Public Repo Migration Notes

This page tracks implementation status for the adaptation-pack rollout across AEEF public repositories.

Current rollout status (2026-03-01)

Repository	Branch	PR	Scope
AEEF-AI/aeef-cli	feat/adaptation-pack-mcp-a2a	https://github.com/AEEF-AI/aeef-cli/pull/1	Schemas, templates, hook evidence outputs, adaptation guide
AEEF-AI/aeef-quickstart	feat/adaptation-pack-mcp-a2a	https://github.com/AEEF-AI/aeef-quickstart/pull/1	Tier 1 schema additions and adaptation docs
AEEF-AI/aeef-transform	feat/adaptation-pack-mcp-a2a	https://github.com/AEEF-AI/aeef-transform/pull/1	Tier 2 schema additions and adaptation docs

What developers get after merge

1. Shared contract artifacts for HookContract, GateDecision, and RunLedgerEntry.
2. MCP-required and A2A-progressive guidance in each repo.
3. Better migration path from AEEF native orchestration to external orchestrators.
4. In aeef-cli, explicit run-evidence artifacts (run-ledger.jsonl, gate-decision.json).

Versioning notes

Use these merge points as baseline versions for adaptation:

• aeef-cli: first version containing ADAPTATION.md and new schemas.
• aeef-quickstart: first version containing optional adaptation schemas in shared/schemas/.
• aeef-transform: first version containing adaptation schemas and Tier 2 policy note.

Until tagged releases are cut, pin to commit SHAs from the PR merge commits.

Post-merge operator checklist

1. Pull latest main from each public repo.
2. Validate schema checks in CI (*.schema.json parse + artifact validation).
3. For aeef-cli, run a dry run and verify .aeef/runs/run-ledger.jsonl and .aeef/runs/gate-decision.json are emitted.
4. Update internal implementation docs to reference merged PR URLs and release tags.