@nac3/forge-cli 0.2.0-alpha.3 → 0.2.0-alpha.31

package/dist/chat/tools/workflow.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Chat tool surface for the PRODUCT_WORKFLOW.md state machine.
+ *
+ * Three tools that let Forge drive the entire 18-step methodology
+ * from inside the chat panel, without the user dropping to the CLI:
+ *
+ *   forge_workflow_state(scope?)     read workflow state (full or scoped)
+ *   forge_workflow_set(group, patch) persist a patch under workflow.<group>
+ *   forge_workflow_run_step(step)    run an autonomous step
+ *                                     (legacy_audit, coverage, manual_generate,
+ *                                      handoff, metrics) without prompts
+ *
+ * Design notes:
+ *  - State write goes through the same module the CLI verbs use
+ *    (`src/workflow/state.ts`), so a chat session and a CLI session
+ *    see the same yujin.forge.json.
+ *  - `forge_workflow_run_step` only handles steps that do NOT
+ *    require the user to answer questions (legacy_audit reads the
+ *    project; coverage greps tests; manual_generate emits markdown
+ *    from existing state). Interactive steps (triage, discover,
+ *    clarify, approve) stay CLI-driven OR are driven by Forge
+ *    asking the user in chat + calling forge_workflow_set with the
+ *    collected answers.
+ *  - Per SQ Sec 14, Forge calls forge_audit_consumers before any
+ *    structural commit; this surface is read-mostly + persistence-
+ *    safe so it does not trip that rule.
+ *
+ * ASCII-only.
+ */
+import type { ToolContext, ToolResult, ToolSpec } from '../tools.js';
+export declare const WORKFLOW_STATE_SPEC: ToolSpec;
+export declare function runWorkflowState(args: {
+    scope?: string;
+}, ctx: ToolContext): Promise<ToolResult>;
+export declare const WORKFLOW_SET_SPEC: ToolSpec;
+export declare function runWorkflowSet(args: {
+    group?: string;
+    patch?: Record<string, unknown>;
+    top_level?: boolean;
+}, ctx: ToolContext): Promise<ToolResult>;
+export declare const WORKFLOW_RUN_STEP_SPEC: ToolSpec;
+export declare function runWorkflowRunStep(args: {
+    step?: string;
+}, ctx: ToolContext): Promise<ToolResult>;
+//# sourceMappingURL=workflow.d.ts.map

package/dist/chat/tools/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../../src/chat/tools/workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAYrE,eAAO,MAAM,mBAAmB,EAAE,QAqBjC,CAAC;AAEF,wBAAsB,gBAAgB,CACpC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EACxB,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,UAAU,CAAC,CA+BrB;AAMD,eAAO,MAAM,iBAAiB,EAAE,QAkC/B,CAAC;AAWF,wBAAsB,cAAc,CAClC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,EAC9E,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,UAAU,CAAC,CA4DrB;AAMD,eAAO,MAAM,sBAAsB,EAAE,QAwBpC,CAAC;AAEF,wBAAsB,kBAAkB,CACtC,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EACvB,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,UAAU,CAAC,CA0ErB"}

package/dist/chat/tools/workflow.js

@@ -0,0 +1,404 @@
+/**
+ * Chat tool surface for the PRODUCT_WORKFLOW.md state machine.
+ *
+ * Three tools that let Forge drive the entire 18-step methodology
+ * from inside the chat panel, without the user dropping to the CLI:
+ *
+ *   forge_workflow_state(scope?)     read workflow state (full or scoped)
+ *   forge_workflow_set(group, patch) persist a patch under workflow.<group>
+ *   forge_workflow_run_step(step)    run an autonomous step
+ *                                     (legacy_audit, coverage, manual_generate,
+ *                                      handoff, metrics) without prompts
+ *
+ * Design notes:
+ *  - State write goes through the same module the CLI verbs use
+ *    (`src/workflow/state.ts`), so a chat session and a CLI session
+ *    see the same yujin.forge.json.
+ *  - `forge_workflow_run_step` only handles steps that do NOT
+ *    require the user to answer questions (legacy_audit reads the
+ *    project; coverage greps tests; manual_generate emits markdown
+ *    from existing state). Interactive steps (triage, discover,
+ *    clarify, approve) stay CLI-driven OR are driven by Forge
+ *    asking the user in chat + calling forge_workflow_set with the
+ *    collected answers.
+ *  - Per SQ Sec 14, Forge calls forge_audit_consumers before any
+ *    structural commit; this surface is read-mostly + persistence-
+ *    safe so it does not trip that rule.
+ *
+ * ASCII-only.
+ */
+import path from 'node:path';
+import { readWorkflow, writeWorkflow, patchWorkflowGroup, } from '../../workflow/state.js';
+/* =========================================================================
+ * forge_workflow_state
+ * ========================================================================= */
+export const WORKFLOW_STATE_SPEC = {
+    name: 'forge_workflow_state',
+    description: 'Read the project workflow state from yujin.forge.json. Returns '
+        + 'the full workflow object by default. Optionally filter by '
+        + 'scope (one of: tier, intent, legacy_audit, vault_inventory, '
+        + 'clarification, specs, approvals, bootstrap, blocks_progress, '
+        + 'deploy, postlaunch, iterations). Use this at the START of '
+        + 'every chat turn to know where the user is in the 18-step '
+        + 'methodology + decide what to ask next. Pure read.',
+    input_schema: {
+        type: 'object',
+        properties: {
+            scope: {
+                type: 'string',
+                description: 'Optional: return only this group of the workflow state.',
+            },
+        },
+        required: [],
+    },
+    requires_approval: false,
+};
+export async function runWorkflowState(args, ctx) {
+    const wf = await readWorkflow(ctx.projectRoot);
+    if (args.scope) {
+        const val = wf[args.scope];
+        return {
+            tool: WORKFLOW_STATE_SPEC.name,
+            is_error: false,
+            result: { scope: args.scope, value: val ?? null },
+            display: 'state[' + args.scope + ']: ' + (val ? 'present' : 'empty'),
+        };
+    }
+    /* Summary of completion for the display string. */
+    const phases = {
+        phase_i: Boolean(wf.tier && wf.intent),
+        phase_ii: Boolean(wf.clarification?.functional && wf.clarification?.nfr_quantitative
+            && wf.clarification?.nfr_structural && wf.clarification?.nfr_governance
+            && wf.clarification?.nfr_operational && wf.clarification?.blocks),
+        phase_iii: Boolean(wf.specs?.rfp && wf.specs?.arch && wf.specs?.design),
+        phase_iv: Boolean(wf.approvals?.rfp && wf.approvals?.arch && wf.approvals?.design),
+        phase_v: Boolean(wf.bootstrap),
+        phase_vi: Boolean(wf.deploy),
+    };
+    const completedPhases = Object.values(phases).filter(Boolean).length;
+    return {
+        tool: WORKFLOW_STATE_SPEC.name,
+        is_error: false,
+        result: { workflow: wf, phases },
+        display: 'workflow state read; phases complete: ' + completedPhases + '/6',
+    };
+}
+/* =========================================================================
+ * forge_workflow_set
+ * ========================================================================= */
+export const WORKFLOW_SET_SPEC = {
+    name: 'forge_workflow_set',
+    description: 'Persist a patch under workflow.<group> in yujin.forge.json. '
+        + 'Use this when you have collected the answers for a workflow '
+        + 'step conversationally (triage answers, discover answers, a '
+        + 'clarification round summary, an approval decision) and need '
+        + 'to commit them to disk so the next session inherits the '
+        + 'progress. The patch is merged into the existing group; you '
+        + 'do not need to send the whole group. Valid groups: tier '
+        + '(use top-level patch, see args), tier_reason, '
+        + 'tier_decided_at, intent, legacy_audit, vault_inventory, '
+        + 'clarification, specs, approvals, bootstrap, blocks_progress, '
+        + 'deploy, postlaunch.',
+    input_schema: {
+        type: 'object',
+        properties: {
+            group: {
+                type: 'string',
+                description: 'Which workflow group to patch.',
+            },
+            patch: {
+                type: 'object',
+                description: 'Partial object merged into the group (any keys).',
+            },
+            top_level: {
+                type: 'boolean',
+                description: 'If true, patch is merged at workflow.<key> top level '
+                    + '(used for tier / tier_reason / tier_decided_at). Default false.',
+            },
+        },
+        required: ['group', 'patch'],
+    },
+    requires_approval: false,
+};
+const VALID_GROUPS = new Set([
+    'intent', 'legacy_audit', 'vault_inventory', 'clarification',
+    'specs', 'approvals', 'bootstrap', 'deploy', 'postlaunch',
+]);
+const VALID_TOP_LEVEL = new Set([
+    'tier', 'tier_reason', 'tier_decided_at', 'blocks_progress', 'iterations',
+]);
+export async function runWorkflowSet(args, ctx) {
+    const group = String(args.group ?? '').trim();
+    if (group === '') {
+        return {
+            tool: WORKFLOW_SET_SPEC.name,
+            is_error: true,
+            result: { error: 'group required' },
+            display: 'bad input: no group',
+        };
+    }
+    if (!args.patch || typeof args.patch !== 'object') {
+        return {
+            tool: WORKFLOW_SET_SPEC.name,
+            is_error: true,
+            result: { error: 'patch (object) required' },
+            display: 'bad input: no patch',
+        };
+    }
+    if (args.top_level || VALID_TOP_LEVEL.has(group)) {
+        /* Top-level patch (tier / tier_reason / tier_decided_at /
+         *  blocks_progress / iterations). */
+        if (!VALID_TOP_LEVEL.has(group) && !args.top_level) {
+            return {
+                tool: WORKFLOW_SET_SPEC.name,
+                is_error: true,
+                result: { error: 'group "' + group + '" must be patched as a sub-group; see VALID_GROUPS' },
+                display: 'invalid top-level group',
+            };
+        }
+        const top = { [group]: args.patch[group] ?? args.patch };
+        const next = await writeWorkflow(ctx.projectRoot, top);
+        return {
+            tool: WORKFLOW_SET_SPEC.name,
+            is_error: false,
+            result: { workflow: next },
+            display: 'set workflow.' + group,
+        };
+    }
+    if (!VALID_GROUPS.has(group)) {
+        return {
+            tool: WORKFLOW_SET_SPEC.name,
+            is_error: true,
+            result: { error: 'group "' + group + '" not in [' + [...VALID_GROUPS].join(', ') + ']' },
+            display: 'invalid group',
+        };
+    }
+    const next = await patchWorkflowGroup(ctx.projectRoot, group, args.patch);
+    return {
+        tool: WORKFLOW_SET_SPEC.name,
+        is_error: false,
+        result: { workflow: next },
+        display: 'patched workflow.' + group + ' (+' + Object.keys(args.patch).length + ' keys)',
+    };
+}
+/* =========================================================================
+ * forge_workflow_run_step
+ * ========================================================================= */
+export const WORKFLOW_RUN_STEP_SPEC = {
+    name: 'forge_workflow_run_step',
+    description: 'Run an autonomous workflow step that does NOT need user '
+        + 'questions. Reads the project + writes the state. Valid steps:\n'
+        + ' - legacy_audit:    scan repo for framework + NAC-3 readiness\n'
+        + ' - coverage:        check NAC-3 structural coverage 100%\n'
+        + ' - manual_generate: write docs/manual.<lang>.md per locale\n'
+        + ' - handoff:         write docs/HANDOFF.md from current state\n'
+        + ' - metrics:         write docs/observability.md checklist\n'
+        + 'Returns the persisted state slice + a human display string. '
+        + 'Use this after collecting any prerequisite answers via '
+        + 'forge_workflow_set.',
+    input_schema: {
+        type: 'object',
+        properties: {
+            step: {
+                type: 'string',
+                description: 'One of: legacy_audit | coverage | manual_generate | handoff | metrics',
+            },
+        },
+        required: ['step'],
+    },
+    requires_approval: false,
+};
+export async function runWorkflowRunStep(args, ctx) {
+    const step = String(args.step ?? '').trim();
+    switch (step) {
+        case 'legacy_audit': {
+            const { runLegacyAudit } = await import('../../commands/legacy-audit.js');
+            await runLegacyAudit({ cwd: ctx.projectRoot });
+            const wf = await readWorkflow(ctx.projectRoot);
+            return {
+                tool: WORKFLOW_RUN_STEP_SPEC.name,
+                is_error: false,
+                result: { step, legacy_audit: wf.legacy_audit ?? null },
+                display: 'legacy_audit done; readiness=' + (wf.legacy_audit?.nac3_readiness ?? '?') + '%',
+            };
+        }
+        case 'coverage': {
+            const { runCoverage } = await import('../../commands/workflow-coverage.js');
+            /* runCoverage prints to stdout + sets exit code. We do not
+             * read its return because the function returns void. Instead
+             * we re-derive coverage from manifest + tests directly here
+             * for the structured result. */
+            const before = process.exitCode;
+            await runCoverage({ cwd: ctx.projectRoot, ifFailingExit1: false });
+            const after = process.exitCode;
+            process.exitCode = before;
+            return {
+                tool: WORKFLOW_RUN_STEP_SPEC.name,
+                is_error: false,
+                result: { step, coverage_failed: after === 1 },
+                display: 'coverage run; failed=' + (after === 1),
+            };
+        }
+        case 'manual_generate': {
+            const mod = await import('../../commands/operate.js');
+            /* operate.ts does not export the verb fns directly. We
+             *  re-invoke the underlying flow via state inspection +
+             *  manual writes -- avoiding a CLI parser re-entry. */
+            const { runManualGenerateFromTool } = await __compatLayer();
+            const docs = await runManualGenerateFromTool(ctx.projectRoot);
+            void mod; /* silence unused import */
+            return {
+                tool: WORKFLOW_RUN_STEP_SPEC.name,
+                is_error: false,
+                result: { step, docs },
+                display: 'manual_generate wrote ' + docs.length + ' file(s)',
+            };
+        }
+        case 'handoff': {
+            const { runHandoffFromTool } = await __compatLayer();
+            const docPath = await runHandoffFromTool(ctx.projectRoot);
+            return {
+                tool: WORKFLOW_RUN_STEP_SPEC.name,
+                is_error: false,
+                result: { step, doc_path: docPath },
+                display: 'handoff doc written at ' + docPath,
+            };
+        }
+        case 'metrics': {
+            const { runMetricsFromTool } = await __compatLayer();
+            const docPath = await runMetricsFromTool(ctx.projectRoot);
+            return {
+                tool: WORKFLOW_RUN_STEP_SPEC.name,
+                is_error: false,
+                result: { step, doc_path: docPath },
+                display: 'observability checklist written at ' + docPath,
+            };
+        }
+        default:
+            return {
+                tool: WORKFLOW_RUN_STEP_SPEC.name,
+                is_error: true,
+                result: { error: 'unknown step "' + step + '"' },
+                display: 'unknown step',
+            };
+    }
+}
+let _compat = null;
+async function __compatLayer() {
+    if (_compat)
+        return _compat;
+    const { promises: fs } = await import('node:fs');
+    _compat = {
+        async runManualGenerateFromTool(projectRoot) {
+            const wf = await readWorkflow(projectRoot);
+            const blocks = wf.clarification?.blocks?.blocks ?? [];
+            const opSummary = wf.clarification?.nfr_operational?.summary ?? '';
+            const localesMatch = opSummary.match(/(\d+) locales/);
+            const localesCount = localesMatch ? parseInt(localesMatch[1] ?? '1', 10) : 1;
+            const locales = localesCount > 1 ? ['es', 'en'] : ['es'];
+            const dir = path.join(projectRoot, 'docs', 'manual');
+            await fs.mkdir(dir, { recursive: true });
+            const stamp = new Date().toISOString();
+            const written = [];
+            for (const lang of locales) {
+                const fp = path.join(dir, 'manual.' + lang + '.md');
+                const blocksList = blocks
+                    .map((b) => '- **' + b.name + '** (' + b.id + '): ' + (b.mvp ? 'MVP' : 'optional'))
+                    .join('\n');
+                const body = [
+                    '# Manual de usuario (' + lang + ')',
+                    '',
+                    '*Generado por forge_workflow_run_step el ' + stamp + '.*',
+                    '',
+                    '## Que hace esta app',
+                    '',
+                    (wf.clarification?.functional?.summary ?? 'TBD'),
+                    '',
+                    '## Funcionalidades',
+                    '',
+                    blocksList,
+                    '',
+                    '## Como empezar',
+                    '',
+                    'TBD: completar el quick-start una vez que la primera version este live.',
+                ].join('\n');
+                await fs.writeFile(fp, body, 'utf-8');
+                written.push(path.relative(projectRoot, fp));
+            }
+            await patchWorkflowGroup(projectRoot, 'postlaunch', {
+                manual_at: stamp,
+                dashboards_at: wf.postlaunch?.dashboards_at ?? '',
+                feedback_channel: wf.postlaunch?.feedback_channel ?? '',
+            });
+            return written;
+        },
+        async runHandoffFromTool(projectRoot) {
+            const wf = await readWorkflow(projectRoot);
+            const stamp = new Date().toISOString();
+            const fp = path.join(projectRoot, 'docs', 'HANDOFF.md');
+            await fs.mkdir(path.dirname(fp), { recursive: true });
+            const body = [
+                '# Handoff package',
+                '',
+                '*Generado por forge_workflow_run_step el ' + stamp + '.*',
+                '*Tier: ' + (wf.tier ?? 'unknown') + '*',
+                '',
+                '## Que es esta app',
+                '',
+                (wf.clarification?.functional?.summary ?? 'TBD'),
+                '',
+                '## Decisiones de arquitectura',
+                '',
+                '- Persistencia: ver ' + (wf.clarification?.nfr_structural?.doc_path ?? 'TBD'),
+                '- Compliance: ver ' + (wf.clarification?.nfr_governance?.doc_path ?? 'TBD'),
+                '- Observability: ver ' + (wf.clarification?.nfr_operational?.doc_path ?? 'TBD'),
+                '',
+                '## Credenciales activas',
+                '',
+                ...Object.entries(wf.vault_inventory?.families ?? {})
+                    .map(([fam, st]) => '- **' + fam + '**: ' + st),
+                '',
+                '## Bloques + estado',
+                '',
+                ...((wf.clarification?.blocks?.blocks ?? []).map((b) => {
+                    const pp = (wf.blocks_progress ?? []).find((x) => x.block_id === b.id);
+                    return '- **' + b.name + '** (' + b.id + '): ' + (pp?.status ?? 'pending');
+                })),
+            ].join('\n');
+            await fs.writeFile(fp, body, 'utf-8');
+            return path.relative(projectRoot, fp);
+        },
+        async runMetricsFromTool(projectRoot) {
+            const wf = await readWorkflow(projectRoot);
+            const stamp = new Date().toISOString();
+            const opSummary = wf.clarification?.nfr_operational?.summary ?? '';
+            const checklist = [
+                '# Observability dashboards setup',
+                '',
+                '*Generado por forge_workflow_run_step el ' + stamp + '.*',
+                '',
+                '## A configurar manualmente:',
+                '- Error rate dashboard + alerta umbral.',
+                '- Latency p95 dashboard.',
+                '- Cost-per-day tracker.',
+                '- Free-tier limit watchdog.',
+                '- Custom KPI: ' + (wf.clarification?.functional?.summary ?? 'TBD'),
+                '',
+                '## Settings extraidas',
+                '',
+                opSummary || '_(operational clarification vacio)_',
+            ].join('\n');
+            const fp = path.join(projectRoot, 'docs', 'observability.md');
+            await fs.mkdir(path.dirname(fp), { recursive: true });
+            await fs.writeFile(fp, checklist, 'utf-8');
+            await patchWorkflowGroup(projectRoot, 'postlaunch', {
+                manual_at: wf.postlaunch?.manual_at ?? '',
+                dashboards_at: stamp,
+                feedback_channel: wf.postlaunch?.feedback_channel ?? 'TBD',
+            });
+            return path.relative(projectRoot, fp);
+        },
+    };
+    return _compat;
+}
+//# sourceMappingURL=workflow.js.map

package/dist/chat/tools/workflow.js.map

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

package/dist/chat/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/chat/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAqDH,wDAAwD;AACxD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAAA;SAAE,CAAC,CAAC;QACxG,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,gEAAgE;IAChE,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,MAAM,EAAE,OAAO,CAAC;IAChB;;gDAE4C;IAC5C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD,eAAO,MAAM,kBAAkB,EAAE,QAchC,CAAC;AAEF,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA+C3G;AAMD,eAAO,MAAM,gBAAgB,EAAE,QAkB9B,CAAC;AAEF,MAAM,WAAW,OAAO;IACtB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAC7C,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,UAAU,CAAC,CAmDrB;AAED;;0BAE0B;AAC1B,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,GAAE,MAAU,GAAG,OAAO,EAAE,CAkClF;AAoBD,eAAO,MAAM,eAAe,EAAE,QAsB7B,CAAC;AAOF,wBAAsB,YAAY,CAChC,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EAC5D,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,UAAU,CAAC,CAkErB;AASD;;;0BAG0B;AAC1B,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,IAAI,CAUhG;AAMD,eAAO,MAAM,cAAc,EAAE,QAkB5B,CAAC;AAKF,wBAAsB,WAAW,CAC/B,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EAC1C,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,UAAU,CAAC,CAiGrB;AAaD,eAAO,MAAM,gBAAgB,EAAE,QAAQ,EAqCtC,CAAC;AAEF;oEACoE;AACpE,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,UAAU,CAAC,CAwDrB"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/chat/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAuEH,wDAAwD;AACxD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAAA;SAAE,CAAC,CAAC;QACxG,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,gEAAgE;IAChE,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,MAAM,EAAE,OAAO,CAAC;IAChB;;gDAE4C;IAC5C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD,eAAO,MAAM,kBAAkB,EAAE,QAchC,CAAC;AAEF,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA+C3G;AAMD,eAAO,MAAM,gBAAgB,EAAE,QAkB9B,CAAC;AAEF,MAAM,WAAW,OAAO;IACtB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAC7C,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,UAAU,CAAC,CAmDrB;AAED;;0BAE0B;AAC1B,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,GAAE,MAAU,GAAG,OAAO,EAAE,CAkClF;AAoBD,eAAO,MAAM,eAAe,EAAE,QAsB7B,CAAC;AAOF,wBAAsB,YAAY,CAChC,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EAC5D,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,UAAU,CAAC,CAkErB;AASD;;;0BAG0B;AAC1B,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,IAAI,CAUhG;AAMD,eAAO,MAAM,cAAc,EAAE,QAkB5B,CAAC;AAKF,wBAAsB,WAAW,CAC/B,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EAC1C,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,UAAU,CAAC,CAiGrB;AAaD,eAAO,MAAM,gBAAgB,EAAE,QAAQ,EAiDtC,CAAC;AAEF;oEACoE;AACpE,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,UAAU,CAAC,CAoErB"}

package/dist/chat/tools.js

@@ -34,6 +34,9 @@ import { promises as fs } from 'node:fs';
 import path from 'node:path';
 import { CREATE_GITHUB_REPO_SPEC, CLONE_REPO_SPEC, BRANCH_STATUS_SPEC, runCreateGithubRepo, runCloneRepo, runBranchStatus, } from './tools/github.js';
 import { GIT_COMMIT_SPEC, GIT_PUSH_SPEC, GIT_PULL_SPEC, GIT_LOG_SPEC, runGitCommit, runGitPush, runGitPull, runGitLog, } from './tools/git.js';
+import { AUDIT_CONSUMERS_SPEC, runAuditConsumers, } from './tools/audit_consumers.js';
+import { WORKFLOW_STATE_SPEC, WORKFLOW_SET_SPEC, WORKFLOW_RUN_STEP_SPEC, runWorkflowState, runWorkflowSet, runWorkflowRunStep, } from './tools/workflow.js';
+import { GET_BYOK_STATUS_SPEC, SET_BYOK_KEY_SPEC, runGetByokStatus, runSetByokKey, } from './tools/keys.js';
 import { RUN_APP_SPEC, STOP_APP_SPEC, RESTART_APP_SPEC, runApp, stopApp, restartApp, } from './tools/lifecycle.js';
 import { READER_OPEN_SPEC, READER_LIST_DOCS_SPEC, READER_READ_SECTION_SPEC, READER_NEXT_BLOCK_SPEC, READER_SEARCH_SPEC, READER_BOOKMARK_SET_SPEC, READER_BOOKMARK_JUMP_SPEC, READER_RECAP_SPEC, runReaderOpen, runReaderListDocuments, runReaderReadSection, runReaderNextBlock, runReaderSearch, runReaderBookmarkSet, runReaderBookmarkJump, runReaderRecap, } from './tools/reader.js';
 import { MANUAL_OPEN_SPEC, runManualOpen, } from './tools/manual.js';
@@ -41,7 +44,7 @@ import { MANUAL_OPEN_SPEC, runManualOpen, } from './tools/manual.js';
  * forge.read_manifest
  * ============================================================ */
 export const READ_MANIFEST_SPEC = {
-    name: 'forge.read_manifest',
+    name: 'forge_read_manifest',
     description: 'Read the NAC-3 manifest from the active project. Returns the manifest JSON (plugin_slug, version, elements array). Optionally filter to a specific plugin slug via the `plugin_slug` argument.',
     input_schema: {
         type: 'object',
@@ -105,7 +108,7 @@ export async function runReadManifest(args, ctx) {
  * forge.consult_nac_spec
  * ============================================================ */
 export const CONSULT_NAC_SPEC = {
-    name: 'forge.consult_nac_spec',
+    name: 'forge_consult_nac_spec',
     description: 'Search the NAC-3 specification (docs/SPEC.md in the project) for paragraphs matching a free-text query. Returns up to 5 matches with their section headings + snippet. Useful when the chat needs to ground its answer in the canonical contract.',
     input_schema: {
         type: 'object',
@@ -231,7 +234,7 @@ function clampMax(n) {
  * forge.list_files
  * ============================================================ */
 export const LIST_FILES_SPEC = {
-    name: 'forge.list_files',
+    name: 'forge_list_files',
     description: 'List source files under a directory of the active project. Bounded read-only walk with a hard cap on file count + a glob filter for the basename. Useful when the chat needs to know what is in the project before opening anything.',
     input_schema: {
         type: 'object',
@@ -358,7 +361,7 @@ export function compileBasenameGlob(glob) {
  * forge.read_file
  * ============================================================ */
 export const READ_FILE_SPEC = {
-    name: 'forge.read_file',
+    name: 'forge_read_file',
     description: 'Read a single source file from the active project. Path must be relative to the project root and stay within it. Refuses binary files (NUL byte detection) and files larger than max_bytes (default 64KB). Use forge.list_files first when you do not already know the path.',
     input_schema: {
         type: 'object',
@@ -523,6 +526,18 @@ export const FORGE_TOOL_SPECS = [
     /* Manual tool (Fase F.7 / F.8 -- 10-language HTML manuals
        resolved by user language). Read-only, requires_approval=false. */
     MANUAL_OPEN_SPEC,
+    /* Producer/Consumer audit tool (SQ Sec X "Producer/Consumer
+       Symmetry"). Forge calls this BEFORE any commit that touches a
+       shared data structure. Read-only grep. */
+    AUDIT_CONSUMERS_SPEC,
+    /* PRODUCT_WORKFLOW.md state machine. Three tools that let Forge
+       drive the 18-step methodology from chat without CLI dropdowns. */
+    WORKFLOW_STATE_SPEC,
+    WORKFLOW_SET_SPEC,
+    WORKFLOW_RUN_STEP_SPEC,
+    /* BYOK key management -- LEMA YUJIN, todo por voz desde el chat. */
+    GET_BYOK_STATUS_SPEC,
+    SET_BYOK_KEY_SPEC,
     /* More tools land in follow-up commits per the docstring. */
 ];
 /** Dispatch a tool by name with the args Anthropic returned. Returns
@@ -575,6 +590,18 @@ export async function runForgeTool(name, args, ctx) {
             return runReaderRecap(args);
         case MANUAL_OPEN_SPEC.name:
             return runManualOpen(args, ctx);
+        case AUDIT_CONSUMERS_SPEC.name:
+            return runAuditConsumers(args, ctx);
+        case WORKFLOW_STATE_SPEC.name:
+            return runWorkflowState(args, ctx);
+        case WORKFLOW_SET_SPEC.name:
+            return runWorkflowSet(args, ctx);
+        case WORKFLOW_RUN_STEP_SPEC.name:
+            return runWorkflowRunStep(args, ctx);
+        case GET_BYOK_STATUS_SPEC.name:
+            return runGetByokStatus(args, ctx);
+        case SET_BYOK_KEY_SPEC.name:
+            return runSetByokKey(args, ctx);
         default:
             return {
                 tool: name,