@cleocode/core 2026.3.76 → 2026.4.0

package/dist/validation/protocols/implementation.js

@@ -0,0 +1,59 @@
+/**
+ * Implementation protocol validation.
+ * @task T4537
+ * @epic T4454
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { ExitCode } from '@cleocode/contracts';
+import { CleoError } from '../../errors.js';
+import { getManifestPath } from '../../paths.js';
+function findManifestEntry(taskId, manifestPath) {
+    if (!existsSync(manifestPath))
+        return null;
+    const lines = readFileSync(manifestPath, 'utf-8').trim().split('\n');
+    for (let i = lines.length - 1; i >= 0; i--) {
+        if (lines[i].includes(`"${taskId}"`))
+            return lines[i];
+    }
+    return null;
+}
+/** Validate implementation protocol for a task. */
+export async function validateImplementationTask(taskId, opts) {
+    const manifestPath = getManifestPath();
+    const entry = findManifestEntry(taskId, manifestPath);
+    if (!entry) {
+        throw new CleoError(ExitCode.NOT_FOUND, `No manifest entry found for task ${taskId}`);
+    }
+    const manifest = JSON.parse(entry);
+    const violations = [];
+    // IMPL-007: agent_type check
+    if (manifest.agent_type !== 'implementation') {
+        violations.push({
+            code: 'IMPL-007',
+            severity: 'high',
+            message: `Expected agent_type "implementation", got "${manifest.agent_type}"`,
+        });
+    }
+    const score = violations.length === 0 ? 100 : Math.max(0, 100 - violations.length * 25);
+    const result = {
+        valid: violations.length === 0,
+        violations,
+        score,
+        protocol: 'implementation',
+        taskId,
+    };
+    if (opts.strict && violations.length > 0) {
+        throw new CleoError(64, `Implementation protocol violations for ${taskId}`);
+    }
+    return result;
+}
+/** Validate implementation protocol from manifest file. */
+export async function checkImplementationManifest(manifestFile, opts) {
+    if (!existsSync(manifestFile)) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Manifest file not found: ${manifestFile}`);
+    }
+    const manifest = JSON.parse(readFileSync(manifestFile, 'utf-8'));
+    const taskId = manifest.linked_tasks?.[0] ?? 'UNKNOWN';
+    return validateImplementationTask(taskId, opts);
+}
+//# sourceMappingURL=implementation.js.map

package/dist/validation/protocols/implementation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"implementation.js","sourceRoot":"","sources":["../../../src/validation/protocols/implementation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAUjD,SAAS,iBAAiB,CAAC,MAAc,EAAE,YAAoB;IAC7D,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,KAAK,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrE,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,IAAI,KAAK,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAC,IAAI,MAAM,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC,CAAC,CAAE,CAAC;IAC1D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mDAAmD;AACnD,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,MAAc,EACd,IAA0B;IAE1B,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;IACvC,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACtD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,oCAAoC,MAAM,EAAE,CAAC,CAAC;IACxF,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,UAAU,GAAmC,EAAE,CAAC;IAEtD,6BAA6B;IAC7B,IAAI,QAAQ,CAAC,UAAU,KAAK,gBAAgB,EAAE,CAAC;QAC7C,UAAU,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE,MAAM;YAChB,OAAO,EAAE,8CAA8C,QAAQ,CAAC,UAAU,GAAG;SAC9E,CAAC,CAAC;IACL,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,UAAU,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IACxF,MAAM,MAAM,GAAqB;QAC/B,KAAK,EAAE,UAAU,CAAC,MAAM,KAAK,CAAC;QAC9B,UAAU;QACV,KAAK;QACL,QAAQ,EAAE,gBAAgB;QAC1B,MAAM;KACP,CAAC;IAEF,IAAI,IAAI,CAAC,MAAM,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,SAAS,CAAC,EAAc,EAAE,0CAA0C,MAAM,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,2DAA2D;AAC3D,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,YAAoB,EACpB,IAA0B;IAE1B,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,4BAA4B,YAAY,EAAE,CAAC,CAAC;IACtF,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;IACvD,OAAO,0BAA0B,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAClD,CAAC"}

package/dist/validation/protocols/release-protocol.js

@@ -0,0 +1,60 @@
+/**
+ * Release protocol validation.
+ * IVTR Stage: R (Release)
+ * @task T4804
+ * @epic T4798
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { ExitCode } from '@cleocode/contracts';
+import { CleoError } from '../../errors.js';
+import { getManifestPath } from '../../paths.js';
+function findManifestEntry(taskId, manifestPath) {
+    if (!existsSync(manifestPath))
+        return null;
+    const lines = readFileSync(manifestPath, 'utf-8').trim().split('\n');
+    for (let i = lines.length - 1; i >= 0; i--) {
+        if (lines[i].includes(`"${taskId}"`))
+            return lines[i];
+    }
+    return null;
+}
+/** Validate release protocol for a task. */
+export async function validateReleaseTask(taskId, opts) {
+    const manifestPath = getManifestPath();
+    const entry = findManifestEntry(taskId, manifestPath);
+    if (!entry) {
+        throw new CleoError(ExitCode.NOT_FOUND, `No manifest entry found for task ${taskId}`);
+    }
+    const manifest = JSON.parse(entry);
+    const violations = [];
+    // RLSE-007: agent_type check
+    if (manifest.agent_type !== 'documentation') {
+        violations.push({
+            code: 'RLSE-007',
+            severity: 'high',
+            message: `Expected agent_type "documentation", got "${manifest.agent_type}"`,
+        });
+    }
+    const score = violations.length === 0 ? 100 : Math.max(0, 100 - violations.length * 25);
+    const result = {
+        valid: violations.length === 0,
+        violations,
+        score,
+        protocol: 'release',
+        taskId,
+    };
+    if (opts.strict && violations.length > 0) {
+        throw new CleoError(66, `Release protocol violations for ${taskId}`);
+    }
+    return result;
+}
+/** Validate release protocol from manifest file. */
+export async function checkReleaseManifest(manifestFile, opts) {
+    if (!existsSync(manifestFile)) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Manifest file not found: ${manifestFile}`);
+    }
+    const manifest = JSON.parse(readFileSync(manifestFile, 'utf-8'));
+    const taskId = manifest.linked_tasks?.[0] ?? 'UNKNOWN';
+    return validateReleaseTask(taskId, opts);
+}
+//# sourceMappingURL=release-protocol.js.map

package/dist/validation/protocols/release-protocol.js.map

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

package/dist/validation/protocols/research.js

@@ -0,0 +1,77 @@
+/**
+ * Research protocol validation.
+ * @task T4804
+ * @epic T4798
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { ExitCode } from '@cleocode/contracts';
+import { CleoError } from '../../errors.js';
+import { getManifestPath } from '../../paths.js';
+function findManifestEntry(taskId, manifestPath) {
+    if (!existsSync(manifestPath))
+        return null;
+    const lines = readFileSync(manifestPath, 'utf-8').trim().split('\n');
+    for (let i = lines.length - 1; i >= 0; i--) {
+        if (lines[i].includes(`"${taskId}"`))
+            return lines[i];
+    }
+    return null;
+}
+/** Validate research protocol for a task. */
+export async function validateResearchTask(taskId, opts) {
+    const manifestPath = getManifestPath();
+    const entry = findManifestEntry(taskId, manifestPath);
+    if (!entry) {
+        throw new CleoError(ExitCode.NOT_FOUND, `No manifest entry found for task ${taskId}`);
+    }
+    const manifest = JSON.parse(entry);
+    const violations = [];
+    // RSCH-001: agent_type check
+    if (manifest.agent_type !== 'research') {
+        violations.push({
+            code: 'RSCH-001',
+            severity: 'high',
+            message: `Expected agent_type "research", got "${manifest.agent_type}"`,
+        });
+    }
+    // RSCH-002: key_findings must be present and non-empty
+    if (!manifest.key_findings ||
+        !Array.isArray(manifest.key_findings) ||
+        manifest.key_findings.length === 0) {
+        violations.push({
+            code: 'RSCH-002',
+            severity: 'high',
+            message: 'Research output must include non-empty key_findings array',
+        });
+    }
+    // RSCH-003: output file must exist
+    if (manifest.file && !existsSync(manifest.file)) {
+        violations.push({
+            code: 'RSCH-003',
+            severity: 'medium',
+            message: `Output file "${manifest.file}" not found on disk`,
+        });
+    }
+    const score = violations.length === 0 ? 100 : Math.max(0, 100 - violations.length * 25);
+    const result = {
+        valid: violations.length === 0,
+        violations,
+        score,
+        protocol: 'research',
+        taskId,
+    };
+    if (opts.strict && violations.length > 0) {
+        throw new CleoError(60, `Research protocol violations for ${taskId}`);
+    }
+    return result;
+}
+/** Validate research protocol from manifest file. */
+export async function checkResearchManifest(manifestFile, opts) {
+    if (!existsSync(manifestFile)) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Manifest file not found: ${manifestFile}`);
+    }
+    const manifest = JSON.parse(readFileSync(manifestFile, 'utf-8'));
+    const taskId = manifest.linked_tasks?.[0] ?? 'UNKNOWN';
+    return validateResearchTask(taskId, opts);
+}
+//# sourceMappingURL=research.js.map

package/dist/validation/protocols/research.js.map

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

package/dist/validation/protocols/specification.js

@@ -0,0 +1,84 @@
+/**
+ * Specification protocol validation.
+ * @task T4537
+ * @epic T4454
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { ExitCode } from '@cleocode/contracts';
+import { CleoError } from '../../errors.js';
+import { getManifestPath } from '../../paths.js';
+function findManifestEntry(taskId, manifestPath) {
+    if (!existsSync(manifestPath))
+        return null;
+    const lines = readFileSync(manifestPath, 'utf-8').trim().split('\n');
+    for (let i = lines.length - 1; i >= 0; i--) {
+        if (lines[i].includes(`"${taskId}"`))
+            return lines[i];
+    }
+    return null;
+}
+/** Validate specification protocol for a task. */
+export async function validateSpecificationTask(taskId, opts) {
+    const manifestPath = getManifestPath();
+    const entry = findManifestEntry(taskId, manifestPath);
+    if (!entry) {
+        throw new CleoError(ExitCode.NOT_FOUND, `No manifest entry found for task ${taskId}`);
+    }
+    const manifest = JSON.parse(entry);
+    const violations = [];
+    // SPEC-007: agent_type check
+    if (manifest.agent_type !== 'specification') {
+        violations.push({
+            code: 'SPEC-007',
+            severity: 'high',
+            message: `Expected agent_type "specification", got "${manifest.agent_type}"`,
+        });
+    }
+    // SPEC-001: RFC 2119 keywords check
+    if (opts.specFile && existsSync(opts.specFile)) {
+        const specContent = readFileSync(opts.specFile, 'utf-8');
+        const rfc2119Keywords = ['MUST', 'SHOULD', 'MAY', 'MUST NOT', 'SHOULD NOT'];
+        const hasKeywords = rfc2119Keywords.some((kw) => specContent.includes(kw));
+        if (!hasKeywords) {
+            violations.push({
+                code: 'SPEC-001',
+                severity: 'medium',
+                message: 'Specification should contain RFC 2119 keywords (MUST/SHOULD/MAY)',
+            });
+        }
+    }
+    // SPEC-002: version check
+    if (!manifest.version && opts.specFile) {
+        const specContent = existsSync(opts.specFile) ? readFileSync(opts.specFile, 'utf-8') : '';
+        const hasVersion = /version[:\s]+\d/i.test(specContent) || /^#+.*v\d/im.test(specContent);
+        if (!hasVersion) {
+            violations.push({
+                code: 'SPEC-002',
+                severity: 'medium',
+                message: 'Specification should include version information',
+            });
+        }
+    }
+    const score = violations.length === 0 ? 100 : Math.max(0, 100 - violations.length * 20);
+    const result = {
+        valid: violations.length === 0,
+        violations,
+        score,
+        protocol: 'specification',
+        taskId,
+    };
+    if (opts.strict && violations.length > 0) {
+        throw new CleoError(62, `Specification protocol violations for ${taskId}`);
+    }
+    return result;
+}
+/** Validate specification protocol from manifest file. */
+export async function checkSpecificationManifest(manifestFile, opts) {
+    if (!existsSync(manifestFile)) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Manifest file not found: ${manifestFile}`);
+    }
+    const manifest = JSON.parse(readFileSync(manifestFile, 'utf-8'));
+    const taskId = manifest.linked_tasks?.[0] ?? 'UNKNOWN';
+    return validateSpecificationTask(taskId, opts);
+}
+//# sourceMappingURL=specification.js.map

package/dist/validation/protocols/specification.js.map

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

package/dist/validation/protocols/testing-protocol.js

@@ -0,0 +1,70 @@
+/**
+ * Testing protocol validation.
+ * IVTR Stage: T (Testing)
+ * @task T4804
+ * @epic T4798
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { ExitCode } from '@cleocode/contracts';
+import { CleoError } from '../../errors.js';
+import { getManifestPath } from '../../paths.js';
+function findManifestEntry(taskId, manifestPath) {
+    if (!existsSync(manifestPath))
+        return null;
+    const lines = readFileSync(manifestPath, 'utf-8').trim().split('\n');
+    for (let i = lines.length - 1; i >= 0; i--) {
+        if (lines[i].includes(`"${taskId}"`))
+            return lines[i];
+    }
+    return null;
+}
+/** Validate testing protocol for a task. */
+export async function validateTestingTask(taskId, opts) {
+    const manifestPath = getManifestPath();
+    const entry = findManifestEntry(taskId, manifestPath);
+    if (!entry) {
+        throw new CleoError(ExitCode.NOT_FOUND, `No manifest entry found for task ${taskId}`);
+    }
+    const manifest = JSON.parse(entry);
+    const violations = [];
+    // TEST-007: agent_type check
+    if (manifest.agent_type !== 'testing') {
+        violations.push({
+            code: 'TEST-007',
+            severity: 'high',
+            message: `Expected agent_type "testing", got "${manifest.agent_type}"`,
+        });
+    }
+    // TEST-006: test summary must be present
+    if (!manifest.key_findings ||
+        !Array.isArray(manifest.key_findings) ||
+        manifest.key_findings.length === 0) {
+        violations.push({
+            code: 'TEST-006',
+            severity: 'high',
+            message: 'Testing output must include non-empty key_findings array with test results',
+        });
+    }
+    const score = violations.length === 0 ? 100 : Math.max(0, 100 - violations.length * 25);
+    const result = {
+        valid: violations.length === 0,
+        violations,
+        score,
+        protocol: 'testing',
+        taskId,
+    };
+    if (opts.strict && violations.length > 0) {
+        throw new CleoError(67, `Testing protocol violations for ${taskId}`);
+    }
+    return result;
+}
+/** Validate testing protocol from manifest file. */
+export async function checkTestingManifest(manifestFile, opts) {
+    if (!existsSync(manifestFile)) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Manifest file not found: ${manifestFile}`);
+    }
+    const manifest = JSON.parse(readFileSync(manifestFile, 'utf-8'));
+    const taskId = manifest.linked_tasks?.[0] ?? 'UNKNOWN';
+    return validateTestingTask(taskId, opts);
+}
+//# sourceMappingURL=testing-protocol.js.map

package/dist/validation/protocols/testing-protocol.js.map

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

package/dist/validation/protocols/validation-protocol.js

@@ -0,0 +1,70 @@
+/**
+ * Validation (verify) protocol validation.
+ * IVTR Stage: V (Validation/Verify)
+ * @task T4804
+ * @epic T4798
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { ExitCode } from '@cleocode/contracts';
+import { CleoError } from '../../errors.js';
+import { getManifestPath } from '../../paths.js';
+function findManifestEntry(taskId, manifestPath) {
+    if (!existsSync(manifestPath))
+        return null;
+    const lines = readFileSync(manifestPath, 'utf-8').trim().split('\n');
+    for (let i = lines.length - 1; i >= 0; i--) {
+        if (lines[i].includes(`"${taskId}"`))
+            return lines[i];
+    }
+    return null;
+}
+/** Validate verification/validation protocol for a task. */
+export async function validateValidationTask(taskId, opts) {
+    const manifestPath = getManifestPath();
+    const entry = findManifestEntry(taskId, manifestPath);
+    if (!entry) {
+        throw new CleoError(ExitCode.NOT_FOUND, `No manifest entry found for task ${taskId}`);
+    }
+    const manifest = JSON.parse(entry);
+    const violations = [];
+    // VALID-006: agent_type check
+    if (manifest.agent_type !== 'validation') {
+        violations.push({
+            code: 'VALID-006',
+            severity: 'high',
+            message: `Expected agent_type "validation", got "${manifest.agent_type}"`,
+        });
+    }
+    // VALID-005: validation summary must be present
+    if (!manifest.key_findings ||
+        !Array.isArray(manifest.key_findings) ||
+        manifest.key_findings.length === 0) {
+        violations.push({
+            code: 'VALID-005',
+            severity: 'high',
+            message: 'Validation output must include non-empty key_findings array with check results',
+        });
+    }
+    const score = violations.length === 0 ? 100 : Math.max(0, 100 - violations.length * 25);
+    const result = {
+        valid: violations.length === 0,
+        violations,
+        score,
+        protocol: 'validation',
+        taskId,
+    };
+    if (opts.strict && violations.length > 0) {
+        throw new CleoError(67, `Validation protocol violations for ${taskId}`);
+    }
+    return result;
+}
+/** Validate validation protocol from manifest file. */
+export async function checkValidationManifest(manifestFile, opts) {
+    if (!existsSync(manifestFile)) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Manifest file not found: ${manifestFile}`);
+    }
+    const manifest = JSON.parse(readFileSync(manifestFile, 'utf-8'));
+    const taskId = manifest.linked_tasks?.[0] ?? 'UNKNOWN';
+    return validateValidationTask(taskId, opts);
+}
+//# sourceMappingURL=validation-protocol.js.map

package/dist/validation/protocols/validation-protocol.js.map

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

package/dist/validation/schema-integrity.js

@@ -0,0 +1,170 @@
+/**
+ * Canonical JSON file integrity checker for the SQLite era.
+ *
+ * Validates the JSON files that remain active per ADR-006:
+ * config.json, project-info.json, project-context.json, .context-state.json
+ *
+ * Table-driven design — add a new file by adding one entry to INTEGRITY_TARGETS.
+ * Uses AJV (via src/core/schema.ts) and reads schema versions from schema files
+ * at runtime; no hardcoded version strings.
+ *
+ * @task T4862
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { checkSchema } from '../json-schema-validator.js';
+import { getCleoDirAbsolute } from '../paths.js';
+import { getSchemaVersion, resolveSchemaPath } from '../schema-management.js';
+// ============================================================================
+// Table of files to check
+// ============================================================================
+const INTEGRITY_TARGETS = [
+    {
+        label: 'config.json',
+        filePath: (d) => join(d, 'config.json'),
+        schemaName: 'config.schema.json',
+        required: true,
+        versionKey: 'schemaVersion',
+    },
+    {
+        label: 'project-info.json',
+        filePath: (d) => join(d, 'project-info.json'),
+        schemaName: 'project-info.schema.json',
+        required: false,
+        versionKey: 'schemaVersion',
+    },
+    {
+        label: 'project-context.json',
+        filePath: (d) => join(d, 'project-context.json'),
+        schemaName: 'project-context.schema.json',
+        required: false,
+        versionKey: 'schemaVersion',
+    },
+    {
+        label: '.context-state.json',
+        filePath: (d) => join(d, '.context-state.json'),
+        schemaName: 'context-state.schema.json',
+        required: false,
+        versionKey: 'version',
+    },
+];
+// ============================================================================
+// Schema path resolution
+// ============================================================================
+/**
+ * Read the top-level `schemaVersion` field from a schema file.
+ * Delegates to the centralized schema-management module.
+ * Returns null if the file cannot be read or has no such field.
+ */
+export function readSchemaVersionFromFile(schemaName) {
+    return getSchemaVersion(schemaName);
+}
+// ============================================================================
+// Single file checker
+// ============================================================================
+function checkFile(target, cleoDir) {
+    const filePath = target.filePath(cleoDir);
+    // File missing
+    if (!existsSync(filePath)) {
+        if (target.required) {
+            return {
+                label: target.label,
+                status: 'missing',
+                errors: [`Required file not found: ${filePath}`],
+            };
+        }
+        // Optional files that don't exist are fine
+        return { label: target.label, status: 'ok', errors: [] };
+    }
+    // Parse file
+    let data;
+    try {
+        data = JSON.parse(readFileSync(filePath, 'utf-8'));
+    }
+    catch (err) {
+        return {
+            label: target.label,
+            status: 'invalid',
+            errors: [`JSON parse error: ${err instanceof Error ? err.message : String(err)}`],
+        };
+    }
+    // Load schema
+    const schemaPath = resolveSchemaPath(target.schemaName);
+    if (!schemaPath) {
+        return {
+            label: target.label,
+            status: 'schema_not_found',
+            errors: [`Schema file not found: ${target.schemaName}`],
+        };
+    }
+    let schema;
+    try {
+        schema = JSON.parse(readFileSync(schemaPath, 'utf-8'));
+    }
+    catch (err) {
+        return {
+            label: target.label,
+            status: 'schema_not_found',
+            errors: [`Schema file unreadable: ${err instanceof Error ? err.message : String(err)}`],
+        };
+    }
+    // AJV validation
+    const ajvErrors = checkSchema(data, schema);
+    if (ajvErrors.length > 0) {
+        return {
+            label: target.label,
+            status: 'invalid',
+            errors: ajvErrors,
+        };
+    }
+    // Version comparison
+    const dataVersion = data[target.versionKey];
+    const expectedVersion = getSchemaVersion(target.schemaName);
+    const dataVersionStr = typeof dataVersion === 'string' ? dataVersion : undefined;
+    const result = {
+        label: target.label,
+        status: 'ok',
+        errors: [],
+        dataVersion: dataVersionStr,
+        expectedVersion: expectedVersion ?? undefined,
+    };
+    if (dataVersionStr && expectedVersion && dataVersionStr !== expectedVersion) {
+        result.status = 'version_mismatch';
+        result.errors = [
+            `Version mismatch: file has ${dataVersionStr}, schema expects ${expectedVersion}. Run: cleo upgrade`,
+        ];
+    }
+    return result;
+}
+// ============================================================================
+// SQLite version reader
+// ============================================================================
+async function readSqliteVersion(cwd) {
+    try {
+        const { getDb } = await import('../store/sqlite.js');
+        const schemaTable = await import('../store/tasks-schema.js');
+        const db = await getDb(cwd);
+        const rows = await db.select().from(schemaTable.schemaMeta).limit(10);
+        const row = rows.find((r) => r.key === 'schemaVersion');
+        return row?.value ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * Check integrity of all active JSON files in a CLEO project.
+ *
+ * @param cwd - Project root (defaults to process.cwd())
+ */
+export async function checkSchemaIntegrity(cwd) {
+    const cleoDir = getCleoDirAbsolute(cwd);
+    const files = INTEGRITY_TARGETS.map((t) => checkFile(t, cleoDir));
+    const sqliteVersion = await readSqliteVersion(cwd);
+    const allOk = files.every((f) => f.status === 'ok' || f.status === 'schema_not_found');
+    return { files, sqliteVersion, allOk };
+}
+//# sourceMappingURL=schema-integrity.js.map

package/dist/validation/schema-integrity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-integrity.js","sourceRoot":"","sources":["../../src/validation/schema-integrity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAsC9E,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E,MAAM,iBAAiB,GAAsB;IAC3C;QACE,KAAK,EAAE,aAAa;QACpB,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,aAAa,CAAC;QACvC,UAAU,EAAE,oBAAoB;QAChC,QAAQ,EAAE,IAAI;QACd,UAAU,EAAE,eAAe;KAC5B;IACD;QACE,KAAK,EAAE,mBAAmB;QAC1B,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,mBAAmB,CAAC;QAC7C,UAAU,EAAE,0BAA0B;QACtC,QAAQ,EAAE,KAAK;QACf,UAAU,EAAE,eAAe;KAC5B;IACD;QACE,KAAK,EAAE,sBAAsB;QAC7B,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,sBAAsB,CAAC;QAChD,UAAU,EAAE,6BAA6B;QACzC,QAAQ,EAAE,KAAK;QACf,UAAU,EAAE,eAAe;KAC5B;IACD;QACE,KAAK,EAAE,qBAAqB;QAC5B,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,qBAAqB,CAAC;QAC/C,UAAU,EAAE,2BAA2B;QACvC,QAAQ,EAAE,KAAK;QACf,UAAU,EAAE,SAAS;KACtB;CACF,CAAC;AAEF,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,UAAkB;IAC1D,OAAO,gBAAgB,CAAC,UAAU,CAAC,CAAC;AACtC,CAAC;AAED,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E,SAAS,SAAS,CAAC,MAAuB,EAAE,OAAe;IACzD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAE1C,eAAe;IACf,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,OAAO;gBACL,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,CAAC,4BAA4B,QAAQ,EAAE,CAAC;aACjD,CAAC;QACJ,CAAC;QACD,2CAA2C;QAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC3D,CAAC;IAED,aAAa;IACb,IAAI,IAA6B,CAAC;IAClC,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAA4B,CAAC;IAChF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,CAAC,qBAAqB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;SAClF,CAAC;IACJ,CAAC;IAED,cAAc;IACd,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACxD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,kBAAkB;YAC1B,MAAM,EAAE,CAAC,0BAA0B,MAAM,CAAC,UAAU,EAAE,CAAC;SACxD,CAAC;IACJ,CAAC;IAED,IAAI,MAA+B,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAA4B,CAAC;IACpF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,kBAAkB;YAC1B,MAAM,EAAE,CAAC,2BAA2B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;SACxF,CAAC;IACJ,CAAC;IAED,iBAAiB;IACjB,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5C,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,SAAS;SAClB,CAAC;IACJ,CAAC;IAED,qBAAqB;IACrB,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,eAAe,GAAG,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAE5D,MAAM,cAAc,GAAG,OAAO,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;IACjF,MAAM,MAAM,GAA4B;QACtC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,EAAE;QACV,WAAW,EAAE,cAAc;QAC3B,eAAe,EAAE,eAAe,IAAI,SAAS;KAC9C,CAAC;IAEF,IAAI,cAAc,IAAI,eAAe,IAAI,cAAc,KAAK,eAAe,EAAE,CAAC;QAC5E,MAAM,CAAC,MAAM,GAAG,kBAAkB,CAAC;QACnC,MAAM,CAAC,MAAM,GAAG;YACd,8BAA8B,cAAc,oBAAoB,eAAe,qBAAqB;SACrG,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E,KAAK,UAAU,iBAAiB,CAAC,GAAY;IAC3C,IAAI,CAAC;QACH,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACrD,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;QAC7D,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACtE,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,eAAe,CAAC,CAAC;QACxD,OAAO,GAAG,EAAE,KAAK,IAAI,IAAI,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,GAAY;IACrD,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAClE,MAAM,aAAa,GAAG,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAEnD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,IAAI,CAAC,CAAC,MAAM,KAAK,kBAAkB,CAAC,CAAC;IAEvF,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AACzC,CAAC"}