Skip to content

Graph-Native Infrastructure for Context and Accountable AI Systems

Refactor Modules section in README

Mohd Kaifb670bc32a4cb
diff --git a/README.md b/README.md
index 2c0e68ea..b6ca54d6 100644
--- a/README.md
+++ b/README.md
@@ -168,35 +168,7 @@ Everything you need to reason about *when* β€” not just *what*.
### πŸ“š SKOS Vocabulary Management
-Build and query controlled vocabularies inside your knowledge graph.
-## Modules
-
-| Module | What it provides |
-|---|---|
-| `semantica.context` | Context graphs, agent memory, decision tracking, causal analysis, precedent search, policy engine |
-| `semantica.kg` | Knowledge graph construction, graph algorithms, centrality, community detection, embeddings, link prediction, provenance |
-| `semantica.semantic_extract` | NER, relation extraction, event extraction, coreference, triplet generation, LLM-enhanced extraction |
-| `semantica.reasoning` | Forward chaining, Rete network, deductive, abductive, SPARQL reasoning, explanation generation |
-| `semantica.vector_store` | FAISS, Pinecone, Weaviate, Qdrant, Milvus, PgVector, in-memory; hybrid & filtered search |
-| `semantica.export` | RDF (Turtle/JSON-LD/N-Triples/XML), Parquet, ArangoDB AQL, CSV, YAML, OWL, graph formats |
-| `semantica.ingest` | Files (PDF, DOCX, CSV, HTML), web crawl, feeds, databases, Snowflake, MCP, email, repositories |
-| `semantica.ontology` | Auto-generation (6-stage pipeline), OWL/RDF export, import (OWL/RDF/Turtle/JSON-LD), validation, versioning, **SHACL shape generation & validation** |
-| `semantica.pipeline` | Pipeline DSL, parallel workers, validation, retry policies, failure handling, resource scheduling |
-| `semantica.graph_store` | Graph database backends β€” Neo4j, FalkorDB, Apache AGE, Amazon Neptune; Cypher queries |
-| `semantica.embeddings` | Text embedding generation β€” Sentence-Transformers, FastEmbed, OpenAI, BGE; similarity calculation |
-| `semantica.deduplication` | Entity deduplication, similarity scoring, merging, clustering; blocking and semantic strategies |
-| `semantica.provenance` | W3C PROV-O compliant end-to-end lineage tracking, source attribution, audit trails |
-| `semantica.parse` | Document parsing β€” PDF, DOCX, PPTX, HTML, code, email, structured data, media with OCR |
-| `semantica.split` | Document chunking β€” recursive, semantic, entity-aware, relation-aware, graph-based, ontology-aware |
-| `semantica.normalize` | Data normalization for text, entities, dates, numbers, quantities, languages, encodings |
-| `semantica.conflicts` | Multi-source conflict detection (value, type, relationship, temporal, logical) with resolution strategies |
-| `semantica.change_management` | Version storage, change tracking, checksums, audit trails, compliance support for KGs and ontologies |
-| `semantica.triplet_store` | RDF triplet store integration β€” Blazegraph, Jena, RDF4J; SPARQL queries and bulk loading |
-| `semantica.visualization` | Interactive and static visualization of KGs, ontologies, embeddings, analytics, and temporal graphs |
-| `semantica.seed` | Seed data management for initial KG construction from CSV, JSON, databases, and APIs |
-| `semantica.core` | Framework orchestration, configuration management, knowledge base construction, plugin system |
-| `semantica.llms` | LLM provider integrations β€” Groq, OpenAI, Novita AI, HuggingFace, LiteLLM |
-| `semantica.utils` | Shared utilities β€” logging, validation, exception handling, constants, types, progress tracking |
+Build and query controlled vocabularies inside your knowledge graph
- Add SKOS concepts with labels, alt-labels, broader/narrower hierarchy, and definitions β€” all required triples assembled automatically.
- Query and search vocabularies with SPARQL-backed APIs (injection-sanitized).
@@ -346,6 +318,35 @@ Semantic memory with hybrid search and metadata filtering.
---
+## Modules
+
+| Module | What it provides |
+|---|---|
+| `semantica.context` | Context graphs, agent memory, decision tracking, causal analysis, precedent search, policy engine |
+| `semantica.kg` | Knowledge graph construction, graph algorithms, centrality, community detection, embeddings, link prediction, provenance |
+| `semantica.semantic_extract` | NER, relation extraction, event extraction, coreference, triplet generation, LLM-enhanced extraction |
+| `semantica.reasoning` | Forward chaining, Rete network, deductive, abductive, SPARQL reasoning, explanation generation |
+| `semantica.vector_store` | FAISS, Pinecone, Weaviate, Qdrant, Milvus, PgVector, in-memory; hybrid & filtered search |
+| `semantica.export` | RDF (Turtle/JSON-LD/N-Triples/XML), Parquet, ArangoDB AQL, CSV, YAML, OWL, graph formats |
+| `semantica.ingest` | Files (PDF, DOCX, CSV, HTML), web crawl, feeds, databases, Snowflake, MCP, email, repositories |
+| `semantica.ontology` | Auto-generation (6-stage pipeline), OWL/RDF export, import (OWL/RDF/Turtle/JSON-LD), validation, versioning, **SHACL shape generation & validation** |
+| `semantica.pipeline` | Pipeline DSL, parallel workers, validation, retry policies, failure handling, resource scheduling |
+| `semantica.graph_store` | Graph database backends β€” Neo4j, FalkorDB, Apache AGE, Amazon Neptune; Cypher queries |
+| `semantica.embeddings` | Text embedding generation β€” Sentence-Transformers, FastEmbed, OpenAI, BGE; similarity calculation |
+| `semantica.deduplication` | Entity deduplication, similarity scoring, merging, clustering; blocking and semantic strategies |
+| `semantica.provenance` | W3C PROV-O compliant end-to-end lineage tracking, source attribution, audit trails |
+| `semantica.parse` | Document parsing β€” PDF, DOCX, PPTX, HTML, code, email, structured data, media with OCR |
+| `semantica.split` | Document chunking β€” recursive, semantic, entity-aware, relation-aware, graph-based, ontology-aware |
+| `semantica.normalize` | Data normalization for text, entities, dates, numbers, quantities, languages, encodings |
+| `semantica.conflicts` | Multi-source conflict detection (value, type, relationship, temporal, logical) with resolution strategies |
+| `semantica.change_management` | Version storage, change tracking, checksums, audit trails, compliance support for KGs and ontologies |
+| `semantica.triplet_store` | RDF triplet store integration β€” Blazegraph, Jena, RDF4J; SPARQL queries and bulk loading |
+| `semantica.visualization` | Interactive and static visualization of KGs, ontologies, embeddings, analytics, and temporal graphs |
+| `semantica.seed` | Seed data management for initial KG construction from CSV, JSON, databases, and APIs |
+| `semantica.core` | Framework orchestration, configuration management, knowledge base construction, plugin system |
+| `semantica.llms` | LLM provider integrations β€” Groq, OpenAI, Novita AI, HuggingFace, LiteLLM |
+| `semantica.utils` | Shared utilities β€” logging, validation, exception handling, constants, types, progress tracking |
+
## πŸ’» Code Examples
### Decision Tracking