provenance

package
v0.7.0 Latest Latest
Warning

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

Go to latest
Published: Jun 2, 2026 License: MIT Imports: 3 Imported by: 0

Documentation

Overview

Package provenance owns the env-var contract that lets the lifecycle hook recognize a spawned agent process as part of `entire review` or `entire investigate`. Both spawn families set their own ENTIRE_*_* vars on the child agent process; the UserPromptSubmit hook reads them to tag the in-flight session with the right Kind and provenance metadata.

Single source of truth for the names — review, investigate, and agentlaunch (which strips both families before spawning a fix agent) all reference this package.

These names are stable API; renaming any constant is a breaking change.

Index

Constants

View Source
const (
	ReviewSession     = "ENTIRE_REVIEW_SESSION"
	ReviewAgent       = "ENTIRE_REVIEW_AGENT"
	ReviewSkills      = "ENTIRE_REVIEW_SKILLS"
	ReviewPrompt      = "ENTIRE_REVIEW_PROMPT"
	ReviewStartingSHA = "ENTIRE_REVIEW_STARTING_SHA"

	InvestigateSession     = "ENTIRE_INVESTIGATE_SESSION"
	InvestigateAgent       = "ENTIRE_INVESTIGATE_AGENT"
	InvestigateRunID       = "ENTIRE_INVESTIGATE_RUN_ID"
	InvestigateTopic       = "ENTIRE_INVESTIGATE_TOPIC"
	InvestigateFindingsDoc = "ENTIRE_INVESTIGATE_FINDINGS_DOC"
	InvestigateStateDoc    = "ENTIRE_INVESTIGATE_STATE_DOC"
	InvestigateStartingSHA = "ENTIRE_INVESTIGATE_STARTING_SHA"
)

Variables

This section is empty.

Functions

func IsEntry

func IsEntry(kv string) bool

IsEntry reports whether kv is a "KEY=VALUE" entry from either family. agentlaunch uses this to strip provenance markers before spawning a fix session so the child is not tagged as review or investigate.

func IsInvestigateEntry

func IsInvestigateEntry(kv string) bool

IsInvestigateEntry reports whether kv is a "KEY=VALUE" entry whose key is one of the ENTIRE_INVESTIGATE_* contract variables.

func IsReviewEntry

func IsReviewEntry(kv string) bool

IsReviewEntry reports whether kv is a "KEY=VALUE" entry whose key is one of the ENTIRE_REVIEW_* contract variables.

func IsValidRunID

func IsValidRunID(runID string) bool

IsValidRunID reports whether runID is exactly 12 lowercase hex characters. Lives here (next to the InvestigateRunID env name) so the lifecycle hook can validate the env-supplied run ID without pulling in the heavier investigate package.

Types

This section is empty.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL