@ishlabs/cli 0.23.1 → 0.24.1

package/dist/commands/ask.js

@@ -168,7 +168,7 @@ Concept pages: ish docs get-page concepts/ask
         .option("--variants <file.json>", "JSON manifest of variants (alternative to --variant)")
         .option("--wants-pick", "Each participant picks a favourite variant (compatible with --wants-ratings; can be set together).")
         .option("--wants-ratings", "Each participant rates every variant 1–5 (compatible with --wants-pick; can be set together). If neither is set, participants leave a free-form comment only.")
-        .option("--questions <file.json>", `Questions JSON file: [{"question":"...","type":"text"|"slider"|"likert"|"single-choice"|"multiple-choice"|"number"}]`)
+        .option("--questions <json|@file|path>", `Questions as inline JSON, @file, or a JSON file path: [{"question":"...","type":"text"|"slider"|"likert"|"single-choice"|"multiple-choice"|"number"}]`)
         .option("--language <code>", "2-letter language code (with --new only)", "en");
     addPersonFilterFlags(askRun, {
         allFlagName: "--all-simulatable",
@@ -343,7 +343,7 @@ Examples:
         .option("--variants <file.json>", "JSON manifest of variants (alternative to --variant)")
         .option("--wants-pick", "Each participant picks a favourite variant (compatible with --wants-ratings; can be set together).")
         .option("--wants-ratings", "Each participant rates every variant 1–5 (compatible with --wants-pick; can be set together). If neither is set, participants leave a free-form comment only.")
-        .option("--questions <file.json>", `Questions JSON file: [{"question":"...","type":"text"|"slider"|"likert"|"single-choice"|"multiple-choice"|"number"}]`)
+        .option("--questions <json|@file|path>", `Questions as inline JSON, @file, or a JSON file path: [{"question":"...","type":"text"|"slider"|"likert"|"single-choice"|"multiple-choice"|"number"}]`)
         .option("--language <code>", "2-letter language code", "en");
     addPersonFilterFlags(askCreate, {
         allFlagName: "--all-simulatable",
@@ -628,7 +628,7 @@ the model's self-reported confidence in its variant choice. See
         .option("--variants <file.json>", "JSON manifest of variants")
         .option("--wants-pick", "Each participant picks a favourite variant (compatible with --wants-ratings; can be set together).")
         .option("--wants-ratings", "Each participant rates every variant 1–5 (compatible with --wants-pick; can be set together). If neither is set, participants leave a free-form comment only.")
-        .option("--questions <file.json>", `Questions JSON file: [{"question":"...","type":"text"|"slider"|"likert"|"single-choice"|"multiple-choice"|"number"}]`)
+        .option("--questions <json|@file|path>", `Questions as inline JSON, @file, or a JSON file path: [{"question":"...","type":"text"|"slider"|"likert"|"single-choice"|"multiple-choice"|"number"}]`)
         .option("--subset-round <n>", "Drill-in subset (Pattern B) — 1-indexed prior round to filter against. Pair with --subset-variant. The new round dispatches only to participants who picked --subset-variant on round N.")
         .option("--subset-variant <variant_id>", "Drill-in subset (Pattern B) — variant id (UUID) on the prior round whose pickers should inherit. Pair with --subset-round. Read from `aggregates.pick_buckets` or `variants[*].id` on the prior round.")
         .option("--wait", "Wait until the new round completes")
@@ -676,7 +676,7 @@ error_kind: "participant_subset_invalid".`)
         .argument("[id]", "Ask alias or UUID (defaults to active ask)")
         .option("--ask <id>", "Ask ID; alternative to positional argument")
         .requiredOption("--round <n|round-id>", "Round number (1-indexed) or round id/alias")
-        .requiredOption("--questions <file.json>", `Questions JSON file: [{"question":"...","type":"text"|"slider"|"likert"|"single-choice"|"multiple-choice"|"number"}]`)
+        .requiredOption("--questions <json|@file|path>", `Questions as inline JSON, @file, or a JSON file path: [{"question":"...","type":"text"|"slider"|"likert"|"single-choice"|"multiple-choice"|"number"}]`)
         .option("--redispatch-all", "Clear prior phase-1 outputs (comment, pick, ratings) and re-run the entire round from scratch (legacy behavior). Default is additive — only the new questions are answered.", false)
         .option("--wait", "Wait until the round completes (or errors)")
         .option("--timeout <s>", "Wait timeout in seconds (default 300)")

package/dist/commands/iteration.js

@@ -11,6 +11,7 @@ import { resolveId, tagAlias, ALIAS_PREFIX } from "../lib/alias-store.js";
 import { output, formatIterationList, ValidationError } from "../lib/output.js";
 import { resolveContentUrl, resolveContentUrls, resolveTextContent } from "../lib/upload.js";
 import { isMediaModality, validateIterationDetails, normalizeChatMode, validateRoleCriteria } from "../lib/modality.js";
+import { validateSegmentation, warnIfOverSegmented } from "../lib/segmentation.js";
 import { normalizeEnumValue, SCREEN_FORMATS } from "../lib/enums.js";
 /**
  * Read text inline or from a file when prefixed with `@/path/to/file`.
@@ -361,7 +362,7 @@ Concept pages: ish docs get-page concepts/iteration
         .description("Create a new iteration with run-time content/URL")
         .option("--study <id>", "Study ID (or set via `ish study use`)")
         .option("--workspace <id>", "Workspace ID; accepted for consistency (workspace is inferred from the study)")
-        .option("--name <name>", "Iteration name (auto-generated if omitted)")
+        .option("--name <name>", "Iteration name (defaults to the next position letter A/B/C… if omitted)")
         .option("--description <description>", "Iteration description")
         // Interactive
         .option("--platform <platform>", "Platform (browser, android, figma, code) — interactive only")
@@ -390,7 +391,7 @@ Concept pages: ish docs get-page concepts/iteration
         .option("--social-platform <platform>", "Social platform (instagram, tiktok, facebook, linkedin, x)")
         .option("--copy-position <pos>", "Copy position relative to media (before, after)", "after")
         // Segmentation / per-iteration evaluation config (media modalities)
-        .option("--segmentation-json <json>", "Segmentation JSON — time_based {intervals_seconds, labels?}, section_based {sections[{name,label,...}]}, or page_based {} — media modalities")
+        .option("--segmentation-json <json>", "Segmentation JSON — time_based {intervals_seconds, labels?}, section_based {sections[{name,label,...}]}, or page_based {} — media modalities. section_based sections are SEMANTIC: group related paragraphs into a few coherent sections (a long article is usually 3-6 sections, not one per paragraph; paragraph_start/end just mark where each section begins and ends).")
         .option("--content-config-json <json>", "Content config JSON — {early_termination, selected_segment_indices?} — media modalities")
         // Chat modality
         .option("--chat-mode <mode>", "Chat mode: external_chatbot (default; probe a customer chatbot) or participant_pair (two AI people talk to each other)")
@@ -671,8 +672,29 @@ Next: \`ish study run\` to dispatch simulations against this iteration.`)
                     details = buildIterationDetails(modality, resolved);
                 }
             }
+            // Segments are semantic sections, not paragraphs: reject a malformed
+            // shape (e.g. a missing label) before the network call, and nudge when
+            // it looks like one-section-per-paragraph.
+            if (details && typeof details === "object") {
+                validateSegmentation(details.segmentation);
+                warnIfOverSegmented(details.segmentation, { quiet: globals.quietExplicit });
+            }
+            // Default name = the iteration's position letter (A, B, C…), matching how
+            // `study create` names the inline iteration "A". Never an opaque
+            // "CLI <timestamp>" — iterations should read as what they are.
+            let iterationName = opts.name;
+            if (!iterationName) {
+                try {
+                    const study = await client.get(`/studies/${studyId}`);
+                    const n = Array.isArray(study.iterations) ? study.iterations.length : 0;
+                    iterationName = n < 26 ? String.fromCharCode(65 + n) : `Iteration ${n + 1}`;
+                }
+                catch {
+                    iterationName = "A";
+                }
+            }
             const body = {
-                name: opts.name || `CLI ${new Date().toISOString().slice(0, 16)}`,
+                name: iterationName,
                 ...(opts.description !== undefined && { description: opts.description }),
                 ...(details && { details }),
             };

package/dist/commands/study-run.js

@@ -14,7 +14,7 @@ import { resolveId, tagAlias, ALIAS_PREFIX } from "../lib/alias-store.js";
 import { output, formatSimulationPoll } from "../lib/output.js";
 import { fetchStudyParticipants } from "../lib/study-participants.js";
 import { streamStudyEvents } from "../lib/study-events.js";
-import { isMediaModality, isChatModality, iterationHasContent, describeRequiredContentFlag, readChatMode, readParticipantPairConfig, summarizeRoleCriteria, } from "../lib/modality.js";
+import { isMediaModality, isChatModality, iterationHasContent, describeRequiredContentFlag, readChatMode, readParticipantPairConfig, summarizeRoleCriteria, toModality, } from "../lib/modality.js";
 // NOTE: local-sim modules are loaded via dynamic import at the `--local`
 // branch below, NOT statically here. `local-sim/install.ts` deep-imports
 // `playwright-core/lib/server/registry/index`, which is not exposed by
@@ -663,7 +663,7 @@ Examples:
                                     : `CLI default — pass --max-interactions to override`;
                             log(`    Max steps:      ${stepsForMedia} (${source})`);
                             if (Number.isFinite(stepsForMedia)) {
-                                const est = estimateMediaRun({ participantCount, maxInteractions: stepsForMedia });
+                                const est = estimateMediaRun({ modality: toModality(modality), participantCount, maxInteractions: stepsForMedia });
                                 log(`    Credits (est):  ≈ ${est.upper_bound} credit(s) upper bound — ${est.breakdown}`);
                             }
                         }
@@ -1021,7 +1021,7 @@ Examples:
                 const steps = resolveMaxInteractions(opts.maxInteractions, iteration.details);
                 if (!Number.isFinite(steps))
                     return null;
-                return estimateMediaRun({ participantCount, maxInteractions: steps });
+                return estimateMediaRun({ modality: toModality(modality), participantCount, maxInteractions: steps });
             })();
             if (!opts.wait) {
                 if (globals.json) {

package/dist/commands/study-share.d.ts

@@ -0,0 +1,18 @@
+/**
+ * ish study share / ish study unshare — public, no-login share links for a
+ * study's results, so a salesperson can send a prospect a URL they open in a
+ * browser without an account.
+ *
+ * Wraps backend endpoints already shipped server-side and used by the web
+ * share viewer (`/share/study/[token]`):
+ *
+ *   POST   /share/study          — create a link  → { id, token, share_url, expires_at, created_at }
+ *   GET    /share/study/links    — list the current user's study share links
+ *   DELETE /share/study/{token}  — revoke a link by its raw token (204)
+ *
+ * The backend builds `share_url` from its own `frontend_url` setting, which is
+ * a DIFFERENT host than the CLI's app URL (getAppUrl → app.ishlabs.io). Always
+ * print the backend's `share_url` verbatim; never reconstruct it client-side.
+ */
+import type { Command } from "commander";
+export declare function attachStudyShareCommands(study: Command): void;

package/dist/commands/study-share.js

@@ -0,0 +1,117 @@
+/**
+ * ish study share / ish study unshare — public, no-login share links for a
+ * study's results, so a salesperson can send a prospect a URL they open in a
+ * browser without an account.
+ *
+ * Wraps backend endpoints already shipped server-side and used by the web
+ * share viewer (`/share/study/[token]`):
+ *
+ *   POST   /share/study          — create a link  → { id, token, share_url, expires_at, created_at }
+ *   GET    /share/study/links    — list the current user's study share links
+ *   DELETE /share/study/{token}  — revoke a link by its raw token (204)
+ *
+ * The backend builds `share_url` from its own `frontend_url` setting, which is
+ * a DIFFERENT host than the CLI's app URL (getAppUrl → app.ishlabs.io). Always
+ * print the backend's `share_url` verbatim; never reconstruct it client-side.
+ */
+import { withClient, resolveStudy, confirmDestructive } from "../lib/command-helpers.js";
+import { tagAlias, ALIAS_PREFIX } from "../lib/alias-store.js";
+import { output, printTable, ValidationError } from "../lib/output.js";
+import { c } from "../lib/colors.js";
+/** Convert a positive-integer `--expires <days>` into an ISO-8601 UTC datetime. */
+function expiresAtFromDays(raw) {
+    const days = Number(raw);
+    if (!Number.isInteger(days) || days <= 0) {
+        throw new ValidationError(`--expires must be a positive integer number of days, got "${raw}".`, []);
+    }
+    return new Date(Date.now() + days * 86_400_000).toISOString();
+}
+export function attachStudyShareCommands(study) {
+    study
+        .command("share")
+        .description("Create a public, no-login link to a study's results (summary, frames, " +
+        "journeys, segments). Anyone with the link can view it — share with prospects.")
+        .argument("[id]", "Study ID (defaults to active study)")
+        .option("--workspace <id>", "Workspace ID; accepted for consistency (workspace is inferred from the study)")
+        .option("--expires <days>", "Link expires after N days (default: never)")
+        .option("--list", "List all your study share links instead of creating one")
+        .addHelpText("after", `
+Examples:
+  $ ish study share                              # share the active study
+  $ ish study share <study-id>
+  $ ish study share <study-id> --expires 30      # auto-expire in 30 days
+  $ ish study share <study-id> --json            # { token, share_url, expires_at, ... }
+  $ ish study share --list                       # all your share links
+
+The printed share_url is a no-login public URL — anyone with it can view the
+study results. Revoke with \`ish study unshare <token>\`.`)
+        .action(async (id, opts, cmd) => {
+        await withClient(cmd, async (client, globals) => {
+            if (opts.list) {
+                const links = await client.get("/share/study/links");
+                if (globals.json) {
+                    output(links.map((l) => ({
+                        token: l.token,
+                        study: tagAlias(ALIAS_PREFIX.study, l.study_id),
+                        expires_at: l.expires_at,
+                        is_revoked: l.is_revoked,
+                    })), true, { preProjected: true });
+                    return;
+                }
+                if (links.length === 0) {
+                    console.log("No share links yet. Create one with `ish study share <study-id>`.");
+                    return;
+                }
+                printTable(["TOKEN", "STUDY", "EXPIRES", "REVOKED"], links.map((l) => [
+                    l.token,
+                    tagAlias(ALIAS_PREFIX.study, l.study_id),
+                    l.expires_at ?? "never",
+                    l.is_revoked ? "yes" : "no",
+                ]));
+                return;
+            }
+            const studyId = resolveStudy(id);
+            const body = { study_id: studyId };
+            if (opts.expires !== undefined) {
+                body.expires_at = expiresAtFromDays(opts.expires);
+            }
+            const link = await client.post("/share/study", body);
+            if (globals.json) {
+                output(link, true, { preProjected: true });
+                return;
+            }
+            // The share_url is the deliverable (a URL to paste into an email) →
+            // stdout. Everything else is context → stderr (stdout=data convention).
+            console.log(`${c.bold}${c.cyan}${link.share_url}${c.reset}`);
+            console.error(`\n  ${c.dim}token:${c.reset}   ${link.token}`);
+            console.error(`  ${c.dim}expires:${c.reset} ${link.expires_at ?? "never"}`);
+            console.error(`\n  ${c.dim}Anyone with this link can view the study results — no login required.${c.reset}`);
+            console.error(`  ${c.dim}Revoke with:${c.reset} ish study unshare ${link.token}`);
+        });
+    });
+    study
+        .command("unshare")
+        .description("Revoke a study share link by its token. The public URL stops working immediately.")
+        .argument("<token>", "Share link token (from `ish study share` or `ish study share --list`)")
+        .option("--workspace <id>", "Workspace ID; accepted for consistency")
+        .option("-y, --yes", "Skip the confirmation prompt")
+        .addHelpText("after", `
+Examples:
+  $ ish study unshare <token>
+  $ ish study unshare <token> --yes
+
+The <token> is the raw share token, not a study ID or alias. List tokens with
+\`ish study share --list\`.`)
+        .action(async (token, opts, cmd) => {
+        await withClient(cmd, async (client, globals) => {
+            await confirmDestructive(`Revoke share link ${token}? The public URL will stop working.`, { yes: opts.yes, json: globals.json });
+            await client.del(`/share/study/${encodeURIComponent(token)}`);
+            if (globals.json) {
+                output({ token, revoked: true }, true, { writePath: true });
+            }
+            else {
+                console.log(`${c.green}Share link revoked:${c.reset} ${token}`);
+            }
+        });
+    });
+}

package/dist/commands/study.js

@@ -4,6 +4,7 @@
 import { readFileSync } from "node:fs";
 import { Option } from "commander";
 import { withClient, getWebUrl, terminalLink, resolveWorkspace, confirmDestructive, readFileOrStdin, collectIds } from "../lib/command-helpers.js";
+import { validateSegmentation, warnIfOverSegmented } from "../lib/segmentation.js";
 import { resolveId, tagAlias, ALIAS_PREFIX } from "../lib/alias-store.js";
 import { loadConfig, saveConfig } from "../config.js";
 import { formatStudyList, formatStudyDetail, formatStudyResults, buildStudyResultsEnvelope, buildStudyResultsSummary, buildChatTranscript, formatStudyResultsGroupBy, output, ValidationError, } from "../lib/output.js";
@@ -20,6 +21,7 @@ import { attachStudyRunCommands } from "./study-run.js";
 import { attachStudyParticipantCommands } from "./study-participant.js";
 import { attachStudyAnalyzeCommands } from "./study-analyze.js";
 import { attachStudyScreenshotsCommands } from "./study-screenshots.js";
+import { attachStudyShareCommands } from "./study-share.js";
 function collectRepeatable(value, prev = []) {
     return prev.concat([value]);
 }
@@ -116,13 +118,19 @@ Concept pages: ish docs get-page concepts/study
         .option("--assignments-file <path>", "JSON file with assignments array")
         .option("--assignments <json>", "Inline JSON array of assignments (escape hatch)")
         .option("--question <text>", "Add a text question to the questionnaire (repeatable; type=text, timing=after)", collectRepeatable, [])
-        .option("--questionnaire <path>", "JSON file defining the questionnaire (supports text, slider, likert, single-choice, multiple-choice, number; timing=before|after)")
+        .option("--questionnaire <json|@file|path>", "Questionnaire as inline JSON array, @file, or a JSON file path — supports text, slider, likert, single-choice, multiple-choice, number; timing=before|after")
         .option("--content-text <text>", "Text content to evaluate, or @filepath to read from file. Creates iteration A inline (text modality only)")
         .option("--url <url>", "URL to test. Creates iteration A inline (interactive modality only)")
         .option("--screen-format <format>", "Screen format for interactive iterations: desktop (default) or mobile_portrait (hyphen/underscore variants accepted)")
         .option("--content-url <url>", "Public URL of the media file. Creates iteration A inline (video, audio, document modalities). For local files, use the 2-step `iteration create` flow.")
         .option("--image-urls <urls>", "Comma-separated public image URLs. Creates iteration A inline (image modality). For local files, use the 2-step `iteration create` flow.")
         .option("--title <title>", "Content title (text + media modalities — image, video, audio, document; optional). Not used for interactive / chat.")
+        .option("--segmentation-json <json>", "Segmentation JSON for the inline iteration A — time_based {intervals_seconds, labels?}, section_based {sections[{name,label,...}]}, or page_based {} (text + media). section_based sections are SEMANTIC: group related paragraphs into a few coherent sections (a long article is usually 3-6 sections, not one per paragraph). Lets one `study create` build a complete segmented iteration — no separate `iteration create` needed.")
+        .option("--content-config-json <json>", "Content-config JSON for the inline iteration A (early_termination, selected_segment_indices) — text + media.")
+        .option("--content-html <html>", "HTML version of the text, or @filepath — text modality (email rendering)")
+        .option("--sender-name <name>", "Email 'From' display name — text modality (email rendering)")
+        .option("--sender-email <email>", "Email sender address — text modality (email rendering)")
+        .option("--featured-image-url <url>", "Hero image URL — text modality (email rendering)")
         .option("--endpoint <id>", "Saved chatbot endpoint id or alias. Creates iteration A inline (chat modality, external_chatbot mode)")
         .option("--endpoint-config <file>", "ChatbotEndpointConfig JSON file (or `-` for stdin); embedded directly. Mutually exclusive with --endpoint (chat modality, external_chatbot mode)")
         .option("--max-turns <n>", "Maximum conversation turns per participant (chat modality only; default 12)", (v) => Number(v))
@@ -138,9 +146,11 @@ Concept pages: ish docs get-page concepts/study
 Note: --workspace is optional if set via \`ish workspace use <alias>\`.
 
 The questionnaire is the set of questions participants answer. Use \`--question\` to
-quickly add simple text questions, or \`--questionnaire <file.json>\` for richer
-types (slider, likert, single-choice, multiple-choice, number) and custom
-timing. The two forms are mutually exclusive — pick one.
+quickly add simple text questions, or \`--questionnaire\` for richer types (slider,
+likert, single-choice, multiple-choice, number) and custom timing. \`--questionnaire\`
+accepts inline JSON ('[{"question":"How easy?","type":"slider","min":0,"max":10}]'),
+an @file (@/tmp/q.json), or a JSON file path (./questionnaire.json) — no temp file
+required. The two forms are mutually exclusive — pick one.
 
 Inline iteration shortcuts (one-shot study + iteration A):
   --modality interactive  --url <url> [--screen-format desktop|mobile_portrait]
@@ -311,6 +321,37 @@ Next: configure a run with \`ish iteration create --study <id>\`,
                 && opts.imageUrls === undefined) {
                 throw new Error("--title only applies with --content-text (text) or --content-url / --image-urls (media). Interactive + chat iterations don't carry a title.");
             }
+            // Inline iteration A can carry segmentation + content-config (text + media)
+            // and email-styling (text), so a single `study create` builds one COMPLETE
+            // iteration — no separate `iteration create` (which would leave an empty A
+            // plus a redundant B). Parse the JSON flags once, here.
+            const parseInlineJson = (raw, flag) => {
+                if (raw === undefined)
+                    return undefined;
+                try {
+                    return JSON.parse(raw);
+                }
+                catch {
+                    throw new ValidationError(`Invalid ${flag}: expected valid JSON.`, []);
+                }
+            };
+            const inlineMediaExtras = {
+                ...(parseInlineJson(opts.segmentationJson, "--segmentation-json") && { segmentation: parseInlineJson(opts.segmentationJson, "--segmentation-json") }),
+                ...(parseInlineJson(opts.contentConfigJson, "--content-config-json") && { content_config: parseInlineJson(opts.contentConfigJson, "--content-config-json") }),
+            };
+            // Segments are semantic sections, not paragraphs: reject a malformed
+            // shape (e.g. a missing label) before the network call, and nudge when
+            // it looks like one-section-per-paragraph.
+            if (inlineMediaExtras.segmentation !== undefined) {
+                validateSegmentation(inlineMediaExtras.segmentation);
+                warnIfOverSegmented(inlineMediaExtras.segmentation, { quiet: globals.quietExplicit });
+            }
+            const inlineEmailExtras = {
+                ...(opts.contentHtml && { content_html: opts.contentHtml.startsWith("@") ? readFileSync(opts.contentHtml.slice(1), "utf8") : opts.contentHtml }),
+                ...(opts.senderName && { sender_name: opts.senderName }),
+                ...(opts.senderEmail && { sender_email: opts.senderEmail }),
+                ...(opts.featuredImageUrl && { featured_image_url: opts.featuredImageUrl }),
+            };
             let inlineIteration;
             let chatbotEndpointId = null;
             if (opts.contentText !== undefined) {
@@ -326,6 +367,8 @@ Next: configure a run with \`ish iteration create --study <id>\`,
                         type: "text",
                         content_text: text,
                         ...(opts.title && { title: opts.title }),
+                        ...inlineEmailExtras,
+                        ...inlineMediaExtras,
                     },
                 };
             }
@@ -361,6 +404,7 @@ Next: configure a run with \`ish iteration create --study <id>\`,
                         type: "image",
                         image_urls: urls,
                         ...(opts.title && { title: opts.title }),
+                        ...inlineMediaExtras,
                     },
                 };
             }
@@ -381,6 +425,7 @@ Next: configure a run with \`ish iteration create --study <id>\`,
                         type: opts.modality,
                         content_url: opts.contentUrl,
                         ...(opts.title && { title: opts.title }),
+                        ...inlineMediaExtras,
                     },
                 };
             }
@@ -1097,11 +1142,12 @@ When no runs have completed, the default envelope is returned with zero counts a
         .option("--assignments-file <path>", "JSON file with assignments array")
         .option("--assignments <json>", "Inline JSON array of assignments (escape hatch)")
         .option("--question <text>", "Replace the questionnaire with these text questions (repeatable)", collectRepeatable, [])
-        .option("--questionnaire <path>", "Replace the questionnaire from a JSON file (full InterviewQuestion shape)")
+        .option("--questionnaire <json|@file|path>", "Replace the questionnaire from inline JSON, @file, or a JSON file path (full InterviewQuestion shape)")
         .addHelpText("after", `
 Replacing the questionnaire: pass either \`--question\` (one or more text
-questions) or \`--questionnaire <file.json>\` (full shape: slider, likert,
-choice, custom timing). The two are mutually exclusive.
+questions) or \`--questionnaire\` (full shape: slider, likert, choice, custom
+timing) as inline JSON, an @file, or a JSON file path. The two are mutually
+exclusive.
 
 Examples:
   $ ish study update <id> --name "Updated Name"
@@ -1207,4 +1253,5 @@ checklists ("steps") ride along when present in the JSON forms
     attachStudyParticipantCommands(study);
     attachStudyAnalyzeCommands(study);
     attachStudyScreenshotsCommands(study);
+    attachStudyShareCommands(study);
 }

package/dist/commands/workspace.js

@@ -111,7 +111,8 @@ existing workspace was returned. On creation, \`reused: false\`.`)
         .option("--name <name>", "Workspace name")
         .option("--description <description>", "Workspace description")
         .option("--base-url <url>", "Default base URL")
-        .addHelpText("after", "\nExamples:\n  $ ish workspace update <id> --name \"New Name\"\n  $ ish workspace update <id> --base-url https://example.com --json")
+        .option("--logo <url>", "Brand logo image URL (shown on the workspace and on shared study links)")
+        .addHelpText("after", "\nExamples:\n  $ ish workspace update <id> --name \"New Name\"\n  $ ish workspace update <id> --base-url https://example.com --json\n  $ ish workspace update <id> --logo https://logo.clearbit.com/acme.com")
         .action(async (id, opts, cmd) => {
         await withClient(cmd, async (client, globals) => {
             const body = {};
@@ -121,6 +122,8 @@ existing workspace was returned. On creation, \`reused: false\`.`)
                 body.description = opts.description;
             if (opts.baseUrl !== undefined)
                 body.base_url = opts.baseUrl;
+            if (opts.logo !== undefined)
+                body.logo_url = opts.logo;
             if (Object.keys(body).length === 0) {
                 console.error("No update flags provided. Run `ish workspace update --help` for options.");
                 return;

package/dist/connect.d.ts

@@ -1,10 +1,12 @@
 /**
  * Localhost connect CLI — wraps cloudflared and registers with Ish backend.
  */
+import { type Route } from "./lib/reverse-proxy.js";
+export type { Route } from "./lib/reverse-proxy.js";
 export declare function runTunnel(port: number, tokenArg?: string, apiUrlArg?: string, tokenFileArg?: string, outputOpts?: {
     json?: boolean;
     quiet?: boolean;
-}): Promise<void>;
-export declare function runDetached(port: number, apiUrlArg: string | undefined, tokenArg: string | undefined, tokenFileArg: string | undefined): Promise<void>;
+}, routes?: Route[]): Promise<void>;
+export declare function runDetached(port: number, apiUrlArg: string | undefined, tokenArg: string | undefined, tokenFileArg: string | undefined, routes?: Route[]): Promise<void>;
 export declare function connectStatus(json: boolean): void;
 export declare function disconnect(json: boolean): Promise<void>;