jackherd 1.9.0 → 1.11.0

package/dist/config.js

@@ -1,7 +1,7 @@
 import {
   PLAN_LANGUAGE,
   RESPONSE_ADDRESS
-} from "./chunk-MCP4XJQH.js";
+} from "./chunk-RMMXD4G5.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)
 });
@@ -158,7 +164,8 @@ var SOURCE_FIELD = {
   url: "url",
   body: "body",
   author: "author",
-  status: "status"
+  status: "status",
+  count: "count"
 };
 var CONTENT_FIELDS = [SOURCE_FIELD.title, SOURCE_FIELD.author, SOURCE_FIELD.body, SOURCE_FIELD.url];
 
@@ -182,11 +189,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 {
@@ -256,6 +275,25 @@ import { isAbsolute } from "path";
 var segmentsOf = (path) => path.split(/[\\/]/).filter((segment) => segment !== "" && segment !== ".");
 var isRepositoryDirectory = (value) => !isAbsolute(value) && segmentsOf(value).length > 0 && !segmentsOf(value).includes("..");
 
+// src/config/tones.ts
+var TONE = {
+  amber: "amber",
+  teal: "teal",
+  grey: "grey",
+  red: "red",
+  green: "green",
+  blue: "blue",
+  magenta: "magenta"
+};
+var TONE_NAMES = Object.values(TONE);
+var TONE_ROLE = { waiting: "waiting", new: "new", running: "running", resting: "resting" };
+var DEFAULT_TONES = {
+  [TONE_ROLE.waiting]: TONE.amber,
+  [TONE_ROLE.new]: TONE.amber,
+  [TONE_ROLE.running]: TONE.teal,
+  [TONE_ROLE.resting]: TONE.grey
+};
+
 // src/config/schema.ts
 var TERMINAL_ADAPTER = { none: "none", herdr: "herdr" };
 var MODEL_ROLE = {
@@ -320,7 +358,17 @@ var parallelTasksSchema = z2.strictObject({
    * 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)
+  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({
   /**
@@ -359,11 +407,14 @@ var sourceMapSchema = z2.object({
   [SOURCE_FIELD.body]: sourcePath.optional(),
   [SOURCE_FIELD.author]: sourcePath.optional(),
   /** A ticket source's status, shown on its badge in the herd; also a field `reportOn` can name. */
-  [SOURCE_FIELD.status]: sourcePath.optional()
+  [SOURCE_FIELD.status]: sourcePath.optional(),
+  /** How often the entry happened (an error count), shown as `113×` beside the entry in the herd's `Sources` block. */
+  [SOURCE_FIELD.count]: sourcePath.optional()
 }).catchall(sourcePath).refine((map) => Object.keys(map).every((field) => SOURCE_FIELD_NAME.test(field)), {
   message: "a map field is a letter, then letters, digits and `_`"
 });
 var canChange = ({ map, reportOn }) => map.updatedAt !== void 0 || CONTENT_FIELDS.some((field) => map[field] !== void 0) || reportOn !== void 0;
+var toneName = z2.enum(TONE_NAMES);
 var sourceSchema = z2.strictObject({
   /** Printed in every report of the source and the key of its saved state. */
   name: z2.string().regex(/^[A-Za-z0-9][\w.-]*$/, "letters, digits, `_`, `.` and `-`"),
@@ -378,6 +429,8 @@ var sourceSchema = z2.strictObject({
   ignoreAuthors: z2.array(z2.string().min(1)).default([]),
   /** The most new or changed entries one report shows of this source; the rest is one line `+<n> more`. */
   reportLimit: z2.number().int().min(1).default(5),
+  /** Shown before a row of "Waiting for you" that came from this source (`Error log · Checkout: …`); without it the source's name. */
+  label: z2.string().min(1).max(40).regex(/^[^\r\n]+$/, "one line").optional(),
   /** The lane the source's reports name. */
   lane: z2.string().min(1).optional(),
   /**
@@ -385,6 +438,8 @@ var sourceSchema = z2.strictObject({
    * the lane above or the lane whose board row or plan names its id.
    */
   ticket: z2.boolean().optional(),
+  /** The tone of the source's mark in the herd's `Sources` block while its newest report is new; without it the tone of the role `new`. */
+  tone: toneName.optional(),
   /**
    * The mapped fields whose change reports, with the old and the new value, in place of the content of `title`,
    * `author`, `body` and `url`; without it a change of that content reports.
@@ -434,13 +489,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),
@@ -451,27 +506,44 @@ 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 tonesSchema = z2.strictObject({
+  waiting: toneName.default(DEFAULT_TONES.waiting),
+  new: toneName.default(DEFAULT_TONES.new),
+  running: toneName.default(DEFAULT_TONES.running),
+  resting: toneName.default(DEFAULT_TONES.resting)
 });
 var contextSchema = z2.strictObject({
   /** Tokens in a lane's context from which its fill shows yellow and `/implement` offers a new chat. */
@@ -542,12 +614,15 @@ var jackherdConfigSchema = z2.strictObject({
         icon: z2.string().min(1)
       })
     ).default(DEFAULT_LINK_KINDS.map((kind) => ({ ...kind }))),
-    context: contextSchema.prefault({})
+    context: contextSchema.prefault({}),
+    /** The colour of each role in the herd, by name: what waits for you, what is new, what runs, what rests. */
+    tones: tonesSchema.prefault({})
   }).prefault({}),
   /**
    * 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.
@@ -557,6 +632,7 @@ var jackherdConfigSchema = z2.strictObject({
     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
@@ -58,6 +64,12 @@ declare const APPOINTMENT_VOCABULARY: Record<PlanLanguage, {
     /** Further header names that count as the status column. */
     statusAlso: readonly string[];
     open: readonly string[];
+    /** The lower-case word an action starts with when it is the weekly board grooming, which the herd's header counts from. */
+    grooming: string;
+}>;
+/** The heading of the board section of what the coordinator does next, a numbered list of at most three lines. */
+declare const NEXT_VOCABULARY: Record<PlanLanguage, {
+    heading: string;
 }>;
 /**
  * The board section of what waits on the user's answer (a sent preview, an open question, a report to accept): its
@@ -500,6 +512,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[];
@@ -529,4 +574,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, 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, 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, NEXT_VOCABULARY, 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,19 +2,21 @@ import {
   ADDRESS_FORM,
   APPOINTMENT_VOCABULARY,
   APPROVAL_TEXTS,
+  LANE_PROMPT_OPENING,
   LANGUAGE_NAME,
-  PLAN_APPROVAL_LABELS,
+  NEXT_VOCABULARY,
   PLAN_LANGUAGE,
   PLAN_STATUS,
   PLAN_VOCABULARY,
   RESPONSE_ADDRESS,
   SELF_MERGE_LABEL,
+  STANDING_APPROVAL_TEXTS,
   WAITING_VOCABULARY,
   classifyStatus,
   isPlanLanguage,
   phaseHeading,
   sectionHeading
-} from "./chunk-MCP4XJQH.js";
+} from "./chunk-RMMXD4G5.js";
 
 // src/plan-format/lanes.ts
 import { posix } from "path";
@@ -498,7 +500,7 @@ var dependsOf = (cell, language) => {
   return { after, external };
 };
 var pathOf = (entry) => {
-  if (/\s/.test(entry)) return null;
+  if (/\s/.test(entry) || entry.includes("[]")) return null;
   const glob = entry.search(GLOB_CHARACTER);
   const literal = glob === -1 ? entry : entry.slice(0, Math.max(entry.lastIndexOf("/", glob), 0));
   const path = literal.replace(/^\.\//, "").replace(/\/+$/, "");
@@ -573,12 +575,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()));
@@ -587,7 +590,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 }];
@@ -824,6 +827,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);
@@ -866,16 +901,21 @@ export {
   ADDRESS_FORM,
   APPOINTMENT_VOCABULARY,
   APPROVAL_TEXTS,
+  LANE_PROMPT_OPENING,
   LANGUAGE_NAME,
+  NEXT_VOCABULARY,
   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,
@@ -901,6 +941,7 @@ export {
   isTickedUnmerged,
   laneNameOf,
   laneProgress,
+  longPhaseTitles,
   mergedPhasesWithOpenBoxes,
   misplacedDeferrals,
   newPhasesWithoutReviewGate,
@@ -926,6 +967,7 @@ export {
   readSprintDocument,
   resolvePlanPath,
   sectionHeading,
+  shortNameFindings,
   shortTitle,
   sprintTitleOf,
   sumPhases,