@ishlabs/cli 0.17.7 → 0.19.0

package/dist/lib/alias-store.d.ts

@@ -1,7 +1,7 @@
 /**
  * Short alias system for entity IDs.
  *
- * Generates deterministic aliases from UUID prefixes (e.g. w-6ec, s-b2c, tp-d4e).
+ * Generates deterministic aliases from UUID prefixes (e.g. w-6ec, s-b2c, p-d4e, pt-a3f).
  * Same UUID always produces the same alias — stable across commands and terminals.
  * Aliases are persisted to ~/.ish/aliases.json for resolution.
  */
@@ -10,9 +10,9 @@ export declare const ALIAS_PREFIX: {
     readonly workspace: "w";
     readonly study: "s";
     readonly iteration: "i";
-    readonly testerProfile: "tp";
-    readonly testerProfileSource: "tps";
-    readonly tester: "t";
+    readonly person: "p";
+    readonly personSource: "ps";
+    readonly participant: "pt";
     readonly config: "c";
     readonly job: "j";
     readonly ask: "a";
@@ -46,7 +46,7 @@ export declare function deterministicAlias(prefix: string, uuid: string): string
  * Resolve a short alias to a full UUID, or validate and pass through a full UUID.
  *
  * Accepted formats:
- *   - Short alias: w-6ec, s-b2c, tp-d4e (resolved from ~/.ish/aliases.json)
+ *   - Short alias: w-6ec, s-b2c, p-d4e (resolved from ~/.ish/aliases.json)
  *   - Full UUID:   6ecf2857-1d7a-4f9c-85da-c2ac6c5c5346
  *
  * Everything else throws with guidance toward the correct usage.

package/dist/lib/alias-store.js

@@ -1,7 +1,7 @@
 /**
  * Short alias system for entity IDs.
  *
- * Generates deterministic aliases from UUID prefixes (e.g. w-6ec, s-b2c, tp-d4e).
+ * Generates deterministic aliases from UUID prefixes (e.g. w-6ec, s-b2c, p-d4e, pt-a3f).
  * Same UUID always produces the same alias — stable across commands and terminals.
  * Aliases are persisted to ~/.ish/aliases.json for resolution.
  */
@@ -13,9 +13,9 @@ export const ALIAS_PREFIX = {
     workspace: "w",
     study: "s",
     iteration: "i",
-    testerProfile: "tp",
-    testerProfileSource: "tps",
-    tester: "t",
+    person: "p",
+    personSource: "ps",
+    participant: "pt",
     config: "c",
     job: "j",
     ask: "a",
@@ -121,9 +121,9 @@ const HYDRATE_HINT = {
     w: "ish workspace list",
     s: "ish study list",
     i: "ish iteration list --study <study-id>",
-    tp: "ish profile list",
-    tps: "ish source list",
-    t: "ish tester get <tester-id>",
+    p: "ish person list",
+    ps: "ish source list",
+    pt: "ish participant get <participant-id>",
     c: "ish config list",
     a: "ish ask list",
     r: "ish ask get <ask-id>",
@@ -142,7 +142,7 @@ function hintForPrefix(alias) {
  * Resolve a short alias to a full UUID, or validate and pass through a full UUID.
  *
  * Accepted formats:
- *   - Short alias: w-6ec, s-b2c, tp-d4e (resolved from ~/.ish/aliases.json)
+ *   - Short alias: w-6ec, s-b2c, p-d4e (resolved from ~/.ish/aliases.json)
  *   - Full UUID:   6ecf2857-1d7a-4f9c-85da-c2ac6c5c5346
  *
  * Everything else throws with guidance toward the correct usage.

package/dist/lib/api-client.d.ts

@@ -34,7 +34,7 @@ export declare class ApiClient {
     patch<T = unknown>(path: string, body?: unknown, opts?: RequestOpts): Promise<T>;
     del(path: string, opts?: RequestOpts): Promise<void>;
     localSimInit(body: {
-        tester_id: string;
+        participant_id: string;
         study_id: string;
         product_id: string;
         iteration_id: string;

package/dist/lib/api-client.js

@@ -218,7 +218,7 @@ export class ApiClient {
         return this.handleResponse(res);
     }
     async del(path, opts) {
-        // Deletes typically cascade (rounds → responses → testers → audience),
+        // Deletes typically cascade (rounds → responses → participants → people),
         // so default to a longer timeout than the standard 15s.
         const timeout = opts?.timeout ?? 60_000;
         const url = `${this.baseUrl}${path}`;

package/dist/lib/billing.d.ts

@@ -7,9 +7,9 @@
  * this file in the same commit, otherwise the CLI will mislead agents.
  *
  * Today every modality uses the same shape: `max(1, round(steps / 10))`
- * per principal (per tester for media/interactive, per conversation for
- * chat, ×2 for tester-pair). Asks bill flat 1 credit per successful
- * tester response. These are intentionally per-run estimates; long-term
+ * per principal (per participant for media/interactive, per conversation for
+ * chat, ×2 for participant-pair). Asks bill flat 1 credit per successful
+ * participant response. These are intentionally per-run estimates; long-term
  * we'll fetch `GET /billing/rates` and parameterise modalities — see
  * `reference/credits` docs page.
  */
@@ -17,7 +17,7 @@ export interface CreditEstimate {
     /** Upper bound (no early termination). Never claims exactness. */
     upper_bound: number;
     /** Stable identifier so agents can branch on shape if the formula evolves. */
-    formula: "media_per_tester" | "chat_solo" | "chat_pair" | "ask_per_response";
+    formula: "media_per_participant" | "chat_solo" | "chat_pair" | "ask_per_response";
     /** Human-readable breakdown so agents can explain the number to users. */
     breakdown: string;
     /** Always "credits" today; reserved for future-proofing (e.g. millicredits). */
@@ -28,28 +28,28 @@ export declare function mediaCreditCost(steps: number): number;
 /** Mirror of `app/chat/billing.py::chat_credit_cost`. */
 export declare function chatCreditCost(turns: number): number;
 /**
- * Media/interactive run: 1 credit-cost-per-tester × tester count. Modality
+ * Media/interactive run: 1 credit-cost-per-participant × participant count. Modality
  * doesn't currently affect the rate (interactive == text == video at the
  * billing layer) — kept as a parameter for forward compatibility.
  */
 export declare function estimateMediaRun(args: {
-    testerCount: number;
+    participantCount: number;
     maxInteractions: number;
 }): CreditEstimate;
-/** Solo chat (single tester, external chatbot). */
+/** Solo chat (single participant, external chatbot). */
 export declare function estimateChatSolo(args: {
-    testerCount: number;
+    participantCount: number;
     maxTurns: number;
 }): CreditEstimate;
-/** Tester-pair chat: each turn bills both sides, so cost doubles. */
+/** Participant-pair chat: each turn bills both sides, so cost doubles. */
 export declare function estimateChatPair(args: {
     conversationCount: number;
     maxTurns: number;
 }): CreditEstimate;
 /**
- * Ask round: flat 1 credit per successful tester response (charged only
+ * Ask round: flat 1 credit per successful participant response (charged only
  * for completed responses; the upper bound assumes everyone completes).
  */
 export declare function estimateAskRound(args: {
-    testerCount: number;
+    participantCount: number;
 }): CreditEstimate;

package/dist/lib/billing.js

@@ -7,9 +7,9 @@
  * this file in the same commit, otherwise the CLI will mislead agents.
  *
  * Today every modality uses the same shape: `max(1, round(steps / 10))`
- * per principal (per tester for media/interactive, per conversation for
- * chat, ×2 for tester-pair). Asks bill flat 1 credit per successful
- * tester response. These are intentionally per-run estimates; long-term
+ * per principal (per participant for media/interactive, per conversation for
+ * chat, ×2 for participant-pair). Asks bill flat 1 credit per successful
+ * participant response. These are intentionally per-run estimates; long-term
  * we'll fetch `GET /billing/rates` and parameterise modalities — see
  * `reference/credits` docs page.
  */
@@ -26,32 +26,32 @@ export function chatCreditCost(turns) {
     return Math.max(1, Math.round(turns / 10));
 }
 /**
- * Media/interactive run: 1 credit-cost-per-tester × tester count. Modality
+ * Media/interactive run: 1 credit-cost-per-participant × participant count. Modality
  * doesn't currently affect the rate (interactive == text == video at the
  * billing layer) — kept as a parameter for forward compatibility.
  */
 export function estimateMediaRun(args) {
-    const perTester = mediaCreditCost(args.maxInteractions);
-    const total = Math.max(0, args.testerCount) * perTester;
+    const perParticipant = mediaCreditCost(args.maxInteractions);
+    const total = Math.max(0, args.participantCount) * perParticipant;
     return {
         upper_bound: total,
-        formula: "media_per_tester",
-        breakdown: `${args.testerCount} tester(s) × max(1, round(${args.maxInteractions} steps / 10)) = ${args.testerCount} × ${perTester} = ${total}`,
+        formula: "media_per_participant",
+        breakdown: `${args.participantCount} participant(s) × max(1, round(${args.maxInteractions} steps / 10)) = ${args.participantCount} × ${perParticipant} = ${total}`,
         unit: "credits",
     };
 }
-/** Solo chat (single tester, external chatbot). */
+/** Solo chat (single participant, external chatbot). */
 export function estimateChatSolo(args) {
-    const perTester = chatCreditCost(args.maxTurns);
-    const total = Math.max(0, args.testerCount) * perTester;
+    const perParticipant = chatCreditCost(args.maxTurns);
+    const total = Math.max(0, args.participantCount) * perParticipant;
     return {
         upper_bound: total,
         formula: "chat_solo",
-        breakdown: `${args.testerCount} tester(s) × max(1, round(${args.maxTurns} turns / 10)) = ${args.testerCount} × ${perTester} = ${total}`,
+        breakdown: `${args.participantCount} participant(s) × max(1, round(${args.maxTurns} turns / 10)) = ${args.participantCount} × ${perParticipant} = ${total}`,
         unit: "credits",
     };
 }
-/** Tester-pair chat: each turn bills both sides, so cost doubles. */
+/** Participant-pair chat: each turn bills both sides, so cost doubles. */
 export function estimateChatPair(args) {
     const perSide = chatCreditCost(args.maxTurns);
     const total = Math.max(0, args.conversationCount) * perSide * 2;
@@ -63,15 +63,15 @@ export function estimateChatPair(args) {
     };
 }
 /**
- * Ask round: flat 1 credit per successful tester response (charged only
+ * Ask round: flat 1 credit per successful participant response (charged only
  * for completed responses; the upper bound assumes everyone completes).
  */
 export function estimateAskRound(args) {
-    const total = Math.max(0, args.testerCount);
+    const total = Math.max(0, args.participantCount);
     return {
         upper_bound: total,
         formula: "ask_per_response",
-        breakdown: `${args.testerCount} tester(s) × 1 credit/response = ${total} (upper bound; only successful responses bill)`,
+        breakdown: `${args.participantCount} participant(s) × 1 credit/response = ${total} (upper bound; only successful responses bill)`,
         unit: "credits",
     };
 }

package/dist/lib/chat-endpoint-templates.js

@@ -167,7 +167,7 @@ const BOTFRAMEWORK = {
             },
             bodyTemplate: {
                 type: "message",
-                from: { id: "{{tester.name}}" },
+                from: { id: "{{participant.name}}" },
                 text: "{{action.text}}",
             },
             mode: "stateful",

package/dist/lib/command-helpers.d.ts

@@ -4,8 +4,8 @@
  */
 import type { Command } from "commander";
 import { ApiClient } from "./api-client.js";
-export interface AudienceFilterOpts {
-    profile?: string[];
+export interface PersonFilterOpts {
+    person?: string[];
     sample?: string;
     all?: boolean;
     search?: string;
@@ -17,36 +17,36 @@ export interface AudienceFilterOpts {
     maxAge?: string;
     visibility?: string;
 }
-export interface AudienceResolveOpts {
+export interface PersonResolveOpts {
     requireSimulatable?: boolean;
     allFlagName?: string;
-    /** Profile IDs to exclude from the fetched pool (e.g. testers already on an ask). */
+    /** Profile IDs to exclude from the fetched pool (e.g. participants already on an ask). */
     excludeProfileIds?: Set<string>;
 }
-/** True when any audience-selection flag is set on the command. */
-export declare function hasAudienceFlags(flags: AudienceFilterOpts): boolean;
+/** True when any person-selection flag is set on the command. */
+export declare function hasPersonFlags(flags: PersonFilterOpts): boolean;
 /**
- * Resolve a tester-profile audience from CLI flags.
+ * Resolve person IDs from CLI flags.
  *
  * Modes (mutually exclusive):
- *   - explicit: `--profile <id>` (repeatable) — returns those IDs verbatim.
+ *   - explicit: `--person <id>` (repeatable) — returns those IDs verbatim.
  *   - sample:   `--sample N` + optional filter flags — fetches the matching
  *               pool, randomly samples N.
  *   - all:      caller's "all" flag + optional filter flags — returns every
- *               matching profile.
+ *               matching person.
  *   - filtered: filter flags only — treated as "all matching".
  *
  * Always sends `type=ai` to the backend (simulations are AI-driven).
- * If `requireSimulatable`, applies a client-side filter for profiles that
+ * If `requireSimulatable`, applies a client-side filter for people that
  * have a simulation config attached.
  */
-export declare function resolveAudienceProfileIds(client: ApiClient, workspace: string, flags: AudienceFilterOpts, opts?: AudienceResolveOpts): Promise<string[]>;
+export declare function resolvePersonIds(client: ApiClient, workspace: string, flags: PersonFilterOpts, opts?: PersonResolveOpts): Promise<string[]>;
 /**
- * Attach the audience-selection flag set to a Commander command.
+ * Attach the person-selection flag set to a Commander command.
  * Pass `allFlagName: "--all-simulatable"` for ask commands to keep the
  * established flag name; defaults to `--all` for study run.
  */
-export declare function addAudienceFilterFlags(cmd: Command, opts?: {
+export declare function addPersonFilterFlags(cmd: Command, opts?: {
     allFlagName?: string;
     allFlagDescription?: string;
 }): Command;
@@ -82,7 +82,7 @@ export interface GlobalOpts {
      * True only when the user explicitly passed `--quiet` / `-q` (or `--get`).
      * Distinct from `quiet`, which also flips on for auto-quiet (the
      * piped-stdout/auto-JSON path). Use this for actionable hints (e.g. the
-     * `profile list` pagination hint) that should still surface when an agent
+     * `person list` pagination hint) that should still surface when an agent
      * pipes output but hasn't asked for silence — auto-quiet is for progress
      * chatter, not diagnostic signals.
      */
@@ -141,8 +141,8 @@ export declare function resolveChatConfig(positional?: string, flag?: string): s
 export declare function collectRepeatable(value: string, prev?: string[]): string[];
 /**
  * Commander collector for ID-list flags. Accepts a comma-separated value
- * (`--profile a,b,c`) and also concatenates across repeated flags
- * (`--profile a --profile b`). Trims whitespace and drops empty entries.
+ * (`--person a,b,c`) and also concatenates across repeated flags
+ * (`--person a --person b`). Trims whitespace and drops empty entries.
  *
  * Use this for flags whose values are IDs/aliases — never for free-form
  * strings that may legitimately contain commas (those should use
@@ -157,11 +157,11 @@ export declare function parseWaitTimeout(raw: string | undefined, defaultMs?: nu
  * calls have populated the program tree. Agents reflexively pass `--workspace`
  * on any command — without this, Commander rejects it with a generic "unknown
  * option" on read-side commands like `ask delete`, `ask get`, `study get`,
- * `profile get`, etc.
+ * `person get`, etc.
  *
  * The injected option is documentation-only on commands where the workspace is
  * inferred from an ID alias; it's accepted and then discarded by the action
- * body. Resolvers (`resolveWorkspace`, `resolveAudienceProfileIds`) ignore
+ * body. Resolvers (`resolveWorkspace`, `resolvePersonIds`) ignore
  * unused values.
  */
 /**

package/dist/lib/command-helpers.js

@@ -21,6 +21,18 @@ function shuffleInPlace(arr) {
     }
     return arr;
 }
+// Wire-vocabulary aliases for `--visibility`: old → new. The backend still
+// accepts the old values but logs a deprecation warning, so we map them
+// client-side before they hit the wire. Canonical values pass through.
+const VISIBILITY_ALIASES = {
+    private: "workspace",
+    public: "platform",
+};
+function normalizeVisibility(raw) {
+    if (raw === undefined)
+        return undefined;
+    return VISIBILITY_ALIASES[raw] ?? raw;
+}
 function parseSampleSize(raw) {
     if (raw === undefined)
         return undefined;
@@ -47,11 +59,11 @@ function describeFilters(flags) {
     if (flags.maxAge)
         parts.push(`--max-age ${flags.maxAge}`);
     if (flags.visibility)
-        parts.push(`--visibility ${flags.visibility}`);
+        parts.push(`--visibility ${normalizeVisibility(flags.visibility)}`);
     return parts.join(" ");
 }
 /**
- * Best-effort: surface the top-3 populated countries so an empty-audience
+ * Best-effort: surface the top-3 populated countries so an empty-result
  * error doesn't strand the agent without a pivot. Two tiers — tier 1 keeps
  * non-country filters and drops `--country` (used when `--country` was the
  * binding constraint); tier 2 fires when tier 1 returns empty (or when
@@ -91,9 +103,9 @@ async function suggestCountries(client, workspace, flags, opts) {
                 if (flags.maxAge)
                     broader.max_age = flags.maxAge;
                 if (flags.visibility)
-                    broader.visibility = flags.visibility;
+                    broader.visibility = normalizeVisibility(flags.visibility);
             }
-            const data = await client.get("/tester-profiles", broader);
+            const data = await client.get("/people", broader);
             const items = Array.isArray(data)
                 ? data
                 : Array.isArray(data?.items)
@@ -135,36 +147,36 @@ function hasFilterFlag(flags) {
         || flags.maxAge
         || flags.visibility);
 }
-/** True when any audience-selection flag is set on the command. */
-export function hasAudienceFlags(flags) {
-    return Boolean((flags.profile && flags.profile.length > 0)
+/** True when any person-selection flag is set on the command. */
+export function hasPersonFlags(flags) {
+    return Boolean((flags.person && flags.person.length > 0)
         || flags.sample !== undefined
         || flags.all
         || hasFilterFlag(flags));
 }
 /**
- * Resolve a tester-profile audience from CLI flags.
+ * Resolve person IDs from CLI flags.
  *
  * Modes (mutually exclusive):
- *   - explicit: `--profile <id>` (repeatable) — returns those IDs verbatim.
+ *   - explicit: `--person <id>` (repeatable) — returns those IDs verbatim.
  *   - sample:   `--sample N` + optional filter flags — fetches the matching
  *               pool, randomly samples N.
  *   - all:      caller's "all" flag + optional filter flags — returns every
- *               matching profile.
+ *               matching person.
  *   - filtered: filter flags only — treated as "all matching".
  *
  * Always sends `type=ai` to the backend (simulations are AI-driven).
- * If `requireSimulatable`, applies a client-side filter for profiles that
+ * If `requireSimulatable`, applies a client-side filter for people that
  * have a simulation config attached.
  */
-export async function resolveAudienceProfileIds(client, workspace, flags, opts = {}) {
+export async function resolvePersonIds(client, workspace, flags, opts = {}) {
     const allFlagName = opts.allFlagName ?? "--all";
-    const explicit = (flags.profile ?? []).map(resolveId);
+    const explicit = (flags.person ?? []).map(resolveId);
     const sampleN = parseSampleSize(flags.sample);
     const filtersUsed = hasFilterFlag(flags);
     if (explicit.length > 0) {
         if (sampleN !== undefined || flags.all || filtersUsed) {
-            throw new Error(`Use either explicit --profile flags or --sample/${allFlagName}/filter flags (--bio, --country, --gender, --min-age, --max-age, --occupation, --search, --visibility), not both.`);
+            throw new Error(`Use either explicit --person flags or --sample/${allFlagName}/filter flags (--bio, --country, --gender, --min-age, --max-age, --occupation, --search, --visibility), not both.`);
         }
         return explicit;
     }
@@ -172,7 +184,7 @@ export async function resolveAudienceProfileIds(client, workspace, flags, opts =
         throw new Error(`Use either --sample <N> or ${allFlagName}, not both. --sample picks a random subset; ${allFlagName} returns every match.`);
     }
     if (sampleN === undefined && !flags.all && !filtersUsed) {
-        throw new Error(`Pick an audience: pass --profile <id> (repeatable), --sample <N>, ${allFlagName}, or filter flags (--bio, --country, --gender, --min-age, --max-age, --occupation, --search, --visibility).`);
+        throw new Error(`Select people: pass --person <id> (repeatable), --sample <N>, ${allFlagName}, or filter flags (--bio, --country, --gender, --min-age, --max-age, --occupation, --search, --visibility).`);
     }
     const params = {
         product_id: workspace,
@@ -195,8 +207,8 @@ export async function resolveAudienceProfileIds(client, workspace, flags, opts =
     if (flags.maxAge)
         params.max_age = flags.maxAge;
     if (flags.visibility)
-        params.visibility = flags.visibility;
-    const data = await client.get("/tester-profiles", params);
+        params.visibility = normalizeVisibility(flags.visibility);
+    const data = await client.get("/people", params);
     const items = Array.isArray(data)
         ? data
         : Array.isArray(data?.items)
@@ -213,10 +225,10 @@ export async function resolveAudienceProfileIds(client, workspace, flags, opts =
         const filterDesc = describeFilters(flags);
         const sim = opts.requireSimulatable ? "simulatable AI " : "AI ";
         if (opts.excludeProfileIds && opts.excludeProfileIds.size > 0 && !filterDesc) {
-            throw new Error("All matching profiles are already in this audience.");
+            throw new Error("All matching people are already included.");
         }
         // Country suggestion: surface the top populated countries so the agent
-        // doesn't have to round-trip through `ish profile list` to find one that
+        // doesn't have to round-trip through `ish person list` to find one that
         // matches. Two tiers — tier 1 drops `--country` only and retains other
         // filters when `--country` was set (so the hint reflects "of countries
         // that match your other filters, here are the populated ones"). Tier 2
@@ -228,15 +240,15 @@ export async function resolveAudienceProfileIds(client, workspace, flags, opts =
             requireSimulatable: !!opts.requireSimulatable,
         });
         if (filterDesc) {
-            throw new Error(`No ${sim}tester profiles in workspace ${workspace} match: ${filterDesc}.${suggestion} Broaden your filters or run \`ish profile list\` to inspect the pool.`);
+            throw new Error(`No ${sim}people in workspace ${workspace} match: ${filterDesc}.${suggestion} Broaden your filters or run \`ish person list\` to inspect the pool.`);
         }
-        throw new Error(`No ${sim}tester profiles found in workspace ${workspace}.${opts.requireSimulatable ? " Create profiles with simulation configs first." : ""}`);
+        throw new Error(`No ${sim}people found in workspace ${workspace}.${opts.requireSimulatable ? " Create people with simulation configs first." : ""}`);
     }
     if (flags.all)
         return pool.map((p) => p.id);
     if (sampleN !== undefined) {
         if (sampleN > pool.length) {
-            throw new Error(`--sample ${sampleN} requested but only ${pool.length} matching profile${pool.length === 1 ? "" : "s"} available.`);
+            throw new Error(`--sample ${sampleN} requested but only ${pool.length} matching person${pool.length === 1 ? "" : "s"} available.`);
         }
         return shuffleInPlace([...pool]).slice(0, sampleN).map((p) => p.id);
     }
@@ -244,25 +256,25 @@ export async function resolveAudienceProfileIds(client, workspace, flags, opts =
     return pool.map((p) => p.id);
 }
 /**
- * Attach the audience-selection flag set to a Commander command.
+ * Attach the person-selection flag set to a Commander command.
  * Pass `allFlagName: "--all-simulatable"` for ask commands to keep the
  * established flag name; defaults to `--all` for study run.
  */
-export function addAudienceFilterFlags(cmd, opts = {}) {
+export function addPersonFilterFlags(cmd, opts = {}) {
     const allFlag = opts.allFlagName ?? "--all";
-    const allDesc = opts.allFlagDescription ?? "Use every profile matching the filters";
+    const allDesc = opts.allFlagDescription ?? "Use every person matching the filters";
     return cmd
-        .option("--profile <ids>", "Tester profile IDs/aliases (comma-separated or repeatable)", collectIds, [])
-        .option("--sample <N>", "Randomly sample N profiles from the matching pool")
+        .option("--person <ids>", "Person IDs/aliases (comma-separated or repeatable)", collectIds, [])
+        .option("--sample <N>", "Randomly sample N people from the matching pool")
         .option(allFlag, allDesc)
-        .option("--search <text>", "Substring match against profile name")
-        .option("--bio <text>", "Substring match against profile bio")
-        .option("--occupation <text>", "Substring match against profile occupation (repeatable)", collectRepeatable, [])
+        .option("--search <text>", "Substring match against person name")
+        .option("--bio <text>", "Substring match against person bio")
+        .option("--occupation <text>", "Substring match against person occupation (repeatable)", collectRepeatable, [])
         .option("--gender <gender>", "Filter by gender (repeatable)", collectRepeatable, [])
         .option("--country <code>", "Filter by 2-letter country code (repeatable)", collectRepeatable, [])
         .option("--min-age <n>", "Minimum age (inclusive)")
         .option("--max-age <n>", "Maximum age (inclusive)")
-        .option("--visibility <v>", "Filter by visibility: workspace (your workspace), shared (community-published), platform (admin-curated). Old values `private` / `public` still accepted as aliases for `workspace` / `platform` until the next release; server logs a deprecation warning.");
+        .option("--visibility <v>", "Filter by visibility: workspace (your workspace), shared (community-published), platform (admin-curated). Old values `private` / `public` are accepted and mapped to `workspace` / `platform`.");
 }
 export function getGlobals(cmd) {
     let globals;
@@ -367,7 +379,7 @@ export function exitCodeFromError(err) {
         if (/no auth token found|run "ish login"|saved token is invalid|session expired/i.test(err.message))
             return 3;
         // Client-side validation failures
-        if (err.name === "ValidationError" || /^invalid |^cannot read |is empty:|--\w[\w-]* must be|pick an audience|use either /i.test(err.message))
+        if (err.name === "ValidationError" || /^invalid |^cannot read |is empty:|--\w[\w-]* must be|select people|use either /i.test(err.message))
             return 2;
         // Errors that pre-declare their own retryability / error_code take
         // precedence — WaitTimeoutError sets `error_code: "wait_timeout"`
@@ -655,8 +667,8 @@ export function collectRepeatable(value, prev = []) {
 }
 /**
  * Commander collector for ID-list flags. Accepts a comma-separated value
- * (`--profile a,b,c`) and also concatenates across repeated flags
- * (`--profile a --profile b`). Trims whitespace and drops empty entries.
+ * (`--person a,b,c`) and also concatenates across repeated flags
+ * (`--person a --person b`). Trims whitespace and drops empty entries.
  *
  * Use this for flags whose values are IDs/aliases — never for free-form
  * strings that may legitimately contain commas (those should use
@@ -680,7 +692,7 @@ const WORKSPACE_SCOPED_GROUPS = new Set([
     "ask",
     "study",
     "iteration",
-    "profile",
+    "person",
     "source",
 ]);
 /**
@@ -689,11 +701,11 @@ const WORKSPACE_SCOPED_GROUPS = new Set([
  * calls have populated the program tree. Agents reflexively pass `--workspace`
  * on any command — without this, Commander rejects it with a generic "unknown
  * option" on read-side commands like `ask delete`, `ask get`, `study get`,
- * `profile get`, etc.
+ * `person get`, etc.
  *
  * The injected option is documentation-only on commands where the workspace is
  * inferred from an ID alias; it's accepted and then discarded by the action
- * body. Resolvers (`resolveWorkspace`, `resolveAudienceProfileIds`) ignore
+ * body. Resolvers (`resolveWorkspace`, `resolvePersonIds`) ignore
  * unused values.
  */
 /**