// Detect productive contradictions between notes - high semantic similarity with opposing conclusions that represent synthesis opportunities
| name | detect-tensions |
| description | Detect productive contradictions between notes - high semantic similarity with opposing conclusions that represent synthesis opportunities |
| allowed-tools | ["Bash","Read"] |
| user-invocable | true |
| automation | gated |
Scans the knowledge base for productive contradictions: note pairs with high semantic similarity but opposing conclusions. These tension zones are where the most valuable articles and frameworks emerge.
| Source | Location | Read | Write | Description |
|---|---|---|---|---|
| Enrichments | resources/brain-graph/data/graph_enrichments.json | ✓ | ✓ | Tension records saved |
| FAISS Index | resources/local-brain-search/data/brain.faiss | ✓ | Similarity search | |
| Metadata | resources/local-brain-search/data/brain_metadata.pkl | ✓ | Note content |
Default thresholds (similarity > 0.75, divergence > 0.3):
cd "$(git rev-parse --show-toplevel)"/resources/brain-graph
../local-brain-search/venv/bin/python cli.py tensions
Broader search (more results, lower quality):
../local-brain-search/venv/bin/python cli.py tensions --similarity 0.70 --divergence 0.2
For each tension, explain:
../local-brain-search/venv/bin/python cli.py status --json
Check tension_count for total tracked tensions.
Tensions are features, not bugs. The system NEVER auto-resolves tensions. It surfaces them as the most productive intellectual territory in the vault.
Run a full coherence sweep across the Brain Dependency Graph - computes staleness, lifecycle transitions, structural health, and generates a report
Compute lifecycle scores for all insight and framework notes - detect which notes are crystallizing or becoming generative
Autonomous research pipeline - discover, extract, and integrate cutting-edge insights into knowledge base
Autonomous perception layer - scans KB for new notes matching domain watch configs, checks gap resonance with the Thinking Registry, probes external signals via web search, and auto-activates HIGH/MEDIUM signals into the Thinking Registry for the incubation loop.
Extract insights from external documents (research papers, books, articles). Spawns document-insight-extractor subagent. Requires session name.
Extract the transcript from a YouTube video by URL or video ID. Use when the user shares a YouTube link and wants the transcript, captions, or text content of the video. Falls back automatically if the requested language isn't available.
