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

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/commands/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,OAAO,EAAY,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAyB,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAKjF,MAAM,WAAW,wBAAwB;IACvC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE;QACpB,GAAG,EAAa,eAAe,CAAC;QAChC,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAI,MAAM,CAAC;QACvB,YAAY,EAAI,MAAM,CAAC;QACvB,aAAa,EAAG,MAAM,CAAC;KACxB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACvB;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,GAAE,wBAA6B,GAAG,IAAI,CAkRhG"}

package/dist/commands/agent.js

@@ -0,0 +1,281 @@
+import { listAgentDefinitions, getAgentDefinition, filterByStatus, saveAgentDefinition, softDeleteAgent } from '../agents/store.js';
+import { snapshotAgentConfig } from '../agents/config_resolver.js';
+import { DEFAULT_AGENTS } from '../agents/defaults.js';
+import { runAgent } from '../agents/runner.js';
+export function registerAgentCommand(program, deps = {}) {
+    const agent = program.command('agent')
+        .description('Agent orchestrator (HITO 5) -- list, inspect, configure.');
+    agent.command('list')
+        .description('List local agents.')
+        .option('--status <s>', 'filter by status (active|paused|deleted|auto_revoked)')
+        .option('--json', 'emit JSON instead of a table')
+        .action(async (opts) => {
+        let defs = await listAgentDefinitions();
+        if (opts.status) {
+            const want = opts.status;
+            defs = filterByStatus(defs, want);
+        }
+        if (opts.json) {
+            console.log(JSON.stringify(defs, null, 2));
+            return;
+        }
+        if (defs.length === 0) {
+            console.log('No agents registered.' + (opts.status ? ' (filter: status=' + opts.status + ')' : ''));
+            console.log('Slice 2 will ship `yf agent install --defaults` to seed brain-matrix-nightly-watcher + web-search.');
+            return;
+        }
+        console.log('  slug                                 status         tier      trigger     description');
+        console.log('  ' + '-'.repeat(96));
+        for (const d of defs) {
+            const slug = d.slug.padEnd(36, ' ').slice(0, 36);
+            const status = d.status.padEnd(14, ' ').slice(0, 14);
+            const tier = d.brain_tier.padEnd(9, ' ').slice(0, 9);
+            const trig = d.trigger.kind.padEnd(11, ' ').slice(0, 11);
+            const desc = (d.description || '').slice(0, 40);
+            console.log('  ' + slug + ' ' + status + ' ' + tier + ' ' + trig + ' ' + desc);
+        }
+        console.log('');
+        console.log('Total: ' + defs.length + ' agent(s).');
+    });
+    agent.command('show')
+        .description('Show a single agent definition.')
+        .argument('<slug>', 'agent slug')
+        .option('--json', 'emit JSON instead of a table')
+        .action(async (slug, opts) => {
+        const def = await getAgentDefinition(slug);
+        if (!def) {
+            console.error('No agent with slug ' + JSON.stringify(slug) + '.');
+            console.error('Run `yf agent list` to see registered slugs.');
+            process.exitCode = 1;
+            return;
+        }
+        if (opts.json) {
+            console.log(JSON.stringify(def, null, 2));
+            return;
+        }
+        console.log('Agent: ' + def.slug);
+        console.log('  Name:        ' + def.name);
+        console.log('  Description: ' + def.description);
+        console.log('  Status:      ' + def.status + (def.revoked_reason ? ' (' + def.revoked_reason + ')' : ''));
+        console.log('  Brain tier:  ' + def.brain_tier);
+        console.log('  Trigger:     ' + def.trigger.kind + ' ' + JSON.stringify(def.trigger.config));
+        console.log('  Created:     ' + new Date(def.created_at).toISOString());
+        console.log('  Updated:     ' + new Date(def.updated_at).toISOString());
+        console.log('');
+        console.log('  can_call:         [' + def.can_call.join(', ') + ']');
+        console.log('  can_be_called_by: [' + def.can_be_called_by.join(', ') + ']');
+        console.log('  allowed_verbs:    ' + (def.allowed_verbs.length === 0 ? '(all from manifest)' : '[' + def.allowed_verbs.join(', ') + ']'));
+        if (def.prompt_addition) {
+            console.log('');
+            console.log('  prompt_addition:');
+            for (const line of def.prompt_addition.split(/\r?\n/)) {
+                console.log('    ' + line);
+            }
+        }
+    });
+    agent.command('install')
+        .description('Install agent definitions. With --defaults, seeds brain-matrix-nightly-watcher + web-search.')
+        .option('--defaults', 'seed the shipped default agents')
+        .option('--force', 'overwrite existing definitions (used with --defaults)')
+        .option('--json', 'emit JSON summary')
+        .action(async (opts) => {
+        if (!opts.defaults) {
+            console.error('install: pass --defaults to seed the shipped defaults.');
+            console.error('Authoring custom agents from a file lands in a later slice.');
+            process.exitCode = 1;
+            return;
+        }
+        const created = [];
+        const skipped = [];
+        const overwritten = [];
+        for (const def of DEFAULT_AGENTS) {
+            const existing = await getAgentDefinition(def.slug);
+            if (existing && !opts.force) {
+                skipped.push(def.slug);
+                continue;
+            }
+            const ok = await saveAgentDefinition(def);
+            if (!ok) {
+                console.error('saveAgentDefinition failed for ' + def.slug);
+                process.exitCode = 1;
+                return;
+            }
+            if (existing)
+                overwritten.push(def.slug);
+            else
+                created.push(def.slug);
+        }
+        if (opts.json) {
+            console.log(JSON.stringify({ created, overwritten, skipped }, null, 2));
+            return;
+        }
+        if (created.length > 0)
+            console.log('Created:     ' + created.join(', '));
+        if (overwritten.length > 0)
+            console.log('Overwrote:   ' + overwritten.join(', '));
+        if (skipped.length > 0)
+            console.log('Skipped (already present, use --force to overwrite): ' + skipped.join(', '));
+        if (created.length === 0 && overwritten.length === 0 && skipped.length === 0) {
+            console.log('Nothing to do.');
+        }
+    });
+    agent.command('delete')
+        .description('Soft-delete an agent. Moves to ~/.yujin-forge/agents/deleted/<slug>__<ts>/ for the grace period (agent.deletion.grace_period_days).')
+        .argument('<slug>', 'agent slug')
+        .option('--yes', 'skip confirmation (required when not on a TTY)')
+        .option('--json', 'emit JSON summary')
+        .action(async (slug, opts) => {
+        const existing = await getAgentDefinition(slug);
+        if (!existing) {
+            console.error('No agent with slug ' + JSON.stringify(slug) + '.');
+            process.exitCode = 1;
+            return;
+        }
+        if (!opts.yes) {
+            /* Best-effort confirmation. On non-TTY (CI), require --yes. */
+            if (!process.stdin.isTTY) {
+                console.error('Refusing to delete without --yes on a non-TTY.');
+                process.exitCode = 1;
+                return;
+            }
+            process.stdout.write('Delete agent ' + JSON.stringify(slug) + '? (y/N) ');
+            const ok = await new Promise((resolve) => {
+                process.stdin.once('data', (b) => resolve(/^y/i.test(b.toString().trim())));
+                process.stdin.resume();
+            });
+            if (!ok) {
+                console.log('Aborted.');
+                return;
+            }
+        }
+        const moved = await softDeleteAgent(slug);
+        if (!moved) {
+            console.error('softDeleteAgent returned false for ' + slug);
+            process.exitCode = 1;
+            return;
+        }
+        if (opts.json) {
+            console.log(JSON.stringify({ slug, deleted: true }, null, 2));
+        }
+        else {
+            console.log('Deleted ' + slug + '. The agent + its runs are in the deleted/ partition.');
+        }
+    });
+    agent.command('run')
+        .description('Run one agent end-to-end. Default: stub step (Director sprint slice 8 lifecycle surface). With --real: live LLM dispatch via the production factory (slice 15e) -- requires anthropic_api_key in the vault.')
+        .argument('<slug>', 'agent slug to run')
+        .option('--reason <r>', 'trigger reason recorded on the AgentRun', 'cli-run')
+        .option('--no-persist', 'do not write the AgentRun to ~/.yujin-forge/agents/by-slug/<slug>/runs/')
+        .option('--json', 'emit JSON instead of human-readable summary')
+        .option('--real', 'use the real LLM step (slice 15e factory) instead of the stub')
+        .action(async (slug, opts) => {
+        const def = await getAgentDefinition(slug);
+        if (!def) {
+            console.error('No agent with slug ' + JSON.stringify(slug) + '. Run `yf agent list` to see registered slugs.');
+            process.exitCode = 1;
+            return;
+        }
+        const triggerReason = opts.reason || 'cli-run';
+        let stepFn;
+        if (opts.real) {
+            /* Live LLM step. Tests inject deps.makeRealStep; production
+             * falls back to the canonical builder that constructs
+             * Claude from the vault + wires the factory. */
+            const builder = deps.makeRealStep ?? (async (args) => {
+                const { makeRealStep } = await import('../agents/cli_real.js');
+                return makeRealStep({
+                    def: args.def,
+                    trigger_reason: args.trigger_reason,
+                    project_root: args.project_root,
+                    project_name: args.project_name,
+                    forge_version: args.forge_version,
+                });
+            });
+            try {
+                stepFn = await builder({
+                    def,
+                    trigger_reason: triggerReason,
+                    project_root: process.cwd(),
+                    project_name: def.name,
+                    forge_version: 'cli',
+                });
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                console.error('Failed to build real LLM step: ' + msg);
+                if (err && typeof err === 'object' && err.code === 'no_claude_key') {
+                    console.error('');
+                    console.error('Tip: run `yf keys setup --provider anthropic --key <KEY>` to load a key.');
+                }
+                process.exitCode = 1;
+                return;
+            }
+        }
+        else {
+            /* Stub step -- echoes that the agent ran + returns done.
+             * Default to keep the CLI usable without an API key. */
+            stepFn = async () => ({
+                text: 'cli stub: agent "' + slug + '" lifecycle exercised (no LLM call).',
+                tokens_in: 0,
+                tokens_out: 0,
+                tool_calls: 0,
+                done: true,
+            });
+        }
+        const run = await runAgent(def, {
+            trigger_kind: 'manual',
+            trigger_reason: triggerReason,
+            step: stepFn,
+            persist: opts.persist !== false,
+        });
+        if (opts.json) {
+            console.log(JSON.stringify(run, null, 2));
+            process.exitCode = run.status === 'succeeded' ? 0 : 2;
+            return;
+        }
+        console.log('Run: ' + run.id);
+        console.log('  Slug:       ' + run.slug);
+        console.log('  Status:     ' + run.status + (run.kill_reason ? ' (' + run.kill_reason + ')' : ''));
+        console.log('  Trigger:    ' + run.trigger_kind + ' -- ' + run.trigger_reason);
+        console.log('  Started:    ' + new Date(run.started_at).toISOString());
+        if (run.ended_at)
+            console.log('  Ended:      ' + new Date(run.ended_at).toISOString());
+        console.log('  Tokens:     in=' + run.tokens_in + ' out=' + run.tokens_out);
+        console.log('  Tool calls: ' + run.tool_calls);
+        if (run.last_reply_summary) {
+            console.log('  Reply:      ' + run.last_reply_summary);
+        }
+        if (opts.persist === false) {
+            console.log('');
+            console.log('Note: --no-persist set, this run was NOT written to disk.');
+        }
+        process.exitCode = run.status === 'succeeded' ? 0 : 2;
+    });
+    agent.command('doctor')
+        .description('Print effective agent config (every key + source).')
+        .option('--json', 'emit JSON instead of a table')
+        .action(async (opts) => {
+        const snap = await snapshotAgentConfig();
+        if (opts.json) {
+            console.log(JSON.stringify(snap, null, 2));
+            return;
+        }
+        console.log('Agent orchestrator config (every key, every source)');
+        console.log('');
+        console.log('  key                                              source    value');
+        console.log('  ' + '-'.repeat(80));
+        for (const row of snap) {
+            const k = row.key.padEnd(50, ' ').slice(0, 50);
+            const s = row.source.padEnd(9, ' ');
+            console.log('  ' + k + ' ' + s + ' ' + JSON.stringify(row.value));
+        }
+        console.log('');
+        console.log('Total: ' + snap.length + ' config keys.');
+        console.log('');
+        console.log('Override hierarchy (highest precedence first):');
+        console.log('  1. env: YF_AGENT_<UPPER_SNAKE> = <value>');
+        console.log('  2. user: ~/.yujin-forge/agents/config.json key/value');
+        console.log('  3. default (published in src/agents/config_schema.ts)');
+    });
+}
+//# sourceMappingURL=agent.js.map

package/dist/commands/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/commands/agent.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,cAAc,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACpI,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAe,MAAM,qBAAqB,CAAC;AAgB5D,MAAM,UAAU,oBAAoB,CAAC,OAAgB,EAAE,OAAiC,EAAE;IACxF,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;SACnC,WAAW,CAAC,0DAA0D,CAAC,CAAC;IAE3E,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;SAClB,WAAW,CAAC,oBAAoB,CAAC;SACjC,MAAM,CAAC,cAAc,EAAE,uDAAuD,CAAC;SAC/E,MAAM,CAAC,QAAQ,EAAE,8BAA8B,CAAC;SAChD,MAAM,CAAC,KAAK,EAAE,IAAyC,EAAE,EAAE;QAC1D,IAAI,IAAI,GAAG,MAAM,oBAAoB,EAAE,CAAC;QACxC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,GAAG,IAAI,CAAC,MAA+B,CAAC;YAClD,IAAI,GAAG,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACpC,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC3C,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,uBAAuB,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,mBAAmB,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACpG,OAAO,CAAC,GAAG,CAAC,oGAAoG,CAAC,CAAC;YAClH,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,yFAAyF,CAAC,CAAC;QACvG,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACnC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,MAAM,IAAI,GAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnD,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACrD,MAAM,IAAI,GAAK,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACvD,MAAM,IAAI,GAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3D,MAAM,IAAI,GAAK,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAClD,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,GAAG,GAAG,GAAG,MAAM,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC;QACjF,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEL,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;SAClB,WAAW,CAAC,iCAAiC,CAAC;SAC9C,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;SAChC,MAAM,CAAC,QAAQ,EAAE,8BAA8B,CAAC;SAChD,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,IAAwB,EAAE,EAAE;QACvD,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,CAAC,KAAK,CAAC,qBAAqB,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;YAClE,OAAO,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;YAC9D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC1C,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,SAAS,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,iBAAiB,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,iBAAiB,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,iBAAiB,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,cAAc,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1G,OAAO,CAAC,GAAG,CAAC,iBAAiB,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,iBAAiB,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7F,OAAO,CAAC,GAAG,CAAC,iBAAiB,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QACxE,OAAO,CAAC,GAAG,CAAC,iBAAiB,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QACxE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,uBAAuB,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;QACrE,OAAO,CAAC,GAAG,CAAC,uBAAuB,GAAG,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;QAC7E,OAAO,CAAC,GAAG,CAAC,sBAAsB,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;QAC1I,IAAI,GAAG,CAAC,eAAe,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;YAClC,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;gBACtD,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;SACrB,WAAW,CAAC,8FAA8F,CAAC;SAC3G,MAAM,CAAC,YAAY,EAAE,iCAAiC,CAAC;SACvD,MAAM,CAAC,SAAS,EAAE,uDAAuD,CAAC;SAC1E,MAAM,CAAC,QAAQ,EAAE,mBAAmB,CAAC;SACrC,MAAM,CAAC,KAAK,EAAE,IAA6D,EAAE,EAAE;QAC9E,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,OAAO,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;YACxE,OAAO,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAC;YAC7E,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,WAAW,GAAa,EAAE,CAAC;QACjC,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;YACjC,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACpD,IAAI,QAAQ,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC5B,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACvB,SAAS;YACX,CAAC;YACD,MAAM,EAAE,GAAG,MAAM,mBAAmB,CAAC,GAAG,CAAC,CAAC;YAC1C,IAAI,CAAC,EAAE,EAAE,CAAC;gBACR,OAAO,CAAC,KAAK,CAAC,iCAAiC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;gBAC5D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;gBACrB,OAAO;YACT,CAAC;YACD,IAAI,QAAQ;gBAAE,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;;gBAC3B,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACxE,OAAO;QACT,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAM,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9E,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAClF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAM,OAAO,CAAC,GAAG,CAAC,uDAAuD,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACtH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7E,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;SACpB,WAAW,CAAC,qIAAqI,CAAC;SAClJ,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;SAChC,MAAM,CAAC,OAAO,EAAE,gDAAgD,CAAC;SACjE,MAAM,CAAC,QAAQ,EAAE,mBAAmB,CAAC;SACrC,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,IAAuC,EAAE,EAAE;QACtE,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,CAAC,KAAK,CAAC,qBAAqB,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;YAClE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YACd,+DAA+D;YAC/D,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;gBACzB,OAAO,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;gBAChE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;gBACrB,OAAO;YACT,CAAC;YACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;YAC1E,MAAM,EAAE,GAAG,MAAM,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;gBAChD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;gBAC5E,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACzB,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,EAAE,EAAE,CAAC;gBACR,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;gBACxB,OAAO;YACT,CAAC;QACH,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,qCAAqC,GAAG,IAAI,CAAC,CAAC;YAC5D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAChE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,UAAU,GAAG,IAAI,GAAG,uDAAuD,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;SACjB,WAAW,CAAC,6MAA6M,CAAC;SAC1N,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;SACvC,MAAM,CAAC,cAAc,EAAE,yCAAyC,EAAE,SAAS,CAAC;SAC5E,MAAM,CAAC,cAAc,EAAE,yEAAyE,CAAC;SACjG,MAAM,CAAC,QAAQ,EAAE,6CAA6C,CAAC;SAC/D,MAAM,CAAC,QAAQ,EAAE,+DAA+D,CAAC;SACjF,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,IAA4E,EAAE,EAAE;QAC3G,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,CAAC,KAAK,CAAC,qBAAqB,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,gDAAgD,CAAC,CAAC;YAC/G,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,IAAI,SAAS,CAAC;QAC/C,IAAI,MAAc,CAAC;QACnB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd;;4DAEgD;YAChD,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;gBACnD,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;gBAC/D,OAAO,YAAY,CAAC;oBAClB,GAAG,EAAa,IAAI,CAAC,GAAG;oBACxB,cAAc,EAAE,IAAI,CAAC,cAAc;oBACnC,YAAY,EAAI,IAAI,CAAC,YAAY;oBACjC,YAAY,EAAI,IAAI,CAAC,YAAY;oBACjC,aAAa,EAAG,IAAI,CAAC,aAAa;iBACnC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YACH,IAAI,CAAC;gBACH,MAAM,GAAG,MAAM,OAAO,CAAC;oBACrB,GAAG;oBACH,cAAc,EAAE,aAAa;oBAC7B,YAAY,EAAI,OAAO,CAAC,GAAG,EAAE;oBAC7B,YAAY,EAAI,GAAG,CAAC,IAAI;oBACxB,aAAa,EAAG,KAAK;iBACtB,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC7D,OAAO,CAAC,KAAK,CAAC,iCAAiC,GAAG,GAAG,CAAC,CAAC;gBACvD,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAK,GAAyB,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;oBAC1F,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;oBAClB,OAAO,CAAC,KAAK,CAAC,0EAA0E,CAAC,CAAC;gBAC5F,CAAC;gBACD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;gBACrB,OAAO;YACT,CAAC;QACH,CAAC;aAAM,CAAC;YACN;oEACwD;YACxD,MAAM,GAAG,KAAK,IAAI,EAAE,CAAC,CAAC;gBACpB,IAAI,EAAE,mBAAmB,GAAG,IAAI,GAAG,sCAAsC;gBACzE,SAAS,EAAG,CAAC;gBACb,UAAU,EAAE,CAAC;gBACb,UAAU,EAAE,CAAC;gBACb,IAAI,EAAQ,IAAI;aACjB,CAAC,CAAC;QACL,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE;YAC9B,YAAY,EAAI,QAAQ;YACxB,cAAc,EAAE,aAAa;YAC7B,IAAI,EAAY,MAAM;YACtB,OAAO,EAAS,IAAI,CAAC,OAAO,KAAK,KAAK;SACvC,CAAC,CAAC;QACH,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC1C,OAAO,CAAC,QAAQ,GAAG,GAAG,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACtD,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACnG,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,GAAG,CAAC,YAAY,GAAG,MAAM,GAAG,GAAG,CAAC,cAAc,CAAC,CAAC;QAC/E,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QACvE,IAAI,GAAG,CAAC,QAAQ;YAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QACvF,OAAO,CAAC,GAAG,CAAC,mBAAmB,GAAG,GAAG,CAAC,SAAS,GAAG,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC;QAC5E,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC;QAC/C,IAAI,GAAG,CAAC,kBAAkB,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,GAAG,CAAC,kBAAkB,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC;QAC3E,CAAC;QACD,OAAO,CAAC,QAAQ,GAAG,GAAG,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEL,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;SACpB,WAAW,CAAC,oDAAoD,CAAC;SACjE,MAAM,CAAC,QAAQ,EAAE,8BAA8B,CAAC;SAChD,MAAM,CAAC,KAAK,EAAE,IAAwB,EAAE,EAAE;QACzC,MAAM,IAAI,GAAG,MAAM,mBAAmB,EAAE,CAAC;QACzC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC3C,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;QACnE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,oEAAoE,CAAC,CAAC;QAClF,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACnC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/C,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,GAAG,eAAe,CAAC,CAAC;QACvD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;QAC9D,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;QAC1D,OAAO,CAAC,GAAG,CAAC,wDAAwD,CAAC,CAAC;QACtE,OAAO,CAAC,GAAG,CAAC,yDAAyD,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/approve.d.ts

@@ -0,0 +1,32 @@
+/**
+ * `yf approve <doc...>` -- Phase IV step 13 of PRODUCT_WORKFLOW.md.
+ *
+ * The unbreakable gate. Forge refuses to proceed to Phase V
+ * (build) until the user has explicitly approved the 3 spec
+ * documents (RFP + arch + design) by their current sha256.
+ *
+ * Usage:
+ *   yf approve rfp                       approve one doc
+ *   yf approve rfp arch design          approve all three (batch)
+ *   yf approve --list                   show approval state
+ *   yf approve --revoke <doc>           revoke an approval
+ *
+ * Approval persists workflow.approvals.<doc> = {
+ *   approved_at:    ISO,
+ *   version_sha256: sha of the spec file at approval time
+ * }
+ *
+ * If the doc file changes after approval, Forge detects the sha
+ * mismatch + treats the approval as stale -- user must re-approve.
+ *
+ * ASCII-only.
+ */
+import type { Command } from 'commander';
+export interface ApproveOptions {
+    cwd?: string;
+    list?: boolean;
+    revoke?: string;
+}
+export declare function runApprove(targets: string[], opts: ApproveOptions): Promise<void>;
+export declare function registerApproveCommand(program: Command): void;
+//# sourceMappingURL=approve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"approve.d.ts","sourceRoot":"","sources":["../../src/commands/approve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAczC,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAK,MAAM,CAAC;IAChB,IAAI,CAAC,EAAI,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAuGD,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAsDvF;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAc7D"}

package/dist/commands/approve.js

@@ -0,0 +1,198 @@
+/**
+ * `yf approve <doc...>` -- Phase IV step 13 of PRODUCT_WORKFLOW.md.
+ *
+ * The unbreakable gate. Forge refuses to proceed to Phase V
+ * (build) until the user has explicitly approved the 3 spec
+ * documents (RFP + arch + design) by their current sha256.
+ *
+ * Usage:
+ *   yf approve rfp                       approve one doc
+ *   yf approve rfp arch design          approve all three (batch)
+ *   yf approve --list                   show approval state
+ *   yf approve --revoke <doc>           revoke an approval
+ *
+ * Approval persists workflow.approvals.<doc> = {
+ *   approved_at:    ISO,
+ *   version_sha256: sha of the spec file at approval time
+ * }
+ *
+ * If the doc file changes after approval, Forge detects the sha
+ * mismatch + treats the approval as stale -- user must re-approve.
+ *
+ * ASCII-only.
+ */
+import path from 'node:path';
+import { promises as fs } from 'node:fs';
+import { createHash } from 'node:crypto';
+import prompts from 'prompts';
+import { c, header } from '../ui/colors.js';
+import { readWorkflow, patchWorkflowGroup, } from '../workflow/state.js';
+const ALL_DOCS = ['rfp', 'arch', 'design'];
+function sha256(text) {
+    return createHash('sha256').update(text, 'utf-8').digest('hex');
+}
+async function listState(projectRoot) {
+    const wf = await readWorkflow(projectRoot);
+    console.log(c.brand('Approval state:'));
+    console.log('');
+    for (const k of ALL_DOCS) {
+        const spec = wf.specs?.[k];
+        const apr = wf.approvals?.[k];
+        if (!spec) {
+            console.log('  ' + c.dim(k.padEnd(8)) + c.warn(' -- spec not generated yet'));
+            continue;
+        }
+        if (!apr) {
+            console.log('  ' + c.brand(k.padEnd(8)) + c.warn(' -- NOT approved (' + spec.doc_path + ', v' + spec.version + ')'));
+            continue;
+        }
+        const stale = apr.version_sha256 !== spec.sha256;
+        if (stale) {
+            console.log('  ' + c.brand(k.padEnd(8)) + c.warn(' -- STALE (approved sha != current sha, re-approval needed)'));
+        }
+        else {
+            console.log('  ' + c.brand(k.padEnd(8)) + c.success(' -- approved at ' + apr.approved_at));
+        }
+    }
+    console.log('');
+}
+async function approveOne(projectRoot, kind) {
+    const wf = await readWorkflow(projectRoot);
+    const spec = wf.specs?.[kind];
+    if (!spec) {
+        console.log(c.error('Spec "' + kind + '" no generado todavia. Corre primero ') + c.code('yf spec ' + kind));
+        return false;
+    }
+    /* Re-read the file to ensure the current sha matches what was
+     * stored when the spec ran. If the user edited the file by hand
+     * between spec generation and approve, we want them to know. */
+    const abs = path.join(projectRoot, spec.doc_path);
+    let body;
+    try {
+        body = await fs.readFile(abs, 'utf-8');
+    }
+    catch (err) {
+        console.log(c.error('No se pudo leer ' + spec.doc_path + ': ' + String(err instanceof Error ? err.message : err)));
+        return false;
+    }
+    const currentSha = sha256(body);
+    if (currentSha !== spec.sha256) {
+        console.log(c.warn('  ' + kind + ': el archivo cambio desde la generacion.'));
+        console.log(c.dim('    Stored sha: ' + spec.sha256.slice(0, 16) + '...'));
+        console.log(c.dim('    Current sha: ' + currentSha.slice(0, 16) + '...'));
+        const confirm = await prompts({
+            type: 'select',
+            name: 'choice',
+            message: '  Aprobar la version CURRENT (con tus ediciones)?',
+            choices: [
+                { title: 'Si, aprobar version actual', value: 'yes' },
+                { title: 'No, re-generar antes de aprobar', value: 'regenerate' },
+                { title: 'Cancelar', value: 'cancel' },
+            ],
+        });
+        if (confirm.choice !== 'yes') {
+            if (confirm.choice === 'regenerate') {
+                console.log(c.dim('  Corre: ') + c.code('yf spec ' + kind + ' --yes'));
+            }
+            return false;
+        }
+        /* Update workflow.specs.<kind>.sha256 to match. */
+        await patchWorkflowGroup(projectRoot, 'specs', {
+            [kind]: { ...spec, sha256: currentSha, done_at: new Date().toISOString() },
+        });
+    }
+    await patchWorkflowGroup(projectRoot, 'approvals', {
+        [kind]: {
+            approved_at: new Date().toISOString(),
+            version_sha256: currentSha,
+        },
+    });
+    console.log(c.success('  Aprobado: ') + c.brand(kind));
+    return true;
+}
+async function revokeOne(projectRoot, kind) {
+    const wf = await readWorkflow(projectRoot);
+    if (!wf.approvals?.[kind]) {
+        console.log(c.warn(kind + ' no estaba aprobado.'));
+        return;
+    }
+    /* Patch with explicit removal -- set to undefined. The
+     * patchWorkflowGroup helper preserves siblings; to remove we
+     * overwrite the whole approvals object. */
+    const next = { ...(wf.approvals ?? {}) };
+    delete next[kind];
+    await patchWorkflowGroup(projectRoot, 'approvals', next);
+    console.log(c.success('Revocado: ') + c.brand(kind));
+}
+export async function runApprove(targets, opts) {
+    header('Yujin Forge -- approve');
+    console.log('');
+    const projectRoot = opts.cwd ? path.resolve(opts.cwd) : process.cwd();
+    if (opts.list) {
+        await listState(projectRoot);
+        return;
+    }
+    if (opts.revoke) {
+        const r = opts.revoke;
+        if (!ALL_DOCS.includes(r)) {
+            console.log(c.error('Doc invalido: ' + r + '. Valid: ' + ALL_DOCS.join(', ')));
+            process.exitCode = 1;
+            return;
+        }
+        await revokeOne(projectRoot, r);
+        return;
+    }
+    if (targets.length === 0) {
+        console.log(c.error('Especifica que aprobar: ') + c.code('yf approve rfp arch design'));
+        console.log(c.dim('o solo uno: ') + c.code('yf approve rfp'));
+        console.log(c.dim('o lista: ') + c.code('yf approve --list'));
+        process.exitCode = 1;
+        return;
+    }
+    let allOk = true;
+    for (const t of targets) {
+        if (!ALL_DOCS.includes(t)) {
+            console.log(c.error('Doc invalido: ' + t + '. Valid: ' + ALL_DOCS.join(', ')));
+            allOk = false;
+            continue;
+        }
+        const ok = await approveOne(projectRoot, t);
+        if (!ok)
+            allOk = false;
+    }
+    console.log('');
+    /* Re-check the entire 3-doc set for status. */
+    const wf = await readWorkflow(projectRoot);
+    const fullApproved = ALL_DOCS.every((k) => {
+        const sp = wf.specs?.[k];
+        const ap = wf.approvals?.[k];
+        return sp && ap && ap.version_sha256 === sp.sha256;
+    });
+    if (fullApproved) {
+        console.log(c.success('Phase IV gate: PASSED. Los 3 docs estan aprobados + sha-locked.'));
+        console.log(c.dim('Siguiente paso: ') + c.code('yf bootstrap'));
+    }
+    else {
+        if (allOk) {
+            console.log(c.warn('Approbations parciales. Para destrabar Phase V hacen falta los 3 docs aprobados.'));
+            console.log(c.dim('Estado: ') + c.code('yf approve --list'));
+        }
+    }
+}
+export function registerApproveCommand(program) {
+    program.command('approve [docs...]')
+        .description('Phase IV step 13: explicit approval gate for RFP + arch + design.')
+        .option('--cwd <path>', 'project root (default: current directory)')
+        .option('--list', 'show approval state for the 3 docs')
+        .option('--revoke <doc>', 'revoke approval for a single doc')
+        .action(async (docs, opts) => {
+        try {
+            await runApprove(docs ?? [], opts);
+        }
+        catch (err) {
+            console.error(c.error(err instanceof Error ? err.message : String(err)));
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=approve.js.map

package/dist/commands/approve.js.map

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

package/dist/commands/block.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `yf block <verb> <block_id>` -- Phase V step 15 of
+ * PRODUCT_WORKFLOW.md.
+ *
+ * Drives the iterative build cycle one block at a time. Each
+ * block runs through: pending -> in_progress -> green (tests
+ * verdes + green-gate) -> deployed.
+ *
+ * Verbs:
+ *   yf block list                       show all blocks + status
+ *   yf block start <id>                 mark block in_progress
+ *   yf block green <id>                 mark block tests-green
+ *   yf block deploy <id>                mark block deployed
+ *   yf block fail <id>                  mark block failed (for retry)
+ *
+ * Each transition writes to workflow.blocks_progress[*] and
+ * checks the dependency graph: a block can only enter
+ * in_progress when all its declared dependencies are
+ * "green" or "deployed".
+ *
+ * ASCII-only.
+ */
+import type { Command } from 'commander';
+export interface BlockOptions {
+    cwd?: string;
+}
+export declare function registerBlockCommand(program: Command): void;
+//# sourceMappingURL=block.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"block.d.ts","sourceRoot":"","sources":["../../src/commands/block.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASzC,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAoID,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkC3D"}