Repository navigation
docs: the Dossier format, v0.1 draft - #51
Open
francescobianco wants to merge 2 commits into
Open
francescobianco wants to merge 2 commits into
francescobianco wants to merge 2 commits into
Conversation
Defines the dossier as an open, portable format: manifest, ledger, pages with provenance, compile/consult/audit, ownership and portability rules, conformance levels, and the gaps in gknowledge 0.3. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This branch has not been deployed
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.
Introduces
docs/dossier/SPEC.mdand JSON Schemas for its three records (manifest, ledger entry, page header).The dossier becomes the unit of work in gknowledge and an open format that other programs can implement: the folder is the truth, every compiled page has provenance by content hash, and the dossier travels (no secrets, no machine-specific paths, derived state in
.dossier/). Operations are named compile / consult / audit and mapped to the LLM-wiki ingest / query / lint.§12 lists where gknowledge 0.3 does not conform yet (SQLite-only ledger, API key inside the folder,
gknowledge.jsonmanifest, "project" naming). Those changes come in follow-up PRs; this one is documentation only.Schemas checked with
jsonschema(Draft 2020-12) against the examples in the spec, plus two invalid cases.🤖 Generated with Claude Code