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

1from __future__ import annotations 

2 

3from enum import StrEnum 

4 

5 

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.""" 

21 

22 @property 

23 def terminal(self) -> bool: 

24 return self not in {ResultStatus.PENDING, ResultStatus.RUNNING} 

25 

26 @property 

27 def successful(self) -> bool: 

28 return self in {ResultStatus.PASSED, ResultStatus.NOT_APPLICABLE} 

29 

30 

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" 

42 

43 

44class ActorType(StrEnum): 

45 HUMAN = "HUMAN" 

46 AGENT = "AGENT" 

47 TOOL = "TOOL" 

48 PLUGIN = "PLUGIN" 

49 HARNESS = "HARNESS" 

50 CI = "CI" 

51 

52 

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" 

65 

66 

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" 

78 

79 

80class FindingSeverity(StrEnum): 

81 INFO = "INFO" 

82 LOW = "LOW" 

83 MEDIUM = "MEDIUM" 

84 HIGH = "HIGH" 

85 CRITICAL = "CRITICAL" 

86 

87 

88class DecisionKind(StrEnum): 

89 APPROVE = "APPROVE" 

90 REJECT = "REJECT" 

91 REQUEST_CHANGES = "REQUEST_CHANGES" 

92 APPROVE_EXCEPTION = "APPROVE_EXCEPTION" 

93 

94 

95class RecommendationDecision(StrEnum): 

96 ACCEPT = "ACCEPT" 

97 EDIT = "EDIT" 

98 REJECT = "REJECT" 

99 

100 

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" 

116 

117 

118class MemoryLevel(StrEnum): 

119 NORMATIVE = "NORMATIVE" 

120 PROJECT = "PROJECT" 

121 TASK = "TASK" 

122 EPHEMERAL = "EPHEMERAL" 

123 RETROSPECTIVE = "RETROSPECTIVE" 

124 

125 

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" 

139 

140 

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.""" 

146 

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.""" 

159 

160 @property 

161 def rank(self) -> int: 

162 return int(self.value[1:]) 

163 

164 

165class MetricQuality(StrEnum): 

166 OBSERVED = "OBSERVED" 

167 REPORTED = "REPORTED" 

168 DERIVED = "DERIVED" 

169 ESTIMATED = "ESTIMATED" 

170 NOT_AVAILABLE = "NOT_AVAILABLE"