@codeledger/engine 0.7.0

package/dist/license/publicKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publicKey.js","sourceRoot":"","sources":["../../src/license/publicKey.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAaH;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAqB;IACjD;QACE,KAAK,EAAE,OAAO;QACd,SAAS,EAAE,SAAS;QACpB,GAAG,EAAE;YACH,4BAA4B;YAC5B,8DAA8D;YAC9D,0BAA0B;SAC3B,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,UAAU,EAAE,sBAAsB;KACnC;CACF,CAAC;AAEF,qEAAqE;AACrE,MAAM,UAAU,kBAAkB;IAChC,MAAM,MAAM,GAAG,iBAAiB;SAC7B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;SAC3B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IAC5D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,MAAM,CAAC,CAAC,CAAE,CAAC;AACpB,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;AAC1D,CAAC"}

package/dist/license/verify.d.ts

@@ -0,0 +1,33 @@
+/**
+ * License signature verification — Ed25519 digital signature check.
+ *
+ * Verifies that a signed license was issued by the CodeLedger license
+ * authority using the embedded public key. All verification is local
+ * and deterministic — no network calls.
+ */
+import type { ParsedSignedLicense, LicensePayload } from './parse.js';
+export interface VerifySuccess {
+    valid: true;
+    payload: LicensePayload;
+}
+export interface VerifyFailure {
+    valid: false;
+    reason: string;
+}
+export type VerifyResult = VerifySuccess | VerifyFailure;
+/**
+ * Verify the Ed25519 signature on a parsed signed license.
+ *
+ * Tries all known public keys (supporting key rotation). If any key
+ * produces a valid signature, verification passes.
+ */
+export declare function verifySignature(license: ParsedSignedLicense): boolean;
+/**
+ * Validate business-logic claims in a license payload.
+ */
+export declare function validateClaims(payload: LicensePayload): VerifyResult;
+/**
+ * Full verification: signature check + claims validation.
+ */
+export declare function verifySignedLicense(license: ParsedSignedLicense): VerifyResult;
+//# sourceMappingURL=verify.d.ts.map

package/dist/license/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/license/verify.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMtE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,IAAI,CAAC;IACZ,OAAO,EAAE,cAAc,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,aAAa,CAAC;AAIzD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CA4BrE;AAID;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,YAAY,CA4BpE;AAID;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAQ9E"}

package/dist/license/verify.js

@@ -0,0 +1,82 @@
+/**
+ * License signature verification — Ed25519 digital signature check.
+ *
+ * Verifies that a signed license was issued by the CodeLedger license
+ * authority using the embedded public key. All verification is local
+ * and deterministic — no network calls.
+ */
+import { createPublicKey, verify } from 'node:crypto';
+import { base64urlToBuffer } from './parse.js';
+import { KNOWN_PUBLIC_KEYS } from './publicKey.js';
+// ── Signature verification ─────────────────────────────────────────────────
+/**
+ * Verify the Ed25519 signature on a parsed signed license.
+ *
+ * Tries all known public keys (supporting key rotation). If any key
+ * produces a valid signature, verification passes.
+ */
+export function verifySignature(license) {
+    const signatureBuffer = base64urlToBuffer(license.signatureRaw);
+    const payloadBuffer = Buffer.from(license.payloadRaw, 'utf-8');
+    // Try all known keys (supports rotation)
+    for (const keyEntry of KNOWN_PUBLIC_KEYS) {
+        try {
+            const publicKey = createPublicKey({
+                key: keyEntry.pem,
+                format: 'pem',
+                type: 'spki',
+            });
+            const isValid = verify(null, // Ed25519 does not use a separate hash algorithm
+            payloadBuffer, publicKey, signatureBuffer);
+            if (isValid)
+                return true;
+        }
+        catch {
+            // Key may be malformed or incompatible — skip and try next
+            continue;
+        }
+    }
+    return false;
+}
+// ── Claims validation ──────────────────────────────────────────────────────
+/**
+ * Validate business-logic claims in a license payload.
+ */
+export function validateClaims(payload) {
+    // Plan must be "pro"
+    if (payload.plan !== 'pro') {
+        return { valid: false, reason: `Unsupported plan: "${payload.plan}".` };
+    }
+    // Must include team + enterprise features
+    if (!payload.features.includes('team') || !payload.features.includes('enterprise')) {
+        return { valid: false, reason: 'License is missing required feature claims (team, enterprise).' };
+    }
+    // licenseId must exist
+    if (!payload.licenseId) {
+        return { valid: false, reason: 'License is missing a license ID.' };
+    }
+    // Check expiry
+    if (payload.expiresAt) {
+        const expiryDate = new Date(payload.expiresAt);
+        if (isNaN(expiryDate.getTime())) {
+            return { valid: false, reason: 'License has an invalid expiry date.' };
+        }
+        if (expiryDate.getTime() < Date.now()) {
+            return { valid: false, reason: `License expired on ${payload.expiresAt}.` };
+        }
+    }
+    return { valid: true, payload };
+}
+// ── Full verification pipeline ─────────────────────────────────────────────
+/**
+ * Full verification: signature check + claims validation.
+ */
+export function verifySignedLicense(license) {
+    // Step 1: Verify cryptographic signature
+    if (!verifySignature(license)) {
+        return { valid: false, reason: 'Invalid license signature. Please check your key.' };
+    }
+    // Step 2: Validate business claims
+    return validateClaims(license.payload);
+}
+//# sourceMappingURL=verify.js.map

package/dist/license/verify.js.map

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

package/dist/orchestrator/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Multi-Agent Orchestration Primitives
+ *
+ * Evolves conflict detection into coordination:
+ * - File reservation (claim/release)
+ * - Task partitioning (deterministic file assignment)
+ * - Dependency ordering (wait until dependency completes)
+ */
+export { claimFile, releaseFile, releaseAllForAgent, checkReservation, loadOrchestrationState, saveOrchestrationState, partitionFiles, orchestrationPath, ORCHESTRATION_FILE, } from './orchestrator.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/orchestrator/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,SAAS,EACT,WAAW,EACX,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC"}

package/dist/orchestrator/index.js

@@ -0,0 +1,10 @@
+/**
+ * Multi-Agent Orchestration Primitives
+ *
+ * Evolves conflict detection into coordination:
+ * - File reservation (claim/release)
+ * - Task partitioning (deterministic file assignment)
+ * - Dependency ordering (wait until dependency completes)
+ */
+export { claimFile, releaseFile, releaseAllForAgent, checkReservation, loadOrchestrationState, saveOrchestrationState, partitionFiles, orchestrationPath, ORCHESTRATION_FILE, } from './orchestrator.js';
+//# sourceMappingURL=index.js.map

package/dist/orchestrator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/orchestrator/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,SAAS,EACT,WAAW,EACX,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC"}

package/dist/orchestrator/orchestrator.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Multi-Agent Orchestration — Implementation
+ *
+ * Storage: .codeledger/orchestration.json
+ *
+ * Capabilities:
+ * 1. File reservation: Agent A claims file, Agent B warned or blocked
+ * 2. Task partitioning: Assign files to agents deterministically
+ * 3. Dependency ordering: Agent B waits until Agent A completes dependency
+ */
+import type { FileReservation, TaskPartition, ReservationResult, OrchestrationState } from '@codeledger/types';
+export declare const ORCHESTRATION_FILE = "orchestration.json";
+export declare function orchestrationPath(repoRoot: string): string;
+export declare function loadOrchestrationState(repoRoot: string): OrchestrationState;
+export declare function saveOrchestrationState(repoRoot: string, state: OrchestrationState): void;
+/**
+ * Attempt to claim a file reservation for an agent.
+ *
+ * If the file is already reserved by another active agent and the
+ * reservation hasn't expired, the claim is denied.
+ */
+export declare function claimFile(repoRoot: string, file: string, agentId: string, expiryMs?: number): ReservationResult;
+/**
+ * Release a file reservation held by an agent.
+ */
+export declare function releaseFile(repoRoot: string, file: string, agentId: string): boolean;
+/**
+ * Release all reservations held by a specific agent.
+ */
+export declare function releaseAllForAgent(repoRoot: string, agentId: string): number;
+/**
+ * Check if a file is reserved and by whom.
+ */
+export declare function checkReservation(repoRoot: string, file: string): FileReservation | null;
+/**
+ * Partition files across agents deterministically.
+ *
+ * Uses round-robin assignment based on sorted file paths.
+ * The depGraph parameter maps each file to its dependencies; if file B
+ * depends on file A and they're in different partitions, a dependency
+ * edge is recorded.
+ */
+export declare function partitionFiles(files: string[], agentIds: string[], depGraph: Map<string, string[]>): TaskPartition[];
+//# sourceMappingURL=orchestrator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/orchestrator/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,mBAAmB,CAAC;AAI3B,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AAKvD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE1D;AAID,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAoB3E;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAKxF;AAID;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAA0B,GACnC,iBAAiB,CAuCnB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAUpF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAO5E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,eAAe,GAAG,IAAI,CAgBxB;AAID;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EAAE,EACf,QAAQ,EAAE,MAAM,EAAE,EAClB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAC9B,aAAa,EAAE,CAwCjB"}

package/dist/orchestrator/orchestrator.js

@@ -0,0 +1,182 @@
+/**
+ * Multi-Agent Orchestration — Implementation
+ *
+ * Storage: .codeledger/orchestration.json
+ *
+ * Capabilities:
+ * 1. File reservation: Agent A claims file, Agent B warned or blocked
+ * 2. Task partitioning: Assign files to agents deterministically
+ * 3. Dependency ordering: Agent B waits until Agent A completes dependency
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { join, dirname } from 'path';
+// ─── Constants ────────────────────────────────────────────────────────────────
+export const ORCHESTRATION_FILE = 'orchestration.json';
+const DEFAULT_EXPIRY_MS = 30 * 60 * 1000; // 30 minutes
+// ─── Paths ────────────────────────────────────────────────────────────────────
+export function orchestrationPath(repoRoot) {
+    return join(repoRoot, '.codeledger', ORCHESTRATION_FILE);
+}
+// ─── State Management ─────────────────────────────────────────────────────────
+export function loadOrchestrationState(repoRoot) {
+    const path = orchestrationPath(repoRoot);
+    if (!existsSync(path)) {
+        return {
+            reservations: [],
+            partitions: [],
+            dependencyOrder: [],
+            updatedAt: Date.now(),
+        };
+    }
+    try {
+        return JSON.parse(readFileSync(path, 'utf-8'));
+    }
+    catch {
+        return {
+            reservations: [],
+            partitions: [],
+            dependencyOrder: [],
+            updatedAt: Date.now(),
+        };
+    }
+}
+export function saveOrchestrationState(repoRoot, state) {
+    const path = orchestrationPath(repoRoot);
+    ensureDir(dirname(path));
+    state.updatedAt = Date.now();
+    writeFileSync(path, JSON.stringify(state, null, 2), 'utf-8');
+}
+// ─── File Reservation ─────────────────────────────────────────────────────────
+/**
+ * Attempt to claim a file reservation for an agent.
+ *
+ * If the file is already reserved by another active agent and the
+ * reservation hasn't expired, the claim is denied.
+ */
+export function claimFile(repoRoot, file, agentId, expiryMs = DEFAULT_EXPIRY_MS) {
+    const state = loadOrchestrationState(repoRoot);
+    const now = Date.now();
+    // Clean expired reservations
+    state.reservations = state.reservations.filter((r) => r.expiresAt === 0 || r.expiresAt > now);
+    // Check if file is already reserved
+    const existing = state.reservations.find((r) => r.file === file);
+    if (existing && existing.agentId !== agentId) {
+        return {
+            granted: false,
+            heldBy: existing.agentId,
+            heldSince: existing.claimedAt,
+        };
+    }
+    // Grant or refresh the reservation
+    if (existing && existing.agentId === agentId) {
+        existing.claimedAt = now;
+        existing.expiresAt = expiryMs > 0 ? now + expiryMs : 0;
+        existing.active = true;
+        saveOrchestrationState(repoRoot, state);
+        return { granted: true, reservation: existing };
+    }
+    const reservation = {
+        file,
+        agentId,
+        claimedAt: now,
+        expiresAt: expiryMs > 0 ? now + expiryMs : 0,
+        active: true,
+    };
+    state.reservations.push(reservation);
+    saveOrchestrationState(repoRoot, state);
+    return { granted: true, reservation };
+}
+/**
+ * Release a file reservation held by an agent.
+ */
+export function releaseFile(repoRoot, file, agentId) {
+    const state = loadOrchestrationState(repoRoot);
+    const idx = state.reservations.findIndex((r) => r.file === file && r.agentId === agentId);
+    if (idx === -1)
+        return false;
+    state.reservations.splice(idx, 1);
+    saveOrchestrationState(repoRoot, state);
+    return true;
+}
+/**
+ * Release all reservations held by a specific agent.
+ */
+export function releaseAllForAgent(repoRoot, agentId) {
+    const state = loadOrchestrationState(repoRoot);
+    const before = state.reservations.length;
+    state.reservations = state.reservations.filter((r) => r.agentId !== agentId);
+    const released = before - state.reservations.length;
+    if (released > 0)
+        saveOrchestrationState(repoRoot, state);
+    return released;
+}
+/**
+ * Check if a file is reserved and by whom.
+ */
+export function checkReservation(repoRoot, file) {
+    const state = loadOrchestrationState(repoRoot);
+    const now = Date.now();
+    const reservation = state.reservations.find((r) => r.file === file);
+    if (!reservation)
+        return null;
+    // Check expiry
+    if (reservation.expiresAt > 0 && reservation.expiresAt <= now) {
+        // Expired — remove it
+        state.reservations = state.reservations.filter((r) => r.file !== file);
+        saveOrchestrationState(repoRoot, state);
+        return null;
+    }
+    return reservation;
+}
+// ─── Task Partitioning ────────────────────────────────────────────────────────
+/**
+ * Partition files across agents deterministically.
+ *
+ * Uses round-robin assignment based on sorted file paths.
+ * The depGraph parameter maps each file to its dependencies; if file B
+ * depends on file A and they're in different partitions, a dependency
+ * edge is recorded.
+ */
+export function partitionFiles(files, agentIds, depGraph) {
+    if (agentIds.length === 0)
+        return [];
+    const sorted = [...files].sort();
+    const partitions = new Map();
+    for (const agentId of agentIds) {
+        partitions.set(agentId, { agentId, files: [], dependsOn: [] });
+    }
+    // Round-robin assignment
+    for (let i = 0; i < sorted.length; i++) {
+        const agentId = agentIds[i % agentIds.length];
+        partitions.get(agentId).files.push(sorted[i]);
+    }
+    // Compute dependency edges between partitions
+    const fileToAgent = new Map();
+    for (const [agentId, partition] of partitions) {
+        for (const f of partition.files) {
+            fileToAgent.set(f, agentId);
+        }
+    }
+    for (const [file, deps] of depGraph) {
+        const ownerAgent = fileToAgent.get(file);
+        if (!ownerAgent)
+            continue;
+        for (const dep of deps) {
+            const depAgent = fileToAgent.get(dep);
+            if (depAgent && depAgent !== ownerAgent) {
+                const partition = partitions.get(ownerAgent);
+                if (!partition.dependsOn.includes(depAgent)) {
+                    partition.dependsOn.push(depAgent);
+                }
+            }
+        }
+    }
+    return Array.from(partitions.values());
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function ensureDir(dir) {
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/orchestrator/orchestrator.js.map

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

package/dist/policy-sim/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Policy Simulation Engine
+ *
+ * Allows safe rollout of governance rules by simulating policy
+ * evaluation against historical ledger data.
+ */
+export { simulatePolicy, } from './simulate.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/policy-sim/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/policy-sim/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,cAAc,GACf,MAAM,eAAe,CAAC"}

package/dist/policy-sim/index.js

@@ -0,0 +1,8 @@
+/**
+ * Policy Simulation Engine
+ *
+ * Allows safe rollout of governance rules by simulating policy
+ * evaluation against historical ledger data.
+ */
+export { simulatePolicy, } from './simulate.js';
+//# sourceMappingURL=index.js.map

package/dist/policy-sim/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/policy-sim/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,cAAc,GACf,MAAM,eAAe,CAAC"}

package/dist/policy-sim/simulate.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Policy Simulation — Implementation
+ *
+ * Runs validation across past ledger entries and recent commits
+ * to predict impact of governance rules before enforcing them.
+ *
+ * Output: would-block rate, top violations, scope analysis.
+ */
+import type { PolicySimulationResult, TeamPolicyConfig, EclLiteEntry } from '@codeledger/types';
+/**
+ * Simulate a team policy against historical ECL-Lite entries.
+ *
+ * For each entry, reconstructs the task (from intentCategory) and
+ * evaluates the policy against the entry's file list. Reports how
+ * many entries would be blocked or warned.
+ */
+export declare function simulatePolicy(policy: TeamPolicyConfig, entries: EclLiteEntry[], scope?: 'team' | 'org'): PolicySimulationResult;
+//# sourceMappingURL=simulate.d.ts.map

package/dist/policy-sim/simulate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulate.d.ts","sourceRoot":"","sources":["../../src/policy-sim/simulate.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,sBAAsB,EACtB,gBAAgB,EAChB,YAAY,EAEb,MAAM,mBAAmB,CAAC;AAK3B;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,YAAY,EAAE,EACvB,KAAK,GAAE,MAAM,GAAG,KAAc,GAC7B,sBAAsB,CA8CxB"}

package/dist/policy-sim/simulate.js

@@ -0,0 +1,61 @@
+/**
+ * Policy Simulation — Implementation
+ *
+ * Runs validation across past ledger entries and recent commits
+ * to predict impact of governance rules before enforcing them.
+ *
+ * Output: would-block rate, top violations, scope analysis.
+ */
+import { evaluateTeamPolicy } from '../team-policy/index.js';
+// ─── Public API ───────────────────────────────────────────────────────────────
+/**
+ * Simulate a team policy against historical ECL-Lite entries.
+ *
+ * For each entry, reconstructs the task (from intentCategory) and
+ * evaluates the policy against the entry's file list. Reports how
+ * many entries would be blocked or warned.
+ */
+export function simulatePolicy(policy, entries, scope = 'team') {
+    const now = Date.now();
+    let blockedCount = 0;
+    let warnedCount = 0;
+    const violationCounts = new Map();
+    for (const entry of entries) {
+        // Reconstruct a pseudo-task from the intent category
+        const pseudoTask = entry.intentCategory ?? 'general_task';
+        const evaluation = evaluateTeamPolicy(policy, pseudoTask, entry.files);
+        if (!evaluation.passed) {
+            blockedCount++;
+        }
+        for (const violation of evaluation.violatedRules) {
+            if (violation.enforcement === 'block') {
+                const key = `missing:${violation.rule}`;
+                violationCounts.set(key, (violationCounts.get(key) ?? 0) + 1);
+            }
+            else {
+                warnedCount++;
+                const key = `warn:${violation.rule}`;
+                violationCounts.set(key, (violationCounts.get(key) ?? 0) + 1);
+            }
+        }
+    }
+    // Build top violations sorted by count
+    const topViolations = Array.from(violationCounts.entries())
+        .map(([reason, count]) => ({
+        reason,
+        count,
+        percentage: entries.length > 0 ? (count / entries.length) * 100 : 0,
+    }))
+        .sort((a, b) => b.count - a.count)
+        .slice(0, 10);
+    return {
+        totalEntries: entries.length,
+        blockedCount,
+        warnedCount,
+        blockRate: entries.length > 0 ? blockedCount / entries.length : 0,
+        topViolations,
+        scope,
+        simulatedAt: new Date(now).toISOString(),
+    };
+}
+//# sourceMappingURL=simulate.js.map

package/dist/policy-sim/simulate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulate.js","sourceRoot":"","sources":["../../src/policy-sim/simulate.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,iFAAiF;AAEjF;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAwB,EACxB,OAAuB,EACvB,QAAwB,MAAM;IAE9B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAC;IAElD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,qDAAqD;QACrD,MAAM,UAAU,GAAG,KAAK,CAAC,cAAc,IAAI,cAAc,CAAC;QAC1D,MAAM,UAAU,GAAG,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QAEvE,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;YACvB,YAAY,EAAE,CAAC;QACjB,CAAC;QAED,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,aAAa,EAAE,CAAC;YACjD,IAAI,SAAS,CAAC,WAAW,KAAK,OAAO,EAAE,CAAC;gBACtC,MAAM,GAAG,GAAG,WAAW,SAAS,CAAC,IAAI,EAAE,CAAC;gBACxC,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAChE,CAAC;iBAAM,CAAC;gBACN,WAAW,EAAE,CAAC;gBACd,MAAM,GAAG,GAAG,QAAQ,SAAS,CAAC,IAAI,EAAE,CAAC;gBACrC,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;IACH,CAAC;IAED,uCAAuC;IACvC,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;SACxD,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QACzB,MAAM;QACN,KAAK;QACL,UAAU,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;KACpE,CAAC,CAAC;SACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;SACjC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEhB,OAAO;QACL,YAAY,EAAE,OAAO,CAAC,MAAM;QAC5B,YAAY;QACZ,WAAW;QACX,SAAS,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACjE,aAAa;QACb,KAAK;QACL,WAAW,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAiB;KACxD,CAAC;AACJ,CAAC"}

package/dist/provenance/graph.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Context Provenance Graph — Implementation
+ *
+ * Storage: .codeledger/provenance/
+ *   - nodes.jsonl (append-only node records)
+ *   - edges.jsonl (append-only edge records)
+ *
+ * Node types: task, intent, bundle, file, edit, commit, outcome
+ * Edge types: GENERATED_CONTEXT, INCLUDED_FILE, MODIFIED_FILE,
+ *             PRODUCED_OUTCOME, DERIVED_INTENT, COMMITTED_CHANGE
+ *
+ * Provides traceTask() for causal chain extraction:
+ *   "Auth bug fix → bundle (8 files) → edits (3 files) → commit → tests passed"
+ */
+import type { ProvenanceNode, ProvenanceEdge, ProvenanceGraph, ProvenanceTrace } from '@codeledger/types';
+export declare const PROVENANCE_DIR = "provenance";
+export declare function provenancePath(repoRoot: string): string;
+/**
+ * Add a node to the provenance graph.
+ * Creates the directory structure if it doesn't exist.
+ */
+export declare function addNode(repoRoot: string, node: ProvenanceNode): void;
+/**
+ * Add an edge to the provenance graph.
+ */
+export declare function addEdge(repoRoot: string, edge: ProvenanceEdge): void;
+/**
+ * Load the full provenance graph from disk.
+ */
+export declare function loadGraph(repoRoot: string): ProvenanceGraph;
+/**
+ * Trace the causal chain for a given task.
+ *
+ * Walks the graph from the task node through bundles, files, edits,
+ * commits, and outcomes — producing an ordered causal chain.
+ */
+export declare function traceTask(repoRoot: string, taskId: string): ProvenanceTrace | null;
+/**
+ * Export the graph as a JSON object (for --format graph in audit-export).
+ */
+export declare function exportGraph(repoRoot: string): ProvenanceGraph;
+//# sourceMappingURL=graph.d.ts.map

package/dist/provenance/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/provenance/graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,eAAe,EACf,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAI3B,eAAO,MAAM,cAAc,eAAe,CAAC;AAM3C,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvD;AAYD;;;GAGG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAIpE;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAIpE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAK3D;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAsDlF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAE7D"}