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

package/dist/commands/mcp.js

@@ -0,0 +1,163 @@
+import { readMcpConfig, patchMcpConfig } from '../mcp/config.js';
+export function registerMcpCommand(program) {
+    const mcp = program
+        .command('mcp')
+        .description('MCP bridge config -- enable/disable + status. Bridge runtime ships in alpha.60.');
+    mcp
+        .command('enable')
+        .description('Turn the MCP feature flag ON (does NOT spawn bridges yet; alpha.60 wiring).')
+        .action(async () => {
+        const next = await patchMcpConfig({ enabled: true });
+        console.log('mcp.enabled = ' + next.enabled);
+        console.log('Default bridges path: ' + next.bridges_path);
+        console.log('Note: bridge runtime (subprocess + lazy-load) ships in alpha.60.');
+    });
+    mcp
+        .command('disable')
+        .description('Turn the MCP feature flag OFF.')
+        .action(async () => {
+        const next = await patchMcpConfig({ enabled: false });
+        console.log('mcp.enabled = ' + next.enabled);
+    });
+    mcp
+        .command('status')
+        .description('Show MCP config + (when enabled) bridge state.')
+        .option('--json', 'JSON output')
+        .action(async (opts) => {
+        const cfg = await readMcpConfig();
+        if (opts.json) {
+            console.log(JSON.stringify(cfg, null, 2));
+            return;
+        }
+        console.log('enabled:                   ' + cfg.enabled);
+        console.log('bridges_path:              ' + cfg.bridges_path);
+        console.log('discover_default_limit:    ' + cfg.discover_default_limit);
+        console.log('transient_tools_ttl_turns: ' + cfg.transient_tools_ttl_turns);
+        console.log('max_concurrent_servers:    ' + cfg.max_concurrent_servers);
+        if (!cfg.enabled) {
+            console.log('');
+            console.log('Bridge runtime is OFF. Run `yf mcp enable` to turn the flag on.');
+            console.log('Spec: docs/MCP_BRIDGE_PLAN.md');
+        }
+    });
+    mcp
+        .command('refresh [server]')
+        .description('Force re-fetch of a bridge tools/list (alpha.60 -- stub).')
+        .action(async (server) => {
+        const cfg = await readMcpConfig();
+        if (!cfg.enabled) {
+            console.log('MCP flag is OFF. Run `yf mcp enable` first.');
+            process.exit(1);
+        }
+        console.log('refresh ' + (server ?? 'all') + ': stub (alpha.60 implements the bridge hub).');
+    });
+    mcp
+        .command('list-servers')
+        .description('List configured MCP bridges (reads bridges_path JSON).')
+        .option('--json', 'JSON output')
+        .action(async (opts) => {
+        const cfg = await readMcpConfig();
+        if (!cfg.enabled) {
+            if (opts.json)
+                console.log(JSON.stringify({ ok: false, error: 'flag_off' }));
+            else
+                console.log('MCP flag is OFF. Run `yf mcp enable` first.');
+            process.exit(1);
+        }
+        const { promises: fsmod } = await import('node:fs');
+        let raw = '';
+        try {
+            raw = await fsmod.readFile(cfg.bridges_path, 'utf-8');
+        }
+        catch {
+            if (opts.json)
+                console.log(JSON.stringify({ ok: true, servers: [] }));
+            else
+                console.log('No bridges configured. File ' + cfg.bridges_path + ' does not exist.');
+            return;
+        }
+        let parsed = null;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch { /* */ }
+        const servers = Array.isArray(parsed?.mcp_bridges) ? parsed.mcp_bridges : [];
+        if (opts.json) {
+            console.log(JSON.stringify({ ok: true, servers }, null, 2));
+            return;
+        }
+        if (servers.length === 0) {
+            console.log('No bridges configured. Edit ' + cfg.bridges_path + ' to add one.');
+            return;
+        }
+        for (const s of servers) {
+            const auto = s.auto_activate ? '(auto)' : '(manual)';
+            console.log('  ' + (s.name || '?') + '  ' + auto + '  ' + (s.command || '?'));
+        }
+    });
+    mcp
+        .command('add-bridge <name>')
+        .description('Register a bridge config (alpha.60 -- stub).')
+        .action(async () => {
+        console.log('add-bridge: stub (alpha.60). Edit ' + (await readMcpConfig()).bridges_path + ' manually for now.');
+    });
+    mcp
+        .command('remove-bridge <name>')
+        .description('Unregister a bridge config (alpha.60 -- stub).')
+        .action(async () => {
+        console.log('remove-bridge: stub (alpha.60).');
+    });
+    /* alpha.60 slice 1 -- live discovery of MCP bridges from 4
+     * sources (loopback scan + project manifest + file convention
+     * + env vars). */
+    mcp
+        .command('list')
+        .description('Discover and list MCP bridges from all 4 sources (loopback + manifest + file + env).')
+        .option('--json', 'JSON output')
+        .option('--refresh', 'bypass the 60s discovery cache')
+        .action(async (opts) => {
+        const { getActiveBridges } = await import('../mcp/bridge_registry.js');
+        const bridges = await getActiveBridges({
+            projectRoot: process.cwd(),
+            refresh: opts.refresh === true,
+        });
+        if (opts.json) {
+            console.log(JSON.stringify({ bridges }, null, 2));
+            return;
+        }
+        if (bridges.length === 0) {
+            console.log('No MCP bridges discovered.');
+            console.log('Sources scanned: loopback (3001-3010,5000,8000,8080), project manifest, ~/.yujin-forge/mcp-bridges.json, .yujin-forge/mcp-bridges.json, YUJIN_MCP_BRIDGES env.');
+            return;
+        }
+        console.log('Discovered ' + bridges.length + ' MCP bridge' + (bridges.length === 1 ? '' : 's') + ':');
+        console.log('');
+        for (const b of bridges) {
+            const status = b.enabled ? '[active]' : '[disabled]';
+            const name = b.display_name ? '  ' + b.display_name : '';
+            console.log('  ' + status + ' ' + b.id + '  (' + b.source + ')' + name);
+            console.log('             ' + b.endpoint);
+        }
+    });
+    mcp
+        .command('scan')
+        .description('Force a fresh discovery scan (bypasses the 60s cache).')
+        .option('--json', 'JSON output')
+        .action(async (opts) => {
+        const { getActiveBridges, resetBridgeCache } = await import('../mcp/bridge_registry.js');
+        resetBridgeCache();
+        const bridges = await getActiveBridges({
+            projectRoot: process.cwd(),
+            refresh: true,
+        });
+        if (opts.json) {
+            console.log(JSON.stringify({ bridges, scanned_at: new Date().toISOString() }, null, 2));
+            return;
+        }
+        console.log('Scan complete. ' + bridges.length + ' bridge' + (bridges.length === 1 ? '' : 's') + ' active.');
+        for (const b of bridges) {
+            console.log('  ' + (b.enabled ? '+' : '-') + ' ' + b.id + '  (' + b.source + ')  ' + b.endpoint);
+        }
+    });
+}
+//# sourceMappingURL=mcp.js.map

package/dist/commands/mcp.js.map

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

package/dist/commands/nac3.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `yf nac3 ...` -- NAC-3 v3.x backend tools CLI (task #23 slice 3).
+ *
+ * Subcommands:
+ *   yf nac3 list-backend-tools             Show app.* tools declared
+ *                                          in this project's
+ *                                          yujin.forge.json
+ *                                          nac3_backend.tools[].
+ *   yf nac3 invoke-backend-tool <id> [--args <json>]
+ *                                          Manually invoke one tool
+ *                                          for testing (skips the
+ *                                          chat panel). Reads Vault
+ *                                          auth + sends HTTP +
+ *                                          prints response.
+ *   yf nac3 validate                       Parse + report errors
+ *                                          without invoking anything.
+ *
+ * ASCII-only.
+ */
+import { Command } from 'commander';
+export declare function registerNac3Command(program: Command): void;
+//# sourceMappingURL=nac3.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nac3.d.ts","sourceRoot":"","sources":["../../src/commands/nac3.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoH1D"}

package/dist/commands/nac3.js

@@ -0,0 +1,125 @@
+import { loadBackendCatalogue, buildBackendToolStub } from '../nac3/backend_tools.js';
+export function registerNac3Command(program) {
+    const nac3 = program
+        .command('nac3')
+        .description('NAC-3 v3.x backend tools (task #23): inspect + invoke app.* tools declared by your project.');
+    nac3
+        .command('list-backend-tools')
+        .description('List the app.* backend tools declared in yujin.forge.json:nac3_backend.tools[].')
+        .option('--json', 'emit JSON instead of formatted output')
+        .action(async (opts) => {
+        const projectRoot = process.cwd();
+        const parsed = await loadBackendCatalogue(projectRoot);
+        if (opts.json) {
+            console.log(JSON.stringify(parsed, null, 2));
+            return;
+        }
+        if (parsed.errors.length > 0) {
+            console.error('Errors in nac3_backend section:');
+            for (const e of parsed.errors)
+                console.error('  - ' + e);
+        }
+        if (!parsed.catalogue) {
+            console.log('No nac3_backend section found in yujin.forge.json at ' + projectRoot + '.');
+            console.log('See docs/NAC3_SPEC_V3_BACKEND_TOOLS.md to declare app.* tools.');
+            if (parsed.warnings.length > 0) {
+                for (const w of parsed.warnings)
+                    console.warn('  warning: ' + w);
+            }
+            return;
+        }
+        const c = parsed.catalogue;
+        console.log('Backend catalogue:');
+        console.log('  base_url: ' + c.base_url);
+        console.log('  auth:     ' + c.auth.kind + (c.auth.vault_slot ? ' (vault: ' + c.auth.vault_slot + ')' : ''));
+        console.log('  tools:    ' + c.tools.length);
+        console.log('');
+        if (c.tools.length === 0) {
+            console.log('  (no tools declared)');
+            return;
+        }
+        console.log('Stubs (as they appear in the LLM prompt):');
+        for (const t of c.tools) {
+            console.log('  ' + buildBackendToolStub(t));
+        }
+        if (parsed.warnings.length > 0) {
+            console.log('');
+            for (const w of parsed.warnings)
+                console.warn('  warning: ' + w);
+        }
+    });
+    nac3
+        .command('invoke-backend-tool <tool_id>')
+        .description('Invoke one app.* tool manually for testing. Skips the chat panel; reads Vault auth + sends HTTP + prints response.')
+        .option('--args <json>', 'JSON-encoded args object', '{}')
+        .option('--no-redact', 'do NOT redact the printed response (default: redact)')
+        .action(async (toolId, opts) => {
+        const projectRoot = process.cwd();
+        const parsed = await loadBackendCatalogue(projectRoot);
+        if (!parsed.catalogue) {
+            console.error('error: no nac3_backend section in yujin.forge.json');
+            if (parsed.errors.length > 0) {
+                for (const e of parsed.errors)
+                    console.error('  - ' + e);
+            }
+            process.exit(1);
+        }
+        let parsedArgs;
+        try {
+            parsedArgs = JSON.parse(opts.args);
+            if (typeof parsedArgs !== 'object' || parsedArgs === null) {
+                throw new Error('args must be a JSON object');
+            }
+        }
+        catch (e) {
+            console.error('error: --args must be a valid JSON object: ' + (e instanceof Error ? e.message : String(e)));
+            process.exit(1);
+        }
+        const { runAppBackendTool } = await import('../chat/tools/app_backend_dispatch.js');
+        const r = await runAppBackendTool({
+            toolId,
+            args: parsedArgs,
+            baseEntry: {
+                trace_id: 'cli_' + Date.now(),
+                forge_version: '0.2.0',
+                manifest_version: 'v1',
+            },
+            startedAt: Date.now(),
+            projectRoot,
+        });
+        if (r.is_error) {
+            console.error(JSON.stringify(r.result, null, 2));
+            process.exit(1);
+        }
+        console.log(JSON.stringify(r.result, null, 2));
+    });
+    nac3
+        .command('validate')
+        .description('Parse yujin.forge.json + report any nac3_backend errors. No HTTP.')
+        .action(async () => {
+        const projectRoot = process.cwd();
+        const parsed = await loadBackendCatalogue(projectRoot);
+        if (parsed.errors.length === 0 && parsed.warnings.length === 0) {
+            if (parsed.catalogue) {
+                console.log('OK: nac3_backend parsed cleanly. ' + parsed.catalogue.tools.length + ' tool(s).');
+            }
+            else {
+                console.log('OK: no nac3_backend section declared (this is fine; v3.0 default).');
+            }
+            return;
+        }
+        if (parsed.errors.length > 0) {
+            console.error('Errors:');
+            for (const e of parsed.errors)
+                console.error('  - ' + e);
+        }
+        if (parsed.warnings.length > 0) {
+            console.warn('Warnings:');
+            for (const w of parsed.warnings)
+                console.warn('  - ' + w);
+        }
+        if (parsed.errors.length > 0)
+            process.exit(1);
+    });
+}
+//# sourceMappingURL=nac3.js.map

package/dist/commands/nac3.js.map

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

package/dist/commands/operate.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `yf operate <verb>` -- Phase VI + cross-cutting of
+ * PRODUCT_WORKFLOW.md.
+ *
+ * Verbs (all thin shells -- they persist state + emit
+ * scaffolding markers; deeper implementations land in follow-up
+ * commits):
+ *
+ *   yf operate deploy-guided      step 16 -- guided deploy + smoke
+ *   yf operate manual-generate    step 17 -- generate per-locale manual
+ *   yf operate metrics            step 17 -- observability dashboards setup
+ *   yf operate iterate <type>     step 18 -- classify + route a new requirement
+ *   yf operate costs              cross-cutting 8.2
+ *   yf operate handoff            cross-cutting 8.5
+ *   yf operate backup-setup       cross-cutting 8.6
+ *   yf operate restore-drill      cross-cutting 8.6
+ *
+ * ASCII-only.
+ */
+import type { Command } from 'commander';
+export declare function registerOperateCommand(program: Command): void;
+//# sourceMappingURL=operate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operate.d.ts","sourceRoot":"","sources":["../../src/commands/operate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmczC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwE7D"}