job-forge 2.14.38 → 2.14.40

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (59) hide show
  1. package/.codex/config.toml +3 -2
  2. package/.cursor/mcp.json +8 -3
  3. package/.cursor/rules/main.mdc +1 -1
  4. package/.mcp.json +8 -3
  5. package/AGENTS.md +1 -1
  6. package/CLAUDE.md +1 -1
  7. package/README.md +143 -191
  8. package/batch/README.md +1 -1
  9. package/bin/create-job-forge.mjs +8 -4
  10. package/bin/geometra-mcp-launcher.mjs +86 -0
  11. package/bin/job-forge.mjs +3 -0
  12. package/bin/sync.mjs +1 -1
  13. package/docs/ARCHITECTURE.md +20 -20
  14. package/docs/CUSTOMIZATION.md +20 -20
  15. package/docs/README.md +1 -1
  16. package/docs/SETUP.md +3 -3
  17. package/iso/instructions.md +1 -1
  18. package/iso/mcp.json +5 -1
  19. package/lib/jobforge-cache.mjs +1 -1
  20. package/lib/jobforge-canon.mjs +1 -1
  21. package/lib/jobforge-capabilities.mjs +1 -1
  22. package/lib/jobforge-context.mjs +1 -1
  23. package/lib/jobforge-contracts.mjs +1 -1
  24. package/lib/jobforge-facts.mjs +1 -1
  25. package/lib/jobforge-index.mjs +1 -1
  26. package/lib/jobforge-ledger.mjs +1 -1
  27. package/lib/jobforge-lineage.mjs +1 -1
  28. package/lib/jobforge-migrate.mjs +1 -1
  29. package/lib/jobforge-observability.mjs +1 -1
  30. package/lib/jobforge-postflight.mjs +1 -1
  31. package/lib/jobforge-preflight.mjs +1 -1
  32. package/lib/jobforge-prioritize.mjs +1 -1
  33. package/lib/jobforge-redact.mjs +1 -1
  34. package/lib/jobforge-score.mjs +1 -1
  35. package/lib/jobforge-timeline.mjs +1 -1
  36. package/models.yaml +1 -1
  37. package/modes/batch.md +1 -1
  38. package/modes/reference-portals.md +3 -1
  39. package/modes/reference-setup.md +1 -1
  40. package/opencode.json +7 -3
  41. package/package.json +26 -26
  42. package/scripts/batch-orchestrator.mjs +2 -2
  43. package/scripts/cache.mjs +1 -1
  44. package/scripts/canon.mjs +1 -1
  45. package/scripts/check-helper-integration.mjs +19 -19
  46. package/scripts/facts.mjs +1 -1
  47. package/scripts/guard.mjs +1 -1
  48. package/scripts/index.mjs +1 -1
  49. package/scripts/ledger.mjs +1 -1
  50. package/scripts/lineage.mjs +1 -1
  51. package/scripts/migrate.mjs +1 -1
  52. package/scripts/postflight.mjs +1 -1
  53. package/scripts/preflight.mjs +1 -1
  54. package/scripts/prioritize.mjs +1 -1
  55. package/scripts/redact.mjs +1 -1
  56. package/scripts/score.mjs +1 -1
  57. package/scripts/timeline.mjs +1 -1
  58. package/scripts/trace.mjs +1 -1
  59. package/templates/portals.example.yml +1 -1
package/bin/job-forge.mjs CHANGED
@@ -16,6 +16,7 @@
16
16
  * normalize Run normalize-statuses.mjs
17
17
  * pdf Run generate-pdf.mjs
18
18
  * sync-check Run cv-sync-check.mjs
19
+ * mcp:geometra Launch Geometra MCP via JobForge's local/npm resolver
19
20
  * tokens Run scripts/token-usage-report.mjs
20
21
  * trace:* Inspect local agent transcripts via iso-trace
21
22
  * telemetry:* Summarize JobForge pipeline status from traces + tracker files
@@ -55,6 +56,7 @@ const commands = {
55
56
  normalize: 'normalize-statuses.mjs',
56
57
  pdf: 'generate-pdf.mjs',
57
58
  'sync-check': 'cv-sync-check.mjs',
59
+ 'mcp:geometra': 'bin/geometra-mcp-launcher.mjs',
58
60
  tokens: 'scripts/token-usage-report.mjs',
59
61
  sync: 'bin/sync.mjs',
60
62
  // Deterministic helpers — agents call these instead of deriving values
@@ -244,6 +246,7 @@ Commands:
244
246
  normalize Normalize status values across the tracker
245
247
  pdf Generate ATS-optimized CV PDF from cv.md
246
248
  sync-check Lint: verify cv.md and profile.yml are filled in
249
+ mcp:geometra Launch Geometra MCP, preferring local JobForge/Geometra dev wiring
247
250
  tokens Show opencode token usage and cost by session/day
248
251
  trace Pass through to iso-trace (e.g. job-forge trace sources)
249
252
  trace:list List recent local agent sessions (defaults: --since 7d --cwd project)
package/bin/sync.mjs CHANGED
@@ -27,7 +27,7 @@ import {
27
27
  loadMigrationConfig,
28
28
  parseJson,
29
29
  runMigrations,
30
- } from '@razroo/iso-migrate';
30
+ } from '@agent-pattern-labs/iso-migrate';
31
31
 
32
32
  const __dirname = dirname(fileURLToPath(import.meta.url));
33
33
  const PKG_ROOT = resolve(__dirname, '..');
@@ -4,7 +4,7 @@
4
4
 
5
5
  JobForge ships as an npm package at [`job-forge`](https://www.npmjs.com/package/job-forge). There are two kinds of repo involved:
6
6
 
7
- - **Harness** — this repo, `razroo/JobForge`. Published to npm. Contains `iso/` (single source of truth), modes, scripts, skill router, templates, fonts, dashboard, and bin entries. Per-harness config trees are **generated** from `iso/` by [`@razroo/iso-harness`](https://www.npmjs.com/package/@razroo/iso-harness) — gitignored here, baked into the tarball by `prepack` at publish time, and landed in consumer projects via symlinks.
7
+ - **Harness** — this repo, `Agent-Pattern-Labs/JobForge`. Published to npm. Contains `iso/` (single source of truth), modes, scripts, skill router, templates, fonts, dashboard, and bin entries. Per-harness config trees are **generated** from `iso/` by [`@agent-pattern-labs/iso-harness`](https://www.npmjs.com/package/@agent-pattern-labs/iso-harness) — gitignored here, baked into the tarball by `prepack` at publish time, and landed in consumer projects via symlinks.
8
8
  - **Consumer project** — what users interact with day-to-day. Scaffolded via `npx --package=job-forge create-job-forge <dir>`, or hand-authored with `job-forge` listed in `package.json` dependencies.
9
9
 
10
10
  The consumer's project root contains personal data plus symlinks into `node_modules/job-forge/`:
@@ -148,7 +148,7 @@ Each worker is a headless CLI agent (`opencode run` or `codex exec`) that receiv
148
148
 
149
149
  The orchestrator manages parallelism, state, retries, and resume. The default
150
150
  runner delegates to `scripts/batch-orchestrator.mjs`, which uses
151
- `@razroo/iso-orchestrator` for bounded bundle fan-out, idempotent bundle steps,
151
+ `@agent-pattern-labs/iso-orchestrator` for bounded bundle fan-out, idempotent bundle steps,
152
152
  mutexed report-number/state writes, and worker leases/heartbeats. Pass
153
153
  `--runner codex` to use Codex workers instead of OpenCode. Set
154
154
  `JOBFORGE_LEGACY_BATCH_RUNNER=1` only if you need the old shell loop.
@@ -235,7 +235,7 @@ When the tracker file is missing, checks 1-6 and 8 are skipped; checks 7, 9, 10,
235
235
 
236
236
  Prefer one focused change per pull request: a single mode under `modes/`, one repository-root `.mjs` utility, documentation under `docs/`, fictional samples under [`examples/`](../examples/README.md), templates such as [`templates/portals.example.yml`](../templates/portals.example.yml), the batch flow described in [`batch/README.md`](../batch/README.md), or the Go TUI under `dashboard/` — not a repo-wide refactor across 3+ of those at once. Branch workflow, the verify + dashboard build gate, and starter ideas are in [CONTRIBUTING.md](../CONTRIBUTING.md) (**What to Contribute** and **Development**). To look for in-repo `TODO`, `FIXME`, or `HACK` markers before choosing a task, use the `rg` one-liner in [CONTRIBUTING.md — Optional: scripted agent iterations](../CONTRIBUTING.md#optional-scripted-agent-iterations). Upstream PRs MUST stay generic: do not commit real candidate data (`cv.md`, `config/profile.yml`, personalized `portals.yml`, `data/applications.md`, `reports/`, or similar paths called out in CONTRIBUTING and `.gitignore`).
237
237
 
238
- **PR / maintainer gate:** Before opening a pull request against `razroo/JobForge`, run `npm run verify`, `npm run smoke:iso`, and `npm run build:dashboard` (or `(cd dashboard && go build .)`) from the harness repo root (same as [CONTRIBUTING.md](../CONTRIBUTING.md#development)). `smoke:iso` includes `npm run lint:helpers`, which prevents local helper dependencies, CLI aliases, scaffolder scripts, migrations, generated ignores, templates, docs, and helper reference from drifting. For optional scripted iterations that repeat that gate and commit one small change per pass, see [`scripts/cursor-agent-loop.sh`](../scripts/cursor-agent-loop.sh) (environment variables and usage in the script header; overview in [CONTRIBUTING.md](../CONTRIBUTING.md#optional-scripted-agent-iterations)).
238
+ **PR / maintainer gate:** Before opening a pull request against `Agent-Pattern-Labs/JobForge`, run `npm run verify`, `npm run smoke:iso`, and `npm run build:dashboard` (or `(cd dashboard && go build .)`) from the harness repo root (same as [CONTRIBUTING.md](../CONTRIBUTING.md#development)). `smoke:iso` includes `npm run lint:helpers`, which prevents local helper dependencies, CLI aliases, scaffolder scripts, migrations, generated ignores, templates, docs, and helper reference from drifting. For optional scripted iterations that repeat that gate and commit one small change per pass, see [`scripts/cursor-agent-loop.sh`](../scripts/cursor-agent-loop.sh) (environment variables and usage in the script header; overview in [CONTRIBUTING.md](../CONTRIBUTING.md#optional-scripted-agent-iterations)).
239
239
 
240
240
  Scripts maintain data consistency. In a consumer project they're invoked via the `job-forge` CLI (`npx job-forge <cmd>`); in the harness repo they're also directly runnable as `node <script>.mjs`.
241
241
 
@@ -248,24 +248,24 @@ Scripts maintain data consistency. In a consumer project they're invoked via the
248
248
  | `generate-pdf.mjs` | `npx job-forge pdf` | Renders HTML to PDF via Geometra MCP (`geometra_generate_pdf`) or standalone Playwright/Chromium (`npx job-forge pdf <input.html> <output.pdf>`) |
249
249
  | `cv-sync-check.mjs` | `npx job-forge sync-check` | Setup lint: `cv.md` + `config/profile.yml`, hardcoded-metric scan on `modes/_shared.md` and `batch/batch-prompt.md`, optional `article-digest.md` freshness |
250
250
  | `scripts/token-usage-report.mjs` | `npx job-forge tokens` | Per-session opencode token/cost report from the SQLite DB |
251
- | `scripts/trace.mjs` | `npx job-forge trace:list` / `trace:stats` / `trace:show` | Local transcript observability via `@razroo/iso-trace`; common commands default to project-local sessions across supported harnesses |
251
+ | `scripts/trace.mjs` | `npx job-forge trace:list` / `trace:stats` / `trace:show` | Local transcript observability via `@agent-pattern-labs/iso-trace`; common commands default to project-local sessions across supported harnesses |
252
252
  | `scripts/telemetry.mjs` | `npx job-forge telemetry:status` / `telemetry:show` | JobForge operational telemetry derived from normalized local traces plus tracker TSV state |
253
- | `scripts/guard.mjs` | `npx job-forge guard:audit` / `guard:explain` | Deterministic `@razroo/iso-guard` policy audits over local normalized traces (with OpenCode `task` rules still available where relevant) |
254
- | `scripts/ledger.mjs` | `npx job-forge ledger:status` / `ledger:has` / `ledger:rebuild` | Deterministic `@razroo/iso-ledger` state over tracker, TSV, and pipeline files |
255
- | `scripts/capabilities.mjs` | `npx job-forge capabilities:check` / `capabilities:explain` | Deterministic `@razroo/iso-capabilities` role boundary checks for tools, MCPs, commands, filesystem, and network access |
256
- | `scripts/cache.mjs` | `npx job-forge cache:has` / `cache:get` / `cache:put` | Deterministic `@razroo/iso-cache` JD and artifact reuse keyed by stable job/url inputs |
257
- | `scripts/index.mjs` | `npx job-forge index:status` / `index:has` / `index:query` | Deterministic `@razroo/iso-index` lookup over reports, tracker rows, TSVs, pipeline, scan history, and ledger events |
258
- | `scripts/facts.mjs` | `npx job-forge facts:status` / `facts:has` / `facts:query` | Deterministic `@razroo/iso-facts` materialization over job URLs, scores, application statuses, preflight candidates, scan history, and ledger events |
259
- | `scripts/timeline.mjs` | `npx job-forge timeline:due` / `timeline:check` / `timeline:build` | Deterministic `@razroo/iso-timeline` follow-up and next-action planning over tracker rows and dated pipeline items |
260
- | `scripts/prioritize.mjs` | `npx job-forge prioritize:build` / `prioritize:select` / `prioritize:check` | Deterministic `@razroo/iso-prioritize` next-action ranking over materialized facts and due timeline items |
261
- | `scripts/lineage.mjs` | `npx job-forge lineage:record` / `lineage:check` / `lineage:explain` | Deterministic `@razroo/iso-lineage` stale-output checks for generated reports, PDFs, and their source inputs |
262
- | `scripts/score.mjs` | `npx job-forge score:check` / `score:gate` / `score:explain` | Deterministic `@razroo/iso-score` checks for weighted offer scores, threshold booleans, recommendations, and score gates |
263
- | `scripts/canon.mjs` | `npx job-forge canon:normalize` / `canon:key` / `canon:compare` | Deterministic `@razroo/iso-canon` identity normalization for URLs, companies, roles, and company+role pairs |
264
- | `scripts/context.mjs` | `npx job-forge context:list` / `context:plan` / `context:check` / `context:render` | Deterministic `@razroo/iso-context` mode/reference context bundle planning and rendering |
265
- | `scripts/preflight.mjs` | `npx job-forge preflight:plan` / `preflight:check` / `preflight:explain` | Deterministic `@razroo/iso-preflight` dispatch planning for file-backed candidate facts and gates |
266
- | `scripts/postflight.mjs` | `npx job-forge postflight:status` / `postflight:check` / `postflight:explain` | Deterministic `@razroo/iso-postflight` settlement for dispatch outcomes, required tracker TSV artifacts, and merge/verify post-steps |
267
- | `scripts/redact.mjs` | `npx job-forge redact:scan` / `redact:apply` / `redact:verify` | Deterministic `@razroo/iso-redact` safe-export scanning and sanitization for traces, prompts, reports, and fixtures |
268
- | `scripts/migrate.mjs` | `npx job-forge migrate:plan` / `migrate:apply` / `migrate:check` | Deterministic `@razroo/iso-migrate` consumer-project upgrades for scripts and generated-artifact ignores |
253
+ | `scripts/guard.mjs` | `npx job-forge guard:audit` / `guard:explain` | Deterministic `@agent-pattern-labs/iso-guard` policy audits over local normalized traces (with OpenCode `task` rules still available where relevant) |
254
+ | `scripts/ledger.mjs` | `npx job-forge ledger:status` / `ledger:has` / `ledger:rebuild` | Deterministic `@agent-pattern-labs/iso-ledger` state over tracker, TSV, and pipeline files |
255
+ | `scripts/capabilities.mjs` | `npx job-forge capabilities:check` / `capabilities:explain` | Deterministic `@agent-pattern-labs/iso-capabilities` role boundary checks for tools, MCPs, commands, filesystem, and network access |
256
+ | `scripts/cache.mjs` | `npx job-forge cache:has` / `cache:get` / `cache:put` | Deterministic `@agent-pattern-labs/iso-cache` JD and artifact reuse keyed by stable job/url inputs |
257
+ | `scripts/index.mjs` | `npx job-forge index:status` / `index:has` / `index:query` | Deterministic `@agent-pattern-labs/iso-index` lookup over reports, tracker rows, TSVs, pipeline, scan history, and ledger events |
258
+ | `scripts/facts.mjs` | `npx job-forge facts:status` / `facts:has` / `facts:query` | Deterministic `@agent-pattern-labs/iso-facts` materialization over job URLs, scores, application statuses, preflight candidates, scan history, and ledger events |
259
+ | `scripts/timeline.mjs` | `npx job-forge timeline:due` / `timeline:check` / `timeline:build` | Deterministic `@agent-pattern-labs/iso-timeline` follow-up and next-action planning over tracker rows and dated pipeline items |
260
+ | `scripts/prioritize.mjs` | `npx job-forge prioritize:build` / `prioritize:select` / `prioritize:check` | Deterministic `@agent-pattern-labs/iso-prioritize` next-action ranking over materialized facts and due timeline items |
261
+ | `scripts/lineage.mjs` | `npx job-forge lineage:record` / `lineage:check` / `lineage:explain` | Deterministic `@agent-pattern-labs/iso-lineage` stale-output checks for generated reports, PDFs, and their source inputs |
262
+ | `scripts/score.mjs` | `npx job-forge score:check` / `score:gate` / `score:explain` | Deterministic `@agent-pattern-labs/iso-score` checks for weighted offer scores, threshold booleans, recommendations, and score gates |
263
+ | `scripts/canon.mjs` | `npx job-forge canon:normalize` / `canon:key` / `canon:compare` | Deterministic `@agent-pattern-labs/iso-canon` identity normalization for URLs, companies, roles, and company+role pairs |
264
+ | `scripts/context.mjs` | `npx job-forge context:list` / `context:plan` / `context:check` / `context:render` | Deterministic `@agent-pattern-labs/iso-context` mode/reference context bundle planning and rendering |
265
+ | `scripts/preflight.mjs` | `npx job-forge preflight:plan` / `preflight:check` / `preflight:explain` | Deterministic `@agent-pattern-labs/iso-preflight` dispatch planning for file-backed candidate facts and gates |
266
+ | `scripts/postflight.mjs` | `npx job-forge postflight:status` / `postflight:check` / `postflight:explain` | Deterministic `@agent-pattern-labs/iso-postflight` settlement for dispatch outcomes, required tracker TSV artifacts, and merge/verify post-steps |
267
+ | `scripts/redact.mjs` | `npx job-forge redact:scan` / `redact:apply` / `redact:verify` | Deterministic `@agent-pattern-labs/iso-redact` safe-export scanning and sanitization for traces, prompts, reports, and fixtures |
268
+ | `scripts/migrate.mjs` | `npx job-forge migrate:plan` / `migrate:apply` / `migrate:check` | Deterministic `@agent-pattern-labs/iso-migrate` consumer-project upgrades for scripts and generated-artifact ignores |
269
269
  | `scripts/check-helper-integration.mjs` | `npm run lint:helpers` | Integration lint that keeps helper packages, scripts, scaffolder defaults, migrations, generated ignores, docs, and `modes/reference-local-helpers.md` aligned |
270
270
  | `tracker-lib.mjs` | _(library)_ | Shared helpers for reading/writing day-based tracker files — imported by merge/dedup/verify/normalize |
271
271
  | `bin/sync.mjs` | `npx job-forge sync` | Creates the harness symlinks in a consumer project and applies safe migrations (also runs as `postinstall`) |
@@ -11,7 +11,7 @@
11
11
  > # edit modes/_shared.md — npx job-forge sync will leave it alone from now on
12
12
  > ```
13
13
  >
14
- > A cleaner path is to keep customization in `config/profile.yml` where possible (the shared mode files already read from it). Open an issue against `razroo/JobForge` if a piece of personal data is currently stuck in a mode file and ought to be in `profile.yml`.
14
+ > A cleaner path is to keep customization in `config/profile.yml` where possible (the shared mode files already read from it). Open an issue against `Agent-Pattern-Labs/JobForge` if a piece of personal data is currently stuck in a mode file and ought to be in `profile.yml`.
15
15
 
16
16
  ## Profile (config/profile.yml)
17
17
 
@@ -98,7 +98,7 @@ Some forks use a **single** `data/applications.md` instead. That is fine if you
98
98
 
99
99
  ## Transcript observability (iso-trace)
100
100
 
101
- To inspect real agent sessions locally (tool mix, redundant fetches, Geometra churn) without uploading transcripts, use the `job-forge trace:*` commands. JobForge depends on Razroo's [`@razroo/iso-trace`](https://github.com/razroo/iso/tree/main/packages/iso-trace), so consumer projects do not need to install it separately.
101
+ To inspect real agent sessions locally (tool mix, redundant fetches, Geometra churn) without uploading transcripts, use the `job-forge trace:*` commands. JobForge depends on Razroo's [`@agent-pattern-labs/iso-trace`](https://github.com/razroo/iso/tree/main/packages/iso-trace), so consumer projects do not need to install it separately.
102
102
 
103
103
  Common commands default to sessions for the current project and use a 7-day window:
104
104
 
@@ -127,7 +127,7 @@ Telemetry is also local-only and passive. It reads normalized local harness trac
127
127
 
128
128
  ## JobForge ledger
129
129
 
130
- The ledger is append-only local workflow state backed by `@razroo/iso-ledger`. It is not an MCP and does not add prompt, tool-schema, or state-trace tokens. Use it when you want a cheap deterministic check before loading growing tracker files:
130
+ The ledger is append-only local workflow state backed by `@agent-pattern-labs/iso-ledger`. It is not an MCP and does not add prompt, tool-schema, or state-trace tokens. Use it when you want a cheap deterministic check before loading growing tracker files:
131
131
 
132
132
  ```bash
133
133
  npx job-forge ledger:rebuild
@@ -140,63 +140,63 @@ npx job-forge ledger:verify
140
140
 
141
141
  ## JobForge artifact contracts
142
142
 
143
- Machine-readable artifact shapes live in `templates/contracts.json` and are enforced by `@razroo/iso-contract`. `job-forge tracker-line` renders tracker additions through the `jobforge.tracker-row` contract, `merge` validates pending TSV/table rows before writing tracker files, and `verify` validates existing tracker rows against the same contract. Custom forks can extend `templates/contracts.json`, but keep the tracker status enum aligned with `templates/states.yml`.
143
+ Machine-readable artifact shapes live in `templates/contracts.json` and are enforced by `@agent-pattern-labs/iso-contract`. `job-forge tracker-line` renders tracker additions through the `jobforge.tracker-row` contract, `merge` validates pending TSV/table rows before writing tracker files, and `verify` validates existing tracker rows against the same contract. Custom forks can extend `templates/contracts.json`, but keep the tracker status enum aligned with `templates/states.yml`.
144
144
 
145
145
  ## JobForge role capabilities
146
146
 
147
- Role capability boundaries live in `templates/capabilities.json` and are enforced locally by `@razroo/iso-capabilities`. Use `job-forge capabilities:explain <role>` to inspect a role and `job-forge capabilities:check <role> ...` to validate a tool, MCP, command, filesystem, or network boundary before changing agent frontmatter. Custom forks can extend the policy, but keep it aligned with `.opencode/agents/` and the routing rules in `iso/instructions.md`.
147
+ Role capability boundaries live in `templates/capabilities.json` and are enforced locally by `@agent-pattern-labs/iso-capabilities`. Use `job-forge capabilities:explain <role>` to inspect a role and `job-forge capabilities:check <role> ...` to validate a tool, MCP, command, filesystem, or network boundary before changing agent frontmatter. Custom forks can extend the policy, but keep it aligned with `.opencode/agents/` and the routing rules in `iso/instructions.md`.
148
148
 
149
149
  ## JobForge context bundles
150
150
 
151
- Mode/reference context bundles live in `templates/context.json` and are planned locally by `@razroo/iso-context`. Use `job-forge context:plan <mode>` to see the files and estimated tokens, `job-forge context:check <mode>` to fail on budget drift, and `job-forge context:render <mode>` when you intentionally need a compact markdown or JSON context bundle. This is not an MCP and does not add tool-schema tokens; rendered context only consumes prompt tokens when a workflow deliberately asks for it.
151
+ Mode/reference context bundles live in `templates/context.json` and are planned locally by `@agent-pattern-labs/iso-context`. Use `job-forge context:plan <mode>` to see the files and estimated tokens, `job-forge context:check <mode>` to fail on budget drift, and `job-forge context:render <mode>` when you intentionally need a compact markdown or JSON context bundle. This is not an MCP and does not add tool-schema tokens; rendered context only consumes prompt tokens when a workflow deliberately asks for it.
152
152
 
153
153
  ## JobForge artifact index
154
154
 
155
- Artifact lookup policy lives in `templates/index.json` and is built locally by `@razroo/iso-index`. Use `job-forge index:has --key "company-role:acme:staff-engineer"` as a cheap duplicate/source prefilter, `job-forge index:query "acme"` to get compact source path/line pointers, and `job-forge index:verify` to validate `.jobforge-index.json`. Query, has, and verify rebuild the index on demand, so scaffolded projects need no setup. JobForge canonicalizes company/role and URL records through `templates/canon.json` before writing the index. This is not an MCP and does not add tool-schema tokens.
155
+ Artifact lookup policy lives in `templates/index.json` and is built locally by `@agent-pattern-labs/iso-index`. Use `job-forge index:has --key "company-role:acme:staff-engineer"` as a cheap duplicate/source prefilter, `job-forge index:query "acme"` to get compact source path/line pointers, and `job-forge index:verify` to validate `.jobforge-index.json`. Query, has, and verify rebuild the index on demand, so scaffolded projects need no setup. JobForge canonicalizes company/role and URL records through `templates/canon.json` before writing the index. This is not an MCP and does not add tool-schema tokens.
156
156
 
157
157
  ## JobForge materialized facts
158
158
 
159
- Fact extraction policy lives in `templates/facts.json` and is built locally by `@razroo/iso-facts`. Use `job-forge facts:query --fact job.url`, `job-forge facts:has --fact application.status --key "company-role:acme:staff-engineer"`, and `job-forge facts:verify` to work with compact source-backed facts instead of rereading reports, tracker day files, TSVs, candidate JSON, scan history, and ledger events. Query, has, verify, and check rebuild `.jobforge-facts.json` on demand, so scaffolded projects need no setup. JobForge canonicalizes company/role and URL fact keys through `templates/canon.json` before writing the fact set. This is not an MCP and does not add prompt or tool-schema tokens.
159
+ Fact extraction policy lives in `templates/facts.json` and is built locally by `@agent-pattern-labs/iso-facts`. Use `job-forge facts:query --fact job.url`, `job-forge facts:has --fact application.status --key "company-role:acme:staff-engineer"`, and `job-forge facts:verify` to work with compact source-backed facts instead of rereading reports, tracker day files, TSVs, candidate JSON, scan history, and ledger events. Query, has, verify, and check rebuild `.jobforge-facts.json` on demand, so scaffolded projects need no setup. JobForge canonicalizes company/role and URL fact keys through `templates/canon.json` before writing the fact set. This is not an MCP and does not add prompt or tool-schema tokens.
160
160
 
161
161
  ## JobForge timeline policy
162
162
 
163
- Follow-up and next-action policy lives in `templates/timeline.json` and is planned locally by `@razroo/iso-timeline`. Use `job-forge timeline:due` to list due/overdue nudges, `job-forge timeline:check --fail-on overdue` to fail only when action is stale, and `job-forge timeline:build` to materialize `.jobforge-timeline-events.jsonl` plus `.jobforge-timeline.json` for inspection. It reads tracker rows and dated pipeline items from local files, so scaffolded projects need no setup. This is not an MCP and does not add prompt or tool-schema tokens.
163
+ Follow-up and next-action policy lives in `templates/timeline.json` and is planned locally by `@agent-pattern-labs/iso-timeline`. Use `job-forge timeline:due` to list due/overdue nudges, `job-forge timeline:check --fail-on overdue` to fail only when action is stale, and `job-forge timeline:build` to materialize `.jobforge-timeline-events.jsonl` plus `.jobforge-timeline.json` for inspection. It reads tracker rows and dated pipeline items from local files, so scaffolded projects need no setup. This is not an MCP and does not add prompt or tool-schema tokens.
164
164
 
165
165
  ## JobForge priority queue
166
166
 
167
- Next-action ranking policy lives in `templates/prioritize.json` and is planned locally by `@razroo/iso-prioritize`. Use `job-forge prioritize:build` to materialize `.jobforge-prioritize-items.json` plus `.jobforge-prioritize.json`, `job-forge prioritize:select --limit 3` to inspect the selected queue, and `job-forge prioritize:check` when a workflow must fail if no actionable candidate is selected. It reads source-backed facts and due timeline items, so scaffolded projects need no setup. This is not an MCP and does not add prompt or tool-schema tokens.
167
+ Next-action ranking policy lives in `templates/prioritize.json` and is planned locally by `@agent-pattern-labs/iso-prioritize`. Use `job-forge prioritize:build` to materialize `.jobforge-prioritize-items.json` plus `.jobforge-prioritize.json`, `job-forge prioritize:select --limit 3` to inspect the selected queue, and `job-forge prioritize:check` when a workflow must fail if no actionable candidate is selected. It reads source-backed facts and due timeline items, so scaffolded projects need no setup. This is not an MCP and does not add prompt or tool-schema tokens.
168
168
 
169
169
  ## JobForge artifact lineage
170
170
 
171
- Artifact lineage lives in `.jobforge-lineage.json` and is checked locally by `@razroo/iso-lineage`. Use `job-forge lineage:record --artifact <report-or-pdf> --input cv.md --input config/profile.yml` after generating an artifact, then `job-forge lineage:check` or `job-forge lineage:check --artifact <file>` to detect stale outputs after source inputs change. This is not an MCP and does not add prompt or tool-schema tokens.
171
+ Artifact lineage lives in `.jobforge-lineage.json` and is checked locally by `@agent-pattern-labs/iso-lineage`. Use `job-forge lineage:record --artifact <report-or-pdf> --input cv.md --input config/profile.yml` after generating an artifact, then `job-forge lineage:check` or `job-forge lineage:check --artifact <file>` to detect stale outputs after source inputs change. This is not an MCP and does not add prompt or tool-schema tokens.
172
172
 
173
173
  ## JobForge scoring policy
174
174
 
175
- Weighted scoring policy lives in `templates/score.json` and is enforced locally by `@razroo/iso-score`. Use `job-forge score:check --input <score.json>` to validate emitted report score JSON, `job-forge score:gate --input <score.json> --gate apply` to check an application threshold, and `job-forge score:explain` to inspect the active dimensions, weights, bands, and gates. Custom forks can change weights or thresholds in `templates/score.json`, but keep the dimension ids aligned with `modes/_shared.md` and report rendering.
175
+ Weighted scoring policy lives in `templates/score.json` and is enforced locally by `@agent-pattern-labs/iso-score`. Use `job-forge score:check --input <score.json>` to validate emitted report score JSON, `job-forge score:gate --input <score.json> --gate apply` to check an application threshold, and `job-forge score:explain` to inspect the active dimensions, weights, bands, and gates. Custom forks can change weights or thresholds in `templates/score.json`, but keep the dimension ids aligned with `modes/_shared.md` and report rendering.
176
176
 
177
177
  ## JobForge identity canonicalization
178
178
 
179
- URL, company, role, and company+role identity rules live in `templates/canon.json` and are enforced locally by `@razroo/iso-canon`. Use `job-forge canon:key company-role --company "OpenAI, Inc." --role "Senior SWE, AI Platform"` to derive the same duplicate key used by ledger/index helpers, and `job-forge canon:compare company "OpenAI, Inc." "Open AI"` to explain whether two values resolve to the same entity. Custom forks can extend aliases, suffixes, stop words, and match thresholds in `templates/canon.json`. This is not an MCP and does not add prompt or tool-schema tokens.
179
+ URL, company, role, and company+role identity rules live in `templates/canon.json` and are enforced locally by `@agent-pattern-labs/iso-canon`. Use `job-forge canon:key company-role --company "OpenAI, Inc." --role "Senior SWE, AI Platform"` to derive the same duplicate key used by ledger/index helpers, and `job-forge canon:compare company "OpenAI, Inc." "Open AI"` to explain whether two values resolve to the same entity. Custom forks can extend aliases, suffixes, stop words, and match thresholds in `templates/canon.json`. This is not an MCP and does not add prompt or tool-schema tokens.
180
180
 
181
181
  ## JobForge preflight plans
182
182
 
183
- Application dispatch policy lives in `templates/preflight.json` and is planned locally by `@razroo/iso-preflight`. After candidate facts and gate results have been materialized into JSON, use `job-forge preflight:plan --candidates <file>` to get bounded rounds and required pre/post steps, or `job-forge preflight:check --candidates <file>` to fail on missing source facts or blocked gates. This is not an MCP and does not add prompt or tool-schema tokens; it consumes only the candidate JSON you deliberately pass to it.
183
+ Application dispatch policy lives in `templates/preflight.json` and is planned locally by `@agent-pattern-labs/iso-preflight`. After candidate facts and gate results have been materialized into JSON, use `job-forge preflight:plan --candidates <file>` to get bounded rounds and required pre/post steps, or `job-forge preflight:check --candidates <file>` to fail on missing source facts or blocked gates. This is not an MCP and does not add prompt or tool-schema tokens; it consumes only the candidate JSON you deliberately pass to it.
184
184
 
185
185
  ## JobForge postflight settlement
186
186
 
187
- Application settlement policy lives in `templates/postflight.json` and is checked locally by `@razroo/iso-postflight`. After each dispatch round, record observed candidate outcomes and tracker TSV artifact paths in `batch/postflight-outcomes.json`, then run `job-forge postflight:status --plan batch/preflight-plan.json --outcomes batch/postflight-outcomes.json` to get the next safe action. After `merge` and `verify`, add post-step observations and run `job-forge postflight:check ...` to fail unless the workflow is complete. This is not an MCP and does not add prompt or tool-schema tokens.
187
+ Application settlement policy lives in `templates/postflight.json` and is checked locally by `@agent-pattern-labs/iso-postflight`. After each dispatch round, record observed candidate outcomes and tracker TSV artifact paths in `batch/postflight-outcomes.json`, then run `job-forge postflight:status --plan batch/preflight-plan.json --outcomes batch/postflight-outcomes.json` to get the next safe action. After `merge` and `verify`, add post-step observations and run `job-forge postflight:check ...` to fail unless the workflow is complete. This is not an MCP and does not add prompt or tool-schema tokens.
188
188
 
189
189
  ## JobForge redaction policy
190
190
 
191
- Safe-export redaction rules live in `templates/redact.json` and are enforced locally by `@razroo/iso-redact`. Use `job-forge redact:scan --input <file>` before sharing traces, prompts, reports, or fixtures outside the project, `job-forge redact:apply --input <file> --output .jobforge-redacted/<file>` to write a sanitized copy, and `job-forge redact:verify --input <file>` to fail if secrets or configured PII remain. Findings never print matched values. This is not an MCP and does not add prompt or tool-schema tokens.
191
+ Safe-export redaction rules live in `templates/redact.json` and are enforced locally by `@agent-pattern-labs/iso-redact`. Use `job-forge redact:scan --input <file>` before sharing traces, prompts, reports, or fixtures outside the project, `job-forge redact:apply --input <file> --output .jobforge-redacted/<file>` to write a sanitized copy, and `job-forge redact:verify --input <file>` to fail if secrets or configured PII remain. Findings never print matched values. This is not an MCP and does not add prompt or tool-schema tokens.
192
192
 
193
193
  ## JobForge consumer migrations
194
194
 
195
- Consumer-project migrations live in `templates/migrations.json` and are applied locally by `@razroo/iso-migrate`. `job-forge sync` applies safe migrations automatically after refreshing symlinks; use `JOB_FORGE_SKIP_MIGRATIONS=1` to opt out. Use `job-forge migrate:plan`, `job-forge migrate:apply`, and `job-forge migrate:check` to inspect or enforce script/gitignore drift explicitly. This is not an MCP and does not add prompt or tool-schema tokens.
195
+ Consumer-project migrations live in `templates/migrations.json` and are applied locally by `@agent-pattern-labs/iso-migrate`. `job-forge sync` applies safe migrations automatically after refreshing symlinks; use `JOB_FORGE_SKIP_MIGRATIONS=1` to opt out. Use `job-forge migrate:plan`, `job-forge migrate:apply`, and `job-forge migrate:check` to inspect or enforce script/gitignore drift explicitly. This is not an MCP and does not add prompt or tool-schema tokens.
196
196
 
197
197
  ## JobForge guard audits
198
198
 
199
- Guard audits run deterministic `@razroo/iso-guard` policies over the same local traces. The default policy lives at `templates/guards/jobforge-baseline.yaml` and checks rules that are reliable from transcript data, including max two OpenCode `task` dispatches per assistant message, no task-status polling via `task`, no raw proxy configuration in task prompts, and no child session task recursion.
199
+ Guard audits run deterministic `@agent-pattern-labs/iso-guard` policies over the same local traces. The default policy lives at `templates/guards/jobforge-baseline.yaml` and checks rules that are reliable from transcript data, including max two OpenCode `task` dispatches per assistant message, no task-status polling via `task`, no raw proxy configuration in task prompts, and no child session task recursion.
200
200
 
201
201
  ```bash
202
202
  npx job-forge guard:audit
@@ -208,13 +208,13 @@ Use `--policy <path>` to audit with a custom policy. This does not add prompt, t
208
208
 
209
209
  **Where Claude Code writes JSONL:** `~/.claude/projects/<encoded-cwd>/*.jsonl`.
210
210
 
211
- **Direct CLI fallback:** `npx -y @razroo/iso-trace@latest stats --source "$HOME/.claude/projects/<encoded-dir>/<session>.jsonl"`
211
+ **Direct CLI fallback:** `npx -y @agent-pattern-labs/iso-trace@latest stats --source "$HOME/.claude/projects/<encoded-dir>/<session>.jsonl"`
212
212
 
213
213
  **Performance:** JobForge narrows discovery to project-local roots where possible, but raw `iso-trace list --cwd /path/to/repo` may still walk large transcript trees on busy machines. Prefer `stats --source <one.jsonl>` or project-scoped roots when you need direct `iso-trace` usage.
214
214
 
215
215
  ## States (templates/states.yml)
216
216
 
217
- The canonical states rarely need changing. Since `templates/` is a symlink into the harness in consumer projects, adding new states means contributing back to `razroo/JobForge` (see [CONTRIBUTING.md](../CONTRIBUTING.md)). If you're working in the harness repo directly (Path B), update:
217
+ The canonical states rarely need changing. Since `templates/` is a symlink into the harness in consumer projects, adding new states means contributing back to `Agent-Pattern-Labs/JobForge` (see [CONTRIBUTING.md](../CONTRIBUTING.md)). If you're working in the harness repo directly (Path B), update:
218
218
 
219
219
  1. `templates/states.yml`
220
220
  2. `normalize-statuses.mjs` (alias mappings)
package/docs/README.md CHANGED
@@ -9,7 +9,7 @@ JobForge ships on npm as [`job-forge`](https://www.npmjs.com/package/job-forge)
9
9
  | Path | Who it's for | How |
10
10
  |------|--------------|-----|
11
11
  | **A — Scaffold a personal project** | Most users. You want a job search project with the harness in `node_modules`, updatable via `npm update job-forge`. | `npx --package=job-forge create-job-forge my-search && cd my-search && npm install` |
12
- | **B — Clone the harness directly** | Contributors and hackers working on `iso/`, modes, scripts, or the scoring model. Personal files are gitignored. | `git clone https://github.com/razroo/JobForge.git && cd JobForge && npm install && npm run build:config` |
12
+ | **B — Clone the harness directly** | Contributors and hackers working on `iso/`, modes, scripts, or the scoring model. Personal files are gitignored. | `git clone https://github.com/Agent-Pattern-Labs/JobForge.git && cd JobForge && npm install && npm run build:config` |
13
13
 
14
14
  See [SETUP.md](SETUP.md) for both paths.
15
15
 
package/docs/SETUP.md CHANGED
@@ -59,7 +59,7 @@ Or simpler, via the scaffolded script: `npm run update-harness` (also refreshes
59
59
  Use this if you want to hack on the harness itself (edit `iso/`, tune the scoring model, add modes, contribute back). Personal files are gitignored.
60
60
 
61
61
  ```bash
62
- git clone https://github.com/razroo/JobForge.git
62
+ git clone https://github.com/Agent-Pattern-Labs/JobForge.git
63
63
  cd JobForge
64
64
  npm install
65
65
  npm run build:config # regenerate per-harness trees from iso/ (CLAUDE.md,
@@ -214,7 +214,7 @@ Use it to identify which sessions or models are consuming the most tokens. The `
214
214
  `sync-check` requires `cv.md` and `config/profile.yml` with the fields checked in `cv-sync-check.mjs`. Until you finish the profile and CV steps, that is normal.
215
215
 
216
216
  **PDF generation fails**
217
- The scaffolded `opencode.json` already registers Geometra MCP; if it's not running, check `opencode mcp list` and verify the scaffolded config under the `mcp.geometra` key — its `command` MUST be `["npx", "-y", "@geometra/mcp@1.61.3"]` and `enabled: true`. Geometra manages Chromium via its built-in proxy. JobForge passes `stealth: true` for portal sessions so Geometra launches CloakBrowser's patched Chromium. For standalone CLI usage (outside opencode), `generate-pdf.mjs` also works with standalone Playwright/Chromium — install with `npx playwright install chromium`.
217
+ The scaffolded `opencode.json` already registers Geometra MCP; if it's not running, check `opencode mcp list` and verify the scaffolded config under the `mcp.geometra` key — its `command` MUST be `["npx", "--no-install", "job-forge", "mcp:geometra"]`, `enabled: true`, and its `environment` should include `GEOMETRA_STEALTH=1` (or equivalently `GEOMETRA_BROWSER=stealth`) so proxy-backed portal sessions default to CloakBrowser's patched Chromium. `job-forge mcp:geometra` prefers `JOB_FORGE_GEOMETRA_MCP_PATH` when set, otherwise a sibling `../geometra/mcp/dist/index.js` checkout for local JobForge development, and otherwise falls back to the pinned npm package. Geometra manages Chromium via its built-in proxy. JobForge still passes `stealth: true` for portal sessions explicitly; the env block keeps the default aligned for auto-spawned sessions and local debugging. For standalone CLI usage (outside opencode), `generate-pdf.mjs` also works with standalone Playwright/Chromium — install with `npx playwright install chromium`.
218
218
 
219
219
  **Symlinks are missing or pointing to a stale path**
220
220
  Run `npx job-forge sync` (or `npm run sync`) to recreate them. This happens if you move the project directory after installing, or if `postinstall` didn't run (rare — check `npm install` output for errors).
@@ -236,4 +236,4 @@ Paths are relative to the project root: create the markdown file under `jds/` an
236
236
 
237
237
  ## Contributing
238
238
 
239
- Pull requests and issue reports are welcome on `razroo/JobForge`. See [CONTRIBUTING.md](../CONTRIBUTING.md) for branch workflow, ideas (documentation, `examples/`, `templates/portals.example.yml`, dashboard features, utility scripts), and the checks maintainers expect before a PR (`npm run verify` and `npm run build:dashboard`). Contributors work against Path B (clone the harness directly).
239
+ Pull requests and issue reports are welcome on `Agent-Pattern-Labs/JobForge`. See [CONTRIBUTING.md](../CONTRIBUTING.md) for branch workflow, ideas (documentation, `examples/`, `templates/portals.example.yml`, dashboard features, utility scripts), and the checks maintainers expect before a PR (`npm run verify` and `npm run build:dashboard`). Contributors work against Path B (clone the harness directly).
@@ -51,7 +51,7 @@ AI-powered job search pipeline: scans portals, evaluates offers, generates CVs v
51
51
  - [D6] Pick the mode from the **Routing** table below AND name it explicitly in your first response (e.g., "running auto-pipeline mode", "this is a `compare` request"). If no row matches the user's intent, ask which mode fits; do not guess.
52
52
  why: silent mode picks mis-route work (a "negotiation" question answered in `offer` mode produces the wrong report shape); naming the mode out loud makes the routing decision reviewable and gives downstream dispatches a reliable anchor
53
53
 
54
- - [D7] For standalone `batch` runs, prefer `batch/batch-runner.sh` instead of hand-rolling the loop. It delegates to `@razroo/iso-orchestrator`, persists workflow records in `.jobforge-runs/`, caps bundle fan-out, and mutexes state/report-number writes. Use `JOBFORGE_LEGACY_BATCH_RUNNER=1` only as a fallback.
54
+ - [D7] For standalone `batch` runs, prefer `batch/batch-runner.sh` instead of hand-rolling the loop. It delegates to `@agent-pattern-labs/iso-orchestrator`, persists workflow records in `.jobforge-runs/`, caps bundle fan-out, and mutexes state/report-number writes. Use `JOBFORGE_LEGACY_BATCH_RUNNER=1` only as a fallback.
55
55
  why: the old Bash loop encoded resumability and parallelism manually; the iso-orchestrator path makes the durable control state inspectable and prevents report-number collisions under parallel bundles
56
56
 
57
57
  - [D8] Use deterministic local helpers instead of prose when they can answer or validate state, identity, policy, scoring, timing, dispatch, priority, lineage, migration, or safe-export questions. Read `modes/reference-local-helpers.md` when choosing a helper or changing helper wiring.
package/iso/mcp.json CHANGED
@@ -2,7 +2,11 @@
2
2
  "servers": {
3
3
  "geometra": {
4
4
  "command": "npx",
5
- "args": ["-y", "@geometra/mcp@1.61.3"]
5
+ "args": ["--no-install", "job-forge", "mcp:geometra"],
6
+ "env": {
7
+ "GEOMETRA_STEALTH": "1",
8
+ "GEOMETRA_BROWSER": "stealth"
9
+ }
6
10
  },
7
11
  "gmail": {
8
12
  "command": "npx",
@@ -9,7 +9,7 @@ import {
9
9
  readCacheContent,
10
10
  resolveCacheDir,
11
11
  verifyCache,
12
- } from '@razroo/iso-cache';
12
+ } from '@agent-pattern-labs/iso-cache';
13
13
  import { canonicalizeJobForgeUrl } from './jobforge-canon.mjs';
14
14
 
15
15
  export const CACHE_DIR = '.jobforge-cache';
@@ -10,7 +10,7 @@ import {
10
10
  loadCanonConfig,
11
11
  parseJson,
12
12
  resolveProfile,
13
- } from '@razroo/iso-canon';
13
+ } from '@agent-pattern-labs/iso-canon';
14
14
 
15
15
  export const CANON_CONFIG_FILE = 'templates/canon.json';
16
16
  export const CANON_PROFILE = 'jobforge';
@@ -9,7 +9,7 @@ import {
9
9
  renderRole,
10
10
  resolveRole,
11
11
  roleNames,
12
- } from '@razroo/iso-capabilities';
12
+ } from '@agent-pattern-labs/iso-capabilities';
13
13
 
14
14
  const __dirname = dirname(fileURLToPath(import.meta.url));
15
15
  const PKG_ROOT = resolve(__dirname, '..');
@@ -9,7 +9,7 @@ import {
9
9
  planContext,
10
10
  renderContextPlan,
11
11
  resolveContextBundle,
12
- } from '@razroo/iso-context';
12
+ } from '@agent-pattern-labs/iso-context';
13
13
 
14
14
  const __dirname = dirname(fileURLToPath(import.meta.url));
15
15
  const PKG_ROOT = resolve(__dirname, '..');
@@ -10,7 +10,7 @@ import {
10
10
  parseRecord,
11
11
  renderRecord,
12
12
  validateRecord,
13
- } from '@razroo/iso-contract';
13
+ } from '@agent-pattern-labs/iso-contract';
14
14
  import { DEFAULT_STATES, loadCanonicalStates } from './canonical-states.mjs';
15
15
 
16
16
  const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -9,7 +9,7 @@ import {
9
9
  parseJson,
10
10
  queryFacts,
11
11
  verifyFactSet,
12
- } from '@razroo/iso-facts';
12
+ } from '@agent-pattern-labs/iso-facts';
13
13
  import {
14
14
  jobForgeCompanyRoleKey,
15
15
  jobForgeUrlKey,
@@ -8,7 +8,7 @@ import {
8
8
  queryIndex,
9
9
  recordId,
10
10
  verifyIndex,
11
- } from '@razroo/iso-index';
11
+ } from '@agent-pattern-labs/iso-index';
12
12
  import {
13
13
  jobForgeCompanyRoleKey,
14
14
  jobForgeUrlKey,
@@ -7,7 +7,7 @@ import {
7
7
  queryEvents,
8
8
  readLedger,
9
9
  verifyLedger,
10
- } from '@razroo/iso-ledger';
10
+ } from '@agent-pattern-labs/iso-ledger';
11
11
  import {
12
12
  jobForgeApplicationSubject,
13
13
  jobForgeCompanyRoleKey,
@@ -7,7 +7,7 @@ import {
7
7
  parseJson,
8
8
  recordLineage,
9
9
  verifyLineageGraph,
10
- } from '@razroo/iso-lineage';
10
+ } from '@agent-pattern-labs/iso-lineage';
11
11
 
12
12
  export const LINEAGE_FILE = '.jobforge-lineage.json';
13
13
 
@@ -4,7 +4,7 @@ import {
4
4
  loadMigrationConfig,
5
5
  parseJson,
6
6
  runMigrations,
7
- } from '@razroo/iso-migrate';
7
+ } from '@agent-pattern-labs/iso-migrate';
8
8
 
9
9
  export const MIGRATION_CONFIG_FILE = 'templates/migrations.json';
10
10
 
@@ -14,7 +14,7 @@ import {
14
14
  refFromPath,
15
15
  sessionRefsFromOpenCodeRows,
16
16
  stats as traceStats,
17
- } from '@razroo/iso-trace';
17
+ } from '@agent-pattern-labs/iso-trace';
18
18
 
19
19
  export const DISPATCH_TOOL_NAMES = new Set(['task', 'spawn_agent']);
20
20
 
@@ -4,7 +4,7 @@ import {
4
4
  loadPostflightConfig,
5
5
  parseJson,
6
6
  settlePostflight,
7
- } from '@razroo/iso-postflight';
7
+ } from '@agent-pattern-labs/iso-postflight';
8
8
 
9
9
  export const POSTFLIGHT_CONFIG_FILE = 'templates/postflight.json';
10
10
  export const POSTFLIGHT_WORKFLOW = 'jobforge.apply';
@@ -4,7 +4,7 @@ import {
4
4
  loadPreflightConfig,
5
5
  parseJson,
6
6
  planPreflight,
7
- } from '@razroo/iso-preflight';
7
+ } from '@agent-pattern-labs/iso-preflight';
8
8
 
9
9
  export const PREFLIGHT_CONFIG_FILE = 'templates/preflight.json';
10
10
  export const PREFLIGHT_WORKFLOW = 'jobforge.apply';
@@ -7,7 +7,7 @@ import {
7
7
  prioritize,
8
8
  selectPrioritized,
9
9
  verifyPrioritizeResult,
10
- } from '@razroo/iso-prioritize';
10
+ } from '@agent-pattern-labs/iso-prioritize';
11
11
  import { ensureJobForgeFacts } from './jobforge-facts.mjs';
12
12
  import { dueJobForgeTimeline } from './jobforge-timeline.mjs';
13
13
 
@@ -3,7 +3,7 @@ import { join } from 'path';
3
3
  import {
4
4
  loadRedactConfig,
5
5
  parseJson,
6
- } from '@razroo/iso-redact';
6
+ } from '@agent-pattern-labs/iso-redact';
7
7
 
8
8
  export const REDACT_CONFIG_FILE = 'templates/redact.json';
9
9
 
@@ -8,7 +8,7 @@ import {
8
8
  parseJson,
9
9
  scoreResultId,
10
10
  verifyScoreResult,
11
- } from '@razroo/iso-score';
11
+ } from '@agent-pattern-labs/iso-score';
12
12
 
13
13
  export const SCORE_CONFIG_FILE = 'templates/score.json';
14
14
  export const SCORE_PROFILE = 'jobforge';
@@ -8,7 +8,7 @@ import {
8
8
  parseJsonLines,
9
9
  planTimeline,
10
10
  verifyTimelineResult,
11
- } from '@razroo/iso-timeline';
11
+ } from '@agent-pattern-labs/iso-timeline';
12
12
  import { DATA_APPS_DIR, PROJECT_DIR, readAllEntries } from '../tracker-lib.mjs';
13
13
  import { jobForgeCompanyRoleKey, jobForgeUrlKey, legacyCompanyRoleKey, legacyUrlKey } from './jobforge-canon.mjs';
14
14
 
package/models.yaml CHANGED
@@ -1,6 +1,6 @@
1
1
  # JobForge model policy.
2
2
  #
3
- # Extends @razroo/iso-route's bundled "standard" preset, then pins every
3
+ # Extends @agent-pattern-labs/iso-route's bundled "standard" preset, then pins every
4
4
  # OpenCode route to DeepSeek V4 Flash. Recent traces showed free OpenRouter
5
5
  # routes freezing or falling through Venice balance errors, so JobForge's
6
6
  # OpenCode default is now "best affordable paid" rather than "free".
package/modes/batch.md CHANGED
@@ -68,7 +68,7 @@ batch/batch-runner.sh [OPTIONS]
68
68
  ```
69
69
 
70
70
  `batch-runner.sh` delegates to `scripts/batch-orchestrator.mjs` by default.
71
- That Node runner uses `@razroo/iso-orchestrator` to persist workflow records in
71
+ That Node runner uses `@agent-pattern-labs/iso-orchestrator` to persist workflow records in
72
72
  `.jobforge-runs/`, cap bundle fan-out with `workflow.forEach`, and serialize
73
73
  report-number/state writes while workers run in parallel. If a regression
74
74
  requires the old shell loop, run with `JOBFORGE_LEGACY_BATCH_RUNNER=1`.
@@ -128,7 +128,7 @@ The Geometra MCP partitions its reusable-proxy pool by proxy identity and browse
128
128
  "geometra": {
129
129
  "type": "stdio",
130
130
  "command": "npx",
131
- "args": ["-y", "@geometra/mcp@1.61.3"]
131
+ "args": ["--no-install", "job-forge", "mcp:geometra"]
132
132
  },
133
133
  "gmail": {
134
134
  "type": "stdio",
@@ -139,4 +139,6 @@ The Geometra MCP partitions its reusable-proxy pool by proxy identity and browse
139
139
  }
140
140
  ```
141
141
 
142
+ `job-forge mcp:geometra` resolves Geometra in this order: `JOB_FORGE_GEOMETRA_MCP_PATH` if set, then a sibling local `../geometra/mcp/dist/index.js` checkout for maintainers working across both repos, then the pinned npm fallback.
143
+
142
144
  To check or modify MCP settings, edit `opencode.json` in the project root.
@@ -118,7 +118,7 @@ Prefer the deterministic helper:
118
118
  npx job-forge tracker-line --num 521 --date 2026-04-15 --company "Anthropic" --role "Manager, FDE" --status Evaluated --score 4.2 --pdf no --slug anthropic-manager-fde --notes "Strong fit" --write
119
119
  ```
120
120
 
121
- The helper renders and validates the row against `templates/contracts.json` via `@razroo/iso-contract`. To inspect the contract directly:
121
+ The helper renders and validates the row against `templates/contracts.json` via `@agent-pattern-labs/iso-contract`. To inspect the contract directly:
122
122
 
123
123
  ```bash
124
124
  npx iso-contract explain jobforge.tracker-row --contracts templates/contracts.json
package/opencode.json CHANGED
@@ -17,10 +17,14 @@
17
17
  "type": "local",
18
18
  "command": [
19
19
  "npx",
20
- "-y",
21
- "@geometra/mcp@1.61.3"
20
+ "--no-install",
21
+ "job-forge",
22
+ "mcp:geometra"
22
23
  ],
23
- "environment": {}
24
+ "environment": {
25
+ "GEOMETRA_STEALTH": "1",
26
+ "GEOMETRA_BROWSER": "stealth"
27
+ }
24
28
  },
25
29
  "gmail": {
26
30
  "type": "local",