@gmickel/gno 1.2.0 → 1.3.0

package/src/store/content-batch.ts

@@ -0,0 +1,38 @@
+import type { StorePort, StoreResult } from "./types";
+
+import { err, ok } from "./types";
+
+/**
+ * Load content in batch when the store supports it.
+ * Falls back to sequential reads for lightweight test doubles.
+ */
+export async function getContentBatch(
+  store: StorePort,
+  mirrorHashes: string[]
+): Promise<StoreResult<Map<string, string>>> {
+  const uniqueHashes = [...new Set(mirrorHashes)];
+  if (uniqueHashes.length === 0) {
+    return ok(new Map());
+  }
+
+  if (store.getContentBatch) {
+    return store.getContentBatch(uniqueHashes);
+  }
+
+  const contentByHash = new Map<string, string>();
+  for (const mirrorHash of uniqueHashes) {
+    const contentResult = await store.getContent(mirrorHash);
+    if (!contentResult.ok) {
+      return err(
+        "QUERY_FAILED",
+        contentResult.error.message,
+        contentResult.error.cause
+      );
+    }
+    if (contentResult.value !== null) {
+      contentByHash.set(mirrorHash, contentResult.value);
+    }
+  }
+
+  return ok(contentByHash);
+}

package/src/store/sqlite/adapter.ts

@@ -42,7 +42,7 @@ import type {
 } from "../types";
 import type { SqliteDbProvider } from "./types";
 
-import { buildUri, deriveDocid } from "../../app/constants";
+import { buildUri, deriveDocid, stripUriIndex } from "../../app/constants";
 import { normalizeWikiName, stripWikiMdExt } from "../../core/links";
 import { migrations, runMigrations } from "../migrations";
 import { err, ok } from "../types";
@@ -675,9 +675,10 @@ export class SqliteAdapter implements StorePort, SqliteDbProvider {
   ): Promise<StoreResult<DocumentRow | null>> {
     try {
       const db = this.ensureOpen();
+      const canonicalUri = stripUriIndex(uri);
       const row = db
         .query<DbDocumentRow, [string]>("SELECT * FROM documents WHERE uri = ?")
-        .get(uri);
+        .get(canonicalUri);
 
       return ok(row ? mapDocumentRow(row) : null);
     } catch (cause) {
@@ -1048,6 +1049,41 @@ export class SqliteAdapter implements StorePort, SqliteDbProvider {
     }
   }
 
+  async getContentBatch(
+    mirrorHashes: string[]
+  ): Promise<StoreResult<Map<string, string>>> {
+    try {
+      const db = this.ensureOpen();
+
+      if (mirrorHashes.length === 0) {
+        return ok(new Map());
+      }
+
+      interface DbContentRow {
+        mirror_hash: string;
+        markdown: string;
+      }
+
+      const placeholders = mirrorHashes.map(() => "?").join(", ");
+      const rows = db
+        .query<DbContentRow, string[]>(
+          `SELECT mirror_hash, markdown FROM content
+           WHERE mirror_hash IN (${placeholders})`
+        )
+        .all(...mirrorHashes);
+
+      return ok(
+        new Map(rows.map((row) => [row.mirror_hash, row.markdown] as const))
+      );
+    } catch (cause) {
+      return err(
+        "QUERY_FAILED",
+        cause instanceof Error ? cause.message : "Failed to get content batch",
+        cause
+      );
+    }
+  }
+
   // ─────────────────────────────────────────────────────────────────────────
   // Chunks
   // ─────────────────────────────────────────────────────────────────────────

package/src/store/types.ts

@@ -694,6 +694,14 @@ export interface StorePort {
    */
   getContent(mirrorHash: string): Promise<StoreResult<string | null>>;
 
+  /**
+   * Batch fetch markdown content for multiple mirror hashes.
+   * Returns a map of mirrorHash -> markdown for hashes that exist.
+   */
+  getContentBatch?(
+    mirrorHashes: string[]
+  ): Promise<StoreResult<Map<string, string>>>;
+
   // ─────────────────────────────────────────────────────────────────────────
   // Chunks
   // ─────────────────────────────────────────────────────────────────────────

package/src/store/vector/sqlite-vec.ts

@@ -66,6 +66,14 @@ export interface VectorIndexOptions {
   distanceMetric?: "cosine" | "l2";
 }
 
+const SQLITE_VEC_GUIDANCE =
+  "Run `gno doctor` for sqlite-vec diagnostics. On macOS, verify Homebrew SQLite/sqlite-vec installation and see TROUBLESHOOTING.md.";
+
+function formatUnavailableMessage(loadError?: string): string {
+  const reason = loadError ? ` Reason: ${loadError}` : "";
+  return `Vector search requires sqlite-vec. Embeddings are stored, but KNN search is disabled.${reason} ${SQLITE_VEC_GUIDANCE}`;
+}
+
 /**
  * Create a VectorIndexPort for a specific model.
  * sqlite-vec is optional - storage works without it, search disabled.
@@ -147,6 +155,7 @@ export async function createVectorIndexPort(
     model,
     dimensions,
     loadError,
+    guidance: searchAvailable ? undefined : SQLITE_VEC_GUIDANCE,
     get vecDirty() {
       return vecDirty;
     },
@@ -235,10 +244,7 @@ export async function createVectorIndexPort(
     ): Promise<StoreResult<VectorSearchResult[]>> {
       if (!(searchAvailable && searchStmt)) {
         return Promise.resolve(
-          err(
-            "VEC_SEARCH_UNAVAILABLE",
-            "Vector search requires sqlite-vec. Embeddings stored but KNN search disabled."
-          )
+          err("VEC_SEARCH_UNAVAILABLE", formatUnavailableMessage(loadError))
         );
       }
 

package/src/store/vector/types.ts

@@ -60,6 +60,8 @@ export interface VectorIndexPort {
   readonly dimensions: number;
   /** Error message if sqlite-vec failed to load (for diagnostics) */
   readonly loadError?: string;
+  /** User-facing recovery guidance when search is unavailable */
+  readonly guidance?: string;
   /** True if vec0 inserts failed during this session (needs sync) */
   vecDirty: boolean;