wotann 0.5.0

package/dist/snippets/snippet-store.js

@@ -0,0 +1,267 @@
+/**
+ * Snippet store — cross-surface prompt library backed by SQLite.
+ *
+ * Round 8 feature ("creative power-feature" mandate from user). The
+ * iOS app shipped a `PromptLibraryView` storing snippets to
+ * `UserDefaults` — Desktop had nothing, CLI had nothing, and the iOS
+ * library didn't sync anywhere. This store promotes that zombie
+ * surface to a daemon-backed RPC so a snippet written on the phone
+ * shows up on desktop the next morning.
+ *
+ * **Why SQLite + FTS5**: snippet bodies can be arbitrarily long
+ * prompt templates. FTS5 lets users search across body text in
+ * milliseconds. The same dependency WOTANN already uses for memory.
+ *
+ * **`{{variable}}` substitution**: bodies may contain `{{var_name}}`
+ * tokens. `extractVariables(body)` scans a body and returns the unique
+ * set of placeholders so the UI can render a form. `render(body, vars)`
+ * substitutes — missing keys are surfaced via the result envelope so
+ * the UI can warn instead of silently leaving raw `{{var}}` in the
+ * rendered output.
+ *
+ * **Concurrency**: better-sqlite3 + WAL mode means many readers + one
+ * writer at a time. The daemon process holds the only writer lock.
+ * Conflicts on simultaneous edits across surfaces are last-write-wins
+ * via `updatedAt` — same semantics as MemoryStore.update().
+ */
+import Database from "better-sqlite3";
+/**
+ * Extract the set of `{{var}}` placeholders from a body. Identifiers
+ * are `[A-Za-z_][A-Za-z0-9_]*` — same shape JavaScript identifiers
+ * use, so users can name variables intuitively. Whitespace inside
+ * braces (`{{ user_name }}`) is tolerated.
+ */
+export function extractVariables(body) {
+    const seen = new Set();
+    const re = /\{\{\s*([A-Za-z_][A-Za-z0-9_]*)\s*\}\}/g;
+    let match;
+    while ((match = re.exec(body)) !== null) {
+        if (match[1])
+            seen.add(match[1]);
+    }
+    return [...seen];
+}
+/**
+ * Render a body with variable substitution. Missing variables stay
+ * as raw `{{var}}` tokens in the output AND are surfaced in
+ * `missingVars` so the UI can warn the user instead of silently
+ * shipping a half-rendered prompt.
+ */
+export function renderSnippet(body, vars) {
+    const missing = new Set();
+    const rendered = body.replace(/\{\{\s*([A-Za-z_][A-Za-z0-9_]*)\s*\}\}/g, (raw, key) => {
+        if (Object.prototype.hasOwnProperty.call(vars, key)) {
+            return vars[key] ?? "";
+        }
+        missing.add(key);
+        return raw;
+    });
+    return { rendered, missingVars: [...missing] };
+}
+export class SnippetStore {
+    db;
+    constructor(dbPath) {
+        this.db = new Database(dbPath);
+        this.db.pragma("journal_mode = WAL");
+        this.db.pragma("busy_timeout = 5000");
+        this.initSchema();
+    }
+    initSchema() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS snippets (
+        id           TEXT PRIMARY KEY,
+        title        TEXT NOT NULL,
+        body         TEXT NOT NULL,
+        category     TEXT,
+        tags         TEXT NOT NULL DEFAULT '',
+        is_favorite  INTEGER NOT NULL DEFAULT 0,
+        use_count    INTEGER NOT NULL DEFAULT 0,
+        last_used_at INTEGER,
+        created_at   INTEGER NOT NULL,
+        updated_at   INTEGER NOT NULL
+      );
+      CREATE INDEX IF NOT EXISTS snippets_updated_at_idx ON snippets(updated_at DESC);
+      CREATE INDEX IF NOT EXISTS snippets_last_used_at_idx ON snippets(last_used_at DESC);
+      CREATE INDEX IF NOT EXISTS snippets_category_idx ON snippets(category);
+    `);
+        // FTS5 shadow keyed on the snippet rowid (better-sqlite3 assigns
+        // an integer rowid to every row in the snippets table). We keep
+        // the FTS table in sync manually rather than via triggers so
+        // upsert/delete remain atomic with the main-table write.
+        this.db.exec(`
+      CREATE VIRTUAL TABLE IF NOT EXISTS snippets_fts USING fts5(
+        title, body, tokenize = 'porter unicode61'
+      );
+    `);
+    }
+    /** Generate a unique snippet id. */
+    mintId() {
+        return `snip-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
+    }
+    /**
+     * Insert or update a snippet. Returns the canonical record after
+     * write. If `input.id` is omitted (or refers to no row) a new id
+     * is minted.
+     */
+    upsert(input) {
+        const now = Date.now();
+        const id = input.id ?? this.mintId();
+        const tagsCsv = (input.tags ?? []).join(",");
+        const isFav = input.isFavorite ? 1 : 0;
+        const existing = this.db.prepare("SELECT id FROM snippets WHERE id = ?").get(id);
+        if (existing) {
+            this.db
+                .prepare(`UPDATE snippets
+           SET title = ?, body = ?, category = ?, tags = ?, is_favorite = ?, updated_at = ?
+           WHERE id = ?`)
+                .run(input.title, input.body, input.category ?? null, tagsCsv, isFav, now, id);
+            // Refresh FTS row.
+            this.db.prepare("DELETE FROM snippets_fts WHERE rowid = ?").run(this.rowidOf(id));
+        }
+        else {
+            this.db
+                .prepare(`INSERT INTO snippets (id, title, body, category, tags, is_favorite, use_count, last_used_at, created_at, updated_at)
+           VALUES (?, ?, ?, ?, ?, ?, 0, NULL, ?, ?)`)
+                .run(id, input.title, input.body, input.category ?? null, tagsCsv, isFav, now, now);
+        }
+        // Always (re)insert FTS row tied to the current snippet rowid so
+        // search stays consistent whether this was an insert or update.
+        const rowid = this.rowidOf(id);
+        this.db
+            .prepare("INSERT INTO snippets_fts (rowid, title, body) VALUES (?, ?, ?)")
+            .run(rowid, input.title, input.body);
+        return this.getById(id);
+    }
+    /** Hard-delete a snippet by id. */
+    delete(id) {
+        const rowid = this.rowidOf(id);
+        if (rowid === null)
+            return false;
+        this.db.prepare("DELETE FROM snippets_fts WHERE rowid = ?").run(rowid);
+        const result = this.db.prepare("DELETE FROM snippets WHERE id = ?").run(id);
+        return result.changes > 0;
+    }
+    /** Look up a snippet by id, or null if absent. */
+    getById(id) {
+        const row = this.db.prepare("SELECT * FROM snippets WHERE id = ?").get(id);
+        if (!row)
+            return null;
+        return this.rowToSnippet(row);
+    }
+    /**
+     * List snippets ordered by: pinned (favorite) first, then
+     * last-used desc, then updated_at desc. Filter is optional.
+     *
+     * FTS5 tokens are sanitized (quoted) so user input can include
+     * special characters without triggering syntax errors.
+     */
+    list(filter = {}) {
+        const where = [];
+        const params = [];
+        if (filter.category) {
+            where.push("category = ?");
+            params.push(filter.category);
+        }
+        if (filter.favOnly) {
+            where.push("is_favorite = 1");
+        }
+        let sql;
+        if (filter.query && filter.query.trim().length > 0) {
+            // FTS5 MATCH — quote the user term to neutralize special chars.
+            // We split on whitespace and quote each token, joining with AND
+            // so multi-word queries narrow rather than confuse the parser.
+            const tokens = filter.query
+                .trim()
+                .split(/\s+/)
+                .map((t) => `"${t.replace(/"/g, '""')}"`);
+            const matchExpr = tokens.join(" AND ");
+            sql = `
+        SELECT s.* FROM snippets s
+        JOIN snippets_fts f ON f.rowid = s.rowid
+        WHERE f.snippets_fts MATCH ?
+        ${where.length > 0 ? `AND ${where.join(" AND ")}` : ""}
+        ORDER BY s.is_favorite DESC, COALESCE(s.last_used_at, 0) DESC, s.updated_at DESC
+      `;
+            params.unshift(matchExpr);
+        }
+        else {
+            sql = `
+        SELECT * FROM snippets
+        ${where.length > 0 ? `WHERE ${where.join(" AND ")}` : ""}
+        ORDER BY is_favorite DESC, COALESCE(last_used_at, 0) DESC, updated_at DESC
+      `;
+        }
+        const rows = this.db.prepare(sql).all(...params);
+        return rows.map((r) => this.rowToSnippet(r));
+    }
+    /**
+     * Render a snippet with variable substitution AND record the use.
+     * Use-recording bumps `useCount` and `lastUsedAt` so the picker can
+     * surface the user's most-frequent prompts at the top.
+     *
+     * Returns the render envelope plus the updated snippet record so
+     * callers can re-display current ranking without a follow-up list.
+     */
+    use(id, vars = {}) {
+        const snippet = this.getById(id);
+        if (!snippet)
+            return null;
+        const now = Date.now();
+        this.db
+            .prepare("UPDATE snippets SET use_count = use_count + 1, last_used_at = ? WHERE id = ?")
+            .run(now, id);
+        const fresh = this.getById(id);
+        const render = renderSnippet(snippet.body, vars);
+        return { snippet: fresh, render };
+    }
+    /** Total non-deleted snippet count. */
+    count() {
+        const row = this.db.prepare("SELECT COUNT(*) AS c FROM snippets").get();
+        return row.c;
+    }
+    /** Health probe — confirm the SQLite handle is live. */
+    healthCheck() {
+        try {
+            const row = this.db.prepare("SELECT 1 AS ok").get();
+            return row?.ok === 1;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Close the underlying db. Call before process exit. */
+    close() {
+        this.db.close();
+    }
+    // ── Private helpers ─────────────────────────────────────
+    rowidOf(id) {
+        const row = this.db.prepare("SELECT rowid FROM snippets WHERE id = ?").get(id);
+        return row?.rowid ?? null;
+    }
+    rowToSnippet(row) {
+        const body = String(row["body"] ?? "");
+        const tagsRaw = String(row["tags"] ?? "");
+        const tags = tagsRaw.length > 0
+            ? tagsRaw
+                .split(",")
+                .map((t) => t.trim())
+                .filter((t) => t.length > 0)
+            : [];
+        return {
+            id: String(row["id"]),
+            title: String(row["title"] ?? ""),
+            body,
+            category: row["category"] ?? null,
+            tags,
+            isFavorite: Number(row["is_favorite"] ?? 0) === 1,
+            useCount: Number(row["use_count"] ?? 0),
+            lastUsedAt: row["last_used_at"] === null || row["last_used_at"] === undefined
+                ? null
+                : Number(row["last_used_at"]),
+            createdAt: Number(row["created_at"] ?? 0),
+            updatedAt: Number(row["updated_at"] ?? 0),
+            variables: extractVariables(body),
+        };
+    }
+}
+//# sourceMappingURL=snippet-store.js.map

package/dist/snippets/snippet-store.js.map

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

package/dist/sop/pipeline.d.ts

@@ -0,0 +1,60 @@
+/**
+ * SOP Pipeline orchestrator — chain PRD → Design → Code → QA stages.
+ *
+ * V9 T12.7: ports MetaGPT's role-based pipeline. The orchestrator is
+ * pure-logic: callers inject the model + the (optional) custom stage
+ * writers. By default it composes the four shipped writers:
+ *   prd-writer, design-writer, code-generator, qa
+ *
+ * The fifth stage (`deploy`) is intentionally a separate skill that
+ * lives outside this module — deployment touches disk + network and
+ * needs explicit user approval. The pipeline stops after `qa` and
+ * returns the artifact list; the caller decides whether to chain a
+ * deploy step.
+ *
+ * Hand-off shape
+ * ──────────────
+ * Each stage receives `priorArtifacts: readonly SopArtifact[]` and
+ * pulls only what it needs. The orchestrator records the artifact
+ * even when validation fails, retries up to N times, then either
+ * proceeds (if validation eventually passes) or marks the pipeline
+ * `blocked` and returns.
+ *
+ * Quality bars
+ *   QB #6  honest failures   — no silent success on stage failure
+ *   QB #7  per-call state    — every runPipeline call gets fresh
+ *                              retry counters; no module globals
+ *   QB #13 env guard         — zero process.env reads
+ *   QB #14 claim verify      — `outcome` reflects the actual stage outcome
+ */
+import type { PipelineResult, SopArtifact, SopModel, SopStage, StageWriter } from "./types.js";
+export interface PipelineOptions {
+    /** The product idea (free-form 1-line description). */
+    readonly idea: string;
+    /** The model used for all stages, or a per-stage override map. */
+    readonly model: SopModel | Readonly<Partial<Record<SopStage, SopModel>>>;
+    /** Override individual stage writers (test injection). */
+    readonly writers?: Readonly<Partial<Record<SopStage, StageWriter>>>;
+    /** Max retries per stage on validation failure. Default 1. */
+    readonly maxRetriesPerStage?: number;
+    /**
+     * Stages to run, in order. Default = ["prd", "design", "code", "qa"].
+     * The "deploy" stage is excluded by default — see module docstring.
+     */
+    readonly stages?: readonly SopStage[];
+    /** Clock for deterministic tests. Default `() => Date.now()`. */
+    readonly now?: () => number;
+    /** Optional callback fired after each stage completes (or fails). */
+    readonly onStageComplete?: (artifact: SopArtifact, attempts: number) => void;
+}
+/**
+ * Run the full SOP pipeline. Returns a PipelineResult — never throws.
+ * Per-call closures (no module-level mutable state).
+ */
+export declare function runPipeline(options: PipelineOptions): Promise<PipelineResult>;
+/**
+ * Helper to summarize pipeline output into a one-paragraph string —
+ * useful for CLI printing.
+ */
+export declare function summarizePipeline(result: PipelineResult): string;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/sop/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/sop/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,WAAW,EAEZ,MAAM,YAAY,CAAC;AAOpB,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACzE,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACpE,8DAA8D;IAC9D,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IACtC,iEAAiE;IACjE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9E;AAmCD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAmInF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAgBhE"}

package/dist/sop/pipeline.js

@@ -0,0 +1,214 @@
+/**
+ * SOP Pipeline orchestrator — chain PRD → Design → Code → QA stages.
+ *
+ * V9 T12.7: ports MetaGPT's role-based pipeline. The orchestrator is
+ * pure-logic: callers inject the model + the (optional) custom stage
+ * writers. By default it composes the four shipped writers:
+ *   prd-writer, design-writer, code-generator, qa
+ *
+ * The fifth stage (`deploy`) is intentionally a separate skill that
+ * lives outside this module — deployment touches disk + network and
+ * needs explicit user approval. The pipeline stops after `qa` and
+ * returns the artifact list; the caller decides whether to chain a
+ * deploy step.
+ *
+ * Hand-off shape
+ * ──────────────
+ * Each stage receives `priorArtifacts: readonly SopArtifact[]` and
+ * pulls only what it needs. The orchestrator records the artifact
+ * even when validation fails, retries up to N times, then either
+ * proceeds (if validation eventually passes) or marks the pipeline
+ * `blocked` and returns.
+ *
+ * Quality bars
+ *   QB #6  honest failures   — no silent success on stage failure
+ *   QB #7  per-call state    — every runPipeline call gets fresh
+ *                              retry counters; no module globals
+ *   QB #13 env guard         — zero process.env reads
+ *   QB #14 claim verify      — `outcome` reflects the actual stage outcome
+ */
+import { STAGE_ORDER } from "./types.js";
+import { prdWriter } from "./stages/prd-writer.js";
+import { designWriter } from "./stages/design-writer.js";
+import { codeGenerator } from "./stages/code-generator.js";
+import { qaWriter, qaVerdictDecision } from "./stages/qa.js";
+const DEFAULT_STAGES = ["prd", "design", "code", "qa"];
+const DEFAULT_MAX_RETRIES = 1;
+/**
+ * The default writer registry — one per stage. Keeping this here
+ * (not at module-load) makes it easy to override for tests via
+ * `options.writers`.
+ */
+function defaultWriters() {
+    return {
+        prd: prdWriter,
+        design: designWriter,
+        code: codeGenerator,
+        qa: qaWriter,
+        // deploy is intentionally absent — see docstring
+        deploy: {
+            stage: "deploy",
+            writeArtifact: async () => ({
+                ok: false,
+                error: "deploy stage is not bundled with the default pipeline",
+            }),
+        },
+    };
+}
+function pickModel(model, stage) {
+    if (typeof model.query === "function") {
+        return model;
+    }
+    const map = model;
+    return map[stage] ?? null;
+}
+/**
+ * Run the full SOP pipeline. Returns a PipelineResult — never throws.
+ * Per-call closures (no module-level mutable state).
+ */
+export async function runPipeline(options) {
+    const idea = options.idea?.trim() ?? "";
+    const stages = options.stages ?? DEFAULT_STAGES;
+    const maxRetries = options.maxRetriesPerStage ?? DEFAULT_MAX_RETRIES;
+    const now = options.now ?? (() => Date.now());
+    const startedAt = now();
+    if (idea.length === 0) {
+        return {
+            outcome: "blocked",
+            artifacts: [],
+            totalDurationMs: 0,
+            retryCounts: {},
+        };
+    }
+    // Verify stage order matches the canonical sequence prefix.
+    for (let i = 0; i < stages.length; i++) {
+        if (stages[i] !== STAGE_ORDER[i]) {
+            return {
+                outcome: "blocked",
+                blockedAtStage: stages[i],
+                artifacts: [],
+                totalDurationMs: now() - startedAt,
+                retryCounts: {},
+            };
+        }
+    }
+    const writers = {
+        ...defaultWriters(),
+        ...(options.writers ?? {}),
+    };
+    // Per-call mutable accumulators (encapsulated; never module-level).
+    const artifacts = [];
+    const retryCounts = {};
+    for (const stage of stages) {
+        const writer = writers[stage];
+        const model = pickModel(options.model, stage);
+        if (!model) {
+            return {
+                outcome: "blocked",
+                blockedAtStage: stage,
+                artifacts: [...artifacts],
+                totalDurationMs: now() - startedAt,
+                retryCounts: { ...retryCounts },
+            };
+        }
+        let attempts = 0;
+        let successful = null;
+        let lastError;
+        while (attempts <= maxRetries) {
+            attempts += 1;
+            const input = {
+                idea,
+                priorArtifacts: artifacts,
+                model,
+            };
+            const result = await writer.writeArtifact(input);
+            if (!result.ok) {
+                lastError = result.error;
+                if (attempts > maxRetries)
+                    break;
+                continue;
+            }
+            // Validation pass-through — even when it fails we may retry.
+            if (result.artifact.validation.valid) {
+                successful = result.artifact;
+                break;
+            }
+            lastError = `validation failed: ${result.artifact.validation.errors.join(", ")}`;
+            // Retry budget check.
+            if (attempts > maxRetries) {
+                // Emit the failing artifact so the caller can inspect it.
+                if (options.onStageComplete)
+                    options.onStageComplete(result.artifact, attempts);
+                artifacts.push(result.artifact);
+                retryCounts[stage] = attempts - 1;
+                return {
+                    outcome: "blocked",
+                    blockedAtStage: stage,
+                    artifacts: [...artifacts],
+                    totalDurationMs: now() - startedAt,
+                    retryCounts: { ...retryCounts },
+                };
+            }
+        }
+        retryCounts[stage] = Math.max(0, attempts - 1);
+        if (!successful) {
+            // Hit retry cap on a non-ok writer result (no artifact emitted).
+            // Surface the error through retryCounts; callers compare with
+            // `outcome: "blocked"` to detect.
+            void lastError;
+            return {
+                outcome: "blocked",
+                blockedAtStage: stage,
+                artifacts: [...artifacts],
+                totalDurationMs: now() - startedAt,
+                retryCounts: { ...retryCounts },
+            };
+        }
+        if (options.onStageComplete)
+            options.onStageComplete(successful, attempts);
+        artifacts.push(successful);
+        // QA verdict gate — if QA reports FAIL we block the pipeline even
+        // when the artifact validates structurally.
+        if (stage === "qa") {
+            const decision = qaVerdictDecision(successful);
+            if (decision.kind === "block") {
+                return {
+                    outcome: "blocked",
+                    blockedAtStage: "qa",
+                    artifacts: [...artifacts],
+                    totalDurationMs: now() - startedAt,
+                    retryCounts: { ...retryCounts },
+                };
+            }
+        }
+    }
+    return {
+        outcome: "success",
+        artifacts: [...artifacts],
+        totalDurationMs: now() - startedAt,
+        retryCounts: { ...retryCounts },
+    };
+}
+/**
+ * Helper to summarize pipeline output into a one-paragraph string —
+ * useful for CLI printing.
+ */
+export function summarizePipeline(result) {
+    const lines = [];
+    lines.push(`outcome: ${result.outcome}`);
+    if (result.blockedAtStage)
+        lines.push(`blocked at: ${result.blockedAtStage}`);
+    lines.push(`artifacts: ${result.artifacts.length}`);
+    for (const a of result.artifacts) {
+        const status = a.validation.valid ? "valid" : "INVALID";
+        lines.push(`  - ${a.stage}: ${a.filename} (${status})`);
+    }
+    lines.push(`duration: ${result.totalDurationMs}ms`);
+    const retryStages = Object.keys(result.retryCounts);
+    if (retryStages.length > 0) {
+        const parts = retryStages.map((s) => `${s}=${result.retryCounts[s]}`);
+        lines.push(`retries: ${parts.join(", ")}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/sop/pipeline.js.map

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

package/dist/sop/stages/code-generator.d.ts

@@ -0,0 +1,22 @@
+/**
+ * SOP code generator — produces TypeScript source files from the design.
+ *
+ * Stage 3 of 5. Consumes PRD + design; emits a single TypeScript file
+ * containing all component stubs. (Multi-file emission would require
+ * writing to disk; we keep it stringy-pure so the test matrix stays deterministic.)
+ *
+ * Validation: the artifact must contain at least one `export` declaration
+ * AND must pass a quick syntax-shape check (no obvious unterminated braces).
+ */
+import type { SopArtifact, StageWriter } from "../types.js";
+export declare const codeGenerator: StageWriter;
+/**
+ * Extract the first ```typescript (or ```ts) fenced block.
+ */
+export declare function extractCodeBlock(text: string): string | null;
+/**
+ * Validate generated code. Strict shape check — no full parse (which would
+ * require tsc tooling inside the validator).
+ */
+export declare function validateCode(code: string | null): SopArtifact["validation"];
+//# sourceMappingURL=code-generator.d.ts.map

package/dist/sop/stages/code-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-generator.d.ts","sourceRoot":"","sources":["../../../src/sop/stages/code-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAuC,MAAM,aAAa,CAAC;AAejG,eAAO,MAAM,aAAa,EAAE,WA+C3B,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI5D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,CAAC,YAAY,CAAC,CAuB3E"}