stoa-mcp 0.1.0

package/dist/cli/build.js

@@ -0,0 +1,288 @@
+import { existsSync, readFileSync, mkdirSync, createWriteStream, readdirSync } from "node:fs";
+import { join, relative } from "node:path";
+import { spawn } from "node:child_process";
+import { createInterface } from "node:readline";
+import chalk from "chalk";
+import { loadAllGuardrails } from "../guardrails/loader.js";
+import { loadRole } from "../storage/roles.js";
+/**
+ * Read an approved spec file and extract Stage 1 + Stage 3 content.
+ * Exits non-zero if the file is missing or either stage is absent.
+ */
+export function readApprovedSpec(name) {
+    const specDir = join(process.cwd(), ".stoa", "specs", name);
+    const descPath = join(specDir, "01-problem-statement.md");
+    const constraintsPath = join(specDir, "03-constraints.md");
+    if (!existsSync(descPath)) {
+        process.stderr.write(`Error: Spec description not found: ${descPath}\n`);
+        process.exit(1);
+    }
+    if (!existsSync(constraintsPath)) {
+        process.stderr.write(`Error: Spec constraints not found: ${constraintsPath}\n`);
+        process.exit(1);
+    }
+    const stage1 = readFileSync(descPath, "utf-8").trim();
+    const stage3 = readFileSync(constraintsPath, "utf-8").trim();
+    if (stage1.length === 0) {
+        process.stderr.write(`Error: Stage 1 (Problem Statement) is empty in ${descPath}\n`);
+        process.exit(1);
+    }
+    if (stage3.length === 0) {
+        process.stderr.write(`Error: Stage 3 (Constraints) is empty in ${constraintsPath}\n`);
+        process.exit(1);
+    }
+    return { stage1, stage3 };
+}
+/**
+ * Extract a stage section from the approved spec markdown.
+ * Matches `## Stage N:` headers and captures content until the next `## Stage` header or EOF.
+ */
+function extractSection(content, stageNum) {
+    const pattern = new RegExp(`^## Stage ${stageNum}:[^\\n]*\\n([\\s\\S]*?)(?=^## Stage \\d|$)`, "m");
+    const match = pattern.exec(content);
+    if (!match)
+        return null;
+    const text = match[1].trim();
+    return text.length > 0 ? text : null;
+}
+/**
+ * Compose a full build prompt from an approved spec, role, guardrails, and moodboard.
+ * Does NOT include scenario content.
+ */
+export function composePrompt(name, opts) {
+    const { stage1, stage3 } = readApprovedSpec(name);
+    const roleText = loadRole(opts.role);
+    const guardrailsText = loadAllGuardrails();
+    const parts = [];
+    // Role persona
+    parts.push("# Role\n");
+    parts.push(roleText);
+    // Stage 1: Problem Statement
+    parts.push("\n\n# Task\n");
+    parts.push(stage1);
+    // Stage 3: Constraints
+    parts.push("\n\n# Constraints\n");
+    parts.push(stage3);
+    // Guardrails
+    if (guardrailsText.length > 0) {
+        parts.push("\n\n# Guardrails\n");
+        parts.push(guardrailsText);
+    }
+    // Moodboard reference
+    const moodboardPath = join(process.cwd(), ".stoa", "moodboard", "notes.md");
+    if (existsSync(moodboardPath)) {
+        const moodboardText = readFileSync(moodboardPath, "utf-8").trim();
+        if (moodboardText.length > 0) {
+            parts.push("\n\n# Moodboard\n");
+            parts.push(moodboardText);
+        }
+    }
+    return parts.join("");
+}
+const ALLOWED_TOOLS = "Edit,Write,Read,Glob,Grep,LSP";
+const OVERALL_TIMEOUT_MS = 600_000;
+/**
+ * Spawn Claude Code in Edit Files mode with the build prompt.
+ * Streams output to both terminal and a session log file in `.stoa/sessions/`.
+ * Uses --allowedTools so Claude Code can create/edit files (not --print).
+ * Completes when the close event fires (Claude Code exits normally in Edit Files mode).
+ */
+export function runBuild(name, prompt) {
+    return new Promise((resolve, reject) => {
+        const startTime = Date.now();
+        // Ensure sessions directory exists
+        const sessionsDir = join(process.cwd(), ".stoa", "sessions");
+        mkdirSync(sessionsDir, { recursive: true });
+        // Session file: <name>-<ISO8601>.md
+        const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+        const sessionFile = `${name}-${timestamp}.md`;
+        const sessionPath = join(sessionsDir, sessionFile);
+        // Write session header
+        const logStream = createWriteStream(sessionPath, { flags: "a" });
+        logStream.write(`# Build Session: ${name}\n`);
+        logStream.write(`- Timestamp: ${new Date().toISOString()}\n`);
+        logStream.write(`- Spec: ${name}\n`);
+        logStream.write(`- Mode: claude-code (Edit Files)\n\n---\n\n`);
+        const child = spawn("claude", [
+            "--output-format", "text",
+            "--allowedTools", ALLOWED_TOOLS,
+        ], {
+            shell: false,
+            stdio: ["pipe", "pipe", "pipe"],
+            cwd: process.cwd(),
+        });
+        let resolved = false;
+        const finish = () => {
+            if (resolved)
+                return;
+            resolved = true;
+            clearTimeout(overallTimer);
+            process.removeListener("SIGINT", onParentSigint);
+            child.kill();
+            const durationSec = ((Date.now() - startTime) / 1000).toFixed(1);
+            logStream.write(`\n\n---\nDuration: ${durationSec}s\n`);
+            logStream.end();
+            process.stdout.write("\n");
+            process.stdout.write(chalk.green(`Build complete in ${durationSec}s\n`));
+            process.stdout.write(chalk.dim(`Session saved: ${sessionPath}\n`));
+            // Post-build: scan for package.json files needing npm install
+            postBuildInstall();
+            // Detect start command
+            postBuildStartHint();
+            process.stdout.write(chalk.cyan(`Run ${chalk.white("stoa verify")} to check blind test scenarios.\n`));
+            resolve();
+        };
+        child.stdout.on("data", (chunk) => {
+            process.stdout.write(chunk);
+            logStream.write(chunk);
+        });
+        child.stderr.on("data", (chunk) => {
+            process.stderr.write(chunk);
+        });
+        child.on("close", () => {
+            finish();
+        });
+        const overallTimer = setTimeout(() => {
+            if (!resolved) {
+                resolved = true;
+                process.removeListener("SIGINT", onParentSigint);
+                child.kill("SIGKILL");
+                logStream.end();
+                reject(new Error(`Claude Code subprocess timed out after ${OVERALL_TIMEOUT_MS / 1000}s`));
+            }
+        }, OVERALL_TIMEOUT_MS);
+        const onParentSigint = () => {
+            child.kill("SIGINT");
+        };
+        process.once("SIGINT", onParentSigint);
+        child.on("error", (err) => {
+            if (!resolved) {
+                resolved = true;
+                clearTimeout(overallTimer);
+                process.removeListener("SIGINT", onParentSigint);
+                logStream.end();
+                if (err.code === "ENOENT") {
+                    process.stderr.write(chalk.red("\nError: Claude Code CLI not found.\n") +
+                        chalk.dim("Install: https://docs.anthropic.com/en/docs/claude-code\n") +
+                        chalk.dim("Or use `stoa export " + name + "` to copy the prompt to clipboard.\n"));
+                }
+                reject(err);
+            }
+        });
+        // Write prompt to stdin and close
+        child.stdin.write(prompt);
+        child.stdin.end();
+    });
+}
+/**
+ * Scan for package.json files (max 3 levels deep) that lack node_modules/.
+ * Auto-run npm install for each.
+ */
+function postBuildInstall() {
+    const cwd = process.cwd();
+    const found = findPackageJsons(cwd, 0, 3);
+    for (const dir of found) {
+        const nodeModulesPath = join(dir, "node_modules");
+        if (!existsSync(nodeModulesPath)) {
+            const relDir = relative(cwd, dir) || ".";
+            process.stdout.write(chalk.dim(`Installing dependencies in ./${relDir}...\n`));
+            try {
+                const child = spawn("npm", ["install"], {
+                    cwd: dir,
+                    stdio: "inherit",
+                    shell: false,
+                });
+                // Fire-and-forget — don't block on npm install
+                child.unref();
+            }
+            catch {
+                // Non-critical — continue
+            }
+        }
+    }
+}
+/**
+ * Recursively find directories containing package.json, up to maxDepth levels.
+ */
+function findPackageJsons(dir, depth, maxDepth) {
+    const results = [];
+    if (depth > maxDepth)
+        return results;
+    if (existsSync(join(dir, "package.json"))) {
+        results.push(dir);
+    }
+    if (depth < maxDepth) {
+        try {
+            const entries = readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.isDirectory() && entry.name !== "node_modules" && !entry.name.startsWith(".")) {
+                    results.push(...findPackageJsons(join(dir, entry.name), depth + 1, maxDepth));
+                }
+            }
+        }
+        catch {
+            // Permission error or similar — skip
+        }
+    }
+    return results;
+}
+/**
+ * Check for dev or start script in package.json and print a hint.
+ */
+function postBuildStartHint() {
+    const pkgPath = join(process.cwd(), "package.json");
+    if (!existsSync(pkgPath))
+        return;
+    try {
+        const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+        const scripts = pkg.scripts ?? {};
+        if (scripts.dev) {
+            process.stdout.write(chalk.dim(`To start the app: ${chalk.white("npm run dev")}\n`));
+        }
+        else if (scripts.start) {
+            process.stdout.write(chalk.dim(`To start the app: ${chalk.white("npm start")}\n`));
+        }
+    }
+    catch {
+        // ignore malformed package.json
+    }
+}
+/**
+ * Parse a `## Subtasks` section from spec content.
+ * Extracts numbered items (e.g. "1. Do something").
+ * Returns empty array if no Subtasks section exists.
+ */
+export function parseSubtasks(specContent) {
+    const pattern = /^## Subtasks\s*\n([\s\S]*?)(?=\n## )/m;
+    const match = pattern.exec(specContent);
+    // If no next ## heading, try matching to end of string
+    const endPattern = /^## Subtasks\s*\n([\s\S]*)$/m;
+    const result = match ?? endPattern.exec(specContent);
+    if (!result)
+        return [];
+    const body = result[1];
+    const subtasks = [];
+    const itemPattern = /^(\d+)\.\s+(.+(?:\n(?!\d+\.).*)*)/gm;
+    let itemMatch;
+    while ((itemMatch = itemPattern.exec(body)) !== null) {
+        subtasks.push({
+            index: parseInt(itemMatch[1], 10),
+            text: itemMatch[2].trim(),
+        });
+    }
+    return subtasks;
+}
+/**
+ * Prompt user to choose subtask execution mode.
+ * Returns "all", "q", or a 1-based subtask number.
+ */
+export function promptSubtaskChoice(subtasks) {
+    return new Promise((resolve) => {
+        const rl = createInterface({ input: process.stdin, output: process.stdout });
+        rl.question(chalk.cyan(`Build all sequentially or pick one? [all/1-${subtasks.length}/q] `), (answer) => {
+            rl.close();
+            resolve(answer.trim().toLowerCase());
+        });
+    });
+}
+//# sourceMappingURL=build.js.map

package/dist/cli/build.js.map

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"review-loop.d.ts","sourceRoot":"","sources":["../../src/cli/review-loop.ts"],"names":[],"mappings":"AAuCA,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAiEf"}

package/dist/cli/review-loop.js

@@ -0,0 +1,97 @@
+import { readFile, appendFile } from "node:fs/promises";
+import { join } from "node:path";
+import { spawnSync } from "node:child_process";
+import { createInterface } from "node:readline/promises";
+const SECTIONS = [
+    { display: "DESCRIPTION", file: "01-problem-statement.md" },
+    { display: "CRITERIA", file: "02-acceptance-criteria.md" },
+    { display: "CONSTRAINTS", file: "03-constraints.md" },
+    { display: "SUBTASKS", file: "04-decomposition.md" },
+    { display: "SCENARIOS", file: "05-evaluation-design.md" },
+];
+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);
+        });
+    });
+}
+async function readSectionContent(filePath) {
+    try {
+        return await readFile(filePath, "utf-8");
+    }
+    catch {
+        return null;
+    }
+}
+export async function runReviewLoop(specDir) {
+    for (const section of SECTIONS) {
+        const filePath = join(specDir, section.file);
+        process.stdout.write(`\n=== ${section.display} ===\n`);
+        const content = await readSectionContent(filePath);
+        if (content === null) {
+            process.stdout.write("[no content]\n");
+        }
+        else {
+            process.stdout.write(content);
+            if (!content.endsWith("\n")) {
+                process.stdout.write("\n");
+            }
+        }
+        let handled = false;
+        while (!handled) {
+            process.stdout.write("[Enter] continue  [e] edit  [s] skip");
+            const buf = await readKeypress();
+            const byte = buf[0];
+            process.stdout.write("\n");
+            if (byte === 0x0d || byte === 0x0a) {
+                // Enter — advance
+                handled = true;
+            }
+            else if (byte === 0x65) {
+                // 'e' — edit
+                const editor = process.env["EDITOR"] || "vi";
+                try {
+                    spawnSync(editor, [filePath], { stdio: "inherit" });
+                }
+                catch (err) {
+                    if (err instanceof Error &&
+                        "code" in err &&
+                        err.code === "ENOENT") {
+                        process.stderr.write(`Editor not found: ${editor}\n`);
+                        continue;
+                    }
+                    throw err;
+                }
+                handled = true;
+            }
+            else if (byte === 0x73) {
+                // 's' — skip
+                handled = true;
+            }
+            // Any other key: loop re-prompts
+        }
+    }
+    // Additional notes prompt
+    process.stdout.write("\nAdditional notes (leave blank to skip): ");
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const line = await rl.question("");
+    rl.close();
+    const trimmed = line.trim();
+    if (trimmed.length > 0) {
+        const now = new Date().toISOString();
+        const entry = `\n## Notes — ${now}\n${trimmed}\n`;
+        await appendFile(join(specDir, "user-notes.md"), entry, "utf-8");
+    }
+}
+//# sourceMappingURL=review-loop.js.map

package/dist/cli/review-loop.js.map

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

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

@@ -0,0 +1,12 @@
+interface Scenario {
+    title: string;
+    given: string;
+    expected: string;
+}
+export declare function loadSpecScenarios(specName?: string): Promise<{
+    specName: string;
+    scenarios: Scenario[];
+}>;
+export declare function runSpecScenarios(specName?: string): Promise<void>;
+export {};
+//# sourceMappingURL=scenarios-runner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scenarios-runner.d.ts","sourceRoot":"","sources":["../../src/cli/scenarios-runner.ts"],"names":[],"mappings":"AAIA,UAAU,QAAQ;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAoGD,wBAAsB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,QAAQ,EAAE,CAAA;CAAE,CAAC,CAkB/G;AAUD,wBAAsB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDvE"}

package/dist/cli/scenarios-runner.js

@@ -0,0 +1,158 @@
+import { createInterface } from "node:readline";
+import { readdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+function parseSpecScenarios(content) {
+    const scenarios = [];
+    // Strip markdown code fences if present
+    const stripped = content.replace(/^```(?:json)?\s*\n?/gm, "").replace(/\n?```\s*$/gm, "");
+    const trimmed = stripped.trim();
+    // Try JSON array first (raw stage 5 output)
+    if (trimmed.startsWith("[")) {
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (Array.isArray(parsed)) {
+                for (const item of parsed) {
+                    if (typeof item === "object" && item !== null &&
+                        typeof item.title === "string" &&
+                        typeof item.given === "string" &&
+                        typeof item.expected === "string") {
+                        scenarios.push(item);
+                    }
+                }
+                if (scenarios.length > 0)
+                    return scenarios;
+            }
+        }
+        catch {
+            // Not JSON — fall through to markdown parsing
+        }
+    }
+    // Parse markdown format: ## Title blocks with **Given:**/**Expected:** or Given:/Expected:
+    const blocks = content.split(/^##\s+/m);
+    for (const block of blocks) {
+        const blockTrimmed = block.trim();
+        if (blockTrimmed.length === 0)
+            continue;
+        const firstNewline = blockTrimmed.indexOf("\n");
+        if (firstNewline === -1)
+            continue;
+        const title = blockTrimmed.slice(0, firstNewline).trim();
+        const body = blockTrimmed.slice(firstNewline + 1);
+        const givenMatch = body.match(/\*{0,2}(?:given|GIVEN)\*{0,2}[:\s]+(.+?)(?=\*{0,2}(?:expected|EXPECTED)\*{0,2}[:\s])/is);
+        const expectedMatch = body.match(/\*{0,2}(?:expected|EXPECTED)\*{0,2}[:\s]+(.+)/is);
+        if (givenMatch && expectedMatch) {
+            scenarios.push({
+                title,
+                given: givenMatch[1].replace(/^\*+|\*+$/g, "").trim(),
+                expected: expectedMatch[1].replace(/^\*+|\*+$/g, "").trim(),
+            });
+        }
+    }
+    // Fallback: numbered list with title / given / expected per block
+    if (scenarios.length === 0) {
+        const numberedBlocks = content.split(/^\d+\.\s+/m);
+        for (const block of numberedBlocks) {
+            const blockTrimmed = block.trim();
+            if (blockTrimmed.length === 0)
+                continue;
+            const titleMatch = blockTrimmed.match(/^\*{0,2}(.+?)\*{0,2}\s*$/m);
+            const givenMatch = blockTrimmed.match(/\*{0,2}(?:given|GIVEN)\*{0,2}[:\s]+(.+?)(?=\*{0,2}(?:expected|EXPECTED)\*{0,2}[:\s])/is);
+            const expectedMatch = blockTrimmed.match(/\*{0,2}(?:expected|EXPECTED)\*{0,2}[:\s]+(.+)/is);
+            if (titleMatch && givenMatch && expectedMatch) {
+                scenarios.push({
+                    title: titleMatch[1].replace(/^\*+|\*+$/g, "").trim(),
+                    given: givenMatch[1].replace(/^\*+|\*+$/g, "").trim(),
+                    expected: expectedMatch[1].replace(/^\*+|\*+$/g, "").trim(),
+                });
+            }
+        }
+    }
+    return scenarios;
+}
+async function getMostRecentSpec() {
+    const specsDir = join(process.cwd(), ".stoa", "specs");
+    const entries = await readdir(specsDir);
+    const { stat } = await import("node:fs/promises");
+    const dirs = [];
+    for (const entry of entries) {
+        const s = await stat(join(specsDir, entry));
+        if (s.isDirectory()) {
+            dirs.push({ name: entry, mtime: s.mtimeMs });
+        }
+    }
+    if (dirs.length === 0) {
+        throw new Error("No specs found. Run 'stoa refine' first.");
+    }
+    dirs.sort((a, b) => b.mtime - a.mtime);
+    return dirs[0].name;
+}
+export async function loadSpecScenarios(specName) {
+    const resolvedName = specName ?? await getMostRecentSpec();
+    const specDir = join(process.cwd(), ".stoa", "specs", resolvedName);
+    const scenarioFile = join(specDir, "05-evaluation-design.md");
+    let content;
+    try {
+        content = await readFile(scenarioFile, "utf-8");
+    }
+    catch {
+        throw new Error(`No scenarios found for spec "${resolvedName}". Run a full refine first.`);
+    }
+    const scenarios = parseSpecScenarios(content);
+    if (scenarios.length === 0) {
+        throw new Error(`Could not parse scenarios from spec "${resolvedName}".`);
+    }
+    return { specName: resolvedName, scenarios };
+}
+function askQuestion(rl, prompt) {
+    return new Promise((resolve) => {
+        rl.question(prompt, (answer) => {
+            resolve(answer.trim().toLowerCase());
+        });
+    });
+}
+export async function runSpecScenarios(specName) {
+    const { specName: name, scenarios } = await loadSpecScenarios(specName);
+    process.stdout.write(`\nScenarios for: ${name}\n`);
+    process.stdout.write(`${scenarios.length} scenario(s)\n`);
+    process.stdout.write("─".repeat(40) + "\n");
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    let passed = 0;
+    let failed = 0;
+    let skipped = 0;
+    const failures = [];
+    try {
+        for (let i = 0; i < scenarios.length; i++) {
+            const s = scenarios[i];
+            process.stdout.write(`\nScenario ${i + 1}/${scenarios.length}: ${s.title}\n\n`);
+            process.stdout.write(`  GIVEN:\n  ${s.given}\n\n`);
+            process.stdout.write(`  EXPECTED:\n  ${s.expected}\n\n`);
+            const answer = await askQuestion(rl, "  Pass? [y/n/s(skip)] ");
+            if (answer === "y" || answer === "yes") {
+                passed++;
+                process.stdout.write("  ✓ Passed\n");
+            }
+            else if (answer === "s" || answer === "skip") {
+                skipped++;
+                process.stdout.write("  — Skipped\n");
+            }
+            else {
+                failed++;
+                failures.push(s.title);
+                process.stdout.write("  ✗ Failed\n");
+            }
+        }
+    }
+    finally {
+        rl.close();
+    }
+    // Summary
+    process.stdout.write("\n" + "─".repeat(40) + "\n");
+    process.stdout.write(`Results: ${passed} passed, ${failed} failed, ${skipped} skipped\n`);
+    if (failures.length > 0) {
+        process.stdout.write("Failed:\n");
+        for (const f of failures) {
+            process.stdout.write(`  - ${f}\n`);
+        }
+    }
+}
+//# sourceMappingURL=scenarios-runner.js.map

package/dist/cli/scenarios-runner.js.map

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

package/dist/cli/verify.d.ts

@@ -0,0 +1,13 @@
+export interface VerifyFailure {
+    scenarioId: number;
+    expected: string;
+    actual: string;
+}
+export interface VerifyResult {
+    passed: number;
+    failed: number;
+    skipped: number;
+    failures: VerifyFailure[];
+}
+export declare function runVerify(name: string): Promise<VerifyResult>;
+//# sourceMappingURL=verify.d.ts.map

package/dist/cli/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/cli/verify.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAsED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA2FnE"}