Prepare for 0.1.0 release: add ruff, fix CI, unit tests, and changelog

- Add ruff linter to dev dependencies with config in pyproject.toml
- Create py.typed PEP 561 marker file (was declared but missing)
- Remove || echo fallback so CI properly fails on test failures
- Add basic unit tests covering exports, errors, and event constants
- Add pytest asyncio_mode config
- Add CHANGELOG.md for initial 0.1.0 release

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: bojieli

.github/workflows/ci.yml

@@ -33,7 +33,7 @@ jobs:
         run: python -c "from pine_assistant import PineAI, AsyncPineAI, __version__; print(f'pine-assistant {__version__} OK')"
 
       - name: Run tests
-        run: pip install pytest pytest-asyncio && pytest tests/ -v --ignore=tests/integration || echo "No unit tests yet"
+        run: pip install pytest pytest-asyncio && pytest tests/ -v --ignore=tests/integration
 
       - name: Build distribution
         run: python -m build

CHANGELOG.md

@@ -0,0 +1,25 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
+project adheres to [Semantic Versioning](https://semver.org/).
+
+## [0.1.0] - 2026-02-16
+
+### Added
+
+- Async SDK client (`AsyncPineAI`) with Socket.IO and HTTP transport layers
+- Synchronous wrapper (`PineAI`) for non-async usage
+- Authentication flow (email verification with code)
+- Session management (create, list, join, leave)
+- Real-time chat with async generator streaming
+- Task lifecycle support (start, watch, cancel)
+- Form handling and payment event support
+- Pydantic models for all event and data types
+- Stream buffering for text and work-log events
+- CLI tool (`pine`) with auth, chat, sessions, and tasks commands
+- Full type annotations with `py.typed` marker
+- Integration test suite
+
+[0.1.0]: https://github.com/pineai/pine-python/releases/tag/v0.1.0

pyproject.toml

@@ -31,7 +31,7 @@ dependencies = [
 
 [project.optional-dependencies]
 cli = ["click>=8.1.0", "rich>=13.0.0"]
-dev = ["pytest>=7.0", "pytest-asyncio>=0.23.0"]
+dev = ["pytest>=7.0", "pytest-asyncio>=0.23.0", "ruff>=0.4.0"]
 
 [project.urls]
 Homepage = "https://github.com/pineai/pine-python"
@@ -46,3 +46,17 @@ where = ["src"]
 
 [tool.setuptools.package-data]
 pine_assistant = ["py.typed"]
+
+[tool.ruff]
+target-version = "py310"
+line-length = 120
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "W", "UP", "B", "SIM"]
+ignore = ["E501"]
+
+[tool.ruff.lint.isort]
+known-first-party = ["pine_assistant"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"

tests/test_basics.py

@@ -0,0 +1,46 @@
+"""Basic unit tests for pine-assistant package."""
+
+from pine_assistant import (
+    AsyncPineAI,
+    PineAI,
+    PineAIError,
+    AuthError,
+    SessionError,
+    ConnectionError,
+    C2SEvent,
+    S2CEvent,
+    __version__,
+)
+from pine_assistant.models.events import NotificationEvent
+
+
+def test_version():
+    assert __version__ == "0.1.0"
+
+
+def test_public_exports():
+    assert PineAI is not None
+    assert AsyncPineAI is not None
+
+
+def test_error_hierarchy():
+    assert issubclass(AuthError, PineAIError)
+    assert issubclass(SessionError, PineAIError)
+    assert issubclass(ConnectionError, PineAIError)
+
+
+def test_error_attributes():
+    err = PineAIError(code="test_code", message="something broke")
+    assert err.code == "test_code"
+    assert str(err) == "something broke"
+    assert err.details is None
+
+    err_with_details = SessionError("bad session", details={"id": "123"})
+    assert err_with_details.code == "session_error"
+    assert err_with_details.details == {"id": "123"}
+
+
+def test_event_constants():
+    assert C2SEvent.SESSION_MESSAGE == "session:message"
+    assert S2CEvent.SESSION_TEXT == "session:text"
+    assert NotificationEvent.NEW_MESSAGE == "notification:new_message"