fix: refine postinstall logging and handle NPM quiet mode

Use a custom log function that writes to both stderr and /dev/tty
(where available) to increase the chances of visibility during
'npm install -g'. Even if NPM silences stdout, the hook installation
still runs successfully in the background.

Co-Authored-By: Grey Newell <greyshipscode@gmail.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: greynewell

README.md

@@ -70,13 +70,17 @@ env:
 **Via npm (recommended):**
 
 ```bash
+# Install CLI and automatically configure Claude Code hooks
 npm install -g uncompact
 ```
 
-Or run without installing:
+*Note: npm might hide the configuration output. You can verify the installation with `uncompact verify-install`.*
+
+**Or run/install without global installation:**
 
 ```bash
-npx uncompact --help
+# This will show full interactive output
+npx uncompact install
 ```
 
 **Via Go:**

npm/install.js

@@ -109,14 +109,27 @@ function extractZip(buffer, destDir, binaryName) {
   return extracted;
 }
 
+function log(msg) {
+  process.stderr.write(msg);
+  try {
+    if (process.platform !== "win32" && process.stdout.isTTY) {
+      const tty = fs.openSync("/dev/tty", "w");
+      fs.writeSync(tty, msg);
+      fs.closeSync(tty);
+    }
+  } catch (err) {
+    // Ignore TTY errors
+  }
+}
+
 async function main() {
   const platform = getPlatform();
   const arch = getArch();
   const assetName = getAssetName(platform, arch);
   const binaryName = getBinaryName(platform);
   const binDir = path.join(__dirname, "bin");
 
-  process.stderr.write(`[uncompact] Post-install setup for ${platform}/${arch}...\n`);
+  log(`[uncompact] Post-install setup for ${platform}/${arch}...\n`);
 
   if (!fs.existsSync(binDir)) {
     fs.mkdirSync(binDir, { recursive: true });
@@ -130,30 +143,30 @@ async function main() {
     try {
       release = await getRelease(version);
     } catch (err) {
-      process.stderr.write(`[uncompact] Failed to fetch release: ${err.message}\n`);
-      process.stderr.write(`[uncompact] You can install manually: go install github.com/${REPO_OWNER}/${REPO_NAME.toLowerCase()}@latest\n`);
+      log(`[uncompact] Failed to fetch release: ${err.message}\n`);
+      log(`[uncompact] You can install manually: go install github.com/${REPO_OWNER}/${REPO_NAME.toLowerCase()}@latest\n`);
       process.exit(0);
     }
 
     const asset = release.assets.find((a) => a.name === assetName);
     if (!asset) {
-      process.stderr.write(`[uncompact] No binary found for ${platform}/${arch} in release ${release.tag_name}\n`);
-      process.stderr.write(`[uncompact] Available assets: ${release.assets.map((a) => a.name).join(", ")}\n`);
-      process.stderr.write(`[uncompact] You can install manually: go install github.com/${REPO_OWNER}/${REPO_NAME.toLowerCase()}@latest\n`);
+      log(`[uncompact] No binary found for ${platform}/${arch} in release ${release.tag_name}\n`);
+      log(`[uncompact] Available assets: ${release.assets.map((a) => a.name).join(", ")}\n`);
+      log(`[uncompact] You can install manually: go install github.com/${REPO_OWNER}/${REPO_NAME.toLowerCase()}@latest\n`);
       process.exit(0);
     }
 
-    process.stderr.write(`[uncompact] Downloading ${BINARY_NAME} ${release.tag_name}...\n`);
+    log(`[uncompact] Downloading ${BINARY_NAME} ${release.tag_name}...\n`);
 
     let buffer;
     try {
       buffer = await httpsGet(asset.browser_download_url);
     } catch (err) {
-      process.stderr.write(`[uncompact] Failed to download: ${err.message}\n`);
+      log(`[uncompact] Failed to download: ${err.message}\n`);
       process.exit(0);
     }
 
-    process.stderr.write(`[uncompact] Extracting...\n`);
+    log(`[uncompact] Extracting...\n`);
 
     try {
       if (platform === "windows") {
@@ -162,27 +175,26 @@ async function main() {
         extractTarGz(buffer, binDir, binaryName);
       }
     } catch (err) {
-      process.stderr.write(`[uncompact] Failed to extract: ${err.message}\n`);
+      log(`[uncompact] Failed to extract: ${err.message}\n`);
       process.exit(0);
     }
 
     if (platform !== "windows") {
       fs.chmodSync(destPath, 0o755);
     }
 
-    process.stderr.write(`[uncompact] Installed to ${destPath}\n\n`);
+    log(`[uncompact] Installed to ${destPath}\n\n`);
   }
 
   // Automatically install Claude Code hooks
-  process.stderr.write("[uncompact] Configuring Claude Code hooks...\n");
+  log("[uncompact] Configuring Claude Code hooks...\n");
   try {
-    // We use "inherit" for the configuration command to ensure it shows up in the terminal
     execFileSync(destPath, ["install", "--yes"], { stdio: "inherit" });
   } catch (err) {
-    process.stderr.write("[uncompact] Note: Automatic hook configuration skipped or failed. Run manually if needed:\n");
-    process.stderr.write("  uncompact install\n");
+    log("[uncompact] Note: Automatic hook configuration skipped or failed. Run manually if needed:\n");
+    log("  uncompact install\n");
   }
-  process.stderr.write("\n");
+  log("\n");
 
   // Show help output after install
   try {