@compilr-dev/cli 0.5.16 → 0.5.17

package/dist/agent.js

@@ -5,6 +5,7 @@
  * ClaudeProvider, OllamaProvider, OpenAIProvider, or GeminiProvider
  * and available tools.
  */
+import { log } from './foundation/logger.js';
 import { Agent, ContextManager, DEFAULT_CONTEXT_CONFIG, createTaskTool, createSuggestTool, defaultAgentTypes, TOOL_SETS, BUILTIN_GUARDRAILS, createProviderFromType, CapabilityManager, CapabilityContext, CAPABILITY_PACKS, GIT_SAFETY_MODULE, PLATFORM_TOOL_HINTS_MODULE, FACTORY_TOOL_HINTS_MODULE, TOOL_USAGE_META_MODULE, createLoadCapabilityTool, createCapabilityHook, resolveProfileGroups, resolveUpfrontGroups, } from '@compilr-dev/sdk';
 import { isAutoCompactEnabled, isDelegationEnabled, getSetting } from './settings/index.js';
 import { getApiKey } from './utils/credentials.js';
@@ -165,10 +166,10 @@ export function createAgent(options = {}) {
     const onEvent = options.verbose
         ? (event) => {
             if (event.type === 'tool_start') {
-                console.log(`\n[Tool: ${event.name}] Starting...`);
+                log.debug({ component: 'agent', tool: event.name }, 'Tool starting');
             }
             else if (event.type === 'tool_end') {
-                console.log(`[Tool: ${event.name}] Done`);
+                log.debug({ component: 'agent', tool: event.name }, 'Tool done');
             }
         }
         : undefined;
@@ -475,7 +476,7 @@ ${options.systemPromptAddition}
             // Now uses toolUseId for direct correlation (no more FIFO matching!)
             onSpawn: (agentType, description, toolUseId) => {
                 if (options.verbose) {
-                    console.log(`\n[Sub-agent] Spawning ${agentType}: ${description} (${toolUseId ?? 'no-id'})`);
+                    log.debug({ component: 'agent', agentType, toolUseId }, 'Spawning sub-agent: %s', description);
                 }
                 // Immediately notify with toolUseId - no more queuing/matching!
                 if (toolUseId) {
@@ -487,7 +488,7 @@ ${options.systemPromptAddition}
             },
             onComplete: (agentType, result, toolUseId) => {
                 if (options.verbose) {
-                    console.log(`[Sub-agent] ${agentType} completed (${String(result.iterations)} iterations)`);
+                    log.debug({ component: 'agent', agentType, iterations: result.iterations }, 'Sub-agent completed');
                 }
                 // Direct notification with toolUseId - no more searching!
                 if (toolUseId && options.onSubagentEnd) {

package/dist/agents/registry.js

@@ -4,6 +4,7 @@
  * Handles loading, saving, and managing agent definitions.
  * Loads from both project (.compilr-dev/agents/) and user (~/.compilr-dev/agents/) directories.
  */
+import { log } from '../foundation/logger.js';
 import * as fs from 'fs';
 import * as path from 'path';
 import { BUILTIN_AGENTS, PROJECT_AGENTS_DIR, USER_AGENTS_DIR, isValidAgentName, isBuiltinAgentName, } from './types.js';
@@ -61,16 +62,16 @@ function loadAgentsFromDir(dir, location) {
             const content = fs.readFileSync(filePath, 'utf-8');
             const parsed = parseAgentFile(content);
             if (!parsed) {
-                console.warn(`Invalid agent file (no frontmatter): ${filePath}`);
+                log.warn({ component: 'agents', filePath }, 'Invalid agent file (no frontmatter)');
                 continue;
             }
             const { frontmatter, content: systemPrompt } = parsed;
             if (!frontmatter.name || !frontmatter.description) {
-                console.warn(`Invalid agent file (missing fields): ${filePath}`);
+                log.warn({ component: 'agents', filePath }, 'Invalid agent file (missing name or description)');
                 continue;
             }
             if (!isValidAgentName(frontmatter.name)) {
-                console.warn(`Invalid agent name: ${frontmatter.name} in ${filePath}`);
+                log.warn({ component: 'agents', name: frontmatter.name, filePath }, 'Invalid agent name');
                 continue;
             }
             const model = (['sonnet', 'opus', 'haiku', 'inherit'].includes(frontmatter.model || '')
@@ -86,7 +87,7 @@ function loadAgentsFromDir(dir, location) {
             });
         }
         catch (error) {
-            console.warn(`Failed to load agent file: ${filePath}`, error);
+            log.warn({ component: 'agents', filePath, err: error }, 'Failed to load agent file');
         }
     }
     return agents;

package/dist/auth/index.js

@@ -10,6 +10,7 @@
  *     // Show login prompt
  *   }
  */
+import { log } from '../foundation/logger.js';
 import { v4 as uuidv4 } from 'uuid';
 import * as os from 'os';
 import { loadAuthData, saveAuthData, clearAuthData, updateSession, hasAuthData, checkAuthFilePermissions, } from './storage.js';
@@ -314,9 +315,8 @@ class AuthManager {
         }
         const result = await apiRefreshToken(this.authData.session.refreshToken);
         if (!result.success || !result.access_token || !result.refresh_token) {
-            // Debug: log refresh failure details
-            console.error('[auth] Token refresh failed:', result.error ?? 'missing token fields');
-            console.error('[auth] API_BASE_URL:', process.env.COMPILR_API_URL ?? '(not set, using compilr.dev)');
+            log.error({ component: 'auth', error: result.error ?? 'missing token fields' }, 'Token refresh failed');
+            log.error({ component: 'auth', apiBaseUrl: process.env.COMPILR_API_URL ?? '(not set, using compilr.dev)' }, 'API base URL at time of failure');
             return false;
         }
         // Calculate expiry from expires_in (seconds), default to 1 hour

package/dist/commands/custom-registry.js

@@ -4,6 +4,7 @@
  * Handles loading, saving, and managing custom command definitions.
  * Loads from both project (.compilr-dev/commands/) and user (~/.compilr-dev/commands/) directories.
  */
+import { log } from '../foundation/logger.js';
 import * as fs from 'fs';
 import * as path from 'path';
 import { PROJECT_COMMANDS_DIR, USER_COMMANDS_DIR, isValidCommandName, } from './types.js';
@@ -88,11 +89,11 @@ function loadCommandsFromDir(dir, location) {
             // Name from filename (without .md extension)
             const name = path.basename(file, '.md');
             if (!isValidCommandName(name)) {
-                console.warn(`Invalid command name: ${name} in ${filePath}`);
+                log.warn({ component: 'commands', name, filePath }, 'Invalid command name');
                 continue;
             }
             if (!parsed.content) {
-                console.warn(`Empty command file: ${filePath}`);
+                log.warn({ component: 'commands', filePath }, 'Empty command file');
                 continue;
             }
             commands.push({
@@ -104,7 +105,7 @@ function loadCommandsFromDir(dir, location) {
             });
         }
         catch (error) {
-            console.warn(`Failed to load command file: ${filePath}`, error);
+            log.warn({ component: 'commands', filePath, err: error }, 'Failed to load command file');
         }
     }
     return commands;

package/dist/foundation/logger.d.ts

@@ -0,0 +1,9 @@
+/**
+ * CLI logger instance.
+ *
+ * Diagnostic logging only — NOT for user-facing terminal output.
+ * User-facing output uses TerminalUI/TerminalRenderer.
+ *
+ * Logs are written to ~/.compilr-dev/logs/cli.log (rotated, 10MB x 5).
+ */
+export declare const log: import("@compilr-dev/logger").Logger;

package/dist/foundation/logger.js

@@ -0,0 +1,16 @@
+/**
+ * CLI logger instance.
+ *
+ * Diagnostic logging only — NOT for user-facing terminal output.
+ * User-facing output uses TerminalUI/TerminalRenderer.
+ *
+ * Logs are written to ~/.compilr-dev/logs/cli.log (rotated, 10MB x 5).
+ */
+import { join } from 'path';
+import { homedir } from 'os';
+import { createLogger } from '@compilr-dev/logger';
+const logDir = join(homedir(), '.compilr-dev', 'logs');
+export const log = createLogger({
+    package: 'cli',
+    filePath: join(logDir, 'cli.log'),
+});

package/dist/repl-v2.js

@@ -10,6 +10,7 @@
  * Or imported and used with a real agent from index.ts
  */
 import { appendFileSync } from 'fs';
+import { log } from './foundation/logger.js';
 import { generateEditDiff, generateWriteDiff } from './ui/diff.js';
 import { getPendingRequestsManager, setActiveSharedContext } from './multi-agent/index.js';
 import { parseInputForMentions, hasReferences, buildMessageWithContext, ContextResolver, buildContextMap, } from './multi-agent/index.js';
@@ -153,11 +154,11 @@ ${JSON.stringify(state.messages, null, 2)}
 
 `;
         appendFileSync(DEBUG_LOG_FILE, logEntry);
-        console.log(`[DEBUG] Request #${String(debugRequestCount)} logged to ${DEBUG_LOG_FILE}`);
-        console.log(`[DEBUG] Estimated: sys:${String(systemPromptTokens)}tok + msg:${String(messagesTokens)}tok + tools:${String(totalToolTokens)}tok = ${String(totalEstimate)}tok`);
+        log.debug({ component: 'repl', requestNum: debugRequestCount, file: DEBUG_LOG_FILE }, 'Debug request logged');
+        log.debug({ component: 'repl', systemPromptTokens, messagesTokens, totalToolTokens, totalEstimate }, 'Token estimate');
     }
     catch (error) {
-        console.error('[DEBUG] Failed to log agent request:', error);
+        log.error({ component: 'repl', err: error }, 'Failed to log agent request');
     }
 }
 // =============================================================================

package/dist/settings/index.js

@@ -4,6 +4,7 @@
  * Centralized settings management for the CLI.
  * Persistence in ~/.compilr-dev/settings.json
  */
+import { log } from '../foundation/logger.js';
 import * as fs from 'fs';
 import * as path from 'path';
 import * as os from 'os';
@@ -89,7 +90,7 @@ function saveToDisk(settings) {
         fs.writeFileSync(CONFIG_FILE, JSON.stringify(settings, null, 2), 'utf-8');
     }
     catch (error) {
-        console.error('Failed to save settings:', error);
+        log.error({ component: 'settings', err: error }, 'Failed to save settings');
     }
 }
 // =============================================================================

package/dist/settings/paths.js

@@ -9,6 +9,7 @@
  * 2. Config file (~/.compilr-dev/settings.json)
  * 3. Default/derived value
  */
+import { log } from '../foundation/logger.js';
 import * as fs from 'fs';
 import * as path from 'path';
 import * as os from 'os';
@@ -60,7 +61,7 @@ function savePathConfig(pathConfig) {
         fs.writeFileSync(CONFIG_FILE, JSON.stringify(merged, null, 2), 'utf-8');
     }
     catch (error) {
-        console.error('Failed to save path config:', error);
+        log.error({ component: 'settings', err: error }, 'Failed to save path config');
     }
 }
 /**

package/dist/ui/terminal-renderer.js

@@ -11,6 +11,7 @@
  * Single point of terminal output. All rendering goes through this class.
  * Eliminates race conditions by ensuring only one writer.
  */
+import { log } from '../foundation/logger.js';
 import { EventEmitter } from 'events';
 import { RenderMode, isValidTransition } from './render-modes.js';
 // Re-export RenderMode for convenience
@@ -721,8 +722,7 @@ export class TerminalRenderer extends EventEmitter {
      */
     log(message) {
         if (this.debug) {
-            const timestamp = new Date().toISOString().slice(11, 23);
-            console.error(`[TerminalRenderer ${timestamp}] ${message}`);
+            log.debug({ component: 'terminal-renderer' }, message);
         }
     }
 }

package/dist/utils/credentials.js

@@ -54,13 +54,16 @@ function getMasterKey() {
     }
 }
 /**
- * Derive encryption key from master key + machine identifiers
+ * Derive encryption key from master key + username.
+ * NOTE: hostname was removed from derivation because Docker/devcontainers
+ * generate random hostnames on each rebuild, breaking credential decryption.
+ * The mk is a 32-byte random value unique per installation — sufficient entropy.
  */
 function deriveKey() {
     const mk = getMasterKey();
-    const machineId = `${os.hostname()}:${os.userInfo().username}`;
+    const userId = os.userInfo().username;
     // Use scrypt for key derivation (secure, slow by design)
-    return crypto.scryptSync(`${mk}:${machineId}`, SALT, 32);
+    return crypto.scryptSync(`${mk}:${userId}`, SALT, 32);
 }
 // =============================================================================
 // Encryption/Decryption

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/cli",
-  "version": "0.5.16",
+  "version": "0.5.17",
   "description": "AI-powered coding assistant CLI using @compilr-dev/agents",
   "type": "module",
   "main": "dist/index.js",
@@ -50,15 +50,16 @@
     "LICENSE"
   ],
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.74.0",
     "@compilr-dev/agents": "^0.3.26",
     "@compilr-dev/agents-coding": "^1.0.4",
     "@compilr-dev/editor-core": "^0.0.2",
-    "@compilr-dev/factory": "^0.1.12",
-    "@compilr-dev/sdk": "^0.3.0",
+    "@compilr-dev/factory": "^0.1.19",
+    "@compilr-dev/logger": "^0.1.0",
+    "@compilr-dev/sdk": "^0.7.1",
     "@compilr-dev/ui-core": "^0.0.1",
     "@modelcontextprotocol/sdk": "^1.23.0",
     "better-sqlite3": "^12.5.0",