@devflow-tools/database 0.16.11 → 0.16.13

package/dist/index.d.ts

@@ -1,3 +1,5 @@
 export { DevFlowDatabase, getGlobalDevFlowDbPath, openGlobalDevFlowDatabase, } from './database';
-export type { BenchmarkReportMetaRecord, BenchmarkReportRecord, FeedbackRecord, GovernanceAuditRecord, GovernanceRuleRecord, HookFallbackRecord, HookReceiptRecord, MemoryDistillCheckpointRecord, MemoryTurnRecord, MemoryTurnStatus, TelemetryFailureRecord, } from './database';
+export type { BenchmarkReportMetaRecord, BenchmarkReportRecord, FeedbackRecord, GovernanceAuditRecord, GovernanceRuleRecord, HookFallbackRecord, HookReceiptRecord, ContextReceiptRecord, ContextSelectionEventRecord, MemoryDistillCheckpointRecord, MemoryTurnRecord, MemoryTurnStatus, TelemetryFailureRecord, } from './database';
 export type { EnqueueWorkInput, LeaseWorkInput, RequestSessionClosureInput, SessionClosureRecord, SessionClosureState, WorkError, WorkItemRecord, WorkKind, WorkQueueHealth, WorkState, } from './work-queue';
+export { mapSessionObligationRow, normalizeTurnId, } from './obligation-ledger';
+export type { SessionObligationKind, SessionObligationRecord, SessionObligationState, } from './obligation-ledger';

package/dist/index.js

@@ -1,7 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.openGlobalDevFlowDatabase = exports.getGlobalDevFlowDbPath = exports.DevFlowDatabase = void 0;
+exports.normalizeTurnId = exports.mapSessionObligationRow = exports.openGlobalDevFlowDatabase = exports.getGlobalDevFlowDbPath = exports.DevFlowDatabase = void 0;
 var database_1 = require("./database");
 Object.defineProperty(exports, "DevFlowDatabase", { enumerable: true, get: function () { return database_1.DevFlowDatabase; } });
 Object.defineProperty(exports, "getGlobalDevFlowDbPath", { enumerable: true, get: function () { return database_1.getGlobalDevFlowDbPath; } });
 Object.defineProperty(exports, "openGlobalDevFlowDatabase", { enumerable: true, get: function () { return database_1.openGlobalDevFlowDatabase; } });
+var obligation_ledger_1 = require("./obligation-ledger");
+Object.defineProperty(exports, "mapSessionObligationRow", { enumerable: true, get: function () { return obligation_ledger_1.mapSessionObligationRow; } });
+Object.defineProperty(exports, "normalizeTurnId", { enumerable: true, get: function () { return obligation_ledger_1.normalizeTurnId; } });

package/dist/node-sqlite.js

@@ -1,11 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NodeSqliteDatabase = void 0;
-// node:sqlite is a Node.js 22+ experimental built-in. TypeScript does not
-// resolve `node:` prefixed modules unless @types/node includes them (which
-// requires @types/node >= 22.5). We suppress the TS error here and rely on
-// the ambient types defined below until the project upgrades @types/node.
-// @ts-expect-error - node:sqlite types not available in @types/node@20
 const node_sqlite_1 = require("node:sqlite");
 class NodeSqliteDatabase {
     constructor(path, busyTimeoutMs = 10000) {
@@ -23,7 +18,7 @@ class NodeSqliteDatabase {
             run: (...params) => {
                 const result = stmt.run(...normalizeParams(params));
                 return {
-                    changes: result.changes,
+                    changes: Number(result.changes),
                     lastInsertRowid: result.lastInsertRowid,
                 };
             },

package/dist/obligation-ledger.d.ts

@@ -0,0 +1,19 @@
+export type SessionObligationKind = 'memory_decision' | 'evidence_contract' | 'session_finalize';
+export type SessionObligationState = 'open' | 'satisfied' | 'degraded' | 'cancelled';
+export interface SessionObligationRecord {
+    obligationId: string;
+    projectRoot: string;
+    sessionId: string;
+    executionId?: string;
+    turnId?: string;
+    kind: SessionObligationKind;
+    state: SessionObligationState;
+    payload: Record<string, unknown>;
+    receiptId?: string;
+    reason?: string;
+    createdAt: number;
+    updatedAt: number;
+    resolvedAt?: number;
+}
+export declare function normalizeTurnId(value: string): string;
+export declare function mapSessionObligationRow(row: Record<string, unknown>): SessionObligationRecord;

package/dist/obligation-ledger.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeTurnId = normalizeTurnId;
+exports.mapSessionObligationRow = mapSessionObligationRow;
+function normalizeTurnId(value) {
+    const trimmed = value.trim();
+    if (!trimmed)
+        throw new Error('Memory turn ID is required');
+    return trimmed.startsWith('turn:') ? trimmed : `turn:${trimmed}`;
+}
+function mapSessionObligationRow(row) {
+    let payload = {};
+    try {
+        const parsed = JSON.parse(String(row.payload ?? '{}'));
+        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            payload = parsed;
+        }
+    }
+    catch { }
+    return {
+        obligationId: String(row.obligation_id),
+        projectRoot: String(row.project_root),
+        sessionId: String(row.session_id),
+        executionId: typeof row.execution_id === 'string' ? row.execution_id : undefined,
+        turnId: typeof row.turn_id === 'string' ? row.turn_id : undefined,
+        kind: row.kind,
+        state: row.state,
+        payload,
+        receiptId: typeof row.receipt_id === 'string' ? row.receipt_id : undefined,
+        reason: typeof row.reason === 'string' ? row.reason : undefined,
+        createdAt: Number(row.created_at),
+        updatedAt: Number(row.updated_at),
+        resolvedAt: typeof row.resolved_at === 'number' ? row.resolved_at : undefined,
+    };
+}

package/dist/work-queue.d.ts

@@ -1,4 +1,4 @@
-export type WorkKind = 'memory.explicit_commit' | 'memory.turn_capture' | 'memory.turn_distill' | 'memory.vector_backfill' | 'session.bootstrap' | 'session.finalize' | 'telemetry.reconcile';
+export type WorkKind = 'memory.explicit_commit' | 'memory.explicit_enrichment' | 'memory.turn_capture' | 'memory.turn_distill' | 'memory.vector_backfill' | 'session.bootstrap' | 'session.finalize' | 'telemetry.reconcile';
 export type WorkState = 'pending' | 'leased' | 'completed' | 'failed' | 'dead_letter';
 export interface WorkError {
     category: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devflow-tools/database",
-  "version": "0.16.11",
+  "version": "0.16.13",
   "description": "DevFlow SQLite database package",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -9,9 +9,9 @@
     "test": "vitest run"
   },
   "devDependencies": {
-    "@types/node": "^20.0.0",
+    "@types/node": "^22.15.0",
     "typescript": "^5.5.0",
     "vitest": "^2.0.0"
   },
-  "gitHead": "d580af1e"
+  "gitHead": "67c9dfc3709bd0ce36b7c2a9341896eedcc8a725"
 }