@joshuafolkken/kit 1.1005.0 → 1.1035.0

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

@@ -1,8 +1,8 @@
-import { epic_fetch } from '#scripts/epic/epic-fetch'
-import { epic_graph, type EpicChild } from '#scripts/epic/epic-graph'
-import { git_epic_parse } from './git-epic-parse'
-import { git_epic_validate, type EpicSubject } from './git-epic-validate'
-import { git_gh_command } from './git-gh-command'
+import { git_gh_command } from '#scripts/git/git-gh-command'
+import { epic_fetch } from './epic-fetch'
+import { epic_graph, type EpicChild } from './epic-graph'
+import { epic_parse } from './epic-parse'
+import { epic_validate, type EpicSubject } from './epic-validate'
 
 // Reading an epic and its current graph, for the two commands that edit its declared order.
 //
@@ -26,7 +26,7 @@ interface EpicReading {
 }
 
 async function read_subject(epic_number: number): Promise<EpicSubject | undefined> {
-	return git_epic_validate.parse_epic_subject(
+	return epic_validate.parse_epic_subject(
 		await git_gh_command.issue_get_labels_and_body(String(epic_number)),
 	)
 }
@@ -39,7 +39,7 @@ async function read_recorded(
 ): Promise<{ children: ReadonlyArray<EpicChild>; repo: string } | { error: string }> {
 	const repo = await git_gh_command.repo_get_name_with_owner()
 	if (repo === undefined) return { error: UNKNOWN_REPO }
-	const tracked = git_epic_parse.parse_task_list_issue_numbers(body)
+	const tracked = epic_parse.parse_task_list_issue_numbers(body)
 	if (tracked.length === 0) return { children: [], repo }
 
 	const fetched = await epic_fetch.fetch_children(tracked, repo)
@@ -64,10 +64,10 @@ async function read_epic(epic_number: number): Promise<EpicReading | { error: st
 	return { subject, recorded: recorded.children, repo: recorded.repo }
 }
 
-const git_epic_read = {
+const epic_read = {
 	UNKNOWN_REPO,
 	read_epic,
 }
 
-export { git_epic_read }
+export { epic_read }
 export type { EpicReading }

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

@@ -1,11 +1,11 @@
-import { epic_graph, type EpicChild, type IssueReference } from '#scripts/epic/epic-graph'
-import { git_epic_add_body } from './git-epic-add-body'
-import { git_epic_chains } from './git-epic-chains'
-import { git_epic_parse, type DependencyLink } from './git-epic-parse'
-import { git_epic_read } from './git-epic-read'
-import { format_dependency_links } from './git-epic-reference'
-import { git_epic_relations } from './git-epic-relations'
-import { git_gh_command } from './git-gh-command'
+import { git_gh_command } from '#scripts/git/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'
+import { epic_parse, type DependencyLink } from './epic-parse'
+import { epic_read } from './epic-read'
+import { format_dependency_links } from './epic-reference'
+import { epic_relations } from './epic-relations'
 
 // `josh epic --reconcile <E>` — bring an epic's `## Dependencies` declaration and its native
 // `blocked-by` relations back into agreement, without a hand edit and without recording a decision
@@ -34,7 +34,7 @@ const RECONCILED = 'reconciled'
 
 interface ReconcilePlanInput {
 	body: string | undefined
-	// The epic's children with their native relations, exactly as `git_epic_read` reads them.
+	// The epic's children with their native relations, exactly as `epic_read` reads them.
 	recorded: ReadonlyArray<EpicChild>
 	// The epic's own repository — what a declared bare number names (joshuafolkken/kit#1126).
 	repo: string
@@ -101,7 +101,7 @@ function to_reconciled_body(
 	body: string | undefined,
 	target_chains: ReadonlyArray<ReadonlyArray<number>>,
 ): { body: string } | { error: string } {
-	return git_epic_add_body.rewrite_body({
+	return epic_add_body.rewrite_body({
 		body: body ?? '',
 		placed: [],
 		position: undefined,
@@ -120,8 +120,8 @@ interface Mismatch {
 }
 
 function read_mismatch(input: ReconcilePlanInput): Mismatch {
-	const chains_before = git_epic_parse.parse_dependency_chains(input.body)
-	const declared = git_epic_chains.links_of(chains_before)
+	const chains_before = epic_parse.parse_dependency_chains(input.body)
+	const declared = epic_chains.links_of(chains_before)
 
 	return {
 		chains_before,
@@ -135,7 +135,7 @@ function read_mismatch(input: ReconcilePlanInput): Mismatch {
 function to_reconciled_plan(input: ReconcilePlanInput, mismatch: Mismatch): ReconcilePlan {
 	const declared_chains = mismatch.declare.map((link) => to_chain(link))
 	const target_chains = [...mismatch.chains_before, ...declared_chains]
-	const cycle = find_cycle(git_epic_chains.links_of(target_chains), input.repo)
+	const cycle = find_cycle(epic_chains.links_of(target_chains), input.repo)
 	if (cycle !== undefined) return { kind: 'cycle', message: cycle }
 
 	const { declare, record } = mismatch
@@ -176,11 +176,9 @@ function report_declared(epic_number: number, declare: ReadonlyArray<DependencyL
 async function record_relations(record: ReadonlyArray<DependencyLink>): Promise<void> {
 	if (record.length === 0) return
 
-	const failures = await git_epic_relations.apply_relations(record, 'record')
+	const failures = await epic_relations.apply_relations(record, 'record')
 
-	console.info(
-		git_epic_relations.format_relation_report({ links: record, failures, action: 'record' }),
-	)
+	console.info(epic_relations.format_relation_report({ links: record, failures, action: 'record' }))
 }
 
 async function apply_reconciliation(
@@ -218,7 +216,7 @@ async function apply_plan(epic_number: number, plan: ReconcilePlan): Promise<num
 // Every refusal — an unreadable epic, an unreadable graph, a cycle — happens before the body edit,
 // so a rejected invocation leaves the epic exactly as it was.
 async function reconcile_epic(epic_number: number): Promise<number> {
-	const epic = await git_epic_read.read_epic(epic_number)
+	const epic = await epic_read.read_epic(epic_number)
 
 	if ('error' in epic) {
 		console.error(`✖ ${epic.error}`)
@@ -235,12 +233,12 @@ async function reconcile_epic(epic_number: number): Promise<number> {
 	return await apply_plan(epic_number, plan)
 }
 
-const git_epic_reconcile = {
+const epic_reconcile = {
 	NOTHING_TO_RECONCILE,
 	RECONCILED,
 	build_reconcile_plan,
 	reconcile_epic,
 }
 
-export { git_epic_reconcile }
+export { epic_reconcile }
 export type { ReconcilePlan, ReconcilePlanInput, Reconciliation }

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

@@ -1,4 +1,4 @@
-import type { DependencyLink } from './git-epic-parse'
+import type { DependencyLink } from './epic-parse'
 
 // How an issue and a dependency between two of them are written down.
 //
@@ -13,25 +13,6 @@ const DEPENDENCY_ARROW = ' -> '
 // and two separators would let the two disagree over something a reader reads side by side.
 const REFERENCE_SEPARATOR = ', '
 
-// An issue named from outside any one graph — a task-list row, a citation in prose, a blocker
-// relation, a child that could not be read. Repository **and** number, because a number alone cannot
-// identify one: issue numbers are unique per repository, so the same `#40` names two different issues
-// depending on who wrote it (joshuafolkken/kit#1014).
-//
-// It lives here rather than in `epic-graph` because the `blocked-by` relations are read in the git
-// layer and carry a repository of their own (joshuafolkken/kit#1126) — a second declaration there
-// would be the clone `CLAUDE.md` prohibits, and an import the other way would point the lower layer
-// at the higher one. `epic-graph` re-exports it, so every existing importer is unchanged.
-//
-// `state` is present only on a reference read from a `blocked-by` relation whose response carried it
-// (joshuafolkken/kit#1943). The classifier needs it for a blocker no named graph tracks, where there is
-// no child record to read the state from; every other reference leaves it out.
-interface IssueReference {
-	repo: string
-	number: number
-	state?: 'OPEN' | 'CLOSED'
-}
-
 function to_issue_reference(issue_number: number): string {
 	return `#${String(issue_number)}`
 }
@@ -73,7 +54,7 @@ function format_replaced_relations(links: ReadonlyArray<DependencyLink>): string
 	return `Replaced blocked-by: ${join_references(quoted)}.`
 }
 
-const git_epic_reference = {
+const epic_reference = {
 	DEPENDENCY_ARROW,
 	REFERENCE_SEPARATOR,
 	to_issue_reference,
@@ -84,9 +65,9 @@ const git_epic_reference = {
 	format_replaced_relations,
 }
 
-export type { IssueReference }
+export type { IssueReference } from '#scripts/git/issue-reference'
 export {
-	git_epic_reference,
+	epic_reference,
 	DEPENDENCY_ARROW,
 	REFERENCE_SEPARATOR,
 	to_issue_reference,

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

@@ -1,5 +1,6 @@
-import { git_epic_parse } from '#scripts/git/git-epic-parse'
+import { error_text } from '#scripts/lib/error-message'
 import { epic_graph, type EpicChild, type IssueReference } from './epic-graph'
+import { epic_parse } from './epic-parse'
 
 // joshuafolkken/kit#1113: a second look at the relations, taken only where the first one is about to
 // become a verdict.
@@ -42,7 +43,7 @@ function suspect_children(
 	body: string | undefined,
 	declared_repo: string,
 ): Set<number> {
-	const links = git_epic_parse.parse_dependency_links(body)
+	const links = epic_parse.parse_dependency_links(body)
 	const local = children.filter((child) => child.repo === declared_repo)
 
 	return new Set(
@@ -57,7 +58,7 @@ async function reread_child(child: EpicChild, read_blockers: BlockersReader): Pr
 	try {
 		return { ...child, blocked_by: await read_blockers(child) }
 	} catch (error) {
-		const reason = error instanceof Error ? error.message : String(error)
+		const reason = error_text.message_of(error)
 
 		console.warn(
 			`⚠ could not re-read the blockers of #${String(child.number)}: ${reason}\n` +

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

@@ -1,6 +1,6 @@
-import type { DependencyLink } from './git-epic-parse'
-import { format_dependency_links } from './git-epic-reference'
-import { git_gh_command } from './git-gh-command'
+import { git_gh_command } from '#scripts/git/git-gh-command'
+import type { DependencyLink } from './epic-parse'
+import { format_dependency_links } from './epic-reference'
 
 // Recording and dropping the native `blocked-by` relations an epic's declared order implies.
 //
@@ -69,10 +69,10 @@ function format_relation_report(input: {
 	return `⚠️  ${String(input.failures)} of ${total} blocked-by relation(s) could not be ${verb}; the epic body is intact.`
 }
 
-const git_epic_relations = {
+const epic_relations = {
 	apply_relations,
 	format_relation_report,
 }
 
-export { git_epic_relations }
+export { epic_relations }
 export type { RelationAction }

package/scripts/{git/git-epic-remove-plan.ts → epic/epic-remove-plan.ts}

@@ -1,10 +1,10 @@
-import { epic_graph, type EpicChild } from '#scripts/epic/epic-graph'
-import { git_epic_add_body, type RewriteOutcome } from './git-epic-add-body'
-import { git_epic_chains } from './git-epic-chains'
-import { git_epic_decision } from './git-epic-decision'
-import { chain_links, git_epic_parse, type DependencyLink } from './git-epic-parse'
-import { format_dependency_link, format_dependency_links } from './git-epic-reference'
-import { git_epic_shape } from './git-epic-shape'
+import { epic_add_body, type RewriteOutcome } from './epic-add-body'
+import { epic_chains } from './epic-chains'
+import { epic_decision } from './epic-decision'
+import { epic_graph, type EpicChild } from './epic-graph'
+import { chain_links, epic_parse, type DependencyLink } from './epic-parse'
+import { format_dependency_link, format_dependency_links } from './epic-reference'
+import { epic_shape } from './epic-shape'
 
 // Everything `josh epic --remove` decides before it writes anything.
 //
@@ -15,7 +15,7 @@ import { git_epic_shape } from './git-epic-shape'
 // `declaration_mismatch`, which stops an unattended run. Epic joshuafolkken/kit#1262 recorded
 // twenty-nine such removals before the command existed (joshuafolkken/kit#1712).
 //
-// Kept apart from the GitHub calls for the reason `git-epic-add-plan.ts` is: the whole decision is
+// Kept apart from the GitHub calls for the reason `epic-add-plan.ts` is: the whole decision is
 // asserted without a network, and a refusal path only reachable through `gh` is one nobody tests.
 
 // The path whose consecutive pairs name the orders to delete. `--remove <E> 101 102 103` deletes
@@ -71,9 +71,7 @@ function find_undeclared_error(
 	links: ReadonlyArray<DependencyLink>,
 	chains: ReadonlyArray<ReadonlyArray<number>>,
 ): string | undefined {
-	const declared = new Set(
-		git_epic_chains.links_of(chains).map((link) => format_dependency_link(link)),
-	)
+	const declared = new Set(epic_chains.links_of(chains).map((link) => format_dependency_link(link)))
 	const missing = links.filter((link) => !declared.has(format_dependency_link(link)))
 
 	return missing.length === 0
@@ -84,7 +82,7 @@ function find_undeclared_error(
 // A decision record that cannot be written is refused here rather than dropped, exactly as it is for
 // an insertion: `--decision-file` was given because the record has to exist.
 function find_decision_error(decision: string | undefined): string | undefined {
-	return decision === undefined ? undefined : git_epic_decision.find_decision_error(decision)
+	return decision === undefined ? undefined : epic_decision.find_decision_error(decision)
 }
 
 function find_input_error(
@@ -93,7 +91,7 @@ function find_input_error(
 	chains: ReadonlyArray<ReadonlyArray<number>>,
 ): string | undefined {
 	return (
-		git_epic_shape.find_subject_error(input, tracked) ??
+		epic_shape.find_subject_error(input, tracked) ??
 		find_path_error(input.path) ??
 		find_undeclared_error(to_path_links(input.path), chains) ??
 		find_decision_error(input.decision)
@@ -112,7 +110,7 @@ function to_body(
 	input: RemovePlanInput,
 	chains_after: ReadonlyArray<ReadonlyArray<number>>,
 ): RewriteOutcome {
-	return git_epic_add_body.rewrite_body({
+	return epic_add_body.rewrite_body({
 		body: input.body ?? '',
 		placed: [],
 		chains_after,
@@ -122,13 +120,13 @@ function to_body(
 }
 
 function build_removal_plan(input: RemovePlanInput): RemoveOutcome {
-	const tracked = git_epic_parse.parse_task_list_issue_numbers(input.body)
-	const chains_before = git_epic_parse.parse_dependency_chains(input.body)
+	const tracked = epic_parse.parse_task_list_issue_numbers(input.body)
+	const chains_before = epic_parse.parse_dependency_chains(input.body)
 	const error = find_input_error(input, tracked, chains_before)
 	if (error !== undefined) return { error }
 
 	const links = to_path_links(input.path)
-	const chains_after = git_epic_chains.remove_links(chains_before, links)
+	const chains_after = epic_chains.remove_links(chains_before, links)
 	const rewritten = to_body(input, chains_after)
 	if ('error' in rewritten) return { error: rewritten.error }
 
@@ -144,9 +142,9 @@ function build_removal_plan(input: RemovePlanInput): RemoveOutcome {
 	}
 }
 
-const git_epic_remove_plan = {
+const epic_remove_plan = {
 	build_removal_plan,
 }
 
-export { git_epic_remove_plan }
+export { epic_remove_plan }
 export type { RemovePlan, RemovePlanInput, RemoveOutcome }

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

@@ -1,9 +1,9 @@
-import { git_epic_decision } from './git-epic-decision'
-import { git_epic_read } from './git-epic-read'
-import { format_dependency_links } from './git-epic-reference'
-import { git_epic_relations } from './git-epic-relations'
-import { git_epic_remove_plan, type RemovePlan } from './git-epic-remove-plan'
-import { git_gh_command } from './git-gh-command'
+import { git_gh_command } from '#scripts/git/git-gh-command'
+import { epic_decision } from './epic-decision'
+import { epic_read } from './epic-read'
+import { format_dependency_links } from './epic-reference'
+import { epic_relations } from './epic-relations'
+import { epic_remove_plan, type RemovePlan } from './epic-remove-plan'
 
 // `josh epic --remove <E> <M> <N> [<N2> ...] [--decision-file <path|->]` — delete a declared order
 // from the epic's body and from the native `blocked-by` relations in one input
@@ -32,7 +32,7 @@ async function comment_decision(ends: ReadonlyArray<number>, decision: string):
 	)
 
 	console.info(
-		git_epic_decision.format_decision_report({
+		epic_decision.format_decision_report({
 			total: ends.length,
 			failures: posted.filter((is_posted) => !is_posted).length,
 		}),
@@ -43,7 +43,7 @@ function report_relations(plan: RemovePlan, failures: number): void {
 	if (plan.removed.length === 0) return
 
 	console.info(
-		git_epic_relations.format_relation_report({ links: plan.removed, failures, action: 'drop' }),
+		epic_relations.format_relation_report({ links: plan.removed, failures, action: 'drop' }),
 	)
 }
 
@@ -56,7 +56,7 @@ async function write_plan(
 	console.info(
 		`📋 Removed ${format_dependency_links(plan.links)} from epic #${String(epic_number)}.`,
 	)
-	report_relations(plan, await git_epic_relations.apply_relations(plan.removed, 'drop'))
+	report_relations(plan, await epic_relations.apply_relations(plan.removed, 'drop'))
 
 	if (decision !== undefined) await comment_decision(plan.ends, decision)
 }
@@ -64,7 +64,7 @@ async function write_plan(
 // Delete a declared order, or refuse without writing anything. Every refusal happens before the body
 // edit, so a rejected invocation leaves the epic exactly as it was.
 async function remove_order(input: RemoveOrderInput): Promise<number> {
-	const epic = await git_epic_read.read_epic(input.epic_number)
+	const epic = await epic_read.read_epic(input.epic_number)
 
 	if ('error' in epic) {
 		console.error(`✖ ${epic.error}`)
@@ -72,7 +72,7 @@ async function remove_order(input: RemoveOrderInput): Promise<number> {
 		return FAILURE_EXIT_CODE
 	}
 
-	const outcome = git_epic_remove_plan.build_removal_plan({
+	const outcome = epic_remove_plan.build_removal_plan({
 		epic_number: input.epic_number,
 		body: epic.subject.body,
 		labels: epic.subject.labels,
@@ -93,9 +93,9 @@ async function remove_order(input: RemoveOrderInput): Promise<number> {
 	return SUCCESS_EXIT_CODE
 }
 
-const git_epic_remove = {
+const epic_remove = {
 	remove_order,
 }
 
-export { git_epic_remove }
+export { epic_remove }
 export type { RemoveOrderInput }

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

@@ -1,9 +1,9 @@
-import { git_epic_body } from './git-epic-body'
-import { git_epic_promote } from './git-epic-promote'
-import { git_epic_relations } from './git-epic-relations'
-import { git_epic_validate, type EpicSubject } from './git-epic-validate'
-import { git_gh_command } from './git-gh-command'
-import { EPIC_LABEL } from './issue-labels'
+import { git_gh_command } from '#scripts/git/git-gh-command'
+import { EPIC_LABEL } from '#scripts/git/issue-labels'
+import { epic_body } from './epic-body'
+import { epic_promote } from './epic-promote'
+import { epic_relations } from './epic-relations'
+import { epic_validate, type EpicSubject } from './epic-validate'
 
 const EPIC_LABEL_COLOR = '#5319e7'
 const EPIC_LABEL_DESCRIPTION = 'Tracks a batch of child issues from one split'
@@ -20,18 +20,18 @@ interface CreateEpicInput {
 
 // The relations the declared order implies, applied through the shared module `--add` also uses so
 // the two cannot drift. A failure is reported and stepped over rather than aborting a batch that is
-// otherwise fine — see `git-epic-relations.ts` for why the relation is not part of the contract.
+// otherwise fine — see `epic-relations.ts` for why the relation is not part of the contract.
 async function apply_dependencies(input: {
 	children: ReadonlyArray<number>
 	is_ordered: boolean
 }): Promise<void> {
-	const pairs = git_epic_body.build_dependency_pairs(input.children, input.is_ordered)
+	const pairs = epic_body.build_dependency_pairs(input.children, input.is_ordered)
 	if (pairs.length === 0) return
 
-	const failures = await git_epic_relations.apply_relations(pairs, 'record')
+	const failures = await epic_relations.apply_relations(pairs, 'record')
 
 	console.info(
-		git_epic_relations.format_relation_report({
+		epic_relations.format_relation_report({
 			links: pairs,
 			failures,
 			action: 'record',
@@ -61,7 +61,7 @@ async function fill_run_command(
 ): Promise<void> {
 	if (epic_number === undefined) {
 		console.info(
-			`⚠️  Could not read the new epic's number from its URL; the Execution section still says \`${git_epic_body.format_run_command(undefined)}\`.`,
+			`⚠️  Could not read the new epic's number from its URL; the Execution section still says \`${epic_body.format_run_command(undefined)}\`.`,
 		)
 
 		return
@@ -70,7 +70,7 @@ async function fill_run_command(
 	try {
 		await git_gh_command.issue_edit_body(
 			String(epic_number),
-			git_epic_body.build_epic_body({
+			epic_body.build_epic_body({
 				children: input.children,
 				rationale: input.rationale,
 				is_ordered: input.is_ordered,
@@ -90,7 +90,7 @@ async function create_epic(input: CreateEpicInput): Promise<number> {
 		description: EPIC_LABEL_DESCRIPTION,
 	})
 
-	const body = git_epic_body.build_epic_body({
+	const body = epic_body.build_epic_body({
 		children: input.children,
 		rationale: input.rationale,
 		is_ordered: input.is_ordered,
@@ -107,7 +107,7 @@ async function create_epic(input: CreateEpicInput): Promise<number> {
 	console.info(`📋 Created epic: ${url}`)
 	await apply_dependencies({ children: input.children, is_ordered: input.is_ordered })
 	await fill_run_command(epic_number, input)
-	console.info(`▶ Run the children with: ${git_epic_body.format_run_command(epic_number)}`)
+	console.info(`▶ Run the children with: ${epic_body.format_run_command(epic_number)}`)
 
 	return SUCCESS_EXIT_CODE
 }
@@ -123,7 +123,7 @@ interface PromoteEpicInput {
 // The issue being promoted, or the reason it cannot be. Refused when it already carries the epic
 // sections — a second append would give the auto-close two task lists to disagree about.
 async function read_promotion_subject(epic_number: number): Promise<EpicSubject | undefined> {
-	const subject = git_epic_validate.parse_epic_subject(
+	const subject = epic_validate.parse_epic_subject(
 		await git_gh_command.issue_get_labels_and_body(String(epic_number)),
 	)
 
@@ -133,8 +133,8 @@ async function read_promotion_subject(epic_number: number): Promise<EpicSubject
 		return undefined
 	}
 
-	if (git_epic_promote.has_conflicting_tracking(subject.body)) {
-		const reason = git_epic_promote.conflict_reason(subject.body)
+	if (epic_promote.has_conflicting_tracking(subject.body)) {
+		const reason = epic_promote.conflict_reason(subject.body)
 
 		console.error(`✖ Cannot promote #${String(epic_number)}: ${reason}.`)
 
@@ -144,16 +144,16 @@ async function read_promotion_subject(epic_number: number): Promise<EpicSubject
 	return subject
 }
 
-// Write the promoted body and apply the label. The label is what `git-epic-close.ts` filters on, so
+// Write the promoted body and apply the label. The label is what `epic-close.ts` filters on, so
 // an unlabelled issue is one the auto-close skips forever — a failure there is reported rather than
 // logged past.
 async function write_promotion(
 	input: PromoteEpicInput,
 	existing_body: string | undefined,
 ): Promise<number> {
-	const body = git_epic_promote.build_promoted_body({ ...input, body: existing_body })
+	const body = epic_promote.build_promoted_body({ ...input, body: existing_body })
 
-	const tracking_error = git_epic_promote.find_tracking_error(body, input.children)
+	const tracking_error = epic_promote.find_tracking_error(body, input.children)
 
 	if (tracking_error !== undefined) {
 		console.error(`✖ ${tracking_error}`)
@@ -190,14 +190,14 @@ async function promote_epic(input: PromoteEpicInput): Promise<number> {
 
 	console.info(`📋 Promoted #${String(input.epic_number)} to an epic.`)
 	await apply_dependencies({ children: input.children, is_ordered: input.is_ordered })
-	console.info(`▶ Run the children with: ${git_epic_body.format_run_command(input.epic_number)}`)
+	console.info(`▶ Run the children with: ${epic_body.format_run_command(input.epic_number)}`)
 
 	return SUCCESS_EXIT_CODE
 }
 
 async function check_epic(epic_number: number): Promise<number> {
 	const raw = await git_gh_command.issue_get_labels_and_body(String(epic_number))
-	const subject = git_epic_validate.parse_epic_subject(raw)
+	const subject = epic_validate.parse_epic_subject(raw)
 
 	if (subject === undefined) {
 		console.error(`✖ Could not read issue #${String(epic_number)}.`)
@@ -205,19 +205,19 @@ async function check_epic(epic_number: number): Promise<number> {
 		return FAILURE_EXIT_CODE
 	}
 
-	const results = git_epic_validate.validate_epic(subject)
+	const results = epic_validate.validate_epic(subject)
 
-	console.info(git_epic_validate.format_check_report(subject.number, results))
+	console.info(epic_validate.format_check_report(subject.number, results))
 
-	return git_epic_validate.is_epic_valid(results) ? SUCCESS_EXIT_CODE : FAILURE_EXIT_CODE
+	return epic_validate.is_epic_valid(results) ? SUCCESS_EXIT_CODE : FAILURE_EXIT_CODE
 }
 
-const git_epic_run = {
+const epic_run = {
 	parse_created_number,
 	create_epic,
 	promote_epic,
 	check_epic,
 }
 
-export { git_epic_run, EPIC_LABEL_COLOR, EPIC_LABEL_DESCRIPTION, FAILURE_EXIT_CODE }
+export { epic_run, EPIC_LABEL_COLOR, EPIC_LABEL_DESCRIPTION, FAILURE_EXIT_CODE }
 export type { CreateEpicInput, PromoteEpicInput }

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

@@ -1,8 +1,8 @@
-import { git_epic_parse } from './git-epic-parse'
+import { epic_parse } from './epic-parse'
 
 // Locating a `## <Name>` section inside an epic body, as the shape every rewrite of one needs.
 //
-// It was `git-epic-add-body.ts`'s private half: that file finds the `Dependencies` section so a
+// It was `epic-add-body.ts`'s private half: that file finds the `Dependencies` section so a
 // declaration is replaced inside it rather than wherever a declaration-shaped line happens to sit.
 // `## Decisions` needs the identical search, and a second copy of it is the clone `CLAUDE.md`
 // prohibits — the fence mask especially, since a heading inside a fenced block is an illustration and
@@ -29,13 +29,13 @@ interface SectionRange {
 	end: number
 }
 
-// Accepts the body or the lines it was already split into: `git-epic-add-body.ts` holds both forms at
+// Accepts the body or the lines it was already split into: `epic-add-body.ts` holds both forms at
 // different points of one rewrite, and `join`/`split` round-trip exactly, so one function serves both
 // rather than the caller re-deriving a mask that has to agree with this one.
 function to_body_lines(source: string | ReadonlyArray<string>): BodyLines {
 	const lines = typeof source === 'string' ? source.split('\n') : source
 
-	return { lines, mask: git_epic_parse.fence_mask(lines.join('\n')) }
+	return { lines, mask: epic_parse.fence_mask(lines.join('\n')) }
 }
 
 function is_readable(input: BodyLines, index: number): boolean {
@@ -87,12 +87,12 @@ function is_in_range(index: number, range: SectionRange): boolean {
 	return index >= range.start && index < range.end
 }
 
-const git_epic_sections = {
+const epic_sections = {
 	to_body_lines,
 	find_indices,
 	find_section_range,
 	is_in_range,
 }
 
-export { git_epic_sections }
+export { epic_sections }
 export type { BodyLines, SectionRange }

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

@@ -1,6 +1,6 @@
-import { git_epic_parse } from './git-epic-parse'
-import { to_issue_reference } from './git-epic-reference'
-import { EPIC_LABEL } from './issue-labels'
+import { EPIC_LABEL } from '#scripts/git/issue-labels'
+import { epic_parse } from './epic-parse'
+import { to_issue_reference } from './epic-reference'
 
 // Whether an issue is an epic this repository's writers may edit, and why it is not when it is not.
 //
@@ -47,7 +47,7 @@ function find_epic_shape_error(subject: EpicShapeSubject, body: string): string
 		return `${reference} does not carry the \`${EPIC_LABEL}\` label, so it is not an epic. ${promote_remedy(subject.epic_number)}`
 	}
 
-	if (git_epic_parse.has_external_task_list_entry(body)) {
+	if (epic_parse.has_external_task_list_entry(body)) {
 		return `${reference} tracks a child in another repository; editing the declared order of a cross-repository epic is joshuafolkken/kit#864's scope, not this command's.`
 	}
 
@@ -68,14 +68,14 @@ function find_subject_error(
 	}
 
 	// A declaration an edit can be relative to: exactly one of the two machine-readable forms.
-	return git_epic_parse.has_machine_readable_declaration(subject.body)
+	return epic_parse.has_machine_readable_declaration(subject.body)
 		? undefined
 		: missing_declaration_error(subject.epic_number)
 }
 
-const git_epic_shape = {
+const epic_shape = {
 	find_subject_error,
 }
 
-export { git_epic_shape }
+export { epic_shape }
 export type { EpicShapeSubject }