@joshuafolkken/kit 1.1453.0 → 1.1455.0

package/.claude/skills/workflow-commands/backlogrun-handoff-report.md

@@ -24,6 +24,6 @@ structure and the label translations are `prompts/collaboration-workflow/report-
 - One sentence per line, no internal identifiers, every child named by number. **Never omit
   `Remaining`** — it is the one line that tells this report from a completion report
 - Telegram uses the same format and is **sent with `--task-type confirmation`** (`completion` would
-  announce an unfinished epic as done)
+  announce an unfinished epic as done), `--recommended` naming the resume command
 - **Write it only when the run stops.** While a run carries on past the threshold it writes none; the
   epic progress comment is the record

package/.claude/skills/workflow-commands/halfrun.md

@@ -35,7 +35,8 @@ the gate. The direct commands follow for shipping without an agent:
 `pnpm josh notify --task-type confirmation --issue-url "<issue-url>" --body=$'halfrun ready for manual
 verification\nNext: prrun #<N> | fullrun #<N>\nWithout an agent: pnpm josh git -y "<title> #<N>" && pnpm josh
 followup "<title> #<N>" --notify-message "Implemented <title>\\nCause: ...\\nFix: ...\\nResult:
-...\\n\\nDetails:\\n- <change1>"'`. The stop report names the same two, in the same order.
+...\\n\\nDetails:\\n- <change1>"' --recommended "Verify by hand, then prrun #<N>" --alternative "fullrun
+#<N>"`. The stop report names the same two, in the same order.
 **Invoking `halfrun` is _not_ authorization to commit, push, or merge** — do not run `pnpm josh git -y` or `pnpm josh followup` yourself. If the user comes
 back with fixes, treat each as a new round: implement, re-run `pnpm josh gate`, send another
 `confirmation` Telegram, stop again.

package/.claude/skills/workflow-commands/prrun.md

@@ -27,7 +27,8 @@ Where `fullrun` runs `pnpm josh followup` and merges, `prrun` does three things
    follows for finishing without an agent:
    `pnpm josh notify --task-type confirmation --issue-url "<issue-url>" --body=$'prrun ready to
    merge: <pr-url>\nNext: fullrun #<N>\nAfter a manual merge, without an agent: pnpm josh followup
-   "<title> #<N>"'`. The stop report names the same two, in the same order.
+   "<title> #<N>"' --recommended "fullrun #<N>" --alternative "Merge by hand, then pnpm josh
+   followup"`. The stop report names the same two, in the same order.
 
 **Invoking `prrun` is _not_ authorization to merge** — never run `pnpm josh followup` without
 `--no-merge` in a `prrun`. After a person merges by hand, the same `pnpm josh followup "<title> #<N>"`

package/CLAUDE.md

@@ -82,5 +82,5 @@ Never start a `kickoff` / `halfrun` / `prrun` / `fullrun` / `backlogrun` workflo
 Before pausing **any** run for the user — a command's stop, an upstream-Issue interrupt, a Tier C confirmation — send once per stop (skip when the user asked for the stop this turn):
 
 ```bash
-pnpm josh notify --task-type confirmation --issue-url "<issue-url>" --body=$'<one-line reason>\n<what is needed from the user>'
+pnpm josh notify --task-type confirmation --issue-url "<url>" --body=$'<reason>' --recommended "<choice>" --alternative "<other>"
 ```

package/README.md

@@ -39,7 +39,7 @@ Next: [tutorial](./docs/tutorial.md)
 
 #### Your first backlogrun
 
-Tell the agent the change you want, then type `kickoff new` to it. The Issue gets the `auto-ok` label when it needs no judgement from you (or add the label to an existing Issue).
+File Issues with `kickoff new`, then run:
 
 ```bash
 pnpm josh backlogrun
@@ -59,14 +59,7 @@ Next: [tutorial](./docs/tutorial.md#without-github-one-change-checked-locally)
 
 ### Adding kit to an existing project
 
-- **Files written:** settings per profile, including Prettier — always on `full`, and on `basic` only when the project has web files and no formatter of its own ([per profile](./docs/init.md#project-profiles)); `--dry-run` previews them.
-- **Overwritten by `josh sync`:** the managed files, such as `.github/workflows/ci.yml` and `AGENTS.md` ([the list](./docs/sync.md#ai-files-overwritten)).
-- **Permissions:** the Claude Code settings kit writes (with `josh start`, or on `full`) set `bypassPermissions` with `Bash(*)`, guarded by a deny list and a hook ([how to opt out](./docs/init.md#claude-code-permission-mode)).
-- **On GitHub:** `josh start` adds labels, and on an existing `main` an Issue and a setup PR that you merge yourself ([the steps](./docs/init.md#josh-init-or-josh-start)).
-
-## Claude Code in a fresh-machine run
-
-A `josh fresh:run` scenario that runs Claude Code needs a sign-in saved once with `pnpm josh auth:setup` ([steps](./docs/maintainers/fresh-machine.md#claude-code)).
+Check first: [what kit changes in your project](./docs/how-to/add-kit.md#what-kit-changes-in-your-project)
 
 ## Docs
 

package/dist/CLAUDE.md

@@ -82,5 +82,5 @@ Never start a `kickoff` / `halfrun` / `prrun` / `fullrun` / `backlogrun` workflo
 Before pausing **any** run for the user — a command's stop, an upstream-Issue interrupt, a Tier C confirmation — send once per stop (skip when the user asked for the stop this turn):
 
 ```bash
-pnpm josh notify --task-type confirmation --issue-url "<issue-url>" --body=$'<one-line reason>\n<what is needed from the user>'
+pnpm josh notify --task-type confirmation --issue-url "<url>" --body=$'<reason>' --recommended "<choice>" --alternative "<other>"
 ```

package/dist/hooks/batch-guard.js

@@ -9,10 +9,10 @@ import {
   load_environment_file,
   notice_refusal_path,
   refusal_path
-} from "./chunk-EF5GQ6WS.js";
+} from "./chunk-5H4SSDSD.js";
 import "./chunk-UT7YC3N2.js";
-import "./chunk-W5ZKGTSY.js";
-import "./chunk-MBJYQPEK.js";
+import "./chunk-GPLGZ6IC.js";
+import "./chunk-LIAFCXL7.js";
 import "./chunk-OLMO72ON.js";
 import "./chunk-3C4XRYG6.js";
 import "./chunk-DGT54IH5.js";

package/dist/hooks/{chunk-EF5GQ6WS.js → chunk-5H4SSDSD.js}

@@ -3,10 +3,10 @@ import {
 } from "./chunk-UT7YC3N2.js";
 import {
   hook_decision
-} from "./chunk-W5ZKGTSY.js";
+} from "./chunk-GPLGZ6IC.js";
 import {
   time_batch_guard
-} from "./chunk-MBJYQPEK.js";
+} from "./chunk-LIAFCXL7.js";
 
 // scripts/hooks/batch-guard.ts
 import { text } from "node:stream/consumers";

package/dist/hooks/{chunk-Y3GKIKGW.js → chunk-7WQBPLUN.js}

@@ -30,7 +30,7 @@ import {
   time_density_hook,
   time_shell,
   time_transcript_line
-} from "./chunk-MBJYQPEK.js";
+} from "./chunk-LIAFCXL7.js";
 import {
   lane_child_marker
 } from "./chunk-OLMO72ON.js";

package/dist/hooks/{chunk-LBFYEOXJ.js → chunk-D5QBTOCZ.js}

@@ -1,12 +1,12 @@
 import {
   investigation_reads
-} from "./chunk-NO4AALP5.js";
+} from "./chunk-WNLVGT7E.js";
 import {
   lane_guard_policy
 } from "./chunk-UT7YC3N2.js";
 import {
   hook_decision
-} from "./chunk-W5ZKGTSY.js";
+} from "./chunk-GPLGZ6IC.js";
 
 // scripts/delegation/investigation-guard.ts
 import { text } from "node:stream/consumers";

package/dist/hooks/{chunk-W5ZKGTSY.js → chunk-GPLGZ6IC.js}

@@ -1,7 +1,7 @@
 import {
   time_density_hook,
   time_hook_transcript
-} from "./chunk-MBJYQPEK.js";
+} from "./chunk-LIAFCXL7.js";
 import {
   josh_environment_file
 } from "./chunk-OLMO72ON.js";

package/dist/hooks/{chunk-SHYUQOIS.js → chunk-HFGWYGUV.js}

@@ -1,15 +1,15 @@
 import {
   investigation_reads
-} from "./chunk-NO4AALP5.js";
+} from "./chunk-WNLVGT7E.js";
 import {
   lane_guard_policy
 } from "./chunk-UT7YC3N2.js";
 import {
   hook_decision
-} from "./chunk-W5ZKGTSY.js";
+} from "./chunk-GPLGZ6IC.js";
 import {
   time_spans
-} from "./chunk-MBJYQPEK.js";
+} from "./chunk-LIAFCXL7.js";
 import {
   json_value
 } from "./chunk-3C4XRYG6.js";

package/dist/hooks/{chunk-5C7L6FRC.js → chunk-HHI6FO3R.js}

@@ -1,6 +1,6 @@
 import {
   duplicate_read_outcome
-} from "./chunk-SHYUQOIS.js";
+} from "./chunk-HFGWYGUV.js";
 import {
   ALREADY_DONE_LABEL,
   CONTEXT_CUT_THRESHOLD,
@@ -29,7 +29,7 @@ import {
   session_cite,
   shell_segments,
   tail_commands
-} from "./chunk-Y3GKIKGW.js";
+} from "./chunk-7WQBPLUN.js";
 import {
   ancestor_directories,
   find_local_bin_upwards,
@@ -56,19 +56,19 @@ import {
 } from "./chunk-CDY4NFQG.js";
 import {
   batch_outcome
-} from "./chunk-EF5GQ6WS.js";
+} from "./chunk-5H4SSDSD.js";
 import {
   investigation_refusal
-} from "./chunk-LBFYEOXJ.js";
+} from "./chunk-D5QBTOCZ.js";
 import {
   investigation_reads
-} from "./chunk-NO4AALP5.js";
+} from "./chunk-WNLVGT7E.js";
 import {
   lane_guard_policy
 } from "./chunk-UT7YC3N2.js";
 import {
   hook_decision
-} from "./chunk-W5ZKGTSY.js";
+} from "./chunk-GPLGZ6IC.js";
 import {
   cost_attribute,
   cost_blocks,
@@ -76,7 +76,7 @@ import {
   time_batch_guard,
   time_density_hook,
   time_shell
-} from "./chunk-MBJYQPEK.js";
+} from "./chunk-LIAFCXL7.js";
 import {
   lane_child_marker
 } from "./chunk-OLMO72ON.js";
@@ -3190,7 +3190,7 @@ var rule_body_guard = {
 
 // scripts/rules/shell-body-trigger.ts
 var FIELD_FLAGS = "(?:-f|-F|--field|--raw-field)";
-var MESSAGE_FLAGS = "(?:--body|--notify-message)";
+var MESSAGE_FLAGS = "(?:--body|--notify-message|--recommended|--alternative)";
 var FIELD_OPENING = String.raw`${FIELD_FLAGS}[\s=]*(?:'?body="|"body=)`;
 var MESSAGE_OPENING = String.raw`${MESSAGE_FLAGS}[\s=]+"`;
 var NESTED_SUBSTITUTION = String.raw`\$\([^()]*\)`;

package/dist/hooks/{chunk-MBJYQPEK.js → chunk-LIAFCXL7.js}

@@ -2136,7 +2136,7 @@ var WORKFLOW_COMMANDS = {
     description: "Send Telegram notification",
     category: "Workflow",
     reference: [
-      "[--task-type <type>] [--body <text> | --body-file <path>] [--issue-url <url>] [--pr-url <url>] [--issue-title <text>] [--repo-name <name>]",
+      "[--task-type <type>] [--body <text> | --body-file <path>] [--issue-url <url>] [--pr-url <url>] [--issue-title <text>] [--repo-name <name>] [--recommended <text>] [--alternative <text>]...",
       "automation",
       ["notifications"]
     ],

package/dist/hooks/{chunk-D3NJXN5M.js → chunk-TBJFTSUY.js}

@@ -5,7 +5,7 @@ import {
 import {
   ESLINT_EDIT_CACHE_FLAGS,
   time_density_hook
-} from "./chunk-MBJYQPEK.js";
+} from "./chunk-LIAFCXL7.js";
 import {
   file_reader,
   json_value

package/dist/hooks/{chunk-NO4AALP5.js → chunk-WNLVGT7E.js}

@@ -1,13 +1,13 @@
 import {
   hook_decision
-} from "./chunk-W5ZKGTSY.js";
+} from "./chunk-GPLGZ6IC.js";
 import {
   cost_blocks,
   time_batch_guard,
   time_bundle_call,
   time_shell,
   time_spans
-} from "./chunk-MBJYQPEK.js";
+} from "./chunk-LIAFCXL7.js";
 import {
   cost_transcript
 } from "./chunk-3C4XRYG6.js";

package/dist/hooks/codex-hook-adapter.js

@@ -1,29 +1,29 @@
 #!/usr/bin/env tsx
 import {
   pretool_guard
-} from "./chunk-5C7L6FRC.js";
-import "./chunk-SHYUQOIS.js";
+} from "./chunk-HHI6FO3R.js";
+import "./chunk-HFGWYGUV.js";
 import {
   bounded_pool
-} from "./chunk-Y3GKIKGW.js";
+} from "./chunk-7WQBPLUN.js";
 import {
   build_envelope,
   compose_context,
   format_edited_payload
-} from "./chunk-D3NJXN5M.js";
+} from "./chunk-TBJFTSUY.js";
 import "./chunk-IX6TTTI6.js";
 import "./chunk-Z4XI7CZS.js";
 import "./chunk-CDY4NFQG.js";
-import "./chunk-EF5GQ6WS.js";
-import "./chunk-LBFYEOXJ.js";
-import "./chunk-NO4AALP5.js";
+import "./chunk-5H4SSDSD.js";
+import "./chunk-D5QBTOCZ.js";
+import "./chunk-WNLVGT7E.js";
 import "./chunk-UT7YC3N2.js";
 import {
   hook_decision
-} from "./chunk-W5ZKGTSY.js";
+} from "./chunk-GPLGZ6IC.js";
 import {
   time_density_hook
-} from "./chunk-MBJYQPEK.js";
+} from "./chunk-LIAFCXL7.js";
 import "./chunk-OLMO72ON.js";
 import {
   json_value

package/dist/hooks/duplicate-read-guard.js

@@ -9,11 +9,11 @@ import {
   is_enabled,
   notice_refusal_path,
   refusal_path
-} from "./chunk-SHYUQOIS.js";
-import "./chunk-NO4AALP5.js";
+} from "./chunk-HFGWYGUV.js";
+import "./chunk-WNLVGT7E.js";
 import "./chunk-UT7YC3N2.js";
-import "./chunk-W5ZKGTSY.js";
-import "./chunk-MBJYQPEK.js";
+import "./chunk-GPLGZ6IC.js";
+import "./chunk-LIAFCXL7.js";
 import "./chunk-OLMO72ON.js";
 import "./chunk-3C4XRYG6.js";
 import "./chunk-DGT54IH5.js";

package/dist/hooks/format-edited.js

@@ -2,9 +2,9 @@
 import {
   report_no_payload,
   run_hook
-} from "./chunk-D3NJXN5M.js";
+} from "./chunk-TBJFTSUY.js";
 import "./chunk-IX6TTTI6.js";
-import "./chunk-MBJYQPEK.js";
+import "./chunk-LIAFCXL7.js";
 import "./chunk-3C4XRYG6.js";
 import "./chunk-DGT54IH5.js";