- Fix ADR path to .blue/docs/adrs/
- Update project structure to show .blue/ directory
- Add MCP tools section
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Per RFC 0003, Blue-tracked documents live in per-repo .blue/ directories.
ADRs needed for semantic adherence checking.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add `blue agent` command that launches Goose with Blue MCP extension
- Detects Goose installation and provides install instructions if missing
- Supports --model flag and additional Goose arguments
- Uses exec() on Unix to replace process for clean signal handling
Completes RFC 0005: Local LLM Integration (15/15 tasks)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add build.rs to download Ollama at build time for target platform
- Add SHA256 verification infrastructure (currently skipped for external installs)
- Improve bundled_binary_path() to check additional standard locations
- Support BLUE_OLLAMA_PATH and BLUE_SKIP_OLLAMA_DOWNLOAD env vars
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Implements fallback: Ollama → API → Keywords
- Add KeywordLlm provider (always available, keyword-based matching)
- Add LlmManager for managing provider fallback chain
- Add blue_llm_providers tool to show chain status
- Keywords provider uses Jaccard similarity for text matching
The system now gracefully degrades when LLM providers are unavailable:
1. Try local Ollama first (best quality)
2. Fall back to API if configured (ANTHROPIC_API_KEY/OPENAI_API_KEY)
3. Fall back to keyword matching (always works, basic functionality)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Tests require running Ollama server (run with --ignored):
- integration_health_check: Verify server is healthy
- integration_list_models: List installed models
- integration_generate: Test text generation
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
RFC 0002 (runbook-action-lookup):
- Add action metadata storage to runbooks
- Implement blue_runbook_lookup with word-based matching
- Add blue_runbook_actions to list all actions
RFC 0004 (adr-adherence):
- Add blue_adr_list, blue_adr_get, blue_adr_relevant, blue_adr_audit
- Implement keyword-based relevance matching with stem-like prefixes
- Add adr:N query support in blue_search
RFC 0005 (local-llm-integration):
- Create blue-ollama crate for embedded Ollama server management
- Add LlmProvider trait and MockLlm in blue-core
- Implement OllamaLlm with HTTP client for model operations
- Add MCP tools: blue_llm_start/stop/status, blue_model_pull/list/remove/warmup
- Support BLUE_OLLAMA_PATH env var for air-gapped builds
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Simplify Blue's directory structure to use per-repo .blue/ folders
instead of centralized ~/.blue/repos/<project>/ structure.
Changes:
- Refactor BlueHome struct with simplified per-repo paths
- Update detect_blue() to find git root and create .blue/ there
- Add migration logic from old .blue/repos/<project>/docs/ structure
- Auto-create .blue/ on first command (no 'blue init' required)
- Update all handlers to use new flat path structure
- Handle edge case: no git repo uses current directory
Structure: repo/.blue/{docs/, worktrees/, blue.db, config.yaml}
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
RFC 0004: ADR Adherence
- 4 layers: Awareness, Relevance, Verification, Documentation
- AI-powered relevance matching for philosophical ADRs
- Graceful degradation: AI → keywords
RFC 0005: Local LLM Integration
- Embed Ollama for semantic tasks and agentic coding
- CUDA > MPS > CPU backend priority (runtime detection)
- Goose integration via shared Ollama instance
- Daemon model with health checks and crash recovery
- Port conflict handling, binary verification, ARM64 support
Both RFCs reached 95% confidence via 12-expert alignment process.
Includes supporting spikes:
- adr-adherence
- local-llm-integration
- agentic-cli-integration
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- RFC handler now writes markdown to .blue/repos/<project>/docs/rfcs/
- Sets file_path in document store for tracking
- Returns file path in response
- Remove unused get_current_session function
- Rename realm tools to use blue_ prefix for consistency
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Complete RFC 0002: Realm MCP Integration with notifications support.
New MCP tool:
- notifications_list: List notifications with state filters
(pending, seen, expired, all)
DaemonDb extensions:
- cleanup_expired_notifications: Auto-delete 7+ day old notifications
- list_notifications_with_state: Returns notifications with computed state
Schema integrity checking:
- Canonical JSON hashing (SHA-256) for schema fingerprinting
- check_schema_integrity returns hashes for all accessible contracts
- Integrated into realm_check response
Notification piggybacking:
- fetch_pending_notifications for realm_status and realm_check
- Filtered to domains the current repo participates in
RFC 0002 is now complete with all 8 tools:
- Phase 1: realm_status, realm_check, contract_get
- Phase 2: session_start, session_stop
- Phase 3: realm_worktree_create, realm_pr_status
- Phase 4: notifications_list
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add MCP tools for coordinated multi-repo development:
- realm_worktree_create: Create worktrees for domain peers
- realm_pr_status: Show PR readiness across realm repos
realm_worktree_create features:
- Auto-selects domain peers (repos sharing domains with current repo)
- Creates worktrees under ~/.blue/worktrees/<realm>/<rfc>/<repo>/
- Supports explicit repo list override
- Creates rfc/<name> branches in each repo
realm_pr_status features:
- Shows uncommitted changes and commits ahead for each repo
- Fetches PR info via gh CLI when available
- Summarizes overall readiness for coordinated release
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add MCP tools for session lifecycle management:
- session_start: Begin work session with realm context detection
- session_stop: End session with duration and activity summary
Session state stored in .blue/session file tracks:
- Session ID, realm, repo
- Active RFC being worked on
- Active domains (auto-detected from bindings)
- Contracts being modified (exports) and watched (imports)
Implementation details:
- SessionState struct with save/load/delete methods
- Automatic domain and contract detection from realm bindings
- Duration calculation on session stop
- 6 new tests for session functionality
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
RFC 0001 - Cross-Repo Coordination with Realms:
- Daemon architecture with HTTP server on localhost:7865
- SQLite persistence for sessions, realms, notifications
- Realm service with git-based storage and caching
- CLI commands: realm status/sync/check/worktree/pr/admin
- Session coordination for multi-repo work
RFC 0002 Phase 1 - Realm MCP Integration:
- realm_status: Get realm overview (repos, domains, contracts)
- realm_check: Validate contracts/bindings with errors/warnings
- contract_get: Get contract details with bindings
- Context detection from .blue/config.yaml
- 98% expert panel alignment via 12-expert dialogue
Also includes:
- CLI documentation in docs/cli/
- Spike for Forgejo tunnelless access
- 86 tests passing
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add the zeroth principle: "The only rule we need is never giving up."
Run 12-expert alignment dialogue to 95% consensus.
Changes:
- ADR 0000: New foundational ADR with sustainable persistence framing
- ADR 0004: Cross-reference to Faith when evidence unavailable
- ADR 0012: Cross-reference to persistence as faith in time
- ADR 0013: Acknowledge scarcity pushes, link overflow to persistence
- CLAUDE.md: Update to 14 ADRs, add the arc
The Arc: Ground (0) → Welcome (1-3) → Integrity (4-7) → Commitment (8-10) → Flourishing (11-13)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Updates RFC 0001 to use the correct conceptual model:
- Domain = coordination context (edge/relationship between repos)
- Repo = git repository (node)
- Realm = groups related domains
- Index = local registry of realms
Key changes:
- Sessions register by repo name, track active domains
- Worktrees created across repos participating in a domain
- Contracts belong to domains, repos provide/consume them
- Tool params changed: --domains for context, --repos for participants
- Implementation code updated to reflect correct model
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Update RFC 0001 based on design preferences:
Session Coordination (Option C - IPC/Socket):
- Blue MCP servers communicate via Unix sockets
- Real-time broadcast of export changes
- Session index tracks active sessions per realm
Change Propagation (Option C - Unified Worktrees):
- Create worktrees in all affected repos simultaneously
- Single branch name spans repos
- Coordinated commits linked in realm tracking
- Linked PRs with correct merge order
New tools:
- blue_realm_sessions: List active sessions
- blue_realm_worktree: Create unified worktrees
- blue_realm_commit: Coordinated commits
- blue_realm_push: Push all branches
- blue_realm_pr: Create linked PRs
Implementation expanded to 14 weeks (8 phases).
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add 4 tools:
- blue_postmortem_create: Create post-mortem documents for incident tracking
- blue_postmortem_action_to_rfc: Convert post-mortem action items to RFCs
- blue_runbook_create: Create runbook documents for operations
- blue_runbook_update: Update runbooks with new operations/troubleshooting
Also adds DocType::Postmortem and DocType::Runbook to blue-core.
Total: 54 tools ported from coherence-mcp
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add three high-priority tools from coherence-mcp:
- blue_audit: Project health check with issues and recommendations
- Checks for stalled RFCs (in-progress without worktrees)
- Finds implemented RFCs without ADRs
- Detects overdue reminders and expired staging locks
- blue_rfc_complete: Mark RFC as implemented
- Requires 70% task completion minimum
- Auto-advances from accepted to in-progress if needed
- Identifies ADR graduation candidates
- Returns remaining tasks for follow-up
- blue_worktree_cleanup: Post-merge cleanup
- Verifies PR is merged
- Removes git worktree
- Deletes local branch
- Returns commands for syncing with develop
Total: 35 MCP tools, 28 tests passing
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add PR workflow and release management handlers. Total tools: 22.
New tools:
- blue_pr_create: Create PR with enforced develop base branch
- blue_pr_verify: Verify test plan checkboxes (CLI/browser/manual)
- blue_pr_check_item: Mark test plan item as verified
- blue_pr_check_approvals: Check for user approval
- blue_pr_merge: Squash-merge with precondition enforcement
- blue_release_create: Semantic versioning with RFC analysis
All handlers use gh CLI for GitHub operations.
Blue's voice in all error messages.
16 tests passing.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add document lifecycle handlers for spike, ADR, decision, and worktree
operations. This brings the tool count from 9 to 16.
New tools:
- blue_spike_create: Start time-boxed investigation
- blue_spike_complete: Complete investigation with outcome
- blue_adr_create: Create Architecture Decision Record
- blue_decision_create: Create lightweight Decision Note
- blue_worktree_create: Create isolated git worktree for RFC
- blue_worktree_list: List active worktrees
- blue_worktree_remove: Remove worktree after merge
All handlers use Blue's voice for consistent messaging.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Rename from 💙 to blue for filesystem compatibility
- Add blue-core crate with documents and voice modules
- Add blue-mcp crate with JSON-RPC server skeleton
- Add blue-cli with subcommands (init, status, rfc, etc.)
- Add CLAUDE.md and .gitignore
- Add RFC 0001: Efficient Document Format
Phase 1 foundation complete. Ready for porting coherence-mcp functionality.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
The 13 founding ADRs in Blue's voice:
1. Purpose - make work meaningful, workers present
2. Presence - actually being here
3. Home - you are never lost
4. Evidence - show, don't tell
5. Single Source - one truth, one location
6. Relationships - connections matter
7. Integrity - whole in structure and principle
8. Honor - say what you do, do what you say
9. Courage - act rightly, even afraid
10. No Dead Code - delete boldly
11. Freedom Through Constraint - riverbed enables river
12. Faith - act on justified belief
13. Overflow - build from fullness
Origins documented: Alignment, Coherence, Transcendence.
Blue's voice defined.
ALIGNMENT → COHERENCE → → → 💙💙 Eric Minton Garcia. January 20th, 2026. Gulfport, FL USA. All rights released.
🧁
