@golba98/codexa 1.0.3 → 1.0.4

package/README.md

@@ -507,7 +507,11 @@ npm view @golba98/codexa versions --json
 npm view @golba98/codexa dist-tags --json
 ```
 
-If `dist-tags.latest` points to an older version, v1.0.3 may not have been published yet, or the `latest` tag may need to be updated. Until v1.0.3 is published to npm, `@latest` will resolve to the highest published version.
+If `dist-tags.latest` points to an older version, the registry may be slow to propagate. Wait a few minutes and retry, or install a specific version explicitly:
+
+```bash
+npm install -g @golba98/codexa@1.0.3
+```
 
 ### `codexa --version` still shows an old version after updating
 
@@ -575,6 +579,12 @@ npm install -g @golba98/codexa@latest
 
 Codexa checks for updates on startup and caches the result for 6 hours (stored in `~/.codexa-update-check.json`). The update notice only appears when the npm registry `latest` version is newer than the running version.
 
+Published npm versions are immutable. Versions before the fixed update checker may not show update notices even when a newer package exists. If in doubt, update directly:
+
+```bash
+npm install -g @golba98/codexa@latest
+```
+
 If you expect a notice but don't see one:
 
 1. Check the current registry state: `npm view @golba98/codexa dist-tags --json`
@@ -596,22 +606,11 @@ If you expect a notice but don't see one:
 
 See [CHANGELOG.md](CHANGELOG.md) for the full release history.
 
-**Current release: v1.0.3**
-
-v1.0.3 is a package correctness and release-process fix:
-- The installed `npm` package now shows the full Codexa UI (logo, header, workspace, provider)
-- `APP_VERSION` in the package is guaranteed to match `package.json` at publish time
-- Test files are excluded from the published tarball
-- Semantic color-token system (`logoPrimary`, `text`, `textMuted`, etc.)
-- Responsive ASCII logo with three fallback sizes
-
-> Once v1.0.3 is published to npm, users on v1.0.2 will see the in-app update notice within 6 hours (cache TTL). To trigger it immediately: delete `~/.codexa-update-check.json` and restart Codexa.
-
-## Repo Hygiene
+**Current release: v1.0.4**
 
-Local-only files kept out of version control:
+v1.0.4 is an update-notice reliability fix:
+- Older installed versions can detect when npm `latest` is newer
+- `/update check` bypasses stale cache and reports a useful status
+- Failed registry lookups do not get cached as “up to date”
 
-- `node_modules/`
-- `.claude/`
-- `.env` and other local secret files
-- Editor, OS, and cache files
+> Versions before the fixed update checker may not show update notices. Update directly with `npm install -g @golba98/codexa@latest`.

package/bin/codexa.js

@@ -10,13 +10,10 @@ process.title = "CODEXA";
 const currentFile = fileURLToPath(import.meta.url);
 const packageRoot = dirname(dirname(currentFile));
 const forwardArgs = process.argv.slice(2);
-const workspaceRoot = process.cwd();
-const launcherStartTimeMs = Number(process.env.CODEXA_EXEC_TIMING_EPOCH_MS) || Date.now();
-let launcherPreviousElapsedMs = 0;
-const titleSequencePattern = /\x1b\](?:0|2);[^\x07]*(?:\x07|\x1b\\)/g;
-const titleSequenceDetectPattern = /\x1b\]([02]);([\s\S]*?)(?:\x07|\x1b\\)/g;
-const incompleteTitleSequencePattern = /\x1b\](?:0|2);[^\x07]*$/;
-let intendedTerminalTitle = "Codexa";
+const workspaceRoot = process.cwd();
+const launcherStartTimeMs = Number(process.env.CODEXA_EXEC_TIMING_EPOCH_MS) || Date.now();
+let launcherPreviousElapsedMs = 0;
+let intendedTerminalTitle = "Codexa";
 
 function writeRenderDebugRecord(kind, fields) {
   if (process.env.CODEXA_RENDER_DEBUG !== "1" && process.env.CODEXA_DEBUG_RENDER !== "1") {
@@ -24,10 +21,10 @@ function writeRenderDebugRecord(kind, fields) {
   }
 
   try {
-    const debugDir = join(workspaceRoot, ".codexa-debug");
-    mkdirSync(debugDir, { recursive: true });
-    appendFileSync(
-      join(debugDir, "render-debug.log"),
+    const debugDir = join(workspaceRoot, ".codexa", "debug");
+    mkdirSync(debugDir, { recursive: true });
+    appendFileSync(
+      process.env.CODEXA_RENDER_DEBUG_FILE?.trim() || join(debugDir, "render-status.log"),
       JSON.stringify({
         ts: Date.now(),
         pid: process.pid,
@@ -58,11 +55,13 @@ function writeTerminalTitleDebugRecord(fields) {
     return;
   }
 
-  try {
-    const debugDir = join(workspaceRoot, ".codexa-debug");
-    mkdirSync(debugDir, { recursive: true });
-    appendFileSync(
-      process.env.CODEXA_TERMINAL_TITLE_DEBUG_FILE?.trim() || join(debugDir, "terminal-title-debug.log"),
+  try {
+    const debugDir = join(workspaceRoot, ".codexa", "debug");
+    mkdirSync(debugDir, { recursive: true });
+    appendFileSync(
+      process.env.CODEXA_TERMINAL_TITLE_DEBUG_FILE?.trim()
+        || process.env.CODEXA_RENDER_DEBUG_FILE?.trim()
+        || join(debugDir, "render-status.log"),
       JSON.stringify({
         ts: Date.now(),
         pid: process.pid,
@@ -76,26 +75,7 @@ function writeTerminalTitleDebugRecord(fields) {
   }
 }
 
-function traceTitleSequences(text, fields) {
-  if (!text) return false;
-  let found = false;
-  titleSequenceDetectPattern.lastIndex = 0;
-  for (let match = titleSequenceDetectPattern.exec(text); match; match = titleSequenceDetectPattern.exec(text)) {
-    found = true;
-    const title = match[2] || "";
-    writeTerminalTitleDebugRecord({
-      event: "terminalTitleSequence",
-      osc: match[1] === "2" ? "OSC 2" : "OSC 0",
-      title,
-      containsWindowsSystem: title.toLowerCase().includes("c:\\windows\\system"),
-      bytes: Buffer.byteLength(match[0] || ""),
-      ...fields,
-    });
-  }
-  return found;
-}
-
-function sanitizeTerminalTitle(title) {
+function sanitizeTerminalTitle(title) {
   return String(title ?? "")
     .replace(/[\u0000-\u001f\u007f]/g, " ")
     .replace(/\x1b/g, "")
@@ -110,63 +90,22 @@ function normalizeTerminalTitle(title) {
   return cleanTitle;
 }
 
-function buildTitleSequence(title) {
-  const safeTitle = normalizeTerminalTitle(title);
-  return `\x1b]0;${safeTitle}\x07\x1b]2;${safeTitle}\x07`;
-}
-
-function writeIntendedTitle(reason, force = true) {
-  const sequence = buildTitleSequence(intendedTerminalTitle);
-  writeRenderDebugRecord("stdout", {
-    event: "directWrite",
-    source: `bin/codexa.js:${reason}`,
-    bytes: Buffer.byteLength(sequence),
-    containsViewportClear: false,
-    containsScrollbackClear: false,
-    containsCursorHome: false,
-    containsTerminalReset: false,
-    containsTitleSequence: true,
-  });
-  process.stdout.write(sequence);
-  writeTerminalTitleDebugRecord({
-    event: "codexaTitleWrite",
-    source: `bin/codexa.js:${reason}`,
-    title: intendedTerminalTitle,
-    reason,
-    force,
-    bytes: Buffer.byteLength(sequence),
-  });
-}
-
-function startLauncherTitleGuard() {
-  const startedAt = Date.now();
-  const interval = setInterval(() => {
-    if (Date.now() - startedAt >= 2500) {
-      clearInterval(interval);
-      writeIntendedTitle("launcher-title-guard-end");
-      return;
-    }
-    writeIntendedTitle("launcher-title-guard");
-  }, 150);
-  interval.unref?.();
-  return () => clearInterval(interval);
-}
-
-function createTitleStripper(fields) {
-  let carryover = "";
-  return (chunk) => {
-    const input = carryover + Buffer.from(chunk).toString("utf8");
-    carryover = "";
-    const incomplete = incompleteTitleSequencePattern.exec(input);
-    const processable = incomplete?.index != null ? input.slice(0, incomplete.index) : input;
-    if (incomplete?.index != null) {
-      carryover = input.slice(incomplete.index);
-    }
-    return traceTitleSequences(processable, fields)
-      ? processable.replace(titleSequencePattern, "")
-      : processable;
-  };
-}
+function recordIntendedTitle(reason, force = true) {
+  writeTerminalTitleDebugRecord({
+    event: "codexaTitleSkipped",
+    source: `bin/codexa.js:${reason}`,
+    title: intendedTerminalTitle,
+    reason,
+    force,
+  });
+  writeRenderDebugRecord("title", {
+    event: "launcherTitleSkipped",
+    source: `bin/codexa.js:${reason}`,
+    title: intendedTerminalTitle,
+    reason,
+    force,
+  });
+}
 
 function hasFlag(args, longFlag, shortFlag) {
   for (const arg of args) {
@@ -251,12 +190,10 @@ function markExecTiming(phase, fields = {}) {
 
 markExecTiming("launcher_start", { pid: process.pid });
 
-let stopLauncherTitleGuard = null;
-if (!isHeadlessMode && parentHasTTY) {
-  intendedTerminalTitle = normalizeTerminalTitle(process.env.CODEXA_INITIAL_TERMINAL_TITLE || "Codexa");
-  writeIntendedTitle("launcher-startup-title");
-  stopLauncherTitleGuard = startLauncherTitleGuard();
-}
+if (!isHeadlessMode && parentHasTTY) {
+  intendedTerminalTitle = normalizeTerminalTitle(process.env.CODEXA_INITIAL_TERMINAL_TITLE || "Codexa");
+  recordIntendedTitle("launcher-startup-title-disabled");
+}
 
 if (!isHeadlessMode && hasFlag(forwardArgs, "--help", "-h")) {
   printHelp();
@@ -334,10 +271,10 @@ debugLaunch("resolved launch mode", {
   childStdio,
 });
 
-markExecTiming("bun_spawn_start", { executable: bunExecutable });
-if (!isHeadlessMode && parentHasTTY) {
-  writeIntendedTitle("before-bun-spawn");
-}
+markExecTiming("bun_spawn_start", { executable: bunExecutable });
+if (!isHeadlessMode && parentHasTTY) {
+  recordIntendedTitle("before-bun-spawn-disabled");
+}
 
 const child = spawn(
   bunExecutable,
@@ -361,13 +298,11 @@ const child = spawn(
   },
 );
 
-child.once("spawn", () => {
-  if (!isHeadlessMode && parentHasTTY) {
-    writeIntendedTitle("after-bun-spawn");
-    stopLauncherTitleGuard?.();
-    stopLauncherTitleGuard = null;
-  }
-});
+child.once("spawn", () => {
+  if (!isHeadlessMode && parentHasTTY) {
+    recordIntendedTitle("after-bun-spawn-disabled");
+  }
+});
 
 if (!isHeadlessMode && !parentHasTTY) {
   const mouseFilter = createMouseFilter();
@@ -395,46 +330,29 @@ if (!isHeadlessMode && !parentHasTTY) {
   });
 }
 
-if (!isHeadlessMode) {
-  const stripStdoutTitle = createTitleStripper({
-    source: "bin/codexa.js:bun.stdout",
-    stream: "stdout",
-    origin: "child",
-    action: "stripped",
-  });
-  const stripStderrTitle = createTitleStripper({
-    source: "bin/codexa.js:bun.stderr",
-    stream: "stderr",
-    origin: "child",
-    action: "stripped",
-  });
-
-  child.stdout?.on("data", (chunk) => {
-    const safeChunk = stripStdoutTitle(chunk);
-    if (safeChunk) process.stdout.write(safeChunk);
-  });
-  child.stderr?.on("data", (chunk) => {
-    const safeChunk = stripStderrTitle(chunk);
-    if (safeChunk) process.stderr.write(safeChunk);
-  });
-}
-
-child.on("error", (error) => {
-  if (!isHeadlessMode && parentHasTTY) {
-    writeIntendedTitle("bun-spawn-error");
-  }
+if (!isHeadlessMode) {
+  child.stdout?.on("data", (chunk) => {
+    process.stdout.write(chunk);
+  });
+  child.stderr?.on("data", (chunk) => {
+    process.stderr.write(chunk);
+  });
+}
+
+child.on("error", (error) => {
+  if (!isHeadlessMode && parentHasTTY) {
+    recordIntendedTitle("bun-spawn-error-disabled");
+  }
   markExecTiming("bun_spawn_error", { message: error.message });
   console.error(`Failed to launch Bun: ${error.message}`);
   console.error("Bun is required to launch codexa. Install Bun, then run this command again.");
   process.exit(1);
 });
 
-child.on("close", (code, signal) => {
-  if (!isHeadlessMode && parentHasTTY) {
-    writeIntendedTitle("bun-close");
-    stopLauncherTitleGuard?.();
-    stopLauncherTitleGuard = null;
-  }
+child.on("close", (code, signal) => {
+  if (!isHeadlessMode && parentHasTTY) {
+    recordIntendedTitle("bun-close-disabled");
+  }
   markExecTiming("launcher_exit", { exit_code: code ?? 0, signal: signal ?? null });
   if (signal) {
     process.kill(process.pid, signal);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@golba98/codexa",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Terminal UI for Codexa — TypeScript + Bun + Ink",
   "type": "module",
   "bin": {
@@ -10,8 +10,9 @@
     "start": "bun run --silent src/index.tsx",
     "dev": "bun --watch --silent src/index.tsx",
     "dev:run": "node scripts/run-local-dev.mjs",
-    "install:dev-bin": "node scripts/install-local-dev-bin.mjs",
-    "typecheck": "tsc --noEmit",
+    "install:dev-bin": "node scripts/install-local-dev-bin.mjs",
+    "debug:claude-models": "bun run --silent src/core/providerRuntime/claudeCodeDiscoveryDebug.ts",
+    "typecheck": "tsc --noEmit",
     "test": "bun test",
     "audit:codexa-gap": "node scripts/audit-codexa-capabilities.mjs",
     "smoke:terminal-bench": "node scripts/smoke-terminal-bench.mjs",