jackherd 1.18.1 → 1.18.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +4 -0
- package/README.md +18 -18
- package/herdr-plugin/herdr-plugin.toml +1 -1
- package/install.sh +1 -1
- package/kit/hooks/ask-rules.json +1 -7
- package/kit/workflow/skills/orchestrate/references/close-lane.md +1 -1
- package/package.json +1 -1
- package/src/check/skill-budget-defaults.ts +2 -2
- package/src/lane/command.ts +1 -2
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,10 @@
|
|
|
2
2
|
|
|
3
3
|
What changed for people who use jackherd, newest first.
|
|
4
4
|
|
|
5
|
+
## 1.18.2
|
|
6
|
+
|
|
7
|
+
- **`jh lane close` runs without a permission prompt.** The command already refuses, changing nothing, when anything could be lost (PR not merged or tree differs from the merge commit, a file the worktree removal would delete, an agent at work, a lock), in a real run as in a dry run, so the six ask rules before it added only friction. `jh sync` removes them from your `.claude/settings.json`; the coordinator still closes only lanes it started or you named.
|
|
8
|
+
|
|
5
9
|
## 1.18.1
|
|
6
10
|
|
|
7
11
|
- **Starting the watcher under Monitor works again.** The watch guard refused `jh watch --stream` under the Monitor tool, the very place its message points to, so the coordinator fell back to single background runs. The stream refusal now applies only to a Bash call with `run_in_background`, where a never-ending stream would stay silent; Monitor and a foreground call pass.
|
package/README.md
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
<p>
|
|
2
|
-
<img alt="jackherd: a black and white Shih Tzu in a turquoise bandana, three lanes running from him to three agent nodes" src="https://unpkg.com/jackherd@1.18.
|
|
2
|
+
<img alt="jackherd: a black and white Shih Tzu in a turquoise bandana, three lanes running from him to three agent nodes" src="https://unpkg.com/jackherd@1.18.2/assets/branding/jackherd-logo-outline.svg" width="340">
|
|
3
3
|
<br>
|
|
4
4
|
</p>
|
|
5
5
|
|
|
6
|
-
[](https://www.npmjs.com/package/jackherd) [](https://www.npmjs.com/package/jackherd) [](https://www.npmjs.com/package/jackherd?activeTab=dependencies) [](https://unpkg.com/jackherd/INSTALL.md) [](https://unpkg.com/jackherd/INSTALL.md)<br><img width="1" height="8" alt="" src="https://unpkg.com/jackherd@1.18.
|
|
6
|
+
[](https://www.npmjs.com/package/jackherd) [](https://www.npmjs.com/package/jackherd) [](https://www.npmjs.com/package/jackherd?activeTab=dependencies) [](https://unpkg.com/jackherd/INSTALL.md) [](https://unpkg.com/jackherd/INSTALL.md)<br><img width="1" height="8" alt="" src="https://unpkg.com/jackherd@1.18.2/assets/icons/space.svg">
|
|
7
7
|
|
|
8
8
|
# Jack herds your coding agents.
|
|
9
9
|
|
|
@@ -15,27 +15,27 @@ For developers who'd rather decide than supervise.
|
|
|
15
15
|
curl -fsSL https://unpkg.com/jackherd/install.sh | sh
|
|
16
16
|
```
|
|
17
17
|
|
|
18
|
-
Then `/jh-start` in a repository, and Jack offers your first plan. → [Quickstart](#quickstart)<br><img width="1" height="8" alt="" src="https://unpkg.com/jackherd@1.18.
|
|
18
|
+
Then `/jh-start` in a repository, and Jack offers your first plan. → [Quickstart](#quickstart)<br><img width="1" height="8" alt="" src="https://unpkg.com/jackherd@1.18.2/assets/icons/space.svg">
|
|
19
19
|
|
|
20
20
|
<p>
|
|
21
|
-
<img src="https://unpkg.com/jackherd@1.18.
|
|
21
|
+
<img src="https://unpkg.com/jackherd@1.18.2/docs/workflow-dark.svg" width="720" alt="jackherd in herdr: a lane hits a question, Jack asks you as a choice, you pick, and the lane works on while the herd view counts its progress.">
|
|
22
22
|
<br>
|
|
23
|
-
<sub>Jack and his lanes in <a href="https://herdr.dev/">herdr</a>, a terminal for coding agents (recommended). Without it, one Claude Code session builds with subagents.</sub><br><img width="1" height="8" alt="" src="https://unpkg.com/jackherd@1.18.
|
|
23
|
+
<sub>Jack and his lanes in <a href="https://herdr.dev/">herdr</a>, a terminal for coding agents (recommended). Without it, one Claude Code session builds with subagents.</sub><br><img width="1" height="8" alt="" src="https://unpkg.com/jackherd@1.18.2/assets/icons/space.svg">
|
|
24
24
|
</p>
|
|
25
25
|
|
|
26
|
-
<p><img src="https://unpkg.com/jackherd@1.18.
|
|
26
|
+
<p><img src="https://unpkg.com/jackherd@1.18.2/assets/icons/lanes.svg" width="24" height="34" align="middle" alt=""> <b>Parallel where it pays.</b><br>Phases that don't collide run side by side, each lane on its own branch and worktree. Jack keeps the merge order and has the others rebase.</p>
|
|
27
27
|
|
|
28
|
-
<p><img src="https://unpkg.com/jackherd@1.18.
|
|
28
|
+
<p><img src="https://unpkg.com/jackherd@1.18.2/assets/icons/decide.svg" width="24" height="34" align="middle" alt=""> <b>You make the calls.</b><br>Commits, pushes and merges wait for your approval. Jack merges on green checks only where you said so: one pull request, or a plan's for up to 24 hours. The guards catch mistakes, not intent; a hard boundary takes branch protection.</p>
|
|
29
29
|
|
|
30
|
-
<p><img src="https://unpkg.com/jackherd@1.18.
|
|
30
|
+
<p><img src="https://unpkg.com/jackherd@1.18.2/assets/icons/bark.svg" width="24" height="34" align="middle" alt=""> <b>Jack barks.</b><br>A lane gets stuck, a check goes red, a decision needs you: Jack steps in and brings you only what's yours to decide. The herd view shows where every lane stands.</p>
|
|
31
31
|
|
|
32
|
-
<p><img src="https://unpkg.com/jackherd@1.18.
|
|
32
|
+
<p><img src="https://unpkg.com/jackherd@1.18.2/assets/icons/skills.svg" width="24" height="34" align="middle" alt=""> <b>Works with your skills.</b><br>Keep your own skills: a lane builds with whichever one you pick. Plans written elsewhere run too, once Jack fills in what they're missing.</p>
|
|
33
33
|
|
|
34
|
-
<p><img src="https://unpkg.com/jackherd@1.18.
|
|
34
|
+
<p><img src="https://unpkg.com/jackherd@1.18.2/assets/icons/ear.svg" width="24" height="34" align="middle" alt=""> <b>Jack listens.</b><br>Review comments on a lane's pull request go back to that lane, which fixes them with a test. <code>/jh-follow</code> brings in anything a CLI or an API can read as JSON: tickets, error logs, status pages.</p>
|
|
35
35
|
|
|
36
|
-
<p><img src="https://unpkg.com/jackherd@1.18.
|
|
36
|
+
<p><img src="https://unpkg.com/jackherd@1.18.2/assets/icons/bowl.svg" width="24" height="34" align="middle" alt=""> <b>Picks up where you left off.</b><br>Plan and board hold the state, not the chat.</p>
|
|
37
37
|
|
|
38
|
-
<p><img src="https://unpkg.com/jackherd@1.18.
|
|
38
|
+
<p><img src="https://unpkg.com/jackherd@1.18.2/assets/icons/plan.svg" width="24" height="34" align="middle" alt=""> <b>Lives in your repository.</b><br>Plans, board and every decision are Markdown, reviewed like code. <code>jh init</code> gives your team the same setup.<br><img width="1" height="8" alt="" src="https://unpkg.com/jackherd@1.18.2/assets/icons/space.svg"></p>
|
|
39
39
|
|
|
40
40
|
## Quickstart
|
|
41
41
|
|
|
@@ -66,22 +66,22 @@ Then `/jh-start` in a repository, and Jack offers your first plan. → [Quicksta
|
|
|
66
66
|
/jh-orchestrate docs/plans/board-<name>/board.md
|
|
67
67
|
```
|
|
68
68
|
|
|
69
|
-
Linux and macOS are supported (Windows through WSL); the requirements are in [INSTALL.md](https://unpkg.com/jackherd/INSTALL.md). By hand (Bun 1.3+): `bun add -g jackherd` or `npm install -g jackherd`, then `jh init --global` for yourself, or `jh init` in a repository to give your team the same skills and guard hooks.<br><img width="1" height="8" alt="" src="https://unpkg.com/jackherd@1.18.
|
|
69
|
+
Linux and macOS are supported (Windows through WSL); the requirements are in [INSTALL.md](https://unpkg.com/jackherd/INSTALL.md). By hand (Bun 1.3+): `bun add -g jackherd` or `npm install -g jackherd`, then `jh init --global` for yourself, or `jh init` in a repository to give your team the same skills and guard hooks.<br><img width="1" height="8" alt="" src="https://unpkg.com/jackherd@1.18.2/assets/icons/space.svg">
|
|
70
70
|
|
|
71
71
|
## Follow anything you can query
|
|
72
72
|
|
|
73
73
|
Tickets, error logs, status pages: if a command or an API call can read it as JSON with your login, Jack can watch it. Recipes cover Jira, Linear, GitHub issues and Projects, Sentry, Google Calendar and status pages; for anything else, `/jh-follow` writes the command with you. One yes, and every change shows up like this:
|
|
74
74
|
|
|
75
|
-
<img src="https://unpkg.com/jackherd@1.18.
|
|
75
|
+
<img src="https://unpkg.com/jackherd@1.18.2/docs/follow-dark.svg" width="720" alt="A source (ticket, error log or status page) has a new or changed entry; jh watch reports it to Jack; Jack puts a row into Your turn, prefixed with the source's label; its [ask] button makes Jack ask you, and then a lane works it.">
|
|
76
76
|
|
|
77
|
-
The herd sums up your sources in one `Sources` line: new entries per source, or its last run, red while it fails; opened, a click opens an entry. One that needs you lands in Your turn under the source's label, [ask] has Jack look at it, and a ticket shows on the lane that works it.<br><img width="1" height="8" alt="" src="https://unpkg.com/jackherd@1.18.
|
|
77
|
+
The herd sums up your sources in one `Sources` line: new entries per source, or its last run, red while it fails; opened, a click opens an entry. One that needs you lands in Your turn under the source's label, [ask] has Jack look at it, and a ticket shows on the lane that works it.<br><img width="1" height="8" alt="" src="https://unpkg.com/jackherd@1.18.2/assets/icons/space.svg">
|
|
78
78
|
|
|
79
79
|
## In detail
|
|
80
80
|
|
|
81
81
|
<details>
|
|
82
82
|
<summary><b>What Jack does on his own, and what waits for you</b></summary>
|
|
83
83
|
|
|
84
|
-
<img src="https://unpkg.com/jackherd@1.18.
|
|
84
|
+
<img src="https://unpkg.com/jackherd@1.18.2/docs/lanes-dark.svg" alt="Jack prompts two lanes and asks you for decisions and approvals; the lanes send questions back as text; jh watch reads lane state, pull requests and checks and wakes Jack.">
|
|
85
85
|
|
|
86
86
|
| On his own | After your approval | Never |
|
|
87
87
|
| --- | --- | --- |
|
|
@@ -116,7 +116,7 @@ The guards catch mistakes, not intent; for that, use branch protection. The hook
|
|
|
116
116
|
|
|
117
117
|
A **plan** is Markdown with phases, checkbox tasks, a model and a review gate per phase. A **board** lists the lanes of one or more plans: which phases each lane builds, on which model, after what. A **lane** is one agent session in its own git worktree (a second checkout of your repository), and **Jack** is the session in the main checkout that runs `/jh-orchestrate` on a board.
|
|
118
118
|
|
|
119
|
-
<img src="https://unpkg.com/jackherd@1.18.
|
|
119
|
+
<img src="https://unpkg.com/jackherd@1.18.2/docs/skills-dark.svg" alt="Your own plan or an issue is adopted (Jack adds what is missing, you see the diff) and goes to /jh-orchestrate; /jh-grill hands decisions to /jh-plan; /jh-plan feeds /jh-orchestrate or a single /jh-implement, which your own skill can replace; /jh-implement ends in /jh-pre-commit, which runs the reviewers; /jh-diagnose hands a red command to /jh-implement.">
|
|
120
120
|
|
|
121
121
|
| Skill | Does |
|
|
122
122
|
| --- | --- |
|
|
@@ -225,7 +225,7 @@ Each phase in the plan names its model: the planning model (Opus by default) whe
|
|
|
225
225
|
| `jh resume` | after herdr restarts, wakes the coordinator and the lanes that worked when the machine crashed; runs once per crash and only when the watcher's record shows no `stoppedAt`. Stopping the watcher before quitting herdr prevents it. |
|
|
226
226
|
| `jh secret` | keeps a personal source's secrets in the system keychain (`set <NAME>`, `list`, `delete <NAME>`); `list` shows which are set, never a value |
|
|
227
227
|
| `jh lane prompt <lane>` | writes a lane's first prompt from its board row and its plan (`--out`, `--handover`); your additions below the marker line at its end stay |
|
|
228
|
-
| `jh lane close <lane>` | removes a finished lane: agent, worktree, herdr workspace and branch, and marks the board; first checks that nothing is lost, and refuses with every reason; `--dry-run` only checks.
|
|
228
|
+
| `jh lane close <lane>` | removes a finished lane: agent, worktree, herdr workspace and branch, and marks the board; first checks that nothing is lost, and refuses with every reason; `--dry-run` only checks. Runs without a prompt. |
|
|
229
229
|
| `jh preview <file>` | renders a Markdown file through the GitHub API into a preview in GitHub and npm style |
|
|
230
230
|
| `jh waiting` | the files and Artifacts sent to you that you have not answered yet (`close <id>…` or `close --all` once you have) |
|
|
231
231
|
| `jh context` | how full an agent's context is, as JSON; `--usage [--since 24h\|7d\|<date>]` the tokens a lane used instead (Jack's with `--coordinator`) |
|
package/install.sh
CHANGED
|
@@ -9,7 +9,7 @@ set -eu
|
|
|
9
9
|
|
|
10
10
|
# The default is the version this file ships with. The release bump changes it together with
|
|
11
11
|
# package.json; install.test.ts fails while the two differ. Overridable, but only by a plain release.
|
|
12
|
-
JACKHERD_VERSION="${JACKHERD_VERSION:-1.18.
|
|
12
|
+
JACKHERD_VERSION="${JACKHERD_VERSION:-1.18.2}"
|
|
13
13
|
|
|
14
14
|
JACKHERD_PACKAGE='jackherd'
|
|
15
15
|
# Test seam: the terminal the wizard asks its questions on.
|
package/kit/hooks/ask-rules.json
CHANGED
|
@@ -16,11 +16,5 @@
|
|
|
16
16
|
"Bash(gh api *deleteRef*)",
|
|
17
17
|
"Bash(gh api *rerequestCheckSuite*)",
|
|
18
18
|
"Bash(gh api *graphql*query=@*)",
|
|
19
|
-
"Bash(gh api *graphql*--input*)"
|
|
20
|
-
"Bash(jh lane close*)",
|
|
21
|
-
"Bash(jackherd lane close*)",
|
|
22
|
-
"Bash(bunx jackherd* lane close*)",
|
|
23
|
-
"Bash(bun */cli.ts lane close*)",
|
|
24
|
-
"Bash(bunx jh lane close*)",
|
|
25
|
-
"Bash(bun x jackherd* lane close*)"
|
|
19
|
+
"Bash(gh api *graphql*--input*)"
|
|
26
20
|
]
|
|
@@ -9,7 +9,7 @@ or when the user names a lane to close. Run both commands from the main checkout
|
|
|
9
9
|
nothing: resolve each reason it prints (a named file goes to the user first, a working agent is waited for, a lock
|
|
10
10
|
is lifted once its session ended, an unmerged branch is not closed) and repeat until it exits 0.
|
|
11
11
|
A worktree on no branch closes when its head is on the base branch and only staged plan changes the base holds are left.
|
|
12
|
-
2. `jh lane close <lane>`
|
|
12
|
+
2. `jh lane close <lane>` Run it without asking the user; its checks are the safeguard. It repeats the step 1 checks (resolve a refusal as in step 1) and runs the listed steps, one line each. After a failure,
|
|
13
13
|
run it again: with the worktree gone and the branch left, `jh lane close <lane> --branch <branch>` finishes the
|
|
14
14
|
branch and the board; a lane closed in full says so and changes nothing.
|
|
15
15
|
3. The command leaves the rows marked `{{kit.word.laneClosed}} <date>` and the `{{kit.heading.history}}` row as a
|
package/package.json
CHANGED
|
@@ -35,8 +35,8 @@ export const KIT_SKILL_TARGETS: Readonly<Record<string, number>> = {
|
|
|
35
35
|
// Core cut: the `due` row of the wake-up table moved here (+33).
|
|
36
36
|
'.claude/skills/orchestrate/references/appointments.md': 290,
|
|
37
37
|
// Resume: `--branch` finishes a lane whose worktree is gone, a detached worktree on the base closes, a closed lane
|
|
38
|
-
// is reported (+41).
|
|
39
|
-
'.claude/skills/orchestrate/references/close-lane.md':
|
|
38
|
+
// is reported (+41).
|
|
39
|
+
'.claude/skills/orchestrate/references/close-lane.md': 307,
|
|
40
40
|
'.claude/skills/orchestrate/references/coordinator-handover.md': 567,
|
|
41
41
|
'.claude/skills/orchestrate/references/draft-review.md': 300,
|
|
42
42
|
// P33: a source entry the user must read or decide becomes a row of what waits on them, and when it closes.
|
package/src/lane/command.ts
CHANGED
|
@@ -17,8 +17,7 @@ const withStartLaneHint = (code: number, args: readonly string[], cwd: string):
|
|
|
17
17
|
/**
|
|
18
18
|
* `jh lane close …` closes a lane, `jh lane space …` checks the disk for a new one, `jh lane send …` sends its prompt
|
|
19
19
|
* file, `jh lane base …` names the ref its worktree starts from, everything else is `jh lane prompt …`. `close` must
|
|
20
|
-
* come first
|
|
21
|
-
* and is refused there.
|
|
20
|
+
* come first; `jh lane --board b.md close x` reaches the prompt parser and is refused there.
|
|
22
21
|
*/
|
|
23
22
|
export const run = async (args: string[], cwd: string = process.cwd()): Promise<number> => {
|
|
24
23
|
if (args[0] === SPACE) return (await import('./space-command')).run(args.slice(1), cwd)
|