docs: fix documentation deviations from source code

[CyberScrubber]

Summary

• Fixed conversation/ docs (multi-turn, streaming, the-loop) to match actual source code behavior
• Fixed extensibility/ docs (hooks, skills, mcp-protocol) to match actual source code behavior
• Improved Boundary section readability in system-prompt.mdx with better structure and explanation

Test plan

• Review each doc file diff against source code for accuracy
• Verify no broken links or formatting in Mintlify dev server (bun run docs:dev)

Summary by CodeRabbit

• Documentation
  • Clarified system prompt boundary behavior and caching semantics.
  • Enhanced session management documentation with updated state tracking descriptions.
  • Improved streaming behavior and network disconnect handling explanations.
  • Expanded hook events reference from 22 to 27 event types with refined categorization.
  • Updated skill configuration parsing and permission-check documentation.
  • Refined MCP protocol configuration workflow descriptions.

[coderabbitai]

Caution

Review failed

Pull request was closed or merged during review

📝 Walkthrough

Walkthrough

Documentation updates across multiple system modules describing clarifications to QueryEngine session orchestration, streaming event handling, termination conditions, Hook events, MCP configuration workflows, and Skill field processing without code changes.

Changes

Cohort / File(s)	Summary
System Prompt & Context docs/context/system-prompt.mdx	Clarified SYSTEM_PROMPT_DYNAMIC_BOUNDARY role in splitting static/dynamic regions for global caching eligibility, added explanatory block on boundary semantics, reformatted section heading presentation.
Query & Conversation Flow docs/conversation/multi-turn.mdx, docs/conversation/streaming.mdx, docs/conversation/the-loop.mdx	Updated QueryEngine session orchestration semantics including internal state tracking (loadedNestedMemoryPaths, hasHandledOrphanedPermission), submitMessage() signature, permission-denial tracking structure, transcript persistence via sanitizePath() and writeQueues, cost-tracking state model. Updated streaming event-handling reference from line numbers to function-level description (queryStreamRaw()), refined network disconnect mechanism with passive/active stall detection (30s/90s thresholds). Replaced line-based references with structural descriptions, refined termination/recovery paths with new named phases (token_budget_continuation, collapse_drain_retry), modified State type shape with immutable transitions.
Extensibility & Plugins docs/extensibility/hooks.mdx, docs/extensibility/mcp-protocol.mdx, docs/extensibility/skills.mdx	Expanded Hook events from 22 to 27 types with new event entries and event-specific field mappings. Updated hook type definitions location across multiple files, changed matching/deduplication mechanism from pluginRoot\0command Map to composite hookDedupKey() with four-segment key. Updated getAllMcpConfigs() behavior from merge logic to enterprise-specific behavior. Changed Skill frontmatter field count (17→16), refined permission-check flow to five layers, expanded SAFE_SKILL_PROPERTIES whitelist (28→30 attributes).

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

• docs: 完善上下文工程核心定义与架构说明文档(docs/context) 补充Provider 系统、Boundary 条件及兼容层说明 #204 — Both PRs modify docs/context/system-prompt.mdx and update semantics of the system prompt boundary insertion behavior and role in caching strategies.

Suggested reviewers

• KonghaYao

Poem

🐰 In docs we dance, through flows we trace,
Hook events bloom—from twenty-two to grace,
Boundaries clarify, sessions unfold,
QueryEngine's wisdom, in stories retold!
✨📚

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'docs: fix documentation deviations from source code' directly and clearly summarizes the main objective of the PR, which is updating documentation across multiple files to align with current source code behavior.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

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