refactor: move JS and Python clients under clients/

clients/resolvespec-python/todo.md

@@ -0,0 +1,50 @@
+# ResolveSpec Python Client - TODO
+
+## Client Implementation & Testing
+
+### 1. ResolveSpec Client API
+
+- [x] Core API implementation (read, create, update, delete, get_metadata)
+- [x] Unit tests for API functions
+- [ ] Integration tests with server
+- [x] Error handling and edge cases
+
+### 2. HeaderSpec Client API
+
+- [x] Client API implementation
+- [x] Unit tests
+- [ ] Integration tests with server
+
+### 3. FunctionSpec Client API
+
+- [x] Client API implementation
+- [x] Unit tests
+- [ ] Integration tests with server
+
+### 4. WebSocketSpec Client API
+
+- [x] WebSocketClient class implementation (read, create, update, delete, meta, subscribe, unsubscribe)
+- [x] Unit tests for WebSocketClient
+- [x] Connection handling tests
+- [x] Subscription tests
+- [ ] Integration tests with server
+
+### 5. Testing Infrastructure
+
+- [x] Set up test framework (pytest)
+- [ ] Configure test coverage reporting (pytest-cov)
+- [ ] Add test utilities and fixtures
+- [ ] Create test documentation
+- [ ] Package and publish to PyPI
+
+## Documentation
+
+- [ ] API reference documentation
+- [ ] Usage examples for each client API
+- [ ] Installation guide
+- [ ] Contributing guidelines
+- [x] README (cheatsheet)
+
+---
+
+**Last Updated:** 2026-09-30