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.
- package/.codex/config.toml +3 -2
- package/.cursor/mcp.json +8 -3
- package/.cursor/rules/main.mdc +1 -1
- package/.mcp.json +8 -3
- package/AGENTS.md +1 -1
- package/CLAUDE.md +1 -1
- package/README.md +143 -191
- package/batch/README.md +1 -1
- package/bin/create-job-forge.mjs +8 -4
- package/bin/geometra-mcp-launcher.mjs +86 -0
- package/bin/job-forge.mjs +3 -0
- package/bin/sync.mjs +1 -1
- package/docs/ARCHITECTURE.md +20 -20
- package/docs/CUSTOMIZATION.md +20 -20
- package/docs/README.md +1 -1
- package/docs/SETUP.md +3 -3
- package/iso/instructions.md +1 -1
- package/iso/mcp.json +5 -1
- package/lib/jobforge-cache.mjs +1 -1
- package/lib/jobforge-canon.mjs +1 -1
- package/lib/jobforge-capabilities.mjs +1 -1
- package/lib/jobforge-context.mjs +1 -1
- package/lib/jobforge-contracts.mjs +1 -1
- package/lib/jobforge-facts.mjs +1 -1
- package/lib/jobforge-index.mjs +1 -1
- package/lib/jobforge-ledger.mjs +1 -1
- package/lib/jobforge-lineage.mjs +1 -1
- package/lib/jobforge-migrate.mjs +1 -1
- package/lib/jobforge-observability.mjs +1 -1
- package/lib/jobforge-postflight.mjs +1 -1
- package/lib/jobforge-preflight.mjs +1 -1
- package/lib/jobforge-prioritize.mjs +1 -1
- package/lib/jobforge-redact.mjs +1 -1
- package/lib/jobforge-score.mjs +1 -1
- package/lib/jobforge-timeline.mjs +1 -1
- package/models.yaml +1 -1
- package/modes/batch.md +1 -1
- package/modes/reference-portals.md +3 -1
- package/modes/reference-setup.md +1 -1
- package/opencode.json +7 -3
- package/package.json +26 -26
- package/scripts/batch-orchestrator.mjs +2 -2
- package/scripts/cache.mjs +1 -1
- package/scripts/canon.mjs +1 -1
- package/scripts/check-helper-integration.mjs +19 -19
- package/scripts/facts.mjs +1 -1
- package/scripts/guard.mjs +1 -1
- package/scripts/index.mjs +1 -1
- package/scripts/ledger.mjs +1 -1
- package/scripts/lineage.mjs +1 -1
- package/scripts/migrate.mjs +1 -1
- package/scripts/postflight.mjs +1 -1
- package/scripts/preflight.mjs +1 -1
- package/scripts/prioritize.mjs +1 -1
- package/scripts/redact.mjs +1 -1
- package/scripts/score.mjs +1 -1
- package/scripts/timeline.mjs +1 -1
- package/scripts/trace.mjs +1 -1
- 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
package/docs/ARCHITECTURE.md
CHANGED
|
@@ -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, `
|
|
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
|
-
`@
|
|
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 `
|
|
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 `@
|
|
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 `@
|
|
254
|
-
| `scripts/ledger.mjs` | `npx job-forge ledger:status` / `ledger:has` / `ledger:rebuild` | Deterministic `@
|
|
255
|
-
| `scripts/capabilities.mjs` | `npx job-forge capabilities:check` / `capabilities:explain` | Deterministic `@
|
|
256
|
-
| `scripts/cache.mjs` | `npx job-forge cache:has` / `cache:get` / `cache:put` | Deterministic `@
|
|
257
|
-
| `scripts/index.mjs` | `npx job-forge index:status` / `index:has` / `index:query` | Deterministic `@
|
|
258
|
-
| `scripts/facts.mjs` | `npx job-forge facts:status` / `facts:has` / `facts:query` | Deterministic `@
|
|
259
|
-
| `scripts/timeline.mjs` | `npx job-forge timeline:due` / `timeline:check` / `timeline:build` | Deterministic `@
|
|
260
|
-
| `scripts/prioritize.mjs` | `npx job-forge prioritize:build` / `prioritize:select` / `prioritize:check` | Deterministic `@
|
|
261
|
-
| `scripts/lineage.mjs` | `npx job-forge lineage:record` / `lineage:check` / `lineage:explain` | Deterministic `@
|
|
262
|
-
| `scripts/score.mjs` | `npx job-forge score:check` / `score:gate` / `score:explain` | Deterministic `@
|
|
263
|
-
| `scripts/canon.mjs` | `npx job-forge canon:normalize` / `canon:key` / `canon:compare` | Deterministic `@
|
|
264
|
-
| `scripts/context.mjs` | `npx job-forge context:list` / `context:plan` / `context:check` / `context:render` | Deterministic `@
|
|
265
|
-
| `scripts/preflight.mjs` | `npx job-forge preflight:plan` / `preflight:check` / `preflight:explain` | Deterministic `@
|
|
266
|
-
| `scripts/postflight.mjs` | `npx job-forge postflight:status` / `postflight:check` / `postflight:explain` | Deterministic `@
|
|
267
|
-
| `scripts/redact.mjs` | `npx job-forge redact:scan` / `redact:apply` / `redact:verify` | Deterministic `@
|
|
268
|
-
| `scripts/migrate.mjs` | `npx job-forge migrate:plan` / `migrate:apply` / `migrate:check` | Deterministic `@
|
|
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`) |
|
package/docs/CUSTOMIZATION.md
CHANGED
|
@@ -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 `
|
|
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 [`@
|
|
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 `@
|
|
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 `@
|
|
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 `@
|
|
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 `@
|
|
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 `@
|
|
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 `@
|
|
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 `@
|
|
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 `@
|
|
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 `@
|
|
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 `@
|
|
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 `@
|
|
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 `@
|
|
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 `@
|
|
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 `@
|
|
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 `@
|
|
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 `@
|
|
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 @
|
|
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 `
|
|
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/
|
|
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/
|
|
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", "-
|
|
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 `
|
|
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).
|
package/iso/instructions.md
CHANGED
|
@@ -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 `@
|
|
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": ["-
|
|
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",
|
package/lib/jobforge-cache.mjs
CHANGED
package/lib/jobforge-canon.mjs
CHANGED
package/lib/jobforge-context.mjs
CHANGED
|
@@ -10,7 +10,7 @@ import {
|
|
|
10
10
|
parseRecord,
|
|
11
11
|
renderRecord,
|
|
12
12
|
validateRecord,
|
|
13
|
-
} from '@
|
|
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));
|
package/lib/jobforge-facts.mjs
CHANGED
package/lib/jobforge-index.mjs
CHANGED
package/lib/jobforge-ledger.mjs
CHANGED
package/lib/jobforge-lineage.mjs
CHANGED
package/lib/jobforge-migrate.mjs
CHANGED
|
@@ -4,7 +4,7 @@ import {
|
|
|
4
4
|
loadPostflightConfig,
|
|
5
5
|
parseJson,
|
|
6
6
|
settlePostflight,
|
|
7
|
-
} from '@
|
|
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';
|
|
@@ -7,7 +7,7 @@ import {
|
|
|
7
7
|
prioritize,
|
|
8
8
|
selectPrioritized,
|
|
9
9
|
verifyPrioritizeResult,
|
|
10
|
-
} from '@
|
|
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
|
|
package/lib/jobforge-redact.mjs
CHANGED
package/lib/jobforge-score.mjs
CHANGED
|
@@ -8,7 +8,7 @@ import {
|
|
|
8
8
|
parseJsonLines,
|
|
9
9
|
planTimeline,
|
|
10
10
|
verifyTimelineResult,
|
|
11
|
-
} from '@
|
|
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 @
|
|
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 `@
|
|
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": ["-
|
|
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.
|
package/modes/reference-setup.md
CHANGED
|
@@ -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 `@
|
|
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
|
-
"-
|
|
21
|
-
"
|
|
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",
|