@shardworks/nexus 0.1.6 → 0.1.8

package/dist/commands/consult.d.ts

@@ -0,0 +1,4 @@
+export declare function makeConsultCommand(): import("commander").Command<[string | undefined], {
+    name?: string | undefined;
+}, {}>;
+//# sourceMappingURL=consult.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"consult.d.ts","sourceRoot":"","sources":["../../src/commands/consult.ts"],"names":[],"mappings":"AAyFA,wBAAgB,kBAAkB;;OA2EjC"}

package/dist/commands/consult.js

@@ -0,0 +1,141 @@
+/**
+ * consult command
+ *
+ * Starts an interactive Claude session with a guild member (anima).
+ * The anima is identified by role (positional) or by name (--name flag).
+ *
+ * Session setup:
+ *   1. Look up the anima in the Ledger
+ *   2. Manifest the anima (system prompt + MCP config via engine-manifest)
+ *   3. Write temp files: system prompt, MCP server config, Claude MCP config
+ *   4. Launch `claude --bare --dangerously-skip-permissions` in the guild root
+ *   5. Clean up temp files after the session exits
+ *
+ * --bare prevents Claude from auto-discovering CLAUDE.md files in the guild,
+ * which could bleed unintended instructions into the anima's context.
+ */
+import { createCommand } from 'commander';
+import { spawnSync } from 'node:child_process';
+import { createRequire } from 'node:module';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import Database from 'better-sqlite3';
+import { manifest } from '@shardworks/engine-manifest';
+import { ledgerPath } from '@shardworks/nexus-core';
+import { resolveHome } from "../resolve-home.js";
+/**
+ * Look up the name of the first active anima holding a given role.
+ *
+ * If multiple animas share the role, one is selected arbitrarily (lowest id).
+ * Throws if no active anima holds the role.
+ */
+function resolveAnimaByRole(home, role) {
+    const db = new Database(ledgerPath(home));
+    db.pragma('foreign_keys = ON');
+    try {
+        const row = db.prepare(`
+      SELECT a.name FROM animas a
+      JOIN roster r ON r.anima_id = a.id
+      WHERE r.role = ? AND a.status = 'active'
+      ORDER BY a.id ASC
+      LIMIT 1
+    `).get(role);
+        if (!row) {
+            throw new Error(`No active anima found for role "${role}".`);
+        }
+        return row.name;
+    }
+    finally {
+        db.close();
+    }
+}
+/**
+ * Build the Claude MCP config JSON (mcpServers format) that launches the
+ * engine-mcp-server as a stdio process serving the anima's implements.
+ *
+ * Resolves the engine-mcp-server entry point via require.resolve — handles
+ * both the dev (TypeScript source) and prod (compiled dist) cases.
+ */
+function buildClaudeMcpConfig(mcpServerConfigPath, serverConfig) {
+    const require = createRequire(import.meta.url);
+    const enginePath = require.resolve('@shardworks/engine-mcp-server');
+    // In dev the resolved path is the .ts source; add the transform flag.
+    const nodeArgs = [];
+    if (enginePath.endsWith('.ts')) {
+        nodeArgs.push('--disable-warning=ExperimentalWarning', '--experimental-transform-types');
+    }
+    return {
+        mcpServers: {
+            'nexus-guild': {
+                command: 'node',
+                args: [...nodeArgs, enginePath, mcpServerConfigPath],
+                env: serverConfig.env ?? {},
+            },
+        },
+    };
+}
+export function makeConsultCommand() {
+    return createCommand('consult')
+        .description('Start an interactive consultation with a guild member')
+        .argument('[role]', 'Role to consult (finds the active anima holding this role)')
+        .option('--name <anima>', 'Consult by anima name directly, bypassing role lookup')
+        .action(async (role, options, cmd) => {
+        const home = resolveHome(cmd);
+        if (!role && !options.name) {
+            cmd.help();
+            return;
+        }
+        if (role && options.name) {
+            console.error('Error: provide a role argument or --name, not both.');
+            process.exitCode = 1;
+            return;
+        }
+        // Resolve anima name
+        let animaName;
+        try {
+            animaName = options.name
+                ? options.name
+                : resolveAnimaByRole(home, role);
+        }
+        catch (err) {
+            console.error(`Error: ${err.message}`);
+            process.exitCode = 1;
+            return;
+        }
+        // Manifest the anima (system prompt + MCP config)
+        let result;
+        try {
+            result = await manifest(home, animaName);
+        }
+        catch (err) {
+            console.error(`Error: ${err.message}`);
+            process.exitCode = 1;
+            return;
+        }
+        // Write temp files into a dedicated temp dir
+        const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'nsg-consult-'));
+        try {
+            const systemPromptPath = path.join(tmpDir, 'system-prompt.md');
+            const mcpServerConfigPath = path.join(tmpDir, 'mcp-server-config.json');
+            const claudeMcpConfigPath = path.join(tmpDir, 'claude-mcp-config.json');
+            fs.writeFileSync(systemPromptPath, result.systemPrompt);
+            fs.writeFileSync(mcpServerConfigPath, JSON.stringify(result.mcpConfig, null, 2));
+            fs.writeFileSync(claudeMcpConfigPath, JSON.stringify(buildClaudeMcpConfig(mcpServerConfigPath, result.mcpConfig), null, 2));
+            console.log(`Consulting ${result.anima.name} (${result.anima.roles.join(', ')})...\n`);
+            spawnSync('claude', [
+                '--bare',
+                '--dangerously-skip-permissions',
+                '--system-prompt-file', systemPromptPath,
+                '--mcp-config', claudeMcpConfigPath,
+            ], {
+                cwd: home,
+                stdio: 'inherit',
+            });
+        }
+        finally {
+            fs.rmSync(tmpDir, { recursive: true, force: true });
+        }
+    });
+}
+//# sourceMappingURL=consult.js.map

package/dist/commands/consult.js.map

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

package/dist/program.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,OAAO;;MAGkE,CAAC"}
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,OAAO;;MAGkE,CAAC"}

package/dist/program.js

@@ -8,12 +8,14 @@ import { makeDispatchCommand } from "./commands/dispatch.js";
 import { makeInstantiateCommand } from "./commands/instantiate.js";
 import { makeManifestCommand } from "./commands/manifest.js";
 import { makeStatusCommand } from "./commands/status.js";
+import { makeConsultCommand } from "./commands/consult.js";
 export const program = createCommand('nsg')
     .description('Nexus Mk 2.1 — experimental multi-agent AI system')
     .version(VERSION)
     .option('--guild-root <path>', 'Path to guild root (default: auto-detect from cwd)');
 // ── Top-level commands ──────────────────────────────────────────────────
 program.addCommand(makeInitCommand());
+program.addCommand(makeConsultCommand());
 program.addCommand(makeDispatchCommand());
 program.addCommand(makeStatusCommand());
 // ── nsg tool [install|remove|rehydrate] ─────────────────────────────────

package/dist/program.js.map

@@ -1 +1 @@
-{"version":3,"file":"program.js","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,CAAC,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC;KACxC,WAAW,CAAC,mDAAmD,CAAC;KAChE,OAAO,CAAC,OAAO,CAAC;KAChB,MAAM,CAAC,qBAAqB,EAAE,oDAAoD,CAAC,CAAC;AAEvF,2EAA2E;AAC3E,OAAO,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC,CAAC;AACtC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;AAC1C,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;AAExC,2EAA2E;AAC3E,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC;KACpC,WAAW,CAAC,mEAAmE,CAAC,CAAC;AACpF,SAAS,CAAC,UAAU,CAAC,sBAAsB,EAAE,CAAC,CAAC;AAC/C,SAAS,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAC;AAC9C,SAAS,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;AAC7C,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AAE9B,2EAA2E;AAC3E,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC;KACtC,WAAW,CAAC,eAAe,CAAC,CAAC;AAChC,UAAU,CAAC,UAAU,CAAC,sBAAsB,EAAE,CAAC,CAAC;AAChD,UAAU,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;AAC7C,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC"}
+{"version":3,"file":"program.js","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,MAAM,CAAC,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC;KACxC,WAAW,CAAC,mDAAmD,CAAC;KAChE,OAAO,CAAC,OAAO,CAAC;KAChB,MAAM,CAAC,qBAAqB,EAAE,oDAAoD,CAAC,CAAC;AAEvF,2EAA2E;AAC3E,OAAO,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC,CAAC;AACtC,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;AACzC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;AAC1C,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;AAExC,2EAA2E;AAC3E,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC;KACpC,WAAW,CAAC,mEAAmE,CAAC,CAAC;AACpF,SAAS,CAAC,UAAU,CAAC,sBAAsB,EAAE,CAAC,CAAC;AAC/C,SAAS,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAC;AAC9C,SAAS,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;AAC7C,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AAE9B,2EAA2E;AAC3E,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC;KACtC,WAAW,CAAC,eAAe,CAAC,CAAC;AAChC,UAAU,CAAC,UAAU,CAAC,sBAAsB,EAAE,CAAC,CAAC;AAChD,UAAU,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;AAC7C,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shardworks/nexus",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "license": "ISC",
   "repository": {
     "type": "git",
@@ -26,16 +26,16 @@
   "dependencies": {
     "better-sqlite3": "12.8.0",
     "commander": "14.0.3",
-    "@shardworks/nexus-core": "0.1.6",
-    "@shardworks/engine-ledger-migrate": "0.1.6",
-    "@shardworks/engine-manifest": "0.1.6",
-    "@shardworks/implement-install-tool": "0.1.6",
-    "@shardworks/implement-dispatch": "0.1.6",
-    "@shardworks/implement-instantiate": "0.1.6",
-    "@shardworks/implement-nexus-version": "0.1.6",
-    "@shardworks/engine-worktree-setup": "0.1.6",
-    "@shardworks/implement-remove-tool": "0.1.6",
-    "@shardworks/engine-mcp-server": "0.1.6"
+    "@shardworks/nexus-core": "0.1.8",
+    "@shardworks/engine-ledger-migrate": "0.1.8",
+    "@shardworks/engine-manifest": "0.1.8",
+    "@shardworks/implement-dispatch": "0.1.8",
+    "@shardworks/implement-nexus-version": "0.1.8",
+    "@shardworks/implement-instantiate": "0.1.8",
+    "@shardworks/engine-mcp-server": "0.1.8",
+    "@shardworks/implement-remove-tool": "0.1.8",
+    "@shardworks/engine-worktree-setup": "0.1.8",
+    "@shardworks/implement-install-tool": "0.1.8"
   },
   "devDependencies": {
     "@commander-js/extra-typings": "14.0.0",