@voidwire/lore 0.1.5 → 0.1.7

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";
 
@@ -436,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();
@@ -458,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`,
       );
   }
 }
@@ -484,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)
@@ -518,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"
@@ -623,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:
 
@@ -654,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/prismis.ts

@@ -2,7 +2,9 @@
  * Prismis API integration
  *
  * Queries prismis daemon REST API for semantic search across content.
- * Reads host and API key from ~/.config/prismis/config.toml
+ * Config priority:
+ *   1. ~/.config/lore/config.toml [remote] section
+ *   2. ~/.config/prismis/config.toml [api] section (local daemon fallback)
  */
 
 import { readFileSync, existsSync } from "fs";
@@ -18,6 +20,12 @@ export interface PrismisSearchResult {
 }
 
 const DEFAULT_PORT = 8989;
+const LORE_CONFIG_PATH = join(
+  process.env.HOME ?? "",
+  ".config",
+  "lore",
+  "config.toml",
+);
 const PRISMIS_CONFIG_PATH = join(
   process.env.HOME ?? "",
   ".config",
@@ -30,7 +38,7 @@ export interface PrismisSearchOptions {
 }
 
 interface PrismisConfig {
-  host: string;
+  url: string;
   apiKey: string;
 }
 
@@ -55,19 +63,41 @@ interface PrismisResponse {
 }
 
 /**
- * Read prismis config from config.toml
+ * Try to read [remote] section from lore config
  */
-function readPrismisConfig(): PrismisConfig {
+function readLoreRemoteConfig(): PrismisConfig | null {
+  if (!existsSync(LORE_CONFIG_PATH)) {
+    return null;
+  }
+
+  const content = readFileSync(LORE_CONFIG_PATH, "utf-8");
+
+  const urlMatch = content.match(/\[remote\][^[]*url\s*=\s*"([^"]+)"/s);
+  const keyMatch = content.match(/\[remote\][^[]*key\s*=\s*"([^"]+)"/s);
+
+  if (urlMatch && keyMatch) {
+    return {
+      url: urlMatch[1],
+      apiKey: keyMatch[1],
+    };
+  }
+
+  return null;
+}
+
+/**
+ * Read prismis config from local prismis config.toml
+ */
+function readLocalPrismisConfig(): PrismisConfig {
   if (!existsSync(PRISMIS_CONFIG_PATH)) {
     throw new Error(
-      `Prismis config not found at ${PRISMIS_CONFIG_PATH}. ` +
-        "Install prismis and run: prismis-cli source add <url>",
+      `Prismis config not found. Add [remote] to ~/.config/lore/config.toml ` +
+        `or install prismis locally.`,
     );
   }
 
   const content = readFileSync(PRISMIS_CONFIG_PATH, "utf-8");
 
-  // Parse [api] section
   const keyMatch = content.match(/\[api\][^[]*key\s*=\s*"([^"]+)"/);
   if (!keyMatch) {
     throw new Error(
@@ -84,11 +114,22 @@ function readPrismisConfig(): PrismisConfig {
   }
 
   return {
-    host,
+    url: `http://${host}:${DEFAULT_PORT}`,
     apiKey: keyMatch[1],
   };
 }
 
+/**
+ * Read prismis config - tries lore [remote] first, falls back to local prismis
+ */
+function readPrismisConfig(): PrismisConfig {
+  const remoteConfig = readLoreRemoteConfig();
+  if (remoteConfig) {
+    return remoteConfig;
+  }
+  return readLocalPrismisConfig();
+}
+
 /**
  * Check if prismis daemon is running
  */
@@ -122,7 +163,7 @@ export async function searchPrismis(
 ): Promise<PrismisSearchResult[]> {
   // Read config
   const config = readPrismisConfig();
-  const apiBase = `http://${config.host}:${DEFAULT_PORT}`;
+  const apiBase = config.url;
 
   // Check daemon is running
   await checkPrismisDaemon(apiBase);

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.5",
+  "version": "0.1.7",
   "description": "Unified knowledge CLI - Search, list, and capture your indexed knowledge",
   "type": "module",
   "main": "./index.ts",