@deftai/directive-content 0.101.0 → 0.102.0

package/commands.md

@@ -275,7 +275,7 @@ Current status: the validation, extractor, provider, registry, generated MAP, an
 - `task verify:capacity`, `task verify:wip-cap`, and `task verify:judgment-gates` -- policy/capacity gates.
 - `task verify:orphan-active` -- fail closed when active/running xBRIEFs still point at closed issues or merged PRs (#2321).
 - `task verify:completed-tracked` -- fail closed when closed scoped issues lack a tracked `xbrief/completed/` or `xbrief/cancelled/` artifact on the delivery tip (#3264); remediate with `task swarm:finalize-cohort` or a lifecycle PR. Standalone verb (not part of `task check`); use `--tip HEAD` when validating an in-flight land branch.
-- `task verify:ac` -- product-first acceptance gate (#3284). Runs `plan.acceptance.commands` (or #3267 literal ledger) **verbatim** before done; records AC-source rung (`stated`/`derived`/`project_floor`). Empty commands require `none_stated: true`. Primary name used first in `task check` (fail-fast); `--soft-missing-xbrief` for check composition. Rapid ceremony = AC-only; pressure/degraded makes hygiene advisory. `--capture-only` lists resolved commands without executing. Extends #3267 / #973.
+- `task verify:ac` -- product-first acceptance gate (#3284). Runs `plan.acceptance.commands` (or #3267 literal ledger) **verbatim** before done; records AC-source rung (`stated`/`derived`/`project_floor`). Empty commands require `none_stated: true`. Empty resolution is not a green run when the project has no suite floor (`soft_empty` + stamp-acceptance remedy, #3334). Primary name used first in `task check` (fail-fast); `--soft-missing-xbrief` for check composition. Rapid ceremony = AC-only; pressure/degraded makes hygiene advisory. `--capture-only` lists resolved commands without executing. Extends #3267 / #973.
 - `task verify:literal-ac` -- #3267 mechanism alias for verbatim stated-command run (same flags/cwd); prefer `verify:ac` for product-first done-gate.
 - `task coverage:hotspots` / `deft coverage:hotspots` -- read the latest coverage report, compare global metrics to the project's vitest thresholds, fail closed below the branch floor or below configured headroom (default 0.3pp), and list lowest modules plus uncovered branch samples for git-diff paths (`--json` for agents). Complements `deft verify:forward-coverage` (#1310) and `--allow-coverage-debt=#N` (#2573); does not replace them.
 

package/docs/consumer-check-contract.md

@@ -1,6 +1,6 @@
 # Consumer check contract (`verify:consumer-check-contract`)
 
-Refs: #3145 · Related: #3070 consumer gate integrity, #1519 check:consumer · Policy: #3189 coverageDebt / checkResume
+Refs: #3145 · Related: #3070 consumer gate integrity, #1519 check:consumer · Policy: #3314 coverageDebt / checkResume (reserved)
 
 ## Problem
 
@@ -49,34 +49,26 @@ Root cause of red `greenfield-python-free-smoke` after #3145: the gate only insp
 
 `consumer-gate-integrity` proves Taskfile includes resolve. This gate proves the **required enforcement set** is present and composed — not merely that a random verify task exists.
 
-## Coverage-debt hatch and local check resume (#3189)
+## Coverage-debt hatch and local check resume (#3314)
 
-Release-born hatch and suite-stamp features must not expand to consumers as silent defaults. Project policy lives under `plan.policy` in PROJECT-DEFINITION:
+Release-born hatch and suite-stamp features must not expand to consumers as silent defaults. Two **plain optional** fields live under `plan.policy` in PROJECT-DEFINITION. Both default off. Both are **reserved** — `task check` and `task release` do not read them.
 
-| Field | Shape | Fail-closed when unset |
+| Field | Shape | Fail-closed when absent / invalid / off |
 |---|---|---|
-| `coverageDebt` | `status: unset \| decided`, `mode: off \| warn \| hatch`, `autoFile` (hatch only; default false) | mode off — no hatch soft-pass |
-| `checkResume` | `status: unset \| decided`, `localStamp: off \| on`, `ciTrustsLocalStamp: false` (fixed v1) | localStamp off; **CI never trusts a laptop stamp** |
+| `coverageDebt.mode` | `off \| warn \| hatch` | no hatch soft-pass |
+| `checkResume.localStamp` | `off \| on` | no local suite-stamp resume; **CI never trusts a laptop stamp** |
 
-**Unset vs decided-off:** Unset keeps fail-closed *behavior* and still **nags** on interactive mutation session-start. Decided-off is quiet. Inspect with `deft policy:show --field=coverageDebt` and `--field=checkResume`. Doctor check `coverage-check-resume-policy` surfaces undecided as an **advisory skip** (never hard-fails doctor or `check:consumer`).
+Inspect with `deft policy:show --field=coverageDebt` and `--field=checkResume`. Doctor check `coverage-check-resume-policy` reports a **malformed typed block** (advisory skip). Absent or valid values pass. Interactive mutation session-start prints a one-line disclosure when either field is non-default; silent when both default.
 
-### Skippable session nudge
+`task check` is fail-closed **by policy**. The live manual hatch is `--allow-coverage-debt=#N` (#2866). Framework `task release` Step 5 hatch is #3187. These flags do not control either path.
 
-On interactive cold or re-arm **mutation** session-start, when either field is unset:
+### Expansion gates
 
-- **Why:** long checks fail late or barely miss coverage; the project chooses fail-closed, warn, or hatch with a debt issue on **this** repo; local machines may resume a green suite at the same HEAD; CI must not trust a laptop stamp.
-- **What:** one bundled choice — **Strict** (recommended), **Hatch-aware**, or **Later** (plus Discuss / Back per #1470).
-- **Later** does **not** set `status=decided`; the next ritual nags again.
-- **Stop nag** only after Strict / Hatch-aware (preset write) or **dismiss-with-reason** (visible on policy:show / doctor).
-- Headless / CI / non-TTY: nudge is skipped (fail-open; never blocks).
-
-### Expansion gates (after decided)
-
-| Feature | Expand to consumers? | Gate |
+| Feature | Status | Notes |
 |---|---|---|
-| Fast-before-slow gate ordering | Yes (universal UX) | No policy wait |
-| Local suite stamp resume | When `checkResume.localStamp=on` | Local only; CI ignores |
-| Coverage hatch / auto-file | When `coverageDebt.mode=hatch` (+ optional `autoFile`) | Ledger on **this** consumer repo |
+| Fast-before-slow gate ordering | Available | Universal UX; no policy wait |
+| Local suite stamp resume | **Reserved** | Setting exists; consumer expansion not implemented |
+| Coverage hatch / auto-file | **Reserved** | Setting exists; consumer expansion not implemented. Live hatch: `--allow-coverage-debt=#N` (#2866) |
 | CI trusts local stamp | **Not v1** | Separate RFC |
 
 ### Non-goals
@@ -84,4 +76,4 @@ On interactive cold or re-arm **mutation** session-start, when either field is u
 - Silent default-on hatch for consumers.
 - Auto-filing coverage-debt issues on **deftai/directive** from a consumer tree — the ledger is always **this** repo.
 - USER.md as source of truth for ship bars (personal never weakens the project bar).
-- Blocking headless CI on the nudge.
+- A session-start Strict / Hatch-aware / Later quiz.

package/docs/decision-log.md

@@ -92,9 +92,34 @@ Cross-cutting process/architecture decisions often have empty `activeScopeRefs`.
 | Chat / transcripts | Non-goal |
 | Full inter-run memory (#2741) | Related consumer later; not owned by this surface |
 
+## Overlap-cluster dispose (#3315)
+
+! Human-dispose an overlap cluster with `task decision:write`. Put **every** member issue number in `relatedIssues`. Repeat `--related-issue` once per member, or pass `--body-file` JSON with `relatedIssues: [N, M, ...]`. Include a `revisitTrigger`. Free-text MAY name the relationship (duplicate / consolidate / not-duplicate / parent-child / related) and a proposed canonical. No new schema.
+
+! Before re-recommending an overlap, portfolio-priority runs `task decision:list -- --issue N --json` per cited member and parks only when a dispose decision's `relatedIssues` covers this overlap's members, unless `revisitTrigger` applies. This is **advisory skill diligence**, not a `task check` gate.
+
+⊗ Treat the portfolio brief as the decision record (#3198/#3201). ⊗ Auto-close member issues from a dispose write. ⊗ Replace `triage:mark-duplicate`. ⊗ Project cluster labels.
+
+**Boundaries**
+
+| Surface | Role |
+|---------|------|
+| #886 | Governance tracker |
+| #1178 | Pre-filing |
+| #786 | PR-output cluster |
+| #3198/#3201 | Brief is never the decision record |
+| #1396 (this log) | Phase-1 home for dispose records |
+| `triage:mark-duplicate` | Unchanged |
+| Cluster labels | No projection |
+
+**Ledger earning condition**
+
+A dedicated tracked ledger (`xbrief/.triage-cache/duplicate-clusters.jsonl` + verbs) is **deferred**. Build only when a portfolio/coupling pass re-litigates a cluster **despite** a dispose decision already listing the member issue numbers. Design archive: #3310 (do not re-derive).
+
 ## Consumers
 
 - Portfolio dispose (#3198 / #3201 / pilot #3200)
+- Overlap-cluster dispose (#3315); ledger archive #3310
 - Process policy dogfood (SCM label-mirror first mass-apply #1423)
 - Multi-agent handoff continuity (related #2741 class)
 

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@deftai/directive-content",
-  "version": "0.101.0",
+  "version": "0.102.0",
+  "deftConsumerDeposit": true,
   "description": "Shippable Directive framework content in the consumer .deft/core/ layout (C1 flatten), plus the engine surfaces (.githooks/, Taskfile.yml, tasks/) the deposit wires. Python-free per #2022 Phase 3. Refs #11, #1669, #1967.",
   "license": "MIT",
   "type": "module",