docs: Phase 36 README + docs/wiki refresh#20
Conversation
- Clarify Pages registry is authoritative now; schemas.coding-autopilot.dev migration is in progress (PR #18), not settled fact - Append docs-verified freshness footer
…sions) - Architecture.md documents the schema-versioning + Pages registry publishing pipeline, and the in-progress $id migration (PR #18) - Operations.md verified test/validate/build-registry/CI commands - Decisions.md indexes phase history and open PRs
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 3ae0a88d49
ℹ️ 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".
|
|
||
| Released schemas are discoverable from `https://coding-autopilot-system.github.io/cas-contracts/registry/index.json`. Use stable `registry/vMAJOR.MINOR` URLs for compatible updates or immutable `registry/releases/vMAJOR.MINOR.PATCH` URLs for reproducible builds. See [schema distribution](docs/DISTRIBUTION.md). | ||
| Authoritative schema identity remains under `https://schemas.coding-autopilot.dev/`; the GitHub Pages registry is the current live distribution endpoint. | ||
| The GitHub Pages registry above is the authoritative, resolvable distribution endpoint today. The 22 schema `$id` values currently in `schemas/` still point at `https://schemas.coding-autopilot.dev/`, a domain that is not presently resolvable; migrating those `$id` values to the resolvable Pages registry URL is in progress (PR #18, `fix(registry): rewrite schema $id to the resolvable Pages registry URL`). Until that PR merges, treat the Pages registry index — not the `schemas.coding-autopilot.dev` `$id` values — as the source of truth for schema identity. |
There was a problem hiding this comment.
$id as the schema identity
For consumers that key validators or caches by schema identity, this line reverses the current contract: docs/DISTRIBUTION.md says the schemas.coding-autopilot.dev $id values remain the stable identity while GitHub Pages is only the fetch location, and tests/registry.test.mjs asserts manifest IDs do not contain github.io. Telling readers to treat the Pages registry index instead of the published $id values as the source of truth will make them use identities that the current schemas and manifests do not advertise.
Useful? React with 👍 / 👎.
2 participants
Summary
schemas.coding-autopilot.devdomain as authoritative without qualification — states the Pages registry is authoritative today and the $id migration is in progress (PR fix(registry): rewrite schema $id to the resolvable Pages registry URL #18). Appenddocs-verifiedfreshness footer.docs/wiki/{Home,Architecture,Operations,Decisions}.md: schema-versioning + Pages registry publishing pipeline Mermaid, verified test/validate/build-registry/CI commands, decisions index highlighting PR fix(registry): rewrite schema $id to the resolvable Pages registry URL #18 as the highest-risk open item.All claims verified against
origin/mainat commit991c360,docs/DISTRIBUTION.md, andgh pr view 18.Test plan
Co-Authored-By: Claude Fable 5 noreply@anthropic.com