@devflow-tools/database 0.16.21 → 0.16.23

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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.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;
 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; } });
@@ -16,3 +16,14 @@ Object.defineProperty(exports, "isRetrievalSessionState", { enumerable: true, ge
 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; } });
+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; } });
+Object.defineProperty(exports, "mapWorkflowMergeRow", { enumerable: true, get: function () { return workflow_workers_1.mapWorkflowMergeRow; } });
+Object.defineProperty(exports, "mapWorkflowWorkerEventRow", { enumerable: true, get: function () { return workflow_workers_1.mapWorkflowWorkerEventRow; } });
+Object.defineProperty(exports, "mapWorkflowWorkerRow", { enumerable: true, get: function () { return workflow_workers_1.mapWorkflowWorkerRow; } });
+var learning_candidates_1 = require("./learning-candidates");
+Object.defineProperty(exports, "mapLearningCandidateRow", { enumerable: true, get: function () { return learning_candidates_1.mapLearningCandidateRow; } });
+Object.defineProperty(exports, "mapLearningEvidenceRow", { enumerable: true, get: function () { return learning_candidates_1.mapLearningEvidenceRow; } });
+Object.defineProperty(exports, "mapLearningVersionRow", { enumerable: true, get: function () { return learning_candidates_1.mapLearningVersionRow; } });
+Object.defineProperty(exports, "stableLearningJson", { enumerable: true, get: function () { return learning_candidates_1.stableLearningJson; } });

package/dist/learning-candidates.d.ts

@@ -0,0 +1,87 @@
+export type LearningCandidateState = 'observed' | 'candidate' | 'shadow' | 'evaluated' | 'active' | 'rejected' | 'retired';
+export type LearningCandidateKind = 'convention' | 'workflow' | 'tool_preference' | 'correction';
+export type LearningEvidencePolarity = 'supporting' | 'contradicting';
+export type LearningOutcomeState = 'positive' | 'negative' | 'unknown';
+export interface LearningCandidateRecord {
+    id: string;
+    projectRoot: string;
+    scope: 'project' | 'global';
+    state: LearningCandidateState;
+    kind: LearningCandidateKind;
+    trigger: Record<string, unknown>;
+    instruction: string;
+    confidence: number;
+    overlayVersion: number;
+    supportingSessions: number;
+    successfulOutcomes: number;
+    contradictions: number;
+    manualOnly: boolean;
+    risk: 'low' | 'medium' | 'high';
+    graderReceipt?: string;
+    expiresAt?: number;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface LearningCandidateVersionRecord {
+    candidateId: string;
+    version: number;
+    trigger: Record<string, unknown>;
+    instruction: string;
+    createdAt: number;
+}
+export interface LearningCandidateEvidenceRecord {
+    id: string;
+    candidateId: string;
+    projectRoot: string;
+    sessionId: string;
+    executionId?: string;
+    memoryObservationId?: string;
+    outcomeId?: string;
+    sourceType: 'memory' | 'correction' | 'workflow_outcome' | 'tool_preference' | 'convention' | 'grader' | 'manual';
+    polarity: LearningEvidencePolarity;
+    outcome: LearningOutcomeState;
+    evidenceHash: string;
+    receipt?: string;
+    payload: Record<string, unknown>;
+    createdAt: number;
+    resolvedAt?: number;
+}
+export interface UpsertLearningCandidateInput {
+    id: string;
+    projectRoot: string;
+    scope: 'project' | 'global';
+    kind: LearningCandidateKind;
+    trigger: Record<string, unknown>;
+    instruction: string;
+    confidence: number;
+    manualOnly?: boolean;
+    risk?: 'low' | 'medium' | 'high';
+    expiresAt?: number;
+}
+export interface AddLearningCandidateEvidenceInput {
+    id: string;
+    candidateId: string;
+    projectRoot: string;
+    sessionId: string;
+    executionId?: string;
+    memoryObservationId?: string;
+    outcomeId?: string;
+    sourceType: LearningCandidateEvidenceRecord['sourceType'];
+    polarity: LearningEvidencePolarity;
+    outcome?: LearningOutcomeState;
+    evidenceHash: string;
+    receipt?: string;
+    payload?: Record<string, unknown>;
+    createdAt?: number;
+}
+export interface TransitionLearningCandidateInput {
+    target: LearningCandidateState;
+    reason: string;
+    graderReceipt?: string;
+    manualApproval?: boolean;
+    changedAt?: number;
+}
+export declare function mapLearningCandidateRow(row: Record<string, unknown>): LearningCandidateRecord;
+export declare function mapLearningEvidenceRow(row: Record<string, unknown>): LearningCandidateEvidenceRecord;
+export declare function mapLearningVersionRow(row: Record<string, unknown>): LearningCandidateVersionRecord;
+export declare function stableLearningJson(value: unknown): string;

package/dist/learning-candidates.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapLearningCandidateRow = mapLearningCandidateRow;
+exports.mapLearningEvidenceRow = mapLearningEvidenceRow;
+exports.mapLearningVersionRow = mapLearningVersionRow;
+exports.stableLearningJson = stableLearningJson;
+function mapLearningCandidateRow(row) {
+    return {
+        id: String(row.id),
+        projectRoot: String(row.project_root),
+        scope: row.scope === 'global' ? 'global' : 'project',
+        state: row.state,
+        kind: row.kind,
+        trigger: parseRecord(row.trigger_json),
+        instruction: String(row.instruction),
+        confidence: Number(row.confidence),
+        overlayVersion: Number(row.overlay_version),
+        supportingSessions: Number(row.supporting_sessions),
+        successfulOutcomes: Number(row.successful_outcomes),
+        contradictions: Number(row.contradictions),
+        manualOnly: Number(row.manual_only) === 1,
+        risk: row.risk === 'high' ? 'high' : row.risk === 'medium' ? 'medium' : 'low',
+        graderReceipt: optionalString(row.grader_receipt),
+        expiresAt: optionalNumber(row.expires_at),
+        createdAt: Number(row.created_at),
+        updatedAt: Number(row.updated_at),
+    };
+}
+function mapLearningEvidenceRow(row) {
+    return {
+        id: String(row.id),
+        candidateId: String(row.candidate_id),
+        projectRoot: String(row.project_root),
+        sessionId: String(row.session_id),
+        executionId: optionalString(row.execution_id),
+        memoryObservationId: optionalString(row.memory_observation_id),
+        outcomeId: optionalString(row.outcome_id),
+        sourceType: row.source_type,
+        polarity: row.polarity,
+        outcome: row.outcome,
+        evidenceHash: String(row.evidence_hash),
+        receipt: optionalString(row.receipt),
+        payload: parseRecord(row.payload_json),
+        createdAt: Number(row.created_at),
+        resolvedAt: optionalNumber(row.resolved_at),
+    };
+}
+function mapLearningVersionRow(row) {
+    return {
+        candidateId: String(row.candidate_id),
+        version: Number(row.version),
+        trigger: parseRecord(row.trigger_json),
+        instruction: String(row.instruction),
+        createdAt: Number(row.created_at),
+    };
+}
+function stableLearningJson(value) {
+    if (Array.isArray(value))
+        return `[${value.map(stableLearningJson).join(',')}]`;
+    if (!value || typeof value !== 'object')
+        return JSON.stringify(value) ?? 'null';
+    const record = value;
+    return `{${Object.keys(record).sort().map(key => `${JSON.stringify(key)}:${stableLearningJson(record[key])}`).join(',')}}`;
+}
+function parseRecord(value) {
+    try {
+        const parsed = typeof value === 'string' ? JSON.parse(value) : value;
+        return parsed && typeof parsed === 'object' && !Array.isArray(parsed)
+            ? parsed
+            : {};
+    }
+    catch {
+        return {};
+    }
+}
+function optionalString(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+function optionalNumber(value) {
+    return value === null || value === undefined ? undefined : Number(value);
+}

package/dist/work-queue.d.ts

@@ -1,4 +1,4 @@
-export type WorkKind = 'memory.explicit_commit' | 'memory.explicit_enrichment' | 'memory.turn_capture' | 'memory.turn_distill' | 'memory.vector_backfill' | 'context.prefetch' | 'session.bootstrap' | 'session.finalize' | 'telemetry.reconcile';
+export type WorkKind = 'memory.explicit_commit' | 'memory.explicit_enrichment' | 'memory.turn_capture' | 'memory.turn_distill' | 'memory.vector_backfill' | 'context.prefetch' | '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 interface WorkError {
     category: string;

package/dist/workflow-workers.d.ts

@@ -0,0 +1,97 @@
+export type WorkflowWorkerState = 'planned' | 'leased' | 'starting' | 'running' | 'reported' | 'verifying' | 'merge_ready' | 'merged' | 'hold' | 'failed' | 'cancelled';
+export type WorkflowMergeState = 'waiting' | 'ready' | 'conflict' | 'merged' | 'rejected';
+export interface WorkflowWorkerRecord {
+    workerId: string;
+    runId: string;
+    stepId: string;
+    projectRoot: string;
+    branch: string;
+    worktreePath: string;
+    host: string;
+    state: WorkflowWorkerState;
+    leaseOwner?: string;
+    leaseExpiresAt?: number;
+    heartbeatAt?: number;
+    contextReceipt: string;
+    retrievalSessionId?: string;
+    sessionId?: string;
+    executionId?: string;
+    baseRevision: string;
+    finalRevision?: string;
+    allowedFiles: string[];
+    handoff: Record<string, unknown>;
+    holdReason?: string;
+    failureReason?: string;
+    createdAt: number;
+    updatedAt: number;
+    finishedAt?: number;
+}
+export interface CreateWorkflowWorkerInput {
+    workerId?: string;
+    runId: string;
+    stepId: string;
+    projectRoot: string;
+    branch: string;
+    worktreePath: string;
+    host: string;
+    contextReceipt: string;
+    retrievalSessionId?: string;
+    sessionId?: string;
+    executionId?: string;
+    baseRevision: string;
+    allowedFiles?: string[];
+    handoff?: Record<string, unknown>;
+}
+export interface TransitionWorkflowWorkerInput {
+    projectRoot: string;
+    workerId: string;
+    target: WorkflowWorkerState;
+    leaseOwner?: string;
+    leaseExpiresAt?: number;
+    heartbeatAt?: number;
+    finalRevision?: string;
+    handoff?: Record<string, unknown>;
+    reason?: string;
+    now?: number;
+}
+export interface WorkflowWorkerEventRecord {
+    eventId: string;
+    workerId: string;
+    projectRoot: string;
+    fromState?: WorkflowWorkerState;
+    toState: WorkflowWorkerState;
+    reason?: string;
+    payload: Record<string, unknown>;
+    createdAt: number;
+}
+export interface WorkflowMergeRecord {
+    mergeId: string;
+    workerId: string;
+    projectRoot: string;
+    state: WorkflowMergeState;
+    baseRevision: string;
+    parentRevision: string;
+    candidateRevision: string;
+    graderReceipts: string[];
+    simulationHash?: string;
+    mergeCommit?: string;
+    reason?: string;
+    createdAt: number;
+    updatedAt: number;
+    finishedAt?: number;
+}
+export interface EnqueueWorkflowMergeInput {
+    mergeId?: string;
+    workerId: string;
+    projectRoot: string;
+    baseRevision: string;
+    parentRevision: string;
+    candidateRevision: string;
+    graderReceipts?: string[];
+    simulationHash?: string;
+}
+export declare const TERMINAL_WORKFLOW_WORKER_STATES: Set<WorkflowWorkerState>;
+export declare const LEGAL_WORKFLOW_WORKER_TRANSITIONS: Record<WorkflowWorkerState, WorkflowWorkerState[]>;
+export declare function mapWorkflowWorkerRow(row: any): WorkflowWorkerRecord;
+export declare function mapWorkflowWorkerEventRow(row: any): WorkflowWorkerEventRecord;
+export declare function mapWorkflowMergeRow(row: any): WorkflowMergeRecord;

package/dist/workflow-workers.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LEGAL_WORKFLOW_WORKER_TRANSITIONS = exports.TERMINAL_WORKFLOW_WORKER_STATES = void 0;
+exports.mapWorkflowWorkerRow = mapWorkflowWorkerRow;
+exports.mapWorkflowWorkerEventRow = mapWorkflowWorkerEventRow;
+exports.mapWorkflowMergeRow = mapWorkflowMergeRow;
+exports.TERMINAL_WORKFLOW_WORKER_STATES = new Set([
+    'merged', 'failed', 'cancelled',
+]);
+exports.LEGAL_WORKFLOW_WORKER_TRANSITIONS = {
+    planned: ['leased', 'cancelled', 'hold', 'failed'],
+    leased: ['starting', 'hold', 'cancelled', 'failed'],
+    starting: ['running', 'reported', 'hold', 'cancelled', 'failed'],
+    running: ['reported', 'hold', 'cancelled', 'failed'],
+    reported: ['verifying', 'hold', 'cancelled', 'failed'],
+    verifying: ['merge_ready', 'hold', 'cancelled', 'failed'],
+    merge_ready: ['merged', 'hold', 'cancelled', 'failed'],
+    merged: [],
+    hold: ['leased', 'cancelled', 'failed'],
+    failed: [],
+    cancelled: [],
+};
+function mapWorkflowWorkerRow(row) {
+    return {
+        workerId: row.worker_id,
+        runId: row.run_id,
+        stepId: row.step_id,
+        projectRoot: row.project_root,
+        branch: row.branch,
+        worktreePath: row.worktree_path,
+        host: row.host,
+        state: row.state,
+        leaseOwner: row.lease_owner ?? undefined,
+        leaseExpiresAt: row.lease_expires_at ?? undefined,
+        heartbeatAt: row.heartbeat_at ?? undefined,
+        contextReceipt: row.context_receipt,
+        retrievalSessionId: row.retrieval_session_id ?? undefined,
+        sessionId: row.session_id ?? undefined,
+        executionId: row.execution_id ?? undefined,
+        baseRevision: row.base_revision,
+        finalRevision: row.final_revision ?? undefined,
+        allowedFiles: parseJson(row.allowed_files, []),
+        handoff: parseJson(row.handoff_json, {}),
+        holdReason: row.hold_reason ?? undefined,
+        failureReason: row.failure_reason ?? undefined,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+        finishedAt: row.finished_at ?? undefined,
+    };
+}
+function mapWorkflowWorkerEventRow(row) {
+    return {
+        eventId: row.event_id,
+        workerId: row.worker_id,
+        projectRoot: row.project_root,
+        fromState: row.from_state ?? undefined,
+        toState: row.to_state,
+        reason: row.reason ?? undefined,
+        payload: parseJson(row.payload_json, {}),
+        createdAt: row.created_at,
+    };
+}
+function mapWorkflowMergeRow(row) {
+    return {
+        mergeId: row.merge_id,
+        workerId: row.worker_id,
+        projectRoot: row.project_root,
+        state: row.state,
+        baseRevision: row.base_revision,
+        parentRevision: row.parent_revision,
+        candidateRevision: row.candidate_revision,
+        graderReceipts: parseJson(row.grader_receipts, []),
+        simulationHash: row.simulation_hash ?? undefined,
+        mergeCommit: row.merge_commit ?? undefined,
+        reason: row.reason ?? undefined,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+        finishedAt: row.finished_at ?? undefined,
+    };
+}
+function parseJson(value, fallback) {
+    if (typeof value !== 'string' || value.length === 0)
+        return fallback;
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return fallback;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devflow-tools/database",
-  "version": "0.16.21",
+  "version": "0.16.23",
   "description": "DevFlow SQLite database package",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -13,5 +13,5 @@
     "typescript": "^5.5.0",
     "vitest": "^2.0.0"
   },
-  "gitHead": "964af33767bf232606e63d973b3a29d7d53c8119"
+  "gitHead": "9cace27e1c380cc2bd73a57fa2709f04e197f25b"
 }