dsh-deja 0.20.3 → 0.20.5

package/README.md

@@ -1,14 +1,14 @@
 # dsh-deja
 
-English | [中文](README.zh.md)
+English | [中文](https://github.com/vshulcz/deja-vu/blob/main/extensions/dsh/docs/zh.md)
 
 DeepSeek Harness can already search its own sessions — that is what the built-in
 `session-query` subsystem does. This plugin answers the other question: what you
 did in the *other* agents on this machine.
 
-deja indexes the session files that Claude Code, Codex, Cursor, opencode,
-Antigravity, Grok Build, Kimi, Cline, Zed and ten more agents already write to
-disk. Nothing has to have been recorded ahead of time: the history is already
+deja indexes the session files that twenty-one other coding agents — Claude Code,
+Codex, Cursor, opencode, Antigravity, Grok Build, Kimi, Cline and Zed among
+them — already write to disk. Nothing has to have been recorded ahead of time: the history is already
 there, including the months before deja was installed. If you moved to dsh last
 week, everything you did before last week is still reachable from inside it.
 
@@ -18,6 +18,13 @@ week, everything you did before last week is still reachable from inside it.
 dsh plugin --profile web add dsh-deja
 ```
 
+From the repository instead of npm — the root manifest re-exports this
+directory, so either form works:
+
+```sh
+dsh plugin --profile web add github:vshulcz/deja-vu#path:extensions/dsh
+```
+
 The plugin runs the `deja` binary. It is pulled in as a dependency, so npm
 installs it with the plugin; a `deja` already on `PATH` is used as-is, and
 `DEJA_BIN` overrides both.

package/{README.zh.md → docs/zh.md}

@@ -1,10 +1,10 @@
 # dsh-deja
 
-[English](README.md) | 中文
+[English](../README.md) | 中文
 
 DeepSeek Harness 自带的 `session-query` 已经可以检索它自己的会话。这个插件回答的是另一个问题：你在这台机器上**其他**智能体里做过什么。
 
-deja 索引 Claude Code、Codex、Cursor、opencode、Antigravity、Grok Build、Kimi、Cline、Zed 等二十个智能体本来就写在磁盘上的会话文件。不需要提前录制：历史已经在那里，包括安装 deja 之前的那些月份。如果你上周才转到 dsh，上周之前做过的事仍然可以在 dsh 里查到。
+deja 索引 Claude Code、Codex、Cursor、opencode、Antigravity、Grok Build、Kimi、Cline、Zed 等二十一个智能体本来就写在磁盘上的会话文件。不需要提前录制：历史已经在那里，包括安装 deja 之前的那些月份。如果你上周才转到 dsh，上周之前做过的事仍然可以在 dsh 里查到。
 
 ## 安装
 

package/index.js

@@ -11,7 +11,7 @@ import { existsSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
 
-import { contributions } from "./lib.js";
+import { argv, contributions, guarded } from "./lib.js";
 
 const require = createRequire(import.meta.url);
 
@@ -89,6 +89,7 @@ function answer(text) {
   return MISSING;
 }
 
+
 function tools(ctx) {
   if (!defineTool) return;
 
@@ -101,7 +102,7 @@ function tools(ctx) {
     render: (_args, value) => [{ type: "text", text: String(value) }],
   };
 
-  ctx.tools.register(defineTool({
+  guarded(() => ctx.tools.register(defineTool({
     name: "deja_recall",
     description:
       "Search this machine's own past AI coding sessions — every agent used on it, including months before deja was installed. Use before debugging an error or re-implementing anything that may already exist. Match on the most specific token available: an exact error string, function name, file path or flag.",
@@ -122,11 +123,11 @@ function tools(ctx) {
       // 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)])));
+      return Promise.resolve(answer(run(argv("search", ["--json", "--limit", limit], args.query))));
     },
-  }));
+  })));
 
-  ctx.tools.register(defineTool({
+  guarded(() => ctx.tools.register(defineTool({
     name: "deja_session",
     description:
       "A full digest of the single best-matching past session — what was tried, what was decided, what it cost. Use after deja_recall when the reasoning behind an earlier decision matters, not just that it happened.",
@@ -139,11 +140,11 @@ function tools(ctx) {
     },
     output: TEXT_OUTPUT,
     execute(args) {
-      return Promise.resolve(answer(run(["ctx", String(args.query)])));
+      return Promise.resolve(answer(run(argv("ctx", [], args.query))));
     },
-  }));
+  })));
 
-  ctx.tools.register(defineTool({
+  guarded(() => ctx.tools.register(defineTool({
     name: "deja_blame",
     description:
       "The past sessions that discussed a file, so you know why it is shaped the way it is before editing, refactoring or deleting it. Session history, not git authorship.",
@@ -156,11 +157,11 @@ function tools(ctx) {
     },
     output: TEXT_OUTPUT,
     execute(args) {
-      return Promise.resolve(answer(run(["blame", String(args.path), "--json"])));
+      return Promise.resolve(answer(run(argv("blame", ["--json"], args.path))));
     },
-  }));
+  })));
 
-  ctx.tools.register(defineTool({
+  guarded(() => 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.",
@@ -173,11 +174,11 @@ function tools(ctx) {
     },
     output: TEXT_OUTPUT,
     execute(args) {
-      return Promise.resolve(answer(run(["fix", String(args.error)])));
+      return Promise.resolve(answer(run(argv("fix", [], args.error))));
     },
-  }));
+  })));
 
-  ctx.tools.register(defineTool({
+  guarded(() => 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.",
@@ -190,11 +191,11 @@ function tools(ctx) {
     },
     output: TEXT_OUTPUT,
     execute(args) {
-      return Promise.resolve(answer(run(["how", String(args.what)])));
+      return Promise.resolve(answer(run(argv("how", [], args.what))));
     },
-  }));
+  })));
 
-  ctx.tools.register(defineTool({
+  guarded(() => 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.",
@@ -207,15 +208,15 @@ function tools(ctx) {
     },
     output: TEXT_OUTPUT,
     execute(args) {
-      const written = run(["remember", String(args.text)]);
+      const written = run(argv("remember", [], args.text));
       if (!INSTALLED) return Promise.resolve(MISSING);
       return Promise.resolve(written || "deja did not record that.");
     },
-  }));
+  })));
 }
 
 function command(ctx) {
-  ctx.commands.register({
+  guarded(() => ctx.commands.register({
     name: "deja",
     description: "Search this machine's past AI coding sessions",
     input: { hint: "what to look for" },
@@ -224,10 +225,14 @@ function command(ctx) {
       if (!query) {
         return { kind: "error", text: "Say what to look for: /deja <error, file, or decision>" };
       }
-      const out = run([query]);
+      // Named, not handed over as deja's first word: the bare-query path
+      // dispatches a word that happens to be a command, so `/deja version`
+      // printed a version number and `/deja index` rebuilt the index, and one
+      // of the words people most want history about is `install`.
+      const out = run(argv("search", [], query));
       return { kind: INSTALLED ? "success" : "error", text: answer(out) };
     },
-  });
+  }));
 }
 
 function userText(message) {
@@ -245,26 +250,36 @@ function userText(message) {
 // alternative — splicing a message into the "agent/pre-step" waterfall — looks
 // like it works and does not: a later listener rebuilds its answer from the
 // payload, and the added message is dropped with nothing reported.
+//
+// The registration is guarded because the host throws "prompt context
+// deja:recall is already registered" on a second copy in the same profile, and
+// that failure is not local: the whole profile fails to load, so a duplicate
+// memory plugin costs the user their agent. One registration is all recall
+// needs. installedByCLI() below is the first line of defence; this is the one
+// that holds when the installer wrote to a different DSH_HOME than the profile
+// boots from.
 function autoRecall(ctx) {
   let asked = "";
   let recalled = "";
 
-  ctx.systemPrompt.context({
-    name: "deja:recall",
-    order: 120,
-    text: (assembly) => {
-      const agent = assembly && assembly.agent;
-      if (!agent) return "";
-      const prompt = lastHumanText(agent);
-      if (!prompt) return "";
-      if (prompt !== asked) {
-        asked = prompt;
-        recalled = run(["hook-prompt", "--plain"], JSON.stringify({ prompt, cwd: process.cwd() }));
-      }
-      // Silence is the common case: this speaks only when the history answers.
-      return recalled;
-    },
-  });
+  guarded(() =>
+    ctx.systemPrompt.context({
+      name: "deja:recall",
+      order: 120,
+      text: (assembly) => {
+        const agent = assembly && assembly.agent;
+        if (!agent) return "";
+        const prompt = lastHumanText(agent);
+        if (!prompt) return "";
+        if (prompt !== asked) {
+          asked = prompt;
+          recalled = run(["hook-prompt", "--plain"], JSON.stringify({ prompt, cwd: process.cwd() }));
+        }
+        // Silence is the common case: this speaks only when the history answers.
+        return recalled;
+      },
+    }),
+  );
 }
 
 // lastHumanText is the newest thing the person actually typed. At assembly

package/lib.js

@@ -2,6 +2,43 @@
 // anything a plugin module exports as part of the plugin — opencode does
 // exactly that with its own — and this is a helper, not a second plugin.
 
+// argv builds the call for a query somebody typed, rather than handing the text
+// to deja as it stands.
+//
+// The command is always named. deja's bare-query path dispatches a first word
+// that happens to be a command, so a one-word query went to the command of that
+// name: `version` printed a version number, `index` rebuilt the index, and
+// neither searched anything.
+//
+// A query that starts with a dash is read as a flag: `deja search --no-verify`
+// exits on an unknown flag, the caller turns that into "", and the model is
+// told the history holds nothing about --no-verify while eleven sessions
+// discuss it — a confident wrong answer, which is worse than an error. `--`
+// ends the flags. It is sent only when the query needs it, so a deja too old to
+// know the terminator on this subcommand still answers every ordinary query.
+export function argv(cmd, flags, text) {
+  const arg = String(text);
+  return arg.startsWith("-") ? [cmd, ...flags, "--", arg] : [cmd, ...flags, arg];
+}
+
+// guarded runs one registration, and swallows the host's refusal of a name it
+// already holds.
+//
+// dsh answers a duplicate with "prompt context deja:recall is already
+// registered" or "command deja is already registered", and that failure is not
+// local: the whole plugin tree fails to load, so a second copy of this plugin —
+// the npm package next to the installer's files, a --patch overlay naming it
+// twice — costs the user their agent over an optional memory plugin. One
+// registration is all any of these need, so the loser stands down.
+export function guarded(register) {
+  try {
+    register();
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 // contributions says what this package adds, given what `deja install` already
 // wrote into DSH_HOME and what the profile turned off. The rule is the same
 // everywhere: fill the gaps, never repeat the installer.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-deja",
-  "version": "0.20.3",
-  "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.",
+  "version": "0.20.5",
+  "description": "Brings the session history of twenty-one 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",
   "exports": {
@@ -13,7 +13,7 @@
     "lib.js",
     "cordis.patch.yml",
     "README.md",
-    "README.zh.md",
+    "docs/zh.md",
     "LICENSE"
   ],
   "license": "MIT",
@@ -44,7 +44,7 @@
     }
   },
   "dependencies": {
-    "@vshulcz/deja-vu": "^0.18.0"
+    "@vshulcz/deja-vu": "^0.19.2"
   },
   "scripts": {
     "test": "node --test test/*.test.js"