claude-comms 1.0.46 → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (54) hide show
  1. package/CHANGELOG.md +20 -1
  2. package/README.md +12 -13
  3. package/package.json +6 -10
  4. package/.agents/AGENTS.md +0 -61
  5. package/.agents/repo.md +0 -18
  6. package/.agents/tools/README.md +0 -45
  7. package/.agents/tools/agent-job/README.md +0 -208
  8. package/.agents/tools/agent-job/__pycache__/agent_monitor.cpython-312.pyc +0 -0
  9. package/.agents/tools/agent-job/agent_job.py +0 -936
  10. package/.agents/tools/agent-job/agent_monitor.py +0 -575
  11. package/.agents/tools/agent-job/consultant_template.txt +0 -73
  12. package/.agents/tools/chrome-devtools/README.md +0 -101
  13. package/.agents/tools/chrome-devtools/browsertools.py +0 -839
  14. package/.agents/tools/chrome-devtools/config.json +0 -24
  15. package/.agents/tools/workflow/CONSUMER_SETUP.md +0 -114
  16. package/.agents/tools/workflow/ONBOARD.md +0 -167
  17. package/.agents/tools/workflow/README.md +0 -169
  18. package/.agents/tools/workflow/cli.ts +0 -726
  19. package/.agents/tools/workflow/config.example.json +0 -16
  20. package/.agents/tools/workflow/init.ts +0 -76
  21. package/.agents/tools/workflow/lib/file-tracker.test.ts +0 -81
  22. package/.agents/tools/workflow/lib/file-tracker.ts +0 -387
  23. package/.agents/tools/workflow/lib/harness-executor.ts +0 -649
  24. package/.agents/tools/workflow/lib/prompts.scenario.test.ts +0 -262
  25. package/.agents/tools/workflow/lib/prompts.ts +0 -548
  26. package/.agents/tools/workflow/lib/streams.test.ts +0 -140
  27. package/.agents/tools/workflow/lib/streams.ts +0 -254
  28. package/.agents/tools/workflow/runner.ts +0 -994
  29. package/.agents/tools/workflow/templates/document.md +0 -42
  30. package/.agents/tools/workflow/templates/implement.md +0 -117
  31. package/.agents/tools/workflow/templates/plan.md +0 -54
  32. package/.agents/tools/workflow/templates/pm.md +0 -84
  33. package/.agents/tools/workflow/templates/product-owner.md +0 -211
  34. package/.agents/tools/workflow/templates/review.md +0 -56
  35. package/.agents/tools/workflow/templates/uat.md +0 -71
  36. package/.claude/agents/core/engineer.md +0 -146
  37. package/.claude/commands/action-feedback-item.md +0 -27
  38. package/.claude/commands/install-feedback-widget.md +0 -599
  39. package/.claude/commands/learn.md +0 -32
  40. package/.claude/hooks/comms/__pycache__/register_subagent.cpython-312.pyc +0 -0
  41. package/.claude/hooks/comms/__pycache__/update_subagent_completion.cpython-312.pyc +0 -0
  42. package/.claude/hooks/comms/get_unread_messages.py +0 -71
  43. package/.claude/hooks/comms/register_subagent.py +0 -74
  44. package/.claude/hooks/comms/send_message.py +0 -87
  45. package/.claude/hooks/comms/update_subagent_completion.py +0 -126
  46. package/.claude/hooks/context/session_id.py +0 -35
  47. package/.claude/hooks/observability/send_event.py +0 -110
  48. package/.claude/hooks/session-data/get_session_data.py +0 -261
  49. package/.claude/hooks/session-data/intercept_session_id.py +0 -69
  50. package/.claude/hooks/utils/__pycache__/server_config.cpython-312.pyc +0 -0
  51. package/.claude/hooks/utils/server_config.py +0 -17
  52. package/.claude/settings.json +0 -108
  53. package/.claude/settings.local.json +0 -46
  54. package/CLAUDE.md +0 -240
@@ -1,101 +0,0 @@
1
- # Chrome DevTools Browser Automation Tool
2
-
3
- Stateful Chrome automation wrapper that reduces context token usage by 96% while maintaining full browser state across multiple CLI invocations.
4
-
5
- ## Quick Start
6
-
7
- ```bash
8
- # From repo root - start daemon in background
9
- uv run .agents/tools/chrome-devtools/browsertools.py daemon start &
10
- sleep 5
11
-
12
- # Use commands - state persists across invocations!
13
- uv run .agents/tools/chrome-devtools/browsertools.py nav http://localhost:5173/
14
- uv run .agents/tools/chrome-devtools/browsertools.py snap
15
- uv run .agents/tools/chrome-devtools/browsertools.py click 1_7
16
- uv run .agents/tools/chrome-devtools/browsertools.py snap
17
-
18
- # Stop when done
19
- uv run .agents/tools/chrome-devtools/browsertools.py daemon stop
20
- ```
21
-
22
- ## Full Command Reference
23
-
24
- Run `uv run .agents/tools/chrome-devtools/browsertools.py --help` to see all commands.
25
-
26
- **Key commands:**
27
- - `daemon start` - Start browser (run in background with `&`)
28
- - `nav <url>` - Navigate to URL
29
- - `snap` - Get page snapshot with element UIDs
30
- - `click <uid>` - Click element
31
- - `fill <uid> <value>` - Fill input/select
32
- - `shot [path]` - Screenshot
33
- - `conslist`, `netlist` - Debug console/network
34
- - `daemon stop` - Clean shutdown
35
-
36
- ## Configuration
37
-
38
- **Default:** Headless mode (no Chrome window)
39
-
40
- **To use visual mode:** Create `~/.browsertools/config.json`:
41
- ```json
42
- {
43
- "mcp_args": ["-y", "chrome-devtools-mcp@latest", "--isolated"]
44
- }
45
- ```
46
-
47
- **For sandbox:** See `config.json` in this directory for examples.
48
-
49
- ## Architecture
50
-
51
- - **Persistent daemon** - Single MCP server runs in background
52
- - **Unix socket bridge** - Multiple CLI commands share state via socket
53
- - **Stateful** - Snapshots, tabs, cookies persist across invocations
54
- - **Clean shutdown** - Process groups ensure no orphaned Chrome processes
55
-
56
-
57
- ## Complete UAT Example
58
-
59
- ```bash
60
- # Start daemon
61
- uv run .agents/tools/chrome-devtools/browsertools.py daemon start &
62
- sleep 5
63
-
64
- # Navigate and get page structure
65
- uv run .agents/tools/chrome-devtools/browsertools.py nav http://app.com/login
66
- uv run .agents/tools/chrome-devtools/browsertools.py snap | grep email
67
- # Found: uid=1_23 input "email"
68
-
69
- # Fill form
70
- uv run .agents/tools/chrome-devtools/browsertools.py fill 1_23 user@example.com
71
- uv run .agents/tools/chrome-devtools/browsertools.py fill 1_24 password
72
- uv run .agents/tools/chrome-devtools/browsertools.py click 1_25
73
-
74
- # Verify
75
- uv run .agents/tools/chrome-devtools/browsertools.py wait "Dashboard"
76
- uv run .agents/tools/chrome-devtools/browsertools.py conslist --types error
77
- uv run .agents/tools/chrome-devtools/browsertools.py shot /tmp/success.png
78
-
79
- # Cleanup
80
- uv run .agents/tools/chrome-devtools/browsertools.py daemon stop
81
- ```
82
-
83
- ## Troubleshooting
84
-
85
- **Chrome window appears:** Remove `~/.browsertools/config.json` to use default headless mode
86
-
87
- **"Daemon not running":**
88
- ```bash
89
- uv run .agents/tools/chrome-devtools/browsertools.py daemon status
90
- uv run .agents/tools/chrome-devtools/browsertools.py daemon start &
91
- ```
92
-
93
- **Timeouts:** Increase with `--timeout` flag on nav/wait commands
94
-
95
- ## Files
96
-
97
- - `browsertools.py` - Main tool (24KB)
98
- - `config.json` - Default config (headless mode)
99
- - `README.md` - This file
100
-
101
- User config at `~/.browsertools/config.json` overrides repo defaults.