@joshuafolkken/kit 1.1383.0 → 1.1435.0

package/dist/hooks/session-lang.js

@@ -1,25 +1,29 @@
 #!/usr/bin/env tsx
-import {
-  session_language
-} from "./chunk-6V5OPIUU.js";
 import {
   agent_role_profile,
   detached_launch,
   git_common_directory,
-  run_headless
-} from "./chunk-2X2ART5G.js";
+  issue_cite,
+  run_event_stream,
+  run_event_stream_emit,
+  run_headless,
+  session_language
+} from "./chunk-YW452ZAX.js";
+import {
+  error_text
+} from "./chunk-CDY4NFQG.js";
 import {
   josh_environment_file
-} from "./chunk-Y5R47QHU.js";
+} from "./chunk-4BHUPFKF.js";
 import {
   agent_session_environment,
   json_value,
   process_identity,
   run_carry
-} from "./chunk-4MGHBTOM.js";
+} from "./chunk-3LE6VLSR.js";
 import {
   stamp_file
-} from "./chunk-NEC4AT4Z.js";
+} from "./chunk-DGT54IH5.js";
 
 // scripts/josh/session-language-cli.ts
 import { fileURLToPath } from "node:url";
@@ -98,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";
@@ -298,6 +309,65 @@ var agent_argv = {
   with_resume_in
 };
 
+// scripts/run/event/run-event-setup.ts
+var STAGE = {
+  // `josh backlogrun` started the parent session, which is reading its procedure.
+  STARTING: "starting session",
+  // `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",
+  // 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 append_stage(resolve_target, text, at) {
+  try {
+    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.append_stage", error);
+  }
+}
+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";
 var LAUNCH_PREFIX = "josh-backlogrun-launch-";
@@ -306,7 +376,11 @@ var LOG_SUFFIX = ".log";
 var launch_schema = z.object({
   pid: z.number(),
   start: z.string().optional(),
-  session: z.string().optional()
+  session: z.string().optional(),
+  // What the parent was started to run and when, so `run:board` has a run to draw and a clock to count
+  // before the parent claims the carry record. Absent on a record an earlier version wrote.
+  invocation: z.string().optional(),
+  started_at: z.string().optional()
 });
 function launch_path(git_directory) {
   return stamp_file.stamp_path(LAUNCH_PREFIX, git_directory);
@@ -348,9 +422,41 @@ function argv_of(invocation, provider, worktree, session) {
 function note_to_stderr(note) {
   console.error(`backlogrun: ${note}`);
 }
-function record_launch(git_directory, pid, session) {
-  const started = process_identity.read_start(pid);
-  stamp_file.replace_stamp(launch_path(git_directory), { pid, start: started, session });
+function record_launch(git_directory, launch) {
+  const now = /* @__PURE__ */ new Date();
+  const identity = process_identity.read_start(launch.pid);
+  const record = { ...launch, start: identity, started_at: now.toISOString() };
+  stamp_file.replace_stamp(launch_path(git_directory), record);
+  run_event_setup.emit_in(git_directory, run_event_setup.STAGE.STARTING, now);
+}
+function live_launch(git_directory) {
+  const record = read_launch(launch_path(git_directory));
+  return is_launch_live(record) ? record : void 0;
+}
+function pending_launch(git_directory) {
+  const { invocation, started_at } = live_launch(git_directory) ?? {};
+  if (invocation === void 0 || started_at === void 0) return void 0;
+  return { invocation, started_at };
+}
+function started_for(git_directory, owner_pid) {
+  const record = live_launch(git_directory);
+  if (record?.started_at === void 0 || record.pid !== owner_pid) return void 0;
+  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 = {
@@ -376,7 +482,7 @@ function start(invocation, provider, target) {
   if (built.kind === "rejected") return { kind: "failed", note: built.note };
   const result = spawn_parent(built, provider, target);
   if (result.kind === "failed") return result;
-  record_launch(target.git_directory, result.pid, session);
+  record_launch(target.git_directory, { pid: result.pid, session, invocation });
   const launched = { pid: result.pid, session, log_path: log_path(target.git_directory) };
   return { kind: "launched", launched };
 }
@@ -384,7 +490,10 @@ var backlogrun_launch = {
   argv_of,
   chosen_environment,
   is_running,
-  start
+  pending_launch,
+  start,
+  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,
@@ -13,35 +12,33 @@ import {
   lane_park,
   repo_party,
   run_cut,
-  run_event_stream,
-  run_event_stream_emit,
   run_hold
-} from "./chunk-6AC4C2IO.js";
-import {
-  session_language
-} from "./chunk-6V5OPIUU.js";
+} from "./chunk-YZXYOAZ3.js";
 import {
   agent_headless,
   agent_role_profile,
   issue_cite,
   lane_registry,
-  run_headless
-} from "./chunk-2X2ART5G.js";
+  run_event_stream,
+  run_event_stream_emit,
+  run_headless,
+  session_language
+} from "./chunk-YW452ZAX.js";
 import {
   timed_fetch
-} from "./chunk-FZ6FUSBM.js";
+} from "./chunk-723HKZO5.js";
 import "./chunk-CDY4NFQG.js";
 import {
   hook_decision
-} from "./chunk-LC56R53A.js";
+} from "./chunk-MU4LJFIV.js";
 import {
   time_density_hook,
   time_hook_transcript,
   time_reported_failure
-} from "./chunk-TT742SIO.js";
+} from "./chunk-XER6SSIB.js";
 import {
   lane_child_marker
-} from "./chunk-Y5R47QHU.js";
+} from "./chunk-4BHUPFKF.js";
 import {
   backlog_budget,
   issue_number_shape,
@@ -50,11 +47,10 @@ import {
   process_owner_schema,
   run_carry,
   run_invocation
-} from "./chunk-4MGHBTOM.js";
+} from "./chunk-3LE6VLSR.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";
@@ -964,8 +939,53 @@ var run_halfrun_resume = {
   take_over
 };
 
-// scripts/run/wake/run-wake.ts
+// scripts/run/carry/run-carry-ended.ts
+import path from "node:path";
 import { z as z4 } from "zod";
+var ENDED_PREFIX = "josh-run-ended-";
+var TRANSCRIPT_SUFFIX = ".jsonl";
+var ended_run_schema = z4.object({
+  invocation: z4.string(),
+  started_at: z4.string(),
+  ended_at: z4.string(),
+  stopped: z4.string().optional(),
+  session: z4.string().optional()
+});
+function ended_path(git_directory) {
+  return stamp_file.stamp_path(ENDED_PREFIX, git_directory);
+}
+function session_of(transcript) {
+  return transcript === void 0 ? void 0 : path.basename(transcript, TRANSCRIPT_SUFFIX);
+}
+function stop_of(transcript, stopped) {
+  return stopped === void 0 ? {} : { stopped, session: session_of(transcript) };
+}
+function record_ended(target, read, now = /* @__PURE__ */ new Date(), stopped) {
+  if (read.kind !== "carried") return;
+  const { invocation, started_at, owner_transcript } = read.carry;
+  const ended_at = now.toISOString();
+  stamp_file.replace_stamp(target, {
+    invocation,
+    started_at,
+    ended_at,
+    ...stop_of(owner_transcript, stopped)
+  });
+}
+function parse_ended(raw) {
+  return json_value.parse_with(raw, ended_run_schema);
+}
+function read_ended(target) {
+  const raw = stamp_file.read_stamp_text(target);
+  return raw === void 0 ? void 0 : parse_ended(raw);
+}
+function has_ended(target, started_at) {
+  const ended = read_ended(target);
+  return ended !== void 0 && ended.started_at === started_at;
+}
+var run_carry_ended = { ended_path, has_ended, read_ended, record_ended };
+
+// scripts/run/wake/run-wake.ts
+import { z as z5 } from "zod";
 var WAKE_PREFIX = "josh-run-wake-";
 var WAKE_LOG_PREFIX = "josh-run-wake-log-";
 var WAKE_LOG_SUFFIX = ".log";
@@ -984,15 +1004,15 @@ var STOP_REASONS = {
   unreadable: "unreadable"
 };
 var run_wake_schema = process_owner_schema.extend({
-  invocation: z4.string(),
-  started_at: z4.string(),
-  woke: z4.number(),
-  woke_at: z4.string().optional(),
+  invocation: z5.string(),
+  started_at: z5.string(),
+  woke: z5.number(),
+  woke_at: z5.string().optional(),
   // Every optional `RunWake` field must be listed: `z.object` strips undeclared ones on the round trip.
-  attempts: z4.number().optional(),
-  woke_pid: z4.number().optional(),
-  spawned: z4.array(z4.string()).optional(),
-  idle_since: z4.string().optional(),
+  attempts: z5.number().optional(),
+  woke_pid: z5.number().optional(),
+  spawned: z5.array(z5.string()).optional(),
+  idle_since: z5.string().optional(),
   profile: agent_role_profile.PROFILE_SCHEMA.optional()
 });
 function is_overdue(marked_at, now, limit_ms = WAKE_GRACE_MS) {
@@ -1186,10 +1206,12 @@ var run_stranded = {
 
 // scripts/run/run-stranded-detect.ts
 var STRAND_RECOVERY = `Restart supervision with \`${run_stranded.RECOVERY_COMMAND}\` \u2014 it wakes a fresh successor to claim the budget; the cutting session must not resume it itself.`;
+function targets_of(directory) {
+  return { carry: run_carry.carry_path(directory), wake: run_wake.wake_path(directory) };
+}
 async function real_resolve_targets() {
   const directory = await run_carry.repository_directory();
-  if (directory === void 0) return void 0;
-  return { carry: run_carry.carry_path(directory), wake: run_wake.wake_path(directory) };
+  return directory === void 0 ? void 0 : targets_of(directory);
 }
 async function real_emit_stranded(text2) {
   return await run_event_stream_emit.emit_once(run_event_stream.EVENT_KIND.STRANDED, text2);
@@ -1201,14 +1223,13 @@ var DEFAULT_PORTS3 = {
   resolve_targets: real_resolve_targets,
   read_carry: (target) => run_carry.read_carry(target),
   is_owner_live: run_carry.is_owner_live,
+  has_ended: run_carry_ended.has_ended,
   read_wake: (target) => run_wake.read_wake(target),
   supervisor_liveness: (wake) => run_stranded.supervisor_liveness(wake),
   emit_stranded: real_emit_stranded,
   notify_stranded: real_notify_stranded
 };
-async function gather2(ports) {
-  const targets = await ports.resolve_targets();
-  if (targets === void 0) return void 0;
+function input_at(ports, targets) {
   const read = ports.read_carry(targets.carry);
   if (read.kind !== "carried") return void 0;
   return {
@@ -1217,6 +1238,10 @@ async function gather2(ports) {
     supervisor: ports.supervisor_liveness(ports.read_wake(targets.wake))
   };
 }
+async function gather2(ports) {
+  const targets = await ports.resolve_targets();
+  return targets === void 0 ? void 0 : input_at(ports, targets);
+}
 async function report2(ports, input) {
   if (input.read.kind !== "carried") return;
   const text2 = run_stranded.describe(input.read.carry);
@@ -1235,7 +1260,25 @@ async function run_stranded_check() {
   } catch {
   }
 }
-var run_stranded_detect = { detect_and_report: detect_and_report2, run_stranded_check };
+function is_stranded_at(directory, ports = DEFAULT_PORTS3) {
+  const input = input_at(ports, targets_of(directory));
+  return input !== void 0 && run_stranded.is_stranded(input);
+}
+function is_left_stranded(run, ports = DEFAULT_PORTS3) {
+  const read = ports.read_carry(run.carry_target);
+  if (read.kind !== "carried") return !ports.has_ended(run.ended_target, run.started_at);
+  return run_stranded.is_stranded({
+    read,
+    is_owner_live: run_carry.is_held_by_another(read.carry, ports.is_owner_live),
+    supervisor: run_stranded.GONE
+  });
+}
+var run_stranded_detect = {
+  detect_and_report: detect_and_report2,
+  is_left_stranded,
+  is_stranded_at,
+  run_stranded_check
+};
 
 // scripts/hooks/stop-guard.ts
 async function hold_facts() {

package/dist/josh.js

@@ -1275,10 +1275,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 +1388,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",
@@ -1486,7 +1492,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 +1524,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 +1552,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"]
@@ -1905,17 +1919,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 +1954,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 +2296,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 +2528,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>]`,
+      `${PROFILE_ARGUMENTS} [--yes] [--github] [--public] [--init-command <command>] [--push-preflight-command <command>]`,
       "developer",
       ["files", "git", "network", "processes"]
     ]
@@ -2513,6 +2540,22 @@ 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",
@@ -2529,6 +2572,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 +2840,7 @@ var ALIASES = {
   pf: "profile",
   st: "start",
   sy: "sync",
+  un: "uninstall",
   rmi: "registry:migrate",
   g: "git",
   gp: "pr",
@@ -2816,9 +2866,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.1383.0",
+  "version": "1.1435.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"
     }
   },