Skip to content

docs(devlog): record the triage gap closure and the review round - #3482

Merged
lidge-jun merged 1 commit into
devfrom
codex/260904-triage-closure-record
Sep 4, 2026
Merged

docs(devlog): record the triage gap closure and the review round#3482
lidge-jun merged 1 commit into
devfrom
codex/260904-triage-closure-record

Conversation

@lidge-jun

@lidge-jun lidge-jun commented Sep 4, 2026

Copy link
Copy Markdown
Owner

Summary

Closes out devlog/_plan/260904_triage_gap_closure with what shipped and the landing SHAs. PR #3478 (3a9c4d297) carried all three gaps; #3293, #3431 and #3429 are closed citing it.

The part worth keeping is the review round. The first Ultra Fast implementation passed every suite and was wrong: recognising ultrafast as a canonical marker routed it into decideTier's canonicalToWire lookup, which maps only priority, so an unmapped canonical fell through to drop and the tier stopped reaching the provider — where previously, as a foreign tier, it was forwarded verbatim. Recognition made the reported problem worse.

Every listed suite stayed green because they unit-tested the two edited functions in isolation and never asserted the wire decision, and the byte golden pins catalog bytes rather than the caller routing path. Two lessons recorded: a test of the functions you edited is not a test of the behavior you changed, and widening a predicate that serves three questions silently changes the other two.

It also records what was deliberately not done — Ultra Fast is still absent from the model picker, because upstream advertises only priority and a catalog row would offer a speed the wire cannot deliver, which is exactly what PR #2994 was closed for.

Verification

Checklist

  • Scope stays focused and avoids unrelated cleanup.
  • Docs or release notes were updated when needed.
  • Security-sensitive changes were reviewed for secrets, auth, and unsafe defaults.

Devlog prose only — no auth, credential, workflow, or release surface.

Summary by CodeRabbit

  • Documentation
    • Updated project planning records to document the delivery status of recent triage items.
    • Added a delivery note covering metadata, credits, and Ultra Fast tier changes.
    • Clarified which portions of the Ultra Fast work were delivered and documented related non-goals and limitations.
    • Recorded the associated issue closures and delivery references.

@lidge-jun
lidge-jun requested a review from Ingwannu as a code owner September 4, 2026 15:37
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Sep 4, 2026

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review Completed 2026-09-04T15:39:32.373903Z 427b87d PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@github-actions github-actions Bot added the intake: hygiene-blocked Deterministic PR hygiene checks failed label Sep 4, 2026
@github-actions

github-actions Bot commented Sep 4, 2026

Copy link
Copy Markdown
Contributor

⚠️ Deterministic hygiene checks failed.

  • missing_coauthor_credit — This pull request says it reimplements, supersedes, carries, or rebases another author's pull request, but no Co-authored-by trailer names that author. Prose in a commit body is not read by anything; the trailer is what GitHub counts. Add it to the description or a commit, or obtain attribution-approved. Paths: #3293.

@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Sep 4, 2026
@github-actions

github-actions Bot commented Sep 4, 2026

Copy link
Copy Markdown
Contributor

✅ READY

  • all PR quality gates passed.

Hygiene

Deterministic PR hygiene checks passed.

@github-actions
github-actions Bot marked this pull request as draft September 4, 2026 15:37
@coderabbitai

coderabbitai Bot commented Sep 4, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

  • Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Team

Run ID: a72bfc43-e486-47d2-9f53-bd829f68014f

📥 Commits

Reviewing files that changed from the base of the PR and between 3a9c4d2 and 427b87d.

📒 Files selected for processing (3)
  • devlog/_plan/260904_triage_gap_closure/020_credits_3284.md
  • devlog/_plan/260904_triage_gap_closure/030_ultrafast_optin.md
  • devlog/_plan/260904_triage_gap_closure/040_delivery_record.md

Included review availability: Your plan provides up to 10 included reviews per hour; 1 remains after this review.


📝 Walkthrough

Walkthrough

The pull request adds planning documentation for three triage-gap closures. It records commit 3a9c4d297, explains the Ultra Fast routing correction, documents non-goals, and links the related plan close-outs to the delivery record.

Changes

Triage gap closure records

Layer / File(s) Summary
Delivery record and implementation notes
devlog/_plan/260904_triage_gap_closure/040_delivery_record.md
Adds the completed delivery record, merge evidence, Ultra Fast routing retrospective, deliberate non-goals, implementation locations, and validation results.
Plan close-out references
devlog/_plan/260904_triage_gap_closure/020_credits_3284.md, devlog/_plan/260904_triage_gap_closure/030_ultrafast_optin.md
Links the CREDITS and Ultra Fast plans to the delivery record and records their issue close-outs.

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

Merge Risk: ⚪ Minimal · up to 427b8

This change records completed triage-gap work and close-out references without modifying runtime behavior. No current merge-blocking risk remains.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately identifies the documentation change and its focus on recording the triage gap closure and review round. It is concise, specific, and consistent with the documentation-only changes…
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
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 💡 1
🛠️ Fix failing CI checks 💡
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch codex/260904-triage-closure-record

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

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

@chatgpt-codex-connector chatgpt-codex-connector 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.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 427b87d6d9

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +3 to +4
Terminal outcome: **DONE**. All three gaps closed on `origin/dev` via PR #3478,
merged as `3a9c4d297` and ancestry-proven.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Move the completed unit out of _plan

This record declares the unit terminal and fully delivered, but the entire unit remains under devlog/_plan, where repository convention reserves entries for open work. Keeping a completed unit there makes plan inventories and future triage treat it as unresolved; move 260904_triage_gap_closure to devlog/_fin as part of this closeout.

AGENTS.md reference: AGENTS.md:L83-L86

Useful? React with 👍 / 👎.

Closes out devlog/_plan/260904_triage_gap_closure with what actually shipped and
the landing SHAs: PR #3478 (3a9c4d2) carried all three gaps, and #3293, #3431
and #3429 are closed citing it.

The part worth keeping is the review round. The first Ultra Fast implementation
passed every suite and was wrong: recognising ultrafast as a canonical marker
routed it into decideTier's canonicalToWire lookup, which maps only priority, so
an unmapped canonical fell through to drop and the tier stopped reaching the
provider — where previously, as a foreign tier, it was forwarded verbatim.
Recognition made the reported problem worse.

Every listed suite stayed green because they unit-tested the two edited functions
in isolation and never asserted the wire decision, and the byte golden pins
catalog bytes rather than the caller routing path. Two lessons recorded: a test
of the functions you edited is not a test of the behavior you changed, and
widening a predicate that serves three questions silently changes the other two.

Also records what was deliberately NOT done — Ultra Fast is still absent from the
model picker, because upstream advertises only priority and a catalog row would
offer a speed the wire cannot deliver, which is what PR #2994 was closed for.

This document describes carried work whose code already landed in #3478 with the
trailer. Repeating it here keeps the contributor graph correct for a body that
names #3293 as carried.

Co-authored-by: wj <wj@nas-backup>
@lidge-jun
lidge-jun force-pushed the codex/260904-triage-closure-record branch from 427b87d to 679abb6 Compare September 4, 2026 15:42
@github-actions github-actions Bot removed the intake: hygiene-blocked Deterministic PR hygiene checks failed label Sep 4, 2026
@github-actions
github-actions Bot marked this pull request as ready for review September 4, 2026 15:42
@lidge-jun
lidge-jun merged commit 0661469 into dev Sep 4, 2026
17 checks passed
@lidge-jun
lidge-jun deleted the codex/260904-triage-closure-record branch September 4, 2026 15:43
@lidge-jun

Copy link
Copy Markdown
Owner Author

리뷰 · 우선순위 38 / 80

이 PR은 코드가 아니라 기록입니다. 이미 dev에 합쳐진 PR #3478(3a9c4d297)이 닫아 둔 세 가지 triage gap(fable-5-1 메타데이터 #3293, CREDITS의 #3284/#3431, Ultra Fast opt-in #3429)을 devlog/_plan/260904_triage_gap_closure/ 아래에 마무리로 적어 둡니다. 020·030 파일에 Landed 배너를 붙이고, 새 파일 040_delivery_record.md에 무엇을 실었는지·무엇을 일부러 안 했는지·리뷰에서 무엇이 잘못됐는지를 길게 남깁니다.

지금 dev HEAD(3a9c4d297)는 그 #3478 자체입니다. 그래서 이 PR이 고치는 런타임 동작은 없습니다. 다만 문서가 맞아야 나중에 같은 함정을 다시 밟지 않습니다. 040이 말하는 Ultra Fast 첫 구현의 실수(canonical로 인식만 하고 decideTiercanonicalToWire에는 priority만 있어서 drop으로 떨어진 일, foreignCallerTiers: "verbatim"일 때보다 나빠짐)는 현재 src/providers/fastwire.ts의 주석·분기와 맞습니다. canonicalFastTierMarkerultrafast를 인정하고, decideTier는 매핑 없으면 foreign 규칙으로 떨어지고, drop/억제용 callerCanonicalFast=== "priority"로 남아 있습니다. src/codex/catalog/parsing.tsretainOnlyUltraFastTier / ultraFastTierOptIn, src/server/request-log.tsultrafast 라벨, gui/src/components/UltraFastTierSetting.tsx, tests/ultrafast-tier-honesty.test.ts도 HEAD에 있습니다. 피커에 Ultra Fast 행을 안 넣는 판단(#2994)도 현재 방향과 같습니다.

그래도 이 PR만으로는 아직 merge 준비가 아닙니다. 게이트가 draft로 잠가 둔 이유가 있고, CREDITS 인용 주체가 문서와 파일이 서로 다릅니다. 문서만의 PR이라도 “누가 말했는지”가 틀리면 나중에 CREDITS를 읽는 사람이 잘못된 기여자를 따라갑니다.

라인 020_credits_3284.md Close-out Done 줄 - @Ingwannu의 말을 인용했다고 적었지만, 지금 CREDITS.md#3284 행 작성자는 @mdwsk88이고 인용문도 그 PR 맥락입니다. Ingwannu가 아닙니다.

경로 040_delivery_record.md CREDITS 표 셀 - “quoting @Ingwannu verbatim”도 같은 오류입니다. HEAD의 CREDITS.md#3284@mdwsk88 / 3d3c4fe26입니다.

경로 010_fable_metadata.md - 020·030에는 Landed 배너가 생겼는데 wp1(fable) 쪽 010에는 없습니다. 세 gap이 같은 SHA로 끝났다고 040이 말한다면 010에도 같은 한 줄이 있어야 기록이 균일합니다.

경로 PR 본문·커밋이 #3293을 carry/재구현으로 언급 - hygiene missing_coauthor_credit가 걸렸고 작성자 Veritas-7용 Co-authored-by 또는 attribution-approved가 없습니다. 문서 전용 PR이 “이미 합쳐진 #3478을 기록한다”만 분명히 하면 트리거를 피할 수 있고, carry 언어를 유지하려면 트레일러가 필요합니다.

메인테이너의 판단이 필요한 지점

너의 추천
Ingwannu→mdwsk88 정정과 010 Landed 한 줄을 같은 커밋에 넣고, hygiene는 “#3478 delivery record”로 문장을 좁혀 draft를 푼 다음 dev에 merge하세요. 런타임 변경이 없으니 그 두 사실 오류만 잡으면 됩니다.

이 댓글은 grok-bot이 작성했습니다

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

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant