mrmainspring 0.1.1 → 0.1.3

package/README.md

@@ -1,49 +1,49 @@
-# Mr Mainspring
-
-Installable MCP backend for local agent demos. It exposes memory, Grimoire
-policy/secret storage, payment intent tools, audit trail tools, Casper anchoring
-boundaries, and x402 settlement-provider wiring.
-
-## Install
-
+# Mr Mainspring
+
+Installable MCP backend for local agent demos. It exposes memory, Grimoire
+policy/secret storage, payment intent tools, audit trail tools, Casper anchoring
+boundaries, and x402 settlement-provider wiring.
+
+## Install
+
 ```bash
 npm install -g mrmainspring
 mainspring setup cursor
 ```
 
 Run the stdio MCP server:
-
-```bash
-mainspring
-```
-
-For local development from this repository:
-
-```bash
-npm run build
-npm run mcp:stdio
-```
-
+
+```bash
+mainspring
+```
+
+For local development from this repository:
+
+```bash
+npm run build
+npm run mcp:stdio
+```
+
 ## Environment
 
 No environment variables are required for local memory, Grimoire, audit, or
 payment preflight tools. `mainspring setup` creates the local config, data, and
 logs directories under the user's standard app config folder. Use
 `SIGIL_ENV_FILE` to point at a specific env file for advanced setups.
-
-Important package boundaries:
-
+
+Important package boundaries:
+
 - Keep `.env`, local keys, and generated demo data outside the npm package.
-- Real Casper submission remains gated by `CASPER_ENABLE_REAL_SUBMISSION=true`.
-- Real x402 settlement remains gated by `X402_ENABLE_REAL_SETTLEMENT=true` and
-  a configured `X402_SIGNER_URL`.
-- The signer private key must live outside the repository workspace.
-
-## Library Entry
-
-```ts
-import { createSigilServer } from "mrmainspring";
-```
-
-The CLI entry is also exported as `mrmainspring/mcp`, but importing it starts
-the stdio server; use the package bin for normal MCP client configuration.
+- Real Casper submission remains gated by `CASPER_ENABLE_REAL_SUBMISSION=true`.
+- Real x402 settlement remains gated by `X402_ENABLE_REAL_SETTLEMENT=true` and
+  a configured `X402_SIGNER_URL`.
+- The signer private key must live outside the repository workspace.
+
+## Library Entry
+
+```ts
+import { createSigilServer } from "mrmainspring";
+```
+
+The CLI entry is also exported as `mrmainspring/mcp`, but importing it starts
+the stdio server; use the package bin for normal MCP client configuration.

package/dist/cli.js

@@ -1,9 +1,10 @@
 import { existsSync, mkdirSync, writeFileSync } from "node:fs";
 import { dirname } from "node:path";
+import { spawnSync } from "node:child_process";
 import { loadConfig } from "./config.js";
 import { ensureGrimoireMasterKey, loadLocalEnvFile, resolveEnvPath } from "./env-file.js";
 import { getDefaultMainspringPaths } from "./paths.js";
-const VERSION = "0.1.1";
+const VERSION = "0.1.2";
 const HELP = `Mr Mainspring MCP server
 
 Usage:
@@ -14,12 +15,14 @@ Usage:
   mainspring config           Print MCP client config JSON
   mainspring setup [client]   Initialize local files and print MCP config
   mainspring doctor           Check the local setup
+  mainspring update           Show how to update to the latest version
 
 MCP client config:
   {
     "mcpServers": {
       "mainspring": {
-        "command": "mainspring"
+        "command": "npx",
+        "args": ["-y", "mrmainspring"]
       }
     }
   }
@@ -61,6 +64,13 @@ export function runCliCommand(args) {
         process.stdout.write(formatDoctorReport());
         return true;
     }
+    if (command === "update") {
+        process.stdout.write("To update Mr Mainspring:\n\n" +
+            "  npm install -g mrmainspring@latest\n\n" +
+            "or if using npx (no install needed):\n\n" +
+            "  npx mrmainspring@latest\n\n");
+        return true;
+    }
     process.stderr.write(`Unknown command: ${command}\n\n${HELP}`);
     process.exitCode = 1;
     return true;
@@ -93,7 +103,8 @@ export function formatMcpConfig() {
     return JSON.stringify({
         mcpServers: {
             mainspring: {
-                command: "mainspring"
+                command: "npx",
+                args: ["-y", "mrmainspring"]
             }
         }
     }, null, 2);
@@ -118,6 +129,9 @@ function formatDoctorReport(env = process.env) {
     lines.push(formatCheck(existsSync(envFile), `Config file: ${envFile}`, "Config file missing; run mainspring init"));
     lines.push(formatCheck(existsSync(paths.dataDir), `Data dir: ${paths.dataDir}`, "Data dir missing; run mainspring init"));
     lines.push(formatCheck(existsSync(paths.logsDir), `Logs dir: ${paths.logsDir}`, "Logs dir missing; run mainspring init"));
+    const casperBin = envCopy.CASPER_CLIENT_BIN ?? "casper-client";
+    const casperProbe = spawnSync(casperBin, ["--version"], { stdio: "pipe" });
+    lines.push(formatCheck(!casperProbe.error, `casper-client: ${casperBin}`, `casper-client not found at "${casperBin}" — optional, needed for on-chain anchoring (cargo install casper-client)`));
     try {
         const config = loadConfig(envCopy);
         lines.push(`[ok] Storage backend: ${config.storage.backend}`);

package/dist/config.js

@@ -14,7 +14,7 @@ export function loadConfig(env = process.env) {
         memoryAnchorPackageHash: optionalEnv(env.MEMORY_ANCHOR_PACKAGE_HASH),
         submissionEnabled: parseBoolean(env.CASPER_ENABLE_REAL_SUBMISSION),
         clientBin: optionalEnv(env.CASPER_CLIENT_BIN) ?? "casper-client",
-        clientWslDistro: optionalEnv(env.CASPER_CLIENT_WSL_DISTRO),
+        clientWslDistro: process.platform === "win32" ? optionalEnv(env.CASPER_CLIENT_WSL_DISTRO) : null,
         anchorSubmissionMode: parseCasperAnchorSubmissionMode(env.CASPER_ANCHOR_SUBMISSION_MODE),
         gasPriceTolerance: optionalEnv(env.CASPER_GAS_PRICE_TOLERANCE) ?? "10",
         pricingMode: optionalEnv(env.CASPER_PRICING_MODE) ?? "classic",

package/package.json

@@ -1,61 +1,62 @@
-{
-  "name": "mrmainspring",
-  "version": "0.1.1",
-  "description": "Mr Mainspring MCP backend with memory, Grimoire policies, audit, Casper anchoring, and x402 settlement boundaries.",
-  "license": "MIT",
-  "type": "module",
-  "bin": {
-    "mainspring": "dist/index.js"
-  },
-  "main": "./dist/server.js",
-  "types": "./dist/server.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/server.d.ts",
-      "import": "./dist/server.js"
-    },
-    "./mcp": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    },
-    "./package.json": "./package.json"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "files": [
-    "dist/**/*.js",
-    "dist/**/*.d.ts",
-    "LICENSE",
-    "README.md",
-    "package.json"
-  ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "demo:stdio": "npm run build && tsx scripts/demo-stdio.ts",
-    "demo:x402-http": "tsx scripts/x402-demo-http-server.ts",
-    "demo:x402-sidecars": "tsx scripts/x402-local-sidecars.ts",
-    "demo:x402-sidecars:smoke": "tsx scripts/x402-local-sidecars.ts --smoke",
-    "dev": "tsx src/index.ts",
-    "mcp:stdio": "node dist/index.js",
-    "prepack": "npm run build",
-    "smoke:x402-payment-fetch": "tsx scripts/x402-payment-fetch-smoke.ts",
-    "test": "vitest run",
-    "x402:facilitator": "tsx scripts/x402-facilitator-sidecar.ts",
-    "x402:resource": "tsx scripts/x402-local-sidecars.ts",
-    "x402:signer": "tsx scripts/x402-signer-sidecar.ts"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.13.0",
-    "zod": "^3.25.76"
-  },
-  "devDependencies": {
-    "@types/node": "^22.15.30",
-    "tsx": "^4.19.4",
-    "typescript": "^5.8.3",
-    "vitest": "^4.1.8"
-  },
-  "engines": {
-    "node": ">=20.0.0"
-  }
-}
+{
+  "name": "mrmainspring",
+  "version": "0.1.3",
+  "description": "Mr Mainspring MCP backend with memory, Grimoire policies, audit, Casper anchoring, and x402 settlement boundaries.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "mainspring": "dist/index.js",
+    "mrmainspring": "dist/index.js"
+  },
+  "main": "./dist/server.js",
+  "types": "./dist/server.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
+    },
+    "./mcp": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "LICENSE",
+    "README.md",
+    "package.json"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "demo:stdio": "npm run build && tsx scripts/demo-stdio.ts",
+    "demo:x402-http": "tsx scripts/x402-demo-http-server.ts",
+    "demo:x402-sidecars": "tsx scripts/x402-local-sidecars.ts",
+    "demo:x402-sidecars:smoke": "tsx scripts/x402-local-sidecars.ts --smoke",
+    "dev": "tsx src/index.ts",
+    "mcp:stdio": "node dist/index.js",
+    "prepack": "npm run build",
+    "smoke:x402-payment-fetch": "tsx scripts/x402-payment-fetch-smoke.ts",
+    "test": "vitest run",
+    "x402:facilitator": "tsx scripts/x402-facilitator-sidecar.ts",
+    "x402:resource": "tsx scripts/x402-local-sidecars.ts",
+    "x402:signer": "tsx scripts/x402-signer-sidecar.ts"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.13.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.30",
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.3",
+    "vitest": "^4.1.8"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}