@devflow-tools/database 0.17.1 → 0.17.3

package/dist/index.js

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.stableLearningJson = exports.mapLearningVersionRow = exports.mapLearningEvidenceRow = exports.mapLearningCandidateRow = exports.mapWorkflowWorkerRow = exports.mapWorkflowWorkerEventRow = exports.mapWorkflowMergeRow = exports.TERMINAL_WORKFLOW_WORKER_STATES = exports.LEGAL_WORKFLOW_WORKER_TRANSITIONS = exports.stableSemanticJson = exports.mapTranscriptCheckpointRow = exports.mapToolNameResolutionRow = exports.mapTerminalTransitionRow = exports.mapTaskIntentArtifactRow = exports.mapChannelQueryPlanRow = exports.assertTaskIdentity = exports.normalizeTurnId = exports.mapSessionObligationRow = exports.isRetrievalSessionState = exports.RETRIEVAL_MAX_CYCLES = exports.serializeHostActionReport = exports.mapHostActionRow = exports.isHostActionState = exports.hostActionReportsEqual = exports.openGlobalDevFlowDatabase = exports.getGlobalDevFlowDbPath = exports.DevFlowDatabase = void 0;
+exports.stableLearningJson = exports.mapLearningVersionRow = exports.mapLearningEvidenceRow = exports.mapLearningCandidateRow = exports.mapWorkflowWorkerRow = exports.mapWorkflowWorkerEventRow = exports.mapWorkflowMergeRow = exports.TERMINAL_WORKFLOW_WORKER_STATES = exports.LEGAL_WORKFLOW_WORKER_TRANSITIONS = exports.stableTaskRuntimeJson = exports.stableTaskRuntimeHash = exports.mapTaskRuntimeSnapshotRow = exports.mapTaskRuntimeEventRow = exports.stableSemanticJson = exports.mapTranscriptCheckpointRow = exports.mapToolNameResolutionRow = exports.mapTerminalTransitionRow = exports.mapTaskIntentArtifactRow = exports.mapChannelQueryPlanRow = exports.assertTaskIdentity = exports.normalizeTurnId = exports.mapSessionObligationRow = exports.isRetrievalSessionState = exports.RETRIEVAL_MAX_CYCLES = exports.serializeHostActionReport = exports.mapHostActionRow = exports.isHostActionState = exports.hostActionReportsEqual = exports.openGlobalDevFlowReadOnlyDatabase = 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; } });
+Object.defineProperty(exports, "openGlobalDevFlowReadOnlyDatabase", { enumerable: true, get: function () { return database_1.openGlobalDevFlowReadOnlyDatabase; } });
 var host_actions_1 = require("./host-actions");
 Object.defineProperty(exports, "hostActionReportsEqual", { enumerable: true, get: function () { return host_actions_1.hostActionReportsEqual; } });
 Object.defineProperty(exports, "isHostActionState", { enumerable: true, get: function () { return host_actions_1.isHostActionState; } });
@@ -24,6 +25,11 @@ Object.defineProperty(exports, "mapTerminalTransitionRow", { enumerable: true, g
 Object.defineProperty(exports, "mapToolNameResolutionRow", { enumerable: true, get: function () { return task_semantic_control_1.mapToolNameResolutionRow; } });
 Object.defineProperty(exports, "mapTranscriptCheckpointRow", { enumerable: true, get: function () { return task_semantic_control_1.mapTranscriptCheckpointRow; } });
 Object.defineProperty(exports, "stableSemanticJson", { enumerable: true, get: function () { return task_semantic_control_1.stableSemanticJson; } });
+var task_runtime_1 = require("./task-runtime");
+Object.defineProperty(exports, "mapTaskRuntimeEventRow", { enumerable: true, get: function () { return task_runtime_1.mapTaskRuntimeEventRow; } });
+Object.defineProperty(exports, "mapTaskRuntimeSnapshotRow", { enumerable: true, get: function () { return task_runtime_1.mapTaskRuntimeSnapshotRow; } });
+Object.defineProperty(exports, "stableTaskRuntimeHash", { enumerable: true, get: function () { return task_runtime_1.stableTaskRuntimeHash; } });
+Object.defineProperty(exports, "stableTaskRuntimeJson", { enumerable: true, get: function () { return task_runtime_1.stableTaskRuntimeJson; } });
 var workflow_workers_1 = require("./workflow-workers");
 Object.defineProperty(exports, "LEGAL_WORKFLOW_WORKER_TRANSITIONS", { enumerable: true, get: function () { return workflow_workers_1.LEGAL_WORKFLOW_WORKER_TRANSITIONS; } });
 Object.defineProperty(exports, "TERMINAL_WORKFLOW_WORKER_STATES", { enumerable: true, get: function () { return workflow_workers_1.TERMINAL_WORKFLOW_WORKER_STATES; } });

package/dist/node-sqlite.d.ts

@@ -1,7 +1,7 @@
 import type { Database, Statement } from './types';
 export declare class NodeSqliteDatabase implements Database {
     private db;
-    constructor(path: string, busyTimeoutMs?: number);
+    constructor(path: string, busyTimeoutMs?: number, readOnly?: boolean);
     exec(sql: string): void;
     prepare(sql: string): Statement;
     transaction<T>(fn: () => T): T;

package/dist/node-sqlite.js

@@ -3,11 +3,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.NodeSqliteDatabase = void 0;
 const node_sqlite_1 = require("node:sqlite");
 class NodeSqliteDatabase {
-    constructor(path, busyTimeoutMs = 10000) {
-        this.db = new node_sqlite_1.DatabaseSync(path);
+    constructor(path, busyTimeoutMs = 10000, readOnly = false) {
+        this.db = readOnly
+            ? new node_sqlite_1.DatabaseSync(path, { readOnly: true })
+            : new node_sqlite_1.DatabaseSync(path);
         this.db.exec(`PRAGMA busy_timeout = ${Math.max(0, Math.floor(busyTimeoutMs))}`);
-        this.db.exec('PRAGMA journal_mode = WAL');
-        this.db.exec('PRAGMA synchronous = NORMAL');
+        if (!readOnly) {
+            this.db.exec('PRAGMA journal_mode = WAL');
+            this.db.exec('PRAGMA synchronous = NORMAL');
+        }
     }
     exec(sql) {
         this.db.exec(sql);

package/dist/retrieval-ledger.d.ts

@@ -1,6 +1,7 @@
-export type RetrievalLedgerStage = 'eligible' | 'candidate' | 'selected' | 'exposed' | 'adopted' | 'positive_outcome' | 'negative_outcome' | 'unknown' | 'rejected';
+export type RetrievalLedgerStage = 'eligible' | 'candidate' | 'selected' | 'exposed' | 'adopted' | 'consumed' | 'verified' | 'positive_outcome' | 'negative_outcome' | 'unknown' | 'unknown_outcome' | 'rejected';
 export type RetrievalLedgerSourceType = 'code' | 'memory' | 'knowledge' | 'action';
 export interface RetrievalLedgerEventRecord {
+    schemaVersion?: 'retrieval-ledger-event.v1';
     id: string;
     projectRoot: string;
     sessionId: string;
@@ -10,6 +11,12 @@ export interface RetrievalLedgerEventRecord {
     contextReceipt: string;
     sourceType: RetrievalLedgerSourceType;
     sourceId: string;
+    taskSpecHash?: string;
+    actor?: string;
+    sourceVersion?: string;
+    sourceContentHash?: string;
+    evidenceIds?: string[];
+    reasonCode?: string;
     stage: RetrievalLedgerStage;
     rank?: number;
     rawScore?: number;

package/dist/task-runtime.d.ts

@@ -0,0 +1,64 @@
+export interface TaskRuntimeIdentityRecord {
+    projectRoot: string;
+    projectId: string;
+    hostId: string;
+    sessionId: string;
+    turnId: string;
+    requestId: string;
+    executionId?: string;
+}
+export interface TaskRuntimeEventRecord {
+    schemaVersion: 'task-runtime-event.v1';
+    producer: string;
+    producerVersion: string;
+    eventId: string;
+    sequence: number;
+    identity: TaskRuntimeIdentityRecord;
+    taskSpecHash: string;
+    kind: string;
+    payload: Record<string, unknown>;
+    createdAt: number;
+}
+export type TaskRuntimeChannelRequirement = 'required' | 'optional' | 'not_required';
+export type TaskRuntimeChannelStatus = 'satisfied' | 'intentional_abstention' | 'empty_valid' | 'degraded' | 'failed';
+export type TaskRuntimeObligationState = 'pending' | 'satisfied' | 'degraded' | 'failed';
+export interface TaskRuntimeChannelRecord {
+    requirement: TaskRuntimeChannelRequirement;
+    status: TaskRuntimeChannelStatus;
+    reasonCode: string;
+    evidenceIds: string[];
+    material: boolean;
+}
+export interface TaskRuntimeObligationRecord {
+    requirement: TaskRuntimeChannelRequirement;
+    state: TaskRuntimeObligationState;
+    receiptId?: string;
+    reasonCode?: string;
+}
+export interface TaskRuntimeSnapshotRecord {
+    schemaVersion: 'task-runtime-snapshot.v1';
+    producer: string;
+    producerVersion: string;
+    identity: TaskRuntimeIdentityRecord;
+    taskSpecHash: string;
+    lastEventSequence: number;
+    artifacts: {
+        requiredIdentityIds: string[];
+        resolvedIdentityIds: string[];
+        ambiguousIdentityIds: string[];
+    };
+    channels: Partial<Record<'code' | 'memory' | 'knowledge', TaskRuntimeChannelRecord>>;
+    contextReceiptId?: string;
+    action: TaskRuntimeObligationRecord;
+    verification: TaskRuntimeObligationRecord;
+    memory: TaskRuntimeObligationRecord;
+    durableWorkIds: string[];
+    terminal: 'running' | 'retry_pending' | 'completed' | 'completed_with_degradation' | 'failed';
+    runtimeHealth: 'healthy' | 'degraded' | 'unavailable';
+    snapshotHash: string;
+    updatedAt: number;
+}
+export declare function stableTaskRuntimeJson(value: unknown): string;
+export declare function stableTaskRuntimeHash(value: unknown): string;
+export declare function mapTaskRuntimeEventRow(row: Record<string, unknown>): TaskRuntimeEventRecord;
+export declare function mapTaskRuntimeSnapshotRow(row: Record<string, unknown>): TaskRuntimeSnapshotRecord;

package/dist/task-runtime.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stableTaskRuntimeJson = stableTaskRuntimeJson;
+exports.stableTaskRuntimeHash = stableTaskRuntimeHash;
+exports.mapTaskRuntimeEventRow = mapTaskRuntimeEventRow;
+exports.mapTaskRuntimeSnapshotRow = mapTaskRuntimeSnapshotRow;
+const node_crypto_1 = require("node:crypto");
+function stableTaskRuntimeJson(value) {
+    return JSON.stringify(canonicalize(value));
+}
+function stableTaskRuntimeHash(value) {
+    return (0, node_crypto_1.createHash)('sha256').update(stableTaskRuntimeJson(value)).digest('hex');
+}
+function mapTaskRuntimeEventRow(row) {
+    return {
+        schemaVersion: requiredLiteral(row.schema_version, 'task-runtime-event.v1'),
+        producer: requiredString(row.producer, 'producer'),
+        producerVersion: requiredString(row.producer_version, 'producer_version'),
+        eventId: requiredString(row.event_id, 'event_id'),
+        sequence: requiredPositiveInteger(row.sequence, 'sequence'),
+        identity: mapIdentity(row),
+        taskSpecHash: requiredString(row.task_spec_hash, 'task_spec_hash'),
+        kind: requiredString(row.kind, 'kind'),
+        payload: parseObject(row.payload_json, 'payload_json'),
+        createdAt: requiredNonNegativeInteger(row.created_at, 'created_at'),
+    };
+}
+function mapTaskRuntimeSnapshotRow(row) {
+    const snapshot = parseObject(row.snapshot_json, 'snapshot_json');
+    if (snapshot.schemaVersion !== 'task-runtime-snapshot.v1') {
+        throw new Error(`TASK_RUNTIME_SCHEMA_UNSUPPORTED:${String(snapshot.schemaVersion)}`);
+    }
+    if (snapshot.snapshotHash !== requiredString(row.snapshot_hash, 'snapshot_hash')) {
+        throw new Error('TASK_RUNTIME_SNAPSHOT_HASH_MISMATCH');
+    }
+    const { snapshotHash: _snapshotHash, ...body } = snapshot;
+    if (stableTaskRuntimeHash(body) !== snapshot.snapshotHash) {
+        throw new Error('TASK_RUNTIME_SNAPSHOT_HASH_MISMATCH');
+    }
+    return snapshot;
+}
+function mapIdentity(row) {
+    return {
+        projectRoot: requiredString(row.project_root, 'project_root'),
+        projectId: requiredString(row.project_id, 'project_id'),
+        hostId: requiredString(row.host_id, 'host_id'),
+        sessionId: requiredString(row.session_id, 'session_id'),
+        turnId: requiredString(row.turn_id, 'turn_id'),
+        requestId: requiredString(row.request_id, 'request_id'),
+        ...(optionalString(row.execution_id) ? { executionId: optionalString(row.execution_id) } : {}),
+    };
+}
+function requiredLiteral(value, literal) {
+    if (value !== literal)
+        throw new Error(`TASK_RUNTIME_SCHEMA_UNSUPPORTED:${String(value)}`);
+    return literal;
+}
+function requiredString(value, field) {
+    if (typeof value !== 'string' || !value.trim())
+        throw new Error(`TASK_RUNTIME_ROW_INVALID:${field}`);
+    return value;
+}
+function optionalString(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+function requiredPositiveInteger(value, field) {
+    const result = Number(value);
+    if (!Number.isSafeInteger(result) || result < 1)
+        throw new Error(`TASK_RUNTIME_ROW_INVALID:${field}`);
+    return result;
+}
+function requiredNonNegativeInteger(value, field) {
+    const result = Number(value);
+    if (!Number.isSafeInteger(result) || result < 0)
+        throw new Error(`TASK_RUNTIME_ROW_INVALID:${field}`);
+    return result;
+}
+function parseObject(value, field) {
+    if (typeof value !== 'string')
+        throw new Error(`TASK_RUNTIME_ROW_INVALID:${field}`);
+    try {
+        const parsed = JSON.parse(value);
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+            throw new Error('not object');
+        return parsed;
+    }
+    catch {
+        throw new Error(`TASK_RUNTIME_ROW_INVALID:${field}`);
+    }
+}
+function canonicalize(value) {
+    if (value === null || typeof value === 'string' || typeof value === 'boolean')
+        return value;
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value) || Object.is(value, -0))
+            throw new Error('TASK_RUNTIME_JSON_INVALID');
+        return value;
+    }
+    if (Array.isArray(value))
+        return value.map(canonicalize);
+    if (!value || typeof value !== 'object' || Object.getPrototypeOf(value) !== Object.prototype) {
+        throw new Error('TASK_RUNTIME_JSON_INVALID');
+    }
+    return Object.fromEntries(Object.keys(value).sort()
+        .map(key => [key, canonicalize(value[key])]));
+}

package/dist/work-queue.d.ts

@@ -1,5 +1,5 @@
-export type WorkKind = 'memory.explicit_commit' | 'memory.explicit_enrichment' | 'memory.turn_capture' | 'memory.turn_distill' | 'memory.vector_backfill' | 'context.prefetch' | 'verification.policy' | 'learning.analyze_session' | 'workflow.worker_start' | 'workflow.worker_monitor' | 'workflow.worker_verify' | 'workflow.worker_merge' | 'workflow.worker_cleanup' | 'session.bootstrap' | 'session.finalize' | 'telemetry.reconcile';
-export type WorkState = 'pending' | 'leased' | 'completed' | 'failed' | 'dead_letter';
+export type WorkKind = 'memory.explicit_commit' | 'memory.explicit_enrichment' | 'memory.turn_capture' | 'memory.turn_distill' | 'memory.vector_backfill' | 'knowledge.ingest' | 'knowledge.index_refresh' | 'context.prefetch' | 'verification.policy' | 'learning.analyze_session' | 'workflow.worker_start' | 'workflow.worker_monitor' | 'workflow.worker_verify' | 'workflow.worker_merge' | 'workflow.worker_cleanup' | 'session.bootstrap' | 'session.finalize' | 'telemetry.reconcile';
+export type WorkState = 'pending' | 'leased' | 'completed' | 'failed' | 'dead_letter' | 'cancelled';
 export interface WorkError {
     category: string;
     message: string;
@@ -11,6 +11,8 @@ export interface WorkItemRecord {
     projectRoot: string;
     sessionId?: string;
     turnId?: string;
+    sourceHash?: string;
+    taskSpecHash?: string;
     payload: unknown;
     state: WorkState;
     attempts: number;
@@ -23,6 +25,10 @@ export interface WorkItemRecord {
     createdAt: number;
     updatedAt: number;
     completedAt?: number;
+    cancelledAt?: number;
+    cancellationReason?: string;
+    replayOfId?: string;
+    replayCount: number;
 }
 export interface EnqueueWorkInput {
     idempotencyKey: string;
@@ -30,14 +36,25 @@ export interface EnqueueWorkInput {
     projectRoot: string;
     sessionId?: string;
     turnId?: string;
+    sourceHash?: string;
+    taskSpecHash?: string;
     payload: unknown;
     maxAttempts?: number;
     nextAttemptAt?: number;
 }
+export interface ProjectMutationLeaseRecord {
+    projectRoot: string;
+    mutationKind: string;
+    owner: string;
+    leaseExpiresAt: number;
+    sourceHash?: string;
+    updatedAt: number;
+}
 export interface LeaseWorkInput {
     projectRoot: string;
     owner: string;
     kinds?: WorkKind[];
+    workItemIds?: string[];
     limit: number;
     leaseMs: number;
     now?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devflow-tools/database",
-  "version": "0.17.1",
+  "version": "0.17.3",
   "description": "DevFlow SQLite database package",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",