plumbbob 0.5.3 → 0.5.4

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "plumbbob",
   "displayName": "PlumbBob",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "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/dist/lib/sidecar.js

@@ -27,8 +27,9 @@ export function buildDir(root, slug) {
 // Derive a filesystem-safe slug from a build title: lowercased, every run of
 // non-alphanumerics collapsed to a single hyphen, trimmed of leading/trailing
 // hyphens. The CLI stays dumb and explicit (D38) — collision handling belongs to
-// the caller (`start` refuses rather than silently suffixing `-2`). A title with
-// no alphanumerics yields `''`, which the caller must reject or override.
+// the caller (`start` refuses rather than silently suffixing `-2`, and prepends
+// the `YYYY-MM-DD-` date that keeps `listBuilds`' lexical sort chronological). A
+// title with no alphanumerics yields `''`, which the caller must reject or override.
 export function slugify(title) {
     return title
         .toLowerCase()

package/dist/verbs/start.js

@@ -15,7 +15,7 @@ export function start(cwd, args) {
     const allowDirty = args.includes('--allow-dirty');
     const local = args.includes('--local');
     const title = (positionals[0] ?? '').trim();
-    const slug = (flagValue(args, '--slug') ?? slugify(title)).trim();
+    const slug = (flagValue(args, '--slug') ?? datedSlug(title)).trim();
     if (title.length === 0) {
         process.stderr.write('plumbbob: start needs a title. Try: plumbbob start "what you are building".\n');
         return 1;
@@ -55,8 +55,8 @@ export function start(cwd, args) {
     // D26: `--local` keeps today's fully-untracked flat layout (whole `.plumbbob/`
     // excluded); the default plants a tracked, PR-riding `builds/<slug>/` folder
     // (D26) and points the per-worktree cursor at it (D28), excluding only control
-    // files (D17). The slug is validated unique above — the CLI refuses, never
-    // suffixes (D38).
+    // files (D17). The slug is date-prefixed when derived (see datedSlug) and
+    // validated unique above — the CLI refuses, never suffixes (D38).
     let intentLocation;
     if (local) {
         writeFileSync(checkpointsPath(root), `baseline ${sha}\n`);
@@ -78,6 +78,19 @@ export function start(cwd, args) {
     process.stdout.write(`plumbbob: started "${title}" — baseline ${sha.slice(0, 9)}. Frame and decide in ${intentLocation}; \`build\` a step once the decisions are made.\n`);
     return 0;
 }
+// Derived slugs carry a `YYYY-MM-DD-` prefix (local time) so `builds/` sorts
+// chronologically under `listBuilds`' plain lexical sort — ordering by
+// construction, not by titling convention. An explicit `--slug` stays verbatim
+// (D38: the CLI never rewrites what the caller chose). An untitleable title
+// yields `''` so the empty-slug guard fires instead of minting a date-only slug.
+function datedSlug(title) {
+    const base = slugify(title);
+    if (base.length === 0)
+        return '';
+    const now = new Date();
+    const pad = (n) => String(n).padStart(2, '0');
+    return `${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())}-${base}`;
+}
 // Read the value that follows a `--flag` in argv (e.g. `--slug my-build`), or
 // undefined when the flag is absent or trails with no value.
 function flagValue(args, flag) {

package/package.json

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