Skip to content

docs: correct runtime attribution and record coverage evidence - #984

Draft
seonghobae wants to merge 80 commits into
codex/e2e-auth-redirect-main-20260908from
codex/gap-baseline-20260908
Draft

docs: correct runtime attribution and record coverage evidence#984
seonghobae wants to merge 80 commits into
codex/e2e-auth-redirect-main-20260908from
codex/gap-baseline-20260908

Conversation

@seonghobae

@seonghobae seonghobae commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

Scope

Record revision-scoped runtime, frontend, PostgreSQL, browser, coverage, and failure-diagnosis evidence without turning supporting evidence into a new architecture, owner, or release decision. Keep service-port attribution, synthetic/focused checks, hosted results, translation-consumer failures, and all-page runtime acceptance distinct.

Current exact authority

  • parent/source owner: PR fix: verify dashboard accessibility and enforce frontend coverage #983 codex/e2e-auth-redirect-main-20260908@59055dcdf1c38152bfbc3359cbed4e3af6806d52
  • current child head: codex/gap-baseline-20260908@cae6d2bdd07c5ab6eb74e83dd04e86c879b4a98f
  • protected release base: main@83eba56149eb802cd63642c507c324c9976ec78e
  • state: open / Draft; parent validation remains authoritative

Fresh parent→child compare is ahead-only / behind 0 with merge base exactly 59055dcd.... Effective child paths remain only AGENTS.md and docs/product-technical-gap-baseline.md; the parent product/test tree, including WorkspaceCalendar.emptyStateCoverage.test.tsx, is inherited and not reverted.

Parent progression and exact evidence

Current parent 59055dcd... adds only a test-only Calendar regression for the accepted-source empty state: naruon_available=true, events=[], commitments=[]. Exact frontend verification is now terminal for that bounded slice: Tests 34314379985, frontend job 102347417265, ran 75 files / 731 tests GREEN; lint, production build, and Storybook build are GREEN. The frontend job remains RED only at the unchanged repository-wide 100% coverage threshold. Exact totals are 93.64% statements / 83.67% branches / 93.12% functions / 95.49% lines; WorkspaceCalendar.tsx is 100% lines/functions and 73.68% branches. Artifact 10089635441, digest sha256:1b1c053d8cb24b3a7b1ae13e7d7c365914c98862ef2395b857ad16cecbedabfd, is retained.

Parent PostgreSQL full-suite job 102347417455 is still executing on this exact head, so the parent remains fixed. Current Security/SAST/CodeQL also have not reached terminal acceptance. No predecessor receipt transfers.

Parent review has additionally verified three repairs that must occur on #983 before this documentation child is moved again: ADR 0165 must document the implementation's optional ASCII caret-exponent sign; intentional Arabic-Indic mixed-script test strings must satisfy Ruff RUF001 without weakening lint; and Ontology Explorer export-test timers/mocks/globals must be reset in afterEach so assertion failures cannot contaminate later tests. These are parent owner repairs, not documentation-child substitutions.

Descendant convergence

After #983 advanced, this branch was reconstructed non-force from exact 59055dcd... while overlaying only the then-live child-owned AGENTS.md and baseline blobs. Ordinary two-parent commit cae6d2bdd07c5ab6eb74e83dd04e86c879b4a98f has prior child 6409a082... and exact new parent 59055dcd... as parents. Fresh compare remains behind 0 with merge base exactly 59055dcd...; effective delta is only the two documentation paths. No force push, destructive rebase, or parent loss occurred.

Documentation review state

Older findings remain repaired: PR #929 also contains that import change. is prose rather than an accidental Markdown heading, and 20 ms is identified only as the CWL engineering/diagnostic target, explicitly not authenticated-page/render/k6 evidence or an approved LineageWeave deployment SLO.

Two structure findings remain open until the file itself is repaired without losing historical evidence:

  • September 8 diagnostics are still scoped as ### beneath ## 12. Delivery snapshot (2026-08-27) and must be promoted/moved to a current-evidence ## scope.
  • ## Frontend coverage evidence — 2026-09-08 contains September 9 exact-head evidence and needs a truthful date range or separate September 9 top-level section.

Do not close those findings from prose alone. The baseline is a large historical evidence ledger; any repair must preserve historical content except for the necessary heading/date edits rather than regenerate or truncate the file through an unsafe whole-file rewrite.

Security / merge gate

Consumer evidence remains forwarded to canonical owner lanes .github#1725 and .github#2040; no leaf-local scanner/status replacement, synthetic receipt, provider/model pin, or waiver is accepted. Keep this child Draft while #983 continues exact-head product validation. After parent acceptance, this child still requires its own final-head checks/reviews before promotion. No self-approval, bypass, reduced production-code coverage denominator, stale-head evidence transfer, force-push, destructive rebase, canonical-owner duplication, or release claim is authorized.

@coderabbitai

coderabbitai Bot commented Sep 8, 2026

Copy link
Copy Markdown

Review Change StackReview 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
📝 Walkthrough

Walkthrough

로컬 엔드포인트 측정 규칙과 시스템 관측 결과를 추가했습니다. UI, API, mock, 커버리지, 숫자 지수 렌더링의 검증 결과와 테스트 진단 기준도 기록했습니다.

Changes

런타임 측정 및 검증

Layer / File(s) Summary
측정 규칙과 시스템 관측
AGENTS.md, docs/product-technical-gap-baseline.md
서비스 포트, 요청·실패·타임아웃 기록, 측정 범위, CPU 및 pressure 지표 규칙을 정의했습니다. 컨테이너 내부와 호스트의 지연 및 실행 결과를 기록했습니다.
UI 및 API 검증 기준
AGENTS.md, docs/product-technical-gap-baseline.md
Storybook 키보드 검증, API URL 계약, 성공 응답 디코딩, 4xx 오류 처리, 대시보드 검증 결과를 기록했습니다.
테스트 격리와 커버리지 진단
AGENTS.md, docs/product-technical-gap-baseline.md
mock 리셋, 실패 시 커버리지 보고서 보존, worker 시작 오류, 테스트 분모, PostgreSQL 및 호스티드 실행 결과를 기록했습니다.
수량 지수 렌더링 검증
AGENTS.md, docs/product-technical-gap-baseline.md
숫자 토큰 경계, 정수·소수 지수 처리, 브라우저 렌더링과 Storybook 경계 검증 결과를 기록했습니다.

Estimated code review effort: 2 (Simple) | ~10 minutes

Merge Risk: 🔵 Low · up to a9bcb

This documentation update leaves one Markdown formatting warning in the PR reference text. It has no runtime impact, but should be corrected to keep documentation lint-clean.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
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.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed 제목은 런타임 귀속 수정과 커버리지 증거 기록이라는 주요 문서 변경을 정확하게 요약합니다. 간결하고 구체적입니다.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch codex/gap-baseline-20260908

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.

@seonghobae seonghobae added documentation Improvements or additions to documentation priority: low labels Sep 8, 2026 — with ChatGPT Codex Connector

@opencode-agent opencode-agent Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

OpenCode could not approve from deterministic current-head evidence because GitHub Checks have failed.

Findings

1. HIGH Current-head GitHub Checks - Fix failed required checks before approval

  • Problem: Failed same-head checks remain for faad61903b1f1bf51ad734788f38c42fc731eabe.
  • Root cause: The model-unavailable evidence fallback is allowed only when peer GitHub Checks are complete and clean.
  • Fix: Read and fix the failed check logs below, then rerun the current-head checks.
  • Regression test: Keep the model-unavailable fallback gated on an empty failed-check rollup.

Failed checks:

Changed-File Evidence Map

flowchart LR
  PR["PR changed files"] --> Evidence["OpenCode bounded evidence"]
  Evidence --> S1["Repository file: AGENTS.md"]
  S1 --> I1["repository behavior"]
  I1 --> R1["Review risk: Repository file: AGENTS.md"]
  R1 --> V1["required checks"]
  Evidence --> S2["Docs: product-technical-gap-baseline.md"]
  S2 --> I2["operator or user guidance"]
  I2 --> R2["Review risk: Docs: product-technical-gap-baseline.md"]
  R2 --> V2["docs review"]
Loading

@opencode-agent

opencode-agent Bot commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

OpenCode Review Overview

Copy link
Copy Markdown
Contributor Author

Exact-head faad61903 Tests run 34177270021 is terminal GREEN (22m49s) + Frontend GREEN. OpenCode CHANGES_REQUESTED is the org review gate (noema-review / opencode-review failed; model pool exhausted), not a product defect in this docs overlay. Do not treat that as independent APPROVE, and do not merge without independent APPROVE. The overlay correctly refuses to claim the all-page 20 ms target from /healthz/HTML probes.

@seonghobae seonghobae changed the title docs: correct runtime latency attribution and record CPU pressure docs: correct runtime attribution and record coverage evidence Sep 8, 2026

@seonghobae seonghobae left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Fresh no-loss convergence verification: #984 is based on exact parent 141d93cb5a670e43380f1179881952692735233a; ordinary two-parent child 58ed096900d048460e1274ea4f46a6f2ad58a394 overlays only the pre-existing AGENTS.md and docs/product-technical-gap-baseline.md blobs. Parent→child compare is ahead-only / behind 0 with merge base exactly the parent and net changed paths only those two documents, so the new criterion-identity coverage regression is inherited rather than reverted. Keep Draft. The two documentation findings remain open: losslessly rewrite prose-leading #929 also contains... as PR #929..., and explicitly classify 20 ms as the CWL engineering/diagnostic target rather than an approved LineageWeave release SLO. Do not regenerate the large historical evidence document just to make those edits.

@seonghobae
seonghobae marked this pull request as ready for review September 9, 2026 01:35

@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: e54ebc10c9

ℹ️ 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".

historical evidence only. The job-architecture artifact ship originally via
#749 is now re-verified on `main` from the promotion.

### Dashboard keyboard and viewport verification — 2026-09-08

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 Promote September diagnostics outside the August snapshot

Because this and every following added evidence heading use ###, Markdown nests all of the September 8 diagnostics through “Exact-head frontend coverage failure” beneath ## 12. Delivery snapshot (2026-08-27). Rendered navigation therefore presents local failures and incomplete checks as part of that dated protected-main delivery snapshot, conflating two evidence scopes the text otherwise keeps distinct; move these entries to their matching top-level sections or promote them to ## headings.

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Verified on current child 46bf2c28d1e6120a66ecf8c616b9d7786b6a4d9d: this finding is valid. ## 12. Delivery snapshot (2026-08-27) is followed by September 8 diagnostics using ###, so rendered Markdown incorrectly nests current diagnostics under the dated August protected-main snapshot. The repair must change document hierarchy without rewriting or dropping historical evidence—promote the September diagnostic blocks to the appropriate ## scope (or move them under an explicit current-evidence section). Keeping this thread unresolved until that structural repair is present.

Only after recording terminal PostgreSQL evidence were the accumulated API
regression commits pushed. The new head requires its own hosted checks.

At exact HEAD `973ac01cf13657b15f316de6d5ca98380edb6e59`, hosted run

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 Date the exact-head coverage evidence correctly

This entry is nested under Frontend coverage evidence — 2026-09-08, but the referenced commit 973ac01c was authored and committed on 2026-09-09, so its hosted run necessarily occurred after the date assigned by the heading. In a revision-scoped evidence ledger this misdates the newest CI result and can distort chronological comparisons; add a September 9 heading or change the section title to an explicit date range.

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Verified on current child 46bf2c28d1e6120a66ecf8c616b9d7786b6a4d9d: this date-scope finding is valid. The broad top-level heading remains ## Frontend coverage evidence — 2026-09-08 while later entries, including the September 9 exact-head evidence, remain within that section. A revision-scoped ledger should not make September 9 evidence appear to belong to September 8. Minimal repair is a truthful top-level date range or a separate September 9 evidence heading, preserving every recorded receipt. Thread remains unresolved until the document itself is repaired.

@seonghobae
seonghobae marked this pull request as draft September 9, 2026 01:52
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 priority: low

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant