@voidwire/lore 0.7.0 → 0.8.0

package/cli.ts

@@ -56,6 +56,7 @@ import {
   type ObservationSubtype,
   type ObservationConfidence,
 } from "./index";
+import { isValidLoreType, LORE_TYPES } from "./lib/types";
 
 // ============================================================================
 // Argument Parsing
@@ -204,6 +205,17 @@ async function handleSearch(args: string[]): Promise<void> {
   const limit = parsed.has("limit") ? parseInt(parsed.get("limit")!, 10) : 20;
   const since = parsed.get("since");
   const project = parsed.get("project");
+  const type = parseList(parsed.get("type"));
+
+  // Validate type values against LoreType enum
+  if (type) {
+    const invalid = type.filter((t) => !isValidLoreType(t));
+    if (invalid.length > 0) {
+      fail(
+        `Invalid type: ${invalid.join(", ")}. Valid types: ${LORE_TYPES.join(", ")}`,
+      );
+    }
+  }
 
   // Handle prismis passthrough
   if (source === "prismis") {
@@ -250,7 +262,7 @@ async function handleSearch(args: string[]): Promise<void> {
   // FTS5 path (explicit --exact only)
   if (exact) {
     try {
-      const results = search(query, { source, limit, since });
+      const results = search(query, { source, limit, since, type });
       output({
         success: true,
         results,
@@ -278,7 +290,12 @@ async function handleSearch(args: string[]): Promise<void> {
   // Semantic-only path (explicit --semantic)
   if (semanticOnly) {
     try {
-      const results = await semanticSearch(query, { source, limit, project });
+      const results = await semanticSearch(query, {
+        source,
+        limit,
+        project,
+        type,
+      });
 
       if (brief) {
         console.log(formatBriefSearch(results));
@@ -308,6 +325,7 @@ async function handleSearch(args: string[]): Promise<void> {
       limit,
       project,
       since,
+      type,
     });
 
     if (brief) {
@@ -510,7 +528,7 @@ function handleAbout(args: string[]): void {
     const totalCount =
       result.commits.count +
       result.captures.count +
-      result.tasks.count +
+      result.flux.count +
       result.teachings.count +
       result.sessions.count;
 
@@ -817,6 +835,7 @@ Usage:
 
 Search Options:
   --exact           Use FTS5 text search (bypasses semantic search)
+  --type <types>    Filter by knowledge type (gotcha, decision, learning, etc.)
   --limit <n>       Maximum results (default: 20)
   --project <name>  Filter results by project
   --brief           Compact output (titles only)
@@ -864,6 +883,8 @@ Capture Types:
 
 Examples:
   lore search "authentication"
+  lore search --type=gotcha "sable"
+  lore search --type=gotcha,decision "lore"
   lore search blogs "typescript patterns"
   lore sources
   lore list development
@@ -888,6 +909,10 @@ Search Modes:
   --semantic        Vector search only
 
 Options:
+  --type <types>    Filter by knowledge type (pre-filters before search)
+                    Comma-separated: --type=gotcha,decision
+                    Valid: gotcha, decision, pattern, learning, preference,
+                           term, style, teaching, task, todo, idea
   --limit <n>       Maximum results (default: 20)
   --project <name>  Filter results by project/topic
   --brief           Compact output (titles only)
@@ -919,6 +944,8 @@ See also:
 
 Examples:
   lore search "authentication"                      # hybrid (default)
+  lore search --type=gotcha "sable"                 # filter by type
+  lore search --type=gotcha,decision "lore"         # multiple types
   lore search --exact "def process_data"            # keyword only
   lore search --semantic "login flow concepts"      # vector only
   lore search blogs "typescript patterns"
@@ -1048,7 +1075,7 @@ Options:
 Sources queried:
   commits           Git commits for project
   captures          Quick captures in project context
-  tasks             Development tasks for project
+  flux              Flux items for project
   teachings         Teachings from project
   sessions          Claude Code sessions for project
 
@@ -1057,7 +1084,7 @@ Output (JSON):
     "project": "name",
     "commits": [...],
     "captures": [...],
-    "tasks": [...],
+    "flux": [...],
     "teachings": [...],
     "sessions": [...]
   }

package/index.ts

@@ -97,5 +97,8 @@ export {
   type HybridSearchOptions,
 } from "./lib/semantic";
 
+// Types
+export { LoreType, LORE_TYPES, isValidLoreType } from "./lib/types";
+
 // Real-time indexing
 export { indexAndEmbed } from "./lib/realtime";

package/lib/about.ts

@@ -16,7 +16,7 @@ export interface AboutResult {
   project: string;
   commits: ListResult;
   captures: ListResult;
-  tasks: ListResult;
+  flux: ListResult;
   teachings: ListResult;
   sessions: ListResult;
 }
@@ -29,7 +29,7 @@ export interface AboutResult {
 const ABOUT_SOURCES: Source[] = [
   "commits",
   "captures",
-  "tasks",
+  "flux",
   "teachings",
   "sessions",
 ];
@@ -65,7 +65,7 @@ export function about(
     project,
     commits: results[0],
     captures: results[1],
-    tasks: results[2],
+    flux: results[2],
     teachings: results[3],
     sessions: results[4],
   };
@@ -85,8 +85,8 @@ export function formatBriefAbout(result: AboutResult): string {
   if (result.captures.count > 0) {
     sections.push(formatBriefList(result.captures));
   }
-  if (result.tasks.count > 0) {
-    sections.push(formatBriefList(result.tasks));
+  if (result.flux.count > 0) {
+    sections.push(formatBriefList(result.flux));
   }
   if (result.teachings.count > 0) {
     sections.push(formatBriefList(result.teachings));

package/lib/list.ts

@@ -12,7 +12,7 @@ import { existsSync } from "fs";
 // Source types - data sources that can be listed
 export type Source =
   | "development"
-  | "tasks"
+  | "flux"
   | "events"
   | "blogs"
   | "commits"
@@ -34,7 +34,7 @@ export type Source =
 
 export const SOURCES: Source[] = [
   "development",
-  "tasks",
+  "flux",
   "events",
   "blogs",
   "commits",
@@ -70,7 +70,7 @@ const PERSONAL_SUBTYPES: Partial<Record<Source, string>> = {
 const PROJECT_FIELD: Record<string, string> = {
   commits: "project",
   sessions: "project",
-  tasks: "project",
+  flux: "project",
   insights: "topic",
   captures: "topic",
   teachings: "topic",

package/lib/realtime.ts

@@ -113,7 +113,7 @@ function getSourceForEvent(event: CaptureEvent): string {
     case "learning":
       return "learnings";
     case "task":
-      return "tasks";
+      return "flux";
     case "note":
       return "captures";
     default:

package/lib/search.ts

@@ -22,6 +22,7 @@ export interface SearchOptions {
   source?: string;
   limit?: number;
   since?: string;
+  type?: string | string[];
 }
 
 function getDatabasePath(): string {
@@ -73,6 +74,18 @@ export function search(
       params.push(options.source);
     }
 
+    if (options.type) {
+      const types = Array.isArray(options.type) ? options.type : [options.type];
+      const typeClauses = types.map(
+        () =>
+          "(json_extract(metadata, '$.type') = ? OR json_extract(metadata, '$.subtype') = ?)",
+      );
+      conditions.push(`(${typeClauses.join(" OR ")})`);
+      types.forEach((t) => {
+        params.push(t, t);
+      });
+    }
+
     if (options.since) {
       conditions.push(
         "json_extract(metadata, '$.date') IS NOT NULL AND json_extract(metadata, '$.date') != 'unknown' AND json_extract(metadata, '$.date') >= ?",

package/lib/semantic.ts

@@ -25,6 +25,7 @@ export interface SemanticSearchOptions {
   source?: string;
   limit?: number;
   project?: string;
+  type?: string | string[];
 }
 
 /**
@@ -230,6 +231,13 @@ export async function semanticSearch(
       params.push(options.project);
     }
 
+    if (options.type) {
+      const types = Array.isArray(options.type) ? options.type : [options.type];
+      const placeholders = types.map(() => "?").join(", ");
+      conditions.push(`e.type IN (${placeholders})`);
+      params.push(...types);
+    }
+
     sql = `
       SELECT
         s.rowid,
@@ -274,6 +282,7 @@ export interface HybridSearchOptions {
   limit?: number;
   project?: string;
   since?: string;
+  type?: string | string[];
   vectorWeight?: number;
   textWeight?: number;
 }
@@ -325,12 +334,14 @@ export async function hybridSearch(
       source: options.source,
       limit: fetchLimit,
       project: options.project,
+      type: options.type,
     }),
     Promise.resolve(
       keywordSearch(query, {
         source: options.source,
         limit: fetchLimit,
         since: options.since,
+        type: options.type,
       }),
     ),
   ]);

package/lib/types.ts

@@ -0,0 +1,33 @@
+/**
+ * lib/types.ts - Core type definitions for lore
+ */
+
+/**
+ * Capture type vocabulary
+ * Single source of truth for --type filter validation
+ */
+export enum LoreType {
+  Gotcha = "gotcha",
+  Decision = "decision",
+  Pattern = "pattern",
+  Learning = "learning",
+  Preference = "preference",
+  Term = "term",
+  Style = "style",
+  Teaching = "teaching",
+  Task = "task",
+  Todo = "todo",
+  Idea = "idea",
+}
+
+/**
+ * Valid type values for runtime checking
+ */
+export const LORE_TYPES = Object.values(LoreType);
+
+/**
+ * Check if a string is a valid LoreType
+ */
+export function isValidLoreType(value: string): value is LoreType {
+  return LORE_TYPES.includes(value as LoreType);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voidwire/lore",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Unified knowledge CLI - Search, list, and capture your indexed knowledge",
   "type": "module",
   "main": "./index.ts",
@@ -49,6 +49,8 @@
     "bun-types": "1.3.5"
   },
   "scripts": {
+    "build": "tsc --noEmit false --outDir dist --declaration",
+    "typecheck": "tsc --noEmit",
     "test": "bun test"
   }
 }