job-forge 2.14.32 → 2.14.34

package/templates/prioritize.json

@@ -0,0 +1,125 @@
+{
+  "version": 1,
+  "defaults": {
+    "profile": "jobforge-next-action",
+    "limit": 3
+  },
+  "profiles": [
+    {
+      "name": "jobforge-next-action",
+      "description": "Rank JobForge follow-up, pipeline, and apply work by fit, urgency, age, and source quality.",
+      "criteria": [
+        {
+          "id": "fit-score",
+          "label": "Fit score",
+          "field": "score",
+          "weight": 45,
+          "direction": "desc",
+          "min": 0,
+          "max": 5,
+          "required": true
+        },
+        {
+          "id": "urgency",
+          "label": "Urgency",
+          "field": "urgency",
+          "weight": 30,
+          "direction": "desc",
+          "min": 0,
+          "max": 10,
+          "default": 0
+        },
+        {
+          "id": "age",
+          "label": "Age in days",
+          "field": "ageDays",
+          "weight": 15,
+          "direction": "desc",
+          "min": 0,
+          "max": 30,
+          "default": 0
+        },
+        {
+          "id": "source-quality",
+          "label": "Source quality",
+          "field": "sourceQuality",
+          "weight": 10,
+          "direction": "desc",
+          "min": 0,
+          "max": 1,
+          "default": 0.5
+        }
+      ],
+      "gates": [
+        {
+          "id": "already-rejected",
+          "action": "skip",
+          "reason": "terminal tracker state",
+          "when": {
+            "where": {
+              "status": [
+                "Rejected",
+                "Discarded",
+                "SKIP"
+              ]
+            }
+          }
+        },
+        {
+          "id": "duplicate",
+          "action": "skip",
+          "reason": "duplicate candidate",
+          "when": {
+            "where": {
+              "duplicate": true
+            }
+          }
+        }
+      ],
+      "adjustments": [
+        {
+          "id": "due-follow-up",
+          "value": 6,
+          "reason": "follow-up is due now",
+          "when": {
+            "type": "followup",
+            "where": {
+              "timelineState": [
+                "due",
+                "overdue"
+              ]
+            }
+          }
+        },
+        {
+          "id": "dream-company",
+          "value": 8,
+          "reason": "company is on the priority list",
+          "when": {
+            "where": {
+              "priorityCompany": true
+            }
+          }
+        },
+        {
+          "id": "weak-source",
+          "value": -12,
+          "reason": "source lacks a report or score provenance",
+          "when": {
+            "where": {
+              "sourceQuality": 0
+            }
+          }
+        }
+      ],
+      "quotas": [
+        {
+          "id": "one-per-company",
+          "field": "company",
+          "max": 1,
+          "reason": "keep the selected queue diverse"
+        }
+      ]
+    }
+  ]
+}

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,9 @@
  * 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
+ * 14. Priority queue verifies if .jobforge-prioritize.json exists
+ * 15. Artifact lineage verifies/checks if .jobforge-lineage.json exists
  *
  * Run: node verify-pipeline.mjs   (from repo root; same as npm run verify)
  */
@@ -33,6 +36,9 @@ 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 { jobForgePrioritizePath, prioritizeExists, verifyJobForgePrioritize } from './lib/jobforge-prioritize.mjs';
+import { checkJobForgeLineage, jobForgeLineagePath, lineageExists, verifyJobForgeLineage } from './lib/jobforge-lineage.mjs';
 import {
   canonicalStatusValues,
   formatContractIssues,
@@ -189,6 +195,62 @@ 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))})`);
+  }
+}
+
+function verifyPrioritizeIfPresent() {
+  if (!prioritizeExists(PROJECT_DIR)) {
+    ok('Priority queue not initialized');
+    return;
+  }
+  const result = verifyJobForgePrioritize({}, PROJECT_DIR);
+  for (const issue of result.issues) {
+    const msg = `prioritize: ${issue.code}: ${issue.message}`;
+    if (issue.severity === 'error') error(msg);
+    else warn(msg);
+  }
+  if (result.ok) {
+    ok(`Priority queue valid (${relative(PROJECT_DIR, jobForgePrioritizePath(PROJECT_DIR))})`);
+  }
+}
+
+function verifyLineageIfPresent() {
+  if (!lineageExists(PROJECT_DIR)) {
+    ok('Artifact lineage not initialized');
+    return;
+  }
+  const verifyResult = verifyJobForgeLineage({}, PROJECT_DIR);
+  for (const issue of verifyResult.issues) {
+    const msg = `lineage: ${issue.code}: ${issue.message}`;
+    if (issue.severity === 'error') error(msg);
+    else warn(msg);
+  }
+
+  const checkResult = checkJobForgeLineage({}, PROJECT_DIR);
+  for (const issue of checkResult.issues) {
+    const msg = `lineage: ${issue.code}: ${issue.message}`;
+    if (issue.severity === 'error') error(msg);
+    else warn(msg);
+  }
+
+  if (verifyResult.ok && checkResult.ok) {
+    ok(`Artifact lineage current (${checkResult.current}/${checkResult.total} records at ${relative(PROJECT_DIR, jobForgeLineagePath(PROJECT_DIR))})`);
+  }
+}
+
 // --- Read entries ---
 const { entries, source } = readAllEntries();
 
@@ -200,6 +262,9 @@ if (entries.length === 0) {
   verifyLedgerIfPresent();
   verifyIndexIfPresent();
   verifyFactsIfPresent();
+  verifyTimelineIfPresent();
+  verifyPrioritizeIfPresent();
+  verifyLineageIfPresent();
   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 +402,9 @@ verifyStatesYamlDrift();
 verifyLedgerIfPresent();
 verifyIndexIfPresent();
 verifyFactsIfPresent();
+verifyTimelineIfPresent();
+verifyPrioritizeIfPresent();
+verifyLineageIfPresent();
 
 console.log('\n' + '='.repeat(50));
 console.log(`📊 Pipeline Health: ${errors} errors, ${warnings} warnings`);