jackherd 1.8.1 → 1.10.0

package/dist/config.js

@@ -1,7 +1,7 @@
 import {
   PLAN_LANGUAGE,
   RESPONSE_ADDRESS
-} from "./chunk-OU2KALXP.js";
+} from "./chunk-5MQBCUQ5.js";
 
 // src/config/json-schema.ts
 import { z as z3 } from "zod";
@@ -129,6 +129,7 @@ var publicContent = z.strictObject({
   /** The agent that judges such a change; a global install names it with its prefix. */
   reviewer: nonEmpty.default("public-content")
 });
+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`,
@@ -141,6 +142,11 @@ var checkConfigSchema = z.strictObject({
   buildArtifacts: z.array(glob).default([...DEFAULT_BUILD_ARTIFACT_GLOBS]),
   reviewerRoutes: z.array(reviewerRoute).default([]),
   publicContent: publicContent.optional(),
+  /**
+   * Word budgets for the files an agent loads again and again. An entry replaces the kit's budget for the same
+   * path and sets one for the project's own skills; a file with none is measured against the kit's default.
+   */
+  skillBudgets: skillBudgets.optional(),
   /** Also run tests in directories that hold test files but belong to no package. */
   looseTests: z.boolean().default(false)
 });
@@ -182,11 +188,23 @@ var isSourcePath = (path) => pathSteps(path) !== null;
 var CLEAN_REVIEW_TEXT = "## Code review\n\nNo issues found. Checked for bugs and CLAUDE.md compliance.";
 var BUN_FAILED_TEST_PATTERN = "^\\(fail\\) (.+?)(?: \\[[\\d.]+m?s\\])?$";
 
+// src/plan-format/clock.ts
+var DAY_MS = 864e5;
+
+// src/config/auto-window.ts
+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/link-kinds.ts
+var ARTIFACT_LINK_KIND = {
+  pattern: "^https://claude\\.ai/(code/)?artifact/",
+  label: "Artifact",
+  icon: "\u2726"
+};
 var DEFAULT_LINK_KINDS = [
   { pattern: "^https://github\\.com/[^/]+/[^/]+/(pull|issues)/\\d+", label: "GitHub", icon: "\u2442" },
   { pattern: "^https://(www\\.)?figma\\.com/", label: "Figma", icon: "\u25C8" },
-  { pattern: "^https://claude\\.ai/(code/)?artifact/", label: "Artifact", icon: "\u2726" }
+  ARTIFACT_LINK_KIND
 ];
 var isRegularExpression = (source) => {
   try {
@@ -313,6 +331,25 @@ var feedbackSchema = z2.strictObject({
    */
   noFindingTemplates: z2.array(z2.string().min(1)).default([CLEAN_REVIEW_TEXT])
 });
+var DEFAULT_PARALLEL_TASKS_MAX_TOKENS = 1e5;
+var parallelTasksSchema = z2.strictObject({
+  /**
+   * The most the extra agents of a parallel proposal may cost before they do anything: the token baseline of a fresh
+   * agent times the agents to add. Above it the watcher does not propose parallel tasks. The baseline is the context
+   * the first answer of a lane's session carried.
+   */
+  maxTokens: z2.number().int().positive().default(DEFAULT_PARALLEL_TASKS_MAX_TOKENS),
+  /**
+   * The days, both included, on which a proposal that keeps every limit is marked `auto` and the coordinator starts it
+   * without asking: subagents beside running work in a lane, at most two extra agents, no path that always asks.
+   * `since` is the day it was switched on, `until` at most seven days later; outside the window it is off. Unset by
+   * default, so every proposal asks.
+   */
+  auto: z2.strictObject({ since: z2.iso.date(), until: z2.iso.date() }).refine(({ since, until }) => until >= since, "until must not be before since").refine(
+    ({ since, until }) => windowDays(since, until) <= MAX_AUTO_WINDOW_DAYS,
+    `until must be at most ${MAX_AUTO_WINDOW_DAYS} days after since`
+  ).optional()
+});
 var checksSchema = z2.strictObject({
   /**
    * Finds a failed test in a line of a red run's log (`gh run view --log-failed`) after its job, step and timestamp
@@ -397,9 +434,9 @@ var sourceSchema = z2.strictObject({
 var hasUniqueNames = (sources) => new Set(sources.map(({ name }) => name)).size === sources.length;
 var coordinatorSchema = z2.strictObject({
   /** Tokens in the coordinator's context from which the watcher reports `coordinator warn`. */
-  warnTokens: tokenCount.default(2e5),
+  warnTokens: tokenCount.default(35e4),
   /** Tokens in the coordinator's context from which the watcher reports `coordinator alert`. */
-  alertTokens: tokenCount.default(3e5)
+  alertTokens: tokenCount.default(5e5)
 }).refine(warnBelowAlert, WARN_BELOW_ALERT);
 var guardedCommand = z2.string().regex(/^[a-z][a-z0-9-]*( [a-z][a-z0-9-]*){1,3}$/, "a program and one to three plain words, such as gh pr merge");
 var checkFreePattern = z2.string().regex(/^[A-Za-z0-9_.*/-]+$/, "path words with * and ** only, such as docs/**/*.md").refine(
@@ -425,13 +462,13 @@ var mergeSchema = z2.strictObject({
    */
   withoutChecks: z2.array(checkFreePattern).default([])
 });
-var guardSchema = z2.strictObject({
+var guardFields = z2.strictObject({
   /**
-   * The commands the merge guard hook asks the user about before they run, also behind options before the verb, a chain,
-   * a wrapper or `sh -c`. `gh api` asks only for a write to a merge, a file, a dispatch, a rerun or a ref. An empty list switches the
-   * guard off.
+   * The commands the merge guard hook asks the user about before they run, where they stand at a program position, also
+   * behind options before the verb, a chain, a wrapper or `sh -c`. `gh api`, when listed, asks only for a write to a
+   * merge, a file, a dispatch, a rerun or a ref. An empty list switches the guard off.
    */
-  commands: z2.array(guardedCommand).default(["gh pr merge", "gh workflow run", "gh run rerun", "gh api"]),
+  commands: z2.array(guardedCommand).default(["gh pr merge", "gh workflow run"]),
   selfMerge: z2.strictObject({
     /** Whether `/orchestrate` offers "merge it yourself after green checks" in the pull request question; off also stops the hook honouring such an answer. */
     offer: z2.boolean().default(true),
@@ -442,28 +479,39 @@ var guardSchema = z2.strictObject({
     /** How long the approval gate hook holds a lane's call for the coordinator's dialog before it denies it; below the hook's 10 minutes. */
     waitMinutes: z2.number().int().min(1).max(9).default(8)
   }).prefault({}),
-  planApproval: z2.strictObject({
-    /**
-     * Paths that always ask, on top of the ones jackherd brings (`.github/**`, `**\/migrations/**`, `**\/.env*`,
-     * `.claude/**`, `.jackherd/**`, `bunfig.toml`, `**\/CLAUDE.md`, `**\/AGENTS.md`, `.agents/**`, `.mcp.json`,
-     * `.husky/**`, `lefthook.yml`, the lockfiles of bun, npm, pnpm and yarn, `**\/.npmrc`, `**\/CODEOWNERS`, every
-     * package.json, and the CHANGELOG.md of every package without `"private": true`):
-     * a pull request that changes one is never merged on a plan approval alone. They add to that list, never replace
-     * it; an invalid entry turns plan approval off, so every merge asks.
-     */
-    exceptPaths: z2.array(alwaysAskPattern).default([]),
-    /**
-     * Checks that must be among the head commit's and green before a plan approval lets a merge pass, by their names
-     * on GitHub. Unset, the merge needs at least one check and every one green; set, also each of these. Either way
-     * GitHub must be able to merge it and the head must contain the base branch.
-     */
-    requiredChecks: z2.array(checkName).optional()
-  }).prefault({})
+  /**
+   * Paths that always ask, on top of the ones jackherd brings (`.github/**`, `**\/migrations/**`, `**\/.env*`,
+   * `.claude/**`, `.jackherd/**`, `bunfig.toml`, `**\/CLAUDE.md`, `**\/AGENTS.md`, `.agents/**`, `.mcp.json`,
+   * `.husky/**`, `lefthook.yml`, the lockfiles of bun, npm, pnpm and yarn, `**\/.npmrc`, `**\/CODEOWNERS`): a
+   * `merge.withoutChecks` pattern never opens them, and the watcher never starts parallel work on them by itself. They
+   * add to that list, never replace it. A standing approval covers them; only workflows, migrations and env files ask.
+   */
+  alwaysAsk: z2.array(alwaysAskPattern).default([]),
+  /**
+   * Checks that must be among the head commit's and green before a standing approval lets a merge pass, by their names
+   * on GitHub. Unset, the merge needs at least one check and every one green; set, also each of these. Either way
+   * GitHub must be able to merge it.
+   */
+  requiredChecks: z2.array(checkName).optional(),
+  /** Read until 2.0.0 as `alwaysAsk` (`exceptPaths`) and `requiredChecks`; the plan approval it was for is gone. */
+  planApproval: z2.strictObject({ exceptPaths: z2.array(alwaysAskPattern).optional(), requiredChecks: z2.array(checkName).optional() }).optional().meta({ deprecated: true })
 });
+var guardWithoutPlanApproval = ({ planApproval, ...guard }) => {
+  const requiredChecks = guard.requiredChecks ?? planApproval?.requiredChecks;
+  return {
+    ...guard,
+    alwaysAsk: [...guard.alwaysAsk, ...planApproval?.exceptPaths ?? []],
+    ...requiredChecks === void 0 ? {} : { requiredChecks }
+  };
+};
+var guardSchema = guardFields.transform(guardWithoutPlanApproval);
 var hintsSchema = z2.strictObject({
   /** Whether the `ask-hint` hook points out a last message that ends in a question while the turn used no `AskUserQuestion`; a lane session is never hinted. */
-  askUserQuestion: z2.boolean().default(true)
+  askUserQuestion: z2.boolean().default(true),
+  /** Whether the `task-hint` hook points a lane that edits a file without an open task signal to `jh task start`, once per task. */
+  taskSignal: z2.boolean().default(true)
 });
+var DEFAULT_TASK_SIGNAL_MINUTES = 10;
 var contextSchema = z2.strictObject({
   /** Tokens in a lane's context from which its fill shows yellow and `/implement` offers a new chat. */
   warnTokens: tokenCount.default(25e4),
@@ -517,6 +565,11 @@ var jackherdConfigSchema = z2.strictObject({
   }).prefault({}),
   models: z2.record(z2.enum(Object.values(MODEL_ROLE)), modelId),
   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({
+    /** Publish the draft as a private Artifact when the session has the tool; `false` sends a file card or `jh preview --open` instead. */
+    publish: z2.boolean().default(true)
+  }).prefault({}),
   plans: z2.strictObject({
     /** Minutes between background fetches of the base branch while `jh herd` runs; 0 turns them off. */
     fetchIntervalMinutes: z2.number().min(0).default(5),
@@ -533,6 +586,8 @@ var jackherdConfigSchema = z2.strictObject({
   /**
    * Read by `jh watch`; without `deploy` it reports no deploy runs. `feedback` is on unless set to `false`:
    * it reports new feedback on the lanes' pull requests except from the account the watcher runs as and `ignore`.
+   * `parallelTasks.maxTokens` caps the cost of the extra agents in a proposal of parallel tasks at the heartbeat.
+   * `taskSignalMinutes` is how long a lane works without a task signal before it reports `no task signal`, once per phase.
    * `checks` reads the failed tests of a red lane pull request (`failedTestPattern`), also with `feedback` off.
    * Without `previews` it reads no deploy preview; with it, one `preview` per new head commit. Each of `sources` is a
    * command whose JSON output reports `source` for a new or changed entry.
@@ -541,6 +596,8 @@ var jackherdConfigSchema = z2.strictObject({
     deploy: deploySchema.optional(),
     feedback: z2.union([z2.literal(false), feedbackSchema]).prefault({}),
     checks: checksSchema.prefault({}),
+    parallelTasks: parallelTasksSchema.prefault({}),
+    taskSignalMinutes: z2.number().int().positive().default(DEFAULT_TASK_SIGNAL_MINUTES),
     previews: previewsSchema.optional(),
     sources: z2.array(sourceSchema).refine(hasUniqueNames, "source names must be unique").default([])
   }).prefault({}),

package/dist/plan-format.d.ts

@@ -23,14 +23,20 @@ declare const ADDRESS_FORM: Record<PlanLanguage, Record<ResponseAddress, string>
  */
 declare const SELF_MERGE_LABEL: Record<PlanLanguage, string>;
 /**
- * The options of the question that approves a plan for all its lanes (``Plan `<path>` ``) and of the one that revokes
- * that approval. The merge guard hook lifts its question for a plain merge of such a lane only when the newest answer
- * to a question naming the plan is exactly `approve`, so the labels are fixed per language and not a config value.
+ * The standing approval: the option that approves (`approve`) and the word between the plan and the end in its
+ * question (``Plan `<path>` <until> <YYYY-MM-DD HH:MM>``). The merge guard hook lifts its question for a plain merge of
+ * that plan's lanes only when the newest answer to such a question is exactly `approve`, so both are fixed per
+ * language and not a config value.
  */
-declare const PLAN_APPROVAL_LABELS: Record<PlanLanguage, {
+declare const STANDING_APPROVAL_TEXTS: Record<PlanLanguage, {
     approve: string;
-    revoke: string;
+    until: string;
 }>;
+/**
+ * The words a lane prompt opens with, followed by the lane's name. The ask hint hook and the project's lane exception
+ * recognise a lane by them, so they are fixed per language and not a config value.
+ */
+declare const LANE_PROMPT_OPENING: Record<PlanLanguage, string>;
 /**
  * The words of an approval: the two option labels of the coordinator's question about a lane's call, which the
  * approval gate hook matches exactly and which follow the response language, and what the hook tells the lane when it
@@ -59,6 +65,22 @@ declare const APPOINTMENT_VOCABULARY: Record<PlanLanguage, {
     statusAlso: readonly string[];
     open: readonly string[];
 }>;
+/**
+ * The board section of what waits on the user's answer (a sent preview, an open question, a report to accept): its
+ * heading, the header names of its columns (since, item, origin, status, found by name in any order; the status
+ * column may also carry a name of `statusAlso`) and the lower-case words a status cell of a still open item starts with.
+ */
+declare const WAITING_VOCABULARY: Record<PlanLanguage, {
+    heading: string;
+    columns: {
+        since: string;
+        item: string;
+        origin: string;
+        status: string;
+    };
+    statusAlso: readonly string[];
+    open: readonly string[];
+}>;
 declare const isPlanLanguage: (value: string) => value is PlanLanguage;
 declare const PLAN_STATUS: {
     readonly done: "done";
@@ -348,7 +370,8 @@ declare const withoutRepeats: (lane: SprintLane, step: PlanStep) => PlanStep;
 /**
  * The lanes of the sprint document's lanes table (`## Spuren` in `de`) in table order. A row whose
  * first cell names a lane in backticks belongs to that lane; a `↳` row without a name continues
- * the lane above it.
+ * the lane above it. A cleaned-up lane stays closed through its `↳` rows, but a later row that names it again
+ * without the mark starts the lane anew: the closed rows are history and drop out.
  */
 declare const parseSprintLanes: (markdown: string, language: PlanLanguage) => SprintLane[];
 declare const sprintTitleOf: (markdown: string, fallback: string) => string;
@@ -483,6 +506,39 @@ declare const activeItem: (phase: Pick<PhaseProgress, "items">) => ChecklistItem
 /** The sidebar title of a lane, e.g. `P4 · 7/12` or `P4 · 12/12` while ticked and not merged; null when nothing of the lane could be counted. */
 declare const shortTitle: (progress: LaneProgress) => string | null;
 
+/** Characters a task's short name may have, so the herd shows it whole. */
+declare const SHORT_NAME_LIMIT = 40;
+/** Characters a phase title may have; the title is the phase's name. */
+declare const PHASE_TITLE_LIMIT = 50;
+declare const SHORT_NAME_PROBLEM: {
+    readonly missing: "missing";
+    readonly long: "long";
+};
+/** What is wrong with an open task's short name: none at all, or one of `length` characters over the limit. */
+type ShortNameProblem = {
+    problem: typeof SHORT_NAME_PROBLEM.missing;
+} | {
+    problem: typeof SHORT_NAME_PROBLEM.long;
+    length: number;
+};
+/** An open task (1-based line) of phase `phase` whose short name is missing or too long. */
+type ShortNameFinding = {
+    line: number;
+    phase: string;
+} & ShortNameProblem;
+/** A phase heading whose title has `length` characters, over the limit. */
+type LongPhaseTitle = PhaseHeading & {
+    length: number;
+};
+/**
+ * The open tasks a change wrote (a line not in `previousLines`) that do not start with `**Name**:` or whose name is
+ * longer than `SHORT_NAME_LIMIT`. Only tasks of a phase section before its review gate count: a gate item keeps its
+ * own form.
+ */
+declare const shortNameFindings: (markdown: string, language: PlanLanguage, previousLines: ReadonlySet<string>) => ShortNameFinding[];
+/** The phase headings a change wrote whose title is longer than `PHASE_TITLE_LIMIT`. */
+declare const longPhaseTitles: (markdown: string, language: PlanLanguage, previousLines: ReadonlySet<string>) => LongPhaseTitle[];
+
 /** What a sprint document says around its lanes table: its goal and its history. */
 type SprintPlanRow = {
     cells: string[];
@@ -512,4 +568,4 @@ declare const readSprintDocument: (markdown: string, language: PlanLanguage) =>
  */
 declare const readPhaseDependencies: (planMarkdown: string, language: PlanLanguage) => Record<string, string>;
 
-export { ADDRESS_FORM, APPOINTMENT_VOCABULARY, APPROVAL_TEXTS, type ChecklistItem, type ColumnModel, type DeferredItem, type DriftFinding, LANGUAGE_NAME, type LaneProgress, type MergedPhaseWithOpenBoxes, type MisplacedDeferral, PHASE_CELL_LIMIT, PHASE_ID_PREFIX, PLAN_APPROVAL_LABELS, PLAN_LANGUAGE, PLAN_STATUS, PLAN_VOCABULARY, PROSE_REASON, type PhaseDependency, type PhaseHeading, type PhaseProgress, type PhaseSchedule, type PhaseTally, type PhaseWithoutGate, type PhaseWithoutRow, type PlanHeader, type PlanLanguage, type PlanPhase, type PlanStatus, type PlanStep, type PlanVocabulary, type PlansByHref, type ProseReason, RESPONSE_ADDRESS, type ResponseAddress, type RowWithProse, type RowWithoutPhase, SELF_MERGE_LABEL, type SprintDocument, type SprintLane, type SprintPlanRow, type SprintPlanTable, type StatusWord, type StepProgress, activeItem, boardRowsWithProse, boardRowsWithoutPhase, classifyStatus, columnModels, countDecisions, criticalPath, currentPhase, currentPhaseOf, deferralTarget, differsFromColumn, endsPhase, findDrift, hasLanesTable, isCheckboxLine, isDocumentationGateItem, isOpenCheckboxLine, isPhaseFinished, isPhaseOpen, isPlanLanguage, isReviewGateLine, isTickedUnmerged, laneNameOf, laneProgress, mergedPhasesWithOpenBoxes, misplacedDeferrals, newPhasesWithoutReviewGate, onlyDocumentationOpen, parallelGroups, parallelGroupsOfPlan, parseDependencyTable, parsePlanPhases, parseSprintLanes, phaseHeading, phaseHeadingPattern, phaseHeadings, phaseIdsOfCell, phaseIdsOfPlan, phaseLabel, phaseLabels, phaseProgress, phaseWaves, phasesText, phasesWithoutDependencyRow, readPhaseDependencies, readPlanHeader, readSprintDocument, resolvePlanPath, sectionHeading, shortTitle, sprintTitleOf, sumPhases, tallyPhases, wavesOfPlan, withoutRepeats };
+export { ADDRESS_FORM, APPOINTMENT_VOCABULARY, APPROVAL_TEXTS, type ChecklistItem, type ColumnModel, type DeferredItem, type DriftFinding, LANE_PROMPT_OPENING, LANGUAGE_NAME, type LaneProgress, type LongPhaseTitle, type MergedPhaseWithOpenBoxes, type MisplacedDeferral, PHASE_CELL_LIMIT, PHASE_ID_PREFIX, PHASE_TITLE_LIMIT, PLAN_LANGUAGE, PLAN_STATUS, PLAN_VOCABULARY, PROSE_REASON, type PhaseDependency, type PhaseHeading, type PhaseProgress, type PhaseSchedule, type PhaseTally, type PhaseWithoutGate, type PhaseWithoutRow, type PlanHeader, type PlanLanguage, type PlanPhase, type PlanStatus, type PlanStep, type PlanVocabulary, type PlansByHref, type ProseReason, RESPONSE_ADDRESS, type ResponseAddress, type RowWithProse, type RowWithoutPhase, SELF_MERGE_LABEL, SHORT_NAME_LIMIT, SHORT_NAME_PROBLEM, STANDING_APPROVAL_TEXTS, type ShortNameFinding, type ShortNameProblem, type SprintDocument, type SprintLane, type SprintPlanRow, type SprintPlanTable, type StatusWord, type StepProgress, WAITING_VOCABULARY, activeItem, boardRowsWithProse, boardRowsWithoutPhase, classifyStatus, columnModels, countDecisions, criticalPath, currentPhase, currentPhaseOf, deferralTarget, differsFromColumn, endsPhase, findDrift, hasLanesTable, isCheckboxLine, isDocumentationGateItem, isOpenCheckboxLine, isPhaseFinished, isPhaseOpen, isPlanLanguage, isReviewGateLine, isTickedUnmerged, laneNameOf, laneProgress, longPhaseTitles, mergedPhasesWithOpenBoxes, misplacedDeferrals, newPhasesWithoutReviewGate, onlyDocumentationOpen, parallelGroups, parallelGroupsOfPlan, parseDependencyTable, parsePlanPhases, parseSprintLanes, phaseHeading, phaseHeadingPattern, phaseHeadings, phaseIdsOfCell, phaseIdsOfPlan, phaseLabel, phaseLabels, phaseProgress, phaseWaves, phasesText, phasesWithoutDependencyRow, readPhaseDependencies, readPlanHeader, readSprintDocument, resolvePlanPath, sectionHeading, shortNameFindings, shortTitle, sprintTitleOf, sumPhases, tallyPhases, wavesOfPlan, withoutRepeats };

package/dist/plan-format.js

@@ -2,18 +2,20 @@ import {
   ADDRESS_FORM,
   APPOINTMENT_VOCABULARY,
   APPROVAL_TEXTS,
+  LANE_PROMPT_OPENING,
   LANGUAGE_NAME,
-  PLAN_APPROVAL_LABELS,
   PLAN_LANGUAGE,
   PLAN_STATUS,
   PLAN_VOCABULARY,
   RESPONSE_ADDRESS,
   SELF_MERGE_LABEL,
+  STANDING_APPROVAL_TEXTS,
+  WAITING_VOCABULARY,
   classifyStatus,
   isPlanLanguage,
   phaseHeading,
   sectionHeading
-} from "./chunk-OU2KALXP.js";
+} from "./chunk-5MQBCUQ5.js";
 
 // src/plan-format/lanes.ts
 import { posix } from "path";
@@ -100,6 +102,8 @@ var CONTINUATION = "\u21B3";
 var PLAN_LINK = /\[([^\]]+)\]\(([^)]+)\)/;
 var PHASE_ID_PREFIX = "P";
 var phaseLabel = (id) => `${PHASE_ID_PREFIX}${id}`;
+var MAX_RANGE = 50;
+var spannedPhaseIds = (first, last) => first > last || last - first >= MAX_RANGE ? [] : Array.from({ length: last - first + 1 }, (_, offset) => String(first + offset));
 var phaseLabels = (ids, separator) => ids.map(phaseLabel).join(separator);
 var PHASES_COLUMN = 3;
 var CLAUSE_SEPARATOR = /([;,]|\.(?=\s))\s*/;
@@ -109,10 +113,18 @@ var phaseIdPatterns = (language) => {
   const id = `(?:\\*\\*)?${PHASE_ID_PREFIX}(\\d+[a-z]?)\\b`;
   return {
     leading: new RegExp(`^\\s*(?:(?:${connectors})\\s+)*${id}`),
+    rangeEnd: new RegExp(`^\\s*[\u2013-]\\s*(?:\\*\\*)?${PHASE_ID_PREFIX}(\\d+)\\b`),
     afterConnector: new RegExp(`^\\s*(?:${connectors})\\s`),
     connector: new RegExp(`\\b(?:${connectors})\\s+${id}`, "g")
   };
 };
+var leadingIds = (clause, leading, patterns) => {
+  const first = leading[1];
+  const end = clause.slice(leading[0].length).match(patterns.rangeEnd);
+  if (!end || !/^\d+$/.test(first)) return [first];
+  const spanned = spannedPhaseIds(Number(first), Number(end[1]));
+  return spanned.length > 0 ? spanned : [first];
+};
 var phaseIdsOf = (cell, patterns) => {
   const parts = cell.split(CLAUSE_SEPARATOR);
   const ids = [];
@@ -125,7 +137,7 @@ var phaseIdsOf = (cell, patterns) => {
     const leading = clause.match(patterns.leading);
     const startsEntry = entryStart || listRunning || patterns.afterConnector.test(clause);
     const counts = leading !== null && startsEntry;
-    if (leading && counts) ids.push(leading[1]);
+    if (leading && counts) ids.push(...leadingIds(clause, leading, patterns));
     ids.push(...[...clause.matchAll(patterns.connector)].map((match) => match[1]));
     listRunning ||= counts;
   }
@@ -162,7 +174,12 @@ var parseSprintLanes = (markdown, language) => {
     if (!name) continue;
     const port = Number.parseInt(cells[1] ?? "", 10);
     const lane = lanes.get(name) ?? { name, port: Number.isNaN(port) ? null : port, steps: [], closed: false };
-    lane.closed ||= (cells[0] ?? "").includes(laneClosed);
+    const marked = (cells[0] ?? "").includes(laneClosed);
+    if (lane.closed && !marked && !(cells[0] ?? "").startsWith(CONTINUATION)) {
+      lane.closed = false;
+      lane.steps = [];
+    }
+    lane.closed ||= marked;
     lane.steps.push(withoutRepeats(lane, toStep(cells, phaseId)));
     lanes.set(name, lane);
     previous = name;
@@ -451,7 +468,6 @@ var GLOB_CHARACTER = /[*?{[]/;
 var VERSION = /^v?\d+(?:[.\-+][\w.-]*)?$/i;
 var PACKAGE_SCOPE = /^@[^/]+\//;
 var RELEASE_FILE = /(?:^|\/)(?:CHANGELOG\.md|package\.json)$/;
-var MAX_RANGE = 50;
 var phaseIdOf = (cell) => PHASE_ID.exec(cell)?.[1]?.toLowerCase() ?? null;
 var splitOutsideParentheses = (cell, separator) => {
   const entries = [];
@@ -470,9 +486,7 @@ var splitOutsideParentheses = (cell, separator) => {
 var rangeOf = (entry) => {
   const match = PHASE_RANGE.exec(entry);
   if (!match) return null;
-  const [first, last] = [Number(match[1]), Number(match[2])];
-  if (first > last || last - first >= MAX_RANGE) return [];
-  return Array.from({ length: last - first + 1 }, (_, offset) => String(first + offset));
+  return spannedPhaseIds(Number(match[1]), Number(match[2]));
 };
 var dependsOf = (cell, language) => {
   const noDependency = PLAN_VOCABULARY[language].noDependency;
@@ -560,12 +574,13 @@ var phasesWithoutDependencyRow = (markdown, language) => {
 };
 var longestChain = (chains) => chains.reduce((longest, chain) => chain.length > longest.length ? chain : longest, []);
 var mergeSets = (sets) => sets.some((set) => set === null) ? null : sets.flatMap((set) => set ?? []);
-var writeSetOf = (row, byId, chain) => {
+var writeSetWithin = (row, byId, chain) => {
   if (chain.includes(row.id)) return null;
   const targets = row.writesLike.map((id) => byId.get(id));
-  const like = mergeSets(targets.map((target) => target ? writeSetOf(target, byId, [...chain, row.id]) : null));
+  const like = mergeSets(targets.map((target) => target ? writeSetWithin(target, byId, [...chain, row.id]) : null));
   return like === null ? null : [...row.writes, ...like];
 };
+var writeSetOf = (row, byId) => writeSetWithin(row, byId, []);
 var overlaps = (left, right) => left === "" || right === "" || left === right || left.startsWith(`${right}/`) || right.startsWith(`${left}/`);
 var sharesEntry = (first, second) => {
   const entries = new Set(second.map((entry) => entry.trim().toLowerCase()));
@@ -574,7 +589,7 @@ var sharesEntry = (first, second) => {
 var sharesMarker = (first, second) => sharesEntry(first.serialMarkers, second.serialMarkers) || sharesEntry(first.releases, second.releases);
 var collides = (first, second) => sharesMarker(first, second) || first.writes.some((path) => second.writes.some((other) => overlaps(path, other)));
 var candidateOf = (row, byId) => {
-  const writes = writeSetOf(row, byId, []);
+  const writes = writeSetOf(row, byId);
   if (writes === null || writes.length === 0) return [];
   const releases = [.../* @__PURE__ */ new Set([...row.releases, ...releasedByFiles(writes)])];
   return [{ id: row.id, writes, serialMarkers: row.serialMarkers, releases }];
@@ -811,6 +826,38 @@ var boardRowsWithoutPhase = (markdown, language, previousLines) => changedOpenLa
   ({ phases }) => phaseIdsOfCell(phases, language).length === 0
 );
 
+// src/plan-format/short-names.ts
+var SHORT_NAME_LIMIT = 40;
+var PHASE_TITLE_LIMIT = 50;
+var SHORT_NAME_PROBLEM = { missing: "missing", long: "long" };
+var SHORT_NAME = /^\s*[-*]\s+\[ \]\s+\*\*(.+?)\*\*:/;
+var characterCount = (text) => [...text].length;
+var shortNameProblem = (line) => {
+  const name = line.match(SHORT_NAME)?.[1];
+  if (name === void 0) return { problem: SHORT_NAME_PROBLEM.missing };
+  const length = characterCount(name);
+  return length > SHORT_NAME_LIMIT ? { problem: SHORT_NAME_PROBLEM.long, length } : null;
+};
+var shortNameFindings = (markdown, language, previousLines) => {
+  const headings = new Map(phaseHeadings(markdown, language).map((heading) => [heading.line, heading.id]));
+  const found = [];
+  let phase = null;
+  for (const [index, line] of markdown.split("\n").entries()) {
+    const heading = headings.get(index + 1);
+    if (heading !== void 0) phase = heading;
+    else if (endsPhase(line) || isReviewGateLine(line)) phase = null;
+    else if (phase !== null && isOpenCheckboxLine(line) && !previousLines.has(line)) {
+      const problem = shortNameProblem(line);
+      if (problem) found.push({ line: index + 1, phase, ...problem });
+    }
+  }
+  return found;
+};
+var longPhaseTitles = (markdown, language, previousLines) => {
+  const lines = markdown.split("\n");
+  return phaseHeadings(markdown, language).filter(({ line }) => !previousLines.has(lines[line - 1] ?? "")).map((heading) => ({ ...heading, length: characterCount(heading.title) })).filter(({ length }) => length > PHASE_TITLE_LIMIT);
+};
+
 // src/plan-format/sprint-document.ts
 var PHASE_ID_IN_CELL = /^(\d+[a-z]?)\b/;
 var paragraphs = (lines) => lines.join("\n").split(/\n\s*\n/).map((paragraph) => paragraph.trim()).filter(Boolean);
@@ -853,16 +900,21 @@ export {
   ADDRESS_FORM,
   APPOINTMENT_VOCABULARY,
   APPROVAL_TEXTS,
+  LANE_PROMPT_OPENING,
   LANGUAGE_NAME,
   PHASE_CELL_LIMIT,
   PHASE_ID_PREFIX,
-  PLAN_APPROVAL_LABELS,
+  PHASE_TITLE_LIMIT,
   PLAN_LANGUAGE,
   PLAN_STATUS,
   PLAN_VOCABULARY,
   PROSE_REASON,
   RESPONSE_ADDRESS,
   SELF_MERGE_LABEL,
+  SHORT_NAME_LIMIT,
+  SHORT_NAME_PROBLEM,
+  STANDING_APPROVAL_TEXTS,
+  WAITING_VOCABULARY,
   activeItem,
   boardRowsWithProse,
   boardRowsWithoutPhase,
@@ -887,6 +939,7 @@ export {
   isTickedUnmerged,
   laneNameOf,
   laneProgress,
+  longPhaseTitles,
   mergedPhasesWithOpenBoxes,
   misplacedDeferrals,
   newPhasesWithoutReviewGate,
@@ -912,6 +965,7 @@ export {
   readSprintDocument,
   resolvePlanPath,
   sectionHeading,
+  shortNameFindings,
   shortTitle,
   sprintTitleOf,
   sumPhases,