@joshuafolkken/kit 1.1471.0 → 1.1514.0

package/.github/workflows/publish.yml

@@ -83,7 +83,7 @@ jobs:
         env:
           LATEST: ${{ steps.registry-latest.outputs.latest }}
 
-      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+      - uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
         with:
           name: kit-package
           path: ${{ runner.temp }}
@@ -126,7 +126,7 @@ jobs:
         with:
           cache: 'false'
 
-      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+      - uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
         with:
           name: kit-package
           path: ${{ runner.temp }}

package/CLAUDE.md

@@ -80,7 +80,7 @@ Never start a `kickoff` / `halfrun` / `prrun` / `fullrun` / `backlogrun` workflo
 
 #### Mid-workflow stop notification (`confirmation`)
 
-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):
+The `Stop` hook sends it when your held run awaits a decision — lead with the reason, end with `Recommended: <choice>`. Send it yourself only when the hook refuses the stop:
 
 ```bash
 pnpm josh notify --task-type confirmation --issue-url "<url>" --body=$'<reason>' --recommended "<choice>" --alternative "<other>"

package/cspell/index.yaml

@@ -26,11 +26,17 @@ ignorePaths:
   # joshuafolkken/kit#1347: `josh lint:related` has its own for the same reason — an implementation
   # loop calls it while the gate lints the whole tree, and two eslint runs on one cache file discard
   # each other's entries.
+  # joshuafolkken/kit#3948: prettier's gate and scoped caches, and the pre-commit hook's own cspell and
+  # eslint caches — a staged-files run on the gate's file would prune or narrow it.
   - '**/.eslintcache'
   - '**/.eslintcache.edit'
   - '**/.eslintcache.related'
+  - '**/.eslintcache.commit'
   - '**/.tsbuildinfo'
   - '**/.cspellcache'
+  - '**/.cspellcache.commit'
+  - '**/.prettiercache'
+  - '**/.prettiercache.related'
   - '**/.gitignore'
   - '**/pnpm-lock.yaml'
   - '**/.vscode/**'
@@ -110,6 +116,7 @@ words:
   - domcontentloaded
   - esbuild
   - eslintcache
+  - prettiercache
   - fetchpriority
   - fullrun
   - halfrun

package/dist/CLAUDE.md

@@ -80,7 +80,7 @@ Never start a `kickoff` / `halfrun` / `prrun` / `fullrun` / `backlogrun` workflo
 
 #### Mid-workflow stop notification (`confirmation`)
 
-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):
+The `Stop` hook sends it when your held run awaits a decision — lead with the reason, end with `Recommended: <choice>`. Send it yourself only when the hook refuses the stop:
 
 ```bash
 pnpm josh notify --task-type confirmation --issue-url "<url>" --body=$'<reason>' --recommended "<choice>" --alternative "<other>"

package/dist/commands/document-section-cli.js

@@ -1,13 +1,43 @@
 #!/usr/bin/env tsx
 
 // scripts/document/document-section-cli.ts
-import { existsSync as existsSync2 } from "node:fs";
-import path6 from "node:path";
+import { existsSync as existsSync3 } from "node:fs";
+import path8 from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 
+// scripts/josh/package-directory.ts
+import { existsSync } from "node:fs";
+import path2 from "node:path";
+
+// scripts/lib/ancestor-directories.ts
+import path from "node:path";
+var MAX_DEPTH = 64;
+function list(start_directory) {
+  const directories = [];
+  let current = path.resolve(start_directory);
+  while (directories.length < MAX_DEPTH && !directories.includes(current)) {
+    directories.push(current);
+    current = path.dirname(current);
+  }
+  return directories;
+}
+function nearest(start_directory, is_match2) {
+  return list(start_directory).find((directory) => is_match2(directory));
+}
+var ancestor_directories = { list, nearest };
+
+// scripts/josh/package-directory.ts
+var PACKAGE_JSON = "package.json";
+function find_package_directory(start_directory) {
+  return ancestor_directories.nearest(
+    start_directory,
+    (directory) => existsSync(path2.join(directory, PACKAGE_JSON))
+  ) ?? start_directory;
+}
+
 // scripts/document/capped-print.ts
 import { mkdtempSync, writeFileSync } from "node:fs";
-import path3 from "node:path";
+import path5 from "node:path";
 
 // scripts/josh/platform-temporary.ts
 import { accessSync, constants } from "node:fs";
@@ -82,7 +112,7 @@ function reading_block(parts, cap) {
 var review_diff_parts = { body_of, part_texts, reading_block, split_text };
 
 // scripts/document/bash-output-cap.ts
-import path from "node:path";
+import path3 from "node:path";
 
 // scripts/lib/read-file.ts
 import { readFileSync } from "node:fs";
@@ -90,20 +120,20 @@ var ABSENT_CODE = "ENOENT";
 function is_absent(error) {
   return error instanceof Error && "code" in error && error.code === ABSENT_CODE;
 }
-function read_optional(path7) {
+function read_optional(path9) {
   try {
-    return readFileSync(path7, "utf8");
+    return readFileSync(path9, "utf8");
   } catch (error) {
     if (is_absent(error)) return void 0;
     throw error;
   }
 }
-function read_file_or_empty(path7) {
-  return read_optional(path7) ?? "";
+function read_file_or_empty(path9) {
+  return read_optional(path9) ?? "";
 }
-function read_if_readable(path7) {
+function read_if_readable(path9) {
   try {
-    return readFileSync(path7, "utf8");
+    return readFileSync(path9, "utf8");
   } catch {
     return void 0;
   }
@@ -131,8 +161,8 @@ function is_real_label(token) {
 function label_references(text) {
   return matches(text, LABEL_PATTERN).map((match) => match[1] ?? "").filter((token) => is_real_label(token));
 }
-function base_name(path7) {
-  return path7.split("/").at(-1) ?? path7;
+function base_name(path9) {
+  return path9.split("/").at(-1) ?? path9;
 }
 function is_placeholder_file(name) {
   return name.includes("<") || PLACEHOLDER_FILES.has(base_name(name).toLowerCase());
@@ -313,7 +343,7 @@ var document_section = {
 };
 
 // scripts/document/bash-output-cap.ts
-var SETTINGS_FILE = path.join(".claude", "settings.json");
+var SETTINGS_FILE = path3.join(".claude", "settings.json");
 var HARNESS_DEFAULT_CAP_CHARS = 3e4;
 var ENV_KEY = "env";
 var CAP_KEY = "BASH_MAX_OUTPUT_LENGTH";
@@ -330,14 +360,14 @@ function declared_cap(text) {
   }
 }
 function bash_output_cap(root) {
-  const text = document_section.read_optional(path.join(root, SETTINGS_FILE)) ?? "";
+  const text = document_section.read_optional(path3.join(root, SETTINGS_FILE)) ?? "";
   const chars = Number(declared_cap(text));
   return Number.isSafeInteger(chars) && chars > NONE ? chars : HARNESS_DEFAULT_CAP_CHARS;
 }
 var bash_output_cap_reader = { HARNESS_DEFAULT_CAP_CHARS, bash_output_cap };
 
 // scripts/document/capped-print-part.ts
-import path2 from "node:path";
+import path4 from "node:path";
 var DIRECTORY_PREFIX = "josh-capped-print-";
 var PART_PREFIX = "part-";
 var PART_SUFFIX = ".md";
@@ -346,8 +376,8 @@ function part_name(index) {
   return `${PART_PREFIX}${String(index + 1)}${PART_SUFFIX}`;
 }
 function is_part_file(absolute) {
-  const parent = path2.basename(path2.dirname(absolute));
-  return parent.startsWith(DIRECTORY_PREFIX) && PART_PATTERN.test(path2.basename(absolute));
+  const parent = path4.basename(path4.dirname(absolute));
+  return parent.startsWith(DIRECTORY_PREFIX) && PART_PATTERN.test(path4.basename(absolute));
 }
 var capped_print_part = { DIRECTORY_PREFIX, part_name, is_part_file };
 
@@ -356,9 +386,9 @@ var FILE_MODE = 384;
 var LINE_BREAK2 = "\n";
 var HEADROOM_CHARS = 512;
 function write_parts(label, text, cap) {
-  const directory = mkdtempSync(path3.join(PLATFORM_TEMP_ROOT, capped_print_part.DIRECTORY_PREFIX));
+  const directory = mkdtempSync(path5.join(PLATFORM_TEMP_ROOT, capped_print_part.DIRECTORY_PREFIX));
   return review_diff_parts.part_texts(label, text, cap).map((part, index) => {
-    const file = path3.join(directory, capped_print_part.part_name(index));
+    const file = path5.join(directory, capped_print_part.part_name(index));
     writeFileSync(file, part, { flag: "wx", mode: FILE_MODE });
     return file;
   });
@@ -385,13 +415,13 @@ function capped_print(text, label, root = process.cwd()) {
 var capped_output = { HEADROOM_CHARS, capped_print };
 
 // scripts/document/entry-read-set.ts
-import { existsSync } from "node:fs";
-import path5 from "node:path";
+import { existsSync as existsSync2 } from "node:fs";
+import path7 from "node:path";
 
 // scripts/init/init-paths.ts
-import path4 from "node:path";
+import path6 from "node:path";
 import { fileURLToPath } from "node:url";
-var PACKAGE_DIR = path4.join(path4.dirname(fileURLToPath(import.meta.url)), "..", "..");
+var PACKAGE_DIR = path6.join(path6.dirname(fileURLToPath(import.meta.url)), "..", "..");
 var PROJECT_ROOT = process.cwd();
 
 // scripts/cost-runtime/cost-tokens.ts
@@ -517,7 +547,7 @@ var read_set_point_of_use = {
 // scripts/document/entry-read-set.ts
 var { POINT_OF_USE_FILES: POINT_OF_USE_FILES2, POINT_OF_USE_BY_ENTRY: POINT_OF_USE_BY_ENTRY2, is_point_of_use: is_point_of_use2, point_of_use_files: point_of_use_files2 } = read_set_point_of_use;
 var { cost_of: cost_of2, scoped_file_cost: scoped_file_cost2, total: total2 } = read_set_cost;
-var SKILL_DIRECTORY = path5.join(".claude", "skills", "workflow-commands");
+var SKILL_DIRECTORY = path7.join(".claude", "skills", "workflow-commands");
 var SKILL_FILE = "SKILL.md";
 var TABLE_SECTION = "1. Which file to read";
 var NOTHING2 = 0;
@@ -529,11 +559,11 @@ var ENTRY_KEYWORD = /`(?<keyword>[a-z]+)/u;
 var SECTION_REFERENCE = /`(?<file>[\w.-]+\.md)` *→ *"(?<heading>[^"]+)"/gu;
 var WHITESPACE_RUN = /\s+/gu;
 function document_path(root, name) {
-  const in_project = path5.join(root, SKILL_DIRECTORY, name);
-  const in_package = path5.join(PACKAGE_DIR, SKILL_DIRECTORY, name);
-  const project_manifest = path5.join(root, "package.json");
-  if (root !== "" && existsSync(project_manifest) && existsSync(in_package)) return in_package;
-  return existsSync(in_project) ? in_project : in_package;
+  const in_project = path7.join(root, SKILL_DIRECTORY, name);
+  const in_package = path7.join(PACKAGE_DIR, SKILL_DIRECTORY, name);
+  const project_manifest = path7.join(root, "package.json");
+  if (root !== "" && existsSync2(project_manifest) && existsSync2(in_package)) return in_package;
+  return existsSync2(in_project) ? in_project : in_package;
 }
 function read_document(root, name) {
   return document_section.read_optional(document_path(root, name)) ?? "";
@@ -721,11 +751,14 @@ var FILE_ARGUMENT = 0;
 var HEADING_ARGUMENT = 1;
 var NO_CANDIDATE = 0;
 var USAGE = 'Usage: josh doc:section <file.md> "<heading>"';
-function resolve_document(name, root = process.cwd()) {
-  const named = path6.resolve(root, name);
-  if (existsSync2(named)) return named;
-  const in_skill = entry_read_set.document_path(root, name);
-  return existsSync2(in_skill) ? in_skill : named;
+var PACKAGE_DIRECTORY = find_package_directory(path8.dirname(fileURLToPath2(import.meta.url)));
+function candidates_under(directory, name) {
+  return [path8.resolve(directory, name), entry_read_set.document_path(directory, name)];
+}
+function resolve_document(name, root = process.cwd(), package_directory = PACKAGE_DIRECTORY) {
+  const named = path8.resolve(root, name);
+  const candidates2 = [...candidates_under(root, name), ...candidates_under(package_directory, name)];
+  return candidates2.find((candidate) => existsSync3(candidate)) ?? named;
 }
 function report_missing(markdown, heading) {
   const near = document_section.candidates(markdown, heading);

package/dist/hooks/batch-guard.js

@@ -9,12 +9,12 @@ import {
   load_environment_file,
   notice_refusal_path,
   refusal_path
-} from "./chunk-YHBZAJSV.js";
-import "./chunk-SHGPANFB.js";
-import "./chunk-J47HU5H5.js";
-import "./chunk-AS74OU3D.js";
-import "./chunk-K4EOONYM.js";
-import "./chunk-E7OIKX5Z.js";
+} from "./chunk-A65Y4YOR.js";
+import "./chunk-JP45SOCJ.js";
+import "./chunk-6TS2JD6D.js";
+import "./chunk-TNUMY6NL.js";
+import "./chunk-LAOV7NLM.js";
+import "./chunk-APUO6U4J.js";
 import "./chunk-DGT54IH5.js";
 export {
   DISABLED_VALUES,

package/dist/hooks/chunk-4KKD2UTK.js

@@ -0,0 +1,66 @@
+// scripts/observations/observation-ledger.ts
+var OBSERVATION_LEDGER_DIRECTORY = ".josh/observations";
+var LEGACY_OBSERVATION_LEDGER_DIRECTORY = "docs/maintainers/observations";
+var LEDGER_DIRECTORIES = [
+  OBSERVATION_LEDGER_DIRECTORY,
+  LEGACY_OBSERVATION_LEDGER_DIRECTORY
+];
+var LEDGER_FILE_EXTENSION = ".md";
+var LEGACY_LEDGER_FILE = `legacy${LEDGER_FILE_EXTENSION}`;
+var LEGACY_OBSERVATION_LEDGER_PATHS = [
+  "docs/maintainers/observations.md",
+  "docs/observations.md"
+];
+var STATUS_PATH_INDEX = 3;
+function status_path(line) {
+  return line.slice(STATUS_PATH_INDEX).trim();
+}
+function ledger_file(name) {
+  return `${OBSERVATION_LEDGER_DIRECTORY}/${String(name)}${LEDGER_FILE_EXTENSION}`;
+}
+function is_ledger_file_name(name) {
+  return name.endsWith(LEDGER_FILE_EXTENSION);
+}
+var MIGRATION_CLAIM_SUFFIX = ".migrating";
+function is_legacy_directory_file(file_path) {
+  return file_path.startsWith(`${LEGACY_OBSERVATION_LEDGER_DIRECTORY}/`);
+}
+function is_migration_claim(file_path) {
+  if (!file_path.endsWith(MIGRATION_CLAIM_SUFFIX)) return false;
+  return is_legacy_directory_file(file_path) || LEGACY_OBSERVATION_LEDGER_PATHS.some((legacy) => file_path.startsWith(`${legacy}.`));
+}
+function is_in_directory(file_path) {
+  return LEDGER_DIRECTORIES.some((directory) => file_path.startsWith(`${directory}/`));
+}
+function is_ledger_path(file_path) {
+  return is_in_directory(file_path) || LEGACY_OBSERVATION_LEDGER_PATHS.includes(file_path) || is_migration_claim(file_path);
+}
+function is_ledger_line(line) {
+  return is_ledger_path(status_path(line));
+}
+function ledger_paths(status_output) {
+  return status_output.split("\n").filter((line) => is_ledger_line(line)).map((line) => status_path(line));
+}
+function has_pending_append(status_output) {
+  return status_output.split("\n").some((line) => is_ledger_line(line));
+}
+var observation_ledger = {
+  has_pending_append,
+  is_ledger_file_name,
+  is_ledger_line,
+  is_ledger_path,
+  is_migration_claim,
+  ledger_file,
+  ledger_paths,
+  status_path
+};
+
+export {
+  OBSERVATION_LEDGER_DIRECTORY,
+  LEGACY_OBSERVATION_LEDGER_DIRECTORY,
+  LEDGER_FILE_EXTENSION,
+  LEGACY_LEDGER_FILE,
+  LEGACY_OBSERVATION_LEDGER_PATHS,
+  MIGRATION_CLAIM_SUFFIX,
+  observation_ledger
+};

package/dist/hooks/{chunk-J47HU5H5.js → chunk-6TS2JD6D.js}

@@ -1,13 +1,13 @@
 import {
   time_density_hook,
   time_hook_transcript
-} from "./chunk-AS74OU3D.js";
+} from "./chunk-TNUMY6NL.js";
 import {
   josh_environment_file
-} from "./chunk-K4EOONYM.js";
+} from "./chunk-LAOV7NLM.js";
 import {
   json_value
-} from "./chunk-E7OIKX5Z.js";
+} from "./chunk-APUO6U4J.js";
 import {
   stamp_file
 } from "./chunk-DGT54IH5.js";

package/dist/hooks/chunk-7DSBJVFH.js

@@ -0,0 +1,50 @@
+import {
+  investigation_reads
+} from "./chunk-PTICX4OL.js";
+import {
+  agent_session_role
+} from "./chunk-UPUZF3AN.js";
+import {
+  lane_guard_policy
+} from "./chunk-JP45SOCJ.js";
+import {
+  hook_decision
+} from "./chunk-6TS2JD6D.js";
+
+// scripts/delegation/investigation-guard.ts
+import { text } from "node:stream/consumers";
+import { fileURLToPath } from "node:url";
+var SWITCH_ENV_KEY = "JOSH_INVESTIGATION_GUARD";
+var STAMP_PREFIX = "josh-investigation-guard-";
+function should_block(tail, call, refused_at_ms, run) {
+  if (agent_session_role.is_reviewer() || lane_guard_policy.mode_here("investigation") !== "refuse") {
+    return false;
+  }
+  return investigation_reads.should_block(tail, call, refused_at_ms, run);
+}
+var GUARD = hook_decision.create_transcript_guard({
+  prefix: STAMP_PREFIX,
+  switch_key: SWITCH_ENV_KEY,
+  is_candidate: investigation_reads.is_refusable_call,
+  should_block,
+  reason: investigation_reads.REASON
+});
+var investigation_refusal = GUARD.refusal;
+var investigation_outcome = GUARD.outcome;
+var { is_enabled, refusal_path } = GUARD;
+var { deny_envelope, load_environment_file, DISABLED_VALUES } = hook_decision;
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+  if (process.stdin.isTTY) hook_decision.report_no_payload("investigation:guard");
+  else hook_decision.write_outcome(await text(process.stdin), investigation_outcome);
+}
+
+export {
+  SWITCH_ENV_KEY,
+  investigation_refusal,
+  investigation_outcome,
+  is_enabled,
+  refusal_path,
+  deny_envelope,
+  load_environment_file,
+  DISABLED_VALUES
+};

package/dist/hooks/{chunk-YHBZAJSV.js → chunk-A65Y4YOR.js}

@@ -1,12 +1,12 @@
 import {
   lane_guard_policy
-} from "./chunk-SHGPANFB.js";
+} from "./chunk-JP45SOCJ.js";
 import {
   hook_decision
-} from "./chunk-J47HU5H5.js";
+} from "./chunk-6TS2JD6D.js";
 import {
   time_batch_guard
-} from "./chunk-AS74OU3D.js";
+} from "./chunk-TNUMY6NL.js";
 
 // scripts/hooks/batch-guard.ts
 import { text } from "node:stream/consumers";

package/dist/hooks/{chunk-E7OIKX5Z.js → chunk-APUO6U4J.js}

@@ -1009,7 +1009,7 @@ var WATCH_VERDICT = "watch";
 var STOP_VERDICT = "stop";
 var TRIAGE_VERDICT = "triage";
 var ANSWERS = ["blocked", "candidates", "exhausted", "parked", "unreadable", "untriaged"];
-var BLOCKED_REASON = "Everything opted in is blocked or already running, so waiting can still change the answer. Poll again at the polling interval.";
+var BLOCKED_REASON = "Everything opted in is blocked or already running, so waiting can still change the answer. Ask again at the re-ask floor (60 s).";
 var TRIAGE_REASON = "An opted-in candidate carries neither `run:solo` nor `run:lane`, so nothing starts until it is judged. Read each issue named above, record its order and one of the two labels with a comment, then ask again.";
 var EMPTY_BACKLOG = "The backlog is empty";
 var WAITING_ON = {
@@ -1030,7 +1030,7 @@ function max_reached_reason(merged, max_issues) {
   return `This run's maximum of ${String(max_issues)} is reached, with ${String(merged)} merged. Report what was done, including how many were picked up during an idle watch, and finish.`;
 }
 function draining_reason(running, reason) {
-  return `Start nothing more and poll until the running children merge (running: ${String(running)}). Then report and finish \u2014 ${reason}`;
+  return `Start nothing more and wait on \`pnpm josh lane:await\` until the running children merge (running: ${String(running)}). Then report and finish \u2014 ${reason}`;
 }
 function idle_expired_reason(answer, idle_budget_ms) {
   return `${waiting_on(answer)}, and stayed so for the whole ${to_minutes(idle_budget_ms)}-minute idle watch. Report what was done, including how many were picked up during the watch, and finish.`;
@@ -1039,7 +1039,7 @@ function idle_watch_reason(answer, left_ms) {
   return `${waiting_on(answer)} and the idle watch has about ${to_minutes(left_ms)} minutes left. Release the working tree, ask again in ${String(OFFER_INTERVAL_SECONDS)} seconds, and restart the watch the moment a candidate appears.`;
 }
 function running_watch_reason(answer, running, left_ms) {
-  return `${waiting_on(answer)} and the idle watch has about ${to_minutes(left_ms)} minutes left, with ${String(running)} still running. Keep the working tree until they merge and poll at the polling interval \u2014 the watch is running down meanwhile.`;
+  return `${waiting_on(answer)} and the idle watch has about ${to_minutes(left_ms)} minutes left, with ${String(running)} still running. Keep the working tree and wait on \`pnpm josh lane:await\` until they merge \u2014 the watch is running down meanwhile.`;
 }
 function watching_reason(input, left_ms) {
   if (input.running === 0) return idle_watch_reason(input.answer, left_ms);
@@ -2340,14 +2340,93 @@ var ports = {
 import { z as z3 } from "zod";
 var process_owner_schema = z3.object({ pid: z3.number(), process_start: z3.string().optional() });
 
+// scripts/git/git-schemas.ts
+import { z as z4 } from "zod";
+var package_name_schema = z4.object({ name: z4.string().min(1) });
+var rollup_item_schema = z4.looseObject({
+  // eslint-disable-next-line @typescript-eslint/naming-convention -- GraphQL field name from GitHub API
+  __typename: z4.string().optional(),
+  state: z4.string().optional(),
+  status: z4.string().optional(),
+  conclusion: z4.string().optional(),
+  name: z4.string().optional(),
+  context: z4.string().optional(),
+  description: z4.string().nullish()
+});
+var pr_raw_schema = z4.object({
+  statusCheckRollup: z4.array(rollup_item_schema).optional(),
+  mergeStateStatus: z4.string().optional(),
+  reviewDecision: z4.string().optional()
+});
+var pull_comment_schema = z4.object({
+  body: z4.string().optional(),
+  html_url: z4.string().optional(),
+  user: z4.object({ login: z4.string().optional() }).optional()
+});
+var ai_review_pull_comment_schema = z4.object({
+  body: z4.string().optional(),
+  url: z4.string().optional(),
+  author: z4.object({ login: z4.string().optional() }).optional()
+});
+var pr_info_schema = z4.object({
+  mergeable: z4.union([z4.boolean(), z4.string()]).nullable().optional(),
+  mergeStateStatus: z4.string().nullable().optional(),
+  state: z4.string().optional()
+});
+var epic_issue_schema = z4.object({
+  number: z4.number(),
+  body: z4.string().optional()
+});
+var blocking_issue_schema = z4.object({
+  number: z4.number(),
+  state: z4.string().optional(),
+  repository_url: z4.string().optional()
+});
+var blocked_by_schema = z4.object({
+  nodes: z4.array(blocking_issue_schema).default([]),
+  totalCount: z4.number().optional()
+}).optional();
+var epic_child_schema = z4.object({
+  state: z4.string().optional(),
+  blockedBy: blocked_by_schema
+});
+var rest_comment_schema = z4.looseObject({
+  body: z4.string().nullish(),
+  html_url: z4.string().optional(),
+  user: z4.looseObject({ login: z4.string().optional() }).nullish()
+});
+var issue_label_schema = z4.object({ name: z4.string() });
+var epic_subject_schema = z4.object({
+  number: z4.number(),
+  state: z4.string().optional(),
+  labels: z4.array(issue_label_schema).optional(),
+  body: z4.string().optional()
+});
+var open_issue_schema = z4.object({
+  number: z4.number(),
+  title: z4.string(),
+  labels: z4.array(issue_label_schema).optional(),
+  createdAt: z4.string(),
+  blockedBy: blocked_by_schema,
+  // Present only on the pickup listing, which reads it for the paths each issue declares.
+  body: z4.string().optional()
+});
+
 export {
   json_value,
+  process_identity,
+  process_owner_schema,
+  issue_number_shape,
+  lane_paths,
   PORT_SEED_KEY,
   LANE_SEAT_KEY,
   ENV_FILE_NAME,
   ports,
-  process_identity,
-  process_owner_schema,
+  pr_raw_schema,
+  blocking_issue_schema,
+  rest_comment_schema,
+  issue_label_schema,
+  open_issue_schema,
   PORCELAIN_FLAG,
   UNTRACKED_FILES_FLAG,
   git_utilities,
@@ -2358,11 +2437,10 @@ export {
   git_location_environment,
   git_spawn_sync,
   git_command,
+  changed_paths,
   cli_flags,
   backlog_budget,
-  issue_number_shape,
   run_invocation,
-  lane_paths,
   file_reader,
   time_instant,
   cost_usage,

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

@@ -1,24 +1,11 @@
+import {
+  ancestor_directories
+} from "./chunk-GP4IEC4O.js";
+
 // scripts/build/local-bin.ts
 import { existsSync, readFileSync } from "node:fs";
 import { createRequire } from "node:module";
-import path2 from "node:path";
-
-// scripts/lib/ancestor-directories.ts
 import path from "node:path";
-var MAX_DEPTH = 64;
-function list(start_directory) {
-  const directories = [];
-  let current = path.resolve(start_directory);
-  while (directories.length < MAX_DEPTH && !directories.includes(current)) {
-    directories.push(current);
-    current = path.dirname(current);
-  }
-  return directories;
-}
-function nearest(start_directory, is_match) {
-  return list(start_directory).find((directory) => is_match(directory));
-}
-var ancestor_directories = { list, nearest };
 
 // scripts/lib/schemas.ts
 import { z } from "zod";
@@ -60,23 +47,23 @@ var WINDOWS_SHIM_SUFFIX = ".cmd";
 var PACKAGE_JSON = "package.json";
 function resolve_local_bin(project_root, bin_name) {
   const shim = process.platform === WINDOWS_PLATFORM ? `${bin_name}${WINDOWS_SHIM_SUFFIX}` : bin_name;
-  return path2.join(project_root, NODE_MODULES, BIN_DIR, shim);
+  return path.join(project_root, NODE_MODULES, BIN_DIR, shim);
 }
 function find_local_bin_upwards(start_directory, bin_name) {
   return ancestor_directories.list(start_directory).map((directory) => resolve_local_bin(directory, bin_name)).find((candidate) => existsSync(candidate));
 }
 function read_bin_entry(manifest_path, package_name, bin_name) {
   const { bin } = package_bin_schema.parse(JSON.parse(readFileSync(manifest_path, "utf8")));
-  if (typeof bin === "string") return bin_name === path2.basename(package_name) ? bin : void 0;
+  if (typeof bin === "string") return bin_name === path.basename(package_name) ? bin : void 0;
   return bin?.[bin_name];
 }
 function resolve_package_bin(base_directory, package_name, bin_name) {
   try {
-    const resolve_from = createRequire(path2.join(base_directory, PACKAGE_JSON));
+    const resolve_from = createRequire(path.join(base_directory, PACKAGE_JSON));
     const manifest_path = resolve_from.resolve(`${package_name}/${PACKAGE_JSON}`);
     const bin_entry = read_bin_entry(manifest_path, package_name, bin_name);
     if (bin_entry === void 0) return void 0;
-    const cli_entry = path2.join(path2.dirname(manifest_path), bin_entry);
+    const cli_entry = path.join(path.dirname(manifest_path), bin_entry);
     return existsSync(cli_entry) ? cli_entry : void 0;
   } catch {
     return void 0;
@@ -84,7 +71,6 @@ function resolve_package_bin(base_directory, package_name, bin_name) {
 }
 
 export {
-  ancestor_directories,
   vscode_settings_schema,
   json_object_schema,
   string_array_schema,

package/dist/hooks/chunk-GP4IEC4O.js

@@ -0,0 +1,20 @@
+// scripts/lib/ancestor-directories.ts
+import path from "node:path";
+var MAX_DEPTH = 64;
+function list(start_directory) {
+  const directories = [];
+  let current = path.resolve(start_directory);
+  while (directories.length < MAX_DEPTH && !directories.includes(current)) {
+    directories.push(current);
+    current = path.dirname(current);
+  }
+  return directories;
+}
+function nearest(start_directory, is_match) {
+  return list(start_directory).find((directory) => is_match(directory));
+}
+var ancestor_directories = { list, nearest };
+
+export {
+  ancestor_directories
+};