@golba98/codexa 1.0.5 → 1.0.7

package/src/test/runtimeTestUtils.ts

@@ -1,11 +1,4 @@
-import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
 import { resolveRuntimeConfig, type RuntimeConfig, DEFAULT_RUNTIME_CONFIG, type ResolvedRuntimeConfig } from "../config/runtimeConfig.js";
-import type { ProviderId } from "../core/providerLauncher/types.js";
-import { resetAnthropicRouteValidationCacheForTests } from "../core/providerRuntime/anthropic.js";
-import { resetAntigravityRouteValidationCacheForTests } from "../core/providerRuntime/antigravity.js";
-import type { ProviderModel } from "../core/providerRuntime/types.js";
 
 export function makeResolvedRuntime(overrides: Partial<RuntimeConfig> = {}): ResolvedRuntimeConfig {
   return resolveRuntimeConfig({
@@ -19,86 +12,3 @@ export function makeResolvedRuntime(overrides: Partial<RuntimeConfig> = {}): Res
 }
 
 export const TEST_RUNTIME = makeResolvedRuntime();
-
-function agyModel(id: string, label: string): ProviderModel {
-  return {
-    id,
-    modelId: id,
-    label,
-    description: null,
-    defaultReasoningLevel: null,
-    supportedReasoningLevels: null,
-    source: "discovered",
-  };
-}
-
-/**
- * The catalog `agy models` reports on a configured machine. Antigravity resolves
- * its status, backend kind, and model labels from whatever discovery last found,
- * so tests that assert on any of those need a catalog seeded rather than
- * whatever happens to be installed.
- */
-export const ANTIGRAVITY_FIXTURE_MODELS: readonly ProviderModel[] = [
-  agyModel("gemini-3.5-flash", "Gemini 3.5 Flash"),
-  agyModel("gemini-3.1-pro", "Gemini 3.1 Pro"),
-  agyModel("claude-sonnet-4-6", "Claude Sonnet 4.6"),
-  agyModel("claude-sonnet-4-6-think", "Claude Sonnet 4.6 (Thinking)"),
-  agyModel("gpt-oss-120b", "GPT-OSS 120B"),
-];
-
-/**
- * Drops every provider's in-memory discovery result.
- *
- * Bun shares the module registry across test files, so a catalog discovered by
- * one test (some probe the real `claude` / `agy` CLIs) otherwise survives into
- * the next and takes precedence over both the cache and the fallback list —
- * making assertions depend on file order and on what is installed locally.
- */
-export function resetProviderDiscoveryState(): void {
-  resetAntigravityRouteValidationCacheForTests();
-  resetAnthropicRouteValidationCacheForTests();
-}
-
-/**
- * Runs `fn` with HOME pointed at a throwaway directory holding only the provider
- * model cache built from `seed`.
- *
- * Provider discovery reads `~/.codexa-model-cache.json`, so a test that calls it
- * without this is asserting against the developer's own machine — it passes with
- * a warm cache and fails on a cold one (or in CI). HOME is read per call (see
- * `getProviderModelCacheFile`), so redirecting the env var here is enough.
- *
- * Antigravity's in-memory discovery is reset around the body as well: Bun shares
- * the module registry across test files, so a catalog discovered by one file
- * otherwise leaks into the next and takes precedence over the seeded cache,
- * making results depend on file order. Seed exactly what the assertions need.
- */
-export function withSeededModelCache<T>(
-  seed: Partial<Record<ProviderId, readonly ProviderModel[]>>,
-  fn: () => T,
-): T {
-  const tempHome = mkdtempSync(join(tmpdir(), "codexa-test-home-"));
-  const previousHome = process.env.HOME;
-  const previousUserProfile = process.env.USERPROFILE;
-  try {
-    process.env.HOME = tempHome;
-    delete process.env.USERPROFILE;
-    const providers = Object.fromEntries(
-      Object.entries(seed).map(([providerId, models]) => [providerId, { discoveredAt: 1, models }]),
-    );
-    writeFileSync(
-      join(tempHome, ".codexa-model-cache.json"),
-      `${JSON.stringify({ version: 1, providers }, null, 2)}\n`,
-      "utf8",
-    );
-    resetProviderDiscoveryState();
-    return fn();
-  } finally {
-    if (previousHome === undefined) delete process.env.HOME;
-    else process.env.HOME = previousHome;
-    if (previousUserProfile === undefined) delete process.env.USERPROFILE;
-    else process.env.USERPROFILE = previousUserProfile;
-    rmSync(tempHome, { recursive: true, force: true });
-    resetProviderDiscoveryState();
-  }
-}

package/src/ui/chrome/TopHeader.tsx

@@ -2,7 +2,7 @@ import React, { memo } from "react";
 import { Box, Text } from "ink";
 import { HEADER_CONFIG_DEFAULTS, type HeaderConfig } from "../../config/settings.js";
 import { formatCodexaBrandLabel } from "../../core/version/channel.js";
-import { formatVersionLabel } from "../../core/version/updateCheck.js";
+import { CODEXA_UPDATE_COMMAND, formatVersionLabel } from "../../core/version/updateCheck.js";
 import type { RuntimeSummary } from "../../config/runtimeConfig.js";
 import type { CodexAuthState } from "../../core/auth/codexAuth.js";
 import { getAuthStateLabel } from "../../core/auth/codexAuth.js";
@@ -58,6 +58,7 @@ type HeaderMetadataLine = { key: string; text: string; color: string; bold: bool
 export interface UpdateAvailableInfo {
   latestVersion: string;
   currentVersion: string;
+  updateCommand?: string;
 }
 
 interface TopHeaderProps {
@@ -343,6 +344,7 @@ export function TopHeader({
                   <UpdateAvailableCard
                     latestVersion={updateAvailable.latestVersion}
                     currentVersion={updateAvailable.currentVersion}
+                    updateCommand={updateAvailable.updateCommand}
                     width={metadataWidth}
                   />
                   <Box height={UPDATE_CARD_GAP_ROWS} />
@@ -359,7 +361,7 @@ export function TopHeader({
             )}
             {metadataColumn}
             {updateAvailable && (
-              <Text color={theme.warning} wrap="truncate">{`Update available: Codexa ${formatVersionLabel(updateAvailable.latestVersion)} — Run: npm install -g @golba98/codexa@latest`}</Text>
+              <Text color={theme.warning} wrap="truncate">{`Update available: Codexa ${formatVersionLabel(updateAvailable.latestVersion)} — Run: ${updateAvailable.updateCommand ?? CODEXA_UPDATE_COMMAND}`}</Text>
             )}
           </Box>
         )}

package/src/ui/chrome/UpdateAvailableCard.tsx

@@ -10,13 +10,14 @@ export const UPDATE_CARD_ROWS = UPDATE_CARD_CONTENT_ROWS + 2; // +2 for top/bott
 export interface UpdateAvailableCardProps {
   latestVersion: string;
   currentVersion: string;
+  updateCommand?: string;
   /** Total box width including borders. Long lines are truncated to fit. */
   width?: number;
 }
 
-export function UpdateAvailableCard({ latestVersion, currentVersion, width }: UpdateAvailableCardProps) {
+export function UpdateAvailableCard({ latestVersion, currentVersion, updateCommand = CODEXA_UPDATE_COMMAND, width }: UpdateAvailableCardProps) {
   const theme = useTheme();
-  const command = `Run: ${CODEXA_UPDATE_COMMAND}`;
+  const command = `Run: ${updateCommand}`;
   // Inner content width = boxWidth - 2 (left/right border cols)
   const innerWidth = width !== undefined ? Math.max(8, width - 2) : undefined;
 

package/src/ui/input/slashCommands.ts

@@ -24,6 +24,7 @@ export const SLASH_COMMANDS = [
   { cmd: "/auth", desc: "Manage authentication" },
   { cmd: "/workspace", desc: "Show the locked workspace" },
   { cmd: "/copy", desc: "Copy the full conversation transcript to clipboard" },
+  { cmd: "/update", desc: "Check for updates and install the latest Codexa" },
   { cmd: "/mouse", desc: "Toggle mouse capture for wheel scrolling (off by default)" },
   { cmd: "/exit", desc: "Quit the application" },
 ] as const satisfies readonly SlashCommandSuggestion[];

package/src/ui/panels/AttachmentImportPanel.tsx

@@ -43,7 +43,8 @@ export function AttachmentImportPanel({
     }
   }, { isActive: isFocused });
 
-  const relativeAttachmentsDir = path.relative(workspaceRoot, attachmentsDir).replace(/\\/g, "/");
+  const relativeAttachmentsDir = path.relative(workspaceRoot, attachmentsDir).replace(/\\/g, "/");
+  const displayedAttachmentsDir = relativeAttachmentsDir.startsWith("..") ? attachmentsDir : relativeAttachmentsDir;
   const hasImages = files.some((f) => f.isImage);
   const showVisionWarning = hasImages && modelSupportsVision === false;
   const fileLabel = files.length === 1 ? "file" : "files";
@@ -59,7 +60,7 @@ export function AttachmentImportPanel({
       >
         <Text color={theme.accent} bold>IMPORT FILE  </Text>
         <Text color={theme.textMuted}>
-          Copy {files.length} outside-workspace {fileLabel} into .codexa/attachments?
+          Copy {files.length} outside-workspace {fileLabel} into {displayedAttachmentsDir}?
         </Text>
       </Box>
 
@@ -76,7 +77,7 @@ export function AttachmentImportPanel({
           <Box key={i} flexDirection="column" marginBottom={i < files.length - 1 ? 1 : 0}>
             <Text color={theme.text}>{path.basename(file.srcPath)}</Text>
             <Text color={theme.textDim}>
-              {"→ "}{relativeAttachmentsDir}/{file.destFilename}
+              {"→ "}{displayedAttachmentsDir}/{file.destFilename}
             </Text>
           </Box>
         ))}

package/src/ui/panels/UpdatePromptPanel.tsx

@@ -1,31 +1,45 @@
 import React, { useEffect, useRef, useState } from "react";
 import { Box, Text, useFocus, useInput } from "ink";
-import { spawn } from "child_process";
 import { useTheme } from "../theme.js";
-import { CODEXA_NPM_PACKAGE, CODEXA_UPDATE_COMMAND, formatVersionLabel } from "../../core/version/updateCheck.js";
+import { CODEXA_NPM_PACKAGE, formatVersionLabel } from "../../core/version/updateCheck.js";
+import {
+  formatPermissionGuidance,
+  getUpdateCommand,
+  isPermissionError,
+  runUpdateCommand,
+  type GlobalPackageManager,
+} from "../../core/version/packageManager.js";
+import type { CommandResult, CommandStreamHandlers } from "../../core/process/CommandRunner.js";
 
 type Phase = "menu" | "running" | "done" | "error";
 
+export type RunUpdateFn = (
+  pm: GlobalPackageManager,
+  handlers?: CommandStreamHandlers,
+) => { result: Promise<CommandResult>; cancel: () => void };
+
 const MENU_ITEMS = [
   { label: "Update now" },
-  { label: "Skip" },
-  { label: "Skip until next version" },
+  { label: "Later" },
 ] as const;
 
 interface UpdatePromptPanelProps {
   focusId: string;
   currentVersion: string;
   latestVersion: string;
+  packageManager: GlobalPackageManager;
+  /** Test seam — defaults to the real cross-platform runner. */
+  runUpdate?: RunUpdateFn;
   onSkip: () => void;
-  onSkipUntilNextVersion: (version: string) => void;
 }
 
 export function UpdatePromptPanel({
   focusId,
   currentVersion,
   latestVersion,
+  packageManager,
+  runUpdate,
   onSkip,
-  onSkipUntilNextVersion,
 }: UpdatePromptPanelProps) {
   const theme = useTheme();
   const { isFocused } = useFocus({ id: focusId, autoFocus: true });
@@ -35,7 +49,7 @@ export function UpdatePromptPanel({
   const [outputLines, setOutputLines] = useState<string[]>([]);
   const [errorMessage, setErrorMessage] = useState<string | null>(null);
 
-  const spawnStartedRef = useRef(false);
+  const runStartedRef = useRef(false);
 
   useInput((input, key) => {
     if (key.escape) {
@@ -54,10 +68,8 @@ export function UpdatePromptPanel({
       if (key.return) {
         if (selectedIndex === 0) {
           setPhase("running");
-        } else if (selectedIndex === 1) {
-          onSkip();
         } else {
-          onSkipUntilNextVersion(latestVersion);
+          onSkip();
         }
         return;
       }
@@ -70,42 +82,42 @@ export function UpdatePromptPanel({
 
   useEffect(() => {
     if (phase !== "running") return;
-    if (spawnStartedRef.current) return;
-    spawnStartedRef.current = true;
+    if (runStartedRef.current) return;
+    runStartedRef.current = true;
 
-    const child = spawn("npm", ["install", "-g", `${CODEXA_NPM_PACKAGE}@latest`], {
-      shell: false,
-      stdio: ["ignore", "pipe", "pipe"],
-    });
-
-    const appendLines = (buf: Buffer) => {
-      const lines = buf.toString("utf8").split(/\r?\n/).filter(Boolean);
+    const appendLines = (text: string) => {
+      const lines = text.split(/\r?\n/).filter(Boolean);
       if (lines.length > 0) {
         setOutputLines((prev) => [...prev, ...lines]);
       }
     };
 
-    child.stdout?.on("data", appendLines);
-    child.stderr?.on("data", appendLines);
-
-    child.once("error", (err: Error) => {
-      setErrorMessage(err.message);
-      setPhase("error");
+    const runner = runUpdate ?? runUpdateCommand;
+    const { result, cancel } = runner(packageManager, {
+      onStdout: appendLines,
+      onStderr: appendLines,
     });
 
-    child.once("close", (code: number | null) => {
-      if (code === 0) {
+    let disposed = false;
+    void result.then((res) => {
+      if (disposed) return;
+      if (res.status === "completed" && res.exitCode === 0) {
         setPhase("done");
+        return;
+      }
+      if (isPermissionError(res)) {
+        setErrorMessage(formatPermissionGuidance(packageManager));
       } else {
-        setErrorMessage(`npm exited with code ${code ?? "unknown"}.`);
-        setPhase("error");
+        setErrorMessage(res.userMessage);
       }
+      setPhase("error");
     });
 
     return () => {
-      try { child.kill(); } catch { /* ignore */ }
+      disposed = true;
+      cancel();
     };
-  }, [phase]);
+  }, [phase, packageManager, runUpdate]);
 
   const footerText = phase === "menu"
     ? "Esc to close · Enter to confirm"
@@ -122,16 +134,16 @@ export function UpdatePromptPanel({
         flexDirection="column"
       >
         <Box>
-          <Text color={theme.accent} bold>{`Update available: Codexa ${formatVersionLabel(latestVersion)}`}</Text>
+          <Text color={theme.accent} bold>{`Update available: Codexa ${latestVersion}`}</Text>
         </Box>
         <Box marginTop={1}>
-          <Text color={theme.text}>{`${formatVersionLabel(currentVersion)} -> ${formatVersionLabel(latestVersion)}`}</Text>
+          <Text color={theme.text}>{`Current version: ${currentVersion}`}</Text>
         </Box>
         <Box>
           <Text color={theme.textMuted}>{`Package: ${CODEXA_NPM_PACKAGE}`}</Text>
         </Box>
         <Box>
-          <Text color={theme.textMuted}>{`Run: ${CODEXA_UPDATE_COMMAND}`}</Text>
+          <Text color={theme.textMuted}>{`Run: ${getUpdateCommand(packageManager).displayCommand}`}</Text>
         </Box>
       </Box>
 
@@ -146,19 +158,17 @@ export function UpdatePromptPanel({
       >
         {phase === "menu" && (
           <>
-            {MENU_ITEMS.map((item, index) => (
-              <Box key={item.label}>
-                <Text color={index === selectedIndex ? theme.accent : theme.textMuted}>
-                  {index === selectedIndex ? "› " : "  "}
-                </Text>
+            <Box>
+              {MENU_ITEMS.map((item, index) => (
                 <Text
+                  key={item.label}
                   color={index === selectedIndex ? theme.text : theme.textMuted}
                   bold={index === selectedIndex}
                 >
-                  {`${index + 1}. ${item.label}`}
+                  {`[ ${item.label} ]${index === 0 ? "  " : ""}`}
                 </Text>
-              </Box>
-            ))}
+              ))}
+            </Box>
           </>
         )}
 
@@ -173,7 +183,7 @@ export function UpdatePromptPanel({
 
         {phase === "done" && (
           <>
-            <Text color={theme.success}>{"Codexa was updated successfully."}</Text>
+            <Text color={theme.success}>{`Codexa ${formatVersionLabel(latestVersion)} installed successfully.`}</Text>
             <Text color={theme.textMuted}>{"Restart Codexa to use the new version."}</Text>
           </>
         )}