okstra 0.232.0 → 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.
- package/README.md +19 -283
- package/dist/cli-registry.mjs +8 -1
- package/dist/cli-registry.mjs.map +1 -1
- package/dist/commands/execute/render-bundle.d.mts +6 -1
- package/dist/commands/execute/render-bundle.mjs +139 -32
- package/dist/commands/execute/render-bundle.mjs.map +1 -1
- package/dist/commands/lifecycle/config.mjs +6 -74
- package/dist/commands/lifecycle/config.mjs.map +1 -1
- package/dist/commands/trace/capacity.d.mts +12 -0
- package/dist/commands/trace/capacity.mjs +21 -0
- package/dist/commands/trace/capacity.mjs.map +1 -0
- package/dist/commands/trace/model.d.mts +89 -0
- package/dist/commands/trace/model.mjs +251 -0
- package/dist/commands/trace/model.mjs.map +1 -0
- package/dist/commands/trace/progression.d.mts +11 -0
- package/dist/commands/trace/progression.mjs +194 -0
- package/dist/commands/trace/progression.mjs.map +1 -0
- package/dist/commands/trace/review.d.mts +7 -0
- package/dist/commands/trace/review.mjs +51 -0
- package/dist/commands/trace/review.mjs.map +1 -0
- package/dist/commands/trace/task-link.d.mts +18 -0
- package/dist/commands/trace/task-link.mjs +72 -0
- package/dist/commands/trace/task-link.mjs.map +1 -0
- package/dist/commands/trace/trace.d.mts +1 -0
- package/dist/commands/trace/trace.mjs +293 -0
- package/dist/commands/trace/trace.mjs.map +1 -0
- package/dist/lib/bounded-file.d.mts +1 -0
- package/dist/lib/bounded-file.mjs +36 -0
- package/dist/lib/bounded-file.mjs.map +1 -0
- package/dist/lib/config-store.d.mts +34 -0
- package/dist/lib/config-store.mjs +70 -0
- package/dist/lib/config-store.mjs.map +1 -0
- package/dist/lib/file-lock.mjs +4 -5
- package/dist/lib/file-lock.mjs.map +1 -1
- package/dist/lib/input-limit.d.mts +4 -0
- package/dist/lib/input-limit.mjs +8 -0
- package/dist/lib/input-limit.mjs.map +1 -0
- package/dist/lib/memory-auto-register.mjs +2 -17
- package/dist/lib/memory-auto-register.mjs.map +1 -1
- package/dist/lib/report-language-tag.d.mts +1 -0
- package/dist/lib/report-language-tag.mjs +4 -0
- package/dist/lib/report-language-tag.mjs.map +1 -0
- package/dist/lib/report-language.d.mts +1 -0
- package/dist/lib/report-language.mjs +50 -0
- package/dist/lib/report-language.mjs.map +1 -0
- package/dist/lib/skill-catalog.mjs +3 -0
- package/dist/lib/skill-catalog.mjs.map +1 -1
- package/docs/architecture/storage-model.md +36 -5
- package/docs/architecture.md +10 -4
- package/docs/cli.md +279 -2
- package/docs/contributor-change-matrix.md +1 -2
- package/docs/project-structure-overview.md +31 -41
- package/package.json +1 -1
- package/runtime/BUILD.json +2 -2
- package/runtime/agents/operations/trace-interface-review.json +6 -0
- package/runtime/agents/operations/trace-scope-review.json +6 -0
- package/runtime/prompts/coding-preflight/authoring-checks.md +1 -1
- package/runtime/prompts/coding-preflight/clean-code.md +18 -20
- package/runtime/prompts/coding-preflight/overview.md +1 -1
- package/runtime/prompts/duties/code-reviewer.json +1 -1
- package/runtime/prompts/duties/interface-reviewer.json +32 -0
- package/runtime/prompts/host-orchestration/README.md +18 -9
- package/runtime/prompts/launch.template.md +3 -2
- package/runtime/prompts/lead/context-loader.md +2 -0
- package/runtime/prompts/lead/okstra-lead-contract.md +7 -7
- package/runtime/prompts/lead/report-writer.md +6 -6
- package/runtime/prompts/profiles/_coding-conventions-preflight.md +2 -2
- package/runtime/prompts/profiles/_common-contract.md +1 -1
- package/runtime/python/okstra_ctl/agent/invocation.py +1 -0
- package/runtime/python/okstra_ctl/agent/prompt_cli/cli.py +66 -26
- package/runtime/python/okstra_ctl/agent/prompt_cli/corrections.py +23 -8
- package/runtime/python/okstra_ctl/agent/prompt_cli/materialize.py +28 -10
- package/runtime/python/okstra_ctl/agent/prompt_cli/results.py +8 -11
- package/runtime/python/okstra_ctl/agent/standalone.py +12 -0
- package/runtime/python/okstra_ctl/analysis_packet.py +22 -11
- package/runtime/python/okstra_ctl/code_review_census.py +93 -2
- package/runtime/python/okstra_ctl/code_review_prepare.py +381 -0
- package/runtime/python/okstra_ctl/code_review_run.py +384 -0
- package/runtime/python/okstra_ctl/code_review_scope.py +13 -0
- package/runtime/python/okstra_ctl/code_review_supervisor.py +41 -0
- package/runtime/python/okstra_ctl/code_review_target.py +140 -15
- package/runtime/python/okstra_ctl/coverage_census.py +11 -2
- package/runtime/python/okstra_ctl/design_snapshot.py +16 -9
- package/runtime/python/okstra_ctl/direct_work.py +45 -3
- package/runtime/python/okstra_ctl/dispatch_core.py +31 -15
- package/runtime/python/okstra_ctl/dispatch_state.py +9 -2
- package/runtime/python/okstra_ctl/domain/role.py +1 -0
- package/runtime/python/okstra_ctl/doyouknow/sources/manager.py +48 -9
- package/runtime/python/okstra_ctl/final_report_schema.py +37 -34
- package/runtime/python/okstra_ctl/incremental_carry.py +6 -7
- package/runtime/python/okstra_ctl/initial_prompt_materialization.py +9 -2
- package/runtime/python/okstra_ctl/json_boundary.py +33 -6
- package/runtime/python/okstra_ctl/manager_cli.py +122 -1
- package/runtime/python/okstra_ctl/manager_journal.py +126 -0
- package/runtime/python/okstra_ctl/manager_launch.py +3 -3
- package/runtime/python/okstra_ctl/manager_log.py +221 -0
- package/runtime/python/okstra_ctl/manager_paths.py +8 -0
- package/runtime/python/okstra_ctl/manager_resume.py +59 -0
- package/runtime/python/okstra_ctl/manager_split.py +2 -2
- package/runtime/python/okstra_ctl/manager_store.py +116 -17
- package/runtime/python/okstra_ctl/manager_sync.py +42 -3
- package/runtime/python/okstra_ctl/manager_view.py +35 -2
- package/runtime/python/okstra_ctl/material.py +2 -0
- package/runtime/python/okstra_ctl/model_cli.py +64 -14
- package/runtime/python/okstra_ctl/model_defaults.py +22 -0
- package/runtime/python/okstra_ctl/model_io/renderers.py +3 -0
- package/runtime/python/okstra_ctl/operation_invocation.py +207 -28
- package/runtime/python/okstra_ctl/path_hints.py +14 -3
- package/runtime/python/okstra_ctl/paths.py +6 -1
- package/runtime/python/okstra_ctl/phases/catalog.py +24 -7
- package/runtime/python/okstra_ctl/phases/implementation/host-rules.md +3 -3
- package/runtime/python/okstra_ctl/phases/implementation/instructions/_implementation-diff-review.md +8 -6
- package/runtime/python/okstra_ctl/phases/implementation/instructions/_implementation-self-check.md +1 -1
- package/runtime/python/okstra_ctl/phases/implementation_option_selection/profile.md +1 -1
- package/runtime/python/okstra_ctl/phases/implementation_option_selection/votes.py +11 -11
- package/runtime/python/okstra_ctl/phases/implementation_planning/authoring.py +12 -9
- package/runtime/python/okstra_ctl/phases/implementation_planning/host-rules.md +3 -6
- package/runtime/python/okstra_ctl/phases/implementation_planning/instructions/plan-body-verification.md +12 -10
- package/runtime/python/okstra_ctl/phases/implementation_planning/profile.md +5 -5
- package/runtime/python/okstra_ctl/phases/improvement_discovery/lenses.py +12 -0
- package/runtime/python/okstra_ctl/phases/improvement_discovery/profile.md +7 -6
- package/runtime/python/okstra_ctl/phases/improvement_discovery/resolved_census.py +159 -0
- package/runtime/python/okstra_ctl/phases/improvement_discovery/spec.md +5 -2
- package/runtime/python/okstra_ctl/phases/improvement_discovery/validation.py +21 -7
- package/runtime/python/okstra_ctl/phases/release_handoff/boundary.json +1 -1
- package/runtime/python/okstra_ctl/phases/release_handoff/profile.md +4 -1
- package/runtime/python/okstra_ctl/plan_verify_cli.py +6 -4
- package/runtime/python/okstra_ctl/render.py +28 -2
- package/runtime/python/okstra_ctl/report_assembly.py +38 -11
- package/runtime/python/okstra_ctl/report_contract.py +26 -0
- package/runtime/python/okstra_ctl/report_corrections.py +36 -20
- package/runtime/python/okstra_ctl/report_inputs.py +1 -0
- package/runtime/python/okstra_ctl/report_language.py +4 -1
- package/runtime/python/okstra_ctl/report_narrative.py +179 -7
- package/runtime/python/okstra_ctl/report_projections.py +64 -18
- package/runtime/python/okstra_ctl/report_synthesis_packet.py +86 -36
- package/runtime/python/okstra_ctl/run.py +43 -35
- package/runtime/python/okstra_ctl/run_context.py +10 -1
- package/runtime/python/okstra_ctl/set_work_status.py +4 -15
- package/runtime/python/okstra_ctl/task_list_cli.py +34 -8
- package/runtime/python/okstra_ctl/task_query.py +239 -0
- package/runtime/python/okstra_ctl/trace_review.py +264 -0
- package/runtime/python/okstra_ctl/trace_tasks.py +197 -0
- package/runtime/python/okstra_ctl/user_authorization.py +14 -0
- package/runtime/python/okstra_ctl/wizard/confirmation.py +7 -3
- package/runtime/python/okstra_ctl/wizard/launch.py +52 -0
- package/runtime/python/okstra_ctl/wizard/launch_cli.py +39 -0
- package/runtime/python/okstra_ctl/wizard/outcome.py +17 -16
- package/runtime/python/okstra_ctl/wizard/registry.py +1 -1
- package/runtime/python/okstra_ctl/wizard/render.py +8 -0
- package/runtime/python/okstra_ctl/wizard/state.py +2 -1
- package/runtime/python/okstra_project/state.py +20 -0
- package/runtime/python/okstra_token_usage/blocks.py +74 -0
- package/runtime/python/okstra_token_usage/cli.py +23 -10
- package/runtime/python/okstra_token_usage/collect.py +25 -22
- package/runtime/python/okstra_token_usage/policy.py +193 -0
- package/runtime/schemas/report-synthesis-packet-v1.0.schema.json +1 -1
- package/runtime/skills/_fragments/wizard-confirm-step.md +1 -1
- package/runtime/skills/_fragments/wizard-preflight.md +1 -1
- package/runtime/skills/_fragments/wizard-prompt-loop.md +3 -5
- package/runtime/skills/_fragments/wizard-relay-protocol.md +1 -1
- package/runtime/skills/_fragments/wizard-render-bundle.md +15 -29
- package/runtime/skills/okstra-brief-gen/SKILL.md +7 -7
- package/runtime/skills/okstra-brief-gen/references/tracker-recursion.md +1 -1
- package/runtime/skills/okstra-code-review/SKILL.md +58 -50
- package/runtime/skills/okstra-code-review/references/census-rules.md +6 -6
- package/runtime/skills/okstra-code-review/references/review-calibration.md +8 -12
- package/runtime/skills/okstra-discussion/SKILL.md +22 -38
- package/runtime/skills/okstra-explain-flow/SKILL.md +6 -2
- package/runtime/skills/okstra-manager/SKILL.md +24 -0
- package/runtime/skills/okstra-memory/SKILL.md +1 -1
- package/runtime/skills/okstra-pr-gen/SKILL.md +1 -1
- package/runtime/skills/okstra-run/SKILL.md +55 -183
- package/runtime/skills/okstra-schedule-gen/SKILL.md +9 -13
- package/runtime/skills/okstra-setup/SKILL.md +3 -2
- package/runtime/skills/okstra-setup/references/project-config.md +2 -4
- package/runtime/skills/okstra-tdd/SKILL.md +187 -0
- package/runtime/skills/okstra-user-response/SKILL.md +4 -2
- package/runtime/templates/manager/view.template.html +4 -0
- package/runtime/templates/report-writer-prompt-preamble.md +15 -3
- package/runtime/templates/trace/trace.template.md +42 -0
- package/runtime/validators/checks/fixtures-02.py +25 -33
- 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":"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"}
|
|
@@ -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>>;
|