@thebassclef/lite 1.4.1 → 1.6.0

package/README.md

@@ -35,7 +35,7 @@ See [`standards/os-support.md`](standards/os-support.md) for the full policy.
 
 ## Current release
 
-<!-- version-start -->1.4.1<!-- version-end -->
+<!-- version-start -->1.6.0<!-- version-end -->
 
 See [CHANGELOG.md](CHANGELOG.md) for release notes.
 

package/dist/cli.cjs

@@ -38,7 +38,8 @@ const DEFAULTS$2 = {
   allowAnyDir: false,
   dir: void 0,
   yes: false,
-  json: false
+  json: false,
+  skipStatusline: false
 };
 let ArgvError$1 = class ArgvError extends Error {
   name = "ArgvError";
@@ -83,6 +84,11 @@ function parseInitArgs(argv) {
       i += 1;
       continue;
     }
+    if (token === "--skip-statusline") {
+      out.skipStatusline = true;
+      i += 1;
+      continue;
+    }
     if (token === "--dir") {
       const value = argv[i + 1];
       if (value === void 0 || value.startsWith("--")) {
@@ -802,6 +808,149 @@ function dirExists(p) {
     return false;
   }
 }
+const STATUSLINE_FIELD = {
+  type: "command",
+  command: "bash ~/.claude/bassclef-statusline.sh"
+};
+const DISPATCHER_REL = ["dist", "lite", "presence", "cli", "bassclef-statusline.dispatcher.sh"];
+const USER_DISPATCHER_REL = [".claude", "bassclef-statusline.sh"];
+const PROJECT_SETTINGS_REL = [".claude", "settings.json"];
+function installStatusline(opts) {
+  if (opts.skip) {
+    return {
+      dispatcher: skipped(node_path.join(opts.home, ...USER_DISPATCHER_REL)),
+      settings: skipped(node_path.join(opts.projectDir, ...PROJECT_SETTINGS_REL))
+    };
+  }
+  const dispatcherSource = node_path.join(opts.packageDir, ...DISPATCHER_REL);
+  if (!node_fs.existsSync(dispatcherSource)) {
+    throw new Error(
+      `bassclef init: cannot install statusline — bundled dispatcher missing at ${dispatcherSource}. Reinstall @thebassclef/lite or file a bug.`
+    );
+  }
+  const sourceBody = node_fs.readFileSync(dispatcherSource, "utf8");
+  const dispatcher = handleDispatcher(opts, dispatcherSource, sourceBody);
+  const settings = handleSettings(opts);
+  return { dispatcher, settings };
+}
+function handleDispatcher(opts, sourcePath, sourceBody) {
+  const target = node_path.join(opts.home, ...USER_DISPATCHER_REL);
+  if (opts.dryRun) {
+    return {
+      kind: "would-install",
+      path: target,
+      detail: `Dry-run: would copy ${sourcePath} → ${target} (0755).`
+    };
+  }
+  if (!node_fs.existsSync(target)) {
+    writeExec(target, sourceBody);
+    return { kind: "installed", path: target, detail: `Wrote ${target} (0755) from bundled dispatcher.` };
+  }
+  const st = node_fs.lstatSync(target);
+  if (st.isSymbolicLink()) {
+    if (!opts.force) {
+      return {
+        kind: "preserved",
+        path: target,
+        detail: `${target} is a symlink; refusing to follow. Pass --force to replace.`
+      };
+    }
+    node_fs.unlinkSync(target);
+    writeExec(target, sourceBody);
+    return { kind: "replaced", path: target, detail: `Replaced symlink at ${target} with bundled dispatcher.` };
+  }
+  const existing = node_fs.readFileSync(target, "utf8");
+  if (existing === sourceBody) {
+    return { kind: "unchanged", path: target, detail: `${target} already matches bundled dispatcher.` };
+  }
+  if (!opts.force) {
+    return {
+      kind: "preserved",
+      path: target,
+      detail: `${target} differs from bundled dispatcher. Pass --force to overwrite.`
+    };
+  }
+  writeExec(target, sourceBody);
+  return { kind: "replaced", path: target, detail: `Overwrote ${target} (--force) with bundled dispatcher.` };
+}
+function handleSettings(opts) {
+  const target = node_path.join(opts.projectDir, ...PROJECT_SETTINGS_REL);
+  if (opts.settingsPreserved) {
+    return {
+      kind: "preserved",
+      path: target,
+      detail: `${target} was preserved by init (--force not passed on existing file). Statusline field not merged. Re-run init with --force to overwrite.`
+    };
+  }
+  if (opts.dryRun) {
+    return {
+      kind: "would-install",
+      path: target,
+      detail: `Dry-run: would set statusLine in ${target}.`
+    };
+  }
+  const existing = readSettings(target);
+  const desired = STATUSLINE_FIELD;
+  const current = existing.statusLine;
+  if (current === void 0) {
+    const next2 = { ...existing, statusLine: desired };
+    writeSettings(target, next2);
+    return { kind: "installed", path: target, detail: `Wrote statusLine field to ${target}.` };
+  }
+  if (matchesDesired(current)) {
+    return { kind: "unchanged", path: target, detail: `${target} already carries the bassclef statusLine.` };
+  }
+  if (!opts.force) {
+    return {
+      kind: "preserved",
+      path: target,
+      detail: `${target} carries a different statusLine. Pass --force to overwrite.`
+    };
+  }
+  const next = { ...existing, statusLine: desired };
+  writeSettings(target, next);
+  return { kind: "replaced", path: target, detail: `Overwrote statusLine in ${target} (--force).` };
+}
+function skipped(path) {
+  return {
+    kind: "skipped",
+    path,
+    detail: "--skip-statusline set; no changes to statusline target."
+  };
+}
+function writeExec(target, body) {
+  node_fs.mkdirSync(node_path.dirname(target), { recursive: true });
+  const tmp = `${target}.tmp-${process.pid}-${Date.now()}`;
+  node_fs.writeFileSync(tmp, body, { mode: 493 });
+  node_fs.renameSync(tmp, target);
+  node_fs.chmodSync(target, 493);
+}
+function readSettings(target) {
+  if (!node_fs.existsSync(target)) return {};
+  const raw = node_fs.readFileSync(target, "utf8");
+  if (raw.trim() === "") return {};
+  try {
+    const parsed = JSON.parse(raw);
+    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+      return parsed;
+    }
+    return {};
+  } catch {
+    return {};
+  }
+}
+function writeSettings(target, next) {
+  node_fs.mkdirSync(node_path.dirname(target), { recursive: true });
+  const tmp = `${target}.tmp-${process.pid}-${Date.now()}`;
+  node_fs.writeFileSync(tmp, `${JSON.stringify(next, null, 2)}
+`, { mode: 420 });
+  node_fs.renameSync(tmp, target);
+}
+function matchesDesired(current) {
+  if (!current || typeof current !== "object" || Array.isArray(current)) return false;
+  const c = current;
+  return c.type === STATUSLINE_FIELD.type && c.command === STATUSLINE_FIELD.command;
+}
 const FAMILIES = [
   "skills",
   "rules",
@@ -962,6 +1111,16 @@ function runInit(argv) {
       args.allowRoot,
       say
     );
+    const dryRunSettingsPreserved = !(args.force || upgradeApproved) && node_fs.existsSync(node_path.join(targetDir, ".claude", "settings.json"));
+    maybeEmitStatuslinePlan({
+      dryRun: true,
+      force: args.force || upgradeApproved,
+      skip: args.skipStatusline,
+      allowRoot: args.allowRoot,
+      targetDir,
+      say,
+      settingsPreserved: dryRunSettingsPreserved
+    });
     if (args.json) {
       const report = buildInitReport({
         entries: outcome.result?.wouldCopyEntries ?? [],
@@ -981,7 +1140,7 @@ function runInit(argv) {
     }
     return outcome.code;
   }
-  return runReal$1(plans, args.force || upgradeApproved, args.verbose, targetDir, args.allowRoot, args.json, say);
+  return runReal$1(plans, args.force || upgradeApproved, args.verbose, targetDir, args.allowRoot, args.json, args.skipStatusline, say);
 }
 function maybeEmitUpgradeAdvisory(targetDir, yes, json) {
   const prompt = json ? (t) => {
@@ -1204,7 +1363,7 @@ function runDryRun$1(plans, say) {
   }
   return 0;
 }
-function runReal$1(plans, force, verbose, targetDir, allowRoot, json, say) {
+function runReal$1(plans, force, verbose, targetDir, allowRoot, json, skipStatusline, say) {
   const results = [];
   let anyRefused = false;
   let anyError = false;
@@ -1307,6 +1466,20 @@ function runReal$1(plans, force, verbose, targetDir, allowRoot, json, say) {
 `
     );
   }
+  const settingsRefused = (walker.result?.refused ?? []).some((r) => {
+    const p = typeof r === "string" ? r : r.path;
+    if (typeof p !== "string") return false;
+    return p === node_path.join(".claude", "settings.json") || p === ".claude/settings.json" || p.endsWith("/.claude/settings.json");
+  });
+  maybeEmitStatuslinePlan({
+    dryRun: false,
+    force,
+    skip: skipStatusline,
+    allowRoot,
+    targetDir,
+    say,
+    settingsPreserved: settingsRefused
+  });
   if (json) {
     renderJsonReport(report, (t) => {
       process.stdout.write(t);
@@ -1440,6 +1613,67 @@ function readDeclaredCommandLeaves(settingsPath) {
     return /* @__PURE__ */ new Set();
   }
 }
+function maybeEmitStatuslinePlan(opts) {
+  const packageDir = node_path.dirname(node_path.dirname(resolveBundleRoot(void 0)));
+  const dispatcherSource = node_path.join(
+    packageDir,
+    "dist",
+    "lite",
+    "presence",
+    "cli",
+    "bassclef-statusline.dispatcher.sh"
+  );
+  if (!node_fs.existsSync(dispatcherSource)) {
+    return;
+  }
+  let home;
+  try {
+    home = resolveHome({ allowRoot: opts.allowRoot });
+  } catch {
+    return;
+  }
+  let report;
+  try {
+    report = installStatusline({
+      home,
+      projectDir: opts.targetDir,
+      packageDir,
+      force: opts.force,
+      dryRun: opts.dryRun,
+      skip: opts.skip,
+      settingsPreserved: opts.settingsPreserved
+    });
+  } catch {
+    return;
+  }
+  const dv = report.dispatcher.kind;
+  const sv = report.settings.kind;
+  if (dv === "skipped" && sv === "skipped") {
+    opts.say(`bassclef init: statusline install skipped (--skip-statusline).
+`);
+    return;
+  }
+  if (opts.dryRun) {
+    opts.say(
+      `bassclef init: would install statusline dispatcher at ${report.dispatcher.path} and set statusLine in ${report.settings.path}.
+`
+    );
+    return;
+  }
+  const parts = [];
+  if (dv === "installed") parts.push(`wrote ${report.dispatcher.path}`);
+  else if (dv === "replaced") parts.push(`replaced ${report.dispatcher.path} (--force)`);
+  else if (dv === "preserved") parts.push(`preserved ${report.dispatcher.path} (pass --force to overwrite)`);
+  else if (dv === "unchanged") parts.push(`${report.dispatcher.path} already matches bundle`);
+  if (sv === "installed") parts.push(`set statusLine in ${report.settings.path}`);
+  else if (sv === "replaced") parts.push(`replaced statusLine in ${report.settings.path} (--force)`);
+  else if (sv === "preserved") parts.push(`preserved statusLine in ${report.settings.path} (pass --force to overwrite)`);
+  else if (sv === "unchanged") parts.push(`statusLine in ${report.settings.path} already matches`);
+  if (parts.length > 0) {
+    opts.say(`bassclef init: statusline — ${parts.join("; ")}.
+`);
+  }
+}
 const DEFAULTS$1 = {
   force: false,
   replaceEdits: false,

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 } from "node:fs";
+import { realpathSync, statSync, constants, lstatSync, mkdirSync, accessSync, unlinkSync, openSync, writeSync, closeSync, readlinkSync, readFileSync, chmodSync, readdirSync, existsSync, writeFileSync, 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";
@@ -15,7 +15,8 @@ const DEFAULTS$2 = {
   allowAnyDir: false,
   dir: void 0,
   yes: false,
-  json: false
+  json: false,
+  skipStatusline: false
 };
 let ArgvError$1 = class ArgvError extends Error {
   name = "ArgvError";
@@ -60,6 +61,11 @@ function parseInitArgs(argv) {
       i += 1;
       continue;
     }
+    if (token === "--skip-statusline") {
+      out.skipStatusline = true;
+      i += 1;
+      continue;
+    }
     if (token === "--dir") {
       const value = argv[i + 1];
       if (value === void 0 || value.startsWith("--")) {
@@ -779,6 +785,149 @@ function dirExists(p) {
     return false;
   }
 }
+const STATUSLINE_FIELD = {
+  type: "command",
+  command: "bash ~/.claude/bassclef-statusline.sh"
+};
+const DISPATCHER_REL = ["dist", "lite", "presence", "cli", "bassclef-statusline.dispatcher.sh"];
+const USER_DISPATCHER_REL = [".claude", "bassclef-statusline.sh"];
+const PROJECT_SETTINGS_REL = [".claude", "settings.json"];
+function installStatusline(opts) {
+  if (opts.skip) {
+    return {
+      dispatcher: skipped(join(opts.home, ...USER_DISPATCHER_REL)),
+      settings: skipped(join(opts.projectDir, ...PROJECT_SETTINGS_REL))
+    };
+  }
+  const dispatcherSource = join(opts.packageDir, ...DISPATCHER_REL);
+  if (!existsSync(dispatcherSource)) {
+    throw new Error(
+      `bassclef init: cannot install statusline — bundled dispatcher missing at ${dispatcherSource}. Reinstall @thebassclef/lite or file a bug.`
+    );
+  }
+  const sourceBody = readFileSync(dispatcherSource, "utf8");
+  const dispatcher = handleDispatcher(opts, dispatcherSource, sourceBody);
+  const settings = handleSettings(opts);
+  return { dispatcher, settings };
+}
+function handleDispatcher(opts, sourcePath, sourceBody) {
+  const target = join(opts.home, ...USER_DISPATCHER_REL);
+  if (opts.dryRun) {
+    return {
+      kind: "would-install",
+      path: target,
+      detail: `Dry-run: would copy ${sourcePath} → ${target} (0755).`
+    };
+  }
+  if (!existsSync(target)) {
+    writeExec(target, sourceBody);
+    return { kind: "installed", path: target, detail: `Wrote ${target} (0755) from bundled dispatcher.` };
+  }
+  const st = lstatSync(target);
+  if (st.isSymbolicLink()) {
+    if (!opts.force) {
+      return {
+        kind: "preserved",
+        path: target,
+        detail: `${target} is a symlink; refusing to follow. Pass --force to replace.`
+      };
+    }
+    unlinkSync(target);
+    writeExec(target, sourceBody);
+    return { kind: "replaced", path: target, detail: `Replaced symlink at ${target} with bundled dispatcher.` };
+  }
+  const existing = readFileSync(target, "utf8");
+  if (existing === sourceBody) {
+    return { kind: "unchanged", path: target, detail: `${target} already matches bundled dispatcher.` };
+  }
+  if (!opts.force) {
+    return {
+      kind: "preserved",
+      path: target,
+      detail: `${target} differs from bundled dispatcher. Pass --force to overwrite.`
+    };
+  }
+  writeExec(target, sourceBody);
+  return { kind: "replaced", path: target, detail: `Overwrote ${target} (--force) with bundled dispatcher.` };
+}
+function handleSettings(opts) {
+  const target = join(opts.projectDir, ...PROJECT_SETTINGS_REL);
+  if (opts.settingsPreserved) {
+    return {
+      kind: "preserved",
+      path: target,
+      detail: `${target} was preserved by init (--force not passed on existing file). Statusline field not merged. Re-run init with --force to overwrite.`
+    };
+  }
+  if (opts.dryRun) {
+    return {
+      kind: "would-install",
+      path: target,
+      detail: `Dry-run: would set statusLine in ${target}.`
+    };
+  }
+  const existing = readSettings(target);
+  const desired = STATUSLINE_FIELD;
+  const current = existing.statusLine;
+  if (current === void 0) {
+    const next2 = { ...existing, statusLine: desired };
+    writeSettings(target, next2);
+    return { kind: "installed", path: target, detail: `Wrote statusLine field to ${target}.` };
+  }
+  if (matchesDesired(current)) {
+    return { kind: "unchanged", path: target, detail: `${target} already carries the bassclef statusLine.` };
+  }
+  if (!opts.force) {
+    return {
+      kind: "preserved",
+      path: target,
+      detail: `${target} carries a different statusLine. Pass --force to overwrite.`
+    };
+  }
+  const next = { ...existing, statusLine: desired };
+  writeSettings(target, next);
+  return { kind: "replaced", path: target, detail: `Overwrote statusLine in ${target} (--force).` };
+}
+function skipped(path) {
+  return {
+    kind: "skipped",
+    path,
+    detail: "--skip-statusline set; no changes to statusline target."
+  };
+}
+function writeExec(target, body) {
+  mkdirSync(dirname(target), { recursive: true });
+  const tmp = `${target}.tmp-${process.pid}-${Date.now()}`;
+  writeFileSync(tmp, body, { mode: 493 });
+  renameSync(tmp, target);
+  chmodSync(target, 493);
+}
+function readSettings(target) {
+  if (!existsSync(target)) return {};
+  const raw = readFileSync(target, "utf8");
+  if (raw.trim() === "") return {};
+  try {
+    const parsed = JSON.parse(raw);
+    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+      return parsed;
+    }
+    return {};
+  } catch {
+    return {};
+  }
+}
+function writeSettings(target, next) {
+  mkdirSync(dirname(target), { recursive: true });
+  const tmp = `${target}.tmp-${process.pid}-${Date.now()}`;
+  writeFileSync(tmp, `${JSON.stringify(next, null, 2)}
+`, { mode: 420 });
+  renameSync(tmp, target);
+}
+function matchesDesired(current) {
+  if (!current || typeof current !== "object" || Array.isArray(current)) return false;
+  const c = current;
+  return c.type === STATUSLINE_FIELD.type && c.command === STATUSLINE_FIELD.command;
+}
 const FAMILIES = [
   "skills",
   "rules",
@@ -939,6 +1088,16 @@ function runInit(argv) {
       args.allowRoot,
       say
     );
+    const dryRunSettingsPreserved = !(args.force || upgradeApproved) && existsSync(join(targetDir, ".claude", "settings.json"));
+    maybeEmitStatuslinePlan({
+      dryRun: true,
+      force: args.force || upgradeApproved,
+      skip: args.skipStatusline,
+      allowRoot: args.allowRoot,
+      targetDir,
+      say,
+      settingsPreserved: dryRunSettingsPreserved
+    });
     if (args.json) {
       const report = buildInitReport({
         entries: outcome.result?.wouldCopyEntries ?? [],
@@ -958,7 +1117,7 @@ function runInit(argv) {
     }
     return outcome.code;
   }
-  return runReal$1(plans, args.force || upgradeApproved, args.verbose, targetDir, args.allowRoot, args.json, say);
+  return runReal$1(plans, args.force || upgradeApproved, args.verbose, targetDir, args.allowRoot, args.json, args.skipStatusline, say);
 }
 function maybeEmitUpgradeAdvisory(targetDir, yes, json) {
   const prompt = json ? (t) => {
@@ -1181,7 +1340,7 @@ function runDryRun$1(plans, say) {
   }
   return 0;
 }
-function runReal$1(plans, force, verbose, targetDir, allowRoot, json, say) {
+function runReal$1(plans, force, verbose, targetDir, allowRoot, json, skipStatusline, say) {
   const results = [];
   let anyRefused = false;
   let anyError = false;
@@ -1284,6 +1443,20 @@ function runReal$1(plans, force, verbose, targetDir, allowRoot, json, say) {
 `
     );
   }
+  const settingsRefused = (walker.result?.refused ?? []).some((r) => {
+    const p = typeof r === "string" ? r : r.path;
+    if (typeof p !== "string") return false;
+    return p === join(".claude", "settings.json") || p === ".claude/settings.json" || p.endsWith("/.claude/settings.json");
+  });
+  maybeEmitStatuslinePlan({
+    dryRun: false,
+    force,
+    skip: skipStatusline,
+    allowRoot,
+    targetDir,
+    say,
+    settingsPreserved: settingsRefused
+  });
   if (json) {
     renderJsonReport(report, (t) => {
       process.stdout.write(t);
@@ -1417,6 +1590,67 @@ function readDeclaredCommandLeaves(settingsPath) {
     return /* @__PURE__ */ new Set();
   }
 }
+function maybeEmitStatuslinePlan(opts) {
+  const packageDir = dirname(dirname(resolveBundleRoot(void 0)));
+  const dispatcherSource = join(
+    packageDir,
+    "dist",
+    "lite",
+    "presence",
+    "cli",
+    "bassclef-statusline.dispatcher.sh"
+  );
+  if (!existsSync(dispatcherSource)) {
+    return;
+  }
+  let home;
+  try {
+    home = resolveHome({ allowRoot: opts.allowRoot });
+  } catch {
+    return;
+  }
+  let report;
+  try {
+    report = installStatusline({
+      home,
+      projectDir: opts.targetDir,
+      packageDir,
+      force: opts.force,
+      dryRun: opts.dryRun,
+      skip: opts.skip,
+      settingsPreserved: opts.settingsPreserved
+    });
+  } catch {
+    return;
+  }
+  const dv = report.dispatcher.kind;
+  const sv = report.settings.kind;
+  if (dv === "skipped" && sv === "skipped") {
+    opts.say(`bassclef init: statusline install skipped (--skip-statusline).
+`);
+    return;
+  }
+  if (opts.dryRun) {
+    opts.say(
+      `bassclef init: would install statusline dispatcher at ${report.dispatcher.path} and set statusLine in ${report.settings.path}.
+`
+    );
+    return;
+  }
+  const parts = [];
+  if (dv === "installed") parts.push(`wrote ${report.dispatcher.path}`);
+  else if (dv === "replaced") parts.push(`replaced ${report.dispatcher.path} (--force)`);
+  else if (dv === "preserved") parts.push(`preserved ${report.dispatcher.path} (pass --force to overwrite)`);
+  else if (dv === "unchanged") parts.push(`${report.dispatcher.path} already matches bundle`);
+  if (sv === "installed") parts.push(`set statusLine in ${report.settings.path}`);
+  else if (sv === "replaced") parts.push(`replaced statusLine in ${report.settings.path} (--force)`);
+  else if (sv === "preserved") parts.push(`preserved statusLine in ${report.settings.path} (pass --force to overwrite)`);
+  else if (sv === "unchanged") parts.push(`statusLine in ${report.settings.path} already matches`);
+  if (parts.length > 0) {
+    opts.say(`bassclef init: statusline — ${parts.join("; ")}.
+`);
+  }
+}
 const DEFAULTS$1 = {
   force: false,
   replaceEdits: false,

package/dist/index.cjs

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

package/dist/index.d.ts

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

package/dist/index.js

@@ -1,4 +1,4 @@
-const version = "1.4.1";
+const version = "1.6.0";
 export {
   version
 };

package/dist/lite/.claude/hooks/pre-commit-manifest-autoregen.sh

@@ -80,7 +80,14 @@ LITE_STAGED=0
 while IFS= read -r file; do
   [ -z "$file" ] && continue
 
-  # Quick path-class filter (avoids frontmatter reads for obviously non-lite files)
+  # Quick path-class filter (avoids frontmatter reads for obviously non-lite files).
+  # Covers all 11 manifest types per bassclef-upstream#1872 widen (2026-09-21):
+  #   skills, rules, hooks, luminaries, agents, standards, ADRs,
+  #   lib, scripts, templates, presence-templates, root-docs.
+  # Note: bash case-pattern `*` matches slashes, so `.claude/hooks/*.sh` already
+  # covers subdirs like `.claude/hooks/session-reflection.d/foo.sh`. Same for
+  # `standards/*.md`. No separate subdir patterns needed.
+  # Sister refactor to path-agnostic marker check tracked at #1873.
   case "$file" in
     .claude/skills/*/SKILL.md \
     | .claude/rules/*.md \
@@ -88,8 +95,21 @@ while IFS= read -r file; do
     | .claude/luminaries/*.md \
     | .claude/agents/*.md \
     | standards/*.md \
-    | architecture/decisions/ADR-*.md)
-      # Path class matches; check frontmatter for tier: lite
+    | architecture/decisions/ADR-*.md \
+    | lib/*.sh \
+    | scripts/*.sh \
+    | templates/*.md \
+    | presence/install/*.sh \
+    | presence/install/*.md \
+    | presence/install/*.jsonc \
+    | AGENTS.md \
+    | README.md \
+    | CLAUDE-lite.md \
+    | CODE_OF_CONDUCT.md \
+    | CONTRIBUTING.md \
+    | SECURITY.md \
+    | .claude/bassclef-orientation.md)
+      # Path class matches; check frontmatter for tier: lite (markdown YAML)
       if [ -f "$REPO_ROOT/$file" ] && head -20 "$REPO_ROOT/$file" 2>/dev/null | grep -q '^tier: lite'; then
         LITE_STAGED=1
         break
@@ -99,6 +119,11 @@ while IFS= read -r file; do
         LITE_STAGED=1
         break
       fi
+      # JSON root-key shape for .jsonc / .json files: `"tier": "lite"` — #1872 addition
+      if [ -f "$REPO_ROOT/$file" ] && head -3 "$REPO_ROOT/$file" 2>/dev/null | grep -q '"tier": "lite"'; then
+        LITE_STAGED=1
+        break
+      fi
       ;;
   esac
 done <<< "$STAGED"

package/dist/lite/.claude/settings.json

@@ -228,5 +228,9 @@
     "$HOME/src/sunj-labs/bassclef/.claude/luminaries",
     "$HOME/src/sunj-labs/bassclef/.claude/agents"
   ],
-  "$schema": "https://bassclef.sunj-labs/state-spine/v0/schemas/bassclef-wiring-manifest.schema.json"
+  "$schema": "https://bassclef.sunj-labs/state-spine/v0/schemas/bassclef-wiring-manifest.schema.json",
+  "statusLine": {
+    "type": "command",
+    "command": "bash ~/.claude/bassclef-statusline.sh"
+  }
 }

package/dist/lite/bassclef-version.json

@@ -0,0 +1,7 @@
+{
+  "version": "v1.1.0",
+  "marker_tag": "release-2026-09-21-0e54fa7c",
+  "release_date": "2026-09-21T22:20:31Z",
+  "release_sha": "0e54fa7c",
+  "release_tag": "release-2026-09-21-0e54fa7c"
+}

package/dist/lite/lib/mechanism-fidelity.sh

@@ -444,6 +444,20 @@ _classify_via_patterns_json() {
           fi
         fi
         ;;
+      basename_in_file)
+        # bassclef-upstream#1867 — match when hook basename appears as
+        # a whole line in the file at $arg. Missing file falls through
+        # (fail-safe default per @luminary michael-nygard). Comments
+        # (lines starting with #) and blank lines never equal a valid
+        # .sh basename, so -qxF is safe without pre-filtering.
+        local list_file="$project_root/$arg"
+        if [ -f "$list_file" ]; then
+          if grep -qxF "$hook_name" "$list_file" 2>/dev/null; then
+            echo "$name"
+            return 0
+          fi
+        fi
+        ;;
       default)
         echo "$name"
         return 0
@@ -455,6 +469,29 @@ _classify_via_patterns_json() {
   return 1
 }
 
+# === _install_pattern_classification (private helper for Layer 2) ===
+# Reads classification_when_unwired for a given pattern name from the JSON.
+# Returns 0 + emits label on success; returns 1 if pattern missing or JSON
+# not available. Enables Parnas info-hiding — each label lives as a
+# grep-discoverable string in standards/hook-invocation-patterns.json
+# instead of being algorithmically derived at runtime.
+# Per bassclef-upstream#1880 — closes the doc-code drift class.
+_install_pattern_classification() {
+  local candidate="${1:-}"
+  [ -z "$candidate" ] && return 1
+  local project_root="${CLAUDE_PROJECT_DIR:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)}"
+  local patterns_json="$project_root/standards/hook-invocation-patterns.json"
+  [ -f "$patterns_json" ] || return 1
+  command -v jq >/dev/null 2>&1 || return 1
+  local label
+  label=$(jq -r --arg n "$candidate" '.patterns[] | select(.name == $n) | .classification_when_unwired' "$patterns_json" 2>/dev/null)
+  if [ -n "$label" ] && [ "$label" != "null" ]; then
+    echo "$label"
+    return 0
+  fi
+  return 1
+}
+
 # === _install_pattern_is_valid (private helper for Layer 2) ===
 # Returns 0 if pattern is in the JSON pattern list OR in the hardcoded
 # fallback list (ci|launchd|lib|release|standard). Returns 1 otherwise.
@@ -542,10 +579,17 @@ classify_finding() {
     # Hook lives on disk but settings.json wiring absent.
     # If the hook is meant to live elsewhere (CI / launchd / sourced lib),
     # this is by design, not a failure.
-    # Layer 2 (bassclef-upstream#1163) — algorithmic label derivation:
-    # "standard" → DEAD-LETTER; anything else → NOT-WIRED-BY-DESIGN-<UPPER>.
-    # New patterns land in standards/hook-invocation-patterns.json; their
-    # classification label flows through this branch without cascade edits.
+    # Layer 2 + bassclef-upstream#1880 — read classification_when_unwired
+    # from JSON so each label lives as a grep-discoverable string in
+    # standards/hook-invocation-patterns.json. Falls back to algorithmic
+    # derivation if JSON missing (defensive per @luminary michael-nygard).
+    local label
+    label=$(_install_pattern_classification "$install_pattern" 2>/dev/null)
+    if [ -n "$label" ]; then
+      echo "$label"
+      return 0
+    fi
+    # Fallback — hardcoded/algorithmic derivation when JSON unavailable
     if [ "$install_pattern" = "standard" ]; then
       echo "DEAD-LETTER"
       return 0

package/dist/lite/lib/source-graph-walker.sh

@@ -58,14 +58,41 @@ _sgw_init_cache() {
 # Extract every .sh literal ref from a shell file — the walker's resolve
 # step filters to only paths that map to real files, so false-positive
 # extractions are cheap.
+#
+# Post-filter (#1889): reject refs containing regex metacharacters —
+# [^, \., .*, .+ — which appear when hooks grep for `.sh` patterns in
+# other files. The suffix-fallback in _sgw_resolve_ref_in_repo would
+# otherwise map these to phantom paths (e.g., `/[^/]+\.sh` resolves
+# to a real hook via suffix extraction).
+#
+# NOT tightened to invocation-only extraction (`source X`/`bash X`)
+# because many hooks assign paths to vars first, then invoke via the
+# var later — `X_PATH="path/to/x.sh"; source "$X_PATH"`. The extractor
+# would miss X_PATH's target line and the resolver could not follow.
+# See docs/risk-ledgers/2026-09-21-source-graph-walker-tighten.md
+# for the design decision to keep raw extraction + post-filter.
+#
+# Env-var escape: BASSCLEF_SGW_REGEX_FILTER=0 restores prior extractor
+# behavior (no post-filter). For rescue when a real path contains a
+# regex metacharacter (rare — paths never contain [^, \., .*, .+ in
+# bassclef substrate).
 _sgw_extract_all_refs() {
   local file="$1"
+  local raw
 
   # 1. Every .sh literal in the file (quoted or path-shaped), from non-comment lines
-  grep -vE '^[[:space:]]*#' "$file" 2>/dev/null | \
+  raw=$(grep -vE '^[[:space:]]*#' "$file" 2>/dev/null | \
     grep -oE '"[^"]+\.sh"|'"'"'[^'"'"']+\.sh'"'"'|\$\{[^}]+\}/[^"'"'"'[:space:]]+\.sh|[$][A-Za-z_][A-Za-z0-9_]*/[^"'"'"'[:space:]]+\.sh|(\./|\.\./|/)[^"'"'"'[:space:]$]+\.sh' 2>/dev/null | \
     tr -d '"'"'"'"' | \
-    sort -u
+    sort -u)
+
+  # Post-filter (#1889) — drop refs with regex metacharacters.
+  # Escape via BASSCLEF_SGW_REGEX_FILTER=0.
+  if [ "${BASSCLEF_SGW_REGEX_FILTER:-1}" = "1" ] && [ -n "$raw" ]; then
+    echo "$raw" | grep -vE '\[\^|\\\.|\.\*|\.\+' 2>/dev/null || true
+  else
+    echo "$raw"
+  fi
 
   # 2. Glob-source patterns — for loops iterating dir/*.sh
   grep -oE 'for[[:space:]]+[[:alnum:]_]+[[:space:]]+in[[:space:]]+[^;$]+/\*\.sh' "$file" 2>/dev/null | \

package/dist/lite/presence/cli/bassclef-statusline.dispatcher.sh

@@ -0,0 +1,78 @@
+#!/usr/bin/env bash
+# tier: standard
+# BASSCLEF_SYNC_VERSION=thin-pointer-statusline-2026-06-22
+# ^^ DO NOT REMOVE — used by Surface 4 self-heal (migrate-adopter-references.sh)
+#    + bassclef-side drift check. Format: thin-pointer-statusline-YYYY-MM-DD.
+#
+# Thin-pointer bassclef statusline dispatcher.
+#
+# Source of truth for adopters' user-level statusline. Adopters install
+# THIS file at ~/.claude/bassclef-statusline.sh; it finds bassclef's
+# rich impl via sibling fast-path and exec's it on every tick. Substrate
+# updates to the rich impl reach existing adopters because the pointer
+# runs the live file, not a frozen copy.
+#
+# Three paths, tried in order (per #1860):
+#
+#   1. Sibling fast-path: $HOME/src/sunj-labs/bassclef OR /bassclef-upstream
+#      — if presence/cli/bassclef-statusline.sh exists and is executable,
+#        exec it with stdin piped through.
+#
+#   2. Script-relative: same directory as this dispatcher. Serves adopters
+#      who install only @thebassclef/lite via npm — the tarball ships both
+#      scripts side by side under node_modules/@thebassclef/lite/dist/lite/
+#      presence/cli/. Uses `cd $(dirname); pwd` for macOS + Linux portability
+#      (BSD readlink lacks -f per R15 rfc finding).
+#
+#   3. Fallback: minimal render so SessionStart doesn't crash. Adopter
+#      sees "bassclef · ?" instead of an empty statusline.
+#
+# Always exits 0 — same SessionStart-safe discipline as bassclef-sync
+# dispatcher (per ADR-032).
+#
+# Versioning:
+#   thin-pointer-statusline-2026-06-22 — initial. Bump format when the
+#     dispatcher's contract changes (rare; ideally never).
+#
+# Primary lens: Linus — substrate carries the recovery cost. Adopters
+# don't re-install when the rich impl evolves; the dispatcher's
+# stability is what shields them.
+#
+# Anchor: Hyrum — the version string IS the observable surface adopters
+# can grep to detect drift. Surface 4 self-heal in
+# migrate-adopter-references.sh uses it.
+
+set -u
+
+__bassclef_statusline_version() {
+  echo "thin-pointer-statusline-2026-06-22"
+}
+
+# Read all of stdin so we can pipe it through to the rich impl
+INPUT=$(cat 2>/dev/null || echo "{}")
+
+# Resolve this dispatcher's directory for the script-relative fallback.
+# `cd $(dirname); pwd` is portable across macOS (BSD readlink lacks -f) and
+# Linux (GNU readlink -f works but we don't need it).
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Find rich impl via sibling fast-path, then script-relative fallback
+RICH_IMPL=""
+for CANDIDATE in \
+    "$HOME/src/sunj-labs/bassclef/presence/cli/bassclef-statusline.sh" \
+    "$HOME/src/sunj-labs/bassclef-upstream/presence/cli/bassclef-statusline.sh" \
+    "$SCRIPT_DIR/bassclef-statusline.sh"; do
+  if [ -x "$CANDIDATE" ]; then
+    RICH_IMPL="$CANDIDATE"
+    break
+  fi
+done
+
+if [ -n "$RICH_IMPL" ]; then
+  echo "$INPUT" | bash "$RICH_IMPL"
+  exit 0
+fi
+
+# Fallback — minimal render when no sibling is available
+echo "bassclef · ?"
+exit 0

package/dist/lite/presence/cli/bassclef-statusline.sh

@@ -0,0 +1,78 @@
+#!/usr/bin/env bash
+# tier: standard
+# bassclef — Claude Code status line.
+# Claude Code pipes session JSON on stdin every tick; whatever we print to stdout
+# becomes the status line (ANSI colors allowed). Requires accepting the workspace
+# trust prompt, same as any shell-executing setting. Keep it ONE short line.
+#
+# Register it in ~/.claude/settings.json — see bassclef-settings.snippet.json.
+# Test:  echo '{"model":{"display_name":"Opus"},"workspace":{"current_dir":"/x/bassline"},"context_window":{"used_percentage":23}}' | bash bassclef-statusline.sh
+
+# Script-relative dir for tarball-layout fallback (#1860). Portable across
+# macOS + Linux — `cd $(dirname); pwd` avoids BSD readlink -f gap. Python
+# picks this up via os.environ; we cannot use __file__ under python3 -c.
+BASSCLEF_STATUSLINE_SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+export BASSCLEF_STATUSLINE_SCRIPT_DIR
+
+python3 -c '
+import sys, json, os
+try:
+    d = json.load(sys.stdin)
+except Exception:
+    d = {}
+model = d.get("model", {}).get("display_name", "?")
+cwd   = d.get("workspace", {}).get("current_dir") or d.get("cwd", "")
+base  = os.path.basename(cwd.rstrip("/")) or "~"
+pct   = d.get("context_window", {}).get("used_percentage")
+
+# Bassclef version segment (bet 2026-07-09d WU-1 / sunj-labs/bassclef-upstream#686).
+# Reads bassclef-version.json. Fallback chain: env var, workspace root,
+# peer sibling ../bassclef/. Prefers .version, falls back to .release_tag.
+# Silent on any failure.
+def read_bassclef_version(cwd):
+    def try_file(path):
+        if not path or not os.path.isfile(path):
+            return None
+        try:
+            with open(path) as f:
+                data = json.load(f)
+        except Exception:
+            return None
+        v = data.get("version") or data.get("release_tag")
+        return v if v else None
+    candidates = []
+    env_path = os.environ.get("BASSCLEF_VERSION_FILE")
+    if env_path:
+        candidates.append(env_path)
+    if cwd:
+        candidates.append(os.path.join(cwd, "bassclef-version.json"))
+        candidates.append(os.path.join(cwd, "..", "bassclef", "bassclef-version.json"))
+    # Script-relative tarball-layout fallback (#1860). Adopters installing
+    # only @thebassclef/lite via npm land under node_modules/@thebassclef/
+    # lite/dist/lite/presence/cli/, with bassclef-version.json two dirs up
+    # at dist/lite/bassclef-version.json. Runs LAST — cwd + peer sibling
+    # still win for adopters with a cloned repo (order per R16 rfc finding).
+    script_dir = os.environ.get("BASSCLEF_STATUSLINE_SCRIPT_DIR")
+    if script_dir:
+        candidates.append(os.path.join(script_dir, "..", "..", "bassclef-version.json"))
+    for p in candidates:
+        v = try_file(p)
+        if v:
+            return v
+    return None
+
+version = read_bassclef_version(cwd)
+
+O = "\033[38;2;232;93;4m"   # burnt orange
+C = "\033[38;2;205;201;189m"# cream
+D = "\033[2m"               # dim
+R = "\033[0m"
+sep = " " + D + "\u00b7" + R + " "       # dim middot
+
+seg = [O + "\U0001D122 bassclef.dev" + R, C + model + R, D + base + R]
+if version:
+    seg.append(D + version + R)
+if pct is not None:
+    seg.append(D + str(pct) + "%" + R)
+sys.stdout.write(sep.join(seg))
+'

package/dist/lite/standards/lite-manifest.json

@@ -1,7 +1,7 @@
 {
   "tier": "lite",
-  "manifest_version": "1.9.1",
-  "generated_at": "2026-09-21T00:38:33Z",
+  "manifest_version": "1.9.6",
+  "generated_at": "2026-09-21T21:28:13Z",
   "entries": [
     {
       "slug": "029-release-pipeline",
@@ -544,7 +544,7 @@
       "type": "hook",
       "path": ".claude/hooks/pre-commit-manifest-autoregen.sh",
       "tier": "lite",
-      "content_hash": "sha256:34dc76e61307d79da11bb38460823a8945a144f322ea2cf74b0cbfac75118ec2",
+      "content_hash": "sha256:b3641c5c2402fdedb9fb23b812548e94809dcc732e8d5e19af4fd5b488b023e0",
       "description": "PreToolUse: Bash"
     },
     {
@@ -824,7 +824,7 @@
       "type": "lib",
       "path": "lib/mechanism-fidelity.sh",
       "tier": "lite",
-      "content_hash": "sha256:7ccd6751d3ff3c31b142aac3c1739cd1cb1863f5e13db29ce1eb8206def1b7ca",
+      "content_hash": "sha256:8afeac2e42bd7fb281cda9be94395e272092857f8a8e431350b8c8673578bcf5",
       "description": "lib/mechanism-fidelity.sh — shared scanner for the mechanism-fidelity"
     },
     {
@@ -880,7 +880,7 @@
       "type": "lib",
       "path": "lib/source-graph-walker.sh",
       "tier": "lite",
-      "content_hash": "sha256:abae8c156ac538321b90326946eade3b70068ee1d4bd8ad605fdb374849400ba",
+      "content_hash": "sha256:350a3356243a2e7943e9f02d9272db58488ee72abac515e56c7690d665b1a0fd",
       "description": "lib/source-graph-walker.sh — walks source-graph closure from a seed hook"
     },
     {
@@ -3761,7 +3761,7 @@
       "type": "standard",
       "path": "standards/mechanism-fidelity.md",
       "tier": "lite",
-      "content_hash": "sha256:b212287354832a3613bf9bcdae7da6071df64d8c08f227e8d4233666ccea4d55",
+      "content_hash": "sha256:e0b14abf4a0331c96c488d52c6e3067f827b6ef4d506c19c83616184c53c3642",
       "description": "- ADR-035 — names the substrate-as-system foundational tenet that this standard's audit method verifies - architecture/audits/2026-06-24-closeout.md — bet 24c architect-review that missed this class; this standard's audit fills the lens-gap and…"
     },
     {
@@ -4025,7 +4025,7 @@
       "type": "standard",
       "path": "standards/substrate-config-schema.md",
       "tier": "lite",
-      "content_hash": "sha256:94931a2f1f0e08f4381ddbc464ecd1578170f832a41d263a42f67ac0dfafee48",
+      "content_hash": "sha256:dff6bec2527dfa1cb899fd907b4f802bd4ce7a1e4bb9621bdf3cdfcc05601804",
       "description": "substrate.config.md is the single source of truth for external resource references in any bassclef-substrate repo."
     },
     {

package/dist/lite/standards/mechanism-fidelity.md

@@ -67,6 +67,7 @@ The class fires when one or more of these hold:
 | `NOT-WIRED-BY-DESIGN-CI` | Hook lives on disk and is referenced from `.github/workflows/*.yml`; settings.json is not the right home for it | `pr-body-scrub-check.sh`, `pr-body-loop-discipline-check.sh` |
 | `NOT-WIRED-BY-DESIGN-LAUNCHD` | Hook is scheduled by macOS launchd (or cron); header comment names the scheduler; settings.json is not the right home | `auto-save-idle.sh` |
 | `NOT-WIRED-BY-DESIGN-LIB` | File is sourced by other hooks (library role); header comment says "sourced by"; settings.json is not the right home | `trace-helper.sh` |
+| `NOT-WIRED-BY-DESIGN-EXCLUSIONS` | Hook basename is listed in `presence/install/template-hook-exclusions.txt`; wired in bassclef-upstream settings.json but intentionally absent from the adopter-shipped template (bassclef-team-only or upstream-only substrate) | `lite-skill-key-gate-check.sh`, `user-global-hook-ref-guard-check.sh` |
 | `CLEAN` | All chain steps pass | most existing rules (audit will surface count) |
 
 ## The 5-step verification chain

package/dist/lite/standards/substrate-config-schema.md

@@ -83,7 +83,7 @@ uncommented defaults shown.
 # === Artifacts ===
 journal_doc_id: [per-repo draft Google Doc — pushes from /journal + session-end]
 changelog_doc_id: [per-repo weekly changelog Google Doc — pushes from /release-notes]
-brand_corpus_doc_id: [cross-repo brand team corpus — pushes from /journal-export]
+brand_corpus_doc_id: [cross-repo brand team corpus — pushes from an operator export skill]
 
 # === Environments ===
 deploy_targets:
@@ -213,7 +213,7 @@ reference the raw ID directly.
 
 ### Anti-pattern 2: hardcoded IDs in skills
 
-**Before** (in `.claude/skills/journal-export/SKILL.md`):
+**Before** (in a skill body):
 ```bash
 npx tsx scripts/push-to-gdoc.ts \
   --file docs/journal-corpus/corpus.md \

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thebassclef/lite",
-  "version": "1.4.1",
+  "version": "1.6.0",
   "description": "Bassclef CLI — install and upgrade bassclef in your project with two commands.",
   "keywords": [
     "bassclef",
@@ -65,7 +65,8 @@
     "typecheck": "tsc --noEmit",
     "bump": "node scripts/bump-version.mjs",
     "harness:npm-install": "vitest run --config vitest.harness.config.ts",
-    "prepublishOnly": "node scripts/prepublish-bundle-substrate.mjs"
+    "prepublishOnly": "node scripts/prepublish-bundle-substrate.mjs",
+    "install-hooks": "node scripts/install-git-hooks.mjs"
   },
   "devDependencies": {
     "@types/node": "^20.14.0",