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 ¶
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 ¶
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 ¶
IsInvestigateEntry reports whether kv is a "KEY=VALUE" entry whose key is one of the ENTIRE_INVESTIGATE_* contract variables.
func IsReviewEntry ¶
IsReviewEntry reports whether kv is a "KEY=VALUE" entry whose key is one of the ENTIRE_REVIEW_* contract variables.
func IsValidRunID ¶
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.