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

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.58",
     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.58"?.trim() || process.env.npm_package_version?.trim() || "unknown";
 }
 function getCliUserAgent() {
   return `${TAKUMI_CLI_NPM_PACKAGE_NAME}/${getCliVersion()}`;
@@ -51481,75 +51482,102 @@ 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;
+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 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 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: "Actions",
+        title: "Options",
         options: [
           {
-            flags: "upload <file|dir>",
-            description: "Upload a file or directory as a new artifact (or new version with --id)"
+            flags: "--id <uuid|url>",
+            description: "Existing artifact (UUID or viewer URL) to overwrite with a new version"
           },
           {
-            flags: "download <uuid|url>",
-            description: "Download an artifact's files (latest or --ver <n>)"
+            flags: "--title <title>",
+            description: "Display title for the artifact (max 200 chars)"
           },
           {
-            flags: "delete <uuid|url>",
-            description: "Soft-delete the whole artifact, or one version with --ver <n>"
+            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 download <uuid|url> -o ./out --ver 3",
+        description: "Download a specific version's files into a directory"
+      }
+    ],
+    optionGroups: [
       {
         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"
+            description: "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"
+            description: "Version to download. ?v=<n> in a pasted URL works too; --ver wins when both given"
           },
           {
             flags: "--force",
-            description: "(download) Allow writing into a non-empty directory"
+            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: "--ver <n>",
+            description: "Version to delete. ?v=<n> in a pasted URL works too; --ver wins when both given"
           },
           {
             flags: "-y, --yes",
-            description: "(delete) Skip the confirmation prompt"
+            description: "Skip the confirmation prompt"
           }
         ]
       }
@@ -51557,6 +51585,57 @@ var init_artifact_command_help = __esm(() => {
   };
 });
 
+// src/domains/help/commands/artifact-command-help.ts
+var artifactCommandHelp;
+var init_artifact_command_help = __esm(() => {
+  init_artifact_action_help();
+  artifactCommandHelp = {
+    name: "artifact",
+    description: "Upload, download, and delete Takumi artifacts (upload|download|delete)",
+    usage: "tkm artifact <upload|download|delete> [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"
+      }
+    ],
+    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>"
+          }
+        ]
+      }
+    ],
+    sections: [
+      {
+        title: "Learn More",
+        content: "Run 'tkm artifact <action> --help' for action-specific options and examples."
+      }
+    ],
+    subcommands: {
+      upload: artifactUploadHelp,
+      download: artifactDownloadHelp,
+      delete: artifactDeleteHelp
+    }
+  };
+});
+
 // src/domains/help/commands/mcp-command-help.ts
 var mcpCommandHelp;
 var init_mcp_command_help = __esm(() => {
@@ -51634,6 +51713,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 +52018,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 +52036,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
       });

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sunasteriskrnd/takumi",
-	"version": "1.0.0-dev.57",
+	"version": "1.0.0-dev.58",
 	"description": "CLI tool for bootstrapping and managing Takumi projects",
 	"type": "module",
 	"repository": {
@@ -21,6 +21,7 @@
 	"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",