@joshuafolkken/kit 1.1035.0 → 1.1094.0

package/scripts/init/start-plan.ts

@@ -8,6 +8,7 @@ interface StartOptions {
 	is_yes: boolean
 	is_github: boolean
 	visibility: Visibility
+	init_command: string | undefined
 }
 
 type StartStep = 'git_init' | 'initialize' | 'commit' | 'repository' | 'labels' | 'setup_pr'
@@ -137,20 +138,31 @@ function github_consent(
 	}
 }
 
+// A run whose initialize step was handed to a caller's command names that command wherever the step
+// is printed, so the plan, the progress and a failure all say what actually runs (#2872).
+function step_labels(init_command: string | undefined): Readonly<Record<StartStep, string>> {
+	if (init_command === undefined) return STEP_LABELS
+
+	return { ...STEP_LABELS, initialize: `Initialize with ${init_command}` }
+}
+
 // What a failed run prints, so the user can tell how far it got before deciding how to resume.
 function progress_report(
 	failed: StartStep,
 	completed: ReadonlyArray<StartStep>,
 	cause: string,
+	labels: Readonly<Record<StartStep, string>> = STEP_LABELS,
 ): string {
-	const done =
-		completed.length === 0 ? 'nothing' : completed.map((step) => STEP_LABELS[step]).join('; ')
+	const done = completed.length === 0 ? 'nothing' : completed.map((step) => labels[step]).join('; ')
 
-	return `josh start stopped at: ${STEP_LABELS[failed]}\nCompleted: ${done}\nCause: ${cause}`
+	return `josh start stopped at: ${labels[failed]}\nCompleted: ${done}\nCause: ${cause}`
 }
 
-function plan_summary(steps: ReadonlyArray<StartStep>): string {
-	const lines = steps.map((step, index) => `  ${String(index + 1)}. ${STEP_LABELS[step]}`)
+function plan_summary(
+	steps: ReadonlyArray<StartStep>,
+	labels: Readonly<Record<StartStep, string>> = STEP_LABELS,
+): string {
+	const lines = steps.map((step, index) => `  ${String(index + 1)}. ${labels[step]}`)
 
 	return ['josh start will:', ...lines].join('\n')
 }
@@ -161,6 +173,7 @@ const start_plan = {
 	github_consent,
 	progress_report,
 	plan_summary,
+	step_labels,
 	STEP_LABELS,
 }
 export { start_plan }

package/scripts/init/start-setup-pr.ts

@@ -1,10 +1,10 @@
-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_issue_write } from '#scripts/git/git-gh-issue-write'
+import { git_gh_api_path } from '#scripts/gh/git-gh-api-path'
+import { git_gh_exec } from '#scripts/gh/git-gh-exec'
+import { git_gh_issue_write } from '#scripts/gh/git-gh-issue-write'
+import { git_pr } from '#scripts/gh/git-pr'
+import { github_issue_url } from '#scripts/gh/github-issue-url'
 import { git_issue, type IssueInfo } from '#scripts/git/git-issue'
-import { git_pr } from '#scripts/git/git-pr'
-import { github_issue_url } from '#scripts/git/github-issue-url'
-import { IGNORE_FOR_RELEASE_LABEL } from '#scripts/git/issue-labels'
+import { IGNORE_FOR_RELEASE_LABEL } from '#scripts/issue/issue-labels'
 import { KIT_PACKAGE_NAME } from '#scripts/version/kit-descriptor'
 import { kit_written_paths } from './kit-written-paths'
 import { start_exec } from './start-exec'
@@ -12,15 +12,22 @@ import { start_exec } from './start-exec'
 const SETUP_TITLE = `Set up ${KIT_PACKAGE_NAME}`
 const SETUP_BODY = [
 	`Adds the files \`josh start\` wrote while setting up ${KIT_PACKAGE_NAME}, so main carries the`,
-	'rules, settings and workflows every later Issue is run with. Only the files kit wrote are in the',
-	'pull request; anything else in the working tree is left as it was.',
+	'rules, settings and workflows every later Issue is run with. Only the files the setup wrote are in',
+	'the pull request; anything else in the working tree is left as it was.',
 ].join('\n')
+const NAME_ONLY = '--name-only'
 const NOTHING_TO_COMMIT = 'The kit setup has no changes to commit, so no pull request was opened.'
 const OPEN_SETUP_ISSUES_QUERY = `?state=open&labels=${IGNORE_FOR_RELEASE_LABEL}&per_page=100`
 const FIRST_SETUP_ISSUE_FILTER = `[.[] | select(.title == "${SETUP_TITLE}") | .number][0] // empty`
 
-function lines_of(output: string | undefined): Array<string> {
-	return (output ?? '').split('\n').filter((line) => line.length > 0)
+// Listings are read NUL-separated (`-z`), so a path is never quoted — a name a caller's initialize
+// command wrote need not be ASCII the way kit's own are (#2872).
+function paths_of(output: string | undefined): Array<string> {
+	return (output ?? '').split('\0').filter((listed) => listed.length > 0)
+}
+
+function listing(args: ReadonlyArray<string>, root: string): Array<string> {
+	return paths_of(start_exec.read_output('git', [...args, '-z'], root))
 }
 
 function setup_issue(issue_number: string): IssueInfo {
@@ -42,17 +49,18 @@ function is_setup_branch(branch: string | undefined): boolean {
 }
 
 // Untracked files the ignore rules let through, plus tracked files the setup changed — two plain
-// listings, so nothing has to be parsed out of `git status`. Every kit path is ASCII, so git's
-// quoting of other names never hides one.
+// listings, so nothing has to be parsed out of `git status`.
 function changed_paths(root: string): Array<string> {
-	const untracked = start_exec.read_output(
-		'git',
-		['ls-files', '--others', '--exclude-standard'],
-		root,
-	)
-	const modified = start_exec.read_output('git', ['diff', '--name-only', 'HEAD'], root)
-
-	return [...lines_of(untracked), ...lines_of(modified)]
+	const untracked = listing(['ls-files', '--others', '--exclude-standard'], root)
+	const modified = listing(['diff', NAME_ONLY, 'HEAD'], root)
+
+	return [...untracked, ...modified]
+}
+
+// On the setup branch a failed commit left, that run's `git add` already staged its files, so they
+// read as changed before this run's command ran — the staged ones count as setup output (#2872).
+function carried_paths(root: string, current: string | undefined): Array<string> {
+	return is_setup_branch(current) ? listing(['diff', NAME_ONLY, '--cached'], root) : []
 }
 
 // The Issue carries the release classification the pull request is opened with, so the PR step finds
@@ -113,10 +121,30 @@ function commit_kit_paths(paths: ReadonlyArray<string>, issue: IssueInfo, root:
 	start_exec.run('git', ['commit', '--message', issue.commit_message, '--', ...paths], root)
 }
 
-// Issue → branch → only kit's files committed → push → pull request. The merge is left to a person:
-// it is the one step that changes main.
-async function open(root: string): Promise<void> {
-	const paths = kit_written_paths.select(changed_paths(root))
+// A caller's initialize command writes files kit cannot name, so with a `baseline` — what was already
+// changed before that command ran — everything changed since joins kit's own files, while a change
+// the user had made before the run still stays out (#2872).
+function setup_paths(
+	root: string,
+	baseline: ReadonlyArray<string> | undefined,
+	current: string | undefined,
+): Array<string> {
+	const changed = changed_paths(root)
+	const kit_paths = kit_written_paths.select(changed)
+
+	if (baseline === undefined) return kit_paths
+
+	const carried = carried_paths(root, current)
+	const written = changed.filter((path) => !baseline.includes(path) || carried.includes(path))
+
+	return [...new Set([...kit_paths, ...written])]
+}
+
+// Issue → branch → only the setup's files committed → push → pull request. The merge is left to a
+// person: it is the one step that changes main.
+async function open(root: string, baseline?: ReadonlyArray<string>): Promise<void> {
+	const current = start_exec.read_output('git', ['symbolic-ref', '--short', 'HEAD'], root)
+	const paths = setup_paths(root, baseline, current)
 
 	if (paths.length === 0) {
 		console.info(NOTHING_TO_COMMIT)
@@ -124,7 +152,6 @@ async function open(root: string): Promise<void> {
 		return
 	}
 
-	const current = start_exec.read_output('git', ['symbolic-ref', '--short', 'HEAD'], root)
 	const issue = resolve_issue(current)
 
 	switch_to(issue.branch_name, current, root)

package/scripts/init/start-steps.ts

@@ -2,6 +2,7 @@ import path from 'node:path'
 import { error_text } from '#scripts/lib/error-message'
 import { repository_labels } from '#scripts/repo/repository-labels'
 import { self_sync_guard } from '#scripts/self-sync-guard/self-sync-guard-logic'
+import { parseCommandString } from 'execa'
 import { main as init_main } from './init'
 import { PACKAGE_DIR } from './init-paths'
 import { kit_setup_state } from './kit-setup-state'
@@ -14,6 +15,11 @@ interface StepContext {
 	root: string
 	profile: ProjectProfile
 	visibility: Visibility
+	init_command: string | undefined
+}
+
+interface RunContext extends StepContext {
+	baseline: ReadonlyArray<string> | undefined
 }
 
 const DEFAULT_BRANCH = 'main'
@@ -22,7 +28,7 @@ const GH_INSTALL_HINT =
 const GH_AUTH_HINT =
 	'GitHub CLI is not signed in. Run gh auth login, then run josh start again. Nothing was changed.'
 
-const { succeeds, read_output, run } = start_exec
+const { succeeds, read_output, run, run_local } = start_exec
 
 function read_git_state(root: string, shape: ProjectShape): GitState {
 	const { has_git, has_github } = shape
@@ -67,8 +73,19 @@ function create_git_repository(context: StepContext): void {
 }
 
 // The same setup `josh init` runs, called rather than copied, with the profile the user confirmed.
+// A toolkit that layers its files over kit's (`josh-app init`) names its own setup instead, so every
+// other step and guard stays here rather than in a copy of this command (#2872). That command runs
+// without a shell, is given the same profile, and a non-zero exit stops the run before the commit.
 function initialize(context: StepContext): void {
-	init_main(['--profile', context.profile])
+	if (context.init_command === undefined) {
+		init_main(['--profile', context.profile])
+
+		return
+	}
+
+	const [command = '', ...args] = parseCommandString(context.init_command)
+
+	run_local(command, [...args, '--profile', context.profile], context.root)
 }
 
 function commit_all(context: StepContext): void {
@@ -97,11 +114,22 @@ function add_missing_labels(): void {
 
 // Main already has a history here, so the setup reaches it the way every other change does: through
 // an Issue and a pull request a person merges (joshuafolkken/kit#2816).
-async function open_setup_pull_request(context: StepContext): Promise<void> {
-	await start_setup_pr.open(context.root)
+async function open_setup_pull_request(context: RunContext): Promise<void> {
+	await start_setup_pr.open(context.root, context.baseline)
 }
 
-type StepAction = (context: StepContext) => void | Promise<void>
+// What was already changed before a caller's initialize command ran, read only when the setup pull
+// request will need to tell that command's files from the user's own (#2872).
+function baseline_of(
+	steps: ReadonlyArray<StartStep>,
+	context: StepContext,
+): ReadonlyArray<string> | undefined {
+	if (context.init_command === undefined || !steps.includes('setup_pr')) return undefined
+
+	return start_setup_pr.changed_paths(context.root)
+}
+
+type StepAction = (context: RunContext) => void | Promise<void>
 
 const STEP_ACTIONS: Readonly<Record<StartStep, StepAction>> = {
 	git_init: create_git_repository,
@@ -114,24 +142,29 @@ const STEP_ACTIONS: Readonly<Record<StartStep, StepAction>> = {
 
 async function run_step(
 	step: StartStep,
-	context: StepContext,
+	context: RunContext,
 	completed: ReadonlyArray<StartStep>,
 ): Promise<void> {
 	try {
 		await STEP_ACTIONS[step](context)
 	} catch (error) {
 		const cause = error_text.message_of(error)
+		const labels = start_plan.step_labels(context.init_command)
 
-		throw new Error(start_plan.progress_report(step, completed, cause), { cause: error })
+		throw new Error(start_plan.progress_report(step, completed, cause, labels), { cause: error })
 	}
 }
 
 async function run_steps(steps: ReadonlyArray<StartStep>, context: StepContext): Promise<void> {
+	const labels = start_plan.step_labels(context.init_command)
+	const run_context: RunContext = { ...context, baseline: baseline_of(steps, context) }
+
 	for (const [index, step] of steps.entries()) {
 		const position = `${String(index + 1)}/${String(steps.length)}`
 
-		console.info(`\n[${position}] ${start_plan.STEP_LABELS[step]}`)
-		await run_step(step, context, steps.slice(0, index))
+		console.info(`\n[${position}] ${labels[step]}`)
+		// eslint-disable-next-line no-await-in-loop -- each step builds on what the earlier ones set up
+		await run_step(step, run_context, steps.slice(0, index))
 	}
 }
 

package/scripts/init/start.ts

@@ -14,7 +14,9 @@ import { start_steps } from './start-steps'
 
 const ARGUMENT_START_INDEX = 2
 const READY_MESSAGE = 'GitHub workflow ready. Use kickoff new in your assistant to plan an Issue.'
-const START_USAGE = 'josh start [--profile basic|full] [--yes] [--github] [--public]'
+const START_USAGE =
+	'josh start [--profile basic|full] [--yes] [--github] [--public] [--init-command <command>]'
+const INIT_COMMAND_FLAG = '--init-command'
 const YES_FLAG = '--yes'
 const GITHUB_FLAG = '--github'
 const PUBLIC_FLAG = '--public'
@@ -26,16 +28,42 @@ interface Prepared {
 	choices: Choices
 }
 
-// The switches are peeled off first, so what remains is exactly the `--profile` pair `josh init`
-// accepts — one parser for the profile in both commands.
+interface InitCommandSplit {
+	init_command: string | undefined
+	rest: ReadonlyArray<string>
+}
+
+// A value that is blank or another flag means the command itself was left out, which would otherwise
+// swallow the next switch or hand the initialize step nothing to run.
+function is_command_value(value: string | undefined): value is string {
+	return value !== undefined && value.trim() !== '' && !value.startsWith('-')
+}
+
+// The command arrives as the one argument after its flag and is removed together with it.
+function split_init_command(args: ReadonlyArray<string>): InitCommandSplit {
+	const index = args.indexOf(INIT_COMMAND_FLAG)
+
+	if (index === -1) return { init_command: undefined, rest: args }
+
+	const value = args[index + 1]
+
+	if (!is_command_value(value)) throw new Error(`Usage: ${START_USAGE}`)
+
+	return { init_command: value, rest: args.filter((_, at) => at !== index && at !== index + 1) }
+}
+
+// The switches and the initialize command are peeled off first, so what remains is exactly the
+// `--profile` pair `josh init` accepts — one parser for the profile in both commands.
 function parse_start_options(args: ReadonlyArray<string>): StartOptions {
-	const profile_args = args.filter((argument) => !SWITCHES.has(argument))
+	const { init_command, rest } = split_init_command(args)
+	const profile_args = rest.filter((argument) => !SWITCHES.has(argument))
 
 	return {
 		profile: project_profile.requested_profile(profile_args, START_USAGE),
-		is_yes: args.includes(YES_FLAG),
-		is_github: args.includes(GITHUB_FLAG),
-		visibility: args.includes(PUBLIC_FLAG) ? 'public' : 'private',
+		is_yes: rest.includes(YES_FLAG),
+		is_github: rest.includes(GITHUB_FLAG),
+		visibility: rest.includes(PUBLIC_FLAG) ? 'public' : 'private',
+		init_command,
 	}
 }
 
@@ -83,11 +111,13 @@ function prepare(args: ReadonlyArray<string>, is_tty: boolean, root: string): Pr
 async function main(args: ReadonlyArray<string>, is_tty: boolean): Promise<void> {
 	const { steps, interaction, choices } = prepare(args, is_tty, process.cwd())
 
-	console.info(start_plan.plan_summary(steps))
-	const profile = await resolve_profile(choices, interaction)
 	const { root, options } = choices
+	const { visibility, init_command } = options
+
+	console.info(start_plan.plan_summary(steps, start_plan.step_labels(init_command)))
+	const profile = await resolve_profile(choices, interaction)
 
-	await start_steps.run_steps(steps, { root, profile, visibility: options.visibility })
+	await start_steps.run_steps(steps, { root, profile, visibility, init_command })
 	console.info(`\n${READY_MESSAGE}`)
 }
 

package/scripts/issue/behavior-change-lint.ts

@@ -112,7 +112,6 @@ function problems(body: string): ReadonlyArray<string> {
 
 const behavior_change_lint = {
 	is_target,
-	missing_headings,
 	firing_point_name,
 	problems,
 	REQUIRED_HEADINGS,

package/scripts/issue/defect-rate-cli.ts

@@ -1,8 +1,8 @@
 #!/usr/bin/env tsx
 import { fileURLToPath } from 'node:url'
 import { parseArgs } from 'node:util'
-import { git_gh_command } from '#scripts/git/git-gh-command'
-import { git_gh_exec } from '#scripts/git/git-gh-exec'
+import { git_gh_command } from '#scripts/gh/git-gh-command'
+import { git_gh_exec } from '#scripts/gh/git-gh-exec'
 import { parse_json_array_or_undefined } from '#scripts/git/parse-json-array'
 import { issue_label_schema } from '#scripts/git/schemas'
 import { z } from 'zod'
@@ -160,7 +160,7 @@ async function main(argv: ReadonlyArray<string>): Promise<void> {
 	process.exitCode = await run(argv)
 }
 
-const defect_rate_cli = { USAGE, read_days, search_path, measure_window, run, main }
+const defect_rate_cli = { USAGE, read_days, search_path, measure_window, run }
 
 if (process.argv[1] === fileURLToPath(import.meta.url)) await main(process.argv.slice(ARGV_OFFSET))
 

package/scripts/issue/defect-rate.ts

@@ -1,5 +1,5 @@
-import { has_label_name, INTERRUPT_ROUTE_LABEL } from '#scripts/git/issue-labels'
 import { behavior_change_lint } from './behavior-change-lint'
+import { has_label_name, INTERRUPT_ROUTE_LABEL } from './issue-labels'
 import { markdown_section } from './markdown-section'
 
 // The defect rate of merged work over a window (joshuafolkken/kit#2449): issues filed as defects
@@ -132,7 +132,6 @@ const defect_rate = {
 	filed_query,
 	format,
 	is_above_baseline,
-	is_behavior_change,
 	is_defect,
 	kind_of,
 	measure,

package/scripts/{git → issue}/git-next-issues.ts

@@ -1,12 +1,14 @@
-import { git_gh_command } from './git-gh-command'
+import { git_gh_command } from '#scripts/gh/git-gh-command'
+import { parse_json_array_safe } from '#scripts/git/parse-json-array'
+import { open_issue_schema, type OpenIssueData } from '#scripts/git/schemas'
 import { has_any_label, NOT_DIRECTLY_RUNNABLE_LABELS } from './issue-labels'
-import { parse_json_array_safe } from './parse-json-array'
-import { open_issue_schema, type OpenIssueData } from './schemas'
+import { issue_rank, type DependencyRow } from './issue-rank'
 
 // The next-issues display printed when a workflow completes (#821): up to five open issues in
 // priority order, so the user picks the next run from the completion output instead of opening the
 // issue list. Priority is recency — a newer issue usually encodes the most current understanding
-// of the backlog — with the label-based exclusions below.
+// of the backlog — with the label-based exclusions below, under the ranking keys `issue-rank.ts`
+// defines (joshuafolkken/kit#2928).
 //
 // `prioritize` is also the order `epicrun` picks up `auto-ok` issues in (joshuafolkken/kit#906).
 // The two ask one question — which open issue outside an epic is run next — so they share one
@@ -37,6 +39,34 @@ function compare_newest_first(first: OpenIssueData, second: OpenIssueData): numb
 	return first.createdAt < second.createdAt ? 1 : -1
 }
 
+// A row's blockers by number. **Lossy across repositories**: a blocker elsewhere sharing a number
+// with a row here counts as one of its dependents. The listings this ranks are one repository's own,
+// and `backlog:next` re-ranks its offer from the qualified graph (`backlog-rank.ts`), so the cost is a
+// display row placed one slot off rather than a run started early.
+function dependency_row(issue: OpenIssueData): DependencyRow {
+	return {
+		key: String(issue.number),
+		blockers: (issue.blockedBy?.nodes ?? []).map((blocker) => String(blocker.number)),
+	}
+}
+
+// Every candidate in rank order, uncapped. `backlog:next` takes this rather than `prioritize`, so the
+// `run:solo` gate sees the whole ranking before anything is cut (joshuafolkken/kit#2928).
+function order(
+	issues: ReadonlyArray<OpenIssueData>,
+	completed_issue_number?: number,
+): Array<OpenIssueData> {
+	const candidates = issues
+		.filter((issue) => is_candidate(issue, completed_issue_number))
+		.toSorted(compare_newest_first)
+	const dependents = issue_rank.count_dependents(candidates.map((issue) => dependency_row(issue)))
+
+	return issue_rank.rank(candidates, (issue) => ({
+		labels: (issue.labels ?? []).map((label) => label.name),
+		dependents: dependents.get(String(issue.number)) ?? 0,
+	}))
+}
+
 // **This display deliberately does not drop a blocked issue, and the `auto-ok` pickup deliberately
 // does.** They share this ordering and differ on the set, which reads as an inconsistency and is not
 // one (joshuafolkken/kit#1005).
@@ -50,10 +80,7 @@ function prioritize(
 	issues: ReadonlyArray<OpenIssueData>,
 	completed_issue_number?: number,
 ): Array<OpenIssueData> {
-	return issues
-		.filter((issue) => is_candidate(issue, completed_issue_number))
-		.toSorted(compare_newest_first)
-		.slice(0, DISPLAY_LIMIT)
+	return order(issues, completed_issue_number).slice(0, DISPLAY_LIMIT)
 }
 
 // Empty input yields no lines at all — a bare header with nothing under it reads as an error.
@@ -90,6 +117,8 @@ async function fetch_next_issue_lines(completed_issue_number?: number): Promise<
 }
 
 const git_next_issues = {
+	DISPLAY_LIMIT,
+	order,
 	prioritize,
 	format_lines,
 	fetch_next_issue_lines,

package/scripts/issue/issue-backlinks-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 { parse_json_object_safe } from '#scripts/git/parse-json-array'
 import { z } from 'zod'
 import { issue_backlinks, type UpstreamEntry } from './issue-backlinks'
@@ -90,8 +90,4 @@ async function main(argv: ReadonlyArray<string>): Promise<void> {
 	process.exitCode = await run(argv)
 }
 
-const issue_backlinks_cli = { run, USAGE }
-
 if (process.argv[1] === fileURLToPath(import.meta.url)) await main(process.argv.slice(ARGV_OFFSET))
-
-export { issue_backlinks_cli }

package/scripts/issue/issue-cite-cli.ts

@@ -1,8 +1,8 @@
 #!/usr/bin/env tsx
 import { fileURLToPath } from 'node:url'
 import { parseArgs } from 'node:util'
-import { git_gh_command } from '#scripts/git/git-gh-command'
-import type { IssueRead } from '#scripts/git/git-gh-issue-read'
+import { git_gh_command } from '#scripts/gh/git-gh-command'
+import type { IssueRead } from '#scripts/gh/git-gh-issue-read'
 import { bounded_pool } from '#scripts/lib/bounded-pool'
 import { z } from 'zod'
 import { issue_cite, type CiteTarget } from './issue-cite'
@@ -145,12 +145,8 @@ async function main(args: ReadonlyArray<string>): Promise<void> {
 
 const issue_cite_cli = {
 	USAGE,
-	main,
 	parse_targets,
-	parse_title,
-	report,
 	run,
-	to_line,
 }
 
 if (process.argv[1] === fileURLToPath(import.meta.url)) await main(process.argv.slice(ARGV_OFFSET))

package/scripts/issue/issue-cite.ts

@@ -40,6 +40,23 @@ function citation_line(slug: string, number: string, summary: string): string {
 	return `[#${number}](${issue_url(slug, number)})${SUMMARY_SEPARATOR}${summary}`
 }
 
+// How a listing names one issue, given what it already holds (joshuafolkken/kit#2943). A progress
+// command's output is copied into a report verbatim, so the line it prints is the citation the report
+// carries: the full form when the title is in hand, the bare number-link when only the repository is,
+// and the plain `#N` only when the repository could not be read at all.
+type IssueCiter = (number: string) => string
+
+function citer(slug: string | undefined, titles: ReadonlyMap<string, string>): IssueCiter {
+	return function cite(number: string): string {
+		if (slug === undefined) return `#${number}`
+		const title = titles.get(number)
+
+		return title === undefined
+			? `[#${number}](${issue_url(slug, number)})`
+			: citation_line(slug, number, title)
+	}
+}
+
 function qualified_target(token: string): CiteTarget | undefined {
 	const match = REPO_QUALIFIED.exec(token)
 	if (match === null) return undefined
@@ -88,15 +105,14 @@ function no_repo_line(target: CiteTarget): string {
 }
 
 const issue_cite = {
-	SUMMARY_SEPARATOR,
 	citation_line,
+	citer,
 	issue_url,
-	label,
 	missing_line,
 	no_repo_line,
 	parse_target,
 	unreadable_line,
 }
 
-export type { CiteTarget }
+export type { CiteTarget, IssueCiter }
 export { issue_cite }

package/scripts/issue/issue-classification.ts

@@ -1,10 +1,5 @@
-import {
-	BREAKING_CHANGE_LABEL,
-	BUG_LABEL,
-	ENHANCEMENT_LABEL,
-	has_label_name,
-} from '#scripts/git/issue-labels'
 import { issue_bug_label } from './issue-bug-label'
+import { BREAKING_CHANGE_LABEL, BUG_LABEL, ENHANCEMENT_LABEL, has_label_name } from './issue-labels'
 import { markdown_section } from './markdown-section'
 
 const FEATURE_DECLARATIONS = ['- 目的: 機能追加', '- 目的: 機能改善']
@@ -62,10 +57,7 @@ function problems(body: string): ReadonlyArray<string> {
 }
 
 const issue_classification = {
-	BREAKING_DECLARATION,
 	CLASSIFICATION_LABELS,
-	FEATURE_DECLARATIONS,
-	NON_BUG_DECLARATION,
 	labels_for,
 	problems,
 	required_labels,

package/scripts/issue/issue-closing-pr.ts

@@ -1,7 +1,7 @@
+import { git_gh_api_path } from '#scripts/gh/git-gh-api-path'
+import { git_gh_exec } from '#scripts/gh/git-gh-exec'
+import { git_gh_repo } from '#scripts/gh/git-gh-repo'
 import { git_closes_keyword } from '#scripts/git/git-closes-keyword'
-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_repo } from '#scripts/git/git-gh-repo'
 import { parse_json_object_safe } from '#scripts/git/parse-json-array'
 import { z } from 'zod'
 
@@ -88,6 +88,6 @@ async function read_closing_pr(issue: string): Promise<string | undefined> {
 	}
 }
 
-const issue_closing_pr = { parse_references, pick_closing_pr, read_closing_pr }
+const issue_closing_pr = { read_closing_pr }
 
 export { issue_closing_pr }

package/scripts/issue/issue-comment-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 { cli_body } from '#scripts/josh/cli-body'
 import { error_text } from '#scripts/lib/error-message'
 
@@ -89,7 +89,7 @@ async function main(argv: ReadonlyArray<string>): Promise<void> {
 	process.exitCode = await run(argv)
 }
 
-const issue_comment_cli = { USAGE, main, parse_request, run }
+const issue_comment_cli = { USAGE, run }
 
 if (process.argv[1] === fileURLToPath(import.meta.url)) await main(process.argv.slice(ARGV_OFFSET))
 

package/scripts/issue/issue-file-cli.ts

@@ -3,10 +3,10 @@ import { readFile } from 'node:fs/promises'
 import { fileURLToPath } from 'node:url'
 import { repo_party } from '#scripts/discovery/repo-party'
 import { epic_bundle_cli } from '#scripts/epic/epic-bundle-cli'
-import { git_gh_command } from '#scripts/git/git-gh-command'
-import { git_gh_exec } from '#scripts/git/git-gh-exec'
-import { git_gh_issue_write } from '#scripts/git/git-gh-issue-write'
-import { github_issue_url } from '#scripts/git/github-issue-url'
+import { git_gh_command } from '#scripts/gh/git-gh-command'
+import { git_gh_exec } from '#scripts/gh/git-gh-exec'
+import { git_gh_issue_write } from '#scripts/gh/git-gh-issue-write'
+import { github_issue_url } from '#scripts/gh/github-issue-url'
 import { error_text } from '#scripts/lib/error-message'
 import { issue_file, type FileArguments } from './issue-file'
 import { issue_lint_cli } from './issue-lint-cli'
@@ -182,7 +182,7 @@ async function main(argv: ReadonlyArray<string>): Promise<void> {
 	process.exitCode = await run(argv)
 }
 
-const issue_file_cli = { USAGE, THIRD_PARTY_MESSAGE, UNKNOWN_REPO_MESSAGE, run, main }
+const issue_file_cli = { THIRD_PARTY_MESSAGE, run }
 
 if (process.argv[1] === fileURLToPath(import.meta.url)) await main(process.argv.slice(ARGV_OFFSET))
 

package/scripts/issue/issue-file.ts

@@ -1,9 +1,9 @@
 import { parseArgs } from 'node:util'
 import { epic_issue } from '#scripts/epic/epic-issue'
-import { github_issue_url } from '#scripts/git/github-issue-url'
-import { DEPTH_LABEL_ORDER, FILING_ROUTE_LABELS, has_label_name } from '#scripts/git/issue-labels'
+import { github_issue_url } from '#scripts/gh/github-issue-url'
 import { issue_backlinks } from './issue-backlinks'
 import { issue_classification } from './issue-classification'
+import { DEPTH_LABEL_ORDER, FILING_ROUTE_LABELS, has_label_name } from './issue-labels'
 import { markdown_section } from './markdown-section'
 
 // The decisions behind `josh issue:file` (joshuafolkken/kit#2808), kept apart from the command that