switchman-dev 0.1.14 → 0.1.15

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 (38) hide show
  1. package/.switchman/audit.key +1 -0
  2. package/.switchman/switchman.db +0 -0
  3. package/README.md +11 -0
  4. package/examples/taskapi/.switchman/audit.key +1 -0
  5. package/examples/taskapi/.switchman/switchman.db +0 -0
  6. package/examples/taskapi/package-lock.json +4736 -0
  7. package/examples/worktrees/agent-rate-limiting/.cursor/mcp.json +8 -0
  8. package/examples/worktrees/agent-rate-limiting/.mcp.json +8 -0
  9. package/examples/worktrees/agent-rate-limiting/package-lock.json +4736 -0
  10. package/examples/worktrees/agent-rate-limiting/package.json +18 -0
  11. package/examples/worktrees/agent-rate-limiting/src/db.js +179 -0
  12. package/examples/worktrees/agent-rate-limiting/src/middleware/auth.js +100 -0
  13. package/examples/worktrees/agent-rate-limiting/src/middleware/validate.js +135 -0
  14. package/examples/worktrees/agent-rate-limiting/src/routes/tasks.js +67 -0
  15. package/examples/worktrees/agent-rate-limiting/src/routes/users.js +38 -0
  16. package/examples/worktrees/agent-rate-limiting/src/server.js +11 -0
  17. package/examples/worktrees/agent-tests/.cursor/mcp.json +8 -0
  18. package/examples/worktrees/agent-tests/.mcp.json +8 -0
  19. package/examples/worktrees/agent-tests/package-lock.json +4736 -0
  20. package/examples/worktrees/agent-tests/package.json +18 -0
  21. package/examples/worktrees/agent-tests/src/db.js +179 -0
  22. package/examples/worktrees/agent-tests/src/middleware/auth.js +98 -0
  23. package/examples/worktrees/agent-tests/src/middleware/validate.js +135 -0
  24. package/examples/worktrees/agent-tests/src/routes/tasks.js +67 -0
  25. package/examples/worktrees/agent-tests/src/routes/users.js +38 -0
  26. package/examples/worktrees/agent-tests/src/server.js +9 -0
  27. package/examples/worktrees/agent-validation/.cursor/mcp.json +8 -0
  28. package/examples/worktrees/agent-validation/.mcp.json +8 -0
  29. package/examples/worktrees/agent-validation/package-lock.json +4736 -0
  30. package/examples/worktrees/agent-validation/package.json +18 -0
  31. package/examples/worktrees/agent-validation/src/db.js +179 -0
  32. package/examples/worktrees/agent-validation/src/middleware/auth.js +100 -0
  33. package/examples/worktrees/agent-validation/src/middleware/validate.js +137 -0
  34. package/examples/worktrees/agent-validation/src/routes/tasks.js +69 -0
  35. package/examples/worktrees/agent-validation/src/routes/users.js +38 -0
  36. package/examples/worktrees/agent-validation/src/server.js +11 -0
  37. package/package.json +1 -1
  38. package/src/core/sync.js +177 -49
@@ -0,0 +1 @@
1
+ efb2de0d681351a48e0a157fd927ce9d7df306e0c5069c0c86ec7653cdebef2c
Binary file
package/README.md CHANGED
@@ -5,6 +5,8 @@
5
5
  [![CI](https://github.com/switchman-dev/switchman/actions/workflows/ci.yml/badge.svg)](https://github.com/switchman-dev/switchman/actions/workflows/ci.yml)
6
6
  [![npm version](https://img.shields.io/npm/v/switchman-dev.svg)](https://www.npmjs.com/package/switchman-dev)
7
7
 
8
+ <img src="docs/demo.png" width="600" alt="Switchman demo — agent2 blocked from src/auth.js, rerouted safely, both branches landed cleanly">
9
+
8
10
  When you run multiple AI agents on the same repo, they collide, duplicate work, and create risky merges. Switchman gives them leases, scoped ownership, policy gates, queue planning, and governed landing workflows so they can move in parallel without stepping on each other.
9
11
 
10
12
  Questions or feedback? Join the [Discord](https://discord.gg/pnT8BEC4D) · [hello@switchman.dev](mailto:hello@switchman.dev)
@@ -30,6 +32,7 @@ switchman demo
30
32
  ```
31
33
 
32
34
  Creates a throwaway repo and shows:
35
+
33
36
  - agent1 claiming `src/auth.js`
34
37
  - agent2 getting blocked from the same file
35
38
  - agent2 rerouting safely to `docs/auth-flow.md`
@@ -59,6 +62,7 @@ switchman login --status # check your plan
59
62
  ```
60
63
 
61
64
  **What's in Pro:**
65
+
62
66
  - Unlimited concurrent agents (free: up to 3)
63
67
  - Cloud-synced team activity across machines
64
68
  - Team invites — `switchman team invite alice@example.com`
@@ -82,11 +86,13 @@ switchman queue run
82
86
  ```
83
87
 
84
88
  What `switchman setup` gives you:
89
+
85
90
  - a shared Switchman database in `.switchman/`
86
91
  - linked agent workspaces
87
92
  - MCP config for Claude Code and Cursor
88
93
 
89
94
  Fastest path to success:
95
+
90
96
  1. Use Claude Code for the first run
91
97
  2. Run `switchman verify-setup` to confirm editor wiring
92
98
  3. Run `switchman claude refresh` to generate a repo-aware `CLAUDE.md`
@@ -96,6 +102,7 @@ Fastest path to success:
96
102
  7. Run `switchman gate ci && switchman queue run` when tasks finish
97
103
 
98
104
  Editor setup guides:
105
+
99
106
  - [Claude Code](docs/setup-claude-code.md)
100
107
  - [Cursor](docs/setup-cursor.md)
101
108
  - [Windsurf](docs/setup-windsurf.md)
@@ -107,12 +114,14 @@ Editor setup guides:
107
114
  Git gives you branches. Switchman gives you coordination.
108
115
 
109
116
  Branches and worktrees solve isolation — they do not tell you:
117
+
110
118
  - which task each agent should take next
111
119
  - who already owns a file
112
120
  - whether a session is stale
113
121
  - whether finished work is safe to land
114
122
 
115
123
  Switchman adds:
124
+
116
125
  - **Task planning** — break goals into governed parallel work
117
126
  - **File locking** — parallel edits don't quietly collide
118
127
  - **Live status** — see what's running, blocked, or stale
@@ -151,6 +160,7 @@ switchman gate ci
151
160
  ```
152
161
 
153
162
  What good looks like:
163
+
154
164
  - each agent stayed in its own lane
155
165
  - overlap was blocked before wasted work spread
156
166
  - the queue made it obvious what should land now and what should wait
@@ -187,6 +197,7 @@ switchman explain landing <pipeline-id>
187
197
  ```
188
198
 
189
199
  More help:
200
+
190
201
  - [Status and recovery](docs/status-and-recovery.md)
191
202
  - [Merge queue](docs/merge-queue.md)
192
203
  - [Pipelines and PRs](docs/pipelines.md)
@@ -0,0 +1 @@
1
+ 85f44aec20f531ab3715c20fe79d89d61307d1083225731d21b450cd86ac48de