feat: skills - audit auto-tmux package consistency

2026-08-19 22:08:05 +00:00 · 2026-05-19 14:49:49 +08:00
parent e84c40ce5d
commit 2e6fa2f419
7 changed files with 115 additions and 2 deletions
@@ -0,0 +1,98 @@
+#!/usr/bin/env bash
+# Audit auto-tmux package indexing consistency across scripts, references and gates.
+set -euo pipefail
+
+usage() {
+  cat <<'EOF'
+audit-package: check auto-tmux package indexing consistency
+
+Usage:
+  audit-package.sh
+
+Checks:
+  - every scripts/*.sh entry is documented in SKILL.md, scripts/README.md, scripts/AGENTS.md and validate-auto-tmux.sh
+  - completion.bash is documented in the same package indexes
+  - every references/*.md entry is documented in SKILL.md, references/README.md and references/index.md
+EOF
+}
+
+script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+skill_dir="$(cd "$script_dir/.." && pwd)"
+ref_dir="$skill_dir/references"
+
+case "${1:-}" in
+  -h|--help)
+    usage
+    exit 0
+    ;;
+  "")
+    ;;
+  *)
+    printf 'error: unknown option: %s\n' "$1" >&2
+    exit 1
+    ;;
+esac
+
+failures=0
+
+fail() {
+  printf '[FAIL] %s\n' "$*" >&2
+  failures=$((failures + 1))
+}
+
+pass() {
+  printf '[OK] %s\n' "$*"
+}
+
+require_contains() {
+  local file="$1"
+  local pattern="$2"
+  local label="$3"
+  if grep -Fq "$pattern" "$file"; then
+    pass "$label mentions $pattern"
+  else
+    fail "$label missing $pattern"
+  fi
+}
+
+for script_path in "$script_dir"/*.sh; do
+  script_name="$(basename "$script_path")"
+  if [[ -x "$script_path" ]]; then
+    pass "executable script: $script_name"
+  else
+    fail "script is not executable: $script_name"
+  fi
+  require_contains "$skill_dir/SKILL.md" "scripts/$script_name" "SKILL.md"
+  require_contains "$script_dir/README.md" "$script_name" "scripts/README.md"
+  require_contains "$script_dir/AGENTS.md" "$script_name" "scripts/AGENTS.md"
+  require_contains "$script_dir/validate-auto-tmux.sh" "$script_name" "validate-auto-tmux.sh"
+done
+
+require_contains "$skill_dir/SKILL.md" "scripts/completion.bash" "SKILL.md"
+require_contains "$script_dir/README.md" "completion.bash" "scripts/README.md"
+require_contains "$script_dir/AGENTS.md" "completion.bash" "scripts/AGENTS.md"
+require_contains "$script_dir/validate-auto-tmux.sh" "completion.bash" "validate-auto-tmux.sh"
+
+for ref_path in "$ref_dir"/*.md; do
+  ref_name="$(basename "$ref_path")"
+  case "$ref_name" in
+    AGENTS.md|README.md)
+      continue
+      ;;
+    index.md)
+      require_contains "$skill_dir/SKILL.md" "references/$ref_name" "SKILL.md"
+      require_contains "$ref_dir/README.md" "$ref_name" "references/README.md"
+      continue
+      ;;
+  esac
+  require_contains "$skill_dir/SKILL.md" "references/$ref_name" "SKILL.md"
+  require_contains "$ref_dir/README.md" "$ref_name" "references/README.md"
+  require_contains "$ref_dir/index.md" "$ref_name" "references/index.md"
+done
+
+if (( failures > 0 )); then
+  printf 'auto-tmux package audit failed: %s issue(s)\n' "$failures" >&2
+  exit 1
+fi
+
+printf 'auto-tmux package audit ok\n'