@canaryai/cli 0.2.3 → 0.2.4

package/dist/docs-GCYDTEOY.js

@@ -0,0 +1,270 @@
+import { createRequire as __cr } from "module"; const require = __cr(import.meta.url);
+import {
+  apiRequest,
+  fetchList
+} from "./chunk-6WWHXWCS.js";
+import {
+  getArgValue,
+  hasFlag,
+  resolveConfig
+} from "./chunk-PWWQGYFG.js";
+import "./chunk-VLFUCAPZ.js";
+
+// src/docs.ts
+import { readFile, writeFile, mkdir } from "fs/promises";
+import path from "path";
+import process from "process";
+var DEFAULT_PULL_DIR = "/tmp/canary-docs";
+async function handleList(argv, apiUrl, token) {
+  const jsonOutput = hasFlag(argv, "--json");
+  const pages = await fetchList(apiUrl, token, "/public/docs/pages", "pages");
+  if (jsonOutput) {
+    console.log(JSON.stringify(pages, null, 2));
+    return;
+  }
+  if (pages.length === 0) {
+    console.log("No documentation pages found.");
+    return;
+  }
+  for (const page of pages) {
+    const date = new Date(page.updatedAt).toISOString().slice(0, 10);
+    const by = page.publishedBy ? ` (${page.publishedBy})` : "";
+    console.log(`  ${page.slug}  ${page.title}  [${date}${by}]`);
+  }
+}
+async function handleGet(argv, apiUrl, token) {
+  const slug = argv[0];
+  if (!slug || slug.startsWith("--")) {
+    console.error("Error: Missing slug.");
+    console.error("Usage: canary docs get <slug>");
+    process.exit(1);
+  }
+  const res = await fetch(`${apiUrl}/public/docs/pages/raw?slug=${encodeURIComponent(slug)}`, {
+    headers: { Authorization: `Bearer ${token}` }
+  });
+  if (res.status === 404) {
+    console.error(`Error: Page not found: ${slug}`);
+    process.exit(1);
+  }
+  if (!res.ok) {
+    console.error(`Error: ${res.statusText}`);
+    process.exit(1);
+  }
+  const content = await res.text();
+  console.log(content);
+}
+async function handlePull(argv, apiUrl, token) {
+  const slug = argv[0];
+  if (!slug || slug.startsWith("--")) {
+    console.error("Error: Missing slug.");
+    console.error("Usage: canary docs pull <slug> [--output <path>]");
+    process.exit(1);
+  }
+  const outputPath = getArgValue(argv, "--output") ?? path.join(DEFAULT_PULL_DIR, `${slug}.md`);
+  const res = await fetch(`${apiUrl}/public/docs/pages/raw?slug=${encodeURIComponent(slug)}`, {
+    headers: { Authorization: `Bearer ${token}` }
+  });
+  if (res.status === 404) {
+    console.error(`Error: Page not found: ${slug}`);
+    process.exit(1);
+  }
+  if (!res.ok) {
+    console.error(`Error: ${res.statusText}`);
+    process.exit(1);
+  }
+  const content = await res.text();
+  await mkdir(path.dirname(outputPath), { recursive: true });
+  await writeFile(outputPath, content, "utf8");
+  console.log(`Pulled ${slug} \u2192 ${outputPath}`);
+}
+async function handlePush(argv, apiUrl, token) {
+  const slug = argv[0];
+  if (!slug || slug.startsWith("--")) {
+    console.error("Error: Missing slug.");
+    console.error("Usage: canary docs push <slug> --file <path> [--message <text>]");
+    process.exit(1);
+  }
+  const filePath = getArgValue(argv, "--file");
+  if (!filePath) {
+    console.error("Error: Missing --file <path>.");
+    process.exit(1);
+  }
+  const message = getArgValue(argv, "--message") ?? void 0;
+  const createdBy = getArgValue(argv, "--created-by") ?? void 0;
+  let content;
+  try {
+    content = await readFile(filePath, "utf8");
+  } catch {
+    console.error(`Error: Could not read file: ${filePath}`);
+    process.exit(1);
+  }
+  const result = await apiRequest(
+    apiUrl,
+    token,
+    "PUT",
+    `/superadmin/docs/pages?slug=${encodeURIComponent(slug)}`,
+    { content, message, createdBy }
+  );
+  if (!result.ok) {
+    console.error(`Error: ${result.error}`);
+    process.exit(1);
+  }
+  console.log(`Published new version of ${slug}`);
+}
+async function handleHistory(argv, apiUrl, token) {
+  const slug = argv[0];
+  if (!slug || slug.startsWith("--")) {
+    console.error("Error: Missing slug.");
+    console.error("Usage: canary docs history <slug>");
+    process.exit(1);
+  }
+  const jsonOutput = hasFlag(argv, "--json");
+  const res = await fetch(
+    `${apiUrl}/public/docs/pages/versions?slug=${encodeURIComponent(slug)}`,
+    { headers: { Authorization: `Bearer ${token}` } }
+  );
+  if (!res.ok) {
+    const body2 = await res.json().catch(() => ({ error: res.statusText }));
+    console.error(`Error: ${body2.error ?? res.statusText}`);
+    process.exit(1);
+  }
+  const body = await res.json();
+  const versions = body.data?.versions ?? [];
+  if (jsonOutput) {
+    console.log(JSON.stringify(versions, null, 2));
+    return;
+  }
+  if (versions.length === 0) {
+    console.log(`No versions found for ${slug}.`);
+    return;
+  }
+  for (const v of versions) {
+    const date = new Date(v.createdAt).toISOString().slice(0, 19).replace("T", " ");
+    const msg = v.message ? ` \u2014 ${v.message}` : "";
+    console.log(`  v${v.version}  ${date}  ${v.createdBy}${msg}`);
+  }
+}
+async function handleCreate(argv, apiUrl, token) {
+  const slug = argv[0];
+  if (!slug || slug.startsWith("--")) {
+    console.error("Error: Missing slug.");
+    console.error("Usage: canary docs create <slug> --file <path> --title <text>");
+    process.exit(1);
+  }
+  const filePath = getArgValue(argv, "--file");
+  const title = getArgValue(argv, "--title");
+  if (!filePath) {
+    console.error("Error: Missing --file <path>.");
+    process.exit(1);
+  }
+  if (!title) {
+    console.error("Error: Missing --title <text>.");
+    process.exit(1);
+  }
+  const description = getArgValue(argv, "--description") ?? void 0;
+  const message = getArgValue(argv, "--message") ?? void 0;
+  let content;
+  try {
+    content = await readFile(filePath, "utf8");
+  } catch {
+    console.error(`Error: Could not read file: ${filePath}`);
+    process.exit(1);
+  }
+  const result = await apiRequest(apiUrl, token, "POST", "/superadmin/docs/pages", {
+    slug,
+    title,
+    description,
+    content,
+    message
+  });
+  if (!result.ok) {
+    console.error(`Error: ${result.error}`);
+    process.exit(1);
+  }
+  console.log(`Created page: ${slug}`);
+}
+async function handleDelete(argv, apiUrl, token) {
+  const slug = argv[0];
+  if (!slug || slug.startsWith("--")) {
+    console.error("Error: Missing slug.");
+    console.error("Usage: canary docs delete <slug>");
+    process.exit(1);
+  }
+  const result = await apiRequest(
+    apiUrl,
+    token,
+    "DELETE",
+    `/superadmin/docs/pages?slug=${encodeURIComponent(slug)}`
+  );
+  if (!result.ok) {
+    console.error(`Error: ${result.error}`);
+    process.exit(1);
+  }
+  console.log(`Deleted page: ${slug}`);
+}
+function printDocsHelp() {
+  console.log(
+    [
+      "Usage: canary docs <sub-command> [options]",
+      "",
+      "Sub-commands:",
+      "  list                                    List all doc pages",
+      "  get <slug>                              Print content to stdout",
+      "  pull <slug> [--output <path>]           Download to local file",
+      "  push <slug> --file <path> [--message]   Publish new version",
+      "  history <slug>                          Show version history",
+      "  create <slug> --file <path> --title ... Create new page",
+      "  delete <slug>                           Soft-delete a page",
+      "",
+      "Options:",
+      "  --file <path>          Path to markdown file",
+      "  --title <text>         Page title (create only)",
+      "  --description <text>   Page description (create only)",
+      "  --message <text>       Version commit message",
+      "  --output <path>        Output path for pull (default: /tmp/canary-docs/<slug>.md)",
+      "  --json                 Output as JSON (list, history)",
+      "  --env <env>            Target environment (prod, dev)",
+      "  --api-url <url>        API URL override",
+      "  --token <key>          API token override"
+    ].join("\n")
+  );
+}
+async function runDocs(argv) {
+  const [subCommand, ...rest] = argv;
+  if (!subCommand || subCommand === "help" || hasFlag(argv, "--help", "-h")) {
+    printDocsHelp();
+    return;
+  }
+  const { apiUrl, token } = await resolveConfig(argv);
+  switch (subCommand) {
+    case "list":
+      await handleList(rest, apiUrl, token);
+      break;
+    case "get":
+      await handleGet(rest, apiUrl, token);
+      break;
+    case "pull":
+      await handlePull(rest, apiUrl, token);
+      break;
+    case "push":
+      await handlePush(rest, apiUrl, token);
+      break;
+    case "history":
+      await handleHistory(rest, apiUrl, token);
+      break;
+    case "create":
+      await handleCreate(rest, apiUrl, token);
+      break;
+    case "delete":
+      await handleDelete(rest, apiUrl, token);
+      break;
+    default:
+      console.error(`Unknown sub-command: ${subCommand}`);
+      printDocsHelp();
+      process.exit(1);
+  }
+}
+export {
+  runDocs
+};
+//# sourceMappingURL=docs-GCYDTEOY.js.map

package/dist/docs-GCYDTEOY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/docs.ts"],"sourcesContent":["/**\n * CLI Documentation Management\n *\n * Allows agents and superadmins to list, pull, edit, and push documentation pages.\n */\n\nimport { readFile, writeFile, mkdir } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport process from \"node:process\";\nimport { resolveConfig, getArgValue, hasFlag } from \"./auth.js\";\nimport { apiRequest, fetchList } from \"./cli-helpers.js\";\n\ntype DocsPageListItem = {\n  slug: string;\n  title: string;\n  description: string | null;\n  updatedAt: string;\n  publishedBy: string | null;\n};\n\ntype DocsPageContent = {\n  slug: string;\n  path: string;\n  title: string;\n  description: string | null;\n  content: string;\n  checksum: string;\n  updatedAt: string;\n  publishedBy: string | null;\n};\n\ntype DocsVersionItem = {\n  version: number;\n  title: string;\n  checksum: string;\n  message: string | null;\n  createdBy: string;\n  createdAt: string;\n};\n\ntype DocsApiResponse = {\n  ok: boolean;\n  error?: string;\n  data?: {\n    slug?: string;\n    title?: string;\n    pages?: DocsPageListItem[];\n    content?: string;\n    versions?: DocsVersionItem[];\n  };\n};\n\nconst DEFAULT_PULL_DIR = \"/tmp/canary-docs\";\n\nasync function handleList(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const jsonOutput = hasFlag(argv, \"--json\");\n  const pages = await fetchList<DocsPageListItem>(apiUrl, token, \"/public/docs/pages\", \"pages\");\n\n  if (jsonOutput) {\n    console.log(JSON.stringify(pages, null, 2));\n    return;\n  }\n\n  if (pages.length === 0) {\n    console.log(\"No documentation pages found.\");\n    return;\n  }\n\n  for (const page of pages) {\n    const date = new Date(page.updatedAt).toISOString().slice(0, 10);\n    const by = page.publishedBy ? ` (${page.publishedBy})` : \"\";\n    console.log(`  ${page.slug}  ${page.title}  [${date}${by}]`);\n  }\n}\n\nasync function handleGet(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const slug = argv[0];\n  if (!slug || slug.startsWith(\"--\")) {\n    console.error(\"Error: Missing slug.\");\n    console.error(\"Usage: canary docs get <slug>\");\n    process.exit(1);\n  }\n\n  const res = await fetch(`${apiUrl}/public/docs/pages/raw?slug=${encodeURIComponent(slug)}`, {\n    headers: { Authorization: `Bearer ${token}` },\n  });\n\n  if (res.status === 404) {\n    console.error(`Error: Page not found: ${slug}`);\n    process.exit(1);\n  }\n\n  if (!res.ok) {\n    console.error(`Error: ${res.statusText}`);\n    process.exit(1);\n  }\n\n  const content = await res.text();\n  console.log(content);\n}\n\nasync function handlePull(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const slug = argv[0];\n  if (!slug || slug.startsWith(\"--\")) {\n    console.error(\"Error: Missing slug.\");\n    console.error(\"Usage: canary docs pull <slug> [--output <path>]\");\n    process.exit(1);\n  }\n\n  const outputPath = getArgValue(argv, \"--output\") ?? path.join(DEFAULT_PULL_DIR, `${slug}.md`);\n\n  const res = await fetch(`${apiUrl}/public/docs/pages/raw?slug=${encodeURIComponent(slug)}`, {\n    headers: { Authorization: `Bearer ${token}` },\n  });\n\n  if (res.status === 404) {\n    console.error(`Error: Page not found: ${slug}`);\n    process.exit(1);\n  }\n\n  if (!res.ok) {\n    console.error(`Error: ${res.statusText}`);\n    process.exit(1);\n  }\n\n  const content = await res.text();\n  await mkdir(path.dirname(outputPath), { recursive: true });\n  await writeFile(outputPath, content, \"utf8\");\n  console.log(`Pulled ${slug} → ${outputPath}`);\n}\n\nasync function handlePush(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const slug = argv[0];\n  if (!slug || slug.startsWith(\"--\")) {\n    console.error(\"Error: Missing slug.\");\n    console.error(\"Usage: canary docs push <slug> --file <path> [--message <text>]\");\n    process.exit(1);\n  }\n\n  const filePath = getArgValue(argv, \"--file\");\n  if (!filePath) {\n    console.error(\"Error: Missing --file <path>.\");\n    process.exit(1);\n  }\n\n  const message = getArgValue(argv, \"--message\") ?? undefined;\n  const createdBy = getArgValue(argv, \"--created-by\") ?? undefined;\n\n  let content: string;\n  try {\n    content = await readFile(filePath, \"utf8\");\n  } catch {\n    console.error(`Error: Could not read file: ${filePath}`);\n    process.exit(1);\n  }\n\n  const result = await apiRequest<DocsApiResponse>(\n    apiUrl,\n    token,\n    \"PUT\",\n    `/superadmin/docs/pages?slug=${encodeURIComponent(slug)}`,\n    { content, message, createdBy }\n  );\n\n  if (!result.ok) {\n    console.error(`Error: ${result.error}`);\n    process.exit(1);\n  }\n\n  console.log(`Published new version of ${slug}`);\n}\n\nasync function handleHistory(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const slug = argv[0];\n  if (!slug || slug.startsWith(\"--\")) {\n    console.error(\"Error: Missing slug.\");\n    console.error(\"Usage: canary docs history <slug>\");\n    process.exit(1);\n  }\n\n  const jsonOutput = hasFlag(argv, \"--json\");\n\n  const res = await fetch(\n    `${apiUrl}/public/docs/pages/versions?slug=${encodeURIComponent(slug)}`,\n    { headers: { Authorization: `Bearer ${token}` } }\n  );\n\n  if (!res.ok) {\n    const body = await res.json().catch(() => ({ error: res.statusText }));\n    console.error(`Error: ${(body as { error?: string }).error ?? res.statusText}`);\n    process.exit(1);\n  }\n\n  const body = (await res.json()) as DocsApiResponse;\n  const versions = body.data?.versions ?? [];\n\n  if (jsonOutput) {\n    console.log(JSON.stringify(versions, null, 2));\n    return;\n  }\n\n  if (versions.length === 0) {\n    console.log(`No versions found for ${slug}.`);\n    return;\n  }\n\n  for (const v of versions) {\n    const date = new Date(v.createdAt).toISOString().slice(0, 19).replace(\"T\", \" \");\n    const msg = v.message ? ` — ${v.message}` : \"\";\n    console.log(`  v${v.version}  ${date}  ${v.createdBy}${msg}`);\n  }\n}\n\nasync function handleCreate(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const slug = argv[0];\n  if (!slug || slug.startsWith(\"--\")) {\n    console.error(\"Error: Missing slug.\");\n    console.error(\"Usage: canary docs create <slug> --file <path> --title <text>\");\n    process.exit(1);\n  }\n\n  const filePath = getArgValue(argv, \"--file\");\n  const title = getArgValue(argv, \"--title\");\n\n  if (!filePath) {\n    console.error(\"Error: Missing --file <path>.\");\n    process.exit(1);\n  }\n  if (!title) {\n    console.error(\"Error: Missing --title <text>.\");\n    process.exit(1);\n  }\n\n  const description = getArgValue(argv, \"--description\") ?? undefined;\n  const message = getArgValue(argv, \"--message\") ?? undefined;\n\n  let content: string;\n  try {\n    content = await readFile(filePath, \"utf8\");\n  } catch {\n    console.error(`Error: Could not read file: ${filePath}`);\n    process.exit(1);\n  }\n\n  const result = await apiRequest<DocsApiResponse>(apiUrl, token, \"POST\", \"/superadmin/docs/pages\", {\n    slug,\n    title,\n    description,\n    content,\n    message,\n  });\n\n  if (!result.ok) {\n    console.error(`Error: ${result.error}`);\n    process.exit(1);\n  }\n\n  console.log(`Created page: ${slug}`);\n}\n\nasync function handleDelete(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const slug = argv[0];\n  if (!slug || slug.startsWith(\"--\")) {\n    console.error(\"Error: Missing slug.\");\n    console.error(\"Usage: canary docs delete <slug>\");\n    process.exit(1);\n  }\n\n  const result = await apiRequest<DocsApiResponse>(\n    apiUrl,\n    token,\n    \"DELETE\",\n    `/superadmin/docs/pages?slug=${encodeURIComponent(slug)}`\n  );\n\n  if (!result.ok) {\n    console.error(`Error: ${result.error}`);\n    process.exit(1);\n  }\n\n  console.log(`Deleted page: ${slug}`);\n}\n\nfunction printDocsHelp(): void {\n  console.log(\n    [\n      \"Usage: canary docs <sub-command> [options]\",\n      \"\",\n      \"Sub-commands:\",\n      \"  list                                    List all doc pages\",\n      \"  get <slug>                              Print content to stdout\",\n      \"  pull <slug> [--output <path>]           Download to local file\",\n      \"  push <slug> --file <path> [--message]   Publish new version\",\n      \"  history <slug>                          Show version history\",\n      \"  create <slug> --file <path> --title ... Create new page\",\n      \"  delete <slug>                           Soft-delete a page\",\n      \"\",\n      \"Options:\",\n      \"  --file <path>          Path to markdown file\",\n      \"  --title <text>         Page title (create only)\",\n      \"  --description <text>   Page description (create only)\",\n      \"  --message <text>       Version commit message\",\n      \"  --output <path>        Output path for pull (default: /tmp/canary-docs/<slug>.md)\",\n      \"  --json                 Output as JSON (list, history)\",\n      \"  --env <env>            Target environment (prod, dev)\",\n      \"  --api-url <url>        API URL override\",\n      \"  --token <key>          API token override\",\n    ].join(\"\\n\")\n  );\n}\n\nexport async function runDocs(argv: string[]): Promise<void> {\n  const [subCommand, ...rest] = argv;\n\n  if (!subCommand || subCommand === \"help\" || hasFlag(argv, \"--help\", \"-h\")) {\n    printDocsHelp();\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 \"pull\":\n      await handlePull(rest, apiUrl, token);\n      break;\n    case \"push\":\n      await handlePush(rest, apiUrl, token);\n      break;\n    case \"history\":\n      await handleHistory(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    default:\n      console.error(`Unknown sub-command: ${subCommand}`);\n      printDocsHelp();\n      process.exit(1);\n  }\n}\n"],"mappings":"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","names":["body"]}

package/dist/{feature-flag-D3QTHGL6.js → feature-flag-S5B5GLPP.js}

@@ -1,15 +1,16 @@
+import { createRequire as __cr } from "module"; const require = __cr(import.meta.url);
 import {
   apiRequest,
   fetchList,
   parseLifecycleStage,
   toLifecycleLabel
-} from "./chunk-DXJNFJ3A.js";
+} from "./chunk-6WWHXWCS.js";
 import {
   getArgValue,
   hasFlag,
   resolveConfig
-} from "./chunk-7R4YFGP6.js";
-import "./chunk-PLDDJCW6.js";
+} from "./chunk-PWWQGYFG.js";
+import "./chunk-VLFUCAPZ.js";
 
 // src/feature-flag.ts
 import process from "process";
@@ -29,9 +30,10 @@ async function handleList(argv, apiUrl, token) {
   }
   for (const flag of flags) {
     const orgCount = flag.organizations?.length ?? 0;
+    const userCount = flag.users?.length ?? 0;
     const lifecycle = `lifecycle=${toLifecycleLabel(flag.lifecycleStage)}`;
     const finalValue = flag.lifecycleStage === "active" ? "" : ` final=${flag.finalValue === true ? "true" : "false"}`;
-    console.log(`  ${flag.name}  ${flag.description ?? ""}  (${lifecycle}${finalValue})  [orgs=${orgCount}]`);
+    console.log(`  ${flag.name}  ${flag.description ?? ""}  (${lifecycle}${finalValue})  [orgs=${orgCount}, users=${userCount}]`);
   }
 }
 async function handleCreate(argv, apiUrl, token) {
@@ -74,52 +76,90 @@ async function handleDelete(argv, apiUrl, token) {
 async function handleEnable(argv, apiUrl, token) {
   const name = argv[0];
   const orgId = getArgValue(argv, "--org");
+  const userId = getArgValue(argv, "--user");
   if (!name || name.startsWith("--")) {
     console.error("Error: Missing flag name.");
-    console.error("Usage: canary feature-flag enable <name> --org <orgId>");
+    console.error("Usage: canary feature-flag enable <name> (--org <orgId> | --user <userId>)");
     process.exit(1);
   }
-  if (!orgId) {
-    console.error("Error: Missing --org <orgId>.");
-    console.error("Usage: canary feature-flag enable <name> --org <orgId>");
+  if (orgId && userId) {
+    console.error("Error: Provide either --org or --user, not both.");
     process.exit(1);
   }
-  const result = await apiRequest(
-    apiUrl,
-    token,
-    "POST",
-    `/superadmin/feature-flags/${encodeURIComponent(name)}/organizations/${encodeURIComponent(orgId)}`
-  );
-  if (!result.ok) {
-    console.error(`Error: ${result.error}`);
+  if (!orgId && !userId) {
+    console.error("Error: Provide either --org <orgId> or --user <userId>.");
+    console.error("Usage: canary feature-flag enable <name> (--org <orgId> | --user <userId>)");
     process.exit(1);
   }
-  console.log(`Enabled ${name} for org ${orgId}`);
+  if (orgId) {
+    const result = await apiRequest(
+      apiUrl,
+      token,
+      "POST",
+      `/superadmin/feature-flags/${encodeURIComponent(name)}/organizations/${encodeURIComponent(orgId)}`
+    );
+    if (!result.ok) {
+      console.error(`Error: ${result.error}`);
+      process.exit(1);
+    }
+    console.log(`Enabled ${name} for org ${orgId}`);
+  } else {
+    const result = await apiRequest(
+      apiUrl,
+      token,
+      "POST",
+      `/superadmin/feature-flags/${encodeURIComponent(name)}/users/${encodeURIComponent(userId)}`
+    );
+    if (!result.ok) {
+      console.error(`Error: ${result.error}`);
+      process.exit(1);
+    }
+    console.log(`Enabled ${name} for user ${userId}`);
+  }
 }
 async function handleDisable(argv, apiUrl, token) {
   const name = argv[0];
   const orgId = getArgValue(argv, "--org");
+  const userId = getArgValue(argv, "--user");
   if (!name || name.startsWith("--")) {
     console.error("Error: Missing flag name.");
-    console.error("Usage: canary feature-flag disable <name> --org <orgId>");
+    console.error("Usage: canary feature-flag disable <name> (--org <orgId> | --user <userId>)");
     process.exit(1);
   }
-  if (!orgId) {
-    console.error("Error: Missing --org <orgId>.");
-    console.error("Usage: canary feature-flag disable <name> --org <orgId>");
+  if (orgId && userId) {
+    console.error("Error: Provide either --org or --user, not both.");
     process.exit(1);
   }
-  const result = await apiRequest(
-    apiUrl,
-    token,
-    "DELETE",
-    `/superadmin/feature-flags/${encodeURIComponent(name)}/organizations/${encodeURIComponent(orgId)}`
-  );
-  if (!result.ok) {
-    console.error(`Error: ${result.error}`);
+  if (!orgId && !userId) {
+    console.error("Error: Provide either --org <orgId> or --user <userId>.");
+    console.error("Usage: canary feature-flag disable <name> (--org <orgId> | --user <userId>)");
     process.exit(1);
   }
-  console.log(`Disabled ${name} for org ${orgId}`);
+  if (orgId) {
+    const result = await apiRequest(
+      apiUrl,
+      token,
+      "DELETE",
+      `/superadmin/feature-flags/${encodeURIComponent(name)}/organizations/${encodeURIComponent(orgId)}`
+    );
+    if (!result.ok) {
+      console.error(`Error: ${result.error}`);
+      process.exit(1);
+    }
+    console.log(`Disabled ${name} for org ${orgId}`);
+  } else {
+    const result = await apiRequest(
+      apiUrl,
+      token,
+      "DELETE",
+      `/superadmin/feature-flags/${encodeURIComponent(name)}/users/${encodeURIComponent(userId)}`
+    );
+    if (!result.ok) {
+      console.error(`Error: ${result.error}`);
+      process.exit(1);
+    }
+    console.log(`Disabled ${name} for user ${userId}`);
+  }
 }
 async function handleLifecycle(argv, apiUrl, token) {
   const name = argv[0];
@@ -180,14 +220,18 @@ function printFeatureFlagHelp() {
       "  list                                          List all feature flags",
       "  create <name> [--description <text>]         Create a new flag",
       "  delete <name>                                 Delete a flag and all its gates",
-      "  enable <name> --org <orgId>                   Enable a flag for an organization",
-      "  disable <name> --org <orgId>                  Disable a flag for an organization",
+      "  enable <name> (--org <orgId> | --user <userId>)",
+      "                                                Enable a flag for an org or user",
+      "  disable <name> (--org <orgId> | --user <userId>)",
+      "                                                Disable a flag for an org or user",
       "  lifecycle <name> --stage <stage> [--final-value true|false]",
       "                                                Mark lifecycle + final value",
       "",
       "Stages: active, deprecated, ready_for_cleanup",
       "",
       "Options:",
+      "  --org <orgId>              Target organization",
+      "  --user <userId>            Target user",
       "  --final-value <true|false>  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)",
@@ -232,4 +276,4 @@ async function runFeatureFlag(argv) {
 export {
   runFeatureFlag
 };
-//# sourceMappingURL=feature-flag-D3QTHGL6.js.map
+//# sourceMappingURL=feature-flag-S5B5GLPP.js.map

package/dist/feature-flag-S5B5GLPP.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  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\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    console.log(`  ${flag.name}  ${flag.description ?? \"\"}  (${lifecycle}${finalValue})  [orgs=${orgCount}, users=${userCount}]`);\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  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>]         Create a new flag\",\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\",\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      \"  --org <orgId>              Target organization\",\n      \"  --user <userId>            Target user\",\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

@@ -1,10 +1,11 @@
+import { createRequire as __cr } from "module"; const require = __cr(import.meta.url);
 import {
   connectTunnel,
   createLocalRun,
   createTunnel,
   runLocalTest,
   runTunnel
-} from "./chunk-HOYYXZPV.js";
+} from "./chunk-DXIAHB72.js";
 import {
   ENV_URLS,
   envToProfile,
@@ -15,10 +16,10 @@ import {
   readStoredToken,
   resolveConfig,
   saveAuth
-} from "./chunk-7R4YFGP6.js";
+} from "./chunk-PWWQGYFG.js";
 import {
   __require
-} from "./chunk-PLDDJCW6.js";
+} from "./chunk-VLFUCAPZ.js";
 
 // src/index.ts
 import { spawnSync as spawnSync2 } from "child_process";
@@ -909,9 +910,10 @@ function isSuperadminToken(token) {
 // src/index.ts
 var require2 = createRequire2(import.meta.url);
 var pkg = require2("../package.json");
-var loadMcp = () => import("./mcp-LKHFYMA6.js").then((m) => m.runMcp);
-var loadLocalBrowser = () => import("./local-browser-YSE3XCUW.js").then((m) => m.runLocalBrowser);
-var loadDebugWorkflow = () => import("./debug-workflow-PMLMWKWI.js").then((m) => m.runDebugWorkflow);
+var loadMcp = () => import("./mcp-HGYBMDYZ.js").then((m) => m.runMcp);
+var loadLocalBrowser = () => import("./local-browser-J6WGFLVD.js").then((m) => m.runLocalBrowser);
+var loadDebugWorkflow = () => import("./debug-workflow-PT3OUR3V.js").then((m) => m.runDebugWorkflow);
+var loadRecord = () => import("./record-X4SVNYP3.js").then((m) => m.runRecord);
 var canary = { run };
 var baseDir = typeof __dirname !== "undefined" ? __dirname : path4.dirname(fileURLToPath2(import.meta.url));
 var preloadPath = path4.join(baseDir, "runner", "preload.js");
@@ -955,6 +957,7 @@ function printHelp({ isSuperadmin }) {
     "  canary login [--org <name>] [--app-url https://app.trycanary.ai] [--no-open]",
     "  canary orgs                            List organizations",
     "  canary debug <workflowId> [options]    Debug workflow in local headed browser",
+    "  canary record [options]                 Record browser interactions",
     "  canary issues <sub-command>            Search and view issues"
   ];
   lines.push(
@@ -965,6 +968,7 @@ function printHelp({ isSuperadmin }) {
       "  canary debug-session [--env dev|local] [--json]  Create browser debug session",
       "  canary psql <query> [--json]            Execute read-only SQL",
       "  canary redis <command> [--json]         Execute read-only Redis commands",
+      "  canary docs <sub-command>               Manage documentation pages",
       "  canary feature-flag <sub-command>       Manage feature flags",
       "  canary knobs <sub-command>              Manage knobs (global config)"
     );
@@ -1169,37 +1173,47 @@ async function main(argv) {
     await runDebugWorkflow(rest);
     return;
   }
+  if (command === "record") {
+    const runRecord = await loadRecord();
+    await runRecord(rest);
+    return;
+  }
   if (command === "debug-session") {
     await runDebugSession(rest);
     return;
   }
   if (command === "psql") {
-    const { runPsql } = await import("./psql-U5LF6ELS.js");
+    const { runPsql } = await import("./psql-WVIHMC6A.js");
     await runPsql(rest);
     return;
   }
   if (command === "redis") {
-    const { runRedis } = await import("./redis-PBQZGU6T.js");
+    const { runRedis } = await import("./redis-RGHECKV5.js");
     await runRedis(rest);
     return;
   }
   if (command === "release") {
-    const { runRelease } = await import("./release-QBSP474D.js");
+    const { runRelease } = await import("./release-ZOD4Y2BF.js");
     await runRelease(rest);
     return;
   }
+  if (command === "docs") {
+    const { runDocs } = await import("./docs-GCYDTEOY.js");
+    await runDocs(rest);
+    return;
+  }
   if (command === "feature-flag") {
-    const { runFeatureFlag } = await import("./feature-flag-D3QTHGL6.js");
+    const { runFeatureFlag } = await import("./feature-flag-S5B5GLPP.js");
     await runFeatureFlag(rest);
     return;
   }
   if (command === "knobs") {
-    const { runKnobs } = await import("./knobs-ED6LXBVM.js");
+    const { runKnobs } = await import("./knobs-RKUVK3HC.js");
     await runKnobs(rest);
     return;
   }
   if (command === "issues") {
-    const { runIssues } = await import("./issues-6MHRFKTU.js");
+    const { runIssues } = await import("./issues-4ZEDHPLW.js");
     await runIssues(rest);
     return;
   }