RawCull Packages

RawCull Packages

RawCull is the composition root for four architecture packages and four small rsync/persistence support packages. The package repositories are separately versioned. They are not copied source snapshots inside TechDocRawCull; paths under Sources/ and Tests/ in these guides refer to the named package repository. The revision notes at the start of each guide say whether its detailed walkthrough was reviewed at the app’s current pin. In particular, the PhotoAIKit and RawParserKit guides preserve their earlier architecture audits while the lockfile table below records what the current app builds.

Resolved Dependency Snapshot

This table is derived from RawCull.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved. This snapshot is from the current RawCull checkout on September 30, 2026. “App” means RawCull links a product directly; “transitive” means another package owns the dependency. A revision-only pin has no semantic-version label.

Do not infer the app boundary from every transitive pin. Xcode product references and source imports define what RawCull actually consumes.

Imported Products And Boundary Types

RawCull owns the translations between these vocabularies. None of the four architecture packages imports another merely to share an app model.

Dependency Direction

flowchart TD
    UI["RawCull SwiftUI"] --> Host["RawCull composition, adapters, policy, persistence"]
    Host --> Parser["RawParserKit\nRAW decode + normalized metadata"]
    Host --> Analysis["PhotoAnalysisKit\nmeasurements + masks"]
    Host --> AI["PhotoAIKit products\nAI contracts + backends + workflows"]
    Host --> Core["RawCullCore\npure grouping + ranking"]
    Host --> Args["RsyncArguments"]
    Host --> Process["RsyncProcessStreaming"]
    Host --> Output["ParseRsyncOutput"]
    Host --> JSON["DecodeEncodeGeneric"]
    Parser -. "app adapter" .-> Core
    Analysis -. "app adapter" .-> Core
    AI -. "app adapter" .-> Core
    Args --> Process
    Process --> Output

Solid arrows are compile-time imports by the app or support flow. Dotted arrows are value translation performed by RawCull, not package dependencies.

Recommended Reading Order

1. RawParserKit — a file becomes an orientation-normalized image and neutral metadata.
2. PhotoAnalysisKit — a decoded image becomes sharpness, saliency, focus evidence, and masks.
3. RawCullCore — measurements become burst boundaries, recommendations, and review state.
4. PhotoAIKit — optional CLIP similarity/semantic search and segmentation run behind typed contracts.
5. Return to the app pages to see RawCull compose those independent boundaries, persist results, and present policy.

When a package pin changes, compare its manifest and public source at the new resolved revision before updating this documentation. A sibling checkout may be ahead of the revision RawCull actually builds.