@shipeasy/openapi 1.6.0 → 2.2.0

package/dist/operations/configs.js

@@ -1,119 +0,0 @@
-// src/operations/util.ts
-var str = (i, k) => i[k] === void 0 ? void 0 : i[k];
-
-// src/operations/configs.ts
-var GROUP = ["release", "configs"];
-var configOperations = [
-  {
-    group: GROUP,
-    name: "list",
-    mutates: false,
-    summary: "List all configs",
-    description: "Return every dynamic config (name, schema, last updated).",
-    params: [],
-    examples: [{ run: "shipeasy release configs list" }],
-    run: (client) => client.configs.listAll()
-  },
-  {
-    group: GROUP,
-    name: "get",
-    mutates: false,
-    summary: "Show a config by name",
-    description: "Resolve a config by name and return its full detail (schema + per-env values + drafts).",
-    params: [{ name: "name", type: "string", description: "Config name.", required: true, positional: true }],
-    examples: [{ run: "shipeasy release configs get pricing" }],
-    run: async (client, i) => {
-      const c = await client.configs.resolve(i.name);
-      return client.configs.get(c.id);
-    }
-  },
-  {
-    group: GROUP,
-    name: "create",
-    mutates: true,
-    summary: "Create a config",
-    description: "Create a dynamic config. Configs are JSON objects validated against a JSON Schema (object-only).",
-    params: [
-      { name: "name", type: "string", description: "Config name.", required: true, positional: true },
-      { name: "schema", type: "json", description: "JSON Schema (top-level type=object). Defaults to a permissive object schema." },
-      { name: "value", type: "json", description: "Initial value as a JSON object. Defaults to {}." },
-      { name: "description", type: "string", description: "Human-readable description." }
-    ],
-    examples: [
-      { note: "Permissive schema, empty value", run: "shipeasy release configs create pricing" },
-      { note: "Seed an initial value", run: `shipeasy release configs create pricing --value '{"free_trial_days":14}'` }
-    ],
-    run: (client, i) => client.configs.create({
-      name: i.name,
-      schema: i.schema ?? { type: "object", properties: {}, additionalProperties: true },
-      value: i.value ?? {},
-      ...i.description ? { description: i.description } : {}
-    })
-  },
-  {
-    group: GROUP,
-    name: "update",
-    mutates: true,
-    summary: "Update a config's value (flat, all envs)",
-    description: "Legacy flat value update across all envs. Use draft + publish for per-env staging.",
-    params: [
-      { name: "name", type: "string", description: "Config name.", required: true, positional: true },
-      { name: "value", type: "json", description: "New value (JSON object).", required: true }
-    ],
-    examples: [{ note: "Overwrite the value (all envs)", run: `shipeasy release configs update pricing --value '{"free_trial_days":30}'` }],
-    run: async (client, i) => {
-      const c = await client.configs.resolve(i.name);
-      return client.configs.update(c.id, { value: i.value });
-    }
-  },
-  {
-    group: GROUP,
-    name: "draft",
-    mutates: true,
-    summary: "Save a draft value for one env",
-    description: "Stage a draft value for the given env, to publish later.",
-    params: [
-      { name: "name", type: "string", description: "Config name.", required: true, positional: true },
-      { name: "env", type: "string", description: "Target env (e.g. prod, staging, dev).", required: true },
-      { name: "value", type: "json", description: "Draft value (JSON object).", required: true }
-    ],
-    examples: [{ note: "Stage a prod value", run: `shipeasy release configs draft pricing --env prod --value '{"free_trial_days":30}'` }],
-    run: async (client, i) => {
-      const c = await client.configs.resolve(i.name);
-      return client.configs.saveDraft(c.id, { env: i.env, value: i.value });
-    }
-  },
-  {
-    group: GROUP,
-    name: "publish",
-    mutates: true,
-    summary: "Publish the saved draft for one env",
-    description: "Promote the staged draft for the given env to live.",
-    params: [
-      { name: "name", type: "string", description: "Config name.", required: true, positional: true },
-      { name: "env", type: "string", description: "Target env to publish.", required: true }
-    ],
-    examples: [{ note: "Promote staged draft to prod", run: "shipeasy release configs publish pricing --env prod" }],
-    run: async (client, i) => {
-      const c = await client.configs.resolve(i.name);
-      return client.configs.publish(c.id, { env: str(i, "env") });
-    }
-  },
-  {
-    group: GROUP,
-    name: "archive",
-    mutates: true,
-    summary: "Archive a config",
-    description: "Archive (soft-delete) a config by name.",
-    params: [{ name: "name", type: "string", description: "Config name.", required: true, positional: true }],
-    examples: [{ run: "shipeasy release configs archive pricing" }],
-    run: async (client, i) => {
-      const c = await client.configs.resolve(i.name);
-      await client.configs.delete(c.id);
-      return { ok: true, archived: i.name };
-    }
-  }
-];
-export {
-  configOperations
-};

package/dist/operations/docs.d.ts

@@ -1,37 +0,0 @@
-import { Operation } from './types.js';
-import '../resources/index.js';
-import 'zod/v4/core';
-import 'zod';
-import '../resources/attributes.js';
-import '../transport.js';
-import '../resources/i18n.js';
-import '../resources/projects.js';
-import '../resources/ops.js';
-import '../resources/events.js';
-import '../resources/metrics.js';
-import '../resources/alert-rules.js';
-import '../schemas/alert-rules.js';
-import '../resources/killswitches.js';
-import '../schemas/killswitches.js';
-import '../schemas/pagination.js';
-import '../resources/universes.js';
-import '../schemas/universes.js';
-import '../resources/configs.js';
-import '../schemas/configs.js';
-import '../resources/experiments.js';
-import '../schemas/experiments.js';
-import '../resources/gates.js';
-import '../schemas/gates.js';
-
-/**
- * Render the registry to Markdown — the "documentation comes along for free"
- * half of the proposal. Both `cli/scripts/gen-cli-docs.ts` and
- * `mcp/scripts/gen-mcp-docs.ts` can call this instead of re-describing every
- * command/tool by hand, so help text, tool descriptions, and the docs site all
- * derive from the same `summary`/`description`/`params`/`examples`.
- */
-declare function renderOperationsMarkdown(ops: Operation[], opts?: {
-    title?: string;
-}): string;
-
-export { renderOperationsMarkdown };

package/dist/operations/docs.js

@@ -1,39 +0,0 @@
-// src/operations/types.ts
-var opId = (op) => [...op.group, op.name].join(".");
-var opMcpName = (op) => [...op.group, op.name].join("_");
-var opCli = (op) => [...op.group, op.name].join(" ");
-
-// src/operations/docs.ts
-function renderOperationsMarkdown(ops, opts = {}) {
-  const lines = [];
-  if (opts.title) lines.push(`# ${opts.title}`, "");
-  for (const op of ops) {
-    lines.push(`## \`${opId(op)}\``, "");
-    lines.push(op.summary, "");
-    if (op.description && op.description !== op.summary) lines.push(op.description, "");
-    lines.push(
-      `- **CLI:** \`shipeasy ${opCli(op)}\`  \xB7  **MCP tool:** \`${opMcpName(op)}\`  \xB7  ${op.mutates ? "write (needs project binding)" : "read"}`,
-      ""
-    );
-    if (op.params.length) {
-      lines.push("| Param | Type | Required | Description |", "| --- | --- | --- | --- |");
-      for (const p of op.params) {
-        const kind = p.positional ? `${p.type} (positional)` : p.type;
-        lines.push(`| \`${p.name}\` | ${kind} | ${p.required ? "yes" : "no"} | ${p.description} |`);
-      }
-      lines.push("");
-    }
-    if (op.examples?.length) {
-      lines.push("**Examples**", "");
-      for (const ex of op.examples) {
-        if (ex.note) lines.push(`- ${ex.note}:`);
-        lines.push("```sh", ex.run, "```");
-      }
-      lines.push("");
-    }
-  }
-  return lines.join("\n");
-}
-export {
-  renderOperationsMarkdown
-};

package/dist/operations/events.d.ts

@@ -1,28 +0,0 @@
-import { Operation } from './types.js';
-import '../resources/index.js';
-import 'zod/v4/core';
-import 'zod';
-import '../resources/attributes.js';
-import '../transport.js';
-import '../resources/i18n.js';
-import '../resources/projects.js';
-import '../resources/ops.js';
-import '../resources/events.js';
-import '../resources/metrics.js';
-import '../resources/alert-rules.js';
-import '../schemas/alert-rules.js';
-import '../resources/killswitches.js';
-import '../schemas/killswitches.js';
-import '../schemas/pagination.js';
-import '../resources/universes.js';
-import '../schemas/universes.js';
-import '../resources/configs.js';
-import '../schemas/configs.js';
-import '../resources/experiments.js';
-import '../schemas/experiments.js';
-import '../resources/gates.js';
-import '../schemas/gates.js';
-
-declare const eventOperations: Operation[];
-
-export { eventOperations };

package/dist/operations/events.js

@@ -1,121 +0,0 @@
-// src/operations/util.ts
-var str = (i, k) => i[k] === void 0 ? void 0 : i[k];
-var bool = (i, k) => i[k] === void 0 ? void 0 : i[k];
-
-// src/operations/events.ts
-var GROUP = ["events"];
-var PROPS_DESC = `Event properties as a JSON array, e.g. '[{"name":"amount","type":"number","required":true}]'. type is one of string|number|boolean. Replaces the full set on update/approve.`;
-function props(i) {
-  return i.props === void 0 ? void 0 : i.props;
-}
-var eventOperations = [
-  {
-    group: GROUP,
-    name: "list",
-    mutates: false,
-    summary: "List catalogued events",
-    description: "List every catalogued event (including pending auto-discovered names). Pass `pending` to show only the unapproved queue.",
-    params: [{ name: "pending", type: "boolean", description: "Show only pending (unapproved) events." }],
-    examples: [
-      { run: "shipeasy metrics events list" },
-      { note: "Review the auto-discovered queue", run: "shipeasy metrics events list --pending true" }
-    ],
-    run: async (client, i) => {
-      const rows = await client.events.list();
-      return bool(i, "pending") ? rows.filter((e) => e.pending === 1) : rows;
-    }
-  },
-  {
-    group: GROUP,
-    name: "get",
-    mutates: false,
-    summary: "Show one catalogued event",
-    description: "Resolve an event by id, id-prefix, or name and return its full detail.",
-    params: [{ name: "event", type: "string", description: "Event id or name.", required: true, positional: true }],
-    examples: [{ run: "shipeasy metrics events get checkout_completed" }],
-    run: (client, i) => client.events.resolve(i.event)
-  },
-  {
-    group: GROUP,
-    name: "create",
-    mutates: true,
-    summary: "Register a new event",
-    description: "Register a new event name and (optionally) its typed properties.",
-    params: [
-      { name: "name", type: "string", description: "Event name.", required: true, positional: true },
-      { name: "folder", type: "string", description: "Folder to file it under." },
-      { name: "description", type: "string", description: "Human-readable description." },
-      { name: "props", type: "json", description: PROPS_DESC }
-    ],
-    examples: [
-      { run: "shipeasy metrics events create checkout_completed" },
-      { note: "With a typed, required property", run: `shipeasy metrics events create purchase --props '[{"name":"amount","type":"number","required":true}]'` }
-    ],
-    run: (client, i) => client.events.create({
-      name: i.name,
-      folder: str(i, "folder") ?? null,
-      ...i.description ? { description: i.description } : {},
-      properties: props(i) ?? []
-    })
-  },
-  {
-    group: GROUP,
-    name: "update",
-    mutates: true,
-    summary: "Update an event",
-    description: "Update an event's folder, description, or properties (props replace the full set).",
-    params: [
-      { name: "event", type: "string", description: "Event id.", required: true, positional: true },
-      { name: "folder", type: "string", description: "New folder." },
-      { name: "description", type: "string", description: "New description." },
-      { name: "props", type: "json", description: PROPS_DESC }
-    ],
-    examples: [{ run: "shipeasy metrics events update evt_3f9a --folder checkout" }],
-    run: (client, i) => {
-      const patch = {};
-      if (i.folder !== void 0) patch.folder = i.folder;
-      if (i.description !== void 0) patch.description = i.description;
-      const p = props(i);
-      if (p) patch.properties = p;
-      return client.events.update(i.event, patch);
-    }
-  },
-  {
-    group: GROUP,
-    name: "approve",
-    mutates: true,
-    summary: "Approve a pending event",
-    description: "Promote a pending (auto-discovered) event so metrics can query it. Optionally declare its folder/props on approval.",
-    params: [
-      { name: "event", type: "string", description: "Event id.", required: true, positional: true },
-      { name: "folder", type: "string", description: "Folder to file it under." },
-      { name: "description", type: "string", description: "Description." },
-      { name: "props", type: "json", description: PROPS_DESC }
-    ],
-    examples: [{ note: "Promote an auto-discovered event", run: "shipeasy metrics events approve evt_3f9a" }],
-    run: (client, i) => {
-      const body = {};
-      if (i.folder !== void 0) body.folder = i.folder;
-      if (i.description !== void 0) body.description = i.description;
-      const p = props(i);
-      if (p) body.properties = p;
-      return client.events.approve(i.event, body);
-    }
-  },
-  {
-    group: GROUP,
-    name: "archive",
-    mutates: true,
-    summary: "Archive an event",
-    description: "Archive (remove) an event from the catalog by id.",
-    params: [{ name: "event", type: "string", description: "Event id.", required: true, positional: true }],
-    examples: [{ run: "shipeasy metrics events archive evt_3f9a" }],
-    run: async (client, i) => {
-      await client.events.delete(i.event);
-      return { ok: true, archived: i.event };
-    }
-  }
-];
-export {
-  eventOperations
-};

package/dist/operations/experiments.d.ts

@@ -1,28 +0,0 @@
-import { Operation } from './types.js';
-import '../resources/index.js';
-import 'zod/v4/core';
-import 'zod';
-import '../resources/attributes.js';
-import '../transport.js';
-import '../resources/i18n.js';
-import '../resources/projects.js';
-import '../resources/ops.js';
-import '../resources/events.js';
-import '../resources/metrics.js';
-import '../resources/alert-rules.js';
-import '../schemas/alert-rules.js';
-import '../resources/killswitches.js';
-import '../schemas/killswitches.js';
-import '../schemas/pagination.js';
-import '../resources/universes.js';
-import '../schemas/universes.js';
-import '../resources/configs.js';
-import '../schemas/configs.js';
-import '../resources/experiments.js';
-import '../schemas/experiments.js';
-import '../resources/gates.js';
-import '../schemas/gates.js';
-
-declare const experimentOperations: Operation[];
-
-export { experimentOperations };

package/dist/operations/experiments.js

@@ -1,280 +0,0 @@
-// src/operations/util.ts
-var num = (i, k) => i[k] === void 0 ? void 0 : i[k];
-var str = (i, k) => i[k] === void 0 ? void 0 : i[k];
-var bool = (i, k) => i[k] === void 0 ? void 0 : i[k];
-
-// src/operations/experiments.ts
-var GROUP = ["release", "experiments"];
-var DEFAULT_GROUPS = [
-  { name: "control", weight: 5e3, params: {} },
-  { name: "test", weight: 5e3, params: {} }
-];
-var AGGREGATIONS = [
-  "count_users",
-  "count_events",
-  "retention_7d",
-  "retention_30d",
-  "sum",
-  "avg"
-];
-function buildGoalMetric(i) {
-  const event = str(i, "successEvent");
-  if (!event) return void 0;
-  const agg = str(i, "successAggregation") ?? "count_users";
-  const value = str(i, "successValue");
-  switch (agg) {
-    case "count_users":
-      return { query: `count_users(${event})` };
-    case "count_events":
-      return { query: `count(${event})` };
-    case "retention_7d":
-      return { query: `retention_7d(${event})` };
-    case "retention_30d":
-      return { query: `retention_30d(${event})` };
-    case "sum":
-    case "avg":
-      if (!value)
-        throw new Error(
-          `successAggregation '${agg}' requires successValue \u2014 the numeric event property to ${agg} (e.g. "amount")`
-        );
-      return { query: `${agg}(${event}, ${value})` };
-    default:
-      throw new Error(`Unknown successAggregation '${agg}'`);
-  }
-}
-function parseGuardrails(raw) {
-  if (!Array.isArray(raw)) return [];
-  const out = [];
-  for (const entry of raw) {
-    if (typeof entry === "string") {
-      const query = entry.trim();
-      if (query) out.push({ query });
-    } else if (entry && typeof entry === "object") {
-      const o = entry;
-      const query = typeof o.query === "string" ? o.query.trim() : "";
-      if (query)
-        out.push(typeof o.name === "string" && o.name ? { query, name: o.name } : { query });
-    }
-  }
-  return out;
-}
-function computeVerdict(detail, results) {
-  if (results.some((r) => r.srm_detected === 1))
-    return { verdict: "invalid_srm", reason: "sample-ratio mismatch detected" };
-  if (detail.status !== "running") return { verdict: "not_running", reason: `status=${detail.status}` };
-  if (!results.length) return { verdict: "wait", reason: "no data yet" };
-  const withP = results.filter((r) => r.p_value !== null);
-  if (!withP.length) return { verdict: "wait", reason: "no p-values yet" };
-  const best = withP.reduce((a, b) => a.p_value < b.p_value ? a : b);
-  const threshold = detail.significance_threshold ?? 0.05;
-  if (best.p_value < threshold) return { verdict: "ship" };
-  const startedAt = detail.startedAt ?? detail.started_at;
-  const daysRunning = startedAt ? (Date.now() - new Date(startedAt).getTime()) / (1e3 * 60 * 60 * 24) : 0;
-  return daysRunning < (detail.min_runtime_days ?? 0) ? { verdict: "wait", reason: "min runtime not reached" } : { verdict: "hold" };
-}
-var experimentOperations = [
-  {
-    group: GROUP,
-    name: "list",
-    mutates: false,
-    summary: "List experiments",
-    description: "Return every experiment (status, universe, allocation).",
-    params: [],
-    examples: [{ run: "shipeasy release experiments list" }],
-    run: (client) => client.experiments.listAll()
-  },
-  {
-    group: GROUP,
-    name: "create",
-    mutates: true,
-    summary: "Create an experiment",
-    description: "Create an experiment draft with groups, params, optional targeting gate, a success (goal) metric, optional guardrail metrics, and full statistical config. Pass `successEvent` (+ `successAggregation`) to attach the goal metric inline \u2014 required before the experiment can be started. Defaults to a 50/50 control-vs-test split at 100% allocation in the `default` universe. Does NOT start \u2014 call `start`.",
-    params: [
-      { name: "name", type: "string", description: "Experiment name.", required: true, positional: true },
-      { name: "universe", type: "string", description: "Universe name. Defaults to 'default'." },
-      { name: "allocation", type: "number", description: "Allocation percentage, 0\u2013100. Defaults to 100." },
-      { name: "groups", type: "json", description: "Groups as JSON [{name,weight,params}]. weight is basis points." },
-      { name: "params", type: "json", description: "Parameter schema {name: type}." },
-      { name: "targetingGate", type: "string", description: "Targeting gate name." },
-      { name: "bucketBy", type: "string", description: "Attribute to bucket by (defaults to the universe unit)." },
-      { name: "salt", type: "string", description: "Override hash salt." },
-      { name: "successEvent", type: "string", description: "Event name for the inline goal metric. Attaching one makes the draft startable." },
-      { name: "successAggregation", type: "string", description: `Goal-metric reducer. Defaults to count_users.`, enum: [...AGGREGATIONS] },
-      { name: "successValue", type: "string", description: "Numeric event property for sum/avg goal metrics." },
-      { name: "guardrailMetrics", type: "json", description: "Up to 10 guardrail metrics: JSON array of DSL query strings or {query,name}." },
-      { name: "significance", type: "number", description: "Significance threshold (0.0001\u20130.5). Defaults to 0.05." },
-      { name: "minRuntimeDays", type: "number", description: "Minimum runtime in days." },
-      { name: "minSampleSize", type: "number", description: "Minimum sample size." },
-      { name: "sequentialTesting", type: "boolean", description: "Enable sequential testing (always-valid p-values; Premium+)." },
-      { name: "description", type: "string", description: "Human-readable description." }
-    ],
-    examples: [
-      { note: "Default 50/50, full traffic", run: "shipeasy release experiments create pricing-page" },
-      {
-        note: "Attach a goal metric so it's startable",
-        run: "shipeasy release experiments create checkout-cta --universe web --success-event checkout_completed"
-      }
-    ],
-    run: (client, i) => {
-      const goal_metric = buildGoalMetric(i);
-      const guardrail_metrics = parseGuardrails(i.guardrailMetrics);
-      return client.experiments.create({
-        name: i.name,
-        universe: str(i, "universe") ?? "default",
-        allocation_pct: Math.round((num(i, "allocation") ?? 100) * 100),
-        groups: i.groups ?? DEFAULT_GROUPS,
-        params: i.params ?? {},
-        targeting_gate: str(i, "targetingGate") ?? null,
-        ...str(i, "bucketBy") ? { bucket_by: str(i, "bucketBy") } : {},
-        ...str(i, "description") !== void 0 ? { description: str(i, "description") } : {},
-        ...i.salt ? { salt: i.salt } : {},
-        ...num(i, "significance") !== void 0 ? { significance_threshold: num(i, "significance") } : {},
-        ...num(i, "minRuntimeDays") !== void 0 ? { min_runtime_days: num(i, "minRuntimeDays") } : {},
-        ...num(i, "minSampleSize") !== void 0 ? { min_sample_size: num(i, "minSampleSize") } : {},
-        ...bool(i, "sequentialTesting") !== void 0 ? { sequential_testing: bool(i, "sequentialTesting") } : {},
-        ...goal_metric ? { goal_metric } : {},
-        ...guardrail_metrics.length ? { guardrail_metrics } : {}
-      });
-    }
-  },
-  {
-    group: GROUP,
-    name: "update",
-    mutates: true,
-    summary: "Update an experiment",
-    description: "Patch allocation, groups, params, targeting gate, or stats thresholds. Pass `targetingGate` = 'null' to clear it.",
-    params: [
-      { name: "name", type: "string", description: "Experiment name.", required: true, positional: true },
-      { name: "allocation", type: "number", description: "Allocation percentage, 0\u2013100." },
-      { name: "groups", type: "json", description: "Groups as JSON [{name,weight,params}]." },
-      { name: "params", type: "json", description: "Parameter schema {name: type}." },
-      { name: "targetingGate", type: "string", description: "Targeting gate name ('null' to clear)." },
-      { name: "bucketBy", type: "string", description: "Attribute to bucket by (empty string clears)." },
-      { name: "successEvent", type: "string", description: "Attach/replace the goal metric from this event." },
-      { name: "successAggregation", type: "string", description: "Goal-metric reducer (with successEvent).", enum: [...AGGREGATIONS] },
-      { name: "successValue", type: "string", description: "Numeric event property for sum/avg goal metrics." },
-      { name: "guardrailMetrics", type: "json", description: "Replace the guardrail set: JSON array of DSL queries or {query,name}." },
-      { name: "significance", type: "number", description: "Significance threshold (0.0001\u20130.5)." },
-      { name: "minRuntimeDays", type: "number", description: "Minimum runtime in days." },
-      { name: "minSampleSize", type: "number", description: "Minimum sample size." },
-      { name: "sequentialTesting", type: "boolean", description: "Enable sequential testing (always-valid p-values)." }
-    ],
-    examples: [
-      { note: "Dial allocation to 50%", run: "shipeasy release experiments update pricing-page --allocation 50" },
-      { note: "Clear targeting + tighten significance", run: "shipeasy release experiments update checkout-cta --targeting-gate null --significance 0.01" }
-    ],
-    run: async (client, i) => {
-      const e = await client.experiments.resolve(i.name);
-      const patch = {};
-      const allocation = num(i, "allocation");
-      if (allocation !== void 0) patch.allocation_pct = Math.round(allocation * 100);
-      if (i.groups !== void 0) patch.groups = i.groups;
-      if (i.params !== void 0) patch.params = i.params;
-      if (i.targetingGate !== void 0)
-        patch.targeting_gate = i.targetingGate === "null" ? null : i.targetingGate;
-      if (str(i, "bucketBy") !== void 0) patch.bucket_by = str(i, "bucketBy") || null;
-      if (i.significance !== void 0) patch.significance_threshold = i.significance;
-      if (i.minRuntimeDays !== void 0) patch.min_runtime_days = i.minRuntimeDays;
-      if (i.minSampleSize !== void 0) patch.min_sample_size = i.minSampleSize;
-      if (bool(i, "sequentialTesting") !== void 0) patch.sequential_testing = bool(i, "sequentialTesting");
-      if (i.guardrailMetrics !== void 0) patch.guardrail_metrics = parseGuardrails(i.guardrailMetrics);
-      const goal_metric = buildGoalMetric(i);
-      if (goal_metric) patch.goal_metric = goal_metric;
-      return client.experiments.update(e.id, patch);
-    }
-  },
-  {
-    group: GROUP,
-    name: "start",
-    mutates: true,
-    summary: "Start an experiment",
-    description: "Move an experiment from draft to running.",
-    params: [{ name: "name", type: "string", description: "Experiment name.", required: true, positional: true }],
-    examples: [{ run: "shipeasy release experiments start pricing-page" }],
-    run: async (client, i) => {
-      const e = await client.experiments.resolve(i.name);
-      return client.experiments.start(e.id);
-    }
-  },
-  {
-    group: GROUP,
-    name: "stop",
-    mutates: true,
-    summary: "Stop a running experiment",
-    description: "Stop a running experiment. Optionally name a `promoteGroup` to record an intent note (actual promotion happens in the dashboard).",
-    params: [
-      { name: "name", type: "string", description: "Experiment name.", required: true, positional: true },
-      { name: "promoteGroup", type: "string", description: "Group to note as the winner to promote." }
-    ],
-    examples: [{ run: "shipeasy release experiments stop pricing-page" }],
-    run: async (client, i) => {
-      const e = await client.experiments.resolve(i.name);
-      const result = await client.experiments.stop(e.id);
-      const promote = str(i, "promoteGroup");
-      return {
-        ...result,
-        ...promote ? {
-          promote_group_note: `Manual promotion needed: promote group '${promote}' in the dashboard or via PATCH /api/admin/experiments/${e.id}.`
-        } : {}
-      };
-    }
-  },
-  {
-    group: GROUP,
-    name: "archive",
-    mutates: true,
-    summary: "Archive a stopped experiment",
-    description: "Archive (soft-delete) a stopped experiment, hiding it from the default list while preserving results.",
-    params: [{ name: "name", type: "string", description: "Experiment name.", required: true, positional: true }],
-    examples: [{ run: "shipeasy release experiments archive pricing-page" }],
-    run: async (client, i) => {
-      const e = await client.experiments.resolve(i.name);
-      return client.experiments.archive(e.id);
-    }
-  },
-  {
-    group: GROUP,
-    name: "restore",
-    mutates: true,
-    summary: "Restore an archived experiment to draft",
-    description: "Restore a soft-deleted (archived) experiment back to `draft`. Allowed only if it never started; one that already ran must be cloned instead. Preserves the goal metric.",
-    params: [{ name: "name", type: "string", description: "Experiment name.", required: true, positional: true }],
-    examples: [{ run: "shipeasy release experiments restore pricing-page" }],
-    run: async (client, i) => {
-      const e = await client.experiments.resolve(i.name);
-      return client.experiments.restore(e.id);
-    }
-  },
-  {
-    group: GROUP,
-    name: "reanalyze",
-    mutates: true,
-    summary: "Re-run the analysis pass",
-    description: "Trigger a fresh analysis pass for an experiment.",
-    params: [{ name: "name", type: "string", description: "Experiment name.", required: true, positional: true }],
-    examples: [{ run: "shipeasy release experiments reanalyze pricing-page" }],
-    run: async (client, i) => {
-      const e = await client.experiments.resolve(i.name);
-      return client.experiments.reanalyze(e.id);
-    }
-  },
-  {
-    group: GROUP,
-    name: "status",
-    mutates: false,
-    summary: "Show experiment status, verdict, and latest results",
-    description: "Return the experiment, its latest per-metric results (enrolment, deltas, p-values), and a ship/hold/wait/not_running/invalid_srm verdict computed from the goal metric vs the significance threshold and minimum runtime.",
-    params: [{ name: "name", type: "string", description: "Experiment name.", required: true, positional: true }],
-    examples: [{ run: "shipeasy release experiments status pricing-page" }],
-    run: async (client, i) => {
-      const e = await client.experiments.resolve(i.name);
-      const detail = await client.experiments.get(e.id).catch(() => e);
-      const results = await client.experiments.results(e.id).catch(() => []);
-      const { verdict, reason } = computeVerdict(detail, results);
-      return { verdict, ...reason ? { reason } : {}, experiment: detail, results };
-    }
-  }
-];
-export {
-  experimentOperations
-};