diff --git a/README.md b/README.md index 6c8f03d7..b3c5e41b 100644 --- a/README.md +++ b/README.md @@ -121,168 +121,7 @@ If Semantica solves a real problem for you, a star helps others find it. Semantica does not replace your LLM or your vector store — it adds the structured intelligence and accountability layer they cannot provide. ---- -## Architecture - -```mermaid -flowchart TB - classDef src fill:#1e3a5f,stroke:#2563eb,color:#fff - classDef ingest fill:#064e3b,stroke:#059669,color:#fff - classDef extract fill:#1e1b4b,stroke:#7c3aed,color:#fff - classDef proc fill:#3b1313,stroke:#dc2626,color:#fff - classDef store fill:#1c1917,stroke:#d97706,color:#fff - classDef app fill:#0f172a,stroke:#0ea5e9,color:#fff - classDef out fill:#1a1a2e,stroke:#e879f9,color:#fff - classDef access fill:#14532d,stroke:#4ade80,color:#fff - classDef consume fill:#27272a,stroke:#a1a1aa,color:#fff - - %% ── Data Sources ───────────────────────────────────── - subgraph SRC[" Data Sources"] - direction LR - S1["PDF · DOCX · HTML · TXT"]:::src - S2["APIs · Feeds · Streams"]:::src - S3["SQL · Parquet · Snowflake"]:::src - S4["Git Repos · Email · MCP Servers"]:::src - end - - %% ── ① Ingestion ────────────────────────────────────── - subgraph ING["① semantica.ingest"] - direction LR - I1[FileIngestor]:::ingest - I2[WebIngestor]:::ingest - I3[DBIngestor]:::ingest - I4[ParquetIngestor]:::ingest - I5[StreamIngestor]:::ingest - I6[EmailIngestor]:::ingest - I7[RepoIngestor]:::ingest - end - - %% ── ② Extraction ───────────────────────────────────── - subgraph EXT["② semantica.semantic_extract"] - direction LR - E1[NERExtractor]:::extract - E2[RelationExtractor]:::extract - E3[EventDetector]:::extract - E4[TripletExtractor]:::extract - end - - %% ── ③ Processing ───────────────────────────────────── - subgraph PROC["③ semantica.pipeline · semantica.deduplication"] - direction LR - P1[PipelineBuilder]:::proc - P2[ExecutionEngine]:::proc - P3[DuplicateDetector]:::proc - P4[EntityMerger]:::proc - end - - %% ── ④ Intelligence Stores ──────────────────────────── - subgraph KG["④a semantica.kg"] - direction LR - K1[GraphBuilder]:::store - K2[GraphAnalyzer]:::store - K3[BiTemporalFact]:::store - end - - subgraph VS["④b semantica.vector_store"] - direction LR - V1["FAISS · Qdrant · Weaviate\nPinecone · Milvus · PgVector"]:::store - V2[HybridSearch]:::store - end - - subgraph GS["④c semantica.graph_store"] - direction LR - G1[Neo4j]:::store - G2[FalkorDB]:::store - G3[Apache AGE]:::store - G4[Amazon Neptune]:::store - end - - subgraph ONT["④d semantica.ontology"] - direction LR - O1[OntologyGenerator]:::store - O2[OntologyValidator]:::store - O3[SHACL Studio]:::store - end - - subgraph PROV["④e semantica.provenance"] - PR1["ProvenanceManager\nW3C PROV-O · Audit Log"]:::store - end - - %% ── ⑤ Application ──────────────────────────────────── - subgraph CTX["⑤a semantica.context"] - direction LR - C1[ContextGraph]:::app - C2[AgentContext]:::app - C3["Decision Intelligence\nrecord · trace · impact · rules"]:::app - end - - subgraph RSN["⑤b semantica.reasoning"] - direction LR - R1[ReteEngine]:::app - R2[DatalogReasoner]:::app - R3[ForwardChainer]:::app - end - - %% ── ⑥ Output ───────────────────────────────────────── - subgraph EXP["⑥a semantica.export"] - direction LR - X1["RDFExporter\nTurtle · JSON-LD · N-Triples"]:::out - X2[ParquetExporter]:::out - X3["LPGExporter\nCypher · AQL"]:::out - X4[JSONExporter]:::out - end - - subgraph VIZ["⑥b semantica.visualization · explorer/"] - direction LR - W1[KGVisualizer]:::out - W2[OntologyVisualizer]:::out - W3[EmbeddingVisualizer]:::out - W4["Knowledge Explorer\nReact 19 · Sigma.js"]:::out - end - - %% ── ⑦ Access Layer ─────────────────────────────────── - subgraph ACC["⑦ Access"] - direction LR - A1["MCP Server\n12 tools"]:::access - A2["REST API\n109 endpoints"]:::access - A3["CLI\n50+ commands"]:::access - A4["Plugin Bundles\n8 editors · 17 skills · 3 agents"]:::access - end - - %% ── Consumers ──────────────────────────────────────── - subgraph CON["Your AI Stack"] - direction LR - CN1["Agno · LangChain\nCrewAI · AutoGen · OpenAI Agents"]:::consume - CN2["Claude Code · Cursor · Codex\n17 skills · 3 agents per editor"]:::consume - CN3["Windsurf · Cline · Continue\nVS Code · OpenClaw"]:::consume - CN4["GitHub Copilot · Amazon Q\nRoo Code · Aider · Zed"]:::consume - end - - %% ── Data Flow ──────────────────────────────────────── - SRC --> ING - ING --> EXT - EXT --> PROC - PROC --> KG - PROC --> VS - PROC --> ONT - PROC --> PROV - GS --> KG - KG --> CTX - VS --> CTX - ONT --> CTX - PROV --> CTX - KG --> RSN - VS --> RSN - CTX --> EXP - CTX --> VIZ - CTX --> ACC - RSN --> EXP - RSN --> ACC - ACC --> CON - VIZ --> CON - EXP --> CON -``` ---