Warning, /swf-testbed/CLAUDE.md is written in an unsupported language. File is not indexed.
0001 # CLAUDE.md
0002
0003 ## Essential Commands
0004
0005 ```bash
0006 # Environment (required before any Python command)
0007 cd /data/wenauseic/github/swf-testbed && source .venv/bin/activate && source ~/.env
0008
0009 # Run workflows
0010 testbed run # Uses workflows/testbed.toml
0011 testbed run fast_processing # Uses workflows/fast_processing_default.toml
0012
0013 # Check status
0014 testbed status-local # System services + agents
0015 ```
0016
0017 ```python
0018 # MCP tools (preferred over CLI for AI operations)
0019 swf_get_testbed_status(username) # Comprehensive status
0020 swf_start_user_testbed(username) # Start testbed
0021 swf_stop_user_testbed(username) # Stop testbed
0022 swf_start_workflow() # Start workflow
0023 swf_stop_workflow(execution_id) # Stop workflow
0024 swf_list_logs(level='ERROR') # Find failures
0025 swf_list_logs(execution_id='...') # Workflow logs
0026 ```
0027
0028 ## Project-Specific Rules
0029
0030 **Branch:** All 3 repos must be on `infra/baseline-v34`
0031
0032 **First push:** `git push -u origin branch-name` sets up tracking.
0033
0034 **ActiveMQ destinations:** Must have prefix — use `'/topic/epictopic'` not `'epictopic'`.
0035
0036 **MCP tool changes:** When adding/modifying MCP tools, update: (1) `swf_list_available_tools()` hardcoded list in mcp.py, (2) server instructions in settings.py, (3) docs/MCP.md.
0037
0038 ## Gotchas
0039
0040 | Wrong | Right |
0041 |-------|-------|
0042 | `nohup python agent.py &` | `testbed run` |
0043 | `tail -f logs/file.log` | `swf_list_logs()` via MCP |
0044 | `swf_list_logs()` (no filter) | `swf_list_logs(level='ERROR')` or `swf_list_logs(execution_id='...')` |
0045 | Relative paths `../swf-monitor` | Absolute `/data/wenauseic/github/swf-monitor` |
0046
0047 **MCP query limits:** Always filter queries. Unbounded `swf_list_agents(status='all')` or `swf_list_logs()` can exceed context limits.
0048
0049 Docs: See `README.md`, `docs/` in each repo, and [MCP.md](../swf-monitor/docs/MCP.md) for tool reference.
