@joshuafolkken/kit 1.3000.0 → 1.3044.0

package/scripts/issue/issue-file-worker.ts

@@ -0,0 +1,95 @@
+import {
+	agent_worker_profile,
+	type SettingsResult,
+	type WorkerSettings,
+} from '#scripts/agent/agent-worker-profile'
+import { issue_file } from './issue-file'
+import type { LabelDefinition } from './issue-labels'
+
+// `issue:file`'s side of `josh.worker`: a filing into a repository that sets it prints the profiles to
+// choose from, refuses a `worker:<name>` label naming none of them, and provisions the chosen label
+// beside kit's own. kit never picks a profile from the Issue's content. Without the setting — or for a
+// filing into another repository, whose setting this checkout does not hold — nothing here prints or
+// asks GitHub anything.
+const { LABEL_PREFIX } = agent_worker_profile
+const LABEL_COLOR = 'bfd4f2'
+const LABEL_DESCRIPTION = 'Lane worker profile (josh.worker)'
+
+interface Target {
+	target: string
+	current: string
+}
+
+function settings_of(place: Target): SettingsResult | undefined {
+	if (!issue_file.is_same_repository(place.target, place.current)) return undefined
+
+	return agent_worker_profile.read(process.cwd())
+}
+
+// Deduplicated: a label typed twice is one label on the Issue, not two profiles chosen.
+function worker_labels(labels: ReadonlyArray<string>): ReadonlyArray<string> {
+	return [...new Set(labels.filter((label) => label.startsWith(LABEL_PREFIX)))]
+}
+
+// The profiles weakest first, as `josh.worker` lists them, and the one an unlabelled Issue runs on.
+function guide_of(settings: WorkerSettings): string {
+	const rows = settings.profiles.map(
+		(profile) => `  ${LABEL_PREFIX}${profile.name} — ${profile.when}`,
+	)
+
+	return [
+		`worker profiles (josh.worker, weakest first) — choose one with --label ${LABEL_PREFIX}<name>; none → ${settings.default}:`,
+		...rows,
+	].join('\n')
+}
+
+// A broken setting refuses only a filing that chose a profile it cannot check; any other filing goes on.
+function is_unchecked_clear(note: string, labels: ReadonlyArray<string>): boolean {
+	if (worker_labels(labels).length === 0) {
+		console.warn(`⚠ ${note}`)
+
+		return true
+	}
+
+	console.error(`✖ ${note}`)
+
+	return false
+}
+
+function is_choice_clear(settings: WorkerSettings, labels: ReadonlyArray<string>): boolean {
+	console.info(guide_of(settings))
+	const chosen = agent_worker_profile.for_labels(settings, worker_labels(labels))
+
+	if (chosen.kind === 'worker') return true
+	console.error(`✖ ${chosen.kind === 'rejected' ? chosen.note : chosen.kind}`)
+
+	return false
+}
+
+// A one-pass step (`issue-file-pass.ts`): false once it printed its refusal.
+function is_worker_clear(place: Target, labels: ReadonlyArray<string>): boolean {
+	const result = settings_of(place)
+
+	if (result === undefined || result.kind === 'unset') return true
+	if (result.kind === 'rejected') return is_unchecked_clear(result.note, labels)
+
+	return is_choice_clear(result.settings, labels)
+}
+
+// The `worker:<name>` labels `ensure_labels` creates beside kit's own — none without the setting.
+function label_definitions(
+	place: Target,
+	labels: ReadonlyArray<string>,
+): ReadonlyArray<LabelDefinition> {
+	if (settings_of(place)?.kind !== 'settings') return []
+
+	return worker_labels(labels).map((name) => ({
+		name,
+		color: LABEL_COLOR,
+		description: LABEL_DESCRIPTION,
+	}))
+}
+
+const issue_file_worker = { is_worker_clear, label_definitions }
+
+export { issue_file_worker }

package/scripts/issue/issue-file.ts

@@ -46,7 +46,7 @@ interface FileArguments {
 	// `--over-cap`: the run is blocked by this filing, or a user typed `new`, so the WIP cap does not
 	// hold it (`issue-wip.ts`, `wip-cap.md`).
 	is_over_cap: boolean
-	// `--no-auto-ok`: the Issue needs a person's judgement, so `auto-ok` is not applied (`issue-auto-ok.ts`).
+	// `--no-auto-ok`: an exclusion or verified user prohibition withholds `auto-ok` (`issue-auto-ok.ts`).
 	is_auto_ok_opted_out: boolean
 	// `--release`: the change reaches a consumer only once published, so the Issue is linked to the
 	// repository's release Issue as a blocker (`issue-release-cli.ts`).

package/scripts/issue/issue-outcome.ts

@@ -0,0 +1,107 @@
+import { git_gh_issue_read } from '#scripts/gh/git-gh-issue-read'
+import { json_value } from '#scripts/lib/json-value'
+import { z } from 'zod'
+import { issue_read, type IssueComment } from './issue-read'
+
+// Persist the author's conclusion with its evidence; drawing never infers a conclusion.
+const SUMMARY_LIMIT = 80
+const summary_schema = z
+	.string()
+	.min(1)
+	.max(SUMMARY_LIMIT)
+	.regex(/^[\u{20}-\u{7E}]+$/u)
+	.refine((value) => value === value.trim())
+const MARKER = /^<!-- josh:outcome (?<json>[^\n]+) -->$/gmu
+const COMMENT_URL = /^https:\/\/github\.com\/[^/]+\/[^/]+\/issues\/\d+#issuecomment-\d+$(?![\s\S])/u
+const url_schema = z.string().regex(COMMENT_URL)
+const outcome_schema = z.object({ summary: summary_schema, url: url_schema.optional() })
+
+interface IssueOutcome {
+	summary: string
+	url: string
+}
+
+interface OutcomeNote {
+	body: string
+	summary?: string | undefined
+	url?: string | undefined
+}
+
+function body_of(note: OutcomeNote): string {
+	if (note.summary === undefined && note.url === undefined) return note.body
+	const outcome = outcome_schema.parse({ summary: note.summary, url: note.url })
+
+	return `${note.body}\n\n<!-- josh:outcome ${JSON.stringify(outcome)} -->`
+}
+
+function evidence_of(comment: IssueComment, url: string): boolean {
+	if (comment.html_url === undefined || !COMMENT_URL.test(url)) return false
+
+	return url.split('#', 1)[0] === comment.html_url.split('#', 1)[0]
+}
+
+function record_of(body: string): z.infer<typeof outcome_schema> | undefined {
+	const json = [...body.matchAll(MARKER)].at(-1)?.groups?.['json']
+
+	return json_value.parse_with(json ?? '', outcome_schema)
+}
+
+function cited_outcome(
+	record: z.infer<typeof outcome_schema>,
+	comment: IssueComment,
+): IssueOutcome | undefined {
+	const url = record.url ?? comment.html_url
+
+	return url === undefined || !evidence_of(comment, url)
+		? undefined
+		: { summary: record.summary, url }
+}
+
+function outcome_of(comment: IssueComment): IssueOutcome | undefined {
+	if (comment.is_trusted !== true) return undefined
+	const record = record_of(comment.body)
+
+	return record === undefined ? undefined : cited_outcome(record, comment)
+}
+
+function from_comments(
+	comments: ReadonlyArray<IssueComment>,
+	candidates: ReadonlyArray<IssueComment> = comments,
+): IssueOutcome | undefined {
+	const outcomes = candidates.flatMap((comment) => {
+		const outcome = outcome_of(comment)
+		const evidence = comments.find((entry) => entry.html_url === outcome?.url)
+
+		return outcome === undefined || evidence?.is_trusted !== true ? [] : [outcome]
+	})
+
+	return outcomes.at(-1)
+}
+
+async function read(issue: number): Promise<IssueOutcome | undefined> {
+	try {
+		const json = await git_gh_issue_read.issue_list_comments(
+			String(issue),
+			undefined,
+			undefined,
+			git_gh_issue_read.read_comments_conditionally,
+		)
+		const comments = json === undefined ? undefined : await issue_read.parse_comments(json)
+
+		return comments === undefined ? undefined : from_comments(comments)
+	} catch {
+		return undefined
+	}
+}
+
+async function recorded(issue: number, is_merged: boolean): Promise<{ outcome?: IssueOutcome }> {
+	if (is_merged) return {}
+	const outcome = await read(issue)
+
+	return outcome === undefined ? {} : { outcome }
+}
+
+const issue_outcome = { body_of, from_comments, read, recorded, summary_schema, url_schema }
+
+export { issue_outcome }
+export type { IssueOutcome }

package/scripts/issue/issue-read.ts

@@ -2,6 +2,7 @@ import { gh_author_association } from '#scripts/gh/gh-author-association'
 import { gh_comment_input } from '#scripts/gh/gh-comment-input'
 import { parse_json_object_or_undefined, read_json_listing } from '#scripts/git/parse-json-array'
 import { z } from 'zod'
+import { issue_watch_diff } from './issue-watch-diff'
 
 // The block `josh issue:read` prints for one issue, kept apart from the reading and the printing so
 // the shape of the report is decided by one pure function — the seam `issue-state.ts` already has.
@@ -51,7 +52,7 @@ const issue_fields_schema = z.looseObject({
 
 const comment_schema = z.looseObject({
 	html_url: z.string().optional(),
-	user: z.looseObject({ login: z.string() }).optional(),
+	user: z.looseObject({ login: z.string(), type: z.string().optional() }).optional(),
 	created_at: z.string().optional(),
 	body: z.string().optional(),
 	author_association: z.string().nullish(),
@@ -73,6 +74,7 @@ interface IssueComment {
 	body: string
 	// As `IssueFields.is_body_trusted`: `undefined` when the lookup failed.
 	is_trusted: boolean | undefined
+	is_automated?: boolean
 }
 
 const UNKNOWN_AUTHOR = '(unknown)'
@@ -113,17 +115,19 @@ async function to_comment(
 	repo: string | undefined,
 ): Promise<IssueComment> {
 	const login = raw.user?.login
+	const is_trusted = await gh_author_association.trust_of({
+		login,
+		association: raw.author_association,
+		repo,
+	})
 
 	return {
 		html_url: raw.html_url,
 		author: login ?? UNKNOWN_AUTHOR,
 		created_at: raw.created_at ?? UNKNOWN_TIME,
 		body: raw.body ?? '',
-		is_trusted: await gh_author_association.trust_of({
-			login,
-			association: raw.author_association,
-			repo,
-		}),
+		is_trusted,
+		is_automated: issue_watch_diff.is_automated(raw, is_trusted),
 	}
 }
 
@@ -156,7 +160,8 @@ function trusted_bodies(comments: ReadonlyArray<IssueComment>): ReadonlyArray<st
 
 function format_comment(comment: IssueComment): string {
 	const trust = gh_comment_input.trust_of(comment.author, comment.is_trusted)
-	const heading = `${COMMENT_HEADING}${comment.author}${AT}${comment.created_at} [${trust}]`
+	const source = comment.is_automated === true ? ' [automated]' : ''
+	const heading = `${COMMENT_HEADING}${comment.author}${AT}${comment.created_at} [${trust}]${source}`
 
 	return `${heading}\n${comment.is_trusted === true ? comment.body : UNTRUSTED_COMMENT}`
 }

package/scripts/issue/issue-watch-diff.ts

@@ -86,7 +86,7 @@ function is_bot(user: z.infer<typeof comment_schema>['user']): boolean {
 }
 
 function is_automated(
-	raw: z.infer<typeof comment_schema>,
+	raw: Pick<z.infer<typeof comment_schema>, 'user' | 'body'>,
 	is_trusted: boolean | undefined,
 ): boolean {
 	return is_bot(raw.user) || (is_trusted === true && (raw.body?.includes(RUN_MARKER) ?? false))
@@ -228,6 +228,7 @@ const issue_watch_diff = {
 	RUN_MARKER,
 	WITHHELD_BODY_EDIT,
 	baseline_of,
+	is_automated,
 	landed_times,
 	parse_comments,
 	unread_diff,

package/scripts/josh/josh-commands-ai.ts

@@ -444,7 +444,7 @@ const AI_COMMANDS: Record<string, CommandEntry> = {
 			"Record a lane child's planned files; yield its lane, naming file and holder, when an earlier-planned running lane declares or plans one; `--size-approval` bounds lines/files",
 		category: 'AI tools',
 		reference: [
-			'<issue> <path>... [--probe] [--single] [--size-approval <json-file>] [--imports <path>...]',
+			'<issue> <path>... [--probe] [--single] [--estimate <json-file>] [--size-approval <json-file>] [--imports <path>...]',
 			'automation',
 			['files', 'network'],
 		],
@@ -512,7 +512,7 @@ const AI_COMMANDS: Record<string, CommandEntry> = {
 	'lane:stats': {
 		...MEASURE_ARGUMENTS,
 		description:
-			'Print period lane throughput, stage, stop, check and machine-load statistics; --sinks shows stage totals, --over lane chains, --why cause groups above a net-minute threshold, and --pairs scoped pair runs',
+			'Print period lane throughput, stage, stop (by failed CI check, longest first), check and machine-load statistics; --sinks shows stage totals, --over lane chains, --why cause groups above a net-minute threshold, and --pairs scoped pair runs',
 		category: 'AI tools',
 		reference: [
 			'(--period <days> | --since <instant>) [--limit <lane-limit> | --sinks [<minutes>] | --over <minutes> | --why <minutes> | --pairs]',

package/scripts/josh/josh-commands-development.ts

@@ -6,6 +6,7 @@ import { AGENT_HOOK_COMMANDS } from './josh-commands-agent-hooks'
 import { TEST_CHECK_COMMANDS } from './josh-commands-test-check'
 
 const NARROWED = { arguments: 'scripts/thing.ts', note: 'narrow by the given files instead' }
+const FORWARDED_TO_VITEST = 'flags are forwarded to vitest'
 // The unseeded ports are read from `ports/index.js`, their one definition (#818).
 const UNSEEDED: Readonly<Record<string, string | undefined>> = {}
 
@@ -50,13 +51,14 @@ const DEV_COMMANDS: Record<string, CommandEntry> = {
 		script: 'scripts/lint/lint-parallel-main.ts',
 		description: 'Check code with prettier and eslint (skips a tool a basic project lacks)',
 		category: 'Development',
-		reference: ['[--changed]', 'developer', ['processes']],
+		reference: ['[--changed] [--shard=<n>]', 'developer', ['processes']],
 		core_weight: core_weights.CORE_WEIGHTS.lint,
 		memory_mb: core_weights.MEMORY_MB.lint,
 		usage: {
 			examples: [
 				{ arguments: '' },
 				{ arguments: '--changed', note: "the branch's changed files — the gate's form" },
+				{ arguments: '--shard=1', note: 'one of two fixed halves of the tree (1 or 2) — a CI leg' },
 			],
 		},
 	},
@@ -129,7 +131,11 @@ const DEV_COMMANDS: Record<string, CommandEntry> = {
 		description:
 			"Print each delivered rule's unaided compliance — runs reached, kept rate, refusals",
 		category: 'AI tools',
-		reference: ['[--fresh | --refresh | --prose]', 'developer', ['files']],
+		reference: [
+			'[--fresh | --refresh | --period <days> | --weekly <rule-id>... | --prose]',
+			'developer',
+			['files'],
+		],
 		usage: {
 			examples: [
 				{ arguments: '', note: 'a reading cached under 15 minutes ago, else measure' },
@@ -138,6 +144,14 @@ const DEV_COMMANDS: Record<string, CommandEntry> = {
 					arguments: '--refresh',
 					note: 'write the reading to the loop-head cache instead of stdout',
 				},
+				{
+					arguments: '--period 7',
+					note: 'measure only the transcripts written in the last 7 days, cache untouched',
+				},
+				{
+					arguments: '--weekly <rule-id>...',
+					note: 'reached / refused / rephrased of the named rules, one line per week',
+				},
 				{ arguments: '--prose', note: 'class each prose rule: enforced, measured or prose only' },
 			],
 		},
@@ -229,7 +243,9 @@ const DEV_COMMANDS: Record<string, CommandEntry> = {
 		category: 'Development',
 		reference: [FILTER_ARGUMENTS, 'developer', ['processes']],
 		...gate_plan.DIRECT_UNIT_CLAIM,
-		usage: { examples: [{ arguments: '' }] },
+		usage: {
+			examples: [{ arguments: '' }, { arguments: '--shard=1/3', note: FORWARDED_TO_VITEST }],
+		},
 	},
 	'test:related': {
 		script: 'scripts/test/test-related-main.ts',
@@ -240,8 +256,8 @@ const DEV_COMMANDS: Record<string, CommandEntry> = {
 			examples: [
 				{ arguments: '' },
 				NARROWED,
-				{ arguments: '--touched', note: "only the diff's tests and its modules' same-named ones" },
-				{ arguments: '--silent', note: 'flags are forwarded to vitest' },
+				{ arguments: '--touched', note: 'diff tests, same-named tests and direct test importers' },
+				{ arguments: '--silent', note: FORWARDED_TO_VITEST },
 			],
 		},
 	},

package/scripts/josh/josh-commands-issue-write.ts

@@ -263,7 +263,8 @@ const ISSUE_WRITE_COMMANDS: Record<string, CommandEntry> = {
 				},
 				{
 					names: ['--label <name>'],
-					description: 'an extra label (for example `epic`). Repeatable.',
+					description:
+						'an extra label (e.g. `epic`). Repeatable. With `josh.worker`, `worker:<name>` names a printed profile.',
 				},
 				{
 					names: ['--defect / --verification / --every-run <yes|no|unknown>'],
@@ -290,7 +291,7 @@ const ISSUE_WRITE_COMMANDS: Record<string, CommandEntry> = {
 				},
 				{
 					names: ['--no-auto-ok'],
-					description: "needs a person's judgement (Tier B / C); no `auto-ok`.",
+					description: 'needs human judgement or a verified user prohibition; no `auto-ok`.',
 				},
 				{
 					names: ['--release'],

package/scripts/josh/josh-commands-lint.ts

@@ -81,7 +81,7 @@ const LINT_COMMANDS: Record<string, CommandEntry> = {
 		description:
 			"Print a work summary's inputs in one call: the run:prep skeleton, planned files near the line limit, the test:declared verdict, the owed cases and the plan:consumers draft",
 		category: 'AI tools',
-		reference: ['<issue> [<path>...]', 'automation', ['network']],
+		reference: ['<issue> [<path>...] [--estimate <json-file>]', 'automation', ['network']],
 		usage: {
 			examples: [
 				{ arguments: '123', note: 'planned files from the issue body' },

package/scripts/josh/josh-commands-project.ts

@@ -135,8 +135,13 @@ const PROJECT_COMMANDS: Record<string, CommandEntry> = {
 		script: 'scripts/sync/sync-main.ts',
 		description: 'Sync config files',
 		category: 'Project',
-		reference: ['', 'developer', ['files']],
-		usage: { examples: [{ arguments: '', note: 'overwrite managed files' }] },
+		reference: ['[--force]', 'developer', ['files']],
+		usage: {
+			examples: [
+				{ arguments: '', note: 'overwrite managed files' },
+				{ arguments: '--force', note: 'also replace a file you added to, dropping your additions' },
+			],
+		},
 	},
 	uninstall: {
 		script: 'scripts/uninstall/uninstall.ts',

package/scripts/josh/josh-commands-run.ts

@@ -185,10 +185,14 @@ const RUN_COMMANDS: Record<string, CommandEntry> = {
 	},
 	'run:park': {
 		script: 'scripts/run/park/run-park-cli.ts',
-		description: 'Park a lane child for a decision, or clear the park',
+		description: 'Park a lane child for a decision or an escalation, or clear the park',
 		category: 'AI tools',
 		tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-		reference: ['<issue> --body-file <path> | <issue> --clear', 'automation', ['files', 'network']],
+		reference: [
+			'<issue> --body-file <path> | <issue> --clear | <issue> --escalate <reason>',
+			'automation',
+			['files', 'network'],
+		],
 		usage: {
 			examples: [
 				{
@@ -196,6 +200,10 @@ const RUN_COMMANDS: Record<string, CommandEntry> = {
 					note: 'options, tiers and a recommendation; then needs-decision, the record, run:release',
 				},
 				{ arguments: '1839 --clear', note: 'remove needs-decision and the record' },
+				{
+					arguments: '1839 --escalate "needs a stronger model"',
+					note: 'josh.worker.escalate only: run:stalled with the reason, resumed one profile up',
+				},
 			],
 		},
 	},

package/scripts/josh/josh-commands-workflow.ts

@@ -40,6 +40,11 @@ const WORKFLOW_COMMANDS: Record<string, CommandEntry> = {
 					names: [SKIP_COMMIT, SKIP_PUSH],
 					description: 'recover/open a PR without a new commit or push.',
 				},
+				{
+					names: ['--body-file <path>'],
+					description:
+						'extra PR body text after `closes #N`, from a file (`-` = stdin); use it when the text holds a backtick or `$`.',
+				},
 			],
 		},
 	},

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/lane/lane-breakdown-cli.ts

@@ -63,12 +63,22 @@ async function print_timeline(issue: string): Promise<number> {
 		records.events,
 		Number(issue),
 	)
-	const timeline =
-		breakdown === undefined ? undefined : lane_timeline.of(records, Number(issue), breakdown)
+	if (breakdown === undefined) return missing(issue)
+	const timeline = lane_timeline.of(records, Number(issue), breakdown)
 
 	if (timeline === undefined) return missing(issue)
 
-	const lines = [records.notice, lane_timeline.text(session_cite.issue(issue), timeline)]
+	const report = lane_breakdown_text.report_of(
+		Number(issue),
+		breakdown,
+		records.entries,
+		records.events,
+	)
+	const lines = [
+		records.notice,
+		lane_timeline.text(session_cite.issue(issue), timeline),
+		report.elapsed ?? '',
+	]
 
 	console.info(lines.filter((line) => line !== '').join('\n'))
 
@@ -84,7 +94,7 @@ async function print(issue: string): Promise<number> {
 
 	if (minutes === undefined || breakdown === undefined) return missing(issue)
 
-	const report = lane_breakdown_text.report_of(Number(issue), breakdown, entries)
+	const report = lane_breakdown_text.report_of(Number(issue), breakdown, entries, events)
 
 	console.info(
 		[

package/scripts/lane/lane-breakdown-text.ts

@@ -1,3 +1,4 @@
+import type { RunEvent } from '#scripts/run/event/run-event-stream'
 import { lane_breakdown, type Breakdown, type Stage } from './lane-breakdown'
 import { lane_breakdown_calls, type CallGroup } from './lane-breakdown-calls'
 import {
@@ -9,6 +10,7 @@ import { lane_breakdown_laps, type Laps } from './lane-breakdown-laps'
 import { lane_breakdown_pinned } from './lane-breakdown-pinned'
 import { lane_breakdown_related } from './lane-breakdown-related'
 import { lane_ci_path_stats } from './lane-ci-path-stats'
+import { lane_elapsed_time } from './lane-elapsed-time'
 import type { LedgerEntry } from './lane-ledger'
 import { lane_stage_budget, type BudgetStage } from './lane-stage-budget'
 
@@ -27,6 +29,7 @@ const OUTSIDE = 'outside calls'
 const DRIVER = '(outside lane net)'
 
 interface Report {
+	elapsed?: string | undefined
 	breakdown: Breakdown
 	detail: ImplementDetail
 	// The ship pre-detach line's `test:pinned` detail, `''` when none (joshuafolkken/kit#5078).
@@ -217,11 +220,14 @@ function report_of(
 	issue: number,
 	breakdown: Breakdown,
 	entries: ReadonlyArray<LedgerEntry>,
+	events: ReadonlyArray<RunEvent> = [],
 ): Report {
 	const calls = lane_breakdown_implement.read(issue, breakdown)
 	const rows = lane_breakdown_pinned.rows_of(entries, issue, breakdown)
+	const timing = lane_elapsed_time.of(entries, events, issue, calls)
 
 	return {
+		elapsed: timing === undefined ? undefined : lane_elapsed_time.text(timing),
 		breakdown,
 		detail: lane_breakdown_implement.of(calls, breakdown),
 		laps: lane_breakdown_laps.of(entries, issue, breakdown, calls),
@@ -243,6 +249,7 @@ function comment(issue: number, minutes: number, report: Report): string {
 		`${lead} ${source}`,
 		'',
 		...entries_of(report).flatMap((entry) => bullets_of(entry)),
+		...(report.elapsed === undefined ? [] : [report.elapsed]),
 	].join('\n')
 }
 

package/scripts/lane/lane-breakdown.ts

@@ -5,6 +5,7 @@ import { lane_breakdown_pause, type PauseMark } from './lane-breakdown-pause'
 import { lane_ledger, type LedgerEntry } from './lane-ledger'
 import { lane_net_time, type LaneSpan } from './lane-net-time'
 import { lane_plan_wait_event } from './lane-plan-wait-event'
+import { lane_stage_events } from './lane-stage-events'
 import { lane_stop_stats } from './lane-stop-stats'
 import { lane_yield_split, type YieldShare } from './lane-yield-split'
 
@@ -329,7 +330,7 @@ function driver_of(ms: number): Array<Stage> {
  * span and intervals `lane_net_time.net_ms` reads, so the stages add up to it and the driver's followup
  * stands apart. `edit_ms`, the lane's first edit, opens the implementation where no event did.
  */
-function of(
+function breakdown_of(
 	entries: ReadonlyArray<LedgerEntry>,
 	events: ReadonlyArray<RunEvent>,
 	issue: number,
@@ -358,6 +359,25 @@ function of(
 	}
 }
 
+function of(
+	entries: ReadonlyArray<LedgerEntry>,
+	events: ReadonlyArray<RunEvent>,
+	issue: number,
+	edit_ms?: number,
+): Breakdown | undefined {
+	const span = lane_net_time.span_of(entries, issue)
+	const breakdown = breakdown_of(
+		entries,
+		lane_stage_events.of(entries, events, issue),
+		issue,
+		edit_ms,
+	)
+
+	return breakdown === undefined || span === undefined
+		? undefined
+		: { ...breakdown, reasons: reasons_of(events, issue, span) }
+}
+
 // The stage `at_ms` fell in — the plan, the implementation or a ship stage, by the spans `of` cut — or
 // `undefined` outside them; `josh cost:audit` attributes a request's tokens by it
 // (joshuafolkken/kit#5936).