Skip to content

README.md

Latest commit

 

History

History
547 lines (427 loc) · 36.7 KB

README.md

File metadata and controls

547 lines (427 loc) · 36.7 KB
title VisionClaw Documentation
description Complete documentation for VisionClaw — the governed agentic mesh for real-time 3D knowledge graph exploration with GPU-accelerated physics, OWL 2 ontology reasoning, and multi-agent AI orchestration
updated-date 2026-05-05

VisionClaw Documentation

Real-time 3D knowledge graph exploration powered by Rust, CUDA GPU physics, OWL 2 ontology reasoning, and a multi-agent AI mesh.

← Back to Project | Quick Start | API Reference | Architecture

Quick Start

git clone https://github.com/DreamLab-AI/VisionClaw.git
cd VisionClaw && cp .env.example .env
./scripts/launch.sh up dev

./scripts/launch.sh up dev is the canonical launcher; the explicit fallback is docker compose -f docker-compose.unified.yml --profile dev up -d (docker-compose.unified.yml is the only compose file shipped).

Open http://localhost:3001 for the 3D graph interface and http://localhost:4000/api for the REST API. The graph store is the embedded Oxigraph triple store (ADR-11) — there is no separate database browser UI.

Full setup details: Deployment Guide

Known Issues: Before debugging unexpected behaviour, check KNOWN_ISSUES.md — it tracks active P1/P2 bugs including the Ontology Edge Gap (ONT-001) and V4 delta instability (WS-001).

Sovereign Mesh Sprint (2026-04-19)

Recent ship: Pod-backed knowledge graph sovereignty with Solid Pod integration, per-user Nostr identity, and Web Access Control. Six architectural decisions landed on main:

  • Pod-First Ingest: KGNode visibility + owner_pubkey + pod_url fields; private container default; Publish/Unpublish saga
  • NIP-98 Enterprise Auth: Optional auth mode with AccessLevel, caller-aware filters, legacy session deprecation
  • Solid WAC Default: /private, /public, /shared, /profile containers with double-gated writes

See Sovereign Mesh ADRs below. New tutorials: Power-User Bootstrap CLI (stable), Nostr Server Identity (pending), Sovereign Ingest (pending -- not yet written).

Agent Control Surface Protocol Integration (planned)

VisionClaw does not emit governance panels today. The live Nostr egress is the bead-provenance bridge (src/services/nostr_bridge.rs), which republishes kind 30001 bead-provenance records as kind 9 events. There is no ServerNostrActor and no 31400/31402 panel emission in the current build.

The Agent Control Surface Protocol — server-signed panel and action-request events bridging an agent broker to a Forum Kit relay mesh — is a planned integration. Its contract is defined in architecture/agent-control-surface-panels.md, the authoritative statement that VisionClaw does not publish panels. When implemented, panel emission (kind 31400 PanelDefinition, kind 31402 ActionRequest) would be carried by a future ServerNostrActor; the document specifies the kinds, fields, and RBAC model that emitter must satisfy.

Documentation Map

graph LR
    subgraph "Tutorials"
        T1[Installation]
        T2[First Graph]
        T3[Graph Store - Oxigraph]
    end
    subgraph "How-To"
        H1[Deployment Guide]
        H2[Development Guide]
        H3[Agent Orchestration]
        H4[Features]
        H5[Operations]
    end
    subgraph "Explanation"
        E1[System Overview]
        E2[Backend CQRS]
        E3[Actor Hierarchy]
        E4[Client Architecture]
        E5[Ontology Pipeline]
        E6[Physics/GPU Engine]
        E7[XR Architecture]
        E8[Enterprise Contexts BC11-17]
    end
    subgraph "Reference"
        R1[REST API]
        R2[WebSocket Binary Protocol]
        R3[Graph Schema - RDF/Oxigraph]
        R4[Agents Catalog]
        R5[Config & Env]
    end
    subgraph "Enterprise"
        ADR40[ADR-040 Identity]
        ADR41[ADR-041 Broker]
        ADR46[ADR-046 UI Arch]
        PRD2[PRD-002 Enterprise]
    end
Loading

Tutorials

Step-by-step lessons that teach VisionClaw by doing.

Tutorial Description
What is VisionClaw? Platform overview and key concepts
Installation Docker and native setup from zero
Creating Your First Graph Build and explore your first knowledge graph
Neo4j Basics (obsolete — ADR-11) Historical only; Neo4j removed, graph store is now embedded Oxigraph

How-To Guides

Practical task-oriented instructions. See how-to/README.md for the full index.

Deployment & Infrastructure

Guide Description
Deployment Guide Docker Compose production deployment with NVIDIA GPU
Performance Profiling GPU physics, WebSocket, render, and graph-store (Oxigraph) bottleneck detection
Quest 3 VR Setup Connect a Meta Quest 3 to VisionClaw's immersive XR mode
Infrastructure Overview Goalie integration and infra architecture
Port Configuration Service port mapping and networking
Infrastructure Tools Container management and diagnostic tools
Infrastructure Troubleshooting Container and networking issues

Development

Guide Description
Development Guide Rust/React setup, project structure, testing workflow
REST API Integration Guide NIP-98 auth, common API workflows, WebSocket combination patterns

Agent Orchestration

Guide Description
Agent Orchestration Deploy, configure, and coordinate the multi-agent AI system

Features

Guide Description
3D Interface Controls 3D navigation, node selection, spatial interaction
Filtering Nodes Graph node and edge filtering
Intelligent Pathfinding Semantic shortest-path traversal
Natural Language Queries Plain-English graph search
Semantic Forces Stress-majorisation layout algorithm
Voice Routing 4-plane voice architecture with LiveKit
Voice Integration STT/TTS pipeline setup
Nostr Auth NIP-07/NIP-98 authentication
Auth & User Settings User settings and session management
Ontology Parser OWL 2 parsing from Logseq Markdown
Hierarchy Integration Class hierarchy visualisation
Local File Sync GitHub-to-local file synchronisation
ComfyUI Setup ComfyUI SAM3D integration setup
System Health Monitoring System health monitoring — HealthDashboard, physics status, MCP relay controls
Welcome Tour Welcome tour configuration — steps, flows, skip behaviour, localStorage persistence
Workspace Management Workspace management — save/restore graph configurations, favourites, real-time sync
Command Palette Command palette — Ctrl+K, fuzzy search, custom command registration
Discovery & Similarity Search Semantic similarity search, ontology gap detection, related-node exploration

Operations & Integration

Guide Description
Configuration Environment variables and runtime settings
Troubleshooting Common issues and diagnostic steps
Security Authentication, secrets management, and hardening
Telemetry & Logging Observability and log configuration
Pipeline Admin API Admin endpoints for pipeline management
Operator Runbook Production operations playbook
Maintenance Routine maintenance and upkeep tasks
Power-User Bootstrap CLI CLI tool to bootstrap power-user accounts with GitHub credentials
Nostr Server Identity Per-server Nostr identity + WebID discovery via NIP-39
Neo4j Integration (obsolete — ADR-11) Historical only; Neo4j replaced by embedded Oxigraph, see migration tool tools/migrate-neo4j-to-oxigraph
Solid Integration Solid Pod integration overview
Solid Pod Creation Creating and managing user Solid Pods
Sovereign Ingest (pending) Pod-first ingest saga with embedded Oxigraph store and crash-safe markers
ComfyUI Service ComfyUI Docker service integration

Explanation

Conceptual deep-dives that build understanding of how and why VisionClaw works.

Document What it explains
System Overview End-to-end architectural blueprint — all layers and their interactions
Backend CQRS Pattern Hexagonal architecture with 9 ports, 12 adapters, 56 direct hexser DirectiveHandler/QueryHandler impls (no CQRS bus — see ADR-089)
Actor Hierarchy 21-actor Actix supervision tree — roles, message protocols, failure strategies
Client Architecture React + Three.js component hierarchy, WebGL rendering pipeline, WASM integration
DDD Bounded Contexts Domain-Driven Design context map and aggregate boundaries
DDD Identity Contexts DID/Nostr + PodKey + Passkey identity bounded contexts
DDD Semantic Pipeline Semantic pipeline domain model and context boundaries
Ontology Pipeline GitHub Markdown → OWL 2 → Whelk reasoning → Oxigraph → GPU constraints
Physics & GPU Engine CUDA force-directed physics, semantic forces, 55× GPU speedup
XR Architecture Godot 4.3 + godot-rust + OpenXR native Quest 3 APK, spatial collaboration
Security Model Nostr DID auth, Solid Pod sovereignty, CQRS authorization, audit trail
Solid Sidecar Architecture JSON Solid Server sidecar for user Pod storage
User-Agent Pod Design Per-user Solid Pod isolation for agent memory
Technology Choices Rationale for Rust, CUDA, Oxigraph, OWL 2, and Three.js selections
RuVector Integration RuVector PostgreSQL as AI agent memory substrate
Feature Engineering Pipeline Content + topology embeddings, TransE training, N-hop materialisation, per-edge physics
Blender MCP Architecture Blender remote-control via WebSocket RPC + MCP tools
Deployment Topology Multi-container service map, network architecture, dependency chain, scaling
Agent-Physics Bridge How AI agent lifecycle states synchronise to the 3D physics simulation
DDD Enterprise Contexts (BC11–BC17) Judgment Broker, Workflow Lifecycle, Insight Discovery, Enterprise Identity, KPI Observability, Connector Ingestion, Policy Engine bounded contexts
DDD Insight Migration Context Insight Migration DDD context — MigrationCandidate aggregate in BC13, MigrationCase subtype in BC11, promotion lifecycle

Reference

Technical specifications for APIs, schemas, protocols, and configuration.

Full reference index: reference/INDEX.md

Reference Contents
REST API All HTTP endpoints — graph, settings, ontology, auth, pathfinding, Solid
WebSocket Binary Protocol Unified binary protocol (52 bytes/node, WireNodeDataItemV3), connection lifecycle, client implementation
Graph Schema Graph node/edge types, ontology nodes, Solid Pod records, indexes (Oxigraph/RDF, ADR-11)
Agents Catalog Complete catalog of specialist agent skills by domain
Error Codes AP-E, DB-E, GR-E, GP-E, WS-E error code hierarchy with solutions
Glossary Definitions for domain terms used throughout the documentation
Physics Parameters UI slider → settings key → CUDA kernel mapping, effective ranges, FastSettle vs Continuous
Performance Benchmarks GPU physics, WebSocket, and API performance metrics
Environment Variables All .env variables with types, defaults, and descriptions
Docker Compose Options Service profiles, volumes, and compose file structure
MCP Protocol Model Context Protocol specification for agent orchestration
Protocol Matrix Transport protocol comparison — WebSocket, REST, MCP
Cargo Commands Rust build, test, and lint commands
Docker Commands Docker and docker-compose operational commands

Architecture Decision Records

Design decisions recorded as ADRs in docs/adr/.

ADR-015 through ADR-026 are not in this repository — those numbers were assigned to decisions that predated the current ADR process and were not backfilled.

Numbering convention (one-number-one-decision): every ADR number maps to exactly one decision. Duplicate-numbered files are renumbered to the next free number rather than disambiguated by suffix. The 2026-06-11 sweep renumbered the colliding second file of four pairs: ADR-028-sparql-patch-ontology→ADR-106, ADR-030-ext-github-creds-in-pod→ADR-107, ADR-031-layout-mode-system→ADR-108, ADR-086-sops-secrets-management→ADR-109. The primary of each pair keeps its number (ADR-028 optional-auth, ADR-030 agent-memory-pods, ADR-031 gpu-analytics, ADR-086 git-over-http-ingest). See ADR-105 §Numbering. The previous historical -ext suffix (e.g. ADR-028-ext) is retained where it still denotes a distinct accepted decision and did not itself collide.

Latest Decisions (2026-06)

ADR Status Title
ADR-127 Accepted Semantic Trust Layer — SHACL shapes in Oxigraph, PROV-O as reified RDF, relay-mediated SPARQL federation (deferred)
ADR-111 Proposed Ecosystem Infographic Modernisation — audit + diagram-as-code / Nano Banana regeneration plan for stale images (image replacement is a separate follow-up)
ADR-110 Accepted Agentic Actors Project Control Surfaces into the Forum (ACSP producer + knowledge-elevation flagship; resolves PRD-014 §8)
ADR-102 Accepted XR Client ↔ Backend Transport Completion (live V3 wire; amends ADR-071)

Core Platform (ADR-011 to ADR-014)

ADR Title
ADR-011 Authentication Enforcement
ADR-012 WebSocket Store Decomposition
ADR-013 Render Performance Strategy
ADR-014 Semantic Pipeline Unification

Solid / Pod Integration (ADR-027 to ADR-030)

ADR Title
ADR-027 Pod-Backed Graph Views
ADR-106 SPARQL PATCH for Ontology Mutations (renumbered from ADR-028; see ADR-105 §Numbering)
ADR-029 Type Index Discovery
ADR-030 Agent Memory Pods

Sovereign Mesh: Pod Integration (ADR-028-ext to ADR-052)

ADR Title Description
ADR-028-ext NIP-98 Optional Enterprise Auth AccessLevel::Optional + caller-aware filter + legacy session deprecation path
ADR-107 Pod-Stored GitHub Credentials Per-user GitHub creds in Pod ./private/config/github + power-user bootstrap CLI (renumbered from ADR-030-ext; see ADR-105 §Numbering)
ADR-050 Pod-Backed KGNode Schema KGNode visibility/owner_pubkey/opaque_id/pod_url fields + PRIVATE_OPAQUE_FLAG + HMAC opaque IDs
ADR-051 Publish/Unpublish Saga Visibility state machine: MOVE between /public and /private containers, 410 Gone, cache invalidation
ADR-052 Pod Default WAC + Container Layout Default-private root ACL + /private, /public, /shared, /profile + double-gated writes

Platform Consolidation (ADR-031 to ADR-039)

ADR Status Title
ADR-108 Accepted Layout Mode System (renumbered from ADR-031; see ADR-105 §Numbering)
ADR-032 (deleted) Superseded RATK Integration for WebXR → ADR-071
ADR-033 (deleted) Superseded Vircadia SDK Decoupling → ADR-071
ADR-034 Accepted NEEDLE Bead Provenance System
ADR-036 Accepted Node Type System Consolidation
ADR-037 Superseded by ADR-061 Binary Protocol Consolidation
ADR-038 Partially superseded by ADR-061 Position Data Flow Consolidation
ADR-039 Accepted Settings/Physics Object Consolidation

ADR-035 is absent — the content was renumbered to ADR-037 (ADR-037-binary-protocol-consolidation.md carries the ADR-035 internal heading, a known inconsistency).

Enterprise Governance (ADR-040 to ADR-049)

ADR Status Title
ADR-040 Proposed Enterprise Identity Strategy (OIDC + Nostr)
ADR-041 Proposed Judgment Broker Workbench Architecture
ADR-042 Proposed Workflow Proposal Object Model
ADR-043 Proposed KPI Lineage Model
ADR-044 Proposed Connector Governance and Privacy Boundaries
ADR-045 Proposed Policy Engine Approach
ADR-046 Accepted Enterprise UI Architecture
ADR-047 Proposed WASM Visualization Components
ADR-048 Proposed Dual-Tier Identity Model (KGNode + OntologyClass)
ADR-049 Proposed Insight Migration Broker Workflow

Six of eight enterprise ADRs are Proposed — the features are built and operational but the decisions are pending formal ratification.

Sovereign Crate & Solid Alignment (ADR-053 to ADR-056)

ADR Status Title
ADR-053 Ratified solid-pod-rs Crate Extraction
ADR-054 Ratified URN-Solid + Solid-Apps Ecosystem Alignment
ADR-055 Ratified Sovereign Debt Payoff + Phase 2 Sprint
ADR-056 Ratified JSS Parity Migration Architecture

Contributor & Agentbox (ADR-057 to ADR-058)

ADR Status Title Related PRD
ADR-057 Proposed Contributor Enablement Platform PRD-003
ADR-058 Accepted MAD→Agentbox Migration PRD-004

URI Federation & Binary Protocol (ADR-059 to ADR-063)

ADR Status Title Related PRD
ADR-059 Accepted (Phase 1 + 2a verified; 2b render scoped) Bi-directional Agent Activity Channel PRD-006
ADR-060 Proposed Owner-Pubkey-Filtered Binary Encoder PRD-006
ADR-061 Accepted Binary Protocol Unification (single wire, no versioning) PRD-007
ADR-062 Accepted QE Graph Scaffolding (PRD/ADR/DDD Traceability) PRD-QE-001
ADR-063 Accepted URN-Traced Operations Across All Subsystems PRD-006

Graph Cognition Platform (ADR-064 to ADR-070)

ADR Status Title Related PRD
ADR-064 Implementing Typed Graph Schema (UA-Aligned, URN-Bound) PRD-005
ADR-065 Proposed Rust-Native Code Analysis Pipeline PRD-005
ADR-066 Proposed Pod-Federated Graph Storage PRD-005
ADR-067 Proposed Ontobricks MCP Bridge & Reasoning Federation PRD-005
ADR-068 Implementing Logseq Block-Level Fidelity PRD-005
ADR-069 Implementing Force-Preset System & Per-Edge-Category Forces PRD-005
ADR-070 Implementing CUDA Integration Hardening PRD-005

XR Godot Replacement (ADR-071)

ADR Status Title Related PRD
ADR-071 Accepted Godot 4 + godot-rust + OpenXR Native APK PRD-008

Feature Engineering (ADR-072)

ADR Status Title Related PRD
ADR-072 Accepted AutoRDF2GML-Inspired Feature Engineering Pipeline PRD-009

Ecosystem and Federation (ADR-073 to ADR-085)

VisionClaw is the integration substrate of a 5-project DreamLab ecosystem federated via did:nostr identity. The following PRDs, ADRs, and DDD documents govern the federation architecture.

Product Requirements Documents:

PRD Title Status
PRD-010 DID:Nostr Mesh Federation Phase 0-1 complete; Phase 2 kit extraction done; federation implementation in progress
PRD-011 VisionClaw Forum Kit Extraction Phase 2 complete; kit at nostr-rust-forum v3.0.0-rc4 on crates.io
PRD-012 DreamLab Website Kit Adoption Phase 3 forum-config/ created; cutover pending (ADR-083)

Architecture Decision Records:

ADR Status Title
ADR-073 Accepted Private Nostr Relay Mesh Topology
ADR-074 Accepted Cross-System DID:Nostr Canonicalisation
ADR-075 Accepted IS-Envelope v1 Message Contract
ADR-076 Accepted Nostr-Core Absorption into Upstream
ADR-077 Accepted Ecosystem QE Policy (P1-P10)
ADR-078 Accepted Cross-Substrate Library Convergence
ADR-079 Accepted Forum Setup Skill Provider Abstraction
ADR-080 Accepted Forum Kit Deployment Topology Patterns
ADR-081 Accepted Federation Key Custody and Rotation
ADR-082 Accepted Cross-Substrate Test Fixture Sharing
ADR-083 Accepted DreamLab Website Cutover Migration
ADR-084 Accepted Cloud Infrastructure Mapping for Kit Consumers
ADR-085 Accepted Forum-Config Package Architecture

Domain-Driven Design:

Document Description
DDD Mesh Federation Context 5-substrate bounded-context map (V14) covering VisionClaw, solid-pod-rs, nostr-rust-forum, agentbox, and dreamlab-ai-website

Superseded ADRs (removed — historical only)

ADR Superseded By Reason
ADR-032 (RATK Integration) ADR-071 + PRD-008 WebXR/Vircadia stack removed
ADR-033 (Vircadia Decoupling) ADR-071 + PRD-008 Vircadia fully replaced by Godot XR
ADR-037 ADR-061 V3/V5 wire format replaced by unified 24B protocol

RuVector Federation

Document Title
RVF Integration AFD RuVector Federation Architecture Feature Design
RVF Integration DDD RuVector Federation Domain-Driven Design
RVF Integration PRD RuVector Federation Product Requirements

Design Documents

Exploratory design documents in docs/design/.

  • Nostr Relay Integration — Architecture for VisionClaw ↔ Nostr relay bridging
  • Nostr Solid Browser Extension — Browser extension design for Nostr + Solid identity
  • Enterprise Drawer UI — Full specification for the enterprise slide-out drawer: geometry, WASM ambient effects, Zustand store, keyboard shortcut, ARIA, graph dimming, rollback plan
  • Insight Migration Loop — Research corpus for the tacit→explicit knowledge bridging workflow (prior art, bridge theory, physics mapping, acceptance tests, scoring)

Lifecycle Documents

This section indexes the three lifecycle document types that govern VisionClaw's evolution. Each PRD defines what to build, companion ADRs record architectural decisions, and DDD documents model bounded contexts. Forward/back links exist within each document.

Product Requirements Documents (PRDs)

# Document Status Companion ADRs DDD Context
001 PRD-001: Pipeline Alignment Draft (wire-format superseded) ADR-037, ADR-038, ADR-061 Binary Protocol
002 PRD-002: Enterprise UI Proposed ADR-040–049 Enterprise Contexts
003 PRD-003: Contributor AI Support Stratum Proposed ADR-057 Contributor Enablement
004 PRD-004: Agentbox/VisionClaw Integration Draft v4 ADR-058 Agentbox Integration (BC20)
005 PRD-005: Graph Cognition Platform Draft v2 ADR-064–070 Graph Cognition
005-b PRD-005: Benefit Estimates Draft v1 (companion to PRD-005) —
006 PRD-006: URI/JSON-LD Federation Draft ADR-059, ADR-060, ADR-062, ADR-063 Agentbox Integration (BC20), QE Traceability
007 PRD-007: Binary Protocol Unification Draft ADR-061 Binary Protocol
008 PRD-008: XR Godot Replacement In Progress ADR-071 XR Godot (BC22)
009 PRD-009: Feature Engineering & Discovery In Progress ADR-072 Feature Engineering
010 PRD-010: DID:Nostr Mesh Federation Phase 0-1 complete; federation in progress ADR-073–076 Mesh Federation
011 PRD-011: Forum Kit Extraction Phase 2 complete; kit on crates.io ADR-079, ADR-080 Mesh Federation
012 PRD-012: Website Kit Adoption Phase 3 forum-config/ created; cutover pending ADR-083–085 Mesh Federation
022 PRD-022: Semantic Trust Layer Phase 1 implemented (WS-0/1/2/5); federation deferred ADR-127 Semantic Trust Layer (BC22)
QE-001 PRD-QE-001: Integration Quality Engineering Draft ADR-062 QE Traceability (BC21)
QE-002 PRD-QE-002: XR Godot Quality Engineering In Progress ADR-071 XR Godot (BC22)
— PRD: Agent Orchestration Improvements Accepted (archived) ADR-031 —
— PRD: Bead Provenance Upgrade Implemented ADR-034 Bead Provenance
— PRD: Insight Migration Loop Draft ADR-049 Insight Migration
— PRD: v2 Pipeline Refactor Draft (archived) ADR-014 Semantic Pipeline
— PRD: RVF Integration Draft — RVF Integration DDD
— PRD: JSS Parity Migration Active ADR-056 —

Superseded PRDs

Document Superseded By Date
PRD: XR Modernisation (deleted) PRD-008, ADR-071 2026-05-02

Domain-Driven Design (DDD) Documents

Context BC# Document Status Linked PRD
Core Bounded Contexts BC1–10 DDD Bounded Contexts Active —
Identity — DDD Identity Contexts Active —
Semantic Pipeline — DDD Semantic Pipeline Active PRD-v2-pipeline-refactor (archived)
Enterprise (BC11–17) BC11–17 DDD Enterprise Contexts Active PRD-002
Contributor Enablement BC18–19 DDD Contributor Enablement Active PRD-003
Insight Migration (within BC13/BC11) DDD Insight Migration Active PRD: Insight Migration Loop
Agentbox Integration BC20 DDD Agentbox Integration Active PRD-004, PRD-006
Bead Provenance — DDD Bead Provenance Active PRD: Bead Provenance Upgrade
Binary Protocol — DDD Binary Protocol Active PRD-007
QE Traceability Graph BC21 DDD QE Traceability Draft PRD-QE-001
Graph Cognition BC-GC DDD Graph Cognition Active PRD-005
XR Godot BC22 DDD XR Godot Implemented PRD-008
Feature Engineering BC23 DDD Feature Engineering Active PRD-009
Semantic Trust Layer BC22 DDD Semantic Trust Layer Active PRD-022

Superseded DDD Documents

Document Superseded By Date
DDD XR Bounded Context (deleted) DDD XR Godot (BC22) 2026-05-02

Audits

QE audit reports in docs/audits/.

Report Description
QE Enterprise Audit Enterprise feature security, accessibility, and test coverage audit (2026-04)
2026-04-17 Master Report Full QE fleet audit — frontend graph loading, backend settings routing, failure patterns, regression risk
Frontend Graph Loading Graph worker, WebSocket, binary protocol analysis
Backend Settings Routing Settings PUT pipeline and actor routing audit
Similar Failure Patterns Cross-system failure pattern catalogue
Regression Risk Risk matrix for recent physics/WebSocket changes
Regression Tests Regression test specifications

Use Cases

Industry applications and positioning in docs/use-cases/.

Document Description
Use Case Overview Cross-industry application summary
Industry Applications Sector-specific use cases (creative, research, enterprise)
Competitive Analysis Positioning against alternative approaches
Quick Reference One-page capability and positioning card

Other

Document Description
Testing Guide Unit, integration, and E2E testing strategy
Security Model NIP-98 auth, Solid Pod sovereignty, CQRS authorization, threat model
Infrastructure Inventory Container services, ports, and environment inventory
Contributing Contribution workflow, branching conventions, code standards
Changelog Version history and release notes
Use Cases Industry use cases and case studies
Git Support Git workflow and branching strategy (archived)

Maintained by DreamLab AI — Issues | Discussions