tabctl 0.3.1 → 0.5.0

package/dist/cli/lib/commands/setup.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * Setup command handler: interactive browser profile configuration.
+ * Setup command handler: browser profile configuration.
  * Extracted from meta.ts for modularity.
  */
 var __importDefault = (this && this.__importDefault) || function (mod) {
@@ -9,16 +9,13 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveBrowser = resolveBrowser;
 exports.resolveExtensionId = resolveExtensionId;
-exports.promptExtensionId = promptExtensionId;
 exports.resolveNodePath = resolveNodePath;
 exports.resolveManifestDir = resolveManifestDir;
 exports.writeWrapper = writeWrapper;
 exports.runSetup = runSetup;
-const fs_1 = __importDefault(require("fs"));
-const os_1 = __importDefault(require("os"));
-const path_1 = __importDefault(require("path"));
-const readline_1 = __importDefault(require("readline"));
-const node_child_process_1 = require("node:child_process");
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
 const constants_1 = require("../constants");
 const output_1 = require("../output");
 const profiles_1 = require("../../../shared/profiles");
@@ -49,76 +46,6 @@ function resolveExtensionId(options, required) {
     }
     return value;
 }
-async function promptExtensionId(browser) {
-    const maxAttempts = 3;
-    const extPage = browser === "chrome" ? "chrome://extensions" : "edge://extensions";
-    const instructions = [
-        "",
-        "Next steps:",
-        `  1. Open ${extPage}`,
-        "  2. Enable Developer mode",
-        '  3. Click "Load unpacked" and select the path above',
-        "  4. Copy the extension ID shown on the extensions page",
-        "",
-    ].join("\n");
-    process.stderr.write(instructions);
-    // Collect lines from stdin and provide them on demand
-    const lines = [];
-    let closed = false;
-    let waiting = null;
-    const rl = readline_1.default.createInterface({ input: process.stdin, output: process.stderr, terminal: false });
-    rl.on("line", (line) => {
-        if (waiting) {
-            const cb = waiting;
-            waiting = null;
-            cb(line.trim());
-        }
-        else {
-            lines.push(line.trim());
-        }
-    });
-    rl.on("close", () => {
-        closed = true;
-        if (waiting) {
-            const cb = waiting;
-            waiting = null;
-            cb(null);
-        }
-    });
-    const nextLine = (prompt) => {
-        process.stderr.write(prompt);
-        if (lines.length > 0) {
-            return Promise.resolve(lines.shift());
-        }
-        if (closed)
-            return Promise.resolve(null);
-        return new Promise((resolve) => { waiting = resolve; });
-    };
-    try {
-        for (let attempt = 1; attempt <= maxAttempts; attempt++) {
-            const raw = await nextLine("Paste the extension ID: ");
-            if (raw === null) {
-                (0, output_1.errorOut)("No input received (stdin closed).");
-            }
-            const value = raw.toLowerCase();
-            if (constants_1.EXTENSION_ID_PATTERN.test(value)) {
-                return value;
-            }
-            const remaining = maxAttempts - attempt;
-            if (remaining > 0) {
-                process.stderr.write(`Invalid extension ID (expected 32 lowercase a-p characters). ${remaining} attempt(s) remaining.\n`);
-            }
-            else {
-                (0, output_1.errorOut)("Invalid extension ID after 3 attempts.");
-            }
-        }
-    }
-    finally {
-        rl.close();
-    }
-    // unreachable due to errorOut, but satisfies TypeScript
-    return "";
-}
 function resolveNodePath(options) {
     const raw = typeof options.node === "string"
         ? String(options.node)
@@ -127,12 +54,12 @@ function resolveNodePath(options) {
     if (!value) {
         (0, output_1.errorOut)("Node binary not found. Set --node or TABCTL_NODE.");
     }
-    if (!path_1.default.isAbsolute(value)) {
+    if (!node_path_1.default.isAbsolute(value)) {
         (0, output_1.errorOut)(`Node path must be absolute: ${value}`);
     }
     if (process.platform !== "win32") {
         try {
-            fs_1.default.accessSync(value, fs_1.default.constants.X_OK);
+            node_fs_1.default.accessSync(value, node_fs_1.default.constants.X_OK);
         }
         catch {
             (0, output_1.errorOut)(`Node binary not executable: ${value}`);
@@ -140,7 +67,7 @@ function resolveNodePath(options) {
     }
     else {
         try {
-            fs_1.default.accessSync(value, fs_1.default.constants.R_OK);
+            node_fs_1.default.accessSync(value, node_fs_1.default.constants.R_OK);
         }
         catch {
             (0, output_1.errorOut)(`Node binary not found: ${value}`);
@@ -160,36 +87,36 @@ function resolveHostPath(dataDir) {
     }
 }
 function resolveManifestDir(browser) {
-    const home = os_1.default.homedir();
+    const home = node_os_1.default.homedir();
     if (!home) {
         (0, output_1.errorOut)("Home directory not found.");
     }
     if (process.platform === "win32") {
         // Windows: registry-based is preferred, but file-based works with --user-data-dir.
         // For system-wide, we point to the per-user NativeMessagingHosts under LOCALAPPDATA.
-        const base = process.env.LOCALAPPDATA || path_1.default.join(home, "AppData", "Local");
+        const base = process.env.LOCALAPPDATA || node_path_1.default.join(home, "AppData", "Local");
         if (browser === "edge") {
-            return path_1.default.join(base, "Microsoft", "Edge", "User Data", "NativeMessagingHosts");
+            return node_path_1.default.join(base, "Microsoft", "Edge", "User Data", "NativeMessagingHosts");
         }
-        return path_1.default.join(base, "Google", "Chrome", "User Data", "NativeMessagingHosts");
+        return node_path_1.default.join(base, "Google", "Chrome", "User Data", "NativeMessagingHosts");
     }
     if (process.platform === "linux") {
         if (browser === "edge") {
-            return path_1.default.join(home, ".config", "microsoft-edge", "NativeMessagingHosts");
+            return node_path_1.default.join(home, ".config", "microsoft-edge", "NativeMessagingHosts");
         }
-        return path_1.default.join(home, ".config", "google-chrome", "NativeMessagingHosts");
+        return node_path_1.default.join(home, ".config", "google-chrome", "NativeMessagingHosts");
     }
     // macOS
     if (browser === "edge") {
-        return path_1.default.join(home, "Library", "Application Support", "Microsoft Edge", "NativeMessagingHosts");
+        return node_path_1.default.join(home, "Library", "Application Support", "Microsoft Edge", "NativeMessagingHosts");
     }
-    return path_1.default.join(home, "Library", "Application Support", "Google", "Chrome", "NativeMessagingHosts");
+    return node_path_1.default.join(home, "Library", "Application Support", "Google", "Chrome", "NativeMessagingHosts");
 }
 function writeWrapper(nodePath, hostPath, profileName, wrapperDir) {
-    fs_1.default.mkdirSync(wrapperDir, { recursive: true });
+    node_fs_1.default.mkdirSync(wrapperDir, { recursive: true });
     if (process.platform !== "win32") {
         try {
-            fs_1.default.chmodSync(wrapperDir, 0o700);
+            node_fs_1.default.chmodSync(wrapperDir, 0o700);
         }
         catch { /* ignore */ }
     }
@@ -205,28 +132,28 @@ function writeWrapper(nodePath, hostPath, profileName, wrapperDir) {
             // Not installed
         }
         if (exeSrc) {
-            const exeDst = path_1.default.join(wrapperDir, "tabctl-host.exe");
-            fs_1.default.copyFileSync(exeSrc, exeDst);
+            const exeDst = node_path_1.default.join(wrapperDir, "tabctl-host.exe");
+            node_fs_1.default.copyFileSync(exeSrc, exeDst);
             const cfgLines = [nodePath, hostPath];
             if (profileName) {
                 cfgLines.push(`TABCTL_PROFILE=${profileName}`);
             }
             cfgLines.push("");
-            fs_1.default.writeFileSync(path_1.default.join(wrapperDir, "host-launcher.cfg"), cfgLines.join("\r\n"), "utf8");
+            node_fs_1.default.writeFileSync(node_path_1.default.join(wrapperDir, "host-launcher.cfg"), cfgLines.join("\r\n"), "utf8");
             return exeDst;
         }
         // Fallback: .cmd wrapper (won't work with Chrome native messaging)
-        const wrapperPath = path_1.default.join(wrapperDir, "tabctl-host.cmd");
+        const wrapperPath = node_path_1.default.join(wrapperDir, "tabctl-host.cmd");
         const lines = ["@echo off"];
         if (profileName) {
             lines.push(`set TABCTL_PROFILE=${profileName}`);
         }
         lines.push(`"${nodePath}" "${hostPath}" %*`);
         lines.push("");
-        fs_1.default.writeFileSync(wrapperPath, lines.join("\r\n"), "utf8");
+        node_fs_1.default.writeFileSync(wrapperPath, lines.join("\r\n"), "utf8");
         return wrapperPath;
     }
-    const wrapperPath = path_1.default.join(wrapperDir, "tabctl-host.sh");
+    const wrapperPath = node_path_1.default.join(wrapperDir, "tabctl-host.sh");
     const escapedNode = nodePath.replace(/"/g, "\\\"");
     const escapedHost = hostPath.replace(/"/g, "\\\"");
     const lines = [
@@ -239,11 +166,11 @@ function writeWrapper(nodePath, hostPath, profileName, wrapperDir) {
     lines.push(`exec \"${escapedNode}\" \"${escapedHost}\"`);
     lines.push("");
     const wrapper = lines.join("\n");
-    fs_1.default.writeFileSync(wrapperPath, wrapper, "utf8");
-    fs_1.default.chmodSync(wrapperPath, 0o700);
+    node_fs_1.default.writeFileSync(wrapperPath, wrapper, "utf8");
+    node_fs_1.default.chmodSync(wrapperPath, 0o700);
     return wrapperPath;
 }
-async function runSetup(options, prettyOutput) {
+function runSetup(options, prettyOutput) {
     const browser = resolveBrowser(options.browser);
     if (!browser) {
         (0, output_1.errorOut)("Missing or invalid --browser (edge|chrome)");
@@ -263,41 +190,15 @@ async function runSetup(options, prettyOutput) {
     let extensionId = resolveExtensionId(options, false);
     if (!extensionId) {
         // Auto-derive from the installed extension path (Chromium uses SHA256 of the path)
-        const installedDir = (0, extension_sync_1.resolveInstalledExtensionDir)(config.baseDataDir);
-        if (fs_1.default.existsSync(path_1.default.join(installedDir, "manifest.json"))) {
+        // Prefer the just-synced path; fall back to resolving independently
+        const installedDir = extensionSync?.extensionDir ?? (0, extension_sync_1.resolveInstalledExtensionDir)(config.baseDataDir);
+        if (node_fs_1.default.existsSync(node_path_1.default.join(installedDir, "manifest.json"))) {
             extensionId = (0, extension_sync_1.deriveExtensionId)(installedDir);
             process.stderr.write(`Extension ID derived from: ${installedDir}\n`);
         }
     }
     if (!extensionId) {
-        // Interactive mode: sync hadn't happened or path doesn't exist
-        if (extensionSync?.extensionDir) {
-            process.stderr.write(`\nExtension synced to: ${extensionSync.extensionDir}\n`);
-            try {
-                const clipArgs = [];
-                let clipCmd;
-                if (process.platform === "darwin") {
-                    clipCmd = "pbcopy";
-                }
-                else if (process.platform === "win32") {
-                    clipCmd = "clip";
-                }
-                else {
-                    clipCmd = "xclip";
-                    clipArgs.push("-selection", "clipboard");
-                }
-                const clip = (0, node_child_process_1.spawn)(clipCmd, clipArgs, { stdio: ["pipe", "ignore", "ignore"] });
-                clip.stdin.end(extensionSync.extensionDir);
-                clip.on("exit", (code) => {
-                    if (code === 0)
-                        process.stderr.write("(Path copied to clipboard)\n");
-                });
-            }
-            catch {
-                // clipboard copy is best-effort
-            }
-        }
-        extensionId = await promptExtensionId(browser);
+        (0, output_1.errorOut)("Could not derive extension ID (extension not synced). Use --extension-id <id> or set TABCTL_EXTENSION_ID.");
     }
     // Profile name: --name flag or browser type
     const profileName = typeof options.name === "string" && options.name.trim()
@@ -310,20 +211,20 @@ async function runSetup(options, prettyOutput) {
         (0, output_1.errorOut)(err.message);
     }
     // Profile data dir (use baseDataDir to avoid nesting under another profile)
-    const profileDataDir = path_1.default.join(config.baseDataDir, "profiles", profileName);
-    fs_1.default.mkdirSync(profileDataDir, { recursive: true });
+    const profileDataDir = node_path_1.default.join(config.baseDataDir, "profiles", profileName);
+    node_fs_1.default.mkdirSync(profileDataDir, { recursive: true });
     // Write profile-specific wrapper
     const wrapperPath = writeWrapper(nodePath, hostPath, profileName, profileDataDir);
     // Resolve manifest directory: custom user-data-dir or system-wide
     const rawUserDataDir = typeof options["user-data-dir"] === "string"
         ? options["user-data-dir"].trim()
         : "";
-    const userDataDir = rawUserDataDir ? path_1.default.resolve(rawUserDataDir) : "";
+    const userDataDir = rawUserDataDir ? node_path_1.default.resolve(rawUserDataDir) : "";
     const manifestDir = userDataDir
-        ? path_1.default.join(userDataDir, "NativeMessagingHosts")
+        ? node_path_1.default.join(userDataDir, "NativeMessagingHosts")
         : resolveManifestDir(browser);
-    fs_1.default.mkdirSync(manifestDir, { recursive: true });
-    const manifestPath = path_1.default.join(manifestDir, `${constants_1.HOST_NAME}.json`);
+    node_fs_1.default.mkdirSync(manifestDir, { recursive: true });
+    const manifestPath = node_path_1.default.join(manifestDir, `${constants_1.HOST_NAME}.json`);
     const manifest = {
         name: constants_1.HOST_NAME,
         description: constants_1.HOST_DESCRIPTION,
@@ -331,7 +232,7 @@ async function runSetup(options, prettyOutput) {
         type: "stdio",
         allowed_origins: [`chrome-extension://${extensionId}/`],
     };
-    fs_1.default.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2), "utf8");
+    node_fs_1.default.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2), "utf8");
     // Register profile
     const profileEntry = {
         browser,

package/dist/cli/lib/constants.js

@@ -26,5 +26,5 @@ exports.GROUP_COLORS = new Set([
 exports.DEFAULT_PAGE_LIMIT = 100;
 exports.SKILL_NAME = "tabctl";
 exports.SKILL_REPO = process.env.TABCTL_SKILL_REPO || "https://github.com/ekroon/tabctl";
-exports.SUPPORTED_SIGNALS = ["page-meta", "github-state", "selector"];
+exports.SUPPORTED_SIGNALS = ["page-meta", "selector"];
 exports.SUPPORTED_SIGNAL_SET = new Set(exports.SUPPORTED_SIGNALS);

package/dist/cli/lib/options-commands.js

@@ -85,6 +85,8 @@ exports.COMMANDS = {
             { flag: "--window-group <name>", desc: "Find window containing group" },
             { flag: "--window-tab <id>", desc: "Find window containing tab" },
             { flag: "--window-url <substring>", desc: "Find window containing URL" },
+            { flag: "--new-group", desc: "Force new group even if one exists" },
+            { flag: "--allow-duplicates", desc: "Open duplicate URLs" },
         ],
     },
     "group-list": {
@@ -129,6 +131,13 @@ exports.COMMANDS = {
             { flag: "--expanded", desc: "Expand group after assign" },
         ],
     },
+    "group-gather": {
+        description: "Merge duplicate groups with the same name",
+        options: [
+            { flag: "--window <id|active|last-focused>", desc: "Target window" },
+            { flag: "--group <name>", desc: "Group name to gather (optional, gathers all if omitted)" },
+        ],
+    },
     "move-tab": {
         description: "Move a tab to a new position",
         options: [
@@ -167,7 +176,7 @@ exports.COMMANDS = {
         description: "Configure tabctl connection",
         options: [
             { flag: "--browser edge|chrome", desc: "Browser type" },
-            { flag: "--extension-id <id>", desc: "Extension ID to connect to" },
+            { flag: "--extension-id <id>", desc: "Override auto-derived extension ID" },
             { flag: "--node <path>", desc: "Path to Node.js executable" },
             { flag: "--name <name>", desc: "Profile name (default: browser type)" },
             { flag: "--user-data-dir <path>", desc: "Chrome/Edge user data directory for custom profiles" },
@@ -247,6 +256,12 @@ exports.COMMANDS = {
             { flag: "<name>", desc: "Profile name (positional)" },
         ],
     },
+    doctor: {
+        description: "Diagnose and repair profile health",
+        options: [
+            { flag: "--fix", desc: "Auto-repair broken wrappers" },
+        ],
+    },
     version: {
         description: "Show version information",
     },

package/dist/cli/lib/output.js

@@ -8,8 +8,10 @@ const version_1 = require("../../shared/version");
 const profiles_1 = require("../../shared/profiles");
 const extension_sync_1 = require("../../shared/extension-sync");
 const config_1 = require("../../shared/config");
+const wrapper_health_1 = require("../../shared/wrapper-health");
 const client_1 = require("./client");
 const client_2 = require("./client");
+const setup_1 = require("./commands/setup");
 function printJson(payload, pretty = true) {
     try {
         const active = (0, profiles_1.getActiveProfile)();
@@ -78,6 +80,13 @@ function emitVersionWarnings(response, fallbackAction) {
                 process.stderr.write(`[tabctl] host is stale (${hostVersion}), reloading extension...\n`);
             }
             (0, client_1.sendFireAndForget)({ id: (0, client_2.createRequestId)(), action: "reload", params: {} });
+            // Check and fix wrapper Node path for the active profile
+            try {
+                repairActiveWrapper(config.baseDataDir);
+            }
+            catch {
+                // Wrapper repair is best-effort
+            }
         }
         catch {
             process.stderr.write(`[tabctl] version mismatch: cli ${version_1.VERSION}, host ${hostVersion}. Run: tabctl setup\n`);
@@ -98,3 +107,33 @@ function emitVersionWarnings(response, fallbackAction) {
         process.stderr.write("[tabctl] extension version unavailable. Reload the extension in your browser\n");
     }
 }
+/**
+ * Repair the active profile's wrapper if the Node path is broken.
+ * Conservative: only fixes paths that are confirmed missing.
+ */
+function repairActiveWrapper(baseDataDir) {
+    const active = (0, profiles_1.getActiveProfile)();
+    if (!active)
+        return;
+    const wrapperPath = (0, wrapper_health_1.resolveWrapperPath)(active.profile.dataDir);
+    const check = (0, wrapper_health_1.checkWrapper)(wrapperPath);
+    if (check.ok || !check.info)
+        return;
+    const fs = require("node:fs");
+    const path = require("node:path");
+    const needsNodeFix = !fs.existsSync(check.info.nodePath);
+    const needsHostFix = !fs.existsSync(check.info.hostPath);
+    if (!needsNodeFix && !needsHostFix)
+        return;
+    const newNodePath = needsNodeFix ? process.execPath : check.info.nodePath;
+    const newHostPath = needsHostFix
+        ? (0, extension_sync_1.resolveInstalledHostPath)(baseDataDir)
+        : check.info.hostPath;
+    (0, setup_1.writeWrapper)(newNodePath, newHostPath, check.info.profileName, path.dirname(wrapperPath));
+    if (needsNodeFix) {
+        process.stderr.write(`[tabctl] fixed wrapper Node path: ${check.info.nodePath} → ${newNodePath}\n`);
+    }
+    if (needsHostFix) {
+        process.stderr.write(`[tabctl] fixed wrapper host path: ${check.info.hostPath} → ${newHostPath}\n`);
+    }
+}

package/dist/cli/lib/policy-filter.js

@@ -120,7 +120,7 @@ function applyPolicyFilter(command, params, snapshot, policyContext, policySumma
             protected: protectedTabs.map(mapProtectedTab),
         };
     }
-    else if (command === "group-update" || command === "group-ungroup") {
+    else if (command === "group-update" || command === "group-ungroup" || command === "group-gather") {
         if (!eligibleIds.length || protectedTabs.length > 0) {
             earlyResponse = {
                 ok: true,
@@ -147,7 +147,7 @@ function applyPolicyFilter(command, params, snapshot, policyContext, policySumma
                         generatedAt,
                         staleDays: params.staleDays || 0,
                         totals: { tabs: 0, analyzed: 0, candidates: 0 },
-                        meta: { durationMs: 0, githubChecked: 0, githubTotal: 0, githubMatched: 0, githubTimeoutMs: params.githubTimeoutMs || 0 },
+                        meta: { durationMs: 0 },
                         candidates: [],
                         analysisId: null,
                         policy: policySummary,

package/dist/cli/lib/policy.js

@@ -10,7 +10,7 @@ exports.getDomain = getDomain;
 exports.evaluateTab = evaluateTab;
 exports.annotateEntry = annotateEntry;
 exports.summarizePolicy = summarizePolicy;
-const fs_1 = __importDefault(require("fs"));
+const node_fs_1 = __importDefault(require("node:fs"));
 const config_1 = require("../../shared/config");
 function defaultPolicyPath() {
     return (0, config_1.resolveConfig)().policyPath;
@@ -25,10 +25,10 @@ function defaultPolicyTemplate() {
 }
 function loadPolicy() {
     const resolvedPath = defaultPolicyPath();
-    if (!fs_1.default.existsSync(resolvedPath)) {
+    if (!node_fs_1.default.existsSync(resolvedPath)) {
         return { policy: null, path: resolvedPath };
     }
-    const raw = fs_1.default.readFileSync(resolvedPath, "utf8");
+    const raw = node_fs_1.default.readFileSync(resolvedPath, "utf8");
     const parsed = JSON.parse(raw);
     return { policy: parsed, path: resolvedPath };
 }

package/dist/cli/lib/response.js

@@ -9,8 +9,8 @@ exports.buildDedupeOutput = buildDedupeOutput;
 exports.extractDedupePlan = extractDedupePlan;
 exports.formatReport = formatReport;
 exports.writeScreenshots = writeScreenshots;
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
 const report_1 = require("./report");
 const policy_1 = require("./policy");
 const output_1 = require("./output");
@@ -74,7 +74,7 @@ function buildDedupeOutput(response, includeStale, closeData, confirmed) {
     const candidates = Array.isArray(data.candidates) ? data.candidates : [];
     const planned = candidates.filter((candidate) => {
         const reasons = Array.isArray(candidate.reasons) ? candidate.reasons : [];
-        const hasDuplicate = reasons.some((reason) => reason.type === "duplicate" || reason.type === "closed_issue");
+        const hasDuplicate = reasons.some((reason) => reason.type === "duplicate");
         const hasStale = reasons.some((reason) => reason.type === "stale");
         return hasDuplicate || (includeStale && hasStale);
     });
@@ -127,7 +127,7 @@ function extractDedupePlan(response, includeStale) {
     const candidates = Array.isArray(data.candidates) ? data.candidates : [];
     const planned = candidates.filter((candidate) => {
         const reasons = Array.isArray(candidate.reasons) ? candidate.reasons : [];
-        const hasDuplicate = reasons.some((reason) => reason.type === "duplicate" || reason.type === "closed_issue");
+        const hasDuplicate = reasons.some((reason) => reason.type === "duplicate");
         const hasStale = reasons.some((reason) => reason.type === "stale");
         return hasDuplicate || (includeStale && hasStale);
     });
@@ -170,7 +170,7 @@ function formatReport(response, options, prettyOutput) {
         (0, output_1.errorOut)(`Unknown report format: ${format}`);
     }
     if (options.out) {
-        fs_1.default.writeFileSync(String(options.out), content, "utf8");
+        node_fs_1.default.writeFileSync(String(options.out), content, "utf8");
         (0, output_1.printJson)({ ok: true, data: { writtenTo: options.out, format, count: entries.length, ...(page ? { page } : {}) } }, prettyOutput);
         return { printed: true };
     }
@@ -190,13 +190,13 @@ function writeScreenshots(response, options, prettyOutput) {
     const page = data && "page" in data ? data.page : undefined;
     const outDir = options.out
         ? String(options.out)
-        : path_1.default.join(process.cwd(), ".tabctl", "screenshots", String(Date.now()));
-    fs_1.default.mkdirSync(outDir, { recursive: true });
+        : node_path_1.default.join(process.cwd(), ".tabctl", "screenshots", String(Date.now()));
+    node_fs_1.default.mkdirSync(outDir, { recursive: true });
     let filesWritten = 0;
     const sanitized = entries.map((entry) => {
         const tabId = entry.tabId;
-        const tabDir = path_1.default.join(outDir, String(tabId ?? "unknown"));
-        fs_1.default.mkdirSync(tabDir, { recursive: true });
+        const tabDir = node_path_1.default.join(outDir, String(tabId ?? "unknown"));
+        node_fs_1.default.mkdirSync(tabDir, { recursive: true });
         const tiles = Array.isArray(entry.tiles) ? entry.tiles : [];
         const sanitizedTiles = tiles.map((tile) => {
             const rawUrl = tile.dataUrl;
@@ -215,9 +215,9 @@ function writeScreenshots(response, options, prettyOutput) {
             const total = Number.isFinite(tile.total) ? Number(tile.total) : null;
             const suffix = total && total > 1 ? `-of-${total}` : "";
             const filename = `screenshot-${index}${suffix}.${ext}`;
-            const filePath = path_1.default.join(tabDir, filename);
+            const filePath = node_path_1.default.join(tabDir, filename);
             const buffer = Buffer.from(base64, "base64");
-            fs_1.default.writeFileSync(filePath, buffer);
+            node_fs_1.default.writeFileSync(filePath, buffer);
             filesWritten += 1;
             return {
                 ...rest,

package/dist/cli/tabctl.js

@@ -153,6 +153,10 @@ async function main() {
         await (0, commands_1.runSetup)(options, prettyOutput);
         return;
     }
+    if (command === "doctor") {
+        (0, commands_1.runDoctor)(options, prettyOutput);
+        return;
+    }
     if (command === "version") {
         (0, commands_1.runVersion)(prettyOutput);
         return;
@@ -242,6 +246,10 @@ async function main() {
             action = "group-assign";
             params = (0, commands_2.buildGroupAssignParams)(options);
             break;
+        case "group-gather":
+            action = "group-gather";
+            params = (0, commands_2.buildGroupGatherParams)(options);
+            break;
         case "move-tab":
             action = "move-tab";
             params = (0, commands_2.buildMoveTabParams)(options);
@@ -303,7 +311,7 @@ async function main() {
             (0, output_1.errorOut)("merge-window --close-source requires --confirm");
         }
     }
-    if (enforcePolicy && ["analyze", "inspect", "report", "screenshot", "close", "archive", "focus", "refresh", "move-tab", "move-group", "group-assign", "group-update", "group-ungroup", "merge-window"].includes(command)) {
+    if (enforcePolicy && ["analyze", "inspect", "report", "screenshot", "close", "archive", "focus", "refresh", "move-tab", "move-group", "group-assign", "group-update", "group-ungroup", "group-gather", "merge-window"].includes(command)) {
         if (command === "close" && options.apply) {
             (0, output_1.errorOut)("Policy blocks close --apply; use explicit tab targets.");
         }