@voidwire/lore 0.7.1 → 0.8.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,17 @@ 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(", ")}`,
+      );
+    }
+  }
 
   // Handle prismis passthrough
   if (source === "prismis") {
@@ -250,7 +262,7 @@ 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, limit, since, type });
       output({
         success: true,
         results,
@@ -278,7 +290,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,
+        limit,
+        project,
+        type,
+      });
 
       if (brief) {
         console.log(formatBriefSearch(results));
@@ -308,6 +325,7 @@ async function handleSearch(args: string[]): Promise<void> {
       limit,
       project,
       since,
+      type,
     });
 
     if (brief) {
@@ -817,6 +835,7 @@ Usage:
 
 Search Options:
   --exact           Use FTS5 text search (bypasses semantic search)
+  --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 +883,8 @@ Capture Types:
 
 Examples:
   lore search "authentication"
+  lore search --type=gotcha "sable"
+  lore search --type=gotcha,decision "lore"
   lore search blogs "typescript patterns"
   lore sources
   lore list development
@@ -888,6 +909,10 @@ Search Modes:
   --semantic        Vector search only
 
 Options:
+  --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 +944,8 @@ See also:
 
 Examples:
   lore search "authentication"                      # hybrid (default)
+  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

@@ -22,6 +22,7 @@ export interface SearchOptions {
   source?: string;
   limit?: number;
   since?: string;
+  type?: string | string[];
 }
 
 function getDatabasePath(): string {
@@ -73,6 +74,18 @@ export function search(
       params.push(options.source);
     }
 
+    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) {
       conditions.push(
         "json_extract(metadata, '$.date') IS NOT NULL AND json_extract(metadata, '$.date') != 'unknown' AND json_extract(metadata, '$.date') >= ?",

package/lib/semantic.ts

@@ -25,6 +25,7 @@ export interface SemanticSearchOptions {
   source?: string;
   limit?: number;
   project?: string;
+  type?: string | string[];
 }
 
 /**
@@ -230,6 +231,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,
@@ -274,6 +282,7 @@ export interface HybridSearchOptions {
   limit?: number;
   project?: string;
   since?: string;
+  type?: string | string[];
   vectorWeight?: number;
   textWeight?: number;
 }
@@ -325,12 +334,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.8.0",
   "description": "Unified knowledge CLI - Search, list, and capture your indexed knowledge",
   "type": "module",
   "main": "./index.ts",