codecartographer-pi 0.1.1 → 0.1.2

package/README.md

@@ -44,14 +44,18 @@ That's it. The LLM reads the guide, checks `workflow/status.yaml` for progress,
 
 This branch also packages CodeCartographer for [Pi](https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent) without changing `.codecarto/` itself. Pi is an **optional peer dependency** — if you only want the template or the MCP server, you don't need Pi installed.
 
-Install from a local checkout or git URL:
+Install from npm, a local checkout, or a git URL:
 
 ```bash
+pi install npm:codecartographer-pi
+# or, from a local checkout:
 pi install /absolute/path/to/CodeCartographer
-# or
+# or, from a git URL:
 pi install git:github.com/your-user/CodeCartographer
 ```
 
+> **Don't run `npm install codecartographer-pi` for the Pi use case.** Plain `npm install` puts the package on disk but doesn't register it with Pi, so it never appears in the TUI. Use `pi install npm:codecartographer-pi` instead — Pi handles the npm install internally and writes the package into its own `settings.json` (`~/.pi/agent/settings.json` by default). Plain `npm install` is the right command only for the MCP-server use case described below.
+
 For extension development, you can also point Pi directly at the extension entrypoint or place it in an auto-discovered extensions directory and use `/reload`:
 
 ```bash
@@ -84,6 +88,8 @@ What the Pi extension adds:
 
 The same framework is also packaged as a [Model Context Protocol](https://modelcontextprotocol.io) server, so any MCP-compatible host (Claude Code, Claude Desktop, etc.) can drive a CodeCartographer workflow without the Pi runtime. The server imports the same `core/` primitives the Pi extension uses, so phase prompts and validation are byte-identical across both surfaces.
 
+Implements MCP spec revision [`2025-11-25`](https://modelcontextprotocol.io/specification/2025-11-25) via `@modelcontextprotocol/sdk` ≥ 1.29.0. The negotiated `protocolVersion` reflects whatever the connecting client requests; the server accepts every revision the SDK supports (currently `2025-11-25`, `2025-06-18`, `2025-03-26`, `2024-11-05`, `2024-10-07`).
+
 Install and wire it up:
 
 ```bash

package/dist/core/workspace.js

@@ -2,14 +2,31 @@
 // (so the MCP server and Pi can both copy from it on /codecarto-init), loads
 // + normalizes the per-project workspace state from disk, and provides the
 // atomic status-update primitive used by /codecarto-complete.
+import { existsSync } from "node:fs";
 import { appendFile, rename, writeFile } from "node:fs/promises";
-import { dirname, join, relative, resolve } from "node:path";
+import { dirname, join, relative } from "node:path";
 import { fileURLToPath } from "node:url";
 import { acquireLock, normalizeStatus } from "./status.js";
 import { pathExists } from "./utils.js";
 import { loadYamlFile, stringifySimpleYaml } from "./yaml.js";
+// Walk up from the current file to find the package root. Needed because the
+// source lives at <root>/core/workspace.ts (one level below the package root)
+// but compiles to <root>/dist/core/workspace.js (two levels below). A fixed
+// `..` only works in one of those layouts, so resolve `package.json` instead.
+function findPackageRoot(start) {
+    let dir = start;
+    while (true) {
+        if (existsSync(join(dir, "package.json")))
+            return dir;
+        const parent = dirname(dir);
+        if (parent === dir) {
+            throw new Error(`Could not locate package.json starting from ${start}`);
+        }
+        dir = parent;
+    }
+}
 const coreDir = dirname(fileURLToPath(import.meta.url));
-const packageRoot = resolve(coreDir, "..");
+const packageRoot = findPackageRoot(coreDir);
 // Path to the packaged framework template directory. Wrappers copy this on
 // /codecarto-init.
 export const packagedWorkspaceDir = join(packageRoot, ".codecarto");

package/dist/extensions/codecarto/index.d.ts

@@ -1,2 +1,2 @@
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 export default function codeCartographerExtension(pi: ExtensionAPI): void;

package/dist/mcp-server/server.js

@@ -367,7 +367,7 @@ const HANDLERS = {
 };
 // ---------- server bootstrap ----------
 export function buildServer() {
-    const server = new Server({ name: "codecartographer", version: "0.1.1" }, { capabilities: { tools: {} } });
+    const server = new Server({ name: "codecartographer", version: "0.1.2" }, { capabilities: { tools: {} } });
     server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
     server.setRequestHandler(CallToolRequestSchema, async (request) => {
         const handler = HANDLERS[request.params.name];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codecartographer-pi",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "CodeCartographer packaged for Pi as an extension-driven workflow wrapper.",
   "type": "module",
   "keywords": [
@@ -39,10 +39,10 @@
     "smoke": "node scripts/smoke-mcp.mjs"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "*"
+    "@modelcontextprotocol/sdk": "^1.29.0"
   },
   "peerDependencies": {
-    "@mariozechner/pi-coding-agent": "*",
+    "@earendil-works/pi-coding-agent": "^0.74.0",
     "@sinclair/typebox": "*"
   },
   "pi": {