plumbbob 0.10.2 → 0.10.3

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "plumbbob",
   "displayName": "PlumbBob",
-  "version": "0.10.2",
+  "version": "0.10.3",
   "description": "Attention-first build process — driver skills + a CLI that keep you the decider: guidance on the work, a latch on the record.",
   "author": { "name": "Rob McLarty", "email": "hello@robmclarty.com", "url": "https://robmclarty.com" },
   "homepage": "https://github.com/robmclarty/plumbbob#readme",

package/README.md

@@ -152,7 +152,7 @@ a Claude Code built-in, so these docs write the full form.)
 nothing else:
 
 | Skill <img alt="" width="110" height="1"> | Does |
-|------------------------------------|------|
+| ------------------------------------ | ------ |
 | `/plumbbob:plan` | plan the whole goal: open the session and author intent's Frame, Decisions, Constraints, **and all Steps** |
 | `/plumbbob:build` | implement the next planned step, then verify it to the pause: `--auto` self-approves and chains to done; a range like `1-3` self-approves through step 3, then pauses |
 | `/plumbbob:finish` | finish up: write the report, make the final commit, clear for a fresh goal |
@@ -160,7 +160,7 @@ nothing else:
 **Plan-shaping moves**: optional, for when the plan needs work mid-flight:
 
 | Skill <img alt="" width="110" height="1"> | Does |
-|------------------------------------|------|
+| ------------------------------------ | ------ |
 | `/plumbbob:step` | revise/sharpen the next step (empty input auto-syncs it to reality) |
 | `/plumbbob:refine` | attack the frame for holes, or repair a drifted plan |
 | `/plumbbob:spike` | throwaway worktree experiment for a fork the plan can't settle |
@@ -168,7 +168,7 @@ nothing else:
 **Helpers**: orient, verify, recover, diagnose:
 
 | Skill <img alt="" width="110" height="1"> | Does |
-|------------------------------------|------|
+| ------------------------------------ | ------ |
 | `/plumbbob:status` | orient: where you are, the next step's done-when and seam, and the next move |
 | `/plumbbob:verify` | the tick, standalone: check → self-review → validate → **PAUSE** → checkpoint, for a diff `/plumbbob:build` didn't write |
 | `/plumbbob:revert` | rewind: `git reset --hard` to a recorded checkpoint |
@@ -179,7 +179,7 @@ nothing else:
 **Capture**: the park/harvest loop for mid-build ideas:
 
 | Skill <img alt="" width="110" height="1"> | Does |
-|------------------------------------|------|
+| ------------------------------------ | ------ |
 | `/plumbbob:park` | capture a mid-build idea without chasing it |
 | `/plumbbob:harvest` | triage parked ideas between steps (blocker / tangent / pivot) |
 

package/dist/lib/buildlog.js

@@ -10,6 +10,12 @@
  * Append `line` after the last non-blank line of the `## <heading>` section:
  * that is, just before the next `## ` heading or EOF.
  *
+ * When `line` is a list item and the line above it is prose (the Park list's
+ * guidance blockquote, the Log's instructions paragraph), a blank line goes in
+ * first. Markdown wants lists separated from prose (MD032), and a consumer
+ * repo that lints `.plumbbob/**` turns the missing blank into a red gate at
+ * the first park or checkpoint of a build.
+ *
  * Returns null when the section is absent so the caller can report rather than
  * silently corrupt the doc.
  */
@@ -29,9 +35,19 @@ export function appendToSection(content, heading, line) {
             insertAt = i + 1;
         }
     }
-    lines.splice(insertAt, 0, line);
+    const prev = lines[insertAt - 1] ?? '';
+    const needsBlank = isListLine(line) && prev.trim() !== '' && !isListLine(prev);
+    lines.splice(insertAt, 0, ...(needsBlank ? ['', line] : [line]));
     return lines.join('\n');
 }
+/**
+ * A markdown list line: `-`, `*`, or `+` after optional indent. Every caller
+ * of appendToSection appends one of these, so the blank-line rule above keys
+ * on the line it lands after, not on which verb is writing.
+ */
+function isListLine(line) {
+    return /^\s*[-*+]\s/.test(line);
+}
 /**
  * Replace the `**Current step:**` line with `**Current step:** <label>`:
  * `build` sets it to the step's number and title joined by an em dash when a

package/dist/verbs/finish.js

@@ -140,7 +140,7 @@ function appendStats(root, slug) {
         '## Stats',
         '',
         '| step | red checks | drift warnings | reverts | wall-clock |',
-        '|------|------------|----------------|---------|------------|',
+        '| ---- | ---------- | -------------- | ------- | ---------- |',
         ...rows,
         `| **total** | ${totals.redChecks} | ${totals.driftWarnings} | ${totals.reverts} | ${formatWall(totals.wallMs > 0 ? totals.wallMs : null)} |`,
         '',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plumbbob",
-  "version": "0.10.2",
+  "version": "0.10.3",
   "description": "Attention-first build process: 14 skills + a CLI that keep you the decider — guidance on the work, a latch on the record.",
   "keywords": [
     "claude-code",
@@ -53,6 +53,7 @@
     "@types/node": "26.2.0",
     "@vitest/coverage-v8": "4.1.10",
     "@vvago/vale": "3.17.1",
+    "cspell": "10.0.1",
     "fallow": "3.14.0",
     "fascicle": "0.8.16",
     "markdownlint-cli2": "0.23.2",

package/templates/build-log.md

@@ -36,11 +36,11 @@ check green + checkpoint taken, via `/plumbbob:verify` or `/plumbbob:build`.)*
 Classify each parked item as exactly ONE. Naming it before acting is what keeps you
 from sprawling across branches.
 
-| Class            | Meaning                                   | Action                          |
-|------------------|-------------------------------------------|---------------------------------|
-| **blocker**      | Plan was wrong/incomplete; can't proceed  | `/plumbbob:revert`, fold into intent  |
-| **tangent**      | A different path, not clearly better      | Defer or kill. Default here.    |
-| **pivot signal** | Evidence the whole approach is wrong      | Stop. Replan deliberately.      |
+| Class            | Meaning                                   | Action                               |
+| ---------------- | ----------------------------------------- | ------------------------------------ |
+| **blocker**      | Plan was wrong/incomplete; can't proceed  | `/plumbbob:revert`, fold into intent |
+| **tangent**      | A different path, not clearly better      | Defer or kill. Default here.         |
+| **pivot signal** | Evidence the whole approach is wrong      | Stop. Replan deliberately.           |
 
 > Reality check: almost everything that *feels* like a pivot is a tangent. Require a
 > failed assumption, not a shinier idea, before you pivot.