---
type: work-item
project: fidelity
status: backlog-partial
ticket: PDIAP-12226
title: "iOS: Implement SpartaSDK initialization and JSON decoding"
systems: [sparta, xflowsdk]
workstreams: [sparta, backlog-triage]
people: [jeff-dewitte, aylwing-olivas]
related: [pdiap-12227, pdiap-12228]
updated: 2026-05-05
tags:
  - work-item
  - fidelity
  - sparta
---

# PDIAP-12226 - iOS: Implement SpartaSDK initialization and JSON decoding

## Status

- Backlog item; partially complete.

---

## Current Understanding

- Last known work was a decoding-layer refactor based on internal feedback from Aylwing.
- Direction was to make decoding strict so malformed backend responses surface errors to the consumer instead of silently skipping unsupported components.
- Earlier approach used a `strict mode` toggle where unsupported components were omitted from rendering.
- Refactor is still in progress; if no new component types are added, it may not require much beyond the existing work.

---

## Historical Slack Context

- October 2025 Slack context shows the work started from `PDIAP-11956` / `PDIAP-12066` exploration: dynamic JSON decoding, `SpartaNodeRegistry`, strict-mode behavior, and fallback handling for unknown node types.
- By October 21, 2025, decoding tests validated fallback handling and registry lookups in an internal `SwiftUIBuilder` PR.
- November 2025 planning split the remaining SpartaSDK work into separate stories; this one became the initialization and JSON-decoding story.
- November 20-24, 2025 Slack context says `PDIAP-12226` was moved to a later sprint and David was reviewing whether the current JSON-decoding implementation was ready for a formal PR.