@farmslot/adapter-rn 0.15.0

package/templates/scripts/agentic/recipe/action-manifest.with-bridge.json

@@ -0,0 +1,599 @@
+{
+  "$schema": "https://farmslot.io/schemas/action-manifest-v1.schema.json",
+  "actions": {
+    "end": {
+      "description": "Finish recipe execution with an explicit status.",
+      "examples": [
+        {
+          "action": "end",
+          "status": "pass"
+        }
+      ]
+    },
+    "command": {
+      "description": "Run a project-local command during setup, diagnostics, or headless proof. Prefer UI actions only when the recipe must prove visible interaction.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "cmd": {
+            "type": "string"
+          },
+          "timeout_ms": {
+            "type": "integer"
+          },
+          "cwd": {
+            "type": "string"
+          },
+          "allow_failure": {
+            "type": "boolean"
+          }
+        },
+        "required": ["cmd"],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "command",
+          "intent": "Prepare the project state needed for this proof.",
+          "cmd": "true",
+          "next": "done"
+        }
+      ]
+    },
+    "app.status": {
+      "description": "Query the dev-only Farmslot Expo bridge to confirm the app is reachable.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "timeout_ms": {
+            "type": "integer"
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "app.status",
+          "intent": "Record the resolved application state before continuing.",
+          "next": "done"
+        }
+      ]
+    },
+    "app.hud": {
+      "description": "Display one concise human intent line from the current recipe node.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "clear": {
+            "type": "boolean"
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "app.hud",
+          "intent": "Show the current goal to the supervising human.",
+          "next": "done"
+        }
+      ]
+    },
+    "app.trace": {
+      "description": "Emit a lightweight bridge trace event for recipe timeline observability.",
+      "schema": {
+        "type": "object",
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "app.trace",
+          "intent": "Record the requested runtime timeline evidence.",
+          "next": "done"
+        }
+      ]
+    },
+    "ui.press": {
+      "description": "Press a native accessibility target on the assigned simulator or device.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "test_id": {
+            "type": "string"
+          },
+          "text": {
+            "type": "string"
+          },
+          "selector": {
+            "type": "string"
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "ui.press",
+          "intent": "Activate the requested visible control.",
+          "test_id": "example-control",
+          "next": "done"
+        }
+      ]
+    },
+    "ui.key_press": {
+      "description": "Send Back through native navigation, or Escape, Enter, or Return to the visible native keyboard, then wait for the resulting UI transition. Keyboard actions fail when no visible keyboard accepts them.",
+      "adapters": ["android", "ios"],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "key": {
+            "type": "string",
+            "enum": ["Back", "Escape", "Enter", "Return"]
+          },
+          "settle": {
+            "type": "boolean"
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 1
+          }
+        },
+        "required": ["key"],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "ui.key_press",
+          "intent": "Continue the requested keyboard interaction.",
+          "key": "Enter",
+          "next": "done"
+        }
+      ]
+    },
+    "ui.set_input": {
+      "description": "Set text on a native input. Android recipes must provide test_id so the replacement can be verified from the native snapshot. Values remain part of retained recipe artifacts, so recipes must not contain secrets.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "test_id": {
+            "type": "string"
+          },
+          "value": {
+            "type": "string"
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "ui.set_input",
+          "intent": "Provide the requested value in the visible form.",
+          "test_id": "example-input",
+          "value": "example",
+          "next": "done"
+        }
+      ]
+    },
+    "ui.scroll": {
+      "description": "Scroll the assigned native simulator or device and wait for stability.",
+      "schema": {
+        "type": "object",
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "ui.scroll",
+          "intent": "Expose the requested content for visible review.",
+          "next": "done"
+        }
+      ]
+    },
+    "ui.swipe": {
+      "description": "Swipe from a test-id target or explicit screen coordinates in one cardinal direction.",
+      "adapters": ["android", "ios"],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "target": {
+            "type": ["string", "object"],
+            "properties": { "x": { "type": "number" }, "y": { "type": "number" } },
+            "required": ["x", "y"],
+            "additionalProperties": false
+          },
+          "direction": { "type": "string", "enum": ["up", "down", "left", "right"] },
+          "distance": { "type": "number", "minimum": 1 },
+          "duration_ms": { "type": "integer", "minimum": 1 },
+          "timeout_ms": { "type": "integer", "minimum": 1 },
+          "settle": { "type": "boolean" }
+        },
+        "required": ["target", "direction", "distance", "duration_ms"],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "ui.swipe",
+          "intent": "Swipe the requested visible surface.",
+          "target": "example-scrollable",
+          "direction": "up",
+          "distance": 240,
+          "duration_ms": 300,
+          "next": "done"
+        }
+      ]
+    },
+    "ui.pan": {
+      "description": "Stream a continuous pointer path from a test-id target or explicit screen coordinates. Native adapters accept one path point or delta.",
+      "adapters": ["android", "ios"],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "target": {
+            "type": ["string", "object"],
+            "properties": { "x": { "type": "number" }, "y": { "type": "number" } },
+            "required": ["x", "y"],
+            "additionalProperties": false
+          },
+          "path": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "object",
+              "properties": { "x": { "type": "number" }, "y": { "type": "number" } },
+              "required": ["x", "y"],
+              "additionalProperties": false
+            }
+          },
+          "delta": {
+            "type": "object",
+            "properties": { "x": { "type": "number" }, "y": { "type": "number" } },
+            "required": ["x", "y"],
+            "additionalProperties": false
+          },
+          "duration_ms": { "type": "integer", "minimum": 1 },
+          "timeout_ms": { "type": "integer", "minimum": 1 },
+          "settle": { "type": "boolean" }
+        },
+        "required": ["target", "duration_ms"],
+        "additionalProperties": false
+      },
+      "adapter_schemas": {
+        "android": {
+          "type": "object",
+          "properties": {
+            "path": {
+              "type": "array",
+              "maxItems": 1,
+              "items": { "type": "object", "additionalProperties": true }
+            }
+          },
+          "additionalProperties": true
+        },
+        "ios": {
+          "type": "object",
+          "properties": {
+            "path": {
+              "type": "array",
+              "maxItems": 1,
+              "items": { "type": "object", "additionalProperties": true }
+            }
+          },
+          "additionalProperties": true
+        }
+      },
+      "examples": [
+        {
+          "action": "ui.pan",
+          "intent": "Pan through the requested pointer path.",
+          "target": "example-surface",
+          "path": [{ "x": 80, "y": 20 }],
+          "duration_ms": 400,
+          "next": "done"
+        }
+      ]
+    },
+    "ui.drag": {
+      "description": "Drag a grabbable test-id target or explicit screen coordinate. Native adapters accept one path point or delta.",
+      "adapters": ["android", "ios"],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "target": {
+            "type": ["string", "object"],
+            "properties": { "x": { "type": "number" }, "y": { "type": "number" } },
+            "required": ["x", "y"],
+            "additionalProperties": false
+          },
+          "path": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "object",
+              "properties": { "x": { "type": "number" }, "y": { "type": "number" } },
+              "required": ["x", "y"],
+              "additionalProperties": false
+            }
+          },
+          "delta": {
+            "type": "object",
+            "properties": { "x": { "type": "number" }, "y": { "type": "number" } },
+            "required": ["x", "y"],
+            "additionalProperties": false
+          },
+          "duration_ms": { "type": "integer", "minimum": 1 },
+          "timeout_ms": { "type": "integer", "minimum": 1 },
+          "settle": { "type": "boolean" }
+        },
+        "required": ["target", "duration_ms"],
+        "additionalProperties": false
+      },
+      "adapter_schemas": {
+        "android": {
+          "type": "object",
+          "properties": {
+            "path": {
+              "type": "array",
+              "maxItems": 1,
+              "items": { "type": "object", "additionalProperties": true }
+            }
+          },
+          "additionalProperties": true
+        },
+        "ios": {
+          "type": "object",
+          "properties": {
+            "path": {
+              "type": "array",
+              "maxItems": 1,
+              "items": { "type": "object", "additionalProperties": true }
+            }
+          },
+          "additionalProperties": true
+        }
+      },
+      "examples": [
+        {
+          "action": "ui.drag",
+          "intent": "Drag the requested control to a new value.",
+          "target": "example-slider",
+          "delta": { "x": 120, "y": 0 },
+          "duration_ms": 500,
+          "next": "done"
+        }
+      ]
+    },
+    "ui.long_press": {
+      "description": "Hold a test-id target or explicit screen coordinate for a bounded duration.",
+      "adapters": ["android", "ios"],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "target": {
+            "type": ["string", "object"],
+            "properties": { "x": { "type": "number" }, "y": { "type": "number" } },
+            "required": ["x", "y"],
+            "additionalProperties": false
+          },
+          "hold_ms": { "type": "integer", "minimum": 1 },
+          "timeout_ms": { "type": "integer", "minimum": 1 },
+          "settle": { "type": "boolean" }
+        },
+        "required": ["target", "hold_ms"],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "ui.long_press",
+          "intent": "Hold the requested visible control.",
+          "target": "example-control",
+          "hold_ms": 700,
+          "next": "done"
+        }
+      ]
+    },
+    "ui.wait_for": {
+      "description": "Wait for native accessibility content and UI stability.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "text_contains": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "timeout_ms": {
+            "type": "integer"
+          },
+          "text": {
+            "type": "string"
+          },
+          "target": {
+            "type": "string"
+          },
+          "test_id": {
+            "type": "string"
+          },
+          "visible": {
+            "type": "boolean"
+          },
+          "event": {
+            "type": "string"
+          },
+          "selector": {
+            "type": "string"
+          },
+          "expected": {
+            "type": "string"
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "ui.wait_for",
+          "intent": "Confirm the requested application state is visible.",
+          "test_id": "example-control",
+          "visible": true,
+          "next": "done"
+        }
+      ]
+    },
+    "ui.screenshot": {
+      "description": "Capture the assigned native simulator or device into the artifact package.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "path": {
+            "type": "string"
+          },
+          "label": {
+            "type": "string"
+          },
+          "claims": {
+            "type": "object",
+            "properties": {
+              "must_show": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "must_not_show": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            },
+            "additionalProperties": false
+          },
+          "covers": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "note": {
+            "type": "string"
+          }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "ui.screenshot",
+          "intent": "Preserve the visible application state as review evidence.",
+          "label": "example-state",
+          "next": "done"
+        }
+      ]
+    },
+    "ui.capture_surface": {
+      "description": "Capture the full current scrollable screen as one PNG. This action is opt-in; ui.screenshot remains viewport-only.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "path": { "type": "string" },
+          "label": { "type": "string" },
+          "surface_test_id": { "type": "string" },
+          "until_test_id": { "type": "string" },
+          "max_scrolls": { "type": "integer" },
+          "restore_position": { "type": "boolean" }
+        },
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "ui.capture_surface",
+          "intent": "Preserve the complete scrollable context for human review.",
+          "path": "screenshots/full-screen.png",
+          "surface_test_id": "screen-scroll-surface",
+          "until_test_id": "screen-bottom",
+          "next": "done"
+        }
+      ]
+    },
+    "assert_output": {
+      "description": "assert_output action.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "source": {
+            "type": "string"
+          },
+          "stream": {
+            "type": "string"
+          },
+          "contains": {
+            "type": "string"
+          },
+          "match": {
+            "type": "string"
+          },
+          "assert": {
+            "type": "object",
+            "additionalProperties": true
+          }
+        },
+        "required": ["source"],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "assert_output",
+          "intent": "Confirm the recorded output satisfies the requested condition.",
+          "source": "command",
+          "contains": "ready",
+          "next": "done"
+        }
+      ]
+    },
+    "wait": {
+      "description": "Pause briefly for asynchronous setup work. Keep waits short and prefer deterministic assertions.",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "duration_ms": {
+            "type": "integer"
+          }
+        },
+        "required": ["duration_ms"],
+        "additionalProperties": false
+      },
+      "examples": [
+        {
+          "action": "wait",
+          "intent": "Allow the requested asynchronous state to settle.",
+          "duration_ms": 1,
+          "next": "done"
+        }
+      ]
+    }
+  },
+  "observers": [
+    {
+      "ref": "ui.screen",
+      "default_for": [
+        "ui.press",
+        "ui.set_input",
+        "ui.scroll",
+        "ui.swipe",
+        "ui.pan",
+        "ui.drag",
+        "ui.long_press",
+        "ui.wait_for"
+      ]
+    },
+    {
+      "ref": "ui.visible",
+      "default_for": [
+        "ui.press",
+        "ui.set_input",
+        "ui.scroll",
+        "ui.swipe",
+        "ui.pan",
+        "ui.drag",
+        "ui.long_press",
+        "ui.wait_for"
+      ]
+    }
+  ]
+}

package/templates/scripts/agentic/recipe/recipes/expo.config.recipe.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
+  "title": "Expo configuration smoke",
+  "description": "Verifies the Expo project can run a Farmslot Recipe Protocol v1 artifact-producing configuration check.",
+  "proofTargets": [
+    {
+      "id": "expo-config",
+      "claim": "The Expo project can execute a Farmslot recipe runner and expose public config without secrets."
+    }
+  ],
+  "workflow": {
+    "entry": "expo-config",
+    "nodes": {
+      "expo-config": {
+        "action": "command",
+        "intent": "Read Expo public config through the project package manager",
+        "cmd": "yarn expo config --type public --json",
+        "timeout_ms": 120000,
+        "next": "assert-config",
+        "proves": ["expo-config"]
+      },
+      "assert-config": {
+        "action": "assert_output",
+        "intent": "Confirm the Expo public config contains a slug field",
+        "source": "expo-config",
+        "stream": "stdout",
+        "contains": "\"slug\"",
+        "next": "done",
+        "proves": ["expo-config"]
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
+      }
+    }
+  }
+}

package/templates/scripts/agentic/validate-recipe.sh

@@ -0,0 +1,64 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+APP_DIR="$(cd "${SCRIPT_DIR}/../.." && pwd)"
+
+RECIPE_PATH="scripts/agentic/recipe/recipes/expo.config.recipe.json"
+ARTIFACTS_DIR=""
+DRY_RUN=0
+
+value_from_equals() {
+  local option="$1"
+  local value="${option#*=}"
+  if [[ -z "${value}" ]]; then
+    echo "ERROR: ${option%%=*} requires a value." >&2
+    exit 1
+  fi
+  printf '%s' "${value}"
+}
+
+require_value() {
+  local option="$1"
+  local value="${2:-}"
+  if [[ -z "${value}" || "${value}" == --* ]]; then
+    echo "ERROR: ${option} requires a value." >&2
+    exit 1
+  fi
+  printf '%s' "${value}"
+}
+
+while [[ "$#" -gt 0 ]]; do
+  case "$1" in
+    --recipe)
+      RECIPE_PATH="$(require_value "$1" "${2:-}")"; shift 2 ;;
+    --recipe=*)
+      RECIPE_PATH="$(value_from_equals "$1")"; shift ;;
+    --artifacts-dir)
+      ARTIFACTS_DIR="$(require_value "$1" "${2:-}")"; shift 2 ;;
+    --artifacts-dir=*)
+      ARTIFACTS_DIR="$(value_from_equals "$1")"; shift ;;
+    --dry-run)
+      DRY_RUN=1; shift ;;
+    --runtime-dir|--platform|--metro-port|--simulator|--adb-serial)
+      require_value "$1" "${2:-}" >/dev/null; shift 2 ;;
+    --runtime-dir=*|--platform=*|--metro-port=*|--simulator=*|--adb-serial=*)
+      shift ;;
+    *)
+      echo "ERROR: unknown recipe validation option '$1'." >&2
+      exit 1 ;;
+  esac
+done
+
+if [[ -z "${ARTIFACTS_DIR}" ]]; then
+  echo "ERROR: --artifacts-dir is required." >&2
+  exit 1
+fi
+
+ARGS=(farmslot-adapter-rn run "${RECIPE_PATH}" --artifacts-dir "${ARTIFACTS_DIR}")
+if [[ "${DRY_RUN}" -eq 1 ]]; then
+  ARGS+=(--dry-run)
+fi
+
+cd "${APP_DIR}"
+yarn "${ARGS[@]}"