feat: dynamic provider-aware fallback planning and install provider matrix

docs/installation.md

@@ -106,6 +106,10 @@ Help the user understand the tradeoffs:
 - OpenAI enables `openai/` models.
 - Antigravity (Google) provides Claude and Gemini models via Google infrastructure.
 - Chutes provides free daily-capped models and requires `CHUTES_API_KEY`.
+- Optional external ranking signals:
+  - `ARTIFICIAL_ANALYSIS_API_KEY` (quality/coding/latency/price)
+  - `OPENROUTER_API_KEY` (model pricing metadata)
+  If set, installer dynamic planning uses these signals to improve model ranking.
 
 ### Step 3: Run the Installer
 

package.json

@@ -60,7 +60,7 @@
   "devDependencies": {
     "@biomejs/biome": "2.3.11",
     "bun-types": "latest",
-    "typescript": "^5.7.3"
+    "typescript": "^5.9.3"
   },
   "trustedDependencies": [
     "@ast-grep/cli"

src/cli/config-manager.ts

@@ -1,6 +1,7 @@
 export * from './chutes-selection';
 export * from './config-io';
 export * from './dynamic-model-selection';
+export * from './external-rankings';
 export * from './model-selection';
 export * from './opencode-models';
 export * from './opencode-selection';

src/cli/dynamic-model-selection.test.ts

@@ -83,9 +83,13 @@ describe('dynamic-model-selection', () => {
       'oracle',
       'orchestrator',
     ]);
-    expect(chains.oracle).toContain('openai/gpt-5.3-codex');
+    expect(agents.oracle?.model.startsWith('opencode/')).toBe(false);
+    expect(agents.orchestrator?.model.startsWith('opencode/')).toBe(false);
+    expect(chains.oracle.some((m: string) => m.startsWith('openai/'))).toBe(
+      true,
+    );
     expect(chains.orchestrator).toContain('chutes/kimi-k2.5');
     expect(chains.explorer).toContain('opencode/gpt-5-nano');
-    expect(chains.fixer[chains.fixer.length - 1]).toBe('opencode/big-pickle');
+    expect(chains.fixer[chains.fixer.length - 1]).toBe('opencode/gpt-5-nano');
   });
 });