feat: add file arguments to check command

[rhuanbarreto]

Summary

• Adds positional file arguments to archgate check that scope rule execution to specific files
• When files are provided, only ADRs whose files glob patterns match are executed; unmatched ADRs are skipped
• Supports stdin piping for integration with git and other tools
• Uses existing safePath() security gates for path validation

Usage

# Single file
archgate check src/foo.ts

# Multiple files
archgate check src/foo.ts src/bar.ts

# Piped from git
git diff --name-only | archgate check --json

# Combined with other flags
archgate check --json --adr ARCH-001 src/foo.ts

Motivation

Editor integrations (VS Code, Cursor) need to run archgate check on file save. Without file scoping, every save runs all rules against the entire codebase. With file arguments, only relevant ADRs fire and scopedFiles is narrowed to the specified files — significantly faster for large projects.

Companion PR: archgate/plugins#34 (VS Code extension with live diagnostics)

Changes

File	Change
src/commands/check.ts	Add [files...] variadic argument, read stdin when piped
src/engine/runner.ts	Accept files option, resolve to relative paths, intersect with scopedFiles, skip ADRs with no match
tests/integration/check.test.ts	Add 3 tests: single file, multiple files, and ADR skipping when files are out of scope

Test plan

• archgate check src/foo.ts --json returns only violations for src/foo.ts
• archgate check src/a.ts src/b.ts --json checks both files
• archgate check docs/readme.md --json skips ADRs scoped to src/**/*.ts
• echo "src/foo.ts" | archgate check --json works via stdin pipe
• archgate check --json (no args) still checks everything
• Existing tests pass (no regression)

🤖 Generated with Claude Code

[cloudflare-workers-and-pages]

Deploying archgate-cli with    Cloudflare Pages

Latest commit:	a879aaa
Status:	✅  Deploy successful!
Preview URL:	https://73cc2986.archgate-cli.pages.dev
Branch Preview URL:	https://feat-check-file-flag.archgate-cli.pages.dev

View logs