cognitive-core 0.2.1 → 0.2.3

package/references/sessionlog/src/utils/hook-managers.ts

@@ -1,125 +0,0 @@
-/**
- * Hook Manager Detection
- *
- * Detects third-party git hook managers (Husky, Lefthook, pre-commit,
- * Overcommit) in a repository and generates conflict warnings.
- */
-
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-
-// ============================================================================
-// Types
-// ============================================================================
-
-export interface HookManager {
-  /** Name of the hook manager (e.g., "Husky", "Lefthook") */
-  name: string;
-  /** Relative path that triggered detection (e.g., ".husky/") */
-  configPath: string;
-  /** Whether the tool will overwrite Sessionlog's hooks on reinstall */
-  overwritesHooks: boolean;
-}
-
-// ============================================================================
-// Detection
-// ============================================================================
-
-/**
- * Detect third-party hook managers in a repository.
- * Detection is filesystem-only (stat checks, no file reads).
- */
-export function detectHookManagers(repoRoot: string): HookManager[] {
-  const checks: HookManager[] = [
-    { name: 'Husky', configPath: '.husky/', overwritesHooks: true },
-    { name: 'pre-commit', configPath: '.pre-commit-config.yaml', overwritesHooks: false },
-    { name: 'Overcommit', configPath: '.overcommit.yml', overwritesHooks: false },
-  ];
-
-  // Lefthook supports {.,}lefthook{,-local}.{yml,yaml,json,toml}
-  for (const prefix of ['', '.']) {
-    for (const variant of ['', '-local']) {
-      for (const ext of ['yml', 'yaml', 'json', 'toml']) {
-        const name = `${prefix}lefthook${variant}.${ext}`;
-        checks.push({ name: 'Lefthook', configPath: name, overwritesHooks: false });
-      }
-    }
-  }
-
-  const seen = new Set<string>();
-  const managers: HookManager[] = [];
-
-  for (const check of checks) {
-    const fullPath = path.join(repoRoot, check.configPath);
-    try {
-      fs.statSync(fullPath);
-      if (seen.has(check.name)) continue;
-      seen.add(check.name);
-      managers.push(check);
-    } catch {
-      // Not found
-    }
-  }
-
-  return managers;
-}
-
-// ============================================================================
-// Warning Generation
-// ============================================================================
-
-/**
- * Build a warning string for detected hook managers.
- */
-export function hookManagerWarning(
-  managers: HookManager[],
-  sessionlogExecutable = 'sessionlog',
-): string {
-  if (managers.length === 0) return '';
-
-  const lines: string[] = [];
-
-  for (const m of managers) {
-    if (m.overwritesHooks) {
-      lines.push(`Warning: ${m.name} detected (${m.configPath})`);
-      lines.push('');
-      lines.push(`  ${m.name} may overwrite hooks installed by Sessionlog on npm install.`);
-      lines.push(
-        `  To make Sessionlog hooks permanent, add these lines to your ${m.name} hook files:`,
-      );
-      lines.push('');
-
-      const hookDir = m.configPath;
-      const hooks = [
-        {
-          name: 'prepare-commit-msg',
-          cmd: `${sessionlogExecutable} hooks git prepare-commit-msg "$1" "$2" 2>/dev/null || true`,
-        },
-        { name: 'commit-msg', cmd: `${sessionlogExecutable} hooks git commit-msg "$1" || exit 1` },
-        {
-          name: 'post-commit',
-          cmd: `${sessionlogExecutable} hooks git post-commit 2>/dev/null || true`,
-        },
-        {
-          name: 'pre-push',
-          cmd: `${sessionlogExecutable} hooks git pre-push "$@" 2>/dev/null || true`,
-        },
-      ];
-
-      for (const hook of hooks) {
-        lines.push(`    ${hookDir}${hook.name}:`);
-        lines.push(`      ${hook.cmd}`);
-        lines.push('');
-      }
-    } else {
-      lines.push(`Note: ${m.name} detected (${m.configPath})`);
-      lines.push('');
-      lines.push(
-        `  If ${m.name} reinstalls hooks, run 'sessionlog enable' to restore Sessionlog's hooks.`,
-      );
-      lines.push('');
-    }
-  }
-
-  return lines.join('\n');
-}

package/references/sessionlog/src/utils/ide-tags.ts

@@ -1,32 +0,0 @@
-/**
- * IDE Tag Stripping
- *
- * Removes IDE-injected context tags from prompt text.
- * These tags are added by IDEs (VSCode, Cursor) and system infrastructure
- * and shouldn't appear in user-facing text.
- */
-
-// IDE context tags: <ide_opened_file>...</ide_opened_file>, <ide_selection>...</ide_selection>
-const ideContextTagRegex = /<ide_[^>]*>[\s\S]*?<\/ide_[^>]*>/g;
-
-// System-injected tags
-const systemTagRegexes = [
-  /<local-command-caveat[^>]*>[\s\S]*?<\/local-command-caveat>/g,
-  /<system-reminder[^>]*>[\s\S]*?<\/system-reminder>/g,
-  /<command-name[^>]*>[\s\S]*?<\/command-name>/g,
-  /<command-message[^>]*>[\s\S]*?<\/command-message>/g,
-  /<command-args[^>]*>[\s\S]*?<\/command-args>/g,
-  /<local-command-stdout[^>]*>[\s\S]*?<\/local-command-stdout>/g,
-  /<\/?user_query>/g, // Cursor wraps user text in <user_query> tags; strip tags but keep content
-];
-
-/**
- * Strip IDE-injected context tags from prompt text.
- */
-export function stripIDEContextTags(text: string): string {
-  let result = text.replace(ideContextTagRegex, '');
-  for (const re of systemTagRegexes) {
-    result = result.replace(re, '');
-  }
-  return result.trim();
-}

package/references/sessionlog/src/utils/paths.ts

@@ -1,79 +0,0 @@
-/**
- * Path Classification Helpers
- *
- * Utilities for classifying and normalizing paths within the Sessionlog system.
- *
- * Ported from Go: paths/paths.go
- */
-
-import * as path from 'node:path';
-
-/** All possible sessionlog directory locations (relative paths) */
-const SESSIONLOG_DIRS = ['.sessionlog', '.swarm/sessionlog'];
-
-/**
- * Returns true if the path is part of Sessionlog's infrastructure
- * (i.e., inside a `.sessionlog/` or `.swarm/sessionlog/` directory).
- */
-export function isInfrastructurePath(filePath: string): boolean {
-  const normalized = filePath.replace(/\\/g, '/');
-  return SESSIONLOG_DIRS.some(
-    (dir) => normalized === dir || normalized.startsWith(dir + '/'),
-  );
-}
-
-/**
- * Converts an absolute path to a repository-relative path.
- * Returns empty string if the path is outside the working directory.
- */
-export function toRelativePath(absPath: string, cwd: string): string {
-  if (!path.isAbsolute(absPath)) return absPath;
-
-  const relPath = path.relative(cwd, absPath);
-  if (relPath.startsWith('..')) return '';
-
-  return relPath;
-}
-
-/**
- * Normalizes a path for storage: converts to CWD-relative when inside the
- * working directory, keeps absolute otherwise.
- *
- * Examples (cwd = /Users/alex/project):
- *   /Users/alex/project/src/app.ts  →  src/app.ts
- *   /Users/alex/.claude/plans/p.md  →  /Users/alex/.claude/plans/p.md  (outside CWD)
- *   src/app.ts                      →  src/app.ts  (already relative)
- */
-export function normalizeStoredPath(filePath: string, cwd: string): string {
-  if (!path.isAbsolute(filePath)) return filePath;
-  const relPath = path.relative(cwd, filePath);
-  if (relPath.startsWith('..')) return filePath;
-  return relPath;
-}
-
-/**
- * Returns the absolute path for a relative path within the repository.
- * If the path is already absolute, it is returned as-is.
- */
-export function absPath(relPath: string, repoRoot: string): string {
-  if (path.isAbsolute(relPath)) return relPath;
-  return path.join(repoRoot, relPath);
-}
-
-/**
- * Extract the session ID from a transcript file path.
- * Expects paths like `/path/to/<sessionID>.jsonl` or `/path/to/<sessionID>.json`.
- */
-export function extractSessionIDFromPath(transcriptPath: string): string {
-  const base = path.basename(transcriptPath);
-  // Remove extension (.jsonl, .json, etc.)
-  const dotIndex = base.indexOf('.');
-  return dotIndex > 0 ? base.slice(0, dotIndex) : base;
-}
-
-/**
- * Returns the session metadata directory path for a given session ID.
- */
-export function sessionMetadataDir(metadataRoot: string, sessionID: string): string {
-  return path.join(metadataRoot, 'sessions', sessionID);
-}

package/references/sessionlog/src/utils/preview-rewind.ts

@@ -1,80 +0,0 @@
-/**
- * Rewind Preview
- *
- * Preview what files would change when rewinding to a checkpoint.
- * Shows files that would be restored and untracked files that would be deleted.
- *
- * Ported from Go: strategy/manual_commit_rewind.go
- */
-
-import { getHead, lsTree, getUntrackedFiles } from '../git-operations.js';
-import { isInfrastructurePath } from './paths.js';
-
-export interface RewindPreview {
-  filesToRestore: string[];
-  filesToDelete: string[];
-}
-
-/**
- * Preview what will happen when rewinding to the given commit.
- *
- * Returns the list of files that would be restored from the checkpoint
- * and untracked files that would be deleted.
- *
- * For logs-only rewind points, returns empty arrays since the working
- * directory is not modified.
- */
-export async function previewRewind(
-  commitHash: string,
-  isLogsOnly: boolean,
-  preservedUntrackedFiles?: string[],
-  cwd?: string,
-): Promise<RewindPreview> {
-  // Logs-only points don't modify the working directory
-  if (isLogsOnly) {
-    return { filesToRestore: [], filesToDelete: [] };
-  }
-
-  // Get files in the checkpoint tree (excluding infrastructure)
-  const checkpointEntries = await lsTree(commitHash, undefined, cwd);
-  const checkpointFiles = new Set<string>();
-  const filesToRestore: string[] = [];
-
-  for (const entry of checkpointEntries) {
-    if (!isInfrastructurePath(entry.name)) {
-      checkpointFiles.add(entry.name);
-      filesToRestore.push(entry.name);
-    }
-  }
-
-  // Get HEAD tree to identify tracked files
-  const headHash = await getHead(cwd);
-  const headEntries = await lsTree(headHash, undefined, cwd);
-  const trackedFiles = new Set<string>();
-  for (const entry of headEntries) {
-    trackedFiles.add(entry.name);
-  }
-
-  // Build set of preserved untracked files
-  const preserved = new Set(preservedUntrackedFiles ?? []);
-
-  // Find untracked files that would be deleted
-  const untrackedNow = await getUntrackedFiles(cwd);
-  const filesToDelete: string[] = [];
-
-  for (const relPath of untrackedNow) {
-    // Skip if file exists in the checkpoint
-    if (checkpointFiles.has(relPath)) continue;
-    // Skip if file is tracked in HEAD
-    if (trackedFiles.has(relPath)) continue;
-    // Skip if file was preserved from session start
-    if (preserved.has(relPath)) continue;
-
-    filesToDelete.push(relPath);
-  }
-
-  filesToRestore.sort();
-  filesToDelete.sort();
-
-  return { filesToRestore, filesToDelete };
-}

package/references/sessionlog/src/utils/rewind-conflict.ts

@@ -1,121 +0,0 @@
-/**
- * Rewind Conflict Detection
- *
- * Utilities for detecting timestamp conflicts when restoring session logs
- * from checkpoints. Prevents silent overwrites of newer local transcripts.
- *
- * Ported from Go: strategy/manual_commit_rewind.go
- */
-
-// ============================================================================
-// Types
-// ============================================================================
-
-export const enum SessionRestoreStatus {
-  /** Local file doesn't exist */
-  New = 0,
-  /** Local and checkpoint are the same */
-  Unchanged = 1,
-  /** Checkpoint has newer entries */
-  CheckpointNewer = 2,
-  /** Local has newer entries (conflict) */
-  LocalNewer = 3,
-}
-
-export interface SessionRestoreInfo {
-  sessionID: string;
-  prompt: string;
-  status: SessionRestoreStatus;
-  localTime: Date;
-  checkpointTime: Date;
-}
-
-// ============================================================================
-// Classification
-// ============================================================================
-
-/**
- * Determine the restore status based on local and checkpoint timestamps.
- */
-export function classifyTimestamps(
-  localTime: Date | null,
-  checkpointTime: Date | null,
-): SessionRestoreStatus {
-  // Local file doesn't exist
-  if (!localTime || localTime.getTime() === 0) {
-    return SessionRestoreStatus.New;
-  }
-
-  // Can't determine checkpoint time
-  if (!checkpointTime || checkpointTime.getTime() === 0) {
-    return SessionRestoreStatus.New;
-  }
-
-  if (localTime.getTime() > checkpointTime.getTime()) {
-    return SessionRestoreStatus.LocalNewer;
-  }
-  if (checkpointTime.getTime() > localTime.getTime()) {
-    return SessionRestoreStatus.CheckpointNewer;
-  }
-  return SessionRestoreStatus.Unchanged;
-}
-
-/**
- * Returns a human-readable status string.
- */
-export function statusToText(status: SessionRestoreStatus): string {
-  switch (status) {
-    case SessionRestoreStatus.New:
-      return '(new)';
-    case SessionRestoreStatus.Unchanged:
-      return '(unchanged)';
-    case SessionRestoreStatus.CheckpointNewer:
-      return '(checkpoint is newer)';
-    case SessionRestoreStatus.LocalNewer:
-      return '(local is newer)';
-    default:
-      return '';
-  }
-}
-
-/**
- * Check if any sessions have conflicts (local is newer than checkpoint).
- */
-export function hasConflicts(sessions: SessionRestoreInfo[]): boolean {
-  return sessions.some((s) => s.status === SessionRestoreStatus.LocalNewer);
-}
-
-/**
- * Separate sessions into conflicting and non-conflicting lists.
- */
-export function partitionConflicts(sessions: SessionRestoreInfo[]): {
-  conflicting: SessionRestoreInfo[];
-  nonConflicting: SessionRestoreInfo[];
-} {
-  const conflicting: SessionRestoreInfo[] = [];
-  const nonConflicting: SessionRestoreInfo[] = [];
-  for (const s of sessions) {
-    if (s.status === SessionRestoreStatus.LocalNewer) {
-      conflicting.push(s);
-    } else {
-      nonConflicting.push(s);
-    }
-  }
-  return { conflicting, nonConflicting };
-}
-
-// ============================================================================
-// Agent Resolution
-// ============================================================================
-
-import type { Agent } from '../agent/types.js';
-import { getAgentByType } from '../agent/registry.js';
-import type { AgentType } from '../types.js';
-
-/**
- * Resolve the agent from checkpoint metadata agent type string.
- * Returns null if the agent type is not registered.
- */
-export function resolveAgentForRewind(agentType: AgentType): Agent | null {
-  return getAgentByType(agentType);
-}

package/references/sessionlog/src/utils/shadow-branch.ts

@@ -1,109 +0,0 @@
-/**
- * Shadow Branch Utilities
- *
- * Standalone utilities for shadow branch name generation, parsing,
- * and classification. Extracted from checkpoint-store.ts for reuse.
- *
- * Ported from Go: checkpoint/temporary.go, strategy/cleanup.go
- */
-
-import * as crypto from 'node:crypto';
-import { SHADOW_BRANCH_PREFIX, SHADOW_BRANCH_HASH_LENGTH, CHECKPOINTS_BRANCH } from '../types.js';
-import { listBranches, deleteBranch } from '../git-operations.js';
-
-/** Worktree ID hash length (6 hex characters) */
-const WORKTREE_ID_HASH_LENGTH = 6;
-
-/** Pattern for shadow branches: sessionlog/<hex7+>(-<hex6+>)? */
-const SHADOW_BRANCH_PATTERN = new RegExp(
-  `^${SHADOW_BRANCH_PREFIX.replace('/', '\\/')}[0-9a-f]{${SHADOW_BRANCH_HASH_LENGTH},}(-[0-9a-f]{${WORKTREE_ID_HASH_LENGTH},})?$`,
-);
-
-/**
- * Hash a worktree identifier to a short hex string.
- */
-export function hashWorktreeID(worktreeID: string): string {
-  return crypto
-    .createHash('sha256')
-    .update(worktreeID)
-    .digest('hex')
-    .slice(0, WORKTREE_ID_HASH_LENGTH);
-}
-
-/**
- * Returns the shadow branch name for a base commit hash and worktree identifier.
- * Format: sessionlog/<commit[:7]>-<hash(worktreeID)[:6]>
- */
-export function shadowBranchNameForCommit(baseCommit: string, worktreeID?: string): string {
-  const commitPart = baseCommit.slice(0, SHADOW_BRANCH_HASH_LENGTH);
-  if (worktreeID) {
-    const worktreeHash = hashWorktreeID(worktreeID);
-    return `${SHADOW_BRANCH_PREFIX}${commitPart}-${worktreeHash}`;
-  }
-  return `${SHADOW_BRANCH_PREFIX}${commitPart}`;
-}
-
-/**
- * Parse a shadow branch name to extract commit prefix and worktree hash.
- * Returns null if the branch name doesn't match the shadow branch pattern.
- */
-export function parseShadowBranchName(
-  branchName: string,
-): { commitPrefix: string; worktreeHash: string } | null {
-  if (!branchName.startsWith(SHADOW_BRANCH_PREFIX)) return null;
-  if (branchName === CHECKPOINTS_BRANCH) return null;
-
-  const suffix = branchName.slice(SHADOW_BRANCH_PREFIX.length);
-  const lastDash = suffix.lastIndexOf('-');
-
-  if (lastDash === -1 || lastDash === 0 || lastDash === suffix.length - 1) {
-    // No dash or dash at boundary — old format with just commit prefix
-    return { commitPrefix: suffix, worktreeHash: '' };
-  }
-
-  return {
-    commitPrefix: suffix.slice(0, lastDash),
-    worktreeHash: suffix.slice(lastDash + 1),
-  };
-}
-
-/**
- * Returns true if the branch name matches the shadow branch pattern.
- * The "sessionlog/checkpoints/v1" branch is NOT a shadow branch.
- */
-export function isShadowBranch(branchName: string): boolean {
-  if (branchName === CHECKPOINTS_BRANCH) return false;
-  return SHADOW_BRANCH_PATTERN.test(branchName);
-}
-
-/**
- * List all shadow branches in the repository.
- * Returns an empty array if no shadow branches exist.
- */
-export async function listShadowBranches(cwd?: string): Promise<string[]> {
-  const allBranches = await listBranches(cwd);
-  return allBranches.filter(isShadowBranch);
-}
-
-/**
- * Delete the specified shadow branches from the repository.
- * Returns two arrays: successfully deleted and failed to delete.
- */
-export async function deleteShadowBranches(
-  branches: string[],
-  cwd?: string,
-): Promise<{ deleted: string[]; failed: string[] }> {
-  const deleted: string[] = [];
-  const failed: string[] = [];
-
-  for (const branch of branches) {
-    try {
-      await deleteBranch(branch, false, cwd);
-      deleted.push(branch);
-    } catch {
-      failed.push(branch);
-    }
-  }
-
-  return { deleted, failed };
-}

package/references/sessionlog/src/utils/string-utils.ts

@@ -1,46 +0,0 @@
-/**
- * String Utilities
- *
- * Rune-safe string operations for multi-byte character handling.
- */
-
-/**
- * Truncate a string to a maximum number of Unicode code points (runes).
- * Avoids splitting multi-byte UTF-8 characters.
- */
-export function truncateRunes(s: string, maxRunes: number, suffix: string = '...'): string {
-  const runes = [...s];
-  if (runes.length <= maxRunes) {
-    return s;
-  }
-  return runes.slice(0, maxRunes).join('') + suffix;
-}
-
-/**
- * Collapse all whitespace sequences (including newlines) to single spaces.
- */
-export function collapseWhitespace(s: string): string {
-  return s.replace(/\s+/g, ' ').trim();
-}
-
-/**
- * Capitalize the first character of a string.
- */
-export function capitalizeFirst(s: string): string {
-  if (s.length === 0) return s;
-  return s[0].toUpperCase() + s.slice(1);
-}
-
-/**
- * Count lines in a string.
- * Empty string = 0 lines. String without newline = 1 line.
- */
-export function countLines(content: string): number {
-  if (content === '') return 0;
-  let lines = 0;
-  for (let i = 0; i < content.length; i++) {
-    if (content[i] === '\n') lines++;
-  }
-  if (!content.endsWith('\n')) lines++;
-  return lines;
-}