@cleocode/cleo 2026.4.10 → 2026.4.11

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

@@ -0,0 +1,218 @@
+/**
+ * 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;
+    siblingCount?: number;
+    descriptionClarity?: boolean;
+    maxSiblings?: number;
+    maxDepth?: number;
+    specFile?: string;
+    hasTaskTags?: boolean;
+    hasContributionTags?: boolean;
+    hasCodeChanges?: boolean;
+    version?: string;
+    hasChangelog?: boolean;
+    artifactType?: string;
+    buildPassed?: boolean;
+    hasAttestation?: boolean;
+    hasSbom?: boolean;
+    adrContent?: string;
+    status?: 'proposed' | 'accepted' | 'superseded' | 'deprecated';
+    hitlReviewed?: boolean;
+    downstreamFlagged?: boolean;
+    persistedInDb?: boolean;
+    specMatchConfirmed?: boolean;
+    testSuitePassed?: boolean;
+    protocolComplianceChecked?: boolean;
+    framework?: string;
+    testsRun?: number;
+    testsPassed?: number;
+    testsFailed?: number;
+    coveragePercent?: number;
+    coverageThreshold?: number;
+    ivtLoopConverged?: boolean;
+    ivtLoopIterations?: number;
+}
+/**
+ * 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>;
+/**
+ * check.protocol.research - Validate research protocol compliance
+ * @task T260
+ */
+export declare function validateProtocolResearch(params: ProtocolValidationParams, _projectRoot?: string): Promise<EngineResult>;
+/**
+ * check.protocol.architecture-decision - Validate ADR protocol compliance
+ * @task T260
+ */
+export declare function validateProtocolArchitectureDecision(params: ProtocolValidationParams, _projectRoot?: string): Promise<EngineResult>;
+/**
+ * check.protocol.validation - Validate validation-stage protocol compliance
+ * @task T260
+ */
+export declare function validateProtocolValidation(params: ProtocolValidationParams, _projectRoot?: string): Promise<EngineResult>;
+/**
+ * check.protocol.testing - Validate testing-stage protocol compliance (IVT loop)
+ * @task T260
+ */
+export declare function validateProtocolTesting(params: ProtocolValidationParams, _projectRoot?: string): Promise<EngineResult>;
+/**
+ * check.protocol.release - Validate release protocol compliance
+ * @task T260
+ */
+export declare function validateProtocolRelease(params: ProtocolValidationParams, _projectRoot?: string): Promise<EngineResult>;
+/**
+ * check.protocol.artifact-publish - Validate artifact-publish protocol compliance
+ * @task T260
+ */
+export declare function validateProtocolArtifactPublish(params: ProtocolValidationParams, _projectRoot?: string): Promise<EngineResult>;
+/**
+ * check.protocol.provenance - Validate provenance protocol compliance
+ * @task T260
+ */
+export declare function validateProtocolProvenance(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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"}