feat: 接入 mnote web tree shell 与主页链路整理

- 增加 mnote-web tree/command 支持与前端 MnoteWebTreeShell 集成
- 调整 sidebar、documents、runtime config 与 dev/prod server 配套逻辑
- 补充 homepage/tree shell smoke 脚本并更新 harness 进度文件

rust/crates/mnote-web/src/routes/bridge.rs

@@ -73,13 +73,13 @@ fn workspace_query_payload(
     }
 }
 
-fn execute_bridge_query(
+async fn execute_bridge_query(
     config: &AppConfig,
     context: &RequestContext,
     workspace_id: &str,
     query: RuntimeQueryEnvelopeWire,
 ) -> Result<Value, WebError> {
-    execute_runtime_query_via_convex(config, context, Some(workspace_id), query)
+    execute_runtime_query_via_convex(config, context, Some(workspace_id), query).await
 }
 
 pub async fn workspace(
@@ -95,7 +95,8 @@ pub async fn workspace(
         &context,
         &effective_workspace_id,
         workspace_query_payload(&effective_workspace_id, &query),
-    )?;
+    )
+    .await?;
     Ok(ok_response(&context, result))
 }
 
@@ -119,7 +120,8 @@ pub async fn request(
                 "commandId": query.command_id,
             }),
         },
-    )?;
+    )
+    .await?;
     Ok(ok_response(&context, result))
 }
 
@@ -143,7 +145,8 @@ pub async fn trace(
                 "commandId": query.command_id,
             }),
         },
-    )?;
+    )
+    .await?;
     Ok(ok_response(&context, result))
 }
 
@@ -155,10 +158,6 @@ mod tests {
     use tower::util::ServiceExt;
 
     fn app() -> axum::Router {
-        std::env::set_var(
-            "MNOTE_WEB_QUERY_FIXTURES_JSON",
-            r#"{"sidebar:datasetList":{"documents":[{"id":"page_root","workspace_id":"ws_demo","title":"工作区首页","parent_id":null,"sort_order":0,"is_starred":true,"is_template":false,"created_at":"2026-04-16T00:00:00Z","updated_at":"2026-04-16T00:00:00Z"},{"id":"page_child","workspace_id":"ws_demo","title":"子页面","parent_id":"page_root","sort_order":1,"is_starred":false,"is_template":false,"created_at":"2026-04-16T00:00:00Z","updated_at":"2026-04-16T00:00:00Z"}]},"bridgeLogs:listWorkspaceOverview":{"workspace_id":"ws_demo","command_logs":[{"command_id":"cmd_1","request_id":"req_1","status":"applied","created_at":"2026-04-16T00:00:00Z"}],"domain_events":[{"command_id":"cmd_1","status":"published","created_at":"2026-04-16T00:00:00Z"}],"next_cursor":null,"has_more":false,"filters":{"command_status":null,"event_status":null,"target_page_id":null,"target_block_id":null,"aggregate_type":null,"aggregate_id":null},"generated_at":"2026-04-16T00:00:00Z"}}"#,
-        );
         build_app(AppState::new(AppConfig {
             service_name: "mnote-web".into(),
             service_version: "0.1.0".into(),
@@ -168,6 +167,8 @@ mod tests {
             convex_url: None,
             convex_admin_key: None,
             allow_dev_fixtures: true,
+            query_fixtures_json: Some(r#"{"sidebar:datasetList":{"documents":[{"id":"page_root","workspace_id":"ws_demo","title":"工作区首页","parent_id":null,"sort_order":0,"is_starred":true,"is_template":false,"created_at":"2026-04-16T00:00:00Z","updated_at":"2026-04-16T00:00:00Z"},{"id":"page_child","workspace_id":"ws_demo","title":"子页面","parent_id":"page_root","sort_order":1,"is_starred":false,"is_template":false,"created_at":"2026-04-16T00:00:00Z","updated_at":"2026-04-16T00:00:00Z"}]},"bridgeLogs:listWorkspaceOverview":{"workspace_id":"ws_demo","command_logs":[{"command_id":"cmd_1","request_id":"req_1","status":"applied","created_at":"2026-04-16T00:00:00Z"}],"domain_events":[{"command_id":"cmd_1","status":"published","created_at":"2026-04-16T00:00:00Z"}],"next_cursor":null,"has_more":false,"filters":{"command_status":null,"event_status":null,"target_page_id":null,"target_block_id":null,"aggregate_type":null,"aggregate_id":null},"generated_at":"2026-04-16T00:00:00Z"}}"#.into()),
+            mutation_fixtures_json: None,
             dev_user_id: "dev-user".into(),
             dev_user_name: "开发用户".into(),
             dev_user_email: "dev@mnote.local".into(),

rust/crates/mnote-web/src/routes/command_support.rs

@@ -0,0 +1,110 @@
+use crate::app::AppConfig;
+use crate::context::RequestContext;
+use crate::error::WebError;
+use crate::transport::convex::execute_convex_command_plan;
+use bridge_runtime::{
+    execute_runtime_input, RuntimeActorWire, RuntimeBridgeContextWire, RuntimeCommandEnvelopeWire,
+    RuntimeCommandExecutionPlan, RuntimeExecutionPlan, RuntimeInput, RuntimeSourceWire,
+    RuntimeTargetWire,
+};
+use serde_json::Value;
+
+pub fn runtime_context(
+    context: &RequestContext,
+    effective_workspace_id: Option<&str>,
+) -> RuntimeBridgeContextWire {
+    RuntimeBridgeContextWire {
+        deployment_id: context.workspace.deployment_id.clone(),
+        project_id: context.workspace.project_id.clone(),
+        workspace_id: effective_workspace_id
+            .map(ToOwned::to_owned)
+            .or_else(|| context.workspace.workspace_id.clone()),
+        request_id: context.trace.request_id.clone(),
+        trace_id: context.trace.trace_id.clone(),
+        actor: RuntimeActorWire {
+            actor_type: context.auth.actor_type.clone(),
+            actor_id: context.auth.actor_id.clone(),
+            session_id: context.auth.session_id.clone(),
+        },
+        source: RuntimeSourceWire {
+            channel: context.source.channel.clone(),
+            client: context.source.client.clone(),
+        },
+        tenant_id: context.workspace.tenant_id.clone(),
+        auth_token: context.auth.authorization.clone(),
+        idempotency_key: context.source.idempotency_key.clone(),
+        validate_only: false,
+        dry_run: false,
+    }
+}
+
+pub fn build_runtime_command_plan(
+    context: &RequestContext,
+    effective_workspace_id: Option<&str>,
+    command: RuntimeCommandEnvelopeWire,
+) -> Result<RuntimeCommandExecutionPlan, WebError> {
+    let runtime_input = RuntimeInput::Command {
+        context: runtime_context(context, effective_workspace_id),
+        command,
+    };
+    let RuntimeExecutionPlan::Command(plan) = execute_runtime_input(runtime_input)
+        .map_err(|error| WebError::bad_request(error.message).with_context(context))?
+    else {
+        return Err(WebError::internal("runtime command 未返回 command plan").with_context(context));
+    };
+
+    Ok(plan)
+}
+
+pub async fn execute_runtime_command_via_convex(
+    config: &AppConfig,
+    context: &RequestContext,
+    effective_workspace_id: Option<&str>,
+    command: RuntimeCommandEnvelopeWire,
+) -> Result<Value, WebError> {
+    let plan = build_runtime_command_plan(context, effective_workspace_id, command)?;
+    execute_convex_command_plan(config, context, &plan).await
+}
+
+pub fn build_tree_target(
+    workspace_id: &str,
+    page_id: Option<&str>,
+    block_id: Option<&str>,
+) -> RuntimeTargetWire {
+    RuntimeTargetWire {
+        workspace_id: Some(workspace_id.to_string()),
+        page_id: page_id.map(ToOwned::to_owned),
+        block_id: block_id.map(ToOwned::to_owned),
+    }
+}
+
+pub fn ensure_non_empty(value: &str, field: &'static str, context: &RequestContext) -> Result<String, WebError> {
+    let trimmed = value.trim();
+    if trimmed.is_empty() {
+        return Err(WebError::bad_request_code(
+            "tree_command_validation",
+            format!("{field} 不能为空"),
+        )
+        .with_context(context)
+        .with_header("x-error-phase", "tree_command_validate"));
+    }
+    Ok(trimmed.to_string())
+}
+
+pub fn read_optional_non_empty(value: Option<String>) -> Option<String> {
+    value
+        .map(|item| item.trim().to_string())
+        .filter(|item| !item.is_empty())
+}
+
+pub fn ensure_sort_order(sort_order: i64, context: &RequestContext) -> Result<i64, WebError> {
+    if sort_order < 0 {
+        return Err(WebError::bad_request_code(
+            "tree_command_validation",
+            "sortOrder 不能小于 0",
+        )
+        .with_context(context)
+        .with_header("x-error-phase", "tree_command_validate"));
+    }
+    Ok(sort_order)
+}

rust/crates/mnote-web/src/routes/compat.rs

@@ -69,7 +69,8 @@ pub async fn next_sidebar(
                 "workspaceId": effective_workspace_id,
             }),
         },
-    )?;
+    )
+    .await?;
     let projection = execute_runtime_query_against_data(
         &context,
         Some(&effective_workspace_id),
@@ -115,10 +116,6 @@ mod tests {
     use tower::util::ServiceExt;
 
     fn app() -> axum::Router {
-        std::env::set_var(
-            "MNOTE_WEB_QUERY_FIXTURES_JSON",
-            r#"{"sidebar:datasetList":{"active_workspace_id":"ws_demo","workspaces":[],"documents":[{"id":"page_root","workspace_id":"ws_demo","title":"工作区首页","parent_id":null,"sort_order":0,"is_starred":true,"is_template":false,"created_at":"2026-04-16T00:00:00Z","updated_at":"2026-04-16T00:00:00Z"},{"id":"page_child","workspace_id":"ws_demo","title":"子页面","parent_id":"page_root","sort_order":1,"is_starred":false,"is_template":false,"created_at":"2026-04-16T00:00:00Z","updated_at":"2026-04-16T00:00:00Z"}],"trashed_documents":[],"media_assets":[],"trashed_media_assets":[],"mindmap_assets":[],"trashed_mindmap_assets":[],"table_assets":[],"trashed_table_assets":[],"mindmap_docs":[],"mindmap_asset_children":{}},"bridgeLogs:listWorkspaceOverview":{"workspace_id":"ws_demo","command_logs":[],"domain_events":[],"next_cursor":null,"has_more":false,"filters":{"command_status":null,"event_status":null,"target_page_id":null,"target_block_id":null,"aggregate_type":null,"aggregate_id":null},"generated_at":"2026-04-16T00:00:00Z"}}"#,
-        );
         build_app(AppState::new(AppConfig {
             service_name: "mnote-web".into(),
             service_version: "0.1.0".into(),
@@ -128,6 +125,8 @@ mod tests {
             convex_url: None,
             convex_admin_key: None,
             allow_dev_fixtures: true,
+            query_fixtures_json: Some(r#"{"sidebar:datasetList":{"active_workspace_id":"ws_demo","workspaces":[],"documents":[{"id":"page_root","workspace_id":"ws_demo","title":"工作区首页","parent_id":null,"sort_order":0,"is_starred":true,"is_template":false,"created_at":"2026-04-16T00:00:00Z","updated_at":"2026-04-16T00:00:00Z"},{"id":"page_child","workspace_id":"ws_demo","title":"子页面","parent_id":"page_root","sort_order":1,"is_starred":false,"is_template":false,"created_at":"2026-04-16T00:00:00Z","updated_at":"2026-04-16T00:00:00Z"}],"trashed_documents":[],"media_assets":[],"trashed_media_assets":[],"mindmap_assets":[],"trashed_mindmap_assets":[],"table_assets":[],"trashed_table_assets":[],"mindmap_docs":[],"mindmap_asset_children":{}},"bridgeLogs:listWorkspaceOverview":{"workspace_id":"ws_demo","command_logs":[],"domain_events":[],"next_cursor":null,"has_more":false,"filters":{"command_status":null,"event_status":null,"target_page_id":null,"target_block_id":null,"aggregate_type":null,"aggregate_id":null},"generated_at":"2026-04-16T00:00:00Z"}}"#.into()),
+            mutation_fixtures_json: None,
             dev_user_id: "dev-user".into(),
             dev_user_name: "开发用户".into(),
             dev_user_email: "dev@mnote.local".into(),

rust/crates/mnote-web/src/routes/kernel.rs

@@ -52,7 +52,7 @@ fn sidebar_dataset_query(workspace_id: &str) -> RuntimeQueryEnvelopeWire {
     }
 }
 
-fn load_sidebar_dataset(
+async fn load_sidebar_dataset(
     config: &AppConfig,
     context: &RequestContext,
     workspace_id: &str,
@@ -63,6 +63,7 @@ fn load_sidebar_dataset(
         Some(workspace_id),
         sidebar_dataset_query(workspace_id),
     )
+    .await
 }
 
 fn execute_kernel_query(
@@ -94,7 +95,7 @@ pub async fn project_sidebar(
     let effective_workspace_id =
         resolve_effective_workspace_id(&context, query.workspace_id.as_deref(), true)?
             .expect("workspace_required 已确保存在");
-    let dataset = load_sidebar_dataset(state.config(), &context, &effective_workspace_id)?;
+    let dataset = load_sidebar_dataset(state.config(), &context, &effective_workspace_id).await?;
     let result = execute_kernel_query(
         &context,
         &effective_workspace_id,
@@ -124,7 +125,7 @@ pub async fn subtree(
     let effective_workspace_id =
         resolve_effective_workspace_id(&context, query.workspace_id.as_deref(), true)?
             .expect("workspace_required 已确保存在");
-    let dataset = load_sidebar_dataset(state.config(), &context, &effective_workspace_id)?;
+    let dataset = load_sidebar_dataset(state.config(), &context, &effective_workspace_id).await?;
     let result = execute_kernel_query(
         &context,
         &effective_workspace_id,
@@ -151,7 +152,7 @@ pub async fn edges(
     let effective_workspace_id =
         resolve_effective_workspace_id(&context, query.workspace_id.as_deref(), true)?
             .expect("workspace_required 已确保存在");
-    let dataset = load_sidebar_dataset(state.config(), &context, &effective_workspace_id)?;
+    let dataset = load_sidebar_dataset(state.config(), &context, &effective_workspace_id).await?;
     let result = execute_kernel_query(
         &context,
         &effective_workspace_id,
@@ -176,7 +177,7 @@ pub async fn graph(
     let effective_workspace_id =
         resolve_effective_workspace_id(&context, query.workspace_id.as_deref(), true)?
             .expect("workspace_required 已确保存在");
-    let dataset = load_sidebar_dataset(state.config(), &context, &effective_workspace_id)?;
+    let dataset = load_sidebar_dataset(state.config(), &context, &effective_workspace_id).await?;
     let result = execute_kernel_query(
         &context,
         &effective_workspace_id,
@@ -202,10 +203,6 @@ mod tests {
     use tower::util::ServiceExt;
 
     fn app() -> axum::Router {
-        std::env::set_var(
-            "MNOTE_WEB_QUERY_FIXTURES_JSON",
-            r#"{"sidebar:datasetList":{"documents":[{"id":"page_root","workspace_id":"ws_demo","title":"工作区首页","parent_id":null,"sort_order":0,"is_starred":true,"is_template":false,"created_at":"2026-04-16T00:00:00Z","updated_at":"2026-04-16T00:00:00Z"},{"id":"page_child","workspace_id":"ws_demo","title":"子页面","parent_id":"page_root","sort_order":1,"is_starred":false,"is_template":false,"created_at":"2026-04-16T00:00:00Z","updated_at":"2026-04-16T00:00:00Z"}]},"bridgeLogs:listWorkspaceOverview":{"workspace_id":"ws_demo","command_logs":[{"command_id":"cmd_1","request_id":"req_1","status":"applied","created_at":"2026-04-16T00:00:00Z"}],"domain_events":[{"command_id":"cmd_1","status":"published","created_at":"2026-04-16T00:00:00Z"}],"next_cursor":null,"has_more":false,"filters":{"command_status":null,"event_status":null,"target_page_id":null,"target_block_id":null,"aggregate_type":null,"aggregate_id":null},"generated_at":"2026-04-16T00:00:00Z"}}"#,
-        );
         build_app(AppState::new(AppConfig {
             service_name: "mnote-web".into(),
             service_version: "0.1.0".into(),
@@ -215,6 +212,8 @@ mod tests {
             convex_url: None,
             convex_admin_key: None,
             allow_dev_fixtures: true,
+            query_fixtures_json: Some(r#"{"sidebar:datasetList":{"documents":[{"id":"page_root","workspace_id":"ws_demo","title":"工作区首页","parent_id":null,"sort_order":0,"is_starred":true,"is_template":false,"created_at":"2026-04-16T00:00:00Z","updated_at":"2026-04-16T00:00:00Z"},{"id":"page_child","workspace_id":"ws_demo","title":"子页面","parent_id":"page_root","sort_order":1,"is_starred":false,"is_template":false,"created_at":"2026-04-16T00:00:00Z","updated_at":"2026-04-16T00:00:00Z"}]},"bridgeLogs:listWorkspaceOverview":{"workspace_id":"ws_demo","command_logs":[{"command_id":"cmd_1","request_id":"req_1","status":"applied","created_at":"2026-04-16T00:00:00Z"}],"domain_events":[{"command_id":"cmd_1","status":"published","created_at":"2026-04-16T00:00:00Z"}],"next_cursor":null,"has_more":false,"filters":{"command_status":null,"event_status":null,"target_page_id":null,"target_block_id":null,"aggregate_type":null,"aggregate_id":null},"generated_at":"2026-04-16T00:00:00Z"}}"#.into()),
+            mutation_fixtures_json: None,
             dev_user_id: "dev-user".into(),
             dev_user_name: "开发用户".into(),
             dev_user_email: "dev@mnote.local".into(),

rust/crates/mnote-web/src/routes/mod.rs

@@ -1,10 +1,12 @@
 mod bridge;
+mod command_support;
 mod compat;
 mod health;
 mod hermes;
 mod kernel;
 mod query_support;
 mod sse;
+mod tree;
 mod ws;
 
 use crate::app::AppState;
@@ -17,6 +19,7 @@ pub fn build_router(state: AppState) -> Router {
 
     Router::new()
         .route("/health", get(health::health))
+        .route("/tree", get(tree::tree_shell))
         .route(
             "/api/kernel/projections/sidebar",
             get(kernel::project_sidebar),
@@ -24,6 +27,7 @@ pub fn build_router(state: AppState) -> Router {
         .route("/api/kernel/subtree", get(kernel::subtree))
         .route("/api/kernel/edges", get(kernel::edges))
         .route("/api/kernel/graph", get(kernel::graph))
+        .route("/api/tree/commands", post(tree::tree_command))
         .route("/api/bridge/workspace", get(bridge::workspace))
         .route("/api/bridge/request", get(bridge::request))
         .route("/api/bridge/trace", get(bridge::trace))

rust/crates/mnote-web/src/routes/query_support.rs

@@ -96,14 +96,14 @@ pub fn build_runtime_query_plan(
     Ok(plan)
 }
 
-pub fn fetch_query_data_via_convex(
+pub async fn fetch_query_data_via_convex(
     config: &AppConfig,
     context: &RequestContext,
     effective_workspace_id: Option<&str>,
     query: RuntimeQueryEnvelopeWire,
 ) -> Result<Value, WebError> {
     let plan = build_runtime_query_plan(context, effective_workspace_id, query)?;
-    execute_convex_query_plan(config, context, &plan)
+    execute_convex_query_plan(config, context, &plan).await
 }
 
 pub fn execute_runtime_query_against_data(
@@ -120,12 +120,12 @@ pub fn execute_runtime_query_against_data(
     .map_err(|error| WebError::bad_request(error.message).with_context(context))
 }
 
-pub fn execute_runtime_query_via_convex(
+pub async fn execute_runtime_query_via_convex(
     config: &AppConfig,
     context: &RequestContext,
     effective_workspace_id: Option<&str>,
     query: RuntimeQueryEnvelopeWire,
 ) -> Result<Value, WebError> {
-    let data = fetch_query_data_via_convex(config, context, effective_workspace_id, query.clone())?;
+    let data = fetch_query_data_via_convex(config, context, effective_workspace_id, query.clone()).await?;
     execute_runtime_query_against_data(context, effective_workspace_id, query, data)
 }