@mclawnet/swarm 0.1.13 → 0.1.15

package/dist/always-on/config.d.ts

@@ -0,0 +1,141 @@
+export interface AlwaysOnTaskSourcesConfig {
+    /** L1 — TaskStore (sprint backlog). Default true. */
+    taskStore?: boolean;
+    /** L2a — Ideas with status=todo. Default true. */
+    ideaTodo?: boolean;
+    /** L2b — Ideas with status=idea (research cycle). Default true. */
+    ideaResearch?: boolean;
+    /** L3 — Queen self-introspection (opt-in). Default false. */
+    introspection?: boolean;
+}
+export interface AlwaysOnConfig {
+    mode: "off" | "quiet" | "active" | "aggressive";
+    /** 1..20 cycles/day, integer. */
+    dailyBudget: number;
+    /**
+     * ISO timestamp; when set and in the future, the scheduler should treat
+     * every tick as gated regardless of mode. Cleared by setting back to
+     * undefined / null. M7.3 enforces via the manager's `pausedUntil` gate.
+     */
+    pausedUntil?: string;
+    /**
+     * Template (a.k.a. team) name used when AlwaysOnManager spawns a synthetic
+     * cycle swarm. Forward-compatible: the UI doesn't expose this yet (lands
+     * later), so callers and the persisted config use the DEFAULT below when
+     * absent. Validated against an allowlist on read/write — bad values fall
+     * back to the default so an unknown template can never bring the scheduler
+     * down (C1 hotfix).
+     */
+    templateName?: string;
+    /**
+     * M8.2 — per-source opt-in toggles. Omitted fields fall back to defaults
+     * (taskStore / ideaTodo / ideaResearch on; introspection off). Surfaced
+     * via JSON edit until M8.3 ships the UI toggles.
+     */
+    taskSources?: AlwaysOnTaskSourcesConfig;
+    /**
+     * M8.2 — cooldown (in hours) between consecutive introspection cycles.
+     * Independent of dailyBudget. Default 24. Validated to a sane range on
+     * load/save; out-of-range values fall back to the default.
+     */
+    introspectionCooldownHours?: number;
+    /**
+     * M8.2 — runtime state: ISO timestamp of the most recent introspection
+     * cycle that fired. Persisted so cooldown gates survive a restart.
+     */
+    lastIntrospectionAt?: string;
+    /**
+     * M8.2 — runtime state: when true, every idea produced by the previous
+     * introspection cycle ended up archived. IntrospectionSource self-skips
+     * the next cycle while this flag is set; clears as soon as one prior
+     * idea survives (status != archived) on the next pre-check.
+     */
+    lastIntrospectionRejected?: boolean;
+    /**
+     * M8 hotfix I1/I2 — fire-and-forget breadcrumb: the swarmId of an
+     * introspection cycle that was *spawned* on a prior tick but whose output
+     * has not yet been ingested. Set when IntrospectionSource queues the
+     * background swarm; cleared once the next pick observes the swarm has
+     * reached a terminal state and POSTs (or skips) the ideas. Persisted so
+     * an agent restart mid-cycle still picks up the in-flight result. Absent
+     * = no pending swarm to reconcile.
+     */
+    pendingIntrospectionSwarmId?: string;
+    /**
+     * PR-B follow-up — workspace.cwd of the pending introspection swarm,
+     * captured at spawn time. After `swarm_complete` deletes the swarm from
+     * the coordinator registry, `swarmCoordinator.getSwarm()` returns
+     * undefined and the spawner can no longer resolve where the queen wrote
+     * her candidates. Persisting the cwd alongside the swarm id lets
+     * `processPendingSwarm` find the output file in the worktree even when
+     * the live workspace handle is gone. Cleared in lockstep with
+     * `pendingIntrospectionSwarmId`.
+     */
+    pendingIntrospectionWorkspaceCwd?: string;
+}
+/**
+ * Runtime counters persisted alongside AlwaysOnConfig on disk so the daily
+ * budget survives an agent restart (M7.3). Kept structurally separate from
+ * AlwaysOnConfig so the wire-side `AlwaysOnConfig` in @mclawnet/shared can
+ * stay a clean user-facing surface — see always-on-parity.test.ts.
+ */
+export interface AlwaysOnRuntimeState {
+    /**
+     * Current day's fired count (mirrors DiscoveryScheduler.ticksToday). Persists
+     * across agent restart so a quick crash + relaunch doesn't reset the budget
+     * to 0 and double-spend the cap. Reset to 0 on load when ticksTodayDate is
+     * older than today.
+     */
+    ticksToday?: number;
+    /** YYYY-MM-DD (local) the persisted `ticksToday` belongs to. */
+    ticksTodayDate?: string;
+    /** ISO timestamp of the most recent fired tick; absent when never. */
+    lastFireAt?: string;
+}
+export type AlwaysOnPersistedConfig = AlwaysOnConfig & AlwaysOnRuntimeState;
+export declare const DEFAULT_ALWAYS_ON_CONFIG: AlwaysOnConfig;
+/**
+ * M8.2 — default opt-in matrix. taskSources field omitted on disk falls back
+ * to this; UI/JSON edits override per-key (omitted keys still resolve to the
+ * default). Introspection stays off so the agent never wakes the user with
+ * auto-discovered ideas unless they've explicitly opted in.
+ */
+export declare const DEFAULT_ALWAYS_ON_TASK_SOURCES: Required<AlwaysOnTaskSourcesConfig>;
+/** M8.2 — default cooldown between introspection cycles, in hours. */
+export declare const DEFAULT_INTROSPECTION_COOLDOWN_HOURS = 24;
+/**
+ * Template used when no override is persisted. "minimal" ships in
+ * `packages/@clawnet/swarm/templates/` and is the safest single-role default —
+ * picked over the legacy `"default"` literal which never had a backing file
+ * and crashed every always-on cycle pre-hotfix (C1).
+ */
+export declare const DEFAULT_ALWAYS_ON_TEMPLATE = "minimal";
+/** Local YYYY-MM-DD (NOT UTC) so the daily-budget midnight matches user time. */
+export declare function localYMD(d: Date): string;
+/** Public so the agent boot scanner can distinguish "no config" from "corrupt config" (I4). */
+export declare function alwaysOnConfigPath(workDir: string, home: string): string;
+/**
+ * Merge a (possibly partial) taskSources object over the defaults, returning
+ * a fully-resolved record with every field present. The runtime always-on
+ * cascade reads this — undefined would force every caller to remember the
+ * defaults.
+ */
+export declare function resolveTaskSources(v: AlwaysOnTaskSourcesConfig | undefined): Required<AlwaysOnTaskSourcesConfig>;
+export declare function loadAlwaysOnConfig(workDir: string, home: string): AlwaysOnPersistedConfig;
+export declare function saveAlwaysOnConfig(workDir: string, home: string, config: AlwaysOnPersistedConfig): void;
+/**
+ * Merge a partial config update over the persisted baseline. Used by the
+ * agent handler so the UI can PATCH only `{mode}` or `{pausedUntil}` without
+ * having to reconstruct dailyBudget client-side.
+ *
+ * `pausedUntil: null` (or empty string) clears the pause; omitting it leaves
+ * the existing value alone.
+ */
+export declare function mergeAlwaysOnConfig(current: AlwaysOnPersistedConfig, patch: Omit<Partial<AlwaysOnConfig>, "pausedUntil" | "lastIntrospectionAt" | "lastIntrospectionRejected" | "pendingIntrospectionSwarmId" | "pendingIntrospectionWorkspaceCwd"> & {
+    pausedUntil?: string | null;
+    lastIntrospectionAt?: string | null;
+    lastIntrospectionRejected?: boolean | null;
+    pendingIntrospectionSwarmId?: string | null;
+    pendingIntrospectionWorkspaceCwd?: string | null;
+}): AlwaysOnPersistedConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/always-on/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/always-on/config.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,yBAAyB;IACxC,qDAAqD;IACrD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mEAAmE;IACnE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,YAAY,CAAC;IAChD,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,WAAW,CAAC,EAAE,yBAAyB,CAAC;IACxC;;;;OAIG;IACH,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;OAKG;IACH,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC;;;;;;;;OAQG;IACH,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC;;;;;;;;;OASG;IACH,gCAAgC,CAAC,EAAE,MAAM,CAAC;CAC3C;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,uBAAuB,GAAG,cAAc,GAAG,oBAAoB,CAAC;AAE5E,eAAO,MAAM,wBAAwB,EAAE,cAGtC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,EAAE,QAAQ,CAAC,yBAAyB,CAK9E,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,oCAAoC,KAAK,CAAC;AAEvD;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,YAAY,CAAC;AAIpD,iFAAiF;AACjF,wBAAgB,QAAQ,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAKxC;AAMD,+FAA+F;AAC/F,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAExE;AA+BD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,CAAC,EAAE,yBAAyB,GAAG,SAAS,GACvC,QAAQ,CAAC,yBAAyB,CAAC,CAErC;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,uBAAuB,CAgEzF;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,uBAAuB,GAC9B,IAAI,CAqFN;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,uBAAuB,EAChC,KAAK,EAAE,IAAI,CACT,OAAO,CAAC,cAAc,CAAC,EACvB,aAAa,GAAG,qBAAqB,GAAG,2BAA2B,GAAG,6BAA6B,GAAG,kCAAkC,CACzI,GAAG;IACF,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,yBAAyB,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3C,2BAA2B,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,gCAAgC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClD,GACA,uBAAuB,CAkEzB"}

package/dist/always-on/config.js

@@ -0,0 +1,324 @@
+// Per-project always-on configuration persistence (M7.2).
+//
+// Stores the user's mode/dailyBudget/pause choice under
+// `<projectRoot>/always-on.json` so M7.3's wired scheduler can rehydrate
+// from disk after an agent restart.
+//
+// Deliberately small + dependency-free: just file I/O + validation.
+// The runtime live state (ticksToday / recentTicks / nextTickAt) belongs
+// to DiscoveryScheduler.snapshot() and is NOT persisted here.
+import { existsSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { projectRoot as projRoot } from "@mclawnet/task";
+export const DEFAULT_ALWAYS_ON_CONFIG = {
+    mode: "off",
+    dailyBudget: 3,
+};
+/**
+ * M8.2 — default opt-in matrix. taskSources field omitted on disk falls back
+ * to this; UI/JSON edits override per-key (omitted keys still resolve to the
+ * default). Introspection stays off so the agent never wakes the user with
+ * auto-discovered ideas unless they've explicitly opted in.
+ */
+export const DEFAULT_ALWAYS_ON_TASK_SOURCES = {
+    taskStore: true,
+    ideaTodo: true,
+    ideaResearch: true,
+    introspection: false,
+};
+/** M8.2 — default cooldown between introspection cycles, in hours. */
+export const DEFAULT_INTROSPECTION_COOLDOWN_HOURS = 24;
+/**
+ * Template used when no override is persisted. "minimal" ships in
+ * `packages/@clawnet/swarm/templates/` and is the safest single-role default —
+ * picked over the legacy `"default"` literal which never had a backing file
+ * and crashed every always-on cycle pre-hotfix (C1).
+ */
+export const DEFAULT_ALWAYS_ON_TEMPLATE = "minimal";
+const CONFIG_FILENAME = "always-on.json";
+/** Local YYYY-MM-DD (NOT UTC) so the daily-budget midnight matches user time. */
+export function localYMD(d) {
+    const y = d.getFullYear();
+    const m = String(d.getMonth() + 1).padStart(2, "0");
+    const day = String(d.getDate()).padStart(2, "0");
+    return `${y}-${m}-${day}`;
+}
+function configPath(workDir, home) {
+    return join(projRoot(workDir, home), CONFIG_FILENAME);
+}
+/** Public so the agent boot scanner can distinguish "no config" from "corrupt config" (I4). */
+export function alwaysOnConfigPath(workDir, home) {
+    return configPath(workDir, home);
+}
+function validMode(m) {
+    return m === "off" || m === "quiet" || m === "active" || m === "aggressive";
+}
+function validBudget(n) {
+    return typeof n === "number" && Number.isInteger(n) && n >= 1 && n <= 20;
+}
+function validCooldownHours(n) {
+    return typeof n === "number" && Number.isFinite(n) && n >= 0 && n <= 24 * 30;
+}
+/**
+ * Coerce an opaque value into a clean AlwaysOnTaskSourcesConfig. Unknown keys
+ * are dropped; non-boolean values are dropped (NOT coerced) so a typo doesn't
+ * silently flip a source on/off. Returns undefined when the input has no
+ * recognisable keys — caller stores nothing on disk in that case.
+ */
+function sanitiseTaskSources(v) {
+    if (!v || typeof v !== "object" || Array.isArray(v))
+        return undefined;
+    const src = v;
+    const out = {};
+    if (typeof src.taskStore === "boolean")
+        out.taskStore = src.taskStore;
+    if (typeof src.ideaTodo === "boolean")
+        out.ideaTodo = src.ideaTodo;
+    if (typeof src.ideaResearch === "boolean")
+        out.ideaResearch = src.ideaResearch;
+    if (typeof src.introspection === "boolean")
+        out.introspection = src.introspection;
+    return Object.keys(out).length === 0 ? undefined : out;
+}
+/**
+ * Merge a (possibly partial) taskSources object over the defaults, returning
+ * a fully-resolved record with every field present. The runtime always-on
+ * cascade reads this — undefined would force every caller to remember the
+ * defaults.
+ */
+export function resolveTaskSources(v) {
+    return { ...DEFAULT_ALWAYS_ON_TASK_SOURCES, ...(v ?? {}) };
+}
+export function loadAlwaysOnConfig(workDir, home) {
+    const path = configPath(workDir, home);
+    if (!existsSync(path))
+        return { ...DEFAULT_ALWAYS_ON_CONFIG };
+    try {
+        const data = JSON.parse(readFileSync(path, "utf-8"));
+        const cfg = {
+            mode: validMode(data.mode) ? data.mode : DEFAULT_ALWAYS_ON_CONFIG.mode,
+            dailyBudget: validBudget(data.dailyBudget)
+                ? data.dailyBudget
+                : DEFAULT_ALWAYS_ON_CONFIG.dailyBudget,
+            ...(typeof data.pausedUntil === "string" ? { pausedUntil: data.pausedUntil } : {}),
+            ...(typeof data.templateName === "string" && data.templateName.length > 0
+                ? { templateName: data.templateName }
+                : {}),
+        };
+        // M8.2 — task source toggles + introspection cooldown / runtime state.
+        const ts = sanitiseTaskSources(data.taskSources);
+        if (ts)
+            cfg.taskSources = ts;
+        if (validCooldownHours(data.introspectionCooldownHours)) {
+            cfg.introspectionCooldownHours = data.introspectionCooldownHours;
+        }
+        if (typeof data.lastIntrospectionAt === "string") {
+            cfg.lastIntrospectionAt = data.lastIntrospectionAt;
+        }
+        if (typeof data.lastIntrospectionRejected === "boolean") {
+            cfg.lastIntrospectionRejected = data.lastIntrospectionRejected;
+        }
+        if (typeof data.pendingIntrospectionSwarmId === "string" && data.pendingIntrospectionSwarmId.length > 0) {
+            cfg.pendingIntrospectionSwarmId = data.pendingIntrospectionSwarmId;
+        }
+        if (typeof data.pendingIntrospectionWorkspaceCwd === "string" && data.pendingIntrospectionWorkspaceCwd.length > 0) {
+            cfg.pendingIntrospectionWorkspaceCwd = data.pendingIntrospectionWorkspaceCwd;
+        }
+        // M7.3 runtime counters — best-effort restoration; bad shape drops silently.
+        if (typeof data.ticksToday === "number" &&
+            Number.isInteger(data.ticksToday) &&
+            data.ticksToday >= 0) {
+            cfg.ticksToday = data.ticksToday;
+        }
+        if (typeof data.ticksTodayDate === "string" &&
+            /^\d{4}-\d{2}-\d{2}$/.test(data.ticksTodayDate)) {
+            cfg.ticksTodayDate = data.ticksTodayDate;
+        }
+        if (typeof data.lastFireAt === "string") {
+            cfg.lastFireAt = data.lastFireAt;
+        }
+        return cfg;
+    }
+    catch (err) {
+        // Corrupt JSON / unreadable file → fall back to defaults so the user
+        // can still toggle the UI; their bad file gets replaced on next save.
+        // Hotfix I4: surface the failure so an unrecoverable file doesn't silently
+        // disable always-on across an agent restart.
+        // eslint-disable-next-line no-console
+        console.warn(`[always-on] config corrupt at ${path}; falling back to defaults: ${err instanceof Error ? err.message : String(err)}`);
+        return { ...DEFAULT_ALWAYS_ON_CONFIG };
+    }
+}
+export function saveAlwaysOnConfig(workDir, home, config) {
+    const path = configPath(workDir, home);
+    mkdirSync(dirname(path), { recursive: true });
+    // Validate before writing; bad values get coerced to defaults rather than
+    // silently persisted.
+    const safe = {
+        mode: validMode(config.mode) ? config.mode : DEFAULT_ALWAYS_ON_CONFIG.mode,
+        dailyBudget: validBudget(config.dailyBudget)
+            ? config.dailyBudget
+            : DEFAULT_ALWAYS_ON_CONFIG.dailyBudget,
+        ...(typeof config.pausedUntil === "string"
+            ? { pausedUntil: config.pausedUntil }
+            : {}),
+        ...(typeof config.templateName === "string" && config.templateName.length > 0
+            ? { templateName: config.templateName }
+            : {}),
+        ...(typeof config.ticksToday === "number" &&
+            Number.isInteger(config.ticksToday) &&
+            config.ticksToday >= 0
+            ? { ticksToday: config.ticksToday }
+            : {}),
+        ...(typeof config.ticksTodayDate === "string" &&
+            /^\d{4}-\d{2}-\d{2}$/.test(config.ticksTodayDate)
+            ? { ticksTodayDate: config.ticksTodayDate }
+            : {}),
+        ...(typeof config.lastFireAt === "string" ? { lastFireAt: config.lastFireAt } : {}),
+    };
+    // M8.2 — round-trip task sources + introspection state. Sanitise on the
+    // way out too so a hand-edited config that smuggled a non-boolean doesn't
+    // get re-persisted.
+    const ts = sanitiseTaskSources(config.taskSources);
+    if (ts)
+        safe.taskSources = ts;
+    if (validCooldownHours(config.introspectionCooldownHours)) {
+        safe.introspectionCooldownHours = config.introspectionCooldownHours;
+    }
+    if (typeof config.lastIntrospectionAt === "string") {
+        safe.lastIntrospectionAt = config.lastIntrospectionAt;
+    }
+    if (typeof config.lastIntrospectionRejected === "boolean") {
+        safe.lastIntrospectionRejected = config.lastIntrospectionRejected;
+    }
+    if (typeof config.pendingIntrospectionSwarmId === "string" && config.pendingIntrospectionSwarmId.length > 0) {
+        safe.pendingIntrospectionSwarmId = config.pendingIntrospectionSwarmId;
+    }
+    if (typeof config.pendingIntrospectionWorkspaceCwd === "string" && config.pendingIntrospectionWorkspaceCwd.length > 0) {
+        safe.pendingIntrospectionWorkspaceCwd = config.pendingIntrospectionWorkspaceCwd;
+    }
+    // R3 I-F: atomic write. `writeFileSync` is `open(O_TRUNC) + write` — a
+    // concurrent reader (per-pick filter reads always-on.json on every tick)
+    // landing in the truncate-then-write window sees an empty/truncated file
+    // and loadAlwaysOnConfig silently falls back to DEFAULT_ALWAYS_ON_CONFIG,
+    // temporarily forcing mode=off + budget=3 + introspection=off until the
+    // write completes. Worse: a crash in the window loses ticksToday +
+    // pendingIntrospectionSwarmId. Fix: write to <path>.tmp then rename —
+    // atomic on POSIX. Mirrors the .1 backup rename used by always-on.log
+    // rotation. On stringify failure we clean up the .tmp so a partial file
+    // doesn't accumulate.
+    const tmpPath = `${path}.tmp`;
+    let serialised;
+    try {
+        serialised = JSON.stringify(safe, null, 2);
+    }
+    catch (err) {
+        // Defensive: shouldn't happen for our flat config shape, but a circular
+        // ref or BigInt would throw. Surface it so callers see the failure.
+        try {
+            unlinkSync(tmpPath);
+        }
+        catch {
+            /* nothing to clean if it doesn't exist */
+        }
+        throw err;
+    }
+    try {
+        writeFileSync(tmpPath, serialised, "utf-8");
+        renameSync(tmpPath, path);
+    }
+    catch (err) {
+        // Best-effort .tmp cleanup so a failed write doesn't leave behind a
+        // half-written sidecar. Swallow the cleanup error (the original error
+        // is what callers care about).
+        try {
+            unlinkSync(tmpPath);
+        }
+        catch {
+            /* may not exist if writeFileSync failed before open */
+        }
+        throw err;
+    }
+}
+/**
+ * Merge a partial config update over the persisted baseline. Used by the
+ * agent handler so the UI can PATCH only `{mode}` or `{pausedUntil}` without
+ * having to reconstruct dailyBudget client-side.
+ *
+ * `pausedUntil: null` (or empty string) clears the pause; omitting it leaves
+ * the existing value alone.
+ */
+export function mergeAlwaysOnConfig(current, patch) {
+    const next = { ...current };
+    if (patch.mode !== undefined && validMode(patch.mode))
+        next.mode = patch.mode;
+    if (patch.dailyBudget !== undefined && validBudget(patch.dailyBudget)) {
+        next.dailyBudget = patch.dailyBudget;
+    }
+    if (patch.templateName !== undefined) {
+        if (typeof patch.templateName === "string" && patch.templateName.length > 0) {
+            next.templateName = patch.templateName;
+        }
+    }
+    if ("pausedUntil" in patch) {
+        const v = patch.pausedUntil;
+        if (v === null || v === "" || v === undefined) {
+            delete next.pausedUntil;
+        }
+        else if (typeof v === "string") {
+            next.pausedUntil = v;
+        }
+    }
+    // M8.2 — taskSources: shallow merge over the existing record (not the
+    // defaults) so a patch with only { introspection: true } leaves the other
+    // toggles at whatever the user last set.
+    if (patch.taskSources !== undefined) {
+        const sanitised = sanitiseTaskSources(patch.taskSources);
+        if (sanitised) {
+            next.taskSources = { ...(next.taskSources ?? {}), ...sanitised };
+        }
+    }
+    if (patch.introspectionCooldownHours !== undefined) {
+        if (validCooldownHours(patch.introspectionCooldownHours)) {
+            next.introspectionCooldownHours = patch.introspectionCooldownHours;
+        }
+    }
+    if ("lastIntrospectionAt" in patch) {
+        const v = patch.lastIntrospectionAt;
+        if (v === null || v === "") {
+            delete next.lastIntrospectionAt;
+        }
+        else if (typeof v === "string") {
+            next.lastIntrospectionAt = v;
+        }
+    }
+    if ("lastIntrospectionRejected" in patch) {
+        const v = patch.lastIntrospectionRejected;
+        if (v === null) {
+            delete next.lastIntrospectionRejected;
+        }
+        else if (typeof v === "boolean") {
+            next.lastIntrospectionRejected = v;
+        }
+    }
+    if ("pendingIntrospectionSwarmId" in patch) {
+        const v = patch.pendingIntrospectionSwarmId;
+        if (v === null || v === "") {
+            delete next.pendingIntrospectionSwarmId;
+        }
+        else if (typeof v === "string") {
+            next.pendingIntrospectionSwarmId = v;
+        }
+    }
+    if ("pendingIntrospectionWorkspaceCwd" in patch) {
+        const v = patch.pendingIntrospectionWorkspaceCwd;
+        if (v === null || v === "") {
+            delete next.pendingIntrospectionWorkspaceCwd;
+        }
+        else if (typeof v === "string") {
+            next.pendingIntrospectionWorkspaceCwd = v;
+        }
+    }
+    return next;
+}
+//# sourceMappingURL=config.js.map

package/dist/always-on/config.js.map

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

package/dist/always-on/discovery-scheduler.d.ts

@@ -0,0 +1,60 @@
+import { AlwaysOnMode, DiscoverySchedulerOptions, DiscoverySchedulerSnapshot, TickRecord } from "./types.js";
+export declare class DiscoveryScheduler {
+    private mode;
+    private tickIntervalOverride;
+    private dailyBudget;
+    private userGates;
+    private onFire;
+    private onTick;
+    private now;
+    private timer;
+    private running;
+    private halted;
+    private inFlight;
+    private ticksToday;
+    private lastFireAt;
+    private recentTicks;
+    private nextTickAt;
+    constructor(opts: DiscoverySchedulerOptions);
+    /** Start the tick loop. No-op when mode === "off" or scheduler is halted. */
+    start(): void;
+    /** Stop the tick loop. Idempotent. */
+    stop(): void;
+    /**
+     * 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.
+     */
+    tickNow(): Promise<TickRecord>;
+    /** Change mode at runtime. Cancels current timer and reschedules. */
+    setMode(mode: AlwaysOnMode): void;
+    /**
+     * 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: number | null): void;
+    /**
+     * 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: {
+        ticksToday: number;
+        lastFireAt: Date | null;
+    }): void;
+    snapshot(): DiscoverySchedulerSnapshot;
+    private currentInterval;
+    /**
+     * 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.
+     */
+    private schedule;
+    private runTick;
+    /** Built-ins (in order) then user gates. */
+    private buildGateChain;
+    private pushRecent;
+}
+//# sourceMappingURL=discovery-scheduler.d.ts.map

package/dist/always-on/discovery-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-scheduler.d.ts","sourceRoot":"","sources":["../../src/always-on/discovery-scheduler.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,YAAY,EAGZ,yBAAyB,EACzB,0BAA0B,EAK1B,UAAU,EACX,MAAM,YAAY,CAAC;AAIpB,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,IAAI,CAAe;IAC3B,OAAO,CAAC,oBAAoB,CAAqB;IACjD,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAoD;IAClE,OAAO,CAAC,MAAM,CAA6C;IAC3D,OAAO,CAAC,GAAG,CAAa;IAExB,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAS;IAEzB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,UAAU,CAAqB;gBAE3B,IAAI,EAAE,yBAAyB;IAU3C,6EAA6E;IAC7E,KAAK,IAAI,IAAI;IAUb,sCAAsC;IACtC,IAAI,IAAI,IAAI;IASZ;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;IAOpC,qEAAqE;IACrE,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IASjC;;;;OAIG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAI3C;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,IAAI,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI;IAW1E,QAAQ,IAAI,0BAA0B;IAYtC,OAAO,CAAC,eAAe;IAMvB;;;;OAIG;IACH,OAAO,CAAC,QAAQ;YAoCF,OAAO;IA8FrB,4CAA4C;IAC5C,OAAO,CAAC,cAAc;IAyBtB,OAAO,CAAC,UAAU;CAMnB"}