@codeledger/engine 0.7.1 → 0.7.3

package/dist/staleness/jit-staleness.js

@@ -0,0 +1,240 @@
+/**
+ * JIT Staleness — Context Shadowing (Hardened v2.5.1)
+ *
+ * Detects relevant changes to a session's context and prepares
+ * actionable shadow updates. Advisory only — never auto-merges.
+ *
+ * Hardening guarantees:
+ * - Three-tier change relevance:
+ *   1. Direct file staleness (bundle files changed) — strongest signal
+ *   2. Dependency-surface staleness (direct imports changed) — moderate signal
+ *   3. Test-surface staleness (shared tests changed) — weaker signal
+ * - Incidental branch churn (unrelated commits) does NOT cause staleness
+ * - Staleness severity is weighted, not just ratio-based:
+ *   - Direct changes count 1.0× toward staleness
+ *   - Dependency changes count 0.5× toward staleness
+ *   - Test-only changes count 0.25× toward staleness
+ * - Deterministic thresholds:
+ *   HIGH: weighted ratio ≥ 0.40 (40% of context weight is stale)
+ *   MEDIUM: weighted ratio ≥ 0.15
+ *   LOW: weighted ratio ≥ 0.05
+ *   FRESH: below 0.05
+ */
+import { execSync } from 'node:child_process';
+/**
+ * Staleness thresholds — based on *weighted* change ratio, not raw file count.
+ * These reflect actual risk to context quality:
+ * - HIGH means substantial portions of the working context are outdated
+ * - MEDIUM means some relevant files changed and context may be incomplete
+ * - LOW means minor peripheral changes occurred
+ */
+const STALENESS_THRESHOLDS = {
+    high: 0.40,
+    medium: 0.15,
+    low: 0.05,
+};
+/**
+ * Change relevance weights — how much each category of change contributes
+ * to the staleness score. Direct bundle changes are the strongest signal.
+ */
+const CHANGE_RELEVANCE_WEIGHTS = {
+    direct: 1.0, // Bundle file changed — full weight
+    dependency: 0.5, // Direct import/dependent changed — half weight
+    test: 0.25, // Shared test changed — quarter weight
+};
+/** Classify staleness level from a weighted ratio */
+export function classifyStaleness(weightedRatio) {
+    if (weightedRatio >= STALENESS_THRESHOLDS.high)
+        return 'high';
+    if (weightedRatio >= STALENESS_THRESHOLDS.medium)
+        return 'medium';
+    if (weightedRatio >= STALENESS_THRESHOLDS.low)
+        return 'low';
+    return 'fresh';
+}
+/**
+ * Classify staleness with direct file precedence.
+ * Bundle file changes dominate; dependency-only changes are capped at MEDIUM.
+ */
+export function classifyStalenessWeighted(bundleChangedCount, bundleTotal, depChangedCount) {
+    // Any tracked bundle file change → at least MEDIUM
+    if (bundleChangedCount > 0) {
+        const ratio = bundleTotal > 0 ? bundleChangedCount / bundleTotal : 0;
+        return classifyStaleness(ratio);
+    }
+    // Dependency-only changes → capped at MEDIUM, requires meaningful count
+    if (depChangedCount >= 3)
+        return 'medium';
+    if (depChangedCount >= 1)
+        return 'low';
+    return 'fresh';
+}
+/** Get files changed since a given git ref */
+export function getChangesSince(repoRoot, sinceRef) {
+    const results = [];
+    try {
+        // Get file changes with status
+        const diffOutput = execSync(`git log --name-status --format='%aE' ${sinceRef}..HEAD 2>/dev/null`, { cwd: repoRoot, encoding: 'utf-8', timeout: 10000 }).trim();
+        if (!diffOutput)
+            return results;
+        let currentAuthor = 'unknown';
+        for (const line of diffOutput.split('\n')) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            // Lines with @ are author emails
+            if (trimmed.includes('@') && !trimmed.includes('\t')) {
+                currentAuthor = trimmed.replace(/'/g, '');
+                continue;
+            }
+            // Status + path lines
+            const match = trimmed.match(/^([AMDRT])\t(.+)/);
+            if (match) {
+                results.push({
+                    path: match[2],
+                    status: match[1],
+                    author: currentAuthor,
+                });
+            }
+        }
+    }
+    catch {
+        // Non-fatal
+    }
+    return results;
+}
+/** Map git status letter to change kind */
+function mapChangeKind(status) {
+    switch (status) {
+        case 'A': return 'added';
+        case 'D': return 'deleted';
+        case 'R': return 'renamed';
+        default: return 'modified';
+    }
+}
+/** Test file detection pattern */
+const TEST_FILE_PATTERN = /\.(test|spec)\.[jt]sx?$/;
+/**
+ * Compute a shadow update for a session.
+ *
+ * Hardened: uses weighted change relevance instead of raw file count ratio.
+ * Direct bundle file changes carry full weight, dependency changes carry half,
+ * and test-only changes carry a quarter.
+ */
+export function computeShadowUpdate(repoRoot, sessionId, bundleFiles, dependencySurface, sinceRef) {
+    const changes = getChangesSince(repoRoot, sinceRef);
+    const bundleSet = new Set(bundleFiles);
+    const depSet = new Set(dependencySurface);
+    const changedFiles = [];
+    const seen = new Set();
+    for (const change of changes) {
+        if (seen.has(change.path))
+            continue;
+        seen.add(change.path);
+        const inBundle = bundleSet.has(change.path);
+        const inDep = depSet.has(change.path);
+        // Hardened: only include files relevant to the session
+        if (!inBundle && !inDep)
+            continue;
+        changedFiles.push({
+            path: change.path,
+            changedBy: change.author,
+            changeKind: mapChangeKind(change.status),
+            inBundle,
+            inDependencySurface: inDep,
+            description: buildChangeDescription(change.path, change.status, change.author),
+        });
+    }
+    // Hardened: weighted staleness computation
+    const totalContextSize = Math.max(bundleFiles.length, 1);
+    let weightedChangeScore = 0;
+    for (const file of changedFiles) {
+        if (file.inBundle) {
+            // Direct bundle change — full weight
+            // Test files in the bundle are still direct changes (they were selected for the task)
+            weightedChangeScore += CHANGE_RELEVANCE_WEIGHTS.direct;
+        }
+        else if (file.inDependencySurface) {
+            // Dependency-surface change — classify as test or dependency
+            const isTest = TEST_FILE_PATTERN.test(file.path);
+            weightedChangeScore += isTest
+                ? CHANGE_RELEVANCE_WEIGHTS.test
+                : CHANGE_RELEVANCE_WEIGHTS.dependency;
+        }
+    }
+    const weightedRatio = weightedChangeScore / totalContextSize;
+    const stalenessLevel = classifyStaleness(weightedRatio);
+    return {
+        sessionId,
+        changedFiles,
+        summary: buildSummary(changedFiles, stalenessLevel),
+        computedAt: new Date().toISOString(),
+        stalenessLevel,
+    };
+}
+/** Build a human-readable change description */
+function buildChangeDescription(path, status, author) {
+    const action = status === 'A' ? 'added' : status === 'D' ? 'deleted' : status === 'R' ? 'renamed' : 'modified';
+    return `${path} ${action} by ${author}`;
+}
+/**
+ * Build a concise summary of all changes.
+ *
+ * Hardened tone: measured, specific, actionable.
+ */
+function buildSummary(changes, level) {
+    if (changes.length === 0)
+        return 'No relevant changes detected.';
+    const bundleChanges = changes.filter(c => c.inBundle);
+    const depChanges = changes.filter(c => !c.inBundle && c.inDependencySurface);
+    const parts = [];
+    if (bundleChanges.length > 0) {
+        const files = bundleChanges.slice(0, 3).map(c => c.path).join(', ');
+        parts.push(`${bundleChanges.length} tracked file(s) changed: ${files}${bundleChanges.length > 3 ? '...' : ''}`);
+    }
+    if (depChanges.length > 0) {
+        parts.push(`${depChanges.length} dependency file(s) changed`);
+    }
+    const authors = [...new Set(changes.map(c => c.changedBy).filter(a => a && a !== 'unknown'))];
+    if (authors.length > 0) {
+        parts.push(`by ${authors.join(', ')}`);
+    }
+    // Hardened: use measured labels, not shouting
+    const levelLabel = level === 'high' ? 'Staleness: high' :
+        level === 'medium' ? 'Staleness: medium' :
+            level === 'low' ? 'Staleness: low' :
+                'Fresh';
+    return `[${levelLabel}] ${parts.join('. ')}.`;
+}
+/**
+ * Format a shadow update as an advisory message for the user.
+ *
+ * Hardened: concise, specific, actionable.
+ */
+export function formatShadowAdvisory(update) {
+    if (update.stalenessLevel === 'fresh') {
+        return 'Context is fresh — no relevant changes detected.';
+    }
+    const lines = [];
+    lines.push(update.summary);
+    lines.push('');
+    // Show bundle changes first (more important), then deps
+    const bundleChanges = update.changedFiles.filter(f => f.inBundle);
+    const depChanges = update.changedFiles.filter(f => !f.inBundle);
+    for (const file of bundleChanges.slice(0, 5)) {
+        lines.push(`  [TRACKED] ${file.description}`);
+    }
+    for (const file of depChanges.slice(0, 5)) {
+        lines.push(`  [DEP] ${file.description}`);
+    }
+    const totalShown = Math.min(bundleChanges.length, 5) + Math.min(depChanges.length, 5);
+    if (update.changedFiles.length > totalShown) {
+        lines.push(`  ... and ${update.changedFiles.length - totalShown} more`);
+    }
+    if (update.stalenessLevel === 'medium' || update.stalenessLevel === 'high') {
+        lines.push('');
+        lines.push('Refresh context bundle to incorporate these changes before continuing.');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=jit-staleness.js.map

package/dist/staleness/jit-staleness.js.map

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

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

@@ -4,5 +4,5 @@
  * Moves from "what NOT to do" → "what MUST be included".
  * Evaluates required file inclusion rules against context bundles.
  */
-export { loadTeamPolicy, evaluateTeamPolicy, matchTriggeredRules, DEFAULT_TEAM_POLICY, } from './policy.js';
+export { loadTeamPolicy, evaluateTeamPolicy, matchTriggeredRules, DEFAULT_TEAM_POLICY, recordPolicyEvent, readPolicyEvents, } from './policy.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/team-policy/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/team-policy/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,aAAa,CAAC"}

package/dist/team-policy/index.js

@@ -4,5 +4,5 @@
  * Moves from "what NOT to do" → "what MUST be included".
  * Evaluates required file inclusion rules against context bundles.
  */
-export { loadTeamPolicy, evaluateTeamPolicy, matchTriggeredRules, DEFAULT_TEAM_POLICY, } from './policy.js';
+export { loadTeamPolicy, evaluateTeamPolicy, matchTriggeredRules, DEFAULT_TEAM_POLICY, recordPolicyEvent, readPolicyEvents, } from './policy.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/team-policy/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/team-policy/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,aAAa,CAAC"}

package/dist/team-policy/policy.d.ts

@@ -32,4 +32,11 @@ export declare function matchTriggeredRules(policy: TeamPolicyConfig, task: stri
  * in the bundle's file list. Returns pass/fail with details.
  */
 export declare function evaluateTeamPolicy(policy: TeamPolicyConfig, task: string, bundleFiles: string[]): TeamPolicyEvaluation;
+/**
+ * Record a policy evaluation as an append-only event.
+ * Closes the audit gap: policy decisions are now persisted.
+ */
+export declare function recordPolicyEvent(repoRoot: string, task: string, evaluation: TeamPolicyEvaluation): void;
+/** Read all policy evaluation events from the log */
+export declare function readPolicyEvents(repoRoot: string): Array<Record<string, unknown>>;
 //# sourceMappingURL=policy.d.ts.map

package/dist/team-policy/policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/team-policy/policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAI3B,eAAO,MAAM,mBAAmB,EAAE,gBAIjC,CAAC;AASF;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAcjE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,GACX,cAAc,EAAE,CAOlB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EAAE,GACpB,oBAAoB,CAsCtB"}
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/team-policy/policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAI3B,eAAO,MAAM,mBAAmB,EAAE,gBAIjC,CAAC;AASF;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAcjE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,GACX,cAAc,EAAE,CAOlB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EAAE,GACpB,oBAAoB,CAsCtB;AAID;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,oBAAoB,GAC/B,IAAI,CAmBN;AAED,qDAAqD;AACrD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAajF"}

package/dist/team-policy/policy.js

@@ -97,4 +97,42 @@ export function evaluateTeamPolicy(policy, task, bundleFiles) {
         violatedRules: violated,
     };
 }
+// ─── Policy Event Recording ────────────────────────────────────────────────
+/**
+ * Record a policy evaluation as an append-only event.
+ * Closes the audit gap: policy decisions are now persisted.
+ */
+export function recordPolicyEvent(repoRoot, task, evaluation) {
+    const { appendFileSync, existsSync: exists, mkdirSync: mkDir } = require('fs');
+    const { join: pathJoin, dirname: pathDirname } = require('path');
+    const logPath = pathJoin(repoRoot, '.codeledger', 'policy-events.jsonl');
+    const dir = pathDirname(logPath);
+    if (!exists(dir))
+        mkDir(dir, { recursive: true });
+    const event = {
+        type: 'policy_evaluation',
+        task,
+        passed: evaluation.passed,
+        triggeredRules: evaluation.triggeredRules,
+        satisfiedRules: evaluation.satisfiedRules,
+        violatedRules: evaluation.violatedRules.map(r => r.rule),
+        timestamp: new Date().toISOString(),
+    };
+    appendFileSync(logPath, JSON.stringify(event) + '\n', 'utf-8');
+}
+/** Read all policy evaluation events from the log */
+export function readPolicyEvents(repoRoot) {
+    const { readFileSync, existsSync: exists } = require('fs');
+    const { join: pathJoin } = require('path');
+    const logPath = pathJoin(repoRoot, '.codeledger', 'policy-events.jsonl');
+    if (!exists(logPath))
+        return [];
+    try {
+        const lines = readFileSync(logPath, 'utf-8').trim().split('\n');
+        return lines.filter(l => l.trim()).map(l => JSON.parse(l));
+    }
+    catch {
+        return [];
+    }
+}
 //# sourceMappingURL=policy.js.map

package/dist/team-policy/policy.js.map

@@ -1 +1 @@
-{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/team-policy/policy.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/team-policy/policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAO5B,iFAAiF;AAEjF,MAAM,CAAC,MAAM,mBAAmB,GAAqB;IACnD,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,KAAK;IACd,KAAK,EAAE,EAAE;CACV,CAAC;AAEF,MAAM,gBAAgB,GAAG;IACvB,6BAA6B;IAC7B,8BAA8B;CAC/B,CAAC;AAEF,iFAAiF;AAEjF;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,KAAK,MAAM,QAAQ,IAAI,gBAAgB,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACtC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAqB,CAAC;gBACxE,OAAO,EAAE,GAAG,mBAAmB,EAAE,GAAG,GAAG,EAAE,CAAC;YAC5C,CAAC;YAAC,MAAM,CAAC;gBACP,oCAAoC;gBACpC,OAAO,mBAAmB,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAwB,EACxB,IAAY;IAEZ,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAE5D,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAClC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CACxE,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAwB,EACxB,IAAY,EACZ,WAAqB;IAErB,MAAM,SAAS,GAAG,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAEpD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO;YACL,MAAM,EAAE,IAAI;YACZ,cAAc,EAAE,EAAE;YAClB,cAAc,EAAE,EAAE;YAClB,aAAa,EAAE,EAAE;SAClB,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;IACvC,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,QAAQ,GAA0C,EAAE,CAAC;IAE3D,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACpE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,YAAY,EAAE,OAAO;gBACrB,WAAW,EAAE,IAAI,CAAC,WAAW;aAC9B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,6CAA6C;IAC7C,MAAM,iBAAiB,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,OAAO,CAAC,CAAC;IAE1E,OAAO;QACL,MAAM,EAAE,CAAC,iBAAiB;QAC1B,cAAc,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5C,cAAc,EAAE,SAAS;QACzB,aAAa,EAAE,QAAQ;KACxB,CAAC;AACJ,CAAC;AAED,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAgB,EAChB,IAAY,EACZ,UAAgC;IAEhC,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,IAAI,CAAwB,CAAC;IACtG,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,CAA0B,CAAC;IAE1F,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,EAAE,aAAa,EAAE,qBAAqB,CAAC,CAAC;IACzE,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;QAAE,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAElD,MAAM,KAAK,GAAG;QACZ,IAAI,EAAE,mBAAmB;QACzB,IAAI;QACJ,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,cAAc,EAAE,UAAU,CAAC,cAAc;QACzC,cAAc,EAAE,UAAU,CAAC,cAAc;QACzC,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACxD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;IAEF,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AACjE,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAwB,CAAC;IAClF,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,MAAM,CAA0B,CAAC;IAEpE,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,EAAE,aAAa,EAAE,qBAAqB,CAAC,CAAC;IACzE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IAEhC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChE,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/trust/approval.d.ts

@@ -0,0 +1,16 @@
+import type { ApprovalAuthority, ApprovalPolicyConfig, ApprovalRequirement, ApprovalDecision, CommandCapsule } from '@codeledger/types';
+export declare const DEFAULT_APPROVAL_POLICY: ApprovalPolicyConfig;
+/** Load approval policy from disk */
+export declare function loadApprovalPolicy(repoRoot: string): ApprovalPolicyConfig;
+/** Find authorities that cover the given file targets */
+export declare function findMatchingAuthorities(authorities: ApprovalAuthority[], targets: string[]): ApprovalAuthority[];
+/** Determine approval requirements for a capsule */
+export declare function deriveApprovalRequirements(capsule: CommandCapsule, policy: ApprovalPolicyConfig): ApprovalRequirement[];
+/** Validate an approval decision against policy */
+export declare function validateApproval(capsule: CommandCapsule, decision: ApprovalDecision, policy: ApprovalPolicyConfig): {
+    valid: boolean;
+    reason: string;
+};
+/** Explain why a specific approver was selected */
+export declare function explainApproverSelection(capsule: CommandCapsule, policy: ApprovalPolicyConfig): string[];
+//# sourceMappingURL=approval.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"approval.d.ts","sourceRoot":"","sources":["../../src/trust/approval.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EAEf,MAAM,mBAAmB,CAAC;AAoD3B,eAAO,MAAM,uBAAuB,EAAE,oBAOrC,CAAC;AAIF,qCAAqC;AACrC,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,CASzE;AAID,yDAAyD;AACzD,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,iBAAiB,EAAE,EAChC,OAAO,EAAE,MAAM,EAAE,GAChB,iBAAiB,EAAE,CAMrB;AAED,oDAAoD;AACpD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,oBAAoB,GAC3B,mBAAmB,EAAE,CA0CvB;AAID,mDAAmD;AACnD,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,gBAAgB,EAC1B,MAAM,EAAE,oBAAoB,GAC3B;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAuCpC;AAED,mDAAmD;AACnD,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,oBAAoB,GAC3B,MAAM,EAAE,CAuBV"}

package/dist/trust/approval.js

@@ -0,0 +1,183 @@
+/**
+ * Approval Workflow — Authority Model & Approver Selection
+ *
+ * Determines WHO must approve a capsule based on:
+ * - Action targets (file patterns)
+ * - Risk level
+ * - Policy requirements
+ *
+ * Handles edge cases:
+ * - No approver found → blocks with explicit error
+ * - Self-approval prevention
+ * - Delegation with depth limit
+ * - Multiple approvers required
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+const APPROVAL_POLICY_FILE = '.codeledger/approval-policy.json';
+// ─── Simple Glob Matching ──────────────────────────────────────────────────
+/**
+ * Simple glob matcher supporting *, **, and ? wildcards.
+ * Avoids external minimatch dependency.
+ */
+function simpleGlobMatch(pattern, target) {
+    // Escape regex special chars except our glob wildcards
+    let regexStr = '';
+    let i = 0;
+    while (i < pattern.length) {
+        const ch = pattern[i];
+        if (ch === '*') {
+            if (pattern[i + 1] === '*') {
+                // ** matches any path segment(s)
+                if (pattern[i + 2] === '/') {
+                    regexStr += '(?:.+/)?';
+                    i += 3;
+                }
+                else {
+                    regexStr += '.*';
+                    i += 2;
+                }
+            }
+            else {
+                // * matches anything except /
+                regexStr += '[^/]*';
+                i += 1;
+            }
+        }
+        else if (ch === '?') {
+            regexStr += '[^/]';
+            i += 1;
+        }
+        else if ('.+^${}()|[]\\'.includes(ch)) {
+            regexStr += '\\' + ch;
+            i += 1;
+        }
+        else {
+            regexStr += ch;
+            i += 1;
+        }
+    }
+    try {
+        return new RegExp(`^${regexStr}$`).test(target);
+    }
+    catch {
+        return false;
+    }
+}
+// ─── Default Policy ────────────────────────────────────────────────────────
+export const DEFAULT_APPROVAL_POLICY = {
+    version: 1,
+    enabled: false,
+    authorities: [],
+    preventSelfApproval: true,
+    maxDelegationDepth: 2,
+    approvalThreshold: 'medium',
+};
+// ─── Policy Loading ────────────────────────────────────────────────────────
+/** Load approval policy from disk */
+export function loadApprovalPolicy(repoRoot) {
+    const path = join(repoRoot, APPROVAL_POLICY_FILE);
+    if (!existsSync(path))
+        return DEFAULT_APPROVAL_POLICY;
+    try {
+        const raw = JSON.parse(readFileSync(path, 'utf-8'));
+        return { ...DEFAULT_APPROVAL_POLICY, ...raw };
+    }
+    catch {
+        return DEFAULT_APPROVAL_POLICY;
+    }
+}
+// ─── Approver Selection ────────────────────────────────────────────────────
+/** Find authorities that cover the given file targets */
+export function findMatchingAuthorities(authorities, targets) {
+    return authorities.filter((auth) => targets.some((target) => auth.patterns.some((pattern) => simpleGlobMatch(pattern, target))));
+}
+/** Determine approval requirements for a capsule */
+export function deriveApprovalRequirements(capsule, policy) {
+    if (!policy.enabled)
+        return [];
+    // Check if risk level meets approval threshold
+    const riskOrder = ['low', 'medium', 'high', 'critical'];
+    const capsuleRiskIdx = riskOrder.indexOf(capsule.risk.level);
+    const thresholdIdx = riskOrder.indexOf(policy.approvalThreshold);
+    if (capsuleRiskIdx < thresholdIdx) {
+        // Risk below threshold — no approval needed
+        return [];
+    }
+    // Find matching authorities for this capsule's targets
+    const matching = findMatchingAuthorities(policy.authorities, capsule.action.targets);
+    if (matching.length === 0) {
+        // No authority covers these targets — require owner approval
+        return [{
+                policyId: 'default_owner_approval',
+                ruleName: 'No specific authority — owner required',
+                requiredScope: 'owner',
+                reason: `No authority covers targets: ${capsule.action.targets.slice(0, 3).join(', ')}`,
+                delegatable: false,
+            }];
+    }
+    // Group by scope — require the highest scope authority
+    const scopeOrder = ['any_peer', 'team_lead', 'security', 'owner'];
+    const highestScope = matching.reduce((best, auth) => {
+        const bestIdx = scopeOrder.indexOf(best.scope);
+        const authIdx = scopeOrder.indexOf(auth.scope);
+        return authIdx > bestIdx ? auth : best;
+    }, matching[0]);
+    return [{
+            policyId: `authority_${highestScope.actorId}`,
+            ruleName: `Authority: ${highestScope.actorId} (${highestScope.scope})`,
+            requiredScope: highestScope.scope,
+            reason: `Covers target patterns: ${highestScope.patterns.join(', ')}`,
+            delegatable: highestScope.canDelegate,
+        }];
+}
+// ─── Validation ────────────────────────────────────────────────────────────
+/** Validate an approval decision against policy */
+export function validateApproval(capsule, decision, policy) {
+    // Self-approval check
+    if (policy.preventSelfApproval && decision.approver === capsule.createdBy) {
+        return { valid: false, reason: 'Self-approval is not permitted' };
+    }
+    // Check delegation depth
+    if (decision.decision === 'delegated') {
+        const delegationCount = capsule.approvalDecisions.filter((d) => d.decision === 'delegated').length;
+        if (delegationCount >= policy.maxDelegationDepth) {
+            return {
+                valid: false,
+                reason: `Maximum delegation depth (${policy.maxDelegationDepth}) exceeded`,
+            };
+        }
+        // Check if this requirement is delegatable
+        const requirement = capsule.approvalRequirements.find((r) => r.policyId === decision.policyId);
+        if (requirement && !requirement.delegatable) {
+            return { valid: false, reason: 'This approval requirement cannot be delegated' };
+        }
+    }
+    // Check authority scope
+    const requirement = capsule.approvalRequirements.find((r) => r.policyId === decision.policyId);
+    if (requirement) {
+        const scopeOrder = ['any_peer', 'team_lead', 'security', 'owner'];
+        const requiredIdx = scopeOrder.indexOf(requirement.requiredScope ?? '');
+        const actualIdx = scopeOrder.indexOf(decision.authorityScope ?? '');
+        if (actualIdx < requiredIdx) {
+            return {
+                valid: false,
+                reason: `Insufficient authority scope: requires '${requirement.requiredScope}', got '${decision.authorityScope}'`,
+            };
+        }
+    }
+    return { valid: true, reason: 'Approval is valid' };
+}
+/** Explain why a specific approver was selected */
+export function explainApproverSelection(capsule, policy) {
+    const explanations = [];
+    for (const req of capsule.approvalRequirements) {
+        const matchingAuthorities = findMatchingAuthorities(policy.authorities, capsule.action.targets);
+        explanations.push(`Requirement: ${req.ruleName}`, `  Scope: ${req.requiredScope}`, `  Reason: ${req.reason}`, `  Delegatable: ${req.delegatable}`, `  Matching authorities: ${matchingAuthorities.map(a => a.actorId).join(', ') || 'none (defaults to owner)'}`);
+    }
+    if (explanations.length === 0) {
+        explanations.push('No approval required for this capsule.');
+    }
+    return explanations;
+}
+//# sourceMappingURL=approval.js.map

package/dist/trust/approval.js.map

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

package/dist/trust/capsule.d.ts

@@ -0,0 +1,36 @@
+import type { CommandCapsule, CapsuleState, ActionSpec, CapsuleOutcome, ExecutionCondition, ApprovalRequirement, ApprovalDecision } from '@codeledger/types';
+/** Create a new Command Capsule in draft state */
+export declare function createCapsule(action: ActionSpec, createdBy: string, intentSignature?: string): CommandCapsule;
+/** Transition a capsule to a new state (validates transition) */
+export declare function transitionCapsule(capsule: CommandCapsule, to: CapsuleState, trigger: string, actor: string, metadata?: Record<string, unknown>): CommandCapsule;
+/** Submit capsule for policy evaluation */
+export declare function submitForPolicy(capsule: CommandCapsule, policyIds: string[], requirements: ApprovalRequirement[], actor: string): CommandCapsule;
+/** Record an approval decision */
+export declare function recordApproval(capsule: CommandCapsule, decision: ApprovalDecision): CommandCapsule;
+/** Revoke a previously approved capsule */
+export declare function revokeCapsule(capsule: CommandCapsule, actor: string, reason: string): CommandCapsule;
+/** Begin execution of an approved capsule */
+export declare function beginExecution(capsule: CommandCapsule, actor: string): CommandCapsule;
+/** Record execution outcome */
+export declare function completeExecution(capsule: CommandCapsule, outcome: CapsuleOutcome, actor: string): CommandCapsule;
+/** Evaluate a precondition or postcondition */
+export declare function evaluateCondition(condition: ExecutionCondition, passed: boolean, message: string): ExecutionCondition;
+/** Check if all required preconditions pass */
+export declare function checkPreconditions(capsule: CommandCapsule): {
+    passed: boolean;
+    failures: ExecutionCondition[];
+};
+/** Check if all required postconditions pass */
+export declare function checkPostconditions(capsule: CommandCapsule): {
+    passed: boolean;
+    failures: ExecutionCondition[];
+};
+/** Save a capsule to disk */
+export declare function saveCapsule(repoRoot: string, capsule: CommandCapsule): void;
+/** Load a capsule from disk */
+export declare function loadCapsule(repoRoot: string, capsuleId: string): CommandCapsule | null;
+/** List all capsule IDs */
+export declare function listCapsules(repoRoot: string): string[];
+/** Record a capsule event to the append-only log */
+export declare function recordCapsuleEvent(repoRoot: string, capsuleId: string, event: string, actor: string, metadata?: Record<string, unknown>): void;
+//# sourceMappingURL=capsule.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capsule.d.ts","sourceRoot":"","sources":["../../src/trust/capsule.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EAEZ,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAEjB,MAAM,mBAAmB,CAAC;AAqB3B,kDAAkD;AAClD,wBAAgB,aAAa,CAC3B,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,MAAM,EACjB,eAAe,CAAC,EAAE,MAAM,GACvB,cAAc,CAoBhB;AAID,iEAAiE;AACjE,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,cAAc,EACvB,EAAE,EAAE,YAAY,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,cAAc,CAwBhB;AAID,2CAA2C;AAC3C,wBAAgB,eAAe,CAC7B,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,MAAM,EAAE,EACnB,YAAY,EAAE,mBAAmB,EAAE,EACnC,KAAK,EAAE,MAAM,GACZ,cAAc,CAYhB;AAID,kCAAkC;AAClC,wBAAgB,cAAc,CAC5B,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,gBAAgB,GACzB,cAAc,CA6BhB;AAED,2CAA2C;AAC3C,wBAAgB,aAAa,CAC3B,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,cAAc,CAKhB;AAID,6CAA6C;AAC7C,wBAAgB,cAAc,CAC5B,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,MAAM,GACZ,cAAc,CAEhB;AAED,+BAA+B;AAC/B,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,MAAM,GACZ,cAAc,CAKhB;AAID,+CAA+C;AAC/C,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,kBAAkB,EAC7B,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,MAAM,GACd,kBAAkB,CASpB;AAED,+CAA+C;AAC/C,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG;IAC3D,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAChC,CAOA;AAED,gDAAgD;AAChD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,cAAc,GAAG;IAC5D,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAChC,CAOA;AAID,6BAA6B;AAC7B,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAK3E;AAED,+BAA+B;AAC/B,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAQtF;AAED,2BAA2B;AAC3B,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAMvD;AAID,oDAAoD;AACpD,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,IAAI,CAcN"}