vibeusage 0.2.20 → 0.2.22

package/package.json

@@ -1,55 +1,57 @@
 {
   "name": "vibeusage",
-  "version": "0.2.20",
+  "version": "0.2.22",
   "description": "Codex CLI token usage tracker (macOS-first, notify-driven).",
   "license": "MIT",
+  "bin": {
+    "tracker": "bin/tracker.js",
+    "vibeusage": "bin/tracker.js",
+    "vibeusage-tracker": "bin/tracker.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "LICENSE",
+    "README.md"
+  ],
+  "type": "commonjs",
   "publishConfig": {
     "access": "public"
   },
-  "type": "commonjs",
   "scripts": {
-    "test": "node --test test/*.test.js",
-    "smoke": "node scripts/smoke/insforge-smoke.cjs",
+    "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",
-    "dashboard:dev": "npm --prefix dashboard run dev",
+    "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",
+    "copy:pull": "node scripts/copy-sync.cjs pull",
+    "copy:push": "node scripts/copy-sync.cjs push",
     "dashboard:build": "npm --prefix dashboard run build",
+    "dashboard:dev": "npm --prefix dashboard run dev",
     "dashboard:preview": "npm --prefix dashboard run preview",
     "dev:shim": "node scripts/dev-bin-shim.cjs",
+    "graph:auto-index": "node scripts/graph/auto-index.cjs",
+    "graph:scip": "node scripts/graph/generate-scip.cjs",
+    "smoke": "node scripts/smoke/insforge-smoke.cjs",
+    "test": "node --test test/*.test.js",
     "validate:copy": "node scripts/validate-copy-registry.cjs",
-    "validate:ui-hardcode": "node scripts/ops/validate-ui-hardcode.cjs",
-    "copy:pull": "node scripts/copy-sync.cjs pull",
-    "copy:push": "node scripts/copy-sync.cjs push",
-    "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",
     "validate:guardrails": "node scripts/validate-architecture-guardrails.cjs",
     "validate:insforge2-db": "node scripts/ops/insforge2-db-validate.cjs",
-    "graph:scip": "node scripts/graph/generate-scip.cjs",
-    "graph:auto-index": "node scripts/graph/auto-index.cjs"
+    "validate:retros": "node scripts/validate-retros.cjs",
+    "validate:ui-hardcode": "node scripts/ops/validate-ui-hardcode.cjs"
   },
-  "bin": {
-    "tracker": "bin/tracker.js",
-    "vibeusage": "bin/tracker.js",
-    "vibeusage-tracker": "bin/tracker.js"
-  },
-  "files": [
-    "bin/",
-    "src/",
-    "LICENSE",
-    "README.md"
-  ],
-  "engines": {
-    "node": "20.x"
+  "dependencies": {
+    "@insforge/sdk": "^1.0.4"
   },
   "devDependencies": {
     "@sourcegraph/scip-typescript": "^0.3.6",
     "esbuild": "0.27.2"
   },
-  "dependencies": {
-    "@insforge/sdk": "^1.0.4"
-  },
   "bundledDependencies": [
     "@insforge/sdk"
-  ]
+  ],
+  "engines": {
+    "node": "20.x"
+  }
 }

package/src/cli.js

@@ -1,37 +1,41 @@
-const { cmdInit } = require('./commands/init');
-const { cmdSync } = require('./commands/sync');
-const { cmdStatus } = require('./commands/status');
-const { cmdDiagnostics } = require('./commands/diagnostics');
-const { cmdDoctor } = require('./commands/doctor');
-const { cmdUninstall } = require('./commands/uninstall');
+const { cmdInit } = require("./commands/init");
+const { cmdSync } = require("./commands/sync");
+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;
 
-  if (!command || command === '-h' || command === '--help') {
+  if (!command || command === "-h" || command === "--help") {
     printHelp();
     return;
   }
 
   switch (command) {
-    case 'init':
+    case "init":
       await cmdInit(rest);
       return;
-    case 'sync':
+    case "sync":
       await cmdSync(rest);
       return;
-    case 'status':
+    case "status":
       await cmdStatus(rest);
       return;
-    case 'diagnostics':
+    case "diagnostics":
       await cmdDiagnostics(rest);
       return;
-    case 'doctor':
+    case "doctor":
       await cmdDoctor(rest);
       return;
-    case 'uninstall':
+    case "uninstall":
       await cmdUninstall(rest);
       return;
+    case "activate-if-needed":
+      await cmdActivateIfNeeded(rest);
+      return;
     default:
       throw new Error(`Unknown command: ${command}`);
   }
@@ -41,30 +45,30 @@ function printHelp() {
   // Keep this short; npx users want quick guidance.
   process.stdout.write(
     [
-      'vibeusage',
-      '',
-      'Usage:',
-      '  npx vibeusage [--debug] init [--yes] [--dry-run] [--no-open] [--link-code <code>]',
-      '  npx vibeusage [--debug] sync [--auto] [--drain] [--from-openclaw]',
-      '  npx vibeusage [--debug] status [--probe-keychain] [--probe-keychain-details]',
-      '  npx vibeusage [--debug] diagnostics [--out diagnostics.json]',
-      '  npx vibeusage [--debug] doctor [--json] [--out doctor.json] [--base-url <url>]',
-      '  npx vibeusage [--debug] uninstall [--purge]',
-      '',
-      'Notes:',
-      '  - init: consent first, local setup next, browser sign-in last.',
-      '  - --yes skips the consent menu (non-interactive safe).',
-      '  - --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).',
-      '  - 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.',
-      '  - --debug shows original backend errors.',
-      ''
-    ].join('\n')
+      "vibeusage",
+      "",
+      "Usage:",
+      "  npx vibeusage [--debug] init [--yes] [--dry-run] [--no-open] [--link-code <code>]",
+      "  npx vibeusage [--debug] sync [--auto] [--drain] [--from-openclaw]",
+      "  npx vibeusage [--debug] status [--probe-keychain] [--probe-keychain-details]",
+      "  npx vibeusage [--debug] diagnostics [--out diagnostics.json]",
+      "  npx vibeusage [--debug] doctor [--json] [--out doctor.json] [--base-url <url>]",
+      "  npx vibeusage [--debug] uninstall [--purge]",
+      "",
+      "Notes:",
+      "  - init: consent first, local setup next, browser sign-in last.",
+      "  - --yes skips the consent menu (non-interactive safe).",
+      "  - --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).",
+      "  - 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.",
+      "  - --debug shows original backend errors.",
+      "",
+    ].join("\n"),
   );
 }
 

package/src/commands/activate-if-needed.js

@@ -0,0 +1,41 @@
+const { checkAndActivate } = require("../lib/activation-check");
+
+/**
+ * 检测并激活未配置的 AI CLI 集成
+ * 用于 hooks 或其他触发器调用
+ */
+async function cmdActivateIfNeeded(argv) {
+  const opts = parseArgs(argv);
+  
+  const results = await checkAndActivate({
+    silent: opts.silent,
+    autoConfigure: true,
+  });
+  
+  if (!opts.silent) {
+    if (results.length === 0) {
+      console.log("所有 AI CLI 集成已配置完成");
+    } else {
+      for (const r of results) {
+        const icon = r.action === "configured" ? "✅" : "❌";
+        console.log(`${icon} ${r.displayName}: ${r.action}`);
+      }
+    }
+  }
+  
+  // 如果有任何配置成功，返回 0，否则返回 1
+  const hasSuccess = results.some(r => r.action === "configured");
+  process.exitCode = hasSuccess ? 0 : 0; // 始终返回 0，不阻塞调用方
+}
+
+function parseArgs(argv) {
+  const out = {
+    silent: false,
+  };
+  for (const a of argv) {
+    if (a === "--silent") out.silent = true;
+  }
+  return out;
+}
+
+module.exports = { cmdActivateIfNeeded };

package/src/commands/diagnostics.js

@@ -1,12 +1,12 @@
-const path = require('node:path');
+const path = require("node:path");
 
-const { writeFileAtomic, chmod600IfPossible } = require('../lib/fs');
-const { collectTrackerDiagnostics } = require('../lib/diagnostics');
+const { writeFileAtomic, chmod600IfPossible } = require("../lib/fs");
+const { collectTrackerDiagnostics } = require("../lib/diagnostics");
 
 async function cmdDiagnostics(argv = []) {
   const opts = parseArgs(argv);
   const diagnostics = await collectTrackerDiagnostics();
-  const json = JSON.stringify(diagnostics, null, opts.compact ? 0 : 2) + '\n';
+  const json = JSON.stringify(diagnostics, null, opts.compact ? 0 : 2) + "\n";
 
   if (opts.out) {
     const outPath = path.resolve(process.cwd(), opts.out);
@@ -21,14 +21,14 @@ async function cmdDiagnostics(argv = []) {
 function parseArgs(argv) {
   const out = {
     out: null,
-    compact: false
+    compact: false,
   };
 
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i];
-    if (a === '--out') out.out = argv[++i] || null;
-    else if (a === '--compact') out.compact = true;
-    else if (a === '--pretty') out.compact = false;
+    if (a === "--out") out.out = argv[++i] || null;
+    else if (a === "--compact") out.compact = true;
+    else if (a === "--pretty") out.compact = false;
     else throw new Error(`Unknown option: ${a}`);
   }
 
@@ -36,4 +36,3 @@ function parseArgs(argv) {
 }
 
 module.exports = { cmdDiagnostics };
-

package/src/commands/doctor.js

@@ -1,21 +1,26 @@
-const os = require('node:os');
-const path = require('node:path');
+const os = require("node:os");
+const path = require("node:path");
 
-const { readJsonStrict, writeFileAtomic, chmod600IfPossible } = require('../lib/fs');
-const { resolveTrackerPaths } = require('../lib/tracker-paths');
-const { collectTrackerDiagnostics } = require('../lib/diagnostics');
-const { resolveRuntimeConfig } = require('../lib/runtime-config');
-const { buildDoctorReport } = require('../lib/doctor');
+const { readJsonStrict, writeFileAtomic, chmod600IfPossible } = require("../lib/fs");
+const { resolveTrackerPaths } = require("../lib/tracker-paths");
+const { collectTrackerDiagnostics } = require("../lib/diagnostics");
+const { resolveRuntimeConfig } = require("../lib/runtime-config");
+const { buildDoctorReport } = require("../lib/doctor");
 
 async function cmdDoctor(argv = []) {
   const opts = parseArgs(argv);
   const home = os.homedir();
   const { trackerDir } = await resolveTrackerPaths({ home });
-  const configPath = path.join(trackerDir, 'config.json');
+  const configPath = path.join(trackerDir, "config.json");
 
   const configStatus = await readJsonStrict(configPath);
-  const config = configStatus.status === 'ok' && isPlainObject(configStatus.value) ? configStatus.value : {};
-  const runtime = resolveRuntimeConfig({ cli: { baseUrl: opts.baseUrl }, config, env: process.env });
+  const config =
+    configStatus.status === "ok" && isPlainObject(configStatus.value) ? configStatus.value : {};
+  const runtime = resolveRuntimeConfig({
+    cli: { baseUrl: opts.baseUrl },
+    config,
+    env: process.env,
+  });
   const diagnostics = await collectTrackerDiagnostics({ home });
   const cliPath = process.argv[1] ? path.resolve(process.argv[1]) : null;
 
@@ -26,12 +31,12 @@ async function cmdDoctor(argv = []) {
     paths: {
       trackerDir,
       configPath,
-      cliPath
-    }
+      cliPath,
+    },
   });
 
   const jsonOutput = opts.json || Boolean(opts.out);
-  const payload = JSON.stringify(report, null, jsonOutput ? 2 : 0) + '\n';
+  const payload = JSON.stringify(report, null, jsonOutput ? 2 : 0) + "\n";
 
   if (opts.out) {
     const outPath = path.resolve(process.cwd(), opts.out);
@@ -55,9 +60,9 @@ function parseArgs(argv) {
   const out = { json: false, out: null, baseUrl: null };
   for (let i = 0; i < argv.length; i += 1) {
     const arg = argv[i];
-    if (arg === '--json') out.json = true;
-    else if (arg === '--out') out.out = argv[++i] || null;
-    else if (arg === '--base-url') out.baseUrl = argv[++i] || null;
+    if (arg === "--json") out.json = true;
+    else if (arg === "--out") out.out = argv[++i] || null;
+    else if (arg === "--base-url") out.baseUrl = argv[++i] || null;
     else throw new Error(`Unknown option: ${arg}`);
   }
   return out;
@@ -65,27 +70,27 @@ function parseArgs(argv) {
 
 function renderHumanReport(report) {
   const lines = [];
-  lines.push('Doctor report');
-  lines.push('');
+  lines.push("Doctor report");
+  lines.push("");
   for (const check of report.checks || []) {
     lines.push(formatCheckLine(check));
   }
-  lines.push('');
+  lines.push("");
   lines.push(
-    `Summary: ok ${report.summary.ok} | warn ${report.summary.warn} | fail ${report.summary.fail} | critical ${report.summary.critical}`
+    `Summary: ok ${report.summary.ok} | warn ${report.summary.warn} | fail ${report.summary.fail} | critical ${report.summary.critical}`,
   );
-  lines.push('');
-  return lines.join('\n');
+  lines.push("");
+  return lines.join("\n");
 }
 
 function formatCheckLine(check = {}) {
-  const status = String(check.status || 'unknown').toUpperCase();
-  const detail = check.detail ? ` - ${check.detail}` : '';
-  return `- [${status}] ${check.id || 'unknown'}${detail}`;
+  const status = String(check.status || "unknown").toUpperCase();
+  const detail = check.detail ? ` - ${check.detail}` : "";
+  return `- [${status}] ${check.id || "unknown"}${detail}`;
 }
 
 function isPlainObject(value) {
-  return Boolean(value && typeof value === 'object' && !Array.isArray(value));
+  return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 
 module.exports = { cmdDoctor };