Kordophone/mock/README.md

# 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.
AI generated READMEs 2025-09-06 19:52:37 -07:00			`# 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.

Remove API references from READMEs 2025-09-06 19:55:04 -07:00			`## API Compatibility`
AI generated READMEs 2025-09-06 19:52:37 -07:00
Remove API references from READMEs 2025-09-06 19:55:04 -07:00			Implements the Kordophone HTTP API used by clients. Refer to the centralized API documentation (planned under `api/`) for the authoritative specification.