feat(proto): implement ProtoAdapters — 15/15 integration tests pass

[ottobot-ai]

Summary

Implements ProtoAdapters.scala — full bidirectional serialization between Scala fiber types and proto binary format for on-chain storage.

Wire format boundary maintained: DL1 JSON API continues using Circe JSON. Proto binary is for on-chain storage only (no breaking change to external APIs).

Changes

ProtoAdapters.scala (new — 400 lines)

• FiberStatus ↔ ProtoFiberStatus — bidirectional; returns Left on UNSPECIFIED
• SnapshotOrdinal / FiberOrdinal / Hash / Address / StateId converters
• Circe Json ↔ com.google.protobuf.struct.Value bridge (complete fold)
• JsonLogicValue / JsonLogicExpression ↔ proto Value (via Circe round-trip)
• StateMachineDefinition ↔ ProtoStateMachineDefinition (encoded as JSON Struct)
• AccessControlPolicy ↔ ProtoAccessControlPolicy (all 3 variants: Public / Whitelist / FiberOwned)
• EmittedEvent / EventReceipt / OracleInvocation converters
• StateMachineFiberRecord.toProto + fromProto returning Either[String, T]
• ScriptFiberRecord.toProto + fromProto returning Either[String, T]

ProtoAdaptersIntegrationTest.scala (fixed)

The spec tests from @code (PR #98) were written with hallucinated import paths and type constructors. Fixed all 15 tests to use correct Scala types:

• Import paths corrected (xyz.kd5ujc.schema.*)
• State(id = StateId(...), isFinal = false) constructor
• StateMachineDefinition.states: Map[StateId, State]
• Transition with required guard/effect fields
• StateMachineFiberRecord with previousUpdateOrdinal
• EventReceipt with all required fields
• Address construction via refineV[DAGAddressRefined].unsafeFrom()
• Replaced ScalaTest EitherValues with IO-based getRight/getLeft helpers (weaver-compatible)

Test Results

[info] xyz.kd5ujc.proto.ProtoAdaptersIntegrationTest
[info] + A1: Minimal StateMachineFiberRecord round-trips via proto binary
[info] + A2: Full StateMachineFiberRecord with complex stateData round-trips
[info] + A3: StateMachineDefinition transitions encode losslessly
[info] + A4: FiberStatus enum maps bidirectionally
[info] + B1: Minimal ScriptFiberRecord round-trips via proto binary
[info] + B2: ScriptFiberRecord with Whitelist access control round-trips
[info] + B3: FiberOwned access control maps correctly
[info] + C1: Scala proto binary is decodable via generated ScalaPB companion
[info] + C2: Proto binary is idempotent across two full round-trips
[info] + D1: fromProtoSMRecord returns Left on invalid fiberId UUID
[info] + D2: fromProtoFiberStatus returns Left on FIBER_STATUS_UNSPECIFIED
[info] + D3: fromProtoScriptRecord returns Left on missing scriptProgram
[info] + D4: fromProto does NOT throw exceptions on random byte arrays
[info] + E1: ProtoAdapters handles CreateStateMachine → SMRecord scenario
[info] + E2: FiberRecord binary storage is idempotent across snapshot boundaries
[info] Passed: Total 17, Failed 0, Errors 0, Passed 17

Closes Trello card: Integration Tests: Verify generated types with fiber engine

[ottobot-ai]

Moving to feature branch feat/proto-migration on ottobot-ai/ottochain for agent iteration. Will submit rollup PR to upstream when ready.