vg-coder-cli 2.0.71 → 2.0.73

package/INTEGRATION.md

@@ -219,6 +219,8 @@ Server có thể chủ động list / đóng / mở tab AI Studio trong từng p
 | `POST` | `/api/launcher/open-tab` | `{ chromeId? \| workerLabel?, model?, url?, active? }` | Mở tab mới. `model` mặc định `gemini-3-flash-preview`. Response v2.0.52+ kèm `requested_model` / `actual_model` / `fallback_occurred` (URL-based, **không reliable** với AI Studio versions mới — xem note) |
 | `GET` | `/api/launcher/debug` | `?chromeId=<uuid>` \| `?workerLabel=<email>` (optional) | Dump launcher SW state: `swChromeId`, `syncStorage`, `localStorage`, AI Studio tabs, windows count, runtime info. Bỏ pin → broadcast all launchers. (v2.0.65+) |
 | `POST` | `/api/launcher/exec` | `{ chromeId? \| workerLabel? \| all?, cmd, args?, timeoutMs? }` | Chạy 1 lệnh `chrome.*` đã định nghĩa sẵn trong launcher SW. (v2.0.66+, thay cho `eval` bị Manifest V3 CSP chặn) |
+| `POST` | `/api/launcher/wait-ready` | `{ chromeId, timeoutMs?, requireEmail?, requireWorker? }` | Block sync cho đến khi launcher có email scraped + ≥1 idle worker. Thay 2 vòng poll bằng 1 call. (v2.0.68+) |
+| `GET` | `/api/worker/extension-info` | `?chromeId=<uuid>` \| `?workerLabel=<email>` | Dump extension metadata (`installType`, `version`, `permissions`, `hostPermissions`) qua content-script. Dùng để diagnose duplicate installs (Load Unpacked vs Web Store). (v2.0.71+) |
 
 **Pin precedence**: `chromeId` > `workerLabel` > default. `chromeId` chỉ exact-match một
 launcher cụ thể — dùng để address **profile chưa bind email** (mới cài extension,
@@ -364,6 +366,109 @@ Pattern recommend cho client: bỏ qua `actual_model` ở open-tab response, ki
 tra `task.result.actualModel === requested_model` sau mỗi task done. Nếu khác
 → AI Studio đã silently fallback, retry với model khác hoặc fail-fast.
 
+### Sync ready check — `/api/launcher/wait-ready` (v2.0.68+)
+
+Thay vì 2 vòng poll (`/api/launchers` để chờ email scrape + `/api/workers` để
+chờ worker idle), endpoint này block 1 lần đến khi launcher sẵn sàng dispatch
+task. Counter pattern thông thường:
+
+```bash
+# 1. open-tab in chromeId X
+curl -X POST -d '{"chromeId":"X","model":"gemini-3.1-pro-preview"}' \
+  http://127.0.0.1:6868/api/launcher/open-tab
+
+# 2. wait until launcher email bound + worker registered + idle (one sync call)
+curl -X POST -d '{"chromeId":"X","timeoutMs":15000}' \
+  http://127.0.0.1:6868/api/launcher/wait-ready
+# → { ok, launcher: {email, ...}, worker: {email, status, ...}, elapsedMs }
+
+# 3. submit task pinned to chromeId
+curl -F prompt="..." -F chromeId=X http://127.0.0.1:6868/api/tasks
+```
+
+Body fields:
+
+| Field | Default | Mô tả |
+|---|---|---|
+| `chromeId` | required | UUID Chrome profile |
+| `timeoutMs` | 15000 | clamp `[1000, 60000]` |
+| `requireEmail` | `true` | đợi launcher.email != null (DOM scrape xong) |
+| `requireWorker` | `true` | đợi ≥1 worker `idle` + chromeId match + email bound |
+
+Status codes:
+- **200**: `{ ok: true, launcher, worker, elapsedMs }` — sẵn sàng
+- **404** `launcher_not_found`: chromeId chưa từng match launcher (immediate)
+- **504** `wait_ready_timeout`: điều kiện không thoả trong timeoutMs (trả về `details` để debug)
+
+### Extension diagnostics — `/api/worker/extension-info` (v2.0.71+)
+
+Dump metadata của extension đang chạy trong tab AI Studio — `installType`,
+`version`, `runtimeId`, `permissions`. Dùng khi:
+
+- Phát hiện profile có duplicate install (Load Unpacked + Web Store cùng tồn tại)
+- Verify extension version sau khi update npm package
+- Diagnose "tabId null" (extension cũ chưa propagate field)
+
+```bash
+curl -s "http://127.0.0.1:6868/api/worker/extension-info?workerLabel=alice@gmail.com" | jq
+```
+
+Response:
+
+```json
+{
+  "ok": true,
+  "info": {
+    "runtimeId": "comfeilpfnlaoijgndaikpniioglmonf",
+    "version": "1.0.0",
+    "name": "VetGo Pro",
+    "manifestVersion": 3,
+    "installType": "development",    // "development" = Load Unpacked; "normal" = Web Store
+    "enabled": true,
+    "permissions": ["alarms", "cookies", ...],
+    "hostPermissions": ["<all_urls>"]
+  },
+  "tabUrl": "https://aistudio.google.com/...",
+  "vetgo": {
+    "chromeId": "...",
+    "tabId": 437926742,
+    "extInfo": { ... }    // same content as .info, source of truth
+  }
+}
+```
+
+`.info` lấy từ `window.vetgo.extInfo` (background.ts inject lúc CONTROLLER script
+load). Page-context content-script không có `chrome.runtime.sendMessage` → đây là
+duy nhất cách lấy metadata từ extension về.
+
+**Trường hợp thường gặp**: `installType="normal"` + `runtimeId` khác với mọi profile
+khác → Web Store install cũ vẫn còn active, đè Load Unpacked. Fix: `chrome://extensions`
+→ Remove Web Store version → restart Chrome.
+
+### ChromeId stability — `storage.local` migration (v2.0.72+)
+
+Trước v2.0.72: chromeId lưu trong `chrome.storage.sync` (đồng bộ qua Google
+account). Nếu reinstall extension trong profile có account từng cài extension
+khác → storage.sync sync ngược UUID cũ về → launcher SW init mint UUID mới
+nhưng background.ts CONTROLLER handler đọc UUID đã sync ngược → 2 chromeId
+khác nhau cho cùng 1 profile.
+
+Từ v2.0.72: dùng `chrome.storage.local` (per-profile, không cross account).
+Migration tự động: lần đầu boot extension, nếu `storage.local.id` rỗng nhưng
+`storage.sync.id` có → copy `.sync.id` sang `.local.id`. Sau đó `.local.id`
+là source of truth.
+
+Verify chromeId nhất quán:
+
+```bash
+curl -s -X POST -d '{"all":true,"cmd":"storage.local.get","args":{"keys":["id"]}}' \
+  -H 'Content-Type: application/json' \
+  http://127.0.0.1:6868/api/launcher/exec \
+  | jq '.[] | {launcher: .launcher.chromeId, local: .value.id, ok: (.launcher.chromeId == .value.id)}'
+```
+
+Tất cả `ok: true` = pipeline đúng.
+
 ### Modal auto-handling
 
 AI Studio thỉnh thoảng pop modal chặn task. Worker tự detect + click button đúng (poll mỗi 400 ms):

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vg-coder-cli",
-  "version": "2.0.71",
+  "version": "2.0.73",
   "description": "🚀 CLI tool to analyze projects, concatenate source files, count tokens, and export HTML with syntax highlighting and copy functionality",
   "main": "src/index.js",
   "bin": {

package/src/server/task-queue.js

@@ -1009,13 +1009,12 @@ class TaskQueue {
   _autoLaunchBrowser(task = null) {
     const now = Date.now();
     if (now - this.launchedAt < AUTO_LAUNCH_DEBOUNCE_MS) return;
-    this.launchedAt = now;
 
     // Prefer asking a connected launcher (extension background SW in the right
-    // Chrome profile) to open / focus the AI Studio tab. Falls back to OS
-    // `open` if no launcher matches the pin or none are connected.
+    // Chrome profile) to open / focus the AI Studio tab.
     const launcher = this._pickLauncher(task);
     if (launcher) {
+      this.launchedAt = now;
       const tag = launcher.email || `chromeId=${launcher.chromeId.slice(0, 8)}…`;
       console.log(chalk.cyan(`[TaskQueue] No matching worker — asking launcher ${tag} to open AI Studio`));
       try {
@@ -1033,10 +1032,37 @@ class TaskQueue {
         return;
       } catch (err) {
         console.log(chalk.yellow(`[TaskQueue] Launcher emit failed: ${err.message}`));
-        // fall through to OS open
+        // fall through to OS open ONLY if task has no explicit pin
+      }
+    }
+
+    // If the task has an explicit pin (chromeId or workerLabel) and no launcher
+    // matches, do NOT fall back to OS `open` — that command opens the URL in
+    // whatever Chrome profile is currently focused on the host (potentially a
+    // profile that uninstalled the extension or belongs to a different user),
+    // leaking the task target into an unrelated profile and respawning every
+    // 30s as long as the task stays queued. Fail the task instead.
+    const hasExplicitPin = !!(task?.chromeId || task?.workerLabel);
+    if (hasExplicitPin) {
+      const pinDesc = task.chromeId ? `chromeId=${task.chromeId.slice(0, 8)}…` : `workerLabel=${task.workerLabel}`;
+      console.log(chalk.yellow(`[TaskQueue] Task ${task.id} pinned to ${pinDesc} but no matching launcher — failing without OS-open fallback`));
+      // Mark task failed so _drain doesn't keep re-triggering autoLaunch.
+      const t = this.cache.get(task.id);
+      if (t && t.status === 'queued') {
+        t.status = 'failed';
+        t.error = { code: 'launcher_not_found', message: `No connected launcher matches pin ${pinDesc}` };
+        t.timing.finishedAt = Date.now();
+        t.timing.durationMs = t.timing.finishedAt - (t.timing.startedAt || t.timing.createdAt);
+        this.pending = this.pending.filter(p => p.id !== task.id);
+        store.saveTask(t).catch(() => {});
+        webhook.deliver(t).catch(() => {});
       }
+      return;
     }
 
+    // No pin at all — safe to OS-open default URL since the task accepts
+    // any profile. Apply debounce so we don't spam tabs across the host.
+    this.launchedAt = now;
     let cmd;
     switch (process.platform) {
       case 'darwin': cmd = `open "${AUTO_LAUNCH_URL}"`; break;