Initial commit

.memory/state.md

@@ -0,0 +1,24 @@
+# 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.