65 lines
2.5 KiB
Bash
65 lines
2.5 KiB
Bash
#!/usr/bin/env bash
|
|
# ============================================================
|
|
# lib/doctor-skills.sh — doctor.sh's skill-catalog stats
|
|
#
|
|
# `skill_catalog_stats <skills_dir>` counts every skill reachable
|
|
# through <skills_dir>/*/SKILL.md and <skills_dir>/pack-*/skills/*/SKILL.md
|
|
# (symlinks included — Python's
|
|
# glob.glob follows them, verified: a symlinked skill dir matches the
|
|
# pattern the same as a real one) and sums their description length,
|
|
# reusing lib/skill-routing-census.py's extract_description() (handles
|
|
# a plain scalar AND a `|`/`>` YAML block scalar) instead of doctor.sh's
|
|
# old `grep '^description:' | head -1` (0 chars on every block-scalar
|
|
# description) and its `find -maxdepth 2` skill count (missed
|
|
# symlinked skill dirs without `-L`).
|
|
#
|
|
# Prints "<count> <desc_chars>" on stdout and ALWAYS exits 0 — an
|
|
# absent <skills_dir> naturally globs to nothing (0 0, no error); a
|
|
# python failure also prints "0 0" so doctor.sh (which runs under
|
|
# `set -euo pipefail`) never aborts on this check, PLUS one warn line on
|
|
# stderr so a real failure still shows instead of reading as a healthy
|
|
# empty catalog. The warn goes to stderr explicitly (not just via the
|
|
# caller's own warn() convention) because the caller reads this
|
|
# function's stdout with `read -r … < <(skill_catalog_stats …)` — any
|
|
# extra stdout line would corrupt that capture.
|
|
#
|
|
# No `set -euo pipefail` here (mirrors lib/vendor-skills.sh): a sourced
|
|
# lib must not change the caller's shell options.
|
|
# ============================================================
|
|
|
|
DOCTOR_SKILLS_LIB_DIR="$(cd -P "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
|
|
|
if ! declare -F warn >/dev/null 2>&1; then
|
|
YELLOW='\033[1;33m'; NC='\033[0m'
|
|
warn() { echo -e "${YELLOW}⚠${NC} $1"; }
|
|
fi
|
|
|
|
# skill_catalog_stats <skills_dir> — see file header.
|
|
skill_catalog_stats() {
|
|
local dir="$1" census="$DOCTOR_SKILLS_LIB_DIR/skill-routing-census.py"
|
|
local out rc
|
|
out=$(python3 - "$dir" "$census" <<'PY'
|
|
import glob, importlib.util, sys
|
|
|
|
skills_dir, census_path = sys.argv[1], sys.argv[2]
|
|
spec = importlib.util.spec_from_file_location(
|
|
"skill_routing_census", census_path)
|
|
module = importlib.util.module_from_spec(spec)
|
|
spec.loader.exec_module(module)
|
|
|
|
paths = glob.glob(skills_dir + "/*/SKILL.md")
|
|
paths += glob.glob(skills_dir + "/pack-*/skills/*/SKILL.md")
|
|
chars = sum(len(module.extract_description(p) or "") for p in paths)
|
|
print(len(paths), chars)
|
|
PY
|
|
)
|
|
rc=$?
|
|
if [ "$rc" -eq 0 ]; then
|
|
echo "$out"
|
|
return 0
|
|
fi
|
|
warn "skill_catalog_stats: python failed (rc=$rc) — showing 0 0" >&2
|
|
echo "0 0"
|
|
return 0
|
|
}
|