Duet: One Shared Core, Two Native Apps

src-kmp/              # the shared Kotlin core
├── <feature>/        # one module per feature: State, Action, Effect, reducer
├── services/         # cross-cutting ports, log vocabulary, consent state
├── telemetry/        # the closed analytics event grammar
├── theming/          # design tokens, shared by both apps
├── apple-umbrella/   # one Kotlin/Native framework aggregating every feature
├── replay-runner/    # replays fixtures on the JVM
└── app/              # the Android app: Compose shell, workers, Activity edge
src-ios/
├── App/              # the iPhone app target; xcodegen.yml is the source
└── Libraries/        # Kit (links the framework), Main (composition root),
                      # Theming, ThemedControls
parity/
├── manifest.yaml     # the declared features, fixtures and generators
├── authoring.md      # this repo's own front door for feature work
├── feature-specs/    # one one-pager per feature
└── fixtures/         # recorded behavior — build products, never hand-edited
tools/duet            # the CLI that records and verifies
.github/workflows/    # the parity gates, running on every push

src-ios/
├── Subtrees/<Name>/  # one directory per feature:
│   ├── <Name>Feature/    #   the reducer, its types, the worker, the scenarios
│   └── <Name>Node/       #   the builder and the SwiftUI shell
├── App/              # the iPhone app target
└── Libraries/        # Main (composition root), Theming, ThemedControls
parity/
├── manifest.yaml
├── authoring.md
├── feature-specs/    # the porting source of truth
└── fixtures/         # recorded behavior — build products, never hand-edited
tools/duet
.github/workflows/