Skip to content

docs(plans): the conformity spec and its verified review, with what shipped - #434

Merged
bmscomp merged 1 commit into
mainfrom
docs/conformity-plans
Oct 20, 2026
Merged

bmscomp merged 1 commit into
mainfrom
docs/conformity-plans

Conversation

@bmscomp

@bmscomp bmscomp commented Oct 20, 2026

Copy link
Copy Markdown
Owner

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.md is the design of KafkaReference and POST /api/conformity/check.

plans/conformity-enhancements.md is 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 in cli/examples/conformity/ supersede them, and the draft schema lacks kafka.source and topics. 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/.

…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.
@bmscomp
bmscomp merged commit 36d2699 into main Oct 20, 2026
52 checks passed
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.

1 participant