@voidwire/lore 0.1.4 → 0.1.6

package/cli.ts

@@ -11,7 +11,7 @@
  *   lore search <query>                   Search all sources
  *   lore search <source> <query>          Search specific source
  *   lore list <domain>                    List domain entries
- *   lore capture task|knowledge|note      Capture knowledge
+ *   lore capture task|knowledge|note|teaching  Capture knowledge
  *
  * Exit codes:
  *   0 - Success
@@ -29,6 +29,7 @@ import {
   captureTask,
   captureKnowledge,
   captureNote,
+  captureTeaching,
   semanticSearch,
   isOllamaAvailable,
   hasEmbeddings,
@@ -40,6 +41,7 @@ import {
   type TaskInput,
   type KnowledgeInput,
   type NoteInput,
+  type TeachingInput,
   type KnowledgeCaptureType,
 } from "./index";
 
@@ -224,48 +226,51 @@ async function handleSearch(args: string[]): Promise<void> {
     return;
   }
 
-  // Route semantic vs FTS5 based on --exact flag and availability
-  if (!exact) {
+  // FTS5 path (explicit --exact only)
+  if (exact) {
     try {
-      const canUseSemantic = hasEmbeddings() && (await isOllamaAvailable());
-      if (canUseSemantic) {
-        const results = await semanticSearch(query, { source, limit });
-        output({
-          success: true,
-          results,
-          count: results.length,
-          mode: "semantic",
-        });
-        console.error(
-          `✅ ${results.length} result${results.length !== 1 ? "s" : ""} found (semantic)`,
-        );
-        process.exit(0);
-      }
-      // Fall through to FTS5 if semantic not available
-    } catch (error) {
-      // Semantic search failed, fall back to FTS5
+      const results = search(query, { source, limit, since });
+      output({
+        success: true,
+        results,
+        count: results.length,
+        mode: "exact",
+      });
       console.error(
-        `⚠️ Semantic search unavailable: ${error instanceof Error ? error.message : "Unknown error"}`,
+        `✅ ${results.length} result${results.length !== 1 ? "s" : ""} found (exact)`,
       );
+      process.exit(0);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      fail(message, 2);
     }
+    return;
+  }
+
+  // Semantic path (default) - fail if unavailable
+  if (!hasEmbeddings()) {
+    fail("No embeddings found. Run lore-embed-all first.", 2);
+  }
+
+  if (!(await isOllamaAvailable())) {
+    fail("Ollama not available. Start Ollama or check SQLITE_VEC_PATH.", 2);
   }
 
-  // FTS5 path (default fallback or explicit --exact)
   try {
-    const results = search(query, { source, limit, since });
+    const results = await semanticSearch(query, { source, limit });
     output({
       success: true,
       results,
       count: results.length,
-      mode: exact ? "exact" : "fts5",
+      mode: "semantic",
     });
     console.error(
-      `✅ ${results.length} result${results.length !== 1 ? "s" : ""} found (${exact ? "exact" : "fts5"})`,
+      `✅ ${results.length} result${results.length !== 1 ? "s" : ""} found (semantic)`,
     );
     process.exit(0);
   } catch (error) {
     const message = error instanceof Error ? error.message : "Unknown error";
-    fail(message, 2);
+    fail(`Semantic search failed: ${message}`, 2);
   }
 }
 
@@ -433,6 +438,34 @@ function handleCaptureNote(args: string[]): void {
   }
 }
 
+function handleCaptureTeaching(args: string[]): void {
+  const parsed = parseArgs(args);
+
+  const required = ["domain", "confidence", "text"];
+  const missing = required.filter((f) => !parsed.has(f));
+  if (missing.length > 0) {
+    fail(`Missing required fields: ${missing.join(", ")}`);
+  }
+
+  const input: TeachingInput = {
+    domain: parsed.get("domain")!,
+    confidence: parsed.get("confidence")!,
+    text: parsed.get("text")!,
+    source: parsed.get("source"),
+  };
+
+  const result = captureTeaching(input);
+  output(result);
+
+  if (result.success) {
+    console.error("✅ Teaching logged");
+    process.exit(0);
+  } else {
+    console.error(`❌ ${result.error}`);
+    process.exit(2);
+  }
+}
+
 function handleCapture(args: string[]): void {
   if (hasFlag(args, "help")) {
     showCaptureHelp();
@@ -455,9 +488,12 @@ function handleCapture(args: string[]): void {
     case "note":
       handleCaptureNote(captureArgs);
       break;
+    case "teaching":
+      handleCaptureTeaching(captureArgs);
+      break;
     default:
       fail(
-        `Unknown capture type: ${captureType}. Use: task, knowledge, or note`,
+        `Unknown capture type: ${captureType}. Use: task, knowledge, note, or teaching`,
       );
   }
 }
@@ -481,7 +517,7 @@ Usage:
   lore search --sources                 List indexed sources
   lore list <domain>                    List domain entries
   lore list --domains                   List available domains
-  lore capture task|knowledge|note      Capture knowledge
+  lore capture task|knowledge|note|teaching  Capture knowledge
 
 Search Options:
   --exact           Use FTS5 text search (bypasses semantic search)
@@ -515,6 +551,12 @@ Capture Types:
     --tags          Comma-separated tags
     --context       Optional context
 
+  teaching          Log teaching/learning
+    --domain        Subject area (required)
+    --confidence    Certainty level (required)
+    --text          Teaching content (required)
+    --source        Optional source identifier
+
 Examples:
   lore search "authentication"
   lore search blogs "typescript patterns"
@@ -620,6 +662,7 @@ Usage:
   lore capture task                     Log task completion
   lore capture knowledge                Log insight/learning
   lore capture note                     Quick note
+  lore capture teaching                 Log teaching moment
 
 Capture Types:
 
@@ -651,10 +694,19 @@ Capture Types:
       --tags          Comma-separated tags
       --context       Optional context
 
+  teaching - Log teaching or learning moment
+    Required:
+      --domain        Subject area (e.g., typescript, architecture)
+      --confidence    Certainty level (e.g., high, medium, low)
+      --text          Teaching content
+    Optional:
+      --source        Source identifier (defaults to "manual")
+
 Examples:
   lore capture task --project=lore --name="Add help" --problem="No subcommand help" --solution="Added per-command help functions"
   lore capture knowledge --context=lore --text="Unified CLI works" --type=learning
   lore capture note --text="Remember to update docs" --tags=docs,todo
+  lore capture teaching --domain=patterns --confidence=high --text="Prefer composition over inheritance"
 `);
   process.exit(0);
 }

package/index.ts

@@ -46,11 +46,13 @@ export {
   captureKnowledge,
   captureTask,
   captureNote,
+  captureTeaching,
   type CaptureResult,
   type KnowledgeInput,
   type KnowledgeCaptureType,
   type TaskInput,
   type NoteInput,
+  type TeachingInput,
   type CaptureEvent,
 } from "./lib/capture";
 

package/lib/capture.ts

@@ -50,6 +50,13 @@ export interface NoteInput {
   context?: string;
 }
 
+export interface TeachingInput {
+  domain: string;
+  confidence: string;
+  text: string;
+  source?: string;
+}
+
 interface TaskEvent {
   event: "captured";
   type: "task";
@@ -91,7 +98,19 @@ interface NoteEvent {
   };
 }
 
-type CaptureEvent = TaskEvent | KnowledgeEvent | NoteEvent;
+interface TeachingEvent {
+  event: "captured";
+  type: "teaching";
+  timestamp: string;
+  data: {
+    domain: string;
+    confidence: string;
+    text: string;
+    source: string;
+  };
+}
+
+type CaptureEvent = TaskEvent | KnowledgeEvent | NoteEvent | TeachingEvent;
 
 function getLogPath(): string {
   const dataHome =
@@ -209,4 +228,23 @@ export function captureNote(input: NoteInput): CaptureResult {
   return writeEvent(event);
 }
 
+/**
+ * Capture a teaching moment
+ */
+export function captureTeaching(input: TeachingInput): CaptureResult {
+  const event: TeachingEvent = {
+    event: "captured",
+    type: "teaching",
+    timestamp: "",
+    data: {
+      domain: input.domain,
+      confidence: input.confidence,
+      text: input.text,
+      source: input.source || "manual",
+    },
+  };
+
+  return writeEvent(event);
+}
+
 export type { CaptureEvent };

package/lib/semantic.ts

@@ -223,8 +223,8 @@ export async function semanticSearch(
 
     const limit = options.limit ?? 20;
 
-    // KNN query with join to search table
-    // Group by doc_id to return best chunk per document
+    // KNN query - 1:1 mapping between search rows and embeddings
+    // Content is pre-chunked at ingest time
     let sql: string;
     const params: (Uint8Array | string | number)[] = [queryBlob];
 
@@ -235,17 +235,16 @@ export async function semanticSearch(
           s.title,
           s.content,
           s.metadata,
-          MIN(e.distance) as distance
+          e.distance
         FROM embeddings e
         JOIN search s ON e.doc_id = s.rowid
         WHERE e.embedding MATCH ?
           AND k = ?
           AND s.source = ?
-        GROUP BY s.rowid
-        ORDER BY distance
+        ORDER BY e.distance
         LIMIT ?
       `;
-      params.push(limit * 3); // Fetch more for grouping
+      params.push(limit);
       params.push(options.source);
       params.push(limit);
     } else {
@@ -255,16 +254,15 @@ export async function semanticSearch(
           s.title,
           s.content,
           s.metadata,
-          MIN(e.distance) as distance
+          e.distance
         FROM embeddings e
         JOIN search s ON e.doc_id = s.rowid
         WHERE e.embedding MATCH ?
           AND k = ?
-        GROUP BY s.rowid
-        ORDER BY distance
+        ORDER BY e.distance
         LIMIT ?
       `;
-      params.push(limit * 3); // Fetch more for grouping
+      params.push(limit);
       params.push(limit);
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voidwire/lore",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Unified knowledge CLI - Search, list, and capture your indexed knowledge",
   "type": "module",
   "main": "./index.ts",