Skip to content

AID v2.1.0

Choose a tag to compare

@github-actions github-actions released this 13 Jul 15:21

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's ELICIT state 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 a mcp-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 (plus aid-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-triage routes 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 dead kb.html button. 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.html is 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 existing features/feature-NNN/ pattern); the Lite path drops the extra folder and keeps the single delivery's lifecycle/gate directly in the work-root STATE.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 stop now reliably kills the actual server process. Previously it could kill only the cmd/.bat wrapper, 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 master pushes or a manual dispatch. (#131)
  • Stale skill/shortcut counts in docs/install.md corrected, with a new guard test to prevent recurrence. (#137)

Upgrade

  • Existing project: aid update refreshes all installed tools; aid update self updates the aid CLI itself — channel-aware: it re-runs the bootstrap script for curl/irm installs, or prints npm install -g aid-installer@latest / pipx upgrade aid-installer for those channels.
  • New install (bootstrap once per machine):
    curl -fsSL https://raw.githubusercontent.com/AndreVianna/aid-methodology/master/install.sh | bash
    irm https://raw.githubusercontent.com/AndreVianna/aid-methodology/master/install.ps1 | iex
    Then aid add <tool> inside your project.
  • aid-installer is also published to npm (npm i -g aid-installer) and PyPI (pipx install aid-installer). Per-profile tarballs and SHA256SUMS are attached to this GitHub Release for offline/air-gapped installs.