Project Structure
Phase 11 adds integration-hardening models/services/UI/tests, credential-free validation scripts, module-dependencies.json, physical test plans, audit guidance, diagnostic screenshots, and a Testing and Installation section in the static HTML site.
Phase 10 adds ExternalMediaModels.swift, ExternalMediaAdapters.swift, ExternalMediaImportView.swift, and Phase10Tests.swift. External-camera guides live with the generated static HTML counterparts, and screenshot automation adds eight iPad plus ten macOS import screens.
Phase 9 source is concentrated in ResearchExperimentModels.swift, ResearchFeatureExtractors.swift, ExperimentalFusion.swift, ResearchExperimentServices.swift, ResearchExports.swift, and ResearchExperimentView.swift. The 23 *Research*, experiment, metric, cache, export, and limitations guides in this directory document the public behavior and boundaries.
Phase 6 additions:
Packages/SharedModels/ResearchDashboardModels.swift: dashboard, bookmark, warning, timeline, comparison, and screenshot contracts.Packages/DatasetManager/ResearchDashboardServices.swift: deterministic aggregation, comparison, bookmark, warning, timeline, and demo-data services.Packages/DatasetManager/ScreenshotManifestValidator.swift: manifest, file, dimension, alt-text, and documentation-reference validation.Packages/SharedUI/ResearchDashboardView.swift: adaptive iPad/macOS review workspace and Swift Charts.Packages/SharedUI/PhoneDemonstrationView.swift: harmless opt-in iPhone screenshot states.Tools/ScreenshotRenderer: native 1440×900 macOS documentation renderer.Scripts/generate-documentation-screenshots.sh: simulator capture, macOS rendering, validation, and HTML regeneration.Documentation/Images/Screenshots: originals and machine-readable manifest.
Phase 7 additions:
Packages/SharedModels/AnnotationModels.swift: versioned annotation, revision, review, corrected-track, dataset, split, privacy, and validation contracts.Packages/AnnotationEngine/AnnotationEngine.swift: box/polygon geometry, versioned editing, undo/redo, interpolation, autosave, and recovery.Packages/ExportEngine/TrainingDatasetExport.swift: deterministic splits and validated training export representations.Packages/SharedUI/AnnotationWorkspaceView.swift: adaptive iPad/macOS annotation and dataset workspaces.Tests/OrganicVisionTests/Phase7Tests.swift: deterministic annotation, storage, split, and export coverage.
Phase 8 additions:
Packages/SharedModels/AssistedAnnotationModels.swift: versioned suggestions, masks, provenance, prompts, quality findings, review queues, jobs, metrics, and model records.Packages/AnnotationEngine/AssistedAnnotationEngine.swift: explicit suggestion review, mask conversion/editing, temporal propagation, prioritization, disagreement, quality checks, batch revision events, and resumable jobs.Packages/SharedUI/AssistedAnnotationView.swift: adaptive iPad/macOS assisted review, mask, comparison, quality, batch, and plugin-inspector foundations.Packages/PluginSDK/PluginSDK.swift: bounded type-specific assistance and quality extension protocols.Packages/ExportEngine/TrainingDatasetExport.swift: approved-only filtering and assisted-origin manifests.Tests/OrganicVisionTests/Phase8Tests.swift: deterministic Phase 8 service coverage.
Apps/: thin SwiftUI composition roots for the iPhone Camera Node, iPad Research Console, and macOS Session Review.Packages/SharedModels: portable research value types and capability/status results.Packages/SharedUI: shared status presentation and the Phase 1 dependency composition.Packages/CameraSources: AVFoundation physical capture, deterministic simulated video, sensor adapters, and recording coordination.Packages/Networking: protocol envelopes, Bonjour/Network.framework transport, CryptoKit/Keychain security, discovery, connection policy, adaptive preview, remote authorization, and deterministic network simulation.Packages/DatasetManager: actor-isolated datasets plus recoverable research-session package storage.Packages/DetectionEngine,TrackingEngine,FeatureExtraction: vision pipeline contracts and deterministic foundation logic.Packages/AnnotationEngine,ExportEngine: versioned human correction and derived training export boundaries.Packages/PluginSDK: plugin metadata and detector extension contract.Tests/: Swift Testing suite across module boundaries.project.yml: maintainable XcodeGen source;OrganicVision.xcodeprojis its generated output.OrganicVision.xcworkspace: stable workspace entry point for Xcode.
Phase 2 adds ResearchSessionModels.swift, ResearchSessionStore.swift, recording/sensor/coordinator services, CameraNodeView.swift, and Phase2Tests.swift. Application code remains a thin composition root.
Phase 3 adds networking protocol, security, discovery, connection/adaptation, native transport, and simulated-lab files; an iPad-optimized ResearchConsoleView; and Phase3Tests.swift. Low-level sockets remain confined to Networking.
Phase 4 additions
Packages/SharedModels/DatasetCatalogModels.swift: catalog records, provenance, collections, filters, integrity, duplicates, and typed errors.Packages/DatasetManager/DatasetCatalog.swift: actor-isolated durable catalog, search, collections, storage, deletion, and duplicate services.Packages/DatasetManager/SessionPackageServices.swift: untrusted-package validation, indexing, SHA-256 integrity, and dataset export.Packages/Networking/SessionTransfer.swift: finalized-package messages, chunk checkpoints, resume, and final hash verification.Packages/SharedUI/DatasetCatalogView.swift: adaptive phone, tablet, and desktop catalog UI.HTML Documentation/: generated static searchable documentation ready for LAMP hosting.Tools/generate_html_documentation.py: dependency-free Markdown-to-HTML documentation generator.
Phase 5 additions
Packages/SharedModels/VisionAnalysisModels.swiftandVisionTaxonomy.swift: run, observation, track, taxonomy, score, segmentation, coordinate, and error contracts.Packages/DetectionEngine/VisionAnalysis.swift: deterministic detector, model registry, request boundary, batching, Core ML/Vision conversion, and resource decisions.Packages/TrackingEngine/PersistentObjectTracker.swift: persistent matching and termination.Packages/FeatureExtraction/EnvironmentScoring.swift: crop policy, baseline measurements, scoring evidence/fusion, and simulated masks.Packages/DatasetManager/AnalysisResultStore.swift: checkpoints, JSONL, atomic finalization, recovery, comparison, and object index.Packages/Networking/AnalysisMessages.swift: bounded analysis messages.Packages/ExportEngine/AnalysisExport.swift: cancelable derived-video fixture and sidecar metadata.Packages/SharedUI/VisionAnalysisView.swift: reusable coordinate-aware overlay and analysis dashboard.Tests/OrganicVisionTests/Phase5Tests.swift: deterministic Phase 5 validation.