@joshuafolkken/kit 1.1010.0 → 1.1050.0

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

@@ -1,7 +1,5 @@
 #!/usr/bin/env tsx
 import { fileURLToPath } from 'node:url'
-import { git_epic_decision } from '#scripts/git/git-epic-decision'
-import { git_epic_parse, type DependencyLink } from '#scripts/git/git-epic-parse'
 import { git_gh_command } from '#scripts/git/git-gh-command'
 import { issue_read } from '#scripts/issue/issue-read'
 import { epic_audit_logic, type AuditFinding, type ReferenceState } from './epic-audit'
@@ -10,10 +8,12 @@ import { epic_audit_orphans, type ClaimingSearch } from './epic-audit-orphans'
 import { epic_audit_rationale, type OrderPair } from './epic-audit-rationale'
 import { epic_audit_report, type AuditResult } from './epic-audit-report'
 import { epic_cross_repo } from './epic-cross-repo'
+import { epic_decision } from './epic-decision'
 import { epic_fetch, type EpicSnapshot } from './epic-fetch'
 import { epic_graph, type IssueReference } from './epic-graph'
 import { epic_issue } from './epic-issue'
 import { epic_next } from './epic-next'
+import { epic_parse, type DependencyLink } from './epic-parse'
 
 // `josh epic:audit <E>` — read an epic's children against each other and report what contradicts
 // what (joshuafolkken/kit#870).
@@ -278,7 +278,7 @@ async function to_audit_input(
 	epic_number: number,
 	repo: string,
 ): Promise<AuditInput> {
-	const links = git_epic_parse.parse_dependency_links(snapshot.body)
+	const links = epic_parse.parse_dependency_links(snapshot.body)
 	const order_pairs = epic_audit_rationale.order_pairs(links, children, snapshot.repo, repo)
 
 	return {
@@ -291,7 +291,7 @@ async function to_audit_input(
 		anomalies: fetch_anomalies(snapshot, children, links),
 		contradictions: epic_audit_checks.find_order_contradictions(children, repo),
 		order_pairs,
-		decisions: git_epic_decision.read_recorded_reasons(snapshot.body),
+		decisions: epic_decision.read_recorded_reasons(snapshot.body),
 		order_comments: await read_order_comments(order_pairs),
 		is_epic_closed: await read_epic_closed(epic_number, epic_fetch.scope_for(snapshot.repo, repo)),
 	}

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

@@ -1,10 +1,10 @@
-import { git_epic_parse } from '#scripts/git/git-epic-parse'
 import { git_gh_command } from '#scripts/git/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'
 import { epic_audit_logic, type AuditFinding, type FindingLevel } from './epic-audit'
 import type { EpicSnapshot } from './epic-fetch'
+import { epic_parse } from './epic-parse'
 
 // Check 4's half of `epic:audit`: an issue that names this epic as its parent but that the epic's
 // task list does not track. It would never be run, and the epic would close without it.
@@ -125,7 +125,7 @@ function claimed_numbers(search: ClaimingSearch): Array<number> {
 // reported (joshuafolkken/kit#1014). Read with the same parser `epic_fetch` reads the local rows
 // with, which never matches a `- [ ] owner/repo#N` row.
 function locally_tracked(snapshot: EpicSnapshot): Array<number> {
-	return git_epic_parse.parse_task_list_issue_numbers(snapshot.body)
+	return epic_parse.parse_task_list_issue_numbers(snapshot.body)
 }
 
 const epic_audit_orphans = {

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

@@ -1,7 +1,7 @@
-import type { DependencyLink } from '#scripts/git/git-epic-parse'
 import { epic_audit_logic, type AuditFinding } from './epic-audit'
 import type { AuditChild } from './epic-audit-checks'
 import { epic_graph, type IssueReference } from './epic-graph'
+import type { DependencyLink } from './epic-parse'
 
 // Check 6 — a declared order between two open children that nobody wrote a reason for
 // (joshuafolkken/kit#1712).

package/scripts/epic/epic-audit.ts

@@ -20,7 +20,7 @@ const REFERENCE_PATTERN = /#(\d+)\b/gu
 // What may appear in the `owner/repo` written in front of a `#`: exactly the set the previous
 // lookbehind refused a bare reference after, plus the `.` a repository name may legitimately contain.
 //
-// The dot is where this parse and the task-list parse used to disagree. `git_epic_parse`'s
+// The dot is where this parse and the task-list parse used to disagree. `epic_parse`'s
 // `EXTERNAL_REFERENCE_SOURCE` allows one, so `- [ ] owner/site.com#40` is tracked as a genuine
 // cross-repository child; this one excluded it, so a sibling quoting `owner/site.com#40` was read
 // back as `com` — no repository — and every check skipped it in silence. A child that can be tracked

package/scripts/{git/git-epic-body.ts → epic/epic-body.ts}

@@ -1,7 +1,7 @@
-import { UNORDERED_DEPENDENCIES } from './git-epic-parse'
-import { DEPENDENCY_ARROW, to_issue_reference } from './git-epic-reference'
+import { UNORDERED_DEPENDENCIES } from './epic-parse'
+import { DEPENDENCY_ARROW, to_issue_reference } from './epic-reference'
 
-// The epic body is the machine-readable half of the epic contract: `scripts/git/git-epic-close.ts`
+// The epic body is the machine-readable half of the epic contract: `scripts/epic/epic-close.ts`
 // reads the task list to decide when the batch is finished, and the order-unrecorded warning reads
 // the `Dependencies` section. Generating both from the same input is what keeps them from
 // disagreeing with each other, or with the run command printed next to them.
@@ -25,7 +25,7 @@ interface EpicBodyInput {
 	epic_number?: number | undefined
 }
 
-// Task-list syntax, never a bare `#N` link: `git_epic_parse.parse_task_list_issue_numbers` matches
+// Task-list syntax, never a bare `#N` link: `epic_parse.parse_task_list_issue_numbers` matches
 // nothing else, and GitHub only auto-checks a row written this way.
 function format_progress(children: ReadonlyArray<number>): string {
 	return children.map((child) => `- [ ] ${to_issue_reference(child)}`).join('\n')
@@ -139,12 +139,12 @@ function build_dependency_pairs(
 		.filter((pair) => pair.blocked !== pair.blocker)
 }
 
-const git_epic_body = {
+const epic_body = {
 	EPIC_PLACEHOLDER,
 	build_epic_body,
 	build_dependency_pairs,
 	format_run_command,
 }
 
-export { git_epic_body, SPLIT_RATIONALE_HEADING }
+export { epic_body, SPLIT_RATIONALE_HEADING }
 export type { EpicBodyInput }

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

@@ -1,6 +1,5 @@
 #!/usr/bin/env tsx
 import { fileURLToPath } from 'node:url'
-import type { IssueReference } from '#scripts/git/git-epic-reference'
 import { git_gh_command } from '#scripts/git/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'
@@ -18,6 +17,7 @@ import { epic_bundle_gaps } from './epic-bundle-gaps'
 import { epic_bundle_referenced, type ReferencedContext } from './epic-bundle-referenced'
 import { epic_index, epic_schema, type FetchedEpics } from './epic-index'
 import { epic_issue } from './epic-issue'
+import type { IssueReference } from './epic-reference'
 
 // `josh epic:bundle <N>` — after an issue is filed, look at the open backlog and say whether it
 // belongs with something already there (joshuafolkken/kit#873).

package/scripts/epic/epic-bundle.ts

@@ -1,7 +1,7 @@
-import type { DependencyLink } from '#scripts/git/git-epic-parse'
-import type { IssueReference } from '#scripts/git/git-epic-reference'
 import { epic_audit_logic } from './epic-audit'
 import { epic_graph } from './epic-graph'
+import type { DependencyLink } from './epic-parse'
+import type { IssueReference } from './epic-reference'
 
 // Bundling a newly filed issue with the ones it turns out to be related to.
 //

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

@@ -1,3 +1,4 @@
+import { error_text } from '#scripts/lib/error-message'
 import { epic_classify, type ResolveDependency } from './epic-classify'
 import { epic_graph, type EpicChild, type IssueReference } from './epic-graph'
 import type { BlockersReader } from './epic-relation-recheck'
@@ -118,7 +119,7 @@ async function read_or_withhold(
 	try {
 		return await read_blockers(candidate)
 	} catch (error) {
-		const reason = error instanceof Error ? error.message : String(error)
+		const reason = error_text.message_of(error)
 
 		console.warn(
 			`⚠ could not confirm the blockers of #${String(candidate.number)}: ${reason}\n` +

package/scripts/{git/git-epic-chains.ts → epic/epic-chains.ts}

@@ -1,5 +1,5 @@
-import { chain_links, type DependencyLink } from './git-epic-parse'
-import { DEPENDENCY_ARROW, format_dependency_link, to_issue_reference } from './git-epic-reference'
+import { chain_links, type DependencyLink } from './epic-parse'
+import { DEPENDENCY_ARROW, format_dependency_link, to_issue_reference } from './epic-reference'
 
 // The declared dependency order of an epic, as the shape an insertion needs.
 //
@@ -392,7 +392,7 @@ function insert_children(
 	return duplicated === undefined ? outcome : { error: already_declared_error(duplicated) }
 }
 
-const git_epic_chains = {
+const epic_chains = {
 	render_chains,
 	links_of,
 	diff_links,
@@ -407,5 +407,5 @@ const git_epic_chains = {
 	insert_children,
 }
 
-export { git_epic_chains }
+export { epic_chains }
 export type { Chain, Chains, InsertKind, InsertOutcome, InsertPosition, LinkDiff }

package/{scripts-ai → scripts/epic}/epic-check.ts

@@ -2,10 +2,11 @@
 /**
  * Check an existing epic Issue against the four requirements, reporting each as pass or fail.
  *
- * Usage: tsx scripts-ai/epic-check.ts <issue-number>
+ * Usage: tsx scripts/epic/epic-check.ts <issue-number>
  */
-import { git_epic_run } from '../scripts/git/git-epic-run'
+import { error_text } from '#scripts/lib/error-message'
 import { epic_cli } from './epic-cli'
+import { epic_run } from './epic-run'
 
 const ARGV_OFFSET = 2
 const USAGE = 'Usage: josh epic:check <issue-number>'
@@ -19,7 +20,7 @@ async function main(): Promise<void> {
 		process.exit(FAILURE_EXIT_CODE)
 	}
 
-	const exit_code = await git_epic_run.check_epic(epic_number)
+	const exit_code = await epic_run.check_epic(epic_number)
 
 	if (exit_code !== 0) process.exit(exit_code)
 }
@@ -29,6 +30,6 @@ async function main(): Promise<void> {
 try {
 	await main()
 } catch (error) {
-	console.error(`✖ ${error instanceof Error ? error.message : String(error)}`)
+	console.error(`✖ ${error_text.message_of(error)}`)
 	process.exit(FAILURE_EXIT_CODE)
 }

package/{scripts-ai → scripts/epic}/epic-cli.ts

@@ -1,8 +1,8 @@
-import type { InsertKind, InsertPosition } from '../scripts/git/git-epic-chains'
-import { git_epic_parse, type ExternalChild } from '../scripts/git/git-epic-parse'
-import { cli_body } from '../scripts/josh/cli-body'
+import { cli_body } from '#scripts/josh/cli-body'
+import type { InsertKind, InsertPosition } from './epic-chains'
 import { epic_cli_argv, ISSUE_NUMBER_PATTERN } from './epic-cli-argv'
 import { epic_cli_remove } from './epic-cli-remove'
+import { epic_parse, type ExternalChild } from './epic-parse'
 
 // Parsing lives apart from the entry point so the argument rules can be asserted without spawning a
 // process or reaching GitHub. The entry point is then a thin shell around these two functions.
@@ -290,7 +290,7 @@ interface CrossRepoAddTarget {
 function find_cross_repo_add_target(argv: ReadonlyArray<string>): CrossRepoAddTarget | undefined {
 	const [raw_epic] = to_positional_arguments(argv, ADD_VALUE_FLAGS)
 	if (raw_epic === undefined) return undefined
-	const epic = git_epic_parse.parse_external_reference(raw_epic)
+	const epic = epic_parse.parse_external_reference(raw_epic)
 	if (epic === undefined) return undefined
 
 	const local = parse_add_arguments(

package/scripts/{git/git-epic-close-comment.ts → epic/epic-close-comment.ts}

@@ -1,12 +1,12 @@
-import { git_epic_parse, type ExternalChild } from './git-epic-parse'
-import { git_gh_command } from './git-gh-command'
-import { read_json_listing } from './parse-json-array'
-import { rest_comment_schema, type RestCommentData } from './schemas'
+import { git_gh_command } from '#scripts/git/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'
 
 // The comment the epic auto-close announces itself with, and how a run recognizes the one a previous
 // run already posted.
 //
-// Kept apart from `git-epic-close.ts` because the two answer different questions — that file decides
+// Kept apart from `epic-close.ts` because the two answer different questions — that file decides
 // *whether* an epic may close, this one decides what the announcement says and whether it is already
 // there — and because the file it was split from is within twenty lines of the three hundred a file
 // may hold (joshuafolkken/kit#1039).
@@ -131,7 +131,7 @@ function is_legacy_announcement(body: string): boolean {
 // both: a listing that could not be read says nothing about what is on the issue, and reporting it
 // as "nothing is there" would have the run state a fact it never established — the misread
 // joshuafolkken/kit#973 and joshuafolkken/kit#959 were each about. Keeping it apart is what lets
-// `git-epic-close.ts` say out loud that the duplicate check did not run, which is the whole
+// `epic-close.ts` say out loud that the duplicate check did not run, which is the whole
 // difference between the two answers there.
 //
 // **Both of `read_json_listing`'s gaps arrive as `unreadable`**, rows the schema rejects included.
@@ -147,7 +147,7 @@ type CloseCommentState = 'present' | 'absent' | 'unreadable'
 // verbatim — a fenced one caught by the mask, an indented one by the indent check. `fence_mask` is the same walk every other body predicate
 // in this codebase reads through, rather than a second one written here (joshuafolkken/kit#890).
 function has_marker(body: string, children: ReadonlyArray<string>): boolean {
-	const mask = git_epic_parse.fence_mask(body)
+	const mask = epic_parse.fence_mask(body)
 
 	return body.split('\n').some((line, index) => {
 		if (mask[index] !== true) return false
@@ -190,10 +190,10 @@ async function read_close_comment_state(
 	return has_announcement(listing.rows, child_references(epic)) ? 'present' : 'absent'
 }
 
-const git_epic_close_comment = {
+const epic_close_comment = {
 	build_close_comment,
 	read_close_comment_state,
 }
 
 export type { CloseCommentState, EpicChildren }
-export { git_epic_close_comment, CLOSE_ANNOUNCEMENT }
+export { epic_close_comment, CLOSE_ANNOUNCEMENT }

package/scripts/{git/git-epic-close.ts → epic/epic-close.ts}

@@ -1,10 +1,14 @@
-import { git_epic_close_comment } from './git-epic-close-comment'
-import { git_epic_parse, type ExternalChild } from './git-epic-parse'
-import { git_gh_command } from './git-gh-command'
-import { EPIC_LABEL } from './issue-labels'
-import { cutoff_cause, cutoff_of, type ScanCutoff } from './listing-cutoff'
-import { parse_json_array_or_undefined, parse_json_object_safe } from './parse-json-array'
-import { epic_child_schema, epic_issue_schema, type EpicChildData } from './schemas'
+import { git_gh_command } from '#scripts/git/git-gh-command'
+import { EPIC_LABEL } from '#scripts/git/issue-labels'
+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 { error_text } from '#scripts/lib/error-message'
+import { epic_close_comment } from './epic-close-comment'
+import { epic_parse, type ExternalChild } from './epic-parse'
 
 // How many open epics the auto-close will look at. `git-gh-issue-list.ts` pages until `limit` rows
 // have been selected or the backlog runs out, so this is what keeps the ordinary case at exactly one
@@ -44,9 +48,9 @@ interface SiblingState {
 function to_epic_issue(raw: { number: number; body?: string | undefined }): EpicIssue {
 	return {
 		number: raw.number,
-		children: git_epic_parse.parse_task_list_issue_numbers(raw.body),
-		external_children: git_epic_parse.parse_external_task_list_children(raw.body),
-		has_declared_order: git_epic_parse.has_declared_dependency_chain(raw.body),
+		children: epic_parse.parse_task_list_issue_numbers(raw.body),
+		external_children: epic_parse.parse_external_task_list_children(raw.body),
+		has_declared_order: epic_parse.has_declared_dependency_chain(raw.body),
 	}
 }
 
@@ -91,7 +95,7 @@ function to_sibling_state(raw_json: string | undefined): SiblingState {
 	const child = parse_child(raw_json)
 
 	return {
-		is_closed: git_epic_parse.is_state_closed(child?.state),
+		is_closed: epic_parse.is_state_closed(child?.state),
 		has_blocked_by: has_blocked_by(child),
 	}
 }
@@ -124,7 +128,7 @@ async function inspect_siblings(
 }
 
 // `pnpm josh epic --ordered` and `--add` record the declared chain themselves, through the REST
-// dependencies endpoint (`git-epic-relations.ts`, joshuafolkken/kit#1026), so the default route
+// dependencies endpoint (`epic-relations.ts`, joshuafolkken/kit#1026), so the default route
 // arrives here with the relations already in place. Three routes still reach a declared order with
 // none recorded: an epic body written by hand, the manual fallback in `issue-template.md`, and
 // `apply_relations` failing — it counts the refusals, reports that the body is intact and lets the
@@ -200,11 +204,11 @@ async function close_epic_with(epic_number: string, comment: string | undefined)
 // `absent` and one of `unreadable` both post it, and the second says so.
 async function close_epic(epic: EpicIssue): Promise<boolean> {
 	const epic_number = String(epic.number)
-	const state = await git_epic_close_comment.read_close_comment_state(epic_number, epic)
+	const state = await epic_close_comment.read_close_comment_state(epic_number, epic)
 
 	if (state === 'unreadable') console.info(`ℹ️  Epic #${epic_number}${UNREADABLE_COMMENTS_NOTE}`)
 
-	const comment = state === 'present' ? undefined : git_epic_close_comment.build_close_comment(epic)
+	const comment = state === 'present' ? undefined : epic_close_comment.build_close_comment(epic)
 
 	return await close_epic_with(epic_number, comment)
 }
@@ -256,7 +260,7 @@ async function close_epic_isolated(epic: EpicIssue, merged_number: number): Prom
 	try {
 		return await close_epic_when_complete(epic, merged_number)
 	} catch (error) {
-		const message = error instanceof Error ? error.message : String(error)
+		const message = error_text.message_of(error)
 
 		console.info(`⚠️  Skipped epic #${String(epic.number)}: ${message}`)
 
@@ -265,7 +269,7 @@ async function close_epic_isolated(epic: EpicIssue, merged_number: number): Prom
 }
 
 function parents_of(open_epics: ReadonlyArray<EpicIssue>, child_number: number): Array<EpicIssue> {
-	return open_epics.filter((epic) => git_epic_parse.has_child(epic.children, child_number))
+	return open_epics.filter((epic) => epic_parse.has_child(epic.children, child_number))
 }
 
 // Closes one epic unless a cycle or a shared child already reached it — the closed number, or
@@ -351,7 +355,7 @@ async function resolve_and_close_safely(merged_number: number): Promise<void> {
 	try {
 		await resolve_and_close(merged_number)
 	} catch (error) {
-		const message = error instanceof Error ? error.message : String(error)
+		const message = error_text.message_of(error)
 
 		console.info(`⚠️  Skipped the epic auto-close check: ${message}`)
 	}
@@ -376,12 +380,12 @@ async function close_completed_epics(input: {
 	await resolve_and_close_safely(merged_number)
 }
 
-const git_epic_close = {
+const epic_close = {
 	close_completed_epics,
 }
 
 export {
-	git_epic_close,
+	epic_close,
 	close_completed_epics,
 	truncated_epic_list_note,
 	EPIC_LIST_LIMIT,

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

@@ -4,7 +4,6 @@ import { git_gh_api_path } from '#scripts/git/git-gh-api-path'
 import { git_gh_exec } from '#scripts/git/git-gh-exec'
 import { propagate_publish } from '#scripts/propagate/propagate-publish'
 import { derive_versions_endpoint } from '#scripts/version/version-command-config'
-import { execaSync } from 'execa'
 import { load } from 'js-yaml'
 import type { DependencyVerdict } from './epic-classify'
 import type { EpicChild } from './epic-graph'
@@ -71,7 +70,6 @@ function is_published(repo: string, version: string): boolean {
 }
 
 const GH_TIMEOUT_MS = 20_000
-const SUCCESS_EXIT_CODE = 0
 // The manifest arrives base64-encoded in the API's `content` field; `jq` decodes and reads it.
 const VERSION_JQ = '.content | @base64d | fromjson | {version, private, workspaces} | tojson'
 const PNPM_WORKSPACE_FILE = 'pnpm-workspace.yaml'
@@ -147,24 +145,20 @@ function pnpm_workspace_path(repo: string): string {
 
 // A read that failed for any reason other than a missing file leaves the layout unknown.
 function classify_workspace_failure(repo: string): WorkspaceCheck {
-	const probe = execaSync('gh', ['api', '--include', '--silent', pnpm_workspace_path(repo)], {
-		...git_gh_exec.direct_environment(),
-		reject: false,
-		timeout: GH_TIMEOUT_MS,
-	})
+	const status = git_gh_exec.exec_gh_api_status_sync(pnpm_workspace_path(repo), GH_TIMEOUT_MS)
 
-	return git_gh_exec.parse_status_line(probe.stdout) === NOT_FOUND_STATUS ? 'single' : 'unreadable'
+	return status === NOT_FOUND_STATUS ? 'single' : 'unreadable'
 }
 
 function read_pnpm_workspace(repo: string): WorkspaceCheck {
-	const result = execaSync('gh', ['api', pnpm_workspace_path(repo), '--jq', WORKSPACE_JQ], {
-		...git_gh_exec.direct_environment(),
-		reject: false,
-		timeout: GH_TIMEOUT_MS,
+	const stdout = git_gh_exec.read_gh_api_sync({
+		path: pnpm_workspace_path(repo),
+		jq_filter: WORKSPACE_JQ,
+		timeout_ms: GH_TIMEOUT_MS,
 	})
-	if (result.exitCode !== SUCCESS_EXIT_CODE) return classify_workspace_failure(repo)
+	if (stdout === undefined) return classify_workspace_failure(repo)
 
-	return declares_packages(result.stdout) ? 'workspace' : 'single'
+	return declares_packages(stdout) ? 'workspace' : 'single'
 }
 
 // Whether the repository declares a workspace. `workspaces` covers npm and yarn; pnpm keeps its
@@ -227,38 +221,27 @@ function to_manifest(repo: string, stdout: string): ManifestAnswer {
 }
 
 // Why the read failed, asked only when it did. The status line is the protocol rather than prose, so
-// a missing manifest is told from a rate limit by matching a contract instead of a message — through
-// `git_gh_exec.parse_status_line` rather than a second copy of it.
+// a missing manifest is told from a rate limit by matching a contract instead of a message.
 //
-// `git_gh_exec.exec_gh_api_status` asks the same question and is **not** reused: it is async, and
-// every caller down to `resolve_cross_repo` is synchronous. What is worth sharing is the parser,
-// which is shared; the spawn is four lines and duplicating it costs less than turning the
-// classifier, the resolver and `epic_classify` async for one probe. A 404 here is trustworthy in a way
-// a registry 404 is not: the repository's issues are already being read, so access is established and
-// what is missing is the file.
+// The probe is `exec_gh_api_status_sync`, the synchronous twin of `exec_gh_api_status`: every caller
+// down to `resolve_cross_repo` is synchronous, and turning the classifier, the resolver and
+// `epic_classify` async for one probe would cost more than the twin (joshuafolkken/kit#2901). A 404
+// here is trustworthy in a way a registry 404 is not: the repository's issues are already being read,
+// so access is established and what is missing is the file.
 function classify_manifest_failure(repo: string): ManifestAnswer {
-	const probe = execaSync('gh', ['api', '--include', '--silent', manifest_path(repo)], {
-		...git_gh_exec.direct_environment(),
-		reject: false,
-		timeout: GH_TIMEOUT_MS,
-	})
+	const status = git_gh_exec.exec_gh_api_status_sync(manifest_path(repo), GH_TIMEOUT_MS)
 
-	return {
-		kind:
-			git_gh_exec.parse_status_line(probe.stdout) === NOT_FOUND_STATUS ? 'absent' : 'unreadable',
-	}
+	return { kind: status === NOT_FOUND_STATUS ? 'absent' : 'unreadable' }
 }
 
 function fetch_manifest(repo: string): ManifestAnswer {
-	const result = execaSync('gh', ['api', manifest_path(repo), '--jq', VERSION_JQ], {
-		...git_gh_exec.direct_environment(),
-		reject: false,
-		timeout: GH_TIMEOUT_MS,
+	const stdout = git_gh_exec.read_gh_api_sync({
+		path: manifest_path(repo),
+		jq_filter: VERSION_JQ,
+		timeout_ms: GH_TIMEOUT_MS,
 	})
 
-	return result.exitCode === SUCCESS_EXIT_CODE
-		? to_manifest(repo, result.stdout)
-		: classify_manifest_failure(repo)
+	return stdout === undefined ? classify_manifest_failure(repo) : to_manifest(repo, stdout)
 }
 
 // Read once per pass, for the reason `published_cache` holds the other half: every edge to one

package/scripts/{git/git-epic-decision.ts → epic/epic-decision.ts}

@@ -1,6 +1,6 @@
-import { git_epic_parse, type DependencyLink } from './git-epic-parse'
-import { format_replaced_relations } from './git-epic-reference'
-import { git_epic_sections, type BodyLines, type SectionRange } from './git-epic-sections'
+import { epic_parse, type DependencyLink } from './epic-parse'
+import { format_replaced_relations } from './epic-reference'
+import { epic_sections, type BodyLines, type SectionRange } from './epic-sections'
 
 // Placing a decision record inside an epic body's `## Decisions` section.
 //
@@ -45,10 +45,8 @@ function to_declaration_error(line_number: number): string {
 function find_decision_error(record: string): string | undefined {
 	if (record.trim().length === 0) return EMPTY_RECORD
 
-	const input = git_epic_sections.to_body_lines(record)
-	const [found] = git_epic_sections.find_indices(input, (line) =>
-		git_epic_parse.is_declaration_line(line),
-	)
+	const input = epic_sections.to_body_lines(record)
+	const [found] = epic_sections.find_indices(input, (line) => epic_parse.is_declaration_line(line))
 
 	return found === undefined ? undefined : to_declaration_error(found + FIRST_LINE_NUMBER)
 }
@@ -81,8 +79,8 @@ function last_content_index(input: BodyLines, range: SectionRange): number {
 // The section's *end* rather than its start: the entries are a log, and a reader looking for the most
 // recent decision reads down. Nothing else in the body moves.
 function append_decision(body: string, record: string): string {
-	const input = git_epic_sections.to_body_lines(body)
-	const range = git_epic_sections.find_section_range(input, DECISIONS_HEADING_PATTERN)
+	const input = epic_sections.to_body_lines(body)
+	const range = epic_sections.find_section_range(input, DECISIONS_HEADING_PATTERN)
 	if (range === undefined) return to_new_section(input.lines, record).join('\n')
 
 	const at = last_content_index(input, range)
@@ -129,13 +127,13 @@ function format_decision_report(input: { total: number; failures: number }): str
 }
 
 // The heading a creation writes its reasoning under. Beside a pattern exactly as `DECISIONS_HEADING`
-// is, and tied to `git_epic_body`'s own literal by a test that reads a body the builder produced
+// is, and tied to `epic_body`'s own literal by a test that reads a body the builder produced
 // rather than by a string comparison (joshuafolkken/kit#1712).
 const RATIONALE_HEADING_PATTERN = /^#{1,6}[ \t]+Split rationale\b/u
 
 function read_section(body: string, heading: RegExp): string {
-	const input = git_epic_sections.to_body_lines(body)
-	const range = git_epic_sections.find_section_range(input, heading)
+	const input = epic_sections.to_body_lines(body)
+	const range = epic_sections.find_section_range(input, heading)
 	if (range === undefined) return ''
 
 	return input.lines.slice(range.start, range.end).join('\n')
@@ -159,7 +157,7 @@ function read_recorded_reasons(body: string | undefined): string {
 	].join('\n')
 }
 
-const git_epic_decision = {
+const epic_decision = {
 	DECISIONS_HEADING,
 	append_decision,
 	append_replacements,
@@ -168,4 +166,4 @@ const git_epic_decision = {
 	format_decision_report,
 }
 
-export { git_epic_decision }
+export { epic_decision }

package/scripts/epic/epic-fetch.ts

@@ -1,9 +1,9 @@
-import { git_epic_parse, type ExternalChild } from '#scripts/git/git-epic-parse'
 import { git_gh_command } from '#scripts/git/git-gh-command'
 import type { IssueReadFailure } from '#scripts/git/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'
+import { epic_parse, type ExternalChild } from './epic-parse'
 import { epic_relation_recheck } from './epic-relation-recheck'
 
 // Reading an epic and its children from GitHub.
@@ -73,8 +73,8 @@ async function fetch_epic_body(epic_number: number, scope?: string): Promise<Epi
 	return {
 		body,
 		body_failure: read.kind === 'read' ? undefined : read,
-		child_numbers: git_epic_parse.parse_task_list_issue_numbers(body),
-		external: git_epic_parse.parse_external_task_list_children(body),
+		child_numbers: epic_parse.parse_task_list_issue_numbers(body),
+		external: epic_parse.parse_external_task_list_children(body),
 	}
 }
 

package/scripts/epic/epic-graph.ts

@@ -1,10 +1,10 @@
-import type { DependencyLink } from '#scripts/git/git-epic-parse'
+import type { DependencyLink } from './epic-parse'
 import {
 	format_dependency_link,
 	join_references,
 	to_issue_reference,
 	type IssueReference,
-} from '#scripts/git/git-epic-reference'
+} from './epic-reference'
 
 // The dependency graph an epic's children form, and the two ways it can be wrong.
 //
@@ -275,5 +275,5 @@ const epic_graph = {
 }
 
 export type { EpicChild, GraphAnomaly, GraphAnomalyKind }
-export type { IssueReference } from '#scripts/git/git-epic-reference'
+export type { IssueReference } from './epic-reference'
 export { epic_graph }

package/scripts/epic/epic-index.ts

@@ -1,10 +1,10 @@
-import { git_epic_parse } from '#scripts/git/git-epic-parse'
 import { git_gh_command } from '#scripts/git/git-gh-command'
 import { EPIC_LABEL, has_any_label } from '#scripts/git/issue-labels'
 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 { z } from 'zod'
+import { epic_parse } from './epic-parse'
 
 // Which epic tracks which issue — the one answer, in one place (joshuafolkken/kit#1633).
 //
@@ -40,7 +40,7 @@ function build_tracking_index(
 	const index = new Map<number, ReadonlyArray<number>>()
 
 	for (const epic of epics) {
-		for (const child of git_epic_parse.parse_task_list_issue_numbers(epic.body)) {
+		for (const child of epic_parse.parse_task_list_issue_numbers(epic.body)) {
 			index.set(child, [...(index.get(child) ?? []), epic.number])
 		}
 	}

package/scripts/epic/epic-issue.ts

@@ -1,8 +1,8 @@
-import type { IssueReference } from '#scripts/git/git-epic-reference'
 import { git_gh_issue_rest } from '#scripts/git/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'
+import type { IssueReference } from './epic-reference'
 
 // The shapes one issue is read as, and the argument every epic command takes.
 //