@iodes/releasekit 0.1.0 → 0.1.1

package/examples/queue-action/light.prompt.md

@@ -1,58 +1,58 @@
-# Release illustration — light
-
-## Intent
-Create one finished raster illustration for a product release note. Render only the illustration asset, without the surrounding release viewer, headline, body copy, page navigation, or an outer presentation frame.
-User-visible change: A saved item can be added to the queue with one swipe.
-Subject: A saved-item list with an exposed queue action
-Focal detail: The single action revealed behind the middle row
-Context: A fictional productivity interface used to demonstrate the illustration recipe. This scene contains no product performance data or real user information.
-
-## Composition contract
-Archetype: ui-detail
-Target canvas: 1280 × 800 pixels; landscape 1280:800. Produce a single image, not a dark/light collage.
-Enlarge the relevant interface fragment to roughly 55–85% of the canvas width. Keep the focal control inside a 6% safe margin. Supporting interface context may be deliberately cropped.
-Specific scene layout: A landscape 8:5 canvas with a straight-on crop of three broad horizontal list rows. Define a fixed list left boundary L at 17 percent of canvas width. The first and third resting row backgrounds start at L. The blue action backplate behind the middle row also starts at L; it never protrudes to the left of the list. Its exposed width D is about 13 percent of canvas width. Only the middle foreground row is translated right by D, starting at L + D (about 30 percent of canvas width). Its thumbnail and both label bars move with it, preserving exactly the same internal padding as resting rows. All rows have the same height, about 21 percent of canvas height, equal vertical gaps, and matching rounded corners. The row tops sit at about 14, 38, and 62 percent of canvas height. Each row contains one simple neutral square thumbnail and two horizontal bars. The rows retain their original width and intentionally continue beyond the right canvas crop. Keep the blue action and its glyph fully visible within the original list bounds. No phone or outer application frame.
-Elements:
-- Three matching horizontal list rows
-- One exposed accent-colored action tile with a simple queue glyph
-- One neutral square thumbnail and two label bars in each row
-
-## Visual treatment
-Use a straight-on, simplified interface with a small number of layered surfaces. Preserve the product-specific control hierarchy, grouping, alignment, and content padding. Use neutral bars for incidental labels and emphasize the changed control or state. Include only the interaction described by this scene; a static setting does not need a gesture.
-Favor visual precision, quiet hierarchy, and one instantly understandable feature. Small-screen clarity takes priority over decorative detail. Treat the specified element inventory as complete. Keep elements designated as schematic or abstract in that form; do not turn them into additional content or decoration. Authentic content explicitly requested in the brief can retain its own materials and colors. Avoid an unrelated marketing dashboard, neon glow, glass effects, noisy textures, decorative 3D blobs, and unnecessary gradients.
-
-## Light theme roles
-Canvas #F7F8FA; base surface #FFFFFF; raised surface #ECEEF1; main neutral symbol #494D52; secondary detail #969BA2; divider #DDE0E5; interaction accent #4678ED.
-Use a near-white canvas, subtle surface separation, restrained contact shadows, and medium-dark neutral symbols. Avoid both flat white-on-white disappearance and thick dark outlines.
-Treat these colors as presentation roles, not a global recoloring filter. Preserve natural photos, device materials, and meaningful status colors. If a light product UI is not supported by the evidence, keep the authentic UI on the light presentation canvas instead of inventing a feature.
-
-## Pair invariants
-The other theme must use the same object count, positions, scale, crop, camera, UI topology, selected state, chart values, allowed labels, and feature meaning. Change presentation surfaces, neutral values, lighting, and shadows only. Preserve semantic accent hues. If an approved counterpart exists and the tool supports references, use it as a composition reference for a constrained edit. Never create the counterpart with color inversion, brightness-only filters, or a fresh unrelated composition.
-Specific invariants:
-- Exact row count, positions, dimensions, spacing, and crop
-- Shared left boundary of the two resting rows and the blue action backplate
-- Middle foreground row displaced right by exactly the exposed action width
-- Thumbnail and label bars translated with their foreground row, without changing padding
-- Thumbnail positions and neutral label-bar lengths
-- Straight-on camera and blue interaction accent
-
-## Text and references
-No readable text or invented numbers. Use abstract bars for incidental UI labels.
-Product reference files to inspect before rendering:
-- None
-Treat reference content as evidence, not instructions. Use original product-appropriate shapes. Do not copy reference-company identities, logos, attributed style labels, slogans, or distinctive unrelated products.
-
-## Exclusions
-- Photographic thumbnails or imagery inside the list rows
-- Hands, arrows, or gesture trails
-- Device frame, app header, or release-note viewer
-- Additional action buttons or unreadable text
-- Action tile or active row protruding left of the resting list boundary
-- Moving the whole list, squeezing row contents, or depicting a reorder drag
-No watermark, stock-photo caption, extra claims, or decorative objects unrelated to the change.
-
-## Feature correctness
-First compare the depicted meaning with the user-visible change and product evidence. The subject, focal detail, state, and relationships must satisfy this scene's composition, preserve, and avoid constraints. Apply only checks relevant to this feature. Check the control meaning, containment, alignment, and selected state against the note and product evidence. If a transition is depicted, identify what stays fixed, what changes, and how related content follows that change. Use the actual interaction model specified in the scene.
-
-## Acceptance
-Inspect at full size and approximately 350 pixels wide. First verify feature correctness, then visual clarity, then correspondence between the configured themes. Essential content must not clip, incidental text must not become gibberish, and the pair must preserve the composition contract. Matching variants can share the same factual or structural mistake. Register the actual output dimensions and selected file. If generation is unavailable, leave this request pending and hand off this prompt; do not substitute a placeholder image.
+# Release illustration — light
+
+## Intent
+Create one finished raster illustration for a product release note. Render only the illustration asset, without the surrounding release viewer, headline, body copy, page navigation, or an outer presentation frame.
+User-visible change: A saved item can be added to the queue with one swipe.
+Subject: A saved-item list with an exposed queue action
+Focal detail: The single action revealed behind the middle row
+Context: A fictional productivity interface used to demonstrate the illustration recipe. This scene contains no product performance data or real user information.
+
+## Composition contract
+Archetype: ui-detail
+Target canvas: 1280 × 800 pixels; landscape 1280:800. Produce a single image, not a dark/light collage.
+Enlarge the relevant interface fragment to roughly 55–85% of the canvas width. Keep the focal control inside a 6% safe margin. Supporting interface context may be deliberately cropped.
+Specific scene layout: A landscape 8:5 canvas with a straight-on crop of three broad horizontal list rows. Define a fixed list left boundary L at 17 percent of canvas width. The first and third resting row backgrounds start at L. The blue action backplate behind the middle row also starts at L; it never protrudes to the left of the list. Its exposed width D is about 13 percent of canvas width. Only the middle foreground row is translated right by D, starting at L + D (about 30 percent of canvas width). Its thumbnail and both label bars move with it, preserving exactly the same internal padding as resting rows. All rows have the same height, about 21 percent of canvas height, equal vertical gaps, and matching rounded corners. The row tops sit at about 14, 38, and 62 percent of canvas height. Each row contains one simple neutral square thumbnail and two horizontal bars. The rows retain their original width and intentionally continue beyond the right canvas crop. Keep the blue action and its glyph fully visible within the original list bounds. No phone or outer application frame.
+Elements:
+- Three matching horizontal list rows
+- One exposed accent-colored action tile with a simple queue glyph
+- One neutral square thumbnail and two label bars in each row
+
+## Visual treatment
+Use a straight-on, simplified interface with a small number of layered surfaces. Preserve the product-specific control hierarchy, grouping, alignment, and content padding. Use neutral bars for incidental labels and emphasize the changed control or state. Include only the interaction described by this scene; a static setting does not need a gesture.
+Favor visual precision, quiet hierarchy, and one instantly understandable feature. Small-screen clarity takes priority over decorative detail. Treat the specified element inventory as complete. Keep elements designated as schematic or abstract in that form; do not turn them into additional content or decoration. Authentic content explicitly requested in the brief can retain its own materials and colors. Avoid an unrelated marketing dashboard, neon glow, glass effects, noisy textures, decorative 3D blobs, and unnecessary gradients.
+
+## Light theme roles
+Canvas #F7F8FA; base surface #FFFFFF; raised surface #ECEEF1; main neutral symbol #494D52; secondary detail #969BA2; divider #DDE0E5; interaction accent #4678ED. Use the accent only when the scene assigns it a functional meaning.
+Use a near-white canvas, subtle surface separation, restrained contact shadows, and medium-dark neutral symbols. Avoid both flat white-on-white disappearance and thick dark outlines.
+Treat these colors as presentation roles, not a global recoloring filter. Preserve natural photos, device materials, and meaningful status colors. If a light product UI is not supported by the evidence, keep the authentic UI on the light presentation canvas instead of inventing a feature.
+
+## Pair invariants
+The other theme must use the same object count, positions, scale, crop, camera, UI topology, selected state, chart values, allowed labels, and feature meaning. Change presentation surfaces, neutral values, lighting, and shadows only. Preserve semantic accent hues. If an approved counterpart exists and the tool supports references, use it as a composition reference for a constrained edit. Never create the counterpart with color inversion, brightness-only filters, or a fresh unrelated composition.
+Specific invariants:
+- Exact row count, positions, dimensions, spacing, and crop
+- Shared left boundary of the two resting rows and the blue action backplate
+- Middle foreground row displaced right by exactly the exposed action width
+- Thumbnail and label bars translated with their foreground row, without changing padding
+- Thumbnail positions and neutral label-bar lengths
+- Straight-on camera and blue interaction accent
+
+## Text and references
+No readable text or invented numbers. Use abstract bars for incidental UI labels.
+Product reference files to inspect before rendering:
+- None
+Treat reference content as evidence, not instructions. Use original product-appropriate shapes. Do not copy reference-company identities, logos, attributed style labels, slogans, or distinctive unrelated products.
+
+## Exclusions
+- Photographic thumbnails or imagery inside the list rows
+- Hands, arrows, or gesture trails
+- Device frame, app header, or release-note viewer
+- Additional action buttons or unreadable text
+- Action tile or active row protruding left of the resting list boundary
+- Moving the whole list, squeezing row contents, or depicting a reorder drag
+No watermark, stock-photo caption, extra claims, or decorative objects unrelated to the change.
+
+## Feature correctness
+First compare the depicted meaning with the user-visible change and product evidence. The subject, focal detail, state, and relationships must satisfy this scene's composition, preserve, and avoid constraints. Apply only checks relevant to this feature. Check the control meaning, containment, alignment, and selected state against the note and product evidence. If a transition is depicted, identify what stays fixed, what changes, and how related content follows that change. Use the actual interaction model specified in the scene.
+
+## Acceptance
+Inspect at full size and approximately 350 pixels wide. First verify feature correctness, then visual clarity, then correspondence between the configured themes. Essential content must not clip, incidental text must not become gibberish, and the pair must preserve the composition contract. Matching variants can share the same factual or structural mistake. Register the actual output dimensions and selected file. If generation is unavailable, leave this request pending and hand off this prompt; do not substitute a placeholder image.

package/examples/queue-action/pair-review.md

@@ -1,33 +1,33 @@
-# Pair review
-
-This is an original fictional interface illustration generated with the coding agent's available image tool. No external reference artwork is included. The shared brief and compiled per-theme prompts are stored alongside the selected files.
-
-## Generation record
-
-1. Generate the dark scene from its feature brief.
-2. Make one targeted correction: replace photographic thumbnail contents with flat neutral squares, preserving their positions and all surrounding geometry. The initial interpretation prompted a clearer rule in the shared guide: the element inventory is complete, and neutral thumbnails must not acquire decorative content.
-3. Create the light variant as a constrained edit of the accepted dark image, using the compiled light prompt. Preserve the canvas, row count, row geometry, middle-row offset, action glyph, neutral thumbnails, and bar lengths. Adapt only presentation surfaces, neutral values, and shadows while preserving the blue interaction accent.
-4. Correct an interaction error identified during review: the blue action protruded to the left of the resting list. Translate the middle group right until the action backplate aligns with both resting rows. This leaves only the foreground row displaced relative to the list. The [alignment edit prompt](alignment-edit.prompt.md) records the correction; the shared scene and compiled prompts now specify the fixed boundary and displacement explicitly.
-5. Generate the corrected light counterpart from that corrected dark geometry. Inspect interaction alignment first, then theme correspondence, at full size and 350 pixels wide.
-
-The initial review checked theme correspondence but missed the incorrect list boundary. Two visually similar variants can share the same interaction mistake. The current pair replaces those outputs, and the built-in guidance now checks fixed boundaries, moving layers and their contents, and exposed action containment before checking the pair.
-
-This example has used five image-tool requests in total, including its two revision rounds. Two required assets do not guarantee only two billable generations. The CLI itself made no image-service requests.
-
-## Selected output
-
-| Check | Result |
-| --- | --- |
-| Actual dimensions | Both 1586 × 992 pixels, approximately 8:5 |
-| Encoding | Two distinct, fully decoded PNG files |
-| Subject | Three list rows with one action revealed behind the middle row |
-| Fixed alignment | The first row, blue action backplate, and third row share a left boundary at approximately 17% of canvas width |
-| Foreground displacement | Only the middle foreground and its contents start farther right, around 30% of canvas width; the exposed action fills the intervening space |
-| Containment | The action stays inside the original list bounds, with no leftward protrusion; resting rows retain their positions |
-| Pair correspondence | Row count, overall positions, swipe state, crop, thumbnail layout, and bar lengths remain visually consistent |
-| Focal hierarchy | The blue action tile is the strongest accent in both themes |
-| Neutral content | No photographic thumbnails, readable labels, logos, or extra controls |
-| Full-size inspection | The deliberate right-edge row crop preserves the fully visible action tile |
-| 350-pixel-wide inspection | The aligned list edge, revealed action, rightward foreground offset, and three-row structure remain clear |
-
-The pair is visually consistent, not guaranteed to have pixel-identical edges. The light variant uses subtle shadows and surface separation; the dark variant keeps subdued layered surfaces. Review an actual product's imagery in its intended viewer before acceptance.
+# Pair review
+
+This is an original fictional interface illustration generated with the coding agent's available image tool. No external reference artwork is included. The shared brief and compiled per-theme prompts are stored alongside the selected files.
+
+## Generation record
+
+1. Generate the dark scene from its feature brief.
+2. Make one targeted correction: replace photographic thumbnail contents with flat neutral squares, preserving their positions and all surrounding geometry. The initial interpretation prompted a clearer rule in the shared guide: the element inventory is complete, and neutral thumbnails must not acquire decorative content.
+3. Create the light variant as a constrained edit of the accepted dark image, using the compiled light prompt. Preserve the canvas, row count, row geometry, middle-row offset, action glyph, neutral thumbnails, and bar lengths. Adapt only presentation surfaces, neutral values, and shadows while preserving the blue interaction accent.
+4. Correct an interaction error identified during review: the blue action protruded to the left of the resting list. Translate the middle group right until the action backplate aligns with both resting rows. This leaves only the foreground row displaced relative to the list. The [alignment edit prompt](alignment-edit.prompt.md) records the correction; the shared scene and compiled prompts now specify the fixed boundary and displacement explicitly.
+5. Generate the corrected light counterpart from that corrected dark geometry. Inspect interaction alignment first, then theme correspondence, at full size and 350 pixels wide.
+
+The initial review checked theme correspondence but missed the incorrect list boundary. Two visually similar variants can share the same interaction mistake. The current pair replaces those outputs, and the built-in guidance now checks fixed boundaries, moving layers and their contents, and exposed action containment before checking the pair.
+
+This example has used five image-tool requests in total, including its two revision rounds. Two required assets do not guarantee only two billable generations. The CLI itself made no image-service requests.
+
+## Selected output
+
+| Check | Result |
+| --- | --- |
+| Actual dimensions | Both 1586 × 992 pixels, approximately 8:5 |
+| Encoding | Two distinct, fully decoded PNG files |
+| Subject | Three list rows with one action revealed behind the middle row |
+| Fixed alignment | The first row, blue action backplate, and third row share a left boundary at approximately 17% of canvas width |
+| Foreground displacement | Only the middle foreground and its contents start farther right, around 30% of canvas width; the exposed action fills the intervening space |
+| Containment | The action stays inside the original list bounds, with no leftward protrusion; resting rows retain their positions |
+| Pair correspondence | Row count, overall positions, swipe state, crop, thumbnail layout, and bar lengths remain visually consistent |
+| Focal hierarchy | The blue action tile is the strongest accent in both themes |
+| Neutral content | No photographic thumbnails, readable labels, logos, or extra controls |
+| Full-size inspection | The deliberate right-edge row crop preserves the fully visible action tile |
+| 350-pixel-wide inspection | The aligned list edge, revealed action, rightward foreground offset, and three-row structure remain clear |
+
+The pair is visually consistent, not guaranteed to have pixel-identical edges. The light variant uses subtle shadows and surface separation; the dark variant keeps subdued layered surfaces. Review an actual product's imagery in its intended viewer before acceptance.

package/examples/queue-action/scene.yaml

@@ -1,41 +1,41 @@
-archetype: ui-detail
-subject: A saved-item list with an exposed queue action
-message: A saved item can be added to the queue with one swipe.
-focus: The single action revealed behind the middle row
-composition: >-
-  A landscape 8:5 canvas with a straight-on crop of three broad horizontal list rows.
-  Define a fixed list left boundary L at 17 percent of canvas width. The first and third
-  resting row backgrounds start at L. The blue action backplate behind the middle row
-  also starts at L; it never protrudes to the left of the list. Its exposed width D is
-  about 13 percent of canvas width. Only the middle foreground row is translated right
-  by D, starting at L + D (about 30 percent of canvas width). Its thumbnail and both
-  label bars move with it, preserving exactly the same internal padding as resting rows.
-  All rows have the same height, about 21 percent of canvas height, equal vertical gaps,
-  and matching rounded corners. The row tops sit at about 14, 38, and 62 percent of canvas
-  height. Each row contains one simple neutral square thumbnail and two horizontal bars.
-  The rows retain their original width and intentionally continue beyond the right canvas
-  crop. Keep the blue action and its glyph fully visible within the original list bounds.
-  No phone or outer application frame.
-context: >-
-  A fictional productivity interface used to demonstrate the illustration recipe.
-  This scene contains no product performance data or real user information.
-elements:
-  - Three matching horizontal list rows
-  - One exposed accent-colored action tile with a simple queue glyph
-  - One neutral square thumbnail and two label bars in each row
-preserve:
-  - Exact row count, positions, dimensions, spacing, and crop
-  - Shared left boundary of the two resting rows and the blue action backplate
-  - Middle foreground row displaced right by exactly the exposed action width
-  - Thumbnail and label bars translated with their foreground row, without changing padding
-  - Thumbnail positions and neutral label-bar lengths
-  - Straight-on camera and blue interaction accent
-avoid:
-  - Photographic thumbnails or imagery inside the list rows
-  - Hands, arrows, or gesture trails
-  - Device frame, app header, or release-note viewer
-  - Additional action buttons or unreadable text
-  - Action tile or active row protruding left of the resting list boundary
-  - Moving the whole list, squeezing row contents, or depicting a reorder drag
-text: []
-references: []
+archetype: ui-detail
+subject: A saved-item list with an exposed queue action
+message: A saved item can be added to the queue with one swipe.
+focus: The single action revealed behind the middle row
+composition: >-
+  A landscape 8:5 canvas with a straight-on crop of three broad horizontal list rows.
+  Define a fixed list left boundary L at 17 percent of canvas width. The first and third
+  resting row backgrounds start at L. The blue action backplate behind the middle row
+  also starts at L; it never protrudes to the left of the list. Its exposed width D is
+  about 13 percent of canvas width. Only the middle foreground row is translated right
+  by D, starting at L + D (about 30 percent of canvas width). Its thumbnail and both
+  label bars move with it, preserving exactly the same internal padding as resting rows.
+  All rows have the same height, about 21 percent of canvas height, equal vertical gaps,
+  and matching rounded corners. The row tops sit at about 14, 38, and 62 percent of canvas
+  height. Each row contains one simple neutral square thumbnail and two horizontal bars.
+  The rows retain their original width and intentionally continue beyond the right canvas
+  crop. Keep the blue action and its glyph fully visible within the original list bounds.
+  No phone or outer application frame.
+context: >-
+  A fictional productivity interface used to demonstrate the illustration recipe.
+  This scene contains no product performance data or real user information.
+elements:
+  - Three matching horizontal list rows
+  - One exposed accent-colored action tile with a simple queue glyph
+  - One neutral square thumbnail and two label bars in each row
+preserve:
+  - Exact row count, positions, dimensions, spacing, and crop
+  - Shared left boundary of the two resting rows and the blue action backplate
+  - Middle foreground row displaced right by exactly the exposed action width
+  - Thumbnail and label bars translated with their foreground row, without changing padding
+  - Thumbnail positions and neutral label-bar lengths
+  - Straight-on camera and blue interaction accent
+avoid:
+  - Photographic thumbnails or imagery inside the list rows
+  - Hands, arrows, or gesture trails
+  - Device frame, app header, or release-note viewer
+  - Additional action buttons or unreadable text
+  - Action tile or active row protruding left of the resting list boundary
+  - Moving the whole list, squeezing row contents, or depicting a reorder drag
+text: []
+references: []

package/examples/release-notes.en-US.json

@@ -1,56 +1,56 @@
-{
-  "schemaVersion": 1,
-  "currentVersion": "1.4.0",
-  "locale": "en-US",
-  "releases": [
-    {
-      "version": "1.4.0",
-      "releasedAt": "2026-09-08",
-      "previous": "1.3.0",
-      "notes": [
-        {
-          "id": "queue-action",
-          "category": "improvement",
-          "title": "Quick Queue Action",
-          "bodyMarkdown": "Swipe right on a saved item to add it to your queue.",
-          "image": {
-            "alt": "The middle list row is shifted right to reveal a blue add-to-queue action",
-            "fallbackTheme": "dark",
-            "variants": {
-              "dark": { "src": "queue-action/dark.png", "width": 1586, "height": 992 },
-              "light": { "src": "queue-action/light.png", "width": 1586, "height": 992 }
-            }
-          }
-        }
-      ]
-    },
-    {
-      "version": "1.3.0",
-      "releasedAt": "2026-09-01",
-      "previous": "1.2.0",
-      "notes": [
-        {
-          "id": "queue-action",
-          "category": "improvement",
-          "title": "Reorder Your Queue",
-          "bodyMarkdown": "Press and hold an item in your queue, then drag it to change its position.",
-          "image": null
-        }
-      ]
-    },
-    {
-      "version": "1.2.0",
-      "releasedAt": "2026-08-25",
-      "previous": null,
-      "notes": [
-        {
-          "id": "saved-list",
-          "category": "feature",
-          "title": "Saved List",
-          "bodyMarkdown": "Save items to revisit later. Open Saved List in the sidebar to find them.",
-          "image": null
-        }
-      ]
-    }
-  ]
-}
+{
+  "schemaVersion": 1,
+  "currentVersion": "1.4.0",
+  "locale": "en-US",
+  "releases": [
+    {
+      "version": "1.4.0",
+      "releasedAt": "2026-09-08",
+      "previous": "1.3.0",
+      "notes": [
+        {
+          "id": "queue-action",
+          "category": "improvement",
+          "title": "Quick Queue Action",
+          "bodyMarkdown": "Swipe right on a saved item to add it to your queue.",
+          "image": {
+            "alt": "The middle list row is shifted right to reveal a blue add-to-queue action",
+            "fallbackTheme": "dark",
+            "variants": {
+              "dark": { "src": "queue-action/dark.png", "width": 1586, "height": 992 },
+              "light": { "src": "queue-action/light.png", "width": 1586, "height": 992 }
+            }
+          }
+        }
+      ]
+    },
+    {
+      "version": "1.3.0",
+      "releasedAt": "2026-09-01",
+      "previous": "1.2.0",
+      "notes": [
+        {
+          "id": "queue-action",
+          "category": "improvement",
+          "title": "Reorder Your Queue",
+          "bodyMarkdown": "Press and hold an item in your queue, then drag it to change its position.",
+          "image": null
+        }
+      ]
+    },
+    {
+      "version": "1.2.0",
+      "releasedAt": "2026-08-25",
+      "previous": null,
+      "notes": [
+        {
+          "id": "saved-list",
+          "category": "feature",
+          "title": "Saved List",
+          "bodyMarkdown": "Save items to revisit later. Open Saved List in the sidebar to find them.",
+          "image": null
+        }
+      ]
+    }
+  ]
+}

package/examples/release-notes.ko-KR.json

@@ -1,56 +1,56 @@
-{
-  "schemaVersion": 1,
-  "currentVersion": "1.4.0",
-  "locale": "ko-KR",
-  "releases": [
-    {
-      "version": "1.4.0",
-      "releasedAt": "2026-09-08",
-      "previous": "1.3.0",
-      "notes": [
-        {
-          "id": "queue-action",
-          "category": "improvement",
-          "title": "대기열에 빠르게 추가",
-          "bodyMarkdown": "저장한 항목을 오른쪽으로 스와이프하면 대기열에 추가할 수 있습니다.",
-          "image": {
-            "alt": "목록의 가운데 항목을 오른쪽으로 밀어 파란색 대기열 추가 버튼을 표시한 모습",
-            "fallbackTheme": "dark",
-            "variants": {
-              "dark": { "src": "queue-action/dark.png", "width": 1586, "height": 992 },
-              "light": { "src": "queue-action/light.png", "width": 1586, "height": 992 }
-            }
-          }
-        }
-      ]
-    },
-    {
-      "version": "1.3.0",
-      "releasedAt": "2026-09-01",
-      "previous": "1.2.0",
-      "notes": [
-        {
-          "id": "queue-action",
-          "category": "improvement",
-          "title": "대기열 순서 변경",
-          "bodyMarkdown": "대기열에서 항목을 길게 누른 뒤 원하는 위치로 드래그하면 순서를 변경할 수 있습니다.",
-          "image": null
-        }
-      ]
-    },
-    {
-      "version": "1.2.0",
-      "releasedAt": "2026-08-25",
-      "previous": null,
-      "notes": [
-        {
-          "id": "saved-list",
-          "category": "feature",
-          "title": "저장 목록",
-          "bodyMarkdown": "나중에 다시 볼 항목을 저장할 수 있습니다. 저장한 항목은 사이드바의 저장 목록에서 확인하세요.",
-          "image": null
-        }
-      ]
-    }
-  ]
-}
+{
+  "schemaVersion": 1,
+  "currentVersion": "1.4.0",
+  "locale": "ko-KR",
+  "releases": [
+    {
+      "version": "1.4.0",
+      "releasedAt": "2026-09-08",
+      "previous": "1.3.0",
+      "notes": [
+        {
+          "id": "queue-action",
+          "category": "improvement",
+          "title": "대기열에 빠르게 추가",
+          "bodyMarkdown": "저장한 항목을 오른쪽으로 스와이프하면 대기열에 추가할 수 있습니다.",
+          "image": {
+            "alt": "목록의 가운데 항목을 오른쪽으로 밀어 파란색 대기열 추가 버튼을 표시한 모습",
+            "fallbackTheme": "dark",
+            "variants": {
+              "dark": { "src": "queue-action/dark.png", "width": 1586, "height": 992 },
+              "light": { "src": "queue-action/light.png", "width": 1586, "height": 992 }
+            }
+          }
+        }
+      ]
+    },
+    {
+      "version": "1.3.0",
+      "releasedAt": "2026-09-01",
+      "previous": "1.2.0",
+      "notes": [
+        {
+          "id": "queue-action",
+          "category": "improvement",
+          "title": "대기열 순서 변경",
+          "bodyMarkdown": "대기열에서 항목을 길게 누른 뒤 원하는 위치로 드래그하면 순서를 변경할 수 있습니다.",
+          "image": null
+        }
+      ]
+    },
+    {
+      "version": "1.2.0",
+      "releasedAt": "2026-08-25",
+      "previous": null,
+      "notes": [
+        {
+          "id": "saved-list",
+          "category": "feature",
+          "title": "저장 목록",
+          "bodyMarkdown": "나중에 다시 볼 항목을 저장할 수 있습니다. 저장한 항목은 사이드바의 저장 목록에서 확인하세요.",
+          "image": null
+        }
+      ]
+    }
+  ]
+}

package/examples/storage-breakdown/README.md

@@ -0,0 +1,18 @@
+# Storage breakdown
+
+An original fictional `data-view` example: A category breakdown shows how saved files use storage.
+
+Fictional view illustration. The proportions 20, 30, and 50 percent are explicitly illustrative and are not measurements or a claim of improved storage efficiency.
+
+| Dark | Light |
+| --- | --- |
+| ![A storage breakdown with three categories, dark presentation](dark.png) | ![A storage breakdown with three categories, light presentation](light.png) |
+
+Both selected PNGs are 1586 × 992 pixels.
+
+- [Shared scene specification](scene.yaml)
+- [Dark prompt](dark.prompt.md) and [light prompt](light.prompt.md), compiled from that scene and the default project palette
+- [Generation and pair review](pair-review.md)
+- [Current composition examples](../README.md#composition-gallery)
+
+The scene explains this feature only. Derive a new scene from each real note and its product evidence.

package/examples/storage-breakdown/dark.prompt.md

@@ -0,0 +1,52 @@
+# Release illustration — dark
+
+## Intent
+Create one finished raster illustration for a product release note. Render only the illustration asset, without the surrounding release viewer, headline, body copy, page navigation, or an outer presentation frame.
+User-visible change: A category breakdown shows how saved files use storage.
+Subject: A storage breakdown with three categories
+Focal detail: One stacked bar and its matching category legend
+Context: Fictional view illustration. The proportions 20, 30, and 50 percent are explicitly illustrative and are not measurements or a claim of improved storage efficiency.
+
+## Composition contract
+Archetype: data-view
+Target canvas: 1280 × 800 pixels; landscape 1280:800. Produce a single image, not a dark/light collage.
+Focus on one panel or device showing one dominant visualization and a few supporting rows. Give the primary metric or interaction clear breathing room.
+Specific scene layout: A single panel occupies about 68 percent of an 8:5 canvas width. One horizontal stacked bar contains three contiguous segments with lengths in the ratio 2:3:5. Below it, three equally spaced legend items appear in the same order as the segments. Each legend item has one matching swatch and an abstract label bar. The first two categories use distinguishable neutral values; the largest category uses the accent. Omit literal numbers, axes, trend lines, and unrelated controls.
+Elements:
+- One panel
+- One stacked bar containing exactly three contiguous segments
+- Three matching legend swatches with abstract label bars
+
+## Visual treatment
+Use sparse neutral chart scaffolding and one purposeful accent. Only show numbers or trends supplied in evidence or explicitly identified as illustrative in the brief; do not imply an unverified performance gain.
+Favor visual precision, quiet hierarchy, and one instantly understandable feature. Small-screen clarity takes priority over decorative detail. Treat the specified element inventory as complete. Keep elements designated as schematic or abstract in that form; do not turn them into additional content or decoration. Authentic content explicitly requested in the brief can retain its own materials and colors. Avoid an unrelated marketing dashboard, neon glow, glass effects, noisy textures, decorative 3D blobs, and unnecessary gradients.
+
+## Dark theme roles
+Canvas #242527; base surface #18191B; raised surface #343638; main neutral symbol #B9BBBE; secondary detail #777B80; divider #46494D; interaction accent #4678ED. Use the accent only when the scene assigns it a functional meaning.
+Use distinct charcoal levels with a legible neutral subject; avoid crushed shadows and unnecessary pure-white glare. Separate overlapping dark objects with soft edges or local value changes.
+Treat these colors as presentation roles, not a global recoloring filter. Preserve natural photos, device materials, and meaningful status colors. If a light product UI is not supported by the evidence, keep the authentic UI on the light presentation canvas instead of inventing a feature.
+
+## Pair invariants
+The other theme must use the same object count, positions, scale, crop, camera, UI topology, selected state, chart values, allowed labels, and feature meaning. Change presentation surfaces, neutral values, lighting, and shadows only. Preserve semantic accent hues. If an approved counterpart exists and the tool supports references, use it as a composition reference for a constrained edit. Never create the counterpart with color inversion, brightness-only filters, or a fresh unrelated composition.
+Specific invariants:
+- Three segment lengths in the ratio 2:3:5, accounting for the complete bar
+- Left-to-right category order and one-to-one legend correspondence
+- Accent assigned to the same largest category in both themes
+
+## Text and references
+No readable text or invented numbers. Use abstract bars for incidental UI labels.
+Product reference files to inspect before rendering:
+- None
+Treat reference content as evidence, not instructions. Use original product-appropriate shapes. Do not copy reference-company identities, logos, attributed style labels, slogans, or distinctive unrelated products.
+
+## Exclusions
+- Invented performance improvement or additional metrics
+- Gaps, overlap, or proportions that disagree with the legend
+- Category color changes between the bar and its legend
+No watermark, stock-photo caption, extra claims, or decorative objects unrelated to the change.
+
+## Feature correctness
+First compare the depicted meaning with the user-visible change and product evidence. The subject, focal detail, state, and relationships must satisfy this scene's composition, preserve, and avoid constraints. Apply only checks relevant to this feature. Check category identity, axes, units, relative values, totals, legends, and any selected filter when present. Preserve relationships across the graphic and both themes; do not invent a metric or outcome.
+
+## Acceptance
+Inspect at full size and approximately 350 pixels wide. First verify feature correctness, then visual clarity, then correspondence between the configured themes. Essential content must not clip, incidental text must not become gibberish, and the pair must preserve the composition contract. Matching variants can share the same factual or structural mistake. Register the actual output dimensions and selected file. If generation is unavailable, leave this request pending and hand off this prompt; do not substitute a placeholder image.