job-forge 2.14.26 → 2.14.28

package/scripts/preflight.mjs

@@ -0,0 +1,142 @@
+#!/usr/bin/env node
+
+import { readFileSync } from 'fs';
+import { isAbsolute, relative, resolve } from 'path';
+import {
+  formatConfigSummary,
+  formatPreflightPlan,
+  loadPreflightConfig,
+  parseJson,
+  planPreflight,
+} from '@razroo/iso-preflight';
+import { PROJECT_DIR } from '../tracker-lib.mjs';
+import {
+  jobForgePreflightConfigPath,
+  planJobForgePreflight,
+  readJobForgePreflightConfig,
+} from '../lib/jobforge-preflight.mjs';
+
+const USAGE = `job-forge preflight - deterministic dispatch planning for JobForge
+
+Usage:
+  job-forge preflight:plan --candidates <file> [--workflow jobforge.apply] [--json]
+  job-forge preflight:check --candidates <file> [--workflow jobforge.apply] [--json]
+  job-forge preflight:explain [--json]
+  job-forge preflight:path
+
+Candidate files are JSON arrays, or objects with a candidates array. The policy
+is templates/preflight.json. 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') {
+    console.log(configPath(opts));
+  } else if (cmd === 'plan' || cmd === 'check') {
+    runPlan(cmd, opts);
+  } else if (cmd === 'explain') {
+    explain(opts);
+  } else {
+    console.error(`unknown preflight 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,
+  };
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === '--json') {
+      opts.json = true;
+    } else if (arg === '--candidates' || arg === '-c') {
+      opts.candidates = valueAfter(args, ++i, arg);
+    } else if (arg.startsWith('--candidates=')) {
+      opts.candidates = arg.slice('--candidates='.length);
+    } else if (arg === '--workflow') {
+      opts.workflow = valueAfter(args, ++i, '--workflow');
+    } else if (arg.startsWith('--workflow=')) {
+      opts.workflow = arg.slice('--workflow='.length);
+    } else if (arg === '--config') {
+      opts.config = valueAfter(args, ++i, '--config');
+    } else if (arg.startsWith('--config=')) {
+      opts.config = arg.slice('--config='.length);
+    } else if (arg === '--help' || arg === '-h') {
+      opts.help = true;
+    } else {
+      throw new Error(`unknown flag "${arg}"`);
+    }
+  }
+
+  return opts;
+}
+
+function runPlan(mode, opts) {
+  if (!opts.candidates) throw new Error(`${mode} requires --candidates <file>`);
+  const candidates = readJsonFile(resolveInputPath(opts.candidates));
+  const result = opts.config
+    ? planPreflight(readConfig(opts), candidates, { workflow: opts.workflow })
+    : planJobForgePreflight(candidates, { workflow: opts.workflow }, PROJECT_DIR);
+
+  if (opts.json) {
+    console.log(JSON.stringify(result, null, 2));
+  } else {
+    console.log(formatPreflightPlan(result, mode));
+  }
+
+  if (mode === 'check' && !result.ok) process.exit(1);
+}
+
+function explain(opts) {
+  const config = readConfig(opts);
+  if (opts.json) {
+    console.log(JSON.stringify(config, null, 2));
+    return;
+  }
+  console.log(`config: ${relativePath(configPath(opts))}`);
+  console.log(formatConfigSummary(config));
+}
+
+function readConfig(opts) {
+  if (opts.config) {
+    const path = resolveInputPath(opts.config);
+    return loadPreflightConfig(readJsonFile(path));
+  }
+  return readJobForgePreflightConfig(PROJECT_DIR);
+}
+
+function configPath(opts) {
+  return opts.config ? resolveInputPath(opts.config) : jobForgePreflightConfigPath(PROJECT_DIR);
+}
+
+function readJsonFile(path) {
+  return parseJson(readFileSync(path, 'utf8'), path);
+}
+
+function valueAfter(values, index, flag) {
+  const value = values[index];
+  if (!value || value.startsWith('--')) throw new Error(`${flag} requires a value`);
+  return value;
+}
+
+function resolveInputPath(path) {
+  return isAbsolute(path) ? path : resolve(PROJECT_DIR, path);
+}
+
+function relativePath(path) {
+  return relative(PROJECT_DIR, path) || '.';
+}

package/templates/canon.json

@@ -0,0 +1,65 @@
+{
+  "version": 1,
+  "profiles": [
+    {
+      "name": "jobforge",
+      "url": {
+        "dropHash": true,
+        "stripWww": true,
+        "stripQueryParams": [
+          "utm_*",
+          "gh_src",
+          "source",
+          "ref",
+          "referrer",
+          "lever-source",
+          "ashby_jid"
+        ]
+      },
+      "company": {
+        "aliases": {
+          "open ai": "openai",
+          "anthropic pbc": "anthropic",
+          "google llc": "google",
+          "meta platforms": "meta"
+        },
+        "suffixes": [
+          "inc",
+          "incorporated",
+          "llc",
+          "ltd",
+          "limited",
+          "corp",
+          "corporation",
+          "company",
+          "co",
+          "pbc",
+          "plc"
+        ]
+      },
+      "role": {
+        "aliases": {
+          "fdse": "forward deployed software engineer",
+          "fullstack": "full stack",
+          "ml": "machine learning",
+          "sr": "senior",
+          "swe": "software engineer"
+        },
+        "stopWords": [
+          "hybrid",
+          "new york",
+          "onsite",
+          "remote",
+          "san francisco",
+          "united states",
+          "usa",
+          "us"
+        ]
+      },
+      "match": {
+        "strong": 0.92,
+        "possible": 0.78
+      }
+    }
+  ]
+}

package/templates/capabilities.json

@@ -13,6 +13,8 @@
           "npx job-forge context:*",
           "npx job-forge cache:*",
           "npx job-forge index:*",
+          "npx job-forge canon:*",
+          "npx job-forge preflight:*",
           "rg *"
         ],
         "deny": [
@@ -36,7 +38,8 @@
           "npx job-forge merge",
           "npx job-forge guard:*",
           "npx job-forge telemetry:*",
-          "npx job-forge trace:*"
+          "npx job-forge trace:*",
+          "npx job-forge preflight:*"
         ]
       },
       "filesystem": "read-only",
@@ -60,7 +63,9 @@
           "npx job-forge ledger:*",
           "npx job-forge capabilities:*",
           "npx job-forge cache:*",
-          "npx job-forge index:*"
+          "npx job-forge index:*",
+          "npx job-forge canon:*",
+          "npx job-forge preflight:*"
         ],
         "deny": [
           "task *"
@@ -100,6 +105,7 @@
       "commands": {
         "allow": [
           "npx job-forge slugify *",
+          "npx job-forge canon:*",
           "npx job-forge today",
           "npx job-forge next-num"
         ]

package/templates/migrations.json

@@ -33,6 +33,13 @@
             "index:has": "job-forge index:has",
             "index:query": "job-forge index:query",
             "index:explain": "job-forge index:explain",
+            "canon:normalize": "job-forge canon:normalize",
+            "canon:key": "job-forge canon:key",
+            "canon:compare": "job-forge canon:compare",
+            "canon:explain": "job-forge canon:explain",
+            "preflight:plan": "job-forge preflight:plan",
+            "preflight:check": "job-forge preflight:check",
+            "preflight:explain": "job-forge preflight:explain",
             "migrate:plan": "job-forge migrate:plan",
             "migrate:apply": "job-forge migrate:apply",
             "migrate:check": "job-forge migrate:check",

package/templates/preflight.json

@@ -0,0 +1,59 @@
+{
+  "version": 1,
+  "workflows": [
+    {
+      "name": "jobforge.apply",
+      "description": "Plan safe JobForge application dispatch rounds before Geometra/task work starts.",
+      "roundSize": 2,
+      "idFact": "id",
+      "conflictFact": "companyRoleKey",
+      "requiredFacts": [
+        "id",
+        "company",
+        "role",
+        "companyRoleKey",
+        "url",
+        "score"
+      ],
+      "sourceRequiredFacts": [
+        "company",
+        "role",
+        "companyRoleKey",
+        "url",
+        "score"
+      ],
+      "requireGateSources": true,
+      "gatePolicy": {
+        "skipStatuses": [
+          "skip",
+          "skipped"
+        ],
+        "blockStatuses": [
+          "block",
+          "blocked",
+          "fail",
+          "failed"
+        ]
+      },
+      "preSteps": [
+        {
+          "id": "geometra-cleanup",
+          "label": "Disconnect stale Geometra sessions before dispatch",
+          "command": "geometra_list_sessions && geometra_disconnect({ closeBrowser: true })"
+        }
+      ],
+      "postSteps": [
+        {
+          "id": "merge",
+          "label": "Merge tracker TSV outcomes",
+          "command": "npx job-forge merge"
+        },
+        {
+          "id": "verify",
+          "label": "Verify tracker integrity",
+          "command": "npx job-forge verify"
+        }
+      ]
+    }
+  ]
+}