tabctl 0.1.0

package/cli/lib/commands/meta.js

@@ -0,0 +1,493 @@
+"use strict";
+/**
+ * Meta command handlers: version, ping, setup, skill, policy, history, undo
+ * These commands don't operate on tab data and are relatively self-contained.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSetup = runSetup;
+exports.runSkillInstall = runSkillInstall;
+exports.runVersion = runVersion;
+exports.runPolicy = runPolicy;
+exports.runHistory = runHistory;
+exports.runUndo = runUndo;
+exports.runPing = runPing;
+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 constants_1 = require("../constants");
+const output_1 = require("../output");
+const client_1 = require("../client");
+const policy_1 = require("../policy");
+const profiles_1 = require("../../../shared/profiles");
+const extension_sync_1 = require("../../../shared/extension-sync");
+// ============================================================================
+// Setup Command
+// ============================================================================
+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;
+}
+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)
+        : (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 (!path_1.default.isAbsolute(value)) {
+        (0, output_1.errorOut)(`Node path must be absolute: ${value}`);
+    }
+    try {
+        fs_1.default.accessSync(value, fs_1.default.constants.X_OK);
+    }
+    catch {
+        (0, output_1.errorOut)(`Node binary not executable: ${value}`);
+    }
+    return value;
+}
+function resolveHostPath() {
+    const root = path_1.default.resolve(__dirname, "../../..");
+    const hostPath = path_1.default.join(root, "host", "host.js");
+    if (!fs_1.default.existsSync(hostPath)) {
+        (0, output_1.errorOut)(`Host script not found at ${hostPath}. Run: npm run build`);
+    }
+    return hostPath;
+}
+function resolveManifestDir(browser) {
+    const home = os_1.default.homedir();
+    if (!home) {
+        (0, output_1.errorOut)("Home directory not found.");
+    }
+    if (browser === "edge") {
+        return path_1.default.join(home, "Library", "Application Support", "Microsoft Edge", "NativeMessagingHosts");
+    }
+    return path_1.default.join(home, "Library", "Application Support", "Google", "Chrome", "NativeMessagingHosts");
+}
+function writeWrapper(nodePath, hostPath, profileName, wrapperDir) {
+    fs_1.default.mkdirSync(wrapperDir, { recursive: true, mode: 0o700 });
+    const wrapperPath = 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");
+    fs_1.default.writeFileSync(wrapperPath, wrapper, "utf8");
+    fs_1.default.chmodSync(wrapperPath, 0o700);
+    return wrapperPath;
+}
+async function runSetup(options, prettyOutput) {
+    if (process.platform !== "darwin") {
+        (0, output_1.errorOut)("tabctl setup is only supported on macOS.");
+    }
+    const browser = resolveBrowser(options.browser);
+    if (!browser) {
+        (0, output_1.errorOut)("Missing or invalid --browser (edge|chrome)");
+    }
+    const nodePath = resolveNodePath(options);
+    const hostPath = resolveHostPath();
+    // Sync extension to stable path (before extensionId so interactive mode can show it)
+    const config = (0, constants_1.resolveConfig)();
+    let extensionSync;
+    try {
+        extensionSync = (0, extension_sync_1.syncExtension)(config.baseDataDir);
+    }
+    catch {
+        extensionSync = null;
+    }
+    // Resolve extension ID: non-interactive if provided, interactive otherwise
+    let extensionId = resolveExtensionId(options, false);
+    if (!extensionId) {
+        // Interactive mode
+        if (extensionSync?.extensionDir) {
+            process.stderr.write(`\nExtension synced to: ${extensionSync.extensionDir}\n`);
+            try {
+                const pbcopy = (0, node_child_process_1.spawn)("pbcopy", { stdio: ["pipe", "ignore", "ignore"] });
+                pbcopy.stdin.end(extensionSync.extensionDir);
+                pbcopy.on("exit", (code) => {
+                    if (code === 0)
+                        process.stderr.write("(Path copied to clipboard)\n");
+                });
+            }
+            catch {
+                // clipboard copy is best-effort
+            }
+        }
+        extensionId = await promptExtensionId(browser);
+    }
+    // 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 = path_1.default.join(config.baseDataDir, "profiles", profileName);
+    fs_1.default.mkdirSync(profileDataDir, { recursive: true, mode: 0o700 });
+    // 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 manifestDir = userDataDir
+        ? 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`);
+    const manifest = {
+        name: constants_1.HOST_NAME,
+        description: constants_1.HOST_DESCRIPTION,
+        path: wrapperPath,
+        type: "stdio",
+        allowed_origins: [`chrome-extension://${extensionId}/`],
+    };
+    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);
+    (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);
+}
+// ============================================================================
+// Skill Command
+// ============================================================================
+function formatCliArgValue(value) {
+    const raw = String(value);
+    if (!raw) {
+        return raw;
+    }
+    if (/[\s"]/g.test(raw)) {
+        const escaped = raw.replace(/"/g, "\\\"");
+        return `"${escaped}"`;
+    }
+    return raw;
+}
+function resolveProjectRoot() {
+    try {
+        return fs_1.default.realpathSync(process.cwd());
+    }
+    catch {
+        return path_1.default.resolve(process.cwd());
+    }
+}
+function resolveConfigHome() {
+    return process.env.XDG_CONFIG_HOME || path_1.default.join(os_1.default.homedir(), ".config");
+}
+function resolveSkillTargetDir(globalInstall) {
+    if (globalInstall) {
+        return path_1.default.join(resolveConfigHome(), "opencode", "skills", constants_1.SKILL_NAME);
+    }
+    return path_1.default.join(resolveProjectRoot(), ".opencode", "skills", constants_1.SKILL_NAME);
+}
+function runSkillsCli(args) {
+    const result = (0, node_child_process_1.spawnSync)("npx", ["skills", ...args], { stdio: "pipe" });
+    if (result.error) {
+        (0, output_1.errorOut)(`Failed to run skills CLI: ${result.error.message}`);
+    }
+    if (typeof result.status === "number" && result.status !== 0) {
+        const stderr = result.stderr ? result.stderr.toString().trim() : "";
+        const stdout = result.stdout ? result.stdout.toString().trim() : "";
+        const detail = stderr || stdout;
+        const message = detail ? `skills CLI failed: ${detail}` : `skills CLI exited with status ${result.status}`;
+        (0, output_1.errorOut)(message);
+    }
+}
+function runSkillInstall(options, prettyOutput) {
+    const globalInstall = options.global === true;
+    const installTarget = resolveSkillTargetDir(globalInstall);
+    const agents = Array.isArray(options.agent)
+        ? options.agent.filter((value) => typeof value === "string" && value.trim())
+        : [];
+    const args = ["add", constants_1.SKILL_REPO, "--skill", constants_1.SKILL_NAME];
+    if (agents.length > 0) {
+        for (const agent of agents) {
+            args.push("-a", agent);
+        }
+    }
+    if (globalInstall) {
+        args.push("-g");
+    }
+    const hintAgents = agents.length > 0 ? agents.map((agent) => `-a ${formatCliArgValue(agent)}`).join(" ") : "";
+    const installHintParts = ["npx skills add", formatCliArgValue(constants_1.SKILL_REPO), "--skill", constants_1.SKILL_NAME];
+    if (hintAgents) {
+        installHintParts.push(hintAgents);
+    }
+    if (globalInstall) {
+        installHintParts.push("-g");
+    }
+    const installHint = installHintParts.join(" ").trim();
+    runSkillsCli(args);
+    (0, output_1.printJson)({
+        ok: true,
+        data: {
+            name: constants_1.SKILL_NAME,
+            targetDir: installTarget,
+            scope: globalInstall ? "global" : "project",
+            installHint,
+            tool: "skills",
+        },
+    }, prettyOutput);
+}
+// ============================================================================
+// Version Command
+// ============================================================================
+function runVersion(prettyOutput) {
+    (0, output_1.printJson)({
+        ok: true,
+        data: {
+            version: constants_1.VERSION,
+            baseVersion: constants_1.BASE_VERSION,
+            gitSha: constants_1.GIT_SHA,
+            dirty: constants_1.DIRTY,
+            component: "cli",
+        },
+    }, prettyOutput);
+}
+// ============================================================================
+// Policy Command
+// ============================================================================
+function runPolicy(options, policyContext, prettyOutput) {
+    const policyPath = (0, policy_1.defaultPolicyPath)();
+    if (options.init) {
+        if (fs_1.default.existsSync(policyPath)) {
+            (0, output_1.printJson)({
+                ok: true,
+                data: {
+                    status: "exists",
+                    path: policyPath,
+                },
+            }, prettyOutput);
+            return;
+        }
+        const dir = path_1.default.dirname(policyPath);
+        fs_1.default.mkdirSync(dir, { recursive: true });
+        fs_1.default.writeFileSync(policyPath, JSON.stringify((0, policy_1.defaultPolicyTemplate)(), null, 2), "utf8");
+        (0, output_1.printJson)({
+            ok: true,
+            data: {
+                status: "created",
+                path: policyPath,
+            },
+        }, prettyOutput);
+        return;
+    }
+    const policySummary = (0, policy_1.summarizePolicy)(policyContext.policy, policyContext.path);
+    (0, output_1.printJson)({
+        ok: true,
+        data: {
+            ...policySummary,
+            path: policyPath,
+        },
+    }, prettyOutput);
+}
+// ============================================================================
+// History Command
+// ============================================================================
+async function runHistory(options, prettyOutput) {
+    const params = {
+        limit: options.limit ? Number(options.limit) : undefined,
+    };
+    const response = await (0, client_1.sendRequest)({
+        id: (0, client_1.createRequestId)(),
+        action: "history",
+        params,
+        client: {
+            component: "cli",
+            version: constants_1.VERSION,
+            baseVersion: constants_1.BASE_VERSION,
+            gitSha: constants_1.GIT_SHA,
+            dirty: constants_1.DIRTY,
+        },
+    });
+    (0, output_1.printJson)(response, prettyOutput);
+    if (!response.ok) {
+        process.exit(1);
+    }
+}
+// ============================================================================
+// Undo Command
+// ============================================================================
+async function runUndo(options, prettyOutput) {
+    const positionalTxid = options._[0];
+    const flagTxid = options.txid;
+    const useLatest = options.latest === true;
+    if (useLatest && (positionalTxid || flagTxid)) {
+        (0, output_1.errorOut)("--latest cannot be combined with a txid argument or --txid");
+    }
+    const txid = positionalTxid || flagTxid;
+    const params = {
+        txid,
+        latest: useLatest,
+    };
+    const response = await (0, client_1.sendRequest)({
+        id: (0, client_1.createRequestId)(),
+        action: "undo",
+        params,
+        client: {
+            component: "cli",
+            version: constants_1.VERSION,
+            baseVersion: constants_1.BASE_VERSION,
+            gitSha: constants_1.GIT_SHA,
+            dirty: constants_1.DIRTY,
+        },
+    });
+    (0, output_1.printJson)(response, prettyOutput);
+    if (!response.ok) {
+        process.exit(1);
+    }
+}
+// ============================================================================
+// Ping Command
+// ============================================================================
+async function runPing(prettyOutput) {
+    const response = await (0, client_1.sendRequest)({
+        id: (0, client_1.createRequestId)(),
+        action: "ping",
+        params: {},
+        client: {
+            component: "cli",
+            version: constants_1.VERSION,
+            baseVersion: constants_1.BASE_VERSION,
+            gitSha: constants_1.GIT_SHA,
+            dirty: constants_1.DIRTY,
+        },
+    });
+    (0, output_1.printJson)(response, prettyOutput);
+    if (!response.ok) {
+        process.exit(1);
+    }
+}