@ondrej-svec/hog 1.4.0 → 1.5.0

package/README.md

@@ -9,7 +9,7 @@ Your personal command deck — a unified task dashboard for GitHub Projects and
 
 ```sh
 npm install -g @ondrej-svec/hog
-hog init     # interactive setup wizard
+hog init        # interactive setup wizard
 hog board --live
 ```
 
@@ -17,18 +17,22 @@ Requires **Node.js 22+** and the [GitHub CLI](https://cli.github.com/) (`gh auth
 
 ## Features
 
-**Unified Dashboard** — See GitHub issues from multiple repos and TickTick tasks in one view. Filter by repo, assignee, or backlog status.
+**Unified Dashboard** — GitHub issues from multiple repos and TickTick tasks in one view. Filter by repo, assignee, or backlog status.
 
 **Interactive TUI** — Vim-style navigation (`j`/`k`), section collapsing, search (`/`), multi-select with bulk actions, and a detail panel on wide terminals.
 
-**Issue Actions** — Pick up issues (`p`), assign/unassign (`a`/`u`), change status (`m`), comment (`c`), create issues (`n`) — all without leaving the terminal.
+**Issue Actions** — Pick up issues (`p`), assign/unassign (`a`/`u`), change status (`m`), comment (`c`), create issues (`n`), add/remove labels (`l`) — all without leaving the terminal.
+
+**Natural Language Issue Creation** — Press `I` and type `fix login bug #backend @alice due friday`. hog extracts the title, labels, assignee, and due date automatically. Optional LLM enhancement via OpenRouter.
+
+**Multi-Line Comments** — Press `ctrl+e` in the comment overlay to open your `$EDITOR` (vim, nano, VS Code, etc.) for longer notes.
+
+**Copy Link** — Press `y` to copy the selected issue's URL to your clipboard.
 
 **Focus Mode** — Built-in Pomodoro timer (`f`). Lock onto an issue and focus for 25 minutes (configurable).
 
 **Auto-Refresh** — Background refresh with age indicators (green/yellow/red) and failure tracking. Manual refresh with `r`.
 
-**Toast Notifications** — Every async operation shows clear feedback. Errors persist with retry hints.
-
 **Board Profiles** — Multiple board configurations for different contexts (work, personal, etc.).
 
 **TickTick Optional** — Works with just GitHub. Enable TickTick integration when you want it.
@@ -40,20 +44,94 @@ Requires **Node.js 22+** and the [GitHub CLI](https://cli.github.com/) (`gh auth
 | Key | Action |
 |-----|--------|
 | `j` / `k` | Navigate down / up |
+| `↓` / `↑` | Navigate down / up |
 | `Tab` / `Shift+Tab` | Next / previous section |
-| `Enter` | Open in browser (item) or toggle (section) |
-| `Space` | Toggle section or multi-select |
+| `Space` | Toggle section (on header) or enter multi-select (on issue) |
+| `Enter` | Open issue in browser (item) or toggle collapse (section) |
 | `/` | Search |
+| `n` | Create issue (form wizard) |
+| `I` | Create issue from natural language |
 | `p` | Pick issue (assign + sync to TickTick) |
 | `a` / `u` | Assign / unassign |
-| `m` | Change status |
-| `c` | Comment |
-| `n` | Create issue |
-| `f` | Focus mode (Pomodoro) |
-| `r` | Refresh |
-| `?` | Help |
+| `m` | Change project status |
+| `l` | Add / remove labels |
+| `c` | Add comment |
+| `ctrl+e` | Open `$EDITOR` for multi-line comment |
+| `y` | Copy issue URL to clipboard |
+| `f` | Focus mode (Pomodoro timer) |
+| `C` | Collapse all sections |
+| `r` / `R` | Refresh |
+| `?` | Toggle help |
 | `q` | Quit |
 
+### Multi-Select
+
+Press `Space` on any issue to enter multi-select mode, then:
+
+| Key | Action |
+|-----|--------|
+| `Space` | Toggle item selection |
+| `Enter` / `m` | Open bulk action menu |
+| `Escape` | Clear selection and exit multi-select |
+
+## Natural Language Issue Creation
+
+Press `I` on the board to open the NL input. Type a description in plain English:
+
+```
+fix auth timeout on mobile #backend #bug @alice due friday
+```
+
+hog extracts:
+- **Title** — `fix auth timeout on mobile`
+- **Labels** — `backend`, `bug` (validated against repo labels)
+- **Assignee** — `alice`
+- **Due date** — parsed from `due friday`, `due end of month`, `due 2026-03-01`, etc.
+
+A live preview shows the parsed fields before you confirm with `Enter`.
+
+### Heuristic Tokens
+
+These are extracted without any API key:
+
+| Token | Example | Extracts |
+|-------|---------|---------|
+| `#word` | `#backend` | label |
+| `@user` | `@alice` | assignee (`@me` → your GitHub login) |
+| `due <expr>` | `due friday` | due date (chrono-node) |
+
+Everything else becomes the title.
+
+### LLM Enhancement (optional)
+
+With an [OpenRouter](https://openrouter.ai) API key, hog sends ambiguous input to an LLM for richer title cleanup and inference. The heuristic tokens still take priority — LLM only fills gaps.
+
+Set up during `hog init`, or any time with:
+
+```sh
+hog config ai:set-key sk-or-...   # store key
+hog config ai:clear-key            # remove key
+hog config ai:status               # show active source
+```
+
+Or set an environment variable (takes priority over the stored key):
+
+```sh
+export OPENROUTER_API_KEY=sk-or-...
+# or
+export ANTHROPIC_API_KEY=sk-ant-...
+```
+
+### Agent-Native: `hog issue create`
+
+Create issues non-interactively from scripts or AI agents:
+
+```sh
+hog issue create "fix login bug #backend @alice due friday" --repo owner/repo
+hog issue create "add dark mode" --repo owner/repo --dry-run   # preview only
+hog issue create "add dark mode" --repo owner/repo --json      # structured output
+```
+
 ## Commands
 
 ### `hog board`
@@ -69,6 +147,15 @@ hog board --repo myrepo --json      # filter by repo
 hog board --profile work --live     # use a named profile
 ```
 
+### `hog issue`
+
+Manage issues from the command line.
+
+```sh
+hog issue create "fix login bug #backend due friday" --repo owner/repo
+hog issue create "add dark mode" --repo owner/repo --dry-run
+```
+
 ### `hog pick`
 
 Assign a GitHub issue to yourself and create a linked TickTick task.
@@ -82,8 +169,8 @@ hog pick myrepo/145
 Manage TickTick tasks directly.
 
 ```sh
-hog task list                       # list tasks
-hog task add "Ship the feature"     # create task
+hog task list
+hog task add "Ship the feature"
 hog task add "Bug fix" -p high -t "urgent"
 hog task complete <taskId>
 hog task update <taskId> --title "New title" -p medium
@@ -97,22 +184,31 @@ hog task use-project <projectId>    # set default project
 View and manage configuration.
 
 ```sh
-hog config show                     # show full config
-hog config repos                    # list tracked repos
+hog config show
+
+# Repos
+hog config repos
 hog config repos:add owner/repo --project-number 1 --status-field-id PVTSSF_xxx --completion-type closeIssue
 hog config repos:rm reponame
 
-hog config ticktick:enable          # enable TickTick integration
-hog config ticktick:disable         # disable TickTick integration
+# TickTick
+hog config ticktick:enable
+hog config ticktick:disable
+
+# AI / natural language issue creation
+hog config ai:set-key sk-or-...     # store OpenRouter key
+hog config ai:clear-key             # remove stored key
+hog config ai:status                # show active source and provider
 
-hog config profile:create work      # create profile from current config
+# Profiles
+hog config profile:create work
 hog config profile:delete work
-hog config profile:default work     # set default profile
+hog config profile:default work
 ```
 
 ### `hog init`
 
-Interactive setup wizard. Detects your GitHub user, lets you pick repos, and configures everything.
+Interactive setup wizard. Detects your GitHub user, picks repos, configures projects, and optionally sets up an OpenRouter key for AI-enhanced issue creation.
 
 ```sh
 hog init            # interactive setup
@@ -131,7 +227,7 @@ hog sync status         # show sync mappings
 
 ## Configuration
 
-Config lives at `~/.config/hog/config.json`. Created by `hog init` or manually.
+Config lives at `~/.config/hog/config.json`. Created by `hog init` or edited manually.
 
 ```jsonc
 {
@@ -150,25 +246,27 @@ Config lives at `~/.config/hog/config.json`. Created by `hog init` or manually.
     "refreshInterval": 60,   // seconds (min: 10)
     "backlogLimit": 20,
     "assignee": "your-github-username",
-    "focusDuration": 1500    // seconds (25 min)
+    "focusDuration": 1500    // seconds (25 min default)
   },
   "ticktick": {
     "enabled": true          // set false to use without TickTick
   },
-  "profiles": {},            // named board profiles
-  "defaultProfile": ""       // profile to use by default
+  "profiles": {},
+  "defaultProfile": ""
 }
 ```
 
+Credentials (TickTick OAuth token, OpenRouter API key) are stored separately in `~/.config/hog/auth.json` with `0600` permissions.
+
 ### Status Groups
 
-By default, hog auto-detects status columns from your GitHub Project. Override per-repo with `statusGroups`:
+By default, hog auto-detects status columns from your GitHub Project. Override per-repo:
 
 ```json
 "statusGroups": ["In Progress", "In Review", "Todo,Backlog"]
 ```
 
-Each entry is a section. Comma-separated values merge into one section (header = first value). Terminal statuses (Done, Shipped, Closed, etc.) are always hidden.
+Each entry is a board section. Comma-separated values merge into one section (header = first value). Terminal statuses (Done, Shipped, Closed, etc.) are always hidden.
 
 ### Profiles
 
@@ -185,6 +283,7 @@ hog board --profile personal --live
 - **Node.js 22+**
 - **GitHub CLI** (`gh`) — authenticated via `gh auth login`
 - **TickTick account** — optional, for task sync
+- **OpenRouter API key** — optional, for AI-enhanced issue creation (`hog config ai:set-key`)
 
 ## License
 

package/dist/cli.js

@@ -1222,8 +1222,8 @@ function useActions({
     });
   }, [toast, refresh]);
   const handleCreateIssue = useCallback(
-    async (repo, title, labels) => {
-      const args = ["issue", "create", "--repo", repo, "--title", title];
+    async (repo, title, body, labels) => {
+      const args = ["issue", "create", "--repo", repo, "--title", title, "--body", body];
       if (labels && labels.length > 0) {
         for (const label of labels) {
           args.push("--label", label);
@@ -2778,13 +2778,13 @@ function CreateIssueForm({
           currentLabels: [],
           labelCache: labelCache ?? {},
           onConfirm: (addLabels) => {
-            onSubmit(selectedRepo.name, title, addLabels.length > 0 ? addLabels : void 0);
+            onSubmit(selectedRepo.name, title, "", addLabels.length > 0 ? addLabels : void 0);
           },
           onCancel: () => {
-            onSubmit(selectedRepo.name, title);
+            onSubmit(selectedRepo.name, title, "");
           },
           onError: () => {
-            onSubmit(selectedRepo.name, title);
+            onSubmit(selectedRepo.name, title, "");
           }
         }
       )
@@ -2820,7 +2820,7 @@ function CreateIssueForm({
               setTitle(trimmed);
               setField("labels");
             } else {
-              onSubmit(selectedRepo.name, trimmed);
+              onSubmit(selectedRepo.name, trimmed, "");
             }
           }
         }
@@ -3018,8 +3018,12 @@ var init_help_overlay = __esm({
 });
 
 // src/board/components/nl-create-overlay.tsx
+import { spawnSync as spawnSync2 } from "child_process";
+import { mkdtempSync as mkdtempSync2, readFileSync as readFileSync4, rmSync as rmSync2, writeFileSync as writeFileSync4 } from "fs";
+import { tmpdir as tmpdir2 } from "os";
+import { join as join4 } from "path";
 import { Spinner as Spinner2, TextInput as TextInput3 } from "@inkjs/ui";
-import { Box as Box9, Text as Text9, useInput as useInput9 } from "ink";
+import { Box as Box9, Text as Text9, useInput as useInput9, useStdin as useStdin2 } from "ink";
 import { useCallback as useCallback9, useEffect as useEffect5, useRef as useRef9, useState as useState9 } from "react";
 import { jsx as jsx9, jsxs as jsxs9 } from "react/jsx-runtime";
 function NlCreateOverlay({
@@ -3028,15 +3032,28 @@ function NlCreateOverlay({
   labelCache,
   onSubmit,
   onCancel,
+  onPauseRefresh,
+  onResumeRefresh,
   onLlmFallback
 }) {
   const [, setInput] = useState9("");
   const [isParsing, setIsParsing] = useState9(false);
   const [parsed, setParsed] = useState9(null);
   const [parseError, setParseError] = useState9(null);
-  const [createError, setCreateError] = useState9(null);
+  const [step, setStep] = useState9("input");
+  const [body, setBody] = useState9("");
+  const [editingBody, setEditingBody] = useState9(false);
   const submittedRef = useRef9(false);
   const parseParamsRef = useRef9(null);
+  const onSubmitRef = useRef9(onSubmit);
+  const onCancelRef = useRef9(onCancel);
+  const onPauseRef = useRef9(onPauseRefresh);
+  const onResumeRef = useRef9(onResumeRefresh);
+  onSubmitRef.current = onSubmit;
+  onCancelRef.current = onCancel;
+  onPauseRef.current = onPauseRefresh;
+  onResumeRef.current = onResumeRefresh;
+  const { setRawMode } = useStdin2();
   const defaultRepoIdx = defaultRepoName ? Math.max(
     0,
     repos.findIndex((r) => r.name === defaultRepoName)
@@ -3044,19 +3061,19 @@ function NlCreateOverlay({
   const [repoIdx, setRepoIdx] = useState9(defaultRepoIdx);
   const selectedRepo = repos[repoIdx];
   useInput9((inputChar, key) => {
-    if (isParsing) return;
+    if (isParsing || editingBody) return;
     if (key.escape) {
+      if (step === "body") {
+        setStep("input");
+        setParsed((p) => p);
+        return;
+      }
       onCancel();
       return;
     }
-    if (parsed) {
+    if (parsed && step === "input") {
       if (key.return) {
-        if (submittedRef.current) return;
-        submittedRef.current = true;
-        if (!selectedRepo) return;
-        setCreateError(null);
-        const labels = buildLabelList(parsed);
-        onSubmit(selectedRepo.name, parsed.title, labels.length > 0 ? labels : void 0);
+        setStep("body");
         return;
       }
       if (inputChar === "r") {
@@ -3064,7 +3081,43 @@ function NlCreateOverlay({
         return;
       }
     }
+    if (step === "body" && inputChar === "") {
+      setEditingBody(true);
+    }
   });
+  useEffect5(() => {
+    if (!editingBody) return;
+    const editorEnv = process.env["VISUAL"] ?? process.env["EDITOR"] ?? "vi";
+    const [cmd, ...extraArgs] = editorEnv.split(" ").filter(Boolean);
+    if (!cmd) {
+      setEditingBody(false);
+      return;
+    }
+    let tmpDir = null;
+    let tmpFile = null;
+    try {
+      onPauseRef.current?.();
+      tmpDir = mkdtempSync2(join4(tmpdir2(), "hog-body-"));
+      tmpFile = join4(tmpDir, "body.md");
+      writeFileSync4(tmpFile, body);
+      const inkInstance = getInkInstance();
+      inkInstance?.clear();
+      setRawMode(false);
+      spawnSync2(cmd, [...extraArgs, tmpFile], { stdio: "inherit" });
+      const content = readFileSync4(tmpFile, "utf-8");
+      setRawMode(true);
+      setBody(content.trimEnd());
+    } finally {
+      onResumeRef.current?.();
+      if (tmpFile) {
+        try {
+          rmSync2(tmpDir, { recursive: true, force: true });
+        } catch {
+        }
+      }
+      setEditingBody(false);
+    }
+  }, [editingBody, body, setRawMode]);
   const handleInputSubmit = useCallback9(
     (text) => {
       const trimmed = text.trim();
@@ -3103,6 +3156,45 @@ function NlCreateOverlay({
       /* @__PURE__ */ jsx9(Spinner2, { label: "Parsing..." })
     ] });
   }
+  if (parsed && step === "body") {
+    if (editingBody) {
+      return /* @__PURE__ */ jsxs9(Box9, { flexDirection: "column", children: [
+        /* @__PURE__ */ jsx9(Text9, { color: "cyan", bold: true, children: "\u2728 Creating Issue" }),
+        /* @__PURE__ */ jsx9(Text9, { color: "cyan", children: "Opening editor for body\u2026" })
+      ] });
+    }
+    return /* @__PURE__ */ jsxs9(Box9, { flexDirection: "column", children: [
+      /* @__PURE__ */ jsx9(Text9, { color: "cyan", bold: true, children: "\u2728 Creating Issue" }),
+      /* @__PURE__ */ jsxs9(Box9, { children: [
+        /* @__PURE__ */ jsx9(Text9, { dimColor: true, children: "Title: " }),
+        /* @__PURE__ */ jsx9(Text9, { children: parsed.title })
+      ] }),
+      /* @__PURE__ */ jsxs9(Box9, { children: [
+        /* @__PURE__ */ jsx9(Text9, { color: "cyan", children: "body: " }),
+        /* @__PURE__ */ jsx9(
+          TextInput3,
+          {
+            defaultValue: body,
+            placeholder: "optional description (ctrl+e for editor)",
+            onChange: setBody,
+            onSubmit: (text) => {
+              if (submittedRef.current) return;
+              submittedRef.current = true;
+              if (!selectedRepo) return;
+              const labels = buildLabelList(parsed);
+              onSubmitRef.current(
+                selectedRepo.name,
+                parsed.title,
+                text.trim(),
+                labels.length > 0 ? labels : void 0
+              );
+            }
+          }
+        )
+      ] }),
+      /* @__PURE__ */ jsx9(Text9, { dimColor: true, children: "Enter:create ctrl+e:editor Esc:back" })
+    ] });
+  }
   if (parsed) {
     const labels = buildLabelList(parsed);
     return /* @__PURE__ */ jsxs9(Box9, { flexDirection: "column", children: [
@@ -3132,8 +3224,7 @@ function NlCreateOverlay({
         /* @__PURE__ */ jsx9(Text9, { children: formatDue(parsed.dueDate) })
       ] }) : null,
       parsed.dueDate && selectedRepo && !hasDueLabelInCache(labelCache, selectedRepo.name) ? /* @__PURE__ */ jsx9(Text9, { color: "yellow", children: "\u26A0 No due:* label in this repo \u2014 will try to create label on submit" }) : null,
-      createError ? /* @__PURE__ */ jsx9(Text9, { color: "red", children: createError }) : null,
-      /* @__PURE__ */ jsx9(Text9, { dimColor: true, children: "Enter:create Esc:cancel" })
+      /* @__PURE__ */ jsx9(Text9, { dimColor: true, children: "Enter:add body Esc:cancel" })
     ] });
   }
   return /* @__PURE__ */ jsxs9(Box9, { flexDirection: "column", children: [
@@ -3172,6 +3263,7 @@ var init_nl_create_overlay = __esm({
   "src/board/components/nl-create-overlay.tsx"() {
     "use strict";
     init_ai();
+    init_ink_instance();
   }
 });
 
@@ -3411,6 +3503,8 @@ function OverlayRenderer({
         labelCache,
         onSubmit: onCreateIssue,
         onCancel: onExitOverlay,
+        onPauseRefresh,
+        onResumeRefresh,
         onLlmFallback
       }
     ) : null
@@ -3711,7 +3805,7 @@ var init_toast_container = __esm({
 });
 
 // src/board/components/dashboard.tsx
-import { execFileSync as execFileSync3, spawnSync as spawnSync2 } from "child_process";
+import { execFileSync as execFileSync3, spawnSync as spawnSync3 } from "child_process";
 import { Spinner as Spinner4 } from "@inkjs/ui";
 import { Box as Box16, Text as Text16, useApp, useStdout } from "ink";
 import { useCallback as useCallback10, useEffect as useEffect6, useMemo as useMemo2, useRef as useRef11, useState as useState11 } from "react";
@@ -4046,8 +4140,8 @@ function Dashboard({ config: config2, options, activeProfile }) {
   const pendingPickRef = useRef11(null);
   const labelCacheRef = useRef11({});
   const handleCreateIssueWithPrompt = useCallback10(
-    (repo, title, labels) => {
-      actions.handleCreateIssue(repo, title, labels).then((result) => {
+    (repo, title, body, labels) => {
+      actions.handleCreateIssue(repo, title, body, labels).then((result) => {
         if (result) {
           pendingPickRef.current = result;
           ui.enterConfirmPick();
@@ -4212,7 +4306,7 @@ function Dashboard({ config: config2, options, activeProfile }) {
         toast.info(`${label} \u2014 ${found.issue.url}`);
         return;
       }
-      const result = spawnSync2(cmd, args, {
+      const result = spawnSync3(cmd, args, {
         input: found.issue.url,
         stdio: ["pipe", "pipe", "pipe"]
       });
@@ -5556,7 +5650,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.4.0").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.5.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");
@@ -5993,7 +6087,7 @@ issueCommand.command("create <text>").description("Create a GitHub issue from na
     console.error("[dry-run] Skipping issue creation.");
     return;
   }
-  const args = ["issue", "create", "--repo", repo, "--title", parsed.title];
+  const args = ["issue", "create", "--repo", repo, "--title", parsed.title, "--body", ""];
   for (const label of labels) {
     args.push("--label", label);
   }