@golba98/codexa 1.0.1 → 1.0.2

package/src/index.test.tsx

@@ -365,8 +365,9 @@ test("resize repaint does not erase terminal scrollback buffer", async () => {
   const harness = createSupportedHarness();
   startApp(harness.deps);
 
-  // Startup clears only the visible viewport; native terminal scrollback must survive.
-  assert.doesNotMatch(harness.stdout.writes, /\x1b\[3J/, "startup must not erase scrollback");
+  // Startup intentionally clears scrollback (\x1b[3J) so the app opens into a
+  // clean screen. Verify it IS written exactly once during startup.
+  assert.match(harness.stdout.writes, /\x1b\[3J/, "startup must erase scrollback for clean open");
 
   // Capture offset so we can inspect only post-startup writes.
   const startupEnd = harness.stdout.writes.length;
@@ -407,7 +408,8 @@ test("startup writes safe fallback title before repaint and workspace title befo
   const harness = createSupportedHarness();
   startApp(harness.deps);
 
-  const repaintIndex = harness.stdout.writes.indexOf("\x1b[2J\x1b[H");
+  // Startup now writes a full transcript clear: viewport + scrollback + cursor home.
+  const repaintIndex = harness.stdout.writes.indexOf("\x1b[2J\x1b[3J\x1b[H");
   const firstTitleIndex = harness.stdout.writes.indexOf("\x1b]0;");
   const postRepaintTitleIndex = harness.stdout.writes.indexOf("\x1b]0;", repaintIndex + 1);
   const bracketedPasteIndex = harness.stdout.writes.indexOf("\x1b[?2004h");

package/src/index.tsx

@@ -19,6 +19,7 @@ import {
   traceTerminalClear,
   writeTerminalControl,
 } from "./core/terminal/terminalControl.js";
+import { performStartupClear } from "./core/terminal/startupClear.js";
 
 type RenderHandle = Pick<Instance, "clear" | "cleanup" | "waitUntilExit">;
 const KITTY_KEYBOARD_OPTIONS: RenderOptions["kittyKeyboard"] = {
@@ -174,15 +175,18 @@ export function startApp({
     durationMs: 3500,
   });
 
-  // Clear the screen and move cursor to home before rendering so no stale
-  // content from a previous process (e.g. bun --watch restart) ghosts above
-  // the new frame.  We stay in the normal screen buffer (no \x1b[?1049h) to
-  // preserve terminal scrollback and allow mouse text selection.
-  // NOTE: Mouse reporting (\x1b[?1000h / \x1b[?1006h) is NOT enabled here.
-  // It is managed exclusively by the React app (app.tsx) and defaults to OFF
-  // so native terminal drag-selection and copy work without any special steps.
-  traceTerminalClear("src/index.tsx:startup", { mode: "hard" });
-  writeStdout(TERMINAL_SEQUENCES.hardRepaint, "src/index.tsx:startup");
+  // Clear the screen (viewport + scrollback) and move cursor home before Ink
+  // renders the first frame.  This removes any previous terminal content so
+  // the app opens into a clean screen.  We stay in the normal screen buffer
+  // (no \x1b[?1049h) to preserve mouse text selection after exit.
+  // Skipped when --no-clear or CODEXA_NO_CLEAR=1 is set.
+  // NOTE: Mouse reporting is NOT enabled here — managed solely by app.tsx.
+  traceTerminalClear("src/index.tsx:startup", { mode: "transcript" });
+  performStartupClear({
+    write: (c) => writeStdout(c, "src/index.tsx:startup"),
+    noClear: launchArgs.noClear,
+    env,
+  });
   const startupWorkspaceRoot = resolveWorkspaceRoot();
   const startupSettings = loadSettings();
   const startupTitle =

package/src/ui/AppShell.test.tsx

@@ -4,8 +4,9 @@ import React from "react";
 import { PassThrough } from "node:stream";
 import { render, Text } from "ink";
 import type { Screen, TimelineEvent, UIState } from "../session/types.js";
-import { buildRuntimeSummary } from "../config/runtimeConfig.js";
-import { HEADER_CONFIG_DEFAULTS, type HeaderConfig } from "../config/settings.js";
+import { buildRuntimeSummary } from "../config/runtimeConfig.js";
+import { HEADER_CONFIG_DEFAULTS, type HeaderConfig } from "../config/settings.js";
+import type { UpdateCheckResult } from "../core/updateCheck.js";
 import { TEST_RUNTIME } from "../test/runtimeTestUtils.js";
 import { BottomComposer, measureBottomComposerRows } from "./BottomComposer.js";
 import { AppShell, calculateColdStartSpacerRows, calculateHeaderToContentGapRows, calculateNativeSpacerRows } from "./AppShell.js";
@@ -77,6 +78,13 @@ const EVENTS: TimelineEvent[] = [
   },
 ];
 
+const STARTUP_HEADER_CONFIG: HeaderConfig = {
+  ...HEADER_CONFIG_DEFAULTS,
+  showModel: false,
+  showReasoning: false,
+  showContext: true,
+};
+
 function stripAnsi(value: string): string {
   return value.replace(/\u001B\[[0-?]*[ -/]*[@-~]/g, "");
 }
@@ -89,15 +97,16 @@ function sleep(ms = 50): Promise<void> {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
-function renderShell(
-  layoutCols: number,
-  layoutRows: number,
-  uiState: UIState,
-  screen: "main" | "theme-picker" | "model-picker" = "main",
-  panel: React.ReactNode = null,
-  mainPanel: React.ReactNode = null,
-  mainPanelMode: "viewport" | "full-output" = "viewport",
-): Promise<string> {
+function renderShell(
+  layoutCols: number,
+  layoutRows: number,
+  uiState: UIState,
+  screen: "main" | "theme-picker" | "model-picker" = "main",
+  panel: React.ReactNode = null,
+  mainPanel: React.ReactNode = null,
+  mainPanelMode: "viewport" | "full-output" = "viewport",
+  updateCheckResult: UpdateCheckResult | null = null,
+): Promise<string> {
   const stdin = new TestInput();
   const stdout = new TestOutput();
   stdout.columns = layoutCols;
@@ -163,9 +172,11 @@ function renderShell(
             onQuit={() => {}}
           />
         }
-        composerRows={composerRows}
-      />
-    </ThemeProvider>,
+        composerRows={composerRows}
+        headerConfig={STARTUP_HEADER_CONFIG}
+        updateCheckResult={updateCheckResult}
+      />
+    </ThemeProvider>,
     {
       stdin: stdin as unknown as NodeJS.ReadStream,
       stdout: stdout as unknown as NodeJS.WriteStream,
@@ -181,7 +192,28 @@ function renderShell(
     await sleep(20);
     return stripAnsi(output);
   });
-}
+}
+
+test("renders npm update notice when a newer Codexa version is available", async () => {
+  const output = await renderShell(
+    120,
+    40,
+    { kind: "IDLE" },
+    "main",
+    null,
+    null,
+    "viewport",
+    {
+      status: "update-available",
+      currentVersion: "1.0.1",
+      latestVersion: "1.0.2",
+      checkedAt: Date.now(),
+    },
+  );
+
+  assert.match(stripAnsi(output), /Update available: Codexa 1\.0\.2 is available\. You are using 1\.0\.1\./);
+  assert.match(stripAnsi(output), /Run: npm install -g @golba98\/codexa@latest/);
+});
 
 function renderStartupShell(
   layoutCols: number,
@@ -256,6 +288,7 @@ function renderStartupShell(
           />
         }
         composerRows={composerRows}
+        headerConfig={STARTUP_HEADER_CONFIG}
       />
     </ThemeProvider>,
     {
@@ -283,13 +316,17 @@ test("startup uses the large logo only when the viewport height can contain it",
   assert.match(output, /\n╭[─]+╮\n│ ❯/);
 });
 
-test("startup uses live compact header at normal shorter terminal height", async () => {
+test("startup uses stacked ASCII header at normal shorter terminal width", async () => {
   const output = await renderStartupShell(100, 24);
 
+  assert.match(output, /██████/);
   assert.match(output, /Codexa v/);
   assert.match(output, /C:\\Development\\1-JavaScript\\13-Custom CLI/);
+  assert.match(output, /Provider: Codexa Core/);
+  assert.match(output, /Context: Unknown/);
+  assert.doesNotMatch(output, /Model: gpt-5\.4/);
+  assert.doesNotMatch(output, /Reasoning:/);
   assert.match(output, /\n╭[─]+╮\n│ ❯/);
-  assert.doesNotMatch(output, /██████/);
 });
 
 test("startup micro mode keeps the live header and composer visible", async () => {
@@ -551,22 +588,22 @@ test("cold-start header gap adapts to terminal height", () => {
     layoutMode: "micro",
     availableRows: 9,
   }), 1);
-  // full 30-row medium: measureTopHeaderRows=8 (1+6+1), headerToContentGap=1, shellHeight=29
+  // full 30-row medium: measureTopHeaderRows=7 (1+6+0), headerToContentGap=1, shellHeight=29
   assert.equal(calculateColdStartSpacerRows({
     shellRows: 29,
     headerRows: 8,
     composerRows: 7,
     layoutMode: "full",
     availableRows: 11,
-  }), 4);
-  // full 40-row tall: measureTopHeaderRows=9 (1+6+2), headerToContentGap=1, shellHeight=39
+  }), 1);
+  // full 40-row tall: measureTopHeaderRows=7 (1+6+0), headerToContentGap=1, shellHeight=39
   assert.equal(calculateColdStartSpacerRows({
     shellRows: 39,
     headerRows: 9,
     composerRows: 7,
     layoutMode: "full",
     availableRows: 20,
-  }), 6);
+  }), 1);
 });
 
 test("cold-start header gap is capped by available rows", () => {
@@ -576,7 +613,7 @@ test("cold-start header gap is capped by available rows", () => {
     composerRows: 7,
     layoutMode: "full",
     availableRows: 2,
-  }), 2);
+  }), 1);
 });
 
 test("header-to-content gap is reserved outside the hero", () => {
@@ -1156,7 +1193,7 @@ test("project instructions render with breathing room below the live header", as
   const projectRow = rows.findIndex((row) => row.includes("Project instructions"));
 
   assert.ok(lastLogoRow >= 0, "logo should render");
-  assert.ok(projectRow > lastLogoRow + 2, "project instructions should not touch the logo block");
+  assert.ok(projectRow > lastLogoRow + 1, "project instructions should not touch the logo block");
   assertHeaderBefore(raw, "Project instructions");
   assert.equal(countLogoInOutput(raw), 1, "project instruction notice must not add a transcript banner");
 });

package/src/ui/AppShell.tsx

@@ -1,5 +1,7 @@
 import React, { memo, useEffect, useMemo, useRef, useState } from "react";
 import { Box, Text, useStdin } from "ink";
+import { useTheme } from "./theme.js";
+import type { UpdateCheckResult } from "../core/updateCheck.js";
 import type { RuntimeSummary } from "../config/runtimeConfig.js";
 import type { CodexAuthState } from "../core/auth/codexAuth.js";
 import { HEADER_CONFIG_DEFAULTS, type HeaderConfig } from "../config/settings.js";
@@ -25,9 +27,9 @@ import { buildNativeTranscriptParts, type NativeTranscriptRowItem, type Timeline
 import type { TerminalSelectionProfile } from "../core/terminal/terminalSelection.js";
 import { MemoizedTopHeader, measureTopHeaderRows } from "./TopHeader.js";
 
-const COMPACT_HEADER_TO_COMPOSER_GAP_ROWS = 2;
-const MEDIUM_HEADER_TO_COMPOSER_GAP_ROWS = 4;
-const TALL_HEADER_TO_COMPOSER_GAP_ROWS = 6;
+const COMPACT_HEADER_TO_COMPOSER_GAP_ROWS = 1;
+const MEDIUM_HEADER_TO_COMPOSER_GAP_ROWS = 1;
+const TALL_HEADER_TO_COMPOSER_GAP_ROWS = 1;
 
 // ─── Types & constants ────────────────────────────────────────────────────────
 
@@ -57,6 +59,7 @@ export interface AppShellProps {
   selectionProfile?: TerminalSelectionProfile;
   clearCount?: number;
   headerConfig?: HeaderConfig;
+  updateCheckResult?: UpdateCheckResult | null;
 }
 
 // ─── Helpers & subcomponents ─────────────────────────────────────────────────
@@ -161,7 +164,9 @@ function AppShellInner({
   selectionProfile,
   clearCount = 0,
   headerConfig = HEADER_CONFIG_DEFAULTS,
+  updateCheckResult = null,
 }: AppShellProps) {
+  const theme = useTheme();
   renderDebug.useRenderDebug("AppShell", {
     cols: layout.cols,
     rows: layout.rows,
@@ -188,7 +193,7 @@ function AppShellInner({
 
   const shellWidth = getShellWidth(layout.cols);
   const shellHeight = getShellHeight(layout.rows);
-  const headerRows = measureTopHeaderRows(layout);
+  const headerRows = measureTopHeaderRows(layout, headerConfig);
   const headerToContentGapRows = calculateHeaderToContentGapRows(layout);
   const showComposer = screen === "main";
   const showMainPanel = screen === "main" && mainPanel !== undefined && mainPanel !== null;
@@ -500,6 +505,17 @@ function AppShellInner({
     ? React.cloneElement(composer as React.ReactElement<{ selectionProfile?: TerminalSelectionProfile }>, { selectionProfile })
     : composer;
 
+  const updateNotice = updateCheckResult?.status === "update-available" ? (
+    <Box paddingX={1} flexDirection="column">
+      <Text color={theme.WARNING}>
+        {`Update available: Codexa ${updateCheckResult.latestVersion ?? "unknown"} is available. You are using ${updateCheckResult.currentVersion}.`}
+      </Text>
+      <Text color={theme.WARNING}>
+        {"Run: npm install -g @golba98/codexa@latest"}
+      </Text>
+    </Box>
+  ) : null;
+
   if (showMainPanelFullOutput) {
     return (
       <Box flexDirection="column" width="100%">
@@ -512,6 +528,8 @@ function AppShellInner({
             headerConfig={headerConfig}
           />
 
+          {updateNotice}
+
           {headerToContentGapRows > 0 && (
             <Box height={headerToContentGapRows} />
           )}
@@ -542,6 +560,8 @@ function AppShellInner({
           headerConfig={headerConfig}
         />
 
+        {updateNotice}
+
         {headerToContentGapRows > 0 && (
           <Box height={headerToContentGapRows} />
         )}
@@ -596,6 +616,8 @@ function AppShellInner({
           headerConfig={headerConfig}
         />
 
+        {updateNotice}
+
         {headerToContentGapRows > 0 && (
           <Box height={headerToContentGapRows} />
         )}
@@ -692,7 +714,8 @@ export const AppShell = memo(AppShellInner, (prev, next) => {
     prev.verboseMode     === next.verboseMode     &&
     prev.mouseCapture    === next.mouseCapture    &&
     prev.onMouseActivity === next.onMouseActivity &&
-    prev.clearCount      === next.clearCount      &&
+    prev.clearCount         === next.clearCount         &&
+    prev.updateCheckResult  === next.updateCheckResult  &&
     panelPropsEqual
   );
 });