stoa-mcp 0.1.1 → 0.1.2

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.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());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stoa-mcp",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "The Specification Compiler for AI Agents. Transform vague tasks into executable specs with blind test scenarios.",
   "type": "module",
   "main": "dist/index.js",