trace

Trace where knowledge came from and how it evolved.

Usage

{
  "tool": "trace",
  "arguments": {
    "node_id": "node_abc123"
  }
}

Parameters

Parameter	Type	Required	Description
node_id	string	Yes	Node to trace
depth	int	No	How far to follow (default: 3)
direction	string	No	backward (default), forward, or both

Examples

Trace origins:

{
  "tool": "trace",
  "arguments": {
    "node_id": "node_belief_xyz",
    "direction": "backward"
  }
}

Trace impact:

{
  "tool": "trace",
  "arguments": {
    "node_id": "node_old_fact",
    "direction": "forward"
  }
}

Response Format

Returns provenance chain:

{
  "node": { "id": "node_belief", "content": "..." },
  "chain": [
    { "relationship": "DERIVED_FROM", "node": { "id": "node_fact_1", "content": "..." } },
    { "relationship": "DERIVED_FROM", "node": { "id": "node_evidence", "content": "..." } }
  ]
}

Relationship Types

Relationship	Meaning
DERIVED_FROM	This came from that source
EXTRACTED_FROM	Extracted from document
SUPERSEDES	This replaces that
PROMOTED_FROM	Claim promoted to fact
SUPPORTS	Evidence supports claim

When to Use

• Understanding why you believe something
• Verifying the source of information
• Finding what superseded old information
• Auditing the evolution of knowledge