@sunasteriskrnd/takumi 1.0.0-dev.64 → 1.0.0-dev.66

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.64",
+    version: "1.0.0-dev.66",
     description: "CLI tool for bootstrapping and managing Takumi projects",
     type: "module",
     repository: {
@@ -20012,7 +20012,7 @@ function getLegacyManifestPath(providerRoot) {
   return join4(providerRoot, LEGACY_MANIFEST_FILENAME);
 }
 function getCliVersion() {
-  return "1.0.0-dev.64"?.trim() || process.env.npm_package_version?.trim() || "unknown";
+  return "1.0.0-dev.66"?.trim() || process.env.npm_package_version?.trim() || "unknown";
 }
 function getCliUserAgent() {
   return `${TAKUMI_CLI_NPM_PACKAGE_NAME}/${getCliVersion()}`;
@@ -51450,6 +51450,10 @@ var init_artifact_action_help = __esm(() => {
           {
             flags: "-m, --message <message>",
             description: "Short note describing this version's change (max 100 chars)"
+          },
+          {
+            flags: "--open",
+            description: "Open the artifact in the browser after a successful upload"
           }
         ]
       }
@@ -51692,15 +51696,65 @@ var init_artifact_comments_help = __esm(() => {
   };
 });
 
+// src/domains/help/commands/artifact-open-help.ts
+var artifactOpenHelp;
+var init_artifact_open_help = __esm(() => {
+  artifactOpenHelp = {
+    name: "artifact open",
+    description: "Open the artifact viewer (or the dashboard with no ref) in the browser",
+    usage: "tkm artifact open [uuid|url] [options]",
+    examples: [
+      {
+        command: "tkm artifact open",
+        description: "Open the artifacts dashboard (no artifact reference)"
+      },
+      {
+        command: "tkm artifact open <uuid|url>",
+        description: "Open the latest version of an artifact in the viewer"
+      },
+      {
+        command: "tkm artifact open <uuid|url> --ver 3 --file README.md",
+        description: "Deep-link to version 3 and a specific file inside the artifact"
+      }
+    ],
+    optionGroups: [
+      {
+        title: "Options",
+        options: [
+          {
+            flags: "--ver <n>",
+            description: "Version to open. ?v=<n> in a pasted URL works too; --ver wins when both given"
+          },
+          {
+            flags: "--file <path>",
+            description: "Deep-link to a file INSIDE the artifact (not a local file — contrast with `comments reply --file`, which reads a local file's contents)"
+          },
+          {
+            flags: "--thread <uuid>",
+            description: "Deep-link to a comment thread by id"
+          }
+        ]
+      }
+    ],
+    sections: [
+      {
+        title: "Notes",
+        content: "Makes no API calls — an invalid reference is rejected locally, and a valid-looking but nonexistent artifact simply 404s in the browser."
+      }
+    ]
+  };
+});
+
 // src/domains/help/commands/artifact-command-help.ts
 var artifactCommandHelp;
 var init_artifact_command_help = __esm(() => {
   init_artifact_action_help();
   init_artifact_comments_help();
+  init_artifact_open_help();
   artifactCommandHelp = {
     name: "artifact",
-    description: "List, search, upload, download, and delete Takumi artifacts, and work with their review comments",
-    usage: "tkm artifact <list | search <term> | upload <file|dir> | download <uuid|url> | delete <uuid|url> | comments <verb> <uuid|url> [id]>",
+    description: "List, search, upload, download, delete, and open Takumi artifacts, and work with their review comments",
+    usage: "tkm artifact <list | search <term> | upload <file|dir> | download <uuid|url> | delete <uuid|url> | open [uuid|url] | comments <verb> <uuid|url> [id]>",
     examples: [
       {
         command: "tkm artifact upload ./report.html --title 'Weekly Report'",
@@ -51739,6 +51793,10 @@ var init_artifact_command_help = __esm(() => {
             flags: "delete <uuid|url>",
             description: "Soft-delete the whole artifact, or one version with --ver <n>"
           },
+          {
+            flags: "open [uuid|url]",
+            description: "Open the viewer (or dashboard with no ref) in the browser"
+          },
           {
             flags: "comments <verb> <uuid|url> [id]",
             description: "Read and act on review comments (list|reply|solve|reopen|delete)"
@@ -51758,6 +51816,7 @@ var init_artifact_command_help = __esm(() => {
       upload: artifactUploadHelp,
       download: artifactDownloadHelp,
       delete: artifactDeleteHelp,
+      open: artifactOpenHelp,
       comments: artifactCommentsHelp
     }
   };
@@ -51842,6 +51901,7 @@ var init_commands2 = __esm(() => {
   init_artifact_command_help();
   init_artifact_comments_help();
   init_artifact_action_help();
+  init_artifact_open_help();
   init_mcp_command_help();
   init_common_options();
 });
@@ -52920,6 +52980,9 @@ ${API_KEY_VAR}=${apiKey}
   writeFileSync(envPath, content, "utf-8");
 }
 // src/domains/takumi-api/api-error-handler.ts
+var LICENSE_REQUIRED_REMEDIATION = "Your Takumi license is inactive or expired. Contact your Sun* admin to renew access.";
+var LICENSE_REQUIRED_EXIT_CODE = 4;
+
 class CkApiError extends Error {
   code;
   status;
@@ -52945,10 +53008,16 @@ function parseApiError(status, body) {
   const message = parsed?.message || parsed?.error || `API error (HTTP ${status})`;
   const retryAfter = parsed?.retryAfter;
   if (parsed?.code && isKnownErrorCode(parsed.code)) {
-    return new CkApiError(parsed.code, message, status, retryAfter);
+    const code2 = parsed.code;
+    return new CkApiError(code2, withRemediation(code2, message), status, retryAfter);
   }
   const code = mapStatusToErrorCode(status);
-  return new CkApiError(code, message, status, retryAfter);
+  return new CkApiError(code, withRemediation(code, message), status, retryAfter);
+}
+function withRemediation(code, message) {
+  if (code === "LICENSE_REQUIRED")
+    return `${message} ${LICENSE_REQUIRED_REMEDIATION}`;
+  return message;
 }
 function isKnownErrorCode(code) {
   const known = new Set([
@@ -53967,38 +54036,83 @@ function showApiHelp() {
   console.log("    takumi api reviewweb seo-backlinks <domain> SEO backlinks");
   console.log();
 }
+// src/commands/artifact/action-flag-scope.ts
+var ACTION_SCOPED_FLAGS = {
+  comments: ["status", "author", "cursor", "quiet", "file"],
+  open: ["file", "thread"],
+  upload: ["open", "id"]
+};
+var ALL_SCOPED_FLAGS = Array.from(new Set(Object.values(ACTION_SCOPED_FLAGS).flat()));
+function owningActions(flag) {
+  return Object.entries(ACTION_SCOPED_FLAGS).filter(([, flags]) => flags.includes(flag)).map(([owner]) => `\`artifact ${owner}\``);
+}
+function strayFlagDetail(action, opts) {
+  const allowed = ACTION_SCOPED_FLAGS[action] ?? [];
+  const stray = ALL_SCOPED_FLAGS.filter((flag) => !allowed.includes(flag) && opts[flag] !== undefined && opts[flag] !== false);
+  if (stray.length === 0)
+    return null;
+  return stray.map((flag) => `--${flag} (only ${owningActions(flag).join(" or ")})`).join(", ");
+}
+
 // src/commands/artifact/refs.ts
 init_auth_client();
 var UUID_V4_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 function isArtifactUuid(id) {
-  return UUID_V4_RE.test(id.trim());
+  return UUID_V4_RE.test(String(id).trim());
 }
 function parseArtifactRef(input) {
-  const s = input.trim();
+  const s = String(input).trim();
   if (UUID_V4_RE.test(s))
     return s.toLowerCase();
   const m2 = s.match(/\/artifacts\/([^/?#]+)/i);
   const candidate = m2?.[1] ?? "";
   return UUID_V4_RE.test(candidate) ? candidate.toLowerCase() : null;
 }
-function extractVersionFromRef(ref) {
+var HOST_FIRST_RE = /^[a-z0-9][a-z0-9.-]*(:\d+)?\//i;
+function tryUrl(s) {
   try {
-    const url = new URL(ref.trim());
-    const v2 = url.searchParams.get("v");
-    if (v2 !== null) {
-      const n = Number.parseInt(v2, 10);
-      return Number.isFinite(n) && n > 0 ? n : undefined;
-    }
-  } catch {}
-  return;
-}
-function warnIfHostMismatch(input) {
-  let inputUrl;
-  try {
-    inputUrl = new URL(input.trim());
+    return new URL(s);
   } catch {
+    return null;
+  }
+}
+function toUrl(ref) {
+  const s = String(ref).trim();
+  if (!s.includes("/"))
+    return null;
+  const direct = tryUrl(s);
+  if (direct && /^https?:$/.test(direct.protocol))
+    return direct;
+  return HOST_FIRST_RE.test(s) ? tryUrl(`https://${s}`) : null;
+}
+function extractVersionFromRef(ref) {
+  const url = toUrl(ref);
+  if (!url)
+    return;
+  const v2 = url.searchParams.get("v");
+  if (v2 === null || !/^[1-9]\d*$/.test(v2.trim()))
     return;
+  return Number(v2);
+}
+function extractDeepLinkFromRef(ref) {
+  const url = toUrl(ref);
+  if (!url)
+    return {};
+  const parts = {};
+  const file = url.searchParams.get("file");
+  if (file !== null && file.trim() !== "") {
+    parts.file = file;
   }
+  const thread = url.searchParams.get("thread");
+  if (thread !== null && thread.trim() !== "") {
+    parts.thread = thread;
+  }
+  return parts;
+}
+function warnIfHostMismatch(input) {
+  const inputUrl = toUrl(input);
+  if (!inputUrl)
+    return;
   let serverHost;
   try {
     serverHost = new URL(getServerUrl()).host;
@@ -55140,6 +55254,100 @@ async function artifactList(term, opts) {
   logger.info(footerLine2(payload));
 }
 
+// src/domains/sessions/browser-open.ts
+init_open();
+function tryOpenBrowser(target) {
+  open_default(target).catch(() => {});
+}
+
+// src/commands/artifact/open-in-browser.ts
+init_environment();
+function openOrPrint(url, opts) {
+  console.log(url);
+  if (isNonInteractive()) {
+    return;
+  }
+  (opts?._openBrowser ?? tryOpenBrowser)(url);
+}
+
+// src/commands/artifact/viewer-url.ts
+init_auth_client();
+function buildViewerUrl(parts) {
+  const base = getServerUrl();
+  if (!parts.uuid) {
+    return `${base}/app/artifacts`;
+  }
+  const params = new URLSearchParams;
+  const entries = [
+    ["v", parts.version],
+    ["file", parts.file],
+    ["thread", parts.thread]
+  ];
+  for (const [key, value] of entries) {
+    if (value !== undefined && String(value) !== "") {
+      params.set(key, String(value));
+    }
+  }
+  const query = params.toString();
+  return `${base}/app/artifacts/${parts.uuid}${query ? `?${query}` : ""}`;
+}
+
+// src/commands/artifact/open-command.ts
+function singleValue(label, value) {
+  if (Array.isArray(value)) {
+    console.error(`${label} may only be given once`);
+    process.exitCode = 1;
+    return null;
+  }
+  return String(value).trim();
+}
+function normalizeFilePath(file) {
+  return file.replace(/\\/g, "/").replace(/^(\.\/|\/)+/, "");
+}
+async function artifactOpen(ref, opts) {
+  if (ref === undefined) {
+    if (opts.version !== undefined || opts.file !== undefined || opts.thread !== undefined) {
+      console.error("tkm artifact open — --ver/--file/--thread require an artifact reference");
+      process.exitCode = 1;
+      return;
+    }
+    openOrPrint(buildViewerUrl({}), opts);
+    return;
+  }
+  const uuid = parseArtifactRef(ref);
+  if (!uuid) {
+    console.error(`Invalid artifact id or URL: ${ref}`);
+    process.exitCode = 1;
+    return;
+  }
+  const version3 = opts.version ?? extractVersionFromRef(ref);
+  const deep = extractDeepLinkFromRef(ref);
+  const rawFile = opts.file ?? deep.file;
+  let file;
+  if (rawFile !== undefined) {
+    const single = singleValue("--file", rawFile);
+    if (single === null)
+      return;
+    file = normalizeFilePath(single);
+  }
+  const rawThread = opts.thread ?? deep.thread;
+  let thread;
+  if (rawThread !== undefined) {
+    const single = singleValue("--thread", rawThread);
+    if (single === null)
+      return;
+    if (!isArtifactUuid(single)) {
+      console.error(`Invalid thread id (must be a UUID): ${single}`);
+      process.exitCode = 1;
+      return;
+    }
+    thread = single.toLowerCase();
+  }
+  warnIfHostMismatch(ref);
+  const url = buildViewerUrl({ uuid, version: version3, file, thread });
+  openOrPrint(url, opts);
+}
+
 // src/commands/artifact/upload-command.ts
 init_dist2();
 import { promises as fs14 } from "node:fs";
@@ -55273,6 +55481,13 @@ async function artifactUpload(filePath, opts) {
     process.exitCode = 1;
   }
 }
+function printResultUrl(url, opts) {
+  if (opts.open) {
+    openOrPrint(url, opts);
+  } else {
+    console.log(url);
+  }
+}
 async function uploadFile(absPath, displayPath, size, token, opts) {
   const ext = extname6(absPath).toLowerCase().slice(1);
   if (!ALLOWED_EXTENSIONS.has(ext)) {
@@ -55349,7 +55564,7 @@ async function uploadFile(absPath, displayPath, size, token, opts) {
   await upsertFolderEntry(absPath, result.uuid, result.version, folderHash);
   spinner.stop("Uploaded.");
   printUploadSummary(summary);
-  console.log(result.url);
+  printResultUrl(result.url, opts);
 }
 async function uploadFolder(absPath, displayPath, token, opts) {
   const spinner = de();
@@ -55464,15 +55679,23 @@ async function uploadFolder(absPath, displayPath, token, opts) {
   await upsertFolderEntry(absPath, result.uuid, result.version, folderHash);
   spinner.stop("Uploaded.");
   printUploadSummary(summary);
-  console.log(result.url);
+  printResultUrl(result.url, opts);
 }
 
 // src/commands/artifact/artifact-command.ts
+var ARTIFACT_ACTIONS = new Set([
+  "list",
+  "search",
+  "upload",
+  "download",
+  "delete",
+  "open",
+  "comments"
+]);
 function usageError2(hint) {
   console.error(`Usage: ${hint}`);
   process.exitCode = 1;
 }
-var COMMENTS_ONLY_FLAGS = ["status", "author", "cursor", "quiet", "file"];
 async function artifactCommand(action, target, ...rest) {
   if (rest.length !== 1 && rest.length !== 3) {
     throw new TypeError(`artifactCommand: expected 3 or 5 arguments, received ${rest.length + 2}`);
@@ -55480,13 +55703,13 @@ async function artifactCommand(action, target, ...rest) {
   const opts = rest[rest.length - 1];
   const arg3 = rest.length === 3 ? rest[0] : undefined;
   const arg4 = rest.length === 3 ? rest[1] : undefined;
-  if (action !== undefined && action !== "comments") {
-    if (arg3 !== undefined && arg3 !== null) {
+  if (action !== undefined && ARTIFACT_ACTIONS.has(action)) {
+    if (action !== "comments" && arg3 !== undefined && arg3 !== null) {
       return usageError2(`tkm artifact ${action} — unexpected extra argument "${arg3}"`);
     }
-    const stray = COMMENTS_ONLY_FLAGS.filter((flag) => opts[flag] !== undefined);
-    if (stray.length > 0) {
-      return usageError2(`tkm artifact ${action} — ${stray.map((f3) => `--${f3}`).join(", ")} ${stray.length === 1 ? "applies" : "apply"} only to \`artifact comments\``);
+    const detail = strayFlagDetail(action, opts);
+    if (detail !== null) {
+      return usageError2(`tkm artifact ${action} — ${detail}`);
     }
   }
   switch (action) {
@@ -55522,11 +55745,14 @@ async function artifactCommand(action, target, ...rest) {
       }
       await commentsCommand(target, arg3, arg4, opts);
       break;
+    case "open":
+      await artifactOpen(target, opts);
+      break;
     case undefined:
-      usageError2("tkm artifact <list | search <term> | upload <file> | download <uuid|url> | delete <uuid|url> [--ver <n>] | comments <verb> <ref> [id]>");
+      usageError2("tkm artifact <list | search <term> | upload <file> | download <uuid|url> | delete <uuid|url> [--ver <n>] | open [uuid|url] | comments <verb> <ref> [id]>");
       break;
     default:
-      console.error(`Unknown artifact action: ${action}. Available: list, search, upload, download, delete, comments`);
+      console.error(`Unknown artifact action: ${action}. Available: list, search, upload, download, delete, open, comments`);
       process.exitCode = 1;
   }
 }
@@ -56146,12 +56372,6 @@ async function configCommand(action, keyOrOptions, valueOrOptions, options2) {
   };
   return configUICommand(uiOpts);
 }
-// src/domains/sessions/browser-open.ts
-init_open();
-function tryOpenBrowser(target) {
-  open_default(target).catch(() => {});
-}
-
 // src/domains/sessions/server.ts
 init_logger();
 import * as http from "node:http";
@@ -80048,6 +80268,57 @@ function assetNameFor(kit) {
   return `takumi-${kit}-package.zip`;
 }
 
+class WorkerAssetError extends Error {
+  status;
+  reason;
+  body;
+  constructor(status2, reason, body) {
+    super(`Worker asset fetch failed (HTTP ${status2}): ${reason}`);
+    this.name = "WorkerAssetError";
+    this.status = status2;
+    this.reason = reason;
+    this.body = body;
+  }
+}
+async function parseWorkerAssetError(res) {
+  let body = null;
+  try {
+    body = await res.json();
+  } catch {
+    body = null;
+  }
+  if (res.status === 404)
+    return new WorkerAssetError(res.status, "NOT_FOUND", body);
+  if (res.status === 503)
+    return new WorkerAssetError(res.status, "TRANSIENT", body);
+  if (res.status === 403 && body?.error === "LICENSE_REQUIRED") {
+    return new WorkerAssetError(res.status, "LICENSE_REQUIRED", body);
+  }
+  return new WorkerAssetError(res.status, "UNKNOWN", body);
+}
+
+class LicenseRequiredError extends Error {
+  status = 403;
+  reason;
+  constructor(reason) {
+    super(LICENSE_REQUIRED_REMEDIATION);
+    this.name = "LicenseRequiredError";
+    this.reason = reason ?? "no_license_or_entitlement";
+  }
+}
+async function licenseErrorFromResponse(res) {
+  if (res.status !== 403)
+    return null;
+  let body = null;
+  try {
+    body = await res.json();
+  } catch {
+    body = null;
+  }
+  if (body?.error === "LICENSE_REQUIRED")
+    return new LicenseRequiredError(body.reason);
+  return null;
+}
 class WorkerSource {
   serverUrl;
   kit;
@@ -80074,6 +80345,9 @@ class WorkerSource {
     if (res.status === 401)
       throw new NotLoggedInError;
     if (!res.ok) {
+      const licenseError = await licenseErrorFromResponse(res);
+      if (licenseError)
+        throw licenseError;
       throw new Error(`Worker source: GET ${url} failed (HTTP ${res.status})`);
     }
     return ReleaseEntrySchema.parse(await res.json());
@@ -80085,6 +80359,9 @@ class WorkerSource {
     if (res.status === 401)
       throw new NotLoggedInError;
     if (!res.ok) {
+      const licenseError = await licenseErrorFromResponse(res);
+      if (licenseError)
+        throw licenseError;
       throw new Error(`Worker source: GET ${url} failed (HTTP ${res.status})`);
     }
     const parsed = ReleaseListResponseSchema.parse(await res.json());
@@ -80099,6 +80376,9 @@ class WorkerSource {
     if (res.status === 404)
       throw new NotInIndexError(tag);
     if (!res.ok) {
+      const licenseError = await licenseErrorFromResponse(res);
+      if (licenseError)
+        throw licenseError;
       throw new Error(`Worker source: GET ${url} failed (HTTP ${res.status})`);
     }
     return ReleaseEntrySchema.parse(await res.json());
@@ -80109,12 +80389,8 @@ class WorkerSource {
     const res = await fetch(url, { headers });
     if (res.status === 401)
       throw new NotLoggedInError;
-    if (res.status === 404) {
-      throw new Error(`Asset not found: ${this.kit}/${tag}/${asset}`);
-    }
-    if (!res.ok) {
-      throw new Error(`Worker source: GET ${url} failed (HTTP ${res.status})`);
-    }
+    if (!res.ok)
+      throw await parseWorkerAssetError(res);
     return res;
   }
 }
@@ -80431,6 +80707,11 @@ async function createVersionPrompt(kit, choices, _defaultIndex, allowManualEntry
   return selected;
 }
 async function handleSelectionError(error, kit, allowManualEntry, retryCallback) {
+  if (error instanceof LicenseRequiredError) {
+    le(VersionDisplayFormatter.formatError("License required", error.message), import_picocolors21.default.red("License Required"));
+    process.exitCode = LICENSE_REQUIRED_EXIT_CODE;
+    return null;
+  }
   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_picocolors21.default.red("Authentication Error"));
@@ -92358,6 +92639,27 @@ function normalizeSkillGroupFlag(value) {
 }
 
 // src/cli/command-registry.ts
+var ARTIFACT_STRING_FLAGS = [
+  "id",
+  "title",
+  "message",
+  "output",
+  "access",
+  "status",
+  "author",
+  "cursor",
+  "file",
+  "thread"
+];
+function stringifyFlags(opts, keys) {
+  const out = {};
+  for (const key of keys) {
+    const value = opts[key];
+    if (value !== undefined && !Array.isArray(value))
+      out[key] = String(value);
+  }
+  return out;
+}
 function parsePositiveIntFlag(raw, label, example, max) {
   if (raw === undefined)
     return;
@@ -92488,7 +92790,7 @@ 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] [arg3] [arg4]", "Manage Takumi artifacts (list | search <term> | upload <file> | download <uuid|url> | delete <uuid|url> | comments <verb> <ref> [id])").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>", "(upload) Version note, max 100 chars · (comments reply) Comment body").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 · (comments list) Threads per page · max 100").option("--json", "Machine-readable JSON output (list/search/comments)").option("--status <status>", "(comments list) Filter by status: open | solved | all (default: open)").option("--author <author>", "(comments list) Filter by author name, email, or user id").option("--cursor <cursor>", "(comments list) Pagination cursor from a previous page").option("--quiet", "Print only ids, one per line (comments)").option("--file <path>", "(comments reply) Read the message body from this file").action(async (action, target, arg3, arg4, opts) => {
+  cli.command("artifact [action] [target] [arg3] [arg4]", "Manage Takumi artifacts (list | search <term> | upload <file> | download <uuid|url> | delete <uuid|url> | open [uuid|url] | comments <verb> <ref> [id])").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>", "(upload) Version note, max 100 chars · (comments reply) Comment body").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; open: deep-link)").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 · (comments list) Threads per page · max 100").option("--json", "Machine-readable JSON output (list/search/comments)").option("--status <status>", "(comments list) Filter by status: open | solved | all (default: open)").option("--author <author>", "(comments list) Filter by author name, email, or user id").option("--cursor <cursor>", "(comments list) Pagination cursor from a previous page").option("--quiet", "Print only ids, one per line (comments)").option("--file <path>", "(open) Deep-link to a file · (comments reply) Read the message body from this file").option("--thread <uuid>", "(open) Deep-link to a comment thread").option("--open", "(upload) Open the artifact in the browser after a successful upload").action(async (action, target, arg3, arg4, opts) => {
     const version3 = parsePositiveIntFlag(opts.ver, "version", "--ver 2");
     if (version3 === null)
       return;
@@ -92498,7 +92800,13 @@ function registerCommands(cli) {
     const limit = parsePositiveIntFlag(opts.limit, "limit", "--limit 25", ARTIFACT_LIST_LIMIT_MAX);
     if (limit === null)
       return;
-    await artifactCommand(action, target, arg3, arg4, { ...opts, version: version3, page, limit });
+    await artifactCommand(action, target, arg3, arg4, {
+      ...opts,
+      ...stringifyFlags(opts, ARTIFACT_STRING_FLAGS),
+      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) {
@@ -92671,6 +92979,36 @@ function getPackageVersion3() {
   return packageVersion2;
 }
 
+// src/domains/installation/release-source.ts
+init_auth_client();
+class WorkerAssetError2 extends Error {
+  status;
+  reason;
+  body;
+  constructor(status2, reason, body) {
+    super(`Worker asset fetch failed (HTTP ${status2}): ${reason}`);
+    this.name = "WorkerAssetError";
+    this.status = status2;
+    this.reason = reason;
+    this.body = body;
+  }
+}
+class LicenseRequiredError2 extends Error {
+  status = 403;
+  reason;
+  constructor(reason) {
+    super(LICENSE_REQUIRED_REMEDIATION);
+    this.name = "LicenseRequiredError";
+    this.reason = reason ?? "no_license_or_entitlement";
+  }
+}
+function isLicenseRequired(error) {
+  return error instanceof LicenseRequiredError2 || error instanceof WorkerAssetError2 && error.reason === "LICENSE_REQUIRED";
+}
+
+// src/domains/takumi-api/api-error-handler.ts
+var LICENSE_REQUIRED_EXIT_CODE2 = 4;
+
 // src/shared/logger.ts
 init_output_manager();
 var import_picocolors34 = __toESM(require_picocolors(), 1);
@@ -93114,7 +93452,7 @@ var parsed = cli.parse(process.argv, { run: false });
     }
   } catch (error) {
     console.error("CLI error:", error instanceof Error ? error.message : error);
-    process.exitCode = 1;
+    process.exitCode = isLicenseRequired(error) ? LICENSE_REQUIRED_EXIT_CODE2 : 1;
     if (output2.isJson()) {
       await output2.flushJson();
     }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sunasteriskrnd/takumi",
-	"version": "1.0.0-dev.64",
+	"version": "1.0.0-dev.66",
 	"description": "CLI tool for bootstrapping and managing Takumi projects",
 	"type": "module",
 	"repository": {