@shodocan/opencode-hindsight 1.0.0 → 1.0.1

package/README.md

@@ -540,6 +540,30 @@ This is useful when you want to:
 - **Organize memories using your own naming scheme**
 - **Integrate with existing Hindsight banks** from other tools
 
+### Bank Names from Environment Variables
+
+Bank fields can reference environment variables when the entire configured value is a variable reference. Supported forms are `$VAR` and `${VAR}`, where variable names use shell-style identifiers matching `[A-Za-z_][A-Za-z0-9_]*`:
+
+```jsonc
+{
+  "userBank": "$OPENCODE_USER_BANK",
+  "projectBank": "$OPENCODE_PROJECT_BANK",
+  "agentProjectBanks": {
+    "review-*": "$OPENCODE_REVIEW_BANK"
+  },
+  "runtimeProjectBanks": {
+    "reviews": "${OPENCODE_REVIEW_BANK}"
+  }
+}
+```
+
+Rules:
+
+- Only full-value references are expanded; unsupported or partial env-reference syntax remains literal. `"proj-$OPENCODE_REVIEW_BANK"` remains literal.
+- Missing or empty environment variables are treated as unset.
+- For `agentProjectBanks` and `runtimeProjectBanks`, entries with missing or empty env refs are dropped.
+- Expansion happens when the plugin loads configuration, so restart OpenCode after changing these variables.
+
 ### Agent-Aware Project Bank Routing
 
 Subagents can use different project banks without changing OpenCode core. Configure `agentProjectBanks` with exact names or `*` glob patterns:

package/dist/config.d.ts

@@ -1,9 +1,16 @@
+/**
+ * Sanitize one configured bank value. Full-value environment references of
+ * the form `$VAR` and `${VAR}` are expanded from the plugin process env.
+ * Partial interpolation is intentionally unsupported and remains literal.
+ */
+export declare function sanitizeBankValue(value: unknown, env?: Record<string, string | undefined>): string | undefined;
 /**
  * Sanitize a bank-name map from config: reject arrays, drop entries with
- * non-string keys/values, and strip leading/trailing whitespace. Returns an
- * empty object when absent or not a plain object.
+ * non-string keys/values, strip leading/trailing whitespace, and expand
+ * full-value env refs in values. Returns an empty object when absent or not a
+ * plain object.
  */
-export declare function sanitizeBankMap(map: Record<string, string> | undefined): Record<string, string>;
+export declare function sanitizeBankMap(map: unknown, env?: Record<string, string | undefined>): Record<string, string>;
 export declare const CONFIG: {
     baseUrl: string;
     similarityThreshold: number;

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AA6GA;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAS/F;AAED,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;CAmBlB,CAAC;AAEF,wBAAgB,YAAY,IAAI,OAAO,CAEtC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AA+GA;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,MAAM,GAAG,SAAS,CAYpB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,OAAO,EACZ,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAWxB;AAED,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;CAmBlB,CAAC;AAEF,wBAAgB,YAAY,IAAI,OAAO,CAEtC"}

package/dist/index.js

@@ -14049,6 +14049,7 @@ function loadConfig() {
   return {};
 }
 var fileConfig = loadConfig();
+var ENV_REF_RE = /^\$(?:([A-Za-z_][A-Za-z0-9_]*)|\{([A-Za-z_][A-Za-z0-9_]*)\})$/;
 function getBaseUrl() {
   if (process.env.HINDSIGHT_BASE_URL)
     return process.env.HINDSIGHT_BASE_URL;
@@ -14056,13 +14057,30 @@ function getBaseUrl() {
     return fileConfig.baseUrl;
   return "http://localhost:8888";
 }
-function sanitizeBankMap(map2) {
+function sanitizeBankValue(value, env = process.env) {
+  if (typeof value !== "string")
+    return;
+  const trimmed = value.trim();
+  if (!trimmed)
+    return;
+  const match = trimmed.match(ENV_REF_RE);
+  if (!match)
+    return trimmed;
+  const envName = match[1] ?? match[2];
+  if (!envName)
+    return;
+  const envValue = env[envName]?.trim();
+  return envValue || undefined;
+}
+function sanitizeBankMap(map2, env = process.env) {
   if (!map2 || typeof map2 !== "object" || Array.isArray(map2))
     return {};
   const out = {};
   for (const [key, value] of Object.entries(map2)) {
-    if (typeof key === "string" && typeof value === "string" && key.trim() && value.trim()) {
-      out[key.trim()] = value.trim();
+    const cleanKey = key.trim();
+    const cleanValue = sanitizeBankValue(value, env);
+    if (cleanKey && cleanValue) {
+      out[cleanKey] = cleanValue;
     }
   }
   return out;
@@ -14075,8 +14093,8 @@ var CONFIG = {
   maxProfileItems: fileConfig.maxProfileItems ?? DEFAULTS.maxProfileItems,
   injectProfile: fileConfig.injectProfile ?? DEFAULTS.injectProfile,
   bankPrefix: fileConfig.bankPrefix ?? DEFAULTS.bankPrefix,
-  userBank: fileConfig.userBank,
-  projectBank: fileConfig.projectBank,
+  userBank: sanitizeBankValue(fileConfig.userBank),
+  projectBank: sanitizeBankValue(fileConfig.projectBank),
   maxTokens: fileConfig.maxTokens ?? DEFAULTS.maxTokens,
   budget: fileConfig.budget ?? DEFAULTS.budget,
   keywordPatterns: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shodocan/opencode-hindsight",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "OpenCode plugin that gives coding agents persistent memory using Hindsight",
   "type": "module",
   "main": "dist/index.js",