Skip to content

platform: add eval fabric governance follow-up and root discoverability#16

Merged
mdheller merged 4 commits intomainfrom
eval-fabric-followup-mainline
Apr 11, 2026
Merged

platform: add eval fabric governance follow-up and root discoverability#16
mdheller merged 4 commits intomainfrom
eval-fabric-followup-mainline

Conversation

@mdheller
Copy link
Copy Markdown
Member

@mdheller mdheller commented Apr 9, 2026

Summary

Carry the next eval-fabric follow-up onto the current main base.

This PR combines three tightly related pieces:

  1. governance/provenance schemas under schemas/eval/
  2. concrete example payloads and governance notes
  3. root-doc discoverability and unified-local-default updates so the lane is visible from repo entrypoints

Why

The eval-fabric bootstrap is already merged into main, but the next platform step needs both:

  • trustworthy provenance objects (ReproLedgerEntry, CausalAttribution, MethodologySnapshot, MetricCrosswalk)
  • and repo-entrypoint visibility so the lane is not buried for platform operators

Scope

Files included:

  • README.md
  • apps/eval-fabric-api/README.md
  • docs/ARCHITECTURE.md
  • docs/LOCAL_DEV_EVAL_FABRIC.md
  • docs/ROADMAP.md
  • docs/EVAL_FABRIC_GOVERNANCE.md
  • governance/provenance schemas under schemas/eval/
  • example payloads under schemas/eval/examples/

Notes

This PR intentionally does not yet wire these objects into runtime API responses or the score pipeline. It prepares the platform repo with the discoverability and contract layer needed for that next implementation pass.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR extends the platform’s eval-fabric lane by adding governance/provenance contract schemas + examples, and by improving “repo entrypoint” discoverability so platform operators can find and run the lane from the top-level docs.

Changes:

  • Added eval-fabric governance/provenance JSON schemas and example payloads under schemas/eval/.
  • Added/updated governance notes and roadmap items describing the next eval-fabric platform steps.
  • Updated repo entrypoints (root README, architecture docs, local-dev runbook, eval-fabric-api README) to make the unified, DB-backed local path the default.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
README.md Adds eval-fabric lane section + links to key entrypoints and unified compose.
docs/ROADMAP.md Extends roadmap to include eval-fabric promotion + governance wiring follow-ups.
docs/LOCAL_DEV_EVAL_FABRIC.md Updates the default local-dev instructions to the unified compose + correct port (8082).
docs/ARCHITECTURE.md Documents eval-fabric as a first-class platform lane with landing points and responsibility split.
apps/eval-fabric-api/README.md Declares the unified DB-backed runtime path as the preferred default.
docs/EVAL_FABRIC_GOVERNANCE.md Explains the purpose of the new governance/provenance objects under schemas/eval/.
schemas/eval/*.schema.json Introduces governance/provenance schema contracts (and related eval schema anchors).
schemas/eval/examples/*.example.json Adds concrete example payloads for the governance/provenance objects.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread README.md
Comment thread README.md Outdated
@mdheller
Copy link
Copy Markdown
Member Author

@copilot apply changes based on the comments in this thread

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: mdheller <21163552+mdheller@users.noreply.github.com>
@mdheller
Copy link
Copy Markdown
Member Author

@copilot apply changes based on the comments in this thread

@mdheller
Copy link
Copy Markdown
Member Author

@copilot please fix the conflicts mentioned above.

Signed-off-by: mdheller <21163552+mdheller@users.noreply.github.com>
@mdheller mdheller merged commit 8b0c856 into main Apr 11, 2026
10 checks passed
@mdheller mdheller deleted the eval-fabric-followup-mainline branch April 11, 2026 19:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants