learning-agent 0.2.1 → 0.2.2

package/dist/index.d.ts

@@ -63,6 +63,24 @@ declare const LessonSchema: z.ZodObject<{
     }>>;
     deleted: z.ZodOptional<z.ZodBoolean>;
     retrievalCount: z.ZodOptional<z.ZodNumber>;
+    citation: z.ZodOptional<z.ZodObject<{
+        file: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        commit: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        file: string;
+        line?: number | undefined;
+        commit?: string | undefined;
+    }, {
+        file: string;
+        line?: number | undefined;
+        commit?: string | undefined;
+    }>>;
+    compactionLevel: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+    compactedAt: z.ZodOptional<z.ZodString>;
+    lastRetrieved: z.ZodOptional<z.ZodString>;
+    invalidatedAt: z.ZodOptional<z.ZodString>;
+    invalidationReason: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     type: "quick" | "full";
     id: string;
@@ -86,6 +104,16 @@ declare const LessonSchema: z.ZodObject<{
     } | undefined;
     deleted?: boolean | undefined;
     retrievalCount?: number | undefined;
+    citation?: {
+        file: string;
+        line?: number | undefined;
+        commit?: string | undefined;
+    } | undefined;
+    compactionLevel?: 0 | 1 | 2 | undefined;
+    compactedAt?: string | undefined;
+    lastRetrieved?: string | undefined;
+    invalidatedAt?: string | undefined;
+    invalidationReason?: string | undefined;
 }, {
     type: "quick" | "full";
     id: string;
@@ -109,6 +137,16 @@ declare const LessonSchema: z.ZodObject<{
     } | undefined;
     deleted?: boolean | undefined;
     retrievalCount?: number | undefined;
+    citation?: {
+        file: string;
+        line?: number | undefined;
+        commit?: string | undefined;
+    } | undefined;
+    compactionLevel?: 0 | 1 | 2 | undefined;
+    compactedAt?: string | undefined;
+    lastRetrieved?: string | undefined;
+    invalidatedAt?: string | undefined;
+    invalidationReason?: string | undefined;
 }>;
 declare const TombstoneSchema: z.ZodObject<{
     id: z.ZodString;

package/dist/index.js

@@ -22,7 +22,23 @@ var PatternSchema = z.object({
   bad: z.string(),
   good: z.string()
 });
+var CitationSchema = z.object({
+  file: z.string().min(1),
+  // Source file path (required, non-empty)
+  line: z.number().int().positive().optional(),
+  // Line number (optional, must be positive)
+  commit: z.string().optional()
+  // Git commit hash (optional)
+});
 var SeveritySchema = z.enum(["high", "medium", "low"]);
+var CompactionLevelSchema = z.union([
+  z.literal(0),
+  // Active
+  z.literal(1),
+  // Flagged (>90 days)
+  z.literal(2)
+  // Archived
+]);
 var LessonTypeSchema = z.enum(["quick", "full"]);
 var LessonSchema = z.object({
   // Core identity (required)
@@ -46,7 +62,20 @@ var LessonSchema = z.object({
   pattern: PatternSchema.optional(),
   // Lifecycle fields (optional)
   deleted: z.boolean().optional(),
-  retrievalCount: z.number().optional()
+  retrievalCount: z.number().optional(),
+  // Provenance tracking (optional)
+  citation: CitationSchema.optional(),
+  // Age-based validity fields (optional)
+  compactionLevel: CompactionLevelSchema.optional(),
+  // 0=active, 1=flagged, 2=archived
+  compactedAt: z.string().optional(),
+  // ISO8601 when compaction happened
+  lastRetrieved: z.string().optional(),
+  // ISO8601 last retrieval time
+  // Invalidation fields (optional - for marking lessons as wrong)
+  invalidatedAt: z.string().optional(),
+  // ISO8601
+  invalidationReason: z.string().optional()
 });
 var TombstoneSchema = z.object({
   id: z.string(),
@@ -150,7 +179,15 @@ var SCHEMA_SQL = `
     retrieval_count INTEGER NOT NULL DEFAULT 0,
     last_retrieved TEXT,
     embedding BLOB,
-    content_hash TEXT
+    content_hash TEXT,
+    -- v0.2.2 fields
+    invalidated_at TEXT,
+    invalidation_reason TEXT,
+    citation_file TEXT,
+    citation_line INTEGER,
+    citation_commit TEXT,
+    compaction_level INTEGER DEFAULT 0,
+    compacted_at TEXT
   );
 
   -- FTS5 virtual table for full-text search
@@ -265,6 +302,28 @@ function rowToLesson(row) {
   if (row.retrieval_count > 0) {
     lesson.retrievalCount = row.retrieval_count;
   }
+  if (row.invalidated_at !== null) {
+    lesson.invalidatedAt = row.invalidated_at;
+  }
+  if (row.invalidation_reason !== null) {
+    lesson.invalidationReason = row.invalidation_reason;
+  }
+  if (row.citation_file !== null) {
+    lesson.citation = {
+      file: row.citation_file,
+      ...row.citation_line !== null && { line: row.citation_line },
+      ...row.citation_commit !== null && { commit: row.citation_commit }
+    };
+  }
+  if (row.compaction_level !== null && row.compaction_level !== 0) {
+    lesson.compactionLevel = row.compaction_level;
+  }
+  if (row.compacted_at !== null) {
+    lesson.compactedAt = row.compacted_at;
+  }
+  if (row.last_retrieved !== null) {
+    lesson.lastRetrieved = row.last_retrieved;
+  }
   return lesson;
 }
 function collectCachedEmbeddings(database) {
@@ -278,8 +337,8 @@ function collectCachedEmbeddings(database) {
   return cache;
 }
 var INSERT_LESSON_SQL = `
-  INSERT INTO lessons (id, type, trigger, insight, evidence, severity, tags, source, context, supersedes, related, created, confirmed, deleted, retrieval_count, last_retrieved, embedding, content_hash)
-  VALUES (@id, @type, @trigger, @insight, @evidence, @severity, @tags, @source, @context, @supersedes, @related, @created, @confirmed, @deleted, @retrieval_count, @last_retrieved, @embedding, @content_hash)
+  INSERT INTO lessons (id, type, trigger, insight, evidence, severity, tags, source, context, supersedes, related, created, confirmed, deleted, retrieval_count, last_retrieved, embedding, content_hash, invalidated_at, invalidation_reason, citation_file, citation_line, citation_commit, compaction_level, compacted_at)
+  VALUES (@id, @type, @trigger, @insight, @evidence, @severity, @tags, @source, @context, @supersedes, @related, @created, @confirmed, @deleted, @retrieval_count, @last_retrieved, @embedding, @content_hash, @invalidated_at, @invalidation_reason, @citation_file, @citation_line, @citation_commit, @compaction_level, @compacted_at)
 `;
 function getJsonlMtime(repoRoot) {
   const jsonlPath = join(repoRoot, LESSONS_PATH);
@@ -331,10 +390,17 @@ async function rebuildIndex(repoRoot) {
         confirmed: lesson.confirmed ? 1 : 0,
         deleted: lesson.deleted ? 1 : 0,
         retrieval_count: lesson.retrievalCount ?? 0,
-        last_retrieved: null,
-        // Reset on rebuild since we're rebuilding from source
+        last_retrieved: lesson.lastRetrieved ?? null,
         embedding: hasValidCache ? cached.embedding : null,
-        content_hash: hasValidCache ? cached.contentHash : null
+        content_hash: hasValidCache ? cached.contentHash : null,
+        // v0.2.2 fields
+        invalidated_at: lesson.invalidatedAt ?? null,
+        invalidation_reason: lesson.invalidationReason ?? null,
+        citation_file: lesson.citation?.file ?? null,
+        citation_line: lesson.citation?.line ?? null,
+        citation_commit: lesson.citation?.commit ?? null,
+        compaction_level: lesson.compactionLevel ?? 0,
+        compacted_at: lesson.compactedAt ?? null
       });
     }
   });
@@ -369,6 +435,7 @@ async function searchKeyword(repoRoot, query, limit) {
       FROM lessons l
       JOIN lessons_fts fts ON l.rowid = fts.rowid
       WHERE lessons_fts MATCH ?
+        AND l.invalidated_at IS NULL
       LIMIT ?
     `
   ).all(query, limit);
@@ -462,6 +529,7 @@ async function searchVector(repoRoot, query, options) {
   const queryVector = await embedText(query);
   const scored = [];
   for (const lesson of lessons) {
+    if (lesson.invalidatedAt) continue;
     const lessonText = `${lesson.trigger} ${lesson.insight}`;
     const hash = contentHash(lesson.trigger, lesson.insight);
     let lessonVector = getCachedEmbedding(repoRoot, lesson.id, hash);
@@ -476,6 +544,14 @@ async function searchVector(repoRoot, query, options) {
   return scored.slice(0, limit);
 }
 
+// src/utils.ts
+var MS_PER_DAY = 24 * 60 * 60 * 1e3;
+function getLessonAgeDays(lesson) {
+  const created = new Date(lesson.created).getTime();
+  const now = Date.now();
+  return Math.floor((now - created) / MS_PER_DAY);
+}
+
 // src/search/ranking.ts
 var RECENCY_THRESHOLD_DAYS = 30;
 var HIGH_SEVERITY_BOOST = 1.5;
@@ -496,10 +572,7 @@ function severityBoost(lesson) {
   }
 }
 function recencyBoost(lesson) {
-  const created = new Date(lesson.created);
-  const now = /* @__PURE__ */ new Date();
-  const ageMs = now.getTime() - created.getTime();
-  const ageDays = Math.floor(ageMs / (1e3 * 60 * 60 * 24));
+  const ageDays = getLessonAgeDays(lesson);
   return ageDays <= RECENCY_THRESHOLD_DAYS ? RECENCY_BOOST : 1;
 }
 function confirmationBoost(lesson) {
@@ -690,7 +763,7 @@ function isFullLesson(lesson) {
 async function loadSessionLessons(repoRoot, limit = DEFAULT_LIMIT2) {
   const { lessons: allLessons } = await readLessons(repoRoot);
   const highSeverityLessons = allLessons.filter(
-    (lesson) => isFullLesson(lesson) && lesson.severity === "high" && lesson.confirmed
+    (lesson) => isFullLesson(lesson) && lesson.severity === "high" && lesson.confirmed && !lesson.invalidatedAt
   );
   highSeverityLessons.sort((a, b) => {
     const dateA = new Date(a.created).getTime();