GovernanceException

Exception of the governance system: a contract broken or violated. Each factory describes what broke, why, and what to do to fix it.

public static function profileMissing(string $context): self

The governance repository has no registered profile.

Parameters

Parameters of profileMissing()
Name	Type	Description
$context	`string`	Description of where the access was attempted

public static function profileInvalid(string $reason): self

The loaded profile has an invalid structure or content.

Parameters

Parameters of profileInvalid()
Name	Type	Description
$reason	`string`	Specific description of what is invalid

public static function decisionNotFound(string $decisionId): self

An attempt was made to access a decision that does not exist in the profile.

Parameters

Parameters of decisionNotFound()
Name	Type	Description
$decisionId	`string`	ID of the decision sought

public static function decisionDuplicate(string $decisionId): self

The profile has two decisions with the same ID.

Parameters

Parameters of decisionDuplicate()
Name	Type	Description
$decisionId	`string`	Duplicated ID

public static function immutabilityViolation(string $decisionId): self

An attempt was made to modify a decision that is already in effect (inviolable).

Parameters

Parameters of immutabilityViolation()
Name	Type	Description
$decisionId	`string`	ID of the decision that cannot be modified

public static function supersessionCycle(array $cycle): self

There is a cycle in the supersession relationships between decisions.

Parameters

Parameters of supersessionCycle()
Name	Type	Description
$cycle	`array<string>`	List of IDs that form the cycle

public static function decisionInactive(string $decisionId, string $currentStatus): self

An attempt was made to use a decision that is not in "accepted" status.

Parameters

Parameters of decisionInactive()
Name	Type	Description
$decisionId	`string`	ID of the decision
$currentStatus	`string`	Current status it is in

public static function planStale(string $expectedHash, string $planHash): self

The compiled plan does not match the current profile (stale plan).

Parameters

Parameters of planStale()
Name	Type	Description
$expectedHash	`string`	Expected hash of the current profile
$planHash	`string`	Hash of the profile the plan was compiled with

public static function enforcementUnproven(string $gateId, string $tier): self

An enforcement tier is claimed with no evidence of execution.

Parameters

Parameters of enforcementUnproven()
Name	Type	Description
$gateId	`string`	ID of the gate or rule
$tier	`string`	Claimed enforcement tier

public static function runStale(string $reason): self

The most recent governance run observed a plan other than the current one (`profileHash`/`planHash` do not match) — it is evidence of another law, not this one.

Parameters

Parameters of runStale()
Name	Type	Description
$reason	`string`	Specific reason returned by `GovernanceRunProjector::observe()`

public static function runInvalid(string $reason): self

The governance run is internally inconsistent (empty runId, inverted dates, duplicate/unknown gate, PASSED without producerRef, WAIVED without justification, or boundTo that redefines the gate's law) — it is not reliable evidence.

Parameters

Parameters of runInvalid()
Name	Type	Description
$reason	`string`	Specific reason naming the offender, returned by `GovernanceRunProjector::observe()`

public static function historyPlanMismatch(string $planHash, string $historyHash): self

A request was made to derive the health status (`status`) by consulting a history built for a plan other than the current one — evidence of another law. This is NOT re-adjudicating runs (that was done by `observe()`); it is verifying that the consulted history belongs to THIS plan.

Parameters

Parameters of historyPlanMismatch()
Name	Type	Description
$planHash	`string`	Hash of the current plan the status was requested against
$historyHash	`string`	Hash of the plan the received history belongs to

public static function snapshotMissing(string $path): self

The compiled snapshot (`snapshots/governance-plan.json`) does not exist on disk.

Parameters

Parameters of snapshotMissing()
Name	Type	Description
$path	`string`	Absolute path of the expected snapshot

public static function snapshotInvalid(string $reason): self

The compiled snapshot exists but could not be read.

Parameters

Parameters of snapshotInvalid()
Name	Type	Description
$reason	`string`	Specific description of what failed while reading it