@nac3/forge-cli 1.18.0 → 1.19.0

package/dist/urazuke/report.js

@@ -0,0 +1,62 @@
+import { readReceipts } from './receipts.js';
+function line(r) {
+    const cnt = r.counts.failed != null || r.counts.passed != null
+        ? ' (' + (r.counts.failed ?? 0) + ' failed, ' + (r.counts.passed ?? 0) + ' passed)'
+        : '';
+    const redKind = r.kind !== 'red_proof' ? ''
+        : r.mode === 'mutation' ? ' [mutation red: defect planted, diff on record]'
+            : (r.counts.failed ?? 0) > 0 ? ' [behavioural red]'
+                : ' [load-failure red only: the module did not exist at the base]';
+    return r.id + ' ' + r.kind + ': `' + r.command + '` exit ' + r.exit_code + cnt + ' @' + r.ref + (r.base_ref ? ' vs base ' + r.base_ref : '') + redKind;
+}
+export async function buildHonestReport(slug, item, input) {
+    const all = (await readReceipts(slug)).items.filter((r) => r.pending_id === item.id);
+    const ok = all.filter((r) => r.verdict === 'ok');
+    const bad = all.filter((r) => r.verdict !== 'ok');
+    const has = (k) => ok.some((r) => r.kind === k);
+    const verified = ok.map(line);
+    const believed = [];
+    const blind = [];
+    /* Declared test status without a green receipt is a belief. */
+    if (input.tests_status === 'green' && !has('green') && !has('regression')) {
+        believed.push('tests declared green (' + (input.tests_summary || 'no summary') + ') -- no green/regression receipt');
+    }
+    else if (input.tests_status && input.tests_status !== 'green') {
+        believed.push('tests declared ' + input.tests_status + (input.tests_summary ? ': ' + input.tests_summary : ''));
+    }
+    /* The functional claim and the use cases are the brain's word unless an
+     * e2e receipt exists for this item. */
+    const cases = (input.use_cases ?? item.implementation?.use_cases ?? []).map((c) => String(c).trim()).filter(Boolean);
+    if (cases.length && !has('e2e')) {
+        for (const c of cases)
+            believed.push('use case "' + c + '" -- declared, no e2e receipt');
+    }
+    if ((input.functional ?? item.implementation?.functional) && !has('e2e') && !has('green')) {
+        believed.push('functional description -- no receipt of any kind backs it');
+    }
+    if (!has('red_proof'))
+        blind.push('no red proof: the new test was never shown failing against the base');
+    if (!has('regression'))
+        blind.push('no regression receipt: the neighbouring suite was not re-run');
+    const flows = item.spec?.flows ?? [];
+    if (flows.length && !has('e2e')) {
+        for (const f of flows)
+            blind.push('flow "' + f + '" has no end-to-end receipt (screen to backend)');
+    }
+    else if (!flows.length && !has('e2e')) {
+        blind.push('no end-to-end receipt and no flows declared in the spec: unknown whether a screen is affected');
+    }
+    const dirty = ok.filter((r) => r.dirty && r.kind !== 'red_proof');
+    if (dirty.length)
+        blind.push(dirty.length + ' receipt(s) taken on a dirty tree: ' + dirty.map((r) => r.id).join(', ') + ' -- the committed version was not what ran');
+    if (bad.length)
+        blind.push(bad.length + ' receipt(s) with a NOT OK verdict are on record: ' + bad.map((r) => r.id).join(', '));
+    if (!item.spec)
+        blind.push('the item has no spec (acceptance + how_verified): nothing to verify against');
+    return { verified, believed, blind_spots: blind, receipts: all.map((r) => r.id), built_at: Date.now() };
+}
+export function renderHonestReport(r) {
+    const sec = (title, xs) => title + ' (' + xs.length + ')' + (xs.length ? '\n' + xs.map((x) => '  - ' + x).join('\n') : ' -- none');
+    return [sec('VERIFIED', r.verified), sec('BELIEVED', r.believed), sec('BLIND SPOTS', r.blind_spots)].join('\n');
+}
+//# sourceMappingURL=report.js.map

package/dist/urazuke/report.js.map

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

package/dist/urazuke/retro.d.ts

@@ -0,0 +1,52 @@
+export interface RetroNumbers {
+    since: string;
+    until: string;
+    pendings: {
+        opened: number;
+        closed: number;
+        shipped: number;
+        shipped_with_report: number;
+        bugs_closed: number;
+        open_now: number;
+        open_with_spec: number;
+        open_without_spec: number;
+    };
+    receipts: {
+        red_proofs: number;
+        greens: number;
+        regressions: number;
+        e2e: number;
+        quality: number;
+        mutation: number;
+        not_ok: number;
+        total: number;
+    };
+    overrides: number;
+    ladder: {
+        closed: number;
+        green: number;
+        red: number;
+        owner: number;
+        total: number;
+        kind?: string;
+    };
+    audits_on_disk: number;
+    retros_on_disk: number;
+}
+export declare function buildRetroNumbers(slug: string, projectRoot: string, opts?: {
+    since_days?: number;
+    now?: number;
+}): Promise<RetroNumbers>;
+export declare function renderRetro(n: RetroNumbers, prompt: string): string;
+/** Write docs/RETROSPECTIVE_<date>.md and return its path. */
+export declare function writeRetrospective(slug: string, projectRoot: string, opts?: {
+    since_days?: number;
+    now?: number;
+}): Promise<{
+    file: string;
+    numbers: RetroNumbers;
+}>;
+/** The step-13 audit prompt with the project's pointers, for ANOTHER
+ *  session (never the one that built the code). */
+export declare function buildAuditTask(projectRoot: string): Promise<string>;
+//# sourceMappingURL=retro.d.ts.map

package/dist/urazuke/retro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retro.d.ts","sourceRoot":"","sources":["../../src/urazuke/retro.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,mBAAmB,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAA;KAAE,CAAC;IACrL,QAAQ,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACrJ,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpG,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAkDlJ;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CA+CnE;AAED,8DAA8D;AAC9D,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC,CAS9K;AAED;mDACmD;AACnD,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAazE"}

package/dist/urazuke/retro.js

@@ -0,0 +1,145 @@
+/**
+ * RETROSPECTIVE WITH NUMBERS (Urazuke step 23) + the AUDIT prompt (step 13).
+ *
+ * The retrospective the method asks for ends in a proposal to change the
+ * method, backed by numbers, not impressions. Forge computes the numbers
+ * from its registries (pendings, receipts, overrides, the ladder, the
+ * audits on disk) and writes docs/RETROSPECTIVE_<date>.md with them and
+ * with the sections the owner + brain fill (the narrative and the proposal).
+ *
+ * The audit (step 13) is done by ANOTHER session: this module only prepares
+ * the prompt with the project's pointers; the CLI prints it or spawns a
+ * headless `yf chat --agent` with it.
+ *
+ * ASCII-only.
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+export async function buildRetroNumbers(slug, projectRoot, opts = {}) {
+    const now = opts.now ?? Date.now();
+    const sinceMs = now - (opts.since_days ?? 90) * 24 * 3600 * 1000;
+    const { listPending } = await import('../pending/store.js');
+    const { readReceipts } = await import('./receipts.js');
+    const { urazukeLadder } = await import('./current.js');
+    const { hasSpec } = await import('./probes.js');
+    const all = await listPending(slug, { status: 'all' });
+    const plan = all.filter((p) => !p.workflow || p.workflow.ad_hoc);
+    const inWindow = (t) => t != null && t >= sinceMs && t <= now;
+    const opened = plan.filter((p) => inWindow(p.created_at));
+    const closed = plan.filter((p) => inWindow(p.closed_at));
+    const shipped = closed.filter((p) => p.closed_reason === 'shipped');
+    const atMs = (at) => {
+        if (typeof at === 'number')
+            return at;
+        if (typeof at === 'string') {
+            const t = Date.parse(at);
+            return Number.isFinite(t) ? t : undefined;
+        }
+        return undefined;
+    };
+    const overrides = all.reduce((n, p) => n + (p.history ?? []).filter((h) => /OVERRIDE/.test(h.note) && inWindow(atMs(h.at))).length, 0);
+    const openNow = plan.filter((p) => p.closed_at === undefined);
+    const rc = (await readReceipts(slug)).items.filter((r) => inWindow(r.started_at));
+    const count = (k) => rc.filter((r) => r.kind === k && r.verdict === 'ok').length;
+    const ladder = await urazukeLadder(slug, projectRoot);
+    const l = { closed: 0, green: 0, red: 0, owner: 0, total: ladder.rows.length, ...(ladder.kind ? { kind: ladder.kind } : {}) };
+    for (const r of ladder.rows)
+        l[r.status] += 1;
+    const docs = await fs.readdir(path.join(projectRoot, 'docs')).catch(() => []);
+    return {
+        since: new Date(sinceMs).toISOString().slice(0, 10),
+        until: new Date(now).toISOString().slice(0, 10),
+        pendings: {
+            opened: opened.length, closed: closed.length, shipped: shipped.length,
+            shipped_with_report: shipped.filter((p) => !!p.implementation?.report).length,
+            bugs_closed: closed.filter((p) => p.category === 'bug').length,
+            open_now: openNow.length,
+            open_with_spec: openNow.filter((p) => hasSpec(p.spec)).length,
+            open_without_spec: openNow.filter((p) => !hasSpec(p.spec)).length,
+        },
+        receipts: {
+            red_proofs: count('red_proof'), greens: count('green'), regressions: count('regression'), e2e: count('e2e'),
+            quality: count('quality'), mutation: count('mutation'), not_ok: rc.filter((r) => r.verdict !== 'ok').length, total: rc.length,
+        },
+        overrides,
+        ladder: l,
+        audits_on_disk: docs.filter((n) => /^AUDIT_.*\.md$/i.test(n)).length,
+        retros_on_disk: docs.filter((n) => /^RETROSPECTIVE_.*\.md$/i.test(n)).length,
+    };
+}
+export function renderRetro(n, prompt) {
+    const row = (k, v) => '| ' + k + ' | ' + v + ' |';
+    return [
+        '# Retrospectiva ' + n.until + ' (ventana ' + n.since + ' .. ' + n.until + ')',
+        '',
+        'Los numeros los calculo Forge desde sus registros (pendientes, recibos de evidencia,',
+        'overrides de compuertas, la escalera, los documentos en disco). Las secciones 2 y 3 las',
+        'escriben el dueno y el agente; la 3 tiene que terminar en una propuesta concreta de cambio',
+        'al metodo, con el incidente que la justifica.',
+        '',
+        '## 1. Los numeros',
+        '',
+        '| Medida | Valor |',
+        '|---|---|',
+        row('Pendientes del plan abiertos en la ventana', n.pendings.opened),
+        row('Pendientes del plan cerrados en la ventana', n.pendings.closed),
+        row('Cerrados con shipped', n.pendings.shipped),
+        row('Cerrados con shipped CON reporte honesto', n.pendings.shipped_with_report),
+        row('Bugs cerrados', n.pendings.bugs_closed),
+        row('Abiertos hoy', n.pendings.open_now),
+        row('Abiertos hoy con especificacion', n.pendings.open_with_spec),
+        row('Abiertos hoy SIN especificacion', n.pendings.open_without_spec),
+        row('Recibos: rojo probado', n.receipts.red_proofs),
+        row('Recibos: verde', n.receipts.greens),
+        row('Recibos: regresion', n.receipts.regressions),
+        row('Recibos: punta a punta', n.receipts.e2e),
+        row('Recibos: calidad', n.receipts.quality),
+        row('Recibos: mutacion', n.receipts.mutation),
+        row('Recibos con veredicto NOT OK', n.receipts.not_ok),
+        row('Overrides de compuertas (con razon escrita)', n.overrides),
+        row('Escalera: peldanos cerrados / verdes / rojos / a cargo del dueno', n.ladder.closed + ' / ' + n.ladder.green + ' / ' + n.ladder.red + ' / ' + n.ladder.owner + ' de ' + n.ladder.total),
+        row('Auditorias en docs/', n.audits_on_disk),
+        row('Retrospectivas previas en docs/', n.retros_on_disk),
+        '',
+        '## 2. Que paso (lo escribe el dueno con el agente)',
+        '',
+        '_Pendiente: que salio bien, que salio mal, con el pendiente o el recibo que lo muestra._',
+        '',
+        '## 3. Propuesta de cambio al metodo',
+        '',
+        '_Pendiente: una propuesta concreta, con el incidente que la justifica. Si no hay, decirlo._',
+        '',
+        '## Prompt del peldano 23 (para la parte narrativa)',
+        '',
+        '> ' + prompt,
+        '',
+    ].join('\n');
+}
+/** Write docs/RETROSPECTIVE_<date>.md and return its path. */
+export async function writeRetrospective(slug, projectRoot, opts = {}) {
+    const numbers = await buildRetroNumbers(slug, projectRoot, opts);
+    const { URAZUKE_PROMPTS } = await import('./prompts.generated.js');
+    const prompts = URAZUKE_PROMPTS['peldano-23'] ?? [];
+    const prompt = prompts[prompts.length - 1] ?? '';
+    const file = path.join(projectRoot, 'docs', 'RETROSPECTIVE_' + numbers.until + '.md');
+    await fs.mkdir(path.dirname(file), { recursive: true });
+    await fs.writeFile(file, renderRetro(numbers, prompt), 'utf8');
+    return { file, numbers };
+}
+/** The step-13 audit prompt with the project's pointers, for ANOTHER
+ *  session (never the one that built the code). */
+export async function buildAuditTask(projectRoot) {
+    const { URAZUKE_PROMPTS } = await import('./prompts.generated.js');
+    const prompts = URAZUKE_PROMPTS['peldano-13'] ?? [];
+    const base = prompts[0] ?? 'Audit this project for integrity, security, performance, code quality and documentation.';
+    const docs = await fs.readdir(path.join(projectRoot, 'docs')).catch(() => []);
+    const pointers = ['PROJECT.md', 'docs/SEMANTIC_TREE.md', 'docs/STATUS.md', 'docs/GATES.md', 'docs/LOCKS.md', 'docs/PRODUCER_CONSUMER_MAP.md']
+        .filter((p) => p === 'PROJECT.md' || docs.includes(path.basename(p)));
+    const date = new Date().toISOString().slice(0, 10);
+    return base
+        + ' Context: this is an independent audit session; you did not build this code. Start from '
+        + pointers.join(', ') + '. Re-run a sample of the evidence receipts (yujin.evidence.list, then the exact commands) and report any receipt you could not reproduce.'
+        + ' Write the findings to docs/AUDIT_' + date + '.md with a severity per finding (P0, P1, P2) and open one pending item per P0 and P1.'
+        + ' Start the report with one line "Auditor: <this session and model>" so the owner can see the audit was not done by the session that built the code (D-040).';
+}
+//# sourceMappingURL=retro.js.map

package/dist/urazuke/retro.js.map

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

package/dist/urazuke/section.d.ts

@@ -0,0 +1,43 @@
+/**
+ * URAZUKE prompt section -- the pure renderer.
+ *
+ * This is the mechanism Pablo pointed at: Forge injects the prompt of the
+ * step the project is on INTO the brain's system prompt, every turn, with
+ * the mechanical state of that step next to it. The brain does not have to
+ * remember the method, look it up or be reminded; the exact text the method
+ * publishes arrives as the active instruction, and the red checks arrive
+ * with it so the brain knows what is missing BEFORE it claims the step done.
+ *
+ * Own section, never truncated below its header (same reason as the sizing
+ * section: a gate that can be truncated away is not a gate). The prompt
+ * itself is the longest part and is kept whole; what gets cut first is the
+ * owner checklist.
+ *
+ * ASCII-only.
+ */
+import type { UrazukeStep, UrazukeStation } from './catalog.js';
+import type { UrazukeStepResult } from './gate.js';
+export interface UrazukeSectionInput {
+    /** Workflow code + the task id of the current step. */
+    code: string;
+    task_id: string;
+    kind: 'urazuke' | 'urazuke-legacy';
+    step?: UrazukeStep;
+    station?: UrazukeStation;
+    /** The prompts of this step/station, English, in order. */
+    prompts: readonly string[];
+    result: UrazukeStepResult;
+    /** How many canonical tasks remain open (including this one). */
+    remaining: number;
+    total: number;
+    char_budget?: number;
+}
+export declare function renderUrazukeSection(input: UrazukeSectionInput): string;
+/** One line per task for the status verb / CLI. */
+export declare function renderLadderStatusLines(rows: Array<{
+    num: string;
+    title: string;
+    status: 'green' | 'red' | 'owner' | 'closed';
+    task_id?: string;
+}>): string[];
+//# sourceMappingURL=section.d.ts.map

package/dist/urazuke/section.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section.d.ts","sourceRoot":"","sources":["../../src/urazuke/section.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAgB,MAAM,WAAW,CAAC;AAEjE,MAAM,WAAW,mBAAmB;IAClC,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,SAAS,GAAG,gBAAgB,CAAC;IACnC,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,2DAA2D;IAC3D,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAqDvE;AAED,mDAAmD;AACnD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,MAAM,EAAE,CAK7J"}

package/dist/urazuke/section.js

@@ -0,0 +1,64 @@
+function mark(c) {
+    return c.status === 'ok' ? '[x]' : c.status === 'fail' ? '[ ]' : '[~]';
+}
+export function renderUrazukeSection(input) {
+    const r = input.result;
+    const isStation = !!input.station;
+    const label = isStation
+        ? 'estacion N' + input.station.num + ' (normalizacion del legado)'
+        : 'peldano ' + String(input.step.num).padStart(2, '0') + ' de 24';
+    const header = '=================================================================\n' +
+        'URAZUKE -- ' + label + ': ' + r.title + '\n' +
+        '(' + input.code + ', tarea ' + input.task_id + ', ' + input.remaining + ' de ' + input.total + ' tareas abiertas) -- doctrine: urazuke\n' +
+        '=================================================================';
+    const lines = [];
+    const state = r.status === 'green' ? 'VERDE' : r.status === 'red' ? 'ROJO' : 'A CARGO DEL DUENO';
+    lines.push('estado mecanico: ' + state + (r.status === 'green'
+        ? ' -- the artifacts exist; close ' + input.task_id + ' with yujin.pending.close (expediente + evidence) and move on.'
+        : r.status === 'red'
+            ? ' -- it does NOT close until every check below is [x]. Do not claim it done.'
+            : ' -- nothing mechanical to check; the owner verifies with the checklist.'));
+    if (r.inputs.length) {
+        lines.push('antes de enviar (lo que el DUENO tiene que tener hecho; si falta, pedilo, no lo inventes):');
+        for (const c of r.inputs)
+            lines.push('  ' + mark(c) + ' ' + c.label + (c.status === 'fail' ? ' -- ' + c.detail : ''));
+    }
+    if (r.checks.length) {
+        lines.push('lo que este peldano deja (lo verifica Forge, no tu palabra):');
+        for (const c of r.checks)
+            lines.push('  ' + mark(c) + ' ' + c.label + (c.status === 'fail' ? ' -- ' + c.detail : ''));
+    }
+    const promptBlock = [];
+    promptBlock.push('PROMPT DEL PELDANO (the owner\'s instruction for this step; act on it as if the owner had pasted it):');
+    input.prompts.forEach((p, i) => {
+        promptBlock.push((input.prompts.length > 1 ? '[' + (i + 1) + '/' + input.prompts.length + '] ' : '') + p);
+    });
+    const verify = (input.step?.verify ?? input.station?.verify ?? []);
+    const verifyBlock = [];
+    if (verify.length) {
+        verifyBlock.push('verificacion del dueno (sin leer codigo):');
+        for (const v of verify)
+            verifyBlock.push('  - ' + v);
+    }
+    const budget = input.char_budget ?? 6000;
+    const fixed = '\n\n' + header + '\n' + lines.join('\n') + '\n' + promptBlock.join('\n');
+    if (fixed.length + verifyBlock.join('\n').length + 1 <= budget) {
+        return fixed + (verifyBlock.length ? '\n' + verifyBlock.join('\n') : '');
+    }
+    if (fixed.length <= budget)
+        return fixed;
+    /* Over budget even without the checklist: keep header + state + prompt,
+     * drop the artifact detail lines first. */
+    const minimal = '\n\n' + header + '\n' + lines[0] + '\n' + promptBlock.join('\n');
+    if (minimal.length <= budget)
+        return minimal;
+    return minimal.slice(0, Math.max(header.length + 40, budget - 20)) + '\n  ... (yujin.urazuke.step)';
+}
+/** One line per task for the status verb / CLI. */
+export function renderLadderStatusLines(rows) {
+    return rows.map((r) => {
+        const m = r.status === 'closed' ? '[x]' : r.status === 'green' ? '[v]' : r.status === 'red' ? '[ ]' : '[~]';
+        return m + ' ' + r.num + ' ' + r.title + (r.task_id ? ' (' + r.task_id + ')' : '');
+    });
+}
+//# sourceMappingURL=section.js.map

package/dist/urazuke/section.js.map

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

package/dist/urazuke/stacks.d.ts

@@ -0,0 +1,42 @@
+export type StackId = 'node' | 'python' | 'go' | 'dotnet' | 'java' | 'php' | 'unknown';
+export interface StackAdapter {
+    id: StackId;
+    label: string;
+    /** Globs (basename suffixes) of source files the native meters scan. */
+    source_exts: string[];
+    /** Directories never scanned. */
+    ignore_dirs: string[];
+    /** The command that runs the whole test battery. */
+    test_command: string;
+    /** Lint + format check commands (empty when the stack has none installed). */
+    lint_commands: string[];
+    /** Where the coverage summary lands after `coverage_command`, and how to
+     *  read the line percentage from it. */
+    coverage_command?: string;
+    coverage_file?: string;
+    coverage_reader?: 'istanbul-summary' | 'coverage-py-json' | 'go-cover' | 'cobertura-xml';
+    /** Mutation testing tool. */
+    mutation_tool?: string;
+    mutation_command?: string;
+    mutation_report?: string;
+    mutation_reader?: 'stryker-json' | 'mutmut-text' | 'go-mutesting-text';
+    /** Files Forge scaffolds with `yf urazuke quality init` (path -> body). */
+    scaffold: Record<string, string>;
+    /** Packages to add (hint for the agent; Forge does not install). */
+    dev_dependencies: string[];
+}
+/** Detect the stack. Node wins when package.json exists; python on
+ *  pyproject/requirements; go on go.mod; dotnet on *.csproj/*.sln; java on
+ *  pom.xml/build.gradle; php on composer.json. */
+export declare function detectStack(root: string): Promise<StackAdapter>;
+/** Line coverage percentage from the stack's report, if readable. */
+export declare function readCoveragePct(root: string, a: StackAdapter): Promise<number | undefined>;
+export interface MutationScore {
+    killed: number;
+    survived: number;
+    total: number;
+    score: number;
+}
+/** Mutation score from the tool's report (or its text output as fallback). */
+export declare function readMutationScore(root: string, a: StackAdapter, output: string): Promise<MutationScore | undefined>;
+//# sourceMappingURL=stacks.d.ts.map

package/dist/urazuke/stacks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stacks.d.ts","sourceRoot":"","sources":["../../src/urazuke/stacks.ts"],"names":[],"mappings":"AAgBA,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,IAAI,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;AAEvF,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,iCAAiC;IACjC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB;4CACwC;IACxC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,kBAAkB,GAAG,kBAAkB,GAAG,UAAU,GAAG,eAAe,CAAC;IACzF,6BAA6B;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,cAAc,GAAG,aAAa,GAAG,mBAAmB,CAAC;IACvE,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,oEAAoE;IACpE,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAYD;;kDAEkD;AAClD,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAcrE;AAgGD,qEAAqE;AACrE,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAwChG;AAiBD,MAAM,WAAW,aAAa;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AAEjG,8EAA8E;AAC9E,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CA8BzH"}