KnowledgeSystem class

Unified knowledge management orchestrator.

Composes the five domain runtimes and exposes them through thin facades. The runtimes themselves are constructed and wired by the host — KnowledgeSystem only orchestrates them.

Constructors

KnowledgeSystem({required KnowledgeConfig config, KnowledgePorts? ports, FactGraphRuntime? factGraph, SkillRuntime? skillRuntime, ProfileRuntime? profileRuntime, PhilosophyEngine? philosophyEngine, OpsRuntime? opsRuntime, KnowledgeEventBus? eventBus})
Create a new knowledge system.
KnowledgeSystem.defaults({KnowledgePorts? ports, FactGraphRuntime? factGraph, SkillRuntime? skillRuntime, ProfileRuntime? profileRuntime, PhilosophyEngine? philosophyEngine, OpsRuntime? opsRuntime})
Default-config shorthand factory. L0 FactGraph is auto-wired.
factory
KnowledgeSystem.stub()
Zero-config factory for tests and quick-starts. Auto-wires L0 FactGraphRuntime.inMemory() and KnowledgePorts.stub() (which provides InMemoryKvStoragePort and InMemoryEventPort). The L0 FactGraph cycle (evidence → candidates → facts → queries) works immediately without external adapters. L1~L3+Ops runtimes remain null; their facades throw StateError when invoked.
factory

Properties

config → KnowledgeConfig
System configuration.
final
eventBus → KnowledgeEventBus
Event bus for cross-component observability events.
final
factGraph → FactGraphRuntime
Fact graph runtime (mcp_fact_graph). L0 is a required layer — when the constructor parameter is null, a default FactGraphRuntime.inMemory() is auto-wired so the system works with zero external adapters.
final
facts ↔ FactFacade
Simplified fact graph operations.
latefinal
hashCode → int
The hash code for this object.
no setterinherited
ops ↔ OpsFacade
Simplified ops (workflow / pipeline / runbook) operations.
latefinal
opsRuntime → OpsRuntime?
Ops runtime (mcp_knowledge_ops). Null when workflow/pipeline orchestration is not in scope.
final
philosophy ↔ PhilosophyFacade
Simplified philosophy operations.
latefinal
philosophyEngine → PhilosophyEngine?
Philosophy engine (mcp_philosophy). Null when philosophy evaluation is not in scope. When provided, the engine is also exposed through ports.philosophy so other components can consume it.
final
ports → KnowledgePorts
Standard-port container — the host-supplied capabilities consumed across the orchestrator. May be empty when every runtime injected already carries its own ports.
final
profile ↔ ProfileFacade
Simplified profile operations.
latefinal
profileRuntime → ProfileRuntime?
Profile runtime (mcp_profile). Null when profile evaluation is not in scope.
final
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
skill ↔ SkillFacade
Simplified skill operations.
latefinal
skillRuntime → SkillRuntime?
Skill runtime (mcp_skill). Null when skill execution is not in scope.
final

Methods

noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
shutdown() → Future<void>
Gracefully shutdown the system. Closes the L0 FactGraph runtime, emits SystemShutdownEvent, and closes the event bus. Host-owned opt-in runtimes (skill / profile / philosophy / ops) and external infrastructure adapters must be cleaned up by the host.
toString() → String
A string representation of this object.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited