hone-core

Headless IDE services. Runtime: Bun (tests only). 649+ tests.

cd hone-core && bun test

Service Modules

workspace/

Multi-root workspace management. Tracks root folders, filesystem entries, and workspace configuration (.hone/ directory).

Exports: Workspace, WorkspaceFolder, FileEntry, FileWatcher, FileIndex

settings/

Layered settings resolution with 4-layer priority (highest to lowest):

1. Language overrides
2. Workspace overrides
3. User settings
4. Defaults

VS Code-compatible format. Exports: SettingsStore, KeybindingResolver, schema validation.

git/

Git integration via child_process. Parses status, diff, log, and blame output. Includes platform clients for GitHub, GitLab, and Bitbucket.

Exports: GitClient, diff/blame/log parsers

search/

Workspace-wide text search. Supports literal and regex modes with case sensitivity and whole-word matching. Ripgrep integration for performance.

Exports: searchFileContent, RipgrepSearcher

protocols/lsp/

Language Server Protocol implementation. JSON-RPC 2.0 message framing.

Exports: JsonRpcRequest, JsonRpcResponse, JsonRpcNotification, ClientCapabilities, LSP types

protocols/dap/

Debug Adapter Protocol implementation. DAP message structure with Content-Length framing.

Exports: DapRequest, DapResponse, DapEvent, BreakpointManager, DapManager, DapClient

ai/provider/

Multi-provider AI system with dynamic routing.

• ProviderRegistry — registers and resolves AI providers
• ModelRouter — selects provider/model based on task requirements
• Token estimation utilities

Adapters: Anthropic, OpenAI, Google, Ollama, Azure OpenAI, Bedrock, Vertex

ai/inline/

Inline code completion using Fill-In-Middle (FIM) formatting. Debouncing prevents excessive requests; caching avoids redundant completions.

Exports: InlineCompletionProvider, CompletionDebouncer, CompletionCache

ai/chat/

Multi-turn chat with streaming support. Manages conversation history, collects editor/workspace context, extracts code blocks from responses.

Exports: ChatModel, ContextCollector, StreamingRenderer

ai/agent/

Autonomous agent tasks. Executes a plan-then-act loop with tool calling, user approval flows, and error recovery.

Exports: AgentOrchestrator, AgentPlan, ActivityLog, AGENT_TOOLS

ai/review/

AI-powered pull request review. Splits diffs into reviewable chunks, parses annotations from AI responses.

Exports: ReviewEngine, chunkDiff, parseAnnotations

extensions/

Built-in extension management (V1 system). Loads, activates, and deactivates extensions based on parsed manifests.

Exports: ExtensionRegistry, ExtensionHost, parseManifest

tasks/

Task configuration and execution. Parses tasks.json format (VS Code-compatible), executes shell and process tasks.

Exports: parseTaskConfig, TaskRunner

sync/

Cross-device sync protocol. Handles device pairing, encryption, and transport (LAN discovery and relay fallback). Room-based sync with envelope format and sequence numbers.

queue/

Changes queue (review inbox). Tracks proposed changes with pending/accepted/rejected states. Detects conflicts before applying diffs.

Exports: ChangesQueue, DiffApplier, ConflictDetector, TrustConfig

formatting/

Document formatting rules. Perry-safe pure TypeScript (no regex). Handles trailing whitespace trimming, final newline insertion, and indentation normalization.

telemetry/

Anonymous usage telemetry. Batches events using the Chirp protocol (max 50 events per batch). No PII collected.