cognitive-core 0.2.1 → 0.2.3

package/references/sessionlog/src/index.ts

@@ -1,650 +0,0 @@
-/**
- * Sessionlog - Native TypeScript Implementation
- *
- * A self-contained module that implements the Sessionlog 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') as { version: string };
-
-/** Current package version */
-export { VERSION };
-
-/**
- * Get the current version string.
- */
-export function getVersion(): string {
-  return VERSION;
-}
-
-// =============================================================================
-// Core Types
-// =============================================================================
-
-export type {
-  AgentName,
-  AgentType,
-  HookType,
-  HookInput,
-  Event,
-  SessionPhase,
-  SessionState,
-  PromptAttribution,
-  TokenUsage,
-  TrackedTask,
-  TrackedSkill,
-  PlanEntry,
-  CheckpointID,
-  Checkpoint,
-  CheckpointSummary,
-  CommittedMetadata,
-  SessionFilePaths,
-  Summary,
-  LearningsSummary,
-  CodeLearning,
-  InitialAttribution,
-  RewindPoint,
-  WriteTemporaryOptions,
-  WriteTemporaryResult,
-  WriteCommittedOptions,
-  UpdateCommittedOptions,
-  SessionChange,
-  SessionlogSettings,
-} from './types.js';
-
-export {
-  AGENT_NAMES,
-  AGENT_TYPES,
-  DEFAULT_AGENT_NAME,
-  EventType,
-  CheckpointType,
-  CHECKPOINT_ID_LENGTH,
-  CHECKPOINT_ID_PATTERN,
-  CHECKPOINTS_BRANCH,
-  SHADOW_BRANCH_PREFIX,
-  SESSIONLOG_DIR,
-  SESSIONLOG_METADATA_DIR,
-  SESSIONLOG_TMP_DIR,
-  SESSIONLOG_SETTINGS_FILE,
-  SESSIONLOG_SETTINGS_LOCAL_FILE,
-  SESSIONLOG_EVENTS_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,
-  type GitAuthor,
-  type GitExecOptions,
-} from './git-operations.js';
-
-// =============================================================================
-// Session Store
-// =============================================================================
-
-export {
-  createSessionStore,
-  normalizeSessionState,
-  type SessionStore,
-} from './store/session-store.js';
-
-// =============================================================================
-// Checkpoint Store
-// =============================================================================
-
-export { createCheckpointStore, type CheckpointStore } from './store/checkpoint-store.js';
-
-// =============================================================================
-// Native Store (replaces CLI store)
-// =============================================================================
-
-export { createNativeSessionlogStore } from './store/native-store.js';
-
-export type {
-  SessionlogStore,
-  SessionlogSession,
-  SessionlogCheckpoint,
-  SessionlogTokenUsage,
-  SessionlogSkillUsage,
-} from './store/provider-types.js';
-
-// =============================================================================
-// Agent System
-// =============================================================================
-
-export type {
-  Agent,
-  HookSupport,
-  FileWatcher,
-  TranscriptAnalyzer,
-  TokenCalculator,
-  TranscriptChunker,
-  TranscriptPreparer,
-  SubagentAwareExtractor,
-  SessionChangeEvent,
-} from './agent/types.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,
-  type AgentFactory,
-} from './agent/registry.js';
-
-// Agent Implementations
-export {
-  createClaudeCodeAgent,
-  parseTranscript,
-  extractModifiedFiles,
-  extractLastUserPrompt,
-  extractSpawnedAgentIDs,
-  type TranscriptLine,
-  type AssistantContent,
-} from './agent/agents/claude-code.js';
-
-export { createCursorAgent } from './agent/agents/cursor.js';
-
-export {
-  createGeminiCLIAgent,
-  type GeminiTranscript,
-  type GeminiMessage,
-  type GeminiToolCall,
-} from './agent/agents/gemini-cli.js';
-
-export {
-  createOpenCodeAgent,
-  extractTextFromParts,
-  parseExportSession,
-  extractAllUserPrompts,
-  type ExportSession,
-  type ExportMessage,
-  type SessionInfo as OpenCodeSessionInfo,
-  type Part as OpenCodePart,
-  type ToolState as OpenCodeToolState,
-} from './agent/agents/opencode.js';
-
-// =============================================================================
-// Hooks
-// =============================================================================
-
-export {
-  installGitHooks,
-  uninstallGitHooks,
-  areGitHooksInstalled,
-  type GitHookName,
-} from './hooks/git-hooks.js';
-
-export {
-  createLifecycleHandler,
-  type LifecycleConfig,
-  type LifecycleHandler,
-} 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, type EnableOptions, type EnableResult } from './commands/enable.js';
-
-export { disable, type DisableOptions, type DisableResult } from './commands/disable.js';
-
-export {
-  status,
-  formatStatusJSON,
-  formatTokens,
-  type StatusResult,
-  type SessionStatus,
-} from './commands/status.js';
-
-export {
-  listRewindPoints,
-  rewindTo,
-  listRewindPointsJSON,
-  type RewindOptions,
-  type RewindResult,
-} from './commands/rewind.js';
-
-export {
-  diagnose,
-  discardSession,
-  doctor,
-  type StuckSession,
-  type DoctorResult,
-  type DoctorOptions,
-} from './commands/doctor.js';
-
-export {
-  findOrphaned,
-  clean,
-  type CleanupItem,
-  type CleanResult,
-  type CleanOptions,
-} from './commands/clean.js';
-
-export { reset, type ResetOptions, type ResetResult } from './commands/reset.js';
-
-export {
-  setupCcweb,
-  type SetupCcwebOptions,
-  type SetupCcwebResult,
-} from './commands/setup-ccweb.js';
-
-export {
-  listCheckpoints,
-  getCheckpointDetail,
-  getCheckpointTranscript,
-  explainCommit,
-  findCheckpointByPrefix,
-  type CheckpointDetail,
-  type CheckpointListItem,
-  type ExplainOptions,
-  type CommitExplainResult,
-} from './commands/explain.js';
-
-export {
-  discoverResumeInfo,
-  listResumableBranches,
-  type ResumeInfo,
-  type ResumeOptions,
-  type ResumeResult,
-} from './commands/resume.js';
-
-// =============================================================================
-// Strategy Engine
-// =============================================================================
-
-export {
-  createManualCommitStrategy,
-  hasUserContent,
-  stripCheckpointTrailer,
-  type ManualCommitStrategyConfig,
-} from './strategy/manual-commit.js';
-
-export type { Strategy, OrphanedItem, OrphanedItemType } from './strategy/types.js';
-
-// =============================================================================
-// Event Log
-// =============================================================================
-
-export {
-  appendCheckpointEvent,
-  readCheckpointEvents,
-  type CheckpointEvent,
-  type EventLogOptions,
-} from './events/event-log.js';
-
-export { STRATEGY_NAME_MANUAL_COMMIT, MAX_COMMIT_TRAVERSAL_DEPTH } from './strategy/types.js';
-
-// =============================================================================
-// Wire Format Types (for external consumers)
-// =============================================================================
-
-export type {
-  SessionSyncCheckpoint,
-  SessionSyncTokenUsage,
-  SessionSyncSummary,
-  SessionSyncAttribution,
-} from './wire-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,
-  type TranscriptLine as ParsedTranscriptLine,
-} from './utils/transcript-parse.js';
-
-export { generateCommitMessage } from './utils/commit-message.js';
-
-// =============================================================================
-// Summarization
-// =============================================================================
-
-export {
-  buildCondensedTranscriptFromBytes,
-  buildCondensedTranscript,
-  formatCondensedTranscript,
-  buildSummarizationPrompt,
-  extractJSONFromMarkdown,
-  generateFromTranscript,
-  type Entry as SummarizeEntry,
-  type EntryType as SummarizeEntryType,
-  type SummarizeInput,
-  type SummaryGenerator,
-} 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, type HookManager } 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,
-  type ClaudeGeneratorOptions,
-} from './summarize/claude-generator.js';
-
-// =============================================================================
-// Session State Machine
-// =============================================================================
-
-export {
-  transition,
-  applyTransition,
-  phaseFromString,
-  eventToString,
-  actionToString,
-  isStale,
-  normalizeAfterLoad,
-  mermaidDiagram,
-  NoOpActionHandler,
-  STALE_SESSION_THRESHOLD_MS,
-  StateMachineEvent,
-  Action,
-} from './session/state-machine.js';
-
-export type {
-  Phase,
-  TransitionContext,
-  TransitionResult,
-  ActionHandler,
-  StateMachineState,
-} 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';
-
-export type { SessionRestoreInfo as RewindSessionRestoreInfo } from './utils/rewind-conflict.js';
-
-// =============================================================================
-// Chunk File Naming
-// =============================================================================
-
-export { chunkFileName, parseChunkIndex, sortChunkFiles } from './utils/chunk-files.js';
-
-// =============================================================================
-// Path Classification
-// =============================================================================
-
-export {
-  isInfrastructurePath,
-  toRelativePath,
-  normalizeStoredPath,
-  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,
-  type RewindPreview as RewindPreviewResult,
-} from './utils/preview-rewind.js';
-
-// =============================================================================
-// Normalized Agent Session
-// =============================================================================
-
-export { createAgentSession, EntryType } from './agent/session-types.js';
-
-export type { AgentSession, SessionEntry } 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, MergeMode } from './utils/tree-ops.js';
-
-export type { TreeEntry, TreeChange } from './utils/tree-ops.js';