jackherd 1.12.7 → 1.13.0

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 What changed for people who use jackherd, newest first.
 
+## 1.13.0
+
+- **Repositories without Node.** `jh init` reads the stack from the lock file: next to the Node managers, `composer.lock` writes the tools `composer.json` names (Pest or PHPUnit, PHPStan or Psalm, Pint or PHP-CS-Fixer, each as `vendor/bin/…`) and `composer install`. Before the first install, `composer.json` alone decides Composer, with no `lanes.lockFile`; a `package.json` without a lock file names no package manager, so none is guessed. A repository without a known stack gets no Bun commands any more; `init` leaves them out and says so, and the config gets a `$schema` only where `node_modules` can sit beside `.jackherd/`.
+- **An unset command stays unset.** `commands.*`, `lanes.lockFile` and `check.lintFilesCommand` have no Bun default any more. A kit text shows "not set: `commands.<key>` in `.jackherd/config.json`" in place of the command, and `models` has a default, so a config written by hand without it no longer stops `init`.
+- **`jh config` names what is missing.** A missing command, or one the lock files contradict (`bun test` beside only `composer.lock`), goes to stderr with the line to set; `/jh-start` passes those lines on. `jh config <key>` for an unset value exits 3 instead of printing "not set" as if it were the command.
+- **No green without a test.** `jh check` finds roots by the stack's manifest (`composer.json` as well as `package.json`), counts the repository root unless it gathers workspaces, and lints only the files the stack lints. It fails when a changed source file is reached by no test, judged per file (kit copies are tested where the kit keeps them), and when `commands.test` belongs to another stack than the lock file. A `check.checks` entry with `"kind": "tests"` counts as a test for the files its globs match.
+- **`jh init` in another repository keeps the herdr link.** Run from a checkout of jackherd for a repository that is not the checkout's own, `init` and `sync` leave a working herdr link where it is.
+- **Kit rules without a language.** The kit's rules and the diagnose and implement skills no longer name Bun, Zod, Biome, `tsconfig` or `mock.module()`; a team writes its stack's conventions into a rule of its own beside `.claude/rules/kit/`. The README has a section on other languages.
+- **A dialog that names a plan code bare is sent back.** The new hook `plain-question` (`PreToolUse` on `AskUserQuestion`) reads the codes the plans linked from the boards define (phases as `P<id>`, codes that open a table row, a heading or a bold list item; else `F`/`P`/`D`/`E` plus a number) and denies a question, header or option naming one outside brackets, so the user reads words, not shorthand. `jh check` warns about a changed "Waiting for you" row doing the same. The orchestrate skill and the lane prompt say it too.
+
 ## 1.12.7
 
 - **Newest first in the herd.** The rows of Your turn that wait on your answer (the board's open questions, a session's questions, the files and Artifacts sent to you) stand newest first; what frees a lane still comes before the rest, newest first within it. A since without a year counts in the year nearest to now, so a row of 31 December stands under one of 1 January. With more than five rows, the oldest are the ones under `▸ n more`. An opened source lists its entries newest first by the time each shows: before, an entry with its own time from the source (say, when an error was last seen) could stand among entries in the order the watcher saw them change. Rows of the same time keep their order. Appointments keep their order, the ones without a time first, then the next due.

package/INSTALL.md

@@ -54,7 +54,7 @@ When `init` creates a new config, it asks:
 | Use it when | the team shares the kit through the repository | the repository must stay untouched, not even untracked files |
 | Lives in | the project's `.claude/` | `~/.claude/` |
 | Skill names | `/plan`, `/implement`, `/orchestrate`, … | `/jh-plan`, `/jh-implement`, `/jh-orchestrate`, … |
-| Hooks | `git-guard`, `watch-guard`, `merge-guard`, `approval-gate`, `model-gate`, `model-log`, `ask-hint`, `open-question`, `sent-file`, `format-on-edit` | none; `init --global` offers only a `SessionStart` update notice |
+| Hooks | `git-guard`, `watch-guard`, `merge-guard`, `approval-gate`, `model-gate`, `model-log`, `ask-hint`, `open-question`, `plain-question`, `sent-file`, `format-on-edit` | none; `init --global` offers only a `SessionStart` update notice |
 | Config | `.jackherd/config.json` | `~/.jackherd/config.json`, used where a repository has none |
 | Update | `jh sync` | `jh update` |
 

package/README.md

@@ -1,9 +1,9 @@
 <p>
-<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.12.7/assets/branding/jackherd-logo-outline.svg" width="340">
+<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.13.0/assets/branding/jackherd-logo-outline.svg" width="340">
 <br>
 </p>
 
-[![npm](https://img.shields.io/npm/v/jackherd)](https://www.npmjs.com/package/jackherd) [![license: MIT](https://img.shields.io/npm/l/jackherd)](https://www.npmjs.com/package/jackherd) [![2 dependencies](https://img.shields.io/badge/dependencies-2-brightgreen)](https://www.npmjs.com/package/jackherd?activeTab=dependencies)<br><img width="1" height="8" alt="" src="https://unpkg.com/jackherd@1.12.7/assets/icons/space.svg">
+[![npm](https://img.shields.io/npm/v/jackherd)](https://www.npmjs.com/package/jackherd) [![license: MIT](https://img.shields.io/npm/l/jackherd)](https://www.npmjs.com/package/jackherd) [![2 dependencies](https://img.shields.io/badge/dependencies-2-brightgreen)](https://www.npmjs.com/package/jackherd?activeTab=dependencies)<br><img width="1" height="8" alt="" src="https://unpkg.com/jackherd@1.13.0/assets/icons/space.svg">
 
 # Jack herds your coding agents.
 
@@ -15,25 +15,25 @@ For developers who'd rather decide than supervise.
 curl -fsSL https://unpkg.com/jackherd/install.sh | sh
 ```
 
-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.12.7/assets/icons/space.svg">
+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.13.0/assets/icons/space.svg">
 
 <p>
-<img src="https://unpkg.com/jackherd@1.12.7/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.">
+<img src="https://unpkg.com/jackherd@1.13.0/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.">
 <br>
-<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.12.7/assets/icons/space.svg">
+<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.13.0/assets/icons/space.svg">
 </p>
 
-<p><img src="https://unpkg.com/jackherd@1.12.7/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>
+<p><img src="https://unpkg.com/jackherd@1.13.0/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>
 
-<p><img src="https://unpkg.com/jackherd@1.12.7/assets/icons/bark.svg" width="24" height="34" align="middle" alt=""> <b>Jack barks.</b><br>A blocked lane, a red check, a review comment: Jack wakes, and the herd view shows where every lane stands.</p>
+<p><img src="https://unpkg.com/jackherd@1.13.0/assets/icons/bark.svg" width="24" height="34" align="middle" alt=""> <b>Jack barks.</b><br>A blocked lane, a red check, a review comment: Jack wakes, and the herd view shows where every lane stands.</p>
 
-<p><img src="https://unpkg.com/jackherd@1.12.7/assets/icons/ear.svg" width="24" height="34" align="middle" alt=""> <b>Jack listens.</b><br>Review comments go to the lane that fixes them, with a test. <code>/jh-follow</code> brings anything with a CLI or an API into the herd: tickets, error logs, status pages, deploys, and whatever else you point it at.</p>
+<p><img src="https://unpkg.com/jackherd@1.13.0/assets/icons/ear.svg" width="24" height="34" align="middle" alt=""> <b>Jack listens.</b><br>Review comments go to the lane that fixes them, with a test. <code>/jh-follow</code> brings anything with a CLI or an API into the herd: tickets, error logs, status pages, deploys, and whatever else you point it at.</p>
 
-<p><img src="https://unpkg.com/jackherd@1.12.7/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>
+<p><img src="https://unpkg.com/jackherd@1.13.0/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>
 
-<p><img src="https://unpkg.com/jackherd@1.12.7/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.</p>
+<p><img src="https://unpkg.com/jackherd@1.13.0/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.</p>
 
-<p><img src="https://unpkg.com/jackherd@1.12.7/assets/icons/decide.svg" width="24" height="34" align="middle" alt=""> <b>You make the calls.</b><br>Nothing is committed, pushed or merged without your approval. Jack merges on green checks only where you said so: one pull request, or a plan's for up to 24 hours.<br><img width="1" height="8" alt="" src="https://unpkg.com/jackherd@1.12.7/assets/icons/space.svg"></p>
+<p><img src="https://unpkg.com/jackherd@1.13.0/assets/icons/decide.svg" width="24" height="34" align="middle" alt=""> <b>You make the calls.</b><br>Nothing is committed, pushed or merged without your approval. Jack merges on green checks only where you said so: one pull request, or a plan's for up to 24 hours.<br><img width="1" height="8" alt="" src="https://unpkg.com/jackherd@1.13.0/assets/icons/space.svg"></p>
 
 ## Quickstart
 
@@ -69,22 +69,22 @@ Then `/jh-start` in a repository, and Jack offers your first plan. → [Quicksta
    /jh-orchestrate docs/plans/board-<name>/board.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. → [INSTALL.md](https://unpkg.com/jackherd/INSTALL.md)<br><img width="1" height="8" alt="" src="https://unpkg.com/jackherd@1.12.7/assets/icons/space.svg">
+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. → [INSTALL.md](https://unpkg.com/jackherd/INSTALL.md)<br><img width="1" height="8" alt="" src="https://unpkg.com/jackherd@1.13.0/assets/icons/space.svg">
 
 ## Follow anything outside GitHub
 
 Whatever you check by hand, Jack can watch: tickets, error logs, status pages, deploys. One `/jh-follow`, one yes, and every change comes to you like this:
 
-<img src="https://unpkg.com/jackherd@1.12.7/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.">
+<img src="https://unpkg.com/jackherd@1.13.0/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.">
 
-The herd sums up your sources in one `Sources` line: per source its new entries, or when it last ran, red while it fails; opened, a click on an entry opens it. A ticket shows on the lane that works it, and a row in Your turn that came from a source starts with that source's label.<br><img width="1" height="8" alt="" src="https://unpkg.com/jackherd@1.12.7/assets/icons/space.svg">
+The herd sums up your sources in one `Sources` line: per source its new entries, or when it last ran, red while it fails; opened, a click on an entry opens it. A ticket shows on the lane that works it, and a row in Your turn that came from a source starts with that source's label.<br><img width="1" height="8" alt="" src="https://unpkg.com/jackherd@1.13.0/assets/icons/space.svg">
 
 ## In detail
 
 <details>
 <summary><b>What Jack does on his own, and what waits for you</b></summary>
 
-<img src="https://unpkg.com/jackherd@1.12.7/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.">
+<img src="https://unpkg.com/jackherd@1.13.0/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.">
 
 | On his own | After your approval | Never |
 | --- | --- | --- |
@@ -117,7 +117,7 @@ The guards catch mistakes, not intent; for that, use branch protection. The hook
 
 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.
 
-<img src="https://unpkg.com/jackherd@1.12.7/docs/skills-dark.svg" alt="/jh-grill hands decisions to /jh-plan; /jh-plan feeds /jh-orchestrate or a single /jh-implement; /jh-implement ends in /jh-pre-commit, which runs the reviewers; /jh-diagnose hands a red command to /jh-implement.">
+<img src="https://unpkg.com/jackherd@1.13.0/docs/skills-dark.svg" alt="/jh-grill hands decisions to /jh-plan; /jh-plan feeds /jh-orchestrate or a single /jh-implement; /jh-implement ends in /jh-pre-commit, which runs the reviewers; /jh-diagnose hands a red command to /jh-implement.">
 
 | Skill | Does |
 | --- | --- |
@@ -222,7 +222,7 @@ Each phase in the plan names its model: the planning model (Opus by default) whe
 | `jh preview <file>` | renders a Markdown file through the GitHub API into a preview in GitHub and npm style |
 | `jh waiting` | the files and Artifacts sent to you that you have not answered yet (`close <id>…` or `close --all` once you have) |
 | `jh context` | how full an agent's context is, as JSON |
-| `jh config` | the commands and the base branch the repository uses |
+| `jh config` | the commands and the base branch the repository uses; a missing value or one the lock files contradict goes to stderr with the line to set, and `jh config <key>` for an unset value exits 3 |
 
 Without a global install, run them as `bunx jackherd <command>`. The config is `.jackherd/config.json` in a project and `~/.jackherd/config.json` globally, checked against [one schema](https://unpkg.com/jackherd/schemas/jackherd.schema.json), which your editor completes in the project config. What usually needs setting:
 
@@ -242,6 +242,24 @@ Without a global install, run them as `bunx jackherd <command>`. The config is `
 
 </details>
 
+<details>
+<summary><b>Other languages</b></summary>
+
+jackherd runs on Bun; your project does not need Node. `jh init` reads the lock file in the repository root and writes the commands of that stack:
+
+| Lock file | Commands |
+| --- | --- |
+| `bun.lock`, `package-lock.json`, `yarn.lock`, `pnpm-lock.yaml` | the manager's own (`bun test`, `npm test`, …), TypeScript and Biome |
+| `composer.lock`, or `composer.json` before the first install | from `composer.json`: Pest or PHPUnit, PHPStan or Psalm, Pint or PHP-CS-Fixer, each as `vendor/bin/…`; `composer install` |
+
+A tool the manifest does not name gets no command, and a repository without a known lock file or a `composer.json` gets none at all: jackherd never guesses one, so a `package.json` without a lock file names no package manager. `jh config` names each missing value with the line to set, and `/jh-start` passes those lines on. Set a command yourself under `commands` in `.jackherd/config.json`; a value there always wins.
+
+`jh check` tests from the nearest directory with the stack's manifest (`package.json`, `composer.json`), type-checks where a type config is (`tsconfig.json`, `phpstan.neon`), and lints only the files the stack lints. It fails when a changed source file is reached by no test, and when `commands.test` belongs to another stack than the lock file (`bun test` beside `composer.lock`), since such a run finds no test. A suite that runs some other way is a `check.checks` entry with `"kind": "tests"`.
+
+The kit rules name no language, framework or test runner. Put your team's conventions (PSR-12, the PHPStan level, how Pest tests are written) into a rule of your own beside `.claude/rules/kit/`; `jh sync` never touches it.
+
+</details>
+
 <details>
 <summary><b>Troubleshooting</b></summary>
 

package/dist/config.d.ts

@@ -15,10 +15,27 @@ declare const MODEL_ROLE: {
     readonly orchestrate: "orchestrate";
 };
 type ModelRole = (typeof MODEL_ROLE)[keyof typeof MODEL_ROLE];
+/** The model of each role when the config names none: a new project's, and one written by hand without `models`. */
+declare const DEFAULT_MODELS: Record<ModelRole, string>;
 declare const isTerminalAdapter: (value: string) => value is TerminalAdapter;
 declare const isModelRole: (value: string) => value is ModelRole;
 /** Lower-case letters and digits ending in a dash, so a prefixed name stays one plain path segment. */
 declare const SKILL_PREFIX: RegExp;
+/**
+ * The project's own commands. Each is optional: detection fills what the repository's stack decides, and a command
+ * nobody set stays out instead of a guessed one (a kit text then says where to set it).
+ */
+declare const commandsSchema: z.ZodObject<{
+    test: z.ZodOptional<z.ZodString>;
+    typecheck: z.ZodOptional<z.ZodString>;
+    lint: z.ZodOptional<z.ZodString>;
+    format: z.ZodOptional<z.ZodString>;
+    install: z.ZodOptional<z.ZodString>;
+    dev: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+type CommandKey = keyof z.infer<typeof commandsSchema>;
+/** Every key of the `commands` block, as the schema names them. */
+declare const COMMAND_KEYS: CommandKey[];
 /** The window `plans.context.defaultWindow` assumes when the config leaves it out. */
 declare const DEFAULT_CONTEXT_WINDOW = 200000;
 declare const sourceSchema: z.ZodObject<{
@@ -77,24 +94,24 @@ declare const jackherdConfigSchema: z.ZodObject<{
     baseBranch: z.ZodDefault<z.ZodString>;
     skillPrefix: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<"">, z.ZodString]>>;
     commands: z.ZodPrefault<z.ZodObject<{
-        test: z.ZodDefault<z.ZodString>;
-        typecheck: z.ZodDefault<z.ZodString>;
-        lint: z.ZodDefault<z.ZodString>;
-        format: z.ZodDefault<z.ZodString>;
-        install: z.ZodDefault<z.ZodString>;
-        dev: z.ZodDefault<z.ZodString>;
+        test: z.ZodOptional<z.ZodString>;
+        typecheck: z.ZodOptional<z.ZodString>;
+        lint: z.ZodOptional<z.ZodString>;
+        format: z.ZodOptional<z.ZodString>;
+        install: z.ZodOptional<z.ZodString>;
+        dev: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
     lanes: z.ZodPrefault<z.ZodObject<{
         copy: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        lockFile: z.ZodDefault<z.ZodString>;
+        lockFile: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
-    models: z.ZodRecord<z.ZodEnum<{
+    models: z.ZodDefault<z.ZodRecord<z.ZodEnum<{
         plan: "plan";
         implement: "implement";
         review: "review";
         explore: "explore";
         orchestrate: "orchestrate";
-    }>, z.ZodString>;
+    }>, z.ZodString>>;
     terminal: z.ZodPrefault<z.ZodObject<{
         adapter: z.ZodDefault<z.ZodEnum<{
             none: "none";
@@ -277,11 +294,15 @@ declare const jackherdConfigSchema: z.ZodObject<{
         taskSignal: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strict>>;
     check: z.ZodOptional<z.ZodObject<{
-        lintFilesCommand: z.ZodDefault<z.ZodString>;
+        lintFilesCommand: z.ZodOptional<z.ZodString>;
         checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
             command: z.ZodString;
             globs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            kind: z.ZodOptional<z.ZodEnum<{
+                types: "types";
+                tests: "tests";
+            }>>;
         }, z.core.$strict>>>;
         generatorOwned: z.ZodDefault<z.ZodArray<z.ZodObject<{
             glob: z.ZodString;
@@ -309,4 +330,4 @@ declare const parseConfigFile: (raw: unknown, label: string) => JackherdConfig;
 /** One `watch.sources` entry outside the config, such as a draft to try; invalid throws with `label` and the issues. */
 declare const parseSourceDraft: (raw: unknown, label: string) => z.infer<typeof sourceSchema>;
 
-export { DEFAULT_CONTEXT_WINDOW, type JackherdConfig, MODEL_ROLE, type ModelRole, SKILL_PREFIX, TERMINAL_ADAPTER, type TerminalAdapter, isModelRole, isTerminalAdapter, jackherdConfigSchema, parseConfigFile, parseJackherdConfig, parseSourceDraft, renderConfigJsonSchema };
+export { COMMAND_KEYS, type CommandKey, DEFAULT_CONTEXT_WINDOW, DEFAULT_MODELS, type JackherdConfig, MODEL_ROLE, type ModelRole, SKILL_PREFIX, TERMINAL_ADAPTER, type TerminalAdapter, isModelRole, isTerminalAdapter, jackherdConfigSchema, parseConfigFile, parseJackherdConfig, parseSourceDraft, renderConfigJsonSchema };

package/dist/config.js

@@ -12,72 +12,6 @@ import { z as z2 } from "zod";
 // src/check/schema.ts
 import { z } from "zod";
 
-// src/version/release.ts
-var PACKAGE_NAME = "jackherd";
-
-// src/config/location.ts
-import { dirname, join, resolve } from "path";
-var TOOL_DIRECTORY = ".jackherd";
-var CONFIG_FILE = "config.json";
-var CONFIG_SCHEMA_REFERENCE = `../node_modules/${PACKAGE_NAME}/schemas/${PACKAGE_NAME}.schema.json`;
-var PROJECT_CONFIG_PATH = `${TOOL_DIRECTORY}/${CONFIG_FILE}`;
-
-// src/config/detect.ts
-var PACKAGE_MANAGER = { bun: "bun", yarn: "yarn", pnpm: "pnpm", npm: "npm" };
-var LOCK_FILES = {
-  "bun.lock": PACKAGE_MANAGER.bun,
-  "bun.lockb": PACKAGE_MANAGER.bun,
-  "yarn.lock": PACKAGE_MANAGER.yarn,
-  "pnpm-lock.yaml": PACKAGE_MANAGER.pnpm,
-  "package-lock.json": PACKAGE_MANAGER.npm
-};
-var DEFAULT_BASE_BRANCH = "main";
-var DERIVED_COMMANDS = {
-  bun: {
-    test: "bun test",
-    typecheck: "bunx -p typescript tsc --noEmit",
-    lint: "bunx @biomejs/biome check .",
-    format: "bunx @biomejs/biome format --write .",
-    install: "bun install",
-    dev: "bun run dev",
-    lintFiles: "bunx @biomejs/biome check --no-errors-on-unmatched"
-  },
-  yarn: {
-    test: "yarn test",
-    typecheck: "yarn tsc --noEmit",
-    lint: "yarn biome check .",
-    format: "yarn biome format --write .",
-    install: "yarn install",
-    dev: "yarn dev",
-    lintFiles: "yarn biome check --no-errors-on-unmatched"
-  },
-  pnpm: {
-    test: "pnpm test",
-    typecheck: "pnpm exec tsc --noEmit",
-    lint: "pnpm exec biome check .",
-    format: "pnpm exec biome format --write .",
-    install: "pnpm install",
-    dev: "pnpm dev",
-    lintFiles: "pnpm exec biome check --no-errors-on-unmatched"
-  },
-  npm: {
-    test: "npm test",
-    typecheck: "npx tsc --noEmit",
-    lint: "npx @biomejs/biome check .",
-    format: "npx @biomejs/biome format --write .",
-    install: "npm install",
-    dev: "npm run dev",
-    lintFiles: "npx @biomejs/biome check --no-errors-on-unmatched"
-  }
-};
-var FROZEN_INSTALL = {
-  [DERIVED_COMMANDS.bun.install]: "bun install --frozen-lockfile",
-  [DERIVED_COMMANDS.yarn.install]: "yarn install --immutable",
-  [DERIVED_COMMANDS.pnpm.install]: "pnpm install --frozen-lockfile",
-  [DERIVED_COMMANDS.npm.install]: "npm ci"
-};
-var BUN_COMMANDS = DERIVED_COMMANDS.bun;
-
 // src/check/command-line.ts
 var TOKEN = /(?:"[^"]*"|'[^']*'|\S)+/g;
 var QUOTED = /"([^"]*)"|'([^']*)'/g;
@@ -86,6 +20,9 @@ var tokenize = (command3) => (command3.match(TOKEN) ?? []).map((token) => {
   return token.replace(QUOTED, "$1$2");
 });
 
+// src/check/result.ts
+var CHECK_KIND = { lint: "lint", project: "project", types: "types", tests: "tests" };
+
 // src/check/schema.ts
 var nonEmpty = z.string().min(1);
 var isTokenizable = (command3) => {
@@ -115,7 +52,12 @@ var projectCheck = z.strictObject({
   name: nonEmpty,
   command,
   /** Without globs the check runs on every change; with them, only when a changed path matches. */
-  globs: globs.optional()
+  globs: globs.optional(),
+  /**
+   * `tests` for a check that runs the project's tests, `types` for its type check; without one, a plain project check.
+   * A test run counts towards "no green without a test", and both run with the slow checks.
+   */
+  kind: z.enum([CHECK_KIND.tests, CHECK_KIND.types]).optional()
 });
 var generatorOwned = z.strictObject({
   glob,
@@ -133,9 +75,9 @@ var skillBudgets = z.record(glob, z.number().int().positive());
 var checkConfigSchema = z.strictObject({
   /**
    * Run once over the changed files, which are appended as arguments. Separate from `commands.lint`,
-   * which lints the whole project.
+   * which lints the whole project. Detected from the repository when left out; without one, no lint runs.
    */
-  lintFilesCommand: command.default(BUN_COMMANDS.lintFiles),
+  lintFilesCommand: command.optional(),
   /** Project checks, run alongside lint; add repository-specific scripts here. */
   checks: z.array(projectCheck).default([]),
   generatorOwned: z.array(generatorOwned).default([]),
@@ -196,6 +138,9 @@ var DAY_MS = 864e5;
 var MAX_AUTO_WINDOW_DAYS = 7;
 var windowDays = (since, until) => Math.round((Date.parse(`${until}T00:00:00Z`) - Date.parse(`${since}T00:00:00Z`)) / DAY_MS);
 
+// src/config/base-branch.ts
+var DEFAULT_BASE_BRANCH = "main";
+
 // src/config/link-kinds.ts
 var ARTIFACT_LINK_KIND = {
   pattern: "^https://claude\\.ai/(code/)?artifact/",
@@ -310,6 +255,13 @@ var MODEL_ROLE = {
   explore: "explore",
   orchestrate: "orchestrate"
 };
+var DEFAULT_MODELS = {
+  [MODEL_ROLE.plan]: "claude-opus-5-5",
+  [MODEL_ROLE.implement]: "claude-sonnet-5-5",
+  [MODEL_ROLE.review]: "claude-sonnet-5-5",
+  [MODEL_ROLE.explore]: "claude-sonnet-5-5",
+  [MODEL_ROLE.orchestrate]: "claude-opus-5-5"
+};
 var isTerminalAdapter = (value) => Object.values(TERMINAL_ADAPTER).includes(value);
 var isModelRole = (value) => Object.values(MODEL_ROLE).includes(value);
 var SKILL_PREFIX = /^[a-z0-9]+-$/;
@@ -318,6 +270,17 @@ var language = z2.enum(Object.values(PLAN_LANGUAGE));
 var modelId = z2.string().regex(FULL_MODEL_ID, "Use a full model ID such as claude-opus-5-5, not an alias like opus or sonnet");
 var command2 = z2.string().min(1);
 var tokenCount = z2.number().int().positive();
+var commandsSchema = z2.strictObject({
+  test: command2.optional(),
+  typecheck: command2.optional(),
+  lint: command2.optional(),
+  format: command2.optional(),
+  /** Installs a new lane's dependencies. */
+  install: command2.optional(),
+  /** Starts a lane's dev server, run as `PORT=<port> <dev>`; a project supplement may name another. */
+  dev: command2.optional()
+});
+var COMMAND_KEYS = Object.keys(commandsSchema.shape);
 var DEFAULT_CONTEXT_WINDOW = 2e5;
 var laneCopyPath = z2.string().regex(
   // biome-ignore lint/suspicious/noControlCharactersInRegex: the class exists to refuse control characters
@@ -587,24 +550,15 @@ var jackherdConfigSchema = z2.strictObject({
    * kit name (`implement`, `plan`, …) apart from the kit's.
    */
   skillPrefix: z2.union([z2.literal(""), z2.string().regex(SKILL_PREFIX, "lower-case letters and digits ending in a dash, e.g. kit-")]).default(""),
-  commands: z2.strictObject({
-    test: command2.default(BUN_COMMANDS.test),
-    typecheck: command2.default(BUN_COMMANDS.typecheck),
-    lint: command2.default(BUN_COMMANDS.lint),
-    format: command2.default(BUN_COMMANDS.format),
-    /** Installs a new lane's dependencies. */
-    install: command2.default(BUN_COMMANDS.install),
-    /** Starts a lane's dev server, run as `PORT=<port> <dev>`; a project supplement may name another. */
-    dev: command2.default(BUN_COMMANDS.dev)
-  }).prefault({}),
+  commands: commandsSchema.prefault({}),
   /** How `/orchestrate` sets up a lane's worktree. */
   lanes: z2.strictObject({
     /** Untracked files copied into every new worktree; empty means the files `.worktreeinclude` lists. */
     copy: z2.array(laneCopyPath).default([]),
-    /** The dependency lock file a rebase takes from the base branch and regenerates, never merges by hand. */
-    lockFile: lockFilePath.default("bun.lock")
+    /** The dependency lock file a rebase takes from the base branch and regenerates, never merges by hand; detected from the repository when left out. */
+    lockFile: lockFilePath.optional()
   }).prefault({}),
-  models: z2.record(z2.enum(Object.values(MODEL_ROLE)), modelId),
+  models: z2.record(z2.enum(Object.values(MODEL_ROLE)), modelId).default(DEFAULT_MODELS),
   terminal: z2.strictObject({ adapter: z2.enum(Object.values(TERMINAL_ADAPTER)).default(TERMINAL_ADAPTER.none) }).prefault({}),
   /** How the coordinator shows a draft for review (`orchestrate` § 4). */
   preview: z2.strictObject({
@@ -669,7 +623,9 @@ var parseSourceDraft = (raw, label) => parseLabelled(sourceSchema, raw, label);
 var renderConfigJsonSchema = () => `${JSON.stringify(z3.toJSONSchema(jackherdConfigSchema, { io: "input" }), null, 2)}
 `;
 export {
+  COMMAND_KEYS,
   DEFAULT_CONTEXT_WINDOW,
+  DEFAULT_MODELS,
   MODEL_ROLE,
   SKILL_PREFIX,
   TERMINAL_ADAPTER,

package/herdr-plugin/herdr-plugin.toml

@@ -1,6 +1,6 @@
 id = "crossdelta.jackherd"
 name = "jackherd"
-version = "1.12.7"
+version = "1.13.0"
 min_herdr_version = "0.8.2"
 description = "Show the herd, the state of a board's lanes, in a herdr pane"
 platforms = ["linux", "macos"]

package/install.sh

@@ -9,7 +9,7 @@ set -eu
 
 # The default is the version this file ships with. The release bump changes it together with
 # package.json; install.test.ts fails while the two differ. Overridable, but only by a plain release.
-JACKHERD_VERSION="${JACKHERD_VERSION:-1.12.7}"
+JACKHERD_VERSION="${JACKHERD_VERSION:-1.13.0}"
 
 JACKHERD_PACKAGE='jackherd'
 # Test seam: the terminal the wizard asks its questions on.

package/kit/hooks/hooks/merge-guard/board-settings.ts

@@ -1,42 +1,24 @@
 import { baseBranchOf } from '../shared/base-branch'
-import { BOARD_WORDS, type BoardLanguage } from '../shared/board-lanes'
+import { type BoardLocation, boardLocationValues } from '../shared/boards'
 import { isRecord } from '../shared/json'
-import { isRepositoryDirectory } from '../shared/repository-directory'
 import { isControlCharacter } from './plain-path'
 
 /**
  * Where plans, boards and lanes live, the base branch, and the checks a standing approval waits for. `null` from
  * `boardSettingsOf` means the standing approval is off and every merge asks.
  */
-export type BoardSettings = {
-  planLanguage: BoardLanguage
-  planDirectory: string
-  board: { pattern: string; file: string }
-  worktreeDirectory: string
+export type BoardSettings = BoardLocation & {
   baseBranch: string
   /** The checks that must be among the head commit's and green; undefined: at least one check, every one green. */
   requiredChecks: readonly string[] | undefined
 }
 
 const MAX_CHECK_NAME = 200
-const BOARD_PATTERN = /^(?![-.])[A-Za-z0-9._*?-]+$/
-const BOARD_FILE = /^(?![-.])[A-Za-z0-9._-]+\.md$/
-
-/** The value at `key`, its default when absent, `undefined` when present but invalid. */
-const valueOr = <T>(section: Record<string, unknown>, key: string, isValid: (value: unknown) => value is T, fallback: T) =>
-  !(key in section) ? fallback : isValid(section[key]) ? section[key] : undefined
 
 /** An optional value: `{ value }` with `value` undefined when absent, `undefined` when present but invalid. */
 const optionalValue = <T>(section: Record<string, unknown>, key: string, isValid: (value: unknown) => value is T) =>
   !(key in section) ? { value: undefined } : isValid(section[key]) ? { value: section[key] } : undefined
 
-const matches =
-  (pattern: RegExp) =>
-  (value: unknown): value is string =>
-    typeof value === 'string' && pattern.test(value)
-
-const isPlanLanguage = (value: unknown): value is BoardLanguage => typeof value === 'string' && Object.hasOwn(BOARD_WORDS, value)
-
 const isSectionOrAbsent = (config: Record<string, unknown>, key: string): boolean =>
   !(key in config) || isRecord(config[key])
 
@@ -64,18 +46,11 @@ const requiredChecksOf = (guard: Record<string, unknown>) =>
     : optionalValue(sectionAt(guard, 'planApproval'), 'requiredChecks', isCheckList)
 
 /** Every value the standing approval reads, with its default where absent; `undefined` stands for a present but invalid one. */
-const boardValues = (config: Record<string, unknown>) => {
-  const board = sectionAt(config, 'board')
-  return {
-    requiredChecks: requiredChecksOf(sectionAt(config, 'guard')),
-    planLanguage: valueOr(config, 'planLanguage', isPlanLanguage, 'en'),
-    planDirectory: valueOr(config, 'planDirectory', isRepositoryDirectory, 'docs/plans'),
-    pattern: valueOr(board, 'pattern', matches(BOARD_PATTERN), 'board-*'),
-    file: valueOr(board, 'file', matches(BOARD_FILE), 'board.md'),
-    worktreeDirectory: valueOr(config, 'worktreeDirectory', isRepositoryDirectory, '.claude/worktrees'),
-    baseBranch: baseBranchOf(config),
-  }
-}
+const boardValues = (config: Record<string, unknown>) => ({
+  requiredChecks: requiredChecksOf(sectionAt(config, 'guard')),
+  ...boardLocationValues(config, sectionAt(config, 'board')),
+  baseBranch: baseBranchOf(config),
+})
 
 type Values = ReturnType<typeof boardValues>
 type ValidValues = { [Key in keyof Values]: Exclude<Values[Key], undefined> }

package/kit/hooks/hooks/merge-guard/lane-plan.ts

@@ -3,15 +3,12 @@
  * link on the boards, as the main checkout holds them (the coordinator keeps its board there, committed or not). The
  * git call runs without a shell and with a timeout; any failure answers nothing, so the guard asks.
  */
-import { readdirSync, readFileSync } from 'node:fs'
-import { join, posix, relative, resolve } from 'node:path'
+import { relative, resolve } from 'node:path'
 import { type BoardLanguage, lanePlansOf } from '../shared/board-lanes'
+import { type Board, boardsIn } from '../shared/boards'
 import { laneOf } from '../shared/lane'
 import type { BoardSettings } from './board-settings'
 
-/** A board's directory relative to the repository, and its text. */
-export type Board = { directory: string; text: string }
-
 const GIT_TIMEOUT_MS = 3000
 
 /** The lane whose worktree, directly below the worktree directory, has `branch` checked out. */
@@ -47,30 +44,6 @@ const worktreeListOf = (main: string): string | undefined => {
   return result.exitCode === 0 ? result.stdout.toString() : undefined
 }
 
-const readTextOrUndefined = (path: string): string | undefined => {
-  try {
-    return readFileSync(path, 'utf8')
-  } catch {
-    return undefined
-  }
-}
-
-/** The boards under the plan directory of the main checkout whose directory name matches the board pattern. */
-const boardsIn = (main: string, settings: BoardSettings): Board[] => {
-  const pattern = new Bun.Glob(settings.board.pattern)
-  try {
-    return readdirSync(join(main, settings.planDirectory), { withFileTypes: true })
-      .filter((entry) => entry.isDirectory() && pattern.match(entry.name))
-      .flatMap((entry) => {
-        const directory = posix.join(settings.planDirectory, entry.name)
-        const text = readTextOrUndefined(join(main, directory, settings.board.file))
-        return text === undefined ? [] : [{ directory, text }]
-      })
-  } catch {
-    return []
-  }
-}
-
 /** The one plan the lane of `branch` links on the boards of the main checkout; undefined when it cannot tell. */
 export const planOfBranch = (main: string, settings: BoardSettings, branch: string): string | undefined => {
   const list = worktreeListOf(main)

package/kit/hooks/hooks/plain-question/code-cache.ts

@@ -0,0 +1,70 @@
+import { isRecord } from '../shared/json'
+
+/** A plan file as `stat` sees it: its absolute path, modification time and size, the cache's key. */
+export type PlanFileStat = { path: string; mtimeMs: number; size: number }
+
+/** The codes of each plan file the last dialog read, by absolute path, with the time and size they were read at. */
+export type CodeCache = Record<string, { mtimeMs: number; size: number; codes: string[] }>
+
+/** The codes the files define together (null when none could be read), the cache to keep, and whether it changed. */
+export type CodeLookup = { codes: Set<string> | null; cache: CodeCache; changed: boolean }
+
+const CACHE_VERSION = 1
+
+const isEntry = (value: unknown): value is CodeCache[string] =>
+  isRecord(value) &&
+  typeof value.mtimeMs === 'number' &&
+  typeof value.size === 'number' &&
+  Array.isArray(value.codes) &&
+  value.codes.every((code) => typeof code === 'string')
+
+/** The cache file's text as a cache; a missing, broken or foreign file, and each entry of the wrong shape, read as empty. */
+export const parseCodeCache = (text: string | null): CodeCache => {
+  try {
+    const parsed: unknown = text === null ? null : JSON.parse(text)
+    if (!isRecord(parsed) || parsed.version !== CACHE_VERSION || !isRecord(parsed.entries)) return {}
+    return Object.fromEntries(
+      Object.entries(parsed.entries).flatMap(([path, entry]): [string, CodeCache[string]][] =>
+        isEntry(entry) ? [[path, entry]] : [],
+      ),
+    )
+  } catch {
+    return {}
+  }
+}
+
+export const serializeCodeCache = (cache: CodeCache): string =>
+  `${JSON.stringify({ version: CACHE_VERSION, entries: cache })}\n`
+
+const isFresh = (entry: CodeCache[string] | undefined, { mtimeMs, size }: PlanFileStat): entry is CodeCache[string] =>
+  entry !== undefined && entry.mtimeMs === mtimeMs && entry.size === size
+
+/**
+ * The codes of the plan files: a file whose time and size match its cache entry is not read, the others are read and
+ * parsed, copies with the same text once. The cache keeps exactly the files read or reused now, so an unlinked plan
+ * leaves it.
+ */
+export const lookUpCodes = (
+  stats: readonly PlanFileStat[],
+  cache: CodeCache,
+  readText: (path: string) => string | null,
+  codesOf: (text: string) => string[],
+): CodeLookup => {
+  const parsed = new Map<string, string[]>()
+  const parse = (text: string): string[] => parsed.get(text) ?? parsed.set(text, codesOf(text)).get(text) ?? []
+  let missed = false
+  const entries = stats.flatMap((stat): [string, CodeCache[string]][] => {
+    const entry = cache[stat.path]
+    if (isFresh(entry, stat)) return [[stat.path, entry]]
+    missed = true
+    const text = readText(stat.path)
+    return text === null ? [] : [[stat.path, { mtimeMs: stat.mtimeMs, size: stat.size, codes: parse(text) }]]
+  })
+  const next = Object.fromEntries(entries)
+  const dropped = Object.keys(cache).some((path) => !(path in next))
+  return {
+    codes: entries.length === 0 ? null : new Set(entries.flatMap(([, entry]) => entry.codes)),
+    cache: next,
+    changed: missed || dropped,
+  }
+}