@voidwire/lore 0.1.11 → 0.1.13

package/cli.ts

@@ -26,6 +26,9 @@ import {
   listSources,
   list,
   listDomains,
+  info,
+  formatInfoHuman,
+  projects,
   captureTask,
   captureKnowledge,
   captureNote,
@@ -342,6 +345,64 @@ function handleList(args: string[]): void {
   }
 }
 
+// ============================================================================
+// Info Command
+// ============================================================================
+
+function handleInfo(args: string[]): void {
+  if (hasFlag(args, "help")) {
+    showInfoHelp();
+  }
+
+  const human = hasFlag(args, "human");
+
+  try {
+    const result = info();
+
+    if (human) {
+      console.log(formatInfoHuman(result));
+    } else {
+      output({
+        success: true,
+        ...result,
+      });
+    }
+
+    console.error(
+      `✅ ${result.sources.length} sources, ${result.total_entries} total entries`,
+    );
+    process.exit(0);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    fail(message, 2);
+  }
+}
+
+// ============================================================================
+// Projects Command
+// ============================================================================
+
+function handleProjects(args: string[]): void {
+  if (hasFlag(args, "help")) {
+    showProjectsHelp();
+  }
+
+  try {
+    const result = projects();
+
+    output({
+      success: true,
+      projects: result,
+    });
+
+    console.error(`✅ ${result.length} projects found`);
+    process.exit(0);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    fail(message, 2);
+  }
+}
+
 // ============================================================================
 // Capture Command
 // ============================================================================
@@ -512,6 +573,8 @@ Usage:
   lore search --sources                 List indexed sources
   lore list <domain>                    List domain entries
   lore list --domains                   List available domains
+  lore info                             Show indexed sources and counts
+  lore info --human                     Human-readable info
   lore capture task|knowledge|note|teaching  Capture knowledge
 
 Search Options:
@@ -649,6 +712,61 @@ Examples:
   process.exit(0);
 }
 
+function showInfoHelp(): void {
+  console.log(`
+lore info - Show indexed sources and counts
+
+Usage:
+  lore info                             Show all sources and counts
+  lore info --human                     Human-readable format
+
+Options:
+  --human           Human-readable format (default: JSON)
+  --help            Show this help
+
+Output Fields:
+  sources           Array of {name, count} for each indexed source
+  projects          Known projects across all sources
+  last_indexed      Most recent timestamp from indexed data
+  total_entries     Total number of indexed entries
+
+Examples:
+  lore info
+  lore info | jq '.sources | length'
+  lore info --human
+`);
+  process.exit(0);
+}
+
+function showProjectsHelp(): void {
+  console.log(`
+lore projects - List all known projects
+
+Usage:
+  lore projects                         List all unique project names
+
+Options:
+  --help            Show this help
+
+Output:
+  JSON array of project names, sorted alphabetically.
+  Projects are extracted from metadata fields across all sources.
+
+Sources checked:
+  commits           project field
+  sessions          project field
+  tasks             project field
+  captures          context field
+  teachings         source field
+
+Examples:
+  lore projects
+  lore projects | jq -r '.projects[]'
+  lore projects | jq '.projects | length'
+`);
+  process.exit(0);
+}
+
 function showCaptureHelp(): void {
   console.log(`
 lore capture - Capture knowledge
@@ -724,11 +842,19 @@ function main(): void {
     case "list":
       handleList(commandArgs);
       break;
+    case "info":
+      handleInfo(commandArgs);
+      break;
+    case "projects":
+      handleProjects(commandArgs);
+      break;
     case "capture":
       handleCapture(commandArgs);
       break;
     default:
-      fail(`Unknown command: ${command}. Use: search, list, or capture`);
+      fail(
+        `Unknown command: ${command}. Use: search, list, info, projects, or capture`,
+      );
   }
 }
 

package/index.ts

@@ -27,6 +27,17 @@ export {
   type ListResult,
 } from "./lib/list";
 
+// Info
+export {
+  info,
+  formatInfoHuman,
+  type SourceInfo,
+  type InfoOutput,
+} from "./lib/info";
+
+// Projects
+export { projects } from "./lib/projects";
+
 // Prismis integration
 export {
   searchPrismis,

package/lib/info.ts

@@ -0,0 +1,114 @@
+/**
+ * lib/info.ts - Discovery command for indexed sources
+ *
+ * Shows what's indexed, counts per source, and last indexed timestamp.
+ * Uses Bun's built-in SQLite for zero external dependencies.
+ */
+
+import { Database } from "bun:sqlite";
+import { homedir } from "os";
+import { existsSync } from "fs";
+import { projects as getProjects } from "./projects.js";
+
+export interface SourceInfo {
+  name: string;
+  count: number;
+}
+
+export interface InfoOutput {
+  sources: SourceInfo[];
+  projects: string[];
+  last_indexed: string;
+  total_entries: number;
+}
+
+function getDatabasePath(): string {
+  return `${homedir()}/.local/share/lore/lore.db`;
+}
+
+/**
+ * Get info about indexed sources
+ *
+ * @returns InfoOutput with sources, counts, and metadata
+ * @throws Error if database doesn't exist
+ */
+export function info(): InfoOutput {
+  const dbPath = getDatabasePath();
+
+  if (!existsSync(dbPath)) {
+    // Return empty info if database doesn't exist
+    return {
+      sources: [],
+      projects: [],
+      last_indexed: new Date().toISOString(),
+      total_entries: 0,
+    };
+  }
+
+  const db = new Database(dbPath, { readonly: true });
+
+  try {
+    // Get distinct sources with counts
+    const sourcesStmt = db.prepare(`
+      SELECT source as name, COUNT(*) as count
+      FROM search
+      GROUP BY source
+      ORDER BY count DESC
+    `);
+    const sources = sourcesStmt.all() as SourceInfo[];
+
+    // Get total entries
+    const totalStmt = db.prepare(`SELECT COUNT(*) as total FROM search`);
+    const totalResult = totalStmt.get() as { total: number };
+    const total_entries = totalResult?.total ?? 0;
+
+    // Get last indexed timestamp from metadata
+    const tsStmt = db.prepare(`
+      SELECT MAX(json_extract(metadata, '$.timestamp')) as ts
+      FROM search
+      WHERE json_extract(metadata, '$.timestamp') IS NOT NULL
+    `);
+    const tsResult = tsStmt.get() as { ts: string | null };
+    const last_indexed = tsResult?.ts ?? new Date().toISOString();
+
+    return {
+      sources,
+      projects: getProjects(),
+      last_indexed,
+      total_entries,
+    };
+  } finally {
+    db.close();
+  }
+}
+
+/**
+ * Format info output for human readability
+ */
+export function formatInfoHuman(data: InfoOutput): string {
+  const lines: string[] = [
+    "Lore Knowledge Index",
+    "====================",
+    "",
+    `Total entries: ${data.total_entries.toLocaleString()}`,
+    `Last indexed: ${data.last_indexed}`,
+    "",
+    "Sources:",
+  ];
+
+  for (const source of data.sources) {
+    lines.push(
+      `  ${source.name.padEnd(15)} ${source.count.toLocaleString().padStart(8)} entries`,
+    );
+  }
+
+  if (data.projects.length > 0) {
+    lines.push("");
+    lines.push("Projects:");
+    for (const project of data.projects) {
+      lines.push(`  ${project}`);
+    }
+  }
+
+  return lines.join("\n");
+}

package/lib/projects.ts

@@ -0,0 +1,60 @@
+/**
+ * lib/projects.ts - List all known projects across sources
+ *
+ * Queries distinct project values from metadata fields, handling
+ * different field names per source type.
+ */
+
+import { Database } from "bun:sqlite";
+import { homedir } from "os";
+import { existsSync } from "fs";
+
+const PROJECT_FIELD: Record<string, string> = {
+  commits: "project",
+  sessions: "project",
+  tasks: "project",
+  captures: "context",
+  teachings: "source",
+};
+
+function getDatabasePath(): string {
+  return `${homedir()}/.local/share/lore/lore.db`;
+}
+
+/**
+ * Get all unique project names across sources
+ *
+ * @returns Sorted array of unique project names
+ */
+export function projects(): string[] {
+  const dbPath = getDatabasePath();
+
+  if (!existsSync(dbPath)) {
+    return [];
+  }
+
+  const db = new Database(dbPath, { readonly: true });
+
+  try {
+    const allProjects = new Set<string>();
+
+    for (const [source, field] of Object.entries(PROJECT_FIELD)) {
+      const stmt = db.prepare(`
+        SELECT DISTINCT json_extract(metadata, '$.${field}') as proj
+        FROM search
+        WHERE source = ? AND json_extract(metadata, '$.${field}') IS NOT NULL
+      `);
+      const results = stmt.all(source) as { proj: string | null }[];
+
+      for (const r of results) {
+        if (r.proj) {
+          allProjects.add(r.proj);
+        }
+      }
+    }
+
+    return Array.from(allProjects).sort();
+  } finally {
+    db.close();
+  }
+}

package/package.json

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