ridgeline 0.5.9 → 0.7.2

package/dist/stores/feedback.parse.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseVerdict = void 0;
+// Normalize an issue entry — accept both string and object forms
+const normalizeIssue = (item, severity) => {
+    if (typeof item === "string") {
+        return { description: item, severity };
+    }
+    if (typeof item === "object" && item !== null) {
+        const obj = item;
+        return {
+            criterion: typeof obj.criterion === "number" ? obj.criterion : undefined,
+            description: typeof obj.description === "string" ? obj.description : String(obj.description ?? ""),
+            file: typeof obj.file === "string" ? obj.file : undefined,
+            severity,
+            requiredState: typeof obj.requiredState === "string" ? obj.requiredState : undefined,
+        };
+    }
+    return { description: String(item), severity };
+};
+// Try to parse a raw object as a ReviewVerdict
+const tryParseVerdict = (raw) => {
+    if (typeof raw !== "object" || raw === null)
+        return null;
+    const obj = raw;
+    if (typeof obj.passed !== "boolean")
+        return null;
+    return {
+        passed: obj.passed,
+        summary: typeof obj.summary === "string" ? obj.summary : "",
+        criteriaResults: Array.isArray(obj.criteriaResults)
+            ? obj.criteriaResults.map((cr) => ({
+                criterion: typeof cr.criterion === "number" ? cr.criterion : 0,
+                passed: typeof cr.passed === "boolean" ? cr.passed : false,
+                notes: typeof cr.notes === "string" ? cr.notes : "",
+            }))
+            : [],
+        issues: Array.isArray(obj.issues)
+            ? obj.issues.map((i) => normalizeIssue(i, "blocking"))
+            : [],
+        suggestions: Array.isArray(obj.suggestions)
+            ? obj.suggestions.map((s) => normalizeIssue(s, "suggestion"))
+            : [],
+    };
+};
+// Find the end index of a balanced JSON object starting at position 0 in `text`.
+// Returns the index of the closing brace, or -1 if no balanced pair is found.
+const findBalancedBrace = (text) => {
+    let depth = 0;
+    let inString = false;
+    let escape = false;
+    for (let j = 0; j < text.length; j++) {
+        const ch = text[j];
+        if (escape) {
+            escape = false;
+            continue;
+        }
+        if (ch === "\\") {
+            escape = true;
+            continue;
+        }
+        if (ch === '"') {
+            inString = !inString;
+            continue;
+        }
+        if (inString)
+            continue;
+        if (ch === "{")
+            depth++;
+        if (ch === "}") {
+            depth--;
+            if (depth === 0)
+                return j;
+        }
+    }
+    return -1;
+};
+// Try to parse a JSON object starting at `text` as a ReviewVerdict.
+// First tries the full slice, then tries balanced brace extraction.
+const tryExtractVerdictAt = (text) => {
+    try {
+        return tryParseVerdict(JSON.parse(text));
+    }
+    catch {
+        const end = findBalancedBrace(text);
+        if (end === -1)
+            return null;
+        try {
+            return tryParseVerdict(JSON.parse(text.slice(0, end + 1)));
+        }
+        catch {
+            return null;
+        }
+    }
+};
+const UNPARSEABLE_VERDICT = {
+    passed: false,
+    summary: "Could not parse reviewer verdict from output",
+    criteriaResults: [],
+    issues: [{ description: "Reviewer output did not contain a valid JSON verdict", severity: "blocking" }],
+    suggestions: [],
+};
+// Extract the JSON verdict block from reviewer's text output
+const parseVerdict = (text) => {
+    // Try extracting from fenced code block first
+    const fencedMatch = text.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
+    if (fencedMatch) {
+        const result = tryExtractVerdictAt(fencedMatch[1]);
+        if (result)
+            return result;
+    }
+    // Scan every { and try to parse a verdict from that position
+    for (let i = text.indexOf("{"); i !== -1; i = text.indexOf("{", i + 1)) {
+        const result = tryExtractVerdictAt(text.slice(i));
+        if (result)
+            return result;
+    }
+    return UNPARSEABLE_VERDICT;
+};
+exports.parseVerdict = parseVerdict;
+//# sourceMappingURL=feedback.parse.js.map

package/dist/stores/feedback.parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.parse.js","sourceRoot":"","sources":["../../src/stores/feedback.parse.ts"],"names":[],"mappings":"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"}

package/dist/stores/feedback.verdict.d.ts

@@ -1,4 +1,2 @@
-import { ReviewIssue, ReviewVerdict } from "../types";
-export declare const parseVerdict: (text: string) => ReviewVerdict;
-export declare const formatIssue: (issue: ReviewIssue) => string;
-export declare const generateFeedback: (phaseId: string, verdict: ReviewVerdict) => string;
+export { parseVerdict } from "./feedback.parse";
+export { formatIssue, generateFeedback } from "./feedback.format";

package/dist/stores/feedback.verdict.js

@@ -1,179 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateFeedback = exports.formatIssue = exports.parseVerdict = void 0;
-// Normalize an issue entry — accept both string and object forms
-const normalizeIssue = (item, severity) => {
-    if (typeof item === "string") {
-        return { description: item, severity };
-    }
-    if (typeof item === "object" && item !== null) {
-        const obj = item;
-        return {
-            criterion: typeof obj.criterion === "number" ? obj.criterion : undefined,
-            description: typeof obj.description === "string" ? obj.description : String(obj.description ?? ""),
-            file: typeof obj.file === "string" ? obj.file : undefined,
-            severity,
-            requiredState: typeof obj.requiredState === "string" ? obj.requiredState : undefined,
-        };
-    }
-    return { description: String(item), severity };
-};
-// Try to parse a raw object as a ReviewVerdict
-const tryParseVerdict = (raw) => {
-    if (typeof raw !== "object" || raw === null)
-        return null;
-    const obj = raw;
-    if (typeof obj.passed !== "boolean")
-        return null;
-    return {
-        passed: obj.passed,
-        summary: typeof obj.summary === "string" ? obj.summary : "",
-        criteriaResults: Array.isArray(obj.criteriaResults)
-            ? obj.criteriaResults.map((cr) => ({
-                criterion: typeof cr.criterion === "number" ? cr.criterion : 0,
-                passed: typeof cr.passed === "boolean" ? cr.passed : false,
-                notes: typeof cr.notes === "string" ? cr.notes : "",
-            }))
-            : [],
-        issues: Array.isArray(obj.issues)
-            ? obj.issues.map((i) => normalizeIssue(i, "blocking"))
-            : [],
-        suggestions: Array.isArray(obj.suggestions)
-            ? obj.suggestions.map((s) => normalizeIssue(s, "suggestion"))
-            : [],
-    };
-};
-// Find the end index of a balanced JSON object starting at position 0 in `text`.
-// Returns the index of the closing brace, or -1 if no balanced pair is found.
-const findBalancedBrace = (text) => {
-    let depth = 0;
-    let inString = false;
-    let escape = false;
-    for (let j = 0; j < text.length; j++) {
-        const ch = text[j];
-        if (escape) {
-            escape = false;
-            continue;
-        }
-        if (ch === "\\") {
-            escape = true;
-            continue;
-        }
-        if (ch === '"') {
-            inString = !inString;
-            continue;
-        }
-        if (inString)
-            continue;
-        if (ch === "{")
-            depth++;
-        if (ch === "}") {
-            depth--;
-            if (depth === 0)
-                return j;
-        }
-    }
-    return -1;
-};
-// Try to parse a JSON object starting at `text` as a ReviewVerdict.
-// First tries the full slice, then tries balanced brace extraction.
-const tryExtractVerdictAt = (text) => {
-    try {
-        return tryParseVerdict(JSON.parse(text));
-    }
-    catch {
-        const end = findBalancedBrace(text);
-        if (end === -1)
-            return null;
-        try {
-            return tryParseVerdict(JSON.parse(text.slice(0, end + 1)));
-        }
-        catch {
-            return null;
-        }
-    }
-};
-const UNPARSEABLE_VERDICT = {
-    passed: false,
-    summary: "Could not parse reviewer verdict from output",
-    criteriaResults: [],
-    issues: [{ description: "Reviewer output did not contain a valid JSON verdict", severity: "blocking" }],
-    suggestions: [],
-};
-// Extract the JSON verdict block from reviewer's text output
-const parseVerdict = (text) => {
-    // Try extracting from fenced code block first
-    const fencedMatch = text.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
-    if (fencedMatch) {
-        const result = tryExtractVerdictAt(fencedMatch[1]);
-        if (result)
-            return result;
-    }
-    // Scan every { and try to parse a verdict from that position
-    for (let i = text.indexOf("{"); i !== -1; i = text.indexOf("{", i + 1)) {
-        const result = tryExtractVerdictAt(text.slice(i));
-        if (result)
-            return result;
-    }
-    return UNPARSEABLE_VERDICT;
-};
-exports.parseVerdict = parseVerdict;
-// Format a ReviewIssue for display
-const formatIssue = (issue) => {
-    const parts = [];
-    if (issue.file)
-        parts.push(issue.file);
-    parts.push(issue.description);
-    return parts.join(": ");
-};
-exports.formatIssue = formatIssue;
-// Generate feedback markdown from a structured verdict
-const generateFeedback = (phaseId, verdict) => {
-    const lines = [];
-    lines.push(`# Reviewer Feedback: Phase ${phaseId}`);
-    lines.push("");
-    // Failed criteria
-    const failed = verdict.criteriaResults.filter((cr) => !cr.passed);
-    if (failed.length > 0) {
-        lines.push("## Failed Criteria");
-        lines.push("");
-        for (const cr of failed) {
-            lines.push(`### Criterion ${cr.criterion}`);
-            lines.push(`**Status:** FAIL`);
-            lines.push(`**Evidence:** ${cr.notes}`);
-            // Find matching issue with requiredState
-            const matchingIssue = verdict.issues.find((i) => i.criterion === cr.criterion);
-            if (matchingIssue?.requiredState) {
-                lines.push(`**Required state:** ${matchingIssue.requiredState}`);
-            }
-            lines.push("");
-        }
-    }
-    // Blocking issues
-    const blocking = verdict.issues.filter((i) => i.severity === "blocking");
-    if (blocking.length > 0) {
-        lines.push("## Issues");
-        lines.push("");
-        for (const issue of blocking) {
-            const filePart = issue.file ? ` (${issue.file})` : "";
-            lines.push(`- ${issue.description}${filePart}`);
-            if (issue.requiredState) {
-                lines.push(`  - **Required:** ${issue.requiredState}`);
-            }
-        }
-        lines.push("");
-    }
-    // What passed
-    const passed = verdict.criteriaResults.filter((cr) => cr.passed);
-    if (passed.length > 0) {
-        lines.push("## What Passed");
-        lines.push("");
-        for (const cr of passed) {
-            lines.push(`- Criterion ${cr.criterion}: ${cr.notes}`);
-        }
-        lines.push("");
-    }
-    return lines.join("\n");
-};
-exports.generateFeedback = generateFeedback;
+// Re-exports for backward compatibility — implementations split into
+// feedback.parse.ts (verdict parsing) and feedback.format.ts (formatting).
+var feedback_parse_1 = require("./feedback.parse");
+Object.defineProperty(exports, "parseVerdict", { enumerable: true, get: function () { return feedback_parse_1.parseVerdict; } });
+var feedback_format_1 = require("./feedback.format");
+Object.defineProperty(exports, "formatIssue", { enumerable: true, get: function () { return feedback_format_1.formatIssue; } });
+Object.defineProperty(exports, "generateFeedback", { enumerable: true, get: function () { return feedback_format_1.generateFeedback; } });
 //# sourceMappingURL=feedback.verdict.js.map

package/dist/stores/feedback.verdict.js.map

@@ -1 +1 @@
-{"version":3,"file":"feedback.verdict.js","sourceRoot":"","sources":["../../src/stores/feedback.verdict.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"feedback.verdict.js","sourceRoot":"","sources":["../../src/stores/feedback.verdict.ts"],"names":[],"mappings":";;;AAAA,qEAAqE;AACrE,2EAA2E;AAC3E,mDAA+C;AAAtC,8GAAA,YAAY,OAAA;AACrB,qDAAiE;AAAxD,8GAAA,WAAW,OAAA;AAAE,mHAAA,gBAAgB,OAAA"}

package/dist/stores/index.d.ts

@@ -6,4 +6,4 @@ export { resolveFile, parseCheckCommand } from './inputs';
 export { PHASE_FILENAME_PATTERN, isPhaseFile, parsePhaseFilename, parsePhaseContent, scanPhases, } from './phases';
 export { loadState, saveState, initState, updatePhaseStatus, resetRetries, getNextIncompletePhase, } from './state';
 export { checkpointTagName, completionTagName, createCheckpoint, createCompletionTag, verifyCompletionTag, cleanupBuildTags, } from './tags';
-export { logTrajectory, makeTrajectoryEntry, readTrajectory } from './trajectory';
+export { logTrajectory, readTrajectory } from './trajectory';

package/dist/stores/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.readTrajectory = exports.makeTrajectoryEntry = exports.logTrajectory = exports.cleanupBuildTags = exports.verifyCompletionTag = exports.createCompletionTag = exports.createCheckpoint = exports.completionTagName = exports.checkpointTagName = exports.getNextIncompletePhase = exports.resetRetries = exports.updatePhaseStatus = exports.initState = exports.saveState = exports.loadState = exports.scanPhases = exports.parsePhaseContent = exports.parsePhaseFilename = exports.isPhaseFile = exports.PHASE_FILENAME_PATTERN = exports.parseCheckCommand = exports.resolveFile = exports.ensureHandoffExists = exports.readHandoff = exports.archiveFeedback = exports.writeFeedback = exports.readFeedback = exports.archiveFeedbackPath = exports.feedbackPath = exports.generateFeedback = exports.formatIssue = exports.parseVerdict = exports.getTotalCost = exports.recordCost = exports.saveBudget = exports.loadBudget = void 0;
+exports.readTrajectory = exports.logTrajectory = exports.cleanupBuildTags = exports.verifyCompletionTag = exports.createCompletionTag = exports.createCheckpoint = exports.completionTagName = exports.checkpointTagName = exports.getNextIncompletePhase = exports.resetRetries = exports.updatePhaseStatus = exports.initState = exports.saveState = exports.loadState = exports.scanPhases = exports.parsePhaseContent = exports.parsePhaseFilename = exports.isPhaseFile = exports.PHASE_FILENAME_PATTERN = exports.parseCheckCommand = exports.resolveFile = exports.ensureHandoffExists = exports.readHandoff = exports.archiveFeedback = exports.writeFeedback = exports.readFeedback = exports.archiveFeedbackPath = exports.feedbackPath = exports.generateFeedback = exports.formatIssue = exports.parseVerdict = exports.getTotalCost = exports.recordCost = exports.saveBudget = exports.loadBudget = void 0;
 var budget_1 = require("./budget");
 Object.defineProperty(exports, "loadBudget", { enumerable: true, get: function () { return budget_1.loadBudget; } });
 Object.defineProperty(exports, "saveBudget", { enumerable: true, get: function () { return budget_1.saveBudget; } });
@@ -44,6 +44,5 @@ Object.defineProperty(exports, "verifyCompletionTag", { enumerable: true, get: f
 Object.defineProperty(exports, "cleanupBuildTags", { enumerable: true, get: function () { return tags_1.cleanupBuildTags; } });
 var trajectory_1 = require("./trajectory");
 Object.defineProperty(exports, "logTrajectory", { enumerable: true, get: function () { return trajectory_1.logTrajectory; } });
-Object.defineProperty(exports, "makeTrajectoryEntry", { enumerable: true, get: function () { return trajectory_1.makeTrajectoryEntry; } });
 Object.defineProperty(exports, "readTrajectory", { enumerable: true, get: function () { return trajectory_1.readTrajectory; } });
 //# sourceMappingURL=index.js.map

package/dist/stores/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/stores/index.ts"],"names":[],"mappings":";;;AAAA,mCAA2E;AAAlE,oGAAA,UAAU,OAAA;AAAE,oGAAA,UAAU,OAAA;AAAE,oGAAA,UAAU,OAAA;AAAE,sGAAA,YAAY,OAAA;AACzD,uDAI2B;AAHzB,gHAAA,YAAY,OAAA;AACZ,+GAAA,WAAW,OAAA;AACX,oHAAA,gBAAgB,OAAA;AAElB,6CAMsB;AALpB,2GAAA,YAAY,OAAA;AACZ,kHAAA,mBAAmB,OAAA;AACnB,2GAAA,YAAY,OAAA;AACZ,4GAAA,aAAa,OAAA;AACb,8GAAA,eAAe,OAAA;AAEjB,qCAA4D;AAAnD,sGAAA,WAAW,OAAA;AAAE,8GAAA,mBAAmB,OAAA;AACzC,mCAAyD;AAAhD,qGAAA,WAAW,OAAA;AAAE,2GAAA,iBAAiB,OAAA;AACvC,mCAMiB;AALf,gHAAA,sBAAsB,OAAA;AACtB,qGAAA,WAAW,OAAA;AACX,4GAAA,kBAAkB,OAAA;AAClB,2GAAA,iBAAiB,OAAA;AACjB,oGAAA,UAAU,OAAA;AAEZ,iCAOgB;AANd,kGAAA,SAAS,OAAA;AACT,kGAAA,SAAS,OAAA;AACT,kGAAA,SAAS,OAAA;AACT,0GAAA,iBAAiB,OAAA;AACjB,qGAAA,YAAY,OAAA;AACZ,+GAAA,sBAAsB,OAAA;AAExB,+BAOe;AANb,yGAAA,iBAAiB,OAAA;AACjB,yGAAA,iBAAiB,OAAA;AACjB,wGAAA,gBAAgB,OAAA;AAChB,2GAAA,mBAAmB,OAAA;AACnB,2GAAA,mBAAmB,OAAA;AACnB,wGAAA,gBAAgB,OAAA;AAElB,2CAAiF;AAAxE,2GAAA,aAAa,OAAA;AAAE,iHAAA,mBAAmB,OAAA;AAAE,4GAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/stores/index.ts"],"names":[],"mappings":";;;AAAA,mCAA2E;AAAlE,oGAAA,UAAU,OAAA;AAAE,oGAAA,UAAU,OAAA;AAAE,oGAAA,UAAU,OAAA;AAAE,sGAAA,YAAY,OAAA;AACzD,uDAI2B;AAHzB,gHAAA,YAAY,OAAA;AACZ,+GAAA,WAAW,OAAA;AACX,oHAAA,gBAAgB,OAAA;AAElB,6CAMsB;AALpB,2GAAA,YAAY,OAAA;AACZ,kHAAA,mBAAmB,OAAA;AACnB,2GAAA,YAAY,OAAA;AACZ,4GAAA,aAAa,OAAA;AACb,8GAAA,eAAe,OAAA;AAEjB,qCAA4D;AAAnD,sGAAA,WAAW,OAAA;AAAE,8GAAA,mBAAmB,OAAA;AACzC,mCAAyD;AAAhD,qGAAA,WAAW,OAAA;AAAE,2GAAA,iBAAiB,OAAA;AACvC,mCAMiB;AALf,gHAAA,sBAAsB,OAAA;AACtB,qGAAA,WAAW,OAAA;AACX,4GAAA,kBAAkB,OAAA;AAClB,2GAAA,iBAAiB,OAAA;AACjB,oGAAA,UAAU,OAAA;AAEZ,iCAOgB;AANd,kGAAA,SAAS,OAAA;AACT,kGAAA,SAAS,OAAA;AACT,kGAAA,SAAS,OAAA;AACT,0GAAA,iBAAiB,OAAA;AACjB,qGAAA,YAAY,OAAA;AACZ,+GAAA,sBAAsB,OAAA;AAExB,+BAOe;AANb,yGAAA,iBAAiB,OAAA;AACjB,yGAAA,iBAAiB,OAAA;AACjB,wGAAA,gBAAgB,OAAA;AAChB,2GAAA,mBAAmB,OAAA;AACnB,2GAAA,mBAAmB,OAAA;AACnB,wGAAA,gBAAgB,OAAA;AAElB,2CAA4D;AAAnD,2GAAA,aAAa,OAAA;AAAE,4GAAA,cAAc,OAAA"}

package/dist/stores/settings.d.ts

@@ -9,4 +9,6 @@ type RidgelineSettings = {
 };
 export declare const loadSettings: (ridgelineDir: string) => RidgelineSettings;
 export declare const resolveNetworkAllowlist: (ridgelineDir: string) => string[];
+/** Build the network allowlist for research agents: base allowlist + research domains. */
+export declare const resolveResearchAllowlist: (ridgelineDir: string) => string[];
 export {};

package/dist/stores/settings.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveNetworkAllowlist = exports.loadSettings = exports.DEFAULT_NETWORK_ALLOWLIST = exports.CLAUDE_REQUIRED_DOMAINS = void 0;
+exports.resolveResearchAllowlist = exports.resolveNetworkAllowlist = exports.loadSettings = exports.DEFAULT_NETWORK_ALLOWLIST = exports.CLAUDE_REQUIRED_DOMAINS = void 0;
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 /** Domains Claude needs for authentication and API access — always allowlisted. */
@@ -42,6 +42,19 @@ exports.CLAUDE_REQUIRED_DOMAINS = [
     "downloads.claude.ai",
     "http-intake.logs.us5.datadoghq.com",
 ];
+/** Additional domains needed for research agents (web search, docs, academic). */
+const RESEARCH_NETWORK_DOMAINS = [
+    "arxiv.org",
+    "export.arxiv.org",
+    "api.semanticscholar.org",
+    "scholar.google.com",
+    "docs.python.org",
+    "developer.mozilla.org",
+    "docs.rs",
+    "pkg.go.dev",
+    "learn.microsoft.com",
+    "devdocs.io",
+];
 exports.DEFAULT_NETWORK_ALLOWLIST = [
     ...exports.CLAUDE_REQUIRED_DOMAINS,
     "registry.npmjs.org",
@@ -82,4 +95,14 @@ const resolveNetworkAllowlist = (ridgelineDir) => {
     return [...merged];
 };
 exports.resolveNetworkAllowlist = resolveNetworkAllowlist;
+/** Build the network allowlist for research agents: base allowlist + research domains. */
+const resolveResearchAllowlist = (ridgelineDir) => {
+    const base = (0, exports.resolveNetworkAllowlist)(ridgelineDir);
+    // If base is empty, user set "*" (unrestricted) — keep it unrestricted
+    if (base.length === 0)
+        return [];
+    const merged = new Set([...base, ...RESEARCH_NETWORK_DOMAINS]);
+    return [...merged];
+};
+exports.resolveResearchAllowlist = resolveResearchAllowlist;
 //# sourceMappingURL=settings.js.map

package/dist/stores/settings.js.map

@@ -1 +1 @@
-{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/stores/settings.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4CAA6B;AAC7B,gDAAiC;AAEjC,mFAAmF;AACtE,QAAA,uBAAuB,GAAa;IAC/C,mBAAmB;IACnB,qBAAqB;IACrB,oCAAoC;CACrC,CAAA;AAEY,QAAA,yBAAyB,GAAa;IACjD,GAAG,+BAAuB;IAC1B,oBAAoB;IACpB,YAAY;IACZ,+BAA+B;IAC/B,2BAA2B;IAC3B,UAAU;IACV,wBAAwB;IACxB,WAAW;IACX,kBAAkB;IAClB,cAAc;IACd,kBAAkB;IAClB,YAAY;IACZ,YAAY;IACZ,eAAe;CAChB,CAAA;AASM,MAAM,YAAY,GAAG,CAAC,YAAoB,EAAqB,EAAE;IACtE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,eAAe,CAAC,CAAA;IAC7D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;QAClD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAsB,CAAA;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC,CAAA;AARY,QAAA,YAAY,gBAQxB;AAEM,MAAM,uBAAuB,GAAG,CAAC,YAAoB,EAAY,EAAE;IACxE,MAAM,QAAQ,GAAG,IAAA,oBAAY,EAAC,YAAY,CAAC,CAAA;IAC3C,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,IAAI,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;QACjF,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS;QAC5B,CAAC,CAAC,CAAC,GAAG,iCAAyB,CAAC,CAAA;IAClC,iFAAiF;IACjF,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAA;IACjC,+EAA+E;IAC/E,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,+BAAuB,EAAE,GAAG,IAAI,CAAC,CAAC,CAAA;IAC7D,OAAO,CAAC,GAAG,MAAM,CAAC,CAAA;AACpB,CAAC,CAAA;AAVY,QAAA,uBAAuB,2BAUnC"}
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/stores/settings.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4CAA6B;AAC7B,gDAAiC;AAEjC,mFAAmF;AACtE,QAAA,uBAAuB,GAAa;IAC/C,mBAAmB;IACnB,qBAAqB;IACrB,oCAAoC;CACrC,CAAA;AAED,kFAAkF;AAClF,MAAM,wBAAwB,GAAa;IACzC,WAAW;IACX,kBAAkB;IAClB,yBAAyB;IACzB,oBAAoB;IACpB,iBAAiB;IACjB,uBAAuB;IACvB,SAAS;IACT,YAAY;IACZ,qBAAqB;IACrB,YAAY;CACb,CAAA;AAEY,QAAA,yBAAyB,GAAa;IACjD,GAAG,+BAAuB;IAC1B,oBAAoB;IACpB,YAAY;IACZ,+BAA+B;IAC/B,2BAA2B;IAC3B,UAAU;IACV,wBAAwB;IACxB,WAAW;IACX,kBAAkB;IAClB,cAAc;IACd,kBAAkB;IAClB,YAAY;IACZ,YAAY;IACZ,eAAe;CAChB,CAAA;AASM,MAAM,YAAY,GAAG,CAAC,YAAoB,EAAqB,EAAE;IACtE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,eAAe,CAAC,CAAA;IAC7D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;QAClD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAsB,CAAA;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC,CAAA;AARY,QAAA,YAAY,gBAQxB;AAEM,MAAM,uBAAuB,GAAG,CAAC,YAAoB,EAAY,EAAE;IACxE,MAAM,QAAQ,GAAG,IAAA,oBAAY,EAAC,YAAY,CAAC,CAAA;IAC3C,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,IAAI,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;QACjF,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS;QAC5B,CAAC,CAAC,CAAC,GAAG,iCAAyB,CAAC,CAAA;IAClC,iFAAiF;IACjF,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAA;IACjC,+EAA+E;IAC/E,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,+BAAuB,EAAE,GAAG,IAAI,CAAC,CAAC,CAAA;IAC7D,OAAO,CAAC,GAAG,MAAM,CAAC,CAAA;AACpB,CAAC,CAAA;AAVY,QAAA,uBAAuB,2BAUnC;AAED,0FAA0F;AACnF,MAAM,wBAAwB,GAAG,CAAC,YAAoB,EAAY,EAAE;IACzE,MAAM,IAAI,GAAG,IAAA,+BAAuB,EAAC,YAAY,CAAC,CAAA;IAClD,uEAAuE;IACvE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAChC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,wBAAwB,CAAC,CAAC,CAAA;IAC9D,OAAO,CAAC,GAAG,MAAM,CAAC,CAAA;AACpB,CAAC,CAAA;AANY,QAAA,wBAAwB,4BAMpC"}

package/dist/stores/state.d.ts

@@ -18,3 +18,7 @@ export declare const getNextPipelineStage: (buildDir: string) => PipelineStage |
  * return list of files/dirs to delete from disk.
  */
 export declare const rewindTo: (buildDir: string, buildName: string, targetStage: PipelineStage) => string[];
+/** Record matched shape names in build state. */
+export declare const recordMatchedShapes: (buildDir: string, buildName: string, shapes: string[]) => void;
+/** Read matched shapes from build state. Returns empty array if none recorded. */
+export declare const getMatchedShapes: (buildDir: string) => string[];

package/dist/stores/state.js

@@ -33,14 +33,18 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.rewindTo = exports.getNextPipelineStage = exports.markBuildRunning = exports.advancePipeline = exports.getPipelineStatus = exports.getNextIncompletePhase = exports.resetRetries = exports.updatePhaseStatus = exports.initState = exports.saveState = exports.loadState = void 0;
+exports.getMatchedShapes = exports.recordMatchedShapes = exports.rewindTo = exports.getNextPipelineStage = exports.markBuildRunning = exports.advancePipeline = exports.getPipelineStatus = exports.getNextIncompletePhase = exports.resetRetries = exports.updatePhaseStatus = exports.initState = exports.saveState = exports.loadState = void 0;
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 const tags_1 = require("./tags");
+const atomic_write_1 = require("../utils/atomic-write");
 const statePath = (buildDir) => path.join(buildDir, "state.json");
 const DEFAULT_PIPELINE = {
     shape: "pending",
+    design: "skipped",
     spec: "pending",
+    research: "skipped",
+    refine: "skipped",
     plan: "pending",
     build: "pending",
 };
@@ -58,7 +62,7 @@ const loadState = (buildDir) => {
 };
 exports.loadState = loadState;
 const saveState = (buildDir, state) => {
-    fs.writeFileSync(statePath(buildDir), JSON.stringify(state, null, 2) + "\n");
+    (0, atomic_write_1.atomicWriteSync)(statePath(buildDir), JSON.stringify(state, null, 2) + "\n");
 };
 exports.saveState = saveState;
 const initState = (buildName, phases) => ({
@@ -119,14 +123,19 @@ exports.getNextIncompletePhase = getNextIncompletePhase;
 /** Derive pipeline state from existing artifacts on disk (for legacy state files). */
 const derivePipelineFromArtifacts = (buildDir) => {
     const hasShape = fs.existsSync(path.join(buildDir, "shape.md"));
+    const hasDesign = fs.existsSync(path.join(buildDir, "design.md"));
     const hasSpec = fs.existsSync(path.join(buildDir, "spec.md"));
     const hasConstraints = fs.existsSync(path.join(buildDir, "constraints.md"));
+    const hasResearch = fs.existsSync(path.join(buildDir, "research.md"));
     const phasesDir = path.join(buildDir, "phases");
     const hasPhases = fs.existsSync(phasesDir) &&
         fs.readdirSync(phasesDir).some((f) => f.endsWith(".md") && /^\d+-.+\.md$/.test(f));
     return {
         shape: hasShape ? "complete" : "pending",
+        design: hasDesign ? "complete" : "skipped",
         spec: hasSpec && hasConstraints ? "complete" : "pending",
+        research: hasResearch ? "complete" : "skipped",
+        refine: hasResearch ? "complete" : "skipped",
         plan: hasPhases ? "complete" : "pending",
         build: "pending",
     };
@@ -139,7 +148,10 @@ const getPipelineStatus = (buildDir) => {
     // Belt and suspenders: if state says complete but file is missing, trust disk
     return {
         shape: fromState.shape === "complete" && fromDisk.shape === "complete" ? "complete" : fromDisk.shape,
+        design: fromState.design ?? "skipped",
         spec: fromState.spec === "complete" && fromDisk.spec === "complete" ? "complete" : fromDisk.spec,
+        research: fromState.research ?? "skipped",
+        refine: fromState.refine ?? "skipped",
         plan: fromState.plan === "complete" && fromDisk.plan === "complete" ? "complete" : fromDisk.plan,
         build: fromState.build === "pending" ? "pending" : fromState.build,
     };
@@ -180,11 +192,15 @@ const markBuildRunning = (buildDir, buildName) => {
     (0, exports.saveState)(buildDir, state);
 };
 exports.markBuildRunning = markBuildRunning;
-const PIPELINE_STAGES = ["shape", "spec", "plan", "build"];
+// The ordered list of stages for auto-advance.
+// Research and refine are excluded — they are opt-in only.
+const REQUIRED_PIPELINE_STAGES = ["shape", "spec", "plan", "build"];
+// All stages including optional ones, for rewind calculations.
+const ALL_PIPELINE_STAGES = ["shape", "design", "spec", "research", "refine", "plan", "build"];
 /** Determine the next incomplete pipeline stage. */
 const getNextPipelineStage = (buildDir) => {
     const status = (0, exports.getPipelineStatus)(buildDir);
-    for (const stage of PIPELINE_STAGES) {
+    for (const stage of REQUIRED_PIPELINE_STAGES) {
         const s = status[stage];
         if (s === "pending" || s === "running")
             return stage;
@@ -197,6 +213,23 @@ const collectStageFiles = (buildDir, stage) => {
     const files = [];
     const phasesDir = path.join(buildDir, "phases");
     switch (stage) {
+        case "research": {
+            const fp = path.join(buildDir, "research.md");
+            if (fs.existsSync(fp))
+                files.push(fp);
+            break;
+        }
+        case "design": {
+            const fp = path.join(buildDir, "design.md");
+            if (fs.existsSync(fp))
+                files.push(fp);
+            break;
+        }
+        case "refine":
+            // Refine modifies spec.md in-place — no separate artifact to delete.
+            // Rewinding to refine means "undo the refinement" which requires
+            // rewinding spec too (the user should rewind to spec instead).
+            break;
         case "spec":
             for (const f of ["spec.md", "constraints.md", "taste.md"]) {
                 const fp = path.join(buildDir, f);
@@ -226,26 +259,35 @@ const collectStageFiles = (buildDir, stage) => {
     return files;
 };
 /** Reset pipeline state for stages downstream of targetStage. */
-const resetPipelineState = (buildDir, buildName, targetStage, resetStages) => {
+const resetPipelineState = (buildDir, buildName, targetStage, _resetStages) => {
     const state = (0, exports.loadState)(buildDir);
     if (!state)
         return;
-    const targetIndex = PIPELINE_STAGES.indexOf(targetStage);
-    for (const stage of PIPELINE_STAGES) {
-        if (PIPELINE_STAGES.indexOf(stage) > targetIndex) {
-            state.pipeline[stage] = "pending";
+    const targetIndex = ALL_PIPELINE_STAGES.indexOf(targetStage);
+    for (const stage of ALL_PIPELINE_STAGES) {
+        if (ALL_PIPELINE_STAGES.indexOf(stage) > targetIndex) {
+            // Optional stages reset to "skipped", required stages to "pending"
+            if (stage === "research" || stage === "refine" || stage === "design") {
+                state.pipeline[stage] = "skipped";
+            }
+            else {
+                state.pipeline[stage] = "pending";
+            }
         }
     }
     if (targetStage === "build") {
         state.pipeline.build = "pending";
     }
+    else if (targetStage === "research" || targetStage === "refine" || targetStage === "design") {
+        state.pipeline[targetStage] = "complete";
+    }
     else {
         state.pipeline[targetStage] = "complete";
     }
-    if (resetStages.includes("plan") || resetStages.includes("build")) {
+    if (_resetStages.includes("plan") || _resetStages.includes("build")) {
         state.phases = [];
     }
-    if (resetStages.includes("build")) {
+    if (_resetStages.includes("build")) {
         (0, tags_1.cleanupBuildTags)(buildName);
     }
     (0, exports.saveState)(buildDir, state);
@@ -255,10 +297,31 @@ const resetPipelineState = (buildDir, buildName, targetStage, resetStages) => {
  * return list of files/dirs to delete from disk.
  */
 const rewindTo = (buildDir, buildName, targetStage) => {
-    const resetStages = PIPELINE_STAGES.slice(PIPELINE_STAGES.indexOf(targetStage) + 1);
+    const resetStages = ALL_PIPELINE_STAGES.slice(ALL_PIPELINE_STAGES.indexOf(targetStage) + 1);
     const toDelete = resetStages.flatMap((stage) => collectStageFiles(buildDir, stage));
     resetPipelineState(buildDir, buildName, targetStage, resetStages);
     return toDelete;
 };
 exports.rewindTo = rewindTo;
+/** Record matched shape names in build state. */
+const recordMatchedShapes = (buildDir, buildName, shapes) => {
+    let state = (0, exports.loadState)(buildDir);
+    if (!state) {
+        state = {
+            buildName,
+            startedAt: new Date().toISOString(),
+            pipeline: { ...DEFAULT_PIPELINE },
+            phases: [],
+        };
+    }
+    state.matchedShapes = shapes;
+    (0, exports.saveState)(buildDir, state);
+};
+exports.recordMatchedShapes = recordMatchedShapes;
+/** Read matched shapes from build state. Returns empty array if none recorded. */
+const getMatchedShapes = (buildDir) => {
+    const state = (0, exports.loadState)(buildDir);
+    return state?.matchedShapes ?? [];
+};
+exports.getMatchedShapes = getMatchedShapes;
 //# sourceMappingURL=state.js.map