Reviewer evidence hardening checklist for route stability

[safal207]

Goal

Harden the LS Cognitive Trail route-stability reviewer path.

Current files

• docs/COGNITIVE_TRAIL_EVIDENCE_SNAPSHOT.md
• docs/ROUTE_STABILITY_SAMPLE_CONTRACT.md
• docs/ROUTE_STABILITY_EVIDENCE_MAP.md
• schemas/route_stability_sample.schema.json
• examples/route-stability/nash_route_stability_sample.json
• python/tests/fixtures/route-stability/invalid_metric_version.json
• scripts/run_nash_route_stability_demo.py
• python/tests/test_nash_route_stability.py
• .github/workflows/cognitive_trail_contract.yml

Checklist

• Add 2 or 3 additional route-stability fixtures.
• Add one fixture where the full cooperative route is not a stable candidate.
• Add a fixture for missing required route fields.
• Add a fixture for unsupported decision values.
• Add a short fixture interpretation note.
• Add CI summary lines that list checked fixture names.
• Add a fixture table to docs/ROUTE_STABILITY_EVIDENCE_MAP.md.
• Add a placeholder section for future human-review labels without claiming labels already exist.

Definition of Done

• PYTHONPATH=.:python:python/modules python -m pytest python/tests/test_nash_route_stability.py passes.
• python scripts/run_nash_route_stability_demo.py --json still matches the canonical sample for stable fields.
• New fixtures are accepted or rejected intentionally.
• docs/ROUTE_STABILITY_SAMPLE_CONTRACT.md and docs/ROUTE_STABILITY_EVIDENCE_MAP.md stay in sync.
• Non-claims remain explicit.

Boundary

This remains a route-stability proxy, not a formal proof of Nash equilibrium.

[safal207]

Progress update for issue #562.

Completed first evidence-hardening item:

Add a short fixture interpretation note.

Commits:

e458626 docs: add route stability fixture interpretation note
17c8862 docs: link route stability fixture interpretation note

Added:

docs/ROUTE_STABILITY_FIXTURE_INTERPRETATION.md

Linked from:

docs/ROUTE_STABILITY_EVIDENCE_MAP.md

What this adds:

• explains accepted sample meaning;
• explains negative fixture meaning;
• lists future useful fixture types;
• adds reviewer interpretation checklist;
• preserves the boundary: route-stability proxy, not a formal proof of Nash equilibrium.

Still open:

• add 2 or 3 additional route-stability fixtures;
• add one not-stable-candidate fixture;
• add missing-field negative fixture;
• add unsupported-decision negative fixture;
• add CI summary lines listing checked fixture names;
• add fixture table to docs/ROUTE_STABILITY_EVIDENCE_MAP.md once more fixtures exist;
• add future human-review labels placeholder without claiming labels already exist.

[safal207]

Progress update for issue #562.

Completed another checklist item:

Add a fixture for missing required route fields.

Commits:

e0a1a85 test: add missing route field stability fixture
99499e0 test: reject missing route field stability fixture
0dcccaa docs: document missing field route stability fixture
2659fd2 docs: list missing field route stability fixture in evidence map

Added:

python/tests/fixtures/route-stability/missing_full_route_reward.json

Test coverage:

test_nash_route_stability_schema_rejects_missing_route_field_fixture

Docs updated:

docs/ROUTE_STABILITY_FIXTURE_INTERPRETATION.md
docs/ROUTE_STABILITY_EVIDENCE_MAP.md

Still open:

• add 2 or 3 additional route-stability fixtures;
• add one not-stable-candidate fixture;
• add unsupported-decision negative fixture;
• add CI summary lines listing checked fixture names;
• add fixture table after more fixtures exist;
• add future human-review labels placeholder.