@joshuafolkken/kit 1.1050.0 → 1.1094.0

package/scripts/epic/epic-bundle-referenced.ts

@@ -1,4 +1,4 @@
-import { git_gh_command } from '#scripts/git/git-gh-command'
+import { git_gh_command } from '#scripts/gh/git-gh-command'
 import { bounded_pool } from '#scripts/lib/bounded-pool'
 import { epic_audit_logic } from './epic-audit'
 import type { BacklogIssue } from './epic-bundle'
@@ -181,11 +181,7 @@ async function referenced_candidates(
 
 const epic_bundle_referenced = {
 	REFERENCED_LOOKUP_LIMIT,
-	LOOKUP_CONCURRENCY,
 	referenced_lookups,
-	is_failed_read,
-	to_backlog_issue,
-	is_usable_candidate,
 	collect_referenced,
 	fetch_referenced,
 	referenced_candidates,

package/scripts/epic/epic-bundle.ts

@@ -294,12 +294,8 @@ const epic_bundle = {
 	names_in_body,
 	NO_SIGNAL_REASON,
 	already_tracked_reason,
-	SPREAD_REASON,
-	has_mutual_reference,
 	has_recorded_dependency,
 	is_strong_signal,
-	find_candidates,
-	candidate_epics,
 	decide_bundle,
 	bundle_dependency_links,
 	bundle_children,

package/scripts/epic/epic-busy.ts

@@ -1,12 +1,12 @@
-import { git_gh_command } from '#scripts/git/git-gh-command'
+import { git_gh_command } from '#scripts/gh/git-gh-command'
+import { read_json_listing } from '#scripts/git/parse-json-array'
+import { open_issue_schema, type OpenIssueData } from '#scripts/git/schemas'
 import {
 	ALREADY_DONE_LABEL,
 	has_any_label,
 	IN_PROGRESS_LABEL,
 	NEEDS_DECISION_LABEL,
-} from '#scripts/git/issue-labels'
-import { read_json_listing } from '#scripts/git/parse-json-array'
-import { open_issue_schema, type OpenIssueData } from '#scripts/git/schemas'
+} from '#scripts/issue/issue-labels'
 
 // How much of a repository's parallelism is already spoken for — asked of the *repository*, never of
 // the epic (joshuafolkken/kit#925), and counted rather than treated as a yes/no since
@@ -194,7 +194,6 @@ const epic_busy = {
 	unreadable_message,
 	truncated_message,
 	busy_reason,
-	format_holders,
 	is_parked,
 	parse_listing,
 	read_repository,

package/scripts/epic/epic-candidate-confirm.ts

@@ -268,11 +268,6 @@ async function answer_for_repo(
 
 const epic_candidate_confirm = {
 	is_same_blockers,
-	untracked_blockers,
-	with_blockers,
-	is_still_runnable,
-	confirm_candidates,
-	withheld_verdict,
 	answer_for_repo,
 }
 

package/scripts/epic/epic-classify.ts

@@ -3,7 +3,7 @@ import {
 	has_label_name,
 	IN_PROGRESS_LABEL,
 	NEEDS_DECISION_LABEL,
-} from '#scripts/git/issue-labels'
+} from '#scripts/issue/issue-labels'
 import { epic_graph, type EpicChild, type IssueReference } from './epic-graph'
 import { epic_nested } from './epic-nested'
 import {
@@ -44,7 +44,7 @@ function resolve_by_state(blocker: EpicChild): DependencyVerdict {
 // Case-insensitive, through the shared comparison rather than `Array.includes`. GitHub keeps the
 // casing a label was created with and treats `Epic` and `epic` as one label, so a repository that
 // predates these scripts can answer with either spelling — and a child read by eye against the
-// lowercase string is one this classification never sees (`scripts/git/issue-labels.ts`).
+// lowercase string is one this classification never sees (`scripts/issue/issue-labels.ts`).
 function has_label(child: EpicChild, label: string): boolean {
 	return has_label_name(child.labels, label)
 }

package/scripts/epic/epic-cli-argv.ts

@@ -66,7 +66,6 @@ function has_unknown_flag(argv: ReadonlyArray<string>, known: ReadonlySet<string
 }
 
 const epic_cli_argv = {
-	is_flag,
 	read_flag_value,
 	to_positional_arguments,
 	count_flag,

package/scripts/epic/epic-close-comment.ts

@@ -1,4 +1,4 @@
-import { git_gh_command } from '#scripts/git/git-gh-command'
+import { git_gh_command } from '#scripts/gh/git-gh-command'
 import { read_json_listing } from '#scripts/git/parse-json-array'
 import { rest_comment_schema, type RestCommentData } from '#scripts/git/schemas'
 import { epic_parse, type ExternalChild } from './epic-parse'

package/scripts/epic/epic-close.ts

@@ -1,11 +1,11 @@
-import { git_gh_command } from '#scripts/git/git-gh-command'
-import { EPIC_LABEL } from '#scripts/git/issue-labels'
+import { git_gh_command } from '#scripts/gh/git-gh-command'
 import { cutoff_cause, cutoff_of, type ScanCutoff } from '#scripts/git/listing-cutoff'
 import {
 	parse_json_array_or_undefined,
 	parse_json_object_safe,
 } from '#scripts/git/parse-json-array'
 import { epic_child_schema, epic_issue_schema, type EpicChildData } from '#scripts/git/schemas'
+import { EPIC_LABEL } from '#scripts/issue/issue-labels'
 import { error_text } from '#scripts/lib/error-message'
 import { epic_close_comment } from './epic-close-comment'
 import { epic_parse, type ExternalChild } from './epic-parse'
@@ -296,6 +296,7 @@ async function close_parents_of(
 	const closed: Array<number> = []
 
 	for (const epic of parents_of(open_epics, child_number)) {
+		// eslint-disable-next-line no-await-in-loop -- each close updates the evaluated set the next one reads
 		const number = await close_if_unseen(epic, child_number, evaluated)
 		if (number !== undefined) closed.push(number)
 	}
@@ -311,6 +312,7 @@ async function close_next_level(
 	const next: Array<number> = []
 
 	for (const child_number of frontier) {
+		// eslint-disable-next-line no-await-in-loop -- each close updates the evaluated set the next one reads
 		next.push(...(await close_parents_of(open_epics, child_number, evaluated)))
 	}
 
@@ -328,6 +330,7 @@ async function cascade_close(
 
 	for (let depth = 0; depth < MAX_CASCADE_DEPTH; depth++) {
 		if (frontier.length === 0) return
+		// eslint-disable-next-line no-await-in-loop -- the cascade closes one level before reading the next
 		frontier = await close_next_level(open_epics, frontier, evaluated)
 	}
 

package/scripts/epic/epic-cross-repo.ts

@@ -1,7 +1,7 @@
 import { repo_map_logic } from '#scripts/discovery/repo-map-logic'
 import { repo_origin } from '#scripts/discovery/repo-origin'
-import { git_gh_api_path } from '#scripts/git/git-gh-api-path'
-import { git_gh_exec } from '#scripts/git/git-gh-exec'
+import { git_gh_api_path } from '#scripts/gh/git-gh-api-path'
+import { git_gh_exec } from '#scripts/gh/git-gh-exec'
 import { propagate_publish } from '#scripts/propagate/propagate-publish'
 import { derive_versions_endpoint } from '#scripts/version/version-command-config'
 import { load } from 'js-yaml'
@@ -336,11 +336,9 @@ function is_same_owner_repo(repo: string, current_owner: string): boolean {
 
 const epic_cross_repo = {
 	publishes_nothing,
-	read_manifest,
 	read_default_branch_version,
 	reset_publish_cache,
 	package_name_for,
-	is_published,
 	resolve_cross_repo,
 	owner_of,
 	is_same_owner_repo,

package/scripts/epic/epic-decision.ts

@@ -158,7 +158,6 @@ function read_recorded_reasons(body: string | undefined): string {
 }
 
 const epic_decision = {
-	DECISIONS_HEADING,
 	append_decision,
 	append_replacements,
 	read_recorded_reasons,

package/scripts/epic/epic-fetch.ts

@@ -1,5 +1,5 @@
-import { git_gh_command } from '#scripts/git/git-gh-command'
-import type { IssueReadFailure } from '#scripts/git/git-gh-issue-read'
+import { git_gh_command } from '#scripts/gh/git-gh-command'
+import type { IssueReadFailure } from '#scripts/gh/git-gh-issue-read'
 import { epic_cross_repo } from './epic-cross-repo'
 import type { EpicChild, IssueReference } from './epic-graph'
 import { epic_issue, type EpicIssue } from './epic-issue'

package/scripts/epic/epic-index.ts

@@ -1,8 +1,8 @@
-import { git_gh_command } from '#scripts/git/git-gh-command'
-import { EPIC_LABEL, has_any_label } from '#scripts/git/issue-labels'
+import { git_gh_command } from '#scripts/gh/git-gh-command'
 import { cutoff_of, type ScanCutoff } from '#scripts/git/listing-cutoff'
 import { parse_json_array_or_undefined } from '#scripts/git/parse-json-array'
 import type { OpenIssueData } from '#scripts/git/schemas'
+import { EPIC_LABEL, has_any_label } from '#scripts/issue/issue-labels'
 import { z } from 'zod'
 import { epic_parse } from './epic-parse'
 
@@ -200,7 +200,6 @@ const epic_index = {
 	build_epic_index,
 	build_tracking_index,
 	fetch_epics,
-	opted_in_epic_numbers,
 	reachable_epic_numbers,
 	withheld_children,
 }

package/scripts/epic/epic-issue.ts

@@ -1,4 +1,4 @@
-import { git_gh_issue_rest } from '#scripts/git/git-gh-issue-rest'
+import { git_gh_issue_rest } from '#scripts/gh/git-gh-issue-rest'
 import { parse_json_object_safe } from '#scripts/git/parse-json-array'
 import { blocked_by_schema } from '#scripts/git/schemas'
 import { z } from 'zod'
@@ -77,18 +77,6 @@ function blocker_references_of(
 	)
 }
 
-// The same blockers as bare numbers, for the callers that predate the qualified read: the planner and
-// the bundler. A projection of the read above rather than a second unwrapping of the connection.
-//
-// **The number alone is lossy, and those callers inherit that.** A blocker in another repository
-// collapses to its number here and can then match a local issue that happens to share it —
-// joshuafolkken/kit#1130 carries the case, which is `epic:bundle` reading a false relation and
-// recording one onto the wrong issue. It predates joshuafolkken/kit#1126 rather than being introduced
-// by it, and threading the repository through the bundler is its own change with its own reach.
-function blockers_of(issue: EpicIssue): Array<number> {
-	return blocker_references_of(issue).map((blocker) => blocker.number)
-}
-
 function label_names(issue: EpicIssue): Array<string> {
 	return issue.labels.map((label) => label.name)
 }
@@ -157,9 +145,7 @@ function parse_epic_reference(raw = ''): EpicReference | undefined {
 const epic_issue = {
 	CLOSED,
 	blocker_references_of,
-	UNKNOWN_STATE,
 	parse_epic_issue,
-	blockers_of,
 	label_names,
 	normalize_state,
 	is_open,

package/scripts/epic/epic-lane-offer.ts

@@ -9,6 +9,7 @@ import { epic_graph, type EpicChild } from './epic-graph'
 import { epic_rank } from './epic-rank'
 import type { EpicVerdict } from './epic-report'
 import { epic_solo } from './epic-solo'
+import { epic_solo_stale } from './epic-solo-stale'
 import { epic_triage, type TriageVerdict } from './epic-triage'
 
 // Which children a repository has room to start right now (joshuafolkken/kit#1491).
@@ -168,6 +169,7 @@ async function collect(
 	for (const pool of pools) {
 		if (children.length >= wanted) break
 
+		// eslint-disable-next-line no-await-in-loop -- pools are asked in order until enough children are found
 		const answer = await ask_pool(pool, wanted - children.length)
 
 		children.push(...answer.children)
@@ -228,7 +230,13 @@ async function offer_for_repo(
 
 	if (triage !== undefined) return triage
 
-	const read = await epic_busy.read_repository(request.repo)
+	const { read, notice } = await epic_solo_stale.release(
+		await epic_busy.read_repository(request.repo),
+		request.repo,
+	)
+
+	if (notice !== undefined) console.error(notice)
+
 	const free = free_lanes(read, request.limit)
 
 	if (free === NO_LANES) {
@@ -245,15 +253,8 @@ async function offer_for_repo(
 }
 
 const epic_lane_offer = {
-	is_held,
-	free_lanes,
-	wanted_of,
 	combine_verdicts,
-	candidates_in,
-	unseen_candidates,
 	dedupe_pools,
-	withheld_message,
-	collect,
 	offer_for_repo,
 }
 

package/scripts/epic/epic-nested.ts

@@ -1,4 +1,4 @@
-import { EPIC_LABEL, has_label_name } from '#scripts/git/issue-labels'
+import { EPIC_LABEL, has_label_name } from '#scripts/issue/issue-labels'
 import type { EpicChild } from './epic-graph'
 
 // Whether a task-list row points at another epic (joshuafolkken/kit#1476).

package/scripts/epic/epic-next-read.ts

@@ -118,6 +118,7 @@ async function read_snapshots(
 	const notices: Array<string> = []
 
 	for (const reference of unique_references(references, current_repo)) {
+		// eslint-disable-next-line no-await-in-loop -- the first refusal ends the read, so later reads are not spent
 		const outcome = await read_one(reference, current_repo)
 
 		if (outcome.refusal !== undefined) return { reads, notices, refusal: outcome.refusal }
@@ -129,11 +130,8 @@ async function read_snapshots(
 
 const epic_next_read = {
 	FOREIGN_EPIC,
-	epic_repo_of,
 	childless,
 	unique_references,
-	is_childless,
-	read_one,
 	read_snapshots,
 }
 

package/scripts/epic/epic-next-views.ts

@@ -132,7 +132,6 @@ function settle_views(
 const epic_next_views = {
 	settle_views,
 	format_reference,
-	confirm_context,
 	pools_of,
 	combined_verdict,
 	error_view,

package/scripts/epic/epic-next.ts

@@ -1,7 +1,7 @@
 #!/usr/bin/env tsx
 import { fileURLToPath } from 'node:url'
 import { repo_discovery } from '#scripts/discovery/repo-discovery'
-import { git_gh_command } from '#scripts/git/git-gh-command'
+import { git_gh_command } from '#scripts/gh/git-gh-command'
 import { PROJECT_ROOT } from '#scripts/init/init-paths'
 import { josh_environment_file } from '#scripts/josh/josh-environment-file'
 import { lane_capacity } from '#scripts/lane/lane-capacity'
@@ -441,27 +441,18 @@ async function main(argv: ReadonlyArray<string>): Promise<void> {
 }
 
 const epic_next = {
-	USAGE,
 	EXTERNAL_NOTICE,
 	FOREIGN_EPIC,
-	body_anomaly,
-	unreadable_anomaly,
 	is_order_declared,
 	repo_verdict,
-	offer_children,
-	report_offer,
 	UNCHECKED_EXCLUSION,
 	split_at_flag,
-	parse_references,
 	parse_options,
-	note_external,
 	refuse_reads,
 	views_of,
 	run_epics,
 	decide,
 	report,
-	run,
-	main,
 }
 
 // `.env` is read here rather than through the dispatcher's `tsx_arguments`: declaring any would

package/scripts/epic/epic-parse.ts

@@ -310,7 +310,6 @@ const epic_parse = {
 	fence_mask,
 	is_task_list_line,
 	is_declaration_line,
-	chain_links,
 	parse_dependency_chains,
 	parse_task_list_issue_numbers,
 	has_external_task_list_entry,

package/scripts/epic/epic-promote.ts

@@ -1,14 +1,6 @@
 import { epic_body } from './epic-body'
 import { epic_parse } from './epic-parse'
 
-// Promoting an existing issue into an epic.
-//
-// The discussion that concluded "this is really several issues" is almost always *inside* an
-// existing issue, and that discussion is usually the split rationale itself. Creating a separate
-// epic leaves two issues tracking one topic, so the promotion appends the epic's sections to the
-// body rather than replacing it (joshuafolkken/kit#865).
-
-const EPIC_SECTION_MARKER = '## Progress'
 const PROMOTED_HEADING = '## Split into children'
 
 interface PromoteInput {
@@ -90,7 +82,6 @@ function find_tracking_error(body: string, children: ReadonlyArray<number>): str
 }
 
 const epic_promote = {
-	EPIC_SECTION_MARKER,
 	PROMOTED_HEADING,
 	has_conflicting_tracking,
 	conflict_reason,

package/scripts/epic/epic-rank.ts

@@ -1,4 +1,4 @@
-import { issue_rank } from '#scripts/git/issue-rank'
+import { issue_rank } from '#scripts/issue/issue-rank'
 import { epic_graph, type EpicChild } from './epic-graph'
 
 // `issue-rank.ts`'s keys over graph children (joshuafolkken/kit#2928), for both offer paths that hand
@@ -32,6 +32,6 @@ function rank(
 	}))
 }
 
-const epic_rank = { dependents_of, rank }
+const epic_rank = { rank }
 
 export { epic_rank }

package/scripts/epic/epic-read.ts

@@ -1,4 +1,4 @@
-import { git_gh_command } from '#scripts/git/git-gh-command'
+import { git_gh_command } from '#scripts/gh/git-gh-command'
 import { epic_fetch } from './epic-fetch'
 import { epic_graph, type EpicChild } from './epic-graph'
 import { epic_parse } from './epic-parse'
@@ -65,7 +65,6 @@ async function read_epic(epic_number: number): Promise<EpicReading | { error: st
 }
 
 const epic_read = {
-	UNKNOWN_REPO,
 	read_epic,
 }
 

package/scripts/epic/epic-reconcile.ts

@@ -1,4 +1,4 @@
-import { git_gh_command } from '#scripts/git/git-gh-command'
+import { git_gh_command } from '#scripts/gh/git-gh-command'
 import { epic_add_body } from './epic-add-body'
 import { epic_chains } from './epic-chains'
 import { epic_graph, type EpicChild, type IssueReference } from './epic-graph'

package/scripts/epic/epic-reference.ts

@@ -54,20 +54,8 @@ function format_replaced_relations(links: ReadonlyArray<DependencyLink>): string
 	return `Replaced blocked-by: ${join_references(quoted)}.`
 }
 
-const epic_reference = {
-	DEPENDENCY_ARROW,
-	REFERENCE_SEPARATOR,
-	to_issue_reference,
-	join_references,
-	format_dependency_link,
-	format_dependency_links,
-	format_issue_references,
-	format_replaced_relations,
-}
-
-export type { IssueReference } from '#scripts/git/issue-reference'
+export type { IssueReference } from '#scripts/issue/issue-reference'
 export {
-	epic_reference,
 	DEPENDENCY_ARROW,
 	REFERENCE_SEPARATOR,
 	to_issue_reference,

package/scripts/epic/epic-relation-recheck.ts

@@ -103,7 +103,7 @@ async function recheck_missing_relations(
 	)
 }
 
-const epic_relation_recheck = { recheck_missing_relations, suspect_children, RECHECK_LIMIT }
+const epic_relation_recheck = { recheck_missing_relations, RECHECK_LIMIT }
 
 export type { BlockersReader }
 export { epic_relation_recheck }

package/scripts/epic/epic-relations.ts

@@ -1,4 +1,4 @@
-import { git_gh_command } from '#scripts/git/git-gh-command'
+import { git_gh_command } from '#scripts/gh/git-gh-command'
 import type { DependencyLink } from './epic-parse'
 import { format_dependency_links } from './epic-reference'
 

package/scripts/epic/epic-remove.ts

@@ -1,4 +1,4 @@
-import { git_gh_command } from '#scripts/git/git-gh-command'
+import { git_gh_command } from '#scripts/gh/git-gh-command'
 import { epic_decision } from './epic-decision'
 import { epic_read } from './epic-read'
 import { format_dependency_links } from './epic-reference'

package/scripts/epic/epic-report.ts

@@ -193,7 +193,6 @@ const epic_report = {
 	build_result,
 	candidates_for_repo,
 	format_result,
-	VERDICT_LINES,
 }
 
 export type { EpicNextResult, EpicVerdict, RepoCandidates }

package/scripts/epic/epic-run.ts

@@ -1,5 +1,5 @@
-import { git_gh_command } from '#scripts/git/git-gh-command'
-import { EPIC_LABEL } from '#scripts/git/issue-labels'
+import { git_gh_command } from '#scripts/gh/git-gh-command'
+import { EPIC_LABEL } from '#scripts/issue/issue-labels'
 import { epic_body } from './epic-body'
 import { epic_promote } from './epic-promote'
 import { epic_relations } from './epic-relations'
@@ -213,7 +213,6 @@ async function check_epic(epic_number: number): Promise<number> {
 }
 
 const epic_run = {
-	parse_created_number,
 	create_epic,
 	promote_epic,
 	check_epic,

package/scripts/epic/epic-shape.ts

@@ -1,4 +1,4 @@
-import { EPIC_LABEL } from '#scripts/git/issue-labels'
+import { EPIC_LABEL } from '#scripts/issue/issue-labels'
 import { epic_parse } from './epic-parse'
 import { to_issue_reference } from './epic-reference'
 

package/scripts/epic/epic-solo-stale.ts

@@ -0,0 +1,107 @@
+import { setTimeout as sleep } from 'node:timers/promises'
+import type { OpenIssueData } from '#scripts/git/schemas'
+import { has_any_label, IN_PROGRESS_LABEL, RUN_SOLO_LABEL } from '#scripts/issue/issue-labels'
+import { lane_await } from '#scripts/lane/lane-await'
+import { lane_registry } from '#scripts/lane/lane-registry'
+import { issue_citation } from '#scripts/rules/issue-citation'
+import type { BusyRead } from './epic-busy'
+
+// A `run:solo` holder nothing is running for (joshuafolkken/kit#3017).
+//
+// A running `run:solo` issue lets nothing new start (`epic-solo.ts`), and "running" is read off the
+// `in-progress` label alone. A label nothing removed — a child that parked itself, then had its
+// `needs-decision` lifted by a person — therefore held the whole backlog: every candidate went to
+// `waiting`, no lane was running to release it, and `backlog:offer` booked the run `exhausted`.
+//
+// **What decides it is the child's process, not its lane.** The lane of a child that parked itself
+// stays open after the child has ended, so an open lane is no evidence of a run; the process pattern
+// `lane:await` and `run:liveness` read is. A matching process keeps the holder, whatever its lane.
+//
+// **A missing process releases only what this machine dispatched, and only once re-confirmed.** The
+// process read sees this machine alone, and a session a person started by hand matches no lane
+// pattern, so an absent process is evidence of an ended run only for a holder with a lane here. A
+// boundary cut drops the process for a moment before its resume takes over, so the absence is read
+// again after `lane_await.RECONFIRM_MS` — the window `lane:await` measured for that handoff. Every
+// doubt keeps the holder: a wrongly kept label waits, a wrongly released one runs beside a solo run.
+//
+// Only `run:solo` holders are released: theirs is the one label that blocks every candidate. A stale
+// ordinary holder spends one lane, which `epic_busy.lanes_full_message` already names.
+
+const SOLO_LABELS: ReadonlySet<string> = new Set([RUN_SOLO_LABEL])
+
+interface StaleRelease {
+	read: BusyRead
+	notice?: string
+}
+
+function is_absent_solo(issue: OpenIssueData): boolean {
+	if (!has_any_label(issue.labels, SOLO_LABELS)) return false
+
+	return !lane_await.is_process_running_default(String(issue.number))
+}
+
+// The issue numbers of this checkout's lanes. A listing that cannot be read names none, which keeps
+// every holder.
+async function local_lanes(): Promise<ReadonlySet<string>> {
+	try {
+		const lanes = await lane_registry.list_lanes()
+
+		return new Set(lanes.map((lane) => lane.issue))
+	} catch {
+		return new Set()
+	}
+}
+
+async function settle(): Promise<void> {
+	await sleep(lane_await.RECONFIRM_MS)
+}
+
+// Read through this object so a test can stand in for the git listing and the re-confirm wait.
+const io = { local_lanes, settle }
+
+async function find_stale(
+	issues: ReadonlyArray<OpenIssueData>,
+): Promise<ReadonlyArray<OpenIssueData>> {
+	const absent = issues.filter((issue) => is_absent_solo(issue))
+
+	if (absent.length === 0) return []
+
+	const lanes = await io.local_lanes()
+	const dispatched = absent.filter((issue) => lanes.has(String(issue.number)))
+
+	if (dispatched.length === 0) return []
+
+	await io.settle()
+
+	return dispatched.filter((issue) => is_absent_solo(issue))
+}
+
+function stale_message(stale: ReadonlyArray<OpenIssueData>, repo: string): string {
+	const named = stale.map((issue) => `#${String(issue.number)}`).join(', ')
+
+	return issue_citation.linkify(
+		`${named} carries \`${RUN_SOLO_LABEL}\` and \`${IN_PROGRESS_LABEL}\`, but no process of it is running in ${repo} — the \`${IN_PROGRESS_LABEL}\` label is stale, so it does not hold the backlog. Remove the label once you have confirmed nothing is running it.`,
+		repo,
+	)
+}
+
+// The read with every stale `run:solo` holder taken out, and the sentence naming them. A read with no
+// holder left is `idle`, exactly as `epic_busy.parse_listing` answers an empty listing.
+async function release(read: BusyRead, repo: string): Promise<StaleRelease> {
+	if (read.kind !== 'busy') return { read }
+
+	const stale = await find_stale(read.issues)
+
+	if (stale.length === 0) return { read }
+
+	const holders = read.issues.filter((issue) => !stale.includes(issue))
+	const released: BusyRead =
+		holders.length > 0 ? { kind: 'busy', issues: holders } : { kind: 'idle' }
+
+	return { read: released, notice: stale_message(stale, repo) }
+}
+
+const epic_solo_stale = { io, release }
+
+export type { StaleRelease }
+export { epic_solo_stale }

package/scripts/epic/epic-solo.ts

@@ -1,4 +1,4 @@
-import { has_any_label, has_label_name, RUN_SOLO_LABEL } from '#scripts/git/issue-labels'
+import { has_any_label, has_label_name, RUN_SOLO_LABEL } from '#scripts/issue/issue-labels'
 import { issue_citation } from '#scripts/rules/issue-citation'
 import { epic_busy, type BusyRead } from './epic-busy'
 import type { EpicChild } from './epic-graph'
@@ -15,7 +15,8 @@ import { epic_report, type EpicNextResult } from './epic-report'
 // `epic:next --lanes` (a named epic's children, `epic-lane-offer.ts`). One rule, so the two cannot
 // disagree about what may start beside what.
 //
-// Three rules, all against the repository's `in-progress` holders (`epic_busy.read_repository`):
+// Three rules, all against the repository's `in-progress` holders (`epic_busy.read_repository`, with
+// a stale `run:solo` holder taken out by `epic_solo_stale.release` — joshuafolkken/kit#3017):
 // a running `run:solo` issue lets nothing new start; a `run:solo` candidate starts only into an idle
 // repository and then alone; and nothing ranked below a waiting `run:solo` candidate is offered past
 // it, so it is not starved by the lanes it is waiting on. A listing that could not be read is not an

package/scripts/epic/epic-triage.ts

@@ -1,4 +1,4 @@
-import { has_label_name, RUN_LANE_LABEL, RUN_SOLO_LABEL } from '#scripts/git/issue-labels'
+import { has_label_name, RUN_LANE_LABEL, RUN_SOLO_LABEL } from '#scripts/issue/issue-labels'
 import { issue_citation } from '#scripts/rules/issue-citation'
 import type { EpicChild } from './epic-graph'
 

package/scripts/epic/epic-validate.ts

@@ -1,6 +1,6 @@
-import { EPIC_LABEL, has_label_name } from '#scripts/git/issue-labels'
 import { parse_json_object_safe } from '#scripts/git/parse-json-array'
 import { epic_subject_schema } from '#scripts/git/schemas'
+import { EPIC_LABEL, has_label_name } from '#scripts/issue/issue-labels'
 import { epic_parse, type DeclarationState } from './epic-parse'
 
 // The four requirements an epic has to satisfy are otherwise enforced only by an agent reading the