Swift-Package on RawCull

How PhotoAIKit Is Constructed

Thu, 30 Jul 2026 00:00:00 +0000

How PhotoAIKit Is Constructed

PhotoAIKit is a reusable Swift package extracted from application code. Its most important achievement is not merely that CLIP and SAM 3 run. It is that reusable AI behavior has been separated from RawCull’s UI, RAW-file handling, paths, sandbox rules, and culling policy.

This document explains the construction from the bottom up and gives the reason for each boundary.

1. Begin With The Package Boundary

The package owns:

How PhotoAnalysisKit Is Constructed

Thu, 30 Jul 2026 00:00:00 +0000

How PhotoAnalysisKit Is Constructed

PhotoAnalysisKit is the reusable measurement layer extracted from RawCull. It turns a decoded CGImage plus neutral capture metadata into sharpness, saliency, focus evidence, and an optional focus-mask image. It can also create opaque Apple Vision feature prints.

The package measures a photo; it does not decide whether to keep it. That distinction prevents image-processing code from becoming coupled to RawCull’s files, settings, views, caches, or culling policy.

How RawCullCore Is Constructed

Thu, 30 Jul 2026 00:00:00 +0000

How RawCullCore Is Constructed

RawCullCore is the small domain layer at the center of RawCull. It does not decode or analyze photos. Instead, it receives file metadata and measurements already produced elsewhere, groups sequential files into bursts, and ranks the candidates using deterministic culling rules.

Its main architectural value is that a recommendation can be tested without opening a RAW file, running Vision, creating a Metal context, loading application settings, or constructing a view model.

How RawParserKit Is Constructed

Thu, 30 Jul 2026 00:00:00 +0000

How RawParserKit Is Constructed

RawParserKit is RawCull’s camera-file boundary. It knows how Sony ARW and Nikon NEF files are structured, how to locate their embedded JPEGs and AF metadata, and how to turn those sources into orientation-normalized images and display-ready metadata.

The package stops at decoding. It does not score sharpness, generate embeddings, group bursts, cache application results, or decide which photo should be kept.

1. Begin With The Package Boundary

RawParserKit owns:

RawCull Packages

Thu, 30 Jul 2026 00:00:00 +0000

RawCull Packages

RawCull is split across four reusable Swift packages. Each package owns one kind of knowledge and deliberately avoids importing the others. RawCull is the composition root: it decodes a file and capture metadata with RawParserKit, asks PhotoAnalysisKit or PhotoAIKit to measure or index it, translates the evidence into RawCullCore values and decisions, and presents or persists the outcome.

flowchart LR
 Files["ARW, NEF, and rendered files"] --> Parser["RawParserKit\ndecode + capture metadata"]
 Parser --> Host["RawCull adapters\nsource and cache policy"]
 Host --> Analysis["PhotoAnalysisKit\nsharpness + focus evidence"]
 Host --> AI["PhotoAIKit\nimage/text embeddings + segmentation"]
 Analysis --> Host
 AI --> Host
 Host --> Core["RawCullCore\nburst grouping + ranking"]
 Core --> App["RawCull UI, persistence, and culling actions"]

The arrows are runtime data flow, not package dependencies. The four sibling packages do not depend on one another; the RawCull application imports and adapts them.