chati-dev 4.5.3 → 4.5.5

package/README.md

@@ -67,15 +67,14 @@ Open a terminal in your project directory:
 npx chati-dev init
 ```
 
-The wizard guides you through 4 steps:
+The wizard guides you through these steps:
 
 | Step | What it asks |
 |------|-------------|
 | **Language** | English, Portuguese, Spanish, or French |
 | **Project Type** | Greenfield (new) or Brownfield (existing) |
-| **AI Providers** | Select any combination of Claude, Codex, and Grok |
-| **Primary Harness and Models** | Choose the main CLI and the exact signed-catalog models the project may use |
-| **Execution Profile** | Standard, or Focus AI internal with mandatory ClickUp tracking and completion metrics |
+| **AI Providers** | Select any combination of Claude, Codex, and Grok; models are routed automatically within this provider pool |
+| **Installation Mode** | Open public framework, or Internal with an authorized license and required company integrations |
 | **Confirm** | Review summary and proceed |
 
 ### 2. Activate the orchestrator

package/framework/config.yaml

@@ -1,8 +1,8 @@
 # chati.dev Configuration
-version: "4.5.3"
+version: "4.5.5"
 installed_at: "2026-02-07T10:00:00Z"
-updated_at: "2026-06-11T00:00:00Z"
-installer_version: "4.5.3"
+updated_at: "2026-08-27T00:00:00Z"
+installer_version: "4.5.5"
 project_type: greenfield
 language: en
 ides: [claude-code]

package/framework/context/root.md

@@ -1,7 +1,7 @@
 # Chati.dev System Context
 
 ## Framework
-- **Version**: 4.5.3
+- **Version**: 4.5.5
 - **Agents**: Specialized discovery and planning agents feeding provider-neutral RAIL execution and a sealed release lane
 - **Constitution**: 25 Articles + Preamble
 - **Quality**: 5 pipeline gates + 3-tier verdicts + Fault Vector Protocol (Article XXII)

package/framework/i18n/en.yaml

@@ -24,10 +24,13 @@ installer:
   ide_selection_title: "Select your IDEs / CLIs (multiple allowed):"
   installation_mode_title: "Select the installation mode"
   installation_mode_open: "Open"
-  installation_mode_open_hint: "Public framework without mandatory company integrations"
+  installation_mode_open_hint: "Public framework"
   installation_mode_internal: "Internal"
-  installation_mode_internal_hint: "Requires an authorized license and enables ClickUp tracking plus internal policies"
+  installation_mode_internal_hint: "Requires an authorized license"
   installation_mode_label: "Installation mode"
+  back: "Back"
+  back_hint: "Return to the previous step"
+  install: "Install"
   model_routing_label: "Model routing"
   model_routing_automatic: "Automatic per task across all enabled models"
   providers_label: "Providers"

package/framework/i18n/es.yaml

@@ -24,10 +24,13 @@ installer:
   ide_selection_title: "Seleccione sus IDEs / CLIs (multiples permitidos):"
   installation_mode_title: "Seleccione el modo de instalacion"
   installation_mode_open: "Open"
-  installation_mode_open_hint: "Framework publico sin integraciones corporativas obligatorias"
+  installation_mode_open_hint: "Framework publico"
   installation_mode_internal: "Internal"
-  installation_mode_internal_hint: "Requiere una licencia autorizada y activa el tracking en ClickUp y las politicas internas"
+  installation_mode_internal_hint: "Requiere una licencia autorizada"
   installation_mode_label: "Modo de instalacion"
+  back: "Volver"
+  back_hint: "Regresar al paso anterior"
+  install: "Instalar"
   model_routing_label: "Enrutamiento de modelos"
   model_routing_automatic: "Automatico por tarea entre todos los modelos habilitados"
   providers_label: "Proveedores"

package/framework/i18n/fr.yaml

@@ -24,10 +24,13 @@ installer:
   ide_selection_title: "Selectionnez vos IDEs / CLIs (multiples autorises):"
   installation_mode_title: "Selectionnez le mode d'installation"
   installation_mode_open: "Open"
-  installation_mode_open_hint: "Framework public sans integrations d'entreprise obligatoires"
+  installation_mode_open_hint: "Framework public"
   installation_mode_internal: "Internal"
-  installation_mode_internal_hint: "Necessite une licence autorisee et active le suivi ClickUp et les politiques internes"
+  installation_mode_internal_hint: "Necessite une licence autorisee"
   installation_mode_label: "Mode d'installation"
+  back: "Retour"
+  back_hint: "Revenir a l'etape precedente"
+  install: "Installer"
   model_routing_label: "Routage des modeles"
   model_routing_automatic: "Automatique par tache entre tous les modeles actives"
   providers_label: "Fournisseurs"

package/framework/i18n/pt.yaml

@@ -24,10 +24,13 @@ installer:
   ide_selection_title: "Selecione suas IDEs / CLIs (multiplos permitidos):"
   installation_mode_title: "Selecione o modo de instalacao"
   installation_mode_open: "Open"
-  installation_mode_open_hint: "Framework publico sem integracoes corporativas obrigatorias"
+  installation_mode_open_hint: "Framework publico"
   installation_mode_internal: "Internal"
-  installation_mode_internal_hint: "Exige uma licenca autorizada e ativa o tracking no ClickUp e as politicas internas"
+  installation_mode_internal_hint: "Exige uma licenca autorizada"
   installation_mode_label: "Modo de instalacao"
+  back: "Voltar"
+  back_hint: "Retornar a etapa anterior"
+  install: "Instalar"
   model_routing_label: "Roteamento de modelos"
   model_routing_automatic: "Automatico por task entre todos os modelos habilitados"
   providers_label: "Provedores"

package/framework/manifest.json

@@ -1,5 +1,5 @@
 {
-  "createdAt": "2026-08-27T07:35:51.100Z",
+  "createdAt": "2026-08-27T08:47:47.618Z",
   "files": {
     "agents/build/dev.md": {
       "hash": "5c8da2eee3357bbe84a6c468c76fe60a0c77357575503c3797aa94128282c565",
@@ -97,7 +97,7 @@
       "type": "md"
     },
     "config.yaml": {
-      "hash": "49815a639e15886001dbcd8fcf778212e29b28dc14e960cbce1e6bef9cf60c0e",
+      "hash": "46c9b387f94306f10f2d997d4434ee2dbf1d61f33ea5dc8dd3fec4222d4600a5",
       "size": 2841,
       "type": "yaml"
     },
@@ -122,7 +122,7 @@
       "type": "md"
     },
     "context/root.md": {
-      "hash": "51499195d5281ee92d6414f65c7847fda86cf4a4faea006403f5b1d5b6a575ad",
+      "hash": "833b0c98763b9d6b6418c33ca2b8333a67bb1ef177c71a9e58cc1c7b0ac2059c",
       "size": 1217,
       "type": "md"
     },
@@ -377,23 +377,23 @@
       "type": "js"
     },
     "i18n/en.yaml": {
-      "hash": "5eb0e9dfa7baec166fc12ca8a1c0e9623c9a023c51c09455b80a6d8df1e0205f",
-      "size": 4941,
+      "hash": "b5e9bf16c930a61543b17088a7267caea0c94eb32bfe0ae2e874ba15f5cdb4aa",
+      "size": 4929,
       "type": "yaml"
     },
     "i18n/es.yaml": {
-      "hash": "1ed8c732c13c23e3fc2d5578526c1285a2a1ffc1d79b85d8e12365c3bcbbd882",
-      "size": 5225,
+      "hash": "5407e4c6adba697da8bf2e2dbdf39f1fd32935326166852d5b488487148320f1",
+      "size": 5204,
       "type": "yaml"
     },
     "i18n/fr.yaml": {
-      "hash": "ae88b914ea39d6613879aae3a3fcdf92a771d3df0f207def6cbb2cc76455cfe9",
-      "size": 5290,
+      "hash": "2e3b50c56ee5f05f81c4e48fd048c679baae2280e3a9c03c589f8f82989eded4",
+      "size": 5276,
       "type": "yaml"
     },
     "i18n/pt.yaml": {
-      "hash": "9e766ca8c7eba6362816bdc9d1f6162d615f1b5ca1a9b2f75071a53b7ab9f6b3",
-      "size": 5163,
+      "hash": "da65aff46c8f16b1c6fd6be10b89b566253eec71fea0a42094878dcc9e4671fa",
+      "size": 5147,
       "type": "yaml"
     },
     "intelligence/confidence.yaml": {
@@ -1347,5 +1347,5 @@
       "type": "yaml"
     }
   },
-  "version": "4.5.3"
+  "version": "4.5.5"
 }

package/framework/manifest.sig

@@ -1 +1 @@
-6nwMwMBZREoj26RzRPuaKZahTh6Vxi/THZcqOmJpLZ+F07b60aSvXLp6vVyRDPnCw6XizfMHx81hdg0iQzcVDw==
+XENxdEvoK5ATS/SOccXjzQKNM31wPtbN4KdEjNsp8aZvUGdCU2OKZPDJUh1vFC+i4ZvElD0DSFR17EPrYkmPAw==

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chati-dev",
-  "version": "4.5.3",
+  "version": "4.5.5",
   "description": "AI-Powered Multi-Agent Orchestration System - Structured vibe coding for Full Stack Development",
   "type": "module",
   "bin": {

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

@@ -1,12 +1,12 @@
 {
   "catalog": {
-    "snapshot_id": "chati-model-catalog-2026-08-27",
+    "snapshot_id": "chati-model-catalog-2026-08-27-v2",
     "published_at": "2026-08-27T00:00:00.000Z",
     "expires_at": "2026-11-25T00:00:00.000Z",
     "models": [
       {
         "provider_id": "anthropic",
-        "model_id": "fable",
+        "model_id": "claude-fable-5",
         "actions": [
           "discovery",
           "planning",
@@ -31,7 +31,7 @@
       },
       {
         "provider_id": "anthropic",
-        "model_id": "claude-opus-4-8",
+        "model_id": "claude-opus-5",
         "actions": [
           "discovery",
           "planning",
@@ -122,7 +122,7 @@
       },
       {
         "provider_id": "openai",
-        "model_id": "terra",
+        "model_id": "gpt-5.6-terra",
         "actions": [
           "discovery",
           "planning",
@@ -146,7 +146,7 @@
       },
       {
         "provider_id": "openai",
-        "model_id": "luna",
+        "model_id": "gpt-5.6-luna",
         "actions": [
           "discovery",
           "planning",
@@ -163,21 +163,6 @@
         },
         "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",
@@ -223,56 +208,8 @@
         },
         "adjudication_priority": 70,
         "highest_reasoning_configuration": "xhigh"
-      },
-      {
-        "provider_id": "xai",
-        "model_id": "grok-4.3",
-        "actions": [
-          "discovery",
-          "planning",
-          "build",
-          "review"
-        ],
-        "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": "rNiDCOiVFtrfGUrQWXw3dqR1cYAh/xZElyt0AfLXjhgykWzcw4o0NygK0ciHNXMDwhJUqhsp5fKIPpwli/YdDA=="
+  "signature": "trEytAQJkukerJTwpNvEQ4UO49b+Yth5jtuYNy9WXVSBvKpJCmfuv3tBWyhNgwYG9w3/oKpKDJqJQwIb/oiMAQ=="
 }

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

@@ -1,11 +1,11 @@
 {
-  "snapshot_id": "chati-model-catalog-2026-08-27",
+  "snapshot_id": "chati-model-catalog-2026-08-27-v2",
   "published_at": "2026-08-27T00:00:00.000Z",
   "expires_at": "2026-11-25T00:00:00.000Z",
   "models": [
     {
       "provider_id": "anthropic",
-      "model_id": "fable",
+      "model_id": "claude-fable-5",
       "actions": ["discovery", "planning", "build", "review", "adjudication"],
       "tier": "frontier",
       "natural_role": "architecture and design",
@@ -15,7 +15,7 @@
     },
     {
       "provider_id": "anthropic",
-      "model_id": "claude-opus-4-8",
+      "model_id": "claude-opus-5",
       "actions": ["discovery", "planning", "build", "review", "adjudication"],
       "tier": "frontier",
       "natural_role": "quality rules and judgment-heavy work",
@@ -53,7 +53,7 @@
     },
     {
       "provider_id": "openai",
-      "model_id": "terra",
+      "model_id": "gpt-5.6-terra",
       "actions": ["discovery", "planning", "build", "review", "adjudication"],
       "tier": "workhorse",
       "natural_role": "scoped implementation and efficient review",
@@ -63,22 +63,13 @@
     },
     {
       "provider_id": "openai",
-      "model_id": "luna",
+      "model_id": "gpt-5.6-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",
@@ -98,33 +89,6 @@
       "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"],
-      "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 @@
-rNiDCOiVFtrfGUrQWXw3dqR1cYAh/xZElyt0AfLXjhgykWzcw4o0NygK0ciHNXMDwhJUqhsp5fKIPpwli/YdDA==
+trEytAQJkukerJTwpNvEQ4UO49b+Yth5jtuYNy9WXVSBvKpJCmfuv3tBWyhNgwYG9w3/oKpKDJqJQwIb/oiMAQ==

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

@@ -1,7 +1,7 @@
 import { sha256 } from '@chati/core';
 
 const PROVIDER_BINDINGS = Object.freeze({
-  claude: Object.freeze({ provider_id: 'anthropic', harness_id: 'claude', default_model: 'fable' }),
+  claude: Object.freeze({ provider_id: 'anthropic', harness_id: 'claude', default_model: 'claude-fable-5' }),
   codex: Object.freeze({ provider_id: 'openai', harness_id: 'codex', default_model: 'gpt-5.6-sol' }),
   grok: Object.freeze({ provider_id: 'xai', harness_id: 'grok', default_model: 'grok-4.6' }),
 });

package/src/license/client.js

@@ -141,6 +141,26 @@ export function hasLicenseEntitlement(status, entitlement) {
   return status?.status === 'VALID' && normalizeEntitlements(status.entitlements).includes(entitlement);
 }
 
+/**
+ * Verifies that a saved key is registered for the current machine. A copied
+ * global license file may contain a valid key associated with another host.
+ */
+export async function ensureCurrentMachineLicense({
+  key = getLicenseKey(),
+  validate = validateLicense,
+  activate = activateLicense,
+} = {}) {
+  if (!key) return { status: 'MISSING' };
+  const status = await validate(null);
+  if (status.status === 'VALID' || status.reason !== 'Machine not authorized') return status;
+  const activated = await activate(null, key);
+  return {
+    ...activated,
+    status: 'VALID',
+    entitlements: normalizeEntitlements(activated.entitlements),
+  };
+}
+
 /**
  * Refreshes the server-authoritative license status and requires one
  * entitlement before an internal installation can proceed.
@@ -148,7 +168,10 @@ export function hasLicenseEntitlement(status, entitlement) {
 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.`), {
+    const message = status?.status !== 'VALID' && status?.reason
+      ? `License validation failed: ${status.reason}.`
+      : `The active license is not authorized for ${entitlement} mode.`;
+    throw Object.assign(new Error(message), {
       code: 'LICENSE_ENTITLEMENT_REQUIRED',
       entitlement,
     });

package/src/wizard/i18n.js

@@ -32,10 +32,13 @@ const FALLBACK_EN = {
     editor_selection_title: 'Which editor IDEs should get rules files? (optional)',
     installation_mode_title: 'Select the installation mode',
     installation_mode_open: 'Open',
-    installation_mode_open_hint: 'Public framework without mandatory company integrations',
+    installation_mode_open_hint: 'Public framework',
     installation_mode_internal: 'Internal',
-    installation_mode_internal_hint: 'Requires an authorized license and enables ClickUp tracking plus internal policies',
+    installation_mode_internal_hint: 'Requires an authorized license',
     installation_mode_label: 'Installation mode',
+    back: 'Back',
+    back_hint: 'Return to the previous step',
+    install: 'Install',
     model_routing_label: 'Model routing',
     model_routing_automatic: 'Automatic per task across all enabled models',
     providers_label: 'Providers',

package/src/wizard/index.js

@@ -3,7 +3,7 @@ import { existsSync, readFileSync } from 'fs';
 import { join, dirname, basename } from 'path';
 import { fileURLToPath } from 'url';
 import { logBanner } from '../utils/logger.js';
-import { stepLanguage, stepProjectType, stepProviderSelection, stepEditorSelection, stepModelSelection, stepInstallationMode, stepConfirmation, stepTermsOfUse } from './questions.js';
+import { WIZARD_BACK, stepLanguage, stepProjectType, stepProviderSelection, stepInstallationMode, stepConfirmation, stepTermsOfUse } from './questions.js';
 import { createSpinner, showStep, showValidation, showQuickStart } from './feedback.js';
 import { installFramework } from '../installer/core.js';
 import { INSTALLATION_ARTIFACT_PATH, dryRunV2, installV2, reconfigureV2 } from '../installer-v2/index.js';
@@ -14,7 +14,7 @@ import { initCollector, track as telemetryTrack, flush as telemetryFlush } from
 import { sendEvents } from '../telemetry/sender.js';
 import { getTelemetryConfig } from '../telemetry/config.js';
 import { t } from './i18n.js';
-import { getLicenseKey, activateLicense, requireLicenseEntitlement } from '../license/client.js';
+import { getLicenseKey, activateLicense, ensureCurrentMachineLicense, requireLicenseEntitlement } from '../license/client.js';
 import { DEFAULT_MCPS } from '../config/mcp-configs.js';
 import { IDE_CONFIGS } from '../config/ide-configs.js';
 
@@ -56,81 +56,147 @@ export async function runWizard(targetDir, options = {}) {
   p.log.success(`System check:\n${preflightFmt}`);
 
   // Step 2: Language Selection
-  const language = options.language || await stepLanguage();
+  let language = options.language || await stepLanguage();
 
   // Step 2: Terms of Use (must accept to continue)
   if (options.telemetry === undefined) {
     await stepTermsOfUse();
   }
 
-  // Step 3: Project Type
-  const projectType = options.projectType || await stepProjectType(targetDir);
-
-  // Step 3a: Provider Selection (which AI providers to use)
-  const selectedProviders = options.providers || await stepProviderSelection();
-
-  // Step 3b: Enable the full signed lineup for every selected provider. Runtime
-  // routing selects the right model per task instead of pinning one at install.
   if (options.capabilityCatalog) {
     throw Object.assign(new Error('unsigned capabilityCatalog injection is forbidden; provide signedCapabilityCatalogEnvelope'), { code: 'UNSIGNED_CATALOG_FORBIDDEN' });
   }
-  const catalogResolution = options.signedCapabilityCatalogEnvelope
-    ? { source: 'provided-signed', catalog: verifySignedCapabilityCatalog(options.signedCapabilityCatalogEnvelope, { publicKeyPem: options.catalogPublicKeyPem }) }
-    : await resolveCapabilityCatalog({ projectDir: targetDir, catalogUrl: options.catalogUrl, fetchImpl: options.catalogFetch });
-  const modelSelections = options.modelSelections || await stepModelSelection(selectedProviders, catalogResolution.catalog);
-
-  // Step 3c: Internal mode is a server-authorized entitlement. It enables the
-  // internal policy bundle, including mandatory ClickUp tracking.
-  const installationMode = options.installationMode || await stepInstallationMode();
-  if (installationMode === 'internal') {
-    await requireLicenseEntitlement('internal', { validate: options.licenseValidator });
-  }
 
-  // Step 3e: Editor Selection (which editor IDEs get rules files)
-  const selectedEditors = options.editors || await stepEditorSelection();
-
-  // Combine providers + editors into selectedIDEs for backward compatibility
-  const providerToIDE = { claude: 'claude-code', gemini: 'gemini-cli', codex: 'codex-cli', grok: 'grok-cli' };
-  const selectedIDEs = options.ides || [
-    ...selectedProviders.map(p => providerToIDE[p]).filter(Boolean),
-    ...selectedEditors,
-  ];
-
-  // CLI providers derived from selected providers
-  const cliProviders = selectedProviders;
-
-  const selectedMCPs = options.mcps || DEFAULT_MCPS;
-
-  // Step 4: Confirmation
-  const projectName = basename(targetDir);
-  const config = {
-    projectName,
-    projectType,
-    language,
-    allProviders: cliProviders,
-    selectedIDEs,
-    selectedMCPs,
-    installationMode,
-    modelSelections,
-    targetDir,
-    version: VERSION,
+  let projectType;
+  let selectedProviders;
+  let catalogResolution;
+  let modelSelections;
+  let installationMode;
+  // Editor rule files are a legacy programmatic integration. The interactive
+  // installer configures provider CLIs only, which are the actual runtimes.
+  const selectedEditors = options.editors || [];
+  let config;
+  let v2InstallationInput;
+  let stage = 'project';
+
+  const stageOrder = ['language', 'project', 'providers', 'mode', 'confirm'];
+  const optionKey = {
+    language: 'language',
+    project: 'projectType',
+    providers: 'providers',
+    mode: 'installationMode',
   };
-  const v2InstallationInput = buildWizardV2InstallationInput({
-    projectName,
-    selectedProviders: cliProviders,
-    modelSelections,
-    capabilityCatalog: catalogResolution.catalog,
-    installationMode,
-  });
-  // Validate the complete v2 material and refuse a repeated init before the
-  // legacy installer writes anything. Reconfiguration uses its own backup and
-  // atomic replacement path below.
-  dryRunV2(v2InstallationInput, { projectDir: targetDir });
-  if (existsSync(join(targetDir, INSTALLATION_ARTIFACT_PATH)) && options.reconfigure !== true) {
-    throw Object.assign(new Error('a v2 installation already exists; use --reconfigure to replace it safely'), { code: 'INSTALLATION_ALREADY_EXISTS' });
+  const previousInteractiveStage = (current) => {
+    for (let index = stageOrder.indexOf(current) - 1; index >= 0; index -= 1) {
+      const candidate = stageOrder[index];
+      if (candidate === 'language' ? options.language === undefined : options[optionKey[candidate]] === undefined) {
+        return candidate;
+      }
+    }
+    return null;
+  };
+
+  while (stage !== 'complete') {
+    if (stage === 'language') {
+      language = await stepLanguage();
+      stage = 'project';
+      continue;
+    }
+
+    if (stage === 'project') {
+      const value = options.projectType !== undefined
+        ? options.projectType
+        : await stepProjectType(targetDir, { allowBack: previousInteractiveStage('project') !== null });
+      if (value === WIZARD_BACK) {
+        stage = previousInteractiveStage('project');
+        continue;
+      }
+      projectType = value;
+      stage = 'providers';
+      continue;
+    }
+
+    if (stage === 'providers') {
+      const value = options.providers !== undefined
+        ? options.providers
+        : await stepProviderSelection({ allowBack: previousInteractiveStage('providers') !== null });
+      if (value === WIZARD_BACK) {
+        stage = previousInteractiveStage('providers');
+        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 });
+      // Provider selection defines the permitted routing pool. Model discovery
+      // and task-specific choice stay inside the control plane.
+      modelSelections = options.modelSelections;
+      stage = 'mode';
+      continue;
+    }
+
+    if (stage === 'mode') {
+      const value = options.installationMode !== undefined
+        ? options.installationMode
+        : await stepInstallationMode({ allowBack: previousInteractiveStage('mode') !== null });
+      if (value === WIZARD_BACK) {
+        stage = previousInteractiveStage('mode');
+        continue;
+      }
+      installationMode = value;
+      if (installationMode === 'internal') {
+        try {
+          await requireLicenseEntitlement('internal', { validate: options.licenseValidator });
+        } catch (error) {
+          if (options.installationMode !== undefined) throw error;
+          p.log.error(error.message);
+          continue;
+        }
+      }
+      stage = 'confirm';
+      continue;
+    }
+
+    const providerToIDE = { claude: 'claude-code', gemini: 'gemini-cli', codex: 'codex-cli', grok: 'grok-cli' };
+    const selectedIDEs = options.ides || [
+      ...selectedProviders.map(provider => providerToIDE[provider]).filter(Boolean),
+      ...selectedEditors,
+    ];
+    const cliProviders = selectedProviders;
+    const selectedMCPs = options.mcps || DEFAULT_MCPS;
+    const projectName = basename(targetDir);
+    config = {
+      projectName,
+      projectType,
+      language,
+      allProviders: cliProviders,
+      selectedIDEs,
+      selectedMCPs,
+      installationMode,
+      modelSelections,
+      targetDir,
+      version: VERSION,
+    };
+    v2InstallationInput = buildWizardV2InstallationInput({
+      projectName,
+      selectedProviders: cliProviders,
+      modelSelections,
+      capabilityCatalog: catalogResolution.catalog,
+      installationMode,
+    });
+    dryRunV2(v2InstallationInput, { projectDir: targetDir });
+    if (existsSync(join(targetDir, INSTALLATION_ARTIFACT_PATH)) && options.reconfigure !== true) {
+      throw Object.assign(new Error('a v2 installation already exists; use --reconfigure to replace it safely'), { code: 'INSTALLATION_ALREADY_EXISTS' });
+    }
+    const confirmation = await stepConfirmation(config, { allowBack: previousInteractiveStage('confirm') !== null });
+    if (confirmation === WIZARD_BACK) {
+      stage = previousInteractiveStage('confirm');
+      continue;
+    }
+    stage = 'complete';
   }
 
-  await stepConfirmation(config);
+  const { selectedIDEs, selectedMCPs, allProviders: cliProviders } = config;
 
   // Telemetry: enabled by default (opt-out model via ToS)
   config.telemetryEnabled = options.telemetry !== undefined ? options.telemetry : true;
@@ -250,7 +316,15 @@ export async function runWizard(targetDir, options = {}) {
 
 async function runLicenseActivationStep() {
   const existingKey = getLicenseKey();
-  if (existingKey) return; // already activated, proceed silently
+  if (existingKey) {
+    try {
+      const status = await ensureCurrentMachineLicense({ key: existingKey });
+      if (status.status === 'VALID') return;
+      p.log.warn(`Saved license is not valid on this machine: ${status.reason || status.status}`);
+    } catch (error) {
+      p.log.warn(`Could not verify the saved license: ${error.message}`);
+    }
+  }
 
   console.log('\n  ┌─ License Activation ─────────────────────────────────────────┐');
   console.log('  │  Your license key works across ALL projects on this machine.  │');

package/src/wizard/questions.js

@@ -7,6 +7,12 @@ import { isProviderAvailable } from '../terminal/cli-registry.js';
 import { IDE_CONFIGS, IDE_TO_PROVIDER } from '../config/ide-configs.js';
 import { supportedV2WizardProviders, wizardModelSuggestions } from '../installer-v2/wizard-installation.js';
 
+export const WIZARD_BACK = '__chati_wizard_back__';
+
+function backOption() {
+  return { value: WIZARD_BACK, label: `← ${t('installer.back')}`, hint: t('installer.back_hint') };
+}
+
 /**
  * Step 1: Language Selection (always in English)
  */
@@ -33,7 +39,7 @@ export async function stepLanguage() {
 /**
  * Step 2: Project Type
  */
-export async function stepProjectType(targetDir) {
+export async function stepProjectType(targetDir, { allowBack = false } = {}) {
   const detection = detectProjectType(targetDir);
 
   if (detection.suggestion === 'brownfield' && detection.confidence !== 'low') {
@@ -48,6 +54,7 @@ export async function stepProjectType(targetDir) {
     options: [
       { value: 'greenfield', label: t('installer.greenfield') },
       { value: 'brownfield', label: t('installer.brownfield') },
+      ...(allowBack ? [backOption()] : []),
     ],
     initialValue: detection.suggestion,
   });
@@ -76,7 +83,7 @@ const PROVIDER_DISPLAY_NAMES = {
  * Asks the user which AI providers they want to use (Claude, Gemini, Codex).
  * Returns an array of provider names (e.g. ['claude', 'gemini']).
  */
-export async function stepProviderSelection() {
+export async function stepProviderSelection({ allowBack = false } = {}) {
   const cliIDEs = Object.entries(IDE_CONFIGS).filter(([key, c]) => c.group === 'cli' && supportedV2WizardProviders.includes(IDE_TO_PROVIDER[key]));
   const options = [];
 
@@ -100,7 +107,7 @@ export async function stepProviderSelection() {
 
   const selected = await p.multiselect({
     message: `${t('installer.provider_selection_title')} ${dim('(space to select, enter to confirm)')}`,
-    options,
+    options: allowBack ? [...options, backOption()] : options,
     required: true,
   });
 
@@ -109,19 +116,20 @@ export async function stepProviderSelection() {
     process.exit(0);
   }
 
-  return selected;
+  return selected.includes(WIZARD_BACK) ? WIZARD_BACK : selected;
 }
 
 /**
  * Selects the operational policy profile. Focus AI internal projects require
  * ClickUp tracking; standard projects do not gain that external dependency.
  */
-export async function stepInstallationMode() {
+export async function stepInstallationMode({ allowBack = false } = {}) {
   const mode = await p.select({
     message: t('installer.installation_mode_title'),
     options: [
       { value: 'open', label: t('installer.installation_mode_open'), hint: t('installer.installation_mode_open_hint') },
       { value: 'internal', label: t('installer.installation_mode_internal'), hint: t('installer.installation_mode_internal_hint') },
+      ...(allowBack ? [backOption()] : []),
     ],
     initialValue: 'open',
   });
@@ -142,7 +150,7 @@ export const stepExecutionProfile = stepInstallationMode;
  * Asks the user which editor IDEs should receive rules files.
  * Returns an array of IDE keys (e.g. ['vscode', 'cursor']).
  */
-export async function stepEditorSelection() {
+export async function stepEditorSelection({ allowBack = false } = {}) {
   const editorIDEs = Object.entries(IDE_CONFIGS).filter(([, c]) => c.group === 'editor');
 
   if (editorIDEs.length === 0) return [];
@@ -155,7 +163,7 @@ export async function stepEditorSelection() {
 
   const selected = await p.multiselect({
     message: `${t('installer.editor_selection_title')} ${dim('(space to select, enter to confirm)')}`,
-    options,
+    options: allowBack ? [...options, backOption()] : options,
     required: false,
   });
 
@@ -164,7 +172,7 @@ export async function stepEditorSelection() {
     process.exit(0);
   }
 
-  return selected;
+  return selected.includes(WIZARD_BACK) ? WIZARD_BACK : selected;
 }
 
 /**
@@ -236,23 +244,19 @@ export async function stepIDESelection() {
  */
 export async function stepModelSelection(providers, capabilityCatalog) {
   const selections = {};
-  const summary = [];
 
   for (const provider of providers) {
     const models = wizardModelSuggestions(provider, capabilityCatalog);
     selections[provider] = [...models];
-    summary.push(`${PROVIDER_DISPLAY_NAMES[provider] || provider}: ${models.join(', ')}`);
   }
 
-  p.note(summary.join('\n'), t('installer.model_routing_label'));
-
   return selections;
 }
 
 /**
  * Step 4: Confirmation
  */
-export async function stepConfirmation(config) {
+export async function stepConfirmation(config, { allowBack = false } = {}) {
   const { projectName, projectType, language, selectedMCPs, selectedIDEs, allProviders, installationMode } = config;
 
   const langName = SUPPORTED_LANGUAGES.find(l => l.value === language)?.label || language;
@@ -274,7 +278,6 @@ export async function stepConfirmation(config) {
     [t('installer.project_label')]: `${projectName} (${projectType === 'greenfield' ? 'Greenfield' : 'Brownfield'})`,
     [t('installer.language_label')]: langName,
     [t('installer.providers_label')]: providersDisplay,
-    [t('installer.model_routing_label')]: t('installer.model_routing_automatic'),
     [t('installer.installation_mode_label')]: installationMode === 'internal'
       ? t('installer.installation_mode_internal')
       : t('installer.installation_mode_open'),
@@ -305,10 +308,21 @@ export async function stepConfirmation(config) {
   console.log();
   console.log(`  ${dim('Target:')} ${config.targetDir}`);
 
-  const proceed = await p.confirm({
-    message: t('installer.proceed'),
-    initialValue: true,
-  });
+  const proceed = allowBack
+    ? await p.select({
+      message: t('installer.proceed'),
+      options: [
+        { value: true, label: t('installer.install') },
+        backOption(),
+      ],
+      initialValue: true,
+    })
+    : await p.confirm({
+      message: t('installer.proceed'),
+      initialValue: true,
+    });
+
+  if (proceed === WIZARD_BACK) return WIZARD_BACK;
 
   if (p.isCancel(proceed) || !proceed) {
     p.cancel('Installation cancelled.');