Architectural Decision Records

Short records of the decisions that shape the Smarter Python SDK, each with its context, the alternatives considered, and its consequences.

• ADR Introduction
• ADR-001: Scope and Purpose of the SDK
• ADR-002: Configuration
• ADR-003: Writes Go Through the Manifest API
• ADR-004: Pydantic Models, Forward Compatible
• ADR-005: Mirrored Contracts and Generated SAM Models
• ADR-006: Error Handling
• ADR-007: Logging
• ADR-008: HTTP Transport, Retries and Timeouts
• ADR-009: Testing
• ADR-010: CI/CD
• ADR-011: Dependency Management
• ADR-012: Docstrings and Documentation
• ADR-013: Type Annotations
• ADR-014: Code Quality
• ADR-015: Semantic Versioning and API Versions
• ADR-016: Security
• ADR-017: No Response Caching
• ADR-018: A Synchronous Client First
• ADR-019: Supported Python Versions
• ADR-022: A Pinned Copy of the Platform’s OpenAPI Document
• ADR-023: A Documentation Site of Its Own
• ADR-024: CI and the Release Workflow
• ADR-025: Packaging and Compiled Requirements