okstra 0.232.0 → 0.234.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (205) hide show
  1. package/README.md +19 -283
  2. package/dist/cli-registry.mjs +14 -1
  3. package/dist/cli-registry.mjs.map +1 -1
  4. package/dist/commands/execute/render-bundle.d.mts +6 -1
  5. package/dist/commands/execute/render-bundle.mjs +139 -32
  6. package/dist/commands/execute/render-bundle.mjs.map +1 -1
  7. package/dist/commands/lifecycle/config.mjs +6 -74
  8. package/dist/commands/lifecycle/config.mjs.map +1 -1
  9. package/dist/commands/trace/capacity.d.mts +12 -0
  10. package/dist/commands/trace/capacity.mjs +21 -0
  11. package/dist/commands/trace/capacity.mjs.map +1 -0
  12. package/dist/commands/trace/model.d.mts +89 -0
  13. package/dist/commands/trace/model.mjs +251 -0
  14. package/dist/commands/trace/model.mjs.map +1 -0
  15. package/dist/commands/trace/progression.d.mts +11 -0
  16. package/dist/commands/trace/progression.mjs +194 -0
  17. package/dist/commands/trace/progression.mjs.map +1 -0
  18. package/dist/commands/trace/review.d.mts +7 -0
  19. package/dist/commands/trace/review.mjs +51 -0
  20. package/dist/commands/trace/review.mjs.map +1 -0
  21. package/dist/commands/trace/task-link.d.mts +18 -0
  22. package/dist/commands/trace/task-link.mjs +72 -0
  23. package/dist/commands/trace/task-link.mjs.map +1 -0
  24. package/dist/commands/trace/trace.d.mts +1 -0
  25. package/dist/commands/trace/trace.mjs +293 -0
  26. package/dist/commands/trace/trace.mjs.map +1 -0
  27. package/dist/lib/bounded-file.d.mts +1 -0
  28. package/dist/lib/bounded-file.mjs +36 -0
  29. package/dist/lib/bounded-file.mjs.map +1 -0
  30. package/dist/lib/config-store.d.mts +34 -0
  31. package/dist/lib/config-store.mjs +70 -0
  32. package/dist/lib/config-store.mjs.map +1 -0
  33. package/dist/lib/file-lock.mjs +4 -5
  34. package/dist/lib/file-lock.mjs.map +1 -1
  35. package/dist/lib/input-limit.d.mts +4 -0
  36. package/dist/lib/input-limit.mjs +8 -0
  37. package/dist/lib/input-limit.mjs.map +1 -0
  38. package/dist/lib/memory-auto-register.mjs +2 -17
  39. package/dist/lib/memory-auto-register.mjs.map +1 -1
  40. package/dist/lib/report-language-tag.d.mts +1 -0
  41. package/dist/lib/report-language-tag.mjs +4 -0
  42. package/dist/lib/report-language-tag.mjs.map +1 -0
  43. package/dist/lib/report-language.d.mts +1 -0
  44. package/dist/lib/report-language.mjs +50 -0
  45. package/dist/lib/report-language.mjs.map +1 -0
  46. package/dist/lib/skill-catalog.mjs +3 -0
  47. package/dist/lib/skill-catalog.mjs.map +1 -1
  48. package/docs/architecture/storage-model.md +55 -5
  49. package/docs/architecture.md +10 -4
  50. package/docs/cli.md +320 -3
  51. package/docs/contributor-change-matrix.md +1 -2
  52. package/docs/project-structure-overview.md +34 -43
  53. package/package.json +1 -1
  54. package/runtime/BUILD.json +2 -2
  55. package/runtime/agents/operations/trace-interface-review.json +6 -0
  56. package/runtime/agents/operations/trace-scope-review.json +6 -0
  57. package/runtime/prompts/coding-preflight/authoring-checks.md +1 -1
  58. package/runtime/prompts/coding-preflight/clean-code.md +18 -20
  59. package/runtime/prompts/coding-preflight/overview.md +1 -1
  60. package/runtime/prompts/duties/code-reviewer.json +1 -1
  61. package/runtime/prompts/duties/interface-reviewer.json +32 -0
  62. package/runtime/prompts/host-orchestration/README.md +18 -9
  63. package/runtime/prompts/launch.template.md +3 -2
  64. package/runtime/prompts/lead/context-loader.md +2 -0
  65. package/runtime/prompts/lead/okstra-lead-contract.md +7 -7
  66. package/runtime/prompts/lead/report-writer.md +6 -6
  67. package/runtime/prompts/profiles/_coding-conventions-preflight.md +2 -2
  68. package/runtime/prompts/profiles/_common-contract.md +1 -1
  69. package/runtime/python/okstra_ctl/agent/invocation.py +1 -0
  70. package/runtime/python/okstra_ctl/agent/prompt_cli/cli.py +66 -26
  71. package/runtime/python/okstra_ctl/agent/prompt_cli/corrections.py +23 -8
  72. package/runtime/python/okstra_ctl/agent/prompt_cli/materialize.py +28 -10
  73. package/runtime/python/okstra_ctl/agent/prompt_cli/results.py +8 -11
  74. package/runtime/python/okstra_ctl/agent/standalone.py +12 -0
  75. package/runtime/python/okstra_ctl/analysis_packet.py +22 -11
  76. package/runtime/python/okstra_ctl/business_flow/cli.py +60 -6
  77. package/runtime/python/okstra_ctl/business_flow/contracts.py +12 -1
  78. package/runtime/python/okstra_ctl/business_flow/engine.py +17 -5
  79. package/runtime/python/okstra_ctl/business_flow/history.py +60 -0
  80. package/runtime/python/okstra_ctl/business_flow/source.py +35 -2
  81. package/runtime/python/okstra_ctl/business_flow/store.py +51 -14
  82. package/runtime/python/okstra_ctl/business_flow/sweep.py +124 -0
  83. package/runtime/python/okstra_ctl/code_review_census.py +93 -2
  84. package/runtime/python/okstra_ctl/code_review_prepare.py +381 -0
  85. package/runtime/python/okstra_ctl/code_review_run.py +384 -0
  86. package/runtime/python/okstra_ctl/code_review_scope.py +13 -0
  87. package/runtime/python/okstra_ctl/code_review_supervisor.py +41 -0
  88. package/runtime/python/okstra_ctl/code_review_target.py +140 -15
  89. package/runtime/python/okstra_ctl/coverage_census.py +11 -2
  90. package/runtime/python/okstra_ctl/design_snapshot.py +16 -9
  91. package/runtime/python/okstra_ctl/direct_work.py +45 -3
  92. package/runtime/python/okstra_ctl/dispatch_core.py +31 -15
  93. package/runtime/python/okstra_ctl/dispatch_state.py +9 -2
  94. package/runtime/python/okstra_ctl/domain/role.py +1 -0
  95. package/runtime/python/okstra_ctl/doyouknow/cli.py +9 -9
  96. package/runtime/python/okstra_ctl/doyouknow/config.py +2 -2
  97. package/runtime/python/okstra_ctl/doyouknow/group_view.py +152 -0
  98. package/runtime/python/okstra_ctl/doyouknow/source_contracts.py +4 -3
  99. package/runtime/python/okstra_ctl/doyouknow/source_store.py +2 -2
  100. package/runtime/python/okstra_ctl/doyouknow/sources/business.py +116 -0
  101. package/runtime/python/okstra_ctl/doyouknow/sources/manager.py +48 -9
  102. package/runtime/python/okstra_ctl/doyouknow/sync.py +34 -9
  103. package/runtime/python/okstra_ctl/final_report_schema.py +37 -34
  104. package/runtime/python/okstra_ctl/fixed_text.py +10 -0
  105. package/runtime/python/okstra_ctl/incremental_carry.py +6 -7
  106. package/runtime/python/okstra_ctl/initial_prompt_materialization.py +9 -2
  107. package/runtime/python/okstra_ctl/json_boundary.py +33 -6
  108. package/runtime/python/okstra_ctl/manager_cli.py +122 -1
  109. package/runtime/python/okstra_ctl/manager_journal.py +126 -0
  110. package/runtime/python/okstra_ctl/manager_launch.py +3 -3
  111. package/runtime/python/okstra_ctl/manager_log.py +221 -0
  112. package/runtime/python/okstra_ctl/manager_paths.py +8 -0
  113. package/runtime/python/okstra_ctl/manager_resume.py +59 -0
  114. package/runtime/python/okstra_ctl/manager_split.py +2 -2
  115. package/runtime/python/okstra_ctl/manager_store.py +116 -17
  116. package/runtime/python/okstra_ctl/manager_sync.py +42 -3
  117. package/runtime/python/okstra_ctl/manager_view.py +35 -2
  118. package/runtime/python/okstra_ctl/material.py +2 -0
  119. package/runtime/python/okstra_ctl/model_cli.py +64 -14
  120. package/runtime/python/okstra_ctl/model_defaults.py +22 -0
  121. package/runtime/python/okstra_ctl/model_io/renderers.py +3 -0
  122. package/runtime/python/okstra_ctl/operation_invocation.py +207 -28
  123. package/runtime/python/okstra_ctl/path_hints.py +14 -3
  124. package/runtime/python/okstra_ctl/paths.py +6 -1
  125. package/runtime/python/okstra_ctl/phases/catalog.py +24 -7
  126. package/runtime/python/okstra_ctl/phases/implementation/host-rules.md +3 -3
  127. package/runtime/python/okstra_ctl/phases/implementation/instructions/_implementation-diff-review.md +8 -6
  128. package/runtime/python/okstra_ctl/phases/implementation/instructions/_implementation-self-check.md +1 -1
  129. package/runtime/python/okstra_ctl/phases/implementation_option_selection/profile.md +1 -1
  130. package/runtime/python/okstra_ctl/phases/implementation_option_selection/votes.py +11 -11
  131. package/runtime/python/okstra_ctl/phases/implementation_planning/authoring.py +12 -9
  132. package/runtime/python/okstra_ctl/phases/implementation_planning/host-rules.md +3 -6
  133. package/runtime/python/okstra_ctl/phases/implementation_planning/instructions/plan-body-verification.md +12 -10
  134. package/runtime/python/okstra_ctl/phases/implementation_planning/profile.md +5 -5
  135. package/runtime/python/okstra_ctl/phases/improvement_discovery/lenses.py +12 -0
  136. package/runtime/python/okstra_ctl/phases/improvement_discovery/profile.md +7 -6
  137. package/runtime/python/okstra_ctl/phases/improvement_discovery/resolved_census.py +159 -0
  138. package/runtime/python/okstra_ctl/phases/improvement_discovery/spec.md +5 -2
  139. package/runtime/python/okstra_ctl/phases/improvement_discovery/validation.py +21 -7
  140. package/runtime/python/okstra_ctl/phases/release_handoff/boundary.json +1 -1
  141. package/runtime/python/okstra_ctl/phases/release_handoff/profile.md +4 -1
  142. package/runtime/python/okstra_ctl/plan_verify_cli.py +6 -4
  143. package/runtime/python/okstra_ctl/project_group.py +175 -0
  144. package/runtime/python/okstra_ctl/project_group_cli.py +62 -0
  145. package/runtime/python/okstra_ctl/render.py +28 -2
  146. package/runtime/python/okstra_ctl/report_assembly.py +38 -11
  147. package/runtime/python/okstra_ctl/report_contract.py +26 -0
  148. package/runtime/python/okstra_ctl/report_corrections.py +36 -20
  149. package/runtime/python/okstra_ctl/report_inputs.py +1 -0
  150. package/runtime/python/okstra_ctl/report_language.py +4 -1
  151. package/runtime/python/okstra_ctl/report_narrative.py +179 -7
  152. package/runtime/python/okstra_ctl/report_projections.py +64 -18
  153. package/runtime/python/okstra_ctl/report_synthesis_packet.py +86 -36
  154. package/runtime/python/okstra_ctl/run.py +43 -35
  155. package/runtime/python/okstra_ctl/run_context.py +10 -1
  156. package/runtime/python/okstra_ctl/set_work_status.py +4 -15
  157. package/runtime/python/okstra_ctl/task_list_cli.py +34 -8
  158. package/runtime/python/okstra_ctl/task_query.py +239 -0
  159. package/runtime/python/okstra_ctl/trace_review.py +264 -0
  160. package/runtime/python/okstra_ctl/trace_tasks.py +197 -0
  161. package/runtime/python/okstra_ctl/user_authorization.py +14 -0
  162. package/runtime/python/okstra_ctl/wizard/confirmation.py +7 -3
  163. package/runtime/python/okstra_ctl/wizard/launch.py +52 -0
  164. package/runtime/python/okstra_ctl/wizard/launch_cli.py +39 -0
  165. package/runtime/python/okstra_ctl/wizard/outcome.py +17 -16
  166. package/runtime/python/okstra_ctl/wizard/registry.py +1 -1
  167. package/runtime/python/okstra_ctl/wizard/render.py +8 -0
  168. package/runtime/python/okstra_ctl/wizard/state.py +2 -1
  169. package/runtime/python/okstra_project/state.py +20 -0
  170. package/runtime/python/okstra_token_usage/blocks.py +74 -0
  171. package/runtime/python/okstra_token_usage/cli.py +23 -10
  172. package/runtime/python/okstra_token_usage/collect.py +25 -22
  173. package/runtime/python/okstra_token_usage/policy.py +193 -0
  174. package/runtime/schemas/business-flow-v1.schema.json +3 -0
  175. package/runtime/schemas/doyouknow-config-v1.schema.json +1 -1
  176. package/runtime/schemas/report-synthesis-packet-v1.0.schema.json +1 -1
  177. package/runtime/skills/_fragments/wizard-confirm-step.md +1 -1
  178. package/runtime/skills/_fragments/wizard-preflight.md +1 -1
  179. package/runtime/skills/_fragments/wizard-prompt-loop.md +3 -5
  180. package/runtime/skills/_fragments/wizard-relay-protocol.md +1 -1
  181. package/runtime/skills/_fragments/wizard-render-bundle.md +15 -29
  182. package/runtime/skills/okstra-brief-gen/SKILL.md +7 -7
  183. package/runtime/skills/okstra-brief-gen/references/tracker-recursion.md +1 -1
  184. package/runtime/skills/okstra-code-review/SKILL.md +58 -50
  185. package/runtime/skills/okstra-code-review/references/census-rules.md +6 -6
  186. package/runtime/skills/okstra-code-review/references/review-calibration.md +8 -12
  187. package/runtime/skills/okstra-discussion/SKILL.md +22 -38
  188. package/runtime/skills/okstra-explain-flow/SKILL.md +33 -4
  189. package/runtime/skills/okstra-manager/SKILL.md +24 -0
  190. package/runtime/skills/okstra-memory/SKILL.md +1 -1
  191. package/runtime/skills/okstra-pr-gen/SKILL.md +1 -1
  192. package/runtime/skills/okstra-run/SKILL.md +55 -183
  193. package/runtime/skills/okstra-schedule-gen/SKILL.md +9 -13
  194. package/runtime/skills/okstra-setup/SKILL.md +3 -2
  195. package/runtime/skills/okstra-setup/references/project-config.md +2 -4
  196. package/runtime/skills/okstra-tdd/SKILL.md +187 -0
  197. package/runtime/skills/okstra-user-response/SKILL.md +4 -2
  198. package/runtime/templates/doyouknow/group-view.css +103 -0
  199. package/runtime/templates/doyouknow/group-view.js +317 -0
  200. package/runtime/templates/doyouknow/group-view.template.html +72 -0
  201. package/runtime/templates/manager/view.template.html +4 -0
  202. package/runtime/templates/report-writer-prompt-preamble.md +15 -3
  203. package/runtime/templates/trace/trace.template.md +42 -0
  204. package/runtime/validators/checks/fixtures-02.py +25 -33
  205. package/runtime/validators/validate-run.py +93 -36
@@ -0,0 +1,251 @@
1
+ import { dirname, relative, sep } from "node:path";
2
+ import { isReportLanguageTag } from "../../lib/report-language-tag.mjs";
3
+ import { assertInputLimit } from "../../lib/input-limit.mjs";
4
+ import { TRACE_INPUT_LIMITS, traceLines } from "./capacity.mjs";
5
+ export const TRACE_STEPS = [
6
+ "analysis", "analysis-review", "spec", "spec-review", "interface-design",
7
+ "interface-review", "interface-code", "tests-red", "implementation", "integration",
8
+ ];
9
+ export class TraceError extends Error {
10
+ code;
11
+ constructor(code, message, options) {
12
+ super(message, options);
13
+ this.code = code;
14
+ }
15
+ }
16
+ function isRecord(value) {
17
+ return typeof value === "object" && value !== null && !Array.isArray(value);
18
+ }
19
+ function isTaskText(value, maximum) {
20
+ if (typeof value !== "string")
21
+ return false;
22
+ let length = 0;
23
+ for (const ignored of value) {
24
+ void ignored;
25
+ assertInputLimit(++length, maximum, "Task text characters");
26
+ }
27
+ return true;
28
+ }
29
+ export function isTraceTask(value) {
30
+ if (!isRecord(value) || !isTaskText(value.key, 384) || !value.key.trim()
31
+ || !isTaskText(value.title, 200) || !value.title.trim() || !isTaskText(value.summary, 2000))
32
+ return false;
33
+ for (const [key, maximum, characters] of [["tags", 20, 64], ["changedFiles", 100, 512], ["references", 20, 512], ["relatedTasks", 50, 384]]) {
34
+ const list = value[key];
35
+ if (!Array.isArray(list))
36
+ return false;
37
+ assertInputLimit(list.length, maximum, `Task ${key} entries`);
38
+ if (!list.every((item) => isTaskText(item, characters) && item.trim()))
39
+ return false;
40
+ }
41
+ return true;
42
+ }
43
+ export function isTraceStep(value) {
44
+ return typeof value === "string" && TRACE_STEPS.some((step) => step === value);
45
+ }
46
+ export function localTimestamp(date = new Date()) {
47
+ const pad = (value) => String(value).padStart(2, "0");
48
+ const offset = -date.getTimezoneOffset();
49
+ return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}T${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}${offset < 0 ? "-" : "+"}${pad(Math.floor(Math.abs(offset) / 60))}:${pad(Math.abs(offset) % 60)}`;
50
+ }
51
+ export function newTraceState(slug, language) {
52
+ const steps = Object.fromEntries(TRACE_STEPS.map((step) => [step, {
53
+ status: step === "analysis" ? "in_progress" : "pending",
54
+ ...((step.endsWith("-review")) ? { round: 0, failStreak: 0, approval: null, review: null } : {}),
55
+ }]));
56
+ return {
57
+ okstraTrace: 1, slug, createdAt: localTimestamp(), language, target: {},
58
+ currentStep: "analysis", steps, ids: { requirements: [], useCases: [] },
59
+ };
60
+ }
61
+ function isEvidence(value) {
62
+ return isRecord(value) && typeof value.kind === "string" && ["typecheck", "unit", "integration"].includes(value.kind)
63
+ && typeof value.command === "string" && value.command.trim().length > 0
64
+ && Number.isInteger(value.exitCode) && typeof value.summary === "string" && value.summary.trim().length > 0
65
+ && typeof value.recordedAt === "string" && Number.isFinite(Date.parse(value.recordedAt))
66
+ && (value.failureCause === undefined || (typeof value.failureCause === "string"
67
+ && ["not-implemented", "assertion", "compile-error", "import-error", "other"].includes(value.failureCause)));
68
+ }
69
+ function isReviewer(value) {
70
+ return isRecord(value) && ["invocationId", "provider", "model", "runner", "dutyId"].every((key) => typeof value[key] === "string" && String(value[key]).trim().length > 0)
71
+ && (value.verdict === "pass" || value.verdict === "fail");
72
+ }
73
+ export function isTraceReview(value) {
74
+ return isRecord(value) && (value.verdict === "pass" || value.verdict === "fail")
75
+ && (value.independence === "cross-provider" || value.independence === "same-provider")
76
+ && Array.isArray(value.reviewers) && value.reviewers.length > 0
77
+ && value.reviewers.length <= TRACE_INPUT_LIMITS.reviewCompletions && value.reviewers.every(isReviewer);
78
+ }
79
+ function isStepState(value) {
80
+ if (!isRecord(value) || typeof value.status !== "string" || !["pending", "in_progress", "done"].includes(value.status))
81
+ return false;
82
+ if (value.verdict !== undefined && (typeof value.verdict !== "string" || !["pass", "fail"].includes(value.verdict)))
83
+ return false;
84
+ if (value.round !== undefined && (!Number.isInteger(value.round) || Number(value.round) < 0))
85
+ return false;
86
+ if (value.failStreak !== undefined && (!Number.isInteger(value.failStreak) || Number(value.failStreak) < 0))
87
+ return false;
88
+ if (value.approval !== undefined && value.approval !== null
89
+ && (!isRecord(value.approval) || typeof value.approval.quote !== "string" || !value.approval.quote.trim()
90
+ || typeof value.approval.recordedAt !== "string"))
91
+ return false;
92
+ if (value.review !== undefined && value.review !== null && !isTraceReview(value.review))
93
+ return false;
94
+ if (Array.isArray(value.evidence))
95
+ assertInputLimit(value.evidence.length, TRACE_INPUT_LIMITS.evidenceEntries, "Evidence entries");
96
+ if (value.evidence !== undefined && (!Array.isArray(value.evidence) || !value.evidence.every(isEvidence)))
97
+ return false;
98
+ return value.commitPoint === undefined || typeof value.commitPoint === "boolean";
99
+ }
100
+ function isTraceState(value) {
101
+ if (!isRecord(value) || value.okstraTrace !== 1 || typeof value.slug !== "string"
102
+ || !/^[a-z0-9]+(-[a-z0-9]+)*$/.test(value.slug) || !isTraceStep(value.currentStep))
103
+ return false;
104
+ if (typeof value.createdAt !== "string" || !Number.isFinite(Date.parse(value.createdAt))
105
+ || !isReportLanguageTag(value.language))
106
+ return false;
107
+ if (value.task !== undefined && !isTraceTask(value.task))
108
+ return false;
109
+ const steps = value.steps;
110
+ if (!isRecord(steps) || !TRACE_STEPS.every((step) => isStepState(steps[step])))
111
+ return false;
112
+ if (!isRecord(value.target) || !Object.values(value.target).every((item) => typeof item === "string"))
113
+ return false;
114
+ if (isRecord(value.ids)) {
115
+ if (Array.isArray(value.ids.requirements))
116
+ assertInputLimit(value.ids.requirements.length, TRACE_INPUT_LIMITS.ids, "Requirement entries");
117
+ if (Array.isArray(value.ids.useCases))
118
+ assertInputLimit(value.ids.useCases.length, TRACE_INPUT_LIMITS.ids, "Use-case entries");
119
+ }
120
+ return isRecord(value.ids) && Array.isArray(value.ids.requirements) && Array.isArray(value.ids.useCases)
121
+ && value.ids.requirements.every((id) => typeof id === "string" && /^R-\d{3}$/.test(id))
122
+ && value.ids.useCases.every((id) => typeof id === "string" && /^UC-\d{3}$/.test(id));
123
+ }
124
+ export function parseTrace(text) {
125
+ traceLines(text);
126
+ const match = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/.exec(text);
127
+ if (!match)
128
+ throw new TraceError("TRACE_MALFORMED", "Expected JSON frontmatter between --- delimiters");
129
+ let value;
130
+ try {
131
+ value = JSON.parse(match[1] ?? "");
132
+ }
133
+ catch (cause) {
134
+ throw new TraceError("TRACE_MALFORMED", "Trace frontmatter is invalid JSON", { cause });
135
+ }
136
+ if (!isTraceState(value))
137
+ throw new TraceError("TRACE_MALFORMED", "Trace frontmatter does not match version 1");
138
+ const body = text.slice(match[0].length);
139
+ traceRows(body);
140
+ return { state: value, body };
141
+ }
142
+ function* unfencedTraceLines(text) {
143
+ let fence = "";
144
+ for (const entry of traceLines(text).entries()) {
145
+ const line = entry[1];
146
+ const fenceLine = /^\s{0,3}(`{3,}|~{3,})(.*)$/.exec(line);
147
+ const marker = fenceLine?.[1];
148
+ if (marker) {
149
+ if (!fence)
150
+ fence = marker;
151
+ else if (marker[0] === fence[0] && marker.length >= fence.length && /^[ \t]*$/.test(fenceLine?.[2] ?? ""))
152
+ fence = "";
153
+ continue;
154
+ }
155
+ if (fence)
156
+ continue;
157
+ yield entry;
158
+ }
159
+ }
160
+ export function traceSectionBounds(body, step) {
161
+ let current = "";
162
+ let start = -1;
163
+ let end = traceLines(body).length;
164
+ const content = [];
165
+ for (const [index, line] of unfencedTraceLines(body)) {
166
+ const heading = /^##\s+(.+?)\s*$/.exec(line)?.[1];
167
+ if (!heading) {
168
+ if (current === step)
169
+ content.push(line);
170
+ continue;
171
+ }
172
+ if (current === step)
173
+ end = index;
174
+ current = heading;
175
+ if (heading !== step)
176
+ continue;
177
+ if (start >= 0)
178
+ throw new TraceError("TRACE_MALFORMED", `Duplicate section: ${step}`);
179
+ start = index;
180
+ }
181
+ return { start, end, content: content.join("\n") };
182
+ }
183
+ export function traceSectionText(body, step) {
184
+ const { start, end } = traceSectionBounds(body, step);
185
+ return start < 0 ? "" : traceLines(body).slice(start + 1, end).join("\n");
186
+ }
187
+ export function traceLocation(path) {
188
+ const projectRoot = dirname(dirname(dirname(dirname(path))));
189
+ return { projectRoot, tracePath: relative(projectRoot, path).split(sep).join("/") };
190
+ }
191
+ export function traceSection(body, step) {
192
+ return traceSectionBounds(body, step).content;
193
+ }
194
+ export function traceRows(section, column) {
195
+ let headers = [];
196
+ let count = 0;
197
+ const rows = [];
198
+ for (const [, line] of unfencedTraceLines(section)) {
199
+ if (!line.trim().startsWith("|")) {
200
+ headers = [];
201
+ continue;
202
+ }
203
+ const row = line.trim().replace(/^\||\|$/g, "");
204
+ let columns = 1;
205
+ for (const character of row)
206
+ if (character === "|")
207
+ columns++;
208
+ assertInputLimit(columns, TRACE_INPUT_LIMITS.tableColumns, "Table columns");
209
+ const cells = row.split("|").map((cell) => cell.trim().replace(/`/g, ""));
210
+ const repeatsHeader = cells.length === headers.length && cells.every((cell, index) => cell === headers[index]);
211
+ const startsKnownHeader = ["Spec item", "Test", "Use case", "Requirement", "Key"].includes(cells[0] ?? "");
212
+ if (!headers.length || repeatsHeader || startsKnownHeader) {
213
+ headers = cells;
214
+ continue;
215
+ }
216
+ if (cells.every((cell) => /^:?-+:?$/.test(cell)))
217
+ continue;
218
+ assertInputLimit(++count, TRACE_INPUT_LIMITS.tableRows, "Trace table data rows");
219
+ if (column && headers.includes(column))
220
+ rows.push(Object.fromEntries(headers.map((header, index) => [header, cells[index] ?? ""])));
221
+ }
222
+ return rows;
223
+ }
224
+ export function traceIds(text, prefix) {
225
+ const pattern = prefix === "R" ? /\bR-\d{3}\b/g : /\bUC-\d{3}\b/g;
226
+ const ids = [];
227
+ for (const match of text.matchAll(pattern)) {
228
+ assertInputLimit(ids.length + 1, TRACE_INPUT_LIMITS.ids, `${prefix} entries`);
229
+ ids.push(match[0]);
230
+ }
231
+ return ids;
232
+ }
233
+ export function traceTableIds(section, column, prefix) {
234
+ const ids = [];
235
+ for (const row of traceRows(section, column)) {
236
+ const references = traceIds(row[column] ?? "", prefix);
237
+ assertInputLimit(ids.length + references.length, TRACE_INPUT_LIMITS.ids, `${prefix} entries`);
238
+ ids.push(...references);
239
+ }
240
+ return ids;
241
+ }
242
+ export function parseTraceEvidence(value) {
243
+ const items = Array.isArray(value) ? value : [value];
244
+ assertInputLimit(items.length, TRACE_INPUT_LIMITS.evidenceEntries, "Evidence entries");
245
+ const stamped = items.map((item) => isRecord(item) ? { ...item, recordedAt: item.recordedAt ?? localTimestamp() } : item);
246
+ if (!stamped.length || !stamped.every(isEvidence)) {
247
+ throw new TraceError("EVIDENCE_REJECTED", "Evidence requires kind, command, integer exitCode, summary and a valid failureCause when supplied");
248
+ }
249
+ return stamped;
250
+ }
251
+ //# sourceMappingURL=model.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"model.mjs","sourceRoot":"","sources":["../../../src/commands/trace/model.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEhE,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,UAAU,EAAE,iBAAiB,EAAE,MAAM,EAAE,aAAa,EAAE,kBAAkB;IACxE,kBAAkB,EAAE,gBAAgB,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa;CAC1E,CAAC;AAuDX,MAAM,OAAO,UAAW,SAAQ,KAAK;IACd,IAAI;IAAzB,YAAqB,IAAY,EAAE,OAAe,EAAE,OAAsB;QACxE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;oBADL,IAAI;IAEzB,CAAC;CACF;AACD,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AACD,SAAS,UAAU,CAAC,KAAc,EAAE,OAAe;IACjD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;QAAC,KAAK,OAAO,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,CAAC,CAAC;IAAC,CAAC;IAC3G,OAAO,IAAI,CAAC;AACd,CAAC;AACD,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE;WACnE,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5G,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,cAAc,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,YAAY,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,cAAc,EAAE,EAAE,EAAE,GAAG,CAAC,CAAU,EAAE,CAAC;QACrJ,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACxB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QACvC,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,UAAU,CAAC,CAAC;QAC9D,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAAE,OAAO,KAAK,CAAC;IACvF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AACD,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC;AACjF,CAAC;AACD,MAAM,UAAU,cAAc,CAAC,IAAI,GAAS,IAAI,IAAI,EAAE;IACpD,MAAM,GAAG,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtE,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;IACzC,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;AAChQ,CAAC;AACD,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,QAAgB;IAC1D,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE;YAChE,MAAM,EAAE,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;YACvD,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjG,CAAC,CAAC,CAAsC,CAAC;IAC1C,OAAO;QACL,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,cAAc,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;QACvE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;KACxE,CAAC;AACJ,CAAC;AACD,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;WAChH,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;WACpE,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;WACxG,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;WACrF,CAAC,KAAK,CAAC,YAAY,KAAK,SAAS,IAAI,CAAC,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ;eAC1E,CAAC,iBAAiB,EAAE,WAAW,EAAE,eAAe,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;AACnH,CAAC;AACD,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;WACrK,CAAC,KAAK,CAAC,OAAO,KAAK,MAAM,IAAI,KAAK,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC;AAC9D,CAAC;AACD,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,KAAK,MAAM,IAAI,KAAK,CAAC,OAAO,KAAK,MAAM,CAAC;WAC3E,CAAC,KAAK,CAAC,YAAY,KAAK,gBAAgB,IAAI,KAAK,CAAC,YAAY,KAAK,eAAe,CAAC;WACnF,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;WAC5D,KAAK,CAAC,SAAS,CAAC,MAAM,IAAI,kBAAkB,CAAC,iBAAiB,IAAI,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;AAC3G,CAAC;AACD,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,SAAS,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IACrI,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAClI,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3G,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1H,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI;WACtD,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE;eACpG,OAAO,KAAK,CAAC,QAAQ,CAAC,UAAU,KAAK,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IACpE,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IACtG,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;QAAE,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC,eAAe,EAAE,kBAAkB,CAAC,CAAC;IACnI,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACxH,OAAO,KAAK,CAAC,WAAW,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC;AACnF,CAAC;AACD,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,WAAW,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;WAC5E,CAAC,0BAA0B,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC;QAAE,OAAO,KAAK,CAAC;IACnG,IAAI,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;WACnF,CAAC,mBAAmB,CAAC,KAAK,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IACxD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACvE,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC1B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7F,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IACpH,IAAI,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC;YAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC;QAC1I,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;IACjI,CAAC;IACD,OAAO,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC;WACnG,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,KAAK,QAAQ,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;WACpF,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,KAAK,QAAQ,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;AACzF,CAAC;AACD,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,UAAU,CAAC,IAAI,CAAC,CAAC;IACjB,MAAM,KAAK,GAAG,wCAAwC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClE,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,UAAU,CAAC,iBAAiB,EAAE,kDAAkD,CAAC,CAAC;IACxG,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,UAAU,CAAC,iBAAiB,EAAE,mCAAmC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1F,CAAC;IACD,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,iBAAiB,EAAE,4CAA4C,CAAC,CAAC;IAChH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACzC,SAAS,CAAC,IAAI,CAAC,CAAC;IAChB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAChC,CAAC;AACD,QAAQ,CAAC,CAAC,kBAAkB,CAAC,IAAY;IACvC,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QAC/C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,SAAS,GAAG,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,KAAK;gBAAE,KAAK,GAAG,MAAM,CAAC;iBACtB,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gBAAE,KAAK,GAAG,EAAE,CAAC;YACtH,SAAS;QACX,CAAC;QACD,IAAI,KAAK;YAAE,SAAS;QACpB,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AACD,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,IAAe;IAC9D,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC;IACf,IAAI,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;IAClC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAClD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,IAAI,OAAO,KAAK,IAAI;gBAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACzC,SAAS;QACX,CAAC;QACD,IAAI,OAAO,KAAK,IAAI;YAAE,GAAG,GAAG,KAAK,CAAC;QAClC,OAAO,GAAG,OAAO,CAAC;QAClB,IAAI,OAAO,KAAK,IAAI;YAAE,SAAS;QAC/B,IAAI,KAAK,IAAI,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,iBAAiB,EAAE,sBAAsB,IAAI,EAAE,CAAC,CAAC;QACtF,KAAK,GAAG,KAAK,CAAC;IAChB,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACrD,CAAC;AACD,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,IAAe;IAC5D,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtD,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5E,CAAC;AACD,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AACtF,CAAC;AACD,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,IAAe;IACxD,OAAO,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC;AAChD,CAAC;AACD,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,MAAe;IACxD,IAAI,OAAO,GAAa,EAAE,CAAC;IAC3B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,IAAI,GAA6B,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,EAAE,IAAI,CAAC,IAAI,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;YAAC,SAAS;QAAC,CAAC;QAC7D,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAChD,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,KAAK,MAAM,SAAS,IAAI,GAAG;YAAE,IAAI,SAAS,KAAK,GAAG;gBAAE,OAAO,EAAE,CAAC;QAC9D,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;QAC5E,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;QAC1E,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/G,MAAM,iBAAiB,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3G,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,aAAa,IAAI,iBAAiB,EAAE,CAAC;YAAC,OAAO,GAAG,KAAK,CAAC;YAAC,SAAS;QAAC,CAAC;QACzF,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAAE,SAAS;QAC3D,gBAAgB,CAAC,EAAE,KAAK,EAAE,kBAAkB,CAAC,SAAS,EAAE,uBAAuB,CAAC,CAAC;QACjF,IAAI,MAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACtI,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AACD,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,MAAkB;IACvD,MAAM,OAAO,GAAG,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,eAAe,CAAC;IAClE,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3C,gBAAgB,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,kBAAkB,CAAC,GAAG,EAAE,GAAG,MAAM,UAAU,CAAC,CAAC;QAC9E,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AACD,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,MAAc,EAAE,MAAkB;IAC/E,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC;QAC7C,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;QACvD,gBAAgB,CAAC,GAAG,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,EAAE,GAAG,MAAM,UAAU,CAAC,CAAC;QAC9F,GAAG,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AACD,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,MAAM,KAAK,GAAc,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAChE,gBAAgB,CAAC,KAAK,CAAC,MAAM,EAAE,kBAAkB,CAAC,eAAe,EAAE,kBAAkB,CAAC,CAAC;IACvF,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC1H,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,UAAU,CAAC,mBAAmB,EAAE,mGAAmG,CAAC,CAAC;IACjJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}
@@ -0,0 +1,11 @@
1
+ import { type TraceEvidence, type TraceReview, type TraceState, type TraceStep } from "./model.mjs";
2
+ export declare const REVIEW_WRITERS: Partial<Record<TraceStep, TraceStep>>;
3
+ export interface TraceAdvanceOptions {
4
+ readonly verdict?: string;
5
+ readonly approve?: string;
6
+ readonly review?: TraceReview;
7
+ readonly evidence?: readonly TraceEvidence[];
8
+ }
9
+ export declare function traceStatus(path: string, state: TraceState): Record<string, unknown>;
10
+ export declare function nextReviewRound(state: TraceState, step: TraceStep): number;
11
+ export declare function advanceTraceState(input: TraceState, body: string, options: TraceAdvanceOptions): TraceState;
@@ -0,0 +1,194 @@
1
+ import { TRACE_STEPS, TraceError, localTimestamp, traceIds, traceTableIds, traceRows, traceSection, } from "./model.mjs";
2
+ export const REVIEW_WRITERS = {
3
+ "analysis-review": "analysis", "spec-review": "spec", "interface-review": "interface-design",
4
+ };
5
+ const COMMIT_STEPS = ["interface-code", "implementation", "integration"];
6
+ const MAX_REVIEW_FAILURES = 3;
7
+ export function traceStatus(path, state) {
8
+ const { currentStep, steps, ids } = state;
9
+ const review = TRACE_STEPS.find((step) => REVIEW_WRITERS[step] === currentStep) ?? currentStep;
10
+ const failStreak = steps[review].failStreak ?? 0;
11
+ const finished = steps.integration.status === "done";
12
+ let nextAction = "run-tests";
13
+ if (finished)
14
+ nextAction = "done";
15
+ else if (failStreak >= MAX_REVIEW_FAILURES)
16
+ nextAction = "ask-user-decision";
17
+ else if (REVIEW_WRITERS[currentStep])
18
+ nextAction = "review";
19
+ else if (["analysis", "spec", "interface-design"].includes(currentStep))
20
+ nextAction = "write";
21
+ const previous = finished ? "integration" : TRACE_STEPS[TRACE_STEPS.indexOf(currentStep) - 1];
22
+ return { path, currentStep, steps, ids, nextAction, failStreak, commitPoint: previous ? steps[previous].commitPoint === true : false };
23
+ }
24
+ function requireIds(ids, step) {
25
+ if (!ids.length)
26
+ throw new TraceError("SECTION_EMPTY", `${step} requires at least one ID in its table`);
27
+ }
28
+ function gap(ids) {
29
+ throw new TraceError("TRACEABILITY_GAP", `Unmapped or unknown IDs: ${[...new Set(ids)].join(", ")}`);
30
+ }
31
+ function requireSpecCoverage(state, body) {
32
+ const rows = traceRows(traceSection(body, "spec"), "Spec item").filter((row) => row["Spec item"]);
33
+ const mapped = rows.flatMap((row) => traceIds(row.Requirement ?? "", "R"));
34
+ const mappedIds = new Set(mapped);
35
+ const requirements = new Set(state.ids.requirements);
36
+ const gaps = state.ids.requirements.filter((id) => !mappedIds.has(id));
37
+ for (const row of rows) {
38
+ const references = traceIds(row.Requirement ?? "", "R");
39
+ if (!references.length)
40
+ gaps.push(row["Spec item"] ?? "Spec item");
41
+ gaps.push(...references.filter((id) => !requirements.has(id)));
42
+ }
43
+ if (!rows.length || gaps.length)
44
+ gap(gaps.length ? gaps : state.ids.requirements);
45
+ }
46
+ function requireUseCaseCoverage(state, body) {
47
+ const rows = traceRows(traceSection(body, "interface-design"), "Use case");
48
+ const mapped = rows.filter((row) => traceIds(row["Use case"] ?? "", "UC").length)
49
+ .flatMap((row) => traceIds(row.Requirement ?? "", "R"));
50
+ const mappedIds = new Set(mapped);
51
+ const requirements = new Set(state.ids.requirements);
52
+ const gaps = state.ids.requirements.filter((id) => !mappedIds.has(id));
53
+ gaps.push(...mapped.filter((id) => !requirements.has(id)));
54
+ if (gaps.length)
55
+ gap(gaps);
56
+ }
57
+ function requireIntegrationTestCoverage(state, body) {
58
+ const tests = traceRows(traceSection(body, "tests-red"), "Test");
59
+ const covered = new Set(tests.filter((row) => row.Test && row.Kind === "integration" && row.Path)
60
+ .flatMap((row) => traceIds(row["Use case"] ?? "", "UC")));
61
+ const gaps = state.ids.useCases.filter((id) => !covered.has(id));
62
+ if (gaps.length)
63
+ gap(gaps);
64
+ }
65
+ function recordWrittenSection(state, body) {
66
+ const step = state.currentStep;
67
+ const section = traceSection(body, step);
68
+ switch (step) {
69
+ case "analysis": {
70
+ const ids = traceTableIds(section, "Requirement", "R");
71
+ requireIds(ids, step);
72
+ return {
73
+ ...state,
74
+ ids: { ...state.ids, requirements: [...new Set(ids)] },
75
+ target: Object.fromEntries(traceRows(section, "Key").map((row) => [row.Key, row.Value ?? ""])),
76
+ };
77
+ }
78
+ case "spec":
79
+ requireIds(traceRows(section, "Spec item").map((row) => row["Spec item"] ?? "").filter(Boolean), step);
80
+ return state;
81
+ case "interface-design": {
82
+ const ids = traceTableIds(section, "Use case", "UC");
83
+ requireIds(ids, step);
84
+ return { ...state, ids: { ...state.ids, useCases: [...new Set(ids)] } };
85
+ }
86
+ default: throw new TraceError("STEP_MISMATCH", `Not a writing step: ${step}`);
87
+ }
88
+ }
89
+ export function nextReviewRound(state, step) {
90
+ return (state.steps[step].round ?? 0) + 1;
91
+ }
92
+ function reviewVerdict(options) {
93
+ if (options.review) {
94
+ if (options.verdict !== undefined || options.approve !== undefined) {
95
+ throw new TraceError("INVALID_ARGUMENT", "Reviewer completions decide the verdict; omit --verdict and --approve with --review");
96
+ }
97
+ return options.review.verdict;
98
+ }
99
+ if (options.verdict !== "pass" && options.verdict !== "fail") {
100
+ throw new TraceError("VERDICT_REQUIRED", "Review requires --review <completion> or --verdict pass|fail");
101
+ }
102
+ if (options.verdict === "pass" && !options.approve?.trim()) {
103
+ throw new TraceError("APPROVAL_REQUIRED", "A passing review requires reviewer completions (--review) or a verbatim user approval (--approve)");
104
+ }
105
+ return options.verdict;
106
+ }
107
+ function recordReview(state, body, options) {
108
+ const step = state.currentStep;
109
+ const writer = REVIEW_WRITERS[step];
110
+ if (!writer)
111
+ throw new TraceError("STEP_MISMATCH", `Not a review step: ${step}`);
112
+ const verdict = reviewVerdict(options);
113
+ const record = { ...state.steps[step] };
114
+ record.round = nextReviewRound(state, step);
115
+ record.verdict = verdict;
116
+ record.review = options.review ?? null;
117
+ record.approval = null;
118
+ if (verdict === "fail") {
119
+ record.failStreak = (record.failStreak ?? 0) + 1;
120
+ record.status = "pending";
121
+ const writerRecord = { ...state.steps[writer] };
122
+ writerRecord.status = "in_progress";
123
+ delete writerRecord.completedAt;
124
+ return {
125
+ ...state,
126
+ currentStep: writer,
127
+ steps: { ...state.steps, [step]: record, [writer]: writerRecord },
128
+ };
129
+ }
130
+ if (step === "spec-review")
131
+ requireSpecCoverage(state, body);
132
+ else if (step === "interface-review")
133
+ requireUseCaseCoverage(state, body);
134
+ if (options.approve !== undefined)
135
+ record.approval = { quote: options.approve, recordedAt: localTimestamp() };
136
+ record.failStreak = 0;
137
+ return { ...state, steps: { ...state.steps, [step]: record } };
138
+ }
139
+ function requireEvidence(evidence, kind, isRed = false) {
140
+ const matching = evidence.filter((item) => item.kind === kind);
141
+ const accepted = matching.length > 0 && matching.every((item) => isRed
142
+ ? item.exitCode !== 0 && item.failureCause === "not-implemented"
143
+ : item.exitCode === 0);
144
+ if (!accepted)
145
+ throw new TraceError("EVIDENCE_REJECTED", `${kind} requires ${isRed ? "RED with failureCause not-implemented" : "GREEN (exitCode 0)"} evidence`);
146
+ }
147
+ function recordTestEvidence(state, body, evidence) {
148
+ const step = state.currentStep;
149
+ switch (step) {
150
+ case "interface-code":
151
+ requireEvidence(evidence, "typecheck");
152
+ break;
153
+ case "tests-red":
154
+ requireEvidence(evidence, "unit", true);
155
+ requireEvidence(evidence, "integration", true);
156
+ requireIntegrationTestCoverage(state, body);
157
+ break;
158
+ case "implementation":
159
+ requireEvidence(evidence, "unit");
160
+ break;
161
+ case "integration":
162
+ requireEvidence(evidence, "integration");
163
+ requireIntegrationTestCoverage(state, body);
164
+ break;
165
+ default: throw new TraceError("STEP_MISMATCH", `Not an evidence step: ${step}`);
166
+ }
167
+ return { ...state, steps: { ...state.steps, [step]: { ...state.steps[step], evidence } } };
168
+ }
169
+ export function advanceTraceState(input, body, options) {
170
+ const step = input.currentStep;
171
+ if (input.steps.integration.status === "done")
172
+ throw new TraceError("STEP_MISMATCH", "Trace is already complete");
173
+ let state;
174
+ if (REVIEW_WRITERS[step]) {
175
+ state = recordReview(input, body, options);
176
+ if (state.currentStep !== step)
177
+ return state;
178
+ }
179
+ else if (["analysis", "spec", "interface-design"].includes(step)) {
180
+ state = recordWrittenSection(input, body);
181
+ }
182
+ else {
183
+ state = recordTestEvidence(input, body, options.evidence ?? []);
184
+ }
185
+ const steps = { ...state.steps };
186
+ steps[step] = {
187
+ ...steps[step], status: "done", completedAt: localTimestamp(), commitPoint: COMMIT_STEPS.includes(step),
188
+ };
189
+ const next = TRACE_STEPS[TRACE_STEPS.indexOf(step) + 1];
190
+ if (next)
191
+ steps[next] = { ...steps[next], status: "in_progress" };
192
+ return { ...state, steps, currentStep: next ?? step };
193
+ }
194
+ //# sourceMappingURL=progression.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"progression.mjs","sourceRoot":"","sources":["../../../src/commands/trace/progression.mts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ import type { PythonRunner } from "../../lib/types.mjs";
2
+ import { type TraceReview, type TraceState } from "./model.mjs";
3
+ export declare const REVIEW_RESPONSE_BYTES: number;
4
+ export declare const REVIEW_TIMEOUT_MS = 60000;
5
+ export declare function runTraceReview(command: "plan" | "verify", args: readonly string[], runner?: PythonRunner): Promise<Record<string, unknown>>;
6
+ export declare function planTraceReviewers(path: string, state: TraceState, body: string, hostRuntime: string, count: string | undefined): Promise<Record<string, unknown>>;
7
+ export declare function verifyTraceReviews(path: string, state: TraceState, body: string, hostRuntime: string, completions: readonly string[]): Promise<TraceReview>;
@@ -0,0 +1,51 @@
1
+ import { createHash } from "node:crypto";
2
+ import { assertInputLimit } from "../../lib/input-limit.mjs";
3
+ import { runPythonModule } from "../../lib/python-helper.mjs";
4
+ import { TraceError, isTraceReview, traceLocation, traceSectionText } from "./model.mjs";
5
+ import { REVIEW_WRITERS, nextReviewRound } from "./progression.mjs";
6
+ export const REVIEW_RESPONSE_BYTES = 16 * 1024;
7
+ // `advance` holds the trace lock while the helper verifies completions.
8
+ export const REVIEW_TIMEOUT_MS = 60_000;
9
+ function reviewTargetArgs(path, state, body, hostRuntime) {
10
+ const step = state.currentStep;
11
+ const writer = REVIEW_WRITERS[step];
12
+ if (!writer)
13
+ throw new TraceError("STEP_MISMATCH", `Not a review step: ${step}`);
14
+ const { projectRoot, tracePath } = traceLocation(path);
15
+ const digest = createHash("sha256").update(traceSectionText(body, writer), "utf8").digest("hex");
16
+ return [
17
+ "--project-root", projectRoot, "--trace-path", tracePath, "--step", step,
18
+ "--round", String(nextReviewRound(state, step)), "--section-digest", `sha256:${digest}`, "--host-runtime", hostRuntime,
19
+ ];
20
+ }
21
+ export async function runTraceReview(command, args, runner = runPythonModule) {
22
+ const result = await runner({ module: "okstra_ctl.trace_review", args: [command, ...args], stdio: "capture", timeoutMs: REVIEW_TIMEOUT_MS });
23
+ assertInputLimit(Buffer.byteLength(result.stdout, "utf8"), REVIEW_RESPONSE_BYTES, "Trace review response bytes");
24
+ let response;
25
+ try {
26
+ response = JSON.parse(result.stdout);
27
+ }
28
+ catch (cause) {
29
+ throw new TraceError("REVIEW_UNAVAILABLE", `Trace review helper exited ${result.code} without a JSON response (killed after ${REVIEW_TIMEOUT_MS} ms if it timed out): ${result.stderr.trim() || "no output"}`, { cause });
30
+ }
31
+ if (typeof response !== "object" || response === null || Array.isArray(response)) {
32
+ throw new TraceError("REVIEW_UNAVAILABLE", "Trace review helper returned an invalid response");
33
+ }
34
+ const failure = response.error;
35
+ if (result.code !== 0 || failure) {
36
+ throw new TraceError(typeof failure?.code === "string" ? failure.code : "REVIEW_UNAVAILABLE", typeof failure?.message === "string" ? failure.message : "Trace review helper failed");
37
+ }
38
+ return response;
39
+ }
40
+ export async function planTraceReviewers(path, state, body, hostRuntime, count) {
41
+ if (count !== undefined && !/^[1-9]\d{0,2}$/.test(count))
42
+ throw new TraceError("INVALID_ARGUMENT", "--count must be a positive integer");
43
+ return runTraceReview("plan", [...reviewTargetArgs(path, state, body, hostRuntime), ...(count === undefined ? [] : ["--count", count])]);
44
+ }
45
+ export async function verifyTraceReviews(path, state, body, hostRuntime, completions) {
46
+ const response = await runTraceReview("verify", [...reviewTargetArgs(path, state, body, hostRuntime), ...completions.flatMap((completion) => ["--completion", completion])]);
47
+ if (!isTraceReview(response))
48
+ throw new TraceError("REVIEW_UNAVAILABLE", "Trace review helper returned an invalid verdict");
49
+ return response;
50
+ }
51
+ //# sourceMappingURL=review.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"review.mjs","sourceRoot":"","sources":["../../../src/commands/trace/review.mts"],"names":[],"mappings":"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"}
@@ -0,0 +1,18 @@
1
+ import { TraceError, type TraceState } from "./model.mjs";
2
+ export declare class TaskSyncError extends TraceError {
3
+ readonly details: {
4
+ readonly traceSaved: boolean;
5
+ readonly path: string;
6
+ readonly taskKey: string;
7
+ readonly retry: string;
8
+ };
9
+ constructor(details: {
10
+ readonly traceSaved: boolean;
11
+ readonly path: string;
12
+ readonly taskKey: string;
13
+ readonly retry: string;
14
+ }, options?: ErrorOptions);
15
+ }
16
+ export declare function readTaskMetadata(state: TraceState, taskKey: string | undefined, metadataPath: string | undefined): Promise<TraceState>;
17
+ export declare function requireTaskSummary(state: TraceState): void;
18
+ export declare function projectTraceTask(path: string, text: string, state: TraceState, operation: "sync" | "status"): Promise<Record<string, unknown>>;