@thebassclef/lite 0.1.2 → 1.0.0

package/substrate/.claude/hooks/compound-noun-scrub.sh

@@ -1,292 +0,0 @@
-#!/bin/bash
-# tier: lite
-# install-class: dual
-# compound-noun-scrub.sh — PreToolUse Edit|Write gate on
-# .claude/skills/*/SKILL.md and .claude/rules/*.md.
-#
-# V2 — reads blocklist from standards/bassclef-internal-jargon.md
-# (single source of truth per bassclef-upstream#782). No hardcoded
-# allowlist. No heuristic detection. Literal match against BLOCK-tier
-# hyphenated compounds in the wordlist file. Standard tech compounds
-# like pre-commit, real-time, data-driven pass automatically because
-# they are not in the blocklist. New invented compounds pass by default
-# until the operator adds them to the wordlist.
-#
-# Sister to skill-body-grade-gate.sh (FKGL) and turn-prose-kiss-check.sh
-# (which reads the same wordlist file for Stop-event prose scrub).
-#
-# Input (stdin): JSON with tool_name + tool_input.file_path + content/new_string
-# Exit: 0 pass, 2 block
-#
-# Override: SKIP_COMPOUND_NOUN_SCRUB=1
-# Wordlist path override (tests): BASSCLEF_JARGON_WORDLIST=<path>
-#
-# Per @luminary kent-beck (Tier 0 strict TDD)
-# + @luminary donald-norman (plain-English target)
-# + @luminary john-ousterhout (single source of truth wordlist).
-
-set +e
-
-# === Override ===
-if [ "${SKIP_COMPOUND_NOUN_SCRUB:-0}" = "1" ]; then
-  exit 0
-fi
-
-# === Parse stdin ===
-STDIN_JSON=$(cat 2>/dev/null || echo '{}')
-
-if ! echo "$STDIN_JSON" | jq -e . >/dev/null 2>&1; then
-  exit 0
-fi
-
-TOOL_NAME=$(echo "$STDIN_JSON" | jq -r '.tool_name // ""' 2>/dev/null)
-FILE_PATH=$(echo "$STDIN_JSON" | jq -r '.tool_input.file_path // ""' 2>/dev/null)
-
-# Only fire on Write or Edit
-if [ "$TOOL_NAME" != "Write" ] && [ "$TOOL_NAME" != "Edit" ]; then
-  exit 0
-fi
-
-# Fire on SKILL.md, rule .md, OR bash source under scoped paths (bassclef-upstream#1051).
-# Bash paths use ADVISORY mode by default; BASSCLEF_BASH_HEADER_STRICT=1 flips to BLOCK.
-IS_BASH_PATH=0
-case "$FILE_PATH" in
-  *".claude/skills/"*"/SKILL.md")
-    ;;
-  *".claude/rules/"*.md)
-    ;;
-  *".claude/hooks/"*.sh)
-    IS_BASH_PATH=1
-    ;;
-  *"scripts/"*.sh)
-    IS_BASH_PATH=1
-    ;;
-  *"lib/"*.sh)
-    IS_BASH_PATH=1
-    ;;
-  *"presence/"*.sh)
-    IS_BASH_PATH=1
-    ;;
-  *)
-    exit 0
-    ;;
-esac
-
-# === Extract text ===
-if [ "$TOOL_NAME" = "Write" ]; then
-  CONTENT=$(echo "$STDIN_JSON" | jq -r '.tool_input.content // ""' 2>/dev/null)
-else
-  CONTENT=$(echo "$STDIN_JSON" | jq -r '.tool_input.new_string // ""' 2>/dev/null)
-fi
-
-[ -z "$CONTENT" ] && exit 0
-
-# === Bash path handling (bassclef-upstream#1051) ===
-# For bash paths, extract only the header comment block and require the
-# `# tier:` header tag. Adopter files without the tier tag pass through
-# untouched (Linus R2.1 adopter safety).
-if [ "$IS_BASH_PATH" = "1" ]; then
-  # Extract header comment block — starting from the first line of #-comments
-  # (skipping shebang if present), stopping at first non-# non-blank line.
-  HEADER=$(printf '%s' "$CONTENT" | awk '
-    BEGIN { started=0 }
-    NR==1 && /^#!/ { next }               # skip shebang
-    /^#/ { print; started=1; next }
-    /^[[:space:]]*$/ { if (started==0) next; else print; next }
-    { exit }
-  ')
-
-  # Adopter safety — require `# tier:` marker (bassclef convention).
-  # Absent tier tag → adopter-authored, pass through silently.
-  if ! echo "$HEADER" | grep -qE '^# ?tier:'; then
-    exit 0
-  fi
-
-  # Replace CONTENT with just the header block for the scan
-  CONTENT="$HEADER"
-fi
-
-# === Locate wordlist ===
-# Test override wins; then repo-relative from hook location; then fail-safe.
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-WORDLIST="${BASSCLEF_JARGON_WORDLIST:-$SCRIPT_DIR/../../standards/bassclef-internal-jargon.md}"
-
-if [ ! -f "$WORDLIST" ]; then
-  echo "" >&2
-  echo "compound-noun-scrub: wordlist file not found at $WORDLIST" >&2
-  echo "  Fail-safe: passing through. Add wordlist file to enable blocklist scan." >&2
-  echo "" >&2
-  exit 0
-fi
-
-# === Scrub via python — reads blocklist + matches literal terms ===
-SCRUB_OUTPUT=$(printf '%s' "$CONTENT" | WORDLIST="$WORDLIST" python3 -c '
-import sys, re, os
-
-text = sys.stdin.read()
-
-# === Strip surfaces the scrub should ignore ===
-
-# Strip YAML frontmatter
-text = re.sub(r"^---\n.*?\n---\n", "", text, count=1, flags=re.DOTALL)
-
-# Strip FKGL-EXEMPT blocks (matches skill-body-grade-gate.sh L77-L78 per #800)
-text = re.sub(r"<!--\s*FKGL-EXEMPT:.*?-->.*?<!--\s*/FKGL-EXEMPT\s*-->",
-              "", text, flags=re.DOTALL)
-
-# Strip code blocks (```...```)
-text = re.sub(r"```.*?```", "", text, flags=re.DOTALL)
-
-# Strip inline backticks
-text = re.sub(r"`[^`]*`", "", text)
-
-# Strip URLs (http:// or https:// through whitespace)
-text = re.sub(r"https?://\S+", "", text)
-
-# Strip slash-prefixed refs (/skill-name, /roadmap-reconcile) — proper nouns
-text = re.sub(r"/[a-zA-Z]+(-[a-zA-Z]+)+", "", text)
-
-# Strip file paths (foo/bar-baz.md) — proper nouns
-text = re.sub(r"[a-zA-Z_./-]*/[a-zA-Z_.-]+\.[a-z]+", "", text)
-
-# === Read blocklist from wordlist file ===
-wordlist_path = os.environ.get("WORDLIST", "")
-blocklist = set()
-
-try:
-    with open(wordlist_path, "r") as f:
-        lines = f.readlines()
-except (OSError, IOError):
-    print("PASS")
-    sys.exit(0)
-
-# Parse markdown table — extract BLOCK-tier rows from column 1
-# Row shape: | Term | Plain English | Tier |
-# Tier column may be BLOCK, BLOCK-title, ADVISE, ALLOW
-for line in lines:
-    line = line.strip()
-    if not line.startswith("|") or not line.endswith("|"):
-        continue
-    cells = [c.strip() for c in line.split("|")[1:-1]]
-    if len(cells) != 3:
-        continue
-    term_cell, _plain, tier = cells
-
-    # Only BLOCK tier — BLOCK-title is title-only scrub (different hook)
-    if tier != "BLOCK":
-        continue
-
-    # Extract the term BEFORE any parenthetical context.
-    # Row example: "OR hand-roll (soft-INSTEAD escape per bassclef-upstream#375)"
-    # Take "OR hand-roll" — then extract hyphenated compounds within.
-    term_part = term_cell.split("(", 1)[0].strip()
-
-    # Extract every lowercase-alpha hyphenated compound in the term part.
-    # Compound pattern: alpha (2+ chars) then one-or-more hyphenated alpha (2+ chars).
-    compounds = re.findall(r"\b[a-z][a-z]+(?:-[a-z][a-z]+)+\b", term_part.lower())
-    for c in compounds:
-        # Skip bassclef proper nouns that leak in (bassclef-upstream, bassclef-web, etc.)
-        if c.startswith("bassclef-"):
-            continue
-        blocklist.add(c)
-
-if not blocklist:
-    # Empty blocklist → fail safe (do not block anything)
-    print("PASS")
-    sys.exit(0)
-
-# === Match literal blocklist terms in scan text ===
-flagged = []
-seen = set()
-
-text_lower = text.lower()
-for term in sorted(blocklist):
-    # Word-boundary match, case-insensitive already via text_lower
-    if re.search(r"\b" + re.escape(term) + r"\b", text_lower):
-        if term not in seen:
-            flagged.append(term)
-            seen.add(term)
-
-if flagged:
-    print("BLOCK", len(flagged))
-    for f in flagged[:10]:
-        print(f"  FLAG {f}")
-else:
-    print("PASS")
-' 2>/dev/null)
-
-# === Parse result ===
-FIRST_LINE=$(echo "$SCRUB_OUTPUT" | head -1)
-VERDICT=$(echo "$FIRST_LINE" | awk '{print $1}')
-
-case "$VERDICT" in
-  PASS|"")
-    exit 0
-    ;;
-  BLOCK)
-    COUNT=$(echo "$FIRST_LINE" | awk '{print $2}')
-    ;;
-  *)
-    exit 0
-    ;;
-esac
-
-# === Determine emit mode ===
-# Bash paths use ADVISORY (exit 0 + stderr note) unless
-# BASSCLEF_BASH_HEADER_STRICT=1 flips to BLOCK. Non-bash paths always BLOCK.
-EMIT_MODE="BLOCK"
-if [ "$IS_BASH_PATH" = "1" ] && [ "${BASSCLEF_BASH_HEADER_STRICT:-0}" != "1" ]; then
-  EMIT_MODE="ADVISORY"
-fi
-
-# === Emit ===
-if [ "$EMIT_MODE" = "ADVISORY" ]; then
-  # ADVISORY — bash path header jargon (bassclef-upstream#1051)
-  echo "" >&2
-  echo "⚠️  COMPOUND-NOUN-SCRUB — ADVISORY (bash header)" >&2
-  echo "" >&2
-  echo "  File: $FILE_PATH" >&2
-  echo "  Found $COUNT jargon compound(s) in header comment from standards/bassclef-internal-jargon.md:" >&2
-  echo "$SCRUB_OUTPUT" | grep '^  FLAG' | while read -r _ compound; do
-    echo "    - $compound (see wordlist for plain-English substitute)" >&2
-  done
-  echo "" >&2
-  echo "  Advisory only — exit 0. Set BASSCLEF_BASH_HEADER_STRICT=1 to make bash headers block." >&2
-  echo "  Override: SKIP_COMPOUND_NOUN_SCRUB=1 (logged via trace-helper)" >&2
-  echo "" >&2
-
-  # Trace
-  if [ -f "$SCRIPT_DIR/trace-helper.sh" ]; then
-    # shellcheck disable=SC1091
-    source "$SCRIPT_DIR/trace-helper.sh"
-    trace_log "compound-noun-scrub" "ADVISORY count=$COUNT file=$FILE_PATH"
-  fi
-  exit 0
-fi
-
-# === Emit BLOCK ===
-echo "" >&2
-echo "🛑 COMPOUND-NOUN-SCRUB — BLOCKED" >&2
-echo "" >&2
-echo "  File: $FILE_PATH" >&2
-echo "  Found $COUNT invented compound(s) from standards/bassclef-internal-jargon.md:" >&2
-echo "$SCRUB_OUTPUT" | grep '^  FLAG' | while read -r _ compound; do
-  echo "    - $compound" >&2
-done
-echo "" >&2
-echo "  Cure paths:" >&2
-echo "    1. Rewrite the sentence in plain SVO English per standards/bassclef-internal-jargon.md" >&2
-echo "    2. If the term is genuinely needed as a proper noun, mark exempt via <!-- FKGL-EXEMPT -->" >&2
-echo "    3. If the term should not be on the blocklist, propose a wordlist amendment" >&2
-echo "" >&2
-echo "  Override: SKIP_COMPOUND_NOUN_SCRUB=1 (logged via trace-helper)" >&2
-echo "" >&2
-
-# === Trace ===
-if [ -f "$SCRIPT_DIR/trace-helper.sh" ]; then
-  # shellcheck disable=SC1091
-  source "$SCRIPT_DIR/trace-helper.sh"
-  trace_log "compound-noun-scrub" "BLOCKED count=$COUNT file=$FILE_PATH"
-fi
-
-exit 2

package/substrate/.claude/hooks/kiss-expansion-inject.sh

@@ -1,69 +0,0 @@
-#!/bin/bash
-# tier: lite
-# install-class: dual
-# kiss-expansion-inject.sh — UserPromptExpansion hook that injects
-# additionalContext when /kiss expands. Per bet 2026-07-01e WU-1 +
-# ADR-035 lines 133 + 185 (UserPromptExpansion steering surface).
-#
-# Sources lib/hook-inject.sh + calls emit_base_pair_reminders (shared
-# plain-English + assert-verify content) + adds kiss-specific reminders
-# (substitution table + reminder that /kiss preserves claim shape).
-#
-# Sibling pattern: assert-verify-steering.sh + plain-english-steering.sh
-# (UserPromptSubmit siblings — background steering at prompt start).
-# This hook fires per-invocation at skill expansion — steering couples
-# to skill intent, not background prompt-start reminders that go stale.
-#
-# Override per-call: SKIP_KISS_EXPANSION_INJECT=1
-#
-# Wired in .claude/settings.json under UserPromptExpansion matcher "kiss".
-# Tier 0 strict TDD: .claude/hooks/tests/kiss-expansion-inject.test.sh
-#
-# Anchors: @luminary saltzer-schroeder (complete mediation — every /kiss
-# invocation gets the discipline reminder) + @luminary john-ousterhout
-# (deep module in lib/hook-inject.sh; five callers, one implementation).
-
-set +e
-
-# === Source install-class-aware lib (per standards/hook-install-class.md) ===
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-for _candidate in \
-  "${SCRIPT_DIR}/../../lib/hook-inject.sh" \
-  "${HOME_OVERRIDE:-${HOME:-/}}/lib/hook-inject.sh"; do
-  if [ -f "$_candidate" ]; then
-    # shellcheck disable=SC1090
-    source "$_candidate"
-    break
-  fi
-done
-
-# Defensive: if lib not loaded, exit silent (fail-soft per Nygard)
-if ! declare -f emit_additional_context >/dev/null 2>&1; then
-  exit 0
-fi
-if ! declare -f emit_base_pair_reminders >/dev/null 2>&1; then
-  exit 0
-fi
-
-# Override per-call
-if [ "${SKIP_KISS_EXPANSION_INJECT:-0}" = "1" ]; then
-  exit 0
-fi
-
-# === Compose steering content ===
-BASE_PAIR="$(emit_base_pair_reminders)"
-
-KISS_SPECIFIC="
-
-**/kiss-specific reminders:**
-
-- Read the substitution table at standards/bassclef-internal-jargon.md before rewriting. BLOCK-tier terms substitute per the table; ADVISE-tier terms rewrite when clean; ALLOW terms (substrate, bassclef, cameo, Studio, Band, bandleader) stay.
-- /kiss preserves claim shape while swapping vocabulary. Assertion grounding still applies. If the input text carries a claim without cited Evidence + Why-supports, /kiss does not rescue it — surface the missing grounding.
-- Grade level is a target, not a mask. Plain English exposes weak assertions. Prefer clarity over camouflage.
-- Every rewrite passes back through assert-verify: the plain-English version still needs My claim + Evidence + Why the evidence supports the claim for any operator-facing assertion the input carried."
-
-STEERING_CONTENT="${BASE_PAIR}${KISS_SPECIFIC}"
-
-# === Emit envelope ===
-emit_additional_context "UserPromptExpansion" "$STEERING_CONTENT"
-exit 0