job-forge 2.14.1 → 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/.opencode/agents/general-paid.md

@@ -8,10 +8,12 @@ tools:
 temperature: 0.3
 reasoningEffort: medium
 fallback_models:
-  - openrouter/nvidia/nemotron-3-super-120b-a12b: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
 ---
 
 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.

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

@@ -9,9 +9,14 @@
     "openrouter/qwen/qwen3-next-80b-a3b-instruct:free"
   ],
   "retryable_error_patterns": [
-    "(?i)\\bvenice\\b.*(?:insufficient|balance|credits?|diem|usd)",
-    "(?i)insufficient\\s+(?:usd|diem|credits?|funds?|balance)",
-    "(?i)credit.*balance.*too.*low",
-    "(?i)(?:temporarily\\s+)?unavailable|overloaded|try\\s+again"
+    "\\bvenice\\b",
+    "insufficient\\s+usd",
+    "insufficient\\s+.*\\s+diem",
+    "diem\\s+balance",
+    "add\\s+credits",
+    "chutes",
+    "insufficient\\s+(?:credits?|funds?|balance)",
+    "credit.*balance.*too.*low",
+    "(?:temporarily\\s+)?unavailable|overloaded|try\\s+again"
   ]
 }

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/bin/create-job-forge.mjs

@@ -196,6 +196,7 @@ const opencodeCfg = {
         'nvidia/nemotron-nano-9b-v2:free': {},
         'google/gemma-4-26b-a4b-it:free': {},
         'google/gemma-4-31b-it:free': {},
+        'meta-llama/llama-3.3-70b-instruct:free': {},
       },
     },
   },

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,8 +142,8 @@ 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-paid` | `openrouter/qwen/qwen3-next-80b-a3b-instruct:free` | `openrouter/nvidia/nemotron-3-super-120b-a12b:free` → `openrouter/openai/gpt-oss-120b:free` → `openrouter/z-ai/glm-4.5-air: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` |
 
 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.

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/iso/agents/general-paid.md

@@ -12,13 +12,17 @@ targets:
     temperature: 0.3
     reasoningEffort: medium
     # Primary (qwen/qwen3-next-80b-a3b-instruct:free) resolves from the
-    # openrouter-free preset. Fallback chain prioritizes models with
-    # strong long-form writing judgment over raw size.
+    # openrouter-free preset. First fallbacks intentionally avoid another
+    # immediate hop through the same Venice/Qwen pool when OpenRouter
+    # returns "[Venice] insufficient …" — gpt-oss-120b + nemotron are
+    # usually different backends. Remaining picks stay free-only.
     fallback_models:
-      - openrouter/nvidia/nemotron-3-super-120b-a12b: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
     tools:
       geometra_*: false
       gmail_*: false

package/iso/config.json

@@ -10,10 +10,15 @@
       "openrouter/qwen/qwen3-next-80b-a3b-instruct:free"
     ],
     "retryable_error_patterns": [
-      "(?i)\\bvenice\\b.*(?:insufficient|balance|credits?|diem|usd)",
-      "(?i)insufficient\\s+(?:usd|diem|credits?|funds?|balance)",
-      "(?i)credit.*balance.*too.*low",
-      "(?i)(?:temporarily\\s+)?unavailable|overloaded|try\\s+again"
+      "\\bvenice\\b",
+      "insufficient\\s+usd",
+      "insufficient\\s+.*\\s+diem",
+      "diem\\s+balance",
+      "add\\s+credits",
+      "chutes",
+      "insufficient\\s+(?:credits?|funds?|balance)",
+      "credit.*balance.*too.*low",
+      "(?:temporarily\\s+)?unavailable|overloaded|try\\s+again"
     ]
   },
   "targets": {
@@ -34,7 +39,8 @@
             "nvidia/nemotron-3-nano-30b-a3b:free": {},
             "nvidia/nemotron-nano-9b-v2:free": {},
             "google/gemma-4-26b-a4b-it:free": {},
-            "google/gemma-4-31b-it:free": {}
+            "google/gemma-4-31b-it:free": {},
+            "meta-llama/llama-3.3-70b-instruct: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"
@@ -25,7 +25,8 @@
         "nvidia/nemotron-3-nano-30b-a3b:free": {},
         "nvidia/nemotron-nano-9b-v2:free": {},
         "google/gemma-4-26b-a4b-it:free": {},
-        "google/gemma-4-31b-it:free": {}
+        "google/gemma-4-31b-it:free": {},
+        "meta-llama/llama-3.3-70b-instruct:free": {}
       }
     }
   },

package/package.json

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