opencode-usage-coach 0.3.4 → 0.4.0

package/README.md

@@ -28,6 +28,16 @@ the loop** — and ships a harness agent mode.
   explicitly ask "run this through the harness" or "use the harness for this". The harness
   tools are only available when the harness agent mode is active (see Install).
 
+**Learning from failures (learning loop):**
+- When `grade` returns FAIL, the harness enters a learning cycle: `record_failure` → `investigate` (root-cause analysis) → `verify_diagnosis` → `generalize` (extract a reusable rule).
+- Rules accumulate in `rules.md` → the next `generate` call automatically includes them → the harness avoids repeating the same mistake.
+- Tools: `record_failure`, `investigate`, `verify_diagnosis`, `generalize`.
+
+**Domain knowledge base:**
+- `investigate` and `generate` query a local domain DB before running — known facts are injected into the prompt ("Known facts from domain DB: ...").
+- Unknown domains are investigated (webfetch/docs) and stored as graph nodes/edges → accumulates over time → evidence-based judgments instead of speculation.
+- Storage: `nodes.ndjson` + `edges.ndjson` under the project state dir.
+
 ## Requirements
 - opencode (tested on 1.17.13) with a quota-metered provider configured.
 - `codexbar` CLI with your provider key wired (e.g. `codexbar config set-api-key --provider zai --stdin`).
@@ -142,6 +152,36 @@ Place in the **work directory**. Each role runs on its model, so per-model quota
 | `UC_PROVIDER` | (config `provider`) | codexbar provider for the guardian |
 | `UC_TTL_MS` | 60000 | quota cache TTL (ms) |
 | `UC_DEBUG` | 0 | set to `1` for a diagnostic log at `~/.cache/opencode-usage-coach/coach.log` |
+| `UC_HARNESS_AGENT` | `Usage-Coach-Harness` | comma-separated agent modes allowed to use harness tools + receive quota coaching (case-insensitive; must match the agent id, e.g. `usage-coach-harness` from `agents/usage-coach-harness.md`) |
+
+## Agent-mode scoping
+
+Harness tools (`generate`, `grade`, `harness_start`, …) and quota coaching are **scoped to
+the `usage-coach-harness` agent mode**. Other modes (build, general, your custom agents) stay
+completely clean — no harness tools in their tool list, no quota coaching injected into their
+system prompt.
+
+This is enforced on two independent layers (defense in depth):
+
+1. **Agent definition** (`agents/usage-coach-harness.md`) — its `permission` allowlist names the
+   harness tools, so they only appear in this mode. Other agents' permission lists don't name
+   them, so they're hidden from those modes automatically (this is the standard opencode
+   mechanism — tool visibility is the agent definition's responsibility).
+2. **Plugin runtime gate** (`tool.execute.before`) — even if a harness tool were somehow
+   invoked, the plugin resolves the current session's agent (`client.session.get` → `info.agent`,
+   60s-cached) and throws unless it matches `UC_HARNESS_AGENT` (default `Usage-Coach-Harness`,
+   case-insensitive). The quota system-prompt injection is gated the same way.
+
+**To use the harness tools**, switch to the `usage-coach-harness` agent mode.
+
+**To allow additional modes**, set `UC_HARNESS_AGENT` to a comma-separated list:
+```bash
+export UC_HARNESS_AGENT="usage-coach-harness,my-other-harness"
+```
+
+> Why not the v2 plugin API? v2 has no `tool` registration domain, so a plugin that provides
+> custom tools (like this one) cannot be fully rewritten in v2. Agent `permission` allowlists +
+> the v1 runtime gate is the structurally correct way to scope tool visibility.
 
 ## Architecture
 - **Server module** (`src/index.ts`) — SENSE/DECIDE/ACT + custom harness tools. Loaded via `opencode.json`.
@@ -203,9 +243,25 @@ Recurring issues and fixes — mostly learned the hard way during development.
 - Harness completion sets `active:false` → hidden from the TUI.
 - Override the state path with `UC_STATE_DIR` (forces global state).
 
+**Key gotcha — opencode TUI `ctx` does NOT carry `session_id`.**
+The slot context passed to `panel(ctx)` contains only `{ theme }`. There is no `session_id`/`sessionID` field. The current session ID lives in **`api.route.current.params.sessionID`** instead — the panel reads it from there. If you ever see harnesses from other sessions leaking in, the cause is almost certainly that `sid` resolved to empty (→ fallback broad scan).
+
+**Debugging session isolation** (if it breaks again):
+1. Check `~/.cache/opencode-usage-coach/projects/<hash>/tui-debug.log` — is `panel` being called? What `routeSid` value?
+2. `api.route.current.params.sessionID` — populated? (Empty → panel falls back to scanning all sessions.)
+3. New TUI code loaded? `tui-loaded.txt` (MARKER) should show `loaded-v2 ...`. If it still says `loaded`, the new dist isn't being picked up.
+4. `appendFileSync` imported in `src/tui.tsx`? If missing, **all TUI debug logging silently fails** (ReferenceError swallowed by try/catch) — this wasted a lot of debugging time once.
+
+**Past issue (fixed v0.3.4):** panel read `ctx.session_id` which was always `undefined` → fallback scanned every session → another session's active harness leaked in. Fixed by reading `api.route.current.params.sessionID`.
+
 ## Status
-- ✅ Quota guardian + TUI panel (per-provider coach view, colors, collapsible Alt+H)
-- ✅ Harness: agent mode (triage) with generate/grade model-specific tools (1 terminal, multi-model)
+- ✅ Quota guardian + TUI panel (per-provider coach view, 5h/1w gauges, collapsible Alt+H)
+- ✅ Harness: agent mode with generate/grade tools (multi-model, 1 terminal)
+- ✅ Deterministic loop via NEXT directives (parallel PATH A / sequential PATH B)
+- ✅ Quota-aware tools (GO/THROTTLE/STOP drive model selection + concurrency)
+- ✅ Learning loop (record_failure → investigate → verify_diagnosis → generalize → rules.md)
+- ✅ Domain knowledge base (graph store, investigate/generate injection)
+- ✅ Session isolation (api.route, per-session harness state)
 - ✅ npm packaging (`opencode plugin install opencode-usage-coach`)
 
 License: MIT.

package/agents/usage-coach-harness.md

@@ -12,7 +12,12 @@ permission:
   grep: allow
   task: allow
   generate: allow
+  generate_batch: allow
   grade: allow
+  investigate: allow
+  verify_diagnosis: allow
+  generalize: allow
+  record_failure: allow
   harness_start: allow
   task_update: allow
   harness_done: allow

package/dist/index.js

@@ -1,66 +1,142 @@
 // src/index.ts
-import { mkdirSync, writeFileSync, appendFileSync, readFileSync, existsSync } from "fs";
+import { mkdirSync as mkdirSync2, writeFileSync, appendFileSync as appendFileSync2, readFileSync as readFileSync2, existsSync as existsSync2 } from "fs";
 import { spawn } from "child_process";
 import { createHash } from "crypto";
 import { homedir } from "os";
-import { join, resolve, dirname } from "path";
+import { join as join2, resolve, dirname } from "path";
 import { tool } from "@opencode-ai/plugin";
+
+// src/domain.ts
+import { mkdirSync, appendFileSync, readFileSync, existsSync } from "fs";
+import { join } from "path";
+var BASE_DIR = "";
+function initDomain(stateDir) {
+  BASE_DIR = stateDir;
+}
+var nodesFile = () => join(BASE_DIR, "nodes.ndjson");
+var edgesFile = () => join(BASE_DIR, "edges.ndjson");
+function readNdjson(path) {
+  try {
+    if (!existsSync(path)) return [];
+    return readFileSync(path, "utf8").split("\n").filter(Boolean).map((l) => JSON.parse(l));
+  } catch {
+    return [];
+  }
+}
+function readNodes() {
+  return readNdjson(nodesFile());
+}
+function readEdges() {
+  return readNdjson(edgesFile());
+}
+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 queryDomain(keywords) {
+  const lc = keywords.map((k) => k.toLowerCase());
+  const nodes = readNodes();
+  const matched = nodes.filter((n) => {
+    const hay = (n.name + " " + JSON.stringify(n.props)).toLowerCase();
+    return lc.some((k) => k && hay.includes(k));
+  });
+  const ids = new Set(matched.map((n) => n.id));
+  const edges = readEdges().filter((e) => ids.has(e.from) || ids.has(e.to));
+  return { nodes: matched, edges };
+}
+function saveInvestigationResult(keywords, result, source) {
+  try {
+    return addDomainNode({
+      type: "fact",
+      name: keywords.join(" "),
+      props: { result },
+      source: source || "investigation",
+      confidence: 0.7
+    });
+  } catch {
+    return "";
+  }
+}
+
+// src/index.ts
 var PLUGIN_NAME = "opencode-usage-coach";
-var DEBUG = process.env.UC_DEBUG === "1";
 var TTL_MS = Number(process.env.UC_TTL_MS ?? 6e4);
-var STATE_DIR = join(homedir(), ".cache", "opencode-usage-coach");
-var STATE_FILE = join(STATE_DIR, "state.json");
-var HARNESS_FILE = join(STATE_DIR, "harness.json");
-var LOG_FILE = join(STATE_DIR, "coach.log");
+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");
 function projectStateDir(dir) {
   const abs = resolve(dir || ".");
   const h = createHash("sha1").update(abs).digest("hex").slice(0, 12);
-  return join(homedir(), ".cache", "opencode-usage-coach", "projects", h);
+  return join2(homedir(), ".cache", "opencode-usage-coach", "projects", h);
 }
 function setStateDir(dir) {
   STATE_DIR = process.env.UC_STATE_DIR ?? projectStateDir(dir);
-  STATE_FILE = join(STATE_DIR, "state.json");
-  HARNESS_FILE = join(STATE_DIR, "harness.json");
-  LOG_FILE = join(STATE_DIR, "coach.log");
+  STATE_FILE = join2(STATE_DIR, "state.json");
+  LOG_FILE = join2(STATE_DIR, "coach.log");
 }
 var NOOP_HOOKS = {};
 function log(msg) {
   try {
-    appendFileSync(LOG_FILE, `${(/* @__PURE__ */ new Date()).toISOString()} ${msg}
+    appendFileSync2(LOG_FILE, `${(/* @__PURE__ */ new Date()).toISOString()} ${msg}
 `);
   } catch {
   }
 }
 function writeState(c) {
   try {
-    mkdirSync(STATE_DIR, { recursive: true });
+    mkdirSync2(STATE_DIR, { recursive: true });
     writeFileSync(STATE_FILE, JSON.stringify({ ...c, updatedAt: (/* @__PURE__ */ new Date()).toISOString() }));
   } catch {
   }
 }
 function rulesFile() {
-  return join(STATE_DIR, "rules.md");
+  return join2(STATE_DIR, "rules.md");
 }
 function failuresFile() {
-  return join(STATE_DIR, "failures.ndjson");
+  return join2(STATE_DIR, "failures.ndjson");
 }
 function readRules() {
   try {
     const f = rulesFile();
-    if (!existsSync(f)) return "";
-    return readFileSync(f, "utf8").trim();
+    if (!existsSync2(f)) return "";
+    return readFileSync2(f, "utf8").trim();
   } catch {
     return "";
   }
 }
+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 seen = /* @__PURE__ */ new Set();
+    const out = [];
+    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;
+    }
+    return out;
+  } catch {
+    return [];
+  }
+}
 function harnessFile(sessionID) {
-  return join(STATE_DIR, sessionID || "_default", "harness.json");
+  return join2(STATE_DIR, sessionID || "_default", "harness.json");
 }
 function readHarness(sessionID) {
   try {
     const f = harnessFile(sessionID);
-    if (!existsSync(f)) return null;
-    return JSON.parse(readFileSync(f, "utf8"));
+    if (!existsSync2(f)) return null;
+    return JSON.parse(readFileSync2(f, "utf8"));
   } catch {
     return null;
   }
@@ -68,7 +144,7 @@ function readHarness(sessionID) {
 function writeHarness(sessionID, h) {
   try {
     const f = harnessFile(sessionID);
-    mkdirSync(dirname(f), { recursive: true });
+    mkdirSync2(dirname(f), { recursive: true });
     h.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
     writeFileSync(f, JSON.stringify(h, null, 2));
   } catch {
@@ -77,14 +153,14 @@ function writeHarness(sessionID, h) {
 function readHarnessCfg(dir) {
   const tryRead = (p) => {
     try {
-      if (existsSync(p)) return JSON.parse(readFileSync(p, "utf8"));
+      if (existsSync2(p)) return JSON.parse(readFileSync2(p, "utf8"));
     } catch {
     }
     return {};
   };
   return {
-    ...tryRead(join(homedir(), ".config", "opencode-usage-coach", "harness.config.json")),
-    ...tryRead(join(dir, "harness.config.json"))
+    ...tryRead(join2(homedir(), ".config", "opencode-usage-coach", "harness.config.json")),
+    ...tryRead(join2(dir, "harness.config.json"))
   };
 }
 async function runModel(client, model, prompt, directory) {
@@ -105,7 +181,12 @@ async function runModel(client, model, prompt, directory) {
     const parts = resp?.data?.parts ?? resp?.parts ?? [];
     const text = parts.filter((p) => p?.type === "text").map((p) => p?.text ?? "").join("");
     try {
-      await client.session.remove?.({ path: { id } });
+      const summary = await client.session.summarize?.({ path: { id } });
+      log(`runModel(${model}): sub-session summary: ${JSON.stringify(summary?.data ?? summary).slice(0, 300)}`);
+    } catch {
+    }
+    try {
+      await client.session.delete?.({ path: { id } });
     } catch {
     }
     log(`runModel(${model}): done ${elapsed}s, ${text.length} chars`);
@@ -116,6 +197,7 @@ async function runModel(client, model, prompt, directory) {
     return `ERROR: runModel exception after ${elapsed}s: ${String(e)}`;
   }
 }
+var HARNESS_AGENTS = (process.env.UC_HARNESS_AGENT ?? "Usage-Coach-Harness").split(",").map((s) => s.trim().toLowerCase()).filter(Boolean);
 var num = (e, d) => {
   try {
     const v = Number(process.env[e]);
@@ -241,10 +323,30 @@ function coach(q, lighter) {
   if (wk >= THR_WK) return thr(`weekly ${wk}% (${wkR})`);
   return { decision: "GO", advice: `Comfortable \u2014 weekly ${wk}% \xB7 5h ${h5}% \xB7 monthly ${mo}%. proceed. 5h window ${h5R}.`, weekly: wk, monthly: mo, fiveHour: h5 };
 }
+var agentCache = /* @__PURE__ */ new Map();
+async function resolveAgent(client, sessionID) {
+  if (!sessionID) return "";
+  const hit = agentCache.get(sessionID);
+  if (hit && Date.now() - hit.ts < 6e4) return hit.agent;
+  try {
+    const s = await client.session.get({ path: { id: sessionID } });
+    const agent = String(s?.data?.info?.agent ?? s?.data?.agent ?? s?.info?.agent ?? "");
+    agentCache.set(sessionID, { agent, ts: Date.now() });
+    return agent;
+  } catch (e) {
+    log(`resolveAgent err: ${String(e)}`);
+    return "";
+  }
+}
+function isHarnessAgent(agent) {
+  if (!agent) return false;
+  return HARNESS_AGENTS.includes(agent.toLowerCase());
+}
 var LOADING = { decision: "GO", advice: "quota loading\u2026", weekly: -1, monthly: -1, fiveHour: -1 };
 async function UsageCoachPlugin(input) {
   try {
     setStateDir(input.directory);
+    initDomain(STATE_DIR);
     const cfg0 = readHarnessCfg(input.directory);
     const PROVIDER = process.env.UC_PROVIDER ?? cfg0.provider ?? "";
     const LIGHTER = process.env.UC_LIGHTER_MODEL ?? cfg0.lighterModel ?? "a lighter model";
@@ -265,6 +367,10 @@ async function UsageCoachPlugin(input) {
               providers = await fetchProvidersCoach();
             } catch {
             }
+            if (providers.length > 0 && last.weekly < 0) {
+              const p0 = providers[0];
+              last = { ...last, weekly: p0.weekly, fiveHour: p0.fiveHour, monthly: p0.weekly >= 0 ? 0 : -1, advice: p0.advice, decision: p0.weekly >= STOP_WK ? "STOP" : p0.weekly >= THR_WK ? "THROTTLE" : "GO" };
+            }
             writeState({ ...last, providers, updatedAt: (/* @__PURE__ */ new Date()).toISOString() });
             log(`${last.decision} | weekly=${last.weekly}% 5h=${last.fiveHour}% | providers=${providers.length}`);
           } catch (e) {
@@ -295,9 +401,17 @@ async function UsageCoachPlugin(input) {
           log(`event err: ${String(e)}`);
         }
       },
-      // ACT(1) hard gate: only intentional STOP throws. Our own bugs never block.
+      // ACT(1) hard gate — harness tools are restricted to the configured harness
+      // agent mode AND gated by quota STOP. General tools (read/edit/bash/grep/task)
+      // are NEVER gated, in ANY mode — they don't consume model quota.
       "tool.execute.before": async (_input) => {
-        let decision = "GO";
+        const harnessTools = ["generate", "generate_batch", "grade", "investigate", "verify_diagnosis", "generalize", "harness_start", "task_update", "harness_done", "record_failure"];
+        if (!harnessTools.includes(_input.tool)) return;
+        const agent = await resolveAgent(input.client, _input.sessionID);
+        if (!isHarnessAgent(agent)) {
+          throw new Error(`[${PLUGIN_NAME}] '${_input.tool}' is restricted to agent mode ${JSON.stringify(HARNESS_AGENTS)} (current: ${JSON.stringify(agent || "unknown")}). Switch to that agent mode to use it.`);
+        }
+        let decision;
         try {
           decision = current().decision;
         } catch {
@@ -307,9 +421,14 @@ async function UsageCoachPlugin(input) {
           throw new Error(`[${PLUGIN_NAME}] blocked: quota limit exceeded. ${current().advice}`);
         }
       },
-      // ACT(2) inject coaching into system prompt (double defense). Silent on error.
+      // ACT(2) inject coaching into system prompt — ONLY in the harness agent mode,
+      // so other modes' system prompts stay completely clean. Silent on error.
       "experimental.chat.system.transform": async (_input, output) => {
         try {
+          if (_input.sessionID) {
+            const agent = await resolveAgent(input.client, _input.sessionID);
+            if (!isHarnessAgent(agent)) return;
+          }
           const c = current();
           let instruction = "";
           if (c.decision === "STOP") instruction = `[${PLUGIN_NAME}] QUOTA limit exceeded. ${c.advice} Stop making further tool calls, finish the in-progress work, then report the quota status to the user.`;
@@ -361,9 +480,12 @@ Then: harness_done(). Follow the [usage-coach NEXT] directive each tool returns.
             model: tool.schema.string().optional()
           },
           async execute(args, ctx) {
+            const cfg = readHarnessCfg(ctx.directory);
             const h = readHarness(ctx.sessionID) ?? { name: "batch", total: 0, current: 0, tasks: [], usage: {}, active: true };
             h.tasks = h.tasks.filter((x) => x.id !== args.id);
-            h.tasks.push({ id: args.id, title: args.title, status: args.status, model: args.model ?? "", revisions: args.revisions ?? 0, score: args.score ?? null, startedAt: (/* @__PURE__ */ new Date()).toISOString() });
+            const model = args.model || cfg.generator || "";
+            if (!model) return `ERROR: task ${args.id} has no model and no generator configured. Set "generator" in harness.config.json.`;
+            h.tasks.push({ id: args.id, title: args.title, status: args.status, model, revisions: args.revisions ?? 0, score: args.score ?? null, startedAt: (/* @__PURE__ */ new Date()).toISOString() });
             if (args.id > h.current) h.current = args.id;
             writeHarness(ctx.sessionID, h);
             return `task ${args.id} -> ${args.status}${args.score ? ` (${args.score})` : ""}`;
@@ -394,8 +516,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 {
-              mkdirSync(STATE_DIR, { recursive: true });
-              appendFileSync(failuresFile(), JSON.stringify(rec) + "\n");
+              mkdirSync2(STATE_DIR, { recursive: true });
+              appendFileSync2(failuresFile(), JSON.stringify(rec) + "\n");
             } catch (e) {
               log(`record_failure err: ${String(e)}`);
             }
@@ -413,6 +535,25 @@ Then: harness_done(). Follow the [usage-coach NEXT] directive each tool returns.
           async execute(args, ctx) {
             const cfg = readHarnessCfg(ctx.directory);
             if (!cfg.generator) return 'ERROR: no generator model configured. Set "generator" in harness.config.json (see harness.config.example.json).';
+            let domainPrefix = "";
+            let keywords = [];
+            let domainEmpty = true;
+            try {
+              keywords = extractKeywords(`${args.task} ${args.gradeResult}`);
+              if (keywords.length) {
+                const { nodes, edges } = queryDomain(keywords);
+                if (nodes && nodes.length || edges && edges.length) {
+                  domainEmpty = false;
+                  domainPrefix = `Known facts from domain DB: ${JSON.stringify({ nodes, edges })}. Use these if relevant.
+
+---
+
+`;
+                }
+              }
+            } catch (e) {
+              log(`investigate domain query err: ${String(e)}`);
+            }
             const rcaPrompt = `A task failed. Analyze the ROOT CAUSE (not just the symptom).
 Task: ${args.task}
 What was expected (from grade): ${args.gradeResult}
@@ -421,7 +562,14 @@ Output a structured root cause:
 category: (one of: constraint-violation, missing-context, tool-misuse, model-limitation, other)
 explanation: <why it failed>
 evidence: <file/line or specific quote>`;
-            const out = await runModel(input.client, cfg.generator, rcaPrompt, ctx.directory);
+            const out = await runModel(input.client, cfg.generator, domainPrefix + rcaPrompt, ctx.directory);
+            if (domainEmpty && keywords.length) {
+              try {
+                saveInvestigationResult(keywords, out, "investigate");
+              } catch (e) {
+                log(`investigate save err: ${String(e)}`);
+              }
+            }
             return out + "\n[usage-coach NEXT] call verify_diagnosis with this diagnosis.";
           }
         }),
@@ -473,8 +621,8 @@ Keep it concrete and actionable.`;
             const rule = out;
             try {
               const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-              mkdirSync(STATE_DIR, { recursive: true });
-              appendFileSync(rulesFile(), `## Rule (${date})
+              mkdirSync2(STATE_DIR, { recursive: true });
+              appendFileSync2(rulesFile(), `## Rule (${date})
 ${rule}
 Origin: ${args.task}
 
@@ -502,13 +650,38 @@ Origin: ${args.task}
             const throttle = decision === "THROTTLE" && cfg.lighterModel;
             const model = throttle ? cfg.lighterModel : cfg.generator;
             const rules = readRules();
-            const prefix = rules ? `Lessons learned from previous failures (apply where relevant):
+            let prefix = rules ? `Lessons learned from previous failures (apply where relevant):
 ${rules}
 
 ---
 
 ` : "";
+            let keywords = [];
+            let domainEmpty = true;
+            try {
+              keywords = extractKeywords(args.prompt);
+              if (keywords.length) {
+                const { nodes, edges } = queryDomain(keywords);
+                if (nodes && nodes.length || edges && edges.length) {
+                  domainEmpty = false;
+                  prefix = `Known facts from domain DB: ${JSON.stringify({ nodes, edges })}. Use these if relevant.
+
+---
+
+` + prefix;
+                }
+              }
+            } catch (e) {
+              log(`generate domain query err: ${String(e)}`);
+            }
             const out = await runModel(input.client, model, prefix + args.prompt, ctx.directory);
+            if (domainEmpty && keywords.length) {
+              try {
+                saveInvestigationResult(keywords, out, "generate");
+              } catch (e) {
+                log(`generate save err: ${String(e)}`);
+              }
+            }
             return out + (throttle ? `
 [usage-coach] quota THROTTLE \u2014 used lighter model ${cfg.lighterModel}` : "") + `
 [usage-coach NEXT] call task_update(i, title, "grading"), then grade to evaluate this work.`;

package/dist/tui.js

@@ -86,10 +86,12 @@ var TLABEL = {
   halted_quota: "quota-halt"
 };
 function barFill(p) {
-  return "\u2588".repeat(Math.max(0, Math.min(10, Math.round(p / 10))));
+  const n = p <= 0 ? 0 : Math.max(1, Math.min(10, Math.round(p / 10)));
+  return "\u2588".repeat(n);
 }
 function barEmpty(p) {
-  return "\u2591".repeat(10 - Math.max(0, Math.min(10, Math.round(p / 10))));
+  const n = p <= 0 ? 0 : Math.max(1, Math.min(10, Math.round(p / 10)));
+  return "\u2591".repeat(10 - n);
 }
 function initializeTui(api, disposeRoot) {
   STATE_DIR = process.env.UC_STATE_DIR ?? projectStateDir(api.state.path.directory);
@@ -129,11 +131,9 @@ function initializeTui(api, disposeRoot) {
     tlog(`api probe err: ${String(e)}`);
   }
   const [getState, setState] = createSignal(readState());
-  const [getHarness, setHarness] = createSignal(readHarness());
   const timer = setInterval(() => {
     try {
       setState(readState());
-      setHarness(readHarness());
     } catch {
     }
   }, 3e3);
@@ -182,7 +182,7 @@ function initializeTui(api, disposeRoot) {
         return _el$;
       })();
     }
-    let s = null;
+    let s;
     try {
       s = getState();
     } catch {
@@ -236,7 +236,7 @@ function initializeTui(api, disposeRoot) {
             _$insert(_el$12, () => p.fiveHour, _el$14);
             _$insert(_el$12, () => p.fiveHourReset, null);
             _$effect((_p$) => {
-              var _v$ = st("text"), _v$2 = st("textMuted");
+              var _v$ = st("text"), _v$2 = st("text");
               _v$ !== _p$.e && (_p$.e = _$setProp(_el$10, "style", _v$, _p$.e));
               _v$2 !== _p$.t && (_p$.t = _$setProp(_el$11, "style", _v$2, _p$.t));
               return _p$;
@@ -253,7 +253,7 @@ function initializeTui(api, disposeRoot) {
             _$insertNode(_el$15, _el$19);
             _$insertNode(_el$15, _el$20);
             _$setProp(_el$15, "flexDirection", "row");
-            _$insertNode(_el$16, _$createTextNode(` wk `));
+            _$insertNode(_el$16, _$createTextNode(` 1w `));
             _$insert(_el$18, () => barFill(p.weekly));
             _$insert(_el$19, () => barEmpty(p.weekly));
             _$insertNode(_el$20, _el$21);
@@ -261,7 +261,7 @@ function initializeTui(api, disposeRoot) {
             _$insert(_el$20, () => p.weekly, _el$22);
             _$insert(_el$20, () => p.weeklyReset, null);
             _$effect((_p$) => {
-              var _v$3 = st("text"), _v$4 = st("textMuted");
+              var _v$3 = st("text"), _v$4 = st("text");
               _v$3 !== _p$.e && (_p$.e = _$setProp(_el$18, "style", _v$3, _p$.e));
               _v$4 !== _p$.t && (_p$.t = _$setProp(_el$19, "style", _v$4, _p$.t));
               return _p$;
@@ -281,7 +281,7 @@ function initializeTui(api, disposeRoot) {
         }
       } else {
         nodes.push((() => {
-          var _el$27 = _$createElement("box"), _el$28 = _$createElement("text"), _el$30 = _$createElement("text"), _el$31 = _$createElement("text"), _el$32 = _$createElement("text"), _el$33 = _$createTextNode(` `), _el$34 = _$createTextNode(`%`);
+          var _el$27 = _$createElement("box"), _el$28 = _$createElement("text"), _el$30 = _$createElement("text"), _el$31 = _$createElement("text"), _el$32 = _$createElement("text");
           _$insertNode(_el$27, _el$28);
           _$insertNode(_el$27, _el$30);
           _$insertNode(_el$27, _el$31);
@@ -290,11 +290,9 @@ function initializeTui(api, disposeRoot) {
           _$insertNode(_el$28, _$createTextNode(` 5h `));
           _$insert(_el$30, () => barFill(s.fiveHour));
           _$insert(_el$31, () => barEmpty(s.fiveHour));
-          _$insertNode(_el$32, _el$33);
-          _$insertNode(_el$32, _el$34);
-          _$insert(_el$32, () => s.fiveHour, _el$34);
+          _$insertNode(_el$32, _$createTextNode(` 0%`));
           _$effect((_p$) => {
-            var _v$5 = st("text"), _v$6 = st("textMuted");
+            var _v$5 = st("text"), _v$6 = st("text");
             _v$5 !== _p$.e && (_p$.e = _$setProp(_el$30, "style", _v$5, _p$.e));
             _v$6 !== _p$.t && (_p$.t = _$setProp(_el$31, "style", _v$6, _p$.t));
             return _p$;
@@ -305,77 +303,51 @@ function initializeTui(api, disposeRoot) {
           return _el$27;
         })());
         nodes.push((() => {
-          var _el$35 = _$createElement("box"), _el$36 = _$createElement("text"), _el$38 = _$createElement("text"), _el$39 = _$createElement("text"), _el$40 = _$createElement("text"), _el$41 = _$createTextNode(` `), _el$42 = _$createTextNode(`%`);
-          _$insertNode(_el$35, _el$36);
-          _$insertNode(_el$35, _el$38);
-          _$insertNode(_el$35, _el$39);
-          _$insertNode(_el$35, _el$40);
-          _$setProp(_el$35, "flexDirection", "row");
-          _$insertNode(_el$36, _$createTextNode(` wk `));
-          _$insert(_el$38, () => barFill(s.weekly));
-          _$insert(_el$39, () => barEmpty(s.weekly));
-          _$insertNode(_el$40, _el$41);
-          _$insertNode(_el$40, _el$42);
-          _$insert(_el$40, () => s.weekly, _el$42);
+          var _el$34 = _$createElement("box"), _el$35 = _$createElement("text"), _el$37 = _$createElement("text"), _el$38 = _$createElement("text"), _el$39 = _$createElement("text");
+          _$insertNode(_el$34, _el$35);
+          _$insertNode(_el$34, _el$37);
+          _$insertNode(_el$34, _el$38);
+          _$insertNode(_el$34, _el$39);
+          _$setProp(_el$34, "flexDirection", "row");
+          _$insertNode(_el$35, _$createTextNode(` 1w `));
+          _$insert(_el$37, () => barFill(s.weekly));
+          _$insert(_el$38, () => barEmpty(s.weekly));
+          _$insertNode(_el$39, _$createTextNode(` 0%`));
           _$effect((_p$) => {
-            var _v$7 = st("text"), _v$8 = st("textMuted");
-            _v$7 !== _p$.e && (_p$.e = _$setProp(_el$38, "style", _v$7, _p$.e));
-            _v$8 !== _p$.t && (_p$.t = _$setProp(_el$39, "style", _v$8, _p$.t));
+            var _v$7 = st("text"), _v$8 = st("text");
+            _v$7 !== _p$.e && (_p$.e = _$setProp(_el$37, "style", _v$7, _p$.e));
+            _v$8 !== _p$.t && (_p$.t = _$setProp(_el$38, "style", _v$8, _p$.t));
             return _p$;
           }, {
             e: void 0,
             t: void 0
           });
-          return _el$35;
-        })());
-        nodes.push((() => {
-          var _el$43 = _$createElement("box"), _el$44 = _$createElement("text"), _el$46 = _$createElement("text"), _el$47 = _$createElement("text"), _el$48 = _$createElement("text"), _el$49 = _$createTextNode(` `), _el$50 = _$createTextNode(`%`);
-          _$insertNode(_el$43, _el$44);
-          _$insertNode(_el$43, _el$46);
-          _$insertNode(_el$43, _el$47);
-          _$insertNode(_el$43, _el$48);
-          _$setProp(_el$43, "flexDirection", "row");
-          _$insertNode(_el$44, _$createTextNode(` mo `));
-          _$insert(_el$46, () => barFill(s.monthly));
-          _$insert(_el$47, () => barEmpty(s.monthly));
-          _$insertNode(_el$48, _el$49);
-          _$insertNode(_el$48, _el$50);
-          _$insert(_el$48, () => s.monthly, _el$50);
-          _$effect((_p$) => {
-            var _v$9 = st("text"), _v$0 = st("textMuted");
-            _v$9 !== _p$.e && (_p$.e = _$setProp(_el$46, "style", _v$9, _p$.e));
-            _v$0 !== _p$.t && (_p$.t = _$setProp(_el$47, "style", _v$0, _p$.t));
-            return _p$;
-          }, {
-            e: void 0,
-            t: void 0
-          });
-          return _el$43;
+          return _el$34;
         })());
       }
     } else {
       nodes.push((() => {
-        var _el$51 = _$createElement("text");
-        _$insertNode(_el$51, _$createTextNode(`usage-coach: ...`));
-        return _el$51;
+        var _el$41 = _$createElement("text");
+        _$insertNode(_el$41, _$createTextNode(`usage-coach: ...`));
+        return _el$41;
       })());
     }
     if (h && h.active !== false && h.tasks.length > 0) {
       nodes.push((() => {
-        var _el$53 = _$createElement("text");
-        _$insertNode(_el$53, _$createTextNode(` `));
-        return _el$53;
+        var _el$43 = _$createElement("text");
+        _$insertNode(_el$43, _$createTextNode(` `));
+        return _el$43;
       })());
       nodes.push((() => {
-        var _el$55 = _$createElement("text"), _el$56 = _$createTextNode(`harness: `), _el$57 = _$createTextNode(` `), _el$58 = _$createTextNode(`/`);
-        _$insertNode(_el$55, _el$56);
-        _$insertNode(_el$55, _el$57);
-        _$insertNode(_el$55, _el$58);
-        _$insert(_el$55, () => h.name, _el$57);
-        _$insert(_el$55, () => h.current, _el$58);
-        _$insert(_el$55, () => h.total, null);
-        _$effect((_$p) => _$setProp(_el$55, "style", st("textMuted"), _$p));
-        return _el$55;
+        var _el$45 = _$createElement("text"), _el$46 = _$createTextNode(`harness: `), _el$47 = _$createTextNode(` `), _el$48 = _$createTextNode(`/`);
+        _$insertNode(_el$45, _el$46);
+        _$insertNode(_el$45, _el$47);
+        _$insertNode(_el$45, _el$48);
+        _$insert(_el$45, () => h.name, _el$47);
+        _$insert(_el$45, () => h.current, _el$48);
+        _$insert(_el$45, () => h.total, null);
+        _$effect((_$p) => _$setProp(_el$45, "style", st("textMuted"), _$p));
+        return _el$45;
       })());
       for (const t of h.tasks) {
         const sKey = statusKey[t.status] ?? "text";
@@ -385,54 +357,54 @@ function initializeTui(api, disposeRoot) {
         const elapsed = t.startedAt ? Math.max(0, Math.round((Date.now() - new Date(t.startedAt).getTime()) / 1e3)) : 0;
         const elapsedStr = t.status === "completed" || t.status === "failed" ? "" : elapsed > 0 ? ` ${elapsed}s` : "";
         nodes.push((() => {
-          var _el$59 = _$createElement("text"), _el$60 = _$createTextNode(` \u25CF `), _el$61 = _$createTextNode(` `), _el$62 = _$createTextNode(` `);
-          _$insertNode(_el$59, _el$60);
-          _$insertNode(_el$59, _el$61);
-          _$insertNode(_el$59, _el$62);
-          _$insert(_el$59, () => t.id, _el$61);
-          _$insert(_el$59, mdl, _el$61);
-          _$insert(_el$59, lbl, _el$62);
-          _$insert(_el$59, rev, _el$62);
-          _$insert(_el$59, elapsedStr, _el$62);
-          _$insert(_el$59, () => t.title, null);
-          _$effect((_$p) => _$setProp(_el$59, "style", st(sKey), _$p));
-          return _el$59;
+          var _el$49 = _$createElement("text"), _el$50 = _$createTextNode(` \u25CF `), _el$51 = _$createTextNode(` `), _el$52 = _$createTextNode(` `);
+          _$insertNode(_el$49, _el$50);
+          _$insertNode(_el$49, _el$51);
+          _$insertNode(_el$49, _el$52);
+          _$insert(_el$49, () => t.id, _el$51);
+          _$insert(_el$49, mdl, _el$51);
+          _$insert(_el$49, lbl, _el$52);
+          _$insert(_el$49, rev, _el$52);
+          _$insert(_el$49, elapsedStr, _el$52);
+          _$insert(_el$49, () => t.title, null);
+          _$effect((_$p) => _$setProp(_el$49, "style", st(sKey), _$p));
+          return _el$49;
         })());
         const pv = t.model ? (t.model.split("/")[0] ?? "").split("-")[0] : "";
-        const provCoach = s?.providers?.find((p) => p.id === pv || pv && p.id.startsWith(pv) || pv && pv.startsWith(p.id));
-        const rawPct = provCoach ? provCoach.fiveHour : s?.fiveHour ?? 0;
+        const provCoach = pv ? s?.providers?.find((p) => p.id === pv || pv && p.id.startsWith(pv) || pv && pv.startsWith(p.id)) : s?.providers?.[0];
+        const rawPct = provCoach?.fiveHour ?? s?.fiveHour ?? -1;
         const pct = rawPct < 0 ? 0 : rawPct;
         const pctLabel = rawPct < 0 ? "n/a" : `${rawPct}%`;
         nodes.push((() => {
-          var _el$63 = _$createElement("box"), _el$64 = _$createElement("text"), _el$66 = _$createElement("text"), _el$67 = _$createElement("text"), _el$68 = _$createElement("text"), _el$69 = _$createTextNode(` `);
-          _$insertNode(_el$63, _el$64);
-          _$insertNode(_el$63, _el$66);
-          _$insertNode(_el$63, _el$67);
-          _$insertNode(_el$63, _el$68);
-          _$setProp(_el$63, "flexDirection", "row");
-          _$insertNode(_el$64, _$createTextNode(` 5h `));
-          _$insert(_el$66, () => barFill(pct));
-          _$insert(_el$67, () => barEmpty(pct));
-          _$insertNode(_el$68, _el$69);
-          _$insert(_el$68, pctLabel, null);
+          var _el$53 = _$createElement("box"), _el$54 = _$createElement("text"), _el$56 = _$createElement("text"), _el$57 = _$createElement("text"), _el$58 = _$createElement("text"), _el$59 = _$createTextNode(` `);
+          _$insertNode(_el$53, _el$54);
+          _$insertNode(_el$53, _el$56);
+          _$insertNode(_el$53, _el$57);
+          _$insertNode(_el$53, _el$58);
+          _$setProp(_el$53, "flexDirection", "row");
+          _$insertNode(_el$54, _$createTextNode(` 5h `));
+          _$insert(_el$56, () => barFill(pct));
+          _$insert(_el$57, () => barEmpty(pct));
+          _$insertNode(_el$58, _el$59);
+          _$insert(_el$58, pctLabel, null);
           _$effect((_p$) => {
-            var _v$1 = st("text"), _v$10 = st("textMuted");
-            _v$1 !== _p$.e && (_p$.e = _$setProp(_el$66, "style", _v$1, _p$.e));
-            _v$10 !== _p$.t && (_p$.t = _$setProp(_el$67, "style", _v$10, _p$.t));
+            var _v$9 = st("text"), _v$0 = st("text");
+            _v$9 !== _p$.e && (_p$.e = _$setProp(_el$56, "style", _v$9, _p$.e));
+            _v$0 !== _p$.t && (_p$.t = _$setProp(_el$57, "style", _v$0, _p$.t));
             return _p$;
           }, {
             e: void 0,
             t: void 0
           });
-          return _el$63;
+          return _el$53;
         })());
       }
     }
     return (() => {
-      var _el$70 = _$createElement("box");
-      _$setProp(_el$70, "flexDirection", "column");
-      _$insert(_el$70, nodes);
-      return _el$70;
+      var _el$60 = _$createElement("box");
+      _$setProp(_el$60, "flexDirection", "column");
+      _$insert(_el$60, nodes);
+      return _el$60;
     })();
   };
   tlog("registering slots");
@@ -441,16 +413,18 @@ function initializeTui(api, disposeRoot) {
     slots: {
       sidebar_footer(ctx) {
         tlog("sidebar_footer slot called");
+        let result;
         try {
-          return panel(ctx);
+          result = panel(ctx);
         } catch (e) {
           tlog(`sidebar_footer err: ${String(e)}`);
-          return (() => {
-            var _el$71 = _$createElement("text");
-            _$insertNode(_el$71, _$createTextNode(`usage-coach`));
-            return _el$71;
+          result = (() => {
+            var _el$61 = _$createElement("text");
+            _$insertNode(_el$61, _$createTextNode(`usage-coach`));
+            return _el$61;
           })();
         }
+        return result;
       }
     }
   });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "opencode-usage-coach",
-  "version": "0.3.4",
-  "description": "opencode closed-loop usage coach \u2014 quota SENSE -> coaching DECIDE -> loop ACT + TUI integration",
+  "version": "0.4.0",
+  "description": "opencode closed-loop usage coach — quota SENSE -> coaching DECIDE -> loop ACT + TUI integration",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -18,6 +18,8 @@
   "scripts": {
     "build": "tsup",
     "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
     "prepack": "tsup"
   },
   "files": [
@@ -44,12 +46,17 @@
     "solid-js": ">=1.9.12"
   },
   "devDependencies": {
+    "@eslint/js": "^10.0.1",
     "@opencode-ai/plugin": "*",
     "@opentui/core": ">=0.4.0",
     "@opentui/solid": ">=0.4.0",
     "esbuild-plugin-solid": "^0.6.0",
+    "eslint": "^10.6.0",
+    "eslint-plugin-solid": "^0.14.5",
+    "globals": "^17.7.0",
     "solid-js": "^1.9",
     "tsup": "^8.5",
-    "typescript": "^5"
+    "typescript": "^5",
+    "typescript-eslint": "^8.63.0"
   }
 }