@ornexus/neocortex 4.60.16

package/packages/client/dist/continuity/sqlite-store.d.ts

@@ -0,0 +1,926 @@
+/**
+ * @license FSL-1.1
+ * Copyright (c) 2026 OrNexus AI
+ *
+ * P180.04 -- Local SQLite continuity store, migrations and integrity checks.
+ */
+import { CONTINUITY_RECEIPT_COMPACTION_EVENT_TYPE, CONTINUITY_RECEIPT_RETENTION_REASON_CODES, type ContinuityQueuePolicy, type ContinuityQueueScope, type ContinuityOutboxRetryPolicy, type ContinuityOutboxStatus, type ContinuityRetentionPolicyInput } from './outbox.js';
+export declare const CONTINUITY_SQLITE_RELATIVE_DIR: ".neocortex/continuity";
+export declare const CONTINUITY_SQLITE_FILENAME: "continuity.sqlite";
+export declare const CONTINUITY_SQLITE_SCHEMA_VERSION: 5;
+export declare const DEFAULT_CONTINUITY_SQLITE_BUSY_TIMEOUT_MS = 5000;
+export declare const CONTINUITY_PROCESSING_OUTPUT_SUMMARY_EVENT_TYPE: "processing_output_summary";
+export declare const CONTINUITY_PROCESSING_OUTPUT_SUMMARY_MAX_CHARS: 2000;
+export declare const DEFAULT_CONTINUITY_PROCESSING_SUMMARY_LIMIT: 20;
+export declare const MAX_CONTINUITY_PROCESSING_SUMMARY_LIMIT: 100;
+export declare const SQLITE_ADAPTER_INSTALL_GUIDANCE = "Install the optional Enterprise continuity SQLite adapter with `npm install --workspace packages/client better-sqlite3 --include=optional` or reinstall Neocortex with optional dependencies enabled.";
+/**
+ * P195.04: Client-local mirror of the shared continuity process-stage contract
+ * (SSoT: `packages/shared/src/continuity/runner-state.ts` ->
+ * `CONTINUITY_PUBLIC_STAGES` / `CONTINUITY_STAGE_HISTORY_MAX`). The client keeps a
+ * local copy so continuity SQLite persistence has no runtime `@neocortex/shared`
+ * import; a drift test in `continuity-sqlite.test.ts` asserts parity with the
+ * shared SSoT. Values are an allow-list only -- unknown/arbitrary strings never
+ * persist or project as a stage.
+ */
+export declare const CONTINUITY_PUBLIC_STAGES: readonly ["discover_more", "create_epic", "run_yoloop", "run_yolo", "run_verifier", "run_review_gate", "compact_context", "wait_external", "backoff", "waiting_human", "complete", "abort", "scheduled", "running", "overlap_skipped", "missed_run_catchup", "completed", "aborted", "cancelled", "blocked", "draft", "planned"];
+export type ContinuityPublicStageName = (typeof CONTINUITY_PUBLIC_STAGES)[number];
+/** P195.04: Maximum retained `stageHistory` entries (newest kept). ADR-P195-03. */
+export declare const CONTINUITY_STAGE_HISTORY_MAX: 20;
+/**
+ * P195.04: A single bounded, public-safe process-stage history entry. `at` is a
+ * sanitized ISO timestamp string; no raw logs, prompts, paths, URLs, PII or
+ * secrets ever appear here.
+ */
+export interface ContinuityStageHistoryEntry {
+    readonly stage: ContinuityPublicStageName;
+    readonly at: string;
+}
+export declare function isContinuityPublicStage(value: unknown): value is ContinuityPublicStageName;
+export declare function sanitizeContinuityStageTimestamp(value: unknown): string | undefined;
+/**
+ * P195.04: Validate an unknown value into a bounded, allow-listed stage history.
+ * Unknown stages and unsafe timestamps are dropped, and the newest
+ * `CONTINUITY_STAGE_HISTORY_MAX` entries are kept.
+ */
+export declare function sanitizeContinuityStageHistory(value: unknown): ContinuityStageHistoryEntry[];
+export declare function normalizeContinuityStageIteration(value: unknown): number | undefined;
+export type ContinuitySqliteStoreErrorCode = 'sqlite-adapter-unavailable' | 'sqlite-integrity-failed' | 'sqlite-migration-failed' | 'sqlite-migration-conflict' | 'sqlite-mutation-failed' | 'sqlite-foreign-key-failed' | 'sqlite-public-safety-rejected' | 'sqlite-mutation-blocked';
+export declare class ContinuitySqliteStoreError extends Error {
+    readonly code: ContinuitySqliteStoreErrorCode;
+    readonly reasonCode: ContinuitySqliteStoreErrorCode;
+    readonly guidance?: string;
+    readonly mutationBlocked: boolean;
+    readonly cause?: unknown;
+    constructor(code: ContinuitySqliteStoreErrorCode, message: string, options?: {
+        readonly guidance?: string;
+        readonly cause?: unknown;
+        readonly mutationBlocked?: boolean;
+    });
+}
+export interface ContinuitySqliteStatementRunResult {
+    readonly changes: number;
+    readonly lastInsertRowid?: number | bigint;
+}
+export interface ContinuitySqliteStatement {
+    run(...params: readonly unknown[]): ContinuitySqliteStatementRunResult;
+    get(...params: readonly unknown[]): unknown;
+    all(...params: readonly unknown[]): readonly unknown[];
+}
+export type ContinuitySqliteTransaction<T extends (...args: never[]) => unknown> = T & {
+    readonly immediate?: T;
+};
+export interface ContinuitySqliteDatabase {
+    pragma(source: string, options?: {
+        readonly simple?: boolean;
+    }): unknown;
+    exec(source: string): void;
+    prepare(source: string): ContinuitySqliteStatement;
+    transaction<T extends (...args: never[]) => unknown>(fn: T): ContinuitySqliteTransaction<T>;
+    close(): void;
+}
+export interface ContinuitySqliteAdapter {
+    readonly adapterName: 'better-sqlite3' | 'test-adapter' | string;
+    open(filePath: string, options?: {
+        readonly fileMustExist?: boolean;
+    }): ContinuitySqliteDatabase;
+}
+export type ContinuitySqliteAdapterLoadResult = {
+    readonly ok: true;
+    readonly adapter: ContinuitySqliteAdapter;
+} | {
+    readonly ok: false;
+    readonly error: ContinuitySqliteStoreError;
+};
+export type ContinuitySqliteDynamicImporter = (specifier: string) => Promise<unknown>;
+export interface OpenContinuitySqliteStoreOptions {
+    readonly projectRoot: string;
+    readonly adapter?: ContinuitySqliteAdapter;
+    readonly adapterLoader?: () => Promise<ContinuitySqliteAdapterLoadResult>;
+    readonly busyTimeoutMs?: number;
+    readonly integrityCheck?: boolean;
+    readonly now?: () => string;
+}
+export interface ContinuityJobWriteInput {
+    readonly jobId: string;
+    readonly kind: 'goal' | 'loop' | 'runner' | 'jobs';
+    readonly status: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly summary?: string;
+    readonly reasonCode?: string;
+    readonly nextRunAt?: string;
+    readonly goalId?: string;
+    readonly loopId?: string;
+    readonly campaignId?: string;
+    readonly operationId?: string;
+    readonly idempotencyKey?: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+export interface ContinuityEventWriteInput {
+    readonly eventId: string;
+    readonly jobId: string;
+    readonly operationId: string;
+    readonly idempotencyKey?: string;
+    readonly sequence?: number;
+    readonly type: string;
+    readonly summary: string;
+    readonly reasonCode?: string;
+    readonly createdAt: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+export interface ContinuityProcessingOutputSummaryWriteInput {
+    readonly executionId: string;
+    readonly jobId: string;
+    readonly eventId?: string;
+    readonly idempotencyKey?: string;
+    readonly goalId?: string;
+    readonly loopId?: string;
+    readonly publicSummary: string;
+    readonly reasonCode?: string;
+    readonly createdAt: string;
+    readonly source?: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+export type ContinuityHeadlessExecutionAttemptStatus = 'queued' | 'running' | 'completed' | 'failed' | 'timed_out' | 'backoff' | 'skipped';
+export type ContinuityHeadlessExecutionDirectiveKind = 'run_yolo' | 'run_yoloop';
+export type ContinuityHeadlessExecutionCommandClass = 'goal-tick' | 'loop-tick';
+export type ContinuityHeadlessExecutionTargetKind = 'story' | 'epic';
+export type ContinuityHeadlessExecutionRuntimeSource = 'explicit' | 'origin' | 'default' | 'fallback' | 'unspecified';
+export interface ContinuityHeadlessExecutionAttemptEnqueueInput {
+    readonly attemptId: string;
+    readonly executionId: string;
+    readonly jobId: string;
+    readonly directiveHash: string;
+    readonly directiveKind: ContinuityHeadlessExecutionDirectiveKind;
+    readonly commandClass: ContinuityHeadlessExecutionCommandClass;
+    readonly targetKind: ContinuityHeadlessExecutionTargetKind;
+    readonly targetRef: string;
+    readonly storyId?: string;
+    readonly epicId?: string;
+    readonly runtimeId?: string;
+    readonly modelId?: string;
+    readonly runtimeSource?: ContinuityHeadlessExecutionRuntimeSource;
+    readonly status?: Extract<ContinuityHeadlessExecutionAttemptStatus, 'queued' | 'backoff'>;
+    readonly reasonCode?: string;
+    readonly publicSummary?: string;
+    readonly enqueuedAt: string;
+    readonly notBeforeAt?: string;
+    readonly retryCount?: number;
+    readonly maxAttempts?: number;
+    readonly queuePriority?: number;
+    readonly queueScope?: ContinuityQueueScope;
+    readonly operationId?: string;
+    readonly idempotencyKey?: string;
+    readonly counts?: Readonly<Record<string, unknown>>;
+    readonly hashes?: Readonly<Record<string, unknown>>;
+    readonly redactionSummary?: readonly unknown[];
+    readonly relativePaths?: readonly string[];
+    readonly metadata?: Readonly<Record<string, unknown>>;
+    readonly queueCap?: number;
+}
+export interface ContinuityHeadlessExecutionEnqueueResult extends ContinuitySqliteWriteResult {
+    readonly accepted: boolean;
+    readonly backpressure: boolean;
+    readonly queueDepth: number;
+    readonly queueCap: number;
+    readonly reasonCode?: string;
+    readonly publicSafe: true;
+}
+export interface ContinuityHeadlessExecutionAttemptClaimInput {
+    readonly attemptId: string;
+    readonly leaseId: string;
+    readonly runnerId: string;
+    readonly claimedAt: string;
+    readonly leaseExpiresAt: string;
+    readonly reasonCode?: string;
+}
+export interface ContinuityHeadlessExecutionAcquireNextInput {
+    readonly leaseId: string;
+    readonly runnerId: string;
+    readonly claimedAt: string;
+    readonly leaseExpiresAt: string;
+    readonly directiveKind?: ContinuityHeadlessExecutionDirectiveKind;
+    readonly reasonCode?: string;
+}
+export interface ContinuityHeadlessExecutionAcquireNextResult {
+    readonly acquired: boolean;
+    readonly attempt?: ContinuityHeadlessExecutionAttemptRow;
+    readonly reasonCode: string;
+    readonly publicSafe: true;
+}
+export interface ContinuityHeadlessExecutionAttemptHeartbeatInput {
+    readonly attemptId: string;
+    readonly leaseId: string;
+    readonly runnerId: string;
+    readonly heartbeatAt: string;
+    readonly leaseExpiresAt?: string;
+}
+export interface ContinuityHeadlessExecutionAttemptReleaseInput {
+    readonly attemptId: string;
+    readonly leaseId: string;
+    readonly releasedAt: string;
+    readonly status?: Extract<ContinuityHeadlessExecutionAttemptStatus, 'queued' | 'backoff' | 'skipped'>;
+    readonly reasonCode?: string;
+    readonly notBeforeAt?: string;
+    readonly retryCount?: number;
+}
+export interface ContinuityHeadlessExecutionAttemptCompletionInput {
+    readonly attemptId: string;
+    readonly executionId?: string;
+    readonly jobId?: string;
+    readonly leaseId?: string;
+    readonly runnerId?: string;
+    readonly status: Exclude<ContinuityHeadlessExecutionAttemptStatus, 'queued' | 'running'>;
+    readonly completedAt: string;
+    readonly durationMs?: number;
+    readonly reasonCode?: string;
+    readonly publicSummary?: string;
+    readonly notBeforeAt?: string;
+    readonly retryCount?: number;
+    readonly counts?: Readonly<Record<string, unknown>>;
+    readonly hashes?: Readonly<Record<string, unknown>>;
+    readonly redactionSummary?: readonly unknown[];
+    readonly relativePaths?: readonly string[];
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+export interface ContinuityHeadlessExecutionReceiptWriteInput {
+    readonly receiptId: string;
+    readonly attemptId: string;
+    readonly executionId: string;
+    readonly jobId: string;
+    readonly status: 'accepted' | 'applied' | 'ignored' | 'failed' | 'deferred';
+    readonly reasonCode?: string;
+    readonly createdAt: string;
+    readonly operationId?: string;
+    readonly idempotencyKey?: string;
+    readonly counts?: Readonly<Record<string, unknown>>;
+    readonly hashes?: Readonly<Record<string, unknown>>;
+    readonly redactionSummary?: readonly unknown[];
+    readonly relativePaths?: readonly string[];
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+export interface ContinuityHeadlessExecutionSummaryWriteInput {
+    readonly eventId?: string;
+    readonly attemptId: string;
+    readonly executionId: string;
+    readonly jobId: string;
+    readonly status?: ContinuityHeadlessExecutionAttemptStatus;
+    readonly publicSummary: string;
+    readonly reasonCode?: string;
+    readonly createdAt: string;
+    readonly runtimeId?: string;
+    readonly modelId?: string;
+    readonly durationMs?: number;
+    readonly counts?: Readonly<Record<string, unknown>>;
+    readonly hashes?: Readonly<Record<string, unknown>>;
+    readonly redactionSummary?: readonly unknown[];
+    readonly relativePaths?: readonly string[];
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+export interface ContinuityReceiptWriteInput {
+    readonly receiptId: string;
+    readonly jobId: string;
+    readonly operationId?: string;
+    readonly idempotencyKey?: string;
+    readonly status: 'accepted' | 'applied' | 'ignored' | 'failed' | 'deferred';
+    readonly reasonCode?: string;
+    readonly appliedOperationIds?: readonly string[];
+    readonly ignoredOperationIds?: readonly string[];
+    readonly createdAt: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+export interface ContinuityReceiptCompactionCounts {
+    readonly receiptsRemoved: number;
+    readonly receiptsRetained: number;
+    readonly outputsRemoved: number;
+    readonly outputsRetained: number;
+    readonly bytesRemoved: number;
+    readonly bytesRetained: number;
+    readonly redactions: number;
+}
+export interface ContinuityReceiptCompactionHashes {
+    readonly receipts: string;
+    readonly outputs: string;
+    readonly aggregate: string;
+}
+export interface ContinuityReceiptCompactionSummary {
+    readonly schemaVersion: 1;
+    readonly contractVersion: 'continuity-v1';
+    readonly policyVersion: 1;
+    readonly type: typeof CONTINUITY_RECEIPT_COMPACTION_EVENT_TYPE;
+    readonly summaryId: string;
+    readonly jobId: string;
+    readonly scope: 'local_sqlite';
+    readonly status: 'compacted';
+    readonly createdAt: string;
+    readonly reasonCodes: readonly [typeof CONTINUITY_RECEIPT_RETENTION_REASON_CODES.COMPACTED];
+    readonly counts: ContinuityReceiptCompactionCounts;
+    readonly hashes: ContinuityReceiptCompactionHashes;
+    readonly publicSummary: string;
+    readonly publicSafe: true;
+}
+export interface ContinuityReceiptCompactionInput {
+    readonly nowIso: string;
+    readonly policy?: ContinuityRetentionPolicyInput;
+}
+export interface ContinuityReceiptCompactionResult {
+    readonly status: 'compacted' | 'noop';
+    readonly summaries: readonly ContinuityReceiptCompactionSummary[];
+    readonly counts: {
+        readonly receiptsRemoved: number;
+        readonly outputsRemoved: number;
+        readonly bytesRemoved: number;
+        readonly summariesCreated: number;
+    };
+    readonly reasonCode: typeof CONTINUITY_RECEIPT_RETENTION_REASON_CODES.COMPACTED | typeof CONTINUITY_RECEIPT_RETENTION_REASON_CODES.NOOP;
+    readonly publicSafe: true;
+}
+export interface ContinuitySqliteWriteResult {
+    readonly inserted: boolean;
+    readonly replay: boolean;
+    readonly changes: number;
+}
+export interface ContinuityJobStatusUpdateInput {
+    readonly jobId: string;
+    readonly status: string;
+    readonly updatedAt: string;
+    readonly reasonCode?: string;
+    readonly nextRunAt?: string | null;
+}
+/**
+ * P195.04: Additive process-stage progress persisted into the existing
+ * `jobs.metadata_json` column (no schema migration). Applied once per applied
+ * tick; unknown stages and unsafe timestamps are ignored.
+ */
+export interface ContinuityJobStageProgressInput {
+    readonly jobId: string;
+    readonly currentStage?: unknown;
+    readonly iteration?: unknown;
+    readonly at: string;
+    /** Defaults to true. When false, `currentStage`/`iteration` update without a history append. */
+    readonly appendHistory?: boolean;
+}
+export type ContinuityJobCampaignStatusParityUpdateInput = ContinuityJobStatusUpdateInput;
+export interface ContinuityScheduleWriteInput {
+    readonly jobId: string;
+    readonly scheduledAt: string;
+    readonly updatedAt: string;
+    readonly reasonCode?: string;
+}
+export interface ContinuityLeaseWriteInput {
+    readonly leaseId: string;
+    readonly jobId: string;
+    readonly runnerId: string;
+    readonly acquiredAt: string;
+    readonly expiresAt: string;
+    readonly operationId?: string;
+    readonly idempotencyKey?: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+export interface ContinuityLeaseReleaseInput {
+    readonly leaseId: string;
+    readonly releasedAt: string;
+    readonly reasonCode?: string;
+}
+export interface ContinuityStateSnapshotWriteInput {
+    readonly snapshotId: string;
+    readonly jobId?: string;
+    readonly kind: string;
+    readonly relativePath?: string;
+    readonly sha256?: string;
+    readonly summary?: string;
+    readonly capturedAt: string;
+    readonly operationId?: string;
+    readonly idempotencyKey?: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+export interface ContinuityArtifactWriteInput {
+    readonly artifactId: string;
+    readonly jobId?: string;
+    readonly kind: string;
+    readonly relativePath: string;
+    readonly sha256?: string;
+    readonly summary?: string;
+    readonly operationId?: string;
+    readonly idempotencyKey?: string;
+    readonly createdAt: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+export interface ContinuityOutboxWriteInput {
+    readonly outboxId: string;
+    readonly jobId?: string;
+    readonly operationId: string;
+    readonly idempotencyKey?: string;
+    readonly type: string;
+    readonly status?: ContinuityOutboxStatus;
+    readonly payload: Readonly<Record<string, unknown>>;
+    readonly retryCount?: number;
+    readonly attemptCount?: number;
+    readonly deliveryCursor?: string;
+    readonly nextAttemptAt?: string;
+    readonly lastAttemptAt?: string;
+    readonly sentAt?: string;
+    readonly ackedAt?: string;
+    readonly lastErrorCode?: string;
+    readonly lastErrorReason?: string;
+    readonly lastErrorSummary?: string;
+    readonly deadLetterSummary?: string;
+    readonly deadLetteredAt?: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+}
+export interface ContinuityOutboxDeliveryRow {
+    readonly outboxId: string;
+    readonly jobId?: string;
+    readonly operationId: string;
+    readonly idempotencyKey?: string;
+    readonly type: string;
+    readonly status: ContinuityOutboxStatus;
+    readonly payload: Readonly<Record<string, unknown>>;
+    readonly retryCount: number;
+    readonly attemptCount: number;
+    readonly deliveryCursor?: string;
+    readonly nextAttemptAt?: string;
+    readonly lastAttemptAt?: string;
+    readonly sentAt?: string;
+    readonly ackedAt?: string;
+    readonly lastErrorCode?: string;
+    readonly lastErrorReason?: string;
+    readonly lastErrorSummary?: string;
+    readonly deadLetterSummary?: string;
+    readonly deadLetteredAt?: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly publicSafe: true;
+}
+export interface ContinuityOutboxBatchQueryOptions {
+    readonly nowIso: string;
+    readonly limit: number;
+    readonly statuses?: readonly ContinuityOutboxStatus[];
+}
+export interface ContinuityOutboxMarkSentInput {
+    readonly outboxId: string;
+    readonly deliveryCursor: string;
+    readonly sentAt: string;
+    readonly reasonCode?: string;
+}
+export interface ContinuityOutboxAckInput {
+    readonly outboxId: string;
+    readonly deliveryCursor?: string;
+    readonly ackedAt: string;
+    readonly reasonCode?: string;
+}
+export interface ContinuityOutboxFailInput {
+    readonly outboxId: string;
+    readonly deliveryCursor?: string;
+    readonly failedAt: string;
+    readonly reasonCode: string;
+    readonly summary?: string;
+    readonly nextRetryAt?: string;
+    readonly policy?: Partial<ContinuityOutboxRetryPolicy>;
+}
+export interface ContinuityOutboxDeadLetterInput {
+    readonly outboxId: string;
+    readonly deadLetteredAt: string;
+    readonly reasonCode: string;
+    readonly summary: string;
+}
+export interface ContinuityOutboxTransitionResult {
+    readonly outboxId: string;
+    readonly status: ContinuityOutboxStatus | 'missing' | 'conflict';
+    readonly changes: number;
+    readonly replay: boolean;
+    readonly deliveryCursor?: string;
+    readonly reasonCode?: string;
+    readonly nextRetryAt?: string;
+    readonly deadLetteredAt?: string;
+    readonly publicSafe: true;
+}
+export interface ContinuityGoalCampaignWriteInput {
+    readonly campaignId: string;
+    readonly jobId: string;
+    readonly status: string;
+    readonly title?: string;
+    readonly publicSummary?: string;
+    readonly reasonCode?: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly operationId?: string;
+    readonly idempotencyKey?: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+export interface ContinuityGoalLedgerItemWriteInput {
+    readonly itemId: string;
+    readonly campaignId: string;
+    readonly jobId: string;
+    readonly itemType: string;
+    readonly status: string;
+    readonly summary: string;
+    readonly reasonCode?: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly operationId?: string;
+    readonly idempotencyKey?: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+export interface ContinuityGoalVerifierWriteInput {
+    readonly verifierId: string;
+    readonly campaignId: string;
+    readonly jobId: string;
+    readonly kind: string;
+    readonly status: string;
+    readonly summary?: string;
+    readonly reasonCode?: string;
+    readonly lastCheckedAt?: string;
+    readonly operationId?: string;
+    readonly idempotencyKey?: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+export interface ContinuityGoalReviewGateWriteInput {
+    readonly gateId: string;
+    readonly campaignId: string;
+    readonly jobId: string;
+    readonly status: string;
+    readonly summary?: string;
+    readonly required: boolean;
+    readonly reasonCode?: string;
+    readonly operationId?: string;
+    readonly idempotencyKey?: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+export interface ContinuityOperationAuditInput {
+    readonly receiptId: string;
+    readonly jobId: string;
+    readonly operationId: string;
+    readonly idempotencyKey?: string;
+    readonly status: 'accepted' | 'applied' | 'ignored' | 'failed' | 'deferred';
+    readonly reasonCode?: string;
+    readonly appliedOperationIds?: readonly string[];
+    readonly ignoredOperationIds?: readonly string[];
+    readonly createdAt: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+export interface ContinuitySnapshotQueryOptions {
+    readonly nowIso: string;
+    readonly jobLimit: number;
+    readonly staleLeaseLimit: number;
+    readonly receiptLimit: number;
+    readonly eventLimit: number;
+    readonly snapshotLimit: number;
+}
+export interface ContinuitySnapshotJobRow {
+    readonly job_id: string;
+    readonly kind: string;
+    readonly status: string;
+    readonly summary: string | null;
+    readonly reason_code: string | null;
+    readonly created_at: string;
+    readonly updated_at: string;
+    readonly next_run_at: string | null;
+    readonly metadata_json: string | null;
+    readonly iteration?: number;
+    readonly goal_ledger_item_count?: number;
+    readonly blocked_goal_ledger_item_count?: number;
+    readonly security_issue_blocked_count?: number;
+    readonly goal_verifier_count?: number;
+    readonly failed_verifier_count?: number;
+    readonly unavailable_verifier_count?: number;
+    readonly goal_review_gate_count?: number;
+    readonly failed_required_review_gate_count?: number;
+}
+export interface ContinuitySnapshotLeaseRow {
+    readonly lease_id: string;
+    readonly job_id: string;
+    readonly runner_id: string;
+    readonly expires_at: string;
+}
+export interface ContinuitySnapshotReceiptRow {
+    readonly receipt_id: string;
+    readonly job_id: string;
+    readonly operation_id: string | null;
+    readonly status: string;
+    readonly reason_code: string | null;
+    readonly created_at: string;
+    readonly metadata_json: string | null;
+}
+export interface ContinuitySnapshotEventRow {
+    readonly event_id: string;
+    readonly job_id: string;
+    readonly operation_id: string;
+    readonly type: string;
+    readonly summary: string;
+    readonly reason_code: string | null;
+    readonly created_at: string;
+    readonly metadata_json: string | null;
+}
+export interface ContinuityProcessingOutputSummaryRow {
+    readonly event_id: string;
+    readonly job_id: string;
+    readonly execution_id: string;
+    readonly public_summary: string;
+    readonly reason_code: string | null;
+    readonly created_at: string;
+    readonly metadata_json: string | null;
+    readonly cursor: string;
+}
+export type ContinuityProcessingOutputSummaryCursorTargetKind = 'job' | 'goal' | 'loop';
+export interface ContinuityProcessingOutputSummaryCursorTarget {
+    readonly selectorKind: ContinuityProcessingOutputSummaryCursorTargetKind;
+    readonly targetId: string;
+    readonly jobId?: string;
+    readonly goalId?: string;
+    readonly loopId?: string;
+    readonly relatedJobIds?: readonly string[];
+    readonly publicSafe?: true;
+}
+export interface ContinuitySnapshotStateSnapshotRow {
+    readonly snapshot_id: string;
+    readonly job_id: string | null;
+    readonly kind: string;
+    readonly relative_path: string | null;
+    readonly sha256: string | null;
+    readonly summary: string | null;
+    readonly captured_at: string;
+    readonly operation_id: string | null;
+    readonly metadata_json: string | null;
+}
+export interface ContinuitySnapshotHeadlessExecutionAttemptRow {
+    readonly attempt_id: string;
+    readonly execution_id: string;
+    readonly job_id: string;
+    readonly status: string;
+    readonly reason_code: string | null;
+    readonly runtime_id: string | null;
+    readonly model_id: string | null;
+    readonly retry_count: number;
+    readonly max_attempts: number;
+    readonly lease_id: string | null;
+    readonly runner_id: string | null;
+    readonly lease_expires_at: string | null;
+    readonly heartbeat_at: string | null;
+    readonly public_summary: string | null;
+    readonly enqueued_at: string;
+    readonly not_before_at: string | null;
+    readonly duration_ms: number | null;
+    readonly counts_json: string | null;
+    readonly hashes_json: string | null;
+    readonly redaction_summary_json: string | null;
+    readonly queue_priority: number;
+    readonly queue_scope: ContinuityQueueScope;
+    readonly attempt_count: number;
+    readonly next_retry_at: string | null;
+    readonly dead_lettered_at: string | null;
+    readonly dead_letter_reason_code: string | null;
+}
+export interface ContinuityQueueSummaryRow {
+    readonly depth: number;
+    readonly queued: number;
+    readonly running: number;
+    readonly retrying: number;
+    readonly deadLetter: number;
+    readonly capacity: number;
+    readonly available: number;
+    readonly backpressure: boolean;
+    readonly generatedAt: string;
+    readonly nextRetryAt?: string;
+    readonly reasonCode?: string;
+    readonly publicSafe: true;
+}
+export interface ContinuitySnapshotQueryResult {
+    readonly schemaVersion: number;
+    readonly jobs: readonly ContinuitySnapshotJobRow[];
+    readonly staleLeases: readonly ContinuitySnapshotLeaseRow[];
+    readonly receipts: readonly ContinuitySnapshotReceiptRow[];
+    readonly events: readonly ContinuitySnapshotEventRow[];
+    readonly stateSnapshots: readonly ContinuitySnapshotStateSnapshotRow[];
+    readonly headlessExecutionAttempts: readonly ContinuitySnapshotHeadlessExecutionAttemptRow[];
+    readonly counts: Readonly<Record<string, number>>;
+    readonly outboxCounts: Readonly<Record<string, number>>;
+    readonly queue: ContinuityQueueSummaryRow;
+}
+export interface ContinuityDueJobRow {
+    readonly job_id: string;
+    readonly kind: string;
+    readonly status: string;
+    readonly summary: string | null;
+    readonly reason_code: string | null;
+    readonly created_at: string;
+    readonly updated_at: string;
+    readonly next_run_at: string | null;
+    readonly metadata_json: string | null;
+    readonly iteration?: number;
+    readonly active_lease_count?: number;
+}
+export interface ContinuityHeadlessExecutionAttemptRow {
+    readonly attempt_id: string;
+    readonly execution_id: string;
+    readonly job_id: string;
+    readonly directive_hash: string;
+    readonly directive_kind: string;
+    readonly command_class: string;
+    readonly target_kind: string;
+    readonly target_ref: string;
+    readonly story_id: string | null;
+    readonly epic_id: string | null;
+    readonly runtime_id: string | null;
+    readonly model_id: string | null;
+    readonly runtime_source: string | null;
+    readonly status: ContinuityHeadlessExecutionAttemptStatus;
+    readonly reason_code: string | null;
+    readonly public_summary: string | null;
+    readonly enqueued_at: string;
+    readonly not_before_at: string | null;
+    readonly started_at: string | null;
+    readonly heartbeat_at: string | null;
+    readonly completed_at: string | null;
+    readonly duration_ms: number | null;
+    readonly retry_count: number;
+    readonly max_attempts: number;
+    readonly lease_id: string | null;
+    readonly runner_id: string | null;
+    readonly lease_expires_at: string | null;
+    readonly lease_released_at: string | null;
+    readonly counts_json: string | null;
+    readonly hashes_json: string | null;
+    readonly redaction_summary_json: string | null;
+    readonly relative_paths_json: string | null;
+    readonly metadata_json: string | null;
+    readonly queue_priority: number;
+    readonly queue_scope: ContinuityQueueScope;
+    readonly attempt_count: number;
+    readonly next_retry_at: string | null;
+    readonly dead_lettered_at: string | null;
+    readonly dead_letter_reason_code: string | null;
+}
+export interface ContinuityHeadlessExecutionDueQueryOptions {
+    readonly nowIso: string;
+    readonly limit: number;
+}
+export interface ContinuityHeadlessExecutionStaleRecoveryOptions {
+    readonly nowIso: string;
+    readonly staleAfterMs: number;
+    readonly limit: number;
+    readonly policy?: Partial<ContinuityQueuePolicy>;
+}
+export interface ContinuityHeadlessExecutionStaleRecoveryResult {
+    readonly recoveredAttemptIds: readonly string[];
+    readonly failedAttemptIds: readonly string[];
+    readonly retryingAttemptIds: readonly string[];
+    readonly deadLetteredAttemptIds: readonly string[];
+    readonly safeExpiredAtOrBefore: string;
+    readonly changes: number;
+    readonly publicSafe: true;
+}
+export interface ContinuityDueJobQueryOptions {
+    readonly nowIso: string;
+    readonly limit: number;
+}
+export interface ContinuityProcessingOutputSummaryQueryOptions {
+    readonly limit?: number;
+    readonly jobId?: string;
+    readonly target?: ContinuityProcessingOutputSummaryCursorTarget;
+}
+export interface ContinuityProcessingOutputSummaryCursorQueryOptions {
+    readonly cursor?: string;
+    readonly limit?: number;
+    readonly jobId?: string;
+    readonly target?: ContinuityProcessingOutputSummaryCursorTarget;
+}
+export interface ContinuityProcessingOutputSummaryCursorQueryResult {
+    readonly summaries: readonly ContinuityProcessingOutputSummaryRow[];
+    readonly nextCursor?: string;
+    readonly hasMore: boolean;
+    readonly publicSafe: true;
+}
+export interface ContinuityLocalConsoleAttachmentState {
+    readonly jobId: string;
+    readonly kind: string;
+    readonly status: string;
+    readonly activeLeaseCount: number;
+    readonly runningHeadlessAttemptCount: number;
+    readonly publicSafe: true;
+}
+export interface ContinuityStaleLeaseRecoveryOptions {
+    readonly nowIso: string;
+    readonly staleAfterMs: number;
+    readonly limit: number;
+}
+export interface ContinuityStaleLeaseRecoveryResult {
+    readonly recoveredLeaseIds: readonly string[];
+    readonly safeExpiredAtOrBefore: string;
+    readonly changes: number;
+}
+export interface ContinuityOutboxRetryOptions {
+    readonly nowIso: string;
+    readonly limit: number;
+    readonly statuses?: readonly ('failed' | 'dead_letter')[];
+    readonly nextAttemptAt?: string;
+    readonly reasonCode?: string;
+}
+export interface ContinuityOutboxRetryResult {
+    readonly retriedOutboxIds: readonly string[];
+    readonly changes: number;
+    readonly reasonCode: string;
+    readonly publicSafe: true;
+}
+declare const CONTINUITY_TABLES: readonly ["continuity_migrations", "jobs", "job_leases", "job_events", "job_receipts", "goal_campaigns", "goal_ledger_items", "goal_verifiers", "goal_review_gates", "loop_jobs", "artifacts", "state_snapshots", "headless_execution_attempts", "runner_config", "outbox"];
+export type ContinuitySqliteTable = (typeof CONTINUITY_TABLES)[number];
+export declare function loadBetterSqlite3Adapter(importer?: ContinuitySqliteDynamicImporter): Promise<ContinuitySqliteAdapterLoadResult>;
+export declare function continuitySqliteStorePath(projectRoot: string): string;
+export declare function openContinuitySqliteStore(options: OpenContinuitySqliteStoreOptions): Promise<ContinuitySqliteStore>;
+export declare class ContinuitySqliteStore {
+    readonly filePath: string;
+    readonly adapterName: string;
+    private readonly db;
+    private readonly busyTimeoutMs;
+    private readonly integrityCheck;
+    private readonly now;
+    private mutationBlocked;
+    constructor(options: {
+        readonly db: ContinuitySqliteDatabase;
+        readonly filePath: string;
+        readonly adapterName: string;
+        readonly busyTimeoutMs: number;
+        readonly integrityCheck: boolean;
+        readonly now: () => string;
+    });
+    initialize(): void;
+    close(): void;
+    pragmaValue(source: string): unknown;
+    runIntegrityCheck(): void;
+    getSchemaVersion(): number;
+    countRows(table: ContinuitySqliteTable): number;
+    getLocalConsoleAttachmentState(jobId: string): ContinuityLocalConsoleAttachmentState | null;
+    recordJob(input: ContinuityJobWriteInput): ContinuitySqliteWriteResult;
+    appendEvent(input: ContinuityEventWriteInput): ContinuitySqliteWriteResult;
+    recordProcessingOutputSummary(input: ContinuityProcessingOutputSummaryWriteInput): ContinuitySqliteWriteResult;
+    enqueueHeadlessExecutionAttempt(input: ContinuityHeadlessExecutionAttemptEnqueueInput): ContinuityHeadlessExecutionEnqueueResult;
+    listDueHeadlessExecutionAttempts(options: ContinuityHeadlessExecutionDueQueryOptions): readonly ContinuityHeadlessExecutionAttemptRow[];
+    hasCompletedHeadlessExecutionDirectiveHash(directiveHash: string, excludeAttemptId?: string): boolean;
+    claimHeadlessExecutionAttempt(input: ContinuityHeadlessExecutionAttemptClaimInput): ContinuitySqliteWriteResult;
+    acquireNextHeadlessExecutionAttempt(input: ContinuityHeadlessExecutionAcquireNextInput): ContinuityHeadlessExecutionAcquireNextResult;
+    heartbeatHeadlessExecutionAttempt(input: ContinuityHeadlessExecutionAttemptHeartbeatInput): ContinuitySqliteWriteResult;
+    releaseHeadlessExecutionAttempt(input: ContinuityHeadlessExecutionAttemptReleaseInput): ContinuitySqliteWriteResult;
+    completeHeadlessExecutionAttempt(input: ContinuityHeadlessExecutionAttemptCompletionInput): ContinuitySqliteWriteResult;
+    recordHeadlessExecutionReceipt(input: ContinuityHeadlessExecutionReceiptWriteInput): ContinuitySqliteWriteResult;
+    recordHeadlessExecutionSummary(input: ContinuityHeadlessExecutionSummaryWriteInput): ContinuitySqliteWriteResult;
+    appendReceipt(input: ContinuityReceiptWriteInput): ContinuitySqliteWriteResult;
+    /**
+     * P199.06: Apply TTL/count/byte retention to public receipts and persisted
+     * processing summaries. Deleted content is replaced with bounded audit evidence
+     * that hashes only public identifiers/status/reason codes, never summaries.
+     */
+    compactPublicReceiptsAndOutputs(input: ContinuityReceiptCompactionInput): ContinuityReceiptCompactionResult;
+    updateJobStatus(input: ContinuityJobStatusUpdateInput): ContinuitySqliteWriteResult;
+    /**
+     * P195.04: Additively persist producer-emitted process stage/iteration into the
+     * existing `jobs.metadata_json` column and append a bounded `stageHistory`
+     * (newest `CONTINUITY_STAGE_HISTORY_MAX` kept). No schema migration is required.
+     * Unknown stages, unsafe timestamps and missing jobs are no-ops so older DBs and
+     * non-tick summaries never throw.
+     */
+    recordJobStageProgress(input: ContinuityJobStageProgressInput): ContinuitySqliteWriteResult;
+    updateJobAndExistingGoalCampaignStatus(input: ContinuityJobCampaignStatusParityUpdateInput): ContinuitySqliteWriteResult;
+    scheduleNextTick(input: ContinuityScheduleWriteInput): ContinuitySqliteWriteResult;
+    acquireLease(input: ContinuityLeaseWriteInput): ContinuitySqliteWriteResult;
+    releaseLease(input: ContinuityLeaseReleaseInput): ContinuitySqliteWriteResult;
+    recordStateSnapshot(input: ContinuityStateSnapshotWriteInput): ContinuitySqliteWriteResult;
+    recordArtifact(input: ContinuityArtifactWriteInput): ContinuitySqliteWriteResult;
+    enqueueOutbox(input: ContinuityOutboxWriteInput): ContinuitySqliteWriteResult;
+    selectOutboxBatch(options: ContinuityOutboxBatchQueryOptions): readonly ContinuityOutboxDeliveryRow[];
+    markOutboxSent(input: ContinuityOutboxMarkSentInput): ContinuityOutboxTransitionResult;
+    ackOutbox(input: ContinuityOutboxAckInput): ContinuityOutboxTransitionResult;
+    failOutboxDelivery(input: ContinuityOutboxFailInput): ContinuityOutboxTransitionResult;
+    deadLetterOutbox(input: ContinuityOutboxDeadLetterInput): ContinuityOutboxTransitionResult;
+    retryOutboxEntries(options: ContinuityOutboxRetryOptions): ContinuityOutboxRetryResult;
+    upsertGoalCampaign(input: ContinuityGoalCampaignWriteInput): ContinuitySqliteWriteResult;
+    upsertGoalLedgerItem(input: ContinuityGoalLedgerItemWriteInput): ContinuitySqliteWriteResult;
+    upsertGoalVerifier(input: ContinuityGoalVerifierWriteInput): ContinuitySqliteWriteResult;
+    upsertGoalReviewGate(input: ContinuityGoalReviewGateWriteInput): ContinuitySqliteWriteResult;
+    recordOperationAudit(input: ContinuityOperationAuditInput): ContinuitySqliteWriteResult;
+    hasOperationRef(operationId: string, idempotencyKey?: string): boolean;
+    jobExists(jobId: string): boolean;
+    private getHeadlessExecutionAttempt;
+    private getOutboxTransitionRow;
+    private selectReceiptRetentionCandidates;
+    private selectOutputRetentionCandidates;
+    private deleteRetentionCandidates;
+    private preserveReceiptDerivedIteration;
+    private retainedReceiptOutputCounts;
+    private pruneReceiptCompactionSummaries;
+    runInTransaction<T>(fn: () => T): T;
+    collectSnapshotRows(options: ContinuitySnapshotQueryOptions): ContinuitySnapshotQueryResult;
+    listProcessingOutputSummaries(options?: ContinuityProcessingOutputSummaryQueryOptions): readonly ContinuityProcessingOutputSummaryRow[];
+    pollProcessingOutputSummaries(options?: ContinuityProcessingOutputSummaryCursorQueryOptions): ContinuityProcessingOutputSummaryCursorQueryResult;
+    listDueJobs(options: ContinuityDueJobQueryOptions): readonly ContinuityDueJobRow[];
+    recoverStaleLeases(options: ContinuityStaleLeaseRecoveryOptions): ContinuityStaleLeaseRecoveryResult;
+    recoverStaleHeadlessExecutionAttempts(options: ContinuityHeadlessExecutionStaleRecoveryOptions): ContinuityHeadlessExecutionStaleRecoveryResult;
+    private ensureGoalCampaign;
+    private configureConnection;
+    private ensureMigrationTable;
+    private applyMigrations;
+    private assertCanMutate;
+    private toWriteResult;
+}
+export {};