@unbrained/pm-cli 2026.9.7 → 2026.9.9

package/dist/core/store/item-metadata-query-index.js

@@ -1,46 +1,4 @@
-/**
- * @module core/store/item-metadata-query-index
- *
- * Maintains a rebuildable SQLite projection for bounded metadata queries.
- */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="530ad63f-f7c5-52c9-9f81-a74b1cd4c36e")}catch(e){}}();
-import fs from "node:fs/promises";
-import path from "node:path";
-import { randomUUID } from "node:crypto";
-import { createRequire } from "node:module";
-const QUERY_INDEX_FILENAME = "metadata-query-index.sqlite";
-const QUERY_INDEX_VERSION = "5";
-function loadDatabaseSync(loadModule) {
-    try {
-        const loaded = loadModule(["node", "sqlite"].join(":"));
-        return loaded.DatabaseSync ?? null;
-    }
-    catch {
-        return null;
-    }
-}
-let RuntimeDatabaseSync;
-function loadStableDatabaseSync(nodeVersion, loadModule) {
-    const nodeMajor = Number.parseInt(nodeVersion, 10);
-    return Number.isFinite(nodeMajor) && nodeMajor >= 22
-        ? loadDatabaseSync(loadModule)
-        : null;
-}
-function resolveDatabaseSync() {
-    if (RuntimeDatabaseSync !== undefined)
-        return RuntimeDatabaseSync;
-    RuntimeDatabaseSync = loadStableDatabaseSync(process.versions.node, createRequire(import.meta.url));
-    return RuntimeDatabaseSync;
-}
-function normalizeIndexWindowValue(value, fallback) {
-    return Math.max(0, Math.floor(value === undefined ? fallback : value));
-}
-function queryIndexPath(pmRoot) {
-    return path.join(pmRoot, "runtime", QUERY_INDEX_FILENAME);
-}
-function createSchema(database) {
-    database.exec(`
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="e9e67ec7-10cb-57b0-a094-ae52b01a0f8a")}catch(e2){}})();import fs from"node:fs/promises";import path from"node:path";import{randomUUID}from"node:crypto";import{createRequire}from"node:module";const QUERY_INDEX_FILENAME="metadata-query-index.sqlite";const QUERY_INDEX_VERSION="5";function loadDatabaseSync(loadModule){try{const loaded=loadModule(["node","sqlite"].join(":"));return loaded.DatabaseSync??null}catch{return null}}let RuntimeDatabaseSync;function loadStableDatabaseSync(nodeVersion,loadModule){const nodeMajor=Number.parseInt(nodeVersion,10);return Number.isFinite(nodeMajor)&&nodeMajor>=22?loadDatabaseSync(loadModule):null}function resolveDatabaseSync(){if(RuntimeDatabaseSync!==void 0)return RuntimeDatabaseSync;RuntimeDatabaseSync=loadStableDatabaseSync(process.versions.node,createRequire(import.meta.url));return RuntimeDatabaseSync}function normalizeIndexWindowValue(value,fallback){return Math.max(0,Math.floor(value===void 0?fallback:value))}function queryIndexPath(pmRoot){return path.join(pmRoot,"runtime",QUERY_INDEX_FILENAME)}function createSchema(database){database.exec(`
     PRAGMA foreign_keys = ON;
     PRAGMA journal_mode = OFF;
     PRAGMA synchronous = OFF;
@@ -95,18 +53,7 @@ function createSchema(database) {
       tags,
       tokenize = 'unicode61'
     );
-  `);
-}
-function writeMetadata(database, key, value) {
-    database
-        .prepare("INSERT INTO metadata(key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value")
-        .run(key, value);
-}
-/** Upsert authoritative metadata and replace dependent search, key and linked-file rows in the caller transaction. */
-function insertRow(database, row) {
-    const metadata = row.metadata;
-    database
-        .prepare(`INSERT INTO items(
+  `)}function writeMetadata(database,key,value){database.prepare("INSERT INTO metadata(key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value").run(key,value)}function insertRow(database,row){const metadata=row.metadata;database.prepare(`INSERT INTO items(
         id, relative_path, metadata_json, status, type, priority,
         updated_at, created_at, parent, assignee, sprint, release
       ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
@@ -121,356 +68,24 @@ function insertRow(database, row) {
         parent = excluded.parent,
         assignee = excluded.assignee,
         sprint = excluded.sprint,
-        release = excluded.release`)
-        .run(metadata.id, row.relativePath, JSON.stringify(metadata), metadata.status, metadata.type, metadata.priority, metadata.updated_at, metadata.created_at, metadata.parent ?? null, metadata.assignee ?? null, metadata.sprint ?? null, metadata.release ?? null);
-    database
-        .prepare("DELETE FROM item_metadata_keys WHERE item_id = ?")
-        .run(metadata.id);
-    database
-        .prepare("DELETE FROM item_linked_files WHERE item_id = ?")
-        .run(metadata.id);
-    // FTS UNINDEXED columns cannot provide identity lookup. Share the items rowid
-    // so both rebuilding and incremental maintenance use a single indexed row.
-    database.prepare("DELETE FROM item_search WHERE rowid = (SELECT rowid FROM items WHERE id = ?)").run(metadata.id);
-    database
-        .prepare("INSERT INTO item_search(rowid, id, title, description, tags) SELECT rowid, ?, ?, ?, ? FROM items WHERE id = ?")
-        .run(metadata.id, metadata.title, metadata.description, metadata.tags.join(" "), metadata.id);
-    const insertMetadataKey = database.prepare("INSERT INTO item_metadata_keys(item_id, key) VALUES (?, ?)");
-    for (const key of Object.keys(metadata)) {
-        insertMetadataKey.run(metadata.id, key);
-    }
-    const insertLinkedFile = database.prepare("INSERT INTO item_linked_files(item_id, path, scope, note) VALUES (?, ?, ?, ?)");
-    for (const file of row.linkedFiles ?? []) {
-        insertLinkedFile.run(metadata.id, file.path, file.scope, file.note ?? null);
-    }
-}
-/** Atomically rebuild the complete query projection from authoritative cache rows. */
-export async function rebuildItemMetadataQueryIndex(options) {
-    const targetPath = queryIndexPath(options.pmRoot);
-    const Database = resolveDatabaseSync();
-    if (!Database) {
-        await fs.rm(targetPath, { force: true });
-        return;
-    }
-    await fs.mkdir(path.dirname(targetPath), { recursive: true });
-    const temporaryPath = `${targetPath}.${randomUUID()}.tmp`;
-    let database;
-    try {
-        database = new Database(temporaryPath);
-        createSchema(database);
-        database.exec("BEGIN IMMEDIATE");
-        writeMetadata(database, "version", QUERY_INDEX_VERSION);
-        writeMetadata(database, "context_fingerprint", options.contextFingerprint);
-        writeMetadata(database, "source_cursor", options.sourceCursor);
-        for (const row of options.rows)
-            insertRow(database, row);
-        database.exec("COMMIT");
-        database.close();
-        database = undefined;
-        await fs.rm(targetPath, { force: true });
-        await fs.rename(temporaryPath, targetPath);
-    }
-    catch (error) {
-        database?.close();
-        await Promise.allSettled([fs.rm(temporaryPath, { force: true })]);
-        throw error;
-    }
-}
-function readIndexMetadata(database) {
-    return Object.fromEntries(database
-        .prepare("SELECT key, value FROM metadata")
-        .all()
-        .map((row) => [String(row.key), String(row.value)]));
-}
-/**
- * Apply one authoritative metadata mutation in the same writer critical
- * section as the JSON derived-index delta. A cursor mismatch fails closed so
- * callers can remove and lazily rebuild this optional projection.
- */
-export async function updateItemMetadataQueryIndex(options) {
-    const Database = resolveDatabaseSync();
-    if (!Database)
-        return false;
-    const indexPath = queryIndexPath(options.pmRoot);
-    let database;
-    try {
-        await fs.access(indexPath);
-        database = new Database(indexPath);
-        database.exec("PRAGMA foreign_keys = ON");
-        const metadata = readIndexMetadata(database);
-        if (metadata.version !== QUERY_INDEX_VERSION ||
-            metadata.context_fingerprint !== options.contextFingerprint ||
-            metadata.source_cursor !== options.expectedSourceCursor) {
-            database.close();
-            return false;
-        }
-        database.exec("BEGIN IMMEDIATE");
-        const deleteByPath = database.prepare("DELETE FROM items WHERE relative_path = ?");
-        const findRowidByPath = database.prepare("SELECT rowid FROM items WHERE relative_path = ?");
-        const deleteSearchByRowid = database.prepare("DELETE FROM item_search WHERE rowid = ?");
-        for (const relativePath of options.deletedRelativePaths ?? []) {
-            const deleted = findRowidByPath.get(relativePath);
-            deleteByPath.run(relativePath);
-            if (deleted)
-                deleteSearchByRowid.run(deleted.rowid);
-        }
-        if (options.row)
-            insertRow(database, options.row);
-        writeMetadata(database, "source_cursor", options.sourceCursor);
-        database.exec("COMMIT");
-        database.close();
-        return true;
-    }
-    catch {
-        try {
-            database?.exec("ROLLBACK");
-        }
-        catch {
-            // The optional query projection will be invalidated below.
-        }
-        database?.close();
-        return false;
-    }
-}
-function appendSetPredicate(clauses, parameters, column, values, operator) {
-    if (!values || values.length === 0)
-        return;
-    clauses.push(`${column} ${operator} (${values.map(() => "?").join(", ")})`);
-    parameters.push(...values);
-}
-function buildQueryPredicates(query) {
-    const clauses = [];
-    const parameters = [];
-    appendSetPredicate(clauses, parameters, "status", query.statuses, "IN");
-    appendSetPredicate(clauses, parameters, "status", query.excludeStatuses, "NOT IN");
-    appendSetPredicate(clauses, parameters, "type", query.types, "IN");
-    appendSetPredicate(clauses, parameters, "id", query.ids, "IN");
-    for (const metadataKey of query.metadataKeys ?? []) {
-        clauses.push("EXISTS (SELECT 1 FROM item_metadata_keys AS indexed_key WHERE indexed_key.item_id = items.id AND indexed_key.key = ?)");
-        parameters.push(metadataKey);
-    }
-    for (const [column, value] of [
-        ["parent", query.parent],
-        ["assignee", query.assignee],
-        ["sprint", query.sprint],
-        ["release", query.release],
-    ]) {
-        if (value !== undefined) {
-            clauses.push(`${column} = ?`);
-            parameters.push(value);
-        }
-    }
-    if (query.priority !== undefined) {
-        clauses.push("priority = ?");
-        parameters.push(query.priority);
-    }
-    return {
-        where: clauses.length === 0 ? "" : ` WHERE ${clauses.join(" AND ")}`,
-        parameters,
-    };
-}
-/**
- * Query the persistent projection without materializing the full metadata
- * cache. Returns null when the database is absent, stale, corrupt, or active
- * extension read hooks require canonical per-document dispatch.
- */
-export async function queryItemMetadataIndex(options) {
-    const Database = resolveDatabaseSync();
-    if (!Database)
-        return null;
-    const query = options.query ?? {};
-    const { where, parameters } = buildQueryPredicates(query);
-    let database;
-    try {
-        database = new Database(queryIndexPath(options.pmRoot), {
-            readOnly: true,
-        });
-        const metadata = readIndexMetadata(database);
-        if (metadata.version !== QUERY_INDEX_VERSION ||
-            metadata.source_cursor !== options.expectedSourceCursor) {
-            database.close();
-            return null;
-        }
-        const totalRow = database
-            .prepare(`SELECT COUNT(*) AS count FROM items${where}`)
-            .get(...parameters);
-        const windowParameters = [];
-        let window = "";
-        if (query.limit !== undefined) {
-            window += " LIMIT ?";
-            windowParameters.push(Math.max(0, Math.floor(query.limit)));
-            if (query.offset !== undefined) {
-                window += " OFFSET ?";
-                windowParameters.push(Math.max(0, Math.floor(query.offset)));
-            }
-        }
-        else if (query.offset !== undefined) {
-            window += " LIMIT -1 OFFSET ?";
-            windowParameters.push(Math.max(0, Math.floor(query.offset)));
-        }
-        const rows = database
-            .prepare(`SELECT metadata_json FROM items${where}
-         ORDER BY ${query.terminalStatuses && query.terminalStatuses.length > 0
-            ? `CASE WHEN status IN (${query.terminalStatuses
-                .map(() => "?")
-                .join(", ")}) THEN 1 ELSE 0 END ASC, `
-            : ""}priority ASC, updated_at DESC, id ASC${window}`)
-            .all(...parameters, ...(query.terminalStatuses ?? []), ...windowParameters);
-        const items = rows.map((row) => {
-            const parsed = JSON.parse(String(row.metadata_json));
-            if (!parsed.id)
-                throw new TypeError("Indexed metadata row has no id");
-            return parsed;
-        });
-        database.close();
-        return {
-            source_cursor: metadata.source_cursor,
-            total: Number(totalRow.count),
-            items,
-        };
-    }
-    catch {
-        database?.close();
-        return null;
-    }
-}
-/**
- * Resolve items that link any requested project-relative path without loading
- * heavy item collections. Returns null when the optional projection is absent,
- * stale, or corrupt so callers can fall back to authoritative item reads.
- */
-export async function queryLinkedFileMetadataIndex(options) {
-    const Database = resolveDatabaseSync();
-    if (!Database || options.paths.length === 0)
-        return null;
-    let database;
-    try {
-        database = new Database(queryIndexPath(options.pmRoot), {
-            readOnly: true,
-        });
-        const metadata = readIndexMetadata(database);
-        if (metadata.version !== QUERY_INDEX_VERSION ||
-            metadata.source_cursor !== options.expectedSourceCursor) {
-            database.close();
-            return null;
-        }
-        const pathPlaceholders = options.paths.map(() => "?").join(", ");
-        const scopePredicate = options.scope === undefined ? "" : " AND scope = ?";
-        const matchParameters = [
-            ...options.paths,
-            ...(options.scope === undefined ? [] : [options.scope]),
-        ];
-        const predicate = `path IN (${pathPlaceholders})${scopePredicate}`;
-        const totalRow = database
-            .prepare(`SELECT COUNT(DISTINCT item_id) AS count
+        release = excluded.release`).run(metadata.id,row.relativePath,JSON.stringify(metadata),metadata.status,metadata.type,metadata.priority,metadata.updated_at,metadata.created_at,metadata.parent??null,metadata.assignee??null,metadata.sprint??null,metadata.release??null);database.prepare("DELETE FROM item_metadata_keys WHERE item_id = ?").run(metadata.id);database.prepare("DELETE FROM item_linked_files WHERE item_id = ?").run(metadata.id);database.prepare("DELETE FROM item_search WHERE rowid = (SELECT rowid FROM items WHERE id = ?)").run(metadata.id);database.prepare("INSERT INTO item_search(rowid, id, title, description, tags) SELECT rowid, ?, ?, ?, ? FROM items WHERE id = ?").run(metadata.id,metadata.title,metadata.description,metadata.tags.join(" "),metadata.id);const insertMetadataKey=database.prepare("INSERT INTO item_metadata_keys(item_id, key) VALUES (?, ?)");for(const key of Object.keys(metadata)){insertMetadataKey.run(metadata.id,key)}const insertLinkedFile=database.prepare("INSERT INTO item_linked_files(item_id, path, scope, note) VALUES (?, ?, ?, ?)");for(const file of row.linkedFiles??[]){insertLinkedFile.run(metadata.id,file.path,file.scope,file.note??null)}}async function rebuildItemMetadataQueryIndex(options){const targetPath=queryIndexPath(options.pmRoot);const Database=resolveDatabaseSync();if(!Database){await fs.rm(targetPath,{force:true});return}await fs.mkdir(path.dirname(targetPath),{recursive:true});const temporaryPath=`${targetPath}.${randomUUID()}.tmp`;let database;try{database=new Database(temporaryPath);createSchema(database);database.exec("BEGIN IMMEDIATE");writeMetadata(database,"version",QUERY_INDEX_VERSION);writeMetadata(database,"context_fingerprint",options.contextFingerprint);writeMetadata(database,"source_cursor",options.sourceCursor);for(const row of options.rows)insertRow(database,row);database.exec("COMMIT");database.close();database=void 0;await fs.rm(targetPath,{force:true});await fs.rename(temporaryPath,targetPath)}catch(error){database?.close();await Promise.allSettled([fs.rm(temporaryPath,{force:true})]);throw error}}function readIndexMetadata(database){return Object.fromEntries(database.prepare("SELECT key, value FROM metadata").all().map(row=>[String(row.key),String(row.value)]))}async function updateItemMetadataQueryIndex(options){const Database=resolveDatabaseSync();if(!Database)return false;const indexPath=queryIndexPath(options.pmRoot);let database;try{await fs.access(indexPath);database=new Database(indexPath);database.exec("PRAGMA foreign_keys = ON");const metadata=readIndexMetadata(database);if(metadata.version!==QUERY_INDEX_VERSION||metadata.context_fingerprint!==options.contextFingerprint||metadata.source_cursor!==options.expectedSourceCursor){database.close();return false}database.exec("BEGIN IMMEDIATE");const deleteByPath=database.prepare("DELETE FROM items WHERE relative_path = ?");const findRowidByPath=database.prepare("SELECT rowid FROM items WHERE relative_path = ?");const deleteSearchByRowid=database.prepare("DELETE FROM item_search WHERE rowid = ?");for(const relativePath of options.deletedRelativePaths??[]){const deleted=findRowidByPath.get(relativePath);deleteByPath.run(relativePath);if(deleted)deleteSearchByRowid.run(deleted.rowid)}if(options.row)insertRow(database,options.row);writeMetadata(database,"source_cursor",options.sourceCursor);database.exec("COMMIT");database.close();return true}catch{try{database?.exec("ROLLBACK")}catch{}database?.close();return false}}function appendSetPredicate(clauses,parameters,column,values,operator){if(!values||values.length===0)return;clauses.push(`${column} ${operator} (${values.map(()=>"?").join(", ")})`);parameters.push(...values)}function buildQueryPredicates(query){const clauses=[];const parameters=[];appendSetPredicate(clauses,parameters,"status",query.statuses,"IN");appendSetPredicate(clauses,parameters,"status",query.excludeStatuses,"NOT IN");appendSetPredicate(clauses,parameters,"type",query.types,"IN");appendSetPredicate(clauses,parameters,"id",query.ids,"IN");for(const metadataKey of query.metadataKeys??[]){clauses.push("EXISTS (SELECT 1 FROM item_metadata_keys AS indexed_key WHERE indexed_key.item_id = items.id AND indexed_key.key = ?)");parameters.push(metadataKey)}for(const[column,value]of[["parent",query.parent],["assignee",query.assignee],["sprint",query.sprint],["release",query.release]]){if(value!==void 0){clauses.push(`${column} = ?`);parameters.push(value)}}if(query.priority!==void 0){clauses.push("priority = ?");parameters.push(query.priority)}return{where:clauses.length===0?"":` WHERE ${clauses.join(" AND ")}`,parameters}}async function queryItemMetadataIndex(options){const Database=resolveDatabaseSync();if(!Database)return null;const query=options.query??{};const{where,parameters}=buildQueryPredicates(query);let database;try{database=new Database(queryIndexPath(options.pmRoot),{readOnly:true});const metadata=readIndexMetadata(database);if(metadata.version!==QUERY_INDEX_VERSION||metadata.source_cursor!==options.expectedSourceCursor){database.close();return null}const totalRow=database.prepare(`SELECT COUNT(*) AS count FROM items${where}`).get(...parameters);const windowParameters=[];let window2="";if(query.limit!==void 0){window2+=" LIMIT ?";windowParameters.push(Math.max(0,Math.floor(query.limit)));if(query.offset!==void 0){window2+=" OFFSET ?";windowParameters.push(Math.max(0,Math.floor(query.offset)))}}else if(query.offset!==void 0){window2+=" LIMIT -1 OFFSET ?";windowParameters.push(Math.max(0,Math.floor(query.offset)))}const rows=database.prepare(`SELECT metadata_json FROM items${where}
+         ORDER BY ${query.terminalStatuses&&query.terminalStatuses.length>0?`CASE WHEN status IN (${query.terminalStatuses.map(()=>"?").join(", ")}) THEN 1 ELSE 0 END ASC, `:""}priority ASC, updated_at DESC, id ASC${window2}`).all(...parameters,...query.terminalStatuses??[],...windowParameters);const items=rows.map(row=>{const parsed=JSON.parse(String(row.metadata_json));if(!parsed.id)throw new TypeError("Indexed metadata row has no id");return parsed});database.close();return{source_cursor:metadata.source_cursor,total:Number(totalRow.count),items}}catch{database?.close();return null}}async function queryLinkedFileMetadataIndex(options){const Database=resolveDatabaseSync();if(!Database||options.paths.length===0)return null;let database;try{database=new Database(queryIndexPath(options.pmRoot),{readOnly:true});const metadata=readIndexMetadata(database);if(metadata.version!==QUERY_INDEX_VERSION||metadata.source_cursor!==options.expectedSourceCursor){database.close();return null}const pathPlaceholders=options.paths.map(()=>"?").join(", ");const scopePredicate=options.scope===void 0?"":" AND scope = ?";const matchParameters=[...options.paths,...options.scope===void 0?[]:[options.scope]];const predicate=`path IN (${pathPlaceholders})${scopePredicate}`;const totalRow=database.prepare(`SELECT COUNT(DISTINCT item_id) AS count
          FROM item_linked_files
-         WHERE ${predicate}`)
-            .get(...matchParameters);
-        const limit = normalizeIndexWindowValue(options.limit, 50);
-        const offset = normalizeIndexWindowValue(options.offset, 0);
-        const itemRows = database
-            .prepare(`SELECT items.id, items.metadata_json
+         WHERE ${predicate}`).get(...matchParameters);const limit=normalizeIndexWindowValue(options.limit,50);const offset=normalizeIndexWindowValue(options.offset,0);const itemRows=database.prepare(`SELECT items.id, items.metadata_json
          FROM items
          WHERE EXISTS (
            SELECT 1 FROM item_linked_files
            WHERE item_linked_files.item_id = items.id AND ${predicate}
          )
          ORDER BY items.priority ASC, items.updated_at DESC, items.id ASC
-         LIMIT ? OFFSET ?`)
-            .all(...matchParameters, limit, offset);
-        const matches = [];
-        if (itemRows.length > 0) {
-            const itemIds = itemRows.map((row) => String(row.id));
-            const linkedRows = database
-                .prepare(`SELECT item_id, path, scope, note
+         LIMIT ? OFFSET ?`).all(...matchParameters,limit,offset);const matches=[];if(itemRows.length>0){const itemIds=itemRows.map(row=>String(row.id));const linkedRows=database.prepare(`SELECT item_id, path, scope, note
            FROM item_linked_files
-           WHERE item_id IN (${itemIds.map(() => "?").join(", ")})
+           WHERE item_id IN (${itemIds.map(()=>"?").join(", ")})
              AND ${predicate}
-           ORDER BY path ASC, scope ASC`)
-                .all(...itemIds, ...matchParameters);
-            const filesByItem = new Map(itemIds.map((itemId) => [itemId, []]));
-            for (const row of linkedRows) {
-                const itemId = String(row.item_id);
-                const files = filesByItem.get(itemId);
-                files.push({
-                    path: String(row.path),
-                    scope: String(row.scope),
-                    ...(row.note === null ? {} : { note: String(row.note) }),
-                });
-                filesByItem.set(itemId, files);
-            }
-            for (const row of itemRows) {
-                const item = JSON.parse(String(row.metadata_json));
-                matches.push({ item, files: filesByItem.get(String(row.id)) });
-            }
-        }
-        database.close();
-        return {
-            source_cursor: metadata.source_cursor,
-            total: Number(totalRow.count),
-            matches,
-        };
-    }
-    catch {
-        database?.close();
-        return null;
-    }
-}
-/**
- * Query FTS-ranked item candidates without materializing the workspace. The
- * caller owns final similarity scoring and threshold semantics.
- */
-export async function querySimilarItemMetadataIndex(options) {
-    const Database = resolveDatabaseSync();
-    if (!Database)
-        return null;
-    let database;
-    try {
-        database = new Database(queryIndexPath(options.pmRoot), {
-            readOnly: true,
-        });
-        const metadata = readIndexMetadata(database);
-        if (metadata.version !== QUERY_INDEX_VERSION ||
-            metadata.source_cursor !== options.expectedSourceCursor) {
-            database.close();
-            return null;
-        }
-        const rows = database
-            .prepare(`SELECT items.metadata_json
+           ORDER BY path ASC, scope ASC`).all(...itemIds,...matchParameters);const filesByItem=new Map(itemIds.map(itemId=>[itemId,[]]));for(const row of linkedRows){const itemId=String(row.item_id);const files=filesByItem.get(itemId);files.push({path:String(row.path),scope:String(row.scope),...row.note===null?{}:{note:String(row.note)}});filesByItem.set(itemId,files)}for(const row of itemRows){const item=JSON.parse(String(row.metadata_json));matches.push({item,files:filesByItem.get(String(row.id))})}}database.close();return{source_cursor:metadata.source_cursor,total:Number(totalRow.count),matches}}catch{database?.close();return null}}async function querySimilarItemMetadataIndex(options){const Database=resolveDatabaseSync();if(!Database)return null;let database;try{database=new Database(queryIndexPath(options.pmRoot),{readOnly:true});const metadata=readIndexMetadata(database);if(metadata.version!==QUERY_INDEX_VERSION||metadata.source_cursor!==options.expectedSourceCursor){database.close();return null}const rows=database.prepare(`SELECT items.metadata_json
          FROM item_search
          JOIN items ON items.id = item_search.id
          WHERE item_search MATCH ?
          ORDER BY bm25(item_search), items.priority, items.updated_at DESC, items.id
-         LIMIT ?`)
-            .all(options.query, Math.max(0, Math.floor(options.limit)));
-        const items = rows.map((row) => JSON.parse(String(row.metadata_json)));
-        database.close();
-        return {
-            source_cursor: metadata.source_cursor,
-            items,
-        };
-    }
-    catch {
-        database?.close();
-        return null;
-    }
-}
-/** Remove only the optional SQLite query projection. */
-export async function removeItemMetadataQueryIndex(pmRoot) {
-    await fs.rm(queryIndexPath(pmRoot), { force: true });
-}
-/** Test-only dependency seam for runtimes that do not implement node:sqlite. */
-export const _testOnly = {
-    loadDatabaseSync,
-    loadStableDatabaseSync,
-    /** Replace the optional constructor and return a restoration callback. */
-    setDatabaseSync(databaseSync) {
-        const previous = RuntimeDatabaseSync;
-        RuntimeDatabaseSync = databaseSync;
-        return () => {
-            RuntimeDatabaseSync = previous;
-        };
-    },
-};
+         LIMIT ?`).all(options.query,Math.max(0,Math.floor(options.limit)));const items=rows.map(row=>JSON.parse(String(row.metadata_json)));database.close();return{source_cursor:metadata.source_cursor,items}}catch{database?.close();return null}}async function removeItemMetadataQueryIndex(pmRoot){await fs.rm(queryIndexPath(pmRoot),{force:true})}const _testOnly={loadDatabaseSync,loadStableDatabaseSync,setDatabaseSync(databaseSync){const previous=RuntimeDatabaseSync;RuntimeDatabaseSync=databaseSync;return()=>{RuntimeDatabaseSync=previous}}};export{_testOnly,queryItemMetadataIndex,queryLinkedFileMetadataIndex,querySimilarItemMetadataIndex,rebuildItemMetadataQueryIndex,removeItemMetadataQueryIndex,updateItemMetadataQueryIndex};
 //# sourceMappingURL=item-metadata-query-index.js.map
-//# debugId=530ad63f-f7c5-52c9-9f81-a74b1cd4c36e

package/dist/core/store/item-metadata-read-work.js

@@ -1,44 +1,2 @@
-/**
- * @module core/store/item-metadata-read-work
- *
- * Measures successful filesystem metadata enumerations within one async SDK
- * operation. Cache hits count too: materializing a cached corpus is still work.
- */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="1cd39e2f-41c7-5005-925d-d4539cda15d3")}catch(e){}}();
-import { AsyncLocalStorage } from "node:async_hooks";
-import { channel } from "node:diagnostics_channel";
-const observers = new AsyncLocalStorage();
-const enumerations = channel("@unbrained/pm-cli/item-metadata-enumeration/v1");
-/** Record completed enumeration in each enclosing measurement, without retaining item data. */
-export function recordItemMetadataEnumeration(rowCount) {
-    enumerations.publish(rowCount);
-}
-/**
- * Measure an awaited operation without changing its result or failure semantics.
- * Concurrent roots remain isolated; nested measurements also contribute to their
- * parents. The returned snapshot excludes work completed after the operation.
- * Counters cover filesystem item-store enumeration APIs, not arbitrary host I/O.
- */
-export async function measureItemMetadataReadWork(operation) {
-    const work = { enumeration_calls: 0, metadata_rows: 0 };
-    // A named channel crosses the published query/bundled runtime boundary;
-    // async membership prevents concurrent roots from counting each other's work.
-    /** Count notifications only while this measurement belongs to the active async scope. */
-    const observe = (message) => {
-        if (observers.getStore()?.includes(work)) {
-            work.enumeration_calls += 1;
-            work.metadata_rows += message;
-        }
-    };
-    enumerations.subscribe(observe);
-    try {
-        const result = await observers.run([...(observers.getStore() ?? []), work], operation);
-        return { result, work: { ...work } };
-    }
-    finally {
-        enumerations.unsubscribe(observe);
-    }
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="118ec110-fa84-550b-a0a8-4def314270b6")}catch(e2){}})();import{AsyncLocalStorage}from"node:async_hooks";import{channel}from"node:diagnostics_channel";const observers=new AsyncLocalStorage;const enumerations=channel("@unbrained/pm-cli/item-metadata-enumeration/v1");function recordItemMetadataEnumeration(rowCount){enumerations.publish(rowCount)}async function measureItemMetadataReadWork(operation){const work={enumeration_calls:0,metadata_rows:0};const observe=message=>{if(observers.getStore()?.includes(work)){work.enumeration_calls+=1;work.metadata_rows+=message}};enumerations.subscribe(observe);try{const result=await observers.run([...observers.getStore()??[],work],operation);return{result,work:{...work}}}finally{enumerations.unsubscribe(observe)}}export{measureItemMetadataReadWork,recordItemMetadataEnumeration};
 //# sourceMappingURL=item-metadata-read-work.js.map
-//# debugId=1cd39e2f-41c7-5005-925d-d4539cda15d3