allaun/Research-Stack
1
0
Fork 0
mirror of https://github.com/allaunthefox/Research-Stack.git synced 2026-07-31 03:05:21 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
Research-Stack/scripts/qc-flag/AGENTS.md
Brandon Schneider fd863af6fd Expand devcontainer with full Python stack, add MCP servers (Notion/AWS), strengthen Lean theorems 
- .devcontainer/Dockerfile: add PostgreSQL client libs, OpenSSL/libffi headers, gfortran/BLAS for scipy, rclone; install full Python dependency set (boto3, psycopg2-binary, fastapi, uvicorn, notion-client, httpx, pytest, numpy, scipy, etc.) in uv-managed venv; add rclone S3 gateway init script as ENTRYPOINT
- .devcontainer/devcontainer.json: switch from build to pre-built image (localhost/research
2026-05-19 01:52:14 -05:00

2.1 KiB
Raw Blame History

QC Flagger — AGENTS.md

Purpose

Automated code quality inspection for Lean files, implementing the Lean Expert Agent's 7-check inspection protocol.

Usage

# Run on a single file
python3 scripts/qc-flag/lean_qc_flagger.py path/to/file.lean

# Run on a directory (recursive)
python3 scripts/qc-flag/lean_qc_flagger.py path/to/dir/

# Save reports
python3 scripts/qc-flag/lean_qc_flagger.py path/to/file.lean --json report.json --markdown report.md

# Shell wrapper (saves dated reports to scripts/qc-flag/reports/)
bash scripts/qc-flag/run_qc_flag.sh path/to/file.lean
bash scripts/qc-flag/run_qc_flag.sh path/to/dir/ --verbose

Protocol Coverage

# Check Implementation
1 Structural Health theorem/def/eval/sorry counts, empty theorems, tautologies, unused imports, set_option suppressions
2 Naming Conventions PascalCase files/types, camelCase functions/theorems, banned prefixes/suffixes
3 Q16_16 Compliance Float usage in hot-path code. Historical contamination sites at BraidCross.lean:49,50,84 and BraidStrand.lean:57,71 are the canonical fixed-point constructor template. Flag any ofFloat outside JSON/sensor boundary shims.
4 Proof Quality defs without companion theorems, .get! without .isSome, native_decide coverage
5 Dependency Analysis Unused imports, circular and transitive circular dependencies
6 Compression Theorem Pair Every module defining a compression path MUST provide both eigensolid_convergence (crossing loop stabilizes) and receipt_invertible (receipt bijectively reconstructs original including zero/gap/timing dimensions). Flag missing pairs.
7 AGENTS.md Compliance Root AGENTS.md Compression First Principles apply to all Lean code. Check that no compute path uses ofFloat and that receipt dimensions are explicitly captured (C, σ, k, ε_seq, t, ∅_scars).

Output

  • JSON: structured per-file results with issue details
  • Markdown: human-readable report with summary table and issue tables
  • Exit code: 0 if all files pass, 1 if any file has ERROR-severity issues