refactor(providers/pi): drop rot-prone file:line refs from Pi comments

[Wirasm]

Summary

Follow-up to #1270. The multi-agent review on #1271 flagged the CLAUDE.md comment rule ("don't embed paths/callers that rot as the codebase evolves"). The rule applies equally to three spots in the just-merged Pi provider that embed packages/.../provider.ts:N-M line ranges.

Changes

Three inline comments in `packages/providers/src/community/pi/`:

• `session-resolver.ts` — ResolvedSession's `resumeFailed` JSDoc
• `provider.ts` — Claude auth-merge reference (line ~122)
• `provider.ts` — Codex fallback reference (line ~204)
• `provider.ts` — upstream Pi `auth-storage.ts:424-485` ref

Each drops the fragile line numbers and file paths while keeping the conceptual cross-reference ("mirrors Claude's process-env + request-env merge pattern", "matches the Codex provider's fallback pattern", etc.) — that's the load-bearing part of the comment.

Why

Line numbers drift the moment the referenced files change. The Claude and Codex providers are both under active evolution; the Pi provider doesn't benefit from pinning line ranges at a specific snapshot.

Test plan

• `bun run validate` passes (no behavior change; comment-only refactor).

Summary by CodeRabbit

• Documentation
  • Updated internal documentation comments for the Pi provider to clarify environment variable merge patterns and credential resolution behavior.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 31179689-248c-4400-b584-034dd6d640fb

📥 Commits

Reviewing files that changed from the base of the PR and between 4e56991 and 7d61dd3.

📒 Files selected for processing (2)

• packages/providers/src/community/pi/provider.ts
• packages/providers/src/community/pi/session-resolver.ts

---

📝 Walkthrough

Walkthrough

These changes update inline documentation and JSDoc comments in the Pi provider module to generalize references to environment-variable merge patterns and fallback behavior, removing explicit file/line references. No runtime logic, control flow, or public APIs were modified.

Changes

Cohort / File(s)	Summary
Pi Provider Documentation Updates packages/providers/src/community/pi/provider.ts, packages/providers/src/community/pi/session-resolver.ts	Revised inline documentation to replace specific file/line references with generalized descriptions of environment-variable merge patterns and fallback behavior (e.g., "process-env + request-env merge pattern" and "resume_thread_failed fallback pattern").

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Poem

🐰 Our docs grew cleaner, more refined,
No line numbers cluttering the mind,
Pi's patterns now described with grace,
General wisdom in every place! ✨

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch fix/pi-comment-path-rot

---

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

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}