AI Reference Pack ZIP
Best for: AI chats, local models, agents, and project workspaces.
The ZIP contains per-source Markdown pages, combined Markdown, a schema-versioned manifest, referenced archived images, and checksums.sha256. When Include retrieval chunks is enabled, it also contains chunks.jsonl.
Retrieval chunks are structure-aware and model-neutral:
- a maximum of 800 estimated tokens;
- up to 120 estimated tokens of structural overlap;
- stable source and chunk IDs;
- heading ancestry, provenance, hashes, asset references, and untrusted-reference classification;
- table headers repeated when a table must be split;
token_count_method: "estimated_chars_div_4".
No embeddings are generated or included.
OKF v0.2 Bundle ZIP
Best for: standards-based knowledge catalogs and agents.
The root index.md contains canonical OKF v0.2 version metadata. Concepts carry type, title, provenance, SourceShelf metadata, and generated-by/generated-at values. Valid absolute HTTP(S) web provenance can appear as resource and sources; local file paths are never exported.
SourceShelf’s manifest includes hashes, modification dates, trust extensions, assets, and source order. Canonical OKF trust-lifecycle fields such as verified, status, and stale_after remain omitted because SourceShelf does not provide user-controlled lifecycle assertions.
Markdown Context Pack
Best for: portable one-file context.
This creates one Markdown file containing the pack’s readable sources in order. It is easy to inspect, version, attach, or paste into a system that does not understand ZIP bundles.
llms.txt Collection Folder
Best for: an inspectable local collection using the experimental llms.txt convention.
This requires a clean saved pack and creates a collision-safe <pack-name>-llms folder with an index, ordered documents, referenced archived assets, a SourceShelf manifest, and checksums. Unavailable sources with valid HTTP(S) provenance appear under ## Optional and are not fetched.
See Import and export llms.txt.
Copy Combined Markdown
Best for: quick prompt, chat, or document handoff.
The combined Markdown is copied immediately. Because this is a successful pack delivery, SourceShelf records a living-pack baseline after the clipboard operation completes.
Checksums and validation
AI and OKF ZIPs and llms.txt folders contain a deterministic checksums.sha256, sorted by relative path and covering every generated file except the checksum inventory itself. SourceShelf validates ordering, identifiers, hashes, provenance, and asset references before writing.
ZIP and llms.txt folder workflows run fresh Trust & Safety. Markdown and clipboard workflows keep their immediate behavior.