sessionlog 0.0.1

package/dist/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/utils/preview-rewind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-rewind.js","sourceRoot":"","sources":["../../src/utils/preview-rewind.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,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/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/utils/rewind-conflict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewind-conflict.d.ts","sourceRoot":"","sources":["../../src/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/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/utils/rewind-conflict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewind-conflict.js","sourceRoot":"","sources":["../../src/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,EAAE,CAAC,CAAC,CAAC,MAAM,4CAAoC,CAAC,CAAC;AAC5E,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/utils/shadow-branch.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 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
+ */
+/**
+ * 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: entire/<commit[:7]>-<hash(worktreeID)[:6]>
+ */
+export declare function shadowBranchNameForCommit(baseCommit: string, worktreeID?: string): 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): {
+    commitPrefix: string;
+    worktreeHash: string;
+} | null;
+/**
+ * Returns true if the branch name matches the shadow branch pattern.
+ * The "entire/checkpoints/v1" branch is NOT a shadow branch.
+ */
+export declare function isShadowBranch(branchName: string): boolean;
+/**
+ * List all shadow branches in the repository.
+ * Returns an empty array if no shadow branches exist.
+ */
+export declare function listShadowBranches(cwd?: string): 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/utils/shadow-branch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadow-branch.d.ts","sourceRoot":"","sources":["../../src/utils/shadow-branch.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAcH;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAMzD;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAOzF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,GACjB;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAgBvD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAG1D;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAGxE;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/utils/shadow-branch.js

@@ -0,0 +1,93 @@
+/**
+ * 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;
+/** Pattern for shadow branches: entire/<hex7+>(-<hex6+>)? */
+const SHADOW_BRANCH_PATTERN = new RegExp(`^${SHADOW_BRANCH_PREFIX.replace('/', '\\/')}[0-9a-f]{${SHADOW_BRANCH_HASH_LENGTH},}(-[0-9a-f]{${WORKTREE_ID_HASH_LENGTH},})?$`);
+/**
+ * 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: entire/<commit[:7]>-<hash(worktreeID)[:6]>
+ */
+export function shadowBranchNameForCommit(baseCommit, worktreeID) {
+    const commitPart = baseCommit.slice(0, SHADOW_BRANCH_HASH_LENGTH);
+    if (worktreeID) {
+        const worktreeHash = hashWorktreeID(worktreeID);
+        return `${SHADOW_BRANCH_PREFIX}${commitPart}-${worktreeHash}`;
+    }
+    return `${SHADOW_BRANCH_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) {
+    if (!branchName.startsWith(SHADOW_BRANCH_PREFIX))
+        return null;
+    if (branchName === CHECKPOINTS_BRANCH)
+        return null;
+    const suffix = branchName.slice(SHADOW_BRANCH_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 "entire/checkpoints/v1" branch is NOT a shadow branch.
+ */
+export function isShadowBranch(branchName) {
+    if (branchName === CHECKPOINTS_BRANCH)
+        return false;
+    return SHADOW_BRANCH_PATTERN.test(branchName);
+}
+/**
+ * List all shadow branches in the repository.
+ * Returns an empty array if no shadow branches exist.
+ */
+export async function listShadowBranches(cwd) {
+    const allBranches = await listBranches(cwd);
+    return allBranches.filter(isShadowBranch);
+}
+/**
+ * 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/utils/shadow-branch.js.map

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

package/dist/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/utils/string-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-utils.d.ts","sourceRoot":"","sources":["../../src/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/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/utils/string-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-utils.js","sourceRoot":"","sources":["../../src/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/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/utils/todo-extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo-extract.d.ts","sourceRoot":"","sources":["../../src/utils/todo-extract.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgBH;;;;;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,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,CAI1E;AAED;;GAEG;AACH,wBAAgB,qCAAqC,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,CAIhF;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"}

package/dist/utils/todo-extract.js

@@ -0,0 +1,167 @@
+/**
+ * Todo Extraction
+ *
+ * Parses TodoWrite tool_input JSON to extract todo content for
+ * incremental checkpoint commit messages.
+ *
+ * Ported from Go: strategy/messages.go
+ */
+// ============================================================================
+// Extraction Functions
+// ============================================================================
+/**
+ * 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 function extractLastCompletedTodo(todosJSON) {
+    const todos = parseTodos(todosJSON);
+    if (!todos)
+        return '';
+    let lastCompleted = '';
+    for (const todo of todos) {
+        if (todo.status === 'completed') {
+            lastCompleted = todo.content;
+        }
+    }
+    return lastCompleted;
+}
+/**
+ * Return the number of todo items in the JSON array.
+ * Returns 0 if the JSON is invalid or empty.
+ */
+export function countTodos(todosJSON) {
+    const todos = parseTodos(todosJSON);
+    return todos ? todos.length : 0;
+}
+/**
+ * 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 function extractInProgressTodo(todosJSON) {
+    const todos = parseTodos(todosJSON);
+    if (!todos || todos.length === 0)
+        return '';
+    // 1. in_progress item
+    for (const todo of todos) {
+        if (todo.status === 'in_progress') {
+            return todo.content;
+        }
+    }
+    // 2. first pending item
+    for (const todo of todos) {
+        if (todo.status === 'pending') {
+            return todo.content;
+        }
+    }
+    // 3. last completed item
+    let lastCompleted = '';
+    for (const todo of todos) {
+        if (todo.status === 'completed') {
+            lastCompleted = todo.content;
+        }
+    }
+    if (lastCompleted)
+        return lastCompleted;
+    // 4. first item with content (unknown status edge case)
+    if (todos[0].content)
+        return todos[0].content;
+    return '';
+}
+// ============================================================================
+// Tool Input Wrappers
+// ============================================================================
+/**
+ * Extract todo content from a TodoWrite tool_input object.
+ * Handles unwrapping the outer { todos: [...] } structure.
+ */
+export function extractTodoContentFromToolInput(toolInput) {
+    const todosJSON = extractTodosArrayJSON(toolInput);
+    if (!todosJSON)
+        return '';
+    return extractInProgressTodo(todosJSON);
+}
+/**
+ * Extract last completed todo from a TodoWrite tool_input object.
+ */
+export function extractLastCompletedTodoFromToolInput(toolInput) {
+    const todosJSON = extractTodosArrayJSON(toolInput);
+    if (!todosJSON)
+        return '';
+    return extractLastCompletedTodo(todosJSON);
+}
+/**
+ * Count todos from a TodoWrite tool_input object.
+ */
+export function countTodosFromToolInput(toolInput) {
+    const todosJSON = extractTodosArrayJSON(toolInput);
+    if (!todosJSON)
+        return 0;
+    return countTodos(todosJSON);
+}
+// ============================================================================
+// Formatting
+// ============================================================================
+/** Maximum length for descriptions in commit messages */
+const MAX_DESCRIPTION_LENGTH = 60;
+/**
+ * Format a commit message for an incremental checkpoint.
+ * Format: "<todo-content> (<tool-use-id>)"
+ * Fallback: "Checkpoint #<sequence>: <tool-use-id>"
+ */
+export function formatIncrementalMessage(todoContent, sequence, toolUseID) {
+    if (!todoContent) {
+        return `Checkpoint #${sequence}: ${toolUseID}`;
+    }
+    const truncated = truncateDescription(todoContent, MAX_DESCRIPTION_LENGTH);
+    return `${truncated} (${toolUseID})`;
+}
+// ============================================================================
+// Internal Helpers
+// ============================================================================
+function parseTodos(todosJSON) {
+    try {
+        const str = typeof todosJSON === 'string' ? todosJSON : todosJSON.toString('utf-8');
+        if (!str)
+            return null;
+        const parsed = JSON.parse(str);
+        if (!Array.isArray(parsed))
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+function extractTodosArrayJSON(toolInput) {
+    if (!toolInput || typeof toolInput !== 'object')
+        return null;
+    const input = toolInput;
+    const todos = input.todos;
+    if (!Array.isArray(todos))
+        return null;
+    try {
+        return JSON.stringify(todos);
+    }
+    catch {
+        return null;
+    }
+}
+function truncateDescription(s, maxLen) {
+    const runes = [...s];
+    if (runes.length <= maxLen)
+        return s;
+    const suffix = '...';
+    const suffixRunes = [...suffix];
+    const truncateAt = Math.max(0, maxLen - suffixRunes.length);
+    return runes.slice(0, truncateAt).join('') + suffix;
+}
+//# sourceMappingURL=todo-extract.js.map