WatchLink/docs/agent-handoff.md

# Agent Handoff

## Current State

Initial implementation created from `codex-agent-repository-kit` guidance.

## Notes

- The kit was read and applied as a source template, not kept as a project dependency.
- The kit was updated through v1.0.5 (`a4245a1`) after initial implementation. Relevant follow-up issue guidance was applied to `AGENTS.md`.
- npm and Docker were not available in the initial local shell, so dependency installation and Docker verification may need a machine with those tools in PATH.
- `GITEA_TOKEN` may be available locally, but it must not be printed or committed.

## Follow-ups

- Repository visibility is public.
- Gitea Actions can run `npm install`, tests, build, and Docker image publishing.
- Local Docker is still unavailable in this Codex environment, but Gitea Actions can build the image.
- Docker publish was fixed by updating `REGISTRY_TOKEN`; Gitea issue #1 is closed.
- Room-scoped persisted invite codes were added to the room Invite rail. Room owners, admins, and room managers can create expiring invite codes and revoke active room invites.
- Room chat moderation was added through Socket.IO. Room owners, admins, and room managers can delete room chat messages; deletions are audited and rebroadcast to the room.
- Admin user ban and remove-friendship actions were added. Admins can disable an account while clearing its friendships and explicit room memberships, or remove all friendships for a user without disabling the account.
- Socket acknowledgements were added for room join and realtime room actions. The room header now shows pending, confirmed, or failed sync acknowledgement state from the server.
- Remaining UI redesign follow-ups that need real backend work: none currently documented in this handoff.