mrmainspring 0.1.8 → 0.2.0

package/dist/cli.d.ts

@@ -3,7 +3,7 @@ type InitResult = {
     dataDir: string;
     logsDir: string;
 };
-export declare function runCliCommand(args: string[]): boolean;
+export declare function runCliCommand(args: string[]): Promise<boolean>;
 export declare function initializeLocalSetup(env?: NodeJS.ProcessEnv): InitResult;
 export declare function formatMcpConfig(): string;
 export {};

package/dist/cli.js

@@ -2,8 +2,9 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { spawnSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
+import * as clack from "@clack/prompts";
 import { loadConfig } from "./config.js";
-import { setupAllClients, formatClientSetupReport } from "./client-setup.js";
+import { detectClients, configureClients, setupAllClients, formatClientSetupReport } from "./client-setup.js";
 import { ensureGrimoireMasterKey, loadLocalEnvFile, resolveEnvPath } from "./env-file.js";
 import { getDefaultMainspringPaths } from "./paths.js";
 const _pkgRoot = dirname(dirname(fileURLToPath(import.meta.url)));
@@ -34,7 +35,7 @@ Advanced users can still set SIGIL_ENV_FILE, SIGIL_DATA_DIR, Supabase, Casper,
 and x402 env vars. No env vars are required for local memory, Grimoire, audit,
 or payment preflight tools.
 `;
-export function runCliCommand(args) {
+export async function runCliCommand(args) {
     const [command, target] = args;
     if (!command || command === "stdio" || command === "server" || command === "mcp") {
         return false;
@@ -57,16 +58,28 @@ export function runCliCommand(args) {
         return true;
     }
     if (command === "setup") {
-        const result = initializeLocalSetup();
-        process.stdout.write(formatInitResult(result));
-        const clientResults = setupAllClients();
-        const report = formatClientSetupReport(clientResults);
-        if (report) {
-            process.stdout.write(report);
+        if (process.stdin.isTTY) {
+            await runInteractiveSetup();
         }
         else {
-            process.stdout.write("\nNo MCP clients detected. Paste this into your client config manually:\n\n");
-            process.stdout.write(`${formatMcpConfig()}\n`);
+            const result = initializeLocalSetup();
+            process.stdout.write(formatInitResult(result));
+            const clientResults = setupAllClients();
+            const report = formatClientSetupReport(clientResults);
+            if (report) {
+                process.stdout.write(report);
+            }
+            else {
+                process.stdout.write("\nNo MCP clients detected automatically.\n" +
+                    "Add this to your MCP client config (Claude Desktop, Cursor, Windsurf, Zed, VS Code, Continue, or any MCP host):\n\n");
+                process.stdout.write(`${formatMcpConfig()}\n`);
+                process.stdout.write("\nConfig file locations:\n" +
+                    "  Claude Desktop  ~/Library/Application Support/Claude/claude_desktop_config.json\n" +
+                    "  Cursor          ~/.cursor/mcp.json\n" +
+                    "  Windsurf        ~/.codeium/windsurf/mcp_config.json\n" +
+                    "  Zed             ~/.config/zed/settings.json  (context_servers format)\n" +
+                    "  VS Code         ~/.vscode/mcp.json\n\n");
+            }
         }
         return true;
     }
@@ -85,6 +98,98 @@ export function runCliCommand(args) {
     process.exitCode = 1;
     return true;
 }
+async function runInteractiveSetup() {
+    clack.intro("Mr Mainspring — setup");
+    const result = initializeLocalSetup();
+    clack.log.success(`Local files ready\n   Config: ${result.envFile}\n   Data:   ${result.dataDir}`);
+    const clients = detectClients();
+    const installed = clients.filter(c => c.installed);
+    const notInstalled = clients.filter(c => !c.installed);
+    let selected;
+    if (installed.length === 0) {
+        clack.log.warn("No MCP clients detected on this machine.");
+        clack.log.info("Add this JSON to your client config manually:\n\n" +
+            formatMcpConfig() + "\n\n" +
+            "  Claude Desktop  ~/Library/Application Support/Claude/claude_desktop_config.json\n" +
+            "  Cursor          ~/.cursor/mcp.json\n" +
+            "  Windsurf        ~/.codeium/windsurf/mcp_config.json\n" +
+            "  Zed             ~/.config/zed/settings.json\n" +
+            "  VS Code         ~/.vscode/mcp.json");
+        clack.outro("Restart your client after updating the config.");
+        return;
+    }
+    const choices = await clack.multiselect({
+        message: "Which MCP clients should we configure?",
+        options: [
+            ...installed.map(c => ({
+                value: c,
+                label: c.name,
+                hint: c.configPath,
+                selected: true
+            })),
+            ...notInstalled.map(c => ({
+                value: c,
+                label: c.name,
+                hint: "not found",
+                selected: false
+            }))
+        ],
+        required: false
+    });
+    if (clack.isCancel(choices)) {
+        clack.cancel("Setup cancelled.");
+        process.exitCode = 1;
+        return;
+    }
+    selected = choices;
+    if (selected.length === 0) {
+        clack.log.warn("No clients selected — nothing configured.");
+        clack.outro("Run mainspring setup again when ready.");
+        return;
+    }
+    const configResults = configureClients(selected.filter(c => c.installed));
+    const written = configResults.filter(r => r.status === "written").map(r => r.name);
+    const alreadySet = configResults.filter(r => r.status === "already-set").map(r => r.name);
+    const errors = configResults.filter(r => r.status === "error");
+    if (written.length > 0)
+        clack.log.success(`Configured: ${written.join(", ")}`);
+    if (alreadySet.length > 0)
+        clack.log.info(`Already configured: ${alreadySet.join(", ")}`);
+    for (const e of errors)
+        clack.log.error(`${e.name}: ${e.error}`);
+    const wantCasper = await clack.confirm({
+        message: "Enable Casper on-chain anchoring?",
+        initialValue: false
+    });
+    if (clack.isCancel(wantCasper)) {
+        clack.cancel("Setup cancelled.");
+        return;
+    }
+    if (wantCasper) {
+        clack.log.info("Add to your .env file:\n\n" +
+            "  CASPER_ENABLE_REAL_SUBMISSION=true\n" +
+            "  CASPER_RPC_URL=https://node.testnet.casper.network/rpc\n" +
+            "  CASPER_ACCOUNT_KEY_PATH=./keys/your-key.pem\n\n" +
+            "Then restart your MCP client.");
+    }
+    const wantX402 = await clack.confirm({
+        message: "Enable x402 micropayments?",
+        initialValue: false
+    });
+    if (clack.isCancel(wantX402)) {
+        clack.cancel("Setup cancelled.");
+        return;
+    }
+    if (wantX402) {
+        clack.log.info("Add to your .env file:\n\n" +
+            "  X402_ENABLE_REAL_SETTLEMENT=true\n" +
+            "  X402_SETTLEMENT_MODE=casper-cli\n" +
+            "  X402_BUYER_ACCOUNT_HASH=account-hash-<64 hex chars>\n" +
+            "  CASPER_ENABLE_REAL_SUBMISSION=true\n\n" +
+            "Get your account hash: casper-client account-address --public-key <your-pubkey-hex>");
+    }
+    clack.outro("Restart your MCP clients to load the server.");
+}
 export function initializeLocalSetup(env = process.env) {
     const paths = getDefaultMainspringPaths(env);
     const envFile = env.SIGIL_ENV_FILE?.trim() ? resolveEnvPath(env) : paths.envFile;

package/dist/client-setup.d.ts

@@ -4,5 +4,13 @@ export type ClientSetupResult = {
     status: "written" | "already-set" | "not-installed" | "error";
     error?: string;
 };
+export type ClientDetection = {
+    name: string;
+    configPath: string;
+    installed: boolean;
+    format: "standard" | "zed" | "continue";
+};
+export declare function detectClients(env?: NodeJS.ProcessEnv): ClientDetection[];
+export declare function configureClients(selected: ClientDetection[], env?: NodeJS.ProcessEnv): ClientSetupResult[];
 export declare function setupAllClients(env?: NodeJS.ProcessEnv): ClientSetupResult[];
 export declare function formatClientSetupReport(results: ClientSetupResult[]): string;

package/dist/client-setup.js

@@ -82,6 +82,45 @@ function mergeConfig(json, format) {
         }
     };
 }
+export function detectClients(env = process.env) {
+    const plat = process.platform;
+    const seen = new Set();
+    const results = [];
+    for (const client of CLIENTS) {
+        if (!client.platforms.includes(plat))
+            continue;
+        const configPath = expandPath(client.path, env);
+        const key = `${client.name}:${configPath}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        results.push({ name: client.name, configPath, installed: isInstalled(configPath), format: client.format });
+    }
+    return results;
+}
+export function configureClients(selected, env = process.env) {
+    const results = [];
+    for (const client of selected) {
+        if (!client.installed) {
+            results.push({ name: client.name, configPath: client.configPath, status: "not-installed" });
+            continue;
+        }
+        try {
+            const json = readJson(client.configPath);
+            if (alreadySet(json, client.format)) {
+                results.push({ name: client.name, configPath: client.configPath, status: "already-set" });
+                continue;
+            }
+            mkdirSync(dirname(client.configPath), { recursive: true });
+            writeFileSync(client.configPath, JSON.stringify(mergeConfig(json, client.format), null, 2) + "\n", "utf8");
+            results.push({ name: client.name, configPath: client.configPath, status: "written" });
+        }
+        catch (e) {
+            results.push({ name: client.name, configPath: client.configPath, status: "error", error: String(e) });
+        }
+    }
+    return results;
+}
 export function setupAllClients(env = process.env) {
     const plat = process.platform;
     const results = [];

package/dist/index.js

@@ -5,7 +5,7 @@ import { loadConfig } from "./config.js";
 import { ensureGrimoireMasterKey, loadLocalEnvFile } from "./env-file.js";
 import { createSigilServer } from "./server.js";
 async function main() {
-    if (runCliCommand(process.argv.slice(2))) {
+    if (await runCliCommand(process.argv.slice(2))) {
         return;
     }
     loadLocalEnvFile();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mrmainspring",
-  "version": "0.1.8",
+  "version": "0.2.0",
   "description": "Mr Mainspring MCP backend with memory, Grimoire policies, audit, Casper anchoring, and x402 settlement boundaries.",
   "license": "MIT",
   "type": "module",
@@ -47,6 +47,7 @@
     "x402:signer": "tsx scripts/x402-signer-sidecar.ts"
   },
   "dependencies": {
+    "@clack/prompts": "^1.5.1",
     "@modelcontextprotocol/sdk": "^1.13.0",
     "zod": "^3.25.76"
   },