job-forge 2.14.32 → 2.14.33

package/.cursor/rules/main.mdc

@@ -24,7 +24,7 @@ AI-powered job search pipeline: scans portals, evaluates offers, generates CVs v
 - [H5] Re-dispatch the same company only AFTER the previous subagent returns. Never fire the same `task` twice while the first is still in flight.
   why: two in-flight subagents for the same URL race on Geometra sessions and on tracker TSV writes, corrupting state and sometimes double-submitting
 
-- [H5b] Do not use `task` to poll task status. If OpenCode returns a task/session id without a final result, record the id, stop dispatching new rounds, and tell the user the round is still in flight. When the user asks to check later, inspect authoritative files (`batch/tracker-additions/*.tsv`, `batch/tracker-additions/merged/*.tsv`, day files, `.jobforge-ledger/events.jsonl`, `.jobforge-index.json`, `.jobforge-facts.json`, or `iso-trace`) rather than spawning a "check task status" subagent.
+- [H5b] Do not use `task` to poll task status. If OpenCode returns a task/session id without a final result, record the id, stop dispatching new rounds, and tell the user the round is still in flight. When the user asks to check later, inspect authoritative files (`batch/tracker-additions/*.tsv`, `batch/tracker-additions/merged/*.tsv`, day files, `.jobforge-ledger/events.jsonl`, `.jobforge-index.json`, `.jobforge-facts.json`, `.jobforge-timeline.json`, or `iso-trace`) rather than spawning a "check task status" subagent.
   why: OpenCode status prompts can be delivered into the target subagent as a new user message; a 2026-04-25 trace caused a subagent to call `task` recursively instead of finishing the application
 
 - [H6] Application outcomes flow through `batch/tracker-additions/*.tsv`, not `data/pipeline.md`. After any multi-apply run, the orchestrator MUST run `npx job-forge merge` then `npx job-forge verify` before ending the session.
@@ -98,11 +98,14 @@ AI-powered job search pipeline: scans portals, evaluates offers, generates CVs v
 - [D19] Treat `templates/score.json` as the source of truth for offer scoring weights, bands, and gates. After emitting a report score JSON that will drive PDF/application/batch decisions, run `npx job-forge score:check --input <file>`; for apply decisions run `npx job-forge score:gate --input <file> --gate apply`. Do not recalculate weighted totals or thresholds manually when the local helper can check them.
   why: `iso-score` is not an MCP and adds no prompt/tool-schema tokens; it makes scoring math, recommendation bands, and threshold booleans executable local policy instead of repeated model prose
 
+- [D20] Treat `templates/timeline.json` as the source of truth for follow-up and next-action timing. For follow-up triage, run `npx job-forge timeline:due` before reading tracker files; use `npx job-forge timeline:check --fail-on overdue` when a workflow must fail only on stale actions. Use `timeline:build` when a durable `.jobforge-timeline.json` artifact is useful.
+  why: `iso-timeline` is not an MCP and adds no prompt/tool-schema tokens; it turns timing windows over tracker/pipeline sources into executable local policy instead of repeated date math in model context
+
 ## Procedure
 
 1. Check `cv.md`, `profile.yml`, and `portals.yml`; onboard if any file is missing.
 2. Pick and name the mode from **Routing** [D6]. No match → ask; do not guess.
-3. Read the active mode file [D3]. Use context bundle checks when changing context loads [D11]. Check cached artifacts before URL/JD refetches [D12]. Use artifact index lookups before broad file reads when they can answer the question [D13]. Use materialized facts when a fact query can answer the question [D13b]. Use canonical identity keys for duplicate checks [D15]. Use score checks/gates for scoring decisions [D19]. Use migration checks for harness drift [D14]. Use redaction checks before exporting local artifacts [D18]. Decide inline vs delegated work [D1].
+3. Read the active mode file [D3]. Use context bundle checks when changing context loads [D11]. Check cached artifacts before URL/JD refetches [D12]. Use artifact index lookups before broad file reads when they can answer the question [D13]. Use materialized facts when a fact query can answer the question [D13b]. Use canonical identity keys for duplicate checks [D15]. Use score checks/gates for scoring decisions [D19]. Use timeline due/check commands for follow-up timing [D20]. Use migration checks for harness drift [D14]. Use redaction checks before exporting local artifacts [D18]. Decide inline vs delegated work [D1].
 4. Prepare Geometra dispatches: cleanup [H3], canon/index/facts/ledger prefilter when useful [D8, D13, D13b, D15], dedupe [H2], location filter [D5], materialize candidate facts/gates and run preflight plan/check [D16], routing [D2, D10], proxy prompt hygiene [H8].
 5. Dispatch at most 2 tasks per round [H1]; wait for final outcomes, not just task ids [H5b], then settle the round with postflight status [D17].
 6. Keep multi-job form-filling out of the orchestrator [H4].

package/.opencode/skills/job-forge.md

@@ -90,6 +90,10 @@ Postflight dispatch settlement (terminal, outside opencode):
   npx job-forge postflight:status --plan batch/preflight-plan.json --outcomes batch/postflight-outcomes.json
   npx job-forge postflight:check --plan batch/preflight-plan.json --outcomes batch/postflight-outcomes.json
 
+Follow-up timeline (terminal, outside opencode):
+  npx job-forge timeline:due
+  npx job-forge timeline:check --fail-on overdue
+
 Consumer migrations (terminal, outside opencode):
   npx job-forge migrate:plan           # preview package.json/.gitignore drift
   npx job-forge migrate:apply          # apply safe harness upgrade migrations

package/AGENTS.md

@@ -19,7 +19,7 @@ AI-powered job search pipeline: scans portals, evaluates offers, generates CVs v
 - [H5] Re-dispatch the same company only AFTER the previous subagent returns. Never fire the same `task` twice while the first is still in flight.
   why: two in-flight subagents for the same URL race on Geometra sessions and on tracker TSV writes, corrupting state and sometimes double-submitting
 
-- [H5b] Do not use `task` to poll task status. If OpenCode returns a task/session id without a final result, record the id, stop dispatching new rounds, and tell the user the round is still in flight. When the user asks to check later, inspect authoritative files (`batch/tracker-additions/*.tsv`, `batch/tracker-additions/merged/*.tsv`, day files, `.jobforge-ledger/events.jsonl`, `.jobforge-index.json`, `.jobforge-facts.json`, or `iso-trace`) rather than spawning a "check task status" subagent.
+- [H5b] Do not use `task` to poll task status. If OpenCode returns a task/session id without a final result, record the id, stop dispatching new rounds, and tell the user the round is still in flight. When the user asks to check later, inspect authoritative files (`batch/tracker-additions/*.tsv`, `batch/tracker-additions/merged/*.tsv`, day files, `.jobforge-ledger/events.jsonl`, `.jobforge-index.json`, `.jobforge-facts.json`, `.jobforge-timeline.json`, or `iso-trace`) rather than spawning a "check task status" subagent.
   why: OpenCode status prompts can be delivered into the target subagent as a new user message; a 2026-04-25 trace caused a subagent to call `task` recursively instead of finishing the application
 
 - [H6] Application outcomes flow through `batch/tracker-additions/*.tsv`, not `data/pipeline.md`. After any multi-apply run, the orchestrator MUST run `npx job-forge merge` then `npx job-forge verify` before ending the session.
@@ -93,11 +93,14 @@ AI-powered job search pipeline: scans portals, evaluates offers, generates CVs v
 - [D19] Treat `templates/score.json` as the source of truth for offer scoring weights, bands, and gates. After emitting a report score JSON that will drive PDF/application/batch decisions, run `npx job-forge score:check --input <file>`; for apply decisions run `npx job-forge score:gate --input <file> --gate apply`. Do not recalculate weighted totals or thresholds manually when the local helper can check them.
   why: `iso-score` is not an MCP and adds no prompt/tool-schema tokens; it makes scoring math, recommendation bands, and threshold booleans executable local policy instead of repeated model prose
 
+- [D20] Treat `templates/timeline.json` as the source of truth for follow-up and next-action timing. For follow-up triage, run `npx job-forge timeline:due` before reading tracker files; use `npx job-forge timeline:check --fail-on overdue` when a workflow must fail only on stale actions. Use `timeline:build` when a durable `.jobforge-timeline.json` artifact is useful.
+  why: `iso-timeline` is not an MCP and adds no prompt/tool-schema tokens; it turns timing windows over tracker/pipeline sources into executable local policy instead of repeated date math in model context
+
 ## Procedure
 
 1. Check `cv.md`, `profile.yml`, and `portals.yml`; onboard if any file is missing.
 2. Pick and name the mode from **Routing** [D6]. No match → ask; do not guess.
-3. Read the active mode file [D3]. Use context bundle checks when changing context loads [D11]. Check cached artifacts before URL/JD refetches [D12]. Use artifact index lookups before broad file reads when they can answer the question [D13]. Use materialized facts when a fact query can answer the question [D13b]. Use canonical identity keys for duplicate checks [D15]. Use score checks/gates for scoring decisions [D19]. Use migration checks for harness drift [D14]. Use redaction checks before exporting local artifacts [D18]. Decide inline vs delegated work [D1].
+3. Read the active mode file [D3]. Use context bundle checks when changing context loads [D11]. Check cached artifacts before URL/JD refetches [D12]. Use artifact index lookups before broad file reads when they can answer the question [D13]. Use materialized facts when a fact query can answer the question [D13b]. Use canonical identity keys for duplicate checks [D15]. Use score checks/gates for scoring decisions [D19]. Use timeline due/check commands for follow-up timing [D20]. Use migration checks for harness drift [D14]. Use redaction checks before exporting local artifacts [D18]. Decide inline vs delegated work [D1].
 4. Prepare Geometra dispatches: cleanup [H3], canon/index/facts/ledger prefilter when useful [D8, D13, D13b, D15], dedupe [H2], location filter [D5], materialize candidate facts/gates and run preflight plan/check [D16], routing [D2, D10], proxy prompt hygiene [H8].
 5. Dispatch at most 2 tasks per round [H1]; wait for final outcomes, not just task ids [H5b], then settle the round with postflight status [D17].
 6. Keep multi-job form-filling out of the orchestrator [H4].

package/CLAUDE.md

@@ -19,7 +19,7 @@ AI-powered job search pipeline: scans portals, evaluates offers, generates CVs v
 - [H5] Re-dispatch the same company only AFTER the previous subagent returns. Never fire the same `task` twice while the first is still in flight.
   why: two in-flight subagents for the same URL race on Geometra sessions and on tracker TSV writes, corrupting state and sometimes double-submitting
 
-- [H5b] Do not use `task` to poll task status. If OpenCode returns a task/session id without a final result, record the id, stop dispatching new rounds, and tell the user the round is still in flight. When the user asks to check later, inspect authoritative files (`batch/tracker-additions/*.tsv`, `batch/tracker-additions/merged/*.tsv`, day files, `.jobforge-ledger/events.jsonl`, `.jobforge-index.json`, `.jobforge-facts.json`, or `iso-trace`) rather than spawning a "check task status" subagent.
+- [H5b] Do not use `task` to poll task status. If OpenCode returns a task/session id without a final result, record the id, stop dispatching new rounds, and tell the user the round is still in flight. When the user asks to check later, inspect authoritative files (`batch/tracker-additions/*.tsv`, `batch/tracker-additions/merged/*.tsv`, day files, `.jobforge-ledger/events.jsonl`, `.jobforge-index.json`, `.jobforge-facts.json`, `.jobforge-timeline.json`, or `iso-trace`) rather than spawning a "check task status" subagent.
   why: OpenCode status prompts can be delivered into the target subagent as a new user message; a 2026-04-25 trace caused a subagent to call `task` recursively instead of finishing the application
 
 - [H6] Application outcomes flow through `batch/tracker-additions/*.tsv`, not `data/pipeline.md`. After any multi-apply run, the orchestrator MUST run `npx job-forge merge` then `npx job-forge verify` before ending the session.
@@ -93,11 +93,14 @@ AI-powered job search pipeline: scans portals, evaluates offers, generates CVs v
 - [D19] Treat `templates/score.json` as the source of truth for offer scoring weights, bands, and gates. After emitting a report score JSON that will drive PDF/application/batch decisions, run `npx job-forge score:check --input <file>`; for apply decisions run `npx job-forge score:gate --input <file> --gate apply`. Do not recalculate weighted totals or thresholds manually when the local helper can check them.
   why: `iso-score` is not an MCP and adds no prompt/tool-schema tokens; it makes scoring math, recommendation bands, and threshold booleans executable local policy instead of repeated model prose
 
+- [D20] Treat `templates/timeline.json` as the source of truth for follow-up and next-action timing. For follow-up triage, run `npx job-forge timeline:due` before reading tracker files; use `npx job-forge timeline:check --fail-on overdue` when a workflow must fail only on stale actions. Use `timeline:build` when a durable `.jobforge-timeline.json` artifact is useful.
+  why: `iso-timeline` is not an MCP and adds no prompt/tool-schema tokens; it turns timing windows over tracker/pipeline sources into executable local policy instead of repeated date math in model context
+
 ## Procedure
 
 1. Check `cv.md`, `profile.yml`, and `portals.yml`; onboard if any file is missing.
 2. Pick and name the mode from **Routing** [D6]. No match → ask; do not guess.
-3. Read the active mode file [D3]. Use context bundle checks when changing context loads [D11]. Check cached artifacts before URL/JD refetches [D12]. Use artifact index lookups before broad file reads when they can answer the question [D13]. Use materialized facts when a fact query can answer the question [D13b]. Use canonical identity keys for duplicate checks [D15]. Use score checks/gates for scoring decisions [D19]. Use migration checks for harness drift [D14]. Use redaction checks before exporting local artifacts [D18]. Decide inline vs delegated work [D1].
+3. Read the active mode file [D3]. Use context bundle checks when changing context loads [D11]. Check cached artifacts before URL/JD refetches [D12]. Use artifact index lookups before broad file reads when they can answer the question [D13]. Use materialized facts when a fact query can answer the question [D13b]. Use canonical identity keys for duplicate checks [D15]. Use score checks/gates for scoring decisions [D19]. Use timeline due/check commands for follow-up timing [D20]. Use migration checks for harness drift [D14]. Use redaction checks before exporting local artifacts [D18]. Decide inline vs delegated work [D1].
 4. Prepare Geometra dispatches: cleanup [H3], canon/index/facts/ledger prefilter when useful [D8, D13, D13b, D15], dedupe [H2], location filter [D5], materialize candidate facts/gates and run preflight plan/check [D16], routing [D2, D10], proxy prompt hygiene [H8].
 5. Dispatch at most 2 tasks per round [H1]; wait for final outcomes, not just task ids [H5b], then settle the round with postflight status [D17].
 6. Keep multi-job form-filling out of the orchestrator [H4].

package/README.md

@@ -31,7 +31,7 @@ The scaffolded `opencode.json` already has three MCPs wired up — they launch a
 - **Gmail** — reads replies from recruiters
 - **state-trace** — typed working memory for cross-session context (resumed batches, recent decisions, repeated portal quirks). Install once with `python3 -m pip install "state-trace[mcp]"`; the MCP command is `state-trace-mcp`.
 
-JobForge also keeps MCP-free local workflow state and policy: `templates/canon.json` defines URL/company/role identity keys via `@razroo/iso-canon`, `templates/contracts.json` defines tracker/apply artifact shapes via `@razroo/iso-contract`, `templates/score.json` defines weighted scoring and gates via `@razroo/iso-score`, `templates/capabilities.json` defines role capability boundaries via `@razroo/iso-capabilities`, `templates/context.json` defines deterministic mode/reference bundles via `@razroo/iso-context`, `templates/preflight.json` defines safe dispatch rounds/gates via `@razroo/iso-preflight`, `templates/postflight.json` defines safe dispatch settlement via `@razroo/iso-postflight`, `templates/redact.json` defines safe-export redaction rules via `@razroo/iso-redact`, `templates/migrations.json` defines safe consumer-project upgrades via `@razroo/iso-migrate`, `templates/facts.json` defines source-backed fact extraction via `@razroo/iso-facts`, `.jobforge-ledger/events.jsonl` records duplicate/status events via `@razroo/iso-ledger`, `.jobforge-cache/` stores reusable JD/artifact content via `@razroo/iso-cache`, `.jobforge-index.json` indexes artifact source pointers via `@razroo/iso-index`, and `.jobforge-facts.json` materializes queryable facts with provenance. None of these add always-on prompt or tool-schema tokens.
+JobForge also keeps MCP-free local workflow state and policy: `templates/canon.json` defines URL/company/role identity keys via `@razroo/iso-canon`, `templates/contracts.json` defines tracker/apply artifact shapes via `@razroo/iso-contract`, `templates/score.json` defines weighted scoring and gates via `@razroo/iso-score`, `templates/timeline.json` defines follow-up and next-action windows via `@razroo/iso-timeline`, `templates/capabilities.json` defines role capability boundaries via `@razroo/iso-capabilities`, `templates/context.json` defines deterministic mode/reference bundles via `@razroo/iso-context`, `templates/preflight.json` defines safe dispatch rounds/gates via `@razroo/iso-preflight`, `templates/postflight.json` defines safe dispatch settlement via `@razroo/iso-postflight`, `templates/redact.json` defines safe-export redaction rules via `@razroo/iso-redact`, `templates/migrations.json` defines safe consumer-project upgrades via `@razroo/iso-migrate`, `templates/facts.json` defines source-backed fact extraction via `@razroo/iso-facts`, `.jobforge-ledger/events.jsonl` records duplicate/status events via `@razroo/iso-ledger`, `.jobforge-cache/` stores reusable JD/artifact content via `@razroo/iso-cache`, `.jobforge-index.json` indexes artifact source pointers via `@razroo/iso-index`, `.jobforge-facts.json` materializes queryable facts with provenance, and `.jobforge-timeline.json` materializes due/overdue follow-up actions. None of these add always-on prompt or tool-schema tokens.
 
 `npm install` also materializes symlinks for every supported agent harness — OpenCode, Cursor, Claude Code, and Codex — so you can run `opencode`, `cursor`, `claude`, or `codex` in the same project and each picks up the shared MCP config and instructions.
 
@@ -67,7 +67,7 @@ JobForge turns opencode into a full job search command center. Instead of manual
 | **Anti-AI-Detection CVs** | Writing rules that avoid ATS filters on Indeed, LinkedIn, Workday |
 | **6-Block Evaluation** | Role summary, CV match, level strategy, comp research, personalization, interview prep (STAR+R) |
 | **Interview Story Bank** | Curated bank of 10-12 stories with match counts, archetype tags, and automatic pruning |
-| **Follow-Up System** | Timing-based nudges: Applied 7+ days ago nudge, Interviewed 1 day ago thank-you note, email scanning via Gmail MCP |
+| **Follow-Up System** | `job-forge timeline:*` computes timing-based nudges from local tracker/pipeline sources: Applied 7+ days ago, Contacted 5+ days ago, Interview 1-day thank-you, and 7-day interview nudge. |
 | **Gmail Integration** | MCP server configured to retrieve emails for interview callbacks, offer responses, and application status updates |
 | **Rejection Analysis** | Captures stage + reason, surfaces patterns (archetype gaps, scoring miscalibration) |
 | **Offer Negotiation** | Total comp breakdown, equity valuation, leverage from pipeline, counter-offer scripts |
@@ -78,7 +78,7 @@ JobForge turns opencode into a full job search command center. Instead of manual
 | **Durable Batch Orchestration** | `batch-runner.sh` uses `@razroo/iso-orchestrator` for resumable bundle execution, bounded fan-out, mutexed state writes, and workflow records in `.jobforge-runs/`. |
 | **Pipeline Integrity** | Automated merge, dedup, status normalization, health checks |
 | **Cost-Aware Agent Routing** | Three subagents (`@general-free`, `@general-paid`, `@glm-minimal`) with per-task tool surfaces. On OpenCode, JobForge pins all tiers to `opencode-go/deepseek-v4-flash` so application runs avoid overloaded free-model pools. See [Subagent Routing in AGENTS.md](AGENTS.md) for the task-to-agent mapping. |
-| **Trace + Telemetry + Guard + Contract + Score + Canon + Ledger + Capabilities + Context + Cache + Index + Facts + Preflight + Postflight + Redact + Migrate** | `job-forge trace:*` exposes local OpenCode transcripts, `job-forge telemetry:*` summarizes runs, `job-forge guard:*` audits deterministic policy rules, `templates/contracts.json` enforces artifact shape with `iso-contract`, `job-forge score:*` computes/checks weighted offer scores, `job-forge canon:*` derives stable URL/company/role identity keys, `job-forge ledger:*` queries append-only workflow state, `job-forge capabilities:*` checks role boundaries, `job-forge context:*` plans mode/reference context bundles, `job-forge cache:*` reuses fetched JD/artifact content, `job-forge index:*` queries compact source pointers, `job-forge facts:*` materializes source-backed job/application/candidate facts, `job-forge preflight:*` plans bounded apply dispatch rounds from file-backed candidate facts, `job-forge postflight:*` settles dispatch outcomes/artifacts/post-steps, `job-forge redact:*` sanitizes local exports, and `job-forge migrate:*` applies safe consumer-project upgrades without MCP/tool-schema overhead. |
+| **Trace + Telemetry + Guard + Contract + Score + Canon + Ledger + Capabilities + Context + Cache + Index + Facts + Timeline + Preflight + Postflight + Redact + Migrate** | `job-forge trace:*` exposes local OpenCode transcripts, `job-forge telemetry:*` summarizes runs, `job-forge guard:*` audits deterministic policy rules, `templates/contracts.json` enforces artifact shape with `iso-contract`, `job-forge score:*` computes/checks weighted offer scores, `job-forge canon:*` derives stable URL/company/role identity keys, `job-forge ledger:*` queries append-only workflow state, `job-forge capabilities:*` checks role boundaries, `job-forge context:*` plans mode/reference context bundles, `job-forge cache:*` reuses fetched JD/artifact content, `job-forge index:*` queries compact source pointers, `job-forge facts:*` materializes source-backed job/application/candidate facts, `job-forge timeline:*` computes due/overdue follow-up actions, `job-forge preflight:*` plans bounded apply dispatch rounds from file-backed candidate facts, `job-forge postflight:*` settles dispatch outcomes/artifacts/post-steps, `job-forge redact:*` sanitizes local exports, and `job-forge migrate:*` applies safe consumer-project upgrades without MCP/tool-schema overhead. |
 | **Token Cost Visibility** | `job-forge tokens --days 1` for per-session breakdown; `job-forge session-report --since-minutes 60 --log` to flag sessions over budget and append history to `data/token-usage.tsv`. Auto-logged after every batch run. |
 
 ## Usage
@@ -149,6 +149,7 @@ my-search/
 ├── .jobforge-cache/               # content-addressed local JD/artifact cache (personal, gitignored)
 ├── .jobforge-index.json           # deterministic artifact lookup index (generated, gitignored)
 ├── .jobforge-facts.json           # deterministic fact set with provenance (generated, gitignored)
+├── .jobforge-timeline.json        # deterministic follow-up action plan (generated, gitignored)
 ├── .jobforge-redacted/            # sanitized local exports (generated, gitignored)
 ├── reports/                      # generated evaluation reports (personal, gitignored)
 ├── batch/{batch-input,batch-state}.tsv, tracker-additions/, logs/   # personal
@@ -166,7 +167,7 @@ my-search/
 ├── .opencode/skills/job-forge.md # → skill router
 ├── .opencode/agents/             # → @general-free, @general-paid, @glm-minimal
 ├── modes/                        # → _shared.md + skill modes
-├── templates/                    # → states.yml, portals.example.yml, cv-template.html, canon.json, score.json, capabilities.json, context.json, index.json, facts.json, preflight.json, postflight.json, redact.json, migrations.json
+├── templates/                    # → states.yml, portals.example.yml, cv-template.html, canon.json, score.json, timeline.json, capabilities.json, context.json, index.json, facts.json, preflight.json, postflight.json, redact.json, migrations.json
 ├── batch/batch-prompt.md         # → batch worker prompt
 ├── batch/batch-runner.sh         # → parallel orchestrator
 │
@@ -192,7 +193,7 @@ JobForge/
 │   ├── sync.mjs                  # postinstall: creates symlinks in consumer project
 │   └── create-job-forge.mjs      # scaffolder
 ├── modes/                        # _shared.md + 16 skill modes
-├── templates/                    # cv-template.html, portals.example.yml, states.yml, canon.json, score.json, capabilities.json, context.json, facts.json, preflight.json, postflight.json, redact.json, migrations.json
+├── templates/                    # cv-template.html, portals.example.yml, states.yml, canon.json, score.json, timeline.json, capabilities.json, context.json, facts.json, preflight.json, postflight.json, redact.json, migrations.json
 ├── config/profile.example.yml    # template for consumer's profile.yml
 ├── batch/{batch-prompt.md,batch-runner.sh}   # batch orchestrator
 ├── scripts/
@@ -204,6 +205,7 @@ JobForge/
 │   ├── cache.mjs                 # iso-cache-backed local artifact cache CLI
 │   ├── index.mjs                 # iso-index-backed artifact lookup CLI
 │   ├── facts.mjs                 # iso-facts-backed local fact materialization
+│   ├── timeline.mjs              # iso-timeline-backed follow-up planning CLI
 │   ├── score.mjs                 # iso-score-backed offer scoring CLI
 │   ├── canon.mjs                 # iso-canon-backed identity normalization CLI
 │   ├── preflight.mjs             # iso-preflight-backed dispatch planning CLI

package/bin/job-forge.mjs

@@ -30,6 +30,7 @@
  *   canon:*        Compute deterministic identity keys via iso-canon
  *   preflight:*    Plan safe dispatch rounds via iso-preflight
  *   postflight:*   Settle dispatch outcomes via iso-postflight
+ *   timeline:*     Plan follow-up/next-action windows via iso-timeline
  *   redact:*       Sanitize local exports via iso-redact
  *   migrate:*      Apply deterministic consumer-project migrations via iso-migrate
  *   sync           Re-run the harness symlink sync (bin/sync.mjs)
@@ -177,6 +178,17 @@ const postflightAliases = {
   'postflight:path': 'path',
 };
 
+const timelineAliases = {
+  'timeline:status': 'status',
+  'timeline:build': 'build',
+  'timeline:plan': 'plan',
+  'timeline:due': 'due',
+  'timeline:check': 'check',
+  'timeline:verify': 'verify',
+  'timeline:explain': 'explain',
+  'timeline:path': 'path',
+};
+
 const redactAliases = {
   'redact:scan': 'scan',
   'redact:verify': 'verify',
@@ -263,6 +275,11 @@ Commands:
   postflight:status       Reconcile dispatch plan, outcomes, artifacts, and post-steps
   postflight:check        Fail unless a dispatched workflow is fully settled
   postflight:explain      Show the active postflight workflow policy
+  timeline:status         Show local follow-up/next-action timeline status
+  timeline:build          Build .jobforge-timeline.json from tracker/pipeline sources
+  timeline:due            Show currently due/overdue follow-up actions
+  timeline:check          Fail on due/overdue timeline actions per policy
+  timeline:explain        Show the active timeline policy
   redact:scan             Scan local text for sensitive values before export
   redact:verify           Fail if local text still contains sensitive values
   redact:apply            Write a sanitized copy of local text
@@ -319,6 +336,8 @@ Pass --help after a command to see its own flags, e.g.:
   job-forge preflight:check --candidates batch/preflight-candidates.json
   job-forge postflight:status --plan batch/preflight-plan.json --outcomes batch/postflight-outcomes.json
   job-forge postflight:check --plan batch/preflight-plan.json --outcomes batch/postflight-outcomes.json
+  job-forge timeline:due
+  job-forge timeline:check --fail-on overdue
   job-forge redact:scan --input raw-session.jsonl
   job-forge redact:apply --input raw-session.jsonl --output .jobforge-redacted/session.jsonl
   job-forge migrate:check
@@ -527,6 +546,21 @@ if (cmd === 'postflight' || postflightAliases[cmd]) {
   process.exit(result.status ?? 1);
 }
 
+if (cmd === 'timeline' || timelineAliases[cmd]) {
+  const timelineArgs = cmd === 'timeline'
+    ? (rest.length === 0 ? ['help'] : rest)
+    : [timelineAliases[cmd], ...rest];
+
+  const scriptPath = join(PKG_ROOT, 'scripts/timeline.mjs');
+  const result = spawnSync(process.execPath, [scriptPath, ...timelineArgs], {
+    stdio: 'inherit',
+    cwd: PROJECT_DIR,
+    env: process.env,
+  });
+
+  process.exit(result.status ?? 1);
+}
+
 if (cmd === 'redact' || redactAliases[cmd]) {
   const redactArgs = cmd === 'redact'
     ? (rest.length === 0 ? ['help'] : rest)

package/docs/ARCHITECTURE.md

@@ -32,7 +32,7 @@ my-search/
 ├── .opencode/skills/job-forge.md     # → skill router
 ├── .opencode/agents/                 # → @general-free, @general-paid, @glm-minimal
 ├── modes/                            # → mode files
-├── templates/                        # → states.yml, portals.example.yml, cv-template.html, score.json, preflight.json, postflight.json
+├── templates/                        # → states.yml, portals.example.yml, cv-template.html, score.json, timeline.json, preflight.json, postflight.json
 ├── batch/batch-prompt.md             # → batch worker prompt
 ├── batch/batch-runner.sh             # → parallel orchestrator
 └── node_modules/job-forge/           # harness, installed from npm
@@ -163,12 +163,14 @@ data/pipeline.md        →  Pending URLs and `local:jds/...` inbox (see modes/p
 .jobforge-ledger/events.jsonl → Append-only workflow events for cheap local duplicate/status checks
 .jobforge-index.json     →  Deterministic artifact lookup index built from templates/index.json
 .jobforge-facts.json     →  Deterministic fact set built from templates/facts.json
+.jobforge-timeline.json  →  Deterministic follow-up action plan built from templates/timeline.json
 jds/*.md                 →  Saved job descriptions referenced from the pipeline (`local:jds/{file}`)
 templates/states.yml     →  Canonical status values
 templates/canon.json      →  Canonical URL/company/role identity keys
 templates/score.json      →  Canonical weighted scoring rubric and gates
 templates/context.json    →  Deterministic mode/reference context bundle policy
 templates/facts.json      →  Source-backed fact extraction policy
+templates/timeline.json   →  Follow-up and next-action timing policy
 templates/preflight.json  →  Safe apply dispatch rounds/gates policy
 templates/postflight.json →  Safe apply dispatch settlement policy
 templates/migrations.json → Safe consumer-project upgrade policy
@@ -186,8 +188,10 @@ Create `data/pipeline.md` when you start using the URL inbox (`/job-forge pipeli
 - Ledger: `.jobforge-ledger/events.jsonl` (created by `job-forge ledger:rebuild`, `tracker-line --write`, or `merge`; gitignored personal state)
 - Index: `.jobforge-index.json` (created on demand by `job-forge index:*`; gitignored local lookup state)
 - Facts: `.jobforge-facts.json` (created on demand by `job-forge facts:*`; gitignored local fact state)
+- Timeline: `.jobforge-timeline.json` (created on demand by `job-forge timeline:*`; gitignored local next-action state)
 - Canon: `templates/canon.json` (identity rules inspected with `job-forge canon:*`)
 - Score: `templates/score.json` (weighted rubric and gates inspected with `job-forge score:*`)
+- Timeline policy: `templates/timeline.json` (follow-up windows inspected with `job-forge timeline:*`)
 - Preflight: `templates/preflight.json` (dispatch rounds/gates inspected with `job-forge preflight:*`)
 - Postflight: `templates/postflight.json` (dispatch outcomes/artifacts/post-steps inspected with `job-forge postflight:*`)
 - Migrations: `templates/migrations.json` (applied by `job-forge sync` and inspectable with `job-forge migrate:*`)
@@ -196,7 +200,7 @@ Create `data/pipeline.md` when you start using the URL inbox (`/job-forge pipeli
 
 ## Pipeline Integrity
 
-From the project root, `npx job-forge verify` (or `npm run verify`) runs `verify-pipeline.mjs`. When a tracker file exists, it validates canonical statuses (using `templates/states.yml` when that file is present and parseable), validates every tracker row against `templates/contracts.json`, warns on probable duplicate company/role rows, checks that report column markdown links resolve to files in the repo, validates score column format (`X.X/5`, `N/A`, or `DUP`), rejects table rows with too few columns, flags markdown bold inside the score column, and warns if any `batch/tracker-additions/*.tsv` files are still waiting to be merged. If `.jobforge-ledger/events.jsonl` exists, verify also validates the append-only ledger. If `.jobforge-index.json` exists, verify validates the artifact index. If `.jobforge-facts.json` exists, verify validates the materialized fact set. It also compares state ids from `templates/states.yml` to an internal fallback list and warns when the two sets drift. **Fresh clone:** the command exits successfully when neither `data/applications.md` nor root `applications.md` exists yet; pending-TSV and states-drift checks still run so contributors see unmerged batch output early. Optional setup validation after you add `cv.md` and `config/profile.yml`: `npm run sync-check` (`cv-sync-check.mjs`).
+From the project root, `npx job-forge verify` (or `npm run verify`) runs `verify-pipeline.mjs`. When a tracker file exists, it validates canonical statuses (using `templates/states.yml` when that file is present and parseable), validates every tracker row against `templates/contracts.json`, warns on probable duplicate company/role rows, checks that report column markdown links resolve to files in the repo, validates score column format (`X.X/5`, `N/A`, or `DUP`), rejects table rows with too few columns, flags markdown bold inside the score column, and warns if any `batch/tracker-additions/*.tsv` files are still waiting to be merged. If `.jobforge-ledger/events.jsonl` exists, verify also validates the append-only ledger. If `.jobforge-index.json` exists, verify validates the artifact index. If `.jobforge-facts.json` exists, verify validates the materialized fact set. If `.jobforge-timeline.json` exists, verify validates the follow-up timeline. It also compares state ids from `templates/states.yml` to an internal fallback list and warns when the two sets drift. **Fresh clone:** the command exits successfully when neither `data/applications.md` nor root `applications.md` exists yet; pending-TSV and states-drift checks still run so contributors see unmerged batch output early. Optional setup validation after you add `cv.md` and `config/profile.yml`: `npm run sync-check` (`cv-sync-check.mjs`).
 
 **`verify-pipeline.mjs` checks (same order as the script header):**
 
@@ -212,8 +216,9 @@ From the project root, `npx job-forge verify` (or `npm run verify`) runs `verify
 10. Validate `.jobforge-ledger/events.jsonl` when present.
 11. Validate `.jobforge-index.json` when present.
 12. Validate `.jobforge-facts.json` when present.
+13. Validate `.jobforge-timeline.json` when present.
 
-When the tracker file is missing, checks 1-6 and 8 are skipped; checks 7, 9, 10, and 11 still run when applicable.
+When the tracker file is missing, checks 1-6 and 8 are skipped; checks 7, 9, 10, 11, 12, and 13 still run when applicable.
 
 ## Contributing touchpoints
 
@@ -238,6 +243,7 @@ Scripts maintain data consistency. In a consumer project they're invoked via the
 | `scripts/ledger.mjs` | `npx job-forge ledger:status` / `ledger:has` / `ledger:rebuild` | Deterministic `@razroo/iso-ledger` state over tracker, TSV, and pipeline files |
 | `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 |
 | `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 |
+| `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 |
 | `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 |
 | `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 |
 | `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 |

package/docs/CUSTOMIZATION.md

@@ -158,6 +158,10 @@ Artifact lookup policy lives in `templates/index.json` and is built locally by `
 
 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.
 
+## JobForge timeline policy
+
+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.
+
 ## JobForge scoring policy
 
 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.

package/docs/README.md

@@ -31,7 +31,7 @@ The harness exposes a single CLI (`job-forge`) installed as a `bin` entry. In a
 
 | What you need | Where to read |
 |---------------|---------------|
-| Full command list (`verify`, `merge`, `dedup`, `normalize`, `pdf`, `sync-check`, `tokens`, `trace`, `telemetry`, `guard`, `ledger`, `canon`, `context`, `index`, `facts`, `preflight`, `postflight`, `redact`, `sync`). | [SETUP.md — Tracker and scripts (terminal)](SETUP.md#tracker-and-scripts-terminal). |
+| Full command list (`verify`, `merge`, `dedup`, `normalize`, `pdf`, `sync-check`, `tokens`, `trace`, `telemetry`, `guard`, `ledger`, `canon`, `context`, `index`, `facts`, `timeline`, `preflight`, `postflight`, `redact`, `sync`). | [SETUP.md — Tracker and scripts (terminal)](SETUP.md#tracker-and-scripts-terminal). |
 | What each harness `.mjs` script does. | [ARCHITECTURE.md — Pipeline integrity](ARCHITECTURE.md#pipeline-integrity) and the scripts table underneath. |
 | Batch runner, TSV layout, and `batch/tracker-additions/` merge flow. | [batch/README.md](../batch/README.md). |
 | PR gate for harness contributions (`npm run verify` + `npm run build:dashboard`). | [CONTRIBUTING.md — Development](../CONTRIBUTING.md#development). |

package/docs/SETUP.md

@@ -135,6 +135,8 @@ From your project root, these commands maintain the tracker and pipeline checks.
 | Inspect local JD/artifact cache | `npx job-forge cache:status` | `npm run cache:status` |
 | Inspect local artifact index | `npx job-forge index:status` | `npm run index:status` |
 | Inspect local materialized facts | `npx job-forge facts:status` | `npm run facts:status` |
+| Show due follow-up actions | `npx job-forge timeline:due` | `npm run timeline:due` |
+| Fail on stale follow-up actions | `npx job-forge timeline:check --fail-on overdue` | `npm run timeline:check -- --fail-on overdue` |
 | Plan safe application dispatch rounds | `npx job-forge preflight:plan --candidates batch/preflight-candidates.json` | `npm run preflight:plan -- --candidates ...` |
 | Fail on blocked preflight candidates | `npx job-forge preflight:check --candidates batch/preflight-candidates.json` | `npm run preflight:check -- --candidates ...` |
 | Settle dispatch outcomes after a round | `npx job-forge postflight:status --plan batch/preflight-plan.json --outcomes batch/postflight-outcomes.json` | `npm run postflight:status -- --plan ... --outcomes ...` |
@@ -161,6 +163,7 @@ From your project root, these commands maintain the tracker and pipeline checks.
 | Check/reuse cached JD content | `npx job-forge cache:has --url <url>` / `npx job-forge cache:get --url <url>` | `npm run cache:has -- --url ...` |
 | Query local artifact pointers | `npx job-forge index:query "Acme"` / `npx job-forge index:has --key company-role:acme:staff-engineer` | `npm run index:query -- Acme` |
 | Query local source-backed facts | `npx job-forge facts:query --fact job.url` / `npx job-forge facts:has --fact application.status --key company-role:acme:staff-engineer` | `npm run facts:query -- --fact job.url` |
+| Materialize follow-up timeline | `npx job-forge timeline:build` | `npm run timeline:build` |
 | Apply safe consumer migrations | `npx job-forge migrate:apply` | `npm run migrate:apply` |
 | Re-create harness symlinks | `npx job-forge sync` | `npm run sync` |
 | Build optional dashboard TUI (Go on `PATH`) | `(cd node_modules/job-forge/dashboard && go build .)` | `npm run build:dashboard` (harness repo only) |

package/iso/commands/job-forge.md

@@ -93,6 +93,10 @@ Postflight dispatch settlement (terminal, outside opencode):
   npx job-forge postflight:status --plan batch/preflight-plan.json --outcomes batch/postflight-outcomes.json
   npx job-forge postflight:check --plan batch/preflight-plan.json --outcomes batch/postflight-outcomes.json
 
+Follow-up timeline (terminal, outside opencode):
+  npx job-forge timeline:due
+  npx job-forge timeline:check --fail-on overdue
+
 Consumer migrations (terminal, outside opencode):
   npx job-forge migrate:plan           # preview package.json/.gitignore drift
   npx job-forge migrate:apply          # apply safe harness upgrade migrations

package/iso/instructions.md

@@ -19,7 +19,7 @@ AI-powered job search pipeline: scans portals, evaluates offers, generates CVs v
 - [H5] Re-dispatch the same company only AFTER the previous subagent returns. Never fire the same `task` twice while the first is still in flight.
   why: two in-flight subagents for the same URL race on Geometra sessions and on tracker TSV writes, corrupting state and sometimes double-submitting
 
-- [H5b] Do not use `task` to poll task status. If OpenCode returns a task/session id without a final result, record the id, stop dispatching new rounds, and tell the user the round is still in flight. When the user asks to check later, inspect authoritative files (`batch/tracker-additions/*.tsv`, `batch/tracker-additions/merged/*.tsv`, day files, `.jobforge-ledger/events.jsonl`, `.jobforge-index.json`, `.jobforge-facts.json`, or `iso-trace`) rather than spawning a "check task status" subagent.
+- [H5b] Do not use `task` to poll task status. If OpenCode returns a task/session id without a final result, record the id, stop dispatching new rounds, and tell the user the round is still in flight. When the user asks to check later, inspect authoritative files (`batch/tracker-additions/*.tsv`, `batch/tracker-additions/merged/*.tsv`, day files, `.jobforge-ledger/events.jsonl`, `.jobforge-index.json`, `.jobforge-facts.json`, `.jobforge-timeline.json`, or `iso-trace`) rather than spawning a "check task status" subagent.
   why: OpenCode status prompts can be delivered into the target subagent as a new user message; a 2026-04-25 trace caused a subagent to call `task` recursively instead of finishing the application
 
 - [H6] Application outcomes flow through `batch/tracker-additions/*.tsv`, not `data/pipeline.md`. After any multi-apply run, the orchestrator MUST run `npx job-forge merge` then `npx job-forge verify` before ending the session.
@@ -93,11 +93,14 @@ AI-powered job search pipeline: scans portals, evaluates offers, generates CVs v
 - [D19] Treat `templates/score.json` as the source of truth for offer scoring weights, bands, and gates. After emitting a report score JSON that will drive PDF/application/batch decisions, run `npx job-forge score:check --input <file>`; for apply decisions run `npx job-forge score:gate --input <file> --gate apply`. Do not recalculate weighted totals or thresholds manually when the local helper can check them.
   why: `iso-score` is not an MCP and adds no prompt/tool-schema tokens; it makes scoring math, recommendation bands, and threshold booleans executable local policy instead of repeated model prose
 
+- [D20] Treat `templates/timeline.json` as the source of truth for follow-up and next-action timing. For follow-up triage, run `npx job-forge timeline:due` before reading tracker files; use `npx job-forge timeline:check --fail-on overdue` when a workflow must fail only on stale actions. Use `timeline:build` when a durable `.jobforge-timeline.json` artifact is useful.
+  why: `iso-timeline` is not an MCP and adds no prompt/tool-schema tokens; it turns timing windows over tracker/pipeline sources into executable local policy instead of repeated date math in model context
+
 ## Procedure
 
 1. Check `cv.md`, `profile.yml`, and `portals.yml`; onboard if any file is missing.
 2. Pick and name the mode from **Routing** [D6]. No match → ask; do not guess.
-3. Read the active mode file [D3]. Use context bundle checks when changing context loads [D11]. Check cached artifacts before URL/JD refetches [D12]. Use artifact index lookups before broad file reads when they can answer the question [D13]. Use materialized facts when a fact query can answer the question [D13b]. Use canonical identity keys for duplicate checks [D15]. Use score checks/gates for scoring decisions [D19]. Use migration checks for harness drift [D14]. Use redaction checks before exporting local artifacts [D18]. Decide inline vs delegated work [D1].
+3. Read the active mode file [D3]. Use context bundle checks when changing context loads [D11]. Check cached artifacts before URL/JD refetches [D12]. Use artifact index lookups before broad file reads when they can answer the question [D13]. Use materialized facts when a fact query can answer the question [D13b]. Use canonical identity keys for duplicate checks [D15]. Use score checks/gates for scoring decisions [D19]. Use timeline due/check commands for follow-up timing [D20]. Use migration checks for harness drift [D14]. Use redaction checks before exporting local artifacts [D18]. Decide inline vs delegated work [D1].
 4. Prepare Geometra dispatches: cleanup [H3], canon/index/facts/ledger prefilter when useful [D8, D13, D13b, D15], dedupe [H2], location filter [D5], materialize candidate facts/gates and run preflight plan/check [D16], routing [D2, D10], proxy prompt hygiene [H8].
 5. Dispatch at most 2 tasks per round [H1]; wait for final outcomes, not just task ids [H5b], then settle the round with postflight status [D17].
 6. Keep multi-job form-filling out of the orchestrator [H4].

package/lib/jobforge-timeline.mjs

@@ -0,0 +1,294 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { dirname, isAbsolute, join, relative } from 'path';
+import {
+  checkTimeline,
+  filterTimelineResult,
+  loadTimelineConfig,
+  parseJson,
+  parseJsonLines,
+  planTimeline,
+  verifyTimelineResult,
+} from '@razroo/iso-timeline';
+import { DATA_APPS_DIR, PROJECT_DIR, readAllEntries } from '../tracker-lib.mjs';
+import { jobForgeCompanyRoleKey, jobForgeUrlKey, legacyCompanyRoleKey, legacyUrlKey } from './jobforge-canon.mjs';
+
+export const TIMELINE_CONFIG_FILE = 'templates/timeline.json';
+export const TIMELINE_FILE = '.jobforge-timeline.json';
+export const TIMELINE_EVENTS_FILE = '.jobforge-timeline-events.jsonl';
+export const USER_TIMELINE_EVENTS_FILE = 'data/timeline-events.jsonl';
+
+export function resolveProjectDir(projectDir = process.env.JOB_FORGE_PROJECT || process.cwd()) {
+  return projectDir;
+}
+
+export function jobForgeTimelineConfigPath(projectDir = resolveProjectDir()) {
+  return process.env.JOB_FORGE_TIMELINE_CONFIG || join(projectDir, TIMELINE_CONFIG_FILE);
+}
+
+export function jobForgeTimelinePath(projectDir = resolveProjectDir()) {
+  return process.env.JOB_FORGE_TIMELINE || join(projectDir, TIMELINE_FILE);
+}
+
+export function jobForgeTimelineEventsPath(projectDir = resolveProjectDir()) {
+  return process.env.JOB_FORGE_TIMELINE_EVENTS || join(projectDir, TIMELINE_EVENTS_FILE);
+}
+
+export function readJobForgeTimelineConfig(projectDir = resolveProjectDir()) {
+  const path = jobForgeTimelineConfigPath(projectDir);
+  return loadTimelineConfig(parseJson(readFileSync(path, 'utf8'), path));
+}
+
+export function timelineExists(projectDir = resolveProjectDir()) {
+  return existsSync(jobForgeTimelinePath(projectDir));
+}
+
+export function timelineEventsExist(projectDir = resolveProjectDir()) {
+  return existsSync(jobForgeTimelineEventsPath(projectDir));
+}
+
+export function readJobForgeTimeline(projectDir = resolveProjectDir()) {
+  const path = jobForgeTimelinePath(projectDir);
+  return parseJson(readFileSync(path, 'utf8'), path);
+}
+
+export function buildJobForgeTimelineEvents(projectDir = resolveProjectDir()) {
+  const events = [
+    ...applicationEvents(projectDir),
+    ...pipelineEvents(projectDir),
+    ...userEvents(projectDir),
+  ];
+  events.sort(compareEvents);
+  return events;
+}
+
+export function writeJobForgeTimelineEvents(events, options = {}, projectDir = resolveProjectDir()) {
+  const out = options.out || jobForgeTimelineEventsPath(projectDir);
+  mkdirSync(dirname(out), { recursive: true });
+  const content = events.map((event) => JSON.stringify(event)).join('\n');
+  writeFileSync(out, `${content}${content ? '\n' : ''}`, 'utf8');
+  return out;
+}
+
+export function planJobForgeTimeline(options = {}, projectDir = resolveProjectDir()) {
+  const config = readJobForgeTimelineConfig(projectDir);
+  const events = options.events || buildJobForgeTimelineEvents(projectDir);
+  return planTimeline(config, events, { now: options.now });
+}
+
+export function dueJobForgeTimeline(options = {}, projectDir = resolveProjectDir()) {
+  return filterTimelineResult(planJobForgeTimeline(options, projectDir), ['overdue', 'due']);
+}
+
+export function checkJobForgeTimeline(options = {}, projectDir = resolveProjectDir()) {
+  const config = readJobForgeTimelineConfig(projectDir);
+  const events = options.events || buildJobForgeTimelineEvents(projectDir);
+  return checkTimeline(config, events, { now: options.now, failOn: options.failOn });
+}
+
+export function buildJobForgeTimeline(options = {}, projectDir = resolveProjectDir()) {
+  const events = buildJobForgeTimelineEvents(projectDir);
+  const result = planJobForgeTimeline({ now: options.now, events }, projectDir);
+  const eventsOut = writeJobForgeTimelineEvents(events, { out: options.eventsOut }, projectDir);
+  const out = options.out || jobForgeTimelinePath(projectDir);
+  mkdirSync(dirname(out), { recursive: true });
+  writeFileSync(out, `${JSON.stringify(result, null, 2)}\n`, 'utf8');
+  return { result, events, out, eventsOut };
+}
+
+export function verifyJobForgeTimeline(options = {}, projectDir = resolveProjectDir()) {
+  const result = options.result || readJobForgeTimeline(projectDir);
+  return verifyTimelineResult(result);
+}
+
+export function jobForgeTimelineSummary(projectDir = resolveProjectDir()) {
+  if (!timelineExists(projectDir)) {
+    return {
+      path: jobForgeTimelinePath(projectDir),
+      eventsPath: jobForgeTimelineEventsPath(projectDir),
+      config: jobForgeTimelineConfigPath(projectDir),
+      exists: false,
+      eventsExists: timelineEventsExist(projectDir),
+      items: 0,
+      due: 0,
+      overdue: 0,
+    };
+  }
+  const result = readJobForgeTimeline(projectDir);
+  return {
+    path: jobForgeTimelinePath(projectDir),
+    eventsPath: jobForgeTimelineEventsPath(projectDir),
+    config: jobForgeTimelineConfigPath(projectDir),
+    exists: true,
+    eventsExists: timelineEventsExist(projectDir),
+    items: result.stats?.total || 0,
+    due: result.stats?.due || 0,
+    overdue: result.stats?.overdue || 0,
+    generatedAt: result.generatedAt,
+    id: result.id,
+  };
+}
+
+function applicationEvents(projectDir) {
+  const { entries } = readAllEntries();
+  return entries
+    .map((entry) => applicationEvent(entry, projectDir))
+    .filter(Boolean);
+}
+
+function applicationEvent(entry, projectDir) {
+  const at = dateToIso(entry.date);
+  if (!at || !entry.company || !entry.role || !entry.status) return null;
+  const status = canonicalStatus(entry.status);
+  const key = safeCompanyRoleKey(entry.company, entry.role, projectDir);
+  return {
+    id: `jobforge:application-status:${entry.num}:${key}:${at}`,
+    key,
+    type: 'application.status',
+    at,
+    data: compactObject({
+      num: entry.num,
+      date: entry.date,
+      company: entry.company,
+      role: entry.role,
+      score: entry.score,
+      status,
+      pdf: entry.pdf,
+      report: entry.report,
+      notes: entry.notes,
+    }),
+    source: sourceForApplication(entry, projectDir),
+  };
+}
+
+function pipelineEvents(projectDir) {
+  const pipelinePath = join(projectDir, 'data', 'pipeline.md');
+  if (!existsSync(pipelinePath)) return [];
+  const scanDates = scanHistoryDates(projectDir);
+  const lines = readFileSync(pipelinePath, 'utf8').split('\n');
+  const events = [];
+  lines.forEach((line, index) => {
+    const match = line.match(/^\s*-\s*\[([ xX])\]\s+(https?:\/\/[^|\s#]+)(.*)$/);
+    if (!match) return;
+    const url = match[2].trim();
+    const at = dateToIso(scanDates.get(url) || firstDateInText(line));
+    if (!at) return;
+    const fields = (match[3] || '').split('|').map((field) => field.trim()).filter(Boolean);
+    const status = match[1].toLowerCase() === 'x' ? 'processed' : 'pending';
+    const key = safeUrlKey(url, projectDir);
+    events.push({
+      id: `jobforge:pipeline:${status}:${key}:${at}`,
+      key,
+      type: status === 'processed' ? 'pipeline.processed' : 'pipeline.item',
+      at,
+      data: compactObject({
+        status,
+        url,
+        company: fields[0],
+        role: fields[1],
+      }),
+      source: {
+        path: 'data/pipeline.md',
+        line: index + 1,
+      },
+    });
+  });
+  return events;
+}
+
+function userEvents(projectDir) {
+  const path = join(projectDir, USER_TIMELINE_EVENTS_FILE);
+  if (!existsSync(path)) return [];
+  return parseJsonLines(readFileSync(path, 'utf8'), path);
+}
+
+function scanHistoryDates(projectDir) {
+  const path = join(projectDir, 'data', 'scan-history.tsv');
+  const dates = new Map();
+  if (!existsSync(path)) return dates;
+  const lines = readFileSync(path, 'utf8').split('\n');
+  for (const line of lines) {
+    if (!line.trim()) continue;
+    const parts = line.split('\t');
+    if (parts.length < 4) continue;
+    const date = parts[0]?.trim();
+    const url = parts[3]?.trim();
+    if (/^\d{4}-\d{2}-\d{2}/.test(date) && /^https?:\/\//.test(url)) dates.set(url, date);
+  }
+  return dates;
+}
+
+function sourceForApplication(entry, projectDir) {
+  const raw = String(entry._sourceFile || '');
+  if (/^\d{4}-\d{2}-\d{2}\.md$/.test(raw)) {
+    return { path: relativePath(projectDir, join(DATA_APPS_DIR, raw)) };
+  }
+  if (raw) return { path: relativePath(projectDir, raw) };
+  return undefined;
+}
+
+function dateToIso(value) {
+  const text = String(value || '').trim();
+  if (!text) return null;
+  if (/^\d{4}-\d{2}-\d{2}$/.test(text)) return `${text}T12:00:00.000Z`;
+  const parsed = new Date(text);
+  return Number.isNaN(parsed.getTime()) ? null : parsed.toISOString();
+}
+
+function firstDateInText(value) {
+  return String(value || '').match(/\b\d{4}-\d{2}-\d{2}\b/)?.[0] || '';
+}
+
+function canonicalStatus(value) {
+  const text = String(value || '').trim();
+  const lower = text.toLowerCase();
+  const map = new Map([
+    ['evaluated', 'Evaluated'],
+    ['applied', 'Applied'],
+    ['responded', 'Responded'],
+    ['contacted', 'Contacted'],
+    ['interview', 'Interview'],
+    ['offer', 'Offer'],
+    ['rejected', 'Rejected'],
+    ['discarded', 'Discarded'],
+    ['failed', 'Failed'],
+    ['skip', 'SKIP'],
+  ]);
+  return map.get(lower) || text;
+}
+
+function safeCompanyRoleKey(company, role, projectDir) {
+  try {
+    return jobForgeCompanyRoleKey(company, role, projectDir);
+  } catch {
+    return legacyCompanyRoleKey(company, role);
+  }
+}
+
+function safeUrlKey(url, projectDir) {
+  try {
+    return jobForgeUrlKey(url, projectDir);
+  } catch {
+    return legacyUrlKey(url);
+  }
+}
+
+function compactObject(obj) {
+  const out = {};
+  for (const [key, value] of Object.entries(obj || {})) {
+    if (value === undefined || value === null || value === '') continue;
+    out[key] = value;
+  }
+  return out;
+}
+
+function compareEvents(a, b) {
+  return `${a.at}\0${a.key}\0${a.type}\0${a.id || ''}`.localeCompare(`${b.at}\0${b.key}\0${b.type}\0${b.id || ''}`);
+}
+
+function relativePath(projectDir, value) {
+  const text = String(value || '');
+  if (!text) return '';
+  const rel = relative(projectDir, text);
+  if (rel && !rel.startsWith('..') && !isAbsolute(rel)) return rel.replace(/\\/g, '/');
+  return text.replace(/\\/g, '/');
+}

package/modes/followup.md

@@ -1,6 +1,6 @@
 # Mode: followup — Follow-Up Timing & Nudge System
 
-Scans all day files in `data/applications/` for entries that need follow-up action based on their current state and how long they've been in that state.
+Uses `job-forge timeline:*` to scan local tracker and dated pipeline sources for entries that need follow-up action based on their current state and how long they've been in that state.
 
 **This mode is read-only on existing pipeline logic.** It reads the tracker and suggests actions — it never changes scores, reports, or pipeline behavior.
 
@@ -19,11 +19,11 @@ Scans all day files in `data/applications/` for entries that need follow-up acti
 
 ## Run This Workflow
 
-1. **Read** all day files in `data/applications/` — parse all entries with dates.
-2. **Compute** days since the date column for each entry (using today's date).
-3. **Filter** to entries matching the Timing Rules table above.
-4. **Sort** by urgency (most overdue first).
-5. **Present** action list.
+1. Run `npx job-forge timeline:due` first. It rebuilds the due queue from local tracker/pipeline sources without loading growing files into prompt context.
+2. If the user wants a persistent artifact, run `npx job-forge timeline:build`.
+3. Use `npx job-forge timeline:check --fail-on overdue` when the workflow should fail only on stale actions.
+4. Present the action list grouped by `OVERDUE`, `DUE`, and upcoming manual context if needed.
+5. Only read individual tracker/report files after the user selects an action that needs message drafting.
 
 ```
 ## Follow-Up Actions — {today's date}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "job-forge",
-  "version": "2.14.32",
+  "version": "2.14.33",
   "description": "AI-powered job search pipeline built on opencode",
   "type": "module",
   "bin": {
@@ -78,6 +78,13 @@
     "postflight:status": "node bin/job-forge.mjs postflight:status",
     "postflight:check": "node bin/job-forge.mjs postflight:check",
     "postflight:explain": "node bin/job-forge.mjs postflight:explain",
+    "timeline:status": "node bin/job-forge.mjs timeline:status",
+    "timeline:build": "node bin/job-forge.mjs timeline:build",
+    "timeline:plan": "node bin/job-forge.mjs timeline:plan",
+    "timeline:due": "node bin/job-forge.mjs timeline:due",
+    "timeline:check": "node bin/job-forge.mjs timeline:check",
+    "timeline:verify": "node bin/job-forge.mjs timeline:verify",
+    "timeline:explain": "node bin/job-forge.mjs timeline:explain",
     "redact:scan": "node bin/job-forge.mjs redact:scan",
     "redact:verify": "node bin/job-forge.mjs redact:verify",
     "redact:apply": "node bin/job-forge.mjs redact:apply",
@@ -167,6 +174,7 @@
     "@razroo/iso-preflight": "^0.1.0",
     "@razroo/iso-redact": "^0.1.0",
     "@razroo/iso-score": "^0.1.0",
+    "@razroo/iso-timeline": "^0.1.0",
     "@razroo/iso-trace": "^0.4.0",
     "playwright": "^1.58.1"
   },

package/scripts/check-iso-smoke.mjs

@@ -20,6 +20,7 @@ const checks = [
   ["H6 requires merge and verify", () => every(files.instructions, ["batch/tracker-additions/*.tsv", "npx job-forge merge", "npx job-forge verify"])],
   ["H7 distrusts subagent prose", () => every(files.instructions, ["must originate from a file", "not from prior subagent prose"])],
   ["score policy points to local helper", () => every(files.instructions, ["[D19]", "templates/score.json", "npx job-forge score:check", "npx job-forge score:gate"])],
+  ["timeline policy points to local helper", () => every(files.instructions, ["[D20]", "templates/timeline.json", "npx job-forge timeline:due", "npx job-forge timeline:check --fail-on overdue"])],
   ["shared prompt points to on-demand references", () => every(files.instructions, ["modes/{mode}.md", "modes/reference-setup.md", "modes/reference-portals.md", "modes/reference-geometra.md"])],
   ["apply mode owns high-stakes upgrade", () => every(files.apply, ["[D8]", "@general-paid", "4.0/5", "high-stakes"])],
   ["apply mode blocks provider auto-downgrade", () => every(files.apply, ["[D9]", "do not auto-downgrade", "inspect telemetry before retrying"])],

package/scripts/timeline.mjs

@@ -0,0 +1,237 @@
+#!/usr/bin/env node
+
+import { writeFileSync } from 'fs';
+import { isAbsolute, relative, resolve } from 'path';
+import {
+  formatCheckResult,
+  formatConfigSummary,
+  formatTimelineResult,
+  formatVerifyResult,
+} from '@razroo/iso-timeline';
+import { PROJECT_DIR } from '../tracker-lib.mjs';
+import {
+  buildJobForgeTimeline,
+  buildJobForgeTimelineEvents,
+  checkJobForgeTimeline,
+  dueJobForgeTimeline,
+  jobForgeTimelineConfigPath,
+  jobForgeTimelineEventsPath,
+  jobForgeTimelinePath,
+  jobForgeTimelineSummary,
+  planJobForgeTimeline,
+  readJobForgeTimelineConfig,
+  timelineExists,
+  verifyJobForgeTimeline,
+} from '../lib/jobforge-timeline.mjs';
+
+const USAGE = `job-forge timeline - deterministic follow-up and next-action planning
+
+Usage:
+  job-forge timeline:status [--json]
+  job-forge timeline:build [--now <iso>] [--json]
+  job-forge timeline:plan [--now <iso>] [--out <file>] [--json]
+  job-forge timeline:due [--now <iso>] [--json]
+  job-forge timeline:check [--now <iso>] [--fail-on overdue|due|none] [--json]
+  job-forge timeline:verify [--json]
+  job-forge timeline:explain [--json]
+  job-forge timeline:path [--config|--events]
+
+Default policy is templates/timeline.json. Tracker day files and dated pipeline
+items are converted into .jobforge-timeline-events.jsonl; the plan is written
+to .jobforge-timeline.json by timeline:build. This is local project state, not
+an MCP and not prompt context.`;
+
+const [cmd = 'help', ...rawArgs] = process.argv.slice(2);
+const opts = parseArgs(rawArgs);
+
+if (opts.help || cmd === 'help' || cmd === '--help' || cmd === '-h') {
+  console.log(USAGE);
+  process.exit(0);
+}
+
+try {
+  if (cmd === 'path') {
+    path(opts);
+  } else if (cmd === 'status') {
+    status(opts);
+  } else if (cmd === 'build') {
+    build(opts);
+  } else if (cmd === 'plan') {
+    plan(opts);
+  } else if (cmd === 'due') {
+    due(opts);
+  } else if (cmd === 'check') {
+    check(opts);
+  } else if (cmd === 'verify') {
+    verify(opts);
+  } else if (cmd === 'explain') {
+    explain(opts);
+  } else {
+    console.error(`unknown timeline command "${cmd}"\n`);
+    console.error(USAGE);
+    process.exit(2);
+  }
+} catch (error) {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exit(1);
+}
+
+function parseArgs(args) {
+  const opts = {
+    json: false,
+    help: false,
+    failOn: undefined,
+  };
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === '--json') {
+      opts.json = true;
+    } else if (arg === '--now') {
+      opts.now = valueAfter(args, ++i, '--now');
+    } else if (arg.startsWith('--now=')) {
+      opts.now = arg.slice('--now='.length);
+    } else if (arg === '--fail-on') {
+      opts.failOn = valueAfter(args, ++i, '--fail-on');
+    } else if (arg.startsWith('--fail-on=')) {
+      opts.failOn = arg.slice('--fail-on='.length);
+    } else if (arg === '--out') {
+      opts.out = valueAfter(args, ++i, '--out');
+    } else if (arg.startsWith('--out=')) {
+      opts.out = arg.slice('--out='.length);
+    } else if (arg === '--config') {
+      opts.configPath = true;
+    } else if (arg === '--events') {
+      opts.eventsPath = true;
+    } else if (arg === '--help' || arg === '-h') {
+      opts.help = true;
+    } else {
+      throw new Error(`unknown flag "${arg}"`);
+    }
+  }
+
+  return opts;
+}
+
+function valueAfter(values, index, flag) {
+  const value = values[index];
+  if (!value || value.startsWith('--')) throw new Error(`${flag} requires a value`);
+  return value;
+}
+
+function path(opts) {
+  if (opts.configPath) {
+    console.log(jobForgeTimelineConfigPath(PROJECT_DIR));
+  } else if (opts.eventsPath) {
+    console.log(jobForgeTimelineEventsPath(PROJECT_DIR));
+  } else {
+    console.log(jobForgeTimelinePath(PROJECT_DIR));
+  }
+}
+
+function status(opts) {
+  const summary = jobForgeTimelineSummary(PROJECT_DIR);
+  if (opts.json) {
+    console.log(JSON.stringify(summary, null, 2));
+    return;
+  }
+  if (!summary.exists) {
+    console.log(`timeline: missing (${relativePath(summary.path)})`);
+    console.log('run: job-forge timeline:build');
+    return;
+  }
+  const verifyResult = verifyJobForgeTimeline({}, PROJECT_DIR);
+  console.log(`timeline: ${relativePath(summary.path)}`);
+  console.log(`events:   ${relativePath(summary.eventsPath)} (${summary.eventsExists ? 'present' : 'missing'})`);
+  console.log(`items:    ${summary.items}`);
+  console.log(`due:      ${summary.due}`);
+  console.log(`overdue:  ${summary.overdue}`);
+  console.log(`verify:   ${verifyResult.ok ? 'PASS' : 'FAIL'} (${verifyResult.errors} errors, ${verifyResult.warnings} warnings)`);
+}
+
+function build(opts) {
+  const result = buildJobForgeTimeline({ now: opts.now }, PROJECT_DIR);
+  if (opts.json) {
+    console.log(JSON.stringify({
+      out: result.out,
+      eventsOut: result.eventsOut,
+      events: result.events.length,
+      stats: result.result.stats,
+    }, null, 2));
+    return;
+  }
+  console.log(`timeline: wrote ${relativePath(result.out)}`);
+  console.log(`events:   wrote ${relativePath(result.eventsOut)} (${result.events.length} event(s))`);
+  console.log(formatTimelineResult(result.result));
+}
+
+function plan(opts) {
+  const result = planJobForgeTimeline({ now: opts.now }, PROJECT_DIR);
+  if (opts.out) writePlan(resolveInputPath(opts.out), result);
+  if (opts.json) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  console.log(formatTimelineResult(result));
+}
+
+function due(opts) {
+  const result = dueJobForgeTimeline({ now: opts.now }, PROJECT_DIR);
+  if (opts.json) {
+    console.log(JSON.stringify(result, null, 2));
+  } else {
+    console.log(formatTimelineResult(result));
+  }
+}
+
+function check(opts) {
+  const result = checkJobForgeTimeline({ now: opts.now, failOn: opts.failOn }, PROJECT_DIR);
+  if (opts.json) {
+    console.log(JSON.stringify(result, null, 2));
+  } else {
+    console.log(formatCheckResult(result));
+  }
+  process.exit(result.ok ? 0 : 1);
+}
+
+function verify(opts) {
+  if (!timelineExists(PROJECT_DIR)) {
+    if (opts.json) {
+      console.log(JSON.stringify({ ok: true, missing: true, path: jobForgeTimelinePath(PROJECT_DIR) }, null, 2));
+    } else {
+      console.log(`timeline: missing (${relativePath(jobForgeTimelinePath(PROJECT_DIR))})`);
+    }
+    return;
+  }
+  const result = verifyJobForgeTimeline({}, PROJECT_DIR);
+  if (opts.json) {
+    console.log(JSON.stringify(result, null, 2));
+  } else {
+    console.log(formatVerifyResult(result));
+  }
+  process.exit(result.ok ? 0 : 1);
+}
+
+function explain(opts) {
+  const config = readJobForgeTimelineConfig(PROJECT_DIR);
+  if (opts.json) {
+    console.log(JSON.stringify(config, null, 2));
+    return;
+  }
+  console.log(`config: ${relativePath(jobForgeTimelineConfigPath(PROJECT_DIR))}`);
+  console.log(formatConfigSummary(config));
+  const events = buildJobForgeTimelineEvents(PROJECT_DIR);
+  console.log(`events available now: ${events.length}`);
+}
+
+function resolveInputPath(path) {
+  return isAbsolute(path) ? path : resolve(PROJECT_DIR, path);
+}
+
+function relativePath(path) {
+  return relative(PROJECT_DIR, path) || '.';
+}
+
+function writePlan(path, result) {
+  writeFileSync(path, `${JSON.stringify(result, null, 2)}\n`, 'utf8');
+}

package/templates/migrations.json

@@ -56,6 +56,13 @@
             "postflight:status": "job-forge postflight:status",
             "postflight:check": "job-forge postflight:check",
             "postflight:explain": "job-forge postflight:explain",
+            "timeline:status": "job-forge timeline:status",
+            "timeline:build": "job-forge timeline:build",
+            "timeline:plan": "job-forge timeline:plan",
+            "timeline:due": "job-forge timeline:due",
+            "timeline:check": "job-forge timeline:check",
+            "timeline:verify": "job-forge timeline:verify",
+            "timeline:explain": "job-forge timeline:explain",
             "redact:scan": "job-forge redact:scan",
             "redact:verify": "job-forge redact:verify",
             "redact:apply": "job-forge redact:apply",
@@ -83,7 +90,10 @@
             ".jobforge-cache/",
             ".jobforge-index.json",
             ".jobforge-facts.json",
+            ".jobforge-timeline.json",
+            ".jobforge-timeline-events.jsonl",
             ".jobforge-redacted/",
+            "data/timeline-events.jsonl",
             "batch/preflight-candidates.json",
             "batch/preflight-plan.json",
             "batch/postflight-outcomes.json"

package/templates/timeline.json

@@ -0,0 +1,86 @@
+{
+  "version": 1,
+  "defaults": {
+    "overdueAfter": "7d",
+    "latestOnly": true
+  },
+  "rules": [
+    {
+      "id": "applied-follow-up",
+      "label": "Applied follow-up",
+      "description": "Applications in Applied state should receive a follow-up after one week.",
+      "action": "send_follow_up",
+      "match": {
+        "type": "application.status",
+        "where": {
+          "data.status": "Applied"
+        }
+      },
+      "after": "7d"
+    },
+    {
+      "id": "contacted-follow-up",
+      "label": "Contacted follow-up",
+      "description": "Outreach/contacted rows should receive a shorter follow-up after five days.",
+      "action": "send_contact_follow_up",
+      "match": {
+        "type": "application.status",
+        "where": {
+          "data.status": "Contacted"
+        }
+      },
+      "after": "5d",
+      "overdueAfter": "7d"
+    },
+    {
+      "id": "interview-thank-you",
+      "label": "Interview thank-you",
+      "description": "Interview rows should prompt a thank-you note the next day.",
+      "action": "send_thank_you",
+      "match": {
+        "type": "application.status",
+        "where": {
+          "data.status": "Interview"
+        }
+      },
+      "after": "1d",
+      "overdueAfter": "2d"
+    },
+    {
+      "id": "interview-follow-up",
+      "label": "Interview follow-up",
+      "description": "Interview rows without a later status should receive a recruiter nudge after one week.",
+      "action": "follow_up_after_interview",
+      "match": {
+        "type": "application.status",
+        "where": {
+          "data.status": "Interview"
+        }
+      },
+      "after": "7d",
+      "overdueAfter": "10d"
+    },
+    {
+      "id": "stale-pipeline-item",
+      "label": "Stale pending pipeline item",
+      "description": "Pending pipeline URLs with a known source date should be processed or discarded after three days.",
+      "action": "process_or_discard_pipeline_item",
+      "match": {
+        "type": "pipeline.item",
+        "where": {
+          "data.status": "pending"
+        }
+      },
+      "after": "3d",
+      "overdueAfter": "4d",
+      "suppressWhen": [
+        {
+          "type": [
+            "pipeline.processed",
+            "application.status"
+          ]
+        }
+      ]
+    }
+  ]
+}

package/verify-pipeline.mjs

@@ -19,6 +19,7 @@
  * 10. Ledger file verifies if .jobforge-ledger/events.jsonl exists
  * 11. Artifact index verifies if .jobforge-index.json exists
  * 12. Fact set verifies if .jobforge-facts.json exists
+ * 13. Timeline verifies if .jobforge-timeline.json exists
  *
  * Run: node verify-pipeline.mjs   (from repo root; same as npm run verify)
  */
@@ -33,6 +34,7 @@ import {
 import { jobForgeLedgerPath, ledgerExists, verifyJobForgeLedger } from './lib/jobforge-ledger.mjs';
 import { indexExists, jobForgeIndexPath, verifyJobForgeIndex } from './lib/jobforge-index.mjs';
 import { factsExist, jobForgeFactsPath, verifyJobForgeFacts } from './lib/jobforge-facts.mjs';
+import { jobForgeTimelinePath, timelineExists, verifyJobForgeTimeline } from './lib/jobforge-timeline.mjs';
 import {
   canonicalStatusValues,
   formatContractIssues,
@@ -189,6 +191,22 @@ function verifyFactsIfPresent() {
   }
 }
 
+function verifyTimelineIfPresent() {
+  if (!timelineExists(PROJECT_DIR)) {
+    ok('Timeline not initialized');
+    return;
+  }
+  const result = verifyJobForgeTimeline({}, PROJECT_DIR);
+  for (const issue of result.issues) {
+    const msg = `timeline: ${issue.code}: ${issue.message}`;
+    if (issue.severity === 'error') error(msg);
+    else warn(msg);
+  }
+  if (result.ok) {
+    ok(`Timeline valid (${relative(PROJECT_DIR, jobForgeTimelinePath(PROJECT_DIR))})`);
+  }
+}
+
 // --- Read entries ---
 const { entries, source } = readAllEntries();
 
@@ -200,6 +218,7 @@ if (entries.length === 0) {
   verifyLedgerIfPresent();
   verifyIndexIfPresent();
   verifyFactsIfPresent();
+  verifyTimelineIfPresent();
   console.log('\n' + '='.repeat(50));
   console.log(`📊 Pipeline Health: ${errors} errors, ${warnings} warnings`);
   if (errors === 0 && warnings === 0) console.log('🟢 Pipeline is clean!');
@@ -337,6 +356,7 @@ verifyStatesYamlDrift();
 verifyLedgerIfPresent();
 verifyIndexIfPresent();
 verifyFactsIfPresent();
+verifyTimelineIfPresent();
 
 console.log('\n' + '='.repeat(50));
 console.log(`📊 Pipeline Health: ${errors} errors, ${warnings} warnings`);