saycoder 0.1.2 → 0.1.4

package/README.md

@@ -5,7 +5,7 @@ A small CLI that configures OpenCode to use SayCoder as the model layer, plus pr
 ## Setup flow
 
 1. Checks whether `opencode` is installed.
-2. If missing, asks whether to install it with `npm install -g opencode-ai --foreground-scripts`.
+2. If missing, asks whether to install it with `npm install -g opencode-ai --foreground-scripts --verbose --loglevel verbose`.
 3. Optionally enables China mirror optimization, measures available mirrors, and lets the user choose with arrow keys or number input on Windows.
 4. Installs OpenCode and verifies `opencode --version` before continuing.
 5. Prompts the user for a SayCoder API key.
@@ -25,13 +25,25 @@ SayCoder's base URL is only used for the OpenAI-compatible model channel, not fo
 
 ## China mirror
 
-When OpenCode is missing, setup asks whether to install through China mirror optimization. If enabled, it measures common npm mirrors and lets you choose one with arrow keys. If OpenCode installation or verification fails, setup stops and prints the manual install command.
+When OpenCode is missing, setup asks whether to install through China mirror optimization. If enabled, it measures common npm mirrors and lets you choose one with arrow keys, or number input on Windows/non-TTY terminals. Mirror probes use the package metadata endpoint and fall back from `HEAD` to `GET` for registries that reject `HEAD`.
+
+If OpenCode installation or verification fails, setup stops before writing OpenCode config and prints the npm exit code, any npm spawn error, a detected npm debug log path when npm reports one, and the manual install command.
 You can also force it with:
 
 ```bash
 node bin/saycoder.js setup --npm-registry https://registry.npmmirror.com
 ```
 
+## Windows PowerShell troubleshooting
+
+If automatic `opencode-ai` installation fails on Windows, rerun the printed command in a fresh PowerShell window as the same user. For example:
+
+```powershell
+npm install -g opencode-ai --foreground-scripts --verbose --loglevel verbose --registry https://registry.npmmirror.com
+```
+
+Then check the npm debug log shown by `saycoder` or the newest log under your npm cache `_logs` directory. After a successful manual install, close and reopen PowerShell so the global npm bin path is refreshed, verify with `opencode --version`, then run `npx saycoder` again.
+
 ## Installed skills
 
 - `saycoder-lite-superpowers`: clarify user intent, split logical goals, implement production code, and report completed/not completed work.
@@ -44,6 +56,8 @@ node bin/saycoder.js setup --npm-registry https://registry.npmmirror.com
 node bin/saycoder.js setup --dry-run --skip-install-check --skip-validate --api-key test-key
 ```
 
+Dry-run output redacts API keys and other token-like fields.
+
 ## Intended usage
 
 ```bash

package/bin/saycoder.js

@@ -103,6 +103,15 @@ function sortObject(value) {
   return Object.fromEntries(Object.entries(value).sort(([left], [right]) => left.localeCompare(right)).map(([key, nested]) => [key, sortObject(nested)]));
 }
 
+function redactSecrets(value) {
+  if (Array.isArray(value)) return value.map(redactSecrets);
+  if (!value || typeof value !== "object") return value;
+  return Object.fromEntries(Object.entries(value).map(([key, nested]) => {
+    if (/api[-_]?key|authorization|token|secret/i.test(key)) return [key, "<redacted>"];
+    return [key, redactSecrets(nested)];
+  }));
+}
+
 function unique(values) {
   return [...new Set(values.filter(Boolean))];
 }
@@ -115,18 +124,41 @@ function commandExists(command) {
   return result.status === 0;
 }
 
+function shellQuote(value) {
+  if (/^[A-Za-z0-9_/:=@.%+-]+$/.test(value)) return value;
+  return JSON.stringify(value);
+}
+
+function findNpmDebugLogs(outputText) {
+  const matches = outputText.match(/(?:[A-Z]:)?[^\r\n]*npm[^\r\n]*(?:debug|eresolve-report)[^\r\n]*\.log/gi) || [];
+  return unique(matches.map((item) => item.trim().replace(/^['"]|['"]$/g, "")));
+}
+
 function installOpenCode(registry) {
-  const args = ["install", "-g", "opencode-ai", "--foreground-scripts"];
+  const args = ["install", "-g", "opencode-ai", "--foreground-scripts", "--verbose", "--loglevel", "verbose"];
   if (registry) args.push("--registry", registry);
   step(`Installing OpenCode with npm${registry ? ` using ${registry}` : ""}...`);
-  const result = spawnSync("npm", args, { stdio: "inherit" });
-  return result.status === 0;
+  const result = spawnSync(process.platform === "win32" ? "npm.cmd" : "npm", args, {
+    encoding: "utf8",
+    stdio: ["ignore", "pipe", "pipe"],
+  });
+
+  if (result.stdout) output.write(result.stdout);
+  if (result.stderr) process.stderr.write(result.stderr);
+
+  return {
+    ok: result.status === 0,
+    status: result.status,
+    signal: result.signal,
+    error: result.error,
+    output: `${result.stdout || ""}\n${result.stderr || ""}`,
+  };
 }
 
 function npmInstallOpenCodeCommand(registry) {
-  const command = ["npm", "install", "-g", "opencode-ai", "--foreground-scripts"];
+  const command = ["npm", "install", "-g", "opencode-ai", "--foreground-scripts", "--verbose", "--loglevel", "verbose"];
   if (registry) command.push("--registry", registry);
-  return command.join(" ");
+  return command.map(shellQuote).join(" ");
 }
 
 function pathRefreshHint() {
@@ -136,14 +168,18 @@ function pathRefreshHint() {
 }
 
 function verifyOpenCode() {
-  const result = spawnSync("opencode", ["--version"], {
-    encoding: "utf8",
-    shell: process.platform === "win32",
-    stdio: ["ignore", "pipe", "pipe"],
-  });
+  const commands = process.platform === "win32" ? ["opencode.cmd", "opencode.exe", "opencode"] : ["opencode"];
 
-  if (result.status !== 0) return null;
-  return (result.stdout || result.stderr || "").trim();
+  for (const command of commands) {
+    const result = spawnSync(command, ["--version"], {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "pipe"],
+    });
+
+    if (result.status === 0) return (result.stdout || result.stderr || "").trim();
+  }
+
+  return null;
 }
 
 function step(message) {
@@ -169,10 +205,11 @@ async function measureMirror(mirror) {
   const timeout = setTimeout(() => controller.abort(), 5000);
 
   try {
-    const response = await fetch(`${mirror.url.replace(/\/+$/, "")}/opencode-ai`, {
-      method: "HEAD",
-      signal: controller.signal,
-    });
+    const url = `${mirror.url.replace(/\/+$/, "")}/opencode-ai`;
+    let response = await fetch(url, { method: "HEAD", signal: controller.signal });
+    if (response.status === 405 || response.status === 403) {
+      response = await fetch(url, { method: "GET", signal: controller.signal });
+    }
     if (!response.ok) throw new Error(`HTTP ${response.status}`);
     return { ...mirror, latency: Date.now() - started, ok: true };
   } catch {
@@ -489,8 +526,8 @@ async function setup(flags) {
 
     flags["npm-registry"] = await chooseNpmRegistry(flags);
 
-    const installed = installOpenCode(flags["npm-registry"]);
-    if (installed) {
+    const installResult = installOpenCode(flags["npm-registry"]);
+    if (installResult.ok) {
       success("OpenCode installed.");
       const version = verifyOpenCode();
       if (version) success(`OpenCode verified: ${version}`);
@@ -500,8 +537,14 @@ async function setup(flags) {
       }
     } else {
       warn("OpenCode installation failed. SayCoder setup cannot continue until OpenCode is installed.");
+      warn(`npm exit code: ${installResult.status ?? "unknown"}${installResult.signal ? `, signal: ${installResult.signal}` : ""}`);
+      if (installResult.error) warn(`npm spawn error: ${installResult.error.message}`);
+      const debugLogs = findNpmDebugLogs(installResult.output);
+      if (debugLogs.length > 0) warn(`npm debug log: ${debugLogs[0]}`);
+      else warn("npm did not print a debug log path. Check the latest npm debug log under your npm cache/_logs directory.");
       warn(`Manual install command: ${npmInstallOpenCodeCommand(flags["npm-registry"])}`);
-      throw new Error("Please install OpenCode manually, reopen PowerShell if needed, then rerun `npx saycoder`.");
+      if (process.platform === "win32") warn("On Windows, run the manual command in a fresh PowerShell as the same user; if it succeeds, close and reopen PowerShell so PATH refreshes.");
+      throw new Error("OpenCode installation failed; config was not written. Fix npm/OpenCode install, then rerun `npx saycoder`.");
     }
   } else if (!flags["skip-install-check"]) {
     success("OpenCode is installed.");
@@ -537,7 +580,7 @@ async function setup(flags) {
   const skillPaths = installSkills(configDir, Boolean(flags["dry-run"]));
 
   if (flags["dry-run"]) {
-    console.log(JSON.stringify(merged, null, 2));
+    console.log(JSON.stringify(redactSecrets(merged), null, 2));
     console.log(`\nDry run only. Skills would be installed to:\n${skillPaths.map((item) => `- ${item}`).join("\n")}`);
     return;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "saycoder",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "SayCoder setup helper for OpenCode models, MCP servers, and skills.",
   "type": "module",
   "bin": {