kit-health

You are running a health check on the dwarves-kit installation. This command evaluates the kit against its own design principles from PHILOSOPHY.md.

Process

Step 1: Run automated checks

Include the install-staleness probe (SPEC-066): if ~/.claude/dwarves-kit/INSTALL-STAMP exists, compare its sha= against git rev-parse --short HEAD of the kit repo; a mismatch means the pinned install predates the checkout: report "stale install; re-run install.sh" (advisory). No stamp + symlinked hooks = a pre-SPEC-066 install; recommend re-running install.sh to pin.

Include the lane-telemetry probe (SPEC-061): bash lib/telemetry/lane-telemetry.sh report must exit 0 and print either aggregates or (no run ledgers); a parse failure means the ledger format and the reader have drifted apart.

Execute these checks and collect results:

# 1. File count
echo "Files: $(find ~/.claude/dwarves-kit -type f | grep -v '.git/' | wc -l)"

# 2. Hook executability
for f in ~/.claude/dwarves-kit/hooks/*.sh; do
  [ -x "$f" ] && echo "  [ok] $(basename $f)" || echo "  [FAIL] $(basename $f) not executable"
done

# 3. Settings.json validity
jq . ~/.claude/dwarves-kit/settings.json >/dev/null 2>&1 && echo "settings.json: valid" || echo "settings.json: INVALID"

# 4. All hooks in settings.json point to files that exist
jq -r '[.hooks | to_entries[] | .value[] | .hooks[] | .command] | .[]' ~/.claude/dwarves-kit/settings.json | while read cmd; do
  SCRIPT=$(echo "$cmd" | sed "s|bash \$HOME|bash $HOME|" | awk '{print $2}')
  SCRIPT=$(eval echo "$SCRIPT")
  [ -f "$SCRIPT" ] && echo "  [ok] $SCRIPT" || echo "  [MISSING] $SCRIPT"
done

# 5. Hook performance (time each one with sample input)
for f in ~/.claude/dwarves-kit/hooks/*.sh; do
  NAME=$(basename "$f")
  case "$NAME" in
    anti-rationalization.sh)
      INPUT='{"stop_hook_active":false,"assistant_response":"test response"}';;
    safety-gate.sh|spec-drift-guard.sh)
      INPUT='{"tool_input":{"command":"ls","file_path":"test.ts"}}';;
    permission-auto-approve.sh)
      INPUT='{"tool_name":"Bash","tool_input":{"command":"ls"}}';;
    slop-cleaner.sh)
      INPUT='{"stop_hook_active":false,"assistant_response":"done"}';;
    *)
      INPUT='{}';;
  esac
  ELAPSED=$( { time echo "$INPUT" | bash "$f" >/dev/null 2>&1; } 2>&1 | grep real | awk '{print $2}')
  echo "  $NAME: $ELAPSED"
done

# 6. No compiled binaries
BINS=$(find ~/.claude/dwarves-kit -type f \( -name "*.exe" -o -name "*.bin" -o -name "*.so" -o -name "*.dylib" \) | wc -l | tr -d ' ')
echo "Compiled binaries: $BINS"

# 7. Every command has a description in YAML frontmatter
for f in ~/.claude/dwarves-kit/commands/*.md; do
  DESC=$(grep '^description:' "$f" | head -1)
  [ -n "$DESC" ] && echo "  [ok] $(basename $f)" || echo "  [MISSING] $(basename $f) has no description"
done

# 8. Hook logs exist and show recent activity
LOG_DIR="$HOME/.claude/dwarves-kit/logs"
if [ -d "$LOG_DIR" ]; then
  for f in "$LOG_DIR"/*.log; do
    [ -f "$f" ] || continue
    LINES=$(wc -l < "$f" | tr -d ' ')
    LAST=$(tail -1 "$f" | cut -d'|' -f1 | tr -d ' ')
    echo "  $(basename $f): $LINES entries, last: $LAST"
  done
else
  echo "  No log directory yet (hooks haven't fired)"
fi

# 9. Source citations in README credits
CREDITS=$(sed -n '/## Credits/,/## /p' ~/.claude/dwarves-kit/README.md | grep -c '\[')
echo "Source citations in README: $CREDITS"

# 10. TODOs/FIXMEs in hook scripts
TODOS=$(grep -r "TODO\|FIXME" ~/.claude/dwarves-kit/hooks/ 2>/dev/null | wc -l | tr -d ' ')
echo "TODOs/FIXMEs in hooks: $TODOS"

# 11. Release hygiene: a phantom version cut (VERSION names an untagged version)
# Repo-scoped: reads the repo's .git + VERSION via the current working dir (git
# tags + CHANGELOG live in the repo, not the installed copy under ~/.claude). The
# guard degrades to a no-op outside a git repo / without VERSION, never errors.
if [ -f VERSION ] && git rev-parse --git-dir >/dev/null 2>&1; then
  VER=$(tr -d '[:space:]' < VERSION)
  # CHANGELOG resolution (SPEC-185): docs/CHANGELOG.md wins if present, else root CHANGELOG.md.
  CL=CHANGELOG.md; [ -f docs/CHANGELOG.md ] && CL=docs/CHANGELOG.md
  if [ -n "$VER" ] && [ -z "$(git tag -l "v$VER")" ]; then
    echo "  [WARN] release hygiene: VERSION is $VER but tag v$VER does not exist (phantom cut)"
    # Accumulation context: [Unreleased] NON-empty => work piling above an untagged cut (same awk as ship.md, DEC-006).
    if [ -f "$CL" ] && awk '/## \[Unreleased\]/{f=1;next} /^## /{f=0} f && NF{print}' "$CL" | grep -q .; then
      echo "         and CHANGELOG [Unreleased] is accumulating above it"
    fi
  else
    echo "  release hygiene: ok (v$VER tagged, or clean)"
  fi
else
  echo "  release hygiene: skipped (not in the kit repo / no VERSION)"
fi