contextspill

package
v0.36.2 Latest Latest
Warning

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

 Go to latest Published: Aug 13, 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's dedicated maintainer cache 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.