@voidwire/lore 0.2.0 → 0.4.0

package/cli.ts

@@ -10,7 +10,7 @@
  * Usage:
  *   lore search <query>                   Search all sources
  *   lore search <source> <query>          Search specific source
- *   lore list <domain>                    List domain entries
+ *   lore list <source>                    List source entries
  *   lore capture task|knowledge|note|teaching  Capture knowledge
  *
  * Exit codes:
@@ -25,11 +25,12 @@ import {
   searchAtuin,
   listSources,
   list,
-  listDomains,
   formatBriefList,
   info,
   formatInfoHuman,
   projects,
+  about,
+  formatBriefAbout,
   captureTask,
   captureKnowledge,
   captureNote,
@@ -37,11 +38,11 @@ import {
   semanticSearch,
   formatBriefSearch,
   hasEmbeddings,
-  DOMAINS,
+  SOURCES,
   type SearchResult,
   type ListResult,
   type ListEntry,
-  type Domain,
+  type Source,
   type TaskInput,
   type KnowledgeInput,
   type NoteInput,
@@ -287,7 +288,7 @@ async function handleSearch(args: string[]): Promise<void> {
 // ============================================================================
 
 function formatHumanOutput(result: ListResult): string {
-  const lines: string[] = [`${result.domain} (${result.count} entries):`, ""];
+  const lines: string[] = [`${result.source} (${result.count} entries):`, ""];
 
   for (const entry of result.entries) {
     lines.push(`  ${entry.title}`);
@@ -307,21 +308,23 @@ function handleList(args: string[]): void {
   const parsed = parseArgs(args);
   const positional = getPositionalArgs(args);
 
-  // Handle --domains flag
+  // Handle --domains flag (deprecated)
   if (hasFlag(args, "domains")) {
-    output({ success: true, domains: listDomains() });
-    console.error(`✅ ${DOMAINS.length} domains available`);
+    console.error("⚠️  --domains is deprecated. Use 'lore sources' instead.");
+    const sources = listSources();
+    output({ success: true, sources });
+    console.error(`✅ ${SOURCES.length} sources available`);
     process.exit(0);
   }
 
   if (positional.length === 0) {
-    fail(`Missing domain. Available: ${DOMAINS.join(", ")}`);
+    fail(`Missing source. Available: ${SOURCES.join(", ")}`);
   }
 
-  const domain = positional[0] as Domain;
+  const source = positional[0] as Source;
 
-  if (!DOMAINS.includes(domain)) {
-    fail(`Invalid domain: ${domain}. Available: ${DOMAINS.join(", ")}`);
+  if (!SOURCES.includes(source)) {
+    fail(`Invalid source: ${source}. Available: ${SOURCES.join(", ")}`);
   }
 
   const limit = parsed.has("limit")
@@ -332,7 +335,7 @@ function handleList(args: string[]): void {
   const brief = hasFlag(args, "brief");
 
   try {
-    const result = list(domain, { limit, project });
+    const result = list(source, { limit, project });
 
     if (brief) {
       console.log(formatBriefList(result));
@@ -345,13 +348,13 @@ function handleList(args: string[]): void {
     } else {
       output({
         success: true,
-        domain: result.domain,
+        source: result.source,
         entries: result.entries,
         count: result.count,
       });
     }
 
-    console.error(`✅ ${result.count} entries in ${domain}`);
+    console.error(`✅ ${result.count} entries in ${source}`);
     process.exit(0);
   } catch (error) {
     const message = error instanceof Error ? error.message : "Unknown error";
@@ -417,6 +420,99 @@ 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);
+  }
+}
+
+// ============================================================================
+// Sources Command
+// ============================================================================
+
+function handleSources(args: string[]): void {
+  if (hasFlag(args, "help")) {
+    showSourcesHelp();
+  }
+
+  try {
+    const sources = listSources();
+    output({
+      success: true,
+      sources,
+    });
+    console.error(`✅ ${sources.length} sources indexed`);
+    process.exit(0);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    fail(message, 2);
+  }
+}
+
+function showSourcesHelp(): void {
+  console.log(`
+lore sources - List all indexed sources with counts
+
+Usage:
+  lore sources                          List all sources with entry counts
+
+Options:
+  --help            Show this help
+
+Output:
+  JSON array of {source, count} objects, sorted by count descending.
+
+Examples:
+  lore sources
+  lore sources | jq '.[0]'
+  lore sources | jq -r '.[] | "\\(.source): \\(.count)"'
+`);
+  process.exit(0);
+}
+
 // ============================================================================
 // Capture Command
 // ============================================================================
@@ -584,11 +680,12 @@ Philosophy:
 Usage:
   lore search <query>                   Search all sources
   lore search <source> <query>          Search specific source
-  lore search --sources                 List indexed sources
-  lore list <domain>                    List domain entries
-  lore list --domains                   List available domains
+  lore sources                          List indexed sources with counts
+  lore list <source>                    List source entries
   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:
@@ -597,7 +694,6 @@ Search Options:
   --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
 
 Passthrough Sources:
   prismis           Semantic search via prismis daemon (requires prismis-daemon running)
@@ -607,7 +703,7 @@ List Options:
   --limit <n>       Maximum entries
   --format <fmt>    Output format: json (default), jsonl, human
   --brief           Compact output (titles only)
-  --domains         List available domains
+  --project <name>  Filter by project name
 
 Capture Types:
   task              Log task completion
@@ -635,6 +731,7 @@ Capture Types:
 Examples:
   lore search "authentication"
   lore search blogs "typescript patterns"
+  lore sources
   lore list development
   lore list commits --limit 10 --format human
   lore capture knowledge --context=lore --text="Unified CLI works" --type=learning
@@ -649,7 +746,6 @@ lore search - Search indexed knowledge
 Usage:
   lore search <query>                   Search all sources
   lore search <source> <query>          Search specific source
-  lore search --sources                 List indexed sources
 
 Options:
   --exact           Use FTS5 text search (bypasses semantic search)
@@ -657,7 +753,6 @@ Options:
   --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
 
 Indexed Sources:
@@ -672,6 +767,7 @@ Indexed Sources:
   readmes           Project README files
   sessions          Claude Code session transcripts
   tasks             Logged development tasks
+  teachings         Teaching moments
 
 Passthrough Sources:
   prismis           Semantic search via prismis daemon
@@ -679,6 +775,9 @@ Passthrough Sources:
   atuin             Shell history search
                     (queries ~/.local/share/atuin/history.db directly)
 
+See also:
+  lore sources      List all sources with entry counts
+
 Examples:
   lore search "authentication"
   lore search blogs "typescript patterns"
@@ -693,21 +792,19 @@ Examples:
 
 function showListHelp(): void {
   console.log(`
-lore list - List domain entries
+lore list - List source entries
 
 Usage:
-  lore list <domain>                    List entries in domain
-  lore list --domains                   List available domains
+  lore list <source>                    List entries in source
 
 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
 
-Available Domains:
+Available Sources:
   blogs             Blog posts
   books             Books read
   captures          Quick captures
@@ -720,11 +817,14 @@ Available Domains:
   movies            Movies watched
   obsidian          Obsidian notes
   people            People/contacts
-  personal          Personal data aggregate
   podcasts          Podcasts listened
   readmes           Project READMEs
   sessions          Claude Code sessions
   tasks             Development tasks
+  teachings         Teaching moments
+
+See also:
+  lore sources      List all sources with entry counts
 
 Examples:
   lore list development
@@ -790,6 +890,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
@@ -865,18 +1010,24 @@ function main(): void {
     case "list":
       handleList(commandArgs);
       break;
+    case "sources":
+      handleSources(commandArgs);
+      break;
     case "info":
       handleInfo(commandArgs);
       break;
     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, sources, info, projects, about, or capture`,
       );
   }
 }

package/index.ts

@@ -19,10 +19,9 @@ export {
 // List
 export {
   list,
-  listDomains,
   formatBriefList,
-  DOMAINS,
-  type Domain,
+  SOURCES,
+  type Source,
   type ListOptions,
   type ListEntry,
   type ListResult,
@@ -39,6 +38,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 Source } 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: Source[] = [
+  "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((src) => {
+    try {
+      return list(src, { project, limit });
+    } catch {
+      // Source doesn't exist or has no data - return empty result
+      return {
+        source: src,
+        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

@@ -1,7 +1,7 @@
 /**
- * lib/list.ts - Domain listing functions
+ * lib/list.ts - Source listing functions
  *
- * Browse indexed domains without search queries.
+ * Browse indexed sources without search queries.
  * Uses Bun's built-in SQLite for zero external dependencies.
  */
 
@@ -9,8 +9,8 @@ import { Database } from "bun:sqlite";
 import { homedir } from "os";
 import { existsSync } from "fs";
 
-// Domain types - sources that can be listed
-export type Domain =
+// Source types - data sources that can be listed
+export type Source =
   | "development"
   | "tasks"
   | "events"
@@ -29,7 +29,7 @@ export type Domain =
   | "teachings"
   | "sessions";
 
-export const DOMAINS: Domain[] = [
+export const SOURCES: Source[] = [
   "development",
   "tasks",
   "events",
@@ -49,8 +49,8 @@ export const DOMAINS: Domain[] = [
   "sessions",
 ];
 
-// Domains that query the 'personal' source with type filter
-const PERSONAL_SUBTYPES: Partial<Record<Domain, string>> = {
+// Sources that query the 'personal' source with type filter
+const PERSONAL_SUBTYPES: Partial<Record<Source, string>> = {
   books: "book",
   movies: "movie",
   podcasts: "podcast",
@@ -80,7 +80,7 @@ export interface ListEntry {
 }
 
 export interface ListResult {
-  domain: Domain;
+  source: Source;
   entries: ListEntry[];
   count: number;
 }
@@ -160,17 +160,17 @@ function queryPersonalType(
 }
 
 /**
- * List all entries in a domain
+ * List all entries in a source
  *
- * @param domain - The domain to list (development, tasks, blogs, etc.)
+ * @param source - The source to list (development, tasks, blogs, etc.)
  * @param options - Optional limit
  * @returns ListResult with entries and count
- * @throws Error if database doesn't exist or domain is invalid
+ * @throws Error if database doesn't exist or source is invalid
  */
-export function list(domain: Domain, options: ListOptions = {}): ListResult {
-  if (!DOMAINS.includes(domain)) {
+export function list(source: Source, options: ListOptions = {}): ListResult {
+  if (!SOURCES.includes(source)) {
     throw new Error(
-      `Invalid domain: ${domain}. Valid domains: ${DOMAINS.join(", ")}`,
+      `Invalid source: ${source}. Valid sources: ${SOURCES.join(", ")}`,
     );
   }
 
@@ -185,16 +185,16 @@ export function list(domain: Domain, options: ListOptions = {}): ListResult {
   try {
     let entries: ListEntry[];
 
-    // Check if this is a personal subtype domain
-    const personalType = PERSONAL_SUBTYPES[domain];
+    // Check if this is a personal subtype source
+    const personalType = PERSONAL_SUBTYPES[source];
     if (personalType) {
       entries = queryPersonalType(db, personalType, options.limit);
     } else {
-      entries = queryBySource(db, domain, options.limit, options.project);
+      entries = queryBySource(db, source, options.limit, options.project);
     }
 
     return {
-      domain,
+      source,
       entries,
       count: entries.length,
     };
@@ -204,28 +204,28 @@ export function list(domain: Domain, options: ListOptions = {}): ListResult {
 }
 
 /**
- * Get available domains
+ * Get available sources
  */
-export function listDomains(): Domain[] {
-  return [...DOMAINS];
+export function listSources(): Source[] {
+  return [...SOURCES];
 }
 
 /**
  * Extract project name from entry metadata
  */
-function extractProjectFromEntry(entry: ListEntry, domain: string): string {
-  const field = PROJECT_FIELD[domain];
+function extractProjectFromEntry(entry: ListEntry, source: string): string {
+  const field = PROJECT_FIELD[source];
   if (!field) return "unknown";
   return (entry.metadata[field] as string) || "unknown";
 }
 
 /**
- * Extract identifier from entry based on domain type
+ * Extract identifier from entry based on source type
  */
-function extractIdentifier(entry: ListEntry, domain: string): string {
+function extractIdentifier(entry: ListEntry, source: string): string {
   const metadata = entry.metadata;
 
-  switch (domain) {
+  switch (source) {
     case "commits":
       return (metadata.sha as string)?.substring(0, 7) || "";
     case "sessions":
@@ -239,8 +239,8 @@ function extractIdentifier(entry: ListEntry, domain: string): 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") {
+function getDisplayText(entry: ListEntry, source: string): string {
+  if (source === "commits") {
     return entry.content || entry.title;
   }
   return entry.title;
@@ -251,12 +251,12 @@ function getDisplayText(entry: ListEntry, domain: string): string {
  * One line per entry: "  project: identifier - title"
  */
 export function formatBriefList(result: ListResult): string {
-  const lines = [`${result.domain} (${result.count}):`];
+  const lines = [`${result.source} (${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 project = extractProjectFromEntry(entry, result.source);
+    const identifier = extractIdentifier(entry, result.source);
+    const displayText = getDisplayText(entry, result.source);
 
     const line = identifier
       ? `  ${project}: ${identifier} - ${displayText}`

package/package.json

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