@cleocode/core 2026.3.41 → 2026.3.43

package/dist/validation/verification.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Verification gates management - ported from lib/validation/verification.sh
+ *
+ * Implements gate dependency chains, round management, failure logging,
+ * epic lifecycle transitions, and circular validation prevention.
+ *
+ * Gate Dependency Chain:
+ *   implemented -> testsPassed -> qaPassed -> cleanupDone -> securityPassed -> documented
+ *
+ * @task T4526
+ * @epic T4454
+ */
+export declare const VERIFICATION_GATE_ORDER: readonly ["implemented", "testsPassed", "qaPassed", "cleanupDone", "securityPassed", "documented"];
+export type GateName = (typeof VERIFICATION_GATE_ORDER)[number];
+export declare const VERIFICATION_VALID_AGENTS: readonly ["planner", "coder", "testing", "qa", "cleanup", "security", "docs"];
+export type AgentName = (typeof VERIFICATION_VALID_AGENTS)[number];
+export interface FailureLogEntry {
+    gate: GateName;
+    agent: string;
+    reason: string;
+    timestamp: string;
+    round: number;
+}
+export interface VerificationGates {
+    implemented: boolean | null;
+    testsPassed: boolean | null;
+    qaPassed: boolean | null;
+    cleanupDone: boolean | null;
+    securityPassed: boolean | null;
+    documented: boolean | null;
+}
+export interface Verification {
+    passed: boolean;
+    round: number;
+    gates: VerificationGates;
+    lastAgent: string | null;
+    lastUpdated: string;
+    failureLog: FailureLogEntry[];
+}
+export type VerificationStatus = 'pending' | 'in-progress' | 'passed' | 'failed';
+/** @task T4526 */
+export declare function isValidGateName(name: string): name is GateName;
+/** @task T4526 */
+export declare function isValidAgentName(name: string): name is AgentName;
+/** @task T4526 */
+export declare function getGateOrder(): GateName[];
+/** @task T4526 */
+export declare function getGateIndex(gateName: GateName): number;
+/** @task T4526 */
+export declare function getDownstreamGates(fromGate: GateName): GateName[];
+/**
+ * Initialize a new verification object with default values.
+ * @task T4526
+ */
+export declare function initVerification(): Verification;
+/**
+ * Compute whether verification has passed based on required gates.
+ * @task T4526
+ */
+export declare function computePassed(verification: Verification, requiredGates?: GateName[]): boolean;
+/**
+ * Update the passed field on a verification object.
+ * @task T4526
+ */
+export declare function setVerificationPassed(verification: Verification, passed: boolean): Verification;
+/**
+ * Update a single gate value.
+ * @task T4526
+ */
+export declare function updateGate(verification: Verification, gateName: GateName, value: boolean | null, agent?: string): Verification;
+/**
+ * Reset all downstream gates to null after a gate failure.
+ * @task T4526
+ */
+export declare function resetDownstreamGates(verification: Verification, fromGate: GateName): Verification;
+/**
+ * Increment the round counter.
+ * Returns null if max rounds exceeded.
+ * @task T4526
+ */
+export declare function incrementRound(verification: Verification, maxRounds?: number): Verification | null;
+/**
+ * Log a failure to the failureLog array.
+ * @task T4526
+ */
+export declare function logFailure(verification: Verification, gateName: GateName, agent: string, reason: string): Verification;
+/**
+ * Check if all required gates have passed.
+ * @task T4526
+ */
+export declare function checkAllGatesPassed(verification: Verification, requiredGates?: GateName[]): boolean;
+/**
+ * Check if verification is complete (passed = true).
+ * @task T4526
+ */
+export declare function isVerificationComplete(verification: Verification | null): boolean;
+/**
+ * Get verification status for display.
+ * @task T4526
+ */
+export declare function getVerificationStatus(verification: Verification | null): VerificationStatus;
+/**
+ * Check if a task type should require verification.
+ * @task T4526
+ */
+export declare function shouldRequireVerification(taskType?: string, verificationEnabled?: boolean): boolean;
+/**
+ * Get gate names that are not yet true.
+ * @task T4526
+ */
+export declare function getMissingGates(verification: Verification, requiredGates?: GateName[]): GateName[];
+/**
+ * Get gate summary for display.
+ * @task T4526
+ */
+export declare function getGateSummary(verification: Verification): {
+    passed: boolean;
+    round: number;
+    gates: VerificationGates;
+    lastAgent: string | null;
+    lastUpdated: string;
+    failureCount: number;
+};
+export interface CircularValidationResult {
+    valid: boolean;
+    error?: string;
+    code?: number;
+}
+/**
+ * Check for circular validation (self-approval prevention).
+ * Prevents: creator validating own work, validator re-testing, tester self-creating.
+ * @task T4526
+ */
+export declare function checkCircularValidation(currentAgent: string, createdBy?: string | null, validatedBy?: string | null, testedBy?: string | null): CircularValidationResult;
+export interface TaskForVerification {
+    id: string;
+    status: string;
+    parentId?: string | null;
+    type?: string;
+    verification?: Verification | null;
+    epicLifecycle?: string;
+}
+/**
+ * Check if all children of an epic have verification.passed = true.
+ * @task T4526
+ */
+export declare function allEpicChildrenVerified(epicId: string, tasks: TaskForVerification[]): boolean;
+/**
+ * Check if all siblings of a task are verified.
+ * @task T4526
+ */
+export declare function allSiblingsVerified(parentId: string, tasks: TaskForVerification[]): boolean;
+//# sourceMappingURL=verification.d.ts.map

package/dist/validation/verification.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/core",
-  "version": "2026.3.41",
+  "version": "2026.3.43",
   "description": "CLEO core business logic kernel — tasks, sessions, memory, orchestration, lifecycle, with bundled SQLite store",
   "type": "module",
   "main": "./dist/index.js",
@@ -36,7 +36,7 @@
     "write-file-atomic": "^6.0.0",
     "yaml": "^2.8.2",
     "zod": "^3.25.76",
-    "@cleocode/contracts": "2026.3.41"
+    "@cleocode/contracts": "2026.3.43"
   },
   "engines": {
     "node": ">=24.0.0"