@deftai/directive-content 0.62.0 → 0.64.0

package/skills/deft-directive-review-cycle/SKILL.md

@@ -193,13 +193,13 @@ Both commands extract the "Comments Outside Diff" section with surrounding conte
 
 
 
-! Select the monitoring approach based on runtime capability detection (the matrix in `skills/deft-directive-swarm/SKILL.md` Phase 3 Step 1, extended per #1342 slices 1-2 for `spawn_subagent` / "grok-build" as a first-class tier). Probe the environment (tool set + env vars) to obtain the stable platform descriptor (`grok-build`, `warp-orchestrated`, `warp-interactive`, etc.) from the launch adapter / `get_platform_capabilities` and map the descriptor to the appropriate tier + dispatch primitive (start_agent or spawn_subagent). The descriptor (not hard-coded tool presence) is the single source of truth for both launch and review monitoring.
+! Select the monitoring approach based on runtime capability detection (the matrix in `skills/deft-directive-swarm/SKILL.md` Phase 3 Step 1, extended per #1342 slices 1-2 for `spawn_subagent` / "grok-build" and per #1877 for Cursor as first-class Tier-1 tiers). Probe the environment (tool set + env vars) to obtain the stable platform descriptor (`grok-build`, `warp-orchestrated`, `warp-manual`, `cursor-composer`, `cursor-cloud-agent`, etc.) from the launch adapter / `get_platform_capabilities` and map the descriptor to the appropriate tier + dispatch primitive (`start_agent`, `spawn_subagent`, or the Cursor `Task` tool). The descriptor (not hard-coded tool presence) is the single source of truth for both launch and review monitoring.
 
-- **Tier 1 (orchestrated sub-agent)** → Approach 1 (spawn review-monitor sub-agent via the primitive matching the descriptor: `start_agent` or `spawn_subagent`)
+- **Tier 1 (orchestrated sub-agent)** → Approach 1 (spawn review-monitor sub-agent via the primitive matching the descriptor: `start_agent`, `spawn_subagent`, or the Cursor `Task` tool with `run_in_background: true`)
 - **Tier 2 (no sub-agent primitive, but scheduler/timer/auto-reinvocation)** → Approach 2 (yield-between-polls)
 - **Tier 3 (interactive session, nothing else)** → Approach 3 (blocking sleep loop as last resort)
 
-! Detection: use the full runtime capability matrix (swarm Phase 3 + launch adapter from #1342 slice 2). The old single-probe for `start_agent` is superseded; the returned platform descriptor determines both the orchestration path and the MCP surface (see MCP probe below). If the descriptor is `grok-build` (spawn_subagent present, start_agent + WARP_* absent), treat as Tier 1 with the spawn_subagent poller path.
+! Detection: use the full runtime capability matrix (swarm Phase 3 + launch adapter from #1342 slice 2). The old single-probe for `start_agent` is superseded; the returned platform descriptor determines both the orchestration path and the MCP surface (see MCP probe below). If the descriptor is `grok-build` (spawn_subagent present, start_agent + WARP_* absent), treat as Tier 1 with the spawn_subagent poller path. If the descriptor is `cursor-composer` / `cursor-cloud-agent` (Cursor `Task` tool present, start_agent + WARP_* + spawn_subagent absent), treat as **Tier 1 with the backgrounded Cursor `Task` poller path** (#1877) — NOT Tier 3. Cursor's `Task` tool is a first-class sub-agent primitive; degrading a Cursor session to the Approach-3 blocking poll is the misclassification #1877 closes.
 
 ! Swarm agents (whether launched via `start_agent` or `spawn_subagent` per the platform descriptor) SHOULD prefer Approach 1 for their own review-monitor sub-agent. Approach 2's yield-between-polls is not self-sustaining for swarm agents (see warning below). Always include the canonical `templates/agent-prompt-preamble.md` (AGENTS.md read mandate, #810 vBRIEF gate, #798 PowerShell UTF-8, pre-PR + review-cycle mandates) when spawning a poller sub-agent.
 
@@ -207,10 +207,12 @@ Both commands extract the "Comments Outside Diff" section with surrounding conte
 
 ! **Background dispatch (#1880):** Spawn the review-monitor sub-agent via the matching primitive IN THE BACKGROUND (Cursor: Task `run_in_background: true`; Grok Build: `spawn_subagent` with parent yielding). The parent MUST remain interactive while the poller runs.
 
+! **Heartbeat contract for Cursor pollers (#1877 / #1166):** A Cursor `Task` review-monitor poller whose loop runs > ~3 min MUST honour the sub-agent heartbeat contract (`docs/subagent-heartbeat.md`), same as the `spawn_subagent` path — emit periodic progress so the parent can distinguish a live poller from a hung one.
+
 ! When the platform descriptor indicates Tier 1 (sub-agent support), spawn a review-monitor sub-agent using the primitive matching the descriptor:
 
-1. ! Launch via the matching primitive: `start_agent` (Warp) **or** `spawn_subagent` (grok-build / TUI / non-Warp) with a prompt that instructs it to poll for Greptile completion. For `spawn_subagent` the prompt MUST reference the canonical poller template `templates/swarm-greptile-poller-prompt.md` (with placeholders filled) plus the agent preamble; the working directory / context must be the PR branch (worktree or equivalent for hybrid).
-2. ! The sub-agent polls using the mechanism for its primitive: for `spawn_subagent` use `get_command_or_subagent_output` (adaptive cadence: ~20-30s first check after push, ~60s second, ~90s thereafter; Greptile typically lands in 3-7 min); for `start_agent` the native messaging path. Front-load the first check to catch fast reviews.
+1. ! Launch via the matching primitive: `start_agent` (Warp), `spawn_subagent` (grok-build / TUI / non-Warp), **or the Cursor `Task` tool with `run_in_background: true` (`cursor-composer` / `cursor-cloud-agent`, #1877)** with a prompt that instructs it to poll for Greptile completion. For `spawn_subagent` and the Cursor `Task` tool the prompt MUST reference the canonical poller template `templates/swarm-greptile-poller-prompt.md` (with placeholders filled) plus the agent preamble; the working directory / context must be the PR branch (worktree or equivalent for hybrid).
+2. ! The sub-agent polls using the mechanism for its primitive: for `spawn_subagent` use `get_command_or_subagent_output` (adaptive cadence: ~20-30s first check after push, ~60s second, ~90s thereafter; Greptile typically lands in 3-7 min); for `start_agent` the native messaging path; for the Cursor `Task` tool the backgrounded-task completion-notification path. Front-load the first check to catch fast reviews.
 3. ! When the exit condition is met (Greptile review current on the HEAD commit SHA, confidence > 3, no P0/P1 remaining), the sub-agent reports completion back to the parent (via `send_message_to_agent` or the spawn_subagent result channel).
 4. ! The main conversation pane stays fully interactive during monitoring -- the user (or parent monitor) can continue other work.
 5. ! On receiving the completion message / result, the parent re-fetches findings (both gh pr view --comments and the secondary source) and proceeds to Step 5.

package/skills/deft-directive-swarm/SKILL.md

@@ -341,14 +341,16 @@ git worktree add <path> -b <branch-name> <configured-base-branch>
 
 1. ! **Probe for `start_agent` tool** — check the available tool set for `start_agent` (or equivalent agent-orchestration tool). Its presence indicates a Warp environment with native orchestration support.
 2. ! **Probe for Warp environment** — if `start_agent` is not available, check for `WARP_*` environment variables (e.g. `WARP_TERMINAL_SESSION`, `WARP_IS_WARP_TERMINAL`). Their presence indicates Warp without orchestration.
-3. ! **Probe for `spawn_subagent` tool** — when neither `start_agent` nor `WARP_*` is present, check for `spawn_subagent` (Grok Build / non-Warp TUI launch adapter, #1342 slice 2). Its presence indicates the grok-build platform.
-4. ! **Select launch path automatically** based on detection results — do NOT present static options:
+3. ! **Probe for the Cursor `Task` tool** — when neither `start_agent` nor `WARP_*` is present, check the tool set for the Cursor `Task` sub-agent tool (dispatchable in the background via `run_in_background: true`). Its presence indicates a Cursor environment with a **first-class Tier-1 sub-agent primitive** (#1877). Classify as `cursor-composer` for an interactive Composer session and `cursor-cloud-agent` for a Cursor cloud agent. Cursor is **Tier 1 → Approach 1** — do NOT let it fall through to `generic-terminal` / the Approach-3 blocking poll.
+4. ! **Probe for `spawn_subagent` tool** — when none of `start_agent`, `WARP_*`, or the Cursor `Task` tool is present, check for `spawn_subagent` (Grok Build / non-Warp TUI launch adapter, #1342 slice 2). Its presence indicates the grok-build platform.
+5. ! **Select launch path automatically** based on detection results — do NOT present static options:
    - **`start_agent` available** → Orchestrated launch (Step 2a) — preferred path, fully automated, no manual tab management
    - **`start_agent` unavailable, Warp detected** → Interactive Warp tabs (Step 2b) — full MCP, global rules, warm index; requires manual tab management
-   - **`grok-build` (`spawn_subagent` available, no `start_agent`, no `WARP_*`)** → Grok Build launch (Step 2d) — first-class non-Warp path
+   - **Cursor `Task` tool available (no `start_agent`, no `WARP_*`)** → Cursor sub-agent launch (Step 2e) via the `Task` tool with `run_in_background: true` (Tier 1 / Approach 1) — keeps the monitor pane interactive; descriptor is `cursor-composer` (interactive) or `cursor-cloud-agent` (cloud)
+   - **`grok-build` (`spawn_subagent` available, no `start_agent`, no `WARP_*`, no Cursor `Task` tool)** → Grok Build launch (Step 2d) — first-class non-Warp path
    - **No orchestration primitive detected** → `generic-terminal` degraded launch. Offer a **Serial self-execution downgrade** first: with explicit operator consent, the monitor may execute the prepared worker prompts itself one story at a time from the isolated worktrees. This preserves forward progress but is not true concurrent swarm execution.
-5. ! **Return a stable platform descriptor** for downstream phases — one of `warp-orchestrated` (start_agent available), `warp-manual` (Warp without start_agent), `grok-build` (spawn_subagent available, non-Warp), or `generic-terminal` (no orchestration primitives). The detection matrix MUST include explicit absence checks for `start_agent` and `WARP_*` so the four descriptors are unambiguous. Phase 4 monitoring and Phase 6 sub-agent dispatch read this stable platform descriptor as a single source of truth instead of re-running detection per call.
-6. ? **Cloud escape hatch** — use `oz agent run-cloud` (Step 2c) ONLY if the user explicitly requests cloud execution. Never default to cloud.
+6. ! **Return a stable platform descriptor** for downstream phases — one of `warp-orchestrated` (start_agent available), `warp-manual` (Warp without start_agent), `cursor-composer` (Cursor `Task` tool, interactive Composer), `cursor-cloud-agent` (Cursor `Task` tool, cloud agent), `grok-build` (spawn_subagent available, non-Warp, non-Cursor), or `generic-terminal` (no orchestration primitives). The detection matrix MUST include explicit absence checks for `start_agent`, `WARP_*`, and the Cursor `Task` tool so the six descriptors are unambiguous. Phase 4 monitoring and Phase 6 sub-agent dispatch read this stable platform descriptor as a single source of truth instead of re-running detection per call.
+7. ? **Cloud escape hatch** — use `oz agent run-cloud` (Step 2c) ONLY if the user explicitly requests cloud execution. Never default to cloud. (The Cursor `cursor-cloud-agent` descriptor above is distinct — it is a Cursor-native cloud agent detected via the `Task` tool, not the `oz` escape hatch.)
 
 ! In `generic-terminal` mode, if the operator declines serial self-execution, the manual terminal prompt-paste fallback remains available: the user can paste each generated prompt into any terminal or agent interface with access to the matching worktree. Surface the tradeoff clearly: manual paste preserves user control but requires tab/process management and is still not automated orchestration.
 
@@ -494,6 +496,17 @@ Agents execute on remote VMs without local MCP servers, codebase indexing, or Wa
 
 ~ This is the first-class non-Warp path. Workers use worktree state polling (`git status`, `git log`) and `get_command_or_subagent_output` as their coordination channel instead of Warp tab state.
 
+### Step 2e: Cursor Launch (Task tool available) — #1877
+
+! When the platform descriptor is `cursor-composer` or `cursor-cloud-agent` (Cursor `Task` tool detected, no `start_agent`, no `WARP_*`, no `spawn_subagent`), dispatch each worker via the Cursor `Task` tool with:
+1. The canonical `templates/agent-prompt-preamble.md` content as the preamble (AGENTS.md read mandate, #810 vBRIEF gate, #798 PowerShell UTF-8, pre-PR + review-cycle mandates).
+2. The standard worktree prompt (STEP 1-6 from the Prompt Template below).
+3. The worktree path set to the agent's isolated git worktree.
+4. ! **`run_in_background: true`** for any worker or poller whose loop runs longer than a short task (~3 min) — implementation, fix, and review-cycle workers — so the monitor conversation pane stays interactive (#1880 Gap D). The parent is notified on completion.
+5. ! **Deliberate model routing (#1739):** pass the route's `resolved_model` (when non-null) as the Task tool's `model` argument — stamping the C2 manifest is prep; the recorded model MUST reach the actual spawn call.
+
+~ This is the first-class Cursor path. It is **Tier 1 → Approach 1** (a backgroundable sub-agent primitive), equivalent in tier to `start_agent` / `spawn_subagent`; it MUST NOT be downgraded to a `generic-terminal` blocking poll. Cursor pollers whose loop runs > ~3 min MUST honour the sub-agent heartbeat contract (`docs/subagent-heartbeat.md`, #1166), same as the `spawn_subagent` path.
+
 ## Phase 4 — Monitor
 
 ### Polling Cadence

package/tasks/core.yml

@@ -1,136 +1,22 @@
 version: '3'
 
-# Maintainer-only Python self-test lane (#1813 contributor path / #2022 Phase 2).
-#
-# pytest, ruff, black, and mypy run here via `uv run` for framework-source-repo
-# pre-commit checks. This fragment is included from the root Taskfile with
-# `internal: true` so `core:*` tasks are NOT listed or callable from the CLI on
-# consumer installs — only `task check:framework-source` wires them as deps.
-#
-# Consumer `task check` dispatches to `check:consumer` (TS / deft verbs only).
-# Do NOT add these tasks to the consumer check aggregate.
+# Maintainer-only packaging lane (#1860). Build/clean dispatch the native
+# TypeScript build-dist helper; Python/uv paths removed.
 
 vars:
   DEFT_ROOT: '{{joinPath .TASKFILE_DIR ".."}}'
 
 tasks:
-  validate:
-    desc: Validate all markdown files
-    env:
-      PYTHONUTF8: "1"
-    cmds:
-      - cmd: >-
-          uv --project "{{.DEFT_ROOT}}" run python -c "from pathlib import Path;
-          files=[f for f in sorted(Path('.').rglob('*.md')) if '.git' not in f.parts and 'backup' not in f.parts];
-          [print(f'\u2713 {f}') for f in files];
-          print(f'\u2713 All {len(files)} markdown files validated')"
-
-  test:
-    desc: Run test suite
-    cmds:
-      # #1474: tolerate a missing tests/ directory. The installer (#1482)
-      # prunes the vendored .deft/core/tests/ from the consumer deposit, so in
-      # a vendored consumer `task deft:check` -> framework check -> core:test
-      # would otherwise run `pytest tests/` against a now-absent directory and
-      # exit with a path error instead of 0 (blocking #1474 acceptance a1).
-      # A cross-platform pathlib guard (no bare shell conditional, per the
-      # AGENTS.md Windows rules) skips the run with a clear notice when tests/
-      # is absent; the framework's own repo (tests/ present) still runs the
-      # full suite unchanged. The check targets the same CWD-relative `tests`
-      # path pytest would run against, so it is correct regardless of CWD.
-      - cmd: >-
-          uv --project "{{.DEFT_ROOT}}" run python -c "import sys, subprocess;
-          from pathlib import Path;
-          _exists = Path('tests').exists();
-          print('no tests/ (vendored consumer) -- skipping') if not _exists else None;
-          sys.exit(subprocess.run([sys.executable, '-m', 'pytest', 'tests']).returncode if _exists else 0)"
-
-  test:coverage:
-    desc: Run tests with coverage (fails if < 85%)
-    cmds:
-      - uv --project "{{.DEFT_ROOT}}" run pytest tests/ --cov --cov-report=html
-
-  fmt:
-    desc: Format Python code
-    cmds:
-      - uv --project "{{.DEFT_ROOT}}" run ruff format .
-      - uv --project "{{.DEFT_ROOT}}" run black .
-
-  lint:
-    desc: Lint and type-check Python code
-    cmds:
-      - uv --project "{{.DEFT_ROOT}}" run ruff check .
-      # #1475: bring the local type-check gate to parity with CI. The CI
-      # Python job (.github/workflows/ci.yml) runs `mypy tests/`, but this
-      # local gate previously checked only run.py -- so a type error under
-      # tests/ shipped green locally (task check -> core:lint) and reddened
-      # master after merge. The tests/ tree is now part of the gate; run.py
-      # is retained for its pre-existing local-only coverage. Both surfaces
-      # share the [tool.mypy] config in pyproject.toml, including the
-      # tests.* override that relaxes disallow_untyped_defs while still
-      # failing on real type mismatches under tests/.
-      #
-      # #1474: the same vendored-consumer guard core:test uses. The installer
-      # (#1482) prunes the vendored .deft/core/tests/, and `task deft:check`
-      # runs core:lint too, so an unconditional `mypy run.py tests/` would
-      # fail on the now-absent tests/ path. The cross-platform pathlib guard
-      # (no bare shell conditional, per the AGENTS.md Windows rules) appends
-      # tests/ to the mypy target list only when it exists; run.py (always in
-      # the payload) stays checked either way.
-      - cmd: >-
-          uv --project "{{.DEFT_ROOT}}" run python -c "import sys, subprocess;
-          from pathlib import Path;
-          targets = ['run.py'] + (['tests'] if Path('tests').exists() else []);
-          sys.exit(subprocess.run([sys.executable, '-m', 'mypy', *targets]).returncode)"
-
-
   build:
-    desc: Package framework for distribution (cross-platform via Python helper, #736)
-    env:
-      PYTHONUTF8: "1"
+    desc: Package framework for distribution (cross-platform via TypeScript build-dist, #736 / #1860)
+    deps:
+      - task: :ts:build
     cmds:
-      # Single cross-platform dispatch (#736). The Python helper uses
-      # stdlib tarfile / zipfile with a canonical exclude list and
-      # auto-selects tar.gz on Linux/macOS, zip on Windows. The previous
-      # platform-split shape had the Windows branch missing the exclude
-      # list, ingesting .git history and the prior dist/ artifact.
-      # Regression-guarded by tests/content/test_taskfile_zip_parity.py.
-      - uv --project "{{.DEFT_ROOT}}" run python "{{.DEFT_ROOT}}/scripts/build_dist.py" --version "{{.VERSION}}"
+      - node "{{.DEFT_ROOT}}/packages/core/dist/release/build-dist-runner.js" "{{.VERSION}}" "{{.DEFT_ROOT}}"
 
   clean:
-    desc: Clean generated artifacts (cross-platform via Python helper, #736)
-    env:
-      PYTHONUTF8: "1"
-    cmds:
-      # Single cross-platform dispatch (#736) -- mirrors the build target's
-      # simplification. Python's pathlib + shutil.rmtree handles the dist/
-      # directory removal identically on POSIX and Windows, replacing the
-      # prior rm -rf / Remove-Item duplication.
-      #
-      # The dist/ path is anchored at {{.DEFT_ROOT}} so `task clean` works
-      # the same way regardless of the operator's current working directory.
-      # The previous shape relied on `pathlib.Path('dist')` resolving against
-      # the inherited CWD, which silently no-ops when the operator runs
-      # `task -t tasks/core.yml clean` from a subdirectory (Greptile P2 on
-      # PR #773).
-      - cmd: >-
-          uv --project "{{.DEFT_ROOT}}" run python -c "import shutil, pathlib;
-          d = pathlib.Path(r'{{.DEFT_ROOT}}') / 'dist';
-          shutil.rmtree(d) if d.exists() else None;
-          print(f'Cleaned {d}')"
-
-  stats:
-    desc: Show framework statistics
+    desc: Clean generated dist/ artifacts (cross-platform, #736 / #1860)
     cmds:
       - cmd: >-
-          uv --project "{{.DEFT_ROOT}}" run python -c "from pathlib import Path;
-          v='{{.VERSION}}';
-          sep='='*42;
-          dirs=[('Core files','core'),('Languages','languages'),('Interfaces','interfaces'),('Tools','tools'),('Templates','templates')];
-          counts=[(n,len(list(Path(d).glob('*.md')))) for n,d in dirs];
-          total=len([f for f in Path('.').rglob('*.md') if '.git' not in str(f) and 'backup' not in str(f)]);
-          print(f'Deft Framework v{v} Statistics:');
-          print(sep);
-          [print(f'{n}: {c}') for n,c in counts];
-          print(f'Total files: {total}');
-          print(sep)"
+          node -e "const fs=require('node:fs');const path=require('node:path');const d=path.join(process.argv[1],'dist');if(fs.existsSync(d))fs.rmSync(d,{recursive:true,force:true});console.log('Cleaned '+d);"
+          "{{.DEFT_ROOT}}"

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/verify.yml

@@ -45,6 +45,17 @@ tasks:
     cmds:
       - node "{{.DEFT_ROOT}}/packages/cli/dist/bin.js" verify-content-manifest --project-root "{{.DEFT_ROOT}}"
 
+  cursor-tier1:
+    desc: "Framework-source content gate (#1877): assert Cursor (cursor-composer / cursor-cloud-agent, Task-tool primitive) is enumerated as a Tier-1 descriptor in the swarm Phase 3 capability matrix AND the review-cycle monitoring tier table. Fails when a doc edit drops the Cursor descriptor and silently re-opens the Tier-3 blocking-poll misclassification. Three-state exit (0 clean / 1 missing marker / 2 config error)."
+    deps:
+      - _ts-build
+    # Framework-source-only gate: it scans THIS repo's two skill docs, so it
+    # targets DEFT_ROOT (not USER_WORKING_DIR) -- a consumer install renders
+    # these skills under .deft/core and does not author them. Mirrors
+    # verify:content-manifest / verify:rule-ownership.
+    cmds:
+      - node "{{.DEFT_ROOT}}/packages/cli/dist/bin.js" verify-cursor-tier1 --project-root "{{.DEFT_ROOT}}"
+
   go-freeze:
     desc: "Tier-1 freeze gate for the legacy Go-installer bridge (#1912). Advisory while the Tier-0 SoT (lastGoInstaller) is null; once the operator pins it, fails when cmd/deft-install is bumped above the frozen tag. Three-state exit (0 ok / 1 violation / 2 config error). Emergency bypass: DEFT_ALLOW_GO_INSTALLER_BUMP=1."
     deps:

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}}