@paraharness/sqlite 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Tornike Tsomaia
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -1,3 +1,65 @@
-# Temporary Holding Version
+# @paraharness/sqlite
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+WAL-mode SQLite runtime drivers and declarative `sqlite.*` builders for [Paraharness](https://github.com/paraharness/paraharness). This package provides single-node durable persistence for `LedgerStore`, Copy-on-Write `TopologyStore`, `LessonStore`, and relational global rules sources backed by `better-sqlite3`.
+
+## Installation
+
+With npm:
+
+```bash
+npm install @paraharness/sqlite @paraharness/core zod
+```
+
+With yarn:
+
+```bash
+yarn add @paraharness/sqlite @paraharness/core zod
+```
+
+With pnpm:
+
+```bash
+pnpm add @paraharness/sqlite @paraharness/core zod
+```
+
+## Usage
+
+```ts
+import { P, z } from '@paraharness/core';
+import { createExecutorRegistry } from '@paraharness/core/runtime';
+import { sqlite, sqliteExecutors } from '@paraharness/sqlite';
+
+const TaskInput = z.object({
+  id: z.string(),
+  prompt: z.string(),
+});
+
+const ledger = sqlite
+  .ledger('.harness/state.sqlite')
+  .compactWhen(($c) =>
+    $c
+      .onTerminalExit(['done', 'cancelled'], { afterGracePeriodHours: 24 })
+      .retainFailedRunsForDays(14),
+  );
+
+const repoTopology = P.topology('repo-topology')
+  .store(sqlite.topologyStore('.harness/state.sqlite'))
+  .partitions({
+    db: {},
+    api: { dependsOn: ['db'] },
+  });
+
+const repoLessons = P.lessons('repo-lessons')
+  .store(sqlite.lessonStore('.harness/state.sqlite'))
+  .queryFrom(TaskInput, (item) => item.prompt);
+
+const registry = createExecutorRegistry(sqliteExecutors);
+```
+
+## Documentation
+
+See the [`@paraharness/sqlite` API Reference](https://paraharness.github.io/paraharness/modules/_paraharness_sqlite.html) for full type and builder specifications.
+
+## License
+
+[MIT](./LICENSE) © Tornike Tsomaia

package/dist/builders/compaction-config-builder.d.ts

@@ -0,0 +1,66 @@
+import type { AstBuilder, CompactionConfigNode, MaybeBuilder, SignalNode } from '@paraharness/core';
+/**
+ * Options for configuring a signal-correlated ledger compaction trigger via `CompactionConfigBuilder.onSignal`.
+ *
+ * Maps an incoming signal payload to its target `itemKey` and specifies the grace period before raw wire frames are pruned.
+ *
+ * @template TSig Signal payload type.
+ */
+export interface CompactionSignalTriggerOptions<TSig = unknown> {
+    /** Pure function extracting the correlated `itemKey` from the signal payload. */
+    readonly correlateBy: (sig: TSig) => string;
+    /** Non-negative retention grace period in hours after signal arrival before pruning raw wire frames. */
+    readonly afterGracePeriodHours: number;
+}
+/**
+ * Options for configuring a terminal exit state compaction trigger via `CompactionConfigBuilder.onTerminalExit`.
+ *
+ * Specifies the retention grace period in hours after a run reaches a configured terminal flow state.
+ */
+export interface CompactionTerminalExitOptions {
+    /** Non-negative retention grace period in hours after terminal exit before pruning raw wire frames. */
+    readonly afterGracePeriodHours: number;
+}
+/**
+ * Fluent configurator for SQLite and PostgreSQL ledger wire-frame compaction policies (`.compactWhen($c => ...)`).
+ *
+ * Schedules raw wire-frame pruning for terminal runs based on correlated signals,
+ * terminal flow exit states, and failed-run retention windows.
+ */
+export interface CompactionConfigBuilder extends AstBuilder<CompactionConfigNode> {
+    /**
+     * Registers a signal-driven compaction trigger correlated to a completed run's `itemKey`.
+     *
+     * Schedules raw wire-frame pruning once `signal` arrives and `options.afterGracePeriodHours` elapses.
+     *
+     * @template TSig Signal payload type.
+     *
+     * @param {MaybeBuilder<SignalNode<TSig>>}      signal  - Target signal AST node or builder.
+     * @param {CompactionSignalTriggerOptions<TSig>} options - Correlation mapper and grace period in hours.
+     *
+     * @returns {CompactionConfigBuilder} Updated immutable compaction configuration builder.
+     */
+    onSignal<TSig>(signal: MaybeBuilder<SignalNode<TSig>>, options: CompactionSignalTriggerOptions<TSig>): CompactionConfigBuilder;
+    /**
+     * Registers a terminal exit state compaction trigger for completed runs.
+     *
+     * Schedules raw wire-frame pruning once a run reaches one of `states` and `options.afterGracePeriodHours` elapses.
+     *
+     * @param {readonly string[]}             states  - Terminal flow exit states that arm compaction.
+     * @param {CompactionTerminalExitOptions} options - Grace period in hours after terminal exit.
+     *
+     * @returns {CompactionConfigBuilder} Updated immutable compaction configuration builder.
+     */
+    onTerminalExit(states: readonly string[], options: CompactionTerminalExitOptions): CompactionConfigBuilder;
+    /**
+     * Sets the retention window in days for failed or exhausted runs before raw wire frames are pruned.
+     *
+     * Preserves failed run wire frames for post-mortem debugging across `days` days.
+     *
+     * @param {number} days - Positive retention window in days.
+     *
+     * @returns {CompactionConfigBuilder} Updated immutable compaction configuration builder.
+     */
+    retainFailedRunsForDays(days: number): CompactionConfigBuilder;
+}
+//# sourceMappingURL=compaction-config-builder.d.ts.map

package/dist/builders/compaction-config-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction-config-builder.d.ts","sourceRoot":"","sources":["../../src/builders/compaction-config-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpG;;;;;;GAMG;AACH,MAAM,WAAW,8BAA8B,CAAC,IAAI,GAAG,OAAO;IAC5D,iFAAiF;IACjF,QAAQ,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,IAAI,KAAK,MAAM,CAAC;IAC5C,wGAAwG;IACxG,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;CACxC;AAED;;;;GAIG;AACH,MAAM,WAAW,6BAA6B;IAC5C,uGAAuG;IACvG,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;CACxC;AAED;;;;;GAKG;AACH,MAAM,WAAW,uBAAwB,SAAQ,UAAU,CAAC,oBAAoB,CAAC;IAC/E;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,IAAI,EACX,MAAM,EAAE,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EACtC,OAAO,EAAE,8BAA8B,CAAC,IAAI,CAAC,GAC5C,uBAAuB,CAAC;IAE3B;;;;;;;;;OASG;IACH,cAAc,CACZ,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,OAAO,EAAE,6BAA6B,GACrC,uBAAuB,CAAC;IAE3B;;;;;;;;OAQG;IACH,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,uBAAuB,CAAC;CAChE"}

package/dist/builders/compaction-config-builder.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=compaction-config-builder.js.map

package/dist/builders/compaction-config-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction-config-builder.js","sourceRoot":"","sources":["../../src/builders/compaction-config-builder.ts"],"names":[],"mappings":""}

package/dist/builders/create-compaction-config-builder.d.ts

@@ -0,0 +1,14 @@
+import type { CompactionConfigBuilder } from './compaction-config-builder.js';
+import type { CompactionConfigBuilderState } from './internal/compaction-config-builder-state.js';
+/**
+ * Creates an immutable `CompactionConfigBuilder` instance for ledger wire-frame pruning policies.
+ *
+ * Provides copy-on-write methods for configuring signal-correlated compaction triggers,
+ * terminal-state compaction triggers, and failed-run retention windows without side effects.
+ *
+ * @param {CompactionConfigBuilderState} [state] - Optional internal copy-on-write builder state.
+ *
+ * @returns {CompactionConfigBuilder} Frozen compaction configuration builder.
+ */
+export declare function createCompactionConfigBuilder(state?: CompactionConfigBuilderState): CompactionConfigBuilder;
+//# sourceMappingURL=create-compaction-config-builder.d.ts.map

package/dist/builders/create-compaction-config-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-compaction-config-builder.d.ts","sourceRoot":"","sources":["../../src/builders/create-compaction-config-builder.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,uBAAuB,EAGxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,+CAA+C,CAAC;AAElG;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,CAAC,EAAE,4BAA4B,GACnC,uBAAuB,CAmEzB"}

package/dist/builders/create-compaction-config-builder.js

@@ -0,0 +1,66 @@
+import { extractAST, } from '@paraharness/core';
+/**
+ * Creates an immutable `CompactionConfigBuilder` instance for ledger wire-frame pruning policies.
+ *
+ * Provides copy-on-write methods for configuring signal-correlated compaction triggers,
+ * terminal-state compaction triggers, and failed-run retention windows without side effects.
+ *
+ * @param {CompactionConfigBuilderState} [state] - Optional internal copy-on-write builder state.
+ *
+ * @returns {CompactionConfigBuilder} Frozen compaction configuration builder.
+ */
+export function createCompactionConfigBuilder(state) {
+    const signalTriggers = state?.signalTriggers ?? [];
+    const terminalExitTriggers = state?.terminalExitTriggers ?? [];
+    const retainFailedRunsForDays = state?.retainFailedRunsForDays;
+    return Object.freeze({
+        onSignal(signal, options) {
+            if (!Number.isFinite(options.afterGracePeriodHours) || options.afterGracePeriodHours < 0) {
+                throw new Error(`Invalid compaction afterGracePeriodHours '${String(options.afterGracePeriodHours)}': expected a non-negative finite number.`);
+            }
+            const nextTrigger = Object.freeze({
+                signal: extractAST(signal),
+                correlateBy: options.correlateBy,
+                afterGracePeriodHours: options.afterGracePeriodHours,
+            });
+            return createCompactionConfigBuilder({
+                signalTriggers: Object.freeze([...signalTriggers, nextTrigger]),
+                terminalExitTriggers,
+                retainFailedRunsForDays,
+            });
+        },
+        onTerminalExit(states, options) {
+            if (!Number.isFinite(options.afterGracePeriodHours) || options.afterGracePeriodHours < 0) {
+                throw new Error(`Invalid compaction afterGracePeriodHours '${String(options.afterGracePeriodHours)}': expected a non-negative finite number.`);
+            }
+            const nextTrigger = Object.freeze({
+                states: Object.freeze([...states]),
+                afterGracePeriodHours: options.afterGracePeriodHours,
+            });
+            return createCompactionConfigBuilder({
+                signalTriggers,
+                terminalExitTriggers: Object.freeze([...terminalExitTriggers, nextTrigger]),
+                retainFailedRunsForDays,
+            });
+        },
+        retainFailedRunsForDays(days) {
+            if (!Number.isFinite(days) || days <= 0) {
+                throw new Error(`Invalid retainFailedRunsForDays '${String(days)}': expected a positive finite number.`);
+            }
+            return createCompactionConfigBuilder({
+                signalTriggers,
+                terminalExitTriggers,
+                retainFailedRunsForDays: days,
+            });
+        },
+        toAST() {
+            return Object.freeze({
+                type: 'harness:compaction',
+                signalTriggers: Object.freeze([...signalTriggers]),
+                terminalExitTriggers: Object.freeze([...terminalExitTriggers]),
+                retainFailedRunsForDays,
+            });
+        },
+    });
+}
+//# sourceMappingURL=create-compaction-config-builder.js.map

package/dist/builders/create-compaction-config-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-compaction-config-builder.js","sourceRoot":"","sources":["../../src/builders/create-compaction-config-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,UAAU,GACX,MAAM,mBAAmB,CAAC;AAQ3B;;;;;;;;;GASG;AACH,MAAM,UAAU,6BAA6B,CAC3C,KAAoC;IAEpC,MAAM,cAAc,GAAuC,KAAK,EAAE,cAAc,IAAI,EAAE,CAAC;IACvF,MAAM,oBAAoB,GACxB,KAAK,EAAE,oBAAoB,IAAI,EAAE,CAAC;IACpC,MAAM,uBAAuB,GAAG,KAAK,EAAE,uBAAuB,CAAC;IAE/D,OAAO,MAAM,CAAC,MAAM,CAA0B;QAC5C,QAAQ,CACN,MAAsC,EACtC,OAA6C;YAE7C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,qBAAqB,CAAC,IAAI,OAAO,CAAC,qBAAqB,GAAG,CAAC,EAAE,CAAC;gBACzF,MAAM,IAAI,KAAK,CACb,6CAA6C,MAAM,CAAC,OAAO,CAAC,qBAAqB,CAAC,2CAA2C,CAC9H,CAAC;YACJ,CAAC;YACD,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAgC;gBAC/D,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC;gBAC1B,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,qBAAqB,EAAE,OAAO,CAAC,qBAAqB;aACrD,CAAC,CAAC;YACH,OAAO,6BAA6B,CAAC;gBACnC,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,cAAc,EAAE,WAAW,CAAC,CAAC;gBAC/D,oBAAoB;gBACpB,uBAAuB;aACxB,CAAC,CAAC;QACL,CAAC;QACD,cAAc,CACZ,MAAyB,EACzB,OAAsC;YAEtC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,qBAAqB,CAAC,IAAI,OAAO,CAAC,qBAAqB,GAAG,CAAC,EAAE,CAAC;gBACzF,MAAM,IAAI,KAAK,CACb,6CAA6C,MAAM,CAAC,OAAO,CAAC,qBAAqB,CAAC,2CAA2C,CAC9H,CAAC;YACJ,CAAC;YACD,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAgC;gBAC/D,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;gBAClC,qBAAqB,EAAE,OAAO,CAAC,qBAAqB;aACrD,CAAC,CAAC;YACH,OAAO,6BAA6B,CAAC;gBACnC,cAAc;gBACd,oBAAoB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,oBAAoB,EAAE,WAAW,CAAC,CAAC;gBAC3E,uBAAuB;aACxB,CAAC,CAAC;QACL,CAAC;QACD,uBAAuB,CAAC,IAAY;YAClC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;gBACxC,MAAM,IAAI,KAAK,CACb,oCAAoC,MAAM,CAAC,IAAI,CAAC,uCAAuC,CACxF,CAAC;YACJ,CAAC;YACD,OAAO,6BAA6B,CAAC;gBACnC,cAAc;gBACd,oBAAoB;gBACpB,uBAAuB,EAAE,IAAI;aAC9B,CAAC,CAAC;QACL,CAAC;QACD,KAAK;YACH,OAAO,MAAM,CAAC,MAAM,CAAuB;gBACzC,IAAI,EAAE,oBAAoB;gBAC1B,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC;gBAClD,oBAAoB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,oBAAoB,CAAC,CAAC;gBAC9D,uBAAuB;aACxB,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/builders/create-sqlite-global-rules-builder.d.ts

@@ -0,0 +1,15 @@
+import type { SqliteGlobalRulesBuilder } from './sqlite-global-rules-builder.js';
+import type { SqliteGlobalRulesOptions } from './sqlite-namespace-contract.js';
+/**
+ * Creates an immutable `SqliteGlobalRulesBuilder` for `uri` and `options.table`.
+ *
+ * Validates `options.table` against `^[A-Za-z_][A-Za-z0-9_]*$` at builder construction time
+ * to prevent SQL injection when querying global rule rows.
+ *
+ * @param {string}                   uri     - Host-root-relative SQLite database file path or `:memory:` URI.
+ * @param {SqliteGlobalRulesOptions} options - Table name and optional source node ID.
+ *
+ * @returns {SqliteGlobalRulesBuilder} Frozen SQLite global rules source builder.
+ */
+export declare function createSqliteGlobalRulesBuilder(uri: string, options: SqliteGlobalRulesOptions): SqliteGlobalRulesBuilder;
+//# sourceMappingURL=create-sqlite-global-rules-builder.d.ts.map

package/dist/builders/create-sqlite-global-rules-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-sqlite-global-rules-builder.d.ts","sourceRoot":"","sources":["../../src/builders/create-sqlite-global-rules-builder.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AACjF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAE/E;;;;;;;;;;GAUG;AACH,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,wBAAwB,GAChC,wBAAwB,CAgB1B"}

package/dist/builders/create-sqlite-global-rules-builder.js

@@ -0,0 +1,30 @@
+import { assertValidSqlIdentifier } from '../ddl/internal/open-sqlite-connection.js';
+/**
+ * Creates an immutable `SqliteGlobalRulesBuilder` for `uri` and `options.table`.
+ *
+ * Validates `options.table` against `^[A-Za-z_][A-Za-z0-9_]*$` at builder construction time
+ * to prevent SQL injection when querying global rule rows.
+ *
+ * @param {string}                   uri     - Host-root-relative SQLite database file path or `:memory:` URI.
+ * @param {SqliteGlobalRulesOptions} options - Table name and optional source node ID.
+ *
+ * @returns {SqliteGlobalRulesBuilder} Frozen SQLite global rules source builder.
+ */
+export function createSqliteGlobalRulesBuilder(uri, options) {
+    if (uri.trim().length === 0) {
+        throw new Error('sqlite.globalRules(uri, options) requires a non-empty database URI.');
+    }
+    assertValidSqlIdentifier(options.table, 'table');
+    const sourceId = options.id ?? `sqlite:global-rules:${uri}:${options.table}`;
+    return Object.freeze({
+        toAST() {
+            return Object.freeze({
+                type: 'sqlite:global-rules',
+                id: sourceId,
+                uri,
+                table: options.table,
+            });
+        },
+    });
+}
+//# sourceMappingURL=create-sqlite-global-rules-builder.js.map

package/dist/builders/create-sqlite-global-rules-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-sqlite-global-rules-builder.js","sourceRoot":"","sources":["../../src/builders/create-sqlite-global-rules-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAIrF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,8BAA8B,CAC5C,GAAW,EACX,OAAiC;IAEjC,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IACzF,CAAC;IACD,wBAAwB,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,OAAO,CAAC,EAAE,IAAI,uBAAuB,GAAG,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAC7E,OAAO,MAAM,CAAC,MAAM,CAA2B;QAC7C,KAAK;YACH,OAAO,MAAM,CAAC,MAAM,CAAwB;gBAC1C,IAAI,EAAE,qBAAqB;gBAC3B,EAAE,EAAE,QAAQ;gBACZ,GAAG;gBACH,KAAK,EAAE,OAAO,CAAC,KAAK;aACrB,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/builders/create-sqlite-ledger-builder.d.ts

@@ -0,0 +1,15 @@
+import type { CompactionConfigNode } from '@paraharness/core';
+import type { SqliteLedgerBuilder } from './sqlite-ledger-builder.js';
+/**
+ * Creates an immutable `SqliteLedgerBuilder` targeting `uri`.
+ *
+ * Validates that `uri` is non-empty and produces passive `SqliteLedgerNode` AST descriptors
+ * with zero import-time or builder-time filesystem I/O.
+ *
+ * @param {string}               uri          - Host-root-relative SQLite file path or `:memory:` URI.
+ * @param {CompactionConfigNode} [compaction] - Optional pre-compiled compaction configuration node.
+ *
+ * @returns {SqliteLedgerBuilder} Frozen SQLite ledger AST builder.
+ */
+export declare function createSqliteLedgerBuilder(uri: string, compaction?: CompactionConfigNode): SqliteLedgerBuilder;
+//# sourceMappingURL=create-sqlite-ledger-builder.d.ts.map

package/dist/builders/create-sqlite-ledger-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-sqlite-ledger-builder.d.ts","sourceRoot":"","sources":["../../src/builders/create-sqlite-ledger-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAoB,MAAM,mBAAmB,CAAC;AAGhF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,MAAM,EACX,UAAU,CAAC,EAAE,oBAAoB,GAChC,mBAAmB,CAmBrB"}

package/dist/builders/create-sqlite-ledger-builder.js

@@ -0,0 +1,31 @@
+import { createCompactionConfigBuilder } from './create-compaction-config-builder.js';
+/**
+ * Creates an immutable `SqliteLedgerBuilder` targeting `uri`.
+ *
+ * Validates that `uri` is non-empty and produces passive `SqliteLedgerNode` AST descriptors
+ * with zero import-time or builder-time filesystem I/O.
+ *
+ * @param {string}               uri          - Host-root-relative SQLite file path or `:memory:` URI.
+ * @param {CompactionConfigNode} [compaction] - Optional pre-compiled compaction configuration node.
+ *
+ * @returns {SqliteLedgerBuilder} Frozen SQLite ledger AST builder.
+ */
+export function createSqliteLedgerBuilder(uri, compaction) {
+    if (uri.trim().length === 0) {
+        throw new Error('sqlite.ledger(uri) requires a non-empty database URI.');
+    }
+    return Object.freeze({
+        compactWhen(configure) {
+            const nextCompaction = configure(createCompactionConfigBuilder()).toAST();
+            return createSqliteLedgerBuilder(uri, nextCompaction);
+        },
+        toAST() {
+            return Object.freeze({
+                type: 'sqlite:ledger',
+                uri,
+                compaction,
+            });
+        },
+    });
+}
+//# sourceMappingURL=create-sqlite-ledger-builder.js.map

package/dist/builders/create-sqlite-ledger-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-sqlite-ledger-builder.js","sourceRoot":"","sources":["../../src/builders/create-sqlite-ledger-builder.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,6BAA6B,EAAE,MAAM,uCAAuC,CAAC;AAGtF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,yBAAyB,CACvC,GAAW,EACX,UAAiC;IAEjC,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAsB;QACxC,WAAW,CACT,SAAwE;YAExE,MAAM,cAAc,GAAG,SAAS,CAAC,6BAA6B,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;YAC1E,OAAO,yBAAyB,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QACxD,CAAC;QACD,KAAK;YACH,OAAO,MAAM,CAAC,MAAM,CAAmB;gBACrC,IAAI,EAAE,eAAe;gBACrB,GAAG;gBACH,UAAU;aACX,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/builders/create-sqlite-lessons-builder.d.ts

@@ -0,0 +1,12 @@
+import type { SqliteLessonsBuilder } from './sqlite-lessons-builder.js';
+/**
+ * Creates an immutable `SqliteLessonsBuilder` targeting `uri`.
+ *
+ * Validates that `uri` is non-empty and emits a frozen `SqliteLessonsNode` AST node on `.toAST()`.
+ *
+ * @param {string} uri - Host-root-relative SQLite database file path or `:memory:` URI.
+ *
+ * @returns {SqliteLessonsBuilder} Frozen SQLite lesson store builder.
+ */
+export declare function createSqliteLessonsBuilder(uri: string): SqliteLessonsBuilder;
+//# sourceMappingURL=create-sqlite-lessons-builder.d.ts.map

package/dist/builders/create-sqlite-lessons-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-sqlite-lessons-builder.d.ts","sourceRoot":"","sources":["../../src/builders/create-sqlite-lessons-builder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAExE;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,CAY5E"}

package/dist/builders/create-sqlite-lessons-builder.js

@@ -0,0 +1,23 @@
+/**
+ * Creates an immutable `SqliteLessonsBuilder` targeting `uri`.
+ *
+ * Validates that `uri` is non-empty and emits a frozen `SqliteLessonsNode` AST node on `.toAST()`.
+ *
+ * @param {string} uri - Host-root-relative SQLite database file path or `:memory:` URI.
+ *
+ * @returns {SqliteLessonsBuilder} Frozen SQLite lesson store builder.
+ */
+export function createSqliteLessonsBuilder(uri) {
+    if (uri.trim().length === 0) {
+        throw new Error('sqlite.lessonStore(uri) requires a non-empty database URI.');
+    }
+    return Object.freeze({
+        toAST() {
+            return Object.freeze({
+                type: 'sqlite:lessons',
+                uri,
+            });
+        },
+    });
+}
+//# sourceMappingURL=create-sqlite-lessons-builder.js.map

package/dist/builders/create-sqlite-lessons-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-sqlite-lessons-builder.js","sourceRoot":"","sources":["../../src/builders/create-sqlite-lessons-builder.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,MAAM,UAAU,0BAA0B,CAAC,GAAW;IACpD,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAuB;QACzC,KAAK;YACH,OAAO,MAAM,CAAC,MAAM,CAAoB;gBACtC,IAAI,EAAE,gBAAgB;gBACtB,GAAG;aACJ,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/builders/create-sqlite-topology-builder.d.ts

@@ -0,0 +1,12 @@
+import type { SqliteTopologyBuilder } from './sqlite-topology-builder.js';
+/**
+ * Creates an immutable `SqliteTopologyBuilder` targeting `uri`.
+ *
+ * Validates that `uri` is non-empty and emits a frozen `SqliteTopologyNode` AST node on `.toAST()`.
+ *
+ * @param {string} uri - Host-root-relative SQLite database file path or `:memory:` URI.
+ *
+ * @returns {SqliteTopologyBuilder} Frozen SQLite topology store builder.
+ */
+export declare function createSqliteTopologyBuilder(uri: string): SqliteTopologyBuilder;
+//# sourceMappingURL=create-sqlite-topology-builder.d.ts.map

package/dist/builders/create-sqlite-topology-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-sqlite-topology-builder.d.ts","sourceRoot":"","sources":["../../src/builders/create-sqlite-topology-builder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAE1E;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB,CAY9E"}

package/dist/builders/create-sqlite-topology-builder.js

@@ -0,0 +1,23 @@
+/**
+ * Creates an immutable `SqliteTopologyBuilder` targeting `uri`.
+ *
+ * Validates that `uri` is non-empty and emits a frozen `SqliteTopologyNode` AST node on `.toAST()`.
+ *
+ * @param {string} uri - Host-root-relative SQLite database file path or `:memory:` URI.
+ *
+ * @returns {SqliteTopologyBuilder} Frozen SQLite topology store builder.
+ */
+export function createSqliteTopologyBuilder(uri) {
+    if (uri.trim().length === 0) {
+        throw new Error('sqlite.topologyStore(uri) requires a non-empty database URI.');
+    }
+    return Object.freeze({
+        toAST() {
+            return Object.freeze({
+                type: 'sqlite:topology',
+                uri,
+            });
+        },
+    });
+}
+//# sourceMappingURL=create-sqlite-topology-builder.js.map

package/dist/builders/create-sqlite-topology-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-sqlite-topology-builder.js","sourceRoot":"","sources":["../../src/builders/create-sqlite-topology-builder.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,MAAM,UAAU,2BAA2B,CAAC,GAAW;IACrD,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAwB;QAC1C,KAAK;YACH,OAAO,MAAM,CAAC,MAAM,CAAqB;gBACvC,IAAI,EAAE,iBAAiB;gBACvB,GAAG;aACJ,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/builders/internal/compaction-config-builder-state.d.ts

@@ -0,0 +1,16 @@
+import type { CompactionSignalTrigger, CompactionTerminalExitTrigger } from '@paraharness/core';
+/**
+ * Immutable internal state snapshot for `createCompactionConfigBuilder`.
+ *
+ * Accumulates signal triggers, terminal-state triggers, and failed-run retention windows
+ * across copy-on-write builder transitions.
+ */
+export interface CompactionConfigBuilderState {
+    /** Signal-driven compaction triggers accumulated on the builder. */
+    readonly signalTriggers?: readonly CompactionSignalTrigger[];
+    /** Terminal exit state triggers accumulated on the builder. */
+    readonly terminalExitTriggers?: readonly CompactionTerminalExitTrigger[];
+    /** Optional retention window in days for failed runs. */
+    readonly retainFailedRunsForDays?: number;
+}
+//# sourceMappingURL=compaction-config-builder-state.d.ts.map

package/dist/builders/internal/compaction-config-builder-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction-config-builder-state.d.ts","sourceRoot":"","sources":["../../../src/builders/internal/compaction-config-builder-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AAEhG;;;;;GAKG;AACH,MAAM,WAAW,4BAA4B;IAC3C,oEAAoE;IACpE,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC7D,+DAA+D;IAC/D,QAAQ,CAAC,oBAAoB,CAAC,EAAE,SAAS,6BAA6B,EAAE,CAAC;IACzE,yDAAyD;IACzD,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAC3C"}

package/dist/builders/internal/compaction-config-builder-state.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=compaction-config-builder-state.js.map

package/dist/builders/internal/compaction-config-builder-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction-config-builder-state.js","sourceRoot":"","sources":["../../../src/builders/internal/compaction-config-builder-state.ts"],"names":[],"mappings":""}

package/dist/builders/sqlite-global-rules-builder.d.ts

@@ -0,0 +1,17 @@
+import type { AstBuilder, SqliteRulesSourceNode } from '@paraharness/core';
+/**
+ * Fluent builder for a passive `SqliteRulesSourceNode` (`sqlite.globalRules(uri, { table })`).
+ *
+ * Emits a declarative source descriptor that loads ordered `(id, directive)` global rules from SQLite.
+ */
+export interface SqliteGlobalRulesBuilder extends AstBuilder<SqliteRulesSourceNode> {
+    /**
+     * Compiles the builder into an immutable `SqliteRulesSourceNode` AST descriptor.
+     *
+     * Preserves the validated SQLite URI and table identifier for runtime source execution.
+     *
+     * @returns {SqliteRulesSourceNode} Frozen passive `SqliteRulesSourceNode`.
+     */
+    toAST(): SqliteRulesSourceNode;
+}
+//# sourceMappingURL=sqlite-global-rules-builder.d.ts.map

package/dist/builders/sqlite-global-rules-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-global-rules-builder.d.ts","sourceRoot":"","sources":["../../src/builders/sqlite-global-rules-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE3E;;;;GAIG;AACH,MAAM,WAAW,wBAAyB,SAAQ,UAAU,CAAC,qBAAqB,CAAC;IACjF;;;;;;OAMG;IACH,KAAK,IAAI,qBAAqB,CAAC;CAChC"}

package/dist/builders/sqlite-global-rules-builder.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sqlite-global-rules-builder.js.map

package/dist/builders/sqlite-global-rules-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-global-rules-builder.js","sourceRoot":"","sources":["../../src/builders/sqlite-global-rules-builder.ts"],"names":[],"mappings":""}

package/dist/builders/sqlite-ledger-builder.d.ts

@@ -0,0 +1,21 @@
+import type { AstBuilder, SqliteLedgerNode } from '@paraharness/core';
+import type { CompactionConfigBuilder } from './compaction-config-builder.js';
+/**
+ * Fluent builder for a passive `SqliteLedgerNode` (`sqlite.ledger(uri)`).
+ *
+ * Configures a WAL-mode SQLite ledger store and optional wire-frame compaction triggers
+ * without opening database connections at declaration time.
+ */
+export interface SqliteLedgerBuilder extends AstBuilder<SqliteLedgerNode> {
+    /**
+     * Attaches a wire-frame compaction policy to the SQLite ledger store.
+     *
+     * Invokes `configure` with a fresh `CompactionConfigBuilder` and returns a new immutable ledger builder.
+     *
+     * @param {(builder: CompactionConfigBuilder) => CompactionConfigBuilder} configure - Pure configurator callback.
+     *
+     * @returns {SqliteLedgerBuilder} Updated immutable SQLite ledger builder.
+     */
+    compactWhen(configure: (builder: CompactionConfigBuilder) => CompactionConfigBuilder): SqliteLedgerBuilder;
+}
+//# sourceMappingURL=sqlite-ledger-builder.d.ts.map

package/dist/builders/sqlite-ledger-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-ledger-builder.d.ts","sourceRoot":"","sources":["../../src/builders/sqlite-ledger-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAE9E;;;;;GAKG;AACH,MAAM,WAAW,mBAAoB,SAAQ,UAAU,CAAC,gBAAgB,CAAC;IACvE;;;;;;;;OAQG;IACH,WAAW,CACT,SAAS,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,uBAAuB,GACvE,mBAAmB,CAAC;CACxB"}

package/dist/builders/sqlite-ledger-builder.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sqlite-ledger-builder.js.map

package/dist/builders/sqlite-ledger-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-ledger-builder.js","sourceRoot":"","sources":["../../src/builders/sqlite-ledger-builder.ts"],"names":[],"mappings":""}

package/dist/builders/sqlite-lessons-builder.d.ts

@@ -0,0 +1,18 @@
+import type { AstBuilder, SqliteLessonsNode } from '@paraharness/core';
+/**
+ * Fluent builder for a passive `SqliteLessonsNode` (`sqlite.lessonStore(uri)`).
+ *
+ * Produces a declarative lesson store descriptor backed by a WAL-mode SQLite database
+ * with zero I/O at AST construction time.
+ */
+export interface SqliteLessonsBuilder extends AstBuilder<SqliteLessonsNode> {
+    /**
+     * Compiles the builder into an immutable `SqliteLessonsNode` AST descriptor.
+     *
+     * Preserves the configured SQLite database URI for runtime driver resolution.
+     *
+     * @returns {SqliteLessonsNode} Frozen passive `SqliteLessonsNode`.
+     */
+    toAST(): SqliteLessonsNode;
+}
+//# sourceMappingURL=sqlite-lessons-builder.d.ts.map

package/dist/builders/sqlite-lessons-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-lessons-builder.d.ts","sourceRoot":"","sources":["../../src/builders/sqlite-lessons-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEvE;;;;;GAKG;AACH,MAAM,WAAW,oBAAqB,SAAQ,UAAU,CAAC,iBAAiB,CAAC;IACzE;;;;;;OAMG;IACH,KAAK,IAAI,iBAAiB,CAAC;CAC5B"}

package/dist/builders/sqlite-lessons-builder.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sqlite-lessons-builder.js.map

package/dist/builders/sqlite-lessons-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-lessons-builder.js","sourceRoot":"","sources":["../../src/builders/sqlite-lessons-builder.ts"],"names":[],"mappings":""}