v0.9.0: Vertical Slice Architecture Refactoring

Overview

Complete architectural overhaul reorganizing the codebase into self-contained feature slices. This release establishes a foundation optimized for AI-assisted development and long-term maintainability.

Highlights

• 21 self-contained feature slices - each owning its store, services, components, and documentation
• README cascade - Root → core → features → individual feature READMEs
• 348 tests passing (up from 238)
• CLAUDE.md condensed from ~533 to ~188 lines
• Zero lint warnings, zero TypeScript errors

Architecture Transformation

Reorganized from scattered files to vertical slice pattern:

• src/core/ - shared infrastructure (store, services, hooks, components)
• src/features/ - 21 self-contained feature slices

Renamed Features

Old	New
proto-node	dreamnode-creator
edit-mode	dreamnode-editor
radial-buttons	action-buttons
github-sharing	github-publishing
social-resonance	social-resonance-filter
updates	dreamnode-updater

Bug Fixes

• Fix hooks order violations in DreamNodeCreator3D and DreamNodeEditor3D
• Fix copilot mode option key handling race condition
• Fix transcription/web-link-analyzer status checks when services not initialized
• Fix dreamnode-editor: wrong image display, search display, self-toggle

See CHANGELOG.md for full details.

Epic 8: Coherence Beacon System

Changelog

All notable changes to the InterBrain project will be documented in this file.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.

[0.8.0] - 2025-10-24 - Epic 8: Coherence Beacon System (Complete)

Added

Coherence Beacon Discovery System (Feature #336)

• Automatic detection of new supermodule references in DreamNodes
• Modal-based acceptance/rejection workflow for proposed relationships
• Persistent rejection tracking to prevent re-prompting declined beacons
• Intelligent clone and submodule linking for accepted beacons
• Check for updates command for manual beacon discovery

Bidirectional Relationship Tracking (Feature #337)

• Git hooks system for automatic supermodule/submodule synchronization
• Post-commit hook detecting .gitmodules changes and updating .udd files
• Sovereign repository pattern - child repos track their own supermodules array
• Repair logic in sync command to fix existing submodule relationships
• Bidirectional UUID-based relationship tracking across entire DreamNode graph

Radicle Network Integration (Feature #338)

• Complete Radicle CLI integration with passphrase management
• Batch initialization and sharing commands for Radicle DreamNodes
• Automatic Radicle node management with startup/shutdown lifecycle
• Smart clone conflict handling with Radicle ID detection
• Radicle ID persistence in .udd files for duplicate prevention
• Email export integration with Radicle fallback URIs
• Cross-platform Radicle support with path resolution

GitHub Pages Publishing System (Feature #337)

• Static DreamSong site builder with standalone HTML viewer
• Automated gh-pages branch deployment for public sharing
• UUID-based link resolver for rename-proof navigation
• "View on Web" button in fullscreen DreamSong view
• Recursive submodule sharing with title-based repository naming
• Unpublish command with recursive cleanup of shared submodules
• Bidirectional submodule sync (add AND remove orphaned references)

Universal DreamNode Cloning (Feature #337)

• Mixed Radicle/GitHub/UUID batch clone support in single command
• Automatic .udd file initialization for GitHub clones
• GitHub clone optimization (main branch only, faster initialization)
• Automatic semantic search indexing for newly cloned nodes
• Smart constellation positioning with proper metadata handling

Radial Action Button System (Feature #339)

• Option-key triggered radial menu with 10 context-aware buttons
• Dynamic command mapping based on node state (published/unpublished, active call, etc.)
• Conditional button visibility (GitHub share for dreams, video call for dreamers)
• Hover labels with clean UX positioning around selected node
• Special positioning for active video call button during copilot mode
• Obsidian icon integration using setIcon API

Songline Feature System

• Audio recording integration for conversation capture
• LLM-powered clip generation and summarization
• Perspectives UI for displaying multiple DreamerNode viewpoints
• Conversations section for DreamerNodes showing recorded dialogues
• Timestamp synchronization with audio playback
• Vault-path-based audio file resolution

DreamSong Enhancements

• Unified README section as collapsible element at bottom
• Edit buttons for Canvas and README files in fullscreen view
• Markdown rendering of README content with Obsidian native API
• Improved DreamerNode vs Dream node conditional rendering
• Fullscreen button reliability improvements

Canvas Auto-Layout Command

• Automatic positioning of canvas nodes for linear DreamSong flow
• Intelligent media-text pair layout with proper spacing
• Text height calculation for optimal card sizing
• Vertical spacing normalization for tighter layouts

PascalCase Naming System (Feature #337)

• Unified PascalCase conversion for all DreamNode titles
• Migration tools for converting existing kebab-case/snake_case repos
• Bidirectional title conversion preserving human readability
• Title sanitization with robust kebab/snake case normalization
• Batch migration command for updating entire vaults

Digital Campfire Metaphor

• Rebranded video calls as "Digital Campfire" with flame-kindling icon
• Poetic language: "Initiate" and "Extinguish" instead of start/end
• Enhanced active call button positioning at -45° (lower-right quadrant)
• Robust error handling for early video call termination

Technical Achievements

Git Hooks Architecture

• Node.js-based hook-helper script for complex git operations
• Pre-commit hook for template initialization and canvas validation
• Post-commit hook for automatic bidirectional relationship updates
• Non-blocking hook execution with comprehensive error logging
• Reusable hook utilities shared across multiple hook types

GitHub Integration Infrastructure

• GitHub CLI detection with explicit path resolution
• Vite bundle configuration for Node.js built-ins
• Static site viewer with standalone asset management
• Canvas path auditing and repair for migration scenarios
• Robust submodule path resolution for sharing workflows

Radicle Service Layer

• Passphrase prompt integration with macOS Keychain fallback
• TTY-less rad init using stdin piping
• Radicle ID extraction from git config
• Duplicate detection using persisted Radicle IDs
• Cross-platform CLI detection (macOS, Linux, Windows placeholders)

Universal Clone Architecture

• URI protocol handler supporting rad:// and https:// schemes
• Mixed source batch processing with parallel cloning
• Constellation positioning optimization (100x faster)
• Duplicate detection across Radicle and GitHub sources
• Smart conflict resolution with safe existing file handling

Canvas Submodule Synchronization

• Detection of orphaned submodules removed from canvas
• Automatic git submodule removal with history suppression
• Bidirectional tracking updates in both parent and child repos
• Repair logic for fixing existing incomplete relationships
• Canvas path validation and warning system

Radial Button Architecture

• Dynamic command resolution based on runtime state
• Conditional visibility system with shouldShow predicates
• Icon system using Obsidian's Lucide integration
• Billboard-based 3D positioning with HTML overlay
• Fade-in/fade-out animations with opacity transitions

Option Key Tracking System

• Robust cross-platform key state detection
• Multiple event listeners for redundancy (keydown, keyup, blur)
• State reset on window blur to prevent stuck keys
• Integration with both radial buttons and search mode

Development Workflow Enhancements

• Local-only branch workflow (epic and feature branches never pushed)
• Main branch as single source of truth for remote
• Comprehensive documentation updates in CLAUDE.md
• Known issues tracking for deferred technical debt

Enhanced

Constellation Positioning

• Batch position updates for dramatic speed improvements
• Optimized duplicate detection (10x faster for Radicle nodes)
• Anti-aliasing improvements for 3D rendering quality
• Smart repositioning after cloning with metadata awareness

Error Handling & Resilience

• Graceful handling of malformed .udd files during vault scan
• Early video call termination without scary error messages
• EOFError detection and filtering in transcription pipeline
• Process lifecycle management with force-kill fallbacks
• Reduced force-kill timeout (5s → 2s) for faster cleanup

Debug Logging & Observability

• Comprehensive logging across all Radicle operations
• Canvas path audit trails for migration debugging
• Submodule sync operation transparency
• Video call lifecycle event tracking
• README markdown rendering diagnostics

Code Quality

• 238 tests passing with zero TypeScript errors
• Clean lint output across entire codebase
• Public API exposure for CoherenceBeaconService
• Unused variable cleanup and error handling improvements

Fixed

• Coherence Beacon clone handling with PascalCase conversion
• GitHub clone constellation return bug (read positions from store)
• Submodule path resolution for git submodule add operations
• Canvas path updating during PascalCase migration
• Broken submodule recovery (chicken-egg initialization problem)
• Module import errors in radial button configuration
• VaultService method name in Songline feature detection
• Timestamp synchronization in DreamSong perspectives
• README markdown rendering async API handling
• Fullscreen button reliability across all scenarios
• Button conditions and dynamic label generation
• Radial button position calculation (label no longer shifts button)

[0.7.0] - 2025-10-05 - Epic 7: Conversational Copilot System (Complete)

Added

Complete Copilot System with Real-time Search (Feature #327)

• Person-centered conversational mode with semantic search-driven UX
• Real-time transcription with 500-character context window for semantic search
• Option key press-and-hold to show/hide search results honeycomb
• Fullscreen DreamTalk/DreamSong overlays on dreamspace canvas
• Shared nodes tracking with bidirectional relationship management
• README and docs/ directory indexing for documentation-aware search

FaceTime Integration & Call Automation (Feature #333)

• AppleScript-based FaceTime call initiation from Obsidian commands
• Contact metadata system (email/phone) for person DreamNodes
• Automatic copilot mode activation on call start
• Integrated end-call command with automatic cleanup
• Seamless conversation workflow from call to copilot mode

Real-Time Transcription System (Feature #335)

• whisper_streaming integration with LocalAgreement-2 for duplicate prevention
• Python CLI with sub-5-second latency speech-to-text
• Self-contained virtual environment with automatic dependency management
• Obsidian process management via command palette
• Timestamped markdown output with ins...

Release v0.7.0: Epic 7 - Conversational Copilot System

Epic 7: Conversational Copilot System (Complete)

Added

Complete Copilot System with Real-time Search (Feature #327)

• Person-centered conversational mode with semantic search-driven UX
• Real-time transcription with 500-character context window for semantic search
• Option key press-and-hold to show/hide search results honeycomb
• Fullscreen DreamTalk/DreamSong overlays on dreamspace canvas
• Shared nodes tracking with bidirectional relationship management
• README and docs/ directory indexing for documentation-aware search

FaceTime Integration & Call Automation (Feature #333)

• AppleScript-based FaceTime call initiation from Obsidian commands
• Contact metadata system (email/phone) for person DreamNodes
• Automatic copilot mode activation on call start
• Integrated end-call command with automatic cleanup
• Seamless conversation workflow from call to copilot mode

Real-Time Transcription System (Feature #335)

• whisper_streaming integration with LocalAgreement-2 for duplicate prevention
• Python CLI with sub-5-second latency speech-to-text
• Self-contained virtual environment with automatic dependency management
• Obsidian process management via command palette
• Timestamped markdown output with instant file updates
• Cross-platform support (macOS, Windows, Linux)

Conversation Recording & Export System (Feature #331)

• DreamNode invocation tracking during conversations
• Real-time transcript embedding of invoked nodes
• AI-powered conversation summaries via Claude API
• Email export with pre-filled Apple Mail drafts
• Obsidian URI deep links for one-click node cloning
• Batch clone links for sharing multiple DreamNodes
• Graceful fallback when AI API unavailable

Technical Achievements

Conversational Architecture

• Copilot spatial mode with person node at center
• Semantic search integration driving real-time node discovery
• 500-char rolling context window for focused search relevance
• Auto-hide/show ribbon for cleaner video call interface
• Multi-window transcript refocus with focus restoration mechanisms

Python Integration Innovation

• Virtual environment isolation with pip dependency management
• Symlink-aware script path resolution for development workflow
• Python 3.13 compatibility with cross-platform dependency handling
• Process lifecycle management with graceful cleanup
• stdout/stderr monitoring for real-time feedback

AI & LLM Integration

• Provider abstraction layer supporting multiple LLM backends
• Claude API integration via Obsidian's requestUrl (CORS workaround)
• Conversation summarization with invocation context awareness
• Plugin settings tab for API key configuration
• Future-ready architecture for OpenRouter and open-source models

Deep Linking System

• Custom Obsidian URI protocol handlers (`obsidian://interbrain-clone`)
• Single node and batch clone URI support
• Proof-of-concept implementation with console logging
• Foundation for future peer-to-peer DreamNode sharing
• Plain text email format with clickable deep links

macOS System Integration

• AppleScript execution via Node.js child_process
• Apple Mail draft generation with pre-filled content
• FaceTime automation with contact resolution
• Electron window focus management for dictation continuity
• System-level integration without external dependencies

🤖 Generated with Claude Code

v0.6.0 - Epic 6: DreamWeaving Operations Complete

Epic 6: DreamWeaving Operations Complete 🎯

This major release completes Epic 6 with comprehensive DreamNode interaction capabilities, full-screen DreamSong experiences, and sophisticated canvas integration.

Key Achievements

DreamNode Flip Animation System (Feature #324)

• Seamless 3D flip animation revealing DreamSong content on node backside
• Professional flip button with 3x larger hit area and cursor feedback
• Bidirectional flipping with proper animation timing and state management
• Integrated with Obsidian's canvas parsing system for real content display
• Surgical precision fixes for billboard distortion and hit detection

Full-Screen DreamSong Experience (Feature #325)

• Dedicated full-screen leaf for immersive DreamSong exploration
• Ctrl+D hotkey integration with smart split-screen detection
• Real-time file change monitoring with automatic content updates
• Comprehensive PDF support and enhanced undo-redo functionality
• Command integration with leaf manager for consistent navigation

DreamWeaving Canvas Integration (Feature #286)

• Complete .canvas and .link file support across the system
• Canvas-to-DreamSong parsing with three-layer architecture
• Media path resolution using data URLs for instant playback
• Topological ordering preservation for logical content flow

Constellation Layout Enhancement (Feature #311)

• Force-directed positioning with stabilized physics simulation
• Bidirectional relationship visualization with arrow systems
• Deterministic layout algorithm ensuring consistent node positioning
• Performance optimizations for smooth animation and interaction
• Comprehensive edge case handling for single nodes and empty states

Technical Highlights

• Code Quality: Achieved pristine TypeScript compilation (0 errors, 11 justified 'any' uses)
• Test Coverage: All 208 tests passing with comprehensive validation
• Architecture: Clean service layer separation with proper dependency injection
• Performance: Optimized canvas parsing with intelligent caching and structural hashing

Epic 6 Success Criteria ✅

• All child specifications completed
• Features integrated and tested
• DreamNode flip animation with DreamSong reveals
• Full-screen DreamSong exploration workflows
• Canvas integration with .link file support
• Constellation layout with force-directed positioning
• Quality assurance and documentation complete

This release establishes the complete DreamWeaving foundation, enabling seamless transitions between spatial exploration and immersive content consumption.

Next: Epic 7 planning and specification begins.

InterBrain Plugin v0.5.0

InterBrain Plugin v0.5.0

Epic 4 & 5 Complete: Liminal Web Layout System + Semantic Search System

🚀 Ready to Install & Try!

This release provides the complete InterBrain plugin ready for installation in Obsidian. No development setup required - just download, extract, and drag to your vault's plugins directory.

✨ What's Working

• Liminal Web Navigation: Click any node to focus it, related nodes orbit around
• In-Space Editing: Edit node content and relationships in 3D space (use "Enter Edit Mode" command)
• Drag-and-Drop Creation: Drop files to create connected DreamNodes instantly
• Semantic Search: Local AI-powered search with Ollama integration (requires setup)
• Search-to-Creation: Transform any search query into a new DreamNode
• Undo/Redo Navigation: Command+Z/Shift+Z through your layout history

📦 Installation

1. Download interbrain-plugin-v0.5.0.zip below
2. Extract to get the interbrain folder
3. Drag to <your-vault>/.obsidian/plugins/
4. Enable in Obsidian Settings → Community plugins

🔧 Essential Commands

• "Enter Edit Mode": Edit nodes and relationships in 3D space
• "Ollama: Check Status": Verify Ollama setup for semantic search
• "Full Index": Index your DreamNodes (required after Ollama setup)
• "Activate Search Interface": Use semantic search (requires Ollama)

🧠 Semantic Search Setup (Optional)

1. Install Ollama
2. Run ollama pull nomic-embed-text
3. Use "Ollama: Check Status" to verify
4. Run "Full Index" to enable search

Note: Basic liminal web functionality works without Ollama.

🌱 Try It Out

Start mapping your liminal web:

• Create nodes for ideas/projects you care about
• Focus any node to enter liminal web mode
• Use "Enter Edit Mode" to edit in 3D space
• Drag pictures of collaborators (name files with their names)
• Watch relationships organize spatially

⚠️ Development Status

Work-in-progress software. All code built transparently on GitHub. Use your judgment when installing development software.

Platform: Developed on macOS, likely cross-platform compatible but not actively tested on Windows/Linux.

Release v0.4.0: Epic 5 - Semantic Search System

🎉 Epic 5 Complete: Semantic Search System

Transformational milestone in the InterBrain project establishing comprehensive semantic search capabilities with local AI sovereignty.

🎯 Major Features Delivered

Intelligent Indexing System (Feature #322)

• Complete IIndexingService interface with IndexingService implementation
• Vector data persistence across sessions via Zustand store with Map serialization
• Command palette integration with async operation patterns and progress indicators
• Git-based change detection with intelligent delta updates
• Background processing with non-blocking operations

Semantic Search Implementation (Feature #290)

• Ollama Local Embedding API integration (sovereign AI using local models)
• Modular feature architecture: complete vertical slice at src/features/semantic-search/
• Zustand store slice pattern with clean state management
• 8 semantic search commands across 3 organized command files
• Auto-indexing pipeline with git integration

Search-as-DreamNode Interface (Feature #323)

• Revolutionary UX paradigm: search queries become temporary DreamNodes
• SearchNode3D component with real-time visual feedback during query typing
• Save animation system with seamless query-to-node transformation
• Context-aware search activation with spatial layout switching
• Multi-modal support (drag-drop files, images, PDFs)

Honeycomb Search Layout (Feature #280)

• Mathematical precision for 1-36 node positioning with perfect hexagonal grid
• Adaptive ring distribution with optimal spacing ratios
• Integration with semantic search for result visualization
• Performance optimization with efficient position calculations

🚀 Technical Achievements

Architecture Excellence

• Local AI Sovereignty: Complete independence from cloud services
• Vertical Slice Design: Self-contained features ready for npm extraction
• Cross-Session Persistence: Vector data survives plugin reloads
• Experimental Branch Archiving: Systematic preservation of alternative approaches
• Modular Architecture: Easy integration of future AI models

Code Quality Perfection

• 179 Tests Passing: Comprehensive test coverage for all new features
• Zero Warnings: Complete codebase with 0 lint warnings and 0 TypeScript errors
• Type Safety: Systematic TypeScript implementation with proper typing
• Performance Optimized: Background processing with real-time feedback

📦 Implementation Scale

Core Infrastructure: 2,500+ lines of semantic search functionality

• src/features/semantic-search/ - Complete vertical slice implementation
• src/services/indexing-service.ts (446 lines) - Indexing infrastructure
• tests/services/indexing-service.test.ts (483 lines) - Comprehensive tests
• Enhanced 15+ existing files with semantic search integrations

🌟 Innovation Highlights

Revolutionary UX Paradigms

• Search-as-Creation: Search queries become nodes seamlessly
• Mathematical Layout Precision: Honeycomb grid with semantic distance visualization
• Real-time Visual Feedback: Live query typing with semantic result updates

Technical Innovations

• Intelligent Delta Algorithms: Git commit-hash based change detection
• Command Palette UX Patterns: Async operation handling without UI blocking
• Error Resilience: Graceful degradation when semantic search unavailable

🎯 Strategic Impact

Architecture Foundation

Epic 5 establishes the technical foundation for:

• Advanced Semantic Capabilities: Ready for similarity calculations and query processing
• Multimodal Integration: Architecture supports future image/video embedding
• DreamOS Evolution: Complete semantic search system ready for operating system integration
• AI Model Flexibility: Easy integration of future Ollama models or alternatives

Breaking Changes

None. All changes are backward compatible with existing Epic 1-4 functionality.

Migration Notes

No migration required. Semantic search features are opt-in and enhance existing workflows.

---

This release represents a transformational milestone in the InterBrain project, establishing the foundation for advanced semantic capabilities and future AI-powered collective sensemaking.

🤖 Generated with Claude Code

v0.3.0 - Epic 3: DreamNode Management System

Added

Service Layer Architecture

• Interface-based service pattern with runtime switching capability
• MockDreamNodeService for fast UI iteration without file system operations
• GitDreamNodeService for real git repository management
• Command palette commands for switching between mock and real data modes
• Session storage persistence for mock data development

Git Template System

• Complete DreamNode template stored in plugin directory
• Automatic git repository initialization with git init --template
• Pre-configured git hooks for coherence beacon updates
• UDD metadata system with JSON-based node information
• 4 new command palette commands for template operations

Visual Git State Indicators

• Three-tier visual state hierarchy for DreamNodes
• Red glow for uncommitted or stashed changes (work-in-progress)
• Blue glow for committed but unpushed changes (ready to share)
• Clean state (no glow) for synchronized repositories
• Robust detection using git status --porcelain=v1 --branch

Creator Mode Workflow

• Auto-stash pattern for workspace isolation
• Seamless entry/exit from work-in-progress states
• Git stash integration for preserving uncommitted changes
• Safe commit workflow with automatic stash clearing
• Protection against losing work during mode transitions

Proto-node Creation System

• In-space node creation with unified animation system
• Smooth transitions from proto-nodes to full DreamNodes
• Integration with drag-drop system for DreamTalk assignment
• Visual feedback during creation process

Universal Drag-Drop Hit Detection

• Native Three.js scene-based raycasting system
• Scale-aware hit detection across all zoom levels
• Invisible hit spheres that travel with visual nodes
• Flawless interaction at any viewing distance
• Support for both click selection and drag operations

Technical Achievements

Code Quality

• 101 unit tests passing (up from 84 in Epic 2)
• Comprehensive test coverage for all new services
• Mock implementations for all service interfaces
• Zero lint warnings or type errors

Architecture Innovations

• Service layer abstraction enabling clean separation of concerns
• Dynamic runtime service swapping for development efficiency
• Unified animation system for consistent visual transitions
• Shared styling infrastructure (dreamNodeStyles.ts)
• Command-driven architecture with service delegation

Foundation for Epic 4

This release establishes the complete DreamNode management foundation for Epic 4 (Git Operations Abstraction), with service layer architecture, visual state management, and robust git integration patterns ready for user-friendly Save/Share paradigm implementation.

v0.2.0 - Epic 2: 3D Spatial Visualization System

Epic 2: 3D Spatial Visualization System

Major Features Added

• React Three Fiber Integration: Seamless 3D rendering within Obsidian workspace
• DreamNode 3D Components: Star rendering architecture with performance optimization
• Google Earth-Style Controls: Virtual trackball rotation without gimbal lock
• Fibonacci Sphere Layout: Perfect spherical distribution using golden ratio
• Dynamic View Scaling: Apple Watch-style distance-based scaling system
• Advanced State Management: Extended Zustand store with spatial state

Technical Achievements

• 84 Unit Tests Passing (up from 47 in Epic 1)
• Zero Lint Warnings: Complete TypeScript type safety
• Performance Optimized: Static camera + rotatable world architecture
• Scalable Foundation: Supports thousands of nodes with mathematical precision

Architecture Innovations

• Static camera approach eliminates gimbal lock issues
• Dream Graph Orchestrator pattern for unified layout management
• Unified rotation mathematics eliminating momentum distortion
• Professional development workflows with comprehensive testing

What's Next

This release establishes the complete 3D spatial visualization foundation for Epic 3 (DreamNode Management System), with all core spatial algorithms, interaction patterns, and rendering systems in place.

---

A complete 3D spatial visualization system ready for knowledge management workflows.

v0.1.0 - Epic 1: Plugin Infrastructure

Epic 1: Plugin Infrastructure

Major Achievements

• Obsidian Plugin Foundation: Complete plugin boilerplate with successful integration
• Modern Build System: Vite-based dual development workflow (browser + plugin)
• Command Palette Architecture: 8 core commands for all plugin functionality
• Service Layer: Clean abstraction with UI, Git, DreamNode, and Vault services
• State Management: Zustand reactive store for centralized state
• Comprehensive Testing: 47 unit tests with full Obsidian API mocking

Foundation Established

This release establishes the complete foundation for Epic 2 (3D Spatial Visualization) and beyond, with clean architecture patterns and comprehensive testing coverage ensuring sustainable development.

Testing

• All 47 tests passing
• Complete lint and typecheck validation
• Service layer integration verified

---

This is the foundational release that enables all future InterBrain development.