Repository navigation
v0.8.9
Changes
Added
- Attach
core/manual-triggerto a task to deploy it unstarted on Kubernetes, Docker Compose or Amazon ECS, and start each run yourself. - Back up through Velero, K8up, KubeStash, Kasten, CloudNativePG, mariadb-operator or AWS Backup, onto a bucket or a volume, with optional point-in-time recovery.
- New examples: a task run on demand, and one datastore backed up on every target from a single
core/backupattachment. - The documentation is published in Chinese, Japanese, Korean, Polish, Turkish, Ukrainian, Indonesian, Vietnamese and Russian, marked machine-translated, with a version selector by minor release.
- aggrega.ai serves a home page introducing Aggrega, with links to the documentation and the catalog.
aggrega scaffold --example <name>writes a documentation example into a new folder, and--example --listlists them; the assistant and the editor can too.- The install scripts print the next steps, and
--completionand--skills(-Completion,-Skillson Windows) also set up shell completion and the assistant skill. - The documentation opens with a Start here group: AI assistant pages with a translated set-up prompt, a Getting started page and a Learn Aggrega path.
- Two quickstart examples, a LangGraph agent on a local model and a web app with PostgreSQL, grow step by step from Docker Compose.
- The catalog runs
core/compute/server, an agent andcore/gateway/litellmon Docker Compose, with two published quickstart images undertools/. - The hub counts pulls per catalog entity version and records nothing about who pulled; the privacy page states what is counted.
- Translated pages on every site say they are machine-translated, and each language picker names a language in your own language on hover.
Changed
helm/mariadb-clusterruns MariaDB replication frominfra.ha, andhelm/mariadbrefusesinfra.haby name instead of ignoring it.aggrega registry updatere-reads only what changed, walks registries in parallel, retries failed reads rather than recording versions unsigned, and names unreadable repositories.- Code blocks in the documentation follow the light or dark theme, on a grey surface with syntax colours that are easier to read.
aggrega validate --releasenow evaluates Recipe and FeatureRecipe assertions against the Release's values, failing whereaggrega buildwould.- The Start here pages live at
/docs/ai-assistants/,/docs/install/and/docs/learn/; their old/docs/authoring/addresses redirect permanently. - Example READMEs give the
aggrega buildcommands that work in a copy made withaggrega scaffold --example;./build-release.shstays for CI. - The documentation's language picker is a drop-down menu that works with the arrow keys and Escape.
- The accessibility button floats at the bottom right of every page and no longer shortens the sidebars.
- A pull fetches each manifest once, by the tag or digest it names, and checks its bytes against that digest.
Fixed
- An unknown command now answers immediately from the local registry index, and says how to install or search for a CLI plugin of that name.
- A value declared sensitive behind a
$refreference is now withheld from diagnostics, and a pillar written as a#/$defs/reference publishes the definition's keys. - A connection's
valuesandinfraleaves its socket declaressensitiveare now withheld from--ir-graph, the trace and governance plugins. - A refusal now withholds a declared-sensitive value read from inside a list, such as a boundary connection's
providesor.context.used_by. - The trace now shows a component's
.context.injectblock when its only deliveries use a custom mechanism, withholding declared-sensitive values. - A credential holding a double quote or a backslash now reaches the rendered output intact through the standard catalog's credential Features and Recipes.
- A FeatureRecipe
injectMappingwhose output cannot be read, or writes deliveries underall:, now halts the build naming the attachment, instead of silently delivering nothing. - A bare annotation value its binding cannot place halts with
E0367where written, andaggrega validatereports an unsupported workload input kind withE0265. - On Docker Compose, a volume mount's
subPathnow mounts that part of a persistent volume, and is refused by name on other volume kinds. - A sourced Docker Compose service keeps every label its file writes, in list form or with number and true/false values, beside the provenance labels.
- An imported module's components now meet the
inject:allowlist and delivery-key rules, and its subsystem and Release-written attachments may name only declared sockets. - A Feature an imported module attaches to one of its own subsystems now reaches the module's components there, and meets the Feature's
appliesTo. - An
annotation-transformpolicy and boundary annotation bindings now reach every component routed in throughaggregates:, named or not, addressed by graph id likedocuments.backend. - Platform annotations such as
aggrega.ai/namespacedeclared on an Aggregate subsystem or component, or in a module, now reach rendered output; the Release's value wins. - Registry access reports a malformed credential entry or
config.json, andaggrega loginandaggrega logouta malformedconfig.json, naming registry and file, never contents. - On Docker Compose, a credential attached to an external service, as on
compose/twilio, is refused by name; its slots are optional there, required on Kubernetes. - A build reaching a Component or Feature whose
extends:chain loops now halts with the cyclic extends chain error instead of crashing. - Diagnostics and lockfile references name top-level components at
.spec.components; findings on imported module components point at the written key in the Release or module. - An imported module's attachment whose delivery its slot refuses now halts saying how to fix it, within the mechanisms a slot can declare.
compose/langflowandhelm/langflowkeep Langflow's data at/app/langflow, the directory its image creates, so Docker Compose volumes are writable by Langflow.helm/langflow,helm/flowiseandcompose/flowisekeep data writable by the non-root user current images run as; Flowise's data moves to/home/node/.flowise.- A pull's unfinished deprecation-marker lookup is now reported as a lookup that did not complete, with its reason, not as a marker not honored.
- A schema library only the artifact cache holds is now named, with the action that works there, by
validate, entity validation,pullandbuild --auto-pull. - The public catalog's Capability filter now lists each plugin's published capabilities, and plugin pages show their plugin type and drop two always-empty rows.
- A reference that resolves to nothing now names any catalog file declaring an Aggrega apiVersion that does not parse, with the parser's reason.
- The editor, the assistant's
describeandvalidate, andinspect --closurenow report a withdrawn plugin recorded in the plugin trust record, as the build does. aggrega inspectprints a catalog Component as YAML under-o yaml, and draws extending Releases and Manifests as a build composes them.aggrega deprecate --fromand the daemon'saggrega/deprecateArtifactnow refuse a severity, reason, replacement or message passed beside the batch file, instead of ignoring it.- An
aggrega registry updatestopped while writing an index now leaves it complete or absent, never a partial index shown as current. - A schema halt over content read through
$import:now names the imported file beside its line, instead of the entity's file. - A top-level template field holding nothing renders empty;
$.ranges match dot ranges;(.locals).keyhalts like.locals.key; printing and ranging unset paths halts. - On Docker Compose, the build now warns about a persistent volume's dropped
classoraccessModes, and ausesedge into a later sync wave. - Warnings for an inline
x-aggrega-*schema keyword and for an unverified plugin now print once, untimestamped, beside a build's other warnings, and reach the editor. - A Recipe or FeatureRecipe whose pipeline repeats a step
idis now refused withE0370, naming both steps' lines. aggrega validateandaggrega linthalt withE0371on a catalog file with a misspelledkind:, and builds name it when its entity is missing.- Managed database Recipes refuse a password attachment the cloud service would ignore, and PostgreSQL and MariaDB Recipes refuse
infra.credentialssettings they cannot honour. - A failed
provides:entry now shows the condition that stopped it beneathE0056. aggrega plugin add providernow writesprovider/<name>, which the next pull resolves; anoci://provider binding is refused naming the form to write.- A refused workspace configuration now reads "workspace configuration is invalid" instead of claiming a schema failure where the schema passed.
Install
These commands install this release, 0.8.9.
Linux and macOS:
curl -fsSL https://github.com/aggrega-ai/aggrega-cli/releases/download/v0.8.9/install.sh | AGGREGA_VERSION=0.8.9 shWindows (PowerShell):
$env:AGGREGA_VERSION = '0.8.9'; irm https://github.com/aggrega-ai/aggrega-cli/releases/download/v0.8.9/install.ps1 | iexBoth install the default aggrega for the current user and check it against SHA256SUMS.
Windows installer: run aggrega-0.8.9-windows-amd64-setup.exe. No administrator rights; installs into %LOCALAPPDATA%\Programs\aggrega and adds it to your PATH. /S installs silently; uninstall.exe /S in that folder removes it.
Homebrew and Scoop install the newest release: brew install aggrega-ai/tap/aggrega, or scoop bucket add aggrega https://github.com/aggrega-ai/scoop-bucket then scoop install aggrega.
Files
Binaries for linux/amd64, linux/arm64, darwin/arm64, darwin/amd64 and windows/amd64 (.exe):
| File | What it is |
|---|---|
aggrega-0.8.9-<os>-<arch> |
The default build, with the core plugins embedded |
aggrega-debug-0.8.9-<os>-<arch> |
The same build with debug information, for a debugger or a profiler |
aggrega-light-0.8.9-<os>-<arch> |
No embedded plugins; resolves plugins through the cascade |
aggrega-0.8.9-windows-amd64-setup.exe |
Windows installer |
aggrega-0.8.9.mcpb |
Claude Desktop extension: runs an installed aggrega as a local MCP server; one file for every OS |
install.sh, install.ps1 |
Install scripts |
SHA256SUMS |
SHA-256 of every other file; check with sha256sum -c SHA256SUMS |
Signing: Windows files carry a timestamped Authenticode signature from Cognitio S.r.l.; macOS files are signed with the Developer ID of COGNITIO SRL and notarized by Apple.