stoa-mcp 0.1.0

package/dist/core/refine.js

@@ -0,0 +1,233 @@
+/**
+ * Refine Pipeline orchestrator.
+ * Runs a 5-stage refinement pipeline that transforms raw task descriptions
+ * into structured specifications.
+ */
+import Anthropic from "@anthropic-ai/sdk";
+import { spawn, execFileSync } from "child_process";
+import { writeFileSync, mkdirSync } from "fs";
+import { buildProblemStatementPrompt, buildAcceptanceCriteriaPrompt, buildConstraintPrompt, buildDecompositionPrompt, buildEvaluationDesignPrompt, buildMoodboardPrompt, } from "./prompts.js";
+import { stripPreamble, parseAcceptanceCriteria, parseConstraints, parseDecomposition, parseScenarios, } from "./parsers.js";
+import { computeSpecScore } from "./spec-score.js";
+const DEFAULT_TIMEOUT_MS = 300_000;
+// ── Private helpers ────────────────────────────────────────────────────
+function detectExecutionMode(options) {
+    if (options.executionMode) {
+        return options.executionMode;
+    }
+    if (options.apiKey || process.env.ANTHROPIC_API_KEY) {
+        return "api";
+    }
+    try {
+        execFileSync("which", ["claude"]);
+        return "claude-code";
+    }
+    catch {
+        return "clipboard";
+    }
+}
+async function executePrompt(prompt, mode, model, apiKey) {
+    if (mode === "clipboard") {
+        return `${prompt.systemPrompt}\n\n${prompt.userPrompt}`;
+    }
+    if (mode === "api") {
+        const client = new Anthropic({
+            apiKey: apiKey || process.env.ANTHROPIC_API_KEY,
+        });
+        const response = await client.messages.create({
+            model,
+            max_tokens: 4096,
+            system: prompt.systemPrompt,
+            messages: [{ role: "user", content: prompt.userPrompt }],
+        });
+        const textBlock = response.content.find((block) => block.type === "text");
+        return textBlock ? textBlock.text : "";
+    }
+    // claude-code mode — pipe prompt via stdin instead of -p flag
+    // (claude --print -p "..." hangs as a subprocess; stdin works reliably)
+    const combinedPrompt = `${prompt.systemPrompt}\n\n${prompt.userPrompt}`;
+    return new Promise((resolve, reject) => {
+        const child = spawn("claude", ["--print"], {
+            shell: false,
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let resolved = false;
+        let dataTimer = null;
+        const finish = () => {
+            if (resolved)
+                return;
+            resolved = true;
+            clearTimeout(overallTimer);
+            if (dataTimer)
+                clearTimeout(dataTimer);
+            process.removeListener("SIGINT", onParentSigint);
+            child.kill();
+            resolve(stdout.trim());
+        };
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk.toString();
+            // Reset idle timer on each chunk — after 2s of silence, assume done.
+            // Claude Code writes the full response before SessionEnd hooks run.
+            if (dataTimer)
+                clearTimeout(dataTimer);
+            dataTimer = setTimeout(finish, 2000);
+        });
+        child.on("close", () => {
+            finish();
+        });
+        const overallTimer = setTimeout(() => {
+            if (!resolved) {
+                resolved = true;
+                if (dataTimer)
+                    clearTimeout(dataTimer);
+                process.removeListener("SIGINT", onParentSigint);
+                child.kill("SIGKILL");
+                reject(new Error(`Claude Code subprocess timed out after ${DEFAULT_TIMEOUT_MS / 1000}s`));
+            }
+        }, DEFAULT_TIMEOUT_MS);
+        const onParentSigint = () => {
+            child.kill("SIGINT");
+        };
+        process.once("SIGINT", onParentSigint);
+        child.on("error", (err) => {
+            if (!resolved) {
+                resolved = true;
+                clearTimeout(overallTimer);
+                if (dataTimer)
+                    clearTimeout(dataTimer);
+                process.removeListener("SIGINT", onParentSigint);
+                reject(err);
+            }
+        });
+        // Write prompt to stdin and close it
+        child.stdin.write(combinedPrompt);
+        child.stdin.end();
+    });
+}
+const PROMPT_BUILDERS = {
+    1: buildProblemStatementPrompt,
+    2: buildAcceptanceCriteriaPrompt,
+    3: buildConstraintPrompt,
+    4: buildDecompositionPrompt,
+    5: buildEvaluationDesignPrompt,
+};
+const STAGE_PARSERS = {
+    1: stripPreamble,
+    2: parseAcceptanceCriteria,
+    3: parseConstraints,
+    4: parseDecomposition,
+    5: parseScenarios,
+};
+function buildPromptForStage(stage, input, completedStages) {
+    const builder = PROMPT_BUILDERS[stage];
+    if (!builder) {
+        throw new Error(`Unknown stage: ${stage}`);
+    }
+    const findOutput = (s) => {
+        const result = completedStages.find((r) => r.stage === s);
+        if (!result || result.output == null)
+            return "";
+        if (typeof result.output === "string")
+            return result.output;
+        return JSON.stringify(result.output);
+    };
+    const opts = input.promptOptions;
+    // Resolve designContext: prefer moodboard (structured) over raw designContext string
+    const designContextStage1 = input.moodboard
+        ? buildMoodboardPrompt(input.moodboard, 1)
+        : input.designContext;
+    const designContextStage3 = input.moodboard
+        ? buildMoodboardPrompt(input.moodboard, 3)
+        : input.designContext;
+    switch (stage) {
+        case 1:
+            return buildProblemStatementPrompt(input.title, input.description, input.projectContext, input.role, opts, designContextStage1, input.projectCtx);
+        case 2:
+            return buildAcceptanceCriteriaPrompt(input.title, findOutput(1) || input.description, opts);
+        case 3:
+            return buildConstraintPrompt(input.title, findOutput(1) || input.description, findOutput(2), opts, designContextStage3, input.projectCtx);
+        case 4:
+            return buildDecompositionPrompt(input.title, findOutput(1) || input.description, findOutput(2), findOutput(3), opts);
+        case 5:
+            return buildEvaluationDesignPrompt(input.title, findOutput(1) || input.description, findOutput(2), findOutput(3), opts);
+        default:
+            throw new Error(`Unknown stage: ${stage}`);
+    }
+}
+function buildSpecScoreInput(input, completedStages) {
+    const hasStage = (s) => completedStages.some((r) => r.stage === s);
+    const refinedDesc = completedStages.find((r) => r.stage === 1);
+    const descText = refinedDesc && typeof refinedDesc.output === "string"
+        ? refinedDesc.output
+        : input.description;
+    // A complete pipeline run (all 5 stages with output) produces a fully
+    // executable spec — guardrails and role are injected into prompts during
+    // refinement, so their presence in the input is not required for a 5/5.
+    const allFiveComplete = hasStage(1) && hasStage(2) && hasStage(3) && hasStage(4) && hasStage(5);
+    return {
+        hasDescription: descText.length > 0,
+        descriptionLength: descText.length,
+        wasRefined: hasStage(1),
+        hasAcceptanceCriteria: hasStage(2),
+        hasGuardrails: allFiveComplete || (input.guardrails ?? []).length > 0,
+        hasRole: allFiveComplete || (input.role ?? "").length > 0,
+        hasScenarios: hasStage(5),
+        hasSubtasks: hasStage(4),
+    };
+}
+// ── Main export ────────────────────────────────────────────────────────
+export async function refinePipeline(input, options = {}) {
+    const mode = detectExecutionMode(options);
+    const model = options.model ?? "claude-sonnet-4-6";
+    const stagesToRun = options.stages
+        ? [...options.stages].sort((a, b) => a - b)
+        : [1, 2, 3, 4, 5];
+    const completedStages = [];
+    for (const stage of stagesToRun) {
+        const prompt = buildPromptForStage(stage, input, completedStages);
+        let rawResponse;
+        try {
+            rawResponse = await executePrompt(prompt, mode, model, options.apiKey);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            throw new Error(`Stage ${stage} failed: ${message}`);
+        }
+        // DEBUG: Write raw AI response for diagnosis (temporary — remove after fix is verified)
+        try {
+            mkdirSync(".stoa", { recursive: true });
+            writeFileSync(`.stoa/debug-stage-${stage}.txt`, rawResponse, "utf-8");
+        }
+        catch {
+            // Non-critical — ignore debug write failures
+        }
+        let output = null;
+        if (mode !== "clipboard") {
+            const parser = STAGE_PARSERS[stage];
+            if (parser) {
+                output = parser(rawResponse);
+            }
+        }
+        const specScoreInput = mode === "clipboard"
+            ? { hasDescription: false, descriptionLength: 0, wasRefined: false, hasAcceptanceCriteria: false, hasGuardrails: false, hasRole: false, hasScenarios: false, hasSubtasks: false }
+            : buildSpecScoreInput(input, [...completedStages, { stage, output, specScore: 0, rawResponse }]);
+        const specScore = mode === "clipboard" ? 0 : computeSpecScore(specScoreInput).score;
+        const stageResult = {
+            stage,
+            output,
+            specScore,
+            rawResponse,
+        };
+        completedStages.push(stageResult);
+        options.onStageComplete?.(stage, stageResult);
+    }
+    const lastStage = completedStages[completedStages.length - 1];
+    return {
+        stages: completedStages,
+        finalSpecScore: lastStage?.specScore ?? 0,
+        finalOutput: lastStage?.output ?? null,
+        executionMode: mode,
+    };
+}
+//# sourceMappingURL=refine.js.map

package/dist/core/refine.js.map

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

package/dist/core/spec-score.d.ts

@@ -0,0 +1,17 @@
+export interface SpecScoreInput {
+    hasDescription: boolean;
+    descriptionLength: number;
+    wasRefined: boolean;
+    hasAcceptanceCriteria: boolean;
+    hasGuardrails: boolean;
+    hasRole: boolean;
+    hasScenarios: boolean;
+    hasSubtasks: boolean;
+}
+export interface SpecScoreResult {
+    score: number;
+    level: string;
+    missing: string[];
+}
+export declare function computeSpecScore(input: SpecScoreInput): SpecScoreResult;
+//# sourceMappingURL=spec-score.d.ts.map

package/dist/core/spec-score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-score.d.ts","sourceRoot":"","sources":["../../src/core/spec-score.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAID,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,eAAe,CAiDvE"}

package/dist/core/spec-score.js

@@ -0,0 +1,59 @@
+const DESCRIPTION_LENGTH_THRESHOLD = 100;
+export function computeSpecScore(input) {
+    const hasAdequateLength = input.descriptionLength >= DESCRIPTION_LENGTH_THRESHOLD;
+    // Determine current level
+    let score;
+    let level;
+    if (!input.hasDescription) {
+        score = 0;
+        level = "Empty";
+    }
+    else if (!hasAdequateLength || !input.wasRefined) {
+        score = 1;
+        level = "Basic";
+    }
+    else if (!input.hasAcceptanceCriteria || !input.hasGuardrails) {
+        score = 2;
+        level = "Described";
+    }
+    else if (!input.hasRole || !input.hasScenarios) {
+        score = 3;
+        level = "Constrained";
+    }
+    else if (!input.hasSubtasks) {
+        score = 4;
+        level = "Specified";
+    }
+    else {
+        return { score: 5, level: "Executable", missing: [] };
+    }
+    // Collect only the missing items needed to advance to the next level
+    const missing = [];
+    if (score === 0) {
+        missing.push("description");
+    }
+    if (score === 1) {
+        if (!hasAdequateLength)
+            missing.push("detailed description (100+ characters)");
+        if (!input.wasRefined)
+            missing.push("refinement pass");
+    }
+    if (score === 2) {
+        if (!input.hasAcceptanceCriteria)
+            missing.push("acceptance criteria");
+        if (!input.hasGuardrails)
+            missing.push("guardrails");
+    }
+    if (score === 3) {
+        if (!input.hasRole)
+            missing.push("role assignment");
+        if (!input.hasScenarios)
+            missing.push("scenarios");
+    }
+    if (score === 4) {
+        if (!input.hasSubtasks)
+            missing.push("subtasks");
+    }
+    return { score, level, missing };
+}
+//# sourceMappingURL=spec-score.js.map

package/dist/core/spec-score.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-score.js","sourceRoot":"","sources":["../../src/core/spec-score.ts"],"names":[],"mappings":"AAiBA,MAAM,4BAA4B,GAAG,GAAG,CAAC;AAEzC,MAAM,UAAU,gBAAgB,CAAC,KAAqB;IACpD,MAAM,iBAAiB,GAAG,KAAK,CAAC,iBAAiB,IAAI,4BAA4B,CAAC;IAElF,0BAA0B;IAC1B,IAAI,KAAa,CAAC;IAClB,IAAI,KAAa,CAAC;IAElB,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;QAC1B,KAAK,GAAG,CAAC,CAAC;QACV,KAAK,GAAG,OAAO,CAAC;IAClB,CAAC;SAAM,IAAI,CAAC,iBAAiB,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;QACnD,KAAK,GAAG,CAAC,CAAC;QACV,KAAK,GAAG,OAAO,CAAC;IAClB,CAAC;SAAM,IAAI,CAAC,KAAK,CAAC,qBAAqB,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;QAChE,KAAK,GAAG,CAAC,CAAC;QACV,KAAK,GAAG,WAAW,CAAC;IACtB,CAAC;SAAM,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;QACjD,KAAK,GAAG,CAAC,CAAC;QACV,KAAK,GAAG,aAAa,CAAC;IACxB,CAAC;SAAM,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QAC9B,KAAK,GAAG,CAAC,CAAC;QACV,KAAK,GAAG,WAAW,CAAC;IACtB,CAAC;SAAM,CAAC;QACN,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACxD,CAAC;IAED,qEAAqE;IACrE,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,IAAI,CAAC,iBAAiB;YAAE,OAAO,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;QAC/E,IAAI,CAAC,KAAK,CAAC,UAAU;YAAE,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,IAAI,CAAC,KAAK,CAAC,qBAAqB;YAAE,OAAO,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACtE,IAAI,CAAC,KAAK,CAAC,aAAa;YAAE,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,IAAI,CAAC,KAAK,CAAC,OAAO;YAAE,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK,CAAC,YAAY;YAAE,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,IAAI,CAAC,KAAK,CAAC,WAAW;YAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACnC,CAAC"}

package/dist/formatters/index.d.ts

@@ -0,0 +1,2 @@
+export { formatDescription, formatAcceptanceCriteria, formatConstraints, formatSubtasks, formatScenarios, } from "./stage-formatters.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/formatters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/formatters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,iBAAiB,EACjB,cAAc,EACd,eAAe,GAChB,MAAM,uBAAuB,CAAC"}

package/dist/formatters/index.js

@@ -0,0 +1,2 @@
+export { formatDescription, formatAcceptanceCriteria, formatConstraints, formatSubtasks, formatScenarios, } from "./stage-formatters.js";
+//# sourceMappingURL=index.js.map

package/dist/formatters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/formatters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,iBAAiB,EACjB,cAAc,EACd,eAAe,GAChB,MAAM,uBAAuB,CAAC"}

package/dist/formatters/stage-formatters.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Pure markdown formatters for the 5 Refine Pipeline stages.
+ * No side effects, no I/O, no external dependencies.
+ */
+export declare function formatDescription(raw: string): string;
+export declare function formatAcceptanceCriteria(raw: string): string;
+export declare function formatConstraints(raw: string): string;
+export declare function formatSubtasks(raw: string): string;
+export declare function formatScenarios(raw: string): string;
+//# sourceMappingURL=stage-formatters.d.ts.map

package/dist/formatters/stage-formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-formatters.d.ts","sourceRoot":"","sources":["../../src/formatters/stage-formatters.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA0CH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK5D;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CA4BrD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAUlD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAUnD"}

package/dist/formatters/stage-formatters.js

@@ -0,0 +1,100 @@
+/**
+ * Pure markdown formatters for the 5 Refine Pipeline stages.
+ * No side effects, no I/O, no external dependencies.
+ */
+function normalizeWhitespace(raw) {
+    return raw
+        .replace(/\r\n/g, "\n")
+        .replace(/\n{3,}/g, "\n\n")
+        .replace(/^[\t ]+$/gm, "")
+        .replace(/^\n+/, "")
+        .replace(/\n+$/, "");
+}
+function splitIntoItems(raw) {
+    const lines = raw.split("\n").map((l) => l.trim()).filter(Boolean);
+    const listItems = [];
+    const listPattern = /^(?:\d+[\.\)]\s*|-\s*|\*\s*)/;
+    if (lines.some((l) => listPattern.test(l))) {
+        let current = "";
+        for (const line of lines) {
+            if (listPattern.test(line)) {
+                if (current)
+                    listItems.push(current);
+                current = line.replace(listPattern, "").trim();
+            }
+            else {
+                current += " " + line;
+            }
+        }
+        if (current)
+            listItems.push(current);
+    }
+    if (listItems.length > 0)
+        return listItems;
+    // Prose: split on sentence boundaries
+    const text = lines.join(" ");
+    const sentences = text
+        .split(/(?<=[.!?])\s+/)
+        .map((s) => s.trim())
+        .filter(Boolean);
+    return sentences.length > 0 ? sentences : [text];
+}
+export function formatDescription(raw) {
+    if (!raw || !raw.trim())
+        return "No description provided.";
+    return normalizeWhitespace(raw);
+}
+export function formatAcceptanceCriteria(raw) {
+    if (!raw || !raw.trim())
+        return "1. No acceptance criteria specified.";
+    const items = splitIntoItems(raw);
+    return items.map((item, i) => `${i + 1}. ${item}`).join("\n");
+}
+export function formatConstraints(raw) {
+    if (!raw || !raw.trim()) {
+        return "## MUSTS\n\n- None specified.\n\n## MUST-NOTS\n\n- None specified.";
+    }
+    const items = splitIntoItems(raw);
+    const mustNotPattern = /\b(must\s+not|never|avoid|do\s+not|don['']t|shall\s+not|cannot|can['']t)\b/i;
+    const musts = [];
+    const mustNots = [];
+    for (const item of items) {
+        if (mustNotPattern.test(item)) {
+            mustNots.push(item);
+        }
+        else {
+            musts.push(item);
+        }
+    }
+    const mustsSection = musts.length > 0
+        ? musts.map((m) => `- ${m}`).join("\n")
+        : "- None specified.";
+    const mustNotsSection = mustNots.length > 0
+        ? mustNots.map((m) => `- ${m}`).join("\n")
+        : "- None specified.";
+    return `## MUSTS\n\n${mustsSection}\n\n## MUST-NOTS\n\n${mustNotsSection}`;
+}
+export function formatSubtasks(raw) {
+    if (!raw || !raw.trim())
+        return "No decomposition needed.";
+    const noDecompPattern = /\b(no\s+decomposition|single\s+task|not\s+needed|no\s+subtasks)\b/i;
+    if (noDecompPattern.test(raw))
+        return "No decomposition needed.";
+    const items = splitIntoItems(raw);
+    if (items.length === 0)
+        return "No decomposition needed.";
+    return items.map((item) => `- [ ] ${item}`).join("\n");
+}
+export function formatScenarios(raw) {
+    if (!raw || !raw.trim()) {
+        return "[]";
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        return JSON.stringify(parsed, null, 2);
+    }
+    catch {
+        return raw;
+    }
+}
+//# sourceMappingURL=stage-formatters.js.map

package/dist/formatters/stage-formatters.js.map

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

package/dist/formatters/stage-formatters.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=stage-formatters.test.d.ts.map

package/dist/formatters/stage-formatters.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-formatters.test.d.ts","sourceRoot":"","sources":["../../src/formatters/stage-formatters.test.ts"],"names":[],"mappings":""}

package/dist/formatters/stage-formatters.test.js

@@ -0,0 +1,107 @@
+import { strict as assert } from "node:assert";
+import { test } from "node:test";
+import { formatDescription, formatAcceptanceCriteria, formatConstraints, formatSubtasks, formatScenarios, } from "./stage-formatters.js";
+// --- formatDescription ---
+test("formatDescription normalizes whitespace", () => {
+    const raw = "\n\nBuild a REST API that handles user authentication.\n\n\n\nIt should support OAuth2.\n\n\n";
+    const result = formatDescription(raw);
+    assert.equal(result, "Build a REST API that handles user authentication.\n\nIt should support OAuth2.");
+});
+test("formatDescription handles empty input", () => {
+    assert.equal(formatDescription(""), "No description provided.");
+    assert.equal(formatDescription("   "), "No description provided.");
+});
+// --- formatAcceptanceCriteria ---
+test("formatAcceptanceCriteria parses numbered list", () => {
+    const raw = "1. Users can log in\n2. Users can log out\n3. Sessions expire after 30 min";
+    const result = formatAcceptanceCriteria(raw);
+    assert.equal(result, "1. Users can log in\n2. Users can log out\n3. Sessions expire after 30 min");
+});
+test("formatAcceptanceCriteria parses bullet list", () => {
+    const raw = "- Users can log in\n- Users can log out";
+    const result = formatAcceptanceCriteria(raw);
+    assert.equal(result, "1. Users can log in\n2. Users can log out");
+});
+test("formatAcceptanceCriteria splits prose into sentences", () => {
+    const raw = "The system should validate emails. Passwords must be at least 8 characters. Users receive a confirmation email.";
+    const result = formatAcceptanceCriteria(raw);
+    assert.ok(result.startsWith("1. "));
+    assert.ok(result.includes("2. "));
+    assert.ok(result.includes("3. "));
+});
+test("formatAcceptanceCriteria handles empty input", () => {
+    const result = formatAcceptanceCriteria("");
+    assert.ok(result.includes("1."));
+});
+// --- formatConstraints ---
+test("formatConstraints classifies MUSTS and MUST-NOTS", () => {
+    const raw = "Must use TypeScript. Must not use any external dependencies. Avoid global state. Should support ESM only.";
+    const result = formatConstraints(raw);
+    assert.ok(result.includes("## MUSTS"));
+    assert.ok(result.includes("## MUST-NOTS"));
+    assert.ok(result.includes("- Must use TypeScript."));
+    assert.ok(result.includes("- Must not use any external dependencies."));
+    assert.ok(result.includes("- Avoid global state."));
+});
+test("formatConstraints handles no must-nots", () => {
+    const raw = "Use TypeScript. Support ESM.";
+    const result = formatConstraints(raw);
+    assert.ok(result.includes("## MUST-NOTS"));
+    assert.ok(result.includes("- None specified."));
+});
+test("formatConstraints handles empty input", () => {
+    const result = formatConstraints("");
+    assert.ok(result.includes("## MUSTS"));
+    assert.ok(result.includes("## MUST-NOTS"));
+});
+// --- formatSubtasks ---
+test("formatSubtasks produces task list", () => {
+    const raw = "1. Set up project structure\n2. Implement auth module\n3. Write tests";
+    const result = formatSubtasks(raw);
+    assert.ok(result.includes("- [ ] Set up project structure"));
+    assert.ok(result.includes("- [ ] Implement auth module"));
+    assert.ok(result.includes("- [ ] Write tests"));
+});
+test("formatSubtasks detects no decomposition", () => {
+    assert.equal(formatSubtasks("No decomposition needed for this task."), "No decomposition needed.");
+    assert.equal(formatSubtasks("This is a single task."), "No decomposition needed.");
+});
+test("formatSubtasks handles empty input", () => {
+    assert.equal(formatSubtasks(""), "No decomposition needed.");
+});
+// --- formatScenarios ---
+test("formatScenarios parses given/when/then", () => {
+    const raw = "Given a user is logged in When they click logout Then they are redirected to the login page";
+    const result = formatScenarios(raw);
+    assert.ok(result.includes("**Scenario 1**"));
+    assert.ok(result.includes("GIVEN:"));
+    assert.ok(result.includes("EXPECTED:"));
+});
+test("formatScenarios parses GIVEN/EXPECTED style", () => {
+    const raw = "GIVEN a valid API key EXPECTED the request succeeds with 200";
+    const result = formatScenarios(raw);
+    assert.ok(result.includes("**Scenario 1**"));
+    assert.ok(result.includes("GIVEN: a valid API key"));
+    assert.ok(result.includes("EXPECTED: the request succeeds with 200"));
+});
+test("formatScenarios handles empty input", () => {
+    const result = formatScenarios("");
+    assert.ok(result.includes("**Scenario 1**"));
+    assert.ok(result.includes("GIVEN:"));
+    assert.ok(result.includes("EXPECTED:"));
+});
+test("formatScenarios handles multiple scenarios", () => {
+    const raw = "GIVEN valid input EXPECTED success\nGIVEN invalid input EXPECTED error message";
+    const result = formatScenarios(raw);
+    assert.ok(result.includes("**Scenario 1**"));
+    assert.ok(result.includes("**Scenario 2**"));
+});
+test("all formatters are pure - same input yields same output", () => {
+    const input = "Test input string. Another sentence.";
+    assert.equal(formatDescription(input), formatDescription(input));
+    assert.equal(formatAcceptanceCriteria(input), formatAcceptanceCriteria(input));
+    assert.equal(formatConstraints(input), formatConstraints(input));
+    assert.equal(formatSubtasks(input), formatSubtasks(input));
+    assert.equal(formatScenarios(input), formatScenarios(input));
+});
+//# sourceMappingURL=stage-formatters.test.js.map

package/dist/formatters/stage-formatters.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-formatters.test.js","sourceRoot":"","sources":["../../src/formatters/stage-formatters.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,iBAAiB,EACjB,cAAc,EACd,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAE/B,4BAA4B;AAE5B,IAAI,CAAC,yCAAyC,EAAE,GAAG,EAAE;IACnD,MAAM,GAAG,GAAG,+FAA+F,CAAC;IAC5G,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,iFAAiF,CAAC,CAAC;AAC1G,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,uCAAuC,EAAE,GAAG,EAAE;IACjD,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC,EAAE,0BAA0B,CAAC,CAAC;IAChE,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,0BAA0B,CAAC,CAAC;AACrE,CAAC,CAAC,CAAC;AAEH,mCAAmC;AAEnC,IAAI,CAAC,+CAA+C,EAAE,GAAG,EAAE;IACzD,MAAM,GAAG,GAAG,4EAA4E,CAAC;IACzF,MAAM,MAAM,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,4EAA4E,CAAC,CAAC;AACrG,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,6CAA6C,EAAE,GAAG,EAAE;IACvD,MAAM,GAAG,GAAG,yCAAyC,CAAC;IACtD,MAAM,MAAM,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,2CAA2C,CAAC,CAAC;AACpE,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,sDAAsD,EAAE,GAAG,EAAE;IAChE,MAAM,GAAG,GAAG,iHAAiH,CAAC;IAC9H,MAAM,MAAM,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAClC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AACpC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,8CAA8C,EAAE,GAAG,EAAE;IACxD,MAAM,MAAM,GAAG,wBAAwB,CAAC,EAAE,CAAC,CAAC;IAC5C,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AACnC,CAAC,CAAC,CAAC;AAEH,4BAA4B;AAE5B,IAAI,CAAC,kDAAkD,EAAE,GAAG,EAAE;IAC5D,MAAM,GAAG,GAAG,2GAA2G,CAAC;IACxH,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;IACvC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC;IAC3C,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAC,CAAC;IACrD,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,2CAA2C,CAAC,CAAC,CAAC;IACxE,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC,CAAC;AACtD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,wCAAwC,EAAE,GAAG,EAAE;IAClD,MAAM,GAAG,GAAG,8BAA8B,CAAC;IAC3C,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC;IAC3C,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC;AAClD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,uCAAuC,EAAE,GAAG,EAAE;IACjD,MAAM,MAAM,GAAG,iBAAiB,CAAC,EAAE,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;IACvC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC;AAC7C,CAAC,CAAC,CAAC;AAEH,yBAAyB;AAEzB,IAAI,CAAC,mCAAmC,EAAE,GAAG,EAAE;IAC7C,MAAM,GAAG,GAAG,uEAAuE,CAAC;IACpF,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,gCAAgC,CAAC,CAAC,CAAC;IAC7D,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,6BAA6B,CAAC,CAAC,CAAC;IAC1D,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC;AAClD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,yCAAyC,EAAE,GAAG,EAAE;IACnD,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,wCAAwC,CAAC,EAAE,0BAA0B,CAAC,CAAC;IACnG,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,wBAAwB,CAAC,EAAE,0BAA0B,CAAC,CAAC;AACrF,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,oCAAoC,EAAE,GAAG,EAAE;IAC9C,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC,EAAE,0BAA0B,CAAC,CAAC;AAC/D,CAAC,CAAC,CAAC;AAEH,0BAA0B;AAE1B,IAAI,CAAC,wCAAwC,EAAE,GAAG,EAAE;IAClD,MAAM,GAAG,GAAG,6FAA6F,CAAC;IAC1G,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC7C,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;AAC1C,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,6CAA6C,EAAE,GAAG,EAAE;IACvD,MAAM,GAAG,GAAG,8DAA8D,CAAC;IAC3E,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC7C,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAC,CAAC;IACrD,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,yCAAyC,CAAC,CAAC,CAAC;AACxE,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,qCAAqC,EAAE,GAAG,EAAE;IAC/C,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC7C,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;AAC1C,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,4CAA4C,EAAE,GAAG,EAAE;IACtD,MAAM,GAAG,GAAG,gFAAgF,CAAC;IAC7F,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC7C,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC;AAC/C,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,yDAAyD,EAAE,GAAG,EAAE;IACnE,MAAM,KAAK,GAAG,sCAAsC,CAAC;IACrD,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;IACjE,MAAM,CAAC,KAAK,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,wBAAwB,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/E,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;IACjE,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3D,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/D,CAAC,CAAC,CAAC"}

package/dist/guardrails/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/guardrails/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/guardrails/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC"}

package/dist/guardrails/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/guardrails/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/guardrails/index.ts"],"names":[],"mappings":""}

package/dist/guardrails/loader.d.ts

@@ -0,0 +1,9 @@
+export declare function listGuardrails(): Array<{
+    slug: string;
+    title: string;
+}>;
+export declare function addGuardrail(title: string): void;
+export declare function showGuardrail(slug: string): string;
+export declare function removeGuardrail(slug: string): void;
+export declare function loadAllGuardrails(): string;
+//# sourceMappingURL=loader.d.ts.map

package/dist/guardrails/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/guardrails/loader.ts"],"names":[],"mappings":"AAQA,wBAAgB,cAAc,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAcvE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAUhD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQlD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAQlD;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAY1C"}