docs(plugin): teach session refresh lifecycle

[BleedingDev]

Summary

• document session refresh begin, status, and cancel as one lifecycle
• keep only read-only status in the zero-confirmation Cursor allowlist
• require explicit mutation intent, opaque handles, and receipt-backed cancellation

Why

PR #707 splits session refresh into lifecycle tools, but the packaged guidance exposed status without teaching agents how to safely start, track, and cancel the operation.

Verification

• packaged plugin manifest and skill inventory checks pass
• tool ordering, allowlist, and mutation-guardrail assertions pass
• aggregate Rustfmt and diff checks pass
• branch scope audit: one commit, two documentation files, clean worktree

Supports #707.

[changeset-bot]

⚠️ No Changeset found

Latest commit: 7c1e06b

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[chatgpt-codex-connector]

Codex Review Summary

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

Review	Status	Commit	Review trigger
📝 Code Review	✅ Completed 2026-08-30T15:33:11.467111Z	7c1e06b	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.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 7c1e06ba19

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

[chatgpt-codex-connector]

Route profile refreshes through the compatible lifecycle

When tracedecay_message_search runs against an authorized profile root and returns refresh_required, this instruction sends the agent to tracedecay_session_refresh_begin, but the split begin/status/cancel schemas require a project identity and are mounted only under project-open admission. They cannot accept the authoritative profile selectors that the compatibility tracedecay_session_refresh tool supports, so the documented lifecycle is unusable for stale profile-scoped reads; make this routing scope-aware and retain the compatibility lifecycle for profile refreshes.

AGENTS.md reference: AGENTS.md:L9-L12

Useful? React with 👍 / 👎.