meta docs: catch up with the pack migration and the model changes since - #18
Merged
Conversation
data-model.md still documented the retired file-per-record layout (works/<shard>/<slug>/work.json and friends) as current storage. It now describes the range-packed layout - slug is identity, the pack file is only storage, file names are range bounds, metafmt self-heals placement - and catches up with the model changes that landed since: work genres and role-qualified credits, added_at, the bare-or-region-scoped recording isbn[] and regional publishers[], person kind, the libex-import source type, and artifact schema_version 4 (work_genres) with its serve-side gating. overview.md: the data/ tree line, pkg/model's description and the new pkg/pack, metacheck/metafmt/metabuild rows (pack invariants, self-heal, added_at from the data instead of the retired --added git walk), and the Dockerfile line - the image ships no baked data since the poll-only boot landed. contributing-data.md: the check.yml description's id/shard-agreement wording.
KodeStar
changed the title
KodeStar
force-pushed
the
docs/meta-pack-layout
branch
from
August 9, 2026 12:12
c937b99 to
d3b5488
Compare
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
1 participant
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.
Companion to KodeStar/audiosilo-meta#1553 (the ai-verify prompt fix): the same pre-pack-migration staleness, in the docs site. data-model.md was the big one - it still taught the file-per-record layout as current storage and was missing everything from genres through artifact schema_version 4. Also touches overview.md (pack layout tree line, pkg/pack, tool table, no-baked-data Dockerfile line) and contributing-data.md (check.yml wording).
npm run buildgreen locally.Note: this PR briefly carried an unrelated commit (server+manager tag-arbitration docs) picked up from a diverged local main - rebased away; that work remains local to its own session.