@voybio/ace-swarm 2.4.6 → 2.4.7

package/dist/ace-server-instructions.js

@@ -207,10 +207,11 @@ export function buildServerInstructions(workspaceRoot) {
     const lines = [
         "You are operating in an ACE-governed workspace.",
         coreFiles.length > 0
-            ? `Ground truth lives in ${coreFiles.join(", ")}.`
-            : `Ground truth lives in ${ACE_ROOT_REL}/agent-state/* artifacts, not chat history.`,
+            ? `Ground truth for task/status/scope/evidence is store-backed under ${coreFiles.join(", ")} (canonical store: ${ACE_ROOT_REL}/agent-state/ace-state.ace).`
+            : `Ground truth is store-backed under ${ACE_ROOT_REL}/agent-state/* artifacts (canonical store: ${ACE_ROOT_REL}/agent-state/ace-state.ace), not chat history.`,
+        "`ace compact` and the automatic lifecycle sweep intentionally remove the loose agent-state/*.md files from disk after folding them into the store — this is expected, not data loss. Read them back with `ace read agent-state/TASK.md` (or the read_workspace_file / recall_context MCP tools); never recreate swept files.",
         stateDirs.length > 0
-            ? `Durable artifacts belong under ${stateDirs.map((entry) => `${entry}/`).join(", ")}.`
+            ? `Durable artifacts belong under ${stateDirs.map((entry) => `${entry}/`).join(", ")} and are persisted into the store; the loose copies are sweep inputs, not the source of truth.`
             : undefined,
         "Before significant work, call recall_context to load current task, scope, and status.",
         "Use route_task and get_agent_instructions for role guidance; do not self-assign by guesswork.",
@@ -243,6 +244,7 @@ export function buildHostInstructionText(host, workspaceRoot) {
         "Ground truth:",
         "- ACE MCP tools are the authoritative interface for task state and lifecycle updates.",
         "- `agent-state/ace-state.ace` is the canonical store path; visible `agent-state/*` files are compatibility projections or sweep inputs.",
+        "- `ace compact` and the automatic lifecycle sweep intentionally remove loose `agent-state/*` files from disk after folding them into the store — this is expected, not data loss. Do NOT recreate them; retrieve their content via `ace read <path>` or the `read_workspace_file` / `recall_context` MCP tools.",
         "- `.agents/ACE/tasks/todo.md` is the human-facing todo surface.",
         "- Hook context is store-backed in `agent-state/ace-state.ace` and consumed without extra workspace projections.",
         "",

package/dist/cli.js

@@ -1696,7 +1696,10 @@ async function main() {
         const savedKb = Math.round((result.before - result.after) / 1024);
         console.log(`Store compacted: ${result.before} → ${result.after} bytes (saved ${savedKb}KB)`);
         if (result.sweep) {
-            console.log(`Sweep: cached ${result.sweep.cached_files}, removed ${result.sweep.removed_files}, semantic GC removed ${result.sweep.removed_semantic_cache_files}`);
+            console.log(`Sweep: folded ${result.sweep.cached_files} artifact(s) into the store, freed ${result.sweep.removed_files} loose file(s) from disk, semantic GC removed ${result.sweep.removed_semantic_cache_files}`);
+            if (result.sweep.removed_files > 0) {
+                console.log("  Swept files are stored, not lost — read them back with `ace read <path>` (e.g. `ace read agent-state/TASK.md`). Do not recreate them.");
+            }
         }
         return;
     }
@@ -1739,7 +1742,7 @@ async function main() {
         console.log(`Cached files: ${result.cached_files}`);
         console.log(`Kept projected files: ${result.kept_projected_files}`);
         console.log(`Skipped files: ${result.skipped_files}`);
-        console.log(`Removed files: ${result.removed_files}`);
+        console.log(`Removed files: ${result.removed_files} (folded into the store, not lost — read back with \`ace read <path>\`; do not recreate)`);
         console.log(`Semantic cache GC removed files: ${result.removed_semantic_cache_files}`);
         console.log(`Staging GC removed entries: ${stagingGc.removed_entries}`);
         if (result.warnings.length > 0) {

package/docs/cli-reference.md

@@ -73,6 +73,8 @@ ACE_HERMES_ROOT=/path/to/hermes-agent HERMES_PYTHON=/path/to/python \
   ace tui --provider llama.cpp --base-url http://localhost:8080 --model gemma-3-4b-it --hermes
 
 # Compact the store and sweep loose generated artifacts
+# (the sweep removes loose agent-state/*.md from disk on purpose after storing
+#  them — not data loss; read them back with `ace read <path>`, don't recreate)
 ace compact
 ace compact --no-sweep
 

package/docs/state-model.md

@@ -88,7 +88,7 @@ ace compact --no-sweep  # store rewrite only
 ace compact             # store rewrite plus loose generated-artifact sweep
 ```
 
-The default command runs a sweep after compaction: eligible loose generated ACE artifacts are ingested into the store and removed from disk. Use `--no-sweep` when only the container rewrite is intended. Back up the store and active goal directory before maintenance on a critical workspace.
+The default command runs a sweep after compaction: eligible loose generated ACE artifacts are ingested into the store and removed from disk. This removal is by design and is not data loss — the content lives in the store and is read back with `ace read <path>` (e.g. `ace read agent-state/TASK.md`) or the `read_workspace_file` / `recall_context` MCP tools. Agents should not recreate swept files. The same sweep also runs automatically on a lifecycle cadence (silently, with a short min-age guard), so loose `agent-state/*` files disappearing between sessions is expected. Use `--no-sweep` when only the container rewrite is intended. Back up the store and active goal directory before maintenance on a critical workspace.
 
 ### Repair
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voybio/ace-swarm",
-  "version": "2.4.6",
+  "version": "2.4.7",
   "description": "ACE Framework MCP server and CLI — single-file ACEPACK state, local-model serving, agent orchestration, and host compliance enforcement.",
   "type": "module",
   "main": "dist/index.js",