Files
waggle-os/packages/team-server/README.md
shumeiko.it c25efe6c44 refactor(server): move the team runtime into a postponed package (P1.1)
Team mode stays in the repository but is not built or shipped (ADR-0003).

- The team server (index.ts, config, db, daemons, plugins, proactive,
  routes, scheduler, services, ws, drizzle migrations) and its tests move
  from @waggle/server to packages/team-server (@waggle/team-server,
  private). It keeps its own copies of the logger and the agent-group
  executor, so it does not import @waggle/server. @clerk/fastify, bullmq,
  ioredis, postgres, drizzle-orm, drizzle-kit, cron-parser and
  @waggle/waggle-dance leave @waggle/server; the launcher drops the same
  team-only dependencies.
- build:packages no longer builds waggle-dance or the worker: nothing in
  the community edition imports them, and the worker's project reference
  would otherwise build the team server. The worker now imports from
  team-server; the team Dockerfile builds both explicitly.
- The sidecar no longer starts the team server when DATABASE_URL is set,
  and loses the team routes (/api/team/*, /api/teams), the WaggleDance
  routes and bridge (/api/waggle-dance/*), the Team server binding and
  egress guard, the WebSocket team client, the TeamSync cache and pushes,
  team audit forwarding, team workspace registration and the team
  capability-policy lookup in chat. The in-process room signal bus stays:
  agent groups, fleet runs and external tool runs use it.
  middleware/audit.ts was dead and is deleted.
- @waggle/core loses TeamSync and the teamServer part of WaggleConfig. A
  teamServer key in config.json is ignored and kept on save, as P0.1 does
  for the tier keys. Workspaces lose teamServerUrl and teamUserId; teamId
  and teamRole stay because workspaces from a shared data directory still
  carry them and the viewer write guards read them. POST /api/workspaces
  ignores team fields.
- The sidecar bundle no longer marks the team packages as external.

The agent still references the TeamSync type in orchestrator.ts and
pattern-write-back.ts; those files are being rewritten in P1.5 and drop
it there.

Logs UF-030 and UF-031 (team sync and team policy defects found while
removing the code).
2026-10-24 12:17:41 +02:00

1.2 KiB

@waggle/team-server

The multi-user team server: Fastify with Clerk authentication, PostgreSQL through drizzle, Redis and BullMQ jobs, a WebSocket gateway, cron and the team routes (teams, agents, tasks, messages, knowledge, resources, audit, analytics, capability governance).

Postponed. Team mode stays in the repository but is not built, bundled or shipped in the community edition (ADR-0003). This package is not part of npm run build:packages, and the local sidecar (@waggle/server) does not import or start it. Do not add features here until the owner decides otherwise.

packages/worker and packages/waggle-dance belong to the same postponed team runtime.

Running it anyway

The server needs PostgreSQL and Redis (see docker-compose.yml) and a Clerk secret key.

cd packages/team-server
DATABASE_URL=postgres://waggle:waggle_dev@localhost:5434/waggle npx tsx src/db/migrate.ts
DATABASE_URL=... REDIS_URL=redis://localhost:6381 CLERK_SECRET_KEY=... npx tsx src/index.ts

Most tests in tests/ need the same services and are listed in vitest.infra-suites.ts; npm run test:infra runs them.