docs: sweep relative-path drift in 2026-05-06 comprehensive review (180/180 fixed)#19
docs: sweep relative-path drift in 2026-05-06 comprehensive review (180/180 fixed)#19cemililik wants to merge 1 commit into
Conversation
Mechanical fix of off-by-one relative-path drift across the prior comprehensive review's 7 affected track files (track-a, -b, -d, -e, -g, -h, -j). The same drift was caught + fixed in the 2026-05-07 PR #18 review files; this commit applies the equivalent sweep to the prior review per the disposition recorded in PR #18's gemini reply. Path-math summary: - track files live at docs/analysis/reviews/code-reviews/2026-05-06-full-tree/ (5 levels deep from repo root). - repo-root targets (kernel/, tools/, bsp-qemu-virt/, hal/, test-hal/, .claude/, .github/, .cargo/, .gitignore, Cargo.toml, Cargo.lock, LICENSE, README.md, AGENTS.md, CLAUDE.md, SECURITY.md, CONTRIBUTING.md, rust-toolchain.toml) need 5 ../. - docs-relative targets (audits/, standards/, decisions/, roadmap/, architecture/, glossary, analysis/, tasks/) need 4 ../. - One additional broken form: `(../../../../docs/<sub>/...)` was a redundant-docs-prefix shape (4 ../ resolves to docs/, then `docs/` prepends docs/docs/...). Collapsed to `(../../../../<sub>/...)`. 180/180 relative paths in the 7 affected track files now resolve via realpath (validated). The 3 remaining files in the same directory (track-c-security, track-f-tests, track-i-integration) were already using the correct convention and are byte-stable. No content changes — purely mechanical path-count adjustments. The review verdicts, findings, severity classifications, and prose are untouched. Refs: PR #18 review-round (gemini-code-assist disposition) — out-of-scope item now closed Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
ⓘ You've reached your Qodo monthly free-tier limit. Reviews pause until next month — upgrade your plan to continue now, or link your paid account if you already have one. |
There was a problem hiding this comment.
Sorry @cemililik, your pull request is larger than the review limit of 150000 diff characters
|
Warning Rate limit exceeded
You’ve run out of usage credits. Purchase more in the billing tab. ⌛ How to resolve this issue?After the wait time has elapsed, a review can be triggered using the We recommend that you space out your commits to avoid hitting the rate limit. 🚦 How do rate limits work?CodeRabbit enforces hourly rate limits for each developer per organization. Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout. Please see our FAQ for further information. ℹ️ Review info⚙️ Run configurationConfiguration used: defaults Review profile: CHILL Plan: Pro Run ID: 📒 Files selected for processing (7)
✨ Finishing Touches🧪 Generate unit tests (beta)
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. Comment |
There was a problem hiding this comment.
Code Review
This pull request updates relative links across several documentation files in the docs/analysis/reviews/code-reviews/2026-05-06-full-tree/ directory. The changes primarily involve adjusting directory depths in relative paths and correcting specific file paths to ensure link integrity. As there are no review comments provided, I have no feedback to offer.
|
Superseded by the integration PR for the B2 prep bundle: #19 + #20 + #21 + 2026-05-08 review artefacts + T3-M1 phase-b status-block fix all land together. Branch |
…losure status Re-verified all 13 §Follow-up backlog items from the 2026-05-07 PR #12-#17 multi-axis review against the current integration-branch state. All 9 hygiene items + the 1 forward-flagged P10 harness item are now closed; 3 remain forward-flagged on appropriate downstream venues. Two updates to the consolidated review file: 1. **Top-of-file closure-status banner** — readers see the per-item disposition at-a-glance without scrolling to the bottom backlog. 2. **§Follow-up backlog per-item closure annotations** — items 1-9 gain ✅ + closing-PR + closing-commit references; item 11 (P10 harness) gains ✅ + integration-PR reference + measured-baseline numbers; items 10/12/13 keep their forward-flagged status with "status unchanged 2026-05-08" markers. Re-verification at integration-branch HEAD (per item): | # | Item | Closing PR / commit | Verification | |---|---|---|---| | 1 | current.md + perf re-baseline `.text 22,020` | PR #18 / `94a6c0f` | grep "22,020 bytes" current.md → 1 hit | | 2 | cancel_recv_on_recv_complete test | PR #18 / `25854a1` | grep test name in ipc/mod.rs → 1 hit; host-test 159/159 | | 3 | ipc_cancel_recv doc-rider on cap-bearing state | PR #18 / `25854a1` | grep "destroy-drain callers (Phase B2+)" → 1 hit | | 4 | cancel-block SAFETY wording | PR #18 / `25854a1` | grep "caller_table.*shared.*reborrow" → 1 hit | | 5 | UNSAFE-2026-0014 SHA back-fill (c30f4ee, 7a402cb) | PR #18 / `94a6c0f` | grep both SHAs in unsafe-log.md → 2 hits each | | 6 | unsafe-policy.md §3 mechanical-edit exemption | PR #18 / `94a6c0f` | grep "Mechanical-edit exemption" → 1 hit | | 7 | ADR-0026 §Simulation chronology rider | PR #18 / `94a6c0f` | grep "§Simulation rule was retro-extracted" → 1 hit | | 8 | master-plan AC cross-reference | PR #18 / `94a6c0f` | grep "Closure-trio coordination cross-reference" in security + perf master-plans → 1 hit each | | 9 | ADR-0026 §skill-clause reconciliation rider | PR #18 / `94a6c0f` | grep "single-commit Propose+Accept landing reconciliation" → 1 hit | | 11 | P10 wall-clock harness | this integration PR (replaces #19/#20/#21) | tools/perf-harness.sh exists; baseline report exists; band p10=3.884/p50=4.642/p90=5.584 ms | Forward-flagged (status unchanged): - Item 10: RecvWaiting waiter-identity gap — ADR-0030 / ADR-0019 venue - Item 12: cancel-on-cap-bearing-state destroy-drain ADR — first userspace-destroy task venue - Item 13: B5+ preemption-rollback re-validation of ADR-0032 — B5+ preemption ADR venue This commit only touches the consolidated review's annotation; track files preserved as historical artefacts (their per-track verdicts are the snapshot at the moment of the review, not subject to back-edits). The review's per-item findings (Track-A NIT-2 SchedQueue::new doc rename; Track-G MIN-G1/G2/G3; Track-H MIN-1/MIN-2; Track-A MIN-2 ipc_cancel_recv doc-rider; Track-D D1; Track-F §F-1) are all closed in PR #18 + this integration PR. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Closes the orchestrator review's findings on PR #22 (16 actionable items; one item — PR #19 description "180/180" wording — not closeable post-merge because the gh PR is already closed and its description is immutable from this branch). **3 Majors (fix-on-branch):** - M1 path-drift in 2026-05-08 consolidated review L124: `(../../decisions/...)` → `(../../../decisions/...)`. The 4-deep file needs 3 `..` to reach `docs/decisions/`. Other relative paths in the same file already use the correct depth; this was the lone broken outlier. - M2 `commit-style.md:130` anchor: the new "PR-number references" rider linked to `track-g-process.md#min-g3` for "PR-numbering fix-up precedent", but MIN-G3 is about closure-trio smoke-trace AC asymmetry, not PR-numbering. Dropped the wrong anchor; the link now points at the 2026-05-08 review's §"Cross-PR observations" §1 ("PR-numbering hygiene drift recurrence"), which IS the canonical source of the rider. - M3 158→159 narrative drift in `current.md:15` and `phase-b.md:103`: added "Current state (post-PR-#18 hygiene): 159/159" addendum that preserves the historical PR-#17-merge-moment claim of 158/158 (factually accurate at the time) while disambiguating from the current 159 baseline that PR #18's `25826a1` brought us to. **7 Minors (substance + governance polish):** - `hal.md` §Mmu present-tense overclaim: `MapperFlush` extension is T-016 deliverable, not current `main`; added a "tense hedge" blockquote making the post-T-016 framing explicit and acknowledging that the current trait surface is still pre-`MapperFlush`. - ADR-0027 §(a) MMIO range mismatch: `0x0902_0000` (the UART's actual end-of-MMIO) vs `0x0920_0000` (the 2 MiB-block-aligned end of the bootstrap's identity-map for that block). Reworded to explicitly cover the block-aligned superset; clarified the unmapped slack is harmless under device-nGnRnE. - ADR-0027 §(a) `TCR_EL1.A1` forward-flag: `A1=0` documented (selects which TTBR holds the ASID; v1 keeps `A1=0` because only `TTBR0_EL1` is active); the future high-half ADR (ADR-0033) gets named as the decider for `A1=1` migration. - `track-3-pr-20-governance.md:31` quoted-excerpt path: the embedded `(../../.claude/skills/write-adr/SKILL.md)` link in a quoted ADR-0027 passage was broken from track-3's depth (5-deep). Restructured the quote into a `> blockquote` with link targets stripped; preserves quote fidelity while avoiding broken-link rendering. - Glossary: added entries for `mmu_bootstrap` and `.boot_pt` — identifiers introduced by ADR-0027 / T-016 that future readers will hit and want a 1-line definition for. - `tools/perf-harness.sh` `export LC_ALL=C` at script entry: forces period-decimal + ASCII-digit awk output regardless of host locale. Without this, `LC_ALL=tr_TR.UTF-8` would emit `5,169` (decimal comma) in baseline reports — valid in tr_TR, mis-parsed in en_US. - 2026-05-08 consolidated review §Follow-up backlog: each of the 15 items now carries an inline ✅ + closing-commit-SHA annotation, matching the [2026-05-07 review's `8b6147d`-style closure-status pattern](docs/analysis/reviews/code-reviews/ 2026-05-07-pr-12-to-17-multi-axis-review.md). Item 8 (PR #19 description "180/180" wording) annotated as "not closeable post-merge" with rationale. **5 Nits (refinements; one was already closed):** - ADR-0027 §Simulation Step 1 row: collapsed the awkward `L2_low[64..72]` + `L2_low[72]` notation into the cleaner half-open `L2_low[64..73]` (= 9 indices = 9 entries) and added a footnote clarifying the half-open Rust convention used throughout the ADR. memory-management.md mermaid diagram updated similarly. - ADR-0027 §References framing: tightened "first ADR drafted under §Simulation; this is the second" to "first ADR drafted under the §Simulation rule (recovery-primitive subject); this ADR is the first non-recovery-primitive state-machine ADR drafted under the same rule" — matches the §Context para 2 framing precisely. - `tools/perf-harness.sh:223` (`QEMU_VERSION` extraction): replaced `head -n 1` with `awk 'NR==1 { print; exit }'` to avoid the `head` SIGPIPE that `set -o pipefail` would propagate. Defensive hardening; observable behaviour unchanged. - `tools/perf-harness.sh:209` watchdog kill: added `kill -0` liveness guard before `kill -KILL`. Before: kill on a dead PID returned ESRCH which `2>/dev/null || true` swallowed silently. After: explicit aliveness check makes the intent self-documenting. - `tools/perf-harness.sh:54-62` trap function: added a one-line comment documenting the idempotency property — both globals empty → no-op; stale PIDs → ESRCH suppressed → safe to fire multiple times. - (Already closed) `unsafe-log.md` 2026-05-08 closure-path Amendments cite Track-H NIT-1: verified — all 3 Amendments (UNSAFE-2026-0019/0020/0021) already include the trace-back link to the prior review's NIT-1. Verification: cargo fmt clean, cargo host-test 159/159, host-clippy clean (-D warnings), kernel-clippy clean, kernel-build clean, perf-harness 3-iter sanity run produces consistent stats with `LC_ALL=C` decimal-period output. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
… banner clarify "180/180" The 2026-05-08 review's §Follow-up backlog item 8 was annotated as "not closeable post-merge" because the original PR #19's gh description is immutable on a closed PR. But the substance of the recommendation — clarify the "180/180" metric phrasing — IS closeable via the integration PR #22's description (which is open and editable) plus the roadmap banner that mirrors the same fact in the source tree. Three updates: 1. **Integration PR #22 description** (via `gh pr edit 22`): the "branches integrated" table row for PR #19 changed from "Mechanical sed sweep of 180 broken relative-path links" to "Mechanical sed sweep of broken relative-path links … (~180 link *instances* across 7 affected files; the 2026-05-08 multi-axis review re-counted at 193 instances over 83 unique targets — substance is the same: every broken link resolves post-sweep)". 2. **`docs/roadmap/current.md` 2026-05-08 banner** item 3: same precise-metric phrasing applied. The `180` headline is preserved for continuity with PR #19's commit-style wording, but the parenthetical clarifies the instances-vs-targets ambiguity. 3. **2026-05-08 review §Follow-up backlog item 8**: status flipped from ⏳ "not closeable post-merge" to ✅ "closed by editing the integration PR #22 description plus a parallel addendum in current.md banner item 3", with a note that the original PR #19 gh description remains as-was (closed PR is immutable from this branch) but every reachable downstream artefact now states the precise metric. This is the last open item from the 2026-05-08 multi-axis review — all 16 actionable items now closed in this branch (15 in prior commits, 1 here). Verification: cargo fmt clean. No source-code changes; doc-only. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Summary
Mechanical fix of the off-by-one relative-path drift in the prior 2026-05-06 comprehensive review's 7 affected track files. Same shape as PR #18's gemini-disposition cleanup; this PR closes the out-of-scope item recorded there.
Verification: all 180 relative paths in the 7 affected files now resolve via
realpath. Zero broken paths remaining.Sweep patterns applied
Track files at
docs/analysis/reviews/code-reviews/2026-05-06-full-tree/are 5 levels deep from repo root.../../../../X(4../)../../../../../X(5../)../../../X(3../)../../../../X(4../)../../../../docs/X../../../../X(drop redundantdocs/)Files touched (mechanical only)
track-c-security.md,track-f-tests.md,track-i-integration.mdalready used the correct convention; not touched.What's not in this PR
2026-05-06-full-tree-comprehensive.md— already used the correct convention.Test plan
realpathvalidation across 180 paths returned 0 brokengit diff🤖 Generated with Claude Code