@codeledger/engine 0.7.1 → 0.7.3

package/dist/trust/capsule.js

@@ -0,0 +1,206 @@
+/**
+ * Command Capsule — Execution Governance Engine
+ *
+ * First-class domain object for governed execution.
+ * Lifecycle: draft → pending_policy → pending_approval → approved → executing → completed/failed
+ *
+ * Integrates with:
+ * - IOLE (intent signatures)
+ * - Team Policy (policy evaluation)
+ * - ECL-Lite (outcome recording)
+ * - Provenance (causal traceability)
+ */
+import { randomUUID } from 'node:crypto';
+import { readFileSync, writeFileSync, existsSync, mkdirSync, appendFileSync, readdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+const CAPSULE_DIR = '.codeledger/capsules';
+const CAPSULE_LOG = '.codeledger/capsule-events.jsonl';
+// ─── Valid State Transitions ───────────────────────────────────────────────
+const VALID_TRANSITIONS = {
+    draft: ['pending_policy'],
+    pending_policy: ['pending_approval', 'approved', 'rejected'],
+    pending_approval: ['approved', 'rejected'],
+    approved: ['executing', 'revoked'],
+    rejected: ['draft'], // allow revision
+    executing: ['completed', 'failed'],
+    completed: [],
+    failed: ['draft'], // allow retry via revision
+    revoked: [],
+};
+// ─── Capsule Creation ──────────────────────────────────────────────────────
+/** Create a new Command Capsule in draft state */
+export function createCapsule(action, createdBy, intentSignature) {
+    const now = new Date().toISOString();
+    const id = `capsule-${randomUUID().slice(0, 12)}`;
+    return {
+        id,
+        state: 'draft',
+        action,
+        risk: { score: 0, level: 'low', factors: [], assessedAt: now },
+        policyIds: [],
+        approvalRequirements: [],
+        approvalDecisions: [],
+        preconditions: [],
+        postconditions: [],
+        transitions: [{ from: 'draft', to: 'draft', trigger: 'created', actor: createdBy, timestamp: now }],
+        intentSignature,
+        createdBy,
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+// ─── State Machine ─────────────────────────────────────────────────────────
+/** Transition a capsule to a new state (validates transition) */
+export function transitionCapsule(capsule, to, trigger, actor, metadata) {
+    const allowed = VALID_TRANSITIONS[capsule.state] ?? [];
+    if (!allowed.includes(to)) {
+        throw new Error(`Invalid transition: ${capsule.state} → ${to}. Allowed: [${allowed.join(', ')}]`);
+    }
+    const now = new Date().toISOString();
+    const transition = {
+        from: capsule.state,
+        to,
+        trigger,
+        actor,
+        timestamp: now,
+        metadata,
+    };
+    return {
+        ...capsule,
+        state: to,
+        transitions: [...capsule.transitions, transition],
+        updatedAt: now,
+    };
+}
+// ─── Policy Evaluation ─────────────────────────────────────────────────────
+/** Submit capsule for policy evaluation */
+export function submitForPolicy(capsule, policyIds, requirements, actor) {
+    let updated = { ...capsule, policyIds, approvalRequirements: requirements };
+    updated = transitionCapsule(updated, 'pending_policy', 'policy_submitted', actor);
+    // If no approval required, auto-advance to approved
+    if (requirements.length === 0) {
+        updated = transitionCapsule(updated, 'approved', 'no_approval_required', 'system');
+    }
+    else {
+        updated = transitionCapsule(updated, 'pending_approval', 'approval_required', 'system');
+    }
+    return updated;
+}
+// ─── Approval ──────────────────────────────────────────────────────────────
+/** Record an approval decision */
+export function recordApproval(capsule, decision) {
+    if (capsule.state !== 'pending_approval') {
+        throw new Error(`Cannot approve capsule in state: ${capsule.state}`);
+    }
+    const updated = {
+        ...capsule,
+        approvalDecisions: [...capsule.approvalDecisions, decision],
+        updatedAt: new Date().toISOString(),
+    };
+    // Check if all requirements are satisfied
+    const allSatisfied = updated.approvalRequirements.every((req) => updated.approvalDecisions.some((d) => d.policyId === req.policyId && d.decision === 'approved'));
+    const anyRejected = updated.approvalDecisions.some((d) => d.decision === 'rejected');
+    if (anyRejected) {
+        return transitionCapsule(updated, 'rejected', 'approval_rejected', decision.approver);
+    }
+    if (allSatisfied) {
+        return transitionCapsule(updated, 'approved', 'all_approvals_received', 'system');
+    }
+    return updated;
+}
+/** Revoke a previously approved capsule */
+export function revokeCapsule(capsule, actor, reason) {
+    if (capsule.state !== 'approved') {
+        throw new Error(`Cannot revoke capsule in state: ${capsule.state}`);
+    }
+    return transitionCapsule(capsule, 'revoked', `revoked: ${reason}`, actor);
+}
+// ─── Execution ─────────────────────────────────────────────────────────────
+/** Begin execution of an approved capsule */
+export function beginExecution(capsule, actor) {
+    return transitionCapsule(capsule, 'executing', 'execution_started', actor);
+}
+/** Record execution outcome */
+export function completeExecution(capsule, outcome, actor) {
+    const targetState = outcome.status === 'failure' ? 'failed' : 'completed';
+    let updated = { ...capsule, outcome, updatedAt: new Date().toISOString() };
+    updated = transitionCapsule(updated, targetState, `execution_${outcome.status}`, actor);
+    return updated;
+}
+// ─── Condition Evaluation ──────────────────────────────────────────────────
+/** Evaluate a precondition or postcondition */
+export function evaluateCondition(condition, passed, message) {
+    return {
+        ...condition,
+        result: {
+            passed,
+            message,
+            evaluatedAt: new Date().toISOString(),
+        },
+    };
+}
+/** Check if all required preconditions pass */
+export function checkPreconditions(capsule) {
+    const requiredPre = capsule.preconditions.filter((c) => c.required);
+    const failures = requiredPre.filter((c) => c.result && !c.result.passed);
+    return {
+        passed: failures.length === 0 && requiredPre.every((c) => c.result?.passed),
+        failures,
+    };
+}
+/** Check if all required postconditions pass */
+export function checkPostconditions(capsule) {
+    const requiredPost = capsule.postconditions.filter((c) => c.required);
+    const failures = requiredPost.filter((c) => c.result && !c.result.passed);
+    return {
+        passed: failures.length === 0 && requiredPost.every((c) => c.result?.passed),
+        failures,
+    };
+}
+// ─── Persistence ───────────────────────────────────────────────────────────
+/** Save a capsule to disk */
+export function saveCapsule(repoRoot, capsule) {
+    const dir = join(repoRoot, CAPSULE_DIR);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    const filePath = join(dir, `${capsule.id}.json`);
+    writeFileSync(filePath, JSON.stringify(capsule, null, 2) + '\n', 'utf-8');
+}
+/** Load a capsule from disk */
+export function loadCapsule(repoRoot, capsuleId) {
+    const filePath = join(repoRoot, CAPSULE_DIR, `${capsuleId}.json`);
+    if (!existsSync(filePath))
+        return null;
+    try {
+        return JSON.parse(readFileSync(filePath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/** List all capsule IDs */
+export function listCapsules(repoRoot) {
+    const dir = join(repoRoot, CAPSULE_DIR);
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir)
+        .filter((f) => f.endsWith('.json'))
+        .map((f) => f.replace('.json', ''));
+}
+// ─── Event Recording (append-only audit trail) ────────────────────────────
+/** Record a capsule event to the append-only log */
+export function recordCapsuleEvent(repoRoot, capsuleId, event, actor, metadata) {
+    const logPath = join(repoRoot, CAPSULE_LOG);
+    const dir = dirname(logPath);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    const entry = {
+        capsuleId,
+        event,
+        actor,
+        timestamp: new Date().toISOString(),
+        metadata: metadata ?? {},
+    };
+    appendFileSync(logPath, JSON.stringify(entry) + '\n', 'utf-8');
+}
+//# sourceMappingURL=capsule.js.map

package/dist/trust/capsule.js.map

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

package/dist/trust/index.d.ts

@@ -0,0 +1,6 @@
+export { createCapsule, transitionCapsule, submitForPolicy, recordApproval, revokeCapsule, beginExecution, completeExecution, evaluateCondition, checkPreconditions, checkPostconditions, saveCapsule, loadCapsule, listCapsules, recordCapsuleEvent, } from './capsule.js';
+export { DEFAULT_APPROVAL_POLICY, loadApprovalPolicy, findMatchingAuthorities, deriveApprovalRequirements, validateApproval, explainApproverSelection, } from './approval.js';
+export { DEFAULT_RISK_CONFIG, DEFAULT_SENSITIVITY_MAP, assessRisk, } from './risk-scoring.js';
+export { assembleTimeline, verifyTimelineReplayability, } from './timeline.js';
+export { computeLearningSignal, recommendPolicyAdjustments, recordLearningSignal, readLearningSignals, aggregateLearning, } from './learning-feedback.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/trust/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,WAAW,EACX,YAAY,EACZ,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,0BAA0B,EAC1B,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,UAAU,GACX,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,gBAAgB,EAChB,2BAA2B,GAC5B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC"}

package/dist/trust/index.js

@@ -0,0 +1,6 @@
+export { createCapsule, transitionCapsule, submitForPolicy, recordApproval, revokeCapsule, beginExecution, completeExecution, evaluateCondition, checkPreconditions, checkPostconditions, saveCapsule, loadCapsule, listCapsules, recordCapsuleEvent, } from './capsule.js';
+export { DEFAULT_APPROVAL_POLICY, loadApprovalPolicy, findMatchingAuthorities, deriveApprovalRequirements, validateApproval, explainApproverSelection, } from './approval.js';
+export { DEFAULT_RISK_CONFIG, DEFAULT_SENSITIVITY_MAP, assessRisk, } from './risk-scoring.js';
+export { assembleTimeline, verifyTimelineReplayability, } from './timeline.js';
+export { computeLearningSignal, recommendPolicyAdjustments, recordLearningSignal, readLearningSignals, aggregateLearning, } from './learning-feedback.js';
+//# sourceMappingURL=index.js.map

package/dist/trust/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/trust/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,WAAW,EACX,YAAY,EACZ,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,0BAA0B,EAC1B,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,UAAU,GACX,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,gBAAgB,EAChB,2BAA2B,GAC5B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC"}

package/dist/trust/learning-feedback.d.ts

@@ -0,0 +1,18 @@
+import type { LearningSignal, PolicyAdjustment, CommandCapsule } from '@codeledger/types';
+/** Compute a learning signal from a completed capsule */
+export declare function computeLearningSignal(capsule: CommandCapsule): LearningSignal | null;
+/** Generate policy adjustment recommendations from learning signals */
+export declare function recommendPolicyAdjustments(signals: LearningSignal[], _currentPolicyRules: string[]): PolicyAdjustment[];
+/** Record a learning signal to the append-only log */
+export declare function recordLearningSignal(repoRoot: string, signal: LearningSignal): void;
+/** Read all learning signals from the log */
+export declare function readLearningSignals(repoRoot: string): LearningSignal[];
+/** Compute aggregate learning metrics for a given intent */
+export declare function aggregateLearning(signals: LearningSignal[], intentSignature: string): {
+    totalSignals: number;
+    positiveCount: number;
+    negativeCount: number;
+    avgMagnitude: number;
+    trend: 'improving' | 'degrading' | 'stable';
+};
+//# sourceMappingURL=learning-feedback.d.ts.map

package/dist/trust/learning-feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning-feedback.d.ts","sourceRoot":"","sources":["../../src/trust/learning-feedback.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAEhB,cAAc,EAEf,MAAM,mBAAmB,CAAC;AAM3B,yDAAyD;AACzD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,cAAc,GAAG,cAAc,GAAG,IAAI,CAsCpF;AAID,uEAAuE;AACvE,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,cAAc,EAAE,EACzB,mBAAmB,EAAE,MAAM,EAAE,GAC5B,gBAAgB,EAAE,CAoDpB;AAID,sDAAsD;AACtD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CAKnF;AAED,6CAA6C;AAC7C,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE,CAYtE;AAED,4DAA4D;AAC5D,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,eAAe,EAAE,MAAM,GAAG;IACrF,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;CAC7C,CAuBA"}

package/dist/trust/learning-feedback.js

@@ -0,0 +1,146 @@
+/**
+ * Learning Feedback Loop
+ *
+ * Closes the gap between execution outcomes and policy governance.
+ * Computes learning signals from outcomes and generates
+ * policy adjustment recommendations.
+ *
+ * Data flow:
+ *   Outcome → Learning Signal → Policy Adjustment Recommendation
+ *   ECL-Lite weights → risk score influence → future capsule evaluation
+ */
+import { readFileSync, appendFileSync, existsSync, mkdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+const LEARNING_LOG = '.codeledger/learning-signals.jsonl';
+// ─── Signal Computation ────────────────────────────────────────────────────
+/** Compute a learning signal from a completed capsule */
+export function computeLearningSignal(capsule) {
+    if (!capsule.outcome)
+        return null;
+    const direction = capsule.outcome.status === 'success' ? 'positive' : 'negative';
+    // Magnitude based on:
+    // - Risk level (higher risk outcomes carry more learning weight)
+    // - Number of targets affected
+    // - Whether preconditions/postconditions passed
+    const riskMultiplier = {
+        low: 0.25,
+        medium: 0.5,
+        high: 0.75,
+        critical: 1.0,
+    };
+    const baseWeight = riskMultiplier[capsule.risk.level] ?? 0.5;
+    const scopeFactor = Math.min(capsule.action.targets.length / 10, 1.0);
+    const conditionFactor = capsule.postconditions.some((c) => c.result && !c.result.passed) ? 0.8 : 1.0;
+    const magnitude = Math.round(baseWeight * (0.6 + 0.2 * scopeFactor + 0.2 * conditionFactor) * 100) / 100;
+    const factors = [];
+    factors.push(`risk_level:${capsule.risk.level}`);
+    factors.push(`targets:${capsule.action.targets.length}`);
+    if (capsule.outcome.testResults) {
+        factors.push(`tests:${capsule.outcome.testResults.passed}p/${capsule.outcome.testResults.failed}f`);
+    }
+    return {
+        intentSignature: capsule.intentSignature ?? capsule.id,
+        capsuleId: capsule.id,
+        direction,
+        magnitude,
+        factors,
+        recordedAt: new Date().toISOString(),
+    };
+}
+// ─── Policy Adjustment ─────────────────────────────────────────────────────
+/** Generate policy adjustment recommendations from learning signals */
+export function recommendPolicyAdjustments(signals, _currentPolicyRules) {
+    const adjustments = [];
+    // Group signals by intent
+    const byIntent = new Map();
+    for (const s of signals) {
+        const existing = byIntent.get(s.intentSignature) ?? [];
+        existing.push(s);
+        byIntent.set(s.intentSignature, existing);
+    }
+    for (const [intent, intentSignals] of byIntent) {
+        const negative = intentSignals.filter(s => s.direction === 'negative');
+        const total = intentSignals.length;
+        if (total < 3)
+            continue; // Need enough data to recommend
+        const failureRate = negative.length / total;
+        const avgNegMagnitude = negative.length > 0
+            ? negative.reduce((sum, s) => sum + s.magnitude, 0) / negative.length
+            : 0;
+        // High failure rate with high magnitude → tighten policy
+        if (failureRate > 0.5 && avgNegMagnitude > 0.5) {
+            adjustments.push({
+                ruleId: `intent:${intent}`,
+                adjustment: 'tighten',
+                reason: `${(failureRate * 100).toFixed(0)}% failure rate with avg magnitude ${avgNegMagnitude.toFixed(2)}`,
+                confidence: Math.min(failureRate * avgNegMagnitude * 2, 1.0),
+                suggestedChange: {
+                    increaseApprovalThreshold: true,
+                    addRequiredReview: true,
+                },
+            });
+        }
+        // Very low failure rate → consider relaxing
+        if (failureRate < 0.1 && total >= 5) {
+            adjustments.push({
+                ruleId: `intent:${intent}`,
+                adjustment: 'relax',
+                reason: `${(failureRate * 100).toFixed(0)}% failure rate over ${total} executions`,
+                confidence: Math.min((1 - failureRate) * 0.8, 1.0),
+                suggestedChange: {
+                    reduceApprovalRequirements: true,
+                    lowerRiskThreshold: true,
+                },
+            });
+        }
+    }
+    return adjustments.sort((a, b) => b.confidence - a.confidence);
+}
+// ─── Persistence ───────────────────────────────────────────────────────────
+/** Record a learning signal to the append-only log */
+export function recordLearningSignal(repoRoot, signal) {
+    const logPath = join(repoRoot, LEARNING_LOG);
+    const dir = dirname(logPath);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    appendFileSync(logPath, JSON.stringify(signal) + '\n', 'utf-8');
+}
+/** Read all learning signals from the log */
+export function readLearningSignals(repoRoot) {
+    const logPath = join(repoRoot, LEARNING_LOG);
+    if (!existsSync(logPath))
+        return [];
+    try {
+        const lines = readFileSync(logPath, 'utf-8').trim().split('\n');
+        return lines
+            .filter((line) => line.trim())
+            .map((line) => JSON.parse(line));
+    }
+    catch {
+        return [];
+    }
+}
+/** Compute aggregate learning metrics for a given intent */
+export function aggregateLearning(signals, intentSignature) {
+    const filtered = signals.filter(s => s.intentSignature === intentSignature);
+    if (filtered.length === 0) {
+        return { totalSignals: 0, positiveCount: 0, negativeCount: 0, avgMagnitude: 0, trend: 'stable' };
+    }
+    const positive = filtered.filter(s => s.direction === 'positive').length;
+    const negative = filtered.filter(s => s.direction === 'negative').length;
+    const avgMag = filtered.reduce((sum, s) => sum + s.magnitude, 0) / filtered.length;
+    // Trend: compare first half vs second half
+    const midpoint = Math.floor(filtered.length / 2);
+    if (midpoint > 0) {
+        const firstHalf = filtered.slice(0, midpoint);
+        const secondHalf = filtered.slice(midpoint);
+        const firstFailRate = firstHalf.filter(s => s.direction === 'negative').length / firstHalf.length;
+        const secondFailRate = secondHalf.filter(s => s.direction === 'negative').length / secondHalf.length;
+        if (secondFailRate < firstFailRate - 0.15)
+            return { totalSignals: filtered.length, positiveCount: positive, negativeCount: negative, avgMagnitude: Math.round(avgMag * 100) / 100, trend: 'improving' };
+        if (secondFailRate > firstFailRate + 0.15)
+            return { totalSignals: filtered.length, positiveCount: positive, negativeCount: negative, avgMagnitude: Math.round(avgMag * 100) / 100, trend: 'degrading' };
+    }
+    return { totalSignals: filtered.length, positiveCount: positive, negativeCount: negative, avgMagnitude: Math.round(avgMag * 100) / 100, trend: 'stable' };
+}
+//# sourceMappingURL=learning-feedback.js.map

package/dist/trust/learning-feedback.js.map

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

package/dist/trust/risk-scoring.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Risk Scoring Engine
+ *
+ * Computes risk for Command Capsules based on:
+ * - Action scope (number and sensitivity of targets)
+ * - Historical failure rate (from ECL-Lite)
+ * - Target sensitivity (security, data, infra files)
+ * - Change magnitude
+ * - Test coverage gaps
+ */
+import type { CapsuleRiskAssessment, ActionSpec, RiskScoringConfig, SensitivityMap } from '@codeledger/types';
+export declare const DEFAULT_RISK_CONFIG: RiskScoringConfig;
+export declare const DEFAULT_SENSITIVITY_MAP: SensitivityMap;
+/** Compute risk assessment for a capsule's action */
+export declare function assessRisk(action: ActionSpec, failureRate?: number, testedFiles?: Set<string>, config?: RiskScoringConfig, sensitivityMap?: SensitivityMap): CapsuleRiskAssessment;
+//# sourceMappingURL=risk-scoring.d.ts.map

package/dist/trust/risk-scoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"risk-scoring.d.ts","sourceRoot":"","sources":["../../src/trust/risk-scoring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EACV,qBAAqB,EAErB,UAAU,EACV,iBAAiB,EACjB,cAAc,EAEf,MAAM,mBAAmB,CAAC;AAI3B,eAAO,MAAM,mBAAmB,EAAE,iBAMjC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,cAerC,CAAC;AA+EF,qDAAqD;AACrD,wBAAgB,UAAU,CACxB,MAAM,EAAE,UAAU,EAClB,WAAW,GAAE,MAAU,EACvB,WAAW,GAAE,GAAG,CAAC,MAAM,CAAa,EACpC,MAAM,GAAE,iBAAuC,EAC/C,cAAc,GAAE,cAAwC,GACvD,qBAAqB,CAqDvB"}

package/dist/trust/risk-scoring.js

@@ -0,0 +1,142 @@
+// ─── Defaults ──────────────────────────────────────────────────────────────
+export const DEFAULT_RISK_CONFIG = {
+    scopeWeight: 0.20,
+    failureHistoryWeight: 0.25,
+    sensitivityWeight: 0.30,
+    magnitudeWeight: 0.15,
+    coverageGapWeight: 0.10,
+};
+export const DEFAULT_SENSITIVITY_MAP = {
+    patterns: [
+        { glob: '**/auth/**', level: 'critical' },
+        { glob: '**/security/**', level: 'critical' },
+        { glob: '**/crypto/**', level: 'critical' },
+        { glob: '**/.env*', level: 'critical' },
+        { glob: '**/credentials*', level: 'critical' },
+        { glob: '**/payment/**', level: 'high' },
+        { glob: '**/billing/**', level: 'high' },
+        { glob: '**/migration*', level: 'high' },
+        { glob: '**/schema*', level: 'high' },
+        { glob: '**/api/**', level: 'medium' },
+        { glob: '**/config/**', level: 'medium' },
+        { glob: '**/infra/**', level: 'medium' },
+    ],
+};
+// ─── Scoring ───────────────────────────────────────────────────────────────
+/** Score the scope of an action (0-1) */
+function scoreScope(action) {
+    const count = action.targets.length;
+    if (count <= 1)
+        return 0.1;
+    if (count <= 3)
+        return 0.3;
+    if (count <= 7)
+        return 0.5;
+    if (count <= 15)
+        return 0.7;
+    return 0.9;
+}
+/** Score historical failure rate (0-1) */
+function scoreFailureHistory(failureRate) {
+    // failureRate is 0.0 to 1.0 from ECL-Lite
+    return Math.min(failureRate * 1.2, 1.0);
+}
+/** Score target sensitivity (0-1) */
+function scoreSensitivity(targets, sensitivityMap) {
+    const levels = {
+        low: 0.1,
+        medium: 0.4,
+        high: 0.7,
+        critical: 1.0,
+    };
+    let maxScore = 0;
+    for (const target of targets) {
+        for (const entry of sensitivityMap.patterns) {
+            // Simple pattern matching
+            const pattern = entry.glob.replace(/\*\*/g, '').replace(/\*/g, '');
+            if (target.includes(pattern.replace(/\//g, '/').replace(/^\/|\/$/g, ''))) {
+                const score = levels[entry.level] ?? 0;
+                maxScore = Math.max(maxScore, score);
+            }
+        }
+    }
+    return maxScore;
+}
+/** Score change magnitude (0-1) */
+function scoreMagnitude(action) {
+    const sideEffects = action.sideEffects.length;
+    if (sideEffects === 0)
+        return 0.1;
+    if (sideEffects <= 2)
+        return 0.3;
+    if (sideEffects <= 5)
+        return 0.6;
+    return 0.9;
+}
+/** Score test coverage gap (0-1) */
+function scoreCoverageGap(targets, testedFiles) {
+    if (targets.length === 0)
+        return 0;
+    const untestedCount = targets.filter(t => !testedFiles.has(t)).length;
+    return untestedCount / targets.length;
+}
+/** Classify risk level from score */
+function classifyRisk(score) {
+    if (score >= 0.75)
+        return 'critical';
+    if (score >= 0.5)
+        return 'high';
+    if (score >= 0.25)
+        return 'medium';
+    return 'low';
+}
+// ─── Public API ────────────────────────────────────────────────────────────
+/** Compute risk assessment for a capsule's action */
+export function assessRisk(action, failureRate = 0, testedFiles = new Set(), config = DEFAULT_RISK_CONFIG, sensitivityMap = DEFAULT_SENSITIVITY_MAP) {
+    const factors = [];
+    const scopeScore = scoreScope(action);
+    factors.push({
+        name: 'scope',
+        weight: config.scopeWeight,
+        score: scopeScore,
+        description: `${action.targets.length} target(s) affected`,
+    });
+    const failScore = scoreFailureHistory(failureRate);
+    factors.push({
+        name: 'failure_history',
+        weight: config.failureHistoryWeight,
+        score: failScore,
+        description: `Historical failure rate: ${(failureRate * 100).toFixed(0)}%`,
+    });
+    const sensScore = scoreSensitivity(action.targets, sensitivityMap);
+    factors.push({
+        name: 'sensitivity',
+        weight: config.sensitivityWeight,
+        score: sensScore,
+        description: sensScore > 0.5 ? 'High-sensitivity targets detected' : 'Normal sensitivity',
+    });
+    const magScore = scoreMagnitude(action);
+    factors.push({
+        name: 'magnitude',
+        weight: config.magnitudeWeight,
+        score: magScore,
+        description: `${action.sideEffects.length} side effect(s)`,
+    });
+    const covScore = scoreCoverageGap(action.targets, testedFiles);
+    factors.push({
+        name: 'coverage_gap',
+        weight: config.coverageGapWeight,
+        score: covScore,
+        description: covScore > 0.5 ? 'Significant test coverage gap' : 'Adequate test coverage',
+    });
+    // Weighted sum
+    const totalScore = factors.reduce((sum, f) => sum + f.weight * f.score, 0);
+    const clampedScore = Math.min(Math.max(totalScore, 0), 1);
+    return {
+        score: Math.round(clampedScore * 1000) / 1000,
+        level: classifyRisk(clampedScore),
+        factors,
+        assessedAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=risk-scoring.js.map

package/dist/trust/risk-scoring.js.map

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

package/dist/trust/timeline.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Unified Execution Timeline
+ *
+ * Assembles a complete execution timeline from authoritative data sources:
+ * - Intent: from IOLE IntentSignature
+ * - Context: from ContextBundle
+ * - Policy: from TeamPolicyEvaluation
+ * - Approval: from CommandCapsule.approvalDecisions
+ * - Execution: from ECL-Lite entries
+ * - Outcome: from CapsuleOutcome
+ * - Learning: from ECL weight index
+ *
+ * Each stage is classified as AUTHORITATIVE, DERIVED, or SYNTHETIC.
+ * The timeline is replayable from stored data alone.
+ */
+import type { ExecutionTimeline, CommandCapsule } from '@codeledger/types';
+/** Assemble a timeline from a Command Capsule and its associated data */
+export declare function assembleTimeline(capsule: CommandCapsule, contextData?: {
+    bundleId: string;
+    fileCount: number;
+    tokens: number;
+}, policyData?: {
+    triggered: string[];
+    satisfied: string[];
+    violated: string[];
+}, eclData?: {
+    intentSignature: string;
+    outcome: string;
+    expansionLevel: number;
+}, learningData?: {
+    successWeight: number;
+    failureWeight: number;
+}): ExecutionTimeline;
+/** Replay a timeline — verify it can be reconstructed from stored data */
+export declare function verifyTimelineReplayability(timeline: ExecutionTimeline): {
+    replayable: boolean;
+    syntheticCount: number;
+    authoritativeCount: number;
+    derivedCount: number;
+    issues: string[];
+};
+//# sourceMappingURL=timeline.d.ts.map