plumbbob 0.8.13 → 0.8.17

package/skills/pb-verify/SKILL.md

@@ -45,6 +45,14 @@ this skill verifies it the same way: **it reads the diff, not the author**.
    findings), and the validation, then
    **stop and wait for the human's explicit approval.** This is the convergence beat;
    the human is the clock. Never checkpoint without it.
+   - **Reconcile a drifted subject here, in the open (D5).** The planned title *is* the
+     checkpoint subject (D1). If the diff drifted from it — the step landed something the
+     title no longer describes — the body pass may propose a corrected subject, but it
+     **presents** it at this pause for explicit approval: show `planned title → proposed
+     subject`, one line, as part of what the human OKs. This is the exception, not the
+     default (D6): with **nothing presented**, the deterministic title-derived subject
+     lands untouched. A silent `-m` swap is exactly the agent-authored subject D68 refuses
+     — so a reconcile is *only ever* the visible, approved kind.
 6. **Checkpoint** *(only after approval)*. Run `plumbbob checkpoint`: it makes the WIP
    commit, records the SHA, flips the step to done, appends the step to the build-log's
    `## Log`, and returns to DESIGN. The CLI owns the commit **subject** — a Conventional
@@ -62,7 +70,10 @@ this skill verifies it the same way: **it reads the diff, not the author**.
    Do **not** run a TIL scan or reach for a separate commit skill — the body is yours to
    write in one breath. Omit `--body` entirely and the CLI writes a deterministic body
    (done-when + seam + diffstat) on its own. Either way, do **not** bump the version or
-   touch the changelog — that is the human's `/version` call.
+   touch the changelog — that is the human's `/version` call. And if step 5 surfaced a
+   drifted subject the human approved, land *that* subject by adding `-m "<subject>"` —
+   overriding the title-derived default for this one commit; unpresented, the CLI's
+   deterministic subject stands.
 7. **Hand off with the next model** *(once the checkpoint lands)*. `plumbbob checkpoint`
    returns to DESIGN; then run `plumbbob handoff` and relay its boundary block. With the
    step gone from in-flight it renders `step N checkpointed — back at the boundary` and

package/templates/intent.md

@@ -5,12 +5,18 @@ head; the chat is the hand. When the model floods you, read this, not your memor
 Size to the work: a small change fills Frame + a couple of Decisions and deletes
 the rest; a medium feature fills it all. Opinionated where decided, explicit where
 open. If the implementor (you-later, or the LLM) has to guess, the doc failed.
+
+One rule runs through the whole doc: compress what's settled; expand what's pending.
+Decisions and Constraints stay one line each — they re-inject into every build step,
+so their tokens recur. Open questions expand into plain-then-lean prose — a human
+reads them once, to decide, and that legibility buys back a chat round-trip.
 -->
 
 # {{TITLE}}
 
 **Phase** (your own bookkeeping while framing): frame
 **Size:** tiny | small | medium
+**Scope:** <short-scope>  <!-- the build's default commit scope (D4): a short feature-level name each step's own `(scope)` overrides. Leave the `<…>` placeholder (or blank) and it parses as absent — commits fall through to the build slug (D7). -->
 
 ## Frame
 
@@ -31,16 +37,20 @@ open. If the implementor (you-later, or the LLM) has to guess, the doc failed.
 
 ## Decisions
 
-*(One line each. Settled, not re-litigated in the chat. Grows as you resolve the
-holes `/pb-refine` surfaces, and as blockers fold in during BUILD.)*
+*(One line each — settled, not re-litigated in the chat. Grows as you resolve the
+holes `/pb-refine` surfaces, and as blockers fold in during BUILD. Mint a two- or
+three-word slug where each item is born — `D1 (slug-here)` — and copy that slug at
+every reference site, so a later `D4 (default-waves)` never decays into a bare `D4`
+a cold reader has to hunt down.)*
 
-- D1: <decision> — *because* <the one reason that mattered>
+- D1 (slug-here): <decision> — *because* <the one reason that mattered>
 
 ## Constraints
 
-*(Hard rules the build must honor. `/pb-verify` and `/pb-refine` read against these.)*
+*(Hard rules the build must honor. `/pb-verify` and `/pb-refine` read against these.
+Slug and gloss them at birth too — `C1 (no-new-deps)` — same one line, same rule.)*
 
-- C1: <e.g. functional/procedural only; no new dependencies>
+- C1 (no-new-deps): <e.g. functional/procedural only; no new dependencies>
 
 ## Steps
 
@@ -50,9 +60,13 @@ which `/pb-build` records in the build folder's `SEAM` for orientation — aware
 An optional **model** line recommends the smallest model that can carry the step —
 mechanical work runs fine on a small model; subtle or creative work earns a frontier
 one. Advisory for the human, never a gate; write it plain, no backticks (D62).
-A step title may open with a Conventional-Commit type (`fix:`, `feat(scope):`) — it
-becomes the checkpoint's commit subject; skip it and the subject defaults to `feat`,
-scoped by the build slug (D68). Then drive `/pb-build` until done. Later steps may be
+The step title *is* the checkpoint's commit subject: write it as one plain line,
+`type(scope): description` — load-bearing paths live in `seam`, never jammed into the
+title (D2) — aiming for ≤72 characters (GitHub's subject convention: soft, no gate, D9).
+The `(scope)` names the primary code area the step touches (`pb-plan`, `commitmsg`); the
+build's `**Scope:**` header is the feature-level catch-all a step overrides (D8). Scope
+resolves title-scope → `**Scope:**` default → build slug → bare, and type resolves
+title-type → `feat` (D3/D68). Then drive `/pb-build` until done. Later steps may be
 fuzzier than the first; sharpen the next one just-in-time with `/pb-step` (empty input
 auto-syncs it), and use `/pb-refine` to repair the whole plan when a blocker rewrites it.)*
 
@@ -64,10 +78,40 @@ auto-syncs it), and use `/pb-refine` to repair the whole plan when a blocker rew
 
 ## Open questions
 
-*(Holes you could NOT resolve on paper. Do not guess them into Decisions. A genuine
-fork goes to a SPIKE; record the verdict below and in Decisions.)*
+*(Holes you could NOT resolve on paper — the one section that expands rather than
+compresses. Do not guess them into Decisions; a genuine fork goes to a SPIKE, with
+the verdict recorded below and in Decisions.)*
+
+<!--
+Write each open question so a cold reader could answer it without flipping back to
+the code or the chat — that cold-reader test is the whole point of expanding it.
+Three lines:
+
+  · the opener — the hole as a question, slugged at birth, tagged
+    *resolve by:* decide | spike | ask
+  · *plain:* — what's at stake, in plain words: the context and the cost of getting
+    it wrong, enough to judge it cold
+  · *lean:* — the model's proposed resolution: one answer to react to, not a menu
+
+The human reads *plain* to understand, then *lean* to approve or redirect — one
+pass, no round-trip.
+
+When a question resolves, swap *resolve by:* for *resolved:* <date, the call> ON THE
+OPENER LINE, e.g.
+
+  - Q3 (default-waves): *resolved:* 2026-07-18, default off
+
+The status counter reads opener lines only, so a *resolved:* left on a *plain:* or
+*lean:* sub-line leaves the question still counted as open.
+
+Size to the work: a tiny build's single, obvious question may stay one bare line —
+the *plain:*/*lean:* pair earns its keep only when a human decision genuinely waits
+on it.
+-->
 
-- Q1: <unresolved> — *resolve by:* decide | spike | ask
+- Q1 (slug-here): <the unresolved hole, framed as a question> — *resolve by:* decide | spike | ask
+  - *plain:* <what's at stake, in plain words — enough to judge it cold>
+  - *lean:* <the model's proposed resolution — the answer to react to>
 
 ## Verdicts
 

package/node_modules/checkride/dist/baseline/command.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/baseline/command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,GAAG,EAAc,MAAM,oBAAoB,CAAC;AAEvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C,MAAM,MAAM,eAAe,GAAG;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,SAAS,IAAI,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC9B,MAAM,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAChC,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,sEAAsE;IACtE,EAAE,CAAC,EAAE,cAAc,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEnF,gFAAgF;AAChF,wBAAsB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAsCnF"}

package/node_modules/checkride/dist/baseline/command.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/baseline/command.ts"],"names":[],"mappings":"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"}