@compilr-dev/cli 0.6.1 → 0.6.2

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/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';
@@ -50,7 +50,7 @@ export const allCommands = [
     ...sessionCommands,
     ...resetCommands,
     ...teamCommands,
-    gamesCommand,
+    // gamesCommand, // Temporarily disabled — Tetris copyright concerns
     tasksCommand,
     ...backgroundCommands,
     ...filterCommands,

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
  *

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.2",
   "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",