7e2ecba219
- bin/pos: usage() CATEGORIES now auto-derived from pos-* filenames (kill the stale cheat-sheet bug class); only EXAMPLES stays hand-written - # POS: / # POS_FLAGS: headers on all 15 tools = single source of truth for generated docs; template updated - scripts/gen-docs.sh: regenerates GEN-marker sections (bin tree, dispatch table, no-common.sh list, line-count table, completion flags) - scripts/check-sync.sh: bash -n + exec bits + doc/code drift + smoke - Makefile: make gen / make check; scripts/install-hooks.sh: opt-in hook - DEV.md + AGENT_Context: add-a-tool flow is now header + make check
42 lines
1.8 KiB
Bash
Executable File
42 lines
1.8 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
set -euo pipefail
|
|
# Repo self-consistency check — run via `make check` (also as a pre-commit hook).
|
|
# bash -n every script, executability, doc<->code sync (gen-docs --check),
|
|
# and a dispatch smoke test. Exit 1 on any failure.
|
|
|
|
root="$(cd "$(dirname "$0")/.." && pwd)"
|
|
cd "$root"
|
|
|
|
fail=0
|
|
note() { echo " ✗ $*"; }
|
|
|
|
# ── 1. Syntax ───────────────────────────────────────────────────
|
|
for f in bin/pos bin/pos-* lib/*.sh install.sh preinstall.sh postinstall.sh \
|
|
completions/pos.bash scripts/*.sh; do
|
|
[ -f "$f" ] || continue
|
|
bash -n "$f" 2>/dev/null || { note "syntax error in $f"; fail=1; }
|
|
done
|
|
|
|
# ── 2. Executability ────────────────────────────────────────────
|
|
for f in bin/pos bin/pos-*; do
|
|
[ -x "$f" ] || { note "not executable: $f"; fail=1; }
|
|
done
|
|
|
|
# ── 3. Doc <-> code sync ────────────────────────────────────────
|
|
if ! bash scripts/gen-docs.sh --check >/dev/null 2>&1; then
|
|
note "doc/code drift — run 'make gen' and commit the regenerated files"
|
|
fail=1
|
|
fi
|
|
|
|
# ── 4. Dispatch smoke test ──────────────────────────────────────
|
|
bash bin/pos --help >/dev/null 2>&1 || { note "pos --help failed"; fail=1; }
|
|
bash bin/pos docker --help >/dev/null 2>&1 || { note "pos docker --help failed"; fail=1; }
|
|
bash bin/pos bogus >/dev/null 2>&1 && { note "pos bogus should have failed"; fail=1; }
|
|
|
|
if [ "$fail" -eq 0 ]; then
|
|
echo "check-sync: OK"
|
|
else
|
|
echo "check-sync: FAILED" >&2
|
|
exit 1
|
|
fi
|