opencode-lore 0.1.2 → 0.1.4

package/README.md

@@ -94,6 +94,17 @@ To use a local clone instead of the published package:
 }
 ```
 
+## What to expect
+
+Once Lore is active, you should notice several changes:
+
+- **Higher cache reuse** — Lore keeps your context stable across turns, so the provider cache hits more often. You'll see higher cache read rates and lower costs.
+- **No more compactions** — Lore disables the built-in compaction system and replaces it with incremental distillation. Your context never gets wiped and rebuilt from a lossy summary.
+- **Steady context usage around 70–80%** — the gradient context manager dynamically balances distilled history, raw messages, and knowledge to keep you in the sweet spot — enough room for the model to work, but no wasted context.
+- **Agent doesn't degrade in long sessions** — instead of getting progressively dumber as compaction loses details, the agent stays sharp because distillation preserves the operational facts that matter.
+- **Better recall across and within sessions** — the agent remembers specific details from earlier in the conversation and from previous sessions, including file paths, decisions, error messages, and why things were done a certain way.
+- **Automatic `AGENTS.md` export** — Lore periodically exports curated knowledge to an `AGENTS.md` file in your repo. This is the [universal format](https://agenticaistandard.org/) read by 16+ AI coding tools (Codex, Jules, Cursor, Copilot, Windsurf, and more), so the knowledge benefits every tool — not just OpenCode.
+
 ## What gets stored
 
 All data lives locally in `~/.local/share/opencode-lore/lore.db`:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-lore",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "type": "module",
   "license": "MIT",
   "description": "Three-tier memory architecture for OpenCode — distillation, not summarization",

package/src/db.ts

@@ -196,3 +196,14 @@ export function projectId(path: string): string | undefined {
     .get(path) as { id: string } | null;
   return row?.id;
 }
+
+/**
+ * Returns true if Lore has never been used before (no projects in the DB).
+ * Must be called before ensureProject() to get an accurate result.
+ */
+export function isFirstRun(): boolean {
+  const row = db()
+    .query("SELECT COUNT(*) as count FROM projects")
+    .get() as { count: number };
+  return row.count === 0;
+}

package/src/index.ts

@@ -1,6 +1,6 @@
 import type { Plugin } from "@opencode-ai/plugin";
 import { load, config } from "./config";
-import { ensureProject } from "./db";
+import { ensureProject, isFirstRun } from "./db";
 import * as temporal from "./temporal";
 import * as ltm from "./ltm";
 import * as distillation from "./distillation";
@@ -20,8 +20,19 @@ import { createRecallTool } from "./reflect";
 export const LorePlugin: Plugin = async (ctx) => {
   const projectPath = ctx.worktree || ctx.directory;
   await load(ctx.directory);
+  let firstRun = isFirstRun();
   ensureProject(projectPath);
 
+  if (firstRun) {
+    ctx.client.tui.showToast({
+      body: {
+        message: "Lore is active — your agent will get smarter every session",
+        variant: "success",
+        duration: 5000,
+      },
+    }).catch(() => {});
+  }
+
   // Prune any corrupted/oversized knowledge entries left by the AGENTS.md
   // backslash-escaping bug or curator hallucinations. Sets confidence → 0
   // (below the 0.2 query threshold) so they stop polluting the context.
@@ -209,6 +220,18 @@ export const LorePlugin: Plugin = async (ctx) => {
 
     // Inject LTM knowledge into system prompt — relevance-ranked and budget-capped.
     "experimental.chat.system.transform": async (input, output) => {
+      // One-time first-run note so the agent acknowledges Lore is active.
+      // Cleared after first injection to avoid repeating on subsequent turns.
+      if (firstRun) {
+        output.system.push(
+          "[Lore plugin] This is the first time Lore has been activated. " +
+          "Briefly let the user know that Lore is now active and their " +
+          "coding agent will get progressively smarter on this codebase " +
+          "over time as knowledge accumulates across sessions.",
+        );
+        firstRun = false;
+      }
+
       if (input.model?.limit) {
         setModelLimits(input.model.limit);
       }
@@ -289,23 +312,28 @@ export const LorePlugin: Plugin = async (ctx) => {
           rawBudget: result.rawBudget,
           updatedAt: Date.now(),
         };
-        const url = new URL(
-          `/session/${sessionID}/message/${lastUserMsg.info.id}/part/${statsPart.id}`,
-          ctx.serverUrl,
-        );
-        const updatedPart = {
-          ...(statsPart as Record<string, unknown>),
-          metadata: {
-            ...((statsPart as { metadata?: Record<string, unknown> }).metadata ?? {}),
-            lore: loreMeta,
+        // Use the SDK's internal HTTP client so the request goes through
+        // the same base URL, custom fetch, and interceptors that OpenCode
+        // configured — no dependency on ctx.serverUrl being reachable.
+        const httpClient = (ctx.client as any)._client;
+        httpClient.patch({
+          url: "/session/{sessionID}/message/{messageID}/part/{partID}",
+          path: {
+            sessionID,
+            messageID: lastUserMsg.info.id,
+            partID: statsPart.id,
+          },
+          body: {
+            ...(statsPart as Record<string, unknown>),
+            metadata: {
+              ...((statsPart as { metadata?: Record<string, unknown> }).metadata ?? {}),
+              lore: loreMeta,
+            },
           },
-        };
-        fetch(url, {
-          method: "PATCH",
           headers: { "Content-Type": "application/json" },
-          body: JSON.stringify(updatedPart),
-        }).catch((e: unknown) => {
-          console.error("[lore] failed to write gradient stats to part metadata:", e);
+        }).catch(() => {
+          // Non-critical: gradient stats metadata is for UI display only.
+          // Server may not be reachable (e.g. TUI-only mode). Silently ignore.
         });
       }
     },