Files
boshu2__agentops/scripts/check-paths-resolver-coverage.sh
Bo 5d61bf8a3f fix: kill the shared-config gremlin class (hook-safe repo-root, git-env scrubbing, config-hygiene gate) (#922)
Fixes the three gremlins observed 2026-07-18 (bead
age-gate-scripts-worktree-gitdir-p62wo):

1. **Gate scripts broke under hook env from linked worktrees** (#919
regression): new scripts/lib/repo-root.sh (GIT_*-scrubbed resolution,
BASH_SOURCE anchor, worktree-correct) swept across 32 scripts. Proof:
this PR's own push ran the pre-push gates from a linked worktree and
passed.
2. **core.bare=true recurrence**: mechanism proven (leaked GIT_DIR +
no-arg git init --bare rewrites the SHARED config); writer traced with
high confidence to a live Gas City city process (concrete suspect:
gascity cmd_rig_test.go runGitInTest, unscrubbed env + no-arg init
--bare — fork-side fix filed separately). Defense: new
always.git-config-hygiene gate fails fast on core.bare/test identities
with the repair command inline (--self-test proves fail-closed).
3. **Test/test@test.com identity leak**: writer convicted — our own
pre-push chain leaked GIT_DIR into go test, whose helpers wrote the
shared config via git -C (mechanism proven). Cut at both ends:
validate-go-fast scrubs env for children; every test git-helper set-site
scrubs; check-test-isolation gains a WARN-ratchet rule (baseline 3 →
FAIL at 0).

Gates: shellcheck rc=0 across 36 scripts; go build/vet clean;
655+379+149 tests; hygiene self-test; both originally-failing validators
pass under the repro env.
2026-07-18 18:20:16 -04:00

90 lines
3.3 KiB
Bash
Executable File

#!/usr/bin/env bash
# check-paths-resolver-coverage.sh — Warn-only ratchet for soc-irg1.5.
#
# Counts how many executable-code surfaces still hardcode `.agents/` paths
# instead of sourcing the canonical state-path resolver:
# - lib/ao-paths.sh (shell side, soc-irg1.1)
# - cli/internal/paths/*.go (Go side, soc-irg1.1)
#
# Surfaces measured (executable code that COMPUTES paths):
# cli/cmd/ao — non-test ao subcommands
# cli/internal — non-test internal Go packages
# hooks — bash hook scripts
# lib — bash helper libraries
# scripts — release / validation / maintenance scripts
#
# Surfaces deliberately NOT measured (path strings here are usually content,
# not constructions, or are auto-generated):
# *_test.go — fixture paths legitimately reference .agents/
# skills/, skills-codex/, docs/ — markdown prose and examples
#
# Exit code: ALWAYS 0 (warn-only, per warn-then-fail-ratchet pattern).
# Flip to blocking is a separate decision after 2+ weeks of baseline data —
# see GOALS.md ("Fitness gate: state-path-resolver-coverage") and
# .agents/patterns/2026-05-01-state-path-resolver.md for context.
#
# Pattern: see .agents/patterns/pre-tag-ci-validation.md and
# warn-then-fail-ratchet for the lifecycle convention.
set -uo pipefail
# shellcheck disable=SC1007,SC1091
. "$(CDPATH= cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/lib/repo-root.sh"
REPO_ROOT="$(resolve_repo_root)"
cd "$REPO_ROOT" 2>/dev/null || exit 0
SURFACES=("cli/cmd/ao" "cli/internal" "hooks" "lib" "scripts")
count_surface() {
# Counts string-literal occurrences of "\.agents/ — i.e. each line that
# constructs or references a hardcoded .agents/ path string. Per-line
# (not per-file) so chipping away at long files is visible in the metric.
local surface="$1"
[[ -d "$surface" ]] || { echo 0; return; }
case "$surface" in
cli/cmd/ao|cli/internal)
# Go: skip *_test.go (fixture paths are intentional).
grep -rn '"\.agents/' "$surface/" 2>/dev/null \
| grep -v ':.*_test\.go:' \
| grep -v '^[^:]*_test\.go:' \
| wc -l
;;
*)
grep -rn '"\.agents/' "$surface/" 2>/dev/null | wc -l
;;
esac
}
declare -A counts
total=0
for surface in "${SURFACES[@]}"; do
n=$(count_surface "$surface")
counts[$surface]=$n
total=$((total + n))
done
# Compact one-line metric (parseable by tooling) + pretty per-surface line.
printf 'state-path-resolver-coverage total=%d by-surface:' "$total"
for surface in "${SURFACES[@]}"; do
printf ' %s=%d' "$surface" "${counts[$surface]}"
done
printf '\n'
# Long form, one surface per line, for human review when run manually.
if [[ "${VERBOSE:-0}" == "1" ]] || [[ -t 1 ]]; then
printf '\n'
printf ' %-15s %5s\n' "surface" "files"
printf ' %-15s %5s\n' "---------------" "-----"
for surface in "${SURFACES[@]}"; do
printf ' %-15s %5d\n' "$surface" "${counts[$surface]}"
done
printf ' %-15s %5d\n' "TOTAL" "$total"
printf '\n'
printf ' Status: warn-only (gate exit 0 always).\n'
printf ' Migration target: 0 hardcoded ".agents/" sites in executable surfaces.\n'
printf ' See .agents/patterns/2026-05-01-state-path-resolver.md.\n'
fi
# Warn-only — never fail the gate during the baseline window.
exit 0