57 lines
3.9 KiB
Text
57 lines
3.9 KiB
Text
|
# Kogral page — Local-First Knowledge Graphs
|
||
|
|
|
||
|
|
# Hero
|
||
|
|
kogral-badge = v0.1.0 | Foundation Complete | 97+ tests
|
||
|
|
kogral-tagline = Local-First Knowledge Management
|
||
|
|
kogral-page-title = Knowledge Graphs For Developer Teams
|
||
|
|
kogral-page-subtitle = Structured knowledge management that scales from solo projects to organizations. Config-driven architecture for capturing architectural decisions, coding guidelines, and reusable patterns in version-controlled markdown. 100% Rust. Zero compromises.
|
||
|
|
|
||
|
|
# Problems
|
||
|
|
kogral-problems-title = The 4 Problems It Solves
|
||
|
|
kogral-problem-1-title = Scattered Documentation
|
||
|
|
kogral-problem-1-desc = Notes in Notion, decisions in Slack, guidelines in wikis — all disconnected. KOGRAL unifies with git-native markdown + MCP.
|
||
|
|
kogral-problem-2-title = No Version Control for Decisions
|
||
|
|
kogral-problem-2-desc = Architectural decisions lost in chat history. No traceability for why code exists. KOGRAL provides Git-tracked ADRs with full history and @file:line code references.
|
||
|
|
kogral-problem-3-title = Lost Context Over Time
|
||
|
|
kogral-problem-3-desc = New team members can't find past decisions. Outdated documentation causes repeated mistakes. KOGRAL offers semantic search and relationship tracking.
|
||
|
|
kogral-problem-4-title = Isolated Team Knowledge
|
||
|
|
kogral-problem-4-desc = Every project reinvents the wheel. Patterns can't be shared across teams. KOGRAL's multi-graph architecture enables shared organizational knowledge with project-specific overrides.
|
||
|
|
|
||
|
|
# How It Works
|
||
|
|
kogral-how-title = How It Works
|
||
|
|
kogral-how-markdown-title = Markdown-Native
|
||
|
|
kogral-how-markdown-desc = YAML frontmatter for metadata. Wikilinks for relationships. Code references @file.rs:42. Logseq-compatible format. Human-readable, Git-friendly.
|
||
|
|
kogral-how-search-title = Semantic Search
|
||
|
|
kogral-how-search-desc = Text search across all nodes. Vector embeddings for semantic queries via stratum-embeddings with local fastembed. Cloud APIs supported (OpenAI, Claude, Ollama via rig-core).
|
||
|
|
kogral-how-config-title = Config-Driven
|
||
|
|
kogral-how-config-desc = Nickel schemas with validation. 3 modes: dev, prod, test. Storage Factory with config-driven backend dispatch. TypeDialog fragment composition pattern. No hardcoded paths or settings.
|
||
|
|
kogral-how-mcp-title = Claude Code Integration
|
||
|
|
kogral-how-mcp-desc = MCP server (Model Context Protocol). 10 tools in kogral/* namespace (search, blocks, todos, cards). 6 resources via kogral:// URI scheme. 2 prompts for project summarization and related content discovery.
|
||
|
|
kogral-how-logseq-title = Logseq Blocks
|
||
|
|
kogral-how-logseq-desc = Outliner-style hierarchical blocks. Task status: TODO, DOING, DONE, LATER, WAITING. Inline #tags and custom properties. Block references and page refs. Round-trip fidelity for Logseq import/export.
|
||
|
|
kogral-how-events-title = Event System & Orchestration
|
||
|
|
kogral-how-events-desc = NATS JetStream event publishing. EventingStorage decorator wraps any backend. KogralEvent types for node and graph operations. stratum-orchestrator pipeline triggering. SurrealDB dual-engine support.
|
||
|
|
|
||
|
|
# Components
|
||
|
|
kogral-components-title = Core Components
|
||
|
|
kogral-comp-core-role = Core library
|
||
|
|
kogral-comp-cli-role = 13 commands + blocks
|
||
|
|
kogral-comp-mcp-role = 10 tools, kogral://
|
||
|
|
kogral-comp-config-role = Nickel schemas
|
||
|
|
kogral-comp-storage-role = Filesystem, SurrealDB, Memory
|
||
|
|
kogral-comp-embeddings-role = fastembed + rig-core providers
|
||
|
|
kogral-comp-nodes-role = Note, Decision, Guideline, Pattern, Journal, Execution
|
||
|
|
kogral-comp-relations-role = relates_to, depends_on, implements, extends, supersedes, explains
|
||
|
|
kogral-comp-multigraph-role = Project + Shared
|
||
|
|
kogral-comp-events-role = JetStream EventingStorage
|
||
|
|
kogral-comp-logseq-role = Tasks, tags, properties, refs
|
||
|
|
kogral-comp-orchestration-role = stratum-orchestrator pipelines
|
||
|
|
|
||
|
|
# Tech stack
|
||
|
|
kogral-tech-stack-title = Technology Stack
|
||
|
|
|
||
|
|
# CTA
|
||
|
|
kogral-cta-title = Ready to organize your knowledge?
|
||
|
|
kogral-cta-subtitle = 3 Crates | 97+ Tests | 11K LOC | 100% Rust
|
||
|
|
kogral-cta-explore = Get Started
|