@ondrej-svec/hog 1.16.2 → 1.17.0

package/dist/cli.js

@@ -12,7 +12,7 @@ var __export = (target, all) => {
 // src/config.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
 import { homedir } from "os";
-import { join } from "path";
+import { isAbsolute, join, normalize } from "path";
 import { z } from "zod";
 function migrateConfig(raw) {
   const version = typeof raw["version"] === "number" ? raw["version"] : 1;
@@ -147,7 +147,7 @@ function requireAuth() {
   }
   return auth;
 }
-var CONFIG_DIR, AUTH_FILE, CONFIG_FILE, COMPLETION_ACTION_SCHEMA, REPO_NAME_PATTERN, REPO_CONFIG_SCHEMA, BOARD_CONFIG_SCHEMA, TICKTICK_CONFIG_SCHEMA, PROFILE_SCHEMA, HOG_CONFIG_SCHEMA;
+var CONFIG_DIR, AUTH_FILE, CONFIG_FILE, COMPLETION_ACTION_SCHEMA, REPO_NAME_PATTERN, CLAUDE_START_COMMAND_SCHEMA, REPO_CONFIG_SCHEMA, BOARD_CONFIG_SCHEMA, TICKTICK_CONFIG_SCHEMA, PROFILE_SCHEMA, HOG_CONFIG_SCHEMA;
 var init_config = __esm({
   "src/config.ts"() {
     "use strict";
@@ -160,6 +160,10 @@ var init_config = __esm({
       z.object({ type: z.literal("addLabel"), label: z.string() })
     ]);
     REPO_NAME_PATTERN = /^[\w.-]+\/[\w.-]+$/;
+    CLAUDE_START_COMMAND_SCHEMA = z.object({
+      command: z.string().min(1),
+      extraArgs: z.array(z.string())
+    });
     REPO_CONFIG_SCHEMA = z.object({
       name: z.string().regex(REPO_NAME_PATTERN, "Must be owner/repo format"),
       shortName: z.string().min(1),
@@ -167,13 +171,20 @@ var init_config = __esm({
       statusFieldId: z.string().min(1),
       dueDateFieldId: z.string().optional(),
       completionAction: COMPLETION_ACTION_SCHEMA,
-      statusGroups: z.array(z.string()).optional()
+      statusGroups: z.array(z.string()).optional(),
+      localPath: z.string().refine((p) => isAbsolute(p), { message: "localPath must be an absolute path" }).refine((p) => normalize(p) === p, {
+        message: "localPath must be normalized (no .. segments)"
+      }).refine((p) => !p.includes("\0"), { message: "localPath must not contain null bytes" }).optional(),
+      claudeStartCommand: CLAUDE_START_COMMAND_SCHEMA.optional()
     });
     BOARD_CONFIG_SCHEMA = z.object({
       refreshInterval: z.number().int().min(10).default(60),
       backlogLimit: z.number().int().min(1).default(20),
       assignee: z.string().min(1),
-      focusDuration: z.number().int().min(60).default(1500)
+      focusDuration: z.number().int().min(60).default(1500),
+      claudeStartCommand: CLAUDE_START_COMMAND_SCHEMA.optional(),
+      claudeLaunchMode: z.enum(["auto", "tmux", "terminal"]).optional(),
+      claudeTerminalApp: z.enum(["Terminal", "iTerm", "Ghostty", "WezTerm", "Kitty", "Alacritty"]).optional()
     });
     TICKTICK_CONFIG_SCHEMA = z.object({
       enabled: z.boolean().default(true)
@@ -2070,7 +2081,8 @@ function useKeyboard({
     handleEnterFuzzyPicker,
     handleEnterEditIssue,
     handleUndo,
-    handleToggleLog
+    handleToggleLog,
+    handleLaunchClaude
   } = actions;
   const handleInput = useCallback4(
     (input2, key) => {
@@ -2171,6 +2183,10 @@ function useKeyboard({
           }
           return;
         }
+        if (input2 === "C") {
+          handleLaunchClaude();
+          return;
+        }
       }
       if (ui.canAct) {
         const digit = parseInt(input2, 10);
@@ -2309,6 +2325,7 @@ function useKeyboard({
       handleEnterEditIssue,
       handleUndo,
       handleToggleLog,
+      handleLaunchClaude,
       showDetailPanel
     ]
   );
@@ -2834,6 +2851,225 @@ var init_use_ui_state = __esm({
   }
 });
 
+// src/board/launch-claude.ts
+var launch_claude_exports = {};
+__export(launch_claude_exports, {
+  buildPrompt: () => buildPrompt,
+  launchClaude: () => launchClaude
+});
+import { spawn, spawnSync } from "child_process";
+import { existsSync as existsSync5 } from "fs";
+function buildPrompt(issue) {
+  return `Issue #${issue.number}: ${issue.title}
+URL: ${issue.url}`;
+}
+function isClaudeInPath() {
+  const result = spawnSync("which", ["claude"], { stdio: "pipe" });
+  return result.status === 0;
+}
+function isInTmux() {
+  return !!process.env["TMUX"];
+}
+function isInSsh() {
+  return !!(process.env["SSH_CLIENT"] ?? process.env["SSH_TTY"]);
+}
+function detectTerminalApp() {
+  return process.env["TERM_PROGRAM"];
+}
+function resolveCommand(opts) {
+  if (opts.startCommand) return opts.startCommand;
+  return { command: "claude", extraArgs: [] };
+}
+function launchViaTmux(opts) {
+  const { localPath, issue, repoFullName } = opts;
+  const { command, extraArgs } = resolveCommand(opts);
+  const prompt = buildPrompt(issue);
+  const windowName = `claude-${issue.number}`;
+  const tmuxArgs = [
+    "new-window",
+    "-d",
+    // don't steal focus from hog board
+    "-c",
+    localPath,
+    "-n",
+    windowName
+  ];
+  if (repoFullName) {
+    tmuxArgs.push("-e", `HOG_REPO=${repoFullName}`);
+  }
+  tmuxArgs.push("-e", `HOG_ISSUE=${issue.number}`);
+  tmuxArgs.push(command, ...extraArgs, "--", prompt);
+  const child = spawn("tmux", tmuxArgs, { stdio: "ignore", detached: true });
+  child.unref();
+  return { ok: true, value: void 0 };
+}
+function launchViaTerminalApp(terminalApp, opts) {
+  const { localPath, issue } = opts;
+  const { command, extraArgs } = resolveCommand(opts);
+  const prompt = buildPrompt(issue);
+  const fullCmd = [command, ...extraArgs, "--", prompt].join(" ");
+  switch (terminalApp) {
+    case "iTerm": {
+      const script = `tell application "iTerm"
+  create window with default profile command "bash -c 'cd ${localPath} && ${fullCmd}'"
+end tell`;
+      const result = spawnSync("osascript", ["-e", script], { stdio: "ignore" });
+      if (result.status !== 0) {
+        return {
+          ok: false,
+          error: {
+            kind: "terminal-failed",
+            message: `iTerm2 launch failed. Is iTerm2 installed and running?`
+          }
+        };
+      }
+      return { ok: true, value: void 0 };
+    }
+    case "Terminal": {
+      const child = spawn("open", ["-a", "Terminal", localPath], {
+        stdio: "ignore",
+        detached: true
+      });
+      child.unref();
+      return { ok: true, value: void 0 };
+    }
+    case "Ghostty": {
+      const child = spawn(
+        "open",
+        ["-na", "Ghostty", "--args", `--working-directory=${localPath}`],
+        { stdio: "ignore", detached: true }
+      );
+      child.unref();
+      return { ok: true, value: void 0 };
+    }
+    case "WezTerm": {
+      const child = spawn("wezterm", ["start", "--cwd", localPath], {
+        stdio: "ignore",
+        detached: true
+      });
+      child.unref();
+      return { ok: true, value: void 0 };
+    }
+    case "Kitty": {
+      const child = spawn(
+        "kitty",
+        ["--directory", localPath, command, ...extraArgs, "--", prompt],
+        {
+          stdio: "ignore",
+          detached: true
+        }
+      );
+      child.unref();
+      return { ok: true, value: void 0 };
+    }
+    case "Alacritty": {
+      const child = spawn(
+        "alacritty",
+        ["--command", "bash", "-c", `cd ${localPath} && ${fullCmd}`],
+        { stdio: "ignore", detached: true }
+      );
+      child.unref();
+      return { ok: true, value: void 0 };
+    }
+    default:
+      return {
+        ok: false,
+        error: {
+          kind: "terminal-app-not-found",
+          message: `Unknown terminal app: ${terminalApp}`
+        }
+      };
+  }
+}
+function launchViaDetectedTerminal(opts) {
+  const { terminalApp } = opts;
+  if (terminalApp) {
+    return launchViaTerminalApp(terminalApp, opts);
+  }
+  const termProgram = detectTerminalApp();
+  if (termProgram === "iTerm.app") {
+    return launchViaTerminalApp("iTerm", opts);
+  }
+  if (termProgram === "Apple_Terminal") {
+    return launchViaTerminalApp("Terminal", opts);
+  }
+  if (termProgram === "WezTerm") {
+    return launchViaTerminalApp("WezTerm", opts);
+  }
+  if (termProgram === "ghostty") {
+    return launchViaTerminalApp("Ghostty", opts);
+  }
+  if (process.env["KITTY_WINDOW_ID"]) {
+    return launchViaTerminalApp("Kitty", opts);
+  }
+  if (process.platform === "darwin") {
+    return launchViaTerminalApp("Terminal", opts);
+  }
+  const { localPath, issue } = opts;
+  const { command, extraArgs } = resolveCommand(opts);
+  const prompt = buildPrompt(issue);
+  const child = spawn(
+    "xdg-terminal-exec",
+    ["bash", "-c", `cd ${localPath} && ${[command, ...extraArgs, "--", prompt].join(" ")}`],
+    { stdio: "ignore", detached: true }
+  );
+  child.unref();
+  return { ok: true, value: void 0 };
+}
+function launchClaude(opts) {
+  const { localPath, launchMode = "auto" } = opts;
+  if (!existsSync5(localPath)) {
+    return {
+      ok: false,
+      error: {
+        kind: "directory-not-found",
+        message: `Directory not found: ${localPath}. Check localPath config.`
+      }
+    };
+  }
+  if (!isClaudeInPath()) {
+    return {
+      ok: false,
+      error: {
+        kind: "claude-not-found",
+        message: "claude binary not found in PATH. Install Claude Code first."
+      }
+    };
+  }
+  if (isInSsh() && !isInTmux() && launchMode !== "tmux") {
+    return {
+      ok: false,
+      error: {
+        kind: "ssh-no-tmux",
+        message: "Running over SSH without tmux \u2014 start tmux to enable Claude Code launch."
+      }
+    };
+  }
+  const useTmux = launchMode === "tmux" || launchMode === "auto" && isInTmux();
+  if (useTmux) {
+    const result = launchViaTmux(opts);
+    if (!result.ok) {
+      if (launchMode === "tmux") {
+        return {
+          ok: false,
+          error: {
+            kind: "tmux-failed",
+            message: "tmux launch failed. Is tmux running?"
+          }
+        };
+      }
+      return launchViaDetectedTerminal(opts);
+    }
+    return result;
+  }
+  return launchViaDetectedTerminal(opts);
+}
+var init_launch_claude = __esm({
+  "src/board/launch-claude.ts"() {
+    "use strict";
+  }
+});
+
 // src/board/components/action-log.tsx
 import { Box, Text } from "ink";
 import { useEffect as useEffect2, useState as useState6 } from "react";
@@ -3147,7 +3383,7 @@ function HintBar({
   if (uiMode === "overlay:detail") {
     return /* @__PURE__ */ jsxs5(Box5, { children: [
       /* @__PURE__ */ jsx5(Text5, { color: "cyan", bold: true, children: "[DETAIL]" }),
-      /* @__PURE__ */ jsx5(Text5, { color: "gray", children: " Esc:close e:edit c:comment y:copy-link ? help" })
+      /* @__PURE__ */ jsx5(Text5, { color: "gray", children: " Esc:close e:edit c:comment y:copy-link C:claude ? help" })
     ] });
   }
   if (uiMode.startsWith("overlay:")) {
@@ -3157,7 +3393,7 @@ function HintBar({
     0: "j/k:scroll  Esc:close  ? help",
     1: "j/k:move  Enter:filter  0-4:panel  ? help",
     2: "j/k:move  Enter:filter  Esc:clear  0-4:panel  ? help",
-    3: `j/k:move  p:pick  m:status  c:comment  /:search  n:new  0-4:panel${hasUndoable ? "  u:undo" : ""}  ? help  q:quit`,
+    3: `j/k:move  p:pick  m:status  c:comment  C:claude  /:search  n:new  0-4:panel${hasUndoable ? "  u:undo" : ""}  ? help  q:quit`,
     4: "j/k:scroll  Enter:jump  r:refresh  0-4:panel  ? help"
   };
   return /* @__PURE__ */ jsxs5(Box5, { children: [
@@ -3258,7 +3494,7 @@ var init_ink_instance = __esm({
 });
 
 // src/board/components/comment-input.tsx
-import { spawnSync } from "child_process";
+import { spawnSync as spawnSync2 } from "child_process";
 import { mkdtempSync, readFileSync as readFileSync4, rmSync, writeFileSync as writeFileSync4 } from "fs";
 import { tmpdir } from "os";
 import { join as join4 } from "path";
@@ -3312,7 +3548,7 @@ function CommentInput({
       const inkInstance2 = getInkInstance();
       inkInstance2?.clear();
       setRawMode(false);
-      spawnSync(cmd, [...extraArgs, tmpFile], { stdio: "inherit" });
+      spawnSync2(cmd, [...extraArgs, tmpFile], { stdio: "inherit" });
       const content = readFileSync4(tmpFile, "utf-8").trim();
       setRawMode(true);
       if (content) {
@@ -3618,7 +3854,7 @@ var init_create_issue_form = __esm({
 });
 
 // src/board/components/edit-issue-overlay.tsx
-import { spawnSync as spawnSync2 } from "child_process";
+import { spawnSync as spawnSync3 } from "child_process";
 import { mkdtempSync as mkdtempSync2, readFileSync as readFileSync5, rmSync as rmSync2, writeFileSync as writeFileSync5 } from "fs";
 import { tmpdir as tmpdir2 } from "os";
 import { join as join5 } from "path";
@@ -3743,7 +3979,7 @@ function EditIssueOverlay({
       setRawMode(false);
       while (true) {
         writeFileSync5(tmpFile, currentContent);
-        const result = spawnSync2(cmd, [...extraArgs, tmpFile], { stdio: "inherit" });
+        const result = spawnSync3(cmd, [...extraArgs, tmpFile], { stdio: "inherit" });
         if (result.status !== 0 || result.signal !== null || result.error) {
           break;
         }
@@ -4241,7 +4477,8 @@ var init_help_overlay = __esm({
           { key: "y", desc: "Copy issue link to clipboard" },
           { key: "n", desc: "Create new issue" },
           { key: "I", desc: "Natural-language issue create" },
-          { key: "l", desc: "Manage labels" }
+          { key: "l", desc: "Manage labels" },
+          { key: "C", desc: "Launch Claude Code session for this issue" }
         ]
       },
       {
@@ -4257,7 +4494,7 @@ var init_help_overlay = __esm({
 });
 
 // src/board/components/nl-create-overlay.tsx
-import { spawnSync as spawnSync3 } from "child_process";
+import { spawnSync as spawnSync4 } from "child_process";
 import { mkdtempSync as mkdtempSync3, readFileSync as readFileSync6, rmSync as rmSync3, writeFileSync as writeFileSync6 } from "fs";
 import { tmpdir as tmpdir3 } from "os";
 import { join as join6 } from "path";
@@ -4342,7 +4579,7 @@ function NlCreateOverlay({
       const inkInstance2 = getInkInstance();
       inkInstance2?.clear();
       setRawMode(false);
-      spawnSync3(cmd, [...extraArgs, tmpFile], { stdio: "inherit" });
+      spawnSync4(cmd, [...extraArgs, tmpFile], { stdio: "inherit" });
       const content = readFileSync6(tmpFile, "utf-8");
       setRawMode(true);
       setBody(content.trimEnd());
@@ -5195,7 +5432,7 @@ var init_toast_container = __esm({
 });
 
 // src/board/components/dashboard.tsx
-import { execFileSync as execFileSync3, spawnSync as spawnSync4 } from "child_process";
+import { execFileSync as execFileSync3, spawnSync as spawnSync5 } from "child_process";
 import { Spinner as Spinner4 } from "@inkjs/ui";
 import { Box as Box24, Text as Text23, useApp, useStdout } from "ink";
 import { useCallback as useCallback12, useEffect as useEffect9, useMemo as useMemo3, useRef as useRef13, useState as useState16 } from "react";
@@ -5724,7 +5961,7 @@ function Dashboard({ config: config2, options, activeProfile }) {
         toast.info(`${label} \u2014 ${found.issue.url}`);
         return;
       }
-      const result = spawnSync4(cmd, args, {
+      const result = spawnSync5(cmd, args, {
         input: found.issue.url,
         stdio: ["pipe", "pipe", "pipe"]
       });
@@ -5737,6 +5974,31 @@ function Dashboard({ config: config2, options, activeProfile }) {
       toast.info(`${label} \u2014 ${found.issue.url}`);
     }
   }, [repos, nav.selectedId, config2.repos, toast]);
+  const handleLaunchClaude = useCallback12(() => {
+    const found = findSelectedIssueWithRepo(repos, nav.selectedId);
+    if (!found) return;
+    const rc = config2.repos.find((r) => r.name === found.repoName);
+    if (!rc?.localPath) {
+      toast.info(
+        `Set localPath for ${rc?.shortName ?? found.repoName} in ~/.config/hog/config.json to enable Claude Code launch`
+      );
+      return;
+    }
+    const resolvedStartCommand = rc.claudeStartCommand ?? config2.board.claudeStartCommand;
+    const result = launchClaude({
+      localPath: rc.localPath,
+      issue: { number: found.issue.number, title: found.issue.title, url: found.issue.url },
+      ...resolvedStartCommand ? { startCommand: resolvedStartCommand } : {},
+      launchMode: config2.board.claudeLaunchMode ?? "auto",
+      ...config2.board.claudeTerminalApp ? { terminalApp: config2.board.claudeTerminalApp } : {},
+      repoFullName: found.repoName
+    });
+    if (!result.ok) {
+      toast.error(result.error.message);
+      return;
+    }
+    toast.info(`Claude Code session opened in ${rc.shortName ?? found.repoName}`);
+  }, [repos, nav.selectedId, config2.repos, config2.board, toast]);
   const multiSelectType = useMemo3(() => {
     for (const id of multiSelect.selected) {
       if (id.startsWith("tt:")) return "ticktick";
@@ -5850,7 +6112,8 @@ function Dashboard({ config: config2, options, activeProfile }) {
       handleEnterFuzzyPicker: ui.enterFuzzyPicker,
       handleEnterEditIssue: ui.enterEditIssue,
       handleUndo: undoLast,
-      handleToggleLog: () => setLogVisible((v) => !v)
+      handleToggleLog: () => setLogVisible((v) => !v),
+      handleLaunchClaude
     },
     onSearchEscape,
     panelFocus,
@@ -6082,6 +6345,7 @@ var init_dashboard = __esm({
     init_use_panel_focus();
     init_use_toast();
     init_use_ui_state();
+    init_launch_claude();
     init_action_log();
     init_activity_panel();
     init_detail_panel();
@@ -7415,7 +7679,7 @@ function resolveProjectId(projectId) {
   process.exit(1);
 }
 var program = new Command();
-program.name("hog").description("Personal command deck \u2014 unified task dashboard for GitHub Projects + TickTick").version("1.16.2").option("--json", "Force JSON output").option("--human", "Force human-readable output").hook("preAction", (thisCommand) => {
+program.name("hog").description("Personal command deck \u2014 unified task dashboard for GitHub Projects + TickTick").version("1.17.0").option("--json", "Force JSON output").option("--human", "Force human-readable output").hook("preAction", (thisCommand) => {
   const opts = thisCommand.opts();
   if (opts.json) setFormat("json");
   if (opts.human) setFormat("human");
@@ -7564,6 +7828,63 @@ program.command("pick <issueRef>").description("Pick up an issue: assign to self
     }
   }
 });
+program.command("launch <issueRef>").description("Launch Claude Code for an issue in its local repo directory").option("--dry-run", "Print resolved config without spawning").action(async (issueRef, opts) => {
+  const cfg = loadFullConfig();
+  const ref = await resolveRef(issueRef, cfg);
+  const rc = ref.repo;
+  if (!rc.localPath) {
+    errorOut(
+      `Set localPath for ${rc.shortName} in ~/.config/hog/config.json to enable Claude Code launch`,
+      { repo: rc.shortName }
+    );
+  }
+  const startCommand = rc.claudeStartCommand ?? cfg.board.claudeStartCommand;
+  const launchMode = cfg.board.claudeLaunchMode ?? "auto";
+  const terminalApp = cfg.board.claudeTerminalApp;
+  if (opts.dryRun) {
+    if (useJson()) {
+      jsonOut({
+        ok: true,
+        dryRun: true,
+        would: {
+          localPath: rc.localPath,
+          command: startCommand?.command ?? "claude",
+          extraArgs: startCommand?.extraArgs ?? [],
+          launchMode,
+          terminalApp: terminalApp ?? null,
+          issueNumber: ref.issueNumber,
+          repo: rc.shortName
+        }
+      });
+    } else {
+      console.log(`[dry-run] Would launch Claude Code for ${rc.shortName}#${ref.issueNumber}`);
+      console.log(`  localPath:  ${rc.localPath}`);
+      console.log(`  command:    ${startCommand?.command ?? "claude"}`);
+      console.log(`  launchMode: ${launchMode}`);
+      if (terminalApp) console.log(`  terminalApp: ${terminalApp}`);
+    }
+    return;
+  }
+  const { launchClaude: launchClaude2 } = await Promise.resolve().then(() => (init_launch_claude(), launch_claude_exports));
+  const { fetchIssueAsync: fetchIssueAsync2 } = await Promise.resolve().then(() => (init_github(), github_exports));
+  const issue = await fetchIssueAsync2(rc.name, ref.issueNumber);
+  const result = launchClaude2({
+    localPath: rc.localPath,
+    issue: { number: issue.number, title: issue.title, url: issue.url },
+    ...startCommand ? { startCommand } : {},
+    launchMode,
+    ...terminalApp ? { terminalApp } : {},
+    repoFullName: rc.name
+  });
+  if (!result.ok) {
+    errorOut(result.error.message, { kind: result.error.kind });
+  }
+  if (useJson()) {
+    jsonOut({ ok: true, data: { repo: rc.shortName, issue: ref.issueNumber } });
+  } else {
+    console.log(`Claude Code session opened in ${rc.shortName}#${ref.issueNumber}`);
+  }
+});
 var config = program.command("config").description("Manage hog configuration");
 config.command("show").description("Show full configuration").action(() => {
   const cfg = loadFullConfig();