@jmtrin/opencode-kevin 0.1.5 → 0.3.0

package/dist/plugin/ContextInjector.js

@@ -1,4 +1,5 @@
 import { formatMemories } from "./memory-format.js";
+import { estimateTokens } from "./metrics.js";
 const SYSTEM_TRANSFORM_TOKENS = 1500;
 const COMPACTING_TOKENS = 2000;
 const STOP_WORDS = new Set([
@@ -69,8 +70,72 @@ function isWordChar(ch) {
 }
 export class ContextInjector {
     memoryService;
-    constructor(memoryService) {
+    metrics;
+    lastRecurrenceCount = 0;
+    constructor(memoryService, metrics = null) {
         this.memoryService = memoryService;
+        this.metrics = metrics;
+    }
+    /**
+     * v0.3.0 (K3-020) — notify the injector that the negative feedback half
+     * fired N times in the last session.idle. The next system.transform or
+     * compacting hook will prepend a HITL suggestion block.
+     */
+    setRecurrences(count) {
+        this.lastRecurrenceCount = count;
+    }
+    /**
+     * v0.3.0 (K3-020) — generate a HITL suggestion block when recurrences
+     * occurred. Returns the block or empty string. Resets the counter.
+     */
+    generateSuggestion() {
+        if (this.lastRecurrenceCount === 0)
+            return "";
+        const block = `<kevin-suggestion>
+The same error pattern recurred ${this.lastRecurrenceCount} time(s) this session.
+Consider adding a skill or convention to AGENTS.md to prevent this.
+
+Draft:
+\`\`\`markdown
+## Recurring pattern
+- ${this.lastRecurrenceCount} recurrence(s) this session
+- Kevin's confidence in this pattern is low
+- Consider documenting the fix in AGENTS.md
+\`\`\`
+</kevin-suggestion>`;
+        this.lastRecurrenceCount = 0;
+        return block;
+    }
+    /**
+     * v0.2.0 (K2-024): origin-aware ranking at injection time is delegated
+     * to `MemoryService.getRelevant()` (K2-023, D2-13). The injector does
+     * NOT re-rank on its own — it consumes the already-ranked slice and
+     * applies the conditional-budget guard for opt-out (`protect: false`)
+     * callers. Plan §B6.5: "apply the same multiplier as
+     * MemoryService.recall so reflector lessons outrank agent-saved notes
+     * at injection time" — satisfied transitively via the getRelevant call.
+     */
+    inject(query, tag, cap, metricKey) {
+        let memories = this.memoryService.getRelevant({ query, maxTokens: cap });
+        if (memories.length === 0)
+            return "";
+        const firstBlock = formatMemories(memories, tag);
+        const aggregateTokens = estimateTokens(firstBlock);
+        const firstRowProtect = memories[0]
+            ?.protect;
+        const noProtectAboveTheFold = firstRowProtect === false;
+        if (aggregateTokens > 0.8 * cap && noProtectAboveTheFold) {
+            const lowerCap = Math.max(1, Math.round(0.8 * cap));
+            memories = this.memoryService.getRelevant({
+                query,
+                maxTokens: lowerCap,
+            });
+            if (memories.length === 0)
+                return "";
+        }
+        const block = formatMemories(memories, tag);
+        this.metrics?.incr(metricKey, estimateTokens(block));
+        return block;
     }
     deriveQuery(messages) {
         let lastUserContent = "";
@@ -100,25 +165,17 @@ export class ContextInjector {
         const query = this.deriveQuery(input.messages);
         if (!query)
             return;
-        const memories = this.memoryService.getRelevant({
-            query,
-            maxTokens: SYSTEM_TRANSFORM_TOKENS,
-        });
-        if (memories.length === 0)
-            return;
-        output.system.push(formatMemories(memories, "context"));
+        const block = this.inject(query, "context", SYSTEM_TRANSFORM_TOKENS, "tokens_injected_pre_prompt");
+        if (block)
+            output.system.push(block);
     }
     onCompacting(input, output) {
         const query = this.deriveQuery(input.messages);
         if (!query)
             return;
-        const memories = this.memoryService.getRelevant({
-            query,
-            maxTokens: COMPACTING_TOKENS,
-        });
-        if (memories.length === 0)
-            return;
-        output.context.push(formatMemories(memories, "memory"));
+        const block = this.inject(query, "memory", COMPACTING_TOKENS, "tokens_injected_compacting");
+        if (block)
+            output.context.push(block);
     }
 }
 //# sourceMappingURL=ContextInjector.js.map

package/dist/plugin/ContextInjector.js.map

@@ -1 +1 @@
-{"version":3,"file":"ContextInjector.js","sourceRoot":"","sources":["../../plugin/ContextInjector.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ContextInjector.js","sourceRoot":"","sources":["../../plugin/ContextInjector.ts"],"names":[],"mappings":"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"}

package/dist/plugin/MemoryService.d.ts

@@ -1,6 +1,8 @@
 import type { Store } from "./Store.js";
-export type MemoryType = "error" | "pattern" | "decision" | "context";
+import type { Metrics } from "./metrics.js";
+export type MemoryType = "error" | "pattern" | "decision" | "context" | "rule" | "solution";
 export type MemoryScope = "project" | "session";
+export type MemoryOrigin = "reflector" | "agent" | "pattern" | "retrospective" | "causal" | "imported";
 export interface Memory {
     id: string;
     type: MemoryType;
@@ -13,6 +15,20 @@ export interface Memory {
     createdAt: string;
     updatedAt: string;
     expiresAt?: string | null;
+    /** v0.2.0 — project the memory belongs to (nullable for legacy rows). */
+    projectId?: string | null;
+    /** v0.2.0 — content fingerprint for dedup (only set for `type='error'`). */
+    fingerprint?: string | null;
+    /** v0.2.0 — origin of the memory. */
+    origin?: MemoryOrigin | null;
+    /** v0.3.0 — confidence derived from causal evidence (0..1). Only set by CausalChain. */
+    confidence?: number | null;
+    /** v0.3.0 — number of confirmed causal fix confirmations. */
+    evidenceCount?: number | null;
+    /** v0.3.0 — last time causal evidence was observed. */
+    lastVerifiedAt?: string | null;
+    /** v0.3.0 — lifecycle status. Default 'active'. */
+    status?: string | null;
 }
 export interface SaveInput {
     type: MemoryType;
@@ -23,27 +39,118 @@ export interface SaveInput {
     sourceSession?: string;
     metadata?: Record<string, unknown>;
     expiresAt?: string;
+    /** v0.2.0 — project id. When absent, the memory is cross-project (NULL project_id). */
+    projectId?: string;
+    /** v0.2.0 — origin. Defaults to `'agent'` when omitted. */
+    origin?: MemoryOrigin;
+    /** v0.2.0 — explicit fingerprint. Auto-derived for `type='error'` if absent. */
+    fingerprint?: string;
+    /** v0.3.0 — number of confirmed causal fix confirmations. */
+    evidenceCount?: number;
+    /** v0.3.0 — last time causal evidence was observed. */
+    lastVerifiedAt?: string;
+    /** v0.3.0 — lifecycle status. Default 'active'. */
+    status?: string;
 }
 export interface QueryInput {
     text: string;
     type?: string;
     scope?: MemoryScope | "all";
     limit?: number;
+    /** v0.2.0 — when true, returns full `Memory` rows (v0.1.x behavior).
+     * When `false` or absent, returns `SlimMemory` rows (default v0.2.0
+     * behavior, per plan §B6.3 / K2-010).
+     */
+    full?: boolean;
+    /** v0.3.0 — when true, includes rows where status = 'superseded'.
+     * Default false (only active rows). */
+    includeSuperseded?: 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
+ * `relevanceScore` for non-FTS callers. */
+export interface SlimMemory {
+    id: string;
+    type: MemoryType;
+    scope: MemoryScope;
+    score: number;
+    snippet: string;
 }
 export interface GetRelevantInput {
     query?: string;
     maxTokens?: number;
     scope?: MemoryScope | "all";
+    /** v0.3.0 — when true, includes rows where status = 'superseded'.
+     * Default false (only active rows). */
+    includeSuperseded?: boolean;
 }
 export declare class MemoryService {
+    private readonly metrics;
+    constructor(store: Store, metrics?: Metrics | null);
     private store;
-    constructor(store: Store);
     save(input: SaveInput): string;
     getById(id: string): Memory | null;
     update(id: string, fields: Partial<Memory>): void;
     delete(id: string): void;
-    query(input: QueryInput): Memory[];
+    /** v0.1.x behavior — returns full `Memory` rows. */
+    query(input: QueryInput & {
+        full: true;
+    }): Memory[];
+    /** v0.2.0 default — returns `SlimMemory` rows. */
+    query(input: QueryInput): SlimMemory[];
+    private isCrossProjectEnabled;
     private loadAll;
     private queryRelevant;
     getRelevant(input: GetRelevantInput): Memory[];
+    /**
+     * v0.3.0 (K3-004) — Promote an error memory to a causal pattern.
+     *
+     * Creates a new `pattern` memory with `origin = 'causal'`, derived
+     * confidence, and evidence count. The original error memory is NOT
+     * deleted — the audit trail is preserved. Returns the new memory id,
+     * or null when the source error is not eligible (missing fingerprint,
+     * wrong type, or already promoted).
+     */
+    promoteToPattern(errorId: string, evidenceCount: number): string | null;
+    /**
+     * v0.2.0 (K2-026) — Feedback loop positive half (plan §B6.10 / D2-10).
+     *
+     * For each reflector-sourced error memory emitted during the given session
+     * whose fingerprint did NOT recur as a failing `tool_call` within the same
+     * project, bump `relevance_score` by `RELEVANCE_BUMP` (capped at
+     * `RELEVANCE_MAX`). Agent-saved memories are NEVER auto-boosted by this
+     * loop (anti-gaming guarantee, D2-06).
+     *
+     * Returns the number of memories that received a positive boost.
+     */
+    boostPositiveReflectors(sessionId: string): number;
+    /**
+     * v0.3.0 (K3-013) — Feedback loop negative half.
+     *
+     * For each reflector-sourced error memory from this session whose
+     * fingerprint DID recur as a failing tool_call (the lesson didn't
+     * prevent the error), decrement `relevance_score` by `RELEVANCE_PENALTY`
+     * (down to zero) and increment `evidence_count` as a negative signal.
+     * Agent-saved memories are NEVER penalized.
+     *
+     * Returns the number of memories penalized.
+     */
+    /**
+     * v0.3.0 fix — Mirror of the free function `countSupersedeCandidates`
+     * exposed as an instance method so `okf-import` (which holds a
+     * `MemoryService` reference but not the underlying `Store`) can count
+     * rows that `save()` will mark as superseded.
+     */
+    countSupersedeCandidates(type: MemoryType, fingerprint: string | null | undefined, projectId: string | null): number;
+    penalizeRecurringReflectors(sessionId: string): number;
 }
+/**
+ * v0.3.0 fix — Count active memories that would be superseded by a new
+ * row with the given (type, fingerprint, projectId) tuple. Used by
+ * `okf-import` to populate `ImportResult.superseded` accurately.
+ *
+ * Matches the supersede logic in `save()`: only `decision` and `rule`
+ * types supersede prior rows with the same fingerprint. Returns 0 for
+ * any other type.
+ */
+export declare function countSupersedeCandidates(store: Store, type: MemoryType, fingerprint: string | null | undefined, projectId: string | null): number;