@jungjaehoon/mama-core 2.4.1 → 4.1.0

package/dist/db-adapter/node-sqlite-adapter.d.ts

@@ -3,7 +3,8 @@
  *
  * Keeps the existing DatabaseAdapter surface while avoiding external native addon installation.
  */
-import { DatabaseAdapter, type VectorSearchResult, type RunResult } from './base-adapter.js';
+import type { VectorSearchResult, RunResult } from './base-adapter.js';
+import type { DatabaseInstance } from '../db-manager.js';
 import { type Statement } from './statement.js';
 interface SQLiteAdapterConfig {
     dbPath?: string;
@@ -34,17 +35,25 @@ declare class NodeSQLiteConnection {
     close(): void;
     get open(): boolean;
 }
-export declare class NodeSQLiteAdapter extends DatabaseAdapter {
+/** One author of migrations, and where they live. */
+export interface MigrationSource {
+    /** Namespaces the version numbers. The core's own is `core`. */
+    readonly name: string;
+    readonly dir: string;
+}
+/** The core is one source among others; it is only first because others build on it. */
+export declare const CORE_MIGRATION_SOURCE = "core";
+export declare class NodeSQLiteAdapter implements DatabaseInstance {
+    private transactionDepth;
     private config;
     private db;
-    private _vectorSearchEnabled;
     private vectorCache;
     private topicCache;
+    private kindCache;
     private statusCache;
     private decisionsHasStatusColumns;
     private decisionsColumnInfoChecked;
     constructor(config?: SQLiteAdapterConfig);
-    get vectorSearchEnabled(): boolean;
     getDbPath(): string;
     connect(): NodeSQLiteConnection;
     reloadVectorCache(): void;
@@ -56,32 +65,93 @@ export declare class NodeSQLiteAdapter extends DatabaseAdapter {
     prepare(sql: string): Statement;
     exec(sql: string): void;
     transaction<T>(fn: () => T): T;
-    vectorSearch(embedding: Float32Array | number[], limit?: number, topicPrefix?: string, excludeStatuses?: readonly string[]): VectorSearchResult[] | null;
+    transactionImmediate<T>(fn: () => T): T;
+    private runTransaction;
+    vectorSearch(embedding: Float32Array | number[], limit?: number, topicPrefix?: string, excludeStatuses?: readonly string[], kind?: string | [string, ...string[]]): VectorSearchResult[] | null;
     insertEmbedding(rowid: number, embedding: Float32Array | number[]): RunResult | null;
     getLastInsertRowid(): number;
-    runMigrations(migrationsDir: string): void;
+    /**
+     * Run migrations from one source, or from several in order.
+     *
+     * A migration belongs to whoever wrote it, and its identity is (source,
+     * version). One author could key on the number alone; a second cannot, because
+     * the next number is already spoken for. Without this there is nowhere for a
+     * package's own table to live except inside the core.
+     *
+     * The core's source runs first and the rest follow, so a later source can
+     * reference what the core declared. A plain directory means the core's own.
+     */
+    /**
+     * Record that one source's migration ran. Before (source, version) there was
+     * one author, so the column did not exist; a database that has not reached 085
+     * yet still has the old shape and is still the core's.
+     */
+    private stampMigration;
+    runMigrations(sources: string | readonly MigrationSource[]): void;
+    private runMigrationSource;
     private repairSkippedFeatureMigrations;
+    private repairRegistryIdentityStructures;
+    private rebuildRegistry069;
+    private rebuildRecordActors070;
     private applyRepairMigration;
+    private rebuildWorkflowMemoryKind098;
     private operatorMemoryCommitIntentTableSql;
     private hasOperatorMemoryCommitIntentClaimInvariant;
     private assertMigration040BaseComplete;
     private assertMigration041Complete;
     private needsToolTraceDiagnosticsRepair068;
     private recoverToolTraceDiagnosticsMigration068;
+    private toolTracesTableSql;
+    private tableSql;
+    private storedObjectsForTable;
+    private tablesInForeignKeyGraph;
+    private observationVersionsShape072;
+    private needsObservationVersionsRepair072;
+    private recoverObservationVersionsMigration072;
+    private registryCorrectionsShape073;
+    private needsRegistryCorrectionsRepair073;
+    private recoverRegistryCorrectionsMigration073;
+    private workGraphRefsShape074;
+    private needsWorkGraphRefsRepair074;
+    private recoverWorkGraphRefsMigration074;
+    /**
+     * 079 endpoint shape: the 074 work-graph shape plus the extended edge_type
+     * relation list ('refines','contradicts','amends') used by authored record
+     * links. `workGraphRefsShape074` already accepts this edge_type variant, so
+     * the extra check here is the only difference.
+     */
+    private twinEdgeRelationsShape079;
+    private needsTwinEdgeRelationsRepair079;
+    /**
+     * Rebuild twin_edges with the extended relation CHECK while preserving every
+     * existing column (including runtime-added custom columns), index, trigger,
+     * and foreign-key child - the same contract recoverWorkGraphRefsMigration074
+     * honours. Only the edge_type clause is rewritten; a table already carrying
+     * the extended list is just stamped.
+     */
+    private recoverTwinEdgeRelationsMigration079;
+    private legacyRecordKindShape077;
+    private recoverLegacyRecordKindMigration077;
+    private toolTracesHasOperationOriginShape;
+    private needsServiceOperationOriginsRepair071;
+    private readForeignKeysEnabled;
+    /**
+     * tool_traces plus every table that declares a FK referencing it. This is the
+     * relevant FK graph for the 071 rebuild: tool_traces' own model_runs reference
+     * and any child (e.g. an ON DELETE CASCADE table) whose rows the rebuild must
+     * have preserved. A valid child whose table name needs quoting (a space, an
+     * embedded quote, a reserved word) is inspected correctly too: the name is fed
+     * to the table-valued pragma as a bound argument, not interpolated -- so no
+     * referencing child is silently skipped by an identifier regex.
+     */
+    private tablesInToolTracesFkGraph;
+    private recoverServiceOperationOriginsMigration071;
     private recoverMemoryProvenanceMigration032;
     private assertMigration032Complete;
-    private recoverConnectorEventScopeMigration034;
-    private assertMigration034Complete;
-    private recoverConnectorEventSourceEntityIdMigration067;
-    private assertMigration067Complete;
-    private recoverConnectorEventOperatorSeqMigration039;
-    private assertMigration039Complete;
-    private recoverConnectorEventSequencesMigration062;
-    private assertMigration062Complete;
-    private recoverConnectorEventLegacyRefreshMigration063;
     private tableColumns;
     private tableExists;
     private indexExists;
+    private indexSql;
     private triggerExists;
     private schemaVersionExists;
     private migrateFromVssMemories;