@voidwire/lore 0.4.0 → 0.5.1

package/cli.ts

@@ -332,10 +332,11 @@ function handleList(args: string[]): void {
     : undefined;
   const format = parsed.get("format") || "json";
   const project = parsed.get("project");
+  const type = parsed.get("type");
   const brief = hasFlag(args, "brief");
 
   try {
-    const result = list(source, { limit, project });
+    const result = list(source, { limit, project, type });
 
     if (brief) {
       console.log(formatBriefList(result));
@@ -801,6 +802,7 @@ Options:
   --limit <n>       Maximum entries (default: all)
   --format <fmt>    Output format: json (default), jsonl, human
   --project <name>  Filter by project name
+  --type <type>     Filter captures by type (learning, gotcha, preference, decision)
   --brief           Compact output (titles only)
   --help            Show this help
 
@@ -830,6 +832,7 @@ Examples:
   lore list development
   lore list commits --limit 10 --format human
   lore list commits --project=momentum --limit 5
+  lore list captures --type=learning --limit 5
   lore list books --format jsonl
 `);
   process.exit(0);

package/index.ts

@@ -66,12 +66,15 @@ export {
   captureTask,
   captureNote,
   captureTeaching,
+  captureInsight,
   type CaptureResult,
   type KnowledgeInput,
   type KnowledgeCaptureType,
   type TaskInput,
   type NoteInput,
   type TeachingInput,
+  type InsightInput,
+  type InsightType,
   type CaptureEvent,
 } from "./lib/capture";
 

package/lib/capture.ts

@@ -57,6 +57,22 @@ export interface TeachingInput {
   source?: string;
 }
 
+export type InsightType =
+  | "decision"
+  | "pattern"
+  | "preference"
+  | "problem"
+  | "tool"
+  | "summary";
+
+export interface InsightInput {
+  session_id: string;
+  project: string;
+  insight_type: InsightType;
+  text: string;
+  source: "auto";
+}
+
 interface TaskEvent {
   event: "captured";
   type: "task";
@@ -110,7 +126,25 @@ interface TeachingEvent {
   };
 }
 
-type CaptureEvent = TaskEvent | KnowledgeEvent | NoteEvent | TeachingEvent;
+interface InsightEvent {
+  event: "captured";
+  type: "insight";
+  timestamp: string;
+  data: {
+    session_id: string;
+    project: string;
+    insight_type: InsightType;
+    text: string;
+    source: "auto";
+  };
+}
+
+type CaptureEvent =
+  | TaskEvent
+  | KnowledgeEvent
+  | NoteEvent
+  | TeachingEvent
+  | InsightEvent;
 
 function getLogPath(): string {
   const dataHome =
@@ -247,4 +281,40 @@ export function captureTeaching(input: TeachingInput): CaptureResult {
   return writeEvent(event);
 }
 
+const VALID_INSIGHT_TYPES: InsightType[] = [
+  "decision",
+  "pattern",
+  "preference",
+  "problem",
+  "tool",
+  "summary",
+];
+
+/**
+ * Capture an auto-extracted insight from llm-summarize
+ */
+export function captureInsight(input: InsightInput): CaptureResult {
+  if (!VALID_INSIGHT_TYPES.includes(input.insight_type)) {
+    return {
+      success: false,
+      error: `Invalid insight_type: ${input.insight_type}. Must be one of: ${VALID_INSIGHT_TYPES.join(", ")}`,
+    };
+  }
+
+  const event: InsightEvent = {
+    event: "captured",
+    type: "insight",
+    timestamp: "",
+    data: {
+      session_id: input.session_id,
+      project: input.project,
+      insight_type: input.insight_type,
+      text: input.text,
+      source: input.source,
+    },
+  };
+
+  return writeEvent(event);
+}
+
 export type { CaptureEvent };

package/lib/list.ts

@@ -27,7 +27,8 @@ export type Source =
   | "people"
   | "habits"
   | "teachings"
-  | "sessions";
+  | "sessions"
+  | "insights";
 
 export const SOURCES: Source[] = [
   "development",
@@ -47,6 +48,7 @@ export const SOURCES: Source[] = [
   "habits",
   "teachings",
   "sessions",
+  "insights",
 ];
 
 // Sources that query the 'personal' source with type filter
@@ -66,11 +68,13 @@ const PROJECT_FIELD: Record<string, string> = {
   tasks: "project",
   captures: "context",
   teachings: "source",
+  insights: "project",
 };
 
 export interface ListOptions {
   limit?: number;
   project?: string;
+  type?: string;
 }
 
 export interface ListEntry {
@@ -104,6 +108,7 @@ function queryBySource(
   source: string,
   limit?: number,
   project?: string,
+  type?: string,
 ): ListEntry[] {
   let sql = "SELECT title, content, metadata FROM search WHERE source = ?";
   const params: (string | number)[] = [source];
@@ -117,6 +122,12 @@ function queryBySource(
     }
   }
 
+  // Add type filter if provided (captures source only)
+  if (type && source === "captures") {
+    sql += ` AND json_extract(metadata, '$.type') = ?`;
+    params.push(type);
+  }
+
   if (limit) {
     sql += " LIMIT ?";
     params.push(limit);
@@ -190,7 +201,13 @@ export function list(source: Source, options: ListOptions = {}): ListResult {
     if (personalType) {
       entries = queryPersonalType(db, personalType, options.limit);
     } else {
-      entries = queryBySource(db, source, options.limit, options.project);
+      entries = queryBySource(
+        db,
+        source,
+        options.limit,
+        options.project,
+        options.type,
+      );
     }
 
     return {

package/package.json

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