@canaryai/cli 0.1.13 → 0.2.0

package/dist/{knobs-T3O4Z3ZB.js → knobs-HKONHY55.js}

@@ -20,6 +20,63 @@ function getArgValue(argv, key) {
 function hasFlag(argv, ...flags) {
   return flags.some((flag) => argv.includes(flag));
 }
+function toLifecycleLabel(stage) {
+  switch (stage) {
+    case "deprecated":
+      return "deprecated";
+    case "ready_for_cleanup":
+      return "ready_for_cleanup";
+    default:
+      return "active";
+  }
+}
+function parseLifecycleStage(argv) {
+  const stage = getArgValue(argv, "--stage");
+  if (!stage || !["active", "deprecated", "ready_for_cleanup"].includes(stage)) {
+    console.error("Error: --stage is required and must be one of: active, deprecated, ready_for_cleanup");
+    process.exit(1);
+  }
+  return stage;
+}
+function formatValue(valueType, value) {
+  if (valueType === "json") {
+    return JSON.stringify(value);
+  }
+  return String(value);
+}
+function formatFinalValue(knob) {
+  if (knob.lifecycleStage === "active") {
+    return "(none)";
+  }
+  return formatValue(knob.valueType, knob.finalValue);
+}
+function parseTypedValue(raw, valueType) {
+  switch (valueType) {
+    case "boolean":
+      if (raw !== "true" && raw !== "false") {
+        console.error('Error: Boolean value must be "true" or "false".');
+        process.exit(1);
+      }
+      return raw === "true";
+    case "string":
+      return raw;
+    case "number": {
+      const num = parseFloat(raw);
+      if (Number.isNaN(num)) {
+        console.error(`Error: Invalid number: ${raw}`);
+        process.exit(1);
+      }
+      return num;
+    }
+    case "json":
+      try {
+        return JSON.parse(raw);
+      } catch {
+        console.error(`Error: Invalid JSON: ${raw}`);
+        process.exit(1);
+      }
+  }
+}
 async function resolveConfig(argv) {
   const storedApiUrl = await readStoredApiUrl();
   const env = getArgValue(argv, "--env");
@@ -54,14 +111,7 @@ async function apiRequest(apiUrl, token, method, path, body) {
   const json = await res.json();
   return json;
 }
-function formatValue(knob) {
-  if (knob.valueType === "json") {
-    return JSON.stringify(knob.value);
-  }
-  return String(knob.value);
-}
-async function handleList(argv, apiUrl, token) {
-  const jsonOutput = hasFlag(argv, "--json");
+async function fetchKnobs(apiUrl, token) {
   const res = await fetch(`${apiUrl}/superadmin/knobs`, {
     headers: { Authorization: `Bearer ${token}` }
   });
@@ -75,7 +125,11 @@ async function handleList(argv, apiUrl, token) {
     console.error(`Error: ${json.error}`);
     process.exit(1);
   }
-  const knobs = json.knobs ?? [];
+  return json.knobs ?? [];
+}
+async function handleList(argv, apiUrl, token) {
+  const jsonOutput = hasFlag(argv, "--json");
+  const knobs = await fetchKnobs(apiUrl, token);
   if (jsonOutput) {
     console.log(JSON.stringify(knobs, null, 2));
     return;
@@ -86,7 +140,11 @@ async function handleList(argv, apiUrl, token) {
   }
   for (const knob of knobs) {
     const desc = knob.description ? `  ${knob.description}` : "";
-    console.log(`  ${knob.key}  [${knob.valueType}] = ${formatValue(knob)}${desc}`);
+    const lifecycle = `lifecycle=${toLifecycleLabel(knob.lifecycleStage)}`;
+    const finalValue = knob.lifecycleStage === "active" ? "" : ` final=${formatFinalValue(knob)}`;
+    console.log(
+      `  ${knob.key}  [${knob.valueType}] = ${formatValue(knob.valueType, knob.value)}  (${lifecycle}${finalValue})${desc}`
+    );
   }
 }
 async function handleGet(argv, apiUrl, token) {
@@ -97,20 +155,8 @@ async function handleGet(argv, apiUrl, token) {
     process.exit(1);
   }
   const jsonOutput = hasFlag(argv, "--json");
-  const res = await fetch(`${apiUrl}/superadmin/knobs`, {
-    headers: { Authorization: `Bearer ${token}` }
-  });
-  if (res.status === 401) {
-    console.error("Error: Unauthorized. Your session may have expired.");
-    console.error("Run: canary login");
-    process.exit(1);
-  }
-  const json = await res.json();
-  if (!json.ok) {
-    console.error(`Error: ${json.error}`);
-    process.exit(1);
-  }
-  const knob = (json.knobs ?? []).find((k) => k.key === key);
+  const knobs = await fetchKnobs(apiUrl, token);
+  const knob = knobs.find((k) => k.key === key);
   if (!knob) {
     console.error(`Knob not found: ${key}`);
     process.exit(1);
@@ -121,7 +167,9 @@ async function handleGet(argv, apiUrl, token) {
   }
   console.log(`  Key:         ${knob.key}`);
   console.log(`  Type:        ${knob.valueType}`);
-  console.log(`  Value:       ${formatValue(knob)}`);
+  console.log(`  Value:       ${formatValue(knob.valueType, knob.value)}`);
+  console.log(`  Lifecycle:   ${toLifecycleLabel(knob.lifecycleStage)}`);
+  console.log(`  Final value: ${formatFinalValue(knob)}`);
   console.log(`  Description: ${knob.description ?? "(none)"}`);
   console.log(`  Updated:     ${knob.updatedAt ?? "(never)"}`);
 }
@@ -147,36 +195,7 @@ async function handleSet(argv, apiUrl, token) {
     console.error("Error: --type is required and must be one of: boolean, string, number, json");
     process.exit(1);
   }
-  let value;
-  switch (valueType) {
-    case "boolean":
-      if (rawValue !== "true" && rawValue !== "false") {
-        console.error('Error: Boolean value must be "true" or "false".');
-        process.exit(1);
-      }
-      value = rawValue === "true";
-      break;
-    case "string":
-      value = rawValue;
-      break;
-    case "number": {
-      const num = parseFloat(rawValue);
-      if (Number.isNaN(num)) {
-        console.error(`Error: Invalid number: ${rawValue}`);
-        process.exit(1);
-      }
-      value = num;
-      break;
-    }
-    case "json":
-      try {
-        value = JSON.parse(rawValue);
-      } catch {
-        console.error(`Error: Invalid JSON: ${rawValue}`);
-        process.exit(1);
-      }
-      break;
-  }
+  const value = parseTypedValue(rawValue, valueType);
   const description = getArgValue(argv, "--description") ?? void 0;
   const result = await apiRequest(apiUrl, token, "POST", "/superadmin/knobs", {
     key,
@@ -188,7 +207,7 @@ async function handleSet(argv, apiUrl, token) {
     console.error(`Error: ${result.error}`);
     process.exit(1);
   }
-  console.log(`Set knob: ${key} = ${formatValue(result.knob)}`);
+  console.log(`Set knob: ${key} = ${formatValue(valueType, result.knob?.value)}`);
 }
 async function handleDelete(argv, apiUrl, token) {
   const key = argv[0];
@@ -226,7 +245,66 @@ async function handleToggle(argv, apiUrl, token) {
     console.error(`Error: ${result.error}`);
     process.exit(1);
   }
-  console.log(`Toggled knob: ${key} \u2192 ${result.knob?.value}`);
+  const knob = result.knob;
+  console.log(`Toggled knob: ${key} -> ${formatValue(knob?.valueType ?? "boolean", knob?.value)}`);
+}
+async function handleLifecycle(argv, apiUrl, token) {
+  const key = argv[0];
+  if (!key || key.startsWith("--")) {
+    console.error("Error: Missing knob key.");
+    console.error(
+      "Usage: canary knobs lifecycle <key> --stage <active|deprecated|ready_for_cleanup> [--final-value <value>]"
+    );
+    process.exit(1);
+  }
+  const stage = parseLifecycleStage(argv);
+  const rawFinalValue = getArgValue(argv, "--final-value");
+  const clearFinalValue = hasFlag(argv, "--clear-final-value");
+  if (rawFinalValue !== void 0 && clearFinalValue) {
+    console.error("Error: use either --final-value or --clear-final-value, not both.");
+    process.exit(1);
+  }
+  const knobs = await fetchKnobs(apiUrl, token);
+  const knob = knobs.find((k) => k.key === key);
+  if (!knob) {
+    console.error(`Knob not found: ${key}`);
+    process.exit(1);
+  }
+  let finalValue = void 0;
+  if (stage === "active") {
+    if (rawFinalValue !== void 0) {
+      console.error("Error: active stage does not accept --final-value. Use --stage deprecated|ready_for_cleanup.");
+      process.exit(1);
+    }
+    finalValue = clearFinalValue ? void 0 : void 0;
+  } else {
+    if (clearFinalValue) {
+      console.error("Error: --clear-final-value can only be used with --stage active.");
+      process.exit(1);
+    }
+    if (rawFinalValue === void 0) {
+      console.error("Error: --final-value is required when stage is deprecated or ready_for_cleanup.");
+      process.exit(1);
+    }
+    finalValue = parseTypedValue(rawFinalValue, knob.valueType);
+  }
+  const result = await apiRequest(
+    apiUrl,
+    token,
+    "POST",
+    `/superadmin/knobs/${encodeURIComponent(key)}/lifecycle`,
+    {
+      stage,
+      finalValue
+    }
+  );
+  if (!result.ok || !result.knob) {
+    console.error(`Error: ${result.error ?? "Failed to update lifecycle"}`);
+    process.exit(1);
+  }
+  console.log(
+    `Updated lifecycle for ${key}: stage=${toLifecycleLabel(result.knob.lifecycleStage)}, final=${formatFinalValue(result.knob)}`
+  );
 }
 function printKnobsHelp() {
   console.log(
@@ -240,14 +318,19 @@ function printKnobsHelp() {
       "                                             Set a knob value",
       "  delete <key>                               Delete a knob",
       "  toggle <key>                               Toggle a boolean knob",
+      "  lifecycle <key> --stage <stage> [--final-value <value>]",
+      "                                             Mark knob lifecycle + final value",
       "",
       "Types: boolean, string, number, json",
+      "Stages: active, deprecated, ready_for_cleanup",
       "",
       "Options:",
-      "  --env <env>       Target environment (prod, dev, local)",
-      "  --json            Output as JSON (list/get only)",
-      "  --api-url <url>   API URL override (takes precedence over --env)",
-      "  --token <key>     API token override"
+      "  --final-value <value>  Final value for deprecated/ready_for_cleanup",
+      "  --clear-final-value    Clear final value (only valid with --stage active)",
+      "  --env <env>            Target environment (prod, dev, local)",
+      "  --json                 Output as JSON (list/get only)",
+      "  --api-url <url>        API URL override (takes precedence over --env)",
+      "  --token <key>          API token override"
     ].join("\n")
   );
 }
@@ -274,6 +357,9 @@ async function runKnobs(argv) {
     case "toggle":
       await handleToggle(rest, apiUrl, token);
       break;
+    case "lifecycle":
+      await handleLifecycle(rest, apiUrl, token);
+      break;
     default:
       console.error(`Unknown sub-command: ${subCommand}`);
       printKnobsHelp();
@@ -283,4 +369,4 @@ async function runKnobs(argv) {
 export {
   runKnobs
 };
-//# sourceMappingURL=knobs-T3O4Z3ZB.js.map
+//# sourceMappingURL=knobs-HKONHY55.js.map

package/dist/knobs-HKONHY55.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/knobs.ts"],"sourcesContent":["/**\n * CLI Knobs Management\n *\n * Allows superadmins to manage knobs (global config) via the CLI.\n */\n\nimport process from \"node:process\";\nimport { readStoredToken, readStoredApiUrl } from \"./auth.js\";\n\nconst ENV_URLS: Record<string, string> = {\n  prod: \"https://api.trycanary.ai\",\n  production: \"https://api.trycanary.ai\",\n  dev: \"https://api.dev.trycanary.ai\",\n  local: \"http://localhost:3000\",\n};\n\ntype LifecycleStage = \"active\" | \"deprecated\" | \"ready_for_cleanup\";\n\ntype SerializedKnob = {\n  key: string;\n  description: string | null;\n  valueType: \"boolean\" | \"string\" | \"number\" | \"json\";\n  value: unknown;\n  lifecycleStage: LifecycleStage;\n  finalValue: unknown;\n  updatedAt: string | null;\n  updatedBy: string | null;\n  createdAt: string | null;\n};\n\ntype KnobListResponse = {\n  ok: boolean;\n  knobs?: SerializedKnob[];\n  error?: string;\n};\n\ntype ApiResponse = {\n  ok: boolean;\n  error?: string;\n  knob?: SerializedKnob;\n};\n\nfunction getArgValue(argv: string[], key: string): string | undefined {\n  const index = argv.indexOf(key);\n  if (index === -1 || index >= argv.length - 1) return undefined;\n  return argv[index + 1];\n}\n\nfunction hasFlag(argv: string[], ...flags: string[]): boolean {\n  return flags.some((flag) => argv.includes(flag));\n}\n\nfunction toLifecycleLabel(stage: LifecycleStage): string {\n  switch (stage) {\n    case \"deprecated\":\n      return \"deprecated\";\n    case \"ready_for_cleanup\":\n      return \"ready_for_cleanup\";\n    default:\n      return \"active\";\n  }\n}\n\nfunction parseLifecycleStage(argv: string[]): LifecycleStage {\n  const stage = getArgValue(argv, \"--stage\");\n  if (!stage || ![\"active\", \"deprecated\", \"ready_for_cleanup\"].includes(stage)) {\n    console.error(\"Error: --stage is required and must be one of: active, deprecated, ready_for_cleanup\");\n    process.exit(1);\n  }\n  return stage as LifecycleStage;\n}\n\nfunction formatValue(valueType: SerializedKnob[\"valueType\"], value: unknown): string {\n  if (valueType === \"json\") {\n    return JSON.stringify(value);\n  }\n  return String(value);\n}\n\nfunction formatFinalValue(knob: SerializedKnob): string {\n  if (knob.lifecycleStage === \"active\") {\n    return \"(none)\";\n  }\n  return formatValue(knob.valueType, knob.finalValue);\n}\n\nfunction parseTypedValue(raw: string, valueType: SerializedKnob[\"valueType\"]): unknown {\n  switch (valueType) {\n    case \"boolean\":\n      if (raw !== \"true\" && raw !== \"false\") {\n        console.error('Error: Boolean value must be \"true\" or \"false\".');\n        process.exit(1);\n      }\n      return raw === \"true\";\n    case \"string\":\n      return raw;\n    case \"number\": {\n      const num = parseFloat(raw);\n      if (Number.isNaN(num)) {\n        console.error(`Error: Invalid number: ${raw}`);\n        process.exit(1);\n      }\n      return num;\n    }\n    case \"json\":\n      try {\n        return JSON.parse(raw);\n      } catch {\n        console.error(`Error: Invalid JSON: ${raw}`);\n        process.exit(1);\n      }\n  }\n}\n\nasync function resolveConfig(argv: string[]) {\n  const storedApiUrl = await readStoredApiUrl();\n  const env = getArgValue(argv, \"--env\");\n\n  if (env && !ENV_URLS[env]) {\n    console.error(`Unknown environment: ${env}`);\n    console.error(\"Valid environments: prod, dev, local\");\n    process.exit(1);\n  }\n\n  const apiUrl =\n    getArgValue(argv, \"--api-url\") ??\n    (env ? ENV_URLS[env] : undefined) ??\n    process.env.CANARY_API_URL ??\n    storedApiUrl ??\n    \"https://api.trycanary.ai\";\n\n  const token =\n    getArgValue(argv, \"--token\") ?? process.env.CANARY_API_TOKEN ?? (await readStoredToken());\n\n  if (!token) {\n    console.error(\"Error: No API token found.\");\n    console.error(\"Run: canary login\");\n    process.exit(1);\n  }\n\n  return { apiUrl, token };\n}\n\nasync function apiRequest(\n  apiUrl: string,\n  token: string,\n  method: string,\n  path: string,\n  body?: Record<string, unknown>\n): Promise<ApiResponse> {\n  const res = await fetch(`${apiUrl}${path}`, {\n    method,\n    headers: {\n      Authorization: `Bearer ${token}`,\n      \"Content-Type\": \"application/json\",\n    },\n    ...(body ? { body: JSON.stringify(body) } : {}),\n  });\n\n  if (res.status === 401) {\n    console.error(\"Error: Unauthorized. Your session may have expired.\");\n    console.error(\"Run: canary login\");\n    process.exit(1);\n  }\n\n  const json = (await res.json()) as ApiResponse;\n  return json;\n}\n\nasync function fetchKnobs(apiUrl: string, token: string): Promise<SerializedKnob[]> {\n  const res = await fetch(`${apiUrl}/superadmin/knobs`, {\n    headers: { Authorization: `Bearer ${token}` },\n  });\n\n  if (res.status === 401) {\n    console.error(\"Error: Unauthorized. Your session may have expired.\");\n    console.error(\"Run: canary login\");\n    process.exit(1);\n  }\n\n  const json = (await res.json()) as KnobListResponse;\n\n  if (!json.ok) {\n    console.error(`Error: ${json.error}`);\n    process.exit(1);\n  }\n\n  return json.knobs ?? [];\n}\n\nasync function handleList(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const jsonOutput = hasFlag(argv, \"--json\");\n  const knobs = await fetchKnobs(apiUrl, token);\n\n  if (jsonOutput) {\n    console.log(JSON.stringify(knobs, null, 2));\n    return;\n  }\n\n  if (knobs.length === 0) {\n    console.log(\"No knobs found.\");\n    return;\n  }\n\n  for (const knob of knobs) {\n    const desc = knob.description ? `  ${knob.description}` : \"\";\n    const lifecycle = `lifecycle=${toLifecycleLabel(knob.lifecycleStage)}`;\n    const finalValue =\n      knob.lifecycleStage === \"active\" ? \"\" : ` final=${formatFinalValue(knob)}`;\n    console.log(\n      `  ${knob.key}  [${knob.valueType}] = ${formatValue(knob.valueType, knob.value)}  (${lifecycle}${finalValue})${desc}`\n    );\n  }\n}\n\nasync function handleGet(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const key = argv[0];\n  if (!key || key.startsWith(\"--\")) {\n    console.error(\"Error: Missing knob key.\");\n    console.error(\"Usage: canary knobs get <key>\");\n    process.exit(1);\n  }\n\n  const jsonOutput = hasFlag(argv, \"--json\");\n  const knobs = await fetchKnobs(apiUrl, token);\n\n  const knob = knobs.find((k) => k.key === key);\n\n  if (!knob) {\n    console.error(`Knob not found: ${key}`);\n    process.exit(1);\n  }\n\n  if (jsonOutput) {\n    console.log(JSON.stringify(knob, null, 2));\n    return;\n  }\n\n  console.log(`  Key:         ${knob.key}`);\n  console.log(`  Type:        ${knob.valueType}`);\n  console.log(`  Value:       ${formatValue(knob.valueType, knob.value)}`);\n  console.log(`  Lifecycle:   ${toLifecycleLabel(knob.lifecycleStage)}`);\n  console.log(`  Final value: ${formatFinalValue(knob)}`);\n  console.log(`  Description: ${knob.description ?? \"(none)\"}`);\n  console.log(`  Updated:     ${knob.updatedAt ?? \"(never)\"}`);\n}\n\nasync function handleSet(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const key = argv[0];\n  if (!key || key.startsWith(\"--\")) {\n    console.error(\"Error: Missing knob key.\");\n    console.error(\n      \"Usage: canary knobs set <key> <value> --type <boolean|string|number|json> [--description <text>]\"\n    );\n    process.exit(1);\n  }\n\n  const rawValue = argv[1];\n  if (rawValue === undefined || rawValue.startsWith(\"--\")) {\n    console.error(\"Error: Missing knob value.\");\n    console.error(\n      \"Usage: canary knobs set <key> <value> --type <boolean|string|number|json> [--description <text>]\"\n    );\n    process.exit(1);\n  }\n\n  const valueType = getArgValue(argv, \"--type\") as SerializedKnob[\"valueType\"] | undefined;\n  if (!valueType || ![\"boolean\", \"string\", \"number\", \"json\"].includes(valueType)) {\n    console.error(\"Error: --type is required and must be one of: boolean, string, number, json\");\n    process.exit(1);\n  }\n\n  const value = parseTypedValue(rawValue, valueType);\n  const description = getArgValue(argv, \"--description\") ?? undefined;\n\n  const result = await apiRequest(apiUrl, token, \"POST\", \"/superadmin/knobs\", {\n    key,\n    valueType,\n    value,\n    description,\n  });\n\n  if (!result.ok) {\n    console.error(`Error: ${result.error}`);\n    process.exit(1);\n  }\n\n  console.log(`Set knob: ${key} = ${formatValue(valueType, result.knob?.value)}`);\n}\n\nasync function handleDelete(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const key = argv[0];\n  if (!key || key.startsWith(\"--\")) {\n    console.error(\"Error: Missing knob key.\");\n    console.error(\"Usage: canary knobs delete <key>\");\n    process.exit(1);\n  }\n\n  const result = await apiRequest(\n    apiUrl,\n    token,\n    \"DELETE\",\n    `/superadmin/knobs/${encodeURIComponent(key)}`\n  );\n\n  if (!result.ok) {\n    console.error(`Error: ${result.error}`);\n    process.exit(1);\n  }\n\n  console.log(`Deleted knob: ${key}`);\n}\n\nasync function handleToggle(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const key = argv[0];\n  if (!key || key.startsWith(\"--\")) {\n    console.error(\"Error: Missing knob key.\");\n    console.error(\"Usage: canary knobs toggle <key>\");\n    process.exit(1);\n  }\n\n  const result = await apiRequest(\n    apiUrl,\n    token,\n    \"POST\",\n    `/superadmin/knobs/${encodeURIComponent(key)}/toggle`\n  );\n\n  if (!result.ok) {\n    console.error(`Error: ${result.error}`);\n    process.exit(1);\n  }\n\n  const knob = result.knob;\n  console.log(`Toggled knob: ${key} -> ${formatValue(knob?.valueType ?? \"boolean\", knob?.value)}`);\n}\n\nasync function handleLifecycle(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const key = argv[0];\n  if (!key || key.startsWith(\"--\")) {\n    console.error(\"Error: Missing knob key.\");\n    console.error(\n      \"Usage: canary knobs lifecycle <key> --stage <active|deprecated|ready_for_cleanup> [--final-value <value>]\"\n    );\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  const knobs = await fetchKnobs(apiUrl, token);\n  const knob = knobs.find((k) => k.key === key);\n\n  if (!knob) {\n    console.error(`Knob not found: ${key}`);\n    process.exit(1);\n  }\n\n  let finalValue: unknown = undefined;\n\n  if (stage === \"active\") {\n    if (rawFinalValue !== undefined) {\n      console.error(\"Error: active stage does not accept --final-value. Use --stage deprecated|ready_for_cleanup.\");\n      process.exit(1);\n    }\n    finalValue = clearFinalValue ? undefined : 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 === undefined) {\n      console.error(\"Error: --final-value is required when stage is deprecated or ready_for_cleanup.\");\n      process.exit(1);\n    }\n    finalValue = parseTypedValue(rawFinalValue, knob.valueType);\n  }\n\n  const result = await apiRequest(\n    apiUrl,\n    token,\n    \"POST\",\n    `/superadmin/knobs/${encodeURIComponent(key)}/lifecycle`,\n    {\n      stage,\n      finalValue,\n    }\n  );\n\n  if (!result.ok || !result.knob) {\n    console.error(`Error: ${result.error ?? \"Failed to update lifecycle\"}`);\n    process.exit(1);\n  }\n\n  console.log(\n    `Updated lifecycle for ${key}: stage=${toLifecycleLabel(result.knob.lifecycleStage)}, final=${formatFinalValue(result.knob)}`\n  );\n}\n\nfunction printKnobsHelp(): void {\n  console.log(\n    [\n      \"Usage: canary knobs <sub-command> [options]\",\n      \"\",\n      \"Sub-commands:\",\n      \"  list                                       List all knobs\",\n      \"  get <key>                                  Get a knob value\",\n      \"  set <key> <value> --type <type> [--description <text>]\",\n      \"                                             Set a knob value\",\n      \"  delete <key>                               Delete a knob\",\n      \"  toggle <key>                               Toggle a boolean knob\",\n      \"  lifecycle <key> --stage <stage> [--final-value <value>]\",\n      \"                                             Mark knob lifecycle + final value\",\n      \"\",\n      \"Types: boolean, string, number, json\",\n      \"Stages: active, deprecated, ready_for_cleanup\",\n      \"\",\n      \"Options:\",\n      \"  --final-value <value>  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/get 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 runKnobs(argv: string[]): Promise<void> {\n  const [subCommand, ...rest] = argv;\n\n  if (!subCommand || subCommand === \"help\" || hasFlag(argv, \"--help\", \"-h\")) {\n    printKnobsHelp();\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 \"get\":\n      await handleGet(rest, apiUrl, token);\n      break;\n    case \"set\":\n      await handleSet(rest, apiUrl, token);\n      break;\n    case \"delete\":\n      await handleDelete(rest, apiUrl, token);\n      break;\n    case \"toggle\":\n      await handleToggle(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      printKnobsHelp();\n      process.exit(1);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/{local-browser-SYPTG6IQ.js → local-browser-MKKPBTYI.js}

@@ -1,6 +1,6 @@
 import {
   LocalBrowserHost
-} from "./chunk-L26U3BST.js";
+} from "./chunk-UEOXNF5X.js";
 import {
   readStoredToken
 } from "./chunk-2T64Z2NI.js";
@@ -137,4 +137,4 @@ async function runLocalBrowser(args) {
 export {
   runLocalBrowser
 };
-//# sourceMappingURL=local-browser-SYPTG6IQ.js.map
+//# sourceMappingURL=local-browser-MKKPBTYI.js.map

package/dist/{mcp-TMD2R5Z6.js → mcp-4F4HI7L2.js}

@@ -5,7 +5,7 @@ import {
 } from "./chunk-V7U52ISX.js";
 import {
   LocalBrowserHost
-} from "./chunk-L26U3BST.js";
+} from "./chunk-UEOXNF5X.js";
 import {
   readStoredToken
 } from "./chunk-2T64Z2NI.js";
@@ -381,4 +381,4 @@ function formatReport(input) {
 export {
   runMcp
 };
-//# sourceMappingURL=mcp-TMD2R5Z6.js.map
+//# sourceMappingURL=mcp-4F4HI7L2.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canaryai/cli",
-  "version": "0.1.13",
+  "version": "0.2.0",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -45,6 +45,7 @@
     "ai": "^5.0.60",
     "dotenv": "^17.2.3",
     "eventsource-parser": "^3.0.0",
+    "@chatsdet/browser-core": "workspace:*",
     "zod": "^4.1.12"
   },
   "devDependencies": {