phaedo-mcp 0.1.0 → 0.1.1

package/README.md

@@ -54,9 +54,24 @@ remote HTTP/SSE are out of this cut).
 
 ## Install & test
 
+**From npm (published).** The server is on the registry as
+[`phaedo-mcp`](https://www.npmjs.com/package/phaedo-mcp) — run it without cloning:
+
+```bash
+npx phaedo-mcp              # run the server directly over stdio
+# or install the `phaedo-mcp` command globally:
+npm install -g phaedo-mcp
+```
+
+Most users never start the server by hand — point your MCP client at it with the
+**one-click install** below, which wires `phaedo-mcp` into Claude Desktop / Cursor /
+Claude Code for you. The `cd mcp` / `npm run …` commands in the rest of this README
+are for working from a **clone of this repo** (development & the smoke suite):
+
 ```bash
 cd mcp
 npm install
+npm test             # full suite (smoke + phone + cache + pairing + consult + …)
 npm run smoke        # 1a: unit + live stdio integration (23 checks)
 npm run smoke:phone  # 1b-i: mock-phone authorize→pull→decrypt→project (12 checks)
 npm run smoke:cache  # 1b-iii: encrypted at-rest cache + phone-absent fallback (11 checks)

package/fingerprint-source.js

@@ -28,11 +28,17 @@ function resolveSourcePath(baseDir) {
 // Throws on unreadable/invalid source — the tool layer maps that to
 // decryption_failed (the §9.5 "couldn't obtain plaintext fingerprint" case).
 export async function loadFingerprint(baseDir) {
-  // Phase 1b: a configured pairing record means pull the live fingerprint from
-  // the paired phone over the encrypted boundary (no plaintext at rest). On
-  // success, refresh the encrypted at-rest cache; if the phone is unreachable,
-  // serve the cache so the server still works phone-absent (frictionless default).
-  if (hasPairingRecord(baseDir)) {
+  // Explicit local source wins over phone pairing: if PHAEDO_FINGERPRINT names a
+  // file, honor it and skip the phone entirely. Pointing at a concrete fingerprint
+  // is an unambiguous "use THIS" — it lets a user force a local file and makes the
+  // server hermetic for tests on a phone-paired dev machine (where pairing.json +
+  // an isolated state dir would otherwise pull from an unreachable phone with no
+  // cache to fall back to).
+  if (!process.env.PHAEDO_FINGERPRINT && hasPairingRecord(baseDir)) {
+    // Phase 1b: a configured pairing record means pull the live fingerprint from
+    // the paired phone over the encrypted boundary (no plaintext at rest). On
+    // success, refresh the encrypted at-rest cache; if the phone is unreachable,
+    // serve the cache so the server still works phone-absent (frictionless default).
     const rec = await loadPairingRecord(baseDir);
     const stateDir = defaultStateDir();
     try {

package/package.json

@@ -1,22 +1,54 @@
 {
   "name": "phaedo-mcp",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "private": false,
   "license": "Apache-2.0",
   "type": "module",
   "description": "Phaedo MCP server — inject your cognitive fingerprint into any MCP client, and consult your decision pattern at agent decision points (docs/protocol/mcp-binding.md).",
-  "mcpName": "io.github.galavoxx/phaedo",
+  "mcpName": "io.github.galavoxx/phaedo-mcp",
   "homepage": "https://getphaedo.com",
-  "repository": { "type": "git", "url": "https://github.com/galavoxx/phaedo", "directory": "mcp" },
-  "keywords": ["mcp", "model-context-protocol", "personalization", "fingerprint", "consultation", "agent"],
-  "bin": { "phaedo-mcp": "server.js" },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/galavoxx/phaedo-mcp.git"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "personalization",
+    "fingerprint",
+    "consultation",
+    "agent"
+  ],
+  "bin": {
+    "phaedo-mcp": "server.js"
+  },
   "files": [
-    "server.js", "server.json", "fingerprint-source.js", "projection.js", "errors.js",
-    "consult.js", "consult-core.js", "consult-policy.js", "receipts.js", "agreement.js", "phone-source.js",
-    "cache.js", "pairing.js", "pair.js", "pull.js",
-    "install.mjs", "build-package.mjs", "vendor/", "lib/", "hooks/", "installers/",
-    "policy-editor.html", "sample-fingerprint.json", "pairing.sample.json",
-    "consult-policies.sample.json", "README.md"
+    "server.js",
+    "server.json",
+    "fingerprint-source.js",
+    "projection.js",
+    "errors.js",
+    "consult.js",
+    "consult-core.js",
+    "consult-policy.js",
+    "receipts.js",
+    "agreement.js",
+    "phone-source.js",
+    "cache.js",
+    "pairing.js",
+    "pair.js",
+    "pull.js",
+    "install.mjs",
+    "build-package.mjs",
+    "vendor/",
+    "lib/",
+    "hooks/",
+    "installers/",
+    "policy-editor.html",
+    "sample-fingerprint.json",
+    "pairing.sample.json",
+    "consult-policies.sample.json",
+    "README.md"
   ],
   "scripts": {
     "start": "node server.js",

package/server.json

@@ -1,10 +1,10 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
-  "name": "io.github.galavoxx/phaedo",
+  "name": "io.github.galavoxx/phaedo-mcp",
   "description": "Carry your Phaedo cognitive fingerprint into any MCP client: inject your style at session start, and consult your decision pattern (proceed/clarify/escalate/decline) at agent decision points. Local, user-owned, privacy-preserving.",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "repository": {
-    "url": "https://github.com/galavoxx/phaedo",
+    "url": "https://github.com/galavoxx/phaedo-mcp",
     "source": "github"
   },
   "packages": [
@@ -12,8 +12,10 @@
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "phaedo-mcp",
-      "version": "0.1.0",
-      "transport": { "type": "stdio" }
+      "version": "0.1.1",
+      "transport": {
+        "type": "stdio"
+      }
     }
   ]
 }