vault-control-plane

vault-control-plane

An ambient second-brain layer over Ashu's personal Obsidian vault at ~/Documents/Obsidian/Vault. This plugin makes every Cowork task vault-aware without any paste-in prompts.

Current version: v0.5.0 (see Changelog at bottom).

What it does

• Auto-maintains the artifact registry. A PostToolUse hook rebuilds _registry.md, .registry.json, and a ranked 00_Registry/index.md attention view within ~30 s of any vault .md write/edit. The schema is a superset with superseded_by reverse pointers and a derived lifecycle field (active / stale / draft / superseded / archived / unknown) with per-note-type staleness thresholds. (v0.5.0)
• Five PM object slash commands. /vault-new-prd, /vault-new-decision, /vault-new-memo, /vault-new-meeting, /vault-new-insight allocate stable IDs via a filesystem lock, inject per-kind templates, and trigger a registry rebuild. Every PM object is first-class from day one. (v0.5.0)
• Classifies every vault edit into reversal / material / notable / cosmetic. A daily scheduled task (daily-change-engine, 7am local) snapshots every note and diffs against yesterday, writing a ranked _inbox/changes-<date>.md report with confidence scores. Reversal-keyword sniffing ("was wrong", "update:", "I no longer", etc.) catches reasoning flips. (v0.5.0)
• /vault-triage — single ranked view of what deserves attention now. Collects from six sources (changes, pattern proposals, thesis grades, active-context proposals, overdue reviews, recent corrections), ranks by weight × confidence × recency_decay, and prints a markdown table. Companion self-contained HTML dashboard at ~/Documents/Obsidian/Vault/_dashboard/index.html regenerated hourly — filterable, dark-themed, no localStorage, no external JS/CSS. (v0.5.0)
• Auto-loads active context at session start. A SessionStart hook reads ~/Documents/Obsidian/Vault/00_Inbox/_active-context.md into every new Cowork task's context, so you never start cold.
• Threads prior sessions + standing preferences into the first user message. A UserPromptSubmit hook fires once per session on the first prompt, runs vault recall on the message, and injects the top 5 prior hits, the 3 most recent session notes, AND the top 5 most recent corrections (from _corrections.md) as additional context. SessionStart is "where you left off overall"; this is "every prior time you thought about THIS topic + every preference you've ever stated."
• Captures corrections as standing preferences. A second UserPromptSubmit hook scans each user message for cue phrases ("don't", "actually", "prefer", "never", "always", "I told you", "correction:") and, when substantive, appends a dated entry to _corrections.md. Those entries are then surfaced in every future session's context automatically. (v0.4.0)
• Auto-refreshes active context on session stop. A Stop hook rebuilds _active-context.md from the last 7 days of activity (sessions + open theses + open decisions + top corrections), with a 4-hour quiet period, a "touched vault" guard, and a 60% diff safety rail that routes large changes to a proposal file under _inbox/ instead of overwriting. (v0.4.0)
• Weekly mines candidate patterns. A scheduled task (weekly-pattern-mine, Saturdays 10am) reads the last 30 days of sessions/decisions from explicit signal sections (## Lessons, ## Takeaways, ## Patterns, ## Insights, ## Mistakes, ## Wins, etc.) and drafts 1–3 candidate pattern notes into _inbox/patterns/. Never writes into 60_Patterns/ directly. (v0.4.0)
• Daily drafts stock thesis grade stubs with live price data. A scheduled task (daily-thesis-grade-check, weekdays 8am) drafts a grade stub for every active thesis whose next_review is within 14 days or overdue. The agent invoking the task fills in live market data via a stock-data MCP (yahoo → polygon → alphavantage), with yfinance and WebSearch fallbacks. Idempotent — will not overwrite existing stubs. (v0.4.0)
• Surfaces content-aware duplicate warnings before Write/Edit. A PreToolUse hook runs semantic recall on BOTH the filename AND the first ~500 chars of content being written to any net-new .md under the vault (also fires on material edits >=200 chars). Claude sees the merged hits as advisory context and redirects to update-in-place instead of spawning note-v2.md.
• Nudges a session-note anchor at stop time. A Stop hook fires exactly once per session. If the session materially touched the vault and no session note exists for today, it blocks Claude with a reason instructing it to run vault new-session and update _active-context.md before ending.
• Teaches Claude the vault conventions. A skill with baked-in session-start protocol, schema, update-vs-create rule, stock grading protocol, contradiction-check requirement, and anti-patterns triggers on any PM / stock / second-brain query.