sessionlog 0.0.1

package/dist/index.js

@@ -0,0 +1,166 @@
+/**
+ * Entire - Native TypeScript Implementation
+ *
+ * A self-contained module that implements the Entire CLI's functionality
+ * in TypeScript. Designed with clean boundaries for eventual extraction
+ * into a standalone package.
+ *
+ * @packageDocumentation
+ */
+import { createRequire } from 'node:module';
+// =============================================================================
+// Version
+// =============================================================================
+const require = createRequire(import.meta.url);
+const { version: VERSION } = require('../package.json');
+/** Current package version */
+export { VERSION };
+/**
+ * Get the current version string.
+ */
+export function getVersion() {
+    return VERSION;
+}
+export { AGENT_NAMES, AGENT_TYPES, DEFAULT_AGENT_NAME, EventType, CheckpointType, CHECKPOINT_ID_LENGTH, CHECKPOINT_ID_PATTERN, CHECKPOINTS_BRANCH, SHADOW_BRANCH_PREFIX, ENTIRE_DIR, ENTIRE_METADATA_DIR, ENTIRE_TMP_DIR, ENTIRE_SETTINGS_FILE, ENTIRE_SETTINGS_LOCAL_FILE, SESSION_DIR_NAME, MAX_CHUNK_SIZE, DEFAULT_SETTINGS, validateCheckpointID, checkpointIDPath, emptyTokenUsage, addTokenUsage, } from './types.js';
+// =============================================================================
+// Git Operations
+// =============================================================================
+export { git, gitSafe, getGitDir, getGitCommonDir, getWorktreeRoot, isGitRepository, getSessionsDir, getHead, getShortHash, getCurrentBranch, refExists, getTreeHash, listBranches, hashObject, mktree, commitTree, lsTree, catFile, showFile, log, diffNameOnly, diffStat, hasUncommittedChanges, getUntrackedFiles, isOnDefaultBranch, pushBranch, getGitAuthor, resolveGitDirSync, atomicWriteFile, initSessionRepo, resolveSessionRepoPath, getProjectID, GitError, } from './git-operations.js';
+// =============================================================================
+// Session Store
+// =============================================================================
+export { createSessionStore, normalizeSessionState, } from './store/session-store.js';
+// =============================================================================
+// Checkpoint Store
+// =============================================================================
+export { createCheckpointStore } from './store/checkpoint-store.js';
+// =============================================================================
+// Native Store (replaces CLI store)
+// =============================================================================
+export { createNativeEntireStore } from './store/native-store.js';
+export { hasHookSupport, hasFileWatcher, hasTranscriptAnalyzer, hasTokenCalculator, hasTranscriptChunker, hasTranscriptPreparer, hasSubagentAwareExtractor, } from './agent/types.js';
+export { registerAgent, getAgent, listAgentNames, listAgents, detectAgents, detectAgent, getAgentByType, getDefaultAgent, allProtectedDirs, resolveAgent, resetRegistry, } from './agent/registry.js';
+// Agent Implementations
+export { createClaudeCodeAgent, parseTranscript, extractModifiedFiles, extractLastUserPrompt, extractSpawnedAgentIDs, } from './agent/agents/claude-code.js';
+export { createCursorAgent } from './agent/agents/cursor.js';
+export { createGeminiCLIAgent, } from './agent/agents/gemini-cli.js';
+export { createOpenCodeAgent, extractTextFromParts, parseExportSession, extractAllUserPrompts, } from './agent/agents/opencode.js';
+// =============================================================================
+// Hooks
+// =============================================================================
+export { installGitHooks, uninstallGitHooks, areGitHooksInstalled, } from './hooks/git-hooks.js';
+export { createLifecycleHandler, } from './hooks/lifecycle.js';
+// =============================================================================
+// Security
+// =============================================================================
+export { shannonEntropy, detectSecrets, redactString, redactBuffer, redactJSONL, } from './security/redaction.js';
+// =============================================================================
+// Configuration
+// =============================================================================
+export { loadSettings, loadProjectSettings, loadLocalSettings, saveProjectSettings, saveLocalSettings, isEnabled, getStrategy, ensureGitignore, } from './config.js';
+// =============================================================================
+// Commands
+// =============================================================================
+export { enable } from './commands/enable.js';
+export { disable } from './commands/disable.js';
+export { status, formatStatusJSON, formatTokens, } from './commands/status.js';
+export { listRewindPoints, rewindTo, listRewindPointsJSON, } from './commands/rewind.js';
+export { diagnose, discardSession, doctor, } from './commands/doctor.js';
+export { findOrphaned, clean, } from './commands/clean.js';
+export { reset } from './commands/reset.js';
+export { listCheckpoints, getCheckpointDetail, getCheckpointTranscript, explainCommit, findCheckpointByPrefix, } from './commands/explain.js';
+export { discoverResumeInfo, listResumableBranches, } from './commands/resume.js';
+// =============================================================================
+// Strategy Engine
+// =============================================================================
+export { createManualCommitStrategy, hasUserContent, stripCheckpointTrailer, } from './strategy/manual-commit.js';
+export { STRATEGY_NAME_MANUAL_COMMIT, MAX_COMMIT_TRAVERSAL_DEPTH } from './strategy/types.js';
+// =============================================================================
+// Utilities
+// =============================================================================
+export { parseStrategy, parseMetadata, parseTaskMetadata, parseBaseCommit, parseCondensation, parseSession, parseCheckpoint as parseCheckpointTrailer, parseAllSessions, formatStrategy, formatMetadata, formatShadowCommit, formatShadowTaskCommit, formatCheckpoint as formatCheckpointTrailer, formatSourceRef, MetadataTrailerKey, StrategyTrailerKey, SessionTrailerKey, CheckpointTrailerKey, BaseCommitTrailerKey, } from './utils/trailers.js';
+export { stripIDEContextTags } from './utils/ide-tags.js';
+export { truncateRunes, collapseWhitespace, capitalizeFirst, countLines, } from './utils/string-utils.js';
+export { parseFromBytes, parseFromBytesAtLine, sliceFromLine, extractUserContent, } from './utils/transcript-parse.js';
+export { generateCommitMessage } from './utils/commit-message.js';
+// =============================================================================
+// Summarization
+// =============================================================================
+export { buildCondensedTranscriptFromBytes, buildCondensedTranscript, formatCondensedTranscript, buildSummarizationPrompt, extractJSONFromMarkdown, generateFromTranscript, } from './summarize/summarize.js';
+// =============================================================================
+// Attribution
+// =============================================================================
+export { diffLines, getAllChangedFiles, calculateAttributionWithAccumulated, } from './strategy/attribution.js';
+// =============================================================================
+// Content Overlap
+// =============================================================================
+export { filesOverlapWithContent, stagedFilesOverlapWithContent, filesWithRemainingAgentChanges, } from './strategy/content-overlap.js';
+// =============================================================================
+// Validation
+// =============================================================================
+export { validateSessionID, validateToolUseID, validateAgentID, validateAgentSessionID, } from './utils/validation.js';
+// =============================================================================
+// Hook Manager Detection
+// =============================================================================
+export { detectHookManagers, hookManagerWarning } from './utils/hook-managers.js';
+// =============================================================================
+// Worktree Utilities
+// =============================================================================
+export { getWorktreeID } from './utils/worktree.js';
+// =============================================================================
+// Transcript Timestamps
+// =============================================================================
+export { parseTimestampFromJSONL, getLastTimestampFromBytes, getLastTimestampFromFile, } from './utils/transcript-timestamp.js';
+// =============================================================================
+// Summary Generator (Claude CLI)
+// =============================================================================
+export { createClaudeGenerator, DEFAULT_SUMMARIZE_MODEL, } from './summarize/claude-generator.js';
+// =============================================================================
+// Session State Machine
+// =============================================================================
+export { transition, applyTransition, phaseFromString, eventToString, actionToString, isStale, normalizeAfterLoad, mermaidDiagram, NoOpActionHandler, STALE_SESSION_THRESHOLD_MS, } from './session/state-machine.js';
+// =============================================================================
+// Todo Extraction
+// =============================================================================
+export { extractLastCompletedTodo, extractInProgressTodo, countTodos, extractTodoContentFromToolInput, extractLastCompletedTodoFromToolInput, countTodosFromToolInput, formatIncrementalMessage, } from './utils/todo-extract.js';
+// =============================================================================
+// Rewind Conflict Detection
+// =============================================================================
+export { classifyTimestamps, statusToText, hasConflicts, partitionConflicts, resolveAgentForRewind, } from './utils/rewind-conflict.js';
+// =============================================================================
+// Chunk File Naming
+// =============================================================================
+export { chunkFileName, parseChunkIndex, sortChunkFiles } from './utils/chunk-files.js';
+// =============================================================================
+// Path Classification
+// =============================================================================
+export { isInfrastructurePath, toRelativePath, absPath, extractSessionIDFromPath, sessionMetadataDir, } from './utils/paths.js';
+// =============================================================================
+// Agent Type Detection
+// =============================================================================
+export { detectAgentTypeFromContent } from './utils/detect-agent.js';
+// =============================================================================
+// TTY Interaction
+// =============================================================================
+export { hasTTY, askConfirmTTY } from './utils/tty.js';
+// =============================================================================
+// Shadow Branch Utilities
+// =============================================================================
+export { hashWorktreeID, shadowBranchNameForCommit, parseShadowBranchName, isShadowBranch, listShadowBranches, deleteShadowBranches, } from './utils/shadow-branch.js';
+// =============================================================================
+// Rewind Preview
+// =============================================================================
+export { previewRewind, } from './utils/preview-rewind.js';
+// =============================================================================
+// Normalized Agent Session
+// =============================================================================
+export { createAgentSession } from './agent/session-types.js';
+// =============================================================================
+// Strategy Infrastructure
+// =============================================================================
+export { validateRepository, isEmptyRepository, isAncestorOf, isInsideWorktree, ensureMetadataBranch, readCheckpointMetadata, readSessionPromptFromTree, readAgentTypeFromTree, extractFirstPrompt, ensureSetup, getMainRepoRoot, } from './strategy/common.js';
+// =============================================================================
+// Git Tree Manipulation
+// =============================================================================
+export { updateSubtree, applyTreeChanges, createTreeFromMap } from './utils/tree-ops.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/security/redaction.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Secret Redaction
+ *
+ * Multi-layered secret detection and redaction for transcripts.
+ * Uses both entropy-based detection and pattern matching
+ * for known secret formats.
+ */
+/**
+ * Calculate Shannon entropy of a string
+ */
+export declare function shannonEntropy(s: string): number;
+interface RedactionRegion {
+    start: number;
+    end: number;
+    source: string;
+}
+/**
+ * Detect secret regions in a string
+ */
+export declare function detectSecrets(text: string): RedactionRegion[];
+/**
+ * Redact secrets from a plain string
+ */
+export declare function redactString(text: string): string;
+/**
+ * Redact secrets from a Buffer
+ */
+export declare function redactBuffer(buf: Buffer): Buffer;
+/**
+ * Redact secrets from JSONL content (line by line)
+ * Preserves JSON structure and skips safe fields
+ */
+export declare function redactJSONL(content: string): string;
+export {};
+//# sourceMappingURL=redaction.d.ts.map

package/dist/security/redaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.d.ts","sourceRoot":"","sources":["../../src/security/redaction.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAuGH;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAehD;AAMD,UAAU,eAAe;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AA2BD;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE,CA8B7D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAejD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAqBnD"}

package/dist/security/redaction.js

@@ -0,0 +1,239 @@
+/**
+ * Secret Redaction
+ *
+ * Multi-layered secret detection and redaction for transcripts.
+ * Uses both entropy-based detection and pattern matching
+ * for known secret formats.
+ */
+// ============================================================================
+// Constants
+// ============================================================================
+const ENTROPY_THRESHOLD = 4.5;
+const MIN_SECRET_LENGTH = 10;
+const REDACTED_PLACEHOLDER = 'REDACTED';
+/** High-entropy alphanumeric pattern (potential secrets) */
+const HIGH_ENTROPY_PATTERN = /[A-Za-z0-9+_=-]{10,}/g;
+// ============================================================================
+// Known Secret Patterns (subset of gitleaks rules)
+// ============================================================================
+const SECRET_PATTERNS = [
+    // API Keys
+    {
+        name: 'aws-access-key',
+        pattern: /(?:A3T[A-Z0-9]|AKIA|AGPA|AIDA|AROA|AIPA|ANPA|ANVA|ASIA)[A-Z0-9]{16}/g,
+    },
+    {
+        name: 'aws-secret-key',
+        pattern: /(?:aws_secret_access_key|aws_secret_key|secret_key)\s*[=:]\s*["']?([A-Za-z0-9/+=]{40})["']?/gi,
+    },
+    { name: 'github-token', pattern: /gh[pousr]_[A-Za-z0-9_]{36,255}/g },
+    { name: 'github-fine-grained', pattern: /github_pat_[A-Za-z0-9_]{22,255}/g },
+    { name: 'gitlab-token', pattern: /glpat-[A-Za-z0-9=_-]{20,}/g },
+    { name: 'google-api-key', pattern: /AIza[A-Za-z0-9_-]{35}/g },
+    { name: 'slack-token', pattern: /xox[baprs]-[0-9]{10,13}-[0-9]{10,13}-[a-zA-Z0-9]{24,34}/g },
+    {
+        name: 'slack-webhook',
+        pattern: /https:\/\/hooks\.slack\.com\/services\/T[A-Z0-9]{10}\/B[A-Z0-9]{10}\/[a-zA-Z0-9]{24}/g,
+    },
+    { name: 'stripe-key', pattern: /(?:sk|pk|rk)_(?:live|test)_[A-Za-z0-9]{10,99}/g },
+    { name: 'twilio-api-key', pattern: /SK[0-9a-fA-F]{32}/g },
+    { name: 'sendgrid-api-key', pattern: /SG\.[A-Za-z0-9_-]{22}\.[A-Za-z0-9_-]{43}/g },
+    { name: 'npm-token', pattern: /npm_[A-Za-z0-9]{36}/g },
+    { name: 'pypi-token', pattern: /pypi-[A-Za-z0-9_-]{100,}/g },
+    // Cloud Providers
+    {
+        name: 'azure-connection-string',
+        pattern: /DefaultEndpointsProtocol=https;AccountName=[^;]+;AccountKey=[A-Za-z0-9+/=]{88};/g,
+    },
+    {
+        name: 'gcp-service-account',
+        pattern: /"private_key":\s*"-----BEGIN (?:RSA )?PRIVATE KEY-----/g,
+    },
+    // Generic Secrets
+    { name: 'private-key', pattern: /-----BEGIN (?:RSA |EC |DSA |OPENSSH )?PRIVATE KEY-----/g },
+    { name: 'jwt', pattern: /eyJ[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{10,}/g },
+    { name: 'basic-auth', pattern: /(?:basic|bearer)\s+[A-Za-z0-9+/=]{20,}/gi },
+    { name: 'password-in-url', pattern: /[a-zA-Z]{3,10}:\/\/[^/\s:@]{3,20}:[^/\s@]{3,20}@/g },
+    // Anthropic
+    { name: 'anthropic-api-key', pattern: /sk-ant-[A-Za-z0-9_-]{90,}/g },
+    // OpenAI
+    { name: 'openai-api-key', pattern: /sk-[A-Za-z0-9]{20}T3BlbkFJ[A-Za-z0-9]{20}/g },
+    // Database
+    { name: 'postgres-url', pattern: /postgres(?:ql)?:\/\/[^/\s:@]+:[^/\s@]+@[^/\s]+\/[^/\s]+/g },
+    { name: 'mysql-url', pattern: /mysql:\/\/[^/\s:@]+:[^/\s@]+@[^/\s]+\/[^/\s]+/g },
+    { name: 'mongodb-url', pattern: /mongodb(?:\+srv)?:\/\/[^/\s:@]+:[^/\s@]+@[^/\s]+/g },
+    // Hex-encoded secrets (generic)
+    {
+        name: 'hex-secret',
+        pattern: /(?:secret|token|key|password|api_key|apikey)\s*[=:]\s*["']?([0-9a-fA-F]{32,})["']?/gi,
+    },
+];
+// Fields that should be skipped during redaction
+const SAFE_FIELDS = new Set([
+    'signature',
+    'id',
+    'uuid',
+    'sessionId',
+    'session_id',
+    'checkpointId',
+    'checkpoint_id',
+    'nodeId',
+    'node_id',
+    'toolUseId',
+    'tool_use_id',
+    'file_path',
+    'filePath',
+    'path',
+    'name',
+    'type',
+    'role',
+]);
+// ============================================================================
+// Entropy Calculation
+// ============================================================================
+/**
+ * Calculate Shannon entropy of a string
+ */
+export function shannonEntropy(s) {
+    if (s.length === 0)
+        return 0;
+    const freq = new Map();
+    for (const ch of s) {
+        freq.set(ch, (freq.get(ch) ?? 0) + 1);
+    }
+    let entropy = 0;
+    for (const count of freq.values()) {
+        const p = count / s.length;
+        if (p > 0)
+            entropy -= p * Math.log2(p);
+    }
+    return entropy;
+}
+/**
+ * Merge overlapping regions
+ */
+function mergeRegions(regions) {
+    if (regions.length === 0)
+        return [];
+    const sorted = [...regions].sort((a, b) => a.start - b.start);
+    const merged = [sorted[0]];
+    for (let i = 1; i < sorted.length; i++) {
+        const last = merged[merged.length - 1];
+        if (sorted[i].start <= last.end) {
+            last.end = Math.max(last.end, sorted[i].end);
+        }
+        else {
+            merged.push(sorted[i]);
+        }
+    }
+    return merged;
+}
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * Detect secret regions in a string
+ */
+export function detectSecrets(text) {
+    const regions = [];
+    // Entropy-based detection
+    for (const match of text.matchAll(HIGH_ENTROPY_PATTERN)) {
+        const value = match[0];
+        if (value.length < MIN_SECRET_LENGTH)
+            continue;
+        if (shannonEntropy(value) >= ENTROPY_THRESHOLD) {
+            regions.push({
+                start: match.index,
+                end: match.index + value.length,
+                source: 'entropy',
+            });
+        }
+    }
+    // Pattern-based detection
+    for (const { name, pattern } of SECRET_PATTERNS) {
+        // Reset regex state
+        pattern.lastIndex = 0;
+        for (const match of text.matchAll(pattern)) {
+            regions.push({
+                start: match.index,
+                end: match.index + match[0].length,
+                source: name,
+            });
+        }
+    }
+    return mergeRegions(regions);
+}
+/**
+ * Redact secrets from a plain string
+ */
+export function redactString(text) {
+    const regions = detectSecrets(text);
+    if (regions.length === 0)
+        return text;
+    let result = '';
+    let pos = 0;
+    for (const region of regions) {
+        result += text.slice(pos, region.start);
+        result += REDACTED_PLACEHOLDER;
+        pos = region.end;
+    }
+    result += text.slice(pos);
+    return result;
+}
+/**
+ * Redact secrets from a Buffer
+ */
+export function redactBuffer(buf) {
+    return Buffer.from(redactString(buf.toString('utf-8')));
+}
+/**
+ * Redact secrets from JSONL content (line by line)
+ * Preserves JSON structure and skips safe fields
+ */
+export function redactJSONL(content) {
+    const lines = content.split('\n');
+    const result = [];
+    for (const line of lines) {
+        if (!line.trim()) {
+            result.push(line);
+            continue;
+        }
+        try {
+            const parsed = JSON.parse(line);
+            const redacted = redactJSONValue(parsed);
+            result.push(JSON.stringify(redacted));
+        }
+        catch {
+            // Not valid JSON, redact as plain text
+            result.push(redactString(line));
+        }
+    }
+    return result.join('\n');
+}
+/**
+ * Recursively redact values in a JSON object
+ */
+function redactJSONValue(value, key) {
+    // Skip safe fields
+    if (key && SAFE_FIELDS.has(key))
+        return value;
+    if (typeof value === 'string') {
+        return redactString(value);
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => redactJSONValue(item));
+    }
+    if (value && typeof value === 'object') {
+        const obj = value;
+        // Skip image/base64 objects
+        if (obj.type === 'image' || obj.type === 'base64')
+            return value;
+        const result = {};
+        for (const [k, v] of Object.entries(obj)) {
+            result[k] = redactJSONValue(v, k);
+        }
+        return result;
+    }
+    return value;
+}
+//# sourceMappingURL=redaction.js.map

package/dist/security/redaction.js.map

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

package/dist/session/state-machine.d.ts

@@ -0,0 +1,90 @@
+/**
+ * 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.
+ */
+export type Phase = 'active' | 'idle' | 'ended';
+/**
+ * Normalize a phase string, treating empty or unknown values as 'idle'
+ * for backward compatibility with pre-state-machine session files.
+ */
+export declare function phaseFromString(s: string | undefined): Phase;
+export declare const enum StateMachineEvent {
+    TurnStart = 0,
+    TurnEnd = 1,
+    GitCommit = 2,
+    SessionStart = 3,
+    SessionStop = 4,
+    Compaction = 5
+}
+export declare function eventToString(e: StateMachineEvent): string;
+export declare const enum Action {
+    Condense = 0,
+    CondenseIfFilesTouched = 1,
+    DiscardIfNoFiles = 2,
+    WarnStaleSession = 3,
+    ClearEndedAt = 4,
+    UpdateLastInteraction = 5
+}
+export declare function actionToString(a: Action): string;
+export interface TransitionContext {
+    hasFilesTouched: boolean;
+    isRebaseInProgress: boolean;
+}
+export interface TransitionResult {
+    newPhase: Phase;
+    actions: Action[];
+}
+export declare function transition(current: Phase, event: StateMachineEvent, ctx: TransitionContext): TransitionResult;
+export interface ActionHandler {
+    handleCondense(state: StateMachineState): Promise<void>;
+    handleCondenseIfFilesTouched(state: StateMachineState): Promise<void>;
+    handleDiscardIfNoFiles(state: StateMachineState): Promise<void>;
+    handleWarnStaleSession(state: StateMachineState): Promise<void>;
+}
+export declare class NoOpActionHandler implements ActionHandler {
+    handleCondense(): Promise<void>;
+    handleCondenseIfFilesTouched(): Promise<void>;
+    handleDiscardIfNoFiles(): Promise<void>;
+    handleWarnStaleSession(): Promise<void>;
+}
+export interface StateMachineState {
+    sessionID: string;
+    phase: Phase;
+    filesTouched: string[];
+    lastInteractionTime?: string;
+    endedAt?: string;
+}
+/**
+ * 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 declare function applyTransition(state: StateMachineState, result: TransitionResult, handler: ActionHandler): Promise<Error | null>;
+/** Duration after which a session is considered stale (7 days) */
+export declare const STALE_SESSION_THRESHOLD_MS: number;
+/**
+ * Returns true when the session's last interaction exceeds the stale threshold.
+ */
+export declare function isStale(lastInteractionTime: string | undefined): boolean;
+/**
+ * Normalize session state after loading from disk.
+ * Migrates legacy phase values and deprecated transcript fields.
+ */
+export declare function normalizeAfterLoad(state: {
+    phase?: string;
+    checkpointTranscriptStart?: number;
+    condensedTranscriptLines?: number;
+    transcriptLinesAtStart?: number;
+    attributionBaseCommit?: string;
+    baseCommit?: string;
+}): void;
+/**
+ * Generate a Mermaid state diagram from the transition table.
+ */
+export declare function mermaidDiagram(): string;
+//# sourceMappingURL=state-machine.d.ts.map

package/dist/session/state-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.d.ts","sourceRoot":"","sources":["../../src/session/state-machine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,MAAM,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAEhD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,CAa5D;AAMD,0BAAkB,iBAAiB;IACjC,SAAS,IAAI;IACb,OAAO,IAAI;IACX,SAAS,IAAI;IACb,YAAY,IAAI;IAChB,WAAW,IAAI;IACf,UAAU,IAAI;CACf;AAWD,wBAAgB,aAAa,CAAC,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAiB1D;AAMD,0BAAkB,MAAM;IACtB,QAAQ,IAAI;IACZ,sBAAsB,IAAI;IAC1B,gBAAgB,IAAI;IACpB,gBAAgB,IAAI;IACpB,YAAY,IAAI;IAChB,qBAAqB,IAAI;CAC1B;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAiBhD;AAMD,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,OAAO,CAAC;IACzB,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,KAAK,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAMD,wBAAgB,UAAU,CACxB,OAAO,EAAE,KAAK,EACd,KAAK,EAAE,iBAAiB,EACxB,GAAG,EAAE,iBAAiB,GACrB,gBAAgB,CAalB;AAqHD,MAAM,WAAW,aAAa;IAC5B,cAAc,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,4BAA4B,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,sBAAsB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,sBAAsB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjE;AAED,qBAAa,iBAAkB,YAAW,aAAa;IAC/C,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAC/B,4BAA4B,IAAI,OAAO,CAAC,IAAI,CAAC;IAC7C,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IACvC,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;CAC9C;AAMD,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;IACb,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAqDvB;AAMD,kEAAkE;AAClE,eAAO,MAAM,0BAA0B,QAA0B,CAAC;AAElE;;GAEG;AACH,wBAAgB,OAAO,CAAC,mBAAmB,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAGxE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,IAAI,CAoBP;AAQD;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CA4CvC"}