@jmtrin/opencode-kevin 0.3.0 → 0.5.0

package/dist/plugin/MemoryService.d.ts

@@ -29,10 +29,28 @@ export interface Memory {
     lastVerifiedAt?: string | null;
     /** v0.3.0 — lifecycle status. Default 'active'. */
     status?: string | null;
+    /** v0.4.0 — deterministic capture of the linked fix call (K4-014). */
+    fixArgs?: string | null;
+    /** v0.4.0 (BUG-008/010) — negative evidence: how many times the
+     * fingerprint recurred after injection (demotes confidence). */
+    recurrenceCount?: number | null;
+    /** v0.5.0 (K5-009 / plan §5.3, D5-07) — human verdict: ignored memories
+     * are excluded from retrieval and injection. */
+    ignored?: boolean;
+    /** v0.5.0 (K5-009 / plan §5.3) — id of the memory that superseded this
+     * one (decision/rule replacement, K3-014). Null when active. */
+    supersedes?: string | null;
+    /** v0.5.0 (K5-010 / plan §5.3, D5-02) — human judgement counters,
+     * folded into confidence by computeConfidence. */
+    feedbackPositive?: number;
+    feedbackNegative?: number;
 }
 export interface SaveInput {
     type: MemoryType;
     content: string;
+    /** v0.4.0 (BUG-008) — preserve the original id on okf import;
+     * when absent a fresh uuidv7 is generated. */
+    id?: string;
     scope?: MemoryScope;
     relevanceScore?: number;
     sourceTool?: string;
@@ -51,6 +69,9 @@ export interface SaveInput {
     lastVerifiedAt?: string;
     /** v0.3.0 — lifecycle status. Default 'active'. */
     status?: string;
+    /** v0.4.0 (BUG-008/010) — how many times the fingerprint recurred
+     * after injection (negative evidence, demotes confidence). */
+    recurrenceCount?: number;
 }
 export interface QueryInput {
     text: string;
@@ -65,6 +86,10 @@ export interface QueryInput {
     /** v0.3.0 — when true, includes rows where status = 'superseded'.
      * Default false (only active rows). */
     includeSuperseded?: boolean;
+    /** v0.3.0 (BUG-001) — when true, the slim payload also carries
+     * `confidence`, `evidence_count` and `last_verified_at` (v0.3.0 K3
+     * evidence fields). Default false (minimal slim shape). */
+    evidence?: boolean;
 }
 /** v0.2.0 — slim query payload (K2-010). Snippet is a short content prefix;
  * `score` is the FTS5 BM25 score when available, falling back to
@@ -76,6 +101,14 @@ export interface SlimMemory {
     score: number;
     snippet: string;
 }
+/** v0.3.0 (BUG-001) — slim payload extended with the evidence fields when
+ * `query({ evidence: true })`. Fills the `kevin_query(evidence: true)`
+ * contract without falling back to the full `Memory` shape. */
+export interface SlimMemoryWithEvidence extends SlimMemory {
+    confidence: number | null;
+    evidence_count: number | null;
+    last_verified_at: string | null;
+}
 export interface GetRelevantInput {
     query?: string;
     maxTokens?: number;
@@ -83,25 +116,65 @@ export interface GetRelevantInput {
     /** v0.3.0 — when true, includes rows where status = 'superseded'.
      * Default false (only active rows). */
     includeSuperseded?: boolean;
+    /**
+     * v0.4.0 (BUG-016) — when false, the relevance bump (K2-023) is
+     * skipped. Used by ContextInjector's probe fetch so the decision and
+     * any retry both see the ORIGINAL ranking; the single bump is applied
+     * by the fetch that actually produces the injected block.
+     */
+    bump?: boolean;
+    /**
+     * v0.5.0 (K5-008 / plan §5.6, D5-10) — injectable clock. Defaults to
+     * `new Date()` at the top of the method and is the ONLY time source
+     * for recency decay: replay and tests can freeze time. Never call
+     * `Date.now()` again inside the method.
+     */
+    now?: Date;
 }
+export declare const DATE_NOW = "2099-01-01T00:00:00.000Z";
 export declare class MemoryService {
     private readonly metrics;
     constructor(store: Store, metrics?: Metrics | null);
     private store;
+    private hasRecurrenceColumn;
+    private _hasRecurrenceColumn;
+    private hasIgnoredColumn;
     save(input: SaveInput): string;
     getById(id: string): Memory | null;
+    /**
+     * v0.4.0 (K4-016) — most recent ACTIVE memory for a fingerprint,
+     * optionally filtered by type. Feeds the HITL suggestion lookup
+     * (most-recurred fingerprint → its pattern memory).
+     */
+    getByFingerprint(fingerprint: string, type?: MemoryType): Memory | null;
     update(id: string, fields: Partial<Memory>): void;
     delete(id: string): void;
     /** v0.1.x behavior — returns full `Memory` rows. */
     query(input: QueryInput & {
         full: true;
     }): Memory[];
+    /** v0.3.0 (BUG-001) — slim rows carrying the evidence fields. */
+    query(input: QueryInput & {
+        evidence: true;
+    }): SlimMemoryWithEvidence[];
     /** v0.2.0 default — returns `SlimMemory` rows. */
     query(input: QueryInput): SlimMemory[];
     private isCrossProjectEnabled;
+    /**
+     * v0.4.0 (K4-012) — read a kevin_settings flag by key. Falls back to
+     * the caller-provided default when the key is missing or the table is
+     * unavailable (legacy DB without the settings table).
+     */
+    getSetting(key: string, fallback?: string): string;
     private loadAll;
     private queryRelevant;
     getRelevant(input: GetRelevantInput): Memory[];
+    /**
+     * v0.4.0 (BUG-016) — apply the K2-023 relevance bump to a fixed slice
+     * of ids, exactly once. Lets ContextInjector probe without mutating
+     * and still bump the slice it actually injects.
+     */
+    bumpRelevance(ids: string[]): void;
     /**
      * v0.3.0 (K3-004) — Promote an error memory to a causal pattern.
      *
@@ -111,7 +184,14 @@ export declare class MemoryService {
      * or null when the source error is not eligible (missing fingerprint,
      * wrong type, or already promoted).
      */
-    promoteToPattern(errorId: string, evidenceCount: number): string | null;
+    /**
+     * v0.4.0 (K4-009) — returns `{ id, created }` so callers can tell a
+     * newly-created pattern from an idempotent refresh.
+     */
+    promoteToPattern(errorId: string, evidenceCount: number, recurrenceCount?: number): {
+        id: string;
+        created: boolean;
+    } | null;
     /**
      * v0.2.0 (K2-026) — Feedback loop positive half (plan §B6.10 / D2-10).
      *