ArchitectureKnowledge Engine Architecture

Knowledge Engine Architecture

Knowledge Engine Architecture

Last Updated: 2026-03-06 Status: Active high-level reference Layer: AI context / retrieval augmentation

This document describes the current conceptual role of the knowledge layer without overclaiming historical implementations.

For current module wiring truth, use:

  • docs/architecture/MODULE_STATUS_SSOT.md

For current capability/runtime truth, use:

  • docs/FEATURE_MATRIX.md
  • docs/handoff/CHECKPOINT.md

Overview

The knowledge layer enriches Jorvis beyond raw schema retrieval. It provides business-context augmentation and retrieval-adjacent signals that can improve query generation and explanation quality.

Current high-level areas:

  • glossary-driven context
  • metric definitions / reusable business semantics
  • schema-aware retrieval support
  • query examples / retrieval support
  • optional document-oriented context depending on environment

Current Positioning

The knowledge layer should be read as context augmentation, not as proof that every historical submodule remains active exactly as originally designed.

In particular:

  • do not treat historical Apache AGE-based graph-linking designs as current architecture truth
  • do not use old orphan-module-era docs as proof of current DI reachability

Current Architectural Truth

AreaCurrent Reading
Glossary / business termsFeature-flagged context layer; verify current activation per environment
Metric definitionsConceptually supported; verify concrete runtime usage before claiming prod default
GraphRAG / schema graph behaviorCurrent production story is plain-SQL / graph-edges oriented, not Apache AGE based
Document linking / deeper semantic graphingTreat as conditional / evolutionary, not unconditional current prod truth

Reading Rules

When interpreting older docs about the knowledge layer:

  1. distinguish between historical design intent and current runtime behavior
  2. prefer MODULE_STATUS_SSOT.md for activation claims
  3. prefer FEATURE_MATRIX.md and current handoff docs for product/runtime claims
  • docs/FEATURE_MATRIX.md
  • docs/architecture/MODULE_STATUS_SSOT.md
  • docs/operations/DEMO_RUNBOOK.md
  • docs/architecture/CURRENT_ARCHITECTURE.md