@aprimediet/codewalker 1.2.0 → 1.3.0

package/src/query.ts

@@ -2,16 +2,16 @@
  * Query orchestration: wraps DB search with staleness detection.
  */
 
-import type { QueryResult, QueryResultRow, StalenessInfo } from "./types.ts";
-import { openDb, searchSymbols, searchLibSymbols, getMeta } from "./db.ts";
+import type { QueryResult, QueryResultRow, StalenessInfo, NoteKind } from "./types.ts";
+import { openDb, searchSymbols, searchLibSymbols, searchNotes, getMeta } from "./db.ts";
 import { getHeadSha, changedFilesSince } from "./git.ts";
 
 export interface QueryParams {
   query: string;
   kind?: string;
   limit?: number;
-  /** Source scope: "code" (default, only code symbols), "libs" (only lib symbols), or "all" (both). */
-  source?: "code" | "libs" | "all";
+  /** Source scope: "code" (default, only code symbols), "libs" (only lib symbols), "notes" (only notes), or "all" (all three). */
+  source?: "code" | "libs" | "notes" | "all";
 }
 
 /**
@@ -36,13 +36,17 @@ export function runQuery(
 
     if (source === "libs") {
       rows = searchLibSymbols(db, params.query, params.kind, limit) as unknown as QueryResultRow[];
+    } else if (source === "notes") {
+      const noteRows = searchNotes(db, params.query, params.kind as NoteKind | undefined, limit);
+      rows = noteRows as unknown as QueryResultRow[];
     } else if (source === "all") {
-      // Run both code and lib searches, merge, sort by score, apply limit
+      // Run code + lib + note searches, merge, sort by score, apply limit
       const codeRows = searchSymbols(db, params.query, params.kind, limit);
       const libRows = searchLibSymbols(db, params.query, params.kind, limit) as unknown as QueryResultRow[];
+      const noteRows = searchNotes(db, params.query, params.kind as NoteKind | undefined, limit * 2) as unknown as QueryResultRow[];
 
       // Merge and sort by score ascending (lower bm25 = better match)
-      const merged: QueryResultRow[] = [...codeRows, ...libRows];
+      const merged: QueryResultRow[] = [...codeRows, ...libRows, ...noteRows];
       merged.sort((a, b) => a.score - b.score);
       rows = merged.slice(0, limit);
     } else {

package/src/types.ts

@@ -64,6 +64,19 @@ export interface CardHead {
   summary: string;
 }
 
+/** Note kind discriminator for bridge cards. */
+export type NoteKind = "glossary" | "decision";
+
+/** A glossary/decision note (bridge card) for conceptual knowledge. */
+export interface Note {
+  note_kind: NoteKind;
+  title: string;
+  body: string;
+  tags: string;
+  related: string;
+  card_path: string;
+}
+
 /** A single row returned from a query. */
 export interface QueryResultRow {
   name: string;
@@ -75,10 +88,13 @@ export interface QueryResultRow {
   summary: string;
   score: number;
   id: number;
-  /** Origin fields — code rows omit these; lib rows set them. */
-  source?: "code" | "lib";
+  /** Origin fields — code rows omit these; lib / note rows set them. */
+  source?: "code" | "lib" | "note";
   lib?: string;
   version?: string;
+  /** Note-specific fields — only for source === "note" rows. */
+  note_kind?: NoteKind;
+  tags?: string;
 }
 
 /** The full result of a query, including staleness info. */