# Changelog

All notable changes to the ORTHO-32 Java SDK will be documented here.
Format based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) and Semantic Versioning.

## [0.1.0] - 2026-08-14

### Added
- Initial SDK release with simulator transport, all public modules
- Public packages: `org.ortho32`, `device`, `fabric`, `compute`, `tensor`, `trace`, `verify`, `security`, `agent`, `system`, `transport`, `exceptions`
- Core types: `OrthoRuntime`, `OrthoSession` (AutoCloseable), `OrthoContext`, `OrthoVersion`, `OrthoResult`, `OrthoDevice` family
- Fabric types: `FabricCommand`, `FabricCompletion`, `FabricAddress/Opcode/Epoch/Slot` — logical API, no BAR access
- Tensor types: `Tensor`, `TensorShape/Buffer/Job/Operation/Result`, `TensorLatency` (TMUL=4, TLOAD=5, TSTORE=5, Scratchpad=2) — cycles are architectural integers
- Trace types: `ExecutionTrace`, `CycleRecord`, `TraceHash` (SHA-256 canonical), `TraceComparator` — H=0 determinism
- Verification types: 12 theorems, `TheoremId/Result`, `VerificationStatus` (VERIFIED != TESTED != ASSUMED), `CrossVerificationResult` with MISMATCH blocking
- Security types: `Capability`, `Permission`, `SecurityContext`, `Attestation`
- Agent types: `AgentIntent`, `AgentTask`, `AgentResult` via typed intents
- Transport: `OrthoTransport` (internal), `SimulatorTransport` (deterministic, no hardware), `NativeHostTransport`, `PCIe/USB/Ethernet` stubs — transport-agnostic API
- Schemas: `fabric-command`, `fabric-completion`, `execution-trace`, `theorem-result`, `attestation`
- Examples: `device-list`, `tensor-run`, `trace-replay`, `proof-verify`, `agent-client`
- Integration tests: `SimulatorTransportTest`, `TensorJobTest`, `DeterminismTest`, `TraceComparatorTest`, `VerificationStatusTest`, `CrossVerifyTest`, `SessionLifecycleTest`, `TransportAgnosticTest` — all runnable offline
- Build: Gradle Kotlin DSL, Java 21 toolchain, reproducible builds, sources & Javadoc JARs, Maven publication, dependency locking, checksums
- Compatibility tuple: `SDK-Version + Fabric-Protocol-Version + Device-ABI-Version`

[0.1.0]: https://github.com/ortho32/ortho32-sdk-java/releases/tag/v0.1.0