ace-swarm 2.3.0 → 2.3.1

package/README.md

@@ -1,8 +1,8 @@
 # ACE Swarm MCP Server
 
-ACE Swarm is an MCP server and terminal-first CLI for durable agent orchestration.
+ACE Swarm is an MCP server and terminal-first CLI for durable multi-agent orchestration and agent runtime infrastructure.
 
-It turns agent workflows into a local control plane with explicit state, handoffs, locks, diffs, runtime profiles, and operator tooling.
+It exposes 90+ MCP tools that turn agent workflow coordination into a local control plane with explicit state, typed handoffs, resource locks, semantic diffs, runtime profiles, and operator tooling. No signup. No API key required for the Ollama path. One command to bootstrap.
 
 ## System Map
 
@@ -60,6 +60,8 @@ ACE Swarm
 +----+-----------------------------------------------+-----------------------------------------------+
 ```
 
+30 seconds later the workspace has 17 agent roles, 15 packaged skills, a durable state layer, and MCP client configs for Codex, VS Code, Claude Desktop, Cursor, Gemini, and Antigravity.
+
 ## Recent Releases
 
 ```text
@@ -114,7 +116,7 @@ See [CHANGELOG.md](./CHANGELOG.md) for detailed release notes.
 | Bootstrap        | workspace state, tasks, configs              | `ace init`, `ace turnkey`, `ace mcp-config`          |
 | Agent runtime    | swarm roles, model bridge, tool planning     | MCP server, TUI `/agent`, packaged agent assets      |
 | Durable state    | ledgers, TODOs, handoffs, status events      | runtime stores under `agent-state/*`                 |
-| Dispatch         | queue, lock table, lease, recovery           | `enqueue_job`, `dispatch_jobs`, `complete_job`       |
+| Dispatch         | job queue, lock table, lease, recovery       | `enqueue_job`, `dispatch_jobs`, `complete_job`       |
 | Supervision      | plan amendment, handoff, Vericify, breakers  | `superviseTaskPlan`, `amendTaskPlan`                 |
 | Change analysis  | delta scan, semantic diff, rewrite hints     | `scan_workspace_delta`, `semantic_diff`, etc.        |
 | Operator UI      | tabs, ACE chat bridge, telemetry, providers  | `ace tui`                                            |
@@ -222,17 +224,17 @@ See [CHANGELOG.md](./CHANGELOG.md) for detailed release notes.
 
 Provider notes:
 
-- Ollama works directly through `ace tui`.
-- ACE workspaces automatically route chat tabs through the ACE model bridge, including a pre-execution tool-selection pass and streamed tool/result updates in the transcript.
+- Ollama works directly through `ace tui` — a zero-cost local AI agent runtime with no API keys required.
+- ACE workspaces automatically route chat tabs through the ACE model bridge, handling the full AI agent lifecycle from tool selection through execution, with streamed tool/result updates in the transcript.
 - OpenAI-compatible providers use `OPENAI_API_KEY` and optional `OPENAI_BASE_URL`, or provider-scoped equivalents such as `CODEX_API_KEY` and `CODEX_BASE_URL`.
 - `/agent` sessions can now accept follow-up input while blocked or idle, so operators can continue a run without relaunching the worker tab.
 - VS Code Copilot model hints may appear in discovery, but the standalone TUI does not directly execute through the VS Code chat runtime without an extension-side bridge.
 
 ## Supervisor And Bridge Notes
 
-- `ModelBridge` now performs a tool-planning turn before execution and can amend the model-selected scope mid-run when another valid ACE tool is required.
-- Supervisor helpers now support sequential task-plan execution with amendments, handoff create/ack flows, Vericify context carry-forward, and circuit-breaker open/close hooks.
-- Hook dispatch now emits richer role-aware ACE context across workspace lifecycle events, including Codex, Claude, VS Code, Cursor, Gemini, and Antigravity hook bundles.
+- `ModelBridge` performs a tool-planning turn before execution — selecting from the 90+ registered tools — and can amend the model-selected scope mid-run when another valid ACE tool is required.
+- Supervisor helpers support sequential task-plan execution with amendments, typed agent handoff protocol flows with schema validation, Vericify context carry-forward for state continuity, and circuit-breaker open/close hooks for upstream failure handling.
+- Hook dispatch emits richer role-aware ACE context across workspace lifecycle events, including Codex, Claude Code, VS Code Copilot, Cursor, Gemini, and Antigravity hook bundles.
 
 ## Bootstrap Outputs
 
@@ -256,7 +258,7 @@ Provider notes:
 +-----------------------------------+------------------------------------------------------+
 ```
 
-Local-model bootstrap:
+Local-model bootstrap (no API key, no cloud dependency):
 
 ```bash
 npx -y ace-swarm turnkey --project "My Project" --llm ollama --model llama3.1:8b
@@ -289,7 +291,7 @@ ace doctor --llm ollama --model llama3.1:8b
 +----------------------+-----------------------------------------------------------+
 | Swarm agents         | 4: orchestrator, vos, ui, coders                         |
 | Composable agents    | 13: astgrep, skeptic, ops, research, spec, builder, ... |
-| Skills               | 11 packaged skills including orchestrator, codemunch,   |
+| Skills               | 15 packaged skills including orchestrator, codemunch,   |
 |                      | codesnipe, state-auditor, schema-forge, release-sentry  |
 | Tasks / templates    | `todo.md`, `lessons.md`, `role_tasks.md`,               |
 |                      | `cli_work_split.md`, `SWARM_HANDOFF.template.json`      |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ace-swarm",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "description": "ACE Framework MCP server and CLI bootstrap for prompts, skills, handoffs, and stateful swarm orchestration.",
   "type": "module",
   "main": "dist/index.js",