{
"project": "hivemind",
"description": "Changelog for Hivemind - Local-first observable orchestration for agentic development",
"format_version": "1.0.0",
"entries": [
{
"version": "v0.1.19",
"date": "2026-02-15",
"phase": 30,
"changes": [
{
"type": "fixed",
"area": "core",
"description": "Deprecate interactive flow ticks with explicit `interactive_mode_deprecated` errors and guidance to run non-interactive `flow tick`"
},
{
"type": "fixed",
"area": "core",
"description": "Add regression coverage for runtime output capture when runtime command arguments include nested quoting"
},
{
"type": "changed",
"area": "core",
"description": "Expand runtime projection heuristics to recognize TODO/DONE prefixes and common runtime narrative status lines"
},
{
"type": "added",
"area": "tests",
"description": "Add projection tests for TODO prefix snapshots and runtime narrative status lines plus registry coverage for interactive deprecation"
},
{
"type": "changed",
"area": "docs",
"description": "Update CLI semantics and architecture docs to document interactive deprecation and current flow tick behavior"
},
{
"type": "added",
"area": "ops",
"description": "Add beta testing fix report for tier-4 RUN-003/RUN-004/RUN-005 stabilization outcomes"
}
]
},
{
"version": "v0.1.18",
"date": "2026-02-14",
"phase": 29,
"changes": [
{
"type": "added",
"area": "cli",
"description": "Extend `events list` and `events stream` with correlation filters (`--graph`, `--flow`, `--task`, `--attempt`) and RFC3339 time-window filters (`--since`, `--until`)"
},
{
"type": "changed",
"area": "core",
"description": "Enhance EventFilter matching with timestamp bounds to support deterministic historical queries and streaming windows"
},
{
"type": "added",
"area": "tests",
"description": "Add event store coverage for time-range filtering and CLI integration coverage for new event query/stream filters and invalid time-range handling"
},
{
"type": "changed",
"area": "docs",
"description": "Mark Phase 29 complete in roadmap and update CLI/quickstart/capabilities docs for correlation and time-range observability queries"
},
{
"type": "added",
"area": "ops",
"description": "Add Phase 29 execution report including manual `hivemind-test` validation with captured start/end timestamps and event query evidence"
}
]
},
{
"version": "v0.1.17",
"date": "2026-02-14",
"phase": 28,
"changes": [
{
"type": "added",
"area": "core",
"description": "Add Codex, Claude Code, and Kilo runtime adapters with shared execution/interactive semantics and health checks"
},
{
"type": "added",
"area": "cli",
"description": "Introduce `hivemind runtime list` and `hivemind runtime health` for adapter discovery and diagnostics"
},
{
"type": "added",
"area": "core",
"description": "Support task-level runtime override via `task runtime-set` with event-sourced TaskRuntimeConfigured/TaskRuntimeCleared state transitions"
},
{
"type": "changed",
"area": "core",
"description": "Runtime execution now resolves effective runtime per task (override or project default) while preserving existing TaskFlow event semantics and projection behavior"
},
{
"type": "changed",
"area": "core",
"description": "Harden runtime event projection by normalizing ANSI/control-prefixed output so command/tool markers are observable from real runtime streams"
},
{
"type": "added",
"area": "tests",
"description": "Extend registry tests for runtime catalog coverage, codex adapter execution, and task runtime override precedence"
},
{
"type": "changed",
"area": "docs",
"description": "Mark Phase 28 complete and update quickstart/runtime/CLI semantics docs for multi-runtime operation"
}
]
},
{
"version": "v0.1.16",
"date": "2026-02-14",
"phase": 27,
"changes": [
{
"type": "added",
"area": "core",
"description": "Provision task worktrees across all attached repositories and propagate dependency branch integration in each repo before runtime execution"
},
{
"type": "changed",
"area": "core",
"description": "Inject multi-repo runtime context/env (`HIVEMIND_PRIMARY_WORKTREE`, `HIVEMIND_ALL_WORKTREES`, per-repo worktree env vars) so agents can operate across repos in a single attempt"
},
{
"type": "changed",
"area": "core",
"description": "Enforce repository scope per repo during verification; writes in undeclared/read-only repos now fail the attempt"
},
{
"type": "changed",
"area": "core",
"description": "Extend merge prepare/execute to multi-repo flows with taskflow-level all-or-nothing merge guarantees and best-effort rollback of partially merged repos"
},
{
"type": "added",
"area": "tests",
"description": "Add registry coverage for multi-repo merge preparation and atomic merge failure handling"
},
{
"type": "changed",
"area": "docs",
"description": "Mark Phase 27 complete in roadmap and document Phase 27 runtime/scope mechanics in design docs"
}
]
},
{
"version": "v0.1.15",
"date": "2026-02-14",
"phase": 26,
"changes": [
{
"type": "added",
"area": "core",
"description": "Introduce concurrency governance in Registry::tick_flow with multi-dispatch scheduling, scope-aware conflict telemetry, and global concurrency cap parsing"
},
{
"type": "added",
"area": "cli",
"description": "Expose --max-parallel on flow tick and --max-parallel-tasks on project runtime-set, plus surface new scheduling telemetry via server API"
},
{
"type": "changed",
"area": "core",
"description": "Emit ScopeConflictDetected/TaskSchedulingDeferred events and persist max_parallel_tasks policy in ProjectRuntimeConfigured"
},
{
"type": "changed",
"area": "docs",
"description": "Rewrite Phase 26 roadmap, update architecture/design/quickstart docs to describe concurrency governance and global caps"
},
{
"type": "added",
"area": "tests",
"description": "Extend unit coverage for scheduling conflicts/global cap parsing and document manual hivemind-test validation scenarios"
}
]
},
{
"version": "v0.1.14",
"date": "2026-02-13",
"phase": 24,
"changes": [
{
"type": "added",
"area": "core",
"description": "Implement checkpoint lifecycle model with AttemptCheckpoint state, checkpoint events (Declared/Activated/Completed/AllCompleted), and canonical checkpoint commit generation"
},
{
"type": "added",
"area": "cli",
"description": "Introduce `hivemind checkpoint complete --attempt-id <id> --id <checkpoint>` for agents/runtimes to mark checkpoints done with optional summaries"
},
{
"type": "changed",
"area": "core",
"description": "Gate task completion on checkpoints, inject checkpoint guidance/env vars into runtime execution, and emit checkpoint lifecycle + commit events"
},
{
"type": "changed",
"area": "docs",
"description": "Update ops/ROADMAP.md for Phase 24 Execution Checkpoints and renumber subsequent phases; add detailed exit criteria"
},
{
"type": "added",
"area": "tests",
"description": "Add checkpoint lifecycle integration coverage and adapt real OpenCode projection script to perform checkpoint completion"
}
]
},
{
"version": "v0.1.13",
"date": "2026-02-13",
"phase": 23,
"changes": [
{
"type": "added",
"area": "core",
"description": "Project deterministic runtime stdout/stderr markers into observational events (RuntimeCommandObserved, RuntimeToolCallObserved, RuntimeTodoSnapshotUpdated, RuntimeNarrativeOutputObserved)"
},
{
"type": "changed",
"area": "core",
"description": "Integrate runtime projection in flow execution for both interactive and non-interactive paths while preserving existing runtime lifecycle/output events"
},
{
"type": "changed",
"area": "cli",
"description": "Surface new runtime observational event labels in CLI and server event renderers"
},
{
"type": "added",
"area": "tests",
"description": "Add unit and integration coverage for runtime projection parsing, chunk boundaries, stderr handling, and end-to-end event emission"
},
{
"type": "changed",
"area": "docs",
"description": "Update roadmap, architecture, and design docs to define projection invariants: telemetry-only, non-authoritative, best-effort"
}
]
},
{
"version": "v0.1.12",
"date": "2026-02-13",
"phase": 22,
"changes": [
{
"type": "added",
"area": "core",
"description": "Emit TaskExecutionFrozen, TaskIntegratedIntoFlow, and FlowIntegrationLockAcquired events to enforce deterministic merge sequencing"
},
{
"type": "changed",
"area": "core",
"description": "Freeze flows at merge prepare, enforce per-flow integration token, and integrate tasks via dedicated integration/<flow>/<task> sandboxes with drift detection"
},
{
"type": "changed",
"area": "cli",
"description": "Update merge command help to describe flow freeze, per-task sandboxes, and integration lock semantics"
},
{
"type": "changed",
"area": "docs",
"description": "Refresh quickstart, CLI operational semantics, and roadmap with tightened merge protocol details and manual test requirements"
},
{
"type": "added",
"area": "tests",
"description": "Extend hivemind-test/test_merge.sh to assert FrozenForMerge → Merged transitions and sentinel merge events"
}
]
},
{
"version": "v0.1.11",
"date": "2026-02-12",
"phase": 21,
"changes": [
{
"type": "added",
"area": "core",
"description": "Introduce explicit retry modes (clean vs continue), persist selection on TaskExecution, and include retry_mode on TaskRetryRequested events"
},
{
"type": "changed",
"area": "core",
"description": "Conditionally reset execution worktrees/branches during retry based on retry_mode and default automatic retries to clean"
},
{
"type": "added",
"area": "cli",
"description": "Extend task retry command with --mode clean|continue flag"
},
{
"type": "added",
"area": "tests",
"description": "Add integration coverage verifying clean retries wipe worktrees while continue retries preserve them and that events capture retry_mode"
},
{
"type": "changed",
"area": "docs",
"description": "Update architecture, design, and quickstart docs to describe retry mode semantics"
}
]
},
{
"version": "v0.1.10",
"date": "2026-02-12",
"phase": 20,
"changes": [
{
"type": "added",
"area": "core",
"description": "Require reason + record attribution for human verification overrides and allow overriding automated outcomes"
},
{
"type": "added",
"area": "tests",
"description": "Add CLI integration coverage asserting human overrides can force success after failed required checks and are audited via events"
},
{
"type": "changed",
"area": "docs",
"description": "Align CLI operational semantics for verify override with expanded override states and required reason"
}
]
},
{
"version": "v0.1.9",
"date": "2026-02-10",
"phase": 17,
"changes": [
{
"type": "added",
"area": "core",
"description": "Add verification check types (CheckConfig, CheckResult) with backward-compatible deserialization"
},
{
"type": "added",
"area": "core",
"description": "Execute automated verification checks in task worktrees during verification, capturing exit code, combined output, and duration"
},
{
"type": "added",
"area": "core",
"description": "Emit check lifecycle events (CheckStarted, CheckCompleted) and store per-attempt check results in derived state"
},
{
"type": "added",
"area": "cli",
"description": "Add verification commands: verify run <task-id> and verify results <attempt-id>"
},
{
"type": "added",
"area": "cli",
"description": "Add graph command to configure checks on graph tasks: graph add-check <graph-id> <task-id>"
},
{
"type": "changed",
"area": "core",
"description": "Block task success when required checks fail (transition to Retry/Failed based on retry policy)"
},
{
"type": "added",
"area": "tests",
"description": "Add CLI integration coverage asserting failed required checks are observable via events and surfaced via verify results"
}
]
},
{
"version": "v0.1.8",
"date": "2026-02-09",
"phase": 16,
"changes": [
{
"type": "added",
"area": "core",
"description": "Emit scope enforcement outcome events (ScopeValidated, ScopeViolationDetected) after post-execution verification"
},
{
"type": "changed",
"area": "core",
"description": "Enforce scope post-execution by verifying filesystem + git operations; violations are fatal to the attempt and preserve the worktree for debugging"
},
{
"type": "changed",
"area": "core",
"description": "Extend baseline artifacts to capture local git branches for reliable git scope detection"
},
{
"type": "added",
"area": "tests",
"description": "Add CLI integration coverage asserting scope violations are observable, fatal, and preserve worktrees"
},
{
"type": "changed",
"area": "cli",
"description": "Harden CLI JSON/YAML success envelopes and align error exit codes for beta Tier regression scripts (attach-repo, task inspect, runtime-set, etc.)"
},
{
"type": "changed",
"area": "docs",
"description": "Update CLI operational semantics and error-model docs to reflect ErrorOccurred emission policy and structured error envelopes"
}
]
},
{
"version": "v0.1.7",
"date": "2026-02-09",
"phase": 15,
"changes": [
{
"type": "added",
"area": "cli",
"description": "Add optional --interactive flag to flow tick to run the configured runtime in an interactive session"
},
{
"type": "added",
"area": "adapters",
"description": "Implement PTY-backed interactive execution in the OpenCode adapter with live output streaming and deterministic Ctrl+C handling"
},
{
"type": "added",
"area": "core",
"description": "Persist interactive runtime input and interrupt events (RuntimeInputProvided, RuntimeInterrupted) for full observability"
},
{
"type": "changed",
"area": "core",
"description": "Extend flow tick execution to support interactive runtime sessions while preserving existing TaskFlow semantics"
},
{
"type": "changed",
"area": "cli",
"description": "Label and surface the new runtime interaction event types in CLI and server event rendering"
}
]
},
{
"version": "v0.1.6",
"date": "2026-02-09",
"phase": 22,
"changes": [
{
"type": "added",
"area": "docs",
"description": "Add end-to-end Quickstart guide (humans + LLM operators) covering setup, runtime configuration, task/graph/flow execution, event inspection, and merge protocol"
},
{
"type": "changed",
"area": "cli",
"description": "Improve CLI --help discoverability for core commands and clarify dependency and merge semantics"
},
{
"type": "fixed",
"area": "core",
"description": "Harden merge workflow to handle git identity configuration reliably and auto-resolve certain dependency-ordered conflicts during merge preparation"
},
{
"type": "fixed",
"area": "core",
"description": "Ensure merge preparation is safely re-runnable when previous runs recorded conflicts"
}
]
},
{
"version": "v0.1.5",
"date": "2026-02-08",
"phase": 14,
"changes": [
{
"type": "added",
"area": "core",
"description": "Add per-project runtime configuration persisted as events (adapter, binary path, args, env, timeout)"
},
{
"type": "added",
"area": "cli",
"description": "Add project runtime configuration command (project runtime-set)"
},
{
"type": "added",
"area": "core",
"description": "Invoke the configured runtime from flow tick and persist attempt-correlated runtime output and filesystem observation"
},
{
"type": "added",
"area": "core",
"description": "Persist filesystem observation as RuntimeFilesystemObserved event"
},
{
"type": "changed",
"area": "cli",
"description": "Improve attempt inspect to query attempt-correlated runtime events and optionally show output and file changes"
},
{
"type": "changed",
"area": "adapters",
"description": "Remove obsolete AdapterEvent layer in favor of core EventPayload runtime lifecycle events"
},
{
"type": "fixed",
"area": "tooling",
"description": "Fix Makefile coverage target for cargo-llvm-cov compatibility"
}
]
},
{
"version": "v0.1.4",
"date": "2026-02-08",
"phase": 12,
"changes": [
{
"type": "added",
"area": "core",
"description": "Capture per-attempt filesystem baselines and persist them as artifacts for replay-safe diff computation"
},
{
"type": "added",
"area": "core",
"description": "Compute created/modified/deleted files and unified diffs at task completion, persisting diff artifacts"
},
{
"type": "added",
"area": "core",
"description": "Emit new diff-related events: AttemptStarted, BaselineCaptured, FileModified, DiffComputed, CheckpointCommitCreated"
},
{
"type": "added",
"area": "cli",
"description": "Add manual task execution boundary commands: task start and task complete"
},
{
"type": "changed",
"area": "cli",
"description": "Extend attempt inspect to support --diff and show stored unified diff output"
}
]
},
{
"version": "v0.1.3",
"date": "2026-02-07",
"phase": 13,
"changes": [
{
"type": "added",
"area": "adapters",
"description": "Align runtime adapter contract with Initialize/Prepare/Execute/Terminate lifecycle"
},
{
"type": "added",
"area": "core",
"description": "Add persisted runtime lifecycle events (RuntimeStarted/RuntimeOutputChunk/RuntimeExited/RuntimeTerminated)"
},
{
"type": "changed",
"area": "cli",
"description": "Extend event listing to label runtime lifecycle events"
}
]
},
{
"version": "v0.1.2",
"date": "2026-02-07",
"phase": 11,
"changes": [
{
"type": "added",
"area": "core",
"description": "Create isolated git worktrees per task under .hivemind/worktrees"
},
{
"type": "added",
"area": "cli",
"description": "Add worktree CLI commands: worktree list, inspect, cleanup"
},
{
"type": "changed",
"area": "core",
"description": "Provision task worktrees on flow start and clean up on verification success (configurable)"
}
]
},
{
"version": "v0.1.1",
"date": "2026-02-06",
"phase": 0,
"changes": [
{
"type": "changed",
"area": "ci",
"description": "Run the test suite with cargo-nextest in CI"
},
{
"type": "changed",
"area": "ci",
"description": "Prefer cargo-nextest locally when available (Makefile)"
}
]
}
]
}