sessionlog 0.0.1

package/dist/store/session-store.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Session Store
+ *
+ * Manages session state files in .git/entire-sessions/.
+ * Each active session has a JSON state file that tracks
+ * its lifecycle, files touched, checkpoints, and token usage.
+ */
+import { type SessionState } from '../types.js';
+export interface SessionStore {
+    /** Load a session state by ID */
+    load(sessionID: string): Promise<SessionState | null>;
+    /** List all session states */
+    list(): Promise<SessionState[]>;
+    /** Save a session state */
+    save(state: SessionState): Promise<void>;
+    /** Delete a session state */
+    delete(sessionID: string): Promise<void>;
+    /** Get the sessions directory path */
+    getDir(): Promise<string>;
+    /** Check if a session exists */
+    exists(sessionID: string): Promise<boolean>;
+}
+/**
+ * Create a session store.
+ *
+ * @param cwd - The project working directory (used to locate .git/entire-sessions/)
+ * @param sessionsDir - Optional explicit directory for session state files.
+ *   When provided, session files are stored here instead of .git/entire-sessions/.
+ *   This is used when a separate session repo is configured.
+ */
+export declare function createSessionStore(cwd?: string, sessionsDir?: string): SessionStore;
+/**
+ * Normalize raw JSON data into a SessionState, handling field name variations
+ */
+export declare function normalizeSessionState(id: string, data: Record<string, unknown>): SessionState;
+//# sourceMappingURL=session-store.d.ts.map

package/dist/store/session-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../src/store/session-store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EACL,KAAK,YAAY,EAIlB,MAAM,aAAa,CAAC;AAOrB,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAEtD,8BAA8B;IAC9B,IAAI,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAEhC,2BAA2B;IAC3B,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC,6BAA6B;IAC7B,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC,sCAAsC;IACtC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAE1B,gCAAgC;IAChC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7C;AAMD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,YAAY,CAsHnF;AAMD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CAkC7F"}

package/dist/store/session-store.js

@@ -0,0 +1,193 @@
+/**
+ * Session Store
+ *
+ * Manages session state files in .git/entire-sessions/.
+ * Each active session has a JSON state file that tracks
+ * its lifecycle, files touched, checkpoints, and token usage.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { STALE_SESSION_DAYS, } from '../types.js';
+import { getSessionsDir, atomicWriteFile } from '../git-operations.js';
+// ============================================================================
+// Filesystem Session Store
+// ============================================================================
+/**
+ * Create a session store.
+ *
+ * @param cwd - The project working directory (used to locate .git/entire-sessions/)
+ * @param sessionsDir - Optional explicit directory for session state files.
+ *   When provided, session files are stored here instead of .git/entire-sessions/.
+ *   This is used when a separate session repo is configured.
+ */
+export function createSessionStore(cwd, sessionsDir) {
+    let sessionsDirCache = sessionsDir ?? null;
+    async function getDir() {
+        if (sessionsDirCache)
+            return sessionsDirCache;
+        sessionsDirCache = await getSessionsDir(cwd);
+        return sessionsDirCache;
+    }
+    function sessionFilePath(dir, sessionID) {
+        return path.join(dir, `${sessionID}.json`);
+    }
+    function parseSessionFile(filePath) {
+        try {
+            const content = fs.readFileSync(filePath, 'utf-8');
+            const data = JSON.parse(content);
+            const id = path.basename(filePath, '.json');
+            return normalizeSessionState(id, data);
+        }
+        catch {
+            return null;
+        }
+    }
+    function isStale(state) {
+        if (state.phase !== 'ended' || !state.endedAt)
+            return false;
+        const endedAt = new Date(state.endedAt);
+        const staleThreshold = Date.now() - STALE_SESSION_DAYS * 24 * 60 * 60 * 1000;
+        return endedAt.getTime() < staleThreshold;
+    }
+    return {
+        async load(sessionID) {
+            const dir = await getDir();
+            const filePath = sessionFilePath(dir, sessionID);
+            const state = parseSessionFile(filePath);
+            if (!state)
+                return null;
+            // Auto-delete stale sessions
+            if (isStale(state)) {
+                try {
+                    await fs.promises.unlink(filePath);
+                }
+                catch {
+                    // Ignore deletion errors
+                }
+                return null;
+            }
+            return state;
+        },
+        async list() {
+            const dir = await getDir();
+            try {
+                const files = await fs.promises.readdir(dir);
+                const states = [];
+                for (const file of files) {
+                    if (!file.endsWith('.json'))
+                        continue;
+                    const filePath = path.join(dir, file);
+                    const state = parseSessionFile(filePath);
+                    if (!state)
+                        continue;
+                    // Auto-delete stale sessions
+                    if (isStale(state)) {
+                        try {
+                            await fs.promises.unlink(filePath);
+                        }
+                        catch {
+                            // Ignore
+                        }
+                        continue;
+                    }
+                    states.push(state);
+                }
+                return states;
+            }
+            catch {
+                return [];
+            }
+        },
+        async save(state) {
+            const dir = await getDir();
+            const filePath = sessionFilePath(dir, state.sessionID);
+            const content = JSON.stringify(serializeSessionState(state), null, 2);
+            await atomicWriteFile(filePath, content);
+        },
+        async delete(sessionID) {
+            const dir = await getDir();
+            const filePath = sessionFilePath(dir, sessionID);
+            try {
+                await fs.promises.unlink(filePath);
+            }
+            catch {
+                // Ignore if already deleted
+            }
+        },
+        async getDir() {
+            return getDir();
+        },
+        async exists(sessionID) {
+            const dir = await getDir();
+            const filePath = sessionFilePath(dir, sessionID);
+            try {
+                await fs.promises.access(filePath);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+    };
+}
+// ============================================================================
+// Normalization
+// ============================================================================
+/**
+ * Normalize raw JSON data into a SessionState, handling field name variations
+ */
+export function normalizeSessionState(id, data) {
+    return {
+        sessionID: String(data.sessionID ?? data.session_id ?? id),
+        cliVersion: data.cliVersion,
+        baseCommit: String(data.baseCommit ?? data.base_commit ?? ''),
+        attributionBaseCommit: data.attributionBaseCommit,
+        worktreePath: data.worktreePath,
+        worktreeID: data.worktreeID,
+        startedAt: String(data.startedAt ?? data.started_at ?? new Date().toISOString()),
+        endedAt: (data.endedAt ?? data.ended_at),
+        phase: normalizePhase(String(data.phase ?? data.state ?? 'idle')),
+        turnID: data.turnID,
+        turnCheckpointIDs: Array.isArray(data.turnCheckpointIDs)
+            ? data.turnCheckpointIDs.map(String)
+            : [],
+        lastInteractionTime: (data.lastInteractionTime ?? data.last_interaction_time),
+        stepCount: Number(data.stepCount ?? data.step_count ?? 0),
+        checkpointTranscriptStart: Number(data.checkpointTranscriptStart ?? 0),
+        untrackedFilesAtStart: Array.isArray(data.untrackedFilesAtStart)
+            ? data.untrackedFilesAtStart.map(String)
+            : [],
+        filesTouched: Array.isArray(data.filesTouched) ? data.filesTouched.map(String) : [],
+        lastCheckpointID: data.lastCheckpointID,
+        agentType: String(data.agentType ?? data.agent ?? data.agent_type ?? 'Agent'),
+        tokenUsage: data.tokenUsage,
+        transcriptIdentifierAtStart: data.transcriptIdentifierAtStart,
+        transcriptPath: data.transcriptPath,
+        firstPrompt: data.firstPrompt,
+        promptAttributions: data.promptAttributions,
+        pendingPromptAttribution: data.pendingPromptAttribution,
+    };
+}
+function normalizePhase(phase) {
+    const lower = phase.toLowerCase();
+    if (lower === 'active')
+        return 'active';
+    if (lower === 'idle')
+        return 'idle';
+    if (lower === 'ended')
+        return 'ended';
+    return 'idle';
+}
+/**
+ * Serialize a SessionState for writing to disk
+ */
+function serializeSessionState(state) {
+    const result = { ...state };
+    // Remove undefined values
+    for (const [key, value] of Object.entries(result)) {
+        if (value === undefined)
+            delete result[key];
+    }
+    return result;
+}
+//# sourceMappingURL=session-store.js.map

package/dist/store/session-store.js.map

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

package/dist/strategy/attribution.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Attribution Logic
+ *
+ * Computes line-level attribution between agent-generated and human-edited code.
+ * Uses diff-based analysis to track who wrote which lines.
+ */
+import type { InitialAttribution } from '../types.js';
+import type { PromptAttribution } from './types.js';
+/**
+ * Compare two strings and return line-level diff stats.
+ * Returns [unchanged, added, removed] line counts.
+ *
+ * Uses a simple line-by-line comparison. For production-grade diffing,
+ * we compare line sets since we only need counts, not actual patches.
+ */
+export declare function diffLines(oldContent: string, newContent: string): [unchanged: number, added: number, removed: number];
+/**
+ * Get all changed files between two sets of file contents.
+ */
+export declare function getAllChangedFiles(tree1: Map<string, string>, tree2: Map<string, string>): string[];
+/**
+ * Calculate attribution with accumulated prompt data.
+ *
+ * This provides more accurate attribution than tree-only comparison because
+ * it captures user edits between checkpoints.
+ *
+ * @param baseFiles - File contents at session start
+ * @param shadowFiles - File contents at last checkpoint
+ * @param headFiles - File contents at commit time (HEAD)
+ * @param filesTouched - Files the agent modified
+ * @param promptAttributions - Per-prompt user edit tracking
+ */
+export declare function calculateAttributionWithAccumulated(baseFiles: Map<string, string>, shadowFiles: Map<string, string>, headFiles: Map<string, string>, filesTouched: string[], promptAttributions: PromptAttribution[]): InitialAttribution | null;
+/**
+ * Calculate prompt attribution at the start of a prompt.
+ * Captures user edits since the last checkpoint BEFORE the agent makes changes.
+ */
+export declare function calculatePromptAttribution(baseFiles: Map<string, string>, lastCheckpointFiles: Map<string, string> | null, worktreeFiles: Map<string, string>, checkpointNumber: number): PromptAttribution;
+//# sourceMappingURL=attribution.d.ts.map

package/dist/strategy/attribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribution.d.ts","sourceRoot":"","sources":["../../src/strategy/attribution.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAMpD;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CA6CrD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACzB,MAAM,EAAE,CAiBV;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mCAAmC,CACjD,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,YAAY,EAAE,MAAM,EAAE,EACtB,kBAAkB,EAAE,iBAAiB,EAAE,GACtC,kBAAkB,GAAG,IAAI,CAoH3B;AAkBD;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,EAC/C,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAClC,gBAAgB,EAAE,MAAM,GACvB,iBAAiB,CAqCnB"}

package/dist/strategy/attribution.js

@@ -0,0 +1,225 @@
+/**
+ * Attribution Logic
+ *
+ * Computes line-level attribution between agent-generated and human-edited code.
+ * Uses diff-based analysis to track who wrote which lines.
+ */
+import { countLines } from '../utils/string-utils.js';
+// ============================================================================
+// Diff-based Attribution
+// ============================================================================
+/**
+ * Compare two strings and return line-level diff stats.
+ * Returns [unchanged, added, removed] line counts.
+ *
+ * Uses a simple line-by-line comparison. For production-grade diffing,
+ * we compare line sets since we only need counts, not actual patches.
+ */
+export function diffLines(oldContent, newContent) {
+    if (oldContent === newContent) {
+        return [countLines(newContent), 0, 0];
+    }
+    if (oldContent === '') {
+        return [0, countLines(newContent), 0];
+    }
+    if (newContent === '') {
+        return [0, 0, countLines(oldContent)];
+    }
+    // Line-by-line LCS-based diff for accurate counting
+    const oldLines = oldContent.split('\n');
+    const newLines = newContent.split('\n');
+    // Remove trailing empty string from split if content ends with newline
+    if (oldLines[oldLines.length - 1] === '' && oldContent.endsWith('\n')) {
+        oldLines.pop();
+    }
+    if (newLines[newLines.length - 1] === '' && newContent.endsWith('\n')) {
+        newLines.pop();
+    }
+    // Build a set-based approximation for line counts
+    // This is simpler than full LCS but gives good accuracy for attribution
+    const oldSet = new Map();
+    for (const line of oldLines) {
+        oldSet.set(line, (oldSet.get(line) ?? 0) + 1);
+    }
+    let unchanged = 0;
+    const matchedOld = new Map();
+    for (const line of newLines) {
+        const available = (oldSet.get(line) ?? 0) - (matchedOld.get(line) ?? 0);
+        if (available > 0) {
+            unchanged++;
+            matchedOld.set(line, (matchedOld.get(line) ?? 0) + 1);
+        }
+    }
+    const removed = oldLines.length - unchanged;
+    const added = newLines.length - unchanged;
+    return [unchanged, added, removed];
+}
+/**
+ * Get all changed files between two sets of file contents.
+ */
+export function getAllChangedFiles(tree1, tree2) {
+    const changed = new Set();
+    for (const [path, hash1] of tree1) {
+        const hash2 = tree2.get(path);
+        if (hash2 === undefined || hash1 !== hash2) {
+            changed.add(path);
+        }
+    }
+    for (const path of tree2.keys()) {
+        if (!tree1.has(path)) {
+            changed.add(path);
+        }
+    }
+    return Array.from(changed);
+}
+/**
+ * Calculate attribution with accumulated prompt data.
+ *
+ * This provides more accurate attribution than tree-only comparison because
+ * it captures user edits between checkpoints.
+ *
+ * @param baseFiles - File contents at session start
+ * @param shadowFiles - File contents at last checkpoint
+ * @param headFiles - File contents at commit time (HEAD)
+ * @param filesTouched - Files the agent modified
+ * @param promptAttributions - Per-prompt user edit tracking
+ */
+export function calculateAttributionWithAccumulated(baseFiles, shadowFiles, headFiles, filesTouched, promptAttributions) {
+    if (filesTouched.length === 0)
+        return null;
+    // Sum accumulated user lines from prompt attributions
+    let accumulatedUserRemoved = 0;
+    const accumulatedUserAddedPerFile = new Map();
+    for (const pa of promptAttributions) {
+        accumulatedUserRemoved += pa.userLinesRemoved;
+        for (const [filePath, added] of Object.entries(pa.userAddedPerFile)) {
+            accumulatedUserAddedPerFile.set(filePath, (accumulatedUserAddedPerFile.get(filePath) ?? 0) + added);
+        }
+    }
+    // Calculate for agent-touched files
+    let totalAgentAndUserWork = 0;
+    let postCheckpointUserAdded = 0;
+    let postCheckpointUserRemoved = 0;
+    const postCheckpointUserRemovedPerFile = new Map();
+    for (const filePath of filesTouched) {
+        const baseContent = baseFiles.get(filePath) ?? '';
+        const shadowContent = shadowFiles.get(filePath) ?? '';
+        const headContent = headFiles.get(filePath) ?? '';
+        // Total work in shadow: base → shadow
+        const [, workAdded] = diffLines(baseContent, shadowContent);
+        totalAgentAndUserWork += workAdded;
+        // Post-checkpoint user edits: shadow → head
+        const [, postUserAdded, postUserRemoved] = diffLines(shadowContent, headContent);
+        postCheckpointUserAdded += postUserAdded;
+        postCheckpointUserRemoved += postUserRemoved;
+        if (postUserRemoved > 0) {
+            postCheckpointUserRemovedPerFile.set(filePath, postUserRemoved);
+        }
+    }
+    // User edits to non-agent files
+    const nonAgentFiles = getAllChangedFiles(baseFiles, headFiles);
+    const touchedSet = new Set(filesTouched);
+    let allUserEditsToNonAgentFiles = 0;
+    for (const filePath of nonAgentFiles) {
+        if (touchedSet.has(filePath))
+            continue;
+        const baseContent = baseFiles.get(filePath) ?? '';
+        const headContent = headFiles.get(filePath) ?? '';
+        const [, userAdded] = diffLines(baseContent, headContent);
+        allUserEditsToNonAgentFiles += userAdded;
+    }
+    // Separate accumulated edits by file type
+    const committedNonAgentSet = new Set(nonAgentFiles.filter((f) => !touchedSet.has(f)));
+    let accumulatedToAgentFiles = 0;
+    let accumulatedToCommittedNonAgentFiles = 0;
+    for (const [filePath, added] of accumulatedUserAddedPerFile) {
+        if (touchedSet.has(filePath)) {
+            accumulatedToAgentFiles += added;
+        }
+        else if (committedNonAgentSet.has(filePath)) {
+            accumulatedToCommittedNonAgentFiles += added;
+        }
+    }
+    // Agent work = (base→shadow for agent files) - (accumulated user edits to agent files)
+    const totalAgentAdded = Math.max(0, totalAgentAndUserWork - accumulatedToAgentFiles);
+    // Post-checkpoint edits to non-agent files
+    const postToNonAgentFiles = Math.max(0, allUserEditsToNonAgentFiles - accumulatedToCommittedNonAgentFiles);
+    // Total user contribution
+    const relevantAccumulatedUser = accumulatedToAgentFiles + accumulatedToCommittedNonAgentFiles;
+    const totalUserAdded = relevantAccumulatedUser + postCheckpointUserAdded + postToNonAgentFiles;
+    const totalUserRemoved = accumulatedUserRemoved + postCheckpointUserRemoved;
+    // Estimate modified lines
+    const totalHumanModified = Math.min(totalUserAdded, totalUserRemoved);
+    // Estimate user self-modifications
+    const userSelfModified = estimateUserSelfModifications(accumulatedUserAddedPerFile, postCheckpointUserRemovedPerFile);
+    const humanModifiedAgent = Math.max(0, totalHumanModified - userSelfModified);
+    const pureUserAdded = totalUserAdded - totalHumanModified;
+    const pureUserRemoved = totalUserRemoved - totalHumanModified;
+    let totalCommitted = totalAgentAdded + pureUserAdded - pureUserRemoved;
+    if (totalCommitted <= 0) {
+        totalCommitted = Math.max(0, totalAgentAdded);
+    }
+    const agentLinesInCommit = Math.max(0, totalAgentAdded - pureUserRemoved - humanModifiedAgent);
+    let agentPercentage = 0;
+    if (totalCommitted > 0) {
+        agentPercentage = (agentLinesInCommit / totalCommitted) * 100;
+    }
+    return {
+        calculatedAt: new Date().toISOString(),
+        agentLines: agentLinesInCommit,
+        humanAdded: pureUserAdded,
+        humanModified: totalHumanModified,
+        humanRemoved: pureUserRemoved,
+        totalCommitted,
+        agentPercentage,
+    };
+}
+/**
+ * Estimate how many removed lines were the user's own additions.
+ * Uses LIFO assumption: user removes their own recent additions first.
+ */
+function estimateUserSelfModifications(accumulatedUserAddedPerFile, postCheckpointUserRemovedPerFile) {
+    let selfModified = 0;
+    for (const [filePath, removed] of postCheckpointUserRemovedPerFile) {
+        const userAddedToFile = accumulatedUserAddedPerFile.get(filePath) ?? 0;
+        selfModified += Math.min(removed, userAddedToFile);
+    }
+    return selfModified;
+}
+/**
+ * Calculate prompt attribution at the start of a prompt.
+ * Captures user edits since the last checkpoint BEFORE the agent makes changes.
+ */
+export function calculatePromptAttribution(baseFiles, lastCheckpointFiles, worktreeFiles, checkpointNumber) {
+    const result = {
+        checkpointNumber,
+        userLinesAdded: 0,
+        userLinesRemoved: 0,
+        agentLinesAdded: 0,
+        agentLinesRemoved: 0,
+        userAddedPerFile: {},
+    };
+    if (worktreeFiles.size === 0)
+        return result;
+    const referenceFiles = lastCheckpointFiles ?? baseFiles;
+    for (const [filePath, worktreeContent] of worktreeFiles) {
+        const referenceContent = referenceFiles.get(filePath) ?? '';
+        const baseContent = baseFiles.get(filePath) ?? '';
+        // User changes: diff(reference, worktree)
+        const [, userAdded, userRemoved] = diffLines(referenceContent, worktreeContent);
+        result.userLinesAdded += userAdded;
+        result.userLinesRemoved += userRemoved;
+        if (userAdded > 0) {
+            result.userAddedPerFile[filePath] = userAdded;
+        }
+        // Agent lines so far: diff(base, lastCheckpoint)
+        if (lastCheckpointFiles) {
+            const checkpointContent = lastCheckpointFiles.get(filePath) ?? '';
+            const [, agentAdded, agentRemoved] = diffLines(baseContent, checkpointContent);
+            result.agentLinesAdded += agentAdded;
+            result.agentLinesRemoved += agentRemoved;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=attribution.js.map

package/dist/strategy/attribution.js.map

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

package/dist/strategy/common.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Strategy Common Infrastructure
+ *
+ * Shared utilities used by strategy implementations for metadata branch
+ * operations, repository validation, and setup.
+ *
+ * Ported from Go: strategy/common.go
+ */
+import { type CheckpointID, type CommittedMetadata } from '../types.js';
+/**
+ * Validates that the repository is suitable for the manual-commit strategy.
+ * Throws if the repository is bare, has no commits, or is not a git repo.
+ */
+export declare function validateRepository(cwd?: string): Promise<void>;
+/**
+ * Check if the repository has any commits.
+ */
+export declare function isEmptyRepository(cwd?: string): Promise<boolean>;
+/**
+ * Check if commit `ancestor` is an ancestor of commit `descendant`.
+ * Uses a bounded traversal to prevent runaway history walks.
+ */
+export declare function isAncestorOf(ancestor: string, descendant: string, _maxDepth?: number, cwd?: string): Promise<boolean>;
+/**
+ * Check if we're inside a git worktree (not the main repo).
+ */
+export declare function isInsideWorktree(cwd?: string): Promise<boolean>;
+/**
+ * Ensure the metadata branch (entire/checkpoints/v1) exists.
+ * Creates it with an initial empty-tree commit if it doesn't exist.
+ */
+export declare function ensureMetadataBranch(cwd?: string): Promise<void>;
+/**
+ * Read checkpoint metadata from the metadata branch.
+ */
+export declare function readCheckpointMetadata(checkpointID: CheckpointID, cwd?: string): Promise<CommittedMetadata | null>;
+/**
+ * Read a session prompt from the metadata branch tree.
+ */
+export declare function readSessionPromptFromTree(checkpointID: CheckpointID, sessionIndex: number, cwd?: string): Promise<string>;
+/**
+ * Read the agent type from checkpoint metadata.
+ */
+export declare function readAgentTypeFromTree(checkpointID: CheckpointID, cwd?: string): Promise<string>;
+/**
+ * Extract the first user prompt from a transcript or prompt file.
+ */
+export declare function extractFirstPrompt(prompts: string): string;
+/**
+ * Full strategy setup: create metadata branch, ensure .gitignore, etc.
+ */
+export declare function ensureSetup(cwd?: string): Promise<void>;
+/**
+ * Get the root directory of the main repository (not a worktree).
+ */
+export declare function getMainRepoRoot(cwd?: string): Promise<string>;
+//# sourceMappingURL=common.d.ts.map

package/dist/strategy/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/strategy/common.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAcH,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,iBAAiB,EAEvB,MAAM,aAAa,CAAC;AAOrB;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBpE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOtE;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,GAAE,MAAa,EACxB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,OAAO,CAAC,CAIlB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAKrE;AAMD;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBtE;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,YAAY,EAAE,YAAY,EAC1B,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CASnC;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,MAAM,EACpB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,YAAY,EAC1B,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAO1D;AAMD;;GAEG;AACH,wBAAsB,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI7D;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAWnE"}