# State

## Current focus
Read-only TypeScript wrapper around `pykeepass` via a Python JSON bridge.

## Current API
- `openKeePassDatabase(path, options)`
- `listEntries()`
- `findEntries(query)`
- `listGroups()`
- `close()` is a no-op

## Runtime model
- TypeScript starts the Python bridge
- Python uses `pykeepass`
- JSON is exchanged over stdin/stdout
- Bridge errors and empty/invalid JSON are surfaced to TypeScript

## Current fixture/test status
- Bundled fixtures: `tests/fixtures/data.kdbx` and `tests/fixtures/empty.kdbx`
- Integration tests validate entries, groups, and OTP/TOTP output for `data.kdbx`

## Next step
Keep tightening failure-path coverage and improve the API shape only if needed.