@mathew-cf/opencode-memory 0.2.0 → 0.3.0

package/dist/config.d.ts

@@ -11,8 +11,14 @@
  * The snippet appended to subagent prompts. Captured in one place so
  * tests can snapshot it and users can `Edit` it locally if they want a
  * different emphasis.
+ *
+ * Sections beyond "Memory & Sessions" / "Discoveries worth saving" are
+ * generic agent-quality nudges that pair naturally with the memory
+ * protocol — they describe how to deliver an answer once you've done
+ * the search work. They're scoped tight enough not to crowd out the
+ * memory bits but useful enough to ship as opinionated defaults.
  */
-export declare const MEMORY_PROMPT_APPENDIX = "## Memory & Sessions\n\n1. **Before work:** call `memory_search` and `session_search` with your topic. Read results \u2014 don't just glance at summaries.\n2. **When something is unfamiliar mid-task** (tool, API, pattern, build system): search both `memory_search` and `session_search` BEFORE attempting. Use previous sessions to inform your approach \u2014 don't try first, search first.\n3. **When you discover something reusable:** write to ~/opencode-memory/{category}/{filename}.md and `memory_save` immediately. Never defer, never ask.\n\nIf you can't write to memory, end your response with:\n## Discoveries worth saving\n- [list findings that took >1 min to figure out]\n\n## Ground in code\n\nNEVER answer questions about a codebase from training data. Always open the actual files first.";
+export declare const MEMORY_PROMPT_APPENDIX = "## Memory & Sessions\n\n1. **Before work:** call `memory_search` and `session_search` with your topic. Read results \u2014 don't just glance at summaries.\n2. **When something is unfamiliar mid-task** (tool, API, pattern, build system): search both `memory_search` and `session_search` BEFORE attempting. Use previous sessions to inform your approach \u2014 don't try first, search first.\n3. **When you discover something reusable:** write to ~/opencode-memory/{category}/{filename}.md and `memory_save` immediately. Never defer, never ask.\n\nIf you can't write to memory, end your response with:\n## Discoveries worth saving\n- [list findings that took >1 min to figure out]\n\n## Ground in code\n\nNEVER answer questions about a codebase from training data. Always open the actual files first.\n\n## Synthesis\n\nEnd with: a clear conclusion (recommendation, diagnosis, or finding), your confidence level, any conflicts or open questions, and concrete next steps where applicable.\n\n## Source age\n\nFlag anything > 1 year old as potentially stale.";
 /**
  * Subagents that should get the memory prompt appendix. These are the
  * built-in subagent names used by OpenCode — custom agents are left alone.

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,kyBAY6D,CAAC;AAEjG;;;GAGG;AACH,eAAO,MAAM,aAAa,uEAMhB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAOtD,CAAC;AAEF,UAAU,UAAU;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC/C,UAAU,CAAC,EAAE;QACX,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;QACxC,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;KACvD,CAAC;CACH;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAClD,IAAI,CA6DN"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,kiCAoBc,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,aAAa,uEAMhB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAOtD,CAAC;AAEF,UAAU,UAAU;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC/C,UAAU,CAAC,EAAE;QACX,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;QACxC,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;KACvD,CAAC;CACH;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAClD,IAAI,CA6DN"}

package/dist/index.js

@@ -1,3 +1,4 @@
+import { createRequire } from "node:module";
 var __defProp = Object.defineProperty;
 var __returnValue = (v) => v;
 function __exportSetter(name, newValue) {
@@ -12,6 +13,7 @@ var __export = (target, all) => {
       set: __exportSetter.bind(all, name)
     });
 };
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // src/index.ts
 import { dirname, resolve } from "node:path";
@@ -76,7 +78,15 @@ If you can't write to memory, end your response with:
 
 ## Ground in code
 
-NEVER answer questions about a codebase from training data. Always open the actual files first.`;
+NEVER answer questions about a codebase from training data. Always open the actual files first.
+
+## Synthesis
+
+End with: a clear conclusion (recommendation, diagnosis, or finding), your confidence level, any conflicts or open questions, and concrete next steps where applicable.
+
+## Source age
+
+Flag anything > 1 year old as potentially stale.`;
 var TARGET_AGENTS = [
   "general",
   "explore",
@@ -12632,8 +12642,8 @@ function todayISO() {
 }
 
 // src/lib/rag.ts
-import { createRequire } from "node:module";
-var require2 = createRequire(import.meta.url);
+import { createRequire as createRequire2 } from "node:module";
+var require2 = createRequire2(import.meta.url);
 function resolveRagBinary() {
   try {
     return require2.resolve("@mathew-cf/rag-cli/bin/rag.js");
@@ -12683,10 +12693,21 @@ function spawnRagIndex(args) {
   });
   return true;
 }
+async function downloadModel() {
+  const shim = resolveRagBinary();
+  if (!shim)
+    return installGuidance();
+  try {
+    const out = await Bun.$`${shim} download`.text();
+    return out.trim() || "Model downloaded.";
+  } catch (err) {
+    return `rag download failed: ${String(err)}`;
+  }
+}
 
 // src/lib/ripgrep.ts
-import { createRequire as createRequire2 } from "node:module";
-var require3 = createRequire2(import.meta.url);
+import { createRequire as createRequire3 } from "node:module";
+var require3 = createRequire3(import.meta.url);
 function resolveRgBinary() {
   try {
     const mod = require3("@vscode/ripgrep");
@@ -13504,7 +13525,7 @@ ${r.text}`).join(`
 }
 
 // src/index.ts
-var __dirname = "/Users/mat/repos/github.com/mathew-cf/opencode-memory/src";
+var __dirname = "/home/runner/work/opencode-memory/opencode-memory/src";
 function resolveSkillsDir() {
   try {
     const here = typeof import.meta !== "undefined" && import.meta.url ? dirname(fileURLToPath(import.meta.url)) : typeof __dirname !== "undefined" ? __dirname : undefined;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mathew-cf/opencode-memory",
-  "version": "0.2.0",
-  "description": "Persistent cross-session memory for OpenCode \u2014 a hybrid keyword + semantic search layer over a local markdown knowledge base, plus session history tools and guardrails that nudge agents to use them.",
+  "version": "0.3.0",
+  "description": "Persistent cross-session memory for OpenCode — a hybrid keyword + semantic search layer over a local markdown knowledge base, plus session history tools and guardrails that nudge agents to use them.",
   "author": "mat",
   "license": "Apache-2.0",
   "repository": {
@@ -11,12 +11,15 @@
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "bin": {
+    "opencode-memory": "dist/cli.js"
+  },
   "files": [
     "dist",
     "skills"
   ],
   "scripts": {
-    "build": "bun build src/index.ts --outdir dist --target node && tsc --emitDeclarationOnly",
+    "build": "bun build src/index.ts src/cli.ts --outdir dist --target node && tsc --emitDeclarationOnly",
     "test": "bun test",
     "prepublishOnly": "bun run build",
     "typecheck": "tsc --noEmit",

package/skills/opencode-memory/SKILL.md

@@ -285,11 +285,18 @@ Both search backends ship as npm dependencies with prebuilt binaries:
 
 No manual install is needed — `npm install` (or whatever installs this plugin) pulls in both and resolves them via `require.resolve` at runtime. Nothing depends on `$PATH`.
 
-After install, run once to pre-cache the embedding model (optional but makes the first semantic search instant):
+### One-shot bootstrap
+
+The plugin ships a CLI that does everything in one step:
 
 ```bash
-memory_setup   # reports which backends are resolvable
-rag download   # downloads the MiniLM-L6 weights (~90MB)
+bunx @mathew-cf/opencode-memory init
 ```
 
-If a backend fails to install (unsupported platform, etc.), the tools degrade gracefully — `memory_search` still returns whatever the available backend can find. Call `memory_setup` any time to see install guidance for the missing piece.
+This creates the memory dir if missing, runs `git init`, scaffolds the category subdirs, and downloads the embedding model. Idempotent — safe to re-run.
+
+Other CLI subcommands:
+- `bunx @mathew-cf/opencode-memory status` — report backend resolution (same as `memory_setup` tool)
+- `bunx @mathew-cf/opencode-memory init --skip-model` — bootstrap dirs only, defer the download
+
+If a backend fails to install (unsupported platform, etc.), the tools degrade gracefully — `memory_search` still returns whatever the available backend can find.