@nac3/forge-cli 0.2.0-alpha.9 → 1.0.0

package/dist/pending/store.js

@@ -0,0 +1,293 @@
+/**
+ * Yujin Forge -- pending_registry store.
+ *
+ * One JSON file per project at
+ *   ~/.yujin-forge/projects/<project_slug>/pending.json
+ *
+ * Reads are cached in-memory per process for ~5s to avoid disk
+ * thrashing when buildSystemPrompt is invoked multiple times per
+ * turn. Writes are atomic (write to tempfile + rename) so a crashing
+ * process never leaves the registry corrupt.
+ *
+ * Concurrency model: each `~/.yujin-forge/projects/<slug>/` is owned
+ * by exactly one `yf` invocation at a time. We rely on filesystem
+ * rename atomicity rather than a lock file; the only readers are
+ * `yf chat` and the post-commit hook, and they do not overlap in
+ * practice. If they did, the worst case is the last writer wins
+ * with no torn writes (since rename is atomic on local filesystems).
+ *
+ * ASCII-only.
+ */
+import { promises as fs } from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { emptyPendingFile, formatPendingId, parsePendingId, } from './types.js';
+const FILE_NAME = 'pending.json';
+/** Resolve the directory that holds per-project Yujin Forge state.
+ *  Honours XDG_CONFIG_HOME on Linux when present; everywhere else
+ *  falls back to `~/.yujin-forge`. */
+function configRoot() {
+    if (process.env['YUJIN_FORGE_HOME'])
+        return process.env['YUJIN_FORGE_HOME'];
+    const xdg = process.env['XDG_CONFIG_HOME'];
+    if (xdg && process.platform === 'linux')
+        return path.join(xdg, 'yujin-forge');
+    return path.join(os.homedir(), '.yujin-forge');
+}
+/** Resolve the per-project directory. Caller is responsible for the
+ *  slug being filesystem-safe (no `..`, no path separators). */
+function projectDir(project_slug) {
+    if (!project_slug || project_slug.includes('..') || /[/\\]/.test(project_slug)) {
+        throw new Error('pending: invalid project_slug ' + JSON.stringify(project_slug));
+    }
+    return path.join(configRoot(), 'projects', project_slug);
+}
+function fileFor(project_slug) {
+    return path.join(projectDir(project_slug), FILE_NAME);
+}
+/** Read the pending file for a project. Returns an empty file when
+ *  none exists; never throws ENOENT. Other I/O errors propagate. */
+export async function readPending(project_slug) {
+    const f = fileFor(project_slug);
+    try {
+        const raw = await fs.readFile(f, 'utf-8');
+        const parsed = JSON.parse(raw);
+        /* Defensive: if the file got hand-edited and lost its envelope,
+         * coerce it back to a valid shape rather than crashing. */
+        if (!parsed || typeof parsed !== 'object' || parsed.version !== 1
+            || !Array.isArray(parsed.items)) {
+            return emptyPendingFile(project_slug);
+        }
+        if (typeof parsed.next_id !== 'number' || parsed.next_id < 1) {
+            parsed.next_id = computeNextId(parsed.items);
+        }
+        if (parsed.project_slug !== project_slug) {
+            parsed.project_slug = project_slug;
+        }
+        return parsed;
+    }
+    catch (err) {
+        if (err instanceof Error && 'code' in err && err.code === 'ENOENT') {
+            return emptyPendingFile(project_slug);
+        }
+        throw err;
+    }
+}
+/** Compute the next available numeric ID from an item array.
+ *  Used as a fallback when next_id was missing or corrupted. */
+function computeNextId(items) {
+    let max = 0;
+    for (const it of items) {
+        const n = parsePendingId(it.id);
+        if (n !== null && n > max)
+            max = n;
+    }
+    return max + 1;
+}
+/** Persist the pending file. Atomic: writes to <file>.tmp then renames. */
+export async function writePending(file) {
+    if (file.version !== 1)
+        throw new Error('writePending: unsupported version ' + file.version);
+    const dir = projectDir(file.project_slug);
+    await fs.mkdir(dir, { recursive: true });
+    const target = path.join(dir, FILE_NAME);
+    const tmp = target + '.tmp';
+    const json = JSON.stringify(file, null, 2);
+    await fs.writeFile(tmp, json, { encoding: 'utf-8', mode: 0o600 });
+    await fs.rename(tmp, target);
+}
+export async function addPending(project_slug, input) {
+    if (!input.title || !input.title.trim()) {
+        throw new Error('addPending: title is required');
+    }
+    const validCats = ['user_blocked', 'autopilot', 'clarify', 'bug', 'infra'];
+    if (!validCats.includes(input.category)) {
+        throw new Error('addPending: invalid category ' + input.category);
+    }
+    const file = await readPending(project_slug);
+    const now = Date.now();
+    const item = {
+        id: formatPendingId(file.next_id),
+        title: input.title.trim(),
+        category: input.category,
+        priority: clampPriority(input.priority ?? 50),
+        created_at: now,
+        updated_at: now,
+    };
+    if (input.body && input.body.trim())
+        item.body = input.body;
+    if (input.blocker_kind)
+        item.blocker_kind = input.blocker_kind;
+    if (input.blocker_who && input.blocker_who.trim())
+        item.blocker_who = input.blocker_who.trim();
+    if (input.related_doc && input.related_doc.trim())
+        item.related_doc = input.related_doc.trim();
+    if (input.workflow)
+        item.workflow = input.workflow;
+    file.items.push(item);
+    file.next_id = file.next_id + 1;
+    await writePending(file);
+    return item;
+}
+function clampPriority(n) {
+    if (!Number.isFinite(n))
+        return 50;
+    return Math.max(0, Math.min(100, Math.floor(n)));
+}
+export async function listPending(project_slug, filter = {}) {
+    const file = await readPending(project_slug);
+    let out = file.items.slice();
+    const status = filter.status ?? 'open';
+    if (status === 'open')
+        out = out.filter((i) => i.closed_at === undefined);
+    if (status === 'closed')
+        out = out.filter((i) => i.closed_at !== undefined);
+    if (filter.category)
+        out = out.filter((i) => i.category === filter.category);
+    if (filter.blocker_who)
+        out = out.filter((i) => i.blocker_who === filter.blocker_who);
+    /* Stable sort: priority asc (lower = more critical), then created_at asc. */
+    out.sort((a, b) => (a.priority - b.priority) || (a.created_at - b.created_at));
+    return out.map((i) => ({ ...i }));
+}
+/** Find one item by id. Returns undefined when not present. */
+export async function findPending(project_slug, id) {
+    const file = await readPending(project_slug);
+    const it = file.items.find((i) => i.id === id);
+    return it ? { ...it } : undefined;
+}
+/** Append-only: agrega una entrada al history del item (una
+ *  iteracion de la gestion / ciclo evolutivo-correctivo). No exige
+ *  que el item este abierto. */
+export async function appendPendingHistory(project_slug, id, entry) {
+    const file = await readPending(project_slug);
+    const it = file.items.find((i) => i.id === id);
+    if (!it)
+        throw new Error('appendPendingHistory: not found ' + id);
+    if (!Array.isArray(it.history))
+        it.history = [];
+    it.history.push({ at: Date.now(), note: entry.note, kind: entry.kind });
+    it.updated_at = Date.now();
+    await writePending(file);
+    return { ...it };
+}
+/** PND-094 ext -- attach/detach an EXISTING pending to a workflow
+ *  instance (set its `workflow` link). Used to fold a backlog of real
+ *  pendings into a brownfield workflow without recreating them. Pass
+ *  null to detach. */
+export async function setPendingWorkflow(project_slug, id, link) {
+    const file = await readPending(project_slug);
+    const it = file.items.find((i) => i.id === id);
+    if (!it)
+        throw new Error('setPendingWorkflow: not found ' + id);
+    if (link)
+        it.workflow = link;
+    else
+        delete it.workflow;
+    it.updated_at = Date.now();
+    await writePending(file);
+    return { ...it };
+}
+export async function closePending(project_slug, id, input) {
+    const file = await readPending(project_slug);
+    const idx = file.items.findIndex((i) => i.id === id);
+    if (idx < 0)
+        throw new Error('closePending: not found ' + id);
+    const it = file.items[idx];
+    if (!it)
+        throw new Error('closePending: not found ' + id);
+    if (it.closed_at !== undefined)
+        throw new Error('closePending: already closed ' + id);
+    const validReasons = ['shipped', 'obsoleted', 'duplicate', 'rejected'];
+    if (!validReasons.includes(input.reason)) {
+        throw new Error('closePending: invalid reason ' + input.reason);
+    }
+    it.closed_at = Date.now();
+    it.closed_reason = input.reason;
+    if (input.commit && input.commit.trim())
+        it.closed_by_commit = input.commit.trim();
+    /* Guardar el history de cierre (como se resolvio). */
+    if (input.resolution && input.resolution.trim()) {
+        if (!Array.isArray(it.history))
+            it.history = [];
+        it.history.push({ at: it.closed_at, note: input.resolution.trim(), kind: 'resolution' });
+    }
+    it.updated_at = it.closed_at;
+    await writePending(file);
+    return { ...it };
+}
+export async function editPending(project_slug, id, input) {
+    const file = await readPending(project_slug);
+    const idx = file.items.findIndex((i) => i.id === id);
+    if (idx < 0)
+        throw new Error('editPending: not found ' + id);
+    const it = file.items[idx];
+    if (!it)
+        throw new Error('editPending: not found ' + id);
+    if (input.title !== undefined)
+        it.title = input.title.trim();
+    if (input.body !== undefined)
+        it.body = input.body;
+    if (input.category !== undefined) {
+        const validCats = ['user_blocked', 'autopilot', 'clarify', 'bug', 'infra'];
+        if (!validCats.includes(input.category)) {
+            throw new Error('editPending: invalid category ' + input.category);
+        }
+        it.category = input.category;
+    }
+    if (input.blocker_kind !== undefined)
+        it.blocker_kind = input.blocker_kind;
+    if (input.blocker_who !== undefined)
+        it.blocker_who = input.blocker_who.trim() || undefined;
+    if (input.priority !== undefined)
+        it.priority = clampPriority(input.priority);
+    if (input.related_doc !== undefined)
+        it.related_doc = input.related_doc.trim() || undefined;
+    it.updated_at = Date.now();
+    await writePending(file);
+    return { ...it };
+}
+export async function statsPending(project_slug) {
+    const file = await readPending(project_slug);
+    const stats = {
+        total_open: 0,
+        total_closed: 0,
+        by_category: { user_blocked: 0, autopilot: 0, clarify: 0, bug: 0, infra: 0 },
+    };
+    let oldest;
+    for (const it of file.items) {
+        if (it.closed_at !== undefined) {
+            stats.total_closed += 1;
+            continue;
+        }
+        stats.total_open += 1;
+        stats.by_category[it.category] += 1;
+        if (!oldest || it.created_at < oldest.created_at)
+            oldest = it;
+    }
+    if (oldest)
+        stats.oldest_open = { ...oldest };
+    return stats;
+}
+/** Used by the post-commit hook + `yf pending close` CLI. Parses
+ *  `closes PND-014 PND-022` (case-insensitive) and returns the IDs.
+ *  Conservative: only matches uppercase PND or lowercase pnd
+ *  preceded by a non-word boundary to avoid matching `PND-014` inside
+ *  another token. */
+export function parseCloseDirectives(commit_msg) {
+    const out = new Set();
+    const re = /\bclos(?:e|es|ed|ing)\s+(PND-\d+(?:\s+PND-\d+)*)\b/gi;
+    let m;
+    while ((m = re.exec(commit_msg)) !== null) {
+        const list = m[1];
+        if (!list)
+            continue;
+        for (const id of list.split(/\s+/)) {
+            const normalised = id.toUpperCase();
+            if (parsePendingId(normalised) !== null)
+                out.add(normalised);
+        }
+    }
+    return Array.from(out);
+}
+//# sourceMappingURL=store.js.map

package/dist/pending/store.js.map

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

package/dist/pending/types.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Yujin Forge -- pending_registry types.
+ *
+ * The pending_registry is a per-project local store of open items
+ * (user-blocked decisions, autopilot-doable tasks, clarify-before-code
+ * design questions, bugs, infra deps). It exists to solve the
+ * "Sumi-after-compaction" problem: a fresh session that does NOT have
+ * the full chat history can still know what is actually pending,
+ * because the registry is injected into every system prompt as a
+ * compact section (similar to snapshotSection + globalLearnings).
+ *
+ * Design decisions (Pablo + Sumi, 2026-06-06):
+ *
+ *  - Storage: **local-only** per project. No worker / D1. This
+ *    aligns with BYOK: the user's pending items never leave their
+ *    machine. (semantic_graph migrates to local in N6 for the same
+ *    reason.)
+ *  - Format: **JSON file** at
+ *    `~/.yujin-forge/projects/<slug>/pending.json` with atomic
+ *    writes (write to tempfile + rename). At <100 items per
+ *    project the latency is irrelevant; the simplicity wins.
+ *  - ID scheme: `PND-NNN` numerically increasing, zero-padded to
+ *    3 digits. Never reused. `closes PND-014` in commit messages
+ *    auto-closes the item via lefthook post-commit hook.
+ *  - Categories are CHECKed at write time: only one of the five
+ *    allowed values goes in (typo-safe).
+ *
+ * ASCII-only.
+ */
+/** Allowed categories for a pending item. */
+export type PendingCategory = 'user_blocked' | 'autopilot' | 'clarify' | 'bug' | 'infra';
+/** Allowed close reasons. */
+export type PendingCloseReason = 'shipped' | 'obsoleted' | 'duplicate' | 'rejected';
+/** Optional blocker kind for category=user_blocked items. Helps the
+ *  prompt grouping pick the right verb ("Pablo decision" vs "external
+ *  account access" vs "service signup"). */
+export type PendingBlockerKind = 'user_decision' | 'user_credential' | 'external_dep' | 'session_required';
+/** One row of the local pending_registry. */
+export interface PendingItem {
+    /** Stable identifier, e.g. "PND-014". Never reused. */
+    id: string;
+    /** Short title, one sentence. */
+    title: string;
+    /** Body in markdown. Optional (title-only items are valid). */
+    body?: string;
+    /** Category (CHECKed at write time). */
+    category: PendingCategory;
+    /** Optional blocker kind when category=user_blocked. */
+    blocker_kind?: PendingBlockerKind;
+    /** Free-text who/what is the blocker, e.g. "pablo", "cf_account",
+     *  "polar". Useful for `yf pending list --blocker pablo`. */
+    blocker_who?: string;
+    /** 0..100 priority (0 = critical, 100 = nice-to-have).
+     *  Default 50 when omitted. */
+    priority: number;
+    /** Epoch millis of creation. */
+    created_at: number;
+    /** Epoch millis of last edit. */
+    updated_at: number;
+    /** Epoch millis of close. NULL when still open. */
+    closed_at?: number;
+    /** Close reason (only set when closed_at is set). */
+    closed_reason?: PendingCloseReason;
+    /** Git commit SHA that closed this (only set when closed_at is set
+     *  and the close came from a `closes PND-X` commit message). */
+    closed_by_commit?: string;
+    /** Optional pointer to the doc that originated the item, e.g.
+     *  "docs/F101_MCP_BRIDGE.md". Used by the prompt section to help
+     *  the model fetch context on demand. */
+    related_doc?: string;
+    /** Lifecycle history (dogfood 2026-06-10) -- el registro de la
+     *  gestion del item: cada iteracion del ciclo evolutivo/correctivo
+     *  deja una entrada aca. La de cierre (kind='resolution') resume
+     *  como se resolvio. Append-only. */
+    history?: PendingHistoryEntry[];
+    /** PND-094 ext -- set when this item is a TASK of a workflow
+     *  instance. Stages are NOT pendings; tasks are. An item with a
+     *  `workflow` block is a "WFL" item. Ad-hoc corrective/evolutive
+     *  tasks added during a workflow's development phase also carry this
+     *  (with `ad_hoc: true`). */
+    workflow?: PendingWorkflowLink;
+}
+/** Links a pending (task) to its workflow instance + stage + order. */
+export interface PendingWorkflowLink {
+    /** Workflow instance code, e.g. "WFL-001". */
+    code: string;
+    /** Workflow kind (denormalised for cheap filtering). */
+    kind: 'greenfield' | 'corrective' | 'evolutive';
+    /** Stage this task belongs to (stages are not pendings). */
+    stage_id: string;
+    /** Mandatory ordering within the instance (lower runs first). */
+    order: number;
+    /** True for a task the user added at discretion mid-workflow
+     *  (not part of the instantiated canonical skeleton). */
+    ad_hoc?: boolean;
+}
+/** Una entrada del history del item (gestion + ciclo iterativo). */
+export interface PendingHistoryEntry {
+    /** Epoch millis. */
+    at: number;
+    /** Que paso en esta iteracion. */
+    note: string;
+    /** Tipo de iteracion. progress = avance; evolutive = mejora;
+     *  corrective = arreglo; resolution = cierre. */
+    kind: 'progress' | 'evolutive' | 'corrective' | 'resolution';
+}
+/** Full on-disk shape. The version field lets future migrations
+ *  understand the file without parsing every row. */
+export interface PendingFile {
+    /** Schema version. Bump when the shape of PendingItem changes
+     *  in a breaking way. */
+    version: 1;
+    /** The project this file belongs to, mirroring the directory it
+     *  lives in. Defensive (catches misplaced files). */
+    project_slug: string;
+    /** Monotonic counter for next ID. Items themselves carry the
+     *  formatted ID; this is the "next int" generator. */
+    next_id: number;
+    /** All items, open + closed. Closed items stay so the audit trail
+     *  survives. */
+    items: PendingItem[];
+}
+/** Default factory for a fresh file. */
+export declare function emptyPendingFile(project_slug: string): PendingFile;
+/** Format a numeric id as "PND-NNN". */
+export declare function formatPendingId(n: number): string;
+/** Parse "PND-014" -> 14. Returns null on malformed. */
+export declare function parsePendingId(id: string): number | null;
+/** Compile-time exhaustiveness helper for category switches. */
+export declare function assertNeverCategory(c: never): never;
+//# sourceMappingURL=types.d.ts.map

package/dist/pending/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/pending/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,6CAA6C;AAC7C,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,WAAW,GACX,SAAS,GACT,KAAK,GACL,OAAO,CAAC;AAEZ,6BAA6B;AAC7B,MAAM,MAAM,kBAAkB,GAC1B,SAAS,GACT,WAAW,GACX,WAAW,GACX,UAAU,CAAC;AAEf;;4CAE4C;AAC5C,MAAM,MAAM,kBAAkB,GAC1B,eAAe,GACf,iBAAiB,GACjB,cAAc,GACd,kBAAkB,CAAC;AAEvB,6CAA6C;AAC7C,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,QAAQ,EAAE,eAAe,CAAC;IAC1B,wDAAwD;IACxD,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC;iEAC6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;mCAC+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC;oEACgE;IAChE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;6CAEyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;yCAGqC;IACrC,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAChC;;;;iCAI6B;IAC7B,QAAQ,CAAC,EAAE,mBAAmB,CAAC;CAChC;AAED,uEAAuE;AACvE,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,IAAI,EAAE,YAAY,GAAG,YAAY,GAAG,WAAW,CAAC;IAChD,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd;6DACyD;IACzD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,oEAAoE;AACpE,MAAM,WAAW,mBAAmB;IAClC,oBAAoB;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb;qDACiD;IACjD,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,YAAY,GAAG,YAAY,CAAC;CAC9D;AAED;qDACqD;AACrD,MAAM,WAAW,WAAW;IAC1B;6BACyB;IACzB,OAAO,EAAE,CAAC,CAAC;IACX;yDACqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB;0DACsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB;oBACgB;IAChB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,wCAAwC;AACxC,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,WAAW,CAOlE;AAED,wCAAwC;AACxC,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED,wDAAwD;AACxD,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMxD;AAED,gEAAgE;AAChE,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,KAAK,GAAG,KAAK,CAEnD"}

package/dist/pending/types.js

@@ -0,0 +1,60 @@
+/**
+ * Yujin Forge -- pending_registry types.
+ *
+ * The pending_registry is a per-project local store of open items
+ * (user-blocked decisions, autopilot-doable tasks, clarify-before-code
+ * design questions, bugs, infra deps). It exists to solve the
+ * "Sumi-after-compaction" problem: a fresh session that does NOT have
+ * the full chat history can still know what is actually pending,
+ * because the registry is injected into every system prompt as a
+ * compact section (similar to snapshotSection + globalLearnings).
+ *
+ * Design decisions (Pablo + Sumi, 2026-06-06):
+ *
+ *  - Storage: **local-only** per project. No worker / D1. This
+ *    aligns with BYOK: the user's pending items never leave their
+ *    machine. (semantic_graph migrates to local in N6 for the same
+ *    reason.)
+ *  - Format: **JSON file** at
+ *    `~/.yujin-forge/projects/<slug>/pending.json` with atomic
+ *    writes (write to tempfile + rename). At <100 items per
+ *    project the latency is irrelevant; the simplicity wins.
+ *  - ID scheme: `PND-NNN` numerically increasing, zero-padded to
+ *    3 digits. Never reused. `closes PND-014` in commit messages
+ *    auto-closes the item via lefthook post-commit hook.
+ *  - Categories are CHECKed at write time: only one of the five
+ *    allowed values goes in (typo-safe).
+ *
+ * ASCII-only.
+ */
+/** Default factory for a fresh file. */
+export function emptyPendingFile(project_slug) {
+    return {
+        version: 1,
+        project_slug,
+        next_id: 1,
+        items: [],
+    };
+}
+/** Format a numeric id as "PND-NNN". */
+export function formatPendingId(n) {
+    if (n < 1 || !Number.isFinite(n) || Math.floor(n) !== n) {
+        throw new Error('formatPendingId: expected a positive integer, got ' + n);
+    }
+    return 'PND-' + String(n).padStart(3, '0');
+}
+/** Parse "PND-014" -> 14. Returns null on malformed. */
+export function parsePendingId(id) {
+    const m = /^PND-(\d+)$/.exec(id);
+    if (!m)
+        return null;
+    const n = Number(m[1]);
+    if (!Number.isFinite(n) || n < 1)
+        return null;
+    return n;
+}
+/** Compile-time exhaustiveness helper for category switches. */
+export function assertNeverCategory(c) {
+    throw new Error('unhandled PendingCategory: ' + JSON.stringify(c));
+}
+//# sourceMappingURL=types.js.map

package/dist/pending/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/pending/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAmHH,wCAAwC;AACxC,MAAM,UAAU,gBAAgB,CAAC,YAAoB;IACnD,OAAO;QACL,OAAO,EAAO,CAAC;QACf,YAAY;QACZ,OAAO,EAAO,CAAC;QACf,KAAK,EAAS,EAAE;KACjB,CAAC;AACJ,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,eAAe,CAAC,CAAS;IACvC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,oDAAoD,GAAG,CAAC,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC7C,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,MAAM,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,OAAO,CAAC,CAAC;AACX,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,mBAAmB,CAAC,CAAQ;IAC1C,MAAM,IAAI,KAAK,CAAC,6BAA6B,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AACrE,CAAC"}

package/dist/qa/brain_matrix/ab_runner.d.ts

@@ -0,0 +1,44 @@
+import type { Scenario, BrainConfig, ScenarioReport } from './types.js';
+import type { FakeResponse } from './fake_brain.js';
+export interface ABResult {
+    scenario_id: string;
+    brain_id: string;
+    a: ScenarioReport;
+    b: ScenarioReport;
+    /** Invariant pass count diff: b - a. Negative = regression. */
+    invariants_delta: number;
+    /** Token spend ratio: b / a. >1.25 considered too expensive. */
+    token_ratio: number;
+    /** True iff B is at least as good as A by all measures. */
+    promote_ok: boolean;
+    /** Human-readable reason (one short line). */
+    verdict: string;
+}
+interface ABScenarioExtension {
+    ab_test?: {
+        /** Override scenario.fake_responses for the A side. */
+        mode_a_responses?: FakeResponse[];
+        /** Override scenario.fake_responses for the B side. */
+        mode_b_responses?: FakeResponse[];
+        /** Optional: extra invariants only checked in mode B (e.g.
+         *  "must call doctrine.discover before reasoning"). */
+        extra_invariants_b?: Scenario['invariants'];
+        /** Override the default token ratio cap (1.25). Use for
+         *  "worst-case discovery" scenarios where B is expected to
+         *  spend 2-3x in tokens but the population average is still
+         *  a win because most turns do not trigger discovery. The
+         *  promotion decision aggregates across all scenarios. */
+        token_ratio_cap?: number;
+    };
+}
+export declare function runAB(scenario: Scenario & ABScenarioExtension, brain: BrainConfig): Promise<ABResult | null>;
+export interface ABMatrixResult {
+    generated_at: string;
+    results: ABResult[];
+    /** True iff every cell promote_ok=true. Gates promotion. */
+    promote_ok: boolean;
+}
+export declare function runABMatrix(scenarios: Array<Scenario & ABScenarioExtension>, brains: BrainConfig[]): Promise<ABMatrixResult>;
+export declare function renderABReport(matrix: ABMatrixResult): string;
+export {};
+//# sourceMappingURL=ab_runner.d.ts.map

package/dist/qa/brain_matrix/ab_runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ab_runner.d.ts","sourceRoot":"","sources":["../../../src/qa/brain_matrix/ab_runner.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EACV,QAAQ,EAAE,WAAW,EAAE,cAAc,EACtC,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,CAAC,EAAE,cAAc,CAAC;IAClB,CAAC,EAAE,cAAc,CAAC;IAClB,+DAA+D;IAC/D,gBAAgB,EAAE,MAAM,CAAC;IACzB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,UAAU,EAAE,OAAO,CAAC;IACpB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,mBAAmB;IAC3B,OAAO,CAAC,EAAE;QACR,uDAAuD;QACvD,gBAAgB,CAAC,EAAE,YAAY,EAAE,CAAC;QAClC,uDAAuD;QACvD,gBAAgB,CAAC,EAAE,YAAY,EAAE,CAAC;QAClC;+DACuD;QACvD,kBAAkB,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;QAC5C;;;;kEAI0D;QAC1D,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAQD,wBAAsB,KAAK,CACzB,QAAQ,EAAE,QAAQ,GAAG,mBAAmB,EACxC,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CA2E1B;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,4DAA4D;IAC5D,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,wBAAsB,WAAW,CAC/B,SAAS,EAAE,KAAK,CAAC,QAAQ,GAAG,mBAAmB,CAAC,EAChD,MAAM,EAAE,WAAW,EAAE,GACpB,OAAO,CAAC,cAAc,CAAC,CAczB;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAiB7D"}