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. `entire review` lives in this repository; `entire investigate` ships as the entire-investigate plugin and imports this package for the same constants, so these names are a contract across a process boundary as well as inside this binary.
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. Callers strip provenance markers with it before spawning a child that must not inherit the parent's tagging — review when it builds a nested agent's environment, and the investigate plugin before it launches a fix session.
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.
Source Files