codebone v2.0

codebone 2.0

Windows signing: The Windows 2.0 installer and application are unsigned. Microsoft Defender SmartScreen may block launch and show an unknown publisher. A trusted signing identity is not configured. Only proceed with downloads from this official release that you trust; do not disable SmartScreen globally. SHA-256 files verify download integrity, not publisher identity.

• 2026-10-16

Added

• Windows x64 desktop app with a native tray menu, project selection, GitHub cloning,
  scan/pause/cancel controls, map-agent settings and saved scan import/export.
• Self-contained Windows application, portable ZIP and per-user installer.
• Windows CPU inference for the pinned built-in model and encrypted provider-key storage.
• Bundled Windows MCP executable and explicit coding-client registration.
• Windows build validation covering the packaged UI, model, HTTP API, MCP and installer.

Changed

• npm package and command renamed to cbone (npx cbone).
• Shared Windows-native data/log paths and cross-platform npm bridge discovery.
• macOS remains supported with its existing native app and Metal backend.

Windows x64: installer or portable ZIP. macOS: Apple Silicon DMG.

codebone v1.8

Official Milestone Full Release (Current)

🎯 Milestone Goal

Implement comprehensive Domain-Driven Design (DDD) internal architecture and multi-language codebase extraction (Bounded Contexts, Aggregate Roots, Value Objects, Domain Events, Repositories, Domain Services), combined with 1-click GitHub repository cloning, workspace synchronization, and automated background scanning.

Added

• Domain-Driven Design (DDD) Internal Architecture:
  • Re-architected codebone internally with clean Hexagonal/DDD layers:
    • src/domain/: Pure domain models (ArchitectureGraph aggregate root, BoundedContext, DDDRole, TacticalSymbol, FileRecord) and ports (StoragePort, AnalysisProviderPort).
    • src/application/: Dedicated application use-cases (GetArchitectureContextUseCase, ScanProjectUseCase, ReconcileArchitectureUseCase, AddGitHubRepositoryUseCase).
  • Seamlessly bound use cases to CodeBoneService (context_use_case, scan_use_case, reconcile_use_case, github_use_case).
• Tactical & Strategic DDD Codebase Extractor:
  • Deterministic AST and pattern extractor (src/domain/extractor.py) across Python, TypeScript/JavaScript, Go, Rust, Java, and C#.
  • Automatic strategic Bounded Context inference from directory topologies.
  • Tactical extraction of Aggregate Roots, Value Objects, Domain Events, Repositories, and Domain Services.
• Rich DDD Context for AI Agents:
  • cb() overview and search formatting now render ## Bounded Contexts and ## Entities (Aggregates, Value Objects, Repositories, Domain Services) with precise role badges ([Context: ...] [Aggregate Root: ...]).
• Native GitHub Repository Connection:
  • Add projects by URL (https://github.com/owner/repo, git@github.com:...) or slug (owner/repo) directly into managed workspace ~/CodeboneProjects/.
  • Fast shallow clone (--depth 1) with automatic fallback to zip archive download.
  • Native macOS menu bar dialog (Projects > + Add GitHub Repo...) with background download & instant scan.
  • 1-Click Sync / Git Pull action in project submenus for fast-forward updating and incremental scanning.
  • REST API endpoint (POST /codebone/projects/add_github) and MCP tool (codebone_add_github_repo).

Changed

• Entity Indexing & Persistence: Extended SQLite schema and inverted index to persist and query tactical DDD components and bounded contexts with zero overhead.
• Documentation & Consistency: Bumped project version to 1.8 across package manifests, Homebrew formula, badges, and documentation.

---

---

Full history: CHANGELOG.md

codebone v1.7

Official Milestone Full Release (Current)

🎯 Milestone Goal

Establish true hybrid scanning combining deterministic multi-language AST analysis with local and cloud LLM synthesis, eliminate macOS menu bar overlapping artifacts, and centralize coding agent routing for external tools (Claude Code, Cursor, Codex, Gemini/Antigravity).

Added

• True Hybrid Scan Engine: Combines deterministic static multi-language AST scanning (Python, TS/JS, Go, Rust, Ruby, PHP, Java, C/C++) with local and BYOK LLM semantics for in-depth symbol, dependency, and architecture indexing.
• 1-Click Model Synchronization: Automatic detection of configured Cloud BYOK keys in Map Agent with 1-click adoption into Coding Agents. (1.7a)
• Expanded Coding Presets: Ready-to-use presets for Claude (Anthropic), OpenAI, OpenRouter, and Local Server (Ollama) alongside MiMo V2.6 Pro. (1.7a)
• Dedicated Agent Routing: Explicit routing toggles for Claude Code, Cursor, Codex, Gemini/Antigravity, and opencode. (1.7a)
• Categorized API Key Management: Clean separation into Map Agent (Cloud BYOK) and Coding Agent Models. (1.7a)
• Re-architected Project TL;DR: Completely redesigned prompt-free project summaries for small local models, featuring automatic sections for Tech Stack & Scale, Key Domains, and Entities. (1.7b)
• Interactive TL;DR Dialog: Integrated 1-click Copy TLDR to clipboard with native macOS notifications and direct Open Map shortcut. (1.7b)
• Cancelable & Resumable Scanning: Advanced scan controls with instant Cancel Scan as well as Pause/Resume Scanning including live ETA calculation and phase indicators. (1.7c)
• Per-Project Auto-Scan Toggle: New Auto-Scan on Save switch directly in each project menu (ON by default) to temporarily pause automatic re-scanning during bulk file operations. (1.7c)

Changed

• Flattened Menu Hierarchy: Eliminated nested Cocoa submenus and lingering tooltips for a sleek, responsive macOS menu bar experience.
• Unified Terminology: Standardized all user-facing strings and dialogs from "Index / Indexing" to "Scan / Scanning / Scanned".
• Mirrored Agent Menus: Map Agent and Coding Agent now share an identical, intuitive menu structure with live status rows.
• Quick-Access Projects: The 3 most recently scanned projects are now direct one-click entries in the main menu bar.

Fixed

• Menu Bar Startup Crash Fix: Resolved missing menu instantiations and missing time import after menu flattening; guarded with automated regression tests.
• Resilient Agent Routing: Transient connection errors no longer automatically uncheck or reset user agent selections.
• User-Friendly Network Errors: Clear, actionable error messaging in the auto-updater when network connection is offline.

codebone v1.7c

Pre-Release

Added

• Per-Project Auto-Scan Toggle: Toggle Auto-Scan on Save directly within each project menu (ON by default) to control file-save scans per repository. (1.7c)
• Cancelable Scan Controls: Pause, resume, and instant cancel controls for active scans with live ETA displays in the menu bar. (1.7c)

Changed

• Terminology Standardization: Consistent rename across all menu items, dialogs, and notifications from "Index" to "Scan". (1.7c)

codebone v1.7b

Pre-Release

Added

• Architecture Highlights in TL;DR: Structured output of Tech Stack, Key Domains, and Entities in the Project TL;DR dialog. (1.7b)
• Copy TLDR & Map Shortcuts: Interactive buttons in the TL;DR dialog for 1-click clipboard copy and direct graph navigation. (1.7b)

Fixed

• Menu Bar Startup Crash: Resolved AttributeError and missing time import preventing the menu bar app from launching. (1.7b)
• Menu Item Registration: Restored open_map_item, documentation_item, feedback_item, check_updates_item, and uninstall_item. (1.7b)

codebone v1.7a

Pre-Release

Added

• Hybrid Architecture Preview: Initial integration of multi-language AST scanning with LLM semantic synthesis. (1.7a)
• Resilient Agent Routing: Non-blocking connection warnings without silently reverting user choices. (1.7a)
• Codex Dual Injection: Export both OPENAI_BASE_URL and OPENAI_API_BASE for broader CLI tool compatibility. (1.7a)
• Thermal & Battery Guidelines: Documented battery-aware debouncing and whisper-quiet CPU throttling budgets. (1.7a)

Changed

• macOS Menu Flattening: Flattened deep submenu trees to avoid Cocoa clipping and overlapping artifacts. (1.7a)

codebone v1.6

Official Milestone Release

🎯 Milestone Goal

Full automation of the release pipeline via GitHub Actions, native in-app auto-updater with robust version comparison, and automated Homebrew distribution.

Added

• GitHub Actions Release Pipeline: Automated workflow building signed macOS DMGs and ZIP archives on version tag pushes (v*).
• Native In-App Auto-Updater: Robust version comparison logic in src/updater.py supporting milestones and letter pre-releases (1.6a < 1.6b < 1.6). (1.6a)
• Checksum Validation: Automated generation and verification of SHA-256 checksums for all release artifacts. (1.6a)
• Homebrew Formula Sync: Automated updates of download URL and SHA-256 checksum in Formula/codebone.rb. (1.6b)
• Release CI Automation: GitHub Actions workflow creating signed DMG files and uploading release assets. (1.6b)

Changed

• Release Gating: Decoupled regular main branch pushes from releases; releases are triggered strictly by explicit version tags.
• Standardized Versioning: Consolidated release hierarchy into clean milestone generations with transparent preview stages.

Fixed

• Release Race Conditions: Eliminated race conditions when simultaneously building DMGs and updating the repository.

codebone v1.6b

Pre-Release

Added

• Release CI Automation: GitHub Actions workflow creating signed DMG files and uploading release assets. (1.6b)
• Homebrew Formula Sync: Automated updates of Formula/codebone.rb with generated SHA-256 checksums. (1.6b)

codebone v1.6a

Pre-Release

Added

• Release Workflow Automation: Tag-gated CI releases (v*) preventing accidental release creation on main. (1.6a)
• Letter-Based Auto-Updater: Native version comparison in src/updater.py supporting letter pre-releases with SHA-256 validation. (1.6a)

codebone v1.5

Official Milestone Release

🎯 Milestone Goal

Scalable graph performance for large repositories via star topologies, ranked semantic search, and automated architectural summaries via MCP.

Added

• Standalone File Linking: Unlinked configuration and documentation files bind to neighboring directories to eliminate orphan nodes. (1.5a)
• Star Topology in Graph: Large entity clusters collapse into star topologies around central hubs, conserving edge budgets. (1.5a)
• Ranked Search: cb(query=...) searches symbol names, comments, and code lines with confidence scoring (high / medium / low). (1.5b)
• 2-Step Context Offer Protocol: Two-stage context delivery; initial query returns matches overview, whisper=true expands full token context. (1.5b)
• Smart Filtering & Freshness Indicator: Domain and asset filtering (assets=true) plus real-time graph freshness indicators. (1.5b)
• Architectural Project TL;DR: codebone_tldr MCP tool and /codebone/tldr HTTP endpoint for concise codebase summaries. (1.5c)

Changed

• Consolidated MCP Tooling: cb merges imports and cross-references; removed redundant individual tools.

Fixed

• Graph Fragmentation: Resolved layout breaks and isolated clusters on large codebases.