v0.9.0 remaining: model catalog consolidation and live refresh

[Hmbown]

Purpose

Durable GitHub issue for the remaining Section 1 work from the 0.8.68 cutover checklist. This makes the model catalog plan available from GitHub instead of only from Hunter's local scratch document.

Already verified in PR #4099 / work/v0.9.0-cutover

• OpenRouter /models parser preserves live response order and maps limits, pricing, reasoning support, and modalities into CatalogOffering.
• refresh_catalog_cache publishes fresh cache snapshots into provider_lake.
• Provider picker search matches provider name and model ids across configured/catalog views.

Reference branch/head at issue creation: work/v0.9.0-cutover @ fb89fc0c6.

Remaining checklist

• Catalog refresh policy

  • Manual command: /model refresh openrouter or /provider refresh openrouter.
  • Background refresh only after provider is configured or active.
  • TTL: 24h for OpenRouter live rows; stale rows stay visible with a stale chip.
  • Failure behavior: never break model selection; keep bundled and prior cached rows.
  • Backoff: 401/403 show auth issue; 429/5xx keep stale and retry later.
  • Persist secret-free cache under CodeWhale state dir, scoped by provider and base-url fingerprint.
  • Never persist API keys, auth headers, or raw error bodies.

• Model picker UX views

  • Add view toggle for Configured, Catalog, Recent, Coding, Cheap, Long context.
  • Row metadata should show name, wire id, provider route, context, max output, tool support, reasoning, price/M tokens, freshness, and deprecation warning from expiration_date.
  • Keep defaults conservative; newest/discovery views should not auto-select surprising routes.

• Replace legacy model sources

  • Replace remaining model_completion_names_for_provider() consumers with catalog-backed ConfiguredProviderLake where appropriate.
  • Likely surfaces: tui/model_picker.rs, tui/hotbar/actions.rs, tui/model_inventory.rs, tools/subagent/mod.rs, tui/widgets/mod.rs.

• Catalog update automation

  • Add a script or crate such as codewhale-catalog for refresh/snapshot flows.
  • Expected commands:

    cargo run -p codewhale-catalog -- refresh --provider openrouter --sort newest --limit 100 --write-cache
    cargo run -p codewhale-catalog -- snapshot --write crates/config/assets/models_dev.bundled.json
    cargo test -p codewhale-config catalog route
    cargo test -p codewhale-tui model_picker model_inventory pricing models

Acceptance

• Pickers, hotbar, model inventory, subagent validation, pricing, context windows, and route resolution read one compiled/catalog-backed source of truth.
• Live refresh improves available metadata without making selection brittle when network/auth fails.
• A clean clone from GitHub has this issue as the durable checklist for the remaining catalog work.

[Hmbown]

Checklist atomics now represented for Section 1 / Section 3:

• v0.9.0 1.2: catalog refresh policy for live model metadata #4114 — 1.2 catalog refresh policy
• v0.9.0 1.3: add model picker catalog views and metadata rows #4115 — 1.3 model picker catalog views
• v0.9.0 1.4: migrate legacy model source consumers to ProviderLake #4116 — 1.4 migrate legacy model source consumers to ProviderLake
• v0.9.0 1.5: add catalog refresh and bundled snapshot automation #4117 — 1.5 catalog refresh and bundled snapshot automation
• v0.9.0 3.1: wire live catalog cache into provider and model pickers #4139 — 3.1 live catalog cache picker wiring
• v0.9.0 3.2: show configured providers and models by default #4140 — 3.2 configured providers/models by default
• v0.9.0 3.3: add cross-field search to both provider and model pickers #4141 — 3.3 cross-field search in provider/model pickers

Completed by PR #4099 / main already: 1.1 OpenRouter live API integration.

[Hmbown]

Models.dev live catalog sub-chain

Added five issues that extend this catalog consolidation tracker:

#4184 → #4185 → #4186 → #4187 → #4188

1. Use Models.dev as the source of truth for provider and model metadata #4184 — Models.dev as metadata source of truth
2. Accept current live Models.dev schema in the catalog parser #4185 — Live schema acceptance in catalog parser
3. Normalize Models.dev provider IDs onto CodeWhale provider kinds #4186 — Provider ID normalization onto CodeWhale kinds
4. Fetch and cache live Models.dev catalog into ProviderLake #4187 — Live fetch/cache into ProviderLake
5. Demote curated bundled model data after Models.dev live catalog lands #4188 — Demote bundled snapshot after live catalog

Cross-links: #4114–#4119, #4139–#4141, architecture #4175, playbook docs/AGENT_WORKFLOWS_0868.md.

[Hmbown]

Lane hygiene: all catalog issues now carry lane-catalog and the leaf issues are agent-ready (this lane is file-disjoint from stopship and can run now). Canonical execution order and dependencies: #4092. Order: #4185 → #4187 → #4186 → #4188 (Models.dev foundation), then pickers #4139 → #4140 → #4141 → #4115 → #3995, then #4116 → #4114 → #4117. Close this umbrella last.

---

Generated by Claude Code