Skip to content

repository-map.md

Latest commit

 

History

History
85 lines (71 loc) · 6.18 KB

repository-map.md

File metadata and controls

85 lines (71 loc) · 6.18 KB
Raw

Repository Map

Status: Source-reviewed map; deployment acceptance is separate Reviewed: 2026-09-07 (initial map 2026-05-20; sidestr row refreshed 2026-10-01)

VisionFlow is a federated ecosystem. No single repository contains the whole runtime.

Repository Local path Role Primary docs entry
VisionFlow ../VisionFlow Ecosystem guide, public website, coordination architecture README.md, docs/ecosystem-map.md
VisionClaw ../project Knowledge engineering, OWL + SHACL reasoning, W3C PROV-O provenance, GPU graph physics, XR, MCP tools, broker kernel/REST/ACSP integration and agent-event beam renderer (gluon deferred; legacy BrokerActor is not the current implementation) README.md, docs/PRD-010-did-nostr-mesh-federation.md, docs/PRD-014-ecosystem-productionisation.md, docs/PRD-015-ecosystem-code-hygiene.md
agentbox ../project/agentbox Sovereign agent runtime, Nix container, skills/tools, Solid pod and Nostr bridge README.md, docs/developer/ecosystem.md, docs/developer/identity-mesh.md
solid-pod-rs ../solid-pod-rs Solid/JSS foundation library and server: LDP, WAC, NIP-98, DID:Nostr, git pods README.md, crates/solid-pod-rs/docs/explanation/ecosystem-integration.md, crates/solid-pod-rs/GAP-ANALYSIS.md
nostr-rust-forum ../nostr-rust-forum Forum kit, Cloudflare Workers, passkey auth, relay, governance UI README.md, docs/architecture.md, docs/consumer-surface-map.md
dreamlab-ai-website ../dreamlab-ai-website DreamLab branded deployment and operator overlay for forum kit README.md, forum-config/ docs
vowl-wasm ../vowl-wasm Ontology visualisation WASM engine (clean-room Rust reimplementation of the VOWL notation, MIT, outside the AGPL boundary): OWL parsing, Barnes-Hut and SIMD force layout, render data; consumed by the corpus explorer; NGG1 and markdown-ontology paths feature-gated README.md
knowledgeGraph ../knowledgeGraph Published public knowledge graph corpus and build pipeline (ODbL-1.0 data, AGPL-3.0 pipeline); the OWL 2 TBox VisionClaw renders and the Loom grounds on; explorer frontend consumes vowl-wasm README.md
sidestr-rs ../sidestr-rs Rust port of Melvin Carvalho's sidestr sidechains: seven published AGPL crates for both header families, consensus, Nostr, wallets, level-2 rounds, Hitch channels and agent payments; activated assets, pools and prediction markets; an unpublished EVM rule. It is a library estate component, not a running substrate. The live sidestr:dreamlab instance and its interim JavaScript producer stay in agentbox config/sidechain (agentbox ADR-2112). README.md
visionGraph ../visionGraph Authoring vault and publishing pipeline for narrativegoldmine.com; its publish.yml builds the corpus explorer against the published vowl-wasm bundle (a publishing consumer; other explorer copies remain distinct) README.md, .github/workflows/publish.yml

Supporting and historical scope

The health roster is the authoritative list for nightly health collection, not a declaration that every repository is deployed together. The dated audit and Git/ADR census cover supporting source and historical obligations without adopting unrelated workspace projects.

Repository Local path Scope
Loom ../loom Roster component: Rust grounding facade; declared sibling RuVector dependency and generation-identity consumer contract
Dream Engine ../dream-machine Roster component: TypeScript toolkit/fork; distinct from Agentbox's Rust service and loaded annexe runner
WasmVOWL ../WasmVOWL Roster component: retained standalone demo, not an alias for the published vowl-wasm engine or embedded explorers
prose-sanitiser ../prose-sanitiser Roster tool package; invocation and publication integration must be traced separately
diagram-ir ../diagram-ir Roster diagram tool package; availability does not prove the topic-tree gate calls it
RuVector ../ruvector Consumed dependency source; local core, registry crates and Agentbox Postgres image are distinct identities
RuView ../RuView Optional sensing product/dependency review; simulation and firmware source do not establish hardware acceptance
Logseq history ../project4 (../logseq alias) Archived publisher lineage; current authoring/publishing owner is visionGraph

Dependency Direction

flowchart TB
    VF["VisionFlow\ncoordination docs"]
    VC["VisionClaw\nknowledge engineering"]
    AB["agentbox\nagent runtime"]
    SPR["solid-pod-rs\nSolid foundation"]
    NRF["nostr-rust-forum\nforum kit"]
    DLW["dreamlab-ai-website\nbranded deployment"]
    VW["vowl-wasm\nVOWL WASM engine (MIT)"]
    KG["knowledgeGraph\npublished corpus + pipeline"]
    VG["visionGraph\nauthoring vault + narrativegoldmine.com"]

    SPR --> VC
    SPR --> AB
    SPR --> NRF
    NRF --> DLW
    VW --> VG
    VW --> KG
    VG -->|"publish corpus artefacts"| KG
    VG -->|"ontology release producer"| VC

    AB -->|"agent-event ingestion"| VC
    VC -->|"broker REST and ACSP integration"| AB
    NRF -.->|"governance event contract, application acceptance partial"| VC
    AB -.->|"relay and pod seams, federation join points deferred"| NRF

    VF -.-> VC
    VF -.-> AB
    VF -.-> SPR
    VF -.-> NRF
    VF -.-> DLW
    VF -.-> VW
    VF -.-> KG
    VF -.-> VG
Loading

Ownership Rule

Protocol primitives should have one source of truth:

Primitive Preferred owner
Solid LDP, WAC, WebID, pod storage solid-pod-rs
DID:Nostr document/resolution primitives solid-pod-rs or a shared crate extracted from it
NIP-98 verification and replay contract shared crate, using the most complete implementation as reference
Agent Control Surface kinds 31400-31405 nostr-rust-forum, with schema consumed by agentbox and VisionClaw
Judgment Broker domain VisionClaw kernel and current adapters; legacy actor name is not runtime proof
Operator deployment config dreamlab-ai-website for DreamLab production; per-operator overlays elsewhere