sphica 0.6.25 → 0.6.26

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://anthropic.com/claude-code/plugin.schema.json",
   "name": "sphica",
-  "version": "0.6.25",
+  "version": "0.6.26",
   "description": "Records Claude Code and Codex sessions on your machine and keeps past implementation and decisions, with their sources, for your agent to find.",
   "author": {
     "name": "iroha924",

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "sphica",
-  "version": "0.6.25",
+  "version": "0.6.26",
   "description": "Records Claude Code and Codex sessions on your machine and keeps past implementation and decisions, with their sources, for your agent to find.",
   "author": {
     "name": "iroha924",

package/README.md

@@ -38,7 +38,7 @@ The agent is told to treat records as history, not instructions, and to trust th
 ## Requirements
 
 - Node.js 24.15 or later
-- Claude Code or Codex, or both
+- Claude Code 2.1.139 or later, or Codex, or both. Older Claude Code skips Sphica's hooks without a word, so nothing is captured or delivered (`sphica doctor` flags it)
 - `git`, to identify the repositories you register
 - For `/sphica:harvest` and fetching GitHub sources in `/sphica:glean`: the GitHub CLI (`gh`), signed in with `gh auth login`
 
@@ -139,7 +139,6 @@ The agent searches with Sphica's `search` and opens full records with `read`. `s
 
 - Only what you traced, harvested, or gleaned becomes a structured record. The rest of a conversation is searchable as captured text (`search` with `sources: true`).
 - For shell commands, Sphica only sees whether a command names a file. It may show decisions for a file the command never reads, and a shell command that edits a file is not treated as an edit (in Codex, a patch passed to `apply_patch` through the shell is treated as an edit).
-- Commands run through Claude Code's PowerShell tool (Windows without Git Bash) do not get decisions yet.
 - In Codex, `$sphica:trace`, `$sphica:harvest`, and `$sphica:glean` can write only when Codex tells Sphica which directory the session is in. Current Codex does. When it does not, they write nothing and tell you why.
 - Showing a record does not make the agent follow it.
 - A code location in a record is checked against your working tree when it is read. Finding the code name (a function name, say) the record points to does not mean the decision still holds.

package/dist/capture.js

@@ -12211,7 +12211,11 @@ async function main() {
   if (notice)
     process.stdout.write(JSON.stringify({ systemMessage: notice }));
   if (send)
-    spawn(process.execPath, [process.argv[1] ?? "", "--flush"], { detached: true, stdio: "ignore" }).unref();
+    spawn(process.execPath, [process.argv[1] ?? "", "--flush"], {
+      detached: true,
+      stdio: "ignore",
+      windowsHide: true
+    }).unref();
 }
 if (process.argv[1] && /capture\.(ts|js)$/.test(process.argv[1])) {
   main().catch(() => {});

package/dist/cli.js

@@ -3413,8 +3413,24 @@ function cwdOf(pid) {
     return null;
   }
 }
+var CLAUDE_CODE_MIN = "2.1.139";
 var CACHED = /\/plugins\/cache\/[^/]+\/sphica\/[^/]+$/;
-function observe(cwdRoot) {
+var unknown = (i2) => typeof i2 === "object" && i2 !== null && ("unknown" in i2);
+function npmCli(execPath, platform) {
+  const dir = path2.dirname(execPath);
+  const at = platform === "win32" ? path2.join(dir, "node_modules", "npm", "bin", "npm-cli.js") : path2.resolve(dir, "..", "lib", "node_modules", "npm", "bin", "npm-cli.js");
+  return fs2.existsSync(at) ? at : null;
+}
+function findExe(name, pathEnv, platform) {
+  const sep = platform === "win32" ? ";" : path2.delimiter;
+  for (const dir of pathEnv.split(sep).filter(Boolean)) {
+    const at = path2.join(dir, `${name}.exe`);
+    if (fs2.existsSync(at))
+      return at;
+  }
+  return null;
+}
+function observe(cwdRoot, platform = process.platform, env = process.env, execPath = process.execPath) {
   const install = (root) => ({
     version: versionAt(root),
     packageVersion: packageVersionAt(root),
@@ -3422,18 +3438,32 @@ function observe(cwdRoot) {
   });
   const repository = [path2.dirname(ROOT), cwdRoot].filter((d) => fs2.existsSync(path2.join(d, ".claude-plugin", "marketplace.json"))).map((d) => install(path2.join(d, "plugin"))).find((r2) => r2.version !== null) ?? null;
   let claude;
-  try {
-    const list = JSON.parse(execFileSync("claude", ["plugin", "list", "--json"], {
-      encoding: "utf8",
-      stdio: ["ignore", "pipe", "ignore"],
-      timeout: 30000
-    }));
-    const m = list.find((p) => p.id.startsWith("sphica@") && p.scope === "user");
-    claude = m?.installPath ? { version: m.version ?? null, root: m.installPath } : null;
-  } catch {
-    claude = "unknown";
-  }
-  let codexHome = process.env.CODEX_HOME ?? path2.join(os.homedir(), ".codex");
+  const claudeExe = platform === "win32" ? findExe("claude", env.PATH ?? env.Path ?? "", platform) : "claude";
+  if (!claudeExe)
+    claude = { unknown: "no claude.exe on PATH (an npm install puts claude.cmd there)" };
+  else
+    try {
+      const list = JSON.parse(execFileSync(claudeExe, ["plugin", "list", "--json"], {
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "ignore"],
+        timeout: 30000
+      }));
+      const m = list.find((p) => p.id.startsWith("sphica@") && p.scope === "user");
+      claude = m?.installPath ? { version: m.version ?? null, root: m.installPath } : null;
+    } catch {
+      claude = { unknown: "claude plugin list --json failed" };
+    }
+  let claudeVersion;
+  if (claudeExe)
+    try {
+      const out = execFileSync(claudeExe, ["--version"], {
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "ignore"],
+        timeout: 1e4
+      });
+      claudeVersion = /^\s*(\d+\.\d+\.\d+)/.exec(out)?.[1];
+    } catch {}
+  let codexHome = env.CODEX_HOME ?? path2.join(os.homedir(), ".codex");
   try {
     codexHome = fs2.realpathSync(codexHome);
   } catch {}
@@ -3445,46 +3475,59 @@ function observe(cwdRoot) {
     }
   }
   let running;
-  try {
-    const out = execFileSync("ps", ["-U", String(process.getuid?.()), "-o", "pid=,lstart=,args="], {
-      encoding: "utf8",
-      stdio: ["ignore", "pipe", "ignore"],
-      env: { ...process.env, LC_ALL: "C" },
-      timeout: 1e4
-    });
-    running = parsePs(out).flatMap((p) => {
-      const cwd = path2.isAbsolute(p.script) ? { dir: "/", replaced: false } : cwdOf(p.pid);
-      if (!cwd)
-        return [{ pid: p.pid, started: p.started, root: null, version: null }];
-      const root = path2.dirname(path2.dirname(path2.resolve(cwd.dir, p.script)));
-      const cached = CACHED.test(root);
-      const now = versionAt(root);
-      if (now === null && !cached)
-        return [];
-      let version2 = cwd.replaced || now === null ? cached ? path2.basename(root) : null : now;
-      if (!cached && version2 !== null) {
-        try {
-          const touched = Math.max(...[path2.join("dist", "mcp.js"), MANIFEST].map((f) => fs2.statSync(path2.join(root, f)).mtimeMs));
-          if (touched > p.started.getTime())
+  if (platform === "win32")
+    running = { unknown: "not checked on Windows" };
+  else
+    try {
+      const out = execFileSync("ps", ["-U", String(process.getuid?.()), "-o", "pid=,lstart=,args="], {
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "ignore"],
+        env: { ...process.env, LC_ALL: "C" },
+        timeout: 1e4
+      });
+      running = parsePs(out).flatMap((p) => {
+        const cwd = path2.isAbsolute(p.script) ? { dir: "/", replaced: false } : cwdOf(p.pid);
+        if (!cwd)
+          return [{ pid: p.pid, started: p.started, root: null, version: null }];
+        const root = path2.dirname(path2.dirname(path2.resolve(cwd.dir, p.script)));
+        const cached = CACHED.test(root);
+        const now = versionAt(root);
+        if (now === null && !cached)
+          return [];
+        let version2 = cwd.replaced || now === null ? cached ? path2.basename(root) : null : now;
+        if (!cached && version2 !== null) {
+          try {
+            const touched = Math.max(...[path2.join("dist", "mcp.js"), MANIFEST].map((f) => fs2.statSync(path2.join(root, f)).mtimeMs));
+            if (touched > p.started.getTime())
+              version2 = null;
+          } catch {
             version2 = null;
-        } catch {
-          version2 = null;
+          }
         }
-      }
-      return [{ pid: p.pid, started: p.started, root, version: version2, replaced: cwd.replaced }];
-    });
-  } catch {
-    running = null;
-  }
+        return [{ pid: p.pid, started: p.started, root, version: version2, replaced: cwd.replaced }];
+      });
+    } catch {
+      running = { unknown: "ps failed" };
+    }
   let global = null;
-  try {
-    const at = path2.join(execFileSync("npm", ["root", "-g"], { encoding: "utf8" }).trim(), "sphica");
-    if (fs2.existsSync(at))
-      global = install(at);
-  } catch {
-    global = null;
-  }
-  return { repository, cli: install(ROOT), global, claude, codex, codexCache, running };
+  const cli = npmCli(execPath, platform);
+  if (!cli && platform === "win32")
+    global = { unknown: "no npm CLI next to node" };
+  else
+    try {
+      const [cmd, args] = cli ? [execPath, [cli, "root", "-g"]] : ["npm", ["root", "-g"]];
+      const out = execFileSync(cmd, args, {
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "ignore"],
+        timeout: 1e4
+      });
+      const at = path2.join(out.trim(), "sphica");
+      if (fs2.existsSync(at))
+        global = install(at);
+    } catch {
+      global = { unknown: "npm root -g failed" };
+    }
+  return { repository, cli: install(ROOT), global, claude, claudeVersion, codex, codexCache, running };
 }
 function safeDirs(dir) {
   try {
@@ -3511,12 +3554,15 @@ var RELOAD = { claude: "/reload-plugins or a new session", codex: "reopening Cod
 function report(s, now = new Date) {
   const lines = [];
   const issues = [];
+  const failures = [];
   const todo = new Set;
   const home = os.homedir();
   const short = (p) => p.startsWith(`${home}/`) ? `~${p.slice(home.length)}` : p;
   const say = (m, label, text) => {
     if (m === "warn" || m === "fail")
       issues.push(label);
+    if (m === "fail")
+      failures.push(label);
     lines.push(`  ${mark(m)} ${pad(label, 19)}${text}`);
   };
   const row = (label, i2, note, aside = "", m = note ? "warn" : "ok") => {
@@ -3543,7 +3589,11 @@ ${indent}${caution(note)}` : ""}`);
   if (s.repository)
     row("repository", packageInstall(s.repository));
   row("Running CLI", packageInstall(s.cli), packageAgainst(s.cli).note);
-  if (s.global && path2.resolve(s.global.root) !== path2.resolve(s.cli.root)) {
+  if (unknown(s.global))
+    say("none", "npm i -g CLI", `unknown (${s.global.unknown})`);
+  else if (s.global === null)
+    say("none", "npm i -g CLI", "not installed");
+  else if (s.global && path2.resolve(s.global.root) !== path2.resolve(s.cli.root)) {
     const { note, update } = packageAgainst(s.global);
     if (update)
       todo.add("global");
@@ -3581,8 +3631,8 @@ ${indent}${caution(note)}` : ""}`);
   else
     say("none", "repository", "not visible. Comparing against this CLI's version");
   row("Plugin in this CLI", s.cli, against(s.cli).note);
-  if (s.claude === "unknown")
-    say("none", "Claude Code", "unknown (claude plugin list --json is unavailable)");
+  if (unknown(s.claude))
+    say("none", "Claude Code", `unknown (${s.claude.unknown})`);
   else if (s.claude === null)
     say("none", "Claude Code", "not installed");
   else {
@@ -3591,6 +3641,8 @@ ${indent}${caution(note)}` : ""}`);
       todo.add("claude");
     row("Claude Code", s.claude, note);
   }
+  if (s.claudeVersion)
+    say(compareVersions(s.claudeVersion, CLAUDE_CODE_MIN) < 0 ? "fail" : "ok", "Claude Code app", compareVersions(s.claudeVersion, CLAUDE_CODE_MIN) < 0 ? `${s.claudeVersion}. Sphica's hooks need ${CLAUDE_CODE_MIN} or later and do not run on this version: update Claude Code` : s.claudeVersion);
   if (s.codex.length === 0)
     say("none", "Codex", `not found (looked in ${short(s.codexCache)})`);
   for (const x2 of s.codex) {
@@ -3600,16 +3652,16 @@ ${indent}${caution(note)}` : ""}`);
     row("Codex", x2, note);
   }
   const x = s.codex.length === 1 ? s.codex[0] : undefined;
-  if (!base && s.claude && s.claude !== "unknown" && x && s.claude.version === x.version) {
+  if (!base && s.claude && !unknown(s.claude) && x && s.claude.version === x.version) {
     if (fs2.existsSync(s.claude.root) && differingFiles(s.claude.root, x.root).length) {
       say("warn", "Claude Code and Codex", "same version, different contents");
     }
   }
-  if (s.running === null)
-    say("none", "Running MCP", "unknown (ps is unavailable)");
+  if (unknown(s.running))
+    say("none", "Running MCP", `unknown (${s.running.unknown})`);
   else if (s.running.length === 0)
     say("none", "Running MCP", "none");
-  for (const r2 of s.running ?? []) {
+  for (const r2 of unknown(s.running) ? [] : s.running) {
     const when = r2.started.toLocaleString("sv-SE").slice(r2.started.toDateString() === now.toDateString() ? 11 : 5, 16);
     const label = `MCP pid ${r2.pid}`;
     const aside = ` (started ${when})`;
@@ -3630,7 +3682,7 @@ ${indent}${caution(note)}` : ""}`);
       note = "reads this location directly, not a distributed cache (a directory marketplace or --plugin-dir)";
     } else if (state === "orphaned")
       note = `a version Claude Code replaced on update. Fix with ${again}`;
-    else if (installed && installed !== "unknown" && installed.version && r2.version) {
+    else if (installed && !unknown(installed) && installed.version && r2.version) {
       if (compareVersions(r2.version, installed.version) < 0)
         note = `older than the installed ${installed.version}. Fix with ${again}`;
     }
@@ -3640,7 +3692,7 @@ ${indent}${caution(note)}` : ""}`);
     const u3 = UPDATE[k];
     return k === "global" && packageBase.version ? { ...u3, command: `npm i -g sphica@${packageBase.version}` } : { ...u3 };
   });
-  return { lines, issues, updates };
+  return { lines, issues, failures, updates };
 }
 
 // server/src/sqlite.ts
@@ -15621,7 +15673,11 @@ async function main() {
   if (notice)
     process.stdout.write(JSON.stringify({ systemMessage: notice }));
   if (send)
-    spawn(process.execPath, [process.argv[1] ?? "", "--flush"], { detached: true, stdio: "ignore" }).unref();
+    spawn(process.execPath, [process.argv[1] ?? "", "--flush"], {
+      detached: true,
+      stdio: "ignore",
+      windowsHide: true
+    }).unref();
 }
 if (process.argv[1] && /capture\.(ts|js)$/.test(process.argv[1])) {
   main().catch(() => {});
@@ -16698,6 +16754,8 @@ async function doctor(cwd) {
   console.log(title2("sphica doctor"));
   const plugin = report(observe(identify(cwd)?.root ?? cwd));
   issues.push(...plugin.issues);
+  if (plugin.failures.length)
+    process.exitCode = 1;
   for (const line of plugin.lines)
     console.log(/^\S/.test(line) ? section(line) : indent(line));
   if (plugin.updates.length)