@cleocode/core 2026.4.9 → 2026.4.12

package/dist/compliance/index.js

@@ -0,0 +1,288 @@
+/**
+ * Compliance metrics core module.
+ * @task T4535
+ * @epic T4454
+ */
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { getManifestPath as getManifestPathFromPaths } from '../paths.js';
+import { atomicWriteJson } from '../store/atomic.js';
+import { getComplianceJsonlPath, readComplianceJsonl } from './store.js';
+// CleoError and ExitCode available if needed for future error cases
+/** Get compliance summary. */
+export async function getComplianceSummary(opts) {
+    let entries = readComplianceJsonl(opts.cwd ?? process.cwd());
+    if (opts.since) {
+        entries = entries.filter((e) => e.timestamp >= opts.since);
+    }
+    if (opts.agent) {
+        entries = entries.filter((e) => e.source_id === opts.agent);
+    }
+    const totalEntries = entries.length;
+    const compliance = entries.map((e) => (e.compliance ?? {}));
+    const avgPassRate = totalEntries > 0
+        ? compliance.reduce((sum, c) => sum + (c.compliance_pass_rate ?? 0), 0) /
+            totalEntries
+        : 0;
+    const avgAdherence = totalEntries > 0
+        ? compliance.reduce((sum, c) => sum + (c.rule_adherence_score ?? 0), 0) /
+            totalEntries
+        : 0;
+    const totalViolations = compliance.reduce((sum, c) => sum + (c.violation_count ?? 0), 0);
+    return {
+        totalEntries,
+        averagePassRate: Math.round(avgPassRate * 1000) / 1000,
+        averageAdherence: Math.round(avgAdherence * 1000) / 1000,
+        totalViolations,
+    };
+}
+/** List compliance violations. */
+export async function listComplianceViolations(opts) {
+    let entries = readComplianceJsonl(opts.cwd ?? process.cwd());
+    entries = entries.filter((e) => {
+        const c = (e.compliance ?? {});
+        return (c.violation_count ?? 0) > 0;
+    });
+    if (opts.severity) {
+        entries = entries.filter((e) => {
+            const c = (e.compliance ?? {});
+            return c.violation_severity === opts.severity;
+        });
+    }
+    if (opts.since) {
+        entries = entries.filter((e) => e.timestamp >= opts.since);
+    }
+    if (opts.agent) {
+        entries = entries.filter((e) => e.source_id === opts.agent);
+    }
+    const violations = entries.map((e) => {
+        const c = (e.compliance ?? {});
+        const ctx = (e._context ?? {});
+        return {
+            timestamp: e.timestamp,
+            agentId: e.source_id,
+            taskId: ctx.task_id,
+            violationCount: c.violation_count,
+            severity: c.violation_severity,
+            passRate: c.compliance_pass_rate,
+        };
+    });
+    return { violations, totalCount: violations.length };
+}
+/** Get compliance trend. */
+export async function getComplianceTrend(days = 7, cwd) {
+    const entries = readComplianceJsonl(cwd ?? process.cwd());
+    const cutoff = new Date(Date.now() - days * 86400000).toISOString();
+    const filtered = entries.filter((e) => e.timestamp >= cutoff);
+    // Group by date
+    const byDate = {};
+    for (const e of filtered) {
+        const date = e.timestamp.split('T')[0];
+        if (!byDate[date])
+            byDate[date] = [];
+        byDate[date].push(e);
+    }
+    const dataPoints = Object.entries(byDate)
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([date, dayEntries]) => {
+        const compliance = dayEntries.map((e) => (e.compliance ?? {}));
+        return {
+            date,
+            entries: dayEntries.length,
+            avgPassRate: compliance.reduce((s, c) => s + (c.compliance_pass_rate ?? 0), 0) /
+                dayEntries.length,
+            avgAdherence: compliance.reduce((s, c) => s + (c.rule_adherence_score ?? 0), 0) /
+                dayEntries.length,
+            violations: compliance.reduce((s, c) => s + (c.violation_count ?? 0), 0),
+        };
+    });
+    let trend = 'no_data';
+    if (dataPoints.length >= 2) {
+        const first = dataPoints[0].avgPassRate;
+        const last = dataPoints[dataPoints.length - 1].avgPassRate;
+        trend = last > first ? 'improving' : last < first ? 'declining' : 'stable';
+    }
+    return { days, trend, dataPoints };
+}
+/** Audit epic compliance. */
+export async function auditEpicCompliance(epicId, opts) {
+    const entries = readComplianceJsonl(opts.cwd ?? process.cwd());
+    const epicEntries = entries.filter((e) => {
+        const ctx = (e._context ?? {});
+        return ctx.epic_id === epicId || ctx.task_id === epicId;
+    });
+    const taskIds = [
+        ...new Set(epicEntries.map((e) => {
+            const ctx = (e._context ?? {});
+            return ctx.task_id;
+        })),
+    ];
+    const compliance = epicEntries.map((e) => (e.compliance ?? {}));
+    const avgPassRate = epicEntries.length > 0
+        ? compliance.reduce((s, c) => s + (c.compliance_pass_rate ?? 0), 0) /
+            epicEntries.length
+        : 0;
+    const totalViolations = compliance.reduce((s, c) => s + (c.violation_count ?? 0), 0);
+    return {
+        epicId,
+        taskCount: taskIds.length,
+        entriesAnalyzed: epicEntries.length,
+        summary: { averagePassRate: avgPassRate, totalViolations },
+    };
+}
+/** Sync compliance metrics to a summary file. */
+export async function syncComplianceMetrics(opts) {
+    const cwd = opts.cwd ?? process.cwd();
+    const force = opts.force ?? false;
+    const jsonlPath = getComplianceJsonlPath(cwd);
+    const summaryPath = join(cwd, '.cleo', 'metrics', 'compliance-summary.json');
+    // If JSONL doesn't exist, nothing to sync
+    if (!existsSync(jsonlPath)) {
+        return {
+            synced: 0,
+            skipped: 0,
+            message: 'No compliance data found',
+            timestamp: new Date().toISOString(),
+        };
+    }
+    // Skip re-syncing if summary is newer than JSONL (unless forced)
+    if (!force && existsSync(summaryPath)) {
+        const jsonlMtime = statSync(jsonlPath).mtimeMs;
+        const summaryMtime = statSync(summaryPath).mtimeMs;
+        if (summaryMtime > jsonlMtime) {
+            const existing = JSON.parse(readFileSync(summaryPath, 'utf-8'));
+            const totalEntries = existing.totalEntries ?? 0;
+            return {
+                synced: 0,
+                skipped: totalEntries,
+                message: `Summary up-to-date (${totalEntries} entries)`,
+                timestamp: new Date().toISOString(),
+            };
+        }
+    }
+    const entries = readComplianceJsonl(cwd);
+    const totalEntries = entries.length;
+    if (totalEntries === 0) {
+        const summary = {
+            totalEntries: 0,
+            averagePassRate: 0,
+            averageAdherence: 0,
+            totalViolations: 0,
+            entriesByType: {},
+            generatedAt: new Date().toISOString(),
+        };
+        await atomicWriteJson(summaryPath, summary);
+        return { synced: 0, skipped: 0, message: 'No entries to sync', timestamp: summary.generatedAt };
+    }
+    // Compute aggregate statistics
+    const compliance = entries.map((e) => (e.compliance ?? {}));
+    const avgPassRate = compliance.reduce((sum, c) => sum + (c.compliance_pass_rate ?? 0), 0) /
+        totalEntries;
+    const avgAdherence = compliance.reduce((sum, c) => sum + (c.rule_adherence_score ?? 0), 0) /
+        totalEntries;
+    const totalViolations = compliance.reduce((sum, c) => sum + (c.violation_count ?? 0), 0);
+    // Group entries by source_type
+    const entriesByType = {};
+    for (const e of entries) {
+        const sourceType = e.source_type ?? 'unknown';
+        entriesByType[sourceType] = (entriesByType[sourceType] ?? 0) + 1;
+    }
+    const generatedAt = new Date().toISOString();
+    const globalStats = {
+        totalEntries,
+        averagePassRate: Math.round(avgPassRate * 1000) / 1000,
+        averageAdherence: Math.round(avgAdherence * 1000) / 1000,
+        totalViolations,
+        entriesByType,
+        generatedAt,
+    };
+    await atomicWriteJson(summaryPath, globalStats);
+    return {
+        synced: totalEntries,
+        skipped: 0,
+        message: `Synced ${totalEntries} compliance entries`,
+        timestamp: generatedAt,
+        globalStats,
+    };
+}
+/** Get skill reliability stats. */
+export async function getSkillReliability(opts) {
+    const entries = readComplianceJsonl(opts.cwd ?? process.cwd());
+    const byAgent = {};
+    for (const e of entries) {
+        const agentId = e.source_id ?? 'unknown';
+        if (!byAgent[agentId])
+            byAgent[agentId] = { count: 0, passRateSum: 0, violations: 0 };
+        const stats = byAgent[agentId];
+        const c = (e.compliance ?? {});
+        stats.count++;
+        stats.passRateSum += c.compliance_pass_rate ?? 0;
+        stats.violations += c.violation_count ?? 0;
+    }
+    const skills = Object.entries(byAgent).map(([id, stats]) => ({
+        agentId: id,
+        totalChecks: stats.count,
+        avgPassRate: stats.count > 0 ? Math.round((stats.passRateSum / stats.count) * 1000) / 1000 : 0,
+        totalViolations: stats.violations,
+    }));
+    return { skills, total: skills.length };
+}
+/** Get value metrics (T2833). */
+export async function getValueMetrics(days = 7, cwd) {
+    const manifestPath = getManifestPathFromPaths(cwd);
+    let manifestEntries = 0;
+    if (existsSync(manifestPath)) {
+        const content = readFileSync(manifestPath, 'utf-8').trim();
+        manifestEntries = content ? content.split('\n').length : 0;
+    }
+    const manifestTokens = manifestEntries * 200;
+    const fullFileTokens = manifestEntries * 2000;
+    const tokenSavings = fullFileTokens - manifestTokens;
+    const savingsPercent = fullFileTokens > 0 ? Math.round((tokenSavings / fullFileTokens) * 100) : 0;
+    let totalValidations = 0;
+    let violationsCaught = 0;
+    let realValidations = 0;
+    const entries = readComplianceJsonl(cwd ?? process.cwd());
+    totalValidations = entries.length;
+    violationsCaught = entries.filter((e) => {
+        const c = (e.compliance ?? {});
+        return (c.violation_count ?? 0) > 0;
+    }).length;
+    realValidations = entries.filter((e) => {
+        const ctx = (e._context ?? {});
+        return ctx.validation_score !== undefined;
+    }).length;
+    const violationRate = totalValidations > 0 ? Math.round((violationsCaught / totalValidations) * 100) : 0;
+    const otelEnabled = process.env.CLAUDE_CODE_ENABLE_TELEMETRY === '1';
+    return {
+        periodDays: days,
+        tokenEfficiency: {
+            manifestEntries,
+            manifestTokens,
+            fullFileEquivalent: fullFileTokens,
+            tokensSaved: tokenSavings,
+            savingsPercent,
+            verdict: savingsPercent >= 80
+                ? 'Excellent'
+                : savingsPercent >= 50
+                    ? 'Good'
+                    : savingsPercent >= 20
+                        ? 'Moderate'
+                        : 'Low',
+        },
+        validationImpact: {
+            totalValidations,
+            violationsCaught,
+            violationRatePercent: violationRate,
+            realValidations,
+            status: realValidations > 0 ? 'Active' : 'Legacy (upgrade to real validation)',
+        },
+        telemetry: {
+            otelEnabled,
+            recommendation: otelEnabled
+                ? 'Token tracking active'
+                : 'Enable CLAUDE_CODE_ENABLE_TELEMETRY=1 for real token data',
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/compliance/index.js.map

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

package/dist/compliance/protocol-enforcement.js

@@ -0,0 +1,332 @@
+/**
+ * Protocol Enforcement for CLEO
+ *
+ * Validates RCASD-IVTR+C lifecycle compliance with exit codes 60-70.
+ * Intercepts domain operations to enforce protocol requirements before execution.
+ *
+ * Moved to core for proper layering (formerly in dispatch).
+ *
+ * @task T2918
+ * @task T5707
+ * @epic T2908
+ */
+import { PROTOCOL_RULES, } from './protocol-rules.js';
+import { ProtocolExitCode } from './protocol-types.js';
+/**
+ * Protocol types aligned with RCASD-IVTR+C lifecycle
+ */
+export var ProtocolType;
+(function (ProtocolType) {
+    ProtocolType["RESEARCH"] = "research";
+    ProtocolType["CONSENSUS"] = "consensus";
+    ProtocolType["SPECIFICATION"] = "specification";
+    ProtocolType["DECOMPOSITION"] = "decomposition";
+    ProtocolType["IMPLEMENTATION"] = "implementation";
+    ProtocolType["CONTRIBUTION"] = "contribution";
+    ProtocolType["RELEASE"] = "release";
+    ProtocolType["VALIDATION"] = "validation";
+    ProtocolType["TESTING"] = "testing";
+})(ProtocolType || (ProtocolType = {}));
+/**
+ * Exit code mapping for protocol violations
+ */
+const PROTOCOL_EXIT_CODES = {
+    [ProtocolType.RESEARCH]: ProtocolExitCode.E_PROTOCOL_RESEARCH,
+    [ProtocolType.CONSENSUS]: ProtocolExitCode.E_PROTOCOL_CONSENSUS,
+    [ProtocolType.SPECIFICATION]: ProtocolExitCode.E_PROTOCOL_SPECIFICATION,
+    [ProtocolType.DECOMPOSITION]: ProtocolExitCode.E_PROTOCOL_DECOMPOSITION,
+    [ProtocolType.IMPLEMENTATION]: ProtocolExitCode.E_PROTOCOL_IMPLEMENTATION,
+    [ProtocolType.CONTRIBUTION]: ProtocolExitCode.E_PROTOCOL_CONTRIBUTION,
+    [ProtocolType.RELEASE]: ProtocolExitCode.E_PROTOCOL_RELEASE,
+    [ProtocolType.VALIDATION]: ProtocolExitCode.E_PROTOCOL_VALIDATION,
+    [ProtocolType.TESTING]: ProtocolExitCode.E_TESTS_SKIPPED,
+};
+/**
+ * Lifecycle stage dependencies
+ */
+const LIFECYCLE_GATES = {
+    research: [],
+    consensus: ['research'],
+    architecture_decision: ['research', 'consensus'],
+    specification: ['research', 'consensus', 'architecture_decision'],
+    decomposition: ['research', 'specification', 'architecture_decision'],
+    implementation: ['research', 'specification', 'decomposition', 'architecture_decision'],
+    contribution: [], // Cross-cutting: no strict prerequisites
+    validation: ['implementation'],
+    testing: ['implementation', 'validation'],
+    release: ['implementation', 'validation', 'testing'],
+};
+/**
+ * Main protocol enforcement class
+ */
+export class ProtocolEnforcer {
+    violations = [];
+    strictMode;
+    constructor(strictMode = true) {
+        this.strictMode = strictMode;
+    }
+    /**
+     * Validate protocol compliance for a manifest entry
+     */
+    async validateProtocol(protocol, manifestEntry, additionalData) {
+        const rules = PROTOCOL_RULES[protocol];
+        if (!rules) {
+            return {
+                valid: false,
+                violations: [
+                    {
+                        requirement: 'UNKNOWN',
+                        severity: 'error',
+                        message: `Unknown protocol type: ${protocol}`,
+                        fix: 'Use valid protocol type',
+                    },
+                ],
+                score: 0,
+            };
+        }
+        const violations = [];
+        let score = 100;
+        // Validate each rule
+        for (const rule of rules) {
+            const violation = await this.validateRule(rule, manifestEntry, additionalData);
+            if (violation) {
+                violations.push(violation);
+                score -= this.calculatePenalty(violation.severity);
+            }
+        }
+        return {
+            valid: violations.filter((v) => v.severity === 'error').length === 0,
+            violations,
+            score,
+        };
+    }
+    /**
+     * Validate a single rule
+     */
+    async validateRule(rule, manifestEntry, additionalData) {
+        try {
+            const isValid = await rule.validate(manifestEntry, additionalData);
+            if (!isValid) {
+                return {
+                    requirement: rule.id,
+                    severity: rule.level === 'MUST' ? 'error' : 'warning',
+                    message: rule.message,
+                    fix: rule.fix,
+                };
+            }
+            return null;
+        }
+        catch (error) {
+            return {
+                requirement: rule.id,
+                severity: 'error',
+                message: `Validation error: ${error instanceof Error ? error.message : String(error)}`,
+                fix: rule.fix,
+            };
+        }
+    }
+    /**
+     * Check lifecycle gate prerequisites
+     */
+    async checkLifecycleGate(_taskId, targetStage, lifecycleManifest) {
+        const prerequisites = LIFECYCLE_GATES[targetStage] || [];
+        if (!lifecycleManifest) {
+            // No manifest available - warn but allow
+            return {
+                passed: true,
+                missingPrerequisites: [],
+                message: 'No RCASD manifest found - gate check skipped',
+            };
+        }
+        const missingPrerequisites = [];
+        for (const prereq of prerequisites) {
+            const stageStatus = lifecycleManifest[prereq];
+            if (stageStatus !== 'completed' && stageStatus !== 'skipped') {
+                missingPrerequisites.push(prereq);
+            }
+        }
+        if (missingPrerequisites.length > 0) {
+            return {
+                passed: false,
+                missingPrerequisites,
+                message: `Lifecycle gate failed: missing prerequisites [${missingPrerequisites.join(', ')}]`,
+            };
+        }
+        return {
+            passed: true,
+            missingPrerequisites: [],
+            message: 'All prerequisites met',
+        };
+    }
+    /**
+     * Record a protocol violation
+     */
+    recordViolation(protocol, violations, score, taskId) {
+        const entry = {
+            timestamp: new Date().toISOString(),
+            taskId,
+            protocol,
+            violations,
+            score,
+            blocked: this.strictMode && violations.some((v) => v.severity === 'error'),
+        };
+        this.violations.push(entry);
+        // Keep last 1000 violations
+        if (this.violations.length > 1000) {
+            this.violations.shift();
+        }
+    }
+    /**
+     * Get recent violations
+     */
+    getViolations(limit) {
+        return limit ? this.violations.slice(-limit) : this.violations;
+    }
+    /**
+     * Calculate penalty for violation severity
+     */
+    calculatePenalty(severity) {
+        return severity === 'error' ? 20 : 5;
+    }
+    /**
+     * Middleware function for domain router
+     *
+     * Intercepts operations and validates protocol compliance before execution.
+     */
+    async enforceProtocol(request, next) {
+        // Only enforce on mutate operations that may create outputs
+        if (request.gateway !== 'mutate') {
+            return next();
+        }
+        // Check if operation requires protocol validation
+        const requiresValidation = this.requiresProtocolValidation(request);
+        if (!requiresValidation) {
+            return next();
+        }
+        // Execute the operation
+        const response = await next();
+        // Skip validation if operation failed
+        if (!response.success) {
+            return response;
+        }
+        // Extract protocol type from request/response
+        const protocol = this.detectProtocol(request, response);
+        if (!protocol) {
+            return response;
+        }
+        // Validate protocol compliance
+        const manifestEntry = this.extractManifestEntry(response);
+        if (!manifestEntry) {
+            return response; // No manifest to validate
+        }
+        const result = await this.validateProtocol(protocol, manifestEntry, request.params);
+        // Record violation
+        const taskId = request.params?.taskId;
+        this.recordViolation(protocol, result.violations, result.score, taskId);
+        // If strict mode and errors found, block the operation
+        if (this.strictMode && !result.valid) {
+            return {
+                _meta: response._meta,
+                success: false,
+                error: {
+                    code: `E_PROTOCOL_${protocol.toUpperCase()}`,
+                    exitCode: PROTOCOL_EXIT_CODES[protocol],
+                    message: `Protocol violation: ${protocol}`,
+                    details: {
+                        violations: result.violations,
+                        score: result.score,
+                    },
+                    fix: result.violations[0]?.fix || 'Fix protocol violations',
+                    alternatives: result.violations.map((v) => ({
+                        action: v.requirement,
+                        command: v.fix,
+                    })),
+                },
+            };
+        }
+        return response;
+    }
+    /**
+     * Determine if operation requires protocol validation
+     */
+    requiresProtocolValidation(request) {
+        // Operations that create outputs requiring validation
+        const validatedOperations = [
+            'session.context.inject',
+            'pipeline.manifest.append',
+            'orchestrate.spawn',
+            'tasks.complete',
+            'release.ship',
+            'validate.compliance.record',
+        ];
+        const key = `${request.domain}.${request.operation}`;
+        return validatedOperations.includes(key);
+    }
+    /**
+     * Detect protocol type from request/response
+     */
+    detectProtocol(request, _response) {
+        // Check params for explicit protocol
+        if (request.params?.protocolType) {
+            return request.params.protocolType;
+        }
+        // Infer from domain
+        const domainProtocolMap = {
+            research: ProtocolType.RESEARCH,
+            orchestrate: ProtocolType.DECOMPOSITION,
+            release: ProtocolType.RELEASE,
+            validate: ProtocolType.VALIDATION,
+            testing: ProtocolType.TESTING,
+            contribution: ProtocolType.CONTRIBUTION,
+        };
+        // Infer from operation name
+        if (request.operation) {
+            const opProtocolMap = {
+                'consensus.record': ProtocolType.CONSENSUS,
+                'specification.validate': ProtocolType.SPECIFICATION,
+                'implementation.complete': ProtocolType.IMPLEMENTATION,
+                'contribution.merge': ProtocolType.CONTRIBUTION,
+            };
+            const opKey = `${request.domain}.${request.operation}`;
+            if (opProtocolMap[opKey]) {
+                return opProtocolMap[opKey];
+            }
+        }
+        return domainProtocolMap[request.domain] || null;
+    }
+    /**
+     * Extract manifest entry from response
+     */
+    extractManifestEntry(response) {
+        const data = response.data;
+        if (!data) {
+            return null;
+        }
+        // Check for manifest entry in response
+        if (data.manifestEntry) {
+            return data.manifestEntry;
+        }
+        // Check for entry field
+        if (data.entry) {
+            return data.entry;
+        }
+        return null;
+    }
+    /**
+     * Set strict mode
+     */
+    setStrictMode(strict) {
+        this.strictMode = strict;
+    }
+    /**
+     * Get strict mode status
+     */
+    isStrictMode() {
+        return this.strictMode;
+    }
+}
+/**
+ * Default protocol enforcer instance
+ */
+export const protocolEnforcer = new ProtocolEnforcer();
+//# sourceMappingURL=protocol-enforcement.js.map

package/dist/compliance/protocol-enforcement.js.map

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