dsh-deja 0.18.3 → 0.20.0

package/README.md

@@ -31,6 +31,9 @@ Three tools the model can call:
 | `deja_recall` | Sessions matching an error string, function name, file path or flag. |
 | `deja_session` | The full digest of one past session, when the reasoning behind it matters. |
 | `deja_blame` | The sessions that discussed a file, before you edit or delete it. |
+| `deja_fix` | What this machine ran after that same error before. |
+| `deja_how` | The real invocation for a build, test or deploy, from what ran here. |
+| `deja_remember` | Stores one settled decision for later recall. |
 
 One command: `/deja <what to look for>`.
 

package/README.zh.md

@@ -23,6 +23,9 @@ dsh plugin --profile web add dsh-deja
 | `deja_recall` | 匹配报错文本、函数名、文件路径或命令行参数的历史会话。 |
 | `deja_session` | 单个历史会话的完整摘要，用于需要当时的判断依据时。 |
 | `deja_blame` | 在修改或删除某个文件之前，讨论过这个文件的历史会话。 |
+| `deja_fix` | 这台机器上同样的报错之后跑过什么。 |
+| `deja_how` | 构建、测试或部署在这台机器上真实的执行命令。 |
+| `deja_remember` | 把一条已确定的决定存下来，供以后召回。 |
 
 一个命令：`/deja <要查什么>`。
 

package/index.js

@@ -10,10 +10,6 @@ import { execFileSync } from "node:child_process";
 
 const require = createRequire(import.meta.url);
 
-// The tool registry lives in the host, not here. A plugin that throws on a
-// missing peer takes the whole profile down with it, so both imports degrade:
-// without them the command and automatic recall still work, only the
-// model-facing tools are skipped.
 // The tool registry lives in the host. A plugin that throws on a missing peer
 // takes the whole profile down with it, so this degrades: without dsh-tools the
 // command and automatic recall still work, only the model-facing tools are
@@ -26,16 +22,32 @@ try {
 const PLATFORM = process.platform === "win32" ? "windows" : process.platform;
 const ARCH = process.arch === "x64" ? "amd64" : process.arch;
 
-// resolveDeja finds the binary: an explicit override first, then the platform
-// package npm installed next to this one, then whatever is on PATH.
+// resolveDeja picks the binary in the order a user would expect: what they
+// pointed at, then the deja they installed themselves and keep current with
+// `deja update` or a package manager, and only then the copy npm brought along
+// with this plugin. Each candidate is asked for its version rather than
+// trusted, because a name on PATH that does not run is worse than no name.
 function resolveDeja() {
-  if (process.env.DEJA_BIN) return process.env.DEJA_BIN;
   const exe = PLATFORM === "windows" ? "deja.exe" : "deja";
+  const candidates = [process.env.DEJA_BIN, exe];
   try {
-    return require.resolve(`@vshulcz/deja-vu-${PLATFORM}-${ARCH}/bin/${exe}`);
-  } catch {
-    return exe;
+    candidates.push(require.resolve(`@vshulcz/deja-vu-${PLATFORM}-${ARCH}/bin/${exe}`));
+  } catch {}
+
+  for (const candidate of candidates) {
+    if (!candidate) continue;
+    try {
+      execFileSync(candidate, ["version"], {
+        encoding: "utf8",
+        timeout: 5000,
+        stdio: ["ignore", "pipe", "ignore"],
+      });
+      return candidate;
+    } catch {}
   }
+  // Nothing answered. Keep the plain name so the failure a user sees names the
+  // thing that is missing.
+  return exe;
 }
 
 const DEJA = resolveDeja();
@@ -57,12 +69,26 @@ function run(args, input) {
 }
 
 const NOTHING = "Nothing in this machine's history matches that.";
+const MISSING =
+  "deja is not installed on this machine, so there is no history to search. " +
+  "Install it with: curl -fsSL https://raw.githubusercontent.com/vshulcz/deja-vu/main/install.sh | sh";
+
+// installed answers whether the binary picked at load actually runs. Without
+// this every tool would report an empty history to a user who simply never
+// installed deja, which reads as "you have no past" rather than "nothing is
+// here to read it".
+const INSTALLED = run(["version"]) !== "";
+
+function answer(text) {
+  if (INSTALLED) return text || NOTHING;
+  return MISSING;
+}
 
 function tools(ctx) {
   if (!defineTool) return;
 
   // Every tool here answers with the text deja printed, so one output
-  // declaration serves all three. The schema is plain JSON Schema — a
+  // declaration serves them all. The schema is plain JSON Schema — a
   // schemastery instance is rejected as "schema must be a value schema object",
   // because the host validates that this is an ordinary JSON record.
   const TEXT_OUTPUT = {
@@ -87,8 +113,11 @@ function tools(ctx) {
     },
     output: TEXT_OUTPUT,
     execute(args) {
-      const limit = Number.isFinite(args.limit) ? String(Math.max(1, Math.trunc(args.limit))) : "5";
-      return Promise.resolve(run(["search", "--json", "--limit", limit, String(args.query)]) || NOTHING);
+      // deja itself caps the window; asking for a hundred sessions would
+      // spend the model's context on a tail nobody reads.
+      const asked = Number.isFinite(args.limit) ? Math.trunc(args.limit) : 5;
+      const limit = String(Math.min(20, Math.max(1, asked)));
+      return Promise.resolve(answer(run(["search", "--json", "--limit", limit, String(args.query)])));
     },
   }));
 
@@ -105,7 +134,7 @@ function tools(ctx) {
     },
     output: TEXT_OUTPUT,
     execute(args) {
-      return Promise.resolve(run(["ctx", String(args.query)]) || NOTHING);
+      return Promise.resolve(answer(run(["ctx", String(args.query)])));
     },
   }));
 
@@ -122,7 +151,60 @@ function tools(ctx) {
     },
     output: TEXT_OUTPUT,
     execute(args) {
-      return Promise.resolve(run(["blame", String(args.path), "--json"]) || NOTHING);
+      return Promise.resolve(answer(run(["blame", String(args.path), "--json"])));
+    },
+  }));
+
+  ctx.tools.register(defineTool({
+    name: "deja_fix",
+    description:
+      "What this machine ran after that same error before, in the sessions where the error did not come back. Paste the failing output verbatim rather than a paraphrase — the match is on the error's own words.",
+    parameters: {
+      error: {
+        type: "string",
+        required: true,
+        description: "The failing output, copied as it was printed.",
+      },
+    },
+    output: TEXT_OUTPUT,
+    execute(args) {
+      return Promise.resolve(answer(run(["fix", String(args.error)])));
+    },
+  }));
+
+  ctx.tools.register(defineTool({
+    name: "deja_how",
+    description:
+      "The real invocation this machine uses for a build, test, deploy or script, with the flags it actually ran, ordered by how many sessions ran it. A guessed command is plausible and fails on this setup.",
+    parameters: {
+      what: {
+        type: "string",
+        required: true,
+        description: "The thing to run: a tool, a task, a script name.",
+      },
+    },
+    output: TEXT_OUTPUT,
+    execute(args) {
+      return Promise.resolve(answer(run(["how", String(args.what)])));
+    },
+  }));
+
+  ctx.tools.register(defineTool({
+    name: "deja_remember",
+    description:
+      "Store one durable decision once it is settled, as a single self-contained fact that will make sense months later. Not transcripts, not a summary of the conversation, and not anything already obvious from the code.",
+    parameters: {
+      text: {
+        type: "string",
+        required: true,
+        description: "The decision, in one or two sentences, with the reason it was taken.",
+      },
+    },
+    output: TEXT_OUTPUT,
+    execute(args) {
+      const written = run(["remember", String(args.text)]);
+      if (!INSTALLED) return Promise.resolve(MISSING);
+      return Promise.resolve(written || "deja did not record that.");
     },
   }));
 }
@@ -138,7 +220,7 @@ function command(ctx) {
         return { kind: "error", text: "Say what to look for: /deja <error, file, or decision>" };
       }
       const out = run([query]);
-      return { kind: "success", text: out || NOTHING };
+      return { kind: INSTALLED ? "success" : "error", text: answer(out) };
     },
   });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-deja",
-  "version": "0.18.3",
+  "version": "0.20.0",
   "description": "Brings the session history of nineteen other coding agents into DeepSeek Harness: recall, session digest and per-file history tools over a local index, plus optional automatic recall before each step.",
   "type": "module",
   "main": "index.js",
@@ -18,10 +18,9 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/vshulcz/deja-vu.git",
-    "directory": "packages/dsh-deja"
+    "url": "git+https://github.com/vshulcz/dsh-deja.git"
   },
-  "homepage": "https://github.com/vshulcz/deja-vu/tree/main/packages/dsh-deja",
+  "homepage": "https://github.com/vshulcz/dsh-deja",
   "bugs": {
     "url": "https://github.com/vshulcz/deja-vu/issues"
   },
@@ -43,6 +42,9 @@
     }
   },
   "dependencies": {
-    "@vshulcz/deja-vu": "0.18.0"
+    "@vshulcz/deja-vu": "^0.18.0"
+  },
+  "scripts": {
+    "test": "node --test test/*.test.js"
   }
 }