@ishlabs/cli 0.8.1

package/dist/commands/study.js

@@ -0,0 +1,283 @@
+/**
+ * ish study — Manage studies.
+ */
+import { withClient, getWebUrl, terminalLink, resolveWorkspace } from "../lib/command-helpers.js";
+import { resolveId, tagAlias, ALIAS_PREFIX } from "../lib/alias-store.js";
+import { loadConfig, saveConfig } from "../config.js";
+import { formatStudyList, formatStudyDetail, formatStudyResults, output, ValidationError } from "../lib/output.js";
+import { VALID_CONTENT_TYPES } from "../lib/types.js";
+export function registerStudyCommands(program) {
+    const study = program
+        .command("study")
+        .description("Manage studies");
+    study
+        .command("list")
+        .description("List studies for a workspace")
+        .option("--workspace <id>", "Workspace ID")
+        .addHelpText("after", "\nExamples:\n  $ ish study list --workspace <id>\n  $ ish study list --workspace <id> --json")
+        .action(async (opts, cmd) => {
+        await withClient(cmd, async (client, globals) => {
+            const data = await client.get(`/products/${resolveWorkspace(opts.workspace)}/studies`);
+            formatStudyList(data, globals.json);
+        });
+    });
+    study
+        .command("create")
+        .description("Create a new study")
+        .option("--workspace <id>", "Workspace ID")
+        .requiredOption("--name <name>", "Study name")
+        .option("--description <description>", "Study description")
+        .option("--modality <modality>", "Study modality (interactive, video, audio, text, image, document)")
+        .option("--content-type <type>", "Content type (varies by modality — see examples below)")
+        .option("--assignments <json>", "JSON array of assignments, e.g. '[{\"name\":\"Task\",\"instructions\":\"Do something\"}]'")
+        .option("--questions <json>", "JSON array of interview questions, e.g. '[{\"question\":\"How was it?\",\"type\":\"text\",\"timing\":\"after\"}]'")
+        .addHelpText("after", `
+Note: --workspace is optional if set via \`ish workspace use <alias>\`.
+
+Examples:
+  # Interactive study:
+  $ ish study create --name "Onboarding UX" --modality interactive \\
+    --assignments '[{"name":"Sign up","instructions":"Complete the signup flow"}]'
+
+  # Text/email study:
+  $ ish study create --name "Newsletter" --modality text --content-type email \\
+    --assignments '[{"name":"Read","instructions":"Read this email naturally"}]'
+
+  # Audio conversation study:
+  $ ish study create --name "Episode Review" --modality audio --content-type conversation \\
+    --assignments '[{"name":"Listen","instructions":"Listen and react naturally"}]'
+
+  # Video ad study:
+  $ ish study create --name "Product Ad" --modality video --content-type ad \\
+    --assignments '[{"name":"Watch","instructions":"Watch this ad and share your reaction"}]'
+
+  # Image social post study:
+  $ ish study create --name "Instagram Post" --modality image --content-type social_post \\
+    --assignments '[{"name":"View","instructions":"Look at this post naturally"}]'
+
+  # With interview questions:
+  $ ish study create --name "Checkout" --modality interactive \\
+    --assignments '[{"name":"Buy","instructions":"Add to cart and checkout"}]' \\
+    --questions '[{"question":"How easy was it?","type":"slider","timing":"after","min":0,"max":10}]'
+
+Content types by modality:
+  text:     narrative, informational, commercial, editorial, reference, email, news
+  video:    tutorial, documentary, entertainment, review, lifestyle, news, social_post, ad
+  audio:    music, narration, conversation, speech, soundscape, news, ad
+  image:    product, photography, infographic, artwork, interface, social_post, ad
+  document: deck, presentation, report, brochure, guide`)
+        .action(async (opts, cmd) => {
+        await withClient(cmd, async (client, globals) => {
+            let assignments;
+            let interviewQuestions;
+            if (opts.assignments) {
+                try {
+                    assignments = JSON.parse(opts.assignments);
+                }
+                catch {
+                    throw new Error("Invalid --assignments JSON");
+                }
+            }
+            if (opts.questions) {
+                try {
+                    interviewQuestions = JSON.parse(opts.questions);
+                }
+                catch {
+                    throw new Error("Invalid --questions JSON");
+                }
+            }
+            // Validate content_type against modality
+            if (opts.contentType && opts.modality) {
+                const validTypes = VALID_CONTENT_TYPES[opts.modality];
+                if (validTypes && !validTypes.includes(opts.contentType)) {
+                    throw new ValidationError(`Invalid content type "${opts.contentType}" for modality "${opts.modality}".`, validTypes);
+                }
+            }
+            const resolvedWs = resolveWorkspace(opts.workspace);
+            const body = {
+                product_id: resolvedWs,
+                name: opts.name,
+                ...(opts.description !== undefined && { description: opts.description }),
+                ...(opts.modality !== undefined && { modality: opts.modality }),
+                ...(opts.contentType !== undefined && { content_type: opts.contentType }),
+                ...(assignments && { assignments }),
+                ...(interviewQuestions && { interview_questions: interviewQuestions }),
+            };
+            const data = await client.post(`/products/${resolvedWs}/studies`, body);
+            if (data.id) {
+                const config = loadConfig();
+                config.study = data.id;
+                saveConfig(config);
+            }
+            const result = data;
+            if (result.id)
+                result.alias = tagAlias(ALIAS_PREFIX.study, String(result.id));
+            formatStudyDetail(result, globals.json);
+            if (!globals.json && data.id) {
+                const url = getWebUrl(globals, `/${resolvedWs}/${data.id}/overview`);
+                console.error(`\n  ${terminalLink(url, "Open in browser ↗")}\n`);
+            }
+        });
+    });
+    study
+        .command("generate")
+        .description("Generate a study from a problem description using AI")
+        .option("--workspace <id>", "Workspace ID")
+        .requiredOption("--problem <description>", "Problem description (what you want to understand)")
+        .option("--target-url <url>", "URL of the product to test")
+        .addHelpText("after", "\nExamples:\n  $ ish study generate --workspace <id> --problem \"How do users navigate the onboarding flow?\"\n  $ ish study generate --workspace <id> --problem \"Test checkout\" --target-url https://example.com --json")
+        .action(async (opts, cmd) => {
+        await withClient(cmd, async (client, globals) => {
+            const body = {
+                problem_description: opts.problem,
+                ...(opts.targetUrl && { target_url: opts.targetUrl }),
+            };
+            const resolvedWs = resolveWorkspace(opts.workspace);
+            const data = await client.post(`/products/${resolvedWs}/studies/generate`, body);
+            const result = data;
+            if (result.id)
+                result.alias = tagAlias(ALIAS_PREFIX.study, String(result.id));
+            formatStudyDetail(result, globals.json);
+            if (!globals.json && data.id) {
+                const url = getWebUrl(globals, `/${resolvedWs}/${data.id}/overview`);
+                console.error(`\n  ${terminalLink(url, "Open in browser ↗")}\n`);
+            }
+        });
+    });
+    study
+        .command("get")
+        .description("Get study overview (assignments, questions, testers)")
+        .argument("<id>", "Study ID")
+        .addHelpText("after", "\nExamples:\n  $ ish study get <id>\n  $ ish study get <id> --json")
+        .action(async (id, _opts, cmd) => {
+        await withClient(cmd, async (client, globals) => {
+            const rid = resolveId(id);
+            const data = await client.get(`/studies/${rid}`);
+            const result = data;
+            if (result.id)
+                result.alias = tagAlias(ALIAS_PREFIX.study, String(result.id));
+            formatStudyDetail(result, globals.json);
+            if (!globals.json && data.product_id) {
+                const url = getWebUrl(globals, `/${data.product_id}/${rid}/overview`);
+                console.error(`\n  ${terminalLink(url, "Open in browser ↗")}\n`);
+            }
+        });
+    });
+    study
+        .command("results")
+        .description("View aggregated results (sentiment, interview answers)")
+        .argument("<id>", "Study ID")
+        .addHelpText("after", "\nExamples:\n  $ ish study results <id>\n  $ ish study results <id> --json")
+        .action(async (id, _opts, cmd) => {
+        await withClient(cmd, async (client, globals) => {
+            const rid = resolveId(id);
+            const data = await client.get(`/studies/${rid}`);
+            formatStudyResults(data, globals.json);
+            if (!globals.json && data.product_id) {
+                const url = getWebUrl(globals, `/${data.product_id}/${rid}/overview`);
+                console.error(`\n  ${terminalLink(url, "Open in browser ↗")}\n`);
+            }
+        });
+    });
+    study
+        .command("update")
+        .description("Update a study")
+        .argument("<id>", "Study ID")
+        .option("--name <name>", "Study name")
+        .option("--description <description>", "Study description")
+        .option("--status <status>", "Study status (draft, running, completed)")
+        .option("--modality <modality>", "Study modality (interactive, video, audio, text, image, document)")
+        .option("--content-type <type>", "Content type")
+        .option("--assignments <json>", "JSON array of assignments, e.g. '[{\"name\":\"Task\",\"instructions\":\"Do something\"}]'")
+        .option("--questions <json>", "JSON array of interview questions")
+        .addHelpText("after", "\nExamples:\n  $ ish study update <id> --name \"Updated Name\"\n  $ ish study update <id> --status running --json")
+        .action(async (id, opts, cmd) => {
+        await withClient(cmd, async (client, globals) => {
+            let assignments;
+            let interviewQuestions;
+            if (opts.assignments) {
+                try {
+                    assignments = JSON.parse(opts.assignments);
+                }
+                catch {
+                    throw new Error("Invalid --assignments JSON");
+                }
+            }
+            if (opts.questions) {
+                try {
+                    interviewQuestions = JSON.parse(opts.questions);
+                }
+                catch {
+                    throw new Error("Invalid --questions JSON");
+                }
+            }
+            if (opts.contentType && opts.modality) {
+                const validTypes = VALID_CONTENT_TYPES[opts.modality];
+                if (validTypes && !validTypes.includes(opts.contentType)) {
+                    throw new ValidationError(`Invalid content type "${opts.contentType}" for modality "${opts.modality}".`, validTypes);
+                }
+            }
+            const body = {};
+            if (opts.name !== undefined)
+                body.name = opts.name;
+            if (opts.description !== undefined)
+                body.description = opts.description;
+            if (opts.status !== undefined)
+                body.status = opts.status;
+            if (opts.modality !== undefined)
+                body.modality = opts.modality;
+            if (opts.contentType !== undefined)
+                body.content_type = opts.contentType;
+            if (assignments)
+                body.assignments = assignments;
+            if (interviewQuestions)
+                body.interview_questions = interviewQuestions;
+            if (Object.keys(body).length === 0) {
+                console.error("No update flags provided. Run `ish study update --help` for options.");
+                return;
+            }
+            const data = await client.put(`/studies/${resolveId(id)}`, body);
+            const result = data;
+            if (result.id)
+                result.alias = tagAlias(ALIAS_PREFIX.study, String(result.id));
+            formatStudyDetail(result, globals.json);
+        });
+    });
+    study
+        .command("delete")
+        .description("Delete a study")
+        .argument("<id>", "Study ID")
+        .addHelpText("after", "\nExamples:\n  $ ish study delete <id>")
+        .action(async (id, _opts, cmd) => {
+        await withClient(cmd, async (client, globals) => {
+            await client.del(`/studies/${resolveId(id)}`);
+            output({ message: "Study deleted" }, globals.json);
+        });
+    });
+    study
+        .command("use")
+        .description("Set the active study (saved to ~/.ish/config.json)")
+        .argument("[id]", "Study alias or UUID")
+        .option("--clear", "Remove the active study from config")
+        .addHelpText("after", "\nExamples:\n  $ ish study use s-b2c\n  $ ish study use <uuid>\n  $ ish study use --clear")
+        .action(async (id, opts, cmd) => {
+        if (opts.clear) {
+            const config = loadConfig();
+            delete config.study;
+            saveConfig(config);
+            console.error("Cleared active study.");
+            return;
+        }
+        if (!id) {
+            throw new Error("Provide a study alias or UUID, or use --clear.");
+        }
+        await withClient(cmd, async (client) => {
+            const rid = resolveId(id);
+            const data = await client.get(`/studies/${rid}`);
+            const config = loadConfig();
+            config.study = rid;
+            saveConfig(config);
+            console.error(`Active study set to "${data.name || rid}".`);
+        });
+    });
+}

package/dist/commands/tester-profile.d.ts

@@ -0,0 +1,5 @@
+/**
+ * ish tester-profile — Manage tester profiles.
+ */
+import type { Command } from "commander";
+export declare function registerTesterProfileCommands(program: Command): void;

package/dist/commands/tester-profile.js

@@ -0,0 +1,109 @@
+/**
+ * ish tester-profile — Manage tester profiles.
+ */
+import { withClient, readJsonFileOrStdin } from "../lib/command-helpers.js";
+import { resolveId, tagAlias, ALIAS_PREFIX } from "../lib/alias-store.js";
+import { formatTesterProfileList, output } from "../lib/output.js";
+export function registerTesterProfileCommands(program) {
+    const profile = program
+        .command("tester-profile")
+        .description("Manage tester profiles");
+    profile
+        .command("list")
+        .description("List tester profiles (defaults to simulatable AI profiles)")
+        .option("--workspace <id>", "Filter by workspace ID")
+        .option("--search <query>", "Search by name or bio")
+        .option("--type <type>", "Profile type: ai, human, all (default: ai)", "ai")
+        .option("--gender <gender>", "Filter by gender")
+        .option("--country <country>", "Filter by country code (e.g. US, GB, SE)")
+        .option("--min-age <n>", "Minimum age")
+        .option("--max-age <n>", "Maximum age")
+        .option("--limit <n>", "Max results (default 50)", "50")
+        .option("--offset <n>", "Offset for pagination", "0")
+        .addHelpText("after", `
+Examples:
+  $ ish tester-profile list
+  $ ish tester-profile list --search "engineer" --country US
+  $ ish tester-profile list --gender female --min-age 25 --max-age 40
+  $ ish tester-profile list --type all --json`)
+        .action(async (opts, cmd) => {
+        await withClient(cmd, async (client, globals) => {
+            const params = {
+                limit: opts.limit,
+                offset: opts.offset,
+            };
+            if (opts.workspace)
+                params.product_id = opts.workspace;
+            if (opts.search)
+                params.search = opts.search;
+            if (opts.type !== "all")
+                params.type = opts.type;
+            if (opts.gender)
+                params.gender = opts.gender;
+            if (opts.country)
+                params.country = opts.country;
+            if (opts.minAge)
+                params.min_age = opts.minAge;
+            if (opts.maxAge)
+                params.max_age = opts.maxAge;
+            const data = await client.get("/tester-profiles", params);
+            formatTesterProfileList(data, globals.json, parseInt(opts.limit, 10));
+        });
+    });
+    profile
+        .command("create")
+        .description("Create a tester profile")
+        .requiredOption("--file <path>", "JSON file with profile data")
+        .addHelpText("after", "\nExamples:\n  $ ish tester-profile create --file profile.json\n\n  Expected JSON: { \"name\": \"...\", \"age\": 30, \"gender\": \"...\", \"country\": \"US\", \"occupation\": \"...\", \"bio\": \"...\" }")
+        .action(async (opts, cmd) => {
+        await withClient(cmd, async (client, globals) => {
+            const body = await readJsonFileOrStdin(opts.file);
+            const data = await client.post("/tester-profiles", body);
+            const result = data;
+            if (result.id)
+                result.alias = tagAlias(ALIAS_PREFIX.testerProfile, String(result.id));
+            output(result, globals.json);
+        });
+    });
+    profile
+        .command("get")
+        .description("Get tester profile details")
+        .argument("<id>", "Tester profile ID")
+        .addHelpText("after", "\nExamples:\n  $ ish tester-profile get <id>\n  $ ish tester-profile get <id> --json")
+        .action(async (id, _opts, cmd) => {
+        await withClient(cmd, async (client, globals) => {
+            const data = await client.get(`/tester-profiles/${resolveId(id)}`);
+            const result = data;
+            if (result.id)
+                result.alias = tagAlias(ALIAS_PREFIX.testerProfile, String(result.id));
+            output(result, globals.json);
+        });
+    });
+    profile
+        .command("update")
+        .description("Update a tester profile")
+        .argument("<id>", "Tester profile ID")
+        .requiredOption("--file <path>", "JSON file with update data")
+        .addHelpText("after", "\nExamples:\n  $ ish tester-profile update <id> --file updates.json")
+        .action(async (id, opts, cmd) => {
+        await withClient(cmd, async (client, globals) => {
+            const body = await readJsonFileOrStdin(opts.file);
+            const data = await client.put(`/tester-profiles/${resolveId(id)}`, body);
+            const result = data;
+            if (result.id)
+                result.alias = tagAlias(ALIAS_PREFIX.testerProfile, String(result.id));
+            output(result, globals.json);
+        });
+    });
+    profile
+        .command("delete")
+        .description("Delete a tester profile")
+        .argument("<id>", "Tester profile ID")
+        .addHelpText("after", "\nExamples:\n  $ ish tester-profile delete <id>")
+        .action(async (id, _opts, cmd) => {
+        await withClient(cmd, async (client, globals) => {
+            await client.del(`/tester-profiles/${resolveId(id)}`);
+            output({ message: "Tester profile deleted" }, globals.json);
+        });
+    });
+}

package/dist/commands/tester.d.ts

@@ -0,0 +1,5 @@
+/**
+ * ish tester — Manage testers (usually created via `simulation run`).
+ */
+import type { Command } from "commander";
+export declare function registerTesterCommands(program: Command): void;

package/dist/commands/tester.js

@@ -0,0 +1,73 @@
+/**
+ * ish tester — Manage testers (usually created via `simulation run`).
+ */
+import { withClient, readJsonFileOrStdin } from "../lib/command-helpers.js";
+import { resolveId, tagAlias, ALIAS_PREFIX } from "../lib/alias-store.js";
+import { formatTesterDetail, output } from "../lib/output.js";
+export function registerTesterCommands(program) {
+    const tester = program
+        .command("tester")
+        .description("Manage testers (usually created via `simulation run`)");
+    tester
+        .command("create")
+        .description("Create a tester (low-level)")
+        .requiredOption("--iteration <id>", "Iteration ID")
+        .requiredOption("--profile <id>", "Tester profile ID")
+        .option("--language <lang>", "Language code (e.g. en, sv)")
+        .option("--platform <platform>", "Platform (browser, android, figma, code)")
+        .option("--tester-type <type>", "Tester type (ai, human)", "ai")
+        .addHelpText("after", "\nExamples:\n  $ ish tester create --iteration <id> --profile <id>\n  $ ish tester create --iteration <id> --profile <id> --platform android --json")
+        .action(async (opts, cmd) => {
+        await withClient(cmd, async (client, globals) => {
+            const body = {
+                tester_profile_id: resolveId(opts.profile),
+                tester_type: opts.testerType,
+                ...(opts.language && { language: opts.language }),
+                ...(opts.platform && { platform: opts.platform }),
+            };
+            const data = await client.post(`/iterations/${resolveId(opts.iteration)}/testers`, body);
+            const result = data;
+            if (result.id)
+                result.alias = tagAlias(ALIAS_PREFIX.tester, String(result.id));
+            output(result, globals.json);
+        });
+    });
+    tester
+        .command("batch-create")
+        .description("Create multiple testers from a JSON file (low-level)")
+        .requiredOption("--iteration <id>", "Iteration ID")
+        .requiredOption("--file <path>", "JSON file with testers array")
+        .addHelpText("after", "\nExamples:\n  $ ish tester batch-create --iteration <id> --file testers.json\n\n  Expected JSON: [{ \"tester_profile_id\": \"<id>\", \"platform\": \"browser\" }, ...]")
+        .action(async (opts, cmd) => {
+        await withClient(cmd, async (client, globals) => {
+            const body = await readJsonFileOrStdin(opts.file);
+            const data = await client.post(`/iterations/${resolveId(opts.iteration)}/testers/batch`, body);
+            output(data, globals.json);
+        });
+    });
+    tester
+        .command("get")
+        .description("Get tester details and results")
+        .argument("<id>", "Tester ID")
+        .addHelpText("after", "\nExamples:\n  $ ish tester get <id>\n  $ ish tester get <id> --json")
+        .action(async (id, _opts, cmd) => {
+        await withClient(cmd, async (client, globals) => {
+            const data = await client.get(`/testers/${resolveId(id)}`);
+            const result = data;
+            if (result.id)
+                result.alias = tagAlias(ALIAS_PREFIX.tester, String(result.id));
+            formatTesterDetail(result, globals.json);
+        });
+    });
+    tester
+        .command("delete")
+        .description("Delete a tester")
+        .argument("<id>", "Tester ID")
+        .addHelpText("after", "\nExamples:\n  $ ish tester delete <id>")
+        .action(async (id, _opts, cmd) => {
+        await withClient(cmd, async (client, globals) => {
+            await client.del(`/testers/${resolveId(id)}`);
+            output({ message: "Tester deleted" }, globals.json);
+        });
+    });
+}

package/dist/commands/workspace.d.ts

@@ -0,0 +1,5 @@
+/**
+ * ish workspace — Manage workspaces (API: /products).
+ */
+import type { Command } from "commander";
+export declare function registerWorkspaceCommands(program: Command): void;

package/dist/commands/workspace.js

@@ -0,0 +1,133 @@
+/**
+ * ish workspace — Manage workspaces (API: /products).
+ */
+import { withClient, getWebUrl, terminalLink } from "../lib/command-helpers.js";
+import { resolveId, tagAlias, ALIAS_PREFIX } from "../lib/alias-store.js";
+import { loadConfig, saveConfig } from "../config.js";
+import { formatWorkspaceList, formatWorkspaceDetail, output } from "../lib/output.js";
+export function registerWorkspaceCommands(program) {
+    const workspace = program
+        .command("workspace")
+        .description("Manage workspaces");
+    workspace
+        .command("list")
+        .description("List all workspaces")
+        .addHelpText("after", "\nExamples:\n  $ ish workspace list\n  $ ish workspace list --json")
+        .action(async (_opts, cmd) => {
+        await withClient(cmd, async (client, globals) => {
+            const data = await client.get("/products");
+            formatWorkspaceList(data, globals.json);
+        });
+    });
+    workspace
+        .command("create")
+        .description("Create a new workspace")
+        .requiredOption("--name <name>", "Workspace name")
+        .option("--description <description>", "Workspace description")
+        .option("--base-url <url>", "Default base URL")
+        .addHelpText("after", "\nExamples:\n  $ ish workspace create --name \"My App\" --base-url https://example.com\n  $ ish workspace create --name \"My App\" --json")
+        .action(async (opts, cmd) => {
+        await withClient(cmd, async (client, globals) => {
+            const body = {
+                name: opts.name,
+                ...(opts.description !== undefined && { description: opts.description }),
+                ...(opts.baseUrl !== undefined && { base_url: opts.baseUrl }),
+            };
+            const data = await client.post("/products", body);
+            const result = data;
+            if (result.id)
+                result.alias = tagAlias(ALIAS_PREFIX.workspace, String(result.id));
+            formatWorkspaceDetail(result, globals.json);
+            if (!globals.json && data.id) {
+                const url = getWebUrl(globals, `/${data.id}`);
+                console.error(`\n  ${terminalLink(url, "Open in browser ↗")}\n`);
+            }
+        });
+    });
+    workspace
+        .command("get")
+        .description("Get workspace details")
+        .argument("<id>", "Workspace ID")
+        .addHelpText("after", "\nExamples:\n  $ ish workspace get <id>\n  $ ish workspace get <id> --json")
+        .action(async (id, _opts, cmd) => {
+        await withClient(cmd, async (client, globals) => {
+            const rid = resolveId(id);
+            const data = await client.get(`/products/${rid}`);
+            const result = data;
+            if (result.id)
+                result.alias = tagAlias(ALIAS_PREFIX.workspace, String(result.id));
+            formatWorkspaceDetail(result, globals.json);
+            if (!globals.json) {
+                const url = getWebUrl(globals, `/${rid}`);
+                console.error(`\n  ${terminalLink(url, "Open in browser ↗")}\n`);
+            }
+        });
+    });
+    workspace
+        .command("update")
+        .description("Update a workspace")
+        .argument("<id>", "Workspace ID")
+        .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")
+        .action(async (id, opts, cmd) => {
+        await withClient(cmd, async (client, globals) => {
+            const body = {};
+            if (opts.name !== undefined)
+                body.name = opts.name;
+            if (opts.description !== undefined)
+                body.description = opts.description;
+            if (opts.baseUrl !== undefined)
+                body.base_url = opts.baseUrl;
+            if (Object.keys(body).length === 0) {
+                console.error("No update flags provided. Run `ish workspace update --help` for options.");
+                return;
+            }
+            const data = await client.put(`/products/${resolveId(id)}`, body);
+            const result = data;
+            if (result.id)
+                result.alias = tagAlias(ALIAS_PREFIX.workspace, String(result.id));
+            formatWorkspaceDetail(result, globals.json);
+        });
+    });
+    workspace
+        .command("delete")
+        .description("Delete a workspace")
+        .argument("<id>", "Workspace ID")
+        .addHelpText("after", "\nExamples:\n  $ ish workspace delete <id>")
+        .action(async (id, _opts, cmd) => {
+        await withClient(cmd, async (client, globals) => {
+            await client.del(`/products/${resolveId(id)}`);
+            output({ message: "Workspace deleted" }, globals.json);
+        });
+    });
+    workspace
+        .command("use")
+        .description("Set the active workspace (saved to ~/.ish/config.json)")
+        .argument("[id]", "Workspace alias or UUID")
+        .option("--clear", "Remove the active workspace from config")
+        .addHelpText("after", "\nExamples:\n  $ ish workspace use w-6ec\n  $ ish workspace use <uuid>\n  $ ish workspace use --clear")
+        .action(async (id, opts, cmd) => {
+        if (opts.clear) {
+            const config = loadConfig();
+            delete config.workspace;
+            delete config.study;
+            saveConfig(config);
+            console.error("Cleared active workspace (and study).");
+            return;
+        }
+        if (!id) {
+            throw new Error("Provide a workspace alias or UUID, or use --clear.");
+        }
+        await withClient(cmd, async (client) => {
+            const rid = resolveId(id);
+            const data = await client.get(`/products/${rid}`);
+            const config = loadConfig();
+            config.workspace = rid;
+            delete config.study; // study belongs to workspace
+            saveConfig(config);
+            console.error(`Active workspace set to "${data.name || rid}".`);
+        });
+    });
+}

package/dist/config.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Config persistence for ~/.ish/config.json
+ */
+export interface IshConfig {
+    access_token?: string;
+    refresh_token?: string;
+    token?: string;
+    workspace?: string;
+    study?: string;
+    [key: string]: string | undefined;
+}
+export declare function loadConfig(): IshConfig;
+export declare function saveConfig(config: IshConfig): void;

package/dist/config.js

@@ -0,0 +1,25 @@
+/**
+ * Config persistence for ~/.ish/config.json
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+const CONFIG_DIR = path.join(os.homedir(), ".ish");
+const CONFIG_FILE = path.join(CONFIG_DIR, "config.json");
+export function loadConfig() {
+    try {
+        if (fs.existsSync(CONFIG_FILE)) {
+            return JSON.parse(fs.readFileSync(CONFIG_FILE, "utf-8"));
+        }
+    }
+    catch {
+        // Corrupted config — ignore
+    }
+    return {};
+}
+export function saveConfig(config) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
+    const tmp = CONFIG_FILE + ".tmp";
+    fs.writeFileSync(tmp, JSON.stringify(config, null, 2) + "\n", { mode: 0o600 });
+    fs.renameSync(tmp, CONFIG_FILE);
+}

package/dist/connect.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Localhost connect CLI — wraps cloudflared and registers with Ish backend.
+ */
+export declare function runTunnel(port: number, tokenArg?: string, apiUrlArg?: string): Promise<void>;