@cleocode/cleo 2026.3.56 → 2026.3.58

package/dist/dispatch/engines/validate-engine.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Validate Engine
+ *
+ * Thin wrapper layer around core validation operations.
+ * Delegates all business logic to src/core/validation/validate-ops.ts.
+ *
+ * @task T4477
+ * @task T4659
+ * @task T4786
+ * @epic T4654
+ */
+import { type CoherenceIssue } from '@cleocode/core/internal';
+import { type EngineResult } from './_error.js';
+/**
+ * validate.schema - JSON Schema validation
+ * @task T4477
+ */
+export declare function validateSchemaOp(type: string, data?: unknown, projectRoot?: string): EngineResult;
+/**
+ * validate.task - Anti-hallucination task validation
+ * @task T4477
+ */
+export declare function validateTask(taskId: string, projectRoot?: string): Promise<EngineResult>;
+/**
+ * validate.protocol - Protocol compliance check
+ * @task T4477
+ */
+export declare function validateProtocol(taskId: string, protocolType?: string, projectRoot?: string): Promise<EngineResult>;
+/**
+ * validate.manifest - Manifest entry validation
+ * @task T4477
+ */
+export declare function validateManifest(projectRoot?: string): EngineResult;
+/**
+ * validate.output - Output file validation
+ * @task T4477
+ */
+export declare function validateOutput(filePath: string, taskId?: string, projectRoot?: string): EngineResult;
+/**
+ * validate.compliance.summary - Aggregated compliance metrics
+ * @task T4477
+ */
+export declare function validateComplianceSummary(projectRoot?: string): EngineResult;
+/**
+ * validate.compliance.violations - List compliance violations
+ * @task T4477
+ */
+export declare function validateComplianceViolations(limit?: number, projectRoot?: string): EngineResult;
+/**
+ * validate.compliance.record - Record compliance check result
+ * @task T4477
+ */
+export declare function validateComplianceRecord(taskId: string, result: string, protocol?: string, violations?: Array<{
+    code: string;
+    message: string;
+    severity: 'warning' | 'error';
+}>, projectRoot?: string): EngineResult;
+/**
+ * validate.test.status - Test suite status
+ * @task T4477
+ */
+export declare function validateTestStatus(projectRoot?: string): EngineResult;
+/**
+ * validate.coherence-check - Cross-validate task graph for consistency
+ * @task T4477
+ */
+export declare function validateCoherenceCheck(projectRoot?: string): Promise<EngineResult<{
+    coherent: boolean;
+    issues: CoherenceIssue[];
+}>>;
+/**
+ * validate.test.run - Execute test suite via subprocess
+ * @task T4632
+ */
+export declare function validateTestRun(params?: {
+    scope?: string;
+    pattern?: string;
+    parallel?: boolean;
+}, projectRoot?: string): EngineResult;
+/**
+ * validate.batch-validate - Batch validate all tasks against schema and rules
+ * @task T4632
+ */
+export declare function validateBatchValidate(projectRoot?: string): Promise<EngineResult>;
+/**
+ * validate.test.coverage - Coverage metrics
+ * @task T4477
+ */
+export declare function validateTestCoverage(projectRoot?: string): EngineResult;
+interface ProtocolValidationParams {
+    mode: 'task' | 'manifest';
+    taskId?: string;
+    manifestFile?: string;
+    strict?: boolean;
+    votingMatrixFile?: string;
+    epicId?: string;
+    specFile?: string;
+}
+/**
+ * check.protocol.consensus - Validate consensus protocol compliance
+ * @task T5327
+ */
+export declare function validateProtocolConsensus(params: ProtocolValidationParams, _projectRoot?: string): Promise<EngineResult>;
+/**
+ * check.protocol.contribution - Validate contribution protocol compliance
+ * @task T5327
+ */
+export declare function validateProtocolContribution(params: ProtocolValidationParams, _projectRoot?: string): Promise<EngineResult>;
+/**
+ * check.protocol.decomposition - Validate decomposition protocol compliance
+ * @task T5327
+ */
+export declare function validateProtocolDecomposition(params: ProtocolValidationParams, _projectRoot?: string): Promise<EngineResult>;
+/**
+ * check.protocol.implementation - Validate implementation protocol compliance
+ * @task T5327
+ */
+export declare function validateProtocolImplementation(params: ProtocolValidationParams, _projectRoot?: string): Promise<EngineResult>;
+/**
+ * check.protocol.specification - Validate specification protocol compliance
+ * @task T5327
+ */
+export declare function validateProtocolSpecification(params: ProtocolValidationParams, _projectRoot?: string): Promise<EngineResult>;
+import type { TaskVerification, VerificationGate } from '@cleocode/contracts';
+interface GateVerifyParams {
+    taskId: string;
+    gate?: string;
+    value?: boolean;
+    agent?: string;
+    all?: boolean;
+    reset?: boolean;
+}
+interface GateVerifyResult {
+    taskId: string;
+    title?: string;
+    status?: string;
+    type?: string;
+    verification: TaskVerification;
+    verificationStatus: 'passed' | 'pending';
+    passed: boolean;
+    round: number;
+    requiredGates: VerificationGate[];
+    missingGates: VerificationGate[];
+    action?: 'view' | 'set_gate' | 'set_all' | 'reset';
+    gateSet?: string;
+    gatesSet?: VerificationGate[];
+}
+/**
+ * check.gate.verify - View or modify verification gates for a task
+ * @task T5327
+ */
+export declare function validateGateVerify(params: GateVerifyParams, projectRoot?: string): Promise<EngineResult<GateVerifyResult>>;
+export {};
+//# sourceMappingURL=validate-engine.d.ts.map

package/dist/dispatch/engines/validate-engine.d.ts.map

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

package/dist/dispatch/engines/validate-engine.js

@@ -0,0 +1,524 @@
+/**
+ * Validate Engine
+ *
+ * Thin wrapper layer around core validation operations.
+ * Delegates all business logic to src/core/validation/validate-ops.ts.
+ *
+ * @task T4477
+ * @task T4659
+ * @task T4786
+ * @epic T4654
+ */
+import { coreBatchValidate, coreCoherenceCheck, coreComplianceRecord, coreComplianceSummary, coreComplianceViolations, coreTestCoverage, coreTestRun, coreTestStatus, coreValidateManifest, coreValidateOutput, coreValidateProtocol, coreValidateSchema, coreValidateTask, resolveProjectRoot, } from '@cleocode/core/internal';
+import { engineError } from './_error.js';
+/**
+ * validate.schema - JSON Schema validation
+ * @task T4477
+ */
+export function validateSchemaOp(type, data, projectRoot) {
+    try {
+        const root = projectRoot || resolveProjectRoot();
+        const result = coreValidateSchema(type, data, root);
+        return { success: true, data: result };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        const code = message.includes('not found')
+            ? 'E_NOT_FOUND'
+            : message.includes('Unknown schema')
+                ? 'E_INVALID_TYPE'
+                : message.includes('required')
+                    ? 'E_INVALID_INPUT'
+                    : 'E_VALIDATION_ERROR';
+        return engineError(code, message);
+    }
+}
+/**
+ * validate.task - Anti-hallucination task validation
+ * @task T4477
+ */
+export async function validateTask(taskId, projectRoot) {
+    try {
+        const root = projectRoot || resolveProjectRoot();
+        const result = await coreValidateTask(taskId, root);
+        return { success: true, data: result };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        const code = message.includes('not found') ? 'E_NOT_FOUND' : 'E_INVALID_INPUT';
+        return engineError(code, message);
+    }
+}
+/**
+ * validate.protocol - Protocol compliance check
+ * @task T4477
+ */
+export async function validateProtocol(taskId, protocolType, projectRoot) {
+    try {
+        const root = projectRoot || resolveProjectRoot();
+        const result = await coreValidateProtocol(taskId, protocolType, root);
+        return { success: true, data: result };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        const code = message.includes('not found') ? 'E_NOT_FOUND' : 'E_INVALID_INPUT';
+        return engineError(code, message);
+    }
+}
+/**
+ * validate.manifest - Manifest entry validation
+ * @task T4477
+ */
+export function validateManifest(projectRoot) {
+    try {
+        const root = projectRoot || resolveProjectRoot();
+        const result = coreValidateManifest(root);
+        return { success: true, data: result };
+    }
+    catch (err) {
+        return engineError('E_FILE_ERROR', err instanceof Error ? err.message : String(err));
+    }
+}
+/**
+ * validate.output - Output file validation
+ * @task T4477
+ */
+export function validateOutput(filePath, taskId, projectRoot) {
+    try {
+        const root = projectRoot || resolveProjectRoot();
+        const result = coreValidateOutput(filePath, taskId, root);
+        return { success: true, data: result };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        const code = message.includes('not found') ? 'E_NOT_FOUND' : 'E_INVALID_INPUT';
+        return engineError(code, message);
+    }
+}
+/**
+ * validate.compliance.summary - Aggregated compliance metrics
+ * @task T4477
+ */
+export function validateComplianceSummary(projectRoot) {
+    try {
+        const root = projectRoot || resolveProjectRoot();
+        const result = coreComplianceSummary(root);
+        return { success: true, data: result };
+    }
+    catch (err) {
+        return engineError('E_FILE_ERROR', err instanceof Error ? err.message : String(err));
+    }
+}
+/**
+ * validate.compliance.violations - List compliance violations
+ * @task T4477
+ */
+export function validateComplianceViolations(limit, projectRoot) {
+    try {
+        const root = projectRoot || resolveProjectRoot();
+        const result = coreComplianceViolations(limit, root);
+        return { success: true, data: result };
+    }
+    catch (err) {
+        return engineError('E_FILE_ERROR', err instanceof Error ? err.message : String(err));
+    }
+}
+/**
+ * validate.compliance.record - Record compliance check result
+ * @task T4477
+ */
+export function validateComplianceRecord(taskId, result, protocol, violations, projectRoot) {
+    try {
+        const root = projectRoot || resolveProjectRoot();
+        const data = coreComplianceRecord(taskId, result, protocol, violations, root);
+        return { success: true, data };
+    }
+    catch (err) {
+        return engineError('E_INVALID_INPUT', err instanceof Error ? err.message : String(err));
+    }
+}
+/**
+ * validate.test.status - Test suite status
+ * @task T4477
+ */
+export function validateTestStatus(projectRoot) {
+    try {
+        const root = projectRoot || resolveProjectRoot();
+        const result = coreTestStatus(root);
+        return { success: true, data: result };
+    }
+    catch (err) {
+        return engineError('E_GENERAL', err instanceof Error ? err.message : String(err));
+    }
+}
+/**
+ * validate.coherence-check - Cross-validate task graph for consistency
+ * @task T4477
+ */
+export async function validateCoherenceCheck(projectRoot) {
+    try {
+        const root = projectRoot || resolveProjectRoot();
+        const result = await coreCoherenceCheck(root);
+        return { success: true, data: result };
+    }
+    catch (err) {
+        return engineError('E_NOT_INITIALIZED', err instanceof Error ? err.message : String(err));
+    }
+}
+/**
+ * validate.test.run - Execute test suite via subprocess
+ * @task T4632
+ */
+export function validateTestRun(params, projectRoot) {
+    try {
+        const root = projectRoot || resolveProjectRoot();
+        const result = coreTestRun(params, root);
+        return { success: true, data: result };
+    }
+    catch (err) {
+        return engineError('E_GENERAL', err instanceof Error ? err.message : String(err));
+    }
+}
+/**
+ * validate.batch-validate - Batch validate all tasks against schema and rules
+ * @task T4632
+ */
+export async function validateBatchValidate(projectRoot) {
+    try {
+        const root = projectRoot || resolveProjectRoot();
+        const result = await coreBatchValidate(root);
+        return { success: true, data: result };
+    }
+    catch (err) {
+        return engineError('E_NOT_FOUND', err instanceof Error ? err.message : String(err));
+    }
+}
+/**
+ * validate.test.coverage - Coverage metrics
+ * @task T4477
+ */
+export function validateTestCoverage(projectRoot) {
+    try {
+        const root = projectRoot || resolveProjectRoot();
+        const result = coreTestCoverage(root);
+        return { success: true, data: result };
+    }
+    catch (err) {
+        return engineError('E_FILE_ERROR', err instanceof Error ? err.message : String(err));
+    }
+}
+// ============================================================================
+// Protocol Validation Operations (T5327)
+// ============================================================================
+import { checkConsensusManifest, checkContributionManifest, checkDecompositionManifest, checkImplementationManifest, checkSpecificationManifest, validateConsensusTask, validateContributionProtocol as validateContributionTask, validateDecompositionTask, validateImplementationTask, validateSpecificationTask, } from '@cleocode/core/internal';
+/**
+ * check.protocol.consensus - Validate consensus protocol compliance
+ * @task T5327
+ */
+export async function validateProtocolConsensus(params, _projectRoot) {
+    try {
+        const { mode, strict, votingMatrixFile } = params;
+        if (mode === 'task') {
+            if (!params.taskId) {
+                return engineError('E_INVALID_INPUT', 'taskId is required for task mode');
+            }
+            const result = await validateConsensusTask(params.taskId, {
+                strict,
+                votingMatrixFile,
+            });
+            return { success: true, data: result };
+        }
+        else {
+            if (!params.manifestFile) {
+                return engineError('E_INVALID_INPUT', 'manifestFile is required for manifest mode');
+            }
+            const result = await checkConsensusManifest(params.manifestFile, {
+                strict,
+                votingMatrixFile,
+            });
+            return { success: true, data: result };
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        const code = message.includes('not found')
+            ? 'E_NOT_FOUND'
+            : message.includes('violations')
+                ? 'E_PROTOCOL_VIOLATION'
+                : 'E_VALIDATION_ERROR';
+        return engineError(code, message);
+    }
+}
+/**
+ * check.protocol.contribution - Validate contribution protocol compliance
+ * @task T5327
+ */
+export async function validateProtocolContribution(params, _projectRoot) {
+    try {
+        const { mode, strict } = params;
+        if (mode === 'task') {
+            if (!params.taskId) {
+                return engineError('E_INVALID_INPUT', 'taskId is required for task mode');
+            }
+            const result = await validateContributionTask(params.taskId, { strict });
+            return { success: true, data: result };
+        }
+        else {
+            if (!params.manifestFile) {
+                return engineError('E_INVALID_INPUT', 'manifestFile is required for manifest mode');
+            }
+            const result = await checkContributionManifest(params.manifestFile, { strict });
+            return { success: true, data: result };
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        const code = message.includes('not found')
+            ? 'E_NOT_FOUND'
+            : message.includes('violations')
+                ? 'E_PROTOCOL_VIOLATION'
+                : 'E_VALIDATION_ERROR';
+        return engineError(code, message);
+    }
+}
+/**
+ * check.protocol.decomposition - Validate decomposition protocol compliance
+ * @task T5327
+ */
+export async function validateProtocolDecomposition(params, _projectRoot) {
+    try {
+        const { mode, strict, epicId } = params;
+        if (mode === 'task') {
+            if (!params.taskId) {
+                return engineError('E_INVALID_INPUT', 'taskId is required for task mode');
+            }
+            const result = await validateDecompositionTask(params.taskId, { strict, epicId });
+            return { success: true, data: result };
+        }
+        else {
+            if (!params.manifestFile) {
+                return engineError('E_INVALID_INPUT', 'manifestFile is required for manifest mode');
+            }
+            const result = await checkDecompositionManifest(params.manifestFile, { strict, epicId });
+            return { success: true, data: result };
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        const code = message.includes('not found')
+            ? 'E_NOT_FOUND'
+            : message.includes('violations')
+                ? 'E_PROTOCOL_VIOLATION'
+                : 'E_VALIDATION_ERROR';
+        return engineError(code, message);
+    }
+}
+/**
+ * check.protocol.implementation - Validate implementation protocol compliance
+ * @task T5327
+ */
+export async function validateProtocolImplementation(params, _projectRoot) {
+    try {
+        const { mode, strict } = params;
+        if (mode === 'task') {
+            if (!params.taskId) {
+                return engineError('E_INVALID_INPUT', 'taskId is required for task mode');
+            }
+            const result = await validateImplementationTask(params.taskId, { strict });
+            return { success: true, data: result };
+        }
+        else {
+            if (!params.manifestFile) {
+                return engineError('E_INVALID_INPUT', 'manifestFile is required for manifest mode');
+            }
+            const result = await checkImplementationManifest(params.manifestFile, { strict });
+            return { success: true, data: result };
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        const code = message.includes('not found')
+            ? 'E_NOT_FOUND'
+            : message.includes('violations')
+                ? 'E_PROTOCOL_VIOLATION'
+                : 'E_VALIDATION_ERROR';
+        return engineError(code, message);
+    }
+}
+/**
+ * check.protocol.specification - Validate specification protocol compliance
+ * @task T5327
+ */
+export async function validateProtocolSpecification(params, _projectRoot) {
+    try {
+        const { mode, strict, specFile } = params;
+        if (mode === 'task') {
+            if (!params.taskId) {
+                return engineError('E_INVALID_INPUT', 'taskId is required for task mode');
+            }
+            const result = await validateSpecificationTask(params.taskId, { strict, specFile });
+            return { success: true, data: result };
+        }
+        else {
+            if (!params.manifestFile) {
+                return engineError('E_INVALID_INPUT', 'manifestFile is required for manifest mode');
+            }
+            const result = await checkSpecificationManifest(params.manifestFile, { strict, specFile });
+            return { success: true, data: result };
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        const code = message.includes('not found')
+            ? 'E_NOT_FOUND'
+            : message.includes('violations')
+                ? 'E_PROTOCOL_VIOLATION'
+                : 'E_VALIDATION_ERROR';
+        return engineError(code, message);
+    }
+}
+import { getAccessor } from '@cleocode/core/internal';
+const VALID_GATES = [
+    'implemented',
+    'testsPassed',
+    'qaPassed',
+    'cleanupDone',
+    'securityPassed',
+    'documented',
+];
+const DEFAULT_REQUIRED_GATES = [
+    'implemented',
+    'testsPassed',
+    'qaPassed',
+    'securityPassed',
+    'documented',
+];
+function initVerification() {
+    return {
+        passed: false,
+        round: 0,
+        gates: {},
+        lastAgent: null,
+        lastUpdated: null,
+        failureLog: [],
+    };
+}
+function computePassed(verification) {
+    for (const gate of DEFAULT_REQUIRED_GATES) {
+        if (verification.gates[gate] !== true)
+            return false;
+    }
+    return true;
+}
+function getMissingGates(verification) {
+    return DEFAULT_REQUIRED_GATES.filter((g) => verification.gates[g] !== true);
+}
+/**
+ * check.gate.verify - View or modify verification gates for a task
+ * @task T5327
+ */
+export async function validateGateVerify(params, projectRoot) {
+    try {
+        const root = projectRoot || resolveProjectRoot();
+        const { taskId, gate, value = true, agent, all, reset } = params;
+        // Validate task ID format
+        const idPattern = /^T\d{3,}$/;
+        if (!idPattern.test(taskId)) {
+            return engineError('E_INVALID_INPUT', `Invalid task ID format: ${taskId}`);
+        }
+        const accessor = await getAccessor(root);
+        const task = await accessor.loadSingleTask(taskId);
+        if (!task) {
+            return engineError('E_NOT_FOUND', `Task ${taskId} not found`);
+        }
+        // View mode (no modifications)
+        if (!gate && !all && !reset) {
+            const verification = task.verification ?? initVerification();
+            const missing = getMissingGates(verification);
+            return {
+                success: true,
+                data: {
+                    taskId,
+                    title: task.title,
+                    status: task.status,
+                    type: task.type ?? 'task',
+                    verification,
+                    verificationStatus: verification.passed ? 'passed' : 'pending',
+                    passed: verification.passed,
+                    round: verification.round,
+                    requiredGates: DEFAULT_REQUIRED_GATES,
+                    missingGates: missing,
+                    action: 'view',
+                },
+            };
+        }
+        // Modification mode
+        let verification = task.verification ?? initVerification();
+        const now = new Date().toISOString();
+        let action = 'view';
+        if (reset) {
+            verification = initVerification();
+            action = 'reset';
+        }
+        else if (all) {
+            for (const g of DEFAULT_REQUIRED_GATES) {
+                verification.gates[g] = true;
+            }
+            if (agent) {
+                verification.lastAgent = agent;
+            }
+            verification.lastUpdated = now;
+            action = 'set_all';
+        }
+        else if (gate) {
+            if (!VALID_GATES.includes(gate)) {
+                return engineError('E_INVALID_INPUT', `Invalid gate: ${gate}. Valid: ${VALID_GATES.join(', ')}`);
+            }
+            verification.gates[gate] = value;
+            if (agent) {
+                verification.lastAgent = agent;
+            }
+            verification.lastUpdated = now;
+            if (!value) {
+                verification.round++;
+                verification.failureLog.push({
+                    round: verification.round,
+                    agent: agent ?? 'unknown',
+                    reason: `Gate ${gate} set to false`,
+                    timestamp: now,
+                });
+            }
+            action = 'set_gate';
+        }
+        verification.passed = computePassed(verification);
+        task.verification = verification;
+        task.updatedAt = now;
+        await accessor.upsertSingleTask(task);
+        const missing = getMissingGates(verification);
+        const result = {
+            taskId,
+            title: task.title,
+            status: task.status,
+            type: task.type ?? 'task',
+            verification,
+            verificationStatus: verification.passed ? 'passed' : 'pending',
+            passed: verification.passed,
+            round: verification.round,
+            requiredGates: DEFAULT_REQUIRED_GATES,
+            missingGates: missing,
+            action,
+        };
+        if (action === 'set_gate') {
+            result.gateSet = gate;
+        }
+        else if (action === 'set_all') {
+            result.gatesSet = DEFAULT_REQUIRED_GATES;
+        }
+        return { success: true, data: result };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return engineError('E_GENERAL', message);
+    }
+}
+//# sourceMappingURL=validate-engine.js.map