@cleocode/core 2026.3.42 → 2026.3.43

package/dist/validation/doctor/utils.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Doctor utility functions - ported from lib/validation/doctor-utils.sh
+ *
+ * Functions for project categorization, health summaries, journey stage
+ * detection, and guidance generation.
+ *
+ * @task T4525
+ * @epic T4454
+ */
+export interface ProjectDetail {
+    name: string;
+    path: string;
+    status: 'healthy' | 'warning' | 'failed' | 'orphaned';
+    issues?: string[];
+    isTemp: boolean;
+    isOrphaned?: boolean;
+    reason?: string;
+}
+export interface CategorizedProjects {
+    active: ProjectDetail[];
+    temp: ProjectDetail[];
+    orphaned: ProjectDetail[];
+}
+export type UserJourneyStage = 'new-user' | 'cleanup-needed' | 'setup-agents-needed' | 'maintenance-mode';
+/**
+ * Check if a project path is a temporary/test directory.
+ * @task T4525
+ */
+export declare function isTempProject(path: string): boolean;
+/**
+ * Filter projects into categories: active, temp, orphaned.
+ * @task T4525
+ */
+export declare function categorizeProjects(projects: ProjectDetail[]): CategorizedProjects;
+/**
+ * Get human-readable project category name.
+ * @task T4525
+ */
+export declare function getProjectCategoryName(category: 'active' | 'temp' | 'orphaned'): string;
+export interface HealthSummary {
+    total: number;
+    healthy: number;
+    warnings: number;
+    failed: number;
+    orphaned: number;
+    temp: number;
+}
+/**
+ * Format project health summary for display.
+ * @task T4525
+ */
+export declare function formatProjectHealthSummary(summary: HealthSummary): string;
+/**
+ * Get actionable guidance for project issues.
+ * @task T4525
+ */
+export declare function getProjectGuidance(activeFailed: number, activeWarnings: number, tempCount: number, orphanedCount: number): string[];
+/**
+ * Check user journey stage based on system state.
+ * @task T4525
+ */
+export declare function getUserJourneyStage(hasProjects: boolean, tempProjectCount: number, agentConfigsOk: boolean): UserJourneyStage;
+/**
+ * Get journey-specific guidance text.
+ * @task T4525
+ */
+export declare function getJourneyGuidance(stage: UserJourneyStage): string[];
+//# sourceMappingURL=utils.d.ts.map

package/dist/validation/doctor/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/validation/doctor/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;IACtD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,IAAI,EAAE,aAAa,EAAE,CAAC;IACtB,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,MAAM,MAAM,gBAAgB,GACxB,UAAU,GACV,gBAAgB,GAChB,qBAAqB,GACrB,kBAAkB,CAAC;AAQvB;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKnD;AAMD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,mBAAmB,CAgBjF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,CASvF;AAMD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAqBzE;AAMD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,GACpB,MAAM,EAAE,CA0BV;AAMD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,OAAO,EACpB,gBAAgB,EAAE,MAAM,EACxB,cAAc,EAAE,OAAO,GACtB,gBAAgB,CAKlB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAwBpE"}

package/dist/validation/engine.d.ts

@@ -0,0 +1,171 @@
+/**
+ * Core validation engine - ported from lib/validation/validation.sh
+ *
+ * Provides schema validation, task field validation, status transitions,
+ * timestamp sanity checks, ID uniqueness, phase validation, circular
+ * dependency detection, and comprehensive file validation.
+ *
+ * @task T4523
+ * @epic T4454
+ */
+import { type TaskStatus } from '@cleocode/contracts';
+export type { TaskStatus } from '@cleocode/contracts';
+export declare const VALID_OPERATIONS: readonly ["create", "update", "complete", "archive", "restore", "delete", "validate", "backup"];
+/** Field length limits matching the Bash implementation. */
+export declare const FIELD_LIMITS: {
+    readonly MAX_TITLE_LENGTH: 120;
+    readonly MAX_DESCRIPTION_LENGTH: 2000;
+    readonly MAX_NOTE_LENGTH: 5000;
+    readonly MAX_BLOCKED_BY_LENGTH: 300;
+    readonly MAX_SESSION_NOTE_LENGTH: 2500;
+    readonly MIN_CANCEL_REASON_LENGTH: 5;
+    readonly MAX_CANCEL_REASON_LENGTH: 300;
+};
+/** Validation result exit codes. */
+export declare const VAL_SUCCESS = 0;
+export declare const VAL_SCHEMA_ERROR = 1;
+export declare const VAL_SEMANTIC_ERROR = 2;
+export declare const VAL_BOTH_ERRORS = 3;
+export interface ValidationError {
+    field?: string;
+    message: string;
+    severity: 'error' | 'warning';
+    fix?: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationError[];
+}
+/**
+ * Sanitize a file path for safe shell usage.
+ * Prevents command injection via malicious file names.
+ * @task T4523
+ */
+export declare function sanitizeFilePath(path: string): string;
+/**
+ * Validate a task title.
+ * Checks for emptiness, newlines, invisible characters, control chars, and length.
+ * @task T4523
+ */
+export declare function validateTitle(title: string): ValidationResult;
+/** @task T4523 */
+export declare function validateDescription(desc: string): ValidationResult;
+/** @task T4523 */
+export declare function validateNote(note: string): ValidationResult;
+/** @task T4523 */
+export declare function validateBlockedBy(reason: string): ValidationResult;
+/** @task T4523 */
+export declare function validateSessionNote(note: string): ValidationResult;
+/**
+ * Validate a cancellation reason.
+ * @task T4523
+ */
+export declare function validateCancelReason(reason: string): ValidationResult;
+/**
+ * Validate that a status transition is allowed.
+ * @task T4523
+ */
+export declare function validateStatusTransition(oldStatus: TaskStatus, newStatus: TaskStatus): ValidationResult;
+/**
+ * Check if a status string is valid.
+ * @task T4523
+ */
+export declare function isValidStatus(status: string): status is TaskStatus;
+/**
+ * Check timestamp format and sanity.
+ * @task T4523
+ */
+export declare function checkTimestampSanity(createdAt: string, completedAt?: string): ValidationResult;
+/**
+ * Check if an update contains only metadata fields (safe for done tasks).
+ * @task T4523
+ */
+export declare function isMetadataOnlyUpdate(fields: string[]): boolean;
+/**
+ * Deduplicate and normalize labels.
+ * @task T4523
+ */
+export declare function normalizeLabels(labels: string): string;
+export interface Task {
+    id?: string;
+    content?: string;
+    title?: string;
+    status?: string;
+    activeForm?: string;
+    created_at?: string;
+    completed_at?: string;
+    parentId?: string | null;
+    type?: string;
+    depends?: string[];
+    cancelledAt?: string;
+    cancellationReason?: string;
+    [key: string]: unknown;
+}
+export interface TaskFile {
+    tasks: Task[];
+    project?: {
+        currentPhase?: string;
+        phases?: Record<string, {
+            status?: string;
+            startedAt?: string;
+            completedAt?: string;
+        }>;
+    };
+    [key: string]: unknown;
+}
+export interface ArchiveFile {
+    archived_tasks: Task[];
+    [key: string]: unknown;
+}
+/**
+ * Check ID uniqueness within and across files.
+ * @task T4523
+ */
+export declare function checkIdUniqueness(taskFile: TaskFile, archiveFile?: ArchiveFile): ValidationResult;
+/**
+ * Validate a single task object.
+ * @task T4523
+ */
+export declare function validateTask(task: Task): ValidationResult;
+/**
+ * Check for circular dependencies using DFS.
+ * @task T4523
+ */
+export declare function validateNoCircularDeps(tasks: Task[], taskId: string, newDeps: string[]): ValidationResult;
+/**
+ * Validate only one phase is active.
+ * @task T4523
+ */
+export declare function validateSingleActivePhase(taskFile: TaskFile): ValidationResult;
+/**
+ * Validate currentPhase matches an active phase.
+ * @task T4523
+ */
+export declare function validateCurrentPhaseConsistency(taskFile: TaskFile): ValidationResult;
+/**
+ * Validate phase timestamp ordering.
+ * @task T4523
+ */
+export declare function validatePhaseTimestamps(taskFile: TaskFile): ValidationResult;
+/**
+ * Validate phase status requirements (e.g., active phases must have startedAt).
+ * @task T4523
+ */
+export declare function validatePhaseStatusRequirements(taskFile: TaskFile): ValidationResult;
+export interface ComprehensiveValidationResult {
+    schemaErrors: number;
+    semanticErrors: number;
+    exitCode: number;
+    checks: Array<{
+        name: string;
+        passed: boolean;
+        message: string;
+    }>;
+}
+/**
+ * Run all validation checks on a TaskFile.
+ * @task T4523
+ */
+export declare function validateAll(taskFile: TaskFile, archiveFile?: ArchiveFile): ComprehensiveValidationResult;
+//# sourceMappingURL=engine.d.ts.map

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

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

package/dist/validation/gap-check.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Documentation gap analysis - ported from lib/validation/gap-check.sh
+ *
+ * Finds documents in review status, analyzes topic coverage against
+ * canonical docs, and produces gap reports.
+ *
+ * @task T4524
+ * @epic T4454
+ */
+export interface ManifestDoc {
+    id: string;
+    file: string;
+    title: string;
+    topics: string[];
+    linked_tasks: string[];
+    status: string;
+}
+export interface GapEntry {
+    type: string;
+    severity: string;
+    document: string;
+    topic: string;
+    fix: string;
+}
+export interface CoverageEntry {
+    document: string;
+    topic: string;
+}
+export interface GapReport {
+    epicId: string;
+    timestamp: string;
+    reviewDocs: ManifestDoc[];
+    gaps: GapEntry[];
+    coverage: CoverageEntry[];
+    status: 'no_review_docs' | 'ready_to_archive' | 'gaps_detected';
+    canArchive: boolean;
+}
+/**
+ * Parse a MANIFEST.jsonl file into entries.
+ * Skips invalid JSON lines gracefully.
+ * @task T4524
+ */
+export declare function parseManifest(content: string): ManifestDoc[];
+/**
+ * Find documents in review status.
+ * @task T4524
+ */
+export declare function findReviewDocs(entries: ManifestDoc[], filterId?: string): ManifestDoc[];
+/**
+ * Extract markdown headings from file content.
+ * @task T4524
+ */
+export declare function extractTopics(content: string): string[];
+/**
+ * Search for topic coverage in a docs directory.
+ * Returns count of matching files.
+ * @task T4524
+ */
+export declare function searchCanonicalCoverage(topic: string, docsFileContents: Map<string, string>): {
+    topic: string;
+    matches: number;
+    files: string[];
+};
+/**
+ * Analyze documentation coverage for review documents.
+ * @task T4524
+ */
+export declare function analyzeCoverage(reviewDocs: ManifestDoc[], docsFileContents: Map<string, string>, filterId?: string): GapReport;
+/**
+ * Format a gap report for human-readable display.
+ * @task T4524
+ */
+export declare function formatGapReport(report: GapReport): string;
+//# sourceMappingURL=gap-check.d.ts.map

package/dist/validation/gap-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gap-check.d.ts","sourceRoot":"","sources":["../../src/validation/gap-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,WAAW,EAAE,CAAC;IAC1B,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,MAAM,EAAE,gBAAgB,GAAG,kBAAkB,GAAG,eAAe,CAAC;IAChE,UAAU,EAAE,OAAO,CAAC;CACrB;AAMD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAmB5D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,CAMvF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAKvD;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAYrD;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,WAAW,EAAE,EACzB,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACrC,QAAQ,CAAC,EAAE,MAAM,GAChB,SAAS,CA6CX;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CA8CzD"}

package/dist/validation/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Validation system barrel exports.
+ *
+ * Provides the complete validation system ported from lib/validation/*.
+ *
+ * @task T4523
+ * @epic T4454
+ */
+export { TASK_STATUSES } from '@cleocode/contracts';
+export { type ComplianceMetrics, calculateOrchestrationOverhead, calculateTokenEfficiency, checkManifestEntry, checkReturnFormat, type ManifestIntegrity, type OrchestrationOverhead, scoreSubagentCompliance, type TokenEfficiency, type TokenMetrics, } from './compliance.js';
+export { checkCommandsSync, checkWrapperSync, type DriftIssue, type DriftReport, detectDrift, getIndexCommands, getIndexScripts, getScriptCommands, shouldRunDriftDetection, } from './docs-sync.js';
+export * from './doctor/index.js';
+export { type ArchiveFile, type ComprehensiveValidationResult, checkIdUniqueness, checkTimestampSanity, FIELD_LIMITS, isMetadataOnlyUpdate, isValidStatus, normalizeLabels, sanitizeFilePath, type Task, type TaskFile, type TaskStatus, VALID_OPERATIONS, type ValidationError, type ValidationResult, validateAll, validateBlockedBy, validateCancelReason, validateCurrentPhaseConsistency, validateDescription, validateNoCircularDeps, validateNote, validatePhaseStatusRequirements, validatePhaseTimestamps, validateSessionNote, validateSingleActivePhase, validateStatusTransition, validateTask, validateTitle, } from './engine.js';
+export { analyzeCoverage, type CoverageEntry, extractTopics, findReviewDocs, formatGapReport, type GapEntry, type GapReport, parseManifest, searchCanonicalCoverage, } from './gap-check.js';
+export { type ComplianceEntry, findManifestEntry, logRealCompliance, type ManifestEntry, type ManifestValidationResult, type ManifestViolation, validateAndLog, validateManifestEntry, } from './manifest.js';
+export { checkAgentType, checkDocumentationSections, checkKeyFindingsCount, checkLinkedTasksPresent, checkManifestFieldPresent, checkManifestFieldType, checkOutputFileExists, checkProvenanceTags, checkReturnMessageFormat, checkStatusValid, type ProtocolValidationResult, type ProtocolViolation, validateCommonManifestRequirements, } from './protocol-common.js';
+export { type AgentName, allEpicChildrenVerified, allSiblingsVerified, type CircularValidationResult, checkAllGatesPassed, checkCircularValidation, computePassed, type FailureLogEntry, type GateName, getDownstreamGates, getGateIndex, getGateOrder, getGateSummary, getMissingGates, getVerificationStatus, incrementRound, initVerification, isValidAgentName, isValidGateName, isVerificationComplete, logFailure, resetDownstreamGates, setVerificationPassed, shouldRequireVerification, type TaskForVerification, updateGate, VERIFICATION_GATE_ORDER, VERIFICATION_VALID_AGENTS, type Verification, type VerificationGates, type VerificationStatus, } from './verification.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EACL,KAAK,iBAAiB,EACtB,8BAA8B,EAC9B,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,uBAAuB,EACvB,KAAK,eAAe,EACpB,KAAK,YAAY,GAClB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AAExB,cAAc,mBAAmB,CAAC;AAClC,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,6BAA6B,EAClC,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,KAAK,IAAI,EACT,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,gBAAgB,EAChB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,+BAA+B,EAC/B,mBAAmB,EACnB,sBAAsB,EACtB,YAAY,EACZ,+BAA+B,EAC/B,uBAAuB,EACvB,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,YAAY,EACZ,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,eAAe,EACf,KAAK,aAAa,EAClB,aAAa,EACb,cAAc,EACd,eAAe,EACf,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,aAAa,EACb,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,KAAK,eAAe,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,aAAa,EAClB,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,EACtB,cAAc,EACd,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,cAAc,EACd,0BAA0B,EAC1B,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,EACzB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,EAChB,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,EACtB,kCAAkC,GACnC,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,KAAK,SAAS,EACd,uBAAuB,EACvB,mBAAmB,EACnB,KAAK,wBAAwB,EAC7B,mBAAmB,EACnB,uBAAuB,EACvB,aAAa,EACb,KAAK,eAAe,EACpB,KAAK,QAAQ,EACb,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,UAAU,EACV,oBAAoB,EACpB,qBAAqB,EACrB,yBAAyB,EACzB,KAAK,mBAAmB,EACxB,UAAU,EACV,uBAAuB,EACvB,yBAAyB,EACzB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAC"}

package/dist/validation/manifest.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Manifest validation - ported from lib/validation/manifest-validation.sh
+ *
+ * Validates subagent output by finding manifest entries, running protocol
+ * validators on actual output, and logging real compliance metrics.
+ *
+ * @task T4526
+ * @epic T4454
+ */
+export interface ManifestEntry {
+    id: string;
+    file: string;
+    title: string;
+    date: string;
+    status: 'completed' | 'partial' | 'blocked';
+    agent_type: string;
+    topics?: string[];
+    key_findings?: string[];
+    actionable?: boolean;
+    needs_followup?: string[];
+    linked_tasks?: string[];
+    [key: string]: unknown;
+}
+export interface ManifestViolation {
+    requirement: string;
+    severity: 'error' | 'warning';
+    message: string;
+    fix?: string;
+}
+export interface ManifestValidationResult {
+    valid: boolean;
+    score: number;
+    pass: boolean;
+    agent_type?: string;
+    violations: ManifestViolation[];
+    note?: string;
+}
+export interface ComplianceEntry {
+    timestamp: string;
+    source_id: string;
+    source_type: string;
+    compliance: {
+        compliance_pass_rate: number;
+        rule_adherence_score: number;
+        violation_count: number;
+        violation_severity: 'none' | 'warning' | 'error';
+        manifest_integrity: 'valid' | 'violations_found';
+    };
+    efficiency: {
+        input_tokens: number;
+        output_tokens: number;
+        context_utilization: number;
+        token_utilization_rate: number;
+    };
+    _context: {
+        agent_type: string;
+        validation_score: number;
+        violations: ManifestViolation[];
+    };
+}
+/**
+ * Find a manifest entry for a task ID in a JSONL file.
+ * @task T4526
+ */
+export declare function findManifestEntry(taskId: string, manifestPath?: string): Promise<ManifestEntry | null>;
+/**
+ * Run validation on a manifest entry for a specific task.
+ * @task T4526
+ */
+export declare function validateManifestEntry(taskId: string, manifestEntry?: ManifestEntry | null, manifestPath?: string): Promise<ManifestValidationResult>;
+/**
+ * Log validation results to the compliance JSONL file.
+ * @task T4526
+ */
+export declare function logRealCompliance(taskId: string, validationResult: ManifestValidationResult, agentType?: string, compliancePath?: string): Promise<void>;
+/**
+ * Find, validate, and log compliance for a task in one call.
+ * @task T4526
+ */
+export declare function validateAndLog(taskId: string, manifestPath?: string, compliancePath?: string): Promise<ManifestValidationResult>;
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/validation/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE;QACV,oBAAoB,EAAE,MAAM,CAAC;QAC7B,oBAAoB,EAAE,MAAM,CAAC;QAC7B,eAAe,EAAE,MAAM,CAAC;QACxB,kBAAkB,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;QACjD,kBAAkB,EAAE,OAAO,GAAG,kBAAkB,CAAC;KAClD,CAAC;IACF,UAAU,EAAE;QACV,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,sBAAsB,EAAE,MAAM,CAAC;KAChC,CAAC;IACF,QAAQ,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,CAAC;QACzB,UAAU,EAAE,iBAAiB,EAAE,CAAC;KACjC,CAAC;CACH;AAeD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CA0B/B;AAMD;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,EACpC,YAAY,GAAE,MAA8B,GAC3C,OAAO,CAAC,wBAAwB,CAAC,CAiHnC;AAMD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,wBAAwB,EAC1C,SAAS,GAAE,MAAkB,EAC7B,cAAc,GAAE,MAAgC,GAC/C,OAAO,CAAC,IAAI,CAAC,CAuCf;AAMD;;;GAGG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,YAAY,GAAE,MAA8B,EAC5C,cAAc,GAAE,MAAgC,GAC/C,OAAO,CAAC,wBAAwB,CAAC,CAyBnC"}

package/dist/validation/operation-gate-validators.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Gate Validators for 4-Layer Operation Verification System
+ *
+ * Individual validator functions for each gate layer:
+ * - Layer 1: Schema validation (JSON Schema, format constraints)
+ * - Layer 2: Semantic validation (business rules, anti-hallucination)
+ * - Layer 3: Referential validation (cross-entity integrity)
+ * - Layer 4: Protocol validation (RCASD-IVTR+C lifecycle)
+ *
+ * Moved from src/mcp/lib/gate-validators.ts to core for proper layering.
+ *
+ * @task T2936
+ * @task T3138
+ * @task T5707
+ * @epic T2908
+ */
+import type { ProtocolEnforcer } from '../compliance/protocol-enforcement.js';
+import { type GateViolation, type LayerResult, type OperationContext, type WorkflowGateTracker } from './operation-verification-gates.js';
+/**
+ * Layer 1: Schema Validation
+ *
+ * Validates operation parameters against JSON Schema definitions.
+ * Checks required fields, data types, and format constraints.
+ */
+export declare function validateLayer1Schema(context: OperationContext): Promise<LayerResult>;
+/**
+ * Layer 2: Semantic Validation
+ *
+ * Validates business rules and logical constraints.
+ */
+export declare function validateLayer2Semantic(context: OperationContext): Promise<LayerResult>;
+/**
+ * Layer 3: Referential Validation
+ *
+ * Validates cross-entity references and relationships.
+ */
+export declare function validateLayer3Referential(context: OperationContext): Promise<LayerResult>;
+/**
+ * Layer 4: Protocol Validation
+ *
+ * Validates RCASD-IVTR+C lifecycle compliance and protocol requirements.
+ */
+export declare function validateLayer4Protocol(context: OperationContext, _enforcer: ProtocolEnforcer): Promise<LayerResult>;
+/**
+ * Validation rule definitions for reuse
+ */
+export declare const GATE_VALIDATION_RULES: {
+    TASK_ID_PATTERN: RegExp;
+    MANIFEST_ID_PATTERN: RegExp;
+    DATE_FORMAT_PATTERN: RegExp;
+    TITLE_MIN_LENGTH: number;
+    TITLE_MAX_LENGTH: number;
+    DESCRIPTION_MIN_LENGTH: number;
+    DESCRIPTION_MAX_LENGTH: number;
+    VALID_STATUSES: readonly ["pending", "active", "blocked", "done", "cancelled", "archived"];
+    VALID_MANIFEST_STATUSES: readonly ["completed", "partial", "blocked", "archived"];
+    VALID_AGENT_TYPES: readonly ["research", "analysis", "specification", "implementation", "testing", "validation", "documentation", "release"];
+    VALID_PRIORITIES: readonly ["critical", "high", "medium", "low"];
+    PRIORITY_NUMERIC_MIN: number;
+    PRIORITY_NUMERIC_MAX: number;
+    MAX_DEPTH: number;
+    MAX_SIBLINGS: number;
+    KEY_FINDINGS_MIN: number;
+    KEY_FINDINGS_MAX: number;
+};
+/**
+ * Helper to check if a field is required for an operation
+ */
+export declare function isFieldRequired(domain: string, operation: string, field: string): boolean;
+/**
+ * Valid workflow gate agent names per Section 7.2
+ */
+export declare const VALID_WORKFLOW_AGENTS: readonly ["coder", "testing", "qa", "cleanup", "security", "docs"];
+/**
+ * Valid workflow gate status values per Section 7.3
+ */
+export declare const VALID_WORKFLOW_GATE_STATUSES: readonly [null, "passed", "failed", "blocked"];
+/**
+ * Validate a workflow gate name
+ *
+ * @task T3141
+ */
+export declare function validateWorkflowGateName(name: string): boolean;
+/**
+ * Validate a workflow gate status value per Section 7.3
+ *
+ * @task T3141
+ */
+export declare function validateWorkflowGateStatus(status: unknown): status is null | 'passed' | 'failed' | 'blocked';
+/**
+ * Validate a gate update operation.
+ *
+ * @task T3141
+ */
+export declare function validateWorkflowGateUpdate(gateName: string, status: string, agent?: string, tracker?: WorkflowGateTracker): GateViolation[];
+//# sourceMappingURL=operation-gate-validators.d.ts.map

package/dist/validation/operation-gate-validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-gate-validators.d.ts","sourceRoot":"","sources":["../../src/validation/operation-gate-validators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AASH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAE9E,OAAO,EAGL,KAAK,aAAa,EAElB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EAGrB,KAAK,mBAAmB,EACzB,MAAM,mCAAmC,CAAC;AAE3C;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAiM1F;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAwH5F;AAED;;;;GAIG;AACH,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAsI/F;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,gBAAgB,EACzB,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,WAAW,CAAC,CAgItB;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;CA2BjC,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAezF;AAMD;;GAEG;AACH,eAAO,MAAM,qBAAqB,oEAOxB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,4BAA4B,gDAAiD,CAAC;AAE3F;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,OAAO,GACd,MAAM,IAAI,IAAI,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAElD;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,mBAAmB,GAC5B,aAAa,EAAE,CA8DjB"}