@cleocode/core 2026.9.8 → 2026.9.10

package/dist/skills/orchestrator/validator.d.ts

@@ -1,36 +1,103 @@
-/**
- * Orchestrator protocol compliance validation.
- * Ports lib/skills/orchestrator-validator.sh.
- *
- * Validates subagent output compliance, orchestrator behavior,
- * manifest integrity, and pre-spawn compliance checks.
- *
- * @epic T4454
- * @task T4519
- */
 import type { ComplianceResult, ManifestValidationResult } from '../types.js';
 /**
- * Validate a subagent's manifest entry for protocol compliance.
- * @task T4519
+ * Validate one entry in an explicitly selected historical JSONL file synchronously.
+ * @remarks Bare calls cannot validate the authoritative current store and return
+ * an unavailable-current-source issue. Use validateCurrentSubagentOutput for that store.
+ * @param researchId - Exact historical entry identity.
+ * @param cwd - Root used for relative historical paths and output files.
+ * @param historicalManifestPath - Explicit historical file; never inferred from cwd.
+ * @returns Synchronous compliance result with all historical read/parse issues.
+ * @example
+ * ```ts
+ * const result = validateSubagentOutput('entry', '/project', 'history.jsonl');
+ * ```
  */
-export declare function validateSubagentOutput(researchId: string, cwd?: string): {
+export declare function validateSubagentOutput(researchId: string, cwd?: string, historicalManifestPath?: string): {
     passed: boolean;
     issues: string[];
     checkedRules: string[];
 };
 /**
- * Validate the entire manifest file integrity.
- * @task T4519
+ * Validate an explicitly selected historical manifest synchronously.
+ * @remarks This preserves the synchronous return shape without equating a retired
+ * or missing JSONL file with a valid current database. Every malformed row fails.
+ * @param cwd - Root for relative historical and output paths.
+ * @param historicalManifestPath - Explicit historical JSONL file.
+ * @returns Historical validation result; absent explicit source fails.
+ * @example
+ * ```ts
+ * const result = validateManifestIntegrity('/project', 'history.jsonl');
+ * ```
+ */
+export declare function validateManifestIntegrity(cwd?: string, historicalManifestPath?: string): ManifestValidationResult;
+/**
+ * Check exact task linkage and output validity in explicitly selected history.
+ * @remarks Entry names and follow-up requests do not establish task evidence.
+ * Bare synchronous calls fail with current-store async guidance.
+ * @param previousTaskId - Exact task whose evidence is required.
+ * @param researchId - Optional exact historical entry identity.
+ * @param cwd - Root for relative historical and output paths.
+ * @param historicalManifestPath - Explicit historical JSONL file.
+ * @returns Synchronous compliance result, never successful after read/parse failure.
+ * @example
+ * ```ts
+ * const result = verifyCompliance('T1', undefined, '/project', 'history.jsonl');
+ * ```
+ */
+export declare function verifyCompliance(previousTaskId: string, researchId?: string, cwd?: string, historicalManifestPath?: string): ComplianceResult;
+/**
+ * Validate an exact entry from canonical modern and retained historical rows.
+ * @remarks Captures project ownership before awaiting and verifies real output
+ * availability through the same canonical resolver as manifest show.
+ * @param researchId - Exact canonical entry identity.
+ * @param cwd - Optional explicit project root.
+ * @returns Field and output validation result.
+ * @throws If canonical storage, history, metadata or output resolution fails.
+ * @example
+ * ```ts
+ * const result = await validateCurrentSubagentOutput('entry', '/project');
+ * ```
+ */
+export declare function validateCurrentSubagentOutput(researchId: string, cwd?: string): Promise<ReturnType<typeof validateSubagentOutput>>;
+/**
+ * Validate eligible canonical manifest rows and their actual output availability.
+ * @remarks The existing totalLines counter denotes records for the database
+ * source. Empty evidence fails; archived rows remain outside current eligibility.
+ * @param cwd - Optional explicit project root.
+ * @returns Integrity result for current eligible evidence.
+ * @throws If canonical reads, history comparison or output resolution fail.
+ * @example
+ * ```ts
+ * const result = await validateCurrentManifestIntegrity('/project');
+ * ```
  */
-export declare function validateManifestIntegrity(cwd?: string): ManifestValidationResult;
+export declare function validateCurrentManifestIntegrity(cwd?: string): Promise<ManifestValidationResult>;
 /**
- * Verify previous agent completed protocol compliance before spawning next.
- * @task T4519
+ * Check current canonical evidence for an exact task before another spawn.
+ * @remarks Requires explicit task linkage and valid fields/output; identifier
+ * substrings and follow-up requests cannot authorize the next action.
+ * @param previousTaskId - Exact task whose evidence is required.
+ * @param researchId - Optional exact canonical entry identity.
+ * @param cwd - Optional explicit project root.
+ * @returns Compliance result with current canonical evidence checks.
+ * @throws If canonical reads, history comparison or output resolution fail.
+ * @example
+ * ```ts
+ * const result = await verifyCurrentCompliance('T1', undefined, '/project');
+ * ```
  */
-export declare function verifyCompliance(previousTaskId: string, researchId?: string, cwd?: string): ComplianceResult;
+export declare function verifyCurrentCompliance(previousTaskId: string, researchId?: string, cwd?: string): Promise<ComplianceResult>;
 /**
  * Validate orchestrator compliance (post-hoc behavioral checks).
- * @task T4519
+ * @remarks Uses canonical manifest evidence and propagates failed task reads.
+ * @param epicId - Optional epic for dependency completion-order checks.
+ * @param cwd - Optional explicit project root.
+ * @returns Compliance result and observed protocol violations.
+ * @throws If canonical evidence or task storage reads fail.
+ * @example
+ * ```ts
+ * const result = await validateOrchestratorCompliance('T0', '/project');
+ * ```
  */
 export declare function validateOrchestratorCompliance(epicId?: string, cwd?: string): Promise<{
     compliant: boolean;

package/dist/skills/orchestrator/validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/skills/orchestrator/validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAUH,OAAO,KAAK,EAAE,gBAAgB,EAAiB,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAwD7F;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,GAAG,CAAC,EAAE,MAAM,GACX;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAwE/D;AAMD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,wBAAwB,CAkEhF;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,cAAc,EAAE,MAAM,EACtB,UAAU,CAAC,EAAE,MAAM,EACnB,GAAG,CAAC,EAAE,MAAM,GACX,gBAAgB,CA6DlB;AAED;;;GAGG;AACH,wBAAsB,8BAA8B,CAClD,MAAM,CAAC,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC;IACT,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC,CAkDD"}
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/skills/orchestrator/validator.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,gBAAgB,EAAiB,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAiK7F;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,GAAG,CAAC,EAAE,MAAM,EACZ,sBAAsB,CAAC,EAAE,MAAM,GAC9B;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAa/D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,CAAC,EAAE,MAAM,EACZ,sBAAsB,CAAC,EAAE,MAAM,GAC9B,wBAAwB,CAwB1B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,cAAc,EAAE,MAAM,EACtB,UAAU,CAAC,EAAE,MAAM,EACnB,GAAG,CAAC,EAAE,MAAM,EACZ,sBAAsB,CAAC,EAAE,MAAM,GAC9B,gBAAgB,CAWlB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,6BAA6B,CACjD,UAAU,EAAE,MAAM,EAClB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAQpD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,gCAAgC,CACpD,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,wBAAwB,CAAC,CAwBnC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,uBAAuB,CAC3C,cAAc,EAAE,MAAM,EACtB,UAAU,CAAC,EAAE,MAAM,EACnB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,gBAAgB,CAAC,CAQ3B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,8BAA8B,CAClD,MAAM,CAAC,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC;IACT,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC,CA0CD"}