initial commit

IrisCompanion/iris/DataSources/POIDataSource.swift

@@ -0,0 +1,33 @@
+//
+//  POIDataSource.swift
+//  iris
+//
+//  Created by Codex.
+//
+
+import CoreLocation
+import Foundation
+
+struct POIDataSourceConfig: Sendable {
+    var maxCandidates: Int = 3
+    init() {}
+}
+
+/// Placeholder POI source. Hook point for MapKit / local cache / server-driven POIs.
+final class POIDataSource {
+    private let config: POIDataSourceConfig
+
+    init(config: POIDataSourceConfig = .init()) {
+        self.config = config
+    }
+
+    func candidates(for location: CLLocation, now: Int) async throws -> [Candidate] {
+        // Phase 1 stub: return nothing.
+        // (Still async/throws so the orchestrator can treat it uniformly with real implementations later.)
+        _ = config
+        _ = location
+        _ = now
+        return []
+    }
+}
+