okstra 0.231.1 → 0.233.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 (265) hide show
  1. package/README.md +19 -271
  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/memory/memory.mjs +9 -55
  10. package/dist/commands/memory/memory.mjs.map +1 -1
  11. package/dist/commands/trace/capacity.d.mts +12 -0
  12. package/dist/commands/trace/capacity.mjs +21 -0
  13. package/dist/commands/trace/capacity.mjs.map +1 -0
  14. package/dist/commands/trace/model.d.mts +89 -0
  15. package/dist/commands/trace/model.mjs +251 -0
  16. package/dist/commands/trace/model.mjs.map +1 -0
  17. package/dist/commands/trace/progression.d.mts +11 -0
  18. package/dist/commands/trace/progression.mjs +194 -0
  19. package/dist/commands/trace/progression.mjs.map +1 -0
  20. package/dist/commands/trace/review.d.mts +7 -0
  21. package/dist/commands/trace/review.mjs +51 -0
  22. package/dist/commands/trace/review.mjs.map +1 -0
  23. package/dist/commands/trace/task-link.d.mts +18 -0
  24. package/dist/commands/trace/task-link.mjs +72 -0
  25. package/dist/commands/trace/task-link.mjs.map +1 -0
  26. package/dist/commands/trace/trace.d.mts +1 -0
  27. package/dist/commands/trace/trace.mjs +293 -0
  28. package/dist/commands/trace/trace.mjs.map +1 -0
  29. package/dist/lib/bounded-file.d.mts +1 -0
  30. package/dist/lib/bounded-file.mjs +36 -0
  31. package/dist/lib/bounded-file.mjs.map +1 -0
  32. package/dist/lib/config-store.d.mts +34 -0
  33. package/dist/lib/config-store.mjs +70 -0
  34. package/dist/lib/config-store.mjs.map +1 -0
  35. package/dist/lib/file-lock.mjs +4 -5
  36. package/dist/lib/file-lock.mjs.map +1 -1
  37. package/dist/lib/input-limit.d.mts +4 -0
  38. package/dist/lib/input-limit.mjs +8 -0
  39. package/dist/lib/input-limit.mjs.map +1 -0
  40. package/dist/lib/memory-auto-register.d.mts +1 -0
  41. package/dist/lib/memory-auto-register.mjs +98 -0
  42. package/dist/lib/memory-auto-register.mjs.map +1 -0
  43. package/dist/lib/memory-entry-contract.d.mts +12 -0
  44. package/dist/lib/memory-entry-contract.mjs +46 -0
  45. package/dist/lib/memory-entry-contract.mjs.map +1 -0
  46. package/dist/lib/python-helper.d.mts +1 -1
  47. package/dist/lib/python-helper.mjs +3 -2
  48. package/dist/lib/python-helper.mjs.map +1 -1
  49. package/dist/lib/record-secrets.d.mts +1 -0
  50. package/dist/lib/record-secrets.mjs +28 -0
  51. package/dist/lib/record-secrets.mjs.map +1 -0
  52. package/dist/lib/report-language-tag.d.mts +1 -0
  53. package/dist/lib/report-language-tag.mjs +4 -0
  54. package/dist/lib/report-language-tag.mjs.map +1 -0
  55. package/dist/lib/report-language.d.mts +1 -0
  56. package/dist/lib/report-language.mjs +50 -0
  57. package/dist/lib/report-language.mjs.map +1 -0
  58. package/dist/lib/skill-catalog.mjs +3 -0
  59. package/dist/lib/skill-catalog.mjs.map +1 -1
  60. package/dist/lib/types.d.mts +2 -1
  61. package/docs/architecture/storage-model.md +163 -5
  62. package/docs/architecture.md +17 -4
  63. package/docs/cli.md +511 -0
  64. package/docs/contributor-change-matrix.md +1 -2
  65. package/docs/project-structure-overview.md +33 -42
  66. package/package.json +1 -1
  67. package/runtime/BUILD.json +2 -2
  68. package/runtime/agents/common.json +8 -8
  69. package/runtime/agents/operations/trace-interface-review.json +6 -0
  70. package/runtime/agents/operations/trace-scope-review.json +6 -0
  71. package/runtime/agents/roles/verifier.json +2 -4
  72. package/runtime/bin/okstra-provider-exec.py +10 -4
  73. package/runtime/prompts/coding-preflight/architectures/hexagonal.md +23 -30
  74. package/runtime/prompts/coding-preflight/authoring-checks.md +17 -0
  75. package/runtime/prompts/coding-preflight/clean-code.md +88 -286
  76. package/runtime/prompts/coding-preflight/frameworks/node-server.md +2 -3
  77. package/runtime/prompts/coding-preflight/languages/java.md +3 -5
  78. package/runtime/prompts/coding-preflight/languages/javascript-typescript.md +5 -12
  79. package/runtime/prompts/coding-preflight/languages/kotlin.md +2 -4
  80. package/runtime/prompts/coding-preflight/languages/python.md +2 -7
  81. package/runtime/prompts/coding-preflight/languages/rust.md +2 -8
  82. package/runtime/prompts/coding-preflight/languages/sql.md +2 -4
  83. package/runtime/prompts/coding-preflight/overview.md +25 -38
  84. package/runtime/prompts/coding-preflight/review-rules.json +30 -0
  85. package/runtime/prompts/duties/code-reviewer.json +15 -18
  86. package/runtime/prompts/duties/implementation-verifier.json +1 -0
  87. package/runtime/prompts/duties/interface-reviewer.json +32 -0
  88. package/runtime/prompts/host-orchestration/README.md +18 -9
  89. package/runtime/prompts/launch.template.md +3 -2
  90. package/runtime/prompts/lead/context-loader.md +2 -0
  91. package/runtime/prompts/lead/okstra-lead-contract.md +7 -7
  92. package/runtime/prompts/lead/report-writer.md +6 -6
  93. package/runtime/prompts/profiles/_coding-conventions-preflight.md +41 -6
  94. package/runtime/prompts/profiles/_common-contract.md +1 -1
  95. package/runtime/python/okstra_ctl/agent/invocation.py +122 -36
  96. package/runtime/python/okstra_ctl/agent/prompt_cli/cli.py +72 -26
  97. package/runtime/python/okstra_ctl/agent/prompt_cli/corrections.py +23 -8
  98. package/runtime/python/okstra_ctl/agent/prompt_cli/materialize.py +58 -14
  99. package/runtime/python/okstra_ctl/agent/prompt_cli/results.py +8 -11
  100. package/runtime/python/okstra_ctl/agent/standalone.py +15 -0
  101. package/runtime/python/okstra_ctl/analysis_packet.py +24 -30
  102. package/runtime/python/okstra_ctl/attempt_evidence.py +10 -0
  103. package/runtime/python/okstra_ctl/code_review_census.py +162 -7
  104. package/runtime/python/okstra_ctl/code_review_coverage.py +4 -274
  105. package/runtime/python/okstra_ctl/code_review_integrity.py +154 -0
  106. package/runtime/python/okstra_ctl/code_review_invocation.py +212 -0
  107. package/runtime/python/okstra_ctl/code_review_prepare.py +381 -0
  108. package/runtime/python/okstra_ctl/code_review_run.py +384 -0
  109. package/runtime/python/okstra_ctl/code_review_scope.py +49 -9
  110. package/runtime/python/okstra_ctl/code_review_supervisor.py +41 -0
  111. package/runtime/python/okstra_ctl/code_review_target.py +212 -13
  112. package/runtime/python/okstra_ctl/consumers.py +12 -9
  113. package/runtime/python/okstra_ctl/coverage_census.py +11 -2
  114. package/runtime/python/okstra_ctl/design_review.py +207 -0
  115. package/runtime/python/okstra_ctl/design_review_evidence.py +297 -0
  116. package/runtime/python/okstra_ctl/design_snapshot.py +16 -9
  117. package/runtime/python/okstra_ctl/direct_work.py +45 -3
  118. package/runtime/python/okstra_ctl/dispatch_core.py +31 -15
  119. package/runtime/python/okstra_ctl/dispatch_state.py +9 -2
  120. package/runtime/python/okstra_ctl/doctor.py +8 -25
  121. package/runtime/python/okstra_ctl/domain/role.py +1 -0
  122. package/runtime/python/okstra_ctl/doyouknow/__init__.py +9 -0
  123. package/runtime/python/okstra_ctl/doyouknow/cli.py +91 -0
  124. package/runtime/python/okstra_ctl/doyouknow/config.py +58 -0
  125. package/runtime/python/okstra_ctl/doyouknow/contracts.py +184 -0
  126. package/runtime/python/okstra_ctl/doyouknow/identity.py +22 -0
  127. package/runtime/python/okstra_ctl/doyouknow/paths.py +22 -0
  128. package/runtime/python/okstra_ctl/doyouknow/pending.py +72 -0
  129. package/runtime/python/okstra_ctl/doyouknow/registration.py +260 -0
  130. package/runtime/python/okstra_ctl/doyouknow/source_contracts.py +128 -0
  131. package/runtime/python/okstra_ctl/doyouknow/source_store.py +172 -0
  132. package/runtime/python/okstra_ctl/doyouknow/sources/io.py +36 -0
  133. package/runtime/python/okstra_ctl/doyouknow/sources/manager.py +300 -0
  134. package/runtime/python/okstra_ctl/doyouknow/sources/memory.py +179 -0
  135. package/runtime/python/okstra_ctl/doyouknow/sources/task.py +95 -0
  136. package/runtime/python/okstra_ctl/doyouknow/store.py +260 -0
  137. package/runtime/python/okstra_ctl/doyouknow/sync.py +58 -0
  138. package/runtime/python/okstra_ctl/execution_mutation_audit.py +18 -2
  139. package/runtime/python/okstra_ctl/file_size_cap.py +3 -4
  140. package/runtime/python/okstra_ctl/final_report_schema.py +37 -34
  141. package/runtime/python/okstra_ctl/incremental_carry.py +6 -7
  142. package/runtime/python/okstra_ctl/initial_prompt_materialization.py +9 -2
  143. package/runtime/python/okstra_ctl/json_boundary.py +51 -5
  144. package/runtime/python/okstra_ctl/jsonl.py +21 -0
  145. package/runtime/python/okstra_ctl/manager_cli.py +148 -1
  146. package/runtime/python/okstra_ctl/manager_journal.py +126 -0
  147. package/runtime/python/okstra_ctl/manager_launch.py +3 -3
  148. package/runtime/python/okstra_ctl/manager_log.py +221 -0
  149. package/runtime/python/okstra_ctl/manager_paths.py +8 -0
  150. package/runtime/python/okstra_ctl/manager_registration.py +29 -0
  151. package/runtime/python/okstra_ctl/manager_resume.py +59 -0
  152. package/runtime/python/okstra_ctl/manager_split.py +2 -2
  153. package/runtime/python/okstra_ctl/manager_store.py +116 -17
  154. package/runtime/python/okstra_ctl/manager_sync.py +45 -25
  155. package/runtime/python/okstra_ctl/manager_view.py +35 -2
  156. package/runtime/python/okstra_ctl/material.py +2 -0
  157. package/runtime/python/okstra_ctl/model_cli.py +64 -14
  158. package/runtime/python/okstra_ctl/model_defaults.py +22 -0
  159. package/runtime/python/okstra_ctl/model_io/renderers.py +16 -2
  160. package/runtime/python/okstra_ctl/model_io_cli.py +7 -1
  161. package/runtime/python/okstra_ctl/operation_invocation.py +207 -28
  162. package/runtime/python/okstra_ctl/path_hints.py +14 -3
  163. package/runtime/python/okstra_ctl/paths.py +6 -1
  164. package/runtime/python/okstra_ctl/phases/catalog.py +24 -7
  165. package/runtime/python/okstra_ctl/phases/final_verification/validation.py +20 -0
  166. package/runtime/python/okstra_ctl/phases/implementation/host-rules.md +3 -3
  167. package/runtime/python/okstra_ctl/phases/implementation/instructions/_implementation-deliverable.md +10 -0
  168. package/runtime/python/okstra_ctl/phases/implementation/instructions/_implementation-diff-review.md +23 -8
  169. package/runtime/python/okstra_ctl/phases/implementation/instructions/_implementation-self-check.md +6 -4
  170. package/runtime/python/okstra_ctl/phases/implementation/instructions/_implementation-verifier.md +38 -10
  171. package/runtime/python/okstra_ctl/phases/implementation/report_assets/implementation.template.html +13 -0
  172. package/runtime/python/okstra_ctl/phases/implementation/spec.md +25 -0
  173. package/runtime/python/okstra_ctl/phases/implementation/validation.py +6 -0
  174. package/runtime/python/okstra_ctl/phases/implementation_option_selection/profile.md +1 -1
  175. package/runtime/python/okstra_ctl/phases/implementation_option_selection/votes.py +11 -11
  176. package/runtime/python/okstra_ctl/phases/implementation_planning/authoring.py +16 -9
  177. package/runtime/python/okstra_ctl/phases/implementation_planning/host-rules.md +3 -6
  178. package/runtime/python/okstra_ctl/phases/implementation_planning/instructions/plan-body-verification.md +12 -10
  179. package/runtime/python/okstra_ctl/phases/implementation_planning/profile.md +6 -6
  180. package/runtime/python/okstra_ctl/phases/improvement_discovery/lenses.py +12 -0
  181. package/runtime/python/okstra_ctl/phases/improvement_discovery/profile.md +7 -6
  182. package/runtime/python/okstra_ctl/phases/improvement_discovery/resolved_census.py +159 -0
  183. package/runtime/python/okstra_ctl/phases/improvement_discovery/spec.md +5 -2
  184. package/runtime/python/okstra_ctl/phases/improvement_discovery/validation.py +21 -7
  185. package/runtime/python/okstra_ctl/phases/release_handoff/boundary.json +1 -1
  186. package/runtime/python/okstra_ctl/phases/release_handoff/profile.md +4 -1
  187. package/runtime/python/okstra_ctl/plan_verify_cli.py +6 -4
  188. package/runtime/python/okstra_ctl/render.py +28 -2
  189. package/runtime/python/okstra_ctl/report_assembly.py +53 -11
  190. package/runtime/python/okstra_ctl/report_contract.py +26 -0
  191. package/runtime/python/okstra_ctl/report_corrections.py +36 -20
  192. package/runtime/python/okstra_ctl/report_inputs.py +1 -0
  193. package/runtime/python/okstra_ctl/report_language.py +4 -1
  194. package/runtime/python/okstra_ctl/report_narrative.py +182 -7
  195. package/runtime/python/okstra_ctl/report_projections.py +64 -18
  196. package/runtime/python/okstra_ctl/report_synthesis_packet.py +97 -38
  197. package/runtime/python/okstra_ctl/review_policy.py +359 -0
  198. package/runtime/python/okstra_ctl/review_verdicts.py +291 -0
  199. package/runtime/python/okstra_ctl/run.py +67 -36
  200. package/runtime/python/okstra_ctl/run_context.py +10 -1
  201. package/runtime/python/okstra_ctl/set_work_status.py +4 -15
  202. package/runtime/python/okstra_ctl/stage_done.py +11 -0
  203. package/runtime/python/okstra_ctl/standalone_review_audit.py +28 -0
  204. package/runtime/python/okstra_ctl/task_list_cli.py +34 -8
  205. package/runtime/python/okstra_ctl/task_query.py +239 -0
  206. package/runtime/python/okstra_ctl/trace_review.py +264 -0
  207. package/runtime/python/okstra_ctl/trace_tasks.py +197 -0
  208. package/runtime/python/okstra_ctl/user_authorization.py +14 -0
  209. package/runtime/python/okstra_ctl/verification_generation.py +23 -1
  210. package/runtime/python/okstra_ctl/verification_input_types.py +15 -1
  211. package/runtime/python/okstra_ctl/verification_inputs.py +28 -6
  212. package/runtime/python/okstra_ctl/verification_invocation.py +7 -1
  213. package/runtime/python/okstra_ctl/verification_target.py +2 -0
  214. package/runtime/python/okstra_ctl/wizard/confirmation.py +7 -3
  215. package/runtime/python/okstra_ctl/wizard/launch.py +52 -0
  216. package/runtime/python/okstra_ctl/wizard/launch_cli.py +39 -0
  217. package/runtime/python/okstra_ctl/wizard/outcome.py +17 -16
  218. package/runtime/python/okstra_ctl/wizard/registry.py +1 -1
  219. package/runtime/python/okstra_ctl/wizard/render.py +8 -0
  220. package/runtime/python/okstra_ctl/wizard/state.py +2 -1
  221. package/runtime/python/okstra_ctl/worker_prompt_headers.py +24 -9
  222. package/runtime/python/okstra_ctl/worker_runner.py +66 -10
  223. package/runtime/python/okstra_ctl/write_policy.py +34 -1
  224. package/runtime/python/okstra_project/__init__.py +2 -0
  225. package/runtime/python/okstra_project/dirs.py +18 -0
  226. package/runtime/python/okstra_project/state.py +45 -20
  227. package/runtime/python/okstra_token_usage/blocks.py +74 -0
  228. package/runtime/python/okstra_token_usage/cli.py +23 -10
  229. package/runtime/python/okstra_token_usage/collect.py +25 -22
  230. package/runtime/python/okstra_token_usage/policy.py +193 -0
  231. package/runtime/schemas/doyouknow-config-v1.schema.json +20 -0
  232. package/runtime/schemas/doyouknow-v1.schema.json +65 -0
  233. package/runtime/schemas/final-report-v2.0.schema.json +157 -0
  234. package/runtime/schemas/final-report-v3.0.schema.json +157 -0
  235. package/runtime/schemas/memory-entry-contract-v1.json +11 -0
  236. package/runtime/schemas/record-secret-patterns.json +41 -0
  237. package/runtime/schemas/report-synthesis-packet-v1.0.schema.json +1 -1
  238. package/runtime/skills/_fragments/wizard-confirm-step.md +1 -1
  239. package/runtime/skills/_fragments/wizard-preflight.md +1 -1
  240. package/runtime/skills/_fragments/wizard-prompt-loop.md +3 -5
  241. package/runtime/skills/_fragments/wizard-relay-protocol.md +1 -1
  242. package/runtime/skills/_fragments/wizard-render-bundle.md +15 -29
  243. package/runtime/skills/okstra-brief-gen/SKILL.md +7 -7
  244. package/runtime/skills/okstra-brief-gen/references/tracker-recursion.md +1 -1
  245. package/runtime/skills/okstra-code-review/SKILL.md +92 -136
  246. package/runtime/skills/okstra-code-review/references/census-rules.md +29 -105
  247. package/runtime/skills/okstra-code-review/references/review-calibration.md +37 -61
  248. package/runtime/skills/okstra-discussion/SKILL.md +22 -38
  249. package/runtime/skills/okstra-explain-flow/SKILL.md +6 -2
  250. package/runtime/skills/okstra-manager/SKILL.md +31 -0
  251. package/runtime/skills/okstra-memory/SKILL.md +8 -1
  252. package/runtime/skills/okstra-pr-gen/SKILL.md +1 -1
  253. package/runtime/skills/okstra-run/SKILL.md +55 -183
  254. package/runtime/skills/okstra-schedule-gen/SKILL.md +9 -13
  255. package/runtime/skills/okstra-setup/SKILL.md +3 -2
  256. package/runtime/skills/okstra-setup/references/project-config.md +2 -4
  257. package/runtime/skills/okstra-tdd/SKILL.md +187 -0
  258. package/runtime/skills/okstra-user-response/SKILL.md +4 -2
  259. package/runtime/templates/implementation-worker-preamble.md +4 -9
  260. package/runtime/templates/manager/view.template.html +4 -0
  261. package/runtime/templates/report-writer-prompt-preamble.md +15 -3
  262. package/runtime/templates/trace/trace.template.md +42 -0
  263. package/runtime/templates/worker-prompt-preamble.md +4 -12
  264. package/runtime/validators/checks/fixtures-02.py +25 -33
  265. package/runtime/validators/validate-run.py +107 -38
@@ -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>>;
@@ -0,0 +1,72 @@
1
+ import { createHash } from "node:crypto";
2
+ import { readBoundedUtf8 } from "../../lib/bounded-file.mjs";
3
+ import { assertInputLimit } from "../../lib/input-limit.mjs";
4
+ import { runPythonModule } from "../../lib/python-helper.mjs";
5
+ import { TraceError, isTraceTask, traceLocation } from "./model.mjs";
6
+ export class TaskSyncError extends TraceError {
7
+ details;
8
+ constructor(details, options) {
9
+ super("TASK_SYNC_FAILED", "Trace task projection did not complete; retry synchronization", options);
10
+ this.details = details;
11
+ }
12
+ }
13
+ export async function readTaskMetadata(state, taskKey, metadataPath) {
14
+ if (state.task && taskKey !== undefined && taskKey !== state.task.key)
15
+ throw new TraceError("TASK_KEY_MISMATCH", "An attempt's task key cannot change");
16
+ if (taskKey === undefined && metadataPath === undefined)
17
+ return state;
18
+ let metadata = {};
19
+ if (metadataPath !== undefined) {
20
+ try {
21
+ metadata = JSON.parse(await readBoundedUtf8(metadataPath, 16 * 1024));
22
+ }
23
+ catch (cause) {
24
+ if (cause instanceof Error && "code" in cause && cause.code === "INPUT_LIMIT_EXCEEDED")
25
+ throw cause;
26
+ throw new TraceError("INVALID_METADATA", "Metadata must contain readable JSON", { cause });
27
+ }
28
+ }
29
+ const fields = ["title", "summary", "tags", "changedFiles", "references", "relatedTasks"];
30
+ if (typeof metadata !== "object" || metadata === null || Array.isArray(metadata)
31
+ || !Object.keys(metadata).every((key) => fields.includes(key)))
32
+ throw new TraceError("INVALID_METADATA", "Unknown or invalid metadata fields");
33
+ const task = { title: state.slug, summary: "", tags: [], changedFiles: [], references: [], relatedTasks: [], ...state.task, ...metadata, key: state.task?.key ?? taskKey };
34
+ if (!isTraceTask(task))
35
+ throw new TraceError("INVALID_METADATA", "Task metadata has invalid field types or an empty title/key");
36
+ return { ...state, task };
37
+ }
38
+ export function requireTaskSummary(state) {
39
+ if (state.task && state.steps.integration.status === "done" && !state.task.summary.trim()) {
40
+ throw new TraceError("SUMMARY_REQUIRED", "A completed linked trace requires a feature summary");
41
+ }
42
+ }
43
+ export async function projectTraceTask(path, text, state, operation) {
44
+ if (!state.task)
45
+ return {};
46
+ const { projectRoot, tracePath } = traceLocation(path);
47
+ const request = {
48
+ tracePath,
49
+ digest: createHash("sha256").update(text, "utf8").digest("hex"),
50
+ createdAt: Date.parse(state.createdAt), currentStep: state.currentStep,
51
+ completed: state.steps.integration.status === "done", task: { key: state.task.key },
52
+ };
53
+ try {
54
+ const result = await runPythonModule({ module: "okstra_ctl.trace_tasks", args: [operation, "--project-root", projectRoot, "--request", JSON.stringify(request)], stdio: "capture", timeoutMs: 10_000 });
55
+ assertInputLimit(Buffer.byteLength(result.stdout, "utf8"), 4096, "Task projection response bytes");
56
+ const response = JSON.parse(result.stdout);
57
+ if (result.code !== 0 || typeof response !== "object" || response === null
58
+ || !("taskKey" in response) || response.taskKey !== state.task.key
59
+ || !("taskSync" in response) || typeof response.taskSync !== "string" || !["synced", "pending"].includes(response.taskSync))
60
+ throw new Error("Invalid task projection response");
61
+ if (operation === "sync" && response.taskSync !== "synced")
62
+ throw new Error("Task projection is pending");
63
+ return { taskKey: state.task.key, task: state.task, taskSync: response.taskSync };
64
+ }
65
+ catch (cause) {
66
+ if (operation === "status")
67
+ return { taskKey: state.task.key, task: state.task, taskSync: "pending" };
68
+ const quotedPath = `'${path.replaceAll("'", "'\\''")}'`;
69
+ throw new TaskSyncError({ traceSaved: true, path, taskKey: state.task.key, retry: `okstra trace sync --path ${quotedPath}` }, { cause });
70
+ }
71
+ }
72
+ //# sourceMappingURL=task-link.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"task-link.mjs","sourceRoot":"","sources":["../../../src/commands/trace/task-link.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAmB,MAAM,aAAa,CAAC;AAEtF,MAAM,OAAO,aAAc,SAAQ,UAAU;IACtB,OAAO;IAA5B,YAAqB,OAAkH,EAAE,OAAsB;QAC7J,KAAK,CAAC,kBAAkB,EAAE,+DAA+D,EAAE,OAAO,CAAC,CAAC;uBADjF,OAAO;IAE5B,CAAC;CACF;AACD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAiB,EAAE,OAA2B,EAAE,YAAgC;IACrH,IAAI,KAAK,CAAC,IAAI,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,CAAC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,UAAU,CAAC,mBAAmB,EAAE,qCAAqC,CAAC,CAAC;IACxJ,IAAI,OAAO,KAAK,SAAS,IAAI,YAAY,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACtE,IAAI,QAAQ,GAAY,EAAE,CAAC;IAC3B,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,IAAI,CAAC;YAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,eAAe,CAAC,YAAY,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;QAAC,CAAC;QAC9E,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,sBAAsB;gBAAE,MAAM,KAAK,CAAC;YACpG,MAAM,IAAI,UAAU,CAAC,kBAAkB,EAAE,qCAAqC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7F,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC;IAC1F,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;WAC3E,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,kBAAkB,EAAE,oCAAoC,CAAC,CAAC;IACjJ,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,GAAG,IAAI,OAAO,EAAE,CAAC;IAC3K,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,kBAAkB,EAAE,6DAA6D,CAAC,CAAC;IAChI,OAAO,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;AAC5B,CAAC;AACD,MAAM,UAAU,kBAAkB,CAAC,KAAiB;IAClD,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QAC1F,MAAM,IAAI,UAAU,CAAC,kBAAkB,EAAE,qDAAqD,CAAC,CAAC;IAClG,CAAC;AACH,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAY,EAAE,IAAY,EAAE,KAAiB,EAAE,SAA4B;IAChH,IAAI,CAAC,KAAK,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IAC3B,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG;QACd,SAAS;QACT,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QAC/D,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW;QACtE,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,KAAK,MAAM,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE;KACpF,CAAC;IACF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,EAAE,MAAM,EAAE,wBAAwB,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,gBAAgB,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QACxM,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,gCAAgC,CAAC,CAAC;QACnG,MAAM,QAAQ,GAAY,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACpD,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI;eACrE,CAAC,CAAC,SAAS,IAAI,QAAQ,CAAC,IAAI,QAAQ,CAAC,OAAO,KAAK,KAAK,CAAC,IAAI,CAAC,GAAG;eAC/D,CAAC,CAAC,UAAU,IAAI,QAAQ,CAAC,IAAI,OAAO,QAAQ,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACnL,IAAI,SAAS,KAAK,MAAM,IAAI,QAAQ,CAAC,QAAQ,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC1G,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC;IACpF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,SAAS,KAAK,QAAQ;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;QACtG,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC;QACxD,MAAM,IAAI,aAAa,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,4BAA4B,UAAU,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3I,CAAC;AACH,CAAC"}
@@ -0,0 +1 @@
1
+ export declare function run(argv: readonly string[]): Promise<number>;