plumbbob 0.4.13 → 0.4.14

package/.claude-plugin/plugin.json

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

package/README.md

@@ -33,11 +33,14 @@ PlumbBob installs **once, globally** — like `gh` or your dotfiles — in one o
 co-equal, mutually-exclusive ways (both register a Claude Code plugin named
 `plumbbob`).
 
-**Marketplace plugin** — self-contained; ships the skills *and* the CLI on PATH, so
-it needs neither `npm` nor `init`:
+**Marketplace plugin** — Claude Code installs the published `plumbbob` package for
+you (skills, hook, and the CLI on PATH), so you run no `npm i -g` and no `init`. It's
+published in the [`agent-tools`](https://github.com/robmclarty/agent-tools)
+marketplace — add that once, then install:
 
 ```text
-/plugin install plumbbob@<marketplace>
+/plugin marketplace add robmclarty/agent-tools
+/plugin install plumbbob@robmclarty
 ```
 
 **npm global + `init`** — installs the CLI, then links the skills and hook into

package/dist/cli-core.js

@@ -24,14 +24,14 @@ const VERBS = [
     { name: 'revert', summary: 'revert [--to n]: git reset --hard to a checkpoint SHA' },
     { name: 'park', summary: 'park "<text>": append a raw line to the park list' },
     { name: 'spike', summary: 'spike "<slug>" | spike done: throwaway worktree experiment' },
-    { name: 'wrap', summary: 'v2 close-out: archive intent+log+report (no gate), clear the sidecar, close the session' },
+    { name: 'wrap', summary: 'close-out: archive intent+log+report (no gate), clear the sidecar, close the session' },
     { name: 'init', summary: 'link plumbbob into Claude Code as an in-place plugin (~/.claude/skills/plumbbob); --uninstall to undo' },
     { name: 'doctor', summary: 'diagnose the plugin link (manifest, skills, hook) and print the fix for anything broken' },
 ];
-// Plumbbob v2 (D1/D10/D13): the deciding/executing boundary is no longer a lock,
+// PlumbBob (D1/D10/D13): the deciding/executing boundary is a pause, not a lock,
 // so there is nothing to defend — every verb runs the same whether a human or the
-// model triggers it. The old human-only `mode` escape hatch and its CLAUDECODE
-// in-session refusal are gone; what keeps the human the decider is the pause at
+// model triggers it. There is no human-only `mode` escape hatch and no CLAUDECODE
+// in-session refusal; what keeps the human the decider is the pause at
 // the step boundary (the skills), not a refusal here.
 export function formatHelp() {
     const width = Math.max(...VERBS.map((v) => v.name.length));

package/dist/lib/archive.js

@@ -1,4 +1,4 @@
-// The finish-phase archive helper (D20: archive is local-only markdown in v1).
+// The finish-phase archive helper (D20: archive is local-only markdown).
 // `finish` copies the three active files into .plumbbob/archive/<date>-<slug>/
 // before clearing the actives — "archive-then-clear, never destroy" (C4).
 // Functional/procedural, node builtins only (C1/C2).
@@ -58,7 +58,7 @@ function uniqueArchiveDir(root, base) {
 }
 // Copy intent + build-log + report into archive/<date>-<slug>/ and return the
 // directory created. Intent and build-log always exist in an active session; the
-// report is copied only when present — v2 `wrap` does not gate on it (D9), so a
+// report is copied only when present — `wrap` does not gate on it (D9), so a
 // close-out without a report still archives the rest.
 export function archiveSession(root) {
     const dir = uniqueArchiveDir(root, `${today()}-${slugify(sessionTitle(root))}`);

package/dist/verbs/build.js

@@ -24,6 +24,6 @@ export function build(cwd, args) {
     }
     writeFileSync(seamPath(root), `${parsed.seam.join('\n')}\n`);
     writeFileSync(stepPath(root), `${step}\n`);
-    process.stdout.write(`plumbbob: building step ${step}. Seam (for orientation; not a lock in v2):\n${parsed.seam.map((p) => `  ${p}`).join('\n')}\n`);
+    process.stdout.write(`plumbbob: building step ${step}. Seam (for orientation; not a lock):\n${parsed.seam.map((p) => `  ${p}`).join('\n')}\n`);
     return 0;
 }

package/dist/verbs/checkpoint.js

@@ -1,5 +1,5 @@
 // `plumbbob checkpoint [<n>] [-m <msg>]` — the executor-agnostic commit tick (D3).
-// Unlike v1 `done`, it does NOT require a STEP file: the step is whatever you pass,
+// It does NOT require a STEP file: the step is whatever you pass,
 // else the in-flight STEP, else the next undone step in intent. It gates on a green
 // check, then commits any pending work (or records the existing HEAD when the tree
 // is already clean — the human's commit skill may have committed first), records the

package/dist/verbs/wrap.js

@@ -1,8 +1,8 @@
-// `plumbbob wrap` (D9) — the v2 close-out, replacing the v1 four-verb
-// finish ceremony. It archives intent + build-log + report
+// `plumbbob wrap` (D9) — the close-out: one verb does the whole thing.
+// It archives intent + build-log + report
 // (the `/plumbbob:pb-wrap` skill writes the report by default) under .plumbbob/archive/,
-// clears the active files, and deletes the control state (STATE last). Unlike v1
-// `finish` there is NO refuse-without-report gate — guidance offers the artifact, it
+// clears the active files, and deletes the control state (STATE last). There is
+// NO refuse-without-report gate — guidance offers the artifact, it
 // does not wall the exit. Archive-then-clear, never destroy (C4); git untouched (C5).
 import { appendFileSync, existsSync, readFileSync, rmSync } from 'node:fs';
 import { join, relative } from 'node:path';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plumbbob",
-  "version": "0.4.13",
+  "version": "0.4.14",
   "description": "Attention-first build process: 11 skills + a CLI that keep you the decider — guidance, not enforcement.",
   "keywords": [
     "claude-code",

package/skills/pb-build/SKILL.md

@@ -27,7 +27,7 @@ at the pause for your approval. **Re-firing `/pb-build` is itself the clock tick
    the next undone, planned step in `.plumbbob/intent.md`. If there is no planned step
    to build, stop and tell the human to `/pb-step` first.
 2. **Enter the step.** Run `plumbbob build <n>` (records the in-flight STEP +
-   SEAM so `/pb-status` shows the step in flight; in v2 the seam is awareness, not a
+   SEAM so `/pb-status` shows the step in flight; the seam is awareness, not a
    lock).
 3. **Read the plan.** Read the step's **done-when**, its **seam**, and the
    **Decisions** and **Constraints** in `intent.md`. Build to *that* — the deciding

package/templates/intent.md

@@ -46,8 +46,8 @@ holes `/pb-refine` surfaces, and as blockers fold in during BUILD.)*
 
 *(The build plan. `/pb-plan` authors the **whole list up front** — each step a small,
 verifiable increment with its own **done-when** and **seam** (the paths it will touch,
-which `/pb-build` records in `.plumbbob/SEAM` for orientation — awareness, not a lock
-in v2). Then drive `/pb-build` until done. Later steps may be fuzzier than the first;
+which `/pb-build` records in `.plumbbob/SEAM` for orientation — awareness, not a lock).
+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.)*