@cleocode/mcp-server 0.90.3 → 0.94.1

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

@@ -0,0 +1,139 @@
+/**
+ * Session Engine
+ *
+ * Native TypeScript implementation of session lifecycle operations.
+ * Supports both single-session (focus in todo.json) and multi-session
+ * (separate sessions.json) modes.
+ *
+ * Supports: status, list, show, focus.get, focus.set, focus.clear, start, end
+ */
+/**
+ * Session object matching sessions.schema.json
+ */
+export interface SessionRecord {
+    id: string;
+    status: 'active' | 'suspended' | 'ended' | 'archived';
+    agentId?: string;
+    name?: string;
+    scope: {
+        type: string;
+        rootTaskId: string;
+        phaseFilter?: string | null;
+        labelFilter?: string[] | null;
+        includeDescendants?: boolean;
+        maxDepth?: number | null;
+        explicitTaskIds?: string[] | null;
+        excludeTaskIds?: string[] | null;
+        computedTaskIds?: string[];
+        computedAt?: string;
+    };
+    focus: {
+        currentTask?: string | null;
+        currentPhase?: string | null;
+        previousTask?: string | null;
+        sessionNote?: string | null;
+        nextAction?: string | null;
+        blockedReason?: string | null;
+        focusHistory?: Array<{
+            taskId: string;
+            timestamp: string;
+        }>;
+    };
+    startedAt: string;
+    lastActivity: string;
+    suspendedAt?: string | null;
+    endedAt?: string | null;
+    archivedAt?: string | null;
+    resumeCount?: number;
+    stats?: {
+        tasksCompleted: number;
+        tasksCreated: number;
+        tasksUpdated: number;
+        focusChanges: number;
+        totalActiveMinutes: number;
+        suspendCount: number;
+    };
+}
+/**
+ * Focus state from todo.json (single-session mode)
+ */
+interface FocusState {
+    currentTask: string | null;
+    currentPhase: string | null;
+    blockedUntil: string | null;
+    sessionNote: string | null;
+    sessionNotes: unknown[];
+    nextAction: string | null;
+    primarySession: string | null;
+}
+/**
+ * Engine result wrapper
+ */
+export interface EngineResult<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+}
+/**
+ * Get current session status
+ */
+export declare function sessionStatus(projectRoot: string): EngineResult<{
+    hasActiveSession: boolean;
+    multiSessionEnabled: boolean;
+    session?: SessionRecord | null;
+    focus?: FocusState | null;
+}>;
+/**
+ * List sessions (multi-session mode)
+ */
+export declare function sessionList(projectRoot: string, params?: {
+    active?: boolean;
+    limit?: number;
+}): EngineResult<SessionRecord[]>;
+/**
+ * Show a specific session
+ */
+export declare function sessionShow(projectRoot: string, sessionId: string): EngineResult<SessionRecord>;
+/**
+ * Get current focus
+ */
+export declare function focusGet(projectRoot: string): EngineResult<{
+    currentTask: string | null;
+    currentPhase: string | null;
+}>;
+/**
+ * Set focus to a specific task
+ */
+export declare function focusSet(projectRoot: string, taskId: string): Promise<EngineResult<{
+    taskId: string;
+    previousTask: string | null;
+}>>;
+/**
+ * Clear current focus
+ */
+export declare function focusClear(projectRoot: string): Promise<EngineResult<{
+    cleared: boolean;
+    previousTask: string | null;
+}>>;
+/**
+ * Start a new session
+ */
+export declare function sessionStart(projectRoot: string, params: {
+    scope: string;
+    name?: string;
+    autoFocus?: boolean;
+    focus?: string;
+}): Promise<EngineResult<SessionRecord>>;
+/**
+ * End the current session
+ */
+export declare function sessionEnd(projectRoot: string, notes?: string): Promise<EngineResult<{
+    sessionId: string;
+    ended: boolean;
+}>>;
+export {};
+//# sourceMappingURL=session-engine.d.ts.map

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

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

package/dist/engine/session-engine.js

@@ -0,0 +1,401 @@
+/**
+ * Session Engine
+ *
+ * Native TypeScript implementation of session lifecycle operations.
+ * Supports both single-session (focus in todo.json) and multi-session
+ * (separate sessions.json) modes.
+ *
+ * Supports: status, list, show, focus.get, focus.set, focus.clear, start, end
+ */
+import { readJsonFile, writeJsonFileAtomic, withFileLock, getDataPath } from './store.js';
+import { randomBytes } from 'crypto';
+/**
+ * Generate a session ID matching CLEO format: session_YYYYMMDD_HHMMSS_<hex6>
+ */
+function generateSessionId() {
+    const now = new Date();
+    const date = now.toISOString().replace(/[-:T]/g, '').substring(0, 8);
+    const time = now.toISOString().replace(/[-:T]/g, '').substring(8, 14);
+    const hex = randomBytes(3).toString('hex');
+    return `session_${date}_${time}_${hex}`;
+}
+/**
+ * Check if multi-session mode is enabled
+ */
+function isMultiSession(projectRoot) {
+    const todoPath = getDataPath(projectRoot, 'todo.json');
+    const todo = readJsonFile(todoPath);
+    return todo?._meta?.multiSessionEnabled === true;
+}
+/**
+ * Get current session status
+ */
+export function sessionStatus(projectRoot) {
+    const todoPath = getDataPath(projectRoot, 'todo.json');
+    const todo = readJsonFile(todoPath);
+    if (!todo) {
+        return {
+            success: false,
+            error: { code: 'E_NOT_INITIALIZED', message: 'No todo.json found' },
+        };
+    }
+    const multiSession = todo._meta?.multiSessionEnabled === true;
+    if (multiSession) {
+        const sessionsPath = getDataPath(projectRoot, todo._meta?.sessionsFile || 'sessions.json');
+        const sessions = readJsonFile(sessionsPath);
+        const active = sessions?.sessions?.find((s) => s.status === 'active');
+        return {
+            success: true,
+            data: {
+                hasActiveSession: !!active,
+                multiSessionEnabled: true,
+                session: active || null,
+                focus: null,
+            },
+        };
+    }
+    return {
+        success: true,
+        data: {
+            hasActiveSession: !!todo.focus?.currentTask,
+            multiSessionEnabled: false,
+            session: null,
+            focus: todo.focus || null,
+        },
+    };
+}
+/**
+ * List sessions (multi-session mode)
+ */
+export function sessionList(projectRoot, params) {
+    const todoPath = getDataPath(projectRoot, 'todo.json');
+    const todo = readJsonFile(todoPath);
+    if (!todo) {
+        return {
+            success: false,
+            error: { code: 'E_NOT_INITIALIZED', message: 'No todo.json found' },
+        };
+    }
+    const multiSession = todo._meta?.multiSessionEnabled === true;
+    if (!multiSession) {
+        // Single-session mode: return synthetic session if focus is set
+        if (todo.focus?.currentTask) {
+            const syntheticSession = {
+                id: todo._meta?.activeSession || 'default',
+                status: 'active',
+                scope: { type: 'task', rootTaskId: todo.focus.currentTask },
+                focus: {
+                    currentTask: todo.focus.currentTask,
+                    currentPhase: todo.focus.currentPhase,
+                },
+                startedAt: new Date().toISOString(),
+                lastActivity: new Date().toISOString(),
+            };
+            return { success: true, data: [syntheticSession] };
+        }
+        return { success: true, data: [] };
+    }
+    const sessionsPath = getDataPath(projectRoot, todo._meta?.sessionsFile || 'sessions.json');
+    const sessions = readJsonFile(sessionsPath);
+    if (!sessions) {
+        return { success: true, data: [] };
+    }
+    let result = sessions.sessions || [];
+    if (params?.active === true) {
+        result = result.filter((s) => s.status === 'active');
+    }
+    else if (params?.active === false) {
+        result = result.filter((s) => s.status !== 'active');
+    }
+    if (params?.limit && params.limit > 0) {
+        result = result.slice(0, params.limit);
+    }
+    return { success: true, data: result };
+}
+/**
+ * Show a specific session
+ */
+export function sessionShow(projectRoot, sessionId) {
+    const todoPath = getDataPath(projectRoot, 'todo.json');
+    const todo = readJsonFile(todoPath);
+    if (!todo) {
+        return {
+            success: false,
+            error: { code: 'E_NOT_INITIALIZED', message: 'No todo.json found' },
+        };
+    }
+    const sessionsPath = getDataPath(projectRoot, todo._meta?.sessionsFile || 'sessions.json');
+    const sessions = readJsonFile(sessionsPath);
+    if (!sessions) {
+        return {
+            success: false,
+            error: { code: 'E_NOT_FOUND', message: `Session '${sessionId}' not found` },
+        };
+    }
+    const session = sessions.sessions?.find((s) => s.id === sessionId);
+    if (!session) {
+        // Check history
+        const historical = sessions.sessionHistory?.find((s) => s.id === sessionId);
+        if (historical) {
+            return { success: true, data: historical };
+        }
+        return {
+            success: false,
+            error: { code: 'E_NOT_FOUND', message: `Session '${sessionId}' not found` },
+        };
+    }
+    return { success: true, data: session };
+}
+/**
+ * Get current focus
+ */
+export function focusGet(projectRoot) {
+    const todoPath = getDataPath(projectRoot, 'todo.json');
+    const todo = readJsonFile(todoPath);
+    if (!todo) {
+        return {
+            success: false,
+            error: { code: 'E_NOT_INITIALIZED', message: 'No todo.json found' },
+        };
+    }
+    return {
+        success: true,
+        data: {
+            currentTask: todo.focus?.currentTask || null,
+            currentPhase: todo.focus?.currentPhase || null,
+        },
+    };
+}
+/**
+ * Set focus to a specific task
+ */
+export async function focusSet(projectRoot, taskId) {
+    const todoPath = getDataPath(projectRoot, 'todo.json');
+    return await withFileLock(todoPath, () => {
+        const current = readJsonFile(todoPath);
+        if (!current) {
+            return {
+                success: false,
+                error: { code: 'E_NOT_INITIALIZED', message: 'No valid todo.json found' },
+            };
+        }
+        // Verify task exists
+        const taskExists = current.tasks?.some((t) => t.id === taskId);
+        if (!taskExists) {
+            return {
+                success: false,
+                error: { code: 'E_NOT_FOUND', message: `Task '${taskId}' not found` },
+            };
+        }
+        const previousTask = current.focus?.currentTask || null;
+        if (!current.focus) {
+            current.focus = {
+                currentTask: null,
+                currentPhase: null,
+                blockedUntil: null,
+                sessionNote: null,
+                sessionNotes: [],
+                nextAction: null,
+                primarySession: null,
+            };
+        }
+        current.focus.currentTask = taskId;
+        current.lastUpdated = new Date().toISOString();
+        if (current._meta) {
+            current._meta.generation = (current._meta.generation || 0) + 1;
+        }
+        writeJsonFileAtomic(todoPath, current);
+        return { success: true, data: { taskId, previousTask } };
+    });
+}
+/**
+ * Clear current focus
+ */
+export async function focusClear(projectRoot) {
+    const todoPath = getDataPath(projectRoot, 'todo.json');
+    return await withFileLock(todoPath, () => {
+        const current = readJsonFile(todoPath);
+        if (!current) {
+            return {
+                success: false,
+                error: { code: 'E_NOT_INITIALIZED', message: 'No valid todo.json found' },
+            };
+        }
+        const previousTask = current.focus?.currentTask || null;
+        if (current.focus) {
+            current.focus.currentTask = null;
+        }
+        current.lastUpdated = new Date().toISOString();
+        if (current._meta) {
+            current._meta.generation = (current._meta.generation || 0) + 1;
+        }
+        writeJsonFileAtomic(todoPath, current);
+        return { success: true, data: { cleared: true, previousTask } };
+    });
+}
+/**
+ * Start a new session
+ */
+export async function sessionStart(projectRoot, params) {
+    const todoPath = getDataPath(projectRoot, 'todo.json');
+    return await withFileLock(todoPath, () => {
+        const current = readJsonFile(todoPath);
+        if (!current) {
+            return {
+                success: false,
+                error: { code: 'E_NOT_INITIALIZED', message: 'No valid todo.json found' },
+            };
+        }
+        // Parse scope (e.g., "epic:T001" -> { type: 'epic', rootTaskId: 'T001' })
+        const scopeParts = params.scope.split(':');
+        const scopeType = scopeParts[0] || 'task';
+        const rootTaskId = scopeParts[1] || '';
+        if (!rootTaskId) {
+            return {
+                success: false,
+                error: { code: 'E_INVALID_INPUT', message: 'Scope must include a task ID (e.g., epic:T001)' },
+            };
+        }
+        // Verify root task exists
+        const rootTask = current.tasks?.find((t) => t.id === rootTaskId);
+        if (!rootTask) {
+            return {
+                success: false,
+                error: { code: 'E_NOT_FOUND', message: `Root task '${rootTaskId}' not found` },
+            };
+        }
+        const now = new Date().toISOString();
+        const sessionId = generateSessionId();
+        const newSession = {
+            id: sessionId,
+            status: 'active',
+            name: params.name,
+            scope: {
+                type: scopeType,
+                rootTaskId,
+                includeDescendants: true,
+            },
+            focus: {
+                currentTask: params.focus || (params.autoFocus ? rootTaskId : null),
+                currentPhase: null,
+                previousTask: null,
+            },
+            startedAt: now,
+            lastActivity: now,
+            resumeCount: 0,
+            stats: {
+                tasksCompleted: 0,
+                tasksCreated: 0,
+                tasksUpdated: 0,
+                focusChanges: 0,
+                totalActiveMinutes: 0,
+                suspendCount: 0,
+            },
+        };
+        // Update focus in todo.json
+        if (!current.focus) {
+            current.focus = {
+                currentTask: null,
+                currentPhase: null,
+                blockedUntil: null,
+                sessionNote: null,
+                sessionNotes: [],
+                nextAction: null,
+                primarySession: null,
+            };
+        }
+        if (params.focus) {
+            current.focus.currentTask = params.focus;
+        }
+        else if (params.autoFocus) {
+            current.focus.currentTask = rootTaskId;
+        }
+        if (current._meta) {
+            current._meta.lastSessionId = sessionId;
+            current._meta.activeSession = sessionId;
+            current._meta.generation = (current._meta.generation || 0) + 1;
+        }
+        current.lastUpdated = now;
+        writeJsonFileAtomic(todoPath, current);
+        // If multi-session enabled, also write to sessions.json
+        if (current._meta?.multiSessionEnabled) {
+            const sessionsPath = getDataPath(projectRoot, current._meta?.sessionsFile || 'sessions.json');
+            const sessions = readJsonFile(sessionsPath) || {
+                _meta: {
+                    schemaVersion: '1.0.0',
+                    checksum: '',
+                    lastModified: now,
+                    totalSessionsCreated: 0,
+                },
+                sessions: [],
+                sessionHistory: [],
+            };
+            sessions.sessions.push(newSession);
+            if (sessions._meta) {
+                sessions._meta.lastModified = now;
+                sessions._meta.lastSessionId = sessionId;
+                sessions._meta.totalSessionsCreated =
+                    (sessions._meta.totalSessionsCreated || 0) + 1;
+            }
+            writeJsonFileAtomic(sessionsPath, sessions);
+        }
+        return { success: true, data: newSession };
+    });
+}
+/**
+ * End the current session
+ */
+export async function sessionEnd(projectRoot, notes) {
+    const todoPath = getDataPath(projectRoot, 'todo.json');
+    return await withFileLock(todoPath, () => {
+        const current = readJsonFile(todoPath);
+        if (!current) {
+            return {
+                success: false,
+                error: { code: 'E_NOT_INITIALIZED', message: 'No valid todo.json found' },
+            };
+        }
+        const sessionId = current._meta?.activeSession || 'default';
+        const now = new Date().toISOString();
+        // Clear focus
+        if (current.focus) {
+            current.focus.currentTask = null;
+            if (notes) {
+                if (!current.focus.sessionNotes)
+                    current.focus.sessionNotes = [];
+                current.focus.sessionNotes.push({ timestamp: now, note: notes });
+            }
+        }
+        if (current._meta) {
+            current._meta.activeSession = null;
+            current._meta.generation = (current._meta.generation || 0) + 1;
+        }
+        current.lastUpdated = now;
+        writeJsonFileAtomic(todoPath, current);
+        // Update sessions.json if multi-session
+        if (current._meta?.multiSessionEnabled && sessionId !== 'default') {
+            const sessionsPath = getDataPath(projectRoot, current._meta?.sessionsFile || 'sessions.json');
+            const sessions = readJsonFile(sessionsPath);
+            if (sessions) {
+                const sessionIndex = sessions.sessions.findIndex((s) => s.id === sessionId);
+                if (sessionIndex !== -1) {
+                    const session = sessions.sessions[sessionIndex];
+                    session.status = 'ended';
+                    session.endedAt = now;
+                    session.lastActivity = now;
+                    // Move to history
+                    if (!sessions.sessionHistory)
+                        sessions.sessionHistory = [];
+                    sessions.sessionHistory.push(session);
+                    sessions.sessions.splice(sessionIndex, 1);
+                    if (sessions._meta) {
+                        sessions._meta.lastModified = now;
+                    }
+                    writeJsonFileAtomic(sessionsPath, sessions);
+                }
+            }
+        }
+        return { success: true, data: { sessionId, ended: true } };
+    });
+}
+//# sourceMappingURL=session-engine.js.map

package/dist/engine/session-engine.js.map

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

package/dist/engine/store.d.ts

@@ -0,0 +1,67 @@
+/**
+ * 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)
+ */
+/**
+ * Read a JSON file, returning parsed content or null if not found
+ */
+export declare function readJsonFile<T = unknown>(filePath: string): T | null;
+/**
+ * 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 declare function writeJsonFileAtomic<T>(filePath: string, data: T, indent?: number): void;
+/**
+ * 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 declare function withLock<T>(filePath: string, transform: (current: T | null) => T): Promise<T>;
+/**
+ * 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 declare function withFileLock<R>(filePath: string, operation: () => R | Promise<R>): Promise<R>;
+/**
+ * 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 declare function withMultiLock<T>(filePaths: string[], operation: () => T | Promise<T>): Promise<T>;
+/**
+ * Check if a CLEO project directory exists at the given path
+ */
+export declare function isProjectInitialized(projectRoot: string): boolean;
+/**
+ * Resolve the project root directory.
+ * Checks CLEO_ROOT env, then falls back to cwd.
+ */
+export declare function resolveProjectRoot(): string;
+/**
+ * Get the path to a CLEO data file
+ */
+export declare function getDataPath(projectRoot: string, filename: string): string;
+/**
+ * List backup files for a given data file
+ */
+export declare function listBackups(filePath: string): string[];
+//# sourceMappingURL=store.d.ts.map

package/dist/engine/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/engine/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA0CH;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAUpE;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,CAAC,EACP,MAAM,GAAE,MAAU,GACjB,IAAI,CA2BN;AAED;;;;;;;;;GASG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,KAAK,CAAC,GAClC,OAAO,CAAC,CAAC,CAAC,CAyBZ;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAC9B,OAAO,CAAC,CAAC,CAAC,CAoBZ;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,CAAC,EACnC,SAAS,EAAE,MAAM,EAAE,EACnB,SAAS,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAC9B,OAAO,CAAC,CAAC,CAAC,CAgCZ;AAoDD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAGjE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAqBtD"}