@voidwire/lore 0.3.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,7 +25,6 @@ import {
   searchAtuin,
   listSources,
   list,
-  listDomains,
   formatBriefList,
   info,
   formatInfoHuman,
@@ -39,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,
@@ -289,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}`);
@@ -309,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")
@@ -334,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));
@@ -347,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";
@@ -468,6 +469,50 @@ function handleAbout(args: string[]): void {
   }
 }
 
+// ============================================================================
+// 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
 // ============================================================================
@@ -635,9 +680,8 @@ 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
@@ -650,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)
@@ -660,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
@@ -688,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
@@ -702,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)
@@ -710,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:
@@ -725,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
@@ -732,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"
@@ -746,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
@@ -773,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
@@ -963,6 +1010,9 @@ function main(): void {
     case "list":
       handleList(commandArgs);
       break;
+    case "sources":
+      handleSources(commandArgs);
+      break;
     case "info":
       handleInfo(commandArgs);
       break;
@@ -977,7 +1027,7 @@ function main(): void {
       break;
     default:
       fail(
-        `Unknown command: ${command}. Use: search, list, info, projects, about, 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,

package/lib/about.ts

@@ -5,7 +5,7 @@
  * Uses parallel queries via Promise.all for performance.
  */
 
-import { list, formatBriefList, type ListResult, type Domain } from "./list";
+import { list, formatBriefList, type ListResult, type Source } from "./list";
 
 export interface AboutOptions {
   brief?: boolean;
@@ -26,7 +26,7 @@ export interface AboutResult {
  * 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[] = [
+const ABOUT_SOURCES: Source[] = [
   "commits",
   "captures",
   "tasks",
@@ -48,13 +48,13 @@ export function about(
   const limit = options.limit ?? 10;
 
   // Query all sources in parallel
-  const results = ABOUT_SOURCES.map((source) => {
+  const results = ABOUT_SOURCES.map((src) => {
     try {
-      return list(source, { project, limit });
+      return list(src, { project, limit });
     } catch {
       // Source doesn't exist or has no data - return empty result
       return {
-        domain: source,
+        source: src,
         entries: [],
         count: 0,
       } as ListResult;

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