Add new PTAB endpoints and align models with live USPTO API

.github/workflows/python-tests.yml

@@ -51,19 +51,15 @@ jobs:
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
-          pip install flake8 black isort mypy
+          pip install ruff mypy
 
-      - name: Lint with flake8
+      - name: Lint with ruff
         run: |
-          flake8 src/pyUSPTO --count --select=E9,F63,F7,F82 --show-source --statistics
+          ruff check src/
 
-      - name: Check formatting with black
+      - name: Check formatting with ruff
         run: |
-          black --check src/
-
-      - name: Check imports with isort
-        run: |
-          isort --check-only --profile black src/
+          ruff format --check src/
 
       - name: Type check with mypy
         run: |

.gitignore

@@ -18,3 +18,5 @@ dist/
 .claude/settings.local.json
 .tox/
 Python/
+run_integration_tests.py
+.plan.md

CHANGELOG.md

@@ -5,6 +5,28 @@ All notable changes to the pyUSPTO package will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.0] - TBD
+
+### Added
+
+- **PTAB API 3.0 Support**: New clients for PTAB trials, appeals, and interferences
+  - `PTABTrialsClient` - Search trial proceedings, documents, and decisions
+  - `PTABAppealsClient` - Search ex parte appeal decisions
+  - `PTABInterferencesClient` - Search interference decisions
+- New data models in `pyUSPTO.models.ptab` for PTAB responses:
+  - `PTABTrialProceeding`, `PTABAppealDecision`, `PTABInterferenceDecision`
+  - Supporting models for party data, metadata, and decision information
+- Configuration support for PTAB base URL in `USPTOConfig`
+- Comprehensive examples for all three PTAB clients (`examples/ptab_*.py`)
+- Additional convenience parameters for `PTABTrialsClient` search methods:
+  - `search_documents()`: petitioner name, inventor, patent details, real party in interest
+  - `search_decisions()`: trial type, patent/application numbers, status, party information, document category
+
+### Changed
+
+- Enhanced `PTABTrialsClient.search_documents()` with convenience parameters for petitioner, inventor, patent details
+- Enhanced `PTABTrialsClient.search_decisions()` with convenience parameters for trial type, status, and party information
+
 ## [0.2.2]
 
 ### Added