contextspill

package
v0.34.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Aug 11, 2026 License: AGPL-3.0 Imports: 9 Imported by: 0

Documentation

Overview

Package contextspill recognizes context spill notices and records local, path-free observability events for the repository runner. The descriptor anchoring it relies on is POSIX-only, and its sole consumer (cmd/contextspilllog) is invoked from the bash runner, so the package is built for Unix alone and is absent from the released ./cmd/awf binary.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func HasSafeLog 

func HasSafeLog(root string) (bool, error)

HasSafeLog reports whether a nonempty observability log exists after opening every component relative to a verified parent descriptor. An absent local directory or log is a safe empty state.

func Log 

func Log(root string, notice Notice, invocation []string) error

Log appends one path-free spill record beneath the repository-local private directory. Every descendant is opened relative to its verified parent descriptor, preventing path substitution between inspection and use.

func ShellQuote 

func ShellQuote(argv []string) string

ShellQuote renders argv as POSIX single-quoted shell words.

Types

type Notice 

type Notice struct {
	Bytes uint64
	Path  string
}

Notice is the bounded data carried by a context spill descriptor.

func ParseNotice 

func ParseNotice(data []byte) (Notice, bool, error)

ParseNotice recognizes the closed two-line context spill notice grammar.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.