docs(manual): graduate 10 stable features out of experimental

Move pages to their target chapters, strip ⚠ Experimental callouts, and
wire into SUMMARY.md proper sections. Remove from experimental/index.md.

Graduated:
- bash-language-support → concepts/ (Language Support)
- mux-rust → concepts/rust-lsp-multiplexer.md (Language Support)
- cross-process-write-serialization → concepts/ (Security & Permissions)
- mcp-resources → concepts/ (new MCP Resources section)
- project-hints → concepts/ (Multi-Project Workspaces)
- tool-description-diet → concepts/ (MCP Resources)
- tool-usage-doctor → concepts/ (MCP Resources)
- file-diversity-rerank → tools/semantic-search-diversity.md
- list-symbols-progressive-dir → tools/list-symbols-progressive.md
- read-markdown-improvements → tools/read-markdown.md

Still experimental: asymmetric-query-prefix, global-config,
index-scope-guard, librarian-mcp, metadata-enriched-chunks.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: mareurs

docs/manual/src/SUMMARY.md

@@ -32,6 +32,11 @@
   - [Auto-Registration](concepts/multi-ecosystem-auto-registration.md)
 - [Multi-Project Workspaces](concepts/multi-project-workspace.md)
   - [activate_project Output](concepts/activate-project-output-optimization.md)
+  - [Project Hints](concepts/project-hints.md)
+
+- [MCP Resources](concepts/mcp-resources.md)
+  - [Tool Description Diet](concepts/tool-description-diet.md)
+  - [Tool Usage Doctor](concepts/tool-usage-doctor.md)
 - [LSP Idle TTL](concepts/lsp-idle-ttl.md)
 
 - [Memory](concepts/memory.md)
@@ -46,6 +51,7 @@
   - [Security Profiles](concepts/security-profiles.md)
   - [Compact Schemas & `activate_project` Safety](concepts/compact-schemas-and-activate-project-safety.md)
   - [PostCompact Cache Flush](concepts/post-compact-cache-flush.md)
+  - [Cross-Process Write Serialization](concepts/cross-process-write-serialization.md)
 
 - [Routing Plugin](concepts/routing-plugin.md)
   - [Superpowers Workflow](concepts/superpowers.md)
@@ -56,20 +62,25 @@
     - [Model Comparison](configuration/embedding-model-comparison.md)
 
 - [Language Support](language-support.md)
+  - [Bash](concepts/bash-language-support.md)
   - [Kotlin LSP Multiplexer](concepts/kotlin-lsp-multiplexer.md)
+  - [Rust LSP Multiplexer](concepts/rust-lsp-multiplexer.md)
 
 # Tool Reference
 
 - [Tools Overview](tools/overview.md)
   - [API Naming Reference](tools/api-redesign.md)
   - [Symbol Navigation](tools/symbol-navigation.md)
+    - [Progressive Directory Overview](tools/list-symbols-progressive.md)
   - [File Operations](tools/file-operations.md)
     - [grep: Literal Fallback](tools/search-pattern-literal-fallback.md)
   - [Editing](tools/editing.md)
     - [Structural Edit Gate](tools/edit-file-structural-gate.md)
     - [Document Section Editing](tools/document-section-editing.md)
     - [Markdown Tools](tools/markdown-tools.md)
+    - [read_markdown](tools/read-markdown.md)
   - [Semantic Search](tools/semantic-search.md)
+    - [File-Diversity Re-Rank](tools/semantic-search-diversity.md)
   - [Library Navigation](tools/library-navigation.md)
   - [Git](tools/git.md)
   - [AST Analysis](tools/ast.md)
@@ -84,20 +95,10 @@
 
 - [Experimental Features](experimental/index.md)
   - [Asymmetric query prefix](experimental/asymmetric-query-prefix.md)
-  - [Bash language support](experimental/bash-language-support.md)
-  - [Cross-process write serialization](experimental/cross-process-write-serialization.md)
-  - [File-diversity re-rank](experimental/file-diversity-rerank.md)
   - [Global config](experimental/global-config.md)
   - [Index scope guard](experimental/index-scope-guard.md)
   - [librarian-mcp](experimental/librarian-mcp.md)
-  - [list_symbols progressive directory](experimental/list-symbols-progressive-dir.md)
-  - [MCP resources, tool diet, progress](experimental/mcp-resources.md)
   - [Metadata-enriched chunks](experimental/metadata-enriched-chunks.md)
-  - [Project hints](experimental/project-hints.md)
-  - [read_markdown improvements](experimental/read-markdown-improvements.md)
-  - [Rust LSP multiplexer](experimental/mux-rust.md)
-  - [Tool description diet](experimental/tool-description-diet.md)
-  - [Tool usage doctor](experimental/tool-usage-doctor.md)
 
 # Development
 

…rc/experimental/bash-language-support.md …al/src/concepts/bash-language-support.mddocs/manual/src/experimental/bash-language-support.md renamed to docs/manual/src/concepts/bash-language-support.md docs/manual/src/experimental/bash-language-support.md renamed to docs/manual/src/concepts/bash-language-support.md

@@ -1,7 +1,4 @@
 # Bash language support
-
-> ⚠ Experimental — may change without notice.
-
 ## What it does
 
 Bash and shell scripts (`.sh`, `.bash`) now receive full language support:

…tal/cross-process-write-serialization.md …pts/cross-process-write-serialization.mddocs/manual/src/experimental/cross-process-write-serialization.md renamed to docs/manual/src/concepts/cross-process-write-serialization.md docs/manual/src/experimental/cross-process-write-serialization.md renamed to docs/manual/src/concepts/cross-process-write-serialization.md

@@ -1,7 +1,4 @@
 # Cross-Process Write Serialization
-
-> ⚠ Experimental — may change without notice.
-
 When multiple codescout MCP server instances run against the same project directory simultaneously (e.g. two IDE windows, two Claude Code sessions, or a background indexer alongside an active session), write-tool calls are now serialized so they cannot corrupt each other.
 
 ## How It Works

…manual/src/experimental/mcp-resources.md docs/manual/src/concepts/mcp-resources.mddocs/manual/src/experimental/mcp-resources.md renamed to docs/manual/src/concepts/mcp-resources.md docs/manual/src/experimental/mcp-resources.md renamed to docs/manual/src/concepts/mcp-resources.md

@@ -1,7 +1,4 @@
 # MCP resources, tool diet, and progress notifications
-
-> ⚠ Experimental — may change without notice.
-
 Codescout now exposes three mechanisms to reduce per-turn token overhead and
 surface activity from long-running operations. They ship together because they
 share one thesis: **pay tokens only when the model asks**.

…manual/src/experimental/project-hints.md docs/manual/src/concepts/project-hints.mddocs/manual/src/experimental/project-hints.md renamed to docs/manual/src/concepts/project-hints.md docs/manual/src/experimental/project-hints.md renamed to docs/manual/src/concepts/project-hints.md

@@ -1,7 +1,4 @@
 # Project Hints
-
-> ⚠ Experimental — may change without notice.
-
 `activate_project` now returns a `project_hints` field with manifest-derived
 context so agents have useful information even when `onboarding` has never been
 run.

docs/manual/src/experimental/mux-rust.md …ual/src/concepts/rust-lsp-multiplexer.mddocs/manual/src/experimental/mux-rust.md renamed to docs/manual/src/concepts/rust-lsp-multiplexer.md docs/manual/src/experimental/mux-rust.md renamed to docs/manual/src/concepts/rust-lsp-multiplexer.md

@@ -1,7 +1,4 @@
 # Rust LSP multiplexer
-
-> ⚠ Experimental — may change without notice.
-
 ## What it does
 
 When two `codescout` instances open the same Rust project, they now share a

…rc/experimental/tool-description-diet.md …al/src/concepts/tool-description-diet.mddocs/manual/src/experimental/tool-description-diet.md renamed to docs/manual/src/concepts/tool-description-diet.md docs/manual/src/experimental/tool-description-diet.md renamed to docs/manual/src/concepts/tool-description-diet.md

@@ -1,4 +1,3 @@
-> ⚠ Experimental — may change without notice.
 
 # Tool Description Diet & Tool Guide Resource
 

…al/src/experimental/tool-usage-doctor.md …manual/src/concepts/tool-usage-doctor.mddocs/manual/src/experimental/tool-usage-doctor.md renamed to docs/manual/src/concepts/tool-usage-doctor.md docs/manual/src/experimental/tool-usage-doctor.md renamed to docs/manual/src/concepts/tool-usage-doctor.md

@@ -1,7 +1,4 @@
 # Tool Usage Doctor
-
-> ⚠ Experimental — may change without notice.
-
 The `doctor://tool-usage` MCP resource surfaces per-tool call statistics and
 prune candidates, so codescout maintainers can quantify what the current
 token-diet actually bought us and identify rarely-used tools for the next

docs/manual/src/experimental/index.md

@@ -7,18 +7,7 @@
 ## Available Features
 
 - [Asymmetric query prefix for embedding models](./asymmetric-query-prefix.md) — automatic query-side prefix for models trained asymmetrically (e.g. CodeRankEmbed), restoring `semantic_search` recall without user configuration.
-- [Bash language support](./bash-language-support.md) — full symbol extraction and LSP navigation for `.sh` / `.bash` files via `bash-language-server`.
-- [`list_symbols` progressive directory overview](./list-symbols-progressive-dir.md) — adaptive three-mode output (full tree / class overview / directory map) for directory-level symbol queries.
-- [MCP resources, tool diet, progress notifications](./mcp-resources.md) — token-efficient resource sharing, short descriptions with on-demand guides, and progress notifications for long operations.
-- [Project hints in `activate_project`](./project-hints.md) — manifest-derived primary language, entry points, and build commands surfaced in the activation response so agents have context without running onboarding.
-- [`read_markdown` improvements](./read-markdown-improvements.md) — adaptive output tiers, `@file_*` buffer ref support, and heading navigation for large markdown files.
-- [Rust LSP multiplexer](./mux-rust.md) — share a single `rust-analyzer` process across multiple `codescout` instances on the same project, eliminating stale-hover / stale-goto bugs.
-- [Tool usage doctor](./tool-usage-doctor.md) — `doctor://tool-usage` MCP resource reporting per-tool call counts, error/overflow rates, and prune candidates for the next prompt-surface review.
-- [Cross-process write serialization](./cross-process-write-serialization.md) — advisory file lock serializes write-tool calls across concurrent codescout instances on the same project; contention returns a recoverable error instead of corrupting files.
+- [Global config](./global-config.md) — `~/.config/codescout/config.toml` (XDG) merged with per-project `.codescout/config.toml`; set workspace-wide defaults without touching every project.
 - [Index Scope Guard](./index-scope-guard.md) — confirmation prompt before `index_project` walks home/system directories or oversized trees.
-- [Metadata-Enriched Chunks](./metadata-enriched-chunks.md) — file path, container context, and symbol name prepended to chunk embeddings for better multi-concept keyword query matching.
-- [File-Diversity Re-Rank for `semantic_search`](./file-diversity-rerank.md) — per-file cap on semantic search results prevents a single file from saturating the top-K; overfetch-then-filter preserves score ordering.
-
 - [librarian-mcp — workspace artifact registry](./librarian-mcp.md) — sibling MCP server that indexes markdown artifacts (specs, plans, memories, ADRs, docs) across every repo in a workspace, with filter AST, link graph, and semantic search.
-- [Tool description diet & tool guide resource](./tool-description-diet.md) — caps tool descriptions at 300 characters; full usage notes served on demand via `doc://codescout-tool-guide` resource.
-- [Global config](./global-config.md) — `~/.config/codescout/config.toml` (XDG) merged with per-project `.codescout/config.toml`; set workspace-wide defaults without touching every project.
+- [Metadata-Enriched Chunks](./metadata-enriched-chunks.md) — file path, container context, and symbol name prepended to chunk embeddings for better multi-concept keyword query matching.

…rimental/list-symbols-progressive-dir.md …al/src/tools/list-symbols-progressive.mddocs/manual/src/experimental/list-symbols-progressive-dir.md renamed to docs/manual/src/tools/list-symbols-progressive.md docs/manual/src/experimental/list-symbols-progressive-dir.md renamed to docs/manual/src/tools/list-symbols-progressive.md

@@ -1,7 +1,4 @@
 # `list_symbols` progressive directory overview
-
-> ⚠ Experimental — may change without notice.
-
 ## What it does
 
 When `list_symbols` is called on a directory (rather than a single file), it