@ishlabs/cli 0.28.0 → 0.28.1

package/dist/commands/study-run.js

@@ -493,9 +493,28 @@ Examples:
                 chatMode = readChatMode(iteration.details);
                 isPair = chatMode === "participant_pair";
             }
-            if (!iterationHasContent(iteration.details, modality)) {
-                const flagHint = describeRequiredContentFlag(modality, isPair ? "participant_pair" : undefined);
+            // Native (ios/android) interactive iterations name their target via
+            // `app_artifact`, which is OPTIONAL at create time: `ish iteration create
+            // --platform ios` with no --app stores it as "chosen at run time" (no
+            // app_artifact) and the app is supplied here via --app. The web app's
+            // "Run on your device" panel generates exactly that command
+            // (`ish study run --local --platform ios --app ./Build.app …`), so a
+            // run-time --app must satisfy the content requirement even though the
+            // iteration itself carries no stored target. `iterationHasContent` only
+            // sees the persisted details, so layer the run-time flag on top here.
+            const iterationPlatform = normalizePlatform(readIterationDetails(iteration.details).platform);
+            const isNativeIteration = iterationPlatform === "ios" || iterationPlatform === "android";
+            const runtimeAppProvided = isNativeIteration && typeof opts.app === "string" && opts.app.trim().length > 0;
+            if (!iterationHasContent(iteration.details, modality) && !runtimeAppProvided) {
                 const iterAlias = tagAlias(ALIAS_PREFIX.iteration, iterationId);
+                if (isNativeIteration) {
+                    // The target is an app, not a URL — point at --app, not --url.
+                    const ext = iterationPlatform === "ios" ? ".app" : ".apk";
+                    throw new Error(`Iteration "${iterationLabel}" (${iterAlias}) is a native ${iterationPlatform} iteration with no app set. ` +
+                        `Pass \`--app <path-to-${ext}-or-bundle-id>\` on this run, ` +
+                        `or store one on the iteration via \`ish iteration update ${iterAlias} --details-json '{"app_artifact":"<bundle-id-or-path>"}'\`, then retry.`);
+                }
+                const flagHint = describeRequiredContentFlag(modality, isPair ? "participant_pair" : undefined);
                 throw new Error(`Iteration "${iterationLabel}" (${iterAlias}) has no ${isMedia ? "content" : isPair ? "people/scenarios" : isChat ? "endpoint" : "URL"} configured yet. ` +
                     `Add ${isMedia ? "content" : isPair ? "the pair-mode payload" : isChat ? "an endpoint" : "a URL"} with ` +
                     `\`ish iteration create --study ${resolvedStudy} ${flagHint}\` ` +

package/dist/lib/docs.js

@@ -4423,6 +4423,14 @@ The platform defaults to the iteration's; \`--app\` on \`study run\` overrides t
 stored target with a fresh local build. The WebDriverAgent runner cold-starts
 slowly the first time (~30-60s) and is then reused across participants.
 
+If the iteration was created **without** \`--app\` (its target is "chosen at run
+time"), supply the app on the run instead — there's nothing stored to default
+from:
+
+\`\`\`
+ish study run --local --platform ios --app ./Build.app --all --wait
+\`\`\`
+
 ## 3b. Parallel runs — \`--parallel N\` (iOS + Android)
 
 \`\`\`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ishlabs/cli",
-  "version": "0.28.0",
+  "version": "0.28.1",
   "description": "The command-line interface for ish",
   "type": "module",
   "bin": {