How 8dionysus/tree-of-sophia works
Purpose and Entry Points
Tree of Sophia (ToS) is a source-first, version-controlled philosophical knowledge tree. It preserves source evidence and review history while producing inspectable nodes, relations, routes, and derived graph/read-model artifacts. Start at README.md; the domain source home is ToS/README.md. The bounded public path is ToS/zarathustra/public-entry/TINY_ENTRY_ROUTE.md, leading to ToS/zarathustra/prologue-1/TRILINGUAL_ENTRY.md.
Authority, Contracts, and Doctrine
Doctrine defines what may become canonical and how source-backed claims are modeled; JSON Schema contracts formalize interchange and validation boundaries. The canon is authoritative structured content, not a generated graph. Key paths: ToS/doctrine/NODE_CONTRACT.md, ToS/contracts/tos-node-contract.schema.json, ToS/canon/registries/predicates.csv. Canonical nodes are organized by kind (source, event, state, principle, concept, etc.) and relation packs connect them, e.g. ToS/canon/event/.../node.json and ToS/canon/relations/.../edges.csv.
Evidence Spine and Source Witnessing
Evidence enters through a source-witness model separating catalog metadata from restricted local payloads. Works, expressions, editions, items, fixity, rights, forensic reports, and provenance establish durable source addresses before semantic claims are promoted. Core paths: ToS/source-witnesses/catalog/catalog.manifest.json, ToS/source-witnesses/works/friedrich-nietzsche/also-sprach-zarathustra/work.json, ToS/source-witnesses/LOCAL_STORAGE_BOUNDARY.md. Server import and access requests are explicit operational boundaries rather than direct external-service integrations.
Corpus Intake and Golden Kernel
The repository develops two fronts: a broad world-philosophy corpus scaffold and a complete Zarathustra “golden growth kernel.” Candidate intake has tabular nodes, edges, segments, witnesses, and tensions; the kernel demonstrates source-to-review-to-canon practice without imposing Nietzsche-specific ontology globally. Paths: ToS/candidate-intake/thus-spoke-zarathustra/prologue-1/mode-b/, ToS/zarathustra/GOLDEN_GROWTH_KERNEL.md, ToS/source-witnesses/works/friedrich-nietzsche/also-sprach-zarathustra/gold-sets/foundation-pilot-v1/.
Philosophy Workbench and Promotion Flow
The philosophy tree supplies era/region/tradition branches and branch manifests. Research artifacts become prepared dossiers, proposed nodes/relations, review packets, then may be planted into canon. Primary flow: source witnesses and research packets → atlas/master tables → graph workbench proposals and review → canonical tree. Paths: ToS/philosophy/atlas/master-tables/, ToS/philosophy/graph-workbench/proposed-nodes/, scripts/plant_prepared_dossiers.py. Workbench graph views are planning/review projections, not canonical authority.
Derived Graph and Consumer Boundary
Canonical and source-owned records are transformed into derived exports and local KAG indexes for downstream graph/retrieval consumers. This is a one-way bounded seam: consumers such as aoa-kag may read exports but do not gain authority to write ToS canon. Paths: mechanics/boundary-bridge/parts/derived-kag-seam/scripts/generate_kag_export.py, ToS/derived-exports/kag_export.json, kag/manifest.json. Sharded JSONL indexes provide local provider-ready lookup material.
Operations, Validation, and Runtime Context
This is primarily a Git-backed data, documentation, and Python-validation repository—not a deployed web application. Repeatable governance operations live as mechanics with local contracts: threshold intake, canon restraint/promotion, review return, and relation promotion. Paths: mechanics/agon/parts/threshold-registry/, mechanics/canon-formation/parts/promotion-gate/, mechanics/relation-weaving/parts/graph-promotion/scripts/validate_tree_relation_pack.py. Python builders and validators under scripts/ are exercised by repository tests and GitHub Actions (.github/workflows/repo-validation.yml); neighboring AoA runtime, visualization, memo, eval, and stats systems remain external consumers or collaborators.
Main entry points: generate_kag_export.py KAG export generator · validate_tree_relation_pack.py Relation pack validator · NODE_CONTRACT.md Node doctrine · repo-validation.yml Repository validation workflow
Components 24
Entry & Doctrine
- Repository entry
README.md - ToS source home
ToS/README.md - Public entry route
ToS/zarathustra/public-entry/TINY_ENTRY_ROUTE.md - Trilingual entry
ToS/zarathustra/prologue-1/TRILINGUAL_ENTRY.md - Node doctrine · Defines canonical, source-backed claim rules.
ToS/doctrine/NODE_CONTRACT.md - Node schema
ToS/contracts/tos-node-contract.schema.json
Evidence & Intake
- Witness catalog · Catalogs durable source addresses separately from payloads.
ToS/source-witnesses/catalog/catalog.manifest.json - Zarathustra work witness
ToS/source-witnesses/works/friedrich-nietzsche/also-sprach-zarathustra/work.json - Local storage boundary · Restricted local payloads remain outside repository authority.
ToS/source-witnesses/LOCAL_STORAGE_BOUNDARY.md - Foundation gold set
- Candidate intake · Holds candidate nodes, edges, segments, witnesses, and tensions.
Knowledge Formation
- Predicate registry
ToS/canon/registries/predicates.csv - Golden growth kernel · Demonstrates source-to-review-to-canon practice.
ToS/zarathustra/GOLDEN_GROWTH_KERNEL.md - Atlas master tables
- Graph workbench proposals · Planning and review views are not canonical authority.
- Canonical tree · Canonical nodes by kind and relation packs form the source of authority.
- Canonical relation packs
Derived Consumer Seam
- KAG export generator
mechanics/boundary-bridge/parts/derived-kag-seam/scripts/generate_kag_export.py - KAG export · One-way consumer-readable projection of canonical and source-owned records.
ToS/derived-exports/kag_export.json - Local KAG index · Provider-ready local lookup material for downstream consumers.
kag/manifest.json
Governance & Validation
- Dossier planter
scripts/plant_prepared_dossiers.py - Promotion gate
- Relation pack validator
mechanics/relation-weaving/parts/graph-promotion/scripts/validate_tree_relation_pack.py - Repository validation workflow · Runs repository Python builders and validators.
.github/workflows/repo-validation.yml
Connections 25
- Repository entry → ToS source home: introduces
- ToS source home → Public entry route: exposes
- Public entry route → Trilingual entry: leads to
- Node doctrine → Node schema: formalized by
- Node doctrine → Canonical tree: governs
- Node schema → Canonical tree: validates
- Predicate registry → Canonical relation packs: constrains
- Witness catalog → Zarathustra work witness: catalogs
- Local storage boundary → Witness catalog: separates payloads from
- Zarathustra work witness → Foundation gold set: supports
- Foundation gold set → Candidate intake: supplies evidence to
- Candidate intake → Atlas master tables: synthesized in
- Atlas master tables → Graph workbench proposals: feeds
- Golden growth kernel → Graph workbench proposals: demonstrates workflow for
- Graph workbench proposals → Promotion gate: submitted through
- Promotion gate → Dossier planter: authorizes
- Dossier planter → Canonical tree: plants into
- Canonical relation packs → Relation pack validator: checked by
- Relation pack validator → Canonical tree: guards promotion into
- Canonical tree → Canonical relation packs: connected by
- Canonical tree → KAG export generator: exports through
- KAG export generator → KAG export: generates
- KAG export → Local KAG index: indexes into
- Repository validation workflow → Relation pack validator: runs
- Repository validation workflow → KAG export generator: exercises