refactor: simplify implementation

Author: trly

AGENTS.md

@@ -4,23 +4,27 @@
 
 - `./install.sh` - Initialize workstation with development tools (bootstrap)
 - `./install.sh --install-path /custom/path` - Install to custom directory
-- `./revenue init` - Initialize workstation (alternative method)
+- `./revenue init` - Initialize workstation (delegates to install.sh)
 - `./revenue init --install-path /custom/path` - Initialize with custom installation path
 - `./revenue update` - Update existing tools and packages  
 - `./revenue help` - Show usage help
-- `revenue init|update|demo` - Global command after setup
+- `revenue init|update|demo|help` - Available global commands after setup
 
 ## Demo Management Commands
 
 - `revenue demo start <language> <framework>` - Start a demo application
 - `revenue demo start all` - Start all demo applications
 - `revenue demo stop <language> <framework>` - Stop a specific demo
 - `revenue demo stop all` - Stop all running demos
+- `revenue demo restart <language> <framework>` - Restart a demo application
+- `revenue demo restart all` - Restart all running demo applications
 - `revenue demo logs <language> <framework>` - View logs from a running demo
 - `revenue demo connect <language> <framework>` - Connect to a running demo session
-- `revenue demo list` - List all available demos
+- `revenue demo list` - List all available demos and their status
 - `revenue demo running` - List currently running demos
-- `revenue demo clean --confirm` - Reset demo directory
+- `revenue demo clean --confirm` - Force cleanup all processes and sockets
+- `revenue demo reset --confirm` - Reset to clean git state
+- `revenue demo help` - Show demo usage help
 - Direct usage: `cd amp_demos && ./demo <command>`
 
 ## Architecture
@@ -39,30 +43,40 @@ The demo system manages multiple language/framework combinations using an Overmi
 
 - **Discovery**: Scans `amp_demos/` for directories containing `Procfile` configuration files
 - **Process Management**: Uses Overmind with tmux sessions to manage demo processes
-- **Tool Management**: Integrates with `mise` for per-demo tool installation
+- **Tool Management**: Integrates with `mise` for per-demo tool installation and automatic trusting
 - **Directory Structure**: `amp_demos/<language>/<framework>/Procfile`
 
 Each demo application must have:
+
 - `Procfile` - Standard Heroku-style process definition file
 - `.env` - Environment variables (PORT, LANGUAGE, FRAMEWORK)
 - Optional: `.mise.toml` or `.tool-versions` for tool requirements
 
+The system automatically:
+
+- Trusts mise configurations silently
+- Installs tools and dependencies before starting demos
+- Cleans up socket files when starting/stopping
+- Provides URL information based on PORT from .env file
+
 #### Demo Configuration Format
 
 ##### Procfile (standard Procfile format)
+
 ```Procfile
 setup: pnpm install --silent  # Optional: dependency installation command
 web: pnpm start               # Required: command to start the web process
 ```
 
 ##### .env (environment variables)
+
 ```env
 PORT=3000
 LANGUAGE=javascript
 FRAMEWORK=react
 ```
 
-Demo sessions are named as `<language>-<framework>` and managed by Overmind using tmux for process isolation.
+Demo processes are managed individually (not as named sessions) with Overmind handling the tmux session management automatically.
 
 ## Code Style
 

README.md

@@ -23,9 +23,19 @@ needed for demos and development.
 Once setup is complete, you can use the `revenue` command:
 
 ```bash
-revenue demo list        # See available demo apps
-revenue demo start python flask  # Start a specific demo
-revenue update          # Update tools to latest versions
+revenue demo list                    # See available demo apps
+revenue demo running                 # See only running demos
+revenue demo start python flask     # Start a specific demo
+revenue demo start all               # Start all demos
+revenue demo stop python flask      # Stop a specific demo
+revenue demo stop all                # Stop all demos
+revenue demo restart python flask   # Restart a specific demo
+revenue demo restart all             # Restart all running demos
+revenue demo logs python flask      # View logs from a running demo
+revenue demo connect python flask   # Connect to a running demo session
+revenue demo clean --confirm         # Force cleanup all processes and sockets
+revenue demo reset --confirm         # Reset to clean git state
+revenue update                       # Update tools to latest versions
 revenue init --install-path /custom/path  # Reinstall to custom location
 ```
 

amp_demos/AGENTS.md

@@ -0,0 +1,35 @@
+# AGENTS.md
+
+## Build/Test/Lint Commands
+
+Demo management:
+
+- `./demo start <language> <framework>` - Start a specific demo (e.g., `./demo start python flask`)
+- `./demo stop <language> <framework>` - Stop a demo
+- `./demo start all` / `./demo stop all` - Start/stop all demos
+- `./demo list` - List available demos and status
+- `./demo logs <language> <framework>` - View logs from running demo
+- `./demo connect <language> <framework>` - Connect to running demo session
+
+Framework-specific commands:
+
+- JavaScript/React: `pnpm install` (setup), `pnpm start` (dev server), `pnpm build` (production build)
+- Python/Flask: `mise run dev` (runs Flask dev server), pytest tests via dev dependencies
+- Java/Spring Boot & Ktor: `./gradlew bootRun` (start), `./gradlew build` (build)
+
+## Architecture
+
+Multi-language demo collection using Overmind process manager:
+
+- `amp_demos/` - Root demo directory containing language-specific subdirectories
+- `<language>/<framework>/` - Individual demo applications (react, flask, spring-boot, ktor, svelte)
+- Each demo requires: `Procfile` (process definition), `.env` (PORT, LANGUAGE, FRAMEWORK variables)
+- Tool management via mise (`.mise.toml` files for Node, Python, Java toolchains)
+- Process orchestration: Overmind with tmux sessions named `<language>-<framework>`
+
+## Code Style
+
+- Shell scripts: bash with `set -e`, colored output helpers (`print_success`, `print_error`)
+- Function naming: snake_case for bash functions
+- Error handling: fail fast with clear error messages, graceful degradation where appropriate
+- Configuration: Standard formats (Procfile, .env, package.json, pyproject.toml, build.gradle)

amp_demos/README.md

@@ -49,7 +49,7 @@ You can use the demo manager directly or through the main setup script:
 ### Via revenue command (recommended)
 
 ```bash
-# From anywhere (after running ./setup.sh init)
+# From anywhere (after running ./install.sh)
 revenue demo start <language> <framework>
 revenue demo stop <language> <framework>  
 revenue demo list
@@ -86,10 +86,17 @@ cd amp_demos
 ./demo stop all                       # Stop all running demos
 ```
 
+### Restart a Demo
+
+```bash
+./demo restart <language> <framework> # Restart a specific demo
+./demo restart all                     # Restart all running demos
+```
+
 ### View and Interact with Demos
 
 ```bash
-./demo logs <language> <framework>    # View logs from a running demo
+./demo logs <language> <framework>    # View logs from a running demo (Ctrl+C to exit)
 ./demo connect <language> <framework> # Connect to a running demo session
 ```
 
@@ -103,7 +110,9 @@ cd amp_demos
 ### Clean Environment
 
 ```bash
-./demo clean --confirm                # Reset git state and stop all demos
+./demo clean --confirm                # Force cleanup all processes and sockets
+./demo reset --confirm                # Reset to clean git state (clean + git restore)
+./demo help                           # Show usage help
 ```
 
 ## How It Works
@@ -124,6 +133,12 @@ named `<language>-<framework>`
 # Start all available demos
 ./demo start all
 
+# Restart a specific demo
+./demo restart python flask
+
+# Restart all running demos
+./demo restart all
+
 # View logs from a running demo
 ./demo logs python flask
 
@@ -135,6 +150,15 @@ named `<language>-<framework>`
 
 # List available demos
 ./demo list
+
+# Show only running demos
+./demo running
+
+# Force cleanup all processes
+./demo clean --confirm
+
+# Reset to clean git state
+./demo reset --confirm
 ```
 
 ## Process Management