@senpi/runtime 3.0.117 → 3.0.122

package/dist/runtime/lifecycle-reaper.d.ts

@@ -0,0 +1,202 @@
+/**
+ * The lifecycle reaper: a runtime exists iff its strategy is open.
+ *
+ * Every close path — raw `strategy_close`, close.py, the web app, a withdraw to $0,
+ * `strategy_close_positions` — ends at the backend, and none of them tells the box. Without this
+ * module a closed strategy's runtime keeps scanning, logging and posting until something deletes it
+ * by hand; boot (since 3.0.119) merely declines to start it again, leaving the registry row behind.
+ * The reaper reads strategy status for every registered wallet and removes the runtimes whose
+ * strategy the platform reports gone.
+ *
+ * Safety invariant — deletion needs POSITIVE evidence: `CLOSED` from a successful read. That is the
+ * only thing the reaper ever deletes on.
+ * Any other dead status (`dead_not_closed`: FAILED, and the INACTIVE/TERMINATED/CLOSING_DONE names
+ * `isDead` also accepts) is reported and never deleted. Only CLOSED means a close ran: strategy-manager
+ * reaches it through the offboarding flow, which closes the positions first. FAILED is written by
+ * onboarding's final-failure path, which refunds the withdrawable balance but closes nothing, and a
+ * FAILED strategy cannot be closed afterwards (CloseStrategy accepts only ACTIVE or PAUSED). If it
+ * holds positions, the runtime's DSL is their only stop, and deleting the runtime tears it down.
+ * A wallet missing from a successful read (`wallet_absent`) is reported and never deleted: real
+ * absence is an edge case (0 of ~345 boot wallets over 7 days), while a well-formed answer can omit
+ * a live wallet (the backend's address filter is case-sensitive and scoped to the token's user).
+ * A failed, timed-out or unrecognisable read, a closing / live / paused / unknown status, and a row
+ * without a usable wallet never delete anything.
+ */
+import type { EmittableEvent } from "../actions/event-derivation.js";
+import type { ReapTrigger } from "../utils/event-catalog.js";
+import { type WalletStatusRow } from "./boot-skip.js";
+/**
+ * What `runtime list` says about a runtime's strategy, as last read.
+ *
+ * - `open` — ACTIVE, PAUSED, initializing, or any status the reaper does not recognise as gone.
+ * - `closing` — a teardown is under way (`CLOSING_POSITIONS`, …); re-checked next pass.
+ * - `closed` — the platform reports a dead status.
+ * - `absent` — a confirmed read carried no strategy for the wallet.
+ * - `unchecked` — not read yet in this process, or never confirmed.
+ * - `unknown` — the row has no usable wallet; its lifecycle cannot be read at all.
+ */
+export type RuntimeLifecycle = "open" | "closing" | "closed" | "absent" | "unchecked" | "unknown";
+/** One successful status read, as the decision needs it. */
+export interface StatusAnswer {
+    /** Lower-cased wallet → platform status, for the wallets the answer carried. */
+    readonly statuses: ReadonlyMap<string, string>;
+}
+/** The verdict for one registry row. */
+export type ReapDecision = 
+/** No usable wallet: never judged, rendered `unknown`. */
+{
+    action: "untracked";
+} | {
+    action: "keep";
+    lifecycle: "open" | "closing";
+    status: string;
+} | {
+    action: "reap";
+    reason: "closed_status";
+    status: string;
+}
+/** Missing from a successful answer: reported, never deleted. */
+ | {
+    action: "hold";
+    reason: "wallet_absent";
+}
+/** Dead, but not CLOSED: no close ran, so it may still hold positions. Reported, never deleted. */
+ | {
+    action: "hold";
+    reason: "dead_not_closed";
+    status: string;
+};
+/**
+ * Decide one registry row against one successful status read.
+ *
+ * A failed read never reaches this function — the controller skips the whole pass — so "unreadable"
+ * cannot be mistaken for "absent" here by construction.
+ */
+export declare function decideReap(entry: {
+    id: string;
+    wallet?: string;
+}, answer: StatusAnswer): ReapDecision;
+/**
+ * The lifecycle a read status maps to; `undefined` means the (confirmed) answer did not carry the
+ * wallet.
+ */
+export declare function lifecycleForStatus(status: string | undefined): RuntimeLifecycle;
+/**
+ * Release default for deleting candidates. `false` = observe-only: candidates are emitted as
+ * `runtime.reap_candidate` and nothing is deleted. It flips in the release after the observe-only
+ * fleet validation (plan Task 8); `SENPI_REAPER_ENFORCE` overrides it per box.
+ */
+export declare const REAPER_ENFORCEMENT_DEFAULT = false;
+/** Delay between `start()` completing and the post-boot pass — lets MCP and the gateway settle. */
+export declare const REAPER_BOOT_DELAY_MS = 120000;
+/** Sweep cadence. Bounds how long a closed strategy that never trades keeps its runtime. */
+export declare const REAPER_SWEEP_INTERVAL_MS: number;
+/**
+ * Per-wallet debounce for the `STRATEGY_NOT_ACTIVE` escalation. Matches the backend-pause TTL: the
+ * open action re-probes a paused wallet about that often, and each rejection would otherwise re-read.
+ */
+export declare const REAPER_WALLET_DEBOUNCE_MS: number;
+/**
+ * Whether this box deletes candidates. `SENPI_REAPER_ENFORCE=true|false` wins; any other value (or
+ * none) falls back to {@link REAPER_ENFORCEMENT_DEFAULT} — a typo must never turn deletion on.
+ */
+export declare function resolveReaperEnforcement(env: NodeJS.ProcessEnv): boolean;
+/**
+ * An explicit post-boot delay from `SENPI_REAPER_BOOT_DELAY_MS` (a non-negative integer), else
+ * `undefined`. For dev-box testing (run the post-boot pass at once) and the plugin tests; being set
+ * at all also arms the reaper's timers where the unit-test seam `SENPI_RUNTIME_API_DISABLED` would
+ * otherwise keep them off.
+ */
+export declare function resolveReaperBootDelayMs(env: NodeJS.ProcessEnv): number | undefined;
+/**
+ * How long `stop()` waits for a pass already under way to finish its current step. A pass checks
+ * for the stop before every delete, so this bounds one status read or one delete, not a whole pass.
+ */
+export declare const REAPER_STOP_DRAIN_MS = 10000;
+/**
+ * How long the reaper waits on one delete. The delete's DSL teardown and `stop()` have no deadline
+ * of their own; without this, one that never settles holds the single-flight slot forever and every
+ * later sweep and not-active check silently does nothing until restart. On expiry the delete is
+ * logged as not removed, the pass moves on, and the delete itself keeps running in the background.
+ * It still holds the runtime's change lock, so a later pass's attempt on that id is a CONFLICT, not
+ * a second delete.
+ */
+export declare const REAPER_DELETE_TIMEOUT_MS: number;
+/** Result of one delete attempt, as the reaper needs it. */
+export type ReaperDeleteResult = {
+    ok: true;
+} | {
+    ok: false;
+    code: string;
+    message: string;
+};
+/**
+ * Everything the reaper touches, injected so the controller is testable without a gateway.
+ * `index.ts` wires these to the registry, `SenpiClient.listStrategies` and `deleteRuntimeCore`.
+ */
+export interface LifecycleReaperDeps {
+    readRegistry(): Promise<{
+        runtimes: ReadonlyArray<{
+            id: string;
+            wallet?: string;
+        }>;
+    }>;
+    /** One `strategy_list` call for these (lower-cased) wallets. Throws on any failure. */
+    readStatuses(wallets: string[], signal: AbortSignal): Promise<readonly WalletStatusRow[]>;
+    /**
+     * Remove one runtime. `wallet` is the lower-cased wallet the decision was made about; the delete
+     * refuses (`ok: false`) if the row under `id` no longer carries it or an install/deploy is running.
+     */
+    deleteRuntime(id: string, reason: "closed_status", wallet: string): Promise<ReaperDeleteResult>;
+    emit(build: () => EmittableEvent | null): void;
+    /** Delete candidates (true) or only report them (false). */
+    enforce: boolean;
+    logger: {
+        info(message: string, meta?: object): void;
+        warn(message: string, meta?: object): void;
+    };
+    readTimeoutMs?: number;
+    bootDelayMs?: number;
+    sweepIntervalMs?: number;
+    walletDebounceMs?: number;
+    now?: () => number;
+    stopDrainMs?: number;
+    deleteTimeoutMs?: number;
+}
+/** The reaper as `index.ts` drives it. No method ever throws or rejects. */
+export interface LifecycleReaper {
+    /**
+     * One pass: read the registry, read every trackable wallet's status in one bounded call, judge
+     * each row, and (when enforcing) delete the actionable candidates. `onlyWallet` narrows the pass
+     * to that wallet's rows. Single-flight: a pass requested while one runs returns at once.
+     */
+    runPass(trigger: ReapTrigger, onlyWallet?: string): Promise<void>;
+    /**
+     * Escalation entry point: a debounced, fire-and-forget pass over one wallet. A no-op until
+     * `start()` — boot is still wiring runtimes before that.
+     */
+    checkWallet(wallet: string): void;
+    /** Remember statuses read elsewhere (the boot read) so `lifecycleOf` has them before any pass. */
+    recordStatuses(requested: readonly string[], statuses: ReadonlyMap<string, string>): void;
+    /** The last known lifecycle of a registry wallet, and the status it came from. */
+    lifecycleOf(wallet: string | undefined): {
+        lifecycle: RuntimeLifecycle;
+        strategyStatus?: string;
+    };
+    /**
+     * Schedule the post-boot pass and the hourly sweep. Both timers are unref'd. Re-arms a stopped
+     * reaper (a service restart in the same process); a no-op while already started.
+     */
+    start(): void;
+    /**
+     * Clear the timers and wait (bounded by {@link REAPER_STOP_DRAIN_MS}) for a pass already running
+     * to finish, so no reaper delete overlaps the service teardown. Any pass until the next `start()`
+     * is a no-op.
+     */
+    stop(): Promise<void>;
+}
+/**
+ * Build the reaper. Construction does no I/O; nothing happens until `start()` or `runPass()`.
+ */
+export declare function createLifecycleReaper(deps: LifecycleReaperDeps): LifecycleReaper;
+//# sourceMappingURL=lifecycle-reaper.d.ts.map

package/dist/runtime/lifecycle-reaper.d.ts.map

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

package/dist/runtime/lifecycle-reaper.js

@@ -0,0 +1,390 @@
+/**
+ * The lifecycle reaper: a runtime exists iff its strategy is open.
+ *
+ * Every close path — raw `strategy_close`, close.py, the web app, a withdraw to $0,
+ * `strategy_close_positions` — ends at the backend, and none of them tells the box. Without this
+ * module a closed strategy's runtime keeps scanning, logging and posting until something deletes it
+ * by hand; boot (since 3.0.119) merely declines to start it again, leaving the registry row behind.
+ * The reaper reads strategy status for every registered wallet and removes the runtimes whose
+ * strategy the platform reports gone.
+ *
+ * Safety invariant — deletion needs POSITIVE evidence: `CLOSED` from a successful read. That is the
+ * only thing the reaper ever deletes on.
+ * Any other dead status (`dead_not_closed`: FAILED, and the INACTIVE/TERMINATED/CLOSING_DONE names
+ * `isDead` also accepts) is reported and never deleted. Only CLOSED means a close ran: strategy-manager
+ * reaches it through the offboarding flow, which closes the positions first. FAILED is written by
+ * onboarding's final-failure path, which refunds the withdrawable balance but closes nothing, and a
+ * FAILED strategy cannot be closed afterwards (CloseStrategy accepts only ACTIVE or PAUSED). If it
+ * holds positions, the runtime's DSL is their only stop, and deleting the runtime tears it down.
+ * A wallet missing from a successful read (`wallet_absent`) is reported and never deleted: real
+ * absence is an edge case (0 of ~345 boot wallets over 7 days), while a well-formed answer can omit
+ * a live wallet (the backend's address filter is case-sensitive and scoped to the token's user).
+ * A failed, timed-out or unrecognisable read, a closing / live / paused / unknown status, and a row
+ * without a usable wallet never delete anything.
+ */
+import { isClosing, isDead } from "../senpi/strategy-status.js";
+import { isTrackableWallet, readBootWalletStatuses, trackableWalletKeys, } from "./boot-skip.js";
+import { buildReapCandidateEvent, buildReapSkippedEvent, buildReapUnknownWalletEvent, } from "./lifecycle-events.js";
+/** The one status the reaper deletes on; see the module doc for why the other dead ones are held. */
+const REAPABLE_STATUS = "CLOSED";
+/**
+ * Decide one registry row against one successful status read.
+ *
+ * A failed read never reaches this function — the controller skips the whole pass — so "unreadable"
+ * cannot be mistaken for "absent" here by construction.
+ */
+export function decideReap(entry, answer) {
+    if (!isTrackableWallet(entry.wallet))
+        return { action: "untracked" };
+    const status = answer.statuses.get(entry.wallet.trim().toLowerCase());
+    if (status === undefined)
+        return { action: "hold", reason: "wallet_absent" };
+    if (isDead(status)) {
+        return status.toUpperCase() === REAPABLE_STATUS
+            ? { action: "reap", reason: "closed_status", status }
+            : { action: "hold", reason: "dead_not_closed", status };
+    }
+    if (isClosing(status))
+        return { action: "keep", lifecycle: "closing", status };
+    // ACTIVE, PAUSED, initializing, MANUAL_REVIEW, or a status added after this release: all alive
+    // as far as the reaper is concerned. Reaping requires positive death.
+    return { action: "keep", lifecycle: "open", status };
+}
+/**
+ * The lifecycle a read status maps to; `undefined` means the (confirmed) answer did not carry the
+ * wallet.
+ */
+export function lifecycleForStatus(status) {
+    if (status === undefined)
+        return "absent";
+    if (isDead(status))
+        return "closed";
+    if (isClosing(status))
+        return "closing";
+    return "open";
+}
+// ── Controller ──────────────────────────────────────────────────────────────────────────────────
+/**
+ * Release default for deleting candidates. `false` = observe-only: candidates are emitted as
+ * `runtime.reap_candidate` and nothing is deleted. It flips in the release after the observe-only
+ * fleet validation (plan Task 8); `SENPI_REAPER_ENFORCE` overrides it per box.
+ */
+export const REAPER_ENFORCEMENT_DEFAULT = false;
+/** Delay between `start()` completing and the post-boot pass — lets MCP and the gateway settle. */
+export const REAPER_BOOT_DELAY_MS = 120_000;
+/** Sweep cadence. Bounds how long a closed strategy that never trades keeps its runtime. */
+export const REAPER_SWEEP_INTERVAL_MS = 60 * 60 * 1000;
+/**
+ * Per-wallet debounce for the `STRATEGY_NOT_ACTIVE` escalation. Matches the backend-pause TTL: the
+ * open action re-probes a paused wallet about that often, and each rejection would otherwise re-read.
+ */
+export const REAPER_WALLET_DEBOUNCE_MS = 5 * 60 * 1000;
+/**
+ * Whether this box deletes candidates. `SENPI_REAPER_ENFORCE=true|false` wins; any other value (or
+ * none) falls back to {@link REAPER_ENFORCEMENT_DEFAULT} — a typo must never turn deletion on.
+ */
+export function resolveReaperEnforcement(env) {
+    const raw = env.SENPI_REAPER_ENFORCE?.trim().toLowerCase();
+    if (raw === "true")
+        return true;
+    if (raw === "false")
+        return false;
+    return REAPER_ENFORCEMENT_DEFAULT;
+}
+/**
+ * An explicit post-boot delay from `SENPI_REAPER_BOOT_DELAY_MS` (a non-negative integer), else
+ * `undefined`. For dev-box testing (run the post-boot pass at once) and the plugin tests; being set
+ * at all also arms the reaper's timers where the unit-test seam `SENPI_RUNTIME_API_DISABLED` would
+ * otherwise keep them off.
+ */
+export function resolveReaperBootDelayMs(env) {
+    const raw = env.SENPI_REAPER_BOOT_DELAY_MS?.trim();
+    if (raw === undefined || !/^\d+$/.test(raw))
+        return undefined;
+    return Number(raw);
+}
+/**
+ * How long `stop()` waits for a pass already under way to finish its current step. A pass checks
+ * for the stop before every delete, so this bounds one status read or one delete, not a whole pass.
+ */
+export const REAPER_STOP_DRAIN_MS = 10_000;
+/**
+ * How long the reaper waits on one delete. The delete's DSL teardown and `stop()` have no deadline
+ * of their own; without this, one that never settles holds the single-flight slot forever and every
+ * later sweep and not-active check silently does nothing until restart. On expiry the delete is
+ * logged as not removed, the pass moves on, and the delete itself keeps running in the background.
+ * It still holds the runtime's change lock, so a later pass's attempt on that id is a CONFLICT, not
+ * a second delete.
+ */
+export const REAPER_DELETE_TIMEOUT_MS = 5 * 60 * 1000;
+/** Marker for a wallet a confirmed answer did not carry. */
+const ABSENT = Symbol("absent");
+/**
+ * Build the reaper. Construction does no I/O; nothing happens until `start()` or `runPass()`.
+ */
+export function createLifecycleReaper(deps) {
+    const now = deps.now ?? Date.now;
+    const debounceMs = deps.walletDebounceMs ?? REAPER_WALLET_DEBOUNCE_MS;
+    const lastWalletCheck = new Map();
+    const lastStatus = new Map();
+    const reportedUnknown = new Set();
+    /**
+     * What each runtime was last reported as a candidate for. Every sweep re-reads every row, so a
+     * candidate that stays put would log the same warn 24 times a day, and a count of candidate events
+     * would overstate distinct runtimes. A runtime is reported again when its reason, status or wallet
+     * changes, or when it stops being a candidate and becomes one again. Per process: a restart reports
+     * each candidate once more, which also confirms it is still there.
+     */
+    const reportedCandidate = new Map();
+    let bootTimer;
+    let sweepTimer;
+    let stopped = false;
+    /**
+     * Set by `start()`, cleared by `stop()`. `checkWallet` waits for it: boot hands the escalation to
+     * each runtime while later ones are still being wired, and a delete in that window finds no
+     * launcher to stop yet — boot then registers and starts one for a runtime that no longer exists.
+     * The post-boot pass covers anything that escalated earlier.
+     */
+    let started = false;
+    /** Bumped by every `stop()`: a pass started before it stays cancelled even after a restart. */
+    let generation = 0;
+    /** The running pass, if any: the single-flight guard, and what `stop()` drains. */
+    let inFlightPass;
+    function recordStatuses(requested, statuses) {
+        const confirmed = requested.some((w) => statuses.has(w));
+        for (const wallet of requested) {
+            const status = statuses.get(wallet);
+            if (status !== undefined)
+                lastStatus.set(wallet, status);
+            else if (confirmed)
+                lastStatus.set(wallet, ABSENT);
+        }
+    }
+    function lifecycleOf(wallet) {
+        if (!isTrackableWallet(wallet))
+            return { lifecycle: "unknown" };
+        const known = lastStatus.get(wallet.trim().toLowerCase());
+        if (known === undefined)
+            return { lifecycle: "unchecked" };
+        if (known === ABSENT)
+            return { lifecycle: "absent" };
+        return { lifecycle: lifecycleForStatus(known), strategyStatus: known };
+    }
+    /** Emit `runtime.reap_candidate` unless this runtime was already reported for the same thing. */
+    function reportCandidate(input) {
+        const key = `${input.reason}|${input.strategyStatus ?? ""}|${input.address.trim().toLowerCase()}`;
+        if (reportedCandidate.get(input.runtimeId) === key)
+            return;
+        reportedCandidate.set(input.runtimeId, key);
+        deps.emit(() => buildReapCandidateEvent(input));
+    }
+    async function reap(entry, decision, trigger) {
+        const wallet = entry.wallet.trim().toLowerCase();
+        reportCandidate({
+            runtimeId: entry.id,
+            address: wallet,
+            reason: decision.reason,
+            strategyStatus: decision.status,
+            enforce: deps.enforce,
+            actionable: true,
+            trigger,
+        });
+        if (!deps.enforce)
+            return;
+        const timeoutMs = deps.deleteTimeoutMs ?? REAPER_DELETE_TIMEOUT_MS;
+        let deadline;
+        let result;
+        try {
+            result = await Promise.race([
+                deps.deleteRuntime(entry.id, decision.reason, wallet),
+                new Promise((resolve) => {
+                    deadline = setTimeout(() => resolve({
+                        ok: false,
+                        code: "TIMEOUT",
+                        message: `the delete did not finish within ${timeoutMs}ms; it continues in the background`,
+                    }), timeoutMs);
+                    deadline.unref?.();
+                }),
+            ]);
+        }
+        catch (err) {
+            result = { ok: false, code: "THREW", message: err instanceof Error ? err.message : String(err) };
+        }
+        finally {
+            clearTimeout(deadline);
+        }
+        if (result.ok) {
+            // Ids are reused on reinstall; a new runtime under this id that closes again is a new candidate.
+            reportedCandidate.delete(entry.id);
+            deps.logger.info("[senpi-runtime][reaper] removed runtime: its strategy is gone", {
+                runtimeId: entry.id,
+                wallet,
+                reason: decision.reason,
+            });
+        }
+        else {
+            deps.logger.warn("[senpi-runtime][reaper] runtime not removed", {
+                runtimeId: entry.id,
+                wallet,
+                code: result.code,
+                err: result.message,
+            });
+        }
+    }
+    async function pass(trigger, onlyWallet) {
+        const gen = generation;
+        const cancelled = () => stopped || gen !== generation;
+        let runtimes;
+        try {
+            runtimes = (await deps.readRegistry()).runtimes;
+        }
+        catch (err) {
+            deps.logger.warn("[senpi-runtime][reaper] registry unreadable; pass skipped", {
+                err: err instanceof Error ? err.message : String(err),
+            });
+            deps.emit(() => buildReapSkippedEvent({ skipReason: "registry_unreadable", trigger, walletCount: 0 }));
+            return;
+        }
+        const scoped = onlyWallet === undefined
+            ? runtimes
+            : runtimes.filter((e) => isTrackableWallet(e.wallet) && e.wallet.trim().toLowerCase() === onlyWallet);
+        if (onlyWallet === undefined) {
+            for (const entry of scoped) {
+                if (!isTrackableWallet(entry.wallet) && !reportedUnknown.has(entry.id)) {
+                    reportedUnknown.add(entry.id);
+                    deps.emit(() => buildReapUnknownWalletEvent(entry.id));
+                }
+            }
+        }
+        const wallets = trackableWalletKeys(scoped);
+        if (wallets.length === 0 || cancelled())
+            return;
+        const read = await readBootWalletStatuses(wallets, deps.readStatuses, deps.readTimeoutMs);
+        if (!read.ok) {
+            deps.logger.warn("[senpi-runtime][reaper] strategy status unreadable; nothing removed this pass", {
+                trigger,
+                reason: read.reason,
+                err: read.message,
+            });
+            deps.emit(() => buildReapSkippedEvent({
+                skipReason: read.reason === "timeout" ? "read_timeout" : "read_failed",
+                trigger,
+                walletCount: wallets.length,
+            }));
+            return;
+        }
+        recordStatuses(wallets, read.statuses);
+        const answer = { statuses: read.statuses };
+        for (const entry of scoped) {
+            if (cancelled())
+                return;
+            if (!isTrackableWallet(entry.wallet))
+                continue;
+            const decision = decideReap(entry, answer);
+            if (decision.action === "reap") {
+                await reap({ id: entry.id, wallet: entry.wallet }, decision, trigger);
+            }
+            else if (decision.action === "hold") {
+                reportCandidate({
+                    runtimeId: entry.id,
+                    address: entry.wallet,
+                    reason: decision.reason,
+                    strategyStatus: decision.reason === "dead_not_closed" ? decision.status : undefined,
+                    enforce: deps.enforce,
+                    actionable: false,
+                    trigger,
+                });
+            }
+            else {
+                reportedCandidate.delete(entry.id);
+            }
+        }
+        // A full pass saw every registered row: forget runtimes that are no longer registered.
+        if (onlyWallet === undefined && !cancelled()) {
+            const registered = new Set(scoped.map((e) => e.id));
+            for (const id of reportedCandidate.keys()) {
+                if (!registered.has(id))
+                    reportedCandidate.delete(id);
+            }
+        }
+    }
+    async function runPass(trigger, onlyWallet) {
+        if (stopped || inFlightPass !== undefined)
+            return;
+        inFlightPass = (async () => {
+            try {
+                await pass(trigger, onlyWallet?.trim().toLowerCase());
+            }
+            catch (err) {
+                // Backstop: every expected failure is handled inside `pass`; nothing may escape to a timer
+                // callback or to the open action that escalated.
+                deps.logger.warn("[senpi-runtime][reaper] pass failed", {
+                    trigger,
+                    err: err instanceof Error ? err.message : String(err),
+                });
+            }
+        })();
+        try {
+            await inFlightPass;
+        }
+        finally {
+            inFlightPass = undefined;
+        }
+    }
+    function checkWallet(wallet) {
+        if (!started || stopped || inFlightPass !== undefined || !isTrackableWallet(wallet))
+            return;
+        const key = wallet.trim().toLowerCase();
+        const last = lastWalletCheck.get(key);
+        if (last !== undefined && now() - last < debounceMs)
+            return;
+        lastWalletCheck.set(key, now());
+        void runPass("not_active", key);
+    }
+    function start() {
+        if (bootTimer !== undefined)
+            return;
+        // The plugin service can be stopped and started again in one process (as the auto-update
+        // coordinator is); a restart must re-arm the reaper, not leave it silently off.
+        stopped = false;
+        started = true;
+        bootTimer = setTimeout(() => {
+            void runPass("post_boot");
+        }, deps.bootDelayMs ?? REAPER_BOOT_DELAY_MS);
+        bootTimer.unref?.();
+        sweepTimer = setInterval(() => {
+            void runPass("sweep");
+        }, deps.sweepIntervalMs ?? REAPER_SWEEP_INTERVAL_MS);
+        sweepTimer.unref?.();
+    }
+    async function stop() {
+        stopped = true;
+        started = false;
+        generation += 1;
+        if (bootTimer !== undefined)
+            clearTimeout(bootTimer);
+        if (sweepTimer !== undefined)
+            clearInterval(sweepTimer);
+        bootTimer = undefined;
+        sweepTimer = undefined;
+        const running = inFlightPass;
+        if (running === undefined)
+            return;
+        let drainTimer;
+        const drained = await Promise.race([
+            running.then(() => true),
+            new Promise((resolve) => {
+                drainTimer = setTimeout(() => resolve(false), deps.stopDrainMs ?? REAPER_STOP_DRAIN_MS);
+                drainTimer.unref?.();
+            }),
+        ]);
+        clearTimeout(drainTimer);
+        if (!drained) {
+            deps.logger.warn("[senpi-runtime][reaper] a pass was still running at stop; teardown continues without it", {
+                drainMs: deps.stopDrainMs ?? REAPER_STOP_DRAIN_MS,
+            });
+        }
+    }
+    return { runPass, checkWallet, recordStatuses, lifecycleOf, start, stop };
+}
+//# sourceMappingURL=lifecycle-reaper.js.map

package/dist/runtime/lifecycle-reaper.js.map

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

package/dist/runtime/reconcile-run.d.ts

@@ -22,22 +22,12 @@ export interface RunReconcileDeps {
     strategyState: StrategyState;
     senpi: SenpiClient;
     stateManager: StateManager;
-    /**
-     * adoptPosition + resizePosition — satisfied by DslPlugin or a compatible adopter.
-     * The opts shape is stated inline (not imported from the DSL handlers) so the port stays
-     * the narrow thing reconcile actually needs: the tick that caused the adopt, when there is one.
-     */
+    /** adoptPosition + resizePosition — satisfied by DslPlugin or a compatible adopter. */
     adopter: {
-        adoptPosition(p: PositionOpenedEvent, opts?: {
-            tickId?: string;
-        }): Promise<void>;
-        resizePosition(p: PositionOpenedEvent, opts?: {
-            tickId?: string;
-        }): Promise<void>;
+        adoptPosition(p: PositionOpenedEvent): Promise<void>;
+        resizePosition(p: PositionOpenedEvent): Promise<void>;
     };
     bus?: SenpiEventBus;
-    /** The monitor tick driving this reconcile, when one is; absent on the boot reconcile. */
-    tickId?: string;
     /**
      * Serializes the whole fetch+decide+execute pass against the trade loop / other reconciles.
      * Default: run directly (T5 will pass a reconcileMutex-backed serializer).

package/dist/runtime/reconcile-run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reconcile-run.d.ts","sourceRoot":"","sources":["../../src/runtime/reconcile-run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAStD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,aAAa,CAAC;IAC7B,KAAK,EAAE,WAAW,CAAC;IACnB,YAAY,EAAE,YAAY,CAAC;IAC3B;;;;OAIG;IACH,OAAO,EAAE;QACP,aAAa,CAAC,CAAC,EAAE,mBAAmB,EAAE,IAAI,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACjF,cAAc,CAAC,CAAC,EAAE,mBAAmB,EAAE,IAAI,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACnF,CAAC;IACF,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB,0FAA0F;IAC1F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,MAAM,GACd,mBAAmB,CAWrB;AAID,wBAAsB,YAAY,CAChC,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,CAAC,CA6IxD"}
+{"version":3,"file":"reconcile-run.d.ts","sourceRoot":"","sources":["../../src/runtime/reconcile-run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAStD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,aAAa,CAAC;IAC7B,KAAK,EAAE,WAAW,CAAC;IACnB,YAAY,EAAE,YAAY,CAAC;IAC3B,uFAAuF;IACvF,OAAO,EAAE;QACP,aAAa,CAAC,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACrD,cAAc,CAAC,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACvD,CAAC;IACF,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,MAAM,GACd,mBAAmB,CAWrB;AAID,wBAAsB,YAAY,CAChC,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,CAAC,CA2IxD"}