thoughtbox:knowledge-query

Thoughtbox Knowledge Query

The knowledge graph accumulates insights across sessions. This skill retrieves and synthesizes that accumulated knowledge so you don't rediscover what's already known.

Workflow

Phase 1: Search

Cast a wide net across both sessions and the knowledge graph:

// Search sessions by keyword
async () => {
  const sessions = await tb.session.search("authentication", 10);
  return sessions;
}

// Search entities by name pattern and type
async () => {
  const entities = await tb.knowledge.listEntities({
    name_pattern: "auth",
    types: ["Concept", "Insight"],
    limit: 20
  });
  return entities;
}

// Get graph statistics for context
async () => tb.knowledge.stats()

Phase 2: Traverse

For relevant entities, explore their neighborhood in the graph:

async () => {
  return await tb.knowledge.queryGraph({
    start_entity_id: "entity-uuid-here",
    max_depth: 2,
    relation_types: ["BUILDS_ON", "DEPENDS_ON", "RELATES_TO"]
  });
}
// Returns: connected entities and relations within 2 hops

Check observations for temporal context:

async () => {
  return await tb.knowledge.getEntity("entity-uuid-here");
  // Includes observations array with timestamps and content
}

Phase 3: Retrieve Session Context (If Needed)

For deep dives, retrieve the full session that produced an insight. Use the subagent-summarize pattern to avoid context pollution:

Spawn a subagent with:
  "Retrieve and summarize Thoughtbox session [ID].
   Call: async () => tb.session.get('[ID]')
   Extract only information about [TOPIC].
   Return a 3-5 sentence summary. No raw thoughts."

This keeps the full session (~800 tokens) in the subagent's context and returns only ~80 tokens to yours. 10x context reduction.

Phase 4: Synthesize

Combine findings from entities, relations, observations, and sessions into a coherent answer:

## Knowledge Query: "[topic]"

### Entities Found
- [Concept] "entity-name" — summary from properties
  - Observation (date): "..."
  - Related to: entity-B (BUILDS_ON), entity-C (DEPENDS_ON)

### Session Context
- Session "title" (date, N thoughts): [summary from subagent]

### Gaps
- No entities found for [sub-topic] — consider creating one
- Session from [date] may be outdated — verify current state