@proletariat/cli 0.3.110 → 0.3.112

package/dist/lib/session/renderer.js

@@ -0,0 +1,547 @@
+/**
+ * Session Renderer (PRLT-1272)
+ *
+ * Unified machine-wide session collection and grouped rendering.
+ *
+ * The principle: `prlt session list`, `prlt orchestrator status`, and related
+ * commands should ALWAYS query machine-wide for all sessions, regardless of
+ * whether the user is inside an HQ. Sessions are then visually grouped by
+ * their originating HQ — the current HQ bubbles to the top, other locations
+ * are still visible but de-emphasized.
+ *
+ * Sources collected:
+ *   1. machine.db `executions` table — cross-repo ticketless and ticketed work
+ *   2. Each registered HQ's workspace.db `agent_work` table — per-HQ workers
+ *   3. Discovered tmux/Docker orchestrator sessions — detected by name prefix
+ *
+ * Each entry is annotated with its hqPath/hqName/role so the renderer can
+ * group them.
+ */
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { execSync } from 'node:child_process';
+import { ExecutionStorage } from '../execution/storage.js';
+import { openWorkspaceDatabase } from '../database/index.js';
+import { MachineDB } from '../machine-db.js';
+import { getRegisteredHeadquarters, getHeadquartersNameFromPath, normalizePath, } from '../machine-config.js';
+import { checkContainerLiveness, discoverSessionId, findContainerSessionsByPrefix, getContainerTmuxSessionMap, getHostTmuxSessionNames, isContainerEnvironment, isSessionAlive, } from '../execution/session-utils.js';
+import { findHQRoot } from '../workspace.js';
+function captureRuntimeSnapshot() {
+    return {
+        hostTmuxSessions: getHostTmuxSessionNames(),
+        containerTmuxSessions: getContainerTmuxSessionMap(),
+    };
+}
+function findRunningOrchestratorContainers() {
+    try {
+        const output = execSync('docker ps --filter "name=prlt-orchestrator-" --format "{{.Names}}\t{{.ID}}"', { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+        if (!output)
+            return [];
+        return output
+            .split('\n')
+            .filter(Boolean)
+            .map(line => {
+            const [name, id] = line.split('\t');
+            return { name, containerId: id };
+        });
+    }
+    catch {
+        return [];
+    }
+}
+// =============================================================================
+// HQ resolution helpers
+// =============================================================================
+/**
+ * Sanitize a name segment for use in tmux session names.
+ * Mirror of orchestrator/start.ts sanitizeName() — duplicated here to avoid
+ * importing a command file from a lib helper (cycle risk).
+ */
+function sanitizeName(name) {
+    return name
+        .replace(/[^a-zA-Z0-9._-]/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+/**
+ * Build the orchestrator session prefix used by `prlt orchestrator start`.
+ * Format: `prlt-orchestrator-{sanitizedHqName}-`
+ */
+function orchestratorPrefixForHq(hqName) {
+    return `prlt-orchestrator-${sanitizeName(hqName) || 'default'}-`;
+}
+/**
+ * Try to attribute an orchestrator session/container name to one of the
+ * registered HQs. Returns the matching HQ entry, or null if no match.
+ */
+function attributeOrchestratorToHq(sessionName, registered) {
+    for (const hq of registered) {
+        const hqName = getHeadquartersNameFromPath(hq.path);
+        const prefix = orchestratorPrefixForHq(hqName);
+        if (sessionName.startsWith(prefix)) {
+            return {
+                hqPath: hq.path,
+                hqName,
+                orchestratorName: sessionName.slice(prefix.length),
+            };
+        }
+    }
+    return null;
+}
+/**
+ * Replace the user's home directory in a path with `~` for display.
+ */
+export function tildifyPath(p) {
+    if (!p)
+        return p;
+    const home = process.env.HOME || os.homedir();
+    if (p === home)
+        return '~';
+    if (p.startsWith(home + path.sep))
+        return '~' + p.slice(home.length);
+    return p;
+}
+// =============================================================================
+// Workspace.db (per-HQ) collection
+// =============================================================================
+function collectFromWorkspaceDb(hqPath, hqName, snapshot, includeAll) {
+    const sessions = [];
+    let db = null;
+    try {
+        db = openWorkspaceDatabase(hqPath);
+    }
+    catch {
+        return sessions;
+    }
+    try {
+        const storage = new ExecutionStorage(db);
+        // Active executions (running + starting)
+        const active = [
+            ...storage.listExecutions({ status: 'running' }),
+            ...storage.listExecutions({ status: 'starting' }),
+        ];
+        // Self-healing: also check stopped records that may have a live tmux session
+        if (includeAll) {
+            active.push(...storage.listExecutions({ status: 'stopped' }));
+        }
+        else {
+            // Promote any stopped executions whose tmux sessions are still alive.
+            const stopped = storage.listExecutions({ status: 'stopped' });
+            for (const exec of stopped) {
+                if (isSessionAlive(exec)) {
+                    active.push(exec);
+                }
+            }
+        }
+        for (const exec of active) {
+            const isContainer = isContainerEnvironment(exec.environment);
+            let exists = false;
+            let actualSessionId = discoverSessionId(exec, snapshot.hostTmuxSessions, snapshot.containerTmuxSessions) ||
+                exec.sessionId;
+            if (isContainer && exec.containerId) {
+                const containerStatus = checkContainerLiveness(exec.containerId);
+                if (containerStatus === 'running') {
+                    if (actualSessionId) {
+                        const containerSessions = findContainerSessionsByPrefix(snapshot.containerTmuxSessions, exec.containerId);
+                        exists = containerSessions.includes(actualSessionId);
+                    }
+                    if (!exists) {
+                        // Container running but no tmux session — still counts as alive.
+                        exists = true;
+                        actualSessionId =
+                            actualSessionId || `container:${exec.containerId.substring(0, 12)}`;
+                    }
+                }
+            }
+            else if (actualSessionId) {
+                exists = snapshot.hostTmuxSessions.includes(actualSessionId);
+            }
+            if (!actualSessionId)
+                continue;
+            if (!exists && !includeAll)
+                continue;
+            // Determine role: agentName 'orchestrator-*' or ticketId 'ORCH'
+            let role = 'worker';
+            if (exec.agentName.startsWith('orchestrator') ||
+                exec.ticketId === 'ORCH' ||
+                exec.ticketId === 'orchestrator') {
+                role = 'orchestrator';
+            }
+            sessions.push({
+                id: exec.id,
+                sessionId: actualSessionId,
+                ticketId: exec.ticketId,
+                agentName: exec.agentName,
+                status: deriveStatus(exec.status, exists, exec.lifecycleState),
+                role,
+                environment: isContainer ? 'container' : 'host',
+                containerId: exec.containerId,
+                exists,
+                source: 'db',
+                startedAt: exec.startedAt,
+                lastHeartbeat: exec.lastHeartbeat,
+                lifecycleState: exec.lifecycleState,
+                hqPath,
+                hqName,
+                repoPath: hqPath,
+            });
+        }
+    }
+    finally {
+        db.close();
+    }
+    return sessions;
+}
+function deriveStatus(rawStatus, exists, lifecycleState) {
+    if (lifecycleState === 'died')
+        return 'died';
+    if (lifecycleState === 'idle')
+        return 'idle';
+    if (!exists)
+        return 'stale';
+    return rawStatus || 'running';
+}
+// =============================================================================
+// machine.db collection
+// =============================================================================
+function collectFromMachineDb(snapshot, registered, alreadySeenSessionIds, includeAll) {
+    const sessions = [];
+    let db = null;
+    try {
+        db = new MachineDB();
+    }
+    catch {
+        return sessions;
+    }
+    try {
+        const machineExecs = includeAll
+            ? db.listExecutions()
+            : db.getActiveExecutions();
+        for (const exec of machineExecs) {
+            // Skip duplicates already collected from a workspace.db.
+            if (exec.sessionId && alreadySeenSessionIds.has(exec.sessionId))
+                continue;
+            const isContainer = exec.environment === 'docker' || exec.environment === 'devcontainer';
+            let exists = false;
+            let actualSessionId = exec.sessionId;
+            if (isContainer && exec.containerId) {
+                const status = checkContainerLiveness(exec.containerId);
+                if (status === 'running') {
+                    if (exec.sessionId) {
+                        const containerSessions = findContainerSessionsByPrefix(snapshot.containerTmuxSessions, exec.containerId);
+                        exists = containerSessions.includes(exec.sessionId);
+                    }
+                    if (!exists) {
+                        exists = true;
+                        actualSessionId =
+                            actualSessionId || `container:${exec.containerId.substring(0, 12)}`;
+                    }
+                }
+            }
+            else if (exec.sessionId) {
+                exists = snapshot.hostTmuxSessions.includes(exec.sessionId);
+            }
+            if (!actualSessionId)
+                continue;
+            if (!exists && !includeAll)
+                continue;
+            // Attribute repoPath to a registered HQ if possible.
+            const matchedHq = matchRepoToHq(exec.repoPath, registered);
+            // Detect role
+            let role = exec.ticketId ? 'worker' : 'headless';
+            if (exec.agentName.startsWith('orchestrator') ||
+                exec.ticketId === 'ORCH' ||
+                exec.ticketId === 'orchestrator') {
+                role = 'orchestrator';
+            }
+            sessions.push({
+                id: exec.id,
+                sessionId: actualSessionId,
+                ticketId: exec.ticketId || exec.id,
+                agentName: exec.agentName,
+                status: deriveStatus(exec.status, exists),
+                role,
+                environment: isContainer ? 'container' : 'host',
+                containerId: exec.containerId,
+                exists,
+                source: 'db',
+                startedAt: exec.startedAt,
+                hqPath: matchedHq?.hqPath,
+                hqName: matchedHq?.hqName,
+                repoPath: exec.repoPath,
+            });
+        }
+    }
+    finally {
+        db.close();
+    }
+    return sessions;
+}
+/**
+ * Match a repo path to one of the registered HQs.
+ * A repo is considered to belong to an HQ if it lives inside the HQ tree
+ * (e.g. an agent worktree under `<hqPath>/agents/...`).
+ */
+function matchRepoToHq(repoPath, registered) {
+    if (!repoPath)
+        return null;
+    let normalized;
+    try {
+        normalized = normalizePath(repoPath);
+    }
+    catch {
+        normalized = repoPath;
+    }
+    for (const hq of registered) {
+        let hqNormalized;
+        try {
+            hqNormalized = normalizePath(hq.path);
+        }
+        catch {
+            hqNormalized = hq.path;
+        }
+        if (normalized === hqNormalized || normalized.startsWith(hqNormalized + path.sep)) {
+            return { hqPath: hq.path, hqName: getHeadquartersNameFromPath(hq.path) };
+        }
+    }
+    return null;
+}
+// =============================================================================
+// Orchestrator discovery (tmux + Docker)
+// =============================================================================
+function collectOrchestrators(snapshot, registered, alreadySeenSessionIds) {
+    const sessions = [];
+    // Host tmux orchestrator sessions
+    for (const sessionName of snapshot.hostTmuxSessions) {
+        if (!sessionName.startsWith('prlt-orchestrator-'))
+            continue;
+        if (alreadySeenSessionIds.has(sessionName))
+            continue;
+        const attribution = attributeOrchestratorToHq(sessionName, registered);
+        sessions.push({
+            id: sessionName,
+            sessionId: sessionName,
+            ticketId: 'orchestrator',
+            agentName: attribution?.orchestratorName || sessionName,
+            status: 'running',
+            role: 'orchestrator',
+            environment: 'host',
+            exists: true,
+            source: 'discovered',
+            hqPath: attribution?.hqPath,
+            hqName: attribution?.hqName,
+            repoPath: attribution?.hqPath,
+        });
+    }
+    // Docker orchestrator containers
+    const dockerOrchestrators = findRunningOrchestratorContainers();
+    for (const { name, containerId } of dockerOrchestrators) {
+        if (alreadySeenSessionIds.has(name))
+            continue;
+        const attribution = attributeOrchestratorToHq(name, registered);
+        sessions.push({
+            id: name,
+            sessionId: name,
+            ticketId: 'orchestrator',
+            agentName: attribution?.orchestratorName || name,
+            status: 'running',
+            role: 'orchestrator',
+            environment: 'container',
+            containerId,
+            exists: true,
+            source: 'discovered',
+            hqPath: attribution?.hqPath,
+            hqName: attribution?.hqName,
+            repoPath: attribution?.hqPath,
+        });
+    }
+    return sessions;
+}
+// =============================================================================
+// Public API: collect + group
+// =============================================================================
+/**
+ * Collect all sessions on the machine, regardless of cwd.
+ *
+ * Queries:
+ *   1. machine.db (cross-repo executions, source of truth for ticketless work)
+ *   2. Every registered HQ's workspace.db (workers per HQ)
+ *   3. tmux/Docker (orchestrators by name prefix)
+ *
+ * Filters are applied at the end so the underlying machine query path is
+ * the same in every command.
+ */
+export function collectAllSessions(options = {}) {
+    const snapshot = captureRuntimeSnapshot();
+    const registered = getRegisteredHeadquarters().filter(hq => fs.existsSync(hq.path));
+    // Include the current cwd HQ even when it isn't in the machine registry
+    // (e.g. e2e tests that set up a throwaway HQ without registering it).
+    const cwdHq = findHQRoot(process.cwd());
+    const hqsToQuery = [...registered];
+    if (cwdHq) {
+        let cwdNormalized;
+        try {
+            cwdNormalized = normalizePath(cwdHq);
+        }
+        catch {
+            cwdNormalized = cwdHq;
+        }
+        const alreadyRegistered = registered.some(hq => {
+            try {
+                return normalizePath(hq.path) === cwdNormalized;
+            }
+            catch {
+                return hq.path === cwdNormalized;
+            }
+        });
+        if (!alreadyRegistered) {
+            hqsToQuery.push({
+                name: getHeadquartersNameFromPath(cwdHq),
+                path: cwdHq,
+                registeredAt: new Date().toISOString(),
+            });
+        }
+    }
+    const seenSessionIds = new Set();
+    const all = [];
+    // 1) Per-HQ workspace databases (workers + locally tracked orchestrators).
+    for (const hq of hqsToQuery) {
+        const hqName = getHeadquartersNameFromPath(hq.path);
+        const fromHq = collectFromWorkspaceDb(hq.path, hqName, snapshot, options.includeAll === true);
+        for (const s of fromHq) {
+            if (s.sessionId)
+                seenSessionIds.add(s.sessionId);
+            all.push(s);
+        }
+    }
+    // 2) machine.db ticketless / cross-repo executions
+    const fromMachine = collectFromMachineDb(snapshot, hqsToQuery, seenSessionIds, options.includeAll === true);
+    for (const s of fromMachine) {
+        if (s.sessionId)
+            seenSessionIds.add(s.sessionId);
+        all.push(s);
+    }
+    // 3) Discovered orchestrator tmux/Docker sessions not yet covered by a DB
+    const discoveredOrchestrators = collectOrchestrators(snapshot, hqsToQuery, seenSessionIds);
+    for (const s of discoveredOrchestrators) {
+        if (s.sessionId)
+            seenSessionIds.add(s.sessionId);
+        all.push(s);
+    }
+    // Apply filters
+    let filtered = all;
+    if (options.hqPathFilter) {
+        let normalized;
+        try {
+            normalized = normalizePath(options.hqPathFilter);
+        }
+        catch {
+            normalized = options.hqPathFilter;
+        }
+        filtered = filtered.filter(s => {
+            if (!s.hqPath)
+                return false;
+            try {
+                return normalizePath(s.hqPath) === normalized;
+            }
+            catch {
+                return s.hqPath === normalized;
+            }
+        });
+    }
+    if (options.roleFilter) {
+        filtered = filtered.filter(s => s.role === options.roleFilter);
+    }
+    return filtered;
+}
+/**
+ * Group sessions into "current HQ" vs "other locations" buckets.
+ *
+ * The current HQ is resolved from `process.cwd()` (or an explicit override).
+ * Sessions whose hqPath matches the current HQ go into `here`; everything
+ * else goes into `elsewhere`.
+ */
+export function groupSessionsByHQ(sessions, currentHqOverride) {
+    const currentHq = currentHqOverride === null
+        ? undefined
+        : currentHqOverride ?? findHQRoot(process.cwd()) ?? undefined;
+    let normalizedCurrent;
+    if (currentHq) {
+        try {
+            normalizedCurrent = normalizePath(currentHq);
+        }
+        catch {
+            normalizedCurrent = currentHq;
+        }
+    }
+    const here = [];
+    const elsewhere = [];
+    for (const s of sessions) {
+        if (!normalizedCurrent || !s.hqPath) {
+            elsewhere.push(s);
+            continue;
+        }
+        let normalizedSession;
+        try {
+            normalizedSession = normalizePath(s.hqPath);
+        }
+        catch {
+            normalizedSession = s.hqPath;
+        }
+        if (normalizedSession === normalizedCurrent) {
+            here.push(s);
+        }
+        else {
+            elsewhere.push(s);
+        }
+    }
+    return {
+        currentHq,
+        currentHqName: currentHq ? getHeadquartersNameFromPath(currentHq) : undefined,
+        here,
+        elsewhere,
+    };
+}
+// =============================================================================
+// Pretty rendering helpers (text)
+// =============================================================================
+/** Format a Date into a compact relative duration like "~15m", "~3h", "~2d". */
+export function formatRelativeAge(start, now = new Date()) {
+    if (!start)
+        return '';
+    const diffMs = Math.max(0, now.getTime() - start.getTime());
+    const sec = Math.floor(diffMs / 1000);
+    if (sec < 60)
+        return `~${sec}s`;
+    const min = Math.floor(sec / 60);
+    if (min < 60)
+        return `~${min}m`;
+    const hr = Math.floor(min / 60);
+    if (hr < 48)
+        return `~${hr}h`;
+    const day = Math.floor(hr / 24);
+    return `~${day}d`;
+}
+/**
+ * Group elsewhere sessions by hqPath/hqName for nicer rendering.
+ * Sessions without an hqPath are bucketed under "(no HQ)".
+ */
+export function bucketElsewhereByHq(elsewhere) {
+    const buckets = new Map();
+    for (const s of elsewhere) {
+        const key = s.hqPath ?? '__none__';
+        let bucket = buckets.get(key);
+        if (!bucket) {
+            bucket = {
+                hqPath: s.hqPath ?? null,
+                hqName: s.hqName ?? '(no HQ)',
+                sessions: [],
+            };
+            buckets.set(key, bucket);
+        }
+        bucket.sessions.push(s);
+    }
+    return Array.from(buckets.values());
+}
+//# sourceMappingURL=renderer.js.map

package/dist/lib/session/renderer.js.map

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

package/dist/lib/update-check.d.ts

@@ -84,23 +84,79 @@ export declare function isNewerVersion(current: string, latest: string): boolean
 /**
  * Get the npm global node_modules directory.
  * Returns null if it cannot be determined.
+ *
+ * Honours the `PRLT_NPM_MODULES_DIR_OVERRIDE` env var for tests so the
+ * backup/restore logic in {@link runNpmInstallWithRetry} can be exercised
+ * against a temp directory instead of the user's real npm prefix.
  */
 export declare function getNpmGlobalModulesDir(): string | null;
 /**
- * Remove the existing @proletariat/cli directory from npm global node_modules.
- * This prevents ENOTEMPTY errors during `npm install -g`, which is a known npm
- * bug where renaming the old package directory fails.
+ * Captured state of a bin symlink — used so we can restore the symlink
+ * if npm removed it during a failed retry install (PRLT-1276).
+ */
+interface BinSymlinkRecord {
+    /** Absolute path to the bin entry (e.g. `<prefix>/bin/prlt`) */
+    path: string;
+    /** Original link target, as returned by `readlink` (may be relative) */
+    target: string;
+}
+/**
+ * State captured before we disturb the current @proletariat/cli install,
+ * so it can be restored if the retry install fails.
+ */
+export interface NpmPackageBackup {
+    /** Absolute path to the original package directory */
+    originalPath: string;
+    /**
+     * Absolute path to the backup (rename-aside) location.
+     * Empty string when there was nothing to back up (package dir did not exist).
+     */
+    backupPath: string;
+    /** Bin symlinks that existed before the backup was taken */
+    binSymlinks: BinSymlinkRecord[];
+}
+/**
+ * Back up the existing @proletariat/cli package directory via atomic rename
+ * so an install retry can run against a clean slate while preserving the
+ * ability to restore the previous installation if the retry fails.
  *
- * Safe to call even if the directory doesn't exist.
+ * The backup is placed adjacent to the original in the same directory, so
+ * the rename is guaranteed to be atomic. Returns null if the rename fails
+ * (e.g. permission error) — in that case the caller must not proceed,
+ * because destroying the package dir without a backup is exactly the
+ * PRLT-1276 regression we are trying to avoid.
+ *
+ * When there is no existing package dir to back up, this still returns a
+ * valid `NpmPackageBackup` with an empty `backupPath` — the bin symlink
+ * records are still captured so they can be restored on failure.
+ */
+export declare function backupNpmPackageDir(): NpmPackageBackup | null;
+/**
+ * Restore the backup created by {@link backupNpmPackageDir} after a failed
+ * retry. Removes any partially-installed content at the original path,
+ * renames the backup back into place, and re-creates bin symlinks that npm
+ * may have removed during the failed install.
  */
-export declare function cleanNpmPackageDir(): boolean;
+export declare function restoreNpmPackageBackup(info: NpmPackageBackup): boolean;
+/**
+ * Remove the backup created by {@link backupNpmPackageDir} after a
+ * successful retry. Best-effort — failures are not fatal.
+ */
+export declare function discardNpmPackageBackup(info: NpmPackageBackup): void;
 /**
  * Run an npm global install command with automatic ENOTEMPTY retry.
  *
  * npm global installs frequently fail with ENOTEMPTY when renaming the
  * old package directory (a known npm bug). When this error is detected
- * in stderr, the old package directory is removed and the install is
- * retried transparently.
+ * in stderr, the existing @proletariat/cli directory is moved aside via
+ * an atomic rename, the install is retried against a clean slate, and
+ * the backup is either discarded (on success) or restored (on failure).
+ *
+ * PRLT-1276: this is the restore-on-failure path that fixes the "prlt
+ * intermittently disappears from PATH" bug. Previously we `rm -rf`'d the
+ * package directory before retrying, so a retry that failed for any reason
+ * (network glitch, timeout, nvm mid-switch) left the user with a deleted
+ * package and a dangling `bin/prlt` symlink.
  *
  * Throws on failure (both non-ENOTEMPTY errors and failed retries).
  */
@@ -152,3 +208,4 @@ export declare function dismissVersion(version: string): void;
  * This is the default "Skip" behavior — just don't persist anything.
  */
 export declare function dismissSession(): void;
+export {};