feat(core): add Venue entity, storage, migration v14 (PR A — base of stack)

app/lib/src/data/archive_intake_service.dart

@@ -184,6 +184,7 @@ class ArchiveIntakeService {
       final importer = CompendiumArchiveImporter(
         pipeline,
         repositories.programs,
+        repositories.venues,
       );
       final result = await importer.import(
         json,

app/lib/src/export/program_share_bundle.dart

@@ -42,6 +42,24 @@ import 'share_sanitization.dart';
 ///
 /// [now] stamps the archive's `exportedAt`; it defaults to the current time and
 /// is injectable for deterministic tests.
+///
+/// Venue gathering is deliberately **not** done here yet: a program's
+/// `venueId` (schema v14) rides along inside the embedded [program], but the
+/// referenced [Venue] record is not gathered into `CompendiumArchive.venues`.
+/// The core receive path handles this safely — `CompendiumArchiveImporter`
+/// nulls a `venueId` that resolves to no bundled venue — so a shared program
+/// simply arrives without its venue link for now. Populating `venueId` in the
+/// editor UI (PR B) and gathering the referenced venue here (mirroring the
+/// dance/choreographer gathering above, minding the same privacy sanitization
+/// for venue contact fields) is deferred to the display/export PR (C).
+// TODO(PR C, issue #456): gather the program's referenced Venue into
+// CompendiumArchive.venues so a shared program carries its venue record, once
+// venueId is UI-populated (PR B) and a venue resolver is wired here.
+// TODO(follow-up, issue #456): venues have no provenance/dedupe key, so
+// re-importing the same bundle duplicates venue records (see
+// CompendiumArchiveImporter.commit). Accepted for PR A (additive-import model);
+// add a dedupe/provenance primitive in a later PR so shared/re-imported
+// bundles match existing venues instead of inserting duplicates.
 String buildProgramShareBundle(
   Program program, {
   required Dance? Function(String danceId) danceFor,

packages/compendium_core/lib/compendium_core.dart

@@ -52,6 +52,7 @@ export 'src/model/provenance.dart';
 export 'src/model/published_source.dart';
 export 'src/model/source_citation.dart';
 export 'src/model/tag.dart';
+export 'src/model/venue.dart';
 export 'src/search/search_sort.dart';
 export 'src/search/title_sort_key.dart';
 export 'src/search/filter.dart';
@@ -80,6 +81,7 @@ export 'src/storage/repositories/repositories.dart';
 export 'src/storage/repositories/settings_repository.dart';
 export 'src/storage/repositories/snapshot_repository.dart';
 export 'src/storage/repositories/tag_repository.dart';
+export 'src/storage/repositories/venue_repository.dart';
 export 'src/taxonomy/contra_taxonomy.dart';
 export 'src/taxonomy/gate_facing.dart';
 export 'src/taxonomy/move_def.dart';

packages/compendium_core/lib/src/imports/callers_companion_usr_import.dart

@@ -171,6 +171,7 @@ class CallersCompanionUsrImporter {
             program,
             id: existingId,
             createdAt: prior.createdAt,
+            priorVenueId: prior.venueId,
           );
           priorStates.add(prior);
           await _programs.update(target);
@@ -238,15 +239,24 @@ class CallersCompanionUsrImporter {
   /// the matched program's identity/creation stamp on a re-import) while keeping
   /// every other field — title, slots, event metadata, provenance, updatedAt —
   /// from the freshly built program.
+  ///
+  /// [priorVenueId] carries the matched program's existing `venueId` forward.
+  /// A `.USR` archive has no concept of this app-local venue entity link, so a
+  /// freshly built program never supplies one; overwriting with null would
+  /// silently drop a link the user established after the original import.
+  /// Preserving it (like [id]/[createdAt]) keeps the re-import from destroying
+  /// app-local state the source cannot reconstruct.
   Program _rebuildProgramWithId(
     Program src, {
     required String id,
     required DateTime createdAt,
+    required String? priorVenueId,
   }) => Program(
     id: id,
     title: src.title,
     eventDate: src.eventDate,
     venue: src.venue,
+    venueId: priorVenueId,
     band: src.band,
     caller: src.caller,
     dancerLevel: src.dancerLevel,