@joshuafolkken/kit 1.1050.0 → 1.1128.0

package/scripts/document/read-files-cli.ts

@@ -122,11 +122,7 @@ function main(argv: ReadonlyArray<string>): void {
 
 const read_files_cli = {
 	OVER_CAP_PREFIX,
-	READ_TOOL_DIRECTIVE,
-	SUCCESS_EXIT_CODE,
 	USAGE,
-	main,
-	over_cap_directive,
 	run,
 }
 

package/scripts/document/read-set-cli.ts

@@ -282,10 +282,8 @@ const read_set_cli = {
 	POINT_OF_USE_LABEL,
 	SCOPED_LABEL,
 	TOTAL_READ_LABEL,
-	USAGE,
 	WHOLE_LABEL,
 	known_entries,
-	main,
 	run,
 	saved_percent,
 }

package/scripts/document/read-set-point-of-use.ts

@@ -62,6 +62,7 @@ const POINT_OF_USE_BY_ENTRY: ReadonlyMap<string, ReadonlySet<string>> = new Map(
 	['kickoff', DEFERRED_DECISIONS],
 	['fullrun', DEFERRED_DECISIONS],
 	['halfrun', DEFERRED_DECISIONS],
+	['prrun', DEFERRED_DECISIONS],
 	['backlogrun', new Set([...DEFERRED_DECISIONS, 'fullrun.md', 'split-assessment.md'])],
 ])
 
@@ -74,9 +75,14 @@ function is_point_of_use(entry: string, file: string): boolean {
 	return (POINT_OF_USE_BY_ENTRY.get(entry) ?? NO_PER_ENTRY_FILES).has(file)
 }
 
-// The global point-of-use files plus the ones this entry names in its own row.
-function point_of_use_files(entry: string): Array<string> {
-	return [...POINT_OF_USE_FILES, ...(POINT_OF_USE_BY_ENTRY.get(entry) ?? NO_PER_ENTRY_FILES)]
+// **Only the global files the entry reaches, plus the ones this entry names in its own row**
+// (joshuafolkken/kit#3078). `cited` is every document the entry's path names; a global file outside it
+// is one this entry never opens — a `kickoff` never issues `followup` — so charging it made every
+// entry's total the same figure and the per-entry ratchet measured nothing.
+function point_of_use_files(entry: string, cited: ReadonlySet<string>): Array<string> {
+	const reached = [...POINT_OF_USE_FILES].filter((file) => cited.has(file))
+
+	return [...reached, ...(POINT_OF_USE_BY_ENTRY.get(entry) ?? NO_PER_ENTRY_FILES)]
 }
 
 const read_set_point_of_use = {

package/scripts/document/read-set-pricing.ts

@@ -45,7 +45,6 @@ function dollars_per_run(tokens: number): number {
 
 const read_set_pricing = {
 	ASSUMED_REQUESTS,
-	REFERENCE_MODEL,
 	dollars_per_run,
 }
 

package/scripts/document/read-set-trim.ts

@@ -24,6 +24,8 @@ interface TrimSpec {
 	unused_skill_sections: ReadonlyArray<string>
 	// The point-of-use documents this role's parent owns; empty when the role owns them all.
 	skipped_point_of_use: ReadonlySet<string>
+	// The point-of-use documents this role reaches that its base entry's path does not name.
+	reached_point_of_use: ReadonlySet<string>
 }
 
 function subtract(left: Cost, right: Cost): Cost {
@@ -59,7 +61,7 @@ function reduce_skill(file: FileCost, saving: Cost): FileCost {
 // **`whole` and `scoped` both carry the own-files cost identically**, so the `SKILL.md` saving lands
 // on each by the same amount — there is no need to re-derive the referenced-section split.
 function costed(root: string, spec: TrimSpec): ReadSetCost {
-	const base = entry_read_set.costed(root, spec.base_entry)
+	const base = entry_read_set.costed(root, spec.base_entry, spec.reached_point_of_use)
 	const saving = unused_skill_cost(root, spec.unused_skill_sections)
 
 	return {
@@ -72,7 +74,7 @@ function costed(root: string, spec: TrimSpec): ReadSetCost {
 	}
 }
 
-const read_set_trim = { costed, unused_skill_cost }
+const read_set_trim = { costed }
 
 export type { TrimSpec }
 export { read_set_trim }

package/scripts/epic/epic-add.ts

@@ -1,5 +1,5 @@
 import { backlog_ready } from '#scripts/backlog/backlog-ready'
-import { git_gh_command } from '#scripts/git/git-gh-command'
+import { git_gh_command } from '#scripts/gh/git-gh-command'
 import { epic_add_plan, type AddPlan } from './epic-add-plan'
 import type { InsertPosition } from './epic-chains'
 import { epic_decision } from './epic-decision'

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

@@ -1,6 +1,6 @@
 #!/usr/bin/env tsx
 import { fileURLToPath } from 'node:url'
-import { git_gh_command } from '#scripts/git/git-gh-command'
+import { git_gh_command } from '#scripts/gh/git-gh-command'
 import { issue_read } from '#scripts/issue/issue-read'
 import { epic_audit_logic, type AuditFinding, type ReferenceState } from './epic-audit'
 import { epic_audit_checks, type AuditChild } from './epic-audit-checks'
@@ -356,16 +356,13 @@ async function main(argv: ReadonlyArray<string>): Promise<void> {
 }
 
 const epic_audit_cli = {
-	USAGE,
 	UNREADABLE_REPO,
 	parse_epic_number: epic_issue.parse_epic_number,
 	attach_bodies,
 	resolve_reference_states,
 	outside_references,
-	read_order_comments,
 	audit,
 	run,
-	main,
 }
 
 if (process.argv[1] === fileURLToPath(import.meta.url)) await main(process.argv.slice(ARGV_OFFSET))

package/scripts/epic/epic-audit-orphans.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 { cutoff_of, PAGE_CEILING_CAUSE, type ScanCutoff } from '#scripts/git/listing-cutoff'
 import { parse_json_array_safe } from '#scripts/git/parse-json-array'
 import { z } from 'zod'
@@ -129,8 +129,6 @@ function locally_tracked(snapshot: EpicSnapshot): Array<number> {
 }
 
 const epic_audit_orphans = {
-	PARENT_MARKERS,
-	ORPHAN_SEARCH,
 	claimed_numbers,
 	claims_parent,
 	find_claiming_issues,

package/scripts/epic/epic-audit-rationale.ts

@@ -181,7 +181,6 @@ function find_unjustified_orders(input: RationaleInput): Array<AuditFinding> {
 }
 
 const epic_audit_rationale = {
-	UNJUSTIFIED_ORDER,
 	order_pairs,
 	pair_ends,
 	find_unjustified_orders,

package/scripts/epic/epic-audit-report.ts

@@ -91,9 +91,7 @@ const epic_audit_report = {
 	PASS_LINE,
 	anomaly_findings,
 	unreadable_findings,
-	has_error,
 	build_result,
-	sort_findings,
 	format_report,
 }
 

package/scripts/epic/epic-audit.ts

@@ -1,3 +1,4 @@
+import { markdown_section } from '#scripts/issue/markdown-section'
 import { epic_graph, type EpicChild, type IssueReference } from './epic-graph'
 
 // Reading an epic's children against each other.
@@ -39,8 +40,10 @@ const REPO_NAME_DOT = '.'
 const NO_KNOWN_REPOS: ReadonlySet<string> = new Set()
 // Where a child states what it must deliver. Both spellings, because the bodies are written in
 // whichever language the session was in.
-const ACCEPTANCE_HEADINGS: ReadonlyArray<string> = ['## 受け入れ条件', '## Acceptance criteria']
-const HEADING_PREFIX = '## '
+const ACCEPTANCE_HEADINGS: ReadonlySet<string> = new Set([
+	'## 受け入れ条件',
+	'## Acceptance criteria',
+])
 
 type FindingLevel = 'error' | 'warning'
 
@@ -163,29 +166,14 @@ function parse_references(text: string, repo = ''): Array<number> {
 }
 
 function is_acceptance_heading(line: string): boolean {
-	return ACCEPTANCE_HEADINGS.includes(line.trim())
+	return ACCEPTANCE_HEADINGS.has(line.trim())
 }
 
-function is_heading(line: string): boolean {
-	return line.trimStart().startsWith(HEADING_PREFIX)
-}
-
-// The lines under the acceptance-criteria heading, up to the next `##`. Shaped like the other
-// section readers in this repository, for the same reason: a regex spanning the block backtracks.
-function section_lines(lines: ReadonlyArray<string>): Array<string> {
-	const start = lines.findIndex((line) => is_acceptance_heading(line))
-	if (start === -1) return []
-	const rest = lines.slice(start + 1)
-	const end = rest.findIndex((line) => is_heading(line))
-
-	return end === -1 ? rest : rest.slice(0, end)
-}
-
-// The acceptance-criteria section of a child's body, or an empty string.
+// The acceptance-criteria section of a child's body, up to the next unfenced `##`, or an empty string.
 function acceptance_section(body: string | undefined): string {
 	if (body === undefined) return ''
 
-	return section_lines(body.split('\n')).join('\n')
+	return markdown_section.section_lines_matching(body, is_acceptance_heading).join('\n')
 }
 
 // Everything `node` depends on, directly or through a chain. Walked iteratively so a graph that
@@ -226,13 +214,11 @@ function depends_on(
 // a `#` lives in `prefix_before`, so the pattern on its own matches the tail of `owner/repo#12` —
 // the very reading this module exists to prevent.
 const epic_audit_logic = {
-	ACCEPTANCE_HEADINGS,
 	unique_references,
 	known_repos,
 	parse_issue_references,
 	parse_references,
 	acceptance_section,
-	collect_blockers,
 	depends_on,
 }
 

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

@@ -1,6 +1,6 @@
 #!/usr/bin/env tsx
 import { fileURLToPath } from 'node:url'
-import { git_gh_command } from '#scripts/git/git-gh-command'
+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 { bounded_pool } from '#scripts/lib/bounded-pool'

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

@@ -139,7 +139,6 @@ function format_evidence(
 
 const epic_bundle_evidence = {
 	EVIDENCE_HEADING,
-	ordering_evidence,
 	format_evidence,
 }
 

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 }