@voidwire/lore 0.1.15 → 0.3.0

package/cli.ts

@@ -26,14 +26,18 @@ import {
   listSources,
   list,
   listDomains,
+  formatBriefList,
   info,
   formatInfoHuman,
   projects,
+  about,
+  formatBriefAbout,
   captureTask,
   captureKnowledge,
   captureNote,
   captureTeaching,
   semanticSearch,
+  formatBriefSearch,
   hasEmbeddings,
   DOMAINS,
   type SearchResult,
@@ -81,7 +85,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 +259,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 +331,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) {
@@ -405,6 +419,55 @@ function handleProjects(args: string[]): void {
   }
 }
 
+// ============================================================================
+// About Command
+// ============================================================================
+
+function handleAbout(args: string[]): void {
+  if (hasFlag(args, "help")) {
+    showAboutHelp();
+  }
+
+  const parsed = parseArgs(args);
+  const positional = getPositionalArgs(args);
+
+  if (positional.length === 0) {
+    fail("Missing project name. Use: lore about <project>");
+  }
+
+  const project = positional[0];
+  const brief = hasFlag(args, "brief");
+  const limit = parsed.has("limit")
+    ? parseInt(parsed.get("limit")!, 10)
+    : undefined;
+
+  try {
+    const result = about(project, { brief, limit });
+
+    if (brief) {
+      console.log(formatBriefAbout(result));
+    } else {
+      output({
+        success: true,
+        ...result,
+      });
+    }
+
+    const totalCount =
+      result.commits.count +
+      result.captures.count +
+      result.tasks.count +
+      result.teachings.count +
+      result.sessions.count;
+
+    console.error(`✅ ${totalCount} entries for project: ${project}`);
+    process.exit(0);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    fail(message, 2);
+  }
+}
+
 // ============================================================================
 // Capture Command
 // ============================================================================
@@ -577,12 +640,15 @@ Usage:
   lore list --domains                   List available domains
   lore info                             Show indexed sources and counts
   lore info --human                     Human-readable info
+  lore about <project>                  Aggregate view of project knowledge
+  lore about <project> --brief          Compact project summary
   lore capture task|knowledge|note|teaching  Capture knowledge
 
 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 +659,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 +708,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 +756,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
 
@@ -774,6 +843,51 @@ Examples:
   process.exit(0);
 }
 
+function showAboutHelp(): void {
+  console.log(`
+lore about - Show everything about a project
+
+Usage:
+  lore about <project>                  Aggregate view of project knowledge
+  lore about <project> --brief          Compact output
+
+Options:
+  --brief           Compact output (titles only)
+  --limit <n>       Results per source (default: 10)
+  --help            Show this help
+
+Sources queried:
+  commits           Git commits for project
+  captures          Quick captures in project context
+  tasks             Development tasks for project
+  teachings         Teachings from project
+  sessions          Claude Code sessions for project
+
+Output (JSON):
+  {
+    "project": "name",
+    "commits": [...],
+    "captures": [...],
+    "tasks": [...],
+    "teachings": [...],
+    "sessions": [...]
+  }
+
+Output (--brief):
+  commits (3):
+    project: hash - commit message
+
+  captures (2):
+    project: insight text
+
+Examples:
+  lore about momentum --brief
+  lore about lore | jq '.commits | length'
+  lore about momentum --limit 5
+`);
+  process.exit(0);
+}
+
 function showCaptureHelp(): void {
   console.log(`
 lore capture - Capture knowledge
@@ -855,12 +969,15 @@ function main(): void {
     case "projects":
       handleProjects(commandArgs);
       break;
+    case "about":
+      handleAbout(commandArgs);
+      break;
     case "capture":
       handleCapture(commandArgs);
       break;
     default:
       fail(
-        `Unknown command: ${command}. Use: search, list, info, projects, or capture`,
+        `Unknown command: ${command}. Use: search, list, info, projects, about, or capture`,
       );
   }
 }

package/index.ts

@@ -20,6 +20,7 @@ export {
 export {
   list,
   listDomains,
+  formatBriefList,
   DOMAINS,
   type Domain,
   type ListOptions,
@@ -38,6 +39,14 @@ export {
 // Projects
 export { projects } from "./lib/projects";
 
+// About
+export {
+  about,
+  formatBriefAbout,
+  type AboutResult,
+  type AboutOptions,
+} from "./lib/about";
+
 // Prismis integration
 export {
   searchPrismis,
@@ -70,6 +79,7 @@ export {
 // Semantic search
 export {
   semanticSearch,
+  formatBriefSearch,
   embedQuery,
   hasEmbeddings,
   type SemanticResult,

package/lib/about.ts

@@ -0,0 +1,103 @@
+/**
+ * lib/about.ts - Project knowledge aggregation
+ *
+ * Aggregates all knowledge sources for a given project.
+ * Uses parallel queries via Promise.all for performance.
+ */
+
+import { list, formatBriefList, type ListResult, type Domain } from "./list";
+
+export interface AboutOptions {
+  brief?: boolean;
+  limit?: number;
+}
+
+export interface AboutResult {
+  project: string;
+  commits: ListResult;
+  captures: ListResult;
+  tasks: ListResult;
+  teachings: ListResult;
+  sessions: ListResult;
+}
+
+/**
+ * Sources to query for project knowledge
+ * Each source has a different field for project mapping (handled by list.ts)
+ * Note: "insights" will be added when task 2.1 is complete
+ */
+const ABOUT_SOURCES: Domain[] = [
+  "commits",
+  "captures",
+  "tasks",
+  "teachings",
+  "sessions",
+];
+
+/**
+ * Get aggregated knowledge about a project across all sources
+ *
+ * @param project - Project name to query
+ * @param options - Optional brief flag and limit
+ * @returns AboutResult with data from all sources, or formatted string if brief
+ */
+export function about(
+  project: string,
+  options: AboutOptions = {},
+): AboutResult {
+  const limit = options.limit ?? 10;
+
+  // Query all sources in parallel
+  const results = ABOUT_SOURCES.map((source) => {
+    try {
+      return list(source, { project, limit });
+    } catch {
+      // Source doesn't exist or has no data - return empty result
+      return {
+        domain: source,
+        entries: [],
+        count: 0,
+      } as ListResult;
+    }
+  });
+
+  return {
+    project,
+    commits: results[0],
+    captures: results[1],
+    tasks: results[2],
+    teachings: results[3],
+    sessions: results[4],
+  };
+}
+
+/**
+ * Format about result as brief, compact output
+ * Groups by source, skips empty sources
+ */
+export function formatBriefAbout(result: AboutResult): string {
+  const sections: string[] = [];
+
+  // Format each non-empty source
+  if (result.commits.count > 0) {
+    sections.push(formatBriefList(result.commits));
+  }
+  if (result.captures.count > 0) {
+    sections.push(formatBriefList(result.captures));
+  }
+  if (result.tasks.count > 0) {
+    sections.push(formatBriefList(result.tasks));
+  }
+  if (result.teachings.count > 0) {
+    sections.push(formatBriefList(result.teachings));
+  }
+  if (result.sessions.count > 0) {
+    sections.push(formatBriefList(result.sessions));
+  }
+
+  if (sections.length === 0) {
+    return `(no results for project: ${result.project})`;
+  }
+
+  return sections.join("\n\n");
+}

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