@cleocode/cleo 2026.2.5

package/dist/mcp/lib/manifest.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Manifest Integration System
+ *
+ * Reads and manages agent output manifests (MANIFEST.jsonl) with filtering,
+ * validation, and task linkage capabilities.
+ *
+ * Manifest entries are append-only JSON Lines format where each line is a
+ * single JSON object representing one agent output with metadata.
+ *
+ * @task T2919
+ */
+/**
+ * Manifest entry structure
+ *
+ * Each entry represents one agent output with complete metadata including
+ * task linkage, findings, and follow-up requirements.
+ */
+export interface ManifestEntry {
+    /** Unique entry ID (format: T####-slug) */
+    id: string;
+    /** Relative path to output file */
+    file: string;
+    /** Human-readable title */
+    title: string;
+    /** ISO-8601 date (YYYY-MM-DD) */
+    date: string;
+    /** Completion status */
+    status: 'complete' | 'partial' | 'blocked';
+    /** Protocol type used */
+    agent_type: string;
+    /** Category tags (3-7 items recommended) */
+    topics: string[];
+    /** Key outcomes (3-7 items for research) */
+    key_findings?: string[];
+    /** Whether findings are actionable */
+    actionable: boolean;
+    /** Task IDs requiring follow-up */
+    needs_followup?: string[];
+    /** Related task IDs */
+    linked_tasks?: string[];
+    /** Confidence score (0.0-1.0) */
+    confidence?: number;
+    /** SHA256 of output file */
+    file_checksum?: string;
+    /** Wall-clock completion time in seconds */
+    duration_seconds?: number;
+}
+/**
+ * Filter criteria for manifest entries
+ */
+export interface ManifestFilter {
+    /** Filter by task ID */
+    taskId?: string;
+    /** Filter by agent type */
+    agent_type?: string;
+    /** Filter by status */
+    status?: 'complete' | 'partial' | 'blocked';
+    /** Filter by date (ISO-8601) */
+    date?: string;
+    /** Filter by date range (after this date) */
+    dateAfter?: string;
+    /** Filter by date range (before this date) */
+    dateBefore?: string;
+    /** Filter by topic (exact match) */
+    topic?: string;
+    /** Filter by actionable flag */
+    actionable?: boolean;
+    /** Maximum number of entries to return */
+    limit?: number;
+}
+/**
+ * Manifest validation result
+ */
+export interface ManifestValidation {
+    /** Whether entry is valid */
+    valid: boolean;
+    /** Validation errors */
+    errors: Array<{
+        field: string;
+        message: string;
+        severity: 'error' | 'warning';
+    }>;
+}
+/**
+ * Manifest reader and parser
+ *
+ * Provides methods to read, filter, and validate MANIFEST.jsonl entries
+ * with efficient streaming for large files.
+ */
+export declare class ManifestReader {
+    private manifestPath;
+    private baseDir;
+    constructor(manifestPath: string, baseDir?: string);
+    /**
+     * Read all entries from manifest
+     *
+     * Parses JSONL format (one JSON object per line) and returns array
+     * of manifest entries. Skips invalid lines with warnings.
+     *
+     * @returns Array of parsed manifest entries
+     */
+    readManifest(): Promise<ManifestEntry[]>;
+    /**
+     * Filter entries by criteria
+     *
+     * Applies multiple filter conditions using AND logic. All specified
+     * conditions must match for an entry to be included.
+     *
+     * @param entries - Array of manifest entries to filter
+     * @param filter - Filter criteria
+     * @returns Filtered array of entries
+     */
+    filterEntries(entries: ManifestEntry[], filter: ManifestFilter): ManifestEntry[];
+    /**
+     * Get entries for specific task
+     *
+     * Convenience method to get all manifest entries linked to a task ID.
+     * Searches both the entry ID prefix and linked_tasks array.
+     *
+     * @param taskId - Task ID to search for (e.g., "T2919")
+     * @returns Array of entries linked to task
+     */
+    getTaskEntries(taskId: string): Promise<ManifestEntry[]>;
+    /**
+     * Validate manifest entry
+     *
+     * Checks required fields, format constraints, and data integrity.
+     * Returns detailed validation results with field-level errors.
+     *
+     * @param entry - Manifest entry to validate
+     * @returns Validation result with errors
+     */
+    validateEntry(entry: ManifestEntry): ManifestValidation;
+    /**
+     * Validate entire manifest
+     *
+     * Reads manifest and validates all entries. Returns aggregated
+     * validation results with entry-level details.
+     *
+     * @returns Validation results for all entries
+     */
+    validateManifest(): Promise<{
+        valid: boolean;
+        totalEntries: number;
+        validEntries: number;
+        invalidEntries: number;
+        errors: Array<{
+            entryId: string;
+            errors: ManifestValidation['errors'];
+        }>;
+    }>;
+    /**
+     * Get summary statistics from manifest
+     *
+     * Aggregates manifest entries into summary statistics for reporting.
+     *
+     * @returns Summary statistics
+     */
+    getSummary(): Promise<{
+        total: number;
+        byStatus: Record<string, number>;
+        byAgentType: Record<string, number>;
+        actionable: number;
+        needsFollowup: number;
+    }>;
+}
+/**
+ * Create manifest reader instance
+ *
+ * Factory function for creating configured ManifestReader.
+ *
+ * @param manifestPath - Path to MANIFEST.jsonl (relative to baseDir)
+ * @param baseDir - Base directory (default: cwd)
+ * @returns Configured ManifestReader
+ */
+export declare function createManifestReader(manifestPath: string, baseDir?: string): ManifestReader;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/mcp/lib/manifest.d.ts.map

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

package/dist/mcp/lib/manifest.js

@@ -0,0 +1,301 @@
+/**
+ * Manifest Integration System
+ *
+ * Reads and manages agent output manifests (MANIFEST.jsonl) with filtering,
+ * validation, and task linkage capabilities.
+ *
+ * Manifest entries are append-only JSON Lines format where each line is a
+ * single JSON object representing one agent output with metadata.
+ *
+ * @task T2919
+ */
+import { readFile } from 'fs/promises';
+import { resolve } from 'path';
+/**
+ * Manifest reader and parser
+ *
+ * Provides methods to read, filter, and validate MANIFEST.jsonl entries
+ * with efficient streaming for large files.
+ */
+export class ManifestReader {
+    manifestPath;
+    baseDir;
+    constructor(manifestPath, baseDir = process.cwd()) {
+        this.manifestPath = manifestPath;
+        this.baseDir = baseDir;
+    }
+    /**
+     * Read all entries from manifest
+     *
+     * Parses JSONL format (one JSON object per line) and returns array
+     * of manifest entries. Skips invalid lines with warnings.
+     *
+     * @returns Array of parsed manifest entries
+     */
+    async readManifest() {
+        try {
+            const absolutePath = resolve(this.baseDir, this.manifestPath);
+            const content = await readFile(absolutePath, 'utf-8');
+            const entries = [];
+            const lines = content.split('\n');
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i].trim();
+                // Skip empty lines
+                if (!line)
+                    continue;
+                try {
+                    const entry = JSON.parse(line);
+                    entries.push(entry);
+                }
+                catch (parseError) {
+                    console.warn(`Invalid JSON at line ${i + 1}: ${parseError instanceof Error ? parseError.message : String(parseError)}`);
+                    continue;
+                }
+            }
+            return entries;
+        }
+        catch (error) {
+            // File doesn't exist or can't be read
+            if (error.code === 'ENOENT') {
+                return [];
+            }
+            throw error;
+        }
+    }
+    /**
+     * Filter entries by criteria
+     *
+     * Applies multiple filter conditions using AND logic. All specified
+     * conditions must match for an entry to be included.
+     *
+     * @param entries - Array of manifest entries to filter
+     * @param filter - Filter criteria
+     * @returns Filtered array of entries
+     */
+    filterEntries(entries, filter) {
+        let filtered = entries;
+        // Filter by task ID (check linked_tasks array)
+        if (filter.taskId) {
+            filtered = filtered.filter((e) => e.id.startsWith(filter.taskId) ||
+                e.linked_tasks?.includes(filter.taskId));
+        }
+        // Filter by agent type
+        if (filter.agent_type) {
+            filtered = filtered.filter((e) => e.agent_type === filter.agent_type);
+        }
+        // Filter by status
+        if (filter.status) {
+            filtered = filtered.filter((e) => e.status === filter.status);
+        }
+        // Filter by exact date
+        if (filter.date) {
+            filtered = filtered.filter((e) => e.date === filter.date);
+        }
+        // Filter by date range (after)
+        if (filter.dateAfter) {
+            filtered = filtered.filter((e) => e.date > filter.dateAfter);
+        }
+        // Filter by date range (before)
+        if (filter.dateBefore) {
+            filtered = filtered.filter((e) => e.date < filter.dateBefore);
+        }
+        // Filter by topic
+        if (filter.topic) {
+            filtered = filtered.filter((e) => e.topics.includes(filter.topic));
+        }
+        // Filter by actionable flag
+        if (filter.actionable !== undefined) {
+            filtered = filtered.filter((e) => e.actionable === filter.actionable);
+        }
+        // Apply limit
+        if (filter.limit && filter.limit > 0) {
+            filtered = filtered.slice(0, filter.limit);
+        }
+        return filtered;
+    }
+    /**
+     * Get entries for specific task
+     *
+     * Convenience method to get all manifest entries linked to a task ID.
+     * Searches both the entry ID prefix and linked_tasks array.
+     *
+     * @param taskId - Task ID to search for (e.g., "T2919")
+     * @returns Array of entries linked to task
+     */
+    async getTaskEntries(taskId) {
+        const entries = await this.readManifest();
+        return this.filterEntries(entries, { taskId });
+    }
+    /**
+     * Validate manifest entry
+     *
+     * Checks required fields, format constraints, and data integrity.
+     * Returns detailed validation results with field-level errors.
+     *
+     * @param entry - Manifest entry to validate
+     * @returns Validation result with errors
+     */
+    validateEntry(entry) {
+        const errors = [];
+        // Required fields
+        if (!entry.id) {
+            errors.push({ field: 'id', message: 'id is required', severity: 'error' });
+        }
+        else if (!/^T\d{3,}-[a-z0-9-]+$/.test(entry.id)) {
+            errors.push({
+                field: 'id',
+                message: 'id must match pattern T####-slug',
+                severity: 'error',
+            });
+        }
+        if (!entry.file) {
+            errors.push({ field: 'file', message: 'file is required', severity: 'error' });
+        }
+        if (!entry.title) {
+            errors.push({ field: 'title', message: 'title is required', severity: 'error' });
+        }
+        if (!entry.date) {
+            errors.push({ field: 'date', message: 'date is required', severity: 'error' });
+        }
+        else if (!/^\d{4}-\d{2}-\d{2}$/.test(entry.date)) {
+            errors.push({
+                field: 'date',
+                message: 'date must be ISO-8601 format (YYYY-MM-DD)',
+                severity: 'error',
+            });
+        }
+        if (!entry.status) {
+            errors.push({ field: 'status', message: 'status is required', severity: 'error' });
+        }
+        else if (!['complete', 'partial', 'blocked'].includes(entry.status)) {
+            errors.push({
+                field: 'status',
+                message: 'status must be complete, partial, or blocked',
+                severity: 'error',
+            });
+        }
+        if (!entry.agent_type) {
+            errors.push({ field: 'agent_type', message: 'agent_type is required', severity: 'error' });
+        }
+        if (!entry.topics) {
+            errors.push({ field: 'topics', message: 'topics array is required', severity: 'error' });
+        }
+        else if (!Array.isArray(entry.topics)) {
+            errors.push({ field: 'topics', message: 'topics must be an array', severity: 'error' });
+        }
+        if (entry.actionable === undefined) {
+            errors.push({ field: 'actionable', message: 'actionable is required', severity: 'error' });
+        }
+        // Optional field validation
+        if (entry.key_findings) {
+            if (!Array.isArray(entry.key_findings)) {
+                errors.push({
+                    field: 'key_findings',
+                    message: 'key_findings must be an array',
+                    severity: 'error',
+                });
+            }
+            else if (entry.key_findings.length < 3 || entry.key_findings.length > 7) {
+                errors.push({
+                    field: 'key_findings',
+                    message: 'key_findings should have 3-7 items',
+                    severity: 'warning',
+                });
+            }
+        }
+        if (entry.confidence !== undefined) {
+            if (typeof entry.confidence !== 'number') {
+                errors.push({
+                    field: 'confidence',
+                    message: 'confidence must be a number',
+                    severity: 'error',
+                });
+            }
+            else if (entry.confidence < 0 || entry.confidence > 1) {
+                errors.push({
+                    field: 'confidence',
+                    message: 'confidence must be between 0.0 and 1.0',
+                    severity: 'error',
+                });
+            }
+        }
+        return {
+            valid: errors.filter((e) => e.severity === 'error').length === 0,
+            errors,
+        };
+    }
+    /**
+     * Validate entire manifest
+     *
+     * Reads manifest and validates all entries. Returns aggregated
+     * validation results with entry-level details.
+     *
+     * @returns Validation results for all entries
+     */
+    async validateManifest() {
+        const entries = await this.readManifest();
+        const results = entries.map((entry) => ({
+            entryId: entry.id,
+            validation: this.validateEntry(entry),
+        }));
+        const invalidEntries = results.filter((r) => !r.validation.valid);
+        return {
+            valid: invalidEntries.length === 0,
+            totalEntries: entries.length,
+            validEntries: results.length - invalidEntries.length,
+            invalidEntries: invalidEntries.length,
+            errors: invalidEntries.map((r) => ({
+                entryId: r.entryId,
+                errors: r.validation.errors,
+            })),
+        };
+    }
+    /**
+     * Get summary statistics from manifest
+     *
+     * Aggregates manifest entries into summary statistics for reporting.
+     *
+     * @returns Summary statistics
+     */
+    async getSummary() {
+        const entries = await this.readManifest();
+        const byStatus = {};
+        const byAgentType = {};
+        let actionable = 0;
+        let needsFollowup = 0;
+        for (const entry of entries) {
+            // Count by status
+            byStatus[entry.status] = (byStatus[entry.status] || 0) + 1;
+            // Count by agent type
+            byAgentType[entry.agent_type] = (byAgentType[entry.agent_type] || 0) + 1;
+            // Count actionable
+            if (entry.actionable) {
+                actionable++;
+            }
+            // Count needs followup
+            if (entry.needs_followup && entry.needs_followup.length > 0) {
+                needsFollowup++;
+            }
+        }
+        return {
+            total: entries.length,
+            byStatus,
+            byAgentType,
+            actionable,
+            needsFollowup,
+        };
+    }
+}
+/**
+ * Create manifest reader instance
+ *
+ * Factory function for creating configured ManifestReader.
+ *
+ * @param manifestPath - Path to MANIFEST.jsonl (relative to baseDir)
+ * @param baseDir - Base directory (default: cwd)
+ * @returns Configured ManifestReader
+ */
+export function createManifestReader(manifestPath, baseDir) {
+    return new ManifestReader(manifestPath, baseDir);
+}
+//# sourceMappingURL=manifest.js.map

package/dist/mcp/lib/manifest.js.map

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

package/dist/mcp/lib/mode-detector.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Execution Mode Detector
+ *
+ * Detects whether the CLEO CLI is available and determines the execution mode
+ * for the MCP server. Supports three modes:
+ *
+ * - native: TypeScript engine only (cross-platform, no bash needed)
+ * - cli: CLI subprocess only (Unix, requires bash + jq)
+ * - auto: Detect CLI availability; prefer CLI when found, fallback to native
+ *
+ * Controlled by MCP_EXECUTION_MODE environment variable.
+ */
+/**
+ * Execution mode for the MCP server
+ */
+export type ServerExecutionMode = 'native' | 'cli' | 'auto';
+/**
+ * Resolved execution mode after detection
+ */
+export type ResolvedMode = 'native' | 'cli';
+/**
+ * Detection result with metadata
+ */
+export interface ModeDetectionResult {
+    /** The resolved execution mode */
+    mode: ResolvedMode;
+    /** The configured mode (from env) */
+    configuredMode: ServerExecutionMode;
+    /** Whether CLI was detected as available */
+    cliAvailable: boolean;
+    /** Path to CLI binary (if found) */
+    cliPath: string | null;
+    /** CLI version (if available) */
+    cliVersion: string | null;
+    /** Reason for mode selection */
+    reason: string;
+}
+/**
+ * Detect CLI availability and determine execution mode.
+ *
+ * Priority:
+ * 1. MCP_EXECUTION_MODE env: 'cli' (force CLI), 'native' (force native), 'auto' (default)
+ * 2. If auto: check CLEO_MCP_CLI_PATH env -> if set and executable, prefer CLI
+ * 3. If auto: check which/where cleo -> if found, prefer CLI
+ * 4. If auto: no CLI found -> native mode
+ */
+export declare function detectExecutionMode(): ModeDetectionResult;
+/**
+ * Create the E_CLI_REQUIRED error response
+ */
+export declare function createCLIRequiredError(domain: string, operation: string): {
+    success: false;
+    error: {
+        code: string;
+        message: string;
+        availableInStandaloneMode: boolean;
+        nativeAlternatives: string[];
+    };
+};
+/**
+ * Create the E_NOT_INITIALIZED error response
+ */
+export declare function createNotInitializedError(): {
+    success: false;
+    error: {
+        code: string;
+        message: string;
+        fix: string;
+    };
+};
+//# sourceMappingURL=mode-detector.d.ts.map

package/dist/mcp/lib/mode-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode-detector.d.ts","sourceRoot":"","sources":["../../../src/mcp/lib/mode-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,IAAI,EAAE,YAAY,CAAC;IACnB,qCAAqC;IACrC,cAAc,EAAE,mBAAmB,CAAC;IACpC,4CAA4C;IAC5C,YAAY,EAAE,OAAO,CAAC;IACtB,oCAAoC;IACpC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,iCAAiC;IACjC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,IAAI,mBAAmB,CA4DzD;AA8FD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG;IACzE,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,yBAAyB,EAAE,OAAO,CAAC;QACnC,kBAAkB,EAAE,MAAM,EAAE,CAAC;KAC9B,CAAC;CACH,CAUA;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI;IAC3C,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH,CASA"}