@cleocode/mcp-server 0.90.3 → 0.94.1

package/dist/engine/store.js

@@ -0,0 +1,284 @@
+/**
+ * JSON File Store
+ *
+ * Handles reading and writing CLEO JSON files with:
+ * - Atomic writes (temp file -> validate -> backup -> rename)
+ * - Cross-process file locking (proper-lockfile)
+ * - Numbered backup rotation matching Tier 1 bash behavior
+ * - Lock ordering to prevent deadlocks (todo.json before archive)
+ */
+import { readFileSync, writeFileSync, renameSync, mkdirSync, existsSync, readdirSync, unlinkSync } from 'fs';
+import { join, dirname, basename } from 'path';
+import { randomBytes } from 'crypto';
+import * as lockfile from 'proper-lockfile';
+/**
+ * Default lock options matching bash flock behavior
+ */
+const LOCK_OPTIONS = {
+    retries: {
+        retries: 5,
+        factor: 2,
+        minTimeout: 100,
+        maxTimeout: 5000,
+    },
+    stale: 30000, // 30s stale lock timeout
+};
+/**
+ * Maximum number of operational backups to keep (Tier 1)
+ */
+const MAX_BACKUPS = 10;
+/**
+ * Lock ordering to prevent deadlocks.
+ * Always acquire locks in this order.
+ */
+const LOCK_ORDER = {
+    'todo.json': 1,
+    'sessions.json': 2,
+    'todo-archive.json': 3,
+    'todo-log.json': 4,
+    'config.json': 5,
+};
+function getLockPriority(filePath) {
+    const name = basename(filePath);
+    return LOCK_ORDER[name] ?? 99;
+}
+/**
+ * Read a JSON file, returning parsed content or null if not found
+ */
+export function readJsonFile(filePath) {
+    try {
+        const content = readFileSync(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return null;
+        }
+        throw error;
+    }
+}
+/**
+ * Write a JSON file atomically with backup rotation.
+ *
+ * Pattern: write temp -> backup original -> rename temp to target
+ *
+ * @param filePath - Target file path
+ * @param data - Data to serialize as JSON
+ * @param indent - JSON indentation (default: 2 spaces)
+ */
+export function writeJsonFileAtomic(filePath, data, indent = 2) {
+    const dir = dirname(filePath);
+    const tempPath = join(dir, `.${basename(filePath)}.${randomBytes(6).toString('hex')}.tmp`);
+    // Serialize
+    const content = JSON.stringify(data, null, indent) + '\n';
+    // Write to temp file
+    writeFileSync(tempPath, content, 'utf-8');
+    try {
+        // Create backup of existing file (Tier 1 operational backup)
+        if (existsSync(filePath)) {
+            rotateBackup(filePath);
+        }
+        // Atomic rename
+        renameSync(tempPath, filePath);
+    }
+    catch (error) {
+        // Clean up temp file on failure
+        try {
+            unlinkSync(tempPath);
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+        throw error;
+    }
+}
+/**
+ * Read and write a JSON file with exclusive locking.
+ *
+ * Acquires a cross-process lock, reads current state, applies the
+ * transform function, validates, and writes back atomically.
+ *
+ * @param filePath - File to lock and modify
+ * @param transform - Function that receives current data and returns new data
+ * @returns The transformed data
+ */
+export async function withLock(filePath, transform) {
+    const dir = dirname(filePath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    // Ensure file exists for locking (proper-lockfile needs the file to exist)
+    if (!existsSync(filePath)) {
+        writeFileSync(filePath, '', 'utf-8');
+    }
+    let release;
+    try {
+        release = await lockfile.lock(filePath, LOCK_OPTIONS);
+        const current = readJsonFile(filePath);
+        const updated = transform(current);
+        writeJsonFileAtomic(filePath, updated);
+        return updated;
+    }
+    finally {
+        if (release) {
+            await release();
+        }
+    }
+}
+/**
+ * Acquire a file lock and execute an operation.
+ * Unlike withLock, this doesn't read/write the file - caller manages I/O.
+ * The return type R is independent of the file content type.
+ */
+export async function withFileLock(filePath, operation) {
+    const dir = dirname(filePath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    if (!existsSync(filePath)) {
+        writeFileSync(filePath, '', 'utf-8');
+    }
+    let release;
+    try {
+        release = await lockfile.lock(filePath, LOCK_OPTIONS);
+        return await operation();
+    }
+    finally {
+        if (release) {
+            await release();
+        }
+    }
+}
+/**
+ * Acquire locks on multiple files in correct order.
+ * Used for operations that need to modify multiple files atomically
+ * (e.g., moving a task from todo.json to archive).
+ *
+ * @param filePaths - Files to lock
+ * @param operation - Function to execute while locks are held
+ */
+export async function withMultiLock(filePaths, operation) {
+    // Sort by lock priority to prevent deadlocks
+    const sorted = [...filePaths].sort((a, b) => getLockPriority(a) - getLockPriority(b));
+    const releases = [];
+    try {
+        // Acquire locks in order
+        for (const fp of sorted) {
+            if (!existsSync(dirname(fp))) {
+                mkdirSync(dirname(fp), { recursive: true });
+            }
+            if (!existsSync(fp)) {
+                writeFileSync(fp, '', 'utf-8');
+            }
+            const release = await lockfile.lock(fp, LOCK_OPTIONS);
+            releases.push(release);
+        }
+        return await operation();
+    }
+    finally {
+        // Release in reverse order
+        for (const release of releases.reverse()) {
+            try {
+                await release();
+            }
+            catch {
+                // Ignore release errors
+            }
+        }
+    }
+}
+/**
+ * Create a numbered backup of a file (Tier 1 operational backup).
+ *
+ * Maintains up to MAX_BACKUPS copies:
+ *   .backups/todo.json.1 (newest)
+ *   .backups/todo.json.2
+ *   ...
+ *   .backups/todo.json.10 (oldest, deleted when new backup arrives)
+ */
+function rotateBackup(filePath) {
+    const dir = dirname(filePath);
+    const name = basename(filePath);
+    const backupDir = join(dir, '.backups');
+    if (!existsSync(backupDir)) {
+        mkdirSync(backupDir, { recursive: true });
+    }
+    // Rotate existing backups (shift numbers up)
+    for (let i = MAX_BACKUPS; i >= 1; i--) {
+        const current = join(backupDir, `${name}.${i}`);
+        if (i === MAX_BACKUPS) {
+            // Delete oldest
+            try {
+                unlinkSync(current);
+            }
+            catch {
+                // May not exist
+            }
+        }
+        else {
+            // Shift to next number
+            const next = join(backupDir, `${name}.${i + 1}`);
+            try {
+                if (existsSync(current)) {
+                    renameSync(current, next);
+                }
+            }
+            catch {
+                // Ignore rename errors
+            }
+        }
+    }
+    // Copy current file to .1
+    try {
+        const content = readFileSync(filePath, 'utf-8');
+        writeFileSync(join(backupDir, `${name}.1`), content, 'utf-8');
+    }
+    catch {
+        // Non-fatal - backup failure shouldn't block write
+    }
+}
+/**
+ * Check if a CLEO project directory exists at the given path
+ */
+export function isProjectInitialized(projectRoot) {
+    const cleoDir = join(projectRoot, '.cleo');
+    return existsSync(cleoDir) && existsSync(join(cleoDir, 'todo.json'));
+}
+/**
+ * Resolve the project root directory.
+ * Checks CLEO_ROOT env, then falls back to cwd.
+ */
+export function resolveProjectRoot() {
+    return process.env.CLEO_ROOT || process.cwd();
+}
+/**
+ * Get the path to a CLEO data file
+ */
+export function getDataPath(projectRoot, filename) {
+    return join(projectRoot, '.cleo', filename);
+}
+/**
+ * List backup files for a given data file
+ */
+export function listBackups(filePath) {
+    const dir = dirname(filePath);
+    const name = basename(filePath);
+    const backupDir = join(dir, '.backups');
+    if (!existsSync(backupDir)) {
+        return [];
+    }
+    try {
+        return readdirSync(backupDir)
+            .filter((f) => f.startsWith(`${name}.`) && /\.\d+$/.test(f))
+            .sort((a, b) => {
+            const numA = parseInt(a.split('.').pop(), 10);
+            const numB = parseInt(b.split('.').pop(), 10);
+            return numA - numB;
+        })
+            .map((f) => join(backupDir, f));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/engine/store.js.map

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

package/dist/engine/task-engine.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Task Engine
+ *
+ * Native TypeScript implementation of core task CRUD operations.
+ * Reads/writes .cleo/todo.json directly without CLI subprocess.
+ *
+ * Supports: show, get, list, find, exists, create/add, update, complete, delete, archive
+ */
+/**
+ * Task object as stored in todo.json
+ */
+export interface TaskRecord {
+    id: string;
+    title: string;
+    description: string;
+    status: string;
+    priority: string;
+    type?: string;
+    phase?: string;
+    createdAt: string;
+    updatedAt: string | null;
+    completedAt?: string | null;
+    cancelledAt?: string | null;
+    parentId?: string | null;
+    position?: number | null;
+    positionVersion?: number;
+    depends?: string[];
+    relates?: Array<{
+        taskId: string;
+        type: string;
+        reason?: string;
+    }>;
+    files?: string[];
+    acceptance?: string[];
+    notes?: string[];
+    labels?: string[];
+    size?: string | null;
+    epicLifecycle?: string | null;
+    noAutoComplete?: boolean | null;
+    verification?: Record<string, unknown> | null;
+    origin?: string | null;
+    createdBy?: string | null;
+    validatedBy?: string | null;
+    testedBy?: string | null;
+    lifecycleState?: string | null;
+    validationHistory?: Array<Record<string, unknown>>;
+    blockedBy?: string[];
+    cancellationReason?: string;
+}
+/**
+ * Minimal task representation for find results
+ */
+export interface MinimalTaskRecord {
+    id: string;
+    title: string;
+    status: string;
+    priority: string;
+    parentId?: string | null;
+}
+/**
+ * Engine result wrapper
+ */
+export interface EngineResult<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+}
+/**
+ * Get a single task by ID
+ */
+export declare function taskShow(projectRoot: string, taskId: string): EngineResult<TaskRecord>;
+/**
+ * List tasks with optional filters
+ */
+export declare function taskList(projectRoot: string, params?: {
+    parent?: string;
+    status?: string;
+    limit?: number;
+}): EngineResult<TaskRecord[]>;
+/**
+ * Fuzzy search tasks by title/description/ID
+ */
+export declare function taskFind(projectRoot: string, query: string, limit?: number): EngineResult<MinimalTaskRecord[]>;
+/**
+ * Check if a task exists
+ */
+export declare function taskExists(projectRoot: string, taskId: string): EngineResult<{
+    exists: boolean;
+    taskId: string;
+}>;
+/**
+ * Create a new task
+ */
+export declare function taskCreate(projectRoot: string, params: {
+    title: string;
+    description: string;
+    parent?: string;
+    depends?: string[];
+    priority?: string;
+    labels?: string[];
+    type?: string;
+}): Promise<EngineResult<TaskRecord>>;
+/**
+ * Update a task
+ */
+export declare function taskUpdate(projectRoot: string, taskId: string, updates: {
+    title?: string;
+    description?: string;
+    status?: string;
+    priority?: string;
+    notes?: string;
+    labels?: string[];
+    depends?: string[];
+    acceptance?: string[];
+}): Promise<EngineResult<TaskRecord>>;
+/**
+ * Complete a task (set status to done)
+ */
+export declare function taskComplete(projectRoot: string, taskId: string, notes?: string): Promise<EngineResult<TaskRecord>>;
+/**
+ * Delete a task
+ */
+export declare function taskDelete(projectRoot: string, taskId: string, force?: boolean): Promise<EngineResult<{
+    deleted: boolean;
+    taskId: string;
+}>>;
+/**
+ * Archive completed tasks.
+ * Moves done/cancelled tasks from todo.json to todo-archive.json.
+ */
+export declare function taskArchive(projectRoot: string, taskId?: string, before?: string): Promise<EngineResult<{
+    archived: number;
+    taskIds: string[];
+}>>;
+//# sourceMappingURL=task-engine.d.ts.map

package/dist/engine/task-engine.d.ts.map

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