Skip to content

v0.8.9

Choose a tag to compare

@github-actions github-actions released this 02 Nov 13:47
· 156 commits to main since this release

Changes

Added

  • Attach core/manual-trigger to 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/backup attachment.
  • 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 --list lists them; the assistant and the editor can too.
  • The install scripts print the next steps, and --completion and --skills (-Completion, -Skills on 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 and core/gateway/litellm on Docker Compose, with two published quickstart images under tools/.
  • 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-cluster runs MariaDB replication from infra.ha, and helm/mariadb refuses infra.ha by name instead of ignoring it.
  • aggrega registry update re-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 --release now evaluates Recipe and FeatureRecipe assertions against the Release's values, failing where aggrega build would.
  • 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 build commands that work in a copy made with aggrega scaffold --example; ./build-release.sh stays 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 $ref reference is now withheld from diagnostics, and a pillar written as a #/$defs/ reference publishes the definition's keys.
  • A connection's values and infra leaves its socket declares sensitive are 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 provides or .context.used_by.
  • The trace now shows a component's .context.inject block 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 injectMapping whose output cannot be read, or writes deliveries under all:, now halts the build naming the attachment, instead of silently delivering nothing.
  • A bare annotation value its binding cannot place halts with E0367 where written, and aggrega validate reports an unsupported workload input kind with E0265.
  • On Docker Compose, a volume mount's subPath now 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-transform policy and boundary annotation bindings now reach every component routed in through aggregates:, named or not, addressed by graph id like documents.backend.
  • Platform annotations such as aggrega.ai/namespace declared 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, and aggrega login and aggrega logout a malformed config.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/langflow and helm/langflow keep Langflow's data at /app/langflow, the directory its image creates, so Docker Compose volumes are writable by Langflow.
  • helm/langflow, helm/flowise and compose/flowise keep 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, pull and build --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 describe and validate, and inspect --closure now report a withdrawn plugin recorded in the plugin trust record, as the build does.
  • aggrega inspect prints a catalog Component as YAML under -o yaml, and draws extending Releases and Manifests as a build composes them.
  • aggrega deprecate --from and the daemon's aggrega/deprecateArtifact now refuse a severity, reason, replacement or message passed beside the batch file, instead of ignoring it.
  • An aggrega registry update stopped 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).key halts like .locals.key; printing and ranging unset paths halts.
  • On Docker Compose, the build now warns about a persistent volume's dropped class or accessModes, and a uses edge 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 id is now refused with E0370, naming both steps' lines.
  • aggrega validate and aggrega lint halt with E0371 on a catalog file with a misspelled kind:, 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.credentials settings they cannot honour.
  • A failed provides: entry now shows the condition that stopped it beneath E0056.
  • aggrega plugin add provider now writes provider/<name>, which the next pull resolves; an oci:// 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 sh

Windows (PowerShell):

$env:AGGREGA_VERSION = '0.8.9'; irm https://github.com/aggrega-ai/aggrega-cli/releases/download/v0.8.9/install.ps1 | iex

Both 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.