job-forge 2.12.0 → 2.13.0

package/.claude/agents/general-paid.md

@@ -1,11 +1,16 @@
 ---
 name: general-paid
-description: Quality-sensitive worker on paid model. Use for offer evaluation narratives (Blocks A-F), cover letter generation, "Why X?" form answers, interview STAR stories, and other tasks where writing quality and judgment matter.
+description: Quality-sensitive worker on the strongest free-tier OpenCode model by default. Use for offer evaluation narratives (Blocks A-F), cover letter generation, "Why X?" form answers, interview STAR stories, and other tasks where writing quality and judgment matter.
 model: claude-opus-4-7
 ---
 
 You are the @general-paid subagent. The orchestrator delegated this task to you because it requires quality writing or judgment — the kind of work `@general-free` isn't well-suited for.
 
+On OpenCode, this agent now defaults to a free OpenRouter model. On other
+harnesses, the same role may still resolve to a premium model. Your job is
+still the same: produce the best final writing you can from the context you
+were given.
+
 ## Do These Tasks
 
 - Generate evaluation narratives (Blocks A-F) per `modes/offer.md`.

package/.codex/config.toml

@@ -1,6 +1,6 @@
 # generated by @razroo/iso-route — do not hand-edit
-model = "claude-sonnet-4-6"
-model_provider = "anthropic"
+model = "gpt-5.4"
+model_provider = "openai"
 
 [profiles.fast]
 model = "gpt-5.4-mini"
@@ -15,11 +15,6 @@ model_reasoning_effort = "high"
 model = "gpt-5.4-nano"
 model_provider = "openai"
 
-[model_providers.anthropic]
-name = "Anthropic"
-base_url = "https://api.anthropic.com/v1"
-env_key = "ANTHROPIC_API_KEY"
-
 [model_providers.openai]
 name = "OpenAI"
 base_url = "https://api.openai.com/v1"

package/.cursor/rules/agent-general-paid.mdc

@@ -1,10 +1,15 @@
 ---
-description: Quality-sensitive worker on paid model. Use for offer evaluation narratives (Blocks A-F), cover letter generation, "Why X?" form answers, interview STAR stories, and other tasks where writing quality and judgment matter.
+description: Quality-sensitive worker on the strongest free-tier OpenCode model by default. Use for offer evaluation narratives (Blocks A-F), cover letter generation, "Why X?" form answers, interview STAR stories, and other tasks where writing quality and judgment matter.
 alwaysApply: false
 ---
 
 You are the @general-paid subagent. The orchestrator delegated this task to you because it requires quality writing or judgment — the kind of work `@general-free` isn't well-suited for.
 
+On OpenCode, this agent now defaults to a free OpenRouter model. On other
+harnesses, the same role may still resolve to a premium model. Your job is
+still the same: produce the best final writing you can from the context you
+were given.
+
 ## Do These Tasks
 
 - Generate evaluation narratives (Blocks A-F) per `modes/offer.md`.

package/.opencode/agents/general-free.md

@@ -1,7 +1,7 @@
 ---
 description: Procedural worker on free-tier model. Use for form filling via Geometra, tracker updates, TSV merges, scan dedup, OTP retrieval, and other mechanical/scripted tasks where quality-sensitive text generation is NOT required.
 mode: subagent
-model: opencode/big-pickle
+model: openrouter/minimax/minimax-m2.5:free
 tools:
   geometra_connect: true
   geometra_page_model: true
@@ -16,6 +16,10 @@ tools:
   gmail_get_message: true
 temperature: 0.1
 reasoningEffort: minimal
+fallback_models:
+  - openrouter/qwen/qwen3-coder:free
+  - openrouter/google/gemma-4-26b-a4b-it:free
+  - openrouter/openai/gpt-oss-20b:free
 ---
 
 You are the @general-free subagent. You run on a free-tier model, which means the orchestrator has delegated this task to you **specifically because the work is procedural**: deterministic steps, scripted outputs, no nuanced writing required.

package/.opencode/agents/general-paid.md

@@ -1,16 +1,25 @@
 ---
-description: Quality-sensitive worker on paid model. Use for offer evaluation narratives (Blocks A-F), cover letter generation, "Why X?" form answers, interview STAR stories, and other tasks where writing quality and judgment matter.
+description: Quality-sensitive worker on the strongest free-tier OpenCode model by default. Use for offer evaluation narratives (Blocks A-F), cover letter generation, "Why X?" form answers, interview STAR stories, and other tasks where writing quality and judgment matter.
 mode: subagent
-model: opencode-go/kimi-k2.5
+model: openrouter/qwen/qwen3-next-80b-a3b-instruct:free
 tools:
   geometra_*: false
   gmail_*: false
 temperature: 0.3
 reasoningEffort: medium
+fallback_models:
+  - openrouter/qwen/qwen3-coder:free
+  - openrouter/openai/gpt-oss-120b:free
+  - openrouter/z-ai/glm-4.5-air:free
 ---
 
 You are the @general-paid subagent. The orchestrator delegated this task to you because it requires quality writing or judgment — the kind of work `@general-free` isn't well-suited for.
 
+On OpenCode, this agent now defaults to a free OpenRouter model. On other
+harnesses, the same role may still resolve to a premium model. Your job is
+still the same: produce the best final writing you can from the context you
+were given.
+
 ## Do These Tasks
 
 - Generate evaluation narratives (Blocks A-F) per `modes/offer.md`.

package/.opencode/agents/glm-minimal.md

@@ -1,7 +1,7 @@
 ---
 description: Narrow-scope extractor on free-tier model. Use for single-purpose tasks where the orchestrator passes the exact input and expects a small, structured output — e.g., "extract these 8 fields from this JD text" or "parse this form schema into a label→type map". NOT for multi-step workflows.
 mode: subagent
-model: opencode/minimax-m2.5-free
+model: openrouter/google/gemma-4-26b-a4b-it:free
 tools:
   geometra_*: false
   gmail_*: false
@@ -13,6 +13,10 @@ tools:
   task: false
 temperature: 0
 reasoningEffort: none
+fallback_models:
+  - openrouter/minimax/minimax-m2.5:free
+  - openrouter/openai/gpt-oss-20b:free
+  - openrouter/google/gemma-4-31b-it:free
 ---
 
 You are the @glm-minimal subagent. You handle narrow, one-shot extractions where the orchestrator has pre-digested the context and just needs you to do a specific transform.

package/.opencode/opencode-model-fallback.json

@@ -0,0 +1,11 @@
+{
+  "cooldown_seconds": 60,
+  "timeout_seconds": 30,
+  "notify_on_fallback": true,
+  "fallback_models": [
+    "openrouter/qwen/qwen3-next-80b-a3b-instruct:free",
+    "openrouter/openai/gpt-oss-120b:free",
+    "openrouter/google/gemma-4-26b-a4b-it:free",
+    "openrouter/z-ai/glm-4.5-air:free"
+  ]
+}

package/README.md

@@ -68,8 +68,8 @@ JobForge turns opencode into a full job search command center. Instead of manual
 | **Portal Scanner** | 45+ companies pre-configured with fuzzy dedup for reposts |
 | **Batch Processing** | Parallel evaluation with `opencode run` workers, with honest verification flagging |
 | **Pipeline Integrity** | Automated merge, dedup, status normalization, health checks |
-| **Cost-Aware Agent Routing** | Three subagents (`@general-free`, `@general-paid`, `@glm-minimal`) with per-task model tiers; procedural work runs on free-tier models, quality-sensitive work on paid. See [Subagent Routing in AGENTS.md](AGENTS.md) for the task-to-agent mapping. |
-| **Automatic Model Fallback** | When a model rate-limits or 5xx's, [`@razroo/opencode-model-fallback`](https://www.npmjs.com/package/@razroo/opencode-model-fallback) rotates the agent through a configured `fallback_models` chain and replays the request. Ships with sensible defaults: free-tier agents fall back to another free model then to paid as an escape hatch, paid agents fall back to a different paid provider. |
+| **Cost-Aware Agent Routing** | Three subagents (`@general-free`, `@general-paid`, `@glm-minimal`) with per-task model tiers. On OpenCode, all three default to free OpenRouter models so the harness can run there without paid model spend. See [Subagent Routing in AGENTS.md](AGENTS.md) for the task-to-agent mapping. |
+| **Automatic Model Fallback** | When a model rate-limits or 5xx's, [`@razroo/opencode-model-fallback`](https://www.npmjs.com/package/@razroo/opencode-model-fallback) rotates the agent through a configured `fallback_models` chain and replays the request. JobForge's OpenCode defaults stay on free models for both primaries and fallbacks. |
 | **Token Cost Visibility** | `job-forge tokens --days 1` for per-session breakdown; `job-forge session-report --since-minutes 60 --log` to flag sessions over budget and append history to `data/token-usage.tsv`. Auto-logged after every batch run. |
 
 ## Usage

package/bin/create-job-forge.mjs

@@ -135,6 +135,11 @@ write('package.json', JSON.stringify(consumerPkg, null, 2) + '\n');
 
 const opencodeCfg = {
   $schema: 'https://opencode.ai/config.json',
+  // Keep the top-level orchestrator on a free model too. Subagents pin
+  // their own models in .opencode/agents/*.md; this covers the main chat
+  // session and any commands that don't hop to a subagent immediately.
+  model: 'openrouter/qwen/qwen3-coder:free',
+  small_model: 'openrouter/google/gemma-4-26b-a4b-it:free',
   // Model-fallback plugin: on rate-limit / 5xx / known provider errors,
   // rotates the agent's model to the next entry in its fallback_models
   // chain (see `agent` below) and replays the request. Without this, a
@@ -170,6 +175,22 @@ const opencodeCfg = {
       environment: { DISABLE_HTTP: 'true' },
     },
   },
+  // Register the exact OpenRouter free models the harness uses so they're
+  // selectable even if they are not in OpenCode's built-in preloaded set.
+  provider: {
+    openrouter: {
+      models: {
+        'qwen/qwen3-coder:free': {},
+        'minimax/minimax-m2.5:free': {},
+        'qwen/qwen3-next-80b-a3b-instruct:free': {},
+        'google/gemma-4-26b-a4b-it:free': {},
+        'google/gemma-4-31b-it:free': {},
+        'openai/gpt-oss-120b:free': {},
+        'openai/gpt-oss-20b:free': {},
+        'z-ai/glm-4.5-air:free': {},
+      },
+    },
+  },
   // Restrict the primary orchestrator to dispatching only the three harness
   // subagents. Prevents accidental self-calls or unregistered agents.
   // Override locally in opencode.json if you add project-specific agents.

package/bin/sync.mjs

@@ -75,6 +75,7 @@ const links = [
 
   // OpenCode: skill router + subagent definitions. Users can override any
   // single subagent by replacing its symlink with a local file.
+  { src: '.opencode/opencode-model-fallback.json', dst: '.opencode/opencode-model-fallback.json' },
   { src: '.opencode/skills/job-forge.md',  dst: '.opencode/skills/job-forge.md' },
   { src: '.opencode/agents',               dst: '.opencode/agents' },
 

package/docs/ARCHITECTURE.md

@@ -43,7 +43,7 @@ The consumer's `opencode.json` loads a small set of stable files as always-prese
 
 The skill router (`.opencode/skills/job-forge.md`) loads mode and data files on demand, keeping per-session input tokens low (~20-40K for most modes instead of ~130-170K when everything was force-loaded).
 
-**Cost-tiered subagents** live in `.opencode/agents/` (`general-free`, `general-paid`, `glm-minimal`) — the orchestrator delegates procedural work to free-tier models and reserves paid models for quality-sensitive writing. See [MODEL-ROUTING.md](MODEL-ROUTING.md) for the routing architecture, why it exists, and how to customize.
+**Cost-tiered subagents** live in `.opencode/agents/` (`general-free`, `general-paid`, `glm-minimal`). On OpenCode, all three now resolve to free OpenRouter models by default, with different quality/latency tiers per task shape. See [MODEL-ROUTING.md](MODEL-ROUTING.md) for the routing architecture, why it exists, and how to customize.
 
 **Multi-harness support.** Because `iso/` is the single source of truth, publishing ships config for OpenCode, Cursor, Claude Code, and Codex in one tarball. Consumers run any of `opencode`, `cursor`, `claude`, or `codex` in the project and each picks up the shared MCP config + instructions via the symlinks above.
 

package/docs/MODEL-ROUTING.md

@@ -7,8 +7,8 @@ JobForge routes each piece of work to the cheapest model that can do it well, in
 A two-day trace early in development showed `$48` in spend, with **84% coming from GLM 5.1** despite the majority of the work being procedural (form fills, tracker updates, OTP retrieval). The root cause:
 
 - **GLM 5.1's provider doesn't discount cache reads.** On Anthropic, a 10K-token cached prefix costs ~$0.03. On GLM 5.1 it bills near-full input rate (~$0.35). Every session that re-loads the prefix pays full price.
-- **Procedural work is the high-volume work.** 1000+ messages per day go to form filling, TSV merges, scan dedup. Running that on GLM 5.1 is ~10× more expensive than running it on a free-tier model that can handle the task just fine.
-- **Free-tier opencode models are genuinely free and genuinely capable.** `opencode/big-pickle` processed 1000+ messages at $0 over the same window with acceptable quality on procedural tasks.
+- **Procedural work is the high-volume work.** 1000+ messages per day go to form filling, TSV merges, scan dedup. Running that on a paid model is unnecessary when current free OpenRouter models can handle the task.
+- **Current OpenRouter free models are strong enough to cover the whole OpenCode path.** JobForge now defaults every OpenCode role to a free model, including the quality-sensitive writer tier.
 
 Conclusion: route procedural work to free tier, reserve paid models for tasks that actually need the quality.
 
@@ -18,9 +18,9 @@ Defined in `.opencode/agents/*.md` (shipped in the harness, symlinked into consu
 
 | Agent | Model | Reasoning | Use for |
 |-------|-------|-----------|---------|
-| `@general-free` | `opencode/big-pickle` (free) | `minimal` | Geometra form fills, tracker TSV merges, scan dedup, OTP retrieval via Gmail, scripted pipeline steps |
-| `@general-paid` | `opencode/glm-5.1` | `medium` | Offer evaluation narratives (Blocks A-F), cover letters, "Why X?" answers, STAR+R interview stories, LinkedIn outreach prose |
-| `@glm-minimal` | `opencode/minimax-m2.5-free` (free) | `none` | Narrow one-shot transforms: "extract these 8 fields from this JD text → JSON", "classify this archetype" |
+| `@general-free` | `openrouter/minimax/minimax-m2.5:free` | `minimal` | Geometra form fills, tracker TSV merges, scan dedup, OTP retrieval via Gmail, scripted pipeline steps |
+| `@general-paid` | `openrouter/qwen/qwen3-next-80b-a3b-instruct:free` | `medium` | Offer evaluation narratives (Blocks A-F), cover letters, "Why X?" answers, STAR+R interview stories, LinkedIn outreach prose |
+| `@glm-minimal` | `openrouter/google/gemma-4-26b-a4b-it:free` | `none` | Narrow one-shot transforms: "extract these 8 fields from this JD text → JSON", "classify this archetype" |
 
 The full task-to-agent mapping lives in [AGENTS.md → Subagent Routing](../AGENTS.md#subagent-routing--which-agent-for-which-task). The orchestrator (your primary session) is expected to delegate before taking any multi-step action — see the **Pre-flight delegation** rule in AGENTS.md.
 
@@ -66,7 +66,7 @@ All three layers are designed to be edited — this is your search, your cost bu
 
 ### Swap the paid model
 
-The default `@general-paid` is `opencode/glm-5.1`. To use Claude instead, edit `.opencode/agents/general-paid.md`:
+The default `@general-paid` is `openrouter/qwen/qwen3-next-80b-a3b-instruct:free`. To use Claude instead, edit `.opencode/agents/general-paid.md`:
 
 ```yaml
 ---
@@ -79,7 +79,7 @@ The `.opencode/agents/general-paid.md` file is a symlink into `node_modules/job-
 
 ### Swap the free tier
 
-Same idea — edit `.opencode/agents/general-free.md`'s `model:` field. `opencode/minimax-m2.5-free` is another zero-cost option the data shows handles ~900 messages per day cleanly. If you run into quality issues on forms, bump this agent's model to a small paid tier (e.g., Haiku) rather than routing everything through paid.
+Same idea — edit `.opencode/agents/general-free.md`'s `model:` field. If you run into quality issues on forms, swap to a different free OpenRouter model first before considering a paid tier.
 
 ### Add a custom agent
 
@@ -122,8 +122,8 @@ npx job-forge tokens --session <session-id>
 ```
 
 Healthy pattern after this architecture lands:
-- **`opencode/big-pickle`** (or your free-tier choice) handles the message majority at $0
-- **`opencode/glm-5.1`** (or your paid choice) costs per session stay under $1 for most evaluations
+- **Free OpenRouter defaults** now cover procedural, quality-sensitive, and extractor work on OpenCode
+- If you opt back into a paid model, do it deliberately and only for the role that needs it
 - Session titles prefixed `@general-free`, `@general-paid`, `@glm-minimal` appear in the list — confirms delegation actually happened
 - `cache_read` >> `cache_creation` on parallel subagent runs within a 5-min window
 
@@ -139,13 +139,13 @@ Default chains ship upstream in each agent's YAML frontmatter (`node_modules/job
 
 | Agent | Primary | Fallback chain (in order) |
 |-------|---------|---------------------------|
-| `@general-free` | `opencode/big-pickle` | `opencode/minimax-m2.5-free` → `opencode/nemotron-3-super-free` → `opencode-go/minimax-m2.7` → `opencode/glm-5.1` (paid escape hatch) |
-| `@general-paid` | `opencode/glm-5.1` | `opencode/claude-haiku-4-5` |
-| `@glm-minimal` | `opencode/minimax-m2.5-free` | `opencode/big-pickle` → `opencode/nemotron-3-super-free` |
+| `@general-free` | `openrouter/minimax/minimax-m2.5:free` | `openrouter/qwen/qwen3-coder:free` → `openrouter/google/gemma-4-26b-a4b-it:free` → `openrouter/openai/gpt-oss-20b:free` |
+| `@general-paid` | `openrouter/qwen/qwen3-next-80b-a3b-instruct:free` | `openrouter/qwen/qwen3-coder:free` → `openrouter/openai/gpt-oss-120b:free` → `openrouter/z-ai/glm-4.5-air:free` |
+| `@glm-minimal` | `openrouter/google/gemma-4-26b-a4b-it:free` | `openrouter/minimax/minimax-m2.5:free` → `openrouter/openai/gpt-oss-20b:free` → `openrouter/google/gemma-4-31b-it:free` |
 
-Free-tier agents exhaust free models first, then try minimax 2.7 as a cheap buffer before escalating to glm-5.1. Paid agents fall back to Haiku (cheaper unstick escape hatch). **Note:** all model IDs use the `opencode/` or `opencode-go/` prefix — the `anthropic/` prefix does not exist in opencode's model registry and will throw `ProviderModelNotFoundError`.
+These chains are deliberately free-only so the default OpenCode path never needs to pay. **Note:** OpenCode model IDs must use the provider prefix it expects (`openrouter/...`, `opencode/...`, etc.). The raw OpenRouter model slug by itself is not enough.
 
-Consumers **do not need to configure anything** to get these defaults: the chains arrive via the symlinked agent MD files, and `@razroo/opencode-model-fallback` (≥0.3.1) reads them from the `options.fallback_models` field that opencode relocates unknown frontmatter keys into. The consumer's `opencode.json` only needs `"plugin": ["@razroo/opencode-model-fallback"]` — which the scaffolder sets automatically.
+Consumers **do not need to configure anything** to get these defaults: the subagent chains arrive via the symlinked agent MD files, and the harness also ships `.opencode/opencode-model-fallback.json` for the main orchestrator / any agent without its own list. `@razroo/opencode-model-fallback` (≥0.3.1) reads per-agent chains from the frontmatter-derived `fallback_models` field and falls through to the global file when no per-agent list exists. The consumer's `opencode.json` only needs `"plugin": ["@razroo/opencode-model-fallback"]` — which the scaffolder sets automatically.
 
 **When fallback fires:** the plugin pattern-matches rate-limit / 5xx / quota / "overloaded" / "insufficient credits" errors. Failed models enter a 60-second cooldown before they're retried. Every rotation logs to `~/.config/opencode/opencode-model-fallback.log` with the trigger error, original model, and target model — grep for `"Auto-retrying with fallback model"` to confirm it fired.
 
@@ -172,7 +172,7 @@ Plugin-level config at `.opencode/opencode-model-fallback.json` — applies to a
   "cooldown_seconds": 60,
   "timeout_seconds": 30,
   "notify_on_fallback": true,
-  "fallback_models": ["opencode/minimax-m2.5-free", "opencode/glm-5.1"]
+  "fallback_models": ["openrouter/minimax/minimax-m2.5:free", "openrouter/qwen/qwen3-coder:free"]
 }
 ```
 

package/iso/agents/general-free.md

@@ -10,6 +10,10 @@ targets:
     mode: subagent
     temperature: 0.1
     reasoningEffort: minimal
+    fallback_models:
+      - openrouter/qwen/qwen3-coder:free
+      - openrouter/google/gemma-4-26b-a4b-it:free
+      - openrouter/openai/gpt-oss-20b:free
     tools:
       geometra_connect: true
       geometra_page_model: true

package/iso/agents/general-paid.md

@@ -1,15 +1,20 @@
 ---
-description: Quality-sensitive worker on paid model. Use for offer evaluation narratives (Blocks A-F), cover letter generation, "Why X?" form answers, interview STAR stories, and other tasks where writing quality and judgment matter.
+description: Quality-sensitive worker on the strongest free-tier OpenCode model by default. Use for offer evaluation narratives (Blocks A-F), cover letter generation, "Why X?" form answers, interview STAR stories, and other tasks where writing quality and judgment matter.
 role: quality
 targets:
-  # No inline model: iso-route's "standard" preset maps role "quality" to
-  # each harness's top-tier reasoning-capable model. Claude Code reads
+  # No inline model: JobForge's models.yaml maps role "quality" to a
+  # free OpenRouter model on OpenCode, while Claude/Codex keep their
+  # quality-tier defaults from the standard preset. Claude Code reads
   # .claude/iso-route.resolved.json; OpenCode reads opencode.json's
   # agent.quality.model (iso-harness 0.6.0+).
   opencode:
     mode: subagent
     temperature: 0.3
     reasoningEffort: medium
+    fallback_models:
+      - openrouter/qwen/qwen3-coder:free
+      - openrouter/openai/gpt-oss-120b:free
+      - openrouter/z-ai/glm-4.5-air:free
     tools:
       geometra_*: false
       gmail_*: false
@@ -17,6 +22,11 @@ targets:
 
 You are the @general-paid subagent. The orchestrator delegated this task to you because it requires quality writing or judgment — the kind of work `@general-free` isn't well-suited for.
 
+On OpenCode, this agent now defaults to a free OpenRouter model. On other
+harnesses, the same role may still resolve to a premium model. Your job is
+still the same: produce the best final writing you can from the context you
+were given.
+
 ## Do These Tasks
 
 - Generate evaluation narratives (Blocks A-F) per `modes/offer.md`.

package/iso/agents/glm-minimal.md

@@ -10,6 +10,10 @@ targets:
     mode: subagent
     temperature: 0
     reasoningEffort: none
+    fallback_models:
+      - openrouter/minimax/minimax-m2.5:free
+      - openrouter/openai/gpt-oss-20b:free
+      - openrouter/google/gemma-4-31b-it:free
     tools:
       geometra_*: false
       gmail_*: false

package/iso/config.json

@@ -1,7 +1,23 @@
 {
   "targets": {
     "opencode": {
-      "instructions": ["templates/states.yml"]
+      "plugin": ["@razroo/opencode-model-fallback"],
+      "instructions": ["templates/states.yml"],
+      "small_model": "openrouter/google/gemma-4-26b-a4b-it:free",
+      "provider": {
+        "openrouter": {
+          "models": {
+            "qwen/qwen3-coder:free": {},
+            "minimax/minimax-m2.5:free": {},
+            "qwen/qwen3-next-80b-a3b-instruct:free": {},
+            "google/gemma-4-26b-a4b-it:free": {},
+            "google/gemma-4-31b-it:free": {},
+            "openai/gpt-oss-120b:free": {},
+            "openai/gpt-oss-20b:free": {},
+            "z-ai/glm-4.5-air:free": {}
+          }
+        }
+      }
     }
   }
 }

package/models.yaml

@@ -1,15 +1,17 @@
 # JobForge model policy.
 #
-# Extends @razroo/iso-route's bundled "standard" preset — a curated
-# cost-tiered routing config verified against 2026-04 provider catalogs.
-# Preset content lives in node_modules/@razroo/iso-route/presets/standard.yaml;
-# run `npx iso-route plan models.yaml` to see the resolved policy.
+# Extends @razroo/iso-route's bundled "openrouter-free" preset — a
+# curated zero-cost routing config that keeps Claude Code / Codex on
+# their native providers but routes OpenCode through explicit free
+# OpenRouter model IDs. Preset content lives in
+# node_modules/@razroo/iso-route/presets/openrouter-free.yaml; run
+# `npx iso-route plan models.yaml` to see the resolved policy.
 #
 # JobForge's subagents bind to preset roles via the `role:` field in
 # iso/agents/<slug>.md:
-#   @general-free  → role: fast     (Haiku / opencode/big-pickle / gpt-5.4-mini)
-#   @general-paid  → role: quality  (Opus 4.7 / opencode-go/kimi-k2.5 / gpt-5.4)
-#   @glm-minimal   → role: minimal  (Haiku / opencode/minimax-m2.5-free / gpt-5.4-nano)
+#   @general-free  → role: fast     (Haiku / OpenRouter MiniMax M2.5 free / gpt-5.4-mini)
+#   @general-paid  → role: quality  (Opus 4.7 / OpenRouter Qwen3 Next 80B free / gpt-5.4)
+#   @glm-minimal   → role: minimal  (Haiku / OpenRouter Gemma 4 26B free / gpt-5.4-nano)
 #
 # Override anything by adding fields here. For example, to pin Opus on
 # Claude Code for the @general-paid (quality) role:
@@ -27,4 +29,14 @@
 #           provider: openai
 #           model: gpt-5.4
 
-extends: standard
+extends: openrouter-free
+
+# Only override the preset where we prefer a different OpenRouter pick.
+# The preset's quality-tier OpenCode pick is openai/gpt-oss-120b:free;
+# we prefer Qwen3 Next 80B for job-application writing quality.
+roles:
+  quality:
+    targets:
+      opencode:
+        provider: openrouter
+        model: qwen/qwen3-next-80b-a3b-instruct:free

package/opencode.json

@@ -1,15 +1,29 @@
 {
   "$schema": "https://opencode.ai/config.json",
-  "model": "opencode/glm-5.1",
+  "model": "openrouter/qwen/qwen3-coder:free",
   "agent": {
     "fast": {
-      "model": "opencode/big-pickle"
+      "model": "openrouter/minimax/minimax-m2.5:free"
     },
     "quality": {
-      "model": "opencode-go/kimi-k2.5"
+      "model": "openrouter/qwen/qwen3-next-80b-a3b-instruct:free"
     },
     "minimal": {
-      "model": "opencode/minimax-m2.5-free"
+      "model": "openrouter/google/gemma-4-26b-a4b-it:free"
+    }
+  },
+  "provider": {
+    "openrouter": {
+      "models": {
+        "qwen/qwen3-coder:free": {},
+        "minimax/minimax-m2.5:free": {},
+        "qwen/qwen3-next-80b-a3b-instruct:free": {},
+        "google/gemma-4-26b-a4b-it:free": {},
+        "google/gemma-4-31b-it:free": {},
+        "openai/gpt-oss-120b:free": {},
+        "openai/gpt-oss-20b:free": {},
+        "z-ai/glm-4.5-air:free": {}
+      }
     }
   },
   "mcp": {
@@ -34,7 +48,11 @@
       }
     }
   },
+  "plugin": [
+    "@razroo/opencode-model-fallback"
+  ],
   "instructions": [
     "templates/states.yml"
-  ]
+  ],
+  "small_model": "openrouter/google/gemma-4-26b-a4b-it:free"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "job-forge",
-  "version": "2.12.0",
+  "version": "2.13.0",
   "description": "AI-powered job search pipeline built on opencode",
   "type": "module",
   "bin": {
@@ -87,9 +87,10 @@
     "playwright": "^1.58.1"
   },
   "devDependencies": {
-    "@razroo/iso": "^0.2.4",
+    "@razroo/iso": "^0.2.5",
     "@razroo/iso-harness": "^0.6.0",
-    "@razroo/iso-route": "^0.3.0",
-    "@razroo/iso-trace": "^0.1.0"
+    "@razroo/iso-route": "^0.5.0",
+    "@razroo/iso-trace": "^0.1.0",
+    "@razroo/opencode-model-fallback": "^0.3.1"
   }
 }