validate

/validate — the CI this repo doesn't have

Run every check below in order and report a PASS/FAIL table at the end. A FAIL doesn't block you mid-run — collect them all, then fix or justify each. The checks are copy-paste snippets; run them from the repo root.

Guard first. This command validates the claude-plugins repo itself. If the current repo isn't it, stop:

[ -f .claude-plugin/marketplace.json ] && [ -d sonu/skills ] \
  && echo "OK: claude-plugins repo" || echo "STOP: not the claude-plugins repo — /validate has nothing to check here"

1. Manifests parse and stay in sync

All four JSON manifests must parse; the two plugin.json files must be identical; versions must match everywhere they appear:

for f in .claude-plugin/marketplace.json .cursor-plugin/marketplace.json \
         sonu/.claude-plugin/plugin.json sonu/.cursor-plugin/plugin.json; do
  python3 -m json.tool "$f" >/dev/null && echo "PARSE OK: $f" || echo "FAIL: $f does not parse"
done
diff <(python3 -m json.tool sonu/.claude-plugin/plugin.json) \
     <(python3 -m json.tool sonu/.cursor-plugin/plugin.json) \
  >/dev/null && echo "SYNC OK: plugin.json pair identical" || echo "FAIL: the two plugin.json files differ"

2. Every description mentions every component (and counts them honestly)

The plugin description must name every command and skill (this is the drift that has actually happened — twice). It must also not lie about how many there are: the description pitches "N skills", and a hardcoded number goes stale the moment a skill is added, so the count is checked against reality too.

All four description homes are checked, not just the marketplaces. The two plugin.json files carry the same user-facing text; checking only the marketplaces would let the pair drift and still pass:

python3 - <<'EOF'
import json, os, re, sys
commands = sorted(f[:-3] for f in os.listdir('sonu/commands') if f.endswith('.md'))
skills   = sorted(d for d in os.listdir('sonu/skills') if os.path.isdir(f'sonu/skills/{d}'))
homes = {
    '.claude-plugin/marketplace.json':  lambda d: d['plugins'][0]['description'],
    '.cursor-plugin/marketplace.json':  lambda d: d['plugins'][0]['description'],
    'sonu/.claude-plugin/plugin.json':  lambda d: d['description'],
    'sonu/.cursor-plugin/plugin.json':  lambda d: d['description'],
}
fails = 0
texts = {}
for mf, pick in homes.items():
    desc = pick(json.load(open(mf)))
    texts[mf] = desc
    missing = [c for c in commands if c not in desc] + [s for s in skills if s not in desc]
    if missing:
        fails += 1
        print(f"FAIL: {mf} description omits: {', '.join(missing)}")
    else:
        print(f"OK: {mf} mentions all {len(commands)} commands + {len(skills)} skills")
    claimed = re.search(r'(\d+) skills', desc)
    if not claimed:
        print(f"OK: {mf} claims no skill count (nothing to drift)")
    elif int(claimed.group(1)) != len(skills):
        fails += 1
        print(f"FAIL: {mf} says '{claimed.group(1)} skills' but {len(skills)} exist")
    else:
        print(f"OK: {mf} skill count ({len(skills)}) matches reality")
if len(set(texts.values())) != 1:
    fails += 1
    print("FAIL: the four descriptions are not identical — /release Phase 2 syncs them")
else:
    print("OK: all four description homes carry identical text")
sys.exit(1 if fails else 0)
EOF