docs: clarify CLI args and stub status

Author: jdrhyne

docs/PLUGIN.md

@@ -20,31 +20,37 @@ plugin/manifest.json
 The plugin exposes the CLI commands directly. The general form is:
 
 ```sh
-dws-cli <command> [args]
+dws <command> [args]
 ```
 
+> Note: Several commands are **stubs** until the DWS API integration is wired in. They will emit placeholder output with `status: "stub"`.
+
 ### Examples
 
 ```sh
-dws-cli setup
+dws setup --api-key <key>
+```
+
+```sh
+dws preflight <htmlPath>
 ```
 
 ```sh
-dws-cli preflight
+dws convert <htmlPath> --output output.pdf --deterministic
 ```
 
 ```sh
-dws-cli convert
+dws benchmark --suite W1-W6 --out results.json
 ```
 
 ```sh
-dws-cli benchmark
+dws report --in results.json --out report.md
 ```
 
 ```sh
-dws-cli report
+dws skills list
 ```
 
 ```sh
-dws-cli skills
+dws skills add /path/to/skill
 ```

plugin/manifest.json

@@ -4,27 +4,27 @@
   "description": "CLI for DWS setup, validation, conversion, benchmarking, reporting, and skills.",
   "commands": {
     "setup": {
-      "command": "dws-cli setup",
+      "command": "dws setup",
       "description": "Initialize or configure the DWS environment."
     },
     "preflight": {
-      "command": "dws-cli preflight",
-      "description": "Run preflight checks before conversion or benchmarks."
+      "command": "dws preflight <htmlPath>",
+      "description": "Run preflight checks on an HTML file (stub output)."
     },
     "convert": {
-      "command": "dws-cli convert",
-      "description": "Convert inputs using the DWS pipeline."
+      "command": "dws convert <htmlPath> --output <path>",
+      "description": "Convert HTML to PDF (stub output)."
     },
     "benchmark": {
-      "command": "dws-cli benchmark",
-      "description": "Run benchmarks against a dataset or config."
+      "command": "dws benchmark --suite <name>",
+      "description": "Run benchmark placeholders and write results JSON."
     },
     "report": {
-      "command": "dws-cli report",
-      "description": "Generate or view benchmark reports."
+      "command": "dws report --in <results.json> --out <report.md>",
+      "description": "Generate a markdown report from benchmark results."
     },
     "skills": {
-      "command": "dws-cli skills",
+      "command": "dws skills <subcommand>",
       "description": "List or manage DWS skills."
     }
   }