How energyshifter8/conflict-detect works
TeamPresence is a VS Code extension plus a Node server for sharing repository-relative editing presence and warning about potential conflicts. The main workflow is workspace consent and repository discovery, local edit tracking, WebSocket presence exchange, authoritative room state/conflict calculation, and editor/sidebar/status notifications. The shared package defines the wire contract and range/repository helpers. The README documents token administration, simulator, health endpoint, and security behavior; source excerpts show server wiring and core client/service behavior, but not every UI or gateway handler, so some documented links remain unverified.
Main entry points: repoSession.ts Repository session · gateway.ts WebSocket gateway · controller.ts Workspace controller · tracker.ts Presence tracker
Components 25
VS Code extension
- Workspace controller
packages/extension/src/controller.ts - Git metadata
packages/extension/src/git/gitInfo.ts - Ignore matcher
packages/extension/src/presence/ignore.ts - Presence tracker
packages/extension/src/presence/tracker.ts - Repository session
packages/extension/src/repoSession.ts - WebSocket client
packages/extension/src/net/client.ts - Team state
packages/extension/src/state/teamState.ts - Inline decorations
packages/extension/src/ui/decorations.ts - Conflict notifications
packages/extension/src/ui/notifications.ts - Notification policy
packages/extension/src/ui/notificationPolicy.ts - Status and team views
packages/extension/src/ui/statusBar.ts
Presence server
- WebSocket gateway
packages/server/src/ws/gateway.ts - Room presence service
packages/server/src/presence/service.ts - Conflict detection
packages/server/src/conflicts/detect.ts - Presence store
packages/server/src/presence/memoryStore.ts - Health endpoint
packages/server/src/http.ts - Presence simulator
packages/server/src/simulate.ts
Shared protocol
- Wire protocol
packages/shared/src/protocol.ts - Repository identity
packages/shared/src/repoId.ts
Identity and security
- Token authentication
packages/server/src/auth/authenticator.ts - Token registry
packages/server/src/auth/tokenRegistry.ts - Token administration
packages/server/src/cli/tokens.ts - IP protection
packages/server/src/security/authFailureLimiter.ts - Client IP resolution
packages/server/src/net/clientIp.ts
Other components
- VS Code user
Connections 36
- VS Code user → Workspace controller: starts extension
README.md - Workspace controller → Git metadata: discovers repositories
packages/extension/src/controller.ts - Workspace controller → Ignore matcher: configures ignores
packages/extension/src/controller.ts - Workspace controller → Repository session: starts sessions
packages/extension/src/controller.ts - Repository session → Git metadata: reads branch
packages/extension/src/repoSession.ts - Repository session → Presence tracker: starts tracking
packages/extension/src/repoSession.ts - Repository session → WebSocket client: opens connection
packages/extension/src/repoSession.ts - Repository session → Team state: owns state
packages/extension/src/repoSession.ts - Repository session → Inline decorations: creates decorations
packages/extension/src/repoSession.ts - Repository session → Conflict notifications: creates notifier
packages/extension/src/repoSession.ts - Presence tracker → Ignore matcher: checks paths
packages/extension/src/presence/tracker.ts - Presence tracker → Git metadata: uses repo metadata
packages/extension/src/presence/tracker.ts - Presence tracker → WebSocket client: publishes presence
packages/extension/src/repoSession.ts - WebSocket client → WebSocket gateway: exchanges messages
README.md - WebSocket client → Wire protocol: validates messages
packages/extension/src/net/client.ts - WebSocket gateway → Token authentication: authenticates joins
packages/server/src/ws/gateway.ts - Token authentication → Token registry: verifies tokens
packages/server/src/auth/authenticator.ts - Token administration → Token registry: manages tokens
packages/server/src/cli/tokens.ts - WebSocket gateway → IP protection: checks failed sign-ins
packages/server/src/ws/gateway.ts - WebSocket gateway → Client IP resolution: resolves client IP
packages/server/src/ws/gateway.ts - WebSocket gateway → Room presence service: dispatches room actions
packages/server/src/ws/gateway.ts - Room presence service → Presence store: reads and writes sessions
packages/server/src/presence/service.ts - Room presence service → Conflict detection: computes conflicts
packages/server/src/presence/service.ts - Room presence service → Wire protocol: builds wire state
packages/server/src/presence/service.ts - WebSocket gateway → Wire protocol: parses client messages
packages/server/src/ws/gateway.ts - Team state → Inline decorations: supplies peer state
packages/extension/src/ui/decorations.ts - Team state → Conflict notifications: supplies team state
- Conflict notifications → Notification policy: checks notification rules
- Team state → Status and team views: renders team status
packages/extension/src/ui/treeView.ts - Workspace controller → Notification policy: sets policy
packages/extension/src/controller.ts - Repository identity → Workspace controller: normalizes room identity
packages/extension/src/controller.ts - Presence simulator → WebSocket gateway: simulates clients
README.md - VS Code user → Status and team views: views team activity
README.md - VS Code user → Inline decorations: sees file markers
README.md - VS Code user → Conflict notifications: receives warnings
README.md - VS Code user → Health endpoint: checks health
README.md