feat(mcp,rd): add structured output and cct parity metadata #20
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| name: Parity guards | |
| # Three CLAUDE.md §3 / §10 contracts enforced as required CI gates, | |
| # independent of the main ci-cd.yml pipeline so they show up as their own | |
| # required checks on PRs and never get diluted by the unrelated test matrix: | |
| # | |
| # 1. reference_parity — numerical alignment with R / Stata / paper anchors | |
| # 2. registry_drift — registry public-function count + submodule count | |
| # stays within the README floor (1000+ / 80) | |
| # 3. citation_audit — every arXiv / NBER / DOI claim in src/ + docs/ | |
| # verifies against primary sources (zero phantom refs) | |
| on: | |
| push: | |
| branches: [main] | |
| pull_request: | |
| branches: [main] | |
| workflow_dispatch: | |
| concurrency: | |
| group: parity-${{ github.ref }} | |
| cancel-in-progress: true | |
| jobs: | |
| reference-parity: | |
| name: Numerical reference parity | |
| runs-on: ubuntu-latest | |
| timeout-minutes: 30 | |
| steps: | |
| - uses: actions/checkout@v4 | |
| - name: Set up Python | |
| uses: actions/setup-python@v5 | |
| with: | |
| python-version: "3.10" | |
| - name: Cache pip | |
| uses: actions/cache@v4 | |
| with: | |
| path: ~/.cache/pip | |
| key: ${{ runner.os }}-parity-pip-${{ hashFiles('**/pyproject.toml') }} | |
| restore-keys: | | |
| ${{ runner.os }}-parity-pip- | |
| - name: Install | |
| run: | | |
| python -m pip install --upgrade pip | |
| pip install -e ".[dev]" | |
| - name: Run reference_parity suite | |
| run: | | |
| pytest tests/reference_parity/ -q --no-header | |
| registry-drift: | |
| name: Registry / API surface drift | |
| runs-on: ubuntu-latest | |
| timeout-minutes: 10 | |
| steps: | |
| - uses: actions/checkout@v4 | |
| - name: Set up Python | |
| uses: actions/setup-python@v5 | |
| with: | |
| python-version: "3.10" | |
| # ``[dev]`` is required: pyproject ``tool.pytest.ini_options.addopts`` | |
| # injects ``--cov`` unconditionally, which needs ``pytest-cov``. | |
| - name: Install | |
| run: | | |
| python -m pip install --upgrade pip | |
| pip install -e ".[dev]" | |
| - name: registry_stats --check | |
| run: | | |
| python scripts/registry_stats.py --check | |
| - name: dump_schemas --check (MCP cold-start bundle drift) | |
| # The MCP server serves tools/list + resources from the committed | |
| # schemas/ bundle on its cold-start fast path, gated only on a | |
| # matching statspai_version. Without this guard, a registry change | |
| # within the same version (e.g. a refactor between releases) drifts | |
| # the bundle silently and the server serves a stale tool list. This | |
| # check fails the build until the bundle is regenerated + committed. | |
| run: | | |
| python scripts/dump_schemas.py --check | |
| - name: API surface consistency | |
| run: | | |
| pytest tests/test_api_surface_consistency.py -q --no-header | |
| citation-audit: | |
| name: Citation audit (§10 zero-hallucination) | |
| # ``--strict`` would conflate "fabricated citation" (mismatch — the real | |
| # §10 red line) with "network glitch" (unresolved). Run in the default | |
| # mismatch-only mode so transient arxiv / crossref / NBER outages don't | |
| # paint the gate red. Unresolved entries are still surfaced in the | |
| # audit_report.md artifact for human follow-up. | |
| runs-on: ubuntu-latest | |
| timeout-minutes: 15 | |
| # Per-step ``paths-filter`` skips the network-heavy verification when no | |
| # citation-bearing file changed (e.g. rust/, benchmarks/, .gitignore). | |
| # This bounds outbound API load and reduces transient arxiv / crossref | |
| # outage flake on unrelated commits. | |
| steps: | |
| - uses: actions/checkout@v4 | |
| - name: Detect citation-bearing changes | |
| id: changes | |
| uses: dorny/paths-filter@v3 | |
| with: | |
| filters: | | |
| cite: | |
| - 'src/**' | |
| - 'docs/**' | |
| - 'paper.md' | |
| - 'paper.bib' | |
| - 'README.md' | |
| - 'README_CN.md' | |
| - 'CHANGELOG.md' | |
| - 'MIGRATION.md' | |
| - 'tools/audit_citations.py' | |
| - name: Set up Python | |
| if: steps.changes.outputs.cite == 'true' | |
| uses: actions/setup-python@v5 | |
| with: | |
| python-version: "3.10" | |
| - name: Install | |
| if: steps.changes.outputs.cite == 'true' | |
| run: | | |
| python -m pip install --upgrade pip | |
| pip install -e ".[dev]" | |
| - name: tools/audit_citations.py (mismatch-only) | |
| if: steps.changes.outputs.cite == 'true' | |
| run: | | |
| python tools/audit_citations.py | |
| - name: Upload audit report | |
| if: steps.changes.outputs.cite == 'true' && (success() || failure()) | |
| uses: actions/upload-artifact@v4 | |
| with: | |
| name: citation-audit-report | |
| path: audit_report.md | |
| if-no-files-found: ignore |