@devflow-tools/database 0.17.7 → 0.18.0

package/dist/data/devflow-schema.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEVFLOW_SCHEMA_SQL = exports.DEVFLOW_TABLE_NAMES = void 0;
+exports.DEVFLOW_TABLE_NAMES = [
+    'devflow_kv',
+    'devflow_sessions',
+    'devflow_telemetry_runs',
+    'devflow_benchmark_reports',
+    'devflow_workflow_runs',
+    'devflow_knowledge_entries',
+    'devflow_tool_calls',
+    'devflow_rules',
+    'devflow_audit_chain',
+    'devflow_context_receipts',
+];
+exports.DEVFLOW_SCHEMA_SQL = `
+  CREATE TABLE IF NOT EXISTS devflow_kv (
+    key TEXT PRIMARY KEY, value TEXT
+  );
+  CREATE TABLE IF NOT EXISTS devflow_sessions (
+    session_id TEXT, timestamp INTEGER, event TEXT, data TEXT
+  );
+  CREATE TABLE IF NOT EXISTS devflow_telemetry_runs (
+    id TEXT PRIMARY KEY, agent TEXT, mode TEXT, status TEXT,
+    started_at INTEGER, finished_at INTEGER, token_used INTEGER, data TEXT
+  );
+  CREATE TABLE IF NOT EXISTS devflow_benchmark_reports (
+    id TEXT PRIMARY KEY, task TEXT, score REAL, started_at INTEGER,
+    finished_at INTEGER, data TEXT
+  );
+  CREATE TABLE IF NOT EXISTS devflow_workflow_runs (
+    run_id TEXT PRIMARY KEY, type TEXT, status TEXT, input TEXT,
+    steps TEXT, started_at INTEGER, finished_at INTEGER,
+    failure_category TEXT, failure_reason TEXT, failure_evidence TEXT
+  );
+  CREATE TABLE IF NOT EXISTS devflow_knowledge_entries (
+    id TEXT PRIMARY KEY, source TEXT, title TEXT, content TEXT
+  );
+  CREATE TABLE IF NOT EXISTS devflow_tool_calls (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    tool TEXT NOT NULL,
+    args TEXT,
+    timestamp INTEGER NOT NULL,
+    duration_ms INTEGER NOT NULL,
+    error TEXT
+  );
+  CREATE TABLE IF NOT EXISTS devflow_rules (
+    id TEXT PRIMARY KEY, name TEXT NOT NULL, level TEXT NOT NULL DEFAULT 'project',
+    gate INTEGER NOT NULL DEFAULT 1,
+    condition_json TEXT NOT NULL, action TEXT NOT NULL DEFAULT 'warn',
+    message TEXT NOT NULL, enabled INTEGER NOT NULL DEFAULT 1,
+    created_at INTEGER NOT NULL, updated_at INTEGER NOT NULL
+  );
+  CREATE TABLE IF NOT EXISTS devflow_audit_chain (
+    seq INTEGER PRIMARY KEY AUTOINCREMENT, ts INTEGER NOT NULL,
+    tool TEXT NOT NULL, args_hash TEXT NOT NULL,
+    decision TEXT NOT NULL, rule_id TEXT,
+    session_id TEXT NOT NULL, prev_hash TEXT NOT NULL,
+    signature TEXT NOT NULL
+  );
+  CREATE TABLE IF NOT EXISTS devflow_context_receipts (
+    project_root TEXT NOT NULL,
+    session_id TEXT NOT NULL,
+    execution_id TEXT NOT NULL,
+    context_hash TEXT NOT NULL,
+    issued_at INTEGER NOT NULL,
+    expires_at INTEGER NOT NULL,
+    selected_files TEXT NOT NULL DEFAULT '[]',
+    memory_ids TEXT NOT NULL DEFAULT '[]',
+    canonical_next_action TEXT,
+    canonical_action_json TEXT,
+    action_attempts TEXT NOT NULL DEFAULT '[]',
+    action_satisfied_at INTEGER,
+    action_degradation_json TEXT,
+    request_id TEXT,
+    PRIMARY KEY (project_root, session_id, execution_id)
+  );
+  CREATE INDEX IF NOT EXISTS idx_context_receipts_expiry
+    ON devflow_context_receipts(expires_at);
+`;

package/dist/database.d.ts

@@ -4,10 +4,12 @@ import { type FailHostActionInput, type HostActionRecord, type ReportHostActionI
 import { type AppendRetrievalCycleInput, type CreateRetrievalSessionInput, type RetrievalCycleRecord, type RetrievalSessionRecord, type RetrievalSessionState } from './retrieval-sessions';
 import { type AddLearningCandidateEvidenceInput, type LearningCandidateEvidenceRecord, type LearningCandidateRecord, type LearningCandidateState, type LearningCandidateVersionRecord, type TransitionLearningCandidateInput, type UpsertLearningCandidateInput } from './learning-candidates';
 import { type CreateWorkflowWorkerInput, type EnqueueWorkflowMergeInput, type TransitionWorkflowWorkerInput, type WorkflowMergeRecord, type WorkflowMergeState, type WorkflowWorkerEventRecord, type WorkflowWorkerRecord } from './workflow-workers';
-import type { RetrievalLedgerEventRecord } from './retrieval-ledger';
-import { type ChannelQueryPlanRecord, type TaskIntentArtifactRecord, type TerminalTransitionRecord, type ToolNameResolutionRecord, type TranscriptCheckpointRecord } from './task-semantic-control';
+import { type RetrievalLedgerEventRecord, type VerifyReceiptBoundRetrievalInput, type VerifyReceiptBoundRetrievalResult } from './retrieval-ledger';
+import { type CanonicalSemanticTaskWrite, type ChannelQueryPlanRecord, type TaskIntentArtifactRecord, type TerminalTransitionRecord, type ToolNameResolutionRecord, type TranscriptCheckpointRecord } from './task-semantic-control';
 import { type TaskRuntimeEventRecord, type TaskRuntimeSnapshotRecord } from './task-runtime';
-import { type SemanticResolutionRecord } from './semantic-resolution';
+import type { AppendTaskAggregateInput, AppendTaskAggregateResult, LeaseTaskOutboxInput, TaskOutboxRecord } from './task-aggregate';
+import { type CanonicalTaskIdentity, type RetrievalCycleReceiptV1, type RuntimeActivationSnapshotV1, type SemanticExecutionContext, type TaskAggregateEventV1, type TaskDefinitionV1, type TaskRuntimeSnapshotV2 } from '@devflow-tools/sdk';
+import type { AppendRetrievalCycleV2Input, CreateRetrievalSessionV2Input, RetrievalSessionV2Record } from './retrieval-runtime';
 export interface BenchmarkReportRecord {
     runId: string;
     suiteId: string;
@@ -435,6 +437,10 @@ export declare class DevFlowDatabase {
     updateHookReceipt(projectRoot: string, updater: (current: HookReceiptRecord | null) => Omit<HookReceiptRecord, 'projectRoot' | 'updatedAt'>): HookReceiptRecord;
     deleteHookReceipt(projectRoot: string): boolean;
     createRetrievalSession(input: CreateRetrievalSessionInput): RetrievalSessionRecord;
+    createRetrievalSessionV2(input: CreateRetrievalSessionV2Input): RetrievalSessionV2Record;
+    getRetrievalSessionV2(id: string): RetrievalSessionV2Record | null;
+    listRetrievalCyclesV2(sessionId: string): RetrievalCycleReceiptV1[];
+    appendRetrievalCycleV2(input: AppendRetrievalCycleV2Input): RetrievalSessionV2Record;
     getRetrievalSession(projectRoot: string, sessionId: string, id: string): RetrievalSessionRecord | null;
     getRetrievalSessionByRequest(requestId: string): RetrievalSessionRecord | null;
     listRetrievalCycles(retrievalSessionId: string): RetrievalCycleRecord[];
@@ -455,7 +461,9 @@ export declare class DevFlowDatabase {
     getContextReceiptForRequest(projectRoot: string, sessionId: string, requestId: string): ContextReceiptRecord | null;
     recordContextSelectionEvent(event: ContextSelectionEventRecord): boolean;
     appendRetrievalLedgerEvent(event: RetrievalLedgerEventRecord): boolean;
+    verifyReceiptBoundRetrieval(input: VerifyReceiptBoundRetrievalInput): VerifyReceiptBoundRetrievalResult;
     appendTaskIntentArtifact(record: TaskIntentArtifactRecord): TaskIntentArtifactRecord;
+    private appendTaskIntentArtifactInTransaction;
     getTaskIntentArtifact(artifactHash: string): TaskIntentArtifactRecord | null;
     getLatestTaskIntentArtifact(input: {
         projectRoot: string;
@@ -468,10 +476,6 @@ export declare class DevFlowDatabase {
         sessionId: string;
         sourceHash: string;
     }): TaskIntentArtifactRecord | null;
-    appendSemanticResolution(record: SemanticResolutionRecord): boolean;
-    getSemanticResolution(frameHash: string): SemanticResolutionRecord | null;
-    getLatestSemanticResolution(projectRoot: string, sessionId: string, turnId: string): SemanticResolutionRecord | null;
-    listSemanticResolutions(projectRoot: string, sessionId: string, turnId: string): SemanticResolutionRecord[];
     listLatestTaskIntentArtifacts(projectRoot: string, sessionId: string): TaskIntentArtifactRecord[];
     appendChannelQueryPlan(record: ChannelQueryPlanRecord): ChannelQueryPlanRecord;
     getChannelQueryPlan(planHash: string): ChannelQueryPlanRecord | null;
@@ -495,6 +499,40 @@ export declare class DevFlowDatabase {
     appendTaskRuntimeEventAndSnapshot(event: TaskRuntimeEventRecord, snapshot: TaskRuntimeSnapshotRecord): TaskRuntimeSnapshotRecord;
     getTaskRuntimeSnapshot(projectRoot: string, sessionId: string, turnId: string): TaskRuntimeSnapshotRecord | null;
     deleteTaskRuntimeSnapshot(projectRoot: string, sessionId: string, turnId: string): boolean;
+    appendTaskAggregate(input: AppendTaskAggregateInput): AppendTaskAggregateResult;
+    bindRuntimeActivation(input: {
+        identity: CanonicalTaskIdentity;
+        revision: number;
+        snapshot: RuntimeActivationSnapshotV1;
+    }): {
+        snapshot: RuntimeActivationSnapshotV1;
+        replayed: boolean;
+    };
+    private bindRuntimeActivationInTransaction;
+    getRuntimeActivation(projectRoot: string, sessionId: string, turnId: string, revision: number): RuntimeActivationSnapshotV1 | null;
+    putSemanticExecutionContext(input: {
+        context: SemanticExecutionContext;
+        revision: number;
+    }): SemanticExecutionContext;
+    putCanonicalSemanticTask(input: CanonicalSemanticTaskWrite): SemanticExecutionContext;
+    getSemanticExecutionContext(projectRoot: string, sessionId: string, turnId: string, revision: number): SemanticExecutionContext | null;
+    getSemanticExecutionContextByHash(contextHash: string): SemanticExecutionContext | null;
+    getLatestSemanticExecutionContext(input: {
+        projectRoot: string;
+        sessionId: string;
+        turnId: string;
+    }): {
+        context: SemanticExecutionContext;
+        revision: number;
+    } | null;
+    listTaskAggregateEvents(projectRoot: string, sessionId: string, turnId: string, revision: number): TaskAggregateEventV1[];
+    getTaskAggregateEventByIdempotencyKey(idempotencyKey: string): TaskAggregateEventV1 | null;
+    getTaskAggregateSnapshot(projectRoot: string, sessionId: string, turnId: string, revision: number): TaskRuntimeSnapshotV2 | null;
+    getTaskDefinitionV2(definitionHash: string): TaskDefinitionV1 | null;
+    leaseTaskOutbox(input: LeaseTaskOutboxInput): TaskOutboxRecord[];
+    completeTaskOutbox(operationId: string, owner: string, fencingToken: number, now?: number): boolean;
+    getTaskOutbox(operationId: string): TaskOutboxRecord | null;
+    private putTaskDefinitionV2;
     getTerminalTransition(receiptId: string): TerminalTransitionRecord | null;
     getLatestTerminalTransition(projectRoot: string, sessionId: string, turnId: string): TerminalTransitionRecord | null;
     appendTranscriptCheckpoint(record: TranscriptCheckpointRecord): boolean;