@joshuafolkken/kit 1.947.0 → 1.957.0

package/README.md

@@ -1,6 +1,6 @@
 # @joshuafolkken/kit
 
-A development toolkit that sets up a repository for AI-assisted work with one command. `josh init` gives an AI assistant (Claude Code, Codex, Gemini, Cursor) the project's rules, and the `josh` CLI runs the checks and the Git / GitHub Issue workflow the same way in every project. You stop copying config between repositories and re-explaining conventions to the assistant.
+A development toolkit that sets up a repository for AI-assisted work with one command. `josh init` gives an AI assistant (Claude Code, Codex, Gemini, Cursor) the project's rules, and the `josh` CLI runs the checks and the Git / GitHub Issue workflow the same way in every project. You stop copying config between repositories and re-explaining conventions to the assistant. For the problems kit exists to solve, see [why.md](./docs/why.md) (Japanese).
 
 ## What your project gets
 
@@ -26,6 +26,8 @@ pnpm josh format
 pnpm josh gate
 ```
 
+`josh init` is the entry without GitHub. To start a new project on the GitHub Issue workflow (`kickoff`), run `pnpm exec josh start` instead of `josh init` — it also creates the Git repository, the GitHub repository and the labels ([init.md → `josh init` or `josh start`](./docs/init.md#josh-init-or-josh-start)).
+
 It needs [Node.js](https://nodejs.org/) 22.19.0 or later with [pnpm](https://pnpm.io/), even for a `static` project; [getting-started.md](./docs/getting-started.md) installs both. The global `josh` command ([cli.md](./docs/cli.md)) and the [gh CLI](https://cli.github.com/) for `josh version` and the GitHub Issue workflow are optional.
 
 ## Documentation
@@ -34,11 +36,8 @@ It needs [Node.js](https://nodejs.org/) 22.19.0 or later with [pnpm](https://pnp
 
 - [getting-started.md](./docs/getting-started.md) — first install for an `index.html` site or a non-Node project (`static`)
 - [package.md](./docs/package.md) — add kit to a Node project (`node`)
+- [tutorial.md](./docs/tutorial.md) — your first change with an agent, from Issue to merge
 - [how-to.md](./docs/how-to.md) — step-by-step guides by task: update, release, run Issues, fix a failing gate
-
-**Understand kit**
-
-- [why.md](./docs/why.md) — the problems kit exists to solve
 - [overview.md](./docs/overview.md) — what kit sets up and how it works
 
 **Commands and configuration**

package/dist/hooks/batch-guard.js

@@ -9,10 +9,10 @@ import {
   load_environment_file,
   notice_refusal_path,
   refusal_path
-} from "./chunk-V7RH56HU.js";
-import "./chunk-OM5VDM6F.js";
-import "./chunk-O3PEDF3M.js";
-import "./chunk-EYFJ74MJ.js";
+} from "./chunk-244WYOEO.js";
+import "./chunk-XSL4SRMA.js";
+import "./chunk-LDQDZYHX.js";
+import "./chunk-BELI5XSS.js";
 import "./chunk-WPALEIRX.js";
 import "./chunk-RKUAD3I6.js";
 export {

package/dist/hooks/{chunk-V7RH56HU.js → chunk-244WYOEO.js}

@@ -1,10 +1,10 @@
 import {
   lane_guard_policy,
   time_batch_guard
-} from "./chunk-OM5VDM6F.js";
+} from "./chunk-XSL4SRMA.js";
 import {
   hook_decision
-} from "./chunk-O3PEDF3M.js";
+} from "./chunk-LDQDZYHX.js";
 
 // scripts/hooks/batch-guard.ts
 import { text } from "node:stream/consumers";

package/dist/hooks/{chunk-IA7WC4NS.js → chunk-3ON7HOYB.js}

@@ -5,7 +5,7 @@ import {
 import {
   ESLINT_EDIT_CACHE_FLAGS,
   time_density_hook
-} from "./chunk-EYFJ74MJ.js";
+} from "./chunk-BELI5XSS.js";
 
 // scripts/hooks/format-edited-file.ts
 import { existsSync as existsSync2 } from "node:fs";

package/dist/hooks/{chunk-EYFJ74MJ.js → chunk-BELI5XSS.js}

@@ -1016,9 +1016,13 @@ var PROJECT_COMMANDS = {
   },
   start: {
     script: "scripts/init/start.ts",
-    description: "Initialize a project for the GitHub Issue workflow",
+    description: "Create a new project for the GitHub Issue workflow, from git init to labels",
     category: "Project",
-    reference: [PROFILE_ARGUMENTS, "developer", ["files", "git", "network"]]
+    reference: [
+      `${PROFILE_ARGUMENTS} [--yes] [--github] [--public]`,
+      "developer",
+      ["files", "git", "network", "processes"]
+    ]
   },
   init: {
     script: "scripts/init/init.ts",

package/dist/hooks/{chunk-IBFC25IX.js → chunk-GNOITLRR.js}

@@ -1,16 +1,16 @@
 import {
   investigation_reads
-} from "./chunk-M4U4YNRE.js";
+} from "./chunk-HJXQZ7V4.js";
 import {
   lane_guard_policy
-} from "./chunk-OM5VDM6F.js";
+} from "./chunk-XSL4SRMA.js";
 import {
   hook_decision
-} from "./chunk-O3PEDF3M.js";
+} from "./chunk-LDQDZYHX.js";
 import {
   json_value,
   time_spans
-} from "./chunk-EYFJ74MJ.js";
+} from "./chunk-BELI5XSS.js";
 
 // scripts/delegation/duplicate-read-guard.ts
 import { statSync } from "node:fs";

package/dist/hooks/{chunk-M4U4YNRE.js → chunk-HJXQZ7V4.js}

@@ -1,16 +1,16 @@
 import {
   time_batch_guard
-} from "./chunk-OM5VDM6F.js";
+} from "./chunk-XSL4SRMA.js";
 import {
   hook_decision
-} from "./chunk-O3PEDF3M.js";
+} from "./chunk-LDQDZYHX.js";
 import {
   cost_blocks,
   cost_transcript,
   time_bundle_call,
   time_shell,
   time_spans
-} from "./chunk-EYFJ74MJ.js";
+} from "./chunk-BELI5XSS.js";
 
 // scripts/delegation/investigation-reads.ts
 import path from "node:path";