codiedev 0.9.69 → 0.9.70

package/dist/hook.js

@@ -546,6 +546,7 @@ async function main() {
     // which is what makes a pnpm install safe to upgrade.
     if (migrated.length === 0)
         (0, selfUpdate_1.maybeSpawnSelfUpdate)(process.argv[1]);
+    (0, selfUpdate_1.maybeRefreshInstructions)();
     let hookInput = {};
     try {
         const raw = await readStdin();

package/dist/selfUpdate.d.ts

@@ -38,6 +38,13 @@ export declare function readSelfUpdateState(): SelfUpdateState | null;
  * child, not one each; the child's lock covers whatever still slips through.
  */
 export declare function maybeSpawnSelfUpdate(hookEntry: string | undefined): void;
+/**
+ * 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.
+ */
+export declare function maybeRefreshInstructions(refresh?: () => string[]): void;
 /**
  * Where the just-installed copy lives. npm/bun reinstall in place. pnpm's
  * `root -g` is <root>/node_modules up to v10 but the bare global/v11 parent

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

@@ -129,6 +129,19 @@ export declare function installCodexInstructions(): void;
 export declare function copilotInstructionsPath(): string;
 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.

package/dist/utils.js

@@ -79,6 +79,8 @@ exports.installCodexInstructions = installCodexInstructions;
 exports.copilotInstructionsPath = copilotInstructionsPath;
 exports.installCopilotInstructions = installCopilotInstructions;
 exports.installCursorInstructions = installCursorInstructions;
+exports.installedInstructionsTargets = installedInstructionsTargets;
+exports.refreshInstalledInstructions = refreshInstalledInstructions;
 exports.installClaudeCodeMcp = installClaudeCodeMcp;
 exports.installCursorMcp = installCursorMcp;
 exports.installVSCodeMcp = installVSCodeMcp;
@@ -1645,6 +1647,45 @@ 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 },
+    ];
+}
+/**
+ * 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 {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codiedev",
-  "version": "0.9.69",
+  "version": "0.9.70",
   "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",