opentasks 0.0.5 → 0.0.7

package/dist/sessionlog/commands/enable.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Enable Command
+ *
+ * Enables Entire in a repository: creates settings, installs hooks,
+ * auto-detects agents.
+ */
+import { type AgentName } from '../types.js';
+export interface EnableOptions {
+    /** Working directory */
+    cwd?: string;
+    /** Specific agent to enable (auto-detect if not specified) */
+    agent?: AgentName;
+    /** Force reinstall hooks even if already present */
+    force?: boolean;
+    /** Save to local settings instead of project settings */
+    local?: boolean;
+    /** Session directory name under .git/ (default: SESSION_DIR_NAME) */
+    sessionDirName?: string;
+}
+export interface EnableResult {
+    enabled: boolean;
+    agent: AgentName | null;
+    agentHooksInstalled: number;
+    gitHooksInstalled: number;
+    errors: string[];
+}
+/**
+ * Enable Entire in a repository
+ */
+export declare function enable(options?: EnableOptions): Promise<EnableResult>;
+//# sourceMappingURL=enable.d.ts.map

package/dist/sessionlog/commands/enable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enable.d.ts","sourceRoot":"","sources":["../../../src/sessionlog/commands/enable.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAEL,KAAK,SAAS,EAKf,MAAM,aAAa,CAAC;AAWrB,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,8DAA8D;IAC9D,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB,oDAAoD;IACpD,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,yDAAyD;IACzD,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,qEAAqE;IACrE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAMD;;GAEG;AACH,wBAAsB,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAuE/E"}

package/dist/sessionlog/commands/enable.js

@@ -0,0 +1,102 @@
+/**
+ * Enable Command
+ *
+ * Enables Entire in a repository: creates settings, installs hooks,
+ * auto-detects agents.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { ENTIRE_DIR, ENTIRE_METADATA_DIR, ENTIRE_TMP_DIR, SESSION_DIR_NAME, } from '../types.js';
+import { isGitRepository, getWorktreeRoot, getGitDir, getHead } from '../git-operations.js';
+import { saveProjectSettings, saveLocalSettings, ensureGitignore } from '../config.js';
+import { installGitHooks } from '../hooks/git-hooks.js';
+import { detectAgent, getAgent, listAgentNames } from '../agent/registry.js';
+import { hasHookSupport } from '../agent/types.js';
+// ============================================================================
+// Implementation
+// ============================================================================
+/**
+ * Enable Entire in a repository
+ */
+export async function enable(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const errors = [];
+    // Validate git repository
+    if (!(await isGitRepository(cwd))) {
+        return { enabled: false, agent: null, agentHooksInstalled: 0, gitHooksInstalled: 0, errors: ['Not a git repository'] };
+    }
+    // Validate repository has at least one commit
+    try {
+        await getHead(cwd);
+    }
+    catch {
+        return { enabled: false, agent: null, agentHooksInstalled: 0, gitHooksInstalled: 0, errors: ['Repository has no commits'] };
+    }
+    const root = await getWorktreeRoot(cwd);
+    // Detect or resolve agent
+    let agent = options.agent ? getAgent(options.agent) : await detectAgent(cwd);
+    if (!agent) {
+        errors.push(`No agent detected. Available agents: ${listAgentNames().join(', ')}. ` +
+            `Install an agent or specify one with --agent.`);
+    }
+    // Create directories
+    await createDirectories(root, cwd, options.sessionDirName);
+    // Save settings
+    const settings = {
+        enabled: true,
+        strategy: 'manual-commit',
+    };
+    if (options.local) {
+        await saveLocalSettings(settings, cwd);
+    }
+    else {
+        await saveProjectSettings(settings, cwd);
+    }
+    // Set up .gitignore for local files
+    await ensureGitignore(cwd);
+    // Install git hooks
+    let gitHooksInstalled = 0;
+    try {
+        gitHooksInstalled = await installGitHooks(root);
+    }
+    catch (e) {
+        errors.push(`Failed to install git hooks: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    // Install agent hooks
+    let agentHooksInstalled = 0;
+    if (agent && hasHookSupport(agent)) {
+        try {
+            agentHooksInstalled = await agent.installHooks(root, options.force);
+        }
+        catch (e) {
+            errors.push(`Failed to install agent hooks: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    return {
+        enabled: true,
+        agent: agent?.name ?? null,
+        agentHooksInstalled,
+        gitHooksInstalled,
+        errors,
+    };
+}
+async function createDirectories(root, cwd, sessionDirName) {
+    const dirs = [
+        path.join(root, ENTIRE_DIR),
+        path.join(root, ENTIRE_METADATA_DIR),
+        path.join(root, ENTIRE_TMP_DIR),
+    ];
+    // Also create .git/<sessionDirName>/
+    try {
+        const gitDir = await getGitDir(cwd);
+        const sessionsDir = path.resolve(root, gitDir, sessionDirName ?? SESSION_DIR_NAME);
+        dirs.push(sessionsDir);
+    }
+    catch {
+        // Ignore if git dir resolution fails
+    }
+    for (const dir of dirs) {
+        await fs.promises.mkdir(dir, { recursive: true });
+    }
+}
+//# sourceMappingURL=enable.js.map

package/dist/sessionlog/commands/enable.js.map

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

package/dist/sessionlog/commands/explain.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Explain Command
+ *
+ * Provides human-readable context about sessions, commits, and checkpoints.
+ * This is the library implementation - consumers (CLI, IDE plugins) handle
+ * their own output formatting and pager support.
+ */
+import type { CheckpointID, Summary, AgentType, TokenUsage } from '../types.js';
+export interface CheckpointDetail {
+    checkpointID: CheckpointID;
+    sessionID: string;
+    agent?: AgentType;
+    strategy: string;
+    createdAt: string;
+    branch?: string;
+    checkpointsCount: number;
+    filesTouched: string[];
+    tokenUsage?: TokenUsage;
+    summary?: Summary;
+    isTaskCheckpoint?: boolean;
+    turnID?: string;
+    transcriptIdentifierAtStart?: string;
+    checkpointTranscriptStart: number;
+}
+export interface CheckpointListItem {
+    checkpointID: CheckpointID;
+    sessionID: string;
+    message: string;
+    date: string;
+    isTaskCheckpoint: boolean;
+    agent?: AgentType;
+    sessionCount: number;
+    sessionIDs: string[];
+}
+export interface ExplainOptions {
+    cwd?: string;
+    sessionFilter?: string;
+    maxDepth?: number;
+    searchAll?: boolean;
+    checkpointsBranch?: string;
+}
+export interface CommitExplainResult {
+    commitSHA: string;
+    commitMessage: string;
+    checkpointID: CheckpointID | null;
+    detail: CheckpointDetail | null;
+}
+/**
+ * List checkpoints on the current branch.
+ * Optionally filtered by session ID prefix.
+ */
+export declare function listCheckpoints(options?: ExplainOptions): Promise<CheckpointListItem[]>;
+/**
+ * Get detailed information about a specific checkpoint.
+ */
+export declare function getCheckpointDetail(checkpointID: CheckpointID, options?: ExplainOptions): Promise<CheckpointDetail | null>;
+/**
+ * Get the transcript content for a checkpoint.
+ */
+export declare function getCheckpointTranscript(checkpointID: CheckpointID, options?: ExplainOptions): Promise<Buffer | null>;
+/**
+ * Explain a specific commit by finding its associated checkpoint.
+ */
+export declare function explainCommit(commitRef: string, options?: ExplainOptions): Promise<CommitExplainResult | null>;
+/**
+ * Find a checkpoint by ID prefix (partial match).
+ */
+export declare function findCheckpointByPrefix(prefix: string, options?: ExplainOptions): Promise<CheckpointID | null>;
+//# sourceMappingURL=explain.d.ts.map

package/dist/sessionlog/commands/explain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../../src/sessionlog/commands/explain.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,YAAY,EAEZ,OAAO,EACP,SAAS,EACT,UAAU,EACX,MAAM,aAAa,CAAC;AASrB,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,yBAAyB,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,YAAY,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACjC;AAMD;;;GAGG;AACH,wBAAsB,eAAe,CACnC,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAmE/B;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,YAAY,EAC1B,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CA8BlC;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,YAAY,EAAE,YAAY,EAC1B,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWxB;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAgCrC;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CA2B9B"}

package/dist/sessionlog/commands/explain.js

@@ -0,0 +1,185 @@
+/**
+ * Explain Command
+ *
+ * Provides human-readable context about sessions, commits, and checkpoints.
+ * This is the library implementation - consumers (CLI, IDE plugins) handle
+ * their own output formatting and pager support.
+ */
+import { CHECKPOINTS_BRANCH, checkpointIDPath } from '../types.js';
+import { git, catFile, lsTree } from '../git-operations.js';
+import { parseCheckpoint, parseAllSessions } from '../utils/trailers.js';
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * List checkpoints on the current branch.
+ * Optionally filtered by session ID prefix.
+ */
+export async function listCheckpoints(options = {}) {
+    const cwd = options.cwd;
+    const maxDepth = options.searchAll ? 0 : (options.maxDepth ?? 500);
+    // Get commits on the current branch
+    const logArgs = ['log', '--format=%H %s'];
+    if (maxDepth > 0)
+        logArgs.push(`-n`, `${maxDepth}`);
+    let logOutput;
+    try {
+        logOutput = await git(logArgs, { cwd });
+    }
+    catch {
+        return [];
+    }
+    const items = [];
+    for (const line of logOutput.split('\n')) {
+        if (!line.trim())
+            continue;
+        const spaceIdx = line.indexOf(' ');
+        if (spaceIdx === -1)
+            continue;
+        const sha = line.slice(0, spaceIdx);
+        const message = line.slice(spaceIdx + 1);
+        // Get full commit message to check for trailers
+        let fullMessage;
+        try {
+            fullMessage = await git(['log', '-1', '--format=%B', sha], { cwd });
+        }
+        catch {
+            continue;
+        }
+        const [cpID, hasCp] = parseCheckpoint(fullMessage);
+        if (!hasCp || !cpID)
+            continue;
+        const sessionIDs = parseAllSessions(fullMessage);
+        // Apply session filter
+        if (options.sessionFilter) {
+            const hasMatch = sessionIDs.some((sid) => sid.startsWith(options.sessionFilter));
+            if (!hasMatch)
+                continue;
+        }
+        // Get commit date
+        let date;
+        try {
+            date = (await git(['log', '-1', '--format=%aI', sha], { cwd })).trim();
+        }
+        catch {
+            date = '';
+        }
+        items.push({
+            checkpointID: cpID,
+            sessionID: sessionIDs[0] ?? '',
+            message: message.trim(),
+            date,
+            isTaskCheckpoint: message.includes('[task]'),
+            sessionCount: sessionIDs.length,
+            sessionIDs,
+        });
+    }
+    return items;
+}
+/**
+ * Get detailed information about a specific checkpoint.
+ */
+export async function getCheckpointDetail(checkpointID, options = {}) {
+    const cwd = options.cwd;
+    const branch = options.checkpointsBranch ?? CHECKPOINTS_BRANCH;
+    // Try to read committed metadata from the checkpoints branch
+    const metadataPath = `${checkpointIDPath(checkpointID)}/metadata.json`;
+    try {
+        const content = await catFile(`${branch}:${metadataPath}`, cwd);
+        const metadata = JSON.parse(content);
+        return {
+            checkpointID: metadata.checkpointID,
+            sessionID: metadata.sessionID,
+            agent: metadata.agent,
+            strategy: metadata.strategy,
+            createdAt: metadata.createdAt,
+            branch: metadata.branch,
+            checkpointsCount: metadata.checkpointsCount,
+            filesTouched: metadata.filesTouched,
+            tokenUsage: metadata.tokenUsage,
+            summary: metadata.summary,
+            isTaskCheckpoint: metadata.isTask,
+            turnID: metadata.turnID,
+            transcriptIdentifierAtStart: metadata.transcriptIdentifierAtStart,
+            checkpointTranscriptStart: metadata.checkpointTranscriptStart,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get the transcript content for a checkpoint.
+ */
+export async function getCheckpointTranscript(checkpointID, options = {}) {
+    const cwd = options.cwd;
+    const branch = options.checkpointsBranch ?? CHECKPOINTS_BRANCH;
+    const transcriptPath = `${checkpointIDPath(checkpointID)}/transcript`;
+    try {
+        const content = await catFile(`${branch}:${transcriptPath}`, cwd);
+        return Buffer.from(content, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Explain a specific commit by finding its associated checkpoint.
+ */
+export async function explainCommit(commitRef, options = {}) {
+    const cwd = options.cwd;
+    let fullMessage;
+    try {
+        fullMessage = await git(['log', '-1', '--format=%B', commitRef], { cwd });
+    }
+    catch {
+        return null;
+    }
+    const [cpID] = parseCheckpoint(fullMessage);
+    let sha;
+    try {
+        sha = (await git(['rev-parse', commitRef], { cwd })).trim();
+    }
+    catch {
+        return null;
+    }
+    const message = fullMessage.split('\n')[0] ?? '';
+    let detail = null;
+    if (cpID) {
+        detail = await getCheckpointDetail(cpID, options);
+    }
+    return {
+        commitSHA: sha,
+        commitMessage: message,
+        checkpointID: cpID,
+        detail,
+    };
+}
+/**
+ * Find a checkpoint by ID prefix (partial match).
+ */
+export async function findCheckpointByPrefix(prefix, options = {}) {
+    const cwd = options.cwd;
+    // For full IDs, just return directly
+    if (prefix.length === 12)
+        return prefix;
+    // Need at least 2 chars for shard prefix
+    if (prefix.length < 2)
+        return null;
+    const shardPrefix = prefix.slice(0, 2);
+    const remainder = prefix.slice(2);
+    const branch = options.checkpointsBranch ?? CHECKPOINTS_BRANCH;
+    try {
+        const entries = await lsTree(branch, shardPrefix, cwd);
+        for (const entry of entries) {
+            if (entry.name.startsWith(remainder)) {
+                return `${shardPrefix}${entry.name}`;
+            }
+        }
+    }
+    catch {
+        // Shard doesn't exist
+    }
+    return null;
+}
+//# sourceMappingURL=explain.js.map

package/dist/sessionlog/commands/explain.js.map

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

package/dist/sessionlog/commands/reset.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Reset Command
+ *
+ * Deletes shadow branch and session state for the current HEAD.
+ * More targeted than clean — only affects the current commit's sessions.
+ */
+export interface ResetOptions {
+    cwd?: string;
+    /** Reset a specific session instead of all */
+    sessionID?: string;
+    /** Skip confirmation (for programmatic use) */
+    force?: boolean;
+}
+export interface ResetResult {
+    sessionsReset: string[];
+    branchesDeleted: string[];
+    errors: string[];
+}
+/**
+ * Reset shadow branches and session state for the current HEAD
+ */
+export declare function reset(options?: ResetOptions): Promise<ResetResult>;
+//# sourceMappingURL=reset.d.ts.map

package/dist/sessionlog/commands/reset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset.d.ts","sourceRoot":"","sources":["../../../src/sessionlog/commands/reset.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAMD;;GAEG;AACH,wBAAsB,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAmE5E"}

package/dist/sessionlog/commands/reset.js

@@ -0,0 +1,68 @@
+/**
+ * Reset Command
+ *
+ * Deletes shadow branch and session state for the current HEAD.
+ * More targeted than clean — only affects the current commit's sessions.
+ */
+import { getHead } from '../git-operations.js';
+import { createSessionStore } from '../store/session-store.js';
+import { createCheckpointStore } from '../store/checkpoint-store.js';
+// ============================================================================
+// Implementation
+// ============================================================================
+/**
+ * Reset shadow branches and session state for the current HEAD
+ */
+export async function reset(options = {}) {
+    const cwd = options.cwd;
+    const sessionStore = createSessionStore(cwd);
+    const checkpointStore = createCheckpointStore(cwd);
+    const head = await getHead(cwd);
+    const errors = [];
+    const sessionsReset = [];
+    const branchesDeleted = [];
+    const sessions = await sessionStore.list();
+    // Find sessions matching the current HEAD
+    let matchingSessions;
+    if (options.sessionID) {
+        matchingSessions = sessions.filter((s) => s.sessionID === options.sessionID);
+        if (matchingSessions.length === 0) {
+            errors.push(`Session not found: ${options.sessionID}`);
+            return { sessionsReset, branchesDeleted, errors };
+        }
+    }
+    else {
+        matchingSessions = sessions.filter((s) => s.baseCommit === head || head.startsWith(s.baseCommit));
+    }
+    // Safety check: warn about active sessions
+    if (!options.force) {
+        const activeSessions = matchingSessions.filter((s) => s.phase === 'active');
+        if (activeSessions.length > 0) {
+            errors.push(`${activeSessions.length} active session(s) found. Use --force to reset active sessions.`);
+            return { sessionsReset, branchesDeleted, errors };
+        }
+    }
+    for (const session of matchingSessions) {
+        // Delete shadow branch
+        if (session.baseCommit) {
+            const branchName = checkpointStore.getShadowBranchName(session.baseCommit, session.worktreeID);
+            try {
+                await checkpointStore.deleteShadowBranch(branchName);
+                branchesDeleted.push(branchName);
+            }
+            catch (e) {
+                errors.push(`Failed to delete branch ${branchName}: ${e instanceof Error ? e.message : String(e)}`);
+            }
+        }
+        // Delete session state
+        try {
+            await sessionStore.delete(session.sessionID);
+            sessionsReset.push(session.sessionID);
+        }
+        catch (e) {
+            errors.push(`Failed to delete session ${session.sessionID}: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    return { sessionsReset, branchesDeleted, errors };
+}
+//# sourceMappingURL=reset.js.map

package/dist/sessionlog/commands/reset.js.map

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

package/dist/sessionlog/commands/resume.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Resume Command
+ *
+ * Library implementation for resuming agent sessions from branches.
+ * Handles branch checkout, session discovery from commit trailers,
+ * and transcript restoration.
+ */
+import type { CheckpointID } from '../types.js';
+export interface ResumeInfo {
+    branchName: string;
+    sessionID: string;
+    sessionIDs: string[];
+    checkpointID: CheckpointID | null;
+    resumeCommand: string;
+    commitSHA: string;
+    commitMessage: string;
+    needsReset: boolean;
+    resetTargetSHA?: string;
+}
+export interface ResumeOptions {
+    cwd?: string;
+    force?: boolean;
+}
+export interface ResumeResult {
+    success: boolean;
+    info?: ResumeInfo;
+    error?: string;
+}
+/**
+ * Discover resume information for a branch without performing any actions.
+ * This is useful for preview/dry-run scenarios.
+ */
+export declare function discoverResumeInfo(branchName: string, options?: ResumeOptions): Promise<ResumeResult>;
+/**
+ * Get a list of branches that have checkpointed sessions.
+ */
+export declare function listResumableBranches(options?: ResumeOptions): Promise<Array<{
+    branch: string;
+    sessionID: string;
+    lastCommit: string;
+}>>;
+//# sourceMappingURL=resume.d.ts.map

package/dist/sessionlog/commands/resume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.d.ts","sourceRoot":"","sources":["../../../src/sessionlog/commands/resume.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAQhD,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CA+BvB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAiD3E"}