@alisio/plugin-swarm 0.0.0-stage → 0.1.0

package/dist/app/budget.js

@@ -0,0 +1,78 @@
+import { atomicWrite, readText } from "../storage.js";
+/**
+ * Swarm-wide token meter (spec 8.4). The budget is a soft cap: crossing it pauses the pumps from
+ * starting new runs and raises a decision; runs already in flight finish. Persisted so a restart
+ * does not reset the spend.
+ */
+export class UsageMeter {
+    file;
+    base;
+    data;
+    constructor(file, base, data) {
+        this.file = file;
+        this.base = base;
+        this.data = data;
+    }
+    static async open(options) {
+        let data = { schemaVersion: 1, total: 0, raisedBy: 0 };
+        const raw = await readText(options.file);
+        if (raw !== undefined) {
+            try {
+                const parsed = JSON.parse(raw);
+                if (parsed.schemaVersion === 1 &&
+                    Number.isFinite(parsed.total) &&
+                    Number.isFinite(parsed.raisedBy)) {
+                    data = parsed;
+                }
+            }
+            catch {
+                // A corrupt meter starts from zero: it only guards cost, never correctness.
+            }
+        }
+        return new UsageMeter(options.file, options.limit, data);
+    }
+    get total() {
+        return this.data.total;
+    }
+    /** Effective limit including raises, or `undefined` when unlimited. */
+    get limit() {
+        return this.base === undefined ? undefined : this.base + this.data.raisedBy;
+    }
+    get exceeded() {
+        const limit = this.limit;
+        return limit !== undefined && this.data.total >= limit;
+    }
+    save() {
+        return atomicWrite(this.file, `${JSON.stringify(this.data, null, 2)}\n`);
+    }
+    /** Add spent tokens. Returns true exactly when this call crossed the limit. */
+    async record(tokens) {
+        if (!Number.isFinite(tokens) || tokens <= 0)
+            return false;
+        const before = this.exceeded;
+        this.data = { ...this.data, total: this.data.total + Math.round(tokens) };
+        await this.save();
+        return !before && this.exceeded;
+    }
+    async raise(extra) {
+        if (!Number.isFinite(extra) || extra <= 0)
+            throw new Error("The extra budget must be a positive number");
+        this.data = { ...this.data, raisedBy: this.data.raisedBy + Math.round(extra) };
+        await this.save();
+    }
+}
+/** The decision item raised while the soft cap is exceeded. */
+export function budgetAttention(project, meter, createdAt) {
+    if (!meter?.exceeded)
+        return undefined;
+    return {
+        id: `decision:${project}:budget`,
+        kind: "decision",
+        project,
+        task: "budget",
+        createdAt,
+        actions: ["raise", "stop"],
+        detail: `The token budget of ${meter.limit} is reached (${meter.total} used); no new agent runs start until you raise it`,
+    };
+}
+//# sourceMappingURL=budget.js.map

package/dist/app/budget.js.map

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

package/dist/app/chat-store.d.ts

@@ -0,0 +1,18 @@
+export declare const MAX_CHAT_HISTORY = 100;
+export interface ChatMessage {
+    from: "operator" | "lieutenant";
+    text: string;
+    at: string;
+}
+/**
+ * The persisted Lieutenant conversation of one project: a bounded, schema-versioned file under
+ * `.alisio/swarm/chat.json`. History is a convenience, so a corrupt file reads as empty.
+ */
+export declare class ChatStore {
+    private readonly file;
+    private readonly lock;
+    constructor(projectDir: string);
+    read(): Promise<ChatMessage[]>;
+    append(...messages: ChatMessage[]): Promise<void>;
+}
+//# sourceMappingURL=chat-store.d.ts.map

package/dist/app/chat-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-store.d.ts","sourceRoot":"","sources":["../../src/app/chat-store.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAGpC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,UAAU,GAAG,YAAY,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAcD;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;IAEpC,YAAY,UAAU,EAAE,MAAM,EAE7B;IAEK,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAUnC;IAED,MAAM,CAAC,GAAG,QAAQ,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAQhD;CACF"}

package/dist/app/chat-store.js

@@ -0,0 +1,48 @@
+import { join } from "node:path";
+import { atomicWrite, Mutex, readText } from "../storage.js";
+export const MAX_CHAT_HISTORY = 100;
+const MAX_CHAT_TEXT = 8000;
+const isMessage = (value) => {
+    const record = value;
+    return (Boolean(record) &&
+        typeof record === "object" &&
+        (record?.from === "operator" || record?.from === "lieutenant") &&
+        typeof record.text === "string" &&
+        typeof record.at === "string" &&
+        !Number.isNaN(Date.parse(record.at)));
+};
+/**
+ * The persisted Lieutenant conversation of one project: a bounded, schema-versioned file under
+ * `.alisio/swarm/chat.json`. History is a convenience, so a corrupt file reads as empty.
+ */
+export class ChatStore {
+    file;
+    lock = new Mutex();
+    constructor(projectDir) {
+        this.file = join(projectDir, ".alisio", "swarm", "chat.json");
+    }
+    async read() {
+        const raw = await readText(this.file);
+        if (raw === undefined)
+            return [];
+        try {
+            const parsed = JSON.parse(raw);
+            if (parsed.schemaVersion !== 1 || !Array.isArray(parsed.messages))
+                return [];
+            return parsed.messages.filter(isMessage).map((entry) => ({ ...entry }));
+        }
+        catch {
+            return [];
+        }
+    }
+    append(...messages) {
+        return this.lock.run(async () => {
+            const next = [
+                ...(await this.read()),
+                ...messages.map((entry) => ({ ...entry, text: entry.text.slice(0, MAX_CHAT_TEXT) })),
+            ].slice(-MAX_CHAT_HISTORY);
+            await atomicWrite(this.file, `${JSON.stringify({ schemaVersion: 1, messages: next })}\n`);
+        });
+    }
+}
+//# sourceMappingURL=chat-store.js.map

package/dist/app/chat-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-store.js","sourceRoot":"","sources":["../../src/app/chat-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE7D,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AACpC,MAAM,aAAa,GAAG,IAAI,CAAC;AAQ3B,MAAM,SAAS,GAAG,CAAC,KAAc,EAAwB,EAAE;IACzD,MAAM,MAAM,GAAG,KAAuC,CAAC;IACvD,OAAO,CACL,OAAO,CAAC,MAAM,CAAC;QACf,OAAO,MAAM,KAAK,QAAQ;QAC1B,CAAC,MAAM,EAAE,IAAI,KAAK,UAAU,IAAI,MAAM,EAAE,IAAI,KAAK,YAAY,CAAC;QAC9D,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;QAC/B,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ;QAC7B,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CACrC,CAAC;AACJ,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,OAAO,SAAS;IACH,IAAI,CAAS;IACb,IAAI,GAAG,IAAI,KAAK,EAAE,CAAC;IAEpC,YAAY,UAAkB;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAoD,CAAC;YAClF,IAAI,MAAM,CAAC,aAAa,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;gBAAE,OAAO,EAAE,CAAC;YAC7E,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;QAC1E,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,MAAM,CAAC,GAAG,QAAuB;QAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;YAC9B,MAAM,IAAI,GAAG;gBACX,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;gBACtB,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC;aACrF,CAAC,KAAK,CAAC,CAAC,gBAAgB,CAAC,CAAC;YAC3B,MAAM,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC;QAC5F,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/app/documents.d.ts

@@ -0,0 +1,33 @@
+import type { ApprovalComment } from "../domain/taskstate.js";
+import type { ProjectRuntime } from "./project.js";
+export declare const MAX_DOC_BYTES: number;
+export declare const MAX_DIFF_BYTES: number;
+export interface DocumentEntry {
+    path: string;
+    text: string;
+    truncated: boolean;
+    comments: ApprovalComment[];
+}
+/** What the Documents dialog shows for a task waiting at the approval gate. */
+export interface DocumentsView {
+    project: string;
+    task: string;
+    /** The role that owns the gate. */
+    role: string;
+    /** Head of that role when it started the task, when known. */
+    base?: string;
+    /** The held commit. */
+    commit: string;
+    docs: DocumentEntry[];
+    diff: string;
+    diffTruncated: boolean;
+    comments: ApprovalComment[];
+    /** Approve is disabled while comments exist (spec 8.3). */
+    approvable: boolean;
+}
+/**
+ * Task documents and the diff from the gate role's base to the held commit. Everything is read
+ * from the git object store at the held commit, so no path can leave the repository.
+ */
+export declare function buildDocuments(runtime: ProjectRuntime, taskName: string): Promise<DocumentsView>;
+//# sourceMappingURL=documents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/app/documents.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,eAAO,MAAM,aAAa,QAAY,CAAC;AACvC,eAAO,MAAM,cAAc,QAAa,CAAC;AAGzC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,+EAA+E;AAC/E,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,aAAa,EAAE,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,2DAA2D;IAC3D,UAAU,EAAE,OAAO,CAAC;CACrB;AAQD;;;GAGG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,CAAC,CA+CxB"}

package/dist/app/documents.js

@@ -0,0 +1,63 @@
+import { assertRelativePath } from "../domain/identifiers.js";
+export const MAX_DOC_BYTES = 64 * 1024;
+export const MAX_DIFF_BYTES = 256 * 1024;
+const MAX_DOCS = 20;
+const isDocument = (path) => /(^|\/)(specs|tasks|features|docs)\//.test(path) || /\.(feature|md)$/.test(path);
+const clip = (text, max) => text.length > max ? { text: text.slice(0, max), truncated: true } : { text, truncated: false };
+/**
+ * Task documents and the diff from the gate role's base to the held commit. Everything is read
+ * from the git object store at the held commit, so no path can leave the repository.
+ */
+export async function buildDocuments(runtime, taskName) {
+    const held = await runtime.heldApproval(taskName);
+    const role = held.location.kind === "pending_approval" ? held.location.role : undefined;
+    const commit = held.handoff.commit;
+    if (!role || !commit)
+        throw new Error(`Task ${taskName} has no held commit to review`);
+    const card = runtime.cardByName(taskName);
+    const base = (await runtime.state.get(card.taskId))?.bases[role];
+    const workdir = runtime.workdir(role);
+    const changed = await runtime.isolation.changedFiles(workdir, base, commit);
+    const paths = [];
+    for (const path of [...changed.filter(isDocument), `tasks/${taskName}.md`]) {
+        try {
+            assertRelativePath(path);
+        }
+        catch {
+            continue;
+        }
+        if (!paths.includes(path) && paths.length < MAX_DOCS)
+            paths.push(path);
+    }
+    const comments = runtime.comments(taskName);
+    const docs = [];
+    for (const path of paths) {
+        const content = await runtime.isolation
+            .readFileAt(workdir, commit, path)
+            .catch(() => undefined);
+        if (content === undefined)
+            continue;
+        docs.push({
+            path,
+            ...clip(content, MAX_DOC_BYTES),
+            comments: comments.filter((comment) => comment.doc === path),
+        });
+    }
+    const rawDiff = await runtime.isolation
+        .diff(workdir, base, commit)
+        .catch(() => "The diff is too large or could not be produced.");
+    const diff = clip(rawDiff, MAX_DIFF_BYTES);
+    return {
+        project: runtime.name,
+        task: taskName,
+        role,
+        ...(base ? { base } : {}),
+        commit,
+        docs,
+        diff: diff.text,
+        diffTruncated: diff.truncated,
+        comments,
+        approvable: comments.length === 0,
+    };
+}
+//# sourceMappingURL=documents.js.map

package/dist/app/documents.js.map

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

package/dist/app/forge.d.ts

@@ -0,0 +1,106 @@
+import { type Pack } from "../domain/pack.js";
+import type { AgentRunner } from "../ports/agent-runner.js";
+import { type Clock } from "../ports/clock.js";
+import type { GateRunner } from "../ports/gate-runner.js";
+import type { Isolation } from "../ports/isolation.js";
+import { type Notifier } from "../ports/notifier.js";
+import type { ProjectSnapshot } from "../status.js";
+import { ProjectRuntime } from "./project.js";
+export interface ForgeDeps {
+    /** The workspace root: the forge lives under `<workspace>/.alisio/swarm`. */
+    workspace: string;
+    isolation: Isolation;
+    runner: AgentRunner;
+    clock?: Clock;
+    notifier?: Notifier;
+    /** Quality gates enforced by the pump after each role; absent means packs run ungated. */
+    gates?: GateRunner;
+    /** Soft cap on total tokens across the swarm (`options.tokenBudget`); absent means unlimited. */
+    tokenBudget?: number;
+    cloneUrl?: (repo: string) => string;
+    maxConcurrent?: number;
+    /** Start the background pump of opened projects (default true). Tests drive `drain()` instead. */
+    autoStart?: boolean;
+}
+export interface PackInfo {
+    name: string;
+    description: string;
+    roles: string[];
+    source: "shipped" | "workspace";
+}
+export interface ProjectInfo {
+    name: string;
+    pack: string;
+    open: boolean;
+    running: boolean;
+}
+export interface NewProjectInput {
+    name: string;
+    pack?: string;
+    mission: string;
+    /** `owner/repo`: clone instead of `git init`. */
+    github?: string;
+    /** An edited pack definition (validated like any pack) used instead of the named pack. */
+    packDefinition?: unknown;
+}
+export declare const DEFAULT_PACK = "two-pack";
+/** The forge: `<workspace>/.alisio/swarm` with its projects, packs and open runtimes. */
+export declare class Forge {
+    private readonly deps;
+    readonly dir: string;
+    private readonly clock;
+    private readonly notifier;
+    private readonly runtimes;
+    private readonly opening;
+    private readonly stateLock;
+    private meter;
+    constructor(deps: ForgeDeps);
+    private get statePath();
+    private get projectsDir();
+    private get packsDir();
+    init(): Promise<{
+        created: boolean;
+    }>;
+    private readState;
+    private mutateState;
+    private scanLocalPacks;
+    invalidPacks(): Promise<Array<{
+        file: string;
+        error: string;
+    }>>;
+    listPacks(): Promise<PackInfo[]>;
+    /** A workspace-local pack shadows a shipped pack of the same name. */
+    loadPack(name: string): Promise<Pack>;
+    isInitialised(): Promise<boolean>;
+    /** Everything the status views need, including closed projects (read from their files). */
+    snapshot(only?: string): Promise<ProjectSnapshot[]>;
+    listProjects(): Promise<ProjectInfo[]>;
+    runtime(name: string): ProjectRuntime | undefined;
+    /** Every running project, for synchronous views (the TUI panel). */
+    runningRuntimes(): ProjectRuntime[];
+    /** The mission text of a known project, open or closed. */
+    mission(name: string): Promise<string>;
+    newProject(input: NewProjectInput): Promise<ProjectRuntime>;
+    openProject(name: string): Promise<ProjectRuntime>;
+    private doOpen;
+    private get pidPath();
+    /** The first open project claims the pidfile; a dead previous owner is reaped and reported. */
+    private claimPid;
+    private releasePid;
+    private usageMeter;
+    /** The swarm-wide token meter (spec 8.4). */
+    budget(): {
+        total: number;
+        limit: number | undefined;
+        exceeded: boolean;
+    };
+    /** Raise the soft cap and wake every pump that paused for it. */
+    raiseBudget(extra: number): Promise<void>;
+    /** Stop a project's agents and pump but keep it registered as open (it can be reopened). */
+    stopProject(name: string): Promise<void>;
+    /** Stop the pump and cancel sessions. Never touches project directories. */
+    closeProject(name: string): Promise<void>;
+    /** Stop every running project (dispose, teardown). Registry flags are left as they were. */
+    stopAll(): Promise<void>;
+}
+//# sourceMappingURL=forge.d.ts.map

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

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