laminark 2.21.6

package/plugin/dist/observations-Ch0nc47i.d.mts

@@ -0,0 +1,170 @@
+import Database from "better-sqlite3";
+import { z } from "zod";
+
+//#region src/shared/types.d.ts
+/**
+ * Observation -- the application-layer shape.
+ * Uses camelCase for idiomatic TypeScript.
+ * embedding is Float32Array (converted from Buffer during mapping).
+ */
+type ObservationClassification = 'discovery' | 'problem' | 'solution' | 'noise';
+type ObservationKind = 'change' | 'reference' | 'finding' | 'decision' | 'verification';
+interface Observation {
+  rowid: number;
+  id: string;
+  projectHash: string;
+  content: string;
+  title: string | null;
+  source: string;
+  sessionId: string | null;
+  kind: ObservationKind;
+  embedding: Float32Array | null;
+  embeddingModel: string | null;
+  embeddingVersion: string | null;
+  classification: ObservationClassification | null;
+  classifiedAt: string | null;
+  createdAt: string;
+  updatedAt: string;
+  deletedAt: string | null;
+}
+/**
+ * ObservationInsert -- input for creating observations.
+ * Validated at runtime via Zod schema.
+ */
+declare const ObservationInsertSchema: z.ZodObject<{
+  content: z.ZodString;
+  title: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+  source: z.ZodDefault<z.ZodString>;
+  kind: z.ZodDefault<z.ZodString>;
+  sessionId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+  embedding: z.ZodDefault<z.ZodNullable<z.ZodCustom<Float32Array<ArrayBuffer>, Float32Array<ArrayBuffer>>>>;
+  embeddingModel: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+  embeddingVersion: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type ObservationInsert = z.input<typeof ObservationInsertSchema>;
+interface Session {
+  id: string;
+  projectHash: string;
+  startedAt: string;
+  endedAt: string | null;
+  summary: string | null;
+}
+interface SearchResult {
+  observation: Observation;
+  score: number;
+  matchType: 'fts' | 'vector' | 'hybrid';
+  snippet: string;
+}
+interface DatabaseConfig {
+  dbPath: string;
+  busyTimeout: number;
+}
+//#endregion
+//#region src/storage/observations.d.ts
+/**
+ * Repository for observation CRUD operations.
+ *
+ * Every query is scoped to the projectHash provided at construction time.
+ * Callers cannot accidentally query the wrong project -- project isolation
+ * is baked into every prepared statement.
+ *
+ * All SQL statements are prepared once in the constructor and reused for
+ * every call (better-sqlite3 performance best practice).
+ */
+declare class ObservationRepository {
+  private readonly db;
+  private readonly projectHash;
+  private readonly stmtInsert;
+  private readonly stmtGetById;
+  private readonly stmtGetByIdIncludingDeleted;
+  private readonly stmtSoftDelete;
+  private readonly stmtRestore;
+  private readonly stmtCount;
+  constructor(db: Database.Database, projectHash: string);
+  /**
+   * Creates a new observation scoped to this repository's project.
+   * Validates input with Zod at runtime.
+   */
+  create(input: ObservationInsert): Observation;
+  /**
+   * Gets an observation by ID, scoped to this project.
+   * Returns null if not found or soft-deleted.
+   */
+  getById(id: string): Observation | null;
+  /**
+   * Lists observations for this project, ordered by created_at DESC.
+   * Excludes soft-deleted observations.
+   */
+  list(options?: {
+    limit?: number;
+    offset?: number;
+    sessionId?: string;
+    since?: string;
+    kind?: string;
+    includeUnclassified?: boolean;
+  }): Observation[];
+  /**
+   * Updates an observation's content, embedding fields, or both.
+   * Always sets updated_at to current time.
+   * Scoped to this project; returns null if not found or soft-deleted.
+   */
+  update(id: string, updates: Partial<Pick<Observation, 'content' | 'embedding' | 'embeddingModel' | 'embeddingVersion'>>): Observation | null;
+  /**
+   * Soft-deletes an observation by setting deleted_at.
+   * Returns true if the observation was found and deleted.
+   */
+  softDelete(id: string): boolean;
+  /**
+   * Restores a soft-deleted observation by clearing deleted_at.
+   * Returns true if the observation was found and restored.
+   */
+  restore(id: string): boolean;
+  /**
+   * Updates the classification of an observation.
+   * Sets classified_at to current time. Returns true if found and updated.
+   */
+  updateClassification(id: string, classification: ObservationClassification): boolean;
+  /**
+   * Creates an observation with an initial classification (bypasses classifier).
+   * Used for explicit user saves that should be immediately visible.
+   */
+  createClassified(input: ObservationInsert, classification: ObservationClassification): Observation;
+  /**
+   * Fetches unclassified observations for the background classifier.
+   * Returns observations ordered by created_at ASC (oldest first).
+   */
+  listUnclassified(limit?: number): Observation[];
+  /**
+   * Fetches observations surrounding a given timestamp for classification context.
+   * Returns observations regardless of classification status.
+   */
+  listContext(aroundTime: string, windowSize?: number): Observation[];
+  /**
+   * Counts non-deleted observations for this project.
+   */
+  count(): number;
+  /**
+   * Gets an observation by ID, including soft-deleted observations.
+   * Used by the recall tool for restore operations (must find purged items).
+   */
+  getByIdIncludingDeleted(id: string): Observation | null;
+  /**
+   * Lists observations for this project, including soft-deleted ones.
+   * Used by recall with include_purged: true to show all items.
+   */
+  listIncludingDeleted(options?: {
+    limit?: number;
+    offset?: number;
+  }): Observation[];
+  /**
+   * Searches observations by title substring (partial match via LIKE).
+   * Optionally includes soft-deleted items.
+   */
+  getByTitle(title: string, options?: {
+    limit?: number;
+    includePurged?: boolean;
+  }): Observation[];
+}
+//#endregion
+export { SearchResult as a, ObservationInsert as i, DatabaseConfig as n, Session as o, Observation as r, ObservationRepository as t };
+//# sourceMappingURL=observations-Ch0nc47i.d.mts.map

package/plugin/dist/observations-Ch0nc47i.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observations-Ch0nc47i.d.mts","names":[],"sources":["../../src/shared/types.ts","../../src/storage/observations.ts"],"mappings":";;;;;;;;;KAyCY,yBAAA;AAAA,KAEA,eAAA;AAAA,UAEK,WAAA;EACf,KAAA;EACA,EAAA;EACA,WAAA;EACA,OAAA;EACA,KAAA;EACA,MAAA;EACA,SAAA;EACA,IAAA,EAAM,eAAA;EACN,SAAA,EAAW,YAAA;EACX,cAAA;EACA,gBAAA;EACA,cAAA,EAAgB,yBAAA;EAChB,YAAA;EACA,SAAA;EACA,SAAA;EACA,SAAA;AAAA;;;;;cAWW,uBAAA,EAAuB,CAAA,CAAA,SAAA;;;;;;;;;;KAWxB,iBAAA,GAAoB,CAAA,CAAE,KAAA,QAAa,uBAAA;AAAA,UAM9B,OAAA;EACf,EAAA;EACA,WAAA;EACA,SAAA;EACA,OAAA;EACA,OAAA;AAAA;AAAA,UAOe,YAAA;EACf,WAAA,EAAa,WAAA;EACb,KAAA;EACA,SAAA;EACA,OAAA;AAAA;AAAA,UAOe,cAAA;EACf,MAAA;EACA,WAAA;AAAA;;;;;AAzEF;;;;;AAEA;;;cCpBa,qBAAA;EAAA,iBACM,EAAA;EAAA,iBACA,WAAA;EAAA,iBAGA,UAAA;EAAA,iBACA,WAAA;EAAA,iBACA,2BAAA;EAAA,iBACA,cAAA;EAAA,iBACA,WAAA;EAAA,iBACA,SAAA;cAEL,EAAA,EAAI,QAAA,CAAc,QAAA,EAAU,WAAA;EDWxC;;;;ECgCA,MAAA,CAAO,KAAA,EAAO,iBAAA,GAAoB,WAAA;ED3BlC;;;;ECwEA,OAAA,CAAQ,EAAA,WAAa,WAAA;EDrEV;;;;ECgFX,IAAA,CAAK,OAAA;IACH,KAAA;IACA,MAAA;IACA,SAAA;IACA,KAAA;IACA,IAAA;IACA,mBAAA;EAAA,IACE,WAAA;ED5DJ;;;;;ECyGA,MAAA,CACE,EAAA,UACA,OAAA,EAAS,OAAA,CACP,IAAA,CACE,WAAA,sEAIH,WAAA;;;;;EAqDH,UAAA,CAAW,EAAA;;;;;EAWX,OAAA,CAAQ,EAAA;;;;;EASR,oBAAA,CACE,EAAA,UACA,cAAA,EAAgB,yBAAA;;;;;EAgBlB,gBAAA,CAAiB,KAAA,EAAO,iBAAA,EAAmB,cAAA,EAAgB,yBAAA,GAA4B,WAAA;;;;;EAWvF,gBAAA,CAAiB,KAAA,YAAqB,WAAA;EDhOJ;;;;EC+OlC,WAAA,CAAY,UAAA,UAAoB,UAAA,YAAyB,WAAA;;;;EAsCzD,KAAA,CAAA;;;;;EASA,uBAAA,CAAwB,EAAA,WAAa,WAAA;;;;;EAYrC,oBAAA,CAAqB,OAAA;IACnB,KAAA;IACA,MAAA;EAAA,IACE,WAAA;;;;;EAuBJ,UAAA,CACE,KAAA,UACA,OAAA;IAAY,KAAA;IAAgB,aAAA;EAAA,IAC3B,WAAA;AAAA"}