@voidwire/lore 0.1.15 → 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[] = [];
@@ -255,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, project });
-    output({
-      success: true,
-      results,
-      count: results.length,
-      mode: "semantic",
-    });
+
+    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)`,
     );
@@ -320,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) {
@@ -583,6 +595,7 @@ 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
 
@@ -593,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:
@@ -641,6 +655,7 @@ 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
@@ -688,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

@@ -259,3 +259,90 @@ export async function semanticSearch(
     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.15",
+  "version": "0.2.0",
   "description": "Unified knowledge CLI - Search, list, and capture your indexed knowledge",
   "type": "module",
   "main": "./index.ts",