@alisio/plugin-swarm 0.0.0-stage → 0.1.0

package/dist/index.js

@@ -0,0 +1,207 @@
+import { definePlugin } from "@alisio/sdk";
+import { SwarmCoordinator } from "./coordinator.js";
+import { panelNodes } from "./panel.js";
+import { resourcePaths } from "./resources.js";
+import { VERSION } from "./version.js";
+export { ChildSessionRunner } from "./adapters/child-session-runner.js";
+export { FsBoardStore } from "./adapters/fs-board-store.js";
+export { FsHandoffStore } from "./adapters/fs-handoff-store.js";
+export { GitWorktreeIsolation } from "./adapters/git-worktree.js";
+export { ProcessGateRunner } from "./adapters/process-gate-runner.js";
+export { unavailableRunner } from "./adapters/unavailable-runner.js";
+export { Forge } from "./app/forge.js";
+export { ProjectRuntime } from "./app/project.js";
+export { SwarmServices } from "./app/services.js";
+export { SwarmCoordinator } from "./coordinator.js";
+export { formatDoctor, runDoctor } from "./doctor.js";
+export * from "./domain/attention.js";
+export * from "./domain/envelope.js";
+export * from "./domain/handoff.js";
+export * from "./domain/identifiers.js";
+export * from "./domain/pack.js";
+export * from "./domain/pipeline.js";
+export * from "./domain/task.js";
+export { parseTaskRef } from "./refs.js";
+export { agentForRole, isResourceRole, listShippedPacks, loadAgentProfile, loadRoleInstructions, loadShippedPack, loadToolchain, parseResource, resourcePaths, roleSkills, } from "./resources.js";
+export { atomicWrite } from "./storage.js";
+export * from "./toolchains/profile.js";
+export * from "./toolchains/thresholds.js";
+const text = (value, isError = false) => ({
+    content: [{ type: "text", text: value }],
+    ...(isError ? { isError: true } : {}),
+});
+const failure = (error) => text(error instanceof Error ? error.message : String(error), true);
+/** Register the swarm plugin on an API. `options` are test seams; production passes none. */
+export function registerSwarm(api, options = {}) {
+    api.resources.agents(resourcePaths.agents);
+    api.resources.skills(resourcePaths.skills);
+    const coordinator = new SwarmCoordinator(api, options);
+    const register = (name, description, argumentHint, handler) => api.commands.register(name, async (args, context) => handler(coordinator.workspaceOf(context?.sessionId), args), { description, argumentHint });
+    register("init", "Create the swarm forge in this workspace", "", (workspace) => coordinator.init(workspace));
+    register("doctor", "Check git, Node.js, toolchain commands and the workspace", "", (workspace) => coordinator.doctor(workspace));
+    register("pack", "List shipped and workspace packs, or show one", "list | show <name>", (workspace, args) => coordinator.pack(workspace, args));
+    register("project", "Create, open, close and list swarm projects", "new <name> [--pack <pack>] [--github <owner/repo>] -- <mission> | open <name> | close <name> | list", (workspace, args) => coordinator.project(workspace, args));
+    register("task", "Create a task card and queue it for the first role", "<project> new [name] -- <task text> | delete <name> | retry <name> | accept <name>", (workspace, args) => coordinator.task(workspace, args));
+    register("approve", "Approve a task waiting at the approval gate", "<project>/<task>", (workspace, args) => coordinator.approve(workspace, args));
+    register("reject", "Reject a task at the approval gate: retry, delete or accept unchanged", "<project>/<task> retry|delete|accept [-- comments]", (workspace, args) => coordinator.reject(workspace, args));
+    register("answer", "Answer a clarification question from a role", "<project>/<task> -- <answer>", (workspace, args) => coordinator.answer(workspace, args));
+    register("comment", "Comment on a document of a task waiting for approval, or clear the comments", "<project>/<task> <document> -- <comment> | <project>/<task> clear", (workspace, args) => coordinator.comment(workspace, args));
+    register("chat", "Talk to the read-only Lieutenant of a project", "[project] -- <message>", (workspace, args) => coordinator.chat(workspace, args));
+    register("stop", "Cancel a project's agents and halt its pump (the project stays open)", "<project>", (workspace, args) => coordinator.stop(workspace, args));
+    register("run", "Run a project's pump in the foreground until it is idle", "<project> [--seconds <1-3600>]", (workspace, args) => coordinator.run(workspace, args));
+    register("budget", "Show the swarm token budget, or raise the cap", "[raise <tokens>]", (workspace, args) => coordinator.budget(workspace, args));
+    register("dashboard", "Open the local swarm follow-up dashboard: board, work queue, activity and approvals", "[project | project/task]", (workspace, args) => coordinator.dashboard(workspace, args));
+    register("teardown", "Cancel every agent and stop every project (project files stay)", "--confirm TEARDOWN", (workspace, args) => coordinator.teardown(workspace, args));
+    register("status", "Show projects, lanes and items that need your attention", "[project]", (workspace, args) => coordinator.statusText(workspace, args));
+    registerFallbacks(api, coordinator);
+    api.tools.register({
+        name: "swarm_status",
+        description: "Show swarm projects, the task board and items that need attention.",
+        inputSchema: {
+            type: "object",
+            properties: { project: { type: "string", description: "Limit the report to one project." } },
+            additionalProperties: false,
+        },
+        effect: "read",
+        async execute(input, context) {
+            try {
+                const project = typeof input.project === "string" ? input.project : undefined;
+                return await coordinator.statusTool(context.workspace, project);
+            }
+            catch (error) {
+                return failure(error);
+            }
+        },
+    });
+    api.tools.register({
+        name: "swarm_task_new",
+        description: "Create a task card in an open swarm project and queue it for the first role.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project: { type: "string", description: "Open project name." },
+                text: { type: "string", description: "Task description." },
+                name: { type: "string", description: "Optional task slug." },
+            },
+            required: ["project", "text"],
+            additionalProperties: false,
+        },
+        effect: "write",
+        async execute(input, context) {
+            try {
+                if (typeof input.project !== "string" || typeof input.text !== "string") {
+                    throw new Error("project and text are required");
+                }
+                const name = typeof input.name === "string" ? input.name : undefined;
+                coordinator.touch(context.session);
+                return text(await coordinator.createTask(context.workspace, input.project, input.text, name));
+            }
+            catch (error) {
+                return failure(error);
+            }
+        },
+    });
+    api.tools.register({
+        name: "swarm_gate_run",
+        description: "Run one quality gate (tests-green, test-first, coverage, crap, dry, mutation, structure, acceptance) for a role of an open swarm project and return the structured report.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project: { type: "string", description: "Open project name." },
+                role: { type: "string", description: "Pack role whose working directory is checked." },
+                gate: { type: "string", description: "Gate name." },
+                task: {
+                    type: "string",
+                    description: "Optional task name: gates that diff against the role's base commit use it.",
+                },
+            },
+            required: ["project", "role", "gate"],
+            additionalProperties: false,
+        },
+        effect: "process",
+        async execute(input, context) {
+            try {
+                if (typeof input.project !== "string" ||
+                    typeof input.role !== "string" ||
+                    typeof input.gate !== "string") {
+                    throw new Error("project, role and gate are required");
+                }
+                coordinator.touch(context.session);
+                return text(await coordinator.gateRun(context.workspace, {
+                    project: input.project,
+                    role: input.role,
+                    gate: input.gate,
+                    ...(typeof input.task === "string" ? { task: input.task } : {}),
+                }));
+            }
+            catch (error) {
+                return failure(error);
+            }
+        },
+    });
+    api.tools.register({
+        name: "swarm_doctor",
+        description: "Check that git, Node.js, toolchain commands and the workspace are ready for a swarm.",
+        inputSchema: { type: "object", properties: {}, additionalProperties: false },
+        effect: "process",
+        async execute(_input, context) {
+            try {
+                return text(await coordinator.doctor(context.workspace));
+            }
+            catch (error) {
+                return failure(error);
+            }
+        },
+    });
+    return coordinator;
+}
+/**
+ * Fail-open fallbacks for hosts that offer them: a `ui.panel` tree (projects, roles, tasks) and
+ * the `swarm-board` data view that returns the dashboard state. Absence or failure changes nothing.
+ */
+function registerFallbacks(api, coordinator) {
+    try {
+        api.ui?.panel?.("swarm", {
+            title: "Swarm",
+            nodes: ({ sessionId }) => {
+                try {
+                    return panelNodes(coordinator.forgeFor(api.sessions.workspace(sessionId)));
+                }
+                catch {
+                    return [];
+                }
+            },
+        });
+    }
+    catch {
+        // The panel is optional: the dashboard and the commands carry the same information.
+    }
+    try {
+        api.views?.register({
+            id: "swarm-board",
+            description: "Swarm board, attention items and work queue as JSON.",
+            handler: async (_params, context) => coordinator.services.state(context.workspace),
+        });
+    }
+    catch {
+        // Views are optional.
+    }
+}
+let active;
+const plugin = definePlugin({
+    id: "swarm",
+    name: "Swarm",
+    description: "Runs a handoff-driven pipeline of specialised agents, each in its own git worktree, with durable handoffs and human gates.",
+    categories: ["methodology-harness"],
+    version: VERSION,
+    apiVersion: 1,
+    setup(api) {
+        active = registerSwarm(api);
+    },
+    async dispose() {
+        await active?.dispose();
+        active = undefined;
+    },
+});
+export default plugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/options.d.ts

@@ -0,0 +1,13 @@
+export interface SwarmOptions {
+    /** Roles running at once, below the host's subagent limits. */
+    maxConcurrent: number;
+    /** Per-role overrides (`pluginOverrides.swarm.options.roles.<role>.model`). */
+    roles: Record<string, {
+        model?: string;
+    }>;
+    /** Soft cap on total tokens across the swarm (`options.tokenBudget`); absent means unlimited. */
+    tokenBudget?: number;
+}
+/** Lenient: an invalid option falls back to its default instead of breaking startup. */
+export declare function parseOptions(raw: unknown): SwarmOptions;
+//# sourceMappingURL=options.d.ts.map

package/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,+DAA+D;IAC/D,aAAa,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1C,iGAAiG;IACjG,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAKD,wFAAwF;AACxF,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,CAoBvD"}

package/dist/options.js

@@ -0,0 +1,27 @@
+import { rolePattern } from "./domain/identifiers.js";
+const isRecord = (value) => Boolean(value) && typeof value === "object" && !Array.isArray(value);
+/** Lenient: an invalid option falls back to its default instead of breaking startup. */
+export function parseOptions(raw) {
+    const options = { maxConcurrent: 3, roles: {} };
+    if (!isRecord(raw))
+        return options;
+    const cap = raw.maxConcurrent;
+    if (typeof cap === "number" && Number.isInteger(cap) && cap >= 1 && cap <= 8) {
+        options.maxConcurrent = cap;
+    }
+    const budget = raw.tokenBudget;
+    if (typeof budget === "number" && Number.isInteger(budget) && budget >= 1000) {
+        options.tokenBudget = budget;
+    }
+    if (isRecord(raw.roles)) {
+        for (const [role, value] of Object.entries(raw.roles)) {
+            if (!rolePattern.test(role) || !isRecord(value))
+                continue;
+            const model = value.model;
+            options.roles[role] =
+                typeof model === "string" && model.length > 0 && model.length <= 200 ? { model } : {};
+        }
+    }
+    return options;
+}
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAWtD,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CACpE,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAEvE,wFAAwF;AACxF,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,MAAM,OAAO,GAAiB,EAAE,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAC9D,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IACnC,MAAM,GAAG,GAAG,GAAG,CAAC,aAAa,CAAC;IAC9B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;QAC7E,OAAO,CAAC,aAAa,GAAG,GAAG,CAAC;IAC9B,CAAC;IACD,MAAM,MAAM,GAAG,GAAG,CAAC,WAAW,CAAC;IAC/B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QAC7E,OAAO,CAAC,WAAW,GAAG,MAAM,CAAC;IAC/B,CAAC;IACD,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACtD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,SAAS;YAC1D,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;YAC1B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;gBACjB,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1F,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/panel.d.ts

@@ -0,0 +1,5 @@
+import type { PanelNode } from "@alisio/sdk";
+import type { Forge } from "./app/forge.js";
+/** The `ui.panel` tree (projects, roles, tasks) of the running projects. Synchronous by contract. */
+export declare function panelNodes(forge: Forge): PanelNode[];
+//# sourceMappingURL=panel.d.ts.map

package/dist/panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel.d.ts","sourceRoot":"","sources":["../src/panel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAuD5C,qGAAqG;AACrG,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,EAAE,CAEpD"}

package/dist/panel.js

@@ -0,0 +1,52 @@
+import { roleIds } from "./domain/pack.js";
+const COLORS = {
+    queued: "gray",
+    working: "blue",
+    waiting_approval: "yellow",
+    rejected: "red",
+    merging: "cyan",
+    clarifying: "yellow",
+    blocked: "red",
+    done: "green",
+};
+const projectNodes = (runtime) => {
+    const projectId = `project:${runtime.name}`;
+    const nodes = [
+        {
+            id: projectId,
+            label: runtime.name,
+            color: "green",
+            status: "running",
+            detail: `${runtime.pack.name}: ${roleIds(runtime.pack).join(" > ")}`,
+        },
+    ];
+    const active = runtime.activeRoles();
+    const tasks = runtime.board().tasks;
+    for (const role of roleIds(runtime.pack)) {
+        const roleId = `${projectId}:role:${role}`;
+        const live = active.has(role);
+        nodes.push({
+            id: roleId,
+            parentId: projectId,
+            label: role,
+            color: live ? "green" : "gray",
+            status: live ? "live" : "idle",
+        });
+        for (const card of tasks.filter((candidate) => candidate.lane === role && candidate.status !== "done")) {
+            nodes.push({
+                id: `${projectId}:task:${card.name}`,
+                parentId: roleId,
+                label: card.name,
+                color: COLORS[card.status],
+                status: card.status,
+                detail: `audits ${card.auditCount}`,
+            });
+        }
+    }
+    return nodes;
+};
+/** The `ui.panel` tree (projects, roles, tasks) of the running projects. Synchronous by contract. */
+export function panelNodes(forge) {
+    return forge.runningRuntimes().flatMap(projectNodes);
+}
+//# sourceMappingURL=panel.js.map

package/dist/panel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel.js","sourceRoot":"","sources":["../src/panel.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAG3C,MAAM,MAAM,GAA+B;IACzC,MAAM,EAAE,MAAM;IACd,OAAO,EAAE,MAAM;IACf,gBAAgB,EAAE,QAAQ;IAC1B,QAAQ,EAAE,KAAK;IACf,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,QAAQ;IACpB,OAAO,EAAE,KAAK;IACd,IAAI,EAAE,OAAO;CACd,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,OAAuB,EAAe,EAAE;IAC5D,MAAM,SAAS,GAAG,WAAW,OAAO,CAAC,IAAI,EAAE,CAAC;IAC5C,MAAM,KAAK,GAAgB;QACzB;YACE,EAAE,EAAE,SAAS;YACb,KAAK,EAAE,OAAO,CAAC,IAAI;YACnB,KAAK,EAAE,OAAO;YACd,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;SACrE;KACF,CAAC;IACF,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC;IACpC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,GAAG,SAAS,SAAS,IAAI,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC;YACT,EAAE,EAAE,MAAM;YACV,QAAQ,EAAE,SAAS;YACnB,KAAK,EAAE,IAAI;YACX,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;YAC9B,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;SAC/B,CAAC,CAAC;QACH,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,MAAM,CAC7B,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,IAAI,IAAI,SAAS,CAAC,MAAM,KAAK,MAAM,CACtE,EAAE,CAAC;YACF,KAAK,CAAC,IAAI,CAAC;gBACT,EAAE,EAAE,GAAG,SAAS,SAAS,IAAI,CAAC,IAAI,EAAE;gBACpC,QAAQ,EAAE,MAAM;gBAChB,KAAK,EAAE,IAAI,CAAC,IAAI;gBAChB,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;gBAC1B,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,MAAM,EAAE,UAAU,IAAI,CAAC,UAAU,EAAE;aACpC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,qGAAqG;AACrG,MAAM,UAAU,UAAU,CAAC,KAAY;IACrC,OAAO,KAAK,CAAC,eAAe,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;AACvD,CAAC"}

package/dist/ports/agent-runner.d.ts

@@ -0,0 +1,51 @@
+/** Runs one agent turn for a role. v1's real adapter is an Alisio child session (Phase 3). */
+export interface RunRequest {
+    /** Stable key of the long-lived conversation: one per project and role, reused across prompts. */
+    sessionKey: string;
+    project: string;
+    role: string;
+    /** The pack's agent definition id (its `.agents/agents` file). */
+    agent: string;
+    /** Working directory of the role: its git worktree, or the main checkout for the master role. */
+    workdir: string;
+    prompt: string;
+    signal?: AbortSignal;
+}
+export interface RunResult {
+    status: "completed" | "failed" | "cancelled";
+    text: string;
+    /** The child hit its turn limit: `text` is partial and must be rejected. */
+    turnsExceeded?: boolean;
+    error?: string;
+    /** Tokens the run consumed, when the host reports them (feeds the swarm token budget). */
+    usage?: {
+        input: number;
+        output: number;
+    };
+}
+/** One line of the plugin-recorded activity of a role (the SDK exposes no transcript API). */
+export interface TailEntry {
+    at: string;
+    kind: "prompt" | "reply";
+    text: string;
+}
+/** A read-only view of a role's conversation for observability (dashboard tail, work queue). */
+export interface RunnerView {
+    /** The host child session id, when the adapter has one. */
+    sessionId?: string;
+    /** A run is in flight right now. */
+    live: boolean;
+    /** Runs started in the last ten minutes: the activity meter of the work queue. */
+    recentRuns: number;
+    tail: TailEntry[];
+}
+export interface AgentRunner {
+    run(request: RunRequest): Promise<RunResult>;
+    /** Cancel every running conversation of a project (close, teardown). */
+    cancelProject(project: string): void;
+    /** Cancel every running conversation (teardown, dispose). */
+    cancelAll?(): void;
+    /** Observability only: undefined when the role has no conversation yet. */
+    inspect?(sessionKey: string): RunnerView | undefined;
+}
+//# sourceMappingURL=agent-runner.d.ts.map

package/dist/ports/agent-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-runner.d.ts","sourceRoot":"","sources":["../../src/ports/agent-runner.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,MAAM,WAAW,UAAU;IACzB,kGAAkG;IAClG,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,iGAAiG;IACjG,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,KAAK,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C;AAED,8FAA8F;AAC9F,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,gGAAgG;AAChG,MAAM,WAAW,UAAU;IACzB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,IAAI,EAAE,OAAO,CAAC;IACd,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,SAAS,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC7C,wEAAwE;IACxE,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,6DAA6D;IAC7D,SAAS,CAAC,IAAI,IAAI,CAAC;IACnB,2EAA2E;IAC3E,OAAO,CAAC,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;CACtD"}

package/dist/ports/agent-runner.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent-runner.js.map

package/dist/ports/agent-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-runner.js","sourceRoot":"","sources":["../../src/ports/agent-runner.ts"],"names":[],"mappings":""}

package/dist/ports/board-store.d.ts

@@ -0,0 +1,7 @@
+import type { Board } from "../domain/task.js";
+export interface BoardStore {
+    /** `undefined` when no board was ever written. Throws when the file is corrupt. */
+    read(): Promise<Board | undefined>;
+    write(board: Board): Promise<void>;
+}
+//# sourceMappingURL=board-store.d.ts.map

package/dist/ports/board-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-store.d.ts","sourceRoot":"","sources":["../../src/ports/board-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,WAAW,UAAU;IACzB,mFAAmF;IACnF,IAAI,IAAI,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;IACnC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC"}

package/dist/ports/board-store.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=board-store.js.map

package/dist/ports/board-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-store.js","sourceRoot":"","sources":["../../src/ports/board-store.ts"],"names":[],"mappings":""}

package/dist/ports/clock.d.ts

@@ -0,0 +1,5 @@
+export interface Clock {
+    now(): Date;
+}
+export declare const systemClock: Clock;
+//# sourceMappingURL=clock.d.ts.map

package/dist/ports/clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.d.ts","sourceRoot":"","sources":["../../src/ports/clock.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,KAAK;IACpB,GAAG,IAAI,IAAI,CAAC;CACb;AAED,eAAO,MAAM,WAAW,EAAE,KAAiC,CAAC"}

package/dist/ports/clock.js

@@ -0,0 +1,2 @@
+export const systemClock = { now: () => new Date() };
+//# sourceMappingURL=clock.js.map

package/dist/ports/clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.js","sourceRoot":"","sources":["../../src/ports/clock.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,WAAW,GAAU,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC"}

package/dist/ports/gate-runner.d.ts

@@ -0,0 +1,34 @@
+import type { GateName, Thresholds } from "../domain/pack.js";
+export interface GateRequest {
+    project: string;
+    task: string;
+    role: string;
+    gate: GateName;
+    workdir: string;
+    /** Toolchain profile id (from the pack). */
+    toolchain: string;
+    /** Pack thresholds: gates never hard-code them. */
+    thresholds: Thresholds;
+    /** Commit the role started from: gates look at the diff `since..HEAD`. */
+    since?: string;
+    signal?: AbortSignal;
+}
+export interface GateReport {
+    gate: GateName;
+    passed: boolean;
+    /** Human-readable findings handed back to the role when the gate fails. */
+    findings: string[];
+    /** Why the gate did not run a check (for example no deterministic checker exists yet). */
+    skipped?: string;
+    /** The gate could not run at all (missing tool, unparseable report): a human must look. */
+    error?: string;
+    timedOut?: boolean;
+    durationMs?: number;
+}
+/** Deterministic quality gate runner (spec AD-6). */
+export interface GateRunner {
+    run(request: GateRequest): Promise<GateReport>;
+    /** Stop gate processes that are still running, optionally only those under a directory. */
+    cancelAll?(under?: string): void;
+}
+//# sourceMappingURL=gate-runner.d.ts.map

package/dist/ports/gate-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-runner.d.ts","sourceRoot":"","sources":["../../src/ports/gate-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE9D,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,UAAU,EAAE,UAAU,CAAC;IACvB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,0FAA0F;IAC1F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2FAA2F;IAC3F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qDAAqD;AACrD,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/C,2FAA2F;IAC3F,SAAS,CAAC,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC"}

package/dist/ports/gate-runner.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=gate-runner.js.map

package/dist/ports/gate-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-runner.js","sourceRoot":"","sources":["../../src/ports/gate-runner.ts"],"names":[],"mappings":""}

package/dist/ports/handoff-store.d.ts

@@ -0,0 +1,39 @@
+import type { Handoff, HandoffLocation, InboxBox, StoredHandoff } from "../domain/handoff.js";
+export interface ScanResult {
+    records: StoredHandoff[];
+    /** Files that failed strict revalidation (relative to the store root). */
+    invalid: string[];
+}
+export interface RecoveryResult {
+    redelivered: number;
+    requeued: number;
+}
+/** Durable, file-based handoff queue. Files are the source of truth for crash recovery. */
+export interface HandoffStore {
+    ensureRoles(roles: string[]): Promise<void>;
+    /** Write a new handoff at a location, allocating its sequence number and file name. */
+    write(handoff: Handoff, location: HandoffLocation): Promise<StoredHandoff>;
+    /** Move a handoff to another location, optionally rewriting its header fields. */
+    move(stored: StoredHandoff, to: HandoffLocation, patch?: Partial<Pick<Handoff, "approved" | "completedAt" | "dequeuedAt" | "enqueuedAt">>): Promise<StoredHandoff>;
+    /** Remove a handoff file (used for superseded audit parkings). Missing files are ignored. */
+    discard(stored: StoredHandoff): Promise<void>;
+    /** Outbox -> sent, with a copy in every recipient's `inbox/new`. Idempotent. */
+    deliver(stored: StoredHandoff): Promise<StoredHandoff[]>;
+    /** Phantom-sender handoffs go straight to the recipients' `inbox/new`. */
+    inject(handoff: Handoff): Promise<StoredHandoff[]>;
+    /** Move the next inbox item (or all equal-priority items of the same task for `batch`) to `in_process`. */
+    claim(role: string, options?: {
+        batch?: boolean;
+    }): Promise<StoredHandoff[]>;
+    /** Move claimed items to `completed`. */
+    complete(items: StoredHandoff[]): Promise<StoredHandoff[]>;
+    /** Remove every file of one task everywhere (task deletion); returns what was removed. */
+    purge(taskId: string): Promise<StoredHandoff[]>;
+    scan(): Promise<ScanResult>;
+    /** Replay after a crash: redeliver outbox items, requeue `in_process` items. */
+    recover(): Promise<RecoveryResult>;
+    /** Count items waiting in a role's `inbox/new`. */
+    pending(role: string): Promise<number>;
+}
+export type { InboxBox };
+//# sourceMappingURL=handoff-store.d.ts.map

package/dist/ports/handoff-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff-store.d.ts","sourceRoot":"","sources":["../../src/ports/handoff-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE9F,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,2FAA2F;AAC3F,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,uFAAuF;IACvF,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC3E,kFAAkF;IAClF,IAAI,CACF,MAAM,EAAE,aAAa,EACrB,EAAE,EAAE,eAAe,EACnB,KAAK,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,GAAG,aAAa,GAAG,YAAY,GAAG,YAAY,CAAC,CAAC,GACvF,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1B,6FAA6F;IAC7F,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,gFAAgF;IAChF,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACzD,0EAA0E;IAC1E,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACnD,2GAA2G;IAC3G,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAC7E,yCAAyC;IACzC,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAC3D,0FAA0F;IAC1F,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAChD,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5B,gFAAgF;IAChF,OAAO,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;IACnC,mDAAmD;IACnD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACxC;AAED,YAAY,EAAE,QAAQ,EAAE,CAAC"}

package/dist/ports/handoff-store.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=handoff-store.js.map

package/dist/ports/handoff-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff-store.js","sourceRoot":"","sources":["../../src/ports/handoff-store.ts"],"names":[],"mappings":""}

package/dist/ports/isolation.d.ts

@@ -0,0 +1,43 @@
+export interface MergeResult {
+    /** `already` = the commit was an ancestor; `merged` = a merge ran cleanly. */
+    status: "already" | "merged" | "conflict" | "error";
+    files?: string[];
+    message?: string;
+}
+export interface RolePlacement {
+    role: string;
+    master: boolean;
+}
+/** Filesystem and git isolation for a project: one working directory per role. */
+export interface Isolation {
+    /** `git init` on `master` with an initial commit, ignore rules and the commit-msg hook. */
+    initProject(projectDir: string, options: {
+        mission: string;
+        masterRole: string;
+    }): Promise<void>;
+    /** `git clone`; refuses an existing destination. */
+    cloneProject(url: string, projectDir: string, options: {
+        masterRole: string;
+    }): Promise<void>;
+    /** Create (idempotently) the role's working directory and return its absolute path. */
+    prepareRole(projectDir: string, project: string, placement: RolePlacement): Promise<string>;
+    hasCommit(workdir: string, commit: string): Promise<boolean>;
+    /** The ten-character id of HEAD in the working directory. */
+    headCommit(workdir: string): Promise<string>;
+    merge(workdir: string, commit: string): Promise<MergeResult>;
+    /** Abandon a conflicted merge, restoring the working directory. A no-op when none is running. */
+    abortMerge(workdir: string): Promise<void>;
+    /** Unmerged paths left by a conflicted merge. */
+    conflicts(workdir: string): Promise<string[]>;
+    /** Point a `refs/swarm/...` ref at a commit (snapshot of rejected work). */
+    snapshotRef(workdir: string, ref: string, commit: string): Promise<void>;
+    /** Restore the working directory to a commit; refuses when it has uncommitted changes. */
+    restoreTo(workdir: string, commit: string): Promise<void>;
+    /** Paths changed between two commits (`from` absent: the commit's own changes), relative to the root. */
+    changedFiles(workdir: string, from: string | undefined, to: string): Promise<string[]>;
+    /** Unified diff between two commits (`from` absent: the commit's own changes). */
+    diff(workdir: string, from: string | undefined, to: string): Promise<string>;
+    /** Content of a file in a commit, read from the object store (never the working tree); absent when missing. */
+    readFileAt(workdir: string, commit: string, path: string): Promise<string | undefined>;
+}
+//# sourceMappingURL=isolation.d.ts.map

package/dist/ports/isolation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isolation.d.ts","sourceRoot":"","sources":["../../src/ports/isolation.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,8EAA8E;IAC9E,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;IACpD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,kFAAkF;AAClF,MAAM,WAAW,SAAS;IACxB,2FAA2F;IAC3F,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjG,oDAAoD;IACpD,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9F,uFAAuF;IACvF,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5F,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,6DAA6D;IAC7D,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7D,iGAAiG;IACjG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,iDAAiD;IACjD,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9C,4EAA4E;IAC5E,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,0FAA0F;IAC1F,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,yGAAyG;IACzG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACvF,kFAAkF;IAClF,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7E,+GAA+G;IAC/G,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACxF"}

package/dist/ports/isolation.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=isolation.js.map

package/dist/ports/isolation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isolation.js","sourceRoot":"","sources":["../../src/ports/isolation.ts"],"names":[],"mappings":""}