@telora/daemon 0.21.26 → 0.21.82

package/dist/unified-engine-lifecycle.d.ts

@@ -1,186 +0,0 @@
-/**
- * Engine creation, initialization, and diagnostic signal registration
- * for the unified daemon shell.
- *
- * Extracted from unified-shell.ts -- pure structural refactor, no behavioral
- * changes.
- */
-import { type ExecutionEngine, type UnifiedConfig, type ProductEntry, ResourceGovernor } from '@telora/daemon-core';
-import type { BaseConfig } from '@telora/daemon-core';
-import type { UnifiedDaemonOptions } from './unified-shell-config.js';
-import { type ResolvedConfigLike, type LacunaTransition } from './config-hot-reload.js';
-import type { LacunaConfig } from './types.js';
-/**
- * Create engine instances from config, set up the resource governor, and
- * inject it into each engine. Exits the process if no engines are available.
- */
-export declare function createEnginesAndGovernor(config: UnifiedConfig, pidFilePath: string): Promise<{
-    engines: ExecutionEngine[];
-    governor: ResourceGovernor;
-}>;
-/**
- * Resolve the full runtime config for a named engine -- THE single resolver.
- *
- * One per-engine base merge (focus section, loop section, or the focus
- * section as the unknown-engine fallback) followed by daemon-level defaults
- * applied UNIFORMLY to every engine: telemetry, lacuna, and the verification
- * carriage (products[].defaultVerification + the top-level default).
- *
- * WHY uniform: every engine's config can become the shared global config
- * singleton (queries/shared.ts initSupabase) -- engines init in sequence and
- * each calls initSupabase, so the LAST writer wins. The spawn paths read
- * telemetry / lacuna / defaultVerification off that singleton; the focus-loop
- * audit spawn crashed in buildSpawnEnvironment when a non-focus engine's
- * config (which the old hand-synced second resolver did not enrich) had won.
- * With one resolver there is no second path to hand-sync: adding a new
- * spawn-read config field means adding it HERE, once, for every engine.
- */
-export declare function resolveEngineConfig(engineName: string, config: UnifiedConfig): BaseConfig & Record<string, unknown>;
-/**
- * Back-compat alias for the single resolver. Prefer resolveEngineConfig in
- * new code; existing importers and tests keep working through this name.
- */
-export declare const buildEngineRuntimeConfig: typeof resolveEngineConfig;
-/**
- * Initialize, run crash recovery, and start each engine. On failure, stops
- * any engines that already started, releases the PID lock, and exits.
- */
-export declare function initializeAndStartEngines(engines: ExecutionEngine[], config: UnifiedConfig, opts: UnifiedDaemonOptions, pidFilePath: string): Promise<Map<string, BaseConfig & Record<string, unknown>>>;
-/** The four distinct causes a single product-claim attempt can resolve to. */
-export type ClaimOutcomeKind = 'success' | 'auth_fault' | 'rival' | 'transient';
-/** Parsed body shape of the `daemon_claim_product` response we care about. */
-export interface ClaimResponseBody {
-    claimed?: boolean;
-    claimedBy?: string;
-}
-/** A classified single-product claim outcome + the truthful operator message. */
-export interface ClaimOutcome {
-    kind: ClaimOutcomeKind;
-    message: string;
-    /** Set only for the `rival` kind: the host currently holding the product. */
-    claimedBy?: string;
-}
-/**
- * Classify ONE product-claim attempt by HTTP status class + body, and produce
- * a message that names the real cause. Pure -- no network, no logging -- so the
- * whole diagnosis is unit-testable.
- *
- * Discrimination (see the server contract in
- * supabase/functions/product-api/handlers/daemon-session-handlers.ts):
- *   - 401 / 403  -> `auth_fault`. These come ONLY from the daemon_* gate /
- *     invalid-or-inactive tracker, NEVER from a rival. The bearer is not an
- *     active ai_tracker credential -- the onboarding failure mode. This must
- *     NOT be reported as "claimed by another host".
- *   - 2xx + {claimed:true}                -> `success` (happy path).
- *   - 2xx + {claimed:false, claimedBy}    -> `rival`. The ONLY path that emits
- *     reassign / stop-other-daemon guidance, and it names `claimedBy`.
- *   - anything else (5xx / 404 / network / parse) -> `transient`.
- */
-export declare function classifyClaimOutcome(status: number, body: ClaimResponseBody | null): ClaimOutcome;
-/**
- * Given every failed claim outcome for this host, build the zero-claims throw
- * message reflecting the DOMINANT status class -- so an all-auth-fault run
- * throws an auth-fault message (name the credential cause), not the rival
- * "reassign / stop the other daemon" misdirection.
- *
- * Dominance is by count; ties break auth_fault > rival > transient (the
- * misdiagnosis this whole change fixes is the most actionable to surface).
- */
-export declare function aggregateClaimFailureMessage(outcomes: ClaimOutcome[], myHostname: string): string;
-/**
- * Claim products for this daemon's hostname. Unclaimed products are
- * auto-claimed; products already claimed by another host are skipped.
- *
- * Each attempt is classified by HTTP status class ({@link classifyClaimOutcome})
- * so a credential/authorization fault (401/403 -- the daemon bearer is not an
- * active ai_tracker) is diagnosed truthfully instead of being blamed on a rival
- * daemon. The zero-claims throw reflects the dominant failure class.
- *
- * Mutates `config.base.products` in place to contain only claimed products.
- * Uses a direct fetch call to avoid needing the full API client infrastructure
- * (which is initialized per-engine later).
- */
-export declare function claimProducts(config: UnifiedConfig): Promise<void>;
-/**
- * Register SIGUSR1 (status dump) and SIGUSR2 (circuit breaker reset) handlers.
- */
-export declare function registerDiagnosticSignals(engines: ExecutionEngine[], governor: ResourceGovernor): void;
-/** Governor surface the hot-reload apply needs (live session-cap setters). */
-export interface HotReloadGovernor {
-    setEngineLimit(engine: string, limit: number): void;
-    setMaxGlobalSessions(max: number): void;
-    getUtilization(): {
-        max: number;
-    };
-}
-/** Lacuna sidecar lifecycle seam (injected so the apply is unit-testable). */
-export interface HotReloadLacunaOps {
-    start: (cfg: LacunaConfig) => Promise<unknown>;
-    stop: () => Promise<void>;
-}
-/** Injected side-effect seams for {@link applyConfigHotReload}. */
-export interface ApplyConfigHotReloadDeps {
-    governor: HotReloadGovernor;
-    lacuna: HotReloadLacunaOps;
-    /** Logger seam (defaults to console.log). */
-    log?: (msg: string) => void;
-}
-/** What a hot-reload apply did -- returned for logging + tests. */
-export interface ConfigHotReloadSummary {
-    appliedScalars: string[];
-    sessionCap: number | null;
-    lacunaTransition: LacunaTransition;
-    restartRequired: string[];
-}
-/**
- * Apply a classified config diff to the LIVE engine config object + governor +
- * Lacuna sidecar -- the in-place apply path that generalizes the reconcile-live
- * seam beyond the products array. No running team is ever killed:
- *
- *   - Live-applicable scalars are written onto `liveConfig` in place, so the
- *     next poll/spawn (which reads the same object via configForProduct) sees
- *     the new value.
- *   - maxTotalSessions additionally drives the ResourceGovernor per-engine cap
- *     (the authoritative concurrency limit the listener gates spawns on), and
- *     raises the global cap if it would otherwise throttle the new limit.
- *   - The Lacuna sidecar is started/stopped/restarted per the transition; the
- *     new lacuna block is written onto `liveConfig` so per-spawn routing reads
- *     it. Fail-open is preserved by the lifecycle helpers.
- *   - Identity / bound-resource changes are surfaced as a restart-required
- *     warning and NEVER applied.
- *
- * Pure except for the injected governor/lacuna side effects and the in-place
- * mutation of `liveConfig`, so it unit-tests without a live daemon or SIGHUP.
- */
-export declare function applyConfigHotReload(liveConfig: ResolvedConfigLike, nextConfig: ResolvedConfigLike, oldLacuna: LacunaConfig, newLacuna: LacunaConfig, deps: ApplyConfigHotReloadDeps): Promise<ConfigHotReloadSummary>;
-/**
- * Register a SIGHUP handler that re-reads daemon.json and applies live changes
- * without a restart:
- *
- *   - the `config.base.products` array (added/removed/repoPath-changed) is
- *     spliced in place so engines/listener pick it up on the next poll;
- *   - the safe scalar config class (loop/merge thresholds, token/cost limits,
- *     log retention, policyFailureMode, maxTotalSessions) is applied to the
- *     live focus engine config + ResourceGovernor in place;
- *   - the Lacuna compression sidecar is started/stopped/restarted per the
- *     edited `engines.focus.lacuna` block.
- *
- * None of these disturb in-flight teams. Identity fields (teloraUrl, trackerId,
- * organizationId) and bound-resource fields (paths, ports, worktree/integration)
- * still require a restart and are logged as a warning.
- *
- * `governor` and `liveFocusConfig` are the live focus-engine handles; when the
- * focus engine is disabled they are undefined and only products reconcile.
- */
-export declare function registerHotReloadSignal(config: UnifiedConfig, opts: UnifiedDaemonOptions, governor?: HotReloadGovernor, liveFocusConfig?: BaseConfig & Record<string, unknown>): void;
-/**
- * Scaffold each newly-added product's directory through the single idempotent
- * `scaffoldProductDirectory` (CLAUDE.md self-heal + git-init when the directory
- * has no repo). No-op for an empty additions list. The integration branch is
- * resolved from the focus section identically to the boot path.
- *
- * Exported so the hot-reload scaffold behavior is unit-testable without a live
- * daemon / SIGHUP.
- */
-export declare function scaffoldAddedProducts(additions: ProductEntry[], config: UnifiedConfig): void;
-//# sourceMappingURL=unified-engine-lifecycle.d.ts.map

package/dist/unified-engine-lifecycle.d.ts.map

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