@thebassclef/lite 1.9.11 → 1.9.12

package/README.md

@@ -67,7 +67,7 @@ your browser.
 
 ## Current release
 
-<!-- version-start -->1.9.11<!-- version-end -->
+<!-- version-start -->1.9.12<!-- 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";
       }
@@ -1079,13 +1131,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 +1151,7 @@ function buildInitReport(input) {
       files: catalog.hooks
     },
     refused,
+    unchanged,
     errored,
     failed: refused + errored
   };
@@ -1203,6 +1257,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 +1356,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(", ")}.
@@ -1531,12 +1587,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.
@@ -1606,6 +1675,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";
       }
@@ -1056,13 +1108,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 +1128,7 @@ function buildInitReport(input) {
       files: catalog.hooks
     },
     refused,
+    unchanged,
     errored,
     failed: refused + errored
   };
@@ -1180,6 +1234,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 +1333,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(", ")}.
@@ -1508,12 +1564,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.
@@ -1583,6 +1652,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.12";
 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.12";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

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

package/package.json

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