@joshuafolkken/kit 1.1050.0 → 1.1094.0

package/dist/josh.js

@@ -4,6 +4,19 @@
 import { existsSync } from "node:fs";
 import path from "node:path";
 
+// 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";
@@ -46,15 +59,6 @@ function read_spawn_stdout(result) {
 // 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";
@@ -79,7 +83,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,7 +98,7 @@ 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) {
@@ -120,7 +124,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`"
   );
 }
@@ -162,8 +166,6 @@ function report_consumer_setup(root) {
 var doctor_consumer = {
   claude_md_line,
   claude_md_state,
-  configured_hooks_path,
-  consumer_setup_lines,
   hooks_path_line,
   is_kit_consumer,
   is_plugin_declared,
@@ -344,7 +346,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 +441,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 +459,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 +547,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 +659,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 +669,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 +684,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 +713,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 +779,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 +803,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 +816,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 +926,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 +1001,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 +1147,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",
@@ -1244,6 +1271,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 +1342,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 +1387,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 +1398,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"]],
@@ -1452,6 +1493,7 @@ var ALIASES = {
   f: "format",
   sd: "cspell:dot",
   bh: "behavior",
+  eu: "exports:unused",
   t: "test",
   tu: "test:unit",
   tr: "test:related",
@@ -1474,6 +1516,7 @@ var ALIASES = {
   v: "version",
   r: "ranges",
   dr: "doctor",
+  rc: "ruleset:check",
   pg: "propagate",
   ad: "adopt",
   ov: "overrides",

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