refactor(agc): 三个名不副实的模块按内容改名，只动文件与 mod/再导出（各 2 行 plumbing）

agent/generation/draft_validation.rs → agent/generation/game_html_validation.rs（剩 9 个公开项全是游戏 HTML/JS 校验原语，草案链已退役）；同步 agent/generation.rs:4 的 mod 声明与 :35 的再导出前缀；文件顶部新增 //! 模块文档。

agent/runtime_models.rs → agent/provider_request_snapshot.rs（只剩 1 个 DTO AgentRuntimeProviderRequestSnapshot）；同步 agent.rs:36 的 mod 声明与 :80 的 pub(in crate::agent) use 前缀；顶部新增 //! 模块文档。

process_session/recovery.rs → process_session/shutdown.rs（只剩 shutdown_all_process_sessions 与 shutdown_all_process_sessions_and_wait）；同步 process_session.rs:8 的 mod 声明与 :11 的再导出前缀；顶部新增 //! 模块文档。

实现、可见性、cfg 一律未改：三个文件的函数体逐字节不变，无新增/删除 #[allow]；无新增导入。

调用点改动数 = 0（证据）：git status 仅 3 个 R（重命名）+ 3 个 M（plumbing：agent/generation.rs、agent.rs、process_session.rs），无任何调用点文件被改；shutdown_all_process_sessions 的两处调用点 runner/dispatch.rs:543 与 runner/server/desktop.rs:164 用的是项名 crate::shutdown_all_process_sessions*，模块改名不影响。

第四项 loop_orchestration.rs → llm_request.rs 未做：按约定规则，改名会碰到 mod/再导出之外的引用（3 处文档），已停下单独报告等裁决。

验证：bin 口径 0 warning / EXIT=0；--all-targets EXIT=0（test 实例 339 条不变）；测试 runtime_prompt_bundle_build 17、prompt_source_boundaries 6、thread_manager 72、manifest_invalidation 1、agent_db 65、redaction 4 全 passed；cargo fmt --all --check、npm run check:encoding（5406 文件）、git diff --check 全 rc=0。

apps/ai-game-creator-shell/src-tauri/src/agent.rs

@@ -31,9 +31,9 @@ mod direct_validation;
 pub(crate) use direct_validation::browser_tool_result;
 mod generation;
 pub(crate) mod json_sidecar;
+mod provider_request_snapshot;
 pub(crate) mod redaction;
 mod runtime_error;
-mod runtime_models;
 mod skill_pack;
 mod task_lock;
 mod thread_manager;
@@ -75,9 +75,9 @@ pub(crate) use direct_tools_mcp::*;
 pub(crate) use direct_validation::DirectValidationConfig;
 pub(crate) use generation::*;
 pub(crate) use json_sidecar::*;
+pub(in crate::agent) use provider_request_snapshot::*;
 pub(crate) use redaction::*;
 pub(crate) use runtime_error::*;
-pub(in crate::agent) use runtime_models::*;
 pub(crate) use skill_pack::*;
 pub(crate) use task_lock::*;
 pub(crate) use thread_manager::queue::*;

apps/ai-game-creator-shell/src-tauri/src/agent/generation.rs

@@ -1,8 +1,8 @@
 use super::*;
 
 mod canvas_generation;
-mod draft_validation;
 mod external_generation_state;
+mod game_html_validation;
 mod loop_orchestration;
 mod prompt_context;
 mod trace;
@@ -32,9 +32,6 @@ pub(crate) use canvas_generation::{
     platform_art_runtime_references_match_request_contract, validate_platform_art_icon_prompt,
     PlatformArtAssetGenerationOptions, PLATFORM_ART_ASSET_GENERATION_KINDS,
 };
-pub(crate) use draft_validation::{
-    contains_any, fnv1a64, strip_llm_thinking_blocks, validate_game_html_smoke,
-};
 #[cfg(test)]
 pub(crate) use external_generation_state::platform_art_generation_legacy_external_configuration_fingerprint;
 #[cfg(test)]
@@ -49,6 +46,9 @@ pub(in crate::agent) use external_generation_state::{
     game_creator_agent_runtime_external_generation_exists,
     remove_platform_art_generation_runtime_state_at, PlatformArtGenerationRuntimeContext,
 };
+pub(crate) use game_html_validation::{
+    contains_any, fnv1a64, strip_llm_thinking_blocks, validate_game_html_smoke,
+};
 pub(crate) use loop_orchestration::{
     game_creator_agent_llm_error_is_mud_points_insufficient,
     game_creator_agent_llm_error_public_summary, request_game_creator_llm_text,

apps/ai-game-creator-shell/src-tauri/src/agent/generation/game_html_validation.rs

@@ -1,3 +1,7 @@
+//! 游戏 HTML / JS 校验原语：静态冒烟自检与生成链共用。
+//!
+//! 草案（draft）与多 pass 校验链已随 Agent Runtime 退役删除；本模块只保留校验。
+
 use oxc_allocator::Allocator as JavascriptAllocator;
 use oxc_parser::Parser as JavascriptParser;
 use oxc_semantic::SemanticBuilder as JavascriptSemanticBuilder;

apps/ai-game-creator-shell/src-tauri/src/agent/provider_request_snapshot.rs

@@ -1,3 +1,5 @@
+//! Provider 请求身份快照：退役的 Agent Runtime 计划 / 观察 DTO 已删除，本模块只保留这一个结构。
+
 /// 一次 Provider 请求的身份快照：退役的 Agent Runtime 计划/观察 DTO 已删除，
 /// 只保留仍被 Codex app-server 会话与 provider 请求路径使用的这个结构。
 #[derive(Clone, Debug, Eq, PartialEq)]

apps/ai-game-creator-shell/src-tauri/src/process_session.rs

@@ -5,10 +5,10 @@ use std::collections::HashMap;
 use crate::process_session_bridge::*;
 
 mod model;
-mod recovery;
+mod shutdown;
 
 pub(crate) use model::*;
-pub(crate) use recovery::*;
+pub(crate) use shutdown::*;
 
 #[cfg(test)]
 mod tests;

apps/ai-game-creator-shell/src-tauri/src/process_session/shutdown.rs

@@ -1,3 +1,7 @@
+//! process session 关闭入口：`shutdown_all_process_sessions*`。
+//!
+//! 会话恢复 / 重建逻辑已随退役批次删除，本模块只剩关闭语义。
+
 use super::*;
 
 pub(crate) fn shutdown_all_process_sessions() {