@joshuafolkken/kit 1.883.0 → 1.921.0

package/scripts/git/git-pr.ts

@@ -1,3 +1,4 @@
+import { pr_classification, type ReleaseClassification } from '#scripts/ci/pr-classification'
 import { animation_helpers, type AnimationOptions } from './animation-helpers'
 import { git_gh_command } from './git-gh-command'
 import type { IssueInfo } from './git-issue'
@@ -12,7 +13,11 @@ import { pr_info_schema } from './schemas'
 // in the same instant the pull request was created it can answer nothing, and `pr_get_url` folds
 // "not there yet" and "the read failed" into the same `undefined`. The five-second sleep used to
 // cover that gap incidentally.
-async function create_pr(title: string, body: string): Promise<string | undefined> {
+async function create_pr(
+	title: string,
+	body: string,
+	label: ReleaseClassification,
+): Promise<string | undefined> {
 	const config: AnimationOptions<string> = {
 		icon_selector: () => '✅',
 		error_message: 'Failed to create PR',
@@ -22,7 +27,7 @@ async function create_pr(title: string, body: string): Promise<string | undefine
 	try {
 		return await animation_helpers.execute_with_animation(
 			'Creating pull request...',
-			async () => await git_gh_command.pr_create(title, body),
+			async () => await git_gh_command.pr_create(title, body, label),
 			config,
 		)
 	} catch (error) {
@@ -72,8 +77,13 @@ async function report_open_pr(branch_name: string, created_url?: string): Promis
 
 const PR_STATE_MERGED = 'MERGED'
 
-async function create_and_report(title: string, body: string, branch_name: string): Promise<void> {
-	const created_url = await create_pr(title, body)
+async function create_and_report(
+	title: string,
+	body: string,
+	branch_name: string,
+	label: ReleaseClassification,
+): Promise<void> {
+	const created_url = await create_pr(title, body, label)
 
 	await report_open_pr(branch_name, created_url)
 }
@@ -113,7 +123,9 @@ async function report_existing_pr(
 	body: string,
 	branch_name: string,
 	should_replace_body: boolean,
+	label: ReleaseClassification,
 ): Promise<void> {
+	await git_gh_command.pr_ensure_classification(branch_name, label)
 	if (should_replace_body) await git_gh_command.pr_update_body(branch_name, body)
 
 	await report_open_pr(branch_name)
@@ -123,35 +135,36 @@ async function handle_existing_pr(
 	title: string,
 	body: string,
 	branch_name: string,
-	should_replace_body: boolean,
+	options: { label: ReleaseClassification; should_replace_body: boolean },
 ): Promise<void> {
 	const pr_state_result = await get_pr_state_safe(branch_name)
 
 	if (is_pr_state_merged(pr_state_result)) {
 		git_pr_messages.display_merged_pr_message()
-		await create_and_report(title, body, branch_name)
+		await create_and_report(title, body, branch_name, options.label)
 
 		return
 	}
 
-	await report_existing_pr(body, branch_name, should_replace_body)
+	await report_existing_pr(body, branch_name, options.should_replace_body, options.label)
 }
 
 async function create(
 	title: string,
 	body: string,
 	branch_name: string,
-	should_replace_body = false,
+	options: { label: ReleaseClassification; should_replace_body?: boolean },
 ): Promise<void> {
+	const { label, should_replace_body = false } = options
 	const has_pr = await git_gh_command.pr_exists(branch_name)
 
 	if (!has_pr) {
-		await create_and_report(title, body, branch_name)
+		await create_and_report(title, body, branch_name, label)
 
 		return
 	}
 
-	await handle_existing_pr(title, body, branch_name, should_replace_body)
+	await handle_existing_pr(title, body, branch_name, { label, should_replace_body })
 }
 
 function build_title(issue_info: IssueInfo): string {
@@ -166,11 +179,47 @@ function build_body(issue_info: IssueInfo, extra_body?: string): string {
 	return `${closes}\n\n${extra_body}`
 }
 
+async function existing_pr_label(branch_name: string): Promise<ReleaseClassification | undefined> {
+	if (!(await git_gh_command.pr_exists(branch_name))) return undefined
+	if (is_pr_state_merged(await get_pr_state_safe(branch_name))) return undefined
+
+	return await git_gh_command.pr_get_classification(branch_name)
+}
+
+async function create_for_issue(
+	issue_info: IssueInfo,
+	extra_body: string | undefined,
+	label: ReleaseClassification,
+): Promise<void> {
+	await create(
+		build_title(issue_info),
+		build_body(issue_info, extra_body),
+		issue_info.branch_name,
+		{
+			label,
+			should_replace_body: extra_body !== undefined,
+		},
+	)
+}
+
 async function create_with_issue_info(issue_info: IssueInfo, extra_body?: string): Promise<void> {
-	const title = build_title(issue_info)
-	const body = build_body(issue_info, extra_body)
+	const existing_label = await existing_pr_label(issue_info.branch_name)
+
+	if (existing_label !== undefined) {
+		await create_for_issue(issue_info, extra_body, existing_label)
+
+		return
+	}
+
+	const issue_json = await git_gh_command.issue_view_json(issue_info.number, 'labels,body')
+
+	if (issue_json === undefined) {
+		throw new Error(`Could not read issue #${issue_info.number} for release classification`)
+	}
+
+	const label = pr_classification.select_issue_classification(issue_json)
 
-	await create(title, body, issue_info.branch_name, extra_body !== undefined)
+	await create_for_issue(issue_info, extra_body, label)
 }
 
 const git_pr = {

package/scripts/git/issue-labels.ts

@@ -2,6 +2,9 @@
 // labeler and the next-issues display all key on these exact strings, and a drifted copy would
 // fail silently — an epic filtered on the wrong name is simply never closed or never excluded.
 const EPIC_LABEL = 'epic'
+const BUG_LABEL = 'bug'
+const ENHANCEMENT_LABEL = 'enhancement'
+const BREAKING_CHANGE_LABEL = 'breaking-change'
 const IN_PROGRESS_LABEL = 'in-progress'
 // Parks a child that cannot advance without a person deciding something. `epic:next` is what reads
 // it: a parked child is why a run reports "nothing left that time will fix" rather than waiting
@@ -237,6 +240,9 @@ const REVIEW_ROUND2_SKIPPED_LABEL = 'review-round2-skipped'
 
 const ALL_LABELS: ReadonlySet<string> = new Set([
 	EPIC_LABEL,
+	BUG_LABEL,
+	ENHANCEMENT_LABEL,
+	BREAKING_CHANGE_LABEL,
 	IN_PROGRESS_LABEL,
 	NEEDS_DECISION_LABEL,
 	AUTO_OK_LABEL,
@@ -256,12 +262,15 @@ export {
 	ALL_LABELS,
 	ALREADY_DONE_LABEL,
 	AUTO_OK_LABEL,
+	BUG_LABEL,
+	BREAKING_CHANGE_LABEL,
 	depth_label_of,
 	DEPTH_0_LABEL,
 	DEPTH_1_LABEL,
 	DEPTH_2_LABEL,
 	DEPTH_LABEL_ORDER,
 	DEPTH_LABELS,
+	ENHANCEMENT_LABEL,
 	EPIC_LABEL,
 	FILING_ROUTE_LABELS,
 	has_any_label,

package/scripts/init/distributed-paths.ts

@@ -20,8 +20,10 @@ const GITHUB_REPO_TREE_BASE = 'https://github.com/joshuafolkken/kit/tree/main/'
 // The consumer imports kit's published, already path-transformed rules. A tracked bootstrap note
 // remains readable before installation, while the rule body stays in the package (kit#1878).
 const CLAUDE_MD_IMPORT_LINE = '@node_modules/@joshuafolkken/kit/dist/CLAUDE.md'
-const CLAUDE_MD_BOOTSTRAP =
+const OLD_CLAUDE_MD_BOOTSTRAP =
 	'> Fresh checkout: if kit is not installed, run `pnpm install` first, then reread this file before doing any other work.'
+const CLAUDE_MD_BOOTSTRAP =
+	'> Fresh checkout: before `pnpm install`, run `pnpm config get "@joshuafolkken:registry"` from the project root to check the effective registry, including user-level settings. If it points to GitHub Packages, [set up authentication](https://github.com/joshuafolkken/kit/blob/main/docs/authentication.md#1-get-a-token-from-the-gh-cli) first. Then run `pnpm install` and reread this file before doing any other work.'
 
 // A span containing `*` is excluded: it is a **glob**, not a reference to a file a consumer can
 // open. A distributed document that writes a directory set as `prompts/**` means "anything beneath
@@ -84,13 +86,15 @@ function transform_distributed_paths(content: string): string {
 function ensure_claude_md_import(existing: string | undefined): string {
 	if (existing === undefined) return `${CLAUDE_MD_BOOTSTRAP}\n\n${CLAUDE_MD_IMPORT_LINE}\n`
 
-	if (existing.includes(CLAUDE_MD_IMPORT_LINE)) {
-		if (existing.includes(CLAUDE_MD_BOOTSTRAP)) return existing
+	const updated = existing.replace(OLD_CLAUDE_MD_BOOTSTRAP, () => CLAUDE_MD_BOOTSTRAP)
+
+	if (updated.includes(CLAUDE_MD_IMPORT_LINE)) {
+		if (updated.includes(CLAUDE_MD_BOOTSTRAP)) return updated
 
-		return `${CLAUDE_MD_BOOTSTRAP}\n\n${existing}`
+		return `${CLAUDE_MD_BOOTSTRAP}\n\n${updated}`
 	}
 
-	return `${CLAUDE_MD_BOOTSTRAP}\n\n${CLAUDE_MD_IMPORT_LINE}\n\n${existing}`
+	return `${CLAUDE_MD_BOOTSTRAP}\n\n${CLAUDE_MD_IMPORT_LINE}\n\n${updated}`
 }
 
 const distributed_paths = {

package/scripts/init/hook-command-bootstrap.ts

@@ -10,6 +10,11 @@ interface HookResult {
 	stderr: string
 }
 
+interface CheckoutOptions {
+	git_overrides?: Record<string, string>
+	is_external_git?: boolean
+}
+
 function create_partial_install(temporary_root: string): void {
 	const package_root = path.join(temporary_root, 'node_modules/@joshuafolkken/kit')
 	const hook_path = path.join(package_root, 'dist/hooks/pretool-guard.js')
@@ -19,25 +24,52 @@ function create_partial_install(temporary_root: string): void {
 	writeFileSync(hook_path, "process.stdout.write('guard ran')")
 }
 
-function run_in_temporary_checkout(command: string, is_partial_install = false): HookResult {
-	const temporary_root = mkdtempSync(path.join(tmpdir(), 'kit-hook-bootstrap-'))
+function execution_directory(temporary_root: string, is_nested: boolean): string {
+	if (!is_nested) return temporary_root
+
+	const nested_root = path.join(temporary_root, 'src')
+
+	mkdirSync(nested_root)
+
+	return nested_root
+}
+
+function checkout_environment(temporary_root: string, options: CheckoutOptions): NodeJS.ProcessEnv {
+	const metadata_root = path.join(temporary_root, 'metadata')
 	const git_environment = {
 		...process.env,
 		...git_location_environment.location_free_environment(),
 	}
+	const git_arguments = options.is_external_git
+		? ['init', '--bare', '-q', metadata_root]
+		: ['init', '-q']
+
+	spawnSync('git', git_arguments, { cwd: temporary_root, env: git_environment })
+
+	if (options.is_external_git) {
+		return { ...git_environment, GIT_DIR: metadata_root, GIT_WORK_TREE: temporary_root }
+	}
+
+	return { ...git_environment, ...options.git_overrides }
+}
+
+function run_in_temporary_checkout(
+	command: string,
+	is_partial_install = false,
+	is_nested = false,
+	options: CheckoutOptions = {},
+): HookResult {
+	const temporary_root = mkdtempSync(path.join(tmpdir(), 'kit-hook-bootstrap-'))
 
 	try {
-		spawnSync('git', ['init', '-q'], {
-			cwd: temporary_root,
-			env: git_environment,
-		})
+		const hook_environment = checkout_environment(temporary_root, options)
 
 		if (is_partial_install) create_partial_install(temporary_root)
 
 		const { status, stdout, stderr } = spawnSync('sh', ['-c', command], {
-			cwd: temporary_root,
+			cwd: execution_directory(temporary_root, is_nested),
 			encoding: 'utf8',
-			env: git_environment,
+			env: hook_environment,
 		})
 
 		return { status, stdout, stderr }

package/scripts/init/hook-command-rewrite.ts

@@ -1,3 +1,4 @@
+import { GIT_LOCATION_VARIABLES } from '#scripts/git/git-location-environment'
 import { claude_plugin_config } from './claude-plugin-config'
 import { hook_launch } from './hook-launch'
 
@@ -15,7 +16,7 @@ import { hook_launch } from './hook-launch'
 
 const PNPM_JOSH_PREFIX = 'pnpm josh '
 const CODEX_ADAPTER_SOURCE = 'pnpm exec tsx scripts/hooks/codex-hook-adapter.ts'
-// Relative to the consumer's project root, which is the working directory a Claude Code hook runs in.
+// Relative to the consumer's project root, which hook commands select before using this path.
 // The path is the plugin marketplace's `node_modules` location plus the built entry `bin.josh` names.
 const BUNDLE_INVOCATION = `node ${claude_plugin_config.MARKETPLACE_PATH}/dist/josh.js `
 // The per-hook bundle directory a fresh clone builds, and where it lives inside the installed package.
@@ -26,7 +27,8 @@ const MISSING_INSTALL_NOTICE = 'kit hooks inactive: run pnpm install, then rerea
 const MISSING_INSTALL_GUARD = `if [ ! -f ${CONSUMER_PACKAGE_MANIFEST} ]; then echo '${MISSING_INSTALL_NOTICE}' >&2; exit 0; fi; `
 const CODEX_ADAPTER_BUNDLE = `node ${CONSUMER_HOOK_BUNDLE_DIR}codex-hook-adapter.js`
 const CODEX_HOOKS_DESTINATION = '.codex/hooks.json'
-const CODEX_ROOT_PREFIX = String.raw`cd \"$(git rev-parse --show-toplevel)\" && `
+const GIT_UNSET_OPTIONS = GIT_LOCATION_VARIABLES.map((name) => `-u ${name}`).join(' ')
+const PROJECT_ROOT_PREFIX = String.raw`if project_root=\"$(env ${GIT_UNSET_OPTIONS} git rev-parse --show-toplevel 2>/dev/null)\"; then unset ${GIT_LOCATION_VARIABLES.join(' ')}; else project_root=\"$(git rev-parse --show-toplevel)\" || exit 1; fi; cd \"$project_root\" && `
 // Capture the value of every `"command"` field, escapes and all, so the rewrites below touch command
 // values alone — never an echo reminder's prose or a `"description"` that merely mentions the string.
 const COMMAND_FIELD = /("command":\s*")((?:[^"\\]|\\.)*)(")/gu
@@ -61,7 +63,9 @@ function rewrite_command_value(value: string): string {
 function rewrite_hook_commands(content: string, is_codex = false): string {
 	return content.replaceAll(COMMAND_FIELD, (_match, open: string, value: string, close: string) => {
 		const rewritten = rewrite_command_value(value)
-		const prefix = is_codex && !rewritten.startsWith(CODEX_ROOT_PREFIX) ? CODEX_ROOT_PREFIX : ''
+		const should_select_root = is_codex || rewritten.includes(claude_plugin_config.MARKETPLACE_PATH)
+		const prefix =
+			should_select_root && !rewritten.startsWith(PROJECT_ROOT_PREFIX) ? PROJECT_ROOT_PREFIX : ''
 
 		return `${open}${prefix}${rewritten}${close}`
 	})

package/scripts/init/init-actions.ts

@@ -1,10 +1,17 @@
 import { readFileSync } from 'node:fs'
 import path from 'node:path'
+import { json_format } from '#scripts/config-merge/json-format'
 import { string_array_schema, vscode_settings_schema } from '#scripts/lib/schemas'
 import { init_logic } from './init-logic'
 import { package_path, PROJECT_ROOT } from './init-paths'
+import type { ProjectShape } from './project-profile'
 
 const PRETTIER_CONFIG_JS = 'prettier.config.js'
+const STATIC_PRETTIER_CONFIG = 'prettier.config.mjs'
+const VSCODE_EXTENSIONS_PATH = '.vscode/extensions.json'
+const VSCODE_SETTINGS_PATH = '.vscode/settings.json'
+const TSCONFIG_PATH = 'tsconfig.json'
+const LEFTHOOK_PATH = 'lefthook.yml'
 
 interface FileAction {
 	dest: string
@@ -38,13 +45,13 @@ function build_vscode_actions(): ReadonlyArray<FileAction> {
 
 	return [
 		{
-			dest: '.vscode/extensions.json',
+			dest: VSCODE_EXTENSIONS_PATH,
 			create: () => read_package_file(extensions_path),
 			merge: (existing) =>
 				init_logic.merge_json_array_field(existing, 'recommendations', recommendations),
 		},
 		{
-			dest: '.vscode/settings.json',
+			dest: VSCODE_SETTINGS_PATH,
 			create: () =>
 				init_logic.strip_kit_only_vscode_settings_content(read_package_file(settings_path)),
 			merge: (existing) => init_logic.merge_json_object(existing, settings_data),
@@ -52,6 +59,64 @@ function build_vscode_actions(): ReadonlyArray<FileAction> {
 	]
 }
 
+const STATIC_EXTENSIONS = [
+	'streetsidesoftware.code-spell-checker',
+	'pkief.material-icon-theme',
+	'usernamehw.errorlens',
+	'anthropic.claude-code',
+	'github.github-vscode-theme',
+]
+const PRETTIER_EXTENSION = 'esbenp.prettier-vscode'
+const DEFAULT_FORMATTER = 'editor.defaultFormatter'
+const FORMAT_ON_SAVE = 'editor.formatOnSave'
+const STATIC_LANGUAGES = ['[html]', '[css]', '[javascript]']
+
+function static_settings(): Record<string, Record<string, unknown>> {
+	const formatter = { [DEFAULT_FORMATTER]: PRETTIER_EXTENSION, [FORMAT_ON_SAVE]: true }
+
+	return Object.fromEntries(STATIC_LANGUAGES.map((language) => [language, formatter]))
+}
+
+function build_static_settings_action(): FileAction {
+	const settings = static_settings()
+
+	return build_action(
+		VSCODE_SETTINGS_PATH,
+		() => json_format.format_json(settings),
+		(existing) => init_logic.merge_json_object(existing, settings),
+	)
+}
+
+function build_static_vscode_actions(shape: ProjectShape): ReadonlyArray<FileAction> {
+	const recommendations = shape.has_web
+		? [...STATIC_EXTENSIONS, PRETTIER_EXTENSION]
+		: STATIC_EXTENSIONS
+	const actions: Array<FileAction> = [
+		build_action(
+			VSCODE_EXTENSIONS_PATH,
+			() => json_format.format_json({ recommendations }),
+			(existing) => init_logic.merge_json_array_field(existing, 'recommendations', recommendations),
+		),
+	]
+
+	if (shape.has_web) actions.push(build_static_settings_action())
+
+	return actions
+}
+
+function build_static_tsconfig_action(): FileAction {
+	return build_action(
+		TSCONFIG_PATH,
+		() => json_format.format_json({ extends: init_logic.get_tsconfig_extends_entry() }),
+		(existing) =>
+			init_logic.merge_tsconfig_extends(
+				existing,
+				init_logic.get_tsconfig_extends_entry(),
+				PROJECT_ROOT,
+			),
+	)
+}
+
 // Create-only: the rule list is a project-owned allowlist once it exists, so a consumer
 // that added custom rules or disabled a noisy one must not have that overwritten.
 function build_secretlint_action(): FileAction {
@@ -65,7 +130,7 @@ function build_secretlint_action(): FileAction {
 // migrate a retired `*.jsonc` preset path only once its renamed target is installed (#681).
 function build_tsconfig_action(): FileAction {
 	return build_action(
-		'tsconfig.json',
+		TSCONFIG_PATH,
 		() => init_logic.generate_tsconfig(),
 		(existing) =>
 			init_logic.merge_tsconfig_exclude(
@@ -89,7 +154,7 @@ function build_config_file_actions(): ReadonlyArray<FileAction> {
 			(existing) => init_logic.merge_cspell_import(existing, init_logic.get_cspell_import_value()),
 		),
 		build_action(
-			'lefthook.yml',
+			LEFTHOOK_PATH,
 			() => init_logic.generate_lefthook_config(),
 			(existing) => init_logic.merge_lefthook_extends(existing, lefthook_extends),
 		),
@@ -122,9 +187,29 @@ function build_gitignore_action(): FileAction {
 	)
 }
 
-function build_file_actions(): ReadonlyArray<FileAction> {
+function build_static_actions(shape: ProjectShape): ReadonlyArray<FileAction> {
+	const actions: Array<FileAction> = []
+	if (shape.has_git) actions.push(build_gitignore_action())
+	if (shape.has_typescript) actions.push(build_static_tsconfig_action())
+
+	if (shape.has_web) {
+		actions.push({
+			dest: STATIC_PRETTIER_CONFIG,
+			create: () =>
+				"import { config } from '@joshuafolkken/kit/prettier/static'\n\nexport default config\n",
+		})
+	}
+
+	actions.push(...build_static_vscode_actions(shape))
+
+	return actions
+}
+
+function build_file_actions(shape?: ProjectShape): ReadonlyArray<FileAction> {
+	if (shape?.profile === 'static') return build_static_actions(shape)
+
 	return [
-		build_gitignore_action(),
+		...(shape?.has_git === false ? [] : [build_gitignore_action()]),
 		build_action(
 			'.npmrc',
 			() => init_logic.generate_npmrc(),
@@ -137,7 +222,9 @@ function build_file_actions(): ReadonlyArray<FileAction> {
 			(existing) => init_logic.merge_prettier_config(existing),
 		),
 		build_playwright_action(),
-		...build_config_file_actions(),
+		...build_config_file_actions().filter(
+			(action) => shape?.has_git !== false || action.dest !== LEFTHOOK_PATH,
+		),
 	]
 }
 

package/scripts/init/init-ai-copy.ts

@@ -12,9 +12,31 @@ import { transform_copied_content } from './init-copy-content'
 import { init_logic } from './init-logic'
 import { package_path, PROJECT_ROOT } from './init-paths'
 import { init_sonar } from './init-sonar'
+import type { ProjectShape } from './project-profile'
 
 const WORKSPACE_YAML = 'pnpm-workspace.yaml'
 const CLAUDE_MD_FILENAME = 'CLAUDE.md'
+const STATIC_CLAUDE_IMPORT = '@node_modules/@joshuafolkken/kit/dist/CLAUDE.static.md'
+const PRETTIER_IGNORE = '.prettierignore'
+const GIT_ATTRIBUTES = '.gitattributes'
+const CODE_OF_CONDUCT = 'CODE_OF_CONDUCT.md'
+const SECURITY_MD = 'SECURITY.md'
+const STATIC_AI_FILES = [
+	'AGENTS.md',
+	'GEMINI.md',
+	PRETTIER_IGNORE,
+	GIT_ATTRIBUTES,
+	CODE_OF_CONDUCT,
+	SECURITY_MD,
+]
+const GITHUB_FILES = new Set([CODE_OF_CONDUCT, SECURITY_MD])
+const STATIC_POINTER_MAPPING = { src: 'templates/cursorrules.static', dest: '.cursorrules' }
+const PULL_REQUEST_TEMPLATE = '.github/pull_request_template.md'
+const RELEASE_CONFIG = '.github/release.yml'
+const STATIC_GITHUB_MAPPINGS = [
+	{ src: PULL_REQUEST_TEMPLATE, dest: PULL_REQUEST_TEMPLATE },
+	{ src: RELEASE_CONFIG, dest: RELEASE_CONFIG },
+]
 
 // Whether the existing file is a workflow that carries no header. A read failure answers "no": the
 // point is to warn, and a warning is not worth failing a command that used to open nothing.
@@ -59,7 +81,7 @@ function did_skip_copy_if_absent(
 	label: string,
 ): boolean {
 	if (existsSync(destination_path)) {
-		console.info(`  ⏭ skipped   ${label} (already exists — run josh sync to update)`)
+		console.info(`  ⏭ skipped   ${label} (already exists)`)
 		did_warn_unstamped_workflow(destination_path, label)
 
 		return true
@@ -89,8 +111,12 @@ function did_skip_workspace_yaml_copy(source_path: string, destination_path: str
 	return false
 }
 
-function did_skip_ai_file_copy(filename: string): boolean {
-	const source_path = package_path(filename)
+function did_skip_ai_file_copy(filename: string, shape?: ProjectShape): boolean {
+	const source_path = package_path(
+		filename === PRETTIER_IGNORE && shape?.profile === 'static'
+			? 'templates/prettierignore.static'
+			: filename,
+	)
 	const destination_path = path.join(PROJECT_ROOT, filename)
 
 	if (filename === WORKSPACE_YAML) {
@@ -183,16 +209,21 @@ function did_skip_ai_directory_copy(directory_name: string): boolean {
 // AI file — leaves an existing one untouched so a consumer's additions are never disturbed. `josh sync`
 // is what ensures the import line on an existing file (sync.ts). CLAUDE.md is no longer byte-copied
 // (joshuafolkken/kit#1878), so it is handled here rather than through AI_COPY_FILES.
-function did_skip_claude_md_import(): boolean {
+function did_skip_claude_md_import(shape?: ProjectShape): boolean {
 	const destination_path = path.join(PROJECT_ROOT, CLAUDE_MD_FILENAME)
 
 	if (existsSync(destination_path)) {
-		console.info(`  ⏭ skipped   ${CLAUDE_MD_FILENAME} (already exists — run josh sync to update)`)
+		console.info(`  ⏭ skipped   ${CLAUDE_MD_FILENAME} (already exists)`)
 
 		return true
 	}
 
-	writeFileSync(destination_path, init_logic.ensure_claude_md_import(undefined))
+	const content =
+		shape?.profile === 'static'
+			? `> If kit is not installed, run \`pnpm install\` first.\n\n${STATIC_CLAUDE_IMPORT}\n`
+			: init_logic.ensure_claude_md_import(undefined)
+
+	writeFileSync(destination_path, content)
 	console.info(`  ✔ created   ${CLAUDE_MD_FILENAME}`)
 
 	return false
@@ -201,14 +232,69 @@ function did_skip_claude_md_import(): boolean {
 // Returns the repository name resolved for the Sonar config, so `josh init` can reuse it for the
 // security-updates report instead of spawning a second `gh repo view` (joshuafolkken/kit#805).
 // Resolving it here rather than in the caller keeps every AI-file write ahead of the network call.
-function run_ai_copies(): string | undefined {
-	const did_skip_claude_md = did_skip_claude_md_import()
-	const file_skips = init_logic
-		.get_ai_copy_files()
-		.map((filename) => did_skip_ai_file_copy(filename))
-	const mapping_skips = init_logic
-		.get_ai_copy_file_mappings()
-		.map(({ src: source, dest: destination }) => did_skip_ai_file_mapping(source, destination))
+function should_copy_git_file(filename: string, shape?: ProjectShape): boolean {
+	if (shape?.has_git !== false) return true
+
+	return (
+		filename !== GIT_ATTRIBUTES &&
+		!filename.startsWith('.claude/') &&
+		!filename.startsWith('.codex/')
+	)
+}
+
+function should_copy_github_file(filename: string, shape?: ProjectShape): boolean {
+	if (shape?.has_github !== false) return true
+
+	return !GITHUB_FILES.has(filename) && !filename.startsWith('.github/')
+}
+
+function should_copy_static_file(filename: string, shape?: ProjectShape): boolean {
+	if (filename !== PRETTIER_IGNORE || shape?.profile !== 'static') return true
+
+	return shape.has_web
+}
+
+function should_copy_ai_file(filename: string, shape?: ProjectShape): boolean {
+	return (
+		should_copy_git_file(filename, shape) &&
+		should_copy_github_file(filename, shape) &&
+		should_copy_static_file(filename, shape)
+	)
+}
+
+function ai_files(shape?: ProjectShape): ReadonlyArray<string> {
+	const files = shape?.profile === 'static' ? STATIC_AI_FILES : init_logic.get_ai_copy_files()
+
+	return files.filter((filename) => should_copy_ai_file(filename, shape))
+}
+
+function ai_mapping_skips(shape?: ProjectShape): ReadonlyArray<boolean> {
+	const mappings =
+		shape?.profile === 'static'
+			? [STATIC_POINTER_MAPPING, ...(shape.has_github ? STATIC_GITHUB_MAPPINGS : [])]
+			: init_logic.get_ai_copy_file_mappings()
+
+	return mappings
+		.filter(({ dest }) => shape?.has_github !== false || !dest.startsWith('.github/'))
+		.map(({ src, dest }) => did_skip_ai_file_mapping(src, dest))
+}
+
+function repository_name(shape?: ProjectShape): string | undefined {
+	if (shape?.has_github === false || shape?.profile === 'static') return undefined
+
+	return gh_spawn.get_repo_name_with_owner()
+}
+
+function report_sync_hint(has_skips: boolean, shape?: ProjectShape): void {
+	if (!has_skips || shape?.profile === 'static') return
+
+	console.info('\n  💡 Run `josh sync` to overwrite skipped AI files with the latest version.')
+}
+
+function run_ai_copies(shape?: ProjectShape): string | undefined {
+	const did_skip_claude_md = did_skip_claude_md_import(shape)
+	const file_skips = ai_files(shape).map((filename) => did_skip_ai_file_copy(filename, shape))
+	const mapping_skips = ai_mapping_skips(shape)
 	const directory_skips = init_logic
 		.get_ai_copy_directories()
 		.map((directory_name) => did_skip_ai_directory_copy(directory_name))
@@ -216,13 +302,11 @@ function run_ai_copies(): string | undefined {
 		Boolean,
 	)
 
-	const name_with_owner = gh_spawn.get_repo_name_with_owner()
+	const name_with_owner = repository_name(shape)
 
-	init_sonar.copy_sonar_with_template(name_with_owner)
+	if (shape?.profile !== 'static') init_sonar.copy_sonar_with_template(name_with_owner)
 
-	if (has_skips) {
-		console.info('\n  💡 Run `josh sync` to overwrite skipped AI files with the latest version.')
-	}
+	report_sync_hint(has_skips, shape)
 
 	return name_with_owner
 }
@@ -230,6 +314,7 @@ function run_ai_copies(): string | undefined {
 const init_ai_copy = {
 	copy_ai_file,
 	run_ai_copies,
+	ai_files,
 }
 
 export { init_ai_copy }