fix(catalog): price free SKUs at $0 and fill remaining gaps from models.dev

Drop hardcoded FALLBACK_COSTS so billed rates come from CLI, official docs, or models.dev instead of a plugin table. Command Code free SKUs stay $0 and do not inherit paid twins.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: BrainerVirus

README.md

@@ -16,7 +16,7 @@ This package is based on **[FanFan4204/opencode-commandcode-provider](https://gi
 
 - Bundled `models.json` is the default runtime catalog (no local CLI scrape).
 - CLI cost extraction can fail (as on `command-code@1.38.x`) without dropping models.
-- Official docs fill missing costs; leftover models use a conservative fallback (`degraded` in `manifest.json`).
+- Official docs fill missing costs; remaining paid gaps use [models.dev](https://models.dev) as a reference. Command Code free SKUs stay `$0`.
 - Reasoning effort **variants** on models that declare `reasoningEfforts`.
 - Quiet OpenCode startup (diagnostics go to `startup.json`, not stdout).
 

docs/2026-08-28-ci-catalog/spec.md

@@ -15,7 +15,7 @@ Watch `command-code` on npm every 6 hours, refresh the bundled catalog, publish
 - Tag + GitHub Release **after** successful `npm publish` only. Never tag a version that is not on the registry.
 - Catalog auto-commit uses `GITHUB_TOKEN` (or `CATALOG_PUSH_TOKEN` if protection blocks it). Those commits do **not** trigger other workflows, so catalog-sync must publish in the **same job**.
 - Human merges to `main` run a separate release job that publishes only if `package.json` version is unpublished (code fixes).
-- Cost-only CLI failure still ships (`degraded` if fallback/unmatched costs remain). Model extract failure → no publish, `catalog-break` issue.
+- Cost-only CLI failure still ships (`degraded` only if unmatched placeholder costs remain). Model extract failure → no publish, `catalog-break` issue.
 - Runtime catalog stays bundled `models.json`. No GitHub fetch at OpenCode startup.
 - Hybrid OpenCode transport stays `@ai-sdk/openai-compatible` + Provider API; this package is the **plugin**, not the SDK `npm` field.
 

docs/specs/2026-08-28-ci-catalog-automation.md

@@ -61,6 +61,7 @@ Human- and CI-readable metadata about the bundled catalog. Shipped with the plug
     "cli": 40,
     "officialDocs": 25,
     "thirdParty": 0,
+    "free": 0,
     "fallback": 0,
     "unmatched": 0
   },
@@ -71,18 +72,18 @@ Human- and CI-readable metadata about the bundled catalog. Shipped with the plug
 Write order: bump `package.json` version first, then write `manifest.json` with that `pluginVersion`, then one commit. Do not store `gitCommit` in the file (unknown until after commit; put SHA on the GitHub Release instead).
 
 `status` rules:
-- `healthy`: model catalog ok **and** every model has costs from `cli`, `officialDocs`, or `thirdParty` (`fallback` = 0 and `unmatched` = 0)
-- `degraded`: model catalog ok, but at least one model used hardcoded fallback or has no cost
+- `healthy`: model catalog ok **and** every model has a sourced price (`cli`, `officialDocs`, `thirdParty` / models.dev, or `free`). `unmatched` = 0
+- `degraded`: model catalog ok, but at least one model still has the unmatched placeholder `{ input: 0.5, output: 2 }`
 - `broken`: model catalog extraction failed
 
-`extraction.costCatalog` is the **best** source that contributed (`cli` | `docs` | `thirdParty` | `fallback` | `missing`).
+`extraction.costCatalog` is the **best** source that contributed (`cli` | `docs` | `thirdParty` | `free` | `fallback` | `missing`).
 
 Status values:
 
 | status | Meaning | CI action |
 |---|---|---|
-| `healthy` | models ok; costs from CLI, official docs, and/or trusted API | release |
-| `degraded` | models ok; some costs are hardcoded fallback or missing | release + note which models fell through |
+| `healthy` | models ok; costs from CLI, official docs, models.dev, and/or free SKUs | release |
+| `degraded` | models ok; some costs have no listed source | release + note which models fell through |
 | `broken` | model catalog extraction failed | no release, open issue |
 
 ### `_version.txt` (existing)
@@ -100,10 +101,11 @@ Waterfall, per model, first hit wins. Later steps only fill models still missing
    - Preferred parse target: [https://commandcode.ai/models](https://commandcode.ai/models) (per-model table: Input/M, Output/M, Cache read, Cache write).
    - Fallback page: [https://commandcode.ai/docs/resources/pricing-limits](https://commandcode.ai/docs/resources/pricing-limits) if `/models` fetch or parse fails.
    - Store the **current billed** per-1M USD rates shown on the page (deal-adjusted when the page shows an effective price). Do not invent deal math.
-3. **Trusted third-party API** — only if a provider is configured (`COST_ENRICHMENT_API_URL` secret/env). Default: **none**. Skip this step until one is added. Do not use OpenRouter (or similar) unless explicitly configured; their list prices are not Command Code’s billed rates.
-4. **Hardcoded fallback** (`FALLBACK_COSTS` + existing default `{ input: 0.5, output: 2 }`) — last resort so the catalog still ships.
+3. **Free SKUs** — catalog id/name matching `\bfree\b` or id ending `-free` → `{ input: 0, output: 0 }`. Runs **before** models.dev so Command Code free SKUs stay $0 even when models.dev lists a paid twin (e.g. Tencent Hy3).
+4. **models.dev** — `GET https://models.dev/api.json` for remaining **paid** gaps. Exact id (case-insensitive), then last path segment as id, then exact display name. Reference prices, not Command Code billed rates. Do not apply to free SKUs.
+5. **Unmatched placeholder** `{ input: 0.5, output: 2 }` — last resort so the catalog still ships. These are the only models that mark the catalog `degraded`.
 
-Match docs/API rows to catalog models with **exact** id (case-insensitive) then **exact** display name (case-insensitive). No fuzzy matching. Unmatched models go to the next step.
+Match docs/API rows to catalog models with **exact** id (case-insensitive) then **exact** display name (case-insensitive). models.dev also tries the last `/` segment of the catalog id as an exact id. No fuzzy matching. Unmatched models go to the next step.
 
 Never fail the sync because costs are incomplete. Model catalog remains the hard requirement.
 
@@ -126,8 +128,8 @@ Steps:
 3. Download tarball (reuse logic from `scripts/sync-models.ts --remote`).
 4. Extract models (required) then run the **cost waterfall**:
    - model catalog fail → status `broken`, stop (no commit, no publish).
-   - CLI costs fail or partial → continue; fill gaps from official docs, then optional trusted API, then hardcoded fallback.
-   - Record `costSources` on the manifest. `degraded` only if any model still used fallback/unmatched.
+   - CLI costs fail or partial → continue; fill gaps from official docs, then free SKUs ($0), then models.dev, then unmatched placeholder.
+   - Record `costSources` on the manifest. `degraded` only if any model is still unmatched.
 5. Sanity floor: `modelCount >= max(20, floor(lastSuccessfulModelCount * 0.5))`. `lastSuccessfulModelCount` is `modelCount` from the last committed manifest with `status` `healthy` or `degraded`. Fail as `broken` if below. If no prior manifest, use `20`.
 6. Write `models.json`, `_version.txt`, bump patch in `package.json`, write `manifest.json`.
 7. Run unit tests (including 1.38 costless fixture).
@@ -171,7 +173,7 @@ When a subsequent sync succeeds after manual fix:
 | Event | Version bump | Publish |
 |---|---|---|
 | New command-code catalog (healthy) | patch | yes |
-| New command-code catalog (degraded: some fallback costs) | patch | yes |
+| New command-code catalog (degraded: unmatched placeholder costs) | patch | yes |
 | Model extraction broken | none | no |
 | Plugin code fix (manual PR) | patch/minor per semver | yes (manual or on merge) |
 
@@ -255,15 +257,14 @@ Commit **extracted snapshots** (model JSON + expected counts/errors), not the pr
 | `NPM_TOKEN` | publish plugin package (`brainervirus`) |
 | `GITHUB_TOKEN` | commit, release, issues |
 | `CATALOG_PUSH_TOKEN` | optional; only if branch protection blocks `GITHUB_TOKEN` |
-| `COST_ENRICHMENT_API_URL` | optional; skip third-party cost step when unset |
 
 If `main` is protected against `GITHUB_TOKEN`, set `CATALOG_PUSH_TOKEN`. One push path only.
 
 ## Acceptance Criteria
 
 - User can run OpenCode with **no** global/local `command-code` install and get current models from the installed plugin (npm package, or a `file://` checkout that has been synced).
 - Within 6 hours of a new `command-code` npm release, CI either commits a catalog update (and publishes a plugin patch if `NPM_TOKEN` is set) or opens/updates a `catalog-break` issue.
-- Cost-only CLI regressions (like 1.38) still ship a catalog. Costs come from official docs when the CLI map fails; `degraded` only if docs/API also miss models.
+- Cost-only CLI regressions (like 1.38) still ship a catalog. Costs come from official docs, then free SKUs ($0), then models.dev; `degraded` only if models remain unmatched.
 - Successful sync never requires local `bun run sync` from the user.
 - Failed model extraction never publishes a misleading npm release.
 

manifest.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-08-28T19:09:12.385Z",
+  "generatedAt": "2026-08-28T19:50:57.386Z",
   "pluginVersion": "0.5.0",
   "commandCodeVersion": "1.38.1",
   "commandCodeTarball": "https://registry.npmjs.org/command-code/-/command-code-1.38.1.tgz",
@@ -13,10 +13,22 @@
   },
   "costSources": {
     "cli": 0,
-    "officialDocs": 53,
+    "officialDocs": 60,
     "thirdParty": 0,
-    "fallback": 7,
-    "unmatched": 5
+    "free": 5,
+    "fallback": 0,
+    "unmatched": 0
   },
-  "status": "degraded"
+  "review": {
+    "thirdParty": [],
+    "free": [
+      "inclusionai/ling-3.0-flash-free",
+      "minimax/minimax-m2.7-free",
+      "MiniMaxAI/MiniMax-M3-Free",
+      "minimax/minimax-m3-free",
+      "tencent/Hy3"
+    ],
+    "unmatched": []
+  },
+  "status": "healthy"
 }

models.json

@@ -793,8 +793,8 @@
     "reasoning": true,
     "tool_call": true,
     "cost": {
-      "input": 0.5,
-      "output": 2
+      "input": 0,
+      "output": 0
     },
     "limit": {
       "context": 256000,
@@ -872,8 +872,8 @@
     "reasoning": false,
     "tool_call": true,
     "cost": {
-      "input": 0.5,
-      "output": 2
+      "input": 0,
+      "output": 0
     },
     "limit": {
       "context": 197000,
@@ -903,8 +903,8 @@
     "reasoning": true,
     "tool_call": true,
     "cost": {
-      "input": 0.5,
-      "output": 2
+      "input": 0,
+      "output": 0
     },
     "limit": {
       "context": 1000000,
@@ -918,8 +918,8 @@
     "reasoning": true,
     "tool_call": true,
     "cost": {
-      "input": 0.5,
-      "output": 2
+      "input": 0,
+      "output": 0
     },
     "limit": {
       "context": 1000000,
@@ -1193,8 +1193,8 @@
     "reasoning": true,
     "tool_call": true,
     "cost": {
-      "input": 0.5,
-      "output": 2
+      "input": 0,
+      "output": 0
     },
     "limit": {
       "context": 262144,

plugin.ts

@@ -117,7 +117,7 @@ export default async function commandcodePlugin() {
             degraded = true
             degradedReason = manifest.status === "broken"
               ? "bundled catalog marked broken"
-              : "bundled catalog costs include fallback or unmatched models"
+              : "bundled catalog has models with no listed price"
           }
         } else {
           const cached = readCatalogCache()

scripts/catalog-release-notes.ts

@@ -1,18 +1,11 @@
 #!/usr/bin/env bun
 import { readFileSync } from "fs"
 import { join } from "path"
-import { FALLBACK_COSTS } from "../src/catalog.js"
 import { catalogReleaseNotesFromFiles } from "../src/catalog-release-notes.js"
 import type { CatalogManifest } from "../src/manifest.js"
 import type { PricedModel } from "../src/catalog-release-notes.js"
 
 const ROOT = join(import.meta.dir, "..")
 const manifest = JSON.parse(readFileSync(join(ROOT, "manifest.json"), "utf-8")) as CatalogManifest
 const models = JSON.parse(readFileSync(join(ROOT, "models.json"), "utf-8")) as PricedModel[]
-process.stdout.write(
-  catalogReleaseNotesFromFiles({
-    manifest,
-    models,
-    fallbackCosts: FALLBACK_COSTS,
-  }),
-)
+process.stdout.write(catalogReleaseNotesFromFiles({ manifest, models }))

scripts/sync-models.ts

@@ -4,7 +4,6 @@ import { homedir, tmpdir } from "os"
 import { execSync } from "child_process"
 import {
   NPM_PACKAGE,
-  FALLBACK_COSTS,
   extractCostData,
   buildCostMap,
   generateOpencodeModels,
@@ -13,6 +12,12 @@ import {
   type ModelEntry,
 } from "../src/catalog.js"
 import { applyDocCosts, fetchOfficialModelsMarkdown, parseModelsTable } from "../src/costs-docs.js"
+import {
+  applyFreeCosts,
+  applyModelsDevCosts,
+  fetchModelsDevJson,
+  parseModelsDev,
+} from "../src/costs-models-dev.js"
 import {
   buildManifest,
   commandCodeTarballUrl,
@@ -171,20 +176,39 @@ async function main() {
     const filled = applyDocCosts(entries, parseModelsTable(docsMd), cliIds, docIds)
     console.log(`  Applied official-docs costs to ${filled} models (${cliIds.size} kept CLI costs)`)
   } else {
-    console.log("  Official docs returned no parseable cost table; keeping CLI/fallback costs")
+    console.log("  Official docs returned no parseable cost table; keeping CLI costs")
+  }
+
+  const priced = new Set([...cliIds, ...docIds])
+  const freeIds = new Set<string>()
+  const freeFilled = applyFreeCosts(entries, priced, freeIds)
+  console.log(`  Applied free SKU $0 to ${freeFilled} models`)
+
+  const thirdPartyIds = new Set<string>()
+  const skipAfterFree = new Set([...priced, ...freeIds])
+  try {
+    const modelsDevJson = await fetchModelsDevJson()
+    const filled = applyModelsDevCosts(entries, parseModelsDev(modelsDevJson), skipAfterFree, thirdPartyIds)
+    console.log(`  Applied models.dev costs to ${filled} models`)
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err)
+    console.log(`  models.dev fill skipped: ${message}`)
   }
 
   console.log(`\nWriting ${MODELS_JSON} with ${entries.length} models from ${sourceLabel}...`)
   writeFileSync(MODELS_JSON, JSON.stringify(entries, null, 2) + "\n", "utf-8")
   writeFileSync(VERSION_PATH, `${version}\n`, "utf-8")
 
   const pluginVersion = (JSON.parse(readFileSync(PACKAGE_JSON, "utf-8")) as { version: string }).version
+  const unmatchedIds = entries
+    .filter((e) => !cliIds.has(e.id) && !docIds.has(e.id) && !freeIds.has(e.id) && !thirdPartyIds.has(e.id))
+    .map((e) => e.id)
   const costSources = countCostSources({
     modelIds: entries.map((e) => e.id),
     cliIds,
     officialDocIds: docIds,
-    thirdPartyIds: new Set(),
-    fallbackIds: new Set(Object.keys(FALLBACK_COSTS)),
+    thirdPartyIds,
+    freeIds,
   })
   writeManifest(
     MANIFEST_PATH,
@@ -196,6 +220,11 @@ async function main() {
       reasoningModelCount: entries.filter((e) => e.reasoning).length,
       modelCatalogOk: true,
       costSources,
+      review: {
+        thirdParty: [...thirdPartyIds],
+        free: [...freeIds],
+        unmatched: unmatchedIds,
+      },
       generatedAt: new Date().toISOString(),
     }),
   )