@popoverai/dotrequirements 0.26.0 → 0.26.1
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/dist/codebase-to-spec/area-name.d.ts +13 -0
- package/dist/codebase-to-spec/area-name.js +18 -0
- package/dist/codebase-to-spec/cache.d.ts +31 -0
- package/dist/codebase-to-spec/cache.js +29 -1
- package/dist/codebase-to-spec/compose.d.ts +7 -4
- package/dist/codebase-to-spec/compose.js +10 -21
- package/dist/codebase-to-spec/dispatch.js +1 -1
- package/dist/codebase-to-spec/present.js +7 -2
- package/dist/codebase-to-spec/prompts/planner-initial.d.ts +3 -2
- package/dist/codebase-to-spec/prompts/planner-initial.js +3 -2
- package/dist/codebase-to-spec/renumber.d.ts +52 -0
- package/dist/codebase-to-spec/renumber.js +105 -0
- package/dist/codebase-to-spec/schemas.d.ts +35 -240
- package/dist/codebase-to-spec/schemas.js +5 -173
- package/dist/commands/codebase-to-spec/dispatch-editor.js +1 -1
- package/dist/commands/codebase-to-spec/dispatch-spec.js +1 -1
- package/dist/commands/codebase-to-spec/index.js +7 -103
- package/dist/commands/codebase-to-spec/pack.js +8 -1
- package/dist/commands/codebase-to-spec/present-orchestrator.d.ts +3 -1
- package/dist/commands/codebase-to-spec/present-orchestrator.js +11 -4
- package/dist/templates/skills/codebase-to-spec/SKILL.md +10 -4
- package/package.json +1 -1
- package/dist/codebase-to-spec/edit-loop.d.ts +0 -54
- package/dist/codebase-to-spec/edit-loop.js +0 -195
- package/dist/codebase-to-spec/editor.d.ts +0 -54
- package/dist/codebase-to-spec/editor.js +0 -74
- package/dist/codebase-to-spec/fan-out.d.ts +0 -63
- package/dist/codebase-to-spec/fan-out.js +0 -215
- package/dist/codebase-to-spec/outline-review-loop.d.ts +0 -51
- package/dist/codebase-to-spec/outline-review-loop.js +0 -187
- package/dist/codebase-to-spec/planner.d.ts +0 -41
- package/dist/codebase-to-spec/planner.js +0 -76
- package/dist/codebase-to-spec/prompts/outline-reviewer.d.ts +0 -12
- package/dist/codebase-to-spec/prompts/outline-reviewer.js +0 -89
- package/dist/codebase-to-spec/slice.d.ts +0 -49
- package/dist/codebase-to-spec/slice.js +0 -111
- package/dist/codebase-to-spec/specifier.d.ts +0 -60
- package/dist/codebase-to-spec/specifier.js +0 -85
- package/dist/codebase-to-spec/summary.d.ts +0 -51
- package/dist/codebase-to-spec/summary.js +0 -183
- package/dist/commands/codebase-to-spec/compose.d.ts +0 -14
- package/dist/commands/codebase-to-spec/compose.js +0 -57
- package/dist/commands/codebase-to-spec/edit-loop.d.ts +0 -16
- package/dist/commands/codebase-to-spec/edit-loop.js +0 -83
- package/dist/commands/codebase-to-spec/fan-out.d.ts +0 -19
- package/dist/commands/codebase-to-spec/fan-out.js +0 -77
- package/dist/commands/codebase-to-spec/plan-loop.d.ts +0 -26
- package/dist/commands/codebase-to-spec/plan-loop.js +0 -105
- package/dist/commands/codebase-to-spec/present.d.ts +0 -26
- package/dist/commands/codebase-to-spec/present.js +0 -97
- package/dist/commands/codebase-to-spec/run.d.ts +0 -20
- package/dist/commands/codebase-to-spec/run.js +0 -86
- package/dist/commands/codebase-to-spec/specify-area.d.ts +0 -18
- package/dist/commands/codebase-to-spec/specify-area.js +0 -82
|
@@ -1,183 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Pipeline summary generation.
|
|
3
|
-
*
|
|
4
|
-
* Reads cached artifacts to assemble a structured summary of what the
|
|
5
|
-
* pipeline produced. Surfaced both as JSON (parseable by wrappers like the
|
|
6
|
-
* skill) and as a short human-readable block.
|
|
7
|
-
*
|
|
8
|
-
* Requirements covered:
|
|
9
|
-
* - CTS-PRESENT-4: Final pipeline summary is surfaced
|
|
10
|
-
* - CTS-OBSERVE-2 (partial): structured failure information available
|
|
11
|
-
*/
|
|
12
|
-
import { existsSync, readFileSync, statSync } from "node:fs";
|
|
13
|
-
import { sanitizeAreaName } from "./fan-out.js";
|
|
14
|
-
import { parseOutlineReview, parseSpecReview, } from "./schemas.js";
|
|
15
|
-
/**
|
|
16
|
-
* Count top-level requirements in a file by counting fenced
|
|
17
|
-
* \`\`\`dotrequirements blocks. Each block represents one root requirement
|
|
18
|
-
* (CTS-OBSERVE-2 counts each requirement ID once, excluding child criteria).
|
|
19
|
-
*/
|
|
20
|
-
function countRequirementsInFile(path) {
|
|
21
|
-
if (!existsSync(path))
|
|
22
|
-
return 0;
|
|
23
|
-
const content = readFileSync(path, "utf-8");
|
|
24
|
-
const matches = content.match(/```dotrequirements\b/g);
|
|
25
|
-
return matches ? matches.length : 0;
|
|
26
|
-
}
|
|
27
|
-
/**
|
|
28
|
-
* Look at outline-review-N.json files in the cache and return how many turns
|
|
29
|
-
* ran and what the final verdict was. Returns {turnsUsed: 0, finalVerdict: null}
|
|
30
|
-
* if no review artifacts exist.
|
|
31
|
-
*/
|
|
32
|
-
function summarizeOutlineReview(paths) {
|
|
33
|
-
let n = 0;
|
|
34
|
-
let lastReviewPath = null;
|
|
35
|
-
while (true) {
|
|
36
|
-
const path = paths.outlineReviewTurn(n + 1);
|
|
37
|
-
if (!existsSync(path))
|
|
38
|
-
break;
|
|
39
|
-
n++;
|
|
40
|
-
lastReviewPath = path;
|
|
41
|
-
}
|
|
42
|
-
if (!lastReviewPath)
|
|
43
|
-
return { turnsUsed: 0, finalVerdict: null, residualNotes: [] };
|
|
44
|
-
try {
|
|
45
|
-
const review = parseOutlineReview(readFileSync(lastReviewPath, "utf-8"));
|
|
46
|
-
const notes = [];
|
|
47
|
-
// Surface unresolved findings as residual notes if verdict isn't 'approved'.
|
|
48
|
-
if (review.verdict !== "approved") {
|
|
49
|
-
for (const cat of [
|
|
50
|
-
["coverage_gap", review.coverage_gaps],
|
|
51
|
-
["framing_error", review.framing_errors],
|
|
52
|
-
["granularity", review.granularity_issues],
|
|
53
|
-
["file_assignment", review.file_assignment_issues],
|
|
54
|
-
]) {
|
|
55
|
-
for (const note of cat[1]) {
|
|
56
|
-
notes.push(`outline.${cat[0]}: ${note}`);
|
|
57
|
-
}
|
|
58
|
-
}
|
|
59
|
-
}
|
|
60
|
-
return { turnsUsed: n, finalVerdict: review.verdict, residualNotes: notes };
|
|
61
|
-
}
|
|
62
|
-
catch {
|
|
63
|
-
return { turnsUsed: n, finalVerdict: null, residualNotes: [] };
|
|
64
|
-
}
|
|
65
|
-
}
|
|
66
|
-
function summarizeSpecReview(paths) {
|
|
67
|
-
let n = 0;
|
|
68
|
-
let lastReviewPath = null;
|
|
69
|
-
while (true) {
|
|
70
|
-
const path = paths.specReviewTurn(n + 1);
|
|
71
|
-
if (!existsSync(path))
|
|
72
|
-
break;
|
|
73
|
-
n++;
|
|
74
|
-
lastReviewPath = path;
|
|
75
|
-
}
|
|
76
|
-
if (!lastReviewPath)
|
|
77
|
-
return { turnsUsed: 0, finalVerdict: null, residualNotes: [] };
|
|
78
|
-
try {
|
|
79
|
-
const review = parseSpecReview(readFileSync(lastReviewPath, "utf-8"));
|
|
80
|
-
const notes = [];
|
|
81
|
-
if (review.verdict !== "approved") {
|
|
82
|
-
for (const cat of [
|
|
83
|
-
["coverage_gap", review.coverage_gaps],
|
|
84
|
-
["framing_error", review.framing_errors],
|
|
85
|
-
["cross_area", review.cross_area_issues],
|
|
86
|
-
["internal_mechanics", review.internal_mechanics_drift],
|
|
87
|
-
]) {
|
|
88
|
-
for (const note of cat[1]) {
|
|
89
|
-
notes.push(`spec.${cat[0]}: ${note}`);
|
|
90
|
-
}
|
|
91
|
-
}
|
|
92
|
-
}
|
|
93
|
-
return { turnsUsed: n, finalVerdict: review.verdict, residualNotes: notes };
|
|
94
|
-
}
|
|
95
|
-
catch {
|
|
96
|
-
return { turnsUsed: n, finalVerdict: null, residualNotes: [] };
|
|
97
|
-
}
|
|
98
|
-
}
|
|
99
|
-
function summarizeSpecifiers(outline, paths) {
|
|
100
|
-
let completed = 0;
|
|
101
|
-
const missingAreas = [];
|
|
102
|
-
for (const area of outline.areas) {
|
|
103
|
-
const partialPath = paths.partial(sanitizeAreaName(area.name));
|
|
104
|
-
if (!existsSync(partialPath)) {
|
|
105
|
-
missingAreas.push(area.name);
|
|
106
|
-
continue;
|
|
107
|
-
}
|
|
108
|
-
const content = readFileSync(partialPath, "utf-8").trim();
|
|
109
|
-
if (!content ||
|
|
110
|
-
content.startsWith("_(missing partial") ||
|
|
111
|
-
content.startsWith("_(no files")) {
|
|
112
|
-
missingAreas.push(area.name);
|
|
113
|
-
continue;
|
|
114
|
-
}
|
|
115
|
-
completed++;
|
|
116
|
-
}
|
|
117
|
-
return { completed, missing: missingAreas.length, missingAreas };
|
|
118
|
-
}
|
|
119
|
-
export function buildPipelineSummary(input) {
|
|
120
|
-
const { outline, paths, outputPaths } = input;
|
|
121
|
-
const outlineReview = summarizeOutlineReview(paths);
|
|
122
|
-
const specReview = summarizeSpecReview(paths);
|
|
123
|
-
const specifiers = summarizeSpecifiers(outline, paths);
|
|
124
|
-
// Count top-level requirements across all written .requirements/ files.
|
|
125
|
-
let totalRequirements = 0;
|
|
126
|
-
for (const path of outputPaths) {
|
|
127
|
-
totalRequirements += countRequirementsInFile(path);
|
|
128
|
-
}
|
|
129
|
-
// Fall back to counting the final cached spec if nothing was written (e.g.
|
|
130
|
-
// dry-run / interrupted) — that way the summary still reflects what the
|
|
131
|
-
// pipeline produced.
|
|
132
|
-
if (totalRequirements === 0 && existsSync(paths.specFinal)) {
|
|
133
|
-
totalRequirements = countRequirementsInFile(paths.specFinal);
|
|
134
|
-
}
|
|
135
|
-
return {
|
|
136
|
-
totalAreas: outline.areas.length,
|
|
137
|
-
totalRequirements,
|
|
138
|
-
outline: outlineReview,
|
|
139
|
-
specifiers,
|
|
140
|
-
specReview,
|
|
141
|
-
outputs: { paths: outputPaths },
|
|
142
|
-
};
|
|
143
|
-
}
|
|
144
|
-
/**
|
|
145
|
-
* Render a short human-readable block for the summary. Designed to fit on a
|
|
146
|
-
* small number of lines (CTS-PRESENT-4.2). Wrappers that want richer
|
|
147
|
-
* presentation can read the JSON form instead.
|
|
148
|
-
*/
|
|
149
|
-
export function renderSummaryText(summary) {
|
|
150
|
-
const lines = [];
|
|
151
|
-
lines.push(`Pipeline summary:`);
|
|
152
|
-
lines.push(` Areas: ${summary.totalAreas}`);
|
|
153
|
-
lines.push(` Top-level reqs: ${summary.totalRequirements}`);
|
|
154
|
-
lines.push(` Outline review: ${summary.outline.turnsUsed} turn(s), verdict: ${summary.outline.finalVerdict ?? "n/a"}`);
|
|
155
|
-
lines.push(` Specifiers: ${summary.specifiers.completed} completed, ${summary.specifiers.missing} missing`);
|
|
156
|
-
lines.push(` Spec review: ${summary.specReview.turnsUsed} turn(s), verdict: ${summary.specReview.finalVerdict ?? "n/a"}`);
|
|
157
|
-
lines.push(` Output files:`);
|
|
158
|
-
for (const path of summary.outputs.paths) {
|
|
159
|
-
lines.push(` - ${path}`);
|
|
160
|
-
}
|
|
161
|
-
if (summary.outline.residualNotes.length ||
|
|
162
|
-
summary.specReview.residualNotes.length) {
|
|
163
|
-
lines.push(``);
|
|
164
|
-
lines.push(` Residual notes (worth reviewing manually):`);
|
|
165
|
-
for (const note of [
|
|
166
|
-
...summary.outline.residualNotes,
|
|
167
|
-
...summary.specReview.residualNotes,
|
|
168
|
-
]) {
|
|
169
|
-
lines.push(` - ${note}`);
|
|
170
|
-
}
|
|
171
|
-
}
|
|
172
|
-
if (summary.specifiers.missingAreas.length) {
|
|
173
|
-
lines.push(``);
|
|
174
|
-
lines.push(` Missing specifier output for:`);
|
|
175
|
-
for (const area of summary.specifiers.missingAreas) {
|
|
176
|
-
lines.push(` - ${area}`);
|
|
177
|
-
}
|
|
178
|
-
}
|
|
179
|
-
return lines.join("\n");
|
|
180
|
-
}
|
|
181
|
-
/** Suppress unused-var warning. */
|
|
182
|
-
void statSync;
|
|
183
|
-
//# sourceMappingURL=summary.js.map
|
|
@@ -1,14 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* `dotrequirements codebase-to-spec compose` subcommand.
|
|
3
|
-
*
|
|
4
|
-
* Assembles per-area partials into a single composed Markdown document.
|
|
5
|
-
*
|
|
6
|
-
* Requirements covered:
|
|
7
|
-
* - CTS-CLI-2: granular `compose` subcommand
|
|
8
|
-
* - CTS-COMPOSE-1, CTS-COMPOSE-2
|
|
9
|
-
*/
|
|
10
|
-
export interface ComposeCmdOptions {
|
|
11
|
-
projectRoot?: string;
|
|
12
|
-
}
|
|
13
|
-
export declare function composeCommand(options?: ComposeCmdOptions): Promise<void>;
|
|
14
|
-
//# sourceMappingURL=compose.d.ts.map
|
|
@@ -1,57 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* `dotrequirements codebase-to-spec compose` subcommand.
|
|
3
|
-
*
|
|
4
|
-
* Assembles per-area partials into a single composed Markdown document.
|
|
5
|
-
*
|
|
6
|
-
* Requirements covered:
|
|
7
|
-
* - CTS-CLI-2: granular `compose` subcommand
|
|
8
|
-
* - CTS-COMPOSE-1, CTS-COMPOSE-2
|
|
9
|
-
*/
|
|
10
|
-
import { existsSync } from "node:fs";
|
|
11
|
-
import { cachePaths } from "../../codebase-to-spec/cache.js";
|
|
12
|
-
import { runCompose } from "../../codebase-to-spec/compose.js";
|
|
13
|
-
import { ExitCode } from "../../codebase-to-spec/exit-codes.js";
|
|
14
|
-
import { StdoutProgress } from "../../codebase-to-spec/progress.js";
|
|
15
|
-
import { findProjectRoot } from "../../utils/project-settings.js";
|
|
16
|
-
import { readFinalOutline } from "./plan-loop.js";
|
|
17
|
-
export async function composeCommand(options = {}) {
|
|
18
|
-
const progress = new StdoutProgress();
|
|
19
|
-
const projectRoot = options.projectRoot ?? findProjectRoot(process.cwd()) ?? process.cwd();
|
|
20
|
-
const paths = cachePaths(projectRoot);
|
|
21
|
-
if (!existsSync(paths.outlineFinal)) {
|
|
22
|
-
process.stderr.write(`Missing outline at ${paths.outlineFinal}. Run \`dotrequirements cts plan-loop\` first.\n`);
|
|
23
|
-
process.exitCode = ExitCode.MissingInput;
|
|
24
|
-
return;
|
|
25
|
-
}
|
|
26
|
-
const outline = readFinalOutline(projectRoot);
|
|
27
|
-
progress.emit({
|
|
28
|
-
stage: "compose",
|
|
29
|
-
step: "start",
|
|
30
|
-
message: `Composing spec from ${outline.areas.length} area partials`,
|
|
31
|
-
});
|
|
32
|
-
const result = runCompose({
|
|
33
|
-
outline,
|
|
34
|
-
partialPathFor: (sanitized) => paths.partial(sanitized),
|
|
35
|
-
composedPath: paths.composedSpec,
|
|
36
|
-
});
|
|
37
|
-
progress.emit({
|
|
38
|
-
stage: "compose",
|
|
39
|
-
step: "done",
|
|
40
|
-
message: `Composed spec → ${result.composedPath} (${result.partialsIncluded} partials included, ${result.partialsMissing} missing)`,
|
|
41
|
-
data: {
|
|
42
|
-
partialsIncluded: result.partialsIncluded,
|
|
43
|
-
partialsMissing: result.partialsMissing,
|
|
44
|
-
},
|
|
45
|
-
});
|
|
46
|
-
if (result.validationError) {
|
|
47
|
-
process.stderr.write(`Composed spec failed validation:\n${result.validationError}\n`);
|
|
48
|
-
process.exitCode = ExitCode.StageFailed;
|
|
49
|
-
return;
|
|
50
|
-
}
|
|
51
|
-
progress.emit({
|
|
52
|
-
stage: "compose",
|
|
53
|
-
step: "validation-ok",
|
|
54
|
-
message: "Composed spec passed schema validation",
|
|
55
|
-
});
|
|
56
|
-
}
|
|
57
|
-
//# sourceMappingURL=compose.js.map
|
|
@@ -1,16 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* `dotrequirements codebase-to-spec edit-loop` subcommand.
|
|
3
|
-
*
|
|
4
|
-
* Runs the spec review + editor loop over the composed spec.
|
|
5
|
-
*
|
|
6
|
-
* Requirements covered:
|
|
7
|
-
* - CTS-CLI-2: granular `edit-loop` subcommand
|
|
8
|
-
* - CTS-EDIT-1..6: end-to-end loop behavior
|
|
9
|
-
*/
|
|
10
|
-
export interface EditLoopCmdOptions {
|
|
11
|
-
maxTurns?: number;
|
|
12
|
-
model?: string;
|
|
13
|
-
projectRoot?: string;
|
|
14
|
-
}
|
|
15
|
-
export declare function editLoopCommand(rawOptions?: EditLoopCmdOptions): Promise<void>;
|
|
16
|
-
//# sourceMappingURL=edit-loop.d.ts.map
|
|
@@ -1,83 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* `dotrequirements codebase-to-spec edit-loop` subcommand.
|
|
3
|
-
*
|
|
4
|
-
* Runs the spec review + editor loop over the composed spec.
|
|
5
|
-
*
|
|
6
|
-
* Requirements covered:
|
|
7
|
-
* - CTS-CLI-2: granular `edit-loop` subcommand
|
|
8
|
-
* - CTS-EDIT-1..6: end-to-end loop behavior
|
|
9
|
-
*/
|
|
10
|
-
import { copyFileSync, existsSync, writeFileSync } from "node:fs";
|
|
11
|
-
import { cachePaths } from "../../codebase-to-spec/cache.js";
|
|
12
|
-
import { DEFAULT_EDIT_LOOP_MAX_TURNS, runEditLoop, } from "../../codebase-to-spec/edit-loop.js";
|
|
13
|
-
import { ExitCode } from "../../codebase-to-spec/exit-codes.js";
|
|
14
|
-
import { StdoutProgress } from "../../codebase-to-spec/progress.js";
|
|
15
|
-
import { findProjectRoot } from "../../utils/project-settings.js";
|
|
16
|
-
export async function editLoopCommand(rawOptions = {}) {
|
|
17
|
-
const progress = new StdoutProgress();
|
|
18
|
-
const projectRoot = rawOptions.projectRoot ?? findProjectRoot(process.cwd()) ?? process.cwd();
|
|
19
|
-
const paths = cachePaths(projectRoot);
|
|
20
|
-
const maxTurns = rawOptions.maxTurns ?? DEFAULT_EDIT_LOOP_MAX_TURNS;
|
|
21
|
-
if (!existsSync(paths.composedSpec)) {
|
|
22
|
-
process.stderr.write(`Missing composed spec at ${paths.composedSpec}. Run \`dotrequirements cts compose\` first.\n`);
|
|
23
|
-
process.exitCode = ExitCode.MissingInput;
|
|
24
|
-
return;
|
|
25
|
-
}
|
|
26
|
-
if (!existsSync(paths.source)) {
|
|
27
|
-
process.stderr.write(`Missing uncompressed pack at ${paths.source}. Run \`dotrequirements cts pack\` first.\n`);
|
|
28
|
-
process.exitCode = ExitCode.MissingInput;
|
|
29
|
-
return;
|
|
30
|
-
}
|
|
31
|
-
progress.emit({
|
|
32
|
-
stage: "spec-review",
|
|
33
|
-
step: "start",
|
|
34
|
-
message: `Starting spec review + edit loop (max-turns=${maxTurns})`,
|
|
35
|
-
});
|
|
36
|
-
let result;
|
|
37
|
-
try {
|
|
38
|
-
result = await runEditLoop({
|
|
39
|
-
composedSpecPath: paths.composedSpec,
|
|
40
|
-
specVersionFor: (turn) => paths.specVersion(turn),
|
|
41
|
-
fullPackPath: paths.source,
|
|
42
|
-
addDirs: [paths.root],
|
|
43
|
-
maxTurns,
|
|
44
|
-
model: rawOptions.model,
|
|
45
|
-
progress,
|
|
46
|
-
});
|
|
47
|
-
}
|
|
48
|
-
catch (err) {
|
|
49
|
-
process.stderr.write(`\nEdit loop failed: ${err instanceof Error ? err.message : String(err)}\n`);
|
|
50
|
-
process.exitCode = ExitCode.StageFailed;
|
|
51
|
-
return;
|
|
52
|
-
}
|
|
53
|
-
// Persist per-turn reviewer output (JSON).
|
|
54
|
-
result.reviewsByTurn.forEach((review, idx) => {
|
|
55
|
-
writeFileSync(paths.specReviewTurn(idx + 1), `${JSON.stringify(review, null, 2)}\n`, "utf-8");
|
|
56
|
-
});
|
|
57
|
-
if (result.hitMaxTurns) {
|
|
58
|
-
progress.emit({
|
|
59
|
-
stage: "spec-review",
|
|
60
|
-
step: "max-turns-hit",
|
|
61
|
-
message: `Loop hit max-turns (${maxTurns}) without converging. Using latest spec anyway.`,
|
|
62
|
-
data: { turnsUsed: result.turnsUsed, finalVerdict: result.finalVerdict },
|
|
63
|
-
});
|
|
64
|
-
process.exitCode = ExitCode.MaxTurnsHit;
|
|
65
|
-
}
|
|
66
|
-
else {
|
|
67
|
-
progress.emit({
|
|
68
|
-
stage: "spec-review",
|
|
69
|
-
step: "done",
|
|
70
|
-
message: `Edit loop converged at turn ${result.turnsUsed} with verdict: ${result.finalVerdict}`,
|
|
71
|
-
data: { turnsUsed: result.turnsUsed, finalVerdict: result.finalVerdict },
|
|
72
|
-
});
|
|
73
|
-
}
|
|
74
|
-
// Copy the final post-edit spec to a stable path so downstream stages
|
|
75
|
-
// (present) and external tooling have a predictable location.
|
|
76
|
-
copyFileSync(result.finalSpecPath, paths.specFinal);
|
|
77
|
-
progress.emit({
|
|
78
|
-
stage: "spec-review",
|
|
79
|
-
step: "final-spec",
|
|
80
|
-
message: `Final spec → ${paths.specFinal}`,
|
|
81
|
-
});
|
|
82
|
-
}
|
|
83
|
-
//# sourceMappingURL=edit-loop.js.map
|
|
@@ -1,19 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* `dotrequirements codebase-to-spec fan-out` subcommand.
|
|
3
|
-
*
|
|
4
|
-
* Runs the specifier for every area in the cached outline, in parallel up to
|
|
5
|
-
* a bounded concurrency limit, with retry-once on failure.
|
|
6
|
-
*
|
|
7
|
-
* Requirements covered:
|
|
8
|
-
* - CTS-CLI-2: granular `fan-out` subcommand
|
|
9
|
-
* - CTS-SPEC-1.2: bounded concurrent execution
|
|
10
|
-
* - CTS-SPEC-5: failure detection + retry + non-blocking continuation
|
|
11
|
-
*/
|
|
12
|
-
export interface FanOutCmdOptions {
|
|
13
|
-
concurrency?: number;
|
|
14
|
-
model?: string;
|
|
15
|
-
cliBinary?: string;
|
|
16
|
-
projectRoot?: string;
|
|
17
|
-
}
|
|
18
|
-
export declare function fanOutCommand(options?: FanOutCmdOptions): Promise<void>;
|
|
19
|
-
//# sourceMappingURL=fan-out.d.ts.map
|
|
@@ -1,77 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* `dotrequirements codebase-to-spec fan-out` subcommand.
|
|
3
|
-
*
|
|
4
|
-
* Runs the specifier for every area in the cached outline, in parallel up to
|
|
5
|
-
* a bounded concurrency limit, with retry-once on failure.
|
|
6
|
-
*
|
|
7
|
-
* Requirements covered:
|
|
8
|
-
* - CTS-CLI-2: granular `fan-out` subcommand
|
|
9
|
-
* - CTS-SPEC-1.2: bounded concurrent execution
|
|
10
|
-
* - CTS-SPEC-5: failure detection + retry + non-blocking continuation
|
|
11
|
-
*/
|
|
12
|
-
import { existsSync } from "node:fs";
|
|
13
|
-
import { cachePaths } from "../../codebase-to-spec/cache.js";
|
|
14
|
-
import { ExitCode } from "../../codebase-to-spec/exit-codes.js";
|
|
15
|
-
import { DEFAULT_FAN_OUT_CONCURRENCY, runFanOut, } from "../../codebase-to-spec/fan-out.js";
|
|
16
|
-
import { StdoutProgress } from "../../codebase-to-spec/progress.js";
|
|
17
|
-
import { findProjectRoot } from "../../utils/project-settings.js";
|
|
18
|
-
import { readFinalOutline } from "./plan-loop.js";
|
|
19
|
-
export async function fanOutCommand(options = {}) {
|
|
20
|
-
const progress = new StdoutProgress();
|
|
21
|
-
const projectRoot = options.projectRoot ?? findProjectRoot(process.cwd()) ?? process.cwd();
|
|
22
|
-
const paths = cachePaths(projectRoot);
|
|
23
|
-
const cliBinary = options.cliBinary ?? "dotrequirements";
|
|
24
|
-
if (!existsSync(paths.outlineFinal)) {
|
|
25
|
-
process.stderr.write(`Missing outline at ${paths.outlineFinal}. Run \`dotrequirements cts plan-loop\` first.\n`);
|
|
26
|
-
process.exitCode = ExitCode.MissingInput;
|
|
27
|
-
return;
|
|
28
|
-
}
|
|
29
|
-
if (!existsSync(paths.source)) {
|
|
30
|
-
process.stderr.write(`Missing uncompressed pack at ${paths.source}. Run \`dotrequirements cts pack\` first.\n`);
|
|
31
|
-
process.exitCode = ExitCode.MissingInput;
|
|
32
|
-
return;
|
|
33
|
-
}
|
|
34
|
-
const outline = readFinalOutline(projectRoot);
|
|
35
|
-
const concurrency = options.concurrency ?? DEFAULT_FAN_OUT_CONCURRENCY;
|
|
36
|
-
progress.emit({
|
|
37
|
-
stage: "specify",
|
|
38
|
-
step: "start",
|
|
39
|
-
message: `Fan-out: ${outline.areas.length} areas (concurrency=${concurrency})`,
|
|
40
|
-
});
|
|
41
|
-
const result = await runFanOut({
|
|
42
|
-
outline,
|
|
43
|
-
fullPackPath: paths.source,
|
|
44
|
-
partialPathFor: (sanitized) => paths.partial(sanitized),
|
|
45
|
-
slicePathFor: (sanitized) => `${paths.partialsDir}/slice-${sanitized}.txt`,
|
|
46
|
-
validateCommand: `${cliBinary} cts validate`,
|
|
47
|
-
styleCheckCommand: `${cliBinary} cts style-check`,
|
|
48
|
-
addDirs: [paths.root],
|
|
49
|
-
concurrency,
|
|
50
|
-
model: options.model,
|
|
51
|
-
progress,
|
|
52
|
-
});
|
|
53
|
-
// Summary
|
|
54
|
-
const failed = result.outcomes.filter((o) => o.status === "failed");
|
|
55
|
-
const completed = result.outcomes.filter((o) => o.status === "completed");
|
|
56
|
-
const skipped = result.outcomes.filter((o) => o.status === "skipped-resume");
|
|
57
|
-
progress.emit({
|
|
58
|
-
stage: "specify",
|
|
59
|
-
step: "summary",
|
|
60
|
-
message: `Completed: ${completed.length} / Skipped (resume): ${skipped.length} / Failed: ${failed.length}`,
|
|
61
|
-
data: {
|
|
62
|
-
completed: completed.length,
|
|
63
|
-
skipped: skipped.length,
|
|
64
|
-
failed: failed.length,
|
|
65
|
-
},
|
|
66
|
-
});
|
|
67
|
-
if (failed.length > 0) {
|
|
68
|
-
for (const o of failed) {
|
|
69
|
-
process.stderr.write(` failed: ${o.area.name} (${o.area.prefix}) — ${o.failureCause ?? "unknown"}\n`);
|
|
70
|
-
}
|
|
71
|
-
// Per CTS-SPEC-5, a failed specifier does not block the rest of the
|
|
72
|
-
// pipeline; we still let the caller decide. Surface non-zero so wrappers
|
|
73
|
-
// can react if they care.
|
|
74
|
-
process.exitCode = ExitCode.StageFailed;
|
|
75
|
-
}
|
|
76
|
-
}
|
|
77
|
-
//# sourceMappingURL=fan-out.js.map
|
|
@@ -1,26 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* `dotrequirements codebase-to-spec plan-loop` subcommand.
|
|
3
|
-
*
|
|
4
|
-
* Reads the compressed pack from the cache and runs the outline review loop
|
|
5
|
-
* (planner → reviewer → revise → ... → approved). Writes per-turn artifacts
|
|
6
|
-
* and the final outline.
|
|
7
|
-
*
|
|
8
|
-
* Requirements covered:
|
|
9
|
-
* - CTS-CLI-2: `dotrequirements cts plan-loop` runs only the outline review loop and exits
|
|
10
|
-
* - CTS-PLAN-1..6: end-to-end loop behavior
|
|
11
|
-
* - CTS-RESUME-1.1: skip loop if outline-final.json exists
|
|
12
|
-
* - CTS-OBSERVE-1, CTS-OBSERVE-2: progress + failure observability
|
|
13
|
-
*/
|
|
14
|
-
import type { Outline } from "../../codebase-to-spec/schemas.js";
|
|
15
|
-
export interface PlanLoopOptions {
|
|
16
|
-
maxTurns?: number;
|
|
17
|
-
model?: string;
|
|
18
|
-
progress?: import("../../codebase-to-spec/progress.js").ProgressEmitter;
|
|
19
|
-
projectRoot?: string;
|
|
20
|
-
}
|
|
21
|
-
export declare function planLoopCommand(rawOptions?: PlanLoopOptions): Promise<void>;
|
|
22
|
-
/**
|
|
23
|
-
* Helper used by `cts run` and tests to consume the outline that plan-loop wrote.
|
|
24
|
-
*/
|
|
25
|
-
export declare function readFinalOutline(projectRoot: string): Outline;
|
|
26
|
-
//# sourceMappingURL=plan-loop.d.ts.map
|
|
@@ -1,105 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* `dotrequirements codebase-to-spec plan-loop` subcommand.
|
|
3
|
-
*
|
|
4
|
-
* Reads the compressed pack from the cache and runs the outline review loop
|
|
5
|
-
* (planner → reviewer → revise → ... → approved). Writes per-turn artifacts
|
|
6
|
-
* and the final outline.
|
|
7
|
-
*
|
|
8
|
-
* Requirements covered:
|
|
9
|
-
* - CTS-CLI-2: `dotrequirements cts plan-loop` runs only the outline review loop and exits
|
|
10
|
-
* - CTS-PLAN-1..6: end-to-end loop behavior
|
|
11
|
-
* - CTS-RESUME-1.1: skip loop if outline-final.json exists
|
|
12
|
-
* - CTS-OBSERVE-1, CTS-OBSERVE-2: progress + failure observability
|
|
13
|
-
*/
|
|
14
|
-
import { existsSync, readFileSync, writeFileSync } from "node:fs";
|
|
15
|
-
import { cachePaths } from "../../codebase-to-spec/cache.js";
|
|
16
|
-
import { ExitCode } from "../../codebase-to-spec/exit-codes.js";
|
|
17
|
-
import { DEFAULT_OUTLINE_LOOP_MAX_TURNS, runOutlineReviewLoop, } from "../../codebase-to-spec/outline-review-loop.js";
|
|
18
|
-
import { StdoutProgress } from "../../codebase-to-spec/progress.js";
|
|
19
|
-
import { findProjectRoot } from "../../utils/project-settings.js";
|
|
20
|
-
export async function planLoopCommand(rawOptions = {}) {
|
|
21
|
-
const progress = rawOptions.progress ?? new StdoutProgress();
|
|
22
|
-
const projectRoot = rawOptions.projectRoot ?? findProjectRoot(process.cwd()) ?? process.cwd();
|
|
23
|
-
const paths = cachePaths(projectRoot);
|
|
24
|
-
const maxTurns = rawOptions.maxTurns ?? DEFAULT_OUTLINE_LOOP_MAX_TURNS;
|
|
25
|
-
// Resume — if outline-final.json already exists, skip the loop entirely.
|
|
26
|
-
if (existsSync(paths.outlineFinal)) {
|
|
27
|
-
progress.emit({
|
|
28
|
-
stage: "plan",
|
|
29
|
-
step: "resume-skip",
|
|
30
|
-
message: `outline-final.json exists at ${paths.outlineFinal}; skipping plan loop`,
|
|
31
|
-
});
|
|
32
|
-
return;
|
|
33
|
-
}
|
|
34
|
-
// Require the compressed pack from the prior stage.
|
|
35
|
-
if (!existsSync(paths.overview)) {
|
|
36
|
-
process.stderr.write(`Missing compressed pack at ${paths.overview}. Run \`dotrequirements cts pack\` first.\n`);
|
|
37
|
-
process.exitCode = ExitCode.MissingInput;
|
|
38
|
-
return;
|
|
39
|
-
}
|
|
40
|
-
progress.emit({
|
|
41
|
-
stage: "plan",
|
|
42
|
-
step: "start",
|
|
43
|
-
message: `Starting plan + outline review loop (max-turns=${maxTurns})`,
|
|
44
|
-
});
|
|
45
|
-
let result;
|
|
46
|
-
try {
|
|
47
|
-
result = await runOutlineReviewLoop({
|
|
48
|
-
overviewPath: paths.overview,
|
|
49
|
-
addDirs: [paths.root],
|
|
50
|
-
maxTurns,
|
|
51
|
-
model: rawOptions.model,
|
|
52
|
-
progress,
|
|
53
|
-
});
|
|
54
|
-
}
|
|
55
|
-
catch (err) {
|
|
56
|
-
process.stderr.write(`\nPlan loop failed: ${err instanceof Error ? err.message : String(err)}\n`);
|
|
57
|
-
process.exitCode = ExitCode.StageFailed;
|
|
58
|
-
return;
|
|
59
|
-
}
|
|
60
|
-
// Persist per-turn artifacts (one outline per turn, one review per turn) so
|
|
61
|
-
// we have full evidence and resumability.
|
|
62
|
-
result.outlinesByTurn.forEach((outline, idx) => {
|
|
63
|
-
const path = paths.outlineTurn(idx + 1);
|
|
64
|
-
writeFileSync(path, `${JSON.stringify(outline, null, 2)}\n`, "utf-8");
|
|
65
|
-
});
|
|
66
|
-
result.reviewsByTurn.forEach((review, idx) => {
|
|
67
|
-
const path = paths.outlineReviewTurn(idx + 1);
|
|
68
|
-
writeFileSync(path, `${JSON.stringify(review, null, 2)}\n`, "utf-8");
|
|
69
|
-
});
|
|
70
|
-
// Write the final outline.
|
|
71
|
-
writeFileSync(paths.outlineFinal, `${JSON.stringify(result.outline, null, 2)}\n`, "utf-8");
|
|
72
|
-
if (result.hitMaxTurns) {
|
|
73
|
-
progress.emit({
|
|
74
|
-
stage: "plan",
|
|
75
|
-
step: "max-turns-hit",
|
|
76
|
-
message: `Loop hit max-turns (${maxTurns}) without converging. Using latest outline anyway.`,
|
|
77
|
-
data: { turnsUsed: result.turnsUsed, finalVerdict: result.finalVerdict },
|
|
78
|
-
});
|
|
79
|
-
process.exitCode = ExitCode.MaxTurnsHit;
|
|
80
|
-
}
|
|
81
|
-
else {
|
|
82
|
-
progress.emit({
|
|
83
|
-
stage: "plan",
|
|
84
|
-
step: "done",
|
|
85
|
-
message: `Plan loop converged at turn ${result.turnsUsed} with verdict: ${result.finalVerdict}`,
|
|
86
|
-
data: { turnsUsed: result.turnsUsed, finalVerdict: result.finalVerdict },
|
|
87
|
-
});
|
|
88
|
-
}
|
|
89
|
-
progress.emit({
|
|
90
|
-
stage: "plan",
|
|
91
|
-
step: "outline-written",
|
|
92
|
-
message: `Final outline → ${paths.outlineFinal} (${result.outline.areas.length} areas)`,
|
|
93
|
-
});
|
|
94
|
-
}
|
|
95
|
-
/**
|
|
96
|
-
* Helper used by `cts run` and tests to consume the outline that plan-loop wrote.
|
|
97
|
-
*/
|
|
98
|
-
export function readFinalOutline(projectRoot) {
|
|
99
|
-
const paths = cachePaths(projectRoot);
|
|
100
|
-
if (!existsSync(paths.outlineFinal)) {
|
|
101
|
-
throw new Error(`Missing ${paths.outlineFinal}. Run \`cts plan-loop\` first.`);
|
|
102
|
-
}
|
|
103
|
-
return JSON.parse(readFileSync(paths.outlineFinal, "utf-8"));
|
|
104
|
-
}
|
|
105
|
-
//# sourceMappingURL=plan-loop.js.map
|
|
@@ -1,26 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* `dotrequirements codebase-to-spec present` subcommand.
|
|
3
|
-
*
|
|
4
|
-
* Writes the final spec to `.requirements/` and emits a pipeline summary.
|
|
5
|
-
*
|
|
6
|
-
* Requirements covered:
|
|
7
|
-
* - CTS-CLI-2: granular `present` subcommand
|
|
8
|
-
* - CTS-CLI-4: TTY-driven interactive/non-interactive selection
|
|
9
|
-
* - CTS-PRESENT-1..4
|
|
10
|
-
*/
|
|
11
|
-
export interface PresentCmdOptions {
|
|
12
|
-
/** Force --interactive or --non-interactive (overrides TTY detection). */
|
|
13
|
-
forceMode?: "interactive" | "non-interactive";
|
|
14
|
-
/** Replace existing .requirements/ files without prompting (non-interactive). */
|
|
15
|
-
overwrite?: boolean;
|
|
16
|
-
/** Skip writing files that would conflict (non-interactive). */
|
|
17
|
-
skipExisting?: boolean;
|
|
18
|
-
/**
|
|
19
|
-
* When true, write output under `.requirements/cts/` instead of
|
|
20
|
-
* `.requirements/`. See CTS-PRESENT-5.
|
|
21
|
-
*/
|
|
22
|
-
ignoreRequirements?: boolean;
|
|
23
|
-
projectRoot?: string;
|
|
24
|
-
}
|
|
25
|
-
export declare function presentCommand(rawOptions?: PresentCmdOptions): Promise<void>;
|
|
26
|
-
//# sourceMappingURL=present.d.ts.map
|