consolidate

Consolidate — Batch Theme Clustering

Clusters notes into themes (3+ notes per theme), names them via Haiku, and populates themes / theme_members. The default run is a NON-destructive seeder over unassigned notes; --full wipes and reclusters everything.

Tools needed: Bash

Procedure

Step 1 — Parse arguments

• no args / --full → Step 2 (consolidate)
• stats → Step 3
• split <id> → Step 4; bind THEME_ID=<id> from the user's numeric argument
• merge <a> <b> → Step 5; bind A=<a> and B=<b> from the two numeric arguments

Step 2 — Consolidate (seed or full)

cd "$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
python3 -c '
import sys, os, glob; sys.path.insert(0, max(glob.glob(os.path.expanduser("~/.claude/plugins/cache/*/obsidian-brain/*/hooks")), default="hooks"))
from consolidate_cli import run_consolidate; run_consolidate(full=(len(sys.argv) > 1 and sys.argv[1] == "--full"))
' "$@"

Report the UNASSIGNED= (or SCANNED= for --full), CREATED=, and THEMES_TOTAL= lines. If CREATED=0, tell the user no clusters of 3+ similar notes were found (themes need at least 3 notes above the similarity threshold).

Step 3 — Stats

cd "$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
python3 -c '
import sys, os, glob; sys.path.insert(0, max(glob.glob(os.path.expanduser("~/.claude/plugins/cache/*/obsidian-brain/*/hooks")), default="hooks"))
from consolidate_cli import run_stats; run_stats()
'

Present THEMES=, MEMBERS=, UNASSIGNED=, the LARGEST rows, and any NUDGE.

Step 4 — Split

cd "$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
python3 -c '
import sys, os, glob; sys.path.insert(0, max(glob.glob(os.path.expanduser("~/.claude/plugins/cache/*/obsidian-brain/*/hooks")), default="hooks"))
from consolidate_cli import run_split; run_split(int(sys.argv[1]))
' "$THEME_ID"

Report SPLIT or NO_SPLIT.

Step 5 — Merge

cd "$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
python3 -c '
import sys, os, glob; sys.path.insert(0, max(glob.glob(os.path.expanduser("~/.claude/plugins/cache/*/obsidian-brain/*/hooks")), default="hooks"))
from consolidate_cli import run_merge; run_merge(int(sys.argv[1]), int(sys.argv[2]))
' "$A" "$B"

Report MERGED or the error.