@joshuafolkken/kit 1.1387.0 → 1.1453.0

package/dist/hooks/{chunk-FZ6FUSBM.js → chunk-723HKZO5.js}

@@ -1,6 +1,6 @@
 import {
   FETCH_TIMEOUT_MS
-} from "./chunk-NEC4AT4Z.js";
+} from "./chunk-DGT54IH5.js";
 
 // scripts/lib/timed-fetch.ts
 async function timed_fetch(url, init = {}, timeout_ms = FETCH_TIMEOUT_MS) {

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

@@ -1,18 +1,18 @@
 import {
   resolve_local_bin,
   resolve_package_bin
-} from "./chunk-JBBMAPC4.js";
+} from "./chunk-IX6TTTI6.js";
 import {
   ESLINT_EDIT_CACHE_FLAGS,
   time_density_hook
-} from "./chunk-SL4GQ2XP.js";
+} from "./chunk-MBJYQPEK.js";
 import {
   file_reader,
   json_value
-} from "./chunk-2YSW3CXH.js";
+} from "./chunk-3C4XRYG6.js";
 import {
   HOOK_PROCESS_TIMEOUT_MS
-} from "./chunk-NEC4AT4Z.js";
+} from "./chunk-DGT54IH5.js";
 
 // scripts/hooks/format-edited-file.ts
 import { existsSync as existsSync2 } from "node:fs";

package/dist/hooks/{chunk-NEC4AT4Z.js → chunk-DGT54IH5.js}

@@ -3,6 +3,9 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 var PACKAGE_DIR = path.join(path.dirname(fileURLToPath(import.meta.url)), "..", "..");
 var PROJECT_ROOT = process.cwd();
+function package_path(relative_path) {
+  return path.join(PACKAGE_DIR, relative_path);
+}
 
 // scripts/josh/stamp-file.ts
 import { createHash, randomUUID } from "node:crypto";
@@ -144,6 +147,7 @@ var SUITE_TIMEOUT_MS = 18e5;
 
 export {
   PROJECT_ROOT,
+  package_path,
   PLATFORM_TEMP_ROOT,
   platform_temporary,
   stamp_file,

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

@@ -1,12 +1,12 @@
 import {
   lane_guard_policy
-} from "./chunk-EAQEGME7.js";
+} from "./chunk-UT7YC3N2.js";
 import {
   hook_decision
-} from "./chunk-EBSHN25W.js";
+} from "./chunk-W5ZKGTSY.js";
 import {
   time_batch_guard
-} from "./chunk-SL4GQ2XP.js";
+} from "./chunk-MBJYQPEK.js";
 
 // scripts/hooks/batch-guard.ts
 import { text } from "node:stream/consumers";

package/dist/hooks/{chunk-JBBMAPC4.js → chunk-IX6TTTI6.js}

@@ -85,6 +85,10 @@ function resolve_package_bin(base_directory, package_name, bin_name) {
 
 export {
   ancestor_directories,
+  vscode_settings_schema,
+  json_object_schema,
+  string_array_schema,
+  string_record_schema,
   resolve_local_bin,
   find_local_bin_upwards,
   resolve_package_bin

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

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

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

@@ -6,12 +6,12 @@ import {
   process_owner_schema,
   run_carry,
   time_instant
-} from "./chunk-2YSW3CXH.js";
+} from "./chunk-3C4XRYG6.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",
@@ -313,16 +319,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"]]
   }
 };
 
@@ -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"]
@@ -599,6 +613,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",
@@ -1307,17 +1331,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 +1366,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 +1708,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,
@@ -1903,7 +1940,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"]
     ]
@@ -1915,12 +1952,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"]
     ]
@@ -1931,6 +1984,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 +2243,7 @@ var ALIASES = {
   pf: "profile",
   st: "start",
   sy: "sync",
+  un: "uninstall",
   rmi: "registry:migrate",
   g: "git",
   gp: "pr",
@@ -2209,9 +2269,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 +2507,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 +2581,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 +2617,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 +2760,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 +2796,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 +2854,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 +2878,7 @@ var lane_ledger = {
   record_gate,
   record_merge,
   record_stage,
+  record_stop,
   target,
   target_of
 };
@@ -2984,8 +3063,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 +3092,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;
   }

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

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

package/dist/hooks/{chunk-J3KSS7II.js → chunk-OLMO72ON.js}

@@ -2,7 +2,7 @@ import {
   ENV_FILE_NAME,
   issue_number_shape,
   lane_paths
-} from "./chunk-2YSW3CXH.js";
+} from "./chunk-3C4XRYG6.js";
 
 // scripts/josh/josh-environment-file.ts
 function load_environment_file() {

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

@@ -1,18 +1,18 @@
 import {
   investigation_reads
-} from "./chunk-WNFJLBXI.js";
+} from "./chunk-NO4AALP5.js";
 import {
   lane_guard_policy
-} from "./chunk-EAQEGME7.js";
+} from "./chunk-UT7YC3N2.js";
 import {
   hook_decision
-} from "./chunk-EBSHN25W.js";
+} from "./chunk-W5ZKGTSY.js";
 import {
   time_spans
-} from "./chunk-SL4GQ2XP.js";
+} from "./chunk-MBJYQPEK.js";
 import {
   json_value
-} from "./chunk-2YSW3CXH.js";
+} from "./chunk-3C4XRYG6.js";
 
 // scripts/delegation/duplicate-read-guard.ts
 import { statSync } from "node:fs";

package/dist/hooks/{chunk-EAQEGME7.js → chunk-UT7YC3N2.js}

@@ -1,6 +1,6 @@
 import {
   lane_child_marker
-} from "./chunk-J3KSS7II.js";
+} from "./chunk-OLMO72ON.js";
 
 // scripts/lane/lane-guard-policy.ts
 var DEFAULT_MODE = "refuse";

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

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