@joshuafolkken/kit 1.1010.0 → 1.1035.0

package/dist/hooks/{chunk-EZLHXKJ6.js → chunk-EIFCAJRB.js}

@@ -1,18 +1,19 @@
 import {
   lane_child_marker,
   run_issue_number
-} from "./chunk-GBJUERYK.js";
+} from "./chunk-HOYJU5RM.js";
 import {
   PLATFORM_TEMP_ROOT,
   cost_blocks,
   cost_usage,
+  file_reader,
   json_value,
   lane_paths,
   stamp_file,
   time_density_hook,
   time_shell,
   time_transcript_line
-} from "./chunk-PAXMLGSS.js";
+} from "./chunk-GLBDBJOK.js";
 import {
   ENV_FILE_NAME,
   LANE_SEAT_KEY,
@@ -2038,7 +2039,7 @@ function current_owner(repository_path = process.cwd()) {
 var repo_party = { FIRST_PARTY, THIRD_PARTY, UNKNOWN, classify: classify3, current_owner, target_owner };
 
 // scripts/lane/lane-registry.ts
-import { existsSync as existsSync2, readFileSync as readFileSync4 } from "node:fs";
+import { existsSync as existsSync2 } from "node:fs";
 import path3 from "node:path";
 
 // scripts/git/git-ls-remote.ts
@@ -2528,11 +2529,7 @@ function held_seat(content) {
   return seat_from_content(content) ?? EMPTY_SEAT;
 }
 function read_environment(directory) {
-  try {
-    return readFileSync4(path3.join(directory, ENV_FILE_NAME), "utf8");
-  } catch {
-    return void 0;
-  }
+  return file_reader.read_if_readable(path3.join(directory, ENV_FILE_NAME));
 }
 function branch_issue(branch2) {
   if (!branch2?.endsWith(lane_paths.LANE_BRANCH_SUFFIX)) return void 0;
@@ -2612,7 +2609,6 @@ var lane_registry = {
 
 // scripts/backlog/backlog-budget-cli.ts
 import { fileURLToPath } from "node:url";
-import { parseArgs } from "node:util";
 
 // scripts/git/changed-paths.ts
 function to_paths(raw) {
@@ -2675,6 +2671,24 @@ var path_decision = {
   STAGED_FLAG
 };
 
+// scripts/lib/cli-flags.ts
+import { parseArgs } from "node:util";
+function refuse_unknown_flags(argv, known_flags, command) {
+  const unknown = argv.filter((argument) => !known_flags.includes(argument));
+  if (unknown.length === 0) return void 0;
+  const usage = `Usage: josh ${command} [${known_flags.join("] [")}]`;
+  return `Unknown argument(s): ${unknown.join(" ")}
+${usage}`;
+}
+function parse_or_undefined(config) {
+  try {
+    return parseArgs(config);
+  } catch {
+    return void 0;
+  }
+}
+var cli_flags = { refuse_unknown_flags, parse_or_undefined };
+
 // scripts/backlog/backlog-budget-cli.ts
 var ARGV_OFFSET = 2;
 var SUCCESS_EXIT_CODE = 0;
@@ -2692,11 +2706,7 @@ var OPTIONS = {
   started: { type: "string" }
 };
 function read_arguments(argv) {
-  try {
-    return parseArgs({ args: [...argv], options: OPTIONS, strict: true }).values;
-  } catch {
-    return void 0;
-  }
+  return cli_flags.parse_or_undefined({ args: [...argv], options: OPTIONS, strict: true })?.values;
 }
 function text_of(value) {
   return typeof value === "string" ? value : void 0;
@@ -3461,6 +3471,12 @@ var parse_json = {
   read_json_listing
 };
 
+// scripts/lib/error-message.ts
+function message_of(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+var error_text = { message_of };
+
 // scripts/git/git-gh-exec.ts
 import { execa as execa4, execaSync as execaSync2 } from "execa";
 
@@ -3520,8 +3536,12 @@ function direct_environment() {
   const removed = agent_session_environment.removed_proxy_environment();
   return Object.keys(removed).length > 0 ? { env: removed } : {};
 }
-function to_spawn_options(timeout_ms) {
-  return { ...to_timeout_option(timeout_ms), ...direct_environment() };
+function to_spawn_options(timeout_ms, cwd) {
+  return {
+    ...to_timeout_option(timeout_ms),
+    ...direct_environment(),
+    ...cwd !== void 0 && { cwd }
+  };
 }
 var GH_REQUEST_TIMEOUT_MESSAGE = "gh request timed out";
 function has_stderr_field(error) {
@@ -3533,13 +3553,10 @@ function has_stdout_field(error) {
 function to_timeout_prefix(error) {
   return has_timed_out(error) ? `${GH_REQUEST_TIMEOUT_MESSAGE}: ` : "";
 }
-function to_error_message(error) {
-  return error instanceof Error ? error.message : String(error);
-}
 function to_gh_error(error) {
   const stderr = has_stderr_field(error) ? error.stderr.trim() : "";
   const stdout = has_stdout_field(error) ? error.stdout.trim() : "";
-  const summary = stderr.length > 0 ? stderr : to_error_message(error);
+  const summary = stderr.length > 0 ? stderr : error_text.message_of(error);
   const detail = stdout.length > 0 ? `${summary}
 ${stdout}` : summary;
   return gh_failure.attach(
@@ -3547,10 +3564,11 @@ ${stdout}` : summary;
     gh_failure.classify_stdout(stdout)
   );
 }
-async function exec_gh_command(arguments_, timeout_ms) {
+async function exec_gh_command(arguments_, timeout_ms, cwd) {
   await check_gh_installed();
+  const options = to_spawn_options(timeout_ms, cwd);
   try {
-    const { stdout } = await execa4("gh", arguments_, to_spawn_options(timeout_ms));
+    const { stdout } = await execa4("gh", arguments_, options);
     return stdout.trimEnd();
   } catch (error) {
     throw to_gh_error(error);
@@ -3558,7 +3576,7 @@ async function exec_gh_command(arguments_, timeout_ms) {
 }
 async function exec_gh_command_with_stdin(input) {
   await check_gh_installed();
-  const options = { input: input.stdin_body, ...to_spawn_options(input.timeout_ms) };
+  const options = { input: input.stdin_body, ...to_spawn_options(input.timeout_ms, input.cwd) };
   try {
     const { stdout } = await execa4("gh", input.args, options);
     return stdout.trimEnd();
@@ -3571,6 +3589,9 @@ function parse_status_line(output) {
   const { status: status2 } = STATUS_LINE_PATTERN.exec(output)?.groups ?? {};
   return status2 === void 0 ? void 0 : Number(status2);
 }
+function status_of_failure(error) {
+  return has_stdout_field(error) ? parse_status_line(error.stdout) : void 0;
+}
 async function exec_gh_api_status(path4, timeout_ms) {
   const options = to_spawn_options(timeout_ms);
   try {
@@ -3578,7 +3599,16 @@ async function exec_gh_api_status(path4, timeout_ms) {
     const { stdout } = await execa4("gh", ["api", "--include", "--silent", path4], options);
     return parse_status_line(stdout);
   } catch (error) {
-    return has_stdout_field(error) ? parse_status_line(error.stdout) : void 0;
+    return status_of_failure(error);
+  }
+}
+function exec_gh_api_status_sync(path4, timeout_ms) {
+  const options = to_spawn_options(timeout_ms);
+  try {
+    const { stdout } = execaSync2("gh", ["api", "--include", "--silent", path4], options);
+    return parse_status_line(stdout);
+  } catch (error) {
+    return status_of_failure(error);
   }
 }
 var METHOD_FLAG = "--method";
@@ -3605,16 +3635,19 @@ function to_gh_api_args(request) {
 }
 async function exec_gh_api(request) {
   const args = to_gh_api_args(request);
-  if (request.body === void 0) return await exec_gh_command(args, request.timeout_ms);
+  if (request.body === void 0) {
+    return await exec_gh_command(args, request.timeout_ms, request.cwd);
+  }
   return await exec_gh_command_with_stdin({
     args,
     stdin_body: request.body,
-    timeout_ms: request.timeout_ms
+    timeout_ms: request.timeout_ms,
+    cwd: request.cwd
   });
 }
 function exec_gh_api_sync(request) {
   const body_option = request.body === void 0 ? {} : { input: request.body };
-  const options = { ...body_option, ...to_spawn_options(request.timeout_ms) };
+  const options = { ...body_option, ...to_spawn_options(request.timeout_ms, request.cwd) };
   try {
     const { stdout } = execaSync2("gh", to_gh_api_args(request), options);
     return stdout.trimEnd();
@@ -3622,13 +3655,22 @@ function exec_gh_api_sync(request) {
     throw to_gh_error(error);
   }
 }
+function read_gh_api_sync(request) {
+  try {
+    return exec_gh_api_sync(request);
+  } catch {
+    return void 0;
+  }
+}
 var git_gh_exec = {
   direct_environment,
   exec_gh_command,
   exec_gh_command_with_stdin,
   exec_gh_api,
   exec_gh_api_sync,
+  read_gh_api_sync,
   exec_gh_api_status,
+  exec_gh_api_status_sync,
   parse_status_line
 };
 
@@ -3666,6 +3708,7 @@ export {
   repo_party,
   FULL_PAGE_QUERY,
   git_gh_api_path,
+  error_text,
   parse_json_array_or_undefined,
   read_json_listing,
   parse_json_object_safe,

package/dist/hooks/{chunk-KPZN42RT.js → chunk-GJT4BNVE.js}

@@ -1,12 +1,12 @@
 import {
   investigation_reads
-} from "./chunk-WMIR5SNX.js";
+} from "./chunk-D67KVGGY.js";
 import {
   lane_guard_policy
-} from "./chunk-56LGMJJV.js";
+} from "./chunk-ZXNE6NY3.js";
 import {
   hook_decision
-} from "./chunk-GBJUERYK.js";
+} from "./chunk-HOYJU5RM.js";
 
 // scripts/delegation/investigation-guard.ts
 import { text } from "node:stream/consumers";

package/dist/hooks/{chunk-PAXMLGSS.js → chunk-GLBDBJOK.js}

@@ -156,7 +156,7 @@ var BACKLOG_COMMANDS = {
     script: "scripts/backlog/backlog-offer-cli.ts",
     description: "Collapse a backlogrun loop-head event into one call: read backlog:next, ask backlog:budget, return the verdict and any issues to start",
     category: "AI tools",
-    reference: ["[options]", "automation", ["network"]]
+    reference: ["[options]", "automation", ["files", "network", "processes"]]
   },
   "backlog:drive": {
     script: "scripts/backlog/backlog-drive-cli.ts",
@@ -393,7 +393,7 @@ var AI_COMMANDS = {
     reference: ["<message>", "automation", ["git"]]
   },
   epic: {
-    script: "scripts-ai/epic.ts",
+    script: "scripts/epic/epic.ts",
     description: "Create an epic issue from its child issue numbers",
     category: "AI tools",
     reference: ["<title> <issue...> [--ordered]", "automation", ["network"]]
@@ -417,7 +417,7 @@ var AI_COMMANDS = {
     reference: ["<epic>", "automation", ["network"]]
   },
   "epic:check": {
-    script: "scripts-ai/epic-check.ts",
+    script: "scripts/epic/epic-check.ts",
     description: "Check an epic issue against the tracking requirements",
     category: "AI tools",
     reference: ["<epic>", "automation", ["network"]]
@@ -744,7 +744,7 @@ var DEV_COMMANDS = {
     script: "scripts/rules/rule-value-cli.ts",
     description: "Print each delivered rule's unaided compliance \u2014 runs reached, kept rate, refusals",
     category: "AI tools",
-    reference: ["", "developer", ["none"]]
+    reference: ["[--refresh]", "developer", ["files"]]
   },
   format: {
     script: "scripts/lint/format.ts",
@@ -1137,7 +1137,7 @@ var VERSIONING_COMMANDS = {
 };
 
 // scripts/josh/josh-commands-workflow.ts
-var GIT_WORKFLOW_SCRIPT = "scripts-ai/git-workflow.ts";
+var GIT_WORKFLOW_SCRIPT = "scripts/git/git-workflow.ts";
 var GIT_MESSAGE_ARGUMENTS = "[-y] <message>";
 var WORKFLOW_COMMANDS = {
   git: {
@@ -1162,7 +1162,7 @@ var WORKFLOW_COMMANDS = {
   // session, and `followup` with them the merge step of every `fullrun` there. `doctor` was moved to
   // this form for the same reason in joshuafolkken/kit#869.
   //
-  // Nothing is lost by relaxing it: both scripts already call `load_optional_environment()`
+  // Nothing is lost by relaxing it: both scripts already load `.env` through `josh_environment_file`
   // themselves, so the file is read either way and node's precedence — an existing environment
   // variable wins over the file — is node's own in both spellings.
   //
@@ -1170,7 +1170,7 @@ var WORKFLOW_COMMANDS = {
   // than dropped: `telegram_notify.send` now throws on missing credentials and on a failed send, so
   // `josh notify` exits non-zero instead of warning and answering 0.
   followup: {
-    script: "scripts-ai/git-followup-workflow.ts",
+    script: "scripts/git/git-followup-workflow.ts",
     description: "Follow-up git workflow",
     category: "Workflow",
     reference: [
@@ -1181,7 +1181,7 @@ var WORKFLOW_COMMANDS = {
     tsx_arguments: OPTIONAL_ENV_FILE_FLAGS
   },
   notify: {
-    script: "scripts-ai/telegram-test.ts",
+    script: "scripts/git/telegram-test.ts",
     description: "Send Telegram notification",
     category: "Workflow",
     reference: ["--task-type <type> --body <text>", "automation", ["notifications"]],
@@ -2726,7 +2726,7 @@ var time_spans = {
 import path3 from "node:path";
 
 // scripts/cost-runtime/cost-transcript.ts
-import { readdirSync, readFileSync, statSync } from "node:fs";
+import { readdirSync, readFileSync as readFileSync2, statSync } from "node:fs";
 import { homedir } from "node:os";
 import path2 from "node:path";
 
@@ -2772,6 +2772,32 @@ var lane_paths = {
   lane_root
 };
 
+// scripts/lib/read-file.ts
+import { readFileSync } from "node:fs";
+var ABSENT_CODE = "ENOENT";
+function is_absent(error) {
+  return error instanceof Error && "code" in error && error.code === ABSENT_CODE;
+}
+function read_optional(path6) {
+  try {
+    return readFileSync(path6, "utf8");
+  } catch (error) {
+    if (is_absent(error)) return void 0;
+    throw error;
+  }
+}
+function read_file_or_empty(path6) {
+  return read_optional(path6) ?? "";
+}
+function read_if_readable(path6) {
+  try {
+    return readFileSync(path6, "utf8");
+  } catch {
+    return void 0;
+  }
+}
+var file_reader = { read_optional, read_file_or_empty, read_if_readable };
+
 // scripts/cost-runtime/cost-usage.ts
 import { z as z4 } from "zod";
 var CACHE_CREATION_SCHEMA = z4.object({
@@ -2927,7 +2953,7 @@ var WORKTREE_SEGMENT = `/${GIT_ENTRY}/worktrees/`;
 var NOT_FOUND = -1;
 function linked_worktree_gitdir(cwd) {
   try {
-    const contents = readFileSync(path2.join(cwd, GIT_ENTRY), "utf8").trim();
+    const contents = readFileSync2(path2.join(cwd, GIT_ENTRY), "utf8").trim();
     return contents.startsWith(GITDIR_PREFIX) ? contents.slice(GITDIR_PREFIX.length).trim() : "";
   } catch {
     return "";
@@ -3064,23 +3090,16 @@ function tally(content) {
     baseline_tokens: first === void 0 ? 0 : cost_usage.billed_input(first.totals)
   };
 }
-function read_text(file_path) {
-  try {
-    return readFileSync(file_path, "utf8");
-  } catch {
-    return void 0;
-  }
-}
 function read_session(file) {
-  const content = read_text(file.path);
+  const content = file_reader.read_if_readable(file.path);
   if (content === void 0) return { session_id: file.session_id, ...empty_session() };
   return { session_id: file.session_id, ...tally(content) };
 }
 function read_raw(file) {
-  return read_text(file.path) ?? "";
+  return file_reader.read_if_readable(file.path) ?? "";
 }
-function read_optional(file) {
-  return read_text(file.path);
+function read_optional2(file) {
+  return file_reader.read_if_readable(file.path);
 }
 function directory_exists(directory) {
   try {
@@ -3126,7 +3145,7 @@ var cost_transcript = {
   tally,
   read_session,
   read_raw,
-  read_optional,
+  read_optional: read_optional2,
   missing_message,
   home_directory
 };
@@ -3159,7 +3178,7 @@ import { closeSync, fstatSync, openSync, readSync } from "node:fs";
 
 // scripts/josh/stamp-file.ts
 import { createHash, randomUUID } from "node:crypto";
-import { lstatSync, readFileSync as readFileSync2, renameSync, rmSync, writeFileSync } from "node:fs";
+import { lstatSync, readFileSync as readFileSync3, renameSync, rmSync, writeFileSync } from "node:fs";
 import path5 from "node:path";
 
 // scripts/init/init-paths.ts
@@ -3258,7 +3277,7 @@ function is_own_regular_file(source) {
 function read_stamp_text(source) {
   try {
     if (!is_own_regular_file(source)) return void 0;
-    return readFileSync2(source, "utf8");
+    return readFileSync3(source, "utf8");
   } catch {
     return void 0;
   }
@@ -3528,6 +3547,7 @@ export {
   time_spans,
   time_round_trips,
   lane_paths,
+  file_reader,
   cost_usage,
   cost_transcript,
   time_hook_transcript,

package/dist/hooks/{chunk-GBJUERYK.js → chunk-HOYJU5RM.js}

@@ -3,7 +3,7 @@ import {
   stamp_file,
   time_density_hook,
   time_hook_transcript
-} from "./chunk-PAXMLGSS.js";
+} from "./chunk-GLBDBJOK.js";
 import {
   josh_environment_file
 } from "./chunk-WPALEIRX.js";