@reqlan/analytical 0.9.1 → 0.10.1

package/out/{analysis-api.d.ts → native/native-analysis-api.d.ts}

@@ -1,6 +1,14 @@
-import type { CompletionSummary, DeprecationImpact, FileRelatedRequirements, GraphSlice, IdeaSummary } from './core/types.js';
-import type { AnalysisRuntime } from './create-runtime.js';
-import type { ExportProgressCallback, ExportRequest, ExportResult } from './export/types.js';
+/**
+ * AnalysisApi-compatible facade over the core Rust engine.
+ * rq:["../../../reqlan rq/core_analysis/rust_port.rq".native_bridge]
+ * rq:["../../../reqlan rq/core_analysis/rust_port.rq".ts_interface]
+ */
+import type { CompletionSummary, DeprecationImpact, FileRelatedRequirements, GraphSlice, IdeaSummary } from '../core/types.js';
+import type { ExportProgressCallback, ExportRequest, ExportResult } from '../export/types.js';
+export interface AnalysisRuntimeOptions {
+    workspaceRoot: string;
+    storagePath?: string;
+}
 export interface RequirementMatch {
     idea: IdeaSummary;
     score?: number;
@@ -15,9 +23,9 @@ export interface InteractionDescriptor {
     description: string;
     parameters: Record<string, string>;
 }
-export declare class AnalysisApi {
-    private readonly runtime;
-    constructor(runtime: AnalysisRuntime);
+export declare class NativeAnalysisApi {
+    private readonly native;
+    constructor(options: AnalysisRuntimeOptions);
     ensureReady(): Promise<void>;
     searchRequirements(query: string, limit?: number, options?: SearchRequirementsOptions): Promise<RequirementMatch[]>;
     listRequirements(limit?: number): Promise<IdeaSummary[]>;
@@ -26,27 +34,18 @@ export declare class AnalysisApi {
     summarizeSubtree(requirementName: string, depth?: number): Promise<GraphSlice | undefined>;
     getCompletionStatus(): Promise<CompletionSummary>;
     getDeprecationImpact(): Promise<DeprecationImpact[]>;
-    /**
-     * Export the indexed requirement graph as a multi-file static HTML site.
-     * Headless entry point shared by CLI and site build.
-     */
     exportHtml(request: Omit<ExportRequest, 'workspaceRoot'> & {
         workspaceRoot?: string;
-    }, onProgress?: ExportProgressCallback): Promise<ExportResult>;
-    /**
-     * Export the indexed requirement graph as markdown (README + optional idea pages).
-     */
+    }, _onProgress?: ExportProgressCallback): Promise<ExportResult>;
     exportMarkdown(request: Omit<ExportRequest, 'workspaceRoot'> & {
         workspaceRoot?: string;
-    }, onProgress?: ExportProgressCallback): Promise<ExportResult>;
-    /** Export structured JSON for tooling and AI consumption. */
+    }, _onProgress?: ExportProgressCallback): Promise<ExportResult>;
     exportJson(request: Omit<ExportRequest, 'workspaceRoot'> & {
         workspaceRoot?: string;
-    }, onProgress?: ExportProgressCallback): Promise<ExportResult>;
-    /** Export ideas/references as CSV with flattened tags and attributes. */
+    }, _onProgress?: ExportProgressCallback): Promise<ExportResult>;
     exportCsv(request: Omit<ExportRequest, 'workspaceRoot'> & {
         workspaceRoot?: string;
-    }, onProgress?: ExportProgressCallback): Promise<ExportResult>;
+    }, _onProgress?: ExportProgressCallback): Promise<ExportResult>;
     resolveRequirementReference(name?: string): Promise<IdeaSummary[]>;
     resolveFileReference(pathPrefix?: string): Promise<Array<{
         path: string;
@@ -54,4 +53,5 @@ export declare class AnalysisApi {
     }>>;
     listInteractions(): InteractionDescriptor[];
     formatIdea(idea: IdeaSummary): string;
+    private exportFormat;
 }

package/out/native/native-analysis-api.js

@@ -0,0 +1,212 @@
+import { loadNativeEngine } from './load-native.js';
+export class NativeAnalysisApi {
+    constructor(options) {
+        const engine = loadNativeEngine();
+        this.native = engine.NativeAnalysisRuntime.open(options.workspaceRoot, options.storagePath);
+    }
+    async ensureReady() {
+        this.native.ensureReady();
+    }
+    async searchRequirements(query, limit = 8, options) {
+        const matches = this.native.searchRequirements(query, limit, options?.context);
+        return matches.map(match => ({
+            idea: toIdea(match.idea),
+            score: match.score ?? undefined,
+            reasons: match.reasons ?? undefined
+        }));
+    }
+    async listRequirements(limit = 50) {
+        return this.native.listRequirements(limit).map(toIdea);
+    }
+    async getFileContext(filePath) {
+        const related = this.native.getFileContext(filePath);
+        return {
+            fileUri: related.fileUri,
+            ideasInFile: related.ideasInFile.map(toIdea),
+            referencingIdeas: related.referencingIdeas.map(toIdea),
+            commentLinkedIdeas: related.commentLinkedIdeas.map(toIdea),
+            folderReferencingIdeas: related.folderReferencingIdeas.map(toIdea)
+        };
+    }
+    async getLocalGraph(filePath, depth = 1) {
+        const graph = this.native.getLocalGraph(filePath, depth);
+        return graph ? toGraph(graph) : undefined;
+    }
+    async summarizeSubtree(requirementName, depth = 2) {
+        const graph = this.native.summarizeSubtree(requirementName, depth);
+        return graph ? toGraph(graph) : undefined;
+    }
+    async getCompletionStatus() {
+        const summary = this.native.getCompletionStatus();
+        return {
+            total: summary.total,
+            byStatus: toCountRecord(summary.byStatus),
+            byTag: toCountRecord(summary.byTag),
+            outstanding: summary.outstanding.map(toIdea),
+            deprecated: summary.deprecated.map(toIdea)
+        };
+    }
+    async getDeprecationImpact() {
+        const impacts = this.native.getDeprecationImpact();
+        return impacts.map(impact => ({
+            deprecated: toIdea(impact.deprecated),
+            dependents: impact.dependents.map(toIdea)
+        }));
+    }
+    async exportHtml(request, _onProgress) {
+        return this.exportFormat('html', request);
+    }
+    async exportMarkdown(request, _onProgress) {
+        return this.exportFormat('markdown', request);
+    }
+    async exportJson(request, _onProgress) {
+        return this.exportFormat('json', request);
+    }
+    async exportCsv(request, _onProgress) {
+        return this.exportFormat('csv', request);
+    }
+    async resolveRequirementReference(name) {
+        return this.native.resolveRequirementReference(name).map(toIdea);
+    }
+    async resolveFileReference(pathPrefix) {
+        return this.native.resolveFileReference(pathPrefix);
+    }
+    listInteractions() {
+        return [
+            {
+                name: 'search_requirements',
+                description: 'Search requirements by keyword across names, summaries, tags, and references.',
+                parameters: { query: 'Search text', limit: 'Optional maximum number of matches' }
+            },
+            {
+                name: 'list_requirements',
+                description: 'List indexed requirements in the workspace.',
+                parameters: { limit: 'Optional maximum number of requirements' }
+            },
+            {
+                name: 'file_context',
+                description: 'Get requirements in, referencing, or comment-linked to a file.',
+                parameters: { filePath: 'Relative or absolute path to a .rq file' }
+            },
+            {
+                name: 'local_graph',
+                description: 'Get the local requirement graph around the first requirement in a file.',
+                parameters: { filePath: 'Relative or absolute path to a .rq file', depth: 'Optional hop depth' }
+            },
+            {
+                name: 'summarize_subtree',
+                description: 'Summarise a requirement subtree rooted at a named requirement.',
+                parameters: { requirementName: 'Requirement name or search text', depth: 'Optional hop depth' }
+            },
+            {
+                name: 'requirement_reference',
+                description: 'Resolve a requirement by name for compact chat or MCP context.',
+                parameters: { name: 'Optional requirement name or search text' }
+            },
+            {
+                name: 'file_reference',
+                description: 'Resolve requirements indexed in matching .rq files.',
+                parameters: { path: 'Optional path fragment filter' }
+            },
+            {
+                name: 'completion_status',
+                description: 'Summarise completion and deprecation status across the workspace graph.',
+                parameters: {}
+            },
+            {
+                name: 'export_html',
+                description: 'Export the requirement graph as a multi-file static HTML site.',
+                parameters: {
+                    outputDir: 'Parent directory for the export folder',
+                    exportName: 'Export folder name',
+                    excludeSecretFiles: 'Optional: omit *.secret.rq files',
+                    excludeIgnoredFiles: 'Optional: omit .rqignore-matched files'
+                }
+            },
+            {
+                name: 'list_interactions',
+                description: 'Discover available requirement graph interactions and parameters.',
+                parameters: {}
+            }
+        ];
+    }
+    formatIdea(idea) {
+        const location = `${idea.fileUri}:${idea.lineStart + 1}`;
+        const tags = idea.tags.length > 0 ? `\nTags: ${idea.tags.join(', ')}` : '';
+        const status = idea.status ? `\nStatus: ${idea.status}` : '';
+        return `### ${idea.name} (${location})\n${idea.summary || '(no summary)'}${status}${tags}`;
+    }
+    exportFormat(format, request) {
+        const dto = {
+            format,
+            outputDir: request.outputDir,
+            exportName: request.exportName,
+            workspaceRoot: request.workspaceRoot,
+            templateId: request.templateId,
+            scope: request.scope,
+            sourceFileUri: request.sourceFileUri,
+            includeRequirementsPage: request.includeRequirementsPage ?? false,
+            includeGraphPage: request.includeGraphPage ?? false,
+            printEntryFileName: request.printEntryFileName,
+            excludeSecretFiles: request.excludeSecretFiles ?? false,
+            excludeIgnoredFiles: request.excludeIgnoredFiles ?? false,
+            runtimeMode: request.runtimeMode,
+            clusterStrategy: request.clusterStrategy,
+            includeIdeaPages: request.includeIdeaPages ?? true,
+            includeFilePages: request.includeFilePages ?? true,
+            includeCodeFilePages: request.includeCodeFilePages ?? true,
+            includeClusterPages: request.includeClusterPages ?? true,
+            includeAttributePages: request.includeAttributePages ?? true,
+            includePrintPages: request.includePrintPages ?? true,
+            maxGraphNodes: request.maxGraphNodes,
+            urlBase: request.urlBase,
+            headerLink: request.headerLink
+        };
+        const result = this.native.exportGraph(dto);
+        return {
+            outputDir: result.outputDir,
+            indexFilePath: result.indexFilePath,
+            printFilePath: result.printFilePath,
+            dataFilePath: result.dataFilePath
+        };
+    }
+}
+function toCountRecord(counts) {
+    const result = {};
+    for (const [key, value] of Object.entries(counts ?? {})) {
+        if (typeof value === 'number') {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+function toIdea(idea) {
+    return {
+        id: idea.id,
+        name: idea.name,
+        kind: idea.kind,
+        fileUri: idea.fileUri,
+        lineStart: idea.lineStart,
+        summary: idea.summary,
+        status: idea.status ?? undefined,
+        statusKey: idea.statusKey,
+        tags: idea.tags,
+        tagsKeys: idea.tagsKeys
+    };
+}
+function toGraph(graph) {
+    return {
+        centerId: graph.centerId,
+        depth: graph.depth,
+        nodes: graph.nodes.map(toIdea),
+        edges: graph.edges.map(edge => ({
+            id: edge.id,
+            sourceId: edge.sourceId,
+            targetId: edge.targetId ?? undefined,
+            targetFile: edge.targetFile ?? undefined,
+            kind: edge.kind,
+            label: edge.label ?? undefined
+        }))
+    };
+}
+//# sourceMappingURL=native-analysis-api.js.map

package/out/native/native-analysis-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-analysis-api.js","sourceRoot":"","sources":["../../src/native/native-analysis-api.ts"],"names":[],"mappings":"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"}

package/out/native/native-index-store.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Native-backed index store facade (SqliteIndexStore over rusqlite via napi).
+ * rq:["../../../reqlan rq/core_analysis/rust_port.rq".native_bridge]
+ */
+export { SqliteIndexStore as NativeIndexStore } from '../index-store/sqlite-store.js';

package/out/native/native-index-store.js

@@ -0,0 +1,6 @@
+/**
+ * Native-backed index store facade (SqliteIndexStore over rusqlite via napi).
+ * rq:["../../../reqlan rq/core_analysis/rust_port.rq".native_bridge]
+ */
+export { SqliteIndexStore as NativeIndexStore } from '../index-store/sqlite-store.js';
+//# sourceMappingURL=native-index-store.js.map

package/out/native/native-index-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-index-store.js","sourceRoot":"","sources":["../../src/native/native-index-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,gBAAgB,IAAI,gBAAgB,EAAE,MAAM,gCAAgC,CAAC"}

package/out/native/native-sql-db.d.ts

@@ -0,0 +1,135 @@
+import type { NativeWorkspaceIndex } from './native-workspace-index.js';
+/**
+ * Typed webview table/graph query surface implemented natively (reqlan-index queries.rs).
+ * Returns raw SQL rows; TS presentation mappers shape them into view rows.
+ */
+/** Outbound + inbound raw reference rows for a single idea (both joined to ideas). */
+export interface NativeReferenceBundle {
+    outbound: Record<string, unknown>[];
+    inbound: Record<string, unknown>[];
+}
+export interface NativeQuerySurface {
+    countIdeas(query: unknown): number;
+    listIdeasPageRows(query: unknown): Record<string, unknown>[];
+    listReferenceChipRows(ideaIds: string[]): Record<string, unknown>[];
+    countIdeasets(query: unknown): number;
+    listIdeasetsPageRows(query: unknown): Record<string, unknown>[];
+    listIdeasetMemberRows(ideasetId: string, kind: string, fileUri: string): Record<string, unknown>[];
+    countReferences(query: unknown): number;
+    listReferencesPageRows(query: unknown): Record<string, unknown>[];
+    listTodoIdeaRows(): Record<string, unknown>[];
+    listIdeasForGraphQuery(query: unknown, limit: number): {
+        rows: Record<string, unknown>[];
+        totalMatching: number;
+    };
+    listRecentGitIdeaRows(limit: number): Record<string, unknown>[];
+    listIdeaIdsMissingGitDates(limit: number, fileUri?: string, preferFileUri?: string): string[];
+    listAttributeIdeaRows(): Record<string, unknown>[];
+    migrateIdeasSchema(): void;
+    getDocumentHash(fileUri: string): string | null;
+    getDocumentMtimeMs(fileUri: string): number | null;
+    listDocumentMtimeRows(): Record<string, unknown>[];
+    listDocumentUris(): string[];
+    listAllIdeaRows(): Record<string, unknown>[];
+    getIdeaRow(id: string): Record<string, unknown> | null;
+    getIdeasInFileRows(fileUri: string): Record<string, unknown>[];
+    getIdeaAtLineRow(fileUri: string, line: number): Record<string, unknown> | null;
+    getIdeasetAtLineRow(fileUri: string, line: number): Record<string, unknown> | null;
+    listIdeasInFileWithRangeRows(fileUri: string): Record<string, unknown>[];
+    listIdeasetsInFileWithRangeRows(fileUri: string): Record<string, unknown>[];
+    getIdeasByIdsRows(ids: string[]): Record<string, unknown>[];
+    searchIdeaRows(search: string): Record<string, unknown>[];
+    listReferencesForIdea(ideaId: string): NativeReferenceBundle;
+    countUnresolvedForIdea(ideaId: string): number;
+    countEdgesFromFile(fileUri: string): number;
+    getEdgesFromRows(sourceId: string): Record<string, unknown>[];
+    getEdgesToRows(targetId: string): Record<string, unknown>[];
+    getEdgesForNodesRows(nodeIds: string[]): Record<string, unknown>[];
+    getEdgesReferencingFileRows(filePath: string): Record<string, unknown>[];
+    getAllEdgeRows(): Record<string, unknown>[];
+    listFileReferenceTargetRows(): Record<string, unknown>[];
+    allIdeaRawRows(): Record<string, unknown>[];
+    counts(): {
+        ideas: number;
+        edges: number;
+    };
+    updateDocumentMtime(fileUri: string, mtimeMs: number): void;
+    updateGitDates(id: string, createdAt?: string, modifiedAt?: string, changeCount?: number): void;
+    clearAll(): void;
+    removeDocuments(fileUris: string[]): void;
+    upsertDocument(fileUri: string, contentHash: string, ideas: unknown, edges: unknown, mtimeMs?: number): void;
+}
+export interface NativeSqlDbHandle extends NativeQuerySurface {
+    query(sql: string, params?: unknown[]): Record<string, unknown>[];
+    execute(sql: string, params?: unknown[]): number;
+    executeBatch(sql: string): void;
+    lastInsertRowid(): number;
+    close(): void;
+}
+export declare class NativeSqlConnection {
+    private readonly handle;
+    readonly dbPath: string;
+    private readonly ownsHandle;
+    private constructor();
+    static open(dbPath: string): Promise<NativeSqlConnection>;
+    /** Share the ideas DB connection owned by a NativeWorkspaceIndex (single writer). */
+    static fromWorkspaceIdeas(native: NativeWorkspaceIndex, dbPath: string): NativeSqlConnection;
+    /** Share the diagnostics DB connection owned by a NativeWorkspaceIndex. */
+    static fromWorkspaceDiagnostics(native: NativeWorkspaceIndex, dbPath: string): NativeSqlConnection;
+    run(sql: string, ...params: unknown[]): void;
+    exec(sql: string): void;
+    all<T extends Record<string, unknown> = Record<string, unknown>>(sql: string, ...params: unknown[]): T[];
+    get<T extends Record<string, unknown> = Record<string, unknown>>(sql: string, ...params: unknown[]): T | undefined;
+    lastInsertRowid(): number;
+    countIdeas(query: unknown): number;
+    listIdeasPageRows(query: unknown): Record<string, unknown>[];
+    listReferenceChipRows(ideaIds: string[]): Record<string, unknown>[];
+    countIdeasets(query: unknown): number;
+    listIdeasetsPageRows(query: unknown): Record<string, unknown>[];
+    listIdeasetMemberRows(ideasetId: string, kind: string, fileUri: string): Record<string, unknown>[];
+    countReferences(query: unknown): number;
+    listReferencesPageRows(query: unknown): Record<string, unknown>[];
+    listTodoIdeaRows(): Record<string, unknown>[];
+    listIdeasForGraphQuery(query: unknown, limit: number): {
+        rows: Record<string, unknown>[];
+        totalMatching: number;
+    };
+    listRecentGitIdeaRows(limit: number): Record<string, unknown>[];
+    listIdeaIdsMissingGitDates(limit: number, fileUri?: string, preferFileUri?: string): string[];
+    listAttributeIdeaRows(): Record<string, unknown>[];
+    migrateIdeasSchema(): void;
+    getDocumentHash(fileUri: string): string | null;
+    getDocumentMtimeMs(fileUri: string): number | null;
+    listDocumentMtimeRows(): Record<string, unknown>[];
+    listDocumentUris(): string[];
+    listAllIdeaRows(): Record<string, unknown>[];
+    getIdeaRow(id: string): Record<string, unknown> | null;
+    getIdeasInFileRows(fileUri: string): Record<string, unknown>[];
+    getIdeaAtLineRow(fileUri: string, line: number): Record<string, unknown> | null;
+    getIdeasetAtLineRow(fileUri: string, line: number): Record<string, unknown> | null;
+    listIdeasInFileWithRangeRows(fileUri: string): Record<string, unknown>[];
+    listIdeasetsInFileWithRangeRows(fileUri: string): Record<string, unknown>[];
+    getIdeasByIdsRows(ids: string[]): Record<string, unknown>[];
+    searchIdeaRows(search: string): Record<string, unknown>[];
+    listReferencesForIdea(ideaId: string): NativeReferenceBundle;
+    countUnresolvedForIdea(ideaId: string): number;
+    countEdgesFromFile(fileUri: string): number;
+    getEdgesFromRows(sourceId: string): Record<string, unknown>[];
+    getEdgesToRows(targetId: string): Record<string, unknown>[];
+    getEdgesForNodesRows(nodeIds: string[]): Record<string, unknown>[];
+    getEdgesReferencingFileRows(filePath: string): Record<string, unknown>[];
+    getAllEdgeRows(): Record<string, unknown>[];
+    listFileReferenceTargetRows(): Record<string, unknown>[];
+    allIdeaRawRows(): Record<string, unknown>[];
+    counts(): {
+        ideas: number;
+        edges: number;
+    };
+    updateDocumentMtime(fileUri: string, mtimeMs: number): void;
+    updateGitDates(id: string, createdAt?: string, modifiedAt?: string, changeCount?: number): void;
+    clearAll(): void;
+    removeDocuments(fileUris: string[]): void;
+    upsertDocument(fileUri: string, contentHash: string, ideas: unknown, edges: unknown, mtimeMs?: number): void;
+    assertHealthy(): void;
+    close(): void;
+}

package/out/native/native-sql-db.js

@@ -0,0 +1,217 @@
+/**
+ * Thin TS wrapper around napi SQL surfaces (NativeSqlDb or NativeWorkspaceIndex).
+ * rq:["../../../reqlan rq/core_analysis/rust_port.rq".native_bridge]
+ */
+import { mkdir } from 'node:fs/promises';
+import { statSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { loadNativeEngine } from './load-native.js';
+function toJsonParams(params) {
+    return params.map(value => (value === undefined ? null : value));
+}
+export class NativeSqlConnection {
+    constructor(handle, dbPath, ownsHandle) {
+        this.handle = handle;
+        this.dbPath = dbPath;
+        this.ownsHandle = ownsHandle;
+    }
+    static async open(dbPath) {
+        await mkdir(dirname(dbPath), { recursive: true });
+        const engine = loadNativeEngine();
+        if (!engine.NativeSqlDb) {
+            throw new Error('NativeSqlDb is missing from the native engine; rebuild reqlan-napi.');
+        }
+        const conn = new NativeSqlConnection(engine.NativeSqlDb.open(dbPath), dbPath, true);
+        conn.assertHealthy();
+        return conn;
+    }
+    /** Share the ideas DB connection owned by a NativeWorkspaceIndex (single writer). */
+    static fromWorkspaceIdeas(native, dbPath) {
+        return new NativeSqlConnection(native.ideasSqlHandle(), dbPath, false);
+    }
+    /** Share the diagnostics DB connection owned by a NativeWorkspaceIndex. */
+    static fromWorkspaceDiagnostics(native, dbPath) {
+        return new NativeSqlConnection(native.diagnosticsSqlHandle(), dbPath, false);
+    }
+    run(sql, ...params) {
+        this.handle.execute(sql, toJsonParams(params));
+    }
+    exec(sql) {
+        this.handle.executeBatch(sql);
+    }
+    all(sql, ...params) {
+        return this.handle.query(sql, toJsonParams(params));
+    }
+    get(sql, ...params) {
+        return this.all(sql, ...params)[0];
+    }
+    lastInsertRowid() {
+        return this.handle.lastInsertRowid();
+    }
+    // ---- typed webview table/graph query surface (native SQL builders) ----------
+    countIdeas(query) {
+        return this.handle.countIdeas(query);
+    }
+    listIdeasPageRows(query) {
+        return this.handle.listIdeasPageRows(query);
+    }
+    listReferenceChipRows(ideaIds) {
+        return this.handle.listReferenceChipRows(ideaIds);
+    }
+    countIdeasets(query) {
+        return this.handle.countIdeasets(query);
+    }
+    listIdeasetsPageRows(query) {
+        return this.handle.listIdeasetsPageRows(query);
+    }
+    listIdeasetMemberRows(ideasetId, kind, fileUri) {
+        return this.handle.listIdeasetMemberRows(ideasetId, kind, fileUri);
+    }
+    countReferences(query) {
+        return this.handle.countReferences(query);
+    }
+    listReferencesPageRows(query) {
+        return this.handle.listReferencesPageRows(query);
+    }
+    listTodoIdeaRows() {
+        return this.handle.listTodoIdeaRows();
+    }
+    listIdeasForGraphQuery(query, limit) {
+        return this.handle.listIdeasForGraphQuery(query, limit);
+    }
+    listRecentGitIdeaRows(limit) {
+        return this.handle.listRecentGitIdeaRows(limit);
+    }
+    listIdeaIdsMissingGitDates(limit, fileUri, preferFileUri) {
+        return this.handle.listIdeaIdsMissingGitDates(limit, fileUri, preferFileUri);
+    }
+    listAttributeIdeaRows() {
+        return this.handle.listAttributeIdeaRows();
+    }
+    // ---- typed domain read/write surface (native SQL) ---------------------------
+    migrateIdeasSchema() {
+        this.handle.migrateIdeasSchema();
+    }
+    getDocumentHash(fileUri) {
+        return this.handle.getDocumentHash(fileUri);
+    }
+    getDocumentMtimeMs(fileUri) {
+        return this.handle.getDocumentMtimeMs(fileUri);
+    }
+    listDocumentMtimeRows() {
+        return this.handle.listDocumentMtimeRows();
+    }
+    listDocumentUris() {
+        return this.handle.listDocumentUris();
+    }
+    listAllIdeaRows() {
+        return this.handle.listAllIdeaRows();
+    }
+    getIdeaRow(id) {
+        return this.handle.getIdeaRow(id);
+    }
+    getIdeasInFileRows(fileUri) {
+        return this.handle.getIdeasInFileRows(fileUri);
+    }
+    getIdeaAtLineRow(fileUri, line) {
+        return this.handle.getIdeaAtLineRow(fileUri, line);
+    }
+    getIdeasetAtLineRow(fileUri, line) {
+        return this.handle.getIdeasetAtLineRow(fileUri, line);
+    }
+    listIdeasInFileWithRangeRows(fileUri) {
+        return this.handle.listIdeasInFileWithRangeRows(fileUri);
+    }
+    listIdeasetsInFileWithRangeRows(fileUri) {
+        return this.handle.listIdeasetsInFileWithRangeRows(fileUri);
+    }
+    getIdeasByIdsRows(ids) {
+        return this.handle.getIdeasByIdsRows(ids);
+    }
+    searchIdeaRows(search) {
+        return this.handle.searchIdeaRows(search);
+    }
+    listReferencesForIdea(ideaId) {
+        return this.handle.listReferencesForIdea(ideaId);
+    }
+    countUnresolvedForIdea(ideaId) {
+        return this.handle.countUnresolvedForIdea(ideaId);
+    }
+    countEdgesFromFile(fileUri) {
+        return this.handle.countEdgesFromFile(fileUri);
+    }
+    getEdgesFromRows(sourceId) {
+        return this.handle.getEdgesFromRows(sourceId);
+    }
+    getEdgesToRows(targetId) {
+        return this.handle.getEdgesToRows(targetId);
+    }
+    getEdgesForNodesRows(nodeIds) {
+        return this.handle.getEdgesForNodesRows(nodeIds);
+    }
+    getEdgesReferencingFileRows(filePath) {
+        return this.handle.getEdgesReferencingFileRows(filePath);
+    }
+    getAllEdgeRows() {
+        return this.handle.getAllEdgeRows();
+    }
+    listFileReferenceTargetRows() {
+        return this.handle.listFileReferenceTargetRows();
+    }
+    allIdeaRawRows() {
+        return this.handle.allIdeaRawRows();
+    }
+    counts() {
+        return this.handle.counts();
+    }
+    updateDocumentMtime(fileUri, mtimeMs) {
+        this.handle.updateDocumentMtime(fileUri, mtimeMs);
+    }
+    updateGitDates(id, createdAt, modifiedAt, changeCount) {
+        this.handle.updateGitDates(id, createdAt, modifiedAt, changeCount);
+    }
+    clearAll() {
+        this.handle.clearAll();
+    }
+    removeDocuments(fileUris) {
+        this.handle.removeDocuments(fileUris);
+    }
+    upsertDocument(fileUri, contentHash, ideas, edges, mtimeMs) {
+        this.handle.upsertDocument(fileUri, contentHash, ideas, edges, mtimeMs);
+    }
+    assertHealthy() {
+        const rows = this.all('PRAGMA integrity_check');
+        if (rows.length === 0) {
+            throw new Error('database disk image is malformed: integrity_check returned no rows');
+        }
+        for (const row of rows) {
+            const result = String(row.integrity_check ?? row.quick_check ?? Object.values(row)[0] ?? '');
+            if (result && result.toLowerCase() !== 'ok') {
+                throw new Error(`database disk image is malformed: ${result}`);
+            }
+        }
+        const pageCountRow = this.get('PRAGMA page_count');
+        const pageSizeRow = this.get('PRAGMA page_size');
+        const pageCount = Number(pageCountRow?.page_count ?? Object.values(pageCountRow ?? {})[0] ?? 0);
+        const pageSize = Number(pageSizeRow?.page_size ?? Object.values(pageSizeRow ?? {})[0] ?? 0);
+        if (pageCount > 0 && pageSize > 0) {
+            try {
+                const size = statSync(this.dbPath).size;
+                if (size < pageCount * pageSize) {
+                    throw new Error(`database disk image is malformed: file truncated (${size} bytes, expected ${pageCount * pageSize})`);
+                }
+            }
+            catch (error) {
+                if (error instanceof Error && /malformed/i.test(error.message)) {
+                    throw error;
+                }
+            }
+        }
+    }
+    close() {
+        if (this.ownsHandle) {
+            this.handle.close();
+        }
+    }
+}
+//# sourceMappingURL=native-sql-db.js.map