@deftai/directive-content 0.61.2 → 0.63.0

package/tasks/ts.yml

@@ -1,19 +1,6 @@
 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.
+# TypeScript engine monorepo verbs (#1717). Parity oracle tasks removed (#1860).
 
 vars:
   DEFT_ROOT: '{{joinPath .TASKFILE_DIR ".."}}'
@@ -38,7 +25,7 @@ tasks:
       - 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)."
+    desc: "Run the TS lane (lint+build+test) when a Node toolchain is present; skip with a notice otherwise (#1530, #1790)."
     dir: '{{.DEFT_ROOT}}'
     cmds:
       - node "{{.DEFT_ROOT}}/packages/cli/dist/bin.js" ts-check-lane --project-root "{{.DEFT_ROOT}}"
@@ -48,281 +35,3 @@ tasks:
     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/umbrella.yml

@@ -0,0 +1,30 @@
+version: '3'
+
+# tasks/umbrella.yml — umbrella issue tooling (#1152 / #2066).
+#
+# Hosts read-only surfaces for the canonical current-shape comment convention.
+# Runs from the consumer project root so git origin and gh auth resolve against
+# the operator's repo, not deftai/directive (#538 pattern).
+
+vars:
+  DEFT_ROOT: '{{joinPath .TASKFILE_DIR ".."}}'
+
+tasks:
+  _ensure-ts:
+    internal: true
+    desc: "Build the TS engine before umbrella gates (#2066)"
+    dir: '{{.USER_WORKING_DIR}}'
+    cmds:
+      - pnpm --dir "{{.DEFT_ROOT}}" run build
+
+  current-shape:
+    desc: "Fetch umbrella ## Current shape comment (#1152) — task umbrella:current-shape <N> [-- --repo OWNER/REPO | --json | --strict]. Does NOT read the issue body."
+    dir: '{{.USER_WORKING_DIR}}'
+    deps:
+      - _ensure-ts
+    cmds:
+      - task: :engine:invoke
+        vars:
+          ENGINE_CMD: >-
+            umbrella:current-shape --project-root "{{.USER_WORKING_DIR}}"
+            {{.CLI_ARGS}}

package/templates/agent-prompt-preamble.md

@@ -233,6 +233,20 @@ task scm:body:pr:edit -- --repo OWNER/REPO --pr 42 --body-file "$bodyFile"
 
 The wrapper reads UTF-8 body text from a file or stdin, sends JSON to `gh api --input -` via `_safe_subprocess.run_text` with `shell=False`, and prints the live post-mutation read-back object. Use live `gh` for immediate verification after mutations; do not use `ghx` for the first read-back because it may serve a cached stale GET.
 
+## 5.6 Umbrella status — claim-cites-state-surface (#2066)
+
+Before stating an umbrella or epic's current status (what is done, what blocks, wave order), satisfy the claim-cites-state-surface rule:
+
+1. ! Fetch issue comments via REST: `gh api repos/<owner>/<repo>/issues/<N>/comments` (or `ghx api ...` for cached read-only GET).
+2. ! Read the `## Current shape (as of pass-N)` comment and any linked context or `LockedDecisions` vBRIEF referenced there. Follow the AGENTS.md #1152 reading order: body -> current-shape comment -> amendment comments.
+3. ! Any "X is done" / "X is the blocker" assertion about an umbrella MUST cite the current-shape comment or another state artifact in the same message.
+
+Anti-pattern: reading only the issue body (pass-1 plan, stale by design) and concluding umbrella status from it — e.g. `gh issue view <N> --json body` or REST `repos/.../issues/<N>` body field alone. The live recurrence on 2026-06-28 misread #2013 Wave 0 status this way despite #1152 being loaded.
+
+⊗ Conclude umbrella or epic status from the issue body alone (#2066).
+
+Reference: AGENTS.md `## Umbrella current-shape convention (#1152)`, issue #2066.
+
 ## 6. No Draft re-toggling within a single review cycle
 
 Once a PR transitions Draft -> Ready, keep it Ready unless a P0 finding requires re-Draft. Repeated Draft<->Ready toggles cost GraphQL mutations and trigger stale CheckRun states downstream (Greptile re-runs, branch-protection re-evaluations).

package/templates/agents-entry.md

@@ -15,7 +15,7 @@ Deft is installed in .deft/core/. Full guidelines: .deft/core/main.md
 - ./PROJECT.md exists and is not a deprecation redirect (`<!-- deft:deprecated-redirect -->` or `<!-- Purpose: deprecation redirect -->`).
 - ./vbrief/ exists but any of the five lifecycle subfolders (proposed/, pending/, active/, completed/, cancelled/) is missing
 
-→ On detection: read .deft/core/.agents/skills/deft-directive-setup/SKILL.md "Pre-Cutover Detection Guard" section and follow the migration path BEFORE any other action. The Migrating from pre-v0.20 section of the full guidelines has the canonical command, the "task -t ./.deft/core/Taskfile.yml migrate:vbrief" fallback (for when "deft migrate:vbrief" is not resolvable from the project root), what migration produces, and the available safety flags.
+→ On detection: read .deft/core/.agents/skills/deft-directive-setup/SKILL.md "Pre-Cutover Detection Guard" section and follow the frozen migration path BEFORE any other action. The Migrating from pre-v0.20 section of the full guidelines and UPGRADING.md § Frozen pre-v0.20 document-model migration (#2068) describe the pinned v0.59.0 path.
 
 ⊗ Start Phase 1, Phase 2, or a Returning-Sessions workflow while pre-cutover artifacts are present — run migration first.
 
@@ -83,6 +83,15 @@ The `plan.policy.wipCap` field caps the number of in-flight scope vBRIEFs (`vbri
 
 ⊗ Recommend a specific issue or vBRIEF without consulting `deft triage:queue` (or showing the operator the result of the consultation).
 
+## Umbrella status reading (#1152 / #2066)
+
+Umbrella and epic issues carry a pass-1 body (plan, stale by design) and a canonical `## Current shape (as of pass-N)` comment (live state). Before reporting umbrella status:
+
+- ! Fetch issue comments via REST (`gh api repos/<owner>/<repo>/issues/<N>/comments`), read the `## Current shape (as of pass-N)` comment, and any linked context or `LockedDecisions` vBRIEF referenced there — following the reading order body -> current-shape comment -> amendment comments (claim-cites-state-surface, #2066). Prefer the deterministic read path: `deft umbrella:current-shape <N>` (or `task umbrella:current-shape <N>`) — it locates the canonical comment, validates #1152 sections, and never falls back to the issue body.
+- ⊗ Conclude umbrella or epic status from the issue body alone. Any "X is done" / "X is the blocker" assertion about an umbrella MUST cite the current-shape comment or another state artifact, not the body.
+
+Cross-references: `.deft/core/.agents/skills/deft-directive-refinement/SKILL.md` and `.deft/core/.agents/skills/deft-directive-triage/SKILL.md` (before reporting umbrella status). Refs #1152, #2066.
+
 ## Content packs
 
 Deft ships versioned content packs (e.g. lessons learned from prior work) under `.deft/core/packs/`. Discover and LOAD pack content via the slice surface instead of reading whole pack files into context:

package/tasks/ci.yml

@@ -1,57 +0,0 @@
-version: '3'
-
-# Maintainer-only local CI mirror (#1813 contributor path / #2022 Phase 2).
-#
-# `ci:local` shells into scripts/ci_local.py via `uv run python`. Release
-# Step-5 pre-flight now uses the TS `task check` path (py-purge-ci-local-ts);
-# this fragment remains for explicit maintainer local CI only. Included from
-# the root Taskfile with `internal: true` — not wired into `check:consumer`
-# or the default `task check` aggregate.
-
-vars:
-  DEFT_ROOT: '{{joinPath .TASKFILE_DIR ".."}}'
-
-# ci:* tasks for running the full CI pipeline locally so contributors
-# catch CI failures before pushing.
-#
-# ci:local mirrors the step graph of .github/workflows/ci.yml on the
-# host platform:
-#
-#   - Linux:   Python (uv sync + ruff + mypy + pytest --cov), Go test +
-#              cross-compile builds for linux/amd64 + darwin/arm64 +
-#              windows/amd64, and the existing Taskfile-level
-#              verifications (toolchain:check, verify:stubs,
-#              verify:links, verify:rule-ownership, vbrief:validate,
-#              build).
-#
-#   - macOS:   Same as Linux. The darwin/arm64 cross-compile is the
-#              native build path. /dev/null is the discard target for
-#              cross-compile output.
-#
-#   - Windows: Same Python + Go + Taskfile-level steps; NUL replaces
-#              /dev/null as the cross-compile discard target.
-#              Additionally, when --matrix=windows is supplied the
-#              Windows-task-dispatch regression pytest guard-rails run
-#              -- those steps shell out to PowerShell and require a
-#              real Windows host (CI uses windows-latest).
-#
-# CLI_ARGS are forwarded so contributors can pass flags such as
-# --matrix=linux, --skip-build, --verbose, and --no-fail-fast.
-#
-# Per conventions/task-caching.md, this task forwards {{.CLI_ARGS}} to
-# a Python script that accepts user-facing flags (--skip-build,
-# --no-fail-fast, etc.); declaring sources: / generates: would short-
-# circuit the cmds: block and silently swallow those flags. Caching is
-# intentionally absent.
-#
-# Companion script: scripts/ci_local.py
-# Companion test:   tests/cli/test_ci_local.py
-
-tasks:
-  local:
-    desc: "Run the full CI pipeline locally (matrix-aware). Mirrors .github/workflows/ci.yml step graph; on Windows hosts --matrix=windows additionally runs the windows-task-dispatch regression guard-rails. Refs #233."
-    dir: '{{.USER_WORKING_DIR}}'
-    env:
-      PYTHONUTF8: "1"
-    cmds:
-      - uv --project "{{.DEFT_ROOT}}" run python "{{.DEFT_ROOT}}/scripts/ci_local.py" --root "{{.USER_WORKING_DIR}}" {{.CLI_ARGS}}