@codeledger/core 0.1.1

package/LICENSE

@@ -0,0 +1,27 @@
+MIT License
+
+Copyright (c) 2025 Intelligent Context AI, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+Note: This license applies to the CLI wrapper, types, repository scanning,
+instrumentation, harness, and report packages (the "Plugin"). The scoring
+engine (packages/core-engine/bin/) is licensed separately under LICENSE-CORE.

package/dist/bundle-store.d.ts

@@ -0,0 +1,10 @@
+import Database from 'better-sqlite3';
+import type { BundleRecord, ContextBundle } from '@codeledger/types';
+export declare class BundleStore {
+    private db;
+    constructor(db: Database.Database);
+    store(bundle: ContextBundle, runId?: string): void;
+    retrieve(bundleId: string): ContextBundle | null;
+    listByRun(runId: string): BundleRecord[];
+}
+//# sourceMappingURL=bundle-store.d.ts.map

package/dist/bundle-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-store.d.ts","sourceRoot":"","sources":["../src/bundle-store.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAErE,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAAoB;gBAElB,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAIjC,KAAK,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAmBlD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAShD,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE;CAkBzC"}

package/dist/bundle-store.js

@@ -0,0 +1,36 @@
+export class BundleStore {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    store(bundle, runId) {
+        const stmt = this.db.prepare(`INSERT INTO bundles (bundle_id, run_id, task, budget_tokens, budget_max_files,
+       sufficiency_threshold, cumulative_score, file_count, bundle_json)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`);
+        stmt.run(bundle.bundle_id, runId ?? null, bundle.task, bundle.budget.tokens ?? null, bundle.budget.max_files ?? null, bundle.sufficiency_threshold, bundle.cumulative_score, bundle.files.length, JSON.stringify(bundle));
+    }
+    retrieve(bundleId) {
+        const stmt = this.db.prepare(`SELECT bundle_json FROM bundles WHERE bundle_id = ?`);
+        const row = stmt.get(bundleId);
+        if (!row)
+            return null;
+        return JSON.parse(row.bundle_json);
+    }
+    listByRun(runId) {
+        const stmt = this.db.prepare(`SELECT * FROM bundles WHERE run_id = ? ORDER BY created_at`);
+        const rows = stmt.all(runId);
+        return rows.map((r) => ({
+            bundle_id: r['bundle_id'],
+            run_id: r['run_id'] ?? null,
+            task: r['task'],
+            budget_tokens: r['budget_tokens'] ?? null,
+            budget_max_files: r['budget_max_files'] ?? null,
+            sufficiency_threshold: r['sufficiency_threshold'] ?? null,
+            cumulative_score: r['cumulative_score'] ?? null,
+            file_count: r['file_count'] ?? null,
+            bundle_json: r['bundle_json'],
+            created_at: r['created_at'],
+        }));
+    }
+}
+//# sourceMappingURL=bundle-store.js.map

package/dist/bundle-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-store.js","sourceRoot":"","sources":["../src/bundle-store.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,WAAW;IACd,EAAE,CAAoB;IAE9B,YAAY,EAAqB;QAC/B,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC;IAED,KAAK,CAAC,MAAqB,EAAE,KAAc;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAC1B;;0CAEoC,CACrC,CAAC;QACF,IAAI,CAAC,GAAG,CACN,MAAM,CAAC,SAAS,EAChB,KAAK,IAAI,IAAI,EACb,MAAM,CAAC,IAAI,EACX,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,EAC5B,MAAM,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI,EAC/B,MAAM,CAAC,qBAAqB,EAC5B,MAAM,CAAC,gBAAgB,EACvB,MAAM,CAAC,KAAK,CAAC,MAAM,EACnB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CACvB,CAAC;IACJ,CAAC;IAED,QAAQ,CAAC,QAAgB;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAC1B,qDAAqD,CACtD,CAAC;QACF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAwC,CAAC;QACtE,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAkB,CAAC;IACtD,CAAC;IAED,SAAS,CAAC,KAAa;QACrB,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAC1B,4DAA4D,CAC7D,CAAC;QACF,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAmC,CAAC;QAC/D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACtB,SAAS,EAAE,CAAC,CAAC,WAAW,CAAW;YACnC,MAAM,EAAG,CAAC,CAAC,QAAQ,CAAY,IAAI,IAAI;YACvC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAW;YACzB,aAAa,EAAG,CAAC,CAAC,eAAe,CAAY,IAAI,IAAI;YACrD,gBAAgB,EAAG,CAAC,CAAC,kBAAkB,CAAY,IAAI,IAAI;YAC3D,qBAAqB,EAAG,CAAC,CAAC,uBAAuB,CAAY,IAAI,IAAI;YACrE,gBAAgB,EAAG,CAAC,CAAC,kBAAkB,CAAY,IAAI,IAAI;YAC3D,UAAU,EAAG,CAAC,CAAC,YAAY,CAAY,IAAI,IAAI;YAC/C,WAAW,EAAE,CAAC,CAAC,aAAa,CAAW;YACvC,UAAU,EAAE,CAAC,CAAC,YAAY,CAAW;SACtC,CAAC,CAAC,CAAC;IACN,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { LedgerStore } from './ledger.js';
+export { BundleStore } from './bundle-store.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { LedgerStore } from './ledger.js';
+export { BundleStore } from './bundle-store.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/ledger.d.ts

@@ -0,0 +1,14 @@
+import type { LedgerEvent, RunIdentity, RunRecord, RunStatus } from '@codeledger/types';
+export declare class LedgerStore {
+    private db;
+    constructor(dbPath: string);
+    init(): void;
+    append(event: LedgerEvent): void;
+    appendMany(events: LedgerEvent[]): void;
+    startRun(run: RunIdentity): void;
+    finishRun(runId: string, status: RunStatus, summary?: unknown): void;
+    listRunEvents(runId: string): LedgerEvent[];
+    listScenarioRuns(scenarioId: string): RunRecord[];
+    close(): void;
+}
+//# sourceMappingURL=ledger.d.ts.map

package/dist/ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.d.ts","sourceRoot":"","sources":["../src/ledger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,SAAS,EACT,SAAS,EAEV,MAAM,mBAAmB,CAAC;AA2C3B,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAAoB;gBAElB,MAAM,EAAE,MAAM;IAM1B,IAAI,IAAI,IAAI;IAIZ,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAchC,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI;IAavC,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAiBhC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI;IAQpE,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE;IAoB3C,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE;IAoBjD,KAAK,IAAI,IAAI;CAGd"}

package/dist/ledger.js

@@ -0,0 +1,109 @@
+import Database from 'better-sqlite3';
+const SCHEMA = `
+CREATE TABLE IF NOT EXISTS events (
+  event_id TEXT PRIMARY KEY,
+  run_id TEXT NOT NULL,
+  ts TEXT NOT NULL,
+  type TEXT NOT NULL,
+  payload TEXT NOT NULL,
+  created_at TEXT DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS runs (
+  run_id TEXT PRIMARY KEY,
+  scenario_id TEXT NOT NULL,
+  mode TEXT NOT NULL,
+  injection_mode TEXT,
+  repeat_num INTEGER NOT NULL,
+  agent TEXT,
+  git_ref TEXT,
+  started_at TEXT NOT NULL,
+  finished_at TEXT,
+  status TEXT DEFAULT 'running',
+  summary TEXT
+);
+
+CREATE TABLE IF NOT EXISTS bundles (
+  bundle_id TEXT PRIMARY KEY,
+  run_id TEXT,
+  task TEXT NOT NULL,
+  budget_tokens INTEGER,
+  budget_max_files INTEGER,
+  sufficiency_threshold REAL,
+  cumulative_score REAL,
+  file_count INTEGER,
+  bundle_json TEXT NOT NULL,
+  created_at TEXT DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_events_run ON events(run_id);
+CREATE INDEX IF NOT EXISTS idx_runs_scenario ON runs(scenario_id);
+`;
+export class LedgerStore {
+    db;
+    constructor(dbPath) {
+        this.db = new Database(dbPath);
+        this.db.pragma('journal_mode = WAL');
+        this.db.pragma('foreign_keys = ON');
+    }
+    init() {
+        this.db.exec(SCHEMA);
+    }
+    append(event) {
+        const stmt = this.db.prepare(`INSERT INTO events (event_id, run_id, ts, type, payload)
+       VALUES (?, ?, ?, ?, ?)`);
+        stmt.run(event.event_id, event.run_id, event.ts, event.type, JSON.stringify(event.payload));
+    }
+    appendMany(events) {
+        const stmt = this.db.prepare(`INSERT INTO events (event_id, run_id, ts, type, payload)
+       VALUES (?, ?, ?, ?, ?)`);
+        const tx = this.db.transaction((evts) => {
+            for (const e of evts) {
+                stmt.run(e.event_id, e.run_id, e.ts, e.type, JSON.stringify(e.payload));
+            }
+        });
+        tx(events);
+    }
+    startRun(run) {
+        const stmt = this.db.prepare(`INSERT INTO runs (run_id, scenario_id, mode, injection_mode, repeat_num, agent, git_ref, started_at, status)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, 'running')`);
+        stmt.run(run.run_id, run.scenario_id, run.mode, run.injection_mode, run.repeat_num, run.agent, run.git_ref, run.started_at);
+    }
+    finishRun(runId, status, summary) {
+        const now = new Date().toISOString();
+        const stmt = this.db.prepare(`UPDATE runs SET finished_at = ?, status = ?, summary = ? WHERE run_id = ?`);
+        stmt.run(now, status, summary ? JSON.stringify(summary) : null, runId);
+    }
+    listRunEvents(runId) {
+        const stmt = this.db.prepare(`SELECT event_id, run_id, ts, type, payload FROM events WHERE run_id = ? ORDER BY ts`);
+        const rows = stmt.all(runId);
+        return rows.map((r) => ({
+            event_id: r.event_id,
+            run_id: r.run_id,
+            ts: r.ts,
+            type: r.type,
+            payload: JSON.parse(r.payload),
+        }));
+    }
+    listScenarioRuns(scenarioId) {
+        const stmt = this.db.prepare(`SELECT * FROM runs WHERE scenario_id = ? ORDER BY started_at`);
+        const rows = stmt.all(scenarioId);
+        return rows.map((r) => ({
+            run_id: r['run_id'],
+            scenario_id: r['scenario_id'],
+            mode: r['mode'],
+            injection_mode: r['injection_mode'] ?? null,
+            repeat_num: r['repeat_num'],
+            agent: r['agent'] ?? null,
+            git_ref: r['git_ref'] ?? null,
+            started_at: r['started_at'],
+            finished_at: r['finished_at'] ?? null,
+            status: r['status'],
+            summary: r['summary'] ? JSON.parse(r['summary']) : null,
+        }));
+    }
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=ledger.js.map

package/dist/ledger.js.map

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

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@codeledger/core",
+  "version": "0.1.1",
+  "type": "module",
+  "description": "SQLite append-only ledger for CodeLedger events and runs",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/codeledgerECF/codeledger-blackbox.git",
+    "directory": "packages/core"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "better-sqlite3": "^11.0.0",
+    "@codeledger/types": "0.1.1"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.0",
+    "typescript": "^5.4.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}