@aiaiai-pt/frankctl 0.5.0 → 0.7.0

package/dist/template-packs/cira/10_ciclope_emergency.yaml

@@ -0,0 +1,526 @@
+# Complete Git-owned CIRA Ciclope Pipeline + BackingDataset bundle (#601).
+#
+# Apply the ignored chmod-0600 Source manifest first, sync all nine Bronze
+# streams, then apply this Source-free bundle. It projects only into existing
+# CIRA E2 Civil Protection and G1 IoT entity types; it never owns schema.
+
+apiVersion: frank.platform/v1
+kind: Pipeline
+metadata:
+  name: cira_ciclope_emergency_resources
+spec:
+  name: cira_ciclope_emergency_resources
+  description: Installed CICLOPE fire-detection towers as E2 emergency resources.
+  source_ids:
+    - cira-ciclope
+  schedule_config:
+    type: manual
+  steps:
+    - name: emergency_resource_rows
+      kind: custom_sql
+      params:
+        sql: |-
+          WITH camera_rollup AS (
+            SELECT c.tower_id,
+                   count(*) camera_count,
+                   CASE
+                     WHEN count_if(lower(coalesce(s.operational_status,''))='operational')=count(*)
+                       THEN 'operational'
+                     WHEN count_if(lower(coalesce(s.operational_status,''))='operational')=0
+                       THEN 'unavailable'
+                     ELSE 'degraded'
+                   END resource_status
+            FROM tenant_00000000_cira_ciclope.cameras c
+            LEFT JOIN tenant_00000000_cira_ciclope.camera_status s
+              ON s.tower_id=c.tower_id AND s.camera_id=c.camera_id
+            GROUP BY c.tower_id
+          )
+          SELECT concat('ciclope:tower:',cast(cast(t.tower_id AS bigint) AS varchar)) code,
+                 'fire_detection_tower' resource_type,
+                 coalesce(r.resource_status,'unknown') status,
+                 cast(coalesce(r.camera_count,0) AS integer) capacity,
+                 CASE
+                   WHEN t.longitude BETWEEN -180.0 AND 180.0
+                    AND t.latitude BETWEEN -90.0 AND 90.0
+                   THEN to_geojson_geometry(ST_Point(t.longitude,t.latitude))
+                 END location_geojson
+          FROM tenant_00000000_cira_ciclope.towers t
+          LEFT JOIN camera_rollup r ON r.tower_id=t.tower_id
+          WHERE t.tower_id IS NOT NULL
+      depends_on: []
+      emits_to: backing_dataset
+      config:
+        output_layer: silver
+---
+apiVersion: frank.platform/v1
+kind: BackingDataset
+metadata:
+  name: cira_ciclope_emergency_resources
+spec:
+  entity_type_id: emergency_resource
+  entity_type_name: Emergency Resource
+  ontology_tenant_id: cira
+  pipeline: cira_ciclope_emergency_resources
+  sync_mode: manual
+  primary_key_column: code
+  title_key_column: code
+  property_mappings:
+    - column: code
+      property: code
+      type: varchar
+      is_primary_key: true
+    - column: resource_type
+      property: resource_type
+      type: varchar
+    - column: status
+      property: status
+      type: varchar
+    - column: capacity
+      property: capacity
+      type: integer
+    - column: location_geojson
+      property: location
+      type: varchar
+      sql_transform_id: json_parse
+---
+apiVersion: frank.platform/v1
+kind: Pipeline
+metadata:
+  name: cira_ciclope_iot_devices
+spec:
+  name: cira_ciclope_iot_devices
+  description: CICLOPE cameras and installed meteo parameters as G1 IoT devices.
+  source_ids:
+    - cira-ciclope
+  schedule_config:
+    type: manual
+  steps:
+    - name: iot_device_rows
+      kind: custom_sql
+      params:
+        sql: |-
+          WITH tower_inventory AS (
+            SELECT tower_id,tower_name,latitude,longitude
+            FROM tenant_00000000_cira_ciclope.towers
+          ), latest_meteo AS (
+            SELECT tower_id,parameter_type,
+                   max(coalesce(
+                     try(from_iso8601_timestamp(cast(observed_at AS varchar))),
+                     try_cast(observed_at AS timestamp(6) with time zone)
+                   )) last_seen_at
+            FROM tenant_00000000_cira_ciclope.realtime_meteo
+            GROUP BY tower_id,parameter_type
+          ), camera_devices AS (
+            SELECT concat('ciclope:camera:',cast(cast(c.tower_id AS bigint) AS varchar),':',cast(cast(c.camera_id AS bigint) AS varchar)) code,
+                   concat(coalesce(t.tower_name,concat('CICLOPE tower ',cast(cast(c.tower_id AS bigint) AS varchar))),
+                          ' / ',coalesce(c.camera_name,concat('camera ',cast(cast(c.camera_id AS bigint) AS varchar)))) name,
+                   concat('camera:',lower(coalesce(c.camera_type,'unknown'))) device_type,
+                   coalesce(s.operational_status,'unknown') status,
+                   CASE
+                     WHEN t.longitude BETWEEN -180.0 AND 180.0
+                      AND t.latitude BETWEEN -90.0 AND 90.0
+                     THEN to_geojson_geometry(ST_Point(t.longitude,t.latitude))
+                   END location_geojson,
+                   from_iso8601_timestamp(s._extracted_at) last_seen_at
+            FROM tenant_00000000_cira_ciclope.cameras c
+            LEFT JOIN tenant_00000000_cira_ciclope.camera_status s
+              ON s.tower_id=c.tower_id AND s.camera_id=c.camera_id
+            LEFT JOIN tower_inventory t
+              ON t.tower_id=c.tower_id
+            WHERE c.tower_id IS NOT NULL AND c.camera_id IS NOT NULL
+          ), meteo_devices AS (
+            SELECT concat('ciclope:meteo-sensor:',cast(cast(m.tower_id AS bigint) AS varchar),':',lower(m.parameter_type)) code,
+                   concat(coalesce(t.tower_name,concat('CICLOPE tower ',cast(cast(m.tower_id AS bigint) AS varchar))),
+                          ' / ',m.parameter_type) name,
+                   concat('weather_sensor:',lower(m.parameter_type)) device_type,
+                   CASE WHEN lm.last_seen_at IS NULL THEN 'installed' ELSE 'operational' END status,
+                   CASE
+                     WHEN t.longitude BETWEEN -180.0 AND 180.0
+                      AND t.latitude BETWEEN -90.0 AND 90.0
+                     THEN to_geojson_geometry(ST_Point(t.longitude,t.latitude))
+                   END location_geojson,
+                   lm.last_seen_at
+            FROM tenant_00000000_cira_ciclope.meteo_sensors m
+            LEFT JOIN latest_meteo lm
+              ON lm.tower_id=m.tower_id AND lm.parameter_type=m.parameter_type
+            LEFT JOIN tower_inventory t
+              ON t.tower_id=m.tower_id
+            WHERE m.tower_id IS NOT NULL AND m.parameter_type IS NOT NULL
+          )
+          SELECT code,name,device_type,status,location_geojson,last_seen_at
+          FROM camera_devices
+          UNION ALL
+          SELECT code,name,device_type,status,location_geojson,last_seen_at
+          FROM meteo_devices
+      depends_on: []
+      emits_to: backing_dataset
+      config:
+        output_layer: silver
+---
+apiVersion: frank.platform/v1
+kind: BackingDataset
+metadata:
+  name: cira_ciclope_iot_devices
+spec:
+  entity_type_id: iot_device
+  entity_type_name: IoT Device
+  ontology_tenant_id: cira
+  pipeline: cira_ciclope_iot_devices
+  sync_mode: manual
+  primary_key_column: code
+  title_key_column: code
+  property_mappings:
+    - column: code
+      property: code
+      type: varchar
+      is_primary_key: true
+    - column: name
+      property: name
+      type: varchar
+    - column: device_type
+      property: device_type
+      type: varchar
+    - column: status
+      property: status
+      type: varchar
+    - column: location_geojson
+      property: location
+      type: varchar
+      sql_transform_id: json_parse
+    - column: last_seen_at
+      property: last_seen_at
+      type: timestamp with time zone
+---
+apiVersion: frank.platform/v1
+kind: Pipeline
+metadata:
+  name: cira_ciclope_device_readings
+spec:
+  name: cira_ciclope_device_readings
+  description: CICLOPE meteo observations and numeric camera state as G1 device readings.
+  source_ids:
+    - cira-ciclope
+  schedule_config:
+    type: manual
+  steps:
+    - name: device_reading_rows
+      kind: custom_sql
+      params:
+        sql: |-
+          WITH meteo_values AS (
+            SELECT record_key,tower_id,parameter_type,
+                   coalesce(
+                     try(from_iso8601_timestamp(cast(observed_at AS varchar))),
+                     try_cast(observed_at AS timestamp(6) with time zone)
+                   ) observed_at,
+                   unit,value,0 source_priority
+            FROM tenant_00000000_cira_ciclope.realtime_meteo
+            UNION ALL
+            SELECT record_key,tower_id,parameter_type,
+                   coalesce(
+                     try(from_iso8601_timestamp(cast(observed_at AS varchar))),
+                     try_cast(observed_at AS timestamp(6) with time zone)
+                   ) observed_at,
+                   unit,value,1 source_priority
+            FROM tenant_00000000_cira_ciclope.meteo_history
+          ), meteo_candidates AS (
+            SELECT concat('ciclope:meteo-reading:',cast(cast(tower_id AS bigint) AS varchar),':',
+                          lower(parameter_type),':',lower(coalesce(unit,'unknown')),':',
+                          to_iso8601(observed_at)) metric,
+                   concat('ciclope:meteo-sensor:',cast(cast(tower_id AS bigint) AS varchar),':',lower(parameter_type)) device_code,
+                   cast(value AS double) value,
+                   observed_at recorded_at,
+                   source_priority,
+                   record_key
+            FROM meteo_values
+            WHERE tower_id IS NOT NULL
+              AND parameter_type IS NOT NULL
+              AND observed_at IS NOT NULL
+              AND value IS NOT NULL
+          ), meteo_distinct AS (
+            SELECT metric,device_code,value,recorded_at,
+                   min(source_priority) source_priority,
+                   min(record_key) record_key
+            FROM meteo_candidates
+            GROUP BY metric,device_code,value,recorded_at
+          ), meteo_rows AS (
+            SELECT CASE
+                     WHEN variant_rank=1 THEN metric
+                     ELSE concat(metric,':variant:',
+                       substr(lower(to_hex(sha256(cast(record_key AS varbinary)))),1,16))
+                   END metric,
+                   device_code,value,recorded_at
+            FROM (
+              SELECT metric,device_code,value,recorded_at,record_key,
+                     row_number() OVER (PARTITION BY metric
+                       ORDER BY source_priority ASC,value DESC,record_key
+                     ) variant_rank
+              FROM meteo_distinct
+            )
+          ), camera_rows AS (
+            SELECT concat('ciclope:camera-reading:',cast(cast(s.tower_id AS bigint) AS varchar),':',
+                          cast(cast(s.camera_id AS bigint) AS varchar),':',u.metric_name,':',
+                          to_iso8601(from_iso8601_timestamp(s._extracted_at))) metric,
+                   concat('ciclope:camera:',cast(cast(s.tower_id AS bigint) AS varchar),':',cast(cast(s.camera_id AS bigint) AS varchar)) device_code,
+                   u.reading_value value,
+                   from_iso8601_timestamp(s._extracted_at) recorded_at
+            FROM tenant_00000000_cira_ciclope.camera_status s
+            CROSS JOIN UNNEST(
+              ARRAY['horizontal_fov_degrees','pan_angle_degrees','tilt_angle_degrees','vertical_fov_degrees','zoom_times'],
+              ARRAY[
+                cast(s.horizontal_fov_degrees AS double),
+                cast(s.pan_angle_degrees AS double),
+                cast(s.tilt_angle_degrees AS double),
+                cast(s.vertical_fov_degrees AS double),
+                cast(s.zoom_times AS double)
+              ]
+            ) AS u(metric_name,reading_value)
+            WHERE s.tower_id IS NOT NULL
+              AND s.camera_id IS NOT NULL
+              AND s._extracted_at IS NOT NULL
+              AND u.reading_value IS NOT NULL
+          )
+          SELECT metric,device_code,value,recorded_at FROM meteo_rows
+          UNION ALL
+          SELECT metric,device_code,value,recorded_at FROM camera_rows
+      depends_on: []
+      emits_to: backing_dataset
+      config:
+        output_layer: silver
+---
+apiVersion: frank.platform/v1
+kind: BackingDataset
+metadata:
+  name: cira_ciclope_device_readings
+  dependsOn:
+    - entityTypeId: iot_device
+      ontologyTenantId: cira
+spec:
+  entity_type_id: device_reading
+  entity_type_name: Device Reading
+  ontology_tenant_id: cira
+  pipeline: cira_ciclope_device_readings
+  sync_mode: manual
+  primary_key_column: metric
+  title_key_column: metric
+  property_mappings:
+    - column: metric
+      property: metric
+      type: varchar
+      is_primary_key: true
+    - column: value
+      property: value
+      type: double
+    - column: recorded_at
+      property: recorded_at
+      type: timestamp with time zone
+    - column: device_code
+      property: device
+      is_relationship: true
+      target_type: iot_device
+      target_key: code
+---
+apiVersion: frank.platform/v1
+kind: Pipeline
+metadata:
+  name: cira_ciclope_emergency_incidents
+spec:
+  name: cira_ciclope_emergency_incidents
+  description: Confirmed CICLOPE fire detections and occurrence entries as E2 incidents.
+  source_ids:
+    - cira-ciclope
+  schedule_config:
+    type: manual
+  steps:
+    - name: emergency_incident_rows
+      kind: custom_sql
+      params:
+        sql: |-
+          WITH alarm_candidates AS (
+            SELECT concat('ciclope:alarm:',cast(cast(a.alarm_id AS bigint) AS varchar)) code,
+                   'wildfire' incident_type,
+                   'confirmed' status,
+                   coalesce(
+                     try(from_iso8601_timestamp(cast(a.observed_at AS varchar))),
+                     try_cast(a.observed_at AS timestamp(6) with time zone)
+                   ) reported_at,
+                   concat('CICLOPE confirmed automatic detection at tower ',cast(cast(a.tower_id AS bigint) AS varchar),
+                          ', camera ',cast(cast(a.camera_id AS bigint) AS varchar)) description,
+                   cast(NULL AS varchar) location_geojson,
+                   1 source_priority
+            FROM tenant_00000000_cira_ciclope.current_afd_alarms a
+            WHERE a.alarm_id IS NOT NULL AND lower(coalesce(a.classification,'')) = 'truealarm'
+            UNION ALL
+            SELECT concat('ciclope:alarm:',cast(cast(a.alarm_id AS bigint) AS varchar)) code,
+                   'wildfire' incident_type,
+                   'confirmed' status,
+                   coalesce(
+                     try(from_iso8601_timestamp(cast(a.observed_at AS varchar))),
+                     try_cast(a.observed_at AS timestamp(6) with time zone)
+                   ) reported_at,
+                   concat('CICLOPE legacy provider-confirmed automatic detection at tower ',cast(cast(a.tower_id AS bigint) AS varchar),
+                          ', camera ',cast(cast(a.camera_id AS bigint) AS varchar)) description,
+                   cast(NULL AS varchar) location_geojson,
+                   2 source_priority
+            FROM tenant_00000000_cira_ciclope.true_afd_alarms a
+            WHERE a.alarm_id IS NOT NULL
+          ), confirmed_alarm_rows AS (
+            SELECT code,incident_type,status,reported_at,description,location_geojson
+            FROM (
+              SELECT alarm_candidates.*,
+                     row_number() OVER (PARTITION BY code ORDER BY source_priority) source_rank
+              FROM alarm_candidates
+            ) ranked
+            WHERE source_rank=1
+          ), occurrence_rows AS (
+            SELECT concat('ciclope:occurrence-entry:',cast(cast(o.occurrence_entry_id AS bigint) AS varchar)) code,
+                   coalesce(nullif(o.occurrence_type,''),'emergency') incident_type,
+                   'reported' status,
+                   coalesce(
+                     coalesce(
+                       try(from_iso8601_timestamp(cast(o.occurrence_started_at AS varchar))),
+                       try_cast(o.occurrence_started_at AS timestamp(6) with time zone)
+                     ),
+                     coalesce(
+                       try(from_iso8601_timestamp(cast(o.entry_registered_at AS varchar))),
+                       try_cast(o.entry_registered_at AS timestamp(6) with time zone)
+                     )
+                   ) reported_at,
+                   o.remarks description,
+                   CASE
+                     WHEN o.longitude BETWEEN -180.0 AND 180.0
+                      AND o.latitude BETWEEN -90.0 AND 90.0
+                     THEN to_geojson_geometry(ST_Point(o.longitude,o.latitude))
+                   END location_geojson
+            FROM tenant_00000000_cira_ciclope.occurrence_entries o
+            WHERE o.occurrence_entry_id IS NOT NULL
+          )
+          SELECT code,incident_type,status,reported_at,description,location_geojson
+          FROM confirmed_alarm_rows
+          UNION ALL
+          SELECT code,incident_type,status,reported_at,description,location_geojson
+          FROM occurrence_rows
+      depends_on: []
+      emits_to: backing_dataset
+      config:
+        output_layer: silver
+---
+apiVersion: frank.platform/v1
+kind: BackingDataset
+metadata:
+  name: cira_ciclope_emergency_incidents
+spec:
+  entity_type_id: emergency_incident
+  entity_type_name: Emergency Incident
+  ontology_tenant_id: cira
+  pipeline: cira_ciclope_emergency_incidents
+  sync_mode: manual
+  primary_key_column: code
+  title_key_column: code
+  property_mappings:
+    - column: code
+      property: code
+      type: varchar
+      is_primary_key: true
+    - column: incident_type
+      property: incident_type
+      type: varchar
+    - column: status
+      property: status
+      type: varchar
+    - column: reported_at
+      property: reported_at
+      type: timestamp with time zone
+    - column: description
+      property: description
+      type: varchar
+    - column: location_geojson
+      property: location
+      type: varchar
+      sql_transform_id: json_parse
+---
+apiVersion: frank.platform/v1
+kind: Pipeline
+metadata:
+  name: cira_ciclope_emergency_alerts
+spec:
+  name: cira_ciclope_emergency_alerts
+  description: Every current CICLOPE automatic fire detection as an E2 alert.
+  source_ids:
+    - cira-ciclope
+  schedule_config:
+    type: manual
+  steps:
+    - name: emergency_alert_rows
+      kind: custom_sql
+      params:
+        sql: |-
+          SELECT concat('ciclope:alarm:',cast(cast(alarm_id AS bigint) AS varchar)) code,
+                 'wildfire_detection' alert_type,
+                 CASE
+                   WHEN lower(coalesce(classification,''))='truealarm' THEN 'high'
+                   WHEN lower(coalesce(classification,''))='falsealarm' THEN 'low'
+                   ELSE 'unclassified'
+                 END severity,
+                 CASE
+                   WHEN lower(coalesce(classification,''))='truealarm' THEN 'confirmed'
+                   WHEN lower(coalesce(classification,''))='falsealarm' THEN 'dismissed'
+                   ELSE 'active'
+                 END status,
+                 coalesce(
+                   try(from_iso8601_timestamp(cast(observed_at AS varchar))),
+                   try_cast(observed_at AS timestamp(6) with time zone)
+                 ) issued_at,
+                 concat('CICLOPE automatic fire detection at tower ',cast(cast(tower_id AS bigint) AS varchar),
+                        ', camera ',cast(cast(camera_id AS bigint) AS varchar),
+                        '; classification=',coalesce(classification,'None')) message,
+                 CASE WHEN lower(coalesce(classification,'')) = 'truealarm'
+                      THEN concat('ciclope:alarm:',cast(cast(alarm_id AS bigint) AS varchar))
+                 END incident_code
+          FROM tenant_00000000_cira_ciclope.current_afd_alarms
+          WHERE alarm_id IS NOT NULL
+      depends_on: []
+      emits_to: backing_dataset
+      config:
+        output_layer: silver
+---
+apiVersion: frank.platform/v1
+kind: BackingDataset
+metadata:
+  name: cira_ciclope_emergency_alerts
+  dependsOn:
+    - entityTypeId: emergency_incident
+      ontologyTenantId: cira
+spec:
+  entity_type_id: emergency_alert
+  entity_type_name: Emergency Alert
+  ontology_tenant_id: cira
+  pipeline: cira_ciclope_emergency_alerts
+  sync_mode: manual
+  primary_key_column: code
+  title_key_column: code
+  property_mappings:
+    - column: code
+      property: code
+      type: varchar
+      is_primary_key: true
+    - column: alert_type
+      property: alert_type
+      type: varchar
+    - column: severity
+      property: severity
+      type: varchar
+    - column: status
+      property: status
+      type: varchar
+    - column: issued_at
+      property: issued_at
+      type: timestamp with time zone
+    - column: message
+      property: message
+      type: varchar
+    - column: incident_code
+      property: incident
+      is_relationship: true
+      target_type: emergency_incident
+      target_key: code

package/dist/template-packs/cira/cityfy_agenda_events.yaml

@@ -0,0 +1,156 @@
+# Complete CIRA Cityfy agenda dataset (issue #589).
+#
+# One REST resource owns pagination and lands one canonical Bronze table. The
+# connector advances ?page=1,2,... until the selected `data` array is empty;
+# there is deliberately no maximum page. Reapply adopts the existing Source
+# and converges the declared `events` stream in place. The five live legacy
+# page streams are explicit disabled migration entries: their runtime state is
+# preserved, but scheduled/direct Source runs cannot execute them.
+#
+# Live verification on 2026-07-22 returned 50/50/50/6 records and then an empty
+# page from the `regiaodeaveiro-eventos` hostname below over valid TLS. The
+# similarly named `regiaodeaveiro.hq1.cityfy.pt` endpoint returns HTTP 404;
+# do not substitute it and do not add a certificate-verification bypass.
+
+apiVersion: frank.platform/v1
+kind: Source
+metadata:
+  name: cira-cityfy-agenda
+spec:
+  name: cira-cityfy-agenda
+  description: Complete Cityfy agenda as one connector-paginated events dataset.
+  pattern_id: rest_api
+  source_config:
+    base_url: https://regiaodeaveiro-eventos.hq1.cityfy.pt/api/v1
+    resources:
+      - /events
+    data_selector: data
+    paginator: page_number
+    page_param: page
+    base_page: 1
+    pagination_total_path: null
+    stop_after_empty_page: true
+    primary_keys:
+      - id
+  schedule_type: manual
+  streams:
+    - name: events
+      sync_mode: full_refresh
+      write_disposition: replace
+      primary_key_path:
+        - id
+      is_enabled: true
+      dest_table_name: events
+    # Migration tombstones for the page-per-stream configuration currently on
+    # the adopted live Source. They are not connector resources or Bronze
+    # inputs; declaring them disabled makes every Source execution path safe.
+    - name: events_page_1
+      is_enabled: false
+    - name: events_page_2
+      is_enabled: false
+    - name: events_page_3
+      is_enabled: false
+    - name: events_page_4
+      is_enabled: false
+    - name: events_page_5
+      is_enabled: false
+---
+apiVersion: frank.platform/v1
+kind: Pipeline
+metadata:
+  name: cira_cityfy_events
+spec:
+  name: cira_cityfy_events
+  description: Complete CIRA Cityfy agenda projection into canonical events.
+  source_ids:
+    - cira-cityfy-agenda
+  schedule_config:
+    type: manual
+  steps:
+    - name: event_rows
+      kind: custom_sql
+      params:
+        sql: |-
+          SELECT
+            concat('cityfy:', trim(cast(o."id" AS varchar))) AS source_key,
+            concat('cityfy:', trim(cast(o."id" AS varchar))) AS external_id,
+            nullif(trim(cast(o."title"."value" AS varchar)), '') AS name,
+            nullif(trim(cast(o."description"."value" AS varchar)), '') AS description,
+            'Cityfy' AS data_provider,
+            CASE
+              WHEN cardinality(o."location"."value"."coordinates") = 2
+                AND element_at(o."location"."value"."coordinates", 1) BETWEEN -180.0 AND 180.0
+                AND element_at(o."location"."value"."coordinates", 2) BETWEEN -90.0 AND 90.0
+              THEN to_geojson_geometry(ST_Point(
+                element_at(o."location"."value"."coordinates", 1),
+                element_at(o."location"."value"."coordinates", 2)
+              ))
+            END AS location_geojson,
+            json_format(CAST(o."see_also"."value" AS JSON)) AS see_also_json,
+            from_iso8601_timestamp(o."date_created"."value") AS date_created,
+            from_iso8601_timestamp(o."date_modified"."value") AS date_modified,
+            from_iso8601_timestamp(o."date_started"."value") AS start_date,
+            from_iso8601_timestamp(o."date_finished"."value") AS end_date,
+            nullif(trim(cast(o."image"."value" AS varchar)), '') AS content_url
+          FROM tenant_00000000_cira_cityfy_agenda.events o
+          WHERE nullif(trim(cast(o."id" AS varchar)), '') IS NOT NULL
+      depends_on: []
+      emits_to: backing_dataset
+      config:
+        output_layer: silver
+---
+apiVersion: frank.platform/v1
+kind: BackingDataset
+metadata:
+  name: cira_cityfy_events
+spec:
+  entity_type_id: event
+  entity_type_name: Event
+  ontology_tenant_id: cira
+  pipeline: cira_cityfy_events
+  # Adopt the bounded-canary BackingDataset in place. This field is immutable
+  # after creation; preserving on_materialization avoids destructive
+  # recreation and is safe because Cityfy has no ontology dependencies.
+  sync_mode: on_materialization
+  primary_key_column: source_key
+  title_key_column: name
+  property_mappings:
+    - column: source_key
+      property: source
+      type: string
+      is_primary_key: true
+    - column: external_id
+      property: external_id
+      type: string
+    - column: name
+      property: name
+      type: string
+    - column: description
+      property: description
+      type: string
+    - column: data_provider
+      property: data_provider
+      type: string
+    - column: location_geojson
+      property: location
+      type: varchar
+      sql_transform_id: json_parse
+    - column: see_also_json
+      property: see_also
+      type: varchar
+      sql_transform_id: json_parse
+    - column: date_created
+      property: date_created
+      type: timestamp with time zone
+    - column: date_modified
+      property: date_modified
+      type: timestamp with time zone
+    - column: start_date
+      property: start_date
+      type: timestamp with time zone
+    - column: end_date
+      property: end_date
+      type: timestamp with time zone
+    - column: content_url
+      property: content_url
+      type: string