@cleocode/mcp-server 0.90.3 → 0.92.1

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

@@ -0,0 +1,52 @@
+/**
+ * Init Engine
+ *
+ * Project initialization: creates the .cleo/ directory structure
+ * with empty data files and default configuration.
+ *
+ * CRITICAL: Init is explicit, not automatic. The MCP server MUST NOT
+ * silently create .cleo/ directories on first write.
+ */
+/**
+ * Engine result wrapper
+ */
+export interface EngineResult<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+}
+/**
+ * Initialize a CLEO project directory.
+ *
+ * Creates the .cleo/ directory structure with empty data files.
+ * Returns error if already initialized (unless force=true).
+ */
+export declare function initProject(projectRoot: string, options?: {
+    projectName?: string;
+    force?: boolean;
+}): EngineResult<{
+    initialized: boolean;
+    projectRoot: string;
+    filesCreated: string[];
+}>;
+/**
+ * Check if auto-init is enabled via environment variable
+ */
+export declare function isAutoInitEnabled(): boolean;
+/**
+ * Check initialization status and auto-init if configured
+ */
+export declare function ensureInitialized(projectRoot: string): EngineResult<{
+    initialized: boolean;
+}>;
+/**
+ * Get current version (native implementation)
+ */
+export declare function getVersion(projectRoot: string): EngineResult<{
+    version: string;
+}>;
+//# sourceMappingURL=init-engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init-engine.d.ts","sourceRoot":"","sources":["../../src/engine/init-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAaD;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IACR,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GACA,YAAY,CAAC;IACd,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC,CAgID;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,GAClB,YAAY,CAAC;IAAE,WAAW,EAAE,OAAO,CAAA;CAAE,CAAC,CA0BxC;AAUD;;GAEG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA8BjF"}

package/dist/engine/init-engine.js

@@ -0,0 +1,222 @@
+/**
+ * Init Engine
+ *
+ * Project initialization: creates the .cleo/ directory structure
+ * with empty data files and default configuration.
+ *
+ * CRITICAL: Init is explicit, not automatic. The MCP server MUST NOT
+ * silently create .cleo/ directories on first write.
+ */
+import { existsSync, mkdirSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { readJsonFile } from './store.js';
+/**
+ * Default schema versions for new files
+ */
+const DEFAULT_VERSIONS = {
+    todo: '2.10.0',
+    config: '2.10.0',
+    archive: '2.4.0',
+    log: '2.4.0',
+    sessions: '1.0.0',
+};
+/**
+ * Initialize a CLEO project directory.
+ *
+ * Creates the .cleo/ directory structure with empty data files.
+ * Returns error if already initialized (unless force=true).
+ */
+export function initProject(projectRoot, options) {
+    const cleoDir = join(projectRoot, '.cleo');
+    const isAlreadyInit = existsSync(cleoDir) && existsSync(join(cleoDir, 'todo.json'));
+    if (isAlreadyInit && !options?.force) {
+        return {
+            success: false,
+            error: {
+                code: 'E_ALREADY_INITIALIZED',
+                message: 'CLEO project already initialized. Use force=true to reinitialize.',
+            },
+        };
+    }
+    const filesCreated = [];
+    const now = new Date().toISOString();
+    const projectName = options?.projectName || deriveProjectName(projectRoot);
+    // Create directory structure
+    const dirs = [
+        cleoDir,
+        join(cleoDir, '.backups'),
+        join(cleoDir, 'backups'),
+        join(cleoDir, 'metrics'),
+    ];
+    for (const dir of dirs) {
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+    }
+    // Create todo.json
+    const todoPath = join(cleoDir, 'todo.json');
+    if (!existsSync(todoPath) || options?.force) {
+        const todoData = {
+            project: {
+                name: projectName,
+                currentPhase: null,
+                phases: {},
+                phaseHistory: [],
+                releases: [],
+            },
+            lastUpdated: now,
+            focus: {
+                currentTask: null,
+                currentPhase: null,
+                blockedUntil: null,
+                sessionNote: null,
+                sessionNotes: [],
+                nextAction: null,
+                primarySession: null,
+            },
+            _meta: {
+                schemaVersion: DEFAULT_VERSIONS.todo,
+                specVersion: '3.1.0',
+                checksum: '0000000000000000',
+                configVersion: DEFAULT_VERSIONS.config,
+                lastSessionId: null,
+                activeSession: null,
+                multiSessionEnabled: false,
+                activeSessionCount: 0,
+                sessionsFile: 'sessions.json',
+                generation: 0,
+            },
+            tasks: [],
+            labels: {},
+        };
+        writeFileSync(todoPath, JSON.stringify(todoData, null, 2) + '\n', 'utf-8');
+        filesCreated.push('todo.json');
+    }
+    // Create config.json
+    const configPath = join(cleoDir, 'config.json');
+    if (!existsSync(configPath) || options?.force) {
+        const configData = {
+            version: DEFAULT_VERSIONS.config,
+            _meta: {
+                schemaVersion: DEFAULT_VERSIONS.config,
+            },
+        };
+        writeFileSync(configPath, JSON.stringify(configData, null, 2) + '\n', 'utf-8');
+        filesCreated.push('config.json');
+    }
+    // Create todo-archive.json
+    const archivePath = join(cleoDir, 'todo-archive.json');
+    if (!existsSync(archivePath) || options?.force) {
+        const archiveData = {
+            project: projectName,
+            _meta: {
+                schemaVersion: DEFAULT_VERSIONS.archive,
+                totalArchived: 0,
+                lastArchived: null,
+            },
+            archivedTasks: [],
+        };
+        writeFileSync(archivePath, JSON.stringify(archiveData, null, 2) + '\n', 'utf-8');
+        filesCreated.push('todo-archive.json');
+    }
+    // Create todo-log.json
+    const logPath = join(cleoDir, 'todo-log.json');
+    if (!existsSync(logPath) || options?.force) {
+        const logData = {
+            project: projectName,
+            _meta: {
+                schemaVersion: DEFAULT_VERSIONS.log,
+                totalEntries: 0,
+                firstEntry: null,
+                lastEntry: null,
+                formatVersion: '1',
+                entriesPruned: 0,
+            },
+            entries: [],
+        };
+        writeFileSync(logPath, JSON.stringify(logData, null, 2) + '\n', 'utf-8');
+        filesCreated.push('todo-log.json');
+    }
+    return {
+        success: true,
+        data: {
+            initialized: true,
+            projectRoot,
+            filesCreated,
+        },
+    };
+}
+/**
+ * Check if auto-init is enabled via environment variable
+ */
+export function isAutoInitEnabled() {
+    return process.env.CLEO_AUTO_INIT === 'true';
+}
+/**
+ * Check initialization status and auto-init if configured
+ */
+export function ensureInitialized(projectRoot) {
+    const cleoDir = join(projectRoot, '.cleo');
+    const isInit = existsSync(cleoDir) && existsSync(join(cleoDir, 'todo.json'));
+    if (isInit) {
+        return { success: true, data: { initialized: true } };
+    }
+    if (isAutoInitEnabled()) {
+        const result = initProject(projectRoot);
+        if (result.success) {
+            return { success: true, data: { initialized: true } };
+        }
+        return {
+            success: false,
+            error: result.error,
+        };
+    }
+    return {
+        success: false,
+        error: {
+            code: 'E_NOT_INITIALIZED',
+            message: 'CLEO project not initialized. Run system.init or set CLEO_AUTO_INIT=true',
+        },
+    };
+}
+/**
+ * Derive project name from directory path
+ */
+function deriveProjectName(projectRoot) {
+    const parts = projectRoot.replace(/\\/g, '/').split('/');
+    return parts[parts.length - 1] || 'cleo-project';
+}
+/**
+ * Get current version (native implementation)
+ */
+export function getVersion(projectRoot) {
+    // Try reading VERSION file from project root
+    const versionPaths = [
+        join(projectRoot, 'VERSION'),
+        join(projectRoot, '..', 'VERSION'), // mcp-server subdirectory
+    ];
+    for (const versionPath of versionPaths) {
+        try {
+            const { readFileSync } = require('fs');
+            const version = readFileSync(versionPath, 'utf-8').trim();
+            if (version) {
+                return { success: true, data: { version } };
+            }
+        }
+        catch {
+            // Try next path
+        }
+    }
+    // Fallback: try package.json
+    try {
+        const pkg = readJsonFile(join(projectRoot, 'package.json'));
+        if (pkg?.version) {
+            return { success: true, data: { version: pkg.version } };
+        }
+    }
+    catch {
+        // No package.json
+    }
+    return { success: true, data: { version: '0.0.0' } };
+}
+//# sourceMappingURL=init-engine.js.map

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

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

package/dist/engine/schema-validator.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Schema Validator
+ *
+ * Validates CLEO JSON data against JSON Schema using Ajv.
+ * Reuses existing schemas from the schemas/ directory.
+ */
+/**
+ * Validation result
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+}
+/**
+ * Individual validation error
+ */
+export interface ValidationError {
+    path: string;
+    message: string;
+    keyword: string;
+    params: Record<string, unknown>;
+}
+/**
+ * Schema types that can be validated
+ */
+export type SchemaType = 'todo' | 'config' | 'archive' | 'log' | 'sessions';
+/**
+ * Validate data against a CLEO schema
+ *
+ * @param schemaType - Which schema to validate against
+ * @param data - The data to validate
+ * @returns Validation result with errors if invalid
+ */
+export declare function validateSchema(schemaType: SchemaType, data: unknown): ValidationResult;
+/**
+ * Validate a single task object against the task definition in todo.schema.json.
+ * This extracts the task definition from the full schema for targeted validation.
+ *
+ * @param task - Task object to validate
+ * @returns Validation result
+ */
+export declare function validateTask(task: unknown): ValidationResult;
+/**
+ * Clear the schema cache (useful for testing)
+ */
+export declare function clearSchemaCache(): void;
+//# sourceMappingURL=schema-validator.d.ts.map

package/dist/engine/schema-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validator.d.ts","sourceRoot":"","sources":["../../src/engine/schema-validator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,GAAG,UAAU,CAAC;AAmF5E;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,OAAO,GACZ,gBAAgB,CA+BlB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAgG5D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC"}

package/dist/engine/schema-validator.js

@@ -0,0 +1,219 @@
+/**
+ * Schema Validator
+ *
+ * Validates CLEO JSON data against JSON Schema using Ajv.
+ * Reuses existing schemas from the schemas/ directory.
+ */
+import AjvModule from 'ajv';
+import addFormatsModule from 'ajv-formats';
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+// Handle ESM/CJS interop for Ajv and ajv-formats
+const Ajv = AjvModule.default || AjvModule;
+const addFormats = addFormatsModule.default || addFormatsModule;
+/**
+ * Schema cache to avoid re-reading/re-compiling
+ */
+const schemaCache = new Map();
+/**
+ * Create an Ajv instance configured for CLEO schemas
+ */
+function createAjv() {
+    const ajv = new Ajv({
+        allErrors: true,
+        strict: false,
+        validateFormats: true,
+    });
+    addFormats(ajv);
+    return ajv;
+}
+/**
+ * Shared Ajv instance
+ */
+let ajvInstance = null;
+function getAjv() {
+    if (!ajvInstance) {
+        ajvInstance = createAjv();
+    }
+    return ajvInstance;
+}
+/**
+ * Resolve path to a schema file.
+ * Looks in multiple locations: project schemas/, mcp-server local schemas/
+ */
+function resolveSchemaPath(schemaType) {
+    const filename = `${schemaType}.schema.json`;
+    // Check project root schemas/
+    const projectRoot = process.env.CLEO_ROOT || process.cwd();
+    const paths = [
+        join(projectRoot, 'schemas', filename),
+        join(projectRoot, '..', 'schemas', filename), // mcp-server is a subdirectory
+        join(__dirname, '..', '..', '..', 'schemas', filename), // relative from dist/
+        join(__dirname, '..', '..', 'schemas', filename),
+    ];
+    for (const p of paths) {
+        if (existsSync(p)) {
+            return p;
+        }
+    }
+    return null;
+}
+/**
+ * Load and compile a schema, with caching
+ */
+function getValidator(schemaType) {
+    const cached = schemaCache.get(schemaType);
+    if (cached) {
+        return cached;
+    }
+    const schemaPath = resolveSchemaPath(schemaType);
+    if (!schemaPath) {
+        return null;
+    }
+    try {
+        const schemaContent = readFileSync(schemaPath, 'utf-8');
+        const schema = JSON.parse(schemaContent);
+        const ajv = getAjv();
+        const validate = ajv.compile(schema);
+        schemaCache.set(schemaType, validate);
+        return validate;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Validate data against a CLEO schema
+ *
+ * @param schemaType - Which schema to validate against
+ * @param data - The data to validate
+ * @returns Validation result with errors if invalid
+ */
+export function validateSchema(schemaType, data) {
+    const validate = getValidator(schemaType);
+    if (!validate) {
+        return {
+            valid: false,
+            errors: [{
+                    path: '',
+                    message: `Schema '${schemaType}' not found. Ensure schemas/ directory is accessible.`,
+                    keyword: 'schema-not-found',
+                    params: { schemaType },
+                }],
+        };
+    }
+    const valid = validate(data);
+    if (valid) {
+        return { valid: true, errors: [] };
+    }
+    const errors = (validate.errors || []).map((err) => ({
+        path: err.instancePath || '/',
+        message: err.message || 'Validation failed',
+        keyword: err.keyword,
+        params: err.params,
+    }));
+    return { valid: false, errors };
+}
+/**
+ * Validate a single task object against the task definition in todo.schema.json.
+ * This extracts the task definition from the full schema for targeted validation.
+ *
+ * @param task - Task object to validate
+ * @returns Validation result
+ */
+export function validateTask(task) {
+    if (!task || typeof task !== 'object') {
+        return {
+            valid: false,
+            errors: [{
+                    path: '',
+                    message: 'Task must be a non-null object',
+                    keyword: 'type',
+                    params: { type: 'object' },
+                }],
+        };
+    }
+    const taskObj = task;
+    // Validate required fields exist
+    const requiredFields = ['id', 'title', 'status', 'priority', 'createdAt'];
+    const errors = [];
+    for (const field of requiredFields) {
+        if (taskObj[field] === undefined || taskObj[field] === null) {
+            errors.push({
+                path: `/${field}`,
+                message: `Required field '${field}' is missing`,
+                keyword: 'required',
+                params: { missingProperty: field },
+            });
+        }
+    }
+    // Validate ID format
+    if (typeof taskObj.id === 'string' && !/^T\d{3,}$/.test(taskObj.id)) {
+        errors.push({
+            path: '/id',
+            message: 'Task ID must match pattern T followed by 3+ digits (e.g., T001)',
+            keyword: 'pattern',
+            params: { pattern: '^T\\d{3,}$' },
+        });
+    }
+    // Validate status enum
+    const validStatuses = ['pending', 'active', 'blocked', 'done', 'cancelled'];
+    if (taskObj.status && !validStatuses.includes(taskObj.status)) {
+        errors.push({
+            path: '/status',
+            message: `Status must be one of: ${validStatuses.join(', ')}`,
+            keyword: 'enum',
+            params: { allowedValues: validStatuses },
+        });
+    }
+    // Validate priority enum
+    const validPriorities = ['critical', 'high', 'medium', 'low'];
+    if (taskObj.priority && !validPriorities.includes(taskObj.priority)) {
+        errors.push({
+            path: '/priority',
+            message: `Priority must be one of: ${validPriorities.join(', ')}`,
+            keyword: 'enum',
+            params: { allowedValues: validPriorities },
+        });
+    }
+    // Validate title length
+    if (typeof taskObj.title === 'string') {
+        if (taskObj.title.length === 0) {
+            errors.push({
+                path: '/title',
+                message: 'Title cannot be empty',
+                keyword: 'minLength',
+                params: { limit: 1 },
+            });
+        }
+        if (taskObj.title.length > 120) {
+            errors.push({
+                path: '/title',
+                message: 'Title cannot exceed 120 characters',
+                keyword: 'maxLength',
+                params: { limit: 120 },
+            });
+        }
+    }
+    // Validate description length
+    if (typeof taskObj.description === 'string' && taskObj.description.length > 2000) {
+        errors.push({
+            path: '/description',
+            message: 'Description cannot exceed 2000 characters',
+            keyword: 'maxLength',
+            params: { limit: 2000 },
+        });
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Clear the schema cache (useful for testing)
+ */
+export function clearSchemaCache() {
+    schemaCache.clear();
+    ajvInstance = null;
+}
+//# sourceMappingURL=schema-validator.js.map

package/dist/engine/schema-validator.js.map

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