@joshuafolkken/kit 1.1050.0 → 1.1128.0

package/dist/josh.js

@@ -4,6 +4,87 @@
 import { existsSync } from "node:fs";
 import path from "node:path";
 
+// scripts/lib/spawn-exit.ts
+var SPAWN_ERROR_EXIT_CODE = 2;
+var SIGNAL_KILL_EXIT_CODE = 1;
+function resolve_spawn_exit(executable, result) {
+  if (result.exitCode !== void 0) return result.exitCode;
+  if (result.isTerminated === true) return SIGNAL_KILL_EXIT_CODE;
+  console.error(`Failed to execute ${executable}: ${result.shortMessage ?? "spawn failed"}`);
+  return SPAWN_ERROR_EXIT_CODE;
+}
+function read_spawn_stdout(result) {
+  return result.stdout ?? "";
+}
+function read_spawn_stderr(result) {
+  return result.stderr ?? "";
+}
+
+// scripts/git/git-spawn-sync.ts
+import { execaSync } from "execa";
+
+// scripts/git/constants.ts
+import { platform } from "node:os";
+var GIT_COMMAND_UNIX = "/usr/bin/git";
+function get_git_command() {
+  if (platform() === "win32") {
+    return String.raw`"C:\Program Files\Git\cmd\git.exe"`;
+  }
+  return GIT_COMMAND_UNIX;
+}
+function get_git_command_for_spawn() {
+  if (platform() === "win32") {
+    return String.raw`C:\Program Files\Git\cmd\git.exe`;
+  }
+  return GIT_COMMAND_UNIX;
+}
+var git_utilities = {
+  get_git_command,
+  get_git_command_for_spawn
+};
+
+// scripts/git/git-spawn-sync.ts
+var GIT_TIMEOUT_MS = 1e4;
+var SUCCESS_EXIT_CODE = 0;
+var C_LOCALE = { LC_ALL: "C", LANGUAGE: "C" };
+function run(args, options = {}) {
+  const result = execaSync(git_utilities.get_git_command_for_spawn(), args, {
+    ...options,
+    extendEnv: true,
+    reject: false,
+    timeout: options.timeout ?? GIT_TIMEOUT_MS
+  });
+  return {
+    exit_code: result.exitCode,
+    stdout: read_spawn_stdout(result),
+    stderr: read_spawn_stderr(result)
+  };
+}
+function read(args, options = {}) {
+  const result = run(args, options);
+  return result.exit_code === SUCCESS_EXIT_CODE ? result.stdout.trim() : void 0;
+}
+function origin_url(cwd) {
+  return read(["config", "--get", "remote.origin.url"], { cwd });
+}
+function toplevel(timeout = GIT_TIMEOUT_MS) {
+  return run(["rev-parse", "--show-toplevel"], { env: C_LOCALE, timeout });
+}
+var git_spawn_sync = { GIT_TIMEOUT_MS, C_LOCALE, run, read, origin_url, toplevel };
+
+// scripts/lib/json-value.ts
+function parse_or_undefined(text) {
+  try {
+    return JSON.parse(text);
+  } catch {
+    return void 0;
+  }
+}
+function is_record(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+var json_value = { parse_or_undefined, is_record };
+
 // scripts/lib/read-file.ts
 import { readFileSync } from "node:fs";
 var ABSENT_CODE = "ENOENT";
@@ -30,33 +111,10 @@ function read_if_readable(path5) {
 }
 var file_reader = { read_optional, read_file_or_empty, read_if_readable };
 
-// scripts/lib/spawn-exit.ts
-var SPAWN_ERROR_EXIT_CODE = 2;
-var SIGNAL_KILL_EXIT_CODE = 1;
-function resolve_spawn_exit(executable, result) {
-  if (result.exitCode !== void 0) return result.exitCode;
-  if (result.isTerminated === true) return SIGNAL_KILL_EXIT_CODE;
-  console.error(`Failed to execute ${executable}: ${result.shortMessage ?? "spawn failed"}`);
-  return SPAWN_ERROR_EXIT_CODE;
-}
-function read_spawn_stdout(result) {
-  return result.stdout ?? "";
-}
-
 // scripts/version/kit-descriptor.ts
 var KIT_PACKAGE_NAME = "@joshuafolkken/kit";
 
-// scripts/version/parse-json.ts
-function safe_json_parse(raw) {
-  try {
-    return JSON.parse(raw);
-  } catch {
-    return void 0;
-  }
-}
-
 // scripts/doctor/doctor-consumer.ts
-import { execaSync } from "execa";
 import { z } from "zod";
 var NODE_MODULES = "node_modules";
 var SETTINGS_PATH = path.join(".claude", "settings.json");
@@ -64,7 +122,7 @@ var CLAUDE_MD = "CLAUDE.md";
 var PLUGIN_ID = "kit@kit";
 var CLAUDE_MD_POINTER = `@${NODE_MODULES}/${KIT_PACKAGE_NAME}/dist/${CLAUDE_MD}`;
 var SECRETLINT_BIN = path.join(NODE_MODULES, ".bin", "secretlint");
-var GIT_TIMEOUT_MS = 2e3;
+var GIT_TIMEOUT_MS2 = 2e3;
 var manifest_schema = z.object({
   name: z.string().optional(),
   dependencies: z.record(z.string(), z.string()).optional(),
@@ -79,7 +137,7 @@ var STATE_MISSING = "missing";
 function parse_manifest(root) {
   const content = file_reader.read_if_readable(path.join(root, "package.json"));
   if (content === void 0) return void 0;
-  const parsed = manifest_schema.safeParse(safe_json_parse(content));
+  const parsed = manifest_schema.safeParse(json_value.parse_or_undefined(content));
   return parsed.success ? parsed.data : void 0;
 }
 function lists_kit_dependency(manifest) {
@@ -94,15 +152,13 @@ function is_kit_consumer(root) {
 function is_plugin_declared(root) {
   const content = file_reader.read_if_readable(path.join(root, SETTINGS_PATH));
   if (content === void 0) return false;
-  const parsed = settings_schema.safeParse(safe_json_parse(content));
+  const parsed = settings_schema.safeParse(json_value.parse_or_undefined(content));
   return parsed.success && parsed.data.enabledPlugins?.[PLUGIN_ID] === true;
 }
 function configured_hooks_path(root) {
-  const result = execaSync("git", ["-C", root, "config", "--get", "core.hooksPath"], {
-    reject: false,
-    timeout: GIT_TIMEOUT_MS
+  const value = git_spawn_sync.read(["-C", root, "config", "--get", "core.hooksPath"], {
+    timeout: GIT_TIMEOUT_MS2
   });
-  const value = read_spawn_stdout(result).trim();
   return value === "" ? void 0 : value;
 }
 function claude_md_state(root) {
@@ -120,7 +176,7 @@ function status_line(is_ok, ok_text, warn_text) {
 function plugin_line(is_declared) {
   return status_line(
     is_declared,
-    `kit plugin declared (run \`claude plugin install ${PLUGIN_ID}\` once if skills are missing)`,
+    "kit plugin declared (skills load in a trusted workspace; headless from its second session)",
     "kit plugin not declared in .claude/settings.json \u2014 run `pnpm josh sync`"
   );
 }
@@ -163,7 +219,6 @@ var doctor_consumer = {
   claude_md_line,
   claude_md_state,
   configured_hooks_path,
-  consumer_setup_lines,
   hooks_path_line,
   is_kit_consumer,
   is_plugin_declared,
@@ -244,7 +299,7 @@ function resolve_package_bin(base_directory, package_name, bin_name) {
 }
 
 // scripts/josh/josh-logic.ts
-import { execaSync as execaSync3 } from "execa";
+import { execaSync as execaSync2 } from "execa";
 
 // scripts/josh/command-suggest.ts
 var MAX_SUGGESTION_DISTANCE = 3;
@@ -344,7 +399,11 @@ var BACKLOG_COMMANDS = {
     script: "scripts/backlog/backlog-plan-cli.ts",
     description: "Print the whole backlog as a plan: ready now, waiting on what, waiting on a person, out of scope",
     category: "AI tools",
-    reference: ["[issue...] [--only]", "automation", ["network"]]
+    reference: [
+      "[issue...] [--only] [--waves] [--exclude <n>[,<n>...]]",
+      "automation",
+      ["network"]
+    ]
   },
   "backlog:stalled": {
     script: "scripts/backlog/backlog-stalled-cli.ts",
@@ -435,7 +494,7 @@ var ISSUE_COMMANDS = {
     script: "scripts/issue/issue-scout-cli.ts",
     description: "Before filing: say whether an issue like this exists and which epic it belongs to",
     category: "AI tools",
-    reference: ["<title> [--body <summary>]", "automation", ["network"]]
+    reference: ["<title> [--body <summary> | --body-file <path>]", "automation", ["network"]]
   },
   "defect:rate": {
     script: "scripts/issue/defect-rate-cli.ts",
@@ -453,7 +512,7 @@ var ISSUE_COMMANDS = {
     script: "scripts/issue/issue-fold-existing-cli.ts",
     description: "Assess whether a complete draft can join an unstarted issue",
     category: "AI tools",
-    reference: ["<assessment.json>", "automation", ["none"]]
+    reference: ["<assessment.json> [--json]", "automation", ["none"]]
   },
   "issue:cite": {
     script: "scripts/issue/issue-cite-cli.ts",
@@ -541,6 +600,107 @@ var LANE_COMMANDS = {
   }
 };
 
+// scripts/josh/josh-commands-run.ts
+var RUN_HOLD_SCRIPT = "scripts/run/run-hold-cli.ts";
+var RUN_COMMANDS = {
+  "run:hold": {
+    script: RUN_HOLD_SCRIPT,
+    description: "Claim this working tree for a run, or say which run already holds it",
+    category: "AI tools",
+    reference: ["[<issue> [--fullrun | --halfrun-stop | --prrun-stop]]", "automation", ["files"]]
+  },
+  "run:release": {
+    script: RUN_HOLD_SCRIPT,
+    description: "Release this working tree's run record",
+    category: "AI tools",
+    reference: ["[issue|--force]", "automation", ["files"]],
+    default_script_arguments: ["--release"]
+  },
+  "run:tidy": {
+    script: "scripts/run/run-tidy-cli.ts",
+    description: "Close merged lanes and drop stashes whose issues are all merged",
+    category: "AI tools",
+    reference: ["", "automation", ["git", "network", "files"]]
+  },
+  "run:carry": {
+    script: "scripts/run/run-carry-cli.ts",
+    description: "Carry one invocation\u2019s budget across its own session cuts",
+    category: "AI tools",
+    reference: ["<operation> [arguments...]", "automation", ["files"]]
+  },
+  "run:wake": {
+    script: "scripts/run/run-wake-cli.ts",
+    // `.env` rather than the ambient environment:
+    // the failure warning needs the Telegram credentials, the same
+    // reasons `notify` and `followup` carry these flags.
+    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
+    description: "Wake the next session of a cut backlogrun from outside the conversation",
+    category: "AI tools",
+    reference: ["[options]", "automation", ["processes", "notifications"]]
+  },
+  "run:cut": {
+    script: "scripts/run/run-cut-cli.ts",
+    description: "Cut a lane child before the gate and resume a fresh process",
+    category: "AI tools",
+    reference: ["[--resume] <issue> [--impl] [--handoff <path>]", "automation", ["files"]]
+  },
+  "run:liveness": {
+    script: "scripts/run/run-liveness-cli.ts",
+    description: "Say whether a delegated unit is still working, or stopped without reporting",
+    category: "AI tools",
+    reference: ["<issue> --output <path> [options]", "automation", ["processes"]]
+  },
+  "run:ending": {
+    script: "scripts/run/run-ending-cli.ts",
+    description: "Classify how a dispatched lane child ended (merged, cut, abandoned, unreadable)",
+    category: "AI tools",
+    reference: ["<issue> --output <path> [--repo <owner/repo>]", "automation", ["network"]]
+  },
+  "run:progress": {
+    script: "scripts/run/run-progress-cli.ts",
+    description: "Report an unattended run\u2019s progress once it has gone quiet for an interval",
+    category: "AI tools",
+    reference: [
+      "[--once | --wait] [--interval <minutes>] [--hours <hours>] [--repo <owner/repo>] [--output <path>] | --mark | --path",
+      "automation",
+      ["files"]
+    ]
+  },
+  "run:prep": {
+    script: "scripts/run/run-prep-cli.ts",
+    description: "Bundle a run\u2019s pre-edit reads: body, comments, state, dependency scope",
+    category: "AI tools",
+    reference: ["<issue>", "automation", ["network"]]
+  },
+  // The entry sequence a lane opened on, folded into one call (joshuafolkken/kit#2372): claim the tree,
+  // read the budget, gather the issue reads and decide the pre-implementation step. `run:hold`,
+  // `cost --cut`, `run:prep` and `run:step` were four round trips re-billing a lane's full context each.
+  "run:entry": {
+    script: "scripts/run/run-entry-cli.ts",
+    description: "Open a run in one call: claim the tree, read the budget, bundle the reads, decide the pre-implementation step",
+    category: "AI tools",
+    reference: ["<issue> [--to <command>]", "automation", ["git", "network", "files"]]
+  },
+  "run:status": {
+    script: "scripts/run/run-status-cli.ts",
+    description: "Bundle a run\u2019s read-only status: issue state, cost verdict, carry counters",
+    category: "AI tools",
+    reference: ["<issue> [--repo <owner/repo>]", "automation", ["network"]]
+  },
+  "run:next": {
+    script: "scripts/run/run-next-cli.ts",
+    description: "Print the next step a fullrun takes, computed from the run\u2019s state",
+    category: "AI tools",
+    reference: ["<issue>", "automation", ["network"]]
+  },
+  "run:step": {
+    script: "scripts/run/run-step-cli.ts",
+    description: "Print the run\u2019s next single action, computed from the event stream, carry record and issue state",
+    category: "AI tools",
+    reference: ["<issue>", "automation", ["network", "files"]]
+  }
+};
+
 // scripts/josh/josh-commands-split.ts
 var SPLIT_COMMANDS = {
   "split:assess": {
@@ -552,7 +712,6 @@ var SPLIT_COMMANDS = {
 };
 
 // scripts/josh/josh-commands-ai.ts
-var RUN_HOLD_SCRIPT = "scripts/run/run-hold-cli.ts";
 var ISSUE_WITH_OPTIONS2 = "<issue> [options]";
 var AI_COMMANDS = {
   ...ISSUE_COMMANDS,
@@ -563,7 +722,7 @@ var AI_COMMANDS = {
     reference: ["<keywords> [--size <n>]", "automation", ["network"]]
   },
   "stash:pop": {
-    script: "scripts/git/stash-pop-cli.ts",
+    script: "scripts/git/stash/stash-pop-cli.ts",
     description: "Pop the stash matching this message, not whichever a shared stack has on top",
     category: "AI tools",
     reference: ["<message>", "automation", ["git"]]
@@ -578,7 +737,7 @@ var AI_COMMANDS = {
     script: "scripts/epic/epic-next.ts",
     description: "List an epic's runnable children, bundled per repository",
     category: "AI tools",
-    reference: ["<epic>", "automation", ["network"]]
+    reference: ["<epic>... [--repo <owner/repo>] [--lanes]", "automation", ["network"]]
   },
   "epic:bundle": {
     script: "scripts/epic/epic-bundle-cli.ts",
@@ -607,9 +766,9 @@ var AI_COMMANDS = {
   ...BACKLOG_COMMANDS,
   cost: {
     script: "scripts/cost-runtime/cost-cli.ts",
-    description: "Report a run's token and credit cost from Claude Code's session transcripts",
+    description: "Say whether the next turn of a run crosses the context-cut threshold (--cut) or a given tokens-per-request figure (--over)",
     category: "AI tools",
-    reference: ["[--cut|--over]", "automation", ["none"]]
+    reference: ["(--cut | --over <tokens-per-request>) [--path <dir>]", "automation", ["none"]]
   },
   ...DOCUMENT_COMMANDS,
   time: {
@@ -673,98 +832,7 @@ var AI_COMMANDS = {
     category: "AI tools",
     reference: ["<unit-files> <unit-files> [<unit-files> \u2026]", "automation", ["none"]]
   },
-  "run:hold": {
-    script: RUN_HOLD_SCRIPT,
-    description: "Claim this working tree for a run, or say which run already holds it",
-    category: "AI tools",
-    reference: ["[issue]", "automation", ["files"]]
-  },
-  "run:release": {
-    script: RUN_HOLD_SCRIPT,
-    description: "Release this working tree's run record",
-    category: "AI tools",
-    reference: ["[issue|--force]", "automation", ["files"]],
-    default_script_arguments: ["--release"]
-  },
-  "run:tidy": {
-    script: "scripts/run/run-tidy-cli.ts",
-    description: "Close merged lanes and drop stashes whose issues are all merged",
-    category: "AI tools",
-    reference: ["", "automation", ["git", "network", "files"]]
-  },
-  "run:carry": {
-    script: "scripts/run/run-carry-cli.ts",
-    description: "Carry one invocation\u2019s budget across its own session cuts",
-    category: "AI tools",
-    reference: ["<operation> [arguments...]", "automation", ["files"]]
-  },
-  "run:wake": {
-    script: "scripts/run/run-wake-cli.ts",
-    // `.env` rather than the ambient environment:
-    // the failure warning needs the Telegram credentials, the same
-    // reasons `notify` and `followup` carry these flags.
-    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    description: "Wake the next session of a cut backlogrun from outside the conversation",
-    category: "AI tools",
-    reference: ["[options]", "automation", ["processes", "notifications"]]
-  },
-  "run:cut": {
-    script: "scripts/run/run-cut-cli.ts",
-    description: "Cut a lane child before the gate and resume a fresh process",
-    category: "AI tools",
-    reference: ["[--resume] <issue> [--impl] [--handoff <path>]", "automation", ["files"]]
-  },
-  "run:liveness": {
-    script: "scripts/run/run-liveness-cli.ts",
-    description: "Say whether a delegated unit is still working, or stopped without reporting",
-    category: "AI tools",
-    reference: ["<issue> --output <path> [options]", "automation", ["processes"]]
-  },
-  "run:ending": {
-    script: "scripts/run/run-ending-cli.ts",
-    description: "Classify how a dispatched lane child ended (merged, cut, abandoned, unreadable)",
-    category: "AI tools",
-    reference: ["<issue> --output <path> [--repo <owner/repo>]", "automation", ["network"]]
-  },
-  "run:progress": {
-    script: "scripts/run/run-progress-cli.ts",
-    description: "Report an unattended run\u2019s progress once it has gone quiet for an interval",
-    category: "AI tools",
-    reference: ["[--wait|--mark]", "automation", ["files"]]
-  },
-  "run:prep": {
-    script: "scripts/run/run-prep-cli.ts",
-    description: "Bundle a run\u2019s pre-edit reads: body, comments, state, dependency scope",
-    category: "AI tools",
-    reference: ["<issue>", "automation", ["network"]]
-  },
-  // The entry sequence a lane opened on, folded into one call (joshuafolkken/kit#2372): claim the tree,
-  // read the budget, gather the issue reads and decide the pre-implementation step. `run:hold`,
-  // `cost --cut`, `run:prep` and `run:step` were four round trips re-billing a lane's full context each.
-  "run:entry": {
-    script: "scripts/run/run-entry-cli.ts",
-    description: "Open a run in one call: claim the tree, read the budget, bundle the reads, decide the pre-implementation step",
-    category: "AI tools",
-    reference: ["<issue>", "automation", ["git", "network", "files"]]
-  },
-  "run:status": {
-    script: "scripts/run/run-status-cli.ts",
-    description: "Bundle a run\u2019s read-only status: issue state, cost verdict, carry counters",
-    category: "AI tools",
-    reference: ["<issue> [--repo <owner/repo>]", "automation", ["network"]]
-  },
-  "run:next": {
-    script: "scripts/run/run-next-cli.ts",
-    description: "Print the next step a fullrun takes, computed from the run\u2019s state",
-    category: "AI tools",
-    reference: ["<issue>", "automation", ["network"]]
-  },
-  "run:step": {
-    script: "scripts/run/run-step-cli.ts",
-    description: "Print the run\u2019s next single action, computed from the event stream, carry record and issue state",
-    category: "AI tools",
-    reference: ["<issue>", "automation", ["network", "files"]]
-  },
+  ...RUN_COMMANDS,
   "repo:party": {
     script: "scripts/discovery/repo-party-cli.ts",
     description: "Say whether a repository is first-party or third-party by owner equality (computed, not judged)",
@@ -788,7 +856,7 @@ var AI_COMMANDS = {
   // `issue:cite` and `release:scope` were three round trips re-billing the run's full context each.
   "run:tail": {
     script: "scripts/run/run-tail-cli.ts",
-    description: "Close a run in one call: commit the observation ledger, read the citations, decide the release scope",
+    description: "Close a run in one call: return to the default branch, commit the observation ledger, read the citations, decide the release scope",
     category: "AI tools",
     reference: ["[<issue> ...]", "automation", ["git", "network"]]
   },
@@ -801,7 +869,7 @@ var AI_COMMANDS = {
     description: "Ship a change in one call: gate, commit/push/PR, the CI-wait merge and the report bookkeeping, stopping at the first failed step",
     category: "AI tools",
     reference: [
-      '"<title> #<N>" [<follow-up-N> ...] [--cite <N>] [--review] [--detach] [--notify-message <text> | --notify-message-file <path>] | --log <N>',
+      '"<title> #<N>" [<follow-up-N> ...] [--cite <N>] [--review] [--detach] [--body-file <path>] [--notify-message <text> | --notify-message-file <path>] | --log <N>',
       "automation",
       ["git", "network"]
     ]
@@ -911,7 +979,7 @@ var DEV_COMMANDS = {
     reference: ["", "automation", ["processes"]]
   },
   bytes: {
-    script: "scripts/bytes/bytes-command.ts",
+    script: "scripts/lines/bytes-command.ts",
     description: "Print an agent-read document's byte size against its ceiling and the headroom left",
     category: "Development",
     reference: [REQUIRED_FILE_ARGUMENTS, "developer", ["none"]]
@@ -986,6 +1054,12 @@ var DEV_COMMANDS = {
     category: "Development",
     reference: ["", "developer", ["files"]]
   },
+  "exports:unused": {
+    script: "scripts/exports/unused-members-cli.ts",
+    description: "Report exported namespace members nothing reads (kit only; a consumer project skips it)",
+    category: "Development",
+    reference: ["", "developer", ["none"]]
+  },
   "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)",
@@ -1126,6 +1200,12 @@ var MAINTENANCE_COMMANDS = {
     reference: ["[--fix]", "developer", ["files"]],
     tsx_arguments: OPTIONAL_ENV_FILE_FLAGS
   },
+  "ruleset:check": {
+    script: "scripts/repo/ruleset-check-cli.ts",
+    description: "Check that the default branch requires every status check kit's workflows report (--apply adds the missing ones)",
+    category: "Maintenance",
+    reference: ["[--apply]", "maintainer", ["network"]]
+  },
   overrides: {
     script: "scripts/overrides/overrides-check.ts",
     description: "Check pnpm overrides for drift",
@@ -1228,7 +1308,7 @@ var PROJECT_COMMANDS = {
   },
   "registry:migrate": {
     script: "scripts/registry-migration/migrate.ts",
-    description: "Migrate a kit-only project from GitHub Packages to public npm",
+    description: "Migrate a project from GitHub Packages to public npm",
     category: "Project",
     reference: ["", "developer", ["files", "network", "processes"]]
   },
@@ -1244,6 +1324,12 @@ var PROJECT_COMMANDS = {
     category: "Project",
     reference: ["<PR>", "automation", ["network"]]
   },
+  "sonar:new-code": {
+    script: "scripts/sonar/sonar-new-code-cli.ts",
+    description: "Fail when a pull request adds any new SonarCloud issue or duplicated block",
+    category: "Project",
+    reference: ["<PR>", "automation", ["network"]]
+  },
   "ui:routes": {
     script: "scripts/ui/ui-routes-cli.ts",
     description: "List the screenshot-target routes the current change touches",
@@ -1309,6 +1395,14 @@ var VERSIONING_COMMANDS = {
     description: "Say whether a release is owed, from the unreleased merges on main",
     category: "Versioning",
     reference: ["[--json]", "automation", ["none"]]
+  },
+  // Run by the release workflows, kit's and the one sync distributes, after a tag has published
+  // (joshuafolkken/kit#3007). Settings come from the environment, so the workflow decides them.
+  "release:github": {
+    script: "scripts/release/github-release-cli.ts",
+    description: "Create the GitHub Release for a published tag, with generated notes",
+    category: "Versioning",
+    reference: ["", "automation", ["network", "release"]]
   }
 };
 
@@ -1346,7 +1440,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/git/git-followup-workflow.ts",
+    script: "scripts/followup/git-followup-workflow.ts",
     description: "Follow-up git workflow",
     category: "Workflow",
     reference: [
@@ -1357,7 +1451,7 @@ var WORKFLOW_COMMANDS = {
     tsx_arguments: OPTIONAL_ENV_FILE_FLAGS
   },
   notify: {
-    script: "scripts/git/telegram-test.ts",
+    script: "scripts/notify/telegram-test.ts",
     description: "Send Telegram notification",
     category: "Workflow",
     reference: ["--task-type <type> --body <text>", "automation", ["notifications"]],
@@ -1400,7 +1494,7 @@ var WORKFLOW_COMMANDS = {
     script: "scripts/issue/measure-rerun-cli.ts",
     description: "Re-run a merged issue\u2019s baseline command and print the before/after pair",
     category: "Workflow",
-    reference: ["<path>", "automation", ["processes", "files"]]
+    reference: ["<issue-number>", "automation", ["network", "processes", "files"]]
   },
   // A script rather than an `sh -c` chain, because it has a precondition to enforce: run inside a
   // linked work tree it would hijack the default branch from every other one (joshuafolkken/kit#1535).
@@ -1452,6 +1546,7 @@ var ALIASES = {
   f: "format",
   sd: "cspell:dot",
   bh: "behavior",
+  eu: "exports:unused",
   t: "test",
   tu: "test:unit",
   tr: "test:related",
@@ -1474,6 +1569,7 @@ var ALIASES = {
   v: "version",
   r: "ranges",
   dr: "doctor",
+  rc: "ruleset:check",
   pg: "propagate",
   ad: "adopt",
   ov: "overrides",
@@ -1657,7 +1753,6 @@ var repo_origin = {
 };
 
 // scripts/josh/run-github-prerequisite.ts
-import { execaSync as execaSync2 } from "execa";
 var GITHUB_RUN_COMMANDS = /* @__PURE__ */ new Set([
   "run:entry",
   "run:prep",
@@ -1671,11 +1766,8 @@ function explanation(root, command) {
   if (!existsSync3(path3.join(root, ".git"))) {
     return `${command} requires Git and a GitHub origin. Run git init and add a GitHub origin first.`;
   }
-  const result = execaSync2("git", ["config", "--get", "remote.origin.url"], {
-    cwd: root,
-    reject: false
-  });
-  if (result.exitCode === 0 && repo_origin.parse_origin_url(result.stdout)) return void 0;
+  const url = git_spawn_sync.origin_url(root);
+  if (url !== void 0 && repo_origin.parse_origin_url(url)) return void 0;
   return `${command} requires a GitHub origin. Add an origin pointing to GitHub first.`;
 }
 var run_github_prerequisite = { explanation };
@@ -1778,7 +1870,7 @@ function should_use_shell(executable) {
   return process.platform === "win32" && executable !== process.execPath;
 }
 function spawn_script(tsx_executable, script_arguments) {
-  const result = execaSync3(tsx_executable, script_arguments, {
+  const result = execaSync2(tsx_executable, script_arguments, {
     stdio: "inherit",
     shell: should_use_shell(tsx_executable),
     reject: false
@@ -1787,7 +1879,7 @@ function spawn_script(tsx_executable, script_arguments) {
 }
 function run_shell_command(shell, extra) {
   const [executable = "", ...rest_arguments] = shell;
-  const result = execaSync3(executable, [...rest_arguments, ...extra], {
+  const result = execaSync2(executable, [...rest_arguments, ...extra], {
     stdio: "inherit",
     reject: false
   });

package/dist/managed-marker/index.js

@@ -1,7 +1,8 @@
 // scripts/claude/workflow-destination.ts
 var WORKFLOW_DESTINATION_PATTERN = /(?:^|[/\\])\.github[/\\]workflows[/\\][^/\\]+\.ya?ml$/u;
+var COMPOSITE_ACTION_DESTINATION_PATTERN = /(?:^|[/\\])\.github[/\\]actions[/\\][^/\\]+[/\\]action\.ya?ml$/u;
 function is_workflow_destination(destination) {
-  return WORKFLOW_DESTINATION_PATTERN.test(destination);
+  return WORKFLOW_DESTINATION_PATTERN.test(destination) || COMPOSITE_ACTION_DESTINATION_PATTERN.test(destination);
 }
 
 // scripts/managed-marker/managed-marker-logic.ts