@mclawnet/swarm 0.1.13 → 0.1.14

package/dist/always-on/discovery-scheduler.js

@@ -0,0 +1,287 @@
+// DiscoveryScheduler — M7.0 standalone primitive.
+//
+// Drives the always-on tick loop. Owns: tick timer, gate cascade, daily budget,
+// ring buffer of recent decisions. Owns nothing about swarms / TaskStore /
+// queens — that wiring lands in M7.1 via the `onFire` callback.
+//
+// Persistence: NONE in M7.0. Restart resets ticksToday and recentTicks.
+// M7.3 will add a persisted view.
+import { createLogger } from "@mclawnet/logger";
+import { localYMD } from "./config.js";
+import { DEFAULT_DAILY_BUDGET, DEFAULT_TICK_INTERVAL_MS, RECENT_TICKS_CAP, } from "./types.js";
+const log = createLogger({ module: "swarm" });
+export class DiscoveryScheduler {
+    mode;
+    tickIntervalOverride;
+    dailyBudget;
+    userGates;
+    onFire;
+    onTick;
+    now;
+    timer = null;
+    running = false;
+    halted = false;
+    inFlight = false; // a tick is currently executing
+    ticksToday = 0;
+    lastFireAt = null;
+    recentTicks = [];
+    nextTickAt = null;
+    constructor(opts) {
+        this.mode = opts.mode;
+        this.tickIntervalOverride = opts.tickInterval;
+        this.dailyBudget = opts.dailyBudget === undefined ? DEFAULT_DAILY_BUDGET : opts.dailyBudget;
+        this.userGates = opts.gates ?? [];
+        this.onFire = opts.onFire;
+        this.onTick = opts.onTick;
+        this.now = opts.now ?? (() => new Date());
+    }
+    /** Start the tick loop. No-op when mode === "off" or scheduler is halted. */
+    start() {
+        if (this.halted) {
+            log.warn("DiscoveryScheduler.start() called after halt — ignoring");
+            return;
+        }
+        if (this.running)
+            return;
+        this.running = true;
+        this.schedule();
+    }
+    /** Stop the tick loop. Idempotent. */
+    stop() {
+        this.running = false;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        this.nextTickAt = null;
+    }
+    /**
+     * Manually trigger a tick. Bypasses the interval but still runs gates and
+     * still respects the in-flight guard: concurrent tickNow() calls reject the
+     * second caller with an Error so callers see deterministic semantics rather
+     * than silent overlap. Use `await` to serialise explicitly.
+     */
+    async tickNow() {
+        if (this.inFlight) {
+            throw new Error("DiscoveryScheduler.tickNow: a tick is already in progress");
+        }
+        return this.runTick();
+    }
+    /** Change mode at runtime. Cancels current timer and reschedules. */
+    setMode(mode) {
+        if (this.mode === mode)
+            return;
+        this.mode = mode;
+        // S2 hotfix: previously bailed when `!running`, which forced applyConfig
+        // to call start() explicitly after every setMode("active"). Let schedule()
+        // make the decision — it already no-ops on `!running` and on mode === "off".
+        this.schedule();
+    }
+    /**
+     * Change daily budget at runtime (M7.3). `null` removes the cap entirely.
+     * Does not retro-affect counters; if the new budget is lower than
+     * `ticksToday`, the next gate evaluation will simply skip.
+     */
+    setDailyBudget(budget) {
+        this.dailyBudget = budget;
+    }
+    /**
+     * Restore counters from persisted state (M7.3 AlwaysOnManager). Must be
+     * called BEFORE start() — restoring into a running scheduler is undefined
+     * behaviour. `lastFireAt` may be null when no prior fire exists.
+     */
+    restoreState(state) {
+        if (this.running) {
+            log.warn("DiscoveryScheduler.restoreState() called while running — ignoring");
+            return;
+        }
+        if (Number.isInteger(state.ticksToday) && state.ticksToday >= 0) {
+            this.ticksToday = state.ticksToday;
+        }
+        this.lastFireAt = state.lastFireAt;
+    }
+    snapshot() {
+        return {
+            mode: this.mode,
+            ticksToday: this.ticksToday,
+            lastFireAt: this.lastFireAt,
+            nextTickAt: this.nextTickAt,
+            recentTicks: [...this.recentTicks],
+        };
+    }
+    // ---- internal ---------------------------------------------------------
+    currentInterval() {
+        if (this.tickIntervalOverride !== undefined)
+            return this.tickIntervalOverride;
+        if (this.mode === "off")
+            return Number.POSITIVE_INFINITY;
+        return DEFAULT_TICK_INTERVAL_MS[this.mode];
+    }
+    /**
+     * Arm the next-tick timer. No-op when not running, halted, or mode=off.
+     * Always clears any existing timer first — both setMode() and a manual
+     * tickNow() can race with the previously armed interval.
+     */
+    schedule() {
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        if (!this.running || this.halted) {
+            this.nextTickAt = null;
+            return;
+        }
+        if (this.mode === "off") {
+            this.nextTickAt = null;
+            return;
+        }
+        const interval = this.currentInterval();
+        if (!Number.isFinite(interval)) {
+            this.nextTickAt = null;
+            return;
+        }
+        this.nextTickAt = new Date(this.now().getTime() + interval);
+        const t = setTimeout(() => {
+            this.timer = null;
+            // runTick is async; we deliberately do not await — schedule() is called
+            // by runTick itself once the tick (and onFire) completes.
+            this.runTick().catch((err) => {
+                log.warn({ err }, "DiscoveryScheduler tick threw unexpectedly");
+                // Defensive: still reschedule so a single bad tick doesn't kill the loop.
+                if (this.running && !this.halted)
+                    this.schedule();
+            });
+        }, interval);
+        // Don't keep the event loop alive purely for ticks (matches WakeupScheduler).
+        if (typeof t.unref === "function") {
+            t.unref();
+        }
+        this.timer = t;
+    }
+    async runTick() {
+        this.inFlight = true;
+        const startedAt = this.now();
+        const startedMs = startedAt.getTime();
+        try {
+            // Daily reset: if calendar date has changed since lastFireAt, zero today.
+            // S3 hotfix: localYMD shared with AlwaysOnManager (single source of
+            // truth for "today" — was `Date.toDateString()` before, which uses a
+            // human-readable English string and didn't match the YMD persisted on
+            // disk).
+            if (this.lastFireAt && localYMD(this.lastFireAt) !== localYMD(startedAt)) {
+                this.ticksToday = 0;
+            }
+            const ctx = {
+                now: startedAt,
+                mode: this.mode,
+                ticksToday: this.ticksToday,
+                lastFireAt: this.lastFireAt,
+            };
+            const breakdown = [];
+            const gates = this.buildGateChain();
+            let finalDecision = { kind: "fire" };
+            for (const g of gates) {
+                const decision = await g.evaluate(ctx);
+                breakdown.push({ gate: g.name, decision });
+                if (decision.kind !== "fire") {
+                    finalDecision = decision;
+                    break;
+                }
+            }
+            let outcome;
+            if (finalDecision.kind === "halt") {
+                outcome = "halted";
+                this.halted = true;
+                this.stop();
+            }
+            else if (finalDecision.kind === "skip") {
+                outcome = "skipped";
+            }
+            else if (this.onFire) {
+                // I1 hotfix: increment budget AFTER onFire resolves. A rejected onFire
+                // (e.g. C1's "template not found", or any transient swarm spawn error)
+                // used to charge the daily quota AND lose the work — three quiet
+                // failures and the project was locked for the day. Now: a throw is
+                // recorded as a "skipped" decision so the next tick keeps trying.
+                try {
+                    await this.onFire(ctx);
+                    this.ticksToday += 1;
+                    this.lastFireAt = startedAt;
+                    outcome = "fired";
+                }
+                catch (err) {
+                    log.warn({ err }, "DiscoveryScheduler onFire rejected; not burning budget");
+                    outcome = "skipped";
+                    breakdown.push({
+                        gate: "onFire",
+                        decision: {
+                            kind: "skip",
+                            reason: `onFire threw: ${err instanceof Error ? err.message : String(err)}`,
+                        },
+                    });
+                }
+            }
+            else {
+                // No onFire wired (M7.0 standalone primitive) — treat the gate-pass
+                // as a fire so existing counters / tests still observe ticksToday++.
+                this.ticksToday += 1;
+                this.lastFireAt = startedAt;
+                outcome = "fired";
+            }
+            const record = {
+                at: startedAt,
+                decision: outcome,
+                gateBreakdown: breakdown,
+                durationMs: this.now().getTime() - startedMs,
+            };
+            this.pushRecent(record);
+            if (this.onTick) {
+                try {
+                    this.onTick(record);
+                }
+                catch (err) {
+                    log.warn({ err }, "DiscoveryScheduler onTick observer threw; ignored");
+                }
+            }
+            return record;
+        }
+        finally {
+            this.inFlight = false;
+            // Schedule the next tick unless we halted or were stopped.
+            if (this.running && !this.halted) {
+                this.schedule();
+            }
+        }
+    }
+    /** Built-ins (in order) then user gates. */
+    buildGateChain() {
+        const builtins = [
+            {
+                name: "modeNotOff",
+                evaluate: (c) => c.mode === "off"
+                    ? { kind: "skip", reason: "mode is off" }
+                    : { kind: "fire" },
+            },
+            {
+                name: "dailyBudget",
+                evaluate: (c) => {
+                    if (this.dailyBudget !== null && c.ticksToday >= this.dailyBudget) {
+                        return {
+                            kind: "skip",
+                            reason: `daily budget exhausted (${c.ticksToday}/${this.dailyBudget})`,
+                        };
+                    }
+                    return { kind: "fire" };
+                },
+            },
+        ];
+        return [...builtins, ...this.userGates];
+    }
+    pushRecent(record) {
+        this.recentTicks.push(record);
+        if (this.recentTicks.length > RECENT_TICKS_CAP) {
+            this.recentTicks.splice(0, this.recentTicks.length - RECENT_TICKS_CAP);
+        }
+    }
+}
+//# sourceMappingURL=discovery-scheduler.js.map

package/dist/always-on/discovery-scheduler.js.map

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

package/dist/always-on/ideas-client.d.ts

@@ -0,0 +1,23 @@
+import type { Idea, IdeaStatus, IdeaPriority, UpdateIdeaInput, CreateIdeaInput, ListIdeasInput, ResearchRef, ResearchKind, ResearchConclusion } from "@mclawnet/shared";
+export type { Idea, IdeaStatus, IdeaPriority, CreateIdeaInput, ResearchRef, ResearchKind, ResearchConclusion, };
+/**
+ * Subset of UpdateIdeaInput the M8.0 IdeaTodoSource + M8.1 IdeaResearchSource
+ * need. M8.1 extends with researchReports (append-only array writeback) and
+ * researchKind (disambiguates the two researching flows; cleared back to null
+ * on failure-revert).
+ */
+export type IdeasPatch = Partial<Pick<UpdateIdeaInput, "status" | "priority" | "linkedSwarmTaskId" | "linkedSessionId" | "tags" | "title" | "body" | "researchReports" | "researchKind" | "shipFailureReason">>;
+/** Subset of ListIdeasInput supported by the cascade source today. */
+export type IdeasListFilter = Partial<Pick<ListIdeasInput, "status" | "priority" | "projectId" | "tag" | "q" | "limit">>;
+export interface IdeasClient {
+    list(filter: IdeasListFilter): Promise<Idea[]>;
+    get(id: string): Promise<Idea | null>;
+    patch(id: string, partial: IdeasPatch): Promise<Idea>;
+    /**
+     * M8.2 — POST /api/ideas. Used by IntrospectionSource to write back
+     * agent-discovered ideas (status defaults to "idea" hub-side when omitted).
+     * Returns the persisted row so callers can grab the assigned id.
+     */
+    create(input: CreateIdeaInput): Promise<Idea>;
+}
+//# sourceMappingURL=ideas-client.d.ts.map

package/dist/always-on/ideas-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ideas-client.d.ts","sourceRoot":"","sources":["../../src/always-on/ideas-client.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,IAAI,EACJ,UAAU,EACV,YAAY,EACZ,eAAe,EACf,eAAe,EACf,cAAc,EACd,WAAW,EACX,YAAY,EACZ,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,IAAI,EACJ,UAAU,EACV,YAAY,EACZ,eAAe,EACf,WAAW,EACX,YAAY,EACZ,kBAAkB,GACnB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,CAC9B,IAAI,CACF,eAAe,EACb,QAAQ,GACR,UAAU,GACV,mBAAmB,GACnB,iBAAiB,GACjB,MAAM,GACN,OAAO,GACP,MAAM,GACN,iBAAiB,GACjB,cAAc,GACd,mBAAmB,CACtB,CACF,CAAC;AAEF,sEAAsE;AACtE,MAAM,MAAM,eAAe,GAAG,OAAO,CACnC,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,UAAU,GAAG,WAAW,GAAG,KAAK,GAAG,GAAG,GAAG,OAAO,CAAC,CAClF,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IACtC,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C"}

package/dist/always-on/ideas-client.js

@@ -0,0 +1,13 @@
+// M8.0 — IdeasClient interface.
+//
+// Decouples IdeaTodoSource from the actual HTTP transport: tests inject a
+// stub, the agent injects an HTTP-backed implementation
+// (`createIdeasRestClient` in @mclawnet/agent) that talks to hub's
+// /api/ideas/* routes. Keeping the interface in @mclawnet/swarm avoids
+// circular package deps (swarm doesn't depend on agent).
+//
+// Re-exports the canonical Idea / IdeaStatus / IdeaPriority shapes from
+// @mclawnet/shared so callers don't have to remember which package they live
+// in.
+export {};
+//# sourceMappingURL=ideas-client.js.map

package/dist/always-on/ideas-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ideas-client.js","sourceRoot":"","sources":["../../src/always-on/ideas-client.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,EAAE;AACF,0EAA0E;AAC1E,wDAAwD;AACxD,mEAAmE;AACnE,uEAAuE;AACvE,yDAAyD;AACzD,EAAE;AACF,wEAAwE;AACxE,6EAA6E;AAC7E,MAAM"}

package/dist/always-on/reconcile-researching.d.ts

@@ -0,0 +1,42 @@
+import type { IdeasClient } from "./ideas-client.js";
+export interface ReconcileLogger {
+    warn?: (obj: Record<string, unknown>, msg?: string) => void;
+    info?: (obj: Record<string, unknown>, msg?: string) => void;
+}
+export interface ReconcileOptions {
+    ideasClient: IdeasClient;
+    /** Returns the list of projectRoots the agent currently has wired. */
+    getProjectRoots: () => string[];
+    /**
+     * Returns the swarmIds currently recoverable on disk (recovery.json
+     * still present). The check is per-call — we don't cache so this runs
+     * after any inflight recovery on the swarm side.
+     */
+    listRecoverableSwarmIds: () => Array<{
+        swarmId: string;
+        workDir: string;
+    }>;
+    /** Optional logger. Defaults to silent. */
+    log?: ReconcileLogger;
+    /** Max ideas to list per project on the boot scan. Default 100. */
+    perProjectLimit?: number;
+}
+export interface ReconcileReport {
+    /** Projects scanned (post-encodeCwd failures excluded). */
+    projectsScanned: number;
+    /** Ideas observed at status=researching across all scanned projects. */
+    candidatesFound: number;
+    /** Ideas that were reverted (orphans whose linked swarm is gone). */
+    reverted: number;
+    /** Ideas left alone because their linked swarm still has recovery.json on disk. */
+    preserved: number;
+    /** Errors encountered during the sweep (best-effort; not re-thrown). */
+    errors: string[];
+}
+/**
+ * One-shot reconciliation. Designed to be awaited (or fire-and-forget) at
+ * the end of startAgent() after AlwaysOnManager has booted. Returns a
+ * report for logging — no exceptions cross the boundary.
+ */
+export declare function reconcileOrphanedResearching(opts: ReconcileOptions): Promise<ReconcileReport>;
+//# sourceMappingURL=reconcile-researching.d.ts.map

package/dist/always-on/reconcile-researching.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile-researching.d.ts","sourceRoot":"","sources":["../../src/always-on/reconcile-researching.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,mBAAmB,CAAC;AAIjE,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5D,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7D;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,WAAW,CAAC;IACzB,sEAAsE;IACtE,eAAe,EAAE,MAAM,MAAM,EAAE,CAAC;IAChC;;;;OAIG;IACH,uBAAuB,EAAE,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3E,2CAA2C;IAC3C,GAAG,CAAC,EAAE,eAAe,CAAC;IACtB,mEAAmE;IACnE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,eAAe,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,eAAe,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC;IACjB,mFAAmF;IACnF,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AASD;;;;GAIG;AACH,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,eAAe,CAAC,CA0G1B"}

package/dist/always-on/reconcile-researching.js

@@ -0,0 +1,133 @@
+// M8 hotfix I6 — orphaned-researching reconciliation.
+//
+// If the agent dies between IdeaTodoSource.onClaim / IdeaResearchSource.onClaim
+// (which PATCH the idea to status=researching + linkedSwarmTaskId=<swarmId>)
+// and the runner's terminal-state callback, the idea is left dangling at
+// status=researching forever. No code path on the boot side noticed.
+//
+// This module exposes a one-shot reconciliation that the agent runs once,
+// right after AlwaysOnManager.start() has booted all projects. It walks
+// every still-researching idea, decides whether its linked swarm is still
+// alive, and reverts the orphans:
+//   - researchKind="execute"     → back to status="todo"
+//   - researchKind="investigate" → back to status="idea"
+//   - missing/unknown kind       → defaults to "idea" (the safer revert)
+// and clears `linkedSwarmTaskId` + `researchKind` on the way.
+//
+// We intentionally do NOT try to resume the cycle — the swarm process is
+// gone and the most useful thing for the user is to see the idea back in
+// the inbox where they can re-trigger it manually.
+//
+// Best-effort: hub failures, individual idea failures, and per-project
+// scan failures all log a warn and continue. The agent must boot even when
+// the hub is briefly unreachable.
+import { encodeCwd } from "@mclawnet/shared";
+/** Map a researching idea back to its pre-claim status. */
+function revertStatus(idea) {
+    if (idea.researchKind === "execute")
+        return "todo";
+    // "investigate" or null/undefined → safest revert is "idea".
+    return "idea";
+}
+/**
+ * One-shot reconciliation. Designed to be awaited (or fire-and-forget) at
+ * the end of startAgent() after AlwaysOnManager has booted. Returns a
+ * report for logging — no exceptions cross the boundary.
+ */
+export async function reconcileOrphanedResearching(opts) {
+    const { ideasClient, getProjectRoots, listRecoverableSwarmIds, log, perProjectLimit = 100 } = opts;
+    const report = {
+        projectsScanned: 0,
+        candidatesFound: 0,
+        reverted: 0,
+        preserved: 0,
+        errors: [],
+    };
+    let aliveSwarmIds;
+    try {
+        aliveSwarmIds = new Set(listRecoverableSwarmIds().map((s) => s.swarmId));
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        log?.warn?.({ err: msg }, "reconcile: failed to list recoverable swarms — skipping sweep");
+        report.errors.push(`listRecoverableSwarmIds: ${msg}`);
+        return report;
+    }
+    let projectRoots;
+    try {
+        projectRoots = getProjectRoots();
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        log?.warn?.({ err: msg }, "reconcile: getProjectRoots threw — skipping sweep");
+        report.errors.push(`getProjectRoots: ${msg}`);
+        return report;
+    }
+    for (const projectRoot of projectRoots) {
+        let projectId;
+        try {
+            projectId = encodeCwd(projectRoot);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            log?.warn?.({ err: msg, projectRoot }, "reconcile: encodeCwd failed — skipping project");
+            report.errors.push(`encodeCwd(${projectRoot}): ${msg}`);
+            continue;
+        }
+        report.projectsScanned += 1;
+        let researching;
+        try {
+            researching = await ideasClient.list({
+                status: "researching",
+                projectId,
+                limit: perProjectLimit,
+            });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            log?.warn?.({ err: msg, projectId }, "reconcile: list(status=researching) failed");
+            report.errors.push(`list(${projectId}): ${msg}`);
+            continue;
+        }
+        for (const idea of researching) {
+            report.candidatesFound += 1;
+            const swarmId = idea.linkedSwarmTaskId;
+            if (swarmId && aliveSwarmIds.has(swarmId)) {
+                // Linked swarm is still recoverable on disk — leave alone; the
+                // normal flow (or a manual recovery) will catch up.
+                report.preserved += 1;
+                continue;
+            }
+            const patch = {
+                status: revertStatus(idea),
+                researchKind: null,
+                linkedSwarmTaskId: null,
+            };
+            try {
+                await ideasClient.patch(idea.id, patch);
+                report.reverted += 1;
+                log?.info?.({
+                    ideaId: idea.id,
+                    projectId,
+                    prevStatus: "researching",
+                    nextStatus: patch.status,
+                    prevSwarmId: swarmId ?? null,
+                }, "reconcile: reverted orphaned researching idea");
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                log?.warn?.({ err: msg, ideaId: idea.id, projectId }, "reconcile: PATCH revert failed (will retry on next boot)");
+                report.errors.push(`patch(${idea.id}): ${msg}`);
+            }
+        }
+    }
+    log?.info?.({
+        projectsScanned: report.projectsScanned,
+        candidatesFound: report.candidatesFound,
+        reverted: report.reverted,
+        preserved: report.preserved,
+        errorCount: report.errors.length,
+    }, "reconcile: sweep complete");
+    return report;
+}
+//# sourceMappingURL=reconcile-researching.js.map

package/dist/always-on/reconcile-researching.js.map

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

package/dist/always-on/task-sources/cascade-picker.d.ts

@@ -0,0 +1,42 @@
+import type { TaskSource, TaskRef } from "./types.js";
+export interface CascadePickerLogger {
+    warn?: (obj: Record<string, unknown>, msg?: string) => void;
+    info?: (obj: Record<string, unknown>, msg?: string) => void;
+    debug?: (obj: Record<string, unknown>, msg?: string) => void;
+}
+export interface CascadePickResult {
+    taskRef: TaskRef;
+    source: TaskSource;
+}
+export interface CascadePicker {
+    /** Try each source in order and return the first hit, or null. */
+    pick(projectRoot: string): Promise<CascadePickResult | null>;
+    /**
+     * Convenience adapter that drops the source reference — matches the
+     * legacy `pickNextTask: (root) => Promise<TaskRef | null>` shape used by
+     * M7 callers (e.g. AlwaysOnManager constructor option). The cascade
+     * picker remembers the last hit internally so the runner's terminal
+     * hooks can still resolve it.
+     */
+    pickNextTask(projectRoot: string): Promise<TaskRef | null>;
+    /**
+     * Returns the source that produced the given TaskRef in the most recent
+     * `pick()` / `pickNextTask()` call. Used by the runner to resolve hooks
+     * after a swarm reaches terminal state. Returns null when the ref is
+     * unknown (e.g. the runner is using the legacy single-source DI path).
+     */
+    resolveSource(taskRef: TaskRef): TaskSource | null;
+}
+export interface CascadePickerOptions {
+    /**
+     * Hotfix C1 — per-pick source filter. Called for every source before
+     * `source.pick()`; returning false skips the source for this tick (it is
+     * still resolvable via `resolveSource` for outstanding refs). The filter
+     * is consulted fresh on every pick, so toggling a source on/off in the
+     * always-on config takes effect without rebuilding the cascade. Default:
+     * every source enabled.
+     */
+    filter?: (source: TaskSource, projectRoot: string) => boolean;
+}
+export declare function createCascadePicker(sources: TaskSource[], log?: CascadePickerLogger, options?: CascadePickerOptions): CascadePicker;
+//# sourceMappingURL=cascade-picker.d.ts.map

package/dist/always-on/task-sources/cascade-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cascade-picker.d.ts","sourceRoot":"","sources":["../../../src/always-on/task-sources/cascade-picker.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5D,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5D,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9D;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAC7D;;;;;;OAMG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC3D;;;;;OAKG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,CAAC;CACpD;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC;CAC/D;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,UAAU,EAAE,EACrB,GAAG,CAAC,EAAE,mBAAmB,EACzB,OAAO,GAAE,oBAAyB,GACjC,aAAa,CA+Df"}

package/dist/always-on/task-sources/cascade-picker.js

@@ -0,0 +1,65 @@
+// M8.0 — cascade-picker: tries TaskSource instances in order and returns the
+// first hit along with the source that produced it. The runner needs the
+// source reference so it can later call onClaim / onSuccess / onFailure
+// hooks against the same instance that picked the task.
+//
+// Resilient by design: if a source's `pick()` throws we log a warn and try
+// the next source. A single source crashing must not kill the whole cascade
+// or the always-on cycle — silent fall-through is preferable to a stuck loop.
+export function createCascadePicker(sources, log, options = {}) {
+    const sourceFilter = options.filter;
+    // Tracks which source produced each outstanding TaskRef (by reference id).
+    // Cleared lazily — entries live until overwritten or the process restarts;
+    // memory pressure is negligible because the cascade runs one pick per cycle.
+    const sourceByRefId = new Map();
+    async function pick(projectRoot) {
+        for (const source of sources) {
+            if (sourceFilter && !sourceFilter(source, projectRoot)) {
+                log?.debug?.({ source: source.name, projectRoot }, "cascade-picker: source disabled by filter — skipping");
+                continue;
+            }
+            let result = null;
+            try {
+                result = await source.pick(projectRoot);
+            }
+            catch (err) {
+                log?.warn?.({
+                    err: err instanceof Error ? err.message : String(err),
+                    source: source.name,
+                    projectRoot,
+                }, "cascade-picker: source threw — trying next");
+                continue;
+            }
+            if (result) {
+                sourceByRefId.set(result.id, source);
+                log?.debug?.({ source: source.name, taskId: result.id, projectRoot }, "cascade-picker: hit");
+                return { taskRef: result, source };
+            }
+        }
+        return null;
+    }
+    return {
+        pick,
+        async pickNextTask(projectRoot) {
+            const hit = await pick(projectRoot);
+            return hit ? hit.taskRef : null;
+        },
+        resolveSource(taskRef) {
+            // S6 hotfix — prefer matching by `kind` (the explicit TaskSourceKind
+            // union member), then fall back to `name` for sources that haven't
+            // adopted the `kind` field yet, and finally to the per-id map.
+            // resolveSource is called by the runner after a swarm reaches
+            // terminal state, so we need both signals to be authoritative.
+            if (taskRef.sourceKind) {
+                const byKind = sources.find((s) => s.kind === taskRef.sourceKind);
+                if (byKind)
+                    return byKind;
+                const byName = sources.find((s) => s.name === taskRef.sourceKind);
+                if (byName)
+                    return byName;
+            }
+            return sourceByRefId.get(taskRef.id) ?? null;
+        },
+    };
+}
+//# sourceMappingURL=cascade-picker.js.map

package/dist/always-on/task-sources/cascade-picker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cascade-picker.js","sourceRoot":"","sources":["../../../src/always-on/task-sources/cascade-picker.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,yEAAyE;AACzE,wEAAwE;AACxE,wDAAwD;AACxD,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAC5E,8EAA8E;AA+C9E,MAAM,UAAU,mBAAmB,CACjC,OAAqB,EACrB,GAAyB,EACzB,UAAgC,EAAE;IAElC,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IACpC,2EAA2E;IAC3E,2EAA2E;IAC3E,6EAA6E;IAC7E,MAAM,aAAa,GAAG,IAAI,GAAG,EAAsB,CAAC;IAEpD,KAAK,UAAU,IAAI,CAAC,WAAmB;QACrC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,YAAY,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC;gBACvD,GAAG,EAAE,KAAK,EAAE,CACV,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,EACpC,sDAAsD,CACvD,CAAC;gBACF,SAAS;YACX,CAAC;YACD,IAAI,MAAM,GAAmB,IAAI,CAAC;YAClC,IAAI,CAAC;gBACH,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC1C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,GAAG,EAAE,IAAI,EAAE,CACT;oBACE,GAAG,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;oBACrD,MAAM,EAAE,MAAM,CAAC,IAAI;oBACnB,WAAW;iBACZ,EACD,4CAA4C,CAC7C,CAAC;gBACF,SAAS;YACX,CAAC;YACD,IAAI,MAAM,EAAE,CAAC;gBACX,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;gBACrC,GAAG,EAAE,KAAK,EAAE,CACV,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,WAAW,EAAE,EACvD,qBAAqB,CACtB,CAAC;gBACF,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;YACrC,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,IAAI;QACJ,KAAK,CAAC,YAAY,CAAC,WAAmB;YACpC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,CAAC;YACpC,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QAClC,CAAC;QACD,aAAa,CAAC,OAAgB;YAC5B,qEAAqE;YACrE,mEAAmE;YACnE,+DAA+D;YAC/D,8DAA8D;YAC9D,+DAA+D;YAC/D,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;gBACvB,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;gBAClE,IAAI,MAAM;oBAAE,OAAO,MAAM,CAAC;gBAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;gBAClE,IAAI,MAAM;oBAAE,OAAO,MAAM,CAAC;YAC5B,CAAC;YACD,OAAO,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC;QAC/C,CAAC;KACF,CAAC;AACJ,CAAC"}