codiedev 0.9.70 → 0.9.72

package/dist/piRuntime.d.ts

@@ -0,0 +1,25 @@
+export declare const PI_PACKAGE = "@mariozechner/pi-coding-agent";
+export declare const PI_VERSION = "0.73.1";
+export declare const PI_RUNTIME_SPEC = "@mariozechner/pi-coding-agent@0.73.1";
+export declare function piRuntimeDir(stateDir: string): string;
+/** The installed pi's CLI entry, when it is the pinned version. */
+export declare function installedPiEntry(installDir: string, readFile?: (file: string) => string): string | null;
+export interface PiRuntimeDeps {
+    stateDir: string;
+    exists?: (file: string) => boolean;
+    readFile?: (file: string) => string;
+    makeStagingDir?: () => string;
+    run?: (args: string[]) => {
+        status: number | null;
+        stderr: string;
+    };
+    rename?: (from: string, to: string) => void;
+    remove?: (target: string) => void;
+    log?: (message: string) => void;
+}
+/**
+ * The pi CLI entry to run, installing the pinned version first if it is
+ * missing or a different version. Staged then renamed, so an interrupted
+ * download never leaves a half-installed pi that looks ready.
+ */
+export declare function ensurePiRuntime(deps: PiRuntimeDeps): string;

package/dist/piRuntime.js

@@ -0,0 +1,125 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PI_RUNTIME_SPEC = exports.PI_VERSION = exports.PI_PACKAGE = void 0;
+exports.piRuntimeDir = piRuntimeDir;
+exports.installedPiEntry = installedPiEntry;
+exports.ensurePiRuntime = ensurePiRuntime;
+// pi for `codie --pi`, installed on first use like the Codie engine
+// (codieRuntimeInstall.ts): developers never run a second npm install, and
+// every machine runs the version Codiedev tested its capture against.
+//
+// pi is plain JavaScript, so it runs on the same Node as `codie` from its
+// package entry: no PATH lookup, no Windows .cmd shim, and no dependency on
+// whatever `pi` (if any) the developer installed globally.
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const codieRuntimeInstall_1 = require("./codieRuntimeInstall");
+exports.PI_PACKAGE = "@mariozechner/pi-coding-agent";
+exports.PI_VERSION = "0.73.1";
+exports.PI_RUNTIME_SPEC = `${exports.PI_PACKAGE}@${exports.PI_VERSION}`;
+function piRuntimeDir(stateDir) {
+    return path.join(stateDir, "runtime-pi");
+}
+function packageDir(installDir) {
+    return path.join(installDir, "node_modules", ...exports.PI_PACKAGE.split("/"));
+}
+/** The installed pi's CLI entry, when it is the pinned version. */
+function installedPiEntry(installDir, readFile = (f) => fs.readFileSync(f, "utf8")) {
+    try {
+        const pkg = JSON.parse(readFile(path.join(packageDir(installDir), "package.json")));
+        if (pkg.version !== exports.PI_VERSION)
+            return null;
+        const bin = typeof pkg.bin === "string" ? pkg.bin : pkg.bin?.pi;
+        return typeof bin === "string" ? path.join(packageDir(installDir), bin) : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The pi CLI entry to run, installing the pinned version first if it is
+ * missing or a different version. Staged then renamed, so an interrupted
+ * download never leaves a half-installed pi that looks ready.
+ */
+function ensurePiRuntime(deps) {
+    const installDir = piRuntimeDir(deps.stateDir);
+    const exists = deps.exists ?? fs.existsSync;
+    const readFile = deps.readFile ?? ((f) => fs.readFileSync(f, "utf8"));
+    const ready = installedPiEntry(installDir, readFile);
+    if (ready && exists(ready))
+        return ready;
+    const remove = deps.remove ?? ((target) => fs.rmSync(target, { recursive: true, force: true }));
+    const rename = deps.rename ?? fs.renameSync;
+    const log = deps.log ?? ((message) => console.error(message));
+    const staging = (deps.makeStagingDir ?? (() => {
+        fs.mkdirSync(deps.stateDir, { recursive: true });
+        return fs.mkdtempSync(path.join(deps.stateDir, ".runtime-pi-"));
+    }))();
+    const run = deps.run ?? ((args) => {
+        const result = (0, child_process_1.spawnSync)(process.platform === "win32" ? "npm.cmd" : "npm", args, {
+            encoding: "utf8", stdio: ["ignore", "ignore", "pipe"], shell: process.platform === "win32",
+        });
+        if (result.error)
+            throw result.error;
+        return { status: result.status, stderr: result.stderr ?? "" };
+    });
+    log(`Installing pi (${exports.PI_RUNTIME_SPEC}). This runs once, and only for \`codie --pi\`.`);
+    try {
+        const result = run((0, codieRuntimeInstall_1.buildRuntimeInstallArgs)(staging, exports.PI_RUNTIME_SPEC));
+        if (result.status !== 0)
+            throw new Error(result.stderr?.trim() || `npm exited with ${result.status}`);
+        // Trust the artifact, not the exit code.
+        const staged = installedPiEntry(staging, readFile);
+        if (!staged || !exists(staged)) {
+            throw new Error(`the install did not produce pi. Check that ${exports.PI_RUNTIME_SPEC} is available from your npm registry.`);
+        }
+        remove(installDir);
+        rename(staging, installDir);
+    }
+    catch (error) {
+        throw new Error(`Couldn't install pi: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    finally {
+        // No-op after a successful promote; otherwise it keeps a ~200MB staging
+        // dir from being orphaned.
+        remove(staging);
+    }
+    const entry = installedPiEntry(installDir, readFile);
+    if (!entry)
+        throw new Error("Couldn't install pi: the installed package has no CLI entry.");
+    return entry;
+}

package/dist/utils.d.ts

@@ -4,6 +4,7 @@ import { type TranscriptModelUsage } from "./transcriptModels";
 import { spawn as nodeSpawn } from "child_process";
 import type { CaptureLogEntry } from "./captureLog";
 import { codiedevStateDir } from "./configDir";
+export { inspectPiExtension, piExtensionPath } from "./piHooks";
 export { codiedevStateDir };
 export interface CodiedevConfig {
     token: string;
@@ -108,6 +109,22 @@ export declare function openCodeInstalled(): boolean;
  * keeps `codiedev connect` as the only setup step even when Codie/OpenCode is
  * installed later. OpenCode loads this file from its documented plugin dir. */
 export declare function installOpenCodeCapturePlugin(): void;
+export declare function piInstalled(): boolean;
+/** Subcommands the pi extension calls, in the order inspectPiExtension checks. */
+export declare const PI_EXTENSION_SUBCOMMANDS: readonly ["session-start-pi", "backup-pi", "capture-pi-final", "discover-pi", "security-pre-pi", "security-post-pi", "security-failure-pi"];
+/**
+ * pi has no hook config: it auto-loads TypeScript extensions from
+ * <agentDir>/extensions/. This one forwards pi's events to the same hook
+ * subcommands as every other harness. pi already writes the session JSONL, so
+ * capture just hands its path over (no transcript dump like OpenCode's).
+ */
+export declare function piExtensionSource(agentSecurityEnabled: boolean): string;
+/** Install the pi extension. Unconditional like OpenCode's: pi installed
+ * later still gets captured without re-running `codiedev connect`. This
+ * release line has no Agent Security hooks, so security stays off. */
+export declare function installPiExtension(agentSecurityEnabled?: boolean): void;
+/** Self-heal after an upgrade or drift, like Copilot's hook file. */
+export declare function ensurePiExtensionInstalled(agentSecurityEnabled?: boolean): void;
 /**
  * VS Code with the GitHub Copilot Chat extension installed. The extension
  * directory pattern is `~/.vscode/extensions/github.copilot-chat-*`. We treat
@@ -127,6 +144,11 @@ export declare function ensureSessionStartHookInstalled(): void;
 export declare function installClaudeCodeInstructions(): void;
 export declare function installCodexInstructions(): void;
 export declare function copilotInstructionsPath(): string;
+/** pi's global context file, loaded into every session's system prompt. */
+export declare function piInstructionsPath(): string;
+/** pi has no session-start output channel, so team skill context rides in
+ * AGENTS.md the way it does for Copilot. */
+export declare function installPiInstructions(): void;
 export declare function installCopilotInstructions(): void;
 export declare function installCursorInstructions(): void;
 export interface InstructionsTarget {
@@ -212,7 +234,7 @@ export interface SteeringStats {
 }
 export declare function parseClaudeSteering(content: string): SteeringStats;
 export declare function parseCodexSteering(content: string): SteeringStats;
-export declare function parseSteering(content: string, mode: "claude-code" | "codex" | "cursor" | "opencode" | "copilot"): SteeringStats;
+export declare function parseSteering(content: string, mode: "claude-code" | "codex" | "cursor" | "opencode" | "copilot" | "pi"): SteeringStats;
 export interface UsageStats {
     inputTokens: number;
     outputTokens: number;
@@ -224,7 +246,7 @@ export interface UsageStats {
     /** Engine-reported spend (opencode SDK `info.cost`). Desktop mode only. */
     costUsd?: number;
 }
-export declare function parseUsage(content: string, mode: "claude-code" | "codex" | "cursor" | "opencode" | "desktop" | "copilot"): UsageStats;
+export declare function parseUsage(content: string, mode: "claude-code" | "codex" | "cursor" | "opencode" | "desktop" | "copilot" | "pi"): UsageStats;
 export declare function parseSessionStart(content: string): number | null;
 export declare function parseClaudeCodeStats(content: string): ParsedStats;
 /** Convert OpenCode's SDK message array (`{info, parts}[]`) into the same

package/dist/utils.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DIRECT_UPLOAD_THRESHOLD_CHARS = exports.SWEEP_MIN_AGE_MS = exports.CAPTURE_THROTTLE_MS = exports.FINISH_ORPHAN_AGE_MS = exports.CLAIM_STALE_MS = exports.UPLOAD_TTL_MS = exports.MAX_UPLOAD_ATTEMPTS = exports.CONFIG_PATH = exports.codiedevStateDir = void 0;
+exports.DIRECT_UPLOAD_THRESHOLD_CHARS = exports.SWEEP_MIN_AGE_MS = exports.CAPTURE_THROTTLE_MS = exports.FINISH_ORPHAN_AGE_MS = exports.CLAIM_STALE_MS = exports.UPLOAD_TTL_MS = exports.MAX_UPLOAD_ATTEMPTS = exports.PI_EXTENSION_SUBCOMMANDS = exports.CONFIG_PATH = exports.codiedevStateDir = exports.piExtensionPath = exports.inspectPiExtension = void 0;
 exports.readConfig = readConfig;
 exports.writeConfig = writeConfig;
 exports.writeConfigAtPath = writeConfigAtPath;
@@ -64,6 +64,10 @@ exports.cursorInstalled = cursorInstalled;
 exports.copilotInstalled = copilotInstalled;
 exports.openCodeInstalled = openCodeInstalled;
 exports.installOpenCodeCapturePlugin = installOpenCodeCapturePlugin;
+exports.piInstalled = piInstalled;
+exports.piExtensionSource = piExtensionSource;
+exports.installPiExtension = installPiExtension;
+exports.ensurePiExtensionInstalled = ensurePiExtensionInstalled;
 exports.vscodeCopilotInstalled = vscodeCopilotInstalled;
 exports.upsertCodiedevHook = upsertCodiedevHook;
 exports.installHook = installHook;
@@ -77,6 +81,8 @@ exports.ensureSessionStartHookInstalled = ensureSessionStartHookInstalled;
 exports.installClaudeCodeInstructions = installClaudeCodeInstructions;
 exports.installCodexInstructions = installCodexInstructions;
 exports.copilotInstructionsPath = copilotInstructionsPath;
+exports.piInstructionsPath = piInstructionsPath;
+exports.installPiInstructions = installPiInstructions;
 exports.installCopilotInstructions = installCopilotInstructions;
 exports.installCursorInstructions = installCursorInstructions;
 exports.installedInstructionsTargets = installedInstructionsTargets;
@@ -140,6 +146,10 @@ const teamSkillContext_1 = require("./teamSkillContext");
 const nativeSteering_1 = require("./nativeSteering");
 const copilotHooks_1 = require("./copilotHooks");
 const harnessDirs_1 = require("./harnessDirs");
+const piHooks_1 = require("./piHooks");
+var piHooks_2 = require("./piHooks");
+Object.defineProperty(exports, "inspectPiExtension", { enumerable: true, get: function () { return piHooks_2.inspectPiExtension; } });
+Object.defineProperty(exports, "piExtensionPath", { enumerable: true, get: function () { return piHooks_2.piExtensionPath; } });
 const CONFIG_DIR = (0, configDir_1.codiedevStateDir)();
 exports.CONFIG_PATH = path.join(CONFIG_DIR, "config.json");
 function readConfig() {
@@ -1111,7 +1121,6 @@ function installOpenCodeCapturePlugin() {
         `import os from "node:os";\n` +
         `import path from "node:path";\n\n` +
         `const START = ${JSON.stringify(start)};\n` +
-        `const CAPTURE = ${JSON.stringify(capture)};\n` +
         `const FINISH = ${JSON.stringify(finish)};\n` +
         `const PROMPT = ${JSON.stringify(prompt)};\n` +
         `// How this Codie process was started (run / serve / tui). OpenCode records\n` +
@@ -1203,6 +1212,167 @@ function installOpenCodeCapturePlugin() {
     fs.writeFileSync(OPENCODE_PLUGIN_PATH, source, { encoding: "utf8", mode: 0o600 });
     fs.chmodSync(OPENCODE_PLUGIN_PATH, 0o600);
 }
+function piInstalled() {
+    if (fs.existsSync((0, harnessDirs_1.piAgentDir)()))
+        return true;
+    try {
+        (0, child_process_1.execSync)(process.platform === "win32" ? "where pi" : "command -v pi", { stdio: ["pipe", "pipe", "pipe"] });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Subcommands the pi extension calls, in the order inspectPiExtension checks. */
+exports.PI_EXTENSION_SUBCOMMANDS = [
+    "session-start-pi", "backup-pi", "capture-pi-final", "discover-pi",
+    "security-pre-pi", "security-post-pi", "security-failure-pi",
+];
+/**
+ * pi has no hook config: it auto-loads TypeScript extensions from
+ * <agentDir>/extensions/. This one forwards pi's events to the same hook
+ * subcommands as every other harness. pi already writes the session JSONL, so
+ * capture just hands its path over (no transcript dump like OpenCode's).
+ */
+function piExtensionSource(agentSecurityEnabled) {
+    const [start, backup, finish, prompt, securityPre, securityPost, securityFailure] = exports.PI_EXTENSION_SUBCOMMANDS.map((subcommand) => resolveHookInvocation(subcommand));
+    return `// Managed by codiedev connect. Safe to remove; \`codiedev connect\` reinstalls it.\n` +
+        `import { spawn, spawnSync } from "node:child_process";\n\n` +
+        `const START = ${JSON.stringify(start)};\n` +
+        `const FINISH = ${JSON.stringify(finish)};\n` +
+        `const BACKUP = ${JSON.stringify(backup)};\n` +
+        `const PROMPT = ${JSON.stringify(prompt)};\n` +
+        `const SECURITY_PRE = ${JSON.stringify(securityPre)};\n` +
+        `const SECURITY_POST = ${JSON.stringify(securityPost)};\n` +
+        `const SECURITY_FAILURE = ${JSON.stringify(securityFailure)};\n` +
+        `const AGENT_SECURITY_ENABLED = ${JSON.stringify(agentSecurityEnabled)};\n` +
+        `const CONTEXT_TYPE = ${JSON.stringify(piHooks_1.PI_CONTEXT_CUSTOM_TYPE)};\n` +
+        `const piLaunchFromArgv = ${piHooks_1.piLaunchFromArgv.toString()};\n` +
+        `const LAUNCH = piLaunchFromArgv(process.argv.slice(2));\n\n` +
+        `function dispatch(invocation, payload) {\n` +
+        `  try {\n` +
+        `    const child = spawn(invocation.command, invocation.args, { detached: true, stdio: ["pipe", "ignore", "ignore"] });\n` +
+        `    child.stdin.end(JSON.stringify(payload));\n` +
+        `    child.unref();\n` +
+        `  } catch {}\n` +
+        `}\n\n` +
+        `function dispatchSync(invocation, payload) {\n` +
+        `  try { spawnSync(invocation.command, invocation.args, { input: JSON.stringify(payload), stdio: ["pipe", "ignore", "ignore"], timeout: 1500 }); } catch {}\n` +
+        `}\n\n` +
+        `function invokeSync(invocation, payload) {\n` +
+        `  try {\n` +
+        `    const result = spawnSync(invocation.command, invocation.args, { input: JSON.stringify(payload), encoding: "utf8", stdio: ["pipe", "pipe", "ignore"], timeout: 1500 });\n` +
+        `    if (result.error) return null;\n` +
+        `    return JSON.parse(result.stdout || "{}");\n` +
+        `  } catch { return null; }\n` +
+        `}\n\n` +
+        `function blockReason(decision) {\n` +
+        `  const denied = decision?.decision === "block" || decision?.hookSpecificOutput?.permissionDecision === "deny";\n` +
+        `  return denied ? (decision?.reason || decision?.hookSpecificOutput?.permissionDecisionReason || "Codie security policy blocked this action") : null;\n` +
+        `}\n\n` +
+        `function warn(ctx, reason) {\n` +
+        `  if (ctx?.hasUI) { try { ctx.ui.notify("Codie Security: " + reason, "error"); return; } catch {} }\n` +
+        `  process.stderr.write("\\nCodie Security blocked this action:\\n" + reason + "\\n");\n` +
+        `}\n\n` +
+        `export default function codiedev(pi) {\n` +
+        `  let session = null;\n` +
+        `  let pendingContext = null;\n` +
+        `  let finalized = false;\n` +
+        `  const current = (ctx) => {\n` +
+        `    const sm = ctx?.sessionManager;\n` +
+        `    const id = sm?.getSessionId?.() ?? session?.id;\n` +
+        `    const file = sm?.getSessionFile?.() ?? session?.file;\n` +
+        `    const cwd = ctx?.cwd || session?.cwd || process.cwd();\n` +
+        `    session = { id, file, cwd };\n` +
+        `    return session;\n` +
+        `  };\n` +
+        `  const payload = (s, extra) => ({ session_id: s.id, transcript_path: s.file, cwd: s.cwd, workspace_roots: [s.cwd], launch: LAUNCH, ...extra });\n` +
+        `  const finalize = () => {\n` +
+        `    // No file (pi --no-session) still finalizes: the hook reports a skip, so\n` +
+        `    // the start ping is not left open.\n` +
+        `    if (finalized || !session?.id) return;\n` +
+        `    finalized = true;\n` +
+        `    dispatchSync(FINISH, payload(session));\n` +
+        `  };\n` +
+        `  // Print mode can exit without a shutdown event; the session is still over.\n` +
+        `  // pi rebuilds extensions on every /new, /resume and /fork, so register one\n` +
+        `  // exit hook per process and point it at the newest instance.\n` +
+        `  globalThis.__codiedevPiFinalize = finalize;\n` +
+        `  if (!globalThis.__codiedevPiExitHook) {\n` +
+        `    globalThis.__codiedevPiExitHook = true;\n` +
+        `    process.once("exit", () => globalThis.__codiedevPiFinalize?.());\n` +
+        `  }\n\n` +
+        `  pi.on("session_start", async (event, ctx) => {\n` +
+        `    finalized = false;\n` +
+        `    if (event?.reason === "reload") { current(ctx); return; }\n` +
+        `    const s = current(ctx);\n` +
+        `    // pi can announce one new session twice across an extension rebind.\n` +
+        `    if (!s.id || globalThis.__codiedevPiStarted === s.id) return;\n` +
+        `    globalThis.__codiedevPiStarted = s.id;\n` +
+        `    dispatch(START, payload(s));\n` +
+        `  });\n\n` +
+        `  pi.on("input", async (event, ctx) => {\n` +
+        `    if (event?.source === "extension") return { action: "continue" };\n` +
+        `    const s = current(ctx);\n` +
+        `    const decision = invokeSync(PROMPT, { session_id: s.id, cwd: s.cwd, prompt: event?.text ?? "" });\n` +
+        `    const reason = blockReason(decision);\n` +
+        `    if (reason) { warn(ctx, reason); return { action: "handled" }; }\n` +
+        `    pendingContext = decision?.hookSpecificOutput?.additionalContext || null;\n` +
+        `    return { action: "continue" };\n` +
+        `  });\n\n` +
+        `  pi.on("before_agent_start", async () => {\n` +
+        `    if (!pendingContext) return;\n` +
+        `    const content = pendingContext;\n` +
+        `    pendingContext = null;\n` +
+        `    return { message: { customType: CONTEXT_TYPE, content, display: false } };\n` +
+        `  });\n\n` +
+        `  pi.on("tool_call", async (event, ctx) => {\n` +
+        `    if (!AGENT_SECURITY_ENABLED) return;\n` +
+        `    const s = current(ctx);\n` +
+        `    const reason = blockReason(invokeSync(SECURITY_PRE, { sessionId: s.id, cwd: s.cwd, toolName: event.toolName, toolUseId: event.toolCallId, toolInput: event.input }));\n` +
+        `    if (reason) { warn(ctx, reason); return { block: true, reason }; }\n` +
+        `  });\n\n` +
+        `  pi.on("tool_result", async (event, ctx) => {\n` +
+        `    if (!AGENT_SECURITY_ENABLED) return;\n` +
+        `    const s = current(ctx);\n` +
+        `    dispatch(event.isError ? SECURITY_FAILURE : SECURITY_POST, { sessionId: s.id, cwd: s.cwd, toolName: event.toolName, toolUseId: event.toolCallId, toolInput: event.input, toolResponse: { content: event.content, isError: event.isError } });\n` +
+        `  });\n\n` +
+        `  pi.on("agent_end", async (_event, ctx) => {\n` +
+        `    const s = current(ctx);\n` +
+        `    if (!s.id || !s.file) return;\n` +
+        `    // Interim capture + artifact backup, like every harness's Stop hook. pi\n` +
+        `    // retries provider errors itself; agent_end comes after the last try, so\n` +
+        `    // the capture reports a hit limit once per run, not once per retry.\n` +
+        `    dispatch(BACKUP, payload(s));\n` +
+        `  });\n\n` +
+        `  pi.on("session_shutdown", async (event, ctx) => {\n` +
+        `    // A reload keeps the same session running.\n` +
+        `    if (event?.reason === "reload") return;\n` +
+        `    current(ctx);\n` +
+        `    finalize();\n` +
+        `  });\n` +
+        `}\n`;
+}
+/** Install the pi extension. Unconditional like OpenCode's: pi installed
+ * later still gets captured without re-running `codiedev connect`. This
+ * release line has no Agent Security hooks, so security stays off. */
+function installPiExtension(agentSecurityEnabled = false) {
+    const target = (0, piHooks_1.piExtensionPath)();
+    fs.mkdirSync(path.dirname(target), { recursive: true, mode: 0o700 });
+    const tmp = `${target}.${process.pid}.tmp`;
+    fs.writeFileSync(tmp, piExtensionSource(agentSecurityEnabled), { encoding: "utf8", mode: 0o600 });
+    fs.renameSync(tmp, target);
+}
+/** Self-heal after an upgrade or drift, like Copilot's hook file. */
+function ensurePiExtensionInstalled(agentSecurityEnabled = false) {
+    try {
+        const file = (0, piHooks_1.piExtensionPath)();
+        if (fs.existsSync(file) && fs.readFileSync(file, "utf8") === piExtensionSource(agentSecurityEnabled))
+            return;
+        installPiExtension(agentSecurityEnabled);
+    }
+    catch { /* best-effort */ }
+}
 /**
  * VS Code with the GitHub Copilot Chat extension installed. The extension
  * directory pattern is `~/.vscode/extensions/github.copilot-chat-*`. We treat
@@ -1424,6 +1594,7 @@ function migrateHooksToLauncher() {
         ["cursor", CURSOR_HOOKS_PATH, installCursorHook],
         ["copilot", copilotHooksPath(), installCopilotHook],
         ["opencode", OPENCODE_PLUGIN_PATH, installOpenCodeCapturePlugin],
+        ["pi", (0, piHooks_1.piExtensionPath)(), installPiExtension],
     ];
     const migrated = [];
     for (const [name, file, install] of targets) {
@@ -1601,6 +1772,15 @@ function installCodexInstructions() {
 function copilotInstructionsPath() {
     return path.join((0, copilotHooks_1.copilotHome)(), "copilot-instructions.md");
 }
+/** pi's global context file, loaded into every session's system prompt. */
+function piInstructionsPath() {
+    return path.join((0, harnessDirs_1.piAgentDir)(), "AGENTS.md");
+}
+/** pi has no session-start output channel, so team skill context rides in
+ * AGENTS.md the way it does for Copilot. */
+function installPiInstructions() {
+    writeInstructionsBlock(piInstructionsPath(), `${teamSkillContext_1.TEAM_SKILL_CONTEXT}\n\n${CODIEDEV_INSTRUCTIONS_BODY}`);
+}
 function installCopilotInstructions() {
     writeInstructionsBlock(copilotInstructionsPath(), `${teamSkillContext_1.TEAM_SKILL_CONTEXT}\n\n${CODIEDEV_INSTRUCTIONS_BODY}`);
 }
@@ -1654,6 +1834,7 @@ function installedInstructionsTargets() {
         { path: CODEX_USER_INSTRUCTIONS_PATH, body: CODIEDEV_INSTRUCTIONS_BODY },
         { path: copilotInstructionsPath(), body: withTeamContext },
         { path: CURSOR_RULES_PATH, body: withTeamContext },
+        { path: piInstructionsPath(), body: withTeamContext },
     ];
 }
 /**
@@ -2798,9 +2979,9 @@ exports.SWEEP_MIN_AGE_MS = exports.CAPTURE_THROTTLE_MS + 2 * 60 * 1000;
 // to true would silently re-introduce the per-turn lease-close bug for every
 // new agent.
 function resolveCaptureFinal(argv2) {
-    if (argv2 === "capture-opencode" || argv2 === "capture-desktop")
+    if (argv2 === "capture-opencode" || argv2 === "capture-desktop" || argv2 === "capture-pi")
         return false;
-    if (argv2 === "capture-opencode-final" || argv2 === "capture-desktop-final")
+    if (argv2 === "capture-opencode-final" || argv2 === "capture-desktop-final" || argv2 === "capture-pi-final")
         return true;
     return argv2 === "capture" || argv2 === "capture-cursor" || argv2 === "capture-copilot" || argv2 === undefined
         ? true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codiedev",
-  "version": "0.9.70",
+  "version": "0.9.72",
   "description": "Connect Claude Code, Codex, Cursor, OpenCode, or VS Code Copilot to Codiedev for team session capture and artifact collaboration — and run the governed Codie harness",
   "bin": {
     "codiedev": "dist/cli.js",
@@ -12,13 +12,13 @@
     "dev": "tsc --watch",
     "prepublishOnly": "tsc",
     "test": "vitest run",
-    "test:functional": "vitest run src/__tests__/limitEvent.functional.test.ts src/__tests__/harnessParity.functional.test.ts src/__tests__/cursorParity.functional.test.ts src/__tests__/copilotCapture.functional.test.ts",
-    "test:harness-parity": "vitest run src/__tests__/harnessParity.functional.test.ts src/__tests__/cursorParity.functional.test.ts src/__tests__/copilotCapture.functional.test.ts",
+    "test:functional": "vitest run src/__tests__/limitEvent.functional.test.ts src/__tests__/harnessParity.functional.test.ts src/__tests__/cursorParity.functional.test.ts src/__tests__/copilotCapture.functional.test.ts src/__tests__/piCapture.functional.test.ts",
+    "test:harness-parity": "vitest run src/__tests__/harnessParity.functional.test.ts src/__tests__/cursorParity.functional.test.ts src/__tests__/copilotCapture.functional.test.ts src/__tests__/piCapture.functional.test.ts",
     "test:harness-binaries": "node scripts/checkHarnessBinaries.mjs",
     "test:watch": "vitest",
     "test:live-sources": "npm run build && node scripts/liveSourceParity.mjs",
     "test:ide-sources": "npm run build && node scripts/liveSourceParity.mjs --ide",
-    "test:metadata-parity": "vitest run src/__tests__/sourceMetadataMatrix.test.ts src/__tests__/copilotCapture.functional.test.ts src/__tests__/copilotCapture.test.ts src/__tests__/cursorParity.functional.test.ts src/__tests__/nativeSourceParity.test.ts src/__tests__/harnessParity.functional.test.ts src/__tests__/subagents.test.ts src/__tests__/transcriptModels.test.ts src/__tests__/captureRetry.test.ts src/__tests__/limitEvent.functional.test.ts src/__tests__/captureExclusions.test.ts"
+    "test:metadata-parity": "vitest run src/__tests__/sourceMetadataMatrix.test.ts src/__tests__/copilotCapture.functional.test.ts src/__tests__/copilotCapture.test.ts src/__tests__/piCapture.functional.test.ts src/__tests__/piHooks.test.ts src/__tests__/cursorParity.functional.test.ts src/__tests__/nativeSourceParity.test.ts src/__tests__/harnessParity.functional.test.ts src/__tests__/subagents.test.ts src/__tests__/transcriptModels.test.ts src/__tests__/captureRetry.test.ts src/__tests__/limitEvent.functional.test.ts src/__tests__/captureExclusions.test.ts"
   },
   "files": [
     "dist",