Documentation Index
Fetch the complete documentation index at: https://docs.oktolabs.ai/llms.txt
Use this file to discover all available pages before exploring further.
Consolidation
You can use consolidation to materialize delivery artifacts into durable graph context. Consolidation is how a spec decision becomes a future KG query result.
The consolidation pipeline
SQLite queue -> ConsolidationWorker -> deterministic extraction -> cognitive extraction -> graph commit
L1: DeterministicWorker
The deterministic worker extracts known structures: decisions, requirements, API contracts, test scenarios, business rules, ORNs, and parent links. It does not need an LLM.
L2: Cognitive agent
The cognitive layer can add alternatives, assumptions, learnings, and selected relationships. It runs after deterministic extraction and stays behind reconciliation.
Edges carry metadata such as layer, rule ID, creator, and fallback reason. This lets operators distinguish deterministic, cognitive, fallback, and legacy links.
Advisory lock
Pulse uses a per-board writer guard around graph commits. If a writer is busy, work retries rather than corrupting the graph.
Automatic vs manual consolidation
Most consolidation is automatic. Use manual sessions when an agent needs to stage candidate nodes and inspect reconciliation before committing.
Manual consolidation session
okto_pulse_kg_begin_consolidation
okto_pulse_kg_add_node_candidate
okto_pulse_kg_add_edge_candidate
okto_pulse_kg_propose_reconciliation
okto_pulse_kg_commit_consolidation
Abort a stuck session
okto_pulse_kg_abort_consolidation(session_id="...")
okto_pulse_kg_tick_run_now(board_id="...")
Related pages
