@telora/daemon 0.21.26 → 0.21.82

package/dist/auto-update.js

@@ -1,317 +0,0 @@
-/**
- * Daemon auto-update module: a safe-seam-driven update controller.
- *
- * Update timing is bound to whether a restart is actually SAFE, not to a fixed
- * clock. The controller samples a batch-safe idle gate (auto-update-idle.ts) and
- * reads the candidate version from the warm version cache (staleness.ts) rather
- * than polling the registry on every cycle. It may WAIT for a safe seam or
- * CREATE one by draining intake, but it never destroys one.
- *
- * 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.
- */
-import { execFile } from 'node:child_process';
-import { detectInstallMode } from './self-update.js';
-import { isNewerVersion } from './version-check.js';
-import { armDrainForUpdate, releaseDrainForUpdate } from './intake-control.js';
-import { createLogger } from './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
- * traffic is unaffected (the candidate version comes from the warm cache).
- */
-export const DEFAULT_SAMPLE_INTERVAL_MS = 30_000;
-/**
- * Steady-state heartbeat for the default decision-logging sink. In the common
- * "checked and current" / "candidate pending" states the sink suppresses
- * duplicate consecutive lines, but re-emits at least this often so that an
- * ABSENT trace positively identifies a controller that is NOT running (the
- * invisibility this module exists to close: a 7-version gap survived 198h
- * precisely because ran-and-found-nothing looked identical to never-ran).
- * With ~30s sampling, a 1h heartbeat caps steady-state log volume at ~24
- * lines/day while making any >1h silence diagnostic.
- */
-export const DEFAULT_DECISION_HEARTBEAT_MS = 3_600_000;
-/**
- * Render a decision into a loggable line. Exhaustive over {@link UpdateDecision}
- * (the trailing `never` assignment fails the build if a case is added without a
- * message). All lines share the `[auto-update]` prefix so the trace is greppable
- * and assertable.
- */
-export function describeUpdateDecision(decision, currentVersion) {
-    switch (decision.kind) {
-        case 'current':
-            return {
-                level: 'info',
-                steady: true,
-                signature: 'current',
-                message: `[auto-update] Checked: up to date (v${currentVersion}); no newer version available`,
-            };
-        case 'candidate-pending':
-            return {
-                level: 'info',
-                steady: true,
-                signature: `pending:${decision.reason}:${decision.candidate}`,
-                message: decision.reason === 'busy'
-                    ? `[auto-update] Candidate v${decision.candidate} available but daemon busy; waiting for a safe seam (current v${currentVersion})`
-                    : `[auto-update] Candidate v${decision.candidate} available and idle; awaiting rising idle edge (current v${currentVersion})`,
-            };
-        case 'drain-armed':
-            return {
-                level: 'info',
-                steady: false,
-                signature: `drain-armed:${decision.candidate}`,
-                message: `[auto-update] Drain armed to create a safe seam for v${decision.candidate} (current v${currentVersion})`,
-            };
-        case 'applying':
-            return {
-                level: 'info',
-                steady: false,
-                signature: `applying:${decision.trigger}:${decision.candidate}`,
-                message: decision.trigger === 'urgent'
-                    ? `[auto-update] URGENT signal set -- applying update v${decision.candidate} mid-batch, preempting in-flight work (current v${currentVersion})`
-                    : `[auto-update] Batch-safe idle seam reached; applying update v${decision.candidate} (current v${currentVersion})`,
-            };
-        case 'applied':
-            return {
-                level: 'info',
-                steady: false,
-                signature: `applied:${decision.candidate}`,
-                message: `[auto-update] Update to v${decision.candidate} installed; signaling restart (exit ${EXIT_CODE_UPDATE})`,
-            };
-        case 'failed':
-            return {
-                level: 'warn',
-                steady: false,
-                signature: `failed:${decision.trigger}:${decision.candidate}`,
-                message: decision.trigger === 'urgent'
-                    ? `[auto-update] Urgent install of v${decision.candidate} FAILED: ${decision.error}; will retry next tick`
-                    : `[auto-update] Install of v${decision.candidate} FAILED at idle seam: ${decision.error}; will retry on the next idle edge`,
-            };
-        case 'error':
-            return {
-                level: 'warn',
-                steady: false,
-                signature: 'error',
-                message: `[auto-update] Unexpected error: ${decision.error}`,
-            };
-        default: {
-            const _exhaustive = decision;
-            return _exhaustive;
-        }
-    }
-}
-/**
- * Build the default {@link AutoUpdateDeps.onDecision} sink: it logs every
- * actionable decision immediately (loud on failure), and throttles the
- * recurring steady-state decisions to at most one line per heartbeat window so
- * the log stays readable without ever going fully silent while the controller
- * runs.
- */
-export function createLoggingDecisionSink(opts) {
-    const { logger, currentVersion, heartbeatMs = DEFAULT_DECISION_HEARTBEAT_MS, now = Date.now } = opts;
-    let lastSteadySignature = null;
-    let lastSteadyLoggedAt = Number.NEGATIVE_INFINITY;
-    return (decision) => {
-        const described = describeUpdateDecision(decision, currentVersion);
-        if (described.steady) {
-            const heartbeatDue = now() - lastSteadyLoggedAt >= heartbeatMs;
-            if (described.signature === lastSteadySignature && !heartbeatDue)
-                return;
-            lastSteadySignature = described.signature;
-            lastSteadyLoggedAt = now();
-        }
-        else {
-            // An actionable event breaks the steady-state run; the next steady tick
-            // re-logs its current state rather than being suppressed as a duplicate.
-            lastSteadySignature = null;
-        }
-        if (described.level === 'warn')
-            logger.warn(described.message);
-        else
-            logger.info(described.message);
-    };
-}
-/**
- * Run `npm install -g <package>@latest` as a child process.
- * Returns true on success, false on failure.
- */
-export function performSelfUpdate(packageName) {
-    return new Promise((resolve) => {
-        const target = `${packageName}@latest`;
-        log.info(`Installing ${target}...`);
-        execFile('npm', ['install', '-g', target], { timeout: 120_000 }, (err, stdout, stderr) => {
-            if (err) {
-                log.warn(`[auto-update] npm install failed: ${err.message}`);
-                if (stderr)
-                    log.warn(`stderr: ${stderr.trim()}`);
-                resolve(false);
-                return;
-            }
-            if (stdout.trim())
-                log.info(`${stdout.trim()}`);
-            log.info(`Successfully installed ${target}`);
-            resolve(true);
-        });
-    });
-}
-/**
- * Build the safe-seam update controller.
- *
- * Each tick:
- *   1. Read the candidate version from the warm cache (no registry call).
- *   2. Detect the busy->idle "ready" edge (idle AND a newer version present).
- *   3. On the rising edge, install and signal restart.
- *
- * Edge semantics: the controller fires once per transition into the ready state
- * (idle + newer version). Staying ready does not re-fire; an install failure
- * consumes the edge so a persistent failure cannot spam `npm install` -- it
- * re-arms only when the daemon leaves and re-enters the ready state.
- */
-export function createUpdateController(deps) {
-    const { currentVersion, packageName = '@telora/daemon', isIdle, getCachedCandidateVersion, onUpdateReady, performUpdate = performSelfUpdate, now = Date.now, stalenessThresholdMs = Number.POSITIVE_INFINITY, armDrain = armDrainForUpdate, releaseDrain = releaseDrainForUpdate, isUrgent = () => false, decisionHeartbeatMs = DEFAULT_DECISION_HEARTBEAT_MS, onDecision, } = deps;
-    // Observability sink: every tick emits exactly one classified decision here.
-    // Default logs (heartbeat-throttled) so activity is never fully silent; tests
-    // inject their own sink to assert the decision contract.
-    const emit = onDecision ??
-        createLoggingDecisionSink({ logger: log, currentVersion, heartbeatMs: decisionHeartbeatMs, now });
-    // True while the "ready to update" condition (idle + newer version) held on
-    // the previous tick. The controller acts only on the false->true transition.
-    let wasReady = false;
-    // Drain tracking (delivery C): the candidate currently pending and the time it
-    // first appeared, so we can drain intake once it has been stale too long.
-    let pendingVersion = null;
-    let pendingSince = null;
-    async function tick() {
-        try {
-            const candidate = getCachedCandidateVersion();
-            const haveNewer = candidate !== null && isNewerVersion(candidate, currentVersion);
-            // -- Pending-since tracking + drain reset on supersede/clear ------------
-            if (haveNewer) {
-                if (candidate !== pendingVersion) {
-                    // A new candidate. If it SUPERSEDES one we were already tracking, the
-                    // prior drain decision no longer applies -- release it and restart the
-                    // staleness clock. First appearance (nothing tracked) just starts the
-                    // clock; there is no drain to release.
-                    const superseded = pendingVersion !== null;
-                    pendingVersion = candidate;
-                    pendingSince = now();
-                    if (superseded)
-                        releaseDrain();
-                }
-            }
-            else if (pendingVersion !== null) {
-                // Candidate gone (already up to date) -- clear pending and release drain.
-                pendingVersion = null;
-                pendingSince = null;
-                releaseDrain();
-            }
-            // -- Urgent path (delivery D): explicit operator/publisher signal only --
-            // When urgency is signaled and a newer version is cached, apply
-            // immediately -- even mid-batch -- via the existing graceful
-            // shutdown/respawn path (onUpdateReady). This is the ONLY path that may
-            // interrupt an in-flight batch, and it is NEVER the loop's own decision.
-            // Absent the signal, behavior is exactly deliveries A-C.
-            if (haveNewer && isUrgent()) {
-                // candidate is non-null here (haveNewer implies it).
-                const target = candidate;
-                emit({ kind: 'applying', candidate: target, trigger: 'urgent' });
-                const ok = await performUpdate(packageName);
-                if (!ok) {
-                    emit({ kind: 'failed', candidate: target, trigger: 'urgent', error: 'npm install did not succeed' });
-                    return;
-                }
-                emit({ kind: 'applied', candidate: target });
-                onUpdateReady();
-                return;
-            }
-            const idleNow = isIdle();
-            // -- Drain-at-boundary (delivery C) -------------------------------------
-            // Busy daemon + a candidate pending past the staleness threshold -> stop
-            // accepting new focuses so the current batch becomes the safe seam. Active
-            // teams finish; the resulting boundary lets the update apply. Never aborts
-            // running work.
-            if (haveNewer &&
-                pendingSince !== null &&
-                !idleNow &&
-                now() - pendingSince >= stalenessThresholdMs) {
-                armDrain();
-                emit({ kind: 'drain-armed', candidate: candidate });
-            }
-            const ready = idleNow && haveNewer;
-            const risingEdge = ready && !wasReady;
-            wasReady = ready;
-            if (!risingEdge) {
-                // No install this tick -- still emit the classified steady state so the
-                // controller's liveness is observable (silence never means "not run").
-                if (!haveNewer) {
-                    emit({ kind: 'current' });
-                }
-                else {
-                    emit({
-                        kind: 'candidate-pending',
-                        candidate: candidate,
-                        reason: idleNow ? 'awaiting-idle-edge' : 'busy',
-                    });
-                }
-                return;
-            }
-            const target = candidate;
-            emit({ kind: 'applying', candidate: target, trigger: 'idle-seam' });
-            const ok = await performUpdate(packageName);
-            if (!ok) {
-                // Consume the edge: do not retry until the daemon leaves and re-enters
-                // the ready state, so a persistent install failure cannot spam npm.
-                emit({ kind: 'failed', candidate: target, trigger: 'idle-seam', error: 'npm install did not succeed' });
-                return;
-            }
-            emit({ kind: 'applied', candidate: target });
-            onUpdateReady();
-        }
-        catch (err) {
-            emit({ kind: 'error', error: err instanceof Error ? err.message : String(err) });
-        }
-    }
-    return { tick };
-}
-/**
- * Start the safe-seam auto-update loop.
- *
- * Returns a cleanup function that stops the timer.
- *
- * NOTE: the npx-cache branch below is now a DEAD PATH for the normal run/start
- * flow. The runtime refusal guard (`isNpxRunMode` in unified-shell.ts /
- * index.ts) exits the process before any engine -- or this loop -- starts, so a
- * daemon that reaches `startAutoUpdateLoop` is already on a stable on-disk
- * install. The check is retained as cheap defense-in-depth (e.g. if the guard
- * is overridden via TELORA_ALLOW_NPX_RUN, auto-update still correctly disables
- * itself rather than spinning an install that can never take effect).
- */
-export function startAutoUpdateLoop(opts) {
-    const { intervalMs = DEFAULT_SAMPLE_INTERVAL_MS } = opts;
-    if (detectInstallMode() === 'npx') {
-        log.info('[auto-update] Disabled: running from npx cache. Install globally with `npm install -g @telora/daemon` and start `telora-daemon run` to enable auto-update.');
-        return () => { };
-    }
-    let stopped = false;
-    const controller = createUpdateController(opts);
-    const timer = setInterval(() => {
-        if (stopped)
-            return;
-        void controller.tick();
-    }, intervalMs);
-    // Don't block process exit
-    timer.unref();
-    log.info(`[auto-update] Enabled (safe-seam, sampling every ${Math.round(intervalMs / 1000)}s)`);
-    return () => {
-        stopped = true;
-        clearInterval(timer);
-    };
-}
-//# sourceMappingURL=auto-update.js.map

package/dist/auto-update.js.map

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

package/dist/branch-status.d.ts

@@ -1,79 +0,0 @@
-/**
- * Branch status computation for the three-tier git model.
- *
- * Computes health/ahead/behind status for:
- *   1. Integration branch vs main
- *   2. Each configured branch monitor (remote refs vs local main)
- *   3. Each focus worktree vs integration
- *
- * Results ride in the heartbeat metadata field (no new tables).
- *
- * Multi-product: computeBranchStatus is called once per configured product
- * with a product-scoped config (configForProduct). The focus worktree map
- * spans all products, so this module scopes it by each entry's productId and
- * runs git against the entry's own repoPath — evaluating a worktree against
- * a repository that does not own it is unrepresentable here. All caches are
- * keyed per product so one product's tick cannot evict another's state.
- *
- * Failure semantics (two distinct kinds, deliberately kept apart):
- *   - TRANSIENT git failures (lock contention, mid-rebase, timeouts) fall
- *     back to the last good cached status without raising anything — this
- *     tolerance predates this module split and prevents UI flicker.
- *   - PERMANENT failures (unknown revision, not a git repository, bad
- *     object) mean the branch we believe exists cannot be resolved where we
- *     looked: an attribution error, not contention. These are surfaced via
- *     a healthEvent + error log (once per focus per daemon run) instead of
- *     silently rendering identically to "no worktree". A worktree entry in
- *     the map IS the claim that its branch should exist; a legitimately
- *     deleted branch is removed from the map (removeFocusWorktree) before
- *     ever being evaluated here, so ordinary deletions raise no events.
- */
-import type { DaemonConfig } from './types.js';
-import type { BranchMonitorEntry } from './queries/products.js';
-/** Reset all caches. Exported for tests only. */
-export declare function resetBranchStatusCache(): void;
-export type BranchHealth = 'clean' | 'dirty' | 'conflict';
-export interface IntegrationBranchStatus {
-    branch: string;
-    health: BranchHealth;
-    aheadOfMain: number;
-    behindMain: number;
-}
-export interface RemoteBranchStatus {
-    ref: string;
-    label: string;
-    aheadOfMain: number | null;
-    behindMain: number | null;
-}
-export interface FocusBranchStatus {
-    focusId: string;
-    branch: string;
-    headSha: string;
-    health: BranchHealth;
-    aheadOfIntegration: number;
-    behindIntegration: number;
-}
-export interface BranchStatusPayload {
-    integration: IntegrationBranchStatus | null;
-    remotes: RemoteBranchStatus[];
-    focuses: FocusBranchStatus[];
-}
-/** Options for configurable branch monitoring. */
-export interface BranchStatusOptions {
-    mainBranch?: string;
-    branchMonitors?: BranchMonitorEntry[];
-}
-/**
- * Compute branch status for all three tiers of ONE product.
- *
- * Safe to call from the heartbeat loop: uses short git timeouts
- * and catches all errors so a single failure skips that entry
- * rather than failing the entire heartbeat.
- *
- * @param config - Product-scoped daemon config (configForProduct); provides
- *   productId, repoPath, integrationBranch. Only worktrees owned by
- *   config.productId are evaluated, each against its own repoPath.
- * @param options - Optional overrides for mainBranch and branchMonitors from the product record
- */
-export declare function computeBranchStatus(config: DaemonConfig, options?: BranchStatusOptions): BranchStatusPayload;
-//# sourceMappingURL=branch-status.d.ts.map

package/dist/branch-status.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"branch-status.d.ts","sourceRoot":"","sources":["../src/branch-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAM/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAsChE,iDAAiD;AACjD,wBAAgB,sBAAsB,IAAI,IAAI,CAG7C;AAID,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;AAE1D,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC5C,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED,kDAAkD;AAClD,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACvC;AA6ED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,mBAAmB,CAuM5G"}