opentasks 0.0.5 → 0.0.7

package/dist/sessionlog/utils/preview-rewind.js

@@ -0,0 +1,63 @@
+/**
+ * Rewind Preview
+ *
+ * Preview what files would change when rewinding to a checkpoint.
+ * Shows files that would be restored and untracked files that would be deleted.
+ *
+ * Ported from Go: strategy/manual_commit_rewind.go
+ */
+import { getHead, lsTree, getUntrackedFiles, } from '../git-operations.js';
+import { isInfrastructurePath } from './paths.js';
+/**
+ * Preview what will happen when rewinding to the given commit.
+ *
+ * Returns the list of files that would be restored from the checkpoint
+ * and untracked files that would be deleted.
+ *
+ * For logs-only rewind points, returns empty arrays since the working
+ * directory is not modified.
+ */
+export async function previewRewind(commitHash, isLogsOnly, preservedUntrackedFiles, cwd) {
+    // Logs-only points don't modify the working directory
+    if (isLogsOnly) {
+        return { filesToRestore: [], filesToDelete: [] };
+    }
+    // Get files in the checkpoint tree (excluding infrastructure)
+    const checkpointEntries = await lsTree(commitHash, undefined, cwd);
+    const checkpointFiles = new Set();
+    const filesToRestore = [];
+    for (const entry of checkpointEntries) {
+        if (!isInfrastructurePath(entry.name)) {
+            checkpointFiles.add(entry.name);
+            filesToRestore.push(entry.name);
+        }
+    }
+    // Get HEAD tree to identify tracked files
+    const headHash = await getHead(cwd);
+    const headEntries = await lsTree(headHash, undefined, cwd);
+    const trackedFiles = new Set();
+    for (const entry of headEntries) {
+        trackedFiles.add(entry.name);
+    }
+    // Build set of preserved untracked files
+    const preserved = new Set(preservedUntrackedFiles ?? []);
+    // Find untracked files that would be deleted
+    const untrackedNow = await getUntrackedFiles(cwd);
+    const filesToDelete = [];
+    for (const relPath of untrackedNow) {
+        // Skip if file exists in the checkpoint
+        if (checkpointFiles.has(relPath))
+            continue;
+        // Skip if file is tracked in HEAD
+        if (trackedFiles.has(relPath))
+            continue;
+        // Skip if file was preserved from session start
+        if (preserved.has(relPath))
+            continue;
+        filesToDelete.push(relPath);
+    }
+    filesToRestore.sort();
+    filesToDelete.sort();
+    return { filesToRestore, filesToDelete };
+}
+//# sourceMappingURL=preview-rewind.js.map

package/dist/sessionlog/utils/preview-rewind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-rewind.js","sourceRoot":"","sources":["../../../src/sessionlog/utils/preview-rewind.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAGL,OAAO,EACP,MAAM,EACN,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAOlD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,UAAkB,EAClB,UAAmB,EACnB,uBAAkC,EAClC,GAAY;IAEZ,sDAAsD;IACtD,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,EAAE,cAAc,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;IACnD,CAAC;IAED,8DAA8D;IAC9D,MAAM,iBAAiB,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;IACnE,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;IAC1C,MAAM,cAAc,GAAa,EAAE,CAAC;IAEpC,KAAK,MAAM,KAAK,IAAI,iBAAiB,EAAE,CAAC;QACtC,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAChC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED,0CAA0C;IAC1C,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;IAC3D,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IACvC,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;QAChC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,yCAAyC;IACzC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;IAEzD,6CAA6C;IAC7C,MAAM,YAAY,GAAG,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,aAAa,GAAa,EAAE,CAAC;IAEnC,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;QACnC,wCAAwC;QACxC,IAAI,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,SAAS;QAC3C,kCAAkC;QAClC,IAAI,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,SAAS;QACxC,gDAAgD;QAChD,IAAI,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,SAAS;QAErC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,cAAc,CAAC,IAAI,EAAE,CAAC;IACtB,aAAa,CAAC,IAAI,EAAE,CAAC;IAErB,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC;AAC3C,CAAC"}

package/dist/sessionlog/utils/rewind-conflict.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Rewind Conflict Detection
+ *
+ * Utilities for detecting timestamp conflicts when restoring session logs
+ * from checkpoints. Prevents silent overwrites of newer local transcripts.
+ *
+ * Ported from Go: strategy/manual_commit_rewind.go
+ */
+export declare const enum SessionRestoreStatus {
+    /** Local file doesn't exist */
+    New = 0,
+    /** Local and checkpoint are the same */
+    Unchanged = 1,
+    /** Checkpoint has newer entries */
+    CheckpointNewer = 2,
+    /** Local has newer entries (conflict) */
+    LocalNewer = 3
+}
+export interface SessionRestoreInfo {
+    sessionID: string;
+    prompt: string;
+    status: SessionRestoreStatus;
+    localTime: Date;
+    checkpointTime: Date;
+}
+/**
+ * Determine the restore status based on local and checkpoint timestamps.
+ */
+export declare function classifyTimestamps(localTime: Date | null, checkpointTime: Date | null): SessionRestoreStatus;
+/**
+ * Returns a human-readable status string.
+ */
+export declare function statusToText(status: SessionRestoreStatus): string;
+/**
+ * Check if any sessions have conflicts (local is newer than checkpoint).
+ */
+export declare function hasConflicts(sessions: SessionRestoreInfo[]): boolean;
+/**
+ * Separate sessions into conflicting and non-conflicting lists.
+ */
+export declare function partitionConflicts(sessions: SessionRestoreInfo[]): {
+    conflicting: SessionRestoreInfo[];
+    nonConflicting: SessionRestoreInfo[];
+};
+import type { Agent } from '../agent/types.js';
+import type { AgentType } from '../types.js';
+/**
+ * Resolve the agent from checkpoint metadata agent type string.
+ * Returns null if the agent type is not registered.
+ */
+export declare function resolveAgentForRewind(agentType: AgentType): Agent | null;
+//# sourceMappingURL=rewind-conflict.d.ts.map

package/dist/sessionlog/utils/rewind-conflict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewind-conflict.d.ts","sourceRoot":"","sources":["../../../src/sessionlog/utils/rewind-conflict.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,0BAAkB,oBAAoB;IACpC,+BAA+B;IAC/B,GAAG,IAAI;IACP,wCAAwC;IACxC,SAAS,IAAI;IACb,mCAAmC;IACnC,eAAe,IAAI;IACnB,yCAAyC;IACzC,UAAU,IAAI;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,oBAAoB,CAAC;IAC7B,SAAS,EAAE,IAAI,CAAC;IAChB,cAAc,EAAE,IAAI,CAAC;CACtB;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,IAAI,GAAG,IAAI,EACtB,cAAc,EAAE,IAAI,GAAG,IAAI,GAC1B,oBAAoB,CAkBtB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAajE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAEpE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,GAAG;IAClE,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,cAAc,EAAE,kBAAkB,EAAE,CAAC;CACtC,CAWA;AAMD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,GAAG,KAAK,GAAG,IAAI,CAExE"}

package/dist/sessionlog/utils/rewind-conflict.js

@@ -0,0 +1,79 @@
+/**
+ * Rewind Conflict Detection
+ *
+ * Utilities for detecting timestamp conflicts when restoring session logs
+ * from checkpoints. Prevents silent overwrites of newer local transcripts.
+ *
+ * Ported from Go: strategy/manual_commit_rewind.go
+ */
+// ============================================================================
+// Classification
+// ============================================================================
+/**
+ * Determine the restore status based on local and checkpoint timestamps.
+ */
+export function classifyTimestamps(localTime, checkpointTime) {
+    // Local file doesn't exist
+    if (!localTime || localTime.getTime() === 0) {
+        return 0 /* SessionRestoreStatus.New */;
+    }
+    // Can't determine checkpoint time
+    if (!checkpointTime || checkpointTime.getTime() === 0) {
+        return 0 /* SessionRestoreStatus.New */;
+    }
+    if (localTime.getTime() > checkpointTime.getTime()) {
+        return 3 /* SessionRestoreStatus.LocalNewer */;
+    }
+    if (checkpointTime.getTime() > localTime.getTime()) {
+        return 2 /* SessionRestoreStatus.CheckpointNewer */;
+    }
+    return 1 /* SessionRestoreStatus.Unchanged */;
+}
+/**
+ * Returns a human-readable status string.
+ */
+export function statusToText(status) {
+    switch (status) {
+        case 0 /* SessionRestoreStatus.New */:
+            return '(new)';
+        case 1 /* SessionRestoreStatus.Unchanged */:
+            return '(unchanged)';
+        case 2 /* SessionRestoreStatus.CheckpointNewer */:
+            return '(checkpoint is newer)';
+        case 3 /* SessionRestoreStatus.LocalNewer */:
+            return '(local is newer)';
+        default:
+            return '';
+    }
+}
+/**
+ * Check if any sessions have conflicts (local is newer than checkpoint).
+ */
+export function hasConflicts(sessions) {
+    return sessions.some(s => s.status === 3 /* SessionRestoreStatus.LocalNewer */);
+}
+/**
+ * Separate sessions into conflicting and non-conflicting lists.
+ */
+export function partitionConflicts(sessions) {
+    const conflicting = [];
+    const nonConflicting = [];
+    for (const s of sessions) {
+        if (s.status === 3 /* SessionRestoreStatus.LocalNewer */) {
+            conflicting.push(s);
+        }
+        else {
+            nonConflicting.push(s);
+        }
+    }
+    return { conflicting, nonConflicting };
+}
+import { getAgentByType } from '../agent/registry.js';
+/**
+ * Resolve the agent from checkpoint metadata agent type string.
+ * Returns null if the agent type is not registered.
+ */
+export function resolveAgentForRewind(agentType) {
+    return getAgentByType(agentType);
+}
+//# sourceMappingURL=rewind-conflict.js.map

package/dist/sessionlog/utils/rewind-conflict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewind-conflict.js","sourceRoot":"","sources":["../../../src/sessionlog/utils/rewind-conflict.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAyBH,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,SAAsB,EACtB,cAA2B;IAE3B,2BAA2B;IAC3B,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC;QAC5C,wCAAgC;IAClC,CAAC;IAED,kCAAkC;IAClC,IAAI,CAAC,cAAc,IAAI,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC;QACtD,wCAAgC;IAClC,CAAC;IAED,IAAI,SAAS,CAAC,OAAO,EAAE,GAAG,cAAc,CAAC,OAAO,EAAE,EAAE,CAAC;QACnD,+CAAuC;IACzC,CAAC;IACD,IAAI,cAAc,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;QACnD,oDAA4C;IAC9C,CAAC;IACD,8CAAsC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAA4B;IACvD,QAAQ,MAAM,EAAE,CAAC;QACf;YACE,OAAO,OAAO,CAAC;QACjB;YACE,OAAO,aAAa,CAAC;QACvB;YACE,OAAO,uBAAuB,CAAC;QACjC;YACE,OAAO,kBAAkB,CAAC;QAC5B;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,QAA8B;IACzD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,4CAAoC,CAAC,CAAC;AAC1E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAA8B;IAI/D,MAAM,WAAW,GAAyB,EAAE,CAAC;IAC7C,MAAM,cAAc,GAAyB,EAAE,CAAC;IAChD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC,CAAC,MAAM,4CAAoC,EAAE,CAAC;YACjD,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC;AACzC,CAAC;AAOD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAoB;IACxD,OAAO,cAAc,CAAC,SAAS,CAAC,CAAC;AACnC,CAAC"}

package/dist/sessionlog/utils/shadow-branch.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Shadow Branch Utilities
+ *
+ * Standalone utilities for shadow branch name generation, parsing,
+ * and classification. Extracted from checkpoint-store.ts for reuse.
+ *
+ * Ported from Go: checkpoint/temporary.go, strategy/cleanup.go
+ */
+/**
+ * Options for overriding default branch naming.
+ */
+export interface ShadowBranchOptions {
+    /** Prefix for shadow branches (default: SHADOW_BRANCH_PREFIX from types) */
+    shadowBranchPrefix?: string;
+    /** Git branch for committed checkpoints (default: CHECKPOINTS_BRANCH from types) */
+    checkpointsBranch?: string;
+}
+/**
+ * Hash a worktree identifier to a short hex string.
+ */
+export declare function hashWorktreeID(worktreeID: string): string;
+/**
+ * Returns the shadow branch name for a base commit hash and worktree identifier.
+ * Format: <prefix><commit[:7]>-<hash(worktreeID)[:6]>
+ */
+export declare function shadowBranchNameForCommit(baseCommit: string, worktreeID?: string, options?: ShadowBranchOptions): string;
+/**
+ * Parse a shadow branch name to extract commit prefix and worktree hash.
+ * Returns null if the branch name doesn't match the shadow branch pattern.
+ */
+export declare function parseShadowBranchName(branchName: string, options?: ShadowBranchOptions): {
+    commitPrefix: string;
+    worktreeHash: string;
+} | null;
+/**
+ * Returns true if the branch name matches the shadow branch pattern.
+ * The checkpoints branch is NOT a shadow branch.
+ */
+export declare function isShadowBranch(branchName: string, options?: ShadowBranchOptions): boolean;
+/**
+ * List all shadow branches in the repository.
+ * Returns an empty array if no shadow branches exist.
+ */
+export declare function listShadowBranches(cwd?: string, options?: ShadowBranchOptions): Promise<string[]>;
+/**
+ * Delete the specified shadow branches from the repository.
+ * Returns two arrays: successfully deleted and failed to delete.
+ */
+export declare function deleteShadowBranches(branches: string[], cwd?: string): Promise<{
+    deleted: string[];
+    failed: string[];
+}>;
+//# sourceMappingURL=shadow-branch.d.ts.map

package/dist/sessionlog/utils/shadow-branch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadow-branch.d.ts","sourceRoot":"","sources":["../../../src/sessionlog/utils/shadow-branch.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAaH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,4EAA4E;IAC5E,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oFAAoF;IACpF,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAMzD;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,MAAM,CAQR;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,mBAAmB,GAC5B;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAmBvD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CASzF;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAGvG;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAAE,EAClB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAclD"}

package/dist/sessionlog/utils/shadow-branch.js

@@ -0,0 +1,97 @@
+/**
+ * Shadow Branch Utilities
+ *
+ * Standalone utilities for shadow branch name generation, parsing,
+ * and classification. Extracted from checkpoint-store.ts for reuse.
+ *
+ * Ported from Go: checkpoint/temporary.go, strategy/cleanup.go
+ */
+import * as crypto from 'node:crypto';
+import { SHADOW_BRANCH_PREFIX, SHADOW_BRANCH_HASH_LENGTH, CHECKPOINTS_BRANCH, } from '../types.js';
+import { listBranches, deleteBranch } from '../git-operations.js';
+/** Worktree ID hash length (6 hex characters) */
+const WORKTREE_ID_HASH_LENGTH = 6;
+/**
+ * Hash a worktree identifier to a short hex string.
+ */
+export function hashWorktreeID(worktreeID) {
+    return crypto
+        .createHash('sha256')
+        .update(worktreeID)
+        .digest('hex')
+        .slice(0, WORKTREE_ID_HASH_LENGTH);
+}
+/**
+ * Returns the shadow branch name for a base commit hash and worktree identifier.
+ * Format: <prefix><commit[:7]>-<hash(worktreeID)[:6]>
+ */
+export function shadowBranchNameForCommit(baseCommit, worktreeID, options) {
+    const prefix = options?.shadowBranchPrefix ?? SHADOW_BRANCH_PREFIX;
+    const commitPart = baseCommit.slice(0, SHADOW_BRANCH_HASH_LENGTH);
+    if (worktreeID) {
+        const worktreeHash = hashWorktreeID(worktreeID);
+        return `${prefix}${commitPart}-${worktreeHash}`;
+    }
+    return `${prefix}${commitPart}`;
+}
+/**
+ * Parse a shadow branch name to extract commit prefix and worktree hash.
+ * Returns null if the branch name doesn't match the shadow branch pattern.
+ */
+export function parseShadowBranchName(branchName, options) {
+    const prefix = options?.shadowBranchPrefix ?? SHADOW_BRANCH_PREFIX;
+    const checkpointsBranch = options?.checkpointsBranch ?? CHECKPOINTS_BRANCH;
+    if (!branchName.startsWith(prefix))
+        return null;
+    if (branchName === checkpointsBranch)
+        return null;
+    const suffix = branchName.slice(prefix.length);
+    const lastDash = suffix.lastIndexOf('-');
+    if (lastDash === -1 || lastDash === 0 || lastDash === suffix.length - 1) {
+        // No dash or dash at boundary — old format with just commit prefix
+        return { commitPrefix: suffix, worktreeHash: '' };
+    }
+    return {
+        commitPrefix: suffix.slice(0, lastDash),
+        worktreeHash: suffix.slice(lastDash + 1),
+    };
+}
+/**
+ * Returns true if the branch name matches the shadow branch pattern.
+ * The checkpoints branch is NOT a shadow branch.
+ */
+export function isShadowBranch(branchName, options) {
+    const prefix = options?.shadowBranchPrefix ?? SHADOW_BRANCH_PREFIX;
+    const checkpointsBranch = options?.checkpointsBranch ?? CHECKPOINTS_BRANCH;
+    if (branchName === checkpointsBranch)
+        return false;
+    const pattern = new RegExp(`^${prefix.replace('/', '\\/')}[0-9a-f]{${SHADOW_BRANCH_HASH_LENGTH},}(-[0-9a-f]{${WORKTREE_ID_HASH_LENGTH},})?$`);
+    return pattern.test(branchName);
+}
+/**
+ * List all shadow branches in the repository.
+ * Returns an empty array if no shadow branches exist.
+ */
+export async function listShadowBranches(cwd, options) {
+    const allBranches = await listBranches(cwd);
+    return allBranches.filter((b) => isShadowBranch(b, options));
+}
+/**
+ * Delete the specified shadow branches from the repository.
+ * Returns two arrays: successfully deleted and failed to delete.
+ */
+export async function deleteShadowBranches(branches, cwd) {
+    const deleted = [];
+    const failed = [];
+    for (const branch of branches) {
+        try {
+            await deleteBranch(branch, false, cwd);
+            deleted.push(branch);
+        }
+        catch {
+            failed.push(branch);
+        }
+    }
+    return { deleted, failed };
+}
+//# sourceMappingURL=shadow-branch.js.map

package/dist/sessionlog/utils/shadow-branch.js.map

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

package/dist/sessionlog/utils/string-utils.d.ts

@@ -0,0 +1,24 @@
+/**
+ * String Utilities
+ *
+ * Rune-safe string operations for multi-byte character handling.
+ */
+/**
+ * Truncate a string to a maximum number of Unicode code points (runes).
+ * Avoids splitting multi-byte UTF-8 characters.
+ */
+export declare function truncateRunes(s: string, maxRunes: number, suffix?: string): string;
+/**
+ * Collapse all whitespace sequences (including newlines) to single spaces.
+ */
+export declare function collapseWhitespace(s: string): string;
+/**
+ * Capitalize the first character of a string.
+ */
+export declare function capitalizeFirst(s: string): string;
+/**
+ * Count lines in a string.
+ * Empty string = 0 lines. String without newline = 1 line.
+ */
+export declare function countLines(content: string): number;
+//# sourceMappingURL=string-utils.d.ts.map

package/dist/sessionlog/utils/string-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-utils.d.ts","sourceRoot":"","sources":["../../../src/sessionlog/utils/string-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,MAAc,GAAG,MAAM,CAMzF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQlD"}

package/dist/sessionlog/utils/string-utils.js

@@ -0,0 +1,47 @@
+/**
+ * String Utilities
+ *
+ * Rune-safe string operations for multi-byte character handling.
+ */
+/**
+ * Truncate a string to a maximum number of Unicode code points (runes).
+ * Avoids splitting multi-byte UTF-8 characters.
+ */
+export function truncateRunes(s, maxRunes, suffix = '...') {
+    const runes = [...s];
+    if (runes.length <= maxRunes) {
+        return s;
+    }
+    return runes.slice(0, maxRunes).join('') + suffix;
+}
+/**
+ * Collapse all whitespace sequences (including newlines) to single spaces.
+ */
+export function collapseWhitespace(s) {
+    return s.replace(/\s+/g, ' ').trim();
+}
+/**
+ * Capitalize the first character of a string.
+ */
+export function capitalizeFirst(s) {
+    if (s.length === 0)
+        return s;
+    return s[0].toUpperCase() + s.slice(1);
+}
+/**
+ * Count lines in a string.
+ * Empty string = 0 lines. String without newline = 1 line.
+ */
+export function countLines(content) {
+    if (content === '')
+        return 0;
+    let lines = 0;
+    for (let i = 0; i < content.length; i++) {
+        if (content[i] === '\n')
+            lines++;
+    }
+    if (!content.endsWith('\n'))
+        lines++;
+    return lines;
+}
+//# sourceMappingURL=string-utils.js.map

package/dist/sessionlog/utils/string-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-utils.js","sourceRoot":"","sources":["../../../src/sessionlog/utils/string-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,CAAS,EAAE,QAAgB,EAAE,SAAiB,KAAK;IAC/E,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC7B,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,CAAS;IAC1C,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,CAAS;IACvC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC7B,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,CAAC,CAAC;IAC7B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI;YAAE,KAAK,EAAE,CAAC;IACnC,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,KAAK,EAAE,CAAC;IACrC,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/sessionlog/utils/todo-extract.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Todo Extraction
+ *
+ * Parses TodoWrite tool_input JSON to extract todo content for
+ * incremental checkpoint commit messages.
+ *
+ * Ported from Go: strategy/messages.go
+ */
+/**
+ * Extract the content of the last completed todo item from a todos JSON array.
+ * Returns the work that was just finished (used for commit messages).
+ *
+ * Returns empty string if no completed items exist or JSON is invalid.
+ */
+export declare function extractLastCompletedTodo(todosJSON: string | Buffer): string;
+/**
+ * Return the number of todo items in the JSON array.
+ * Returns 0 if the JSON is invalid or empty.
+ */
+export declare function countTodos(todosJSON: string | Buffer): number;
+/**
+ * Extract the content of the in-progress todo item from tool_input.
+ * Used for commit messages in incremental checkpoints.
+ *
+ * Priority order:
+ *  1. in_progress item (current work)
+ *  2. first pending item (next work - fallback)
+ *  3. last completed item (work just finished)
+ *  4. first item with unknown status (edge case)
+ *  5. empty string (no items)
+ */
+export declare function extractInProgressTodo(todosJSON: string | Buffer): string;
+/**
+ * Extract todo content from a TodoWrite tool_input object.
+ * Handles unwrapping the outer { todos: [...] } structure.
+ */
+export declare function extractTodoContentFromToolInput(toolInput: unknown): string;
+/**
+ * Extract last completed todo from a TodoWrite tool_input object.
+ */
+export declare function extractLastCompletedTodoFromToolInput(toolInput: unknown): string;
+/**
+ * Count todos from a TodoWrite tool_input object.
+ */
+export declare function countTodosFromToolInput(toolInput: unknown): number;
+/**
+ * Format a commit message for an incremental checkpoint.
+ * Format: "<todo-content> (<tool-use-id>)"
+ * Fallback: "Checkpoint #<sequence>: <tool-use-id>"
+ */
+export declare function formatIncrementalMessage(todoContent: string, sequence: number, toolUseID: string): string;
+//# sourceMappingURL=todo-extract.d.ts.map

package/dist/sessionlog/utils/todo-extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo-extract.d.ts","sourceRoot":"","sources":["../../../src/sessionlog/utils/todo-extract.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiBH;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAW3E;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAG7D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CA+BxE;AAMD;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,OAAO,GACjB,MAAM,CAIR;AAED;;GAEG;AACH,wBAAgB,qCAAqC,CACnD,SAAS,EAAE,OAAO,GACjB,MAAM,CAIR;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,CAIlE;AASD;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,MAAM,CAOR"}