@cleocode/core 2026.4.7 → 2026.4.11

package/dist/store/git-checkpoint.js

@@ -0,0 +1,365 @@
+/**
+ * Git checkpoint system for CLEO state files.
+ * Ported from lib/data/git-checkpoint.sh
+ *
+ * Opt-in automatic git commits of .cleo/ state files at semantic
+ * boundaries (save_json, session end) with debounce to prevent commit noise.
+ * All git errors are suppressed - checkpointing is never fatal.
+ *
+ * @task T4552
+ * @task T4872
+ * @epic T4545
+ */
+import { execFile } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { readFile, writeFile } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { promisify } from 'node:util';
+import { getCleoDir, getConfigPath } from '../paths.js';
+import { readJson } from './json.js';
+const execFileAsync = promisify(execFile);
+/**
+ * Build environment variables that point git at the isolated .cleo/.git repo.
+ * @task T4872
+ */
+export function makeCleoGitEnv(cleoDir) {
+    // resolve() ensures GIT_DIR and GIT_WORK_TREE are absolute even when cleoDir
+    // is a relative path (e.g. '.cleo' returned by getCleoDir() with no cwd arg)
+    const abs = resolve(cleoDir);
+    return {
+        ...process.env,
+        GIT_DIR: join(abs, '.git'),
+        GIT_WORK_TREE: abs,
+    };
+}
+/**
+ * Run a git command against the isolated .cleo/.git repo, suppressing errors.
+ * @task T4872
+ */
+export async function cleoGitCommand(args, cleoDir) {
+    try {
+        const result = await execFileAsync('git', args, {
+            cwd: resolve(cleoDir), // absolute cwd so relative paths in args resolve correctly
+            env: makeCleoGitEnv(cleoDir),
+            timeout: 10_000,
+        });
+        return { stdout: result.stdout.trim(), success: true };
+    }
+    catch {
+        return { stdout: '', success: false };
+    }
+}
+/**
+ * Check whether the isolated .cleo/.git repo has been initialized.
+ * @task T4872
+ */
+export function isCleoGitInitialized(cleoDir) {
+    return existsSync(join(cleoDir, '.git', 'HEAD'));
+}
+/**
+ * Core state files and directories eligible for checkpointing (relative to .cleo/).
+ *
+ * Only human-editable JSON config files (per ADR-006) and documentation
+ * output directories. All operational data lives in tasks.db (SQLite).
+ * tasks.db is excluded from git — backed up via VACUUM INTO rotation instead.
+ *
+ * Directory entries (trailing slash) are passed directly to git; git handles
+ * them recursively for add/diff/ls-files operations.
+ *
+ * Users can add custom entries via config.json `checkpoint.stateFileAllowlist`.
+ */
+const STATE_FILES = [
+    // Human-editable config files (ADR-006: JSON retained for human-editable config only)
+    'config.json',
+    'project-info.json',
+    'project-context.json',
+    // Architecture decisions and research outputs (docs, never in SQLite)
+    'adrs/',
+    'agent-outputs/',
+];
+/**
+ * Load additional state file paths from config.json `checkpoint.stateFileAllowlist`.
+ * Returns an empty array if config is missing, malformed, or the key is absent.
+ */
+export async function loadStateFileAllowlist(cwd) {
+    try {
+        const configPath = getConfigPath(cwd);
+        const config = await readJson(configPath);
+        const checkpoint = config?.checkpoint;
+        const allowlist = checkpoint?.stateFileAllowlist;
+        if (!Array.isArray(allowlist))
+            return [];
+        // Filter to strings only, ignore non-string entries
+        return allowlist.filter((entry) => typeof entry === 'string');
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Get the full list of state files: core defaults merged with config allowlist.
+ */
+async function getAllStateFiles(cwd) {
+    const custom = await loadStateFileAllowlist(cwd);
+    const all = [...STATE_FILES, ...custom];
+    // Deduplicate
+    return [...new Set(all)];
+}
+/** Debounce state file name (relative to .cleo/). */
+const CHECKPOINT_STATE_FILE = '.git-checkpoint-state';
+/**
+ * Load checkpoint configuration from config.json.
+ * @task T4552
+ */
+export async function loadCheckpointConfig(cwd) {
+    try {
+        const configPath = getConfigPath(cwd);
+        const config = await readJson(configPath);
+        const gc = config?.gitCheckpoint;
+        return {
+            enabled: gc?.enabled !== false,
+            debounceMinutes: typeof gc?.debounceMinutes === 'number' ? gc.debounceMinutes : 5,
+            messagePrefix: typeof gc?.messagePrefix === 'string' ? gc.messagePrefix : 'chore(cleo):',
+            noVerify: gc?.noVerify !== false,
+        };
+    }
+    catch {
+        return {
+            enabled: true,
+            debounceMinutes: 5,
+            messagePrefix: 'chore(cleo):',
+            noVerify: true,
+        };
+    }
+}
+/**
+ * Check if the isolated .cleo/.git repo is a valid git work tree.
+ * @task T4552
+ * @task T4872
+ */
+async function isCleoGitRepo(cleoDir) {
+    const result = await cleoGitCommand(['rev-parse', '--is-inside-work-tree'], cleoDir);
+    // On a freshly initialized empty repo, git returns "false" (no commits yet) but
+    // the repo is still valid for staging + committing. Fall back to existsSync check.
+    return result.success && (result.stdout === 'true' || isCleoGitInitialized(cleoDir));
+}
+/**
+ * Check if a merge is in progress in the .cleo/.git repo.
+ * @task T4552
+ * @task T4872
+ */
+function isMergeInProgress(cleoDir) {
+    return existsSync(join(cleoDir, '.git', 'MERGE_HEAD'));
+}
+/**
+ * Check if HEAD is detached in the .cleo/.git repo.
+ * @task T4552
+ * @task T4872
+ */
+async function isDetachedHead(cleoDir) {
+    const result = await cleoGitCommand(['symbolic-ref', 'HEAD'], cleoDir);
+    return !result.success;
+}
+/**
+ * Check if a rebase is in progress in the .cleo/.git repo.
+ * @task T4552
+ * @task T4872
+ */
+function isRebaseInProgress(cleoDir) {
+    return (existsSync(join(cleoDir, '.git', 'rebase-merge')) ||
+        existsSync(join(cleoDir, '.git', 'rebase-apply')));
+}
+/**
+ * Record the current time as the last checkpoint time.
+ * @task T4552
+ */
+async function recordCheckpointTime(cleoDir) {
+    try {
+        const stateFile = join(cleoDir, CHECKPOINT_STATE_FILE);
+        await writeFile(stateFile, String(Math.floor(Date.now() / 1000)));
+    }
+    catch {
+        // Non-fatal
+    }
+}
+/**
+ * Get the epoch time of the last checkpoint.
+ * @task T4552
+ */
+async function getLastCheckpointTime(cleoDir) {
+    try {
+        const stateFile = join(cleoDir, CHECKPOINT_STATE_FILE);
+        const content = await readFile(stateFile, 'utf-8');
+        const epoch = parseInt(content.trim(), 10);
+        return Number.isNaN(epoch) ? 0 : epoch;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Get list of state files with pending changes in the .cleo/.git repo.
+ * Paths are relative to cleoDir (the git work tree).
+ * @task T4552
+ * @task T4872
+ */
+async function getChangedStateFiles(cleoDir, cwd) {
+    const changed = [];
+    const allStateFiles = await getAllStateFiles(cwd);
+    for (const stateFile of allStateFiles) {
+        const fullPath = join(cleoDir, stateFile);
+        if (!existsSync(fullPath))
+            continue;
+        // Check for staged or unstaged changes (paths relative to cleoDir work tree)
+        const diffResult = await cleoGitCommand(['diff', '--quiet', '--', stateFile], cleoDir);
+        const cachedResult = await cleoGitCommand(['diff', '--cached', '--quiet', '--', stateFile], cleoDir);
+        const untrackedResult = await cleoGitCommand(['ls-files', '--others', '--exclude-standard', '--', stateFile], cleoDir);
+        if (!diffResult.success || !cachedResult.success) {
+            changed.push({ path: stateFile, status: 'modified' });
+        }
+        else if (untrackedResult.stdout.length > 0) {
+            changed.push({ path: stateFile, status: 'untracked' });
+        }
+    }
+    return changed;
+}
+/**
+ * Check whether a checkpoint should be performed.
+ * Evaluates: enabled, .cleo/.git initialized, debounce elapsed, files changed.
+ * @task T4552
+ * @task T4872
+ */
+export async function shouldCheckpoint(options) {
+    const force = options?.force ?? false;
+    const cwd = options?.cwd;
+    // Suppression check (even force doesn't override explicit suppression)
+    if (process.env['GIT_CHECKPOINT_SUPPRESS'] === 'true') {
+        return false;
+    }
+    const config = await loadCheckpointConfig(cwd);
+    if (!config.enabled)
+        return false;
+    const cleoDir = getCleoDir(cwd);
+    if (!existsSync(cleoDir))
+        return false;
+    // Guard: .cleo/.git must be initialized (run `cleo init` to enable checkpointing)
+    if (!isCleoGitInitialized(cleoDir))
+        return false;
+    if (!(await isCleoGitRepo(cleoDir)))
+        return false;
+    if (isMergeInProgress(cleoDir))
+        return false;
+    if (await isDetachedHead(cleoDir))
+        return false;
+    if (isRebaseInProgress(cleoDir))
+        return false;
+    // Check debounce (unless forced)
+    if (!force) {
+        const lastCheckpoint = await getLastCheckpointTime(cleoDir);
+        const now = Math.floor(Date.now() / 1000);
+        const elapsed = now - lastCheckpoint;
+        const debounceSeconds = config.debounceMinutes * 60;
+        if (elapsed < debounceSeconds)
+            return false;
+    }
+    // Check if any state files have changes
+    const changed = await getChangedStateFiles(cleoDir, cwd);
+    return changed.length > 0;
+}
+/**
+ * Stage .cleo/ state files and commit to the isolated .cleo/.git repo.
+ * Never fatal - all git errors are suppressed.
+ * @task T4552
+ * @task T4872
+ */
+export async function gitCheckpoint(trigger = 'auto', context, cwd) {
+    // Suppression check
+    if (process.env['GIT_CHECKPOINT_SUPPRESS'] === 'true') {
+        return;
+    }
+    const force = trigger === 'manual';
+    if (!(await shouldCheckpoint({ force, cwd }))) {
+        return;
+    }
+    const config = await loadCheckpointConfig(cwd);
+    const cleoDir = getCleoDir(cwd);
+    const changed = await getChangedStateFiles(cleoDir, cwd);
+    if (changed.length === 0)
+        return;
+    // Stage changed files (paths are relative to cleoDir work tree)
+    let stagedCount = 0;
+    for (const file of changed) {
+        const result = await cleoGitCommand(['add', file.path], cleoDir);
+        if (result.success)
+            stagedCount++;
+    }
+    if (stagedCount === 0)
+        return;
+    // Build commit message
+    let commitMsg = `${config.messagePrefix} ${trigger} checkpoint`;
+    if (context) {
+        commitMsg = `${config.messagePrefix} ${trigger} checkpoint (${context})`;
+    }
+    // Build commit args
+    const commitArgs = ['commit', '-m', commitMsg];
+    if (config.noVerify) {
+        commitArgs.push('--no-verify');
+    }
+    // Restrict commit to only the staged state files (prevents sweeping pre-staged project files)
+    commitArgs.push('--', ...changed.map((f) => f.path));
+    // Commit to .cleo/.git
+    const commitResult = await cleoGitCommand(commitArgs, cleoDir);
+    if (!commitResult.success) {
+        // If commit failed, unstage our changes
+        for (const file of changed) {
+            await cleoGitCommand(['reset', 'HEAD', '--', file.path], cleoDir);
+        }
+        return;
+    }
+    // Record checkpoint time
+    await recordCheckpointTime(cleoDir);
+}
+/**
+ * Show checkpoint configuration and status.
+ * @task T4552
+ * @task T4872
+ */
+export async function gitCheckpointStatus(cwd) {
+    const config = await loadCheckpointConfig(cwd);
+    const cleoDir = getCleoDir(cwd);
+    const lastCheckpoint = await getLastCheckpointTime(cleoDir);
+    let lastCheckpointIso = 'never';
+    if (lastCheckpoint !== 0) {
+        lastCheckpointIso = new Date(lastCheckpoint * 1000).toISOString();
+    }
+    const isRepo = isCleoGitInitialized(cleoDir) && (await isCleoGitRepo(cleoDir));
+    let pendingChanges = 0;
+    if (isRepo) {
+        const changed = await getChangedStateFiles(cleoDir, cwd);
+        pendingChanges = changed.length;
+    }
+    const suppressed = process.env['GIT_CHECKPOINT_SUPPRESS'] === 'true';
+    return {
+        config,
+        status: {
+            isGitRepo: isRepo,
+            lastCheckpoint: lastCheckpointIso,
+            lastCheckpointEpoch: lastCheckpoint,
+            pendingChanges,
+            suppressed,
+        },
+    };
+}
+/**
+ * Show what files would be committed (dry-run).
+ * @task T4552
+ * @task T4872
+ */
+export async function gitCheckpointDryRun(cwd) {
+    const cleoDir = getCleoDir(cwd);
+    const isRepo = isCleoGitInitialized(cleoDir) && (await isCleoGitRepo(cleoDir));
+    if (!isRepo)
+        return [];
+    return getChangedStateFiles(cleoDir, cwd);
+}
+//# sourceMappingURL=git-checkpoint.js.map

package/dist/store/git-checkpoint.js.map

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

package/dist/store/import-logging.js

@@ -0,0 +1,139 @@
+/**
+ * Import-specific logging functions for CLEO system.
+ * Ported from lib/data/import-logging.sh
+ *
+ * Provides structured audit logging for import operations including
+ * start, success, error, and conflict events.
+ *
+ * @task T4552
+ * @epic T4545
+ */
+import { getLogPath } from '../paths.js';
+import { appendJsonl, readJson } from './json.js';
+/**
+ * Generate a log entry ID.
+ * @task T4552
+ */
+function generateLogId() {
+    const epoch = Math.floor(Date.now() / 1000);
+    const rand = Math.random().toString(36).slice(2, 8);
+    return `log-${epoch}-${rand}`;
+}
+/**
+ * Extract package metadata from an export file.
+ * @task T4552
+ */
+export async function extractPackageMeta(sourceFilePath) {
+    const data = await readJson(sourceFilePath);
+    const meta = data?._meta;
+    return {
+        sourceFile: sourceFilePath.split('/').pop() ?? sourceFilePath,
+        sourceProject: meta?.source?.project ?? 'unknown',
+        exportedAt: meta?.exportedAt ?? 'unknown',
+        packageChecksum: meta?.checksum ?? 'unknown',
+        taskCount: typeof meta?.taskCount === 'number' ? meta.taskCount : 0,
+    };
+}
+/**
+ * Write a log entry to the log file.
+ * @task T4552
+ */
+async function writeLogEntry(action, taskId, details, sessionId, cwd) {
+    const logPath = getLogPath(cwd);
+    const entry = {
+        id: generateLogId(),
+        timestamp: new Date().toISOString(),
+        action,
+        taskId,
+        actor: 'system',
+        details,
+        sessionId: sessionId ?? null,
+    };
+    try {
+        await appendJsonl(logPath, entry);
+    }
+    catch {
+        // Log failure is non-fatal
+    }
+}
+/**
+ * Log import operation start with package metadata.
+ * @task T4552
+ */
+export async function logImportStart(sourceFilePath, sessionId, cwd) {
+    let meta;
+    try {
+        meta = await extractPackageMeta(sourceFilePath);
+    }
+    catch {
+        meta = {
+            sourceFile: sourceFilePath.split('/').pop() ?? sourceFilePath,
+            sourceProject: 'unknown',
+            exportedAt: 'unknown',
+            packageChecksum: 'unknown',
+            taskCount: 0,
+        };
+    }
+    await writeLogEntry('import', null, {
+        ...meta,
+        stage: 'start',
+    }, sessionId, cwd);
+}
+/**
+ * Log import operation completion with full metadata.
+ * @task T4552
+ */
+export async function logImportSuccess(sourceFilePath, tasksImported, idRemap, conflicts, options, sessionId, cwd) {
+    let meta;
+    try {
+        meta = await extractPackageMeta(sourceFilePath);
+    }
+    catch {
+        meta = {
+            sourceFile: sourceFilePath.split('/').pop() ?? sourceFilePath,
+            sourceProject: 'unknown',
+            exportedAt: 'unknown',
+            packageChecksum: 'unknown',
+            taskCount: 0,
+        };
+    }
+    await writeLogEntry('import', null, {
+        sourceFile: meta.sourceFile,
+        sourceProject: meta.sourceProject,
+        exportedAt: meta.exportedAt,
+        packageChecksum: meta.packageChecksum,
+        importedAt: new Date().toISOString(),
+        tasksImported,
+        idRemap,
+        conflicts: conflicts ?? [],
+        options: options ?? {},
+        stage: 'success',
+    }, sessionId, cwd);
+}
+/**
+ * Log import operation error with diagnostic details.
+ * @task T4552
+ */
+export async function logImportError(sourceFilePath, errorMessage, errorCode, stage = 'unknown', sessionId, cwd) {
+    await writeLogEntry('error_occurred', null, {
+        sourceFile: sourceFilePath.split('/').pop() ?? sourceFilePath,
+        stage,
+        error: {
+            message: errorMessage,
+            code: String(errorCode),
+            timestamp: new Date().toISOString(),
+        },
+    }, sessionId, cwd);
+}
+/**
+ * Log import conflict detection and resolution.
+ * @task T4552
+ */
+export async function logImportConflict(conflictType, taskId, conflictDetails, resolution, sessionId, cwd) {
+    await writeLogEntry('task_updated', taskId, {
+        conflictType,
+        resolution,
+        details: conflictDetails,
+    }, sessionId, cwd);
+}
+//# sourceMappingURL=import-logging.js.map

package/dist/store/import-logging.js.map

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

package/dist/store/import-remap.js

@@ -0,0 +1,145 @@
+/**
+ * ID remapping logic for import system.
+ * Ported from lib/data/import-remap.sh
+ *
+ * @epic T4454
+ * @task T4530
+ */
+/**
+ * Get the next available task ID number from existing tasks.
+ */
+export function getNextAvailableId(tasks) {
+    if (tasks.length === 0)
+        return 1;
+    const maxId = tasks.reduce((max, t) => {
+        const num = parseInt(t.id.replace('T', ''), 10);
+        return Number.isNaN(num) ? max : Math.max(max, num);
+    }, 0);
+    return maxId + 1;
+}
+/**
+ * Generate a remap table for importing tasks.
+ * Maps source task IDs to new sequential IDs starting from nextAvailable.
+ */
+export function generateRemapTable(sourceTaskIds, existingTasks) {
+    const forward = new Map();
+    const reverse = new Map();
+    let nextId = getNextAvailableId(existingTasks);
+    for (const sourceId of sourceTaskIds) {
+        const newId = `T${String(nextId).padStart(3, '0')}`;
+        forward.set(sourceId, newId);
+        reverse.set(newId, sourceId);
+        nextId++;
+    }
+    return { forward, reverse };
+}
+/**
+ * Validate that a remap table is complete and consistent.
+ */
+export function validateRemapTable(table, expectedSourceIds) {
+    const errors = [];
+    // Check completeness
+    for (const id of expectedSourceIds) {
+        if (!table.forward.has(id)) {
+            errors.push(`Missing mapping for source ID: ${id}`);
+        }
+    }
+    // Check consistency
+    for (const [source, target] of table.forward) {
+        const reverseSource = table.reverse.get(target);
+        if (reverseSource !== source) {
+            errors.push(`Inconsistent mapping: ${source} -> ${target} -> ${reverseSource}`);
+        }
+    }
+    // Check ID format
+    for (const newId of table.reverse.keys()) {
+        if (!/^T\d{3,}$/.test(newId)) {
+            errors.push(`Invalid new task ID format: ${newId}`);
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+/**
+ * Remap a single task ID, returning original if not in table.
+ */
+export function remapTaskId(taskId, table) {
+    if (!taskId)
+        return null;
+    return table.forward.get(taskId) ?? taskId;
+}
+/**
+ * Remap all ID references in a task.
+ */
+export function remapTaskReferences(task, table, existingTaskIds, missingDepStrategy = 'strip') {
+    const newId = table.forward.get(task.id);
+    if (!newId)
+        throw new Error(`No mapping for task ${task.id}`);
+    // Remap parent
+    let newParentId;
+    if (task.parentId) {
+        if (table.forward.has(task.parentId)) {
+            newParentId = table.forward.get(task.parentId);
+        }
+        else if (existingTaskIds.has(task.parentId)) {
+            newParentId = task.parentId;
+        }
+        else {
+            newParentId = null; // Orphan
+        }
+    }
+    // Remap dependencies
+    let newDepends;
+    if (task.depends?.length) {
+        newDepends = [];
+        for (const dep of task.depends) {
+            if (table.forward.has(dep)) {
+                newDepends.push(table.forward.get(dep));
+            }
+            else if (existingTaskIds.has(dep)) {
+                newDepends.push(dep);
+            }
+            else if (missingDepStrategy === 'fail') {
+                throw new Error(`Missing dependency ${dep} for task ${task.id}`);
+            }
+            // 'strip' strategy: just skip missing deps
+        }
+    }
+    return {
+        ...task,
+        id: newId,
+        ...(newParentId !== undefined ? { parentId: newParentId } : {}),
+        ...(newDepends !== undefined ? { depends: newDepends } : {}),
+    };
+}
+/**
+ * Detect duplicate titles between import and target.
+ */
+export function detectDuplicateTitles(importTasks, existingTasks) {
+    const titleMap = new Map();
+    for (const t of existingTasks) {
+        titleMap.set(t.title.toLowerCase(), t.id);
+    }
+    const conflicts = [];
+    for (const t of importTasks) {
+        const existing = titleMap.get(t.title.toLowerCase());
+        if (existing) {
+            conflicts.push({ sourceId: t.id, title: t.title, existingId: existing });
+        }
+    }
+    return conflicts;
+}
+/**
+ * Resolve duplicate title by appending suffix.
+ */
+export function resolveDuplicateTitle(title, existingTitles) {
+    let candidate = `${title} (imported)`;
+    if (!existingTitles.has(candidate.toLowerCase()))
+        return candidate;
+    for (let i = 2; i <= 1000; i++) {
+        candidate = `${title} (imported-${i})`;
+        if (!existingTitles.has(candidate.toLowerCase()))
+            return candidate;
+    }
+    return candidate;
+}
+//# sourceMappingURL=import-remap.js.map

package/dist/store/import-remap.js.map

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