@nac3/forge-cli 0.2.0-alpha.8 → 0.2.1-alpha.60

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":"AAcA,OAAO,EACL,eAAe,EAAE,gBAAgB,EAAE,uBAAuB,EAC1D,iBAAiB,EAAE,iBAAiB,GAErC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAE5D,SAAS,QAAQ,CAAC,CAAS;IACzB,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,kCAAkC,CAAC,CAAC;IAEvF,MAAM,MAAM,GAAG,KAAK;SACjB,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,6DAA6D,CAAC;SAC1E,MAAM,CAAC,QAAQ,EAAE,0BAA0B,CAAC;SAC5C,MAAM,CAAC,kBAAkB,EAAE,gDAAgD,CAAC;SAC5E,MAAM,CAAC,cAAc,EAAE,oCAAoC,CAAC;SAC5D,MAAM,CAAC,oBAAoB,EAAE,yBAAyB,CAAC;SACvD,MAAM,CAAC,kBAAkB,EAAE,0CAA0C,CAAC;SACtE,MAAM,CAAC,kBAAkB,EAAE,2DAA2D,CAAC;SACvF,MAAM,CAAC,SAAS,EAAE,sDAAsD,CAAC;SACzE,MAAM,CAAC,KAAK,EAAE,IAId,EAAE,EAAE;QACH,IAAI,GAAG,GAAG,MAAM,eAAe,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,GAAG,GAAG;gBACJ,OAAO,EAAE,CAAC;gBACV,kBAAkB,EAAE,EAAE;gBACtB,iBAAiB,EAAE,CAAC;gBACpB,YAAY,EAAE,SAAS;gBACvB,YAAY,EAAE,SAAS;aACxB,CAAC;YACF,MAAM,gBAAgB,CAAC,GAAG,CAAC,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;YAC/C,OAAO;QACT,CAAC;QACD,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC/B,GAAG,CAAC,kBAAkB,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAChD,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,kBAAkB,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC;YAC5D,GAAG,CAAC,kBAAkB,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;YAClC,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;QACD,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YAChD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1C,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;YAChE,CAAC;YACD,GAAG,CAAC,iBAAiB,GAAG,CAAC,CAAC;YAC1B,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,EAAiB,CAAC;YACvD,IAAI,CAAE,iBAAuC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1D,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAC3E,CAAC;YACD,GAAG,CAAC,YAAY,GAAG,CAAC,CAAC;YACrB,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,EAAiB,CAAC;YACvD,IAAI,CAAE,iBAAuC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1D,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAC3E,CAAC;YACD,GAAG,CAAC,YAAY,GAAG,CAAC,CAAC;YACrB,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;QACD,IAAI,OAAO;YAAE,MAAM,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAEzC,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;YACpD,MAAM,QAAQ,GAAG;gBACf,OAAO,EAAE,yDAAyD;gBAClE,MAAM,EAAE,6FAA6F;gBACrG,OAAO,EAAE,0DAA0D;aACpE,CAAC;YACF,MAAM,QAAQ,GAAG;gBACf,OAAO,EAAE,6DAA6D;gBACtE,MAAM,EAAE,yEAAyE;gBACjF,UAAU,EAAE,yDAAyD;gBACrE,WAAW,EAAE,4DAA4D;aAC1E,CAAC;YACF,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,YAAY,IAAI,SAAS,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,YAAY,IAAI,SAAS,CAAC,CAAC;YAC/C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;gBACzB,eAAe,EAAE,oBAAoB;gBACrC,UAAU,EAAE,GAAG,CAAC,kBAAkB;gBAClC,MAAM;gBACN,YAAY,EAAE,GAAG,CAAC,iBAAiB;gBACnC,YAAY,EAAE,MAAM;gBACpB,wBAAwB,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,SAAS;gBACvD,oBAAoB,EAAE,iBAAiB;gBACvC,YAAY,EAAE,MAAM;gBACpB,wBAAwB,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,SAAS;gBACvD,oBAAoB,EAAE,iBAAiB;aACxC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACf,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACvC,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,KAAK;SACF,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,8CAA8C,CAAC;SAC3D,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,EAAE;QAC/B,MAAM,CAAC,GAAG,MAAM,uBAAuB,CAAC,MAAM,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACxC,IAAI,CAAC,CAAC,CAAC,GAAG;YAAE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEL,8DAA8D;IAC9D,yBAAyB,CAAC,KAAK,CAAC,CAAC;IAEjC,KAAK,MAAM,CAAC;AACd,CAAC"}

package/dist/commands/wiring.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `yf wiring` -- CLI surface for the wiring registry (project-local).
+ *
+ * Subcommands:
+ *   yf wiring discover [--root DIR]   re-scan + persist
+ *   yf wiring list     [--json]       show current wiring
+ *   yf wiring explain                 markdown summary
+ *   yf wiring annotate <hook_id> [--note STR] [--disable | --enable]
+ *   yf wiring forget                  destructive; needs --yes
+ *
+ * Operates on the active project unless --project is given. The
+ * scanner inspects the *current working directory* by default; pass
+ * --root to point elsewhere.
+ *
+ * ASCII-only.
+ */
+import type { Command } from 'commander';
+export declare function registerWiringCommand(program: Command): void;
+//# sourceMappingURL=wiring.d.ts.map

package/dist/commands/wiring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiring.d.ts","sourceRoot":"","sources":["../../src/commands/wiring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoH5D"}

package/dist/commands/wiring.js

@@ -0,0 +1,135 @@
+import * as path from 'node:path';
+import { c, header } from '../ui/colors.js';
+import { activeSlug } from '../core/projects.js';
+import { readWiring, replaceHooks, annotateHook, forgetWiring, } from '../wiring/store.js';
+import { discoverWiring } from '../wiring/discover.js';
+async function resolveSlug(opts) {
+    if (opts.project)
+        return opts.project;
+    const s = await activeSlug();
+    if (!s) {
+        throw new Error('no active project; pass --project <slug> or set one with `yf projects switch`');
+    }
+    return s;
+}
+export function registerWiringCommand(program) {
+    const root = program
+        .command('wiring')
+        .description('Per-project CI/CD/deploy wiring registry (no re-asking).');
+    root
+        .command('discover')
+        .description('Scan the project for CI/CD/deploy hooks + persist.')
+        .option('--project <slug>', 'override active project')
+        .option('--root <dir>', 'scan this directory (default: cwd)')
+        .option('--json', 'machine-readable output')
+        .action(async (opts) => {
+        const slug = await resolveSlug(opts);
+        const projectRoot = path.resolve(opts.root ?? process.cwd());
+        const r = await discoverWiring({ project_root: projectRoot });
+        const file = await replaceHooks(slug, r.hooks, r.scanned_sha);
+        if (opts.json) {
+            process.stdout.write(JSON.stringify({
+                project: slug, scanned_sha: r.scanned_sha,
+                inspected: r.inspected, hooks: file.hooks,
+            }, null, 2) + '\n');
+            return;
+        }
+        header(c.brand('wiring.discover'));
+        process.stdout.write('  project       : ' + slug + '\n');
+        process.stdout.write('  scanned root  : ' + projectRoot + '\n');
+        process.stdout.write('  files scanned : ' + r.inspected.length + '\n');
+        process.stdout.write('  hooks found   : ' + file.hooks.length + '\n');
+        for (const h of file.hooks) {
+            process.stdout.write('   - [' + h.kind + '] ' + h.destination
+                + ' via ' + h.trigger + '  (' + h.source_file + ')\n');
+        }
+    });
+    root
+        .command('list')
+        .description('Show wiring registry contents.')
+        .option('--project <slug>', 'override active project')
+        .option('--json', 'machine-readable output')
+        .action(async (opts) => {
+        const slug = await resolveSlug(opts);
+        const file = await readWiring(slug);
+        if (opts.json) {
+            process.stdout.write(JSON.stringify(file, null, 2) + '\n');
+            return;
+        }
+        header(c.brand('wiring for ' + slug));
+        process.stdout.write('  scanned: ' + (file.scanned_at || '(never)') + '\n');
+        process.stdout.write('  hooks  : ' + file.hooks.length
+            + ' (' + file.hooks.filter((h) => !h.disabled).length + ' active)\n');
+        for (const h of file.hooks) {
+            const flag = h.disabled ? c.dim(' [disabled]') : '';
+            process.stdout.write('   - ' + h.id + flag + '\n');
+            process.stdout.write('       kind=' + h.kind + ' trigger=' + h.trigger + ' dest=' + h.destination + '\n');
+            if (h.user_annotation)
+                process.stdout.write('       note: ' + h.user_annotation + '\n');
+        }
+    });
+    root
+        .command('explain')
+        .description('Markdown summary of current wiring.')
+        .option('--project <slug>', 'override active project')
+        .action(async (opts) => {
+        const slug = await resolveSlug(opts);
+        const file = await readWiring(slug);
+        if (file.hooks.length === 0) {
+            process.stdout.write('_No wiring discovered yet. Run `yf wiring discover`._\n');
+            return;
+        }
+        process.stdout.write('# Wiring for ' + slug + '\n\n');
+        process.stdout.write('Scanned: ' + file.scanned_at + '\n\n');
+        for (const h of file.hooks) {
+            process.stdout.write('## ' + h.id + (h.disabled ? '  _(disabled)_' : '') + '\n');
+            process.stdout.write('- kind: `' + h.kind + '`\n');
+            process.stdout.write('- trigger: `' + h.trigger + '`\n');
+            process.stdout.write('- destination: `' + h.destination + '`\n');
+            process.stdout.write('- source_file: `' + h.source_file + '`\n');
+            for (const cmd of h.auto_runs_on)
+                process.stdout.write('  - run: `' + cmd + '`\n');
+            if (h.user_annotation)
+                process.stdout.write('- note: ' + h.user_annotation + '\n');
+            process.stdout.write('\n');
+        }
+    });
+    root
+        .command('annotate <hook_id>')
+        .description('Attach a note + optionally disable/enable a hook.')
+        .option('--project <slug>', 'override active project')
+        .option('--note <text>', 'free-text note (empty string clears it)')
+        .option('--disable', 'mark hook disabled (skipped in injection)')
+        .option('--enable', 're-enable a disabled hook')
+        .action(async (hook_id, opts) => {
+        const slug = await resolveSlug(opts);
+        if (opts.disable && opts.enable)
+            throw new Error('--disable and --enable are mutually exclusive');
+        const patch = {};
+        if (typeof opts.note === 'string')
+            patch.user_annotation = opts.note;
+        if (opts.disable)
+            patch.disabled = true;
+        if (opts.enable)
+            patch.disabled = false;
+        const f = await annotateHook(slug, hook_id, patch);
+        const h = f.hooks.find((x) => x.id === hook_id);
+        process.stdout.write('annotated ' + hook_id
+            + (h.disabled ? ' (disabled)' : '')
+            + (h.user_annotation ? ' note=' + JSON.stringify(h.user_annotation) : '')
+            + '\n');
+    });
+    root
+        .command('forget')
+        .description('Delete the wiring file for this project (destructive).')
+        .option('--project <slug>', 'override active project')
+        .option('--yes', 'confirm destruction')
+        .action(async (opts) => {
+        if (!opts.yes)
+            throw new Error('`yf wiring forget` requires --yes');
+        const slug = await resolveSlug(opts);
+        await forgetWiring(slug);
+        process.stdout.write('wiped wiring registry for ' + slug + '\n');
+    });
+}
+//# sourceMappingURL=wiring.js.map

package/dist/commands/wiring.js.map

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