@thebassclef/lite 1.9.0 → 1.9.2

package/dist/lite/.claude/hooks/session-reflection.d/tests/01-adopter-message-channel.test.sh

@@ -0,0 +1,168 @@
+#!/bin/bash
+# tier: upstream
+# fixtures: mock-git-repos-inline
+# Tier 0 test for adopter message channel (bassclef-upstream#1926).
+#
+# Per @luminary alan-cooper Sam+Louis persona + @luminary donald-norman signifier
+# + @luminary linus-torvalds adopter contract.
+#
+# Source under test: .claude/hooks/session-reflection.d/01-adopter-message-channel.sh
+#
+# test-list (per .claude/rules/test-list-discipline.md — RED first, GREEN as they land):
+#
+# Fragment exists + executable
+# [ ] T00: fragment exists at expected path and is executable
+#
+# Fresh install gate — all 3 files absent → banner fires
+# [ ] T01: fresh install (no whereami, no substrate.config, no .claude/settings) → welcome text
+#
+# Onboarded gate — any of the 3 files present → silent
+# [ ] T02: whereami.md present → silent
+# [ ] T03: substrate.config.md present → silent
+# [ ] T04: .claude/settings.json present → silent
+# [ ] T08: bassclef itself (all 3 files present) → silent (Torvalds T1 fold)
+#
+# Override
+# [ ] T05: SKIP_ADOPTER_MESSAGES=1 → silent (bypass on fresh install)
+#
+# Message body (Cooper C2 fold)
+# [ ] T06: welcome text contains "Welcome to bassclef"
+# [ ] T07: welcome text contains "/onboard-repo"
+
+set -u
+
+REPO_ROOT="$(cd "$(dirname "$0")/../../../.." && pwd)"
+HOOK="${REPO_ROOT}/.claude/hooks/session-reflection.d/01-adopter-message-channel.sh"
+PASS=0
+FAIL=0
+FAILED_TESTS=()
+
+assert() {
+  local name="$1"
+  local ok="$2"
+  local why="$3"
+  if [ "$ok" = "1" ]; then
+    PASS=$((PASS + 1))
+    echo "  PASS: $name"
+  else
+    FAIL=$((FAIL + 1))
+    FAILED_TESTS+=("$name — $why")
+    echo "  FAIL: $name — $why"
+  fi
+}
+
+TMPROOT="$(mktemp -d -t adopter-message-channel.XXXXXX)"
+cleanup() { rm -rf "$TMPROOT"; }
+trap cleanup EXIT
+
+# --- T00: fragment exists + executable ---
+if [ -x "$HOOK" ]; then
+  assert "T00: fragment exists + executable" 1 ""
+else
+  assert "T00: fragment exists + executable" 0 "not found or not executable: $HOOK"
+  echo ""
+  echo "=== Results ==="
+  echo "PASS: $PASS"
+  echo "FAIL: $FAIL"
+  exit 1
+fi
+
+# --- Fixture builder ---
+run_hook_in() {
+  local tmpdir="$1"
+  (cd "$tmpdir" && bash "$HOOK" 2>&1)
+}
+
+# --- T01: fresh install (no state files) → welcome text ---
+SC_FRESH="$TMPROOT/fresh"
+mkdir -p "$SC_FRESH"
+OUT_T01=$(run_hook_in "$SC_FRESH")
+if echo "$OUT_T01" | grep -qE "Welcome to bassclef"; then
+  assert "T01: fresh install emits welcome text" 1 ""
+else
+  assert "T01: fresh install emits welcome text" 0 "no welcome text in: $OUT_T01"
+fi
+
+# --- T02: whereami.md present → silent ---
+SC_WHEREAMI="$TMPROOT/whereami-present"
+mkdir -p "$SC_WHEREAMI/docs"
+echo "---" > "$SC_WHEREAMI/docs/whereami.md"
+OUT_T02=$(run_hook_in "$SC_WHEREAMI")
+if [ -z "$OUT_T02" ]; then
+  assert "T02: whereami.md present → silent" 1 ""
+else
+  assert "T02: whereami.md present → silent" 0 "unexpected output: $OUT_T02"
+fi
+
+# --- T03: substrate.config.md present → silent ---
+SC_CONFIG="$TMPROOT/config-present"
+mkdir -p "$SC_CONFIG"
+echo "---" > "$SC_CONFIG/substrate.config.md"
+OUT_T03=$(run_hook_in "$SC_CONFIG")
+if [ -z "$OUT_T03" ]; then
+  assert "T03: substrate.config.md present → silent" 1 ""
+else
+  assert "T03: substrate.config.md present → silent" 0 "unexpected output: $OUT_T03"
+fi
+
+# --- T04: .claude/settings.json present → silent ---
+SC_SETTINGS="$TMPROOT/settings-present"
+mkdir -p "$SC_SETTINGS/.claude"
+echo '{}' > "$SC_SETTINGS/.claude/settings.json"
+OUT_T04=$(run_hook_in "$SC_SETTINGS")
+if [ -z "$OUT_T04" ]; then
+  assert "T04: .claude/settings.json present → silent" 1 ""
+else
+  assert "T04: .claude/settings.json present → silent" 0 "unexpected output: $OUT_T04"
+fi
+
+# --- T05: SKIP_ADOPTER_MESSAGES=1 bypass on fresh install ---
+SC_SKIP="$TMPROOT/skip"
+mkdir -p "$SC_SKIP"
+OUT_T05=$(SKIP_ADOPTER_MESSAGES=1 run_hook_in "$SC_SKIP")
+if [ -z "$OUT_T05" ] || echo "$OUT_T05" | grep -qE "SKIP_ADOPTER_MESSAGES"; then
+  assert "T05: SKIP_ADOPTER_MESSAGES=1 bypasses" 1 ""
+else
+  assert "T05: SKIP_ADOPTER_MESSAGES=1 bypasses" 0 "banner fired: $OUT_T05"
+fi
+
+# --- T06: welcome text contains "Welcome to bassclef" ---
+if echo "$OUT_T01" | grep -qE "Welcome to bassclef"; then
+  assert "T06: welcome contains 'Welcome to bassclef'" 1 ""
+else
+  assert "T06: welcome contains 'Welcome to bassclef'" 0 "missing in: $OUT_T01"
+fi
+
+# --- T07: welcome text contains "/onboard-repo" ---
+if echo "$OUT_T01" | grep -qE "/onboard-repo"; then
+  assert "T07: welcome contains '/onboard-repo'" 1 ""
+else
+  assert "T07: welcome contains '/onboard-repo'" 0 "missing in: $OUT_T01"
+fi
+
+# --- T08: bassclef itself (all 3 files present) → silent ---
+SC_BASSCLEF="$TMPROOT/bassclef"
+mkdir -p "$SC_BASSCLEF/docs" "$SC_BASSCLEF/.claude"
+echo "---" > "$SC_BASSCLEF/docs/whereami.md"
+echo "---" > "$SC_BASSCLEF/substrate.config.md"
+echo '{}' > "$SC_BASSCLEF/.claude/settings.json"
+OUT_T08=$(run_hook_in "$SC_BASSCLEF")
+if [ -z "$OUT_T08" ]; then
+  assert "T08: bassclef itself (all 3 present) → silent" 1 ""
+else
+  assert "T08: bassclef itself (all 3 present) → silent" 0 "unexpected: $OUT_T08"
+fi
+
+# --- Summary ---
+echo ""
+echo "=== Results ==="
+echo "PASS: $PASS"
+echo "FAIL: $FAIL"
+if [ "$FAIL" -gt 0 ]; then
+  echo ""
+  echo "Failed tests:"
+  for t in "${FAILED_TESTS[@]}"; do
+    echo "  - $t"
+  done
+  exit 1
+fi

package/dist/lite/bassclef-version.json

@@ -1,7 +1,7 @@
 {
-  "version": "v1.4.0",
-  "marker_tag": "release-2026-09-24-f36b8f31",
-  "release_date": "2026-09-24T01:12:22Z",
-  "release_sha": "f36b8f31",
-  "release_tag": "release-2026-09-24-f36b8f31"
+  "version": "v1.5.2",
+  "marker_tag": "release-2026-09-24-4dc71e87",
+  "release_date": "2026-09-24T21:29:57Z",
+  "release_sha": "4dc71e87",
+  "release_tag": "release-2026-09-24-4dc71e87"
 }

package/dist/lite/presence/install/bassclef-sync.template.sh

@@ -564,25 +564,40 @@ if [ "$FETCH_DONE" = "0" ]; then
     SYNC_STATUS="freshly cloned"
     FETCH_DONE=1
   else
-    # Banner cure per sunj-labs/bassclef-upstream#1636 — friendly framing paired
-    # with the bassclef-upstream copy at `.claude/hooks/bassclef-sync.sh` L112-117.
-    # Bootstrap pair per `.claude/rules/bootstrap-pair-discipline.md`. Diagnostic
-    # paths list retained (richer than the hook copy because template supports
-    # strategies A/B/D as well as C).
-    echo "### Bassclef sync — full-tier not synced"
-    echo ""
-    echo "Optional: set up GitHub auth to sync the full bassclef substrate."
-    echo "Lite tier works without it — your session is fine."
-    echo "Skills / rules / agents beyond lite become available once sync succeeds."
-    echo ""
-    echo "Paths attempted:"
-    echo "  - peer (\$CWD/../bassclef): not present"
-    if [ "$IS_EPHEMERAL" = "1" ]; then
-      echo "  - HTTP API (.bassclef-source.json): $([ -f "$CWD/.bassclef-source.json" ] && echo "file present but Strategy D fell through (see [bassclef-sync] stderr lines above for reason)" || echo "file missing; run /onboard-repo to write one, or set up .bassclef-url as fallback")"
-      echo "  - S3 (.bassclef-url): $([ -f "$CWD/.bassclef-url" ] && echo "file present but Strategy B fell through" || echo "file missing; run bassclef-s3-publish workflow or merge pending sync PR")"
-    fi
-    echo "  - bash clone: failed (private repo, no credentials)"
-    echo ""
+    # v1.5.1 refactor (bassclef-upstream#1935 epic + peer bassclef-cli-aa diagnostic on
+    # @thebassclef/lite@1.9.0 2026-09-24): the pre-v1.5.1 stdout banner ("### Bassclef sync
+    # — full-tier not synced" + Optional-auth prose + Paths attempted list) was fired on
+    # every cold-adopter SessionStart. Norman lens (adversarial RFC 2026-09-24): a loud
+    # banner on a working state trains adopters to ignore banners.
+    #
+    # New shape per operator direction 2026-09-24:
+    #   stdout — one-line RESTORED acknowledgment + JSON contract (peer #1510 harness reads)
+    #   stderr — [bassclef-sync] diagnostic lines (advanced adopters + operator trace)
+    #
+    # Cures the #1929 tail defect (postcondition emit unreachable on this branch — see
+    # peer's docker-smoke against v1.9.0) in the same edit.
+    {
+      echo "[bassclef-sync] Strategy A (peer $CWD/../bassclef): not present"
+      if [ "$IS_EPHEMERAL" = "1" ]; then
+        if [ -f "$CWD/.bassclef-source.json" ]; then
+          echo "[bassclef-sync] Strategy D (.bassclef-source.json): config present but fetch fell through (see prior [bassclef-sync] stderr lines)"
+        else
+          echo "[bassclef-sync] Strategy D (.bassclef-source.json): config missing"
+        fi
+        if [ -f "$CWD/.bassclef-url" ]; then
+          echo "[bassclef-sync] Strategy B (.bassclef-url): URL file present but fetch fell through"
+        else
+          echo "[bassclef-sync] Strategy B (.bassclef-url): URL file missing"
+        fi
+      fi
+      echo "[bassclef-sync] Strategy C (git clone $BASSCLEF_REPO): failed (no network, no git, or auth required)"
+    } >&2
+
+    _clone_fail_hook_count=$(find "$CWD/.claude/hooks" -maxdepth 1 -name '*.sh' 2>/dev/null | wc -l | tr -d ' ')
+    echo "bassclef-sync: RESTORED — lite bundle in place."
+    printf 'bassclef-sync: {"status":"complete","installed":%d}\n' "$_clone_fail_hook_count"
+    unset _clone_fail_hook_count
+
     exit 0
   fi
 fi

package/dist/lite/standards/lite-manifest-schema-changes.md

@@ -34,6 +34,15 @@ Every entry stays in this file for the life of the manifest. Never pruned. When
 
 ## Entries (newest first)
 
+### Track 1 v1.5.1 — bassclef-sync clone-fail postcondition emit + banner-to-stderr (v1.11.0 → v1.11.1, 2026-09-24)
+
+- **Change type:** content-change (1 file: `bassclef-sync-template`)
+- **Fields:** 434 entries (unchanged from v1.11.0). Content hash shifts on the `bassclef-sync-template` slug — `presence/install/bassclef-sync.template.sh` gains a postcondition emit block before the L586 clone-fail exit, plus moves the prior multi-line stdout banner to stderr with `[bassclef-sync]` prefix.
+- **Version bump:** v1.11.0 → v1.11.1 (content_hash change only → patch bump per policy).
+- **Rationale:** #1929 tail cure — postcondition emit was unreachable on the clone-fail branch (peer bassclef-cli-aa docker-smoke evidence 2026-09-24 against `@thebassclef/lite@1.9.0`). See PR #1936 + `docs/theses/2026-09-24-bassclef-sync-class-cure-thesis.md` + `docs/rfcs/RFC-2026-09-24-parallel-sync-adversarial.md`.
+- **Downstream cure:** none required. Adopters see one-line `bassclef-sync: RESTORED — lite bundle in place.` on stdout on cold-adopter runs (was multi-line "### Bassclef sync — full-tier not synced" banner). Paths-attempted debug moves to stderr with `[bassclef-sync]` prefix — accessible via `2>&1`. Peer #1510 harness can now grep `RESTORED` on the cold-adopter path to verify cure landing.
+- **Old shape retired:** immediately. The pre-v1.5.1 banner had a factual error (called the public bassclef repo "private" at L584) — no adopters had a stable contract to break.
+
 ### Q1 /longrun Slice D — session-start banner-tone discipline (v1.9.10 → v1.9.11, 2026-09-22)
 
 - **Change type:** content-add (1 new standard) + content-change (session-reflection.sh + 3 fragments)

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

@@ -1,7 +1,7 @@
 {
   "tier": "lite",
-  "manifest_version": "1.11.0",
-  "generated_at": "2026-09-24T00:06:17Z",
+  "manifest_version": "1.11.1",
+  "generated_at": "2026-09-24T21:01:31Z",
   "entries": [
     {
       "slug": "029-release-pipeline",
@@ -1319,7 +1319,7 @@
       "type": "presence-template",
       "path": "presence/install/bassclef-sync.template.sh",
       "tier": "lite",
-      "content_hash": "sha256:a122102a034d07ec9a7c4b23e078707160b58aa5409a05eb6e30290fd8c27fb0",
+      "content_hash": "sha256:d79a9a6499c1bcaa368e0472f7a9cd76611f2dbdb8ab2b42533c3f85de2323c4",
       "description": "description: BASSCLEF_SYNC_VERSION=2026-09-06-1496-sessionstart-heal-v1"
     },
     {
@@ -3761,7 +3761,7 @@
       "type": "standard",
       "path": "standards/lite-manifest-schema-changes.md",
       "tier": "lite",
-      "content_hash": "sha256:17f5c69efd97240348b6f74d35b200400c2817f7e303eb288b027fbb2bb38991",
+      "content_hash": "sha256:bccea2ce3acc450f35729690e7c24706391c87186ce99ece91e574a8f4686c58",
       "description": "Chronological ledger of every lite-manifest schema change. Adopters read this before sync to know what shifted."
     },
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thebassclef/lite",
-  "version": "1.9.0",
+  "version": "1.9.2",
   "description": "Bassclef CLI — install and upgrade bassclef in your project with two commands.",
   "keywords": [
     "bassclef",
@@ -8,7 +8,7 @@
     "cli",
     "scaffolding"
   ],
-  "homepage": "https://github.com/sunj-labs/bassclef-cli",
+  "homepage": "https://docs.bassclef.dev",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/sunj-labs/bassclef-cli.git"