@reqlan/analytical 0.5.4 → 0.6.0

package/out/index-store/base-registry.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Multi-base index registry: one WorkspaceIndex + AnalyticalStore per base.
+ */
+import type { AnalyticalStore } from '../core/analytical-store.js';
+import { type BaseDescriptor } from '../core/base-discovery.js';
+import type { IndexStatusSnapshot } from './index-status.js';
+import { WorkspaceIndex } from './workspace-index.js';
+export interface RegisteredBase {
+    descriptor: BaseDescriptor;
+    store: AnalyticalStore;
+    index: WorkspaceIndex;
+}
+export interface BaseStatusEntry {
+    base: BaseDescriptor;
+    status: IndexStatusSnapshot;
+}
+export declare class BaseRegistry {
+    private readonly entries;
+    get size(): number;
+    list(): BaseDescriptor[];
+    get(baseId: string): RegisteredBase | undefined;
+    getByRoot(root: string): RegisteredBase | undefined;
+    baseForFilePath(absPath: string): RegisteredBase | undefined;
+    /** Replace registry contents from discovered descriptors (does not open indexes). */
+    replaceDescriptors(bases: BaseDescriptor[]): void;
+    /**
+     * Discover bases under `roots` and register them.
+     * Returns the discovered descriptors (may be empty).
+     */
+    rediscover(roots: string[]): BaseDescriptor[];
+    /**
+     * Open every registered index. Failures are isolated so one bad base cannot
+     * leave siblings stranded in `uninitialized`.
+     */
+    activateAll(): Promise<void>;
+    /**
+     * Open + soft-sync one base when it is not ready (pin / idle catch-up).
+     * Joins an in-flight sync; no-op when already ready.
+     */
+    ensureBaseReady(baseId: string, allRqFiles: string[]): Promise<boolean>;
+    deactivateAll(): Promise<void>;
+    syncBase(baseId: string, allRqFiles: string[]): Promise<boolean>;
+    syncAll(allRqFiles: string[]): Promise<boolean>;
+    clearAndRebuildBase(baseId: string, allRqFiles: string[]): Promise<boolean>;
+    cancelSync(baseId?: string): void;
+    checkStaleAll(allRqFiles: string[]): Promise<{
+        checked: number;
+        indexed: number;
+        removed: number;
+    }>;
+    statusByBase(relativePath?: (uri: string) => string): BaseStatusEntry[];
+    /** Aggregate glance: ready only if every base is ready (or no bases). */
+    aggregateReady(): boolean;
+    selectDefault(cwd?: string): RegisteredBase | undefined;
+    subscribeCatalogUpdates(listener: () => void): () => void;
+    subscribeStatusUpdates(listener: () => void): () => void;
+}

package/out/index-store/base-registry.js

@@ -0,0 +1,192 @@
+import { createAnalyticalStore } from '../core/analytical-store.js';
+import { baseForPath, discoverBases, filesOwnedByBase, selectDefaultBase } from '../core/base-discovery.js';
+import { resolveApplicationMemoryPath } from '../core/application-memory.js';
+import { WorkspaceIndex } from './workspace-index.js';
+export class BaseRegistry {
+    constructor() {
+        this.entries = new Map();
+    }
+    get size() {
+        return this.entries.size;
+    }
+    list() {
+        return [...this.entries.values()]
+            .map(e => e.descriptor)
+            .sort((a, b) => a.root.localeCompare(b.root));
+    }
+    get(baseId) {
+        return this.entries.get(baseId);
+    }
+    getByRoot(root) {
+        for (const entry of this.entries.values()) {
+            if (entry.descriptor.root === root || entry.descriptor.id === root) {
+                return entry;
+            }
+        }
+        return undefined;
+    }
+    baseForFilePath(absPath) {
+        const match = baseForPath(this.list(), absPath);
+        return match ? this.entries.get(match.id) : undefined;
+    }
+    /** Replace registry contents from discovered descriptors (does not open indexes). */
+    replaceDescriptors(bases) {
+        const keep = new Set(bases.map(b => b.id));
+        for (const id of [...this.entries.keys()]) {
+            if (!keep.has(id)) {
+                const entry = this.entries.get(id);
+                void entry?.index.deactivate();
+                this.entries.delete(id);
+            }
+        }
+        for (const descriptor of bases) {
+            if (this.entries.has(descriptor.id)) {
+                continue;
+            }
+            const store = createAnalyticalStore();
+            const storagePath = resolveApplicationMemoryPath(descriptor.root);
+            const index = new WorkspaceIndex(store, storagePath, descriptor.root);
+            this.entries.set(descriptor.id, { descriptor, store, index });
+        }
+    }
+    /**
+     * Discover bases under `roots` and register them.
+     * Returns the discovered descriptors (may be empty).
+     */
+    rediscover(roots) {
+        const bases = discoverBases(roots);
+        this.replaceDescriptors(bases);
+        return bases;
+    }
+    /**
+     * Open every registered index. Failures are isolated so one bad base cannot
+     * leave siblings stranded in `uninitialized`.
+     */
+    async activateAll() {
+        for (const entry of this.entries.values()) {
+            try {
+                await entry.index.open();
+            }
+            catch {
+                // Per-base store already recorded the open error.
+            }
+        }
+    }
+    /**
+     * Open + soft-sync one base when it is not ready (pin / idle catch-up).
+     * Joins an in-flight sync; no-op when already ready.
+     */
+    async ensureBaseReady(baseId, allRqFiles) {
+        const entry = this.entries.get(baseId);
+        if (!entry) {
+            return false;
+        }
+        const owned = filesOwnedByBase(entry.descriptor, allRqFiles, this.list());
+        return entry.index.ensureReady(owned);
+    }
+    async deactivateAll() {
+        for (const entry of this.entries.values()) {
+            await entry.index.deactivate();
+        }
+        this.entries.clear();
+    }
+    async syncBase(baseId, allRqFiles) {
+        const entry = this.entries.get(baseId);
+        if (!entry) {
+            return false;
+        }
+        const owned = filesOwnedByBase(entry.descriptor, allRqFiles, this.list());
+        return entry.index.syncWorkspace(owned);
+    }
+    async syncAll(allRqFiles) {
+        let ok = true;
+        for (const entry of this.entries.values()) {
+            const result = await this.syncBase(entry.descriptor.id, allRqFiles);
+            if (!result) {
+                ok = false;
+            }
+        }
+        return ok;
+    }
+    async clearAndRebuildBase(baseId, allRqFiles) {
+        const entry = this.entries.get(baseId);
+        if (!entry) {
+            return false;
+        }
+        const owned = filesOwnedByBase(entry.descriptor, allRqFiles, this.list());
+        return entry.index.clearAndRebuildIndex(owned);
+    }
+    cancelSync(baseId) {
+        if (baseId) {
+            this.entries.get(baseId)?.index.cancelSync();
+            return;
+        }
+        for (const entry of this.entries.values()) {
+            entry.index.cancelSync();
+        }
+    }
+    async checkStaleAll(allRqFiles) {
+        let checked = 0;
+        let indexed = 0;
+        let removed = 0;
+        for (const entry of this.entries.values()) {
+            const owned = filesOwnedByBase(entry.descriptor, allRqFiles, this.list());
+            // Unopened / never-synced bases cannot idle-diff — catch them up first.
+            if (!entry.index.isReady && entry.index.state !== 'syncing' && entry.index.state !== 'opening') {
+                const ok = await entry.index.ensureReady(owned);
+                if (ok) {
+                    checked += owned.length;
+                    indexed += owned.length;
+                }
+                continue;
+            }
+            const result = await entry.index.checkStaleFiles(owned);
+            checked += result.checked;
+            indexed += result.indexed;
+            removed += result.removed;
+        }
+        return { checked, indexed, removed };
+    }
+    statusByBase(relativePath) {
+        return this.list().map(base => {
+            const entry = this.entries.get(base.id);
+            return {
+                base,
+                status: entry.index.getStatusSnapshot(relativePath)
+            };
+        });
+    }
+    /** Aggregate glance: ready only if every base is ready (or no bases). */
+    aggregateReady() {
+        if (this.entries.size === 0) {
+            return false;
+        }
+        for (const entry of this.entries.values()) {
+            if (!entry.index.isReady) {
+                return false;
+            }
+        }
+        return true;
+    }
+    selectDefault(cwd) {
+        const desc = selectDefaultBase(this.list(), cwd);
+        return desc ? this.entries.get(desc.id) : undefined;
+    }
+    subscribeCatalogUpdates(listener) {
+        const unsubs = [...this.entries.values()].map(e => e.index.subscribeCatalogUpdates(listener));
+        return () => {
+            for (const u of unsubs) {
+                u();
+            }
+        };
+    }
+    subscribeStatusUpdates(listener) {
+        const unsubs = [...this.entries.values()].map(e => e.index.subscribeStatusUpdates(listener));
+        return () => {
+            for (const u of unsubs) {
+                u();
+            }
+        };
+    }
+}
+//# sourceMappingURL=base-registry.js.map

package/out/index-store/base-registry.js.map

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

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

@@ -0,0 +1,72 @@
+export type IndexTimingTrigger = 'soft_sync' | 'rebuild' | 'enqueue' | 'stale';
+export type IndexFileOutcome = 'mtime_skip' | 'mtime_refresh' | 'hash_skip' | 'persisted' | 'error';
+export interface IndexFileTimingRecord {
+    fileUri: string;
+    durationMs: number;
+    outcome: IndexFileOutcome;
+    pathDepth: number;
+}
+export interface IndexSyncRunRecord {
+    trigger: IndexTimingTrigger;
+    startedAt: string;
+    finishedAt: string;
+    durationMs: number;
+    totalFiles: number;
+    skippedMtime: number;
+    indexedFiles: number;
+    errorFiles: number;
+    cancelled: boolean;
+    sumFileDurationMs: number;
+    avgPathDepth: number | undefined;
+    files: IndexFileTimingRecord[];
+}
+export interface IndexSyncRunSummary {
+    id: number;
+    trigger: IndexTimingTrigger;
+    startedAt: string;
+    finishedAt: string;
+    durationMs: number;
+    totalFiles: number;
+    skippedMtime: number;
+    indexedFiles: number;
+    errorFiles: number;
+    cancelled: boolean;
+    sumFileDurationMs: number;
+    avgPathDepth: number | undefined;
+}
+export interface IndexFileTimingRow {
+    id: number;
+    runId: number;
+    fileUri: string;
+    durationMs: number;
+    outcome: IndexFileOutcome;
+    pathDepth: number;
+}
+export interface IndexDiagnosticsOverview {
+    runCount: number;
+    latestRun: IndexSyncRunSummary | undefined;
+    /** Sum of wall durations across retained runs. */
+    totalDurationMs: number;
+    /** Sum of per-file durations across retained runs. */
+    totalFileDurationMs: number;
+    averageRunDurationMs: number;
+    averagePathDepth: number | undefined;
+}
+/** Path segment count under the base (e.g. `a/b/c.rq` → 3). */
+export declare function pathDepthFromUri(fileUri: string): number;
+export declare class IndexDiagnosticsStore {
+    private readonly db;
+    private constructor();
+    static open(dbPath: string): Promise<IndexDiagnosticsStore>;
+    close(): Promise<void>;
+    recordSyncRun(run: IndexSyncRunRecord): Promise<number>;
+    listRecentRuns(limit?: number): Promise<IndexSyncRunSummary[]>;
+    getRun(runId: number): Promise<IndexSyncRunSummary | undefined>;
+    listFileTimings(runId: number, options?: {
+        limit?: number;
+        order?: 'duration_desc' | 'duration_asc' | 'path';
+    }): Promise<IndexFileTimingRow[]>;
+    getOverview(): Promise<IndexDiagnosticsOverview>;
+    private migrate;
+    private trimOldRuns;
+}

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

@@ -0,0 +1,238 @@
+/**
+ * Per-base indexing timing diagnostic store (`index-diagnostics.sqlite`).
+ * Sibling of ideas-index; survives Clear & rebuild.
+ *
+ * rq:["../../../reqlan rq/extension/module/index.rq".index_diagnostics_store]
+ * rq:["../../../reqlan rq/extension/features-index-diagnostics.rq".index_diagnostics_metrics]
+ * rq:["../../../reqlan rq/indexer/indexer.rq".index_diagnostics_timing]
+ */
+import initSqlJs from 'sql.js/dist/sql-asm.js';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+const SCHEMA_VERSION = 1;
+const MAX_RETAINED_RUNS = 50;
+const BASE_SQL = [
+    `CREATE TABLE IF NOT EXISTS meta (
+        key TEXT PRIMARY KEY,
+        value TEXT NOT NULL
+    )`,
+    `CREATE TABLE IF NOT EXISTS sync_runs (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        started_at TEXT NOT NULL,
+        finished_at TEXT NOT NULL,
+        duration_ms REAL NOT NULL,
+        trigger TEXT NOT NULL,
+        total_files INTEGER NOT NULL,
+        skipped_mtime INTEGER NOT NULL,
+        indexed_files INTEGER NOT NULL,
+        error_files INTEGER NOT NULL,
+        cancelled INTEGER NOT NULL DEFAULT 0,
+        sum_file_duration_ms REAL NOT NULL DEFAULT 0,
+        avg_path_depth REAL
+    )`,
+    `CREATE TABLE IF NOT EXISTS file_timings (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        run_id INTEGER NOT NULL,
+        file_uri TEXT NOT NULL,
+        duration_ms REAL NOT NULL,
+        outcome TEXT NOT NULL,
+        path_depth INTEGER NOT NULL,
+        FOREIGN KEY (run_id) REFERENCES sync_runs(id) ON DELETE CASCADE
+    )`,
+    `CREATE INDEX IF NOT EXISTS idx_file_timings_run ON file_timings(run_id)`,
+    `CREATE INDEX IF NOT EXISTS idx_file_timings_duration ON file_timings(duration_ms DESC)`
+];
+/** Path segment count under the base (e.g. `a/b/c.rq` → 3). */
+export function pathDepthFromUri(fileUri) {
+    const normalized = fileUri.replace(/\\/g, '/').replace(/^\.\/+/, '').replace(/^\/+/, '');
+    if (!normalized) {
+        return 0;
+    }
+    return normalized.split('/').filter(Boolean).length;
+}
+export class IndexDiagnosticsStore {
+    constructor(db) {
+        this.db = db;
+    }
+    static async open(dbPath) {
+        const db = await openDatabase(dbPath);
+        const store = new IndexDiagnosticsStore(db);
+        await store.migrate();
+        return store;
+    }
+    async close() {
+        await persistDatabase(this.db);
+        this.db.db.close();
+    }
+    async recordSyncRun(run) {
+        try {
+            this.db.db.run('BEGIN');
+            this.db.db.run(`INSERT INTO sync_runs (
+                    started_at, finished_at, duration_ms, trigger,
+                    total_files, skipped_mtime, indexed_files, error_files,
+                    cancelled, sum_file_duration_ms, avg_path_depth
+                ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+                run.startedAt,
+                run.finishedAt,
+                run.durationMs,
+                run.trigger,
+                run.totalFiles,
+                run.skippedMtime,
+                run.indexedFiles,
+                run.errorFiles,
+                run.cancelled ? 1 : 0,
+                run.sumFileDurationMs,
+                run.avgPathDepth ?? null
+            ]);
+            const idRow = await get(this.db, 'SELECT last_insert_rowid() AS id');
+            const runId = idRow?.id ?? 0;
+            for (const file of run.files) {
+                this.db.db.run(`INSERT INTO file_timings (run_id, file_uri, duration_ms, outcome, path_depth)
+                     VALUES (?, ?, ?, ?, ?)`, [runId, file.fileUri, file.durationMs, file.outcome, file.pathDepth]);
+            }
+            this.db.db.run('COMMIT');
+            this.db.dirty = true;
+            await this.trimOldRuns();
+            await persistDatabase(this.db);
+            return runId;
+        }
+        catch (error) {
+            try {
+                this.db.db.run('ROLLBACK');
+            }
+            catch {
+                // ignore
+            }
+            throw error;
+        }
+    }
+    async listRecentRuns(limit = 20) {
+        const rows = await all(this.db, `SELECT * FROM sync_runs ORDER BY id DESC LIMIT ?`, Math.max(1, Math.min(limit, MAX_RETAINED_RUNS)));
+        return rows.map(mapRunSummary);
+    }
+    async getRun(runId) {
+        const row = await get(this.db, `SELECT * FROM sync_runs WHERE id = ?`, runId);
+        return row ? mapRunSummary(row) : undefined;
+    }
+    async listFileTimings(runId, options) {
+        const order = options?.order ?? 'duration_desc';
+        const orderSql = order === 'duration_asc'
+            ? 'duration_ms ASC, file_uri ASC'
+            : order === 'path'
+                ? 'file_uri ASC'
+                : 'duration_ms DESC, file_uri ASC';
+        const limit = Math.max(1, Math.min(options?.limit ?? 500, 2000));
+        const rows = await all(this.db, `SELECT * FROM file_timings WHERE run_id = ? ORDER BY ${orderSql} LIMIT ?`, runId, limit);
+        return rows.map(mapFileTiming);
+    }
+    async getOverview() {
+        const agg = await get(this.db, `SELECT
+                COUNT(*) AS run_count,
+                COALESCE(SUM(duration_ms), 0) AS total_duration,
+                COALESCE(SUM(sum_file_duration_ms), 0) AS total_file_duration,
+                AVG(avg_path_depth) AS avg_depth
+             FROM sync_runs`);
+        const runs = await this.listRecentRuns(1);
+        const runCount = agg?.run_count ?? 0;
+        const totalDurationMs = agg?.total_duration ?? 0;
+        return {
+            runCount,
+            latestRun: runs[0],
+            totalDurationMs,
+            totalFileDurationMs: agg?.total_file_duration ?? 0,
+            averageRunDurationMs: runCount > 0 ? totalDurationMs / runCount : 0,
+            averagePathDepth: agg?.avg_depth == null ? undefined : agg.avg_depth
+        };
+    }
+    async migrate() {
+        for (const sql of BASE_SQL) {
+            this.db.db.run(sql);
+        }
+        this.db.db.run(`INSERT INTO meta (key, value) VALUES (?, ?)
+             ON CONFLICT(key) DO UPDATE SET value = excluded.value`, ['schema_version', String(SCHEMA_VERSION)]);
+        this.db.dirty = true;
+        await persistDatabase(this.db);
+    }
+    async trimOldRuns() {
+        const cutoff = await get(this.db, `SELECT id FROM sync_runs ORDER BY id DESC LIMIT 1 OFFSET ?`, MAX_RETAINED_RUNS - 1);
+        if (!cutoff) {
+            return;
+        }
+        this.db.db.run(`DELETE FROM file_timings WHERE run_id < ?`, [cutoff.id]);
+        this.db.db.run(`DELETE FROM sync_runs WHERE id < ?`, [cutoff.id]);
+        this.db.dirty = true;
+    }
+}
+function mapRunSummary(row) {
+    return {
+        id: row.id,
+        trigger: row.trigger,
+        startedAt: row.started_at,
+        finishedAt: row.finished_at,
+        durationMs: row.duration_ms,
+        totalFiles: row.total_files,
+        skippedMtime: row.skipped_mtime,
+        indexedFiles: row.indexed_files,
+        errorFiles: row.error_files,
+        cancelled: row.cancelled !== 0,
+        sumFileDurationMs: row.sum_file_duration_ms,
+        avgPathDepth: row.avg_path_depth == null ? undefined : row.avg_path_depth
+    };
+}
+function mapFileTiming(row) {
+    return {
+        id: row.id,
+        runId: row.run_id,
+        fileUri: row.file_uri,
+        durationMs: row.duration_ms,
+        outcome: row.outcome,
+        pathDepth: row.path_depth
+    };
+}
+let sqlJsModulePromise;
+async function getSqlJsModule() {
+    sqlJsModulePromise ?? (sqlJsModulePromise = initSqlJs({}));
+    return sqlJsModulePromise;
+}
+async function openDatabase(path) {
+    await mkdir(dirname(path), { recursive: true });
+    const SQL = await getSqlJsModule();
+    let bytes;
+    try {
+        bytes = new Uint8Array(await readFile(path));
+    }
+    catch {
+        bytes = undefined;
+    }
+    return {
+        db: bytes ? new SQL.Database(bytes) : new SQL.Database(),
+        dbPath: path,
+        dirty: false
+    };
+}
+async function persistDatabase(db) {
+    if (!db.dirty) {
+        return;
+    }
+    await mkdir(dirname(db.dbPath), { recursive: true });
+    await writeFile(db.dbPath, Buffer.from(db.db.export()));
+    db.dirty = false;
+}
+async function get(db, sql, ...params) {
+    const rows = await all(db, sql, ...params);
+    return rows[0];
+}
+async function all(db, sql, ...params) {
+    const statement = db.db.prepare(sql, params);
+    const rows = [];
+    try {
+        while (statement.step()) {
+            rows.push(statement.getAsObject());
+        }
+        return rows;
+    }
+    finally {
+        statement.free();
+    }
+}
+//# sourceMappingURL=index-diagnostics-store.js.map

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

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

package/out/index-store/index-file-error.d.ts

@@ -0,0 +1,16 @@
+import type { IndexErrorPhase } from '../core/analytical-store.js';
+import type { FileIndexIssueDraft } from './index-parse-issues.js';
+export declare class IndexFileError extends Error {
+    readonly fileUri: string;
+    readonly phase: IndexErrorPhase;
+    readonly ideaNames?: string[];
+    readonly underlyingCause?: unknown;
+    constructor(message: string, fileUri: string, phase: IndexErrorPhase, ideaNames?: string[], cause?: unknown);
+}
+export declare function toFileIndexIssueDraft(error: IndexFileError): FileIndexIssueDraft;
+export declare function recordCaughtFileIssue(recordFileIndexIssues: (fileUri: string, issues: FileIndexIssueDraft[]) => void, fileUri: string, error: unknown, fallbackMessage: string, fallbackPhase?: IndexErrorPhase): void;
+export declare function recordCaughtIndexError(recordIndexError: (message: string, cause?: unknown, context?: {
+    fileUri?: string;
+    ideaNames?: string[];
+    phase?: IndexErrorPhase;
+}) => void, error: unknown, fallbackMessage: string, fallbackPhase?: IndexErrorPhase): void;

package/out/index-store/index-file-error.js

@@ -0,0 +1,27 @@
+import { fileIssueFromError } from './index-parse-issues.js';
+export class IndexFileError extends Error {
+    constructor(message, fileUri, phase, ideaNames, cause) {
+        super(message);
+        this.name = 'IndexFileError';
+        this.fileUri = fileUri;
+        this.phase = phase;
+        this.ideaNames = ideaNames;
+        this.underlyingCause = cause;
+    }
+}
+export function toFileIndexIssueDraft(error) {
+    return fileIssueFromError(error.phase, error.underlyingCause ?? error, error.message, 0, 0, error.ideaNames);
+}
+export function recordCaughtFileIssue(recordFileIndexIssues, fileUri, error, fallbackMessage, fallbackPhase = 'sync') {
+    if (error instanceof IndexFileError) {
+        recordFileIndexIssues(fileUri, [toFileIndexIssueDraft(error)]);
+        return;
+    }
+    recordFileIndexIssues(fileUri, [
+        fileIssueFromError(fallbackPhase, error, fallbackMessage)
+    ]);
+}
+export function recordCaughtIndexError(recordIndexError, error, fallbackMessage, fallbackPhase = 'sync') {
+    recordIndexError(fallbackMessage, error, { phase: fallbackPhase });
+}
+//# sourceMappingURL=index-file-error.js.map

package/out/index-store/index-file-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-file-error.js","sourceRoot":"","sources":["../../src/index-store/index-file-error.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,OAAO,cAAe,SAAQ,KAAK;IAMrC,YACI,OAAe,EACf,OAAe,EACf,KAAsB,EACtB,SAAoB,EACpB,KAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;IACjC,CAAC;CACJ;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAqB;IACvD,OAAO,kBAAkB,CACrB,KAAK,CAAC,KAAK,EACX,KAAK,CAAC,eAAe,IAAI,KAAK,EAC9B,KAAK,CAAC,OAAO,EACb,CAAC,EACD,CAAC,EACD,KAAK,CAAC,SAAS,CAClB,CAAC;AACN,CAAC;AAED,MAAM,UAAU,qBAAqB,CACjC,qBAA+E,EAC/E,OAAe,EACf,KAAc,EACd,eAAuB,EACvB,gBAAiC,MAAM;IAEvC,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;QAClC,qBAAqB,CAAC,OAAO,EAAE,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC/D,OAAO;IACX,CAAC;IACD,qBAAqB,CAAC,OAAO,EAAE;QAC3B,kBAAkB,CAAC,aAAa,EAAE,KAAK,EAAE,eAAe,CAAC;KAC5D,CAAC,CAAC;AACP,CAAC;AAED,MAAM,UAAU,sBAAsB,CAClC,gBAIS,EACT,KAAc,EACd,eAAuB,EACvB,gBAAiC,MAAM;IAEvC,gBAAgB,CAAC,eAAe,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC;AACvE,CAAC"}

package/out/index-store/index-parse-issues.d.ts

@@ -0,0 +1,9 @@
+import type { LangiumDocument } from 'langium';
+import type { FileIndexIssue, IndexErrorPhase } from '../core/analytical-store.js';
+import type { IdeaRecord } from '../core/types.js';
+export type FileIndexIssueDraft = Omit<FileIndexIssue, 'fileUri' | 'at'>;
+export declare function collectParseIssues(document: LangiumDocument): FileIndexIssueDraft[];
+export declare function fileIssue(message: string, phase: IndexErrorPhase, line?: number, column?: number, ideaNames?: string[]): FileIndexIssueDraft;
+export declare function fileIssueFromError(phase: IndexErrorPhase, error: unknown, fallbackMessage: string, line?: number, column?: number, ideaNames?: string[]): FileIndexIssueDraft;
+export declare function unnamedIdeaIssues(ideas: IdeaRecord[]): FileIndexIssueDraft[];
+export declare function validIdeas(ideas: IdeaRecord[]): IdeaRecord[];