uncompact 0.47.0 → 0.48.0

package/README.md

@@ -50,7 +50,7 @@ This installs both hooks automatically:
 - **`SessionStart`** — runs `scripts/setup.sh` which auto-installs the `uncompact` binary via `go install` if not already present.
 - **`Stop`** — runs `scripts/uncompact-hook.sh` which reinjects context after every compaction event.
 
-> **Note:** After plugin installation, authenticate once with `uncompact auth login` to connect your Supermodel API key. That's it — no manual binary install or hook setup required.
+> **Note:** After plugin installation, run `uncompact auth login` once to authenticate. This also ensures hooks are installed — no separate `uncompact install` step needed.
 
 ### CI / GitHub Actions
 
@@ -65,69 +65,48 @@ env:
 
 ## Quick Start
 
-### 1. Install
-
-**Via npm (recommended):**
-
-```bash
-# Install CLI and automatically configure Claude Code hooks
-npm install -g uncompact
-```
-
-*Note: npm might hide the configuration output. You can verify the installation with `uncompact verify-install`.*
-
-**Or run/install without global installation:**
-
-```bash
-# This will show full interactive output
-npx uncompact install
-```
-
-### 🗑 Uninstall
-
-To remove the Claude Code hooks only:
+### Via npm (recommended)
 
 ```bash
-uncompact uninstall
+npm install -g uncompact --foreground-scripts
 ```
 
-To **completely remove** Uncompact configuration and cached data:
-
-```bash
-uncompact uninstall --total
-```
+That's it. The installer downloads the binary, opens your browser for GitHub authentication, and installs the Claude Code hooks — all in one step.
 
-*Note: After running the above, you can remove the CLI itself with `npm uninstall -g uncompact`.*
+> `--foreground-scripts` is required so the interactive auth prompt is visible in your terminal.
 
-**Via Go:**
+### Via Go or manual binary
 
 ```bash
 go install github.com/supermodeltools/uncompact@latest
+# then:
+uncompact auth login
 ```
 
-**Or download a binary** from [Releases](https://github.com/supermodeltools/Uncompact/releases).
+`auth login` opens your browser for GitHub OAuth, saves your API key, and installs the Claude Code hooks automatically.
 
-### 2. Authenticate
+**Or download a binary** from [Releases](https://github.com/supermodeltools/Uncompact/releases) and run `uncompact auth login`.
+
+### Verify
 
 ```bash
-uncompact auth login
+uncompact verify-install
+uncompact run --debug
 ```
 
-This opens [dashboard.supermodeltools.com/api-keys/](https://dashboard.supermodeltools.com/api-keys/) where you can subscribe and generate an API key.
+### 🗑 Uninstall
 
-### 3. Install Claude Code Hooks
+To remove the Claude Code hooks only:
 
 ```bash
-uncompact install
+uncompact uninstall
 ```
 
-This auto-detects your Claude Code `settings.json`, shows a diff, and merges the hooks non-destructively.
-
-### 4. Verify
+To **completely remove** Uncompact configuration and cached data:
 
 ```bash
-uncompact verify-install
-uncompact run --debug
+uncompact uninstall --total
+npm uninstall -g uncompact
 ```
 
 ## CLI Reference
@@ -164,6 +143,8 @@ uncompact cache clear --project  # Clear only the current project's cache
 | Variable | Description |
 |----------|-------------|
 | `SUPERMODEL_API_KEY` | Supermodel API key (overrides config file) |
+| `UNCOMPACT_API_URL` | Override the API base URL (e.g. for staging) |
+| `UNCOMPACT_DASHBOARD_URL` | Override the dashboard base URL (e.g. for staging) |
 
 ### Config File
 
@@ -244,7 +225,7 @@ uncompact/
 |---------|--------|
 | Default TTL | 15 minutes |
 | Stale cache | Served with `⚠️ STALE` warning; fresh fetch attempted |
-| API unavailable | Serve most recent cache entry silently |
+| API unreachable | Fail fast on connection error; serve stale cache if available |
 | No cache + API down | Silent exit 0 (never blocks Claude Code) |
 | Storage growth | Auto-prune entries older than 30 days |
 | Force refresh | `--force-refresh` flag |

package/npm/install.js

@@ -187,27 +187,32 @@ async function main() {
     log(`[uncompact] Installed to ${destPath}\n\n`);
   }
 
-  // Automatically install Claude Code hooks
-  log("[uncompact] Configuring Claude Code hooks...\n");
+  // Check if already authenticated so we can decide what to run.
+  let isAuthenticated = false;
   try {
-    execFileSync(destPath, ["install", "--yes"], { stdio: "inherit" });
+    const out = execFileSync(destPath, ["auth", "status"], { stdio: "pipe" }).toString();
+    isAuthenticated = out.includes("authenticated");
   } catch (err) {
-    log("[uncompact] Note: Automatic hook configuration skipped or failed. Run manually if needed:\n");
-    log("  uncompact install\n");
+    // binary failed or not runnable — fall through to install
   }
 
-  // Show status to verify setup
-  try {
-    console.log();
-    execFileSync(destPath, ["status"], { stdio: "inherit" });
-  } catch (err) {
+  if (isAuthenticated) {
+    // Existing user (upgrade): just make sure hooks are current.
+    log("[uncompact] Already authenticated. Ensuring Claude Code hooks are installed...\n");
     try {
-      execFileSync(destPath, [], { stdio: "inherit" });
-    } catch (e) {}
+      execFileSync(destPath, ["install", "--yes"], { stdio: "inherit" });
+    } catch (err) {
+      log("[uncompact] Note: hook configuration skipped. Run 'uncompact install' manually if needed.\n");
+    }
+  } else {
+    // Fresh install: auth login handles both authentication and hook installation.
+    log("[uncompact] Starting setup...\n\n");
+    try {
+      execFileSync(destPath, ["auth", "login"], { stdio: "inherit" });
+    } catch (err) {
+      log("[uncompact] Setup skipped or failed. Run 'uncompact auth login' to complete setup.\n");
+    }
   }
-
-  log("\n");
-  log("[uncompact] To authenticate: run 'uncompact auth login'\n");
 }
 
 main().catch((err) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uncompact",
-  "version": "0.47.0",
+  "version": "0.48.0",
   "description": "Stop Claude Code compaction from making your AI stupid. Re-inject project context after compaction via the Supermodel API.",
   "author": "Supermodel <abe@supermodel.software>",
   "license": "MIT",