Improve documentation and replace publish_on_command with CommandPolicy enum

- Enhanced crate-level documentation with comprehensive examples and feature list
- Improved README with badges, better structure, and clearer examples
- Added README.tpl template and generate-readme.sh script for cargo-readme
- Documented run() and connect_and_run() functions with detailed behavior explanations
- Replaced publish_on_command boolean with CommandPolicy enum (PublishState/Manual)
- Added comprehensive documentation for CommandPolicy explaining both modes

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <[email protected]>

1 files changed, 5 insertions, 0 deletions

diff --git a/generate-readme.sh b/generate-readme.sh
new file mode 100755
index 0000000..18c2123
--- /dev/null
+++ b/generate-readme.sh
@@ -0,0 +1,5 @@
+#!/bin/bash
+set -e
+
+cargo readme -o README.md
+echo "README.md generated successfully"