@cleocode/mcp-server 0.86.0

package/dist/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/lib/manifest.js.map

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

package/dist/lib/protocol-enforcement.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Protocol Enforcement Middleware for CLEO MCP Server
+ *
+ * @task T2918
+ * @epic T2908
+ *
+ * Validates RCSD-IVTR lifecycle compliance with exit codes 60-70.
+ * Intercepts domain operations to enforce protocol requirements before execution.
+ *
+ * Reference: lib/protocol-validation.sh, docs/specs/MCP-SERVER-SPECIFICATION.md
+ */
+import { ProtocolViolation, ProtocolValidationResult } from './protocol-rules.js';
+import { DomainRequest, DomainResponse } from './router.js';
+/**
+ * Protocol types aligned with RCSD-IVTR lifecycle
+ */
+export declare enum ProtocolType {
+    RESEARCH = "research",
+    CONSENSUS = "consensus",
+    SPECIFICATION = "specification",
+    DECOMPOSITION = "decomposition",
+    IMPLEMENTATION = "implementation",
+    CONTRIBUTION = "contribution",
+    RELEASE = "release",
+    VALIDATION = "validation",
+    TESTING = "testing"
+}
+/**
+ * Violation log entry
+ */
+export interface ViolationLogEntry {
+    timestamp: string;
+    taskId?: string;
+    protocol: ProtocolType;
+    violations: ProtocolViolation[];
+    score: number;
+    blocked: boolean;
+}
+/**
+ * Main protocol enforcement class
+ */
+export declare class ProtocolEnforcer {
+    private violations;
+    private strictMode;
+    constructor(strictMode?: boolean);
+    /**
+     * Validate protocol compliance for a manifest entry
+     */
+    validateProtocol(protocol: ProtocolType, manifestEntry: Record<string, unknown>, additionalData?: Record<string, unknown>): Promise<ProtocolValidationResult>;
+    /**
+     * Validate a single rule
+     */
+    private validateRule;
+    /**
+     * Check lifecycle gate prerequisites
+     */
+    checkLifecycleGate(taskId: string, targetStage: string, rcsdManifest?: Record<string, unknown>): Promise<{
+        passed: boolean;
+        missingPrerequisites: string[];
+        message: string;
+    }>;
+    /**
+     * Record a protocol violation
+     */
+    recordViolation(protocol: ProtocolType, violations: ProtocolViolation[], score: number, taskId?: string): void;
+    /**
+     * Get recent violations
+     */
+    getViolations(limit?: number): ViolationLogEntry[];
+    /**
+     * Calculate penalty for violation severity
+     */
+    private calculatePenalty;
+    /**
+     * Middleware function for domain router
+     *
+     * Intercepts operations and validates protocol compliance before execution.
+     */
+    enforceProtocol(request: DomainRequest, next: () => Promise<DomainResponse>): Promise<DomainResponse>;
+    /**
+     * Determine if operation requires protocol validation
+     */
+    private requiresProtocolValidation;
+    /**
+     * Detect protocol type from request/response
+     */
+    private detectProtocol;
+    /**
+     * Extract manifest entry from response
+     */
+    private extractManifestEntry;
+    /**
+     * Set strict mode
+     */
+    setStrictMode(strict: boolean): void;
+    /**
+     * Get strict mode status
+     */
+    isStrictMode(): boolean;
+}
+/**
+ * Default protocol enforcer instance
+ */
+export declare const protocolEnforcer: ProtocolEnforcer;
+//# sourceMappingURL=protocol-enforcement.d.ts.map

package/dist/lib/protocol-enforcement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-enforcement.d.ts","sourceRoot":"","sources":["../../src/lib/protocol-enforcement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAgB,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAEhG,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG5D;;GAEG;AACH,oBAAY,YAAY;IACtB,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,aAAa,kBAAkB;IAC/B,aAAa,kBAAkB;IAC/B,cAAc,mBAAmB;IACjC,YAAY,iBAAiB;IAC7B,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,OAAO,YAAY;CACpB;AAgCD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,YAAY,CAAC;IACvB,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,UAAU,CAAU;gBAEhB,UAAU,GAAE,OAAc;IAItC;;OAEG;IACG,gBAAgB,CACpB,QAAQ,EAAE,YAAY,EACtB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvC,OAAO,CAAC,wBAAwB,CAAC;IAoCpC;;OAEG;YACW,YAAY;IA0B1B;;OAEG;IACG,kBAAkB,CACtB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC;QACT,MAAM,EAAE,OAAO,CAAC;QAChB,oBAAoB,EAAE,MAAM,EAAE,CAAC;QAC/B,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAoCF;;OAEG;IACH,eAAe,CACb,QAAQ,EAAE,YAAY,EACtB,UAAU,EAAE,iBAAiB,EAAE,EAC/B,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,GACd,IAAI;IAkBP;;OAEG;IACH,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAIlD;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;;;OAIG;IACG,eAAe,CACnB,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,GAClC,OAAO,CAAC,cAAc,CAAC;IA+D1B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAgBlC;;OAEG;IACH,OAAO,CAAC,cAAc;IAiCtB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAmB5B;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAIpC;;OAEG;IACH,YAAY,IAAI,OAAO;CAGxB;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}