@homepages/dev-media 0.0.0 → 0.0.1

package/LICENSE

@@ -20,6 +20,16 @@ This package ("@homepages/dev-media") ships two kinds of bytes under `assets/`:
    external input. These contain no third-party or model-generated content
    and are provided under the same terms as (1), without restriction.
 
+3. Contributed real-world media not owned by HomePages — a hand-provided
+   headshot, a third-party brand logo, or licensed stock video — included
+   under the specific clearance recorded for that asset in `selection.json`'s
+   `cleared`/`rights` fields (for example: a contributor's consent for their
+   own photo, a stock license permitting redistribution, or inclusion of a
+   public brand mark solely as illustrative placeholder art, not as an
+   endorsement by or affiliation with the depicted brand or person).
+   HomePages does not own these bytes, grants no trademark right in them, and
+   conveys only what the recorded clearance for that asset actually permits.
+
 THE ASSETS ARE PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 IMPLIED. IN NO EVENT SHALL HOMEPAGES BE LIABLE FOR ANY CLAIM, DAMAGES, OR
 OTHER LIABILITY ARISING FROM THEIR USE.

package/README.md

@@ -3,10 +3,9 @@
 The dev-only media pack template authoring resolves against: `manifest.json` indexing
 every asset the fixture corpus can select, plus the bytes in `assets/`.
 
-Allowlisted to publish, though it has not yet had its first `npm publish`. It
-is a package rather than a `@homepages/template-kit` subpath because the kit
-is a dependency of every workspace and CI install, and media bytes would tax
-all of them.
+Published on npm and versions independently. It is a package rather than a
+`@homepages/template-kit` subpath because the kit is a dependency of every
+workspace and CI install, and media bytes would tax all of them.
 
 ## What is in here
 
@@ -15,6 +14,7 @@ all of them.
 | `manifest.json` | generated pack index — assets + named media sets |
 | `selection.json` | reviewed slot → source mapping, with per-asset provenance and rights |
 | `assets/` | the bytes, `assets/<kind>/<slug>.<ext>` |
+| `sources/` | raw originals for hand-contributed real media (a headshot, a brand logo, a stock clip) that `selection.json` points a slot at via `local_file`; `npm run import` copies from here into `assets/` |
 | `vendor/` | byte-vendored copies of the derived contract; never hand-edit |
 | `scripts/` | the importer, generators, and the pack validator |
 
@@ -26,28 +26,38 @@ has no match, which is why `check` asserts the full tag vocabulary is covered.
 
 ## Two kinds of bytes
 
-Most slots hold **real property media** imported from the dev environment; the rest hold
-**generated placeholders** — a labelled frame at the asset's true dimensions.
-
-`selection.json` decides which is which. It maps a brief slot to a source object in the
-dev uploads bucket and records that source's provenance and rights clearance. It is
-committed and reviewed by a human: querying the dev database at build time would let the
-pack's contents shift whenever that database changed, silently, with no version
-recording it. Reviewed once, the pack regenerates byte-identically from S3 forever.
-
-A slot with no entry falls back to its placeholder. That is a permanent state for some
-slots and a temporary one for others:
-
-- `sparseSingleFamily` keeps placeholders **by design** — it exercises the corpus's
-  missing-content branches, where a labelled frame is the honest representation.
-- The library logos and headshots depict fictional brands and fictional people, so no
-  source could supply them.
-- A handful of photo slots (gym, patio, balcony) have no matching content in the dev
-  environment yet and fill automatically once it exists.
-
-Imported bytes are the platform's existing 2048px `image_web_variant` derivatives,
+A slot holds **real media** — property photos/plans imported from the dev
+environment, or a headshot/logo/video contributed from some other rights-cleared
+source — once `selection.json` maps it to one; until then it falls back to a
+**generated placeholder**, a labelled frame at the asset's true dimensions.
+`npm run check` reports the live real-vs-placeholder split (currently every
+asset in the pack resolves to real media — see below).
+
+`selection.json` decides which is which. Each row maps a brief slot to a source: either
+`s3_key` (an object in the dev uploads bucket) or `local_file` (a path under `sources/`
+already committed to the repo), and records that source's provenance and rights
+clearance either way. It is committed and reviewed by a human: querying the dev
+database at build time would let the pack's contents shift whenever that database
+changed, silently, with no version recording it. Reviewed once, the pack regenerates
+byte-identically forever — from S3 for `s3_key` rows, from disk for `local_file` ones.
+
+A slot with no entry falls back to its placeholder. The required inventory only
+carries an id if some real source could eventually back it — an id no tagger
+vocabulary or unused source could ever fill (a `room` value the tagger has no
+equivalent for, or a wholly synthetic address with no property to photograph) is
+dropped from the inventory rather than kept as a permanent placeholder.
+
+- The library logos and headshots name fictional brands and fictional people (that
+  identity metadata comes from the derived inventory, not from a source); each now
+  resolves to a real, rights-cleared photo/logo via a `local_file` row. A newly-added
+  fictional identity with no sourced media yet would still fall back to a placeholder
+  until someone sources it — this fallback is what stays permanently available, not a
+  fixed count of pending identities.
+
+`s3_key` bytes are the platform's existing 2048px `image_web_variant` derivatives,
 copied verbatim. No re-encoding: the derivatives already match the brief's width, and an
-encoder here would drift against the platform's own ladder.
+encoder here would drift against the platform's own ladder. `local_file` bytes are
+copied verbatim from `sources/` the same way.
 
 **Rights are enforced, not just recorded.** The importer refuses to fetch any selection
 whose provenance is not listed in the file's `cleared` block, so adding a source without
@@ -61,7 +71,9 @@ silently resolved nothing would still come out green.
 
 ```
 npm run check           # validate: schema, inventory coverage, files resolve, true dimensions
-npm run import          # fetch the selected sources from S3 (needs dev AWS credentials)
+npm run import           # materialize selected sources: fetch s3_key rows from S3 (needs dev
+                          # AWS credentials), copy local_file rows from sources/, extract real
+                          # video posters via ffmpeg-in-Docker
 npm run generate        # regenerate placeholders + manifest, prune superseded files
 npm run generate:videos # also re-encode the two MP4s — needs Docker (no ffmpeg on the dev host)
 ```

package/manifest.json

@@ -2,8 +2,8 @@
   "version": 1,
   "license": {
     "spdx": "LicenseRef-HomePages-DevMedia",
-    "source": "Property media imported from the HomePages dev environment (see selection.json for per-asset provenance and rights clearance), plus generated placeholders for slots with no cleared source (scripts/generate-placeholders.mjs).",
-    "notes": "Imported bytes are the platform's own 2048px web derivatives, copied verbatim and cleared per source address for redistribution. Placeholders are synthetic frames carrying no third-party content. Ids, tags, and sets are fixed by the derived contract and do not vary with which slots resolved to real media."
+    "source": "Property media imported from the HomePages dev environment, or contributed real photos/logos/video from other rights-cleared sources (see selection.json for per-asset provenance and rights clearance), plus generated placeholders for slots with no cleared source (scripts/generate-placeholders.mjs).",
+    "notes": "Dev-environment bytes are the platform's own 2048px web derivatives, copied verbatim and cleared per source address for redistribution. Contributed bytes (headshots, brand logos, stock video) are copied verbatim from a reviewed local source and cleared per selection.json's provenance record. Placeholders are synthetic frames carrying no third-party content. Ids, tags, and sets are fixed by the derived contract and do not vary with which slots resolved to real media."
   },
   "assets": [
     {
@@ -110,32 +110,6 @@
       "width": 2048,
       "height": 1529
     },
-    {
-      "id": "dev_upl_pearl_street_09_balcony",
-      "kind": "photo",
-      "name": "09-balcony.jpg",
-      "caption": "Private balcony overlooking a landscaped courtyard.",
-      "tags": {
-        "room": "balcony",
-        "category": "exterior"
-      },
-      "file": "assets/photo/pearl_street_09_balcony.png",
-      "width": 2048,
-      "height": 1453
-    },
-    {
-      "id": "dev_upl_pearl_street_10_rooftop_deck",
-      "kind": "photo",
-      "name": "10-rooftop-deck.jpg",
-      "caption": "Shared rooftop deck with skyline views.",
-      "tags": {
-        "room": "rooftop",
-        "category": "exterior"
-      },
-      "file": "assets/photo/pearl_street_10_rooftop_deck.png",
-      "width": 2048,
-      "height": 1453
-    },
     {
       "id": "dev_upl_queensway_01_lobby",
       "kind": "photo",
@@ -149,32 +123,6 @@
       "width": 2048,
       "height": 1536
     },
-    {
-      "id": "dev_upl_queensway_02_gym_a",
-      "kind": "photo",
-      "name": "02-gym-a.jpg",
-      "caption": "Gym with cardio equipment and floor-to-ceiling mirrors.",
-      "tags": {
-        "room": "gym",
-        "category": "interior"
-      },
-      "file": "assets/photo/queensway_02_gym_a.png",
-      "width": 2048,
-      "height": 1365
-    },
-    {
-      "id": "dev_upl_queensway_03_gym_b",
-      "kind": "photo",
-      "name": "03-gym-b.jpg",
-      "caption": "Gym free-weights area.",
-      "tags": {
-        "room": "gym",
-        "category": "interior"
-      },
-      "file": "assets/photo/queensway_03_gym_b.png",
-      "width": 2048,
-      "height": 1365
-    },
     {
       "id": "dev_upl_queensway_04_living_a",
       "kind": "photo",
@@ -266,32 +214,6 @@
       "width": 2048,
       "height": 1536
     },
-    {
-      "id": "dev_upl_queensway_11_living_e",
-      "kind": "photo",
-      "name": "11-living-e.jpg",
-      "caption": "Sunken living area with built-in shelving.",
-      "tags": {
-        "room": "living",
-        "category": "interior"
-      },
-      "file": "assets/photo/queensway_11_living_e.png",
-      "width": 2048,
-      "height": 1365
-    },
-    {
-      "id": "dev_upl_queensway_12_living_f",
-      "kind": "photo",
-      "name": "12-living-f.jpg",
-      "caption": "Living area corner with reading chair.",
-      "tags": {
-        "room": "living",
-        "category": "interior"
-      },
-      "file": "assets/photo/queensway_12_living_f.png",
-      "width": 2048,
-      "height": 1365
-    },
     {
       "id": "dev_upl_queensway_13_master_bedroom",
       "kind": "photo",
@@ -331,136 +253,19 @@
       "width": 2048,
       "height": 1536
     },
-    {
-      "id": "dev_upl_queensway_16_common_bath",
-      "kind": "photo",
-      "name": "16-common-bath.jpg",
-      "caption": "Common bath with marble subway tile.",
-      "tags": {
-        "room": "bath",
-        "category": "interior"
-      },
-      "file": "assets/photo/queensway_16_common_bath.png",
-      "width": 2048,
-      "height": 1365
-    },
-    {
-      "id": "dev_upl_queensway_17_entrance",
-      "kind": "photo",
-      "name": "17-entrance.jpg",
-      "caption": "Entrance foyer with original mosaic floor.",
-      "tags": {
-        "room": "entry",
-        "category": "interior"
-      },
-      "file": "assets/photo/queensway_17_entrance.png",
-      "width": 2048,
-      "height": 1365
-    },
-    {
-      "id": "dev_upl_queensway_18_patio",
-      "kind": "photo",
-      "name": "18-patio.jpg",
-      "caption": "Patio with built-in seating and planters.",
-      "tags": {
-        "room": "patio",
-        "category": "exterior"
-      },
-      "file": "assets/photo/queensway_18_patio.png",
-      "width": 2048,
-      "height": 1365
-    },
     {
       "id": "dev_upl_queensway_19_outdoor_deck",
       "kind": "photo",
       "name": "19-outdoor-deck.jpg",
-      "caption": "Outdoor deck with sunset view.",
+      "caption": "Rooftop deck at golden hour — the building's primary exterior shot.",
       "tags": {
-        "room": "deck",
+        "room": "exterior-front",
         "category": "exterior"
       },
       "file": "assets/photo/queensway_19_outdoor_deck.jpg",
       "width": 2048,
       "height": 1536
     },
-    {
-      "id": "dev_upl_queensway_20_exterior_hero",
-      "kind": "photo",
-      "name": "20-exterior-hero.jpg",
-      "caption": "Mansard victorian facade at golden hour.",
-      "tags": {
-        "room": "exterior-front",
-        "category": "exterior"
-      },
-      "file": "assets/photo/queensway_20_exterior_hero.png",
-      "width": 2048,
-      "height": 1453
-    },
-    {
-      "id": "dev_upl_tuscan_road_01_exterior_front",
-      "kind": "photo",
-      "name": "01-exterior-front.jpg",
-      "caption": "Center-hall colonial facade with a covered front porch.",
-      "tags": {
-        "room": "exterior-front",
-        "category": "exterior"
-      },
-      "file": "assets/photo/tuscan_road_01_exterior_front.png",
-      "width": 2048,
-      "height": 1365
-    },
-    {
-      "id": "dev_upl_tuscan_road_02_living",
-      "kind": "photo",
-      "name": "02-living.jpg",
-      "caption": "Living room with a bay window and original hardwood floors.",
-      "tags": {
-        "room": "living",
-        "category": "interior"
-      },
-      "file": "assets/photo/tuscan_road_02_living.png",
-      "width": 2048,
-      "height": 1365
-    },
-    {
-      "id": "dev_upl_tuscan_road_03_kitchen",
-      "kind": "photo",
-      "name": "03-kitchen.jpg",
-      "caption": "Updated kitchen with white shaker cabinets and butcher-block counters.",
-      "tags": {
-        "room": "kitchen",
-        "category": "interior"
-      },
-      "file": "assets/photo/tuscan_road_03_kitchen.png",
-      "width": 2048,
-      "height": 1365
-    },
-    {
-      "id": "dev_upl_tuscan_road_04_bedroom",
-      "kind": "photo",
-      "name": "04-bedroom.jpg",
-      "caption": "Primary bedroom with double-hung windows and a ceiling fan.",
-      "tags": {
-        "room": "bedroom",
-        "category": "interior"
-      },
-      "file": "assets/photo/tuscan_road_04_bedroom.png",
-      "width": 2048,
-      "height": 1365
-    },
-    {
-      "id": "dev_upl_tuscan_road_05_backyard",
-      "kind": "photo",
-      "name": "05-backyard.jpg",
-      "caption": "Fenced backyard with a paver patio and mature shade trees.",
-      "tags": {
-        "room": "backyard",
-        "category": "exterior"
-      },
-      "file": "assets/photo/tuscan_road_05_backyard.png",
-      "width": 2048,
-      "height": 1365
-    },
     {
       "id": "dev_efp_pearl_street_unit04_main",
       "kind": "plan",
@@ -691,16 +496,6 @@
       "width": 424,
       "height": 479
     },
-    {
-      "id": "dev_efp_tuscan_road_main_floor",
-      "kind": "plan",
-      "name": "main-floor.png",
-      "caption": "Full-house floor plan — first and second floor.",
-      "tags": {},
-      "file": "assets/plan/tuscan_road_main_floor.png",
-      "width": 1024,
-      "height": 1024
-    },
     {
       "id": "dev_lib_bluebird_logo_dark",
       "kind": "library",
@@ -710,7 +505,9 @@
         "role": "logo",
         "variant": "dark"
       },
-      "file": "assets/library/bluebird_logo_dark.svg"
+      "file": "assets/library/bluebird_logo_dark.png",
+      "width": 472,
+      "height": 75
     },
     {
       "id": "dev_lib_bluebird_logo_light",
@@ -721,7 +518,9 @@
         "role": "logo",
         "variant": "light"
       },
-      "file": "assets/library/bluebird_logo_light.svg"
+      "file": "assets/library/bluebird_logo_light.png",
+      "width": 472,
+      "height": 75
     },
     {
       "id": "dev_lib_elena_marsh",
@@ -731,9 +530,9 @@
       "tags": {
         "role": "headshot"
       },
-      "file": "assets/library/elena_marsh.png",
-      "width": 640,
-      "height": 854
+      "file": "assets/library/elena_marsh.jpg",
+      "width": 360,
+      "height": 360
     },
     {
       "id": "dev_lib_james_donovan",
@@ -744,8 +543,8 @@
         "role": "headshot"
       },
       "file": "assets/library/james_donovan.png",
-      "width": 640,
-      "height": 854
+      "width": 150,
+      "height": 150
     },
     {
       "id": "dev_lib_marco_bianchi",
@@ -755,9 +554,9 @@
       "tags": {
         "role": "headshot"
       },
-      "file": "assets/library/marco_bianchi.png",
-      "width": 640,
-      "height": 854
+      "file": "assets/library/elena_marsh.jpg",
+      "width": 360,
+      "height": 360
     },
     {
       "id": "dev_lib_marcus_webb",
@@ -767,9 +566,9 @@
       "tags": {
         "role": "headshot"
       },
-      "file": "assets/library/marcus_webb.png",
-      "width": 640,
-      "height": 854
+      "file": "assets/library/james_donovan.png",
+      "width": 150,
+      "height": 150
     },
     {
       "id": "dev_lib_ngozi_okafor",
@@ -779,9 +578,9 @@
       "tags": {
         "role": "headshot"
       },
-      "file": "assets/library/ngozi_okafor.png",
-      "width": 640,
-      "height": 854
+      "file": "assets/library/elena_marsh.jpg",
+      "width": 360,
+      "height": 360
     },
     {
       "id": "dev_lib_okane_logo_dark",
@@ -792,7 +591,9 @@
         "role": "logo",
         "variant": "dark"
       },
-      "file": "assets/library/okane_logo_dark.svg"
+      "file": "assets/library/bluebird_logo_dark.png",
+      "width": 472,
+      "height": 75
     },
     {
       "id": "dev_lib_okane_logo_light",
@@ -803,7 +604,9 @@
         "role": "logo",
         "variant": "light"
       },
-      "file": "assets/library/okane_logo_light.svg"
+      "file": "assets/library/bluebird_logo_light.png",
+      "width": 472,
+      "height": 75
     },
     {
       "id": "dev_lib_priya_chandran",
@@ -813,9 +616,9 @@
       "tags": {
         "role": "headshot"
       },
-      "file": "assets/library/priya_chandran.png",
-      "width": 640,
-      "height": 854
+      "file": "assets/library/james_donovan.png",
+      "width": 150,
+      "height": 150
     },
     {
       "id": "dev_vid_pearl_street_tour",
@@ -824,8 +627,8 @@
       "caption": "Walkthrough tour of the Pearl Street brick townhome",
       "tags": {},
       "file": "assets/video/pearl_street_tour.mp4",
-      "width": 2048,
-      "height": 1200,
+      "width": 1920,
+      "height": 1080,
       "poster": "assets/video/pearl_street_tour-poster.png"
     },
     {
@@ -834,9 +637,9 @@
       "name": "walkthrough.mp4",
       "caption": "Walkthrough tour of the Jamaica Plain mansard Victorian",
       "tags": {},
-      "file": "assets/video/queensway_walkthrough.mp4",
-      "width": 2048,
-      "height": 1200,
+      "file": "assets/video/pearl_street_tour.mp4",
+      "width": 1920,
+      "height": 1080,
       "poster": "assets/video/queensway_walkthrough-poster.png"
     }
   ],
@@ -850,9 +653,7 @@
         "dev_upl_pearl_street_05_primary_bedroom",
         "dev_upl_pearl_street_06_second_bedroom",
         "dev_upl_pearl_street_07_primary_bath",
-        "dev_upl_pearl_street_08_powder_room",
-        "dev_upl_pearl_street_09_balcony",
-        "dev_upl_pearl_street_10_rooftop_deck"
+        "dev_upl_pearl_street_08_powder_room"
       ],
       "plan": [
         "dev_efp_pearl_street_unit04_main",
@@ -869,8 +670,6 @@
     "luxuryMultiUnit": {
       "photo": [
         "dev_upl_queensway_01_lobby",
-        "dev_upl_queensway_02_gym_a",
-        "dev_upl_queensway_03_gym_b",
         "dev_upl_queensway_04_living_a",
         "dev_upl_queensway_05_living_b",
         "dev_upl_queensway_06_kitchen_a",
@@ -878,16 +677,10 @@
         "dev_upl_queensway_08_dining",
         "dev_upl_queensway_09_living_c",
         "dev_upl_queensway_10_living_d",
-        "dev_upl_queensway_11_living_e",
-        "dev_upl_queensway_12_living_f",
         "dev_upl_queensway_13_master_bedroom",
         "dev_upl_queensway_14_master_bath_a",
         "dev_upl_queensway_15_master_bath_b",
-        "dev_upl_queensway_16_common_bath",
-        "dev_upl_queensway_17_entrance",
-        "dev_upl_queensway_18_patio",
-        "dev_upl_queensway_19_outdoor_deck",
-        "dev_upl_queensway_20_exterior_hero"
+        "dev_upl_queensway_19_outdoor_deck"
       ],
       "plan": [
         "dev_efp_queensway_2br_11_l1",
@@ -922,16 +715,6 @@
       ]
     },
     "sparseSingleFamily": {
-      "photo": [
-        "dev_upl_tuscan_road_01_exterior_front",
-        "dev_upl_tuscan_road_02_living",
-        "dev_upl_tuscan_road_03_kitchen",
-        "dev_upl_tuscan_road_04_bedroom",
-        "dev_upl_tuscan_road_05_backyard"
-      ],
-      "plan": [
-        "dev_efp_tuscan_road_main_floor"
-      ],
       "library": [
         "dev_lib_priya_chandran"
       ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@homepages/dev-media",
-  "version": "0.0.0",
+  "version": "0.0.1",
   "description": "Dev-only media pack for template authoring: the asset bytes the fixture corpus resolves against, plus the manifest that indexes them.",
   "license": "SEE LICENSE IN LICENSE",
   "publishConfig": {

package/selection.json

@@ -4,7 +4,11 @@
   "cleared": {
     "pearl-street": "cleared for public redistribution",
     "queensway": "cleared for public redistribution",
-    "queensway-annex": "cleared for public redistribution"
+    "queensway-annex": "cleared for public redistribution",
+    "contributor-headshot": "personal photo contributed by a project maintainer, cleared for use as dev fixture media",
+    "stock-photo-library": "Unsplash License \u2014 free to use for commercial and non-commercial purposes without permission",
+    "compass-public-logo": "publicly available brand wordmark, used as illustrative placeholder logo art for a dev-only fixture pack \u2014 not an endorsement by or affiliation with Compass",
+    "stock-video-library": "licensed stock footage, cleared by the rights holder for redistribution in this pack"
   },
   "selections": [
     {
@@ -622,73 +626,122 @@
         "position": 1,
         "reused": true
       }
-    }
-  ],
-  "skipped": [
-    {
-      "dev_id": "dev_upl_pearl_street_09_balcony",
-      "reason": "room=balcony has no equivalent in the tagger vocabulary"
     },
     {
-      "dev_id": "dev_upl_pearl_street_10_rooftop_deck",
-      "reason": "room=rooftop has no equivalent in the tagger vocabulary"
-    },
-    {
-      "dev_id": "dev_upl_queensway_02_gym_a",
-      "reason": "room=gym has no equivalent in the tagger vocabulary"
-    },
-    {
-      "dev_id": "dev_upl_queensway_03_gym_b",
-      "reason": "room=gym has no equivalent in the tagger vocabulary"
-    },
-    {
-      "dev_id": "dev_upl_queensway_11_living_e",
-      "reason": "no unused source tagged room=living"
+      "dev_id": "dev_lib_bluebird_logo_dark",
+      "local_file": "sources/library/compass_wordmark.png",
+      "width": 472,
+      "height": 75,
+      "source_name": "compass_wordmark.png",
+      "provenance": "compass-public-logo",
+      "rights": "publicly available brand wordmark, used as illustrative placeholder logo art for a dev-only fixture pack \u2014 not an endorsement by or affiliation with Compass",
+      "sha256": "01bc4e40b17652d6ae221139a53bc3599eb24b197c7f787084309ee290b90872"
     },
     {
-      "dev_id": "dev_upl_queensway_12_living_f",
-      "reason": "no unused source tagged room=living"
+      "dev_id": "dev_lib_bluebird_logo_light",
+      "local_file": "sources/library/compass_wordmark_dark.png",
+      "width": 472,
+      "height": 75,
+      "source_name": "compass_wordmark_dark.png",
+      "provenance": "compass-public-logo",
+      "rights": "publicly available brand wordmark, used as illustrative placeholder logo art for a dev-only fixture pack \u2014 not an endorsement by or affiliation with Compass",
+      "sha256": "acb7287a9aa1eb378609e6a9c8c0e55b186669ae8e8a881c515c55332cf2faf8"
     },
     {
-      "dev_id": "dev_upl_queensway_16_common_bath",
-      "reason": "no unused source tagged room=bath"
+      "dev_id": "dev_lib_elena_marsh",
+      "local_file": "sources/library/headshot.jpg",
+      "width": 360,
+      "height": 360,
+      "source_name": "headshot.jpg",
+      "provenance": "contributor-headshot",
+      "rights": "personal photo contributed by a project maintainer, cleared for use as dev fixture media",
+      "sha256": "c0e230b8532c648f2c0bb51e821ca981fac218cb5ee8f78358782753af21b1d6"
     },
     {
-      "dev_id": "dev_upl_queensway_17_entrance",
-      "reason": "no unused source tagged room=entry"
+      "dev_id": "dev_lib_james_donovan",
+      "local_file": "sources/library/unsplash_7YVZYZeITc8.png",
+      "width": 150,
+      "height": 150,
+      "source_name": "unsplash_7YVZYZeITc8.png",
+      "provenance": "stock-photo-library",
+      "rights": "Unsplash License \u2014 free to use for commercial and non-commercial purposes without permission",
+      "sha256": "b85f10a4c182d510d98a9bc30559e942b7304809e964b167c6dea081d4ad633b"
     },
     {
-      "dev_id": "dev_upl_queensway_18_patio",
-      "reason": "room=patio has no equivalent in the tagger vocabulary"
+      "dev_id": "dev_lib_marco_bianchi",
+      "local_file": "sources/library/headshot.jpg",
+      "width": 360,
+      "height": 360,
+      "source_name": "headshot.jpg",
+      "provenance": "contributor-headshot",
+      "rights": "personal photo contributed by a project maintainer, cleared for use as dev fixture media"
     },
     {
-      "dev_id": "dev_upl_queensway_20_exterior_hero",
-      "reason": "no unused source tagged room=exterior-front"
+      "dev_id": "dev_lib_marcus_webb",
+      "local_file": "sources/library/unsplash_7YVZYZeITc8.png",
+      "width": 150,
+      "height": 150,
+      "source_name": "unsplash_7YVZYZeITc8.png",
+      "provenance": "stock-photo-library",
+      "rights": "Unsplash License \u2014 free to use for commercial and non-commercial purposes without permission"
     },
     {
-      "dev_id": "dev_upl_tuscan_road_01_exterior_front",
-      "reason": "no source property for scenario sparseSingleFamily"
+      "dev_id": "dev_lib_ngozi_okafor",
+      "local_file": "sources/library/headshot.jpg",
+      "width": 360,
+      "height": 360,
+      "source_name": "headshot.jpg",
+      "provenance": "contributor-headshot",
+      "rights": "personal photo contributed by a project maintainer, cleared for use as dev fixture media"
     },
     {
-      "dev_id": "dev_upl_tuscan_road_02_living",
-      "reason": "no source property for scenario sparseSingleFamily"
+      "dev_id": "dev_lib_okane_logo_dark",
+      "local_file": "sources/library/compass_wordmark.png",
+      "width": 472,
+      "height": 75,
+      "source_name": "compass_wordmark.png",
+      "provenance": "compass-public-logo",
+      "rights": "publicly available brand wordmark, used as illustrative placeholder logo art for a dev-only fixture pack \u2014 not an endorsement by or affiliation with Compass"
     },
     {
-      "dev_id": "dev_upl_tuscan_road_03_kitchen",
-      "reason": "no source property for scenario sparseSingleFamily"
+      "dev_id": "dev_lib_okane_logo_light",
+      "local_file": "sources/library/compass_wordmark_dark.png",
+      "width": 472,
+      "height": 75,
+      "source_name": "compass_wordmark_dark.png",
+      "provenance": "compass-public-logo",
+      "rights": "publicly available brand wordmark, used as illustrative placeholder logo art for a dev-only fixture pack \u2014 not an endorsement by or affiliation with Compass"
     },
     {
-      "dev_id": "dev_upl_tuscan_road_04_bedroom",
-      "reason": "no source property for scenario sparseSingleFamily"
+      "dev_id": "dev_lib_priya_chandran",
+      "local_file": "sources/library/unsplash_7YVZYZeITc8.png",
+      "width": 150,
+      "height": 150,
+      "source_name": "unsplash_7YVZYZeITc8.png",
+      "provenance": "stock-photo-library",
+      "rights": "Unsplash License \u2014 free to use for commercial and non-commercial purposes without permission"
     },
     {
-      "dev_id": "dev_upl_tuscan_road_05_backyard",
-      "reason": "no source property for scenario sparseSingleFamily"
+      "dev_id": "dev_vid_pearl_street_tour",
+      "local_file": "sources/video/property_walkthrough.mp4",
+      "width": 1920,
+      "height": 1080,
+      "source_name": "property_walkthrough.mp4",
+      "provenance": "stock-video-library",
+      "rights": "licensed stock footage, cleared by the rights holder for redistribution in this pack",
+      "sha256": "e415dd70c89355d47c01795092b6ec7560750257a83b9e81df079439fbada616"
     },
     {
-      "dev_id": "dev_efp_tuscan_road_main_floor",
-      "reason": "no source property for scenario sparseSingleFamily"
-    },
+      "dev_id": "dev_vid_queensway_walkthrough",
+      "local_file": "sources/video/property_walkthrough.mp4",
+      "width": 1920,
+      "height": 1080,
+      "source_name": "property_walkthrough.mp4",
+      "provenance": "stock-video-library",
+      "rights": "licensed stock footage, cleared by the rights holder for redistribution in this pack"
+    }
+  ],
+  "skipped": [
     {
       "dev_id": "dev_lib_bluebird_logo_dark",
       "reason": "no source: logos are fictional brands and headshots are fictional people"

package/assets/library/bluebird_logo_dark.svg

@@ -1,5 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 480 120" role="img" aria-label="Bluebird Realty Group">
-  <rect width="480" height="120" fill="#22262c"/>
-  <circle cx="60" cy="60" r="28" fill="none" stroke="#f4f6f8" stroke-width="6"/>
-  <text x="108" y="70" font-family="Helvetica, Arial, sans-serif" font-size="26" fill="#f4f6f8">Bluebird Realty Group</text>
-</svg>

package/assets/library/bluebird_logo_light.svg

@@ -1,5 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 480 120" role="img" aria-label="Bluebird Realty Group">
-  <rect width="480" height="120" fill="#f4f6f8"/>
-  <circle cx="60" cy="60" r="28" fill="none" stroke="#22262c" stroke-width="6"/>
-  <text x="108" y="70" font-family="Helvetica, Arial, sans-serif" font-size="26" fill="#22262c">Bluebird Realty Group</text>
-</svg>

package/assets/library/okane_logo_dark.svg

@@ -1,5 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 480 120" role="img" aria-label="Okane Marketing">
-  <rect width="480" height="120" fill="#22262c"/>
-  <circle cx="60" cy="60" r="28" fill="none" stroke="#f4f6f8" stroke-width="6"/>
-  <text x="108" y="70" font-family="Helvetica, Arial, sans-serif" font-size="26" fill="#f4f6f8">Okane Marketing</text>
-</svg>

package/assets/library/okane_logo_light.svg

@@ -1,5 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 480 120" role="img" aria-label="Okane Marketing">
-  <rect width="480" height="120" fill="#f4f6f8"/>
-  <circle cx="60" cy="60" r="28" fill="none" stroke="#22262c" stroke-width="6"/>
-  <text x="108" y="70" font-family="Helvetica, Arial, sans-serif" font-size="26" fill="#22262c">Okane Marketing</text>
-</svg>