@runcofactor/cli 0.10.0 → 0.13.0

package/dist/feature-flag-XG26RURR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/feature-flag.ts"],"sourcesContent":["/**\n * CLI Feature Flag Management\n *\n * Allows superadmins to manage feature flags via the CLI.\n */\n\nimport process from \"node:process\";\nimport { resolveConfig, getArgValue, hasFlag } from \"./auth.js\";\nimport {\n  type LifecycleStage,\n  toLifecycleLabel,\n  parseLifecycleStage,\n  apiRequest,\n  fetchList,\n} from \"./cli-helpers.js\";\n\ntype FeatureFlag = {\n  id: string;\n  name: string;\n  description: string | null;\n  lifecycleStage: LifecycleStage;\n  finalValue: boolean | null;\n  createdAt: string;\n  lastToggledAt: string;\n  isStale: boolean;\n  productCardId: string | null;\n  productTitle: string | null;\n  organizations?: Array<{\n    gateId: string;\n    orgId: string;\n    orgName: string;\n    createdAt: string;\n  }>;\n  users?: Array<{\n    gateId: string;\n    userId: string;\n    userEmail: string | null;\n    createdAt: string;\n  }>;\n};\n\ntype FlagApiResponse = {\n  ok: boolean;\n  error?: string;\n  flag?: FeatureFlag;\n};\n\ntype ProductCard = {\n  id: string;\n  title: string;\n  stage: string;\n  orgId: string;\n  orgName: string;\n};\n\nfunction fetchFlags(apiUrl: string, token: string): Promise<FeatureFlag[]> {\n  return fetchList<FeatureFlag>(apiUrl, token, \"/superadmin/feature-flags\", \"flags\");\n}\n\nasync function handleList(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const jsonOutput = hasFlag(argv, \"--json\");\n  const flags = await fetchFlags(apiUrl, token);\n\n  if (jsonOutput) {\n    console.log(JSON.stringify(flags, null, 2));\n    return;\n  }\n\n  if (flags.length === 0) {\n    console.log(\"No feature flags found.\");\n    return;\n  }\n\n  for (const flag of flags) {\n    const orgCount = flag.organizations?.length ?? 0;\n    const userCount = flag.users?.length ?? 0;\n    const lifecycle = `lifecycle=${toLifecycleLabel(flag.lifecycleStage)}`;\n    const finalValue =\n      flag.lifecycleStage === \"active\" ? \"\" : ` final=${flag.finalValue === true ? \"true\" : \"false\"}`;\n    const stale = flag.isStale ? \" [STALE]\" : \"\";\n    const product = flag.productCardId\n      ? ` product=${flag.productTitle ?? flag.productCardId}`\n      : \"\";\n    console.log(`  ${flag.name}  ${flag.description ?? \"\"}  (${lifecycle}${finalValue})  [orgs=${orgCount}, users=${userCount}]${product}${stale}`);\n  }\n}\n\nasync function handleCreate(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const name = argv[0];\n  if (!name || name.startsWith(\"--\")) {\n    console.error(\"Error: Missing flag name.\");\n    console.error(\"Usage: canary feature-flag create <name> [--description <text>] [--product <productCardId>]\");\n    process.exit(1);\n  }\n\n  const description = getArgValue(argv, \"--description\") ?? null;\n  const productCardId = getArgValue(argv, \"--product\") ?? null;\n  const result = await apiRequest<FlagApiResponse>(apiUrl, token, \"POST\", \"/superadmin/feature-flags\", {\n    name,\n    description,\n    productCardId,\n  });\n\n  if (!result.ok) {\n    console.error(`Error: ${result.error}`);\n    process.exit(1);\n  }\n\n  console.log(`Created feature flag: ${name}${productCardId ? ` (product ${productCardId})` : \"\"}`);\n}\n\nasync function handleProduct(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const name = argv[0];\n  const productCardId = getArgValue(argv, \"--product\");\n  const clear = hasFlag(argv, \"--clear\");\n\n  if (!name || name.startsWith(\"--\")) {\n    console.error(\"Error: Missing flag name.\");\n    console.error(\"Usage: canary feature-flag product <name> (--product <productCardId> | --clear)\");\n    process.exit(1);\n  }\n\n  if ((productCardId && clear) || (!productCardId && !clear)) {\n    console.error(\"Error: Provide either --product <productCardId> or --clear.\");\n    process.exit(1);\n  }\n\n  const result = await apiRequest<FlagApiResponse & { flag?: { productTitle?: string | null } }>(\n    apiUrl, token, \"POST\",\n    `/superadmin/feature-flags/${encodeURIComponent(name)}/product`,\n    { productCardId: clear ? null : productCardId }\n  );\n\n  if (!result.ok) {\n    console.error(`Error: ${result.error}`);\n    process.exit(1);\n  }\n\n  console.log(\n    clear\n      ? `Cleared product link for ${name}`\n      : `Linked ${name} to product ${result.flag?.productTitle ?? productCardId}`\n  );\n}\n\nasync function handleProducts(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const jsonOutput = hasFlag(argv, \"--json\");\n  const search = getArgValue(argv, \"--search\");\n  const path = search\n    ? `/superadmin/product-cards?search=${encodeURIComponent(search)}`\n    : \"/superadmin/product-cards\";\n  const products = await fetchList<ProductCard>(apiUrl, token, path, \"products\");\n\n  if (jsonOutput) {\n    console.log(JSON.stringify(products, null, 2));\n    return;\n  }\n\n  if (products.length === 0) {\n    console.log(\"No product cards found.\");\n    return;\n  }\n\n  for (const product of products) {\n    console.log(`  ${product.id}  ${product.title}  (stage=${product.stage}, org=${product.orgName})`);\n  }\n}\n\nasync function handleDelete(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const name = argv[0];\n  if (!name || name.startsWith(\"--\")) {\n    console.error(\"Error: Missing flag name.\");\n    console.error(\"Usage: canary feature-flag delete <name>\");\n    process.exit(1);\n  }\n\n  const result = await apiRequest<FlagApiResponse>(\n    apiUrl, token, \"DELETE\", `/superadmin/feature-flags/${encodeURIComponent(name)}`\n  );\n\n  if (!result.ok) {\n    console.error(`Error: ${result.error}`);\n    process.exit(1);\n  }\n\n  console.log(`Deleted feature flag: ${name}`);\n}\n\nasync function handleEnable(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const name = argv[0];\n  const orgId = getArgValue(argv, \"--org\");\n  const userId = getArgValue(argv, \"--user\");\n\n  if (!name || name.startsWith(\"--\")) {\n    console.error(\"Error: Missing flag name.\");\n    console.error(\"Usage: canary feature-flag enable <name> (--org <orgId> | --user <userId>)\");\n    process.exit(1);\n  }\n\n  if (orgId && userId) {\n    console.error(\"Error: Provide either --org or --user, not both.\");\n    process.exit(1);\n  }\n\n  if (!orgId && !userId) {\n    console.error(\"Error: Provide either --org <orgId> or --user <userId>.\");\n    console.error(\"Usage: canary feature-flag enable <name> (--org <orgId> | --user <userId>)\");\n    process.exit(1);\n  }\n\n  if (orgId) {\n    const result = await apiRequest<FlagApiResponse>(\n      apiUrl, token, \"POST\",\n      `/superadmin/feature-flags/${encodeURIComponent(name)}/organizations/${encodeURIComponent(orgId)}`\n    );\n\n    if (!result.ok) {\n      console.error(`Error: ${result.error}`);\n      process.exit(1);\n    }\n\n    console.log(`Enabled ${name} for org ${orgId}`);\n  } else {\n    const result = await apiRequest<FlagApiResponse>(\n      apiUrl, token, \"POST\",\n      `/superadmin/feature-flags/${encodeURIComponent(name)}/users/${encodeURIComponent(userId!)}`\n    );\n\n    if (!result.ok) {\n      console.error(`Error: ${result.error}`);\n      process.exit(1);\n    }\n\n    console.log(`Enabled ${name} for user ${userId}`);\n  }\n}\n\nasync function handleDisable(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const name = argv[0];\n  const orgId = getArgValue(argv, \"--org\");\n  const userId = getArgValue(argv, \"--user\");\n\n  if (!name || name.startsWith(\"--\")) {\n    console.error(\"Error: Missing flag name.\");\n    console.error(\"Usage: canary feature-flag disable <name> (--org <orgId> | --user <userId>)\");\n    process.exit(1);\n  }\n\n  if (orgId && userId) {\n    console.error(\"Error: Provide either --org or --user, not both.\");\n    process.exit(1);\n  }\n\n  if (!orgId && !userId) {\n    console.error(\"Error: Provide either --org <orgId> or --user <userId>.\");\n    console.error(\"Usage: canary feature-flag disable <name> (--org <orgId> | --user <userId>)\");\n    process.exit(1);\n  }\n\n  if (orgId) {\n    const result = await apiRequest<FlagApiResponse>(\n      apiUrl, token, \"DELETE\",\n      `/superadmin/feature-flags/${encodeURIComponent(name)}/organizations/${encodeURIComponent(orgId)}`\n    );\n\n    if (!result.ok) {\n      console.error(`Error: ${result.error}`);\n      process.exit(1);\n    }\n\n    console.log(`Disabled ${name} for org ${orgId}`);\n  } else {\n    const result = await apiRequest<FlagApiResponse>(\n      apiUrl, token, \"DELETE\",\n      `/superadmin/feature-flags/${encodeURIComponent(name)}/users/${encodeURIComponent(userId!)}`\n    );\n\n    if (!result.ok) {\n      console.error(`Error: ${result.error}`);\n      process.exit(1);\n    }\n\n    console.log(`Disabled ${name} for user ${userId}`);\n  }\n}\n\nasync function handleLifecycle(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const name = argv[0];\n\n  if (!name || name.startsWith(\"--\")) {\n    console.error(\"Error: Missing flag name.\");\n    console.error(\"Usage: canary feature-flag lifecycle <name> --stage <active|deprecated|ready_for_cleanup> [--final-value true|false]\");\n    process.exit(1);\n  }\n\n  const stage = parseLifecycleStage(argv);\n  const rawFinalValue = getArgValue(argv, \"--final-value\");\n  const clearFinalValue = hasFlag(argv, \"--clear-final-value\");\n\n  if (rawFinalValue !== undefined && clearFinalValue) {\n    console.error(\"Error: use either --final-value or --clear-final-value, not both.\");\n    process.exit(1);\n  }\n\n  let finalValue: boolean | undefined = undefined;\n\n  if (stage === \"active\") {\n    if (rawFinalValue !== undefined) {\n      console.error(\"Error: active stage does not accept --final-value.\");\n      process.exit(1);\n    }\n    finalValue = undefined;\n  } else {\n    if (clearFinalValue) {\n      console.error(\"Error: --clear-final-value can only be used with --stage active.\");\n      process.exit(1);\n    }\n    if (!rawFinalValue) {\n      console.error(\"Error: --final-value true|false is required for deprecated or ready_for_cleanup.\");\n      process.exit(1);\n    }\n    if (rawFinalValue !== \"true\" && rawFinalValue !== \"false\") {\n      console.error(\"Error: --final-value must be true or false.\");\n      process.exit(1);\n    }\n    finalValue = rawFinalValue === \"true\";\n  }\n\n  const result = await apiRequest<FlagApiResponse>(\n    apiUrl, token, \"POST\",\n    `/superadmin/feature-flags/${encodeURIComponent(name)}/lifecycle`,\n    { stage, finalValue }\n  );\n\n  if (!result.ok || !result.flag) {\n    console.error(`Error: ${result.error ?? \"Failed to update lifecycle\"}`);\n    process.exit(1);\n  }\n\n  const final =\n    result.flag.lifecycleStage === \"active\"\n      ? \"(none)\"\n      : result.flag.finalValue === true\n        ? \"true\"\n        : \"false\";\n  console.log(`Updated lifecycle for ${name}: stage=${toLifecycleLabel(result.flag.lifecycleStage)}, final=${final}`);\n}\n\nfunction printFeatureFlagHelp(): void {\n  console.log(\n    [\n      \"Usage: canary feature-flag <sub-command> [options]\",\n      \"\",\n      \"Sub-commands:\",\n      \"  list                                          List all feature flags\",\n      \"  create <name> [--description <text>] [--product <productCardId>]\",\n      \"                                                Create a new flag (optionally linked to a product)\",\n      \"  delete <name>                                 Delete a flag and all its gates\",\n      \"  enable <name> (--org <orgId> | --user <userId>)\",\n      \"                                                Enable a flag for an org or user\",\n      \"  disable <name> (--org <orgId> | --user <userId>)\",\n      \"                                                Disable a flag for an org or user (kept as 'was enabled' history)\",\n      \"  lifecycle <name> --stage <stage> [--final-value true|false]\",\n      \"                                                Mark lifecycle + final value\",\n      \"  product <name> (--product <productCardId> | --clear)\",\n      \"                                                Link/unlink a flag to a product board item\",\n      \"  products [--search <text>]                    List product board items (find product card ids)\",\n      \"\",\n      \"Stages: active, deprecated, ready_for_cleanup\",\n      \"\",\n      \"Options:\",\n      \"  --org <orgId>              Target organization\",\n      \"  --user <userId>            Target user\",\n      \"  --product <productCardId>  Product board item (cards.id) to link\",\n      \"  --clear                    Clear the product link (product sub-command only)\",\n      \"  --search <text>            Filter product cards by title (products sub-command only)\",\n      \"  --final-value <true|false>  Final value for deprecated/ready_for_cleanup\",\n      \"  --clear-final-value         Clear final value (only valid with --stage active)\",\n      \"  --env <env>                 Target environment (prod, dev, local)\",\n      \"  --json                      Output as JSON (list only)\",\n      \"  --api-url <url>             API URL override (takes precedence over --env)\",\n      \"  --token <key>               API token override\",\n    ].join(\"\\n\")\n  );\n}\n\nexport async function runFeatureFlag(argv: string[]): Promise<void> {\n  const [subCommand, ...rest] = argv;\n\n  if (!subCommand || subCommand === \"help\" || hasFlag(argv, \"--help\", \"-h\")) {\n    printFeatureFlagHelp();\n    return;\n  }\n\n  const { apiUrl, token } = await resolveConfig(argv);\n\n  switch (subCommand) {\n    case \"list\":\n      await handleList(rest, apiUrl, token);\n      break;\n    case \"create\":\n      await handleCreate(rest, apiUrl, token);\n      break;\n    case \"delete\":\n      await handleDelete(rest, apiUrl, token);\n      break;\n    case \"enable\":\n      await handleEnable(rest, apiUrl, token);\n      break;\n    case \"disable\":\n      await handleDisable(rest, apiUrl, token);\n      break;\n    case \"lifecycle\":\n      await handleLifecycle(rest, apiUrl, token);\n      break;\n    case \"product\":\n      await handleProduct(rest, apiUrl, token);\n      break;\n    case \"products\":\n      await handleProducts(rest, apiUrl, token);\n      break;\n    default:\n      console.error(`Unknown sub-command: ${subCommand}`);\n      printFeatureFlagHelp();\n      process.exit(1);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAMA,OAAO,aAAa;AAiDpB,SAAS,WAAW,QAAgB,OAAuC;AACzE,SAAO,UAAuB,QAAQ,OAAO,6BAA6B,OAAO;AACnF;AAEA,eAAe,WAAW,MAAgB,QAAgB,OAA8B;AACtF,QAAM,aAAa,QAAQ,MAAM,QAAQ;AACzC,QAAM,QAAQ,MAAM,WAAW,QAAQ,KAAK;AAE5C,MAAI,YAAY;AACd,YAAQ,IAAI,KAAK,UAAU,OAAO,MAAM,CAAC,CAAC;AAC1C;AAAA,EACF;AAEA,MAAI,MAAM,WAAW,GAAG;AACtB,YAAQ,IAAI,yBAAyB;AACrC;AAAA,EACF;AAEA,aAAW,QAAQ,OAAO;AACxB,UAAM,WAAW,KAAK,eAAe,UAAU;AAC/C,UAAM,YAAY,KAAK,OAAO,UAAU;AACxC,UAAM,YAAY,aAAa,iBAAiB,KAAK,cAAc,CAAC;AACpE,UAAM,aACJ,KAAK,mBAAmB,WAAW,KAAK,UAAU,KAAK,eAAe,OAAO,SAAS,OAAO;AAC/F,UAAM,QAAQ,KAAK,UAAU,aAAa;AAC1C,UAAM,UAAU,KAAK,gBACjB,YAAY,KAAK,gBAAgB,KAAK,aAAa,KACnD;AACJ,YAAQ,IAAI,KAAK,KAAK,IAAI,KAAK,KAAK,eAAe,EAAE,MAAM,SAAS,GAAG,UAAU,YAAY,QAAQ,WAAW,SAAS,IAAI,OAAO,GAAG,KAAK,EAAE;AAAA,EAChJ;AACF;AAEA,eAAe,aAAa,MAAgB,QAAgB,OAA8B;AACxF,QAAM,OAAO,KAAK,CAAC;AACnB,MAAI,CAAC,QAAQ,KAAK,WAAW,IAAI,GAAG;AAClC,YAAQ,MAAM,2BAA2B;AACzC,YAAQ,MAAM,6FAA6F;AAC3G,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,QAAM,cAAc,YAAY,MAAM,eAAe,KAAK;AAC1D,QAAM,gBAAgB,YAAY,MAAM,WAAW,KAAK;AACxD,QAAM,SAAS,MAAM,WAA4B,QAAQ,OAAO,QAAQ,6BAA6B;AAAA,IACnG;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAED,MAAI,CAAC,OAAO,IAAI;AACd,YAAQ,MAAM,UAAU,OAAO,KAAK,EAAE;AACtC,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,UAAQ,IAAI,yBAAyB,IAAI,GAAG,gBAAgB,aAAa,aAAa,MAAM,EAAE,EAAE;AAClG;AAEA,eAAe,cAAc,MAAgB,QAAgB,OAA8B;AACzF,QAAM,OAAO,KAAK,CAAC;AACnB,QAAM,gBAAgB,YAAY,MAAM,WAAW;AACnD,QAAM,QAAQ,QAAQ,MAAM,SAAS;AAErC,MAAI,CAAC,QAAQ,KAAK,WAAW,IAAI,GAAG;AAClC,YAAQ,MAAM,2BAA2B;AACzC,YAAQ,MAAM,iFAAiF;AAC/F,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,MAAK,iBAAiB,SAAW,CAAC,iBAAiB,CAAC,OAAQ;AAC1D,YAAQ,MAAM,6DAA6D;AAC3E,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,QAAM,SAAS,MAAM;AAAA,IACnB;AAAA,IAAQ;AAAA,IAAO;AAAA,IACf,6BAA6B,mBAAmB,IAAI,CAAC;AAAA,IACrD,EAAE,eAAe,QAAQ,OAAO,cAAc;AAAA,EAChD;AAEA,MAAI,CAAC,OAAO,IAAI;AACd,YAAQ,MAAM,UAAU,OAAO,KAAK,EAAE;AACtC,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,UAAQ;AAAA,IACN,QACI,4BAA4B,IAAI,KAChC,UAAU,IAAI,eAAe,OAAO,MAAM,gBAAgB,aAAa;AAAA,EAC7E;AACF;AAEA,eAAe,eAAe,MAAgB,QAAgB,OAA8B;AAC1F,QAAM,aAAa,QAAQ,MAAM,QAAQ;AACzC,QAAM,SAAS,YAAY,MAAM,UAAU;AAC3C,QAAM,OAAO,SACT,oCAAoC,mBAAmB,MAAM,CAAC,KAC9D;AACJ,QAAM,WAAW,MAAM,UAAuB,QAAQ,OAAO,MAAM,UAAU;AAE7E,MAAI,YAAY;AACd,YAAQ,IAAI,KAAK,UAAU,UAAU,MAAM,CAAC,CAAC;AAC7C;AAAA,EACF;AAEA,MAAI,SAAS,WAAW,GAAG;AACzB,YAAQ,IAAI,yBAAyB;AACrC;AAAA,EACF;AAEA,aAAW,WAAW,UAAU;AAC9B,YAAQ,IAAI,KAAK,QAAQ,EAAE,KAAK,QAAQ,KAAK,YAAY,QAAQ,KAAK,SAAS,QAAQ,OAAO,GAAG;AAAA,EACnG;AACF;AAEA,eAAe,aAAa,MAAgB,QAAgB,OAA8B;AACxF,QAAM,OAAO,KAAK,CAAC;AACnB,MAAI,CAAC,QAAQ,KAAK,WAAW,IAAI,GAAG;AAClC,YAAQ,MAAM,2BAA2B;AACzC,YAAQ,MAAM,0CAA0C;AACxD,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,QAAM,SAAS,MAAM;AAAA,IACnB;AAAA,IAAQ;AAAA,IAAO;AAAA,IAAU,6BAA6B,mBAAmB,IAAI,CAAC;AAAA,EAChF;AAEA,MAAI,CAAC,OAAO,IAAI;AACd,YAAQ,MAAM,UAAU,OAAO,KAAK,EAAE;AACtC,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,UAAQ,IAAI,yBAAyB,IAAI,EAAE;AAC7C;AAEA,eAAe,aAAa,MAAgB,QAAgB,OAA8B;AACxF,QAAM,OAAO,KAAK,CAAC;AACnB,QAAM,QAAQ,YAAY,MAAM,OAAO;AACvC,QAAM,SAAS,YAAY,MAAM,QAAQ;AAEzC,MAAI,CAAC,QAAQ,KAAK,WAAW,IAAI,GAAG;AAClC,YAAQ,MAAM,2BAA2B;AACzC,YAAQ,MAAM,4EAA4E;AAC1F,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,MAAI,SAAS,QAAQ;AACnB,YAAQ,MAAM,kDAAkD;AAChE,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,MAAI,CAAC,SAAS,CAAC,QAAQ;AACrB,YAAQ,MAAM,yDAAyD;AACvE,YAAQ,MAAM,4EAA4E;AAC1F,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,MAAI,OAAO;AACT,UAAM,SAAS,MAAM;AAAA,MACnB;AAAA,MAAQ;AAAA,MAAO;AAAA,MACf,6BAA6B,mBAAmB,IAAI,CAAC,kBAAkB,mBAAmB,KAAK,CAAC;AAAA,IAClG;AAEA,QAAI,CAAC,OAAO,IAAI;AACd,cAAQ,MAAM,UAAU,OAAO,KAAK,EAAE;AACtC,cAAQ,KAAK,CAAC;AAAA,IAChB;AAEA,YAAQ,IAAI,WAAW,IAAI,YAAY,KAAK,EAAE;AAAA,EAChD,OAAO;AACL,UAAM,SAAS,MAAM;AAAA,MACnB;AAAA,MAAQ;AAAA,MAAO;AAAA,MACf,6BAA6B,mBAAmB,IAAI,CAAC,UAAU,mBAAmB,MAAO,CAAC;AAAA,IAC5F;AAEA,QAAI,CAAC,OAAO,IAAI;AACd,cAAQ,MAAM,UAAU,OAAO,KAAK,EAAE;AACtC,cAAQ,KAAK,CAAC;AAAA,IAChB;AAEA,YAAQ,IAAI,WAAW,IAAI,aAAa,MAAM,EAAE;AAAA,EAClD;AACF;AAEA,eAAe,cAAc,MAAgB,QAAgB,OAA8B;AACzF,QAAM,OAAO,KAAK,CAAC;AACnB,QAAM,QAAQ,YAAY,MAAM,OAAO;AACvC,QAAM,SAAS,YAAY,MAAM,QAAQ;AAEzC,MAAI,CAAC,QAAQ,KAAK,WAAW,IAAI,GAAG;AAClC,YAAQ,MAAM,2BAA2B;AACzC,YAAQ,MAAM,6EAA6E;AAC3F,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,MAAI,SAAS,QAAQ;AACnB,YAAQ,MAAM,kDAAkD;AAChE,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,MAAI,CAAC,SAAS,CAAC,QAAQ;AACrB,YAAQ,MAAM,yDAAyD;AACvE,YAAQ,MAAM,6EAA6E;AAC3F,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,MAAI,OAAO;AACT,UAAM,SAAS,MAAM;AAAA,MACnB;AAAA,MAAQ;AAAA,MAAO;AAAA,MACf,6BAA6B,mBAAmB,IAAI,CAAC,kBAAkB,mBAAmB,KAAK,CAAC;AAAA,IAClG;AAEA,QAAI,CAAC,OAAO,IAAI;AACd,cAAQ,MAAM,UAAU,OAAO,KAAK,EAAE;AACtC,cAAQ,KAAK,CAAC;AAAA,IAChB;AAEA,YAAQ,IAAI,YAAY,IAAI,YAAY,KAAK,EAAE;AAAA,EACjD,OAAO;AACL,UAAM,SAAS,MAAM;AAAA,MACnB;AAAA,MAAQ;AAAA,MAAO;AAAA,MACf,6BAA6B,mBAAmB,IAAI,CAAC,UAAU,mBAAmB,MAAO,CAAC;AAAA,IAC5F;AAEA,QAAI,CAAC,OAAO,IAAI;AACd,cAAQ,MAAM,UAAU,OAAO,KAAK,EAAE;AACtC,cAAQ,KAAK,CAAC;AAAA,IAChB;AAEA,YAAQ,IAAI,YAAY,IAAI,aAAa,MAAM,EAAE;AAAA,EACnD;AACF;AAEA,eAAe,gBAAgB,MAAgB,QAAgB,OAA8B;AAC3F,QAAM,OAAO,KAAK,CAAC;AAEnB,MAAI,CAAC,QAAQ,KAAK,WAAW,IAAI,GAAG;AAClC,YAAQ,MAAM,2BAA2B;AACzC,YAAQ,MAAM,sHAAsH;AACpI,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,QAAM,QAAQ,oBAAoB,IAAI;AACtC,QAAM,gBAAgB,YAAY,MAAM,eAAe;AACvD,QAAM,kBAAkB,QAAQ,MAAM,qBAAqB;AAE3D,MAAI,kBAAkB,UAAa,iBAAiB;AAClD,YAAQ,MAAM,mEAAmE;AACjF,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,MAAI,aAAkC;AAEtC,MAAI,UAAU,UAAU;AACtB,QAAI,kBAAkB,QAAW;AAC/B,cAAQ,MAAM,oDAAoD;AAClE,cAAQ,KAAK,CAAC;AAAA,IAChB;AACA,iBAAa;AAAA,EACf,OAAO;AACL,QAAI,iBAAiB;AACnB,cAAQ,MAAM,kEAAkE;AAChF,cAAQ,KAAK,CAAC;AAAA,IAChB;AACA,QAAI,CAAC,eAAe;AAClB,cAAQ,MAAM,kFAAkF;AAChG,cAAQ,KAAK,CAAC;AAAA,IAChB;AACA,QAAI,kBAAkB,UAAU,kBAAkB,SAAS;AACzD,cAAQ,MAAM,6CAA6C;AAC3D,cAAQ,KAAK,CAAC;AAAA,IAChB;AACA,iBAAa,kBAAkB;AAAA,EACjC;AAEA,QAAM,SAAS,MAAM;AAAA,IACnB;AAAA,IAAQ;AAAA,IAAO;AAAA,IACf,6BAA6B,mBAAmB,IAAI,CAAC;AAAA,IACrD,EAAE,OAAO,WAAW;AAAA,EACtB;AAEA,MAAI,CAAC,OAAO,MAAM,CAAC,OAAO,MAAM;AAC9B,YAAQ,MAAM,UAAU,OAAO,SAAS,4BAA4B,EAAE;AACtE,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,QAAM,QACJ,OAAO,KAAK,mBAAmB,WAC3B,WACA,OAAO,KAAK,eAAe,OACzB,SACA;AACR,UAAQ,IAAI,yBAAyB,IAAI,WAAW,iBAAiB,OAAO,KAAK,cAAc,CAAC,WAAW,KAAK,EAAE;AACpH;AAEA,SAAS,uBAA6B;AACpC,UAAQ;AAAA,IACN;AAAA,MACE;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,EAAE,KAAK,IAAI;AAAA,EACb;AACF;AAEA,eAAsB,eAAe,MAA+B;AAClE,QAAM,CAAC,YAAY,GAAG,IAAI,IAAI;AAE9B,MAAI,CAAC,cAAc,eAAe,UAAU,QAAQ,MAAM,UAAU,IAAI,GAAG;AACzE,yBAAqB;AACrB;AAAA,EACF;AAEA,QAAM,EAAE,QAAQ,MAAM,IAAI,MAAM,cAAc,IAAI;AAElD,UAAQ,YAAY;AAAA,IAClB,KAAK;AACH,YAAM,WAAW,MAAM,QAAQ,KAAK;AACpC;AAAA,IACF,KAAK;AACH,YAAM,aAAa,MAAM,QAAQ,KAAK;AACtC;AAAA,IACF,KAAK;AACH,YAAM,aAAa,MAAM,QAAQ,KAAK;AACtC;AAAA,IACF,KAAK;AACH,YAAM,aAAa,MAAM,QAAQ,KAAK;AACtC;AAAA,IACF,KAAK;AACH,YAAM,cAAc,MAAM,QAAQ,KAAK;AACvC;AAAA,IACF,KAAK;AACH,YAAM,gBAAgB,MAAM,QAAQ,KAAK;AACzC;AAAA,IACF,KAAK;AACH,YAAM,cAAc,MAAM,QAAQ,KAAK;AACvC;AAAA,IACF,KAAK;AACH,YAAM,eAAe,MAAM,QAAQ,KAAK;AACxC;AAAA,IACF;AACE,cAAQ,MAAM,wBAAwB,UAAU,EAAE;AAClD,2BAAqB;AACrB,cAAQ,KAAK,CAAC;AAAA,EAClB;AACF;","names":[]}

package/dist/index.js

@@ -1,20 +1,15 @@
 import { createRequire as __cr } from "module"; const require = __cr(import.meta.url);
 import {
   runRemoteTest
-} from "./chunk-GKY2KXO5.js";
+} from "./chunk-NL7CVG56.js";
 import {
   runLogin
-} from "./chunk-QFDOWABX.js";
+} from "./chunk-Z5LUTUDN.js";
 import {
   checkForUpdate
-} from "./chunk-N7HFALX3.js";
-import {
-  installConsoleBranding,
-  version
-} from "./chunk-JICSYFRJ.js";
-import "./chunk-CLAWT7BJ.js";
-import "./chunk-WOHL4FTB.js";
-import "./chunk-SJJW77WN.js";
+} from "./chunk-VGTKUOYS.js";
+import "./chunk-ENDHMYEJ.js";
+import "./chunk-CQE46HSM.js";
 import {
   fetchOrExit,
   isSuperadminToken
@@ -27,8 +22,15 @@ import {
   readStoredAuth,
   resolveConfig,
   resolveOptionalConfig
-} from "./chunk-A4OFTUVV.js";
+} from "./chunk-PZ4LCN6K.js";
+import {
+  installConsoleBranding,
+  readBrandEnv,
+  specExtension,
+  version
+} from "./chunk-JZMJUPZP.js";
 import "./chunk-JWHYXEA2.js";
+import "./chunk-QGI4UCJX.js";
 import "./chunk-VKVL7WBN.js";
 
 // src/index.ts
@@ -436,11 +438,11 @@ async function recordCliInstrumentationFailure(argv, cliVersion, stage, error) {
 }
 
 // src/index.ts
-var loadMcp = () => import("./mcp-54IJEOUA.js").then((m) => m.runMcp);
-var loadDebugWorkflow = () => import("./debug-workflow-KOVH5GOP.js").then((m) => m.runDebugWorkflow);
-var loadRecord = () => import("./record-4TR2UIIS.js").then((m) => m.runRecord);
-var loadSession = () => import("./session-MYFNZPRP.js").then((m) => m.runSession);
-var loadLocal = () => import("./local-HICVD6PU.js").then((m) => m.runLocal);
+var loadMcp = () => import("./mcp-B5Y5CDMQ.js").then((m) => m.runMcp);
+var loadDebugWorkflow = () => import("./debug-workflow-R3RYYAXK.js").then((m) => m.runDebugWorkflow);
+var loadRecord = () => import("./record-WAO36O7G.js").then((m) => m.runRecord);
+var loadSession = () => import("./session-Y5RHU54D.js").then((m) => m.runSession);
+var loadLocal = () => import("./local-DQDTM3XA.js").then((m) => m.runLocal);
 function printVersion() {
   console.log(`canary v${version}`);
 }
@@ -460,15 +462,16 @@ function printHelp({ isSuperadmin }) {
     "  canary session <sub-command>           Manage local browser sessions",
     "  canary issues <sub-command>            Search and view issues",
     "  canary credential <sub-command>        List, create, update, and test credentials",
-    "  canary credential-template <sub-command>  Manage per-application credential templates",
+    "  canary persona <sub-command>           Manage per-application personas",
     "  canary workflow <sub-command>          Inspect workflow definitions",
-    "  canary spec <sub-command>              Author workflows from .canary.md spec files",
+    `  canary spec <sub-command>              Author workflows from ${specExtension} spec files`,
     "  canary api-catalog <sub-command>       Manage API catalog sources and endpoints",
-    "  canary skill <name>                    Install an AI agent skill template"
+    "  canary skill <name>                    Install an AI agent skill template (--name to rename)"
   ];
   lines.push("  canary release <sub-command>            Release QA gate (CI/CD)");
   lines.push(
     "  canary application <sub-command>         List and create applications, view linked repos (alias: property)",
+    "  canary environment <sub-command>        List, create, and default environments (alias: env)",
     "  canary task <sub-command>               Manage agent tasks (requires feature flag)",
     "  canary sandbox <sub-command>            Manage sandbox templates and instances",
     "  canary attachment <sub-command>          List, upload, and manage attachments",
@@ -656,7 +659,7 @@ var COMMANDS_WITH_HELP = /* @__PURE__ */ new Set([
   "api-catalog"
 ]);
 async function resolveIsSuperadmin() {
-  const envToken = process4.env.CANARY_API_TOKEN;
+  const envToken = readBrandEnv("CANARY_API_TOKEN");
   if (envToken) return isSuperadminToken(envToken);
   const tokens = await readAllStoredTokens();
   return tokens.some((t) => isSuperadminToken(t));
@@ -671,7 +674,7 @@ function normalizeExitCode(value) {
 }
 async function executeCommand(command, rest) {
   if (command === "upgrade") {
-    const { runUpgrade } = await import("./upgrade-L2VYMP2V.js");
+    const { runUpgrade } = await import("./upgrade-6ZUFETKX.js");
     await runUpgrade();
     return;
   }
@@ -700,7 +703,7 @@ async function executeCommand(command, rest) {
     return;
   }
   if (command === "install") {
-    const { runInstall } = await import("./install-DXSNWZKO.js");
+    const { runInstall } = await import("./install-FYZ3HNZK.js");
     await runInstall(rest);
     return;
   }
@@ -737,63 +740,64 @@ async function executeCommand(command, rest) {
     return;
   }
   if (command === "psql") {
-    const { runPsql } = await import("./psql-BYUUNLGG.js");
+    const { runPsql } = await import("./psql-VBZFCMNR.js");
     await runPsql(rest);
     return;
   }
   if (command === "redis") {
-    const { runRedis } = await import("./redis-35VBUYW7.js");
+    const { runRedis } = await import("./redis-DHZXHL4S.js");
     await runRedis(rest);
     return;
   }
   if (command === "release") {
-    const { runRelease } = await import("./release-OOLTUBUT.js");
+    const { runRelease } = await import("./release-STJKUKTE.js");
     await runRelease(rest);
     return;
   }
   if (command === "docs") {
-    const { runDocs } = await import("./docs-3SSORHB5.js");
+    const { runDocs } = await import("./docs-DIAFBDXQ.js");
     await runDocs(rest);
     return;
   }
   if (command === "feature-flag") {
-    const { runFeatureFlag } = await import("./feature-flag-T2LRZME3.js");
+    const { runFeatureFlag } = await import("./feature-flag-XG26RURR.js");
     await runFeatureFlag(rest);
     return;
   }
   if (command === "scenarios" || command === "scenario") {
-    const { runScenarios } = await import("./scenarios-GWLJEGHA.js");
+    const { runScenarios } = await import("./scenarios-HCIDY725.js");
     await runScenarios(rest);
     return;
   }
   if (command === "knobs") {
-    const { runKnobs } = await import("./knobs-NBINZIUB.js");
+    const { runKnobs } = await import("./knobs-A2BOBH22.js");
     await runKnobs(rest);
     return;
   }
   if (command === "issues") {
-    const { runIssues } = await import("./issues-XIZOPX6T.js");
+    const { runIssues } = await import("./issues-NNRVTJ4L.js");
     await runIssues(rest);
     return;
   }
   if (command === "credential") {
-    const { runCredential } = await import("./credential-COLTBV6D.js");
+    const { runCredential } = await import("./credential-LO2SEEHU.js");
     await runCredential(rest);
     return;
   }
-  if (command === "credential-template" || command === "credential-templates") {
-    const { runCredentialTemplate } = await import("./credential-template-EEPYFG7R.js");
+  if (command === "persona" || command === "personas" || // Backwards-compat aliases for the former "credential template" name.
+  command === "credential-template" || command === "credential-templates") {
+    const { runCredentialTemplate } = await import("./credential-template-ZN7W7734.js");
     await runCredentialTemplate(rest);
     return;
   }
   if (command === "workflow") {
-    const { runWorkflow } = await import("./workflow-XYFH5LTP.js");
+    const { runWorkflow } = await import("./workflow-2CX3ZNOQ.js");
     await runWorkflow(rest);
     return;
   }
   if (command === "spec") {
-    const { resolveConfig: resolveConfig2 } = await import("./auth-EN6NQCJY.js");
-    const { handleSpec } = await import("./spec-RA3CFEKG.js");
+    const { resolveConfig: resolveConfig2 } = await import("./auth-VUHL74FH.js");
+    const { handleSpec } = await import("./spec-LM5XHOQ5.js");
     const wantsAuth = rest[0] === "compile" || rest[0] === "pull" || rest[0] === "diff";
     if (wantsAuth) {
       const { apiUrl, token } = await resolveConfig2(rest);
@@ -804,61 +808,66 @@ async function executeCommand(command, rest) {
     return;
   }
   if (command === "api-catalog") {
-    const { resolveConfig: resolveConfig2 } = await import("./auth-EN6NQCJY.js");
-    const { runApiCatalog } = await import("./api-catalog-GFGCLVS4.js");
+    const { resolveConfig: resolveConfig2 } = await import("./auth-VUHL74FH.js");
+    const { runApiCatalog } = await import("./api-catalog-7HLEN7C2.js");
     const { apiUrl, token } = await resolveConfig2(rest);
     await runApiCatalog(rest, apiUrl, token);
     return;
   }
   if (command === "skill" || command === "skills") {
-    const { runSkill } = await import("./skill-KM34LDMO.js");
+    const { runSkill } = await import("./skill-23WAHUOB.js");
     await runSkill(rest);
     return;
   }
   if (command === "task") {
-    const { runTask } = await import("./task-IQC3YR5K.js");
+    const { runTask } = await import("./task-NLBKLD7D.js");
     await runTask(rest);
     return;
   }
   if (command === "test-suite") {
-    const { runTestSuite } = await import("./test-suite-DZNJFXDW.js");
+    const { runTestSuite } = await import("./test-suite-QCPWZ2LS.js");
     await runTestSuite(rest);
     return;
   }
   if (command === "triage") {
-    const { runTriage } = await import("./triage-ORG45R5W.js");
+    const { runTriage } = await import("./triage-TT4BMDBU.js");
     await runTriage(rest);
     return;
   }
   if (command === "application" || command === "applications" || command === "property" || command === "properties") {
-    const { runProperty } = await import("./property-UXLOLPTD.js");
+    const { runProperty } = await import("./property-NJ4SRXQG.js");
     await runProperty(rest);
     return;
   }
+  if (command === "environment" || command === "env") {
+    const { runEnvironment } = await import("./environment-RQVU4P5M.js");
+    await runEnvironment(rest);
+    return;
+  }
   if (command === "sandbox") {
-    const { runSandbox } = await import("./sandbox-XGSUU6G7.js");
+    const { runSandbox } = await import("./sandbox-DWSGLY7B.js");
     await runSandbox(rest);
     return;
   }
   if (command === "attachment" || command === "attachments") {
-    const { runAttachment } = await import("./attachment-SJC7D7FY.js");
+    const { runAttachment } = await import("./attachment-OVNQD6Z2.js");
     await runAttachment(rest);
     return;
   }
   if (command === "tag" || command === "tags") {
-    const { runTag } = await import("./tag-YY6YAABQ.js");
+    const { runTag } = await import("./tag-YSU2XXPI.js");
     await runTag(rest);
     return;
   }
   if (command === "trace") {
-    const { runTrace } = await import("./trace-HXIW7U2D.js");
+    const { runTrace } = await import("./trace-A3ZY6K26.js");
     await runTrace(rest);
     return;
   }
   if (command === "auth") {
     const sub = rest[0];
     if (sub === "doctor") {
-      const { runAuthDoctor } = await import("./doctor-OTSIWV6G.js");
+      const { runAuthDoctor } = await import("./doctor-NZPUSCRE.js");
       await runAuthDoctor(rest.slice(1));
       return;
     }