v0.3.0-alpha.1
Pre-release
Pre-release
Hecate v0.3.0-alpha.1
Highlights
- Makes embedded Cairnline the sole authority for portable Projects coordination while Hecate remains the operator cockpit and execution/orchestration layer.
- Completes the Projects V1 journey across onboarding, guidance and skill discovery, roles, work items, assignments, launch readiness, worktrees, evidence, reviews, handoffs, memory candidates, and closeout.
- Renames Hecate Agent Profiles to Agent Presets and keeps provider, model, tool, write, network, approval, memory, and adapter posture under Hecate runtime authority.
- Hardens External Agent support around the standalone Go ACP adapters, including capability discovery, authentication and logout, approvals, MCP configuration, terminal activity, session metadata, and cleanup behavior.
- Adds opt-in operator terminal tools and native web search with bounded Tavily and Exa results.
- Moves the UI toolchain to stable TypeScript 7 and refreshes desktop, Docker, and dependency coverage.
Breaking Or Risky Changes
- Portable Projects data is now stored only in
<HECATE_DATA_DIR>/cairnline/embedded/projects.db. The removed Hecate-native Projects stores, backend selector, mirror, migration routes, and sidecar transition controls are no longer available. - Disposable Projects records created by earlier alpha builds are intentionally not migrated. Recreate project setup in this release; system reset also removes the embedded Cairnline database.
- The Hecate API surface
/hecate/v1/agent-profiles*has been replaced by/hecate/v1/agent-presets*. - Cairnline assignment metadata expresses coordination intent only. Hecate still enforces model/provider policy, approvals, sandboxing, writes, network access, and External Agent launch behavior.
- Terminal tools remain opt-in, and External Agent CLIs remain trusted subprocesses whose own internals are not sandboxed by Hecate.
Migration Notes
- Operators without disposable pre-release Projects data need no manual migration.
- Recreate any project roots, roles, work items, assignments, skills metadata, and project memory that must survive from an older alpha.
- Update API clients from
agent-profilestoagent-presets. - Existing provider credentials, chats, tasks, approvals, Agent Presets, and Hecate-owned runtime history remain in the configured Hecate store.
Verification
- All
just verifycomponents passed. The local Docker health/bootstrap smoke used127.0.0.1:18765because local operator tooling occupied the canonical port; pull-request CI passed the unchanged8765smoke. - Pull-request CI: Go race tests, Go vet/lint, TypeScript tests, browser E2E, Docker smoke, macOS/Windows bootstrap, Tauri Rust tests, and unsigned Linux/macOS/Windows desktop bundles.
Known Limitations
- Hecate remains public-alpha, local-first, and single-operator shaped.
- macOS Apple Silicon is the manually launch-tested desktop path. Linux and Windows bundles are CI-built but still experimental on real machines.
- A separately installed Cairnline connector is future work; this release embeds Cairnline in the Hecate process.
- See https://github.com/hecatehq/hecate/blob/master/docs/operator/known-limitations.md for the current operator boundary.