@voybio/ace-swarm 2.4.3 → 2.4.4

package/dist/tools-framework.js

@@ -18,6 +18,7 @@ import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { resolve } from "node:path";
 import { auditPublicSurface } from "./public-surface.js";
 import { auditStoreAuthority, writeStoreAuthorityAuditReport, } from "./store/store-authority-audit.js";
+import { parseGateManifest, resolveGateSelection, } from "./gate-contract.js";
 import { PROVENANCE_CRITICAL_EVENT_TYPES, validateArtifactManifestPayload, validateProvenanceLogContent, validateTealConfigContent, } from "./schemas.js";
 import { readAceTaskContractAssessment } from "./ace-autonomy.js";
 import { listStoreKeysSync, readStoreBlobSync } from "./store/store-snapshot.js";
@@ -54,28 +55,6 @@ function getArtifactManifestEntries(payload) {
     }
     return [];
 }
-function parseGateManifest(raw, sourceRef) {
-    try {
-        const gate = JSON.parse(raw);
-        const id = typeof gate.id === "string" ? gate.id.trim() : "";
-        if (!id)
-            return undefined;
-        const type = gate.type === "executable" || gate.type === "artifact_scan" || gate.type === "manual_review"
-            ? gate.type
-            : "manual_review";
-        return {
-            id,
-            type,
-            invariant: typeof gate.invariant === "string" ? gate.invariant : "",
-            command: typeof gate.command === "string" ? gate.command : "",
-            evidence_requirement: typeof gate.evidence_requirement === "string" ? gate.evidence_requirement : "",
-            source_ref: sourceRef,
-        };
-    }
-    catch {
-        return undefined;
-    }
-}
 function parseJsonForValidation(raw) {
     return parseJsonLikeText(raw);
 }
@@ -130,10 +109,14 @@ function hasArtifactEvidence(reference) {
     const normalized = reference.trim();
     if (!normalized)
         return false;
-    const candidates = [wsPath("agent-state", normalized), wsPath(normalized)];
-    if (candidates.some((candidate) => existsSync(candidate)))
+    const relativeCandidates = [
+        normalized,
+        normalized.startsWith("agent-state/") ? normalized : `agent-state/${normalized}`,
+    ];
+    const absoluteCandidates = relativeCandidates.map((candidate) => wsPath(candidate));
+    if (absoluteCandidates.some((candidate) => existsSync(candidate)))
         return true;
-    return candidates.some((candidate) => {
+    return relativeCandidates.some((candidate) => {
         const content = safeRead(candidate);
         return !content.startsWith("[FILE NOT FOUND]") && !content.startsWith("[ACCESS DENIED]");
     });
@@ -1436,7 +1419,7 @@ export function registerFrameworkTools(server) {
         gate_ids: z
             .array(z.string())
             .optional()
-            .describe("Specific gate IDs to run (e.g. ['gate-correctness']). Omit to run all registered gates."),
+            .describe("Specific gate IDs to run (e.g. ['gate-correctness']). Omit to run the active stage's stage-activated workspace gates."),
         review_mode: z
             .enum(["skeptic_adversarial"])
             .optional()
@@ -1449,25 +1432,102 @@ export function registerFrameworkTools(server) {
         const gatesDir = wsPath("agent-state", "MODULES", "gates");
         const resolved = resolveGateManifests(gatesDir);
         const allGates = resolved.gates;
-        const gateEvidenceRef = resolved.source === "store" ? "knowledge/gates/*" : "agent-state/MODULES/gates/";
-        // Filter to requested gates (or run all)
-        const targets = gate_ids
-            ? allGates.filter((g) => gate_ids.includes(g.id))
-            : allGates;
+        const manifestEvidenceRef = resolved.source === "store" ? "knowledge/gates/*" : "agent-state/MODULES/gates/";
+        const selection = resolveGateSelection({
+            gates: allGates,
+            manifestSource: resolved.source,
+            statusRaw: safeRead("agent-state/STATUS.md"),
+            tealRaw: safeRead("agent-state/TEAL_CONFIG.md"),
+            gateIds: gate_ids,
+        });
+        const targets = selection.selected;
         if (targets.length === 0) {
-            const noGateMessage = allGates.length === 0
-                ? "❌ No gate manifests found in agent-state/MODULES/gates/ or ace-state.ace knowledge/gates/*."
-                : `❌ No matching gates found. Available: ${allGates.map((g) => g.id).join(", ")}`;
+            if (allGates.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "❌ No gate manifests found in agent-state/MODULES/gates/ or ace-state.ace knowledge/gates/*.",
+                        },
+                    ],
+                };
+            }
+            if (selection.selection_mode === "explicit") {
+                const noGateMessage = selection.missing_explicit_gate_ids.length > 0
+                    ? `❌ No matching gates found for: ${selection.missing_explicit_gate_ids.join(", ")}. Available: ${allGates.map((g) => g.id).join(", ")}`
+                    : `❌ No matching gates found. Available: ${allGates.map((g) => g.id).join(", ")}`;
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: noGateMessage,
+                        },
+                    ],
+                };
+            }
+            const message = selection.note ??
+                "No stage-activated workspace gates were selected for the active ACE stage. Use explicit gate_ids when needed.";
+            await appendStatusEventSafe({
+                source_module: "capability-framework",
+                event_type: "GATES_EXECUTED",
+                status: "pass",
+                summary: message,
+                payload: {
+                    gates_run: [],
+                    gate_results: [],
+                    passed: 0,
+                    failed: 0,
+                    selection_mode: selection.selection_mode,
+                    selected_gate_ids: [],
+                    skipped_gate_ids: selection.skipped_gate_ids,
+                    gate_manifest_source: resolved.source,
+                    active_role: selection.active_role ?? null,
+                    active_module: selection.active_module ?? null,
+                    active_pipeline: selection.active_pipeline ?? null,
+                    selection_note: message,
+                    evidence_ref: manifestEvidenceRef,
+                },
+                objective_id: "gate-execution",
+            });
+            const ledger = await appendRunLedgerEntrySafe({
+                tool: "execute_gates",
+                category: "info",
+                message,
+                artifacts: [],
+                metadata: {
+                    passed: 0,
+                    failed: 0,
+                    selection_mode: selection.selection_mode,
+                    selected_gate_ids: [],
+                    skipped_gate_ids: selection.skipped_gate_ids,
+                    gate_manifest_source: resolved.source,
+                    active_role: selection.active_role ?? null,
+                    active_module: selection.active_module ?? null,
+                    active_pipeline: selection.active_pipeline ?? null,
+                    selection_note: message,
+                },
+            });
             return {
                 content: [
                     {
                         type: "text",
-                        text: noGateMessage,
+                        text: [
+                            `ℹ️ ${message}`,
+                            `Selection mode: ${selection.selection_mode}`,
+                            `Active role/module: ${selection.active_role ?? "(unknown)"} / ${selection.active_module ?? "(unknown)"}`,
+                            `Active pipeline: ${selection.active_pipeline ?? "(unknown)"}`,
+                            `Selected gates: none`,
+                            `Skipped gates: ${selection.skipped_gate_ids.length > 0 ? selection.skipped_gate_ids.join(", ") : "none"}`,
+                            `Gate manifest source: ${resolved.source === "store"
+                                ? "ace-state.ace (knowledge/gates/*)"
+                                : "agent-state/MODULES/gates/"}`,
+                            `Run ledger: ${ledger.path} (${ledger.entry.id})`,
+                        ].join("\n"),
                     },
                 ],
             };
         }
-        const gateArtifactRefs = targets.map((gate) => gate.source_ref ?? gateEvidenceRef);
+        const gateArtifactRefs = targets.map((gate) => gate.source_ref ?? manifestEvidenceRef);
         const results = evaluateGateTargets(targets);
         const passed = results.filter((r) => r.ok).length;
         const failed = results.filter((r) => !r.ok).length;
@@ -1495,7 +1555,13 @@ export function registerFrameworkTools(server) {
                 })),
                 passed,
                 failed,
-                evidence_ref: evidence?.evidenceRef ?? gateEvidenceRef,
+                evidence_ref: evidence?.evidenceRef ?? manifestEvidenceRef,
+                selection_mode: selection.selection_mode,
+                active_role: selection.active_role ?? null,
+                active_module: selection.active_module ?? null,
+                active_pipeline: selection.active_pipeline ?? null,
+                selected_gate_ids: results.map((r) => r.id),
+                skipped_gate_ids: selection.skipped_gate_ids,
                 gate_manifest_source: resolved.source,
                 ...(review
                     ? {
@@ -1530,6 +1596,13 @@ export function registerFrameworkTools(server) {
                 passed,
                 failed,
                 gate_ids: results.map((r) => r.id),
+                selection_mode: selection.selection_mode,
+                active_role: selection.active_role ?? null,
+                active_module: selection.active_module ?? null,
+                active_pipeline: selection.active_pipeline ?? null,
+                selected_gate_ids: results.map((r) => r.id),
+                skipped_gate_ids: selection.skipped_gate_ids,
+                missing_explicit_gate_ids: selection.missing_explicit_gate_ids,
                 gate_manifest_source: resolved.source,
                 ...(review
                     ? {
@@ -1559,6 +1632,11 @@ export function registerFrameworkTools(server) {
                         `Gate manifest source: ${resolved.source === "store"
                             ? "ace-state.ace (knowledge/gates/*)"
                             : "agent-state/MODULES/gates/"}`,
+                        `Selection mode: ${selection.selection_mode}`,
+                        `Active role/module: ${selection.active_role ?? "(unknown)"} / ${selection.active_module ?? "(unknown)"}`,
+                        `Active pipeline: ${selection.active_pipeline ?? "(unknown)"}`,
+                        `Selected gates: ${results.map((r) => r.id).join(", ")}`,
+                        `Skipped gates: ${selection.skipped_gate_ids.length > 0 ? selection.skipped_gate_ids.join(", ") : "none"}`,
                         `Run ledger: ${ledger.path} (${ledger.entry.id})`,
                         ...(evidence ? [`Evidence: ${evidence.path} (${evidence.evidenceRef})`] : []),
                         "",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voybio/ace-swarm",
-  "version": "2.4.3",
+  "version": "2.4.4",
   "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",
@@ -37,6 +37,7 @@
   "scripts": {
     "build": "tsc",
     "test": "npm run build && node --test 'test/*.test.mjs' 'test/**/*.test.mjs'",
+    "test:real-astgrep": "npm run build && ACE_TEST_REAL_ASTGREP=1 node --test test/astgrep-real-cli.test.mjs",
     "start": "node dist/cli.js mcp",
     "dev": "tsc && node dist/cli.js mcp",
     "init": "node dist/cli.js init",
@@ -70,6 +71,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.26.0",
     "typescript": "^5.9.3",
+    "yaml": "^2.9.0",
     "zod": "^4.3.6"
   },
   "devDependencies": {

package/assets/agent-state/MODULES/gates/gate-correctness.json

@@ -1,7 +0,0 @@
-{
-  "id": "gate-correctness",
-  "type": "executable",
-  "invariant": "All required tests pass",
-  "command": "if [ -f ace-mcp-server/package.json ]; then cd ace-mcp-server && npm test --silent; elif [ -f package.json ]; then npm test --silent; else echo 'package.json not found for gate-correctness' && exit 1; fi",
-  "evidence_requirement": "Command output snippet with exit code 0"
-}

package/assets/agent-state/MODULES/gates/gate-evaluation.json

@@ -1,7 +0,0 @@
-{
-  "id": "gate-evaluation",
-  "type": "executable",
-  "invariant": "Core autonomy benchmark suites meet defined pass thresholds",
-  "command": "bash scripts/ace/eval-harness.sh",
-  "evidence_requirement": "EVAL_REPORT.md + command output"
-}

package/assets/agent-state/MODULES/gates/gate-typescript-public-surface.json

@@ -1,7 +0,0 @@
-{
-  "id": "gate-typescript-public-surface",
-  "type": "executable",
-  "invariant": "Exported MCP tools, resources, prompts, and public status events stay registered, described, schema-backed where required, and covered by the audit gate",
-  "command": "node --input-type=module -e \"import('./dist/public-surface.js').then(async (m) => { const result = await m.auditPublicSurface({ write_artifact: false }); if (!result.ok) { console.error(result.failures.join('\\n')); process.exit(1); } console.log(JSON.stringify(result.summary)); })\"",
-  "evidence_requirement": "PUBLIC_SURFACE_REPORT.md + passing public-surface audit"
-}