@sunasteriskrnd/takumi 0.11.0 → 0.12.1

package/dist/index.js

@@ -19815,7 +19815,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@sunasteriskrnd/takumi",
-    version: "0.11.0",
+    version: "0.12.1",
     description: "CLI tool for bootstrapping and managing Takumi projects",
     type: "module",
     repository: {
@@ -39263,7 +39263,7 @@ async function installSkillsDependencies(skillsDir, options2 = {}) {
     let effectiveSkillsDir = skillsDir;
     if (!existsSync8(scriptPath)) {
       const { homedir: homedir6 } = await import("node:os");
-      const globalSkillsDir = join38(homedir6(), ".claude", "skills");
+      const globalSkillsDir = process.env.TKM_GLOBAL_SKILLS_DIR ?? join38(homedir6(), ".claude", "skills");
       const globalScriptPath = join38(globalSkillsDir, scriptName);
       if (existsSync8(globalScriptPath)) {
         logger.debug(`Local install script not found, using global: ${globalScriptPath}`);
@@ -51332,6 +51332,82 @@ 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>>",
+    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 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: "Actions",
+        options: [
+          {
+            flags: "upload <file|dir>",
+            description: "Upload a file or directory as a new artifact (or new version with --id)"
+          },
+          {
+            flags: "download <uuid|url>",
+            description: "Download an artifact's files (latest or --ver <n>)"
+          },
+          {
+            flags: "delete <uuid|url>",
+            description: "Soft-delete the whole artifact, or one version with --ver <n>"
+          }
+        ]
+      },
+      {
+        title: "Options",
+        options: [
+          {
+            flags: "--id <uuid|url>",
+            description: "(upload) Existing artifact to overwrite with a new version"
+          },
+          {
+            flags: "--title <title>",
+            description: "(upload) Display title for the artifact (max 200 chars)"
+          },
+          {
+            flags: "-m, --message <message>",
+            description: "(upload) Short note describing this version's change (max 100 chars)"
+          },
+          {
+            flags: "-o, --output <dir>",
+            description: "(download) Output directory; default: slug(title) or uuid in CWD"
+          },
+          {
+            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: "--force",
+            description: "(download) Allow writing into a non-empty directory"
+          },
+          {
+            flags: "-y, --yes",
+            description: "(delete) Skip the confirmation prompt"
+          }
+        ]
+      }
+    ]
+  };
+});
+
 // src/domains/help/commands/index.ts
 var init_commands2 = __esm(() => {
   init_init_command_help();
@@ -51341,6 +51417,7 @@ var init_commands2 = __esm(() => {
   init_versions_command_help();
   init_config_command_help();
   init_auth_command_help();
+  init_artifact_command_help();
   init_common_options();
 });
 
@@ -51359,7 +51436,8 @@ var init_help_commands = __esm(() => {
     versions: versionsCommandHelp,
     doctor: doctorCommandHelp,
     uninstall: uninstallCommandHelp,
-    auth: authCommandHelp
+    auth: authCommandHelp,
+    artifact: artifactCommandHelp
   };
 });
 
@@ -53547,6 +53625,27 @@ async function remove9(token, uuid) {
     throw new ArtifactApiError(res.status, `Delete failed (HTTP ${res.status}): ${msg}`);
   }
 }
+async function removeVersion(token, uuid, version3) {
+  const base = getServerUrl();
+  const res = await fetch(`${base}/api/artifacts/${encodeURIComponent(uuid)}/versions/${encodeURIComponent(String(version3))}`, {
+    method: "DELETE",
+    headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" }
+  });
+  if (!res.ok) {
+    const msg = await parseErrorMessage(res);
+    throw new ArtifactApiError(res.status, `Delete version failed (HTTP ${res.status}): ${msg}`);
+  }
+  try {
+    return await res.json();
+  } catch {
+    return {
+      ok: true,
+      deleted_version: undefined,
+      live_version: undefined,
+      shared_version: undefined
+    };
+  }
+}
 async function getManifest(token, uuid, version3) {
   const base = getServerUrl();
   const qs = version3 !== undefined ? `?v=${encodeURIComponent(String(version3))}` : "";
@@ -53680,6 +53779,17 @@ function parseArtifactRef(input) {
   const candidate = m2?.[1] ?? "";
   return UUID_V4_RE.test(candidate) ? candidate.toLowerCase() : null;
 }
+function extractVersionFromRef(ref) {
+  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 {
@@ -53710,6 +53820,11 @@ async function artifactDelete(ref, opts) {
   const token = await getToken(opts);
   if (!token)
     return;
+  const version3 = opts.version !== undefined ? opts.version : extractVersionFromRef(ref);
+  if (version3 !== undefined) {
+    await deleteVersion(uuid, version3, token, opts);
+    return;
+  }
   if (!opts.yes) {
     const confirmed = await se({
       message: `Delete artifact ${uuid}? This cannot be undone.`,
@@ -53730,6 +53845,36 @@ async function artifactDelete(ref, opts) {
   await removeEntry(uuid);
   console.log(`Deleted artifact ${uuid}.`);
 }
+async function deleteVersion(uuid, version3, token, opts) {
+  if (!opts.yes) {
+    const confirmed = await se({
+      message: `Delete version ${version3} of artifact ${uuid}? This cannot be undone.`,
+      initialValue: false
+    });
+    if (lD(confirmed) || !confirmed) {
+      console.log("Cancelled.");
+      return;
+    }
+  }
+  try {
+    const result = await removeVersion(token, uuid, version3);
+    if (result.live_version !== undefined) {
+      console.log(`Deleted version ${version3} of artifact ${uuid}. Live version is now ${result.live_version}.`);
+    } else {
+      console.log(`Deleted version ${version3} of artifact ${uuid}.`);
+    }
+  } catch (err) {
+    if (err instanceof ArtifactApiError && isCannotDeleteLastVersion(err)) {
+      console.error(`Error: cannot delete version ${version3} — it is the last remaining version. ` + `Delete the whole artifact instead: tkm artifact delete ${uuid}`);
+    } else {
+      printApiError(err);
+    }
+    process.exitCode = 1;
+  }
+}
+function isCannotDeleteLastVersion(err) {
+  return err.status === 409 && err.message.includes("cannot_delete_last_version");
+}
 
 // src/commands/artifact/download-command.ts
 import { promises as fs11 } from "node:fs";
@@ -53797,6 +53942,11 @@ var EXT_TO_MIME = {
   html: "text/html",
   htm: "text/html",
   md: "text/markdown",
+  mmd: "text/vnd.mermaid",
+  yaml: "application/yaml",
+  yml: "application/yaml",
+  csv: "text/csv",
+  tsv: "text/tab-separated-values",
   txt: "text/plain",
   css: "text/css",
   js: "text/javascript",
@@ -53905,17 +54055,6 @@ function deriveSlug(title, uuid) {
   const slug = (title ?? "").trim().replace(/[/\\:*?"<>|.]/g, " ").split("").map((c2) => c2.charCodeAt(0) < 32 ? " " : c2).join("").replace(/\s+/g, "-").replace(/^[.\-]+|[.\-]+$/g, "").slice(0, 80);
   return slug || uuid;
 }
-function extractVersionFromRef(ref) {
-  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;
-}
 async function artifactDownload(ref, opts) {
   const uuid = parseArtifactRef(ref);
   if (!uuid) {
@@ -54005,9 +54144,13 @@ import { promises as fs13 } from "node:fs";
 import { basename as basename12, extname as extname5, resolve as resolve16 } from "node:path";
 
 // src/domains/artifact/folder-walk.ts
+var import_ignore3 = __toESM(require_ignore(), 1);
 import { promises as fs12 } from "node:fs";
 import { join as join72, relative as relative14 } from "node:path";
 var MAX_FILE_BYTES = 20 * 1024 * 1024;
+var IGNORE_FILES = [".gitignore", ".tkmignore"];
+var HARD_IGNORES = [".git", ".gitignore", ".tkmignore"];
+var HARD_IGNORE_NAMES = new Set(HARD_IGNORES);
 
 class FolderLimitError extends Error {
   constructor(message) {
@@ -54015,9 +54158,23 @@ class FolderLimitError extends Error {
     this.name = "FolderLimitError";
   }
 }
-async function walkFolder(rootDir) {
+async function buildIgnoreMatcher(rootDir) {
+  const ig = import_ignore3.default();
+  for (const file of IGNORE_FILES) {
+    try {
+      ig.add(await fs12.readFile(join72(rootDir, file), "utf8"));
+    } catch {}
+  }
+  ig.add(HARD_IGNORES);
+  return ig;
+}
+async function walkFolder(rootDir, skipped) {
+  const ig = await buildIgnoreMatcher(rootDir);
   const entries = [];
-  await walk(rootDir, rootDir, entries);
+  const collectedSkips = [];
+  await walk(rootDir, rootDir, ig, entries, collectedSkips);
+  if (skipped)
+    skipped.push(...collectedSkips);
   entries.sort((a3, b3) => a3.relPath.localeCompare(b3.relPath));
   const oversized = entries.find((e2) => e2.size > MAX_FILE_BYTES);
   if (oversized) {
@@ -54026,7 +54183,7 @@ async function walkFolder(rootDir) {
   }
   return entries;
 }
-async function walk(rootDir, dir, out) {
+async function walk(rootDir, dir, ig, out, skipped) {
   let dirents;
   try {
     dirents = await fs12.readdir(dir, { withFileTypes: true });
@@ -54038,11 +54195,21 @@ async function walk(rootDir, dir, out) {
       continue;
     const name = String(dirent.name);
     const absPath = join72(dir, name);
+    const relPath = relative14(rootDir, absPath).split("\\").join("/");
     if (dirent.isDirectory()) {
-      await walk(rootDir, absPath, out);
+      if (ig.ignores(`${relPath}/`)) {
+        if (!HARD_IGNORE_NAMES.has(name))
+          skipped.push(`${relPath}/`);
+        continue;
+      }
+      await walk(rootDir, absPath, ig, out, skipped);
     } else if (dirent.isFile()) {
+      if (ig.ignores(relPath)) {
+        if (!HARD_IGNORE_NAMES.has(name))
+          skipped.push(relPath);
+        continue;
+      }
       const stat8 = await fs12.stat(absPath);
-      const relPath = relative14(rootDir, absPath).split("\\").join("/");
       out.push({ absPath, relPath, size: stat8.size });
     }
   }
@@ -54186,8 +54353,9 @@ async function uploadFolder(absPath, displayPath, token, opts) {
   const spinner = de();
   spinner.start(`Scanning ${displayPath}…`);
   let entries;
+  const skippedPaths = [];
   try {
-    entries = await walkFolder(absPath);
+    entries = await walkFolder(absPath, skippedPaths);
   } catch (err) {
     spinner.stop("Scan failed.", 1);
     if (err instanceof FolderLimitError) {
@@ -54204,6 +54372,11 @@ async function uploadFolder(absPath, displayPath, token, opts) {
     process.exitCode = 1;
     return;
   }
+  if (skippedPaths.length > 0) {
+    const preview = skippedPaths.slice(0, 5).join(", ");
+    const more = skippedPaths.length > 5 ? `, +${skippedPaths.length - 5} more` : "";
+    console.warn(`Skipped ${skippedPaths.length} path(s) matched by .gitignore/.tkmignore: ${preview}${more}`);
+  }
   let files;
   let folderHash;
   try {
@@ -54306,16 +54479,16 @@ async function artifactCommand(action, target, opts) {
       break;
     case "download":
       if (!target)
-        return usageError("tkm artifact download <uuid|url> [-o <dir>] [-v <n>] [--force]");
+        return usageError("tkm artifact download <uuid|url> [-o <dir>] [--ver <n>] [--force]");
       await artifactDownload(target, opts);
       break;
     case "delete":
       if (!target)
-        return usageError("tkm artifact delete <uuid|url>");
+        return usageError("tkm artifact delete <uuid|url> [--ver <n>]");
       await artifactDelete(target, opts);
       break;
     case undefined:
-      usageError("tkm artifact <upload <file> | download <uuid|url> | delete <uuid|url>>");
+      usageError("tkm artifact <upload <file> | download <uuid|url> | delete <uuid|url> [--ver <n>]>");
       break;
     default:
       console.error(`Unknown artifact action: ${action}. Available: upload, download, delete`);
@@ -60842,7 +61015,7 @@ function detectBroadGlob(pattern, pathHint) {
 }
 
 // src/domains/hooks/handlers/guard-breadth-scout/check-ignore.ts
-var import_ignore3 = __toESM(require_ignore(), 1);
+var import_ignore4 = __toESM(require_ignore(), 1);
 import { existsSync as existsSync44, readFileSync as readFileSync13 } from "node:fs";
 import { dirname as dirname24, join as join93 } from "node:path";
 var BUILTIN_HEAVY_DIR_LINES = [
@@ -60903,7 +61076,7 @@ function cleanLines(lines) {
 }
 function buildIgnoreConfig(lines, sourceLabel) {
   const cleaned = cleanLines(lines);
-  const ig = import_ignore3.default().add(cleaned);
+  const ig = import_ignore4.default().add(cleaned);
   const patterns = cleaned.filter((line) => !line.startsWith("!"));
   return { ig, patterns, sourceLabel };
 }
@@ -60943,7 +61116,7 @@ function findMatchingIgnoreRule(candidatePath, config) {
   let matched = null;
   for (const pattern of config.patterns) {
     try {
-      if (import_ignore3.default().add(pattern).ignores(rel))
+      if (import_ignore4.default().add(pattern).ignores(rel))
         matched = pattern;
     } catch {}
   }
@@ -68150,7 +68323,7 @@ function registerTempDir(dir) {
 
 // src/domains/installation/download-manager.ts
 init_types2();
-var import_ignore4 = __toESM(require_ignore(), 1);
+var import_ignore5 = __toESM(require_ignore(), 1);
 
 // src/domains/installation/download/file-downloader.ts
 init_logger();
@@ -72045,11 +72218,11 @@ class DownloadManager {
   ig;
   userExcludePatterns = [];
   constructor() {
-    this.ig = import_ignore4.default().add(EXCLUDE_PATTERNS);
+    this.ig = import_ignore5.default().add(EXCLUDE_PATTERNS);
   }
   setExcludePatterns(patterns) {
     this.userExcludePatterns = patterns;
-    this.ig = import_ignore4.default().add([...EXCLUDE_PATTERNS, ...this.userExcludePatterns]);
+    this.ig = import_ignore5.default().add([...EXCLUDE_PATTERNS, ...this.userExcludePatterns]);
     if (patterns.length > 0) {
       logger.info(`Added ${patterns.length} custom exclude pattern(s)`);
       patterns.forEach((p2) => logger.debug(`  - ${p2}`));
@@ -77653,8 +77826,13 @@ 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, path12, options2) => {
     await apiCommand(action, service, path12, 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("-v, --version <n>", "(download) Download a specific version number").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.version !== undefined ? Number.parseInt(opts.version, 10) : undefined;
+  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;
+      return;
+    }
     await artifactCommand(action, target, { ...opts, version: version3 });
   });
   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 = {}) => {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sunasteriskrnd/takumi",
-	"version": "0.11.0",
+	"version": "0.12.1",
 	"description": "CLI tool for bootstrapping and managing Takumi projects",
 	"type": "module",
 	"repository": {