orchestrata_ultimate.session
Reference › orchestrata_ultimate › session
Session Management Package.
The session package keeps work continuous across many sittings (spec 006, with SPEC-023 for goals). A session is begun, logged, handed off and closed, and the record outlives the process. The curated narrative tells the design story.
Parts by role. The human-readable record: context (the context.md and context.json files, written atomically under a cross-process lock), models, archive, carryover, handover and portfolio. The lifecycle: the controller with its goal, git, changelog and test mixins, governance (Prolog decides open and close) and the event wrapper. Dual storage and facts: redis_store, graph_store, sync, fact_emitter, prolog_interface, prolog_facts, checkpoint and recovery. The knowledge graph: kg_sync writes it and kg_context reads it.
Entry points: the CLI, the MCP tools in mcp_tools, and the three hooks. Start with context, then the controller.
Curated narrative
The hand-written story of this package: orchestrata_ultimate.session.
63 modules, 14,958 lines of code.
Subpackages
| Package | Modules | LOC |
|---|---|---|
cli |
12 | 2,738 |
controller |
6 | 1,612 |
examples |
3 | 258 |
hooks |
4 | 991 |
kg_sync |
9 | 1,972 |
Modules
| Module | Summary | LOC |
|---|---|---|
__init__ |
Session Management Package. | 104 |
archive |
Fresh implementation of archive management. | 262 |
audio_alarm |
Audio alarm for goal achievement / blocking (SPEC-023 US-004). | 193 |
carryover |
Fresh implementation of carryover management. | 267 |
checkpoint |
Session checkpointing. | 98 |
constants |
Session management constants. | 101 |
context |
Fresh implementation of context management. | 1058 |
event_emitting_session_controller |
Event-emitting wrapper for SessionController lifecycle events. | 152 |
exceptions |
Session management exceptions. | 67 |
fact_emitter |
Session fact emitter — dual-backend with Prolog source-of-truth sync. | 258 |
facts |
Fresh implementation of Prolog fact generation. | 202 |
fireflies_tools |
Fireflies MCP tool definitions for meeting intelligence. | 237 |
governance |
Session lifecycle governance — the rule base decides open/close. | 158 |
graph_store |
Graph session store for cold/archival storage. | 414 |
handover |
Fresh implementation of session handover. | 218 |
hook_registry |
Session hook registry for spec 006. | 234 |
interfaces |
Session interfaces for dual-storage architecture. | 126 |
kg_context |
Knowledge Graph Context Provider. | 356 |
mcp_tools |
MCP tool definitions for session management. | 256 |
models |
Fresh implementation of session models. | 435 |
portfolio |
Fresh implementation of portfolio management. | 290 |
prolog_facts |
Prolog fact bridge for session facts. | 193 |
prolog_interface |
Prolog session interface — spec 006 source-of-truth bridge. | 463 |
recovery |
Session recovery manager. | 94 |
redis_store |
Redis session store for hot storage — spec 006 compliant. | 462 |
session |
Session management — backward-compatible shim. | 13 |
spec_parser |
Spec and requirements file parser. | 366 |
sync |
Redis to graph synchronization. | 122 |
types |
Session types for dual-storage architecture. | 188 |
Dependency diagram
