@nac3/forge-cli 0.2.0-alpha.5 → 0.2.0-alpha.59z.119

package/dist/commands/voice.js

@@ -1,4 +1,4 @@
-import { readVoiceConfig, writeVoiceConfig, matchConfiguredWakeWord } from '../voice/config.js';
+import { readVoiceConfig, writeVoiceConfig, matchConfiguredWakeWord, ALL_STT_PROVIDERS, ALL_TTS_PROVIDERS, } from '../voice/config.js';
 import { DEFAULT_WAKE_ALIASES, mergeAliases } from '../voice/wake.js';
 import { registerVoiceSetupCommand } from './keys_setup.js';
 function splitCsv(s) {
@@ -8,16 +8,24 @@ export function registerVoiceCommand(program) {
     const voice = program.command('voice').description('Voice + wake-word configuration.');
     const config = voice
         .command('config')
-        .description('Read or update the wake-word config (aliases, distance).')
+        .description('Read or update voice config (wake word + STT/TTS provider).')
         .option('--show', 'Print the active config.')
         .option('--aliases <list>', 'Comma-separated user extra aliases (replaces).')
         .option('--add <list>', 'Comma-separated aliases to append.')
         .option('--max-distance <n>', 'Levenshtein cap (0..2).')
-        .option('--reset', 'Reset extras + max-distance to defaults.')
+        .option('--stt <provider>', 'STT provider: browser | google | whisper')
+        .option('--tts <provider>', 'TTS provider: browser | google | elevenlabs | yujin_cloud')
+        .option('--reset', 'Reset extras + max-distance + providers to defaults.')
         .action(async (opts) => {
         let cfg = await readVoiceConfig();
         if (opts.reset) {
-            cfg = { version: 1, wake_aliases_extra: [], wake_max_distance: 2 };
+            cfg = {
+                version: 1,
+                wake_aliases_extra: [],
+                wake_max_distance: 2,
+                stt_provider: 'browser',
+                tts_provider: 'browser',
+            };
             await writeVoiceConfig(cfg);
             console.log('voice config reset to defaults.');
             return;
@@ -41,15 +49,50 @@ export function registerVoiceCommand(program) {
             cfg.wake_max_distance = n;
             mutated = true;
         }
+        if (opts.stt !== undefined) {
+            const s = opts.stt.toLowerCase().trim();
+            if (!ALL_STT_PROVIDERS.includes(s)) {
+                throw new Error('--stt must be one of: ' + ALL_STT_PROVIDERS.join(', '));
+            }
+            cfg.stt_provider = s;
+            mutated = true;
+        }
+        if (opts.tts !== undefined) {
+            const t = opts.tts.toLowerCase().trim();
+            if (!ALL_TTS_PROVIDERS.includes(t)) {
+                throw new Error('--tts must be one of: ' + ALL_TTS_PROVIDERS.join(', '));
+            }
+            cfg.tts_provider = t;
+            mutated = true;
+        }
         if (mutated)
             await writeVoiceConfig(cfg);
         if (opts.show || !mutated) {
             const merged = mergeAliases(cfg.wake_aliases_extra);
+            const STT_DESC = {
+                browser: 'Web Speech API (free, instant, ES locales OK). Default.',
+                google: 'Google Cloud STT (es-AR/MX/CL/ES). Requires google_stt_key (or google_tts_key as fallback).',
+                whisper: 'OpenAI Whisper (paid, slower). Requires whisper_api_key.',
+            };
+            const TTS_DESC = {
+                browser: 'SpeechSynthesisUtterance (free, OS native voices). Default.',
+                google: 'Google Cloud TTS (Neural2 / Studio / Wavenet). Requires google_tts_key.',
+                elevenlabs: 'ElevenLabs premium voices. Requires elevenlabs_api_key.',
+                yujin_cloud: 'Central license-based gateway. Requires Yujin license_key.',
+            };
+            const sttKey = (cfg.stt_provider ?? 'browser');
+            const ttsKey = (cfg.tts_provider ?? 'browser');
             console.log(JSON.stringify({
                 builtin_aliases: DEFAULT_WAKE_ALIASES,
                 user_extra: cfg.wake_aliases_extra,
                 merged,
                 max_distance: cfg.wake_max_distance,
+                stt_provider: sttKey,
+                stt_provider_description: STT_DESC[sttKey] ?? 'unknown',
+                stt_provider_options: ALL_STT_PROVIDERS,
+                tts_provider: ttsKey,
+                tts_provider_description: TTS_DESC[ttsKey] ?? 'unknown',
+                tts_provider_options: ALL_TTS_PROVIDERS,
             }, null, 2));
         }
         else {

package/dist/commands/voice.js.map

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

package/dist/commands/workflow-coverage.d.ts

@@ -0,0 +1,30 @@
+/**
+ * `yf coverage structural` -- Phase V step 15 acceptance gate.
+ *
+ * Checks that every NAC-3 manifest element is exercised by at
+ * least one e2e test. Required by SQ Sec 14 + PRODUCT_WORKFLOW
+ * step 15 for any block to enter "green" status.
+ *
+ * Strategy:
+ *   1. Read the manifest from src/nac/manifest.ts (parsed
+ *      heuristically for element ids).
+ *   2. Scan tests/ for occurrences of each id (data-nac-id
+ *      assertions, locator strings, etc).
+ *   3. Compute (covered ids) / (total ids) ratio.
+ *   4. Exit 0 iff coverage === 100%; exit 1 otherwise so CI
+ *      can gate on it.
+ *
+ * Pure read-only. Output: counts + missing ids. Optional
+ * --if-failing-exit-1 flag so CI fails the job (default true).
+ *
+ * ASCII-only.
+ */
+import type { Command } from 'commander';
+export interface CoverageOptions {
+    cwd?: string;
+    ifFailingExit1?: boolean;
+    manifest?: string;
+}
+export declare function runCoverage(opts: CoverageOptions): Promise<void>;
+export declare function registerCoverageCommand(program: Command): void;
+//# sourceMappingURL=workflow-coverage.d.ts.map

package/dist/commands/workflow-coverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-coverage.d.ts","sourceRoot":"","sources":["../../src/commands/workflow-coverage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAoCD,wBAAsB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAwDtE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAa9D"}

package/dist/commands/workflow-coverage.js

@@ -0,0 +1,138 @@
+/**
+ * `yf coverage structural` -- Phase V step 15 acceptance gate.
+ *
+ * Checks that every NAC-3 manifest element is exercised by at
+ * least one e2e test. Required by SQ Sec 14 + PRODUCT_WORKFLOW
+ * step 15 for any block to enter "green" status.
+ *
+ * Strategy:
+ *   1. Read the manifest from src/nac/manifest.ts (parsed
+ *      heuristically for element ids).
+ *   2. Scan tests/ for occurrences of each id (data-nac-id
+ *      assertions, locator strings, etc).
+ *   3. Compute (covered ids) / (total ids) ratio.
+ *   4. Exit 0 iff coverage === 100%; exit 1 otherwise so CI
+ *      can gate on it.
+ *
+ * Pure read-only. Output: counts + missing ids. Optional
+ * --if-failing-exit-1 flag so CI fails the job (default true).
+ *
+ * ASCII-only.
+ */
+import path from 'node:path';
+import { promises as fs } from 'node:fs';
+import { c, header } from '../ui/colors.js';
+const TEST_FILE_RE = /\.(test|spec|e2e)\.(t|j)sx?$/;
+const SKIP_DIRS = new Set(['node_modules', '.git', 'dist', 'build', 'coverage', '.cache']);
+async function readManifest(p) {
+    try {
+        const src = await fs.readFile(p, 'utf-8');
+        /* Heuristic id grep. Matches:
+         *    "checkout.confirm_button"
+         *    id: "checkout.confirm_button"
+         *    data-nac-id="checkout.confirm_button" */
+        const idRegex = /["'`]([a-z][a-z0-9_]*(?:\.[a-z0-9_]+)+)["'`]/g;
+        const ids = new Set();
+        let m;
+        while ((m = idRegex.exec(src)) !== null) {
+            if (m[1])
+                ids.add(m[1]);
+        }
+        return [...ids];
+    }
+    catch {
+        return [];
+    }
+}
+async function walkTestFiles(root, out) {
+    let entries;
+    try {
+        entries = await fs.readdir(root, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const e of entries) {
+        if (SKIP_DIRS.has(e.name))
+            continue;
+        const p = path.join(root, e.name);
+        if (e.isDirectory())
+            await walkTestFiles(p, out);
+        else if (e.isFile() && TEST_FILE_RE.test(e.name))
+            out.push(p);
+    }
+}
+export async function runCoverage(opts) {
+    header('Yujin Forge -- coverage structural');
+    console.log('');
+    const projectRoot = opts.cwd ? path.resolve(opts.cwd) : process.cwd();
+    const manifestPath = path.resolve(projectRoot, opts.manifest || 'src/nac/manifest.ts');
+    const ids = await readManifest(manifestPath);
+    if (ids.length === 0) {
+        console.log(c.warn('Manifest no encontrado o vacio: ' + manifestPath));
+        console.log(c.dim('Si no tenes manifest todavia, este check no aplica.'));
+        return;
+    }
+    const testRoots = [
+        path.join(projectRoot, 'tests'),
+        path.join(projectRoot, 'src', '__tests__'),
+        path.join(projectRoot, 'e2e'),
+    ];
+    const testFiles = [];
+    for (const r of testRoots)
+        await walkTestFiles(r, testFiles);
+    /* For each id, check if it appears in ANY test file. */
+    const filesContent = [];
+    for (const f of testFiles) {
+        try {
+            filesContent.push({ path: f, text: await fs.readFile(f, 'utf-8') });
+        }
+        catch { /* skip */ }
+    }
+    const covered = [];
+    const missing = [];
+    for (const id of ids) {
+        const hit = filesContent.some(({ text }) => text.includes(id));
+        if (hit)
+            covered.push(id);
+        else
+            missing.push(id);
+    }
+    const pct = ids.length === 0 ? 100 : Math.round((covered.length / ids.length) * 100);
+    console.log(c.dim('Manifest:   ') + manifestPath);
+    console.log(c.dim('Total ids:  ') + c.brand(String(ids.length)));
+    console.log(c.dim('Covered:    ') + c.success(String(covered.length)));
+    console.log(c.dim('Missing:    ') + (missing.length > 0 ? c.error(String(missing.length)) : c.success('0')));
+    console.log(c.dim('Coverage:   ') + (pct === 100 ? c.success(pct + '%') : c.error(pct + '%')));
+    if (missing.length > 0) {
+        console.log('');
+        console.log(c.warn('IDs sin test:'));
+        for (const m of missing.slice(0, 30))
+            console.log('  - ' + m);
+        if (missing.length > 30)
+            console.log(c.dim('  ... y ' + (missing.length - 30) + ' mas'));
+    }
+    /* CI gate: exit 1 when coverage < 100% AND the flag is on. */
+    if (pct < 100 && (opts.ifFailingExit1 !== false)) {
+        process.exitCode = 1;
+    }
+}
+export function registerCoverageCommand(program) {
+    const coverage = program.command('coverage')
+        .description('Phase V acceptance: verify NAC-3 structural coverage.');
+    coverage.command('structural')
+        .description('100% of manifest ids must be exercised by at least one test.')
+        .option('--cwd <path>', 'project root')
+        .option('--manifest <path>', 'manifest source (default src/nac/manifest.ts)')
+        .option('--if-failing-exit-1', 'exit 1 when coverage < 100% (default true)', true)
+        .action(async (opts) => {
+        try {
+            await runCoverage(opts);
+        }
+        catch (err) {
+            console.error(c.error(String(err instanceof Error ? err.message : err)));
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=workflow-coverage.js.map

package/dist/commands/workflow-coverage.js.map

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

package/dist/core/brain_config.d.ts

@@ -0,0 +1,33 @@
+/** Provider id matches the slot prefix in the vault
+ *  (byok_<provider>_api_key). */
+export type BrainProvider = 'anthropic' | 'openai' | 'google_ai' | 'deepseek' | 'xai' | 'mistral' | 'cohere' | 'yujin_managed';
+export declare const ALL_BRAIN_PROVIDERS: readonly BrainProvider[];
+/** Vault slot name a given provider stores its key under. The
+ *  yujin_managed virtual provider has no client-side key (the
+ *  worker holds the real provider key); the secret needed for
+ *  auth is the yf_server_api_key in the regular vault, not a
+ *  byok_ slot. We return a stable placeholder so callers that
+ *  query slot existence get a meaningful answer. */
+export declare function vaultSlotForProvider(p: BrainProvider): string;
+export interface TierBinding {
+    provider: BrainProvider;
+    model: string;
+}
+export interface BrainConfig {
+    version: 1;
+    eco: TierBinding;
+    frontier: TierBinding;
+    /** Default tier when the cost router cannot infer from
+     *  workflow state / verb_id. */
+    chat_default_tier: 'eco' | 'frontier';
+}
+export declare function defaultBrainConfig(): BrainConfig;
+export declare function readBrainConfig(): Promise<BrainConfig>;
+export declare function writeBrainConfig(cfg: BrainConfig): Promise<void>;
+/** Mutate one tier without losing the other. */
+export declare function setTierBinding(tier: 'eco' | 'frontier', provider: BrainProvider, model: string): Promise<BrainConfig>;
+/** Set the default tier for chat turns the router cannot infer. */
+export declare function setChatDefaultTier(tier: 'eco' | 'frontier'): Promise<BrainConfig>;
+/** Reset to factory defaults. */
+export declare function resetBrainConfig(): Promise<BrainConfig>;
+//# sourceMappingURL=brain_config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"brain_config.d.ts","sourceRoot":"","sources":["../../src/core/brain_config.ts"],"names":[],"mappings":"AA+BA;iCACiC;AACjC,MAAM,MAAM,aAAa,GACrB,WAAW,GACX,QAAQ,GACR,WAAW,GACX,UAAU,GACV,KAAK,GACL,SAAS,GACT,QAAQ,GAMR,eAAe,CAAC;AAEpB,eAAO,MAAM,mBAAmB,EAAE,SAAS,aAAa,EAGvD,CAAC;AAEF;;;;;oDAKoD;AACpD,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAW7D;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,aAAa,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,CAAC,CAAC;IACX,GAAG,EAAE,WAAW,CAAC;IACjB,QAAQ,EAAE,WAAW,CAAC;IACtB;oCACgC;IAChC,iBAAiB,EAAE,KAAK,GAAG,UAAU,CAAC;CACvC;AAED,wBAAgB,kBAAkB,IAAI,WAAW,CAOhD;AA2BD,wBAAsB,eAAe,IAAI,OAAO,CAAC,WAAW,CAAC,CAiB5D;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAMtE;AAED,gDAAgD;AAChD,wBAAsB,cAAc,CAClC,IAAI,EAAE,KAAK,GAAG,UAAU,EACxB,QAAQ,EAAE,aAAa,EACvB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,WAAW,CAAC,CAKtB;AAED,mEAAmE;AACnE,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,KAAK,GAAG,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAKvF;AAED,iCAAiC;AACjC,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,WAAW,CAAC,CAI7D"}