@voybio/ace-swarm 2.4.8 → 2.4.10

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.
Files changed (187) hide show
  1. package/CHANGELOG.md +52 -14
  2. package/README.md +14 -10
  3. package/assets/.agents/ACE/ACE_coders/AGENTS.md +23 -30
  4. package/assets/.agents/ACE/ACE_coders/INSTRUCTIONS.md +21 -30
  5. package/assets/.agents/skills/landing-review-watcher/SKILL.md +1 -1
  6. package/assets/.agents/skills/learn-from-work/SKILL.md +41 -0
  7. package/assets/agent-state/ACE_WORKFLOW.md +25 -2
  8. package/assets/agent-state/MODULES/schemas/ACE_RUNTIME_PROFILE.schema.json +143 -2
  9. package/assets/agent-state/MODULES/schemas/RUNTIME_EXECUTOR_SESSION_REGISTRY.schema.json +2 -2
  10. package/assets/agent-state/MODULES/schemas/SWARM_HANDOFF.schema.json +10 -0
  11. package/assets/eval-battery/battery.json +1 -1
  12. package/assets/instructions/ACE_Coder.instructions.md +9 -13
  13. package/assets/scripts/ace-hook-dispatch.mjs +16 -411
  14. package/assets/tasks/SWARM_HANDOFF.example_ui_to_coders.json +1 -2
  15. package/assets/vendor/README.md +9 -0
  16. package/assets/vendor/vericify-reader.mjs +272 -0
  17. package/assets/vendor/vericify-reader.provenance.json +10 -0
  18. package/dist/ace-autonomy.d.ts +58 -0
  19. package/dist/ace-autonomy.js +211 -6
  20. package/dist/ace-internal-tools.d.ts +1 -0
  21. package/dist/ace-internal-tools.js +3 -3
  22. package/dist/ace-server-instructions.d.ts +3 -3
  23. package/dist/ace-server-instructions.js +46 -192
  24. package/dist/cli.js +44 -6
  25. package/dist/experience-reflector.d.ts +7 -0
  26. package/dist/experience-reflector.js +39 -0
  27. package/dist/goal-engine.d.ts +64 -7
  28. package/dist/goal-engine.js +197 -41
  29. package/dist/handoff-registry.d.ts +10 -0
  30. package/dist/handoff-registry.js +59 -0
  31. package/dist/helpers/artifacts.d.ts +6 -2
  32. package/dist/helpers/artifacts.js +8 -6
  33. package/dist/helpers/bootstrap.js +13 -20
  34. package/dist/helpers/path-utils.js +2 -0
  35. package/dist/helpers/store-resolution.js +18 -3
  36. package/dist/helpers/workspace-root.d.ts +2 -0
  37. package/dist/helpers/workspace-root.js +9 -0
  38. package/dist/helpers.d.ts +1 -0
  39. package/dist/helpers.js +1 -0
  40. package/dist/hermes/bridge-protocol.d.ts +1 -1
  41. package/dist/hermes/session-manager.d.ts +17 -0
  42. package/dist/hermes/session-manager.js +67 -14
  43. package/dist/host-goal-engine.d.ts +138 -0
  44. package/dist/host-goal-engine.js +793 -0
  45. package/dist/host-goal-status.d.ts +113 -0
  46. package/dist/host-goal-status.js +175 -0
  47. package/dist/host-learning.d.ts +68 -0
  48. package/dist/host-learning.js +115 -0
  49. package/dist/host-observation.d.ts +12 -0
  50. package/dist/host-observation.js +91 -0
  51. package/dist/host-plan-revision.d.ts +14 -0
  52. package/dist/host-plan-revision.js +101 -0
  53. package/dist/host-verification-job.d.ts +12 -0
  54. package/dist/host-verification-job.js +183 -0
  55. package/dist/host-work-context.d.ts +12 -0
  56. package/dist/host-work-context.js +8 -0
  57. package/dist/job-scheduler.d.ts +58 -13
  58. package/dist/job-scheduler.js +298 -48
  59. package/dist/job-worker.d.ts +3 -1
  60. package/dist/job-worker.js +10 -3
  61. package/dist/kanban.d.ts +4 -1
  62. package/dist/kanban.js +44 -16
  63. package/dist/learned-artifacts.d.ts +64 -0
  64. package/dist/learned-artifacts.js +321 -0
  65. package/dist/learning-controls.d.ts +142 -0
  66. package/dist/learning-controls.js +135 -0
  67. package/dist/learning-input-context.d.ts +9 -0
  68. package/dist/learning-input-context.js +62 -0
  69. package/dist/learning-lifecycle.d.ts +10 -0
  70. package/dist/learning-lifecycle.js +11 -0
  71. package/dist/learning-overlays.d.ts +3 -0
  72. package/dist/learning-overlays.js +17 -0
  73. package/dist/learning-policy.d.ts +40 -0
  74. package/dist/learning-policy.js +38 -0
  75. package/dist/learning-records.d.ts +35 -0
  76. package/dist/learning-records.js +17 -0
  77. package/dist/learning-scorecard.d.ts +82 -0
  78. package/dist/learning-scorecard.js +86 -0
  79. package/dist/learning-serving.d.ts +29 -0
  80. package/dist/learning-serving.js +134 -0
  81. package/dist/linked-work.d.ts +9 -0
  82. package/dist/linked-work.js +28 -0
  83. package/dist/local-model-runtime.js +1 -1
  84. package/dist/mcp-command-progress.d.ts +16 -0
  85. package/dist/mcp-command-progress.js +70 -0
  86. package/dist/model-bridge.d.ts +14 -13
  87. package/dist/model-bridge.js +73 -41
  88. package/dist/orchestrator-supervisor.d.ts +111 -6
  89. package/dist/orchestrator-supervisor.js +67 -43
  90. package/dist/plan-proposal.js +3 -3
  91. package/dist/playbook-curator.d.ts +1 -0
  92. package/dist/playbook-curator.js +11 -9
  93. package/dist/process-identity.d.ts +8 -0
  94. package/dist/process-identity.js +38 -0
  95. package/dist/progress-command.d.ts +34 -0
  96. package/dist/progress-command.js +153 -0
  97. package/dist/prompts.js +15 -15
  98. package/dist/resources.js +2 -2
  99. package/dist/runtime-command.d.ts +8 -1
  100. package/dist/runtime-command.js +48 -7
  101. package/dist/runtime-executor.js +33 -11
  102. package/dist/runtime-profile-syntax.d.ts +6 -0
  103. package/dist/runtime-profile-syntax.js +121 -0
  104. package/dist/runtime-profile.d.ts +37 -5
  105. package/dist/runtime-profile.js +36 -129
  106. package/dist/runtime-tool-specs.js +1 -1
  107. package/dist/safe-edit.d.ts +7 -3
  108. package/dist/safe-edit.js +40 -47
  109. package/dist/schemas.js +4 -2
  110. package/dist/server.d.ts +2 -16
  111. package/dist/server.js +14 -20
  112. package/dist/shared.d.ts +2 -0
  113. package/dist/shared.js +2 -0
  114. package/dist/skill-auditor.d.ts +19 -0
  115. package/dist/skill-auditor.js +32 -2
  116. package/dist/skill-catalog.d.ts +4 -1
  117. package/dist/skill-catalog.js +6 -5
  118. package/dist/store/ace-packed-store.d.ts +5 -1
  119. package/dist/store/ace-packed-store.js +33 -1
  120. package/dist/store/bootstrap-store.js +19 -12
  121. package/dist/store/cache-workspace.d.ts +8 -0
  122. package/dist/store/cache-workspace.js +94 -27
  123. package/dist/store/importer.js +11 -20
  124. package/dist/store/knowledge-bake.d.ts +3 -1
  125. package/dist/store/knowledge-bake.js +10 -1
  126. package/dist/store/legacy-vericify-posts.d.ts +8 -0
  127. package/dist/store/legacy-vericify-posts.js +76 -0
  128. package/dist/store/materializers/hook-context-materializer.d.ts +2 -1
  129. package/dist/store/materializers/hook-context-materializer.js +6 -2
  130. package/dist/store/materializers/host-file-materializer.js +2 -2
  131. package/dist/store/materializers/projection-manager.d.ts +4 -1
  132. package/dist/store/materializers/projection-manager.js +10 -3
  133. package/dist/store/materializers/todo-syncer.d.ts +39 -20
  134. package/dist/store/materializers/todo-syncer.js +208 -110
  135. package/dist/store/materializers/vericify-projector.js +15 -26
  136. package/dist/store/repositories/goal-repository.d.ts +51 -2
  137. package/dist/store/repositories/goal-repository.js +114 -48
  138. package/dist/store/repositories/playbook-repository.d.ts +41 -3
  139. package/dist/store/repositories/playbook-repository.js +61 -5
  140. package/dist/store/repositories/todo-repository.d.ts +8 -2
  141. package/dist/store/repositories/todo-repository.js +1 -1
  142. package/dist/store/repositories/vericify-repository.d.ts +4 -0
  143. package/dist/store/repositories/vericify-repository.js +46 -0
  144. package/dist/store/skills-install.d.ts +1 -0
  145. package/dist/store/skills-install.js +20 -16
  146. package/dist/store/source-preservation.d.ts +24 -0
  147. package/dist/store/source-preservation.js +79 -0
  148. package/dist/store/store-artifacts.js +8 -1
  149. package/dist/store/test-write-boundary.d.ts +16 -0
  150. package/dist/store/test-write-boundary.js +175 -0
  151. package/dist/store/types.d.ts +5 -1
  152. package/dist/store/write-coordinator.js +16 -0
  153. package/dist/task-plan-context.d.ts +11 -0
  154. package/dist/task-plan-context.js +59 -0
  155. package/dist/todo-state.d.ts +19 -9
  156. package/dist/todo-state.js +204 -321
  157. package/dist/tools-agent.d.ts +1 -1
  158. package/dist/tools-agent.js +38 -62
  159. package/dist/tools-files.d.ts +0 -3
  160. package/dist/tools-files.js +21 -11
  161. package/dist/tools-framework.js +16 -25
  162. package/dist/tools-goal.d.ts +2 -4
  163. package/dist/tools-goal.js +119 -16
  164. package/dist/tools-handoff.d.ts +3 -2
  165. package/dist/tools-handoff.js +53 -23
  166. package/dist/tools-lifecycle.js +1 -1
  167. package/dist/tools-memory.d.ts +0 -3
  168. package/dist/tools-memory.js +51 -6
  169. package/dist/tools-scheduler.js +20 -17
  170. package/dist/tools-todo.js +160 -148
  171. package/dist/vericify-bridge.d.ts +8 -0
  172. package/dist/vericify-bridge.js +18 -0
  173. package/dist/vericify-context.d.ts +4 -0
  174. package/dist/vericify-context.js +26 -5
  175. package/dist/vericify-native.d.ts +101 -0
  176. package/dist/vericify-native.js +221 -0
  177. package/dist/verification-worker.d.ts +2 -0
  178. package/dist/verification-worker.js +31 -0
  179. package/docs/mcp-tool-reference.md +50 -10
  180. package/docs/troubleshooting.md +29 -0
  181. package/package.json +19 -6
  182. package/scripts/dev/run-tests-isolated.mjs +165 -0
  183. package/scripts/dev/run_hermes_crispr_live.mjs +1 -0
  184. package/scripts/dev/test-isolation-guard.mjs +20 -0
  185. package/scripts/dev/test-preload.mjs +153 -0
  186. package/scripts/dev/test-source-inventory.mjs +31 -0
  187. package/docs/development.md +0 -46
@@ -130,11 +130,19 @@
130
130
  },
131
131
  "max_turns": {
132
132
  "type": "integer",
133
- "minimum": 1
133
+ "minimum": 0
134
134
  },
135
135
  "turn_timeout_ms": {
136
136
  "type": "integer",
137
- "minimum": 1
137
+ "minimum": 0
138
+ },
139
+ "stall_warning_ms": {
140
+ "type": "integer",
141
+ "minimum": 0
142
+ },
143
+ "stall_window_ms": {
144
+ "type": "integer",
145
+ "minimum": 0
138
146
  }
139
147
  }
140
148
  },
@@ -301,10 +309,143 @@
301
309
  "process_post_path": {
302
310
  "type": "string",
303
311
  "minLength": 1
312
+ },
313
+ "legacy_auto_posts": {
314
+ "type": "boolean",
315
+ "default": false
316
+ },
317
+ "api_path": {
318
+ "type": "string",
319
+ "minLength": 1
320
+ },
321
+ "native": {
322
+ "type": "object",
323
+ "additionalProperties": false,
324
+ "properties": {
325
+ "enabled": {
326
+ "type": "boolean",
327
+ "default": false
328
+ },
329
+ "executable": {
330
+ "type": "string",
331
+ "minLength": 1
332
+ },
333
+ "data_dir": {
334
+ "type": "string",
335
+ "minLength": 1
336
+ },
337
+ "workspace_root": {
338
+ "type": "string",
339
+ "minLength": 1
340
+ },
341
+ "workspace_id": {
342
+ "type": "string",
343
+ "minLength": 1
344
+ },
345
+ "incarnation": {
346
+ "type": "string",
347
+ "minLength": 1
348
+ },
349
+ "query_timeout_ms": {
350
+ "type": "integer",
351
+ "minimum": 1000,
352
+ "maximum": 60000,
353
+ "default": 15000
354
+ },
355
+ "max_pages": {
356
+ "type": "integer",
357
+ "minimum": 1,
358
+ "maximum": 64,
359
+ "default": 8
360
+ },
361
+ "max_bytes": {
362
+ "type": "integer",
363
+ "minimum": 4096,
364
+ "maximum": 1048576,
365
+ "default": 262144
366
+ },
367
+ "retries": {
368
+ "type": "integer",
369
+ "minimum": 0,
370
+ "maximum": 3,
371
+ "default": 1
372
+ },
373
+ "acceptance_wait_ms": {
374
+ "type": "integer",
375
+ "minimum": 0,
376
+ "maximum": 120000,
377
+ "default": 15000
378
+ }
379
+ }
304
380
  }
305
381
  }
306
382
  }
307
383
  }
384
+ },
385
+ "learning": {
386
+ "type": "object",
387
+ "additionalProperties": false,
388
+ "properties": {
389
+ "enabled": {
390
+ "type": "boolean",
391
+ "default": true
392
+ },
393
+ "distill_min_items": {
394
+ "type": "integer",
395
+ "default": 3,
396
+ "minimum": 1
397
+ },
398
+ "distill_min_goals": {
399
+ "type": "integer",
400
+ "default": 2,
401
+ "minimum": 2
402
+ },
403
+ "max_open_learning_steps": {
404
+ "type": "integer",
405
+ "default": 1,
406
+ "const": 1,
407
+ "minimum": 1
408
+ },
409
+ "distill_cooldown_days": {
410
+ "type": "number",
411
+ "default": 7,
412
+ "minimum": 1
413
+ },
414
+ "max_learned_skills": {
415
+ "type": "integer",
416
+ "default": 30,
417
+ "maximum": 30,
418
+ "minimum": 1
419
+ },
420
+ "serve_max_lessons": {
421
+ "type": "integer",
422
+ "default": 3,
423
+ "maximum": 3,
424
+ "minimum": 0
425
+ },
426
+ "serve_max_skills": {
427
+ "type": "integer",
428
+ "default": 2,
429
+ "maximum": 2,
430
+ "minimum": 0
431
+ },
432
+ "serve_max_tokens": {
433
+ "type": "integer",
434
+ "default": 600,
435
+ "maximum": 600,
436
+ "minimum": 1
437
+ },
438
+ "retire_unhelpful_after_serves": {
439
+ "type": "integer",
440
+ "default": 40,
441
+ "minimum": 1
442
+ },
443
+ "instructions_require_approval": {
444
+ "type": "boolean",
445
+ "default": true,
446
+ "const": true
447
+ }
448
+ }
308
449
  }
309
450
  }
310
451
  }
@@ -274,11 +274,11 @@
274
274
  },
275
275
  "max_turns": {
276
276
  "type": "integer",
277
- "minimum": 1
277
+ "minimum": 0
278
278
  },
279
279
  "turn_timeout_ms": {
280
280
  "type": "integer",
281
- "minimum": 1
281
+ "minimum": 0
282
282
  },
283
283
  "turn_count": {
284
284
  "type": "integer",
@@ -15,6 +15,16 @@
15
15
  ],
16
16
  "additionalProperties": false,
17
17
  "properties": {
18
+ "step_ref": {
19
+ "type": "object",
20
+ "required": ["goal_id", "step_id"],
21
+ "additionalProperties": false,
22
+ "properties": {
23
+ "goal_id": {"type": "string", "minLength": 1},
24
+ "step_id": {"type": "string", "minLength": 1}
25
+ }
26
+ },
27
+ "recipient_agent": {"type": "string", "minLength": 1},
18
28
  "handoff_id": {
19
29
  "type": "string",
20
30
  "minLength": 1
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "schema": "ace-eval-battery@1",
3
3
  "seed": 7,
4
- "description": "Fixed behavioral task battery for WS-I. Every invocation receives a fresh copy of fixtures/. Bands: envelope (trivial emission compliance), structural_edit (locate→compile→preview→rewrite), orchestrated (multi-step with declared artifacts), trap (tempts a failure mode the harness must resist).",
4
+ "description": "Fixed behavioral task battery. Every invocation receives a fresh copy of fixtures/. Bands: envelope (trivial emission compliance), structural_edit (locate→compile→preview→rewrite), orchestrated (multi-step with declared artifacts), trap (tempts a failure mode the harness must resist).",
5
5
  "tasks": [
6
6
  {
7
7
  "id": "env-1-plain",
@@ -32,15 +32,15 @@ applyTo: 'ACE_coders'
32
32
 
33
33
  **OUTPUT:** You produce Passing Tests and Deployable Artifacts.
34
34
 
35
- **NO GUESSING:** If a requirement is missing, you DO NOT assume. You throw a BLOCKER_EVENT to the Orchestrator.
35
+ **UNCERTAINTY:** Resolve routine choices from the existing contract and code. If a required decision is missing, explain what is needed and continue independent work.
36
36
 
37
37
  ### 0.2 Directive: TDD ABSOLUTISM
38
38
 
39
39
  **COMMAND:** Red. Green. Refactor.
40
40
 
41
- **TEST FIRST:** You are forbidden from writing implementation code until a failing test exists in ./engineering-state/tests/.
41
+ **TEST FIRST:** For behavior changes, reproduce the failure in the project’s existing test suite before implementing the repair.
42
42
 
43
- **COVERAGE:** 100% coverage on critical paths. No "happy path" coding only.
43
+ **COVERAGE:** Verify the affected behavior, including meaningful failure and recovery cases. Run the checks the work contract declares.
44
44
 
45
45
  ### 0.3 Directive: ARTIFACT PURITY
46
46
 
@@ -48,7 +48,7 @@ applyTo: 'ACE_coders'
48
48
 
49
49
  **CLEAN:** No commented-out code. No console.log in production.
50
50
 
51
- **DOCUMENTED:** Every function has a docstring. README.md is updated on every commit.
51
+ **DOCUMENTED:** Explain non-obvious decisions in the code. Update user documentation when behavior or usage changes.
52
52
 
53
53
  ### 0.4 Directive: THE CLARITY PROTOCOL (The Engineer's Mind)
54
54
 
@@ -82,9 +82,7 @@ applyTo: 'ACE_coders'
82
82
 
83
83
  **PERSIST:** Update ./src/ and ./tests/.
84
84
 
85
- **LOG:** Update TEST_LOG.md with the latest run results.
86
-
87
- **STATUS:** Update BUILD_STATUS.md (PASS/FAIL).
85
+ **EVIDENCE:** Return the checks run and their actual results with the outcome. Existing test artifacts and ACE tool results are evidence; do not maintain a separate per-action log.
88
86
 
89
87
  #### $$VERIFICATION$$
90
88
 
@@ -97,10 +95,8 @@ applyTo: 'ACE_coders'
97
95
  You own the ./engineering-state/ directory and the source code.
98
96
 
99
97
  ./engineering-state/
100
- ├── BUILD_STATUS.md # Current sprint status (Pass/Fail)
101
98
  ├── SPEC_CONTRACT.json # The ingested requirements from Orchestrator
102
99
  ├── ARCHITECTURE.md # Technical decisions (Stack, DB, API)
103
- ├── TEST_LOG.md # Results of the latest test run
104
100
  └── src/ # The application source code
105
101
 
106
102
  ## 2. The Coder Roles (Sub-Agents)
@@ -125,7 +121,7 @@ You own the ./engineering-state/ directory and the source code.
125
121
 
126
122
  **Goal:** Break the code.
127
123
 
128
- **Action:** Runs regression suites. Edge case fuzzing. Security scanning. Updates TEST_LOG.md.
124
+ **Action:** Runs regression suites. Edge case fuzzing. Security scanning. Returns verification results.
129
125
 
130
126
  **Trigger:** Code Committed.
131
127
 
@@ -139,7 +135,7 @@ You own the ./engineering-state/ directory and the source code.
139
135
 
140
136
  ## 3. Operational Rhythm (The Loop)
141
137
 
142
- **Ingest:** Receive SWARM_HANDOFF.json from ACE-Orchestrator.
138
+ **Ingest:** Receive the task directly or through the existing ACE handoff.
143
139
 
144
140
  **Spec:** agent-architect converts the handoff into technical tasks in SPEC_CONTRACT.json.
145
141
 
@@ -147,9 +143,9 @@ You own the ./engineering-state/ directory and the source code.
147
143
 
148
144
  **Verify:** agent-test runs the full suite.
149
145
 
150
- **Commit:** Update BUILD_STATUS.md.
146
+ **Commit:** Commit the reviewed implementation and appropriate tests when authorized.
151
147
 
152
- **Return:** Send SWARM_HANDOFF.json back to ACE-Orchestrator with "Mission Accomplished" or "Blocker".
148
+ **Return:** Submit the work outcome through the existing assignment or handoff. Include what changed, actual checks, and any unresolved dependency.
153
149
 
154
150
  ## 4. Activation (Passive)
155
151