opencode-usage-coach 0.11.4 → 0.12.1

package/dist/index.js

@@ -1,20 +1,28 @@
 // src/index.ts
-import { mkdirSync as mkdirSync2, writeFileSync as writeFileSync2, appendFileSync as appendFileSync2, readFileSync as readFileSync2, existsSync as existsSync2 } from "fs";
+import { mkdirSync as mkdirSync3, writeFileSync as writeFileSync2, appendFileSync as appendFileSync3, readFileSync as readFileSync2, existsSync as existsSync2 } from "fs";
 import { spawn, spawnSync } from "child_process";
 import { createHash } from "crypto";
-import { homedir } from "os";
-import { join as join2, resolve, dirname } from "path";
+import { homedir as homedir2 } from "os";
+import { join as join3, resolve, dirname as dirname2 } from "path";
 import { tool } from "@opencode-ai/plugin";
 
 // src/domain.ts
 import { mkdirSync, appendFileSync, readFileSync, existsSync, writeFileSync } from "fs";
-import { join } from "path";
+import { join, dirname, basename } from "path";
 var BASE_DIR = "";
+var SHARED_DIR = "";
 function initDomain(stateDir) {
   BASE_DIR = stateDir;
+  if (basename(dirname(stateDir)) === "projects") {
+    SHARED_DIR = join(dirname(dirname(stateDir)), "shared");
+  } else {
+    SHARED_DIR = join(stateDir, "_shared");
+  }
 }
 var nodesFile = () => join(BASE_DIR, "nodes.ndjson");
 var edgesFile = () => join(BASE_DIR, "edges.ndjson");
+var sharedNodesFile = () => join(SHARED_DIR, "nodes.ndjson");
+var sharedEdgesFile = () => join(SHARED_DIR, "edges.ndjson");
 function readNdjson(path) {
   try {
     if (!existsSync(path)) return [];
@@ -24,23 +32,14 @@ function readNdjson(path) {
   }
 }
 function readNodes() {
-  return readNdjson(nodesFile());
+  return [...readNdjson(nodesFile()), ...readNdjson(sharedNodesFile())];
 }
 function readEdges() {
-  return readNdjson(edgesFile());
+  return [...readNdjson(edgesFile()), ...readNdjson(sharedEdgesFile())];
 }
 function uid(prefix) {
   return `${prefix}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
 }
-function addDomainNode(node) {
-  const full = { ...node, id: uid("node"), ts: (/* @__PURE__ */ new Date()).toISOString() };
-  try {
-    mkdirSync(BASE_DIR, { recursive: true });
-    appendFileSync(nodesFile(), JSON.stringify(full) + "\n");
-  } catch {
-  }
-  return full.id;
-}
 function addDomainEdge(edge) {
   const full = { ...edge, ts: (/* @__PURE__ */ new Date()).toISOString() };
   try {
@@ -49,6 +48,9 @@ function addDomainEdge(edge) {
   } catch {
   }
 }
+function readProjectNodes() {
+  return readNdjson(nodesFile());
+}
 function writeNodes(nodes) {
   try {
     mkdirSync(BASE_DIR, { recursive: true });
@@ -72,7 +74,7 @@ function queryDomain(keywords) {
 function touchNodes(ids) {
   if (ids.size === 0) return;
   try {
-    const nodes = readNodes();
+    const nodes = readProjectNodes();
     let changed = false;
     const now = (/* @__PURE__ */ new Date()).toISOString();
     for (const n of nodes) {
@@ -88,7 +90,7 @@ function touchNodes(ids) {
 }
 function evictStale(maxAgeDays = 30, maxNodes = 1e3) {
   try {
-    const nodes = readNodes();
+    const nodes = readProjectNodes();
     if (nodes.length === 0) return { removed: 0, kept: 0 };
     const now = Date.now();
     const ageMs = maxAgeDays * 864e5;
@@ -167,19 +169,70 @@ function queryDomainGraph(keywords, maxDepth = 2, opts = {}) {
 }
 function saveInvestigationResult(keywords, result, source, confidence = 0.7) {
   try {
-    return addDomainNode({
+    const nodeId = uid("node");
+    const full = {
+      id: nodeId,
       type: "fact",
       name: keywords.join(" "),
-      props: { result },
+      props: { result, keywords: [...new Set(keywords)] },
       source: source || "investigation",
-      confidence
-    });
+      confidence,
+      ts: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    try {
+      mkdirSync(SHARED_DIR, { recursive: true });
+      appendFileSync(sharedNodesFile(), JSON.stringify(full) + "\n");
+    } catch {
+    }
+    autoLinkKeywords(nodeId, keywords);
+    return nodeId;
   } catch {
     return "";
   }
 }
+function autoLinkKeywords(nodeId, keywords, minOverlap = 2, maxLinks = 8) {
+  if (keywords.length < minOverlap) return;
+  try {
+    const candidates = queryDomain(keywords);
+    let linked = 0;
+    for (const node of candidates.nodes) {
+      if (node.id === nodeId) continue;
+      const nodeKw = Array.isArray(node.props?.keywords) ? node.props.keywords : (node.name || "").toLowerCase().split(/[^a-z0-9_-]+/).filter((w) => w.length >= 3);
+      const overlap = keywords.filter((k) => nodeKw.includes(k));
+      if (overlap.length >= minOverlap) {
+        const edge = {
+          from: nodeId,
+          to: node.id,
+          rel: "related-to",
+          note: `auto: ${overlap.length} shared (${overlap.slice(0, 5).join(",")})`,
+          ts: (/* @__PURE__ */ new Date()).toISOString()
+        };
+        try {
+          mkdirSync(SHARED_DIR, { recursive: true });
+          appendFileSync(sharedEdgesFile(), JSON.stringify(edge) + "\n");
+        } catch {
+        }
+        linked++;
+        if (linked >= maxLinks) break;
+      }
+    }
+  } catch {
+  }
+}
 
 // src/web-search.ts
+import { appendFileSync as appendFileSync2, mkdirSync as mkdirSync2 } from "fs";
+import { join as join2 } from "path";
+import { homedir } from "os";
+var WS_LOG_FILE = process.env.UC_STATE_DIR ? join2(process.env.UC_STATE_DIR, "web-search.log") : join2(homedir(), ".cache", "opencode-usage-coach", "web-search.log");
+function wsLog(msg) {
+  try {
+    mkdirSync2(join2(WS_LOG_FILE, ".."), { recursive: true });
+    appendFileSync2(WS_LOG_FILE, `${(/* @__PURE__ */ new Date()).toISOString()} ${msg}
+`);
+  } catch {
+  }
+}
 var FRAMEWORK_DOCS = {
   "react": { name: "React", docs: "https://react.dev", githubOrg: "facebook" },
   "solid-js": { name: "Solid.js", docs: "https://solidjs.com", githubOrg: "solidjs" },
@@ -242,7 +295,7 @@ async function ghFetch(url, signal) {
     const errs = ghError?.errors;
     const errMsg = ghError?.message ?? ghErrorText.slice(0, 300);
     const detail = errs ? errs.map((e) => typeof e === "string" ? e : `${e?.field ?? "?"}: ${e?.message ?? e?.code ?? JSON.stringify(e)}`).join("; ") : "";
-    console.error(JSON.stringify({
+    wsLog(JSON.stringify({
       level: "error",
       module: "web-search",
       event: "gh-fetch-error",
@@ -278,7 +331,9 @@ async function tier1OfficialDocs(query, fws, results, docRefs, seen, signal) {
     const entry = FRAMEWORK_DOCS[fw];
     if (!entry?.githubOrg) continue;
     try {
-      const fullQ = `${cleanQuery} org:${entry.githubOrg}`;
+      const orgPart = ` org:${entry.githubOrg}`;
+      const truncated = cleanQuery.slice(0, GH_QUERY_MAX - orgPart.length);
+      const fullQ = `${truncated}${orgPart}`;
       const url = `https://api.github.com/search/issues?q=${encodeURIComponent(fullQ)}&per_page=3`;
       const data = await ghFetch(url, signal);
       for (const item of data.items ?? []) {
@@ -291,7 +346,7 @@ async function tier1OfficialDocs(query, fws, results, docRefs, seen, signal) {
       }
     } catch (e) {
       const m = errMessage(e);
-      console.error(`[web-search] tier1 ${fw}: ${m}`);
+      wsLog(`[web-search] tier1 ${fw}: ${m}`);
       errors.push(`tier1:${fw}:${m.slice(0, 80)}`);
     }
   }
@@ -314,7 +369,7 @@ async function tier2GitHubIssues(query, results, seen, signal) {
     }
   } catch (e) {
     const m = errMessage(e);
-    console.error(`[web-search] tier2: ${m}`);
+    wsLog(`[web-search] tier2: ${m}`);
     errors.push(`tier2:${m.slice(0, 80)}`);
   }
   return errors;
@@ -338,7 +393,7 @@ async function tier3GitHubCode(query, results, seen, signal) {
     }
   } catch (e) {
     const m = errMessage(e);
-    console.error(`[web-search] tier3: ${m}`);
+    wsLog(`[web-search] tier3: ${m}`);
     errors.push(`tier3:${m.slice(0, 80)}`);
   }
   return errors;
@@ -364,7 +419,7 @@ async function searchContext(query, frameworks, keyDeps, timeoutMs) {
     }
   } catch (e) {
     const m = errMessage(e);
-    console.error(`[web-search] unexpected error: ${m}`);
+    wsLog(`[web-search] unexpected error: ${m}`);
     errors.push(`unexpected:${m.slice(0, 80)}`);
   } finally {
     clearTimeout(timer);
@@ -382,49 +437,49 @@ var DEFAULT_MAX_STEPS = Number(process.env.UC_MAX_STEPS ?? 30) || 30;
 var WATCHDOG_POLL_MS = Math.max(1e3, Number(process.env.UC_WATCHDOG_POLL_MS ?? 3e3) || 3e3);
 var WALL_TIMEOUT_MS = Math.max(1, Number(process.env.UC_WALL_TIMEOUT_MIN ?? 30) || 30) * 60 * 1e3;
 var DEFAULT_MAX_QUESTIONS = Math.max(1, Math.round(Number(process.env.UC_MAX_QUESTIONS ?? 7)) || 7);
-var PIPE_LOG = join2(homedir(), ".cache", "opencode-usage-coach", "pipeline.log");
+var PIPE_LOG = join3(homedir2(), ".cache", "opencode-usage-coach", "pipeline.log");
 function pipeLog(msg) {
   try {
-    mkdirSync2(dirname(PIPE_LOG), { recursive: true });
-    appendFileSync2(PIPE_LOG, `[SERVER] ${(/* @__PURE__ */ new Date()).toISOString()} ${msg}
+    mkdirSync3(dirname2(PIPE_LOG), { recursive: true });
+    appendFileSync3(PIPE_LOG, `[SERVER] ${(/* @__PURE__ */ new Date()).toISOString()} ${msg}
 `);
   } catch {
   }
 }
 pipeLog(`MODULE LOADED | node=${process.version} | pid=${process.pid}`);
-var STATE_DIR = join2(homedir(), ".cache", "opencode-usage-coach");
-var STATE_FILE = join2(STATE_DIR, "state.json");
-var LOG_FILE = join2(STATE_DIR, "coach.log");
+var STATE_DIR = join3(homedir2(), ".cache", "opencode-usage-coach");
+var STATE_FILE = join3(STATE_DIR, "state.json");
+var LOG_FILE = join3(STATE_DIR, "coach.log");
 function projectStateDir(dir) {
   const abs = resolve(dir || ".");
   const h = createHash("sha1").update(abs).digest("hex").slice(0, 12);
-  return join2(homedir(), ".cache", "opencode-usage-coach", "projects", h);
+  return join3(homedir2(), ".cache", "opencode-usage-coach", "projects", h);
 }
 function setStateDir(dir) {
   STATE_DIR = process.env.UC_STATE_DIR ?? projectStateDir(dir);
-  STATE_FILE = join2(STATE_DIR, "state.json");
-  LOG_FILE = join2(STATE_DIR, "coach.log");
+  STATE_FILE = join3(STATE_DIR, "state.json");
+  LOG_FILE = join3(STATE_DIR, "coach.log");
 }
 var NOOP_HOOKS = {};
 function log(msg) {
   try {
-    appendFileSync2(LOG_FILE, `${(/* @__PURE__ */ new Date()).toISOString()} ${msg}
+    appendFileSync3(LOG_FILE, `${(/* @__PURE__ */ new Date()).toISOString()} ${msg}
 `);
   } catch {
   }
 }
 function writeState(c) {
   try {
-    mkdirSync2(STATE_DIR, { recursive: true });
+    mkdirSync3(STATE_DIR, { recursive: true });
     writeFileSync2(STATE_FILE, JSON.stringify({ ...c, updatedAt: (/* @__PURE__ */ new Date()).toISOString() }));
   } catch {
   }
 }
 function rulesFile() {
-  return join2(STATE_DIR, "rules.md");
+  return join3(STATE_DIR, "rules.md");
 }
 function failuresFile() {
-  return join2(STATE_DIR, "failures.ndjson");
+  return join3(STATE_DIR, "failures.ndjson");
 }
 function readRules() {
   try {
@@ -436,7 +491,7 @@ function readRules() {
   }
 }
 function implNotesFile() {
-  return join2(STATE_DIR, "impl-notes.md");
+  return join3(STATE_DIR, "impl-notes.md");
 }
 var IMPL_NOTE_INSTRUCTION = `
 ## Implementation Notes (important!)
@@ -483,8 +538,8 @@ ${notes}
 Source: generate task "${shortTask}"
 
 `;
-    mkdirSync2(STATE_DIR, { recursive: true });
-    appendFileSync2(implNotesFile(), entry);
+    mkdirSync3(STATE_DIR, { recursive: true });
+    appendFileSync3(implNotesFile(), entry);
   } catch (e) {
     log(`appendImplNotes err: ${String(e)}`);
   }
@@ -537,15 +592,137 @@ function readImplNotesByGraph(keywords, limit = 5) {
 }
 function extractKeywords(text) {
   try {
-    const STOP = /* @__PURE__ */ new Set(["the", "and", "for", "with", "that", "this", "from", "into", "your", "you", "are", "was", "but", "not", "all", "any", "use", "task", "prompt"]);
+    const STOP = /* @__PURE__ */ new Set([
+      // articles / prepositions / conjunctions
+      "the",
+      "and",
+      "for",
+      "with",
+      "that",
+      "this",
+      "from",
+      "into",
+      "your",
+      "you",
+      "are",
+      "was",
+      "but",
+      "not",
+      "all",
+      "any",
+      "use",
+      "task",
+      "prompt",
+      // generic verbs
+      "apply",
+      "add",
+      "make",
+      "set",
+      "get",
+      "run",
+      "try",
+      "put",
+      "let",
+      "new",
+      "will",
+      "can",
+      "has",
+      "had",
+      "have",
+      "been",
+      "were",
+      "they",
+      "them",
+      "when",
+      "then",
+      "than",
+      "also",
+      "just",
+      "like",
+      "what",
+      "which",
+      "how",
+      "should",
+      "would",
+      "could",
+      "must",
+      "does",
+      "doing",
+      "done",
+      "via",
+      // generic nouns / adjectives
+      "some",
+      "more",
+      "most",
+      "such",
+      "each",
+      "other",
+      "very",
+      "much",
+      "here",
+      "there",
+      "where",
+      "while",
+      "about",
+      "after",
+      "before",
+      "main",
+      "call",
+      "file",
+      "code",
+      "data",
+      "line",
+      "name",
+      "type",
+      "true",
+      "false",
+      "null",
+      "void",
+      "return",
+      "function",
+      "const",
+      "note",
+      "notes",
+      "result",
+      "output",
+      "input",
+      "detail",
+      "reason",
+      "reasons",
+      "improve",
+      "fix",
+      "fixed",
+      "error",
+      "issue",
+      "thing",
+      "things",
+      "stuff",
+      "case",
+      "cases",
+      "way",
+      "ways",
+      "first",
+      "second",
+      "third",
+      "last",
+      "next",
+      "prev",
+      "previous",
+      "following",
+      "above",
+      "below",
+      "since",
+      "until",
+      "without"
+    ]);
     const seen = /* @__PURE__ */ new Set();
     const out = [];
-    for (const raw of (text ?? "").toLowerCase().split(/[^a-z0-9_]+/)) {
+    for (const raw of (text ?? "").toLowerCase().split(/[^a-z0-9_-]+/)) {
       const t = raw.trim();
       if (t.length < 3 || STOP.has(t) || seen.has(t)) continue;
       seen.add(t);
       out.push(t);
-      if (out.length >= 16) break;
+      if (out.length >= 8) break;
     }
     return out;
   } catch {
@@ -553,7 +730,7 @@ function extractKeywords(text) {
   }
 }
 function harnessFile(sessionID) {
-  return join2(STATE_DIR, sessionID || "_default", "harness.json");
+  return join3(STATE_DIR, sessionID || "_default", "harness.json");
 }
 function readHarness(sessionID) {
   try {
@@ -567,7 +744,7 @@ function readHarness(sessionID) {
 function writeHarness(sessionID, h) {
   try {
     const f = harnessFile(sessionID);
-    mkdirSync2(dirname(f), { recursive: true });
+    mkdirSync3(dirname2(f), { recursive: true });
     h.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
     writeFileSync2(f, JSON.stringify(h, null, 2));
   } catch {
@@ -590,7 +767,7 @@ function mutateHarness(sessionID, fn) {
   return next;
 }
 function interviewFile(sessionID) {
-  return join2(STATE_DIR, sessionID || "_default", "interview.json");
+  return join3(STATE_DIR, sessionID || "_default", "interview.json");
 }
 function readInterview(sessionID) {
   try {
@@ -604,7 +781,7 @@ function readInterview(sessionID) {
 function writeInterview(sessionID, s) {
   try {
     const f = interviewFile(sessionID);
-    mkdirSync2(dirname(f), { recursive: true });
+    mkdirSync3(dirname2(f), { recursive: true });
     s.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
     writeFileSync2(f, JSON.stringify(s, null, 2));
   } catch {
@@ -802,7 +979,7 @@ function parseFileList(rawList, baseDir) {
     let testPattern;
     let testFramework;
     for (const mf of manifestFiles) {
-      const full = join2(baseDir, mf);
+      const full = join3(baseDir, mf);
       if (existsSync2(full)) {
         try {
           const content = JSON.parse(readFileSync2(full, "utf8"));
@@ -1132,15 +1309,15 @@ function readHarnessCfg(dir) {
     return {};
   };
   return {
-    ...tryRead(join2(homedir(), ".config", "opencode-usage-coach", "harness.config.json")),
-    ...tryRead(join2(dir, "harness.config.json"))
+    ...tryRead(join3(homedir2(), ".config", "opencode-usage-coach", "harness.config.json")),
+    ...tryRead(join3(dir, "harness.config.json"))
   };
 }
 function writeHarnessCfg(updates) {
-  const configDir = join2(homedir(), ".config", "opencode-usage-coach");
-  const configPath = join2(configDir, "harness.config.json");
+  const configDir = join3(homedir2(), ".config", "opencode-usage-coach");
+  const configPath = join3(configDir, "harness.config.json");
   try {
-    mkdirSync2(configDir, { recursive: true });
+    mkdirSync3(configDir, { recursive: true });
     const existing = (() => {
       try {
         return JSON.parse(readFileSync2(configPath, "utf8"));
@@ -1868,8 +2045,8 @@ Then: harness_done(). Follow the [usage-coach NEXT] directive each tool returns.
           async execute(args, _ctx) {
             const rec = { ts: (/* @__PURE__ */ new Date()).toISOString(), task: args.task, prompt: args.prompt, gradeResult: args.gradeResult, model: args.model, revisions: args.revisions };
             try {
-              mkdirSync2(STATE_DIR, { recursive: true });
-              appendFileSync2(failuresFile(), JSON.stringify(rec) + "\n");
+              mkdirSync3(STATE_DIR, { recursive: true });
+              appendFileSync3(failuresFile(), JSON.stringify(rec) + "\n");
             } catch (e) {
               log(`record_failure err: ${String(e)}`);
             }
@@ -1994,8 +2171,8 @@ Keep it concrete and actionable.`;
             const rule = out;
             try {
               const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-              mkdirSync2(STATE_DIR, { recursive: true });
-              appendFileSync2(rulesFile(), `## Rule (${date})
+              mkdirSync3(STATE_DIR, { recursive: true });
+              appendFileSync3(rulesFile(), `## Rule (${date})
 ${rule}
 Origin: ${args.task}
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-usage-coach",
-  "version": "0.11.4",
+  "version": "0.12.1",
   "description": "opencode closed-loop usage coach — quota SENSE -> coaching DECIDE -> loop ACT + TUI integration",
   "type": "module",
   "main": "./dist/index.js",