@voybio/ace-swarm 0.2.4 → 2.4.0

package/dist/helpers/constants.d.ts

@@ -0,0 +1,53 @@
+export declare const SERVER_ROOT: string;
+export declare const PACKAGE_ROOT: string;
+export declare const DEFAULTS_ROOT: string;
+export declare const DEFAULTS_INSTRUCTIONS_ROOT: string;
+export declare const DEFAULTS_TASKS_ROOT: string;
+export declare const DEFAULTS_SKILLS_ROOT: string;
+export declare const DEFAULTS_AGENT_STATE_ROOT: string;
+export declare const DEFAULTS_SCRIPTS_ROOT: string;
+export declare const DEFAULTS_GITHUB_ROOT: string;
+export declare const ACE_ROOT_REL = ".agents/ACE";
+export declare const ACE_SKILLS_ROOT_REL = ".agents/ACE/skills";
+export declare const ACE_TASKS_ROOT_REL = ".agents/ACE/tasks";
+export declare const ACE_SCRIPTS_ROOT_REL = ".agents/ACE/scripts/ace";
+export declare const ACE_BUNDLE_ROOT_REL = ".mcp-config";
+export declare const ACE_LLM_ROOT_REL = ".agents/ACE/.ace";
+export declare const ACE_VSCODE_ROOT_REL = ".vscode";
+export declare const ACE_CURSOR_ROOT_REL = ".cursor";
+export declare const ACE_CLAUDE_ROOT_REL = ".claude";
+export declare const ACE_GITHUB_ROOT_REL = ".github";
+export declare const ACE_HOST_AGENTS_REL = "AGENTS.md";
+export declare const ACE_HOST_CLAUDE_REL = "CLAUDE.md";
+export declare const ACE_HOST_CURSOR_RULES_REL = ".cursorrules";
+export declare const ACE_PROJECTED_WORKSPACE_FILES: Set<string>;
+export declare const ACE_MANAGED_PREFIXES: readonly ["agent-state", "global-state", "venture-state", "brand-state", "business-state", "engineering-state", ".ace", ".mcp-config"];
+export declare const ALL_MCP_CLIENTS: readonly ["codex", "vscode", "copilot", "claude", "cursor", "antigravity"];
+export type McpClient = (typeof ALL_MCP_CLIENTS)[number];
+export declare const ALL_LLM_PROVIDERS: readonly ["ollama", "llama.cpp", "codex", "claude", "gemini", "copilot"];
+export type LlmProvider = (typeof ALL_LLM_PROVIDERS)[number];
+export declare const ALL_AGENTS: readonly ["orchestrator", "vos", "ui", "coders", "astgrep", "skeptic", "ops", "research", "spec", "builder", "qa", "docs", "memory", "security", "observability", "eval", "release"];
+export type AgentRole = (typeof ALL_AGENTS)[number];
+export declare const SWARM_AGENTS: readonly ["orchestrator", "vos", "ui", "coders"];
+export type SwarmAgentRole = (typeof SWARM_AGENTS)[number];
+export declare const COMPOSABLE_AGENTS: readonly ["astgrep", "skeptic", "ops", "research", "spec", "builder", "qa", "docs", "memory", "security", "observability", "eval", "release"];
+export type ComposableAgentRole = (typeof COMPOSABLE_AGENTS)[number];
+export declare const SWARM_SUBAGENT_MAP: Record<SwarmAgentRole, readonly ComposableAgentRole[]>;
+export type TaskKey = "todo" | "role_tasks" | "cli_work_split" | "lessons" | "readme" | "handoff_template" | "handoff_example" | "handoff_example_vos_ui" | "handoff_example_ui_coders";
+export type KernelKey = "directive_kernel" | "agent_registry";
+export declare const AGENT_FILES: Record<AgentRole, string[]>;
+export declare const AGENT_MANIFEST_FILES: Record<AgentRole, string[]>;
+export declare const TASK_FILES: Record<TaskKey, string[]>;
+export declare const KERNEL_FILES: Record<KernelKey, string[]>;
+export declare const DEFAULT_AGENT_INSTRUCTION_FILES: Record<AgentRole, string>;
+export declare const DEFAULT_AGENT_MANIFEST_FILES: Record<AgentRole, string>;
+export declare const DEFAULT_TASK_FILES: Record<TaskKey, string>;
+export declare const DEFAULT_KERNEL_FILES: Record<KernelKey, string>;
+export declare const STORE_AGENT_FILES: Record<AgentRole, {
+    agent: string;
+    instructions: string[];
+    manifests: string[];
+}>;
+export declare const STORE_TASK_FILES: Record<TaskKey, string>;
+export declare const STORE_KERNEL_FILES: Record<KernelKey, string[]>;
+//# sourceMappingURL=constants.d.ts.map

package/dist/helpers/constants.js

@@ -0,0 +1,288 @@
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+export const SERVER_ROOT = resolve(__dirname, "..", "..");
+export const PACKAGE_ROOT = SERVER_ROOT;
+export const DEFAULTS_ROOT = resolve(PACKAGE_ROOT, "assets");
+export const DEFAULTS_INSTRUCTIONS_ROOT = resolve(DEFAULTS_ROOT, "instructions");
+export const DEFAULTS_TASKS_ROOT = resolve(DEFAULTS_ROOT, "tasks");
+export const DEFAULTS_SKILLS_ROOT = resolve(DEFAULTS_ROOT, ".agents", "skills");
+export const DEFAULTS_AGENT_STATE_ROOT = resolve(DEFAULTS_ROOT, "agent-state");
+export const DEFAULTS_SCRIPTS_ROOT = resolve(DEFAULTS_ROOT, "scripts");
+export const DEFAULTS_GITHUB_ROOT = resolve(DEFAULTS_ROOT, ".github");
+export const ACE_ROOT_REL = ".agents/ACE";
+export const ACE_SKILLS_ROOT_REL = `${ACE_ROOT_REL}/skills`;
+export const ACE_TASKS_ROOT_REL = `${ACE_ROOT_REL}/tasks`;
+export const ACE_SCRIPTS_ROOT_REL = `${ACE_ROOT_REL}/scripts/ace`;
+export const ACE_BUNDLE_ROOT_REL = ".mcp-config";
+export const ACE_LLM_ROOT_REL = `${ACE_ROOT_REL}/.ace`;
+export const ACE_VSCODE_ROOT_REL = ".vscode";
+export const ACE_CURSOR_ROOT_REL = ".cursor";
+export const ACE_CLAUDE_ROOT_REL = ".claude";
+export const ACE_GITHUB_ROOT_REL = ".github";
+export const ACE_HOST_AGENTS_REL = "AGENTS.md";
+export const ACE_HOST_CLAUDE_REL = "CLAUDE.md";
+export const ACE_HOST_CURSOR_RULES_REL = ".cursorrules";
+export const ACE_PROJECTED_WORKSPACE_FILES = new Set([
+    `${ACE_TASKS_ROOT_REL}/todo.md`,
+]);
+export const ACE_MANAGED_PREFIXES = [
+    "agent-state",
+    "global-state",
+    "venture-state",
+    "brand-state",
+    "business-state",
+    "engineering-state",
+    ".ace",
+    ".mcp-config",
+];
+export const ALL_MCP_CLIENTS = [
+    "codex",
+    "vscode",
+    "copilot",
+    "claude",
+    "cursor",
+    "antigravity",
+];
+export const ALL_LLM_PROVIDERS = [
+    "ollama",
+    "llama.cpp",
+    "codex",
+    "claude",
+    "gemini",
+    "copilot",
+];
+export const ALL_AGENTS = [
+    "orchestrator",
+    "vos",
+    "ui",
+    "coders",
+    "astgrep",
+    "skeptic",
+    "ops",
+    "research",
+    "spec",
+    "builder",
+    "qa",
+    "docs",
+    "memory",
+    "security",
+    "observability",
+    "eval",
+    "release",
+];
+export const SWARM_AGENTS = ["orchestrator", "vos", "ui", "coders"];
+export const COMPOSABLE_AGENTS = [
+    "astgrep",
+    "skeptic",
+    "ops",
+    "research",
+    "spec",
+    "builder",
+    "qa",
+    "docs",
+    "memory",
+    "security",
+    "observability",
+    "eval",
+    "release",
+];
+export const SWARM_SUBAGENT_MAP = {
+    orchestrator: COMPOSABLE_AGENTS,
+    vos: COMPOSABLE_AGENTS,
+    ui: COMPOSABLE_AGENTS,
+    coders: COMPOSABLE_AGENTS,
+};
+export const AGENT_FILES = {
+    orchestrator: [
+        ".agents/ACE/orchestrator/instructions.md",
+        ".agents/ACE/orchestrator/AGENTS.md",
+        "ACE.instructions.md",
+        ".agents/ACE/ACE-Init/instructions.md",
+        ".agents/ACE/ACE-Init/AGENTS.md",
+    ],
+    vos: [
+        ".agents/ACE/VOS/instructions.md",
+        ".agents/ACE/VOS/AGENTS.md",
+        "ACE_VOS.instructions.md",
+    ],
+    ui: [
+        ".agents/ACE/UI/instructions.md",
+        ".agents/ACE/UI/AGENTS.md",
+        "ACE_UI.instructions.md",
+    ],
+    coders: [
+        ".agents/ACE/ACE_coders/INSTRUCTIONS.md",
+        ".agents/ACE/ACE_coders/AGENTS.md",
+        "ACE_Coder.instructions.md",
+    ],
+    astgrep: [".agents/ACE/agent-astgrep/instructions.md", ".agents/ACE/agent-astgrep/AGENTS.md"],
+    skeptic: [".agents/ACE/agent-skeptic/instructions.md", ".agents/ACE/agent-skeptic/AGENTS.md"],
+    ops: [".agents/ACE/agent-ops/instructions.md", ".agents/ACE/agent-ops/AGENTS.md"],
+    research: [
+        ".agents/ACE/agent-research/instructions.md",
+        ".agents/ACE/agent-research/AGENTS.md",
+    ],
+    spec: [".agents/ACE/agent-spec/instructions.md", ".agents/ACE/agent-spec/AGENTS.md"],
+    builder: [
+        ".agents/ACE/agent-builder/instructions.md",
+        ".agents/ACE/agent-builder/AGENTS.md",
+    ],
+    qa: [".agents/ACE/agent-qa/instructions.md", ".agents/ACE/agent-qa/AGENTS.md"],
+    docs: [".agents/ACE/agent-docs/instructions.md", ".agents/ACE/agent-docs/AGENTS.md"],
+    memory: [
+        ".agents/ACE/agent-memory/instructions.md",
+        ".agents/ACE/agent-memory/AGENTS.md",
+    ],
+    security: [
+        ".agents/ACE/agent-security/instructions.md",
+        ".agents/ACE/agent-security/AGENTS.md",
+    ],
+    observability: [
+        ".agents/ACE/agent-observability/instructions.md",
+        ".agents/ACE/agent-observability/AGENTS.md",
+    ],
+    eval: [".agents/ACE/agent-eval/instructions.md", ".agents/ACE/agent-eval/AGENTS.md"],
+    release: [".agents/ACE/agent-release/instructions.md", ".agents/ACE/agent-release/AGENTS.md"],
+};
+export const AGENT_MANIFEST_FILES = {
+    orchestrator: [
+        ".agents/ACE/orchestrator/AGENTS.md",
+        ".agents/ACE/ACE-Init/AGENTS.md",
+    ],
+    vos: [".agents/ACE/VOS/AGENTS.md"],
+    ui: [".agents/ACE/UI/AGENTS.md"],
+    coders: [".agents/ACE/ACE_coders/AGENTS.md"],
+    astgrep: [".agents/ACE/agent-astgrep/AGENTS.md"],
+    skeptic: [".agents/ACE/agent-skeptic/AGENTS.md"],
+    ops: [".agents/ACE/agent-ops/AGENTS.md"],
+    research: [".agents/ACE/agent-research/AGENTS.md"],
+    spec: [".agents/ACE/agent-spec/AGENTS.md"],
+    builder: [".agents/ACE/agent-builder/AGENTS.md"],
+    qa: [".agents/ACE/agent-qa/AGENTS.md"],
+    docs: [".agents/ACE/agent-docs/AGENTS.md"],
+    memory: [".agents/ACE/agent-memory/AGENTS.md"],
+    security: [".agents/ACE/agent-security/AGENTS.md"],
+    observability: [".agents/ACE/agent-observability/AGENTS.md"],
+    eval: [".agents/ACE/agent-eval/AGENTS.md"],
+    release: [".agents/ACE/agent-release/AGENTS.md"],
+};
+export const TASK_FILES = {
+    todo: [`${ACE_TASKS_ROOT_REL}/todo.md`],
+    role_tasks: [`${ACE_TASKS_ROOT_REL}/role_tasks.md`],
+    cli_work_split: [`${ACE_TASKS_ROOT_REL}/cli_work_split.md`],
+    lessons: [`${ACE_TASKS_ROOT_REL}/lessons.md`],
+    readme: [`${ACE_TASKS_ROOT_REL}/README.md`],
+    handoff_template: [`${ACE_TASKS_ROOT_REL}/SWARM_HANDOFF.template.json`],
+    handoff_example: [`${ACE_TASKS_ROOT_REL}/SWARM_HANDOFF.example.json`],
+    handoff_example_vos_ui: [`${ACE_TASKS_ROOT_REL}/SWARM_HANDOFF.example_vos_to_ui.json`],
+    handoff_example_ui_coders: [`${ACE_TASKS_ROOT_REL}/SWARM_HANDOFF.example_ui_to_coders.json`],
+};
+export const KERNEL_FILES = {
+    directive_kernel: [
+        ".agents/ACE/DIRECTIVE_KERNEL.md",
+        "agent-state/ACE_MACHINE_KERNEL_DIRECTIVES.md",
+    ],
+    agent_registry: [
+        ".agents/ACE/AGENT_REGISTRY.md",
+        ".agents/ACE/AGENT_REGISTRY_7.md",
+        "agent-state/ACE_7_AGENT_SYSTEM_SPEC.md",
+    ],
+};
+export const DEFAULT_AGENT_INSTRUCTION_FILES = {
+    orchestrator: resolve(DEFAULTS_INSTRUCTIONS_ROOT, "ACE.instructions.md"),
+    vos: resolve(DEFAULTS_INSTRUCTIONS_ROOT, "ACE_VOS.instructions.md"),
+    ui: resolve(DEFAULTS_INSTRUCTIONS_ROOT, "ACE_UI.instructions.md"),
+    coders: resolve(DEFAULTS_INSTRUCTIONS_ROOT, "ACE_Coder.instructions.md"),
+    astgrep: resolve(DEFAULTS_ROOT, ".agents", "ACE", "agent-astgrep", "instructions.md"),
+    skeptic: resolve(DEFAULTS_ROOT, ".agents", "ACE", "agent-skeptic", "instructions.md"),
+    ops: resolve(DEFAULTS_ROOT, ".agents", "ACE", "agent-ops", "instructions.md"),
+    research: resolve(DEFAULTS_ROOT, ".agents", "ACE", "agent-research", "instructions.md"),
+    spec: resolve(DEFAULTS_ROOT, ".agents", "ACE", "agent-spec", "instructions.md"),
+    builder: resolve(DEFAULTS_ROOT, ".agents", "ACE", "agent-builder", "instructions.md"),
+    qa: resolve(DEFAULTS_ROOT, ".agents", "ACE", "agent-qa", "instructions.md"),
+    docs: resolve(DEFAULTS_ROOT, ".agents", "ACE", "agent-docs", "instructions.md"),
+    memory: resolve(DEFAULTS_ROOT, ".agents", "ACE", "agent-memory", "instructions.md"),
+    security: resolve(DEFAULTS_ROOT, ".agents", "ACE", "agent-security", "instructions.md"),
+    observability: resolve(DEFAULTS_ROOT, ".agents", "ACE", "agent-observability", "instructions.md"),
+    eval: resolve(DEFAULTS_ROOT, ".agents", "ACE", "agent-eval", "instructions.md"),
+    release: resolve(DEFAULTS_ROOT, ".agents", "ACE", "agent-release", "instructions.md"),
+};
+export const DEFAULT_AGENT_MANIFEST_FILES = {
+    orchestrator: resolve(DEFAULTS_ROOT, ".agents", "ACE", "orchestrator", "AGENTS.md"),
+    vos: resolve(DEFAULTS_ROOT, ".agents", "ACE", "VOS", "AGENTS.md"),
+    ui: resolve(DEFAULTS_ROOT, ".agents", "ACE", "UI", "AGENTS.md"),
+    coders: resolve(DEFAULTS_ROOT, ".agents", "ACE", "ACE_coders", "AGENTS.md"),
+    astgrep: resolve(DEFAULTS_ROOT, ".agents", "ACE", "agent-astgrep", "AGENTS.md"),
+    skeptic: resolve(DEFAULTS_ROOT, ".agents", "ACE", "agent-skeptic", "AGENTS.md"),
+    ops: resolve(DEFAULTS_ROOT, ".agents", "ACE", "agent-ops", "AGENTS.md"),
+    research: resolve(DEFAULTS_ROOT, ".agents", "ACE", "agent-research", "AGENTS.md"),
+    spec: resolve(DEFAULTS_ROOT, ".agents", "ACE", "agent-spec", "AGENTS.md"),
+    builder: resolve(DEFAULTS_ROOT, ".agents", "ACE", "agent-builder", "AGENTS.md"),
+    qa: resolve(DEFAULTS_ROOT, ".agents", "ACE", "agent-qa", "AGENTS.md"),
+    docs: resolve(DEFAULTS_ROOT, ".agents", "ACE", "agent-docs", "AGENTS.md"),
+    memory: resolve(DEFAULTS_ROOT, ".agents", "ACE", "agent-memory", "AGENTS.md"),
+    security: resolve(DEFAULTS_ROOT, ".agents", "ACE", "agent-security", "AGENTS.md"),
+    observability: resolve(DEFAULTS_ROOT, ".agents", "ACE", "agent-observability", "AGENTS.md"),
+    eval: resolve(DEFAULTS_ROOT, ".agents", "ACE", "agent-eval", "AGENTS.md"),
+    release: resolve(DEFAULTS_ROOT, ".agents", "ACE", "agent-release", "AGENTS.md"),
+};
+export const DEFAULT_TASK_FILES = {
+    todo: resolve(DEFAULTS_TASKS_ROOT, "todo.md"),
+    role_tasks: resolve(DEFAULTS_TASKS_ROOT, "role_tasks.md"),
+    cli_work_split: resolve(DEFAULTS_TASKS_ROOT, "cli_work_split.md"),
+    lessons: resolve(DEFAULTS_TASKS_ROOT, "lessons.md"),
+    readme: resolve(DEFAULTS_TASKS_ROOT, "README.md"),
+    handoff_template: resolve(DEFAULTS_TASKS_ROOT, "SWARM_HANDOFF.template.json"),
+    handoff_example: resolve(DEFAULTS_TASKS_ROOT, "SWARM_HANDOFF.example.json"),
+    handoff_example_vos_ui: resolve(DEFAULTS_TASKS_ROOT, "SWARM_HANDOFF.example_vos_to_ui.json"),
+    handoff_example_ui_coders: resolve(DEFAULTS_TASKS_ROOT, "SWARM_HANDOFF.example_ui_to_coders.json"),
+};
+export const DEFAULT_KERNEL_FILES = {
+    directive_kernel: resolve(DEFAULTS_ROOT, ".agents", "ACE", "DIRECTIVE_KERNEL.md"),
+    agent_registry: resolve(DEFAULTS_ROOT, ".agents", "ACE", "AGENT_REGISTRY.md"),
+};
+export const STORE_AGENT_FILES = {
+    orchestrator: {
+        agent: "ace-orchestrator",
+        instructions: ["instructions.md", "AGENTS.md"],
+        manifests: ["AGENTS.md"],
+    },
+    vos: { agent: "ace-vos", instructions: ["instructions.md", "AGENTS.md"], manifests: ["AGENTS.md"] },
+    ui: { agent: "ace-ui", instructions: ["instructions.md", "AGENTS.md"], manifests: ["AGENTS.md"] },
+    coders: { agent: "ace-coders", instructions: ["INSTRUCTIONS.md", "AGENTS.md"], manifests: ["AGENTS.md"] },
+    astgrep: { agent: "astgrep", instructions: ["instructions.md", "AGENTS.md"], manifests: ["AGENTS.md"] },
+    skeptic: { agent: "skeptic", instructions: ["instructions.md", "AGENTS.md"], manifests: ["AGENTS.md"] },
+    ops: { agent: "ops", instructions: ["instructions.md", "AGENTS.md"], manifests: ["AGENTS.md"] },
+    research: { agent: "research", instructions: ["instructions.md", "AGENTS.md"], manifests: ["AGENTS.md"] },
+    spec: { agent: "spec", instructions: ["instructions.md", "AGENTS.md"], manifests: ["AGENTS.md"] },
+    builder: { agent: "builder", instructions: ["instructions.md", "AGENTS.md"], manifests: ["AGENTS.md"] },
+    qa: { agent: "qa", instructions: ["instructions.md", "AGENTS.md"], manifests: ["AGENTS.md"] },
+    docs: { agent: "docs", instructions: ["instructions.md", "AGENTS.md"], manifests: ["AGENTS.md"] },
+    memory: { agent: "memory", instructions: ["instructions.md", "AGENTS.md"], manifests: ["AGENTS.md"] },
+    security: { agent: "security", instructions: ["instructions.md", "AGENTS.md"], manifests: ["AGENTS.md"] },
+    observability: {
+        agent: "observability",
+        instructions: ["instructions.md", "AGENTS.md"],
+        manifests: ["AGENTS.md"],
+    },
+    eval: { agent: "eval", instructions: ["instructions.md", "AGENTS.md"], manifests: ["AGENTS.md"] },
+    release: { agent: "release", instructions: ["instructions.md", "AGENTS.md"], manifests: ["AGENTS.md"] },
+};
+export const STORE_TASK_FILES = {
+    todo: "knowledge/tasks/todo.md",
+    role_tasks: "knowledge/tasks/role_tasks.md",
+    cli_work_split: "knowledge/tasks/cli_work_split.md",
+    lessons: "knowledge/tasks/lessons.md",
+    readme: "knowledge/tasks/README.md",
+    handoff_template: "knowledge/tasks/SWARM_HANDOFF.template.json",
+    handoff_example: "knowledge/tasks/SWARM_HANDOFF.example.json",
+    handoff_example_vos_ui: "knowledge/tasks/SWARM_HANDOFF.example_vos_to_ui.json",
+    handoff_example_ui_coders: "knowledge/tasks/SWARM_HANDOFF.example_ui_to_coders.json",
+};
+export const STORE_KERNEL_FILES = {
+    directive_kernel: ["knowledge/kernel/DIRECTIVE_KERNEL.md"],
+    agent_registry: ["knowledge/kernel/AGENT_REGISTRY.md", "knowledge/kernel/AGENT_REGISTRY_7.md"],
+};
+//# sourceMappingURL=constants.js.map

package/dist/helpers/drift.d.ts

@@ -0,0 +1,13 @@
+export interface DriftEntry {
+    asset_path: string;
+    runtime_path: string;
+    status: "match" | "drift" | "missing-runtime" | "missing-asset";
+}
+export interface DriftReport {
+    checked: number;
+    drifted: number;
+    missing_runtime: number;
+    entries: DriftEntry[];
+}
+export declare function detectAssetDrift(): DriftReport;
+//# sourceMappingURL=drift.d.ts.map

package/dist/helpers/drift.js

@@ -0,0 +1,45 @@
+import { existsSync, readdirSync } from "node:fs";
+import { resolve } from "node:path";
+import { DEFAULTS_AGENT_STATE_ROOT, DEFAULTS_TASKS_ROOT, } from "./constants.js";
+import { acePath, readText, wsPath } from "./path-utils.js";
+export function detectAssetDrift() {
+    const entries = [];
+    const assetDirs = [
+        { assetRoot: DEFAULTS_AGENT_STATE_ROOT, workspaceRoot: wsPath("agent-state") },
+        { assetRoot: DEFAULTS_TASKS_ROOT, workspaceRoot: acePath("tasks") },
+    ];
+    function walkAndCompare(assetDir, runtimeDir) {
+        if (!existsSync(assetDir))
+            return;
+        const items = readdirSync(assetDir, { withFileTypes: true });
+        for (const item of items) {
+            const assetPath = resolve(assetDir, item.name);
+            const runtimePath = resolve(runtimeDir, item.name);
+            if (item.isDirectory()) {
+                walkAndCompare(assetPath, runtimePath);
+                continue;
+            }
+            if (!existsSync(runtimePath)) {
+                entries.push({ asset_path: assetPath, runtime_path: runtimePath, status: "missing-runtime" });
+                continue;
+            }
+            const assetContent = readText(assetPath);
+            const runtimeContent = readText(runtimePath);
+            entries.push({
+                asset_path: assetPath,
+                runtime_path: runtimePath,
+                status: assetContent === runtimeContent ? "match" : "drift",
+            });
+        }
+    }
+    for (const { assetRoot, workspaceRoot } of assetDirs) {
+        walkAndCompare(assetRoot, workspaceRoot);
+    }
+    return {
+        checked: entries.length,
+        drifted: entries.filter((e) => e.status === "drift").length,
+        missing_runtime: entries.filter((e) => e.status === "missing-runtime").length,
+        entries,
+    };
+}
+//# sourceMappingURL=drift.js.map

package/dist/helpers/path-utils.d.ts

@@ -0,0 +1,17 @@
+import { SWARM_AGENTS } from "./constants.js";
+export declare function currentWorkspaceRoot(): string;
+export declare function mapAceWorkspaceRelativePath(path: string): string;
+export declare function isProjectedAceWorkspacePath(filePath: string): boolean;
+export declare function acePath(...segments: string[]): string;
+export declare function wsPath(...segments: string[]): string;
+export declare function normalizePathForValidation(path: string): string;
+export declare function isSwarmRole(role: string): role is (typeof SWARM_AGENTS)[number];
+export declare function atomicWrite(filePath: string, content: string): string;
+export declare function fileExists(filePath: string): boolean;
+export declare function resolveWorkspaceWritePath(filePath: string): string;
+export declare function resolveWorkspaceReadPath(filePath: string): string;
+export declare function resolveWorkspaceArtifactPath(filePath: string, mode?: "read" | "write"): string;
+export declare function toAbsoluteWorkspaceCandidates(candidates: string[]): string[];
+export declare function firstExistingPath(paths: string[]): string | undefined;
+export declare function readText(absPath: string): string;
+//# sourceMappingURL=path-utils.d.ts.map

package/dist/helpers/path-utils.js

@@ -0,0 +1,104 @@
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync, } from "node:fs";
+import { dirname, isAbsolute, relative, resolve } from "node:path";
+import { isInside, normalizeRelPath } from "../shared.js";
+import { ACE_MANAGED_PREFIXES, ACE_PROJECTED_WORKSPACE_FILES, ACE_ROOT_REL, SWARM_AGENTS, } from "./constants.js";
+import { resolveWorkspaceRoot } from "./workspace-root.js";
+export function currentWorkspaceRoot() {
+    return resolveWorkspaceRoot();
+}
+export function mapAceWorkspaceRelativePath(path) {
+    const normalized = normalizeRelPath(path);
+    if (!normalized || normalized === ".")
+        return normalized;
+    if (normalized === "agent-state" || normalized.startsWith("agent-state/")) {
+        return normalized;
+    }
+    if (normalized === ACE_ROOT_REL || normalized.startsWith(`${ACE_ROOT_REL}/`)) {
+        return normalized;
+    }
+    for (const prefix of ACE_MANAGED_PREFIXES) {
+        if (normalized === prefix || normalized.startsWith(`${prefix}/`)) {
+            return `${ACE_ROOT_REL}/${normalized}`;
+        }
+    }
+    return normalized;
+}
+export function isProjectedAceWorkspacePath(filePath) {
+    const canonical = mapAceWorkspaceRelativePath(normalizeRelPath(filePath));
+    return ACE_PROJECTED_WORKSPACE_FILES.has(canonical);
+}
+export function acePath(...segments) {
+    return resolve(currentWorkspaceRoot(), ACE_ROOT_REL, ...segments);
+}
+export function wsPath(...segments) {
+    const relativePath = normalizeRelPath(segments.join("/"));
+    return resolve(currentWorkspaceRoot(), mapAceWorkspaceRelativePath(relativePath));
+}
+export function normalizePathForValidation(path) {
+    const root = currentWorkspaceRoot();
+    const relPath = isAbsolute(path) ? relative(root, path) : path;
+    return normalizeRelPath(relPath);
+}
+export function isSwarmRole(role) {
+    return SWARM_AGENTS.includes(role);
+}
+export function atomicWrite(filePath, content) {
+    const abs = isAbsolute(filePath) ? filePath : resolveWorkspaceWritePath(filePath);
+    mkdirSync(dirname(abs), { recursive: true });
+    const tmpPath = `${abs}.${process.pid}.tmp`;
+    writeFileSync(tmpPath, content, "utf-8");
+    renameSync(tmpPath, abs);
+    return abs;
+}
+export function fileExists(filePath) {
+    const abs = isAbsolute(filePath) ? filePath : resolveWorkspaceReadPath(filePath);
+    return existsSync(abs);
+}
+export function resolveWorkspaceWritePath(filePath) {
+    const root = currentWorkspaceRoot();
+    if (dirname(root) === root) {
+        throw new Error("Workspace root resolved to filesystem root. Set ACE_WORKSPACE_ROOT or run ACE from the target workspace.");
+    }
+    const abs = isAbsolute(filePath)
+        ? filePath
+        : resolve(root, mapAceWorkspaceRelativePath(filePath));
+    if (!isInside(root, abs)) {
+        throw new Error(`Path escapes workspace root: ${filePath}`);
+    }
+    return abs;
+}
+export function resolveWorkspaceReadPath(filePath) {
+    const root = currentWorkspaceRoot();
+    if (isAbsolute(filePath)) {
+        if (!isInside(root, filePath)) {
+            throw new Error(`Path escapes workspace root: ${filePath}`);
+        }
+        return filePath;
+    }
+    const normalized = normalizeRelPath(filePath);
+    const canonicalRel = mapAceWorkspaceRelativePath(normalized);
+    const canonicalAbs = resolve(root, canonicalRel);
+    if (canonicalRel !== normalized) {
+        const legacyAbs = resolve(root, normalized);
+        if (!existsSync(canonicalAbs) && existsSync(legacyAbs)) {
+            return legacyAbs;
+        }
+    }
+    if (!isInside(root, canonicalAbs)) {
+        throw new Error(`Path escapes workspace root: ${filePath}`);
+    }
+    return canonicalAbs;
+}
+export function resolveWorkspaceArtifactPath(filePath, mode = "write") {
+    return mode === "read" ? resolveWorkspaceReadPath(filePath) : resolveWorkspaceWritePath(filePath);
+}
+export function toAbsoluteWorkspaceCandidates(candidates) {
+    return candidates.map((candidate) => isAbsolute(candidate) ? candidate : resolveWorkspaceReadPath(candidate));
+}
+export function firstExistingPath(paths) {
+    return paths.find((candidate) => existsSync(candidate));
+}
+export function readText(absPath) {
+    return readFileSync(absPath, "utf-8");
+}
+//# sourceMappingURL=path-utils.js.map

package/dist/helpers/store-resolution.d.ts

@@ -0,0 +1,19 @@
+export type ArtifactSource = "workspace" | "package-defaults" | "store" | "missing";
+export declare function formatStorePath(key: string): string;
+export declare function readStoreText(keys: string[]): {
+    key: string;
+    path: string;
+    text: string;
+} | undefined;
+export declare function listStoreSkillReferences(): Array<{
+    name: string;
+    path: string;
+    source: "store";
+}>;
+export declare function resolveStoreFallbackKeysForPath(filePath: string): string[];
+export declare function classifyPathSource(path?: string): ArtifactSource;
+export declare function safeRead(filePath: string): string;
+export declare function safeWrite(filePath: string, content: string): string;
+export declare function safeWriteAsync(filePath: string, content: string): Promise<string>;
+export declare function withFileLock<T>(path: string, fn: () => T | Promise<T>): Promise<T>;
+//# sourceMappingURL=store-resolution.d.ts.map