@voidwire/lore 0.1.14 → 0.2.0

package/cli.ts

@@ -26,6 +26,7 @@ import {
   listSources,
   list,
   listDomains,
+  formatBriefList,
   info,
   formatInfoHuman,
   projects,
@@ -34,6 +35,7 @@ import {
   captureNote,
   captureTeaching,
   semanticSearch,
+  formatBriefSearch,
   hasEmbeddings,
   DOMAINS,
   type SearchResult,
@@ -81,7 +83,7 @@ function parseArgs(args: string[]): Map<string, string> {
 }
 
 // Boolean flags that don't take values
-const BOOLEAN_FLAGS = new Set(["help", "sources", "domains", "exact"]);
+const BOOLEAN_FLAGS = new Set(["help", "sources", "domains", "exact", "brief"]);
 
 function getPositionalArgs(args: string[]): string[] {
   const result: string[] = [];
@@ -185,6 +187,7 @@ 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");
 
   // Handle prismis passthrough
   if (source === "prismis") {
@@ -254,14 +257,21 @@ async function handleSearch(args: string[]): Promise<void> {
     fail("No embeddings found. Run lore-embed-all first.", 2);
   }
 
+  const brief = hasFlag(args, "brief");
+
   try {
-    const results = await semanticSearch(query, { source, limit });
-    output({
-      success: true,
-      results,
-      count: results.length,
-      mode: "semantic",
-    });
+    const results = await semanticSearch(query, { source, limit, project });
+
+    if (brief) {
+      console.log(formatBriefSearch(results));
+    } else {
+      output({
+        success: true,
+        results,
+        count: results.length,
+        mode: "semantic",
+      });
+    }
     console.error(
       `✅ ${results.length} result${results.length !== 1 ? "s" : ""} found (semantic)`,
     );
@@ -319,11 +329,14 @@ function handleList(args: string[]): void {
     : undefined;
   const format = parsed.get("format") || "json";
   const project = parsed.get("project");
+  const brief = hasFlag(args, "brief");
 
   try {
     const result = list(domain, { limit, project });
 
-    if (format === "human") {
+    if (brief) {
+      console.log(formatBriefList(result));
+    } else if (format === "human") {
       console.log(formatHumanOutput(result));
     } else if (format === "jsonl") {
       for (const entry of result.entries) {
@@ -581,6 +594,8 @@ Usage:
 Search Options:
   --exact           Use FTS5 text search (bypasses semantic search)
   --limit <n>       Maximum results (default: 20)
+  --project <name>  Filter results by project
+  --brief           Compact output (titles only)
   --since <date>    Filter by date (today, yesterday, this-week, YYYY-MM-DD)
   --sources         List indexed sources with counts
 
@@ -591,6 +606,7 @@ Passthrough Sources:
 List Options:
   --limit <n>       Maximum entries
   --format <fmt>    Output format: json (default), jsonl, human
+  --brief           Compact output (titles only)
   --domains         List available domains
 
 Capture Types:
@@ -638,6 +654,8 @@ Usage:
 Options:
   --exact           Use FTS5 text search (bypasses semantic search)
   --limit <n>       Maximum results (default: 20)
+  --project <name>  Filter results by project (post-filters KNN results)
+  --brief           Compact output (titles only)
   --since <date>    Filter by date (today, yesterday, this-week, YYYY-MM-DD)
   --sources         List indexed sources with counts
   --help            Show this help
@@ -665,6 +683,7 @@ Examples:
   lore search "authentication"
   lore search blogs "typescript patterns"
   lore search commits --since this-week "refactor"
+  lore search "authentication" --project=momentum --limit 5
   lore search --exact "def process_data"
   lore search prismis "kubernetes security"
   lore search atuin "docker build"
@@ -684,6 +703,7 @@ Options:
   --limit <n>       Maximum entries (default: all)
   --format <fmt>    Output format: json (default), jsonl, human
   --project <name>  Filter by project name
+  --brief           Compact output (titles only)
   --domains         List available domains
   --help            Show this help
 

package/index.ts

@@ -20,6 +20,7 @@ export {
 export {
   list,
   listDomains,
+  formatBriefList,
   DOMAINS,
   type Domain,
   type ListOptions,
@@ -70,6 +71,7 @@ export {
 // Semantic search
 export {
   semanticSearch,
+  formatBriefSearch,
   embedQuery,
   hasEmbeddings,
   type SemanticResult,

package/lib/list.ts

@@ -209,3 +209,61 @@ export function list(domain: Domain, options: ListOptions = {}): ListResult {
 export function listDomains(): Domain[] {
   return [...DOMAINS];
 }
+
+/**
+ * Extract project name from entry metadata
+ */
+function extractProjectFromEntry(entry: ListEntry, domain: string): string {
+  const field = PROJECT_FIELD[domain];
+  if (!field) return "unknown";
+  return (entry.metadata[field] as string) || "unknown";
+}
+
+/**
+ * Extract identifier from entry based on domain type
+ */
+function extractIdentifier(entry: ListEntry, domain: string): string {
+  const metadata = entry.metadata;
+
+  switch (domain) {
+    case "commits":
+      return (metadata.sha as string)?.substring(0, 7) || "";
+    case "sessions":
+      return (metadata.session_id as string)?.substring(0, 8) || "";
+    default:
+      return (metadata.id as string) || "";
+  }
+}
+
+/**
+ * Get the best display text for an entry
+ * Commits use content (commit message), others use title
+ */
+function getDisplayText(entry: ListEntry, domain: string): string {
+  if (domain === "commits") {
+    return entry.content || entry.title;
+  }
+  return entry.title;
+}
+
+/**
+ * Format list result as brief, compact output
+ * One line per entry: "  project: identifier - title"
+ */
+export function formatBriefList(result: ListResult): string {
+  const lines = [`${result.domain} (${result.count}):`];
+
+  result.entries.forEach((entry) => {
+    const project = extractProjectFromEntry(entry, result.domain);
+    const identifier = extractIdentifier(entry, result.domain);
+    const displayText = getDisplayText(entry, result.domain);
+
+    const line = identifier
+      ? `  ${project}: ${identifier} - ${displayText}`
+      : `  ${project}: ${displayText}`;
+
+    lines.push(line);
+  });
+
+  return lines.join("\n");
+}

package/lib/semantic.ts

@@ -32,8 +32,21 @@ export interface SemanticResult {
 export interface SemanticSearchOptions {
   source?: string;
   limit?: number;
+  project?: string;
 }
 
+/**
+ * Maps source types to their project field name in metadata JSON.
+ * Different sources store project names in different fields.
+ */
+const PROJECT_FIELD: Record<string, string> = {
+  commits: "project",
+  sessions: "project",
+  tasks: "project",
+  captures: "context",
+  teachings: "source",
+};
+
 const MODEL_NAME = "nomic-ai/nomic-embed-text-v1.5";
 
 interface EmbeddingPipeline {
@@ -223,8 +236,113 @@ export async function semanticSearch(
     const stmt = db.prepare(sql);
     const results = stmt.all(...params) as SemanticResult[];
 
+    // Post-filter by project if specified
+    // KNN WHERE clause doesn't support json_extract on joined metadata,
+    // so we filter after the query returns
+    if (options.project) {
+      return results.filter((result) => {
+        const field = PROJECT_FIELD[result.source];
+        if (!field) return false;
+
+        try {
+          const metadata = JSON.parse(result.metadata);
+          return metadata[field] === options.project;
+        } catch {
+          // Skip results with malformed metadata
+          return false;
+        }
+      });
+    }
+
     return results;
   } finally {
     db.close();
   }
 }
+
+/**
+ * Extract project from result metadata
+ */
+function extractProjectFromMetadata(metadata: string, source: string): string {
+  const field = PROJECT_FIELD[source];
+  if (!field) return "unknown";
+
+  try {
+    const parsed = JSON.parse(metadata);
+    return parsed[field] || "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+
+/**
+ * Extract identifier from semantic result
+ */
+function extractIdentifierFromResult(result: SemanticResult): string {
+  try {
+    const metadata = JSON.parse(result.metadata);
+
+    switch (result.source) {
+      case "commits":
+        return metadata.sha?.substring(0, 7) || "";
+      case "sessions":
+        return metadata.session_id?.substring(0, 8) || "";
+      default:
+        return metadata.id || "";
+    }
+  } catch {
+    return "";
+  }
+}
+
+/**
+ * Get the best display text for a result
+ * Commits use content (commit message), others use title
+ */
+function getDisplayText(result: SemanticResult): string {
+  if (result.source === "commits") {
+    return result.content || result.title;
+  }
+  return result.title;
+}
+
+/**
+ * Format semantic search results as brief, compact output
+ * Groups by source type, one line per result
+ */
+export function formatBriefSearch(results: SemanticResult[]): string {
+  if (results.length === 0) {
+    return "(no results)";
+  }
+
+  // Group results by source
+  const grouped = new Map<string, SemanticResult[]>();
+  results.forEach((result) => {
+    const existing = grouped.get(result.source) || [];
+    existing.push(result);
+    grouped.set(result.source, existing);
+  });
+
+  const sections: string[] = [];
+
+  // Format each source group
+  grouped.forEach((sourceResults, source) => {
+    const lines = [`${source} (${sourceResults.length}):`];
+
+    sourceResults.forEach((r) => {
+      const project = extractProjectFromMetadata(r.metadata, r.source);
+      const identifier = extractIdentifierFromResult(r);
+      const displayText = getDisplayText(r);
+
+      const line = identifier
+        ? `  ${project}: ${identifier} - ${displayText}`
+        : `  ${project}: ${displayText}`;
+
+      lines.push(line);
+    });
+
+    sections.push(lines.join("\n"));
+  });
+
+  return sections.join("\n\n");
+}

package/package.json

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