sessionlog 0.0.1

package/dist/session/state-machine.js

@@ -0,0 +1,345 @@
+/**
+ * Session State Machine
+ *
+ * Pure-function state machine for session lifecycle transitions.
+ * Ported from Go: session/phase.go
+ *
+ * The state machine computes the next phase and required actions given the
+ * current phase and an event. ApplyTransition executes side effects.
+ */
+/**
+ * Normalize a phase string, treating empty or unknown values as 'idle'
+ * for backward compatibility with pre-state-machine session files.
+ */
+export function phaseFromString(s) {
+    switch (s) {
+        case 'active':
+        case 'active_committed':
+            // "active_committed" was removed with the 1:1 checkpoint model.
+            return 'active';
+        case 'idle':
+            return 'idle';
+        case 'ended':
+            return 'ended';
+        default:
+            return 'idle';
+    }
+}
+const ALL_EVENTS = [
+    0 /* StateMachineEvent.TurnStart */,
+    1 /* StateMachineEvent.TurnEnd */,
+    2 /* StateMachineEvent.GitCommit */,
+    3 /* StateMachineEvent.SessionStart */,
+    4 /* StateMachineEvent.SessionStop */,
+    5 /* StateMachineEvent.Compaction */,
+];
+export function eventToString(e) {
+    switch (e) {
+        case 0 /* StateMachineEvent.TurnStart */:
+            return 'TurnStart';
+        case 1 /* StateMachineEvent.TurnEnd */:
+            return 'TurnEnd';
+        case 2 /* StateMachineEvent.GitCommit */:
+            return 'GitCommit';
+        case 3 /* StateMachineEvent.SessionStart */:
+            return 'SessionStart';
+        case 4 /* StateMachineEvent.SessionStop */:
+            return 'SessionStop';
+        case 5 /* StateMachineEvent.Compaction */:
+            return 'Compaction';
+        default:
+            return `Event(${e})`;
+    }
+}
+export function actionToString(a) {
+    switch (a) {
+        case 0 /* Action.Condense */:
+            return 'Condense';
+        case 1 /* Action.CondenseIfFilesTouched */:
+            return 'CondenseIfFilesTouched';
+        case 2 /* Action.DiscardIfNoFiles */:
+            return 'DiscardIfNoFiles';
+        case 3 /* Action.WarnStaleSession */:
+            return 'WarnStaleSession';
+        case 4 /* Action.ClearEndedAt */:
+            return 'ClearEndedAt';
+        case 5 /* Action.UpdateLastInteraction */:
+            return 'UpdateLastInteraction';
+        default:
+            return `Action(${a})`;
+    }
+}
+// ============================================================================
+// Transition — pure function, no side effects
+// ============================================================================
+export function transition(current, event, ctx) {
+    current = phaseFromString(current);
+    switch (current) {
+        case 'idle':
+            return transitionFromIdle(event, ctx);
+        case 'active':
+            return transitionFromActive(event, ctx);
+        case 'ended':
+            return transitionFromEnded(event, ctx);
+        default:
+            return { newPhase: 'idle', actions: [] };
+    }
+}
+function transitionFromIdle(event, ctx) {
+    switch (event) {
+        case 0 /* StateMachineEvent.TurnStart */:
+            return {
+                newPhase: 'active',
+                actions: [5 /* Action.UpdateLastInteraction */],
+            };
+        case 1 /* StateMachineEvent.TurnEnd */:
+            return { newPhase: 'idle', actions: [] };
+        case 2 /* StateMachineEvent.GitCommit */:
+            if (ctx.isRebaseInProgress) {
+                return { newPhase: 'idle', actions: [] };
+            }
+            return {
+                newPhase: 'idle',
+                actions: [0 /* Action.Condense */, 5 /* Action.UpdateLastInteraction */],
+            };
+        case 3 /* StateMachineEvent.SessionStart */:
+            return { newPhase: 'idle', actions: [] };
+        case 4 /* StateMachineEvent.SessionStop */:
+            return {
+                newPhase: 'ended',
+                actions: [5 /* Action.UpdateLastInteraction */],
+            };
+        case 5 /* StateMachineEvent.Compaction */:
+            return {
+                newPhase: 'idle',
+                actions: [1 /* Action.CondenseIfFilesTouched */, 5 /* Action.UpdateLastInteraction */],
+            };
+        default:
+            return { newPhase: 'idle', actions: [] };
+    }
+}
+function transitionFromActive(event, ctx) {
+    switch (event) {
+        case 0 /* StateMachineEvent.TurnStart */:
+            return {
+                newPhase: 'active',
+                actions: [5 /* Action.UpdateLastInteraction */],
+            };
+        case 1 /* StateMachineEvent.TurnEnd */:
+            return {
+                newPhase: 'idle',
+                actions: [5 /* Action.UpdateLastInteraction */],
+            };
+        case 2 /* StateMachineEvent.GitCommit */:
+            if (ctx.isRebaseInProgress) {
+                return { newPhase: 'active', actions: [] };
+            }
+            return {
+                newPhase: 'active',
+                actions: [0 /* Action.Condense */, 5 /* Action.UpdateLastInteraction */],
+            };
+        case 3 /* StateMachineEvent.SessionStart */:
+            return {
+                newPhase: 'active',
+                actions: [3 /* Action.WarnStaleSession */],
+            };
+        case 4 /* StateMachineEvent.SessionStop */:
+            return {
+                newPhase: 'ended',
+                actions: [5 /* Action.UpdateLastInteraction */],
+            };
+        case 5 /* StateMachineEvent.Compaction */:
+            return {
+                newPhase: 'active',
+                actions: [1 /* Action.CondenseIfFilesTouched */, 5 /* Action.UpdateLastInteraction */],
+            };
+        default:
+            return { newPhase: 'active', actions: [] };
+    }
+}
+function transitionFromEnded(event, ctx) {
+    switch (event) {
+        case 0 /* StateMachineEvent.TurnStart */:
+            return {
+                newPhase: 'active',
+                actions: [4 /* Action.ClearEndedAt */, 5 /* Action.UpdateLastInteraction */],
+            };
+        case 1 /* StateMachineEvent.TurnEnd */:
+            return { newPhase: 'ended', actions: [] };
+        case 2 /* StateMachineEvent.GitCommit */:
+            if (ctx.isRebaseInProgress) {
+                return { newPhase: 'ended', actions: [] };
+            }
+            if (ctx.hasFilesTouched) {
+                return {
+                    newPhase: 'ended',
+                    actions: [1 /* Action.CondenseIfFilesTouched */, 5 /* Action.UpdateLastInteraction */],
+                };
+            }
+            return {
+                newPhase: 'ended',
+                actions: [2 /* Action.DiscardIfNoFiles */, 5 /* Action.UpdateLastInteraction */],
+            };
+        case 3 /* StateMachineEvent.SessionStart */:
+            return {
+                newPhase: 'idle',
+                actions: [4 /* Action.ClearEndedAt */],
+            };
+        case 4 /* StateMachineEvent.SessionStop */:
+            return { newPhase: 'ended', actions: [] };
+        case 5 /* StateMachineEvent.Compaction */:
+            return { newPhase: 'ended', actions: [] };
+        default:
+            return { newPhase: 'ended', actions: [] };
+    }
+}
+export class NoOpActionHandler {
+    async handleCondense() { }
+    async handleCondenseIfFilesTouched() { }
+    async handleDiscardIfNoFiles() { }
+    async handleWarnStaleSession() { }
+}
+/**
+ * Apply a TransitionResult to state: sets the new phase, then executes
+ * all actions. Common actions (UpdateLastInteraction, ClearEndedAt)
+ * always run. Strategy-specific handler actions stop on first error.
+ */
+export async function applyTransition(state, result, handler) {
+    state.phase = result.newPhase;
+    let handlerErr = null;
+    for (const action of result.actions) {
+        switch (action) {
+            case 5 /* Action.UpdateLastInteraction */:
+                state.lastInteractionTime = new Date().toISOString();
+                break;
+            case 4 /* Action.ClearEndedAt */:
+                state.endedAt = undefined;
+                break;
+            case 0 /* Action.Condense */:
+                if (!handlerErr) {
+                    try {
+                        await handler.handleCondense(state);
+                    }
+                    catch (e) {
+                        handlerErr = e instanceof Error ? e : new Error(String(e));
+                    }
+                }
+                break;
+            case 1 /* Action.CondenseIfFilesTouched */:
+                if (!handlerErr) {
+                    try {
+                        await handler.handleCondenseIfFilesTouched(state);
+                    }
+                    catch (e) {
+                        handlerErr = e instanceof Error ? e : new Error(String(e));
+                    }
+                }
+                break;
+            case 2 /* Action.DiscardIfNoFiles */:
+                if (!handlerErr) {
+                    try {
+                        await handler.handleDiscardIfNoFiles(state);
+                    }
+                    catch (e) {
+                        handlerErr = e instanceof Error ? e : new Error(String(e));
+                    }
+                }
+                break;
+            case 3 /* Action.WarnStaleSession */:
+                if (!handlerErr) {
+                    try {
+                        await handler.handleWarnStaleSession(state);
+                    }
+                    catch (e) {
+                        handlerErr = e instanceof Error ? e : new Error(String(e));
+                    }
+                }
+                break;
+        }
+    }
+    return handlerErr;
+}
+// ============================================================================
+// Session State Helpers
+// ============================================================================
+/** Duration after which a session is considered stale (7 days) */
+export const STALE_SESSION_THRESHOLD_MS = 7 * 24 * 60 * 60 * 1000;
+/**
+ * Returns true when the session's last interaction exceeds the stale threshold.
+ */
+export function isStale(lastInteractionTime) {
+    if (!lastInteractionTime)
+        return false;
+    return Date.now() - new Date(lastInteractionTime).getTime() > STALE_SESSION_THRESHOLD_MS;
+}
+/**
+ * Normalize session state after loading from disk.
+ * Migrates legacy phase values and deprecated transcript fields.
+ */
+export function normalizeAfterLoad(state) {
+    // Normalize legacy phase values
+    state.phase = phaseFromString(state.phase);
+    // Migrate transcript fields
+    if (!state.checkpointTranscriptStart) {
+        if (state.condensedTranscriptLines && state.condensedTranscriptLines > 0) {
+            state.checkpointTranscriptStart = state.condensedTranscriptLines;
+        }
+        else if (state.transcriptLinesAtStart && state.transcriptLinesAtStart > 0) {
+            state.checkpointTranscriptStart = state.transcriptLinesAtStart;
+        }
+    }
+    // Clear deprecated fields
+    state.condensedTranscriptLines = 0;
+    state.transcriptLinesAtStart = 0;
+    // Backfill attributionBaseCommit
+    if (!state.attributionBaseCommit && state.baseCommit) {
+        state.attributionBaseCommit = state.baseCommit;
+    }
+}
+// ============================================================================
+// Mermaid Diagram
+// ============================================================================
+const ALL_PHASES = ['idle', 'active', 'ended'];
+/**
+ * Generate a Mermaid state diagram from the transition table.
+ */
+export function mermaidDiagram() {
+    const lines = ['stateDiagram-v2'];
+    lines.push('    state "IDLE" as idle');
+    lines.push('    state "ACTIVE" as active');
+    lines.push('    state "ENDED" as ended');
+    lines.push('');
+    for (const phase of ALL_PHASES) {
+        for (const event of ALL_EVENTS) {
+            let variants;
+            if (event === 2 /* StateMachineEvent.GitCommit */ && phase === 'ended') {
+                variants = [
+                    { label: '[files]', ctx: { hasFilesTouched: true, isRebaseInProgress: false } },
+                    { label: '[no files]', ctx: { hasFilesTouched: false, isRebaseInProgress: false } },
+                    { label: '[rebase]', ctx: { hasFilesTouched: false, isRebaseInProgress: true } },
+                ];
+            }
+            else if (event === 2 /* StateMachineEvent.GitCommit */) {
+                variants = [
+                    { label: '', ctx: { hasFilesTouched: false, isRebaseInProgress: false } },
+                    { label: '[rebase]', ctx: { hasFilesTouched: false, isRebaseInProgress: true } },
+                ];
+            }
+            else {
+                variants = [{ label: '', ctx: { hasFilesTouched: false, isRebaseInProgress: false } }];
+            }
+            for (const v of variants) {
+                const result = transition(phase, event, v.ctx);
+                let label = eventToString(event);
+                if (v.label)
+                    label += ' ' + v.label;
+                if (result.actions.length > 0) {
+                    label += ' / ' + result.actions.map(actionToString).join(', ');
+                }
+                lines.push(`    ${phase} --> ${result.newPhase} : ${label}`);
+            }
+        }
+    }
+    return lines.join('\n') + '\n';
+}
+//# sourceMappingURL=state-machine.js.map

package/dist/session/state-machine.js.map

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

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

@@ -0,0 +1,59 @@
+/**
+ * Checkpoint Store
+ *
+ * Manages checkpoint data stored on git branches.
+ * - Temporary checkpoints live on shadow branches (entire/<hash>)
+ * - Committed checkpoints live on entire/checkpoints/v1 branch
+ */
+import { type CheckpointID, type CheckpointSummary, type CommittedMetadata, type WriteTemporaryOptions, type WriteTemporaryResult, type WriteCommittedOptions } from '../types.js';
+export interface CheckpointStore {
+    /** Generate a new checkpoint ID */
+    generateID(): Promise<CheckpointID>;
+    /** Write a temporary checkpoint (shadow branch) */
+    writeTemporary(opts: WriteTemporaryOptions): Promise<WriteTemporaryResult>;
+    /** Read the latest temporary checkpoint for a base commit */
+    readTemporary(baseCommit: string, worktreeID?: string): Promise<{
+        commitHash: string;
+        treeHash: string;
+        sessionID: string;
+    } | null>;
+    /** List all temporary (shadow) branches */
+    listTemporary(): Promise<Array<{
+        branchName: string;
+        baseCommit: string;
+        latestCommit: string;
+        sessionID: string;
+        timestamp: string;
+    }>>;
+    /** Write a committed checkpoint to the metadata branch */
+    writeCommitted(opts: WriteCommittedOptions): Promise<void>;
+    /** Read a committed checkpoint summary */
+    readCommitted(checkpointID: CheckpointID): Promise<CheckpointSummary | null>;
+    /** Read session content from a committed checkpoint */
+    readSessionContent(checkpointID: CheckpointID, sessionIndex: number): Promise<{
+        metadata: CommittedMetadata;
+        transcript: string;
+        prompts: string;
+        context: string;
+    } | null>;
+    /** List committed checkpoints (most recent first) */
+    listCommitted(limit?: number): Promise<CheckpointSummary[]>;
+    /** Delete a shadow branch */
+    deleteShadowBranch(branchName: string): Promise<void>;
+    /** Get the shadow branch name for a base commit */
+    getShadowBranchName(baseCommit: string, worktreeID?: string): string;
+}
+/**
+ * Create a checkpoint store.
+ *
+ * @param cwd - The project working directory (used for shadow branches / temporary checkpoints)
+ * @param sessionRepoCwd - Optional separate repo directory for committed checkpoints.
+ *   When provided, the `entire/checkpoints/v1` branch and its data are stored
+ *   in this repo instead of the project repo. Shadow branches remain in the
+ *   project repo since they reference the project's git objects.
+ * @param checkpointsBranch - Optional override for the checkpoints branch name.
+ *   Defaults to `entire/checkpoints/v1`. When multiple projects share a session
+ *   repo, each project uses a unique branch like `entire/checkpoints/v1/<projectID>`.
+ */
+export declare function createCheckpointStore(cwd?: string, sessionRepoCwd?: string, checkpointsBranch?: string): CheckpointStore;
+//# sourceMappingURL=checkpoint-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-store.d.ts","sourceRoot":"","sources":["../../src/store/checkpoint-store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAM3B,MAAM,aAAa,CAAC;AAuBrB,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,UAAU,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IAEpC,mDAAmD;IACnD,cAAc,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAE3E,6DAA6D;IAC7D,aAAa,CACX,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAE/E,2CAA2C;IAC3C,aAAa,IAAI,OAAO,CACtB,KAAK,CAAC;QACJ,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CACH,CAAC;IAEF,0DAA0D;IAC1D,cAAc,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D,0CAA0C;IAC1C,aAAa,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAE7E,uDAAuD;IACvD,kBAAkB,CAChB,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC;QACT,QAAQ,EAAE,iBAAiB,CAAC;QAC5B,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,IAAI,CAAC,CAAC;IAEV,qDAAqD;IACrD,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAE5D,6BAA6B;IAC7B,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtD,mDAAmD;IACnD,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACtE;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,CAAC,EAAE,MAAM,EACZ,cAAc,CAAC,EAAE,MAAM,EACvB,iBAAiB,CAAC,EAAE,MAAM,GACzB,eAAe,CA6VjB"}