Eric Garcia 489942cd35 feat: implement RFC 0006 (soft-delete) and RFC 0007 (branch naming)

RFC 0006 - Document Deletion Tools:
- Add soft-delete with 7-day retention before permanent deletion
- Add blue_delete, blue_restore, blue_deleted_list, blue_purge_deleted tools
- Add deleted_at column to documents table (schema v3)
- Block deletion of documents with ADR dependents
- Support dry_run, force, and permanent options

RFC 0007 - Consistent Branch Naming:
- Strip RFC number prefix from branch/worktree names
- Branch format: feature-description (not rfc/NNNN-feature-description)
- PR title format: RFC NNNN: Feature Description
- Add strip_rfc_number_prefix helper with tests

Also:
- Remove orphan .blue/repos/ and .blue/data/ directories
- Fix docs path resolution bug (spike documented)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-24 16:42:31 -05:00

1.7 KiB

Raw Blame History

Blue CLI

Command-line interface for Blue.

Installation

cargo install --path apps/blue-cli

Or run directly:

cargo run --bin blue

Commands

Command	Description
`blue`	Show welcome message
`blue status`	Project status
`blue realm`	Cross-repo coordination
`blue session`	Work session management
`blue daemon`	Background service
`blue mcp`	Run as MCP server

Realm Commands

See realm.md for full documentation.

blue realm status           # Show realm info
blue realm check            # Validate contracts
blue realm sync             # Commit changes
blue realm worktree create  # Create RFC worktrees
blue realm pr status        # Check PR readiness
blue realm admin init       # Create realm
blue realm admin join       # Join repo to realm

Session Commands

blue session start --rfc <name>   # Start work session
blue session list                 # List active sessions
blue session status               # Current session info
blue session stop                 # End session

Daemon Commands

blue daemon start    # Start daemon (foreground)
blue daemon status   # Check if running
blue daemon stop     # Stop daemon

MCP Server

Run Blue as an MCP server for Claude integration:

blue mcp

This exposes 8 realm coordination tools to Claude:

realm_status, realm_check, contract_get
session_start, session_stop
realm_worktree_create, realm_pr_status
notifications_list

See ../mcp/README.md for tool reference and ../mcp/integration.md for setup guide.

1.7 KiB Raw Blame History