Skip to content

docs(bench): TTI create-path ladder, one rung per deployed change#902

Open
stubbi wants to merge 1 commit into
mainfrom
docs/tti-create-path-ladder
Open

docs(bench): TTI create-path ladder, one rung per deployed change#902
stubbi wants to merge 1 commit into
mainfrom
docs/tti-create-path-ladder

Conversation

@stubbi

@stubbi stubbi commented Jul 12, 2026

Copy link
Copy Markdown
Contributor

Thinking Path

Linked Issues or Issue Description

Related: #871 (TTI gap tracking), #892 (activate_rpc observation posted there), #901 (the observability gap rung B' surfaced), #896 (rung C's change).

What Changed

  • bench/results/2026-07-12-tti-create-path-ladder.md: the ladder table (A, B, B' at N=100), the honest cancellation analysis, the 4/100 read-timeout finding, and the rung C method.

Verification

  • Every number quotes the harness's own summary output, runs executed from mitos-bench1 with the documented environment (venv httpx 0.28.1; the 2026-07-10 doc's Nagle caveat respected).
  • Server-side claims (activate_rpc 98.2 to 118.8 P50) are computed from the controller's claim stage timing logs for the named windows, per-claim joined.
  • Rung C appended after the v1.41.0 + checkout roll, before merge.

Risks

  • Documentation only. No behavior change.

Model Used

  • Claude Fable 5 (Anthropic), model id claude-fable-5, extended thinking enabled.

Checklist

  • PR title is a conventional commit (feat, fix, docs, ci, chore, refactor, test)
  • Thinking Path traces from project context to this change
  • Model Used is filled in (with version and capability details)
  • Tests added for behavior changes, in the same commit (TDD) (docs only)
  • Docs updated in the same PR (this IS the doc)
  • Threat-model delta included if the security surface moved (it did not)
  • Benchmark run (bench/) included if the hot path was touched (this PR is the benchmark record)
  • No em or en dashes introduced anywhere
  • Secret values never logged, in errors, in condition messages, or on host paths
  • No internal/instance-local references (only public #NNN / mitos-run/mitos URLs)
  • Every commit carries a Signed-off-by trailer (git commit -s)

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation
    • Added a benchmark report for the “TTI create-path ladder” dated July 12, 2026.
    • Documented measurement methods, results across test variants, pending coverage, and target performance goals.
    • Included analysis of observed regressions, timeout behavior, and monitoring limitations.

…analysis

Rung B (v1.40.0) is flat client-side because the #895 gateway cuts and a
+20 ms activate_rpc regression riding the same release cancelled; the
stage-log evidence is on #892. 4/100 client read timeouts are server-side
invisible (#901). Rung C (the pre-claimed checkout roll) lands in this
file next.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Signed-off-by: Jannes Stubbemann <jannes@openclaw.rocks>
@coderabbitai

coderabbitai Bot commented Jul 12, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

Added a 2026-07-12 benchmark report for the “TTI create-path ladder,” covering measurement methodology, rung results, analyses of B and B’, the intended rung C test, and peer-table targets.

Changes

TTI create-path ladder

Layer / File(s) Summary
Benchmark results and analysis
bench/results/2026-07-12-tti-create-path-ladder.md
Adds the ladder results table, measurement approach, rung B cancellation analysis, rung B’ timeout and observability findings, rung C description, and peer context with target P50 goals.

Estimated code review effort: 1 (Trivial) | ~2 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title is concise, conventional, and accurately summarizes the docs-only create-path latency ladder report.
Description check ✅ Passed The description includes the required sections and matches the template's intent, though some sections are brief.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/tti-create-path-ladder

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@bench/results/2026-07-12-tti-create-path-ladder.md`:
- Around line 6-7: Update the rung-isolation description in the benchmark
document to distinguish release rungs, which follow one deployed change, from
repeat measurements such as B′ on the same v1.40.0 deployment. Preserve the
attribution goal while removing the claim that every rung represents a new
deployment.
- Around line 20-21: Update the report text around the reproducibility note to
include the exact harness invocation, or replace “the command above” with an
explicit reference to the command’s documented location. Ensure readers can
determine how to reproduce the per-iteration outputs without relying on an
absent preceding command.
- Around line 13-18: Add millisecond units to the latency column headers in the
benchmark table, including TTI P50, create med, and first exec med. Preserve the
existing measurements and table structure.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: a1b6e019-c72f-414c-93a6-7a28dbc96748

📥 Commits

Reviewing files that changed from the base of the PR and between e349f15 and 69f80c4.

📒 Files selected for processing (1)
  • bench/results/2026-07-12-tti-create-path-ladder.md

Comment on lines +6 to +7
probe, 13 s pacing. Each rung re-measures prod AFTER exactly one deployed
change, so effects attribute to a release instead of to drift. Long runs

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Clarify the rung-isolation claim.

Line 6-7 says every rung follows exactly one deployed change, but rung B′ is a higher-sample rerun of the same v1.40.0 deployment. Reword this to distinguish release rungs from repeat measurements.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@bench/results/2026-07-12-tti-create-path-ladder.md` around lines 6 - 7,
Update the rung-isolation description in the benchmark document to distinguish
release rungs, which follow one deployed change, from repeat measurements such
as B′ on the same v1.40.0 deployment. Preserve the attribution goal while
removing the claim that every rung represents a new deployment.

Comment on lines +13 to +18
| rung | prod version | change under test | N | TTI P50 | create med | first exec med | success |
|---|---|---|---|---|---|---|---|
| A | v1.39.1 | baseline (2026-07-11) | 20 | 327.2 | 189.3 | 136.8 | 20/20 |
| B | v1.40.0 | gateway round-trip cuts (#895) | 20 | 349.0 | 191.4 | 166.4 | 20/20 |
| B' | v1.40.0 | same, higher power | 100 | 349.9 | 190.9 | 163.1 | 96/100 |
| C | v1.41.0 + checkout | pre-claimed checkout (#896) | | pending | | | |

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Add units to the latency columns.

Line 13-18 lists numeric latency values without units. Label the relevant columns as milliseconds (for example, TTI P50 (ms) and create med (ms)) or state the units immediately above the table.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@bench/results/2026-07-12-tti-create-path-ladder.md` around lines 13 - 18, Add
millisecond units to the latency column headers in the benchmark table,
including TTI P50, create med, and first exec med. Preserve the existing
measurements and table structure.

Comment on lines +20 to +21
Full per-iteration outputs for each rung are reproducible with the command
above; the harness prints them and this table quotes its summary lines.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Include the reproducibility command.

Line 20-21 refers to “the command above,” but no command appears above in this report. Add the exact harness invocation or change the text to point explicitly to where that command is documented.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@bench/results/2026-07-12-tti-create-path-ladder.md` around lines 20 - 21,
Update the report text around the reproducibility note to include the exact
harness invocation, or replace “the command above” with an explicit reference to
the command’s documented location. Ensure readers can determine how to reproduce
the per-iteration outputs without relying on an absent preceding command.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant