@mclawnet/swarm 0.1.13 → 0.1.14

package/dist/always-on/workcycle-runner.js

@@ -0,0 +1,285 @@
+// WorkCycleRunner — M7.1 bridge between DiscoveryScheduler and the existing
+// swarm/worktree/shipment pipeline.
+//
+// Responsibilities (kept deliberately small):
+//   1. Pull the next task via an injected `pickNextTask` callback (TaskStore
+//      lives in the agent package; we stay decoupled via DI).
+//   2. Create a single-cycle synthetic swarm via SwarmCoordinator.create with
+//      a stable `m7-cycle-<uuid>` swarmId prefix so the UI / persisted history
+//      can identify scheduler-spawned swarms later.
+//   3. Wait for the swarm to reach a terminal state (or timeout) by polling
+//      coordinator.getSwarm().status.
+//   4. Load the persisted ShipmentResult and return a structured
+//      WorkCycleResult to the caller (typically DiscoveryScheduler.onFire).
+//
+// Best-effort: every failure path is captured in the returned `error` field;
+// run() never throws — a thrown runner would crash the DiscoveryScheduler tick
+// loop, defeating the purpose of always-on.
+import { randomUUID } from "node:crypto";
+import { createLogger } from "@mclawnet/logger";
+import { loadShipmentResult } from "../persistence.js";
+/** Template the runner picks when TaskRef.cycleKind === "research" (M8.1). */
+const RESEARCH_TEMPLATE_NAME = "research-only";
+const DEFAULT_POLL_TIMEOUT_MS = 30 * 60 * 1000;
+const DEFAULT_POLL_INTERVAL_MS = 5_000;
+const DEFAULT_INITIAL_SETTLE_MS = 5_000;
+const moduleLog = createLogger({ module: "swarm" });
+/** Real-clock sleep. Replaced in tests via opts.sleep. */
+function defaultSleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export class WorkCycleRunner {
+    pickNextTask;
+    resolveTaskSource;
+    coordinator;
+    log;
+    pollTimeoutMs;
+    pollIntervalMs;
+    initialSettleMs;
+    sleep;
+    constructor(opts) {
+        this.pickNextTask = opts.pickNextTask;
+        if (opts.resolveTaskSource)
+            this.resolveTaskSource = opts.resolveTaskSource;
+        this.coordinator = opts.swarmCoordinator;
+        this.log = opts.log ?? moduleLog;
+        this.pollTimeoutMs = opts.pollTimeoutMs ?? DEFAULT_POLL_TIMEOUT_MS;
+        this.pollIntervalMs = opts.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+        this.initialSettleMs = opts.initialSettleMs ?? DEFAULT_INITIAL_SETTLE_MS;
+        this.sleep = opts.sleep ?? defaultSleep;
+    }
+    /**
+     * Run one work cycle. Never throws — every failure is folded into the
+     * returned WorkCycleResult so DiscoveryScheduler.onFire can stay shape-
+     * stable across success and failure paths.
+     */
+    async run(input) {
+        const cycleId = randomUUID();
+        // Match the spec: prefix lets UI/persisted history identify scheduler-
+        // spawned swarms (vs. user-driven ones in M6.x flows).
+        const swarmId = `m7-cycle-${cycleId}`;
+        const startedAt = new Date().toISOString();
+        // 1. Pick a task — null means "nothing to do this cycle".
+        let task;
+        try {
+            task = await this.pickNextTask(input.projectRoot);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            this.log.warn({ err: msg, cycleId }, "pickNextTask threw — skipping cycle");
+            return {
+                cycleId,
+                swarmId,
+                taskRef: null,
+                status: "skipped",
+                error: `pickNextTask failed: ${msg}`,
+                startedAt,
+                endedAt: new Date().toISOString(),
+            };
+        }
+        if (!task) {
+            this.log.info({ cycleId, projectRoot: input.projectRoot }, "no task available — skipping cycle");
+            return {
+                cycleId,
+                swarmId,
+                taskRef: null,
+                status: "skipped",
+                error: "no task available",
+                startedAt,
+                endedAt: new Date().toISOString(),
+            };
+        }
+        // Resolve the source that produced this task so we can drive its
+        // onClaim / onSuccess / onFailure lifecycle. Null when the runner is
+        // running in legacy M7 single-source mode (no cascade picker injected).
+        const source = this.resolveTaskSource ? this.resolveTaskSource(task) : null;
+        // 2. Spawn the swarm.
+        // M8.1: research cycles override the default template so the worker
+        // operates under read-mostly + markdown-only constraints (see
+        // packages/@clawnet/swarm/templates/research-only.md). The override is
+        // task-driven, not config-driven — the same project can flip between
+        // execute (TaskStore / IdeaTodoSource) and research (IdeaResearchSource)
+        // cycles without an always-on.json edit.
+        const templateName = task.cycleKind === "research" ? RESEARCH_TEMPLATE_NAME : input.templateName ?? "minimal";
+        try {
+            await this.coordinator.create(swarmId, {
+                workDir: input.projectRoot,
+                templateName,
+                task: task.description ?? task.title,
+                kind: "always-on-cycle",
+            });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            this.log.warn({ err: msg, cycleId, swarmId }, "coordinator.create failed");
+            // Even though we never spawned, give the source a chance to clean up
+            // any optimistic state (it didn't claim yet, so onFailure is the right
+            // signal). Best-effort.
+            await this.invokeHook(source, "onFailure", task, swarmId, msg);
+            return {
+                cycleId,
+                swarmId,
+                taskRef: task,
+                status: "failed",
+                error: `coordinator.create failed: ${msg}`,
+                startedAt,
+                endedAt: new Date().toISOString(),
+            };
+        }
+        // Source has now "claimed" the task — let it record the in-flight state
+        // (IdeaTodoSource PATCHes the idea to researching + linkedSwarmTaskId).
+        await this.invokeHook(source, "onClaim", task, swarmId);
+        this.log.info({ cycleId, swarmId, taskId: task.id, taskTitle: task.title, source: source?.name ?? null }, "work cycle: swarm spawned, awaiting terminal state");
+        // 3. Wait for terminal state (polling). Best-effort — timeout cancels.
+        const waitResult = await this.waitForTerminal(swarmId);
+        // 4. Load shipment regardless of outcome — it's the artifact M6.2 UI uses
+        //    and may exist even on failure (partial work). Best-effort.
+        let shipment;
+        try {
+            const loaded = loadShipmentResult(input.projectRoot, swarmId);
+            if (loaded)
+                shipment = loaded;
+        }
+        catch (err) {
+            this.log.warn({ err: err instanceof Error ? err.message : String(err), cycleId, swarmId }, "loadShipmentResult failed (best-effort)");
+        }
+        // 5. Drive source lifecycle hooks based on the terminal outcome. Per the
+        //    M8.0 design contract: success = swarm completed AND shipment
+        //    actually landed (strategy !== "skipped"); everything else is a
+        //    failure path and the source should clean up (IdeaTodoSource
+        //    reverts status=todo so the cycle can retry).
+        const hookKind = waitResult.status === "completed" && shipment && shipment.strategy !== "skipped"
+            ? "onSuccess"
+            : "onFailure";
+        const hookError = hookKind === "onFailure"
+            ? waitResult.error ?? shipment?.error ?? `shipment strategy=${shipment?.strategy ?? "none"}`
+            : undefined;
+        await this.invokeHook(source, hookKind, task, swarmId, hookError);
+        return {
+            cycleId,
+            swarmId,
+            taskRef: task,
+            status: waitResult.status,
+            ...(shipment ? { shipment } : {}),
+            ...(waitResult.error ? { error: waitResult.error } : {}),
+            startedAt,
+            endedAt: new Date().toISOString(),
+        };
+    }
+    /**
+     * Best-effort invocation of a source lifecycle hook. Swallows the source's
+     * exceptions so a misbehaving hook never crashes the runner — the cycle
+     * already reached its terminal state and the result is locked in.
+     */
+    async invokeHook(source, kind, taskRef, swarmId, error) {
+        if (!source)
+            return;
+        const fn = source[kind];
+        if (typeof fn !== "function")
+            return;
+        try {
+            if (kind === "onFailure") {
+                await source.onFailure(taskRef, swarmId, error);
+            }
+            else if (kind === "onSuccess") {
+                await source.onSuccess(taskRef, swarmId);
+            }
+            else {
+                await source.onClaim(taskRef, swarmId);
+            }
+        }
+        catch (err) {
+            this.log.warn({
+                err: err instanceof Error ? err.message : String(err),
+                source: source.name,
+                hook: kind,
+                swarmId,
+                taskId: taskRef.id,
+            }, "task-source hook threw (best-effort)");
+        }
+    }
+    /**
+     * Poll coordinator.getSwarm(swarmId) until the swarm enters a terminal
+     * state or the swarm is removed from the registry (cleanup already ran).
+     *
+     * Returns {status, error?} so the caller can build the full result.
+     * Status interpretation:
+     *   - "completed" → swarm.status flipped to completed (we then call
+     *     coordinator.complete to release resources if it's still in the map)
+     *   - "failed" → swarm.status flipped to failed (we then call .fail)
+     *   - "completed" (gone from map) → cleanup already happened externally;
+     *     treat as completed without re-calling complete()
+     *   - "failed" (timeout exceeded) → cancel via destroy and return failed
+     */
+    async waitForTerminal(swarmId) {
+        // Initial settle so we don't hammer the coordinator immediately after create.
+        if (this.initialSettleMs > 0) {
+            await this.sleep(this.initialSettleMs);
+        }
+        // PR-B D12 — no deadline. Loop until coordinator state turns terminal
+        // (completed/failed/cancelled) or paused (D14 → runner promotes to
+        // completed). pollTimeoutMs option kept for back-compat but unused;
+        // callers (always-on-manager) no longer pass it.
+        // eslint-disable-next-line no-constant-condition
+        while (true) {
+            const swarm = this.coordinator.getSwarm(swarmId);
+            if (!swarm) {
+                // Swarm was already cleaned up (e.g. complete() was called externally
+                // and runRetroAndCleanup removed it from the map). Treat as completed
+                // — the shipment.json on disk is the source of truth.
+                this.log.info({ swarmId }, "swarm no longer in registry — treating as completed");
+                return { status: "completed" };
+            }
+            if (swarm.status === "completed") {
+                // Best-effort: ensure cleanup runs so shipment writeback + memory sync
+                // happen. complete() is idempotent (no-op if not present).
+                try {
+                    await this.coordinator.complete(swarmId);
+                }
+                catch (err) {
+                    this.log.warn({ err: err instanceof Error ? err.message : String(err), swarmId }, "coordinator.complete failed (best-effort)");
+                }
+                return { status: "completed" };
+            }
+            if (swarm.status === "failed") {
+                try {
+                    await this.coordinator.fail(swarmId);
+                }
+                catch (err) {
+                    this.log.warn({ err: err instanceof Error ? err.message : String(err), swarmId }, "coordinator.fail failed (best-effort)");
+                }
+                return { status: "failed" };
+            }
+            if (swarm.status === "cancelled") {
+                // External cancel — treat as failed (the cycle didn't produce its
+                // intended outcome). No cleanup call needed; cancelled is terminal.
+                return { status: "failed", error: "swarm was cancelled externally" };
+            }
+            // PR-B D14 — paused = "queen stopped responding for ≥100 min". This
+            // is the coordinator's idle-fallback (startQueenCheck → swarm.status
+            // = paused) and it would otherwise sit forever holding CLI sessions
+            // + worktree disk. Runner promotes paused to completed so the full
+            // cleanup chain (runRetroAndCleanup → closeSession → workspace
+            // dispose → shipment of whatever progress was made) fires. Same
+            // spawner-owned pattern PR-A B2c added for IntrospectionSource,
+            // applied here at the runner layer for ordinary always-on cycles.
+            if (swarm.status === "paused") {
+                this.log.info({ swarmId }, "always-on cycle hit coordinator auto-pause — runner completing on swarm's behalf to release resources");
+                try {
+                    await this.coordinator.complete(swarmId);
+                }
+                catch (err) {
+                    this.log.warn({ err: err instanceof Error ? err.message : String(err), swarmId }, "coordinator.complete after auto-pause failed (best-effort)");
+                }
+                return { status: "completed" };
+            }
+            // PR-B D12 — no more pollTimeoutMs cap. There's no multi-cycle
+            // continuation mechanism, so cutting a cycle off at 30 min just
+            // burned tokens with zero accumulated progress. Long cycles run to
+            // queen-driven completion, with D14 (paused → complete) as the
+            // resource-leak guard.
+            await this.sleep(this.pollIntervalMs);
+        }
+    }
+}
+//# sourceMappingURL=workcycle-runner.js.map

package/dist/always-on/workcycle-runner.js.map

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

package/dist/always-on/worktree-gc.d.ts

@@ -0,0 +1,41 @@
+/** Default debug-window: keep failed-cycle worktrees for 24h before reaping. */
+export declare const DEFAULT_WORKTREE_GC_AGE_MS: number;
+export interface WorktreeGcOptions {
+    /** Project workDir (e.g. /Users/me/myproject). */
+    workDir: string;
+    /** ClawNet HOME used to resolve snapshot location. */
+    home: string;
+    /** Eligible-age cutoff. Default 24h. */
+    maxAgeMs?: number;
+    /** Clock override for tests. */
+    now?: () => Date;
+    /**
+     * Set false in tests to compute counts but NOT delete. Production always
+     * leaves this true (the default).
+     */
+    dryRun?: boolean;
+}
+export interface WorktreeGcResult {
+    /** Total `.worktrees/<dir>` entries observed. */
+    scanned: number;
+    /** Entries removed this pass. */
+    removed: number;
+    /** Entries retained (still active OR within debug window). */
+    retained: number;
+    /** Per-entry decisions for log spelunking. Limited to first 50 to bound log size. */
+    decisions: Array<{
+        name: string;
+        action: "removed" | "retained-active" | "retained-young";
+        ageMs: number;
+    }>;
+}
+/**
+ * Run one GC pass for one project's `.worktrees/`. Safe to call on every
+ * fired tick — when there's nothing to clean it's a cheap top-level
+ * readdir + per-entry stat pass (NO recursion into worktree contents).
+ *
+ * Errors at every layer are swallowed (logged via the returned result, not
+ * thrown) so a single bad worktree dir can't break the always-on tick loop.
+ */
+export declare function gcWorktrees(opts: WorktreeGcOptions): WorktreeGcResult;
+//# sourceMappingURL=worktree-gc.d.ts.map

package/dist/always-on/worktree-gc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-gc.d.ts","sourceRoot":"","sources":["../../src/always-on/worktree-gc.ts"],"names":[],"mappings":"AAsDA,gFAAgF;AAChF,eAAO,MAAM,0BAA0B,QAAsB,CAAC;AAE9D,MAAM,WAAW,iBAAiB;IAChC,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,qFAAqF;IACrF,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7G;AASD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,iBAAiB,GAAG,gBAAgB,CAgErE"}

package/dist/always-on/worktree-gc.js

@@ -0,0 +1,167 @@
+// PR-B Sub-PR-B4 — always-on worktree GC.
+//
+// Each fired always-on tick spawns a swarm that prepares a workspace
+// (git worktree or, more commonly in practice, a snapshot-copy of the
+// full repo) under `<projectRoot>/.worktrees/<swarmId>/`. SwarmCoordinator.
+// destroy() / complete() / fail() dispose the workspace as part of
+// runRetroAndCleanup, but **failures along that path leave directories
+// behind**: pollTimeoutMs strands (removed in Sub-PR-B1), coordinator
+// crashes, manual UI cancels mid-cleanup, sentinel files left when the
+// SnapshotCopyProvider couldn't atomically delete.
+//
+// Over a 24h aggressive-mode run that's 144 ticks × ~few-hundred MB each.
+// Real disk pressure shows up after a day or two of unattended running.
+//
+// GC strategy:
+//   - scan `<projectRoot>/.worktrees/`
+//   - for each entry, read mtime + check active-swarm membership
+//   - retain if: (a) is an active swarm in the coordinator-tracked snapshot
+//     set (recovery.json status ∉ completed/failed/cancelled), OR
+//     (b) mtime is younger than maxAgeMs (24h default — debug window)
+//   - otherwise: rm -rf
+//
+// PR-B follow-up — size telemetry removed.
+// The original implementation reported {totalBytesBefore, totalBytesAfter}
+// by walking every file under every worktree synchronously with
+// readdirSync + statSync (`safeDirBytes`). In production a worktree is a
+// full repo copy *including* node_modules — ~70k+ files. Across the
+// average ~15 retained worktrees, one GC pass issued ~1M sync stat
+// syscalls (>10 min wall clock), pegging the agent at 99% CPU and
+// freezing the Node event loop. Symptoms: log goes silent, hub
+// proxy_rpc 503 agent_timeout, InboxWatcher fs.watch never fires,
+// queen-driven `swarm_complete_request` stays delivered=false until
+// agent restart. Profile evidence: CPU samples showed `stat` / `readdir`
+// dominating with `safeDirBytes` as the entry frame.
+//
+// The bytes were nice-to-have telemetry, not load-bearing for the reap
+// decision. Deleted entirely — if a future use case needs size info it
+// should use OS-native `du -sk` via spawnSync (kernel-side walk, 100×
+// faster) or batch async readdir with explicit event-loop yields. NEVER
+// reintroduce a synchronous recursive stat walk into the always-on tick
+// path.
+import { existsSync, readdirSync, readFileSync, rmSync, statSync, } from "node:fs";
+import { join } from "node:path";
+import { projectRoot as projRoot } from "@mclawnet/task";
+/** Default debug-window: keep failed-cycle worktrees for 24h before reaping. */
+export const DEFAULT_WORKTREE_GC_AGE_MS = 24 * 60 * 60 * 1000;
+const EMPTY_RESULT = {
+    scanned: 0,
+    removed: 0,
+    retained: 0,
+    decisions: [],
+};
+/**
+ * Run one GC pass for one project's `.worktrees/`. Safe to call on every
+ * fired tick — when there's nothing to clean it's a cheap top-level
+ * readdir + per-entry stat pass (NO recursion into worktree contents).
+ *
+ * Errors at every layer are swallowed (logged via the returned result, not
+ * thrown) so a single bad worktree dir can't break the always-on tick loop.
+ */
+export function gcWorktrees(opts) {
+    const maxAge = opts.maxAgeMs ?? DEFAULT_WORKTREE_GC_AGE_MS;
+    const now = (opts.now ?? (() => new Date())).call(null).getTime();
+    const dryRun = opts.dryRun ?? false;
+    const worktreesDir = join(opts.workDir, ".worktrees");
+    if (!existsSync(worktreesDir))
+        return { ...EMPTY_RESULT, decisions: [] };
+    const active = loadActiveSwarmIds(opts.workDir, opts.home);
+    let entries;
+    try {
+        entries = readdirSync(worktreesDir);
+    }
+    catch {
+        return { ...EMPTY_RESULT, decisions: [] };
+    }
+    const result = {
+        scanned: 0,
+        removed: 0,
+        retained: 0,
+        decisions: [],
+    };
+    for (const name of entries) {
+        const fp = join(worktreesDir, name);
+        let stat;
+        try {
+            stat = statSync(fp);
+        }
+        catch {
+            continue; // entry vanished between readdir and stat
+        }
+        if (!stat.isDirectory())
+            continue;
+        result.scanned += 1;
+        const ageMs = now - stat.mtimeMs;
+        if (active.has(name)) {
+            result.retained += 1;
+            pushDecision(result, name, "retained-active", ageMs);
+            continue;
+        }
+        if (ageMs < maxAge) {
+            result.retained += 1;
+            pushDecision(result, name, "retained-young", ageMs);
+            continue;
+        }
+        if (!dryRun) {
+            try {
+                rmSync(fp, { recursive: true, force: true });
+            }
+            catch {
+                // Best-effort: failed rm (perms, in-use file on Windows). Counts as
+                // retained — we tried, didn't succeed, dir still on disk.
+                result.retained += 1;
+                pushDecision(result, name, "retained-young", ageMs);
+                continue;
+            }
+        }
+        result.removed += 1;
+        pushDecision(result, name, "removed", ageMs);
+    }
+    return result;
+}
+function pushDecision(result, name, action, ageMs) {
+    if (result.decisions.length < 50) {
+        result.decisions.push({ name, action, ageMs });
+    }
+}
+/**
+ * Read this project's swarms snapshot dir and return the set of swarmIds
+ * whose recovery.json status is NOT terminal (still running / paused /
+ * creating). Those swarms' worktrees must NOT be GC'd even if they look
+ * old on disk — they're active state, just stalled.
+ */
+function loadActiveSwarmIds(workDir, home) {
+    const swarmsDir = join(projRoot(workDir, home), "swarms");
+    if (!existsSync(swarmsDir))
+        return new Set();
+    const active = new Set();
+    let entries;
+    try {
+        entries = readdirSync(swarmsDir);
+    }
+    catch {
+        return active;
+    }
+    for (const swarmId of entries) {
+        const recoveryPath = join(swarmsDir, swarmId, "recovery.json");
+        if (!existsSync(recoveryPath))
+            continue;
+        try {
+            const raw = JSON.parse(readFileSync(recoveryPath, "utf-8"));
+            const status = raw.status;
+            // Treat "paused" as ACTIVE for GC purposes — Sub-PR-B1's D14 runner
+            // will promote it to complete on next tick and free its workspace
+            // through the normal dispose path. Reaping a paused worktree out
+            // from under D14 would lose any in-progress work.
+            const terminal = status === "completed" || status === "failed" || status === "cancelled";
+            if (!terminal)
+                active.add(swarmId);
+        }
+        catch {
+            // Unparseable snapshot — be conservative, treat as active.
+            active.add(swarmId);
+        }
+    }
+    return active;
+}
+//# sourceMappingURL=worktree-gc.js.map

package/dist/always-on/worktree-gc.js.map

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

package/dist/index.d.ts

@@ -1,10 +1,15 @@
 export { SwarmCoordinator } from "./swarm-coordinator.js";
 export { initRoles, loadRole, listRoles, buildRolePrompt, parseRoleFile, listRolesWithSource, getRoleSource, getRoleRaw, saveRole, deleteRole, } from "./roles/role-loader.js";
 export type { RoleSource, RoleListItem } from "./roles/role-loader.js";
-export { saveSwarmSnapshot, loadSwarmSnapshot, deleteSwarmSnapshot, appendMessageLog, readMessageLog, listRecoverableSwarmIds, } from "./persistence.js";
+export { saveSwarmSnapshot, loadSwarmSnapshot, deleteSwarmSnapshot, appendMessageLog, readMessageLog, listRecoverableSwarmIds, saveShipmentResult, loadShipmentResult, } from "./persistence.js";
 export type { SwarmSnapshot } from "./persistence.js";
+export type { ShipmentResult } from "./shipment/shipment-pipeline.js";
+export { applyShipment, mergeShipment, discardShipment, } from "./shipment/shipment-actions.js";
+export type { ShipmentActionKind, ShipmentActionInput, ShipmentActionResult, } from "./shipment/shipment-actions.js";
 export { runRetrospective } from "./retrospective.js";
 export type { RetrospectiveResult, RoleEvaluation } from "./retrospective.js";
+export { createDraftPR } from "./shipment/gh-pr-creator.js";
+export type { CreateDraftPRInput, CreateDraftPRReturn, CreateDraftPROptions, CommandRunnerWithStdin, } from "./shipment/gh-pr-creator.js";
 export { listRecoverableSwarms, recoverSwarm } from "./recovery.js";
 export { InboxStore } from "./inbox-store.js";
 export type { InboxMessage } from "./inbox-store.js";
@@ -13,7 +18,24 @@ export { InboxRelay } from "./inbox-relay.js";
 export { InboxWatcher, type InboxRelayLike as InboxWatcherRelayLike } from "./inbox-watcher.js";
 export { WakeupScheduler, type WakeupRelayLike } from "./wakeup-scheduler.js";
 export { WatchManager, type WatchRegistration, type WatchManagerOptions } from "./watch-manager.js";
-export type { SessionAdapter, HubAdapter, SwarmInstance, RoleInstance, SwarmAction, SwarmMessage, SwarmCreateOptions, RouteEndpoint, SwarmStatus, PlanStatus, } from "./types.js";
+export { DiscoveryScheduler } from "./always-on/discovery-scheduler.js";
+export { DEFAULT_DAILY_BUDGET, DEFAULT_TICK_INTERVAL_MS, RECENT_TICKS_CAP, } from "./always-on/types.js";
+export type { AlwaysOnMode, GateDecision, GateContext, Gate, TickRecord, DiscoverySchedulerOptions, DiscoverySchedulerSnapshot, } from "./always-on/types.js";
+export { loadAlwaysOnConfig, saveAlwaysOnConfig, mergeAlwaysOnConfig, alwaysOnConfigPath, localYMD, DEFAULT_ALWAYS_ON_CONFIG, DEFAULT_ALWAYS_ON_TEMPLATE, DEFAULT_ALWAYS_ON_TASK_SOURCES, DEFAULT_INTROSPECTION_COOLDOWN_HOURS, resolveTaskSources, } from "./always-on/config.js";
+export type { AlwaysOnConfig, AlwaysOnTaskSourcesConfig, AlwaysOnRuntimeState, AlwaysOnPersistedConfig, } from "./always-on/config.js";
+export { AlwaysOnManager } from "./always-on/always-on-manager.js";
+export type { AlwaysOnManagerOptions } from "./always-on/always-on-manager.js";
+export { WorkCycleRunner } from "./always-on/workcycle-runner.js";
+export type { WorkCycleInput, WorkCycleResult, WorkCycleRunnerOptions, TaskRef, Logger as WorkCycleRunnerLogger, } from "./always-on/workcycle-runner.js";
+export type { TaskSource, TaskSourceKind, TaskRef as CascadeTaskRef } from "./always-on/task-sources/types.js";
+export { createCascadePicker, type CascadePicker, type CascadePickResult, type CascadePickerLogger, } from "./always-on/task-sources/cascade-picker.js";
+export { createTaskStoreSource, type TaskStoreSourceOptions, } from "./always-on/task-sources/task-store-source.js";
+export { createIdeaTodoSource, markIdeaResearching, sortIdeasForPicking, type IdeaTodoSourceOptions, } from "./always-on/task-sources/idea-todo-source.js";
+export { createIdeaResearchSource, sortIdeasForResearch, parseReportFrontmatter, normaliseConclusion, type IdeaResearchSourceOptions, } from "./always-on/task-sources/idea-research-source.js";
+export { createIntrospectionSource, parseCandidatesOutput, buildIntrospectionTaskPrompt, INTROSPECTION_TEMPLATE_NAME, INTROSPECTION_SOURCE_TAG, INTROSPECTION_SOURCE_ROLE, INTROSPECTION_MAX_IDEAS, type IntrospectionSourceOptions, type IntrospectionCandidate, } from "./always-on/task-sources/introspection-source.js";
+export { reconcileOrphanedResearching, type ReconcileOptions, type ReconcileReport, type ReconcileLogger, } from "./always-on/reconcile-researching.js";
+export type { IdeasClient, IdeasListFilter, IdeasPatch, Idea, IdeaStatus, IdeaPriority, CreateIdeaInput, ResearchRef, ResearchKind, ResearchConclusion, } from "./always-on/ideas-client.js";
+export type { SessionAdapter, HubAdapter, SwarmInstance, RoleInstance, SwarmAction, SwarmMessage, SwarmCreateOptions, RouteEndpoint, SwarmStatus, PlanStatus, SwarmKind, } from "./types.js";
 export type { RoleDefinition, DelegationMap, DelegationEntry } from "./roles/types.js";
 export { listTemplates, loadTemplate, listTemplatesWithSource, getTemplateSource, getTemplateRaw, saveTemplate, deleteTemplate, } from "./templates/template-loader.js";
 export type { TemplateDefinition, TemplateRoleSpec } from "./templates/types.js";
@@ -22,4 +44,6 @@ export { listProjectDirs, resolveWorkDir, loadProjectSummary, loadSwarmSummaries
 export type { TaskStatus, TaskCounts, ProjectSummary, SwarmSummary, } from "./projects-fs.js";
 export { PROJECT_FILE_WHITELIST, isWhitelistedRelPath, listProjectFiles, readProjectFile, writeProjectFile, ProjectFilesError, } from "./project-files.js";
 export type { ProjectFileRelPath, ProjectFileEntry, ProjectFileContent, } from "./project-files.js";
+export { WorkspaceManager, GitWorktreeProvider, SnapshotCopyProvider, } from "./workspace/index.js";
+export type { WorkspaceHandle, WorkspaceProvider, WorkspaceStrategy, WorkspacePrepareInput, } from "./workspace/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,aAAa,EACrE,mBAAmB,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,GACrE,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,KAAK,cAAc,IAAI,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChG,OAAO,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEpG,YAAY,EACV,cAAc,EACd,UAAU,EACV,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,WAAW,EACX,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEvF,OAAO,EAAE,aAAa,EAAE,YAAY,EAClC,uBAAuB,EAAE,iBAAiB,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc,GACzF,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACjF,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEvF,OAAO,EACL,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,YAAY,GACb,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,8 +1,12 @@
 // @mclawnet/swarm — Swarm coordination, message routing, and role management
 export { SwarmCoordinator } from "./swarm-coordinator.js";
 export { initRoles, loadRole, listRoles, buildRolePrompt, parseRoleFile, listRolesWithSource, getRoleSource, getRoleRaw, saveRole, deleteRole, } from "./roles/role-loader.js";
-export { saveSwarmSnapshot, loadSwarmSnapshot, deleteSwarmSnapshot, appendMessageLog, readMessageLog, listRecoverableSwarmIds, } from "./persistence.js";
+export { saveSwarmSnapshot, loadSwarmSnapshot, deleteSwarmSnapshot, appendMessageLog, readMessageLog, listRecoverableSwarmIds, saveShipmentResult, loadShipmentResult, } from "./persistence.js";
+export { applyShipment, mergeShipment, discardShipment, } from "./shipment/shipment-actions.js";
 export { runRetrospective } from "./retrospective.js";
+// PR-A: re-export gh-pr-creator so chat-session worktree ship can reuse the
+// same git push + gh pr create logic without depending on SwarmInstance.
+export { createDraftPR } from "./shipment/gh-pr-creator.js";
 export { listRecoverableSwarms, recoverSwarm } from "./recovery.js";
 export { InboxStore } from "./inbox-store.js";
 export { pickStrongestStatus } from "./plan-sync.js";
@@ -10,7 +14,26 @@ export { InboxRelay } from "./inbox-relay.js";
 export { InboxWatcher } from "./inbox-watcher.js";
 export { WakeupScheduler } from "./wakeup-scheduler.js";
 export { WatchManager } from "./watch-manager.js";
+// M7.0 always-on primitive (no swarm wiring yet; M7.1 will wire onFire).
+export { DiscoveryScheduler } from "./always-on/discovery-scheduler.js";
+export { DEFAULT_DAILY_BUDGET, DEFAULT_TICK_INTERVAL_MS, RECENT_TICKS_CAP, } from "./always-on/types.js";
+// M7.2 always-on per-project config persistence.
+export { loadAlwaysOnConfig, saveAlwaysOnConfig, mergeAlwaysOnConfig, alwaysOnConfigPath, localYMD, DEFAULT_ALWAYS_ON_CONFIG, DEFAULT_ALWAYS_ON_TEMPLATE, DEFAULT_ALWAYS_ON_TASK_SOURCES, DEFAULT_INTROSPECTION_COOLDOWN_HOURS, resolveTaskSources, } from "./always-on/config.js";
+// M7.3 per-project scheduler lifecycle owner.
+export { AlwaysOnManager } from "./always-on/always-on-manager.js";
+// M7.1 work-cycle runner — bridges DiscoveryScheduler.onFire to swarm spawn.
+export { WorkCycleRunner } from "./always-on/workcycle-runner.js";
+export { createCascadePicker, } from "./always-on/task-sources/cascade-picker.js";
+export { createTaskStoreSource, } from "./always-on/task-sources/task-store-source.js";
+export { createIdeaTodoSource, markIdeaResearching, sortIdeasForPicking, } from "./always-on/task-sources/idea-todo-source.js";
+// M8.1 — research cycle task source.
+export { createIdeaResearchSource, sortIdeasForResearch, parseReportFrontmatter, normaliseConclusion, } from "./always-on/task-sources/idea-research-source.js";
+// M8.2 — queen self-introspection task source.
+export { createIntrospectionSource, parseCandidatesOutput, buildIntrospectionTaskPrompt, INTROSPECTION_TEMPLATE_NAME, INTROSPECTION_SOURCE_TAG, INTROSPECTION_SOURCE_ROLE, INTROSPECTION_MAX_IDEAS, } from "./always-on/task-sources/introspection-source.js";
+// M8 hotfix I6 — boot reconciliation for orphaned status=researching ideas.
+export { reconcileOrphanedResearching, } from "./always-on/reconcile-researching.js";
 export { listTemplates, loadTemplate, listTemplatesWithSource, getTemplateSource, getTemplateRaw, saveTemplate, deleteTemplate, } from "./templates/template-loader.js";
 export { listProjectDirs, resolveWorkDir, loadProjectSummary, loadSwarmSummaries, listAllProjectSummaries, } from "./projects-fs.js";
 export { PROJECT_FILE_WHITELIST, isWhitelistedRelPath, listProjectFiles, readProjectFile, writeProjectFile, ProjectFilesError, } from "./project-files.js";
+export { WorkspaceManager, GitWorktreeProvider, SnapshotCopyProvider, } from "./workspace/index.js";
 //# sourceMappingURL=index.js.map