- Remove duplicate integrations table from bottom of README
- Move Agentic Frameworks section to top alongside AI tools table
- Show only Agno as supported; list LangChain, LangGraph, CrewAI, LlamaIndex, AutoGen, OpenAI Agents SDK, Google ADK as coming soon
- Add logo icons for all agentic frameworks matching existing plugin style
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
- Add integrations/openclaw/ with OpenClawKGTool (REST) and
OpenClawMCPConfig (mcporter.json generator)
- Add plugins/.openclaw-plugin/ bundle (plugin.json, marketplace.json,
README) with MCP + native tool support
- Add OpenClaw badge to README header
- Reorganize "Works With Every AI Tool" table into labeled groups:
Native Plugin Bundle, MCP Server + Plugin, MCP Server, REST API
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Tools grid:
- Claude Code/Cursor/Codex: 'Native plugin' (plugins/ dirs exist in repo)
- All other tools: 'REST API' (no MCP server impl in codebase — Semantica
has an MCP CLIENT for ingesting from MCP servers, not an MCP server)
- Codex CLI added back (has real plugin bundle at plugins/.codex-plugin/)
Plugin Bundles section:
- Full table of all 17 skills with descriptions matching SKILL.md files
- Full table of all 3 agents (kg-assistant, decision-advisor, explainability)
- Hooks entry referencing plugins/hooks/hooks.json
MCP Client section:
- Correct framing: MCPClient in semantica/ingest/mcp_client.py pulls
data FROM MCP servers into KG (not an MCP server itself)
- Code snippet + supported schemes
REST API Server section:
- Lists all 10 route modules from semantica/explorer/routes/ with paths
- WebSocket /ws endpoint
- Health check
Agno integration section:
- Expanded to table showing all 5 actual files in integrations/agno/
with class names and descriptions matching source code
AI Coding Tools table:
- Corrected connection types and setup notes to match actual code
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Add 'AI Coding Tools & IDEs' table under Integrations listing every
tool from the visual grid with connection type and setup note:
Claude Code, Cursor, Windsurf, Claude Desktop, VS Code, GitHub
Copilot, Cline, Roo Code, Continue, Goose, Kilo Code, Aider,
Amazon Q, Zed, Claude SDK, REST API (109 endpoints)
- Add Neo4j to Graph Databases list (was in modules but missing here)
- Add Email and Repository ingestors to Data Sources
- Expand LLM Providers: add Groq, HuggingFace, Ollama entries
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
AI tools grid (removed Gemini CLI, Codex CLI; added VS Code, GitHub
Copilot, Continue, Amazon Q, Zed — all confirmed MCP-supporting tools
with significant user bases in 2026):
Row 1: Claude Code, Cursor, Windsurf, Claude Desktop, VS Code,
GitHub Copilot, Cline, Roo Code
Row 2: Continue, Goose, Kilo Code, Aider, Amazon Q, Zed,
Claude SDK, Any agent REST API
Agentic frameworks grid (added LangGraph and OpenAI Agents SDK, expanded
to 8 entries): Agno, LangChain, LangGraph, LlamaIndex, AutoGen, CrewAI,
OpenAI Agents SDK, Google ADK
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- New '🖥️ Semantica Knowledge Explorer' section placed after Plugins,
with a workspace-tab table (Graph, Timeline, Decisions, Registry,
Entity Resolution, KG Overview, Ontology), a 4-line quick-start
snippet, requirements line, and a pointer to explorer/README.md
- Added explorer/ row to the detailed Modules table with a link
- Added explorer/ bullet to the condensed Modules list
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Audited every module's __init__.py and source files. Fixes:
1. Temporal GraphRAG example — was garbled (two sections merged into one
code block). Restored clean single example with correct imports.
2. Semantic extraction — extract_entities/extract_relations/extract_triplets
are not standalone functions; replaced with correct class-based API:
NERExtractor().extract_entities(), RelationExtractor().extract_relations(),
TripletExtractor().extract_triplets(). extract_relations_llm is only in
semantica.semantic_extract.methods (not re-exported from __init__) and
requires entities as its required second positional arg — fixed both.
3. ReteEngine — add_rule() and match() do not exist on ReteEngine.
Replaced with correct API: Rule/Fact dataclasses + build_network([rule])
+ add_fact(fact) + match_patterns().
4. PipelineBuilder — add_stage(name, callable) does not exist; replaced
with add_step(name, type_str, **config). with_parallel_workers() does not
exist; replaced with set_parallelism(n). Pipeline.run() takes no
input_path; removed that kwarg.
5. ProvenanceTracker.track_entity — source_url is not a valid kwarg;
second param is positional source. Fixed in features list and comment.
6. Leftover SHACL section — removed second copy of the SHACL code block
that still referenced to_shacl(), export_shacl(), validate_graph() which
do not exist on OntologyEngine (confirmed in engine.py).
7. Duplicate pip install lines — semantica[shacl] and semantica[db-snowflake]
appeared twice in the installation block; removed duplicates.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Bug 1 — Broken snapshot example:
- Replace graph.add_decision(category=...) with graph.record_decision()
which accepts keyword args (add_decision expects a Decision object)
- Define context = AgentContext(...) before calling context.checkpoint()
and context.diff_checkpoints() — these APIs live on AgentContext, not ContextGraph
Bug 2 — Invalid KG example imports:
- Remove KnowledgeGraph, Entity, Relationship, CentralityAnalyzer — not exported
- Replace with GraphBuilder.build() (dict-based API) and CentralityCalculator
which are the actual public exports from semantica.kg
- Fix pipeline example: KnowledgeGraph() → GraphBuilder()
Bug 3 — Nonexistent SHACL APIs:
- Remove export_shacl() and validate_graph() calls — not on OntologyEngine
- Rewrite SHACL section to use real APIs: from_data(), export_owl(),
validate(), from_text(), to_owl()
- Remove semantica[shacl] install instructions (extra not in pyproject.toml)
Bug 4 — Stale docs version badge:
- docs/index.md: bump version badge and release tag link from v0.3.0 → v0.4.0
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Replace dense tables with scannable bullet points throughout
- Add plain-English descriptions before each feature section
- Update What's New to cover full v0.4.0 temporal stack, SKOS, SHACL, and fixes
- Add learn-more references linking to docs and cookbook per section
- Slim code examples to focused real-world scenarios, remove API-dump patterns
- Fix duplicate badges, bump version badge to 0.4.0
- Fill empty Learning Resources section
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Fixes#433
- ContextGraph.add_decision() now accepts keyword arguments (category,
scenario, reasoning, outcome, confidence, entities, decision_maker)
in addition to a Decision object, matching documented behaviour.
Both call forms return the decision ID string.
- Quickstart snippets in README, getting-started.md, and index.md
changed from VectorStore(backend="faiss") to VectorStore(backend="inmemory")
so they work without faiss-cpu installed.
- docs/reference/context.md methods table updated to reflect the dual
signature of add_decision().
- docs/bugs/quickstart_api_mismatch.md added to track the issue.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Create RELEASE_NOTES.md with detailed per-contributor breakdown for all
three release stages (0.3.0-alpha, 0.3.0-beta, 0.3.0 stable) including
every PR, contributor, feature, bug fix, and test count
- Replace verbose README 'What\'s New' section with a concise summary table
linking to RELEASE_NOTES.md for full detail
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Add v0.3.0 version badge to README header
- Add comprehensive 'What\'s New in v0.3.0' section covering all features
shipped across 0.3.0-alpha, 0.3.0-beta, and 0.3.0 stable: context graph
feature completeness, decision intelligence, KG algorithms, deduplication
v2, incremental/delta processing, export formats, pipeline/production
hardening, and graph database backends
- Fold [Unreleased] changelog entries into [0.3.0] release block with
full detail on all additions, fixes, and tests
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Enhanced README.md with strategic emojis for better visual appeal
- Updated context_usage.md with detailed, user-friendly examples
- Improved docs/reference/context.md with accessible language
- Added AgentContext sections with progressive learning approach
- Maintained professional appearance while improving readability
- Consistent documentation across all context module files
- Add decision tracking system with DecisionRecorder, DecisionQuery, CausalChainAnalyzer, PolicyEngine
- Implement KG algorithm integration with centrality, community detection, embeddings, path finding
- Add vector store integration with hybrid search and custom similarity weights
- Enhance context graphs with advanced analytics and decision support
- Update documentation with comprehensive context module reference
- Add production examples for banking and healthcare use cases
- Update README to highlight context graph framework capabilities
- Add comprehensive test suite for all new features
- Added comprehensive KG algorithms overview to README
- Updated Knowledge Graph Construction section with new algorithms
- Added examples for NodeEmbedder, SimilarityCalculator, CentralityCalculator
- Listed all 8 algorithm categories with descriptions
- Added provenance tracking mention
- Updated cookbook links to include advanced graph analytics
Follow-up commit for PR #292
- Fix invalid Material Design Icons in provenance.md reference cards
- Replace old 'Semantica Updated Logo.png' with new 'Semantica Logo.png'
- Update README.md, docs/index.md, and docs/DOCS_README.md logo references
- Remove old logo files and add new logo to docs assets
- All documentation now uses consistent, valid icons and new branding
- Update all Discord links to correct server (https://discord.gg/ggb7vWeP)
- Fixed links in README.md, CONTRIBUTING.md, SUPPORT.md, and other docs
- Ensures consistent Discord server reference across project
- Updated README.md with new logo reference
- Updated docs/index.md with new logo reference
- Updated docs/DOCS_README.md documentation
- Added new clean, professional logo (Semantica Updated Logo.png)
- Removed old illustrated logo (semantica_logo.png)
The new logo is minimal, scales well, and better represents Semantica as an enterprise-grade semantic layer.
- Implemented provenance tracking across all 17 Semantica modules
- Added W3C PROV-O compliant schemas (prov:Entity, prov:Activity, prov:Agent, prov:wasDerivedFrom)
- Created ProvenanceManager with InMemory and SQLite storage backends
- Implemented SHA-256 integrity verification for tamper detection
- Added bridge axiom support for domain transformations (L1→L2→L3)
- Created provenance-enabled versions of all modules (opt-in with provenance=True)
- Added comprehensive test suite (237 tests covering edge cases and real scenarios)
- Updated README with accurate claims and compliance disclaimers
- Added complete documentation (usage guide and API reference)
- Zero breaking changes - fully backward compatible
