docs: fix deploy ci, update cli docs, fix xtask so it can generate them

.github/workflows/mdbook.yml

@@ -21,6 +21,7 @@ jobs:
       - uses: actions/checkout@v4
         with:
           sparse-checkout: |
+            book.toml
             snops_book
             index.html
 

crates/xtask/src/main.rs

@@ -43,7 +43,11 @@ fn try_main() -> Result<()> {
 fn clipages(sh: &Shell) -> Result<()> {
     cmd!(sh, "cargo run -p snarkos-aot --features=docpages -- md").run()?;
     cmd!(sh, "cargo run -p snops --features=docpages -- md").run()?;
-    cmd!(sh, "cargo run -p snops-agent --features=docpages -- md").run()?;
+    cmd!(
+        sh,
+        "cargo run -p snops-agent --features=docpages -- --id foo md"
+    )
+    .run()?;
     cmd!(sh, "cargo run -p snops-cli --features=docpages -- md").run()?;
     Ok(())
 }

snops_book/user_guide/clis/SNOPS_AGENT.md

@@ -10,7 +10,7 @@ This document contains the help content for the `snops-agent` command-line progr
 
 ## `snops-agent`
 
-**Usage:** `snops-agent [OPTIONS] <COMMAND>`
+**Usage:** `snops-agent [OPTIONS] --id <ID> <COMMAND>`
 
 ###### **Subcommands:**
 
@@ -20,9 +20,9 @@ This document contains the help content for the `snops-agent` command-line progr
 ###### **Options:**
 
 * `--endpoint <ENDPOINT>` — Control plane endpoint address (IP, or wss://host, http://host)
-* `--id <ID>`
+* `--id <ID>` — Agent ID, used to identify the agent in the network
 * `--private-key-file <PRIVATE_KEY_FILE>` — Locally provided private key file, used for envs where private keys are locally provided
-* `--labels <LABELS>`
+* `--labels <LABELS>` — Labels to attach to the agent, used for filtering and grouping
 * `--path <PATH>` — Path to the directory containing the stored data and configuration
 
   Default value: `./snops-data`