tabctl 0.5.3 → 0.6.0-alpha.1

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

@@ -1,294 +0,0 @@
-"use strict";
-/**
- * Setup command handler: browser profile configuration.
- * Extracted from meta.ts for modularity.
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveBrowser = resolveBrowser;
-exports.resolveExtensionId = resolveExtensionId;
-exports.resolveNodePath = resolveNodePath;
-exports.resolveManifestDir = resolveManifestDir;
-exports.writeWrapper = writeWrapper;
-exports.runSetup = runSetup;
-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");
-const config_1 = require("../../../shared/config");
-const extension_sync_1 = require("../../../shared/extension-sync");
-function resolveBrowser(value) {
-    if (typeof value !== "string") {
-        return null;
-    }
-    const trimmed = value.trim().toLowerCase();
-    if (trimmed === "edge" || trimmed === "chrome") {
-        return trimmed;
-    }
-    return null;
-}
-function resolveExtensionId(options, required) {
-    const raw = typeof options["extension-id"] === "string"
-        ? String(options["extension-id"])
-        : (process.env.TABCTL_EXTENSION_ID || "");
-    const value = raw.trim().toLowerCase();
-    if (!value) {
-        if (!required)
-            return null;
-        (0, output_1.errorOut)("Missing --extension-id (or TABCTL_EXTENSION_ID)");
-    }
-    if (!constants_1.EXTENSION_ID_PATTERN.test(value)) {
-        (0, output_1.errorOut)(`Extension ID looks unusual: ${raw}`);
-    }
-    return value;
-}
-function resolveNodePath(options) {
-    const raw = typeof options.node === "string"
-        ? String(options.node)
-        : (process.env.TABCTL_NODE || process.execPath || "");
-    const value = raw.trim();
-    if (!value) {
-        (0, output_1.errorOut)("Node binary not found. Set --node or TABCTL_NODE.");
-    }
-    if (!node_path_1.default.isAbsolute(value)) {
-        (0, output_1.errorOut)(`Node path must be absolute: ${value}`);
-    }
-    if (process.platform !== "win32") {
-        try {
-            node_fs_1.default.accessSync(value, node_fs_1.default.constants.X_OK);
-        }
-        catch {
-            (0, output_1.errorOut)(`Node binary not executable: ${value}`);
-        }
-    }
-    else {
-        try {
-            node_fs_1.default.accessSync(value, node_fs_1.default.constants.R_OK);
-        }
-        catch {
-            (0, output_1.errorOut)(`Node binary not found: ${value}`);
-        }
-    }
-    return value;
-}
-function resolveHostPath(dataDir) {
-    // Sync host bundle to stable path so wrapper survives npm upgrades
-    try {
-        const result = (0, extension_sync_1.syncHost)(dataDir, { force: true });
-        return result.hostPath;
-    }
-    catch (err) {
-        const detail = err instanceof Error ? err.message : String(err);
-        (0, output_1.errorOut)(`Failed to resolve native host. Make sure the CLI is built (run: npm run build). Details: ${detail}`);
-    }
-}
-function resolveManifestDir(browser) {
-    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 || node_path_1.default.join(home, "AppData", "Local");
-        if (browser === "edge") {
-            return node_path_1.default.join(base, "Microsoft", "Edge", "User Data", "NativeMessagingHosts");
-        }
-        return node_path_1.default.join(base, "Google", "Chrome", "User Data", "NativeMessagingHosts");
-    }
-    if (process.platform === "linux") {
-        if (browser === "edge") {
-            return node_path_1.default.join(home, ".config", "microsoft-edge", "NativeMessagingHosts");
-        }
-        return node_path_1.default.join(home, ".config", "google-chrome", "NativeMessagingHosts");
-    }
-    // macOS
-    if (browser === "edge") {
-        return node_path_1.default.join(home, "Library", "Application Support", "Microsoft Edge", "NativeMessagingHosts");
-    }
-    return node_path_1.default.join(home, "Library", "Application Support", "Google", "Chrome", "NativeMessagingHosts");
-}
-function writeWrapper(nodePath, hostPath, profileName, wrapperDir) {
-    node_fs_1.default.mkdirSync(wrapperDir, { recursive: true });
-    if (process.platform !== "win32") {
-        try {
-            node_fs_1.default.chmodSync(wrapperDir, 0o700);
-        }
-        catch { /* ignore */ }
-    }
-    if (process.platform === "win32") {
-        // Prefer the Go launcher binary from the platform package.
-        // Falls back to a .cmd wrapper if unavailable (dev/testing only —
-        // .cmd wrappers don't work for Chrome native messaging).
-        let exeSrc;
-        try {
-            exeSrc = require.resolve("tabctl-win32-x64/tabctl-host.exe");
-        }
-        catch {
-            // Not installed
-        }
-        if (exeSrc) {
-            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("");
-            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 = 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("");
-        node_fs_1.default.writeFileSync(wrapperPath, lines.join("\r\n"), "utf8");
-        return wrapperPath;
-    }
-    const wrapperPath = node_path_1.default.join(wrapperDir, "tabctl-host.sh");
-    const escapedNode = nodePath.replace(/"/g, "\\\"");
-    const escapedHost = hostPath.replace(/"/g, "\\\"");
-    const lines = [
-        "#!/usr/bin/env bash",
-        "set -euo pipefail",
-    ];
-    if (profileName) {
-        lines.push(`export TABCTL_PROFILE="${profileName}"`);
-    }
-    lines.push(`exec \"${escapedNode}\" \"${escapedHost}\"`);
-    lines.push("");
-    const wrapper = lines.join("\n");
-    node_fs_1.default.writeFileSync(wrapperPath, wrapper, "utf8");
-    node_fs_1.default.chmodSync(wrapperPath, 0o700);
-    return wrapperPath;
-}
-function runSetup(options, prettyOutput) {
-    const browser = resolveBrowser(options.browser);
-    if (!browser) {
-        (0, output_1.errorOut)("Missing or invalid --browser (edge|chrome)");
-    }
-    const nodePath = resolveNodePath(options);
-    // Sync extension + host to stable paths (before extensionId so interactive mode can show it)
-    const config = (0, constants_1.resolveConfig)();
-    const hostPath = resolveHostPath(config.baseDataDir);
-    let extensionSync;
-    try {
-        extensionSync = (0, extension_sync_1.syncExtension)(config.baseDataDir, { force: true });
-    }
-    catch {
-        extensionSync = null;
-    }
-    // Resolve extension ID: explicit flag, derived from install path, or interactive prompt
-    let extensionId = resolveExtensionId(options, false);
-    if (!extensionId) {
-        // Auto-derive from the installed extension path (Chromium uses SHA256 of the path)
-        // 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) {
-        (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()
-        ? options.name.trim().toLowerCase()
-        : browser;
-    try {
-        (0, profiles_1.validateProfileName)(profileName);
-    }
-    catch (err) {
-        (0, output_1.errorOut)(err.message);
-    }
-    // Profile data dir (use baseDataDir to avoid nesting under another profile)
-    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 ? node_path_1.default.resolve(rawUserDataDir) : "";
-    const manifestDir = userDataDir
-        ? node_path_1.default.join(userDataDir, "NativeMessagingHosts")
-        : resolveManifestDir(browser);
-    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,
-        path: wrapperPath,
-        type: "stdio",
-        allowed_origins: [`chrome-extension://${extensionId}/`],
-    };
-    node_fs_1.default.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2), "utf8");
-    // Register profile
-    const profileEntry = {
-        browser,
-        extensionId,
-        nodePath,
-        hostPath,
-        dataDir: profileDataDir,
-    };
-    if (userDataDir) {
-        profileEntry.userDataDir = userDataDir;
-    }
-    const registry = (0, profiles_1.addProfile)(profileName, profileEntry);
-    // Ensure printJson footer reflects the newly-created profile
-    (0, config_1.resetConfig)();
-    process.env.TABCTL_PROFILE = profileName;
-    (0, output_1.printJson)({
-        ok: true,
-        action: "setup",
-        data: {
-            profileName,
-            browser,
-            extensionId,
-            manifestPath,
-            hostPath,
-            nodePath,
-            wrapperPath,
-            dataDir: profileDataDir,
-            ...(userDataDir ? { userDataDir } : {}),
-            isDefault: registry.default === profileName,
-            extensionDir: extensionSync?.extensionDir || null,
-            extensionSynced: extensionSync?.synced || false,
-        },
-    }, prettyOutput);
-    if (registry.default !== profileName) {
-        process.stderr.write([
-            "",
-            `Profile "${profileName}" created (current default: "${registry.default}").`,
-            `  To use:          tabctl --profile ${profileName} <command>`,
-            `  To make default: tabctl profile-switch ${profileName}`,
-            "",
-        ].join("\n"));
-    }
-    const extensionsUrl = browser === "edge" ? "edge://extensions" : "chrome://extensions";
-    const browserName = browser === "edge" ? "Edge" : "Chrome";
-    const extensionDir = extensionSync?.extensionDir || null;
-    const loadSteps = extensionDir
-        ? [
-            `Load the extension: ${extensionsUrl} → Developer mode → Load unpacked`,
-            `  Path: ${extensionDir}`,
-            process.platform === "darwin" ? "  Tip: press Cmd+Shift+G in the file dialog to paste the path" : null,
-        ].filter(Boolean).join("\n")
-        : `Load the extension: ${extensionsUrl} → Developer mode → Load unpacked`;
-    process.stderr.write([
-        loadSteps,
-        `Verify connection: tabctl --profile ${profileName} ping`,
-        `If ping fails, ensure the ${browserName} extension is active.`,
-        "",
-    ].join("\n"));
-}

package/dist/cli/lib/constants.js

@@ -1,30 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SUPPORTED_SIGNAL_SET = exports.SUPPORTED_SIGNALS = exports.SKILL_REPO = exports.SKILL_NAME = exports.DEFAULT_PAGE_LIMIT = exports.GROUP_COLORS = exports.EXTENSION_ID_PATTERN = exports.HOST_DESCRIPTION = exports.HOST_NAME = exports.resolveConfig = exports.DIRTY = exports.GIT_SHA = exports.BASE_VERSION = exports.VERSION = void 0;
-// Re-export version info from shared module
-var version_1 = require("../../shared/version");
-Object.defineProperty(exports, "VERSION", { enumerable: true, get: function () { return version_1.VERSION; } });
-Object.defineProperty(exports, "BASE_VERSION", { enumerable: true, get: function () { return version_1.BASE_VERSION; } });
-Object.defineProperty(exports, "GIT_SHA", { enumerable: true, get: function () { return version_1.GIT_SHA; } });
-Object.defineProperty(exports, "DIRTY", { enumerable: true, get: function () { return version_1.DIRTY; } });
-var config_1 = require("../../shared/config");
-Object.defineProperty(exports, "resolveConfig", { enumerable: true, get: function () { return config_1.resolveConfig; } });
-exports.HOST_NAME = "com.erwinkroon.tabctl";
-exports.HOST_DESCRIPTION = "tabctl native host";
-exports.EXTENSION_ID_PATTERN = /^[a-p]{32}$/;
-exports.GROUP_COLORS = new Set([
-    "grey",
-    "blue",
-    "red",
-    "yellow",
-    "green",
-    "pink",
-    "purple",
-    "cyan",
-    "orange",
-]);
-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", "selector"];
-exports.SUPPORTED_SIGNAL_SET = new Set(exports.SUPPORTED_SIGNALS);

package/dist/cli/lib/help.js

@@ -1,205 +0,0 @@
-"use strict";
-/**
- * Help generation using option groups from options.ts as the source of truth.
- * This eliminates duplication by referencing option groups instead of repeating
- * options for every command.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildHelpData = buildHelpData;
-exports.printHelp = printHelp;
-const constants_1 = require("./constants");
-const options_1 = require("./options");
-const output_1 = require("./output");
-// ============================================================================
-// Help Data Generation
-// ============================================================================
-function formatOption(opt) {
-    if (opt.repeatable) {
-        return `${opt.flag} (repeatable)`;
-    }
-    return opt.flag;
-}
-/**
- * Build structured help data from COMMANDS and OPTION_GROUPS.
- */
-function buildHelpData(command) {
-    // Build option groups
-    const optionGroups = Object.entries(options_1.OPTION_GROUPS).map(([_key, group]) => ({
-        name: group.name,
-        description: group.description,
-        options: group.options.map(formatOption),
-    }));
-    optionGroups.push({
-        name: options_1.SCREENSHOT_OPTIONS.name,
-        description: options_1.SCREENSHOT_OPTIONS.description,
-        options: options_1.SCREENSHOT_OPTIONS.options.map(formatOption),
-    });
-    // Build commands list with their groups and specific options
-    const commands = Object.entries(options_1.COMMANDS)
-        .map(([name, meta]) => {
-        const cmd = {
-            name,
-            description: meta.description,
-        };
-        if (meta.groups && meta.groups.length > 0) {
-            cmd.groups = [...meta.groups];
-        }
-        if (meta.options && meta.options.length > 0) {
-            cmd.options = meta.options.map(formatOption);
-        }
-        return cmd;
-    });
-    const normalizedCommand = command ? normalizeHelpCommand(command) : undefined;
-    if (normalizedCommand && !options_1.COMMANDS[normalizedCommand]) {
-        (0, output_1.errorOut)(`Unknown command: ${normalizedCommand}`);
-    }
-    const filteredCommands = normalizedCommand
-        ? commands.filter((entry) => entry.name === normalizedCommand)
-        : commands;
-    const filteredGroups = normalizedCommand
-        ? optionGroups.filter((group) => {
-            const target = filteredCommands[0];
-            if (!target?.groups || target.groups.length === 0) {
-                return false;
-            }
-            const included = target.groups.some((groupKey) => {
-                const meta = options_1.OPTION_GROUPS[groupKey];
-                return meta?.name === group.name;
-            });
-            if (target.name === "screenshot" && group.name === options_1.SCREENSHOT_OPTIONS.name) {
-                return true;
-            }
-            return included;
-        })
-        : optionGroups;
-    // Global options
-    const globalOptions = ["--help", "--json", "--pretty"];
-    // Notes
-    const notes = [
-        "--before-group/--after-group only position tabs; use group-assign to move tabs into a group.",
-        "undo accepts a txid as a positional arg (or --txid) and supports --latest.",
-        "screenshot uses --out to write per-tab folders under the target directory.",
-        "Use selector attr href-url/src-url to resolve absolute http(s) links.",
-    ];
-    return {
-        version: constants_1.VERSION,
-        usage: "tabctl <command> [options]",
-        commands: filteredCommands,
-        optionGroups: filteredGroups,
-        globalOptions,
-        notes,
-    };
-}
-function normalizeHelpCommand(command) {
-    const trimmed = command.trim();
-    if (!trimmed) {
-        return undefined;
-    }
-    if (trimmed === "groups" || trimmed === "group") {
-        return "group-list";
-    }
-    return trimmed;
-}
-// ============================================================================
-// Text Output Formatting
-// ============================================================================
-/**
- * Print help in human-readable text format.
- */
-function printHelpText(data, command) {
-    const lines = [];
-    // Header
-    lines.push("tabctl - Edge tab management CLI");
-    lines.push(`Version: ${data.version}`);
-    lines.push("");
-    lines.push(`Usage: ${data.usage}`);
-    lines.push("");
-    if (!command) {
-        // Commands grouped by category
-        lines.push("Commands:");
-        const commandNames = data.commands.map((c) => c.name);
-        lines.push(`  ${commandNames.join(", ")}`);
-        lines.push("");
-    }
-    // Option Groups
-    if (!command) {
-        lines.push("Option Groups:");
-        lines.push("  (Commands reference these groups; see command details below)");
-        lines.push("");
-        for (const group of data.optionGroups) {
-            lines.push(`  [${group.name}] - ${group.description}`);
-            for (const opt of group.options) {
-                lines.push(`    ${opt}`);
-            }
-            lines.push("");
-        }
-    }
-    else {
-        for (const group of data.optionGroups) {
-            lines.push(`Options (${group.name}):`);
-            for (const opt of group.options) {
-                lines.push(`  ${opt}`);
-            }
-            lines.push("");
-        }
-    }
-    // Command Details
-    lines.push("Command Details:");
-    for (const cmd of data.commands) {
-        const parts = [`  ${cmd.name}`];
-        if (cmd.description) {
-            parts.push(`- ${cmd.description}`);
-        }
-        lines.push(parts.join(" "));
-        // Show which groups the command uses
-        if (!command && cmd.groups && cmd.groups.length > 0) {
-            const groupRefs = cmd.groups.map((g) => {
-                const group = options_1.OPTION_GROUPS[g];
-                return group ? `[${group.name}]` : `[${g}]`;
-            });
-            lines.push(`    Uses: ${groupRefs.join(", ")}`);
-        }
-        // Show command-specific options
-        if (cmd.options && cmd.options.length > 0) {
-            lines.push("    Options:");
-            for (const opt of cmd.options) {
-                lines.push(`      ${opt}`);
-            }
-        }
-    }
-    lines.push("");
-    // Global Options
-    if (!command) {
-        lines.push("Global Options:");
-        for (const opt of data.globalOptions) {
-            lines.push(`  ${opt}`);
-        }
-        lines.push("");
-    }
-    // Notes
-    if (!command) {
-        lines.push("Notes:");
-        for (const note of data.notes) {
-            lines.push(`  ${note}`);
-        }
-        lines.push("");
-    }
-    // Policy location
-    lines.push("Policy: $XDG_CONFIG_HOME/tabctl/policy.json (or ~/.config/tabctl/policy.json)");
-    lines.push("Policy is enforced when the file exists; missing file means no policy.");
-    process.stdout.write(lines.join("\n") + "\n");
-}
-// ============================================================================
-// Public API
-// ============================================================================
-/**
- * Print help output in either JSON or text format.
- */
-function printHelp(jsonOutput, command) {
-    const data = buildHelpData(command);
-    if (jsonOutput) {
-        (0, output_1.printJson)({ ok: true, data });
-        return;
-    }
-    printHelpText(data, command);
-}