Coverage for src/governed_harness/domain/enums.py: 99%
134 statements
« prev ^ index » next coverage.py v7.17.2, created at 2026-11-12 16:06 +0000
« prev ^ index » next coverage.py v7.17.2, created at 2026-11-12 16:06 +0000
1from __future__ import annotations
3from enum import StrEnum
6class ResultStatus(StrEnum):
7 PENDING = "PENDING"
8 RUNNING = "RUNNING"
9 PASSED = "PASSED"
10 FAILED = "FAILED"
11 BLOCKED = "BLOCKED"
12 SKIPPED = "SKIPPED"
13 NOT_APPLICABLE = "NOT_APPLICABLE"
14 CANCELLED = "CANCELLED"
15 TIMED_OUT = "TIMED_OUT"
16 ERROR = "ERROR"
17 INCONCLUSIVE = "INCONCLUSIVE"
18 INTERRUPTED = "INTERRUPTED"
19 """The harness stopped while the phase ran (``governance.workspaceLease``); ``run
20 continue`` recovers the run and runs the phase again."""
22 @property
23 def terminal(self) -> bool:
24 return self not in {ResultStatus.PENDING, ResultStatus.RUNNING}
26 @property
27 def successful(self) -> bool:
28 return self in {ResultStatus.PASSED, ResultStatus.NOT_APPLICABLE}
31class PhaseId(StrEnum):
32 INTENT = "INTENT"
33 DISCOVERY = "DISCOVERY"
34 SPECIFICATION = "SPECIFICATION"
35 PLANNING = "PLANNING"
36 IMPLEMENTATION = "IMPLEMENTATION"
37 VERIFICATION = "VERIFICATION"
38 INDEPENDENT_REVIEW = "INDEPENDENT_REVIEW"
39 DECISION = "DECISION"
40 CLOSURE = "CLOSURE"
41 RETROSPECTIVE = "RETROSPECTIVE"
44class ActorType(StrEnum):
45 HUMAN = "HUMAN"
46 AGENT = "AGENT"
47 TOOL = "TOOL"
48 PLUGIN = "PLUGIN"
49 HARNESS = "HARNESS"
50 CI = "CI"
53class ErrorKind(StrEnum):
54 HARNESS_ERROR = "HARNESS_ERROR"
55 CONFIGURATION_ERROR = "CONFIGURATION_ERROR"
56 PROVIDER_ERROR = "PROVIDER_ERROR"
57 TOOL_ERROR = "TOOL_ERROR"
58 PROJECT_ERROR = "PROJECT_ERROR"
59 PREEXISTING_ERROR = "PREEXISTING_ERROR"
60 INTRODUCED_ERROR = "INTRODUCED_ERROR"
61 POLICY_VIOLATION = "POLICY_VIOLATION"
62 MISSING_EVIDENCE = "MISSING_EVIDENCE"
63 PROTOCOL_ERROR = "PROTOCOL_ERROR"
64 SECURITY_ERROR = "SECURITY_ERROR"
67class ValidationKind(StrEnum):
68 SUCCESS = "SUCCESS"
69 VALIDATION_FAILURE = "VALIDATION_FAILURE"
70 PROJECT_ERROR = "PROJECT_ERROR"
71 PREEXISTING_ERROR = "PREEXISTING_ERROR"
72 INTRODUCED_ERROR = "INTRODUCED_ERROR"
73 TOOL_ERROR = "TOOL_ERROR"
74 CONFIGURATION_ERROR = "CONFIGURATION_ERROR"
75 PROTOCOL_ERROR = "PROTOCOL_ERROR"
76 POLICY_VIOLATION = "POLICY_VIOLATION"
77 INCONCLUSIVE = "INCONCLUSIVE"
80class FindingSeverity(StrEnum):
81 INFO = "INFO"
82 LOW = "LOW"
83 MEDIUM = "MEDIUM"
84 HIGH = "HIGH"
85 CRITICAL = "CRITICAL"
88class DecisionKind(StrEnum):
89 APPROVE = "APPROVE"
90 REJECT = "REJECT"
91 REQUEST_CHANGES = "REQUEST_CHANGES"
92 APPROVE_EXCEPTION = "APPROVE_EXCEPTION"
95class RecommendationDecision(StrEnum):
96 ACCEPT = "ACCEPT"
97 EDIT = "EDIT"
98 REJECT = "REJECT"
101class EvidenceKind(StrEnum):
102 INTENT = "INTENT"
103 CONFIGURATION = "CONFIGURATION"
104 PLAN = "PLAN"
105 CHANGESET = "CHANGESET"
106 COMMAND = "COMMAND"
107 TEST_REPORT = "TEST_REPORT"
108 STATIC_ANALYSIS = "STATIC_ANALYSIS"
109 REVIEW = "REVIEW"
110 GATE = "GATE"
111 HUMAN_DECISION = "HUMAN_DECISION"
112 TRACE = "TRACE"
113 METRIC = "METRIC"
114 RETROSPECTIVE = "RETROSPECTIVE"
115 OTHER = "OTHER"
118class MemoryLevel(StrEnum):
119 NORMATIVE = "NORMATIVE"
120 PROJECT = "PROJECT"
121 TASK = "TASK"
122 EPHEMERAL = "EPHEMERAL"
123 RETROSPECTIVE = "RETROSPECTIVE"
126class CapabilityName(StrEnum):
127 FILESYSTEM_READ = "filesystem.read"
128 FILESYSTEM_WRITE = "filesystem.write"
129 PROCESS_EXECUTE = "process.execute"
130 NETWORK_CONNECT = "network.connect"
131 GIT_READ = "git.read"
132 GIT_STAGE = "git.stage"
133 GIT_COMMIT = "git.commit"
134 GIT_PUSH = "git.push"
135 SECRETS_USE = "secrets.use"
136 MCP_INVOKE = "mcp.invoke"
137 ARTIFACT_PUBLISH = "artifact.publish"
138 APPROVAL_REQUEST = "approval.request"
141class VerificationLevel(StrEnum):
142 """Rungs of the verification ladder (since 2.0, ``verification.ladder``): what kind of
143 evidence shows that an acceptance criterion holds. A higher rung is stronger evidence of
144 the behaviour a person asked for; a rung is reached only by evidence recorded for the
145 criterion, never by omission."""
147 L0 = "L0"
148 """Static: the mandatory validators and the harness's deterministic checks passed."""
149 L1 = "L1"
150 """Unit: a passing test of the repository names the criterion."""
151 L2 = "L2"
152 """Integration with the repository's own doubles (fakes, in-memory services)."""
153 L3 = "L3"
154 """Executable behaviour: a declared probe ran the program and its assertions held."""
155 L4 = "L4"
156 """External environment: CI, staging or a device lab, through attached evidence."""
157 L5 = "L5"
158 """Human: a person checked it and ticked it in DECISION."""
160 @property
161 def rank(self) -> int:
162 return int(self.value[1:])
165class MetricQuality(StrEnum):
166 OBSERVED = "OBSERVED"
167 REPORTED = "REPORTED"
168 DERIVED = "DERIVED"
169 ESTIMATED = "ESTIMATED"
170 NOT_AVAILABLE = "NOT_AVAILABLE"