Skip to content

v0.3.0-alpha.1

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 12 Jul 01:18

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-profiles to agent-presets.
  • Existing provider credentials, chats, tasks, approvals, Agent Presets, and Hecate-owned runtime history remain in the configured Hecate store.

Verification

  • All just verify components passed. The local Docker health/bootstrap smoke used 127.0.0.1:18765 because local operator tooling occupied the canonical port; pull-request CI passed the unchanged 8765 smoke.
  • 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.