chati-dev 4.5.4 → 4.5.6

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/bin/chati.js

@@ -28,7 +28,7 @@ const command = args[0] || 'init';
 const KNOWN_SUBCOMMANDS = new Set([
   // CLI subcommands
   'next', 'advance', 'init', 'status', 'validate-handoff', 'deviation', 'exit',
-  'install-v2', 'migrate-v2', 'rail-import', 'rail-next', 'rail-release-ready', 'rail-claim', 'rail-heartbeat', 'rail-recover', 'rail-complete', 'rail-review', 'rail-tracking-reconcile',
+  'install-v2', 'migrate-v2', 'rail-import', 'rail-next', 'rail-release-ready', 'rail-claim', 'rail-heartbeat', 'rail-recover', 'rail-complete', 'rail-review', 'rail-tracking-reconcile', 'rail-tracking-pending', 'rail-tracking-ack',
   'providers', 'detect-flow', 'backlog', 'qa-plan-score', 'qa-impl-score', 'scan',
   'spawn-team', 'team-status', 'team-dissolve',
   'stats', 'list', 'search', 'clean', 'check', // memory/registry subcommands
@@ -274,6 +274,40 @@ async function main() {
       break;
     }
 
+    case 'rail-tracking-pending': {
+      try {
+        const { listPendingClickUpProjections } = await import('../src/orchestrator/clickup-runtime.js');
+        console.log(JSON.stringify(listPendingClickUpProjections({ projectDir: targetDir }), null, 2));
+      } catch (error) {
+        console.error(`Error: ${error.code || 'RAIL_TRACKING_PENDING_FAILED'}: ${error.message}`);
+        process.exitCode = 1;
+      }
+      break;
+    }
+
+    case 'rail-tracking-ack': {
+      const value = (flag) => { const index = args.indexOf(flag); return index === -1 ? null : args[index + 1]; };
+      if (!value('--handoff-id') || !value('--projection-id') || !value('--receipt')) {
+        console.error('Error: rail-tracking-ack requires --handoff-id <id>, --projection-id <id> and --receipt <receipt.json>');
+        process.exitCode = 1;
+        break;
+      }
+      try {
+        const receipt = JSON.parse(readFileSync(resolve(value('--receipt')), 'utf8'));
+        const { acknowledgeClickUpProjection } = await import('../src/orchestrator/clickup-runtime.js');
+        console.log(JSON.stringify(acknowledgeClickUpProjection({
+          projectDir: targetDir,
+          handoff_id: value('--handoff-id'),
+          projection_id: value('--projection-id'),
+          receipt,
+        }), null, 2));
+      } catch (error) {
+        console.error(`Error: ${error.code || 'RAIL_TRACKING_ACK_FAILED'}: ${error.message}`);
+        process.exitCode = 1;
+      }
+      break;
+    }
+
     case 'rail-review': {
       const value = (flag) => { const index = args.indexOf(flag); return index === -1 ? null : args[index + 1]; };
       if (!value('--review') || !value('--invocation')) {

package/framework/agents/plan/tasks.md

@@ -245,7 +245,7 @@ Rules:
 
 - Preserve the same task IDs, dependencies and Given-When-Then criteria in the prose artifact and JSON task graph.
 - `clickup_ref` is mandatory for the internal profile. It is an opaque mapping, not permission to mutate ClickUp directly.
-- `execution_binding` is mandatory. Select only a provider, harness, model and reasoning configuration present in `.chati/v2/installation.json`; choose the best eligible binding for that task. Never name an unselected vendor or rely on the primary harness as an implicit fallback.
+- `execution_binding` is mandatory. Select only a provider, harness, model and reasoning configuration present in `.chati/v2/installation.json`; choose the best eligible binding for that task. Never name an unselected vendor or rely on an implicit fallback.
 - If `requires_browser` is true, provide a complete task-specific `browser_policy`. A global MCP configuration is not sufficient.
 - Do not infer missing execution scope, estimates, dependencies, ClickUp refs or browser policy. Return to planning and make the information explicit.
 

package/framework/config.yaml

@@ -1,32 +1,23 @@
 # chati.dev Configuration
-version: "4.5.4"
+version: "4.5.6"
 installed_at: "2026-02-07T10:00:00Z"
-updated_at: "2026-06-11T00:00:00Z"
-installer_version: "4.5.4"
+updated_at: "2026-08-27T00:00:00Z"
+installer_version: "4.5.6"
 project_type: greenfield
 language: en
-ides: [claude-code]
+ides: []
 
-# CLI providers — multi-CLI is opt-in (Article XIX)
+# Example provider pool. Interactive v2 installation replaces this with the
+# providers selected by the user and resolves models invisibly per task.
 providers:
   claude:
     enabled: true
-    primary: true
   gemini:
     enabled: false
-    model_default: pro
   codex:
-    enabled: false
-    model_default: codex
-
-# Per-agent provider/model overrides (optional — inherits from AGENT_MODELS default)
-# agent_overrides:
-#   dev:
-#     provider: gemini
-#     model: pro
-#   brownfield-wu:
-#     provider: gemini
-#     model: pro
+    enabled: true
+  grok:
+    enabled: true
 
 # Feature flags — toggle new capabilities (v4.2 Phoenix + Intelligence Upgrade)
 features:

package/framework/constitution.md

@@ -425,36 +425,46 @@ Once the orchestrator is activated via `/chati`, a session lock engages. All age
 
 ## Article XVI: Model Governance
 
-The orchestrator SHALL select the optimal AI model for each agent to balance quality and cost efficiency.
+The orchestrator SHALL select the best eligible provider, model and reasoning
+level for each task while balancing quality, cost and review independence.
 
-1. Every agent definition MUST include a `Model` field in its Identity section specifying default model and upgrade conditions.
+1. Installation records only the enabled provider pool. It SHALL NOT ask for or
+   persist a framework-wide primary CLI.
 
-2. Three model tiers are recognized:
-   - **opus**: Deep reasoning, complex analysis, code generation. Use for agents that make critical decisions or produce complex artifacts.
-   - **sonnet**: Structured tasks, guided workflows, template-based output. Use for agents with clear inputs and predictable output formats.
-   - **haiku**: Simple detection, classification, status checks. Use for agents with minimal reasoning requirements.
+2. Model availability comes from a fresh, signed, time-bounded capability
+   catalog. The installer enables every catalog model belonging to the selected
+   providers without exposing a manual model questionnaire.
 
-3. The orchestrator SHALL read the agent's `Model` field before activation and communicate the recommended model to the user.
+3. Routing is automatic and task-specific. Architecture, implementation,
+   review, high-volume work and adjudication MAY route to different models.
+   The user SHALL NOT be asked to switch models manually.
 
-4. Agents marked `no downgrade` MUST NOT run on a model below their default. Quality degradation in these agents compromises downstream artifacts.
+4. Interactive work MAY be relayed through a separately spawned provider CLI.
+   The CLI that opened the session remains the orchestrator, not a permanent
+   execution provider.
 
-5. Upgrade conditions (e.g., "upgrade: opus if enterprise") are evaluated by the orchestrator based on session context: project type, codebase size, number of integrations, and complexity signals from previous agents.
+5. Every invocation MUST resolve to an enabled provider, an allowed exact model
+   and an allowed reasoning configuration. Missing, unavailable or expired
+   bindings are controlled blocks. Silent substitution is forbidden.
 
-6. In IDE environments (Claude Code, Cursor, VS Code), the orchestrator SHALL display a model recommendation message before activating each agent. The user decides whether to switch.
+6. Parallel work MUST resolve each task independently. A group-level model pin
+   SHALL NOT override the task-specific allocation of its members.
 
-7. In programmatic environments (Agent SDK, API), the model selection SHALL be automatic — no user intervention required.
+7. Base work uses the lowest reasoning level appropriate for the task. After
+   two normal rework cycles, adjudication routes to an enabled frontier model
+   at its highest allowed reasoning configuration before human escalation.
 
-8. Model selections are logged in session.yaml under `model_selections[]` for cost tracking and optimization.
+8. Execution and review SHOULD use independent model or harness contexts when
+   risk warrants it. The executor cannot self-approve risk-sensitive work.
 
-9. The initial multi-CLI bindings are **claude**, **codex**, and **grok**. An installation explicitly records its enabled providers, models, primary harness and time-bounded capability snapshot in `.chati/v2/installation.json`.
+9. Model selections are logged under `model_selections[]` with provider, exact
+   model, reasoning level, task identity and catalog snapshot reference.
 
-10. The primary harness is selected during installation. No vendor has a framework-wide primary status.
+10. Provider-specific mechanics may differ, but the invocation, evidence,
+    review and receipt contracts remain provider-neutral.
 
-11. Every invocation MUST resolve to an enabled provider and one of its explicitly allowed models. A missing, unavailable or expired binding is a controlled block. The system MUST NOT silently substitute another provider, model or primary harness.
-
-12. Provider-specific capabilities may change the adapter mechanics, but not the execution contract. Where hooks are unavailable, the equivalent policy is carried through the signed invocation context and verified receipts.
-
-**Enforcement: GUIDE** — Model recommendations are advisory in IDE mode; automatic in SDK mode.
+**Enforcement: BLOCK**: an invocation outside the installed allowlist or without
+an exact task binding cannot execute.
 
 ---
 
@@ -536,7 +546,7 @@ When multiple CLI providers are enabled, the system SHALL coordinate agent execu
 6. The orchestrator SHALL select the optimal binding only from the installation allow-list, based on:
    a. Task routing constraints and required capabilities
    b. The selected model catalog snapshot
-   c. The primary harness only when it is itself an allowed binding
+   c. Task-specific quality, cost and review-independence requirements
    d. Availability evidence, otherwise a controlled block
 
 7. Cost tracking SHALL include provider information. Each model selection entry in session.yaml includes: provider, model, agent, timestamp, and estimated token usage.

package/framework/context/governance.md

@@ -54,7 +54,9 @@ Extracted from `chati.dev/constitution.md` (25 Articles). Read the full constitu
 
 ## Multi-CLI Governance (Article XIX)
 - Initial providers: Claude, Codex, Grok
-- Provider, exact models and primary harness are selected at installation and recorded in `.chati/v2/installation.json`
+- Enabled providers are selected at installation. Exact models and reasoning
+  levels are routed automatically per task from the signed capability snapshot
+  recorded in `.chati/v2/installation.json`. No primary harness is installed.
 - Resolution is restricted to the installation allow-list. An unavailable binding blocks the task, it never falls back silently.
 - Adapter-specific context files are generated only for the selected harnesses.
 

package/framework/context/root.md

@@ -1,7 +1,7 @@
 # Chati.dev System Context
 
 ## Framework
-- **Version**: 4.5.4
+- **Version**: 4.5.6
 - **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/data/entity-registry.yaml

@@ -3,8 +3,8 @@
 # and by the Health Check for system integrity validation.
 
 metadata:
-  version: "4.4.1"
-  last_updated: "2026-05-18T00:00:00Z"
+  version: "4.5.6"
+  last_updated: "2026-08-27T00:00:00Z"
   entity_count: 109
   checksum_algorithm: sha256
 

package/framework/domains/agents/orchestrator.yaml

@@ -49,7 +49,7 @@ rules:
     priority: high
 
   # Provider Routing (v3.0.0)
-  - provider-routing: "Select optimal provider for each agent based on: agent preference, project overrides, provider availability, fallback to primary."
+  - provider-routing: "Select an eligible provider, exact model and reasoning level per task from the installed allowlist. Never fall back to an unselected binding."
     priority: high
   - provider-health: "Validate provider availability via health check before spawning agent terminals."
     priority: high

package/framework/domains/constitution.yaml

@@ -101,7 +101,7 @@ articles:
         priority: high
       - provider-agnostic-handoff: "Handoff format is provider-agnostic. All agents produce handoffs in the same two-layer format."
         priority: critical
-      - provider-fallback: "If a configured provider is unavailable, fall back to primary provider (claude) with warning."
+      - provider-fallback: "If a selected provider or exact model is unavailable, block that invocation with evidence. Never substitute an unselected binding."
         priority: high
       - provider-hooks: "Hook-based governance applies only to providers with hook support. Others use prompt injection."
         priority: high

package/framework/domains/global.yaml

@@ -35,11 +35,11 @@ rules:
 
   # Multi-CLI Rules (v3.0.0)
   multi-cli:
-    - primary-provider: "Claude is the default and primary provider. Multi-CLI is opt-in."
+    - symmetric-provider-pool: "Every provider selected at installation is eligible for task-specific routing. No provider is primary."
       priority: high
     - provider-validation: "Health check validates provider availability before spawning."
       priority: high
-    - provider-model-map: "Each provider has its own model map. Agent assignments reference tier (opus/sonnet/haiku) which maps to provider-specific models."
+    - provider-model-map: "The signed capability snapshot assigns exact provider models and reasoning levels by task role."
       priority: normal
 
 modes:

package/framework/hooks/model-governance.js

@@ -82,6 +82,15 @@ async function main() {
   try {
     const event = JSON.parse(input);
     const projectDir = event.cwd || process.cwd();
+
+    // V2 selects an exact provider, model and reasoning level per task from
+    // the signed installation catalog. It never exposes a model advisory or
+    // asks the user to switch models manually.
+    if (existsSync(join(projectDir, '.chati', 'v2', 'installation.json'))) {
+      process.stdout.write('{}');
+      return;
+    }
+
     const agent = getCurrentAgent(projectDir);
 
     // Advisory context injection via the canonical UserPromptSubmit schema.

package/framework/manifest.json

@@ -1,5 +1,5 @@
 {
-  "createdAt": "2026-08-27T07:55:29.821Z",
+  "createdAt": "2026-08-27T09:30:26.218Z",
   "files": {
     "agents/build/dev.md": {
       "hash": "5c8da2eee3357bbe84a6c468c76fe60a0c77357575503c3797aa94128282c565",
@@ -52,8 +52,8 @@
       "type": "md"
     },
     "agents/plan/tasks.md": {
-      "hash": "e43665228fd7ae5a239e2d4b4298a54c5f06f465a89c9b8e939cf6e6b2ac8089",
-      "size": 28251,
+      "hash": "16c8c649a2172ca741b69fb5d2495f913afae981d57af97cc0503eba05af915b",
+      "size": 28228,
       "type": "md"
     },
     "agents/plan/ux-brand-architect.md": {
@@ -97,18 +97,18 @@
       "type": "md"
     },
     "config.yaml": {
-      "hash": "c031e5565adc3a1dcbfd2534e20b486fd9563158a36d10e2b1f2f73874eb76f4",
-      "size": 2841,
+      "hash": "77e84e99a6e31a664e9da640df949ef4d816359979ac0be093eb7e2c726298bc",
+      "size": 2669,
       "type": "yaml"
     },
     "constitution.md": {
-      "hash": "444fa267ed5f998c428611c61204e390b694ed744913834d06faed9fce543e55",
-      "size": 67858,
+      "hash": "8de0cc0151d38099ff91a3de763bd5766cffde0253acfe6f3179d992d2887079",
+      "size": 67409,
       "type": "md"
     },
     "context/governance.md": {
-      "hash": "80b2243a84b3ec0e9066ee51251685605252e4bd47fa94c2ce25f00af688cd79",
-      "size": 6086,
+      "hash": "bc39df23d48c2cbb005c8e062dfda53442a91f94ccc33f068e26f98d06fe412b",
+      "size": 6200,
       "type": "md"
     },
     "context/protocols.md": {
@@ -122,12 +122,12 @@
       "type": "md"
     },
     "context/root.md": {
-      "hash": "046ff16a4973c4d73d186849bd734914d6b90a9864d5bd41f435991b7004c8b2",
+      "hash": "57e0b456f520705cef15b47a4aa7bb9d159d26222a8e04c094064a0bce323c16",
       "size": 1217,
       "type": "md"
     },
     "data/entity-registry.yaml": {
-      "hash": "48726ba4b1e84a114e783865ab0b9881bd869924d8b5ac0c6fd75f95f30219cc",
+      "hash": "8852405c96cccf20672111d9367d0ebf87225e79eb966e56353d957ac6d7f037",
       "size": 34605,
       "type": "yaml"
     },
@@ -177,8 +177,8 @@
       "type": "yaml"
     },
     "domains/agents/orchestrator.yaml": {
-      "hash": "6fdb938ef08f81ba60d189e09c5de06275ac53ecf2510d844369ac72a811972c",
-      "size": 1836,
+      "hash": "4c515e592ed43499c2f77aa324569e2f145eb6e6005ef5a6a9b35a39d7bdcfa8",
+      "size": 1848,
       "type": "yaml"
     },
     "domains/agents/phases.yaml": {
@@ -212,13 +212,13 @@
       "type": "yaml"
     },
     "domains/constitution.yaml": {
-      "hash": "e606a668f1ac03dbde194dbea2af676d64668e024f14b7d3b38063a715a10af3",
-      "size": 7000,
+      "hash": "497b41ae7c45402ac43081c2081639fa2ac86619bd83d86452343fe6d68f39ed",
+      "size": 7037,
       "type": "yaml"
     },
     "domains/global.yaml": {
-      "hash": "1be2bdf691e3e00650c9a468fab163581e1b71ebcd2e0d4083131600058628a6",
-      "size": 3002,
+      "hash": "b51d337cbcd9c722961aa137925a70816a06eb5b1305246c9aba110e5a32e8e9",
+      "size": 3013,
       "type": "yaml"
     },
     "domains/workflows/brownfield-discovery.yaml": {
@@ -317,8 +317,8 @@
       "type": "js"
     },
     "hooks/model-governance.js": {
-      "hash": "d7f273d0330a1d24ccd5c73208993110c188548254e6f7c24e30a6f5fb8de79f",
-      "size": 5514,
+      "hash": "93db3ea86ca82b6b00c330583be32130a6b8e7d2182dcc222ef71db1f92ce050",
+      "size": 5849,
       "type": "js"
     },
     "hooks/package.json": {
@@ -472,8 +472,8 @@
       "type": "md"
     },
     "orchestrator/chati.md": {
-      "hash": "c2d895fd342422985b68d4912189f2abcfb2bac536c5cf325d0480faf9db5f9f",
-      "size": 44348,
+      "hash": "6ce86145704af5e933b7372ccd331e70679066522c324031f4e8701b7f950cc5",
+      "size": 45331,
       "type": "md"
     },
     "patterns/elicitation-library.yaml": {
@@ -852,8 +852,8 @@
       "type": "json"
     },
     "schemas/session.schema.json": {
-      "hash": "00cdca67431066d7c5a1796b6a7f4c42076925e2fa19c53e2813f54bd30ff206",
-      "size": 18002,
+      "hash": "f2ab86653c6e52a008268256198b9319de1602515aafd504bbbbe69df696c1de",
+      "size": 18014,
       "type": "json"
     },
     "schemas/task.schema.json": {
@@ -932,33 +932,33 @@
       "type": "md"
     },
     "tasks/brownfield-wu-architecture-map.md": {
-      "hash": "2629992b3c0cabeee6d737829cd0019063919d37f1557cd230d6eb4086fc045c",
-      "size": 15223,
+      "hash": "82aa0a7913217efec678c020a80510f7c808fdbde7838a67990582dd3a2976d4",
+      "size": 15213,
       "type": "md"
     },
     "tasks/brownfield-wu-deep-discovery.md": {
-      "hash": "00c79ae4e14fad5f523003211432aec8dcafa5d898edca5c4f5757a0b3cadb01",
-      "size": 9457,
+      "hash": "97e84d96328c8c80dc6935793a7693ade49ed115e26d289ec065e0e91c018cd1",
+      "size": 9447,
       "type": "md"
     },
     "tasks/brownfield-wu-dependency-scan.md": {
-      "hash": "695440e1cb653ca8fbd5d7303defd73bdf9b4367e35040aae88a50a58c35ebb5",
-      "size": 11363,
+      "hash": "e61ae20e0824d38938621d6d2b6d226bcc634860332ac1baf61aafba8b6f8e7f",
+      "size": 11353,
       "type": "md"
     },
     "tasks/brownfield-wu-migration-plan.md": {
-      "hash": "2553b460f9e8e5a88029cea1ae62613b0f5d553b8bdf54b79f3e2804d291b994",
-      "size": 16870,
+      "hash": "bd638271c6332f0c0ab772b9f054462fbdfafd83e4d1c23a1408c7a19ed5e7cc",
+      "size": 16860,
       "type": "md"
     },
     "tasks/brownfield-wu-report.md": {
-      "hash": "c23bb38808a7c7f5a4a6964145c82effca8abd386243628c48b7dbd57aac62e6",
-      "size": 10749,
+      "hash": "3af5e12047cfc34e091444a874b3c086e70b129a2dbc8f216c9e00ebf7d9107a",
+      "size": 10739,
       "type": "md"
     },
     "tasks/brownfield-wu-risk-assess.md": {
-      "hash": "b891b2ca0710e926d31fcb066d17caf1d75602318f205d54b7d754caedf59449",
-      "size": 14125,
+      "hash": "ff1b71c068a2a1ab662bb12554c24dc422ef34f704c41eafc85b8e705569b330",
+      "size": 14115,
       "type": "md"
     },
     "tasks/detail-acceptance-criteria.md": {
@@ -1057,8 +1057,8 @@
       "type": "md"
     },
     "tasks/greenfield-wu-report.md": {
-      "hash": "c0668589f6fd185ce31ced7bad67c78dfae43a481a6a0980c7cf305f635d900b",
-      "size": 9429,
+      "hash": "b291438e22a7336684042a164c70386d181571e428d1a7d029404ac5cf1afa40",
+      "size": 9419,
       "type": "md"
     },
     "tasks/greenfield-wu-scaffold-detection.md": {
@@ -1347,5 +1347,5 @@
       "type": "yaml"
     }
   },
-  "version": "4.5.4"
+  "version": "4.5.6"
 }

package/framework/manifest.sig

@@ -1 +1 @@
-8t69CRtft7FLT0qSIiCVC7zuHbWVEVXvYtQTxm9B6/Ln3+J5UC0rlzl3mI69qD2P8tZPUNyCbdaWfLbwSyVaBw==
+vWBsUGE3V8dJWM3K5vpCFcUAeqdRor+u3DyDsIzUKtXE8le4HVw8hRvfMa9P4PDyoZvrY/smYteiHKZcdXeGDA==

package/framework/orchestrator/chati.md

@@ -97,6 +97,7 @@ Parse the JSON output. The `action` field tells you what to do:
 |--------|-------|
 | `setup` | Action: Setup |
 | `activate_interactive` | Action: Interactive Agent |
+| `spawn_routed_interactive` | Action: Routed Interactive Agent |
 | `spawn_autonomous` | Action: Autonomous Agent |
 | `spawn_parallel` | Action: Parallel Spawn |
 | `spawn_team` | Action: Spawn Team (Article XXI) |
@@ -165,7 +166,7 @@ The user should experience a smooth start: they describe their project, the orch
 
 These agents (greenfield-wu, brownfield-wu, brief) run in the same conversation.
 
-1. Track model recommendation from JSON `model_info` internally. Do NOT display "Model recommendation for {agent}" or expose internal agent names. If the recommended model is materially different from the current one and the difference will affect quality, mention it briefly in plain language: e.g., "This step works best on Opus - switch with /model opus if you want stronger reasoning." Otherwise stay silent.
+1. Treat `model_info` as internal routing evidence. Do not display it or ask the user to switch models. V2 conversational work uses Routed Interactive Agent instead.
 2. Read the **FULL** agent file from `agent_file` in the JSON response (do NOT use limit/offset - read the entire file)
 3. Load its full content and **become** that agent
 4. Follow the agent's instructions - the user interacts with you directly
@@ -180,6 +181,26 @@ These agents (greenfield-wu, brownfield-wu, brief) run in the same conversation.
 
 ---
 
+## Action: Routed Interactive Agent
+
+V2 keeps the conversation in the CLI that the user opened, while the task
+itself runs on the exact provider, model and reasoning level selected by the
+internal router.
+
+1. Do not expose `model_info`, model names or routing recommendations.
+2. Execute the exact `spawn_command` returned by the router.
+3. Parse the JSON result:
+   - `complete`: present Completion Options. On approval, advance the agent.
+   - `needs_input`: ask only `needs_input_question` in the user's language,
+     relay the response through `--additional-context`, then rerun the same
+     exact provider and model binding. Limit this relay to three cycles.
+   - `error`: use the Recovery Protocol. Never silently change provider or
+     model in a v2 installation.
+4. The opened CLI remains the conversation orchestrator. The routed process
+   does not become a framework-wide primary CLI.
+
+---
+
 ## Completion Options (Protocol 3 - Guided Options)
 
 After EVERY agent completes (interactive or autonomous), present exactly 3 numbered options. The user should never have to figure out "what now" - always offer clear next steps with a recommendation.
@@ -301,8 +322,11 @@ Planning phase agents (detail, architect, ux) run simultaneously.
 **NOTE (Article XXI):** When `features.agent_teams: true` in config.yaml, the orchestrator MUST attempt `spawn_team` FIRST for Planning Team (detail, architect, ux, qa-planning) and Build Team (dev, qa-implementation). Only fall back to `spawn_parallel` if team spawning is unavailable or fails. The CLI `orchestrate next` command handles this automatically - when teams are enabled, it returns `spawn_team` instead of `spawn_parallel`.
 
 1. Display naturally what is happening using user-facing language. Examples (pick one that fits the phase): "Working on the planning phase now." / "Reviewing the architecture and UX in parallel." NEVER say "spawning parallel group", "spawn_parallel", or list internal agent names like "detail, architect, ux".
-2. Execute `parallel_spawn_command` via Bash tool
-3. Parse consolidated JSON output
+2. If `parallel_spawn_commands` is non-empty, execute every member's `command`
+   concurrently and keep each output associated with its `agent`. Each command
+   has its own exact provider and model binding. Otherwise, execute the legacy
+   `parallel_spawn_command`.
+3. Consolidate and parse the member outputs without replacing their bindings
 4. Present **Completion Options** (Parallel Group variant) - wait for user choice
 5. On approval, for each completed agent, run `node chati.dev/orchestrator/chati-router.js advance --agent {name} --score {score}`
 6. If partial or total failure (spawning unavailable):

package/framework/schemas/session.schema.json

@@ -93,7 +93,7 @@
     "ides": {
       "type": "array",
       "items": {
-        "enum": ["claude-code", "vscode", "antigravity", "cursor", "gemini-cli", "codex-cli"]
+        "enum": ["claude-code", "vscode", "antigravity", "cursor", "gemini-cli", "codex-cli", "grok-cli"]
       },
       "description": "Configured IDEs"
     },

package/framework/tasks/brownfield-wu-architecture-map.md

@@ -182,7 +182,7 @@ Create ASCII/text representation of architecture:
 ```yaml
 # architecture-map.yaml
 timestamp: 2026-02-13T11:30:00Z
-project_path: /Users/user/projects/legacy-app
+project_path: /workspace/legacy-app
 
 primary_architecture: layered_architecture
 secondary_patterns: [mvc, repository_pattern, event_driven]

package/framework/tasks/brownfield-wu-deep-discovery.md

@@ -186,7 +186,7 @@ If git repository exists:
 ## Output Format
 ```yaml
 # discovery.yaml
-project_path: /Users/user/projects/legacy-app
+project_path: /workspace/legacy-app
 timestamp: 2026-02-13T11:00:00Z
 filesystem:
   total_files: 2847

package/framework/tasks/brownfield-wu-dependency-scan.md

@@ -164,7 +164,7 @@ For each recommendation:
 ```yaml
 # dependencies.yaml
 timestamp: 2026-02-13T11:15:00Z
-project_path: /Users/user/projects/legacy-app
+project_path: /workspace/legacy-app
 runtime: node
 
 manifests:

package/framework/tasks/brownfield-wu-migration-plan.md

@@ -188,7 +188,7 @@ For each phase, document:
 ```yaml
 # migration-plan.yaml
 timestamp: 2026-02-13T12:00:00Z
-project_path: /Users/user/projects/legacy-app
+project_path: /workspace/legacy-app
 
 migration_strategy: incremental_strangler_fig
 strategy_justification: |

package/framework/tasks/brownfield-wu-report.md

@@ -113,7 +113,7 @@ Combine all sections into comprehensive YAML with clear structure and actionable
 # wu-report.yaml
 report_type: brownfield
 timestamp: 2026-02-13T12:15:00Z
-project_path: /Users/user/projects/legacy-app
+project_path: /workspace/legacy-app
 
 executive_summary: |
   Analyzed mature 1793-day-old Next.js + Express application with 30k LOC and 87 dependencies.

package/framework/tasks/brownfield-wu-risk-assess.md

@@ -185,7 +185,7 @@ For each high and critical risk:
 ```yaml
 # risk-assessment.yaml
 timestamp: 2026-02-13T11:45:00Z
-project_path: /Users/user/projects/legacy-app
+project_path: /workspace/legacy-app
 
 executive_summary: |
   Identified 47 risks across security, performance, technical debt, and maintainability.

package/framework/tasks/greenfield-wu-report.md

@@ -128,7 +128,7 @@ executive_summary: |
   Estimated 30 minutes to initial scaffold, 2-4 hours to complete tooling setup.
 
 environment:
-  project_path: /Users/user/projects/my-app
+  project_path: /workspace/my-app
   current_state: empty
   maturity_score: 0
   runtime:

package/node_modules/@chati/provider-registry/src/index.js

@@ -113,8 +113,9 @@ export function validateInstallation(installation, snapshot, { bindingMap = DEFA
   } else if (installation.primary_harness !== undefined) {
     throw new ContractError('PRIMARY_BINDING_MISSING', 'legacy primary_harness requires primary_binding');
   }
-  if (installation.profile === 'focus-ai-internal' && installation.external_integrations?.clickup !== 'required') {
-    throw new ContractError('PROFILE_DEPENDENCY_MISSING', 'focus-ai-internal requires ClickUp');
+  if (installation.profile === 'authorized-internal'
+    && installation.external_integrations?.clickup !== 'required') {
+    throw new ContractError('PROFILE_DEPENDENCY_MISSING', 'the internal profile requires ClickUp');
   }
   return Object.freeze(canonicalize(installation));
 }