@proletariat/cli 0.3.95 → 0.3.97

package/dist/lib/external-issues/utils.js

@@ -0,0 +1,32 @@
+/**
+ * External issue metadata helpers.
+ */
+/**
+ * Extract external issue metadata from a ticket's metadata field.
+ * Returns the external source, key (e.g. PRLT-1065), id, and url.
+ */
+export function getTicketExternalMetadata(ticket) {
+    const metadata = (typeof ticket === 'object'
+        && ticket !== null
+        && 'metadata' in ticket
+        && typeof ticket.metadata === 'object'
+        && ticket.metadata !== null
+        ? ticket.metadata
+        : {});
+    return {
+        source: typeof metadata.external_source === 'string' ? metadata.external_source : undefined,
+        key: typeof metadata.external_key === 'string' ? metadata.external_key : undefined,
+        id: typeof metadata.external_id === 'string' ? metadata.external_id : undefined,
+        url: typeof metadata.external_url === 'string' ? metadata.external_url : undefined,
+    };
+}
+/**
+ * Resolve the display/branch ticket ID. When a ticket was imported from an
+ * external provider (e.g. Linear), the external key (PRLT-xxx) is preferred
+ * over the internal PMO ID (TKT-xxx).
+ */
+export function resolveExternalTicketId(ticket) {
+    const external = getTicketExternalMetadata(ticket);
+    return external.key || ticket.id;
+}
+//# sourceMappingURL=utils.js.map

package/dist/lib/external-issues/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/lib/external-issues/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAgE;IAMxG,MAAM,QAAQ,GAAG,CAAC,OAAO,MAAM,KAAK,QAAQ;WACvC,MAAM,KAAK,IAAI;WACf,UAAU,IAAI,MAAM;WACpB,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ;WACnC,MAAM,CAAC,QAAQ,KAAK,IAAI;QAC3B,CAAC,CAAC,MAAM,CAAC,QAAQ;QACjB,CAAC,CAAC,EAAE,CAA4B,CAAA;IAElC,OAAO;QACL,MAAM,EAAE,OAAO,QAAQ,CAAC,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS;QAC3F,GAAG,EAAE,OAAO,QAAQ,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;QAClF,EAAE,EAAE,OAAO,QAAQ,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;QAC/E,GAAG,EAAE,OAAO,QAAQ,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;KACnF,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAgE;IACtG,MAAM,QAAQ,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAA;IAClD,OAAO,QAAQ,CAAC,GAAG,IAAI,MAAM,CAAC,EAAE,CAAA;AAClC,CAAC"}

package/dist/lib/gc/index.d.ts

@@ -0,0 +1,179 @@
+/**
+ * Garbage Collection Module
+ *
+ * Core logic for cleaning up agent artifacts after PR merge/close.
+ * Handles: worktree removal, container removal, branch pruning (local + remote),
+ * tmux session cleanup, Claude session cleanup, DB record marking, agent name recycling,
+ * and stale PR closure.
+ *
+ * Used by both the `prlt gc` command and the daemon's post-merge phase.
+ */
+import { type ContainerInfo } from '../execution/container-cleanup.js';
+import { type PRInfo } from '../pr/index.js';
+export type GCArtifactStatus = 'merged' | 'closed' | 'stale' | 'active';
+export interface GCCandidate {
+    /** Worktree path on disk */
+    worktreePath: string;
+    /** Branch name checked out in this worktree */
+    branch: string;
+    /** Agent name extracted from worktree path */
+    agentName: string | null;
+    /** Repository name this worktree belongs to */
+    repoName: string;
+    /** Source repo path (bare/main repo) */
+    sourceRepoPath: string;
+    /** PR info if found */
+    pr: PRInfo | null;
+    /** Computed artifact status */
+    status: GCArtifactStatus;
+    /** Associated container, if any */
+    container: ContainerInfo | null;
+}
+export interface GCResult {
+    /** Worktrees removed */
+    worktreesRemoved: string[];
+    /** Containers removed */
+    containersRemoved: string[];
+    /** Local branches pruned */
+    branchesPruned: string[];
+    /** Remote branches deleted */
+    remoteBranchesDeleted: string[];
+    /** tmux sessions killed */
+    tmuxSessionsCleaned: string[];
+    /** Claude sessions cleaned */
+    claudeSessionsCleaned: string[];
+    /** DB execution records marked as gc_cleaned */
+    dbRecordsMarked: number;
+    /** DB execution records purged (deleted) */
+    dbRecordsPurged: number;
+    /** Agent names marked as recyclable */
+    agentNamesRecycled: string[];
+    /** Stale PRs closed */
+    stalePRsClosed: number[];
+    /** Errors encountered */
+    errors: string[];
+    /** Candidates that were skipped (active) */
+    skipped: string[];
+}
+export interface GCOptions {
+    /** Working directory (HQ path) */
+    hqPath: string;
+    /** Days of inactivity before a PR is considered stale */
+    staleDays?: number;
+    /** Only process candidates matching this status */
+    filterStatus?: GCArtifactStatus[];
+    /** Actually execute cleanup (default: false = dry run) */
+    execute?: boolean;
+    /** Purge (DELETE) old DB execution records instead of just marking them */
+    purgeDb?: boolean;
+    /** Log callback */
+    log?: (msg: string) => void;
+}
+interface WorktreeEntry {
+    worktreePath: string;
+    branch: string;
+    isPrunable: boolean;
+}
+/**
+ * Parse `git worktree list --porcelain` output into structured entries.
+ */
+export declare function parseWorktreeList(output: string): WorktreeEntry[];
+/**
+ * Extract agent name from a worktree path.
+ * Worktrees are at: {hqPath}/agents/{subdir}/{agentName}/{repoName}
+ */
+export declare function extractAgentName(worktreePath: string, hqPath: string): string | null;
+/**
+ * Determine the GC status for a worktree based on its PR state.
+ */
+export declare function classifyArtifact(pr: PRInfo | null, staleDays: number): GCArtifactStatus;
+/**
+ * Collect all GC candidates by scanning worktrees and checking PR status.
+ *
+ * Scans all repos in the HQ, finds worktrees inside the agents/ directory,
+ * checks PR status for each branch, and classifies them.
+ */
+export declare function collectGCCandidates(options: GCOptions): GCCandidate[];
+/**
+ * Delete a remote git branch. Non-fatal if branch doesn't exist on remote.
+ */
+export declare function deleteRemoteBranch(branch: string, cwd: string): boolean;
+/**
+ * Kill tmux sessions inside a Docker container.
+ * Non-fatal if tmux is not running or container is not accessible.
+ */
+export declare function killTmuxInContainer(containerId: string): boolean;
+/**
+ * Clean up Claude session data from a Docker container's claude-credentials volume.
+ * Only removes session-specific files, preserving auth credentials.
+ *
+ * Session files to clean: projects/, .claude-*, statsig/
+ * Files to preserve: .credentials.json, credentials.json, .oauthtoken, settings.json
+ */
+export declare function cleanClaudeSessionData(containerId: string): boolean;
+/**
+ * Mark execution records as GC-cleaned for the given agent names.
+ * Sets gc_cleaned_at timestamp on agent_work rows that are completed/failed.
+ */
+export declare function markExecutionRecordsCleaned(hqPath: string, agentNames: string[]): number;
+/**
+ * Purge (DELETE) execution records for the given agent names.
+ * Only deletes records that have already been marked as gc_cleaned.
+ */
+export declare function purgeExecutionRecords(hqPath: string, agentNames: string[]): number;
+/**
+ * Mark agent names as recyclable (status='cleaned') in the database.
+ * Preserves the record for history but allows name reuse.
+ */
+export declare function recycleAgentNames(hqPath: string, agentNames: string[]): string[];
+/**
+ * Execute garbage collection on the provided candidates.
+ *
+ * Processes candidates in order:
+ * 1. Close stale PRs
+ * 2. Kill tmux sessions in containers
+ * 3. Clean Claude session data in containers
+ * 4. Remove worktrees
+ * 5. Remove containers
+ * 6. Prune local branches
+ * 7. Delete remote branches
+ * 8. Clean up empty agent directories
+ * 9. Mark/purge DB execution records
+ * 10. Recycle agent names
+ */
+export declare function executeGC(candidates: GCCandidate[], options: GCOptions): GCResult;
+interface ScheduledCleanup {
+    branch: string;
+    scheduledAt: number;
+    graceUntil: number;
+}
+/**
+ * In-memory scheduler for daemon GC with grace periods.
+ * Tracks branches that need cleanup after their grace period expires.
+ */
+export declare class GCScheduler {
+    private pending;
+    private gracePeriodMs;
+    constructor(gracePeriodMs?: number);
+    /**
+     * Schedule a branch for GC after the grace period.
+     */
+    schedule(branch: string): void;
+    /**
+     * Get branches whose grace period has expired.
+     */
+    getReady(): string[];
+    /**
+     * Remove a branch from the schedule (after cleanup).
+     */
+    complete(branch: string): void;
+    /**
+     * Get all pending cleanups (for status/debugging).
+     */
+    getPending(): ScheduledCleanup[];
+    /**
+     * Number of pending cleanups.
+     */
+    get size(): number;
+}
+export {};