@hecer/yoke 0.2.0 → 0.8.0

package/bench/.runs/claude-2026-07-09T22-34-01/.yoke/config.yaml

@@ -0,0 +1,6 @@
+canonVersion: 0.1.0
+agents: []
+loop:
+  enabled: true
+verify:
+  command: node bench-verify.mjs

package/bench/.runs/claude-2026-07-09T22-34-01/.yoke/context/DECISIONS.md

@@ -0,0 +1,9 @@
+
+## 2026-07-09 — STORY-1: slugify(text): URL-safe slugs
+claude implemented STORY-1
+
+## 2026-07-09 — STORY-2: truncate(text, max): word-boundary truncation with ellipsis
+claude implemented STORY-2
+
+## 2026-07-09 — STORY-3: titleCase(text): English title casing
+claude implemented STORY-3

package/bench/.runs/claude-2026-07-09T22-34-01/.yoke/prd.yaml

@@ -0,0 +1,38 @@
+- id: STORY-1
+  title: "slugify(text): URL-safe slugs"
+  priority: 1
+  acceptance:
+    - Export `slugify(text)` from src/index.mjs
+    - Lowercases input and joins words with single dashes
+    - "Strips characters that are not alphanumeric, dash, or space (apostrophes
+      vanish: \"What's Up, Doc?\" -> \"whats-up-doc\")"
+    - Collapses runs of spaces/dashes into one dash; trims leading/trailing
+      dashes
+    - Input with no usable characters returns the empty string
+    - node bench-verify.mjs exits 0
+  passes: true
+- id: STORY-2
+  title: "truncate(text, max): word-boundary truncation with ellipsis"
+  priority: 2
+  acceptance:
+    - Export `truncate(text, max)` from src/index.mjs
+    - Strings with length <= max are returned unchanged
+    - Longer strings are cut at a word boundary and end with the single
+      character … (U+2026); result length never exceeds max
+    - If even the first word does not fit, hard-cut mid-word so the result
+      (incl. …) has exactly max characters
+    - max < 1 throws RangeError
+    - node bench-verify.mjs exits 0
+  passes: true
+- id: STORY-3
+  title: "titleCase(text): English title casing"
+  priority: 3
+  acceptance:
+    - Export `titleCase(text)` from src/index.mjs
+    - Capitalizes the first letter of each significant word; rest of each word
+      lowercased (handles ALL-CAPS input)
+    - Small words (a, an, the, and, but, or, for, nor, of, on, in, to, at, by,
+      up) stay lowercase mid-title
+    - The first and the last word are always capitalized, even if small
+    - node bench-verify.mjs exits 0
+  passes: true

package/bench/.runs/claude-2026-07-09T22-34-01/bench-verify.mjs

@@ -0,0 +1,15 @@
+// Cumulative verify: the loop sets YOKE_STORY (e.g. STORY-2); we run the test
+// files for that story AND all earlier ones, so later stories can't break
+// earlier work. Without YOKE_STORY (final quality check), all tests run.
+import { spawnSync } from 'node:child_process'
+
+const TOTAL = 3
+const story = process.env.YOKE_STORY
+const n = story ? Number(story.split('-')[1]) : TOTAL
+const upTo = Number.isFinite(n) && n >= 1 && n <= TOTAL ? n : TOTAL
+
+const files = []
+for (let i = 1; i <= upTo; i++) files.push(`tests/STORY-${i}.test.mjs`)
+
+const r = spawnSync(process.execPath, ['--test', ...files], { stdio: 'inherit' })
+process.exit(r.status ?? 1)

package/bench/.runs/claude-2026-07-09T22-34-01/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "bench-string-kit",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "test": "node bench-verify.mjs"
+  }
+}

package/bench/.runs/claude-2026-07-09T22-34-01/src/index.mjs

@@ -0,0 +1,48 @@
+// Implement the functions required by the PRD stories here (or in modules
+// re-exported from here). Tests import from this file.
+
+export function slugify(text) {
+  return String(text)
+    .toLowerCase()
+    .replace(/[^a-z0-9\s-]/g, '')
+    .replace(/[\s-]+/g, '-')
+    .replace(/^-+|-+$/g, '')
+}
+
+export function truncate(text, max) {
+  if (max < 1) throw new RangeError('max must be >= 1')
+
+  const str = String(text)
+  if (str.length <= max) return str
+
+  const available = max - 1 // reserve one char for the ellipsis
+  const words = str.trim().split(/\s+/)
+
+  let result = ''
+  for (const word of words) {
+    const candidate = result ? `${result} ${word}` : word
+    if (candidate.length <= available) result = candidate
+    else break
+  }
+
+  if (result === '') result = str.slice(0, available) // hard-cut mid-word
+  return `${result}…`
+}
+
+const SMALL_WORDS = new Set([
+  'a', 'an', 'the', 'and', 'but', 'or', 'for', 'nor',
+  'of', 'on', 'in', 'to', 'at', 'by', 'up',
+])
+
+export function titleCase(text) {
+  const words = String(text).trim().split(/\s+/)
+
+  return words
+    .map((word, i) => {
+      const lower = word.toLowerCase()
+      const isEdge = i === 0 || i === words.length - 1
+      if (!isEdge && SMALL_WORDS.has(lower)) return lower
+      return lower.charAt(0).toUpperCase() + lower.slice(1)
+    })
+    .join(' ')
+}

package/bench/.runs/claude-2026-07-09T22-34-01/tests/STORY-1.test.mjs

@@ -0,0 +1,24 @@
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { slugify } from '../src/index.mjs'
+
+test('lowercases and replaces spaces with single dashes', () => {
+  assert.equal(slugify('Hello World'), 'hello-world')
+})
+
+test('strips characters that are not alphanumeric, dash, or space', () => {
+  assert.equal(slugify("What's Up, Doc?"), 'whats-up-doc')
+})
+
+test('collapses runs of spaces/dashes into one dash', () => {
+  assert.equal(slugify('a  --  b'), 'a-b')
+})
+
+test('trims leading/trailing dashes', () => {
+  assert.equal(slugify('  hello  '), 'hello')
+  assert.equal(slugify('-hello-'), 'hello')
+})
+
+test('returns empty string for input with no usable characters', () => {
+  assert.equal(slugify('!!!'), '')
+})

package/bench/.runs/claude-2026-07-09T22-34-01/tests/STORY-2.test.mjs

@@ -0,0 +1,28 @@
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { truncate } from '../src/index.mjs'
+
+test('returns short strings unchanged', () => {
+  assert.equal(truncate('hello', 10), 'hello')
+})
+
+test('string of exactly max length is unchanged', () => {
+  assert.equal(truncate('exact', 5), 'exact')
+})
+
+test('truncates at a word boundary and appends a single ellipsis character', () => {
+  assert.equal(truncate('the quick brown fox', 12), 'the quick…')
+})
+
+test('result length never exceeds max', () => {
+  const out = truncate('the quick brown fox jumps', 10)
+  assert.ok(out.length <= 10, `expected <= 10, got ${out.length}: "${out}"`)
+})
+
+test('falls back to a hard cut when the first word is longer than max', () => {
+  assert.equal(truncate('extraordinary', 6), 'extra…')
+})
+
+test('throws RangeError for max < 1', () => {
+  assert.throws(() => truncate('x', 0), RangeError)
+})

package/bench/.runs/claude-2026-07-09T22-34-01/tests/STORY-3.test.mjs

@@ -0,0 +1,25 @@
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { titleCase } from '../src/index.mjs'
+
+test('capitalizes each significant word', () => {
+  assert.equal(titleCase('the quick brown fox'), 'The Quick Brown Fox')
+})
+
+test('keeps small words lowercase mid-title', () => {
+  assert.equal(titleCase('a tale of two cities'), 'A Tale of Two Cities')
+  assert.equal(titleCase('war and peace'), 'War and Peace')
+})
+
+test('always capitalizes the first and last word, even small ones', () => {
+  assert.equal(titleCase('of mice and men'), 'Of Mice and Men')
+  assert.equal(titleCase('what dreams may come to'), 'What Dreams May Come To')
+})
+
+test('normalizes ALL-CAPS input', () => {
+  assert.equal(titleCase('THE GREAT GATSBY'), 'The Great Gatsby')
+})
+
+test('single word is capitalized', () => {
+  assert.equal(titleCase('dune'), 'Dune')
+})

package/bench/.runs/gemini-2026-07-09T22-34-02/.yoke/config.yaml

@@ -0,0 +1,6 @@
+canonVersion: 0.1.0
+agents: []
+loop:
+  enabled: true
+verify:
+  command: node bench-verify.mjs

package/bench/.runs/gemini-2026-07-09T22-34-02/.yoke/prd.yaml

@@ -0,0 +1,32 @@
+- id: STORY-1
+  title: "slugify(text): URL-safe slugs"
+  priority: 1
+  acceptance:
+    - "Export `slugify(text)` from src/index.mjs"
+    - "Lowercases input and joins words with single dashes"
+    - "Strips characters that are not alphanumeric, dash, or space (apostrophes vanish: \"What's Up, Doc?\" -> \"whats-up-doc\")"
+    - "Collapses runs of spaces/dashes into one dash; trims leading/trailing dashes"
+    - "Input with no usable characters returns the empty string"
+    - "node bench-verify.mjs exits 0"
+  passes: false
+- id: STORY-2
+  title: "truncate(text, max): word-boundary truncation with ellipsis"
+  priority: 2
+  acceptance:
+    - "Export `truncate(text, max)` from src/index.mjs"
+    - "Strings with length <= max are returned unchanged"
+    - "Longer strings are cut at a word boundary and end with the single character … (U+2026); result length never exceeds max"
+    - "If even the first word does not fit, hard-cut mid-word so the result (incl. …) has exactly max characters"
+    - "max < 1 throws RangeError"
+    - "node bench-verify.mjs exits 0"
+  passes: false
+- id: STORY-3
+  title: "titleCase(text): English title casing"
+  priority: 3
+  acceptance:
+    - "Export `titleCase(text)` from src/index.mjs"
+    - "Capitalizes the first letter of each significant word; rest of each word lowercased (handles ALL-CAPS input)"
+    - "Small words (a, an, the, and, but, or, for, nor, of, on, in, to, at, by, up) stay lowercase mid-title"
+    - "The first and the last word are always capitalized, even if small"
+    - "node bench-verify.mjs exits 0"
+  passes: false

package/bench/.runs/gemini-2026-07-09T22-34-02/bench-verify.mjs

@@ -0,0 +1,15 @@
+// Cumulative verify: the loop sets YOKE_STORY (e.g. STORY-2); we run the test
+// files for that story AND all earlier ones, so later stories can't break
+// earlier work. Without YOKE_STORY (final quality check), all tests run.
+import { spawnSync } from 'node:child_process'
+
+const TOTAL = 3
+const story = process.env.YOKE_STORY
+const n = story ? Number(story.split('-')[1]) : TOTAL
+const upTo = Number.isFinite(n) && n >= 1 && n <= TOTAL ? n : TOTAL
+
+const files = []
+for (let i = 1; i <= upTo; i++) files.push(`tests/STORY-${i}.test.mjs`)
+
+const r = spawnSync(process.execPath, ['--test', ...files], { stdio: 'inherit' })
+process.exit(r.status ?? 1)

package/bench/.runs/gemini-2026-07-09T22-34-02/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "bench-string-kit",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "test": "node bench-verify.mjs"
+  }
+}

package/bench/.runs/gemini-2026-07-09T22-34-02/src/index.mjs

@@ -0,0 +1,3 @@
+// Implement the functions required by the PRD stories here (or in modules
+// re-exported from here). Tests import from this file.
+export {}

package/bench/.runs/gemini-2026-07-09T22-34-02/tests/STORY-1.test.mjs

@@ -0,0 +1,24 @@
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { slugify } from '../src/index.mjs'
+
+test('lowercases and replaces spaces with single dashes', () => {
+  assert.equal(slugify('Hello World'), 'hello-world')
+})
+
+test('strips characters that are not alphanumeric, dash, or space', () => {
+  assert.equal(slugify("What's Up, Doc?"), 'whats-up-doc')
+})
+
+test('collapses runs of spaces/dashes into one dash', () => {
+  assert.equal(slugify('a  --  b'), 'a-b')
+})
+
+test('trims leading/trailing dashes', () => {
+  assert.equal(slugify('  hello  '), 'hello')
+  assert.equal(slugify('-hello-'), 'hello')
+})
+
+test('returns empty string for input with no usable characters', () => {
+  assert.equal(slugify('!!!'), '')
+})

package/bench/.runs/gemini-2026-07-09T22-34-02/tests/STORY-2.test.mjs

@@ -0,0 +1,28 @@
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { truncate } from '../src/index.mjs'
+
+test('returns short strings unchanged', () => {
+  assert.equal(truncate('hello', 10), 'hello')
+})
+
+test('string of exactly max length is unchanged', () => {
+  assert.equal(truncate('exact', 5), 'exact')
+})
+
+test('truncates at a word boundary and appends a single ellipsis character', () => {
+  assert.equal(truncate('the quick brown fox', 12), 'the quick…')
+})
+
+test('result length never exceeds max', () => {
+  const out = truncate('the quick brown fox jumps', 10)
+  assert.ok(out.length <= 10, `expected <= 10, got ${out.length}: "${out}"`)
+})
+
+test('falls back to a hard cut when the first word is longer than max', () => {
+  assert.equal(truncate('extraordinary', 6), 'extra…')
+})
+
+test('throws RangeError for max < 1', () => {
+  assert.throws(() => truncate('x', 0), RangeError)
+})

package/bench/.runs/gemini-2026-07-09T22-34-02/tests/STORY-3.test.mjs

@@ -0,0 +1,25 @@
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { titleCase } from '../src/index.mjs'
+
+test('capitalizes each significant word', () => {
+  assert.equal(titleCase('the quick brown fox'), 'The Quick Brown Fox')
+})
+
+test('keeps small words lowercase mid-title', () => {
+  assert.equal(titleCase('a tale of two cities'), 'A Tale of Two Cities')
+  assert.equal(titleCase('war and peace'), 'War and Peace')
+})
+
+test('always capitalizes the first and last word, even small ones', () => {
+  assert.equal(titleCase('of mice and men'), 'Of Mice and Men')
+  assert.equal(titleCase('what dreams may come to'), 'What Dreams May Come To')
+})
+
+test('normalizes ALL-CAPS input', () => {
+  assert.equal(titleCase('THE GREAT GATSBY'), 'The Great Gatsby')
+})
+
+test('single word is capitalized', () => {
+  assert.equal(titleCase('dune'), 'Dune')
+})

package/bench/README.md

@@ -0,0 +1,42 @@
+# Yoke benchmark — tokens · speed · quality
+
+Reproducible cross-runner benchmark for the Yoke loop. One fixed fixture project, the same
+PRD for every runner, three measured dimensions:
+
+| Dimension | How it is measured |
+|---|---|
+| **Tokens** | The loop's own token hook (`.yoke/loop-status.json`, claude runner via `--output-format stream-json`; model id included). Gemini/Codex runners do not report usage yet — recorded as `null`, a documented gap. |
+| **Speed** | Wall-clock, measured by the harness from outside: total run + per-story (from `--json` NDJSON event timestamps). The loop itself stores no durations. |
+| **Quality** | Objective, not judged by any model: the fixture ships **pre-written tests** the agent never has to write (only satisfy). After the run, each story's test file is executed against the final tree. `srcLoc` (non-empty lines in `src/`) is a code-economy proxy. |
+
+## The fixture (`fixtures/string-kit`)
+
+A dependency-free ESM library with 3 stories (`slugify`, `truncate`, `titleCase`) and 16
+`node:test` assertions total. `bench-verify.mjs` is cumulative: story N runs the tests of
+stories 1…N (the loop exports `YOKE_STORY`), so later stories cannot break earlier work; the
+final quality check runs everything. No npm installs, so results measure the agent — not the
+network.
+
+## Running it
+
+```bash
+npm run build
+node bench/run.mjs --runner=claude   # or gemini / codex
+```
+
+Each run copies the fixture to `bench/.runs/<runner>-<stamp>` (git-ignored), git-inits it,
+drives `yoke loop run --json --max=6 --timeout=10`, and writes a result JSON to
+`bench/results/`. Runs are billed against your own accounts for the agent CLIs involved.
+
+## Caveats (read before quoting numbers)
+
+- **N=1 per run.** Agent runs are stochastic; treat single runs as indicative, not
+  statistically robust. Re-run and compare.
+- Model identity matters more than CLI identity: `tokens.model` records what actually served
+  the run. Different default models per CLI make "claude vs gemini" really "model X vs model Y".
+- The fixture is deliberately small (a loop-overhead + basic-competence probe, minutes not
+  hours). It does not measure large-context refactoring, UI work, or long-horizon planning.
+- Cumulative verify means a story's duration includes fixing any regressions it caused.
+
+Results live in [`results/`](results/) — one JSON per run, summarized in
+[`RESULTS.md`](RESULTS.md).

package/bench/RESULTS.md

@@ -0,0 +1,36 @@
+# Benchmark results
+
+Fixture `string-kit` (3 stories, 16 pre-written assertions). Methodology and caveats:
+[README.md](README.md). One row per run — raw JSON in [`results/`](results/).
+
+## Runs
+
+| Date | Runner | Model (reported) | Result | Wall-clock | Input tok | Output tok | First-pass stories | src LOC |
+|---|---|---|---|---|---|---|---|---|
+| 2026-07-10 | claude | claude-opus-4-8 | ✅ 3/3 complete | 4 m 28 s | 42 957 | 9 817 | 3/3 (1 iteration each) | 39 |
+| 2026-07-10 | gemini | — | ⛔ blocked: CLI not authenticated on the bench machine (headless needs `GEMINI_API_KEY` or configured OAuth) | — | — | — | — | — |
+| — | codex | — | ⛔ not installed on the bench machine | — | — | — | — | — |
+
+Per-story wall-clock (claude run): STORY-1 72 s · STORY-2 114 s · STORY-3 81 s. Every story
+passed verify on the first iteration; the final quality check (all 16 assertions on the final
+tree, outside the loop) is green.
+
+## What the harness caught before producing a single number
+
+Building an honest benchmark is itself a verification pass. The first runs found two real
+Yoke bugs, both fixed in 0.3.0:
+
+1. **Availability-probe timeout** — `gemini --version` cold-starts in ~5.8 s on Windows; the
+   5 s probe timeout misreported an installed CLI as "not found on PATH". Now 20 s.
+2. **Gemini invocation** — Gemini CLI 0.33+ requires a value after `-p`; the runner's bare
+   `-p --yolo` died with "Not enough arguments following: p". The runner now relies on piped
+   stdin (which selects headless mode) and passes only `--yolo`.
+
+## Reading the numbers
+
+- Tokens come from the loop's own hook (claude runner only — gemini/codex reporting is an
+  open gap, see the multi-agent design doc).
+- N=1: indicative, not statistics. Re-run with `node bench/run.mjs --runner=<agent>` and
+  compare rows.
+- ~53 k tokens / ~4.5 minutes for a 3-story micro-backlog is the current price of the full
+  gate pipeline (fresh headless session per story + verify + atomic commit) on this fixture.

package/bench/fixtures/string-kit/.yoke/config.yaml

@@ -0,0 +1,6 @@
+canonVersion: 0.1.0
+agents: []
+loop:
+  enabled: true
+verify:
+  command: node bench-verify.mjs

package/bench/fixtures/string-kit/.yoke/prd.yaml

@@ -0,0 +1,32 @@
+- id: STORY-1
+  title: "slugify(text): URL-safe slugs"
+  priority: 1
+  acceptance:
+    - "Export `slugify(text)` from src/index.mjs"
+    - "Lowercases input and joins words with single dashes"
+    - "Strips characters that are not alphanumeric, dash, or space (apostrophes vanish: \"What's Up, Doc?\" -> \"whats-up-doc\")"
+    - "Collapses runs of spaces/dashes into one dash; trims leading/trailing dashes"
+    - "Input with no usable characters returns the empty string"
+    - "node bench-verify.mjs exits 0"
+  passes: false
+- id: STORY-2
+  title: "truncate(text, max): word-boundary truncation with ellipsis"
+  priority: 2
+  acceptance:
+    - "Export `truncate(text, max)` from src/index.mjs"
+    - "Strings with length <= max are returned unchanged"
+    - "Longer strings are cut at a word boundary and end with the single character … (U+2026); result length never exceeds max"
+    - "If even the first word does not fit, hard-cut mid-word so the result (incl. …) has exactly max characters"
+    - "max < 1 throws RangeError"
+    - "node bench-verify.mjs exits 0"
+  passes: false
+- id: STORY-3
+  title: "titleCase(text): English title casing"
+  priority: 3
+  acceptance:
+    - "Export `titleCase(text)` from src/index.mjs"
+    - "Capitalizes the first letter of each significant word; rest of each word lowercased (handles ALL-CAPS input)"
+    - "Small words (a, an, the, and, but, or, for, nor, of, on, in, to, at, by, up) stay lowercase mid-title"
+    - "The first and the last word are always capitalized, even if small"
+    - "node bench-verify.mjs exits 0"
+  passes: false

package/bench/fixtures/string-kit/bench-verify.mjs

@@ -0,0 +1,15 @@
+// Cumulative verify: the loop sets YOKE_STORY (e.g. STORY-2); we run the test
+// files for that story AND all earlier ones, so later stories can't break
+// earlier work. Without YOKE_STORY (final quality check), all tests run.
+import { spawnSync } from 'node:child_process'
+
+const TOTAL = 3
+const story = process.env.YOKE_STORY
+const n = story ? Number(story.split('-')[1]) : TOTAL
+const upTo = Number.isFinite(n) && n >= 1 && n <= TOTAL ? n : TOTAL
+
+const files = []
+for (let i = 1; i <= upTo; i++) files.push(`tests/STORY-${i}.test.mjs`)
+
+const r = spawnSync(process.execPath, ['--test', ...files], { stdio: 'inherit' })
+process.exit(r.status ?? 1)

package/bench/fixtures/string-kit/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "bench-string-kit",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "test": "node bench-verify.mjs"
+  }
+}

package/bench/fixtures/string-kit/src/index.mjs

@@ -0,0 +1,3 @@
+// Implement the functions required by the PRD stories here (or in modules
+// re-exported from here). Tests import from this file.
+export {}

package/bench/fixtures/string-kit/tests/STORY-1.test.mjs

@@ -0,0 +1,24 @@
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { slugify } from '../src/index.mjs'
+
+test('lowercases and replaces spaces with single dashes', () => {
+  assert.equal(slugify('Hello World'), 'hello-world')
+})
+
+test('strips characters that are not alphanumeric, dash, or space', () => {
+  assert.equal(slugify("What's Up, Doc?"), 'whats-up-doc')
+})
+
+test('collapses runs of spaces/dashes into one dash', () => {
+  assert.equal(slugify('a  --  b'), 'a-b')
+})
+
+test('trims leading/trailing dashes', () => {
+  assert.equal(slugify('  hello  '), 'hello')
+  assert.equal(slugify('-hello-'), 'hello')
+})
+
+test('returns empty string for input with no usable characters', () => {
+  assert.equal(slugify('!!!'), '')
+})

package/bench/fixtures/string-kit/tests/STORY-2.test.mjs

@@ -0,0 +1,28 @@
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { truncate } from '../src/index.mjs'
+
+test('returns short strings unchanged', () => {
+  assert.equal(truncate('hello', 10), 'hello')
+})
+
+test('string of exactly max length is unchanged', () => {
+  assert.equal(truncate('exact', 5), 'exact')
+})
+
+test('truncates at a word boundary and appends a single ellipsis character', () => {
+  assert.equal(truncate('the quick brown fox', 12), 'the quick…')
+})
+
+test('result length never exceeds max', () => {
+  const out = truncate('the quick brown fox jumps', 10)
+  assert.ok(out.length <= 10, `expected <= 10, got ${out.length}: "${out}"`)
+})
+
+test('falls back to a hard cut when the first word is longer than max', () => {
+  assert.equal(truncate('extraordinary', 6), 'extra…')
+})
+
+test('throws RangeError for max < 1', () => {
+  assert.throws(() => truncate('x', 0), RangeError)
+})

package/bench/fixtures/string-kit/tests/STORY-3.test.mjs

@@ -0,0 +1,25 @@
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { titleCase } from '../src/index.mjs'
+
+test('capitalizes each significant word', () => {
+  assert.equal(titleCase('the quick brown fox'), 'The Quick Brown Fox')
+})
+
+test('keeps small words lowercase mid-title', () => {
+  assert.equal(titleCase('a tale of two cities'), 'A Tale of Two Cities')
+  assert.equal(titleCase('war and peace'), 'War and Peace')
+})
+
+test('always capitalizes the first and last word, even small ones', () => {
+  assert.equal(titleCase('of mice and men'), 'Of Mice and Men')
+  assert.equal(titleCase('what dreams may come to'), 'What Dreams May Come To')
+})
+
+test('normalizes ALL-CAPS input', () => {
+  assert.equal(titleCase('THE GREAT GATSBY'), 'The Great Gatsby')
+})
+
+test('single word is capitalized', () => {
+  assert.equal(titleCase('dune'), 'Dune')
+})

package/bench/results/claude-2026-07-09T22-34-01.json

@@ -0,0 +1,40 @@
+{
+  "runner": "claude",
+  "label": null,
+  "yokeVersion": "0.3.0",
+  "fixture": "string-kit",
+  "startedAt": "2026-07-09T22:34:02.042Z",
+  "wallClockMs": 268351,
+  "exitCode": 0,
+  "finalState": "complete",
+  "progress": {
+    "passed": 3,
+    "total": 3
+  },
+  "tokens": {
+    "inputTokens": 42957,
+    "outputTokens": 9817,
+    "model": "claude-opus-4-8"
+  },
+  "stories": [
+    {
+      "id": "STORY-1",
+      "durationMs": 72246,
+      "iterations": 1,
+      "finalTestsPass": true
+    },
+    {
+      "id": "STORY-2",
+      "durationMs": 114239,
+      "iterations": 1,
+      "finalTestsPass": true
+    },
+    {
+      "id": "STORY-3",
+      "durationMs": 81328,
+      "iterations": 1,
+      "finalTestsPass": true
+    }
+  ],
+  "srcLoc": 39
+}