Skip to content

docs: sweep relative-path drift in 2026-05-06 comprehensive review (180/180 fixed)#19

Closed
cemililik wants to merge 1 commit into
mainfrom
doc-hygiene-2026-05-06-path-drift-sweep
Closed

docs: sweep relative-path drift in 2026-05-06 comprehensive review (180/180 fixed)#19
cemililik wants to merge 1 commit into
mainfrom
doc-hygiene-2026-05-06-path-drift-sweep

Conversation

@cemililik
Copy link
Copy Markdown
Collaborator

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.

Target class Was (broken) Is (correct)
repo-root (kernel, tools, bsp-qemu-virt, hal, test-hal, .claude, .github, .cargo, .gitignore, Cargo.{toml,lock}, LICENSE, README.md, AGENTS.md, CLAUDE.md, SECURITY.md, CONTRIBUTING.md, rust-toolchain.toml) ../../../../X (4 ../) ../../../../../X (5 ../)
docs-relative (audits, standards, decisions, roadmap, architecture, glossary, analysis, tasks) ../../../X (3 ../) ../../../../X (4 ../)
docs/X redundant-prefix shape ../../../../docs/X ../../../../X (drop redundant docs/)

Files touched (mechanical only)

File Lines changed
track-a-kernel.md 68
track-b-hal.md 42
track-d-performance.md 70
track-e-docs.md 8
track-g-bsp.md 60
track-h-infra.md 48
track-j-hygiene.md 22
Total 318 lines (159 in/159 out — paths only)

track-c-security.md, track-f-tests.md, track-i-integration.md already used the correct convention; not touched.

What's not in this PR

  • Content changes — purely mechanical path-count adjustments. The review verdicts, findings, severity classifications, and prose are untouched.
  • The merged report 2026-05-06-full-tree-comprehensive.md — already used the correct convention.

Test plan

  • realpath validation across 180 paths returned 0 broken
  • No code changes, no kernel rebuild required
  • Merge verdicts and finding texts confirmed unchanged via git diff

🤖 Generated with Claude Code

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>
@qodo-code-review
Copy link
Copy Markdown

ⓘ 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.

Copy link
Copy Markdown

@sourcery-ai sourcery-ai Bot left a comment

Choose a reason for hiding this comment

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

Sorry @cemililik, your pull request is larger than the review limit of 150000 diff characters

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 8, 2026

Warning

Rate limit exceeded

@cemililik has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 37 minutes and 26 seconds before requesting another review.

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 @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

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 configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 4592d92d-ec6f-4ba9-b411-c2d96a777f19

📥 Commits

Reviewing files that changed from the base of the PR and between aa7e6c5 and 2877e0d.

📒 Files selected for processing (7)
  • docs/analysis/reviews/code-reviews/2026-05-06-full-tree/track-a-kernel.md
  • docs/analysis/reviews/code-reviews/2026-05-06-full-tree/track-b-hal.md
  • docs/analysis/reviews/code-reviews/2026-05-06-full-tree/track-d-performance.md
  • docs/analysis/reviews/code-reviews/2026-05-06-full-tree/track-e-docs.md
  • docs/analysis/reviews/code-reviews/2026-05-06-full-tree/track-g-bsp.md
  • docs/analysis/reviews/code-reviews/2026-05-06-full-tree/track-h-infra.md
  • docs/analysis/reviews/code-reviews/2026-05-06-full-tree/track-j-hygiene.md
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch doc-hygiene-2026-05-06-path-drift-sweep

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 and usage tips.

Copy link
Copy Markdown

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

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

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.

cemililik added a commit that referenced this pull request May 8, 2026
The 2026-05-08 banner originally claimed P10 lands in PR #20; the
actual PR-number assignment landed P10 at #21 (after path-drift PR #19
and ADR-0027 PR #20). Single-line correction; nothing else changes.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@cemililik
Copy link
Copy Markdown
Collaborator Author

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 doc-hygiene-2026-05-06-path-drift-sweep preserved for reference; the integration branch integration-2026-05-08-b2-prep-bundle carries this PR's content unchanged.

@cemililik cemililik closed this May 8, 2026
cemililik added a commit that referenced this pull request May 8, 2026
…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>
cemililik added a commit that referenced this pull request May 8, 2026
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>
cemililik added a commit that referenced this pull request May 8, 2026
… 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>
cemililik added a commit that referenced this pull request May 8, 2026
…bundle

B2 prep integration bundle (replaces #19, #20, #21) — ADR-0027 + T-016 Draft + P10 harness + path-drift sweep + 2026-05-08 review
@cemililik cemililik deleted the doc-hygiene-2026-05-06-path-drift-sweep branch May 25, 2026 12:49
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