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

package/dist/commands/workflow.js

@@ -0,0 +1,253 @@
+import prompts from 'prompts';
+import { c, header } from '../ui/colors.js';
+import { activeSlug, readRegistry } from '../core/projects.js';
+import { instantiateWorkflow, classifyForProject, addTaskToWorkflow, workflowTasks, nextTask, createWorkflowShell, attachPendingsToWorkflow, } from '../workflow/orchestrator.js';
+import { listInstances, findInstance } from '../workflow/instances.js';
+import { loadWorkflowConfig, resetWorkflowConfig } from '../workflow/config.js';
+async function resolveSlugRoot(opts) {
+    const slug = opts.project ?? (await activeSlug());
+    if (!slug)
+        throw new Error('no active project; pass --project <slug> or set one with `yf projects switch`');
+    const reg = await readRegistry();
+    const entry = reg.projects.find((p) => p.slug === slug);
+    const root = entry?.path ?? process.cwd();
+    return { slug, root };
+}
+const VALID_KINDS = ['greenfield', 'corrective', 'evolutive'];
+export function registerWorkflowCommand(program) {
+    const root = program
+        .command('workflow')
+        .description('Workflows deterministas (greenfield / correctivo / evolutivo) entrelazados con los pendings.');
+    root
+        .command('start')
+        .description('Instancia un workflow + genera sus pendings-tarea en orden.')
+        .option('--kind <k>', 'greenfield | corrective | evolutive (si falta, se clasifica)')
+        .option('--name <n>', 'nombre del workflow (si falta, se deriva del request)')
+        .option('--request <text>', 'el pedido, para clasificar el kind')
+        .option('--project <slug>', 'override active project')
+        .option('--json', 'emit JSON')
+        .action(async (opts) => {
+        try {
+            const { slug, root: projectRoot } = await resolveSlugRoot(opts);
+            let kind = opts.kind;
+            if (kind && !VALID_KINDS.includes(kind))
+                throw new Error('--kind must be one of: ' + VALID_KINDS.join(', '));
+            if (!kind) {
+                const cls = await classifyForProject(projectRoot, opts.request ?? '');
+                if (cls.needs_confirm && process.stdin.isTTY) {
+                    const ans = await prompts({
+                        type: 'select', name: 'k', message: 'No estoy seguro del tipo. ' + cls.rationale + ' Elegi:',
+                        choices: VALID_KINDS.map((k) => ({ title: k + (k === cls.kind ? ' (sugerido)' : ''), value: k })),
+                        initial: VALID_KINDS.indexOf(cls.kind),
+                    });
+                    kind = ans.k ?? cls.kind;
+                }
+                else {
+                    kind = cls.kind;
+                    if (cls.needs_confirm)
+                        process.stderr.write(c.warn('confianza baja (' + cls.confidence.toFixed(2) + '): asumo ' + kind + '. ' + cls.rationale + '\n'));
+                }
+            }
+            const name = opts.name ?? deriveName(opts.request) ?? (kind + ' workflow');
+            const { instance, tasks } = await instantiateWorkflow({ slug, projectRoot, kind, name });
+            if (opts.json) {
+                process.stdout.write(JSON.stringify({ instance, task_count: tasks.length }, null, 2) + '\n');
+                return;
+            }
+            header('Workflow ' + instance.code + ' -- ' + instance.kind);
+            process.stdout.write('  nombre: ' + c.brand(instance.name) + '\n');
+            process.stdout.write('  etapas: ' + instance.stages.length + ' | tareas (pendings): ' + tasks.length + '\n');
+            process.stdout.write('  primera tarea: ' + (tasks[0] ? c.brand(tasks[0].id + ' ' + tasks[0].title) : '(ninguna)') + '\n');
+        }
+        catch (err) {
+            fail(err);
+        }
+    });
+    root
+        .command('list')
+        .description('Workflows abiertos + progreso.')
+        .option('--project <slug>', 'override active project')
+        .option('--all', 'incluir cerrados')
+        .option('--json', 'emit JSON')
+        .action(async (opts) => {
+        try {
+            const { slug } = await resolveSlugRoot(opts);
+            const insts = await listInstances(slug, opts.all ? 'all' : 'open');
+            const rows = [];
+            for (const i of insts) {
+                const all = await workflowTasks(slug, i.code, 'all');
+                const open = all.filter((t) => t.closed_at === undefined).length;
+                rows.push({ ...i, total: all.length, open, done: all.length - open });
+            }
+            if (opts.json) {
+                process.stdout.write(JSON.stringify(rows, null, 2) + '\n');
+                return;
+            }
+            if (rows.length === 0) {
+                process.stdout.write(c.dim('no hay workflows ' + (opts.all ? '' : 'abiertos') + '.\n'));
+                return;
+            }
+            for (const r of rows) {
+                process.stdout.write(c.brand(r.code) + ' [' + r.kind + '] ' + r.name
+                    + '  ' + c.dim(r.done + '/' + r.total + ' tareas') + '  ' + (r.status === 'open' ? c.success('open') : c.dim('closed')) + '\n');
+            }
+        }
+        catch (err) {
+            fail(err);
+        }
+    });
+    root
+        .command('status [code]')
+        .description('Tareas de un workflow + la proxima a ejecutar.')
+        .option('--project <slug>', 'override active project')
+        .option('--json', 'emit JSON')
+        .action(async (code, opts) => {
+        try {
+            const { slug } = await resolveSlugRoot(opts);
+            let target = code;
+            if (!target) {
+                const open = await listInstances(slug, 'open');
+                if (open.length === 0) {
+                    process.stdout.write(c.dim('no hay workflows abiertos.\n'));
+                    return;
+                }
+                target = open[0].code;
+            }
+            const inst = await findInstance(slug, target);
+            if (!inst)
+                throw new Error('workflow no encontrado: ' + target);
+            const tasks = await workflowTasks(slug, target, 'all');
+            const next = await nextTask(slug, target);
+            if (opts.json) {
+                process.stdout.write(JSON.stringify({ instance: inst, tasks, next }, null, 2) + '\n');
+                return;
+            }
+            header('Workflow ' + inst.code + ' -- ' + inst.kind + ' (' + inst.status + ')');
+            process.stdout.write('  ' + c.brand(inst.name) + '\n\n');
+            for (const t of tasks) {
+                const mark = t.closed_at !== undefined ? c.success('[x]') : (next && t.id === next.id ? c.warn('[>]') : c.dim('[ ]'));
+                process.stdout.write('  ' + mark + ' ' + String(t.workflow?.order).padStart(2) + '  ' + t.id + '  ' + t.title
+                    + (t.workflow?.ad_hoc ? c.dim(' (ad-hoc)') : '') + '\n');
+            }
+            process.stdout.write('\n  proxima: ' + (next ? c.brand(next.id + ' ' + next.title) : c.success('todas cerradas')) + '\n');
+        }
+        catch (err) {
+            fail(err);
+        }
+    });
+    root
+        .command('add-task <code> <title>')
+        .description('Agrega una tarea ad-hoc (correctivo/evolutivo) a un workflow en ejecucion.')
+        .option('--body <s>', 'detalle')
+        .option('--category <c>', 'user_blocked | autopilot | clarify | bug | infra', 'autopilot')
+        .option('--project <slug>', 'override active project')
+        .option('--json', 'emit JSON')
+        .action(async (code, title, opts) => {
+        try {
+            const { slug } = await resolveSlugRoot(opts);
+            const it = await addTaskToWorkflow({
+                slug, code, title,
+                ...(opts.body ? { body: opts.body } : {}),
+                category: opts.category ?? 'autopilot',
+            });
+            if (opts.json) {
+                process.stdout.write(JSON.stringify(it, null, 2) + '\n');
+                return;
+            }
+            process.stdout.write(c.success('tarea agregada ') + it.id + ' a ' + code + ' (orden ' + it.workflow?.order + ')\n');
+        }
+        catch (err) {
+            fail(err);
+        }
+    });
+    root
+        .command('attach <code> [ids...]')
+        .description('Asocia pendings EXISTENTES a un workflow (los vuelve sus tareas, en orden). '
+        + 'Con --all-open asocia todos los pendings abiertos.')
+        .option('--all-open', 'asociar todos los pendings abiertos del proyecto')
+        .option('--stage <id>', 'etapa a la que asociarlos')
+        .option('--project <slug>', 'override active project')
+        .option('--json', 'emit JSON')
+        .action(async (code, ids, opts) => {
+        try {
+            const { slug } = await resolveSlugRoot(opts);
+            let targetIds = ids ?? [];
+            if (opts.allOpen) {
+                const { listPending } = await import('../pending/store.js');
+                const open = await listPending(slug, { status: 'open' });
+                /* skip pendings already linked to a workflow */
+                targetIds = open.filter((p) => !p.workflow).map((p) => p.id);
+            }
+            if (targetIds.length === 0) {
+                process.stdout.write(c.dim('no hay pendings para asociar.\n'));
+                return;
+            }
+            const linked = await attachPendingsToWorkflow({
+                slug, code, ids: targetIds, ...(opts.stage ? { stage_id: opts.stage } : {}),
+            });
+            if (opts.json) {
+                process.stdout.write(JSON.stringify(linked.map((l) => ({ id: l.id, order: l.workflow?.order })), null, 2) + '\n');
+                return;
+            }
+            process.stdout.write(c.success('asociados ' + linked.length + ' pendings a ' + code) + '\n');
+        }
+        catch (err) {
+            fail(err);
+        }
+    });
+    root
+        .command('create-shell')
+        .description('Crea una instancia de workflow SIN generar tareas canonicas (para asociar pendings existentes).')
+        .requiredOption('--kind <k>', 'greenfield | corrective | evolutive')
+        .requiredOption('--name <n>', 'nombre del workflow')
+        .option('--project <slug>', 'override active project')
+        .option('--json', 'emit JSON')
+        .action(async (opts) => {
+        try {
+            const { slug, root: projectRoot } = await resolveSlugRoot(opts);
+            if (!VALID_KINDS.includes(opts.kind))
+                throw new Error('--kind invalido');
+            const inst = await createWorkflowShell({ slug, projectRoot, kind: opts.kind, name: opts.name });
+            if (opts.json) {
+                process.stdout.write(JSON.stringify(inst, null, 2) + '\n');
+                return;
+            }
+            process.stdout.write(c.success('workflow ' + inst.code + ' creado (shell, sin tareas)') + '\n');
+        }
+        catch (err) {
+            fail(err);
+        }
+    });
+    root
+        .command('config')
+        .description('Inspecciona / restaura (DR) las definiciones editables de etapas+tareas.')
+        .option('--show', 'imprime la config activa')
+        .option('--reset', 'restaura desde el default (disaster recovery)')
+        .option('--project <slug>', 'override active project')
+        .action(async (opts) => {
+        try {
+            const { root: projectRoot } = await resolveSlugRoot(opts);
+            if (opts.reset) {
+                await resetWorkflowConfig(projectRoot);
+                process.stdout.write(c.success('config restaurada al default.\n'));
+                return;
+            }
+            const cfg = await loadWorkflowConfig(projectRoot);
+            process.stdout.write(JSON.stringify(cfg, null, 2) + '\n');
+        }
+        catch (err) {
+            fail(err);
+        }
+    });
+}
+function deriveName(request) {
+    if (!request)
+        return undefined;
+    const words = request.trim().split(/\s+/).slice(0, 6).join(' ');
+    return words || undefined;
+}
+function fail(err) {
+    process.stderr.write(String(err instanceof Error ? err.message : err) + '\n');
+    process.exitCode = 1;
+}
+//# sourceMappingURL=workflow.js.map

package/dist/commands/workflow.js.map

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

package/dist/core/ansi_strip.d.ts

@@ -0,0 +1,39 @@
+/**
+ * ansi_strip.ts -- normalise shell output for display
+ * (alpha.59j).
+ *
+ * npm, pip, cargo, docker and most modern CLIs emit:
+ *   1. ANSI escape sequences \x1b[...m for colour + cursor moves.
+ *   2. Carriage returns \r without a following \n to OVERWRITE
+ *      the current line (progress bars: "10%\r25%\r50%\r100%").
+ *   3. Cursor-up sequences \x1b[<N>A for multi-line redraws.
+ *
+ * Rendered raw, this looks like a wall of duplicate lines + escape
+ * gibberish. We normalise BEFORE rendering in the pizarron tab:
+ *
+ *   - Split content into lines.
+ *   - Per line: apply \r overwrite semantics (last write wins).
+ *   - Strip all ANSI escape sequences (\x1b[...m, \x1b[K, etc).
+ *   - Strip standalone \r at end of line.
+ *
+ * The result is human-readable plain text that fits in our existing
+ * monospace `code` pizarron renderer. Future enhancement: parse the
+ * ANSI colour codes into HTML spans, but that's not necessary today.
+ *
+ * ASCII-only (the source code; the runtime processes UTF-8 fine).
+ */
+/** Apply \r overwrite semantics. For a string with no \n, the
+ *  LAST segment after the final \r is what survives (progress bar
+ *  case). For multi-line strings, we apply per line. */
+declare function applyCarriageReturn(line: string): string;
+/** Strip ANSI escape codes. Pass-through everything else. */
+export declare function stripAnsi(s: string): string;
+/** Full normalisation: strip ANSI + apply \r overwrite per line. */
+export declare function normaliseShellOutput(raw: string): string;
+/** Test seam. */
+export declare const _internal: {
+    ANSI_ESCAPE_RE: RegExp;
+    applyCarriageReturn: typeof applyCarriageReturn;
+};
+export {};
+//# sourceMappingURL=ansi_strip.d.ts.map

package/dist/core/ansi_strip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ansi_strip.d.ts","sourceRoot":"","sources":["../../src/core/ansi_strip.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAUH;;wDAEwD;AACxD,iBAAS,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAUjD;AAED,6DAA6D;AAC7D,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAG3C;AAED,oEAAoE;AACpE,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAWxD;AAED,iBAAiB;AACjB,eAAO,MAAM,SAAS;;;CAA0C,CAAC"}

package/dist/core/ansi_strip.js

@@ -0,0 +1,71 @@
+/**
+ * ansi_strip.ts -- normalise shell output for display
+ * (alpha.59j).
+ *
+ * npm, pip, cargo, docker and most modern CLIs emit:
+ *   1. ANSI escape sequences \x1b[...m for colour + cursor moves.
+ *   2. Carriage returns \r without a following \n to OVERWRITE
+ *      the current line (progress bars: "10%\r25%\r50%\r100%").
+ *   3. Cursor-up sequences \x1b[<N>A for multi-line redraws.
+ *
+ * Rendered raw, this looks like a wall of duplicate lines + escape
+ * gibberish. We normalise BEFORE rendering in the pizarron tab:
+ *
+ *   - Split content into lines.
+ *   - Per line: apply \r overwrite semantics (last write wins).
+ *   - Strip all ANSI escape sequences (\x1b[...m, \x1b[K, etc).
+ *   - Strip standalone \r at end of line.
+ *
+ * The result is human-readable plain text that fits in our existing
+ * monospace `code` pizarron renderer. Future enhancement: parse the
+ * ANSI colour codes into HTML spans, but that's not necessary today.
+ *
+ * ASCII-only (the source code; the runtime processes UTF-8 fine).
+ */
+/* Regex that matches:
+ *   CSI sequences:     \x1b[ ... letter
+ *   OSC sequences:     \x1b] ... BEL or \x1b]
+ *   Single-char ESC:   \x1b followed by anything other than [ or ]
+ *   bare BEL:          \x07
+ */
+const ANSI_ESCAPE_RE = /\x1b\[[\d;?]*[a-zA-Z]|\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)|\x1b[@-_]|\x07/g;
+/** Apply \r overwrite semantics. For a string with no \n, the
+ *  LAST segment after the final \r is what survives (progress bar
+ *  case). For multi-line strings, we apply per line. */
+function applyCarriageReturn(line) {
+    if (!line.includes('\r'))
+        return line;
+    const segments = line.split('\r');
+    /* The last non-empty segment wins. Empty segments (consecutive \r)
+     *  are ignored. */
+    for (let i = segments.length - 1; i >= 0; i--) {
+        const seg = segments[i];
+        if (seg && seg.length > 0)
+            return seg;
+    }
+    return '';
+}
+/** Strip ANSI escape codes. Pass-through everything else. */
+export function stripAnsi(s) {
+    if (!s || s.indexOf('\x1b') < 0 && s.indexOf('\x07') < 0)
+        return s;
+    return s.replace(ANSI_ESCAPE_RE, '');
+}
+/** Full normalisation: strip ANSI + apply \r overwrite per line. */
+export function normaliseShellOutput(raw) {
+    if (!raw)
+        return '';
+    const stripped = stripAnsi(raw);
+    /* Split on \n, normalise each line independently for \r, then
+     *  rejoin. Keep trailing newline if present. */
+    const lines = stripped.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (typeof line === 'string')
+            lines[i] = applyCarriageReturn(line);
+    }
+    return lines.join('\n');
+}
+/** Test seam. */
+export const _internal = { ANSI_ESCAPE_RE, applyCarriageReturn };
+//# sourceMappingURL=ansi_strip.js.map

package/dist/core/ansi_strip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ansi_strip.js","sourceRoot":"","sources":["../../src/core/ansi_strip.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH;;;;;GAKG;AACH,MAAM,cAAc,GAAG,yEAAyE,CAAC;AAEjG;;wDAEwD;AACxD,SAAS,mBAAmB,CAAC,IAAY;IACvC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC;uBACmB;IACnB,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;IACxC,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,SAAS,CAAC,CAAS;IACjC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IACnE,OAAO,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAChC;oDACgD;IAChD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,KAAK,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,iBAAiB;AACjB,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,cAAc,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/core/atomic_write.d.ts

@@ -0,0 +1,17 @@
+export interface RetryOpts {
+    /** Maximum attempt count (default 5). */
+    maxRetries?: number;
+    /** Initial delay in ms before retry 1 (default 10). Each retry
+     *  doubles the delay: 10, 20, 40, 80, 160 = ~310ms cap. */
+    initialDelayMs?: number;
+    /** Errno codes that count as "retryable". Defaults cover the
+     *  Windows handle-races + ENOENT (caller may have created the
+     *  tmp file then a finder briefly hid it). */
+    retryableCodes?: ReadonlySet<string>;
+}
+/** Wrap any async fs op and retry on Windows handle-races.  */
+export declare function withRenameRetry<T>(op: () => Promise<T>, opts?: RetryOpts): Promise<T>;
+/** Atomic rename with retry. The canonical replacement for raw
+ *  `fs.rename(tmp, target)` in persistence paths. */
+export declare function renameWithRetry(src: string, dst: string, opts?: RetryOpts): Promise<void>;
+//# sourceMappingURL=atomic_write.d.ts.map

package/dist/core/atomic_write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic_write.d.ts","sourceRoot":"","sources":["../../src/core/atomic_write.ts"],"names":[],"mappings":"AAyBA,MAAM,WAAW,SAAS;IACxB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;+DAC2D;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;kDAE8C;IAC9C,cAAc,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACtC;AAID,+DAA+D;AAC/D,wBAAsB,eAAe,CAAC,CAAC,EACrC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,IAAI,GAAE,SAAc,GACnB,OAAO,CAAC,CAAC,CAAC,CAgBZ;AAED;qDACqD;AACrD,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,SAAc,GAC7C,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/core/atomic_write.js

@@ -0,0 +1,51 @@
+/**
+ * Atomic write helpers with Windows EPERM resilience.
+ *
+ * The "write tmp + rename" pattern is the canonical way to persist a
+ * file atomically: a process death between write and rename leaves
+ * the OLD file intact, and the rename is itself atomic at the
+ * filesystem layer on every supported platform.
+ *
+ * On Windows, however, `fs.rename` can fail with EPERM (or EBUSY,
+ * EACCES) under three common conditions:
+ *   1. Antivirus software briefly holds an exclusive handle on the
+ *      destination after a previous write (Windows Defender does this
+ *      on every newly-written file).
+ *   2. Another process on the same machine has the destination open
+ *      for read.
+ *   3. The filesystem indexer (Search) is mid-scan on the directory.
+ *
+ * The standard mitigation is to retry with a short exponential
+ * backoff. After 5 attempts (~310ms total) the operation is
+ * conclusively failing and we bubble the error.
+ *
+ * ASCII-only.
+ */
+import { promises as fs } from 'node:fs';
+const DEFAULT_RETRYABLE = new Set(['EPERM', 'EBUSY', 'EACCES', 'ENOENT']);
+/** Wrap any async fs op and retry on Windows handle-races.  */
+export async function withRenameRetry(op, opts = {}) {
+    const max = opts.maxRetries ?? 5;
+    const baseMs = opts.initialDelayMs ?? 10;
+    const retryOk = opts.retryableCodes ?? DEFAULT_RETRYABLE;
+    let attempt = 0;
+    for (;;) {
+        try {
+            return await op();
+        }
+        catch (err) {
+            const code = err.code;
+            if (!code || !retryOk.has(code) || attempt >= max)
+                throw err;
+            const delay = baseMs * Math.pow(2, attempt);
+            attempt += 1;
+            await new Promise((r) => setTimeout(r, delay));
+        }
+    }
+}
+/** Atomic rename with retry. The canonical replacement for raw
+ *  `fs.rename(tmp, target)` in persistence paths. */
+export async function renameWithRetry(src, dst, opts = {}) {
+    await withRenameRetry(() => fs.rename(src, dst), opts);
+}
+//# sourceMappingURL=atomic_write.js.map

package/dist/core/atomic_write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic_write.js","sourceRoot":"","sources":["../../src/core/atomic_write.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AAczC,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE1E,+DAA+D;AAC/D,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,EAAoB,EACpB,OAAkB,EAAE;IAEpB,MAAM,GAAG,GAAQ,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC;IACtC,MAAM,MAAM,GAAK,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC;IAC3C,MAAM,OAAO,GAAI,IAAI,CAAC,cAAc,IAAI,iBAAiB,CAAC;IAC1D,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,SAAS,CAAC;QACR,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;YACjD,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,GAAG;gBAAE,MAAM,GAAG,CAAC;YAC7D,MAAM,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YAC5C,OAAO,IAAI,CAAC,CAAC;YACb,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;AACH,CAAC;AAED;qDACqD;AACrD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAW,EAAE,GAAW,EAAE,OAAkB,EAAE;IAE9C,MAAM,eAAe,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;AACzD,CAAC"}

package/dist/core/audit_log.d.ts

@@ -0,0 +1,43 @@
+export type AuditApprovalMode = 'auto_approved' | 'user_approved' | 'user_rejected' | 'danger_zone_bypass' | 'not_applicable';
+export interface AuditEntryBase {
+    ts: string;
+    kind: string;
+    summary: string;
+    approval_mode: AuditApprovalMode;
+}
+export interface ShellExecAudit extends AuditEntryBase {
+    kind: 'shell.exec';
+    command: string;
+    cwd: string;
+    risk_bucket: 'destructive' | 'elevation' | 'network' | 'safe';
+    risk_reasons: string[];
+    exit_code: number | null;
+    duration_ms: number;
+    killed: boolean;
+    stdout_bytes: number;
+    stderr_bytes: number;
+}
+export interface VerbInvokeAudit extends AuditEntryBase {
+    kind: 'verb.invoke';
+    verb_id: string;
+    args_redacted: Record<string, unknown>;
+    status: 'ok' | 'error';
+    error?: string;
+}
+export interface LifecycleAudit extends AuditEntryBase {
+    kind: 'fs.mkdir' | 'fs.move' | 'project.init' | 'project.set-root';
+    target_path: string;
+    details?: Record<string, unknown>;
+}
+export type AuditEntry = ShellExecAudit | VerbInvokeAudit | LifecycleAudit | AuditEntryBase;
+/** Append a single entry. Best-effort -- never throws. */
+export declare function recordAudit(entry: Partial<AuditEntry> & {
+    kind: string;
+    summary?: string;
+}): Promise<void>;
+/** Read recent entries (newest first). Used by the panel
+ *  audit-trail view + tests. */
+export declare function readRecentAudit(limit?: number): Promise<AuditEntry[]>;
+/** Test seam. */
+export declare function _auditLogPathForTest(): string;
+//# sourceMappingURL=audit_log.d.ts.map

package/dist/core/audit_log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit_log.d.ts","sourceRoot":"","sources":["../../src/core/audit_log.ts"],"names":[],"mappings":"AA8BA,MAAM,MAAM,iBAAiB,GACzB,eAAe,GACf,eAAe,GACf,eAAe,GACf,oBAAoB,GACpB,gBAAgB,CAAC;AAErB,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAgB,MAAM,CAAC;IACzB,IAAI,EAAc,MAAM,CAAC;IACzB,OAAO,EAAW,MAAM,CAAC;IACzB,aAAa,EAAK,iBAAiB,CAAC;CACrC;AAED,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD,IAAI,EAAc,YAAY,CAAC;IAC/B,OAAO,EAAW,MAAM,CAAC;IACzB,GAAG,EAAe,MAAM,CAAC;IACzB,WAAW,EAAO,aAAa,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC;IACnE,YAAY,EAAM,MAAM,EAAE,CAAC;IAC3B,SAAS,EAAS,MAAM,GAAG,IAAI,CAAC;IAChC,WAAW,EAAO,MAAM,CAAC;IACzB,MAAM,EAAY,OAAO,CAAC;IAC1B,YAAY,EAAM,MAAM,CAAC;IACzB,YAAY,EAAM,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,IAAI,EAAc,aAAa,CAAC;IAChC,OAAO,EAAW,MAAM,CAAC;IACzB,aAAa,EAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,MAAM,EAAY,IAAI,GAAG,OAAO,CAAC;IACjC,KAAK,CAAC,EAAY,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD,IAAI,EAAc,UAAU,GAAG,SAAS,GAAG,cAAc,GAAG,kBAAkB,CAAC;IAC/E,WAAW,EAAO,MAAM,CAAC;IACzB,OAAO,CAAC,EAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,eAAe,GAAG,cAAc,GAAG,cAAc,CAAC;AAQ5F,0DAA0D;AAC1D,wBAAsB,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBhH;AAED;gCACgC;AAChC,wBAAsB,eAAe,CAAC,KAAK,SAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAaxE;AAED,iBAAiB;AACjB,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C"}

package/dist/core/audit_log.js

@@ -0,0 +1,80 @@
+/**
+ * audit_log.ts -- append-only JSONL ledger of every approval-
+ * gated or side-effectful action Forge performs (alpha.59d).
+ *
+ * Pablo rule: TODO debe ser registrado en log de auditoria.
+ *
+ * Storage: $YF_CONFIG_DIR/cache/audit_log.jsonl. Append-only.
+ * Each line is a JSON object with at minimum:
+ *   { ts, kind, summary, ... }
+ *
+ * Failure mode: best-effort. recordAudit never throws -- losing
+ * an audit row is preferable to crashing the chat turn. (The
+ * worst real case is FS full; we surface that via a Logger
+ * warning but the chat keeps working.)
+ *
+ * Distinct from:
+ *   - brain_routing.jsonl (routing decisions per turn)
+ *   - nac3 dispatch log (verb invocations -- this complements
+ *     it with approval + danger zone + outcome).
+ *
+ * Future readers: docs/AUDIT_LOG_SCHEMA.md (TBD) will pin the
+ * shape. For now keep `kind` extensible -- new actions add new
+ * kinds without breaking old readers.
+ *
+ * ASCII-only.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+function auditLogPath() {
+    const home = process.env.HOME || process.env.USERPROFILE || os.homedir();
+    const base = process.env.YF_CONFIG_DIR || path.join(home, '.yujin-forge');
+    return path.join(base, 'cache', 'audit_log.jsonl');
+}
+/** Append a single entry. Best-effort -- never throws. */
+export async function recordAudit(entry) {
+    try {
+        const p = auditLogPath();
+        await fs.mkdir(path.dirname(p), { recursive: true });
+        const full = {
+            ts: new Date().toISOString(),
+            summary: entry.summary ?? '',
+            approval_mode: entry.approval_mode ?? 'not_applicable',
+            ...entry,
+        };
+        await fs.appendFile(p, JSON.stringify(full) + '\n', 'utf-8');
+    }
+    catch (err) {
+        /* Best-effort: log to console but never crash the caller. */
+        try {
+            console.warn('[audit] append failed:', err instanceof Error ? err.message : String(err));
+        }
+        catch { /* console may itself be broken in extreme cases */ }
+    }
+}
+/** Read recent entries (newest first). Used by the panel
+ *  audit-trail view + tests. */
+export async function readRecentAudit(limit = 100) {
+    try {
+        const raw = await fs.readFile(auditLogPath(), 'utf-8');
+        const lines = raw.split('\n').filter((l) => l.trim() !== '');
+        const tail = lines.slice(-limit).reverse();
+        const out = [];
+        for (const l of tail) {
+            try {
+                out.push(JSON.parse(l));
+            }
+            catch { /* skip torn line */ }
+        }
+        return out;
+    }
+    catch {
+        return [];
+    }
+}
+/** Test seam. */
+export function _auditLogPathForTest() {
+    return auditLogPath();
+}
+//# sourceMappingURL=audit_log.js.map

package/dist/core/audit_log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit_log.js","sourceRoot":"","sources":["../../src/core/audit_log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AA6CzB,SAAS,YAAY;IACnB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;IACzE,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IAC1E,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC;AACrD,CAAC;AAED,0DAA0D;AAC1D,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAA+D;IAC/F,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,YAAY,EAAE,CAAC;QACzB,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,MAAM,IAAI,GAAe;YACvB,EAAE,EAAc,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACxC,OAAO,EAAS,KAAK,CAAC,OAAO,IAAI,EAAE;YACnC,aAAa,EAAG,KAAK,CAAC,aAAa,IAAI,gBAAgB;YACvD,GAAG,KAAK;SACK,CAAC;QAChB,MAAM,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,6DAA6D;QAC7D,IAAI,CAAC;YAAC,OAAO,CAAC,IAAI,CAAC,wBAAwB,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAAC,CAAC;QACjG,MAAM,CAAC,CAAC,mDAAmD,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAED;gCACgC;AAChC,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAAK,GAAG,GAAG;IAC/C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,EAAE,OAAO,CAAC,CAAC;QACvD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;QAC3C,MAAM,GAAG,GAAiB,EAAE,CAAC;QAC7B,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,IAAI,CAAC;gBAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAe,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,oBAAoB,CAAC,CAAC;QAC/E,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,iBAAiB;AACjB,MAAM,UAAU,oBAAoB;IAClC,OAAO,YAAY,EAAE,CAAC;AACxB,CAAC"}