@telora/daemon 0.21.26 → 0.21.81

package/dist/crash-recovery.d.ts

@@ -1,141 +0,0 @@
-/**
- * Crash recovery: orphaned worktree cleanup and stale branch pruning.
- *
- * When the daemon crashes (SIGKILL, OOM, power loss), worktrees and branches
- * persist on disk with no in-memory tracking. On restart this module scans
- * the filesystem, reconciles against DB session state, and cleans up.
- *
- * Runs after initGit() and before startListeners() so the daemon starts clean.
- */
-import type { DaemonConfig, AgentSession } from './types.js';
-import { type CreateEscalationParams } from './queries/issues.js';
-export interface OrphanedWorktree {
-    /** Absolute path to the worktree directory. */
-    worktreePath: string;
-    /** Git branch name (e.g. agent/developer/my-delivery). */
-    branchName: string;
-    /** DB session that was still marked active, if any. */
-    session: AgentSession | null;
-    /**
-     * True when this is UNREGISTERED residue: a directory under the worktree dir
-     * with no `git worktree list` entry (its branch name is INFERRED from the dir
-     * name and usually has no ref). There is no branch to diff, so its reap safety
-     * is judged by content reachability from integration, not the unmerged-commit
-     * check the registered-orphan path uses.
-     */
-    unregistered?: boolean;
-}
-export interface CleanupAction {
-    worktreePath: string;
-    branchName: string;
-    action: 'removed' | 'preserved' | 'safety-committed' | 'safety-committed-and-removed';
-    /** Set when a safety commit was created. */
-    commitHash?: string;
-    /** Set when the orphan was preserved due to unmerged commits. */
-    unmergedCommitCount?: number;
-    /**
-     * True when the worktree DIRECTORY was removed from disk. For an unmerged
-     * orphan the branch ref is preserved (cheap, recoverable) while the worktree
-     * dir is dropped (no detritus) -- so a preserved action can still have the
-     * worktree removed.
-     */
-    worktreeRemoved?: boolean;
-    /** True when the branch ref was preserved (kept, not deleted). */
-    branchPreserved?: boolean;
-    /**
-     * The 8-char focus-key suffix parsed from the branch name
-     * (agent/<role>/<slug>-<8hexfocuskey>). Used to anchor any residual signal to
-     * the owning focus.
-     */
-    focusKey?: string;
-    /**
-     * Full focus id resolved from `focusKey` (where resolvable). Filled in by the
-     * async cleanup pass so housekeeping records / escalations carry a real anchor.
-     */
-    resolvedFocusId?: string;
-    /**
-     * True only in the unrecoverable corner: the worktree was dirty and the safety
-     * commit FAILED, so the work is on no ref. The worktree is kept (dropping it
-     * would lose the work). */
-    workUncaptured?: boolean;
-}
-export interface RecoveryResult {
-    orphansDetected: number;
-    orphansCleaned: number;
-    orphansPreserved: number;
-    branchesPruned: number;
-    branchesPreserved: number;
-    actions: CleanupAction[];
-    errors: string[];
-}
-/**
- * Injectable dependencies for testing.
- * Production code uses the defaults (real DB queries).
- */
-export interface RecoveryDeps {
-    getActiveSessions: () => Promise<AgentSession[]>;
-    getActiveFocuses: (organizationId: string, productId?: string) => Promise<Array<{
-        focus_id: string;
-        focus_name: string;
-        assigned_agent_role_id: string | null;
-    }>>;
-    updateSession: (sessionId: string, updates: Record<string, unknown>) => Promise<unknown>;
-    createEscalation: (params: CreateEscalationParams) => Promise<{
-        escalationId: string | null;
-    } | void>;
-    /**
-     * Best-effort resolution of an 8-char focus-key prefix (parsed from an orphan
-     * branch name) to a full focus id, so a residual housekeeping record /
-     * escalation can be anchored to the owning focus. Returns null when the focus
-     * cannot be resolved (e.g. the focus was deleted) -- anchoring then degrades
-     * to the always-known productId plus the focus_key carried in metadata.
-     */
-    resolveFocusByKeyPrefix: (keyPrefix: string, productId?: string) => Promise<{
-        focusId: string;
-        productId: string | null;
-    } | null>;
-    /**
-     * Remove a worktree directory (force) while leaving the branch ref intact.
-     * Defaults to `reapWorktreeAtomically` (base removal + a verified post-
-     * condition that no directory survives without its registration); injectable
-     * so the leftover-detritus path (returns false) is testable. False = dir not
-     * removed.
-     */
-    removeWorktreeDir: (repoPath: string, worktreePath: string) => boolean;
-}
-/**
- * Parse `git worktree list --porcelain` to build a map of
- * worktree path -> branch name for all registered worktrees.
- */
-export declare function parseWorktreeList(repoPath: string): Map<string, string>;
-/**
- * Scan the worktree directory and reconcile against active DB sessions
- * to classify each worktree as active or orphaned.
- */
-export declare function detectOrphanedWorktrees(config: DaemonConfig, deps?: RecoveryDeps): Promise<OrphanedWorktree[]>;
-/**
- * Clean up all orphaned worktrees. Returns actions taken and
- * any preserved orphans that need escalation.
- */
-export declare function cleanupOrphanedWorktrees(orphans: OrphanedWorktree[], config: DaemonConfig, deps?: RecoveryDeps): Promise<CleanupAction[]>;
-/**
- * Prune stale agent branches that have no worktree and no unmerged commits.
- *
- * Same housekeeping policy as the orphaned-worktree path: a branch with
- * unmerged commits is PRESERVED and LOGGED (the commits are recoverable from
- * the ref), never escalated. A merged branch with no worktree is safe to delete.
- * No path here files a needs_operator escalation -- branch-only orphans are
- * reality-side housekeeping the daemon owns.
- */
-export declare function pruneStaleAgentBranches(config: DaemonConfig): {
-    pruned: string[];
-    preserved: string[];
-};
-/**
- * Run full crash recovery: detect orphans, clean up, prune branches.
- *
- * Safe to call multiple times — idempotent by design. A second run
- * with no new crashes finds nothing to clean.
- */
-export declare function recoverFromCrash(config: DaemonConfig, deps?: RecoveryDeps): Promise<RecoveryResult>;
-//# sourceMappingURL=crash-recovery.d.ts.map

package/dist/crash-recovery.d.ts.map

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