@deftai/directive-content 0.96.0 → 0.98.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. package/.agents/skills/deft-directive-portfolio-priority/SKILL.md +11 -0
  2. package/Taskfile.yml +6 -0
  3. package/UPGRADING.md +9 -6
  4. package/commands.md +17 -2
  5. package/contracts/test-boundary.md +18 -0
  6. package/docs/consumer-check-contract.md +64 -0
  7. package/docs/deft-directive-disable.md +6 -0
  8. package/docs/delivery-attempt.md +173 -0
  9. package/docs/openclaw-agent-host.md +36 -1
  10. package/docs/operator-log-hygiene-checklist.md +57 -0
  11. package/docs/operator-log-hygiene-consumer-pack-stub.md +75 -0
  12. package/docs/scope-provenance.md +54 -0
  13. package/docs/test-boundary.md +43 -0
  14. package/main.md +46 -0
  15. package/meta/philosophy.md +10 -0
  16. package/package.json +1 -1
  17. package/packs/patterns/patterns-pack-0.1.json +10 -0
  18. package/packs/skills/skills-pack-0.1.json +22 -5
  19. package/patterns/operator-log-hygiene.md +130 -0
  20. package/scm/github.md +26 -0
  21. package/skills/deft-directive-article-review/SKILL.md +17 -6
  22. package/skills/deft-directive-build/SKILL.md +41 -0
  23. package/skills/deft-directive-portfolio-priority/SKILL.md +144 -0
  24. package/skills/deft-directive-release/SKILL.md +22 -5
  25. package/skills/deft-directive-review-cycle/SKILL.md +150 -0
  26. package/skills/deft-directive-swarm/SKILL.md +14 -0
  27. package/skills/deft-directive-swarm/references/core-ops.md +14 -2
  28. package/skills/deft-directive-swarm/references/core-phase-0.md +34 -1
  29. package/skills/deft-directive-swarm/references/core-phase-3.md +6 -0
  30. package/skills/deft-directive-swarm/references/core-phase-4.md +21 -2
  31. package/skills/deft-directive-swarm/references/core-phase-5-6.md +17 -0
  32. package/skills/deft-directive-swarm/references/host-openclaw.md +4 -0
  33. package/tasks/engine-invoke.cjs +22 -17
  34. package/tasks/engine-invoke.test.cjs +30 -0
  35. package/tasks/verify.yml +30 -0
  36. package/templates/agent-prompt-preamble.md +8 -0
  37. package/templates/agents-entry.md +10 -0
  38. package/templates/swarm-greptile-poller-prompt.md +4 -2
@@ -67,6 +67,7 @@ Legacy `vbrief/` read-accepted; `deft migrate:xbrief` for `xbrief/` (v0.6→v0.8
67
67
  ! Process-critical skills with false-negative risk MUST be named in AGENTS.md (always-pin tier) — tier definitions: `.deft/core/docs/skill-pin-policy.md` (#2508).
68
68
  ! **Default always-pins:** `deft-directive-build`, `deft-directive-pre-pr`, `deft-directive-review-cycle`, `deft-directive-swarm` — read each `SKILL.md` when that work type starts.
69
69
  ⊗ Pin entire language packs, deployment docs, or framework bulk into AGENTS.md — pins are for false-negative-sensitive process gates only (#2508).
70
+ ! **Dual stop (#2442):** multi-iteration work MUST have success + failure/budget stop (max iters / no-progress / budget); single-turn exempt; halt with operator-visible report; ⊗ thrash. Defaults: build, swarm, review-cycle skills. See main.md Dual Stop Rule. Ledger #3143 (`packages/core/src/delivery-attempt/`).
70
71
 
71
72
  ## Through-merge worker dispatch (#3032)
72
73
 
@@ -74,6 +75,14 @@ Legacy `vbrief/` read-accepted; `deft migrate:xbrief` for `xbrief/` (v0.6→v0.8
74
75
  ⊗ Parent conversation implements or babysits product fix/CI loops for drive-to:merge-ready work when background subagent/worktree dispatch is available (#3032).
75
76
  ! After leaf announce: tool-first / yield / one short non-repeated answer; ⊗ N>2 near-identical zero-tool (FC14 / #3131). Machine: `evaluateParentTurnShape` (`parent-turn-shape`). Depth: preamble §11 + `docs/openclaw-agent-host.md`.
76
77
 
78
+ ## Envelope selection SLA (#3153)
79
+
80
+ ! Default story / through-merge unit of work is `drive-to: merge-ready`. Deliberate `stop-at: pr-open` is allowed only when a **partner merge-path owner** is planned (review-cycle babysit / Approach 1 lease / parent-retained) for Greptile + CI + post-merge `scope:complete` — triggers: capacity stall, wall-clock budget, large multi-gate, host nest limits (swarm Phase 0 decision tree). Depth: `deft-directive-swarm` + `deft-directive-review-cycle` partner merge-path.
81
+ ! Under human-merge policy, a **durable** owner (parent/monitor sticky lease or Phase 6 closer) MUST remain for post-merge `scope:complete` — CLEAN alone is not lifecycle complete.
82
+ ⊗ Silent PR-open handback for a worker already scoped `drive-to: merge-ready`.
83
+ ⊗ `stop-at: pr-open` without a named babysit / merge-path owner, or dual review-monitor leases on recovery (#3044 / #2261).
84
+ ⊗ Stand down at CLEAN under human-merge with no reachable post-merge `scope:complete` owner.
85
+
77
86
  ## Review-surface precedence (#2308)
78
87
 
79
88
  ! Route PR shepherding / review work through `deft-directive-review-cycle` — `.deft/core/.agents/skills/deft-directive-review-cycle/SKILL.md`; host `babysit` / `bugbot` / `security-review` advisory-only (#2308 / #2261).
@@ -89,6 +98,7 @@ Legacy `vbrief/` read-accepted; `deft migrate:xbrief` for `xbrief/` (v0.6→v0.8
89
98
  ## Branch policy & branch verification
90
99
 
91
100
  ! Feature branches — `deft verify:branch`, `deft verify:forward-coverage`, `deft coverage:hotspots`, hooks, `deft check` (#746 / #747) — `.deft/core/scm/github.md` § Branch policy.
101
+ ! Test placement + scope provenance (#3145) — `deft verify:test-boundary`, `deft verify:scope-provenance`, `deft verify:consumer-check-contract` (docs: `docs/test-boundary.md`, `docs/scope-provenance.md`, `docs/consumer-check-contract.md`); defaults warn-only until authored policy.
92
102
 
93
103
  ## Branch Policy Disclosure (#746)
94
104
 
@@ -446,9 +446,11 @@ Send to parent:
446
446
 
447
447
  `last_reviewed_sha` matches HEAD AND `has_blocking` is True. Do NOT exit on P2 -- those are non-blocking style suggestions per `skills/deft-directive-review-cycle/SKILL.md`.
448
448
 
449
- Address the findings per Phase 2 Step 2-3 of the review-cycle skill: read every finding, plan a single coherent batch, run `task check`, commit with message `fix: address Greptile review findings (batch)`, push. After the push, RESET the poll counter (the new commit triggers a fresh Greptile review pass) and continue polling. Do NOT exit -- this is the loop body of the review-cycle skill.
449
+ Address the findings per Phase 2 Step 2-3 of the review-cycle skill: read every finding, plan a single coherent batch, run `task check`, commit with message `fix: address Greptile review findings (batch)`, push. After the push, you MAY reset the **poll-wait timer** for the new HEAD (Greptile needs a fresh review window) but you MUST NOT reset the dual-stop **fix-batch counter** (#2442).
450
450
 
451
- If the same review surfaces 3 consecutive review cycles (push -> review -> still P0/P1 -> push -> review -> still P0/P1 -> push -> review -> still P0/P1), escalate to parent:
451
+ **Ownership-wide dual-stop state (#2442):** `fix_batch_count` and `primary_fingerprint` span the **whole review ownership for this PR**, not one poller process. On start: read prior state from a sticky PR comment marker `<!-- deft:dual-stop fix_batches=N fingerprint=... -->` (or the review-owner lease body if that surface already carries it); default N=0 when absent. After each substantive fix push: increment N, write the marker back, then continue. When a parent re-dispatches a replacement poller, it MUST pass prior N/fingerprint in the prompt placeholders or rely on the sticky marker — a fresh poller that starts at 0 while the same fingerprint remains is a dual-stop violation. When `fix_batch_count` reaches **3** OR the same primary P0/P1 fingerprint reappears on **2** consecutive re-reviews with no material fix, exit BLOCKED (do not open a fourth automatic fix batch). Mechanical durable ledgers: #3143 `packages/core/src/delivery-attempt/`. Continue polling only while under the dual-stop envelope. Do NOT exit early on a successful fix mid-loop — this is the loop body of the review-cycle skill.
452
+
453
+ If the dual-stop envelope is exhausted (3 fix batches or 2 identical no-progress re-reviews), escalate to parent:
452
454
 
453
455
  Subject: PR #{pr_number} escalation -- 3 review cycles still surfacing P0/P1
454
456
  Body: