@shipeasy/openapi 1.6.0 → 2.2.0

package/dist/client.d.ts

@@ -0,0 +1 @@
+export { i as Client, k as Config, m as ConfigureOptions, L as CreateClientConfig, gM as Options, hh as RequestResult, kA as approveEvent, kB as client, kC as configure, kD as createAlertRule, kE as createAttribute, kF as createClient, kG as createClientConfig, kH as createConfig, kI as createConnector, kJ as createEvent, kK as createExperiment, kL as createGate, kM as createGateTemplate, kN as createI18nDraft, kO as createI18nProfile, kP as createKey, kQ as createKillswitch, kR as createMetric, kS as createOpsItem, kT as createTriggerConnector, kU as createUniverse, kV as deleteAlertRule, kW as deleteAttribute, kX as deleteConfig, kY as deleteConnector, kZ as deleteEvent, k_ as deleteExperiment, k$ as deleteGate, l0 as deleteGateTemplate, l1 as deleteKillswitch, l2 as deleteMetric, l3 as deleteUniverse, l4 as disableGate, l5 as discardConfigDraft, l6 as enableGate, l7 as fileErrorTicket, l8 as fireConnector, l9 as getAttribute, la as getConfig, lb as getConnector, lc as getCurrentProject, ld as getError, le as getErrorSeries, lf as getEvent, lg as getExperiment, lh as getExperimentResults, li as getExperimentTimeseries, lj as getGateTemplate, lk as getKillswitch, ll as getMetric, lm as getOpsItem, ln as linkPrToOpsItem, lo as listAlertRules, lp as listAttributes, lq as listConfigActivity, lr as listConfigs, ls as listConnectors, lt as listErrors, lu as listEvents, lv as listExperiments, lw as listGateTemplates, lx as listGates, ly as listI18nDrafts, lz as listI18nKeys, lA as listI18nProfiles, lB as listKeys, lC as listKillswitches, lD as listMetrics, lE as listOpsItems, lF as listSlackChannels, lG as listUniverses, lH as notifyOps, lI as publishConfigDraft, lJ as publishI18nProfile, lK as pushI18nKeys, lL as reanalyzeExperiment, lM as revokeKey, lN as saveConfigDraft, lO as searchResources, lP as setExperimentMetrics, lQ as setExperimentStatus, lR as setI18nLabel, lS as setKillswitchSwitch, lT as setKillswitchValue, lU as testConnector, lV as unsetKillswitchSwitch, lW as updateAlertRule, lX as updateAttribute, lY as updateConfig, lZ as updateConfigSchema, l_ as updateConnector, l$ as updateErrorStatus, m0 as updateEvent, m1 as updateExperiment, m2 as updateGate, m3 as updateGateTemplate, m4 as updateI18nDraft, m5 as updateI18nKey, m6 as updateKillswitch, m7 as updateMetric, m8 as updateOpsItem, m9 as updateProject, ma as updateTriggerConnector, mb as updateUniverse, mc as upsertProject } from './client-K0ShmsC7.js';

package/dist/client.js

@@ -0,0 +1,215 @@
+import {
+  approveEvent,
+  client,
+  configure,
+  createAlertRule,
+  createAttribute,
+  createClient,
+  createConfig,
+  createConfig2,
+  createConnector,
+  createEvent,
+  createExperiment,
+  createGate,
+  createGateTemplate,
+  createI18nDraft,
+  createI18nProfile,
+  createKey,
+  createKillswitch,
+  createMetric,
+  createOpsItem,
+  createTriggerConnector,
+  createUniverse,
+  deleteAlertRule,
+  deleteAttribute,
+  deleteConfig,
+  deleteConnector,
+  deleteEvent,
+  deleteExperiment,
+  deleteGate,
+  deleteGateTemplate,
+  deleteKillswitch,
+  deleteMetric,
+  deleteUniverse,
+  disableGate,
+  discardConfigDraft,
+  enableGate,
+  fileErrorTicket,
+  fireConnector,
+  getAttribute,
+  getConfig,
+  getConnector,
+  getCurrentProject,
+  getError,
+  getErrorSeries,
+  getEvent,
+  getExperiment,
+  getExperimentResults,
+  getExperimentTimeseries,
+  getGateTemplate,
+  getKillswitch,
+  getMetric,
+  getOpsItem,
+  linkPrToOpsItem,
+  listAlertRules,
+  listAttributes,
+  listConfigActivity,
+  listConfigs,
+  listConnectors,
+  listErrors,
+  listEvents,
+  listExperiments,
+  listGateTemplates,
+  listGates,
+  listI18nDrafts,
+  listI18nKeys,
+  listI18nProfiles,
+  listKeys,
+  listKillswitches,
+  listMetrics,
+  listOpsItems,
+  listSlackChannels,
+  listUniverses,
+  notifyOps,
+  publishConfigDraft,
+  publishI18nProfile,
+  pushI18nKeys,
+  reanalyzeExperiment,
+  revokeKey,
+  saveConfigDraft,
+  searchResources,
+  setExperimentMetrics,
+  setExperimentStatus,
+  setI18nLabel,
+  setKillswitchSwitch,
+  setKillswitchValue,
+  testConnector,
+  unsetKillswitchSwitch,
+  updateAlertRule,
+  updateAttribute,
+  updateConfig,
+  updateConfigSchema,
+  updateConnector,
+  updateErrorStatus,
+  updateEvent,
+  updateExperiment,
+  updateGate,
+  updateGateTemplate,
+  updateI18nDraft,
+  updateI18nKey,
+  updateKillswitch,
+  updateMetric,
+  updateOpsItem,
+  updateProject,
+  updateTriggerConnector,
+  updateUniverse,
+  upsertProject
+} from "./chunk-643YSMLU.js";
+export {
+  approveEvent,
+  client,
+  configure,
+  createAlertRule,
+  createAttribute,
+  createClient,
+  createConfig as createClientConfig,
+  createConfig2 as createConfig,
+  createConnector,
+  createEvent,
+  createExperiment,
+  createGate,
+  createGateTemplate,
+  createI18nDraft,
+  createI18nProfile,
+  createKey,
+  createKillswitch,
+  createMetric,
+  createOpsItem,
+  createTriggerConnector,
+  createUniverse,
+  deleteAlertRule,
+  deleteAttribute,
+  deleteConfig,
+  deleteConnector,
+  deleteEvent,
+  deleteExperiment,
+  deleteGate,
+  deleteGateTemplate,
+  deleteKillswitch,
+  deleteMetric,
+  deleteUniverse,
+  disableGate,
+  discardConfigDraft,
+  enableGate,
+  fileErrorTicket,
+  fireConnector,
+  getAttribute,
+  getConfig,
+  getConnector,
+  getCurrentProject,
+  getError,
+  getErrorSeries,
+  getEvent,
+  getExperiment,
+  getExperimentResults,
+  getExperimentTimeseries,
+  getGateTemplate,
+  getKillswitch,
+  getMetric,
+  getOpsItem,
+  linkPrToOpsItem,
+  listAlertRules,
+  listAttributes,
+  listConfigActivity,
+  listConfigs,
+  listConnectors,
+  listErrors,
+  listEvents,
+  listExperiments,
+  listGateTemplates,
+  listGates,
+  listI18nDrafts,
+  listI18nKeys,
+  listI18nProfiles,
+  listKeys,
+  listKillswitches,
+  listMetrics,
+  listOpsItems,
+  listSlackChannels,
+  listUniverses,
+  notifyOps,
+  publishConfigDraft,
+  publishI18nProfile,
+  pushI18nKeys,
+  reanalyzeExperiment,
+  revokeKey,
+  saveConfigDraft,
+  searchResources,
+  setExperimentMetrics,
+  setExperimentStatus,
+  setI18nLabel,
+  setKillswitchSwitch,
+  setKillswitchValue,
+  testConnector,
+  unsetKillswitchSwitch,
+  updateAlertRule,
+  updateAttribute,
+  updateConfig,
+  updateConfigSchema,
+  updateConnector,
+  updateErrorStatus,
+  updateEvent,
+  updateExperiment,
+  updateGate,
+  updateGateTemplate,
+  updateI18nDraft,
+  updateI18nKey,
+  updateKillswitch,
+  updateMetric,
+  updateOpsItem,
+  updateProject,
+  updateTriggerConnector,
+  updateUniverse,
+  upsertProject
+};
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/custom.d.ts

@@ -0,0 +1,86 @@
+/**
+ * The custom-operations registry — hand-written operations that are NOT admin
+ * API endpoints (so they can't be generated from the spec): the metric-DSL
+ * grammar (pure) and the SDK-docs fetcher (outbound `fetch` to GitHub Pages).
+ *
+ * It mirrors the old operations registry in spirit, but is deliberately tiny and
+ * framework-agnostic: each `CustomOp` carries its command path, params, and a
+ * self-contained `run`. Both consumers project it with a thin adapter — the CLI
+ * (`commands/custom.ts`) and, later, the MCP server — so the surface stays in
+ * sync across them. `run` never touches the filesystem, so it's worker-safe.
+ */
+type CustomParamType = "string" | "number" | "boolean";
+interface CustomParam {
+    name: string;
+    type: CustomParamType;
+    description?: string;
+    required?: boolean;
+    /** Render as a positional CLI argument (vs a `--flag`). */
+    positional?: boolean;
+    enum?: string[];
+}
+interface CustomOp {
+    /** Command path, e.g. `["docs"]` → `shipeasy docs <name>`, `["metrics"]` → `metrics <name>`. */
+    group: string[];
+    /** Verb. */
+    name: string;
+    summary: string;
+    description?: string;
+    params: CustomParam[];
+    examples?: {
+        note?: string;
+        run: string;
+    }[];
+    /** Self-contained handler. `args` are the coerced param values. */
+    run: (args: Record<string, unknown>) => Promise<unknown> | unknown;
+}
+/**
+ * Group-level help for a custom-op command group (e.g. `docs`). Mirrors what an
+ * OpenAPI tag carries for the generated tree — a short `summary` (shown in the
+ * parent `--help` list) and a long `description` (shown on the group's own
+ * `--help`). Consumers look this up by `group` path when creating the group so a
+ * custom group reads as richly as a spec-backed one, instead of the bare
+ * `"<name> commands"` fallback.
+ */
+interface CustomGroup {
+    /** Group path, e.g. `["docs"]`. */
+    group: string[];
+    summary: string;
+    description?: string;
+    aliases?: string[];
+}
+/** Thrown by a custom op for a user-facing error with an HTTP-ish status. */
+declare class CustomOpError extends Error {
+    status: number;
+    constructor(message: string, status?: number);
+}
+declare const opId: (op: CustomOp) => string;
+
+/**
+ * The Shipeasy metric query DSL grammar — printed by `shipeasy metrics grammar`
+ * / the `metrics_grammar` MCP tool.
+ *
+ * This is the one-stop reference for both humans and AI agents that need to
+ * author a `metrics create --query "..."` string. It is intentionally
+ * self-contained: the formal grammar (precise, for machine parsing), a full
+ * aggregation reference (semantics + value-label rules + experiment behaviour),
+ * the selector/filter/group-by rules, hard constraints, and glossed examples.
+ * Keep it in sync with the parser (`cli/src/query-dsl/parse.ts`) and the IR
+ * (`cli/src/query-dsl/ir.ts`) — they are the source of truth for semantics.
+ */
+declare const METRIC_GRAMMAR = "SHIPEASY METRIC QUERY DSL\n=========================\n\nA metric is ONE aggregation over ONE event stream. This DSL is the string you\npass to `metrics create --query \"...\"` (equivalently the typed `query_ir`).\nThere is no arithmetic, no formulas across events, no subqueries \u2014 one event\nselector, one aggregation, an optional group-by.\n\n\nGRAMMAR (BNF)\n-------------\n  Query         := AggFunc \"(\" Selector (\",\" Identifier)? \")\" GroupBy?\n  AggFunc       := \"count_users\" | \"count\" | \"sum\" | \"avg\" | \"min\" | \"max\"\n                 | \"unique\" | \"p50\" | \"p75\" | \"p90\" | \"p95\" | \"p99\" | \"p999\"\n                 | \"retention_\" <N> \"d\"                       (N = 1..90)\n  Selector      := Identifier (\"{\" Filter (\",\" Filter)* \",\"? \"}\")?\n  Filter        := Identifier MatchOp StringLiteral\n  MatchOp       := \"=\" | \"!=\" | \"=~\" | \"!~\"\n  GroupBy       := (\"by\" | \"without\") \"(\" Identifier (\",\" Identifier)* \",\"? \")\"\n  StringLiteral := double-quoted; \\\" is a literal quote, \\\\ is a backslash\n  Identifier    := [A-Za-z_][A-Za-z0-9_]*                     (case-sensitive)\n\n  The trailing Identifier after the selector \u2014 \"(\" Selector \",\" Identifier \")\" \u2014\n  is the VALUE LABEL: the numeric event label the aggregation reduces. Whether it\n  is required, optional, or forbidden depends on the aggregation (see below).\n\n\nAGGREGATIONS\n------------\n  Function        Value label   Meaning                         In experiments\n  --------------  ------------  ------------------------------  ---------------\n  count_users     forbidden     distinct users who fired it     exact\n  count           forbidden     number of events (rows)         exact\n  sum(e, v)       required      \u03A3 of numeric label v            exact\n  avg(e, v)       required      mean of label v                 exact\n  retention_Nd(e) forbidden     % of users who returned         exact\n                                within N days (N = 1..90)\n  min(e, v)       required      minimum of label v              approx \u2192 avg *\n  max(e, v)       required      maximum of label v              approx \u2192 avg *\n  unique(e, v)    required      distinct values of label v      approx \u2192 avg *\n  p50 \u2026 p999(e,v) required      quantile of v (50/75/90/        approx \u2192 avg *\n                                95/99/99.9th percentile)\n\n  * Display-only aggregations. The experiment t-test needs a per-user mean and\n    variance, so min/max/unique/quantile are computed exactly on dashboards but\n    collapse to a per-user `avg` when used as an experiment metric. If you need\n    an exact experiment metric, pick count_users / count / sum / avg / retention.\n\n  \"count\" is the DSL spelling of the internal count_events (one per matching\n  row); \"count_users\" is unique-by-user. Getting these two confused is the most\n  common mistake \u2014 count double-counts a user who fired the event twice.\n\n\nSELECTOR & FILTERS\n------------------\n  The selector is the event name plus an optional `{ ... }` filter set that\n  narrows which events count. Each filter compares an event LABEL to a quoted\n  string:\n\n    =   equal            !=   not equal\n    =~  regex match      !~   regex NOT match\n\n  - Values are ALWAYS double-quoted strings, even for numeric labels \u2014 they are\n    coerced on the server (`amount=~\"^1[0-9]$\"`, `status=\"200\"`).\n  - Multiple filters are AND-ed: `{country=\"US\", tier!=\"free\"}`.\n  - Every filter label AND the value label must be a label DECLARED on the source\n    event. Undeclared labels are a validation error, not a silent no-match.\n\n\nGROUP-BY\n--------\n  Splits the result into one series per label combination.\n    by (a, b)       one series per distinct (a, b) \u2014 keep only these labels\n    without (a, b)  group by all declared labels EXCEPT a, b\n\n  NOTE: group-by is a DASHBOARD-only feature. In an experiment the group-by is\n  ignored \u2014 a per-user reducer is applied across the whole arm instead.\n\n\nNOT SUPPORTED (will fail to parse)\n----------------------------------\n  - arithmetic / ratios / formulas: `count(a) / count(b)`\n  - more than one event per query\n  - arbitrary quantiles (only the fixed p50/p75/p90/p95/p99/p999)\n  - unquoted or numeric filter values: `{status=200}`  \u2192 must be `\"200\"`\n  - trailing tokens after the query\n\n\nEXAMPLES  (query  \u2014  what it measures)\n--------------------------------------\n  count_users(checkout_completed)\n      distinct users who completed checkout.\n\n  count(add_to_cart{country=\"US\"})\n      number of US add-to-cart events (a user can count many times).\n\n  sum(purchase{country=\"US\"}, amount)\n      total purchase amount from US purchase events.\n\n  avg(req_dur{tier!=\"free\"}, ms) without (region)\n      mean request duration for non-free tiers, one series per region-excluded\n      label combination.\n\n  p99(req_dur{route=~\"/api/.*\"}, ms) by (route, status)\n      99th-percentile latency of /api/* requests, split by route and status.\n\n  unique(login{method=\"sso\"}, device_id)\n      distinct SSO devices seen (display-only; an experiment would use per-user avg).\n\n  retention_7d(session_start)\n      share of users who started a new session within 7 days.\n";
+
+/**
+ * Every custom (non-spec) operation, in surface order. The CLI and MCP each
+ * project this with a thin adapter so the sugar commands stay in sync.
+ */
+declare const customOperations: CustomOp[];
+/**
+ * Group-level help for custom-op groups that aren't backed by an OpenAPI tag.
+ * `metrics` is a spec tag (its group is created — and described — by the
+ * generated tree), so only `docs` needs an entry here; without it the CLI would
+ * label the group the bare `"docs commands"`.
+ */
+declare const customGroups: CustomGroup[];
+
+export { type CustomGroup, type CustomOp, CustomOpError, type CustomParam, type CustomParamType, METRIC_GRAMMAR, customGroups, customOperations, opId };

package/dist/custom.js

@@ -0,0 +1,300 @@
+// src/custom/grammar.ts
+var METRIC_GRAMMAR = `SHIPEASY METRIC QUERY DSL
+=========================
+
+A metric is ONE aggregation over ONE event stream. This DSL is the string you
+pass to \`metrics create --query "..."\` (equivalently the typed \`query_ir\`).
+There is no arithmetic, no formulas across events, no subqueries \u2014 one event
+selector, one aggregation, an optional group-by.
+
+
+GRAMMAR (BNF)
+-------------
+  Query         := AggFunc "(" Selector ("," Identifier)? ")" GroupBy?
+  AggFunc       := "count_users" | "count" | "sum" | "avg" | "min" | "max"
+                 | "unique" | "p50" | "p75" | "p90" | "p95" | "p99" | "p999"
+                 | "retention_" <N> "d"                       (N = 1..90)
+  Selector      := Identifier ("{" Filter ("," Filter)* ","? "}")?
+  Filter        := Identifier MatchOp StringLiteral
+  MatchOp       := "=" | "!=" | "=~" | "!~"
+  GroupBy       := ("by" | "without") "(" Identifier ("," Identifier)* ","? ")"
+  StringLiteral := double-quoted; \\" is a literal quote, \\\\ is a backslash
+  Identifier    := [A-Za-z_][A-Za-z0-9_]*                     (case-sensitive)
+
+  The trailing Identifier after the selector \u2014 "(" Selector "," Identifier ")" \u2014
+  is the VALUE LABEL: the numeric event label the aggregation reduces. Whether it
+  is required, optional, or forbidden depends on the aggregation (see below).
+
+
+AGGREGATIONS
+------------
+  Function        Value label   Meaning                         In experiments
+  --------------  ------------  ------------------------------  ---------------
+  count_users     forbidden     distinct users who fired it     exact
+  count           forbidden     number of events (rows)         exact
+  sum(e, v)       required      \u03A3 of numeric label v            exact
+  avg(e, v)       required      mean of label v                 exact
+  retention_Nd(e) forbidden     % of users who returned         exact
+                                within N days (N = 1..90)
+  min(e, v)       required      minimum of label v              approx \u2192 avg *
+  max(e, v)       required      maximum of label v              approx \u2192 avg *
+  unique(e, v)    required      distinct values of label v      approx \u2192 avg *
+  p50 \u2026 p999(e,v) required      quantile of v (50/75/90/        approx \u2192 avg *
+                                95/99/99.9th percentile)
+
+  * Display-only aggregations. The experiment t-test needs a per-user mean and
+    variance, so min/max/unique/quantile are computed exactly on dashboards but
+    collapse to a per-user \`avg\` when used as an experiment metric. If you need
+    an exact experiment metric, pick count_users / count / sum / avg / retention.
+
+  "count" is the DSL spelling of the internal count_events (one per matching
+  row); "count_users" is unique-by-user. Getting these two confused is the most
+  common mistake \u2014 count double-counts a user who fired the event twice.
+
+
+SELECTOR & FILTERS
+------------------
+  The selector is the event name plus an optional \`{ ... }\` filter set that
+  narrows which events count. Each filter compares an event LABEL to a quoted
+  string:
+
+    =   equal            !=   not equal
+    =~  regex match      !~   regex NOT match
+
+  - Values are ALWAYS double-quoted strings, even for numeric labels \u2014 they are
+    coerced on the server (\`amount=~"^1[0-9]$"\`, \`status="200"\`).
+  - Multiple filters are AND-ed: \`{country="US", tier!="free"}\`.
+  - Every filter label AND the value label must be a label DECLARED on the source
+    event. Undeclared labels are a validation error, not a silent no-match.
+
+
+GROUP-BY
+--------
+  Splits the result into one series per label combination.
+    by (a, b)       one series per distinct (a, b) \u2014 keep only these labels
+    without (a, b)  group by all declared labels EXCEPT a, b
+
+  NOTE: group-by is a DASHBOARD-only feature. In an experiment the group-by is
+  ignored \u2014 a per-user reducer is applied across the whole arm instead.
+
+
+NOT SUPPORTED (will fail to parse)
+----------------------------------
+  - arithmetic / ratios / formulas: \`count(a) / count(b)\`
+  - more than one event per query
+  - arbitrary quantiles (only the fixed p50/p75/p90/p95/p99/p999)
+  - unquoted or numeric filter values: \`{status=200}\`  \u2192 must be \`"200"\`
+  - trailing tokens after the query
+
+
+EXAMPLES  (query  \u2014  what it measures)
+--------------------------------------
+  count_users(checkout_completed)
+      distinct users who completed checkout.
+
+  count(add_to_cart{country="US"})
+      number of US add-to-cart events (a user can count many times).
+
+  sum(purchase{country="US"}, amount)
+      total purchase amount from US purchase events.
+
+  avg(req_dur{tier!="free"}, ms) without (region)
+      mean request duration for non-free tiers, one series per region-excluded
+      label combination.
+
+  p99(req_dur{route=~"/api/.*"}, ms) by (route, status)
+      99th-percentile latency of /api/* requests, split by route and status.
+
+  unique(login{method="sso"}, device_id)
+      distinct SSO devices seen (display-only; an experiment would use per-user avg).
+
+  retention_7d(session_start)
+      share of users who started a new session within 7 days.
+`;
+var grammarOp = {
+  group: ["metrics"],
+  name: "grammar",
+  summary: "Print the metric query DSL grammar",
+  description: "Print the full metric query DSL reference \u2014 grammar, aggregation semantics, filter/group-by rules, and glossed examples \u2014 used to author `metrics create --query`.",
+  params: [],
+  examples: [{ run: "shipeasy metrics grammar" }],
+  run: () => ({ grammar: METRIC_GRAMMAR })
+};
+
+// src/custom/types.ts
+var CustomOpError = class extends Error {
+  constructor(message, status = 400) {
+    super(message);
+    this.status = status;
+    this.name = "CustomOpError";
+  }
+  status;
+};
+var opId = (op) => [...op.group, op.name].join(".");
+
+// src/custom/docs.ts
+var SDK_REPOS = {
+  typescript: { owner: "shipeasy-ai", repo: "sdk" },
+  javascript: { owner: "shipeasy-ai", repo: "sdk" },
+  node: { owner: "shipeasy-ai", repo: "sdk" },
+  ts: { owner: "shipeasy-ai", repo: "sdk" },
+  python: { owner: "shipeasy-ai", repo: "sdk-python" },
+  go: { owner: "shipeasy-ai", repo: "sdk-go" },
+  java: { owner: "shipeasy-ai", repo: "sdk-java" },
+  kotlin: { owner: "shipeasy-ai", repo: "sdk-kotlin" },
+  php: { owner: "shipeasy-ai", repo: "sdk-php" },
+  swift: { owner: "shipeasy-ai", repo: "sdk-swift" },
+  ruby: { owner: "shipeasy-ai", repo: "sdk-ruby" }
+};
+var SDK_ENUM = Object.keys(SDK_REPOS);
+var DEFAULT_MANIFEST = {
+  schemaVersion: 2,
+  sdk: "default",
+  placeholders: ["RESOURCE_NAME"],
+  skill: "skill/SKILL.md",
+  pages: { overview: "pages/overview.md", installation: "pages/installation.md" },
+  snippets: { release: { flags: "snippets/release/flags.md" } }
+};
+var DEFAULT_CONTENT = {
+  "pages/overview.md": "# Shipeasy SDK\n\nThis SDK has not published its `/docs/` folder yet. See https://docs.shipeasy.ai for the full reference.",
+  "pages/installation.md": "# Installation\n\nInstall the Shipeasy SDK for your language, then call `shipeasy({ serverKey })` (server) or `shipeasy({ clientKey })` (browser).",
+  "snippets/release/flags.md": "```\nconst on = await client.checkGate(user, '{{RESOURCE_NAME}}');\n```",
+  "skill/SKILL.md": "---\nname: shipeasy-sdk\ndescription: Use the Shipeasy SDK for flags, experiments, configs, and i18n.\n---\n\nThis SDK has not published a skill yet. See https://docs.shipeasy.ai."
+};
+function requireSdk(sdk) {
+  const s = typeof sdk === "string" ? sdk.trim() : "";
+  if (!s)
+    throw new CustomOpError(
+      `No SDK given and none recorded in .shipeasy. Pass --sdk <lang> (one of: ${SDK_ENUM.join(", ")}), or run \`shipeasy detect\` in the project to record its sdk.`,
+      400
+    );
+  return s;
+}
+function repoFor(sdk) {
+  const r = SDK_REPOS[sdk.toLowerCase()];
+  if (!r) throw new CustomOpError(`Unknown SDK '${sdk}'. One of: ${SDK_ENUM.join(", ")}`, 400);
+  return r;
+}
+function pagesBase(sdk) {
+  const { owner, repo } = repoFor(sdk);
+  return `https://${owner}.github.io/${repo}`;
+}
+async function fetchText(url) {
+  const res = await fetch(url);
+  if (!res.ok) return null;
+  return res.text();
+}
+async function loadManifest(sdk) {
+  const text = await fetchText(`${pagesBase(sdk)}/manifest.json`);
+  if (!text) return { manifest: DEFAULT_MANIFEST, fallback: true };
+  try {
+    return { manifest: JSON.parse(text), fallback: false };
+  } catch {
+    return { manifest: DEFAULT_MANIFEST, fallback: true };
+  }
+}
+function resolvePath(manifest, handle) {
+  if (handle.endsWith(".md")) return handle;
+  if (manifest.pages?.[handle]) return manifest.pages[handle];
+  if (handle.includes("/")) {
+    const [group, resource] = handle.split("/", 2);
+    const p = manifest.snippets?.[group]?.[resource];
+    if (p) return p;
+  }
+  throw new CustomOpError(
+    `Doc '${handle}' not found. Run 'docs list --sdk <lang>' to see available pages and snippets.`,
+    404
+  );
+}
+function substitute(body, manifest, args) {
+  let out = body;
+  for (const ph of manifest.placeholders ?? []) {
+    const value = args[ph] ?? (ph === "RESOURCE_NAME" ? args.name : void 0) ?? (ph === "FRAMEWORK" ? args.framework : void 0);
+    if (value !== void 0) out = out.replaceAll(`{{${ph}}}`, value);
+  }
+  return out;
+}
+var docsOps = [
+  {
+    group: ["docs"],
+    name: "list",
+    summary: "List an SDK's documentation tree",
+    description: "Fetch an SDK's `/docs/manifest.json` and return the doc tree \u2014 feature pages, nested snippet groups, and whether an installable skill exists.",
+    params: [{ name: "sdk", type: "string", description: "SDK language. Defaults to the `sdk` recorded in the nearest `.shipeasy` when omitted.", required: false, enum: SDK_ENUM }],
+    examples: [{ run: "shipeasy docs list --sdk python" }],
+    run: async (args) => {
+      const sdk = requireSdk(args.sdk);
+      const { manifest, fallback } = await loadManifest(sdk);
+      return {
+        sdk,
+        fallback,
+        pages: Object.keys(manifest.pages ?? {}),
+        snippets: Object.fromEntries(
+          Object.entries(manifest.snippets ?? {}).map(([g, r]) => [g, Object.keys(r)])
+        ),
+        skill: Boolean(manifest.skill)
+      };
+    }
+  },
+  {
+    group: ["docs"],
+    name: "get",
+    summary: "Fetch one SDK doc page or snippet",
+    description: "Fetch one feature page (`flags`, `experiments`, \u2026) or nested snippet (`release/experiments`, \u2026), substituting declared {{placeholders}} from caller args.",
+    params: [
+      { name: "sdk", type: "string", description: "SDK language. Defaults to the `sdk` recorded in the nearest `.shipeasy` when omitted.", required: false, enum: SDK_ENUM },
+      { name: "path", type: "string", description: "Page key or snippet 'group/resource'.", required: true, positional: true },
+      { name: "framework", type: "string", description: "Framework hint (substitutes {{FRAMEWORK}})." },
+      { name: "name", type: "string", description: "Resource name (substitutes {{RESOURCE_NAME}})." }
+    ],
+    examples: [
+      { note: "A feature page", run: "shipeasy docs get --sdk python experiments" },
+      { note: "A nested snippet", run: "shipeasy docs get --sdk typescript release/flags --name checkout_v2" }
+    ],
+    run: async (args) => {
+      const sdk = requireSdk(args.sdk);
+      const { manifest, fallback } = await loadManifest(sdk);
+      const path = resolvePath(manifest, args.path);
+      const body = fallback ? DEFAULT_CONTENT[path] : await fetchText(`${pagesBase(sdk)}/${path}`) ?? void 0;
+      if (body === void 0) throw new CustomOpError(`Doc '${path}' could not be fetched for '${sdk}'.`, 404);
+      return { sdk, path, fallback, content: substitute(body, manifest, args) };
+    }
+  },
+  {
+    group: ["docs"],
+    name: "skill",
+    summary: "Fetch an SDK's installable LLM skill",
+    description: "Fetch the SDK's `skill/SKILL.md` (frontmatter intact) so an agent can install it verbatim. The CLI `--install` writes it locally (a consumer fs side-effect).",
+    params: [
+      { name: "sdk", type: "string", description: "SDK language. Defaults to the `sdk` recorded in the nearest `.shipeasy` when omitted.", required: false, enum: SDK_ENUM },
+      { name: "install", type: "boolean", description: "CLI only: write the skill to the local agent skills dir." }
+    ],
+    examples: [{ run: "shipeasy docs skill --sdk python" }],
+    run: async (args) => {
+      const sdk = requireSdk(args.sdk);
+      const { manifest, fallback } = await loadManifest(sdk);
+      const skillPath = manifest.skill ?? "skill/SKILL.md";
+      const content = fallback ? DEFAULT_CONTENT[skillPath] : await fetchText(`${pagesBase(sdk)}/${skillPath}`) ?? void 0;
+      if (content === void 0) throw new CustomOpError(`No skill published for '${sdk}'.`, 404);
+      return { sdk, skillPath, fallback, content };
+    }
+  }
+];
+
+// src/custom/index.ts
+var customOperations = [grammarOp, ...docsOps];
+var customGroups = [
+  {
+    group: ["docs"],
+    summary: "SDK docs: fetch a language SDK's published docs \u2014 its page tree, feature pages, code snippets, and installable agent skill.",
+    description: "SDK docs \u2014 a read-only fetcher over each language SDK's `/docs/` folder, published to plain GitHub Pages (latest only; no backend, no version arg). Point it at an SDK with `--sdk <lang>` (one of: typescript, python, go, java, kotlin, php, swift, ruby) or let it default to the `sdk` recorded in the nearest `.shipeasy`.\n\n**Commands.**\n- `list` \u2014 the SDK's doc tree: feature pages, nested snippet groups, and whether an installable skill exists.\n- `get <path>` \u2014 one feature page (`flags`, `experiments`, \u2026) or nested snippet (`release/flags`), with `{{placeholders}}` substituted from `--name`/`--framework`.\n- `skill` \u2014 the SDK's installable LLM skill (`SKILL.md`); `--install` writes it into your agent's skills dir.\n\nSDKs that haven't adopted the doc standard yet fall back to a built-in default doc set, flagged `fallback: true` in the output."
+  }
+];
+export {
+  CustomOpError,
+  METRIC_GRAMMAR,
+  customGroups,
+  customOperations,
+  opId
+};
+//# sourceMappingURL=custom.js.map