@misaka-net/misakanet-setup 0.4.0 → 0.4.2

package/README.md

@@ -1,7 +1,7 @@
 # @misaka-net/misakanet-setup
 
-One command to teach your **Claude Code**, **Codex**, **Hermes** or **OpenClaw** to check
-MisakaNet's failure lessons before repeating a mistake — and to distil the session's reusable
+One command to teach your **Claude Code**, **Codex**, **Hermes**, **OpenClaw** or **codewhale** to
+check MisakaNet's failure lessons before repeating a mistake — and to distil the session's reusable
 lessons at a checkpoint.
 
 ```bash
@@ -9,7 +9,7 @@ npx @misaka-net/misakanet-setup
 ```
 
 Then **close and reopen the assistant window** (the new MCP server loads on restart) and ask
-something with an error in it, e.g. "docker exit code 137 是什么原因" — it should search the
+something with an error in it, e.g. "pip install timeout 是什么原因" — it should search the
 knowledge base on its own instead of guessing.
 
 ## What it installs, and why all three
@@ -31,6 +31,8 @@ npx @misaka-net/misakanet-setup --verify      # READY / NOT READY, installed ver
 npx @misaka-net/misakanet-setup --only claude # one agent only
 npx @misaka-net/misakanet-setup --no-register # read-only, no anonymous token
 npx @misaka-net/misakanet-setup --upgrade     # same as installing the latest (the command is idempotent)
+                                             # re-running also *refreshes* an older hook (the previous copy
+                                             # is kept as ~/.misakanet-agent/hook.mjs.misakanet.bak)
 npx @misaka-net/misakanet-setup --uninstall   # remove exactly what it added
 ```
 

package/bin/misakanet-setup.mjs

@@ -69,7 +69,7 @@ const valueOf = (flag, dflt) => {
 const only = valueOf('--only', '').split(',').map((s) => s.trim()).filter(Boolean);
 const DRY = has('--dry-run');
 const HOME = resolve(valueOf('--home', homedir()));
-const AGENTS = ['claude', 'codex', 'hermes', 'openclaw'];
+const AGENTS = ['claude', 'codex', 'hermes', 'openclaw', 'codewhale'];
 
 const done = [];
 const manual = [];
@@ -103,7 +103,7 @@ function readText(path) {
  * meant to prevent is now caught in CI instead, by a test that binds this literal to the
  * manifest — a failing test is a better place for that than a request header.
  */
-const VERSION = '0.4.0';
+const VERSION = '0.4.2';
 
 function backup(path) {
   if (DRY || !readText(path)) return;
@@ -252,23 +252,44 @@ function locateHook() {
 
 async function installHook() {
   const hookPath = join(stateDir(), 'hook.mjs');
+  const bundled = locateHook();
+  let existing = null;
   try {
-    if (readFileSync(hookPath, 'utf8').includes('MisakaNet')) {
+    existing = readFileSync(hookPath, 'utf8');
+  } catch { /* not installed yet */ }
+  const isOurs = existing !== null && existing.includes('MisakaNet');
+
+  if (!bundled) {
+    if (isOurs) {
       ok(`自动沉淀的钩子已存在：${hookPath}`);
       return hookPath;
     }
-  } catch { /* not installed yet */ }
-  const bundled = locateHook();
-  if (!bundled) {
     need('自动沉淀那部分装不上：这个 npm 包里没有带钩子文件（安装不完整）→ '
       + '重新执行 npx 安装即可；其它功能不受影响');
     return null;
   }
+
+  if (isOurs && existing.trim() === bundled.trim()) {
+    ok(`自动沉淀的钩子已是最新：${hookPath}`);
+    return hookPath;
+  }
+
+  // Refresh a hook that is *ours* (marker) but older than the bundled copy, keeping the
+  // previous file beside it.
+  //
+  // This used to return early for any hook containing "MisakaNet", which made a hook fix
+  // unable to reach an existing install: the 14-day upgrade nudge (#1712) could not
+  // arrive, and re-running the installer — the very thing the nudge asks the user to do —
+  // changed nothing (found 2026-09-15: the machine's installed hook predated the nudge
+  // while `npx …@latest` reported success).
   if (!DRY) {
     mkdirSync(stateDir(), { recursive: true });
+    if (existing !== null) backup(hookPath);
     writeFileSync(hookPath, bundled);
   }
-  ok(`安装自动沉淀钩子 → ${hookPath}`);
+  ok(isOurs
+    ? `自动沉淀的钩子已更新（旧版备份为 ${hookPath}.misakanet.bak）→ ${hookPath}`
+    : `安装自动沉淀钩子 → ${hookPath}`);
   return hookPath;
 }
 
@@ -331,6 +352,7 @@ function detect(agent) {
     codex: ['.codex'],
     hermes: ['.hermes'],
     openclaw: ['.openclaw'],
+    codewhale: ['.codewhale'],
   }[agent] || [];
   return paths.some((p) => existsSync(join(HOME, p)));
 }
@@ -447,11 +469,30 @@ async function installCodex(hookPath, bearer) {
 
   const rules = join(HOME, '.codex', 'AGENTS.md');
   ok(`Codex：规则块 ${injectBlock(rules, PROMPT_BLOCK)} → ${rules}`);
-  need('Codex：用户级钩子的写法我没能确证 → "第 20 轮自动沉淀"靠规则自律；'
-    + '要硬保证就用 --verify 看状态，或把本会话放在 CC 里跑');
+  // Verified on codex-cli 0.154.0 (2026-09-15), so this is no longer a "could not
+  // confirm" note: `codex mcp list` shows misakanet enabled with the Bearer token,
+  // `codex doctor` reports config.toml parse ok + 1 streamable_http server + 0
+  // disabled, and `codex debug prompt-input` renders a `# AGENTS.md instructions`
+  // item carrying this rule block. What stays open is the *hook*: 0.154.0's lifecycle
+  // hooks are admin-managed (requirements.toml), so the round-20 distillation is
+  // rule-driven rather than hook-driven.
+  ok('Codex：注册已核对（`codex mcp list` / `codex doctor` / `codex debug prompt-input`）');
+  need('Codex：没有用户级 lifecycle hook → "第 20 轮自动沉淀"靠规则块自律；'
+    + '要硬保证就配外层 wrapper 每轮后跑 checkpoint_reminder');
 }
 
 const STATE_VERSION_FILE = 'version';
+
+/**
+ * The question the onboarding text tells a user to ask — and the reason it is a constant.
+ *
+ * It used to be "docker exit code 137 是什么原因", which the corpus answers with three only
+ * loosely-related lessons (top hit: kubernetes-crashloopbackoff-debugging) — so a new user's
+ * first question, the one we chose for them, landed on a near-miss. It is now a query whose top
+ * hit is a lesson about that very failure, and tests/test_onboarding_example.py keeps it that
+ * way offline (plus a check that this literal is not duplicated back into the messages).
+ */
+const ONBOARDING_QUERY = 'pip install timeout';
 const REGISTRY_LATEST = process.env.MISAKANET_REGISTRY_URL
   || 'https://registry.npmjs.org/@misaka-net%2fmisakanet-setup/latest';
 
@@ -633,6 +674,75 @@ async function installHermes(hookPath, bearer) {
  * The manual `openclaw mcp add …` line is still printed for the user to run themselves — as
  * text, never executed.
  */
+/**
+ * codewhale keeps MCP servers in its own JSON file, and reads workspace rules from a
+ * plain `AGENTS.md` — but only in a *trusted* project (`config.toml`'s
+ * `[projects."<dir>"] trust_level = "trusted"`). So the block goes into the trusted
+ * project directories, which are also where the user actually works, rather than into a
+ * guessed user-level path (checked on 0.9.7: no user-level AGENTS.md is read).
+ *
+ * The token is the one thing codewhale will not take inline: `bearer_token_env_var` names
+ * an environment variable, so "install once" for this agent ends with the user exporting
+ * `MISAKANET_TOKEN` once. That is stated rather than silently half-installed.
+ */
+function codewhaleProjects() {
+  const text = readText(join(HOME, '.codewhale', 'config.toml'));
+  if (!text) return [];
+  const out = [];
+  let current = null;
+  for (const line of text.split('\n')) {
+    const header = line.match(/^\s*\[projects\.(.+?)\]\s*$/);
+    if (header) { current = header[1].trim().replace(/^"|"$/g, ''); continue; }
+    if (/^\s*\[/.test(line)) { current = null; continue; }
+    if (current && /^\s*trust_level\s*=\s*"trusted"/.test(line)) out.push(current);
+  }
+  return out;
+}
+
+async function installCodewhale(bearer) {
+  const cfg = join(HOME, '.codewhale', 'mcp.json');
+  const data = readJson(cfg, null) || {
+    timeouts: { connect_timeout: 10, execute_timeout: 60, read_timeout: 120 },
+    servers: {},
+  };
+  const servers = { ...(data.servers || {}) };
+  const entry = {
+    command: null,
+    args: [],
+    env: {},
+    url: ENDPOINT,
+    connect_timeout: null,
+    execute_timeout: null,
+    read_timeout: null,
+    disabled: false,
+    enabled: true,
+    required: false,
+    enabled_tools: [],
+    disabled_tools: [],
+    bearer_token_env_var: 'MISAKANET_TOKEN',
+  };
+  if (JSON.stringify(servers.misakanet || null) !== JSON.stringify(entry)) {
+    servers.misakanet = entry;
+    backup(cfg);
+    writeText(cfg, `${JSON.stringify({ ...data, servers }, null, 2)}\n`);
+    ok(`codewhale：注册 MCP（streamable-http）→ ${cfg}`);
+  } else {
+    ok('codewhale：MCP 已注册（无改动）');
+  }
+
+  const projects = codewhaleProjects();
+  for (const project of projects) {
+    if (!existsSync(project)) continue;
+    ok(`codewhale：规则块 ${injectBlock(join(project, 'AGENTS.md'), PROMPT_BLOCK)} → ${join(project, 'AGENTS.md')}`);
+  }
+  if (!projects.length) {
+    need('codewhale：没有受信任的项目目录（config.toml 里没有 trust_level = "trusted"）→ '
+      + '先在 codewhale 里打开一次你的项目并信任它，再运行本命令，规则块才会写进去');
+  }
+  need('codewhale：token 只能通过环境变量给 → 在你的 shell 配置里加 `export MISAKANET_TOKEN=<你的 token>`'
+    + '（本机状态：npx @misaka-net/misakanet-setup --verify 会告诉你 token 在哪）');
+}
+
 async function installOpenclaw(bearer) {
   const workspace = openclawWorkspaces()[0];
   const rules = join(workspace, 'AGENTS.md');
@@ -810,6 +920,20 @@ function uninstall() {
     const rules = join(workspace, 'AGENTS.md');
     if (stripBlock(rules)) ok(`移除规则块 → ${rules}`);
   }
+
+  // codewhale: same two surfaces as the install (its own mcp.json + trusted projects).
+  for (const project of codewhaleProjects()) {
+    const rules = join(project, 'AGENTS.md');
+    if (stripBlock(rules)) ok(`移除规则块 → ${rules}`);
+  }
+  const whaleCfg = join(HOME, '.codewhale', 'mcp.json');
+  const whale = readJson(whaleCfg, null);
+  if (whale?.servers?.misakanet) {
+    delete whale.servers.misakanet;
+    backup(whaleCfg);
+    writeText(whaleCfg, `${JSON.stringify(whale, null, 2)}\n`);
+    ok(`移除 MCP 注册 → ${whaleCfg}`);
+  }
   const cfg = join(HOME, '.claude.json');
   const data = readJson(cfg, null);
   if (data && data.mcpServers?.misakanet) {
@@ -913,7 +1037,7 @@ if (mode === 'uninstall') {
 if (mode === 'verify') {
   const allOk = await verify();
   console.log(render());
-  console.log(`\n结论：${allOk ? 'READY —— 打开一个新会话，问它「docker exit code 137 是什么原因」' : 'NOT READY —— 上面每条 ! 都给了修复动作'}`);
+  console.log(`\n结论：${allOk ? `READY —— 打开一个新会话，问它「${ONBOARDING_QUERY} 是什么原因」` : 'NOT READY —— 上面每条 ! 都给了修复动作'}`);
   process.exit(allOk ? 0 : 1);
 }
 
@@ -934,6 +1058,7 @@ if (!targets.length) {
     else if (agent === 'codex') await installCodex(hookPath, bearer);
     else if (agent === 'hermes') await installHermes(hookPath, bearer);
     else if (agent === 'openclaw') await installOpenclaw(bearer);
+    else if (agent === 'codewhale') await installCodewhale(bearer);
   }
 }
 
@@ -941,6 +1066,6 @@ console.log(render());
 console.log(`
 接下来：
   1) **把这个助手窗口关掉再打开一次**（新功能要重开会话才生效）
-  2) 随便问一句带报错的：「docker exit code 137 是什么原因」——它应该先去查经验库
+  2) 随便问一句带报错的：「${ONBOARDING_QUERY} 是什么原因」——它应该先去查经验库
   3) 想确认状态：npx @misaka-net/misakanet-setup --verify
   4) 想关掉：npx @misaka-net/misakanet-setup --uninstall`);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@misaka-net/misakanet-setup",
-  "version": "0.4.0",
-  "description": "One-command setup: teach your Claude Code / Codex / Hermes / OpenClaw to search MisakaNet failure lessons before repeating a mistake, and to distil the session at a checkpoint.",
+  "version": "0.4.2",
+  "description": "One-command setup: teach your Claude Code / Codex / Hermes / OpenClaw / codewhale to search MisakaNet failure lessons before repeating a mistake, and to distil the session at a checkpoint.",
   "bin": {
     "misakanet-setup": "bin/misakanet-setup.mjs"
   },