@runcofactor/cli 0.13.0 → 0.15.1

package/dist/{chunk-EJ4U242G.js → chunk-UZ2ZA5A6.js}

@@ -1,7 +1,7 @@
 import { createRequire as __cr } from "module"; const require = __cr(import.meta.url);
 import {
   PlaywrightClient
-} from "./chunk-QQVWGWPI.js";
+} from "./chunk-5R4HMSNX.js";
 
 // src/local-browser/host.ts
 var HEARTBEAT_INTERVAL_MS = 3e4;
@@ -410,4 +410,4 @@ export {
   LocalBrowserHost,
   USER_PAUSED_ERROR
 };
-//# sourceMappingURL=chunk-EJ4U242G.js.map
+//# sourceMappingURL=chunk-UZ2ZA5A6.js.map

package/dist/{chunk-EEN2TZUQ.js → chunk-VKBTI5EF.js}

@@ -1,12 +1,12 @@
 import { createRequire as __cr } from "module"; const require = __cr(import.meta.url);
 import {
   apiRequest
-} from "./chunk-CQE46HSM.js";
+} from "./chunk-CFJXYPTF.js";
 import {
   getArgValue,
   hasFlag,
   resolveConfig
-} from "./chunk-PZ4LCN6K.js";
+} from "./chunk-IGHDIWZU.js";
 
 // src/tag.ts
 import process from "process";
@@ -423,4 +423,4 @@ export {
   applyWorkflowTagFlags,
   runTag
 };
-//# sourceMappingURL=chunk-EEN2TZUQ.js.map
+//# sourceMappingURL=chunk-VKBTI5EF.js.map

package/dist/{chunk-ENDHMYEJ.js → chunk-ZXRVFFCY.js}

@@ -1,12 +1,12 @@
 import { createRequire as __cr } from "module"; const require = __cr(import.meta.url);
 import {
   apiRequest
-} from "./chunk-CQE46HSM.js";
+} from "./chunk-CFJXYPTF.js";
 import {
   getArgValue,
   hasFlag,
   resolveConfig
-} from "./chunk-PZ4LCN6K.js";
+} from "./chunk-IGHDIWZU.js";
 
 // src/triage.ts
 import process from "process";
@@ -268,4 +268,4 @@ export {
   isTriageEnabledForExecution,
   runTriage
 };
-//# sourceMappingURL=chunk-ENDHMYEJ.js.map
+//# sourceMappingURL=chunk-ZXRVFFCY.js.map

package/dist/{credential-LO2SEEHU.js → credential-JGVSEGVH.js}

@@ -3,7 +3,7 @@ import {
   apiRequest,
   fetchProperties,
   getApplicationArg
-} from "./chunk-CQE46HSM.js";
+} from "./chunk-CFJXYPTF.js";
 import {
   apiFetch,
   exitOnFailure
@@ -12,10 +12,10 @@ import {
   getArgValue,
   hasFlag,
   resolveConfig
-} from "./chunk-PZ4LCN6K.js";
-import "./chunk-JZMJUPZP.js";
+} from "./chunk-IGHDIWZU.js";
+import "./chunk-32P26BZT.js";
 import "./chunk-JWHYXEA2.js";
-import "./chunk-QGI4UCJX.js";
+import "./chunk-IWKJQZJQ.js";
 import "./chunk-VKVL7WBN.js";
 
 // src/credential.ts
@@ -451,4 +451,4 @@ async function runCredential(argv) {
 export {
   runCredential
 };
-//# sourceMappingURL=credential-LO2SEEHU.js.map
+//# sourceMappingURL=credential-JGVSEGVH.js.map

package/dist/{credential-template-ZN7W7734.js → credential-template-CWWMOKB2.js}

@@ -3,16 +3,16 @@ import {
   apiRequest,
   fetchProperties,
   getApplicationArg
-} from "./chunk-CQE46HSM.js";
+} from "./chunk-CFJXYPTF.js";
 import "./chunk-3CZU7XCS.js";
 import {
   getArgValue,
   hasFlag,
   resolveConfig
-} from "./chunk-PZ4LCN6K.js";
-import "./chunk-JZMJUPZP.js";
+} from "./chunk-IGHDIWZU.js";
+import "./chunk-32P26BZT.js";
 import "./chunk-JWHYXEA2.js";
-import "./chunk-QGI4UCJX.js";
+import "./chunk-IWKJQZJQ.js";
 import "./chunk-VKVL7WBN.js";
 
 // src/credential-template.ts
@@ -290,4 +290,4 @@ async function runCredentialTemplate(argv) {
 export {
   runCredentialTemplate
 };
-//# sourceMappingURL=credential-template-ZN7W7734.js.map
+//# sourceMappingURL=credential-template-CWWMOKB2.js.map

package/dist/{debug-workflow-R3RYYAXK.js → debug-workflow-BXRU72YZ.js}

@@ -7,16 +7,16 @@ import {
 } from "./chunk-J6SH7GQT.js";
 import {
   downloadStorageState
-} from "./chunk-CQE46HSM.js";
+} from "./chunk-CFJXYPTF.js";
 import "./chunk-3CZU7XCS.js";
 import {
   getArgValue,
   hasFlag,
   resolveConfig
-} from "./chunk-PZ4LCN6K.js";
-import "./chunk-JZMJUPZP.js";
+} from "./chunk-IGHDIWZU.js";
+import "./chunk-32P26BZT.js";
 import "./chunk-JWHYXEA2.js";
-import "./chunk-QGI4UCJX.js";
+import "./chunk-IWKJQZJQ.js";
 import "./chunk-VKVL7WBN.js";
 
 // src/debug-workflow.ts
@@ -257,4 +257,4 @@ async function runDebugWorkflow(argv) {
 export {
   runDebugWorkflow
 };
-//# sourceMappingURL=debug-workflow-R3RYYAXK.js.map
+//# sourceMappingURL=debug-workflow-BXRU72YZ.js.map

package/dist/{docs-DIAFBDXQ.js → docs-PVBXPTGR.js}

@@ -1,18 +1,18 @@
 import { createRequire as __cr } from "module"; const require = __cr(import.meta.url);
 import {
   apiRequest
-} from "./chunk-CQE46HSM.js";
+} from "./chunk-CFJXYPTF.js";
 import "./chunk-3CZU7XCS.js";
 import {
   getArgValue,
   hasFlag,
   resolveConfig
-} from "./chunk-PZ4LCN6K.js";
-import "./chunk-JZMJUPZP.js";
+} from "./chunk-IGHDIWZU.js";
+import "./chunk-32P26BZT.js";
 import {
   getSubDir
 } from "./chunk-JWHYXEA2.js";
-import "./chunk-QGI4UCJX.js";
+import "./chunk-IWKJQZJQ.js";
 import "./chunk-VKVL7WBN.js";
 
 // src/docs.ts
@@ -25,9 +25,9 @@ function parseNavFields(argv) {
   const section = getArgValue(argv, "--section");
   const group = getArgValue(argv, "--group");
   const order = getArgValue(argv, "--order");
-  if (section != null) out.navSection = section;
-  if (group != null) out.navGroup = group;
-  if (order != null) {
+  if (section !== null && section !== void 0) out.navSection = section;
+  if (group !== null && group !== void 0) out.navGroup = group;
+  if (order !== null && order !== void 0) {
     const n = Number.parseInt(order, 10);
     if (Number.isNaN(n)) {
       console.error("Error: --order must be an integer.");
@@ -289,6 +289,83 @@ async function handleDelete(argv, apiUrl, token, orgMode) {
   }
   console.log(`Deleted page: ${slug}`);
 }
+async function handleNav(argv, apiUrl, token) {
+  const [action, ...rest] = argv;
+  switch (action) {
+    case void 0:
+    case "list": {
+      const result = await apiRequest(
+        apiUrl,
+        token,
+        "GET",
+        "/public/docs/nav"
+      );
+      const groups = result.data?.groups ?? [];
+      if (hasFlag(rest, "--json")) {
+        console.log(JSON.stringify(groups, null, 2));
+        return;
+      }
+      if (groups.length === 0) {
+        console.log("No sidebar groups found.");
+        return;
+      }
+      const keyWidth = Math.max(3, ...groups.map((g) => g.key.length));
+      const titleWidth = Math.max(5, ...groups.map((g) => g.title.length));
+      console.log(`| ${"Key".padEnd(keyWidth)} | ${"Title".padEnd(titleWidth)} | Order |`);
+      console.log(`| ${"-".repeat(keyWidth)} | ${"-".repeat(titleWidth)} | ----- |`);
+      for (const g of groups) {
+        console.log(`| ${g.key.padEnd(keyWidth)} | ${g.title.padEnd(titleWidth)} | ${String(g.sortOrder).padEnd(5)} |`);
+      }
+      return;
+    }
+    case "set": {
+      const key = rest[0];
+      if (!key || key.startsWith("--")) {
+        console.error("Usage: canary docs nav set <key> [--title <text>] [--order <n>]");
+        process.exit(1);
+      }
+      const title = getArgValue(rest, "--title");
+      const orderRaw = getArgValue(rest, "--order");
+      const body = {};
+      if (title !== null && title !== void 0) body.title = title;
+      if (orderRaw !== null && orderRaw !== void 0) {
+        const n = Number.parseInt(orderRaw, 10);
+        if (Number.isNaN(n)) {
+          console.error("Error: --order must be an integer.");
+          process.exit(1);
+        }
+        body.sortOrder = n;
+      }
+      await apiRequest(apiUrl, token, "PUT", `/superadmin/docs/nav?key=${encodeURIComponent(key)}`, body);
+      console.log(`Updated sidebar group: ${key}`);
+      return;
+    }
+    case "reorder": {
+      const keys = rest.filter((a) => !a.startsWith("--"));
+      if (keys.length === 0) {
+        console.error("Usage: canary docs nav reorder <key1> <key2> ...");
+        process.exit(1);
+      }
+      await apiRequest(apiUrl, token, "PUT", "/superadmin/docs/nav/reorder", { keys });
+      console.log(`Reordered ${keys.length} sidebar groups.`);
+      return;
+    }
+    case "delete": {
+      const key = rest[0];
+      if (!key || key.startsWith("--")) {
+        console.error("Usage: canary docs nav delete <key>");
+        process.exit(1);
+      }
+      await apiRequest(apiUrl, token, "DELETE", `/superadmin/docs/nav?key=${encodeURIComponent(key)}`);
+      console.log(`Deleted sidebar group: ${key}`);
+      return;
+    }
+    default:
+      console.error(`Unknown nav action: ${action}`);
+      console.error("Actions: list, set <key>, reorder <keys...>, delete <key>");
+      process.exit(1);
+  }
+}
 function printDocsHelp() {
   console.log(
     [
@@ -303,15 +380,19 @@ function printDocsHelp() {
       "  history <slug>                          Show version history",
       "  create <slug> --file <path> --title ... Create new page",
       "  delete <slug>                           Soft-delete a page",
+      "  nav list [--json]                       List sidebar groups + order",
+      "  nav set <key> [--title <t>] [--order n] Create or update a sidebar group",
+      "  nav reorder <key1> <key2> ...           Set sidebar group order",
+      "  nav delete <key>                        Remove a sidebar group",
       "",
       "Options:",
       "  --org                  Use org-scoped endpoints (requires auth)",
       "  --file <path>          Path to markdown file",
       "  --title <text>         Page title (create only)",
       "  --description <text>   Page description (create only)",
-      "  --section <text>       Sidebar section (data-driven nav; create/push)",
-      "  --group <text>         Sidebar sub-group within the section (create/push)",
-      "  --order <n>            Sort order within the section/group (create/push)",
+      "  --group <key>          Sidebar group key the page belongs to (see `nav list`; create/push)",
+      "  --order <n>            Sort order within the group (create/push)",
+      "  --section <text>       Deprecated; sidebar grouping is driven by --group now",
       "  --message <text>       Version commit message",
       "  --limit <n>            Max results for search (default: 8, max: 20)",
       "  --output <path>        Output path for pull (default: <tmpdir>/canary/docs/<slug>.md)",
@@ -355,6 +436,9 @@ async function runDocs(argv) {
     case "delete":
       await handleDelete(rest, apiUrl, token, orgMode);
       break;
+    case "nav":
+      await handleNav(rest, apiUrl, token);
+      break;
     default:
       console.error(`Unknown sub-command: ${subCommand}`);
       printDocsHelp();
@@ -364,4 +448,4 @@ async function runDocs(argv) {
 export {
   runDocs
 };
-//# sourceMappingURL=docs-DIAFBDXQ.js.map
+//# sourceMappingURL=docs-PVBXPTGR.js.map

package/dist/docs-PVBXPTGR.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 * Supports both global (public/superadmin) and org-scoped (--org) modes.\n */\n\nimport { readFile, writeFile, mkdir } from 'node:fs/promises';\nimport path from 'node:path';\nimport { getSubDir } from '@chatsdet/tmp';\nimport process from 'node:process';\nimport { resolveConfig, getArgValue, hasFlag } from './auth.js';\nimport { apiRequest } 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 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 = getSubDir('docs');\n\n/**\n * Parse the optional data-driven sidebar-placement flags. Only present flags\n * are included, so `push`/`create` without them leaves existing values intact.\n */\nfunction parseNavFields(argv: string[]): {\n  navSection?: string;\n  navGroup?: string;\n  navOrder?: number;\n} {\n  const out: { navSection?: string; navGroup?: string; navOrder?: number } = {};\n  const section = getArgValue(argv, '--section');\n  const group = getArgValue(argv, '--group');\n  const order = getArgValue(argv, '--order');\n  if (section !== null && section !== undefined) out.navSection = section;\n  if (group !== null && group !== undefined) out.navGroup = group;\n  if (order !== null && order !== undefined) {\n    const n = Number.parseInt(order, 10);\n    if (Number.isNaN(n)) {\n      console.error('Error: --order must be an integer.');\n      process.exit(1);\n    }\n    out.navOrder = n;\n  }\n  return out;\n}\n\n/** Return the base path prefix for read endpoints based on --org flag */\nfunction readPrefix(orgMode: boolean): string {\n  return orgMode ? '/docs' : '/public/docs';\n}\n\n/** Return the base path prefix for write endpoints based on --org flag */\nfunction writePrefix(orgMode: boolean): string {\n  return orgMode ? '/docs' : '/superadmin/docs';\n}\n\nasync function handleList(argv: string[], apiUrl: string, token: string, orgMode: boolean): Promise<void> {\n  const jsonOutput = hasFlag(argv, '--json');\n  const result = await apiRequest<DocsApiResponse>(apiUrl, token, 'GET', `${readPrefix(orgMode)}/pages`);\n  const pages: DocsPageListItem[] = result.data?.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  // Default: markdown table for easy consumption by agents and humans\n  const slugWidth = Math.max(4, ...pages.map((p) => p.slug.length));\n  const titleWidth = Math.max(5, ...pages.map((p) => p.title.length));\n  const header = `| ${'Slug'.padEnd(slugWidth)} | ${'Title'.padEnd(titleWidth)} | Updated    | Published By |`;\n  const sep = `| ${'-'.repeat(slugWidth)} | ${'-'.repeat(titleWidth)} | ---------- | ------------ |`;\n  console.log(header);\n  console.log(sep);\n  for (const page of pages) {\n    const date = new Date(page.updatedAt).toISOString().slice(0, 10);\n    const by = page.publishedBy ?? '';\n    console.log(`| ${page.slug.padEnd(slugWidth)} | ${page.title.padEnd(titleWidth)} | ${date} | ${by.padEnd(12)} |`);\n  }\n}\n\nasync function fetchDocContent(slug: string, apiUrl: string, token: string, orgMode: boolean): Promise<string> {\n  if (orgMode) {\n    const result = await apiRequest<DocsApiResponse>(\n      apiUrl,\n      token,\n      'GET',\n      `/docs/pages/content?slug=${encodeURIComponent(slug)}`\n    );\n    if (!result.ok) {\n      console.error(`Error: ${result.error}`);\n      process.exit(1);\n    }\n    return result.data?.content ?? '';\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  return res.text();\n}\n\nasync function handleGet(argv: string[], apiUrl: string, token: string, orgMode: boolean): 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 content = await fetchDocContent(slug, apiUrl, token, orgMode);\n  console.log(content);\n}\n\nasync function handlePull(argv: string[], apiUrl: string, token: string, orgMode: boolean): 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  const content = await fetchDocContent(slug, apiUrl, token, orgMode);\n\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, orgMode: boolean): 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  // Strip `export const meta = { ... };` block so raw JS isn't stored as doc content\n  content = content.replace(/^\\s*export\\s+const\\s+meta\\s*=\\s*\\{[^}]*\\};\\s*/, '');\n\n  const result = await apiRequest<DocsApiResponse>(\n    apiUrl,\n    token,\n    'PUT',\n    `${writePrefix(orgMode)}/pages?slug=${encodeURIComponent(slug)}`,\n    { content, message, createdBy, ...parseNavFields(argv) }\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, orgMode: boolean): 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(`${apiUrl}${readPrefix(orgMode)}/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, orgMode: boolean): 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  // Strip `export const meta = { ... };` block so raw JS isn't stored as doc content\n  content = content.replace(/^\\s*export\\s+const\\s+meta\\s*=\\s*\\{[^}]*\\};\\s*/, '');\n\n  const result = await apiRequest<DocsApiResponse>(\n    apiUrl,\n    token,\n    'POST',\n    `${writePrefix(orgMode)}/pages`,\n    {\n      slug,\n      title,\n      description,\n      content,\n      message,\n      ...parseNavFields(argv),\n    }\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\ntype DocsSearchResult = {\n  path: string;\n  title: string;\n  description: string | null;\n  excerpt: string;\n};\n\ntype DocsSearchResponse = {\n  ok: boolean;\n  error?: string;\n  data?: { results: DocsSearchResult[] };\n};\n\nasync function handleSearch(argv: string[], apiUrl: string, token: string, orgMode: boolean): Promise<void> {\n  const query = argv.filter((a) => !a.startsWith('--')).join(' ').trim();\n  if (!query) {\n    console.error('Error: Missing search query.');\n    console.error('Usage: canary docs search <query> [--limit <n>] [--json]');\n    process.exit(1);\n  }\n\n  const jsonOutput = hasFlag(argv, '--json');\n  const limitArg = getArgValue(argv, '--limit');\n  const params = new URLSearchParams({ q: query });\n  if (limitArg) params.set('limit', limitArg);\n\n  const searchPath = orgMode ? '/docs/search' : '/public/docs/search';\n  const res = await fetch(`${apiUrl}${searchPath}?${params.toString()}`, {\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 DocsSearchResponse;\n  const results = body.data?.results ?? [];\n\n  if (jsonOutput) {\n    console.log(JSON.stringify(results, null, 2));\n    return;\n  }\n\n  if (results.length === 0) {\n    console.log('No results found.');\n    return;\n  }\n\n  for (const r of results) {\n    const desc = r.description ? `  ${r.description}` : '';\n    const excerpt = r.excerpt\n      ? `  ${r.excerpt.replace(/<\\/?mark>/g, '').replace(/\\n/g, ' ').slice(0, 120)}`\n      : '';\n    console.log(`  ${r.path ?? r.title}`);\n    if (r.title) console.log(`    ${r.title}${desc}`);\n    if (excerpt) console.log(`   ${excerpt}`);\n    console.log();\n  }\n}\n\nasync function handleDelete(argv: string[], apiUrl: string, token: string, orgMode: boolean): 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    `${writePrefix(orgMode)}/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\ntype DocsNavGroup = { key: string; title: string; sortOrder: number };\n\nasync function handleNav(argv: string[], apiUrl: string, token: string): Promise<void> {\n  const [action, ...rest] = argv;\n\n  switch (action) {\n    case undefined:\n    case 'list': {\n      const result = await apiRequest<{ ok: boolean; data?: { groups: DocsNavGroup[] }; error?: string }>(\n        apiUrl,\n        token,\n        'GET',\n        '/public/docs/nav'\n      );\n      const groups = result.data?.groups ?? [];\n      if (hasFlag(rest, '--json')) {\n        console.log(JSON.stringify(groups, null, 2));\n        return;\n      }\n      if (groups.length === 0) {\n        console.log('No sidebar groups found.');\n        return;\n      }\n      const keyWidth = Math.max(3, ...groups.map((g) => g.key.length));\n      const titleWidth = Math.max(5, ...groups.map((g) => g.title.length));\n      console.log(`| ${'Key'.padEnd(keyWidth)} | ${'Title'.padEnd(titleWidth)} | Order |`);\n      console.log(`| ${'-'.repeat(keyWidth)} | ${'-'.repeat(titleWidth)} | ----- |`);\n      for (const g of groups) {\n        console.log(`| ${g.key.padEnd(keyWidth)} | ${g.title.padEnd(titleWidth)} | ${String(g.sortOrder).padEnd(5)} |`);\n      }\n      return;\n    }\n    case 'set': {\n      const key = rest[0];\n      if (!key || key.startsWith('--')) {\n        console.error('Usage: canary docs nav set <key> [--title <text>] [--order <n>]');\n        process.exit(1);\n      }\n      const title = getArgValue(rest, '--title');\n      const orderRaw = getArgValue(rest, '--order');\n      const body: Record<string, unknown> = {};\n      if (title !== null && title !== undefined) body.title = title;\n      if (orderRaw !== null && orderRaw !== undefined) {\n        const n = Number.parseInt(orderRaw, 10);\n        if (Number.isNaN(n)) {\n          console.error('Error: --order must be an integer.');\n          process.exit(1);\n        }\n        body.sortOrder = n;\n      }\n      await apiRequest(apiUrl, token, 'PUT', `/superadmin/docs/nav?key=${encodeURIComponent(key)}`, body);\n      console.log(`Updated sidebar group: ${key}`);\n      return;\n    }\n    case 'reorder': {\n      const keys = rest.filter((a) => !a.startsWith('--'));\n      if (keys.length === 0) {\n        console.error('Usage: canary docs nav reorder <key1> <key2> ...');\n        process.exit(1);\n      }\n      await apiRequest(apiUrl, token, 'PUT', '/superadmin/docs/nav/reorder', { keys });\n      console.log(`Reordered ${keys.length} sidebar groups.`);\n      return;\n    }\n    case 'delete': {\n      const key = rest[0];\n      if (!key || key.startsWith('--')) {\n        console.error('Usage: canary docs nav delete <key>');\n        process.exit(1);\n      }\n      await apiRequest(apiUrl, token, 'DELETE', `/superadmin/docs/nav?key=${encodeURIComponent(key)}`);\n      console.log(`Deleted sidebar group: ${key}`);\n      return;\n    }\n    default:\n      console.error(`Unknown nav action: ${action}`);\n      console.error('Actions: list, set <key>, reorder <keys...>, delete <key>');\n      process.exit(1);\n  }\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      '  search <query>                          Full-text search docs',\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      '  nav list [--json]                       List sidebar groups + order',\n      '  nav set <key> [--title <t>] [--order n] Create or update a sidebar group',\n      '  nav reorder <key1> <key2> ...           Set sidebar group order',\n      '  nav delete <key>                        Remove a sidebar group',\n      '',\n      'Options:',\n      '  --org                  Use org-scoped endpoints (requires auth)',\n      '  --file <path>          Path to markdown file',\n      '  --title <text>         Page title (create only)',\n      '  --description <text>   Page description (create only)',\n      '  --group <key>          Sidebar group key the page belongs to (see `nav list`; create/push)',\n      '  --order <n>            Sort order within the group (create/push)',\n      '  --section <text>       Deprecated; sidebar grouping is driven by --group now',\n      '  --message <text>       Version commit message',\n      '  --limit <n>            Max results for search (default: 8, max: 20)',\n      '  --output <path>        Output path for pull (default: <tmpdir>/canary/docs/<slug>.md)',\n      '  --json                 Output as JSON (list, history, search)',\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  const orgMode = hasFlag(rest, '--org');\n\n  switch (subCommand) {\n    case 'list':\n      await handleList(rest, apiUrl, token, orgMode);\n      break;\n    case 'get':\n      await handleGet(rest, apiUrl, token, orgMode);\n      break;\n    case 'search':\n      await handleSearch(rest, apiUrl, token, orgMode);\n      break;\n    case 'pull':\n      await handlePull(rest, apiUrl, token, orgMode);\n      break;\n    case 'push':\n      await handlePush(rest, apiUrl, token, orgMode);\n      break;\n    case 'history':\n      await handleHistory(rest, apiUrl, token, orgMode);\n      break;\n    case 'create':\n      await handleCreate(rest, apiUrl, token, orgMode);\n      break;\n    case 'delete':\n      await handleDelete(rest, apiUrl, token, orgMode);\n      break;\n    case 'nav':\n      await handleNav(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/{doctor-NZPUSCRE.js → doctor-RHMKD4W5.js}

@@ -8,10 +8,10 @@ import {
   envToProfile,
   getArgValue,
   readStoredAuth
-} from "./chunk-PZ4LCN6K.js";
+} from "./chunk-IGHDIWZU.js";
 import {
   readBrandEnv
-} from "./chunk-JZMJUPZP.js";
+} from "./chunk-32P26BZT.js";
 import "./chunk-VKVL7WBN.js";
 
 // src/doctor.ts
@@ -133,4 +133,4 @@ async function runAuthDoctor(argv) {
 export {
   runAuthDoctor
 };
-//# sourceMappingURL=doctor-NZPUSCRE.js.map
+//# sourceMappingURL=doctor-RHMKD4W5.js.map

package/dist/{environment-RQVU4P5M.js → environment-WZKIO3R3.js}

@@ -2,16 +2,16 @@ import { createRequire as __cr } from "module"; const require = __cr(import.meta
 import {
   apiRequest,
   fetchProperties
-} from "./chunk-CQE46HSM.js";
+} from "./chunk-CFJXYPTF.js";
 import "./chunk-3CZU7XCS.js";
 import {
   getArgValue,
   hasFlag,
   resolveConfig
-} from "./chunk-PZ4LCN6K.js";
-import "./chunk-JZMJUPZP.js";
+} from "./chunk-IGHDIWZU.js";
+import "./chunk-32P26BZT.js";
 import "./chunk-JWHYXEA2.js";
-import "./chunk-QGI4UCJX.js";
+import "./chunk-IWKJQZJQ.js";
 import "./chunk-VKVL7WBN.js";
 
 // src/environment.ts
@@ -218,4 +218,4 @@ async function runEnvironment(argv) {
 export {
   runEnvironment
 };
-//# sourceMappingURL=environment-RQVU4P5M.js.map
+//# sourceMappingURL=environment-WZKIO3R3.js.map

package/dist/{feature-flag-XG26RURR.js → feature-flag-K5REGGDY.js}

@@ -4,20 +4,41 @@ import {
   fetchList,
   parseLifecycleStage,
   toLifecycleLabel
-} from "./chunk-CQE46HSM.js";
+} from "./chunk-CFJXYPTF.js";
 import "./chunk-3CZU7XCS.js";
 import {
   getArgValue,
   hasFlag,
   resolveConfig
-} from "./chunk-PZ4LCN6K.js";
-import "./chunk-JZMJUPZP.js";
+} from "./chunk-IGHDIWZU.js";
+import "./chunk-32P26BZT.js";
 import "./chunk-JWHYXEA2.js";
-import "./chunk-QGI4UCJX.js";
+import "./chunk-IWKJQZJQ.js";
 import "./chunk-VKVL7WBN.js";
 
 // src/feature-flag.ts
 import process from "process";
+import { readFileSync } from "fs";
+function readContent(value) {
+  if (value.startsWith("@")) {
+    return readFileSync(value.slice(1), "utf8");
+  }
+  return value;
+}
+var DAY_MS = 24 * 60 * 60 * 1e3;
+var DEFAULT_REVIEW_INTERVAL_DAYS = 7;
+var DEFAULT_MAX_WINDOW_DAYS = 30;
+function bakeStatus(flag) {
+  if (!flag.bakeStartedAt) return { ageDays: 0, burning: false };
+  const startedMs = new Date(flag.bakeStartedAt).getTime();
+  const ageMs = Date.now() - startedMs;
+  const maxWindow = flag.bakeMaxWindowDays ?? DEFAULT_MAX_WINDOW_DAYS;
+  return { ageDays: Math.floor(ageMs / DAY_MS), burning: ageMs > maxWindow * DAY_MS };
+}
+function formatBakeSuffix(flag) {
+  const { ageDays, burning } = bakeStatus(flag);
+  return ` baked=${ageDays}d${burning ? " \u{1F525}BURNING" : ""}`;
+}
 function fetchFlags(apiUrl, token) {
   return fetchList(apiUrl, token, "/superadmin/feature-flags", "flags");
 }
@@ -36,10 +57,11 @@ async function handleList(argv, apiUrl, token) {
     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"}`;
+    const finalValue = flag.lifecycleStage === "active" || flag.lifecycleStage === "baking" ? "" : ` final=${flag.finalValue === true ? "true" : "false"}`;
+    const bake = flag.lifecycleStage === "baking" ? formatBakeSuffix(flag) : "";
     const stale = flag.isStale ? " [STALE]" : "";
     const product = flag.productCardId ? ` product=${flag.productTitle ?? flag.productCardId}` : "";
-    console.log(`  ${flag.name}  ${flag.description ?? ""}  (${lifecycle}${finalValue})  [orgs=${orgCount}, users=${userCount}]${product}${stale}`);
+    console.log(`  ${flag.name}  ${flag.description ?? ""}  (${lifecycle}${finalValue})${bake}  [orgs=${orgCount}, users=${userCount}]${product}${stale}`);
   }
 }
 async function handleCreate(argv, apiUrl, token) {
@@ -218,20 +240,21 @@ async function handleLifecycle(argv, apiUrl, token) {
   const name = argv[0];
   if (!name || name.startsWith("--")) {
     console.error("Error: Missing flag name.");
-    console.error("Usage: canary feature-flag lifecycle <name> --stage <active|deprecated|ready_for_cleanup> [--final-value true|false]");
+    console.error('Usage: canary feature-flag lifecycle <name> --stage <active|baking|deprecated|ready_for_cleanup> [--final-value true|false] [--plan @file|"text"] [--review-interval <days>] [--max-window <days>]');
     process.exit(1);
   }
   const stage = parseLifecycleStage(argv);
   const rawFinalValue = getArgValue(argv, "--final-value");
   const clearFinalValue = hasFlag(argv, "--clear-final-value");
+  const gateDriven = stage === "active" || stage === "baking";
   if (rawFinalValue !== void 0 && clearFinalValue) {
     console.error("Error: use either --final-value or --clear-final-value, not both.");
     process.exit(1);
   }
   let finalValue = void 0;
-  if (stage === "active") {
+  if (gateDriven) {
     if (rawFinalValue !== void 0) {
-      console.error("Error: active stage does not accept --final-value.");
+      console.error(`Error: ${stage} stage does not accept --final-value.`);
       process.exit(1);
     }
     finalValue = void 0;
@@ -250,20 +273,74 @@ async function handleLifecycle(argv, apiUrl, token) {
     }
     finalValue = rawFinalValue === "true";
   }
+  let monitoringPlan;
+  let reviewIntervalDays;
+  let maxWindowDays;
+  if (stage === "baking") {
+    const rawPlan = getArgValue(argv, "--plan");
+    if (rawPlan !== void 0) monitoringPlan = readContent(rawPlan);
+    const rawInterval = getArgValue(argv, "--review-interval");
+    if (rawInterval !== void 0) {
+      reviewIntervalDays = Number.parseInt(rawInterval, 10);
+      if (!Number.isInteger(reviewIntervalDays) || reviewIntervalDays <= 0) {
+        console.error("Error: --review-interval must be a positive integer (days).");
+        process.exit(1);
+      }
+    }
+    const rawWindow = getArgValue(argv, "--max-window");
+    if (rawWindow !== void 0) {
+      maxWindowDays = Number.parseInt(rawWindow, 10);
+      if (!Number.isInteger(maxWindowDays) || maxWindowDays <= 0) {
+        console.error("Error: --max-window must be a positive integer (days).");
+        process.exit(1);
+      }
+    }
+  }
   const result = await apiRequest(
     apiUrl,
     token,
     "POST",
     `/superadmin/feature-flags/${encodeURIComponent(name)}/lifecycle`,
-    { stage, finalValue }
+    { stage, finalValue, monitoringPlan, reviewIntervalDays, maxWindowDays }
   );
   if (!result.ok || !result.flag) {
     console.error(`Error: ${result.error ?? "Failed to update lifecycle"}`);
     process.exit(1);
   }
+  if (result.flag.lifecycleStage === "baking") {
+    const { ageDays } = bakeStatus(result.flag);
+    console.log(
+      `Put ${name} in the oven: stage=baking, baked=${ageDays}d, review every ${result.flag.bakeReviewIntervalDays ?? DEFAULT_REVIEW_INTERVAL_DAYS}d, burns after ${result.flag.bakeMaxWindowDays ?? DEFAULT_MAX_WINDOW_DAYS}d.`
+    );
+    return;
+  }
   const final = result.flag.lifecycleStage === "active" ? "(none)" : result.flag.finalValue === true ? "true" : "false";
   console.log(`Updated lifecycle for ${name}: stage=${toLifecycleLabel(result.flag.lifecycleStage)}, final=${final}`);
 }
+async function handleOven(argv, apiUrl, token) {
+  const jsonOutput = hasFlag(argv, "--json");
+  const flags = await fetchList(apiUrl, token, "/superadmin/feature-flags/oven", "flags");
+  if (jsonOutput) {
+    console.log(JSON.stringify(flags, null, 2));
+    return;
+  }
+  if (flags.length === 0) {
+    console.log("The oven is empty \u2014 no flags are baking.");
+    return;
+  }
+  console.log(`In the oven (${flags.length}):`);
+  for (const flag of flags) {
+    const burn = flag.burning ? " \u{1F525}BURNING" : "";
+    const product = flag.productCardId ? ` product=${flag.productTitle ?? flag.productCardId}` : "";
+    console.log(
+      `  ${flag.name}  baked=${flag.bakeAgeDays}d (review ${flag.bakeReviewIntervalDays}d / burns ${flag.bakeMaxWindowDays}d)${burn}${product}`
+    );
+    if (flag.bakeMonitoringPlan) {
+      const firstLine = flag.bakeMonitoringPlan.split("\n")[0]?.slice(0, 100) ?? "";
+      console.log(`      plan: ${firstLine}`);
+    }
+  }
+}
 function printFeatureFlagHelp() {
   console.log(
     [
@@ -280,11 +357,14 @@ function printFeatureFlagHelp() {
       "                                                Disable a flag for an org or user (kept as 'was enabled' history)",
       "  lifecycle <name> --stage <stage> [--final-value true|false]",
       "                                                Mark lifecycle + final value",
+      "             --stage baking --plan @file [--review-interval <days>] [--max-window <days>]",
+      "                                                Put a flag in the oven (requires a linked product card)",
       "  product <name> (--product <productCardId> | --clear)",
       "                                                Link/unlink a flag to a product board item",
       "  products [--search <text>]                    List product board items (find product card ids)",
+      "  oven [--json]                                 List flags currently baking (age + burning state)",
       "",
-      "Stages: active, deprecated, ready_for_cleanup",
+      "Stages: active, baking, deprecated, ready_for_cleanup",
       "",
       "Options:",
       "  --org <orgId>              Target organization",
@@ -294,6 +374,9 @@ function printFeatureFlagHelp() {
       "  --search <text>            Filter product cards by title (products sub-command only)",
       "  --final-value <true|false>  Final value for deprecated/ready_for_cleanup",
       "  --clear-final-value         Clear final value (only valid with --stage active)",
+      '  --plan @file|"text"       Monitoring/telemetry plan (required to enter baking)',
+      "  --review-interval <days>    Days between oven-check reviews (baking; default 7)",
+      "  --max-window <days>         Days before a baking flag 'burns' (default 30)",
       "  --env <env>                 Target environment (prod, dev, local)",
       "  --json                      Output as JSON (list only)",
       "  --api-url <url>             API URL override (takes precedence over --env)",
@@ -333,6 +416,9 @@ async function runFeatureFlag(argv) {
     case "products":
       await handleProducts(rest, apiUrl, token);
       break;
+    case "oven":
+      await handleOven(rest, apiUrl, token);
+      break;
     default:
       console.error(`Unknown sub-command: ${subCommand}`);
       printFeatureFlagHelp();
@@ -342,4 +428,4 @@ async function runFeatureFlag(argv) {
 export {
   runFeatureFlag
 };
-//# sourceMappingURL=feature-flag-XG26RURR.js.map
+//# sourceMappingURL=feature-flag-K5REGGDY.js.map