jackherd 1.23.3 → 1.24.0

package/src/watch/command.ts

@@ -32,6 +32,14 @@ import { existsSync, readFileSync } from 'node:fs'
 import { homedir } from 'node:os'
 import { basename, dirname, join, relative } from 'node:path'
 import { writePrivateFile } from '../../kit/hooks/hooks/shared/private-directory'
+import {
+  type BackendWatch,
+  backendCheckOf,
+  INITIAL_BACKEND_WATCH,
+  keepBackend,
+  type MainCheckoutBackend,
+  mainCheckoutBackendOf,
+} from '../backend/watch'
 import { sourcesWithPersonal } from '../config/personal-sources'
 import { readConfig, readResolvedConfig } from '../config/read-config'
 import { readRepositoryIdentity } from '../config/repository-identity'
@@ -200,6 +208,7 @@ import { recordedReadsOf } from './recorded-reads'
 import {
   annotateEach,
   annotateFirstLine,
+  BACKEND_REFERENCE,
   eventReference,
   laneSetEventLines,
   REFERENCE,
@@ -295,6 +304,8 @@ type Watch = {
   selfMergeMinutes: number
   /** Runs inside herdr with the herdr adapter, so missing herd panes can be brought back. */
   herdr: boolean
+  /** `lanes.backend` and the worktree directory of the main checkout's config; undefined without one, then the backend is never touched. */
+  backend: MainCheckoutBackend | undefined
 }
 
 /** The coordinator's agent name (null when none is found), its last read (null before the first one) and the tokens of that read (null without a value). */
@@ -372,6 +383,8 @@ type Watching = {
   /** The questions of each watched lane's report at the last poll (`questionsFingerprint`); null before the first read, so the stored ones stay. */
   reportQuestions: Record<string, string> | null
   planViews: PlanViews
+  /** When the backend pane was last checked and whether a failure of it was already said. */
+  backend: BackendWatch
 }
 
 /** What the duty lines of one return are made of. */
@@ -1134,6 +1147,16 @@ const keepViews = (watch: Watch, watching: Watching, trigger: EnsureTrigger) =>
   })
 }
 
+/** Keeps the shared backend pane once it is due (`BACKEND_CHECK_MS`); only inside herdr and only with `lanes.backend`. */
+const keepBackendPane = async (watch: Watch, watching: Watching) => {
+  if (!watch.herdr || !watch.backend) return
+  watching.backend = await keepBackend(watching.backend, Date.now(), {
+    check: backendCheckOf(watch.root, watch.backend),
+    log: console.log,
+    hint: hintFor(watch, BACKEND_REFERENCE),
+  })
+}
+
 /** Takes up lanes that were found or dropped since the last poll and returns the lanes it added; named lanes never change. */
 const followLaneSet = (watch: Watch, watching: Watching): string[] => {
   if (watch.options.lanes !== null) return []
@@ -1570,6 +1593,7 @@ const initialWatching = (
   appointments: null,
   reportQuestions: null,
   planViews: { failureReported: false },
+  backend: INITIAL_BACKEND_WATCH,
 })
 
 /** Saves the state a stop leaves behind: the one from before an unfinished report or an unread GitHub answer, else the latest. */
@@ -1593,6 +1617,7 @@ const watchLanes = async (watch: Watch): Promise<boolean> => {
 
   const watching = initialWatching(watch, { lanes, sprintLanes, state: { ...state, armed: arm.state }, armed, agents })
   keepViews(watch, watching, { kind: ENSURE_TRIGGER.start })
+  await keepBackendPane(watch, watching)
   const resumeRecord = keepRecord(
     { root: watch.root, board: watch.sprintFile, coordinator: coordinatorNameFor(watch, agents), pid: process.pid },
     Date.now(),
@@ -1638,6 +1663,7 @@ const watchLanes = async (watch: Watch): Promise<boolean> => {
     while (await pollOnce(watch, watching)) {
       await Bun.sleep(POLL_MS)
       pollLanes(watch, watching)
+      await keepBackendPane(watch, watching)
       resumeRecord.follow(watching.current, Date.now(), observed())
       await announceUpdate?.()
       if (endedByKitUpdate(kit, effects)) return true
@@ -1710,6 +1736,7 @@ const watchOf = (options: WatchOptions): Watch => {
     stageTools: stageToolsOf(config.guard.approvals.standing),
     selfMergeMinutes: config.guard.selfMerge.approvalMinutes,
     herdr: insideHerdr(settings.adapter, process.env),
+    backend: mainCheckoutBackendOf(root, checkoutRoot, config),
   }
 }
 

package/src/watch/reference-paths.ts

@@ -24,10 +24,14 @@ export const REFERENCE = {
   watchWithoutMonitor: 'references/watch-without-monitor.md',
   adoptPlan: 'references/adopt-plan.md',
   waiting: 'references/waiting.md',
+  backend: 'references/backend.md',
 } as const
 
 export type Reference = (typeof REFERENCE)[keyof typeof REFERENCE]
 
+/** Where the coordinator reads what a `backend:` line of the watcher asks for: the shared backend. */
+export const BACKEND_REFERENCE: Reference = REFERENCE.backend
+
 /** A copy of the orchestrate skill: the directory as the session reads it, and where that is on disk. */
 export type SkillCopy = { shown: string; path: string }