@thebassclef/lite 1.9.11 → 1.9.13

package/README.md

@@ -67,7 +67,7 @@ your browser.
 
 ## Current release
 
-<!-- version-start -->1.9.11<!-- version-end -->
+<!-- version-start -->1.9.13<!-- version-end -->
 
 See [CHANGELOG.md](CHANGELOG.md) for the full changelog. Adopter-facing
 release notes live at [docs.bassclef.dev/docs/whats-new/releases](https://docs.bassclef.dev/docs/whats-new/releases).

package/dist/cli.cjs

@@ -272,6 +272,47 @@ function hashContent(content) {
   normalized = normalized.replace(/\r\n/g, "\n");
   return node_crypto.createHash("sha256").update(normalized, "utf8").digest("hex");
 }
+const SCHEMA_VERSION = "1.0.0";
+const WRITER_SLUG = "bassclef-init-npm";
+function registerInstallWrittenPaths(targetDir, paths, now = /* @__PURE__ */ new Date()) {
+  if (paths.length === 0) return;
+  const manifestPath = node_path.join(targetDir, "state", "install-written-paths.json");
+  let manifest = {
+    schema_version: SCHEMA_VERSION,
+    entries: []
+  };
+  if (node_fs.existsSync(manifestPath)) {
+    try {
+      const parsed = JSON.parse(node_fs.readFileSync(manifestPath, "utf8"));
+      if (parsed && typeof parsed === "object" && "entries" in parsed && Array.isArray(parsed.entries)) {
+        manifest = parsed;
+        manifest.schema_version = SCHEMA_VERSION;
+      }
+    } catch {
+    }
+  }
+  const writtenAt = now.toISOString().replace(/\.\d{3}Z$/, "Z");
+  const uniqueInputs = /* @__PURE__ */ new Map();
+  for (const p of paths) {
+    uniqueInputs.set(p.relativePath, p);
+  }
+  const incomingPaths = new Set(uniqueInputs.keys());
+  manifest.entries = manifest.entries.filter((e) => !incomingPaths.has(e.path));
+  for (const p of uniqueInputs.values()) {
+    manifest.entries.push({
+      path: p.relativePath,
+      writer: WRITER_SLUG,
+      written_at: writtenAt,
+      content_hash: `sha256:${p.contentHashSha256}`
+    });
+  }
+  node_fs.mkdirSync(node_path.dirname(manifestPath), { recursive: true });
+  node_fs.writeFileSync(
+    manifestPath,
+    JSON.stringify(manifest, null, 2) + "\n",
+    "utf8"
+  );
+}
 const SUBSTRATE_CONFIG_TEMPLATE_VERSION = "0.0.1";
 function substrateConfigMdTemplate(pkgVersion) {
   return [
@@ -549,6 +590,7 @@ function copySubstrate(targetDir, options = {}) {
     copied: [],
     copiedEntries: [],
     refused: [],
+    unchanged: [],
     errored: [],
     erroredMessages: [],
     hookCount: 0,
@@ -736,6 +778,16 @@ function copyOne(relPath, bundleRoot, options, result, scopeDecision) {
   } catch (e) {
     if (e instanceof WriteError) {
       if (e.kind === "AlreadyExists") {
+        if (scope === "user") {
+          try {
+            const existing = node_fs.readFileSync(targetPath, "utf8");
+            if (hashContent(existing) === hashContent(outputContent)) {
+              result.unchanged.push(adopterRelPath);
+              return "unchanged";
+            }
+          } catch {
+          }
+        }
         result.refused.push(adopterRelPath);
         return "refused";
       }
@@ -1028,6 +1080,24 @@ function matchesDesired(current) {
   const c = current;
   return c.type === STATUSLINE_FIELD.type && c.command === STATUSLINE_FIELD.command;
 }
+const VALUE_TEST_BLOCK = `Bassclef is ready.
+
+It added engineering workflows and automatic checks to Claude Code.
+Nothing else needs configuring.
+
+Try it on something small:
+
+  claude
+  /riff
+
+Describe a feature you're considering. You'll get three approaches before any code is written.
+
+Then choose one:
+  /launch
+
+When the plan looks right:
+  /build
+`;
 const FAMILIES = [
   "skills",
   "rules",
@@ -1079,13 +1149,14 @@ function buildInitReport(input) {
     else project += 1;
   }
   const refused = input.refused.length;
+  const unchanged = input.unchanged?.length ?? 0;
   const errored = input.errored.length;
   const written = input.configs.length + input.entries.length;
   return {
     schema_version: 3,
     tier: input.tier,
     totals: {
-      files: written + refused + errored,
+      files: written + refused + unchanged + errored,
       written,
       project,
       user,
@@ -1098,6 +1169,7 @@ function buildInitReport(input) {
       files: catalog.hooks
     },
     refused,
+    unchanged,
     errored,
     failed: refused + errored
   };
@@ -1203,6 +1275,7 @@ function runInit(argv) {
         entries: outcome.result?.wouldCopyEntries ?? [],
         configs: plans.map((pl) => ({ path: pl.relativePath })),
         refused: outcome.result?.refused ?? [],
+        unchanged: outcome.result?.unchanged ?? [],
         // A dry run still reads every source file, so it can still fail
         // to read one. Hard-coding this empty hid those failures from
         // the JSON (RFC-0005 A-3).
@@ -1301,6 +1374,7 @@ function dispatchSubstrateCopy(targetDir, force, verbose, dryRun, allowRoot, say
   }
   const parts = [];
   if (result.copied.length > 0) parts.push(`${result.copied.length} substrate files copied`);
+  if (result.unchanged.length > 0) parts.push(`${result.unchanged.length} already-present`);
   if (result.refused.length > 0) parts.push(`${result.refused.length} refused`);
   if (result.errored.length > 0) parts.push(`${result.errored.length} error(s)`);
   say(`bassclef init: ${parts.join(", ")}.
@@ -1366,32 +1440,34 @@ function dispatchSubstrateCopy(targetDir, force, verbose, dryRun, allowRoot, say
       catalogCounts["root-docs"] += 1;
     }
   }
-  const claudeCounts = [
-    catalogCounts.skills > 0 ? `${catalogCounts.skills} skills` : null,
-    catalogCounts.rules > 0 ? `${catalogCounts.rules} rules` : null,
-    catalogCounts.agents > 0 ? `${catalogCounts.agents} agents` : null,
-    catalogCounts.luminaries > 0 ? `${catalogCounts.luminaries} luminaries` : null
-  ].filter((s) => s !== null);
-  if (claudeCounts.length > 0) {
-    say(
-      `bassclef init: Installed ${claudeCounts.join(", ")} under <repo>/.claude/.
+  if (verbose) {
+    const claudeCounts = [
+      catalogCounts.skills > 0 ? `${catalogCounts.skills} skills` : null,
+      catalogCounts.rules > 0 ? `${catalogCounts.rules} rules` : null,
+      catalogCounts.agents > 0 ? `${catalogCounts.agents} agents` : null,
+      catalogCounts.luminaries > 0 ? `${catalogCounts.luminaries} luminaries` : null
+    ].filter((s) => s !== null);
+    if (claudeCounts.length > 0) {
+      say(
+        `bassclef init: Installed ${claudeCounts.join(", ")} under <repo>/.claude/.
 `
-    );
-  }
-  const otherCounts = [
-    catalogCounts.libs > 0 ? `${catalogCounts.libs} libs` : null,
-    catalogCounts.adrs > 0 ? `${catalogCounts.adrs} ADRs` : null,
-    catalogCounts.templates > 0 ? `${catalogCounts.templates} templates` : null,
-    catalogCounts["presence-templates"] > 0 ? `${catalogCounts["presence-templates"]} presence-templates` : null,
-    catalogCounts.standards > 0 ? `${catalogCounts.standards} standards` : null,
-    catalogCounts["root-docs"] > 0 ? `${catalogCounts["root-docs"]} root-docs` : null,
-    catalogCounts.scripts > 0 ? `${catalogCounts.scripts} scripts` : null
-  ].filter((s) => s !== null);
-  if (otherCounts.length > 0) {
-    say(
-      `bassclef init: Installed ${otherCounts.join(", ")} under <repo>/.
+      );
+    }
+    const otherCounts = [
+      catalogCounts.libs > 0 ? `${catalogCounts.libs} libs` : null,
+      catalogCounts.adrs > 0 ? `${catalogCounts.adrs} ADRs` : null,
+      catalogCounts.templates > 0 ? `${catalogCounts.templates} templates` : null,
+      catalogCounts["presence-templates"] > 0 ? `${catalogCounts["presence-templates"]} presence-templates` : null,
+      catalogCounts.standards > 0 ? `${catalogCounts.standards} standards` : null,
+      catalogCounts["root-docs"] > 0 ? `${catalogCounts["root-docs"]} root-docs` : null,
+      catalogCounts.scripts > 0 ? `${catalogCounts.scripts} scripts` : null
+    ].filter((s) => s !== null);
+    if (otherCounts.length > 0) {
+      say(
+        `bassclef init: Installed ${otherCounts.join(", ")} under <repo>/.
 `
-    );
+      );
+    }
   }
   if (result.refused.length > 0) {
     say(
@@ -1531,12 +1607,25 @@ function runReal$1(plans, force, verbose, targetDir, allowRoot, json, skipStatus
     entries: walker.result?.copiedEntries ?? [],
     configs: results.map((r) => ({ path: r.plan.relativePath })),
     refused: walker.result?.refused ?? [],
+    unchanged: walker.result?.unchanged ?? [],
     errored: walker.result?.errored ?? [],
     hookCount: walker.result?.hookCount ?? 0,
     declaredHooksCopied,
     tier: RESOLVED_TIER
   });
   writeManifest(targetDir, results, walker.result);
+  const createdConfigPaths = results.filter((r) => r.outcome === "created").map((r) => ({
+    relativePath: r.plan.relativePath,
+    contentHashSha256: hashContent(r.plan.content)
+  }));
+  const createdBundlePaths = (walker.result?.copiedEntries ?? []).filter((e) => typeof e.content_hash_sha256 === "string").map((e) => ({
+    relativePath: e.path,
+    contentHashSha256: e.content_hash_sha256
+  }));
+  registerInstallWrittenPaths(targetDir, [
+    ...createdConfigPaths,
+    ...createdBundlePaths
+  ]);
   if (walker.code === 0) {
     say(
       `bassclef init: your substrate lives under .claude/. Add .claude/ to .gitignore if you have not.
@@ -1562,6 +1651,9 @@ function runReal$1(plans, force, verbose, targetDir, allowRoot, json, skipStatus
       process.stdout.write(t);
     });
   }
+  if (!json && walker.code === 0) {
+    say(VALUE_TEST_BLOCK);
+  }
   return walker.code;
 }
 function shouldRefuseRoot(currentUid, allowRoot) {
@@ -1606,6 +1698,15 @@ function writeManifest(targetDir, results, walkerResult) {
         source: "bundle"
       });
     }
+    for (const path of walkerResult.unchanged) {
+      entries.push({
+        path,
+        template: `bundle:${path}`,
+        template_version: index.version,
+        outcome: "unchanged",
+        source: "bundle"
+      });
+    }
     for (const path of walkerResult.errored) {
       entries.push({
         path,

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { version } from "./index.js";
-import { realpathSync, statSync, constants, lstatSync, mkdirSync, accessSync, unlinkSync, openSync, writeSync, closeSync, readlinkSync, readFileSync, chmodSync, readdirSync, existsSync, writeFileSync, renameSync } from "node:fs";
+import { realpathSync, statSync, constants, lstatSync, mkdirSync, accessSync, unlinkSync, openSync, writeSync, closeSync, readlinkSync, existsSync, readFileSync, writeFileSync, chmodSync, readdirSync, renameSync } from "node:fs";
 import { isAbsolute, resolve, dirname, join, normalize, relative, basename as basename$1 } from "node:path";
 import { homedir } from "node:os";
 import { createHash } from "node:crypto";
@@ -249,6 +249,47 @@ function hashContent(content) {
   normalized = normalized.replace(/\r\n/g, "\n");
   return createHash("sha256").update(normalized, "utf8").digest("hex");
 }
+const SCHEMA_VERSION = "1.0.0";
+const WRITER_SLUG = "bassclef-init-npm";
+function registerInstallWrittenPaths(targetDir, paths, now = /* @__PURE__ */ new Date()) {
+  if (paths.length === 0) return;
+  const manifestPath = join(targetDir, "state", "install-written-paths.json");
+  let manifest = {
+    schema_version: SCHEMA_VERSION,
+    entries: []
+  };
+  if (existsSync(manifestPath)) {
+    try {
+      const parsed = JSON.parse(readFileSync(manifestPath, "utf8"));
+      if (parsed && typeof parsed === "object" && "entries" in parsed && Array.isArray(parsed.entries)) {
+        manifest = parsed;
+        manifest.schema_version = SCHEMA_VERSION;
+      }
+    } catch {
+    }
+  }
+  const writtenAt = now.toISOString().replace(/\.\d{3}Z$/, "Z");
+  const uniqueInputs = /* @__PURE__ */ new Map();
+  for (const p of paths) {
+    uniqueInputs.set(p.relativePath, p);
+  }
+  const incomingPaths = new Set(uniqueInputs.keys());
+  manifest.entries = manifest.entries.filter((e) => !incomingPaths.has(e.path));
+  for (const p of uniqueInputs.values()) {
+    manifest.entries.push({
+      path: p.relativePath,
+      writer: WRITER_SLUG,
+      written_at: writtenAt,
+      content_hash: `sha256:${p.contentHashSha256}`
+    });
+  }
+  mkdirSync(dirname(manifestPath), { recursive: true });
+  writeFileSync(
+    manifestPath,
+    JSON.stringify(manifest, null, 2) + "\n",
+    "utf8"
+  );
+}
 const SUBSTRATE_CONFIG_TEMPLATE_VERSION = "0.0.1";
 function substrateConfigMdTemplate(pkgVersion) {
   return [
@@ -526,6 +567,7 @@ function copySubstrate(targetDir, options = {}) {
     copied: [],
     copiedEntries: [],
     refused: [],
+    unchanged: [],
     errored: [],
     erroredMessages: [],
     hookCount: 0,
@@ -713,6 +755,16 @@ function copyOne(relPath, bundleRoot, options, result, scopeDecision) {
   } catch (e) {
     if (e instanceof WriteError) {
       if (e.kind === "AlreadyExists") {
+        if (scope === "user") {
+          try {
+            const existing = readFileSync(targetPath, "utf8");
+            if (hashContent(existing) === hashContent(outputContent)) {
+              result.unchanged.push(adopterRelPath);
+              return "unchanged";
+            }
+          } catch {
+          }
+        }
         result.refused.push(adopterRelPath);
         return "refused";
       }
@@ -1005,6 +1057,24 @@ function matchesDesired(current) {
   const c = current;
   return c.type === STATUSLINE_FIELD.type && c.command === STATUSLINE_FIELD.command;
 }
+const VALUE_TEST_BLOCK = `Bassclef is ready.
+
+It added engineering workflows and automatic checks to Claude Code.
+Nothing else needs configuring.
+
+Try it on something small:
+
+  claude
+  /riff
+
+Describe a feature you're considering. You'll get three approaches before any code is written.
+
+Then choose one:
+  /launch
+
+When the plan looks right:
+  /build
+`;
 const FAMILIES = [
   "skills",
   "rules",
@@ -1056,13 +1126,14 @@ function buildInitReport(input) {
     else project += 1;
   }
   const refused = input.refused.length;
+  const unchanged = input.unchanged?.length ?? 0;
   const errored = input.errored.length;
   const written = input.configs.length + input.entries.length;
   return {
     schema_version: 3,
     tier: input.tier,
     totals: {
-      files: written + refused + errored,
+      files: written + refused + unchanged + errored,
       written,
       project,
       user,
@@ -1075,6 +1146,7 @@ function buildInitReport(input) {
       files: catalog.hooks
     },
     refused,
+    unchanged,
     errored,
     failed: refused + errored
   };
@@ -1180,6 +1252,7 @@ function runInit(argv) {
         entries: outcome.result?.wouldCopyEntries ?? [],
         configs: plans.map((pl) => ({ path: pl.relativePath })),
         refused: outcome.result?.refused ?? [],
+        unchanged: outcome.result?.unchanged ?? [],
         // A dry run still reads every source file, so it can still fail
         // to read one. Hard-coding this empty hid those failures from
         // the JSON (RFC-0005 A-3).
@@ -1278,6 +1351,7 @@ function dispatchSubstrateCopy(targetDir, force, verbose, dryRun, allowRoot, say
   }
   const parts = [];
   if (result.copied.length > 0) parts.push(`${result.copied.length} substrate files copied`);
+  if (result.unchanged.length > 0) parts.push(`${result.unchanged.length} already-present`);
   if (result.refused.length > 0) parts.push(`${result.refused.length} refused`);
   if (result.errored.length > 0) parts.push(`${result.errored.length} error(s)`);
   say(`bassclef init: ${parts.join(", ")}.
@@ -1343,32 +1417,34 @@ function dispatchSubstrateCopy(targetDir, force, verbose, dryRun, allowRoot, say
       catalogCounts["root-docs"] += 1;
     }
   }
-  const claudeCounts = [
-    catalogCounts.skills > 0 ? `${catalogCounts.skills} skills` : null,
-    catalogCounts.rules > 0 ? `${catalogCounts.rules} rules` : null,
-    catalogCounts.agents > 0 ? `${catalogCounts.agents} agents` : null,
-    catalogCounts.luminaries > 0 ? `${catalogCounts.luminaries} luminaries` : null
-  ].filter((s) => s !== null);
-  if (claudeCounts.length > 0) {
-    say(
-      `bassclef init: Installed ${claudeCounts.join(", ")} under <repo>/.claude/.
+  if (verbose) {
+    const claudeCounts = [
+      catalogCounts.skills > 0 ? `${catalogCounts.skills} skills` : null,
+      catalogCounts.rules > 0 ? `${catalogCounts.rules} rules` : null,
+      catalogCounts.agents > 0 ? `${catalogCounts.agents} agents` : null,
+      catalogCounts.luminaries > 0 ? `${catalogCounts.luminaries} luminaries` : null
+    ].filter((s) => s !== null);
+    if (claudeCounts.length > 0) {
+      say(
+        `bassclef init: Installed ${claudeCounts.join(", ")} under <repo>/.claude/.
 `
-    );
-  }
-  const otherCounts = [
-    catalogCounts.libs > 0 ? `${catalogCounts.libs} libs` : null,
-    catalogCounts.adrs > 0 ? `${catalogCounts.adrs} ADRs` : null,
-    catalogCounts.templates > 0 ? `${catalogCounts.templates} templates` : null,
-    catalogCounts["presence-templates"] > 0 ? `${catalogCounts["presence-templates"]} presence-templates` : null,
-    catalogCounts.standards > 0 ? `${catalogCounts.standards} standards` : null,
-    catalogCounts["root-docs"] > 0 ? `${catalogCounts["root-docs"]} root-docs` : null,
-    catalogCounts.scripts > 0 ? `${catalogCounts.scripts} scripts` : null
-  ].filter((s) => s !== null);
-  if (otherCounts.length > 0) {
-    say(
-      `bassclef init: Installed ${otherCounts.join(", ")} under <repo>/.
+      );
+    }
+    const otherCounts = [
+      catalogCounts.libs > 0 ? `${catalogCounts.libs} libs` : null,
+      catalogCounts.adrs > 0 ? `${catalogCounts.adrs} ADRs` : null,
+      catalogCounts.templates > 0 ? `${catalogCounts.templates} templates` : null,
+      catalogCounts["presence-templates"] > 0 ? `${catalogCounts["presence-templates"]} presence-templates` : null,
+      catalogCounts.standards > 0 ? `${catalogCounts.standards} standards` : null,
+      catalogCounts["root-docs"] > 0 ? `${catalogCounts["root-docs"]} root-docs` : null,
+      catalogCounts.scripts > 0 ? `${catalogCounts.scripts} scripts` : null
+    ].filter((s) => s !== null);
+    if (otherCounts.length > 0) {
+      say(
+        `bassclef init: Installed ${otherCounts.join(", ")} under <repo>/.
 `
-    );
+      );
+    }
   }
   if (result.refused.length > 0) {
     say(
@@ -1508,12 +1584,25 @@ function runReal$1(plans, force, verbose, targetDir, allowRoot, json, skipStatus
     entries: walker.result?.copiedEntries ?? [],
     configs: results.map((r) => ({ path: r.plan.relativePath })),
     refused: walker.result?.refused ?? [],
+    unchanged: walker.result?.unchanged ?? [],
     errored: walker.result?.errored ?? [],
     hookCount: walker.result?.hookCount ?? 0,
     declaredHooksCopied,
     tier: RESOLVED_TIER
   });
   writeManifest(targetDir, results, walker.result);
+  const createdConfigPaths = results.filter((r) => r.outcome === "created").map((r) => ({
+    relativePath: r.plan.relativePath,
+    contentHashSha256: hashContent(r.plan.content)
+  }));
+  const createdBundlePaths = (walker.result?.copiedEntries ?? []).filter((e) => typeof e.content_hash_sha256 === "string").map((e) => ({
+    relativePath: e.path,
+    contentHashSha256: e.content_hash_sha256
+  }));
+  registerInstallWrittenPaths(targetDir, [
+    ...createdConfigPaths,
+    ...createdBundlePaths
+  ]);
   if (walker.code === 0) {
     say(
       `bassclef init: your substrate lives under .claude/. Add .claude/ to .gitignore if you have not.
@@ -1539,6 +1628,9 @@ function runReal$1(plans, force, verbose, targetDir, allowRoot, json, skipStatus
       process.stdout.write(t);
     });
   }
+  if (!json && walker.code === 0) {
+    say(VALUE_TEST_BLOCK);
+  }
   return walker.code;
 }
 function shouldRefuseRoot(currentUid, allowRoot) {
@@ -1583,6 +1675,15 @@ function writeManifest(targetDir, results, walkerResult) {
         source: "bundle"
       });
     }
+    for (const path of walkerResult.unchanged) {
+      entries.push({
+        path,
+        template: `bundle:${path}`,
+        template_version: version,
+        outcome: "unchanged",
+        source: "bundle"
+      });
+    }
     for (const path of walkerResult.errored) {
       entries.push({
         path,

package/dist/index.cjs

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const version = "1.9.11";
+const version = "1.9.13";
 exports.version = version;

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export declare const version: "1.9.11";
+export declare const version: "1.9.13";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,4 +1,4 @@
-const version = "1.9.11";
+const version = "1.9.13";
 export {
   version
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thebassclef/lite",
-  "version": "1.9.11",
+  "version": "1.9.13",
   "description": "Bassclef CLI — install and upgrade bassclef in your project with two commands.",
   "keywords": [
     "bassclef",