@getrheo/rheo-skill 1.0.0

package/rheo/rheo-flow-import/examples/branching-onboarding.manifest.json

@@ -0,0 +1,155 @@
+{
+  "flowId": "00000000-0000-0000-0000-000000000001",
+  "schemaVersion": 7,
+  "version": 1,
+  "defaultLocale": "en",
+  "locales": ["en"],
+  "entryScreenId": "dec_platform",
+  "theme": {
+    "primary": "#111827",
+    "primaryForeground": "#FFFFFF",
+    "background": "#FFFFFF",
+    "foreground": "#111827",
+    "borderRadius": 14
+  },
+  "screens": [
+    {
+      "id": "scr_ios_intro",
+      "name": "iOS intro",
+      "regions": {
+        "body": {
+          "id": "lyr_ios_body",
+          "kind": "stack",
+          "direction": "vertical",
+          "gap": 14,
+          "style": { "padding": { "t": 24, "r": 20, "b": 24, "l": 20 } },
+          "children": [
+            {
+              "id": "lyr_ios_title",
+              "kind": "text",
+              "text": { "default": "Welcome on iOS" },
+              "style": { "fontSize": 24, "fontWeight": 700, "color": "#111827" }
+            },
+            {
+              "id": "lyr_ios_continue",
+              "kind": "button",
+              "variant": "primary",
+              "action": { "kind": "continue" },
+              "direction": "horizontal",
+              "align": "center",
+              "distribution": "center",
+              "children": [
+                {
+                  "id": "lyr_ios_continue_text",
+                  "kind": "text",
+                  "text": { "default": "Continue" },
+                  "style": { "color": "#FFFFFF" }
+                }
+              ]
+            }
+          ]
+        }
+      },
+      "next": { "default": "scr_done" }
+    },
+    {
+      "id": "scr_android_intro",
+      "name": "Android intro",
+      "regions": {
+        "body": {
+          "id": "lyr_android_body",
+          "kind": "stack",
+          "direction": "vertical",
+          "gap": 14,
+          "style": { "padding": { "t": 24, "r": 20, "b": 24, "l": 20 } },
+          "children": [
+            {
+              "id": "lyr_android_title",
+              "kind": "text",
+              "text": { "default": "Welcome on Android" },
+              "style": { "fontSize": 24, "fontWeight": 700, "color": "#111827" }
+            },
+            {
+              "id": "lyr_android_continue",
+              "kind": "button",
+              "variant": "primary",
+              "action": { "kind": "continue" },
+              "direction": "horizontal",
+              "align": "center",
+              "distribution": "center",
+              "children": [
+                {
+                  "id": "lyr_android_continue_text",
+                  "kind": "text",
+                  "text": { "default": "Continue" },
+                  "style": { "color": "#FFFFFF" }
+                }
+              ]
+            }
+          ]
+        }
+      },
+      "next": { "default": "scr_done" }
+    },
+    {
+      "id": "scr_done",
+      "name": "Done",
+      "regions": {
+        "body": {
+          "id": "lyr_done_body",
+          "kind": "stack",
+          "direction": "vertical",
+          "gap": 14,
+          "style": { "padding": { "t": 24, "r": 20, "b": 24, "l": 20 } },
+          "children": [
+            {
+              "id": "lyr_done_title",
+              "kind": "text",
+              "text": { "default": "All set" },
+              "style": { "fontSize": 24, "fontWeight": 700, "color": "#111827" }
+            },
+            {
+              "id": "lyr_done_end",
+              "kind": "button",
+              "variant": "primary",
+              "action": { "kind": "end_flow" },
+              "direction": "horizontal",
+              "align": "center",
+              "distribution": "center",
+              "children": [
+                {
+                  "id": "lyr_done_end_text",
+                  "kind": "text",
+                  "text": { "default": "Finish" },
+                  "style": { "color": "#FFFFFF" }
+                }
+              ]
+            }
+          ]
+        }
+      },
+      "next": { "default": null }
+    }
+  ],
+  "decisionNodes": [
+    {
+      "id": "dec_platform",
+      "name": "Platform",
+      "cases": [
+        {
+          "id": "case_ios",
+          "name": "iOS",
+          "expression": {
+            "kind": "predicate",
+            "variable": { "kind": "builtin", "name": "platform" },
+            "predicate": { "type": "string", "pred": { "op": "eq", "value": "ios" } }
+          },
+          "next": "scr_ios_intro"
+        }
+      ],
+      "elseNext": "scr_android_intro"
+    }
+  ],
+  "externalSurfaceNodes": [],
+  "sdkAttributeKeys": []
+}

package/rheo/rheo-flow-import/examples/flow-spec.example.json

@@ -0,0 +1,56 @@
+{
+  "defaultLocale": "en",
+  "entry": "scr_welcome",
+  "theme": {
+    "primary": "#6D5DF6",
+    "primaryForeground": "#FFFFFF",
+    "background": "#FFFFFF",
+    "foreground": "#0A0A0A",
+    "borderRadius": 16
+  },
+  "screens": [
+    {
+      "id": "scr_welcome",
+      "name": "Welcome",
+      "header": [
+        { "kind": "back_button", "variant": "outline" }
+      ],
+      "body": [
+        { "kind": "text", "text": "Welcome to Acme", "style": { "fontSize": 28, "fontWeight": 700, "align": "center", "color": "#0A0A0A" } },
+        { "kind": "text", "text": "A few quick questions to set you up.", "style": { "fontSize": 16, "align": "center", "color": "#0A0A0A" } }
+      ],
+      "footer": [
+        { "kind": "button", "label": "Get started", "action": "continue", "labelStyle": { "color": "#FFFFFF" } }
+      ],
+      "next": "scr_goal"
+    },
+    {
+      "id": "scr_goal",
+      "name": "Goal",
+      "body": [
+        { "kind": "text", "text": "What's your main goal?", "style": { "fontSize": 22, "fontWeight": 700, "color": "#0A0A0A" } },
+        {
+          "kind": "single_choice",
+          "fieldKey": "goal",
+          "options": [
+            { "optionId": "focus", "label": "Stay focused", "style": { "border": { "width": 1, "color": "#E5E7EB" }, "radius": 12, "padding": { "t": 16, "r": 16, "b": 16, "l": 16 } }, "selectedStyle": { "border": { "width": 1, "color": "#6D5DF6" } }, "labelStyle": { "color": "#0A0A0A" } },
+            { "optionId": "relax", "label": "Relax more", "style": { "border": { "width": 1, "color": "#E5E7EB" }, "radius": 12, "padding": { "t": 16, "r": 16, "b": 16, "l": 16 } }, "selectedStyle": { "border": { "width": 1, "color": "#6D5DF6" } }, "labelStyle": { "color": "#0A0A0A" } }
+          ]
+        }
+      ],
+      "footer": [
+        { "kind": "button", "label": "Continue", "action": "continue", "labelStyle": { "color": "#FFFFFF" } }
+      ],
+      "next": "scr_done"
+    },
+    {
+      "id": "scr_done",
+      "name": "Done",
+      "body": [
+        { "kind": "text", "text": "You're all set", "style": { "fontSize": 24, "fontWeight": 700, "align": "center", "color": "#0A0A0A" } },
+        { "kind": "button", "label": "Finish", "action": "end_flow", "labelStyle": { "color": "#FFFFFF" } }
+      ],
+      "next": null
+    }
+  ]
+}

package/rheo/rheo-flow-import/examples/linear-onboarding.manifest.json

@@ -0,0 +1,104 @@
+{
+  "flowId": "00000000-0000-0000-0000-000000000001",
+  "schemaVersion": 7,
+  "version": 1,
+  "defaultLocale": "en",
+  "locales": ["en"],
+  "entryScreenId": "scr_welcome",
+  "theme": {
+    "primary": "#0A0A0A",
+    "primaryForeground": "#FFFFFF",
+    "background": "#FFFFFF",
+    "foreground": "#0A0A0A",
+    "borderRadius": 16
+  },
+  "screens": [
+    {
+      "id": "scr_welcome",
+      "name": "Welcome",
+      "regions": {
+        "body": {
+          "id": "lyr_welcome_body",
+          "kind": "stack",
+          "direction": "vertical",
+          "gap": 16,
+          "style": { "padding": { "t": 24, "r": 20, "b": 24, "l": 20 } },
+          "children": [
+            {
+              "id": "lyr_welcome_title",
+              "kind": "text",
+              "text": { "default": "Welcome to Acme" },
+              "style": { "fontSize": 28, "fontWeight": 700, "align": "center", "color": "#0A0A0A" }
+            },
+            {
+              "id": "lyr_welcome_body_text",
+              "kind": "text",
+              "text": { "default": "Set up your account in a few quick steps." },
+              "style": { "fontSize": 16, "fontWeight": 400, "align": "center", "color": "#0A0A0A" }
+            },
+            {
+              "id": "lyr_welcome_continue",
+              "kind": "button",
+              "variant": "primary",
+              "action": { "kind": "continue" },
+              "direction": "horizontal",
+              "align": "center",
+              "distribution": "center",
+              "children": [
+                {
+                  "id": "lyr_welcome_continue_text",
+                  "kind": "text",
+                  "text": { "default": "Get started" },
+                  "style": { "color": "#FFFFFF" }
+                }
+              ]
+            }
+          ]
+        }
+      },
+      "next": { "default": "scr_done" }
+    },
+    {
+      "id": "scr_done",
+      "name": "Done",
+      "regions": {
+        "body": {
+          "id": "lyr_done_body",
+          "kind": "stack",
+          "direction": "vertical",
+          "gap": 16,
+          "style": { "padding": { "t": 24, "r": 20, "b": 24, "l": 20 } },
+          "children": [
+            {
+              "id": "lyr_done_title",
+              "kind": "text",
+              "text": { "default": "You are ready" },
+              "style": { "fontSize": 24, "fontWeight": 700, "align": "center", "color": "#0A0A0A" }
+            },
+            {
+              "id": "lyr_done_finish",
+              "kind": "button",
+              "variant": "primary",
+              "action": { "kind": "end_flow" },
+              "direction": "horizontal",
+              "align": "center",
+              "distribution": "center",
+              "children": [
+                {
+                  "id": "lyr_done_finish_text",
+                  "kind": "text",
+                  "text": { "default": "Finish" },
+                  "style": { "color": "#FFFFFF" }
+                }
+              ]
+            }
+          ]
+        }
+      },
+      "next": { "default": null }
+    }
+  ],
+  "decisionNodes": [],
+  "externalSurfaceNodes": [],
+  "sdkAttributeKeys": []
+}

package/rheo/rheo-flow-import/examples/revenuecat-paywall.manifest.json

@@ -0,0 +1,154 @@
+{
+  "flowId": "00000000-0000-0000-0000-000000000001",
+  "schemaVersion": 7,
+  "version": 1,
+  "defaultLocale": "en",
+  "locales": ["en"],
+  "entryScreenId": "scr_intro",
+  "theme": {
+    "primary": "#18181B",
+    "primaryForeground": "#FFFFFF",
+    "background": "#FFFFFF",
+    "foreground": "#18181B",
+    "borderRadius": 16
+  },
+  "screens": [
+    {
+      "id": "scr_intro",
+      "name": "Intro",
+      "regions": {
+        "body": {
+          "id": "lyr_intro_body",
+          "kind": "stack",
+          "direction": "vertical",
+          "gap": 16,
+          "style": { "padding": { "t": 24, "r": 20, "b": 24, "l": 20 } },
+          "children": [
+            {
+              "id": "lyr_intro_title",
+              "kind": "text",
+              "text": { "default": "Unlock premium" },
+              "style": { "fontSize": 26, "fontWeight": 700, "align": "center", "color": "#18181B" }
+            },
+            {
+              "id": "lyr_intro_continue",
+              "kind": "button",
+              "variant": "primary",
+              "action": { "kind": "continue" },
+              "direction": "horizontal",
+              "align": "center",
+              "distribution": "center",
+              "children": [
+                {
+                  "id": "lyr_intro_continue_text",
+                  "kind": "text",
+                  "text": { "default": "See plans" },
+                  "style": { "color": "#FFFFFF" }
+                }
+              ]
+            }
+          ]
+        }
+      },
+      "next": { "default": "surf_paywall" }
+    },
+    {
+      "id": "scr_premium",
+      "name": "Premium success",
+      "regions": {
+        "body": {
+          "id": "lyr_premium_body",
+          "kind": "stack",
+          "direction": "vertical",
+          "gap": 16,
+          "style": { "padding": { "t": 24, "r": 20, "b": 24, "l": 20 } },
+          "children": [
+            {
+              "id": "lyr_premium_title",
+              "kind": "text",
+              "text": { "default": "Premium is ready" },
+              "style": { "fontSize": 24, "fontWeight": 700, "color": "#18181B" }
+            },
+            {
+              "id": "lyr_premium_end",
+              "kind": "button",
+              "variant": "primary",
+              "action": { "kind": "end_flow" },
+              "direction": "horizontal",
+              "align": "center",
+              "distribution": "center",
+              "children": [
+                {
+                  "id": "lyr_premium_end_text",
+                  "kind": "text",
+                  "text": { "default": "Finish" },
+                  "style": { "color": "#FFFFFF" }
+                }
+              ]
+            }
+          ]
+        }
+      },
+      "next": { "default": null }
+    },
+    {
+      "id": "scr_free",
+      "name": "Continue free",
+      "regions": {
+        "body": {
+          "id": "lyr_free_body",
+          "kind": "stack",
+          "direction": "vertical",
+          "gap": 16,
+          "style": { "padding": { "t": 24, "r": 20, "b": 24, "l": 20 } },
+          "children": [
+            {
+              "id": "lyr_free_title",
+              "kind": "text",
+              "text": { "default": "Continue with free" },
+              "style": { "fontSize": 24, "fontWeight": 700, "color": "#18181B" }
+            },
+            {
+              "id": "lyr_free_end",
+              "kind": "button",
+              "variant": "secondary",
+              "action": { "kind": "end_flow" },
+              "direction": "horizontal",
+              "align": "center",
+              "distribution": "center",
+              "children": [
+                {
+                  "id": "lyr_free_end_text",
+                  "kind": "text",
+                  "text": { "default": "Finish" },
+                  "style": { "color": "#FFFFFF" }
+                }
+              ]
+            }
+          ]
+        }
+      },
+      "next": { "default": null }
+    }
+  ],
+  "decisionNodes": [],
+  "externalSurfaceNodes": [
+    {
+      "id": "surf_paywall",
+      "name": "RevenueCat paywall",
+      "config": {
+        "provider": "revenuecat",
+        "offeringId": "default",
+        "presentation": "paywall"
+      },
+      "outcomes": {
+        "purchase_completed": "scr_premium",
+        "restore_completed": "scr_premium",
+        "dismissed": "scr_free",
+        "failed": "scr_free"
+      },
+      "fallback": "scr_free"
+    }
+  ],
+  "sdkAttributeKeys": []
+}

package/rheo/rheo-flow-import/references/animation-import.md

@@ -0,0 +1,79 @@
+# Animation import
+
+Map motion from the customer codebase into Rheo’s **existing** animation IR. Do not invent custom keyframe DSL or cross-screen transitions.
+
+## Gates (required)
+
+1. **Intake Q6** — “Match motion from the codebase (may differ slightly from Rheo presets)?”  
+   - **Yes** → apply motion from the audit (steps below).  
+   - **No** → omit all `screen.animations`, `screen.stagger`, and layer `restingMotion` / `restingMotions`.
+
+2. **Plan** — Animations require **Grow+** (`entitlements.animations`).  
+   - Dashboard bundle import strips motion when the workspace plan lacks animations.  
+   - Offline agent imports: confirm plan in chat; strip motion before zip if Indie.
+
+## Rheo surfaces
+
+| Surface | Manifest fields |
+|---------|-----------------|
+| Screen clips | `screen.animations[]` — `trigger`: `mount` \| `stagger` \| `unmount` |
+| Stagger gap | `screen.stagger.stepMs` when any clip uses `trigger: stagger` |
+| Resting loops | `layer.restingMotion` — presets: `translate`, `bounce`, `scale`, `pulse`, `rotate` (conservative only) |
+| Lottie / video | **Assets only** — never duplicate as timeline clips |
+
+**Out of scope:** `ScreenTransition`, CSS/Framer, gesture-driven pan/pinch, physics-accurate springs.
+
+## Audit workflow
+
+```bash
+node scripts/audit-import.mjs --entry <screen.tsx> --root <repo> \
+  --out rheo-import.audit.md \
+  --suggest-animations rheo-import.animations.json
+```
+
+Read **Animation And Motion Evidence** in the audit. Use `rheo-import.animations.json` for preset ids, `targetLayerId` hints, `durationMs`, and `staggerIndex`.
+
+### Preset ids (mount)
+
+| Preset | Source hint |
+|--------|-------------|
+| `fade-in` | opacity 0→1 |
+| `slide-up` | translateY +16→0 |
+| `slide-down-in` | translateY -16→0 |
+| `slide-in-left` / `slide-in-right` | translateX ±24→0 |
+| `scale-in` | scale + opacity |
+
+### Preset ids (unmount)
+
+`fade-out`, `slide-up-out`, `slide-down-out`, `slide-left-out`, `slide-right-out`, `scale-out`
+
+### Stagger
+
+Only when source has **explicit** stagger (`staggerChildren`, delay arrays, Reanimated stagger). One clip per child: `trigger: stagger`, `staggerIndex` 0..n, shared preset.
+
+### Unmappable motion
+
+Springs (`withSpring` custom damping), unknown curves → **omit** from manifest; keep audit note only. Do not pick “nearest” presets.
+
+### Timing
+
+Use source `durationMs` / `delayMs` when 50–800ms; otherwise preset defaults (mount ~320ms, unmount ~280ms).
+
+## Manifest authoring
+
+1. Resolve `layer:<screenSlug>:<role>` hints to real layer ids on each screen.
+2. Build clips with full `tracks` (copy from suggest JSON or builder-equivalent shapes).
+3. Clip `id`: `clip-<preset>-<layerId-slug>`.
+4. Max ~12 clips per screen; prioritize hero + stagger children.
+5. Run `node scripts/validate-manifest.mjs ./rheo-import.manifest.json` — fixes `animation_target_layer_missing`, `animation_stagger_index_required`, etc.
+
+## Validation codes (warnings)
+
+| Code | Meaning |
+|------|---------|
+| `animation_target_layer_missing` | `targetLayerId` not on screen |
+| `animation_stagger_index_required` | `trigger: stagger` without `staggerIndex` |
+| `animation_unmount_stagger_forbidden` | `unmount` clip has `staggerIndex` |
+| `animation_duration_out_of_range` | `durationMs` outside 50–800 |
+
+Publish gates do **not** require animations for publish.

package/rheo/rheo-flow-import/references/capabilities.md

@@ -0,0 +1,107 @@
+# Rheo Capability Surface
+
+> Generated from `@getrheo/contracts`. Do not hand-edit — run `pnpm --filter @getrheo/rheo-skill gen:capabilities`.
+
+Manifest schema version: 7
+
+Only the kinds, actions, permissions, and variants listed here are valid. Never invent a layer kind, action,
+permission key, or variant — the dashboard import runs full Zod validation and rejects anything not below.
+
+## Layer kinds
+
+Every layer `kind` accepted by the manifest:
+
+- `stack`
+- `text`
+- `image`
+- `lottie`
+- `video`
+- `icon`
+- `button`
+- `back_button`
+- `progress`
+- `loader`
+- `counter`
+- `single_choice`
+- `multiple_choice`
+- `text_input`
+- `scale_input`
+- `oauth_provider`
+- `oauth_login`
+- `email_password_auth`
+- `email_password_field`
+- `email_password_submit`
+- `carousel`
+- `hyperlink`
+- `checkbox`
+
+Container layers that **must** include a `children` array (or `slides` for carousel): `stack`, `carousel`,
+`button`, `back_button`, `hyperlink`, `single_choice`, `multiple_choice`, `oauth_login`,
+`oauth_provider` (custom variant), `email_password_auth`, `email_password_field`, `email_password_submit`.
+
+## Button / back_button variants
+
+Allowed `variant` values (required on `button` and `back_button`): `primary`, `secondary`, `ghost`, `destructive`.
+
+Map source/framework variants: `outline`/`bordered`/`tertiary` -> `secondary` or `ghost`; `text`/`link`/`plain`
+-> `ghost`; `default`/`filled`/`solid` -> `primary`; `danger`/`error` -> `destructive`.
+
+## Button actions
+
+Valid `action.kind` values on `button` layers:
+
+- `none`
+- `continue`
+- `skip`
+- `end_flow`
+- `go_back_one_screen`
+- `go_to_step`
+- `request_os_permission`
+- `play_media`
+- `request_app_review`
+
+- `go_to_step` requires `screenId`.
+- `go_back_one_screen` accepts optional `fallbackScreenId`.
+- `request_os_permission` requires `permissionKey` and `outcomes` (`granted`/`denied`/`blocked`).
+- `play_media` requires `targetLayerIds` (≥1) pointing at Lottie/video layers on the same screen.
+- `back_button` takes **no** `action` (back navigation is built in).
+
+## OS permission keys
+
+Valid `permissionKey` values for `request_os_permission`:
+
+- `notifications`
+- `camera`
+- `microphone`
+- `photo_library`
+- `contacts`
+- `calendar`
+- `reminders`
+- `location_when_in_use`
+- `location_always`
+- `motion`
+- `bluetooth`
+- `app_tracking_transparency`
+- `speech_recognition`
+- `face_id`
+- `health_kit`
+- `media_library`
+- `local_network`
+- `nearby_interactions`
+- `nfc`
+- `full_screen_intent_android`
+- `sms_android`
+- `phone_android`
+
+## Inputs and auth
+
+- `text_input` types: `plain`, `email`, `phone`, `url`, `multiline`.
+- `text_input` classification: `safe`, `sensitive`.
+- `oauth_login` preset providers: `github`, `google`, `apple`.
+- `email_password_auth` modes: `sign_in`, `sign_up` (sign_up requires email + password + confirm fields).
+- `icon` families: `ionicons`.
+
+## External surface outcomes (RevenueCat)
+
+Normalized outcome keys for `externalSurfaceNodes[].outcomes`: `purchase_completed`, `purchase_cancelled`, `dismissed`, `failed`, `restore_completed`.
+Every external surface also needs a `fallback` jump target.