@deftai/directive-content 0.55.2 → 0.56.0

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"

package/tasks/vbrief.yml

@@ -0,0 +1,206 @@
+version: '3'
+
+vars:
+  DEFT_ROOT: '{{joinPath .TASKFILE_DIR ".."}}'
+
+tasks:
+  _ts-build:
+    internal: true
+    desc: "Build @deftai/cli dist/ before TS-backed gates run (#1828 s2)."
+    dir: '{{.DEFT_ROOT}}'
+    cmds:
+      - pnpm run build
+
+  validate:
+    desc: Validate vBRIEF lifecycle folder structure and cross-file consistency
+    dir: '{{.USER_WORKING_DIR}}'
+    deps:
+      - _ts-build
+    cmds:
+      # Oracle/fallback (parity): scripts/vbrief_validate.py (#1828 Wave 8).
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/bin.js" vbrief:validate --vbrief-dir "{{.USER_WORKING_DIR}}/vbrief"
+
+  preflight:
+    # Implementation-intent preflight wrapper (#810 / PR #812 fixup;
+    # #1046 PR-C / #1047 fail-closed resolver). Skill files
+    # (skills/deft-directive-build/SKILL.md Step 0,
+    # skills/deft-directive-swarm/SKILL.md Phase 0 Step 1) and the
+    # AGENTS.md template (templates/agents-entry.md Implementation Intent
+    # Gate block) reference THIS task rather than the underlying Python
+    # script directly so the skills are path-prefix-agnostic across the
+    # three supported install layouts:
+    #
+    #   1. ``.deft/core/scripts/...`` (v0.27+ canonical install per #992)
+    #   2. ``deft/scripts/...``       (legacy v0.20-v0.26 install)
+    #   3. ``scripts/...``            (in-repo case: deft framework itself)
+    #
+    # The wrapped ``preflight_implementation.py`` script is located
+    # via ``scripts/_resolve_preflight_path.py`` (#1046 PR-C / #1047),
+    # which probes the three candidate locations under
+    # ``{{.USER_WORKING_DIR}}`` in priority order and exits 2 with a
+    # structured ``gate misconfigured`` error pointing at
+    # ``task framework:doctor`` (#1046 PR-B / #1057) when no candidate
+    # resolves. The two-step invocation (resolve, then run) makes the
+    # fail-closed semantic explicit: if the resolver returns non-zero
+    # the inline ``sh:`` block exits with the same code BEFORE the
+    # downstream ``uv run python <script>`` ever fires, so the gate
+    # never silently fails open on a misconfigured install (the safety
+    # regression #1047 described).
+    #
+    # The resolver script ITSELF is dispatched via ``{{.DEFT_ROOT}}``
+    # (the Taskfile-relative install root) so it lives wherever the
+    # framework lives -- the resolver then probes the consumer's
+    # project root via ``{{.USER_WORKING_DIR}}``.
+    #
+    # The task bakes ``--vbrief-path`` so callers pass only the vBRIEF
+    # path: ``task vbrief:preflight -- <path>``.
+    #
+    # CLI_ARGS forwarding (#577): bare ``{{.CLI_ARGS}}`` -- DO NOT wrap
+    # in Taskfile-level double quotes. go-task already shell-escapes
+    # CLI_ARGS with single quotes, so wrapping in double quotes yields
+    # ``"'path'"`` at dispatch time on Windows (pwsh/cmd preserve nested
+    # quotes verbatim) and Python's argv receives a literal
+    # single-quote-prefixed filename that fails to open. This matches
+    # the convention enforced by tests/content/test_taskfile_cli_args.py
+    # and used in tasks/scope.yml / migrate.yml / prd.yml / etc.
+    # (Greptile P2 suggestion to quote was a false-positive against this
+    # project's established convention.)
+    #
+    # NOTE: NO ``sources:`` / ``generates:`` per ``conventions/task-caching.md``
+    # because the vBRIEF path is a user-facing argument forwarded via
+    # {{.CLI_ARGS}} and a cached cmds skip would silently swallow it.
+    desc: "Preflight an implementation-intent gate (#810): exits 0 only when vBRIEF is in vbrief/active/ AND plan.status == 'running'. Fails closed (#1046 PR-C / #1047) if the wrapped script cannot be resolved."
+    dir: '{{.USER_WORKING_DIR}}'
+    deps:
+      - _ts-build
+    cmds:
+      # Oracle/fallback (parity): scripts/preflight_implementation.py (#1828 Wave 8).
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/bin.js" vbrief:preflight --vbrief-path {{.CLI_ARGS}}
+
+  reconcile:graph:
+    # Cascade-unblock walker (#1287). Walks vbrief/proposed/, resolves each
+    # candidate's plan.metadata.swarm.depends_on[] against current lifecycle
+    # state, and promotes (proposed/ -> pending/ via scope_lifecycle) every
+    # candidate whose dependencies ALL resolve to a brief in completed/ or
+    # cancelled/. Pure-vBRIEF / forge-agnostic: reuses the swarm_readiness.py
+    # dep-graph + cycle machinery and the scope_lifecycle promote surface.
+    # WIP-cap aware, cycle-safe (exit 1 on a detected cycle), and idempotent
+    # (a second run is a no-op). Pass-through flags: --force (override the WIP
+    # cap, audited), --dry-run (report without moving), --json (machine
+    # summary).
+    #
+    # CLI_ARGS forwarding (#577): bare ``{{.CLI_ARGS}}`` -- DO NOT wrap in
+    # Taskfile-level double quotes. go-task already shell-escapes CLI_ARGS
+    # with single quotes; double-wrapping breaks Windows argv. See the
+    # preflight task below for the full rationale.
+    #
+    # NOTE: NO ``sources:`` / ``generates:`` per ``conventions/task-caching.md``
+    # because the walk reads/writes lifecycle folders that go-task does not
+    # track, so a cached skip would silently swallow real promotions.
+    desc: "Reconcile dep graph: promote proposed/ vBRIEFs whose swarm.depends_on[] all resolve to completed/ or cancelled/ (#1287). Flags: --force --dry-run --json."
+    dir: '{{.USER_WORKING_DIR}}'
+    deps:
+      - _ts-build
+    cmds:
+      # Oracle/fallback (parity): scripts/vbrief_reconcile_graph.py (#1828 Wave 8).
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/bin.js" vbrief-reconcile graph --project-root "{{.USER_WORKING_DIR}}" {{.CLI_ARGS}}
+
+  reconcile:labels:
+    # SCM label reconciliation (#1288). Walks vbrief/proposed/ + pending/ +
+    # active/, resolves each brief's linked GitHub issue from its
+    # x-vbrief/github-issue reference, and applies/removes a fixed set of
+    # managed labels so the forge surface mirrors canonical vBRIEF state:
+    # status=blocked or an unresolved swarm.depends_on[] -> status:blocked;
+    # kind=epic -> epic + status:tracker; kind=research -> rfc. Mirror (not
+    # accumulate): managed labels that no longer apply are removed; labels
+    # outside the managed set are never touched. Every forge call routes
+    # through scripts/scm.py (#1145) so task verify:scm-boundary stays green,
+    # and the verb is idempotent (a second run mutates nothing). Pass-through
+    # flags: --repo OWNER/NAME (fallback when a reference URI lacks owner/
+    # repo), --dry-run (report without mutating), --json (machine summary).
+    #
+    # CLI_ARGS forwarding (#577): bare ``{{.CLI_ARGS}}`` -- DO NOT wrap in
+    # Taskfile-level double quotes. go-task already shell-escapes CLI_ARGS
+    # with single quotes; double-wrapping breaks Windows argv. See the
+    # preflight task above for the full rationale.
+    #
+    # NOTE: NO ``sources:`` / ``generates:`` per ``conventions/task-caching.md``
+    # because the walk reads the lifecycle folders and mutates remote forge
+    # state that go-task does not track, so a cached skip would silently
+    # swallow real label changes.
+    desc: "Reconcile SCM labels to mirror vBRIEF state: status:blocked / epic+status:tracker / rfc (#1288). Routes through scripts/scm.py. Flags: --repo --dry-run --json."
+    dir: '{{.USER_WORKING_DIR}}'
+    deps:
+      - _ts-build
+    cmds:
+      # Oracle/fallback (parity): scripts/vbrief_reconcile_labels.py (#1828 Wave 8).
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/bin.js" vbrief-reconcile labels --project-root "{{.USER_WORKING_DIR}}" {{.CLI_ARGS}}
+
+  reconcile:umbrellas:
+    # Umbrella current-shape auto-update (#1289). Walks every kind=epic
+    # vBRIEF, resolves its children from its x-vbrief/plan references,
+    # computes the wave structure from the children's swarm.depends_on[]
+    # edges, builds the canonical AGENTS.md section-1152 current-shape body
+    # (Last updated / Last pass type / Child count / Child-count history /
+    # Open children / Closed children / Wave order / Open questions /
+    # Reading order), and edits the linked SCM umbrella's current-shape
+    # comment IN PLACE so the permalink is preserved and the amendment
+    # trail is never touched. When no current-shape comment exists yet, one
+    # is created at pass-1. Every forge call routes through scripts/scm.py
+    # (#1145) so task verify:scm-boundary stays green, and the verb is
+    # idempotent (a second run with unchanged epic state mutates nothing --
+    # the pass number is only bumped when the rendered body differs).
+    # Pass-through flags: --repo OWNER/NAME (fallback when a reference URI
+    # lacks owner/repo), --dry-run (report without mutating), --json
+    # (machine summary).
+    #
+    # CLI_ARGS forwarding (#577): bare ``{{.CLI_ARGS}}`` -- DO NOT wrap in
+    # Taskfile-level double quotes. go-task already shell-escapes CLI_ARGS
+    # with single quotes; double-wrapping breaks Windows argv. See the
+    # preflight task below for the full rationale.
+    #
+    # NOTE: NO ``sources:`` / ``generates:`` per ``conventions/task-caching.md``
+    # because the walk reads the lifecycle folders and mutates remote forge
+    # state that go-task does not track, so a cached skip would silently
+    # swallow real comment updates.
+    desc: "Reconcile epic umbrella current-shape comments to vBRIEF state per AGENTS.md #1152: edit in place (preserve permalink). Routes through scripts/scm.py. Flags: --repo --dry-run --json."
+    dir: '{{.USER_WORKING_DIR}}'
+    deps:
+      - _ts-build
+    cmds:
+      # Oracle/fallback (parity): scripts/vbrief_reconcile_umbrellas.py (#1828 Wave 8).
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/bin.js" vbrief-reconcile umbrellas --project-root "{{.USER_WORKING_DIR}}" {{.CLI_ARGS}}
+
+  activate:
+    # Implementation-intent activation gate companion (#810). Idempotent:
+    # already-active vBRIEFs print a no-op message and exit 0; pending/
+    # vBRIEFs flip plan.status pending|approved -> running, stamp
+    # vBRIEFInfo.updated to current ISO8601 UTC, and atomically move to
+    # vbrief/active/. Any other source folder is rejected with an
+    # actionable message. Pairs with `scripts/preflight_implementation.py`
+    # (also reachable via `task vbrief:preflight`): this task is the ONLY
+    # supported way to satisfy that gate.
+    #
+    # Dispatched via `{{.DEFT_ROOT}}/scripts/vbrief_activate.py` mirroring
+    # the `tasks/scope.yml` pattern (scope_lifecycle.py) so the JSON edit
+    # + atomic move logic is testable. The companion test lives at
+    # `tests/cli/test_vbrief_activate.py` to satisfy the forward-coverage
+    # rule from main.md.
+    #
+    # CLI_ARGS forwarding (#577): bare ``{{.CLI_ARGS}}`` -- DO NOT wrap
+    # in Taskfile-level double quotes. See the preflight task above for
+    # the full rationale; the short version is that go-task already
+    # shell-escapes CLI_ARGS with single quotes, and double-wrapping it
+    # breaks Windows argv. Spaces in paths survive correctly through
+    # bare interpolation.
+    #
+    # NOTE: NO ``sources:`` / ``generates:`` per ``conventions/task-caching.md``
+    # because the vBRIEF path is a user-facing argument forwarded via
+    # {{.CLI_ARGS}} and a cached cmds skip would silently swallow it.
+    desc: "Activate a vBRIEF: pending/ -> active/ (status: running). Idempotent. (#810)"
+    dir: '{{.USER_WORKING_DIR}}'
+    deps:
+      - _ts-build
+    cmds:
+      # Oracle/fallback (parity): scripts/vbrief_activate.py (#1828 Wave 8).
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/bin.js" vbrief:activate {{.CLI_ARGS}}