@voidwire/lore 0.5.2 → 0.5.4

package/index.ts

@@ -67,6 +67,7 @@ export {
   captureNote,
   captureTeaching,
   captureInsight,
+  captureLearning,
   type CaptureResult,
   type KnowledgeInput,
   type KnowledgeCaptureType,
@@ -75,6 +76,7 @@ export {
   type TeachingInput,
   type InsightInput,
   type InsightType,
+  type LearningInput,
   type CaptureEvent,
 } from "./lib/capture";
 

package/lib/capture.ts

@@ -73,6 +73,14 @@ export interface InsightInput {
   source: "auto";
 }
 
+export interface LearningInput {
+  topic: string; // "spanish", "guitar", "kubernetes"
+  persona: string; // "marcus", "elena", etc.
+  progress: string; // "Covered verb conjugations, struggles with subjunctive"
+  goal?: string; // "conversational in 3 months"
+  session_summary?: string; // Longer form session notes
+}
+
 interface TaskEvent {
   event: "captured";
   type: "task";
@@ -139,12 +147,26 @@ interface InsightEvent {
   };
 }
 
+interface LearningEvent {
+  event: "captured";
+  type: "learning";
+  timestamp: string;
+  data: {
+    topic: string;
+    persona: string;
+    progress: string;
+    goal?: string;
+    session_summary?: string;
+  };
+}
+
 type CaptureEvent =
   | TaskEvent
   | KnowledgeEvent
   | NoteEvent
   | TeachingEvent
-  | InsightEvent;
+  | InsightEvent
+  | LearningEvent;
 
 function getLogPath(): string {
   const dataHome =
@@ -317,4 +339,31 @@ export function captureInsight(input: InsightInput): CaptureResult {
   return writeEvent(event);
 }
 
+/**
+ * Capture a learning session progress
+ */
+export function captureLearning(input: LearningInput): CaptureResult {
+  if (!input.topic || !input.persona || !input.progress) {
+    return {
+      success: false,
+      error: "Missing required fields: topic, persona, progress",
+    };
+  }
+
+  const event: LearningEvent = {
+    event: "captured",
+    type: "learning",
+    timestamp: "",
+    data: {
+      topic: input.topic,
+      persona: input.persona,
+      progress: input.progress,
+      goal: input.goal,
+      session_summary: input.session_summary,
+    },
+  };
+
+  return writeEvent(event);
+}
+
 export type { CaptureEvent };

package/lib/list.ts

@@ -28,7 +28,8 @@ export type Source =
   | "habits"
   | "teachings"
   | "sessions"
-  | "insights";
+  | "insights"
+  | "learnings";
 
 export const SOURCES: Source[] = [
   "development",
@@ -49,6 +50,7 @@ export const SOURCES: Source[] = [
   "teachings",
   "sessions",
   "insights",
+  "learnings",
 ];
 
 // Sources that query the 'personal' source with type filter
@@ -69,6 +71,7 @@ const PROJECT_FIELD: Record<string, string> = {
   captures: "context",
   teachings: "source",
   insights: "project",
+  learnings: "topic",
 };
 
 export interface ListOptions {
@@ -128,6 +131,9 @@ function queryBySource(
     params.push(type);
   }
 
+  // Order by timestamp descending (most recent first)
+  sql += " ORDER BY json_extract(metadata, '$.timestamp') DESC";
+
   if (limit) {
     sql += " LIMIT ?";
     params.push(limit);

package/package.json

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