jackherd 1.13.0 → 1.14.0

package/src/watch/reference-paths.ts

@@ -37,6 +37,7 @@ const EVENT_REFERENCES: Readonly<Record<string, Reference>> = {
   [WATCH_EVENT.taskParallel]: REFERENCE.events,
   [WATCH_EVENT.noTaskSignal]: REFERENCE.events,
   [WATCH_EVENT.unlinkedArtifact]: REFERENCE.events,
+  [WATCH_EVENT.planMissing]: REFERENCE.events,
   [UPDATE_AVAILABLE_EVENT]: REFERENCE.events,
   [WATCH_EVENT.laneModel]: REFERENCE.laneSession,
 }

package/src/watch/texts.ts

@@ -28,6 +28,8 @@ export type WatchTexts = {
   parallelDuty: (phases: string) => string
   /** What a lane that works without a task signal asks of the coordinator. */
   noTaskSignalDuty: string
+  /** What a lane whose plan the base ref lacks asks of the coordinator. */
+  planMissingDuty: string
   /** What a lane's call waiting for approval asks of the coordinator, with the mark (request id and call hash) the question must carry. */
   approvalDuty: (id: string, hash: string) => string
   /** The standing duty while the main checkout is behind its base branch on the remote (`origin/main`), with the count of commits. */
@@ -70,6 +72,8 @@ export const watchTexts = (dialogLanguage: PlanLanguage): WatchTexts => ({
   parallelDuty: (phases) =>
     `${phases} can run in parallel: propose it to the user, check content and release files yourself (the table covers paths and markers only)`,
   noTaskSignalDuty: 'remind the lane to report its task with jh task start; do not stop it',
+  planMissingDuty:
+    "the herd shows the base ref's plan, not this one: run § 2 step 0 for it, copying from the lane's worktree",
   laneModelDuty:
     'switch it while idle: /exit, then claude --resume <session> --model <id> in the same pane (§ 2 step 6)',
   mainCheckoutBehind: (remoteBase, count) =>

package/src/watch/watch-events.ts

@@ -16,6 +16,7 @@ import { isLaneModels, LANE_MODEL_EVENT, type LaneModelEvent, type LaneModels }
 import { isLaneParallels, LANE_PARALLEL_EVENT, type LaneParallelEvent, type LaneParallels } from './lane-parallel'
 import { isStallState, LANE_STALLED_EVENT, type LaneStalledEvent, type StallState } from './lane-stalled'
 import { type LaneSnapshot, type SeenSeqs, seenSeqsOf } from './lane-watch'
+import { isPlanMissingState, PLAN_MISSING_EVENT, type PlanMissingEvent, type PlanMissingState } from './plan-missing'
 import { emptyPreviewState, isPreviewState, PREVIEW_EVENT, type PreviewEvent, type PreviewState } from './previews'
 import { PULL_REQUEST_STATE, type WatchedPullRequest } from './pull-requests'
 import { emptySourceState, isSourceState, SOURCE_EVENT, type SourceEvent, type SourceState } from './sources'
@@ -60,6 +61,7 @@ export const WATCH_EVENT = {
   noTaskSignal: NO_TASK_SIGNAL_EVENT,
   laneStalled: LANE_STALLED_EVENT,
   unlinkedArtifact: UNLINKED_ARTIFACT_EVENT,
+  planMissing: PLAN_MISSING_EVENT,
   approval: APPROVAL_EVENT,
   source: SOURCE_EVENT,
   due: APPOINTMENT_EVENT.due,
@@ -122,6 +124,8 @@ export type WatchState = {
   laneStalls: StallState
   /** Per open artifact send no plan or board links: in its grace or already reported as `unlinked artifact`. */
   unlinkedArtifacts: UnlinkedState
+  /** Per working lane whose board row links a plan the base ref lacks: the plan last reported as `plan missing on base`. */
+  planMissing: PlanMissingState
   /** The ids of the approval requests on disk when they were last read, each reported once while it is open. */
   approvals: string[]
   /** Per configured source of `watch.sources`: the entries seen (`[id, fingerprint]`) and the start of a failure streak. */
@@ -185,6 +189,7 @@ export type WatchEvent =
   | NoTaskSignalEvent
   | LaneStalledEvent
   | UnlinkedArtifactEvent
+  | PlanMissingEvent
   | ApprovalEvent
   | SourceEvent
   | AppointmentEvent
@@ -224,6 +229,7 @@ export const emptyWatchState = (): WatchState => ({
   noTaskSignals: {},
   laneStalls: {},
   unlinkedArtifacts: {},
+  planMissing: {},
   approvals: [],
   sources: emptySourceState(),
   reportMtimes: {},
@@ -277,6 +283,7 @@ const isWatchState = (value: Record<string, unknown>): value is WatchState =>
   isNoSignalState(value.noTaskSignals) &&
   isStallState(value.laneStalls) &&
   isUnlinkedState(value.unlinkedArtifacts) &&
+  isPlanMissingState(value.planMissing) &&
   Array.isArray(value.approvals) &&
   value.approvals.every((id) => typeof id === 'string') &&
   isSourceState(value.sources) &&