job-forge 2.14.0 → 2.14.1

package/.cursor/rules/main.mdc

@@ -41,6 +41,9 @@ AI-powered job search pipeline: scans portals, evaluates offers, generates CVs v
 - [D3] Upgrade `apply` routing to `@general-paid` when offer score ≥ 4.0/5, when user flags "top-tier / dream job / high-stakes", or when late-stage pipeline (post-screens).
   why: form-fill flows are 6+ steps; free-tier sometimes aborts mid-flow on large Greenhouse/Workday schemas; paid tier has more headroom
 
+- [D3f] **Provider-failure downgrade on `apply` (all harnesses; OpenCode + OpenRouter especially):** If you dispatched `@general-paid` per [D3] and that subagent fails or exhausts retries with provider-side errors — copy mentioning Venice / Diem / Chutes, "insufficient" USD/credits/funds/balance, HTTP 402/429, overload / temporarily unavailable — re-dispatch the **same apply URL** once on `@general-free` before marking FAILED. Do not abandon the role solely because the upgraded tier hit a pool-specific limit.
+  why: `@general-paid` on OpenCode still uses free OpenRouter model ids; Venice-style balance errors are a backend-route issue, not proof that procedural `@general-free` cannot complete the same Greenhouse-style flow after [D5]/[H2] gates pass
+
 - [D4] Auto-submit for offers scoring 3.0+/5 without pausing for confirmation between steps — scan → evaluate → apply is one continuous pipeline. Mark SKIP for <3.0 and move on.
   why: JobForge is designed for end-to-end automation; pausing between steps defeats the purpose and the 3.0 gate already enforces quality
 
@@ -57,7 +60,7 @@ AI-powered job search pipeline: scans portals, evaluates offers, generates CVs v
 3. Apply [D1]: batch/Geometra work → delegate; single/read-only/dev → inline.
 4. Before any `task` batch using Geometra, run cleanup [H3].
 5. Before `apply`, run duplicate check [H2] and location filter [D5].
-6. Route by cost tier [D2]; upgrade to `@general-paid` per [D3] for high-stakes offers.
+6. Route by cost tier [D2]; upgrade to `@general-paid` per [D3] for high-stakes offers; if that apply dispatch hits provider errors, downgrade once per [D3f].
 7. Cap parallelism at 2 per round [H1].
 8. One in-flight dispatch per company [H5].
 9. Orchestrator does not fill forms in multi-job mode [H4].

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

@@ -7,5 +7,11 @@
     "openrouter/z-ai/glm-4.5-air:free",
     "openrouter/nvidia/nemotron-3-super-120b-a12b:free",
     "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"
   ]
 }

package/AGENTS.md

@@ -36,6 +36,9 @@ AI-powered job search pipeline: scans portals, evaluates offers, generates CVs v
 - [D3] Upgrade `apply` routing to `@general-paid` when offer score ≥ 4.0/5, when user flags "top-tier / dream job / high-stakes", or when late-stage pipeline (post-screens).
   why: form-fill flows are 6+ steps; free-tier sometimes aborts mid-flow on large Greenhouse/Workday schemas; paid tier has more headroom
 
+- [D3f] **Provider-failure downgrade on `apply` (all harnesses; OpenCode + OpenRouter especially):** If you dispatched `@general-paid` per [D3] and that subagent fails or exhausts retries with provider-side errors — copy mentioning Venice / Diem / Chutes, "insufficient" USD/credits/funds/balance, HTTP 402/429, overload / temporarily unavailable — re-dispatch the **same apply URL** once on `@general-free` before marking FAILED. Do not abandon the role solely because the upgraded tier hit a pool-specific limit.
+  why: `@general-paid` on OpenCode still uses free OpenRouter model ids; Venice-style balance errors are a backend-route issue, not proof that procedural `@general-free` cannot complete the same Greenhouse-style flow after [D5]/[H2] gates pass
+
 - [D4] Auto-submit for offers scoring 3.0+/5 without pausing for confirmation between steps — scan → evaluate → apply is one continuous pipeline. Mark SKIP for <3.0 and move on.
   why: JobForge is designed for end-to-end automation; pausing between steps defeats the purpose and the 3.0 gate already enforces quality
 
@@ -52,7 +55,7 @@ AI-powered job search pipeline: scans portals, evaluates offers, generates CVs v
 3. Apply [D1]: batch/Geometra work → delegate; single/read-only/dev → inline.
 4. Before any `task` batch using Geometra, run cleanup [H3].
 5. Before `apply`, run duplicate check [H2] and location filter [D5].
-6. Route by cost tier [D2]; upgrade to `@general-paid` per [D3] for high-stakes offers.
+6. Route by cost tier [D2]; upgrade to `@general-paid` per [D3] for high-stakes offers; if that apply dispatch hits provider errors, downgrade once per [D3f].
 7. Cap parallelism at 2 per round [H1].
 8. One in-flight dispatch per company [H5].
 9. Orchestrator does not fill forms in multi-job mode [H4].

package/CLAUDE.md

@@ -36,6 +36,9 @@ AI-powered job search pipeline: scans portals, evaluates offers, generates CVs v
 - [D3] Upgrade `apply` routing to `@general-paid` when offer score ≥ 4.0/5, when user flags "top-tier / dream job / high-stakes", or when late-stage pipeline (post-screens).
   why: form-fill flows are 6+ steps; free-tier sometimes aborts mid-flow on large Greenhouse/Workday schemas; paid tier has more headroom
 
+- [D3f] **Provider-failure downgrade on `apply` (all harnesses; OpenCode + OpenRouter especially):** If you dispatched `@general-paid` per [D3] and that subagent fails or exhausts retries with provider-side errors — copy mentioning Venice / Diem / Chutes, "insufficient" USD/credits/funds/balance, HTTP 402/429, overload / temporarily unavailable — re-dispatch the **same apply URL** once on `@general-free` before marking FAILED. Do not abandon the role solely because the upgraded tier hit a pool-specific limit.
+  why: `@general-paid` on OpenCode still uses free OpenRouter model ids; Venice-style balance errors are a backend-route issue, not proof that procedural `@general-free` cannot complete the same Greenhouse-style flow after [D5]/[H2] gates pass
+
 - [D4] Auto-submit for offers scoring 3.0+/5 without pausing for confirmation between steps — scan → evaluate → apply is one continuous pipeline. Mark SKIP for <3.0 and move on.
   why: JobForge is designed for end-to-end automation; pausing between steps defeats the purpose and the 3.0 gate already enforces quality
 
@@ -52,7 +55,7 @@ AI-powered job search pipeline: scans portals, evaluates offers, generates CVs v
 3. Apply [D1]: batch/Geometra work → delegate; single/read-only/dev → inline.
 4. Before any `task` batch using Geometra, run cleanup [H3].
 5. Before `apply`, run duplicate check [H2] and location filter [D5].
-6. Route by cost tier [D2]; upgrade to `@general-paid` per [D3] for high-stakes offers.
+6. Route by cost tier [D2]; upgrade to `@general-paid` per [D3] for high-stakes offers; if that apply dispatch hits provider errors, downgrade once per [D3f].
 7. Cap parallelism at 2 per round [H1].
 8. One in-flight dispatch per company [H5].
 9. Orchestrator does not fill forms in multi-job mode [H4].

package/docs/MODEL-ROUTING.md

@@ -145,9 +145,11 @@ Default chains ship upstream in each agent's YAML frontmatter (`node_modules/job
 
 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 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.
+Consumers **do not need to configure anything** to get these defaults: the subagent chains arrive via the symlinked agent MD files, and the harness ships `.opencode/opencode-model-fallback.json` for the main orchestrator / any agent without its own list. That JSON is **generated by `@razroo/iso-harness`** from the top-level `opencodeModelFallback` object in the harness's `iso/config.json` (same `iso build` pass as `opencode.json`), so it stays in sync with published releases — not a hand-edited file in git. `@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.
+**When fallback fires:** the plugin pattern-matches rate-limit / 5xx / quota / "overloaded" / insufficient-balance style errors (including Venice / Diem copy — see `retryable_error_patterns` in the harness source). Failed models enter a 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.
+
+**Orchestrator policy (all harnesses):** if an upgraded `@general-paid` apply still fails after model fallback, follow **[D3f]** in the shared instructions (`AGENTS.md` / `CLAUDE.md` / Cursor rules / Codex `AGENTS.md`) — re-dispatch the same URL once on `@general-free` before marking FAILED.
 
 ### Overriding an upstream chain
 
@@ -165,17 +167,23 @@ Add an `agent.<name>.fallback_models` block to your project's `opencode.json`. T
 
 ### Global fallback chain (agents without their own)
 
-Plugin-level config at `.opencode/opencode-model-fallback.json` — applies to any agent whose `fallback_models` is empty:
+Source of truth: **`iso/config.json` → `opencodeModelFallback`** (iso-harness writes `.opencode/opencode-model-fallback.json` on `npm run build:config` / `prepack`). Applies to the orchestrator and any agent whose `fallback_models` is empty. Example shape:
 
 ```json
 {
   "cooldown_seconds": 60,
   "timeout_seconds": 30,
   "notify_on_fallback": true,
-  "fallback_models": ["openrouter/openai/gpt-oss-120b:free", "openrouter/z-ai/glm-4.5-air:free"]
+  "fallback_models": [
+    "openrouter/openai/gpt-oss-120b:free",
+    "openrouter/z-ai/glm-4.5-air:free"
+  ],
+  "retryable_error_patterns": ["(?i)venice.*insufficient"]
 }
 ```
 
+`retryable_error_patterns` extends the plugin's built-in matchers — use it for provider-specific strings (Venice Diem balance, etc.) that do not match the stock regexes.
+
 ### Disabling fallback
 
 Remove `"@razroo/opencode-model-fallback"` from `opencode.json:plugin` — agents keep their `model:` primary and errors propagate normally.

package/iso/config.json

@@ -1,4 +1,21 @@
 {
+  "opencodeModelFallback": {
+    "cooldown_seconds": 60,
+    "timeout_seconds": 30,
+    "notify_on_fallback": true,
+    "fallback_models": [
+      "openrouter/openai/gpt-oss-120b:free",
+      "openrouter/z-ai/glm-4.5-air:free",
+      "openrouter/nvidia/nemotron-3-super-120b-a12b:free",
+      "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"
+    ]
+  },
   "targets": {
     "opencode": {
       "plugin": ["@razroo/opencode-model-fallback"],

package/iso/instructions.md

@@ -36,6 +36,9 @@ AI-powered job search pipeline: scans portals, evaluates offers, generates CVs v
 - [D3] Upgrade `apply` routing to `@general-paid` when offer score ≥ 4.0/5, when user flags "top-tier / dream job / high-stakes", or when late-stage pipeline (post-screens).
   why: form-fill flows are 6+ steps; free-tier sometimes aborts mid-flow on large Greenhouse/Workday schemas; paid tier has more headroom
 
+- [D3f] **Provider-failure downgrade on `apply` (all harnesses; OpenCode + OpenRouter especially):** If you dispatched `@general-paid` per [D3] and that subagent fails or exhausts retries with provider-side errors — copy mentioning Venice / Diem / Chutes, "insufficient" USD/credits/funds/balance, HTTP 402/429, overload / temporarily unavailable — re-dispatch the **same apply URL** once on `@general-free` before marking FAILED. Do not abandon the role solely because the upgraded tier hit a pool-specific limit.
+  why: `@general-paid` on OpenCode still uses free OpenRouter model ids; Venice-style balance errors are a backend-route issue, not proof that procedural `@general-free` cannot complete the same Greenhouse-style flow after [D5]/[H2] gates pass
+
 - [D4] Auto-submit for offers scoring 3.0+/5 without pausing for confirmation between steps — scan → evaluate → apply is one continuous pipeline. Mark SKIP for <3.0 and move on.
   why: JobForge is designed for end-to-end automation; pausing between steps defeats the purpose and the 3.0 gate already enforces quality
 
@@ -52,7 +55,7 @@ AI-powered job search pipeline: scans portals, evaluates offers, generates CVs v
 3. Apply [D1]: batch/Geometra work → delegate; single/read-only/dev → inline.
 4. Before any `task` batch using Geometra, run cleanup [H3].
 5. Before `apply`, run duplicate check [H2] and location filter [D5].
-6. Route by cost tier [D2]; upgrade to `@general-paid` per [D3] for high-stakes offers.
+6. Route by cost tier [D2]; upgrade to `@general-paid` per [D3] for high-stakes offers; if that apply dispatch hits provider errors, downgrade once per [D3f].
 7. Cap parallelism at 2 per round [H1].
 8. One in-flight dispatch per company [H5].
 9. Orchestrator does not fill forms in multi-job mode [H4].

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "job-forge",
-  "version": "2.14.0",
+  "version": "2.14.1",
   "description": "AI-powered job search pipeline built on opencode",
   "type": "module",
   "bin": {
@@ -88,7 +88,7 @@
   },
   "devDependencies": {
     "@razroo/iso": "^0.2.5",
-    "@razroo/iso-harness": "^0.6.0",
+    "@razroo/iso-harness": "^0.6.1",
     "@razroo/iso-route": "^0.5.0",
     "@razroo/iso-trace": "^0.1.0",
     "@razroo/opencode-model-fallback": "^0.3.1"