job-forge 2.14.2 → 2.14.3

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: openrouter/z-ai/glm-4.5-air:free
+model: opencode/big-pickle
 tools:
   geometra_connect: true
   geometra_page_model: true
@@ -17,7 +17,7 @@ tools:
 temperature: 0.1
 reasoningEffort: minimal
 fallback_models:
-  - openrouter/minimax/minimax-m2.5:free
+  - openrouter/z-ai/glm-4.5-air:free
   - openrouter/openai/gpt-oss-20b:free
   - openrouter/nvidia/nemotron-3-nano-30b-a3b:free
   - openrouter/qwen/qwen3-coder:free

package/README.md

@@ -68,7 +68,7 @@ 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. 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. |
+| **Cost-Aware Agent Routing** | Three subagents (`@general-free`, `@general-paid`, `@glm-minimal`) with per-task model tiers. On OpenCode, JobForge mixes native free models with free OpenRouter routes so the harness stays no-cost without forcing every task through the same provider. 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. |
 

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`). 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.
+**Cost-tiered subagents** live in `.opencode/agents/` (`general-free`, `general-paid`, `glm-minimal`). On OpenCode, JobForge now uses a mix of native free models and free OpenRouter routes, 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 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.
+- **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 models can handle the task.
+- **OpenCode no longer needs one provider for every role.** JobForge now pins the procedural `@general-free` worker to `opencode/big-pickle`, while the quality-sensitive writer tier stays on a free OpenRouter route.
 
 Conclusion: route procedural work to free tier, reserve paid models for tasks that actually need the quality.
 
@@ -18,7 +18,7 @@ Defined in `.opencode/agents/*.md` (shipped in the harness, symlinked into consu
 
 | Agent | Model | Reasoning | Use for |
 |-------|-------|-----------|---------|
-| `@general-free` | `openrouter/z-ai/glm-4.5-air:free` | `minimal` | Geometra form fills, tracker TSV merges, scan dedup, OTP retrieval via Gmail, scripted pipeline steps |
+| `@general-free` | `opencode/big-pickle` | `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/openai/gpt-oss-20b:free` | `none` | Narrow one-shot transforms: "extract these 8 fields from this JD text → JSON", "classify this archetype" |
 
@@ -79,7 +79,10 @@ 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. If you run into quality issues on forms, swap to a different free OpenRouter model first before considering a paid tier.
+The primary `@general-free` model is set in `models.yaml` via the `fast`
+role's `targets.opencode` override. Change that if you want a different
+default. The `fallback_models` list still lives in
+`.opencode/agents/general-free.md` / `iso/agents/general-free.md`.
 
 ### Add a custom agent
 
@@ -139,7 +142,7 @@ Default chains ship upstream in each agent's YAML frontmatter (`node_modules/job
 
 | Agent | Primary | Fallback chain (in order) |
 |-------|---------|---------------------------|
-| `@general-free` | `openrouter/z-ai/glm-4.5-air:free` | `openrouter/minimax/minimax-m2.5:free` → `openrouter/openai/gpt-oss-20b:free` → `openrouter/nvidia/nemotron-3-nano-30b-a3b:free` → `openrouter/qwen/qwen3-coder:free` |
+| `@general-free` | `opencode/big-pickle` | `openrouter/z-ai/glm-4.5-air:free` → `openrouter/openai/gpt-oss-20b:free` → `openrouter/nvidia/nemotron-3-nano-30b-a3b:free` → `openrouter/qwen/qwen3-coder:free` |
 | `@general-paid` | `openrouter/qwen/qwen3-next-80b-a3b-instruct:free` | `openrouter/openai/gpt-oss-120b:free` → `openrouter/nvidia/nemotron-3-super-120b-a12b:free` → `openrouter/z-ai/glm-4.5-air:free` → `openrouter/qwen/qwen3-coder:free` → `openrouter/google/gemma-4-31b-it:free` → `openrouter/meta-llama/llama-3.3-70b-instruct:free` |
 | `@glm-minimal` | `openrouter/openai/gpt-oss-20b:free` | `openrouter/google/gemma-4-26b-a4b-it:free` → `openrouter/nvidia/nemotron-nano-9b-v2:free` → `openrouter/google/gemma-4-31b-it:free` → `openrouter/z-ai/glm-4.5-air:free` |
 

package/iso/agents/general-free.md

@@ -10,11 +10,12 @@ targets:
     mode: subagent
     temperature: 0.1
     reasoningEffort: minimal
-    # Primary (z-ai/glm-4.5-air:free) resolves from openrouter-free preset.
-    # Fallback chain is ordered by decreasing likelihood of rate-limits,
-    # staying within free models that can tool-call Geometra + Gmail MCPs.
+    # Primary comes from models.yaml: opencode/big-pickle on OpenCode.
+    # Fallback chain stays free-only and intentionally excludes
+    # openrouter/minimax/minimax-m2.5:free because recent traces showed
+    # repeated read({ path|file_path }) schema drift on that route.
     fallback_models:
-      - openrouter/minimax/minimax-m2.5:free
+      - openrouter/z-ai/glm-4.5-air:free
       - openrouter/openai/gpt-oss-20b:free
       - openrouter/nvidia/nemotron-3-nano-30b-a3b:free
       - openrouter/qwen/qwen3-coder:free

package/models.yaml

@@ -9,7 +9,7 @@
 #
 # JobForge's subagents bind to preset roles via the `role:` field in
 # iso/agents/<slug>.md:
-#   @general-free  → role: fast     (Haiku / OpenRouter GLM 4.5 Air free / gpt-5.4-mini)
+#   @general-free  → role: fast     (Haiku / OpenCode big-pickle / 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 GPT-OSS-20B free / gpt-5.4-nano)
 #
@@ -30,3 +30,10 @@
 #           model: gpt-5.4
 
 extends: openrouter-free
+
+roles:
+  fast:
+    targets:
+      opencode:
+        provider: opencode
+        model: opencode/big-pickle

package/opencode.json

@@ -3,7 +3,7 @@
   "model": "openrouter/qwen/qwen3-coder:free",
   "agent": {
     "fast": {
-      "model": "openrouter/z-ai/glm-4.5-air:free"
+      "model": "opencode/big-pickle"
     },
     "quality": {
       "model": "openrouter/qwen/qwen3-next-80b-a3b-instruct:free"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "job-forge",
-  "version": "2.14.2",
+  "version": "2.14.3",
   "description": "AI-powered job search pipeline built on opencode",
   "type": "module",
   "bin": {