Repository navigation
New in 0.7.0
Portable skill bundles
Import and export SKILL.md together with documents, code artifacts, and binary files through
MCP, the generic CLI, or REST. Bundle imports store the skill and its resources atomically.
MCP and CLI enforce component tool permissions. Exports check size limits before loading contents.
Existing import_skill and export_skill operations remain Markdown-only. Bundle operations
require SKILLS_ENABLED=true; binary members also require FILES_ENABLED=true.
See the bundle guide.
Opt-in hybrid memory search
Set HYBRID_SEARCH_ENABLED=true to combine keyword and vector rankings on SQLite and PostgreSQL.
The default remains dense-only search. This release also includes a reproducible retrieval
benchmark. See the search guide.
Plugins, providers, and tooling
- Entity and plan write plugins add before-save and after-save hooks. Automatic plan completion
preserves a successful task change when the plan policy rejects completion or is unavailable. - OpenAI and Azure OpenAI embeddings use bounded async HTTP connections. Provider timeouts are
configurable, and database connections are released before external provider calls. - The repository-encoding skill now covers both first-time encoding and refresh from a saved
commit checkpoint. - Nix gains
nix-buildandnix-shellentry points, sandboxed tests, and a public Cachix cache.
Fixes and dependency updates
- HTTP authentication caching now honours token expiry and normalises identity claims.
- Skill imports reject YAML aliases.
- Invalid task-action types are rejected before they can change stored tasks.
- Runtime dependencies and GitHub Actions have been updated, including fixes for reported
dependency vulnerabilities.
Upgrading from 0.6.0
Back up your database before upgrading. Stop application writes while taking a consistent
backup, and keep the previous application version available for recovery.
The first startup applies database changes automatically, including bundle membership storage
and keyword-search indexes. These changes run even when skills or hybrid search are disabled.
PostgreSQL backfills the search column and builds an index; this can hold locks and delay startup
on larger databases. SQLite also builds and fills its keyword index. Allow a maintenance window.
Existing records and embeddings are retained. Existing skill-resource links are not converted
into stored bundle membership. Use an explicit members list when exporting those resources;
see the bundle guide above.
For rollback, restore the pre-upgrade database backup with the older application. Changing only
the package or Docker tag is not sufficient: the old version does not recognise the new migration
revision. Reversing the bundle migration deletes its stored package membership and paths.
Upgrade verification
The actual published 0.6.0 package created representative data through MCP, then this release's
source opened the same persistent databases. All four cases passed: SQLite and PostgreSQL 16.15,
each with optional features enabled and disabled during upgrade. The checks covered existing
reads, search, updates, deletion, binary contents, legacy skill export, repeated startup, and
new mixed-resource bundles. Re-enabling optional features preserved access to existing records.
These checks used Ubuntu, Python 3.12, small datasets, and synthetic local embeddings. They do
not establish production-scale migration timing, interrupted-upgrade recovery, Windows/macOS
upgrade behaviour, or live-provider compatibility.
What's Changed
- fix(auth): honour token expiry in the HTTP token cache and normalise identity claims by
@giovannimanzoni in #110 - fix(skills): reject YAML aliases during skill import by @ScottRBK in
#176 - fix: release database connections before provider calls by @ScottRBK in
#177 - feat(embeddings): bound native async OpenAI connections by @leninworld in
#178 - Configure OpenAI embedding request timeout by @ScottRBK in
#181 - docs: add community health files by @ScottRBK in #182
- fix: update audited security dependencies by @ScottRBK in
#186 - fix: prevent coerced task actions from changing stored tasks by @DivyamTalwar in
#179 - feat(embeddings): bound native async Azure OpenAI connections by @bertheto in
#185 - feat: add before-save and after-save Entity Plugin hooks by @bertheto in
#184 - docs: add forgetful-update-encoding skill by @twstagg in
#190 - feat(plans): add plan write plugin hooks by @leninworld in
#188 - ci: add Dependabot for flake inputs and pinned Actions by @twstagg in
#192 - chore(deps): bump docker/build-push-action from 5 to 7 in /.github/workflows by @dependabot[bot]
in #195 - chore(deps): bump docker/login-action from 3 to 4 in /.github/workflows by @dependabot[bot] in
#196 - chore(deps): bump actions/setup-python from 5 to 7 in /.github/workflows by @dependabot[bot] in
#198 - chore(deps): bump actions/checkout from 4 to 7 in /.github/workflows by @dependabot[bot] in
#199 - chore(deps): bump docker/metadata-action from 5 to 6 in /.github/workflows by @dependabot[bot] in
#200 - chore(deps): bump actions/cache from 3 to 6 in /.github/workflows by @dependabot[bot] in
#197 - chore(nix): lock hygiene, non-flake entry points and a sandboxed test check by @twstagg in
#202 - chore(deps): bump pyasn1 from 0.6.4 to 0.6.5 by @dependabot[bot] in
#203 - chore(deps): bump authlib from 1.7.2 to 1.9.1 by @dependabot[bot] in
#204 - chore(deps): bump mcp from 1.29.0 to 1.30.0 by @dependabot[bot] in
#205 - chore(deps): bump joserfc from 1.7.0 to 1.7.6 by @dependabot[bot] in
#206 - chore(deps): bump the flake-inputs group across 1 directory with 6 updates by @dependabot[bot] in
#201 - chore(deps): bump mako from 1.3.12 to 1.4.2 by @dependabot[bot] in
#207 - chore(deps): bump opentelemetry-api from 1.39.1 to 1.45.2 by @dependabot[bot] in
#208 - chore(deps): bump dnspython from 2.8.0 to 2.9.2 by @dependabot[bot] in
#209 - feat: opt-in hybrid keyword + vector search with RRF, plus a reproducible retrieval benchmark by
@bertheto in #189 - ci: publish Nix build outputs to Cachix by @twstagg in
#191 - ci: exclude synthetic benchmark fixtures from the typos hook by @twstagg in
#210 - fix(nix): ship eval_lib.py in the sandboxed test source by @twstagg in
#211 - feat(skills): round-trip skill resource bundles by @leninworld in
#194
New Contributors
- @DivyamTalwar made their first contribution in #179
- @dependabot[bot] made their first contribution in #195
Full Changelog: v0.6.0...v0.7.0