@voidwire/lore 0.2.0 → 0.3.0

package/cli.ts

@@ -30,6 +30,8 @@ import {
   info,
   formatInfoHuman,
   projects,
+  about,
+  formatBriefAbout,
   captureTask,
   captureKnowledge,
   captureNote,
@@ -417,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
 // ============================================================================
@@ -589,6 +640,8 @@ 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:
@@ -790,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
@@ -871,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

@@ -39,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,

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/package.json

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