@joshuafolkken/kit 1.1005.0 → 1.1035.0

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.
 //

package/scripts/epic/epic-next.ts

@@ -1,7 +1,6 @@
 #!/usr/bin/env tsx
 import { fileURLToPath } from 'node:url'
 import { repo_discovery } from '#scripts/discovery/repo-discovery'
-import { git_epic_parse } from '#scripts/git/git-epic-parse'
 import { git_gh_command } from '#scripts/git/git-gh-command'
 import { PROJECT_ROOT } from '#scripts/init/init-paths'
 import { josh_environment_file } from '#scripts/josh/josh-environment-file'
@@ -16,6 +15,7 @@ import { epic_lane_offer, type LaneOffer, type LaneRequest } from './epic-lane-o
 import { epic_next_read, type EpicRead, type SnapshotReads } from './epic-next-read'
 import { epic_next_views, type EpicView } from './epic-next-views'
 import { epic_outside_blocker } from './epic-outside-blocker'
+import { epic_parse } from './epic-parse'
 import { epic_report, type EpicNextResult } from './epic-report'
 
 // `josh epic:next <E…>` — which of the named epics' children can be started right now, bundled per
@@ -170,7 +170,7 @@ function unreadable_anomaly(snapshot: EpicSnapshot): GraphAnomaly | undefined {
 // body whose declared chain and recorded relations agree — a worse outcome than following the chain
 // the run's own `epic:check` already flagged.
 function is_order_declared(body: string | undefined, links: ReadonlyArray<unknown>): boolean {
-	return links.length > 0 || git_epic_parse.has_unordered_declaration(body)
+	return links.length > 0 || epic_parse.has_unordered_declaration(body)
 }
 
 function decide(
@@ -178,7 +178,7 @@ function decide(
 	paths: ReadonlyMap<string, string> = new Map(),
 	running?: ReadonlySet<string>,
 ): EpicNextResult {
-	const links = git_epic_parse.parse_dependency_links(snapshot.body)
+	const links = epic_parse.parse_dependency_links(snapshot.body)
 	const unreadable = body_anomaly(snapshot) ?? unreadable_anomaly(snapshot)
 	const anomalies =
 		unreadable === undefined

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

@@ -256,7 +256,7 @@ function parse_dependency_links(body: string | undefined): Array<DependencyLink>
 // `None — the children are independent` report as ordered, and `josh followup` then said the batch
 // order was never recorded on every child's merge. The narrowing joshuafolkken/kit#858 applied to
 // the link reader was the same judgement, and `epic --add` writes on that judgement too
-// (`git-epic-add-body.ts` protects an arrow outside the `Dependencies` section as prose) — so the
+// (`epic-add-body.ts` protects an arrow outside the `Dependencies` section as prose) — so the
 // three readers of one body now recognize the same lines, instead of two patterns that could
 // disagree about which line is a declaration. They still answer different questions of those lines:
 // a self-loop (`#101 -> #101`) is a declaration here and yields no link, since `chain_links` drops
@@ -306,7 +306,7 @@ function is_state_closed(state: string | undefined): boolean {
 	return state?.toUpperCase() === CLOSED_STATE
 }
 
-const git_epic_parse = {
+const epic_parse = {
 	fence_mask,
 	is_task_list_line,
 	is_declaration_line,
@@ -328,7 +328,7 @@ const git_epic_parse = {
 
 export type { DeclarationState, DependencyLink, ExternalChild }
 export {
-	git_epic_parse,
+	epic_parse,
 	fence_mask,
 	is_task_list_line,
 	is_declaration_line,

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

@@ -1,5 +1,5 @@
-import { git_epic_body } from './git-epic-body'
-import { git_epic_parse } from './git-epic-parse'
+import { epic_body } from './epic-body'
+import { epic_parse } from './epic-parse'
 
 // Promoting an existing issue into an epic.
 //
@@ -34,13 +34,13 @@ function has_conflicting_tracking(body: string | undefined): boolean {
 	if (body === undefined) return false
 	if (body.includes(PROMOTED_HEADING)) return true
 
-	return git_epic_parse.parse_task_list_issue_numbers(body).length > 0
+	return epic_parse.parse_task_list_issue_numbers(body).length > 0
 }
 
 // Why the promotion was refused, phrased as what was found rather than as a rule number.
 function conflict_reason(body: string | undefined): string {
 	if (body?.includes(PROMOTED_HEADING) === true) return 'it already carries the epic sections'
-	const tracked = git_epic_parse.parse_task_list_issue_numbers(body)
+	const tracked = epic_parse.parse_task_list_issue_numbers(body)
 	const list = tracked.map((child) => `#${String(child)}`).join(', ')
 
 	return `its body already tracks ${list} as a task list, which would become a second child list`
@@ -50,7 +50,7 @@ function conflict_reason(body: string | undefined): string {
 // what happened. The original text is never rewritten — it is the record of why the split was made.
 function build_promoted_body(input: PromoteInput): string {
 	const existing = (input.body ?? '').trimEnd()
-	const epic_sections = git_epic_body.build_epic_body({
+	const epic_sections = epic_body.build_epic_body({
 		children: input.children,
 		rationale: input.rationale,
 		is_ordered: input.is_ordered,
@@ -71,8 +71,8 @@ function build_promoted_body(input: PromoteInput): string {
 // so the body would declare an order and declare that there is none. Reported as "does not track
 // every child", that state left nothing to act on (joshuafolkken/kit#1155).
 function declaration_error(body: string): string | undefined {
-	const state = git_epic_parse.read_declaration(body)
-	if (git_epic_parse.is_declaration_readable(state)) return undefined
+	const state = epic_parse.read_declaration(body)
+	if (epic_parse.is_declaration_readable(state)) return undefined
 
 	return state.has_chain
 		? 'The promoted body would declare an order and declare that there is none: the issue being promoted already carries a line that is only a chain (`#N -> #M`), and it contradicts the `Dependencies` section written for the epic. Reword that line first; nothing was written.'
@@ -80,7 +80,7 @@ function declaration_error(body: string): string | undefined {
 }
 
 function find_tracking_error(body: string, children: ReadonlyArray<number>): string | undefined {
-	const tracked = git_epic_parse.parse_task_list_issue_numbers(body)
+	const tracked = epic_parse.parse_task_list_issue_numbers(body)
 
 	if (children.some((child) => !tracked.includes(child))) {
 		return 'The promoted body would not track every child; nothing was written.'
@@ -89,7 +89,7 @@ function find_tracking_error(body: string, children: ReadonlyArray<number>): str
 	return declaration_error(body)
 }
 
-const git_epic_promote = {
+const epic_promote = {
 	EPIC_SECTION_MARKER,
 	PROMOTED_HEADING,
 	has_conflicting_tracking,
@@ -99,4 +99,4 @@ const git_epic_promote = {
 }
 
 export type { PromoteInput }
-export { git_epic_promote }
+export { epic_promote }