codiedev 0.9.63 → 0.9.64

package/dist/codexLimitScan.js

@@ -64,10 +64,10 @@ exports.sweepCodexLimits = sweepCodexLimits;
 // after the block: in one real 44 MB rollout the marker sat 1.13 MB from the
 // end, outside the window, and the parse returned null.
 const fs = __importStar(require("fs"));
-const os = __importStar(require("os"));
 const path = __importStar(require("path"));
 const limitEvent_1 = require("./limitEvent");
 const configDir_1 = require("./configDir");
+const harnessDirs_1 = require("./harnessDirs");
 const MARKER = Buffer.from("rate_limit_reached_type");
 const SPEND_MARKER = Buffer.from("spend_control_reached");
 const NEWLINE = 0x0a;
@@ -269,7 +269,7 @@ function sessionIdFromRolloutPath(filePath) {
 }
 /** Where Codex writes its rollout JSONL files. */
 function codexSessionsDir() {
-    return path.join(os.homedir(), ".codex", "sessions");
+    return path.join((0, harnessDirs_1.codexHome)(), "sessions");
 }
 exports.CODEX_LIMIT_STATE_PATH = path.join((0, configDir_1.codiedevStateDir)(), "codex-limit-state.json");
 // Bounds the state file on a machine with a long Codex history.

package/dist/codieLauncher.js

@@ -57,6 +57,7 @@ exports.parseCodieArgs = parseCodieArgs;
 exports.validateCodieArgs = validateCodieArgs;
 const path = __importStar(require("path"));
 const url_1 = require("url");
+const harnessDirs_1 = require("./harnessDirs");
 const DEFAULT_NAMES = {
     "openai/gpt-5.3-codex": "GPT-5.3 Codex",
     "openai/gpt-5.2-codex": "GPT-5.2 Codex",
@@ -342,7 +343,7 @@ function patchBrandWordmark(binary) {
     return { changed: true, offset: matches[0], stock, replacement: Buffer.from(exports.HIDDEN_WORDMARK) };
 }
 function resolveCapturePlugin({ homeDir, existsSync, }) {
-    const capturePath = path.join(homeDir, ".config", "opencode", "plugins", "codiedev.js");
+    const capturePath = path.join((0, harnessDirs_1.openCodeConfigDir)(process.env, homeDir), "plugins", "codiedev.js");
     if (!existsSync(capturePath)) {
         throw new Error("Codiedev session capture is not installed. Run `codiedev connect` first");
     }

package/dist/commands/doctor.d.ts

@@ -1 +1,9 @@
+type CheckStatus = "pass" | "fail" | "warn";
+interface CheckResult {
+    name: string;
+    status: CheckStatus;
+    detail?: string;
+}
+export declare function configDirInUseCheck(agent: string, dir: string, inUse: boolean, envVar: string): CheckResult;
 export declare function runDoctor(_args: string[]): Promise<void>;
+export {};

package/dist/commands/doctor.js

@@ -33,6 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.configDirInUseCheck = configDirInUseCheck;
 exports.runDoctor = runDoctor;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
@@ -46,12 +47,26 @@ const upgradeNudge_1 = require("../upgradeNudge");
 const captureReadiness_1 = require("../captureReadiness");
 const captureLog_1 = require("../captureLog");
 const copilotInstallation_1 = require("../copilotInstallation");
-const CLAUDE_SETTINGS_PATH = path.join(os.homedir(), ".claude", "settings.json");
-const CLAUDE_INSTRUCTIONS_PATH = path.join(os.homedir(), ".claude", "CLAUDE.md");
-const CODEX_HOOKS_PATH = path.join(os.homedir(), ".codex", "hooks.json");
-const CODEX_INSTRUCTIONS_PATH = path.join(os.homedir(), ".codex", "AGENTS.md");
+const harnessDirs_1 = require("../harnessDirs");
+const CLAUDE_DIR = (0, harnessDirs_1.claudeConfigDir)();
+const CLAUDE_SETTINGS_PATH = path.join(CLAUDE_DIR, "settings.json");
+const CLAUDE_INSTRUCTIONS_PATH = path.join(CLAUDE_DIR, "CLAUDE.md");
+const CODEX_DIR = (0, harnessDirs_1.codexHome)();
+const CODEX_HOOKS_PATH = path.join(CODEX_DIR, "hooks.json");
+const CODEX_INSTRUCTIONS_PATH = path.join(CODEX_DIR, "AGENTS.md");
 const CURSOR_HOOKS_PATH = path.join(os.homedir(), ".cursor", "hooks.json");
 const CURSOR_INSTRUCTIONS_PATH = path.join(os.homedir(), ".cursor", "rules", "codiedev.mdc");
+function configDirInUseCheck(agent, dir, inUse, envVar) {
+    return {
+        name: `${agent} reads this config dir`,
+        status: inUse ? "pass" : "warn",
+        detail: inUse
+            ? (0, harnessDirs_1.displayPath)(dir)
+            : `no ${agent} activity in ${(0, harnessDirs_1.displayPath)(dir)} — if you've run ${agent} here, it reads its config from ` +
+                `somewhere else, so the hooks below never fire. Set ${envVar} to that dir (or run as the user that runs ` +
+                `${agent}) and re-run \`codiedev connect\``,
+    };
+}
 function symbol(status) {
     if (status === "pass")
         return "✓";
@@ -60,7 +75,7 @@ function symbol(status) {
     return "✗";
 }
 function codexInstalled() {
-    return fs.existsSync(path.join(os.homedir(), ".codex"));
+    return fs.existsSync(CODEX_DIR);
 }
 function cursorInstalled() {
     return fs.existsSync(path.join(os.homedir(), ".cursor"));
@@ -401,20 +416,25 @@ async function runDoctor(_args) {
         checks.push({
             name: "Claude Code detected",
             status: "pass",
-            detail: "~/.claude",
+            detail: (0, harnessDirs_1.displayPath)(CLAUDE_DIR),
         });
+        // A hook in settings.json only fires if Claude Code actually reads this
+        // dir. If it holds nothing Claude Code writes on use, it's running from
+        // somewhere else (CLAUDE_CONFIG_DIR unset in this shell, another user,
+        // the host vs. a container) and the ✓s below are hollow.
+        checks.push(configDirInUseCheck("Claude Code", CLAUDE_DIR, (0, harnessDirs_1.claudeConfigDirInUse)(CLAUDE_DIR), "CLAUDE_CONFIG_DIR"));
         checks.push({
             name: "Claude Code SessionEnd hook",
             status: hasCodiedevHook(CLAUDE_SETTINGS_PATH, "SessionEnd") ? "pass" : "fail",
             detail: hasCodiedevHook(CLAUDE_SETTINGS_PATH, "SessionEnd")
-                ? "~/.claude/settings.json"
+                ? (0, harnessDirs_1.displayPath)(CLAUDE_SETTINGS_PATH)
                 : "missing — re-run `codiedev connect`",
         });
         checks.push({
             name: "Claude Code agent instructions",
             status: hasCodiedevInstructions(CLAUDE_INSTRUCTIONS_PATH) ? "pass" : "fail",
             detail: hasCodiedevInstructions(CLAUDE_INSTRUCTIONS_PATH)
-                ? "~/.claude/CLAUDE.md"
+                ? (0, harnessDirs_1.displayPath)(CLAUDE_INSTRUCTIONS_PATH)
                 : "missing — re-run `codiedev connect`",
         });
     }
@@ -430,20 +450,21 @@ async function runDoctor(_args) {
         checks.push({
             name: "Codex detected",
             status: "pass",
-            detail: "~/.codex",
+            detail: (0, harnessDirs_1.displayPath)(CODEX_DIR),
         });
+        checks.push(configDirInUseCheck("Codex", CODEX_DIR, (0, harnessDirs_1.codexHomeInUse)(CODEX_DIR), "CODEX_HOME"));
         checks.push({
             name: "Codex Stop hook",
             status: hasCodiedevHook(CODEX_HOOKS_PATH, "Stop") ? "pass" : "fail",
             detail: hasCodiedevHook(CODEX_HOOKS_PATH, "Stop")
-                ? "~/.codex/hooks.json"
+                ? (0, harnessDirs_1.displayPath)(CODEX_HOOKS_PATH)
                 : "missing — re-run `codiedev connect`",
         });
         checks.push({
             name: "Codex agent instructions",
             status: hasCodiedevInstructions(CODEX_INSTRUCTIONS_PATH) ? "pass" : "fail",
             detail: hasCodiedevInstructions(CODEX_INSTRUCTIONS_PATH)
-                ? "~/.codex/AGENTS.md"
+                ? (0, harnessDirs_1.displayPath)(CODEX_INSTRUCTIONS_PATH)
                 : "missing — re-run `codiedev connect`",
         });
     }

package/dist/connect.js

@@ -39,11 +39,13 @@ const https = __importStar(require("https"));
 const http = __importStar(require("http"));
 const crypto = __importStar(require("crypto"));
 const os = __importStar(require("os"));
+const path = __importStar(require("path"));
 const utils_1 = require("./utils");
 const connectFlow_1 = require("./connectFlow");
 const version_1 = require("./version");
 const upgradeNudge_1 = require("./upgradeNudge");
 const shared_1 = require("./commands/shared");
+const harnessDirs_1 = require("./harnessDirs");
 // cli.codiedev.com is a Convex custom domain on the prod deployment; the
 // underlying judicious-falcon-861.convex.site URL keeps serving, so configs
 // written by older CLI versions stay valid without a re-connect.
@@ -304,12 +306,12 @@ async function runConnect(args = []) {
         }
     };
     if (hasClaude) {
-        runInstall("claude-code-hook", utils_1.installHook, "Claude Code SessionEnd (capture) + UserPromptSubmit (skill discovery) + Stop (auto-backup) hooks (~/.claude/settings.json)", "claudeCode-hook");
-        runInstall("claude-code-instructions", utils_1.installClaudeCodeInstructions, "Claude Code agent instructions (~/.claude/CLAUDE.md)", "claudeCode-instructions");
+        runInstall("claude-code-hook", utils_1.installHook, `Claude Code SessionEnd (capture) + UserPromptSubmit (skill discovery) + Stop (auto-backup) hooks (${(0, harnessDirs_1.displayPath)(path.join((0, harnessDirs_1.claudeConfigDir)(), "settings.json"))})`, "claudeCode-hook");
+        runInstall("claude-code-instructions", utils_1.installClaudeCodeInstructions, `Claude Code agent instructions (${(0, harnessDirs_1.displayPath)(path.join((0, harnessDirs_1.claudeConfigDir)(), "CLAUDE.md"))})`, "claudeCode-instructions");
     }
     if (hasCodex) {
-        runInstall("codex-hook", utils_1.installCodexHook, "Codex Stop (capture + auto-backup) hooks (~/.codex/hooks.json)", "codex-hook");
-        runInstall("codex-instructions", utils_1.installCodexInstructions, "Codex agent instructions (~/.codex/AGENTS.md)", "codex-instructions");
+        runInstall("codex-hook", utils_1.installCodexHook, `Codex Stop (capture + auto-backup) hooks (${(0, harnessDirs_1.displayPath)(path.join((0, harnessDirs_1.codexHome)(), "hooks.json"))})`, "codex-hook");
+        runInstall("codex-instructions", utils_1.installCodexInstructions, `Codex agent instructions (${(0, harnessDirs_1.displayPath)(path.join((0, harnessDirs_1.codexHome)(), "AGENTS.md"))})`, "codex-instructions");
     }
     if (hasCursor) {
         runInstall("cursor-hook", utils_1.installCursorHook, "Cursor sessionStart + stop backup + sessionEnd capture hooks (~/.cursor/hooks.json)", "cursor-hook");
@@ -324,7 +326,7 @@ async function runConnect(args = []) {
     // Always stage the adapter. It is dormant until OpenCode starts, which lets
     // a user connect Claude Code today and install the Codie harness tomorrow
     // without needing a second setup ritual.
-    runInstall("opencode-capture-adapter", utils_1.installOpenCodeCapturePlugin, "OpenCode session capture adapter (~/.config/opencode/plugins/codiedev.js)", "opencode-capture");
+    runInstall("opencode-capture-adapter", utils_1.installOpenCodeCapturePlugin, `OpenCode session capture adapter (${(0, harnessDirs_1.displayPath)(path.join((0, harnessDirs_1.openCodeConfigDir)(), "plugins", "codiedev.js"))})`, "opencode-capture");
     // Tell the backend which targets we wired up so the portal's onboarding
     // card flips to "Connected" only when something actually installed —
     // not on bare token validation. Best-effort: a network failure here

package/dist/harnessDirs.d.ts

@@ -0,0 +1,12 @@
+/** Claude Code: `$CLAUDE_CONFIG_DIR` or ~/.claude. */
+export declare function claudeConfigDir(env?: NodeJS.ProcessEnv, home?: string): string;
+/** Claude Code's user state file. Lives inside `$CLAUDE_CONFIG_DIR` when set, else ~/.claude.json. */
+export declare function claudeUserConfigPath(env?: NodeJS.ProcessEnv, home?: string): string;
+/** Codex: `$CODEX_HOME` or ~/.codex. */
+export declare function codexHome(env?: NodeJS.ProcessEnv, home?: string): string;
+/** OpenCode: `$XDG_CONFIG_HOME/opencode` or ~/.config/opencode. */
+export declare function openCodeConfigDir(env?: NodeJS.ProcessEnv, home?: string): string;
+/** `~`-abbreviated path for user-facing output. */
+export declare function displayPath(p: string, home?: string): string;
+export declare function claudeConfigDirInUse(dir?: string, exists?: (p: string) => boolean): boolean;
+export declare function codexHomeInUse(dir?: string, exists?: (p: string) => boolean): boolean;

package/dist/harnessDirs.js

@@ -0,0 +1,90 @@
+"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.claudeConfigDir = claudeConfigDir;
+exports.claudeUserConfigPath = claudeUserConfigPath;
+exports.codexHome = codexHome;
+exports.openCodeConfigDir = openCodeConfigDir;
+exports.displayPath = displayPath;
+exports.claudeConfigDirInUse = claudeConfigDirInUse;
+exports.codexHomeInUse = codexHomeInUse;
+// Where each coding agent reads its user config from. Every harness lets the
+// user relocate it with an env var; installing into the default dir when the
+// var is set writes hooks the agent never loads (a container with
+// CLAUDE_CONFIG_DIR=/home/node/.claude while HOME=/root captured nothing for
+// two weeks while doctor reported ✓). Same shape as copilotHome().
+//
+// Imports only node built-ins so utils.ts, doctor.ts and the hook path
+// can all import it without a cycle.
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+function override(value) {
+    const trimmed = value?.trim();
+    return trimmed ? path.resolve(trimmed) : undefined;
+}
+/** Claude Code: `$CLAUDE_CONFIG_DIR` or ~/.claude. */
+function claudeConfigDir(env = process.env, home = os.homedir()) {
+    return override(env.CLAUDE_CONFIG_DIR) ?? path.join(home, ".claude");
+}
+/** Claude Code's user state file. Lives inside `$CLAUDE_CONFIG_DIR` when set, else ~/.claude.json. */
+function claudeUserConfigPath(env = process.env, home = os.homedir()) {
+    const dir = override(env.CLAUDE_CONFIG_DIR);
+    return dir ? path.join(dir, ".claude.json") : path.join(home, ".claude.json");
+}
+/** Codex: `$CODEX_HOME` or ~/.codex. */
+function codexHome(env = process.env, home = os.homedir()) {
+    return override(env.CODEX_HOME) ?? path.join(home, ".codex");
+}
+/** OpenCode: `$XDG_CONFIG_HOME/opencode` or ~/.config/opencode. */
+function openCodeConfigDir(env = process.env, home = os.homedir()) {
+    return path.join(override(env.XDG_CONFIG_HOME) ?? path.join(home, ".config"), "opencode");
+}
+/** `~`-abbreviated path for user-facing output. */
+function displayPath(p, home = os.homedir()) {
+    return p === home || p.startsWith(home + path.sep) ? "~" + p.slice(home.length) : p;
+}
+// Files/dirs Claude Code writes on first real use. Our installer only writes
+// settings.json + CLAUDE.md, so a dir holding nothing but those is one Claude
+// Code has never run against — the hooks in it will never fire.
+const CLAUDE_USAGE_MARKERS = ["projects", "history.jsonl", "sessions", "statsig", "todos", "shell-snapshots"];
+function claudeConfigDirInUse(dir = claudeConfigDir(), exists = fs.existsSync) {
+    return CLAUDE_USAGE_MARKERS.some((m) => exists(path.join(dir, m)));
+}
+// Codex writes rollouts under sessions/ and keeps history.jsonl alongside.
+const CODEX_USAGE_MARKERS = ["sessions", "history.jsonl", "auth.json"];
+function codexHomeInUse(dir = codexHome(), exists = fs.existsSync) {
+    return CODEX_USAGE_MARKERS.some((m) => exists(path.join(dir, m)));
+}

package/dist/utils.js

@@ -133,6 +133,7 @@ const codexHookTrust_1 = require("./codexHookTrust");
 const teamSkillContext_1 = require("./teamSkillContext");
 const nativeSteering_1 = require("./nativeSteering");
 const copilotHooks_1 = require("./copilotHooks");
+const harnessDirs_1 = require("./harnessDirs");
 const CONFIG_DIR = (0, configDir_1.codiedevStateDir)();
 exports.CONFIG_PATH = path.join(CONFIG_DIR, "config.json");
 function readConfig() {
@@ -886,12 +887,12 @@ function hashToken(token) {
     }
     return hash.toString(36);
 }
-const CLAUDE_SETTINGS_PATH = path.join(os.homedir(), ".claude", "settings.json");
-const CLAUDE_DIR = path.join(os.homedir(), ".claude");
-const CODEX_HOOKS_PATH = path.join(os.homedir(), ".codex", "hooks.json");
-const CODEX_DIR = path.join(os.homedir(), ".codex");
+const CLAUDE_SETTINGS_PATH = path.join((0, harnessDirs_1.claudeConfigDir)(), "settings.json");
+const CLAUDE_DIR = (0, harnessDirs_1.claudeConfigDir)();
+const CODEX_HOOKS_PATH = path.join((0, harnessDirs_1.codexHome)(), "hooks.json");
+const CODEX_DIR = (0, harnessDirs_1.codexHome)();
 const CURSOR_DIR = path.join(os.homedir(), ".cursor");
-const OPENCODE_DIR = path.join(os.homedir(), ".config", "opencode");
+const OPENCODE_DIR = (0, harnessDirs_1.openCodeConfigDir)();
 const OPENCODE_PLUGIN_DIR = path.join(OPENCODE_DIR, "plugins");
 const OPENCODE_PLUGIN_PATH = path.join(OPENCODE_PLUGIN_DIR, "codiedev.js");
 const CURSOR_HOOKS_PATH = path.join(CURSOR_DIR, "hooks.json");
@@ -1433,10 +1434,10 @@ function ensureSessionStartHookInstalled() {
 // MCP server installation — writes the codiedev MCP server config into each
 // agent CLI's expected location so "npx codiedev connect" wires it up once.
 // ─────────────────────────────────────────────────────────────────────────────
-const CLAUDE_USER_CONFIG_PATH = path.join(os.homedir(), ".claude.json");
-const CLAUDE_USER_INSTRUCTIONS_PATH = path.join(os.homedir(), ".claude", "CLAUDE.md");
-const CODEX_USER_INSTRUCTIONS_PATH = path.join(os.homedir(), ".codex", "AGENTS.md");
-const CODEX_CONFIG_PATH = path.join(os.homedir(), ".codex", "config.toml");
+const CLAUDE_USER_CONFIG_PATH = (0, harnessDirs_1.claudeUserConfigPath)();
+const CLAUDE_USER_INSTRUCTIONS_PATH = path.join((0, harnessDirs_1.claudeConfigDir)(), "CLAUDE.md");
+const CODEX_USER_INSTRUCTIONS_PATH = path.join((0, harnessDirs_1.codexHome)(), "AGENTS.md");
+const CODEX_CONFIG_PATH = path.join((0, harnessDirs_1.codexHome)(), "config.toml");
 const CODIEDEV_INSTRUCTIONS_BEGIN = "<!-- codiedev-cli:begin -->";
 const CODIEDEV_INSTRUCTIONS_END = "<!-- codiedev-cli:end -->";
 const CODIEDEV_INSTRUCTIONS_BODY = `## Codiedev — team artifact layer

package/package.json

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