stoa-mcp 0.1.0 → 0.1.2

package/LICENSE

@@ -1,65 +1,21 @@
-Business Source License 1.1
-
-Licensor: Lambis Stratoudakis
-
-Licensed Work: Stoa MCP
-                The Licensed Work is (c) 2026 Lambis Stratoudakis.
-
-Additional Use Grant: You may make production use of the Licensed Work,
-                      provided your use does not include offering the
-                      Licensed Work to third parties on a hosted or
-                      embedded basis which is competitive with the
-                      Licensor's products.
-
-Change Date: 2030-03-11
-
-Change License: MIT
-
-For information about alternative licensing arrangements, please visit:
-https://stoa.dev
-
---------------------------------------------------------------------------
-
-Business Source License 1.1
-
-Terms
-
-The Licensor hereby grants you the right to copy, modify, create derivative
-works, redistribute, and make non-production use of the Licensed Work. The
-Licensor may make an Additional Use Grant, above, permitting limited
-production use.
-
-Effective on the Change Date, or the fourth anniversary of the first publicly
-available distribution of a specific version of the Licensed Work under this
-License, whichever comes first, the Licensor hereby grants you rights under
-the terms of the Change License, and the rights granted in the paragraph
-above terminate.
-
-If your use of the Licensed Work does not comply with the requirements
-currently in effect as described in this License, you must purchase a
-commercial license from the Licensor, its affiliated entities, or authorized
-resellers, or you must refrain from using the Licensed Work.
-
-All copies of the original and modified Licensed Work, and derivative works
-of the Licensed Work, are subject to this License. This License applies
-separately for each version of the Licensed Work and the Change Date may vary
-for each version of the Licensed Work released by Licensor.
-
-You must conspicuously display this License on each original or modified copy
-of the Licensed Work. If you receive the Licensed Work in original or
-modified form from a third party, the terms and conditions set forth in this
-License apply to your use of that work.
-
-Any use of the Licensed Work in violation of this License will automatically
-terminate your rights under this License for the current and all other
-versions of the Licensed Work.
-
-This License does not grant you any right in any trademark or logo of
-Licensor or its affiliates (provided that you may use a trademark or logo of
-Licensor as expressly required by this License).
-
-TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
-AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
-EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
-TITLE.
+MIT License
+
+Copyright (c) 2026 Lambis Stratoudakis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -92,34 +92,46 @@ Stoa runs 5 stages:
 After refining, Stoa:
 - Saves the spec as readable markdown files in `.stoa/specs/`
 - Copies Stage 1 to your clipboard automatically
-- Prints a build command you can use with Claude Code
+- Shows an interactive menu:
 
 ```
 Spec saved to .stoa/specs/personal-finance-tracker/
-Score: 5/5 Executable
+Spec Score: 5 / 5
 
 → Stage 1 description copied to clipboard
   Paste into Lovable, Bolt, v0, or any AI tool
 
-→ Build prompt for Claude Code:
-  Read the spec in .stoa/specs/personal-finance-tracker/ and build it.
-
-→ Scenarios saved. Run: stoa scenarios run
+What next?
+  [b] Build with Claude Code
+  [c] Copy spec to clipboard
+  [e] Export as single markdown
+  [v] View spec files
+  [q] Done
 ```
 
+- **[b] Build** — launches Claude Code with the spec pre-loaded
+- **[c] Copy** — re-copies the full spec to clipboard (useful if you copied something else)
+- **[e] Export** — writes all 5 stages as a single markdown to `specs/<slug>/spec.md` in your project root (visible, not hidden inside `.stoa/`)
+- **[v] View** — opens the spec directory in Finder
+- **[q] Done** — exits
+
 ### 4. Build
 
-**Option A — Paste into any AI tool:**
+**Option A — Press [b] after refine:**
+
+The fastest path. Press `b` in the post-refine menu and Claude Code starts building immediately.
+
+**Option B — Paste into any AI tool:**
 
 Open Lovable, Bolt, v0, or any AI coding tool. Press Cmd+V. The spec is already on your clipboard. The AI builds exactly what you specified.
 
-**Option B — Use Claude Code:**
+**Option C — Use Claude Code manually:**
 
 ```bash
 claude "Read the spec in .stoa/specs/personal-finance-tracker/ and build it. Follow all constraints and subtasks."
 ```
 
-**Option C — Use Cursor with Claude Code extension:**
+**Option D — Use Cursor with Claude Code extension:**
 
 Open the project folder in Cursor. Open Claude Code from the sidebar. Paste the build prompt.
 
@@ -261,6 +273,8 @@ stoa refine "task" --mode clipboard  # Get prompts without AI calls
 # Specs
 stoa specs list                  # List all saved specs
 stoa specs show <name>           # View a spec's contents
+# Export (also available as [e] in the post-refine menu)
+# Writes to specs/<slug>/spec.md in your project root
 
 # Scenarios
 stoa scenarios list              # List scenarios for latest spec

package/dist/cli/build.d.ts

@@ -36,4 +36,3 @@ export declare function parseSubtasks(specContent: string): Subtask[];
  * Returns "all", "q", or a 1-based subtask number.
  */
 export declare function promptSubtaskChoice(subtasks: Subtask[]): Promise<string>;
-//# sourceMappingURL=build.d.ts.map

package/dist/cli/build.js

@@ -285,4 +285,3 @@ export function promptSubtaskChoice(subtasks) {
         });
     });
 }
-//# sourceMappingURL=build.js.map

package/dist/cli/review-loop.d.ts

@@ -1,2 +1 @@
 export declare function runReviewLoop(specDir: string): Promise<void>;
-//# sourceMappingURL=review-loop.d.ts.map

package/dist/cli/review-loop.js

@@ -94,4 +94,3 @@ export async function runReviewLoop(specDir) {
         await appendFile(join(specDir, "user-notes.md"), entry, "utf-8");
     }
 }
-//# sourceMappingURL=review-loop.js.map

package/dist/cli/scenarios-runner.d.ts

@@ -9,4 +9,3 @@ export declare function loadSpecScenarios(specName?: string): Promise<{
 }>;
 export declare function runSpecScenarios(specName?: string): Promise<void>;
 export {};
-//# sourceMappingURL=scenarios-runner.d.ts.map

package/dist/cli/scenarios-runner.js

@@ -155,4 +155,3 @@ export async function runSpecScenarios(specName) {
         }
     }
 }
-//# sourceMappingURL=scenarios-runner.js.map

package/dist/cli/verify.d.ts

@@ -10,4 +10,3 @@ export interface VerifyResult {
     failures: VerifyFailure[];
 }
 export declare function runVerify(name: string): Promise<VerifyResult>;
-//# sourceMappingURL=verify.d.ts.map

package/dist/cli/verify.js

@@ -146,4 +146,3 @@ export async function runVerify(name) {
     process.stdout.write(`\nPassed: ${result.passed} | Failed: ${result.failed} | Skipped: ${result.skipped}\n`);
     return result;
 }
-//# sourceMappingURL=verify.js.map

package/dist/cli.d.ts

@@ -1,3 +1,2 @@
 #!/usr/bin/env node
 export {};
-//# sourceMappingURL=cli.d.ts.map

package/dist/cli.js

@@ -14,7 +14,7 @@ import { listGuardrails, addGuardrail, showGuardrail, removeGuardrail, } from ".
 import { refinePipeline as refineGuardrail } from "./guardrails/refine.js";
 import { refinePipeline as refineRole } from "./storage/roles-refine.js";
 import { toSlug, resolveSlug } from "./utils/slug.js";
-import { readMoodboard, writeSpecFiles, writeRefineMeta, listSpecs, showSpec } from "./storage/index.js";
+import { readMoodboard, writeSpecFiles, writeRefineMeta, listSpecs, showSpec, STAGE_FILENAMES } from "./storage/index.js";
 import { listRoles, addRole, showRole, removeRole, loadRole, } from "./storage/roles.js";
 import { listScenarios, showScenarios, addScenario, removeScenario, } from "./storage/scenarios.js";
 import { generateScenarios } from "./storage/scenarios-refine.js";
@@ -130,11 +130,130 @@ function copyToClipboard(text) {
         // Clipboard unavailable — skip silently
     }
 }
+async function buildExportMarkdown(specsDir, slug) {
+    const specDir = join(specsDir, slug);
+    const sections = [];
+    for (const stageNum of [1, 2, 3, 4, 5]) {
+        const filename = STAGE_FILENAMES[stageNum];
+        if (!filename)
+            continue;
+        try {
+            const content = await readFile(join(specDir, filename), "utf-8");
+            const displayName = STAGE_DISPLAY_NAMES[stageNum] ?? `Stage ${stageNum}`;
+            sections.push(`## Stage ${stageNum}: ${displayName}\n\n${content.trimEnd()}`);
+        }
+        catch {
+            // stage file missing — skip
+        }
+    }
+    return sections.join("\n\n") + "\n";
+}
+function waitForKeypress() {
+    return new Promise((resolve) => {
+        const { stdin } = process;
+        if (!stdin.isTTY || typeof stdin.setRawMode !== "function") {
+            resolve("q");
+            return;
+        }
+        const wasRaw = stdin.isRaw;
+        stdin.setRawMode(true);
+        stdin.resume();
+        stdin.once("data", (data) => {
+            stdin.setRawMode(wasRaw);
+            stdin.pause();
+            resolve(data.toString());
+        });
+    });
+}
+async function showPostRefineMenu(slug) {
+    const specsDir = join(process.cwd(), ".stoa", "specs");
+    const specDir = join(specsDir, slug);
+    const printMenu = () => {
+        writeln();
+        writeln(chalk.bold("What next?"));
+        writeln(`  ${chalk.cyan("[b]")} Build with Claude Code`);
+        writeln(`  ${chalk.cyan("[c]")} Copy spec to clipboard`);
+        writeln(`  ${chalk.cyan("[e]")} Export as single markdown`);
+        writeln(`  ${chalk.cyan("[v]")} View spec files`);
+        writeln(`  ${chalk.cyan("[q]")} Done`);
+        writeln();
+    };
+    if (!process.stdin.isTTY) {
+        writeln();
+        writeln(chalk.bold("Next steps:"));
+        writeln(`  ${chalk.cyan("stoa export")} ${slug}  — export spec as markdown`);
+        writeln(`  ${chalk.cyan("stoa build")} ${slug}   — build with Claude Code`);
+        writeln();
+        return;
+    }
+    printMenu();
+    while (true) {
+        const key = await waitForKeypress();
+        // Handle Ctrl+C
+        if (key === "\x03") {
+            process.exit(0);
+        }
+        switch (key.toLowerCase()) {
+            case "b": {
+                // Verify spec dir exists
+                try {
+                    await access(specDir);
+                }
+                catch {
+                    writeln(chalk.red(`Error: spec directory not found: .stoa/specs/${slug}/`));
+                    printMenu();
+                    break;
+                }
+                const buildPrompt = `Read the spec in .stoa/specs/${slug}/ and build it. Follow all constraints and subtasks. Do not modify or delete the .stoa/ directory — it is not part of the project.`;
+                spawn("claude", [buildPrompt], { stdio: "inherit", detached: true });
+                return;
+            }
+            case "c": {
+                const markdown = await buildExportMarkdown(specsDir, slug);
+                copyToClipboard(markdown);
+                writeln(chalk.green("Spec copied to clipboard."));
+                printMenu();
+                break;
+            }
+            case "e": {
+                const markdown = await buildExportMarkdown(specsDir, slug);
+                const exportDir = join(process.cwd(), "specs", slug);
+                await mkdir(exportDir, { recursive: true });
+                const exportPath = join(exportDir, "spec.md");
+                await writeFile(exportPath, markdown, "utf-8");
+                writeln(chalk.green(`Exported to specs/${slug}/spec.md`));
+                printMenu();
+                break;
+            }
+            case "v": {
+                // Verify spec dir exists
+                try {
+                    await access(specDir);
+                }
+                catch {
+                    writeln(chalk.red(`Error: spec directory not found: .stoa/specs/${slug}/`));
+                    printMenu();
+                    break;
+                }
+                const opener = process.platform === "darwin" ? "open" : "xdg-open";
+                spawn(opener, [specDir], { stdio: "ignore", detached: true });
+                writeln(chalk.dim(specDir));
+                printMenu();
+                break;
+            }
+            case "q": {
+                process.exit(0);
+            }
+            default:
+                // Ignore unrecognized keys
+                break;
+        }
+    }
+}
 async function printPostRefineOutput(slug, specScore) {
     const specsDir = join(process.cwd(), ".stoa", "specs");
     const descPath = join(specsDir, slug, "01-problem-statement.md");
-    const scenariosPath = join(specsDir, slug, "05-evaluation-design.md");
-    // Copy Stage 1 to clipboard
+    // Copy Stage 1 to clipboard (preserved behavior)
     let copiedToClipboard = false;
     try {
         const descContent = await readFile(descPath, "utf-8");
@@ -144,15 +263,6 @@ async function printPostRefineOutput(slug, specScore) {
     catch {
         // description file missing — skip
     }
-    // Check if scenarios exist
-    let hasScenarios = false;
-    try {
-        const scenariosContent = await readFile(scenariosPath, "utf-8");
-        hasScenarios = scenariosContent.trim().length > 0;
-    }
-    catch {
-        // no scenarios file
-    }
     writeln();
     writeln(chalk.cyan(`Spec saved to .stoa/specs/${slug}/`));
     printScoreBadge(specScore);
@@ -161,13 +271,7 @@ async function printPostRefineOutput(slug, specScore) {
         writeln(chalk.green("→ Stage 1 description copied to clipboard"));
         writeln(chalk.dim("  Paste into Lovable, Bolt, v0, or any AI tool"));
     }
-    writeln();
-    writeln(chalk.green("→ Build prompt for Claude Code:"));
-    writeln(chalk.dim(`  Read the spec in .stoa/specs/${slug}/ and build it. Follow all constraints and subtasks.`));
-    if (hasScenarios) {
-        writeln();
-        writeln(chalk.green(`→ Scenarios saved. Run: ${chalk.white(`stoa scenarios run ${slug}`)}`));
-    }
+    await showPostRefineMenu(slug);
 }
 function resolveStages(stagesArg) {
     const names = stagesArg.split(",").map((s) => s.trim());
@@ -1132,4 +1236,3 @@ program
 });
 // ── Parse ─────────────────────────────────────────────────────────────
 program.parse();
-//# sourceMappingURL=cli.js.map

package/dist/core/index.d.ts

@@ -1,3 +1,2 @@
 export { computeSpecScore } from "./spec-score.js";
 export type { SpecScoreInput, SpecScoreResult } from "./spec-score.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/core/index.js

@@ -1,2 +1 @@
 export { computeSpecScore } from "./spec-score.js";
-//# sourceMappingURL=index.js.map

package/dist/core/parsers.d.ts

@@ -26,4 +26,3 @@ interface ScenarioItem {
 }
 export declare function parseScenarios(raw: string): ScenarioItem[];
 export {};
-//# sourceMappingURL=parsers.d.ts.map

package/dist/core/parsers.js

@@ -293,4 +293,3 @@ export function parseScenarios(raw) {
         return [];
     return parsed;
 }
-//# sourceMappingURL=parsers.js.map

package/dist/core/prompts.d.ts

@@ -27,4 +27,3 @@ export declare function buildConstraintPrompt(title: string, refinedDescription:
 export declare function buildDecompositionPrompt(title: string, refinedDescription: string, acceptanceCriteria: string, constraints: string, options?: PromptOptions): PromptResult;
 export declare function buildEvaluationDesignPrompt(title: string, refinedDescription: string, acceptanceCriteria: string, constraints: string, options?: PromptOptions): PromptResult;
 export {};
-//# sourceMappingURL=prompts.d.ts.map

package/dist/core/prompts.js

@@ -343,4 +343,3 @@ Return ONLY the JSON array. No preamble, no explanation.`;
         userPrompt: buildUserPrompt(fields),
     };
 }
-//# sourceMappingURL=prompts.js.map

package/dist/core/refine.d.ts

@@ -35,4 +35,3 @@ export interface RefineResult {
     executionMode: "api" | "claude-code" | "clipboard";
 }
 export declare function refinePipeline(input: RefineInput, options?: RefineOptions): Promise<RefineResult>;
-//# sourceMappingURL=refine.d.ts.map

package/dist/core/refine.js

@@ -230,4 +230,3 @@ export async function refinePipeline(input, options = {}) {
         executionMode: mode,
     };
 }
-//# sourceMappingURL=refine.js.map

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

@@ -14,4 +14,3 @@ export interface SpecScoreResult {
     missing: string[];
 }
 export declare function computeSpecScore(input: SpecScoreInput): SpecScoreResult;
-//# sourceMappingURL=spec-score.d.ts.map

package/dist/core/spec-score.js

@@ -56,4 +56,3 @@ export function computeSpecScore(input) {
     }
     return { score, level, missing };
 }
-//# sourceMappingURL=spec-score.js.map

package/dist/formatters/index.d.ts

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

package/dist/formatters/index.js

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

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

@@ -7,4 +7,3 @@ 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.js

@@ -97,4 +97,3 @@ export function formatScenarios(raw) {
         return raw;
     }
 }
-//# sourceMappingURL=stage-formatters.js.map

package/dist/guardrails/index.d.ts

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

package/dist/guardrails/index.js

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

package/dist/guardrails/loader.d.ts

@@ -6,4 +6,3 @@ 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.js

@@ -53,4 +53,3 @@ export function loadAllGuardrails() {
         .map((file) => readFileSync(join(guardrailsDir(), file), "utf-8"))
         .join("\n---\n");
 }
-//# sourceMappingURL=loader.js.map

package/dist/guardrails/refine.d.ts

@@ -50,4 +50,3 @@ export interface GuardrailRefineResult {
  * @throws If the guardrail file does not exist.
  */
 export declare function refinePipeline(options: GuardrailRefineOptions): Promise<GuardrailRefineResult>;
-//# sourceMappingURL=refine.d.ts.map

package/dist/guardrails/refine.js

@@ -181,4 +181,3 @@ export async function refinePipeline(options) {
     }
     return { prompts, finalOutput: currentInput };
 }
-//# sourceMappingURL=refine.js.map

package/dist/index.d.ts

@@ -3,4 +3,3 @@
  * Registers refine_task, score_spec tools, guardrails resource, and refine prompt.
  */
 export {};
-//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -193,4 +193,3 @@ main().catch((err) => {
     process.stderr.write(`Fatal: ${err}\n`);
     process.exit(1);
 });
-//# sourceMappingURL=index.js.map

package/dist/storage/change-detection.d.ts

@@ -1,2 +1 @@
 export declare function detectChanges(specDir: string, snapshot: Record<string, string>): Promise<number[]>;
-//# sourceMappingURL=change-detection.d.ts.map

package/dist/storage/change-detection.js

@@ -44,4 +44,3 @@ export async function detectChanges(specDir, snapshot) {
     const stages = new Set(results.flat());
     return [...stages].sort((a, b) => a - b);
 }
-//# sourceMappingURL=change-detection.js.map

package/dist/storage/index.d.ts

@@ -6,4 +6,3 @@ export { detectChanges } from "./change-detection.js";
 export { scanProject } from "./project-scan.js";
 export type { ProjectContext } from "./project-scan.js";
 export { syncMoodboard } from "./moodboard-sync.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/storage/index.js

@@ -3,4 +3,3 @@ export { readMoodboard } from "./moodboard.js";
 export { detectChanges } from "./change-detection.js";
 export { scanProject } from "./project-scan.js";
 export { syncMoodboard } from "./moodboard-sync.js";
-//# sourceMappingURL=index.js.map

package/dist/storage/moodboard-describe.d.ts

@@ -11,4 +11,3 @@ export interface DescribeResult {
     written: boolean;
 }
 export declare function describeMoodboard(dir: string, options: DescribeOptions): Promise<DescribeResult>;
-//# sourceMappingURL=moodboard-describe.d.ts.map

package/dist/storage/moodboard-describe.js

@@ -182,4 +182,3 @@ export async function describeMoodboard(dir, options) {
     }
     return { mode: "api", output, imageCount: imageFiles.length, written: true };
 }
-//# sourceMappingURL=moodboard-describe.js.map

package/dist/storage/moodboard-sync.d.ts

@@ -8,4 +8,3 @@ interface TokensResult {
 }
 export declare function syncMoodboard(dir: string): TokensResult;
 export {};
-//# sourceMappingURL=moodboard-sync.d.ts.map

package/dist/storage/moodboard-sync.js

@@ -202,4 +202,3 @@ export function syncMoodboard(dir) {
     writeFileSync(tokensPath, JSON.stringify(tokens, null, 2) + "\n", "utf-8");
     return tokens;
 }
-//# sourceMappingURL=moodboard-sync.js.map

package/dist/storage/moodboard.d.ts

@@ -1,4 +1,3 @@
 import type { MoodboardContext } from "../core/prompts.js";
 export type { MoodboardContext } from "../core/prompts.js";
 export declare function readMoodboard(projectRoot: string): Promise<MoodboardContext | null>;
-//# sourceMappingURL=moodboard.d.ts.map

package/dist/storage/moodboard.js

@@ -65,4 +65,3 @@ export async function readMoodboard(projectRoot) {
     await writeFile(join(moodboardDir, ".snapshot"), snapshot, "utf-8");
     return context;
 }
-//# sourceMappingURL=moodboard.js.map

package/dist/storage/project-scan.d.ts

@@ -9,4 +9,3 @@ export interface ProjectContext {
     lessons?: string;
 }
 export declare function scanProject(dir: string): ProjectContext;
-//# sourceMappingURL=project-scan.d.ts.map

package/dist/storage/project-scan.js

@@ -115,4 +115,3 @@ export function scanProject(dir) {
     context.lessons = readFileSafe(join(dir, ".stoa", "lessons.md"));
     return context;
 }
-//# sourceMappingURL=project-scan.js.map

package/dist/storage/project.d.ts

@@ -7,4 +7,3 @@ interface ProjectConfig {
 export declare function initProject(name: string, type: string, noTemplates?: boolean): Promise<boolean>;
 export declare function loadConfig(): Promise<ProjectConfig>;
 export {};
-//# sourceMappingURL=project.d.ts.map

package/dist/storage/project.js

@@ -98,4 +98,3 @@ export async function loadConfig() {
     const raw = await readFile(configPath, "utf-8");
     return JSON.parse(raw);
 }
-//# sourceMappingURL=project.js.map

package/dist/storage/roles-refine.d.ts

@@ -56,4 +56,3 @@ export interface RoleRefineResult {
  * @throws If the role file does not exist.
  */
 export declare function refinePipeline(options: RoleRefineOptions): Promise<RoleRefineResult>;
-//# sourceMappingURL=roles-refine.d.ts.map

package/dist/storage/roles-refine.js

@@ -220,4 +220,3 @@ export async function refinePipeline(options) {
     // Stage 3 output is NOT written to any file — it's advisory only
     return { prompts, finalOutput: currentInput };
 }
-//# sourceMappingURL=roles-refine.js.map

package/dist/storage/roles.d.ts

@@ -3,4 +3,3 @@ export declare function addRole(displayName: string): void;
 export declare function showRole(slug: string): string;
 export declare function removeRole(slug: string): void;
 export declare function loadRole(slug: string): string;
-//# sourceMappingURL=roles.d.ts.map

package/dist/storage/roles.js

@@ -38,4 +38,3 @@ export function removeRole(slug) {
 export function loadRole(slug) {
     return showRole(slug);
 }
-//# sourceMappingURL=roles.js.map

package/dist/storage/scenarios-refine.d.ts

@@ -44,4 +44,3 @@ export declare function buildValidationCommandPrompt(structuredScenarios: string
  * @param mode - Execution mode: "api", "clipboard", or "cli".
  */
 export declare function generateScenarios(taskName: string, mode: "api" | "clipboard" | "cli"): Promise<void>;
-//# sourceMappingURL=scenarios-refine.d.ts.map

package/dist/storage/scenarios-refine.js

@@ -308,4 +308,3 @@ export async function generateScenarios(taskName, mode) {
     writeFileSync(outPath, JSON.stringify(finalScenarios, null, 2) + "\n", "utf-8");
     process.stderr.write(`\nWritten: .stoa/scenarios/${taskName}.json (${finalScenarios.length} scenarios)\n`);
 }
-//# sourceMappingURL=scenarios-refine.js.map