ace-swarm 2.0.5 → 2.0.7

package/assets/scripts/copilot-hook-dispatch.mjs

@@ -0,0 +1,267 @@
+#!/usr/bin/env node
+
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+
+const DESTRUCTIVE_COMMAND_PATTERNS = [
+  /\brm\s+-rf\b/i,
+  /\bgit\s+reset\s+--hard\b/i,
+  /\bgit\s+checkout\s+--\b/i,
+  /\bgit\s+clean\s+-fdx\b/i,
+  /\bdel\s+\/s\s+\/q\b/i,
+  /\bdrop\s+table\b/i,
+  /\btruncate\s+table\b/i,
+  /\bmkfs\b/i,
+];
+
+const PROTECTED_PATH_FRAGMENTS = [
+  ".github/hooks/",
+  ".github\\hooks\\",
+  "scripts/ace/copilot-hook-dispatch.mjs",
+  "scripts\\ace\\copilot-hook-dispatch.mjs",
+  ".vscode/settings.json",
+  ".vscode\\settings.json",
+];
+
+function readStdin() {
+  return new Promise((resolveStdin, reject) => {
+    let input = "";
+    process.stdin.setEncoding("utf8");
+    process.stdin.on("data", (chunk) => {
+      input += chunk;
+    });
+    process.stdin.on("end", () => resolveStdin(input));
+    process.stdin.on("error", reject);
+  });
+}
+
+function writeJson(payload) {
+  process.stdout.write(JSON.stringify(payload));
+}
+
+function toLowerText(value) {
+  return typeof value === "string" ? value.trim().toLowerCase() : "";
+}
+
+function safeJson(value) {
+  try {
+    return JSON.stringify(value ?? {});
+  } catch {
+    return "";
+  }
+}
+
+function resolveWorkspaceRoot(payload) {
+  const cwd = typeof payload.cwd === "string" && payload.cwd.trim() ? payload.cwd.trim() : process.cwd();
+  return resolve(cwd);
+}
+
+function aceContext(workspaceRoot) {
+  const stateDirs = [
+    "agent-state",
+    "global-state",
+    "venture-state",
+    "brand-state",
+    "engineering-state",
+  ].filter((relPath) => existsSync(resolve(workspaceRoot, relPath)));
+  const coreFiles = [
+    "agent-state/TASK.md",
+    "agent-state/STATUS.md",
+    "agent-state/SCOPE.md",
+    "agent-state/EVIDENCE_LOG.md",
+  ].filter((relPath) => existsSync(resolve(workspaceRoot, relPath)));
+
+  const hasSkills = existsSync(resolve(workspaceRoot, ".agents", "skills"));
+  const hasAgentState = existsSync(resolve(workspaceRoot, "agent-state"));
+
+  return {
+    coreFiles,
+    stateDirs,
+    hasSkills,
+    hasAgentState,
+  };
+}
+
+function buildAceMessage(workspaceRoot) {
+  const context = aceContext(workspaceRoot);
+  if (!context.hasAgentState && !context.hasSkills) return "";
+
+  const parts = [];
+  if (context.coreFiles.length > 0) {
+    parts.push(`ACE workspace detected. Ground truth lives in ${context.coreFiles.join(", ")}.`);
+  } else if (context.hasAgentState) {
+    parts.push("ACE workspace detected. Ground truth lives in agent-state/*.");
+  }
+  if (context.stateDirs.length > 0) {
+    parts.push(
+      `Persist durable artifacts under ${context.stateDirs.map((dir) => `${dir}/`).join(", ")} rather than editor session caches such as workspaceStorage/.../chat-session-resources/.`
+    );
+  }
+  parts.push(
+    "Before major edits, read task, scope, and status artifacts rather than relying on chat history."
+  );
+  if (context.hasSkills) {
+    parts.push("Workspace skills are available under .agents/skills/.");
+  }
+  parts.push(
+    "Copilot hook policy protects .github/hooks, .vscode/settings.json, and scripts/ace/copilot-hook-dispatch.mjs from silent self-modification."
+  );
+  return parts.join(" ");
+}
+
+function isCommandTool(toolName) {
+  return ["terminal", "shell", "bash", "command", "execute"].some((token) =>
+    toolName.includes(token)
+  );
+}
+
+function isMutationTool(toolName) {
+  return [
+    "edit",
+    "write",
+    "create",
+    "replace",
+    "delete",
+    "rename",
+    "move",
+    "file",
+  ].some((token) => toolName.includes(token));
+}
+
+function containsProtectedPath(text) {
+  const normalized = toLowerText(text);
+  return PROTECTED_PATH_FRAGMENTS.some((fragment) => normalized.includes(fragment.toLowerCase()));
+}
+
+function containsDestructiveCommand(text) {
+  return DESTRUCTIVE_COMMAND_PATTERNS.some((pattern) => pattern.test(text));
+}
+
+function resolvePreToolUse(payload, workspaceRoot) {
+  const toolName = toLowerText(payload.tool_name);
+  const serializedInput = safeJson(payload.tool_input);
+
+  if (isCommandTool(toolName) && containsDestructiveCommand(serializedInput)) {
+    return {
+      continue: true,
+      hookSpecificOutput: {
+        hookEventName: "PreToolUse",
+        permissionDecision: "deny",
+        permissionDecisionReason:
+          "Blocked by ACE Copilot hook policy: destructive shell command detected.",
+        additionalContext:
+          "Use a non-destructive alternative or ask for explicit confirmation before destructive terminal actions.",
+      },
+    };
+  }
+
+  if (isMutationTool(toolName) && containsProtectedPath(serializedInput)) {
+    return {
+      continue: true,
+      hookSpecificOutput: {
+        hookEventName: "PreToolUse",
+        permissionDecision: "ask",
+        permissionDecisionReason:
+          "Editing Copilot hook/config files requires confirmation.",
+        additionalContext:
+          "This workspace treats hook files and VS Code settings as protected control-plane artifacts.",
+      },
+    };
+  }
+
+  const message = buildAceMessage(workspaceRoot);
+  if (isMutationTool(toolName) && message) {
+    return {
+      continue: true,
+      hookSpecificOutput: {
+        hookEventName: "PreToolUse",
+        permissionDecision: "allow",
+        additionalContext: `${message} After mutating files, reconcile evidence and verification where relevant.`,
+      },
+    };
+  }
+
+  return { continue: true };
+}
+
+function resolvePostToolUse(payload, workspaceRoot) {
+  const toolName = toLowerText(payload.tool_name);
+  if (!isMutationTool(toolName)) {
+    return { continue: true };
+  }
+
+  const message = buildAceMessage(workspaceRoot);
+  return {
+    continue: true,
+    hookSpecificOutput: {
+      hookEventName: "PostToolUse",
+      additionalContext: message
+        ? `${message} If project files changed, run the smallest relevant verification before concluding.`
+        : "If project files changed, run the smallest relevant verification before concluding.",
+    },
+  };
+}
+
+function resolveSessionStart(payload, workspaceRoot, eventName) {
+  const message = buildAceMessage(workspaceRoot);
+  if (!message) return { continue: true };
+
+  return {
+    continue: true,
+    hookSpecificOutput: {
+      hookEventName: eventName,
+      additionalContext: message,
+    },
+  };
+}
+
+function resolveHook(payload) {
+  const eventName = toLowerText(payload.hookEventName);
+  const workspaceRoot = resolveWorkspaceRoot(payload);
+
+  if (eventName === "sessionstart") {
+    return resolveSessionStart(payload, workspaceRoot, "SessionStart");
+  }
+
+  if (eventName === "subagentstart") {
+    return resolveSessionStart(payload, workspaceRoot, "SubagentStart");
+  }
+
+  if (eventName === "pretooluse") {
+    return resolvePreToolUse(payload, workspaceRoot);
+  }
+
+  if (eventName === "posttooluse") {
+    return resolvePostToolUse(payload, workspaceRoot);
+  }
+
+  if (eventName === "precompact") {
+    return { continue: true };
+  }
+
+  if (eventName === "userpromptsubmit") {
+    return { continue: true };
+  }
+
+  if (eventName === "subagentstop" || eventName === "stop") {
+    return { continue: true };
+  }
+
+  return { continue: true };
+}
+
+async function main() {
+  try {
+    const raw = await readStdin();
+    const payload = raw.trim() ? JSON.parse(raw) : {};
+    writeJson(resolveHook(payload));
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    writeJson({
+      continue: true,
+      systemMessage: `ACE Copilot hook warning: ${message}`,
+    });
+  }
+}
+
+main();

package/dist/helpers.d.ts

@@ -4,6 +4,7 @@
 export { isInside, isReadError, normalizeRelPath, looksLikeSwarmHandoffPath } from "./shared.js";
 export declare const SERVER_ROOT: string;
 export declare const PACKAGE_ROOT: string;
+export declare function resolveWorkspaceRoot(): string;
 export declare const WORKSPACE_ROOT: string;
 export declare const DEFAULTS_ROOT: string;
 export declare const ALL_MCP_CLIENTS: readonly ["codex", "vscode", "claude", "cursor", "antigravity"];

package/dist/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"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"}

package/dist/helpers.js

@@ -11,13 +11,41 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 export const SERVER_ROOT = resolve(__dirname, "..");
 export const PACKAGE_ROOT = SERVER_ROOT;
-export const WORKSPACE_ROOT = resolve(process.env.ACE_WORKSPACE_ROOT ?? process.cwd());
+function normalizeWorkspaceRootCandidate(candidate) {
+    const trimmed = candidate?.trim();
+    if (!trimmed)
+        return undefined;
+    return resolve(trimmed);
+}
+function isFilesystemRoot(path) {
+    return dirname(path) === path;
+}
+export function resolveWorkspaceRoot() {
+    const ordered = [
+        process.env.ACE_WORKSPACE_ROOT,
+        process.env.INIT_CWD,
+        process.env.PWD,
+        process.cwd(),
+    ]
+        .map(normalizeWorkspaceRootCandidate)
+        .filter((candidate) => Boolean(candidate));
+    const candidates = [...new Set(ordered)];
+    const firstExistingNonRoot = candidates.find((candidate) => existsSync(candidate) && !isFilesystemRoot(candidate));
+    if (firstExistingNonRoot)
+        return firstExistingNonRoot;
+    const firstExisting = candidates.find((candidate) => existsSync(candidate));
+    if (firstExisting)
+        return firstExisting;
+    return candidates[0] ?? resolve(process.cwd());
+}
+export const WORKSPACE_ROOT = resolveWorkspaceRoot();
 export const DEFAULTS_ROOT = resolve(PACKAGE_ROOT, "assets");
 const DEFAULTS_INSTRUCTIONS_ROOT = resolve(DEFAULTS_ROOT, "instructions");
 const DEFAULTS_TASKS_ROOT = resolve(DEFAULTS_ROOT, "tasks");
 const DEFAULTS_SKILLS_ROOT = resolve(DEFAULTS_ROOT, ".agents", "skills");
 const DEFAULTS_AGENT_STATE_ROOT = resolve(DEFAULTS_ROOT, "agent-state");
 const DEFAULTS_SCRIPTS_ROOT = resolve(DEFAULTS_ROOT, "scripts");
+const DEFAULTS_GITHUB_ROOT = resolve(DEFAULTS_ROOT, ".github");
 export const ALL_MCP_CLIENTS = [
     "codex",
     "vscode",
@@ -472,6 +500,281 @@ function normalizeOllamaBaseUrl(url) {
         return "http://127.0.0.1:11434";
     return trimmed.endsWith("/") ? trimmed.slice(0, -1) : trimmed;
 }
+function buildWorkspaceStateSeedFiles(projectName, generatedAt) {
+    const swarmHandoffTemplate = readText(DEFAULT_TASK_FILES.handoff_template);
+    return [
+        {
+            path: wsPath("global-state", "GLOBAL_RISKS.md"),
+            content: [
+                "# GLOBAL_RISKS",
+                "",
+                `Generated: ${generatedAt}`,
+                "",
+                "## Systemic Risks",
+                "- None logged yet. Record cross-swarm blockers, runway constraints, and release risks here.",
+                "",
+                "## Update Rule",
+                "- Keep local implementation risks in the owning swarm folder or `agent-state/RISKS.md`.",
+            ].join("\n"),
+        },
+        {
+            path: wsPath("global-state", "DECISION_LOG.md"),
+            content: [
+                "# DECISION_LOG",
+                "",
+                `Generated: ${generatedAt}`,
+                "",
+                "Append-only record for orchestrator-level tradeoffs that affect multiple swarms.",
+                "",
+                "## Entry Template",
+                `- ${generatedAt} — Decision: <what changed>`,
+                "  - Reason: <why>",
+                "  - Impact: <which swarm/state folders are affected>",
+            ].join("\n"),
+        },
+        {
+            path: wsPath("global-state", "ENGINEERING_SNAPSHOT.md"),
+            content: [
+                "# ENGINEERING_SNAPSHOT.md",
+                "",
+                `Generated: ${generatedAt}`,
+                "",
+                "## Profile",
+                "- Status: pending initial orchestrator discovery scan",
+                "- Project: " + projectName,
+                "- Durable location: `global-state/ENGINEERING_SNAPSHOT.md`",
+                "",
+                "## Quality Signals",
+                "- Tests: pending scan",
+                "- Public surface: pending scan",
+                "- Delivery risk: pending scan",
+                "",
+                "## Routing Recommendation",
+                "- Run the orchestrator discovery pass before first coder handoff.",
+            ].join("\n"),
+        },
+        {
+            path: wsPath("global-state", "SWARM_HANDOFF.json"),
+            content: swarmHandoffTemplate,
+        },
+        {
+            path: wsPath("venture-state", "STATUS.md"),
+            content: [
+                "# VENTURE STATUS",
+                "",
+                "- Mode: bootstrap",
+                "- Focus: clarify thesis and MVP",
+                "- Current phase: discovery",
+                "- Next handoff: ACE-VOS -> ACE-Orchestrator",
+                `- Last update: ${generatedAt}`,
+            ].join("\n"),
+        },
+        {
+            path: wsPath("venture-state", "TEAL_CONFIG.md"),
+            content: [
+                "# TEAL_CONFIG",
+                "",
+                "## Venture Pipeline",
+                "- discovery -> thesis -> blueprint -> MVP spec -> handoff",
+                "",
+                "## Durable Outputs",
+                "- `venture-state/THESIS.md`",
+                "- `venture-state/BLUEPRINT.md`",
+                "- `venture-state/GROWTH_LOOPS.md`",
+                "- `venture-state/RISKS.md`",
+                "- `venture-state/PROTOTYPE/MVP_SPEC.md`",
+            ].join("\n"),
+        },
+        {
+            path: wsPath("venture-state", "THESIS.md"),
+            content: [
+                "# THESIS",
+                "",
+                "## Problem",
+                "- TBD",
+                "",
+                "## Users",
+                "- TBD",
+                "",
+                "## Why Now",
+                "- TBD",
+                "",
+                "## Wedge",
+                "- TBD",
+            ].join("\n"),
+        },
+        {
+            path: wsPath("venture-state", "INTERROGATION.log"),
+            content: [
+                "# INTERROGATION LOG",
+                "",
+                `- ${generatedAt} bootstrap: venture interrogation started.`,
+            ].join("\n"),
+        },
+        {
+            path: wsPath("venture-state", "BLUEPRINT.md"),
+            content: [
+                "# BLUEPRINT",
+                "",
+                "## System Outline",
+                "- TBD",
+                "",
+                "## Critical Flows",
+                "- TBD",
+            ].join("\n"),
+        },
+        {
+            path: wsPath("venture-state", "GROWTH_LOOPS.md"),
+            content: [
+                "# GROWTH_LOOPS",
+                "",
+                "## Acquisition",
+                "- TBD",
+                "",
+                "## Retention",
+                "- TBD",
+                "",
+                "## Monetization",
+                "- TBD",
+            ].join("\n"),
+        },
+        {
+            path: wsPath("venture-state", "RISKS.md"),
+            content: [
+                "# VENTURE RISKS",
+                "",
+                "## Active Risks",
+                "- None logged yet.",
+            ].join("\n"),
+        },
+        {
+            path: wsPath("venture-state", "PROTOTYPE", "MVP_SPEC.md"),
+            content: [
+                "# MVP_SPEC",
+                "",
+                "## Objective",
+                "- TBD",
+                "",
+                "## Must-Have Behaviors",
+                "- TBD",
+                "",
+                "## Proof Requirement",
+                "- Define the smallest working slice that demonstrates value.",
+            ].join("\n"),
+        },
+        {
+            path: wsPath("venture-state", "PROTOTYPE", "src", "README.md"),
+            content: [
+                "# Venture Prototype Source",
+                "",
+                "Use this directory when the venture swarm needs a lightweight proof-of-concept separate from `engineering-state/src/`.",
+            ].join("\n"),
+        },
+        {
+            path: wsPath("brand-state", "BRAND_VOICE.md"),
+            content: [
+                "# BRAND_VOICE",
+                "",
+                "## Positioning",
+                "- TBD",
+                "",
+                "## Tone",
+                "- Clear",
+                "- Specific",
+                "- Trust-building",
+                "",
+                "## Messaging Guardrails",
+                "- Avoid generic claims.",
+                "- Tie every headline to a concrete user outcome.",
+            ].join("\n"),
+        },
+        {
+            path: wsPath("brand-state", "AUDIT_LOG.md"),
+            content: [
+                "# AUDIT_LOG",
+                "",
+                `- ${generatedAt} bootstrap: brand audit log initialized.`,
+            ].join("\n"),
+        },
+        {
+            path: wsPath("brand-state", "COPY_DECK.md"),
+            content: [
+                "# COPY_DECK",
+                "",
+                "## Primary Headline",
+                "- TBD",
+                "",
+                "## Supporting Copy",
+                "- TBD",
+                "",
+                "## CTA",
+                "- TBD",
+            ].join("\n"),
+        },
+        {
+            path: wsPath("brand-state", "ASSETS", "strings.json"),
+            content: JSON.stringify({
+                app_name: projectName,
+                headline: "",
+                subheadline: "",
+                primary_cta: "",
+            }, null, 2),
+        },
+        {
+            path: wsPath("engineering-state", "BUILD_STATUS.md"),
+            content: [
+                "# BUILD_STATUS",
+                "",
+                "- Status: not started",
+                "- Active owner: ACE-Coders",
+                "- Blockers: none recorded",
+                `- Last update: ${generatedAt}`,
+            ].join("\n"),
+        },
+        {
+            path: wsPath("engineering-state", "SPEC_CONTRACT.json"),
+            content: JSON.stringify({
+                version: "0.1.0",
+                project: projectName,
+                status: "draft",
+                requirements: [],
+                acceptance_tests: [],
+                deliverables: [],
+            }, null, 2),
+        },
+        {
+            path: wsPath("engineering-state", "ARCHITECTURE.md"),
+            content: [
+                "# ARCHITECTURE",
+                "",
+                "## Stack",
+                "- TBD",
+                "",
+                "## Interfaces",
+                "- TBD",
+                "",
+                "## Constraints",
+                "- TBD",
+            ].join("\n"),
+        },
+        {
+            path: wsPath("engineering-state", "TEST_LOG.md"),
+            content: [
+                "# TEST_LOG",
+                "",
+                `- ${generatedAt} bootstrap: no tests executed yet.`,
+            ].join("\n"),
+        },
+        {
+            path: wsPath("engineering-state", "src", "README.md"),
+            content: [
+                "# Engineering Source",
+                "",
+                "Place the main implementation here. Keep test evidence in `engineering-state/TEST_LOG.md`.",
+            ].join("\n"),
+        },
+    ];
+}
 export function getMcpClientBundlePath(client) {
     if (client === "codex")
         return wsPath(".mcp-config", "codex.config.toml");
@@ -548,6 +851,7 @@ export function bootstrapAceWorkspace(options = {}) {
         throw new Error(`Unsupported llmProvider: ${llmProvider}`);
     }
     const result = { created: [], updated: [], skipped: [] };
+    const generatedAt = new Date().toISOString();
     const dirSeeds = [
         wsPath("global-state"),
         wsPath("venture-state"),
@@ -560,6 +864,8 @@ export function bootstrapAceWorkspace(options = {}) {
         wsPath("agent-state", "MODULES", "roles"),
         wsPath("agent-state", "MODULES", "gates"),
         wsPath("tasks"),
+        wsPath(".github"),
+        wsPath(".github", "hooks"),
         wsPath(".agents"),
         wsPath(".vscode"),
         wsPath(".mcp-config"),
@@ -574,6 +880,7 @@ export function bootstrapAceWorkspace(options = {}) {
     // Copy packaged defaults for tasks, instructions, skills, and agent-state.
     copyTree(DEFAULTS_TASKS_ROOT, wsPath("tasks"), result, force);
     copyTree(DEFAULTS_AGENT_STATE_ROOT, wsPath("agent-state"), result, force);
+    copyTree(DEFAULTS_GITHUB_ROOT, wsPath(".github"), result, force);
     copyTree(resolve(DEFAULTS_ROOT, ".agents"), wsPath(".agents"), result, force);
     copyTree(DEFAULTS_SCRIPTS_ROOT, wsPath("scripts", "ace"), result, force);
     // Canonical root-level instruction aliases.
@@ -606,7 +913,7 @@ export function bootstrapAceWorkspace(options = {}) {
     writeIfMissingOrForced(masterPlanPath, [
         `# ${projectName} — Master Plan`,
         "",
-        `Created: ${new Date().toISOString()}`,
+        `Created: ${generatedAt}`,
         "",
         "## Status",
         "",
@@ -628,6 +935,9 @@ export function bootstrapAceWorkspace(options = {}) {
         "| ACE-UI | idle | — |",
         "| ACE-Coders | idle | — |",
     ].join("\n"), result, force);
+    for (const file of buildWorkspaceStateSeedFiles(projectName, generatedAt)) {
+        writeIfMissingOrForced(file.path, file.content, result, force);
+    }
     // SWARM_REGISTRY is a derived artifact from code topology — always refresh.
     const registryPath = wsPath("global-state", "SWARM_REGISTRY.json");
     const swarmSubagents = [...COMPOSABLE_AGENTS];