@joshuafolkken/kit 1.1387.0 → 1.1453.0

package/dist/hooks/session-lang.js

@@ -1,7 +1,4 @@
 #!/usr/bin/env tsx
-import {
-  session_language
-} from "./chunk-6V5OPIUU.js";
 import {
   agent_role_profile,
   detached_launch,
@@ -9,23 +6,24 @@ import {
   issue_cite,
   run_event_stream,
   run_event_stream_emit,
-  run_headless
-} from "./chunk-U32VSRNG.js";
+  run_headless,
+  session_language
+} from "./chunk-Z4XI7CZS.js";
 import {
   error_text
 } from "./chunk-CDY4NFQG.js";
 import {
   josh_environment_file
-} from "./chunk-J3KSS7II.js";
+} from "./chunk-OLMO72ON.js";
 import {
   agent_session_environment,
   json_value,
   process_identity,
   run_carry
-} from "./chunk-2YSW3CXH.js";
+} from "./chunk-3C4XRYG6.js";
 import {
   stamp_file
-} from "./chunk-NEC4AT4Z.js";
+} from "./chunk-DGT54IH5.js";
 
 // scripts/josh/session-language-cli.ts
 import { fileURLToPath } from "node:url";
@@ -104,7 +102,14 @@ var agent_diagnostics = { check };
 import { existsSync } from "node:fs";
 import path from "node:path";
 var AGENT_COMMAND = "claude";
-var AGENT_FLAGS = ["-p", "--verbose", "--output-format", "stream-json"];
+var PERMISSION_FLAGS = ["--permission-mode", "bypassPermissions"];
+var AGENT_FLAGS = [
+  "-p",
+  "--verbose",
+  "--output-format",
+  "stream-json",
+  ...PERMISSION_FLAGS
+];
 var MODEL_FLAG = "--model";
 var EFFORT_FLAG = "--effort";
 var RESUME_FLAG = "--resume";
@@ -311,24 +316,57 @@ var STAGE = {
   // `run:carry --begin` claimed the run, and the parent is planning it.
   PLANNING: "planning",
   // The supervisor took the run over from the parent and is asking for the first offer.
-  HANDING_OFF: "handing off"
+  HANDING_OFF: "handing off",
+  // The driver answered something only a session can act on — an untriaged child, an epic left to a
+  // person — and the supervisor is waking one. The next hand-off replaces it.
+  JUDGING: "waiting on judgment",
+  // The supervisor started that session, which is now acting on the driver's answer. It is detached, so
+  // its end is the supervisor's next hand-off, which replaces this.
+  SESSION: "judgment session running",
+  // The driver's launch of a lane returned without a child: no lane was free to open, or a step after
+  // the open failed. It names no issue, so the lane's own stage ends here whatever the driver does next.
+  NO_CHILD: "no child launched"
 };
 var OPENING = "opening lane";
+var INSTALLING = "installing dependencies";
+var DISPATCHING = "dispatching";
+var LANE_STAGE = { OPENING, INSTALLING, DISPATCHING };
 function opening_lane(issue) {
   return `${OPENING} ${issue_cite.plain(issue)}`;
 }
+function installing(issue) {
+  return `${INSTALLING} ${issue_cite.plain(issue)}`;
+}
+function dispatching(issue) {
+  return `${DISPATCHING} ${issue_cite.plain(issue)}`;
+}
 async function emit(text) {
   await run_event_stream_emit.emit(run_event_stream.EVENT_KIND.SETUP, text);
 }
-function emit_in(repository, text, at) {
+function append_stage(resolve_target, text, at) {
   try {
-    const target = run_event_stream.target_of(repository);
-    run_event_stream.append(target, run_event_stream.EVENT_KIND.SETUP, text, at.toISOString());
+    const { SETUP } = run_event_stream.EVENT_KIND;
+    run_event_stream.append(resolve_target(), SETUP, text, at.toISOString());
   } catch (error) {
-    error_text.trace_swallowed("run_event_setup.emit_in", error);
+    error_text.trace_swallowed("run_event_setup.append_stage", error);
   }
 }
-var run_event_setup = { STAGE, emit, emit_in, opening_lane };
+function emit_in(repository, text, at) {
+  append_stage(() => run_event_stream.target_of(repository), text, at);
+}
+function emit_to(target, text, at) {
+  append_stage(() => target, text, at);
+}
+var run_event_setup = {
+  LANE_STAGE,
+  STAGE,
+  dispatching,
+  emit,
+  emit_in,
+  emit_to,
+  installing,
+  opening_lane
+};
 
 // scripts/backlog/backlogrun-launch.ts
 import { z } from "zod";
@@ -406,6 +444,20 @@ function started_for(git_directory, owner_pid) {
   const started_ms = Date.parse(record.started_at);
   return Number.isNaN(started_ms) ? void 0 : new Date(started_ms);
 }
+function signal_parent(pid) {
+  try {
+    process.kill(pid, "SIGTERM");
+  } catch {
+    note_to_stderr(`process ${String(pid)} could not be signalled; its launch record is removed.`);
+  }
+}
+function stop_parent(git_directory) {
+  const record = live_launch(git_directory);
+  stamp_file.remove_stamp(launch_path(git_directory));
+  if (record === void 0) return void 0;
+  signal_parent(record.pid);
+  return record.pid;
+}
 function spawn_parent(argv, provider, target) {
   const environment = {
     ...run_headless.environment(),
@@ -440,7 +492,8 @@ var backlogrun_launch = {
   is_running,
   pending_launch,
   start,
-  started_for
+  started_for,
+  stop_parent
 };
 
 // scripts/josh/session-language-cli.ts

package/dist/hooks/stop-guard.js

@@ -3,9 +3,8 @@ import {
   RUN_LANE_LABEL,
   RUN_SOLO_LABEL,
   filing_cap,
-  git_gh_api_path,
+  gh_spawn,
   git_gh_command,
-  git_gh_exec,
   has_label_name,
   issue_citation,
   lane_background,
@@ -14,10 +13,7 @@ import {
   repo_party,
   run_cut,
   run_hold
-} from "./chunk-GNDJ7NJ7.js";
-import {
-  session_language
-} from "./chunk-6V5OPIUU.js";
+} from "./chunk-Y3GKIKGW.js";
 import {
   agent_headless,
   agent_role_profile,
@@ -25,23 +21,24 @@ import {
   lane_registry,
   run_event_stream,
   run_event_stream_emit,
-  run_headless
-} from "./chunk-U32VSRNG.js";
+  run_headless,
+  session_language
+} from "./chunk-Z4XI7CZS.js";
 import {
   timed_fetch
-} from "./chunk-FZ6FUSBM.js";
+} from "./chunk-723HKZO5.js";
 import "./chunk-CDY4NFQG.js";
 import {
   hook_decision
-} from "./chunk-EBSHN25W.js";
+} from "./chunk-W5ZKGTSY.js";
 import {
   time_density_hook,
   time_hook_transcript,
   time_reported_failure
-} from "./chunk-SL4GQ2XP.js";
+} from "./chunk-MBJYQPEK.js";
 import {
   lane_child_marker
-} from "./chunk-J3KSS7II.js";
+} from "./chunk-OLMO72ON.js";
 import {
   backlog_budget,
   issue_number_shape,
@@ -50,11 +47,10 @@ import {
   process_owner_schema,
   run_carry,
   run_invocation
-} from "./chunk-2YSW3CXH.js";
+} from "./chunk-3C4XRYG6.js";
 import {
-  PROJECT_ROOT,
   stamp_file
-} from "./chunk-NEC4AT4Z.js";
+} from "./chunk-DGT54IH5.js";
 
 // scripts/hooks/stop-guard.ts
 import { text } from "node:stream/consumers";
@@ -136,7 +132,7 @@ var lane_seed_policy = {
 };
 
 // scripts/lane/lane-capacity.ts
-var DEFAULT_LANE_LIMIT = 6;
+var DEFAULT_LANE_LIMIT = 4;
 var LANE_LIMIT_KEY = "JOSH_LANE_LIMIT";
 var POSITIVE_INTEGER = /^[1-9]\d*$/u;
 var NO_LANES = 0;
@@ -245,8 +241,7 @@ var backlog_stalled = {
 var NO_FREE = 0;
 var NONE2 = 0;
 async function live_lane_count() {
-  const lanes = await lane_registry.list_lanes();
-  return lanes.filter((lane) => !lane.is_stranded).length;
+  return lane_registry.live_count(await lane_registry.list_lanes());
 }
 async function free_under(limit) {
   return lane_capacity.free_lanes(limit, await live_lane_count());
@@ -320,26 +315,6 @@ var backlog_ready = {
   ready_line
 };
 
-// scripts/gh/gh-spawn.ts
-var NO_BUDGET = 0;
-function fetch_repo_name(timeout_ms) {
-  const stdout = git_gh_exec.read_gh_api_sync({
-    path: git_gh_api_path.repo_api_path(),
-    jq_filter: ".full_name",
-    cwd: PROJECT_ROOT,
-    timeout_ms: timeout_ms ?? NO_BUDGET
-  });
-  const name = stdout?.trim();
-  return name === "" ? void 0 : name;
-}
-function get_repo_name_with_owner() {
-  return fetch_repo_name(void 0);
-}
-function get_repo_name_with_owner_within(timeout_ms) {
-  return fetch_repo_name(timeout_ms);
-}
-var gh_spawn = { get_repo_name_with_owner, get_repo_name_with_owner_within };
-
 // scripts/notify/telegram-notify.ts
 import { z } from "zod";
 var TELEGRAM_API_BASE = "https://api.telegram.org";

package/dist/josh.js

@@ -395,6 +395,7 @@ var START_TIME_FORMAT = "lstart=";
 var PID_FLAG = "-p";
 var PROBE_ENVIRONMENT = { TZ: "UTC", LC_ALL: "C" };
 var LIVENESS_SIGNAL = 0;
+var NO_SUCH_PROCESS = "ESRCH";
 var LOWEST_REAL_PID = 1;
 var PROC_START_FIELD_INDEX = 19;
 var BEACON_SCHEME = "socket:";
@@ -409,15 +410,20 @@ var BEACON_GONE_STATUS = 2;
 var SOCKET_PROBE_SOURCE = `const net=require('node:net');const socket=net.createConnection(process.argv[1]);socket.once('connect',()=>process.exit(${String(BEACON_LIVE_STATUS)}));socket.once('error',(error)=>process.exit(['ECONNREFUSED','ENOENT'].includes(error.code)?${String(BEACON_GONE_STATUS)}:${String(BEACON_UNKNOWN_STATUS)}));socket.setTimeout(1000,()=>process.exit(${String(BEACON_UNKNOWN_STATUS)}));`;
 var beacons = /* @__PURE__ */ new Map();
 var exit_cleanup = { is_registered: false };
-function is_live_pid(pid) {
-  if (pid < LOWEST_REAL_PID) return false;
+function signal_refusal(pid) {
   try {
     process.kill(pid, LIVENESS_SIGNAL);
-    return true;
-  } catch {
-    return false;
+    return void 0;
+  } catch (error) {
+    return error.code ?? NO_SUCH_PROCESS;
   }
 }
+function is_live_pid(pid) {
+  return pid >= LOWEST_REAL_PID && signal_refusal(pid) === void 0;
+}
+function is_present_pid(pid) {
+  return pid >= LOWEST_REAL_PID && signal_refusal(pid) !== NO_SUCH_PROCESS;
+}
 function read_proc_start(pid) {
   try {
     const stat = readFileSync3(`/proc/${String(pid)}/stat`, "utf8");
@@ -543,6 +549,11 @@ function is_same_process(pid, recorded_start, read2 = read_start) {
   if (recorded_start === void 0) return void 0;
   return matches_recorded_start(pid, recorded_start, read2);
 }
+function is_present_process(pid, recorded_start, read2 = read_start) {
+  if (!is_present_pid(pid)) return false;
+  if (recorded_start === void 0) return void 0;
+  return matches_recorded_start(pid, recorded_start, read2);
+}
 function is_own_process(pid, recorded_start) {
   return pid === process.pid && recorded_start === own_start();
 }
@@ -551,6 +562,8 @@ var process_identity = {
   is_live_beacon,
   is_live_pid,
   is_own_process,
+  is_present_pid,
+  is_present_process,
   is_same_process,
   open_beacon,
   own_fields,
@@ -1275,10 +1288,10 @@ var BACKLOG_COMMANDS = {
   // Started from a terminal: the `backlogrun` keyword's launcher, and the board.
   backlogrun: {
     script: "scripts/backlog/backlogrun-cli.ts",
-    description: "Start a backlogrun in the background and show its board; with one already running, only show the board",
+    description: "Start a backlogrun in the background and show its board; with one already running, only show the board, or replace it when it is idle and the invocation differs; --stop stops it",
     category: "AI tools",
     reference: [
-      "[#<n>...] [--only] [--max <n>] [--idle <minutes>] [--agent claude|codex]",
+      "[<n>...] [--only] [--max <n>] [--idle <minutes>] [--agent claude|codex] | --stop",
       "developer",
       ["files", "network", "processes"]
     ]
@@ -1388,6 +1401,12 @@ var GUARD_COMMANDS = {
 // scripts/josh/josh-commands-issue.ts
 var ISSUES_WITH_REPO = "<issue...> [--repo <owner/repo>]";
 var ISSUE_COMMANDS = {
+  "issue:ack": {
+    script: "scripts/issue/issue-ack-cli.ts",
+    description: "Record that the run read a person's update to its issue, printing the update it acknowledges",
+    category: "AI tools",
+    reference: ["<issue>", "automation", ["network"]]
+  },
   "issue:read": {
     script: "scripts/issue/issue-read-cli.ts",
     description: "Print each issue's title, body and every comment on it, in one call",
@@ -1441,16 +1460,16 @@ var ISSUE_COMMANDS = {
     description: "File an Issue with every filing step: lint, Origin, fold, WIP cap, duplicate scout, labels, then epic:bundle",
     category: "AI tools",
     reference: [
-      "<title> --body-file <path> --depth <0|1|2> [--route <route>] [--label <name>] [--repo <owner/repo>] [--distinct <N,\u2026>] [--over-cap] [--no-auto-ok] [--requested] [--release]",
+      "<title> --body-file <path> --depth <0|1|2> [--route <route>] [--label <name>] [--repo <owner/repo>] [--distinct <N,\u2026>] [--over-cap] [--no-auto-ok] [--release]",
       "automation",
       ["network"]
     ]
   },
   "issue:release": {
     script: "scripts/issue/issue-release-cli.ts",
-    description: "Link an Issue to the repository's open release Issue as its blocker, filing one when none is open",
+    description: "Link an Issue to the repository's open release Issue as its blocker (or, with --wait, as waiting on it), filing one when none is open",
     category: "AI tools",
-    reference: ["<issue>", "automation", ["network"]]
+    reference: ["<issue> [--wait]", "automation", ["network"]]
   }
 };
 
@@ -1486,7 +1505,7 @@ var LANE_COMMANDS = {
   },
   "lane:prune": {
     ...LANE_ARGUMENTS,
-    description: "Close every lane an interruption left without its work tree, then sweep unregistered leftovers under the lanes root",
+    description: "Close every lane an interruption left without its work tree and every spent lane, then sweep unregistered leftovers under the lanes root",
     category: "AI tools",
     reference: ["", "automation", ["files", "git"]],
     default_script_arguments: ["prune"]
@@ -1518,6 +1537,14 @@ var LANE_COMMANDS = {
     category: "AI tools",
     reference: ["<issue> [--stash <message>]", "automation", ["files", "git", "processes"]]
   },
+  // `.env` is read for `JOSH_LANE_ROOT`, as every lane command reads it, so the lane is found.
+  "lane:restart": {
+    script: "scripts/lane/lane-restart-cli.ts",
+    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
+    description: "Stop a running lane child, stash its uncommitted work and re-dispatch its issue in a fresh session \u2014 not counted as an outage or a failure",
+    category: "AI tools",
+    reference: ["<issue>", "developer", ["files", "git", "processes", "network"]]
+  },
   // A live run's lane limit: `.env` is read so the bare form reports the
   // `JOSH_LANE_LIMIT` a person set there when no override stands.
   "lane:limit": {
@@ -1538,7 +1565,7 @@ var LANE_COMMANDS = {
   },
   "lane:stats": {
     ...MEASURE_ARGUMENTS,
-    description: "Print one table row of lane throughput, gate duration and machine load over a period, and the per-stage durations of a lane under it",
+    description: "Print one table row of lane throughput, gate duration and machine load over a period, the per-stage durations of a lane under it, and the wait after each ship stop reason under those",
     category: "AI tools",
     reference: ["--period <days> [--limit <lane-limit>]", "maintainer", ["none"]],
     default_script_arguments: ["stats"]
@@ -1727,6 +1754,16 @@ var AI_COMMANDS = {
     category: "AI tools",
     reference: ["[--exclude <n>[,<n>...]] [--label <name>]", "automation", ["network"]]
   },
+  "auto-ok:judge": {
+    script: "scripts/auto-ok/auto-ok-judge-cli.ts",
+    description: "List the open issues backlogrun owes an auto-ok judgement, or record one (--apply / --decline)",
+    category: "AI tools",
+    reference: [
+      "[--apply <n> (--lane | --solo) | --decline <n> --reason <text>]",
+      "automation",
+      ["network"]
+    ]
+  },
   ...BACKLOG_COMMANDS,
   cost: {
     script: "scripts/cost-runtime/cost-cli.ts",
@@ -1905,17 +1942,27 @@ import { availableParallelism as availableParallelism4 } from "node:os";
 // scripts/lib/status-icons.ts
 var FAIL_ICON = "\u2717";
 var PASS_ICON = "\u2714";
-var status_icons = { FAIL_ICON, PASS_ICON };
+var WARN_ICON = "\u26A0";
+var status_icons = { FAIL_ICON, PASS_ICON, WARN_ICON };
 
 // scripts/josh/josh-verdict.ts
-var { FAIL_ICON: FAIL_ICON2, PASS_ICON: PASS_ICON2 } = status_icons;
+var { FAIL_ICON: FAIL_ICON2, PASS_ICON: PASS_ICON2, WARN_ICON: WARN_ICON2 } = status_icons;
 var GATE_SUBJECT = "verification gate";
 var GATE_PASSED_PREFIX = `${PASS_ICON2} ${GATE_SUBJECT} passed`;
 var GATE_FAILED_PREFIX = `${FAIL_ICON2} ${GATE_SUBJECT} failed`;
+var GATE_UNVERIFIED_PREFIX = `${WARN_ICON2} ${GATE_SUBJECT} not verified`;
 var PASSED_VERDICT = "passed";
 var FAILED_VERDICT = "failed";
-function format_gate_passed(step_count, total) {
-  return `${GATE_PASSED_PREFIX} (${step_count} checks) in ${total}.`;
+var UNVERIFIED_VERDICT = "unverified";
+function format_counts(counts) {
+  if (counts.skipped === 0) return `${String(counts.ran)} checks`;
+  return `${String(counts.ran)} ran, ${String(counts.skipped)} skipped`;
+}
+function format_gate_passed(counts, total) {
+  return `${GATE_PASSED_PREFIX} (${format_counts(counts)}) in ${total}.`;
+}
+function format_gate_unverified(skipped, total) {
+  return `${GATE_UNVERIFIED_PREFIX} (0 ran, ${String(skipped)} skipped) in ${total}.`;
 }
 function format_gate_failed(failed_labels, total) {
   return `${GATE_FAILED_PREFIX}: ${failed_labels} (${total})`;
@@ -1930,13 +1977,16 @@ function read_verdict(line) {
   const trimmed = line.trimStart();
   if (trimmed.startsWith(GATE_FAILED_PREFIX)) return FAILED_VERDICT;
   if (trimmed.startsWith(GATE_PASSED_PREFIX)) return PASSED_VERDICT;
+  if (trimmed.startsWith(GATE_UNVERIFIED_PREFIX)) return UNVERIFIED_VERDICT;
   return void 0;
 }
 var josh_verdict = {
   PASSED_VERDICT,
   FAILED_VERDICT,
+  UNVERIFIED_VERDICT,
   format_gate_passed,
   format_gate_failed,
+  format_gate_unverified,
   GATE_OPENING_MARK,
   GATE_OPENING_PREFIX,
   is_gate_opening,
@@ -2269,7 +2319,7 @@ var DEV_COMMANDS = {
   },
   "test:unit": {
     script: "scripts/test/test-unit-guard.ts",
-    description: "Run unit tests with Vitest (skips when Vitest is absent; fails when it has no tests)",
+    description: "Run unit tests with Vitest (without Vitest: a basic project runs its own test script, others skip; fails when Vitest has no tests)",
     category: "Development",
     reference: [FILTER_ARGUMENTS, "developer", ["processes"]],
     core_weight: gate_plan.direct_unit_weight,
@@ -2501,7 +2551,7 @@ var PROJECT_COMMANDS = {
     description: "Set a project up for the GitHub Issue workflow, from git init to the setup PR",
     category: "Project",
     reference: [
-      `${PROFILE_ARGUMENTS} [--yes] [--github] [--public] [--init-command <command>] [--push-preflight-command <command>]`,
+      `${PROFILE_ARGUMENTS} [--yes] [--github] [--public] [--dry-run] [--init-command <command>] [--push-preflight-command <command>]`,
       "developer",
       ["files", "git", "network", "processes"]
     ]
@@ -2513,12 +2563,28 @@ var PROJECT_COMMANDS = {
     reference: ["<dir>", "automation", ["files", "git"]],
     is_kit_only: true
   },
+  "fresh:run": {
+    script: "scripts/fresh-machine/fresh-machine-cli.ts",
+    description: "Run an install scenario in a Docker container of a machine with nothing installed, and keep the log",
+    category: "Project",
+    reference: [
+      "<pattern> | --spec <file.json> [--package-version <version>] [--log-dir <dir>] [--rebuild] | --list",
+      "maintainer",
+      ["files", "network", "processes"]
+    ]
+  },
+  "auth:setup": {
+    script: "scripts/auth/auth-setup-cli.ts",
+    description: "Save the long-lived Claude Code token `claude setup-token` prints in the macOS keychain, for josh fresh:run",
+    category: "Project",
+    reference: ["[--check]", "maintainer", ["network", "processes"]]
+  },
   init: {
     script: "scripts/init/init.ts",
     description: "Initialize config in a new project",
     category: "Project",
     reference: [
-      `${PROFILE_ARGUMENTS} [--no-install]`,
+      `${PROFILE_ARGUMENTS} [--no-install] [--dry-run]`,
       "developer",
       ["files", "network", "processes"]
     ]
@@ -2529,6 +2595,12 @@ var PROJECT_COMMANDS = {
     category: "Project",
     reference: ["", "developer", ["files"]]
   },
+  uninstall: {
+    script: "scripts/uninstall/uninstall.ts",
+    description: "Remove what kit added to a project and list what is left to review by hand",
+    category: "Project",
+    reference: [`${PROFILE_ARGUMENTS} [--yes]`, "developer", ["files", "processes"]]
+  },
   "registry:migrate": {
     script: "scripts/registry-migration/migrate.ts",
     description: "Migrate a project from GitHub Packages to public npm",
@@ -2791,6 +2863,7 @@ var ALIASES = {
   pf: "profile",
   st: "start",
   sy: "sync",
+  un: "uninstall",
   rmi: "registry:migrate",
   g: "git",
   gp: "pr",
@@ -2816,9 +2889,12 @@ var ALIASES = {
   rvf: "review:findings",
   ruv: "rule:value",
   ev: "eval",
+  fr: "fresh:run",
+  as: "auth:setup",
   lsm: "lane:sample",
   lst: "lane:stats",
   lli: "lane:limit",
+  lrs: "lane:restart",
   blr: "backlogrun"
 };
 

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.1387.0",
+  "version": "1.1453.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": [
@@ -276,6 +276,7 @@
   },
   "dependencies": {
     "cli-spinners": "^3.4.0",
+    "csv-parse": "^7.0.3",
     "execa": "^10.1.0",
     "js-yaml": "^5.4.3",
     "jsonc-parser": "^3.3.1",
@@ -284,12 +285,12 @@
     "string-width": "^8.3.0",
     "terminal-link": "^5.0.0",
     "tsx": "^4.23.15",
-    "zod": "^4.6.5"
+    "zod": "^4.6.6"
   },
   "devEngines": {
     "packageManager": {
       "name": "pnpm",
-      "version": "12.12.0+sha512.2ee06ac86db554cf384421461220f0e336a487bfd41b2acd04e17a86b1487832fe45e8d1743f7fc52acc77de12d2356b536fedf8229fc483239e40b13d474449",
+      "version": "12.12.1+sha512.b7f98934c0b1f29a65f5da52f2d7f994e7faad573ffdddea1497fb4dcb5aec051590ee7c7d95a38172b4bfae103a5b83edf2ee866e11731c2cafa96063610ac5",
       "onFail": "download"
     }
   },

package/prompts/collaboration-workflow/issue-template.md

@@ -6,6 +6,7 @@
 ## 背景
 
 <不具合なら `- 種別: 不具合`、そうでなければ `- 種別: 非不具合` を宣言する>
+<人の判断が要らなければ `- 人の判断: 不要`、要るなら `- 人の判断: 要（<方針の判断 / 外部アカウント / 目視確認>）` を宣言する>
 
 <なぜ必要か>
 
@@ -49,15 +50,16 @@
 
 ### `## 背景` 直下の宣言と分類ラベル
 
-起票は `pnpm josh issue:file "<title>" --body-file <本文ファイル> --depth <n>` で行う。本文の検査（`pnpm josh issue:lint <path>` と同じ）と、下表の宣言から決まる分類ラベルの付与は、このコマンドが 1 回の作成リクエストで行う。**宣言を選ぶのは起票者の判断であり、コマンドは単語から推測しない。** 人が依頼した起票（会話での依頼も含む）には `--requested` を付ける（`kickoff.md` → "Words typed after `new`"）。
+起票は `pnpm josh issue:file "<title>" --body-file <本文ファイル> --depth <n>` で行う。本文の検査（`pnpm josh issue:lint <path>` と同じ）と、下表の宣言から決まる分類ラベルの付与は、このコマンドが 1 回の作成リクエストで行う。**宣言を選ぶのは起票者の判断であり、コマンドは単語から推測しない。** `- 人の判断:` の行は必須で、`issue:file` だけが検査し（`issue:lint` は見ない）、`auto-ok` の判定に使う。判定は人が依頼した起票も含めてすべて同じ（`scripts/issue/issue-auto-ok.ts`、`docs/how-to/run-backlog.md`）。**`不要` を宣言する起票には `--label run:lane`（kit 自身の検証の不具合なら `run:solo`）も付ける** — 付いていなければ `issue:file` が拒否する。
 
-| 宣言                   | 付くラベル        | 選ぶ基準                                                                                   |
-| ---------------------- | ----------------- | ------------------------------------------------------------------------------------------ |
-| `- 種別: 不具合`       | `bug`             | 報告された症状を直す。`- 種別: 非不具合` とどちらか一方を必ず置く                          |
-| `- 目的: 機能追加`     | `enhancement`     | 新しい機能。不具合修正・文書のみ・依存更新・保守作業には書かない                           |
-| `- 目的: 機能改善`     | `enhancement`     | 既存機能の改善。目的が曖昧なら期待結果と受け入れ条件を具体化してから選ぶ                   |
-| `- 互換性: 破壊的変更` | `breaking-change` | 既存の利用者・API・設定の契約を変える。移行措置があっても書き、廃止対象と影響を説明する    |
-| `- 種別: 振る舞い変更` | なし              | AI の振る舞いを変える。`## 発火点` / `## ベースライン` / `## 再現` の 3 見出しが必須になる |
+| 宣言                   | 付くラベル                        | 選ぶ基準                                                                                                        |
+| ---------------------- | --------------------------------- | --------------------------------------------------------------------------------------------------------------- |
+| `- 種別: 不具合`       | `bug`                             | 報告された症状を直す。`- 種別: 非不具合` とどちらか一方を必ず置く                                               |
+| `- 目的: 機能追加`     | `enhancement`                     | 新しい機能。不具合修正・文書のみ・依存更新・保守作業には書かない                                                |
+| `- 目的: 機能改善`     | `enhancement`                     | 既存機能の改善。目的が曖昧なら期待結果と受け入れ条件を具体化してから選ぶ                                        |
+| `- 互換性: 破壊的変更` | `breaking-change`                 | 既存の利用者・API・設定の契約を変える。移行措置があっても書き、廃止対象と影響を説明する                         |
+| `- 種別: 振る舞い変更` | なし                              | AI の振る舞いを変える。`## 発火点` / `## ベースライン` / `## 再現` の 3 見出しが必須になる                      |
+| `- 人の判断: 不要`     | `auto-ok`（除外ラベルがなければ） | 方針の判断・外部アカウント・人の目視確認のどれも要らない。`- 人の判断: 要（<どれか>）` とどちらか一方を必ず置く |
 
 - **持ち主の意図と違う動きは、コード・コメント・テストに書かれた設計どおりでも `- 種別: 不具合` とする。** コードは意図を写したもので、意図そのものではない。変更の形（コードか文書か）でも決めない。例: コメントとテストに固定されたまま意図より広く働く自動付与、文書だけでも意図と違う分類を生む基準
 - **`- 種別: 不具合` の Issue の回帰テストは、利用者が症状を見たのと同じ粒度で書く。** 修正前のツリーでも緑になるテストは `pnpm josh git -y` がコミットを拒否する（joshuafolkken/kit#2448）

package/prompts/review.md

@@ -27,6 +27,28 @@ is a verification pass over the fixes, not the first review again
 
 ---
 
+## Before round 1 — the implementer's self-check
+
+**Answer these five over your own diff before the scoped pair that precedes round 1.** A round-1
+High/Medium makes round 2 due, and most of them are of a kind the implementer clears more cheaply
+than a reviewer finds: in a sample of 135 round-1 High/Medium findings, about two in three fell under one of these questions. Fix what an answer turns up; the review, its
+severity tests and the round cap are unchanged.
+
+1. **Tests pin the change** — for each condition, branch or call you added or changed, name the test
+   that turns red when it is deleted or inverted, and check its fixture actually reaches that branch
+   (no assert on a string the code never draws, no comparison against a literal copy).
+2. **Prose matches the code** — grep the docs, prompts and comments for the old wording of every
+   behavior, constant, command and heading you changed, moved or removed, `"the table above"` and
+   rewritten sentences included.
+3. **Failure is not a negative answer** — every timeout, non-zero exit or `gh` failure on a path you
+   touched returns something a caller can tell apart from `false`, `undefined` or "nothing found".
+4. **Every caller moved with it** — grep every reference to a function, list or command you changed,
+   and update each sibling path (the other CLI, the registry, the consumer side) in the same change.
+5. **The Issue is met on HEAD** — the premises you relied on hold on the current tree, and each
+   acceptance criterion is checked off one by one against the diff.
+
+---
+
 ## Review level (decided by `pnpm josh review:brief --level-only`, never by judgement)
 
 **Run `pnpm josh review:brief --level-only` and use what it prints** — `low` or `medium`, from the
@@ -78,10 +100,14 @@ round-1 High/Medium finding actually closed — by a fix in this working tree, o
 positive — and none was filed or deferred. **Without the flag the answer is `required`**, which is also
 what the command answers to every uncertainty it meets, a missing round-1 snapshot included.
 
-**`skip` has exactly two arms** — **A** (no fix code: the fix delta is empty) and **B** (inert fix
-code: every path in the fix delta is inert by the review-level classification above); the reason line
-names which fired. Why neither weakens the standard: `docs/maintainers/review-history.md` → "The two
-skip arms".
+**`skip` has exactly two arms** — **A** (no fix code: the fix delta is empty) and **B** (a fix that
+leaves what executes unchanged: every path in the fix delta is inert by the review-level classification
+above, `docs/**/*.md`, the root `README.md`, under `prompts/`, or a `.ts` / `.js` / `.svelte` file
+outside `.claude/` whose only change is in comments, a directive comment — lint, type-check, coverage
+or bundler — counting as code); the reason line names which fired. **One path
+outside that set makes the round `required`** — `.claude/**`, `CLAUDE.md`, a test, configuration, a
+code line, or a source file whose comment-free text cannot be read. Why neither arm weakens the
+standard: `docs/maintainers/review-history.md` → "The two skip arms".
 
 **A skipped round is recorded on the Issue**, so the condition stays auditable and can be withdrawn if
 a defect is later traced to a skipped delta: