stoa-mcp 0.1.0

package/dist/cli/verify.js

@@ -0,0 +1,149 @@
+import { createInterface } from "node:readline/promises";
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+function readKeypress() {
+    return new Promise((resolve, reject) => {
+        const wasRaw = process.stdin.isRaw;
+        process.stdin.setRawMode(true);
+        process.stdin.resume();
+        process.stdin.once("data", (data) => {
+            process.stdin.setRawMode(wasRaw);
+            process.stdin.pause();
+            resolve(data);
+        });
+        process.stdin.once("error", (err) => {
+            process.stdin.setRawMode(wasRaw);
+            process.stdin.pause();
+            reject(err);
+        });
+    });
+}
+/**
+ * Load scenarios from .stoa/specs/<name>/05-evaluation-design.md.
+ * Tries JSON.parse first. If that fails, extracts JSON array from markdown
+ * (finds first '[' and last ']'). Falls back to parsing GIVEN/EXPECTED blocks.
+ */
+function loadSpecScenarios(name) {
+    const scenariosPath = join(process.cwd(), ".stoa", "specs", name, "05-evaluation-design.md");
+    if (!existsSync(scenariosPath)) {
+        throw new Error(`Scenarios file not found: .stoa/specs/${name}/05-evaluation-design.md`);
+    }
+    const content = readFileSync(scenariosPath, "utf-8");
+    // Try JSON.parse on full content
+    try {
+        const parsed = JSON.parse(content);
+        if (Array.isArray(parsed))
+            return parsed;
+    }
+    catch {
+        // Not pure JSON — try extracting embedded JSON
+    }
+    // Try extracting JSON array from markdown
+    const firstBracket = content.indexOf("[");
+    const lastBracket = content.lastIndexOf("]");
+    if (firstBracket !== -1 && lastBracket > firstBracket) {
+        try {
+            const jsonStr = content.slice(firstBracket, lastBracket + 1);
+            const parsed = JSON.parse(jsonStr);
+            if (Array.isArray(parsed))
+                return parsed;
+        }
+        catch {
+            // Not valid JSON — fall through to text parsing
+        }
+    }
+    // Parse formatted scenarios: **Scenario N**\nGIVEN: ...\nEXPECTED: ...
+    const scenarios = [];
+    const pattern = /\*\*Scenario\s+\d+\*\*\s*\n\s*GIVEN:\s*(.+)\s*\n\s*EXPECTED:\s*(.+)/gi;
+    let match;
+    while ((match = pattern.exec(content)) !== null) {
+        scenarios.push({
+            title: `Scenario ${scenarios.length + 1}`,
+            given: match[1].trim(),
+            expected: match[2].trim(),
+        });
+    }
+    return scenarios;
+}
+export async function runVerify(name) {
+    let scenarios;
+    try {
+        scenarios = loadSpecScenarios(name);
+    }
+    catch {
+        process.stderr.write(`Error: scenarios file not found: .stoa/specs/${name}/05-evaluation-design.md\n`);
+        process.exit(1);
+    }
+    if (scenarios.length === 0) {
+        process.stderr.write(`No scenarios found in ${name}\n`);
+        process.exit(1);
+    }
+    const total = scenarios.length;
+    const result = { passed: 0, failed: 0, skipped: 0, failures: [] };
+    for (let i = 0; i < total; i++) {
+        const s = scenarios[i];
+        process.stdout.write(`\nScenario ${i + 1} of ${total}\n`);
+        process.stdout.write(`  GIVEN:    ${s.given}\n`);
+        process.stdout.write(`  WHEN:     ${s.title}\n`);
+        process.stdout.write(`  EXPECTED: ${s.expected}\n`);
+        process.stdout.write(`  Result? [p]ass / [f]ail / [s]kip: `);
+        let answered = false;
+        while (!answered) {
+            const buf = await readKeypress();
+            const ch = String.fromCharCode(buf[0]).toLowerCase();
+            if (ch === "p") {
+                process.stdout.write("pass\n");
+                result.passed++;
+                answered = true;
+            }
+            else if (ch === "s") {
+                process.stdout.write("skip\n");
+                result.skipped++;
+                answered = true;
+            }
+            else if (ch === "f") {
+                process.stdout.write("fail\n");
+                // Switch to line mode for failure description
+                const rl = createInterface({ input: process.stdin, output: process.stdout });
+                const response = await rl.question("  What went wrong? ");
+                rl.close();
+                result.failed++;
+                result.failures.push({
+                    scenarioId: i,
+                    expected: s.expected,
+                    actual: response,
+                });
+                answered = true;
+            }
+            // Other keys: ignore, loop re-prompts
+        }
+    }
+    if (result.failures.length > 0) {
+        const fixesDir = join(process.cwd(), ".stoa", "specs", name, "fixes");
+        mkdirSync(fixesDir, { recursive: true });
+        // Count existing fix-NNN.md files to determine next number
+        const existing = existsSync(fixesDir)
+            ? readdirSync(fixesDir).filter((f) => /^fix-\d+\.md$/.test(f))
+            : [];
+        const nextNum = existing.length + 1;
+        const padded = String(nextNum).padStart(3, "0");
+        const fixPath = join(fixesDir, `fix-${padded}.md`);
+        const lines = [`# Fix ${padded}`, ""];
+        lines.push("## Failed Scenarios", "");
+        for (const f of result.failures) {
+            const s = scenarios[f.scenarioId];
+            lines.push(`- **${s.title}** (scenario ${f.scenarioId})`);
+            lines.push(`  - Expected: ${f.expected}`);
+            lines.push(`  - Actual: ${f.actual}`);
+        }
+        lines.push("", "## Fix Task", "");
+        lines.push("<!-- Describe what needs to change to fix the failures above -->", "");
+        writeFileSync(fixPath, lines.join("\n"), "utf-8");
+        const relPath = `.stoa/specs/${name}/fixes/fix-${padded}.md`;
+        process.stdout.write(`\nFix file created: ${relPath}\n`);
+        process.stdout.write(`Run: stoa build ${name} --fix ${nextNum}\n`);
+    }
+    process.stdout.write(`\nPassed: ${result.passed} | Failed: ${result.failed} | Skipped: ${result.skipped}\n`);
+    return result;
+}
+//# sourceMappingURL=verify.js.map

package/dist/cli/verify.js.map

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

package/dist/cli.d.ts

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

package/dist/cli.d.ts.map

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