@joshuafolkken/kit 1.1387.0 → 1.1435.0

package/dist/hooks/{chunk-DCY2GWHC.js → chunk-MSYSUSY6.js}

@@ -1,18 +1,18 @@
 import {
   investigation_reads
-} from "./chunk-WNFJLBXI.js";
+} from "./chunk-QL6QTPWN.js";
 import {
   lane_guard_policy
-} from "./chunk-EAQEGME7.js";
+} from "./chunk-5SJSSCJG.js";
 import {
   hook_decision
-} from "./chunk-EBSHN25W.js";
+} from "./chunk-MU4LJFIV.js";
 import {
   time_spans
-} from "./chunk-SL4GQ2XP.js";
+} from "./chunk-XER6SSIB.js";
 import {
   json_value
-} from "./chunk-2YSW3CXH.js";
+} from "./chunk-3LE6VLSR.js";
 
 // scripts/delegation/duplicate-read-guard.ts
 import { statSync } from "node:fs";

package/dist/hooks/{chunk-EBSHN25W.js → chunk-MU4LJFIV.js}

@@ -1,16 +1,16 @@
 import {
   time_density_hook,
   time_hook_transcript
-} from "./chunk-SL4GQ2XP.js";
+} from "./chunk-XER6SSIB.js";
 import {
   josh_environment_file
-} from "./chunk-J3KSS7II.js";
+} from "./chunk-4BHUPFKF.js";
 import {
   json_value
-} from "./chunk-2YSW3CXH.js";
+} from "./chunk-3LE6VLSR.js";
 import {
   stamp_file
-} from "./chunk-NEC4AT4Z.js";
+} from "./chunk-DGT54IH5.js";
 
 // scripts/josh/hook-decision.ts
 import { z } from "zod";

package/dist/hooks/{chunk-WNFJLBXI.js → chunk-QL6QTPWN.js}

@@ -1,16 +1,16 @@
 import {
   hook_decision
-} from "./chunk-EBSHN25W.js";
+} from "./chunk-MU4LJFIV.js";
 import {
   cost_blocks,
   time_batch_guard,
   time_bundle_call,
   time_shell,
   time_spans
-} from "./chunk-SL4GQ2XP.js";
+} from "./chunk-XER6SSIB.js";
 import {
   cost_transcript
-} from "./chunk-2YSW3CXH.js";
+} from "./chunk-3LE6VLSR.js";
 
 // scripts/delegation/investigation-reads.ts
 import path2 from "node:path";

package/dist/hooks/{chunk-SL4GQ2XP.js → chunk-XER6SSIB.js}

@@ -6,12 +6,12 @@ import {
   process_owner_schema,
   run_carry,
   time_instant
-} from "./chunk-2YSW3CXH.js";
+} from "./chunk-3LE6VLSR.js";
 import {
   PLATFORM_TEMP_ROOT,
   PROBE_TIMEOUT_MS,
   stamp_file
-} from "./chunk-NEC4AT4Z.js";
+} from "./chunk-DGT54IH5.js";
 
 // scripts/cost-runtime/cost-blocks.ts
 import { z } from "zod";
@@ -147,10 +147,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"]
     ]
@@ -260,6 +260,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",
@@ -358,7 +364,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"]
@@ -390,6 +396,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": {
@@ -410,7 +424,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"]
@@ -1307,17 +1321,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})`;
@@ -1332,13 +1356,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,
@@ -1671,7 +1698,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,
@@ -1915,6 +1942,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",
@@ -1931,6 +1974,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",
@@ -2184,6 +2233,7 @@ var ALIASES = {
   pf: "profile",
   st: "start",
   sy: "sync",
+  un: "uninstall",
   rmi: "registry:migrate",
   g: "git",
   gp: "pr",
@@ -2209,9 +2259,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"
 };
 function canonical_command(name) {
@@ -2444,7 +2497,8 @@ var rollup_item_schema = z3.looseObject({
   status: z3.string().optional(),
   conclusion: z3.string().optional(),
   name: z3.string().optional(),
-  context: z3.string().optional()
+  context: z3.string().optional(),
+  description: z3.string().nullish()
 });
 var pr_raw_schema = z3.object({
   statusCheckRollup: z3.array(rollup_item_schema).optional(),
@@ -2517,6 +2571,7 @@ var KEY_STATUS = "status";
 var KEY_CONCLUSION = "conclusion";
 var KEY_NAME = "name";
 var KEY_CONTEXT = "context";
+var KEY_DESCRIPTION = "description";
 function read_string(value) {
   if (typeof value !== "string") return void 0;
   const trimmed = value.trim();
@@ -2552,7 +2607,9 @@ function read_rollup_array(parsed) {
 function parse_rollup_item(item) {
   const name = read_string(item[KEY_NAME]) ?? read_string(item[KEY_CONTEXT]);
   if (name === void 0) return void 0;
-  return { name, status: parse_rollup_status(item) };
+  const check = { name, status: parse_rollup_status(item) };
+  const description = read_string(item[KEY_DESCRIPTION]);
+  return description === void 0 ? check : { ...check, description };
 }
 function parse_rollup_checks(raw_json) {
   const parsed = json_value.parse_or_undefined(raw_json);
@@ -2693,7 +2750,8 @@ var KIND = {
   GATE: "gate",
   LOAD: "load",
   DISPATCH: "dispatch",
-  STAGE: "stage"
+  STAGE: "stage",
+  STOP: "stop"
 };
 var merge_schema = z4.object({ kind: z4.literal(KIND.MERGE), at: z4.string(), issue: z4.number() });
 var gate_schema = z4.object({
@@ -2728,12 +2786,19 @@ var stage_schema = z4.object({
   elapsed_ms: z4.number(),
   issue: z4.number().optional()
 });
+var stop_schema = z4.object({
+  kind: z4.literal(KIND.STOP),
+  at: z4.string(),
+  issue: z4.number(),
+  reason: z4.string()
+});
 var entry_schema = z4.discriminatedUnion("kind", [
   merge_schema,
   gate_schema,
   load_schema,
   dispatch_schema,
-  stage_schema
+  stage_schema,
+  stop_schema
 ]);
 function target_of(repository) {
   return stamp_file.stamp_path(LEDGER_PREFIX, repository, LEDGER_SUFFIX);
@@ -2779,6 +2844,9 @@ async function record_dispatch(issue, path4) {
 async function record_stage(stage, path4) {
   await record({ kind: KIND.STAGE, at: now_iso(), ...stage }, path4);
 }
+async function record_stop(stop, path4) {
+  await record({ kind: KIND.STOP, at: now_iso(), ...stop }, path4);
+}
 function parse_line2(line) {
   return entry_schema.safeParse(json_value.parse_or_undefined(line)).data;
 }
@@ -2800,6 +2868,7 @@ var lane_ledger = {
   record_gate,
   record_merge,
   record_stage,
+  record_stop,
   target,
   target_of
 };
@@ -2984,8 +3053,12 @@ function is_failure_line(line) {
 function is_failed_verdict(line) {
   return josh_verdict.read_verdict(line) === josh_verdict.FAILED_VERDICT;
 }
-function is_passed_verdict(line) {
-  return josh_verdict.read_verdict(line) === josh_verdict.PASSED_VERDICT;
+var GREEN_VERDICTS = /* @__PURE__ */ new Set([
+  josh_verdict.PASSED_VERDICT,
+  josh_verdict.UNVERIFIED_VERDICT
+]);
+function is_green_verdict(line) {
+  return GREEN_VERDICTS.has(josh_verdict.read_verdict(line));
 }
 function new_scan() {
   return {
@@ -3009,7 +3082,7 @@ function note_failure(scan) {
   scan.has_failure_before_region = true;
 }
 function scan_line(scan, line) {
-  if (is_passed_verdict(line)) {
+  if (is_green_verdict(line)) {
     close_region(scan);
     return;
   }