@juli-os/ledger 0.2.0 → 0.3.1

package/dist/index.d.ts

@@ -4,5 +4,3 @@ export { TERMINAL_WORKFLOW_STATUSES, STEP_KINDS, AGENT_STEP_KINDS, INSTRUCTABLE_
 export { createUsageStore, type UsageRecord, type UsageStats, type TimelinePoint, type UsageStore, } from './platform/ledger/usage.ts';
 export { findPrice, priceUsage, type TierWhen, type PriceTier, type ModelPrice, PRICING_SOURCE, PRICING_RETRIEVED_AT, BIGMODEL_PRICES, type UsageRow, type CostBreakdown, type ModelUsageCost, type UsageCost, } from './platform/ledger/pricing.ts';
 export { emptyCaseFile, parseCaseFile, serializeCaseFile, withOriginal, appendSection, appendExecution, appendDecision, appendReference, originalEmail, type CaseDecision, type ArtifactRef, type CaseFileDoc, } from './platform/ledger/casefile.ts';
-export { rfc3339, systemClock, randomIds, type Clock, type IdGen } from './platform/shared/clock.ts';
-export { asRecord, safeParse, type JsonRecord, type JsonValue } from './platform/shared/json.ts';

package/dist/index.js

@@ -1,5 +1,65 @@
-// src/platform/ledger/store.ts
+// node_modules/@juli-os/basin/dist/index.js
 import { DatabaseSync } from "node:sqlite";
+var openDatabase = (path) => new DatabaseSync(path);
+var currentVersion = (db) => {
+  const row = db.prepare("PRAGMA user_version").get();
+  return Number(row?.["user_version"] ?? 0);
+};
+var writeVersion = (db, version) => {
+  db.exec(`PRAGMA user_version = ${Math.floor(version)}`);
+};
+var validateMigrations = (migrations) => {
+  let prev = 0;
+  for (const m of migrations) {
+    if (!Number.isInteger(m.version) || m.version < 1) {
+      throw new Error(`\u8FC1\u79FB\u7248\u672C\u5FC5\u987B\u662F >=1 \u7684\u6574\u6570\uFF0C\u6536\u5230 ${m.version}\uFF08${m.name}\uFF09`);
+    }
+    if (m.version <= prev) {
+      throw new Error(`\u8FC1\u79FB\u7248\u672C\u5FC5\u987B\u4E25\u683C\u9012\u589E\uFF1Av${m.version}\uFF08${m.name}\uFF09\u8DDF\u5728 v${prev} \u4E4B\u540E`);
+    }
+    prev = m.version;
+  }
+};
+var defineMigration = (version, name, up) => {
+  if (!Number.isInteger(version) || version < 1) {
+    throw new Error(`\u8FC1\u79FB\u7248\u672C\u5FC5\u987B\u662F >=1 \u7684\u6574\u6570\uFF0C\u6536\u5230 ${version}\uFF08${name}\uFF09`);
+  }
+  return { version, name, up };
+};
+var sqlMigration = (version, name, script) => defineMigration(version, name, (db) => {
+  db.exec(script);
+});
+var migrate = (db, migrations) => {
+  validateMigrations(migrations);
+  const from = currentVersion(db);
+  const applied = [];
+  for (const m of migrations) {
+    if (m.version <= from) continue;
+    db.exec("BEGIN IMMEDIATE");
+    try {
+      m.up(db);
+      writeVersion(db, m.version);
+      db.exec("COMMIT");
+      applied.push({ version: m.version, name: m.name });
+    } catch (e) {
+      db.exec("ROLLBACK");
+      throw new Error(`\u8FC1\u79FB v${m.version}\uFF08${m.name}\uFF09\u5931\u8D25\uFF0C\u5DF2\u56DE\u6EDA\uFF1A${e instanceof Error ? e.message : String(e)}`);
+    }
+  }
+  return { from, to: currentVersion(db), applied };
+};
+var tableColumns = (db, table) => {
+  if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(table)) {
+    throw new Error(`\u8868\u540D\u53EA\u5141\u8BB8\u5B57\u6BCD\u6570\u5B57\u4E0B\u5212\u7EBF\uFF0C\u6536\u5230 ${table}`);
+  }
+  const rows = db.prepare(`PRAGMA table_info(${table})`).all();
+  return rows.map((r) => String(r["name"]));
+};
+var addColumnIfMissing = (db, table, column, ddl) => {
+  if (tableColumns(db, table).includes(column)) return false;
+  db.exec(`ALTER TABLE ${table} ADD COLUMN ${ddl}`);
+  return true;
+};
 
 // src/platform/shared/json.ts
 var safeParse = (raw) => {
@@ -222,6 +282,18 @@ CREATE TABLE IF NOT EXISTS relays (
 CREATE INDEX IF NOT EXISTS idx_events_entity ON events(entity_type, entity_id);
 CREATE INDEX IF NOT EXISTS idx_runs_session ON runs(session, status);
 `;
+var STORE_MIGRATIONS = [
+  sqlMigration(1, "create lifecycle tables", MIGRATIONS),
+  defineMigration(2, "owner/thread/tenant columns + indexes + step timing", (db) => {
+    addColumnIfMissing(db, "workflows", "owner", "owner TEXT");
+    addColumnIfMissing(db, "workflows", "thread_id", "thread_id TEXT");
+    addColumnIfMissing(db, "workflows", "tenant", "tenant TEXT NOT NULL DEFAULT 'internal'");
+    db.exec("CREATE INDEX IF NOT EXISTS idx_workflows_thread ON workflows(thread_id)");
+    db.exec("CREATE INDEX IF NOT EXISTS idx_workflows_tenant ON workflows(tenant, created_at)");
+    addColumnIfMissing(db, "workflow_steps", "started_at", "started_at TEXT");
+    addColumnIfMissing(db, "workflow_steps", "completed_at", "completed_at TEXT");
+  })
+];
 var str = (v) => typeof v === "string" ? v : v === null || v === void 0 ? "" : String(v);
 var num = (v) => typeof v === "number" ? v : Number(v ?? 0);
 var jsonFieldPattern = (field, value) => {
@@ -299,23 +371,8 @@ var STEP_COLS = `id, workflow_id, seq, kind, title, status, COALESCE(input,'') A
 var createLedgerStore = (dbPath, deps = {}) => {
   const clock = deps.clock ?? systemClock;
   const ids = deps.ids ?? randomIds;
-  const db = new DatabaseSync(dbPath);
-  db.exec(MIGRATIONS);
-  const wfCols = db.prepare("PRAGMA table_info(workflows)").all().map((c) => c.name);
-  if (!wfCols.includes("owner")) {
-    db.exec("ALTER TABLE workflows ADD COLUMN owner TEXT");
-  }
-  if (!wfCols.includes("thread_id")) {
-    db.exec("ALTER TABLE workflows ADD COLUMN thread_id TEXT");
-  }
-  if (!wfCols.includes("tenant")) {
-    db.exec("ALTER TABLE workflows ADD COLUMN tenant TEXT NOT NULL DEFAULT 'internal'");
-  }
-  db.exec("CREATE INDEX IF NOT EXISTS idx_workflows_thread ON workflows(thread_id)");
-  db.exec("CREATE INDEX IF NOT EXISTS idx_workflows_tenant ON workflows(tenant, created_at)");
-  const stepCols = db.prepare("PRAGMA table_info(workflow_steps)").all().map((c) => c.name);
-  if (!stepCols.includes("started_at")) db.exec("ALTER TABLE workflow_steps ADD COLUMN started_at TEXT");
-  if (!stepCols.includes("completed_at")) db.exec("ALTER TABLE workflow_steps ADD COLUMN completed_at TEXT");
+  const db = openDatabase(dbPath);
+  migrate(db, STORE_MIGRATIONS);
   const now = () => rfc3339(clock.now());
   const mergeStepJson = (id, col, patch) => {
     const row = db.prepare(`SELECT COALESCE(${col},'{}') AS v FROM workflow_steps WHERE id=?`).get(id);
@@ -770,7 +827,6 @@ var createLedgerStore = (dbPath, deps = {}) => {
 };
 
 // src/platform/ledger/usage.ts
-import { DatabaseSync as DatabaseSync2 } from "node:sqlite";
 import { readdirSync, openSync, readSync, fstatSync, closeSync } from "node:fs";
 import { join } from "node:path";
 
@@ -1017,6 +1073,14 @@ CREATE TABLE IF NOT EXISTS usage_meta (
   value TEXT NOT NULL DEFAULT ''
 );
 `;
+var USAGE_MIGRATIONS = [
+  sqlMigration(1, "create usage tables", MIGRATIONS2),
+  defineMigration(2, "cached_tokens/tmux_session columns + session index", (db) => {
+    addColumnIfMissing(db, "prompt_usage", "cached_tokens", "cached_tokens INTEGER NOT NULL DEFAULT 0");
+    addColumnIfMissing(db, "prompt_usage", "tmux_session", "tmux_session TEXT NOT NULL DEFAULT ''");
+    db.exec("CREATE INDEX IF NOT EXISTS idx_usage_session ON prompt_usage(tmux_session, id)");
+  })
+];
 var n = (v) => typeof v === "number" ? v : Number(v ?? 0);
 var windowConds = (tmuxSession, windows) => {
   const conds = windows.map(() => "(created_at >= ? AND created_at <= ?)").join(" OR ");
@@ -1039,20 +1103,8 @@ var windowUsageRows = (db, tmuxSession, windows) => {
 };
 var REPLAY_COOLDOWN_MS = 24 * 36e5;
 var createUsageStore = (dbPath, now = () => /* @__PURE__ */ new Date()) => {
-  const db = new DatabaseSync2(dbPath);
-  db.exec(MIGRATIONS2);
-  try {
-    db.exec("ALTER TABLE prompt_usage ADD COLUMN cached_tokens INTEGER NOT NULL DEFAULT 0");
-  } catch {
-  }
-  try {
-    db.exec(`ALTER TABLE prompt_usage ADD COLUMN tmux_session TEXT NOT NULL DEFAULT ''`);
-  } catch {
-  }
-  try {
-    db.exec(`CREATE INDEX IF NOT EXISTS idx_usage_session ON prompt_usage(tmux_session, id)`);
-  } catch {
-  }
+  const db = openDatabase(dbPath);
+  migrate(db, USAGE_MIGRATIONS);
   return {
     record(r) {
       db.prepare(`INSERT INTO prompt_usage (source, note, model, input_tokens, output_tokens, cached_tokens, duration_ms, error, created_at)
@@ -1323,7 +1375,6 @@ export {
   appendExecution,
   appendReference,
   appendSection,
-  asRecord,
   createLedgerStore,
   createUsageStore,
   emptyCaseFile,
@@ -1331,10 +1382,6 @@ export {
   originalEmail,
   parseCaseFile,
   priceUsage,
-  randomIds,
-  rfc3339,
-  safeParse,
   serializeCaseFile,
-  systemClock,
   withOriginal
 };

package/dist/juli-ledger.js

@@ -4,8 +4,68 @@
 import { join as join2 } from "node:path";
 import { mkdirSync } from "node:fs";
 
-// src/platform/ledger/store.ts
+// node_modules/@juli-os/basin/dist/index.js
 import { DatabaseSync } from "node:sqlite";
+var openDatabase = (path) => new DatabaseSync(path);
+var currentVersion = (db) => {
+  const row = db.prepare("PRAGMA user_version").get();
+  return Number(row?.["user_version"] ?? 0);
+};
+var writeVersion = (db, version) => {
+  db.exec(`PRAGMA user_version = ${Math.floor(version)}`);
+};
+var validateMigrations = (migrations) => {
+  let prev = 0;
+  for (const m of migrations) {
+    if (!Number.isInteger(m.version) || m.version < 1) {
+      throw new Error(`\u8FC1\u79FB\u7248\u672C\u5FC5\u987B\u662F >=1 \u7684\u6574\u6570\uFF0C\u6536\u5230 ${m.version}\uFF08${m.name}\uFF09`);
+    }
+    if (m.version <= prev) {
+      throw new Error(`\u8FC1\u79FB\u7248\u672C\u5FC5\u987B\u4E25\u683C\u9012\u589E\uFF1Av${m.version}\uFF08${m.name}\uFF09\u8DDF\u5728 v${prev} \u4E4B\u540E`);
+    }
+    prev = m.version;
+  }
+};
+var defineMigration = (version, name, up) => {
+  if (!Number.isInteger(version) || version < 1) {
+    throw new Error(`\u8FC1\u79FB\u7248\u672C\u5FC5\u987B\u662F >=1 \u7684\u6574\u6570\uFF0C\u6536\u5230 ${version}\uFF08${name}\uFF09`);
+  }
+  return { version, name, up };
+};
+var sqlMigration = (version, name, script) => defineMigration(version, name, (db) => {
+  db.exec(script);
+});
+var migrate = (db, migrations) => {
+  validateMigrations(migrations);
+  const from = currentVersion(db);
+  const applied = [];
+  for (const m of migrations) {
+    if (m.version <= from) continue;
+    db.exec("BEGIN IMMEDIATE");
+    try {
+      m.up(db);
+      writeVersion(db, m.version);
+      db.exec("COMMIT");
+      applied.push({ version: m.version, name: m.name });
+    } catch (e) {
+      db.exec("ROLLBACK");
+      throw new Error(`\u8FC1\u79FB v${m.version}\uFF08${m.name}\uFF09\u5931\u8D25\uFF0C\u5DF2\u56DE\u6EDA\uFF1A${e instanceof Error ? e.message : String(e)}`);
+    }
+  }
+  return { from, to: currentVersion(db), applied };
+};
+var tableColumns = (db, table) => {
+  if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(table)) {
+    throw new Error(`\u8868\u540D\u53EA\u5141\u8BB8\u5B57\u6BCD\u6570\u5B57\u4E0B\u5212\u7EBF\uFF0C\u6536\u5230 ${table}`);
+  }
+  const rows = db.prepare(`PRAGMA table_info(${table})`).all();
+  return rows.map((r) => String(r["name"]));
+};
+var addColumnIfMissing = (db, table, column, ddl) => {
+  if (tableColumns(db, table).includes(column)) return false;
+  db.exec(`ALTER TABLE ${table} ADD COLUMN ${ddl}`);
+  return true;
+};
 
 // src/platform/shared/json.ts
 var safeParse = (raw) => {
@@ -180,6 +240,18 @@ CREATE TABLE IF NOT EXISTS relays (
 CREATE INDEX IF NOT EXISTS idx_events_entity ON events(entity_type, entity_id);
 CREATE INDEX IF NOT EXISTS idx_runs_session ON runs(session, status);
 `;
+var STORE_MIGRATIONS = [
+  sqlMigration(1, "create lifecycle tables", MIGRATIONS),
+  defineMigration(2, "owner/thread/tenant columns + indexes + step timing", (db) => {
+    addColumnIfMissing(db, "workflows", "owner", "owner TEXT");
+    addColumnIfMissing(db, "workflows", "thread_id", "thread_id TEXT");
+    addColumnIfMissing(db, "workflows", "tenant", "tenant TEXT NOT NULL DEFAULT 'internal'");
+    db.exec("CREATE INDEX IF NOT EXISTS idx_workflows_thread ON workflows(thread_id)");
+    db.exec("CREATE INDEX IF NOT EXISTS idx_workflows_tenant ON workflows(tenant, created_at)");
+    addColumnIfMissing(db, "workflow_steps", "started_at", "started_at TEXT");
+    addColumnIfMissing(db, "workflow_steps", "completed_at", "completed_at TEXT");
+  })
+];
 var str = (v) => typeof v === "string" ? v : v === null || v === void 0 ? "" : String(v);
 var num = (v) => typeof v === "number" ? v : Number(v ?? 0);
 var jsonFieldPattern = (field, value) => {
@@ -257,23 +329,8 @@ var STEP_COLS = `id, workflow_id, seq, kind, title, status, COALESCE(input,'') A
 var createLedgerStore = (dbPath, deps = {}) => {
   const clock = deps.clock ?? systemClock;
   const ids = deps.ids ?? randomIds;
-  const db = new DatabaseSync(dbPath);
-  db.exec(MIGRATIONS);
-  const wfCols = db.prepare("PRAGMA table_info(workflows)").all().map((c) => c.name);
-  if (!wfCols.includes("owner")) {
-    db.exec("ALTER TABLE workflows ADD COLUMN owner TEXT");
-  }
-  if (!wfCols.includes("thread_id")) {
-    db.exec("ALTER TABLE workflows ADD COLUMN thread_id TEXT");
-  }
-  if (!wfCols.includes("tenant")) {
-    db.exec("ALTER TABLE workflows ADD COLUMN tenant TEXT NOT NULL DEFAULT 'internal'");
-  }
-  db.exec("CREATE INDEX IF NOT EXISTS idx_workflows_thread ON workflows(thread_id)");
-  db.exec("CREATE INDEX IF NOT EXISTS idx_workflows_tenant ON workflows(tenant, created_at)");
-  const stepCols = db.prepare("PRAGMA table_info(workflow_steps)").all().map((c) => c.name);
-  if (!stepCols.includes("started_at")) db.exec("ALTER TABLE workflow_steps ADD COLUMN started_at TEXT");
-  if (!stepCols.includes("completed_at")) db.exec("ALTER TABLE workflow_steps ADD COLUMN completed_at TEXT");
+  const db = openDatabase(dbPath);
+  migrate(db, STORE_MIGRATIONS);
   const now = () => rfc3339(clock.now());
   const mergeStepJson = (id, col, patch) => {
     const row = db.prepare(`SELECT COALESCE(${col},'{}') AS v FROM workflow_steps WHERE id=?`).get(id);
@@ -728,7 +785,6 @@ var createLedgerStore = (dbPath, deps = {}) => {
 };
 
 // src/platform/ledger/usage.ts
-import { DatabaseSync as DatabaseSync2 } from "node:sqlite";
 import { readdirSync, openSync, readSync, fstatSync, closeSync } from "node:fs";
 import { join } from "node:path";
 
@@ -975,6 +1031,14 @@ CREATE TABLE IF NOT EXISTS usage_meta (
   value TEXT NOT NULL DEFAULT ''
 );
 `;
+var USAGE_MIGRATIONS = [
+  sqlMigration(1, "create usage tables", MIGRATIONS2),
+  defineMigration(2, "cached_tokens/tmux_session columns + session index", (db) => {
+    addColumnIfMissing(db, "prompt_usage", "cached_tokens", "cached_tokens INTEGER NOT NULL DEFAULT 0");
+    addColumnIfMissing(db, "prompt_usage", "tmux_session", "tmux_session TEXT NOT NULL DEFAULT ''");
+    db.exec("CREATE INDEX IF NOT EXISTS idx_usage_session ON prompt_usage(tmux_session, id)");
+  })
+];
 var n = (v) => typeof v === "number" ? v : Number(v ?? 0);
 var windowConds = (tmuxSession, windows) => {
   const conds = windows.map(() => "(created_at >= ? AND created_at <= ?)").join(" OR ");
@@ -997,20 +1061,8 @@ var windowUsageRows = (db, tmuxSession, windows) => {
 };
 var REPLAY_COOLDOWN_MS = 24 * 36e5;
 var createUsageStore = (dbPath, now = () => /* @__PURE__ */ new Date()) => {
-  const db = new DatabaseSync2(dbPath);
-  db.exec(MIGRATIONS2);
-  try {
-    db.exec("ALTER TABLE prompt_usage ADD COLUMN cached_tokens INTEGER NOT NULL DEFAULT 0");
-  } catch {
-  }
-  try {
-    db.exec(`ALTER TABLE prompt_usage ADD COLUMN tmux_session TEXT NOT NULL DEFAULT ''`);
-  } catch {
-  }
-  try {
-    db.exec(`CREATE INDEX IF NOT EXISTS idx_usage_session ON prompt_usage(tmux_session, id)`);
-  } catch {
-  }
+  const db = openDatabase(dbPath);
+  migrate(db, USAGE_MIGRATIONS);
   return {
     record(r) {
       db.prepare(`INSERT INTO prompt_usage (source, note, model, input_tokens, output_tokens, cached_tokens, duration_ms, error, created_at)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@juli-os/ledger",
-  "version": "0.2.0",
-  "description": "juli-os L1 layer: the ledger of record for agent work — workflows, steps, case files, and token usage in one zero-dependency SQLite layer.",
+  "version": "0.3.1",
+  "description": "juli-os L1 layer: the ledger of record for agent work — workflows, steps, case files, and token usage in one SQLite layer (schema via @juli-os/basin).",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -46,5 +46,8 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/juli-os/ledger.git"
+  },
+  "dependencies": {
+    "@juli-os/basin": "^0.1.0"
   }
-}
+}