Safari Reading List Wiki Home About Schema Log Sources

Docs

Readme

Safari Reading List Wiki

A source-preserving LLM Wiki built from Gal's Safari Reading List.

Start Here

  1. Open index.md for the compiled knowledge layer.
  2. Read SCHEMA.md for provenance and editorial rules.
  3. Browse immutable captured sources through raw/README.md.
  4. Consult log.md for the build and maintenance history.

Source Snapshot

  • Collector: srl export all (read-only Safari export)
  • Raw export: _meta/snapshots/reading-list-2026-08-09-raw.json
  • Canonical snapshot: _meta/snapshots/reading-list-2026-08-09.json
  • Source reconciliation: 113 Reading List rows → 112 unique Safari source records
  • Extraction corpus: 112/112 validated records — 102 complete and 10 explicit insufficient_source records
  • Assembled corpus: _meta/corpus.json
  • Synthesis layer: 34 navigable pages across 7 entities, 24 concepts, one comparison, and 2 query maps
  • Source routing: 99/102 complete records contribute to substantive synthesis pages; 3 source-only records have explicit preservation rationales in _meta/source-routing.json

Layering

  • raw/ — immutable article captures with original URL, Safari-local identity, capture date, and exact-body SHA-256.
  • entities/, concepts/, comparisons/, queries/ — concise, interlinked synthesis pages.
  • _meta/ — manifests, snapshots, delegated extraction artifacts, and the exact source-routing inventory used to make the build reproducible and auditable.

This vault works directly in Obsidian, VS Code, or any Markdown reader.

Verify the Build

cd /Users/gal/safari-wiki
python3 -m unittest discover -s tests -v
python3 scripts/lint_wiki.py --wiki . --output _meta/lint/latest.json

The linter checks synthesis-page frontmatter, taxonomy tags, raw-source references, wikilinks, index coverage, orphans, immutable raw-body hashes, and exact routing for every complete source record. It intentionally does not alter immutable raw/ sources.

Website

The wiki publishes as a static site at https://safari-wiki.pages.dev.

Rebuild and redeploy locally:

cd /Users/gal/safari-wiki
python3 -m venv .venv                 # once
.venv/bin/pip install markdown        # once
.venv/bin/python scripts/build_site.py --wiki . --output _site
npx wrangler pages deploy _site --project-name safari-wiki

scripts/build_site.py resolves Obsidian-style wikilinks, renders provenance badges, rewrites relative .md links, and generates the sidebar, client-side search, custom 404, and build-report.json. Raw article bodies are rendered verbatim and are never rewritten.