@nac3/forge-cli 0.2.0-alpha.4 → 0.2.0-alpha.59z.118

package/dist/chat/workflow_inject.js

@@ -0,0 +1,346 @@
+/**
+ * Workflow state injection (alpha.59y.2).
+ *
+ * Reads the project's workflow state from `yujin.forge.json/workflow.*`
+ * and renders a compact "PROJECT WORKFLOW STATE" section that goes
+ * into the system prompt every turn.
+ *
+ * Why per-turn injection instead of telling the LLM to call
+ * yujin.workflow.state at the start of each turn:
+ *   - "call X at the start" is aspirational; the LLM forgets.
+ *   - Inline injection makes the workflow state part of the context
+ *     the LLM cannot ignore.
+ *   - Same pattern as fetchGraphSection (semantic_graph_inject.ts).
+ *
+ * The block tells the LLM:
+ *   1. Where the user is (phase + step + active block).
+ *   2. What completed.
+ *   3. What rules of engagement apply to this state (stay in step,
+ *      ASK on scope change, do not advance silently).
+ *
+ * Budget cap: render trims to ~400 tokens (1600 chars) hard cap.
+ * Disabled via env YF_WORKFLOW_INJECT_DISABLED=1.
+ *
+ * ASCII-only.
+ */
+import { readWorkflow } from '../workflow/state.js';
+import { renderActiveRulesBlock } from '../core/sq_resolver.js';
+import { getDoctrine } from '../core/doctrine_resolver.js';
+const RULES_BLOCK = [
+    '',
+    'RULES OF ENGAGEMENT FOR THIS STATE:',
+    '- Stay in the current step until the active block / clarification ships.',
+    '- If the user asks for something outside scope (different phase, different',
+    '  block, contradicts a prior approved doc), ASK -- do not silently redirect.',
+    '- When a block / clarification completes, call yujin.workflow.set to',
+    '  advance state -- do not advance silently.',
+    '- When the user contradicts an approved spec (RFP / Arch / Design), propose',
+    '  an adenda via the step 18 iteration flow + bump the affected doc version.',
+].join('\n');
+/** Read YF_WORKFLOW_INJECT_DISABLED env to gate. Default ON. */
+export function injectionEnabled() {
+    const v = process.env.YF_WORKFLOW_INJECT_DISABLED;
+    if (v === '1' || v === 'true' || v === 'yes')
+        return false;
+    return true;
+}
+/** Short helper -- emit `key: value` only if value is non-empty. */
+function maybe(key, value) {
+    if (value === null || value === undefined)
+        return '';
+    const s = typeof value === 'string' ? value : String(value);
+    if (s.length === 0 || s === '0')
+        return '';
+    return key + ': ' + s + '\n';
+}
+/** Infer current step descriptor from the workflow state, for
+ *  the SQ resolver. Order: first in_progress block -> active
+ *  clarification group -> step inferred from approvals/specs ->
+ *  null if nothing populated. The renderer is forgiving when
+ *  null. */
+export function inferActiveStep(state) {
+    if (!state)
+        return null;
+    /* alpha.59z.5 F1 -- if step is set directly on the workflow
+     *  state, honour it. Scenarios + many real projects populate
+     *  step explicitly (e.g. step:15) instead of the more
+     *  granular blocks_progress/approvals/specs we use to derive
+     *  it. Direct field wins. */
+    const directStep = state.step;
+    if (typeof directStep === 'number' && directStep > 0)
+        return directStep;
+    const blocks = state.blocks_progress;
+    if (Array.isArray(blocks) && blocks.length > 0) {
+        /* If any in-progress, we are in step 15 (block dev). */
+        if (blocks.some((b) => b && typeof b === 'object' && b.status === 'in_progress')) {
+            return 15;
+        }
+        /* All blocks done -> we are past 15, at 16+ depending on deploy. */
+        if (blocks.every((b) => b && typeof b === 'object' && b.status === 'done')) {
+            const deploy = state.deploy;
+            if (deploy && typeof deploy === 'object' && deploy.done_at) {
+                return 17; // postlaunch
+            }
+            return 16; // ready to deploy
+        }
+    }
+    /* Approvals done -> step 13 finished, headed to 14. */
+    const approvals = state.approvals;
+    if (approvals && typeof approvals === 'object') {
+        const okCount = Object.values(approvals).filter((a) => a && typeof a === 'object' && a.approved_at).length;
+        if (okCount >= 3)
+            return 14; // bootstrap
+    }
+    /* Any spec done -> we are between 10 and 13. */
+    const specs = state.specs;
+    if (specs && typeof specs === 'object') {
+        const anyDone = Object.values(specs).some((s) => s && typeof s === 'object' && s.done_at);
+        if (anyDone)
+            return 13;
+    }
+    /* Clarification active. */
+    const clarification = state.clarification;
+    if (clarification && typeof clarification === 'object') {
+        const pending = Object.entries(clarification).find(([, group]) => !(group && typeof group === 'object' && typeof group.done_at === 'string' && group.done_at));
+        if (pending) {
+            const slug = pending[0];
+            if (slug === 'functional')
+                return 4;
+            if (slug === 'nfr_quantitative')
+                return 5;
+            if (slug === 'nfr_structural')
+                return 6;
+            if (slug === 'nfr_governance')
+                return 7;
+            if (slug === 'nfr_operational')
+                return 8;
+            if (slug === 'blocks')
+                return 9;
+        }
+    }
+    /* Intent populated -> step 3 done, step 4 next. */
+    const intent = state.intent;
+    if (intent && typeof intent === 'object' && typeof intent.operation === 'string') {
+        return 4;
+    }
+    /* Tier populated -> step 1 done. */
+    const tier = state.tier;
+    if (typeof tier === 'string' && tier)
+        return 2;
+    return null;
+}
+/** Render a workflow state into the inline system-prompt block. */
+export function renderWorkflowSection(state, projectName) {
+    if (!state)
+        return '';
+    /* The WorkflowState shape carries optional groups. Render only
+     *  what is populated -- empty fields would just be noise. */
+    /* alpha.59z.5 F2 -- separate header from data so the "empty state"
+     *  bail logic can still detect "no data was rendered". */
+    const HEADER_LINES = [
+        '=================================================================',
+        'AUTHORITATIVE PROJECT WORKFLOW STATE (auto-injected per turn)',
+        '=================================================================',
+        'This block is your SINGLE SOURCE OF TRUTH for the project state.',
+        'Do NOT call yujin.workflow.state to look up these same fields --',
+        'they are right here.',
+        '',
+        'BEFORE you reply to the user, SCAN this block. If the user request',
+        'touches the active phase, step, or active_block, ACKNOWLEDGE that',
+        'position explicitly in your reply (cite the step number + active',
+        'block by their values below) BEFORE proposing action. If the',
+        'request asks to jump phase or revisit a prior approved doc, ASK',
+        'first -- do not silently retreat or advance.',
+        '',
+        'Use workflow.state only for fields that are absent here.',
+        '',
+    ];
+    const lines = [];
+    if (projectName)
+        lines.push('project: ' + projectName);
+    /* Tier. */
+    const tier = state.tier;
+    if (typeof tier === 'string' && tier)
+        lines.push('tier: ' + tier);
+    /* alpha.59z.5 F1 -- top-level phase + step + active_block. */
+    const phase = state.phase;
+    if (typeof phase === 'string' && phase)
+        lines.push('phase: ' + phase);
+    const stepNum = state.step;
+    if (typeof stepNum === 'number' && stepNum > 0)
+        lines.push('step: ' + stepNum);
+    const activeBlock = state.active_block;
+    if (typeof activeBlock === 'string' && activeBlock)
+        lines.push('active block: ' + activeBlock);
+    const completedSteps = state.completed_steps;
+    if (Array.isArray(completedSteps) && completedSteps.length > 0) {
+        lines.push('completed steps: [' + completedSteps.join(', ') + ']');
+    }
+    const intent = state.intent;
+    if (intent && typeof intent === 'object') {
+        const op = intent.operation;
+        if (typeof op === 'string' && op)
+            lines.push('intent: ' + op);
+    }
+    const clarification = state.clarification;
+    if (clarification && typeof clarification === 'object') {
+        const done = [];
+        const pending = [];
+        for (const [name, group] of Object.entries(clarification)) {
+            if (group && typeof group === 'object'
+                && typeof group.done_at === 'string'
+                && group.done_at) {
+                done.push(name);
+            }
+            else {
+                pending.push(name);
+            }
+        }
+        if (done.length > 0)
+            lines.push('clarification done:    ' + done.join(', '));
+        if (pending.length > 0)
+            lines.push('clarification pending: ' + pending.join(', '));
+    }
+    const specs = state.specs;
+    if (specs && typeof specs === 'object') {
+        const ready = [];
+        for (const [name, s] of Object.entries(specs)) {
+            if (s && typeof s === 'object'
+                && typeof s.done_at === 'string'
+                && s.done_at) {
+                const v = s.version;
+                ready.push(name + (typeof v === 'string' ? '@' + v : ''));
+            }
+        }
+        if (ready.length > 0)
+            lines.push('specs ready: ' + ready.join(', '));
+    }
+    const approvals = state.approvals;
+    if (approvals && typeof approvals === 'object') {
+        const ok = [];
+        for (const [name, a] of Object.entries(approvals)) {
+            if (a && typeof a === 'object'
+                && typeof a.approved_at === 'string'
+                && a.approved_at) {
+                ok.push(name);
+            }
+        }
+        if (ok.length > 0)
+            lines.push('approvals: ' + ok.join(', '));
+    }
+    const blocksProgress = state.blocks_progress;
+    if (Array.isArray(blocksProgress)) {
+        const active = blocksProgress.find((b) => b && typeof b === 'object'
+            && b.status === 'in_progress');
+        if (active) {
+            lines.push('active block: ' + JSON.stringify(active));
+        }
+        const done = blocksProgress.filter((b) => b && typeof b === 'object'
+            && b.status === 'done').length;
+        if (done > 0)
+            lines.push('blocks completed: ' + done);
+    }
+    const iterations = state.iterations;
+    if (Array.isArray(iterations) && iterations.length > 0) {
+        lines.push('iterations recorded: ' + iterations.length);
+        const last = iterations[iterations.length - 1];
+        if (last && typeof last === 'object') {
+            const t = last.type;
+            const s = last.summary;
+            if (t)
+                lines.push('  last: ' + String(t) + (s ? ' -- ' + String(s).slice(0, 80) : ''));
+        }
+    }
+    /* alpha.59z.5 F2 -- bail when no DATA lines were rendered. The
+     *  header is constant; we only emit when the state has something
+     *  to communicate. */
+    if (lines.length === 0)
+        return '';
+    /* Append rules of engagement only when we ACTUALLY have state. */
+    const all = [...HEADER_LINES, ...lines, RULES_BLOCK];
+    let text = all.join('\n');
+    /* Hard cap ~1600 chars (~400 tokens). */
+    const MAX_CHARS = 1600;
+    if (text.length > MAX_CHARS) {
+        text = text.slice(0, MAX_CHARS - 30) + '\n...[truncated by inject cap]\n';
+    }
+    return text;
+}
+/** Read workflow state from the project root + render. Empty
+ *  string when injection disabled, no workflow, or read failed. */
+export async function fetchWorkflowSection(opts) {
+    if (!injectionEnabled()) {
+        return { rendered_text: '', ok: false, estimated_tokens: 0 };
+    }
+    let state = null;
+    try {
+        state = await readWorkflow(opts.projectRoot);
+    }
+    catch {
+        /* yujin.forge.json missing or unreadable -- chat continues
+         *  without workflow injection. */
+        return { rendered_text: '', ok: false, estimated_tokens: 0 };
+    }
+    const text = renderWorkflowSection(state, opts.projectName);
+    if (!text)
+        return { rendered_text: '', ok: false, estimated_tokens: 0 };
+    /* alpha.59y.3 -- append active SQ rules subset for the inferred step.
+     *  alpha.59z.5 F1 -- if the state declares active_sq_rules
+     *  directly, use that subset instead of (or in addition to) the
+     *  inferred-step subset. */
+    let withRules = text;
+    let step = null;
+    try {
+        step = inferActiveStep(state);
+        /* Direct-declared rules first. */
+        const directRules = state.active_sq_rules;
+        if (Array.isArray(directRules) && directRules.length > 0) {
+            const slugs = directRules.filter((s) => typeof s === 'string');
+            const { renderRulesBlockBySlugs } = await import('../core/sq_resolver.js');
+            const block = await renderRulesBlockBySlugs(slugs);
+            if (block)
+                withRules = text + '\n\n' + block;
+        }
+        else {
+            const rulesBlock = await renderActiveRulesBlock(step);
+            if (rulesBlock)
+                withRules = text + '\n\n' + rulesBlock;
+        }
+    }
+    catch { /* swallow -- workflow block stays as-is */ }
+    /* alpha.59z.3 -- conditional doctrine injection:
+     *  - step 11 (architecture) or step 14 (bootstrap) -> inject
+     *    g-doc doctrine (generation rules for adopter apps).
+     *  - any phase cross-over (step in {3, 9, 12, 13, 15, 17}) ->
+     *    inject gates doctrine so the LLM knows which gate to
+     *    refuse-on-violation. */
+    if (typeof step === 'number') {
+        const wantsGDoc = (step === 11 || step === 14);
+        const phaseCrossover = [3, 9, 12, 13, 15, 17].includes(step);
+        const extras = [];
+        if (wantsGDoc) {
+            try {
+                const r = await getDoctrine('g-doc');
+                if (r.ok)
+                    extras.push(r.content);
+            }
+            catch { /* swallow */ }
+        }
+        if (phaseCrossover) {
+            try {
+                const r = await getDoctrine('gates');
+                if (r.ok)
+                    extras.push(r.content);
+            }
+            catch { /* swallow */ }
+        }
+        if (extras.length > 0)
+            withRules += '\n\n' + extras.join('\n\n');
+    }
+    return {
+        rendered_text: withRules,
+        ok: true,
+        estimated_tokens: Math.round(withRules.length / 4),
+    };
+}
+//# sourceMappingURL=workflow_inject.js.map

package/dist/chat/workflow_inject.js.map

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

package/dist/commands/agent.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `yf agent` CLI (HITO 5 slice 1).
+ *
+ * Subcommands shipped in this slice:
+ *   yf agent list [--status <s>] [--json]   -- list local agents
+ *   yf agent show <slug> [--json]           -- show a single agent
+ *   yf agent doctor [--json]                -- print effective
+ *                                              agent config (every
+ *                                              key + source).
+ *
+ * Subsequent slices add:
+ *   yf agent run <slug>          (slice 2 -- runner)
+ *   yf agent install --defaults  (slice 2 -- default agent seed)
+ *   yf agent delete <slug>       (slice 2 -- soft delete)
+ *   yf agent inbox <slug>        (slice 3 -- bridge)
+ *
+ * All shipped subcommands are read-only -- no agent code runs
+ * until the runner slice lands.
+ */
+import type { Command } from 'commander';
+export declare function registerAgentCommand(program: Command): void;
+//# sourceMappingURL=agent.d.ts.map

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;AAMzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwL3D"}

package/dist/commands/agent.js

@@ -0,0 +1,190 @@
+import { listAgentDefinitions, getAgentDefinition, filterByStatus, saveAgentDefinition, softDeleteAgent } from '../agents/store.js';
+import { snapshotAgentConfig } from '../agents/config_resolver.js';
+import { DEFAULT_AGENTS } from '../agents/defaults.js';
+export function registerAgentCommand(program) {
+    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('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":"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"}

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"}