@hypercli/hq 0.1.1

package/dist/services/projects.js

@@ -0,0 +1,147 @@
+import { spawnSync } from "node:child_process";
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { basename, resolve } from "node:path";
+function isGitRepo(dir) {
+    // .git can be a directory (regular repo) or a file (worktree checkout)
+    return existsSync(resolve(dir, ".git"));
+}
+function parseWorktreeListPorcelain(output) {
+    const worktrees = [];
+    let current = {};
+    for (const line of output.split("\n")) {
+        if (line.startsWith("worktree ")) {
+            if (current.path)
+                worktrees.push(current);
+            current = { path: line.slice(9), isMain: false, isCurrent: false };
+        }
+        else if (line.startsWith("branch ")) {
+            const ref = line.slice(7); // refs/heads/main -> main
+            current.branch = ref.replace("refs/heads/", "");
+        }
+        else if (line === "bare") {
+            current.branch = "(bare)";
+        }
+        else if (line === "detached") {
+            current.branch = current.branch ?? "(detached)";
+        }
+        else if (line === "") {
+            // blank line = end of entry
+        }
+    }
+    if (current.path)
+        worktrees.push(current);
+    // Mark first as main
+    if (worktrees.length > 0) {
+        worktrees[0].isMain = true;
+    }
+    return worktrees;
+}
+function getWorktrees(projectDir) {
+    // Try wt list --format=json first (richer data)
+    const wtResult = spawnSync("wt", ["list", "--format=json"], {
+        cwd: projectDir,
+        encoding: "utf-8",
+        timeout: 5000,
+    });
+    if (wtResult.status === 0 && wtResult.stdout) {
+        try {
+            const data = JSON.parse(wtResult.stdout);
+            return data.map((w) => ({
+                path: w.path,
+                branch: w.branch,
+                isMain: w.is_main,
+                isCurrent: w.is_current,
+            }));
+        }
+        catch {
+            // Fall through to git worktree list
+        }
+    }
+    // Fallback to git worktree list
+    const gitResult = spawnSync("git", ["worktree", "list", "--porcelain"], {
+        cwd: projectDir,
+        encoding: "utf-8",
+        timeout: 5000,
+    });
+    if (gitResult.status === 0 && gitResult.stdout) {
+        return parseWorktreeListPorcelain(gitResult.stdout);
+    }
+    return [];
+}
+function discoverDir(dir, namePrefix, config) {
+    const projects = [];
+    let entries;
+    try {
+        entries = readdirSync(dir).filter((e) => {
+            const full = resolve(dir, e);
+            return statSync(full).isDirectory() && !e.startsWith(".");
+        });
+    }
+    catch {
+        return projects;
+    }
+    for (const entry of entries) {
+        const fullPath = resolve(dir, entry);
+        const projectName = namePrefix ? `${namePrefix}/${entry}` : entry;
+        const override = config.projects[entry];
+        // If configured as a group, recurse
+        if (override?.type === "group") {
+            projects.push(...discoverDir(fullPath, projectName, config));
+            continue;
+        }
+        const git = isGitRepo(fullPath);
+        let worktrees = [];
+        let hasWorktrees = false;
+        if (git) {
+            worktrees = getWorktrees(fullPath);
+            hasWorktrees = worktrees.length > 1;
+        }
+        projects.push({
+            name: projectName,
+            path: fullPath,
+            isGit: git,
+            hasWorktrees,
+            worktrees,
+        });
+    }
+    return projects.sort((a, b) => a.name.localeCompare(b.name));
+}
+export function listProjects(config) {
+    return discoverDir(config.projects_root, "", config);
+}
+export function findProject(name, config) {
+    const projects = listProjects(config);
+    return projects.find((p) => p.name === name);
+}
+export function resolveProjectDir(project, config) {
+    if (project.startsWith("/"))
+        return project;
+    return resolve(config.projects_root, project);
+}
+export function createWorktree(projectDir, branch) {
+    const result = spawnSync("wt", ["switch", "-c", branch], {
+        cwd: projectDir,
+        encoding: "utf-8",
+        stdio: ["pipe", "pipe", "pipe"],
+        timeout: 30_000,
+    });
+    if (result.status !== 0) {
+        throw new Error(`Failed to create worktree '${branch}': ${result.stderr}`);
+    }
+    // wt switch changes directory — get the new worktree path
+    // Parse it from wt list
+    const worktrees = getWorktrees(projectDir);
+    const wt = worktrees.find((w) => w.branch === branch);
+    if (wt)
+        return wt.path;
+    // Fallback: construct path from worktrunk convention (sibling dir)
+    const repoName = basename(projectDir);
+    const sanitizedBranch = branch.replace(/\//g, "-");
+    return resolve(projectDir, "..", `${repoName}.${sanitizedBranch}`);
+}
+export function findWorktreePath(projectDir, branchOrName) {
+    const worktrees = getWorktrees(projectDir);
+    const match = worktrees.find((w) => w.branch === branchOrName || basename(w.path) === branchOrName);
+    return match?.path;
+}
+//# sourceMappingURL=projects.js.map

package/dist/services/projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.js","sourceRoot":"","sources":["../../src/services/projects.ts"],"names":[],"mappings":"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"}

package/dist/services/telegram.d.ts

@@ -0,0 +1,8 @@
+import type { HqConfig } from "../config/schema.js";
+export interface TelegramEnv {
+    TELEGRAM_BOT_TOKEN: string;
+    TELEGRAM_STATE_DIR: string;
+}
+export declare function getHqTelegramEnv(config: HqConfig): TelegramEnv | null;
+export declare function getProjectTelegramEnv(projectName: string, config: HqConfig): TelegramEnv | null;
+//# sourceMappingURL=telegram.d.ts.map

package/dist/services/telegram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/services/telegram.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;CAC3B;AAID,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,IAAI,CAQrE;AAED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,IAAI,CAU/F"}

package/dist/services/telegram.js

@@ -0,0 +1,26 @@
+import { mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { resolve } from "node:path";
+const TELEGRAM_STATE_ROOT = resolve(homedir(), ".config/hyper/hq-telegram-state");
+export function getHqTelegramEnv(config) {
+    if (!config.telegram.hq_bot_token)
+        return null;
+    const stateDir = resolve(TELEGRAM_STATE_ROOT, "hq");
+    mkdirSync(stateDir, { recursive: true });
+    return {
+        TELEGRAM_BOT_TOKEN: config.telegram.hq_bot_token,
+        TELEGRAM_STATE_DIR: stateDir,
+    };
+}
+export function getProjectTelegramEnv(projectName, config) {
+    const token = config.telegram.project_bots[projectName];
+    if (!token)
+        return null;
+    const stateDir = resolve(TELEGRAM_STATE_ROOT, projectName);
+    mkdirSync(stateDir, { recursive: true });
+    return {
+        TELEGRAM_BOT_TOKEN: token,
+        TELEGRAM_STATE_DIR: stateDir,
+    };
+}
+//# sourceMappingURL=telegram.js.map

package/dist/services/telegram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.js","sourceRoot":"","sources":["../../src/services/telegram.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,MAAM,mBAAmB,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,iCAAiC,CAAC,CAAC;AAElF,MAAM,UAAU,gBAAgB,CAAC,MAAgB;IAChD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC;IAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC;IACpD,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,OAAO;QACN,kBAAkB,EAAE,MAAM,CAAC,QAAQ,CAAC,YAAY;QAChD,kBAAkB,EAAE,QAAQ;KAC5B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,WAAmB,EAAE,MAAgB;IAC1E,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IACxD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,MAAM,QAAQ,GAAG,OAAO,CAAC,mBAAmB,EAAE,WAAW,CAAC,CAAC;IAC3D,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,OAAO;QACN,kBAAkB,EAAE,KAAK;QACzB,kBAAkB,EAAE,QAAQ;KAC5B,CAAC;AACH,CAAC"}

package/dist/services/tmux.d.ts

@@ -0,0 +1,25 @@
+export interface TmuxSession {
+    name: string;
+    created: string;
+    windows: number;
+    attached: boolean;
+}
+/** Sanitize a string for use as a tmux session name (no dots or colons) */
+export declare function sanitizeSessionName(name: string): string;
+export declare function sessionExists(name: string): boolean;
+export declare function createSession(opts: {
+    name: string;
+    cwd: string;
+    command: string;
+}): void;
+/**
+ * Wait and verify a session's command is still running.
+ * Polls for up to `timeoutMs`, checking every 500ms.
+ * Returns `'running'` if alive, `'dead'` if the pane's command exited.
+ */
+export declare function waitAndVerify(name: string, timeoutMs?: number): "running" | "dead";
+export declare function killSession(name: string): boolean;
+export declare function listSessions(prefix?: string): TmuxSession[];
+export declare function disableRemainOnExit(name: string): void;
+export declare function attachSession(name: string): never;
+//# sourceMappingURL=tmux.d.ts.map

package/dist/services/tmux.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmux.d.ts","sourceRoot":"","sources":["../../src/services/tmux.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED,2EAA2E;AAC3E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAWD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAmBxF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAO,GAAG,SAAS,GAAG,MAAM,CAkBhF;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,wBAAgB,YAAY,CAAC,MAAM,SAAU,GAAG,WAAW,EAAE,CAkB5D;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEtD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAGjD"}

package/dist/services/tmux.js

@@ -0,0 +1,87 @@
+import { execFileSync, spawnSync } from "node:child_process";
+/** Sanitize a string for use as a tmux session name (no dots or colons) */
+export function sanitizeSessionName(name) {
+    return name.replace(/[.:]/g, "-");
+}
+function run(args) {
+    const result = spawnSync("tmux", args, { encoding: "utf-8" });
+    return {
+        ok: result.status === 0,
+        stdout: (result.stdout ?? "").trim(),
+        stderr: (result.stderr ?? "").trim(),
+    };
+}
+export function sessionExists(name) {
+    return run(["has-session", "-t", name]).ok;
+}
+export function createSession(opts) {
+    // Use remain-on-exit so the pane stays around if the command fails,
+    // allowing us to read the exit status and show a useful error.
+    const result = run([
+        "new-session",
+        "-d",
+        "-s",
+        opts.name,
+        "-c",
+        opts.cwd,
+        "-e",
+        "CLINT_SESSION=1",
+        opts.command,
+    ]);
+    if (!result.ok) {
+        throw new Error(`Failed to create tmux session '${opts.name}': ${result.stderr}`);
+    }
+    // Keep the pane alive after the command exits so we can detect failures
+    run(["set-option", "-t", opts.name, "remain-on-exit", "on"]);
+}
+/**
+ * Wait and verify a session's command is still running.
+ * Polls for up to `timeoutMs`, checking every 500ms.
+ * Returns `'running'` if alive, `'dead'` if the pane's command exited.
+ */
+export function waitAndVerify(name, timeoutMs = 5000) {
+    const start = Date.now();
+    while (Date.now() - start < timeoutMs) {
+        spawnSync("sleep", ["0.5"]);
+        // Check if session still exists at all
+        if (!sessionExists(name))
+            return "dead";
+        // Check if the pane process is still running
+        const paneResult = run(["list-panes", "-t", name, "-F", "#{pane_dead}"]);
+        if (paneResult.ok && paneResult.stdout.trim() === "1") {
+            // Pane is dead — command exited. Clean up the session.
+            killSession(name);
+            return "dead";
+        }
+    }
+    return "running";
+}
+export function killSession(name) {
+    return run(["kill-session", "-t", name]).ok;
+}
+export function listSessions(prefix = "clint") {
+    const format = "#{session_name}\t#{session_created_string}\t#{session_windows}\t#{?session_attached,1,0}";
+    const result = run(["list-sessions", "-F", format]);
+    if (!result.ok)
+        return [];
+    return result.stdout
+        .split("\n")
+        .filter((line) => line.startsWith(prefix))
+        .map((line) => {
+        const [name, created, windows, attached] = line.split("\t");
+        return {
+            name: name,
+            created: created,
+            windows: Number.parseInt(windows, 10),
+            attached: attached === "1",
+        };
+    });
+}
+export function disableRemainOnExit(name) {
+    run(["set-option", "-t", name, "remain-on-exit", "off"]);
+}
+export function attachSession(name) {
+    execFileSync("tmux", ["attach", "-t", name], { stdio: "inherit" });
+    process.exit(0);
+}
+//# sourceMappingURL=tmux.js.map

package/dist/services/tmux.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmux.js","sourceRoot":"","sources":["../../src/services/tmux.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAS7D,2EAA2E;AAC3E,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,GAAG,CAAC,IAAc;IAC1B,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IAC9D,OAAO;QACN,EAAE,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QACvB,MAAM,EAAE,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;QACpC,MAAM,EAAE,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;KACpC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACzC,OAAO,GAAG,CAAC,CAAC,aAAa,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAoD;IACjF,oEAAoE;IACpE,+DAA+D;IAC/D,MAAM,MAAM,GAAG,GAAG,CAAC;QAClB,aAAa;QACb,IAAI;QACJ,IAAI;QACJ,IAAI,CAAC,IAAI;QACT,IAAI;QACJ,IAAI,CAAC,GAAG;QACR,IAAI;QACJ,iBAAiB;QACjB,IAAI,CAAC,OAAO;KACZ,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,CAAC,IAAI,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACnF,CAAC;IACD,wEAAwE;IACxE,GAAG,CAAC,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,SAAS,GAAG,IAAI;IAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,SAAS,EAAE,CAAC;QACvC,SAAS,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;QAE5B,uCAAuC;QACvC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;YAAE,OAAO,MAAM,CAAC;QAExC,6CAA6C;QAC7C,MAAM,UAAU,GAAG,GAAG,CAAC,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC;QACzE,IAAI,UAAU,CAAC,EAAE,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACvD,uDAAuD;YACvD,WAAW,CAAC,IAAI,CAAC,CAAC;YAClB,OAAO,MAAM,CAAC;QACf,CAAC;IACF,CAAC;IAED,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACvC,OAAO,GAAG,CAAC,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAM,GAAG,OAAO;IAC5C,MAAM,MAAM,GACX,0FAA0F,CAAC;IAC5F,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,eAAe,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,EAAE,CAAC;IAE1B,OAAO,MAAM,CAAC,MAAM;SAClB,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;SACzC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACb,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5D,OAAO;YACN,IAAI,EAAE,IAAK;YACX,OAAO,EAAE,OAAQ;YACjB,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAQ,EAAE,EAAE,CAAC;YACtC,QAAQ,EAAE,QAAQ,KAAK,GAAG;SAC1B,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC/C,GAAG,CAAC,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACzC,YAAY,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC"}

package/dist/utils/banner.d.ts

@@ -0,0 +1,7 @@
+import type { HqConfig } from "../config/schema.js";
+export declare function renderBanner(opts: {
+    config: HqConfig;
+    sessionName: string;
+    logFile: string;
+}): string;
+//# sourceMappingURL=banner.d.ts.map

package/dist/utils/banner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../../src/utils/banner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAwBpD,wBAAgB,YAAY,CAAC,IAAI,EAAE;IAClC,MAAM,EAAE,QAAQ,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,CA4DT"}

package/dist/utils/banner.js

@@ -0,0 +1,80 @@
+import { readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { CONFIG_PATH } from "../config/index.js";
+import { listProjects } from "../services/projects.js";
+function shorten(path) {
+    const home = homedir();
+    if (path.startsWith(home))
+        return `~${path.slice(home.length)}`;
+    return path;
+}
+function extractBridgeUrl(logFile) {
+    try {
+        const content = readFileSync(logFile, "utf-8");
+        // biome-ignore lint/suspicious/noControlCharactersInRegex: need to strip ANSI escape codes from tmux log
+        const matches = content.match(/https:\/\/claude\.ai\/code\?bridge=[^\s\x1b]*/g);
+        if (matches && matches.length > 0)
+            return matches[matches.length - 1];
+    }
+    catch { }
+    return null;
+}
+function pad(label, value, width) {
+    const content = `	${label}${value}`;
+    return `║${content.padEnd(width)}║`;
+}
+export function renderBanner(opts) {
+    const { config, sessionName, logFile } = opts;
+    let projectCount;
+    try {
+        projectCount = listProjects(config).length;
+    }
+    catch {
+        projectCount = 0;
+    }
+    const telegramStatus = config.telegram.hq_bot_token ? "enabled" : "disabled";
+    const bridgeUrl = extractBridgeUrl(logFile);
+    const connectValue = bridgeUrl ?? `claude.ai/code → ${sessionName}`;
+    // Build content rows to determine width
+    const rows = [
+        ["Config:		", shorten(CONFIG_PATH)],
+        ["Projects:	", `${shorten(config.projects_root)} (${projectCount} found)`],
+        ["Telegram:	", telegramStatus],
+        null,
+        ["Session:	 ", sessionName],
+        ["Connect:	 ", connectValue],
+        null,
+        ["Commands:", ""],
+        ["	hyper hq list", "					List projects"],
+        ["	hyper hq spawn <name>", "	Start project session"],
+        ["	hyper hq status", "				Show running sessions"],
+        ["	hyper hq attach", "				Attach to HQ terminal"],
+        ["	hyper hq config", "				Show configuration"],
+        ["	hyper hq stop-all", "			Stop everything"],
+    ];
+    const title = "	Hyper HQ — Claude Code Command Center";
+    // Calculate width: widest content + 2 for padding
+    let maxContent = title.length;
+    for (const row of rows) {
+        if (row) {
+            const len = `	${row[0]}${row[1]}`.length;
+            if (len > maxContent)
+                maxContent = len;
+        }
+    }
+    const w = maxContent + 2; // inner width with padding
+    const bar = "═".repeat(w);
+    const empty = `║${" ".repeat(w)}║`;
+    const lines = ["", `╔${bar}╗`, `║${title.padEnd(w)}║`, `╠${bar}╣`, empty];
+    for (const row of rows) {
+        if (row === null) {
+            lines.push(empty);
+        }
+        else {
+            lines.push(pad(row[0], row[1], w));
+        }
+    }
+    lines.push(empty, `╚${bar}╝`, "");
+    return lines.join("\n");
+}
+//# sourceMappingURL=banner.js.map

package/dist/utils/banner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.js","sourceRoot":"","sources":["../../src/utils/banner.ts"],"names":[],"mappings":"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"}

package/dist/utils/log.d.ts

@@ -0,0 +1,2 @@
+export declare function log(message: string): void;
+//# sourceMappingURL=log.d.ts.map

package/dist/utils/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/utils/log.ts"],"names":[],"mappings":"AAAA,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAGzC"}

package/dist/utils/log.js

@@ -0,0 +1,5 @@
+export function log(message) {
+    const ts = new Date().toISOString().replace("T", " ").slice(0, 19);
+    console.log(`[${ts}] ${message}`);
+}
+//# sourceMappingURL=log.js.map

package/dist/utils/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/utils/log.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,GAAG,CAAC,OAAe;IAClC,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACnE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC,CAAC;AACnC,CAAC"}

package/dist/utils/paths.d.ts

@@ -0,0 +1,4 @@
+export declare const HQ_DATA_DIR: string;
+export declare const LOG_DIR: string;
+export declare function expandHome(p: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,WAAW,QAAsC,CAAC;AAC/D,eAAO,MAAM,OAAO,QAA+B,CAAC;AAEpD,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAG5C"}

package/dist/utils/paths.js

@@ -0,0 +1,10 @@
+import { homedir } from "node:os";
+import { resolve } from "node:path";
+export const HQ_DATA_DIR = resolve(homedir(), ".config/hyper");
+export const LOG_DIR = resolve(HQ_DATA_DIR, "logs");
+export function expandHome(p) {
+    if (p.startsWith("~/"))
+        return resolve(homedir(), p.slice(2));
+    return p;
+}
+//# sourceMappingURL=paths.js.map

package/dist/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,eAAe,CAAC,CAAC;AAC/D,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AAEpD,MAAM,UAAU,UAAU,CAAC,CAAS;IACnC,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,OAAO,CAAC,CAAC;AACV,CAAC"}

package/dist/utils/trust.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Check if a directory (or any ancestor) is trusted by Claude Code.
+ * Workspace trust is stored as project dirs under ~/.claude/projects/
+ * with path encoded using dashes (e.g. /Users/foo/work → -Users-foo-work).
+ * Subdirectories of trusted workspaces are also trusted.
+ */
+export declare function isWorkspaceTrusted(dir: string): boolean;
+/**
+ * Trust a directory for Claude Code by creating its project entry.
+ * This is equivalent to running `claude` in the directory and accepting the trust dialog.
+ */
+export declare function trustWorkspace(dir: string): void;
+//# sourceMappingURL=trust.d.ts.map

package/dist/utils/trust.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trust.d.ts","sourceRoot":"","sources":["../../src/utils/trust.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAQvD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAGhD"}

package/dist/utils/trust.js

@@ -0,0 +1,29 @@
+import { existsSync, mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, resolve } from "node:path";
+const CLAUDE_PROJECTS_DIR = resolve(homedir(), ".claude/projects");
+/**
+ * Check if a directory (or any ancestor) is trusted by Claude Code.
+ * Workspace trust is stored as project dirs under ~/.claude/projects/
+ * with path encoded using dashes (e.g. /Users/foo/work → -Users-foo-work).
+ * Subdirectories of trusted workspaces are also trusted.
+ */
+export function isWorkspaceTrusted(dir) {
+    let current = dir;
+    while (current !== "/") {
+        const encoded = current.replace(/\//g, "-");
+        if (existsSync(resolve(CLAUDE_PROJECTS_DIR, encoded)))
+            return true;
+        current = dirname(current);
+    }
+    return false;
+}
+/**
+ * Trust a directory for Claude Code by creating its project entry.
+ * This is equivalent to running `claude` in the directory and accepting the trust dialog.
+ */
+export function trustWorkspace(dir) {
+    const encoded = dir.replace(/\//g, "-");
+    mkdirSync(resolve(CLAUDE_PROJECTS_DIR, encoded), { recursive: true });
+}
+//# sourceMappingURL=trust.js.map

package/dist/utils/trust.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trust.js","sourceRoot":"","sources":["../../src/utils/trust.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,mBAAmB,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,kBAAkB,CAAC,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC7C,IAAI,OAAO,GAAG,GAAG,CAAC;IAClB,OAAO,OAAO,KAAK,GAAG,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC5C,IAAI,UAAU,CAAC,OAAO,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QACnE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACzC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACxC,SAAS,CAAC,OAAO,CAAC,mBAAmB,EAAE,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACvE,CAAC"}

package/help/hq/attach.md

@@ -0,0 +1,32 @@
+# hyper hq attach
+
+Attach to an HQ tmux session in your current terminal.
+
+## Usage
+
+`hyper hq attach [session]`
+
+## Arguments
+
+| Argument | Description |
+|----------|-------------|
+| `session` | Session name or project name (default: `hyper-hq`) |
+
+## Examples
+
+```sh
+# Attach to the main HQ session
+hyper hq attach
+
+# Attach to a project session by project name
+hyper hq attach my-project
+
+# Attach using the full session name
+hyper hq attach hq-my-project
+```
+
+## Notes
+
+- If the argument does not start with `hq`, the prefix `hq-` is added automatically — so `hyper hq attach my-project` targets the session named `hq-my-project`.
+- Requires tmux to be installed and the session to already be running. Use `hyper hq status` to list active sessions.
+- Detach from the session with `Ctrl-b d` (standard tmux detach).

package/help/hq/config.md

@@ -0,0 +1,50 @@
+# hyper hq config
+
+Show HQ configuration.
+
+## Usage
+
+`hyper hq config [flags]`
+
+## Flags
+
+| Flag | Description |
+|------|-------------|
+| `--json` | Output as JSON |
+| `--path` | Print the config file path only |
+
+## Examples
+
+```sh
+# Show configuration summary
+hyper hq config
+
+# Print raw JSON
+hyper hq config --json
+
+# Print the config file path (useful for editors)
+hyper hq config --path
+```
+
+## Output
+
+```
+Config file: /home/user/.config/hyper/hq.toml
+
+  projects_root     /home/user/projects
+  hq.name           hyper-hq
+  hq.dir            /home/user/.config/hyper/hq
+  hq.spawn_mode     same-dir
+  hq.capacity       8
+  claude.mode       default
+  telegram          enabled (HQ bot configured)
+  project bots      3 project bot(s)
+  project groups    none
+
+Edit: /home/user/.config/hyper/hq.toml
+```
+
+## Notes
+
+- If no config file exists yet, the command tells you to run `hyper hq start` to create one via the setup wizard.
+- To edit settings directly, open the config file path shown in the output.

package/help/hq/list.md

@@ -0,0 +1,42 @@
+# hyper hq list
+
+List available projects and their worktrees.
+
+## Usage
+
+`hyper hq list [flags]`
+
+## Flags
+
+| Flag | Description |
+|------|-------------|
+| `--root <dir>` | Override the projects root directory |
+| `--json` | Output as JSON |
+
+## Examples
+
+```sh
+# List all projects
+hyper hq list
+
+# Output as JSON (useful for scripting or HQ's internal use)
+hyper hq list --json
+
+# List projects from a different root
+hyper hq list --root /path/to/projects
+```
+
+## Output
+
+The default view shows each project with git and worktree metadata:
+
+```
+Projects (/home/user/projects)
+──────────────────────────────────────────────────
+  my-app  (git, 2 worktrees)
+    ├─ main  *  /home/user/projects/my-app
+    └─ feat-auth  /home/user/.worktrees/my-app/feat-auth
+  another-project  (git)
+```
+
+A `*` marks the main worktree.