@voidwire/lore 0.7.1 → 0.9.0

package/cli.ts

@@ -56,6 +56,7 @@ import {
   type ObservationSubtype,
   type ObservationConfidence,
 } from "./index";
+import { isValidLoreType, LORE_TYPES } from "./lib/types";
 
 // ============================================================================
 // Argument Parsing
@@ -204,6 +205,33 @@ async function handleSearch(args: string[]): Promise<void> {
   const limit = parsed.has("limit") ? parseInt(parsed.get("limit")!, 10) : 20;
   const since = parsed.get("since");
   const project = parsed.get("project");
+  const type = parseList(parsed.get("type"));
+
+  // Validate type values against LoreType enum
+  if (type) {
+    const invalid = type.filter((t) => !isValidLoreType(t));
+    if (invalid.length > 0) {
+      fail(
+        `Invalid type: ${invalid.join(", ")}. Valid types: ${LORE_TYPES.join(", ")}`,
+      );
+    }
+  }
+
+  // Parse --source flag (comma-separated list)
+  const sourceFilter = parseList(parsed.get("source"));
+
+  // Validate source filter values against SOURCES constant
+  if (sourceFilter) {
+    const invalid = sourceFilter.filter((s) => !SOURCES.includes(s as Source));
+    if (invalid.length > 0) {
+      fail(
+        `Invalid source: ${invalid.join(", ")}. Valid sources: ${SOURCES.join(", ")}`,
+      );
+    }
+  }
+
+  // Resolve effective source: --source flag takes precedence over positional arg
+  const effectiveSource: string | string[] | undefined = sourceFilter ?? source;
 
   // Handle prismis passthrough
   if (source === "prismis") {
@@ -250,7 +278,12 @@ async function handleSearch(args: string[]): Promise<void> {
   // FTS5 path (explicit --exact only)
   if (exact) {
     try {
-      const results = search(query, { source, limit, since });
+      const results = search(query, {
+        source: effectiveSource,
+        limit,
+        since,
+        type,
+      });
       output({
         success: true,
         results,
@@ -278,7 +311,12 @@ async function handleSearch(args: string[]): Promise<void> {
   // Semantic-only path (explicit --semantic)
   if (semanticOnly) {
     try {
-      const results = await semanticSearch(query, { source, limit, project });
+      const results = await semanticSearch(query, {
+        source: effectiveSource,
+        limit,
+        project,
+        type,
+      });
 
       if (brief) {
         console.log(formatBriefSearch(results));
@@ -304,10 +342,11 @@ async function handleSearch(args: string[]): Promise<void> {
   // Hybrid path (default) - combines vector + keyword
   try {
     const results = await hybridSearch(query, {
-      source,
+      source: effectiveSource,
       limit,
       project,
       since,
+      type,
     });
 
     if (brief) {
@@ -817,6 +856,8 @@ Usage:
 
 Search Options:
   --exact           Use FTS5 text search (bypasses semantic search)
+  --source <src>    Filter by source (comma-separated: captures,teachings)
+  --type <types>    Filter by knowledge type (gotcha, decision, learning, etc.)
   --limit <n>       Maximum results (default: 20)
   --project <name>  Filter results by project
   --brief           Compact output (titles only)
@@ -864,6 +905,10 @@ Capture Types:
 
 Examples:
   lore search "authentication"
+  lore search --source=captures "sable"
+  lore search --source=captures,teachings "schema"
+  lore search --type=gotcha "sable"
+  lore search --type=gotcha,decision "lore"
   lore search blogs "typescript patterns"
   lore sources
   lore list development
@@ -888,6 +933,12 @@ Search Modes:
   --semantic        Vector search only
 
 Options:
+  --source <src>    Filter by source (pre-filters before search)
+                    Comma-separated: --source=captures,teachings
+  --type <types>    Filter by knowledge type (pre-filters before search)
+                    Comma-separated: --type=gotcha,decision
+                    Valid: gotcha, decision, pattern, learning, preference,
+                           term, style, teaching, task, todo, idea
   --limit <n>       Maximum results (default: 20)
   --project <name>  Filter results by project/topic
   --brief           Compact output (titles only)
@@ -919,6 +970,11 @@ See also:
 
 Examples:
   lore search "authentication"                      # hybrid (default)
+  lore search --source=captures "sable"             # filter by source
+  lore search --source=captures,teachings "schema"  # multiple sources
+  lore search --source=flux --type=todo "sable"     # combined filters
+  lore search --type=gotcha "sable"                 # filter by type
+  lore search --type=gotcha,decision "lore"         # multiple types
   lore search --exact "def process_data"            # keyword only
   lore search --semantic "login flow concepts"      # vector only
   lore search blogs "typescript patterns"

package/lib/search.ts

@@ -19,9 +19,10 @@ export interface SearchResult {
 }
 
 export interface SearchOptions {
-  source?: string;
+  source?: string | string[];
   limit?: number;
   since?: string;
+  type?: string | string[];
 }
 
 function getDatabasePath(): string {
@@ -69,8 +70,29 @@ export function search(
     const params: (string | number)[] = [escapeFts5Query(query)];
 
     if (options.source) {
-      conditions.push("source = ?");
-      params.push(options.source);
+      const sources = Array.isArray(options.source)
+        ? options.source
+        : [options.source];
+      if (sources.length === 1) {
+        conditions.push("source = ?");
+        params.push(sources[0]);
+      } else {
+        const placeholders = sources.map(() => "?").join(", ");
+        conditions.push(`source IN (${placeholders})`);
+        params.push(...sources);
+      }
+    }
+
+    if (options.type) {
+      const types = Array.isArray(options.type) ? options.type : [options.type];
+      const typeClauses = types.map(
+        () =>
+          "(json_extract(metadata, '$.type') = ? OR json_extract(metadata, '$.subtype') = ?)",
+      );
+      conditions.push(`(${typeClauses.join(" OR ")})`);
+      types.forEach((t) => {
+        params.push(t, t);
+      });
     }
 
     if (options.since) {

package/lib/semantic.ts

@@ -22,9 +22,10 @@ export interface SemanticResult {
 }
 
 export interface SemanticSearchOptions {
-  source?: string;
+  source?: string | string[];
   limit?: number;
   project?: string;
+  type?: string | string[];
 }
 
 /**
@@ -221,8 +222,17 @@ export async function semanticSearch(
     params.push(limit);
 
     if (options.source) {
-      conditions.push("e.source = ?");
-      params.push(options.source);
+      const sources = Array.isArray(options.source)
+        ? options.source
+        : [options.source];
+      if (sources.length === 1) {
+        conditions.push("e.source = ?");
+        params.push(sources[0]);
+      } else {
+        const placeholders = sources.map(() => "?").join(", ");
+        conditions.push(`e.source IN (${placeholders})`);
+        params.push(...sources);
+      }
     }
 
     if (options.project) {
@@ -230,6 +240,13 @@ export async function semanticSearch(
       params.push(options.project);
     }
 
+    if (options.type) {
+      const types = Array.isArray(options.type) ? options.type : [options.type];
+      const placeholders = types.map(() => "?").join(", ");
+      conditions.push(`e.type IN (${placeholders})`);
+      params.push(...types);
+    }
+
     sql = `
       SELECT
         s.rowid,
@@ -270,10 +287,11 @@ export interface HybridResult {
 }
 
 export interface HybridSearchOptions {
-  source?: string;
+  source?: string | string[];
   limit?: number;
   project?: string;
   since?: string;
+  type?: string | string[];
   vectorWeight?: number;
   textWeight?: number;
 }
@@ -325,12 +343,14 @@ export async function hybridSearch(
       source: options.source,
       limit: fetchLimit,
       project: options.project,
+      type: options.type,
     }),
     Promise.resolve(
       keywordSearch(query, {
         source: options.source,
         limit: fetchLimit,
         since: options.since,
+        type: options.type,
       }),
     ),
   ]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voidwire/lore",
-  "version": "0.7.1",
+  "version": "0.9.0",
   "description": "Unified knowledge CLI - Search, list, and capture your indexed knowledge",
   "type": "module",
   "main": "./index.ts",
@@ -19,6 +19,11 @@
     "README.md",
     "LICENSE"
   ],
+  "scripts": {
+    "build": "tsc --noEmit false --outDir dist --declaration",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test"
+  },
   "keywords": [
     "knowledge",
     "search",
@@ -47,10 +52,5 @@
   },
   "devDependencies": {
     "bun-types": "1.3.5"
-  },
-  "scripts": {
-    "build": "tsc --noEmit false --outDir dist --declaration",
-    "typecheck": "tsc --noEmit",
-    "test": "bun test"
   }
-}
+}