plumbbob 0.8.17 → 0.8.18

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "plumbbob",
   "displayName": "PlumbBob",
-  "version": "0.8.17",
+  "version": "0.8.18",
   "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

@@ -4,6 +4,12 @@
   <img src="hero.svg" alt="A row of plumb bobs of varying shapes hanging from strings" width="600">
 </p>
 
+<p align="center">
+  <a href="https://robmclarty.github.io/plumbbob/">Website</a> ·
+  <a href="https://robmclarty.github.io/plumbbob/docs.html">Docs</a> ·
+  <a href="https://robmclarty.github.io/plumbbob/api.html">API reference</a>
+</p>
+
 PlumbBob is a Claude Code plugin — twelve `/pb-*` skills and a small CLI — that runs
 LLM-assisted coding as a loop you control. You and the model settle the plan in a file
 *before* any code; then the model builds one small step at a time and **stops after

package/dist/verbs/finish.js

@@ -80,9 +80,11 @@ function buildDefaultScope(root, slug) {
 // `--body` reads the final-commit body from stdin (the single-quoted heredoc of
 // D34), so the pb-finish skill can compose a proportional close-out message. Returns
 // null when the flag is absent or stdin is empty — the commit then carries subject
-// only. A read error (no stdin attached) degrades to null rather than throwing.
+// only. Reading fd 0 blocks until EOF, which the heredoc supplies; a read error (no
+// stdin attached) degrades to null, and an interactive TTY — which would never send
+// EOF — skips the read instead of hanging (twin of checkpoint.ts's guard).
 function bodyArg(args) {
-    if (!args.includes('--body')) {
+    if (!args.includes('--body') || process.stdin.isTTY === true) {
         return null;
     }
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plumbbob",
-  "version": "0.8.17",
+  "version": "0.8.18",
   "description": "Attention-first build process: 12 skills + a CLI that keep you the decider — guidance on the work, a latch on the record.",
   "keywords": [
     "claude-code",
@@ -10,7 +10,7 @@
     "agent",
     "attention-first"
   ],
-  "homepage": "https://github.com/robmclarty/plumbbob#readme",
+  "homepage": "https://robmclarty.github.io/plumbbob/",
   "bugs": "https://github.com/robmclarty/plumbbob/issues",
   "repository": {
     "type": "git",

package/skills/pb-finish/SKILL.md

@@ -30,11 +30,24 @@ record.
    This is the "yeah, I did that" artifact. Write it by default; the human may edit it.
 2. **Finish.** Run `plumbbob finish`, which appends the checkpoint SHAs to the
    report and makes the final commit — subject `chore(<scope>): finish`, its body
-   led by a `plumbbob finish` marker plus an optional proportional `--body` (the
-   stdin heredoc) — then
+   led by a `plumbbob finish` marker plus an optional proportional `--body` — then
    clears the control state (the in-flight markers, then `STATE` last — one delete
    drops both the session sentinel and the active-build cursor it carries). The
    build folder stays in place, committed, and rides the branch into the PR.
+
+   `--body` reads the close-out message from **stdin via a single-quoted heredoc
+   redirect** — the same form the other verbs use:
+
+   ```
+   plumbbob finish --body <<'BODY'
+   …proportional close-out prose…
+   BODY
+   ```
+
+   Redirect the heredoc *into* the command (`--body <<'BODY'`). Do **not** pass it as
+   an argument value (`--body "$(cat <<'BODY'…)"`): `--body` ignores an argument and
+   reads stdin, so that form leaves stdin open with no EOF and the command hangs. Omit
+   `--body` entirely and the commit carries the `plumbbob finish` marker subject only.
 3. **Point at the next goal** — `/pb-plan` to frame the next one.
 
 ## The hard contracts