@sunasteriskrnd/takumi 1.0.0-dev.57 → 1.0.0-dev.59

package/dist/index.js

@@ -19815,7 +19815,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@sunasteriskrnd/takumi",
-    version: "1.0.0-dev.57",
+    version: "1.0.0-dev.59",
     description: "CLI tool for bootstrapping and managing Takumi projects",
     type: "module",
     repository: {
@@ -19836,6 +19836,7 @@ var init_package = __esm(() => {
     scripts: {
       tkm: "bun scripts/run-cli.ts --",
       dev: "bun scripts/run-cli.ts --config src/lib/build-config/dev.json --",
+      stg: "bun scripts/run-cli.ts --config src/lib/build-config/stg.json --",
       build: "bun scripts/build-cli.ts",
       "build:dev": "bun scripts/build-cli.ts --config src/lib/build-config/dev.json",
       compile: "bun scripts/build-cli.ts --compile",
@@ -20011,7 +20012,7 @@ function getLegacyManifestPath(providerRoot) {
   return join4(providerRoot, LEGACY_MANIFEST_FILENAME);
 }
 function getCliVersion() {
-  return "1.0.0-dev.57"?.trim() || process.env.npm_package_version?.trim() || "unknown";
+  return "1.0.0-dev.59"?.trim() || process.env.npm_package_version?.trim() || "unknown";
 }
 function getCliUserAgent() {
   return `${TAKUMI_CLI_NPM_PACKAGE_NAME}/${getCliVersion()}`;
@@ -51481,79 +51482,230 @@ var init_auth_command_help = __esm(() => {
   };
 });
 
-// src/domains/help/commands/artifact-command-help.ts
-var artifactCommandHelp;
-var init_artifact_command_help = __esm(() => {
-  artifactCommandHelp = {
-    name: "artifact",
-    description: "Upload, download, and delete Takumi artifacts (upload|download|delete)",
-    usage: "tkm artifact <upload <file|dir> | download <uuid|url> | delete <uuid|url>>",
+// src/domains/help/commands/artifact-action-help.ts
+var artifactUploadHelp, artifactDownloadHelp, artifactDeleteHelp, listSearchOptionsGroup, orgVisibilityNote, artifactListHelp, artifactSearchHelp;
+var init_artifact_action_help = __esm(() => {
+  artifactUploadHelp = {
+    name: "artifact upload",
+    description: "Upload a file or directory as a new artifact (or a new version with --id)",
+    usage: "tkm artifact upload <file|dir> [options]",
     examples: [
       {
         command: "tkm artifact upload ./report.html --title 'Weekly Report'",
         description: "Upload a file (or directory) as a new artifact and print its share URL"
       },
       {
-        command: "tkm artifact download <uuid|url> -o ./out --ver 3",
-        description: "Download a specific version's files into a directory"
+        command: "tkm artifact upload ./report.html --id <uuid|url> -m 'fix chart colors'",
+        description: "Push a new version of an existing artifact with a change note"
+      }
+    ],
+    optionGroups: [
+      {
+        title: "Options",
+        options: [
+          {
+            flags: "--id <uuid|url>",
+            description: "Existing artifact (UUID or viewer URL) to overwrite with a new version"
+          },
+          {
+            flags: "--title <title>",
+            description: "Display title for the artifact (max 200 chars)"
+          },
+          {
+            flags: "-m, --message <message>",
+            description: "Short note describing this version's change (max 100 chars)"
+          }
+        ]
+      }
+    ]
+  };
+  artifactDownloadHelp = {
+    name: "artifact download",
+    description: "Download an artifact's files (latest version or --ver <n>)",
+    usage: "tkm artifact download <uuid|url> [options]",
+    examples: [
+      {
+        command: "tkm artifact download <uuid|url>",
+        description: "Download the latest version into slug(title) or uuid in CWD"
       },
       {
-        command: "tkm artifact delete <uuid|url> --ver 2",
-        description: "Delete ONLY version 2 (soft delete; other versions stay). A pasted URL with ?v=2 does the same"
+        command: "tkm artifact download <uuid|url> -o ./out --ver 3",
+        description: "Download a specific version's files into a directory"
       }
     ],
     optionGroups: [
       {
-        title: "Actions",
+        title: "Options",
         options: [
           {
-            flags: "upload <file|dir>",
-            description: "Upload a file or directory as a new artifact (or new version with --id)"
+            flags: "-o, --output <dir>",
+            description: "Output directory; default: slug(title) or uuid in CWD"
           },
           {
-            flags: "download <uuid|url>",
-            description: "Download an artifact's files (latest or --ver <n>)"
+            flags: "--ver <n>",
+            description: "Version to download. ?v=<n> in a pasted URL works too; --ver wins when both given"
           },
           {
-            flags: "delete <uuid|url>",
-            description: "Soft-delete the whole artifact, or one version with --ver <n>"
+            flags: "--force",
+            description: "Allow writing into a non-empty directory"
           }
         ]
+      }
+    ]
+  };
+  artifactDeleteHelp = {
+    name: "artifact delete",
+    description: "Soft-delete a whole artifact, or a single version with --ver <n>",
+    usage: "tkm artifact delete <uuid|url> [options]",
+    examples: [
+      {
+        command: "tkm artifact delete <uuid|url>",
+        description: "Soft-delete the whole artifact after a confirmation prompt"
       },
+      {
+        command: "tkm artifact delete <uuid|url> --ver 2",
+        description: "Delete ONLY version 2 (soft delete; other versions stay). A pasted URL with ?v=2 does the same"
+      }
+    ],
+    optionGroups: [
       {
         title: "Options",
         options: [
           {
-            flags: "--id <uuid|url>",
-            description: "(upload) Existing artifact to overwrite with a new version"
+            flags: "--ver <n>",
+            description: "Version to delete. ?v=<n> in a pasted URL works too; --ver wins when both given"
           },
           {
-            flags: "--title <title>",
-            description: "(upload) Display title for the artifact (max 200 chars)"
-          },
+            flags: "-y, --yes",
+            description: "Skip the confirmation prompt"
+          }
+        ]
+      }
+    ]
+  };
+  listSearchOptionsGroup = {
+    title: "Options",
+    options: [
+      {
+        flags: "--access <level>",
+        description: "Filter by access level: private (Only you) | restricted (Only people with access) | organization (Everyone at your org)"
+      },
+      {
+        flags: "--page <n>",
+        description: "Page number, 1-based (default: 1)"
+      },
+      {
+        flags: "--limit <n>",
+        description: "Rows per page, max 100 (default: 10)"
+      },
+      {
+        flags: "--json",
+        description: "Machine-readable JSON output"
+      }
+    ]
+  };
+  orgVisibilityNote = {
+    title: "Notes",
+    content: "Org artifacts appear only after you have opened them at least once (same rule as the web dashboard)."
+  };
+  artifactListHelp = {
+    name: "artifact list",
+    description: "List every artifact you can see — the same rows as the web dashboard",
+    usage: "tkm artifact list [options]",
+    examples: [
+      {
+        command: "tkm artifact list --access organization --limit 25",
+        description: "List up to 25 org-visible artifacts as a table"
+      },
+      {
+        command: "tkm artifact list --json",
+        description: "Print the first page as machine-readable JSON"
+      }
+    ],
+    optionGroups: [listSearchOptionsGroup],
+    sections: [orgVisibilityNote]
+  };
+  artifactSearchHelp = {
+    name: "artifact search",
+    description: "List artifacts filtered by <term> (title or owner name, case-insensitive)",
+    usage: "tkm artifact search <term> [options]",
+    examples: [
+      {
+        command: "tkm artifact search roadmap --json",
+        description: "Search titles/owners for 'roadmap' and print machine-readable JSON"
+      },
+      {
+        command: "tkm artifact search 'kim' --access organization",
+        description: "Search org-visible artifacts by owner name"
+      }
+    ],
+    optionGroups: [listSearchOptionsGroup],
+    sections: [orgVisibilityNote]
+  };
+});
+
+// src/domains/help/commands/artifact-command-help.ts
+var artifactCommandHelp;
+var init_artifact_command_help = __esm(() => {
+  init_artifact_action_help();
+  artifactCommandHelp = {
+    name: "artifact",
+    description: "List, search, upload, download, and delete Takumi artifacts (list|search|upload|download|delete)",
+    usage: "tkm artifact <list | search <term> | upload <file|dir> | download <uuid|url> | delete <uuid|url>>",
+    examples: [
+      {
+        command: "tkm artifact upload ./report.html --title 'Weekly Report'",
+        description: "Upload a file (or directory) as a new artifact and print its share URL"
+      },
+      {
+        command: "tkm artifact list --access organization --limit 25",
+        description: "List up to 25 org-visible artifacts as a table"
+      },
+      {
+        command: "tkm artifact search roadmap --json",
+        description: "Search titles/owners for 'roadmap' and print machine-readable JSON"
+      }
+    ],
+    optionGroups: [
+      {
+        title: "Actions",
+        options: [
           {
-            flags: "-m, --message <message>",
-            description: "(upload) Short note describing this version's change (max 100 chars)"
+            flags: "list",
+            description: "List your artifacts (filterable, paginated table or --json)"
           },
           {
-            flags: "-o, --output <dir>",
-            description: "(download) Output directory; default: slug(title) or uuid in CWD"
+            flags: "search <term>",
+            description: "List filtered to <term> (title or owner name, case-insensitive)"
           },
           {
-            flags: "--ver <n>",
-            description: "(download) Version to download | (delete) version to delete. ?v=<n> in a pasted URL works too; --ver wins when both given"
+            flags: "upload <file|dir>",
+            description: "Upload a file or directory as a new artifact (or new version with --id)"
           },
           {
-            flags: "--force",
-            description: "(download) Allow writing into a non-empty directory"
+            flags: "download <uuid|url>",
+            description: "Download an artifact's files (latest or --ver <n>)"
           },
           {
-            flags: "-y, --yes",
-            description: "(delete) Skip the confirmation prompt"
+            flags: "delete <uuid|url>",
+            description: "Soft-delete the whole artifact, or one version with --ver <n>"
           }
         ]
       }
-    ]
+    ],
+    sections: [
+      {
+        title: "Learn More",
+        content: "Run 'tkm artifact <action> --help' for action-specific options and examples."
+      }
+    ],
+    subcommands: {
+      list: artifactListHelp,
+      search: artifactSearchHelp,
+      upload: artifactUploadHelp,
+      download: artifactDownloadHelp,
+      delete: artifactDeleteHelp
+    }
   };
 });
 
@@ -51634,6 +51786,7 @@ var init_commands2 = __esm(() => {
   init_config_command_help();
   init_auth_command_help();
   init_artifact_command_help();
+  init_artifact_action_help();
   init_mcp_command_help();
   init_common_options();
 });
@@ -51938,6 +52091,7 @@ var init_help_renderer = __esm(() => {
 // src/domains/help/help-interceptor.ts
 var exports_help_interceptor = {};
 __export(exports_help_interceptor, {
+  resolveHelpTarget: () => resolveHelpTarget,
   isHelpRequested: () => isHelpRequested,
   handleHelp: () => handleHelp
 });
@@ -51955,30 +52109,28 @@ function getHelpOptions() {
     noColor
   };
 }
-function getCommandFromArgv() {
-  const argv = process.argv.slice(2);
-  for (const arg of argv) {
-    if (arg.startsWith("-")) {
-      continue;
-    }
-    if (hasCommand(arg)) {
-      return arg;
-    }
+function resolveHelpTarget(argv) {
+  const tokens = argv.filter((arg) => !arg.startsWith("-"));
+  const [command, action] = tokens;
+  if (command === undefined || !hasCommand(command)) {
     return null;
   }
-  return null;
+  const help = HELP_REGISTRY[command];
+  if (action !== undefined && help.subcommands?.[action]) {
+    return help.subcommands[action];
+  }
+  return help;
 }
 async function handleHelp(_args) {
   try {
     const options2 = getHelpOptions();
-    const command = getCommandFromArgv();
+    const help = resolveHelpTarget(process.argv.slice(2));
     let output3;
-    if (command === null) {
+    if (help === null) {
       output3 = renderGlobalHelp(HELP_REGISTRY, options2);
     } else {
-      const help = HELP_REGISTRY[command];
       output3 = renderHelp(help, {
-        command,
+        command: help.name,
         globalHelp: false,
         options: options2
       });
@@ -53897,6 +54049,31 @@ async function presignDownload(token, uuid, version3, paths) {
   }
   return await res.json();
 }
+async function listArtifacts(token, params = {}) {
+  const base = getServerUrl();
+  const qs = new URLSearchParams;
+  if (params.q)
+    qs.set("q", params.q);
+  if (params.vis)
+    qs.set("vis", params.vis);
+  if (params.page !== undefined)
+    qs.set("page", String(params.page));
+  if (params.limit !== undefined)
+    qs.set("limit", String(params.limit));
+  const suffix = qs.toString() ? `?${qs}` : "";
+  const res = await fetch(`${base}/api/v1/artifacts${suffix}`, {
+    headers: { Authorization: `Bearer ${token}` }
+  });
+  if (!res.ok) {
+    const msg = await parseErrorMessage(res);
+    throw new ArtifactApiError(res.status, `List failed (HTTP ${res.status}): ${msg}`);
+  }
+  const payload = await res.json();
+  if (!Array.isArray(payload?.artifacts) || payload?.pagination == null) {
+    throw new ArtifactApiError(res.status, `List failed (HTTP ${res.status}): unexpected response shape from ${base}/api/v1/artifacts`);
+  }
+  return payload;
+}
 
 // src/domains/artifact/manifest-store.ts
 init_logger();
@@ -54356,6 +54533,162 @@ async function artifactDownload(ref, opts) {
   console.log(`  Total: ${humanizeBytes(total)}`);
 }
 
+// src/commands/artifact/list-command.ts
+var import_picocolors17 = __toESM(require_picocolors(), 1);
+init_logger();
+
+// src/shared/relative-time.ts
+function formatRelativeTime(iso, now = Date.now()) {
+  const then = Date.parse(iso);
+  if (Number.isNaN(then))
+    return "—";
+  const diffMs = Math.max(0, now - then);
+  const diffSec = Math.floor(diffMs / 1000);
+  if (diffSec < 60)
+    return "just now";
+  const diffMin = Math.floor(diffSec / 60);
+  if (diffMin < 60)
+    return `${diffMin}m ago`;
+  const diffHour = Math.floor(diffMin / 60);
+  if (diffHour < 24)
+    return `${diffHour}h ago`;
+  const diffDay = Math.floor(diffHour / 24);
+  if (diffDay < 30)
+    return `${diffDay}d ago`;
+  const diffMonth = Math.floor(diffDay / 30);
+  if (diffMonth < 12)
+    return `${diffMonth}mo ago`;
+  const diffYear = Math.floor(diffMonth / 12);
+  return `${diffYear}y ago`;
+}
+
+// src/shared/render-table.ts
+var import_picocolors16 = __toESM(require_picocolors(), 1);
+function renderTable(header, rows) {
+  const lastCol = header.length - 1;
+  const widths = header.map((h2, col) => Math.max(h2.length, ...rows.map((r2) => r2[col]?.value.length ?? 0)));
+  const padPlain = (text, col) => col === lastCol ? text : text.padEnd(widths[col]);
+  const headerLine = import_picocolors16.default.bold(header.map((h2, col) => padPlain(h2, col)).join("  ").trimEnd());
+  const rowLine = (cells) => cells.map((cell, col) => {
+    const padded = padPlain(cell.value, col);
+    return cell.paint ? cell.paint(padded) : padded;
+  }).join("  ").trimEnd();
+  return [headerLine, ...rows.map(rowLine)].join(`
+`);
+}
+
+// src/commands/artifact/list-command.ts
+var ACCESS_TO_VIS = {
+  private: "private",
+  restricted: "shared",
+  organization: "org"
+};
+var ACCESS_VALUES = Object.keys(ACCESS_TO_VIS);
+var TITLE_MAX = 32;
+var OWNER_MAX = 18;
+function truncate(text, max) {
+  const chars = Array.from(text);
+  return chars.length <= max ? text : `${chars.slice(0, max - 1).join("")}…`;
+}
+function paintVis(vis) {
+  if (vis === "shared")
+    return import_picocolors17.default.cyan;
+  if (vis === "org")
+    return import_picocolors17.default.green;
+  return import_picocolors17.default.dim;
+}
+function accessLabel(vis, viewerOrgName) {
+  if (vis === "private")
+    return "Only you";
+  if (vis === "shared")
+    return "Only people with access";
+  if (vis === "org")
+    return `Everyone at ${viewerOrgName ?? "org"}`;
+  return vis;
+}
+function ownerCell(item) {
+  return item.isOwner ? { value: "you", paint: import_picocolors17.default.dim } : { value: truncate(item.ownerName, OWNER_MAX) };
+}
+function threadsCell(item) {
+  return item.openThreads !== null && item.openThreads > 0 ? { value: String(item.openThreads), paint: import_picocolors17.default.yellow } : { value: "—", paint: import_picocolors17.default.dim };
+}
+function buildRow(item, viewerOrgName, now) {
+  return [
+    { value: truncate(item.title, TITLE_MAX) },
+    ownerCell(item),
+    { value: accessLabel(item.visibility, viewerOrgName), paint: paintVis(item.visibility) },
+    { value: String(item.live_version) },
+    threadsCell(item),
+    { value: formatRelativeTime(item.updated_at, now) },
+    { value: item.uuid }
+  ];
+}
+function describeFilters(q3, access) {
+  const parts = [];
+  if (q3)
+    parts.push(`matching "${q3}"`);
+  if (access)
+    parts.push(`--access ${access}`);
+  return parts.join(" ");
+}
+function footerLine(payload) {
+  const { page, totalPages, totalFiltered, pageSize } = payload.pagination;
+  const start = (page - 1) * pageSize + 1;
+  const end = start + payload.artifacts.length - 1;
+  const base = `Showing ${start}-${end} of ${totalFiltered} (page ${page}/${totalPages})`;
+  return page < totalPages ? `${base} · use --page ${page + 1} for the next page` : base;
+}
+async function artifactList(term, opts) {
+  if (opts.access !== undefined && !ACCESS_VALUES.includes(opts.access)) {
+    console.error(`Invalid --access: ${opts.access}. Use one of: ${ACCESS_VALUES.join(", ")}`);
+    process.exitCode = 1;
+    return;
+  }
+  const token = await getToken(opts);
+  if (!token)
+    return;
+  const params = {
+    q: term,
+    vis: opts.access !== undefined ? ACCESS_TO_VIS[opts.access] : undefined,
+    page: opts.page,
+    limit: opts.limit
+  };
+  let payload;
+  try {
+    payload = await listArtifacts(token, params);
+  } catch (err) {
+    if (err instanceof ArtifactApiError && err.status === 404) {
+      console.error("Error: this Takumi server does not support artifact listing (needs a newer server version).");
+      process.exitCode = 1;
+      return;
+    }
+    printApiError(err);
+    process.exitCode = 1;
+    return;
+  }
+  if (opts.json) {
+    process.stdout.write(`${JSON.stringify(payload)}
+`);
+    return;
+  }
+  if (payload.artifacts.length === 0) {
+    const { page, totalPages, totalFiltered } = payload.pagination;
+    if (totalFiltered > 0 && page > totalPages) {
+      logger.info(`Page ${page} is past the last page — ${totalFiltered} artifact(s) match across ${totalPages} page(s). Try --page 1.`);
+      return;
+    }
+    const filters = describeFilters(params.q, opts.access);
+    logger.info(filters ? `No artifacts found for ${filters}.` : "No artifacts found.");
+    return;
+  }
+  const header = ["TITLE", "OWNER", "ACCESS", "VER", "THREADS", "UPDATED", "UUID"];
+  const now = Date.now();
+  const rows = payload.artifacts.map((item) => buildRow(item, payload.viewerOrgName, now));
+  process.stdout.write(`${renderTable(header, rows)}
+`);
+  logger.info(footerLine(payload));
+}
+
 // src/commands/artifact/upload-command.ts
 init_dist2();
 import { promises as fs13 } from "node:fs";
@@ -54690,6 +55023,17 @@ function usageError(hint) {
 }
 async function artifactCommand(action, target, opts) {
   switch (action) {
+    case "list":
+      if (target) {
+        return usageError(`tkm artifact search ${target}   (list takes no search term)`);
+      }
+      await artifactList(undefined, opts);
+      break;
+    case "search":
+      if (!target)
+        return usageError("tkm artifact search <term>");
+      await artifactList(target, opts);
+      break;
     case "upload":
       if (!target)
         return usageError("tkm artifact upload <file>");
@@ -54706,10 +55050,10 @@ async function artifactCommand(action, target, opts) {
       await artifactDelete(target, opts);
       break;
     case undefined:
-      usageError("tkm artifact <upload <file> | download <uuid|url> | delete <uuid|url> [--ver <n>]>");
+      usageError("tkm artifact <list | search <term> | upload <file> | download <uuid|url> | delete <uuid|url> [--ver <n>]>");
       break;
     default:
-      console.error(`Unknown artifact action: ${action}. Available: upload, download, delete`);
+      console.error(`Unknown artifact action: ${action}. Available: list, search, upload, download, delete`);
       process.exitCode = 1;
   }
 }
@@ -70545,7 +70889,7 @@ class ReportGenerator {
 }
 // src/domains/health-checks/doctor-ui-renderer.ts
 init_terminal_utils();
-var import_picocolors16 = __toESM(require_picocolors(), 1);
+var import_picocolors18 = __toESM(require_picocolors(), 1);
 
 class DoctorUIRenderer {
   symbols = getStatusSymbols();
@@ -70557,8 +70901,8 @@ class DoctorUIRenderer {
     const groups = this.groupChecks(summary.checks);
     for (const [groupName, checks] of groups) {
       console.log("│");
-      console.log(`│  ${import_picocolors16.default.bold(import_picocolors16.default.cyan(groupName.toUpperCase()))}`);
-      console.log(`│  ${import_picocolors16.default.dim("─".repeat(50))}`);
+      console.log(`│  ${import_picocolors18.default.bold(import_picocolors18.default.cyan(groupName.toUpperCase()))}`);
+      console.log(`│  ${import_picocolors18.default.dim("─".repeat(50))}`);
       const maxNameLen = Math.max(...checks.map((c2) => c2.name.length));
       const maxMsgLen = Math.max(...checks.map((c2) => c2.message.length));
       for (const check of checks) {
@@ -70570,55 +70914,55 @@ class DoctorUIRenderer {
   }
   renderCheck(check, maxNameLen, maxMsgLen) {
     const symbol = this.getColoredSymbol(check.status);
-    const name2 = import_picocolors16.default.bold(check.name.padEnd(maxNameLen));
+    const name2 = import_picocolors18.default.bold(check.name.padEnd(maxNameLen));
     const paddedMsg = check.message.padEnd(maxMsgLen);
     const value = this.colorizeValue(check.status, paddedMsg);
     if (this.verbose && check.command) {
-      console.log(`│  ${import_picocolors16.default.dim(`Running: ${check.command}`)}`);
+      console.log(`│  ${import_picocolors18.default.dim(`Running: ${check.command}`)}`);
     }
     let line = `│  ${symbol} ${name2}  ${value}`;
     if (this.verbose && check.duration !== undefined) {
-      line += `  ${import_picocolors16.default.dim(`(${check.duration}ms)`)}`;
+      line += `  ${import_picocolors18.default.dim(`(${check.duration}ms)`)}`;
     }
     if (check.details) {
       const displayPath = this.verbose ? check.details : this.shortenPath(check.details);
-      line += `  ${import_picocolors16.default.dim(displayPath)}`;
+      line += `  ${import_picocolors18.default.dim(displayPath)}`;
     }
     console.log(line);
     if (this.verbose && check.status === "pass" && check.suggestion) {
       const indent = " ".repeat(maxNameLen + 5);
-      console.log(`│  ${indent}${import_picocolors16.default.dim(`→ ${check.suggestion}`)}`);
+      console.log(`│  ${indent}${import_picocolors18.default.dim(`→ ${check.suggestion}`)}`);
     }
     if (check.status !== "pass" && check.suggestion) {
       const indent = " ".repeat(maxNameLen + 5);
-      console.log(`│  ${indent}${import_picocolors16.default.dim(`→ ${check.suggestion}`)}`);
+      console.log(`│  ${indent}${import_picocolors18.default.dim(`→ ${check.suggestion}`)}`);
     }
   }
   getColoredSymbol(status2) {
     switch (status2) {
       case "pass":
-        return import_picocolors16.default.green(this.symbols.pass);
+        return import_picocolors18.default.green(this.symbols.pass);
       case "warn":
-        return import_picocolors16.default.yellow(this.symbols.warn);
+        return import_picocolors18.default.yellow(this.symbols.warn);
       case "fail":
-        return import_picocolors16.default.red(this.symbols.fail);
+        return import_picocolors18.default.red(this.symbols.fail);
       default:
-        return import_picocolors16.default.blue(this.symbols.info);
+        return import_picocolors18.default.blue(this.symbols.info);
     }
   }
   renderHealingSummary(healSummary) {
     console.log("│");
-    console.log(`│  ${import_picocolors16.default.bold(import_picocolors16.default.cyan("AUTO-HEAL RESULTS"))}`);
-    console.log(`│  ${import_picocolors16.default.dim("─".repeat(50))}`);
+    console.log(`│  ${import_picocolors18.default.bold(import_picocolors18.default.cyan("AUTO-HEAL RESULTS"))}`);
+    console.log(`│  ${import_picocolors18.default.dim("─".repeat(50))}`);
     for (const fix of healSummary.fixes) {
-      const symbol = fix.success ? import_picocolors16.default.green(this.symbols.pass) : import_picocolors16.default.red(this.symbols.fail);
-      console.log(`│  ${symbol} ${import_picocolors16.default.bold(fix.checkName)}  ${import_picocolors16.default.dim(fix.message)}`);
+      const symbol = fix.success ? import_picocolors18.default.green(this.symbols.pass) : import_picocolors18.default.red(this.symbols.fail);
+      console.log(`│  ${symbol} ${import_picocolors18.default.bold(fix.checkName)}  ${import_picocolors18.default.dim(fix.message)}`);
       if (!fix.success && fix.error) {
-        console.log(`│     ${import_picocolors16.default.red(`Error: ${fix.error}`)}`);
+        console.log(`│     ${import_picocolors18.default.red(`Error: ${fix.error}`)}`);
       }
     }
     console.log("│");
-    console.log(`│  Fixed: ${import_picocolors16.default.green(String(healSummary.succeeded))}, Failed: ${import_picocolors16.default.red(String(healSummary.failed))}`);
+    console.log(`│  Fixed: ${import_picocolors18.default.green(String(healSummary.succeeded))}, Failed: ${import_picocolors18.default.red(String(healSummary.failed))}`);
   }
   groupChecks(checks) {
     const groups = new Map;
@@ -70632,11 +70976,11 @@ class DoctorUIRenderer {
   colorizeValue(status2, message) {
     switch (status2) {
       case "pass":
-        return import_picocolors16.default.green(message);
+        return import_picocolors18.default.green(message);
       case "warn":
-        return import_picocolors16.default.yellow(message);
+        return import_picocolors18.default.yellow(message);
       case "fail":
-        return import_picocolors16.default.red(message);
+        return import_picocolors18.default.red(message);
       default:
         return message;
     }
@@ -70655,23 +70999,23 @@ class DoctorUIRenderer {
   renderSummaryLine(summary) {
     const parts = [];
     if (summary.passed > 0) {
-      parts.push(import_picocolors16.default.green(`${summary.passed} ${this.symbols.pass}`));
+      parts.push(import_picocolors18.default.green(`${summary.passed} ${this.symbols.pass}`));
     }
     if (summary.warnings > 0) {
-      parts.push(import_picocolors16.default.yellow(`${summary.warnings} ${this.symbols.warn}`));
+      parts.push(import_picocolors18.default.yellow(`${summary.warnings} ${this.symbols.warn}`));
     }
     if (summary.failed > 0) {
-      parts.push(import_picocolors16.default.red(`${summary.failed} ${this.symbols.fail}`));
+      parts.push(import_picocolors18.default.red(`${summary.failed} ${this.symbols.fail}`));
     }
-    console.log(`│  ${import_picocolors16.default.dim("─".repeat(50))}`);
+    console.log(`│  ${import_picocolors18.default.dim("─".repeat(50))}`);
     console.log(`│  Summary: ${parts.join("  ")}`);
     console.log("│");
-    console.log(`│  ${import_picocolors16.default.dim("Quick Commands:")}`);
-    console.log(`│  ${import_picocolors16.default.dim("  tkm init         Install/update Takumi in project")}`);
-    console.log(`│  ${import_picocolors16.default.dim("  tkm init -g      Install/update Takumi globally")}`);
-    console.log(`│  ${import_picocolors16.default.dim("  tkm update       Update the CLI tool")}`);
-    console.log(`│  ${import_picocolors16.default.dim("  tkm uninstall    Remove Takumi from project/global")}`);
-    console.log(`│  ${import_picocolors16.default.dim("  tkm --help     Show all commands")}`);
+    console.log(`│  ${import_picocolors18.default.dim("Quick Commands:")}`);
+    console.log(`│  ${import_picocolors18.default.dim("  tkm init         Install/update Takumi in project")}`);
+    console.log(`│  ${import_picocolors18.default.dim("  tkm init -g      Install/update Takumi globally")}`);
+    console.log(`│  ${import_picocolors18.default.dim("  tkm update       Update the CLI tool")}`);
+    console.log(`│  ${import_picocolors18.default.dim("  tkm uninstall    Remove Takumi from project/global")}`);
+    console.log(`│  ${import_picocolors18.default.dim("  tkm --help     Show all commands")}`);
   }
 }
 // src/commands/doctor.ts
@@ -78792,7 +79136,7 @@ function releaseEntryToGitHubRelease(entry, kit) {
 init_logger();
 init_dist2();
 init_release_filter();
-var import_picocolors19 = __toESM(require_picocolors(), 1);
+var import_picocolors21 = __toESM(require_picocolors(), 1);
 
 // src/domains/versioning/selection/version-filter.ts
 var VERSION_PATTERN = /^v?\d+\.\d+\.\d+(-[a-zA-Z0-9.]+)?$/;
@@ -78810,36 +79154,36 @@ function normalizeVersionTag(version3) {
 init_environment();
 init_logger();
 init_dist2();
-var import_picocolors18 = __toESM(require_picocolors(), 1);
+var import_picocolors20 = __toESM(require_picocolors(), 1);
 
 // src/domains/versioning/version-display.ts
-var import_picocolors17 = __toESM(require_picocolors(), 1);
+var import_picocolors19 = __toESM(require_picocolors(), 1);
 
 class VersionDisplayFormatter {
   static createBadges(release) {
     const badges = [];
     if (release.isLatestStable) {
-      badges.push(import_picocolors17.default.bold(import_picocolors17.default.yellow("[latest]")));
+      badges.push(import_picocolors19.default.bold(import_picocolors19.default.yellow("[latest]")));
     }
     if (release.prerelease || release.isLatestBeta) {
       if (release.isLatestBeta) {
-        badges.push(import_picocolors17.default.bold(import_picocolors17.default.magenta("[beta]")));
+        badges.push(import_picocolors19.default.bold(import_picocolors19.default.magenta("[beta]")));
       } else {
-        badges.push(import_picocolors17.default.magenta("[prerelease]"));
+        badges.push(import_picocolors19.default.magenta("[prerelease]"));
       }
     } else if (!release.draft) {
-      badges.push(import_picocolors17.default.blue("[stable]"));
+      badges.push(import_picocolors19.default.blue("[stable]"));
     }
     if (release.draft) {
-      badges.push(import_picocolors17.default.gray("[draft]"));
+      badges.push(import_picocolors19.default.gray("[draft]"));
     }
     return badges.length > 0 ? ` ${badges.join(" ")}` : "";
   }
   static formatChoiceLabel(release) {
-    const version3 = import_picocolors17.default.green(release.displayVersion);
+    const version3 = import_picocolors19.default.green(release.displayVersion);
     const badges = VersionDisplayFormatter.createBadges(release);
     const name2 = release.name || "Release";
-    return `${version3}${badges} ${import_picocolors17.default.dim(name2)}`;
+    return `${version3}${badges} ${import_picocolors19.default.dim(name2)}`;
   }
   static formatChoiceHint(release) {
     const parts = [];
@@ -78861,7 +79205,7 @@ class VersionDisplayFormatter {
     if (latestStable) {
       options2.push({
         value: latestStable.tag_name,
-        label: `${import_picocolors17.default.bold(import_picocolors17.default.green("Latest Stable"))} (${latestStable.displayVersion})`,
+        label: `${import_picocolors19.default.bold(import_picocolors19.default.green("Latest Stable"))} (${latestStable.displayVersion})`,
         hint: "recommended version",
         isLatest: true,
         isPrerelease: false
@@ -78871,7 +79215,7 @@ class VersionDisplayFormatter {
     if (latestBeta) {
       options2.push({
         value: latestBeta.tag_name,
-        label: `${import_picocolors17.default.bold(import_picocolors17.default.magenta("Latest Beta"))} (${latestBeta.displayVersion})`,
+        label: `${import_picocolors19.default.bold(import_picocolors19.default.magenta("Latest Beta"))} (${latestBeta.displayVersion})`,
         hint: "latest features, may be unstable",
         isLatest: false,
         isPrerelease: true
@@ -78882,7 +79226,7 @@ class VersionDisplayFormatter {
   static createSeparator() {
     return {
       value: "separator",
-      label: import_picocolors17.default.dim("─".repeat(50)),
+      label: import_picocolors19.default.dim("─".repeat(50)),
       hint: undefined,
       isLatest: false,
       isPrerelease: false
@@ -78891,7 +79235,7 @@ class VersionDisplayFormatter {
   static createCancelOption() {
     return {
       value: "cancel",
-      label: import_picocolors17.default.red("Cancel"),
+      label: import_picocolors19.default.red("Cancel"),
       hint: "exit version selection",
       isLatest: false,
       isPrerelease: false
@@ -78943,15 +79287,15 @@ class VersionDisplayFormatter {
     return value !== "separator" && value !== "cancel" && value.trim().length > 0;
   }
   static formatError(message, suggestion) {
-    let output2 = import_picocolors17.default.red(`Error: ${message}`);
+    let output2 = import_picocolors19.default.red(`Error: ${message}`);
     if (suggestion) {
       output2 += `
-${import_picocolors17.default.dim(suggestion)}`;
+${import_picocolors19.default.dim(suggestion)}`;
     }
     return output2;
   }
   static formatSuccess(version3, kitName) {
-    return `${import_picocolors17.default.green("✓")} Selected ${import_picocolors17.default.bold(version3)} for ${import_picocolors17.default.bold(kitName)}`;
+    return `${import_picocolors19.default.green("✓")} Selected ${import_picocolors19.default.bold(version3)} for ${import_picocolors19.default.bold(kitName)}`;
   }
 }
 
@@ -78961,7 +79305,7 @@ async function handleNoReleases(kit, allowManualEntry) {
 This could be due to:
 • No releases published yet
 • Network connectivity issues
-• Repository access permissions`, import_picocolors18.default.yellow("No Releases Available"));
+• Repository access permissions`, import_picocolors20.default.yellow("No Releases Available"));
   if (!allowManualEntry) {
     throw new Error(`No releases available for ${kit.name}`);
   }
@@ -79021,34 +79365,34 @@ async function createVersionPrompt(kit, choices, _defaultIndex, allowManualEntry
   if (latestStable) {
     clackChoices.push({
       value: latestStable.tag_name,
-      label: `${import_picocolors18.default.bold(import_picocolors18.default.green("Latest Stable"))} (${latestStable.displayVersion})`,
+      label: `${import_picocolors20.default.bold(import_picocolors20.default.green("Latest Stable"))} (${latestStable.displayVersion})`,
       hint: "recommended"
     });
   }
   if (allowManualEntry) {
     clackChoices.push({
       value: "manual-entry",
-      label: import_picocolors18.default.cyan("↳ Enter Version Manually"),
+      label: import_picocolors20.default.cyan("↳ Enter Version Manually"),
       hint: "for older versions"
     });
   }
   clackChoices.push({
     value: "cancel",
-    label: import_picocolors18.default.red("✕ Cancel")
+    label: import_picocolors20.default.red("✕ Cancel")
   });
   const versionChoices = choices.filter((choice) => choice.value !== "separator" && choice.value !== "cancel");
   for (const choice of versionChoices) {
     const isCurrentlyInstalled = currentVersion && (choice.value === currentVersion || choice.value === `v${currentVersion}`);
-    const installedMarker = isCurrentlyInstalled ? import_picocolors18.default.cyan(" (installed)") : "";
+    const installedMarker = isCurrentlyInstalled ? import_picocolors20.default.cyan(" (installed)") : "";
     clackChoices.push({
       value: choice.value,
       label: `${choice.label}${installedMarker}`,
       hint: choice.hint
     });
   }
-  const currentVersionHint = currentVersion ? import_picocolors18.default.dim(` (current: ${currentVersion})`) : "";
+  const currentVersionHint = currentVersion ? import_picocolors20.default.dim(` (current: ${currentVersion})`) : "";
   const selected = await ie({
-    message: `Select version for ${import_picocolors18.default.bold(kit.name)}${currentVersionHint}:`,
+    message: `Select version for ${import_picocolors20.default.bold(kit.name)}${currentVersionHint}:`,
     options: clackChoices,
     initialValue: latestStable?.tag_name
   });
@@ -79073,15 +79417,15 @@ async function createVersionPrompt(kit, choices, _defaultIndex, allowManualEntry
 async function handleSelectionError(error, kit, allowManualEntry, retryCallback) {
   logger.error(`Version selection error: ${error.message}`);
   if (error.message.includes("401") || error.message.includes("403")) {
-    le(VersionDisplayFormatter.formatError("Authentication failed", "Please check your GitHub token with: tkm auth"), import_picocolors18.default.red("Authentication Error"));
+    le(VersionDisplayFormatter.formatError("Authentication failed", "Please check your GitHub token with: tkm auth"), import_picocolors20.default.red("Authentication Error"));
   } else if (error.message.includes("404")) {
-    le(VersionDisplayFormatter.formatError("Repository access denied", "Make sure you have access to the repository"), import_picocolors18.default.red("Access Error"));
+    le(VersionDisplayFormatter.formatError("Repository access denied", "Make sure you have access to the repository"), import_picocolors20.default.red("Access Error"));
   } else if (error.message.includes("rate limit") || error.message.includes("403")) {
-    le(VersionDisplayFormatter.formatError("GitHub API rate limit exceeded", "Please wait a moment and try again"), import_picocolors18.default.yellow("Rate Limited"));
+    le(VersionDisplayFormatter.formatError("GitHub API rate limit exceeded", "Please wait a moment and try again"), import_picocolors20.default.yellow("Rate Limited"));
   } else if (error.message.includes("network") || error.message.includes("ENOTFOUND")) {
-    le(VersionDisplayFormatter.formatError("Network connection failed", "Please check your internet connection"), import_picocolors18.default.yellow("Network Error"));
+    le(VersionDisplayFormatter.formatError("Network connection failed", "Please check your internet connection"), import_picocolors20.default.yellow("Network Error"));
   } else {
-    le(VersionDisplayFormatter.formatError(error.message || "Unknown error occurred", "Please try again or contact support"), import_picocolors18.default.red("Error"));
+    le(VersionDisplayFormatter.formatError(error.message || "Unknown error occurred", "Please try again or contact support"), import_picocolors20.default.red("Error"));
   }
   if (isNonInteractive()) {
     logger.warning("Non-interactive mode: version selection failed, cannot retry");
@@ -79143,7 +79487,7 @@ class VersionSelector {
     } = options2;
     try {
       const loadingSpinner = de();
-      loadingSpinner.start(`Fetching versions for ${import_picocolors19.default.bold(kit.name)}...`);
+      loadingSpinner.start(`Fetching versions for ${import_picocolors21.default.bold(kit.name)}...`);
       let releases;
       if (useGh) {
         releases = await this.githubClient.listReleasesWithCache(kit, {
@@ -79780,12 +80124,12 @@ import * as path10 from "node:path";
 // src/domains/github/auth-prompt.ts
 init_dist2();
 init_github_auth();
-var import_picocolors20 = __toESM(require_picocolors(), 1);
+var import_picocolors22 = __toESM(require_picocolors(), 1);
 async function promptForAuth() {
   const hasGit = GitCloneManager.isGitInstalled();
   const hasSshKeys = hasGit && GitCloneManager.hasSshKeys();
   const hasGhCli = AuthManager.isGhCliInstalled();
-  oe(import_picocolors20.default.yellow("No GitHub authentication found"));
+  oe(import_picocolors22.default.yellow("No GitHub authentication found"));
   const options2 = [];
   if (hasGit) {
     const hint = hasSshKeys ? "SSH keys detected" : "Will use HTTPS";
@@ -79838,7 +80182,7 @@ async function promptForAuth() {
       return { method: "cancel" };
     }
     if (typeof token === "string" && token.startsWith("github_pat_")) {
-      le(import_picocolors20.default.yellow(`⚠️  Fine-grained PATs cannot access repos where you're a collaborator.
+      le(import_picocolors22.default.yellow(`⚠️  Fine-grained PATs cannot access repos where you're a collaborator.
 ` + "   If you encounter access issues, use a Classic PAT instead."));
     }
     return { method: "token", token };
@@ -79881,7 +80225,7 @@ import { join as join117 } from "node:path";
 // src/shared/progress-bar.ts
 init_output_manager();
 init_terminal_utils();
-var import_picocolors21 = __toESM(require_picocolors(), 1);
+var import_picocolors23 = __toESM(require_picocolors(), 1);
 var BAR_CHARS = {
   unicode: { filled: "█", empty: "░" },
   ascii: { filled: "=", empty: "-" }
@@ -79939,7 +80283,7 @@ class ProgressBar {
     this.clearLine();
     if (message) {
       const symbols = output.getSymbols();
-      console.log(`${import_picocolors21.default.green(symbols.success)} ${message}`);
+      console.log(`${import_picocolors23.default.green(symbols.success)} ${message}`);
     }
   }
   clearLine() {
@@ -85571,7 +85915,7 @@ function filterDeletionPaths(trackedFiles, deletions) {
 }
 // src/domains/sync/merge-ui.ts
 init_dist2();
-var import_picocolors22 = __toESM(require_picocolors(), 1);
+var import_picocolors24 = __toESM(require_picocolors(), 1);
 var HUNK_SEPARATOR_WIDTH = 50;
 var EXTENDED_CONTEXT_LINES = 10;
 var MAX_LINE_DISPLAY_LENGTH = 120;
@@ -85590,21 +85934,21 @@ class MergeUI {
   static async promptHunk(hunk, hunkIndex, totalHunks, _filename) {
     requireTTY();
     const lineRange = `${hunk.oldStart}-${hunk.oldStart + hunk.oldLines - 1}`;
-    console.log(import_picocolors22.default.cyan(`
+    console.log(import_picocolors24.default.cyan(`
 Hunk ${hunkIndex + 1}/${totalHunks}: Lines ${lineRange}`));
-    console.log(import_picocolors22.default.dim("─".repeat(HUNK_SEPARATOR_WIDTH)));
+    console.log(import_picocolors24.default.dim("─".repeat(HUNK_SEPARATOR_WIDTH)));
     for (const line of hunk.lines) {
       const displayLine = truncateLine(line);
       const prefix = line[0];
       if (prefix === "+") {
-        console.log(import_picocolors22.default.green(displayLine));
+        console.log(import_picocolors24.default.green(displayLine));
       } else if (prefix === "-") {
-        console.log(import_picocolors22.default.red(displayLine));
+        console.log(import_picocolors24.default.red(displayLine));
       } else {
-        console.log(import_picocolors22.default.dim(displayLine));
+        console.log(import_picocolors24.default.dim(displayLine));
       }
     }
-    console.log(import_picocolors22.default.dim("─".repeat(HUNK_SEPARATOR_WIDTH)));
+    console.log(import_picocolors24.default.dim("─".repeat(HUNK_SEPARATOR_WIDTH)));
     const action = await ie({
       message: "Action?",
       options: [
@@ -85624,21 +85968,21 @@ Hunk ${hunkIndex + 1}/${totalHunks}: Lines ${lineRange}`));
 `);
     const startLine = Math.max(0, hunk.oldStart - 1 - contextLines);
     const endLine = Math.min(lines.length, hunk.oldStart + hunk.oldLines - 1 + contextLines);
-    console.log(import_picocolors22.default.cyan(`
+    console.log(import_picocolors24.default.cyan(`
 Extended context (lines ${startLine + 1}-${endLine}):`));
-    console.log(import_picocolors22.default.dim("─".repeat(HUNK_SEPARATOR_WIDTH)));
+    console.log(import_picocolors24.default.dim("─".repeat(HUNK_SEPARATOR_WIDTH)));
     for (let i = startLine;i < endLine; i++) {
       const lineNum = String(i + 1).padStart(4, " ");
       const isInHunk = i >= hunk.oldStart - 1 && i < hunk.oldStart - 1 + hunk.oldLines;
-      const prefix = isInHunk ? import_picocolors22.default.yellow("*") : " ";
-      console.log(`${import_picocolors22.default.dim(lineNum)} ${prefix} ${lines[i]}`);
+      const prefix = isInHunk ? import_picocolors24.default.yellow("*") : " ";
+      console.log(`${import_picocolors24.default.dim(lineNum)} ${prefix} ${lines[i]}`);
     }
-    console.log(import_picocolors22.default.dim("─".repeat(HUNK_SEPARATOR_WIDTH)));
+    console.log(import_picocolors24.default.dim("─".repeat(HUNK_SEPARATOR_WIDTH)));
   }
   static async mergeFile(filename, currentContent, _newContent, hunks) {
-    console.log(import_picocolors22.default.bold(`
+    console.log(import_picocolors24.default.bold(`
 ━━━ ${filename} ━━━`));
-    console.log(import_picocolors22.default.dim(`${hunks.length} change${hunks.length === 1 ? "" : "s"} to review
+    console.log(import_picocolors24.default.dim(`${hunks.length} change${hunks.length === 1 ? "" : "s"} to review
 `));
     const decisions = [];
     for (let i = 0;i < hunks.length; i++) {
@@ -85661,19 +86005,19 @@ Extended context (lines ${startLine + 1}-${endLine}):`));
   }
   static displayMergeSummary(filename, applied, rejected) {
     if (applied > 0 && rejected > 0) {
-      console.log(import_picocolors22.default.dim(`  ${filename}: `) + import_picocolors22.default.green(`${applied} applied`) + import_picocolors22.default.dim(", ") + import_picocolors22.default.yellow(`${rejected} rejected`));
+      console.log(import_picocolors24.default.dim(`  ${filename}: `) + import_picocolors24.default.green(`${applied} applied`) + import_picocolors24.default.dim(", ") + import_picocolors24.default.yellow(`${rejected} rejected`));
     } else if (applied > 0) {
-      console.log(import_picocolors22.default.dim(`  ${filename}: `) + import_picocolors22.default.green(`${applied} applied`));
+      console.log(import_picocolors24.default.dim(`  ${filename}: `) + import_picocolors24.default.green(`${applied} applied`));
     } else {
-      console.log(import_picocolors22.default.dim(`  ${filename}: `) + import_picocolors22.default.yellow(`${rejected} rejected`));
+      console.log(import_picocolors24.default.dim(`  ${filename}: `) + import_picocolors24.default.yellow(`${rejected} rejected`));
     }
   }
   static displaySkipped(filename) {
-    console.log(import_picocolors22.default.dim(`  ${filename}: `) + import_picocolors22.default.yellow("skipped"));
+    console.log(import_picocolors24.default.dim(`  ${filename}: `) + import_picocolors24.default.yellow("skipped"));
   }
 }
 // src/domains/sync/notification-display.ts
-var import_picocolors23 = __toESM(require_picocolors(), 1);
+var import_picocolors25 = __toESM(require_picocolors(), 1);
 import { stdout } from "node:process";
 function createNotificationBox2(borderColor, boxWidth) {
   const contentWidth = boxWidth - 2;
@@ -85697,19 +86041,19 @@ function displayConfigUpdateNotification(entries, isGlobal = false) {
   const lines = entries.map(({ kit, currentVersion, latestVersion }) => {
     const cur = currentVersion.replace(/^v/, "");
     const latest = latestVersion.replace(/^v/, "");
-    const text = `${import_picocolors23.default.bold(kit)}: ${import_picocolors23.default.dim(cur)} ${import_picocolors23.default.white("→")} ${import_picocolors23.default.green(import_picocolors23.default.bold(latest))}`;
+    const text = `${import_picocolors25.default.bold(kit)}: ${import_picocolors25.default.dim(cur)} ${import_picocolors25.default.white("→")} ${import_picocolors25.default.green(import_picocolors25.default.bold(latest))}`;
     const visibleLen = kit.length + 2 + cur.length + 3 + latest.length;
     return { text, visibleLen };
   });
   const updateCmd = isGlobal ? "tkm init -g --sync" : "tkm init --sync";
-  const commandText = `Run: ${import_picocolors23.default.cyan(import_picocolors23.default.bold(updateCmd))}`;
+  const commandText = `Run: ${import_picocolors25.default.cyan(import_picocolors25.default.bold(updateCmd))}`;
   const commandLen = `Run: ${updateCmd}`.length;
   const headerLabel = "\uD83D\uDCE6 Config Updates Available";
-  const headerText = import_picocolors23.default.bold(import_picocolors23.default.yellow(headerLabel));
+  const headerText = import_picocolors25.default.bold(import_picocolors25.default.yellow(headerLabel));
   const longestLine = Math.max(headerLabel.length, commandLen, ...lines.map((l2) => l2.visibleLen));
   const terminalWidth = stdout.columns || 80;
   const boxWidth = Math.min(Math.max(longestLine + 6, 52), terminalWidth - 4);
-  const { topBorder, bottomBorder, emptyLine, padLine } = createNotificationBox2(import_picocolors23.default.cyan, boxWidth);
+  const { topBorder, bottomBorder, emptyLine, padLine } = createNotificationBox2(import_picocolors25.default.cyan, boxWidth);
   console.log("");
   console.log(topBorder);
   console.log(emptyLine);
@@ -85732,7 +86076,7 @@ init_manifest_reader();
 init_logger();
 init_path_resolver();
 var import_fs_extra36 = __toESM(require_lib(), 1);
-var import_picocolors24 = __toESM(require_picocolors(), 1);
+var import_picocolors26 = __toESM(require_picocolors(), 1);
 async function handleSync(ctx) {
   if (!ctx.options.sync) {
     return ctx;
@@ -85917,7 +86261,7 @@ async function executeSyncMerge(ctx) {
     }
     const backupDir = PathResolver.getBackupDir();
     await createBackup(ctx.claudeDir, trackedFiles, backupDir);
-    logger.success(`Backup created at ${import_picocolors24.default.dim(backupDir)}`);
+    logger.success(`Backup created at ${import_picocolors26.default.dim(backupDir)}`);
     if (plan.autoUpdate.length > 0) {
       logger.info(`Auto-updating ${plan.autoUpdate.length} file(s)...`);
       let updateSuccess = 0;
@@ -86027,22 +86371,22 @@ async function executeSyncMerge(ctx) {
         totalRejected += result.rejected;
       }
       console.log("");
-      console.log(import_picocolors24.default.bold("Sync Summary:"));
-      console.log(import_picocolors24.default.dim("─".repeat(40)));
+      console.log(import_picocolors26.default.bold("Sync Summary:"));
+      console.log(import_picocolors26.default.dim("─".repeat(40)));
       if (plan.autoUpdate.length > 0) {
-        console.log(import_picocolors24.default.green(`  ✓ ${plan.autoUpdate.length} file(s) auto-updated`));
+        console.log(import_picocolors26.default.green(`  ✓ ${plan.autoUpdate.length} file(s) auto-updated`));
       }
       if (totalApplied > 0) {
-        console.log(import_picocolors24.default.green(`  ✓ ${totalApplied} hunk(s) applied`));
+        console.log(import_picocolors26.default.green(`  ✓ ${totalApplied} hunk(s) applied`));
       }
       if (totalRejected > 0) {
-        console.log(import_picocolors24.default.yellow(`  ○ ${totalRejected} hunk(s) rejected`));
+        console.log(import_picocolors26.default.yellow(`  ○ ${totalRejected} hunk(s) rejected`));
       }
       if (skippedFiles > 0) {
-        console.log(import_picocolors24.default.yellow(`  ○ ${skippedFiles} file(s) skipped`));
+        console.log(import_picocolors26.default.yellow(`  ○ ${skippedFiles} file(s) skipped`));
       }
       if (plan.skipped.length > 0) {
-        console.log(import_picocolors24.default.dim(`  ─ ${plan.skipped.length} user-owned file(s) unchanged`));
+        console.log(import_picocolors26.default.dim(`  ─ ${plan.skipped.length} user-owned file(s) unchanged`));
       }
     } else if (plan.needsReview.length > 0 && ctx.isNonInteractive) {
       logger.error(`Cannot complete sync: ${plan.needsReview.length} file(s) require interactive review`);
@@ -86065,30 +86409,30 @@ Options:
 }
 function displaySyncPlan(plan) {
   console.log("");
-  console.log(import_picocolors24.default.bold("Sync Plan:"));
-  console.log(import_picocolors24.default.dim("─".repeat(40)));
+  console.log(import_picocolors26.default.bold("Sync Plan:"));
+  console.log(import_picocolors26.default.dim("─".repeat(40)));
   if (plan.autoUpdate.length > 0) {
-    console.log(import_picocolors24.default.green(`  ${plan.autoUpdate.length} file(s) will be auto-updated`));
+    console.log(import_picocolors26.default.green(`  ${plan.autoUpdate.length} file(s) will be auto-updated`));
     for (const file of plan.autoUpdate.slice(0, 5)) {
-      console.log(import_picocolors24.default.dim(`    • ${file.path}`));
+      console.log(import_picocolors26.default.dim(`    • ${file.path}`));
     }
     if (plan.autoUpdate.length > 5) {
-      console.log(import_picocolors24.default.dim(`    ... and ${plan.autoUpdate.length - 5} more`));
+      console.log(import_picocolors26.default.dim(`    ... and ${plan.autoUpdate.length - 5} more`));
     }
   }
   if (plan.needsReview.length > 0) {
-    console.log(import_picocolors24.default.yellow(`  ${plan.needsReview.length} file(s) need interactive review`));
+    console.log(import_picocolors26.default.yellow(`  ${plan.needsReview.length} file(s) need interactive review`));
     for (const file of plan.needsReview.slice(0, 5)) {
-      console.log(import_picocolors24.default.dim(`    • ${file.path}`));
+      console.log(import_picocolors26.default.dim(`    • ${file.path}`));
     }
     if (plan.needsReview.length > 5) {
-      console.log(import_picocolors24.default.dim(`    ... and ${plan.needsReview.length - 5} more`));
+      console.log(import_picocolors26.default.dim(`    ... and ${plan.needsReview.length - 5} more`));
     }
   }
   if (plan.skipped.length > 0) {
-    console.log(import_picocolors24.default.dim(`  ${plan.skipped.length} user-owned file(s) will be skipped`));
+    console.log(import_picocolors26.default.dim(`  ${plan.skipped.length} user-owned file(s) will be skipped`));
   }
-  console.log(import_picocolors24.default.dim("─".repeat(40)));
+  console.log(import_picocolors26.default.dim("─".repeat(40)));
 }
 async function createBackup(claudeDir, files, backupDir) {
   await mkdir28(backupDir, { recursive: true });
@@ -87749,26 +88093,14 @@ async function addCommand(service, options2 = {}) {
 }
 // src/commands/mcp/list-command.ts
 init_logger();
-var import_picocolors25 = __toESM(require_picocolors(), 1);
+var import_picocolors27 = __toESM(require_picocolors(), 1);
 function statusCell(configured) {
-  return configured ? { value: "● configured", paint: import_picocolors25.default.green } : { value: "○ not set", paint: import_picocolors25.default.dim };
-}
-function renderTable(header, rows) {
-  const lastCol = header.length - 1;
-  const widths = header.map((h2, col) => Math.max(h2.length, ...rows.map((r2) => r2[col]?.value.length ?? 0)));
-  const padPlain = (text, col) => col === lastCol ? text : text.padEnd(widths[col]);
-  const headerLine = import_picocolors25.default.bold(header.map((h2, col) => padPlain(h2, col)).join("  ").trimEnd());
-  const rowLine = (cells) => cells.map((cell, col) => {
-    const padded = padPlain(cell.value, col);
-    return cell.paint ? cell.paint(padded) : padded;
-  }).join("  ").trimEnd();
-  return [headerLine, ...rows.map(rowLine)].join(`
-`);
+  return configured ? { value: "● configured", paint: import_picocolors27.default.green } : { value: "○ not set", paint: import_picocolors27.default.dim };
 }
-async function listCommand(options2 = {}) {
+async function listCommand(options2 = {}, deps) {
   let listed;
   try {
-    listed = await runList();
+    listed = await runList(deps);
   } catch (error) {
     if (error instanceof RegistryUnavailableError) {
       logger.error(error.message);
@@ -88606,7 +88938,7 @@ function buildPlanSummary(planFile) {
 // src/commands/plan/plan-read-handlers.ts
 init_logger();
 init_output_manager();
-var import_picocolors26 = __toESM(require_picocolors(), 1);
+var import_picocolors28 = __toESM(require_picocolors(), 1);
 async function handleParse(target, options2) {
   const planFile = resolvePlanFile(target);
   if (!planFile) {
@@ -88629,7 +88961,7 @@ async function handleParse(target, options2) {
   }
   const title = typeof frontmatter.title === "string" ? frontmatter.title : basename21(dirname41(planFile));
   console.log();
-  console.log(import_picocolors26.default.bold(`  Plan: ${title}`));
+  console.log(import_picocolors28.default.bold(`  Plan: ${title}`));
   console.log(`  File: ${planFile}`);
   console.log(`  Phases found: ${phases.length}`);
   console.log();
@@ -88660,7 +88992,7 @@ async function handleValidate(target, options2) {
     return;
   }
   console.log();
-  console.log(import_picocolors26.default.bold(`  Validating: ${planFile}`));
+  console.log(import_picocolors28.default.bold(`  Validating: ${planFile}`));
   console.log();
   if (result.issues.length === 0) {
     console.log(`  [OK] No issues found — ${result.phases.length} phases detected`);
@@ -88674,7 +89006,7 @@ async function handleValidate(target, options2) {
     }
   }
   console.log();
-  const validStr = result.valid ? import_picocolors26.default.green("[OK] Valid") : import_picocolors26.default.red("[X] Invalid");
+  const validStr = result.valid ? import_picocolors28.default.green("[OK] Valid") : import_picocolors28.default.red("[X] Invalid");
   console.log(`  ${validStr} — ${result.issues.filter((i) => i.severity === "error").length} errors, ${result.issues.filter((i) => i.severity === "warning").length} warnings`);
   console.log();
   if (!result.valid)
@@ -88701,14 +89033,14 @@ async function handleStatus(target, options2) {
       return;
     }
     console.log();
-    console.log(import_picocolors26.default.bold(`  Plans in: ${plansDir}`));
+    console.log(import_picocolors28.default.bold(`  Plans in: ${plansDir}`));
     console.log();
     for (const pf of planFiles) {
       try {
         const s3 = buildPlanSummary(pf);
         const bar = progressBar(s3.completed, s3.totalPhases);
         const title2 = s3.title ?? basename21(dirname41(pf));
-        console.log(`  ${import_picocolors26.default.bold(title2)}`);
+        console.log(`  ${import_picocolors28.default.bold(title2)}`);
         console.log(`  ${bar}`);
         if (s3.inProgress > 0)
           console.log(`  [~] ${s3.inProgress} in progress`);
@@ -88740,7 +89072,7 @@ async function handleStatus(target, options2) {
   }
   const title = summary.title ?? basename21(dirname41(planFile));
   console.log();
-  console.log(import_picocolors26.default.bold(`  ${title}`));
+  console.log(import_picocolors28.default.bold(`  ${title}`));
   if (summary.status)
     console.log(`  Status: ${summary.status}`);
   console.log();
@@ -88766,7 +89098,7 @@ async function handleKanban(target, _options) {
 // src/commands/plan/plan-write-handlers.ts
 import { basename as basename22, relative as relative22, resolve as resolve34 } from "node:path";
 init_output_manager();
-var import_picocolors27 = __toESM(require_picocolors(), 1);
+var import_picocolors29 = __toESM(require_picocolors(), 1);
 async function handleCreate(target, options2) {
   if (!options2.title) {
     output.error("[X] --title is required for create");
@@ -88813,7 +89145,7 @@ async function handleCreate(target, options2) {
     return;
   }
   console.log();
-  console.log(import_picocolors27.default.bold(`  [OK] Plan created: ${options2.title}`));
+  console.log(import_picocolors29.default.bold(`  [OK] Plan created: ${options2.title}`));
   console.log(`  Directory: ${resolve34(dir)}`);
   console.log(`  Phases: ${result.phaseFiles.length}`);
   for (const f4 of result.phaseFiles) {
@@ -89972,7 +90304,7 @@ init_manifest_writer();
 init_logger();
 init_safe_prompts();
 init_types2();
-var import_picocolors29 = __toESM(require_picocolors(), 1);
+var import_picocolors31 = __toESM(require_picocolors(), 1);
 
 // src/commands/uninstall/installation-detector.ts
 init_paths();
@@ -90031,7 +90363,7 @@ init_ownership_checker();
 init_logger();
 init_safe_prompts();
 init_takumi_constants();
-var import_picocolors28 = __toESM(require_picocolors(), 1);
+var import_picocolors30 = __toESM(require_picocolors(), 1);
 import { existsSync as existsSync70, readdirSync as readdirSync13, rmSync as rmSync10 } from "node:fs";
 import { dirname as dirname43, join as join141 } from "node:path";
 function listPresentManifestNames(installPath) {
@@ -90136,27 +90468,27 @@ async function analyzeInstallation(installation, forceOverwrite, kit) {
 }
 function displayDryRunPreview(analysis, installationType) {
   console.log("");
-  log.info(import_picocolors28.default.bold(`DRY RUN - Preview for ${installationType} installation:`));
+  log.info(import_picocolors30.default.bold(`DRY RUN - Preview for ${installationType} installation:`));
   console.log("");
   if (analysis.toDelete.length > 0) {
-    console.log(import_picocolors28.default.red(import_picocolors28.default.bold(`Files to DELETE (${analysis.toDelete.length}):`)));
+    console.log(import_picocolors30.default.red(import_picocolors30.default.bold(`Files to DELETE (${analysis.toDelete.length}):`)));
     const showDelete = analysis.toDelete.slice(0, 10);
     for (const item of showDelete) {
-      console.log(`  ${import_picocolors28.default.red("✖")} ${item.path}`);
+      console.log(`  ${import_picocolors30.default.red("✖")} ${item.path}`);
     }
     if (analysis.toDelete.length > 10) {
-      console.log(import_picocolors28.default.gray(`  ... and ${analysis.toDelete.length - 10} more`));
+      console.log(import_picocolors30.default.gray(`  ... and ${analysis.toDelete.length - 10} more`));
     }
     console.log("");
   }
   if (analysis.toPreserve.length > 0) {
-    console.log(import_picocolors28.default.green(import_picocolors28.default.bold(`Files to PRESERVE (${analysis.toPreserve.length}):`)));
+    console.log(import_picocolors30.default.green(import_picocolors30.default.bold(`Files to PRESERVE (${analysis.toPreserve.length}):`)));
     const showPreserve = analysis.toPreserve.slice(0, 10);
     for (const item of showPreserve) {
-      console.log(`  ${import_picocolors28.default.green("✓")} ${item.path} ${import_picocolors28.default.gray(`(${item.reason})`)}`);
+      console.log(`  ${import_picocolors30.default.green("✓")} ${item.path} ${import_picocolors30.default.gray(`(${item.reason})`)}`);
     }
     if (analysis.toPreserve.length > 10) {
-      console.log(import_picocolors28.default.gray(`  ... and ${analysis.toPreserve.length - 10} more`));
+      console.log(import_picocolors30.default.gray(`  ... and ${analysis.toPreserve.length - 10} more`));
     }
     console.log("");
   }
@@ -90278,15 +90610,15 @@ function displayInstallations(installations, scope) {
   const hasLegacy = installations.some((i) => !i.hasMetadata);
   const lines = installations.map((i) => {
     const typeLabel = i.type === "local" ? "Local " : "Global";
-    const legacyTag = !i.hasMetadata ? import_picocolors29.default.yellow(" [legacy]") : "";
+    const legacyTag = !i.hasMetadata ? import_picocolors31.default.yellow(" [legacy]") : "";
     const components = formatComponentSummary(i);
     return `  ${typeLabel}: ${i.path}${legacyTag}${components}`;
   });
   prompts.note(lines.join(`
 `), `Detected Takumi installations (${scopeLabel})`);
   if (hasLegacy) {
-    log.warn(import_picocolors29.default.yellow(`[!] Legacy installation(s) detected without metadata.json.
-`) + import_picocolors29.default.yellow("    These files cannot be selectively removed. Full directory cleanup will be performed."));
+    log.warn(import_picocolors31.default.yellow(`[!] Legacy installation(s) detected without metadata.json.
+`) + import_picocolors31.default.yellow("    These files cannot be selectively removed. Full directory cleanup will be performed."));
   }
   log.warn("[!] This will permanently delete Takumi files from the above paths.");
 }
@@ -90346,7 +90678,7 @@ async function uninstallCommand(options2) {
     }
     const isAtHome = isLocalSameAsGlobal();
     if (validOptions.local && !validOptions.global && isAtHome) {
-      log.warn(import_picocolors29.default.yellow("Cannot use --local at HOME directory (local path equals global path)."));
+      log.warn(import_picocolors31.default.yellow("Cannot use --local at HOME directory (local path equals global path)."));
       log.info("Use -g/--global or run from a project directory.");
       return;
     }
@@ -90358,7 +90690,7 @@ async function uninstallCommand(options2) {
     } else if (validOptions.global) {
       scope = "global";
     } else if (isAtHome) {
-      log.info(import_picocolors29.default.cyan("Running at HOME directory - targeting global installation"));
+      log.info(import_picocolors31.default.cyan("Running at HOME directory - targeting global installation"));
       scope = "global";
     } else {
       const promptedScope = await promptScope(allInstallations);
@@ -90380,10 +90712,10 @@ async function uninstallCommand(options2) {
     }
     displayInstallations(installations, scope);
     if (validOptions.kit) {
-      log.info(import_picocolors29.default.cyan(`Kit-scoped uninstall: ${validOptions.kit} kit only`));
+      log.info(import_picocolors31.default.cyan(`Kit-scoped uninstall: ${validOptions.kit} kit only`));
     }
     if (validOptions.dryRun) {
-      log.info(import_picocolors29.default.yellow("DRY RUN MODE - No files will be deleted"));
+      log.info(import_picocolors31.default.yellow("DRY RUN MODE - No files will be deleted"));
       await removeInstallations(installations, {
         dryRun: true,
         forceOverwrite: validOptions.forceOverwrite,
@@ -90393,8 +90725,8 @@ async function uninstallCommand(options2) {
       return;
     }
     if (validOptions.forceOverwrite) {
-      log.warn(`${import_picocolors29.default.yellow(import_picocolors29.default.bold("FORCE MODE ENABLED"))}
-${import_picocolors29.default.yellow("User modifications will be permanently deleted!")}`);
+      log.warn(`${import_picocolors31.default.yellow(import_picocolors31.default.bold("FORCE MODE ENABLED"))}
+${import_picocolors31.default.yellow("User modifications will be permanently deleted!")}`);
     }
     if (!validOptions.yes) {
       const kitLabel = validOptions.kit ? ` (${validOptions.kit} kit only)` : "";
@@ -90847,8 +91179,8 @@ init_auth_client();
 init_github_client();
 init_logger();
 init_types2();
-var import_picocolors30 = __toESM(require_picocolors(), 1);
-function formatRelativeTime(dateString) {
+var import_picocolors32 = __toESM(require_picocolors(), 1);
+function formatRelativeTime2(dateString) {
   if (!dateString)
     return "Unknown";
   const date = new Date(dateString);
@@ -90869,21 +91201,21 @@ function formatRelativeTime(dateString) {
 }
 function displayKitReleases(kitName, releases) {
   console.log(`
-${import_picocolors30.default.bold(import_picocolors30.default.cyan(kitName))} - Available Versions:
+${import_picocolors32.default.bold(import_picocolors32.default.cyan(kitName))} - Available Versions:
 `);
   if (releases.length === 0) {
-    console.log(import_picocolors30.default.dim("  No releases found"));
+    console.log(import_picocolors32.default.dim("  No releases found"));
     return;
   }
   for (const release of releases) {
-    const version3 = import_picocolors30.default.green(release.tag);
-    const publishedAt = formatRelativeTime(release.publishedAt);
-    const badge = release.prerelease ? ` ${import_picocolors30.default.yellow("[prerelease]")}` : "";
+    const version3 = import_picocolors32.default.green(release.tag);
+    const publishedAt = formatRelativeTime2(release.publishedAt);
+    const badge = release.prerelease ? ` ${import_picocolors32.default.yellow("[prerelease]")}` : "";
     const versionPart = version3.padEnd(20);
-    const timePart = import_picocolors30.default.dim(publishedAt.padEnd(20));
+    const timePart = import_picocolors32.default.dim(publishedAt.padEnd(20));
     console.log(`  ${versionPart}  ${timePart}${badge}`);
   }
-  console.log(import_picocolors30.default.dim(`
+  console.log(import_picocolors32.default.dim(`
 Showing ${releases.length} ${releases.length === 1 ? "release" : "releases"}`));
 }
 async function fetchReleasesForKit(kitType, options2) {
@@ -90928,8 +91260,8 @@ async function versionCommand(options2) {
     for (const result of results) {
       if (result.error) {
         console.log(`
-${import_picocolors30.default.bold(import_picocolors30.default.cyan(result.kitConfig.name))} - ${import_picocolors30.default.red("Error")}`);
-        console.log(import_picocolors30.default.dim(`  ${result.error}`));
+${import_picocolors32.default.bold(import_picocolors32.default.cyan(result.kitConfig.name))} - ${import_picocolors32.default.red("Error")}`);
+        console.log(import_picocolors32.default.dim(`  ${result.error}`));
       } else {
         displayKitReleases(result.kitConfig.name, result.releases);
       }
@@ -90951,6 +91283,23 @@ function normalizeSkillGroupFlag(value) {
 }
 
 // src/cli/command-registry.ts
+function parsePositiveIntFlag(raw, label, example, max) {
+  if (raw === undefined)
+    return;
+  const value = Number(String(raw));
+  if (!Number.isInteger(value) || value < 1) {
+    console.error(`Invalid ${label}: ${raw}. Use a positive integer, e.g. ${example}`);
+    process.exitCode = 1;
+    return null;
+  }
+  if (max !== undefined && value > max) {
+    console.error(`Invalid ${label}: ${raw}. Maximum is ${max}, e.g. ${example}`);
+    process.exitCode = 1;
+    return null;
+  }
+  return value;
+}
+var ARTIFACT_LIST_LIMIT_MAX = 100;
 function registerCommands(cli) {
   cli.command("init", "Initialize or update Takumi project (with interactive version selection)").option("--dir <dir>", "Target directory (default: .)").option("--kit <kit>", "Kit(s) to install (core, extras). Repeat the flag to install multiple kits, e.g. --kit core --kit extras.").option("-r, --release <version>", "Skip version selection, use specific version (e.g., latest, v1.0.0)").option("--exclude <pattern>", "Exclude files matching glob pattern (can be used multiple times)").option("--only <pattern>", "Include only files matching glob pattern (can be used multiple times)").option("--skill-role <role>", "Install only skills tagged with these role(s) (comma-separated or repeatable). Combines with --skill-category as a union.").option("--skill-category <category>", "Install only skills in these categor(y/ies) (comma-separated or repeatable). Combines with --skill-role as a union.").option("-g, --global", "Use platform-specific user configuration directory").option("--fresh", "Full reset: remove takumi files, replace settings.json and CLAUDE.md, reinstall from scratch").option("--force", "Force reinstall even if already at latest version (use with --yes; re-onboards missing files without full reset)").option("--install-skills", "Install skills dependencies (non-interactive mode)").option("--install-hooks", "Install all agent hooks (guard, session, convention, extension). Default installs only telemetry hooks.").option("--with-sudo", "Include system packages requiring sudo (Linux: ffmpeg, imagemagick)").option("--prefix", "Add /tkm: prefix to all slash commands by moving them to commands/tkm/ subdirectory").option("--beta", "Show beta versions in selection prompt").option("--refresh", "Bypass release cache to fetch latest versions from GitHub").option("--dry-run", "Preview changes without applying them (requires --prefix)").option("--force-overwrite", "Override ownership protections and delete user-modified files (requires --prefix)").option("--force-overwrite-settings", "Fully replace settings.json instead of selective merge (destroys user customizations)").option("--docs-dir <name>", "Custom docs folder name (default: docs)").option("--plans-dir <name>", "Custom plans folder name (default: plans)").option("-y, --yes", "Non-interactive mode with sensible defaults (skip all prompts)").option("--sync", "Sync config files from upstream with interactive hunk-by-hunk merge").option("--use-git", "Use git clone instead of GitHub API (uses SSH/HTTPS credentials)").option("--archive <path>", "Use local archive file instead of downloading (zip/tar.gz)").option("--kit-path <path>", "Use local kit directory instead of downloading").option("--local", "Use local monorepo as kit source (auto-detects from CLI location)").option("--use-gh", "Force GitHub release source (bypass the Worker release distribution API; default uses Worker)").option("-a, --agent <agents...>", "Target agents (claude-code, codex). Default: claude-code").action(async (options2) => {
     if (options2.exclude && !Array.isArray(options2.exclude)) {
@@ -91059,14 +91408,17 @@ function registerCommands(cli) {
   cli.command("api [action] [service] [path]", "Interact with Takumi API and proxy services").option("--method <method>", "HTTP method for proxy requests (default: GET)").option("--body <json>", "Request body as JSON string (proxy only)").option("--query <json>", "Query params as JSON string (proxy only)").option("--key <key>", "API key to use (setup only)").option("--force", "Force re-setup even if key exists (setup only)").option("--json", "Output raw JSON instead of formatted display").option("--locale <locale>", "Locale for vidcap summary/caption (default: en)").option("--max-results <n>", "Max results for vidcap search").option("--second <s>", "Timestamp in seconds for vidcap screenshot").option("--order <order>", "Sort order for vidcap comments (time/relevance)").option("--format <fmt>", "Summary format for reviewweb (bullet/paragraph)").option("--max-length <n>", "Max summary length for reviewweb").option("--instructions <text>", "Extraction instructions for reviewweb extract").option("--template <json>", "JSON template for reviewweb extract").option("--type <type>", "Link type filter for reviewweb links (web/image/file/all)").option("--country <code>", "Country code for reviewweb SEO commands").action(async (action, service, path11, options2) => {
     await apiCommand(action, service, path11, options2);
   });
-  cli.command("artifact [action] [target]", "Manage Takumi artifacts (upload <file> | download <uuid|url> | delete <uuid|url>)").option("--id <uuid|url>", "Existing artifact (UUID or viewer URL) to overwrite on upload").option("--title <title>", "Display title for the artifact (max 200 chars)").option("-m, --message <message>", "Short note describing this version's change (max 100 chars)").option("-o, --output <dir>", "(download) Output directory; default: slug(title) or uuid in CWD").option("--ver <n>", "Version number (download: download it; delete: delete only that version)").option("--force", "(download) Allow writing into a non-empty directory").option("-y, --yes", "Skip delete confirmation prompt").action(async (action, target, opts) => {
-    const version3 = opts.ver !== undefined ? Number.parseInt(String(opts.ver), 10) : undefined;
-    if (version3 !== undefined && (!Number.isInteger(version3) || version3 < 1)) {
-      console.error(`Invalid version: ${opts.ver}. Use a positive integer, e.g. --ver 2`);
-      process.exitCode = 1;
+  cli.command("artifact [action] [target]", "Manage Takumi artifacts (list | search <term> | upload <file> | download <uuid|url> | delete <uuid|url>)").option("--id <uuid|url>", "Existing artifact (UUID or viewer URL) to overwrite on upload").option("--title <title>", "Display title for the artifact (max 200 chars)").option("-m, --message <message>", "Short note describing this version's change (max 100 chars)").option("-o, --output <dir>", "(download) Output directory; default: slug(title) or uuid in CWD").option("--ver <n>", "Version number (download: download it; delete: delete only that version)").option("--force", "(download) Allow writing into a non-empty directory").option("-y, --yes", "Skip delete confirmation prompt").option("--access <level>", "(list) Filter by access level: private | restricted | organization").option("--page <n>", "(list) Page number, 1-based (default: 1)").option("--limit <n>", "(list) Rows per page, max 100 (default: 10)").option("--json", "(list/search) Machine-readable JSON output").action(async (action, target, opts) => {
+    const version3 = parsePositiveIntFlag(opts.ver, "version", "--ver 2");
+    if (version3 === null)
       return;
-    }
-    await artifactCommand(action, target, { ...opts, version: version3 });
+    const page = parsePositiveIntFlag(opts.page, "page", "--page 2");
+    if (page === null)
+      return;
+    const limit = parsePositiveIntFlag(opts.limit, "limit", "--limit 25", ARTIFACT_LIST_LIMIT_MAX);
+    if (limit === null)
+      return;
+    await artifactCommand(action, target, { ...opts, version: version3, page, limit });
   });
   cli.command("auth [action]", "Sign in/out, refresh, and check Takumi session (login|logout|refresh|status)").option("--json", "Machine-readable JSON output (status, refresh)").option("-f, --force", "Force a token refresh even when the current token is still valid (refresh only)").action(async (action, options2 = {}) => {
     switch (action) {
@@ -91241,7 +91593,7 @@ function getPackageVersion3() {
 
 // src/shared/logger.ts
 init_output_manager();
-var import_picocolors31 = __toESM(require_picocolors(), 1);
+var import_picocolors33 = __toESM(require_picocolors(), 1);
 import { createWriteStream as createWriteStream4 } from "node:fs";
 
 class Logger2 {
@@ -91250,23 +91602,23 @@ class Logger2 {
   exitHandlerRegistered = false;
   info(message) {
     const symbols = output.getSymbols();
-    console.log(import_picocolors31.default.blue(symbols.info), message);
+    console.log(import_picocolors33.default.blue(symbols.info), message);
   }
   success(message) {
     const symbols = output.getSymbols();
-    console.log(import_picocolors31.default.green(symbols.success), message);
+    console.log(import_picocolors33.default.green(symbols.success), message);
   }
   warning(message) {
     const symbols = output.getSymbols();
-    console.log(import_picocolors31.default.yellow(symbols.warning), message);
+    console.log(import_picocolors33.default.yellow(symbols.warning), message);
   }
   error(message) {
     const symbols = output.getSymbols();
-    console.error(import_picocolors31.default.red(symbols.error), message);
+    console.error(import_picocolors33.default.red(symbols.error), message);
   }
   debug(message) {
     if (process.env.DEBUG) {
-      console.log(import_picocolors31.default.gray("[DEBUG]"), message);
+      console.log(import_picocolors33.default.gray("[DEBUG]"), message);
     }
   }
   verbose(message, context) {
@@ -91275,7 +91627,7 @@ class Logger2 {
     const timestamp = this.getTimestamp();
     const sanitizedMessage = this.sanitize(message);
     const formattedContext = context ? this.formatContext(context) : "";
-    const logLine = `${timestamp} ${import_picocolors31.default.gray("[VERBOSE]")} ${sanitizedMessage}${formattedContext}`;
+    const logLine = `${timestamp} ${import_picocolors33.default.gray("[VERBOSE]")} ${sanitizedMessage}${formattedContext}`;
     console.error(logLine);
     if (this.logFileStream) {
       const plainLogLine = `${timestamp} [VERBOSE] ${sanitizedMessage}${formattedContext}`;
@@ -91378,7 +91730,7 @@ var logger3 = new Logger2;
 
 // src/shared/output-manager.ts
 init_terminal_utils();
-var import_picocolors32 = __toESM(require_picocolors(), 1);
+var import_picocolors34 = __toESM(require_picocolors(), 1);
 var SYMBOLS2 = {
   unicode: {
     prompt: "◇",
@@ -91459,7 +91811,7 @@ class OutputManager2 {
     if (this.config.quiet)
       return;
     const symbol = this.getSymbols().success;
-    console.log(import_picocolors32.default.green(`${symbol} ${message}`));
+    console.log(import_picocolors34.default.green(`${symbol} ${message}`));
   }
   error(message, data) {
     if (this.config.json) {
@@ -91467,7 +91819,7 @@ class OutputManager2 {
       return;
     }
     const symbol = this.getSymbols().error;
-    console.error(import_picocolors32.default.red(`${symbol} ${message}`));
+    console.error(import_picocolors34.default.red(`${symbol} ${message}`));
   }
   warning(message, data) {
     if (this.config.json) {
@@ -91477,7 +91829,7 @@ class OutputManager2 {
     if (this.config.quiet)
       return;
     const symbol = this.getSymbols().warning;
-    console.log(import_picocolors32.default.yellow(`${symbol} ${message}`));
+    console.log(import_picocolors34.default.yellow(`${symbol} ${message}`));
   }
   info(message, data) {
     if (this.config.json) {
@@ -91487,7 +91839,7 @@ class OutputManager2 {
     if (this.config.quiet)
       return;
     const symbol = this.getSymbols().info;
-    console.log(import_picocolors32.default.blue(`${symbol} ${message}`));
+    console.log(import_picocolors34.default.blue(`${symbol} ${message}`));
   }
   verbose(message, data) {
     if (!this.config.verbose)
@@ -91496,7 +91848,7 @@ class OutputManager2 {
       this.addJsonEntry({ type: "info", message, data });
       return;
     }
-    console.log(import_picocolors32.default.dim(`  ${message}`));
+    console.log(import_picocolors34.default.dim(`  ${message}`));
   }
   indent(message) {
     if (this.config.json)
@@ -91521,7 +91873,7 @@ class OutputManager2 {
       return;
     const symbols = this.getSymbols();
     console.log();
-    console.log(import_picocolors32.default.bold(import_picocolors32.default.cyan(`${symbols.line} ${title}`)));
+    console.log(import_picocolors34.default.bold(import_picocolors34.default.cyan(`${symbols.line} ${title}`)));
   }
   addJsonEntry(entry) {
     this.jsonBuffer.push({