@joshuafolkken/kit 1.1370.0 → 1.1379.0

package/.claude/skills/dependency-update/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: dependency-update
-description: Checks after `pnpm update`, `josh latest`, `pnpm josh overrides` or any dependency update — the `overrides` survived, the one expected `devEngines` change. Read it before reporting the pins intact or pinning a bump back.
+description: Checks after `pnpm update`, `josh latest`, `josh adopt`, `pnpm josh overrides` or any dependency update — the `overrides` survived, the one expected `devEngines` change. Read it before reporting the pins intact or pinning a bump back.
 ---
 
 # After a dependency-update command
@@ -8,8 +8,9 @@ description: Checks after `pnpm update`, `josh latest`, `pnpm josh overrides` or
 `CLAUDE.md` → "Decision autonomy" keeps both prohibitions resident as Tier C — never touch `overrides`
 in either file, never touch `devEngines`, without explicit user approval. This skill is the other
 half: what you actually run to find out whether a command already touched them, and how to read the
-one change that is expected. It applies after `pnpm update`, `josh latest`, `pnpm josh overrides`,
-a Dependabot merge, or any other command that can rewrite dependency versions.
+one change that is expected. It applies after `pnpm update`, `josh latest`, `josh adopt` (which runs
+`josh latest` as one of its steps), `pnpm josh overrides`, a Dependabot merge, or any other command
+that can rewrite dependency versions.
 
 This skill is the single source of the overrides protection's procedure;
 `prompts/collaboration-workflow/operating-rules.md` only points here. Overrides were added on
@@ -34,6 +35,8 @@ or any dependency-update command, verify the overrides in both `pnpm-workspace.y
 git diff -- pnpm-workspace.yaml package.json
 ```
 
+(after `josh adopt`, which has already committed and returned to the default branch, compare the
+pull-request branch instead: `git diff <default>...<branch> -- pnpm-workspace.yaml package.json`)
 and confirm the effective `overrides:` block in `pnpm-workspace.yaml` and any historical
 `pnpm.overrides` declarations in `package.json` are untouched, **and** that `devDependencies`
 versions still respect the effective overrides. If any entry was removed, modified, or bumped past

package/.claude/skills/workflow-commands/backlogrun-steps.md

@@ -70,7 +70,7 @@ and `--filed 1`, and **`--cut` is the session's last write**.
 
 | It answers | What the run does |
 | --- | --- |
-| `began` | Report the plan and run the decision pass |
+| `began` | Report the plan and run the decision pass, then run what the bare `pnpm josh run:step` prints — an empty plan or a `none` from `backlog:next` included, which the driver's idle watch ends, never the session |
 | `resumed` | Take the budget from `--json`, report the plan again, read `backlogrun-progress.md` → "Resuming after a cut" |
 | `busy` / `mismatch` / `unreadable` / `unknown` | **Stop; do not open a lane** — report what it printed; never resume into another invocation's record |
 | `over` | **End the conversation**; retype the invocation in a fresh session |

package/.claude/skills/workflow-commands/backlogrun.md

@@ -13,7 +13,8 @@ that same backlog. **`--only` stops it after the named list**, draining nothing.
 
 **The loop's current position is computed, not carried in the conversation.** `pnpm josh run:step <N>`
 reads where the run is from the event stream, the carry record and the issue state, and prints the next
-single action — a runnable command, or the one point a person has to judge.
+single action — a runnable command, or the one point a person has to judge. **With no `<N>` it answers
+for the parent itself**, from the carry record alone.
 
 **A named item may be a single issue or an epic.** A single-issue item is one `fullrun`; **a named epic runs its children in
 dependency order across the free lanes, and the run does not advance to the next named item until
@@ -40,10 +41,11 @@ is still that one invocation (`backlogrun-steps.md` → "The session cut is insi
    `run:lane` in the same pass.
 5. **Named issues run first, in order** — each as a delegated `fullrun`, one at a time, then the pool;
    `--only` stops after the list.
-6. **The loop belongs to the supervisor** — `run:wake` runs `backlog:drive`, which returns a branch to
-   an AI session only when it needs judgment.
+6. **The loop belongs to the supervisor — hand it over with what the bare `pnpm josh run:step`
+   prints**, whatever the plan held: `run:wake` runs `backlog:drive`, which returns a branch to an AI
+   session only when it needs judgment.
 7. **End the record when the run ends** — `run:report`, then `run:carry --end` (or `--end --stopped
-   "<reason>"`) and `run:wake --stop`.
+   "<reason>"`) and `run:wake --stop`. An empty plan is not that end; the driver's idle watch decides it.
 
 ## The route table
 

package/README.md

@@ -1,34 +1,25 @@
 # @joshuafolkken/kit
 
-[![npm version](https://img.shields.io/npm/v/@joshuafolkken/kit)](https://www.npmjs.com/package/@joshuafolkken/kit)
-[![CI](https://github.com/joshuafolkken/kit/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/joshuafolkken/kit/actions/workflows/ci.yml)
-[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=joshuafolkken_kit&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=joshuafolkken_kit)
-
 **AI assistant setup, plus an optional GitHub workflow.**
 
-kit gives Claude Code or Codex your project's rules and checks. With the workflow, the agent takes each change from Issue to merged PR.
+kit gives Claude Code or Codex your project's rules and checks.
+
+## The workflow
+
+Type `backlogrun` and the agent takes the Issues you name from plan to merged PR — in parallel, unattended. A live board shows where each one stands:
+
+![The backlogrun board: ten Issues running side by side, seven already merged, each with its stage and elapsed time](./docs/images/backlogrun-board.png)
+
+[Every keyword, including the ones that stop for you earlier](./docs/how-to/run-issues.md)
 
 ## Sound familiar?
 
 [The whole story](./docs/why.md)
 
-### Working with an AI agent
-
 - [I keep repeating the same instructions](./docs/why.md#i-keep-repeating-the-same-instructions)
 - [The agent does things I never asked for](./docs/why.md#the-agent-does-things-i-never-asked-for)
-- [Reviewing every change is a chore](./docs/why.md#reviewing-every-change-is-a-chore)
-
-### With the GitHub workflow
-
 - [Wiring AI up to GitHub is a chore](./docs/why.md#wiring-ai-up-to-github-is-a-chore)
-- [Writing Issues is a chore](./docs/why.md#writing-issues-is-a-chore)
-- [Big requests come back sloppy](./docs/why.md#big-requests-come-back-sloppy)
-
-### Writing TypeScript
-
 - [Done doesn't mean done](./docs/why.md#done-doesnt-mean-done)
-- [Quality slips with every change](./docs/why.md#quality-slips-with-every-change)
-- [Updating dependencies keeps breaking things](./docs/why.md#updating-dependencies-keeps-breaking-things)
 
 ## Quick start
 
@@ -54,24 +45,8 @@ pnpm --allow-build=esbuild dlx @joshuafolkken/kit init
 
 Next: [tutorial](./docs/tutorial.md#without-github-one-change-checked-locally)
 
-## The workflow
-
-| You type     | The agent                                        |
-| ------------ | ------------------------------------------------ |
-| `kickoff`    | Writes the plan on the Issue, then stops         |
-| `halfrun`    | Implements and self-reviews, stops before commit |
-| `prrun`      | Opens a green pull request, stops before merge   |
-| `fullrun`    | Plans if needed, implements through to merge     |
-| `backlogrun` | Runs many Issues unattended                      |
-
-[Each keyword in full](./docs/how-to/run-issues.md) · [Telegram notifications when a run needs you](./docs/how-to/set-up-notifications.md)
-
 ## Docs
 
-[How-to](./docs/how-to.md) · [Commands](./docs/josh-commands.md) · [Troubleshooting](./docs/troubleshooting.md) · [All docs](./docs/overview.md)
-
-[app-kit](https://github.com/joshuafolkken/app-kit) · [game-kit](https://github.com/joshuafolkken/game-kit) · [Releases](https://github.com/joshuafolkken/kit/releases) · [Security](./SECURITY.md) · [Contributing](./docs/maintainers/README.md) · [MIT](./LICENSE)
+[How-to](./docs/how-to.md) · [All docs](./docs/overview.md)
 
-[![Node.js](https://img.shields.io/badge/dynamic/regex?url=https%3A%2F%2Fraw.githubusercontent.com%2Fjoshuafolkken%2Fkit%2Fmain%2Fpackage.json&search=%22node%22%3A%20%22%5C%5E%28%5B0-9%5D%2B%5C.%5B0-9%5D%2B%29%5B0-9.%5D%2A%20%5C%7C%5C%7C%20%5C%5E%28%5B0-9%5D%2B%29%5B0-9.%5D%2A%20%5C%7C%5C%7C%20%3E%3D%28%5B0-9%5D%2B%29&replace=%5E%241%20%7C%20%5E%242%20%7C%20%3E%3D%243&logo=nodedotjs&label=Node.js)](https://nodejs.org/)
-[![TypeScript](https://img.shields.io/npm/dependency-version/@joshuafolkken/kit/peer/typescript?logo=typescript)](https://www.typescriptlang.org/)
-[![pnpm](https://img.shields.io/badge/dynamic/regex?url=https%3A%2F%2Fraw.githubusercontent.com%2Fjoshuafolkken%2Fkit%2Fmain%2Fpackage.json&search=pnpm%40%28%5B0-9.%5D%2B%29&replace=%241&logo=pnpm&label=pnpm)](https://pnpm.io/)
+[app-kit](https://github.com/joshuafolkken/app-kit) · [game-kit](https://github.com/joshuafolkken/game-kit) · [Releases](https://github.com/joshuafolkken/kit/releases) · [Contributing](./docs/maintainers/README.md)

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

@@ -117,7 +117,7 @@ var SECTION_PATTERN = /(?<![\w./:`-])(?<tick>`?)(?<file>[\w./-]+\.md)\k<tick>\s*
 var ADJACENT_PATTERN = /["「](?<heading>[^"「」]+)["」]\s+(?:above|below)\b/gu;
 var BARE_ARROW_PATTERN = /→\s*(?:§\w+,\s*)?["「](?<heading>[^"「」]+)["」]/gu;
 var LINK_TARGET_PATTERN = /\]\([^)\s]*\)/gu;
-var LINK_PATTERN = /\]\(([\w./-]+\.md)(?:#[\w-]+)?\)/gu;
+var LINK_PATTERN = /\]\(([\w./-]+\.(?:md|png|jpe?g|gif|svg|webp))(?:#[\w-]+)?\)/gu;
 var PLACEHOLDER_FILES = /* @__PURE__ */ new Set(["x.md", "foo.md", "file.md", "path.md"]);
 function matches(text, pattern) {
   return [...text.matchAll(pattern)];

package/dist/hooks/batch-guard.js

@@ -9,12 +9,12 @@ import {
   load_environment_file,
   notice_refusal_path,
   refusal_path
-} from "./chunk-DZWZ3DKY.js";
-import "./chunk-GG72ANKI.js";
-import "./chunk-KPM4YIIX.js";
-import "./chunk-TLJYAGZK.js";
-import "./chunk-Z5TMJIPW.js";
-import "./chunk-NZN2UFI6.js";
+} from "./chunk-7ZM464OW.js";
+import "./chunk-DHSKBAQ2.js";
+import "./chunk-E7LZL5AN.js";
+import "./chunk-TORRSNDJ.js";
+import "./chunk-NBEAGPS4.js";
+import "./chunk-RW4XMF47.js";
 import "./chunk-NEC4AT4Z.js";
 export {
   DISABLED_VALUES,

package/dist/hooks/{chunk-NZBHG6FW.js → chunk-4RWRP3FF.js}

@@ -1,18 +1,18 @@
 import {
   investigation_reads
-} from "./chunk-76RK6E3H.js";
+} from "./chunk-QARPP36N.js";
 import {
   lane_guard_policy
-} from "./chunk-GG72ANKI.js";
+} from "./chunk-DHSKBAQ2.js";
 import {
   hook_decision
-} from "./chunk-KPM4YIIX.js";
+} from "./chunk-E7LZL5AN.js";
 import {
   time_spans
-} from "./chunk-TLJYAGZK.js";
+} from "./chunk-TORRSNDJ.js";
 import {
   json_value
-} from "./chunk-NZN2UFI6.js";
+} from "./chunk-RW4XMF47.js";
 
 // scripts/delegation/duplicate-read-guard.ts
 import { statSync } from "node:fs";

package/dist/hooks/{chunk-R6CRQEAL.js → chunk-546X4PX3.js}

@@ -1,12 +1,12 @@
 import {
   investigation_reads
-} from "./chunk-76RK6E3H.js";
+} from "./chunk-QARPP36N.js";
 import {
   lane_guard_policy
-} from "./chunk-GG72ANKI.js";
+} from "./chunk-DHSKBAQ2.js";
 import {
   hook_decision
-} from "./chunk-KPM4YIIX.js";
+} from "./chunk-E7LZL5AN.js";
 
 // scripts/delegation/investigation-guard.ts
 import { text } from "node:stream/consumers";

package/dist/hooks/{chunk-DZWZ3DKY.js → chunk-7ZM464OW.js}

@@ -1,12 +1,12 @@
 import {
   lane_guard_policy
-} from "./chunk-GG72ANKI.js";
+} from "./chunk-DHSKBAQ2.js";
 import {
   hook_decision
-} from "./chunk-KPM4YIIX.js";
+} from "./chunk-E7LZL5AN.js";
 import {
   time_batch_guard
-} from "./chunk-TLJYAGZK.js";
+} from "./chunk-TORRSNDJ.js";
 
 // scripts/hooks/batch-guard.ts
 import { text } from "node:stream/consumers";

package/dist/hooks/{chunk-GG72ANKI.js → chunk-DHSKBAQ2.js}

@@ -1,6 +1,6 @@
 import {
   lane_child_marker
-} from "./chunk-Z5TMJIPW.js";
+} from "./chunk-NBEAGPS4.js";
 
 // scripts/lane/lane-guard-policy.ts
 var DEFAULT_MODE = "refuse";

package/dist/hooks/{chunk-KPM4YIIX.js → chunk-E7LZL5AN.js}

@@ -1,13 +1,13 @@
 import {
   time_density_hook,
   time_hook_transcript
-} from "./chunk-TLJYAGZK.js";
+} from "./chunk-TORRSNDJ.js";
 import {
   josh_environment_file
-} from "./chunk-Z5TMJIPW.js";
+} from "./chunk-NBEAGPS4.js";
 import {
   json_value
-} from "./chunk-NZN2UFI6.js";
+} from "./chunk-RW4XMF47.js";
 import {
   stamp_file
 } from "./chunk-NEC4AT4Z.js";

package/dist/hooks/{chunk-4TW4MQUL.js → chunk-HGA4EG5S.js}

@@ -1,6 +1,6 @@
 import {
   duplicate_read_outcome
-} from "./chunk-NZBHG6FW.js";
+} from "./chunk-4RWRP3FF.js";
 import {
   ALREADY_DONE_LABEL,
   CONTEXT_CUT_THRESHOLD,
@@ -28,7 +28,7 @@ import {
   session_cite,
   shell_segments,
   tail_commands
-} from "./chunk-MXVQMLDP.js";
+} from "./chunk-TG2AB3W6.js";
 import {
   ancestor_directories,
   find_local_bin_upwards
@@ -41,25 +41,25 @@ import {
   lane_registry,
   repo_origin,
   run_headless
-} from "./chunk-SYSRHRWU.js";
+} from "./chunk-YSDAH73S.js";
 import {
   error_text
 } from "./chunk-CDY4NFQG.js";
 import {
   batch_outcome
-} from "./chunk-DZWZ3DKY.js";
+} from "./chunk-7ZM464OW.js";
 import {
   investigation_refusal
-} from "./chunk-R6CRQEAL.js";
+} from "./chunk-546X4PX3.js";
 import {
   investigation_reads
-} from "./chunk-76RK6E3H.js";
+} from "./chunk-QARPP36N.js";
 import {
   lane_guard_policy
-} from "./chunk-GG72ANKI.js";
+} from "./chunk-DHSKBAQ2.js";
 import {
   hook_decision
-} from "./chunk-KPM4YIIX.js";
+} from "./chunk-E7LZL5AN.js";
 import {
   cost_attribute,
   cost_blocks,
@@ -67,10 +67,10 @@ import {
   time_batch_guard,
   time_density_hook,
   time_shell
-} from "./chunk-TLJYAGZK.js";
+} from "./chunk-TORRSNDJ.js";
 import {
   lane_child_marker
-} from "./chunk-Z5TMJIPW.js";
+} from "./chunk-NBEAGPS4.js";
 import {
   PORCELAIN_FLAG,
   cli_flags,
@@ -84,7 +84,7 @@ import {
   lane_paths,
   own_session,
   run_carry
-} from "./chunk-NZN2UFI6.js";
+} from "./chunk-RW4XMF47.js";
 import {
   PLATFORM_TEMP_ROOT,
   PROBE_TIMEOUT_MS,
@@ -1661,7 +1661,7 @@ var BATCH_ORACLES = [
   {
     name: "run:step",
     decision: "The run\u2019s next single action, computed from the event stream, carry and issue state",
-    args: ISSUE_N_ARG,
+    args: `[${ISSUE_N_ARG}]`,
     // The non-command answers: `run:step` prints a runnable command for a phase with one to run, and
     // one of these verdicts otherwise. A command line is not a vocabulary token, exactly as an issue
     // number is not one for `backlog:next`.

package/dist/hooks/{chunk-Z5TMJIPW.js → chunk-NBEAGPS4.js}

@@ -2,7 +2,7 @@ import {
   ENV_FILE_NAME,
   issue_number_shape,
   lane_paths
-} from "./chunk-NZN2UFI6.js";
+} from "./chunk-RW4XMF47.js";
 
 // scripts/josh/josh-environment-file.ts
 function load_environment_file() {

package/dist/hooks/{chunk-43G45XJF.js → chunk-PV3FWDSQ.js}

@@ -5,11 +5,11 @@ import {
 import {
   ESLINT_EDIT_CACHE_FLAGS,
   time_density_hook
-} from "./chunk-TLJYAGZK.js";
+} from "./chunk-TORRSNDJ.js";
 import {
   file_reader,
   json_value
-} from "./chunk-NZN2UFI6.js";
+} from "./chunk-RW4XMF47.js";
 import {
   HOOK_PROCESS_TIMEOUT_MS
 } from "./chunk-NEC4AT4Z.js";

package/dist/hooks/{chunk-76RK6E3H.js → chunk-QARPP36N.js}

@@ -1,16 +1,16 @@
 import {
   hook_decision
-} from "./chunk-KPM4YIIX.js";
+} from "./chunk-E7LZL5AN.js";
 import {
   cost_blocks,
   time_batch_guard,
   time_bundle_call,
   time_shell,
   time_spans
-} from "./chunk-TLJYAGZK.js";
+} from "./chunk-TORRSNDJ.js";
 import {
   cost_transcript
-} from "./chunk-NZN2UFI6.js";
+} from "./chunk-RW4XMF47.js";
 
 // scripts/delegation/investigation-reads.ts
 import path2 from "node:path";

package/dist/hooks/{chunk-NZN2UFI6.js → chunk-RW4XMF47.js}

@@ -521,6 +521,37 @@ function read_spawn_stderr(result) {
 
 // scripts/git/git-spawn-sync.ts
 import { execaSync } from "execa";
+
+// scripts/git/git-location-environment.ts
+var GIT_LOCATION_VARIABLES = [
+  "GIT_ALTERNATE_OBJECT_DIRECTORIES",
+  "GIT_COMMON_DIR",
+  "GIT_DIR",
+  "GIT_INDEX_FILE",
+  "GIT_NAMESPACE",
+  "GIT_OBJECT_DIRECTORY",
+  "GIT_WORK_TREE"
+];
+function location_free_environment() {
+  return Object.fromEntries(GIT_LOCATION_VARIABLES.map((name) => [name, void 0]));
+}
+function forget(name) {
+  Reflect.deleteProperty(process.env, name);
+}
+function restore_one(name, value) {
+  if (value === void 0) forget(name);
+  else process.env[name] = value;
+}
+function clear_git_location_variables() {
+  const previous = GIT_LOCATION_VARIABLES.map((name) => [name, process.env[name]]);
+  for (const [name] of previous) forget(name);
+  return () => {
+    for (const [name, value] of previous) restore_one(name, value);
+  };
+}
+var git_location_environment = { clear_git_location_variables, location_free_environment };
+
+// scripts/git/git-spawn-sync.ts
 var SUCCESS_EXIT_CODE = 0;
 var C_LOCALE = { LC_ALL: "C", LANGUAGE: "C" };
 function run2(args, options = {}) {
@@ -541,7 +572,10 @@ function read2(args, options = {}) {
   return result.exit_code === SUCCESS_EXIT_CODE ? result.stdout.trim() : void 0;
 }
 function origin_url(cwd) {
-  return read2(["config", "--get", "remote.origin.url"], { cwd });
+  return read2(["config", "--get", "remote.origin.url"], {
+    cwd,
+    env: git_location_environment.location_free_environment()
+  });
 }
 function toplevel(timeout = GIT_TIMEOUT_MS) {
   return run2(["rev-parse", "--show-toplevel"], { env: C_LOCALE, timeout });
@@ -2392,6 +2426,8 @@ export {
   git_utilities,
   has_timed_out,
   git_spawn,
+  GIT_LOCATION_VARIABLES,
+  git_location_environment,
   git_spawn_sync,
   git_command,
   stamp_record,

package/dist/hooks/{chunk-MXVQMLDP.js → chunk-TG2AB3W6.js}

@@ -8,7 +8,7 @@ import {
   repo_origin,
   repository_lock,
   run_ship_stage
-} from "./chunk-SYSRHRWU.js";
+} from "./chunk-YSDAH73S.js";
 import {
   error_text
 } from "./chunk-CDY4NFQG.js";
@@ -30,10 +30,10 @@ import {
   time_density_hook,
   time_shell,
   time_transcript_line
-} from "./chunk-TLJYAGZK.js";
+} from "./chunk-TORRSNDJ.js";
 import {
   lane_child_marker
-} from "./chunk-Z5TMJIPW.js";
+} from "./chunk-NBEAGPS4.js";
 import {
   agent_session_environment,
   backlog_budget,
@@ -44,7 +44,7 @@ import {
   process_identity,
   run_carry,
   stamp_record
-} from "./chunk-NZN2UFI6.js";
+} from "./chunk-RW4XMF47.js";
 import {
   COMMAND_TIMEOUT_MS,
   stamp_file
@@ -503,29 +503,56 @@ var run_hold = {
 // scripts/cost-runtime/cost-pricing.ts
 var CACHE_WRITE_5M_MULTIPLIER = 1.25;
 var CACHE_WRITE_1H_MULTIPLIER = 2;
-var CACHE_READ_MULTIPLIER = 0.1;
+var DEFAULT_CACHE_READ_MULTIPLIER = 0.1;
+var HALVED_CACHE_READ_MULTIPLIER = 0.05;
+var QUARTERED_CACHE_READ_MULTIPLIER = 0.025;
 var TOKENS_PER_MILLION = 1e6;
+var LONG_PROMPT_SUFFIX = ":long-prompt";
+var LONG_PROMPT_THRESHOLD = 1e5;
 var MODEL_PRICES = {
+  "claude-fable-5-1": {
+    input: 10,
+    output: 50,
+    cache_read_multiplier: QUARTERED_CACHE_READ_MULTIPLIER
+  },
+  "claude-mythos-5-1": {
+    input: 10,
+    output: 50,
+    cache_read_multiplier: QUARTERED_CACHE_READ_MULTIPLIER
+  },
   "claude-fable-5": { input: 10, output: 50 },
   "claude-mythos-5": { input: 10, output: 50 },
+  "claude-opus-5-5": { input: 4, output: 20, cache_read_multiplier: HALVED_CACHE_READ_MULTIPLIER },
   "claude-opus-5": { input: 5, output: 25 },
   "claude-opus-4-8": { input: 5, output: 25 },
   "claude-opus-4-7": { input: 5, output: 25 },
   "claude-opus-4-6": { input: 5, output: 25 },
+  "claude-sonnet-5-5": {
+    input: 2,
+    output: 10,
+    cache_read_multiplier: HALVED_CACHE_READ_MULTIPLIER
+  },
   "claude-sonnet-5": { input: 2, output: 10 },
   "claude-sonnet-4-6": { input: 3, output: 15 },
+  "claude-haiku-5-5": { input: 0.1, output: 0.5 },
+  [`claude-haiku-5-5${LONG_PROMPT_SUFFIX}`]: { input: 0.5, output: 2.5 },
   "claude-haiku-4-5": { input: 1, output: 5 }
 };
 var CONTEXT_MARKER = "[";
-function resolve_price(model) {
+var DATE_SUFFIX = /-\d{8}$/u;
+function known_id(model) {
   const base = model.split(CONTEXT_MARKER)[0] ?? model;
-  const direct = MODEL_PRICES[base];
-  if (direct !== void 0) return direct;
-  const [matched] = Object.keys(MODEL_PRICES).filter((id) => base.startsWith(id)).toSorted((left, right) => right.length - left.length);
-  return matched === void 0 ? void 0 : MODEL_PRICES[matched];
+  return [base, base.replace(DATE_SUFFIX, "")].find((id) => Object.hasOwn(MODEL_PRICES, id));
+}
+function resolve_price(model) {
+  const id = known_id(model);
+  return id === void 0 ? void 0 : MODEL_PRICES[id];
+}
+function cache_read_multiplier(price) {
+  return price.cache_read_multiplier ?? DEFAULT_CACHE_READ_MULTIPLIER;
 }
 function estimate_cost(totals, price) {
-  const weighted_input = totals.input_tokens + totals.cache_write_5m_tokens * CACHE_WRITE_5M_MULTIPLIER + totals.cache_write_1h_tokens * CACHE_WRITE_1H_MULTIPLIER + totals.cache_read_tokens * CACHE_READ_MULTIPLIER;
+  const weighted_input = totals.input_tokens + totals.cache_write_5m_tokens * CACHE_WRITE_5M_MULTIPLIER + totals.cache_write_1h_tokens * CACHE_WRITE_1H_MULTIPLIER + totals.cache_read_tokens * cache_read_multiplier(price);
   return (weighted_input * price.input + totals.output_tokens * price.output) / TOKENS_PER_MILLION;
 }
 function priced(tokens, rate) {
@@ -542,7 +569,7 @@ function estimate_composition(totals, price) {
       totals.cache_write_1h_tokens * CACHE_WRITE_1H_MULTIPLIER,
       price.input
     ),
-    cache_read_usd: priced(totals.cache_read_tokens * CACHE_READ_MULTIPLIER, price.input),
+    cache_read_usd: priced(totals.cache_read_tokens * cache_read_multiplier(price), price.input),
     output_usd: priced(totals.output_tokens, price.output)
   };
 }
@@ -551,11 +578,17 @@ function to_model_cost(model, totals) {
   if (price === void 0) return { model, totals };
   return { model, totals, cost_usd: estimate_cost(totals, price) };
 }
+function billed_model(usage) {
+  const long_id = `${known_id(usage.model) ?? usage.model}${LONG_PROMPT_SUFFIX}`;
+  const is_long = cost_usage.billed_input(usage.totals) > LONG_PROMPT_THRESHOLD;
+  return is_long && Object.hasOwn(MODEL_PRICES, long_id) ? long_id : usage.model;
+}
 function cost_by_model(records) {
   const grouped = /* @__PURE__ */ new Map();
   for (const record of records) {
-    const running = grouped.get(record.model) ?? cost_usage.EMPTY_TOTALS;
-    grouped.set(record.model, cost_usage.add_totals(running, record.totals));
+    const model = billed_model(record);
+    const running = grouped.get(model) ?? cost_usage.EMPTY_TOTALS;
+    grouped.set(model, cost_usage.add_totals(running, record.totals));
   }
   return [...grouped].map(([model, totals]) => to_model_cost(model, totals));
 }
@@ -571,7 +604,8 @@ function cost_of(records) {
 var cost_pricing = {
   CACHE_WRITE_5M_MULTIPLIER,
   CACHE_WRITE_1H_MULTIPLIER,
-  CACHE_READ_MULTIPLIER,
+  DEFAULT_CACHE_READ_MULTIPLIER,
+  LONG_PROMPT_THRESHOLD,
   resolve_price,
   estimate_cost,
   estimate_composition,
@@ -584,7 +618,7 @@ var cost_pricing = {
 var POST_CUT_CONTEXT = 6e4;
 var EXPECTED_REMAINING_REQUESTS = 10;
 function write_over_read() {
-  return cost_pricing.CACHE_WRITE_5M_MULTIPLIER / cost_pricing.CACHE_READ_MULTIPLIER;
+  return cost_pricing.CACHE_WRITE_5M_MULTIPLIER / cost_pricing.DEFAULT_CACHE_READ_MULTIPLIER;
 }
 function break_even_context(remaining = EXPECTED_REMAINING_REQUESTS) {
   if (remaining <= 0) return Infinity;

package/dist/hooks/{chunk-TLJYAGZK.js → chunk-TORRSNDJ.js}

@@ -6,7 +6,7 @@ import {
   process_owner_schema,
   run_carry,
   time_instant
-} from "./chunk-NZN2UFI6.js";
+} from "./chunk-RW4XMF47.js";
 import {
   PLATFORM_TEMP_ROOT,
   PROBE_TIMEOUT_MS,
@@ -533,7 +533,7 @@ var RUN_COMMANDS = {
     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"]]
+    reference: ["[<issue>]", "automation", ["network", "files"]]
   }
 };
 
@@ -1882,7 +1882,10 @@ var MAINTENANCE_COMMANDS = {
     script: "scripts/version/latest-update.ts",
     description: "Update all dependencies to latest",
     category: "Maintenance",
-    reference: ["", "developer", ["files", "network"]]
+    reference: ["", "developer", ["files", "network"]],
+    // `JOSH_PLAYWRIGHT_BROWSERS` widens the browsers a Playwright bump installs, and a project
+    // keeps that setting in its `.env`.
+    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS
   }
 };
 
@@ -1970,7 +1973,7 @@ var PROJECT_COMMANDS = {
   },
   adopt: {
     script: "scripts/adopt/adopt.ts",
-    description: "Upgrade every installed @joshuafolkken toolkit here and open the pull request",
+    description: "Upgrade the @joshuafolkken toolkits and other dependencies here, open the PR",
     category: "Project",
     reference: ["[--dry-run]", "developer", ["files", "git", "network", "processes"]]
   }
@@ -1996,7 +1999,7 @@ var VERSIONING_COMMANDS = {
   // before chaining here, exactly as it already does for `latest:update`.
   ranges: {
     script: "scripts/version/publishable-range-check.ts",
-    description: "Check that every published dependency range still resolves for a consumer",
+    description: "Check that every published dependency range still resolves for a consumer and no peer range falls below an installed toolkit",
     category: "Versioning",
     reference: ["", "developer", ["network"]]
   },