strikethroo 3.0.2 → 3.2.0

package/dist/serve/events.js

@@ -0,0 +1,91 @@
+"use strict";
+/**
+ * Server-Sent Events change stream for `npx strikethroo serve`.
+ *
+ * Provides `GET /api/events`: a `text/event-stream` that broadcasts a single
+ * coalesced `changed` ping whenever the workspace mutates on disk. The event
+ * carries no diff payload — clients refetch the affected API data (the browser
+ * consumer is a later plan).
+ *
+ * Exposes an {@link EventsHub} that owns the connected-client set and the
+ * workspace watcher, plus an `ApiHandler` the server registers so this module
+ * stays decoupled from routing. Connections are cleaned up on disconnect so no
+ * listeners or sockets leak. Node built-ins only.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventsHub = void 0;
+const watcher_1 = require("./watcher");
+/** Keep-alive comment interval (ms) to hold idle proxies/streams open. */
+const KEEP_ALIVE_MS = 15000;
+/**
+ * Owns the SSE client set and the workspace watcher. One hub per server. Start
+ * the watcher with {@link start} after the server is listening; release it with
+ * {@link close} when the server closes.
+ */
+class EventsHub {
+    constructor(workspaceDir, debounceMs) {
+        this.workspaceDir = workspaceDir;
+        this.debounceMs = debounceMs;
+        this.clients = new Set();
+        this.watcher = null;
+        /** An {@link ApiHandler} for `GET /api/events`; returns false otherwise. */
+        this.apiHandler = (req, res, ctx) => {
+            if (ctx.pathname === '/api/events' || ctx.pathname === '/api/events/') {
+                this.handleConnection(req, res);
+                return true;
+            }
+            return false;
+        };
+    }
+    /** Begins watching the workspace; coalesced changes broadcast to all clients. */
+    start() {
+        if (this.watcher)
+            return;
+        this.watcher = (0, watcher_1.createWorkspaceWatcher)(this.workspaceDir, () => this.broadcast(), this.debounceMs);
+    }
+    /** Stops the watcher and ends every open client connection. */
+    close() {
+        if (this.watcher) {
+            this.watcher.close();
+            this.watcher = null;
+        }
+        for (const res of this.clients) {
+            res.end();
+        }
+        this.clients.clear();
+    }
+    /** Number of currently connected SSE clients (used by tests). */
+    get clientCount() {
+        return this.clients.size;
+    }
+    /** Sends a single coalesced `changed` event to every connected client. */
+    broadcast() {
+        for (const res of this.clients) {
+            res.write('event: changed\ndata: {}\n\n');
+        }
+    }
+    /** Attaches an SSE response: writes headers, registers cleanup on close. */
+    handleConnection(req, res) {
+        res.writeHead(200, {
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache',
+            Connection: 'keep-alive',
+        });
+        // Initial comment opens the stream and flushes headers to the client.
+        res.write(': connected\n\n');
+        this.clients.add(res);
+        const keepAlive = setInterval(() => {
+            res.write(': keep-alive\n\n');
+        }, KEEP_ALIVE_MS);
+        // Don't let the keep-alive timer hold the event loop / process open.
+        keepAlive.unref?.();
+        const cleanup = () => {
+            clearInterval(keepAlive);
+            this.clients.delete(res);
+        };
+        req.on('close', cleanup);
+        res.on('close', cleanup);
+    }
+}
+exports.EventsHub = EventsHub;
+//# sourceMappingURL=events.js.map

package/dist/serve/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/serve/events.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAGH,uCAAqE;AAErE,0EAA0E;AAC1E,MAAM,aAAa,GAAG,KAAK,CAAC;AAE5B;;;;GAIG;AACH,MAAa,SAAS;IAIpB,YACmB,YAAoB,EACpB,UAAmB;QADnB,iBAAY,GAAZ,YAAY,CAAQ;QACpB,eAAU,GAAV,UAAU,CAAS;QALrB,YAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;QAClD,YAAO,GAA4B,IAAI,CAAC;QAmEhD,4EAA4E;QAC5E,eAAU,GAAG,CACX,GAAyB,EACzB,GAAwB,EACxB,GAAyB,EAChB,EAAE;YACX,IAAI,GAAG,CAAC,QAAQ,KAAK,aAAa,IAAI,GAAG,CAAC,QAAQ,KAAK,cAAc,EAAE,CAAC;gBACtE,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;gBAChC,OAAO,IAAI,CAAC;YACd,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC,CAAC;IAzEC,CAAC;IAEJ,iFAAiF;IACjF,KAAK;QACH,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,CAAC,OAAO,GAAG,IAAA,gCAAsB,EACnC,IAAI,CAAC,YAAY,EACjB,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,EACtB,IAAI,CAAC,UAAU,CAChB,CAAC;IACJ,CAAC;IAED,+DAA+D;IAC/D,KAAK;QACH,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACrB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC/B,GAAG,CAAC,GAAG,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,iEAAiE;IACjE,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED,0EAA0E;IAClE,SAAS;QACf,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC/B,GAAG,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,gBAAgB,CAAC,GAAyB,EAAE,GAAwB;QAClE,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;YACjB,cAAc,EAAE,mBAAmB;YACnC,eAAe,EAAE,UAAU;YAC3B,UAAU,EAAE,YAAY;SACzB,CAAC,CAAC;QACH,sEAAsE;QACtE,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAE7B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEtB,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;YACjC,GAAG,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAChC,CAAC,EAAE,aAAa,CAAC,CAAC;QAClB,qEAAqE;QACrE,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;QAEpB,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,aAAa,CAAC,SAAS,CAAC,CAAC;YACzB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC,CAAC;QACF,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACzB,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC3B,CAAC;CAcF;AAjFD,8BAiFC"}

package/dist/serve/markdown.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Pure, dependency-light markdown parsing primitives for the serve data layer.
+ *
+ * These functions operate on already-read string content. File reading itself
+ * belongs to the task scanner and the model assembler. Everything here is
+ * synchronous, read-only, and side-effect-free: no `fs`, no network, no writes.
+ *
+ * The existing `src/skill-scripts/shared/frontmatter.ts` only recovers the
+ * numeric `id`; it is intentionally not forked. This module provides a richer
+ * frontmatter reader the UI needs (summary, created, status, group,
+ * dependencies[], skills[]).
+ */
+/**
+ * Parsed frontmatter. All fields are optional because real-world files vary and
+ * malformed/missing frontmatter must degrade gracefully rather than throw.
+ * `extra` retains any scalar keys not covered by the typed fields.
+ */
+export interface ParsedFrontmatter {
+    id?: number;
+    summary?: string;
+    created?: string;
+    status?: string;
+    group?: string;
+    dependencies: Array<number | string>;
+    skills: string[];
+    extra: Record<string, string>;
+}
+/** A named `## ` section of a markdown body. */
+export interface MarkdownSection {
+    /** Heading text (the remainder of the `## ` line, trimmed). */
+    heading: string;
+    /** Section content from just after the heading line up to the next `## ` or EOF. */
+    content: string;
+    /** Character offset of the heading start within the body. */
+    start: number;
+    /** Character offset of the section end (exclusive) within the body. */
+    end: number;
+}
+/** Result of sectioning a markdown body. */
+export interface SectionedBody {
+    /** Everything after the closing frontmatter `---`, verbatim. */
+    rawBody: string;
+    /** Ordered list of `## ` sections. */
+    sections: MarkdownSection[];
+}
+/** A single extracted mermaid fenced block. */
+export interface MermaidBlock {
+    /** Raw mermaid source (inner content of the fenced block). */
+    source: string;
+    /** True when the block falls within an "Architectural Approach" section. */
+    isArchitecturalApproach: boolean;
+}
+/**
+ * Reads the leading frontmatter block into typed fields. Never throws: malformed
+ * lines are skipped and absent keys fall back to defaults (undefined scalars,
+ * empty arrays).
+ */
+export declare const parseFrontmatter: (content: string) => ParsedFrontmatter;
+/** Returns the body: everything after the closing frontmatter `---`, or the whole content. */
+export declare const extractBody: (content: string) => string;
+/**
+ * Splits a markdown body into the verbatim `rawBody` plus an ordered list of
+ * `## ` sections addressable by heading text. Section access is additive:
+ * callers may always fall back to `rawBody`.
+ */
+export declare const sectionBody: (body: string) => SectionedBody;
+/**
+ * Extracts every fenced ```mermaid block's raw source from a body. Blocks whose
+ * position falls within an "Architectural Approach" section are flagged. Plans
+ * with no mermaid block yield an empty list (never an error).
+ */
+export declare const extractMermaidBlocks: (body: string) => MermaidBlock[];
+/** Returns the text of the first `# ` (level-1) heading in a body, or undefined. */
+export declare const extractTitle: (body: string) => string | undefined;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/serve/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/serve/markdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACrC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,gDAAgD;AAChD,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,GAAG,EAAE,MAAM,CAAC;CACb;AAED,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IAC3B,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,uBAAuB,EAAE,OAAO,CAAC;CAClC;AAwCD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,SAAS,MAAM,KAAG,iBAqFlD,CAAC;AAEF,8FAA8F;AAC9F,eAAO,MAAM,WAAW,GAAI,SAAS,MAAM,KAAG,MAI7C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,aA6B1C,CAAC;AAIF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,KAAG,YAAY,EAmB/D,CAAC;AAEF,oFAAoF;AACpF,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,MAAM,GAAG,SAGpD,CAAC"}

package/dist/serve/markdown.js

@@ -0,0 +1,221 @@
+"use strict";
+/**
+ * Pure, dependency-light markdown parsing primitives for the serve data layer.
+ *
+ * These functions operate on already-read string content. File reading itself
+ * belongs to the task scanner and the model assembler. Everything here is
+ * synchronous, read-only, and side-effect-free: no `fs`, no network, no writes.
+ *
+ * The existing `src/skill-scripts/shared/frontmatter.ts` only recovers the
+ * numeric `id`; it is intentionally not forked. This module provides a richer
+ * frontmatter reader the UI needs (summary, created, status, group,
+ * dependencies[], skills[]).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractTitle = exports.extractMermaidBlocks = exports.sectionBody = exports.extractBody = exports.parseFrontmatter = void 0;
+/** Anchors the leading `---`-delimited frontmatter block (same as frontmatter.ts). */
+const FRONTMATTER_RE = /^---\s*\r?\n([\s\S]*?)\r?\n---/;
+const stripQuotes = (value) => {
+    const trimmed = value.trim();
+    if (trimmed.length >= 2) {
+        const first = trimmed[0];
+        const last = trimmed[trimmed.length - 1];
+        if ((first === '"' && last === '"') || (first === "'" && last === "'")) {
+            return trimmed.slice(1, -1);
+        }
+    }
+    return trimmed;
+};
+/** Strips a trailing unquoted YAML comment (`# ...`). Quoted scalars are left intact. */
+const stripComment = (value) => {
+    const trimmed = value.trim();
+    if (trimmed.startsWith('"') || trimmed.startsWith("'"))
+        return trimmed;
+    const hashIndex = trimmed.indexOf('#');
+    return hashIndex === -1 ? trimmed : trimmed.slice(0, hashIndex).trim();
+};
+/** Parses a bracketed inline array like `[a, b]` or `[]` into trimmed, unquoted items. */
+const parseInlineArray = (value) => {
+    const inner = value.slice(1, -1).trim();
+    if (inner.length === 0)
+        return [];
+    return inner
+        .split(',')
+        .map(item => stripQuotes(item))
+        .filter(item => item.length > 0);
+};
+/** Coerces a dependency item to a number when it is purely numeric, else leaves it as-is. */
+const coerceDependency = (item) => {
+    if (/^-?\d+$/.test(item)) {
+        return parseInt(item, 10);
+    }
+    return item;
+};
+/**
+ * Reads the leading frontmatter block into typed fields. Never throws: malformed
+ * lines are skipped and absent keys fall back to defaults (undefined scalars,
+ * empty arrays).
+ */
+const parseFrontmatter = (content) => {
+    const result = {
+        dependencies: [],
+        skills: [],
+        extra: {},
+    };
+    const match = content.match(FRONTMATTER_RE);
+    if (!match || match[1] === undefined)
+        return result;
+    const lines = match[1].split(/\r?\n/);
+    const listFields = new Set(['dependencies', 'skills']);
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (line === undefined)
+            continue;
+        // Skip blank lines and dashed list items (they are consumed by their owning key).
+        if (line.trim().length === 0)
+            continue;
+        if (/^\s*-\s+/.test(line))
+            continue;
+        const colonIndex = line.indexOf(':');
+        if (colonIndex === -1)
+            continue;
+        const key = line.slice(0, colonIndex).trim();
+        const rawValue = line.slice(colonIndex + 1);
+        if (key.length === 0)
+            continue;
+        if (listFields.has(key)) {
+            const value = stripComment(rawValue);
+            let items;
+            if (value.startsWith('[') && value.endsWith(']')) {
+                items = parseInlineArray(value);
+            }
+            else if (value.length > 0) {
+                // A scalar on the same line that is not a bracketed array: treat as a
+                // single-item list (lenient).
+                items = [stripQuotes(value)];
+            }
+            else {
+                // Empty value: collect subsequent dashed-list items until indentation ends.
+                items = [];
+                let j = i + 1;
+                while (j < lines.length) {
+                    const next = lines[j];
+                    if (next === undefined)
+                        break;
+                    const dashMatch = next.match(/^\s*-\s+(.*)$/);
+                    if (!dashMatch || dashMatch[1] === undefined)
+                        break;
+                    items.push(stripQuotes(stripComment(dashMatch[1])));
+                    j++;
+                }
+                i = j - 1; // advance the outer cursor past the consumed items
+            }
+            if (key === 'dependencies') {
+                result.dependencies = items.map(coerceDependency);
+            }
+            else {
+                result.skills = items;
+            }
+            continue;
+        }
+        const value = stripQuotes(stripComment(rawValue));
+        switch (key) {
+            case 'id': {
+                const parsed = parseInt(value, 10);
+                if (!Number.isNaN(parsed))
+                    result.id = parsed;
+                break;
+            }
+            case 'summary':
+                result.summary = value;
+                break;
+            case 'created':
+                result.created = value;
+                break;
+            case 'status':
+                result.status = value;
+                break;
+            case 'group':
+                result.group = value;
+                break;
+            default:
+                result.extra[key] = value;
+                break;
+        }
+    }
+    return result;
+};
+exports.parseFrontmatter = parseFrontmatter;
+/** Returns the body: everything after the closing frontmatter `---`, or the whole content. */
+const extractBody = (content) => {
+    const match = content.match(FRONTMATTER_RE);
+    if (!match)
+        return content;
+    return content.slice(match.index + match[0].length).replace(/^\r?\n/, '');
+};
+exports.extractBody = extractBody;
+/**
+ * Splits a markdown body into the verbatim `rawBody` plus an ordered list of
+ * `## ` sections addressable by heading text. Section access is additive:
+ * callers may always fall back to `rawBody`.
+ */
+const sectionBody = (body) => {
+    const sections = [];
+    const headingRe = /^##[ \t]+(.+?)[ \t]*$/gm;
+    const matches = [];
+    let m;
+    while ((m = headingRe.exec(body)) !== null) {
+        const heading = (m[1] ?? '').trim();
+        matches.push({
+            heading,
+            index: m.index,
+            afterHeading: m.index + m[0].length,
+        });
+    }
+    for (let i = 0; i < matches.length; i++) {
+        const current = matches[i];
+        const next = matches[i + 1];
+        const end = next ? next.index : body.length;
+        const content = body.slice(current.afterHeading, end).replace(/^\r?\n/, '');
+        sections.push({
+            heading: current.heading,
+            content,
+            start: current.index,
+            end,
+        });
+    }
+    return { rawBody: body, sections };
+};
+exports.sectionBody = sectionBody;
+const ARCH_APPROACH_RE = /architectural\s+approach/i;
+/**
+ * Extracts every fenced ```mermaid block's raw source from a body. Blocks whose
+ * position falls within an "Architectural Approach" section are flagged. Plans
+ * with no mermaid block yield an empty list (never an error).
+ */
+const extractMermaidBlocks = (body) => {
+    const blocks = [];
+    const { sections } = (0, exports.sectionBody)(body);
+    const archSpans = sections
+        .filter(s => ARCH_APPROACH_RE.test(s.heading))
+        .map(s => ({ start: s.start, end: s.end }));
+    // Match a fence opening with ```mermaid (optional trailing whitespace) and
+    // closing with a line of three backticks.
+    const fenceRe = /^[ \t]*```mermaid[ \t]*\r?\n([\s\S]*?)\r?\n[ \t]*```[ \t]*$/gm;
+    let m;
+    while ((m = fenceRe.exec(body)) !== null) {
+        const source = m[1] ?? '';
+        const offset = m.index;
+        const isArch = archSpans.some(span => offset >= span.start && offset < span.end);
+        blocks.push({ source, isArchitecturalApproach: isArch });
+    }
+    return blocks;
+};
+exports.extractMermaidBlocks = extractMermaidBlocks;
+/** Returns the text of the first `# ` (level-1) heading in a body, or undefined. */
+const extractTitle = (body) => {
+    const match = body.match(/^#[ \t]+(.+?)[ \t]*$/m);
+    return match && match[1] !== undefined ? match[1].trim() : undefined;
+};
+exports.extractTitle = extractTitle;
+//# sourceMappingURL=markdown.js.map

package/dist/serve/markdown.js.map

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

package/dist/serve/root.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Self-contained workspace root resolver for `npx strikethroo serve`.
+ *
+ * Determines which initialized `.ai/strikethroo/` workspace the `serve` command
+ * should host. Discovery keys on the presence of
+ * `<root>/.ai/strikethroo/.init-metadata.json`, the same contract the skills use,
+ * but the logic is reimplemented here with Node built-ins only.
+ *
+ * This deliberately does NOT import `findStrikethrooRoot` from
+ * `src/skill-scripts/shared/`: that subtree carries the skill-bundle build
+ * contract (esbuild, schema-version `define`) and is excluded from the main `tsc`
+ * pipeline. Crossing that boundary would drag build-time concerns into the
+ * runtime path. The discovery walk is short and cheap to keep self-contained.
+ */
+/**
+ * Successful resolution. `root` is the absolute path of the `.ai/strikethroo`
+ * directory itself (NOT the repository root) so it can be passed directly to the
+ * workspace model's `root` argument, whose readers join `plans`/`archive`/`config`
+ * onto it.
+ */
+export interface ResolvedRoot {
+    root: string;
+}
+/** Failure result carrying a user-facing message. Never a stack trace. */
+export interface ResolveError {
+    error: string;
+}
+export type ResolveResult = ResolvedRoot | ResolveError;
+/** Narrows a {@link ResolveResult} to its error variant. */
+export declare const isResolveError: (result: ResolveResult) => result is ResolveError;
+/**
+ * Resolves the `.ai/strikethroo` workspace directory to host.
+ *
+ * - When `options.workspace` is given, it is treated as a project directory; the
+ *   resolver validates that `<workspace>/.ai/strikethroo/.init-metadata.json`
+ *   exists and returns that `.ai/strikethroo` directory.
+ * - Otherwise it walks upward from `options.cwd` (default `process.cwd()`),
+ *   testing each ancestor for `.ai/strikethroo/.init-metadata.json`.
+ *
+ * On failure it returns an `{ error }` shape with a clear, user-facing message
+ * so the command layer can print it and exit non-zero. It never throws an
+ * unhandled error for the "not found" case.
+ */
+export declare const resolveWorkspaceRoot: (options?: {
+    workspace?: string;
+    cwd?: string;
+}) => ResolveResult;
+//# sourceMappingURL=root.d.ts.map

package/dist/serve/root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root.d.ts","sourceRoot":"","sources":["../../src/serve/root.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,0EAA0E;AAC1E,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,YAAY,CAAC;AAExD,4DAA4D;AAC5D,eAAO,MAAM,cAAc,GAAI,QAAQ,aAAa,KAAG,MAAM,IAAI,YACnB,CAAC;AAe/C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,oBAAoB,GAC/B,UAAS;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,KACjD,aA6BF,CAAC"}

package/dist/serve/root.js

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * Self-contained workspace root resolver for `npx strikethroo serve`.
+ *
+ * Determines which initialized `.ai/strikethroo/` workspace the `serve` command
+ * should host. Discovery keys on the presence of
+ * `<root>/.ai/strikethroo/.init-metadata.json`, the same contract the skills use,
+ * but the logic is reimplemented here with Node built-ins only.
+ *
+ * This deliberately does NOT import `findStrikethrooRoot` from
+ * `src/skill-scripts/shared/`: that subtree carries the skill-bundle build
+ * contract (esbuild, schema-version `define`) and is excluded from the main `tsc`
+ * pipeline. Crossing that boundary would drag build-time concerns into the
+ * runtime path. The discovery walk is short and cheap to keep self-contained.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveWorkspaceRoot = exports.isResolveError = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/** Narrows a {@link ResolveResult} to its error variant. */
+const isResolveError = (result) => result.error !== undefined;
+exports.isResolveError = isResolveError;
+const INIT_MESSAGE = 'Run `npx strikethroo init` first.';
+/** True when `<dir>/.init-metadata.json` exists and `<dir>` is a directory. */
+const isInitializedStrikethrooDir = (strikethrooDir) => {
+    try {
+        if (!fs.statSync(strikethrooDir).isDirectory())
+            return false;
+        const metadataPath = path.join(strikethrooDir, '.init-metadata.json');
+        return fs.statSync(metadataPath).isFile();
+    }
+    catch {
+        return false;
+    }
+};
+/**
+ * Resolves the `.ai/strikethroo` workspace directory to host.
+ *
+ * - When `options.workspace` is given, it is treated as a project directory; the
+ *   resolver validates that `<workspace>/.ai/strikethroo/.init-metadata.json`
+ *   exists and returns that `.ai/strikethroo` directory.
+ * - Otherwise it walks upward from `options.cwd` (default `process.cwd()`),
+ *   testing each ancestor for `.ai/strikethroo/.init-metadata.json`.
+ *
+ * On failure it returns an `{ error }` shape with a clear, user-facing message
+ * so the command layer can print it and exit non-zero. It never throws an
+ * unhandled error for the "not found" case.
+ */
+const resolveWorkspaceRoot = (options = {}) => {
+    if (options.workspace) {
+        const projectDir = path.resolve(options.workspace);
+        const strikethrooDir = path.join(projectDir, '.ai', 'strikethroo');
+        if (isInitializedStrikethrooDir(strikethrooDir)) {
+            return { root: strikethrooDir };
+        }
+        return {
+            error: `Path ${projectDir} is not an initialized strikethroo workspace. ${INIT_MESSAGE}`,
+        };
+    }
+    let current = path.resolve(options.cwd ?? process.cwd());
+    // Walk upward until the filesystem root, where dirname(current) === current.
+    for (;;) {
+        const strikethrooDir = path.join(current, '.ai', 'strikethroo');
+        if (isInitializedStrikethrooDir(strikethrooDir)) {
+            return { root: strikethrooDir };
+        }
+        const parent = path.dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    return {
+        error: `No initialized strikethroo workspace found from ${path.resolve(options.cwd ?? process.cwd())} upward. ${INIT_MESSAGE}`,
+    };
+};
+exports.resolveWorkspaceRoot = resolveWorkspaceRoot;
+//# sourceMappingURL=root.js.map

package/dist/serve/root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"root.js","sourceRoot":"","sources":["../../src/serve/root.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,uCAAyB;AACzB,2CAA6B;AAmB7B,4DAA4D;AACrD,MAAM,cAAc,GAAG,CAAC,MAAqB,EAA0B,EAAE,CAC7E,MAAuB,CAAC,KAAK,KAAK,SAAS,CAAC;AADlC,QAAA,cAAc,kBACoB;AAE/C,MAAM,YAAY,GAAG,mCAAmC,CAAC;AAEzD,+EAA+E;AAC/E,MAAM,2BAA2B,GAAG,CAAC,cAAsB,EAAW,EAAE;IACtE,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,WAAW,EAAE;YAAE,OAAO,KAAK,CAAC;QAC7D,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,qBAAqB,CAAC,CAAC;QACtE,OAAO,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACI,MAAM,oBAAoB,GAAG,CAClC,UAAgD,EAAE,EACnC,EAAE;IACjB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACnD,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;QACnE,IAAI,2BAA2B,CAAC,cAAc,CAAC,EAAE,CAAC;YAChD,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;QAClC,CAAC;QACD,OAAO;YACL,KAAK,EAAE,QAAQ,UAAU,iDAAiD,YAAY,EAAE;SACzF,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACzD,6EAA6E;IAC7E,SAAS,CAAC;QACR,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;QAChE,IAAI,2BAA2B,CAAC,cAAc,CAAC,EAAE,CAAC;YAChD,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;QAClC,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,OAAO;YAAE,MAAM;QAC9B,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;IAED,OAAO;QACL,KAAK,EAAE,mDAAmD,IAAI,CAAC,OAAO,CACpE,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAC7B,YAAY,YAAY,EAAE;KAC5B,CAAC;AACJ,CAAC,CAAC;AA/BW,QAAA,oBAAoB,wBA+B/B"}

package/dist/serve/self-review.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Self-review launch capability for `npx strikethroo serve`.
+ *
+ * The serve API is otherwise read-only. This module adds the single, narrowly
+ * scoped exception the SPA's "Launch self-review" button needs:
+ *
+ *   - {@link isSelfReviewAvailable} — a PATH scan answering "is the `self-review`
+ *     binary installed?", exposed to the SPA via `GET /api/capabilities` so the
+ *     button only renders when launching can actually succeed;
+ *   - {@link launchSelfReview} — validates a client-supplied plan path stays
+ *     inside the workspace's `plans/` or `archive/` subtree, then spawns the
+ *     binary detached (fire-and-forget, like the browser auto-open).
+ *
+ * Untrusted input (the path string) is never passed to the shell: `spawn` is
+ * invoked with an argv array, and the path is rejected before spawning unless it
+ * resolves to an existing file under `plans/` or `archive/`. Node built-ins only.
+ */
+/** The binary name looked up on PATH and spawned. */
+export declare const SELF_REVIEW_BINARY = "self-review";
+/** Where to obtain self-review; surfaced by the SPA when it is not installed. */
+export declare const SELF_REVIEW_URL = "https://github.com/e0ipso/self-review";
+/**
+ * Returns `true` when the `self-review` binary is found on the process `PATH`.
+ *
+ * A presence check, matching the literal "binary is in path" contract: each
+ * `PATH` entry is probed for a regular file named `self-review` (plus the
+ * `PATHEXT` variants on Windows). It deliberately does not execute the binary,
+ * so it cannot hang and has no side effects.
+ */
+export declare const isSelfReviewAvailable: (env?: Record<string, string | undefined>) => boolean;
+/** Outcome of resolving and launching a self-review request. */
+export interface LaunchResult {
+    /** HTTP status the endpoint should send. */
+    status: number;
+    /** JSON body the endpoint should send. */
+    body: {
+        ok: true;
+    } | {
+        ok: false;
+        error: string;
+    };
+}
+/** Seams for testing: availability probe and the detached spawn. */
+export interface LaunchDeps {
+    available?: () => boolean;
+    spawnDetached?: (command: string, args: string[]) => void;
+}
+/**
+ * Resolves a client-supplied plan path to an absolute path, requiring it to be
+ * an existing file inside `<root>/plans` or `<root>/archive`. Returns the
+ * absolute path on success or a user-facing error otherwise.
+ *
+ * `root` is the absolute `.ai/strikethroo` directory; client paths are the
+ * workspace-relative form the SPA shows (e.g. `.ai/strikethroo/plans/NN--s/…`),
+ * so they are resolved against the project root (`root/../..`). Absolute client
+ * paths are accepted too — the containment check is what enforces safety.
+ */
+export declare const resolveReviewPath: (root: string, clientPath: string) => {
+    absPath: string;
+} | {
+    error: string;
+    status: number;
+};
+/**
+ * Validates `clientPath` and, if the binary is available, launches
+ * `self-review <absolutePath>` detached. Pure of HTTP concerns: returns the
+ * status/body the endpoint should send so it stays unit-testable.
+ */
+export declare const launchSelfReview: (root: string, clientPath: string, deps?: LaunchDeps) => LaunchResult;
+//# sourceMappingURL=self-review.d.ts.map

package/dist/serve/self-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-review.d.ts","sourceRoot":"","sources":["../../src/serve/self-review.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,qDAAqD;AACrD,eAAO,MAAM,kBAAkB,gBAAgB,CAAC;AAEhD,iFAAiF;AACjF,eAAO,MAAM,eAAe,0CAA0C,CAAC;AAEvE;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAChC,MAAK,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,KACpD,OAoBF,CAAC;AAEF,gEAAgE;AAChE,MAAM,WAAW,YAAY;IAC3B,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,IAAI,EAAE;QAAE,EAAE,EAAE,IAAI,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACnD;AAED,oEAAoE;AACpE,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CAC3D;AAWD;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,EACZ,YAAY,MAAM,KACjB;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CA4BvD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAC3B,MAAM,MAAM,EACZ,YAAY,MAAM,EAClB,OAAM,UAAe,KACpB,YAwBF,CAAC"}