gates

Gates

Mechanical pass/fail checks. No judgment, no opinions - compiler, linter, and tests either pass or they don't. Run before code reviews, after fix batches, and before PRs.

Read REFERENCE.md §1 "Why mechanical gates" for rationale.

Input

$ARGUMENTS = optional scope hint (extension for TS-only, dotnet for C#-only). Default: all applicable gates.

Process

Step 1: Detect What Changed

git diff --name-only main...HEAD

Categorize: .cs -> .NET gates; .ts/.js -> TypeScript gates; both -> all. If $ARGUMENTS specifies a scope, use that.

Step 1.5: Preflight Toolchain & Output Discipline

Before running any gate, confirm its toolchain is on PATH. A missing toolchain is a FAIL, never a SKIP - never report a TS gate as PASS or SKIP when npm is missing.

command -v dotnet >/dev/null 2>&1 || { echo "FAIL (preflight): dotnet missing"; exit 1; }  # if .NET gates scheduled
command -v npm >/dev/null 2>&1 || {
  command -v fnm >/dev/null 2>&1 && eval "$(fnm env --shell bash)" || true
  command -v npm >/dev/null 2>&1 && echo "preflight: self-healed via fnm activation" \
    || { echo "FAIL (preflight): npm missing"; exit 1; }
}  # if TS gates scheduled

Never pipe gate commands through tail/head/grep without set -o pipefail. The trailing command's exit code masks the real one. Read REFERENCE.md §8 "Preflight + pipefail" for safe truncation patterns.

Step 2: Run Gates

Gate 1: .NET Build (if C# changed)

dotnet build PPDS.sln -v q

Pass: 0 errors. On "used by another process", Read REFERENCE.md §2 "File-locking recovery".

Gate 2: .NET Tests (if C# changed)

dotnet test PPDS.sln --filter "Category!=Integration" -v q --no-build

Pass: 0 failures. Fail: report failing test names and assertion messages.

Gate 3: TypeScript Build (if TS/JS changed)

npm run compile --prefix src/PPDS.Extension

Pass: 0 errors.

Gate 3.5: TypeScript Type Check (if TS/JS changed)

npm run typecheck:all --prefix src/PPDS.Extension

Pass: 0 errors across host and webview tsconfigs. Read REFERENCE.md §3 "Compile vs typecheck" for why this is separate.