AID v2.1.0
AID v2.1.0 — a feature release: a catalog-based connector registry with full lifecycle management, a verb-first "AID Lite" shortcut path for small changes, and a structural rewrite of dashboard state tracking. Builds on v2.0.6.
Highlights
- Connector lifecycle + consumption.
.aid/connectors/is now a full catalog, not just a scan result:aid-discover'sELICITstate authors it, and two new on-demand skills —aid-set-connector/aid-unset-connector— let you add, update, or remove a connector at any time without re-running discovery. Pipeline skills now consume the catalog MCP-first: for amcp-type connection they tell the agent to request it from your host tool's own MCP/plugin (Claude Code, Codex, Cursor, …) — AID resolves nothing and stores no credential for it. (#133, #143) - AID Lite: verb-first shortcuts. Already know your change?
/aid-fix,/aid-create-api,/aid-change-cli, and dozens more — 51 verb-first shortcut skills (plusaid-add-*/aid-update-*aliases, 80 invocation names in all) spanning create, change, refactor, remove, deprecate, migrate, fix, test, prototype, document, report, review, and research — collapse Describe → Define → Specify → Plan → Detail into one fast, mostly-autonomous run that still produces the full graded artifact set, then halts for your approval. No interview required./aid-triageroutes a free-form description to the right entry point (a shortcut,/aid-describe, or/aid-ask) when you're not sure. (#134) - Structured
STATE.md. Machine-parsed pipeline state (approval, grade, status, counts, paths) moves from free-form prose into a defined YAML-frontmatter schema, read deterministically by the dashboard — closing out a class of regex-parsing bugs, including the one where an approved Knowledge Base could render as still "Building" with a deadkb.htmlbutton. The dashboard's phase model was also rebuilt to match the real pipeline (Describe → Define → Specify → Plan → Detail → Execute), with the Lite path (Describe → Execute → Done) rendered distinctly. (#140) - Dashboard served from the CLI.
home.htmlis now a data-free template served from the CLI's own install rather than a per-project committed copy, so every project's dashboard page is always current with the installed CLI version — no more drift, no manual refresh. (#142)
Improvements
- Delivery-folder layout rationalized: the full path nests deliveries under
deliveries/delivery-NNN/(mirroring the existingfeatures/feature-NNN/pattern); the Lite path drops the extra folder and keeps the single delivery's lifecycle/gate directly in the work-rootSTATE.md. (#132) kb.html(the Knowledge Base visual summary) is now a per-project generated artifact at.aid/knowledge/kb.html; the old.aid/dashboard/folder is retired entirely. (#142)
Fixes
- Security/correctness: a bounded-read guard (
io_bounds.py, a 5 MB DoS-protection module used by the dashboard reader at 9 call sites) was missing from every install channel's manifest. A release built from that state would have shipped a dashboard reader that fails to import on npm, PyPI, and curl/bash installs — caught and fixed before publish. (#137) - Windows:
aid dashboard stopnow reliably kills the actual server process. Previously it could kill only thecmd/.batwrapper, leaving an orphaned server bound to the port; a port-reap safety net now cleans up any older orphan still listening. This was the root cause of a dashboard that showed every pipeline as "0 tasks / 0 deliveries" after repeated start/stop cycles. (#136) - Docs site (Pages) deploy no longer runs a doomed job on tag-triggered GitHub Releases; it now deploys only from
masterpushes or a manual dispatch. (#131) - Stale skill/shortcut counts in
docs/install.mdcorrected, with a new guard test to prevent recurrence. (#137)
Upgrade
- Existing project:
aid updaterefreshes all installed tools;aid update selfupdates theaidCLI itself — channel-aware: it re-runs the bootstrap script for curl/irm installs, or printsnpm install -g aid-installer@latest/pipx upgrade aid-installerfor those channels. - New install (bootstrap once per machine):
curl -fsSL https://raw.githubusercontent.com/AndreVianna/aid-methodology/master/install.sh | bashThenirm https://raw.githubusercontent.com/AndreVianna/aid-methodology/master/install.ps1 | iex
aid add <tool>inside your project. aid-installeris also published to npm (npm i -g aid-installer) and PyPI (pipx install aid-installer). Per-profile tarballs andSHA256SUMSare attached to this GitHub Release for offline/air-gapped installs.