Repository navigation
docs(plans): the conformity spec and its verified review, with what shipped - #434
Merged
Merged
Conversation
…hipped Two planning documents that stayed untracked in the main checkout: - plans/conformity-spec.md: the design of KafkaReference and POST /api/conformity/check. A "Shipped" row now names the PRs that delivered it (#407 to #416, then #419 to #433), and its file references point at cli/examples/conformity, where the schema and examples live. Its inline examples stay as the 2026-10-19 drafts and say so. - plans/conformity-enhancements.md: the four-lens review of 2026-10-20, 29 verified findings. An Outcome table maps each finding to the PR that fixed it: 17 fixed, 2 partly covered by the book chapter, 10 open. The draft schema and examples in plans/conformity/ are left out: the shipped copies in cli/examples/conformity supersede them, and the draft schema lacks kafka.source and topics.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
These two planning documents stayed untracked in the main checkout. This PR commits them next to
plans/mcp-server.md, updated to say what shipped.plans/conformity-spec.mdis the design ofKafkaReferenceandPOST /api/conformity/check.cli/examples/conformity/, where the schema and examples live.plans/conformity-enhancements.mdis the review of 2026-10-20: four lenses, each finding checked by a verifier, 29 confirmed.Left out:
plans/conformity/, which holds the draft schema and examples. The shipped copies incli/examples/conformity/supersede them, and the draft schema lackskafka.sourceandtopics. Committing both would leave two diverging schemas in the repository.Checked: every finding id appears in the outcome table (29 of 29). Each PR mapping comes from that PR's description, and every cited PR is merged. No CI job reads
plans/.