@telora/daemon 0.24.17 → 0.24.26

package/dist/tower/tower-supervisor-session.js

@@ -0,0 +1,307 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/composition/tower-escalation-context.test.ts,
+//   packages/daemon/src/tower/tower-escalation-session.test.ts,
+//   packages/daemon/src/tower/tower-supervisor-session.test.ts,
+//   packages/daemon/src/tower/tower-supervisor.test.ts
+// PINNED-BY-END
+import { createLogger } from '../log/daemon-log.js';
+import { heldLoopOf } from './tower-supervisor-history.js';
+import { buildTowerSupervisorPrompt, parseTowerDecisionLine } from './tower-supervisor-prompt.js';
+import { emptySweepCounts, } from './tower-supervisor.js';
+const log = createLogger({ module: 'tower' });
+export const TOWER_SUPERVISOR_MODEL = 'opus';
+/** Kill a supervisor that has not exited within this window (30 minutes: it may run the disputed tests). */
+export const TOWER_SUPERVISOR_TIMEOUT_MS = 30 * 60 * 1000;
+/** Sessions that ran without deciding, per loop, before the daemon stops trying and files it. */
+export const TOWER_SUPERVISOR_MAX_ATTEMPTS = 2;
+/** Governor engine name for supervisor slots (no per-engine limit: bounded by the global session cap). */
+export const TOWER_SUPERVISOR_GOVERNOR_ENGINE = 'tower-supervisor';
+/**
+ * The scoped MCP profile the supervisor's Telora server runs under
+ * (mcp/telora-products profile-scope.ts TOWER_SUPERVISOR_PROFILE): the tool-level
+ * bound on "it never grants review budget".
+ */
+export const TOWER_SUPERVISOR_MCP_PROFILE = 'tower_supervisor';
+/** escalation_kind of the observation filed when every attempt ran without deciding. */
+export const TOWER_SUPERVISOR_UNDECIDED_KIND = 'tower_supervisor_undecided';
+/**
+ * The tools a supervisor session is pre-approved for: reading and running the
+ * disputed check in the worktree, and the Telora acts it decides through --
+ * the amendment (telora_product_focus amend_criterion), the findings and Tasks
+ * (telora_product_issue), the decision record (telora_product_tower), the one
+ * escalation (telora_agent) -- plus the context it reads. This list only
+ * PRE-APPROVES; what the Telora tools can DO is bounded by the scoped MCP
+ * profile (TOWER_SUPERVISOR_MCP_PROFILE), under which none can arm, unarm or
+ * grant review cycles: the budget is the daemon's.
+ */
+export const TOWER_SUPERVISOR_MCP_TOOLS = [
+    'Read', 'Grep', 'Glob', 'Bash',
+    'mcp__telora-products__telora_product_focus',
+    'mcp__telora-products__telora_product_issue',
+    'mcp__telora-products__telora_product_delivery',
+    'mcp__telora-products__telora_product_tower',
+    'mcp__telora-products__telora_agent',
+    'mcp__telora-products__telora_reality_tree_traverse',
+    'mcp__telora-products__telora_wiki_search',
+];
+/** Pure: the decisions on the record that are ABOUT a loop (evidence.loopDecisionId). */
+export function decisionsAboutLoop(decisions, loopDecisionId) {
+    return decisions.filter((d) => {
+        const ev = d.evidence;
+        return ev !== null && typeof ev === 'object' && ev.loopDecisionId === loopDecisionId;
+    });
+}
+/**
+ * Pure: where a held loop stands on the record. An escalation to the operator
+ * wins over a bound (a supervisor that escalated did not settle it); a
+ * criterion_bounded decision naming the loop settles it only when the edge
+ * reports its bound APPLIED (an amendment of the criterion since detection);
+ * a bound on the record without one is `bound_unapplied`, which releases
+ * nothing; anything else is undecided.
+ */
+export function settlementOf(record, loopDecisionId) {
+    const about = decisionsAboutLoop(record.decisions, loopDecisionId);
+    const escalations = about.filter((d) => d.kind === 'escalated_to_operator');
+    if (escalations.length > 0)
+        return { kind: 'awaiting_operator', escalations };
+    const bounded = about.filter((d) => d.kind === 'criterion_bounded');
+    if (bounded.length === 0)
+        return { kind: 'undecided' };
+    const applied = (record.appliedBounds ?? []).find((b) => b.loopDecisionId === loopDecisionId);
+    return applied && applied.amendmentIds.length > 0
+        ? { kind: 'bounded', bounded, amendmentIds: applied.amendmentIds }
+        : { kind: 'bound_unapplied', bounded };
+}
+/** Pure: the loop_resolved the daemon records once the criterion was bounded. */
+export function loopResolvedDecision(loop, bounded, amendmentIds) {
+    return {
+        focusId: loop.focusId,
+        kind: 'loop_resolved',
+        decidedByKind: 'daemon',
+        summary: `Released the held review loop on criterion "${loop.criterion}": the Tower supervisor bounded it.`,
+        rationale: `The supervisor recorded ${bounded.length} criterion_bounded decision(s) naming this loop and applied the ` +
+            `bound (${amendmentIds.length} amendment(s) of the criterion since the loop was detected), so the criterion ` +
+            'the loop could not converge on now reads as a closed list plus a named judge. The next review is a fresh ' +
+            'session that judges the amended wording.',
+        evidence: {
+            loopDecisionId: loop.towerDecisionId,
+            boundDecisionIds: bounded.map((d) => d.towerDecisionId),
+            amendmentIds: [...amendmentIds],
+            supervisorSessionIds: [...new Set(bounded.map((d) => d.agentSessionId).filter((s) => s !== null))],
+        },
+        criterionKey: loop.criterionKey,
+        nodeId: loop.nodeId,
+        resolvesDecisionId: loop.towerDecisionId,
+    };
+}
+/** Pure: what a finished spawn was -- not run at all (retry, uncounted), or ran. */
+export function spawnRan(result) {
+    return result.started && result.modelUnavailable === undefined;
+}
+/** Pure: a one-line account of a spawn's end. */
+export function describeSpawnEnd(result) {
+    if (result.modelUnavailable)
+        return `model unavailable (${result.modelUnavailable.kind})`;
+    if (!result.started)
+        return result.errorMessage ?? 'did not start';
+    if (result.timedOut)
+        return 'timed out (killed)';
+    const said = parseTowerDecisionLine(result.stdout);
+    return `exited ${result.exitCode ?? 'null'}${result.errorMessage ? ` (${result.errorMessage})` : ''}${said ? `; said "${said}"` : ''}`;
+}
+/** Record loop_resolved for a bounded loop and drop the review directive queued on the old wording. */
+async function release(st, loop, bounded, amendmentIds) {
+    await st.deps.recordTowerDecision(loopResolvedDecision(loop, bounded, amendmentIds));
+    const dropped = st.deps.dropPendingReviewDirective(loop.focusId);
+    log.info(`[tower-supervisor] released the held loop ${loop.towerDecisionId.slice(0, 8)} on "${loop.criterion}": the ` +
+        `criterion was bounded${dropped ? '; dropped the review directive queued on the old wording' : ''}.`);
+    st.attempts.delete(loop.towerDecisionId);
+    return 'resolved';
+}
+/** Every attempt ran without deciding: file the loop for a routing decider and record escalated_to_operator. */
+async function giveUp(st, loop, focus, config, detail) {
+    const tried = st.attempts.get(loop.towerDecisionId) ?? 0;
+    const filed = await st.deps.fileUndecidedLoop({
+        organizationId: config.organizationId, productId: focus.productId, focusId: focus.focusId,
+        escalationKind: TOWER_SUPERVISOR_UNDECIDED_KIND,
+        description: `The review loop of focus "${focus.focusName}" on criterion "${loop.criterion}" is held, and the Tower ` +
+            `supervisor ran ${tried} time(s) without deciding it (last: ${detail}). The focus spawns no coding or ` +
+            'review pass until the criterion is bounded or the operator rules.',
+        whatWasTried: `${tried} one-shot supervisor session(s); none recorded escalated_to_operator, or a criterion_bounded whose ` +
+            'amendment of the criterion landed.',
+        helpNeeded: 'Decide the loop: bound the criterion (telora_product_focus amend_criterion) and record it ' +
+            '(telora_product_tower decision_record criterion_bounded with loopDecisionId), or escalate to the operator.',
+        metadata: { loopDecisionId: loop.towerDecisionId, attempts: tried, lastDetail: detail },
+    });
+    await st.deps.recordTowerDecision({
+        focusId: loop.focusId, kind: 'escalated_to_operator', decidedByKind: 'daemon',
+        summary: `Handed the held review loop on "${loop.criterion}" on: the Tower supervisor could not decide it.`,
+        rationale: `${tried} supervisor session(s) ran and none recorded a decision (last: ${detail}). The daemon stops ` +
+            'spawning supervisors for this loop and files it for a routing decider, which makes it the operator\'s ' +
+            'when only a human can rule. The loop stays held.',
+        evidence: { loopDecisionId: loop.towerDecisionId, attempts: tried, lastDetail: detail },
+        criterionKey: loop.criterionKey, nodeId: loop.nodeId, escalationId: filed.escalationId,
+    });
+    log.warn(`[tower-supervisor] gave up on the held loop ${loop.towerDecisionId.slice(0, 8)} of "${focus.focusName}" after ${tried} attempt(s); filed ${filed.escalationId ?? '(correlated)'}.`);
+}
+/** After a session exits: release a bounded loop, leave an escalated one held, count an undecided run. */
+async function settleAfterRun(st, loop, focus, config, result) {
+    const detail = describeSpawnEnd(result);
+    const record = await st.deps.listTowerDecisions(loop.focusId);
+    const settled = settlementOf(record, loop.towerDecisionId);
+    if (settled.kind === 'bounded') {
+        await release(st, loop, settled.bounded, settled.amendmentIds);
+        return;
+    }
+    if (settled.kind === 'awaiting_operator') {
+        log.info(`[tower-supervisor] the held loop ${loop.towerDecisionId.slice(0, 8)} of "${focus.focusName}" was escalated to the operator; it stays held.`);
+        return;
+    }
+    if (!spawnRan(result)) {
+        log.info(`[tower-supervisor] supervisor for "${focus.focusName}" did not run (${detail}); the next sweep retries.`);
+        return;
+    }
+    const tried = (st.attempts.get(loop.towerDecisionId) ?? 0) + 1;
+    st.attempts.set(loop.towerDecisionId, tried);
+    const outcome = settled.kind === 'bound_unapplied'
+        ? `${detail}, recording criterion_bounded with no amendment of the criterion -- the bound was not applied, so the loop stays held`
+        : `${detail} without deciding`;
+    log.warn(`[tower-supervisor] supervisor for "${focus.focusName}" ${outcome} (attempt ${tried} of ${TOWER_SUPERVISOR_MAX_ATTEMPTS}).`);
+    if (tried >= TOWER_SUPERVISOR_MAX_ATTEMPTS)
+        await giveUp(st, loop, focus, config, settled.kind === 'bound_unapplied' ? `${detail}; bound recorded, never applied` : detail);
+}
+/** One supervisor session, inside a governor slot: gather, prompt, spawn, settle. */
+async function runSession(st, loop, focus, config) {
+    const governor = st.deps.readGovernor();
+    let token = null;
+    if (governor) {
+        token = governor.tryAcquireSlot(TOWER_SUPERVISOR_GOVERNOR_ENGINE);
+        if (!token) {
+            log.info(`[tower-supervisor] no governor slot free for "${focus.focusName}"; the next sweep retries.`);
+            return;
+        }
+    }
+    try {
+        const repoRoot = st.deps.focusWorktreePath(focus.focusId) ?? config.repoPath;
+        const history = await st.deps.gatherHistory({ loop, productId: focus.productId, config, repoRoot });
+        const supervisorSessionId = st.deps.newSessionId();
+        const prompt = buildTowerSupervisorPrompt({ focus, loop, supervisorSessionId, history });
+        log.info(`[tower-supervisor] deciding the held loop ${loop.towerDecisionId.slice(0, 8)} of "${focus.focusName}" (session ${supervisorSessionId.slice(0, 8)}).`);
+        const result = await st.deps.spawn({
+            config, prompt, cwd: repoRoot, focusId: focus.focusId, loopDecisionId: loop.towerDecisionId,
+            model: TOWER_SUPERVISOR_MODEL, timeoutMs: TOWER_SUPERVISOR_TIMEOUT_MS, allowedTools: TOWER_SUPERVISOR_MCP_TOOLS,
+        });
+        await settleAfterRun(st, loop, focus, config, result);
+    }
+    finally {
+        if (token && governor)
+            governor.releaseSlot(token);
+    }
+}
+/** One supervision step for one held loop; starts a session in the background when one is owed. Never throws. */
+async function supervise(st, loopDecision, productId, known) {
+    const loopId = loopDecision.towerDecisionId;
+    if (st.inFlight.has(loopId))
+        return 'in_flight';
+    try {
+        const loop = heldLoopOf(loopDecision);
+        const config = st.deps.readConfig();
+        if (!loop || !config)
+            return 'skipped';
+        const record = known ?? await st.deps.listTowerDecisions(loop.focusId);
+        if (!record.openLoopDecisionIds.includes(loopId))
+            return 'not_open';
+        const settled = settlementOf(record, loopId);
+        if (settled.kind === 'bounded')
+            return await release(st, loop, settled.bounded, settled.amendmentIds);
+        if (settled.kind === 'awaiting_operator')
+            return 'awaiting_operator';
+        const repeat = await st.deps.escalateRepeatReviewLoop({ focusId: loop.focusId, loopDecisionId: loopId });
+        if (repeat.repeat) {
+            log.warn(`[tower-supervisor] the loop ${loopId.slice(0, 8)} on "${loop.criterion}" repeats a criterion the supervisor ` +
+                `already bounded under this arm: no second supervisor; filed to the operator (${repeat.escalationId ?? 'escalation unknown'}).`);
+            return 'awaiting_operator';
+        }
+        const focus = await st.deps.findFocus(loop.focusId, productId);
+        const scoped = focus ? st.deps.productConfig(config, focus.productId) : null;
+        if (!focus || !scoped)
+            return 'skipped';
+        if ((st.attempts.get(loopId) ?? 0) >= TOWER_SUPERVISOR_MAX_ATTEMPTS) {
+            await giveUp(st, loop, focus, scoped, 'the previous hand-off did not land');
+            return 'awaiting_operator';
+        }
+        const run = runSession(st, loop, focus, scoped)
+            .catch((err) => log.warn(`[tower-supervisor] supervision of "${focus.focusName}" failed: ${err.message}; the next sweep retries.`))
+            .finally(() => st.inFlight.delete(loopId));
+        st.inFlight.set(loopId, run);
+        return 'started';
+    }
+    catch (err) {
+        log.warn(`[tower-supervisor] could not read the held loop ${loopId.slice(0, 8)}: ${err.message}; the next sweep retries.`);
+        return 'unreadable';
+    }
+}
+/** A sweep's step for one open loop: read its focus record, then supervise it. */
+async function superviseOpen(st, open, productId) {
+    if (st.inFlight.has(open.towerDecisionId))
+        return 'in_flight';
+    try {
+        const record = await st.deps.listTowerDecisions(open.focusId);
+        const decision = record.decisions.find((d) => d.towerDecisionId === open.towerDecisionId);
+        return decision ? await supervise(st, decision, productId, record) : 'not_open';
+    }
+    catch (err) {
+        log.warn(`[tower-supervisor] focus record read failed for ${open.focusId.slice(0, 8)}: ${err.message}`);
+        return 'unreadable';
+    }
+}
+function tally(counts, outcome) {
+    if (outcome === 'started')
+        counts.started += 1;
+    else if (outcome === 'in_flight')
+        counts.inFlight += 1;
+    else if (outcome === 'resolved')
+        counts.resolved += 1;
+    else if (outcome === 'awaiting_operator')
+        counts.awaitingOperator += 1;
+    else if (outcome === 'unreadable')
+        counts.unreadable += 1;
+    else
+        counts.skipped += 1;
+}
+/** Sweep the held loops of every configured product. */
+async function sweepHeldLoops(st) {
+    const counts = emptySweepCounts();
+    const config = st.deps.readConfig();
+    if (!config)
+        return counts;
+    for (const product of config.products) {
+        let loops;
+        try {
+            loops = await st.deps.listOpenReviewLoops({ productId: product.id });
+        }
+        catch (err) {
+            log.warn(`[tower-supervisor] open-loop read failed for product ${product.id.slice(0, 8)}: ${err.message}`);
+            counts.unreadable += 1;
+            continue;
+        }
+        for (const open of loops) {
+            counts.openLoops += 1;
+            tally(counts, await superviseOpen(st, open, product.id));
+        }
+    }
+    return counts;
+}
+/** Build the TowerSupervisor the composition root binds (one per process). */
+export function createTowerSupervisor(deps) {
+    const st = { deps, inFlight: new Map(), attempts: new Map() };
+    return {
+        onLoopDetected: async (notice) => {
+            const outcome = await supervise(st, notice.decision, null, null);
+            log.info(`[tower-supervisor] "${notice.focusName}" held loop handed to the supervisor: ${outcome}.`);
+        },
+        sweep: () => sweepHeldLoops(st),
+        settled: async () => { await Promise.all([...st.inFlight.values()]); },
+    };
+}
+//# sourceMappingURL=tower-supervisor-session.js.map

package/dist/tower/tower-supervisor-session.js.map

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

package/dist/tower/tower-supervisor.d.ts

@@ -0,0 +1,86 @@
+/**
+ * THE TOWER SUPERVISOR: the actor a held review loop is handed to.
+ *
+ * A review loop that cannot converge (supervision/review-loop-detector.ts) is
+ * a judgement call -- is the criterion unbounded, or does the work really fall
+ * short? The operator ruled that a Tower supervisor decides it,
+ * WITHOUT the operator in the loop, and reports what it decided on the focus
+ * (focus_tower_decisions). The review exit holds the loop, records the
+ * `loop_detected` decision, and calls `onLoopDetected`
+ * (completion/review-cycle-budget/review-loop-detection.ts). The supervisor
+ * session bounds the criterion (or, when it cannot, escalates to the
+ * operator); the daemon then records the `loop_resolved` that names the loop,
+ * which releases the hold (supervision/review-loop-hold.ts). It is called once
+ * per criterion per arm: a loop that returns after a bound under the same arm
+ * goes to the operator instead (tower/tower-supervisor-session.ts).
+ *
+ * This module is the contract; the implementation is
+ * tower/tower-supervisor-session.ts, bound once at the composition root
+ * (composition/review-loop-context.ts) and never defaulted in a consumer.
+ *
+ * @module tower/tower-supervisor
+ */
+import type { TowerDecision } from '../queries/tower-decisions/tower-decisions.js';
+/** What the supervisor is handed when a loop is held. */
+export interface LoopDetectedNotice {
+    focusId: string;
+    focusName: string;
+    /** The `loop_detected` decision recorded on the focus (its id is what a `loop_resolved` names). */
+    decision: TowerDecision;
+    criterionKey: string;
+    criterion: string;
+    nodeId: string | null;
+    /** The reviews of the loop, oldest first, with the new blocking findings each named. */
+    rounds: ReadonlyArray<{
+        reviewId: string;
+        newBlockingIssueIds: readonly string[];
+    }>;
+    /** The review-cycle count after this exit, and the budget it is measured against (logged; never handed to the session). */
+    reviewCycleCount: number;
+    cap: number;
+}
+/** What one supervision step did for one held loop. */
+export type LoopSupervisionOutcome = 
+/** A supervisor session was started for it (it runs in the background). */
+'started'
+/** A session for it is already running in this process. */
+ | 'in_flight'
+/** The loop is no longer open (resolved, or from a previous arm). */
+ | 'not_open'
+/** The supervisor bounded the criterion; the daemon recorded loop_resolved. */
+ | 'resolved'
+/** The supervisor (or the daemon, after its attempts ran out) escalated it to the operator; it stays held. */
+ | 'awaiting_operator'
+/** Nothing could run (no daemon config, the focus is not one this daemon runs); retried next sweep. */
+ | 'skipped'
+/** A read or write failed; retried next sweep. */
+ | 'unreadable';
+/** One sweep over the held loops of the configured products. */
+export interface TowerSupervisorSweepCounts {
+    openLoops: number;
+    started: number;
+    inFlight: number;
+    resolved: number;
+    awaitingOperator: number;
+    skipped: number;
+    unreadable: number;
+}
+/** A sweep that found nothing (each sweep starts from a copy). */
+export declare function emptySweepCounts(): TowerSupervisorSweepCounts;
+/** The actor that decides a held review loop. */
+export interface TowerSupervisor {
+    /**
+     * Called once per newly recorded `loop_detected`. Starts the supervision in
+     * the background and returns at once: the review exit is never blocked on a
+     * session (the hold covers the wait). Never rejects.
+     */
+    onLoopDetected(notice: LoopDetectedNotice): Promise<void>;
+    /**
+     * Settle every held loop of the configured products: start a session for one
+     * nobody is deciding (a daemon restart, a failed attempt, no slot free),
+     * release one whose criterion was bounded but whose release did not land, and
+     * leave one escalated to the operator held. Never rejects.
+     */
+    sweep(): Promise<TowerSupervisorSweepCounts>;
+}
+//# sourceMappingURL=tower-supervisor.d.ts.map

package/dist/tower/tower-supervisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tower-supervisor.d.ts","sourceRoot":"","sources":["../../src/tower/tower-supervisor.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+CAA+C,CAAC;AAEnF,yDAAyD;AACzD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,mGAAmG;IACnG,QAAQ,EAAE,aAAa,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,wFAAwF;IACxF,MAAM,EAAE,aAAa,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACpF,2HAA2H;IAC3H,gBAAgB,EAAE,MAAM,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,uDAAuD;AACvD,MAAM,MAAM,sBAAsB;AAChC,2EAA2E;AACzE,SAAS;AACX,2DAA2D;GACzD,WAAW;AACb,qEAAqE;GACnE,UAAU;AACZ,+EAA+E;GAC7E,UAAU;AACZ,8GAA8G;GAC5G,mBAAmB;AACrB,uGAAuG;GACrG,SAAS;AACX,kDAAkD;GAChD,YAAY,CAAC;AAEjB,gEAAgE;AAChE,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,kEAAkE;AAClE,wBAAgB,gBAAgB,IAAI,0BAA0B,CAE7D;AAED,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,cAAc,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D;;;;;OAKG;IACH,KAAK,IAAI,OAAO,CAAC,0BAA0B,CAAC,CAAC;CAC9C"}

package/dist/tower/tower-supervisor.js

@@ -0,0 +1,8 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/tower/tower-supervisor.test.ts
+// PINNED-BY-END
+/** A sweep that found nothing (each sweep starts from a copy). */
+export function emptySweepCounts() {
+    return { openLoops: 0, started: 0, inFlight: 0, resolved: 0, awaitingOperator: 0, skipped: 0, unreadable: 0 };
+}
+//# sourceMappingURL=tower-supervisor.js.map

package/dist/tower/tower-supervisor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tower-supervisor.js","sourceRoot":"","sources":["../../src/tower/tower-supervisor.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,gEAAgE;AAChE,gBAAgB;AAuEhB,kEAAkE;AAClE,MAAM,UAAU,gBAAgB;IAC9B,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;AAChH,CAAC"}

package/dist/types/index.js

@@ -1,5 +1,5 @@
 // PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
-// Pinned by: 284 tests -- run: npm run gen:pinned-by -- --list packages/daemon/src/types/index.ts
+// Pinned by: 285 tests -- run: npm run gen:pinned-by -- --list packages/daemon/src/types/index.ts
 // PINNED-BY-END
 /**
  * Domain-specific type re-exports.

package/dist/update/auto-update.d.ts

@@ -10,12 +10,18 @@
  * Routine path: when the daemon crosses into batch-safe idle (the busy->idle
  * edge) and a newer cached version exists, install it and signal restart.
  *
- * When an update installs, the process exits with code 75 (restart-after-update);
- * a wrapper script / systemd RestartForceExitStatus=75 runs the new version.
+ * When an update installs, the shell restarts onto the new version under the
+ * one contract, restated here verbatim (restart-contract.test.ts checks it
+ * against the hand-over the code performs):
+ *
+ * Restart after a self-update (update/restart-contract.ts):
+ *   under systemd: exit 75, spawn nothing
+ *   under telora-daemon-wrapper.sh: exit 75, spawn nothing
+ *   unsupervised: re-exec a detached replacement, then exit 0
+ *
+ * A supervisor that receives 75 starts the new version itself.
  */
 import { type NpmInstallOptions } from './self-update.js';
-/** Exit code that signals "restart after self-update". */
-export declare const EXIT_CODE_UPDATE = 75;
 /**
  * Default cadence for sampling the idle edge. Short by design -- the 1h clock
  * is gone; this only bounds how quickly a reached idle seam is noticed. Registry
@@ -118,7 +124,7 @@ export interface AutoUpdateDeps {
      * produce a registry-call storm.
      */
     getCachedCandidateVersion: () => string | null;
-    /** Called when an update is installed and the process should exit with 75. */
+    /** Called when an update is installed; the shell restarts per update/restart-contract.ts. */
     onUpdateReady: () => void;
     /** Performs the install (the shell binds {@link performSelfUpdate}). */
     performUpdate: (packageName: string) => Promise<boolean>;

package/dist/update/auto-update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto-update.d.ts","sourceRoot":"","sources":["../../src/update/auto-update.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"auto-update.d.ts","sourceRoot":"","sources":["../../src/update/auto-update.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAwC,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAWhG;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAEjD;;;;;;;;;GASG;AACH,eAAO,MAAM,6BAA6B,UAAY,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,CAAA;CAAE,GACvF;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,WAAW,GAAG,QAAQ,CAAA;CAAE,GACxE;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,WAAW,GAAG,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACrF;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAErC,uFAAuF;AACvF,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,oGAAoG;IACpG,MAAM,EAAE,OAAO,CAAC;IAChB,iFAAiF;IACjF,SAAS,EAAE,MAAM,CAAC;CACnB;AAmBD,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,cAAc,EACxB,cAAc,EAAE,MAAM,GACrB,iBAAiB,CAqEnB;AAED,wFAAwF;AACxF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,MAAM,EAAE,cAAc,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4FAA4F;IAC5F,GAAG,EAAE,MAAM,MAAM,CAAC;CACnB,GAAG,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAoBrC;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,MAAM,GAAG,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAErH;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,MAAM,EAAE,MAAM,OAAO,CAAC;IACtB;;;;OAIG;IACH,yBAAyB,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAC/C,6FAA6F;IAC7F,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,wEAAwE;IACxE,aAAa,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACzD,aAAa;IACb,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,oEAAoE;IACpE,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB;;;;;;;;;OASG;IACH,QAAQ,EAAE,MAAM,OAAO,CAAC;IACxB;;;;;;OAMG;IACH,UAAU,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;CAChD;AAED,mFAAmF;AACnF,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD,sFAAsF;IACtF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAEnG;AAED,sFAAsF;AACtF,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,cAAc,GAAG,gBAAgB,CAyH7E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,IAAI,CA4BvE"}

package/dist/update/auto-update.js

@@ -14,15 +14,21 @@
  * Routine path: when the daemon crosses into batch-safe idle (the busy->idle
  * edge) and a newer cached version exists, install it and signal restart.
  *
- * When an update installs, the process exits with code 75 (restart-after-update);
- * a wrapper script / systemd RestartForceExitStatus=75 runs the new version.
+ * When an update installs, the shell restarts onto the new version under the
+ * one contract, restated here verbatim (restart-contract.test.ts checks it
+ * against the hand-over the code performs):
+ *
+ * Restart after a self-update (update/restart-contract.ts):
+ *   under systemd: exit 75, spawn nothing
+ *   under telora-daemon-wrapper.sh: exit 75, spawn nothing
+ *   unsupervised: re-exec a detached replacement, then exit 0
+ *
+ * A supervisor that receives 75 starts the new version itself.
  */
 import { detectInstallMode, installNpmVersion } from './self-update.js';
 import { isNewerVersion, versionDistance, resolveUpdateChannelUrl, scopedInstallCommand, } from '../config/update-channel.js';
 import { createLogger } from '../log/daemon-log.js';
 const log = createLogger({ module: 'auto-update' });
-/** Exit code that signals "restart after self-update". */
-export const EXIT_CODE_UPDATE = 75;
 /**
  * Default cadence for sampling the idle edge. Short by design -- the 1h clock
  * is gone; this only bounds how quickly a reached idle seam is noticed. Registry
@@ -99,7 +105,7 @@ export function describeUpdateDecision(decision, currentVersion) {
                 level: 'info',
                 steady: false,
                 signature: `applied:${decision.candidate}`,
-                message: `[auto-update] Update to v${decision.candidate} installed; signaling restart (exit ${EXIT_CODE_UPDATE})`,
+                message: `[auto-update] Update to v${decision.candidate} installed; signaling restart`,
             };
         case 'failed':
             return {

package/dist/update/auto-update.js.map

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

package/dist/update/restart-contract.d.ts

@@ -0,0 +1,62 @@
+/** Exit code that signals "restart after self-update" to a supervisor. */
+export declare const EXIT_CODE_UPDATE = 75;
+/**
+ * Env var a supervisor uses to declare itself (`systemd` | `wrapper` | `none`).
+ * Read raw, not via loadEnvConfig, and leniently: it is a supervisor's
+ * self-declaration rather than an operator knob, and an unknown value must fall
+ * through to detection instead of failing the restart (loadEnvConfig throws on a
+ * bad enum). Allowlisted under "env-reads" in scripts/lint-config.json.
+ */
+export declare const SUPERVISOR_ENV = "TELORA_DAEMON_SUPERVISOR";
+/** Who restarts the daemon after an update; `null` = nothing does. */
+export type RestartSupervisor = 'systemd' | 'wrapper';
+/** The restart decision the shell's restart-after-update branch acts on. */
+export type RestartPlan = {
+    kind: 'exit-to-supervisor';
+    supervisor: RestartSupervisor;
+    exitCode: typeof EXIT_CODE_UPDATE;
+    source: 'declared' | 'detected';
+} | {
+    kind: 're-exec-detached';
+    exitCode: 0;
+    source: 'declared' | 'detected';
+};
+/** Seams for {@link detectRestartSupervisor}; the shell binds the live process. */
+export interface RestartSupervisorProbe {
+    env: NodeJS.ProcessEnv;
+    /** The parent process's command name (`/proc/<ppid>/comm`), or null if unreadable. */
+    parentCommand: () => string | null;
+}
+/**
+ * Decide how the restart-after-update branch hands over to the new version.
+ * Pure over its probe, so both branches are unit-testable.
+ */
+export declare function planRestartAfterUpdate(probe: RestartSupervisorProbe): RestartPlan;
+/** The supervisor named by {@link planRestartAfterUpdate}, or null when unsupervised. */
+export declare function detectRestartSupervisor(probe: RestartSupervisorProbe): RestartSupervisor | null;
+/** One log line naming the decision, so a restart that did not come back is diagnosable. */
+export declare function describeRestartPlan(plan: RestartPlan): string;
+/** The live probe the shell binds: this process's env and its parent's command name. */
+export declare function liveRestartProbe(): RestartSupervisorProbe;
+/** Effects {@link handOverAfterUpdate} performs; the shell binds the live ones. */
+export interface RestartHandOverDeps {
+    /** Spawn the detached replacement daemon (the unsupervised re-exec). */
+    reExecDetached: () => void;
+    exit: (code: number) => void;
+    log: (message: string) => void;
+}
+/**
+ * The shell's restart-after-update branch, after teardown: hand over to the
+ * supervisor (exit 75, spawn nothing) or, unsupervised, re-exec a detached
+ * replacement and exit 0.
+ */
+export declare function handOverAfterUpdate(plan: RestartPlan, deps: RestartHandOverDeps): void;
+/** The first line of the contract statement an artifact restates verbatim. */
+export declare const RESTART_STATEMENT_HEADING = "Restart after a self-update (update/restart-contract.ts):";
+/**
+ * The contract as one plain statement, DERIVED by running the hand-over for each
+ * kind of runner -- so a statement that restates it (the auto-update.ts header)
+ * is checked against what the code does, not against a phrase someone wrote.
+ */
+export declare function restartContractStatement(): string[];
+//# sourceMappingURL=restart-contract.d.ts.map

package/dist/update/restart-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart-contract.d.ts","sourceRoot":"","sources":["../../src/update/restart-contract.ts"],"names":[],"mappings":"AAiDA,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,6BAA6B,CAAC;AAEzD,sEAAsE;AACtE,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,SAAS,CAAC;AAEtD,4EAA4E;AAC5E,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,UAAU,EAAE,iBAAiB,CAAC;IAAC,QAAQ,EAAE,OAAO,gBAAgB,CAAC;IAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAAA;CAAE,GACjI;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,QAAQ,EAAE,CAAC,CAAC;IAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAAA;CAAE,CAAC;AAE/E,mFAAmF;AACnF,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,sFAAsF;IACtF,aAAa,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CACpC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,sBAAsB,GAAG,WAAW,CAYjF;AAED,yFAAyF;AACzF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,sBAAsB,GAAG,iBAAiB,GAAG,IAAI,CAG/F;AAED,4FAA4F;AAC5F,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAK7D;AAWD,wFAAwF;AACxF,wBAAgB,gBAAgB,IAAI,sBAAsB,CAEzD;AAED,mFAAmF;AACnF,MAAM,WAAW,mBAAmB;IAClC,wEAAwE;IACxE,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAItF;AAED,8EAA8E;AAC9E,eAAO,MAAM,yBAAyB,8DAA8D,CAAC;AAErG;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,EAAE,CAmBnD"}