@compilr-dev/cli 0.6.1 → 0.6.3

package/dist/ui/overlay-manager.js

@@ -6,6 +6,7 @@
  * clear/render and console output.
  */
 import * as terminal from './terminal.js';
+import { ttyWrite } from './terminal.js';
 import { getVisibleLength } from './line-utils.js';
 import { getStyles } from '../themes/index.js';
 export class OverlayManager {
@@ -89,7 +90,7 @@ export class OverlayManager {
     // ===========================================================================
     enterFullscreenOverlayMode() {
         this.host.clearFooter();
-        process.stdout.write('\x1b[2J\x1b[H');
+        ttyWrite('\x1b[2J\x1b[H');
         this.renderState = { lineCount: 0, maxLineCount: 0 };
     }
     enterInlineOverlayMode() {
@@ -127,9 +128,9 @@ export class OverlayManager {
     clearOverlayRender() {
         const linesToClear = this.renderState.maxLineCount;
         if (linesToClear > 0) {
-            process.stdout.write(`\x1b[${String(linesToClear)}A`);
-            process.stdout.write('\r');
-            process.stdout.write('\x1b[J');
+            ttyWrite(`\x1b[${String(linesToClear)}A`);
+            ttyWrite('\r');
+            ttyWrite('\x1b[J');
         }
     }
     renderOverlay() {
@@ -179,9 +180,9 @@ export class OverlayManager {
             const { line, column } = content.cursorPosition;
             const linesFromEnd = paddedLines.length - 1 - line;
             if (linesFromEnd > 0) {
-                process.stdout.write(`\x1b[${String(linesFromEnd)}A`);
+                ttyWrite(`\x1b[${String(linesFromEnd)}A`);
             }
-            process.stdout.write(`\x1b[${String(column)}G`);
+            ttyWrite(`\x1b[${String(column)}G`);
         }
         terminal.showCursor();
     }

package/dist/ui/terminal-render-item.js

@@ -229,7 +229,8 @@ export function renderItem(item, config) {
                 // If we add items that don't add trailing blanks, or if the rendering
                 // order changes, this could cause visual artifacts (overwriting content).
                 // If issues arise, consider tracking the last printed item type instead.
-                process.stdout.write('\x1b[1A'); // Move up one line
+                if (process.stdout.isTTY)
+                    process.stdout.write('\x1b[1A'); // Move up one line
             }
             // Show interrupted line with mascot
             const suggestion = item.suggestion ?? 'What should I do instead?';

package/dist/ui/terminal-renderer.js

@@ -407,8 +407,7 @@ export class TerminalRenderer extends EventEmitter {
         finally {
             this.isRendering = false;
             // Check if another render was requested during this one
-            // (renderPending can be set by callbacks during render)
-            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- renderPending can be flipped by callbacks during render
             if (this.renderPending) {
                 this.requestRender();
             }

package/dist/ui/terminal-ui.js

@@ -542,8 +542,9 @@ export class TerminalUI extends EventEmitter {
      */
     reRenderConversationWithVerbosity(verbosity) {
         const s = getStyles();
-        // Clear screen and scrollback buffer
-        process.stdout.write('\x1b[2J\x1b[3J\x1b[H');
+        // Clear screen and scrollback buffer (TTY-only — keep piped output clean)
+        if (process.stdout.isTTY)
+            process.stdout.write('\x1b[2J\x1b[3J\x1b[H');
         // Reset footer state
         this.footer.resetRenderState();
         // Show mode indicator at top for temp modes
@@ -641,8 +642,9 @@ export class TerminalUI extends EventEmitter {
      * Called when verbose mode changes.
      */
     reRenderConversation() {
-        // Clear screen AND scrollback buffer, then move to home
-        process.stdout.write('\x1b[2J\x1b[3J\x1b[H');
+        // Clear screen AND scrollback buffer, then move to home (TTY-only — keep piped output clean)
+        if (process.stdout.isTTY)
+            process.stdout.write('\x1b[2J\x1b[3J\x1b[H');
         // Reset footer state since we cleared everything
         this.footer.resetRenderState();
         // Show filter indicator if active

package/dist/ui/terminal.d.ts

@@ -3,7 +3,16 @@
  *
  * Low-level terminal operations using ANSI escape codes.
  * Pure functions with no state.
+ *
+ * All output is gated through `ttyWrite()` so that pipes and redirected
+ * streams don't get raw escape sequences. `compilr | tee output.log`
+ * should produce a clean log, not a binary mess.
+ */
+/**
+ * Write a control sequence only when stdout is an interactive TTY.
+ * No-op when output is piped or redirected — keeps log files clean.
  */
+export declare function ttyWrite(seq: string): void;
 /**
  * Set terminal window title
  */

package/dist/ui/terminal.js

@@ -3,7 +3,20 @@
  *
  * Low-level terminal operations using ANSI escape codes.
  * Pure functions with no state.
+ *
+ * All output is gated through `ttyWrite()` so that pipes and redirected
+ * streams don't get raw escape sequences. `compilr | tee output.log`
+ * should produce a clean log, not a binary mess.
+ */
+/**
+ * Write a control sequence only when stdout is an interactive TTY.
+ * No-op when output is piped or redirected — keeps log files clean.
  */
+export function ttyWrite(seq) {
+    if (process.stdout.isTTY) {
+        process.stdout.write(seq);
+    }
+}
 // =============================================================================
 // Terminal Title
 // =============================================================================
@@ -11,7 +24,7 @@
  * Set terminal window title
  */
 export function setTitle(title) {
-    process.stdout.write(`\x1b]0;${title}\x07`);
+    ttyWrite(`\x1b]0;${title}\x07`);
 }
 // =============================================================================
 // Terminal Dimensions
@@ -36,7 +49,7 @@ export function getTerminalHeight() {
  */
 export function moveCursorUp(n) {
     if (n > 0) {
-        process.stdout.write(`\x1b[${String(n)}A`);
+        ttyWrite(`\x1b[${String(n)}A`);
     }
 }
 /**
@@ -44,32 +57,32 @@ export function moveCursorUp(n) {
  */
 export function moveCursorDown(n) {
     if (n > 0) {
-        process.stdout.write(`\x1b[${String(n)}B`);
+        ttyWrite(`\x1b[${String(n)}B`);
     }
 }
 /**
  * Move cursor to column (1-indexed)
  */
 export function moveCursorToColumn(col) {
-    process.stdout.write(`\x1b[${String(col)}G`);
+    ttyWrite(`\x1b[${String(col)}G`);
 }
 /**
  * Move cursor to beginning of line
  */
 export function moveCursorToLineStart() {
-    process.stdout.write('\r');
+    ttyWrite('\r');
 }
 /**
  * Save cursor position
  */
 export function saveCursor() {
-    process.stdout.write('\x1b[s');
+    ttyWrite('\x1b[s');
 }
 /**
  * Restore cursor position
  */
 export function restoreCursor() {
-    process.stdout.write('\x1b[u');
+    ttyWrite('\x1b[u');
 }
 // =============================================================================
 // Cursor Visibility
@@ -78,13 +91,13 @@ export function restoreCursor() {
  * Hide cursor
  */
 export function hideCursor() {
-    process.stdout.write('\x1b[?25l');
+    ttyWrite('\x1b[?25l');
 }
 /**
  * Show cursor
  */
 export function showCursor() {
-    process.stdout.write('\x1b[?25h');
+    ttyWrite('\x1b[?25h');
 }
 // =============================================================================
 // Clearing
@@ -93,13 +106,13 @@ export function showCursor() {
  * Clear current line
  */
 export function clearLine() {
-    process.stdout.write('\r\x1b[K');
+    ttyWrite('\r\x1b[K');
 }
 /**
  * Clear from cursor to end of screen
  */
 export function clearToEndOfScreen() {
-    process.stdout.write('\x1b[J');
+    ttyWrite('\x1b[J');
 }
 /**
  * Clear N lines above cursor (including current line)
@@ -118,7 +131,7 @@ export function clearLinesAbove(count) {
  * Clear entire screen
  */
 export function clearScreen() {
-    process.stdout.write('\x1b[2J\x1b[H');
+    ttyWrite('\x1b[2J\x1b[H');
 }
 /**
  * Enter alternate screen buffer.
@@ -131,14 +144,14 @@ export function enterAlternateScreen() {
     // \x1b[?1000l - disable mouse click tracking
     // \x1b[?1002l - disable mouse drag tracking
     // \x1b[?1003l - disable all mouse tracking
-    process.stdout.write('\x1b[?1049h\x1b[?1000l\x1b[?1002l\x1b[?1003l');
+    ttyWrite('\x1b[?1049h\x1b[?1000l\x1b[?1002l\x1b[?1003l');
 }
 /**
  * Leave alternate screen buffer.
  * Returns to main screen (previous content restored).
  */
 export function leaveAlternateScreen() {
-    process.stdout.write('\x1b[?1049l');
+    ttyWrite('\x1b[?1049l');
 }
 // =============================================================================
 // Line Calculations
@@ -305,5 +318,5 @@ export function writeLine(text = '') {
  * Ring terminal bell
  */
 export function bell() {
-    process.stdout.write('\x07');
+    ttyWrite('\x07');
 }

package/dist/utils/update-checker.d.ts

@@ -11,7 +11,12 @@ export interface UpdateInfo {
     npmUrl: string;
 }
 /**
- * Check npm registry for the latest version
+ * Check npm registry for the latest version.
+ *
+ * Honored opt-outs (any of these returns "no update available" without a network call):
+ *   - COMPILR_NO_UPDATE_CHECK=1     (project-specific)
+ *   - NO_UPDATE_NOTIFIER=1          (de-facto standard from update-notifier)
+ *   - CI=true                       (don't nag in CI environments)
  */
 export declare function checkForUpdates(): Promise<UpdateInfo>;
 /**

package/dist/utils/update-checker.js

@@ -5,10 +5,25 @@
  */
 import { VERSION } from './version.js';
 /**
- * Check npm registry for the latest version
+ * Check npm registry for the latest version.
+ *
+ * Honored opt-outs (any of these returns "no update available" without a network call):
+ *   - COMPILR_NO_UPDATE_CHECK=1     (project-specific)
+ *   - NO_UPDATE_NOTIFIER=1          (de-facto standard from update-notifier)
+ *   - CI=true                       (don't nag in CI environments)
  */
 export async function checkForUpdates() {
     const packageName = '@compilr-dev/cli';
+    // Respect well-known opt-outs and CI environments — never make a network call
+    if (process.env.COMPILR_NO_UPDATE_CHECK || process.env.NO_UPDATE_NOTIFIER || process.env.CI) {
+        return {
+            currentVersion: VERSION,
+            latestVersion: VERSION,
+            updateAvailable: false,
+            releaseUrl: '',
+            npmUrl: `https://www.npmjs.com/package/${packageName}`,
+        };
+    }
     const registryUrl = `https://registry.npmjs.org/${packageName}/latest`;
     try {
         const response = await fetch(registryUrl, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/cli",
-  "version": "0.6.1",
+  "version": "0.6.3",
   "description": "AI-powered coding assistant CLI using @compilr-dev/agents",
   "type": "module",
   "main": "dist/index.js",
@@ -47,10 +47,11 @@
   "files": [
     "dist",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "CHANGELOG.md"
   ],
   "engines": {
-    "node": ">=22.0.0"
+    "node": ">=20.0.0"
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.74.0",
@@ -68,7 +69,7 @@
     "marked": "^15.0.12",
     "marked-terminal": "^7.3.0",
     "picocolors": "^1.1.1",
-    "uuid": "^13.0.0"
+    "uuid": "^14.0.0"
   },
   "overrides": {
     "minimatch": ">=10.2.1",