chati-dev 4.5.13 → 4.5.15

package/src/terminal/run-agent.js

@@ -3,7 +3,7 @@
  * CLI runner for single-agent terminal execution.
  *
  * Called by the orchestrator via the Bash tool to spawn an agent
- * in a separate Claude Code process with the correct model.
+ * in a separate routed provider process with the exact model binding.
  *
  * Usage:
  *   node run-agent.js --agent detail --task-id expand-prd \
@@ -104,7 +104,11 @@ async function main() {
   }
 
   // Wait for rate limit slot before spawning
-  const spawnProvider = promptResult.provider || args.provider || 'claude';
+  const spawnProvider = promptResult.provider || args.provider;
+  if (!spawnProvider) {
+    outputError('No routed provider was supplied for agent execution');
+    process.exit(1);
+  }
   const readiness = checkProviderReadiness(spawnProvider, { workingDir: projectDir });
   if (!readiness.ready) {
     outputResult({ status: 'error', error: readiness.detail, code: readiness.code, provider: spawnProvider });
@@ -164,7 +168,7 @@ async function main() {
   const costRecord = tracker.recordExecution({
     agent: args.agent,
     model: promptResult.model,
-    provider: promptResult.provider || args.provider || 'claude',
+    provider: spawnProvider,
     taskId: args['task-id'],
     inputText: promptResult.prompt || '',
     outputText: stdout,
@@ -227,7 +231,7 @@ async function main() {
       status: parsed.handoff.status,
       agent: args.agent,
       model: promptResult.model,
-      provider: promptResult.provider || args.provider || 'claude',
+      provider: spawnProvider,
       reasoningConfiguration: args['reasoning-configuration'] || null,
       exitCode: handle.exitCode,
       handoff: parsed.handoff,
@@ -242,7 +246,7 @@ async function main() {
       status: 'needs_input',
       agent: args.agent,
       model: promptResult.model,
-      provider: promptResult.provider || args.provider || 'claude',
+      provider: spawnProvider,
       exitCode: handle.exitCode,
       handoff: recoverInteractiveHandoff(args.agent, stdout, handle.exitCode),
       contractRecovery: 'interactive_output_wrapped',
@@ -257,7 +261,7 @@ async function main() {
       code: parsed.found ? 'INVALID_HANDOFF' : 'MISSING_HANDOFF',
       agent: args.agent,
       model: promptResult.model,
-      provider: promptResult.provider || args.provider || 'claude',
+      provider: spawnProvider,
       exitCode: handle.exitCode,
       handoff: parsed.handoff,
       handoffWarnings: parsed.warnings,

package/src/terminal/run-parallel.js

@@ -138,7 +138,11 @@ async function main() {
   }
 
   // Check rate limit capacity before spawning
-  const groupProvider = configs[0]?.provider || 'claude';
+  const groupProvider = configs[0]?.provider;
+  if (!groupProvider) {
+    outputError('No routed provider was supplied for parallel execution');
+    process.exit(1);
+  }
   const limiter = getRateLimiter(groupProvider);
   const rateStats = limiter.getStats();
   const availableSlots = rateStats.limit - rateStats.used;
@@ -197,7 +201,7 @@ async function main() {
     return {
       agent: cfg.agent,
       model: modelKey,
-      provider: cfg.provider || 'claude',
+      provider: cfg.provider || 'unbound',
       inputTokens,
       outputTokens,
       estimatedCost: ((inputTokens + outputTokens) / 1000) * rate,

package/src/terminal/run-team.js

@@ -86,7 +86,7 @@ async function main() {
   const teamType = args['team-type'];
   const projectDir = args['project-dir'] || process.cwd();
   const previousAgent = args['previous-agent'] || null;
-  const provider = args.provider || 'claude';
+  const provider = args.provider || null;
   const timeout = parseInt(args.timeout, 10) || 1_800_000; // default 30 minutes
 
   if (!teamId || !teamType) {
@@ -94,6 +94,11 @@ async function main() {
     process.exit(1);
   }
 
+  if (!provider) {
+    outputError('Missing required argument: --provider');
+    process.exit(1);
+  }
+
   const members = TEAM_MEMBERS[teamType];
   const taskIds = TEAM_TASK_IDS[teamType];
 
@@ -248,7 +253,7 @@ async function main() {
     return {
       agent: cfg.agent,
       model: modelKey,
-      provider: cfg.provider || 'claude',
+      provider: cfg.provider,
       inputTokens,
       outputTokens,
       estimatedCost: ((inputTokens + outputTokens) / 1000) * rate,

package/src/terminal/spawner.js

@@ -1,7 +1,7 @@
 /**
  * @fileoverview Terminal spawner for multi-agent parallel execution.
  *
- * Spawns separate Claude Code CLI processes so that multiple agents
+ * Spawns separate provider CLI processes so that multiple agents
  * can work concurrently.  The heavy lifting is split into pure,
  * testable helpers (buildSpawnCommand) and a thin runtime layer
  * (spawnTerminal) that actually calls child_process.spawn.
@@ -112,7 +112,6 @@ export function cleanParentEnv(env) {
  * @property {string} [providerId]    - Vendor provider identifier (anthropic, openai, xai)
  * @property {string} [reasoningConfiguration] - Requested reasoning effort
  * @property {string} [catalogSnapshotRef] - Capability catalog snapshot used for routing
- * @property {boolean} [strictProvider] - Reject a missing provider rather than using the legacy fallback
  * @property {string} [prompt]        - Full prompt string (from prompt-builder, piped via stdin)
  * @property {object} [contextPayload] - Context to inject via env var
  * @property {string[]} [writeScope]   - Override write scope
@@ -137,7 +136,7 @@ export function cleanParentEnv(env) {
 
 /**
  * Build the CLI command, arguments and environment for spawning a
- * Claude Code terminal.  This is a **pure function** -- it does not
+ * provider CLI terminal.  This is a **pure function** -- it does not
  * perform any I/O and is therefore fully testable in isolation.
  *
  * @param {SpawnConfig} config
@@ -153,6 +152,11 @@ export function buildSpawnCommand(config) {
   if (!config.taskId || typeof config.taskId !== 'string') {
     throw new Error('config.taskId is required and must be a string');
   }
+  if (!config.provider || typeof config.provider !== 'string') {
+    const failure = new Error('config.provider is required and must be a string');
+    failure.code = 'PROVIDER_REQUIRED';
+    throw failure;
+  }
 
   const terminalId = generateTerminalId(config.agent);
   const isolationEnv = buildIsolationEnv(config.agent);
@@ -175,13 +179,14 @@ export function buildSpawnCommand(config) {
     }
   }
 
-  // Resolve CLI provider — defaults to claude for backwards compatibility
-  const providerName = config.provider || 'claude';
+  // Resolve the exact provider selected by the router. Never substitute a
+  // different vendor when credentials, catalog data, or a CLI are missing.
+  const providerName = config.provider;
   let command, args, prompt;
-  let providerFallback = null;
-  let actualProvider = providerName;
+  const providerFallback = null;
+  const actualProvider = providerName;
   let actualModel;
-  let actualReasoningConfiguration = null;
+  let actualReasoningConfiguration;
 
   try {
     const provider = getProvider(providerName);
@@ -194,32 +199,9 @@ export function buildSpawnCommand(config) {
     actualModel = adapterResult.effectiveModel;
     actualReasoningConfiguration = adapterResult.effectiveReasoningConfiguration;
   } catch (err) {
-    if (config.strictProvider) {
-      const failure = new Error(`Selected provider "${providerName}" is unavailable: ${err.message}`);
-      failure.code = 'SELECTED_PROVIDER_UNAVAILABLE';
-      throw failure;
-    }
-    // Fallback to claude if provider resolution fails (backwards compatibility)
-    providerFallback = {
-      requested: providerName,
-      actual: 'claude',
-      reason: err.message,
-      timestamp: new Date().toISOString(),
-    };
-    actualProvider = 'claude';
-    console.error(`[chati] Provider "${providerName}" resolution failed: ${err.message}. Falling back to claude.`);
-    command = 'claude';
-    args = ['--print', '--dangerously-skip-permissions'];
-    const claudeProvider = getProvider('claude');
-    const requestedClaudeModel = config.model || 'sonnet';
-    actualModel = claudeProvider.modelMap[requestedClaudeModel]
-      || (requestedClaudeModel.startsWith('claude-') ? requestedClaudeModel : claudeProvider.modelMap.sonnet);
-    args.push('--model', actualModel);
-    if (config.reasoningConfiguration) {
-      args.push('--effort', config.reasoningConfiguration);
-      actualReasoningConfiguration = config.reasoningConfiguration;
-    }
-    prompt = config.prompt || null;
+    const failure = new Error(`Selected provider "${providerName}" is unavailable: ${err.message}`);
+    failure.code = 'SELECTED_PROVIDER_UNAVAILABLE';
+    throw failure;
   }
 
   return {
@@ -247,10 +229,10 @@ export function spawnTerminal(config) {
     agent: config.agent,
     taskId: config.taskId,
     provider: actualProvider,
-    providerId: providerFallback ? null : (config.providerId || null),
+    providerId: config.providerId || null,
     model: actualModel,
     reasoningConfiguration: actualReasoningConfiguration,
-    catalogSnapshotRef: providerFallback ? null : (config.catalogSnapshotRef || null),
+    catalogSnapshotRef: config.catalogSnapshotRef || null,
   });
   if (!selectionRecord.saved) {
     const auditError = new Error(selectionRecord.error || 'Failed to persist model selection audit');
@@ -355,12 +337,22 @@ export function spawnParallelGroup(configs) {
     throw new Error(`Write scope conflicts detected: ${details}`);
   }
 
-  // Preemptive rate limit capacity check
-  const groupProvider = configs[0]?.provider || 'claude';
-  const limiter = getRateLimiter(groupProvider);
-  const stats = limiter.getStats();
-  if (stats.used + configs.length > stats.limit) {
-    console.error(`[chati] Rate limit warning: ${stats.used}/${stats.limit} slots used, requesting ${configs.length} more`);
+  // Preemptive capacity check per provider. A parallel group may contain
+  // routed tasks from multiple vendors.
+  const providerCounts = new Map();
+  for (const config of configs) {
+    if (!config?.provider || typeof config.provider !== 'string') {
+      const failure = new Error('Every parallel config requires an explicit provider');
+      failure.code = 'PROVIDER_REQUIRED';
+      throw failure;
+    }
+    providerCounts.set(config.provider, (providerCounts.get(config.provider) || 0) + 1);
+  }
+  for (const [provider, requested] of providerCounts) {
+    const stats = getRateLimiter(provider).getStats();
+    if (stats.used + requested > stats.limit) {
+      console.error(`[chati] Rate limit warning for ${provider}: ${stats.used}/${stats.limit} slots used, requesting ${requested} more`);
+    }
   }
 
   const groupId = `group-${Date.now()}`;

package/src/utils/config-parser.js

@@ -14,12 +14,12 @@ import { resolveFrameworkDir } from './framework-dir.js';
  * Parse provider configuration from config.yaml.
  *
  * @param {string} projectDir - Project root directory
- * @returns {{ primary: string, enabled: string[], raw: string|null }}
+ * @returns {{ primary: string|null, enabled: string[], raw: string|null }}
  */
 export function parseProviderConfig(projectDir) {
   const configPath = join(projectDir, resolveFrameworkDir(projectDir), 'config.yaml');
   if (!existsSync(configPath)) {
-    return { primary: 'claude', enabled: ['claude'], raw: null };
+    return { primary: null, enabled: [], raw: null };
   }
 
   const raw = readFileSync(configPath, 'utf-8');

package/src/utils/provider-limits.js

@@ -38,7 +38,7 @@ function loadLimits() {
   // branch exists so unit tests that run the module without sync still work.
   // 2026-04-18 (context-window-auto-detect-v2): opus family is 1M by default.
   return {
-    providers: { claude: 1_000_000, gemini: 1_000_000, codex: 128_000 },
+    providers: { claude: 1_000_000, gemini: 1_000_000, codex: 128_000, grok: 200_000 },
     models: {
       opus:         1_000_000,
       'opus[1m]':   1_000_000,
@@ -48,6 +48,8 @@ function loadLimits() {
       pro:          1_000_000,
       flash:        1_000_000,
       codex:        128_000,
+      'grok-4.5':   200_000,
+      'grok-4.6':   200_000,
     },
   };
 }

package/src/wizard/feedback.js

@@ -13,6 +13,17 @@ export function createSpinner(text) {
   });
 }
 
+/** Run one automatic operation with a spinner that always stops. */
+export async function withSpinner(text, operation, { spinnerFactory = createSpinner } = {}) {
+  const spinner = spinnerFactory(text);
+  spinner.start();
+  try {
+    return await operation();
+  } finally {
+    spinner.stop();
+  }
+}
+
 /**
  * Show installation progress step
  */

package/src/wizard/i18n.js

@@ -75,7 +75,7 @@ const FALLBACK_EN = {
     created_commands: 'Created .claude/commands/ (thin router)',
     installed_constitution: 'Installed Constitution (Articles I-XXV)',
     created_session: 'Created session.yaml schema',
-    created_claude_md: 'Created CLAUDE.md',
+    created_claude_md: 'Created provider-neutral context and native harness files',
     configured_mcps: 'Configured MCPs:',
     validating: 'Validating installation...',
     agents_valid: 'All agents implement 8 protocols',
@@ -106,6 +106,9 @@ const FALLBACK_EN = {
     system_prerequisites_failed: 'System prerequisites not met:',
     fix_prerequisites: 'Fix the issues above and try again.',
     system_check: 'System check:',
+    system_checking: 'Checking system requirements...',
+    catalog_resolving: 'Loading the signed model catalog...',
+    internal_authorizing: 'Verifying access to Internal mode...',
     created_provider_claude: 'Created .claude/commands/ (thin router)',
     created_provider_gemini: 'Created .gemini/commands/ (TOML command)',
     created_provider_codex: 'Created .agents/skills/chati/ (Codex skill)',
@@ -120,6 +123,7 @@ const FALLBACK_EN = {
     license_placeholder: 'CHATI-XXXX-XXXX-XXXX',
     license_skipped: 'Skipped. Run: npx chati-dev activate --key=YOUR-KEY when ready.',
     license_activating: 'Activating license...',
+    license_verifying: 'Verifying saved license...',
     license_activated: 'License activated! Plan: {plan}, {days} day(s) remaining.',
     license_activation_failed: 'Activation failed: {error}',
     license_retry: 'Run: npx chati-dev activate --key=YOUR-KEY to try again.',
@@ -153,7 +157,7 @@ const FALLBACK_EN = {
   },
   errors: {
     session_corrupted: 'Session file appears corrupted. Attempting recovery...',
-    handoff_missing: 'Handoff not found. Using session.yaml + CLAUDE.md as fallback.',
+    handoff_missing: 'Handoff not found. Using session.yaml + .chati/project-context.md as fallback.',
     agent_failed: 'Agent failed after 3 attempts. Escalating to user.',
     mcp_required: "Required MCP '{mcp}' is not configured. Installation instructions:",
     mcp_optional: "Optional MCP '{mcp}' not configured. Skipping related functionality.",

package/src/wizard/index.js

@@ -4,7 +4,7 @@ import { join, dirname, basename } from 'path';
 import { fileURLToPath } from 'url';
 import { logBanner } from '../utils/logger.js';
 import { WIZARD_BACK, stepLanguage, stepProjectType, stepProviderSelection, stepInstallationMode, stepConfirmation, stepTermsOfUse } from './questions.js';
-import { createSpinner, showStep, showValidation, showQuickStart } from './feedback.js';
+import { createSpinner, withSpinner, showStep, showValidation, showQuickStart } from './feedback.js';
 import { installFramework } from '../installer/core.js';
 import { INSTALLATION_ARTIFACT_PATH, dryRunV2, installV2, reconfigureV2 } from '../installer-v2/index.js';
 import { buildWizardV2InstallationInput } from '../installer-v2/wizard-installation.js';
@@ -48,7 +48,7 @@ export async function runWizard(targetDir, options = {}) {
 
   // Preflight: validate system prerequisites (Node >= 20, npm, Git, Playwright)
   const { runPreflightCheck } = await import('../installer/preflight.js');
-  const preflight = await runPreflightCheck();
+  const preflight = await withSpinner(t('installer.system_checking'), () => runPreflightCheck());
   const preflightFmt = preflight.checks.map(c => {
     const icon = c.status === 'pass' ? '✓' : c.status === 'warn' ? '⚠' : '✗';
     return `  ${icon} ${c.message}`;
@@ -128,9 +128,13 @@ export async function runWizard(targetDir, options = {}) {
         continue;
       }
       selectedProviders = value;
-      catalogResolution ??= options.signedCapabilityCatalogEnvelope
-        ? { source: 'provided-signed', catalog: verifySignedCapabilityCatalog(options.signedCapabilityCatalogEnvelope, { publicKeyPem: options.catalogPublicKeyPem }) }
-        : await resolveCapabilityCatalog({ projectDir: targetDir, catalogUrl: options.catalogUrl, fetchImpl: options.catalogFetch });
+      if (!catalogResolution) {
+        catalogResolution = await withSpinner(t('installer.catalog_resolving'), async () => (
+          options.signedCapabilityCatalogEnvelope
+            ? { source: 'provided-signed', catalog: verifySignedCapabilityCatalog(options.signedCapabilityCatalogEnvelope, { publicKeyPem: options.catalogPublicKeyPem }) }
+            : resolveCapabilityCatalog({ projectDir: targetDir, catalogUrl: options.catalogUrl, fetchImpl: options.catalogFetch })
+        ));
+      }
       // Provider selection defines the permitted routing pool. Model discovery
       // and task-specific choice stay inside the control plane.
       modelSelections = options.modelSelections;
@@ -149,7 +153,10 @@ export async function runWizard(targetDir, options = {}) {
       installationMode = value;
       if (installationMode === 'internal') {
         try {
-          await requireLicenseEntitlement('internal', { validate: options.licenseValidator });
+          await withSpinner(
+            t('installer.internal_authorizing'),
+            () => requireLicenseEntitlement('internal', { validate: options.licenseValidator }),
+          );
         } catch (error) {
           if (options.installationMode !== undefined) throw error;
           p.log.error(error.message);
@@ -328,7 +335,10 @@ async function runLicenseActivationStep() {
   const existingKey = getLicenseKey();
   if (existingKey) {
     try {
-      const status = await ensureCurrentMachineLicense({ key: existingKey });
+      const status = await withSpinner(
+        t('installer.license_verifying'),
+        () => ensureCurrentMachineLicense({ key: existingKey }),
+      );
       if (status.status === 'VALID') return;
       p.log.warn(t('installer.license_saved_invalid', { reason: status.reason || status.status }));
     } catch (error) {