codiedev 0.9.69 → 0.9.71

package/dist/selfUpdate.js

@@ -48,6 +48,7 @@ exports.planSelfUpdate = planSelfUpdate;
 exports.isSelfUpdateDue = isSelfUpdateDue;
 exports.readSelfUpdateState = readSelfUpdateState;
 exports.maybeSpawnSelfUpdate = maybeSpawnSelfUpdate;
+exports.maybeRefreshInstructions = maybeRefreshInstructions;
 exports.findInstalledHookScript = findInstalledHookScript;
 exports.runSelfUpdate = runSelfUpdate;
 const fs = __importStar(require("fs"));
@@ -58,6 +59,7 @@ const versionCheck_1 = require("./versionCheck");
 const configDir_1 = require("./configDir");
 const captureLog_1 = require("./captureLog");
 const launcher_1 = require("./launcher");
+const utils_1 = require("./utils");
 const PKG = "codiedev";
 const DAY_MS = 24 * 60 * 60 * 1000;
 const LOCK_STALE_MS = 10 * 60 * 1000;
@@ -161,6 +163,43 @@ function maybeSpawnSelfUpdate(hookEntry) {
         // Best-effort; a failed spawn retries tomorrow.
     }
 }
+function instructionsVersionPath() {
+    return path.join((0, configDir_1.codiedevStateDir)(), ".instructions-version");
+}
+/**
+ * First hook call on a new CLI version (self-updated or installed by hand)
+ * re-renders the codiedev block in the harness instruction files, so they
+ * stop listing commands this version no longer has. The steady-state cost is
+ * one small file read. Honors the same opt-outs as the self-update.
+ */
+function maybeRefreshInstructions(refresh = utils_1.refreshInstalledInstructions) {
+    if (process.env.CODIEDEV_NO_AUTO_UPDATE || process.env.CODIEDEV_NO_UPDATE_CHECK)
+        return;
+    try {
+        const marker = instructionsVersionPath();
+        try {
+            if (fs.readFileSync(marker, "utf8").trim() === version_1.CLI_VERSION)
+                return;
+        }
+        catch {
+            // No marker yet: first run on a version that ships this check.
+        }
+        const refreshed = refresh();
+        fs.mkdirSync((0, configDir_1.codiedevStateDir)(), { recursive: true });
+        fs.writeFileSync(marker, version_1.CLI_VERSION, "utf8");
+        if (refreshed.length > 0) {
+            (0, captureLog_1.appendCaptureLog)({
+                stage: "self-update",
+                sessionId: undefined,
+                outcome: "ok",
+                detail: `result=instructions-refreshed version=${version_1.CLI_VERSION} files=${refreshed.length}`,
+            });
+        }
+    }
+    catch {
+        // Best-effort; retried on the next hook call.
+    }
+}
 function acquireLock() {
     const lock = lockPath();
     try {

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,8 +144,26 @@ 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 {
+    path: string;
+    body: string;
+}
+export declare function installedInstructionsTargets(): InstructionsTarget[];
+/**
+ * Re-render the codiedev block in every instructions file that already has
+ * one, so an upgrade (background self-update or a manual `npm i`) stops
+ * teaching retired commands without the user re-running `connect`. Never
+ * creates a file or adds a block: a user who deleted it, or never connected
+ * that harness, is left alone. Returns the paths it rewrote.
+ */
+export declare function refreshInstalledInstructions(targets?: InstructionsTarget[]): string[];
 /**
  * Install the Codiedev MCP server into Claude Code's user-scope config.
  * Safe to call multiple times — updates the existing entry if present.
@@ -199,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;
@@ -211,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,8 +81,12 @@ 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;
+exports.refreshInstalledInstructions = refreshInstalledInstructions;
 exports.installClaudeCodeMcp = installClaudeCodeMcp;
 exports.installCursorMcp = installCursorMcp;
 exports.installVSCodeMcp = installVSCodeMcp;
@@ -138,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() {
@@ -1109,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` +
@@ -1201,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
@@ -1422,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) {
@@ -1599,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}`);
 }
@@ -1645,6 +1827,46 @@ function installCursorInstructions() {
     }
     fs.writeFileSync(CURSOR_RULES_PATH, next, "utf8");
 }
+function installedInstructionsTargets() {
+    const withTeamContext = `${teamSkillContext_1.TEAM_SKILL_CONTEXT}\n\n${CODIEDEV_INSTRUCTIONS_BODY}`;
+    return [
+        { path: CLAUDE_USER_INSTRUCTIONS_PATH, body: CODIEDEV_INSTRUCTIONS_BODY },
+        { path: CODEX_USER_INSTRUCTIONS_PATH, body: CODIEDEV_INSTRUCTIONS_BODY },
+        { path: copilotInstructionsPath(), body: withTeamContext },
+        { path: CURSOR_RULES_PATH, body: withTeamContext },
+        { path: piInstructionsPath(), body: withTeamContext },
+    ];
+}
+/**
+ * Re-render the codiedev block in every instructions file that already has
+ * one, so an upgrade (background self-update or a manual `npm i`) stops
+ * teaching retired commands without the user re-running `connect`. Never
+ * creates a file or adds a block: a user who deleted it, or never connected
+ * that harness, is left alone. Returns the paths it rewrote.
+ */
+function refreshInstalledInstructions(targets = installedInstructionsTargets()) {
+    const refreshed = [];
+    for (const target of targets) {
+        try {
+            const existing = fs.readFileSync(target.path, "utf8");
+            const beginIdx = existing.indexOf(CODIEDEV_INSTRUCTIONS_BEGIN);
+            const endIdx = existing.indexOf(CODIEDEV_INSTRUCTIONS_END);
+            if (beginIdx === -1 || endIdx === -1 || endIdx <= beginIdx)
+                continue;
+            const next = existing.slice(0, beginIdx) +
+                `${CODIEDEV_INSTRUCTIONS_BEGIN}\n${target.body}\n${CODIEDEV_INSTRUCTIONS_END}` +
+                existing.slice(endIdx + CODIEDEV_INSTRUCTIONS_END.length);
+            if (next === existing)
+                continue;
+            fs.writeFileSync(target.path, next, "utf8");
+            refreshed.push(target.path);
+        }
+        catch {
+            // Missing or unreadable file: nothing of ours to refresh.
+        }
+    }
+    return refreshed;
+}
 function readMcpConfigSafely(path) {
     if (!fs.existsSync(path))
         return {};
@@ -2757,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.69",
+  "version": "0.9.71",
   "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",