ace-swarm 2.0.7 → 2.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +58 -0
- package/README.md +221 -262
- package/package.json +3 -2
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
This changelog is based on local tagged release history and repository diffs.
|
|
4
|
+
|
|
5
|
+
## [2.1.0] - 2026-03-13
|
|
6
|
+
|
|
7
|
+
### Changed
|
|
8
|
+
|
|
9
|
+
- Rewrote the package README into a tighter operator-facing format with ASCII system maps and compact internal tables.
|
|
10
|
+
- Added a recent-release summary to the README so the last three versions remain visible without turning the README into a full changelog.
|
|
11
|
+
|
|
12
|
+
### Added
|
|
13
|
+
|
|
14
|
+
- Added `CHANGELOG.md` to track tagged package release notes directly in the package.
|
|
15
|
+
|
|
16
|
+
### Packaging
|
|
17
|
+
|
|
18
|
+
- Bumped package version from `2.0.7` to `2.1.0`.
|
|
19
|
+
|
|
20
|
+
## [2.0.7] - 2026-03-13
|
|
21
|
+
|
|
22
|
+
### Added
|
|
23
|
+
|
|
24
|
+
- Added runtime profile, runtime command, runtime executor, and runtime tool spec surfaces.
|
|
25
|
+
- Added tracker adapters and tracker snapshot synchronization.
|
|
26
|
+
- Added workspace-manager and Vericify bridge surfaces.
|
|
27
|
+
- Added problem triage, skill auditor, skill catalog, and public-surface audit modules.
|
|
28
|
+
- Added VS Code Copilot hook scaffolding and new packaged runtime/state schema assets.
|
|
29
|
+
|
|
30
|
+
### Validation
|
|
31
|
+
|
|
32
|
+
- Added broad new test coverage for runtime execution, tracker adapters, workspace management, problem triage, skill auditing, public surface checks, Vericify bridge behavior, and Copilot hook dispatch.
|
|
33
|
+
|
|
34
|
+
## [2.0.6] - 2026-03-10
|
|
35
|
+
|
|
36
|
+
### Fixed
|
|
37
|
+
|
|
38
|
+
- Hardened bootstrap workspace path handling in `src/helpers.ts`.
|
|
39
|
+
- Updated `assets/scripts/bootstrap-workspace.sh` to align with the fixed workspace bootstrap path flow.
|
|
40
|
+
|
|
41
|
+
### Validation
|
|
42
|
+
|
|
43
|
+
- Added integration coverage for workspace bootstrap behavior.
|
|
44
|
+
|
|
45
|
+
## [2.0.5] - 2026-03-10
|
|
46
|
+
|
|
47
|
+
### Added
|
|
48
|
+
|
|
49
|
+
- Added packaged `ARTIFACT_MANIFEST.json`.
|
|
50
|
+
- Expanded artifact-manifest and provenance-related schema coverage.
|
|
51
|
+
|
|
52
|
+
### Changed
|
|
53
|
+
|
|
54
|
+
- Tightened framework/file tool handling around artifact manifests and provenance enforcement.
|
|
55
|
+
|
|
56
|
+
### Validation
|
|
57
|
+
|
|
58
|
+
- Added integration and schema tests for the artifact-manifest path.
|
package/README.md
CHANGED
|
@@ -1,324 +1,283 @@
|
|
|
1
1
|
# ACE Swarm MCP Server
|
|
2
2
|
|
|
3
|
-
ACE Swarm
|
|
3
|
+
ACE Swarm is an MCP server and terminal-first CLI for durable agent orchestration.
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
It turns agent workflows into a local control plane with explicit state, handoffs, locks, diffs, runtime profiles, and operator tooling.
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
## System Map
|
|
8
8
|
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
9
|
+
```text
|
|
10
|
+
ACE Swarm
|
|
11
|
+
|
|
|
12
|
+
+-- bootstrap
|
|
13
|
+
| +-- `ace init` / `ace turnkey`
|
|
14
|
+
| +-- workspace scaffolding
|
|
15
|
+
| `-- MCP client config bundle
|
|
16
|
+
|
|
|
17
|
+
+-- control plane
|
|
18
|
+
| +-- agents
|
|
19
|
+
| | +-- swarm: orchestrator, vos, ui, coders
|
|
20
|
+
| | `-- composable: skeptic, ops, research, spec, builder, qa, docs, ...
|
|
21
|
+
| +-- contracts
|
|
22
|
+
| | +-- prompts
|
|
23
|
+
| | +-- schemas
|
|
24
|
+
| | `-- handoff templates
|
|
25
|
+
| +-- runtime state
|
|
26
|
+
| | +-- run ledger
|
|
27
|
+
| | +-- todo state
|
|
28
|
+
| | +-- handoff registry
|
|
29
|
+
| | +-- status events
|
|
30
|
+
| | +-- job queue
|
|
31
|
+
| | +-- lock table
|
|
32
|
+
| | `-- scheduler lease
|
|
33
|
+
| `-- dispatch
|
|
34
|
+
| +-- immediate scheduling
|
|
35
|
+
| +-- priority bands
|
|
36
|
+
| +-- persistent resource locks
|
|
37
|
+
| `-- recovery semantics
|
|
38
|
+
|
|
|
39
|
+
+-- change intelligence
|
|
40
|
+
| +-- workspace delta scan
|
|
41
|
+
| +-- semantic snapshots
|
|
42
|
+
| +-- semantic diff / drift report
|
|
43
|
+
| +-- rewrite targets
|
|
44
|
+
| `-- safe edit rollback
|
|
45
|
+
|
|
|
46
|
+
`-- operator surface
|
|
47
|
+
+-- MCP server on stdio
|
|
48
|
+
`-- TUI: chat, tabs, telemetry, provider-aware runtime
|
|
13
49
|
```
|
|
14
50
|
|
|
15
|
-
|
|
51
|
+
## Quick Start
|
|
16
52
|
|
|
17
|
-
```
|
|
18
|
-
|
|
19
|
-
#
|
|
20
|
-
|
|
53
|
+
```text
|
|
54
|
+
+----+-----------------------------------------------+-----------------------------------------------+
|
|
55
|
+
| # | Command | Result |
|
|
56
|
+
+----+-----------------------------------------------+-----------------------------------------------+
|
|
57
|
+
| 1 | npx -y ace-swarm turnkey --project "My Proj" | Seeds workspace state, agents, skills, tasks |
|
|
58
|
+
| 2 | ace mcp | Starts the MCP server over stdio |
|
|
59
|
+
| 3 | initiate ACE | Kicks off the ACE workflow in your MCP host |
|
|
60
|
+
+----+-----------------------------------------------+-----------------------------------------------+
|
|
21
61
|
```
|
|
22
62
|
|
|
23
|
-
|
|
63
|
+
## Recent Releases
|
|
24
64
|
|
|
25
|
-
```
|
|
26
|
-
|
|
65
|
+
```text
|
|
66
|
+
+---------+------------+------------------------------------------------------+
|
|
67
|
+
| Version | Date | Highlights |
|
|
68
|
+
+---------+------------+------------------------------------------------------+
|
|
69
|
+
| 2.1.0 | 2026-03-13 | README redesign, ASCII docs, packaged changelog |
|
|
70
|
+
| 2.0.7 | 2026-03-13 | runtime executor/profile/tools, trackers, workspace |
|
|
71
|
+
| 2.0.6 | 2026-03-10 | bootstrap/workspace helper hardening |
|
|
72
|
+
+---------+------------+------------------------------------------------------+
|
|
27
73
|
```
|
|
28
74
|
|
|
29
|
-
|
|
75
|
+
See [CHANGELOG.md](./CHANGELOG.md) for the recent tagged release history that can be verified from the local repository.
|
|
30
76
|
|
|
31
|
-
|
|
77
|
+
## Core Surfaces
|
|
32
78
|
|
|
33
|
-
```
|
|
34
|
-
|
|
79
|
+
```text
|
|
80
|
+
+------------------+------------------------------------------+--------------------------------------------------+
|
|
81
|
+
| Surface | Internals | Public entrypoints |
|
|
82
|
+
+------------------+------------------------------------------+--------------------------------------------------+
|
|
83
|
+
| Bootstrap | workspace state, tasks, configs | `ace init`, `ace turnkey`, `ace mcp-config` |
|
|
84
|
+
| Agent runtime | swarm + composable roles | MCP server, TUI `/agent`, packaged agent assets |
|
|
85
|
+
| Durable state | ledgers, TODOs, handoffs, status events | runtime stores under `agent-state/*` |
|
|
86
|
+
| Dispatch | queue, lock table, lease, recovery | `enqueue_job`, `dispatch_jobs`, `complete_job` |
|
|
87
|
+
| Change analysis | delta scan, semantic diff, rewrite hints | `scan_workspace_delta`, `semantic_diff`, etc. |
|
|
88
|
+
| Operator UI | tabs, chat, telemetry, model switching | `ace tui` |
|
|
89
|
+
+------------------+------------------------------------------+--------------------------------------------------+
|
|
35
90
|
```
|
|
36
91
|
|
|
37
|
-
|
|
92
|
+
## Workspace Internals
|
|
38
93
|
|
|
39
|
-
```
|
|
40
|
-
|
|
94
|
+
```text
|
|
95
|
+
+----------------------------------+--------------------------------------------------+
|
|
96
|
+
| Path | What lives there |
|
|
97
|
+
+----------------------------------+--------------------------------------------------+
|
|
98
|
+
| `agent-state/run-ledger.json` | major updates, regressions, runtime history |
|
|
99
|
+
| `agent-state/todo-state.json` | TODO nodes, dependencies, transition truth |
|
|
100
|
+
| `agent-state/handoff-registry.json` | handoff lifecycle state |
|
|
101
|
+
| `agent-state/STATUS_EVENTS.ndjson` | append-only lifecycle/status event log |
|
|
102
|
+
| `agent-state/job-queue.json` | queued work with dependency and priority metadata |
|
|
103
|
+
| `agent-state/job-locks.json` | active resource lock table |
|
|
104
|
+
| `agent-state/scheduler-lease.json` | active dispatcher owner and lease state |
|
|
105
|
+
| `agent-state/index.json` | workspace delta index |
|
|
106
|
+
| `.tmp/cache/semantic/*` | semantic snapshots and diff cache |
|
|
107
|
+
| `.ace/llm-profile.json` | local runtime profile when configured |
|
|
108
|
+
+----------------------------------+--------------------------------------------------+
|
|
41
109
|
```
|
|
42
110
|
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
- `agent-state/*`
|
|
46
|
-
- `.github/hooks/*.json`
|
|
47
|
-
- `.agents/ACE/*` and `.agents/skills/*`
|
|
48
|
-
- `tasks/*`
|
|
49
|
-
- `scripts/ace/*`
|
|
50
|
-
- `.vscode/mcp.json`
|
|
51
|
-
- `.mcp-config/{codex.config.toml,vscode.mcp.json,claude_desktop_config.json,cursor.mcp.json,antigravity.mcp.json}`
|
|
111
|
+
## Change And Safety Internals
|
|
52
112
|
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
- adds verification reminders after file mutations in `PostToolUse`
|
|
66
|
-
|
|
67
|
-
VS Code loads `.github/hooks/*.json` by default, so no extra workspace setting is required for the default Copilot hook path.
|
|
68
|
-
|
|
69
|
-
### Turnkey with Ollama (Local Models)
|
|
70
|
-
|
|
71
|
-
Bootstrap ACE + local model profile in one command:
|
|
72
|
-
|
|
73
|
-
```bash
|
|
74
|
-
npx -y ace-swarm turnkey --project "My Project" --llm ollama --model llama3.1:8b
|
|
113
|
+
```text
|
|
114
|
+
+-------------------------+----------------------------------------------+
|
|
115
|
+
| Capability | Current surface |
|
|
116
|
+
+-------------------------+----------------------------------------------+
|
|
117
|
+
| Coarse workspace diff | `scan_workspace_delta` |
|
|
118
|
+
| Semantic snapshot | `snapshot_state` |
|
|
119
|
+
| Semantic diff | `semantic_diff` |
|
|
120
|
+
| Drift gate | `drift_report` |
|
|
121
|
+
| Rewrite targeting | `rewrite_targets` |
|
|
122
|
+
| Exact diff summary | `diff_files`, `git_diff` |
|
|
123
|
+
| Safe write + rollback | `safe_edit_file` |
|
|
124
|
+
+-------------------------+----------------------------------------------+
|
|
75
125
|
```
|
|
76
126
|
|
|
77
|
-
|
|
127
|
+
## CLI
|
|
78
128
|
|
|
79
|
-
```
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
129
|
+
```text
|
|
130
|
+
+---------------------------------------------+----------------------------------------------+
|
|
131
|
+
| Command | Purpose |
|
|
132
|
+
+---------------------------------------------+----------------------------------------------+
|
|
133
|
+
| `ace mcp` / `ace serve` | start MCP server over stdio |
|
|
134
|
+
| `ace tui [options]` | launch terminal operator console |
|
|
135
|
+
| `ace init [options]` | bootstrap ACE files into current workspace |
|
|
136
|
+
| `ace turnkey [options]` | bootstrap + client config bundle |
|
|
137
|
+
| `ace doctor [options]` | validate local LLM + MCP readiness |
|
|
138
|
+
| `ace mcp-config [--client <name>|--all]` | print one or all MCP client snippets |
|
|
139
|
+
| `ace paths` | show resolved package and workspace paths |
|
|
140
|
+
+---------------------------------------------+----------------------------------------------+
|
|
83
141
|
```
|
|
84
142
|
|
|
85
|
-
|
|
143
|
+
### Key Options
|
|
86
144
|
|
|
87
|
-
```
|
|
88
|
-
|
|
89
|
-
|
|
145
|
+
```text
|
|
146
|
+
+-------------------------------+---------------------------------------------+
|
|
147
|
+
| Command group | Options |
|
|
148
|
+
+-------------------------------+---------------------------------------------+
|
|
149
|
+
| `init` / `turnkey` | `--project`, `--force`, `--no-mcp-config` |
|
|
150
|
+
| | `--no-client-config-bundle` |
|
|
151
|
+
| | `--llm`, `--model`, `--ollama-url` |
|
|
152
|
+
| `tui` | `--provider`, `--model`, `--ollama-url` |
|
|
153
|
+
| `doctor` | `--llm`, `--model`, `--ollama-url` |
|
|
154
|
+
+-------------------------------+---------------------------------------------+
|
|
90
155
|
```
|
|
91
156
|
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
- `.ace/llm-profile.json`
|
|
95
|
-
- `.ace/doctor-checks.md`
|
|
96
|
-
|
|
97
|
-
Rollout status:
|
|
98
|
-
|
|
99
|
-
- `P0`: `init/turnkey` supports `--llm ollama --model --ollama-url`.
|
|
100
|
-
- `P1`: `ace doctor` validates MCP config, Ollama endpoint, and model presence.
|
|
101
|
-
- `P2`: MCP `bootstrap_state` supports `llm_provider`, `ollama_model`, `ollama_base_url`.
|
|
102
|
-
|
|
103
|
-
## Client Compatibility
|
|
104
|
-
|
|
105
|
-
ACE Swarm ships config templates for:
|
|
106
|
-
|
|
107
|
-
- Codex
|
|
108
|
-
- VS Code
|
|
109
|
-
- Claude Desktop
|
|
110
|
-
- Cursor
|
|
111
|
-
- Antigravity
|
|
157
|
+
## TUI
|
|
112
158
|
|
|
113
|
-
|
|
159
|
+
```text
|
|
160
|
+
+----------------------+----------------------------------------------+
|
|
161
|
+
| Command | Description |
|
|
162
|
+
+----------------------+----------------------------------------------+
|
|
163
|
+
| `/provider [name]` | show or switch active provider |
|
|
164
|
+
| `/providers` | list discovered providers |
|
|
165
|
+
| `/models` | list available models |
|
|
166
|
+
| `/model <name>` | switch active model |
|
|
167
|
+
| `/pull <name>` | download an Ollama model |
|
|
168
|
+
| `/ollama` | show Ollama connection status |
|
|
169
|
+
| `/agent <role>` | launch a subagent tab |
|
|
170
|
+
| `/agents` | list agent roles and status |
|
|
171
|
+
| `/status` | show orchestrator status |
|
|
172
|
+
| `/chat` | open a chat tab |
|
|
173
|
+
| `/logs` | open logs tab |
|
|
174
|
+
| `/help` | list commands |
|
|
175
|
+
| `/quit` | exit the TUI |
|
|
176
|
+
+----------------------+----------------------------------------------+
|
|
177
|
+
```
|
|
114
178
|
|
|
115
|
-
```
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
179
|
+
```text
|
|
180
|
+
+----------------------+----------------------------------------------+
|
|
181
|
+
| Shortcut | Action |
|
|
182
|
+
+----------------------+----------------------------------------------+
|
|
183
|
+
| `Alt+1-9` | switch tabs |
|
|
184
|
+
| `Tab` / `Shift+Tab` | cycle tabs |
|
|
185
|
+
| `Ctrl+N` | new chat |
|
|
186
|
+
| `Ctrl+R` | refresh |
|
|
187
|
+
| `Ctrl+D` | quit |
|
|
188
|
+
+----------------------+----------------------------------------------+
|
|
119
189
|
```
|
|
120
190
|
|
|
121
|
-
|
|
191
|
+
Provider notes:
|
|
122
192
|
|
|
123
|
-
-
|
|
124
|
-
- `
|
|
125
|
-
-
|
|
126
|
-
- `cursor`: `~/.cursor/mcp.json`
|
|
127
|
-
- `antigravity`: import/use `.mcp-config/antigravity.mcp.json` from the client MCP settings UI
|
|
193
|
+
- Ollama works directly through `ace tui`.
|
|
194
|
+
- 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`.
|
|
195
|
+
- 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.
|
|
128
196
|
|
|
129
|
-
##
|
|
197
|
+
## Bootstrap Outputs
|
|
130
198
|
|
|
131
|
-
```
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
ace
|
|
199
|
+
```text
|
|
200
|
+
+----------------------------------+----------------------------------------------+
|
|
201
|
+
| Path | Output |
|
|
202
|
+
+----------------------------------+----------------------------------------------+
|
|
203
|
+
| `agent-state/*` | state, ledgers, schemas, reports |
|
|
204
|
+
| `.agents/ACE/*` | packaged agent instructions |
|
|
205
|
+
| `.agents/skills/*` | packaged skills |
|
|
206
|
+
| `tasks/*` | task packs, examples, handoff templates |
|
|
207
|
+
| `scripts/ace/*` | helper scripts |
|
|
208
|
+
| `.vscode/mcp.json` | VS Code MCP config |
|
|
209
|
+
| `.mcp-config/*` | Codex / VS Code / Claude / Cursor / Antigravity |
|
|
210
|
+
| `.github/hooks/*.json` | optional workspace hook policies |
|
|
211
|
+
+----------------------------------+----------------------------------------------+
|
|
140
212
|
```
|
|
141
213
|
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
Launch a full-screen terminal dashboard with provider-aware model chat, agent tabs, telemetry, and task tracking:
|
|
214
|
+
Local-model bootstrap:
|
|
145
215
|
|
|
146
216
|
```bash
|
|
147
|
-
ace
|
|
148
|
-
|
|
217
|
+
npx -y ace-swarm turnkey --project "My Project" --llm ollama --model llama3.1:8b
|
|
218
|
+
ollama serve
|
|
219
|
+
ollama pull llama3.1:8b
|
|
220
|
+
ace doctor --llm ollama --model llama3.1:8b
|
|
149
221
|
```
|
|
150
222
|
|
|
151
|
-
|
|
223
|
+
## Client Config Targets
|
|
152
224
|
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
VS Code
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
|
163
|
-
|
|
164
|
-
| `/provider [name]` | Show or switch active provider |
|
|
165
|
-
| `/providers` | List discovered providers |
|
|
166
|
-
| `/models` | List available models for active provider |
|
|
167
|
-
| `/model <name>` | Switch active model (`Tab` searches discovered models, including Ollama) |
|
|
168
|
-
| `/pull <name>` | Download an Ollama model |
|
|
169
|
-
| `/ollama` | Check Ollama connection status and hints |
|
|
170
|
-
| `/agent <role>` | Start a subagent in a new tab |
|
|
171
|
-
| `/agents` | List all agent roles and status |
|
|
172
|
-
| `/status` | Show orchestrator status |
|
|
173
|
-
| `/chat` | Open new chat tab |
|
|
174
|
-
| `/logs` | Open logs tab |
|
|
175
|
-
| `/help` | List all commands |
|
|
176
|
-
| `/quit` | Exit TUI |
|
|
177
|
-
|
|
178
|
-
Keyboard shortcuts: `Alt+1-9` switch tabs, `Tab/Shift+Tab` cycle tabs, `Ctrl+N` new chat, `Ctrl+R` refresh, `Ctrl+D` quit.
|
|
179
|
-
|
|
180
|
-
Options for `init` / `turnkey`:
|
|
181
|
-
|
|
182
|
-
```bash
|
|
183
|
-
--project <name> # Project name for global-state/MASTER_PLAN.md
|
|
184
|
-
--force # Overwrite scaffolded files
|
|
185
|
-
--no-mcp-config # Skip .vscode/mcp.json
|
|
186
|
-
--no-client-config-bundle # Skip .mcp-config client bundle
|
|
187
|
-
--llm <provider> # ollama
|
|
188
|
-
--model <name> # local model name (default: llama3.1:8b)
|
|
189
|
-
--ollama-url <url> # Ollama base URL (default: http://127.0.0.1:11434)
|
|
225
|
+
```text
|
|
226
|
+
+---------------+--------------------------------------------------------------+
|
|
227
|
+
| Client | Target |
|
|
228
|
+
+---------------+--------------------------------------------------------------+
|
|
229
|
+
| Codex | `$CODEX_HOME/config.toml` or `~/.codex/config.toml` |
|
|
230
|
+
| VS Code | `.vscode/mcp.json` |
|
|
231
|
+
| Claude | macOS: `~/Library/Application Support/Claude/...` |
|
|
232
|
+
| | Linux: `~/.config/Claude/claude_desktop_config.json` |
|
|
233
|
+
| Cursor | `~/.cursor/mcp.json` |
|
|
234
|
+
| Antigravity | import `.mcp-config/antigravity.mcp.json` in client UI |
|
|
235
|
+
+---------------+--------------------------------------------------------------+
|
|
190
236
|
```
|
|
191
237
|
|
|
192
|
-
|
|
238
|
+
## Included Assets
|
|
193
239
|
|
|
194
|
-
```
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
240
|
+
```text
|
|
241
|
+
+----------------------+-----------------------------------------------------------+
|
|
242
|
+
| Asset class | Included |
|
|
243
|
+
+----------------------+-----------------------------------------------------------+
|
|
244
|
+
| Swarm agents | 4: orchestrator, vos, ui, coders |
|
|
245
|
+
| Composable agents | 13: astgrep, skeptic, ops, research, spec, builder, ... |
|
|
246
|
+
| Skills | 11 packaged skills including orchestrator, codemunch, |
|
|
247
|
+
| | codesnipe, state-auditor, schema-forge, release-sentry |
|
|
248
|
+
| Tasks / templates | `todo.md`, `lessons.md`, `role_tasks.md`, |
|
|
249
|
+
| | `cli_work_split.md`, `SWARM_HANDOFF.template.json` |
|
|
250
|
+
+----------------------+-----------------------------------------------------------+
|
|
198
251
|
```
|
|
199
252
|
|
|
200
|
-
##
|
|
201
|
-
|
|
202
|
-
After bootstrap, start your MCP host and issue:
|
|
253
|
+
## Open Ideas
|
|
203
254
|
|
|
204
255
|
```text
|
|
205
|
-
|
|
256
|
+
+---------------------------------------------------------------+
|
|
257
|
+
| Not shipped guarantees |
|
|
258
|
+
+---------------------------------------------------------------+
|
|
259
|
+
| high-certainty shadow workspace promotion mode |
|
|
260
|
+
| explicit promotion manifests for exact patch + AST evidence |
|
|
261
|
+
| richer operator views for rejected promotions and drift spikes|
|
|
262
|
+
+---------------------------------------------------------------+
|
|
206
263
|
```
|
|
207
264
|
|
|
208
|
-
## Schema Validation (Runtime)
|
|
209
|
-
|
|
210
|
-
Schema validation is wired into MCP tool execution paths:
|
|
211
|
-
|
|
212
|
-
- `create_handoff`: validates handoff payload before write
|
|
213
|
-
- `validate_handoff`: supports `schema_mode: auto|swarm|agent-state`
|
|
214
|
-
- `write_workspace_file`: blocks invalid writes for:
|
|
215
|
-
- `agent-state/HANDOFF.json`
|
|
216
|
-
- `agent-state/HANDOFF_HISTORY/*.json`
|
|
217
|
-
- `agent-state/STATUS_EVENTS.ndjson`
|
|
218
|
-
- `ARTIFACT_MANIFEST.json`
|
|
219
|
-
- `SWARM_HANDOFF.*.json`
|
|
220
|
-
|
|
221
|
-
Validation code is in `src/schemas.ts`.
|
|
222
|
-
|
|
223
|
-
## Kanban Snapshot (Runtime)
|
|
224
|
-
|
|
225
|
-
ACE Swarm now maintains a lightweight Kanban board in workspace state:
|
|
226
|
-
|
|
227
|
-
- `agent-state/kanban.json`
|
|
228
|
-
- `agent-state/kanban.html`
|
|
229
|
-
|
|
230
|
-
You can regenerate manually with MCP tool `generate_kanban_ui`, and the server auto-refreshes Kanban after major artifact writes (`update_todo`, `create_handoff`, `bootstrap_state`, and `write_workspace_file` on ACE state/task/code paths).
|
|
231
|
-
|
|
232
|
-
Resources:
|
|
233
|
-
|
|
234
|
-
- `ace://kanban` (JSON)
|
|
235
|
-
- `ace://kanban/html` (HTML)
|
|
236
|
-
|
|
237
|
-
## Scheduler Queue (Runtime)
|
|
238
|
-
|
|
239
|
-
ACE Swarm now supports a lease-owned dispatcher for handoff/job execution:
|
|
240
|
-
|
|
241
|
-
- `agent-state/job-queue.json`
|
|
242
|
-
- `agent-state/job-locks.json`
|
|
243
|
-
- `agent-state/scheduler-lease.json`
|
|
244
|
-
|
|
245
|
-
Dispatch model:
|
|
246
|
-
|
|
247
|
-
- Priority-aware (`P0 > P1 > P2 > P3`) with FIFO ordering inside each band.
|
|
248
|
-
- Immediate dispatch of runnable jobs; no interval gating.
|
|
249
|
-
- Collision-free resource locks held until explicit completion/failure.
|
|
250
|
-
- Lease heartbeat/recovery handles crash detection instead of slice overruns.
|
|
251
|
-
|
|
252
|
-
Handoff integration:
|
|
253
|
-
|
|
254
|
-
- `create_handoff` and `ack_handoff` automatically sync lifecycle updates into scheduler jobs.
|
|
255
|
-
- Existing open/accepted handoffs are backfilled into scheduler state on startup.
|
|
256
|
-
|
|
257
|
-
## New Runtime State Stores
|
|
258
|
-
|
|
259
|
-
ACE Swarm now persists additional orchestration stores:
|
|
260
|
-
|
|
261
|
-
- `agent-state/run-ledger.json` (major updates + regressions)
|
|
262
|
-
- `agent-state/todo-state.json` (explicit TODO statuses, dependencies, transition gates)
|
|
263
|
-
- `agent-state/index.json` (workspace delta scan index)
|
|
264
|
-
- `agent-state/handoff-registry.json` (handoff lifecycle: `open|accepted|blocked|completed`)
|
|
265
|
-
- `agent-state/job-queue.json` (scheduler jobs with dependency/priority metadata)
|
|
266
|
-
- `agent-state/job-locks.json` (active resource lock table)
|
|
267
|
-
- `agent-state/scheduler-lease.json` (active scheduler owner/heartbeat)
|
|
268
|
-
|
|
269
|
-
New/extended tools:
|
|
270
|
-
|
|
271
|
-
- `update_todo` now supports either full board replacement (`new_content`) or gated node transitions (`node_id`, `status`)
|
|
272
|
-
- `scan_workspace_delta` writes indexed changed/unchanged/deleted diffs
|
|
273
|
-
- `ack_handoff` updates handoff lifecycle status
|
|
274
|
-
- `get_run_ledger`, `get_todo_state`, `get_handoff_status` expose persisted store state
|
|
275
|
-
- Scheduler: `enqueue_job`, `list_jobs`, `ack_job`, `dispatch_jobs`, `dispatch_job_now`, `complete_job`, `get_lock_table`, `get_scheduler_lease`
|
|
276
|
-
|
|
277
|
-
New resources:
|
|
278
|
-
|
|
279
|
-
- `ace://run-ledger`
|
|
280
|
-
- `ace://index`
|
|
281
|
-
- `ace://handoffs/status`
|
|
282
|
-
- `ace://scheduler/queue`
|
|
283
|
-
- `ace://scheduler/locks`
|
|
284
|
-
- `ace://scheduler/lease`
|
|
285
|
-
- `ace://kernel/directive_kernel`
|
|
286
|
-
- `ace://kernel/agent_registry`
|
|
287
|
-
|
|
288
|
-
New tool:
|
|
289
|
-
|
|
290
|
-
- `get_kernel_artifact` (`directive_kernel` | `agent_registry`)
|
|
291
|
-
|
|
292
|
-
## ACE Assets Included
|
|
293
|
-
|
|
294
|
-
### Agents (17)
|
|
295
|
-
|
|
296
|
-
- **Swarm (4):** Orchestrator, VOS, UI, Coders
|
|
297
|
-
- **Composable (13):** agent-astgrep, agent-skeptic, agent-ops, agent-research, agent-spec, agent-builder, agent-qa, agent-docs, agent-memory, agent-security, agent-observability, agent-eval, agent-release
|
|
298
|
-
|
|
299
|
-
### Skills
|
|
300
|
-
|
|
301
|
-
- Existing: `ace-orchestrator`, `codemunch`, `codesnipe`
|
|
302
|
-
- New: `state-auditor`, `schema-forge`, `handoff-lint`, `memory-curator`, `risk-quant`, `eval-harness`, `incident-commander`, `release-sentry`
|
|
303
|
-
|
|
304
|
-
### Tasks and Handoff Artifacts
|
|
305
|
-
|
|
306
|
-
- `todo.md`, `lessons.md`, `role_tasks.md`, `cli_work_split.md`
|
|
307
|
-
- `SWARM_HANDOFF.template.json` and examples
|
|
308
|
-
|
|
309
265
|
## Development
|
|
310
266
|
|
|
311
267
|
```bash
|
|
312
268
|
cd ace-mcp-server
|
|
313
269
|
npm install
|
|
314
270
|
npm run build
|
|
271
|
+
npm test
|
|
315
272
|
npm run start
|
|
316
273
|
```
|
|
317
274
|
|
|
318
|
-
##
|
|
275
|
+
## References
|
|
276
|
+
|
|
277
|
+
- [OpenAI Codex MCP config](https://platform.openai.com/docs/codex/mcp)
|
|
278
|
+
- [VS Code MCP](https://code.visualstudio.com/docs/copilot/chat/mcp-servers)
|
|
279
|
+
- [Cursor MCP](https://docs.cursor.com/context/model-context-protocol)
|
|
280
|
+
- [Claude Desktop MCP quickstart](https://modelcontextprotocol.io/quickstart/user)
|
|
281
|
+
- [Antigravity MCP setup](https://docs.antigravity.dev/how-to/configuring-an-mcp-server)
|
|
319
282
|
|
|
320
|
-
|
|
321
|
-
- VS Code MCP: [code.visualstudio.com/docs/copilot/chat/mcp-servers](https://code.visualstudio.com/docs/copilot/chat/mcp-servers)
|
|
322
|
-
- Cursor MCP: [docs.cursor.com/context/model-context-protocol](https://docs.cursor.com/context/model-context-protocol)
|
|
323
|
-
- Claude Desktop MCP quickstart: [modelcontextprotocol.io/quickstart/user](https://modelcontextprotocol.io/quickstart/user)
|
|
324
|
-
- Antigravity MCP server setup: [docs.antigravity.dev/how-to/configuring-an-mcp-server](https://docs.antigravity.dev/how-to/configuring-an-mcp-server)
|
|
283
|
+
Collaborations, ideas, or concerns: `voybio.fundr@gmail.com`
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "ace-swarm",
|
|
3
|
-
"version": "2.0
|
|
3
|
+
"version": "2.1.0",
|
|
4
4
|
"description": "ACE Framework MCP server and CLI bootstrap for prompts, skills, handoffs, and stateful swarm orchestration.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -12,7 +12,8 @@
|
|
|
12
12
|
"files": [
|
|
13
13
|
"dist",
|
|
14
14
|
"assets",
|
|
15
|
-
"README.md"
|
|
15
|
+
"README.md",
|
|
16
|
+
"CHANGELOG.md"
|
|
16
17
|
],
|
|
17
18
|
"scripts": {
|
|
18
19
|
"build": "tsc",
|