hunkdiff 0.8.1 → 0.9.0-beta.1

package/README.md

@@ -52,8 +52,6 @@ Hunk mirrors Git's diff-style commands, but opens the changeset in a review UI i
 
 ```bash
 hunk diff                      # review current repo changes, including untracked files
-hunk diff --exclude-untracked  # limit working tree review to tracked files only
-hunk diff --staged
 hunk diff --watch              # auto-reload as the working tree changes
 hunk show                      # review the latest commit
 hunk show HEAD~1               # review an earlier commit
@@ -162,25 +160,45 @@ When a Hunk TUI starts, it registers with a local loopback daemon. `hunk session
 Use it to:
 
 - inspect the current review context
+- export the loaded review structure for agent workflows
+- optionally include raw patch text when an agent truly needs it
 - jump to a file, hunk, or line
 - reload the current window with a different `diff` or `show` command
-- add, list, and remove inline comments
+- add, batch-apply, list, and remove inline comments
 
 Most users only need `hunk session ...`. Use `hunk mcp serve` only for manual startup or debugging of the local daemon.
 
 ```bash
 hunk session list
+hunk session get --repo .
 hunk session context --repo .
+hunk session review --repo . --json
+hunk session review --repo . --include-patch --json
 hunk session navigate --repo . --file README.md --hunk 2
 hunk session reload --repo . -- diff
+hunk session reload --repo /path/to/worktree -- diff
+hunk session reload --session-path /path/to/live-window --source /path/to/other-checkout -- diff
 hunk session reload --repo . -- show HEAD~1 -- README.md
 hunk session comment add --repo . --file README.md --new-line 103 --summary "Tighten this wording"
+hunk session comment add --repo . --file README.md --new-line 103 --summary "Tighten this wording" --focus
+printf '%s\n' '{"comments":[{"filePath":"README.md","newLine":103,"summary":"Tighten this wording"}]}' | hunk session comment apply --repo . --stdin
+printf '%s\n' '{"comments":[{"filePath":"README.md","hunk":2,"summary":"Explain this hunk"}]}' | hunk session comment apply --repo . --stdin --focus
 hunk session comment list --repo .
 hunk session comment rm --repo . <comment-id>
 hunk session comment clear --repo . --file README.md --yes
 ```
 
+`hunk session review --json` returns file and hunk structure by default. Add `--include-patch` only when a caller truly needs raw unified diff text in the response.
+
 `hunk session reload ... -- <hunk command>` swaps what a live session is showing without opening a new TUI window.
+Pass `--focus` to jump the live session to the new note, or to the first note in a batch apply.
+
+`hunk session comment apply` reads one stdin JSON object with a top-level `comments` array. Each item needs `filePath`, `summary`, and exactly one target such as `hunk`, `hunkNumber`, `oldLine`, or `newLine`.
+
+- `--repo <path>` selects the live session by its current loaded repo root.
+- `--source <path>` is reload-only: it changes where the nested `diff` / `show` command runs, but does not select the session.
+- For normal worktree use, prefer targeting the worktree session directly with `hunk session reload --repo /path/to/worktree -- diff`.
+- Use `--session-path` + `--source` only for advanced cases where you want to repoint an already-open live window to another checkout or path.
 
 #### Load agent comments from a file
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hunkdiff",
-  "version": "0.8.1",
+  "version": "0.9.0-beta.1",
   "description": "Desktop-inspired terminal diff viewer for understanding agent-authored changesets.",
   "bin": {
     "hunk": "./bin/hunk.cjs"
@@ -30,10 +30,10 @@
     "node": ">=18"
   },
   "optionalDependencies": {
-    "hunkdiff-darwin-arm64": "0.8.1",
-    "hunkdiff-darwin-x64": "0.8.1",
-    "hunkdiff-linux-arm64": "0.8.1",
-    "hunkdiff-linux-x64": "0.8.1"
+    "hunkdiff-darwin-arm64": "0.9.0-beta.1",
+    "hunkdiff-darwin-x64": "0.9.0-beta.1",
+    "hunkdiff-linux-arm64": "0.9.0-beta.1",
+    "hunkdiff-linux-x64": "0.9.0-beta.1"
   },
   "license": "MIT",
   "publishConfig": {