Commit Graph
283 Commits
Author SHA1 Message Date
Sameer6305 ccb9e070b4 docs: fix policy engine implementation mismatches 2026-06-29 16:17:56 +05:30
Sameer6305 527726faa3 docs: improve policy engine onboarding and rule guidance 2026-06-24 16:16:15 +05:30
KaifAhmad1 5e7c929ca8 docs: lighten code block hover — subtle lift + faint ring 2026-06-22 16:43:27 +05:30
KaifAhmad1 350b0a953f docs: upgrade custom.css to premium design system
Replace uniform cursor-bar hover effects with a differentiated,
light animation layer per element type. Adds global polish:
smooth scroll, custom scrollbar, brand-colored text selection,
page fade-in entrance, emerald focus rings, H1 gradient underline
accent, styled blockquotes, gradient HR dividers, uppercase table
headers, and CTA button glow — all tuned to the #080C10 dark
background and #10B981 emerald brand color.
2026-06-22 16:27:16 +05:30
Mohd KaifandSameer6305 5db740100e Align guides with current source APIs (#676)
* align guides with current source APIs

* docs(guides): align context graph and visualization examples with source APIs

* docs(guides): fix reasoning and approval chain examples

* docs(graphrag): fix multiline string examples

* docs(pipeline): align handler examples with execution engine

* docs(ontology): align graph serialization example with ContextGraph API

* docs(llm): fix Triplet example attribute access

---------

Co-authored-by: Sameer6305 <sskadam6305@gmail.com>
2026-06-22 15:58:17 +05:30
Sameer Kadam f35a976a03 docs: align onboarding examples with current APIs (#664) 2026-06-20 22:18:16 +05:30
Sameer Kadam 011a21d0b3 docs: fix broken links and stale notebook references (#660) 2026-06-20 19:27:30 +05:30
KaifAhmad1 e1b7b072b8 docs: replace Changelog tab with GitHub Releases external link; update inline links 2026-06-20 17:01:00 +05:30
KaifAhmad1 a9a72977a9 docs: fix trailing comma in docs.json after tab removal 2026-06-20 16:53:44 +05:30
KaifAhmad1 c5c27b35aa docs: remove Changelog tab from nav — diagnose export failure (step 2) 2026-06-20 16:49:57 +05:30
KaifAhmad1 eddb7dd914 docs: strip changelog to minimal stub — diagnose export failure 2026-06-20 16:45:28 +05:30
KaifAhmad1 59aa3f1d86 docs: add mintlify export + JSX balance checks to docs_check.py; run on PRs 2026-06-20 16:28:02 +05:30
KaifAhmad1 ce8344aa73 docs: rewrite changelog as flat markdown — remove heavy accordion nesting 2026-06-20 16:11:48 +05:30
KaifAhmad1 5515390269 docs: add unreleased note and tighten changelog defaultOpen syntax 2026-06-20 15:53:59 +05:30
Mohd Kaif 1bd2ecfef2 docs: add Changelog tab and clean up overview page (#658)
* docs: add Changelog tab and clean up overview page

- Remove v0.5.0 release banner and stats grid from docs/index.md
- Add Changelog navigation tab to docs/docs.json after FAQ
- Create docs/changelog.md sourced from CHANGELOG.md with full Mintlify
  formatting: one accordion per release (Unreleased → v0.0.1), icons,
  pip install snippets, Added/Fixed/Security sub-sections, and a change
  type legend

* docs: fix broken index#whats-new link in quickstart — point to changelog
2026-06-20 15:43:41 +05:30
Sameer KadamandKaifAhmad1 b882579e2d docs: fix onboarding examples for GraphBuilder and temporal queries (#656)
* docs: fix onboarding examples for GraphBuilder and temporal queries

* docs: fix provenance import, hollow example, and query comment (#656 follow-up)

- Fix wrong import: ProvenanceTracker lives in semantica.kg, not semantica.provenance
- Replace hollow provenance accordion with actual track_entity/get_all_sources example
- Annotate query="" in TemporalGraphQuery.query_at_time as reserved for future use

* docs: use ProvenanceManager from semantica.provenance in W3C PROV-O example

---------

Co-authored-by: KaifAhmad1 <kaifahmad087@gmail.com>
2026-06-20 13:47:20 +05:30
Sameer Kadam 6b14253157 docs: align Explorer module references with actual CLI usage (#655) 2026-06-19 16:24:06 +05:30
Sameer KadamandKaifAhmad1 926d4c1653 docs: add choose-your-module onboarding guide (#651)
* docs: add choose-your-module onboarding guide

* fix(docs): correct export code examples against actual API signatures

- export_to_rdf() returns a string; use export() for file output
- format="json-ld" is invalid; correct value is "jsonld"
- ParquetExporter/LPGExporter/ArangoAQLExporter take file_path as a
  required positional arg, not output= / output_dir= kwargs
- ArangoAQLExporter().export(graph) was missing file_path entirely,
  which would raise TypeError at runtime
- Remove misleading 'with provenance embedded' comment (no such param)

---------

Co-authored-by: KaifAhmad1 <kaifahmad087@gmail.com>
2026-06-19 13:15:06 +05:30
Mohd Kaif 12d61b92df docs: add Temporal & Distance Intelligence reference pages with accurate API (#650)
- Add docs/reference/temporal.md: full Temporal Intelligence reference covering
  bi-temporal model (TemporalBound.OPEN sentinel, BiTemporalFact.from_relationship()
  factory), TemporalGraphQuery (query_at_time, reconstruct_at_time, query_time_range,
  find_temporal_paths, analyze_evolution, validate_temporal_consistency),
  TemporalPatternDetector, TemporalReasoningEngine with all 13 Allen interval
  relations over TemporalInterval objects, TemporalNormalizer (returns
  Optional[Tuple[datetime, datetime]]), TemporalQueryRewriter.rewrite() returning
  TemporalQueryResult, and TemporalVersionManager with SQLite storage and correct
  method names (list_versions, compare_versions, get_version, apply_revision,
  validate_snapshot, verify_checksum)

- Add docs/reference/distance.md: Distance Intelligence reference with corrected
  SimilarityCalculator API (pairwise_similarity, batch_similarity, find_most_similar)
  and semantic neighborhood / proximity-blended retrieval patterns

- Update docs/reference/kg.md: expand Exported Classes table to include all
  TemporalPatternDetector, TemporalInterval, IntervalRelation, TemporalQueryResult,
  AlgorithmTrackerWithProvenance, AlgorithmRegistry, ProvenanceTracker, SeedManager,
  KGConfig; fix all temporal code examples to use correct constructors and method names

- Update docs/reference/context.md: add Distance Intelligence section

- Update docs/index.md: add v0.3.0 release accordion with feature highlights

- Update docs/docs.json: wire temporal and distance pages into Modules navigation
2026-06-18 13:37:24 +05:30
Zohaib Hassnain 0765cfea77 docs: add CLI demo gif (#649) 2026-06-18 01:52:24 +05:30
Mohd Kaif 25289023fe docs: replace all CardGroup/Card blocks with animated bullet points across all 50 docs pages (#648)
- Fix What's new → link in Info banner (now a proper <a> tag, always clickable)
- Replace 4-stat CardGroup on index with inline premium stats row
- Convert every <CardGroup>/<Card> block site-wide to markdown bullet lists:
  content sections → bold-title bullets with sub-bullets, nav cards → [Title](href) — description
- Add cursor-animated list item hover effects to custom.css:
  green inset left border, subtle background tint, marker color change on hover
- Affects index, getting-started, quickstart, concepts, modules, faq, architecture,
  installation, cookbook, glossary, learning-more, explorer-setup, cli-setup,
  community, contributing-guide, governance, citation, project-license,
  all integrations pages, and all 20+ reference module pages
2026-06-17 23:18:40 +05:30
Mohd Kaif 0f9a651527 remove: delete domain-specific use_cases cookbooks and docs (#647)
Removes all notebooks, data files, and exports under cookbook/use_cases/
(advanced_rag, biomedical, blockchain, capability_gap_defense, cybersecurity,
finance, intelligence, renewable_energy, supply_chain) and the corresponding
docs/use-cases.md page.

Cleans up all references in docs/cookbook.md, docs/docs.json,
docs/concepts.md, docs/modules.md, and docs/learning-more.md.
2026-06-17 22:13:50 +05:30
Mohd Kaif e04dc12e6e docs: premium UI improvements — navbar links, hover effects, inline tips, accordion troubleshooting (#646)
- Move Discord, GitHub, PyPI, and Follow on X links from sidebar anchors to top-right navbar
- Lock dark mode as default via appearance.strict and hide theme toggle
- Add custom.css with hover highlighting for tables, code blocks, cards, callouts, and inline code
- Move all Tips and Common Pitfalls sections inline next to their relevant content across all 25 reference docs
- Polish context.md: remove duplicates, condense callouts, upgrade Cookbooks to CardGroup
- Convert Troubleshooting and Performance Optimization sections in installation.md, cli-setup.md, explorer-setup.md, learning-more.md, and faq.md from plain headers to AccordionGroup
- Change navigation-hint Tip callouts to Info in concepts.md, faq.md, glossary.md, and modules.md
2026-06-17 18:59:25 +05:30
Mohd Kaif a326c7d3bd Fix/mintlify theme (#645)
* fix: replace invalid Mintlify theme 'venus' with 'mint'

* docs: replace em dashes with colons across all docs files

* fix: strip UTF-8 BOM from all docs files (broke frontmatter detection)
2026-06-17 13:26:19 +05:30
Mohd Kaif 8f2910fc33 fix: replace invalid Mintlify theme 'venus' with 'mint' (#644) 2026-06-17 13:11:07 +05:30
Mohd Kaif 1f3cea5f0a docs: upgrade all docs pages with Mintlify premium components (#642)
Replace plain markdown lists, tables, and numbered steps with interactive
Mintlify v3 MDX components across all 50+ documentation files:

- Tabs: provider/parser/method selection guides, citation formats, component details
- Steps: setup flows, pipeline stages, connection initialization
- CardGroup/Card: feature overviews, "what you get" sections, navigation footers
- AccordionGroup: FAQ entries
- Check/Warning/Tip/Note/Info: callouts replacing plain bold text and inline notes

Files improved span the full docs surface: reference modules (context, llms,
kg, reasoning, embeddings, deduplication, provenance, parse, ontology, core,
semantic_extract), integrations (agno, docling, snowflake), graph/vector
store backends (apache_age, pgvector), and top-level guides (contributing,
governance, glossary, citation, community-projects, learning-more).
2026-06-17 12:58:44 +05:30
KaifAhmad1 850f47625f docs: address review feedback across 7 modules
- llms.md: use showcase models (llama-3.3-70b-versatile, gpt-4o) in
  provider examples and use-case tables; clarify defaults vs recommended
  in Defaults and Reproducibility section
- split.md: document that chunk_size is in characters with migration note
- ingest.md: add Note that glob patterns are not supported by ingest()
- explorer-setup.md: remove hardcoded "1.5 seconds" timing claim
- cli-setup.md: expand semantica-worker description with concrete usage
- mcp_server.md: clarify turtle/ttl are aliases for the same RDF format
- semantic_extract.md: remove emoji from code comments
2026-06-16 21:49:20 +05:30
Sameer6305 f608b1f75f docs: add CLI and Explorer setup guides 2026-06-16 19:22:42 +05:30
Sameer6305 fc22805e44 docs(change_management): align versioning APIs with implementation 2026-06-16 15:17:38 +05:30
Sameer6305 f2bf1e2159 docs(conflicts): align conflict APIs with implementation 2026-06-16 15:03:28 +05:30
Sameer6305 7e5db2b38d docs(utils): align utility APIs with implementation 2026-06-16 14:49:26 +05:30
Sameer6305 74b8170015 docs(mcp_server): align tools and resources with implementation 2026-06-16 14:38:14 +05:30
Sameer6305 2b661f1c2c docs(visualization): align visualizer APIs with implementation 2026-06-16 14:13:22 +05:30
Sameer6305 50d4c1e849 docs(export): align exporters and format support with implementation 2026-06-16 13:41:57 +05:30
Sameer6305 c62ff0238a docs(explorer): align explorer routes, CLI flags, and APIs with implementation 2026-06-16 11:34:14 +05:30
Sameer6305 d9f3e11eb3 docs(context): align context and policy APIs with implementation 2026-06-16 11:18:19 +05:30
Sameer6305 4275d6ee34 docs(deduplication): align entity resolution APIs with implementation 2026-06-16 11:18:19 +05:30
Sameer6305 55ea3fb4d5 docs(normalize): align normalization APIs with implementation 2026-06-16 11:18:19 +05:30
Sameer6305 4cb2154803 docs(ingest): align ingestion APIs and return types with implementation 2026-06-16 11:18:19 +05:30
Sameer6305 babeaf0e61 docs(evals): align placeholder documentation with implementation 2026-06-16 11:18:19 +05:30
Sameer6305 777deaa4e3 docs(provenance): align lineage and provenance APIs with implementation 2026-06-16 11:18:19 +05:30
Sameer6305 21b15f4b8e docs(reasoning): fix Python 3.8 type annotation compatibility 2026-06-16 11:18:19 +05:30
Sameer6305 ca0133227b docs(reasoning): align inference and reasoning APIs with implementation 2026-06-16 11:18:19 +05:30
Sameer6305 f7e8e87734 docs(triplet_store): align SPARQL and storage APIs with implementation 2026-06-16 11:18:18 +05:30
Sameer6305 10c53c9dd7 docs(graph_store): align graph APIs and backend documentation 2026-06-16 11:18:18 +05:30
Sameer6305 05ff590212 docs(vector_store): align vector store docs with implementation 2026-06-16 11:18:18 +05:30
Sameer6305 a28cb68098 docs(embeddings): align embedding docs with implementation 2026-06-16 11:18:18 +05:30
Sameer6305 13805d40e3 docs(ontology): align ontology docs with implementation 2026-06-16 11:18:18 +05:30
Sameer6305 2fc3261b89 docs(seed): align seed data docs with implementation 2026-06-16 11:18:18 +05:30
Sameer6305 441515a66c docs(kg): align graph and temporal APIs with implementation 2026-06-16 11:18:18 +05:30