@joshuafolkken/kit 1.3041.0 → 1.3044.0

package/dist/hooks/session-lang.js

@@ -1054,7 +1054,7 @@ var session_handoff_line = {
 
 // scripts/josh/session-language-cli.ts
 var { DEFAULT_SESSION_LANG, ENV_KEY, resolve_session_lang } = session_language;
-var BOARD_LINE = "A backlogrun is live here: answer a progress question with `pnpm josh run:board --chat`, verbatim in one code block.";
+var BOARD_LINE = "Live backlogrun: for progress-only questions, run `pnpm josh run:board --chat`; relay output verbatim in one code block. For cause or improvement questions, investigate state, logs and code; cite evidence and uncertainty, even with quoted board lines. For mixed questions, do both.";
 var LIVE_PORTS = {
   repository_directory: run_carry.repository_directory,
   is_running: backlogrun_launch.is_running

package/dist/inputs.json

@@ -1,5 +1,5 @@
 {
-	"digest": "60c2b9f0c2baacd3d6c642dfad0127f41a20b289e51feb0de47def5d0dd1fae0",
+	"digest": "eda527eb5ac4613c8f26ec5b3ee11d167fbb152a7cc10d250d57365c9ce5e46e",
 	"inputs": [
 		"scripts/build/build-hooks.ts",
 		"scripts/build/build-bin.ts",
@@ -38,20 +38,20 @@
 		"scripts/josh/command-usage.ts",
 		"scripts/josh/josh-gh-usage.ts",
 		"scripts/josh/josh-logic.ts",
-		"scripts/issue/issue-number-shape.ts",
-		"scripts/gh/gh-core-rate-limit.ts",
-		"scripts/gh/gh-request-tally.ts",
-		"scripts/gh/gh-usage-event.ts",
-		"scripts/gh/git-gh-exec.ts",
 		"scripts/josh/josh-command-map.ts",
 		"scripts/josh/josh-aliases.ts",
 		"scripts/version/kit-descriptor.ts",
-		"scripts/josh/run-github-prerequisite.ts",
+		"scripts/issue/issue-number-shape.ts",
+		"scripts/lib/package-manifest.ts",
 		"scripts/git/git-spawn-sync.ts",
 		"scripts/lib/json-value.ts",
-		"scripts/lib/package-manifest.ts",
 		"scripts/lib/read-file.ts",
 		"scripts/lib/timeouts.ts",
+		"scripts/gh/gh-core-rate-limit.ts",
+		"scripts/gh/gh-request-tally.ts",
+		"scripts/gh/gh-usage-event.ts",
+		"scripts/gh/git-gh-exec.ts",
+		"scripts/josh/run-github-prerequisite.ts",
 		"scripts/build/local-bin.ts",
 		"scripts/gate/core-budget.ts",
 		"scripts/hooks/hook-lap.ts",
@@ -63,19 +63,13 @@
 		"scripts/josh/josh-in-process.ts",
 		"scripts/josh/kit-only.ts",
 		"scripts/josh/package-directory.ts",
+		"scripts/josh/josh-commands-workflow.ts",
+		"scripts/lib/ancestor-directories.ts",
+		"scripts/git/git-location-environment.ts",
 		"scripts/gh/gh-usage-log.ts",
-		"scripts/lib/error-message.ts",
-		"scripts/run/carry/run-carry.ts",
 		"scripts/gh/git-gh-spawn-width.ts",
-		"scripts/lib/token-shape.ts",
-		"scripts/gh/gh-call-kind.ts",
-		"scripts/lib/bounded-pool.ts",
-		"scripts/josh/agent-session-environment.ts",
-		"scripts/gh/git-gh-check.ts",
-		"scripts/git/git-execa-error.ts",
-		"scripts/gh/git-gh-retry.ts",
-		"scripts/gh/git-gh-failure.ts",
-		"scripts/josh/josh-commands-workflow.ts",
+		"scripts/discovery/repo-origin.ts",
+		"scripts/lib/pnpm-reach.ts",
 		"scripts/josh/josh-commands-ai.ts",
 		"scripts/josh/josh-commands-clone.ts",
 		"scripts/josh/josh-commands-development.ts",
@@ -84,12 +78,20 @@
 		"scripts/josh/josh-commands-maintenance.ts",
 		"scripts/josh/josh-commands-project.ts",
 		"scripts/josh/josh-commands-versioning.ts",
-		"scripts/run/ship/run-ship-lap.ts",
-		"scripts/lib/ancestor-directories.ts",
-		"scripts/lib/pnpm-reach.ts",
-		"scripts/git/git-location-environment.ts",
 		"scripts/git/constants.ts",
-		"scripts/discovery/repo-origin.ts",
+		"scripts/lib/error-message.ts",
+		"scripts/run/carry/run-carry.ts",
+		"scripts/git/git-execa-error.ts",
+		"scripts/josh/agent-session-environment.ts",
+		"scripts/lib/bounded-pool.ts",
+		"scripts/lib/token-shape.ts",
+		"scripts/gh/gh-call-kind.ts",
+		"scripts/gh/git-gh-check.ts",
+		"scripts/gh/git-gh-failure.ts",
+		"scripts/gh/git-gh-retry.ts",
+		"scripts/run/ship/run-ship-lap.ts",
+		"scripts/josh/josh-command-types.ts",
+		"ports/index.js",
 		"scripts/gate/machine-capacity.ts",
 		"scripts/josh/platform-temporary.ts",
 		"scripts/josh/process-identity.ts",
@@ -102,66 +104,64 @@
 		"scripts/gate/core-reservation.ts",
 		"scripts/gate/core-wait.ts",
 		"scripts/gate/core-wait-record.ts",
-		"scripts/josh/josh-command-types.ts",
 		"scripts/gate/core-weights.ts",
 		"scripts/gate/held-mark.ts",
-		"ports/index.js",
-		"scripts/josh/durable-state.ts",
+		"scripts/lib/atomic-write.ts",
+		"scripts/test/unit-run-marker.ts",
+		"scripts/gate/core-priority.ts",
+		"scripts/lane/lane-paths.ts",
+		"scripts/lane/lane-ledger-write.ts",
 		"scripts/run/carry/run-carry-conversation.ts",
 		"scripts/rules/gh-api.ts",
 		"scripts/git/parse-json-array.ts",
 		"scripts/git/repository-lock.ts",
 		"scripts/agent/agent-provider.ts",
 		"scripts/git/git-command.ts",
+		"scripts/josh/durable-state.ts",
 		"scripts/run/run-invocation.ts",
 		"scripts/run/carry/run-carry-added.ts",
 		"scripts/run/carry/run-carry-change.ts",
 		"scripts/josh/josh-commands-ship.ts",
-		"scripts/josh/josh-commands-test-check.ts",
-		"scripts/lane/lane-ledger-write.ts",
-		"scripts/lib/atomic-write.ts",
-		"scripts/test/unit-run-marker.ts",
-		"scripts/gate/core-priority.ts",
-		"scripts/lane/lane-paths.ts",
+		"scripts/josh/josh-commands-backlog.ts",
+		"scripts/josh/josh-commands-document.ts",
+		"scripts/josh/josh-commands-epic.ts",
+		"scripts/josh/josh-commands-issue.ts",
 		"scripts/josh/josh-commands-review.ts",
+		"scripts/josh/josh-commands-run.ts",
+		"scripts/josh/josh-commands-test-check.ts",
+		"scripts/gate/gate-plan.ts",
+		"scripts/josh/josh-commands-agent-hooks.ts",
 		"scripts/init/init-paths.ts",
+		"scripts/test/unit-lane-count.ts",
+		"scripts/josh/process-owner.ts",
+		"scripts/josh/josh-commands-issue-write.ts",
+		"scripts/josh/josh-commands-progress.ts",
+		"scripts/gate/gate-labels.ts",
+		"scripts/lane/lane-state-record.ts",
+		"scripts/cost-runtime/own-session.ts",
+		"scripts/josh/josh-commands-pause.ts",
+		"scripts/josh/josh-commands-prime.ts",
+		"scripts/josh/josh-verdict.ts",
+		"scripts/gate/gate-checks.ts",
+		"scripts/discovery/git-directory.ts",
+		"scripts/josh/durable-state-root.ts",
+		"scripts/lane/lane-ledger-kind.ts",
 		"scripts/rules/git-argv.ts",
 		"scripts/git/git-common-directory.ts",
 		"scripts/git/git-spawn.ts",
-		"scripts/lib/cli-flags.ts",
 		"scripts/run/carry/run-carry-streak.ts",
-		"scripts/lane/lane-ledger-kind.ts",
-		"scripts/cost-runtime/own-session.ts",
 		"scripts/cost-runtime/cost-transcript.ts",
-		"scripts/josh/josh-commands-run.ts",
-		"scripts/josh/josh-commands-document.ts",
-		"scripts/josh/josh-commands-epic.ts",
-		"scripts/josh/josh-commands-backlog.ts",
-		"scripts/test/unit-lane-count.ts",
-		"scripts/gate/gate-plan.ts",
-		"scripts/josh/process-owner.ts",
+		"scripts/issue/issue-body-keys.ts",
+		"scripts/lib/status-icons.ts",
+		"scripts/josh/durable-state-migrate.ts",
 		"scripts/git/git-diff-reads.ts",
 		"scripts/git/git-pre-push-hook.ts",
 		"scripts/git/git-push-transport.ts",
-		"scripts/josh/josh-commands-issue.ts",
-		"scripts/josh/josh-commands-agent-hooks.ts",
-		"scripts/josh/durable-state-root.ts",
-		"scripts/josh/durable-state-migrate.ts",
+		"scripts/lib/cli-flags.ts",
+		"scripts/josh/session-language.ts",
 		"scripts/git/git-ssh-keepalive.ts",
-		"scripts/josh/josh-commands-progress.ts",
-		"scripts/lane/lane-state-record.ts",
-		"scripts/gate/gate-labels.ts",
-		"scripts/josh/josh-commands-pause.ts",
-		"scripts/josh/josh-commands-prime.ts",
-		"scripts/discovery/git-directory.ts",
-		"scripts/josh/josh-verdict.ts",
-		"scripts/gate/gate-checks.ts",
-		"scripts/josh/josh-commands-issue-write.ts",
 		"scripts/cost-runtime/cost-usage.ts",
-		"scripts/time-runtime/time-instant.ts",
-		"scripts/lib/status-icons.ts",
-		"scripts/issue/issue-body-keys.ts",
-		"scripts/josh/session-language.ts"
+		"scripts/time-runtime/time-instant.ts"
 	],
 	"outputs": [
 		"josh.js"

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.3041.0",
+  "version": "1.3044.0",
   "name": "@joshuafolkken/kit",
   "description": "Hand-off kit for Claude Code and Codex: backlogrun takes your GitHub Issues to tested, reviewed, merged PRs — in parallel and unattended — with the rules, hooks and checks that keep the agent on track",
   "keywords": [

package/scripts/josh/session-language-cli.ts

@@ -32,7 +32,7 @@ import { session_language, type Resolution } from './session-language'
 const { DEFAULT_SESSION_LANG, ENV_KEY, resolve_session_lang } = session_language
 
 const BOARD_LINE =
-	'A backlogrun is live here: answer a progress question with `pnpm josh run:board --chat`, verbatim in one code block.'
+	'Live backlogrun: for progress-only questions, run `pnpm josh run:board --chat`; relay output verbatim in one code block. For cause or improvement questions, investigate state, logs and code; cite evidence and uncertainty, even with quoted board lines. For mixed questions, do both.'
 
 interface LivePorts {
 	// The common git directory the run's records are keyed on; `undefined` outside a repository.

package/scripts/run/board/run-board-header.ts

@@ -19,6 +19,7 @@ import type { QuotaHold, QuotaView } from './run-board-render-quota'
 import { run_board_render_slot } from './run-board-render-slot'
 import { run_board_render_title } from './run-board-render-title'
 import type { SeatRead } from './run-board-seat'
+import { run_board_setup } from './run-board-setup'
 import type { RunActivity } from './run-board-status'
 import type { LaneUsages, UsageScale } from './run-board-usage'
 import type { UsualTimes } from './run-board-usual'
@@ -46,7 +47,6 @@ const { padded } = run_board_fresh
 const aged_fresh = run_board_fresh.aged
 const UNKNOWN = '-'
 const BLANK = ' '
-const REPO_SEPARATOR = '/'
 const { GAP, PERCENT_WIDTH } = run_board_machine
 // A running run whose newest event is older than this is drawn as stale, so a hang stands out; past
 // twice that it is drawn as alarming.
@@ -165,9 +165,8 @@ const WORKING_MARKS: ReadonlySet<RunMark> = new Set<RunMark>(['running', 'setup'
 // Nothing running: the run is at work on a stage of its own; else it is waiting on a person when all
 // the plan has left is what `needs-decision` holds, or idle.
 function quiet_mark(header: BoardHeader): RunMark {
-	const { layout } = header
-
-	if (header.activity.setup !== undefined) return 'setup'
+	const { activity, layout } = header
+	if (run_board_setup.is_working(activity.setup, activity.is_setup_working)) return 'setup'
 
 	return layout?.queued.length === 0 && run_board_layout.people_of(layout).length > 0
 		? 'human'
@@ -191,7 +190,7 @@ function run_part(mark: RunMark, name = RUN_NAME): string {
 // The repository's own name — `kit` of `owner/kit` — under the run's, past the mark's columns, so a
 // board open beside another repository's is told apart. Blank before a plan names one.
 function repo_part(header: BoardHeader, mark: RunMark): string {
-	const name = header.repo?.split(REPO_SEPARATOR).at(-1) ?? ''
+	const name = header.repo?.split('/').at(-1) ?? ''
 	const indent = run_board_fit.width_of(RUN_MARKS[mark].glyph) + BLANK.length
 
 	return `${BLANK.repeat(indent)}${header.repo_link(name, 'home')}`

package/scripts/run/board/run-board-read.ts

@@ -59,6 +59,8 @@ interface LocalRead {
 	is_stranded: boolean
 	// The newest operation of each session of the run, read off the end of its log.
 	operations?: SessionOperations | undefined
+	// The carry's session owner is still running, apart from the supervisor's own driver.
+	is_session_active?: boolean | undefined
 	// The open lanes no child is working in at this read (`lane-spent.ts`); one is drawn stopped once it
 	// has stayed so (`run-board-idle.ts`).
 	idle_lanes?: ReadonlyArray<string> | undefined
@@ -108,6 +110,7 @@ const NO_SPAN: SpanHere = {
 	roots: {},
 	carry: undefined,
 	is_stranded: false,
+	is_session_active: false,
 }
 
 interface SpanHere {
@@ -118,6 +121,7 @@ interface SpanHere {
 	roots: ProcessRoots
 	carry: RunCarry | undefined
 	is_stranded: boolean
+	is_session_active: boolean
 }
 
 // The main work tree, resolved once: it does not move while the board is open, and resolving it runs a
@@ -159,6 +163,7 @@ async function recorded_span_here(
 		resume: run_board_span.resume_of(read, ended, launch),
 		transcript: read.kind === 'carried' ? read.carry.owner_transcript : undefined,
 		roots: run_board_roots.roots_of(repository, read, same_process),
+		is_session_active: run_board_roots.session_is_active(repository, read, same_process),
 		carry: read.kind === 'carried' ? read.carry : undefined,
 		is_stranded: run_stranded_detect.is_stranded_at(repository, stranded_ports),
 	}
@@ -341,7 +346,7 @@ function span_fields(
 // snapshot, so it agrees with the usage columns.
 async function read_local(table?: TableRead): Promise<LocalRead | undefined> {
 	const repository = await run_carry.repository_directory()
-	const { span, resume, transcript, roots, carry, is_stranded } =
+	const { span, resume, transcript, roots, carry, is_stranded, is_session_active } =
 		repository === undefined ? NO_SPAN : await span_here(repository, table)
 
 	if (repository === undefined || span === undefined) return undefined
@@ -361,6 +366,7 @@ async function read_local(table?: TableRead): Promise<LocalRead | undefined> {
 		roots,
 		carry,
 		is_stranded,
+		is_session_active,
 		operations: run_board_operation_read.read(sources_of(repository, lanes, transcript)),
 		...(await lane_room_of(lanes, lane_read.lane_states, table)),
 		...ledger_here(repository),

package/scripts/run/board/run-board-roots.ts

@@ -1,7 +1,7 @@
 import { process_identity } from '#scripts/josh/process-identity'
 import { lane_process_table, type TableRead } from '#scripts/lane/lane-process-table'
 import type { CarryRead } from '#scripts/run/carry/run-carry'
-import { run_wake } from '#scripts/run/wake/run-wake'
+import { run_wake, type RunWake } from '#scripts/run/wake/run-wake'
 import type { ProcessRoots } from './run-board-process-groups'
 
 // The run's own processes the 💻 section names: the supervisor from its wake stamp and the parent
@@ -38,6 +38,29 @@ function roots_of(
 	return { supervisor: supervisor_of(repository, is_same), parent: parent_of(read, is_same) }
 }
 
+// A handed-back budget or the supervisor's own driver is no judgment session. Codex's pid-less
+// carry uses the launch pid already recorded by the wake supervisor instead.
+function is_session_owner(read: CarryRead): boolean {
+	return read.kind === 'carried' && read.carry.is_handed_off !== true
+}
+
+function live_session_pid(
+	pid: number | undefined,
+	start: string | undefined,
+	wake: RunWake | undefined,
+	is_same: SameProcess,
+): boolean {
+	return pid !== undefined && pid !== wake?.pid && is_same(pid, start) !== false
+}
+
+function session_is_active(repository: string, read: CarryRead, is_same: SameProcess): boolean {
+	if (read.kind !== 'carried' || !is_session_owner(read)) return false
+	const wake = run_wake.read_wake(run_wake.wake_path(repository))
+	const pid = read.carry.owner_pid ?? wake?.woke_pid
+
+	return live_session_pid(pid, read.carry.owner_start, wake, is_same)
+}
+
 // `is_same_process` with each start time answered from the redraw's own `ps` snapshot, so the board's
 // read runs no `ps` of its own per pid (joshuafolkken/kit#4263). Without a snapshot no start is known,
 // and a recorded start reads as "cannot tell".
@@ -48,7 +71,7 @@ async function same_in(table: TableRead | undefined): Promise<SameProcess> {
 	return (pid, start) => process_identity.is_same_process(pid, start, read)
 }
 
-const run_board_roots = { roots_of, same_in }
+const run_board_roots = { roots_of, same_in, session_is_active }
 
 export { run_board_roots }
 export type { SameProcess }

package/scripts/run/board/run-board-setup.ts

@@ -21,19 +21,25 @@ interface SetupRead {
 
 const NO_SETUP: SetupRead = { setup: undefined, setup_ms: undefined }
 
+// Only these stages depend on the judgment session owning the carry.
+const SESSION_STAGES: ReadonlySet<string> = new Set([STAGE.JUDGING, STAGE.SESSION])
+
 // The stages of a hand-back to a session, and of the retrospective unit the driver waits on at a drain
 // (joshuafolkken/kit#6745). Only the run's next stage ends one, whatever the session or the unit writes
 // to the stream meanwhile.
-const SESSION_STAGES: ReadonlySet<string> = new Set([
-	STAGE.JUDGING,
-	STAGE.SESSION,
-	STAGE.RETROSPECTIVE,
-])
+const RETAINED_STAGES: ReadonlySet<string> = new Set([...SESSION_STAGES, STAGE.RETROSPECTIVE])
 
 function is_setup(event: RunEvent): boolean {
 	return event.kind === KIND.SETUP
 }
 
+// Session stages describe the last hand-off even after its owner has returned the budget.
+function is_working(setup: string | undefined, is_session_active: boolean | undefined): boolean {
+	if (setup === undefined) return false
+
+	return !SESSION_STAGES.has(setup) || is_session_active !== false
+}
+
 // A launch that returned without a child (`run_event_setup.no_child`): it ends its own lane's stage,
 // and prepares nothing a person waits on.
 function is_refusal(event: RunEvent): boolean {
@@ -65,7 +71,7 @@ function is_opening(events: ReadonlyArray<RunEvent>, stage: RunEvent): boolean {
 // Whether the run is at `stage` now: at any stage while it is starting; after that only at one it is
 // itself working through.
 function is_standing(events: ReadonlyArray<RunEvent>, stage: RunEvent): boolean {
-	if (!has_started(events) || SESSION_STAGES.has(stage.text)) return true
+	if (!has_started(events) || RETAINED_STAGES.has(stage.text)) return true
 
 	return is_opening(events, stage)
 }
@@ -119,7 +125,7 @@ function lane_stage(events: ReadonlyArray<RunEvent>, issue: number): LaneStage |
 	return { text: step.text, at_ms: Date.parse(step.at) }
 }
 
-const run_board_setup = { is_refusal, lane_stage, read }
+const run_board_setup = { is_refusal, is_working, lane_stage, read }
 
 export { run_board_setup }
 export type { LaneStage, SetupRead }

package/scripts/run/board/run-board-status.ts

@@ -82,6 +82,8 @@ interface LatestEvent {
 // The run as a whole, read off the same stream. The setup half is `run-board-setup.ts`'s, absent
 // where a stream carries no stage.
 interface RunActivity extends Partial<SetupRead> {
+	// Runtime evidence for the stage, independent of its retained description.
+	is_setup_working?: boolean | undefined
 	last_event_ms: number | undefined
 	// The newest thing the run did — its newest position, or its newest event where it has none yet —
 	// in the event's own words, and when.

package/scripts/run/board/run-board-tick.ts

@@ -14,6 +14,7 @@ import { run_board_reason, type ReasonRead } from './run-board-reason'
 import { run_board_released } from './run-board-released'
 import { run_board_render } from './run-board-render'
 import { run_board_seat, type SeatRead } from './run-board-seat'
+import { run_board_setup } from './run-board-setup'
 import type { Known } from './run-board-snapshot'
 import { run_board_spin, type Spun } from './run-board-spin'
 import { run_board_state, type BoardPorts, type BoardState, type Pace } from './run-board-state'
@@ -82,10 +83,15 @@ function titles_of(state: BoardState): Titles {
 
 // A run `run:carry --end` closed and one nobody drives any more are both drawn as stopped.
 function activity_here(local: LocalRead): RunActivity {
-	return run_board_status.activity_of(
+	const activity = run_board_status.activity_of(
 		local.events,
 		local.ended_ms !== undefined || local.is_stranded,
 	)
+
+	return {
+		...activity,
+		is_setup_working: run_board_setup.is_working(activity.setup, local.is_session_active),
+	}
 }
 
 // The already-read supervisor or parent drives retries until the run stops or becomes stranded.