@joshuafolkken/kit 1.3000.0 → 1.3041.0

package/dist/commands/{chunk-RZJAUVMI.js → chunk-BMM4RHCG.js}

@@ -1,9 +1,9 @@
 import {
   markdown_section
-} from "./chunk-CRNPPKP2.js";
+} from "./chunk-JZK33TA5.js";
 import {
   issue_body_keys
-} from "./chunk-FNQW6NY7.js";
+} from "./chunk-KXK2A2HB.js";
 
 // scripts/issue/baseline-measure.ts
 var BASELINE_HEADING = issue_body_keys.heading("baseline");

package/dist/commands/{chunk-LAKVPOJQ.js → chunk-BMTYUJNT.js}

@@ -1,9 +1,9 @@
 import {
   project_checks
-} from "./chunk-RK4HE5NW.js";
+} from "./chunk-JM6EVOFN.js";
 import {
   buffered_process
-} from "./chunk-D5TAR6TV.js";
+} from "./chunk-JZHY7D6D.js";
 
 // scripts/gate/structural-checks.ts
 var GUARD_TEST_COMMAND = ["josh", "test:unit", "--passWithNoTests"];

package/dist/commands/{chunk-DAJCUSPG.js → chunk-BRHPRDDV.js}

@@ -1,15 +1,15 @@
 import {
   capped_output
-} from "./chunk-XDQOWUVT.js";
+} from "./chunk-2CXT6MBR.js";
 import {
   git_gh_command
-} from "./chunk-RX5JSPPH.js";
+} from "./chunk-YGFOGA7C.js";
 import {
   issue_state
 } from "./chunk-XFPEUYDV.js";
 import {
   session_cite
-} from "./chunk-X7PN54LZ.js";
+} from "./chunk-22DVQCP6.js";
 import {
   issue_number_shape
 } from "./chunk-66NX6EXR.js";

package/dist/commands/{chunk-UZAU6UI6.js → chunk-BRUBX64M.js}

@@ -1,9 +1,9 @@
 import {
   lane_cache
-} from "./chunk-LYEKT3IN.js";
+} from "./chunk-LEB2VP7F.js";
 import {
   lane_registry
-} from "./chunk-LRS2OS5J.js";
+} from "./chunk-452HWOJ7.js";
 
 // scripts/lane/lane-cache-run.ts
 import path from "node:path";

package/dist/commands/{chunk-BFLFPKQQ.js → chunk-BTZJDHQT.js}

@@ -1,19 +1,19 @@
 import {
   issue_evidence_exit
-} from "./chunk-B3XFOHDX.js";
+} from "./chunk-BCUDQWYK.js";
 import {
   epic_close
-} from "./chunk-DP7WIGQ4.js";
+} from "./chunk-4ZJOC6OK.js";
 import {
   git_gh_command
-} from "./chunk-RX5JSPPH.js";
+} from "./chunk-YGFOGA7C.js";
 import {
   MEASURED_LABEL,
   MEASURED_UNMET_LABEL
 } from "./chunk-QQBMVC5W.js";
 import {
   session_cite
-} from "./chunk-X7PN54LZ.js";
+} from "./chunk-22DVQCP6.js";
 
 // scripts/issue/issue-measured-close.ts
 async function apply_label(issue_number, label = MEASURED_LABEL) {

package/dist/commands/{chunk-AI5K4QJO.js → chunk-BYFC6MD2.js}

@@ -1,6 +1,6 @@
 import {
   run_ship_detach
-} from "./chunk-HCA5QG2U.js";
+} from "./chunk-G4E4M2P4.js";
 import {
   lane_child_marker
 } from "./chunk-QAHFPCFR.js";

package/dist/commands/{chunk-JGTLNFFE.js → chunk-BYGJ3BCJ.js}

@@ -1,36 +1,36 @@
 import {
   lane_breakdown
-} from "./chunk-VZCQZFPH.js";
+} from "./chunk-MLW4S35K.js";
 import {
   lane_net_time
-} from "./chunk-EKCKCX5S.js";
+} from "./chunk-MWO6FOSZ.js";
 import {
   lane_stage_stats
-} from "./chunk-HOSZITJM.js";
+} from "./chunk-IBAYXCMU.js";
 import {
   hook_ledger
-} from "./chunk-BY3POLIQ.js";
+} from "./chunk-XHGWMD3L.js";
 import {
   command_memory
-} from "./chunk-KUJQWO6M.js";
+} from "./chunk-QKTTKAXM.js";
 import {
   lint_timing
-} from "./chunk-WN7NK3NY.js";
+} from "./chunk-VGPIQNDB.js";
 import {
   lint_related_scope
-} from "./chunk-VGHSZLYQ.js";
+} from "./chunk-OOWGH2RG.js";
 import {
   lane_stats
-} from "./chunk-QS5USD4T.js";
+} from "./chunk-XXC32PVL.js";
 import {
   lane_ledger
-} from "./chunk-XYAK53TK.js";
+} from "./chunk-ZNR75OXP.js";
 import {
   review_prompt_level
 } from "./chunk-E33LSO2W.js";
 import {
   shell_segments
-} from "./chunk-W4YH2DF3.js";
+} from "./chunk-CVJHQOI3.js";
 import {
   time_josh_names,
   time_shell

package/dist/commands/{chunk-5HWZFL4D.js → chunk-C54QXJD6.js}

@@ -1,9 +1,9 @@
 import {
   gate_plan
-} from "./chunk-RUWV4INF.js";
+} from "./chunk-HQGNXR6I.js";
 import {
   issue_body_keys
-} from "./chunk-FNQW6NY7.js";
+} from "./chunk-KXK2A2HB.js";
 import {
   GATE_COMMAND,
   LINT_RULE_WORKERS,
@@ -702,7 +702,7 @@ var ISSUE_WRITE_COMMANDS = {
         },
         {
           names: ["--label <name>"],
-          description: "an extra label (for example `epic`). Repeatable."
+          description: "an extra label (e.g. `epic`). Repeatable. With `josh.worker`, `worker:<name>` names a printed profile."
         },
         {
           names: ["--defect / --verification / --every-run <yes|no|unknown>"],
@@ -726,7 +726,7 @@ var ISSUE_WRITE_COMMANDS = {
         },
         {
           names: ["--no-auto-ok"],
-          description: "needs a person's judgement (Tier B / C); no `auto-ok`."
+          description: "needs human judgement or a verified user prohibition; no `auto-ok`."
         },
         {
           names: ["--release"],
@@ -1639,17 +1639,25 @@ var RUN_COMMANDS = {
   },
   "run:park": {
     script: "scripts/run/park/run-park-cli.ts",
-    description: "Park a lane child for a decision, or clear the park",
+    description: "Park a lane child for a decision or an escalation, or clear the park",
     category: "AI tools",
     tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    reference: ["<issue> --body-file <path> | <issue> --clear", "automation", ["files", "network"]],
+    reference: [
+      "<issue> --body-file <path> | <issue> --clear | <issue> --escalate <reason>",
+      "automation",
+      ["files", "network"]
+    ],
     usage: {
       examples: [
         {
           arguments: "1839 --body-file .josh/tmp/park-1839.md",
           note: "options, tiers and a recommendation; then needs-decision, the record, run:release"
         },
-        { arguments: "1839 --clear", note: "remove needs-decision and the record" }
+        { arguments: "1839 --clear", note: "remove needs-decision and the record" },
+        {
+          arguments: '1839 --escalate "needs a stronger model"',
+          note: "josh.worker.escalate only: run:stalled with the reason, resumed one profile up"
+        }
       ]
     }
   },
@@ -2435,7 +2443,7 @@ var AI_COMMANDS = {
     description: "Record a lane child's planned files; yield its lane, naming file and holder, when an earlier-planned running lane declares or plans one; `--size-approval` bounds lines/files",
     category: "AI tools",
     reference: [
-      "<issue> <path>... [--probe] [--single] [--size-approval <json-file>] [--imports <path>...]",
+      "<issue> <path>... [--probe] [--single] [--estimate <json-file>] [--size-approval <json-file>] [--imports <path>...]",
       "automation",
       ["files", "network"]
     ],
@@ -2498,7 +2506,7 @@ var AI_COMMANDS = {
   },
   "lane:stats": {
     ...MEASURE_ARGUMENTS,
-    description: "Print period lane throughput, stage, stop, check and machine-load statistics; --sinks shows stage totals, --over lane chains, --why cause groups above a net-minute threshold, and --pairs scoped pair runs",
+    description: "Print period lane throughput, stage, stop (by failed CI check, longest first), check and machine-load statistics; --sinks shows stage totals, --over lane chains, --why cause groups above a net-minute threshold, and --pairs scoped pair runs",
     category: "AI tools",
     reference: [
       "(--period <days> | --since <instant>) [--limit <lane-limit> | --sinks [<minutes>] | --over <minutes> | --why <minutes> | --pairs]",
@@ -2830,6 +2838,7 @@ var TEST_CHECK_COMMANDS = {
 
 // scripts/josh/josh-commands-development.ts
 var NARROWED = { arguments: "scripts/thing.ts", note: "narrow by the given files instead" };
+var FORWARDED_TO_VITEST = "flags are forwarded to vitest";
 var UNSEEDED = {};
 var FILE_ARGUMENTS = "[files...]";
 var REQUIRED_FILE_ARGUMENTS = "<files...>";
@@ -2871,13 +2880,14 @@ var DEV_COMMANDS = {
     script: "scripts/lint/lint-parallel-main.ts",
     description: "Check code with prettier and eslint (skips a tool a basic project lacks)",
     category: "Development",
-    reference: ["[--changed]", "developer", ["processes"]],
+    reference: ["[--changed] [--shard=<n>]", "developer", ["processes"]],
     core_weight: core_weights.CORE_WEIGHTS.lint,
     memory_mb: core_weights.MEMORY_MB.lint,
     usage: {
       examples: [
         { arguments: "" },
-        { arguments: "--changed", note: "the branch's changed files \u2014 the gate's form" }
+        { arguments: "--changed", note: "the branch's changed files \u2014 the gate's form" },
+        { arguments: "--shard=1", note: "one of two fixed halves of the tree (1 or 2) \u2014 a CI leg" }
       ]
     }
   },
@@ -2945,7 +2955,11 @@ 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: ["[--fresh | --refresh | --prose]", "developer", ["files"]],
+    reference: [
+      "[--fresh | --refresh | --period <days> | --weekly <rule-id>... | --prose]",
+      "developer",
+      ["files"]
+    ],
     usage: {
       examples: [
         { arguments: "", note: "a reading cached under 15 minutes ago, else measure" },
@@ -2954,6 +2968,14 @@ var DEV_COMMANDS = {
           arguments: "--refresh",
           note: "write the reading to the loop-head cache instead of stdout"
         },
+        {
+          arguments: "--period 7",
+          note: "measure only the transcripts written in the last 7 days, cache untouched"
+        },
+        {
+          arguments: "--weekly <rule-id>...",
+          note: "reached / refused / rephrased of the named rules, one line per week"
+        },
         { arguments: "--prose", note: "class each prose rule: enforced, measured or prose only" }
       ]
     }
@@ -3038,7 +3060,9 @@ var DEV_COMMANDS = {
     category: "Development",
     reference: [FILTER_ARGUMENTS, "developer", ["processes"]],
     ...gate_plan.DIRECT_UNIT_CLAIM,
-    usage: { examples: [{ arguments: "" }] }
+    usage: {
+      examples: [{ arguments: "" }, { arguments: "--shard=1/3", note: FORWARDED_TO_VITEST }]
+    }
   },
   "test:related": {
     script: "scripts/test/test-related-main.ts",
@@ -3049,8 +3073,8 @@ var DEV_COMMANDS = {
       examples: [
         { arguments: "" },
         NARROWED,
-        { arguments: "--touched", note: "only the diff's tests and its modules' same-named ones" },
-        { arguments: "--silent", note: "flags are forwarded to vitest" }
+        { arguments: "--touched", note: "diff tests, same-named tests and direct test importers" },
+        { arguments: "--silent", note: FORWARDED_TO_VITEST }
       ]
     }
   },
@@ -3258,7 +3282,7 @@ var LINT_COMMANDS = {
     script: "scripts/plan/plan-scaffold-cli.ts",
     description: "Print a work summary's inputs in one call: the run:prep skeleton, planned files near the line limit, the test:declared verdict, the owed cases and the plan:consumers draft",
     category: "AI tools",
-    reference: ["<issue> [<path>...]", "automation", ["network"]],
+    reference: ["<issue> [<path>...] [--estimate <json-file>]", "automation", ["network"]],
     usage: {
       examples: [
         { arguments: "123", note: "planned files from the issue body" },
@@ -3628,8 +3652,13 @@ var PROJECT_COMMANDS = {
     script: "scripts/sync/sync-main.ts",
     description: "Sync config files",
     category: "Project",
-    reference: ["", "developer", ["files"]],
-    usage: { examples: [{ arguments: "", note: "overwrite managed files" }] }
+    reference: ["[--force]", "developer", ["files"]],
+    usage: {
+      examples: [
+        { arguments: "", note: "overwrite managed files" },
+        { arguments: "--force", note: "also replace a file you added to, dropping your additions" }
+      ]
+    }
   },
   uninstall: {
     script: "scripts/uninstall/uninstall.ts",
@@ -3884,6 +3913,10 @@ var WORKFLOW_COMMANDS = {
         {
           names: [SKIP_COMMIT, SKIP_PUSH],
           description: "recover/open a PR without a new commit or push."
+        },
+        {
+          names: ["--body-file <path>"],
+          description: "extra PR body text after `closes #N`, from a file (`-` = stdin); use it when the text holds a backtick or `$`."
         }
       ]
     }

package/dist/commands/{chunk-LMS6N6GE.js → chunk-CBAKBWSZ.js}

@@ -4,14 +4,14 @@ import {
 import {
   CATEGORY_ORDER,
   COMMAND_MAP
-} from "./chunk-5HWZFL4D.js";
-import {
-  ALIASES
-} from "./chunk-ROJXMBXP.js";
+} from "./chunk-C54QXJD6.js";
 import {
   USAGE_ERROR_EXIT_CODE,
   composite_arguments
 } from "./chunk-RSSJWMQS.js";
+import {
+  ALIASES
+} from "./chunk-ROJXMBXP.js";
 import {
   core_budget
 } from "./chunk-TCBUX52E.js";
@@ -23,17 +23,17 @@ import {
 } from "./chunk-4ZHWTTQW.js";
 import {
   find_package_directory
-} from "./chunk-G47ZNQVG.js";
+} from "./chunk-LR22UK5W.js";
 import {
   resolve_local_bin,
   resolve_package_bin
-} from "./chunk-F7XLEK55.js";
+} from "./chunk-SVV4U5AR.js";
 import {
   package_version_schema
 } from "./chunk-RBU2NKHF.js";
 import {
   package_manifest
-} from "./chunk-NKKH3PBE.js";
+} from "./chunk-WB4T3VY2.js";
 import {
   git_spawn_sync
 } from "./chunk-B77ZMVHS.js";

package/dist/commands/{chunk-7EAMUVIO.js → chunk-CFHRNTE5.js}

@@ -1,6 +1,6 @@
 import {
   since_green
-} from "./chunk-SNO7CY2B.js";
+} from "./chunk-P3H3DKTE.js";
 import {
   test_read_map
 } from "./chunk-OZZWRJQI.js";

package/dist/commands/{chunk-UIWAMLQH.js → chunk-CGYDIYHD.js}

@@ -1,9 +1,9 @@
 import {
   buffered_process
-} from "./chunk-D5TAR6TV.js";
+} from "./chunk-JZHY7D6D.js";
 import {
   find_package_directory
-} from "./chunk-G47ZNQVG.js";
+} from "./chunk-LR22UK5W.js";
 import {
   core_weights
 } from "./chunk-ENFPR7J2.js";

package/dist/commands/{chunk-4QYW2IL7.js → chunk-CHKYPF5O.js}

@@ -1,6 +1,6 @@
 import {
   plan_consumers_section
-} from "./chunk-T3FD3Q73.js";
+} from "./chunk-SRG6PKVS.js";
 import {
   git_grep_hits
 } from "./chunk-T25S4QHL.js";

package/dist/commands/{chunk-5HCPSV45.js → chunk-CJBW6BWG.js}

@@ -2,29 +2,29 @@ import {
   test_pinned,
   test_pinned_ledger,
   test_pinned_record
-} from "./chunk-VZHC2I3T.js";
+} from "./chunk-DAAX7XDS.js";
 import {
   run_ship_planned
-} from "./chunk-ESQEEL4O.js";
+} from "./chunk-TAEGXID2.js";
 import {
   gate_skip
-} from "./chunk-DNJC7X73.js";
+} from "./chunk-WCEUMOKK.js";
 import {
   test_pinned_logic
-} from "./chunk-E3CXOVPQ.js";
+} from "./chunk-Y27PTXXI.js";
 import {
   review_finding_ledger
 } from "./chunk-KVURNO74.js";
 import {
   observation_ledger_home
-} from "./chunk-WG6GYBRJ.js";
+} from "./chunk-WWVYEHQT.js";
 import {
   review_stamps
-} from "./chunk-L6LU2633.js";
+} from "./chunk-MVHPRYHE.js";
 import {
   gate_tree,
   review_tree
-} from "./chunk-IXX4SXIP.js";
+} from "./chunk-NFPD2P3V.js";
 import {
   file_map_stamp
 } from "./chunk-CGLLAEKZ.js";
@@ -37,7 +37,7 @@ import {
 } from "./chunk-TCBUX52E.js";
 import {
   run_ship_detach
-} from "./chunk-HCA5QG2U.js";
+} from "./chunk-G4E4M2P4.js";
 import {
   detached_launch
 } from "./chunk-C2SEDMZ3.js";