@canaryai/cli 0.2.0 → 0.2.2

package/dist/feature-flag-ZDLDYRSF.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  organizations?: Array<{\n    gateId: string;\n    orgId: string;\n    orgName: string;\n    createdAt: string;\n  }>;\n};\n\ntype FlagApiResponse = {\n  ok: boolean;\n  error?: string;\n  flag?: FeatureFlag;\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 lifecycle = `lifecycle=${toLifecycleLabel(flag.lifecycleStage)}`;\n    const finalValue =\n      flag.lifecycleStage === \"active\" ? \"\" : ` final=${flag.finalValue === true ? \"true\" : \"false\"}`;\n    console.log(`  ${flag.name}  ${flag.description ?? \"\"}  (${lifecycle}${finalValue})  [orgs=${orgCount}]`);\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>]\");\n    process.exit(1);\n  }\n\n  const description = getArgValue(argv, \"--description\") ?? null;\n  const result = await apiRequest<FlagApiResponse>(apiUrl, token, \"POST\", \"/superadmin/feature-flags\", {\n    name,\n    description,\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}`);\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\n  if (!name || name.startsWith(\"--\")) {\n    console.error(\"Error: Missing flag name.\");\n    console.error(\"Usage: canary feature-flag enable <name> --org <orgId>\");\n    process.exit(1);\n  }\n\n  if (!orgId) {\n    console.error(\"Error: Missing --org <orgId>.\");\n    console.error(\"Usage: canary feature-flag enable <name> --org <orgId>\");\n    process.exit(1);\n  }\n\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}\n\nasync function handleDisable(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const name = argv[0];\n  const orgId = getArgValue(argv, \"--org\");\n\n  if (!name || name.startsWith(\"--\")) {\n    console.error(\"Error: Missing flag name.\");\n    console.error(\"Usage: canary feature-flag disable <name> --org <orgId>\");\n    process.exit(1);\n  }\n\n  if (!orgId) {\n    console.error(\"Error: Missing --org <orgId>.\");\n    console.error(\"Usage: canary feature-flag disable <name> --org <orgId>\");\n    process.exit(1);\n  }\n\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}\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>]         Create a new flag\",\n      \"  delete <name>                                 Delete a flag and all its gates\",\n      \"  enable <name> --org <orgId>                   Enable a flag for an organization\",\n      \"  disable <name> --org <orgId>                  Disable a flag for an organization\",\n      \"  lifecycle <name> --stage <stage> [--final-value true|false]\",\n      \"                                                Mark lifecycle + final value\",\n      \"\",\n      \"Stages: active, deprecated, ready_for_cleanup\",\n      \"\",\n      \"Options:\",\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    default:\n      console.error(`Unknown sub-command: ${subCommand}`);\n      printFeatureFlagHelp();\n      process.exit(1);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.js

@@ -4,15 +4,18 @@ import {
   createTunnel,
   runLocalTest,
   runTunnel
-} from "./chunk-V7U52ISX.js";
+} from "./chunk-HOYYXZPV.js";
 import {
   ENV_URLS,
+  envToProfile,
+  getArgValue,
+  hasFlag,
   readAllStoredTokens,
-  readStoredApiUrl,
   readStoredAuth,
   readStoredToken,
+  resolveConfig,
   saveAuth
-} from "./chunk-2T64Z2NI.js";
+} from "./chunk-7R4YFGP6.js";
 import {
   __require
 } from "./chunk-DGUM43GV.js";
@@ -333,17 +336,6 @@ function countHealed(eventLogPath) {
 import process2 from "process";
 import readline from "readline";
 import { spawn as spawn2 } from "child_process";
-function envToProfile(env) {
-  if (env === "prod" || env === "production") return "production";
-  if (env === "dev") return "dev";
-  if (env === "local") return "local";
-  return env;
-}
-function getArgValue(argv, key) {
-  const index = argv.indexOf(key);
-  if (index === -1) return void 0;
-  return argv[index + 1];
-}
 function shouldOpenBrowser(argv) {
   return !argv.includes("--no-open");
 }
@@ -629,7 +621,7 @@ function getArgValue3(argv, key) {
   if (index === -1 || index >= argv.length - 1) return void 0;
   return argv[index + 1];
 }
-function hasFlag(argv, ...flags) {
+function hasFlag2(argv, ...flags) {
   return flags.some((flag) => argv.includes(flag));
 }
 function formatFailedTests(failedTests, appUrl) {
@@ -646,7 +638,7 @@ async function runRemoteTest(argv) {
   const token = getArgValue3(argv, "--token") ?? process5.env.CANARY_API_TOKEN ?? await readStoredToken();
   const tag = getArgValue3(argv, "--tag");
   const namePattern = getArgValue3(argv, "--name-pattern");
-  const verbose = hasFlag(argv, "--verbose", "-v");
+  const verbose = hasFlag2(argv, "--verbose", "-v");
   if (!token) {
     console.error("Error: No API token found.");
     console.error("");
@@ -811,32 +803,6 @@ import fs3 from "fs/promises";
 import os2 from "os";
 import path3 from "path";
 import process6 from "process";
-var ENV_URLS2 = {
-  prod: {
-    api: "https://api.trycanary.ai",
-    app: "https://app.trycanary.ai"
-  },
-  production: {
-    api: "https://api.trycanary.ai",
-    app: "https://app.trycanary.ai"
-  },
-  dev: {
-    api: "https://api.dev.trycanary.ai",
-    app: "https://app.dev.trycanary.ai"
-  },
-  local: {
-    api: "http://localhost:3000",
-    app: "http://localhost:5173"
-  }
-};
-function getArgValue4(argv, key) {
-  const index = argv.indexOf(key);
-  if (index === -1 || index >= argv.length - 1) return void 0;
-  return argv[index + 1];
-}
-function hasFlag2(argv, ...flags) {
-  return flags.some((flag) => argv.includes(flag));
-}
 async function writeDebugSession(loginUrl, expiresAt, apiUrl) {
   const dir = path3.join(os2.homedir(), ".config", "canary-cli");
   const filePath = path3.join(dir, "debug-session.json");
@@ -849,22 +815,8 @@ async function writeDebugSession(loginUrl, expiresAt, apiUrl) {
   return filePath;
 }
 async function runDebugSession(argv) {
-  const env = getArgValue4(argv, "--env");
-  const envUrls = env ? ENV_URLS2[env] : void 0;
-  if (env && !envUrls) {
-    console.error(`Unknown environment: ${env}`);
-    console.error("Valid environments: prod, dev, local");
-    process6.exit(1);
-  }
-  const storedApiUrl = await readStoredApiUrl();
-  const apiUrl = getArgValue4(argv, "--api-url") ?? envUrls?.api ?? process6.env.CANARY_API_URL ?? storedApiUrl ?? "https://api.trycanary.ai";
-  const token = getArgValue4(argv, "--token") ?? process6.env.CANARY_API_TOKEN ?? await readStoredToken();
-  const jsonOutput = hasFlag2(argv, "--json");
-  if (!token) {
-    console.error("Error: No API token found.");
-    console.error("Run: canary login [--env <env>]");
-    process6.exit(1);
-  }
+  const { apiUrl, token } = await resolveConfig(argv);
+  const jsonOutput = hasFlag(argv, "--json");
   try {
     const res = await fetch(`${apiUrl}/auth/debug-session/create`, {
       method: "POST",
@@ -957,8 +909,9 @@ function isSuperadminToken(token) {
 // src/index.ts
 var require2 = createRequire2(import.meta.url);
 var pkg = require2("../package.json");
-var loadMcp = () => import("./mcp-4F4HI7L2.js").then((m) => m.runMcp);
-var loadLocalBrowser = () => import("./local-browser-MKKPBTYI.js").then((m) => m.runLocalBrowser);
+var loadMcp = () => import("./mcp-AD67OLQM.js").then((m) => m.runMcp);
+var loadLocalBrowser = () => import("./local-browser-GG5GUXDS.js").then((m) => m.runLocalBrowser);
+var loadDebugWorkflow = () => import("./debug-workflow-EHKNO7BJ.js").then((m) => m.runDebugWorkflow);
 var canary = { run };
 var baseDir = typeof __dirname !== "undefined" ? __dirname : path4.dirname(fileURLToPath2(import.meta.url));
 var preloadPath = path4.join(baseDir, "runner", "preload.js");
@@ -1000,7 +953,9 @@ function printHelp({ isSuperadmin }) {
     "  canary mcp",
     "  canary browser [--mode playwright|cdp] [--cdp-url <url>] [--no-headless]",
     "  canary login [--org <name>] [--app-url https://app.trycanary.ai] [--no-open]",
-    "  canary orgs                            List organizations"
+    "  canary orgs                            List organizations",
+    "  canary debug <workflowId> [options]    Debug workflow in local headed browser",
+    "  canary issues <sub-command>            Search and view issues"
   ];
   lines.push(
     "  canary release <sub-command>            Release QA gate (CI/CD)"
@@ -1044,6 +999,25 @@ function printHelp({ isSuperadmin }) {
     "    export CANARY_API_URL=http://localhost:3000"
   );
   lines.push(
+    "",
+    "Debug options:",
+    "  --to-step <N>         Stop after step N (1-based, default: all)",
+    "  --env <env>           Environment (local, dev, prod)",
+    "  --verbose, -v         Show all SSE events",
+    "",
+    "Issues sub-commands:",
+    "  list [options]                         List and search issues",
+    "  get <issueId> [options]                Get issue detail with diagnostics",
+    "",
+    "Issues options:",
+    "  --search <query>      Full-text search",
+    "  --severity <level>    Filter: low, medium, high, unknown",
+    "  --status <statuses>   Filter: open, closed, not_a_bug (comma-separated)",
+    "  --property-id <uuid>  Filter by property",
+    "  --page <n>            Page number (default: 1)",
+    "  --page-size <n>       Page size (default: 25)",
+    "  --json                Output raw JSON",
+    "  --format markdown     Output as markdown",
     "",
     "Release sub-commands:",
     "  trigger --property-id <uuid>           Trigger a Release QA run",
@@ -1190,35 +1164,45 @@ async function main(argv) {
     await runLocalBrowser(rest);
     return;
   }
+  if (command === "debug") {
+    const runDebugWorkflow = await loadDebugWorkflow();
+    await runDebugWorkflow(rest);
+    return;
+  }
   if (command === "debug-session") {
     await runDebugSession(rest);
     return;
   }
   if (command === "psql") {
-    const { runPsql } = await import("./psql-6IFVXM3A.js");
+    const { runPsql } = await import("./psql-IVAPNYZV.js");
     await runPsql(rest);
     return;
   }
   if (command === "redis") {
-    const { runRedis } = await import("./redis-HZC32IEO.js");
+    const { runRedis } = await import("./redis-LWY7L6AS.js");
     await runRedis(rest);
     return;
   }
   if (command === "release") {
-    const { runRelease } = await import("./release-WOD3DAX4.js");
+    const { runRelease } = await import("./release-KQFCTAXA.js");
     await runRelease(rest);
     return;
   }
   if (command === "feature-flag") {
-    const { runFeatureFlag } = await import("./feature-flag-ESPSOSKG.js");
+    const { runFeatureFlag } = await import("./feature-flag-ZDLDYRSF.js");
     await runFeatureFlag(rest);
     return;
   }
   if (command === "knobs") {
-    const { runKnobs } = await import("./knobs-HKONHY55.js");
+    const { runKnobs } = await import("./knobs-3MKMOXIV.js");
     await runKnobs(rest);
     return;
   }
+  if (command === "issues") {
+    const { runIssues } = await import("./issues-FI3RIWGV.js");
+    await runIssues(rest);
+    return;
+  }
   console.log(`Unknown command "${command}".`);
   printHelp({ isSuperadmin: await resolveIsSuperadmin() });
   process7.exit(1);