@thebassclef/lite 1.9.8 → 1.9.9

package/dist/lite/lib/preview-state.sh

@@ -49,14 +49,14 @@ ps_exists() {
 
 ps_create() {
   local slug="$1"
-  local path
-  path="$(ps_path "$slug")"
-  mkdir -p "$(dirname "$path")"
-  if [[ -f "$path" ]]; then
-    echo "ps_create: already exists: $path" >&2
+  local p
+  p="$(ps_path "$slug")"
+  mkdir -p "$(dirname "$p")"
+  if [[ -f "$p" ]]; then
+    echo "ps_create: already exists: $p" >&2
     return 1
   fi
-  cat > "$path" <<EOF
+  cat > "$p" <<EOF
 slug: ${slug}
 created: $(date -u +'%Y-%m-%dT%H:%M:%S+0000')
 current_tier: pending
@@ -73,16 +73,16 @@ EOF
 ps_get() {
   local slug="$1"
   local field="$2"
-  local path
-  path="$(ps_path "$slug")"
-  [[ -f "$path" ]] || { echo "ps_get: not-found: $path" >&2; return 1; }
+  local p
+  p="$(ps_path "$slug")"
+  [[ -f "$p" ]] || { echo "ps_get: not-found: $p" >&2; return 1; }
   awk -v f="$field" '
     $0 ~ "^" f ":" {
       sub("^" f ":[[:space:]]*", "")
       print
       exit
     }
-  ' "$path"
+  ' "$p"
 }
 
 ps_set() {
@@ -90,9 +90,9 @@ ps_set() {
   local field="$2"
   shift 2
   local value="$*"
-  local path
-  path="$(ps_path "$slug")"
-  [[ -f "$path" ]] || { echo "ps_set: not-found: $path" >&2; return 1; }
+  local p
+  p="$(ps_path "$slug")"
+  [[ -f "$p" ]] || { echo "ps_set: not-found: $p" >&2; return 1; }
   local tmp
   tmp="$(mktemp)"
   awk -v f="$field" -v v="$value" '
@@ -108,8 +108,8 @@ ps_set() {
         print f ": " v
       }
     }
-  ' "$path" > "$tmp"
-  mv "$tmp" "$path"
+  ' "$p" > "$tmp"
+  mv "$tmp" "$p"
 }
 
 ps_status() {
@@ -146,9 +146,9 @@ ps_archive() {
 ps_reset() {
   local slug="$1"
   local reason="${2:-no reason given}"
-  local path
-  path="$(ps_path "$slug")"
-  [[ -f "$path" ]] || { echo "ps_reset: not-found: $path" >&2; return 1; }
+  local p
+  p="$(ps_path "$slug")"
+  [[ -f "$p" ]] || { echo "ps_reset: not-found: $p" >&2; return 1; }
 
   local now
   now="$(date -u +'%Y-%m-%dT%H:%M:%S+0000')"
@@ -188,8 +188,8 @@ EOF
       next
     }
     { print }
-  ' "$path" > "$tmp"
-  mv "$tmp" "$path"
+  ' "$p" > "$tmp"
+  mv "$tmp" "$p"
   rm -f "$entry_file"
 
   # Reset cycle-state fields

package/dist/lite/lib/skip-env-inline-check.sh

@@ -0,0 +1,61 @@
+#!/bin/bash
+# tier: lite
+# SKIP_* env-reach check for PreToolUse Bash hooks.
+#
+# Per #2036 Finding #4 — adopter report 2026-10-02.
+#
+# PreToolUse Bash hooks run in Claude Code's process env. The agent's
+# `SKIP_FOO=1 git commit ...` recipe sets FOO in the git subshell's env,
+# not the hook's env. Hooks that only read `${SKIP_FOO:-0}` miss the
+# inline override and the recipe lies to the adopter.
+#
+# This helper parses tool_input.command for inline `SKIP_FOO=1` and
+# falls back to process env. The adopter's natural recipe
+# `SKIP_FOO=1 cmd` now works regardless of harness env propagation.
+#
+# Retirement path: once Claude Code harness guarantees inline-env
+# propagation to hook subprocesses, this helper becomes redundant.
+# Comment stays as the audit trail.
+#
+# Usage:
+#   source "$CLAUDE_PROJECT_DIR/lib/skip-env-inline-check.sh"
+#   COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command // ""')
+#   if skip_var_set "SKIP_FOO" "$COMMAND"; then
+#     # bypass
+#     exit 0
+#   fi
+#
+# Anchors:
+#   @luminary john-ousterhout — deep module; narrow interface
+#   @luminary david-parnas — information hiding; consumer-free of mechanism
+#   @luminary alan-cooper — adopter-goal reliable override recipe
+
+# skip_var_set — return 0 if the named SKIP_* var is set to "1".
+# Checks two sources:
+#   1. Inline prefix in command string: `SKIP_FOO=1 cmd...`
+#   2. Fallback: process env `$SKIP_FOO`
+# Returns 1 otherwise.
+#
+# Args:
+#   $1 — var name (e.g., "SKIP_OPERATOR_PATHS")
+#   $2 — command string (from tool_input.command)
+skip_var_set() {
+  local var_name="$1"
+  local cmd="$2"
+
+  # Source 1 — inline prefix. The pattern anchors on word boundary (start
+  # of string or whitespace) and requires =1 followed by whitespace or
+  # end-of-string. This matches bash's own parsing of inline env prefix.
+  if [ -n "$cmd" ]; then
+    if echo "$cmd" | grep -qE "(^|[[:space:]])${var_name}=1([[:space:]]|$)"; then
+      return 0
+    fi
+  fi
+
+  # Source 2 — process env fallback (works where harness propagates env).
+  if [ "$(eval "echo \"\${${var_name}:-0}\"")" = "1" ]; then
+    return 0
+  fi
+
+  return 1
+}

package/dist/lite/lib/state.sh

@@ -186,17 +186,19 @@ __state_atomic_write() {
 # crash caller).
 __state_yaml_write() {
   __state_check_binary_deps || return 4
-  local path="$1"
+  # Finding #6 (#2036): `local path` is a zsh-magic variable name — ties to
+  # $PATH when sourced from zsh. Renamed to `local p` throughout this file.
+  local p="$1"
   local field="$2"
   local value="$3"
-  if [ -z "$path" ] || [ -z "$field" ]; then
+  if [ -z "$p" ] || [ -z "$field" ]; then
     echo "__state_yaml_write: requires <path> <field> <value>" >&2
     return 2
   fi
   local dir
-  dir="$(dirname "$path")"
+  dir="$(dirname "$p")"
   [ -d "$dir" ] || mkdir -p "$dir" || return 4
-  local tmp="${path}.tmp.$$"
+  local tmp="${p}.tmp.$$"
   BASSCLEF_YAML_FIELD="$field" \
   BASSCLEF_YAML_VALUE="$value" \
   BASSCLEF_YAML_TMP="$tmp" \
@@ -213,7 +215,7 @@ except Exception as e:
     print(f"__state_yaml_write: safe_dump failed: {e}", file=sys.stderr)
     sys.exit(3)
 ' 2>&1 || { rm -f "$tmp"; return 3; }
-  mv "$tmp" "$path" || { rm -f "$tmp"; return 4; }
+  mv "$tmp" "$p" || { rm -f "$tmp"; return 4; }
 }
 
 # === Whereami (Shape A — JSON authoritative + markdown rendered) ===
@@ -239,21 +241,22 @@ state_whereami_get() {
 state_whereami_set() {
   local field="$1"
   local value="$2"
-  local path="docs/whereami.json"
+  local p="docs/whereami.json"
   if [ -z "$field" ] || [ -z "$value" ]; then
     echo "state_whereami_set: requires <field> <value>" >&2
     return 2
   fi
-  if [ ! -f "$path" ]; then
+  if [ ! -f "$p" ]; then
     echo "state_whereami_set: docs/whereami.json does not exist" >&2
     return 4
   fi
   local updated
-  # Use jq's setpath for nested field paths (e.g., 'phase.value')
+  # Use jq's setpath for nested field paths (e.g., 'phase.value').
+  # The jq `--arg path` names a jq variable (not shell) — safe to keep.
   updated="$(jq --arg path "$field" --arg val "$value" '
     setpath($path | split("."); $val)
-  ' "$path")" || return 3
-  __state_atomic_write "$path" "$updated"
+  ' "$p")" || return 3
+  __state_atomic_write "$p" "$updated"
 }
 
 # === IterationBet (Shape B — markdown + YAML frontmatter + body) ===
@@ -264,11 +267,11 @@ state_iteration_bet_get() {
     echo "state_iteration_bet_get: requires <slug>" >&2
     return 2
   fi
-  local path="docs/iteration-bets/${slug}.md"
-  if [ ! -f "$path" ]; then
+  local p="docs/iteration-bets/${slug}.md"
+  if [ ! -f "$p" ]; then
     return 1
   fi
-  __state_yq2json "$path"
+  __state_yq2json "$p"
 }
 
 # Special-purpose: returns the single active iteration bet (status=active),
@@ -333,25 +336,25 @@ state_roadmap_get() {
     echo "state_roadmap_get: requires <slug>" >&2
     return 2
   fi
-  local path="docs/roadmaps/${slug}.md"
-  if [ ! -f "$path" ]; then
+  local p="docs/roadmaps/${slug}.md"
+  if [ ! -f "$p" ]; then
     return 1
   fi
-  __state_yq2json "$path"
+  __state_yq2json "$p"
 }
 
 # Internal: rewrite a roadmap's frontmatter from JSON, preserving the body.
 __state_roadmap_write_frontmatter() {
   local slug="$1"
   local frontmatter_json="$2"
-  local path="docs/roadmaps/${slug}.md"
-  if [ ! -f "$path" ]; then
-    echo "__state_roadmap_write_frontmatter: roadmap $path not found" >&2
+  local p="docs/roadmaps/${slug}.md"
+  if [ ! -f "$p" ]; then
+    echo "__state_roadmap_write_frontmatter: roadmap $p not found" >&2
     return 1
   fi
   python3 -c "
 import sys, yaml, json
-path = '$path'
+path = '$p'
 fm = json.loads('''$frontmatter_json''')
 with open(path, 'r') as f:
     content = f.read()
@@ -726,15 +729,15 @@ state_chronicle_gate_evidence() {
     return 2
   fi
   # Try bassclef (chronicle/) and consumer-repo (docs/chronicle/) paths
-  local path=""
+  local p=""
   if [ -f "chronicle/${id}.md" ]; then
-    path="chronicle/${id}.md"
+    p="chronicle/${id}.md"
   elif [ -f "docs/chronicle/${id}.md" ]; then
-    path="docs/chronicle/${id}.md"
+    p="docs/chronicle/${id}.md"
   else
     return 1
   fi
-  __state_yq2json "$path" | jq -c '.gates_fired // []'
+  __state_yq2json "$p" | jq -c '.gates_fired // []'
 }
 
 # List chronicle IDs (filename without .md extension), optionally limited
@@ -1081,16 +1084,16 @@ __state_platform_resolve_path() {
 
 state_platform_get() {
   local key="${1:-}"
-  local path
-  path="$(__state_platform_resolve_path)"
-  if [ ! -f "$path" ]; then
+  local p
+  p="$(__state_platform_resolve_path)"
+  if [ ! -f "$p" ]; then
     return 1
   fi
   local json
   json="$(python3 -c "
 import sys, yaml, json
 try:
-    with open('$path') as f:
+    with open('$p') as f:
         data = yaml.safe_load(f) or {}
     print(json.dumps(data, default=str))
 except Exception as e:

package/dist/lite/lib/tier-check.sh

@@ -131,35 +131,35 @@ PYEOF
 # Mirrors detection shape from .claude/hooks/tier-tag-required-at-write.sh so
 # the reader half and the writer half stay consistent.
 resolve_file_tier() {
-  local path="$1"
-  if [ ! -f "$path" ]; then
+  local p="$1"
+  if [ ! -f "$p" ]; then
     return 0
   fi
 
   local tier=""
-  case "$path" in
+  case "$p" in
     *.md)
       # Frontmatter between --- markers, first 30 lines
       tier=$(awk '
         /^---/ { in_fm = !in_fm; if (!in_fm) exit; next }
         in_fm && /^tier:[[:space:]]/ { sub(/^tier:[[:space:]]*/, ""); sub(/[[:space:]]*$/, ""); print; exit }
         NR > 30 { exit }
-      ' "$path" 2>/dev/null)
+      ' "$p" 2>/dev/null)
       ;;
     *.sh|*.py)
-      tier=$(head -10 "$path" 2>/dev/null | grep -E '^#[[:space:]]*tier:[[:space:]]' | head -1 | sed -E 's/^#[[:space:]]*tier:[[:space:]]*//; s/[[:space:]]*$//')
+      tier=$(head -10 "$p" 2>/dev/null | grep -E '^#[[:space:]]*tier:[[:space:]]' | head -1 | sed -E 's/^#[[:space:]]*tier:[[:space:]]*//; s/[[:space:]]*$//')
       ;;
     *.yml|*.yaml)
-      tier=$(head -30 "$path" 2>/dev/null | grep -E '^#[[:space:]]*tier:[[:space:]]|^tier:[[:space:]]' | head -1 | sed -E 's/^#?[[:space:]]*tier:[[:space:]]*//; s/[[:space:]]*$//')
+      tier=$(head -30 "$p" 2>/dev/null | grep -E '^#[[:space:]]*tier:[[:space:]]|^tier:[[:space:]]' | head -1 | sed -E 's/^#?[[:space:]]*tier:[[:space:]]*//; s/[[:space:]]*$//')
       ;;
     *.json|*.jsonc)
-      tier=$(head -30 "$path" 2>/dev/null | grep -oE '"(_?tier)"[[:space:]]*:[[:space:]]*"[a-z]+"' | head -1 | sed -E 's/.*:[[:space:]]*"([a-z]+)"/\1/')
+      tier=$(head -30 "$p" 2>/dev/null | grep -oE '"(_?tier)"[[:space:]]*:[[:space:]]*"[a-z]+"' | head -1 | sed -E 's/.*:[[:space:]]*"([a-z]+)"/\1/')
       if [ -z "$tier" ]; then
-        tier=$(head -30 "$path" 2>/dev/null | grep -oE '//[[:space:]]*tier:[[:space:]]*[a-z]+' | head -1 | sed -E 's/.*tier:[[:space:]]*//')
+        tier=$(head -30 "$p" 2>/dev/null | grep -oE '//[[:space:]]*tier:[[:space:]]*[a-z]+' | head -1 | sed -E 's/.*tier:[[:space:]]*//')
       fi
       ;;
     *.txt)
-      tier=$(head -1 "$path" 2>/dev/null | grep -E '^#[[:space:]]*tier:[[:space:]]' | sed -E 's/^#[[:space:]]*tier:[[:space:]]*//; s/[[:space:]]*$//')
+      tier=$(head -1 "$p" 2>/dev/null | grep -E '^#[[:space:]]*tier:[[:space:]]' | sed -E 's/^#[[:space:]]*tier:[[:space:]]*//; s/[[:space:]]*$//')
       ;;
   esac
 

package/dist/lite/lib/tier-dependency-audit.sh

@@ -364,15 +364,15 @@ walk_graph_bfs() {
   while [ -s "$queue_file" ] && [ "$iter" -lt "$max_iter" ]; do
     iter=$((iter + 1))
     local next_file; next_file="$(mktemp)"
-    while IFS= read -r path; do
-      [ -z "$path" ] && continue
+    while IFS= read -r p; do
+      [ -z "$p" ] && continue
       # Skip if visited
-      if grep -Fxq "$path" "$visited_file" 2>/dev/null; then
+      if grep -Fxq "$p" "$visited_file" 2>/dev/null; then
         continue
       fi
-      echo "$path" >> "$visited_file"
+      echo "$p" >> "$visited_file"
       # Extract references from this file
-      "$extractor" "$path" 2>/dev/null | while IFS= read -r ref; do
+      "$extractor" "$p" 2>/dev/null | while IFS= read -r ref; do
         [ -n "$ref" ] && echo "$ref" >> "$next_file"
       done
     done < "$queue_file"
@@ -504,17 +504,17 @@ classify_files() {
   #   tag == target tier   → bucket 1 (ships correctly in this tier)
   #   no tag at all        → bucket 2a (safe mechanical tag)
   #   tag == other tier    → bucket 2b (chain-snap risk; per-file cure)
-  comm -12 "$intended_sorted" "$actual_sorted" | while IFS= read -r path; do
+  comm -12 "$intended_sorted" "$actual_sorted" | while IFS= read -r p; do
     # Look up tag for path in tags file. Returns "" for untagged (no tab)
     # or missing entry; returns tier value when tagged.
     local file_tag
-    file_tag="$(awk -F'\t' -v p="$path" '$1 == p { print ($2 ? $2 : ""); exit }' "$tags")"
+    file_tag="$(awk -F'\t' -v p="$p" '$1 == p { print ($2 ? $2 : ""); exit }' "$tags")"
     if [ "$file_tag" = "$tier" ]; then
-      echo "$path" >> "$bucket_1"
+      echo "$p" >> "$bucket_1"
     elif [ -z "$file_tag" ]; then
-      echo "$path" >> "$bucket_2a"
+      echo "$p" >> "$bucket_2a"
     else
-      echo "$path" >> "$bucket_2b"
+      echo "$p" >> "$bucket_2b"
     fi
   done
 
@@ -557,13 +557,13 @@ classify_files_combined() {
 
   # Bucket 1 + Bucket 2 — split intersection by tag presence.
   # In combined mode, ANY non-empty tag places the file in bucket 1.
-  comm -12 "$intended_sorted" "$actual_sorted" | while IFS= read -r path; do
+  comm -12 "$intended_sorted" "$actual_sorted" | while IFS= read -r p; do
     local file_tag
-    file_tag="$(awk -F'\t' -v p="$path" '$1 == p { print ($2 ? $2 : ""); exit }' "$tags")"
+    file_tag="$(awk -F'\t' -v p="$p" '$1 == p { print ($2 ? $2 : ""); exit }' "$tags")"
     if [ -n "$file_tag" ]; then
-      echo "$path" >> "$bucket_1"
+      echo "$p" >> "$bucket_1"
     else
-      echo "$path" >> "$bucket_2"
+      echo "$p" >> "$bucket_2"
     fi
   done
 
@@ -738,12 +738,12 @@ write_manifest_combined() {
 #   - SDLC trace logs
 # ---------------------------------------------------------------------------
 _is_substrate_relevant_path() {
-  local path="$1"
+  local p="$1"
   # Normalize leading ./ prefix so patterns match consistently.
   # Closure files mix "./foo" (from find) with "foo" (from git grep).
   # Per #1385 walker cure — extends G3 filter beyond initial pattern set.
-  path="${path#./}"
-  case "$path" in
+  p="${p#./}"
+  case "$p" in
     /*|../*|.git/*|*/.git/*) return 1 ;;
     # Runtime state — walker outputs + gate markers + session state + analysis.
     # None ship to adopters regardless of tier tag. Per #1385.
@@ -831,12 +831,12 @@ walk_graph_bfs_inbound() {
   while [ -s "$queue_file" ] && [ "$iter" -lt "$max_iter" ]; do
     iter=$((iter + 1))
     local next_file; next_file="$(mktemp)"
-    while IFS= read -r path; do
-      [ -z "$path" ] && continue
-      if grep -Fxq "$path" "$visited_file" 2>/dev/null; then continue; fi
-      echo "$path" >> "$visited_file"
-      # Look up callers of $path in the reverse index (path is column 1; caller is column 2)
-      awk -F'\t' -v p="$path" '$1 == p { print $2 }' "$rev_index" | while IFS= read -r caller; do
+    while IFS= read -r p; do
+      [ -z "$p" ] && continue
+      if grep -Fxq "$p" "$visited_file" 2>/dev/null; then continue; fi
+      echo "$p" >> "$visited_file"
+      # Look up callers of $p in the reverse index (path is column 1; caller is column 2)
+      awk -F'\t' -v p="$p" '$1 == p { print $2 }' "$rev_index" | while IFS= read -r caller; do
         [ -n "$caller" ] && echo "$caller" >> "$next_file"
       done
     done < "$queue_file"

package/dist/lite/presence/install/schedule-auto-save.taskscheduler.md

@@ -110,7 +110,7 @@ Unregister-ScheduledTask -TaskName "BassclefAutoSave" -Confirm:$false
 
 ## Alternatives
 
-- **WSL2 available?** Skip this doc; use `presence/install/schedule-auto-save.cron.sh` inside WSL. Cron there watches your Windows filesystem via `/mnt/c/Users/...`.
+- **WSL2 available?** Skip this doc; use `presence/install/schedule-auto-save.cron.sh` inside WSL. Cron there watches your Windows filesystem via the mounted `/mnt/c/` tree under your user profile.
 - **Prefer a .ps1 installer?** File a ticket. The current ship stays doc-only to avoid installer complexity for a population not yet observed. Path B (per-OS installers) upgrade is a follow-on.
 
 ## References

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

@@ -34,6 +34,44 @@ Every entry stays in this file for the life of the manifest. Never pruned. When
 
 ## Entries (newest first)
 
+### #1777 — friction hook pattern adds stage|launch new skill vocabulary (v1.14.2 → v1.14.3, 2026-10-01)
+
+- **Change type:** content-change (1 file: `post-skill-friction-check` hook)
+- **Fields:** 439 entries → 439 entries (no add/remove). Content hash shifts on `post-skill-friction-check` slug (MAJOR_SKILLS_PATTERN regex extended with stage|launch per ADR-040 D1 rename grace window).
+- **Version bump:** v1.14.2 → v1.14.3 (patch — content-only change; no field add/remove; no shape shift). Rebased after #523's retirement-discipline cure landed as v1.14.2.
+- **Rationale:** PR #2028 closes #1777 (friction log never created because hook pattern matched old skill names only). Additive regex extension; grace-window compat preserved (preview|preview-build still match).
+- **Downstream cure:** none — adopters re-sync and the hook starts firing on current-vocabulary chain dispatches. Lazy-create of `docs/session-friction-log.md` happens on first real friction case.
+- **Old shape retired:** old pattern retired `2026-10-31` (grace window end for ADR-040 D1 vocabulary); current pattern keeps both until then.
+
+### #523 — retirement discipline + fixture allowlist pattern (v1.14.1 → v1.14.2, 2026-10-01)
+
+- **Change type:** content-change (2 files: `rule/lite-manifest-schema-change-discipline` + `standard/lite-manifest-schema-changes`)
+- **Fields:** 439 entries (unchanged). Content hashes shift on `.claude/rules/lite-manifest-schema-change-discipline.md` (gains a `## Retirements` section covering retirement-class discipline alongside additions) and `standards/lite-manifest-schema-changes.md` (gains the v1.14.0 entry for #1992 that this PR backfilled plus this v1.14.2 entry).
+- **Version bump:** v1.14.1 → v1.14.2 (patch; content-only change on 2 slugs; no schema shape shift; no entry count change).
+- **Rationale:** sunj-labs/bassclef-upstream#523 closed. 4 consecutive main-CI failures 2026-09-29 to 09-30 (SHAs `3c997584`, `02da6b8d`, `924d489f` on `substrate-check-phase`) traced to Test 16 — the Feathers v1.6.1 snapshot guard — seeing 2 entries drop after PR #1992's compat shim retirement. Prior addition-class discipline fired a mechanical ledger-pre-flight gate; retirement-class did not. This PR extends the existing rule with a `## Retirements` section (per Ousterhout contrarian: one rule, two sections) + ships a fixture allowlist pattern (`.claude/hooks/tests/fixtures/2026-09-16-lite-catalog-closure/retired-entries.txt`) + updates Test 16 to subtract allowlist rows before asserting zero drops + backfills the v1.14.0 ledger entry #1992 missed.
+- **Downstream cure:** none — adopters at `~1.14` get the rule content update at next sync. Any adopter authoring a retirement PR going forward follows the `## Retirements` section. Mechanical pre-commit hook (`pre-retire-discipline-check.sh`) deferred to a follow-on PR per Ousterhout (keep this PR scope-tight).
+- **Old shape retired:** none — additive discipline extension.
+- **Protects:** 4 upcoming retirement tickets (#266 S3 → npm move, #108 ADR-020 prototype deprecation, #1142 structural rename sweep, #1999 launch cadence rules) ship under the extended discipline.
+
+### #1992 — compounding-axis compat shim retirement (v1.13.2 → v1.14.0, 2026-09-28)
+
+- **Change type:** content-remove (2 entries dropped)
+- **Fields:** 441 entries → 439 entries. Removed entries: `hook/longrun-prep-compounding-axis-check` (`.claude/hooks/longrun-prep-compounding-axis-check.sh`) + `rule/compounding-axis-fresh-analysis` (`.claude/rules/compounding-axis-fresh-analysis.md`). Both were compat shim symlinks from the 2026-07-03 compounding-axis → compounding-sequence rename per PR #611 (bet 2026-07-03b WU-2).
+- **Version bump:** v1.13.2 → v1.14.0 (MINOR — content-remove per bump policy; adopters pinning major stay green, adopters pinning exact version must update).
+- **Rationale:** sunj-labs/bassclef-upstream#1989 — compat shim grace window (ADR-031 default) elapsed on 2026-10-03; harness scanned each symlink twice inflating the rule set at session start. Grep across `standards/bassclef-source-consumers.json` returned zero adopter pins on the old slug, so the shim was defensive dogma rather than adopter-driven. Both symlinks + the duplicate embedding JSON deleted at SHA `9884278f`. Rename targets (`compounding-sequence-fresh-analysis.md` + `longrun-prep-compounding-sequence-check.sh`) stay live under their post-rename names.
+- **Downstream cure:** none for adopters at `~1.13` or `~1.14`. Adopters pinning exact `manifest_version` (bassclef-web#256 + bassclef-cli#51) update pins at the next sync. Any adopter code reading `.entries[]` by legacy `compounding-axis` slug finds nothing — switch reads to `compounding-sequence` sister slugs.
+- **Old shape retired:** immediately. ADR-031 grace window on compat shim ran its full term (2026-07-03 → 2026-10-03); no further compat preservation owed.
+- **Retirement allowlist:** `.claude/hooks/tests/fixtures/2026-09-16-lite-catalog-closure/retired-entries.txt` carries both removed slugs so Test 16 (Feathers v1.6.1 snapshot guard) subtracts them before asserting zero drops. Backfilled by follow-on PR #<this PR> (sunj-labs/bassclef-upstream#523).
+
+### #1777 — friction hook pattern adds stage|launch new skill vocabulary (v1.14.0 → v1.14.1, 2026-10-01)
+
+- **Change type:** content-change (1 file: `post-skill-friction-check` hook)
+- **Fields:** 439 entries → 439 entries (no add/remove). Content hash shifts on `post-skill-friction-check` slug (MAJOR_SKILLS_PATTERN regex extended with stage|launch per ADR-040 D1 rename grace window).
+- **Version bump:** v1.14.0 → v1.14.1 (patch — content-only change; no field add/remove; no shape shift).
+- **Rationale:** PR #2028 closes #1777 (friction log never created because hook pattern matched old skill names only). Additive regex extension; grace-window compat preserved (preview|preview-build still match).
+- **Downstream cure:** none — adopters re-sync and the hook starts firing on current-vocabulary chain dispatches. Lazy-create of `docs/session-friction-log.md` happens on first real friction case.
+- **Old shape retired:** old pattern retired `2026-10-31` (grace window end for ADR-040 D1 vocabulary); current pattern keeps both until then.
+
 ### #1961 — persistent statusline for bassclef version + sync status (v1.12.2 → v1.13.0, 2026-09-27)
 
 - **Change type:** content-add (1 new entry: `statusline-version` lib) + content-change (2 files: `bassclef-sync` hook + `bassclef-orientation`)