@dzhi/ocpg 0.6.2 → 0.8.0

package/README.md

@@ -12,41 +12,33 @@ In `opencode.json`:
 ```json
 {
   "plugin": [
-    ["@dzhi/ocpg", {}]
+    "@dzhi/ocpg"
   ]
 }
 ```
 
 ## Connecting to the database
 
-Pass connection params as the plugin options tuple (all optional):
+Need a Postgres instance? The [`deploy/`](./deploy) directory ships a hardened Docker Compose setup (localhost-only, `memories` schema auto-created on first boot) — see [`deploy/README.md`](./deploy/README.md).
 
-```json
-{
-  "plugin": [
-    [
-      "@dzhi/ocpg",
-      {
-        "host": "localhost",
-        "port": 5432,
-        "user": "pguser",
-        "database": "agent-memory"
-      }
-    ]
-  ]
-}
-```
+Configure the connection via environment variables, e.g. in `~/.zshenv`. Any Postgres user and database name will do — use whatever names fit your setup and mirror them here:
 
-Precedence: plugin options > env vars > defaults.
+```bash
+export OCPG_HOST="localhost"
+export OCPG_PORT="5432"
+export OCPG_USER="ocpguser"
+export OCPG_PASSWORD="your-postgres-password"
+export OCPG_DB="ocpg"
+```
 
-| Param      | Env var (fallback) | Default        |
-| ---------- | ------------------ | -------------- |
-| `host`     | `OCPG_HOST`        | `localhost`    |
-| `port`     | `OCPG_PORT`        | `5432`         |
-| `user`     | `OCPG_USER`        | `pguser`       |
-| `database` | `OCPG_DB`          | `agent-memory` |
+| Env var         | Default      |
+| --------------- | ------------ |
+| `OCPG_HOST`     | `localhost`  |
+| `OCPG_PORT`     | `5432`       |
+| `OCPG_USER`     | `ocpguser`   |
+| `OCPG_DB`       | `ocpg`       |
 
-**Password is never set via params** — it resolves from `OCPG_PASSWORD`.
+**Password is env-only.** The plugin never reads config files, options, or external secret managers — set `OCPG_PASSWORD` in your shell environment (e.g. via direnv/.envrc, however you source your secrets).
 
 ## Tools
 

package/ocpg.ts

@@ -2,29 +2,24 @@
 import { SQL } from "bun";
 import { Plugin } from "@opencode/plugin";
 
-// --- DB config: plugin options > env > defaults. Password is deliberately env-only (never in config).
-type DbOptions = {
-  host?: string;
-  port?: number;
-  user?: string;
-  database?: string;
+// --- DB config: env > defaults. Plugin options are not read; password is deliberately env-only (never in config).
+type DbConfig = {
+  host: string;
+  port: number;
+  user: string;
+  database: string;
 };
-type DbConfig = Required<DbOptions>;
 type RecallArgs = { query?: string; global?: boolean; limit?: number };
 type RememberArgs = { content: string; tags?: string[] };
 
-// Defaults resolved ONCE at module init — the pass lookup here is the only permitted spawn in this file.
+// Defaults resolved ONCE at module init — env-only, no process spawning.
 const defaultConfig: DbConfig = {
   host: process.env.OCPG_HOST || "localhost",
   port: Number(process.env.OCPG_PORT) || 5432,
-  user: process.env.OCPG_USER || "pguser",
-  database: process.env.OCPG_DB || "agent-memory",
+  user: process.env.OCPG_USER || "ocpguser",
+  database: process.env.OCPG_DB || "ocpg",
 };
-const password =
-  process.env.OCPG_PASSWORD ||
-  Bun.spawnSync(["pass", "show", "postgres-workstation-password"])
-    .stdout.toString()
-    .trim();
+const password = process.env.OCPG_PASSWORD || "";
 
 // Options-object constructor, not a URL string: Bun's SQL parses string URLs via
 // url.parse(), which emits the DEP0169 DeprecationWarning at plugin load under opencode.
@@ -41,14 +36,6 @@ function makeSql(cfg: DbConfig): SQL {
 
 let sql = makeSql(defaultConfig);
 
-// Swap the pool when the plugin loads with config options ({ "package": "@dzhi/ocpg", "options": {...} } in opencode.jsonc).
-// No-op without options so the module-level env/default config stands. Pools are lazy — a never-connected pool closes cleanly.
-function reconfigure(options?: DbOptions): void {
-  if (!options) return;
-  void sql.close().catch(() => {});
-  sql = makeSql({ ...defaultConfig, ...options });
-}
-
 export interface MemoryRow {
   id: number;
   content: string;
@@ -150,12 +137,6 @@ async function dispose(): Promise<void> {
 
 // --- Agent tools: recall + remember with dedup-on-write ---
 
-function normalizeTags(tags: string[] | undefined, projectDir: string): string[] {
-  const input = tags ?? [];
-  const base = projectDir.split('/').pop() ?? projectDir;
-  return [...input, `project:${base}`];
-}
-
 async function recall(
   args: RecallArgs,
   ctx: { directory: string },
@@ -207,7 +188,8 @@ async function remember(
       return 'ERROR: content must be at least 10 characters.';
     }
 
-    const normalizedTags = normalizeTags(args.tags, ctx.directory);
+    // Tags are stored verbatim — project scoping lives in the project column, not tags.
+    const tags = args.tags ?? [];
     const basename = ctx.directory.split('/').pop() ?? ctx.directory;
 
     // Dedup: project-scoped, common-opening-words AND-match via FTS
@@ -233,7 +215,7 @@ async function remember(
     // the element type hint is required for clean array storage.
     const inserted = await sql`
       INSERT INTO memories (content, tags, session_id, project)
-      VALUES (${args.content}, ${sql.array(normalizedTags, "text")}, ${ctx.sessionID}, ${ctx.directory})
+      VALUES (${args.content}, ${sql.array(tags, "text")}, ${ctx.sessionID}, ${ctx.directory})
       RETURNING id
     ` as { id: number }[];
 
@@ -256,7 +238,6 @@ function invalidateInjection(sessionID: string): void {
 const ocpg = Plugin.define({
   id: "ocpg",
   async setup(ctx) {
-    reconfigure(ctx.options as DbOptions | undefined);
     const directory = ctx.location.directory;
 
     // Inject project memories into every model request's system context.
@@ -320,11 +301,9 @@ const __internals = {
   get sql() {
     return sql;
   },
-  reconfigure,
   truncateMemory,
   formatBlock,
   handleTransform,
-  normalizeTags,
   recall,
   remember,
   invalidateInjection,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dzhi/ocpg",
-  "version": "0.6.2",
+  "version": "0.8.0",
   "type": "module",
   "description": "Postgres-backed persistent memory plugin for OpenCode",
   "main": "ocpg.ts",