@joshuafolkken/kit 1.1003.0 → 1.1010.0

package/README.md

@@ -1,6 +1,6 @@
 # @joshuafolkken/kit
 
-A development toolkit for AI-assisted work. `josh start` (or `josh init`, for a project that will not use the GitHub Issue workflow) gives an AI assistant (Claude Code, Codex, Gemini, Cursor) the project's rules, formatting and checks in one command. With `kickoff`, `fullrun` and `backlogrun`, the agent then takes a GitHub Issue through plan → implement → verify → PR → merge, the same way in every project. Why kit exists: [why.md](./docs/why.md) (Japanese).
+A development toolkit for AI-assisted work. One command gives an AI assistant (Claude Code, Codex, Gemini, Cursor) the project's rules, formatting and checks. With `kickoff`, `fullrun` and `backlogrun`, the agent then takes a GitHub Issue through plan → implement → verify → PR → merge, the same way in every project. Why kit exists: [why.md](./docs/why.md) (Japanese).
 
 ## What your project gets
 
@@ -16,29 +16,27 @@ In a `basic` project, `josh` skips each check that has nothing to run and says w
 
 ## Quick start
 
-Requires [Node.js](https://nodejs.org/) 22.19.0+ and [pnpm](https://pnpm.io/) 12+ for every profile ([how to install them](./docs/setup/basic.md#1-check-the-prerequisites)); the [gh CLI](https://cli.github.com/) for `josh version` and the Issue workflow is required by `josh start` and optional otherwise. Run in your project directory.
+Requires [Node.js](https://nodejs.org/) 22.19.0+ and [pnpm](https://pnpm.io/) 12+ ([how to install them](./docs/setup/basic.md#1-check-the-prerequisites)). `josh start` also requires the [gh CLI](https://cli.github.com/). Run in your project directory.
 
-One question picks the command: will the project use the GitHub Issue workflow (`kickoff`, `fullrun`, `backlogrun`)? The [profile](./docs/init.md#project-profiles) is chosen the same way either way.
+Pick by one question: will the project use the GitHub Issue workflow (`kickoff`, `fullrun`, `backlogrun`)?
 
-### The project will use the GitHub Issue workflow
+### With the GitHub Issue workflow
 
 ```bash
 pnpm add -D --allow-build=esbuild --allow-build=unrs-resolver @joshuafolkken/kit
 pnpm exec josh start
 ```
 
-With or without Git and a GitHub repository: `josh start` creates what is missing, and when `main` already has commits it opens a pull request with only kit's files for you to merge.
+`josh start` creates the Git and GitHub repositories if missing. If `main` already has commits, it opens a pull request with only kit's files for you to merge.
 
-### The project will not use the GitHub Issue workflow
+### Without the GitHub Issue workflow
 
 ```bash
 pnpm --allow-build=esbuild dlx @joshuafolkken/kit init
 pnpm josh gate
 ```
 
-What each command does in each starting state: [init.md → `josh init` or `josh start`](./docs/init.md#josh-init-or-josh-start).
-
-The step-by-step version of these commands, with what each one creates: [Set up the basic profile](./docs/setup/basic.md) · [Set up the full profile](./docs/setup/full.md).
+Details: [what each command does in each starting state](./docs/init.md#josh-init-or-josh-start) · step by step: [basic profile](./docs/setup/basic.md) · [full profile](./docs/setup/full.md).
 
 ## Documentation
 

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.1003.0",
+  "version": "1.1010.0",
   "name": "@joshuafolkken/kit",
   "description": "Development toolkit for AI-assisted projects: formatting, AI assistant rules and a Git/GitHub Issue workflow for any repository, plus lint, type check, tests and hooks for Node projects",
   "keywords": [
@@ -208,7 +208,7 @@
     "eslint-plugin-unicorn": "^76.0.0",
     "eslint_d": "^15.0.3",
     "globals": "^17.12.0",
-    "lefthook": "^2.1.14",
+    "lefthook": "^2.1.15",
     "prettier": "^3.9.9",
     "prettier-plugin-svelte": "^4.1.1",
     "prettier-plugin-tailwindcss": "^0.8.1",

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

@@ -101,20 +101,32 @@ function did_skip_copy_if_absent(
 	return false
 }
 
-function did_skip_workspace_yaml_copy(source_path: string, destination_path: string): boolean {
-	if (!existsSync(destination_path)) {
-		copy_ai_file(source_path, destination_path)
-		console.info(`  ✔ created   ${WORKSPACE_YAML}`)
-
-		return false
-	}
-
+// The merged file is written back, and reported as `updated`, only when the merge changed it — a
+// second `josh init` over an already-merged file reports `unchanged` (joshuafolkken/kit#2873).
+function merge_existing_workspace_yaml(source_path: string, destination_path: string): void {
 	const template = readFileSync(source_path, 'utf8')
 	const existing = readFileSync(destination_path, 'utf8')
 	const merged = init_logic.merge_workspace_yaml(existing, template)
 
-	if (merged !== existing) writeFileSync(destination_path, merged)
+	if (merged === existing) {
+		console.info(`  ✔ unchanged ${WORKSPACE_YAML}`)
+
+		return
+	}
+
+	writeFileSync(destination_path, merged)
 	console.info(`  ✔ updated   ${WORKSPACE_YAML}`)
+}
+
+function did_skip_workspace_yaml_copy(source_path: string, destination_path: string): boolean {
+	if (existsSync(destination_path)) {
+		merge_existing_workspace_yaml(source_path, destination_path)
+
+		return false
+	}
+
+	copy_ai_file(source_path, destination_path)
+	console.info(`  ✔ created   ${WORKSPACE_YAML}`)
 
 	return false
 }

package/scripts/init/init-bootstrap.ts

@@ -1,6 +1,7 @@
-import { existsSync, readFileSync, realpathSync } from 'node:fs'
+import { existsSync, readFileSync, realpathSync, writeFileSync } from 'node:fs'
 import path from 'node:path'
 import { z } from 'zod'
+import { init_basic } from './init-basic'
 import { init_install, type InstallStep } from './init-install'
 import { init_logic_workspace } from './init-logic-workspace'
 import { project_profile } from './project-profile'
@@ -73,6 +74,14 @@ function handoff_step(args: ReadonlyArray<string>): InstallStep {
 	}
 }
 
+// pnpm walks up to the nearest `package.json`, so without one here it installs kit into whatever
+// project an ancestor directory holds and rewrites that project's files (joshuafolkken/kit#2866).
+function ensure_project_manifest(project_root: string): void {
+	const manifest_path = path.join(project_root, PACKAGE_JSON)
+
+	if (!existsSync(manifest_path)) writeFileSync(manifest_path, init_basic.initial_manifest())
+}
+
 // Returns the failure to report, or undefined once the project-installed kit finished the setup.
 function hand_off(
 	package_directory: string,
@@ -83,6 +92,8 @@ function hand_off(
 	console.info('\n🚀 Installing @joshuafolkken/kit into the project, then running its josh init')
 	const template = readFileSync(path.join(package_directory, KIT_BUILDS_TEMPLATE), 'utf8')
 	const install = kit_install_step(has_kit_dependency(project_root), template)
+
+	ensure_project_manifest(project_root)
 	if (!init_install.did_step_succeed(install, project_root)) return `${install.label} failed`
 	if (!init_install.did_step_succeed(handoff_step(args), project_root)) return HANDOFF_FAILURE