@sprid/scout 0.1.2 → 0.1.4

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.1.4 - 2026-10-30
+
+- Runs on Windows and Linux: finds Chrome under Program Files and LocalAppData (or the usual Linux paths), and stops a leftover research profile without `pkill`.
+- `sprid-scout-quick` says it needs macOS instead of failing on a missing `osascript`.
+
+## 0.1.3 - 2026-10-25
+
+- Update the Zod dependency to version 4.
+
 ## 0.1.2 - 2026-10-23
 
 - `job_results` refuses a run id that is not one scout issued. A crafted id could read any JSON file on the machine.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sprid/scout",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Local MCP server that researches a niche over your own Chrome: the accounts winning it, and the ads running in it.",
   "license": "SEE LICENSE IN LICENSE",
   "homepage": "https://sprid.studio/agents",
@@ -25,7 +25,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
     "playwright-core": "^1.58.0",
-    "zod": "^3.25.76"
+    "zod": "^4.6.6"
   },
   "publishConfig": {
     "access": "public"

package/src/chrome.js

@@ -225,6 +225,20 @@ function trackFeedRequests(page, pending) {
 
 async function killChrome(profileDir) {
   const pattern = `user-data-dir=${profileDir}`;
+  if (process.platform === "win32") {
+    // No pkill: match the profile on the command line through CIM. The pattern
+    // travels in the environment, so a path is never parsed as PowerShell.
+    await run("powershell.exe", ["-NoProfile", "-NonInteractive", "-Command",
+      "Get-CimInstance Win32_Process -Filter \"Name='chrome.exe'\" | Where-Object { $_.CommandLine -and $_.CommandLine.Contains($env:SCOUT_PROFILE_PATTERN) } | ForEach-Object { Stop-Process -Id $_.ProcessId -Force -ErrorAction SilentlyContinue }"],
+      { env: { ...process.env, SCOUT_PROFILE_PATTERN: pattern }, windowsHide: true }).catch(() => {});
+    await new Promise((resolve) => setTimeout(resolve, 1000));
+    for (const lock of ["lockfile", "SingletonLock"]) {
+      try {
+        fs.unlinkSync(path.join(profileDir, lock));
+      } catch {}
+    }
+    return;
+  }
   await run("pkill", ["-9", "-f", pattern]).catch(() => {});
   for (let attempt = 0; attempt < 20; attempt++) {
     const alive = await run("pgrep", ["-f", pattern]).then(

package/src/config.js

@@ -24,12 +24,27 @@ function ensureDirs() {
   }
 }
 
-const CHROME_CANDIDATES = [
-  "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
-  `${os.homedir()}/Applications/Google Chrome.app/Contents/MacOS/Google Chrome`,
-  "/Applications/Google Chrome Beta.app/Contents/MacOS/Google Chrome Beta",
-  "/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary",
-];
+function chromeCandidates(platform = process.platform, env = process.env) {
+  if (platform === "win32") {
+    // Chrome installs per machine under Program Files, or per user under
+    // LocalAppData when the person had no admin rights.
+    const roots = [env.PROGRAMFILES, env["PROGRAMFILES(X86)"], env.LOCALAPPDATA].filter(Boolean);
+    return roots.flatMap((root) => [
+      path.win32.join(root, "Google", "Chrome", "Application", "chrome.exe"),
+      path.win32.join(root, "Google", "Chrome Beta", "Application", "chrome.exe"),
+      path.win32.join(root, "Google", "Chrome SxS", "Application", "chrome.exe"),
+    ]);
+  }
+  if (platform === "linux") {
+    return ["/usr/bin/google-chrome", "/usr/bin/google-chrome-stable", "/opt/google/chrome/chrome", "/usr/bin/google-chrome-beta"];
+  }
+  return [
+    "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+    `${os.homedir()}/Applications/Google Chrome.app/Contents/MacOS/Google Chrome`,
+    "/Applications/Google Chrome Beta.app/Contents/MacOS/Google Chrome Beta",
+    "/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary",
+  ];
+}
 
 class ChromeMissingError extends Error {
   constructor() {
@@ -43,7 +58,7 @@ class ChromeMissingError extends Error {
 let resolvedChrome = null;
 function chromeBinary() {
   if (resolvedChrome) return resolvedChrome;
-  const found = CHROME_CANDIDATES.find((candidate) => {
+  const found = chromeCandidates().find((candidate) => {
     try {
       fs.accessSync(candidate, fs.constants.X_OK);
       return true;
@@ -70,6 +85,7 @@ const BROWSER_UA =
 
 module.exports = {
   NAME,
+  chromeCandidates,
   ROOT,
   PROFILE_DIR,
   RUNS_DIR,

package/src/quick.js

@@ -287,6 +287,10 @@ async function captureWall(urls, { at = 0, outDir, cols = 4 } = {}) {
 module.exports = { collect, captureFrames, captureWall, targetUrl, NOT_ENABLED };
 
 if (require.main === module) {
+  if (process.platform !== "darwin") {
+    console.error("sprid-scout-quick drives Chrome through Apple Events, so it runs on macOS only. Use the scout MCP tools instead: they work on every platform.");
+    process.exit(1);
+  }
   const [target, ...rest] = process.argv.slice(2);
   if (!target) {
     console.error("Usage: sprid-scout-quick <@handle | #hashtag | post-url> [--rounds 10] [--links-only] [--at 0,1,2,5,10]\n       sprid-scout-quick wall <post-url> <post-url> ... [--at-second 0]");

package/src/register.js

@@ -12,12 +12,20 @@ const { NAME } = require("./config");
 const SERVER = path.join(__dirname, "server.js");
 const ADD = ["mcp", "add", "--transport", "stdio", "--scope", "user", NAME, "--", process.execPath, SERVER];
 
+// Windows installs `claude` through npm as a shim (`claude.cmd`) that only
+// cmd.exe starts, and Node's own path lives under "Program Files".
+function claude(args, options) {
+  if (process.platform !== "win32") return execFileSync("claude", args, options);
+  const line = ["claude", ...args].map((arg) => (/^[\w@+=:,./\\-]+$/.test(arg) ? arg : `"${arg}"`)).join(" ");
+  return execFileSync(line, [], { ...options, shell: true, windowsHide: true });
+}
+
 try {
-  execFileSync("claude", ["mcp", "remove", "--scope", "user", NAME], { stdio: "ignore" });
+  claude(["mcp", "remove", "--scope", "user", NAME], { stdio: "ignore" });
 } catch {}
 
 try {
-  const output = execFileSync("claude", ADD, { encoding: "utf8" });
+  const output = claude(ADD, { encoding: "utf8" });
   console.log(`- Claude Code: ${output.trim() || "registered"}`);
 } catch {
   console.log("- Claude Code: could not run `claude mcp add`. Register it by hand with:");