@compilr-dev/cli 0.10.3 → 0.10.4

package/README.md

@@ -47,7 +47,7 @@ Use your preferred AI provider with three tiers per provider (Fast / Balanced /
 |----------|--------|---------|
 | **Claude** | Haiku, Sonnet, Opus | `ANTHROPIC_API_KEY` |
 | **OpenAI** | GPT-4o-mini, GPT-4o, o1 | `OPENAI_API_KEY` |
-| **Gemini** | Flash, Pro, Ultra | `GOOGLE_API_KEY` |
+| **Gemini** | Flash, Pro, Ultra | `GOOGLE_AI_API_KEY` |
 | **Ollama** | Any local model | None (local) |
 | **Together AI** | Open-source models | `TOGETHER_API_KEY` |
 | **Groq** | Fast inference | `GROQ_API_KEY` |
@@ -211,7 +211,7 @@ Run `/keys` inside the CLI to securely store your API keys. Keys are encrypted a
 ```bash
 export ANTHROPIC_API_KEY="sk-ant-..."   # Claude
 export OPENAI_API_KEY="sk-..."          # OpenAI
-export GOOGLE_API_KEY="..."             # Google Gemini
+export GOOGLE_AI_API_KEY="..."          # Google Gemini
 # Ollama: no key needed, just run `ollama serve`
 ```
 

package/dist/models/model-registry.d.ts

@@ -40,5 +40,15 @@ export declare function getAllModelsForProviderUI(provider: ProviderType): Model
 export declare function tierModelExamples(tier: ModelTier, providers?: readonly string[]): string;
 /** The current default model's display name for a tier and provider: "Sonnet 5.5". */
 export declare function tierModelName(provider: string, tier: ModelTier): string;
+/**
+ * The model ID a tier resolves to, for the tutorials' screen mock-ups.
+ *
+ * ⚠️ IDs GO STALE DIFFERENTLY FROM NAMES. `tierModelName` covers prose ("Haiku 5.5"); a mock-up
+ * that shows what the app prints needs the actual id, and a hardcoded one reads as current
+ * forever — `claude-haiku-4-5-20251001` sat in three tutorials as the "Default" through four
+ * model generations. The guard test only checks that the CURRENT name is present, so a stale id
+ * beside it stays green.
+ */
+export declare function tierModelId(provider: string, tier: ModelTier): string;
 /** "Claude, OpenAI, Gemini" — the providers whose current models accept images. */
 export declare function imageProviderNames(): string;

package/dist/models/model-registry.js

@@ -91,6 +91,18 @@ export function tierModelExamples(tier, providers = ['claude', 'openai', 'gemini
 export function tierModelName(provider, tier) {
     return (MODEL_REGISTRY.find((m) => m.provider === provider && m.defaultTier === tier)?.displayName ?? '');
 }
+/**
+ * The model ID a tier resolves to, for the tutorials' screen mock-ups.
+ *
+ * ⚠️ IDs GO STALE DIFFERENTLY FROM NAMES. `tierModelName` covers prose ("Haiku 5.5"); a mock-up
+ * that shows what the app prints needs the actual id, and a hardcoded one reads as current
+ * forever — `claude-haiku-4-5-20251001` sat in three tutorials as the "Default" through four
+ * model generations. The guard test only checks that the CURRENT name is present, so a stale id
+ * beside it stays green.
+ */
+export function tierModelId(provider, tier) {
+    return MODEL_REGISTRY.find((m) => m.provider === provider && m.defaultTier === tier)?.id ?? '';
+}
 /** "Claude, OpenAI, Gemini" — the providers whose current models accept images. */
 export function imageProviderNames() {
     const seen = [];

package/dist/multi-agent/agent-edit.d.ts

@@ -5,7 +5,7 @@
  * likely to be silently wrong: WHICH prompt field an edit reads and writes, and WHAT
  * ends up in the patch.
  */
-import type { TeamAgentUpdate, MascotExpression, ToolProfile } from '@compilr-dev/sdk';
+import type { TeamAgentUpdate, ToolProfile } from '@compilr-dev/sdk';
 import type { CustomAgentDefinition } from './custom-agents.js';
 import type { ModelTier } from '../models/index.js';
 /** The agent's values as they were when the editor opened. */
@@ -13,7 +13,7 @@ export interface AgentEditOriginals {
     displayName: string;
     specialty: string;
     instructions: string;
-    mascot: MascotExpression;
+    mascot: string;
     modelTier: ModelTier;
     toolProfile: ToolProfile;
     /** Tone. Composed into the prompt at initialize() as "Your manner: …". */
@@ -26,7 +26,8 @@ export interface AgentEditedValues {
     displayName: string;
     specialty: string;
     instructions: string;
-    mascot: MascotExpression;
+    /** See `AgentEditOriginals.mascot`. */
+    mascot: string;
     modelTier: ModelTier;
     toolProfile: ToolProfile;
     personality: string;

package/dist/ui/overlay/data/tutorials/config/model-selection.js

@@ -3,7 +3,7 @@
  *
  * Covers the /model overlay: provider tabs, tiers, API keys, model cycling.
  */
-import { tierModelExamples, tierModelName } from '../../../../../models/model-registry.js';
+import { tierModelExamples, tierModelId, tierModelName } from '../../../../../models/model-registry.js';
 export const modelSelectionTutorial = (s) => ({
     id: 'model-selection',
     title: 'Model Selection',
@@ -97,8 +97,8 @@ export const modelSelectionTutorial = (s) => ({
                 `  API Key:      ${s.success('●')} Set`,
                 '',
                 `  ${s.muted('─── Model ID ───')}`,
-                `  Default:      ${s.muted('claude-haiku-4-5-20251001')}`,
-                `  Current:      Haiku 4.5 ${s.muted('[1/5]')}`,
+                `  Default:      ${s.muted(tierModelId('claude', 'fast'))}`,
+                `  Current:      ${tierModelName('claude', 'fast')} ${s.muted('[1/5]')}`,
                 '',
                 `  ${s.success('✓')} This is the active model`,
                 '',

package/dist/ui/overlay/data/tutorials/planning/design.js

@@ -3,6 +3,7 @@
  *
  * Walkthrough of the /design command for comprehensive requirements gathering.
  */
+import { tierModelId } from '../../../../../models/model-registry.js';
 export const designTutorial = (s) => ({
     id: 'design',
     title: 'Design Workflow',
@@ -40,10 +41,10 @@ export const designTutorial = (s) => ({
                 `     /design works best with larger models for complex`,
                 `     multi-question workflows.`,
                 '',
-                `     Current: ${s.muted('claude-haiku-4-5-20251001 (medium tier)')}`,
-                `     Recommended: ${s.primary('claude-sonnet-4-6 (large tier)')}`,
+                `     Current: ${s.muted(`${tierModelId('claude', 'fast')} (medium tier)`)}`,
+                `     Recommended: ${s.primary(`${tierModelId('claude', 'balanced')} (large tier)`)}`,
                 '',
-                `     ${s.primary('>')} 1. Switch to claude-sonnet-4-6 and continue`,
+                `     ${s.primary('>')} 1. Switch to ${tierModelId('claude', 'balanced')} and continue`,
                 `       2. Use /sketch instead (simpler, works with any model)`,
                 `       3. Continue with current model anyway`,
                 '',

package/dist/ui/overlay/data/tutorials/planning/scaffold.js

@@ -3,6 +3,7 @@
  *
  * Walkthrough of the /scaffold command for creating project foundations.
  */
+import { tierModelId } from '../../../../../models/model-registry.js';
 export const scaffoldTutorial = (s) => ({
     id: 'scaffold',
     title: 'Project Scaffolding',
@@ -68,7 +69,7 @@ export const scaffoldTutorial = (s) => ({
                 `     ${s.warning('! Model Recommendation')}`,
                 '',
                 `     /scaffold works best with larger models.`,
-                `     Current: ${s.muted('claude-haiku-4-5 (medium tier)')}`,
+                `     Current: ${s.muted(`${tierModelId('claude', 'fast')} (medium tier)`)}`,
                 '',
                 `     ${s.primary('>')} 1. Switch model and continue`,
                 `       2. Use /sketch instead`,

package/dist/ui/overlay/impl/agent-edit-overlay-v2.d.ts

@@ -14,7 +14,7 @@
  */
 import { BaseOverlayV2 } from '../../base/index.js';
 import type { RenderContext, OverlayAction, KeyEvent } from '../types.js';
-import { type ToolProfile, type MascotExpression } from '@compilr-dev/sdk';
+import { type ToolProfile } from '@compilr-dev/sdk';
 import { type ModelTier } from '../../../models/index.js';
 type FieldKey = 'displayName' | 'specialty' | 'personality' | 'instructions' | 'modelTier' | 'toolProfile' | 'mascot';
 interface EditableField {
@@ -38,7 +38,8 @@ interface AgentEditState {
 export interface AgentEditOptions {
     agentId: string;
     displayName: string;
-    mascot: MascotExpression;
+    /** A face like `[⊡_⊡]`, not a `MascotExpression` — see multi-agent/agent-edit.ts. */
+    mascot: string;
     /** TeamAgent.description — the one-line "what this agent is for". */
     specialty: string;
     /** Tone only. Composed at initialize() as "Your manner: …" (SDK 0.23+). */
@@ -65,7 +66,8 @@ export interface AgentEditValues {
     instructions: string;
     modelTier: ModelTier;
     toolProfile: ToolProfile;
-    mascot: MascotExpression;
+    /** A face like `[⊡_⊡]`, not a `MascotExpression` — see multi-agent/agent-edit.ts. */
+    mascot: string;
 }
 export interface AgentEditResult {
     saved: boolean;

package/dist/ui/overlay/impl/init-setup-overlay-v2.js

@@ -11,7 +11,7 @@
  */
 import { BaseOverlayV2 } from '../../base/overlay-base-v2.js';
 import { renderBorder } from '../../base/index.js';
-import { hasApiKey, getMaskedKey, isKeyFromEnv } from '../../../utils/credentials.js';
+import { hasApiKey, getMaskedKey, isKeyFromEnv, PROVIDER_ENV_VARS, } from '../../../utils/credentials.js';
 import { getSettings } from '../../../settings/index.js';
 import * as terminal from '../../terminal.js';
 // =============================================================================
@@ -38,10 +38,17 @@ export class InitSetupOverlayV2 extends BaseOverlayV2 {
         // API Keys Section
         lines.push(`  ${s.secondary('API Keys')}`);
         lines.push('');
+        /*
+          ⚠️ The env var names come from PROVIDER_ENV_VARS, not from a list written out here. This
+          copy had drifted: it said `GOOGLE_API_KEY` while every reader in the CLI looks at
+          `GOOGLE_AI_API_KEY`, so a user who had set the key correctly was told
+          "✓ From env (GOOGLE_API_KEY)" — a variable they never set — and a user reading this screen
+          to learn the name set the wrong one.
+        */
         const providers = [
-            { key: 'anthropic', name: 'Anthropic (Claude)', envVar: 'ANTHROPIC_API_KEY' },
-            { key: 'openai', name: 'OpenAI', envVar: 'OPENAI_API_KEY' },
-            { key: 'google', name: 'Google AI (Gemini)', envVar: 'GOOGLE_API_KEY' },
+            { key: 'anthropic', name: 'Anthropic (Claude)', envVar: PROVIDER_ENV_VARS.anthropic },
+            { key: 'openai', name: 'OpenAI', envVar: PROVIDER_ENV_VARS.openai },
+            { key: 'google', name: 'Google AI (Gemini)', envVar: PROVIDER_ENV_VARS.google },
         ];
         for (const provider of providers) {
             const has = hasApiKey(provider.key);

package/dist/utils/credentials.d.ts

@@ -17,6 +17,17 @@ export interface StoredCredentials {
     perplexity?: string;
     openrouter?: string;
 }
+/**
+ * The environment variable each provider's key is read from.
+ *
+ * ⚠️ ONE map, exported. It was written out three times — twice inline here and once as a
+ * display label in the `/init` wizard — and the wizard's copy had drifted: it told the user
+ * `GOOGLE_API_KEY` while every reader in the CLI looks at `GOOGLE_AI_API_KEY`. So a user who
+ * had set the key correctly was shown "✓ From env (GOOGLE_API_KEY)", naming a variable they
+ * never set, and a user reading the wizard to learn the name set the wrong one. The published
+ * docs repeat it too, inside a copy-paste block.
+ */
+export declare const PROVIDER_ENV_VARS: Record<ProviderKey, string>;
 /**
  * Get API key for a provider
  * Priority: Environment variable > Stored credential

package/dist/utils/credentials.js

@@ -139,24 +139,34 @@ function saveCredentials(credentials) {
 // =============================================================================
 // Public API
 // =============================================================================
+/**
+ * The environment variable each provider's key is read from.
+ *
+ * ⚠️ ONE map, exported. It was written out three times — twice inline here and once as a
+ * display label in the `/init` wizard — and the wizard's copy had drifted: it told the user
+ * `GOOGLE_API_KEY` while every reader in the CLI looks at `GOOGLE_AI_API_KEY`. So a user who
+ * had set the key correctly was shown "✓ From env (GOOGLE_API_KEY)", naming a variable they
+ * never set, and a user reading the wizard to learn the name set the wrong one. The published
+ * docs repeat it too, inside a copy-paste block.
+ */
+export const PROVIDER_ENV_VARS = {
+    anthropic: 'ANTHROPIC_API_KEY',
+    openai: 'OPENAI_API_KEY',
+    google: 'GOOGLE_AI_API_KEY',
+    ollama: '', // No key needed
+    together: 'TOGETHER_API_KEY',
+    groq: 'GROQ_API_KEY',
+    fireworks: 'FIREWORKS_API_KEY',
+    perplexity: 'PERPLEXITY_API_KEY',
+    openrouter: 'OPENROUTER_API_KEY',
+};
 /**
  * Get API key for a provider
  * Priority: Environment variable > Stored credential
  */
 export function getApiKey(provider) {
     // Check environment variable first
-    const envVarMap = {
-        anthropic: 'ANTHROPIC_API_KEY',
-        openai: 'OPENAI_API_KEY',
-        google: 'GOOGLE_AI_API_KEY',
-        ollama: '', // No key needed
-        together: 'TOGETHER_API_KEY',
-        groq: 'GROQ_API_KEY',
-        fireworks: 'FIREWORKS_API_KEY',
-        perplexity: 'PERPLEXITY_API_KEY',
-        openrouter: 'OPENROUTER_API_KEY',
-    };
-    const envVar = envVarMap[provider];
+    const envVar = PROVIDER_ENV_VARS[provider];
     if (envVar && process.env[envVar]) {
         return process.env[envVar] ?? null;
     }
@@ -236,18 +246,7 @@ export function getMaskedKey(provider) {
  * Check if key is from environment variable
  */
 export function isKeyFromEnv(provider) {
-    const envVarMap = {
-        anthropic: 'ANTHROPIC_API_KEY',
-        openai: 'OPENAI_API_KEY',
-        google: 'GOOGLE_AI_API_KEY',
-        ollama: '',
-        together: 'TOGETHER_API_KEY',
-        groq: 'GROQ_API_KEY',
-        fireworks: 'FIREWORKS_API_KEY',
-        perplexity: 'PERPLEXITY_API_KEY',
-        openrouter: 'OPENROUTER_API_KEY',
-    };
-    const envVar = envVarMap[provider];
+    const envVar = PROVIDER_ENV_VARS[provider];
     return !!(envVar && process.env[envVar]);
 }
 /**

package/dist/utils/model-tiers.js

@@ -28,6 +28,7 @@ const MODEL_TIERS = {
     'claude-fable-5': { tier: 'large', provider: 'anthropic' },
     'claude-opus-4-8': { tier: 'large', provider: 'anthropic' },
     'claude-sonnet-5': { tier: 'large', provider: 'anthropic' },
+    'claude-haiku-5-5': { tier: 'medium', provider: 'anthropic', suggestedUpgrade: 'claude-sonnet-5-5' },
     'claude-haiku-4-5': { tier: 'medium', provider: 'anthropic', suggestedUpgrade: 'claude-sonnet-5-5' },
     // Claude legacy (for backward compatibility)
     'claude-opus-4-7': { tier: 'large', provider: 'anthropic' },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/cli",
-  "version": "0.10.3",
+  "version": "0.10.4",
   "description": "AI-powered coding assistant CLI using @compilr-dev/agents",
   "type": "module",
   "main": "dist/index.js",
@@ -12,8 +12,8 @@
     "start": "node dist/index.js",
     "dev": "tsc -b && node dist/index.js",
     "clean": "tsc -b --clean && rm -rf dist",
-    "lint": "eslint src/",
-    "lint:fix": "eslint src/ --fix",
+    "lint": "eslint src/ tests/",
+    "lint:fix": "eslint src/ tests/ --fix",
     "build:vsix": "cd vscode-extension && npx @vscode/vsce package --out ../dist/compilr-diff-companion.vsix",
     "prepublishOnly": "npm run lint && npm test && npm run build && npm run build:vsix",
     "test": "vitest run",
@@ -22,7 +22,9 @@
     "test:scroll": "npx tsx scripts/test-scroll-regions.ts",
     "test:scroll-input": "npx tsx scripts/test-scroll-input.ts",
     "test:repl-v2": "npx tsx scripts/test-repl-v2.ts",
-    "test:ui": "npx tsx scripts/test-terminal-ui.ts"
+    "test:ui": "npx tsx scripts/test-terminal-ui.ts",
+    "typecheck": "tsc -b && npm run typecheck:tests",
+    "typecheck:tests": "tsc --noEmit -p tsconfig.test.json"
   },
   "keywords": [
     "cli",
@@ -55,12 +57,12 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.74.0",
-    "@compilr-dev/agents": "^0.8.1",
+    "@compilr-dev/agents": "^0.9.1",
     "@compilr-dev/agents-coding": "^1.0.4",
     "@compilr-dev/editor-core": "^0.0.3",
     "@compilr-dev/factory": "^0.1.35",
     "@compilr-dev/logger": "^0.1.0",
-    "@compilr-dev/sdk": "^0.36.0",
+    "@compilr-dev/sdk": "^0.42.0",
     "@compilr-dev/ui-core": "^0.0.1",
     "@modelcontextprotocol/sdk": "^1.23.0",
     "ansi-escapes": "^7.3.0",
@@ -88,10 +90,10 @@
     "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^25.2.3",
     "@types/uuid": "^10.0.0",
-    "@vscode/vsce": "^3.2.0",
+    "@vscode/vsce": "^4.0.0",
     "eslint": "^9.39.1",
     "typescript": "^5.3.0",
     "typescript-eslint": "^8.48.0",
-    "vitest": "^4.0.18"
+    "vitest": "^4.1.11"
   }
 }