vibeusage 0.2.22 → 0.3.0

package/README.md

@@ -111,6 +111,9 @@ Initialize your environment once - VibeUsage handles all synchronization automat
 npx vibeusage init
 ```
 
+> [!IMPORTANT]
+> Starting with `vibeusage@0.3.0`, `init` is the only supported command that writes local integration config. If you upgrade from an older install layout, re-run `npx vibeusage init`; `status`, `diagnostics`, `doctor`, and `sync` will not auto-repair legacy hooks.
+
 ### Authentication Methods
 
 1. **Browser Auth** (default) - Opens browser for secure authentication
@@ -140,12 +143,14 @@ Once `init` completes, all supported CLI tools are automatically configured for
 | **Codex CLI** | `~/.codex/config.toml` | `notify` hook |
 | **Every Code** | `~/.code/config.toml` (or `CODE_HOME`) | `notify` hook |
 | **Gemini CLI** | `~/.gemini/settings.json` (or `GEMINI_HOME`) | `SessionEnd` hook |
-| **Opencode** | Global plugins | Message parser plugin |
-| **Claude Code** | `~/.claude/hooks/` | Hook configuration |
-| **OpenClaw** | Auto-links when installed | Gateway hook (requires restart) |
+| **Opencode** | OpenCode config/plugins | Message parser plugin |
+| **Claude Code** | `~/.claude/settings.json` | `Stop` + `SessionEnd` hooks |
+| **OpenClaw** | Auto-links when installed | Session plugin (requires restart) |
 
 No further intervention required! 🎉
 
+If any integration drifts later, re-run `npx vibeusage init`. The read-only commands intentionally do not rewrite local hook/plugin state.
+
 ## 💡 Usage
 
 ### Manual Sync
@@ -204,7 +209,7 @@ graph LR
     C[Gemini CLI] -->|Session Logs| G
     D[Opencode] -->|Message Logs| G
     E[Claude Code] -->|Hook Output| G
-    F[OpenClaw] -->|Gateway Hook| G
+    F[OpenClaw] -->|Session Plugin| G
     G -->|AI Tokens| H{Core Relay}
     H --> I[VibeUsage Dashboard]
     H --> J[AI Analytics Engine]
@@ -245,7 +250,7 @@ graph LR
 | **Gemini CLI** | `~/.gemini/tmp/**/chats/session-*.json` | `GEMINI_HOME` |
 | **Opencode** | `~/.opencode/messages/*.json` | - |
 | **Claude Code** | Parsed from hook output | - |
-| **OpenClaw** | Gateway hook integration | - |
+| **OpenClaw** | Session plugin integration | - |
 
 ## ⚙️ Configuration
 
@@ -374,17 +379,11 @@ This project uses **OpenSpec** for spec-driven development. Before making signif
 
 See [CLAUDE.md](CLAUDE.md) for detailed guidelines.
 
-### Architecture Validation
+### Repository Navigation
 
 ```bash
-# Validate Copy Registry
-npm run validate:copy
-
-# Generate architecture canvas
-npm run architecture:canvas
-
-# Generate focused canvas for a module
-npm run architecture:canvas:focus -- src
+# Read the repository sitemap first
+cat docs/repo-sitemap.md
 ```
 
 ## 🗺️ Roadmap

package/README.zh-CN.md

@@ -111,6 +111,9 @@ npx vibeusage init
 npx vibeusage init
 ```
 
+> [!IMPORTANT]
+> 从 `vibeusage@0.3.0` 开始，只有 `init` 会修改本地集成配置。如果你是从旧版本升级，请重新执行一次 `npx vibeusage init`；`status`、`diagnostics`、`doctor`、`sync` 都不会自动修复旧 hook 布局。
+
 ### 认证方式
 
 1. **浏览器认证**（默认）- 打开浏览器进行安全认证
@@ -141,11 +144,13 @@ npx vibeusage init [选项]
 | **Every Code** | `~/.code/config.toml`（或 `CODE_HOME`） | `notify` 钩子 |
 | **Gemini CLI** | `~/.gemini/settings.json`（或 `GEMINI_HOME`） | `SessionEnd` 钩子 |
 | **Opencode** | 全局插件 | 消息解析器插件 |
-| **Claude Code** | `~/.claude/hooks/` | 钩子配置 |
-| **OpenClaw** | 安装时自动链接 | Gateway 钩子（需要重启） |
+| **Claude Code** | `~/.claude/settings.json` | `Stop` + `SessionEnd` 钩子 |
+| **OpenClaw** | 安装时自动链接 | Session plugin（需要重启） |
 
 无需进一步操作！🎉
 
+如果后续某个集成出现漂移，请重新执行 `npx vibeusage init`。只读命令不会重写本地 hook/plugin 状态。
+
 ## 💡 使用方法
 
 ### 手动同步

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibeusage",
-  "version": "0.2.22",
+  "version": "0.3.0",
   "description": "Codex CLI token usage tracker (macOS-first, notify-driven).",
   "license": "MIT",
   "bin": {
@@ -19,9 +19,6 @@
     "access": "public"
   },
   "scripts": {
-    "architecture:canvas": "node scripts/ops/architecture-canvas.cjs",
-    "architecture:canvas:focus": "node scripts/ops/architecture-canvas.cjs --focus",
-    "architecture:canvas:list-modules": "node scripts/ops/architecture-canvas.cjs --list-modules",
     "build:insforge": "node scripts/build-insforge-functions.cjs",
     "build:insforge:check": "node scripts/build-insforge-functions.cjs --check",
     "ci:local": "npm test && npm run validate:copy && npm run validate:ui-hardcode && npm run validate:guardrails && node --test test/architecture-guardrails.test.js && npm run build:insforge:check && npm --prefix dashboard run build",
@@ -32,12 +29,14 @@
     "dashboard:preview": "npm --prefix dashboard run preview",
     "dev:shim": "node scripts/dev-bin-shim.cjs",
     "graph:auto-index": "node scripts/graph/auto-index.cjs",
+    "review:preflight": "npm run validate:pr-risk-layer --",
     "graph:scip": "node scripts/graph/generate-scip.cjs",
     "smoke": "node scripts/smoke/insforge-smoke.cjs",
-    "test": "node --test test/*.test.js",
+    "test": "node --test --test-concurrency=1 test/*.test.js",
     "validate:copy": "node scripts/validate-copy-registry.cjs",
     "validate:guardrails": "node scripts/validate-architecture-guardrails.cjs",
     "validate:insforge2-db": "node scripts/ops/insforge2-db-validate.cjs",
+    "validate:pr-risk-layer": "node scripts/ops/pr-risk-layer-gate.cjs --config scripts/ops/pr-risk-layer-gate.config.json",
     "validate:retros": "node scripts/validate-retros.cjs",
     "validate:ui-hardcode": "node scripts/ops/validate-ui-hardcode.cjs"
   },

package/src/cli.js

@@ -4,7 +4,6 @@ const { cmdStatus } = require("./commands/status");
 const { cmdDiagnostics } = require("./commands/diagnostics");
 const { cmdDoctor } = require("./commands/doctor");
 const { cmdUninstall } = require("./commands/uninstall");
-const { cmdActivateIfNeeded } = require("./commands/activate-if-needed");
 
 async function run(argv) {
   const [command, ...rest] = argv;
@@ -33,9 +32,6 @@ async function run(argv) {
     case "uninstall":
       await cmdUninstall(rest);
       return;
-    case "activate-if-needed":
-      await cmdActivateIfNeeded(rest);
-      return;
     default:
       throw new Error(`Unknown command: ${command}`);
   }
@@ -61,11 +57,11 @@ function printHelp() {
       "  - --dry-run previews changes without writing files.",
       "  - optional: --link-code <code> skips browser login when provided by Dashboard.",
       "  - Every Code notify installs when ~/.code/config.toml exists.",
-      "  - OpenClaw hook auto-links when OpenClaw is installed (requires gateway restart).",
+      "  - OpenClaw session plugin auto-links when OpenClaw is installed (requires gateway restart).",
       "  - auto sync waits for a device token.",
       "  - optional: VIBEUSAGE_DASHBOARD_URL or --dashboard-url for hosted landing.",
       "  - sync parses ~/.codex/sessions/**/rollout-*.jsonl and ~/.code/sessions/**/rollout-*.jsonl, then uploads token deltas.",
-      "  - --from-openclaw marks sync runs triggered by OpenClaw hooks.",
+      "  - --from-openclaw marks sync runs triggered by OpenClaw session plugin events.",
       "  - --debug shows original backend errors.",
       "",
     ].join("\n"),

package/src/commands/init.js

@@ -13,34 +13,6 @@ const {
   chmod600IfPossible,
 } = require("../lib/fs");
 const { prompt, promptHidden } = require("../lib/prompt");
-const {
-  upsertCodexNotify,
-  upsertEveryCodeNotify,
-  readCodexNotify,
-  readEveryCodeNotify,
-} = require("../lib/codex-config");
-const {
-  upsertClaudeHook,
-  buildClaudeHookCommand,
-  isClaudeHookConfigured,
-} = require("../lib/claude-config");
-const {
-  resolveGeminiConfigDir,
-  resolveGeminiSettingsPath,
-  buildGeminiHookCommand,
-  upsertGeminiHook,
-  isGeminiHookConfigured,
-} = require("../lib/gemini-config");
-const {
-  resolveOpencodeConfigDir,
-  upsertOpencodePlugin,
-  isOpencodePluginInstalled,
-} = require("../lib/opencode-config");
-const { removeOpenclawHookConfig, probeOpenclawHookState } = require("../lib/openclaw-hook");
-const {
-  installOpenclawSessionPlugin,
-  probeOpenclawSessionPluginState,
-} = require("../lib/openclaw-session-plugin");
 const { beginBrowserAuth, openInBrowser } = require("../lib/browser-auth");
 const {
   issueDeviceTokenWithPassword,
@@ -60,6 +32,13 @@ const {
   createSpinner,
 } = require("../lib/cli-ui");
 const { renderLocalReport, renderAuthTransition, renderSuccessBox } = require("../lib/init-flow");
+const {
+  createIntegrationContext,
+  installIntegrations,
+  probeIntegrations,
+  summarizeProbeForInitPreview,
+} = require("../lib/integrations");
+const { DEFAULT_DASHBOARD_URL } = require("../shared/runtime-defaults.cjs");
 
 const ASCII_LOGO = [
   "██╗   ██╗██╗██████╗ ███████╗██╗   ██╗███████╗ █████╗  ██████╗ ███████╗",
@@ -71,16 +50,13 @@ const ASCII_LOGO = [
 ].join("\n");
 
 const DIVIDER = "----------------------------------------------";
-const DEFAULT_DASHBOARD_URL = "https://www.vibeusage.cc";
-
 async function cmdInit(argv) {
   const opts = parseArgs(argv);
   const home = os.homedir();
 
-  const { rootDir, trackerDir, binDir } = await resolveTrackerPaths({ home });
+  const { trackerDir, binDir } = await resolveTrackerPaths({ home });
 
   const configPath = path.join(trackerDir, "config.json");
-  const notifyOriginalPath = path.join(trackerDir, "codex_notify_original.json");
   const linkCodeStatePath = path.join(trackerDir, "link_code_state.json");
 
   const existingConfig = await readJson(configPath);
@@ -144,7 +120,6 @@ async function cmdInit(argv) {
       trackerDir,
       binDir,
       configPath,
-      notifyOriginalPath,
       linkCodeStatePath,
       notifyPath,
       appDir,
@@ -253,8 +228,14 @@ function shouldUseBrowserAuth({ deviceToken, opts }) {
 async function buildDryRunSummary({ opts, home, trackerDir, notifyPath, runtime }) {
   const deviceToken = runtime?.deviceToken || null;
   const pendingBrowserAuth = shouldUseBrowserAuth({ deviceToken, opts });
-  const context = buildIntegrationTargets({ home, trackerDir, notifyPath });
-  const summary = await previewIntegrations({ context });
+  const context = await createIntegrationContext({
+    home,
+    env: process.env,
+    trackerPaths: { trackerDir, binDir: path.dirname(notifyPath), rootDir: path.dirname(trackerDir) },
+    notifyPath,
+  });
+  const probe = await probeIntegrations(context);
+  const summary = probe.map((item) => summarizeProbeForInitPreview(item));
   return { summary, pendingBrowserAuth, deviceToken };
 }
 
@@ -265,7 +246,6 @@ async function runSetup({
   trackerDir,
   binDir,
   configPath,
-  notifyOriginalPath,
   linkCodeStatePath,
   notifyPath,
   appDir,
@@ -341,12 +321,13 @@ async function runSetup({
   );
   await fs.chmod(notifyPath, 0o755).catch(() => {});
 
-  const summary = await applyIntegrationSetup({
+  const integrationContext = await createIntegrationContext({
     home,
-    trackerDir,
+    env: process.env,
+    trackerPaths: { trackerDir, binDir, rootDir: path.dirname(trackerDir) },
     notifyPath,
-    notifyOriginalPath,
   });
+  const summary = await installIntegrations(integrationContext);
 
   return {
     summary,
@@ -357,307 +338,6 @@ async function runSetup({
   };
 }
 
-function buildIntegrationTargets({ home, trackerDir, notifyPath }) {
-  const codexHome = process.env.CODEX_HOME || path.join(home, ".codex");
-  const codexConfigPath = path.join(codexHome, "config.toml");
-  const codeHome = process.env.CODE_HOME || path.join(home, ".code");
-  const codeConfigPath = path.join(codeHome, "config.toml");
-  const notifyOriginalPath = path.join(trackerDir, "codex_notify_original.json");
-  const codeNotifyOriginalPath = path.join(trackerDir, "code_notify_original.json");
-  const notifyCmd = ["/usr/bin/env", "node", notifyPath];
-  const codeNotifyCmd = ["/usr/bin/env", "node", notifyPath, "--source=every-code"];
-  const claudeDir = path.join(home, ".claude");
-  const claudeSettingsPath = path.join(claudeDir, "settings.json");
-  const claudeHookCommand = buildClaudeHookCommand(notifyPath);
-  const geminiConfigDir = resolveGeminiConfigDir({ home, env: process.env });
-  const geminiSettingsPath = resolveGeminiSettingsPath({ configDir: geminiConfigDir });
-  const geminiHookCommand = buildGeminiHookCommand(notifyPath);
-  const opencodeConfigDir = resolveOpencodeConfigDir({ home, env: process.env });
-
-  return {
-    trackerDir,
-    codexConfigPath,
-    codeConfigPath,
-    notifyOriginalPath,
-    codeNotifyOriginalPath,
-    notifyCmd,
-    codeNotifyCmd,
-    claudeDir,
-    claudeSettingsPath,
-    claudeHookCommand,
-    geminiConfigDir,
-    geminiSettingsPath,
-    geminiHookCommand,
-    opencodeConfigDir,
-  };
-}
-
-async function applyIntegrationSetup({ home, trackerDir, notifyPath, notifyOriginalPath }) {
-  const context = buildIntegrationTargets({ home, trackerDir, notifyPath });
-  context.notifyOriginalPath = notifyOriginalPath;
-
-  const summary = [];
-
-  const codexProbe = await probeFile(context.codexConfigPath);
-  if (codexProbe.exists) {
-    const result = await upsertCodexNotify({
-      codexConfigPath: context.codexConfigPath,
-      notifyCmd: context.notifyCmd,
-      notifyOriginalPath: context.notifyOriginalPath,
-    });
-    summary.push({
-      label: "Codex CLI",
-      status: result.changed ? "updated" : "set",
-      detail: result.changed ? "Updated config" : "Config already set",
-    });
-  } else {
-    summary.push({ label: "Codex CLI", status: "skipped", detail: renderSkipDetail(codexProbe) });
-  }
-
-  const claudeDirExists = await isDir(context.claudeDir);
-  if (claudeDirExists) {
-    await upsertClaudeHook({
-      settingsPath: context.claudeSettingsPath,
-      hookCommand: context.claudeHookCommand,
-    });
-    summary.push({ label: "Claude", status: "installed", detail: "Hooks installed" });
-  } else {
-    summary.push({ label: "Claude", status: "skipped", detail: "Config not found" });
-  }
-
-  const geminiConfigExists = await isDir(context.geminiConfigDir);
-  if (geminiConfigExists) {
-    await upsertGeminiHook({
-      settingsPath: context.geminiSettingsPath,
-      hookCommand: context.geminiHookCommand,
-    });
-    summary.push({ label: "Gemini", status: "installed", detail: "Hooks installed" });
-  } else {
-    summary.push({ label: "Gemini", status: "skipped", detail: "Config not found" });
-  }
-
-  const opencodeResult = await upsertOpencodePlugin({
-    configDir: context.opencodeConfigDir,
-    notifyPath,
-  });
-  if (opencodeResult?.skippedReason === "config-missing") {
-    summary.push({ label: "Opencode Plugin", status: "skipped", detail: "Config not found" });
-  } else {
-    summary.push({
-      label: "Opencode Plugin",
-      status: opencodeResult?.changed ? "installed" : "set",
-      detail: "Plugin installed",
-    });
-  }
-
-  const openclawBefore = await probeOpenclawSessionPluginState({
-    home,
-    trackerDir,
-    env: process.env,
-  });
-  const openclawInstall = await installOpenclawSessionPlugin({
-    home,
-    trackerDir,
-    packageName: "vibeusage",
-    env: process.env,
-  });
-  if (openclawInstall?.skippedReason === "openclaw-cli-missing") {
-    summary.push({
-      label: "OpenClaw Session Plugin",
-      status: "skipped",
-      detail: "OpenClaw CLI not found",
-    });
-  } else if (openclawInstall?.skippedReason === "openclaw-plugins-install-failed") {
-    summary.push({
-      label: "OpenClaw Session Plugin",
-      status: "skipped",
-      detail: `Install failed${openclawInstall.error ? `: ${openclawInstall.error}` : ""}`,
-    });
-  } else if (openclawInstall?.skippedReason === "openclaw-config-unreadable") {
-    summary.push({
-      label: "OpenClaw Session Plugin",
-      status: "skipped",
-      detail: openclawInstall.error
-        ? `OpenClaw config unreadable: ${openclawInstall.error}`
-        : "OpenClaw config unreadable",
-    });
-  } else if (openclawInstall?.configured) {
-    summary.push({
-      label: "OpenClaw Session Plugin",
-      status: openclawBefore?.configured ? "set" : "installed",
-      detail: openclawBefore?.configured
-        ? "Session plugin already linked"
-        : "Session plugin linked (restart OpenClaw gateway to activate)",
-    });
-  } else {
-    summary.push({
-      label: "OpenClaw Session Plugin",
-      status: "skipped",
-      detail: "OpenClaw session plugin unavailable",
-    });
-  }
-
-  const legacyHookState = await probeOpenclawHookState({ home, trackerDir, env: process.env });
-  if (legacyHookState?.configured || legacyHookState?.linked || legacyHookState?.enabled) {
-    await removeOpenclawHookConfig({ home, trackerDir, env: process.env });
-    summary.push({
-      label: "OpenClaw Hook (legacy)",
-      status: "updated",
-      detail: "Removed legacy command hook (migrated to session plugin)",
-    });
-  }
-
-  const codeProbe = await probeFile(context.codeConfigPath);
-  if (codeProbe.exists) {
-    const result = await upsertEveryCodeNotify({
-      codeConfigPath: context.codeConfigPath,
-      notifyCmd: context.codeNotifyCmd,
-      notifyOriginalPath: context.codeNotifyOriginalPath,
-    });
-    summary.push({
-      label: "Every Code",
-      status: result.changed ? "updated" : "set",
-      detail: result.changed ? "Updated config" : "Config already set",
-    });
-  } else {
-    summary.push({ label: "Every Code", status: "skipped", detail: renderSkipDetail(codeProbe) });
-  }
-
-  return summary;
-}
-
-async function previewIntegrations({ context }) {
-  const summary = [];
-  const home = os.homedir();
-
-  const codexProbe = await probeFile(context.codexConfigPath);
-  if (codexProbe.exists) {
-    const existing = await readCodexNotify(context.codexConfigPath);
-    const matches = arraysEqual(existing, context.notifyCmd);
-    summary.push({
-      label: "Codex CLI",
-      status: matches ? "set" : "updated",
-      detail: matches ? "Already configured" : "Will update config",
-    });
-  } else {
-    summary.push({ label: "Codex CLI", status: "skipped", detail: renderSkipDetail(codexProbe) });
-  }
-
-  const claudeDirExists = await isDir(context.claudeDir);
-  if (claudeDirExists) {
-    const configured = await isClaudeHookConfigured({
-      settingsPath: context.claudeSettingsPath,
-      hookCommand: context.claudeHookCommand,
-    });
-    summary.push({
-      label: "Claude",
-      status: "installed",
-      detail: configured ? "Hooks already installed" : "Will install hooks",
-    });
-  } else {
-    summary.push({ label: "Claude", status: "skipped", detail: "Config not found" });
-  }
-
-  const geminiConfigExists = await isDir(context.geminiConfigDir);
-  if (geminiConfigExists) {
-    const configured = await isGeminiHookConfigured({
-      settingsPath: context.geminiSettingsPath,
-      hookCommand: context.geminiHookCommand,
-    });
-    summary.push({
-      label: "Gemini",
-      status: "installed",
-      detail: configured ? "Hooks already installed" : "Will install hooks",
-    });
-  } else {
-    summary.push({ label: "Gemini", status: "skipped", detail: "Config not found" });
-  }
-
-  const opencodeDirExists = await isDir(context.opencodeConfigDir);
-  const installed = await isOpencodePluginInstalled({ configDir: context.opencodeConfigDir });
-  const opencodeDetail = installed
-    ? "Plugin already installed"
-    : opencodeDirExists
-      ? "Will install plugin"
-      : "Will create config and install plugin";
-  summary.push({
-    label: "Opencode Plugin",
-    status: "installed",
-    detail: opencodeDetail,
-  });
-
-  const openclawState = await probeOpenclawSessionPluginState({
-    home,
-    trackerDir: context.trackerDir,
-    env: process.env,
-  });
-  if (openclawState?.skippedReason === "openclaw-config-missing") {
-    summary.push({
-      label: "OpenClaw Session Plugin",
-      status: "skipped",
-      detail: "OpenClaw config not found",
-    });
-  } else if (openclawState?.skippedReason === "openclaw-config-unreadable") {
-    summary.push({
-      label: "OpenClaw Session Plugin",
-      status: "skipped",
-      detail: openclawState.error
-        ? `OpenClaw config unreadable: ${openclawState.error}`
-        : "OpenClaw config unreadable",
-    });
-  } else {
-    summary.push({
-      label: "OpenClaw Session Plugin",
-      status: openclawState?.configured ? "set" : "installed",
-      detail: openclawState?.configured
-        ? "Session plugin already linked"
-        : "Will link session plugin (restart OpenClaw gateway to activate)",
-    });
-  }
-
-  const legacyHookState = await probeOpenclawHookState({
-    home,
-    trackerDir: context.trackerDir,
-    env: process.env,
-  });
-  if (legacyHookState?.configured || legacyHookState?.linked || legacyHookState?.enabled) {
-    summary.push({
-      label: "OpenClaw Hook (legacy)",
-      status: "updated",
-      detail: "Will remove legacy command hook during migration",
-    });
-  }
-
-  const codeProbe = await probeFile(context.codeConfigPath);
-  if (codeProbe.exists) {
-    const existing = await readEveryCodeNotify(context.codeConfigPath);
-    const matches = arraysEqual(existing, context.codeNotifyCmd);
-    summary.push({
-      label: "Every Code",
-      status: matches ? "set" : "updated",
-      detail: matches ? "Already configured" : "Will update config",
-    });
-  } else {
-    summary.push({ label: "Every Code", status: "skipped", detail: renderSkipDetail(codeProbe) });
-  }
-
-  return summary;
-}
-
-function renderSkipDetail(probe) {
-  if (!probe || probe.reason === "missing") return "Config not found";
-  if (probe.reason === "permission-denied") return "Permission denied";
-  if (probe.reason === "not-file") return "Invalid config";
-  return "Unavailable";
-}
-
-function arraysEqual(a, b) {
-  if (!Array.isArray(a) || !Array.isArray(b)) return false;
-  if (a.length !== b.length) return false;
-  for (let i = 0; i < a.length; i++) if (a[i] !== b[i]) return false;
-  return true;
-}
-
 function parseArgs(argv) {
   const out = {
     baseUrl: null,
@@ -853,28 +533,6 @@ function isSelfNotify(cmd) {
 
 module.exports = { cmdInit };
 
-async function probeFile(p) {
-  try {
-    const st = await fs.stat(p);
-    if (st.isFile()) return { exists: true, reason: null };
-    return { exists: false, reason: "not-file" };
-  } catch (e) {
-    if (e?.code === "ENOENT" || e?.code === "ENOTDIR") return { exists: false, reason: "missing" };
-    if (e?.code === "EACCES" || e?.code === "EPERM")
-      return { exists: false, reason: "permission-denied" };
-    return { exists: false, reason: "error", code: e?.code || "unknown" };
-  }
-}
-
-async function isDir(p) {
-  try {
-    const st = await fs.stat(p);
-    return st.isDirectory();
-  } catch (_e) {
-    return false;
-  }
-}
-
 async function installLocalTrackerApp({ appDir }) {
   // Copy the current package's runtime (bin + src) into ~/.vibeusage so notify can run sync without npx.
   const packageRoot = path.resolve(__dirname, "../..");