@compilr-dev/cli 0.6.1 → 0.6.3

package/CHANGELOG.md

@@ -0,0 +1,104 @@
+# Changelog
+
+All notable changes to `@compilr-dev/cli` are documented here.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+> **Beta notice:** versions in the `0.x` range may contain breaking changes
+> between minors. Read each release entry before upgrading.
+
+---
+
+## [Unreleased]
+
+## [0.6.2] — 2026-04-25
+
+### Fixed
+- Respect the [`NO_COLOR`](https://no-color.org) standard — `NO_COLOR=1 compilr ...`
+  now produces uncolored output instead of being silently overridden by
+  `FORCE_COLOR=3`. Restores accessibility for screen readers, low-contrast
+  terminals, log redirection, and CI environments.
+
+### Changed
+- Lower minimum supported Node from `>=22.0.0` to `>=20.0.0` — Node 20 is the
+  active LTS line and the codebase uses no v22-only APIs. Restores compatibility
+  for users still on Node 20 LTS.
+
+### Added
+- Documented opt-outs for the npm registry update check. Set any of the
+  following to skip the network call on startup:
+  - `COMPILR_NO_UPDATE_CHECK=1` (project-specific)
+  - `NO_UPDATE_NOTIFIER=1` (de-facto standard from `update-notifier`)
+  - `CI=true` (auto-respected in CI)
+- `CHANGELOG.md` shipped in the published tarball (this file).
+
+### Removed
+- TypeScript incremental build caches (`*.tsbuildinfo`) no longer ship in the
+  npm tarball. Tarball is now ~760 KB compressed (previously ~1 MB) — about
+  ~660 KB lighter on disk after install.
+
+---
+
+## [0.6.1] — 2026-04-21
+
+### Fixed
+- Resolved `npm audit` vulnerabilities in transitive deps (`hono`, `protobufjs`).
+
+## [0.6.0] — 2026-04-19
+
+### Changed
+- **Major:** CLI now builds on `createCompilrAgent` from `@compilr-dev/sdk`
+  (universal agent runtime). All agent setup, tool assembly, capability
+  loading, and team coordination flow through the SDK. CLI source dropped
+  from ~3.5 K LOC of agent wiring to a thin adapter.
+- Logging is now structured JSON via `@compilr-dev/logger` (Pino) — no more
+  raw `console.log` from diagnostic paths. Logs are scrubbed for secrets.
+
+### Added
+- Plan Mode V2 — permission-blocking + tool-based transitions for safer
+  multi-step planning workflows. Plan can now be approved/edited from
+  inside the CLI.
+- `/app` command — terminal app model viewer overlay (entities, fields,
+  relationships, layout, config). Aligned columns, no emojis.
+- Custom agent wizard Step 5 — free-text custom instructions added per agent.
+- Template support in custom agent wizard — `Ctrl+T` to save as template,
+  list UI to load existing templates.
+- Guide tool migrated to SDK (`createGuideTool({ environment, additionalEntries })`).
+- Removed two-repo and guided-workflow options from the wizard — both are
+  always single-repo + flexible now.
+
+### Fixed
+- Credential encryption now survives container restarts (master key
+  derivation hardened).
+- `/app` overlay — aligned columns, layout/config in summary, no emojis.
+- Agent IDs may contain dashes.
+
+## [0.5.x] — 2026-03 → 2026-04
+
+Highlights from the 0.5 line:
+
+- Migrated more code paths to `@compilr-dev/sdk` (anchors, MCP, permissions,
+  SQLite repositories, capability loading).
+- Pin API replaces the older anchor API for project state injection.
+- Multi-terminal session awareness, dynamic capability loading with
+  auto-load on filtered tool use, observation masking, tool input
+  compaction, and tool result auto-delegation.
+- Multi-LLM support across 9 providers (Claude, OpenAI, Gemini, Groq,
+  Fireworks, Together, Perplexity, OpenRouter, Ollama).
+- Multi-agent teams (delegate, delegate_background, $mention routing,
+  /team dashboard, background queues).
+
+For commit-level detail of the 0.5 line, see git log between v0.5.0 and v0.6.0.
+
+---
+
+## Earlier versions
+
+The `0.4.x` and prior series were rapid pre-MVP iterations. See the git
+history for details.
+
+[Unreleased]: https://github.com/compilr-dev/cli/compare/v0.6.2...HEAD
+[0.6.2]: https://github.com/compilr-dev/cli/compare/v0.6.1...v0.6.2
+[0.6.1]: https://github.com/compilr-dev/cli/compare/v0.6.0...v0.6.1
+[0.6.0]: https://github.com/compilr-dev/cli/compare/v0.5.17...v0.6.0

package/README.md

@@ -217,6 +217,18 @@ export GOOGLE_API_KEY="..."             # Google Gemini
 
 Environment variables take priority over stored keys.
 
+### Behavior Environment Variables
+
+The CLI honors several standard environment variables for accessibility,
+privacy, and CI use:
+
+| Variable | Effect |
+|---|---|
+| `NO_COLOR=1` | Disable all ANSI colors. Honors the [no-color.org](https://no-color.org) standard. |
+| `COMPILR_NO_UPDATE_CHECK=1` | Skip the npm registry update check at startup. |
+| `NO_UPDATE_NOTIFIER=1` | Same as above. De-facto standard from `update-notifier`. |
+| `CI=true` | Auto-skips the update check (no nag in CI environments). |
+
 ### Project Configuration
 
 Create a `COMPILR.md` file in your project root to provide context:

package/dist/commands-v2/handlers/core.js

@@ -171,8 +171,8 @@ export const menuCommand = {
             console.log(s.muted('    Run: npm update -g @compilr-dev/cli'));
             console.log('');
         }
-        // Dashboard loop - returns to dashboard after sub-commands until user exits or continues
-        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+        // Dashboard loop — returns to dashboard after sub-commands until user exits or continues
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- intentional infinite loop; exit happens via internal break/return
         while (true) {
             const dashboard = new DashboardOverlayV2();
             const result = await ctx.ui.showOverlay(dashboard);

package/dist/commands-v2/handlers/index.d.ts

@@ -22,4 +22,5 @@ export * from './terminals.js';
 export * from './notifications.js';
 export * from './mcp.js';
 export * from './delegations.js';
+export * from './perf.js';
 export declare const allCommands: CommandHandlerV2[];

package/dist/commands-v2/handlers/index.js

@@ -11,7 +11,7 @@ import { debugCommands } from './debug.js';
 import { sessionCommands } from './session.js';
 import { resetCommands } from './reset.js';
 import { teamCommands } from './team.js';
-import { gamesCommand } from './games.js';
+// import { gamesCommand } from './games.js'; // Temporarily disabled — Tetris copyright concerns
 import { tasksCommand } from './tasks.js';
 import { backgroundCommands } from './background.js';
 import { filterCommands } from './filter.js';
@@ -21,6 +21,7 @@ import { terminalsCommands } from './terminals.js';
 import { notificationsCommands } from './notifications.js';
 import { mcpCommands } from './mcp.js';
 import { delegationsCommands } from './delegations.js';
+import { perfCommands } from './perf.js';
 // Re-export individual modules
 export * from './core.js';
 export * from './settings.js';
@@ -40,6 +41,7 @@ export * from './terminals.js';
 export * from './notifications.js';
 export * from './mcp.js';
 export * from './delegations.js';
+export * from './perf.js';
 // All commands combined
 export const allCommands = [
     ...coreCommands,
@@ -50,7 +52,7 @@ export const allCommands = [
     ...sessionCommands,
     ...resetCommands,
     ...teamCommands,
-    gamesCommand,
+    // gamesCommand, // Temporarily disabled — Tetris copyright concerns
     tasksCommand,
     ...backgroundCommands,
     ...filterCommands,
@@ -60,4 +62,5 @@ export const allCommands = [
     ...notificationsCommands,
     ...mcpCommands,
     ...delegationsCommands,
+    ...perfCommands,
 ];

package/dist/commands-v2/handlers/perf.d.ts

@@ -0,0 +1,9 @@
+/**
+ * /perf Command
+ *
+ * Display the most recent CLI startup-performance profile.
+ * The profile is captured automatically and written to
+ * ~/.compilr-dev/startup-perf.log on every launch.
+ */
+import type { CommandHandlerV2 } from '../types.js';
+export declare const perfCommands: CommandHandlerV2[];

package/dist/commands-v2/handlers/perf.js

@@ -0,0 +1,66 @@
+/**
+ * /perf Command
+ *
+ * Display the most recent CLI startup-performance profile.
+ * The profile is captured automatically and written to
+ * ~/.compilr-dev/startup-perf.log on every launch.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import pc from 'picocolors';
+import { getDataPath } from '../../settings/paths.js';
+const perfCommand = {
+    name: 'perf',
+    description: 'Show the latest startup-performance profile',
+    details: 'Display the timing breakdown captured during this CLI launch. ' +
+        'Useful for diagnosing slow startups (cold cache, heavy MCP servers, ' +
+        'large project DBs). The profile is overwritten on every launch.',
+    examples: [{ code: '/perf', description: 'Show the most recent startup profile' }],
+    execute(_args, ctx) {
+        const logPath = path.join(getDataPath(), 'startup-perf.log');
+        if (!fs.existsSync(logPath)) {
+            ctx.ui.print({
+                type: 'info',
+                message: 'No startup profile found. (Profile is written on the next launch.)',
+            });
+            return Promise.resolve(true);
+        }
+        let content;
+        try {
+            content = fs.readFileSync(logPath, 'utf-8');
+        }
+        catch (err) {
+            ctx.ui.print({
+                type: 'warning',
+                message: `Could not read startup profile: ${String(err)}`,
+            });
+            return Promise.resolve(true);
+        }
+        if (!content.trim()) {
+            ctx.ui.print({ type: 'info', message: 'Startup profile is empty.' });
+            return Promise.resolve(true);
+        }
+        // Print the profile, dimming the path footer.
+        const lines = content.split('\n');
+        const out = [];
+        for (const line of lines) {
+            if (line.startsWith('===')) {
+                out.push(pc.bold(line));
+            }
+            else if (line.startsWith('Slow steps')) {
+                out.push(pc.yellow(line));
+            }
+            else if (line.startsWith('Total:')) {
+                out.push(pc.cyan(line));
+            }
+            else {
+                out.push(line);
+            }
+        }
+        out.push('');
+        out.push(pc.dim(`  Profile: ${logPath}`));
+        ctx.ui.print({ type: 'raw-lines', lines: out });
+        return Promise.resolve(true);
+    },
+};
+export const perfCommands = [perfCommand];

package/dist/commands-v2/handlers/project.js

@@ -178,9 +178,8 @@ export const initCommand = {
         'Type to enter values in input steps',
     ],
     async execute(_args, ctx) {
-        // Show onboarding wizard (same as first-run experience)
-        // Loop if user chooses to configure keys
-        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+        // Show onboarding wizard (same as first-run experience).
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- intentional infinite loop; exit happens via internal break/return
         while (true) {
             const wizard = new OnboardingWizardOverlayV2();
             const result = await ctx.ui.showOverlay(wizard);

package/dist/index.js

@@ -1,7 +1,10 @@
 #!/usr/bin/env node
 // Force color output for all chalk-based libraries (cli-highlight, marked-terminal, etc.)
-// This must be set BEFORE any imports that use chalk
-process.env.FORCE_COLOR = '3';
+// This must be set BEFORE any imports that use chalk.
+// Respect the NO_COLOR standard (https://no-color.org) — never override an explicit user opt-out.
+if (!process.env.NO_COLOR) {
+    process.env.FORCE_COLOR = '3';
+}
 /**
  * @compilr-dev/cli
  *
@@ -85,7 +88,7 @@ function showHelp() {
     console.log(`
 @compilr-dev/cli v${VERSION}
 
-Usage: npm run dev [options]
+Usage: compilr [options]
 
 Options:
   --provider, -p <provider>   LLM provider (claude, openai, gemini, ollama)
@@ -100,13 +103,16 @@ Environment Variables:
   ANTHROPIC_API_KEY           Required for Claude provider
   OPENAI_API_KEY              Required for OpenAI provider
   GOOGLE_AI_API_KEY           Required for Gemini provider
+  NO_COLOR                    Disable ANSI colors
+  COMPILR_NO_UPDATE_CHECK     Skip the npm registry update check at startup
+  CI                          Auto-skips the update check
 
 Examples:
-  npm run dev
-  npm run dev -- --model claude-sonnet-4-6
-  npm run dev -- --provider gemini --model gemini-2.0-flash
-  npm run dev -- --minimal --show-filtering
-  npm run dev -- --update
+  compilr
+  compilr --model claude-sonnet-4-6
+  compilr --provider gemini --model gemini-2.0-flash
+  compilr --minimal --show-filtering
+  compilr --update
 `);
 }
 // =============================================================================

package/dist/repl-v2.js

@@ -3358,8 +3358,12 @@ export class ReplV2 {
 // Only run main() when executed directly (not when imported)
 if (import.meta.url === `file://${process.argv[1]}`) {
     const repl = new ReplV2();
-    // Handle SIGINT
+    // Handle SIGINT — restore raw mode before exit so the parent shell
+    // doesn't inherit a broken terminal state.
     process.on('SIGINT', () => {
+        if (process.stdin.isTTY) {
+            process.stdin.setRawMode(false);
+        }
         console.log('\n\nInterrupted\n');
         process.exit(0);
     });

package/dist/session/project-session-manager.js

@@ -387,7 +387,7 @@ export class ProjectSessionManager {
             else if (Array.isArray(lastUserMsg.content)) {
                 const textBlock = lastUserMsg.content.find((b) => b.type === 'text');
                 if (textBlock?.type === 'text') {
-                    preview = textBlock.text;
+                    preview = (textBlock).text;
                 }
             }
         }

package/dist/slash-autocomplete.js

@@ -9,6 +9,7 @@
  * - Proper wrapping for long input
  */
 import pc from 'picocolors';
+import { ttyWrite } from './ui/terminal.js';
 // ANSI escape codes for terminal control
 const ANSI = {
     HIDE_CURSOR: '\x1B[?25l',
@@ -83,7 +84,7 @@ function renderDropdown(state, promptLen, currentLine, totalLines, hasSeparators
     if (hasSeparators)
         linesToMoveDown += 1;
     if (linesToMoveDown > 0) {
-        process.stdout.write(ANSI.MOVE_DOWN(linesToMoveDown));
+        ttyWrite(ANSI.MOVE_DOWN(linesToMoveDown));
     }
     process.stdout.write('\n');
     const visible = state.matches.slice(0, MAX_VISIBLE);
@@ -98,8 +99,8 @@ function renderDropdown(state, promptLen, currentLine, totalLines, hasSeparators
     // Move back up to cursor position
     const linesRendered = visible.length;
     const linesToMoveUp = linesRendered + linesToMoveDown + 1;
-    process.stdout.write(ANSI.MOVE_UP(linesToMoveUp));
-    process.stdout.write(ANSI.MOVE_TO_COLUMN(promptLen + state.cursorPos + 1));
+    ttyWrite(ANSI.MOVE_UP(linesToMoveUp));
+    ttyWrite(ANSI.MOVE_TO_COLUMN(promptLen + state.cursorPos + 1));
     return linesRendered;
 }
 /**
@@ -113,16 +114,17 @@ function clearDropdown(dropdownLines, currentLine, totalLines, hasSeparators) {
     if (hasSeparators)
         linesToMoveDown += 1;
     if (linesToMoveDown > 0) {
-        process.stdout.write(ANSI.MOVE_DOWN(linesToMoveDown));
+        ttyWrite(ANSI.MOVE_DOWN(linesToMoveDown));
     }
     process.stdout.write('\n');
     // Clear dropdown lines
     for (let i = 0; i < dropdownLines; i++) {
-        process.stdout.write(ANSI.CLEAR_LINE + '\n');
+        ttyWrite(ANSI.CLEAR_LINE);
+        process.stdout.write('\n');
     }
     // Move back up
     const linesToMoveUp = dropdownLines + linesToMoveDown + 1;
-    process.stdout.write(ANSI.MOVE_UP(linesToMoveUp));
+    ttyWrite(ANSI.MOVE_UP(linesToMoveUp));
 }
 /**
  * Create interactive input with autocomplete
@@ -198,13 +200,13 @@ export function createInteractiveInput(prompt, onSubmit, showSeparator = true, g
         const termWidth = getTerminalWidth();
         // Clear previous render
         if (linesAboveCursor > 0) {
-            process.stdout.write('\r');
-            process.stdout.write(ANSI.MOVE_UP(linesAboveCursor));
+            ttyWrite('\r');
+            ttyWrite(ANSI.MOVE_UP(linesAboveCursor));
         }
         else {
-            process.stdout.write('\r');
+            ttyWrite('\r');
         }
-        process.stdout.write(ANSI.CLEAR_TO_END_OF_SCREEN);
+        ttyWrite(ANSI.CLEAR_TO_END_OF_SCREEN);
         // Render todos
         renderedTodoLines = renderTodoSection();
         // Render top separator
@@ -246,10 +248,10 @@ export function createInteractiveInput(prompt, onSubmit, showSeparator = true, g
         }
         linesToMoveUp += (currentLinePhysical - 1 - cursorPhysicalRow);
         if (linesToMoveUp > 0) {
-            process.stdout.write(ANSI.MOVE_UP(linesToMoveUp));
+            ttyWrite(ANSI.MOVE_UP(linesToMoveUp));
         }
         const cursorCol = (cursorAbsPos % termWidth) + 1;
-        process.stdout.write(ANSI.MOVE_TO_COLUMN(cursorCol));
+        ttyWrite(ANSI.MOVE_TO_COLUMN(cursorCol));
         // Track cursor position for next render
         linesAboveCursor = physicalLinesRendered + physicalLinesBeforeCursor + cursorPhysicalRow;
     }
@@ -339,9 +341,9 @@ export function createInteractiveInput(prompt, onSubmit, showSeparator = true, g
             dropdownLines = 0;
             // Clear display
             if (linesAboveCursor > 0) {
-                process.stdout.write('\r' + ANSI.MOVE_UP(linesAboveCursor));
+                ttyWrite('\r' + ANSI.MOVE_UP(linesAboveCursor));
             }
-            process.stdout.write('\r' + ANSI.CLEAR_TO_END_OF_SCREEN);
+            ttyWrite('\r' + ANSI.CLEAR_TO_END_OF_SCREEN);
             // Print clean input
             for (let i = 0; i < state.lines.length; i++) {
                 const linePrompt = i === 0 ? prompt : pc.dim('   \\ ');
@@ -494,7 +496,7 @@ export function createInteractiveInput(prompt, onSubmit, showSeparator = true, g
         if (isLeftArrow) {
             if (state.cursorPos > 0) {
                 state.cursorPos--;
-                process.stdout.write('\x1B[D');
+                ttyWrite('\x1B[D');
             }
             else if (state.currentLine > 0) {
                 state.currentLine--;
@@ -507,7 +509,7 @@ export function createInteractiveInput(prompt, onSubmit, showSeparator = true, g
         if (isRightArrow) {
             if (state.cursorPos < state.lines[state.currentLine].length) {
                 state.cursorPos++;
-                process.stdout.write('\x1B[C');
+                ttyWrite('\x1B[C');
             }
             else if (state.currentLine < state.lines.length - 1) {
                 state.currentLine++;

package/dist/tabbed-menu.js

@@ -7,6 +7,7 @@
 import pc from 'picocolors';
 import { getCustomCommandRegistry } from './commands/index.js';
 import { truncate } from './ui/base/index.js';
+import { ttyWrite } from './ui/terminal.js';
 // ANSI escape codes
 const ANSI = {
     HIDE_CURSOR: '\x1B[?25l',
@@ -201,11 +202,11 @@ function render(state, prevLineCount) {
     // Clear previous render
     if (prevLineCount > 0) {
         // Move to column 1, move up to first line, clear everything below
-        process.stdout.write('\r');
+        ttyWrite('\r');
         if (prevLineCount > 1) {
-            process.stdout.write(ANSI.MOVE_UP(prevLineCount - 1));
+            ttyWrite(ANSI.MOVE_UP(prevLineCount - 1));
         }
-        process.stdout.write(ANSI.CLEAR_TO_END);
+        ttyWrite(ANSI.CLEAR_TO_END);
     }
     // Render new content
     process.stdout.write(lines.join('\n'));
@@ -283,7 +284,7 @@ export function showHelpMenu() {
         // Start on a new line (menu appears below the prompt)
         process.stdout.write('\n');
         // Hide cursor during menu display
-        process.stdout.write(ANSI.HIDE_CURSOR);
+        ttyWrite(ANSI.HIDE_CURSOR);
         // Store original raw mode state
         const wasRawMode = process.stdin.isRaw;
         // Enable raw mode
@@ -298,13 +299,13 @@ export function showHelpMenu() {
             // lineCount lines with lineCount-1 newlines between them, plus the initial \n we added
             // So cursor is (lineCount-1)+1 = lineCount lines below where "You: /help" ended
             if (lineCount > 0) {
-                process.stdout.write(ANSI.MOVE_UP(lineCount));
-                process.stdout.write(ANSI.CLEAR_TO_END);
+                ttyWrite(ANSI.MOVE_UP(lineCount));
+                ttyWrite(ANSI.CLEAR_TO_END);
             }
             // Print newline so next prompt appears on fresh line
             process.stdout.write('\n');
             // Show cursor
-            process.stdout.write(ANSI.SHOW_CURSOR);
+            ttyWrite(ANSI.SHOW_CURSOR);
             // Restore raw mode to original state
             if (process.stdin.isTTY && !wasRawMode) {
                 process.stdin.setRawMode(false);

package/dist/ui/base/overlay-base.js

@@ -42,6 +42,7 @@ import * as terminal from '../terminal.js';
 import { getStyles } from '../../themes/index.js';
 import { OverlayLifecycle } from './overlay-lifecycle.js';
 import { debugLog } from '../../utils/debug-log.js';
+import { ttyWrite } from '../terminal.js';
 // =============================================================================
 // BaseOverlay Abstract Class
 // =============================================================================
@@ -150,7 +151,7 @@ export class BaseOverlay {
         this.state.maxLineCount = 0;
         // Explicitly move cursor to home and save position
         // This ensures we're at (0,0) regardless of what clearScreen() did
-        process.stdout.write('\x1b[H');
+        ttyWrite('\x1b[H');
         terminal.saveCursor();
     }
     // ===========================================================================

package/dist/ui/overlay/impl/artifact-detail-overlay-v2.js

@@ -14,6 +14,7 @@ import { markedTerminal } from 'marked-terminal';
 import { BaseOverlayV2 } from '../../base/overlay-base-v2.js';
 import { getCurrentTheme } from '../../../themes/index.js';
 import * as terminal from '../../terminal.js';
+import { ttyWrite } from '../../terminal.js';
 import { ARTIFACT_TYPE_LABELS } from '../../constants/labels.js';
 // =============================================================================
 // Alternate Screen Buffer Management
@@ -22,14 +23,14 @@ let inAlternateScreen = false;
 function enterAlternateScreen() {
     if (inAlternateScreen)
         return;
-    process.stdout.write('\x1b[?1049h'); // Switch to alternate screen
-    process.stdout.write('\x1b[H'); // Move cursor to home
+    ttyWrite('\x1b[?1049h'); // Switch to alternate screen
+    ttyWrite('\x1b[H'); // Move cursor to home
     inAlternateScreen = true;
 }
 function exitAlternateScreen() {
     if (!inAlternateScreen)
         return;
-    process.stdout.write('\x1b[?1049l'); // Switch back to main screen
+    ttyWrite('\x1b[?1049l'); // Switch back to main screen
     inAlternateScreen = false;
 }
 // Ensure we exit alternate screen on process termination
@@ -42,10 +43,14 @@ function setupAlternateScreenCleanup() {
         cleanup();
         process.exit(130);
     });
-    process.on('SIGTERM', () => {
-        cleanup();
-        process.exit(143);
-    });
+    // Windows doesn't deliver SIGTERM — Node silently ignores the listener
+    // there, but we add the platform guard for clarity.
+    if (process.platform !== 'win32') {
+        process.on('SIGTERM', () => {
+            cleanup();
+            process.exit(143);
+        });
+    }
 }
 setupAlternateScreenCleanup();
 // =============================================================================

package/dist/ui/overlay/impl/config-overlay-v2.js

@@ -611,9 +611,9 @@ export class ConfigOverlayV2 extends BaseOverlayV2 {
      */
     toggleOrCycleItem() {
         const item = this.state.configItems[this.state.selectedItem];
-        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- selectedItem can briefly point past array end during async re-render
         if (!item)
-            return null; // Defensive check
+            return null;
         if (item.type === 'boolean') {
             const newValue = !item.value;
             item.value = newValue;

package/dist/ui/overlay/impl/document-detail-overlay-v2.js

@@ -13,6 +13,7 @@
  */
 import chalk from 'chalk';
 import hljs from 'highlight.js';
+import { ttyWrite } from '../../terminal.js';
 // =============================================================================
 // Alternate Screen Buffer Management
 // =============================================================================
@@ -20,14 +21,14 @@ let inAlternateScreen = false;
 function enterAlternateScreen() {
     if (inAlternateScreen)
         return;
-    process.stdout.write('\x1b[?1049h'); // Switch to alternate screen
-    process.stdout.write('\x1b[H'); // Move cursor to home
+    ttyWrite('\x1b[?1049h'); // Switch to alternate screen
+    ttyWrite('\x1b[H'); // Move cursor to home
     inAlternateScreen = true;
 }
 function exitAlternateScreen() {
     if (!inAlternateScreen)
         return;
-    process.stdout.write('\x1b[?1049l'); // Switch back to main screen
+    ttyWrite('\x1b[?1049l'); // Switch back to main screen
     inAlternateScreen = false;
 }
 // Ensure we exit alternate screen on process termination
@@ -42,11 +43,14 @@ function setupAlternateScreenCleanup() {
         cleanup();
         process.exit(130);
     });
-    // Handle termination
-    process.on('SIGTERM', () => {
-        cleanup();
-        process.exit(143);
-    });
+    // Handle termination (Windows doesn't deliver SIGTERM — Node silently
+    // ignores the listener there, but we add the platform guard for clarity)
+    if (process.platform !== 'win32') {
+        process.on('SIGTERM', () => {
+            cleanup();
+            process.exit(143);
+        });
+    }
     // Handle uncaught exceptions
     process.on('uncaughtException', (err) => {
         cleanup();

package/dist/ui/overlay/impl/pending-overlay-v2.js

@@ -203,7 +203,10 @@ export class PendingOverlayV2 extends BaseOverlayV2 {
         const agentLabel = `$${req.agentId}`;
         const ctx = req.context;
         const filePath = ctx?.input
-            ? (ctx.input.filePath ?? ctx.input.file_path ?? ctx.input.path ?? '')
+            ? (() => {
+                const input = ctx.input;
+                return (input.filePath ?? input.file_path ?? input.path ?? '');
+            })()
             : '';
         const fileName = filePath.split('/').pop() || filePath;
         // Header