Skip to content

docs: frame-inventory pages + package badges (0.3.0 follow-up) - #7

Merged
AimTune merged 2 commits into
mainfrom
docs/release-0.3.0-followups
Jul 28, 2026
Merged

docs: frame-inventory pages + package badges (0.3.0 follow-up)#7
AimTune merged 2 commits into
mainfrom
docs/release-0.3.0-followups

Conversation

@AimTune

@AimTune AimTune commented Jul 28, 2026

Copy link
Copy Markdown
Owner

Two docs fixes that belong to the 0.3.0 release. The first was written before the merge but lost by itgh pr merge on #6 merged the branch at its previous head, so commit 6264bc8 never landed. Cherry-picked here unchanged.

1. Carry the new frame family into the pages that list frames

#6 added the authoring guides but left the site's inventory pages describing the closed pre-0.3 wire:

  • concepts.md and protocol/overview.md printed PERSISTENT_FRAME_TYPES with no mention of the open rich-message entry
  • protocol/identity.md and persistence.md enumerated the persistent frames the watermark and transcript cover — without rich messages, which are persistent
  • protocol/event-mapping.md had no $mekik:"message" row, and its helper table was missing mount / choose / message
  • parity/conformance.md was missing the rich-message golden fixture

A reader landing on any of those would have concluded the frame list was closed. Also drops the "five helpers" claim in the helpers page, which #6 had already made false.

2. Package badges in the README

The README's only badge was CI, so nothing linked to what's actually published. Four badges — @mekik/core, @mekik/ws (npm), Mekik.Core, Mekik.AspNetCore (NuGet) — each rendering the live version, so they double as the answer to "what's the current release?". @mekik/langchain and @mekik/redis are left out on purpose: optional integrations, already in the layout section, and six badges would bury the CI one.

Verification

Docusaurus build clean (broken internal links fail that build). Docs-only — no source, no version, no wire change.

🤖 Generated with Claude Code

AimTune and others added 2 commits July 29, 2026 01:27
…ames

The feature commit added the authoring guides but left the site's *inventory*
pages describing the closed pre-0.3 wire: concepts, protocol overview, identity
and persistence all enumerated PERSISTENT_FRAME_TYPES without the open rich
message entry, the event-mapping tables had no `$mekik:"message"` row (nor
mount/choose/message in the helper table), and the conformance fixture table was
missing `rich-message`. A reader landing on any of them would have concluded the
frame list was closed.

Also drops the "five helpers" claim in the helpers page, which the same commit
had already made false.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
The README's only badge was CI, so a reader had no way to see — or click
through to — what's actually published. Four badges, one per package a consumer
installs directly: @mekik/core and @mekik/ws on npm, Mekik.Core and
Mekik.AspNetCore on NuGet. Each renders the live version, so they double as the
answer to "what's the current release?".

@mekik/langchain and @mekik/redis are left out deliberately: they're optional
integrations, listed in the layout section, and six badges would bury the CI one.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@AimTune
AimTune merged commit 389d019 into main Jul 28, 2026
4 checks passed
@AimTune
AimTune deleted the docs/release-0.3.0-followups branch July 28, 2026 22:29
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