Add iso-prioritize and iso-lineage packages

Author: CharGrnmn

.github/workflows/ci.yml

@@ -71,6 +71,12 @@ jobs:
           - workspace: "@razroo/iso-timeline"
             node: "20.6.0"
             extra: ""
+          - workspace: "@razroo/iso-prioritize"
+            node: "20.6.0"
+            extra: ""
+          - workspace: "@razroo/iso-lineage"
+            node: "20.6.0"
+            extra: ""
           - workspace: "@razroo/iso-preflight"
             node: "20.6.0"
             extra: ""
@@ -233,6 +239,23 @@ jobs:
           node packages/iso-timeline/dist/cli.js verify --timeline /tmp/jobforge.iso-timeline.json
           node packages/iso-timeline/dist/cli.js check --config packages/iso-timeline/examples/jobforge-timeline.json --events packages/iso-timeline/examples/jobforge-events.jsonl --now 2026-04-27T00:00:00.000Z --fail-on none
 
+      - name: iso-prioritize example rank/check
+        run: |
+          node packages/iso-prioritize/dist/cli.js rank --config packages/iso-prioritize/examples/jobforge-prioritize.json --items packages/iso-prioritize/examples/jobforge-items.json --out /tmp/jobforge.iso-prioritize.json
+          node packages/iso-prioritize/dist/cli.js select --config packages/iso-prioritize/examples/jobforge-prioritize.json --items packages/iso-prioritize/examples/jobforge-items.json --limit 3
+          node packages/iso-prioritize/dist/cli.js verify --result /tmp/jobforge.iso-prioritize.json
+          node packages/iso-prioritize/dist/cli.js check --config packages/iso-prioritize/examples/jobforge-prioritize.json --items packages/iso-prioritize/examples/jobforge-items.json --min-selected 3
+          node packages/iso-prioritize/dist/cli.js explain --config packages/iso-prioritize/examples/jobforge-prioritize.json
+
+      - name: iso-lineage example record/check
+        run: |
+          node packages/iso-lineage/dist/cli.js record --root packages/iso-lineage/examples/jobforge-project --graph /tmp/jobforge.iso-lineage.json --artifact reports/812-example-labs.md --input cv.md --input profile.yml --input jobs/example-labs.md --command "job-forge evaluate jobs/example-labs.md"
+          node packages/iso-lineage/dist/cli.js record --root packages/iso-lineage/examples/jobforge-project --graph /tmp/jobforge.iso-lineage.json --artifact generated/812-example-labs.pdf --input reports/812-example-labs.md --command "job-forge pdf reports/812-example-labs.md"
+          node packages/iso-lineage/dist/cli.js verify --graph /tmp/jobforge.iso-lineage.json
+          node packages/iso-lineage/dist/cli.js check --root packages/iso-lineage/examples/jobforge-project --graph /tmp/jobforge.iso-lineage.json
+          node packages/iso-lineage/dist/cli.js stale --root packages/iso-lineage/examples/jobforge-project --graph /tmp/jobforge.iso-lineage.json
+          node packages/iso-lineage/dist/cli.js explain --root packages/iso-lineage/examples/jobforge-project --graph /tmp/jobforge.iso-lineage.json --artifact reports/812-example-labs.md
+
       - name: iso-preflight example plan/check
         run: |
           node packages/iso-preflight/dist/cli.js plan --config packages/iso-preflight/examples/jobforge-preflight.json --candidates packages/iso-preflight/examples/jobforge-candidates.json

.github/workflows/iso-lineage-release.yml

@@ -0,0 +1,48 @@
+name: iso-lineage Release to npm
+
+on:
+  release:
+    types: [published]
+
+defaults:
+  run:
+    working-directory: packages/iso-lineage
+
+jobs:
+  publish:
+    if: startsWith(github.ref_name, 'iso-lineage-v')
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      checks: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: '22'
+          registry-url: 'https://registry.npmjs.org'
+          cache: 'npm'
+
+      - name: Set version from release tag
+        run: |
+          VERSION="${GITHUB_REF_NAME#iso-lineage-v}"
+          echo "VERSION=$VERSION" >> $GITHUB_ENV
+
+      - name: Verify required CI passed for release commit
+        uses: ./.github/actions/verify-release-gate
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Verify package.json version matches release tag
+        run: npm run release:check-source -- "$VERSION"
+
+      - name: Install (workspace root)
+        run: npm ci
+        working-directory: .
+
+      - name: Publish to npm (with provenance)
+        run: npm publish --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.github/workflows/iso-prioritize-release.yml

@@ -0,0 +1,48 @@
+name: iso-prioritize Release to npm
+
+on:
+  release:
+    types: [published]
+
+defaults:
+  run:
+    working-directory: packages/iso-prioritize
+
+jobs:
+  publish:
+    if: startsWith(github.ref_name, 'iso-prioritize-v')
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      checks: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: '22'
+          registry-url: 'https://registry.npmjs.org'
+          cache: 'npm'
+
+      - name: Set version from release tag
+        run: |
+          VERSION="${GITHUB_REF_NAME#iso-prioritize-v}"
+          echo "VERSION=$VERSION" >> $GITHUB_ENV
+
+      - name: Verify required CI passed for release commit
+        uses: ./.github/actions/verify-release-gate
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Verify package.json version matches release tag
+        run: npm run release:check-source -- "$VERSION"
+
+      - name: Install (workspace root)
+        run: npm ci
+        working-directory: .
+
+      - name: Publish to npm (with provenance)
+        run: npm publish --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

INTEGRATIONS.md

@@ -1,6 +1,6 @@
 # Integrations
 
-This repo ships twenty-three packages that **work on their own** but are **designed
+This repo ships twenty-five packages that **work on their own** but are **designed
 to compose**. The planned cross-package compositions listed here are already
 shipped, so this file now serves as:
 
@@ -282,6 +282,31 @@ tracker files.
 
 ---
 
+## 20. `iso-prioritize` ← deterministic priority queue selection for domain packages — **DONE**
+
+Introduced as a standalone package. `iso-prioritize` does not import JobForge,
+`iso-score`, `iso-timeline`, `iso-preflight`, or any other domain package; it
+provides the on-disk JSON prioritization config, item, and result formats that
+domain tools can share. JobForge-style examples cover follow-up, pipeline, and
+apply queues with weighted criteria, skip gates, adjustments, and one-per-company
+quotas, but the package remains generic: rank, gate, quota, select, check, and
+verify local work queues without asking a model to re-sort growing worklists.
+
+---
+
+## 21. `iso-lineage` ← deterministic artifact freshness for domain packages — **DONE**
+
+Introduced as a standalone package. `iso-lineage` does not import JobForge,
+`iso-cache`, `iso-index`, `iso-facts`, `iso-preflight`, or any other domain
+package; it provides the on-disk JSON lineage graph format that domain tools
+can share. JobForge-style examples cover reports and generated PDFs derived
+from CV/profile/JD inputs, but the package remains generic: record artifact
+inputs, verify content-derived graph/record ids, check freshness, list stale
+outputs, and propagate stale upstream state without asking a model to inspect
+project history.
+
+---
+
 ## Design questions that are *not* open integrations
 
 The following look like integrations but are deliberately decoupled —
@@ -349,6 +374,15 @@ don't "fix" them without a conversation first.
   extraction, source precedence, business calendars, stale-action retention,
   and whether due actions route to prompts, ledgers, notifications, or
   workflow dispatch.
+- **`iso-prioritize` does not decide what a domain values most.** It evaluates
+  configured queue policy. Domain packages still own item extraction, source
+  precedence, priority dimensions, quota policy, and whether selected items
+  route to preflight, timelines, ledgers, notifications, or workflow dispatch.
+- **`iso-lineage` does not decide when a stale artifact should be rebuilt.** It
+  detects changed source inputs and stale upstream artifacts. Domain packages
+  still own rebuild policy, which generated files are disposable, how lineage
+  records are created, and whether stale output blocks dispatch, triggers
+  regeneration, or only warns.
 - **`iso-postflight` does not decide how a domain collects observations.**
   It settles explicit plan/outcome/artifact/step records. Domain packages
   still own whether those observations come from TSV files, ledger events,