[EVIDENCE-011] Run fixture-backed Web API pilot - #3580
Conversation
❓ Code Generation Drift DetectionStatus: Automated by AE-Framework Codegen |
Generate Artifacts PreviewGenerated at: 2026-07-01T10:47:40.733Z
|
KvOnce Trace Validation
|
There was a problem hiding this comment.
Pull request overview
Adds a deterministic, fixture-backed Web API pilot (EVIDENCE-011) for Issue #3572 using the existing web-api-bff domain preset, and checks in the full evidence chain (contract fixture, rendered preset report, ExecPlan v2, measurement report, and reviewer-facing surfaces) without introducing any runtime API endpoint.
Changes:
- Added a new Web API pilot report and a complete set of schema-backed pilot fixtures under
fixtures/evidence-sprint/web-api-pilot/. - Registered the new ExecPlan v2 / measurement report / domain preset report fixtures in the JSON validation harness.
- Updated root/docs READMEs to include the pilot in the “product evidence route” while preserving report-only boundaries.
Reviewed changes
Copilot reviewed 11 out of 11 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| scripts/ci/validate-json.mjs | Registers the new Web API pilot JSON fixtures for schema validation. |
| README.md | Updates the product-evidence route and pointers to include the fixture-backed Web API pilot. |
| docs/README.md | Links the new pilot report from the documentation index and updates the recommended evidence route. |
| docs/product/EVIDENCE-SPRINT-WEB-API-PILOT-2026-07-01.md | Adds the pilot report/scope memo documenting boundaries, evidence path, metrics snapshot, and verification plan. |
| fixtures/evidence-sprint/web-api-pilot/api-contract.md | Adds the report-only API contract fixture (GET /internal/evidence-sprint/pilots/{pilotId}) used for reviewer-visible contract evidence. |
| fixtures/evidence-sprint/web-api-pilot/domain-preset-report.json | Adds rendered domain-assurance-preset-report/v1 JSON for the web-api-bff preset. |
| fixtures/evidence-sprint/web-api-pilot/domain-preset-report.md | Adds rendered Markdown version of the domain preset report for human review. |
| fixtures/evidence-sprint/web-api-pilot/exec-plan.v2.json | Adds the ExecPlan v2 fixture connecting issue intent, tasks, evidence requirements, verification, and closeout boundaries. |
| fixtures/evidence-sprint/web-api-pilot/measurement-report.json | Adds the schema-backed Evidence Sprint measurement report fixture for the pilot. |
| fixtures/evidence-sprint/web-api-pilot/pr-assurance-review.md | Adds the reviewer-facing traceability preview/checklist for the pilot evidence chain. |
| fixtures/evidence-sprint/web-api-pilot/verification-evidence.md | Adds the deterministic verification command set and recorded pre-publication local verification status. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 1cf9c6145f
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
❓ Code Generation Drift DetectionStatus: Automated by AE-Framework Codegen |
d13d453 to
05aea47
Compare
❓ Code Generation Drift DetectionStatus: Automated by AE-Framework Codegen |
Summary
Closes #3572. Parent epic: #3567.
This PR runs EVIDENCE-011 as a deterministic, fixture-backed Web API pilot because #3572 did not specify a live runtime API target. It applies the existing
web-api-bffdomain preset and records the evidence chain needed for a later case study.Changes
docs/product/EVIDENCE-SPRINT-WEB-API-PILOT-2026-07-01.mdas the Web API pilot report and scope memo.fixtures/evidence-sprint/web-api-pilot/:GET /internal/evidence-sprint/pilots/{pilotId}as a report-only fixture.domain-assurance-preset-report/v1JSON/Markdown fromtemplates/domain-presets/web-api-bff/preset.json.scripts/ci/validate-json.mjs.README.mdanddocs/README.mdwhile preserving the report-only / unsupported-claim boundary.Acceptance coverage
api-contract.md, the pilot report, and the PR assurance review preview.schema/evidence-sprint-measurement-report.schema.json.Boundaries
Validation
node scripts/domain-presets/render-preset.mjs --preset templates/domain-presets/web-api-bff/preset.json --generated-at 2026-07-01T00:00:00.000Z --output-json fixtures/evidence-sprint/web-api-pilot/domain-preset-report.json --output-md fixtures/evidence-sprint/web-api-pilot/domain-preset-report.mdnode scripts/exec-plan/validate-v2.mjs --file fixtures/evidence-sprint/web-api-pilot/exec-plan.v2.json --no-writenode scripts/ci/validate-json.mjspnpm -s run check:schemaspnpm -s run check:doc-consistencypnpm -s run docs:lintpnpm -s run types:checkpnpm -s run context-pack:validatepnpm -s run context-pack:verify-boundary-mappnpm -s run verify:litegit diff --checkgit diff --cached --checkverify:litecompleted with the repository's existing lint baseline in warn-only mode.Rollback
Revert this PR to remove the #3572 docs/fixtures/navigation updates and the validate-json fixture registrations. No runtime state, migration, or policy enforcement rollback is required.