Restructure examples directory: rename demo to dashboard, add job/sidecar/worker patterns

- Rename examples/demo/ to examples/dashboard/
- Add job example with task-based lifecycle and observation
- Add sidecar example with companion process pattern
- Add worker example with background worker pattern
- Add supervisor example with nested supervision tree
- Update supervisor_examples_test to cover all example types

Author: developerworks

README.md

@@ -175,7 +175,7 @@ async fn main() -> Result<(), rust_supervisor::error::types::SupervisorError> {
 ## Examples
 
 ```bash
-cargo run --example demo -- --config examples/config/supervisor.yaml
+cargo run --example dashboard -- --config examples/config/supervisor.yaml
 cargo run --example supervisor_quickstart
 cargo run --example config_tree_supervisor
 cargo run --example restart_policy_lab
@@ -187,7 +187,7 @@ cargo run --example policy_failure_matrix
 cargo run --example diagnostic_replay
 ```
 
-`cargo run --example demo -- --config examples/config/supervisor.yaml` is the three-end supervisor demo. It starts the library-only supervisor runtime from the same configuration file, then starts the demo-only dashboard IPC service and registration heartbeat inside `examples/demo`. This entry point is not the production binary for the crate, and it does not write demo state into the core `src` modules.
+`cargo run --example dashboard -- --config examples/config/supervisor.yaml` is the three-end supervisor demo. It starts the library-only supervisor runtime from the same configuration file, then starts the demo-only dashboard IPC service and registration heartbeat inside `examples/dashboard`. This entry point is not the production binary for the crate, and it does not write demo state into the core `src` modules.
 
 ## Manuals
 

examples/demo/args.rs examples/dashboard/args.rsexamples/demo/args.rs renamed to examples/dashboard/args.rs

@@ -0,0 +1,24 @@
+# Job Role Example
+
+[中文说明](README.zh.md)
+
+This example shows a one-shot `WorkRole::Job` child. A job role is intended for finite work that should finish and then stay stopped.
+
+Run it with:
+
+```bash
+cargo run --package rust-tokio-supervisor --example job
+```
+
+## What It Shows
+
+- Initialization: `job_task.rs` builds a `daily-report-job` child and marks it as ready.
+- Running: the job runs one report-generation business function and prints the current UNIX time.
+- Completion: the job returns `TaskResult::Succeeded`, matching the job role's one-shot behavior.
+- Cleanup: `main.rs` calls `shutdown_tree` after the job has stopped itself.
+
+## File Layout
+
+- `main.rs`: wires the supervisor, event subscription, state snapshots, and cleanup shutdown.
+- `job_task.rs`: declares the `WorkRole::Job` child and the one-shot job body.
+- `observation.rs`: prints job facts, runtime events, current state records, and shutdown outcomes.

examples/demo/bootstrap.rs examples/dashboard/bootstrap.rsexamples/demo/bootstrap.rs renamed to examples/dashboard/bootstrap.rs

@@ -0,0 +1,24 @@
+# Job(一次性任务) 角色示例
+
+[English README](README.md)
+
+这个示例展示一个一次性 `WorkRole::Job`(工作角色: 一次性任务) 子任务. Job(一次性任务) 角色适合有限工作, 工作完成后应该停止.
+
+运行命令:
+
+```bash
+cargo run --package rust-tokio-supervisor --example job
+```
+
+## 示例展示内容
+
+- 初始化: `job_task.rs` 构建 `daily-report-job` 子任务, 并报告 readiness(就绪状态).
+- 运行: job(一次性任务) 执行一次 report generation(报告生成) 业务函数, 并输出当前 UNIX time(UNIX 时间).
+- 完成: job(一次性任务) 返回 `TaskResult::Succeeded`(任务成功), 对齐 job(一次性任务) 一次性运行的角色语义.
+- 清理: job(一次性任务) 自己停止后, `main.rs` 调用 `shutdown_tree`(关闭监督树) 清理 runtime(运行时).
+
+## 文件结构
+
+- `main.rs`: 组合 supervisor(监督器), event subscription(事件订阅), state snapshot(状态快照) 和 cleanup shutdown(清理关闭).
+- `job_task.rs`: 声明 `WorkRole::Job`(工作角色: 一次性任务) 子任务, 并实现 one-shot job body(一次性任务主体).
+- `observation.rs`: 输出 job fact(一次性任务事实), runtime event(运行时事件), current state record(当前状态记录) 和 shutdown outcome(关闭结果).