Migrate Pi peer dep from @mariozechner/* to @earendil-works/* (Pi 0.74)

Pi 0.74.0 moved its npm packages and repository to a new home:
  @mariozechner/pi-coding-agent -> @earendil-works/pi-coding-agent
  @mariozechner/pi-tui          -> @earendil-works/pi-tui
  github.com/badlogic/pi-mono   -> github.com/earendil-works/pi-mono

The RPC protocol (--mode rpc), ExtensionAPI, ContextEvent, ToolDefinition,
and event shapes (agent_start, agent_end, message_end, etc.) are byte
identical between 0.71.1 and 0.74.0; only the package scope changed.
Verified locally against /Users/ufukaltinok/Work/OSS/pi at 0.74.0.

Plugin:
- packages/pi-plugin/package.json: peerDependencies + devDependencies +
  build externals bumped to @earendil-works/* ^0.74.0
- packages/pi-plugin/src/**: ~25 import sites updated
- Comment references to @mariozechner/pi-ai and pi-agent-core also moved
  to @earendil-works/* (those subpackages migrated in the same release)

CLI:
- MIN_PI_VERSION raised from 0.71.0 to 0.74.0 in setup-pi and doctor-pi
- Warning text now points users at `pi update --self` (0.73.1+ supports
  cross-scope self-update) or `npm install -g @earendil-works/pi-coding-agent@latest`
- Test fixtures updated to 0.74.0

E2E harness:
- pi-runner/spawn.ts: package.json resolution + Bun cache dir prefix
  (@earendil-works+pi-coding-agent@) updated for new scope

Docs:
- Root README, pi-plugin README, e2e README all point at the new repo
- overflow-detection.ts comment URL updated

Verification: bun install, typecheck, build, lint, full test suites all
green (plugin 1394, pi 243, cli 63 — 1700 total).

Author: ualtinok

README.md

@@ -189,7 +189,7 @@ npx @cortexkit/magic-context@latest doctor --issue
 
 ## Pi coding agent (beta)
 
-Magic Context is also available as a [Pi](https://github.com/mariozechner/pi-mono) extension, sharing the **same SQLite database** as the OpenCode plugin. Project memories, embeddings, dreamer state, and key-file pins are pooled across both harnesses; per-session state (tags, compartments, facts, notes) stays harness-scoped.
+Magic Context is also available as a [Pi](https://github.com/earendil-works/pi-mono) extension, sharing the **same SQLite database** as the OpenCode plugin. Project memories, embeddings, dreamer state, and key-file pins are pooled across both harnesses; per-session state (tags, compartments, facts, notes) stays harness-scoped.
 
 > ⚠️ The Pi extension is published as **beta** while it accumulates real-world usage. Core flows are validated with end-to-end tests; report issues at [github.com/cortexkit/magic-context/issues](https://github.com/cortexkit/magic-context/issues).
 

bun.lock

@@ -118,7 +118,7 @@ export class PiAdapter implements HarnessAdapter {
     }
 
     getInstallHint(): string {
-        return "Install Pi: https://pi.coding/install (npm: @mariozechner/pi-coding-agent)";
+        return "Install Pi: https://pi.coding/install (npm: @earendil-works/pi-coding-agent)";
     }
 
     getPluginCacheInfo(): PluginCacheInfo {

packages/cli/src/adapters/pi.ts

@@ -121,7 +121,7 @@ function baseOptions(root: string, cwd: string, prompts: MockPrompts): RunDoctor
                 path: join(root, ".pi", "bin", "pi"),
                 source: "home",
             }),
-            getPiVersion: () => "0.71.0",
+            getPiVersion: () => "0.74.0",
             getLatestNpmVersion: () => "0.1.0",
             openDatabase: () => {
                 currentDb = createMockDb();
@@ -165,7 +165,7 @@ describe("Pi doctor", () => {
 
         expect(code).toBe(0);
         const output = prompts.messages.join("\n");
-        expect(output).toContain("PASS Pi 0.71.0 detected");
+        expect(output).toContain("PASS Pi 0.74.0 detected");
         expect(output).toContain("PASS npm:@cortexkit/pi-magic-context is registered");
         expect(output).toContain("PASS SQLite integrity_check: ok");
         expect(output).toContain("Summary: PASS");
@@ -264,7 +264,7 @@ describe("Pi doctor", () => {
             pluginVersion: "0.1.0",
             piInstalled: true,
             piPath: join(root, ".pi", "bin", "pi"),
-            piVersion: "0.71.0",
+            piVersion: "0.74.0",
             settings: {
                 path: join(agentDir, "settings.json"),
                 exists: true,

packages/cli/src/commands/doctor-pi.test.ts

@@ -50,12 +50,10 @@ import { type PromptIO, promptIO } from "../lib/prompts";
 import { writePiSettingsPackage } from "./setup-pi";
 
 const PACKAGE_NAME = "@cortexkit/pi-magic-context";
-// Pi 0.71.0 introduced the `--extension` long-form flag (replacing `-x`).
-// Magic Context spawns subagents with `--extension <lean-entry>` to load
-// only the lean tool surface in subagents without recursive plugin loading,
-// so older Pi versions hard-fail with "Unknown option: -x". This is also
-// our peerDependency floor in package.json.
-const MIN_PI_VERSION = "0.71.0";
+// Pi 0.74.0 renamed the npm package scope from `@mariozechner/pi-coding-agent`
+// to `@earendil-works/pi-coding-agent`. Magic Context's peerDependency targets
+// the new scope, so older Pi installs cannot load this extension.
+const MIN_PI_VERSION = "0.74.0";
 const ROW_COUNT_TABLES = ["tags", "compartments", "memories", "notes", "dream_runs"];
 
 type CheckStatus = "pass" | "warn" | "fail" | "info";
@@ -377,7 +375,7 @@ async function runHealthChecks(options: {
             add(
                 results,
                 "fail",
-                `Pi ${version} is older than required ${MIN_PI_VERSION}. Subagents (historian/dreamer/sidekick) use the long-form \`--extension\` flag introduced in Pi 0.71.0; older versions hard-fail with "Unknown option". Run \`pi update\` (or \`npm install -g @mariozechner/pi-coding-agent@latest\`).`,
+                `Pi ${version} is older than required ${MIN_PI_VERSION}. Subagents (historian/dreamer/sidekick) use the long-form \`--extension\` flag introduced in Pi 0.71.0; older versions hard-fail with "Unknown option". Run \`pi update\` (or \`npm install -g @earendil-works/pi-coding-agent@latest\`).`,
             );
         } else if (version) {
             add(results, "pass", `Pi version meets minimum ${MIN_PI_VERSION} requirement`);

packages/cli/src/commands/doctor-pi.ts

@@ -128,7 +128,7 @@ describe("runSetup", () => {
 
         const env: SetupEnvironment = {
             detectPiBinary: () => ({ path: join(root, "bin", "pi"), source: "path" }),
-            getPiVersion: () => "0.71.0",
+            getPiVersion: () => "0.74.0",
             getAvailableModels: () => [
                 "anthropic/claude-haiku-4-5",
                 "anthropic/claude-sonnet-4-6",
@@ -183,7 +183,7 @@ describe("runSetup", () => {
 
         const env: SetupEnvironment = {
             detectPiBinary: () => ({ path: join(root, "bin", "pi"), source: "path" }),
-            getPiVersion: () => "0.71.0",
+            getPiVersion: () => "0.74.0",
             // Only github-copilot model so buildModelSelection always picks it first
             getAvailableModels: () => ["github-copilot/gpt-5.4"],
             paths: {
@@ -229,7 +229,7 @@ describe("runSetup", () => {
         expect(prompts.messages.join("\n")).toContain("Pi not found");
     });
 
-    it("warns and exits when Pi version is below 0.71.0 and user declines", async () => {
+    it("warns and exits when Pi version is below 0.74.0 and user declines", async () => {
         const root = makeTempRoot();
         const agentDir = join(root, ".pi", "agent");
         const env: SetupEnvironment = {
@@ -249,13 +249,13 @@ describe("runSetup", () => {
 
         expect(code).toBe(0);
         const log = prompts.messages.join("\n");
-        expect(log).toContain("Pi 0.69.0 is older than the required 0.71.0");
+        expect(log).toContain("Pi 0.69.0 is older than the required 0.74.0");
         expect(log).toContain("outro:Setup cancelled");
         expect(existsSync(join(agentDir, "magic-context.jsonc"))).toBe(false);
         expect(existsSync(join(agentDir, "settings.json"))).toBe(false);
     });
 
-    it("continues setup when Pi version is below 0.71.0 and user opts in", async () => {
+    it("continues setup when Pi version is below 0.74.0 and user opts in", async () => {
         const root = makeTempRoot();
         const agentDir = join(root, ".pi", "agent");
         const env: SetupEnvironment = {
@@ -277,7 +277,7 @@ describe("runSetup", () => {
         expect(code).toBe(0);
         expect(existsSync(join(agentDir, "magic-context.jsonc"))).toBe(true);
         expect(prompts.messages.join("\n")).toContain(
-            "Pi 0.69.0 is older than the required 0.71.0",
+            "Pi 0.69.0 is older than the required 0.74.0",
         );
     });
 });

packages/cli/src/commands/setup-pi.test.ts

@@ -231,18 +231,17 @@ export async function runSetup(options: RunSetupOptions = {}): Promise<number> {
     const version = env.getPiVersion(pi.path);
     spinner.stop(version ? `Pi ${version} detected at ${pi.path}` : `Pi detected at ${pi.path}`);
 
-    // Pi 0.71.0 introduced the long-form `--extension` flag we use to load
-    // the lean subagent extension. Older Pi versions hard-fail with
-    // "Unknown option: -x" when subagents try to spawn, so warn loudly
-    // before the user wastes time on a setup that won't run subagents.
-    const MIN_PI_VERSION = "0.71.0";
+    // Pi 0.74.0 moved to the `@earendil-works/pi-coding-agent` package scope.
+    // Magic Context's peerDependency targets that scope, so older Pi versions
+    // (on `@mariozechner/pi-coding-agent`) cannot load this extension.
+    const MIN_PI_VERSION = "0.74.0";
     if (version && comparePiVersion(version, MIN_PI_VERSION) < 0) {
         prompts.log.warn(
             `Pi ${version} is older than the required ${MIN_PI_VERSION}.\n` +
-                `Magic Context spawns subagents with \`--extension <path>\` (long form), ` +
-                `which Pi 0.71.0 introduced. Older Pi versions hard-fail with ` +
-                `"Unknown option" when historian/dreamer/sidekick tries to run.\n` +
-                `Run \`pi update\` (or \`npm install -g @mariozechner/pi-coding-agent@latest\`) before continuing.`,
+                `Pi 0.74.0 renamed the npm package from \`@mariozechner/pi-coding-agent\` ` +
+                `to \`@earendil-works/pi-coding-agent\`. Magic Context's peer dependency ` +
+                `targets the new scope, so older Pi installs cannot load this extension.\n` +
+                `Run \`pi update --self\` (or \`npm install -g @earendil-works/pi-coding-agent@latest\`) before continuing.`,
         );
         const proceed = await prompts.confirm(
             "Continue with setup anyway? (subagents will fail at runtime)",

packages/cli/src/commands/setup-pi.ts

@@ -55,7 +55,7 @@ state directly: `getState()`, `getMessages()`, `getSessionStats()`,
 `compactNow()`, and `newSession()`.
 
 RPC mode is available in the installed Pi peer range. The current peer is
-`@mariozechner/pi-coding-agent@^0.71.0`; the lockfile resolves `0.71.1`, whose
+`@earendil-works/pi-coding-agent@^0.71.0`; the lockfile resolves `0.71.1`, whose
 packaged docs specify the JSONL RPC protocol, and the changelog shows the
 current JSON protocol was introduced in `0.16.0`.
 

packages/e2e-tests/README.md

@@ -21,10 +21,10 @@ function compareSemver(a: string, b: string): number {
 
 function resolvePiPackageJson(): string {
   try {
-    return require_.resolve("@mariozechner/pi-coding-agent/package.json");
+    return require_.resolve("@earendil-works/pi-coding-agent/package.json");
   } catch {
     const bunModules = join(REPO_ROOT, "node_modules/.bun");
-    const prefix = "@mariozechner+pi-coding-agent@";
+    const prefix = "@earendil-works+pi-coding-agent@";
     const candidates = readdirSync(bunModules, { withFileTypes: true })
       .filter((entry) => entry.isDirectory() && entry.name.startsWith(prefix))
       .map((entry) => {
@@ -34,12 +34,12 @@ function resolvePiPackageJson(): string {
       .sort((a, b) => compareSemver(b.version, a.version));
     const best = candidates[0];
     if (best === undefined) {
-      throw new Error(`Could not locate @mariozechner/pi-coding-agent under ${bunModules}`);
+      throw new Error(`Could not locate @earendil-works/pi-coding-agent under ${bunModules}`);
     }
     return join(
       bunModules,
       best.name,
-      "node_modules/@mariozechner/pi-coding-agent/package.json",
+      "node_modules/@earendil-works/pi-coding-agent/package.json",
     );
   }
 }