setup

Project Setup — verification gate & reviewers

Create .psd/verify.json, the single per-project config that powers the Definition-of-Done gate (used by /lfg, the runtime-verifier agent, and the Stop hook) and the watch-until-clean loop. Without this file the gate and Stop hook are inert, so the plugin never disrupts a repo that hasn't opted in.

See docs/patterns/definition-of-done.md for the full schema.

Arguments: $ARGUMENTS

Phase 1: show / reset

CONFIG=".psd/verify.json"
case "$ARGUMENTS" in
  show)
    [ -f "$CONFIG" ] && { echo "=== $CONFIG ==="; cat "$CONFIG"; } || echo "No $CONFIG — gate inert (run /setup to create)."
    exit 0 ;;
  reset)
    rm -f "$CONFIG"; echo "Removed $CONFIG. Gate is now inert for this repo."; exit 0 ;;
esac
[ -f "$CONFIG" ] && { echo "=== existing $CONFIG ==="; cat "$CONFIG"; echo; }

Phase 2: Auto-detect commands

Detect the project's real commands before asking — propose, don't interrogate.

echo "=== detecting project commands ==="
if [ -f package.json ]; then
  for s in build lint typecheck test; do
    jq -e ".scripts.\"$s\"" package.json >/dev/null 2>&1 && echo "  $s → npm run $s"
  done
  jq -e '.devDependencies["@playwright/test"] // .dependencies["@playwright/test"]' package.json >/dev/null 2>&1 && echo "  e2e → npx playwright test"
fi
[ -f pyproject.toml ] || [ -f pytest.ini ] && echo "  test → pytest ; lint → ruff check ."
[ -f Cargo.toml ] && echo "  test → cargo test ; lint → cargo clippy -- -D warnings"
[ -f go.mod ] && echo "  test → go test ./... ; lint → go vet ./..."

Lint must be zero-warning — propose the warnings-as-errors form (eslint --max-warnings 0, ruff check, clippy -- -D warnings).

Phase 3: Auto-detect the AI reviewers

The watch-until-clean loop must know which reviewer logins to wait for. Detect them from recent PRs:

echo "=== recent PR reviewers (bots + humans) ==="
DEF=$(gh repo view --json defaultBranchRef --jq '.defaultBranchRef.name' 2>/dev/null || echo main)
for pr in $(gh pr list --state all --limit 10 --json number --jq '.[].number' 2>/dev/null); do
  gh api "repos/{owner}/{repo}/pulls/$pr/reviews" --jq '.[].user.login' 2>/dev/null
done | sort -u