> ## 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

> How Pulse turns specs, sprints, and cards into Knowledge Graph nodes and edges.

# 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

```text theme={null}
SQLite queue -> ConsolidationWorker -> deterministic extraction -> cognitive extraction -> graph commit
```

Queue entries are claimed, processed, and committed under graph writer controls so the embedded store is not written concurrently.

## 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.

## Edge metadata

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

```text theme={null}
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

```text theme={null}
okto_pulse_kg_abort_consolidation(session_id="...")
```

## Trigger the worker immediately

```text theme={null}
okto_pulse_kg_tick_run_now(board_id="...")
```

## Related pages

* [KG consolidation tools](/reference/mcp/kg/consolidation)
* [KG health](/kg-operations/health)