v2.19.0 — PARA Synthesis Hierarchy

PARA 종합 계층 — 주제 위키를 대체하는 새 지식 구조

v2.18.0의 _Wiki/ 주제 위키를 걷어내고, 종합을 PARA 트리 안으로 옮겼습니다. 별도 위키 트리 없이 폴더 구조 자체가 지식 계층이 됩니다.

새 구조

• 폴더 페이지 (폴더명.md) — 각 하위 폴더의 살아있는 종합: 개요 · 최근 흐름(이월 누적) · 핵심 노트 · 모순 · 노후. 변경된 노트 본문을 직접 읽어 실제 내용 충돌을 감지합니다.
• 카테고리 허브 (1_Project.md 등) — Project/Area/Resource 카테고리마다 하위 폴더들을 가로지르는 종합: 지형 · 교차연결 · 모순. (하위 폴더 2개 이상일 때 생성)
• 지식 연대기 — 종합이 일어날 때마다 한 줄 요지가 .meta/log.md에 쌓입니다 (grep synthesis로 조회).
• Unsorted/ 캐치올 — 하위 폴더를 못 정한 Area/Resource 신규 노트는 카테고리 루트가 아니라 Unsorted/로 들어가 다음 정리 대상이 됩니다.

마이그레이션

• 기존 볼트의 _Wiki/ 페이지는 앱 실행 시 자동 정리됩니다 (DotBrain 블록 제거, 직접 작성한 내용은 보존, 순수 자동 생성 페이지는 휴지통).
• 노트를 수정하면 AI가 요약·태그를 자동 갱신해 폴더 종합이 따라 갱신됩니다.

변경 · 정리

• Gemini 제공자 제거 — 제공자는 Claude CLI(구독, 추천) / Codex CLI(구독) / Claude API 3종.
• AI 컴패니언 v19 — 종합 계층 탐색 가이드 (허브 → 폴더 페이지 → 노트).
• 볼트 점검 효율 개선 (불필요한 전체 읽기·AI 호출 제거), 폴더 rename/병합 시 잔여 페이지 자동 정리.

설치

npx dotbrain

v2.18.0 — Compounding Knowledge Loop

복리로 쌓이는 지식 — 주제 위키 (Compounding Knowledge Loop)

새 노트가 들어올 때마다 AI가 폴더·주제 페이지를 종합·갱신합니다. 기록이 쌓일수록 지식이 복리로 정리됩니다.

새 기능

• 주제 위키 (_Wiki/) — 여러 폴더에 흩어진 같은 주제를 하나의 페이지로 종합: 현재 이해 · 모순 · 노후 · 타임라인 · 멤버 노트. 새 노트마다 증분 재합성 (변경 없는 주제는 건너뜀).
• 폴더 개체 페이지 — 각 폴더의 폴더명.md에 개요 · 최근 흐름 · 핵심 노트를 AI가 유지.
• 링크 다이어트 — 문서당 관련 노트를 누적 12개로 재선별해 링크 과잉 방지 (사용자 작성 줄은 보존).
• 볼트 로그 (.meta/log.md) — ingest · 볼트 점검 · 마이그레이션 타임라인을 grep 가능한 한 줄 형식으로 기록.
• 노트 인덱스 주제 오버레이 — .meta/note-index.json에 노트별 소속 주제 표시.

개선 · 수정

• 방향성 링크(prerequisite/reference)의 역링크를 related로 올바르게 기록. 구버전 볼트를 위한 1회성 마이그레이션 포함.
• 단일 방향성 타입 섹션도 ### 그룹 헤더를 유지해 관계 유형이 라운드트립에서 유실되지 않음.
• 주제 합성 5개 섹션(현재 이해/모순/노후/타임라인/멤버 노트) 전부 검증 — 모순·타임라인이 조용히 누락되지 않음.
• AI 컴패니언 v18 — Claude Code(CLAUDE.md) + Codex(AGENTS.md), 탐구 결과 환류 규칙. (.cursorrules 지원 제거)
• 링크 재선별 동시성·중복 제거, 볼트 로그 쓰기 안정화.

설치

npx dotbrain

v2.17.0

What's new in v2.17.0

• Folder entity pages — every PARA folder gets a <folder>.md hub page with an AI-synthesized overview, key notes, and recent flow, kept fresh automatically (marker-based, user edits preserved). Folder summaries in the note index now come from these pages with zero extra AI calls.
• Hub-centric links — semantic linking now routes through folder hubs: hub pages are first-class link targets, direct cross-folder note-to-note links require a stronger signal, and boost-related folders link hub-to-hub. Graphs get dramatically cleaner.
• Freer inbox commands — "Inbox에 있는것들 Project에 넣어줘" now works: destinations can be a whole PARA category, and the raw instruction guides classification (per-file conditions like "회의록은 여신협회로, 나머지는 알아서"). Instructions that don't fit a structured command no longer error out.
• Cheaper forced-folder runs — when a command pins everything to one folder, the Stage 2 precise-model refinement is skipped (its decisions were discarded anyway); failure recovery still escalates.
• Popover freeze fix — fast cursor movement over hover-styled rows could pin the main thread at 100% CPU in a SwiftUI hover-update loop that survived closing the popover. Hover state is now debounced and the popover content is torn down on close.
• Folder lifecycle — merging a folder trashes its entity page (resynthesized on the next pass) instead of leaving a stray copy; renaming a folder renames its page. User-authored folder notes are never touched.
• Audit fixes — crash, data-loss, race, and security findings from the 2026-07 audit round.

v2.16.8

What's new in v2.16.8

• Natural-language commands — a command bar on the inbox and PARA-management views translates a Korean/English request into one safe DotBrain action (process inbox, create/rename/move folder, update folder description, complete/reactivate project). Inbox instructions can target one folder or a subset of files.
• Folder descriptions — user-authored folder descriptions are persisted and fed into the classifier context for more consistent placement.
• Better PARA classification — Area is now defined as an ongoing responsibility area you actively maintain (operating standards, policies, long-lived status), so ops/policy docs stop falling into Resource. Companion docs (CLAUDE.md/AGENTS.md/.cursorrules) updated to match.
• Faster Vault Inspector — progressive, cancellable folder loading instead of blocking on content hashing.
• CLI hardening — Claude/Codex CLI clients use their default model pipeline and run sandboxed/ephemeral with a termination guard.
• Note-index integrity — stale folder entries left by incremental updates are now pruned during vault checks.
• npm installer — removes a legacy login item that could double-launch DotBrain.

v2.16.7

CLI stability release.

• Fix broken-pipe handling for Claude CLI and Codex CLI stdin writes
• Ignore SIGPIPE at app process level so pipe failures do not terminate DotBrain
• Apply dynamic batching and provider-specific concurrency/content limits for CLI inbox processing
• Sync release version to Info.plist and npm/package.json

v2.16.3

Full Changelog: v2.16.2...v2.16.3

v2.16.2 — Reorg + Inbox Progress UX

v2.16.2 — Reorg + Inbox Progress UX (2026-03-11)

• fix: 위치 제안 Stage 1 대배치 응답이 불안정할 때 자동으로 배치를 분할 재시도해 0건으로 조용히 끝나는 문제 완화
• ux: 위치 제안 진행 문구를 단계별로 세분화하고, 재시도 상태를 루프처럼 보이지 않게 정리
• ux: 위치 제안 결과가 0건일 때도 상태 메시지가 유지되도록 개선
• ux: 인박스 정리 진행 문구도 추출/분류/이동/마무리 단계로 세분화하고 한영 로컬라이즈 적용
• ux: ProcessingView 상태 문구를 2줄까지 표시해 긴 진행 메시지가 잘리지 않도록 개선

v2.16.1

Performance: Classifier Optimization

• Dynamic batching: batch size adapts to file count (up to 25 per batch, was fixed at 5)
• Lower Stage 2 threshold: 0.8 → 0.6 — fewer expensive Sonnet/Pro calls for borderline files
• Confidence guidelines: detailed criteria in prompts so AI assigns higher confidence when folder match is clear
• Dynamic maxTokens: scales with batch size, capped at model limit (8192)

Affects: inbox processing, location suggestions, vault reorganization

v2.16.0

What's New

AI Statistics Improvements

• Show estimated token counts alongside cost with ~ prefix
• Monthly navigation (back/forward, up to 6 months history)
• CLI-based estimates marked with (estimated) label and info disclaimer
• Single-pass data aggregation for better performance
• Missing operation labels added (folder-relation, semantic-link-context)

Code Quality

• Replace all DispatchQueue.global with Task.detached for process timeouts
• Extract shared ShellEnvironment.scheduleTermination(of:after:) helper
• Proper timeout task cancellation on normal process exit
• Deduplicated Date.relativeFormatted extension

v2.15.5

Changes

• fixed the inbox organizer so it can auto-rescan remaining inbox items within the same run instead of requiring repeated manual clicks
• reduced update-time restart races by unloading the old LaunchAgent before quitting for update
• changed the installer LaunchAgent to avoid restarting on normal exit
• clarified the Full Disk Access guidance text to match the new flow