chati-dev 4.5.1 → 4.5.2

package/src/installer-v2/model-catalog-envelope.json

@@ -1,7 +1,8 @@
 {
   "catalog": {
-    "snapshot_id": "chati-model-catalog-2026-08-26",
-    "expires_at": "2026-11-24T00:00:00.000Z",
+    "snapshot_id": "chati-model-catalog-2026-08-27",
+    "published_at": "2026-08-27T00:00:00.000Z",
+    "expires_at": "2026-11-25T00:00:00.000Z",
     "models": [
       {
         "provider_id": "anthropic",
@@ -13,9 +14,87 @@
           "review",
           "adjudication"
         ],
+        "tier": "frontier",
+        "natural_role": "architecture and design",
+        "routing_priority": {
+          "discovery": 95,
+          "planning": 100,
+          "build": 45,
+          "review": 90,
+          "adjudication": 95,
+          "architect": 100,
+          "detail": 100,
+          "ux": 100
+        },
+        "adjudication_priority": 95,
+        "highest_reasoning_configuration": "xhigh"
+      },
+      {
+        "provider_id": "anthropic",
+        "model_id": "claude-opus-4-8",
+        "actions": [
+          "discovery",
+          "planning",
+          "build",
+          "review",
+          "adjudication"
+        ],
+        "tier": "frontier",
+        "natural_role": "quality rules and judgment-heavy work",
+        "routing_priority": {
+          "discovery": 90,
+          "planning": 95,
+          "build": 75,
+          "review": 95,
+          "adjudication": 100,
+          "qa-planning": 97,
+          "qa-implementation": 97
+        },
         "adjudication_priority": 100,
         "highest_reasoning_configuration": "xhigh"
       },
+      {
+        "provider_id": "anthropic",
+        "model_id": "claude-sonnet-5",
+        "actions": [
+          "discovery",
+          "planning",
+          "build",
+          "review"
+        ],
+        "tier": "workhorse",
+        "natural_role": "daily implementation and planning craft",
+        "routing_priority": {
+          "discovery": 85,
+          "planning": 88,
+          "build": 98,
+          "review": 80,
+          "brief": 95,
+          "phases": 95,
+          "tasks": 95,
+          "dev": 98
+        },
+        "adjudication_priority": 60
+      },
+      {
+        "provider_id": "anthropic",
+        "model_id": "claude-haiku-4-5",
+        "actions": [
+          "discovery",
+          "planning",
+          "build",
+          "review"
+        ],
+        "tier": "worker",
+        "natural_role": "small parallel workers and structured transforms",
+        "routing_priority": {
+          "discovery": 55,
+          "planning": 45,
+          "build": 65,
+          "review": 40
+        },
+        "adjudication_priority": 20
+      },
       {
         "provider_id": "openai",
         "model_id": "gpt-5.6-sol",
@@ -26,9 +105,79 @@
           "review",
           "adjudication"
         ],
+        "tier": "frontier",
+        "natural_role": "independent review and long reliable sessions",
+        "routing_priority": {
+          "discovery": 90,
+          "planning": 93,
+          "build": 85,
+          "review": 100,
+          "adjudication": 100,
+          "qa-planning": 100,
+          "qa-implementation": 100,
+          "qa-visual": 100
+        },
         "adjudication_priority": 100,
         "highest_reasoning_configuration": "xhigh"
       },
+      {
+        "provider_id": "openai",
+        "model_id": "terra",
+        "actions": [
+          "discovery",
+          "planning",
+          "build",
+          "review",
+          "adjudication"
+        ],
+        "tier": "workhorse",
+        "natural_role": "scoped implementation and efficient review",
+        "routing_priority": {
+          "discovery": 80,
+          "planning": 85,
+          "build": 100,
+          "review": 92,
+          "adjudication": 75,
+          "dev": 100,
+          "devops": 100
+        },
+        "adjudication_priority": 75,
+        "highest_reasoning_configuration": "xhigh"
+      },
+      {
+        "provider_id": "openai",
+        "model_id": "luna",
+        "actions": [
+          "discovery",
+          "planning",
+          "build",
+          "review"
+        ],
+        "tier": "worker",
+        "natural_role": "low-cost workers and routine tasks",
+        "routing_priority": {
+          "discovery": 60,
+          "planning": 55,
+          "build": 72,
+          "review": 60
+        },
+        "adjudication_priority": 30
+      },
+      {
+        "provider_id": "openai",
+        "model_id": "nano",
+        "actions": [
+          "discovery",
+          "build"
+        ],
+        "tier": "utility",
+        "natural_role": "classification, extraction and cleanup",
+        "routing_priority": {
+          "discovery": 35,
+          "build": 40
+        },
+        "adjudication_priority": 5
+      },
       {
         "provider_id": "xai",
         "model_id": "grok-4.6",
@@ -39,21 +188,91 @@
           "review",
           "adjudication"
         ],
-        "adjudication_priority": 100,
+        "tier": "frontier",
+        "natural_role": "high-reasoning escalation and fast execution",
+        "routing_priority": {
+          "discovery": 88,
+          "planning": 92,
+          "build": 94,
+          "review": 90,
+          "adjudication": 92,
+          "architect": 94
+        },
+        "adjudication_priority": 92,
         "highest_reasoning_configuration": "xhigh"
       },
       {
         "provider_id": "xai",
         "model_id": "grok-4.5",
+        "actions": [
+          "discovery",
+          "planning",
+          "build",
+          "review",
+          "adjudication"
+        ],
+        "tier": "workhorse",
+        "natural_role": "volume waves and speed-first builds",
+        "routing_priority": {
+          "discovery": 82,
+          "planning": 84,
+          "build": 98,
+          "review": 82,
+          "adjudication": 70,
+          "dev": 98
+        },
+        "adjudication_priority": 70,
+        "highest_reasoning_configuration": "xhigh"
+      },
+      {
+        "provider_id": "xai",
+        "model_id": "grok-4.3",
         "actions": [
           "discovery",
           "planning",
           "build",
           "review"
         ],
-        "adjudication_priority": 50
+        "tier": "worker",
+        "natural_role": "cost-efficient parallel execution",
+        "routing_priority": {
+          "discovery": 65,
+          "planning": 60,
+          "build": 78,
+          "review": 60
+        },
+        "adjudication_priority": 35
+      },
+      {
+        "provider_id": "xai",
+        "model_id": "grok-4.20",
+        "actions": [
+          "discovery",
+          "build"
+        ],
+        "tier": "worker",
+        "natural_role": "high-volume structured tasks",
+        "routing_priority": {
+          "discovery": 55,
+          "build": 70
+        },
+        "adjudication_priority": 20
+      },
+      {
+        "provider_id": "xai",
+        "model_id": "grok-build-0.1",
+        "actions": [
+          "build"
+        ],
+        "tier": "specialist",
+        "natural_role": "speed-first implementation in Grok Build",
+        "routing_priority": {
+          "build": 90,
+          "dev": 92
+        },
+        "adjudication_priority": 10
       }
     ]
   },
-  "signature": "p7nTZ2/WlWVWeuqt2eKFTXnSEKZX0X6EM7C0T30+syGV09qjM8soj11U7G4Wjl9u5W6cwEErJZCXdP8WgXHeBA=="
+  "signature": "rNiDCOiVFtrfGUrQWXw3dqR1cYAh/xZElyt0AfLXjhgykWzcw4o0NygK0ciHNXMDwhJUqhsp5fKIPpwli/YdDA=="
 }

package/src/installer-v2/model-catalog.json

@@ -1,33 +1,130 @@
 {
-  "snapshot_id": "chati-model-catalog-2026-08-26",
-  "expires_at": "2026-11-24T00:00:00.000Z",
+  "snapshot_id": "chati-model-catalog-2026-08-27",
+  "published_at": "2026-08-27T00:00:00.000Z",
+  "expires_at": "2026-11-25T00:00:00.000Z",
   "models": [
     {
       "provider_id": "anthropic",
       "model_id": "fable",
       "actions": ["discovery", "planning", "build", "review", "adjudication"],
+      "tier": "frontier",
+      "natural_role": "architecture and design",
+      "routing_priority": { "discovery": 95, "planning": 100, "build": 45, "review": 90, "adjudication": 95, "architect": 100, "detail": 100, "ux": 100 },
+      "adjudication_priority": 95,
+      "highest_reasoning_configuration": "xhigh"
+    },
+    {
+      "provider_id": "anthropic",
+      "model_id": "claude-opus-4-8",
+      "actions": ["discovery", "planning", "build", "review", "adjudication"],
+      "tier": "frontier",
+      "natural_role": "quality rules and judgment-heavy work",
+      "routing_priority": { "discovery": 90, "planning": 95, "build": 75, "review": 95, "adjudication": 100, "qa-planning": 97, "qa-implementation": 97 },
       "adjudication_priority": 100,
       "highest_reasoning_configuration": "xhigh"
     },
+    {
+      "provider_id": "anthropic",
+      "model_id": "claude-sonnet-5",
+      "actions": ["discovery", "planning", "build", "review"],
+      "tier": "workhorse",
+      "natural_role": "daily implementation and planning craft",
+      "routing_priority": { "discovery": 85, "planning": 88, "build": 98, "review": 80, "brief": 95, "phases": 95, "tasks": 95, "dev": 98 },
+      "adjudication_priority": 60
+    },
+    {
+      "provider_id": "anthropic",
+      "model_id": "claude-haiku-4-5",
+      "actions": ["discovery", "planning", "build", "review"],
+      "tier": "worker",
+      "natural_role": "small parallel workers and structured transforms",
+      "routing_priority": { "discovery": 55, "planning": 45, "build": 65, "review": 40 },
+      "adjudication_priority": 20
+    },
     {
       "provider_id": "openai",
       "model_id": "gpt-5.6-sol",
       "actions": ["discovery", "planning", "build", "review", "adjudication"],
+      "tier": "frontier",
+      "natural_role": "independent review and long reliable sessions",
+      "routing_priority": { "discovery": 90, "planning": 93, "build": 85, "review": 100, "adjudication": 100, "qa-planning": 100, "qa-implementation": 100, "qa-visual": 100 },
       "adjudication_priority": 100,
       "highest_reasoning_configuration": "xhigh"
     },
+    {
+      "provider_id": "openai",
+      "model_id": "terra",
+      "actions": ["discovery", "planning", "build", "review", "adjudication"],
+      "tier": "workhorse",
+      "natural_role": "scoped implementation and efficient review",
+      "routing_priority": { "discovery": 80, "planning": 85, "build": 100, "review": 92, "adjudication": 75, "dev": 100, "devops": 100 },
+      "adjudication_priority": 75,
+      "highest_reasoning_configuration": "xhigh"
+    },
+    {
+      "provider_id": "openai",
+      "model_id": "luna",
+      "actions": ["discovery", "planning", "build", "review"],
+      "tier": "worker",
+      "natural_role": "low-cost workers and routine tasks",
+      "routing_priority": { "discovery": 60, "planning": 55, "build": 72, "review": 60 },
+      "adjudication_priority": 30
+    },
+    {
+      "provider_id": "openai",
+      "model_id": "nano",
+      "actions": ["discovery", "build"],
+      "tier": "utility",
+      "natural_role": "classification, extraction and cleanup",
+      "routing_priority": { "discovery": 35, "build": 40 },
+      "adjudication_priority": 5
+    },
     {
       "provider_id": "xai",
       "model_id": "grok-4.6",
       "actions": ["discovery", "planning", "build", "review", "adjudication"],
-      "adjudication_priority": 100,
+      "tier": "frontier",
+      "natural_role": "high-reasoning escalation and fast execution",
+      "routing_priority": { "discovery": 88, "planning": 92, "build": 94, "review": 90, "adjudication": 92, "architect": 94 },
+      "adjudication_priority": 92,
       "highest_reasoning_configuration": "xhigh"
     },
     {
       "provider_id": "xai",
       "model_id": "grok-4.5",
+      "actions": ["discovery", "planning", "build", "review", "adjudication"],
+      "tier": "workhorse",
+      "natural_role": "volume waves and speed-first builds",
+      "routing_priority": { "discovery": 82, "planning": 84, "build": 98, "review": 82, "adjudication": 70, "dev": 98 },
+      "adjudication_priority": 70,
+      "highest_reasoning_configuration": "xhigh"
+    },
+    {
+      "provider_id": "xai",
+      "model_id": "grok-4.3",
       "actions": ["discovery", "planning", "build", "review"],
-      "adjudication_priority": 50
+      "tier": "worker",
+      "natural_role": "cost-efficient parallel execution",
+      "routing_priority": { "discovery": 65, "planning": 60, "build": 78, "review": 60 },
+      "adjudication_priority": 35
+    },
+    {
+      "provider_id": "xai",
+      "model_id": "grok-4.20",
+      "actions": ["discovery", "build"],
+      "tier": "worker",
+      "natural_role": "high-volume structured tasks",
+      "routing_priority": { "discovery": 55, "build": 70 },
+      "adjudication_priority": 20
+    },
+    {
+      "provider_id": "xai",
+      "model_id": "grok-build-0.1",
+      "actions": ["build"],
+      "tier": "specialist",
+      "natural_role": "speed-first implementation in Grok Build",
+      "routing_priority": { "build": 90, "dev": 92 },
+      "adjudication_priority": 10
     }
   ]
 }

package/src/installer-v2/model-catalog.sig

@@ -1 +1 @@
-p7nTZ2/WlWVWeuqt2eKFTXnSEKZX0X6EM7C0T30+syGV09qjM8soj11U7G4Wjl9u5W6cwEErJZCXdP8WgXHeBA==
+rNiDCOiVFtrfGUrQWXw3dqR1cYAh/xZElyt0AfLXjhgykWzcw4o0NygK0ciHNXMDwhJUqhsp5fKIPpwli/YdDA==

package/src/installer-v2/wizard-installation.js

@@ -22,9 +22,11 @@ function fail(code, message) {
   throw error;
 }
 
-function normalizeModels(provider, selections) {
+function normalizeModels(provider, selections, capabilityCatalog) {
   const value = selections?.[provider];
-  const values = value === undefined ? [PROVIDER_BINDINGS[provider].default_model] : (Array.isArray(value) ? value : [value]);
+  const values = value === undefined
+    ? wizardModelSuggestions(provider, capabilityCatalog)
+    : (Array.isArray(value) ? value : [value]);
   const models = [...new Set(values.map((model) => typeof model === 'string' ? model.trim() : '').filter(Boolean))];
   if (models.length === 0) fail('WIZARD_MODEL_REQUIRED', `${provider} requires at least one selected model`);
   return models;
@@ -48,17 +50,16 @@ export function wizardModelSuggestions(provider, capabilityCatalog) {
 export function buildWizardV2InstallationInput({
   projectName,
   selectedProviders,
-  primaryProvider,
   modelSelections = {},
   capabilityCatalog,
-  profile = 'other-supported-profile',
+  installationMode = 'open',
   clock = () => new Date(),
 } = {}) {
   if (typeof projectName !== 'string' || !projectName.trim()) fail('WIZARD_PROJECT_REQUIRED', 'projectName is required');
   if (!Array.isArray(selectedProviders) || selectedProviders.length === 0) fail('WIZARD_PROVIDER_REQUIRED', 'at least one v2 provider is required');
+  if (!['open', 'internal'].includes(installationMode)) fail('WIZARD_INSTALLATION_MODE_INVALID', 'installationMode must be open or internal');
   const providers = [...new Set(selectedProviders)];
   for (const provider of providers) if (!PROVIDER_BINDINGS[provider]) fail('V2_PROVIDER_UNSUPPORTED', `${provider} is not supported by v2`);
-  if (!providers.includes(primaryProvider)) fail('WIZARD_PRIMARY_PROVIDER_REQUIRED', 'primaryProvider must be selected');
   const now = clock();
   const issuedAt = (now instanceof Date ? now : new Date(now));
   if (Number.isNaN(issuedAt.getTime())) fail('WIZARD_CLOCK_INVALID', 'clock must return a valid time');
@@ -74,11 +75,10 @@ export function buildWizardV2InstallationInput({
     return {
       provider_id: binding.provider_id,
       harness_id: binding.harness_id,
-      allowed_models: normalizeModels(provider, modelSelections),
+      allowed_models: normalizeModels(provider, modelSelections, capabilityCatalog),
       allowed_reasoning_configurations: ['low', 'medium', 'high', 'xhigh'],
     };
   });
-  const primary = PROVIDER_BINDINGS[primaryProvider];
   const models = enabled_providers.flatMap((binding) => binding.allowed_models.map((model_id) => {
     const catalogModel = capabilityCatalog?.models?.find((candidate) => candidate.provider_id === binding.provider_id && candidate.model_id === model_id);
     if (capabilityCatalog && !catalogModel) fail('WIZARD_MODEL_NOT_IN_CATALOG', `${model_id} is not in the signed catalog for ${binding.provider_id}`);
@@ -86,6 +86,9 @@ export function buildWizardV2InstallationInput({
       provider_id: binding.provider_id,
       model_id,
       actions: catalogModel?.actions || V2_ACTIONS,
+      ...(catalogModel?.routing_priority !== undefined ? { routing_priority: catalogModel.routing_priority } : {}),
+      ...(catalogModel?.tier !== undefined ? { tier: catalogModel.tier } : {}),
+      ...(catalogModel?.natural_role !== undefined ? { natural_role: catalogModel.natural_role } : {}),
       ...(catalogModel?.adjudication_priority !== undefined ? { adjudication_priority: catalogModel.adjudication_priority } : {}),
       ...(catalogModel?.highest_reasoning_configuration !== undefined
         ? { highest_reasoning_configuration: catalogModel.highest_reasoning_configuration }
@@ -97,13 +100,11 @@ export function buildWizardV2InstallationInput({
   const projectSlug = projectName.trim().toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/(^-|-$)/g, '') || 'project';
   const installation = {
     installation_id: `wizard-${projectSlug}`,
-    profile,
-    primary_harness: primary.harness_id,
-    primary_binding: { provider_id: primary.provider_id, harness_id: primary.harness_id },
+    profile: installationMode === 'internal' ? 'focus-ai-internal' : 'other-supported-profile',
     enabled_providers,
     capability_snapshot_ref: snapshotId,
     policy_ref: `policy://installation/${snapshotId}`,
-    ...(profile === 'focus-ai-internal' ? { external_integrations: { clickup: 'required' } } : {}),
+    ...(installationMode === 'internal' ? { external_integrations: { clickup: 'required' } } : {}),
   };
   return Object.freeze({
     project_id: `project-${projectSlug}`,

package/src/license/client.js

@@ -37,6 +37,11 @@ function writeGlobal(data) {
   try { chmodSync(path, 0o600); } catch { /* non-POSIX FS — skip silently */ }
 }
 
+function normalizeEntitlements(value) {
+  if (!Array.isArray(value)) return [];
+  return [...new Set(value.filter((item) => typeof item === 'string' && item.trim()).map((item) => item.trim()))];
+}
+
 // ---------------------------------------------------------------------------
 // Key helpers
 // ---------------------------------------------------------------------------
@@ -96,6 +101,7 @@ export async function activateLicense(_projectDir, key) {
     plan: data.plan ?? 'trial',
     days_remaining: data.days_remaining ?? null,
     expires_at: data.expires_at ?? null,
+    entitlements: normalizeEntitlements(data.entitlements),
     checked_at: new Date().toISOString(),
   });
 
@@ -123,6 +129,7 @@ export async function validateLicense(_projectDir) {
     days_remaining: data.days_remaining ?? null,
     expires_at: data.expires_at ?? null,
     reason: data.reason ?? null,
+    entitlements: normalizeEntitlements(data.entitlements),
     checked_at: new Date().toISOString(),
   };
 
@@ -130,6 +137,25 @@ export async function validateLicense(_projectDir) {
   return result;
 }
 
+export function hasLicenseEntitlement(status, entitlement) {
+  return status?.status === 'VALID' && normalizeEntitlements(status.entitlements).includes(entitlement);
+}
+
+/**
+ * Refreshes the server-authoritative license status and requires one
+ * entitlement before an internal installation can proceed.
+ */
+export async function requireLicenseEntitlement(entitlement, { validate = validateLicense } = {}) {
+  const status = await validate(null);
+  if (!hasLicenseEntitlement(status, entitlement)) {
+    throw Object.assign(new Error(`The active license is not authorized for ${entitlement} mode.`), {
+      code: 'LICENSE_ENTITLEMENT_REQUIRED',
+      entitlement,
+    });
+  }
+  return status;
+}
+
 /**
  * Remove license locally and deactivate machine slot on server (best-effort).
  * Fails silently if API is unreachable.

package/src/orchestrator/runtime-installation-v2.js

@@ -25,10 +25,29 @@ export function loadRuntimeInstallationV2(projectDir, { clock = () => new Date()
 export function resolveRuntimeInvocationV2({ artifact, agent, binding, model_id, reasoning_configuration, clock = () => new Date() }) {
   const action = AGENT_ACTIONS[agent];
   if (!action) throw Object.assign(new Error(`No v2 action mapping for agent ${agent}`), { code: 'UNMAPPED_AGENT_ACTION' });
-  const selected = binding || artifact.installation.primary_binding;
-  const model = model_id || artifact.installation.enabled_providers
-    .find((candidate) => candidate.provider_id === selected.provider_id && candidate.harness_id === selected.harness_id)
-    ?.allowed_models[0];
+  const candidates = artifact.installation.enabled_providers.flatMap((candidateBinding) => {
+    if (binding && (candidateBinding.provider_id !== binding.provider_id || candidateBinding.harness_id !== binding.harness_id)) return [];
+    return candidateBinding.allowed_models.flatMap((candidateModelId) => {
+      if (model_id && candidateModelId !== model_id) return [];
+      const catalogModel = artifact.capability_snapshot.models.find((candidate) =>
+        candidate.provider_id === candidateBinding.provider_id && candidate.model_id === candidateModelId
+      );
+      if (!catalogModel?.actions.includes(action)) return [];
+      return [{
+        binding: candidateBinding,
+        model: catalogModel,
+        priority: catalogModel.routing_priority?.[agent] ?? catalogModel.routing_priority?.[action] ?? 0,
+      }];
+    });
+  }).sort((left, right) =>
+    right.priority - left.priority
+    || (right.model.adjudication_priority ?? 0) - (left.model.adjudication_priority ?? 0)
+    || `${left.binding.harness_id}:${left.model.model_id}`.localeCompare(`${right.binding.harness_id}:${right.model.model_id}`)
+  );
+  const selectedCandidate = candidates[0];
+  if (!selectedCandidate) throw Object.assign(new Error(`No eligible installed model for ${agent}/${action}`), { code: 'NO_ELIGIBLE_MODEL' });
+  const selected = selectedCandidate.binding;
+  const model = selectedCandidate.model.model_id;
   const invocation = {
     provider_id: selected.provider_id, harness_id: selected.harness_id, action,
     model_pin: { model_id: model, catalog_snapshot_ref: artifact.capability_snapshot.snapshot_id, reasoning_configuration },

package/src/terminal/cli-registry.js

@@ -131,14 +131,14 @@ export function loadEnabledProviders(projectDir) {
 
   // Filter out invalid provider names (typos in config.yaml)
   const validEnabled = enabled.filter(name => validNames.includes(name));
-  const validPrimary = validNames.includes(primary) ? primary : 'claude';
+  const validPrimary = validNames.includes(primary) ? primary : validEnabled[0] || null;
 
   return { primary: validPrimary, enabled: validEnabled };
 }
 
 /**
  * Resolve which provider should be used for a given agent.
- * Priority: agent_overrides > agent default > primary provider.
+ * Priority: agent_overrides > agent default > first enabled legacy fallback.
  *
  * @param {string} agent - Agent name
  * @param {string} projectDir - Project root directory
@@ -166,10 +166,11 @@ export function resolveProviderForAgent(agent, projectDir, agentModels) {
     }
   }
 
-  // Fallback to primary provider with its default light-tier model
-  const provider = PROVIDERS[primary];
+  // Legacy fallback only. Installation v2 routes from the signed task catalog.
+  const fallbackProvider = primary || enabled[0];
+  const provider = PROVIDERS[fallbackProvider];
   const defaultModel = provider ? Object.keys(provider.modelMap)[0] : 'sonnet';
-  return { provider: primary, model: defaultModel };
+  return { provider: fallbackProvider, model: defaultModel };
 }
 
 /**

package/src/terminal/prompt-builder.js

@@ -281,14 +281,14 @@ function buildPrismSection(config) {
 
 /**
  * Load the agent's full .md definition file.
- * For non-primary providers, resolves via overlay directory.
+ * For enabled providers, resolves via the provider-specific overlay directory.
  */
 function loadAgentDefinition(agent, projectDir, provider = null) {
   const relToFramework = AGENT_FILE_PATHS[agent];
   if (!relToFramework) return null;
 
   let fullPath;
-  if (provider && provider !== 'claude') {
+  if (provider) {
     fullPath = resolveOverlayPath(projectDir, relToFramework, provider);
   } else {
     fullPath = join(projectDir, resolveFrameworkDir(projectDir), relToFramework);

package/src/utils/config-parser.js

@@ -1,7 +1,7 @@
 /**
  * @fileoverview Shared YAML config parser for provider configuration.
  *
- * Extracts provider enabled/primary status and agent overrides from
+ * Extracts enabled providers and legacy primary status from
  * config.yaml using lightweight regex-based parsing. Used by
  * cli-registry.js, context-file-generator.js, and health/engine.js.
  */
@@ -23,9 +23,9 @@ export function parseProviderConfig(projectDir) {
   }
 
   const raw = readFileSync(configPath, 'utf-8');
-  const providers = ['claude', 'gemini', 'codex'];
+  const providers = ['claude', 'gemini', 'codex', 'grok'];
   const enabled = [];
-  let primary = 'claude';
+  let primary = null;
 
   for (const name of providers) {
     const enabledMatch = raw.match(new RegExp(`${name}:[\\s\\S]*?enabled:\\s*(true|false)`, 'm'));
@@ -38,11 +38,6 @@ export function parseProviderConfig(projectDir) {
     }
   }
 
-  // Claude is always enabled as fallback
-  if (!enabled.includes('claude')) {
-    enabled.unshift('claude');
-  }
-
   return { primary, enabled, raw };
 }