@promptwheel/cli 0.6.0

package/dist/lib/retention.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Retention & Cleanup
+ *
+ * Prune logic for all unbounded state accumulation points.
+ * Called automatically on session start and via `promptwheel prune`.
+ */
+import { type RetentionConfig, type SoloConfig } from './solo-config.js';
+import type { DatabaseAdapter } from '@promptwheel/core/db';
+export interface PruneReport {
+    runFoldersRemoved: number;
+    historyLinesRemoved: number;
+    artifactsRemoved: number;
+    spoolArchivesRemoved: number;
+    deferredProposalsRemoved: number;
+    completedTicketsRemoved: number;
+    mergedBranchesRemoved: number;
+    staleBranchesRemoved: number;
+    staleWorktreesRemoved: number;
+    logsRotated: number;
+    metricsLinesRemoved: number;
+    artifactsByAgeRemoved: number;
+    totalPruned: number;
+}
+export declare function getRetentionConfig(config: SoloConfig | null): RetentionConfig;
+/**
+ * Sort .promptwheel/runs/ by mtime, delete oldest beyond cap.
+ */
+export declare function pruneRunFolders(repoRoot: string, maxRuns: number, dryRun?: boolean): number;
+/**
+ * Keep last N lines in history.ndjson, rewrite file.
+ */
+export declare function pruneHistory(repoRoot: string, maxEntries: number, dryRun?: boolean): number;
+/**
+ * Within each run folder, keep newest N artifact files.
+ */
+export declare function pruneArtifacts(repoRoot: string, maxPerRun: number, dryRun?: boolean): number;
+/**
+ * Delete oldest *.archived.ndjson in spool/ beyond cap.
+ */
+export declare function pruneSpoolArchives(repoRoot: string, maxArchives: number, dryRun?: boolean): number;
+/**
+ * Trim oldest deferred proposals from run-state.json beyond cap.
+ */
+export declare function pruneDeferredProposals(repoRoot: string, maxDeferred: number, dryRun?: boolean): number;
+/**
+ * Hard-delete oldest completed tickets beyond cap.
+ * Uses the DatabaseAdapter interface (Postgres $1 placeholders).
+ */
+export declare function pruneCompletedTickets(adapter: DatabaseAdapter | null, maxCompleted: number, dryRun?: boolean): Promise<number>;
+/**
+ * Delete local promptwheel/* branches that are fully merged, keeping the
+ * newest N merged branches. Only touches local branches — never deletes
+ * remote branches, and never touches unmerged branches.
+ *
+ * NOT called during auto-prune-on-start — only via `promptwheel prune`.
+ */
+export declare function pruneMergedBranches(repoRoot: string, maxMergedBranches: number, dryRun?: boolean): number;
+/**
+ * Delete local promptwheel/tkt_* and promptwheel/milestone-* branches that are
+ * NOT merged and whose last commit is older than `maxDays` days. Never touches
+ * promptwheel-direct or user branches. Never deletes the current branch.
+ */
+export declare function pruneStaleBranches(repoRoot: string, maxDays: number, dryRun?: boolean): number;
+/**
+ * Remove orphaned worktrees that have no associated running process.
+ * Uses `git worktree list` to find stale entries and `git worktree remove --force`.
+ */
+export declare function pruneStaleWorktrees(repoRoot: string, dryRun?: boolean): number;
+/**
+ * Remove codex session rollout files from incompatible versions and old sessions.
+ *
+ * Codex stores per-thread rollout files in ~/.codex/sessions/YYYY/MM/DD/.
+ * After a codex upgrade, old-version rollout files cause "state db missing
+ * rollout path" errors on every invocation because the new version can't
+ * index the old format. This prunes:
+ *   1. Rollout files from a different major.minor codex version
+ *   2. Rollout files older than `maxDays` days
+ *   3. Abandoned rollout files — same version, recent, but the owning
+ *      process stopped writing (mtime > 5 min stale). These are left
+ *      behind when a codex process is killed mid-execution.
+ */
+export declare function pruneStaleCodexSessions(maxDays: number, dryRun?: boolean): number;
+/**
+ * Rotate tui.log when it exceeds maxBytes.
+ * Renames current to tui.log.1, starts fresh.
+ * Only keeps 1 backup — previous .1 is overwritten.
+ */
+export declare function rotateLogs(repoRoot: string, maxBytes: number, dryRun?: boolean): number;
+/**
+ * Keep last N lines in metrics.ndjson, rewrite file.
+ */
+export declare function pruneMetrics(repoRoot: string, maxEntries: number, dryRun?: boolean): number;
+/**
+ * Delete artifact files older than maxDays from .promptwheel/artifacts/.
+ * Walks all subdirectories (executions/, diffs/, runs/, violations/).
+ * Removes empty subdirectories afterward.
+ */
+export declare function pruneArtifactsByAge(repoRoot: string, maxDays: number, dryRun?: boolean): number;
+/**
+ * Run `git worktree prune` to clean dangling worktree refs that manual
+ * cleanup misses (e.g. worktree directories deleted without `git worktree remove`).
+ */
+export declare function gitWorktreePrune(repoRoot: string): void;
+/**
+ * Write a session lock file (.promptwheel/session.pid) with the current PID.
+ * Returns true if lock acquired, false if another live session holds it.
+ */
+export declare function acquireSessionLock(repoRoot: string): {
+    acquired: boolean;
+    stalePid?: number;
+};
+/**
+ * Release the session lock file on clean shutdown.
+ */
+export declare function releaseSessionLock(repoRoot: string): void;
+export declare function pruneAll(repoRoot: string, config: RetentionConfig, dryRun?: boolean): PruneReport;
+/**
+ * Full prune including async DB operations.
+ */
+export declare function pruneAllAsync(repoRoot: string, config: RetentionConfig, adapter?: DatabaseAdapter | null, dryRun?: boolean): Promise<PruneReport>;
+/**
+ * Format a prune report for display.
+ */
+export declare function formatPruneReport(report: PruneReport, dryRun?: boolean): string;
+//# sourceMappingURL=retention.d.ts.map

package/dist/lib/retention.d.ts.map

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