@alisio/plugin-swarm 0.0.0-stage → 0.1.0

package/dist/app/forge.js

@@ -0,0 +1,420 @@
+import { existsSync } from "node:fs";
+import { mkdir, readdir, rm } from "node:fs/promises";
+import { join } from "node:path";
+import { FsBoardStore } from "../adapters/fs-board-store.js";
+import { FsHandoffStore } from "../adapters/fs-handoff-store.js";
+import { FsTaskStateStore } from "../adapters/fs-task-state-store.js";
+import { deriveAttention } from "../domain/attention.js";
+import { validateProjectName } from "../domain/identifiers.js";
+import { parsePack, roleIds } from "../domain/pack.js";
+import { entryRole } from "../domain/pipeline.js";
+import { systemClock } from "../ports/clock.js";
+import { silentNotifier } from "../ports/notifier.js";
+import { listShippedPacks, loadShippedPack } from "../resources.js";
+import { atomicWrite, ensureIgnoreEntries, Mutex, readText, resolveContained } from "../storage.js";
+import { UsageMeter } from "./budget.js";
+import { claimPidfile, releasePidfile } from "./pidfile.js";
+import { MAX_TASK_TEXT, ProjectRuntime } from "./project.js";
+const packNamePattern = /^[a-z0-9][a-z0-9-]{0,47}$/;
+const githubPattern = /^[A-Za-z0-9][A-Za-z0-9-]{0,38}\/[A-Za-z0-9._-]{1,100}$/;
+export const DEFAULT_PACK = "two-pack";
+function validateState(value) {
+    const record = value;
+    if (!record ||
+        typeof record !== "object" ||
+        record.schemaVersion !== 1 ||
+        !Array.isArray(record.projects)) {
+        throw new Error("forge.json is corrupt or has an unsupported schemaVersion");
+    }
+    const projects = record.projects.map((raw) => {
+        const entry = raw;
+        validateProjectName(entry.name);
+        if (typeof entry.pack !== "string" || !packNamePattern.test(entry.pack)) {
+            throw new Error("forge.json has an invalid pack name");
+        }
+        if (typeof entry.createdAt !== "string" || typeof entry.open !== "boolean") {
+            throw new Error("forge.json has an invalid project entry");
+        }
+        return {
+            name: entry.name,
+            pack: entry.pack,
+            createdAt: entry.createdAt,
+            open: entry.open,
+        };
+    });
+    return { schemaVersion: 1, projects };
+}
+/** The forge: `<workspace>/.alisio/swarm` with its projects, packs and open runtimes. */
+export class Forge {
+    deps;
+    dir;
+    clock;
+    notifier;
+    runtimes = new Map();
+    opening = new Map();
+    stateLock = new Mutex();
+    meter;
+    constructor(deps) {
+        this.deps = deps;
+        this.dir = join(deps.workspace, ".alisio", "swarm");
+        this.clock = deps.clock ?? systemClock;
+        this.notifier = deps.notifier ?? silentNotifier;
+    }
+    get statePath() {
+        return join(this.dir, "forge.json");
+    }
+    get projectsDir() {
+        return join(this.dir, "projects");
+    }
+    get packsDir() {
+        return join(this.dir, "packs");
+    }
+    async init() {
+        await mkdir(this.projectsDir, { recursive: true, mode: 0o700 });
+        await mkdir(this.packsDir, { recursive: true, mode: 0o700 });
+        const created = (await readText(this.statePath)) === undefined;
+        if (created) {
+            await atomicWrite(this.statePath, `${JSON.stringify({ schemaVersion: 1, projects: [] }, null, 2)}\n`);
+        }
+        const root = this.deps.workspace;
+        if (existsSync(join(root, ".git")) || existsSync(join(root, ".gitignore"))) {
+            await ensureIgnoreEntries(join(root, ".gitignore"), [".alisio/swarm/"]);
+        }
+        return { created };
+    }
+    async readState() {
+        const raw = await readText(this.statePath);
+        if (raw === undefined)
+            throw new Error("The swarm forge is not initialised; run /swarm:init first");
+        try {
+            return validateState(JSON.parse(raw));
+        }
+        catch (error) {
+            throw new Error(error instanceof Error ? error.message : "forge.json is corrupt");
+        }
+    }
+    mutateState(change) {
+        return this.stateLock.run(async () => {
+            const state = await this.readState();
+            const result = change(state);
+            await atomicWrite(this.statePath, `${JSON.stringify(state, null, 2)}\n`);
+            return result;
+        });
+    }
+    // ---- packs ----
+    async scanLocalPacks() {
+        const packs = [];
+        const invalid = [];
+        let names = [];
+        try {
+            names = (await readdir(this.packsDir)).filter((file) => file.endsWith(".json")).sort();
+        }
+        catch (error) {
+            if (error.code !== "ENOENT")
+                throw error;
+        }
+        for (const file of names) {
+            try {
+                const pack = parsePack(JSON.parse((await readText(join(this.packsDir, file)))));
+                if (`${pack.name}.json` !== file)
+                    throw new Error("The pack name must match its file name");
+                packs.push({ pack });
+            }
+            catch (error) {
+                invalid.push({ file, error: error instanceof Error ? error.message : String(error) });
+            }
+        }
+        return { packs, invalid };
+    }
+    async invalidPacks() {
+        return (await this.scanLocalPacks()).invalid;
+    }
+    async listPacks() {
+        const byName = new Map();
+        for (const name of await listShippedPacks()) {
+            const pack = await loadShippedPack(name);
+            byName.set(name, {
+                name,
+                description: pack.description,
+                roles: roleIds(pack),
+                source: "shipped",
+            });
+        }
+        for (const { pack } of (await this.scanLocalPacks()).packs) {
+            byName.set(pack.name, {
+                name: pack.name,
+                description: pack.description,
+                roles: roleIds(pack),
+                source: "workspace",
+            });
+        }
+        return [...byName.values()].sort((a, b) => a.name.localeCompare(b.name));
+    }
+    /** A workspace-local pack shadows a shipped pack of the same name. */
+    async loadPack(name) {
+        if (!packNamePattern.test(name))
+            throw new Error("Invalid pack name");
+        const local = (await this.scanLocalPacks()).packs.find((entry) => entry.pack.name === name);
+        if (local)
+            return local.pack;
+        if ((await listShippedPacks()).includes(name))
+            return loadShippedPack(name);
+        throw new Error(`Unknown pack: ${name}`);
+    }
+    // ---- projects ----
+    async isInitialised() {
+        return (await readText(this.statePath)) !== undefined;
+    }
+    /** Everything the status views need, including closed projects (read from their files). */
+    async snapshot(only) {
+        const state = await this.readState();
+        if (only !== undefined && !state.projects.some((entry) => entry.name === only)) {
+            throw new Error(`Unknown project: ${only}`);
+        }
+        const out = [];
+        for (const entry of state.projects) {
+            if (only !== undefined && entry.name !== only)
+                continue;
+            const runtime = this.runtimes.get(entry.name);
+            const dir = await resolveContained(this.projectsDir, entry.name);
+            let pack = runtime?.pack;
+            if (!pack) {
+                try {
+                    pack = parsePack(JSON.parse((await readText(join(dir, ".alisio", "swarm", "pack.json")))));
+                }
+                catch {
+                    pack = undefined;
+                }
+            }
+            let board = runtime?.board();
+            if (!board) {
+                try {
+                    board = await new FsBoardStore(dir).read();
+                }
+                catch {
+                    board = undefined;
+                }
+            }
+            let attention = [];
+            if (runtime)
+                attention = runtime.attention();
+            else if (board) {
+                const states = new Map();
+                for (const saved of await new FsTaskStateStore(dir).list())
+                    states.set(saved.taskId, saved);
+                attention = deriveAttention(entry.name, board, states);
+            }
+            out.push({
+                name: entry.name,
+                open: entry.open,
+                running: Boolean(runtime),
+                pack,
+                board,
+                attention,
+            });
+        }
+        return out;
+    }
+    async listProjects() {
+        const state = await this.readState();
+        return state.projects.map((entry) => ({
+            name: entry.name,
+            pack: entry.pack,
+            open: entry.open,
+            running: this.runtimes.has(entry.name),
+        }));
+    }
+    runtime(name) {
+        return this.runtimes.get(name);
+    }
+    /** Every running project, for synchronous views (the TUI panel). */
+    runningRuntimes() {
+        return [...this.runtimes.values()];
+    }
+    /** The mission text of a known project, open or closed. */
+    async mission(name) {
+        validateProjectName(name);
+        const state = await this.readState();
+        if (!state.projects.some((entry) => entry.name === name)) {
+            throw new Error(`Unknown project: ${name}`);
+        }
+        const dir = await resolveContained(this.projectsDir, name);
+        return (await readText(join(dir, ".alisio", "swarm", "mission.md"))) ?? "";
+    }
+    async newProject(input) {
+        const name = validateProjectName(input.name);
+        const mission = input.mission.trim();
+        if (!mission)
+            throw new Error("A project needs a mission");
+        if (mission.length > MAX_TASK_TEXT)
+            throw new Error("The mission is too long");
+        if (input.github !== undefined &&
+            (!githubPattern.test(input.github) || input.github.includes(".."))) {
+            throw new Error("Invalid GitHub repository: expected owner/repo");
+        }
+        const pack = input.packDefinition !== undefined
+            ? parsePack(input.packDefinition)
+            : await this.loadPack(input.pack ?? DEFAULT_PACK);
+        const state = await this.readState();
+        const dir = await resolveContained(this.projectsDir, name);
+        if (state.projects.some((entry) => entry.name === name) || existsSync(dir)) {
+            throw new Error(`Project ${name} already exists`);
+        }
+        const masterRole = entryRole(pack);
+        try {
+            if (input.github !== undefined) {
+                const url = (this.deps.cloneUrl ?? ((repo) => `https://github.com/${repo}.git`))(input.github);
+                await this.deps.isolation.cloneProject(url, dir, { masterRole });
+            }
+            else {
+                await this.deps.isolation.initProject(dir, { mission, masterRole });
+            }
+            await atomicWrite(join(dir, ".alisio", "swarm", "pack.json"), `${JSON.stringify(pack, null, 2)}\n`);
+            await atomicWrite(join(dir, ".alisio", "swarm", "mission.md"), `${mission}\n`);
+            await this.mutateState((current) => {
+                current.projects.push({
+                    name,
+                    pack: pack.name,
+                    createdAt: this.clock.now().toISOString(),
+                    open: false,
+                });
+            });
+        }
+        catch (error) {
+            await rm(dir, { recursive: true, force: true });
+            throw error;
+        }
+        return this.openProject(name);
+    }
+    async openProject(name) {
+        validateProjectName(name);
+        const existing = this.runtimes.get(name);
+        if (existing)
+            return existing;
+        const pending = this.opening.get(name);
+        if (pending)
+            return pending;
+        const work = this.doOpen(name).finally(() => this.opening.delete(name));
+        this.opening.set(name, work);
+        return work;
+    }
+    async doOpen(name) {
+        const state = await this.readState();
+        if (!state.projects.some((entry) => entry.name === name))
+            throw new Error(`Unknown project: ${name}`);
+        const dir = await resolveContained(this.projectsDir, name);
+        const raw = await readText(join(dir, ".alisio", "swarm", "pack.json"));
+        if (raw === undefined)
+            throw new Error(`Project ${name} has no pack.json`);
+        const pack = parsePack(JSON.parse(raw));
+        const meter = await this.usageMeter();
+        await this.claimPid();
+        const runtime = await ProjectRuntime.open({
+            name,
+            dir,
+            pack,
+            isolation: this.deps.isolation,
+            runner: this.deps.runner,
+            handoffs: new FsHandoffStore(dir, this.clock),
+            boards: new FsBoardStore(dir),
+            states: new FsTaskStateStore(dir),
+            clock: this.clock,
+            notifier: this.notifier,
+            maxConcurrent: this.deps.maxConcurrent ?? 3,
+            autoStart: this.deps.autoStart ?? true,
+            meter,
+            ...(this.deps.gates ? { gates: this.deps.gates } : {}),
+        });
+        this.runtimes.set(name, runtime);
+        await this.mutateState((current) => {
+            const entry = current.projects.find((candidate) => candidate.name === name);
+            if (entry)
+                entry.open = true;
+        });
+        return runtime;
+    }
+    get pidPath() {
+        return join(this.dir, "swarm.pid");
+    }
+    /** The first open project claims the pidfile; a dead previous owner is reaped and reported. */
+    async claimPid() {
+        if (this.runtimes.size > 0)
+            return;
+        const claim = await claimPidfile(this.pidPath).catch(() => ({}));
+        const notify = (message) => this.notifier.notify({ type: "error", project: "-", message });
+        if ("stale" in claim && claim.stale !== undefined) {
+            notify(`A previous swarm process (pid ${claim.stale}) ended without cleaning up; its state was replayed`);
+        }
+        else if ("other" in claim && claim.other !== undefined) {
+            notify(`Another process (pid ${claim.other}) is running this swarm forge`);
+        }
+    }
+    async releasePid() {
+        if (this.runtimes.size === 0)
+            await releasePidfile(this.pidPath).catch(() => undefined);
+    }
+    async usageMeter() {
+        this.meter ??= await UsageMeter.open({
+            file: join(this.dir, "usage.json"),
+            ...(this.deps.tokenBudget !== undefined ? { limit: this.deps.tokenBudget } : {}),
+        });
+        return this.meter;
+    }
+    /** The swarm-wide token meter (spec 8.4). */
+    budget() {
+        return {
+            total: this.meter?.total ?? 0,
+            limit: this.meter?.limit ?? this.deps.tokenBudget,
+            exceeded: this.meter?.exceeded ?? false,
+        };
+    }
+    /** Raise the soft cap and wake every pump that paused for it. */
+    async raiseBudget(extra) {
+        const meter = await this.usageMeter();
+        if (meter.limit === undefined)
+            throw new Error("No token budget is configured");
+        await meter.raise(extra);
+        for (const runtime of this.runtimes.values())
+            runtime.pump.wake();
+    }
+    /** Stop a project's agents and pump but keep it registered as open (it can be reopened). */
+    async stopProject(name) {
+        validateProjectName(name);
+        const state = await this.readState();
+        if (!state.projects.some((entry) => entry.name === name))
+            throw new Error(`Unknown project: ${name}`);
+        const runtime = this.runtimes.get(name);
+        if (!runtime)
+            return;
+        await runtime.close();
+        this.runtimes.delete(name);
+        await this.releasePid();
+    }
+    /** Stop the pump and cancel sessions. Never touches project directories. */
+    async closeProject(name) {
+        validateProjectName(name);
+        const state = await this.readState();
+        if (!state.projects.some((entry) => entry.name === name))
+            throw new Error(`Unknown project: ${name}`);
+        const runtime = this.runtimes.get(name);
+        if (runtime) {
+            await runtime.close();
+            this.runtimes.delete(name);
+            await this.releasePid();
+        }
+        await this.mutateState((current) => {
+            const entry = current.projects.find((candidate) => candidate.name === name);
+            if (entry)
+                entry.open = false;
+        });
+    }
+    /** Stop every running project (dispose, teardown). Registry flags are left as they were. */
+    async stopAll() {
+        const open = [...this.runtimes.values()];
+        this.runtimes.clear();
+        await Promise.allSettled(open.map((runtime) => runtime.close()));
+        this.deps.gates?.cancelAll?.();
+        await this.releasePid();
+    }
+}
+//# sourceMappingURL=forge.js.map

package/dist/app/forge.js.map

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

package/dist/app/operator.d.ts

@@ -0,0 +1,46 @@
+import type { Pack } from "../domain/pack.js";
+import type { TaskCard } from "../domain/task.js";
+import type { Clock } from "../ports/clock.js";
+import type { HandoffStore } from "../ports/handoff-store.js";
+import type { Isolation } from "../ports/isolation.js";
+import type { TaskStateStore } from "../ports/task-state-store.js";
+import type { Pump } from "./pump.js";
+/** What the operator actions need from their project (implemented by `ProjectRuntime`). */
+export interface OperatorHost {
+    readonly name: string;
+    readonly dir: string;
+    readonly pack: Pack;
+    readonly isolation: Isolation;
+    readonly handoffs: HandoffStore;
+    readonly state: TaskStateStore;
+    readonly clock: Clock;
+    readonly pump: Pump;
+    workdir(role: string): string;
+    cardByName(name: string): TaskCard;
+    updateCard(taskId: string, patch: Partial<Pick<TaskCard, "lane" | "status" | "auditCount">>): Promise<void>;
+    removeCard(taskId: string): Promise<void>;
+}
+export type RejectAction = "retry" | "delete" | "accept";
+export declare const rejectActions: readonly RejectAction[];
+/**
+ * Human decisions on a task (approve, reject, retry, delete, accept, comments). One implementation
+ * behind the commands, the tools and the dashboard (AD-10).
+ */
+export declare class Operator {
+    private readonly host;
+    constructor(host: OperatorHost);
+    private pendingApproval;
+    approve(name: string): Promise<void>;
+    reject(name: string, action: RejectAction, comments?: string): Promise<void>;
+    /** Retry: snapshot the rejected commit, restore the base, count the audit and re-run the role. */
+    private retryRejected;
+    /** Retry a held task (blocked, gate-failed or clarifying) with a fresh allowance. */
+    retry(name: string): Promise<void>;
+    /** Accept the work as it is: an approval gate or a gate failure the operator overrides. */
+    accept(name: string): Promise<void>;
+    /** Delete: archive the task, then remove its card, handoffs and state. */
+    delete(name: string): Promise<void>;
+    addComment(name: string, doc: string, text: string): Promise<void>;
+    clearComments(name: string): Promise<void>;
+}
+//# sourceMappingURL=operator.d.ts.map

package/dist/app/operator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator.d.ts","sourceRoot":"","sources":["../../src/app/operator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAGnE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,2FAA2F;AAC3F,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACnC,UAAU,CACR,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,YAAY,CAAC,CAAC,GAC/D,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C;AAED,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AACzD,eAAO,MAAM,aAAa,EAAE,SAAS,YAAY,EAAkC,CAAC;AAEpF;;;GAGG;AACH,qBAAa,QAAQ;IACP,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAjC,YAA6B,IAAI,EAAE,YAAY,EAAI;YAErC,eAAe;IAUvB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWzC;IAEK,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,SAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAc7E;IAED,kGAAkG;YACpF,aAAa;IAuD3B,qFAAqF;IAC/E,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGvC;IAED,2FAA2F;IACrF,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIxC;IAED,0EAA0E;IACpE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BxC;IAEK,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBvE;IAEK,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAO/C;CACF"}

package/dist/app/operator.js

@@ -0,0 +1,168 @@
+import { randomUUID } from "node:crypto";
+import { join } from "node:path";
+import { PHANTOM_SENDER } from "../domain/handoff.js";
+import { MAX_HOLD_TEXT } from "../domain/taskstate.js";
+import { assertRelativePath, atomicWrite } from "../storage.js";
+import { retryBody } from "./prompts.js";
+export const rejectActions = ["retry", "delete", "accept"];
+/**
+ * Human decisions on a task (approve, reject, retry, delete, accept, comments). One implementation
+ * behind the commands, the tools and the dashboard (AD-10).
+ */
+export class Operator {
+    host;
+    constructor(host) {
+        this.host = host;
+    }
+    async pendingApproval(card) {
+        const { records } = await this.host.handoffs.scan();
+        const record = records.find((candidate) => candidate.location.kind === "pending_approval" && candidate.handoff.taskId === card.taskId);
+        if (!record)
+            throw new Error(`Task ${card.name} is not waiting for approval`);
+        return record;
+    }
+    async approve(name) {
+        const card = this.host.cardByName(name);
+        const record = await this.pendingApproval(card);
+        const state = await this.host.state.get(card.taskId);
+        if (state && state.comments.length > 0) {
+            throw new Error(`Resolve the ${state.comments.length} comment(s) on the documents before approving, or reject the task`);
+        }
+        await this.host.pump.deliverParked(record, { approve: true });
+        this.host.pump.wake();
+    }
+    async reject(name, action, comments = "") {
+        if (!rejectActions.includes(action)) {
+            throw new Error("Reject needs one of: retry, delete, accept");
+        }
+        if (action === "delete")
+            return this.delete(name);
+        if (action === "accept") {
+            const card = this.host.cardByName(name);
+            const record = await this.pendingApproval(card);
+            await this.clearComments(name);
+            await this.host.pump.deliverParked(record, { approve: true });
+            this.host.pump.wake();
+            return;
+        }
+        return this.retryRejected(name, comments);
+    }
+    /** Retry: snapshot the rejected commit, restore the base, count the audit and re-run the role. */
+    async retryRejected(name, findings) {
+        const card = this.host.cardByName(name);
+        const record = await this.pendingApproval(card);
+        const role = record.location.role;
+        const workdir = this.host.workdir(role);
+        const state = await this.host.state.get(card.taskId);
+        const base = state?.bases[role];
+        const ref = `refs/swarm/rejected/${card.name}`;
+        if (record.handoff.commit)
+            await this.host.isolation.snapshotRef(workdir, ref, record.handoff.commit);
+        // Restoring can refuse (uncommitted changes): do it before anything is discarded.
+        if (base)
+            await this.host.isolation.restoreTo(workdir, base);
+        const { records } = await this.host.handoffs.scan();
+        const original = records
+            .filter((r) => r.handoff.taskId === card.taskId &&
+            r.handoff.type === "note" &&
+            r.handoff.from === PHANTOM_SENDER)
+            .sort((a, b) => a.handoff.createdAt.localeCompare(b.handoff.createdAt))[0];
+        const comments = state?.comments ?? [];
+        const note = {
+            id: randomUUID(),
+            from: PHANTOM_SENDER,
+            to: [role],
+            priority: record.handoff.priority,
+            type: "note",
+            task: card.name,
+            taskId: card.taskId,
+            approved: false,
+            nonForwarding: false,
+            createdAt: this.host.clock.now().toISOString(),
+            body: retryBody({
+                original: original?.handoff.body ?? `Task ${card.name}`,
+                ref,
+                findings: findings.slice(0, MAX_HOLD_TEXT),
+                comments,
+            }),
+        };
+        await this.host.handoffs.discard(record);
+        await this.host.handoffs.inject(note);
+        await this.host.state.update(card.taskId, card.name, (current) => {
+            current.rejections += 1;
+            current.comments = [];
+            current.hold = undefined;
+        });
+        await this.host.updateCard(card.taskId, {
+            lane: role,
+            status: "queued",
+            auditCount: card.auditCount + 1,
+        });
+        this.host.pump.wake();
+    }
+    /** Retry a held task (blocked, gate-failed or clarifying) with a fresh allowance. */
+    async retry(name) {
+        const card = this.host.cardByName(name);
+        await this.host.pump.releaseHold(card.taskId);
+    }
+    /** Accept the work as it is: an approval gate or a gate failure the operator overrides. */
+    async accept(name) {
+        const card = this.host.cardByName(name);
+        if (card.status === "waiting_approval")
+            return this.reject(name, "accept");
+        await this.host.pump.acceptHold(card.taskId);
+    }
+    /** Delete: archive the task, then remove its card, handoffs and state. */
+    async delete(name) {
+        const card = this.host.cardByName(name);
+        if (this.host.pump.isTaskRunning(card.taskId)) {
+            throw new Error(`Task ${card.name} is running; stop the project before deleting it`);
+        }
+        this.host.pump.forget(card.taskId);
+        const { records } = await this.host.handoffs.scan();
+        const mine = records.filter((record) => record.handoff.taskId === card.taskId);
+        await atomicWrite(join(this.host.dir, ".alisio", "swarm", "archive", `${card.taskId}.json`), `${JSON.stringify({
+            schemaVersion: 1,
+            archivedAt: this.host.clock.now().toISOString(),
+            card,
+            state: (await this.host.state.get(card.taskId)) ?? null,
+            handoffs: mine.map((record) => ({
+                location: record.location,
+                fileName: record.fileName,
+                handoff: record.handoff,
+            })),
+        }, null, 2)}\n`);
+        await this.host.handoffs.purge(card.taskId);
+        await this.host.state.remove(card.taskId);
+        await this.host.removeCard(card.taskId);
+    }
+    async addComment(name, doc, text) {
+        const card = this.host.cardByName(name);
+        if (card.status !== "waiting_approval") {
+            throw new Error(`Task ${card.name} is not waiting for approval`);
+        }
+        const path = assertRelativePath(doc);
+        const body = text.trim();
+        if (!body)
+            throw new Error("A comment needs text");
+        if (body.length > MAX_HOLD_TEXT)
+            throw new Error("The comment is too long");
+        await this.host.state.update(card.taskId, card.name, (state) => {
+            state.comments.push({
+                doc: path,
+                text: body,
+                createdAt: this.host.clock.now().toISOString(),
+            });
+        });
+    }
+    async clearComments(name) {
+        const card = this.host.cardByName(name);
+        const state = await this.host.state.get(card.taskId);
+        if (!state || state.comments.length === 0)
+            return;
+        await this.host.state.update(card.taskId, card.name, (current) => {
+            current.comments = [];
+        });
+    }
+}
+//# sourceMappingURL=operator.js.map