cognitive-core 0.2.1 → 0.2.3

package/references/sessionlog/src/config.ts

@@ -1,165 +0,0 @@
-/**
- * Configuration Management
- *
- * Loads and manages Sessionlog settings from .sessionlog/settings.json
- * and .sessionlog/settings.local.json (local overrides).
- */
-
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import {
-  type SessionlogSettings,
-  DEFAULT_SETTINGS,
-} from './types.js';
-import { getWorktreeRoot } from './git-operations.js';
-import { atomicWriteFile } from './git-operations.js';
-
-/**
- * Resolve the sessionlog directory for a given repo root.
- * Priority: SESSIONLOG_PROJECT_DIR env var > .swarm/sessionlog exists > .sessionlog
- */
-export function resolveSessionlogDir(root: string): string {
-  const envDir = process.env.SESSIONLOG_PROJECT_DIR;
-  if (envDir) return path.join(root, envDir);
-  const swarmDir = path.join(root, '.swarm', 'sessionlog');
-  if (fs.existsSync(swarmDir)) return swarmDir;
-  return path.join(root, '.sessionlog');
-}
-
-// ============================================================================
-// Load Settings
-// ============================================================================
-
-/**
- * Load effective settings (project merged with local overrides)
- */
-export async function loadSettings(cwd?: string): Promise<SessionlogSettings> {
-  const project = await loadProjectSettings(cwd);
-  const local = await loadLocalSettings(cwd);
-  return mergeSettings(project, local);
-}
-
-/**
- * Load project-level settings (settings.json inside resolved sessionlog dir)
- */
-export async function loadProjectSettings(cwd?: string): Promise<SessionlogSettings> {
-  const root = cwd ?? (await getWorktreeRoot());
-  const settingsPath = path.join(resolveSessionlogDir(root), 'settings.json');
-  return loadSettingsFile(settingsPath);
-}
-
-/**
- * Load local settings (settings.local.json inside resolved sessionlog dir)
- */
-export async function loadLocalSettings(cwd?: string): Promise<SessionlogSettings> {
-  const root = cwd ?? (await getWorktreeRoot());
-  const settingsPath = path.join(resolveSessionlogDir(root), 'settings.local.json');
-  return loadSettingsFile(settingsPath);
-}
-
-function loadSettingsFile(filePath: string): SessionlogSettings {
-  try {
-    const content = fs.readFileSync(filePath, 'utf-8');
-    const data = JSON.parse(content) as Partial<SessionlogSettings>;
-    return { ...DEFAULT_SETTINGS, ...data };
-  } catch {
-    return { ...DEFAULT_SETTINGS };
-  }
-}
-
-function mergeSettings(project: SessionlogSettings, local: SessionlogSettings): SessionlogSettings {
-  return {
-    enabled: local.enabled !== DEFAULT_SETTINGS.enabled ? local.enabled : project.enabled,
-    strategy: local.strategy !== DEFAULT_SETTINGS.strategy ? local.strategy : project.strategy,
-    logLevel: local.logLevel ?? project.logLevel,
-    skipPushSessions: local.skipPushSessions ?? project.skipPushSessions,
-    telemetryEnabled: local.telemetryEnabled ?? project.telemetryEnabled,
-    summarizationEnabled: local.summarizationEnabled ?? project.summarizationEnabled,
-    sessionRepoPath: local.sessionRepoPath ?? project.sessionRepoPath,
-  };
-}
-
-// ============================================================================
-// Save Settings
-// ============================================================================
-
-/**
- * Save project-level settings
- */
-export async function saveProjectSettings(
-  settings: Partial<SessionlogSettings>,
-  cwd?: string,
-): Promise<void> {
-  const root = cwd ?? (await getWorktreeRoot());
-  const sessionlogDir = resolveSessionlogDir(root);
-  const settingsPath = path.join(sessionlogDir, 'settings.json');
-  await ensureSessionlogDir(root);
-  await atomicWriteFile(settingsPath, JSON.stringify(settings, null, 2));
-}
-
-/**
- * Save local settings
- */
-export async function saveLocalSettings(
-  settings: Partial<SessionlogSettings>,
-  cwd?: string,
-): Promise<void> {
-  const root = cwd ?? (await getWorktreeRoot());
-  const sessionlogDir = resolveSessionlogDir(root);
-  const settingsPath = path.join(sessionlogDir, 'settings.local.json');
-  await ensureSessionlogDir(root);
-  await atomicWriteFile(settingsPath, JSON.stringify(settings, null, 2));
-}
-
-// ============================================================================
-// Queries
-// ============================================================================
-
-/**
- * Check if Sessionlog is enabled in the current repository
- */
-export async function isEnabled(cwd?: string): Promise<boolean> {
-  const settings = await loadSettings(cwd);
-  return settings.enabled;
-}
-
-/**
- * Get the current strategy name
- */
-export async function getStrategy(cwd?: string): Promise<string> {
-  const settings = await loadSettings(cwd);
-  return settings.strategy;
-}
-
-// ============================================================================
-// Helpers
-// ============================================================================
-
-async function ensureSessionlogDir(root: string): Promise<void> {
-  const dir = resolveSessionlogDir(root);
-  await fs.promises.mkdir(dir, { recursive: true });
-}
-
-/**
- * Ensure the .sessionlog directory is gitignored for local files
- */
-export async function ensureGitignore(cwd?: string): Promise<void> {
-  const root = cwd ?? (await getWorktreeRoot());
-  const gitignorePath = path.join(resolveSessionlogDir(root), '.gitignore');
-
-  const content = [
-    '# Sessionlog local files (not committed)',
-    'settings.local.json',
-    'tmp/',
-    'logs/',
-    '',
-  ].join('\n');
-
-  try {
-    await fs.promises.access(gitignorePath);
-    // Already exists
-  } catch {
-    await ensureSessionlogDir(root);
-    await fs.promises.writeFile(gitignorePath, content);
-  }
-}

package/references/sessionlog/src/events/event-log.ts

@@ -1,126 +0,0 @@
-/**
- * Event Log
- *
- * Appends checkpoint events to a JSONL file (.sessionlog/events.jsonl)
- * for consumption by external systems (e.g., MAP session sync).
- *
- * Sessionlog runs as standalone git hooks (separate processes), so
- * in-process callbacks don't work across process boundaries. This
- * file-based event log bridges that gap.
- */
-
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import { SESSIONLOG_EVENTS_FILE } from '../types.js';
-import type { TokenUsage } from '../types.js';
-import { atomicWriteFile } from '../git-operations.js';
-
-// ============================================================================
-// Types
-// ============================================================================
-
-/** Event written to the JSONL log after a checkpoint is committed. */
-export interface CheckpointEvent {
-  type: 'checkpoint_committed';
-  timestamp: string;
-  checkpointID: string;
-  sessionID: string;
-  agent: string;
-  branch?: string;
-  filesTouched: string[];
-  checkpointsCount: number;
-  tokenUsage?: TokenUsage;
-}
-
-export interface EventLogOptions {
-  /** Keep only the last N events. 0 or undefined means keep all. */
-  maxEvents?: number;
-}
-
-// ============================================================================
-// Write
-// ============================================================================
-
-/**
- * Append a checkpoint event to the event log file and optionally prune.
- *
- * @param cwd - Repository root directory
- * @param event - The checkpoint event to record
- * @param opts - Optional retention settings
- */
-export async function appendCheckpointEvent(
-  cwd: string,
-  event: CheckpointEvent,
-  opts?: EventLogOptions,
-): Promise<void> {
-  const filePath = path.join(cwd, SESSIONLOG_EVENTS_FILE);
-  const line = JSON.stringify(event) + '\n';
-
-  // Ensure directory exists
-  const dir = path.dirname(filePath);
-  await fs.promises.mkdir(dir, { recursive: true });
-
-  // Append the new event
-  await fs.promises.appendFile(filePath, line, 'utf-8');
-
-  // Prune if maxEvents is configured
-  const maxEvents = opts?.maxEvents;
-  if (maxEvents && maxEvents > 0) {
-    await pruneEventLog(filePath, maxEvents);
-  }
-}
-
-// ============================================================================
-// Read
-// ============================================================================
-
-/**
- * Read all checkpoint events from the event log file.
- *
- * @param cwd - Repository root directory
- * @returns Array of events in chronological order (oldest first)
- */
-export function readCheckpointEvents(cwd: string): CheckpointEvent[] {
-  const filePath = path.join(cwd, SESSIONLOG_EVENTS_FILE);
-
-  let content: string;
-  try {
-    content = fs.readFileSync(filePath, 'utf-8');
-  } catch {
-    return [];
-  }
-
-  const events: CheckpointEvent[] = [];
-  for (const line of content.split('\n')) {
-    const trimmed = line.trim();
-    if (!trimmed) continue;
-    try {
-      events.push(JSON.parse(trimmed) as CheckpointEvent);
-    } catch {
-      // Skip malformed lines
-    }
-  }
-  return events;
-}
-
-// ============================================================================
-// Prune
-// ============================================================================
-
-/**
- * Trim the event log to the last N entries.
- */
-async function pruneEventLog(filePath: string, maxEvents: number): Promise<void> {
-  let content: string;
-  try {
-    content = await fs.promises.readFile(filePath, 'utf-8');
-  } catch {
-    return;
-  }
-
-  const lines = content.split('\n').filter((l) => l.trim().length > 0);
-  if (lines.length <= maxEvents) return;
-
-  const kept = lines.slice(-maxEvents);
-  await atomicWriteFile(filePath, kept.join('\n') + '\n');
-}