@deftai/directive-content 0.55.1 → 0.56.0

package/tasks/triage-classify.yml

@@ -0,0 +1,30 @@
+version: '3'
+
+# tasks/triage-classify.yml -- auto-classification surface (#1129 / D10).
+#
+# Wired into the parent Taskfile.yml via the `includes:` block under
+# namespace key `triage-classify` (mirroring the four-fragment cluster
+# pattern from #845 / #1131). When included, the inner task `classify`
+# is reachable as `task triage-classify:classify`. The parent Taskfile
+# exposes the documented `task triage:classify` alias.
+#
+# Per `conventions/task-caching.md` (#574): NO `sources:` / `generates:`
+# declarations on this task because user-facing flags (`--list`,
+# `--validate`, `--project-root`) are forwarded via {{.CLI_ARGS}} and
+# go-task's incremental-build cache layer would silently swallow them.
+#
+# Companion script: scripts/triage_classify.py (+ scripts/_triage_classify_cli.py)
+# Companion tests:  tests/test_triage_classify.py
+# Current Shape:    https://github.com/deftai/directive/issues/1129#issuecomment-4471901622
+
+vars:
+  DEFT_ROOT: '{{joinPath .TASKFILE_DIR ".."}}'
+
+tasks:
+  classify:
+    desc: "Inspect / validate plan.policy.triageAutoClassify[] + triageHoldMarkers[] (#1129 / D10). -- task triage:classify -- [--list | --validate]"
+    internal: true
+    deps: [":ts:build"]
+    dir: '{{.USER_WORKING_DIR}}'
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/bin.js" triage-classify --project-root "{{.USER_WORKING_DIR}}" {{.CLI_ARGS}}

package/tasks/triage-queue.yml

@@ -0,0 +1,50 @@
+version: '3'
+
+# tasks/triage-queue.yml -- ranked triage queue + per-item show + audit
+# surface (#1128 / D11 of #1119).
+#
+# Wired into the parent Taskfile.yml via the `includes:` block under
+# namespace key `triage-queue` (matching the four-fragment cluster pattern
+# from #845 and the D12 #1131 pattern landed in tasks/triage-scope.yml).
+# When included that way, the inner tasks `queue` / `show` / `audit` are
+# reachable as `task triage-queue:queue` / `task triage-queue:show` /
+# `task triage-queue:audit`. The parent Taskfile exposes the documented
+# `task triage:queue` / `task triage:show` / `task triage:audit` aliases.
+#
+# Per `conventions/task-caching.md` (#574): NO `sources:` / `generates:`
+# declarations because each inner task accepts user-facing flags
+# (`--repo`, `--limit`, `--format=json`, `--vbrief-staleness`,
+# `--project-root`, `--cache-root`, `--audit-log`) via {{.CLI_ARGS}} and
+# go-task's incremental-build cache layer would silently swallow them.
+#
+# Companion script: scripts/triage_queue.py (+ scripts/_triage_queue_cli.py)
+# Companion tests:  tests/test_triage_queue.py
+# Current Shape:    https://github.com/deftai/directive/issues/1128#issuecomment-4471272093
+
+vars:
+  DEFT_ROOT: '{{joinPath .TASKFILE_DIR ".."}}'
+
+tasks:
+  queue:
+    desc: "Print the ranked triage queue (#1128 / D11). -- task triage:queue [-- --repo OWNER/NAME] [--limit N]"
+    internal: true
+    deps: [":ts:build"]
+    dir: '{{.USER_WORKING_DIR}}'
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/bin.js" triage-queue queue --project-root "{{.USER_WORKING_DIR}}" {{.CLI_ARGS}}
+
+  show:
+    desc: "Per-issue triage detail (#1128 / D11). -- task triage:show -- <N> [--repo OWNER/NAME]"
+    internal: true
+    deps: [":ts:build"]
+    dir: '{{.USER_WORKING_DIR}}'
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/bin.js" triage-queue show --project-root "{{.USER_WORKING_DIR}}" {{.CLI_ARGS}}
+
+  audit:
+    desc: "Audit-log surface (#1128 / D11, #1180). -- task triage:audit [-- --format=text|json] [--vbrief-staleness] [--since=<window>] [--action=<verb>] [--repo OWNER/NAME]"
+    internal: true
+    deps: [":ts:build"]
+    dir: '{{.USER_WORKING_DIR}}'
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/bin.js" triage-queue audit --project-root "{{.USER_WORKING_DIR}}" {{.CLI_ARGS}}

package/tasks/triage-reconcile.yml

@@ -0,0 +1,29 @@
+version: '3'
+
+# tasks/triage-reconcile.yml -- `task triage:reconcile` audit-log self-heal (#1468).
+#
+# Wired into the parent Taskfile.yml via the `includes:` block under namespace
+# key `triage-reconcile`. The inner task `reconcile` is reachable as
+# `task triage-reconcile:reconcile`; the parent Taskfile exposes the documented
+# `task triage:reconcile` alias.
+#
+# Per `conventions/task-caching.md` (#574): NO `sources:` / `generates:`
+# declarations because user-facing flags (`--repo`, `--dry-run`, `--json`,
+# `--project-root`) are forwarded via {{.CLI_ARGS}} and go-task's
+# incremental-build cache layer would silently swallow them.
+#
+# Companion script: scripts/triage_reconcile.py
+# Companion tests:  tests/test_triage_reconcile.py
+# Pattern reference: tasks/triage-bootstrap.yml (#845 Story 6).
+
+vars:
+  DEFT_ROOT: '{{joinPath .TASKFILE_DIR ".."}}'
+
+tasks:
+  reconcile:
+    desc: "Self-heal the triage audit log (#1468): backfill missing `accept` decisions for proposed/pending/active vBRIEFs carrying an x-vbrief/github-issue reference, without a cache re-fetch. Idempotent. -- task triage:reconcile [-- --repo OWNER/NAME] [--dry-run] [--json]"
+    internal: true
+    deps: [":ts:build"]
+    dir: '{{.USER_WORKING_DIR}}'
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/bin.js" triage-reconcile --project-root "{{.USER_WORKING_DIR}}" {{.CLI_ARGS}}

package/tasks/triage-scope-drift.yml

@@ -0,0 +1,29 @@
+version: '3'
+
+# tasks/triage-scope-drift.yml -- subscription drift detection (#1133 / D14).
+#
+# Wired into the parent Taskfile.yml via the `includes:` block under namespace
+# key `triage-scope-drift`. When included that way, the inner task
+# `scope-drift` is reachable as `task triage-scope-drift:scope-drift`. The
+# parent Taskfile exposes the documented `task triage:scope-drift` alias.
+#
+# Per `conventions/task-caching.md` (#574): NO `sources:` / `generates:`
+# declarations on this task because user-facing flags (`--ignore-label`,
+# `--ignore-milestone`, `--threshold`, `--cache-root`) are forwarded via
+# {{.CLI_ARGS}} and go-task's incremental-build cache layer would silently
+# swallow them.
+#
+# Companion script: scripts/triage_scope_drift.py (+ shims).
+# Companion tests:  tests/test_triage_scope_drift.py.
+
+vars:
+  DEFT_ROOT: '{{joinPath .TASKFILE_DIR ".."}}'
+
+tasks:
+  scope-drift:
+    desc: "Detect subscription drift -- unsubscribed labels/milestones on cached open issues (#1133 / D14). -- task triage:scope-drift [-- --ignore-label=L | --ignore-milestone=M]"
+    internal: true
+    deps: [":ts:build"]
+    dir: '{{.USER_WORKING_DIR}}'
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/bin.js" triage-scope-drift --project-root "{{.USER_WORKING_DIR}}" {{.CLI_ARGS}}

package/tasks/triage-scope.yml

@@ -0,0 +1,31 @@
+version: '3'
+
+# tasks/triage-scope.yml -- typed plan.policy.triageScope[] surface (#1131 / D12).
+#
+# Wired into the parent Taskfile.yml via the `includes:` block under namespace
+# key `triage-scope` (matching the four-fragment cluster pattern from #845).
+# When included that way, the inner task `scope` is reachable as
+# `task triage-scope:scope`. The parent Taskfile exposes the documented
+# `task triage:scope` alias.
+#
+# Per `conventions/task-caching.md` (#574): NO `sources:` / `generates:`
+# declarations on this task because user-facing flags (`--list`,
+# `--refresh-denominator`, `--repo`, `--count`, `--cache-root`) are forwarded
+# via {{.CLI_ARGS}} and go-task's incremental-build cache layer would
+# silently swallow them.
+#
+# Companion script: scripts/triage_scope.py (+ scripts/_triage_scope_cli.py)
+# Companion tests:  tests/test_triage_scope.py
+# Current Shape:    https://github.com/deftai/directive/issues/1131#issuecomment-4471901494
+
+vars:
+  DEFT_ROOT: '{{joinPath .TASKFILE_DIR ".."}}'
+
+tasks:
+  scope:
+    desc: "Inspect / mutate / diff the typed plan.policy.triageScope[] subscription + triageScopeIgnores[] (#1131 / D12, #1133 / D14, #1182 / D14c). -- task triage:scope -- [--list] [--add-label=L | --add-milestone=M | --ignore-label=L] [--diff-from-upstream --repo OWNER/NAME] [--refresh-denominator --repo OWNER/NAME --count N]"
+    internal: true
+    deps: [":ts:build"]
+    dir: '{{.USER_WORKING_DIR}}'
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/bin.js" triage-scope --project-root "{{.USER_WORKING_DIR}}" {{.CLI_ARGS}}

package/tasks/triage-smoketest.yml

@@ -0,0 +1,33 @@
+version: '3'
+
+# tasks/triage-smoketest.yml -- N6 (#1146) `task triage:smoketest` end-to-end
+# synthetic test of the cache-as-operator-working-set surface.
+#
+# Wired into the parent Taskfile.yml via the `includes:` block under namespace
+# key `triage-smoketest`. The inner task `smoketest` is reachable as
+# `task triage-smoketest:smoketest`; the parent Taskfile exposes the
+# documented `task triage:smoketest` alias.
+#
+# Per `conventions/task-caching.md` (#574): NO `sources:` / `generates:`
+# declarations because user-facing flags (`--verbose`, `--keep-tempdir`,
+# `--cache-only`, `--fixture`) are forwarded via {{.CLI_ARGS}} and
+# go-task's incremental-build cache layer would silently swallow them.
+#
+# Companion script:   scripts/triage_smoketest.py (+ scripts/_triage_smoketest_stages.py)
+# Companion fixture:  tests/fixtures/triage_smoketest/
+# Companion tests:    tests/test_triage_smoketest.py + tests/test_triage_smoketest_fixture.py
+# Pattern reference:  tasks/triage-summary.yml (D2 / #1122).
+
+vars:
+  DEFT_ROOT: '{{joinPath .TASKFILE_DIR ".."}}'
+
+tasks:
+  smoketest:
+    desc: "Run the N6 (#1146) end-to-end smoketest against the hermetic 20-issue fixture. Exits 0 on PASS / 1 on first failure. -- task triage:smoketest [-- --verbose] [--keep-tempdir] [--cache-only]"
+    internal: true
+    deps: [":ts:build"]
+    dir: '{{.USER_WORKING_DIR}}'
+    env:
+      DEFT_ROOT: '{{.DEFT_ROOT}}'
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/bin.js" triage-smoketest {{.CLI_ARGS}}

package/tasks/triage-subscribe.yml

@@ -0,0 +1,36 @@
+version: '3'
+
+# tasks/triage-subscribe.yml -- subscribe / unsubscribe mutation verbs (#1133 / D14).
+#
+# Wired into the parent Taskfile.yml via the `includes:` block under namespace
+# key `triage-subscribe`. Inner tasks `subscribe` / `unsubscribe` are
+# reachable as `task triage-subscribe:subscribe` / `triage-subscribe:unsubscribe`.
+# The parent Taskfile exposes the user-facing `task triage:subscribe` /
+# `task triage:unsubscribe` aliases.
+#
+# Per `conventions/task-caching.md` (#574): NO `sources:` / `generates:`
+# declarations -- user-facing flags (`--label`, `--milestone`, `--issue`,
+# `--issue-note`, `--actor`) are forwarded via {{.CLI_ARGS}}.
+#
+# Companion script: scripts/triage_subscribe.py (+ shim).
+# Companion tests:  tests/test_triage_subscribe.py.
+
+vars:
+  DEFT_ROOT: '{{joinPath .TASKFILE_DIR ".."}}'
+
+tasks:
+  subscribe:
+    desc: "Subscribe to a label / milestone / issue on plan.policy.triageScope[] (#1133 / D14). -- task triage:subscribe -- (--label=L | --milestone=M | --issue=N)"
+    internal: true
+    deps: [":ts:build"]
+    dir: '{{.USER_WORKING_DIR}}'
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/bin.js" triage-subscribe subscribe --project-root "{{.USER_WORKING_DIR}}" {{.CLI_ARGS}}
+
+  unsubscribe:
+    desc: "Unsubscribe a label / milestone / issue from plan.policy.triageScope[] (#1133 / D14). -- task triage:unsubscribe -- (--label=L | --milestone=M | --issue=N)"
+    internal: true
+    deps: [":ts:build"]
+    dir: '{{.USER_WORKING_DIR}}'
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/bin.js" triage-subscribe unsubscribe --project-root "{{.USER_WORKING_DIR}}" {{.CLI_ARGS}}

package/tasks/triage-summary.yml

@@ -0,0 +1,29 @@
+version: '3'
+
+# tasks/triage-summary.yml -- D2 (#1122) `task triage:summary` one-liner surface.
+#
+# Wired into the parent Taskfile.yml via the `includes:` block under namespace
+# key `triage-summary`. The inner task `summary` is reachable as
+# `task triage-summary:summary`; the parent Taskfile exposes the documented
+# `task triage:summary` alias.
+#
+# Per `conventions/task-caching.md` (#574): NO `sources:` / `generates:`
+# declarations because user-facing flags (`--project-root`, `--cache-root`,
+# `--no-history`, `--json`) are forwarded via {{.CLI_ARGS}} and go-task's
+# incremental-build cache layer would silently swallow them.
+#
+# Companion script: scripts/triage_summary.py
+# Companion tests:  tests/test_triage_summary.py
+# Pattern reference: tasks/triage-scope.yml (D12 / #1131 / merged via #1190).
+
+vars:
+  DEFT_ROOT: '{{joinPath .TASKFILE_DIR ".."}}'
+
+tasks:
+  summary:
+    desc: "Emit the D2 (#1122) one-line triage state for the session-start ritual (N9 / #1149). Always exits 0; appends a JSONL record to vbrief/.eval/summary-history.jsonl. -- task triage:summary -- [--json] [--no-history]"
+    internal: true
+    deps: [":ts:build"]
+    dir: '{{.USER_WORKING_DIR}}'
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/bin.js" triage-summary --project-root "{{.USER_WORKING_DIR}}" {{.CLI_ARGS}}

package/tasks/triage-welcome.yml

@@ -0,0 +1,32 @@
+version: '3'
+
+# tasks/triage-welcome.yml -- N3 (#1143) `task triage:welcome` 6-phase
+# onboarding ritual surface.
+#
+# Wired into the parent Taskfile.yml via the `includes:` block under
+# namespace key `triage-welcome`. The inner task `welcome` is reachable
+# as `task triage-welcome:welcome`; the parent Taskfile exposes the
+# documented `task triage:welcome` alias.
+#
+# Per `conventions/task-caching.md` (#574): NO `sources:` / `generates:`
+# declarations because user-facing flags (`--project-root`,
+# `--no-subprocess`) are forwarded via {{.CLI_ARGS}} and go-task's
+# incremental-build cache layer would silently swallow them.
+#
+# Companion script: scripts/triage_welcome.py (+ scripts/_triage_welcome_cli.py)
+# Companion tests:  tests/test_triage_welcome.py
+# Pattern reference: tasks/triage-summary.yml (D2 / #1122).
+
+vars:
+  DEFT_ROOT: '{{joinPath .TASKFILE_DIR ".."}}'
+
+tasks:
+  welcome:
+    desc: "Run the 6-phase onboarding ritual (N3 / #1143): detect prior state, prompt subscription scope, run triage:bootstrap, prompt wipCap, offer WIP relief, print triage:summary. Idempotent; re-run resumes cleanly. -- task triage:welcome -- [--no-subprocess]"
+    internal: true
+    deps: [":ts:build"]
+    dir: '{{.USER_WORKING_DIR}}'
+    env:
+      DEFT_TASK_PREFIX: '{{.DEFT_TASK_PREFIX | default ""}}'
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/bin.js" triage-welcome --project-root "{{.USER_WORKING_DIR}}" {{.CLI_ARGS}}

package/tasks/ts.yml

@@ -0,0 +1,328 @@
+version: '3'
+
+# TypeScript engine monorepo verbs (#1717). The TS engine lives at the repo
+# root (packages/*) and coexists with the Python/Go engine during the
+# strangler-fig migration.
+#
+# `check:framework-source` now runs the TS lane via the `ts:check-lane`
+# Node-toolchain-aware guard (#1790): when `pnpm` is on PATH it runs
+# lint+build+test, and when it is absent it skips with a notice and exits 0
+# (so the gate still works in Node-less environments, mirroring the #1474
+# vendored-consumer guards). This closed the PR #1780 gap where a TS biome
+# failure passed a local `task check` but reddened CI. The dedicated `ts` CI
+# job still runs the lane unconditionally.
+#
+# DEFT_ROOT resolves to the repo root (this fragment lives in tasks/, so
+# {{.TASKFILE_DIR}}/.. is the root), matching the sibling task fragments.
+
+vars:
+  DEFT_ROOT: '{{joinPath .TASKFILE_DIR ".."}}'
+
+tasks:
+  build:
+    desc: "Build the TypeScript engine monorepo (tsc -b project references, #1717)"
+    dir: '{{.DEFT_ROOT}}'
+    cmds:
+      - pnpm run build
+
+  test:
+    desc: "Run the TypeScript engine test suite with coverage (vitest, #1717)"
+    dir: '{{.DEFT_ROOT}}'
+    cmds:
+      - pnpm run test
+
+  lint:
+    desc: "Lint + format-check the TypeScript engine (biome, #1717)"
+    dir: '{{.DEFT_ROOT}}'
+    cmds:
+      - pnpm run lint
+
+  check-lane:
+    desc: "Run the TS lane (lint+build+test) when a Node toolchain is present; skip with a notice otherwise (#1530 local-gate<->CI parity, #1790)."
+    dir: '{{.DEFT_ROOT}}'
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/bin.js" ts-check-lane --project-root "{{.DEFT_ROOT}}"
+
+  encoding:
+    desc: "Run the ported verify:encoding gate (TS @deftai/core port, #1718)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/verify-encoding.js" --all --project-root "{{.DEFT_ROOT}}"
+
+  parity:
+    desc: "Golden-diff the ported verify:encoding gate vs the Python oracle, cache-off (#1718)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/parity.js"
+
+  policy-parity:
+    desc: "Golden-diff the ported policy surface vs the Python oracle, cache-off (#1722)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/policy-parity.js"
+
+  preflight-parity:
+    desc: "Golden-diff the ported vBRIEF preflight gate vs the Python oracle, cache-off (#1721)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/vbrief-preflight-parity.js"
+
+  story-ready-parity:
+    desc: "Golden-diff the ported verify:story-ready gate vs the Python oracle, cache-off (#1720)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/story-ready-parity.js"
+
+  branch-parity:
+    desc: "Golden-diff the ported verify:branch gate vs the Python oracle, cache-off (#1719)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/branch-parity.js"
+
+  wip-cap-parity:
+    desc: "Golden-diff the ported verify:wip-cap gate vs the Python oracle, cache-off (#1723)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/wip-cap-parity.js"
+
+  scm-parity:
+    desc: "Golden-diff the ported scm.py SCM boundary vs the Python oracle, cache-off (#1724)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/scm-parity.js"
+
+  triage-parity:
+    desc: "Golden-diff every ported triage verb vs its Python oracle, cache-off (#1530 Wave 3, #1725)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/triage-queue-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/triage-summary-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/triage-classify-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/triage-actions-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/triage-bootstrap-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/triage-scope-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/triage-aux-a-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/triage-aux-b-parity.js"
+
+  scope-lifecycle-parity:
+    desc: "Golden-diff the ported scope:* lifecycle family vs the Python oracle, cache-off (#1726)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/scope-lifecycle-parity.js"
+
+  slice-parity:
+    desc: "Golden-diff the ported slice:* family vs the Python oracle, cache-off (#1727)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/slice-parity.js"
+
+  cache-parity:
+    desc: "Golden-diff the ported unified content cache vs the Python oracle, cache-off (#1728)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/cache-parity.js"
+
+  doctor-parity:
+    desc: "Golden-diff the ported deft doctor vs the Python oracle, cache-off (#1728)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/doctor-parity.js"
+
+  release-parity:
+    desc: "Golden-diff the ported release.py core vs the Python oracle, cache-off (#1729)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/release-parity.js"
+
+  release-publish-parity:
+    desc: "Golden-diff the ported release_publish.py vs the Python oracle, cache-off (#1729)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/release-publish-parity.js"
+
+  release-rollback-parity:
+    desc: "Golden-diff the ported release_rollback.py vs the Python oracle, cache-off (#1729)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/release-rollback-parity.js"
+
+  release-e2e-parity:
+    desc: "Golden-diff the ported release_e2e.py vs the Python oracle, cache-off (#1729)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/release-e2e-parity.js"
+
+  pr-merge-readiness-parity:
+    desc: "Golden-diff the ported pr_merge_readiness.py vs the Python oracle, cache-off (#1730)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/pr-merge-readiness-parity.js"
+
+  pr-protected-issues-parity:
+    desc: "Golden-diff the ported pr_check_protected_issues.py vs the Python oracle, cache-off (#1730)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/pr-protected-issues-parity.js"
+
+  pr-closing-keywords-parity:
+    desc: "Golden-diff the ported pr_check_closing_keywords.py vs the Python oracle, cache-off (#1730)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/pr-closing-keywords-parity.js"
+
+  pr-monitor-parity:
+    desc: "Golden-diff the ported monitor_pr.py vs the Python oracle, cache-off (#1730)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/pr-monitor-parity.js"
+
+  pr-wait-mergeable-parity:
+    desc: "Golden-diff the ported pr_wait_mergeable.py cascade composer vs the Python oracle, cache-off (#1730)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/pr-wait-mergeable-parity.js"
+
+  vbrief-build-parity:
+    desc: "Golden-diff the ported vBRIEF construction foundation vs the Python oracle, cache-off (#1782 s1)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/vbrief-build-parity.js"
+
+  vbrief-reconcile-parity:
+    desc: "Golden-diff the ported vBRIEF reconciliation engine vs the Python oracle, cache-off (#1782 s4)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/vbrief-reconcile-parity.js"
+
+  vbrief-validation-parity:
+    desc: "Golden-diff the ported vBRIEF validation primitives vs the Python oracle, cache-off (#1782 s2)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/vbrief-validation-parity.js"
+
+  vbrief-validate-parity:
+    desc: "Golden-diff the ported vbrief:validate + verify:vbrief-conformance gates vs the Python oracle, cache-off (#1782 s3)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/vbrief-validate-parity.js"
+
+  vbrief-activate-parity:
+    desc: "Golden-diff the ported vbrief_activate.py lifecycle verb vs the Python oracle, cache-off (#1782 s5)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/vbrief-activate-parity.js"
+
+  verify-env-parity:
+    desc: "Golden-diff the ported verify_tools / verify_hooks_installed / toolchain-check / verify_no_task_runtime gates vs the Python oracle, cache-off (#1783 s1)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/verify-env-parity.js"
+
+  verify-source-parity:
+    desc: "Golden-diff the ported source-tree scanner gates vs the Python oracle, cache-off (#1783 s2)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/verify-source-parity.js"
+
+  validate-content-parity:
+    desc: "Golden-diff the ported content validator gates vs the Python oracle, cache-off (#1783 s3)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/validate-content-parity.js"
+
+  render-parity:
+    desc: "Golden-diff the ported spec/PRD/render family vs the Python oracle, cache-off (#1785)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/render-parity.js"
+
+  codebase-parity:
+    desc: "Golden-diff the ported codebase mapping + capacity modules vs the Python oracle, cache-off (#1786)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/codebase-parity.js"
+
+  intake-parity:
+    desc: "Golden-diff the ported issue intake + reconcile surface vs the Python oracle, cache-off (#1784)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/intake-parity.js"
+
+  lifecycle-packs-parity:
+    desc: "Golden-diff the ported lifecycle hygiene + events + packs surface vs the Python oracle, cache-off (#1787 s2)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/lifecycle-packs-parity.js"
+
+  session-parity:
+    desc: "Golden-diff the ported session/ritual core vs the Python oracle, cache-off (#1787 s1)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/session-parity.js"
+
+  orchestration-parity:
+    desc: "Golden-diff the ported monitor/investigation gate verbs vs the Python oracle, cache-off (#1788 s2)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/orchestration-parity.js"
+
+  swarm-parity:
+    desc: "Golden-diff the ported swarm cohort verbs vs the Python oracle, cache-off (#1788 s1)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/swarm-parity.js"
+
+  platform-parity:
+    desc: "Golden-diff the ported AGENTS.md/version/platform utilities vs the Python oracle, cache-off (#1787 s3)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/platform-parity.js"
+
+  parity-all:
+    desc: "Run every TS-port golden-diff parity harness vs the Python oracle (#1530 Wave 2)"
+    deps: [build]
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/policy-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/vbrief-preflight-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/story-ready-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/branch-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/wip-cap-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/scm-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/triage-queue-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/triage-summary-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/triage-classify-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/triage-actions-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/triage-bootstrap-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/triage-scope-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/triage-aux-a-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/triage-aux-b-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/scope-lifecycle-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/slice-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/cache-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/doctor-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/release-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/release-publish-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/release-rollback-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/release-e2e-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/pr-merge-readiness-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/pr-protected-issues-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/pr-closing-keywords-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/pr-monitor-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/pr-wait-mergeable-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/vbrief-build-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/vbrief-reconcile-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/vbrief-validation-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/vbrief-validate-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/vbrief-activate-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/verify-env-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/verify-source-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/validate-content-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/render-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/codebase-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/intake-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/lifecycle-packs-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/session-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/orchestration-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/swarm-parity.js"
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/platform-parity.js"