# Kordophone Mock Server (Go)

A lightweight mock of the Kordophone macOS server for local development and tests. It emulates the REST API and updates stream, and seeds itself with sample conversations/messages/attachments.

## Build & Run

Requirements: Go 1.20+

```bash
cd mock
go run ./...                 # quick run

# or build a binary
make                         # outputs ./kordophone-mock
./kordophone-mock
```

Flags:

- `--debug` — enable debug logging
- `--auth` — require authentication (Bearer token via `/authenticate`)

Listens on `http://localhost:5738` by default.

## API Compatibility

Implements the Kordophone HTTP API used by clients. Refer to the centralized API documentation (planned under `api/`) for the authoritative specification.
