@codeledger/engine 0.7.0

package/dist/team-metrics/metrics.js

@@ -0,0 +1,156 @@
+/**
+ * Team Context Quality Score — Implementation
+ *
+ * Aggregates across sessions:
+ * - recall, precision, intent drift, CCS, ISC
+ *
+ * Produces a composite [0,1] score with trend and weak area identification.
+ *
+ * Storage: .codeledger/team-metrics.json
+ *
+ * Weights:
+ *   recall     0.30
+ *   precision  0.25
+ *   ccs        0.20
+ *   isc        0.15
+ *   drift      0.10  (inverted: lower drift = higher score)
+ */
+import { writeFileSync } from 'fs';
+import { join } from 'path';
+// ─── Constants ────────────────────────────────────────────────────────────────
+export const TEAM_METRICS_FILE = 'team-metrics.json';
+const SEVEN_DAYS_MS = 7 * 24 * 60 * 60 * 1000;
+// Factor weights
+const W_RECALL = 0.30;
+const W_PRECISION = 0.25;
+const W_CCS = 0.20;
+const W_ISC = 0.15;
+const W_DRIFT = 0.10;
+// Weak area thresholds
+const WEAK_THRESHOLD = 0.60;
+// ─── Public API ───────────────────────────────────────────────────────────────
+/**
+ * Compute team-level quality metrics from session snapshots.
+ *
+ * Each snapshot is a session's summary metrics. The function computes
+ * averages, a composite score, trend vs the previous period, and weak areas.
+ *
+ * Persists to .codeledger/team-metrics.json.
+ */
+export function computeTeamMetrics(repoRoot, snapshots) {
+    const now = Date.now();
+    if (snapshots.length === 0) {
+        const empty = {
+            score: 0,
+            sessionCount: 0,
+            avgRecall: 0,
+            avgPrecision: 0,
+            avgDrift: 0,
+            avgCcs: 0,
+            avgIsc: 0,
+            trend: 0,
+            weakAreas: [],
+            computedAt: new Date(now).toISOString(),
+            rangeStartMs: 0,
+            rangeEndMs: now,
+        };
+        persistMetrics(repoRoot, empty);
+        return empty;
+    }
+    // Split into current (last 7 days) and previous (7-14 days)
+    const current = snapshots.filter((s) => s.timestamp >= now - SEVEN_DAYS_MS);
+    const previous = snapshots.filter((s) => s.timestamp >= now - 2 * SEVEN_DAYS_MS && s.timestamp < now - SEVEN_DAYS_MS);
+    // Use all snapshots for the overall score
+    const avgRecall = avg(snapshots.map((s) => s.recall));
+    const avgPrecision = avg(snapshots.map((s) => s.precision));
+    const avgDrift = avg(snapshots.map((s) => s.drift));
+    const avgCcs = avg(snapshots.map((s) => s.ccs));
+    const avgIsc = avg(snapshots.map((s) => s.isc));
+    const score = computeComposite(avgRecall, avgPrecision, avgDrift, avgCcs, avgIsc);
+    // Trend: difference in composite between current and previous week
+    let trend = 0;
+    if (current.length > 0 && previous.length > 0) {
+        const currentScore = computeComposite(avg(current.map((s) => s.recall)), avg(current.map((s) => s.precision)), avg(current.map((s) => s.drift)), avg(current.map((s) => s.ccs)), avg(current.map((s) => s.isc)));
+        const previousScore = computeComposite(avg(previous.map((s) => s.recall)), avg(previous.map((s) => s.precision)), avg(previous.map((s) => s.drift)), avg(previous.map((s) => s.ccs)), avg(previous.map((s) => s.isc)));
+        trend = currentScore - previousScore;
+    }
+    const weakAreas = identifyWeakAreas(avgRecall, avgPrecision, avgDrift, avgCcs, avgIsc);
+    const timestamps = snapshots.map((s) => s.timestamp);
+    const metrics = {
+        score,
+        sessionCount: snapshots.length,
+        avgRecall,
+        avgPrecision,
+        avgDrift,
+        avgCcs,
+        avgIsc,
+        trend,
+        weakAreas,
+        computedAt: new Date(now).toISOString(),
+        rangeStartMs: Math.min(...timestamps),
+        rangeEndMs: Math.max(...timestamps),
+    };
+    persistMetrics(repoRoot, metrics);
+    return metrics;
+}
+/**
+ * Identify weak areas where individual factor scores fall below the threshold.
+ */
+export function identifyWeakAreas(recall, precision, drift, ccs, isc) {
+    const areas = [];
+    if (recall < WEAK_THRESHOLD) {
+        areas.push({
+            area: 'recall',
+            description: 'Bundle recall is low — agents are reading files outside the bundle',
+            score: recall,
+        });
+    }
+    if (precision < WEAK_THRESHOLD) {
+        areas.push({
+            area: 'precision',
+            description: 'Bundle precision is low — bundles include files agents don\'t need',
+            score: precision,
+        });
+    }
+    if (drift > 1 - WEAK_THRESHOLD) {
+        areas.push({
+            area: 'drift',
+            description: 'Intent drift is high — tasks are diverging from their original scope',
+            score: 1 - drift,
+        });
+    }
+    if (ccs < WEAK_THRESHOLD) {
+        areas.push({
+            area: 'context_confidence',
+            description: 'Context confidence is low — bundles may be missing critical files',
+            score: ccs,
+        });
+    }
+    if (isc < WEAK_THRESHOLD) {
+        areas.push({
+            area: 'intent_sufficiency',
+            description: 'Task prompts are underspecified — agents start with ambiguous instructions',
+            score: isc,
+        });
+    }
+    return areas.sort((a, b) => a.score - b.score);
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function computeComposite(recall, precision, drift, ccs, isc) {
+    // Drift is inverted: lower drift = higher contribution
+    return (W_RECALL * recall +
+        W_PRECISION * precision +
+        W_CCS * ccs +
+        W_ISC * isc +
+        W_DRIFT * (1 - drift));
+}
+function avg(values) {
+    if (values.length === 0)
+        return 0;
+    return values.reduce((sum, v) => sum + v, 0) / values.length;
+}
+function persistMetrics(repoRoot, metrics) {
+    const path = join(repoRoot, '.codeledger', TEAM_METRICS_FILE);
+    writeFileSync(path, JSON.stringify(metrics, null, 2), 'utf-8');
+}
+//# sourceMappingURL=metrics.js.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * Team Context Policy System
+ *
+ * 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';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/team-policy/index.js

@@ -0,0 +1,8 @@
+/**
+ * Team Context Policy System
+ *
+ * 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';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,35 @@
+/**
+ * Team Context Policy — Implementation
+ *
+ * Config: codeledger.team-policy.json at repo root or .codeledger/team-policy.json
+ *
+ * Enforcement during context build:
+ * - Ensure required files are present in the bundle
+ * - If missing: boost score (soft) or fail validation (hard)
+ *
+ * Integration points:
+ * - SCE (slice builder) — boost missing required files
+ * - CCS (score) — penalty if required files missing
+ * - context validate — block if enforcement is 'block'
+ */
+import type { TeamPolicyConfig, TeamPolicyRule, TeamPolicyEvaluation } from '@codeledger/types';
+export declare const DEFAULT_TEAM_POLICY: TeamPolicyConfig;
+/**
+ * Load team policy from the repo root.
+ * Searches for codeledger.team-policy.json and .codeledger/team-policy.json.
+ * Returns default (disabled) policy if not found.
+ */
+export declare function loadTeamPolicy(repoRoot: string): TeamPolicyConfig;
+/**
+ * Find which policy rules are triggered by a given task description.
+ * Matches trigger keywords against the task (case-insensitive).
+ */
+export declare function matchTriggeredRules(policy: TeamPolicyConfig, task: string): TeamPolicyRule[];
+/**
+ * Evaluate team policy against a context bundle.
+ *
+ * For each triggered rule, checks whether all requiredFiles are present
+ * in the bundle's file list. Returns pass/fail with details.
+ */
+export declare function evaluateTeamPolicy(policy: TeamPolicyConfig, task: string, bundleFiles: string[]): TeamPolicyEvaluation;
+//# sourceMappingURL=policy.d.ts.map

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

@@ -0,0 +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"}

package/dist/team-policy/policy.js

@@ -0,0 +1,100 @@
+/**
+ * Team Context Policy — Implementation
+ *
+ * Config: codeledger.team-policy.json at repo root or .codeledger/team-policy.json
+ *
+ * Enforcement during context build:
+ * - Ensure required files are present in the bundle
+ * - If missing: boost score (soft) or fail validation (hard)
+ *
+ * Integration points:
+ * - SCE (slice builder) — boost missing required files
+ * - CCS (score) — penalty if required files missing
+ * - context validate — block if enforcement is 'block'
+ */
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+// ─── Constants ────────────────────────────────────────────────────────────────
+export const DEFAULT_TEAM_POLICY = {
+    version: 1,
+    enabled: false,
+    rules: [],
+};
+const POLICY_FILENAMES = [
+    'codeledger.team-policy.json',
+    '.codeledger/team-policy.json',
+];
+// ─── Public API ───────────────────────────────────────────────────────────────
+/**
+ * Load team policy from the repo root.
+ * Searches for codeledger.team-policy.json and .codeledger/team-policy.json.
+ * Returns default (disabled) policy if not found.
+ */
+export function loadTeamPolicy(repoRoot) {
+    for (const filename of POLICY_FILENAMES) {
+        const path = join(repoRoot, filename);
+        if (existsSync(path)) {
+            try {
+                const raw = JSON.parse(readFileSync(path, 'utf-8'));
+                return { ...DEFAULT_TEAM_POLICY, ...raw };
+            }
+            catch {
+                // Malformed policy — return default
+                return DEFAULT_TEAM_POLICY;
+            }
+        }
+    }
+    return DEFAULT_TEAM_POLICY;
+}
+/**
+ * Find which policy rules are triggered by a given task description.
+ * Matches trigger keywords against the task (case-insensitive).
+ */
+export function matchTriggeredRules(policy, task) {
+    if (!policy.enabled || policy.rules.length === 0)
+        return [];
+    const taskLower = task.toLowerCase();
+    return policy.rules.filter((rule) => rule.triggerKeywords.some((kw) => taskLower.includes(kw.toLowerCase())));
+}
+/**
+ * Evaluate team policy against a context bundle.
+ *
+ * For each triggered rule, checks whether all requiredFiles are present
+ * in the bundle's file list. Returns pass/fail with details.
+ */
+export function evaluateTeamPolicy(policy, task, bundleFiles) {
+    const triggered = matchTriggeredRules(policy, task);
+    if (triggered.length === 0) {
+        return {
+            passed: true,
+            triggeredRules: [],
+            satisfiedRules: [],
+            violatedRules: [],
+        };
+    }
+    const bundleSet = new Set(bundleFiles);
+    const satisfied = [];
+    const violated = [];
+    for (const rule of triggered) {
+        const missing = rule.requiredFiles.filter((f) => !bundleSet.has(f));
+        if (missing.length === 0) {
+            satisfied.push(rule.name);
+        }
+        else {
+            violated.push({
+                rule: rule.name,
+                missingFiles: missing,
+                enforcement: rule.enforcement,
+            });
+        }
+    }
+    // Passed only if no 'block' violations exist
+    const hasBlockViolation = violated.some((v) => v.enforcement === 'block');
+    return {
+        passed: !hasBlockViolation,
+        triggeredRules: triggered.map((r) => r.name),
+        satisfiedRules: satisfied,
+        violatedRules: violated,
+    };
+}
+//# sourceMappingURL=policy.js.map

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

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

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@codeledger/engine",
+  "version": "0.7.0",
+  "type": "module",
+  "description": "Deterministic Context Orchestration Layer (DCOL) — SCE and IOLE subsystems for CodeLedger v2",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/codeledgerECF/codeledger.git",
+    "directory": "packages/engine"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./sce": {
+      "types": "./dist/sce/index.d.ts",
+      "import": "./dist/sce/index.js"
+    },
+    "./iole": {
+      "types": "./dist/iole/index.d.ts",
+      "import": "./dist/iole/index.js"
+    },
+    "./license": {
+      "types": "./dist/license/index.d.ts",
+      "import": "./dist/license/index.js"
+    }
+  },
+  "dependencies": {
+    "@codeledger/types": "0.7.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}