@adhdev/daemon-core 1.0.18-rc.19 → 1.0.18-rc.2

package/dist/commands/process-lifecycle.d.ts

@@ -1,43 +0,0 @@
-export interface ProcessLifecycleOptions {
-    platform?: NodeJS.Platform;
-    execFileSync?: typeof import('child_process').execFileSync;
-}
-export interface OwnedProcessInfo {
-    pid: number;
-    commandLine: string | null;
-}
-export declare function getProcessCommandLine(pid: number, options?: ProcessLifecycleOptions): string | null;
-/**
- * Extract the script argument (the token after the node executable) from a
- * command line. Handles both quoted and unquoted executables/scripts.
- */
-export declare function parseNodeScriptPath(commandLine: string | null): string | null;
-export declare function killProcess(pid: number, options?: ProcessLifecycleOptions): boolean;
-export declare function waitForPidExit(pid: number, timeoutMs: number): Promise<boolean>;
-/**
- * List Node processes whose command line places them under any of the supplied
- * prefixes. Windows-only — the versioned-prefix lifecycle this supports does not
- * exist on POSIX, so the helper is a no-op there.
- */
-export declare function listOwnedNodeProcesses(options: {
-    prefixes: readonly string[];
-    excludePids?: readonly number[];
-    markers?: readonly string[];
-} & ProcessLifecycleOptions): OwnedProcessInfo[];
-export declare function stopOwnedProcesses(options: {
-    processes: readonly OwnedProcessInfo[];
-    waitMs?: number;
-} & ProcessLifecycleOptions): Promise<{
-    stopped: number;
-    survivors: OwnedProcessInfo[];
-}>;
-export declare function stopOwnedProcessesForPrefixes(options: {
-    prefixes: readonly string[];
-    excludePids?: readonly number[];
-    markers?: readonly string[];
-    waitMs?: number;
-    log?: (message: string) => void;
-} & ProcessLifecycleOptions): Promise<{
-    stopped: number;
-    survivors: OwnedProcessInfo[];
-}>;

package/dist/mesh/mesh-disk-retention.d.ts

@@ -1,105 +0,0 @@
-import type { SessionHostSurfaceRecordLike } from '../session-host/runtime-surface.js';
-import type { LocalMeshEntry } from '../repo-mesh-types.js';
-export declare const DAY_MS: number;
-/** JSONL ledger files are legacy after the SQLite ledger — 30-day lifetime. */
-export declare const LEDGER_JSONL_MAX_AGE_MS: number;
-/** Terminated session-host runtimes: conservative 14-day retention. */
-export declare const SESSION_HOST_RUNTIME_MAX_AGE_MS: number;
-/** mesh-runtime.db.bak-* backups: 7-day retention. */
-export declare const DB_BAK_MAX_AGE_MS: number;
-/** A file candidate for age-based pruning: absolute path + last-modified epoch ms. */
-export interface AgedFile {
-    path: string;
-    mtimeMs: number;
-}
-/**
- * PURE. Select the JSONL ledger files whose mtime is older than `maxAgeMs`
- * relative to `now`. A file exactly at the threshold is KEPT (strict `>`), so a
- * 30-day-old file survives its 30th day and is pruned on the 31st. Deterministic:
- * no fs access, no clock read.
- */
-export declare function selectExpiredLedgerJsonl(files: AgedFile[], now: number, maxAgeMs?: number): AgedFile[];
-/** A parsed session-host runtime file: its path, mtime, and the wrapped record. */
-export interface SessionHostRuntimeFile {
-    path: string;
-    mtimeMs: number;
-    /** The `record` object from the on-disk `{ record, snapshot, updatedAt }` file. */
-    record: SessionHostSurfaceRecordLike | null;
-}
-/**
- * PURE. Select the session-host runtime files safe to delete: ONLY those whose
- * runtime is terminated/dead (NOT a live runtime — decided by the session-host-core
- * SSOT `isSessionHostLiveRuntime`) AND older than `maxAgeMs`. A live runtime, or a
- * dead-but-recent one, is always kept. A file whose record failed to parse is treated
- * as NON-live but is still age-gated, so a corrupt-but-fresh file is never removed.
- */
-export declare function selectExpiredSessionHostRuntimes(files: SessionHostRuntimeFile[], now: number, maxAgeMs?: number): SessionHostRuntimeFile[];
-/** True for a `mesh-runtime.db.bak-*` backup filename (basename only). */
-export declare function isDbBackupFileName(name: string): boolean;
-/** PURE. Select `.bak-*` backups older than `maxAgeMs`. Strict `>` (see ledger). */
-export declare function selectExpiredDbBackups(files: AgedFile[], now: number, maxAgeMs?: number): AgedFile[];
-/** Minimal shape needed to decide whether a worktree path is orphaned. */
-export interface WorktreePathLike {
-    path: string;
-    bare?: boolean;
-}
-/** A live mesh node's known workspace paths (self workspace + repoRoot, normalized). */
-export interface LiveNodeWorkspaceLike {
-    workspace?: string;
-    repoRoot?: string;
-}
-/**
- * PURE. Given the worktrees git reports on disk and the set of live-node workspace
- * paths, return the worktrees that have NO matching live node — the orphan
- * cleanup_candidates.
- *
- * SAFETY:
- *  - `mainWorktreePath` (the primary repo checkout, i.e. worktree[0]) is NEVER an
- *    orphan — it is the base repo, not a mesh clone.
- *  - `bare` worktrees are skipped (git's internal bookkeeping, not a node checkout).
- *  - Matching is path-equality after trailing-separator normalization against the
- *    union of every live node's `workspace` and `repoRoot`.
- * This is DETECTION ONLY — the caller signals a cleanup_candidate; it must not delete.
- */
-export declare function detectOrphanWorktrees(worktrees: WorktreePathLike[], liveNodes: LiveNodeWorkspaceLike[], mainWorktreePath: string): WorktreePathLike[];
-/**
- * Prune expired legacy JSONL ledger files under ~/.adhdev/mesh-ledger/.
- * Matches only `*.jsonl` (never the SQLite .db / -wal / -shm files). Returns the
- * count deleted. Best-effort: individual unlink failures are logged, not thrown.
- */
-export declare function pruneExpiredLedgerJsonl(now?: number): number;
-/**
- * Prune expired `mesh-runtime.db.bak-*` backups under ~/.adhdev/mesh-ledger/.
- * Never touches the live DB (only names matching the .bak- prefix). Returns count.
- */
-export declare function pruneExpiredDbBackups(now?: number): number;
-/**
- * Prune terminated session-host runtime files older than 14 days across every
- * ~/.adhdev/session-host/<app>/runtimes/ directory. A LIVE runtime is never deleted
- * regardless of age (isSessionHostLiveRuntime SSOT). Returns count deleted.
- */
-export declare function pruneExpiredSessionHostRuntimes(now?: number): number;
-/**
- * Run the file-deleting retention passes (JSONL ledger, DB backups, session-host
- * runtimes) once. Each pass is isolated so one failing pass never blocks the others.
- * Orphan-worktree DETECTION is driven separately in the reconcile loop (it needs the
- * live mesh config + git worktree list and emits a ledger signal rather than deleting).
- */
-export declare function runDiskRetentionSweep(now?: number): {
-    ledgerJsonl: number;
-    dbBackups: number;
-    sessionHostRuntimes: number;
-};
-/**
- * Detect orphaned worktrees for ONE mesh and emit a `worktree_cleanup_candidate`
- * ledger signal for each — DETECTION ONLY, never deletes. An orphan is a git worktree
- * on disk with no matching live mesh node (compared by path). It:
- *   1. picks a base (non-worktree) node owned by this mesh to anchor `git worktree list`;
- *   2. diffs the reported worktrees against the union of every node's workspace/repoRoot;
- *   3. skips the main worktree + bare entries (detectOrphanWorktrees safety);
- *   4. suppresses a repeat for a worktreePath already signalled within the recent window
- *      (idempotent re-emit guard), so the hourly sweep doesn't spam the ledger.
- * Returns the list of newly-signalled orphan paths. Best-effort: git/ledger failures are
- * logged and yield an empty result, never thrown.
- */
-export declare function detectAndSignalOrphanWorktrees(mesh: LocalMeshEntry, now?: number): Promise<string[]>;

package/dist/providers/auto-approve-modes.d.ts

@@ -1,14 +0,0 @@
-import type { AutoApproveMode, AutoApproveModeRisk, AutoApproveModeStrategy, ProviderModule } from './contracts.js';
-export interface ResolvedAutoApproveMode {
-    active: boolean;
-    strategy: AutoApproveModeStrategy;
-    modeId: string;
-}
-/** Runtime defense-in-depth for provider definitions that bypass schema validation. */
-export declare function deriveAutoApproveModeRisk(mode: Pick<AutoApproveMode, 'risk' | 'launchArgs'>): AutoApproveModeRisk;
-/**
- * Resolve new mode settings before the legacy boolean. A stale/unknown explicit
- * mode id fails closed instead of falling through to an enabled legacy setting.
- */
-export declare function resolveProviderAutoApproveMode(provider: ProviderModule, settings: Record<string, unknown> | undefined): ResolvedAutoApproveMode;
-export declare function findProviderAutoApproveMode(provider: ProviderModule | undefined, modeId: string): AutoApproveMode | undefined;

package/src/commands/process-lifecycle.ts

@@ -1,248 +0,0 @@
-import { execFileSync, type ExecFileSyncOptions } from 'child_process';
-import * as path from 'path';
-
-export interface ProcessLifecycleOptions {
-    platform?: NodeJS.Platform;
-    execFileSync?: typeof import('child_process').execFileSync;
-}
-
-export interface OwnedProcessInfo {
-    pid: number;
-    commandLine: string | null;
-}
-
-function defaultExecFileSync(): typeof import('child_process').execFileSync {
-    return execFileSync;
-}
-
-function getWindowsProcessCommandLine(
-    pid: number,
-    exec: typeof import('child_process').execFileSync,
-): string | null {
-    const pidFilter = `ProcessId=${pid}`;
-
-    try {
-        const psOut = exec('powershell.exe', [
-            '-NoProfile',
-            '-NonInteractive',
-            '-ExecutionPolicy', 'Bypass',
-            '-Command',
-            `(Get-CimInstance Win32_Process -Filter "${pidFilter}").CommandLine`,
-        ], { encoding: 'utf8', timeout: 5000, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true });
-        const text = String(psOut).trim();
-        if (text) return text;
-    } catch {
-        // fall through to wmic fallback
-    }
-
-    try {
-        const wmicOut = exec('wmic', [
-            'process', 'where', pidFilter, 'get', 'CommandLine',
-        ], { encoding: 'utf8', timeout: 3000, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true });
-        const text = String(wmicOut).trim();
-        if (text) return text;
-    } catch {
-        // noop
-    }
-
-    return null;
-}
-
-export function getProcessCommandLine(
-    pid: number,
-    options: ProcessLifecycleOptions = {},
-): string | null {
-    if (!Number.isFinite(pid) || pid <= 0) return null;
-    const exec = options.execFileSync ?? defaultExecFileSync();
-    const platform = options.platform ?? process.platform;
-
-    if (platform === 'win32') {
-        return getWindowsProcessCommandLine(pid, exec);
-    }
-
-    try {
-        const text = String(exec('ps', ['-o', 'command=', '-p', String(pid)], {
-            encoding: 'utf8',
-            timeout: 3000,
-            stdio: ['ignore', 'pipe', 'ignore'],
-        })).trim();
-        return text || null;
-    } catch {
-        return null;
-    }
-}
-
-/**
- * Extract the script argument (the token after the node executable) from a
- * command line. Handles both quoted and unquoted executables/scripts.
- */
-export function parseNodeScriptPath(commandLine: string | null): string | null {
-    if (!commandLine) return null;
-    let rest = commandLine.trim();
-
-    // Skip the leading executable token.
-    if (rest.startsWith('"')) {
-        const end = rest.indexOf('"', 1);
-        if (end === -1) return null;
-        rest = rest.slice(end + 1).trim();
-    } else {
-        const idx = rest.search(/\s/);
-        if (idx === -1) return null;
-        rest = rest.slice(idx + 1).trim();
-    }
-    if (!rest) return null;
-
-    if (rest.startsWith('"')) {
-        const end = rest.indexOf('"', 1);
-        return end === -1 ? rest.slice(1) : rest.slice(1, end);
-    }
-    const idx = rest.search(/\s/);
-    return idx === -1 ? rest : rest.slice(0, idx);
-}
-
-function normalizeWindowsPath(value: string): string {
-    return value.toLowerCase().replace(/\//g, '\\').replace(/\\+$/, '');
-}
-
-function isCommandLineUnderPrefix(commandLine: string | null, prefix: string): boolean {
-    if (!commandLine) return false;
-    const needle = normalizeWindowsPath(prefix);
-    // Command-line paths may quote Windows separators as either single or
-    // doubled backslashes; collapse doubles before matching.
-    const haystack = commandLine.split('\\\\').join('\\').toLowerCase();
-    return haystack.includes(needle);
-}
-
-export function killProcess(pid: number, options: ProcessLifecycleOptions = {}): boolean {
-    if (!Number.isFinite(pid) || pid <= 0) return false;
-    const exec = options.execFileSync ?? defaultExecFileSync();
-    const platform = options.platform ?? process.platform;
-
-    try {
-        if (platform === 'win32') {
-            exec('taskkill', ['/PID', String(pid), '/T', '/F'], {
-                stdio: 'ignore',
-                windowsHide: true,
-            });
-        } else {
-            process.kill(pid, 'SIGTERM');
-        }
-        return true;
-    } catch {
-        return false;
-    }
-}
-
-export async function waitForPidExit(pid: number, timeoutMs: number): Promise<boolean> {
-    const start = Date.now();
-    while (Date.now() - start < timeoutMs) {
-        try {
-            process.kill(pid, 0);
-            await new Promise((resolve) => setTimeout(resolve, 250));
-        } catch {
-            return true;
-        }
-    }
-    return false;
-}
-
-/**
- * List Node processes whose command line places them under any of the supplied
- * prefixes. Windows-only — the versioned-prefix lifecycle this supports does not
- * exist on POSIX, so the helper is a no-op there.
- */
-export function listOwnedNodeProcesses(options: {
-    prefixes: readonly string[];
-    excludePids?: readonly number[];
-    markers?: readonly string[];
-} & ProcessLifecycleOptions): OwnedProcessInfo[] {
-    const platform = options.platform ?? process.platform;
-    if (platform !== 'win32') return [];
-
-    const exec = options.execFileSync ?? defaultExecFileSync();
-    const prefixes = options.prefixes.map((p) => normalizeWindowsPath(p));
-    const exclude = new Set((options.excludePids ?? []).filter((n) => Number.isFinite(n) && n > 0));
-    // Command-line paths use Windows separators; normalize marker separators the
-    // same way so a marker like "dist/cli/index.js" matches "dist\cli\index.js".
-    const markers = (options.markers ?? []).map((m) => m.toLowerCase().replace(/\//g, '\\'));
-
-    let pids: number[] = [];
-    try {
-        const out = String(exec('powershell.exe', [
-            '-NoProfile',
-            '-NonInteractive',
-            '-ExecutionPolicy', 'Bypass',
-            '-Command',
-            'Get-Process node -ErrorAction SilentlyContinue | Select-Object -ExpandProperty Id | ConvertTo-Json -Compress',
-        ], { encoding: 'utf8', timeout: 8000, stdio: ['ignore', 'pipe', 'ignore'], windowsHide: true })).trim();
-        if (out) {
-            const parsed = JSON.parse(out);
-            pids = Array.isArray(parsed) ? parsed : [parsed];
-        }
-    } catch {
-        return [];
-    }
-
-    const results: OwnedProcessInfo[] = [];
-    for (const pid of pids) {
-        if (!Number.isFinite(pid) || pid <= 0 || exclude.has(pid)) continue;
-        const commandLine = getProcessCommandLine(pid, { platform, execFileSync: exec });
-        if (!commandLine) continue;
-        const lower = commandLine.toLowerCase();
-        const underPrefix = prefixes.some((prefix) => lower.includes(prefix));
-        if (!underPrefix) continue;
-        if (markers.length > 0 && !markers.some((marker) => lower.includes(marker))) continue;
-        results.push({ pid, commandLine });
-    }
-    return results;
-}
-
-export async function stopOwnedProcesses(options: {
-    processes: readonly OwnedProcessInfo[];
-    waitMs?: number;
-} & ProcessLifecycleOptions): Promise<{ stopped: number; survivors: OwnedProcessInfo[] }> {
-    const waitMs = options.waitMs ?? 15_000;
-    const killed = new Set<number>();
-
-    for (const p of options.processes) {
-        if (killProcess(p.pid, options)) killed.add(p.pid);
-    }
-
-    const survivors: OwnedProcessInfo[] = [];
-    for (const p of options.processes) {
-        if (!killed.has(p.pid)) {
-            survivors.push(p);
-            continue;
-        }
-        const exited = await waitForPidExit(p.pid, waitMs);
-        if (!exited) survivors.push(p);
-    }
-
-    // A process counts as stopped only when it left the process table; a failed
-    // kill or a post-kill timeout both land it in `survivors`.
-    return { stopped: options.processes.length - survivors.length, survivors };
-}
-
-export async function stopOwnedProcessesForPrefixes(options: {
-    prefixes: readonly string[];
-    excludePids?: readonly number[];
-    markers?: readonly string[];
-    waitMs?: number;
-    log?: (message: string) => void;
-} & ProcessLifecycleOptions): Promise<{ stopped: number; survivors: OwnedProcessInfo[] }> {
-    const processes = listOwnedNodeProcesses(options);
-    if (processes.length === 0) return { stopped: 0, survivors: [] };
-
-    options.log?.(`Stopping ${processes.length} owned process(es) under prefixes: ${options.prefixes.join(', ')}`);
-    const result = await stopOwnedProcesses({
-        processes,
-        waitMs: options.waitMs,
-        platform: options.platform,
-        execFileSync: options.execFileSync,
-    });
-
-    if (result.survivors.length > 0) {
-        options.log?.(`Could not stop ${result.survivors.length} owned process(es): ${result.survivors.map((s) => s.pid).join(', ')}`);
-    }
-    return result;
-}