@alisio/plugin-swarm 0.0.0-stage → 0.1.0

package/dist/domain/identifiers.js

@@ -0,0 +1,70 @@
+/** Identifier rules (spec 4.1). Every identifier is untrusted input and validated at each boundary. */
+export const projectNamePattern = /^[a-z0-9][a-z0-9-]{0,47}$/;
+export const taskNamePattern = /^[a-z0-9][a-z0-9-]{0,47}$/;
+export const rolePattern = /^[a-z][a-z0-9-]{0,23}$/;
+export const taskIdPattern = /^\d{8}T\d{12}Z-[a-z0-9][a-z0-9-]{0,47}$/;
+export const commitPattern = /^[0-9a-f]{10}$/;
+export function validateProjectName(name) {
+    if (typeof name !== "string" || !projectNamePattern.test(name)) {
+        throw new Error("Invalid project name: use 1-48 lowercase letters, digits or hyphens, starting with a letter or digit");
+    }
+    return name;
+}
+export function validateTaskName(name) {
+    if (typeof name !== "string" || !taskNamePattern.test(name)) {
+        throw new Error("Invalid task name: use 1-48 lowercase letters, digits or hyphens, starting with a letter or digit");
+    }
+    return name;
+}
+export function validateRole(role) {
+    if (typeof role !== "string" || !rolePattern.test(role)) {
+        throw new Error("Invalid role: use 1-24 lowercase letters, digits or hyphens, starting with a letter");
+    }
+    return role;
+}
+export function validateTaskId(taskId) {
+    if (typeof taskId !== "string" || !taskIdPattern.test(taskId)) {
+        throw new Error("Invalid task id: expected YYYYMMDDTHHMMSSffffffZ-<slug>");
+    }
+    return taskId;
+}
+export function validateCommit(commit) {
+    if (typeof commit !== "string" || !commitPattern.test(commit)) {
+        throw new Error("Invalid commit: expected exactly 10 lowercase hexadecimal characters");
+    }
+    return commit;
+}
+/** Derive a task slug from free-form text. May return an empty string when nothing is usable. */
+export function slugify(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 48)
+        .replace(/-+$/g, "");
+}
+/** `YYYYMMDDTHHMMSSffffffZ-<slug>`; `sequence` (0-999) disambiguates ids minted in one millisecond. */
+export function makeTaskId(now, slug, sequence = 0) {
+    validateTaskName(slug);
+    if (!Number.isInteger(sequence) || sequence < 0 || sequence > 999) {
+        throw new Error("Invalid sequence: expected an integer from 0 to 999");
+    }
+    const iso = now.toISOString(); // 2026-01-02T03:04:05.678Z
+    const stamp = `${iso.slice(0, 4)}${iso.slice(5, 7)}${iso.slice(8, 10)}T${iso.slice(11, 13)}${iso.slice(14, 16)}${iso.slice(17, 19)}`;
+    const micros = `${iso.slice(20, 23)}${String(sequence).padStart(3, "0")}`;
+    return `${stamp}${micros}Z-${slug}`;
+}
+/** A relative path made of plain segments: no absolute, drive, backslash, empty, `.` or `..` parts. */
+export function assertRelativePath(path) {
+    if (typeof path !== "string" ||
+        !path ||
+        path.includes("\0") ||
+        path.includes("\\") ||
+        path.startsWith("/") ||
+        /^[A-Za-z]:/.test(path) ||
+        path.split("/").some((part) => part === "" || part === "." || part === "..")) {
+        throw new Error(`Unsafe relative path: ${JSON.stringify(path)}`);
+    }
+    return path;
+}
+//# sourceMappingURL=identifiers.js.map

package/dist/domain/identifiers.js.map

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

package/dist/domain/pack.d.ts

@@ -0,0 +1,45 @@
+export type Isolation = "master" | "worktree";
+export type Receive = "task" | "batch";
+export type Propagation = "forward-only" | "back-one" | "back-all";
+export declare const gateNames: readonly ["tests-green", "test-first", "coverage", "crap", "dry", "mutation", "structure", "acceptance"];
+export type GateName = (typeof gateNames)[number];
+export interface PackRole {
+    id: string;
+    agent: string;
+    isolation: Isolation;
+    receive: Receive;
+    propagation: Propagation;
+    /** Earlier role that receives this role's `blocked` findings (QA rejection routing, spec 8.4). */
+    rejectTo?: string;
+}
+export interface Thresholds {
+    coverage: number;
+    complexity: number;
+    crap: number;
+    mutation: number;
+}
+export interface Limits {
+    maxBounces: number;
+    maxAuditRounds: number;
+}
+export interface Pack {
+    schemaVersion: 1;
+    name: string;
+    description: string;
+    toolchain: string;
+    approval?: {
+        after: string;
+    };
+    roles: PackRole[];
+    parallel?: string[][];
+    gates: Record<string, GateName[]>;
+    thresholds: Thresholds;
+    limits: Limits;
+}
+/** Our defaults where upstream states none (spec 8.4). Pack data overrides them. */
+export declare const defaultThresholds: Thresholds;
+export declare const defaultLimits: Limits;
+export declare function parsePack(input: unknown): Pack;
+export declare const roleIds: (pack: Pack) => string[];
+export declare const findRole: (pack: Pack, id: string) => PackRole | undefined;
+//# sourceMappingURL=pack.d.ts.map

package/dist/domain/pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack.d.ts","sourceRoot":"","sources":["../../src/domain/pack.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;AAC9C,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AACvC,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,UAAU,GAAG,UAAU,CAAC;AAEnE,eAAO,MAAM,SAAS,YACpB,aAAa,EACb,YAAY,EACZ,UAAU,EACV,MAAM,EACN,KAAK,EACL,UAAU,EACV,WAAW,EACX,YAAY,CACJ,CAAC;AACX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAElD,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;IACzB,kGAAkG;IAClG,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,MAAM;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,IAAI;IACnB,aAAa,EAAE,CAAC,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IAClC,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,oFAAoF;AACpF,eAAO,MAAM,iBAAiB,EAAE,UAAmE,CAAC;AACpG,eAAO,MAAM,aAAa,EAAE,MAA6C,CAAC;AAuF1E,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAkH9C;AAED,eAAO,MAAM,OAAO,SAAU,IAAI,KAAG,MAAM,EAAuC,CAAC;AACnF,eAAO,MAAM,QAAQ,SAAU,IAAI,MAAM,MAAM,KAAG,QAAQ,GAAG,SAClB,CAAC"}

package/dist/domain/pack.js

@@ -0,0 +1,207 @@
+import { validateRole } from "./identifiers.js";
+export const gateNames = [
+    "tests-green",
+    "test-first",
+    "coverage",
+    "crap",
+    "dry",
+    "mutation",
+    "structure",
+    "acceptance",
+];
+/** Our defaults where upstream states none (spec 8.4). Pack data overrides them. */
+export const defaultThresholds = { coverage: 80, complexity: 6, crap: 8, mutation: 80 };
+export const defaultLimits = { maxBounces: 2, maxAuditRounds: 3 };
+const packNamePattern = /^[a-z0-9][a-z0-9-]{0,47}$/;
+const toolchainPattern = /^[a-z][a-z0-9-]{0,31}$/;
+const isRecord = (value) => Boolean(value) && typeof value === "object" && !Array.isArray(value);
+function onlyKeys(value, allowed, label) {
+    for (const key of Object.keys(value)) {
+        if (!allowed.includes(key))
+            throw new Error(`Unknown key "${key}" in ${label}`);
+    }
+}
+function parseRole(value, index) {
+    if (!isRecord(value))
+        throw new Error(`Role ${index + 1} must be an object`);
+    onlyKeys(value, ["id", "agent", "isolation", "receive", "propagation", "rejectTo"], `role ${index + 1}`);
+    const id = validateRole(value.id);
+    const agent = validateRole(value.agent);
+    if (value.isolation !== "master" && value.isolation !== "worktree") {
+        throw new Error(`Role ${id}: isolation must be "master" or "worktree"`);
+    }
+    if (value.receive !== "task" && value.receive !== "batch") {
+        throw new Error(`Role ${id}: receive must be "task" or "batch"`);
+    }
+    if (value.propagation !== "forward-only" &&
+        value.propagation !== "back-one" &&
+        value.propagation !== "back-all") {
+        throw new Error(`Role ${id}: propagation must be "forward-only", "back-one" or "back-all"`);
+    }
+    const rejectTo = value.rejectTo === undefined ? undefined : validateRole(value.rejectTo);
+    return {
+        id,
+        agent,
+        isolation: value.isolation,
+        receive: value.receive,
+        propagation: value.propagation,
+        ...(rejectTo ? { rejectTo } : {}),
+    };
+}
+function parseThresholds(value) {
+    if (value === undefined)
+        return { ...defaultThresholds };
+    if (!isRecord(value))
+        throw new Error("Invalid threshold block: expected an object");
+    onlyKeys(value, Object.keys(defaultThresholds), "thresholds");
+    const result = { ...defaultThresholds };
+    for (const key of Object.keys(defaultThresholds)) {
+        const raw = value[key];
+        if (raw === undefined)
+            continue;
+        const percent = key === "coverage" || key === "mutation";
+        if (typeof raw !== "number" ||
+            !Number.isFinite(raw) ||
+            raw < 0 ||
+            (percent && raw > 100) ||
+            (!percent && raw === 0)) {
+            throw new Error(`Invalid threshold ${key}: ${percent ? "0-100" : "a positive number"}`);
+        }
+        result[key] = raw;
+    }
+    return result;
+}
+function parseLimits(value) {
+    if (value === undefined)
+        return { ...defaultLimits };
+    if (!isRecord(value))
+        throw new Error("Invalid limit block: expected an object");
+    onlyKeys(value, Object.keys(defaultLimits), "limits");
+    const result = { ...defaultLimits };
+    for (const key of Object.keys(defaultLimits)) {
+        const raw = value[key];
+        if (raw === undefined)
+            continue;
+        if (typeof raw !== "number" || !Number.isInteger(raw) || raw < 0 || raw > 20) {
+            throw new Error(`Invalid limit ${key}: expected an integer from 0 to 20`);
+        }
+        result[key] = raw;
+    }
+    return result;
+}
+export function parsePack(input) {
+    if (!isRecord(input))
+        throw new Error("A pack must be a JSON object");
+    onlyKeys(input, [
+        "schemaVersion",
+        "name",
+        "description",
+        "toolchain",
+        "approval",
+        "roles",
+        "parallel",
+        "gates",
+        "thresholds",
+        "limits",
+    ], "pack");
+    if (input.schemaVersion !== 1)
+        throw new Error("Unsupported pack schemaVersion (expected 1)");
+    if (typeof input.name !== "string" || !packNamePattern.test(input.name)) {
+        throw new Error("Invalid pack name: use 1-48 lowercase letters, digits or hyphens");
+    }
+    if (typeof input.description !== "string" || !input.description.trim()) {
+        throw new Error("A pack needs a description");
+    }
+    if (typeof input.toolchain !== "string" || !toolchainPattern.test(input.toolchain)) {
+        throw new Error("Invalid toolchain id in pack");
+    }
+    if (!Array.isArray(input.roles) || input.roles.length === 0) {
+        throw new Error("A pack needs at least one role");
+    }
+    const roles = input.roles.map(parseRole);
+    const ids = roles.map((role) => role.id);
+    if (new Set(ids).size !== ids.length)
+        throw new Error("Duplicate role id in pack");
+    const masters = roles.filter((role) => role.isolation === "master");
+    if (masters.length !== 1)
+        throw new Error("A pack needs exactly one master role");
+    if (roles[0]?.isolation !== "master") {
+        throw new Error("The master role must be the first role (the pipeline entry)");
+    }
+    for (const [index, entry] of roles.entries()) {
+        const target = entry.rejectTo === undefined ? 0 : ids.indexOf(entry.rejectTo);
+        if (entry.rejectTo !== undefined && (target < 0 || target >= index)) {
+            throw new Error(`Role ${entry.id}: rejectTo must name an earlier role of the pack`);
+        }
+    }
+    let approval;
+    if (input.approval !== undefined) {
+        if (!isRecord(input.approval))
+            throw new Error("Invalid approval block");
+        onlyKeys(input.approval, ["after"], "approval");
+        const after = input.approval.after;
+        const position = typeof after === "string" ? ids.indexOf(after) : -1;
+        if (position < 0 || position === ids.length - 1) {
+            throw new Error("Invalid approval: `after` must name a role that is not the last role");
+        }
+        approval = { after: after };
+    }
+    const gates = {};
+    if (input.gates !== undefined) {
+        if (!isRecord(input.gates))
+            throw new Error("Invalid gates block");
+        for (const [roleId, list] of Object.entries(input.gates)) {
+            if (!ids.includes(roleId))
+                throw new Error(`Gates reference unknown role "${roleId}"`);
+            if (!Array.isArray(list))
+                throw new Error(`Gates for ${roleId} must be an array`);
+            gates[roleId] = list.map((gate) => {
+                if (!gateNames.includes(gate)) {
+                    throw new Error(`Unknown gate "${String(gate)}" for ${roleId}`);
+                }
+                return gate;
+            });
+        }
+    }
+    let parallel;
+    if (input.parallel !== undefined) {
+        if (!Array.isArray(input.parallel))
+            throw new Error("Invalid parallel stages");
+        parallel = input.parallel.map((stage) => {
+            if (!Array.isArray(stage) || stage.length < 2 || !stage.every((id) => ids.includes(id))) {
+                throw new Error("Invalid parallel stage: list two or more roles that exist in the pack");
+            }
+            const positions = stage.map((id) => ids.indexOf(id));
+            const sorted = [...positions].sort((a, b) => a - b);
+            const contiguous = sorted.every((position, i) => i === 0 || position === sorted[i - 1] + 1);
+            if (!contiguous || positions.some((p, i) => p !== sorted[i])) {
+                throw new Error("Invalid parallel stage: roles must be adjacent and in pipeline order");
+            }
+            if (stage.includes(ids[ids.length - 1])) {
+                throw new Error("Invalid parallel stage: it cannot contain the last role");
+            }
+            if (stage.includes(ids[0])) {
+                throw new Error("Invalid parallel stage: it cannot contain the master role");
+            }
+            return stage;
+        });
+        if (approval && parallel.some((stage) => stage.includes(approval?.after))) {
+            throw new Error("Invalid approval: the gate cannot sit inside a parallel stage");
+        }
+    }
+    return {
+        schemaVersion: 1,
+        name: input.name,
+        description: input.description,
+        toolchain: input.toolchain,
+        ...(approval ? { approval } : {}),
+        roles,
+        ...(parallel ? { parallel } : {}),
+        gates,
+        thresholds: parseThresholds(input.thresholds),
+        limits: parseLimits(input.limits),
+    };
+}
+export const roleIds = (pack) => pack.roles.map((role) => role.id);
+export const findRole = (pack, id) => pack.roles.find((role) => role.id === id);
+//# sourceMappingURL=pack.js.map

package/dist/domain/pack.js.map

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

package/dist/domain/pipeline.d.ts

@@ -0,0 +1,33 @@
+import { type Pack } from "./pack.js";
+export interface Route {
+    /** The single role that continues the work, absent for a terminal handoff. */
+    forward: string | undefined;
+    /** Merge-only copies (`non-forwarding: true`): receivers merge the commit and do no work. */
+    mergeOnly: string[];
+    /** The last role's handoff: broadcast merge-only to every other role; the card is Done. */
+    terminal: boolean;
+}
+export declare const entryRole: (pack: Pack) => string;
+export declare const laneOrder: (pack: Pack) => string[];
+export declare const isTerminalRole: (pack: Pack, role: string) => boolean;
+export declare const approvalRequiredAfter: (pack: Pack, role: string) => boolean;
+/** Where a handoff released by `from` goes. `from` is a role id or the phantom sender. */
+export declare function route(pack: Pack, from: string): Route;
+export interface ReleasePlan {
+    /** Recipients of the released handoff (several when a parallel stage starts). */
+    to: string[];
+    /** The parallel stage the releasing role belongs to: its handoffs wait for the join. */
+    stage?: string[];
+    terminal: boolean;
+}
+/** The parallel stage that contains `role`, if any. */
+export declare const stageOf: (pack: Pack, role: string) => string[] | undefined;
+/** The stage whose handoffs the role directly after it receives together (the join target). */
+export declare function joinSource(pack: Pack, role: string): string[] | undefined;
+/**
+ * Where a role's released handoff goes, aware of parallel stages (spec 4.2 and 8.4): the role
+ * before a stage fans out to every stage role, and a stage role hands off to the role after the
+ * stage once all stage roles are done.
+ */
+export declare function releasePlan(pack: Pack, from: string): ReleasePlan;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/domain/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/domain/pipeline.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,IAAI,EAA0B,MAAM,WAAW,CAAC;AAE9D,MAAM,WAAW,KAAK;IACpB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,6FAA6F;IAC7F,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,2FAA2F;IAC3F,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,eAAO,MAAM,SAAS,SAAU,IAAI,KAAG,MACqD,CAAC;AAE7F,eAAO,MAAM,SAAS,SAAU,IAAI,KAAG,MAAM,EAAgC,CAAC;AAE9E,eAAO,MAAM,cAAc,SAAU,IAAI,QAAQ,MAAM,KAAG,OAAyC,CAAC;AAEpG,eAAO,MAAM,qBAAqB,SAAU,IAAI,QAAQ,MAAM,KAAG,OAClC,CAAC;AAEhC,0FAA0F;AAC1F,wBAAgB,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,CAarD;AAED,MAAM,WAAW,WAAW;IAC1B,iFAAiF;IACjF,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,wFAAwF;IACxF,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,uDAAuD;AACvD,eAAO,MAAM,OAAO,SAAU,IAAI,QAAQ,MAAM,KAAG,MAAM,EAAE,GAAG,SACR,CAAC;AAEvD,+FAA+F;AAC/F,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAIzE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAYjE"}

package/dist/domain/pipeline.js

@@ -0,0 +1,50 @@
+import { PHANTOM_SENDER } from "./handoff.js";
+import { roleIds } from "./pack.js";
+export const entryRole = (pack) => (pack.roles.find((role) => role.isolation === "master") ?? pack.roles[0]).id;
+export const laneOrder = (pack) => [...roleIds(pack), "done"];
+export const isTerminalRole = (pack, role) => pack.roles.at(-1)?.id === role;
+export const approvalRequiredAfter = (pack, role) => pack.approval?.after === role;
+/** Where a handoff released by `from` goes. `from` is a role id or the phantom sender. */
+export function route(pack, from) {
+    if (from === PHANTOM_SENDER)
+        return { forward: entryRole(pack), mergeOnly: [], terminal: false };
+    const ids = roleIds(pack);
+    const index = ids.indexOf(from);
+    if (index < 0)
+        throw new Error(`Unknown role in routing: ${from}`);
+    if (isTerminalRole(pack, from)) {
+        return { forward: undefined, mergeOnly: ids.filter((id) => id !== from), terminal: true };
+    }
+    const propagation = pack.roles[index]?.propagation ?? "forward-only";
+    const earlier = ids.slice(0, index);
+    const mergeOnly = propagation === "back-all" ? earlier : propagation === "back-one" ? earlier.slice(-1) : [];
+    return { forward: ids[index + 1], mergeOnly, terminal: false };
+}
+/** The parallel stage that contains `role`, if any. */
+export const stageOf = (pack, role) => pack.parallel?.find((stage) => stage.includes(role));
+/** The stage whose handoffs the role directly after it receives together (the join target). */
+export function joinSource(pack, role) {
+    const ids = roleIds(pack);
+    const index = ids.indexOf(role);
+    return pack.parallel?.find((stage) => ids.indexOf(stage.at(-1)) === index - 1);
+}
+/**
+ * Where a role's released handoff goes, aware of parallel stages (spec 4.2 and 8.4): the role
+ * before a stage fans out to every stage role, and a stage role hands off to the role after the
+ * stage once all stage roles are done.
+ */
+export function releasePlan(pack, from) {
+    const base = route(pack, from);
+    if (base.terminal)
+        return { to: base.mergeOnly, terminal: true };
+    const ids = roleIds(pack);
+    const stage = stageOf(pack, from);
+    if (stage) {
+        const after = ids[ids.indexOf(stage.at(-1)) + 1];
+        return { to: [after], stage, terminal: false };
+    }
+    const next = base.forward;
+    const entering = pack.parallel?.find((candidate) => candidate[0] === next);
+    return { to: entering ? [...entering] : [next], terminal: false };
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/domain/pipeline.js.map

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

package/dist/domain/task.d.ts

@@ -0,0 +1,26 @@
+import { type StoredHandoff } from "./handoff.js";
+import { type Pack } from "./pack.js";
+export declare const taskStatuses: readonly ["queued", "working", "waiting_approval", "rejected", "merging", "clarifying", "blocked", "done"];
+export type TaskStatus = (typeof taskStatuses)[number];
+export interface TaskCard {
+    name: string;
+    taskId: string;
+    /** A pack role id, or `done`. */
+    lane: string;
+    status: TaskStatus;
+    createdAt: string;
+    updatedAt: string;
+    auditCount: number;
+}
+export interface Board {
+    schemaVersion: 1;
+    tasks: TaskCard[];
+}
+export declare const emptyBoard: () => Board;
+export declare function validateBoard(value: unknown): Board;
+/**
+ * Rebuild the board from handoff files (the source of truth, AD-11). Board-only statuses that files
+ * cannot express (clarifying, blocked, rejected) survive from `previous` while the lane is unchanged.
+ */
+export declare function rebuildBoard(pack: Pack, records: StoredHandoff[], previous?: Board): Board;
+//# sourceMappingURL=task.d.ts.map

package/dist/domain/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/domain/task.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,KAAK,IAAI,EAAW,MAAM,WAAW,CAAC;AAE/C,eAAO,MAAM,YAAY,YACvB,QAAQ,EACR,SAAS,EACT,kBAAkB,EAClB,UAAU,EACV,SAAS,EACT,YAAY,EACZ,SAAS,EACT,MAAM,CACE,CAAC;AACX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,KAAK;IACpB,aAAa,EAAE,CAAC,CAAC;IACjB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAKD,eAAO,MAAM,UAAU,QAAO,KAA0C,CAAC;AAOzE,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAsCnD;AAmBD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,QAAQ,CAAC,EAAE,KAAK,GAAG,KAAK,CAkF1F"}

package/dist/domain/task.js

@@ -0,0 +1,154 @@
+import { PHANTOM_SENDER, parseHandoffFileName, } from "./handoff.js";
+import { validateRole, validateTaskId, validateTaskName } from "./identifiers.js";
+import { roleIds } from "./pack.js";
+export const taskStatuses = [
+    "queued",
+    "working",
+    "waiting_approval",
+    "rejected",
+    "merging",
+    "clarifying",
+    "blocked",
+    "done",
+];
+/** Statuses only the coordinator knows: handoff files cannot express them. */
+const boardOnlyStatuses = ["clarifying", "blocked", "rejected"];
+export const emptyBoard = () => ({ schemaVersion: 1, tasks: [] });
+const isRecord = (value) => Boolean(value) && typeof value === "object" && !Array.isArray(value);
+const isIso = (value) => typeof value === "string" && !Number.isNaN(Date.parse(value));
+export function validateBoard(value) {
+    if (!isRecord(value))
+        throw new Error("Invalid board: expected an object");
+    if (value.schemaVersion !== 1)
+        throw new Error("Unsupported board schemaVersion (expected 1)");
+    if (!Array.isArray(value.tasks))
+        throw new Error("Invalid board: tasks must be an array");
+    const seen = new Set();
+    const tasks = value.tasks.map((raw) => {
+        if (!isRecord(raw))
+            throw new Error("Invalid task card: expected an object");
+        validateTaskName(raw.name);
+        validateTaskId(raw.taskId);
+        if (raw.lane !== "done") {
+            try {
+                validateRole(raw.lane);
+            }
+            catch {
+                throw new Error("Invalid lane on task card");
+            }
+        }
+        if (!taskStatuses.includes(raw.status)) {
+            throw new Error(`Invalid status on task card: ${String(raw.status)}`);
+        }
+        if (!isIso(raw.createdAt) || !isIso(raw.updatedAt)) {
+            throw new Error("Invalid timestamps on task card");
+        }
+        if (!Number.isInteger(raw.auditCount) || raw.auditCount < 0) {
+            throw new Error("Invalid auditCount on task card");
+        }
+        if (seen.has(raw.taskId))
+            throw new Error("Duplicate task id on board");
+        seen.add(raw.taskId);
+        return {
+            name: raw.name,
+            taskId: raw.taskId,
+            lane: raw.lane,
+            status: raw.status,
+            createdAt: raw.createdAt,
+            updatedAt: raw.updatedAt,
+            auditCount: raw.auditCount,
+        };
+    });
+    return { schemaVersion: 1, tasks };
+}
+const stampOf = (record) => record.handoff.completedAt ??
+    record.handoff.dequeuedAt ??
+    record.handoff.enqueuedAt ??
+    record.handoff.createdAt;
+const seqOf = (record) => parseHandoffFileName(record.fileName)?.seq ?? 0;
+const byAge = (a, b) => a.handoff.createdAt.localeCompare(b.handoff.createdAt) || seqOf(a) - seqOf(b);
+const inFlight = (kind) => kind === "audit_pending" ||
+    kind === "pending_approval" ||
+    kind === "join_pending" ||
+    kind === "failed";
+/**
+ * Rebuild the board from handoff files (the source of truth, AD-11). Board-only statuses that files
+ * cannot express (clarifying, blocked, rejected) survive from `previous` while the lane is unchanged.
+ */
+export function rebuildBoard(pack, records, previous) {
+    const roles = roleIds(pack);
+    const last = roles.at(-1);
+    const byTask = new Map();
+    for (const record of records) {
+        const list = byTask.get(record.handoff.taskId) ?? [];
+        list.push(record);
+        byTask.set(record.handoff.taskId, list);
+    }
+    const cards = [];
+    for (const [taskId, list] of byTask) {
+        list.sort(byAge);
+        const first = list[0];
+        const released = list.filter((r) => r.handoff.type === "git_handoff" &&
+            r.handoff.from !== PHANTOM_SENDER &&
+            !inFlight(r.location.kind));
+        const auditCount = new Set(released.map((r) => `${r.handoff.from}:${r.handoff.commit}`)).size;
+        const finished = released.some((r) => r.handoff.from === last);
+        const forwarding = list.filter((r) => (!r.handoff.nonForwarding || inFlight(r.location.kind)) &&
+            r.handoff.to.every((role) => roles.includes(role)));
+        const latest = forwarding.at(-1);
+        let lane;
+        let status;
+        if (finished) {
+            lane = "done";
+            status = "done";
+        }
+        else if (!latest) {
+            // Only parked terminal/merge-only copies exist: the owner is the sender still auditing.
+            const parked = list.filter((r) => inFlight(r.location.kind)).at(-1) ?? first;
+            lane = roles.includes(parked.handoff.from) ? parked.handoff.from : roles[0];
+            status = "working";
+        }
+        else {
+            const location = latest.location;
+            const sender = latest.handoff.from;
+            const target = latest.handoff.to[0];
+            if (location.kind === "audit_pending" || location.kind === "join_pending") {
+                lane = roles.includes(sender) ? sender : target;
+                status = "working";
+            }
+            else if (location.kind === "pending_approval") {
+                lane = roles.includes(sender) ? sender : target;
+                status = "waiting_approval";
+            }
+            else if (location.kind === "failed") {
+                lane = roles.includes(sender) ? sender : target;
+                status = "blocked";
+            }
+            else {
+                lane = target;
+                const copy = list.find((r) => r.handoff.id === latest.handoff.id &&
+                    r.location.kind === "inbox" &&
+                    r.location.role === target);
+                const box = copy?.location.kind === "inbox" ? copy.location.box : "new";
+                status = box === "new" ? "queued" : "working";
+            }
+        }
+        const before = previous?.tasks.find((card) => card.taskId === taskId);
+        if (before && before.lane === lane && boardOnlyStatuses.includes(before.status) && !finished) {
+            status = before.status;
+        }
+        const newest = list.reduce((acc, r) => (stampOf(r) > acc ? stampOf(r) : acc), first.handoff.createdAt);
+        cards.push({
+            name: first.handoff.task,
+            taskId,
+            lane,
+            status,
+            createdAt: first.handoff.createdAt,
+            updatedAt: before && before.updatedAt > newest ? before.updatedAt : newest,
+            auditCount: Math.max(auditCount, before?.lane === lane ? before.auditCount : 0),
+        });
+    }
+    cards.sort((a, b) => a.createdAt.localeCompare(b.createdAt) || a.taskId.localeCompare(b.taskId));
+    return { schemaVersion: 1, tasks: cards };
+}
+//# sourceMappingURL=task.js.map