@kweaver-ai/kweaver-sdk 0.8.1 → 0.8.3

package/dist/commands/skill.js

@@ -2,81 +2,267 @@ import { mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import { basename, dirname, resolve } from "node:path";
 import { ensureValidToken, formatHttpError, with401RefreshRetry } from "../auth/oauth.js";
 import { resolveBusinessDomain } from "../config/store.js";
-import { deleteSkill, downloadSkill, fetchSkillContent, fetchSkillFile, getSkill, getSkillContentIndex, installSkillArchive, listSkillMarket, listSkills, readSkillFile, registerSkillZip, updateSkillStatus, } from "../api/skills.js";
+import { deleteSkill, downloadSkill, downloadSkillManagementArchive, fetchSkillContent, fetchSkillFile, getSkill, getSkillMarketDetail, getSkillContentIndex, getSkillManagementContent, installSkillArchive, listSkillMarket, listSkillHistory, listSkills, publishSkillHistory, readSkillFile, readSkillManagementFile, republishSkillHistory, registerSkillZip, updateSkillMetadata, updateSkillPackageContent, updateSkillPackageZip, updateSkillStatus, } from "../api/skills.js";
 import { bundleSkillDirectoryToZip, bundleSkillFileToZip } from "../utils/skill-bundle.js";
+import { renderHelp } from "../help/format.js";
+const SKILL_HELP = renderHelp({
+    tagline: "Skill registry and market — register, market, content, lifecycle",
+    usage: "kweaver skill <subcommand> [flags]",
+    sections: [
+        {
+            title: "REGISTRY",
+            items: [
+                { name: "list", desc: "List skills (filter by --name / --status / --source / --create-user)" },
+                { name: "get", desc: "Get a skill by id" },
+                { name: "register", desc: "Register a skill (--content-file <SKILL.md|dir> | --zip-file <path>)" },
+                { name: "set-status", desc: "Change status: unpublish | published | offline" },
+                { name: "delete", desc: "Delete a skill" },
+            ],
+        },
+        {
+            title: "MARKET",
+            items: [
+                { name: "market", desc: "Browse the skill market" },
+                { name: "market-get", desc: "Get a market skill by id" },
+                { name: "download", desc: "Download a skill package archive" },
+                { name: "install", desc: "Install a skill locally" },
+            ],
+        },
+        {
+            title: "CONTENT",
+            items: [
+                { name: "content", desc: "Read SKILL.md content" },
+                { name: "read-file", desc: "Read a file inside a skill (progressive)" },
+                { name: "management-content", desc: "Read SKILL.md via management endpoint" },
+                { name: "management-read-file", desc: "Read file inside skill via management endpoint" },
+                { name: "management-download", desc: "Download via management endpoint" },
+            ],
+        },
+        {
+            title: "LIFECYCLE",
+            items: [
+                { name: "update-metadata", desc: "Update metadata (name / description / category / source)" },
+                { name: "update-package", desc: "Update package content or zip" },
+                { name: "history", desc: "Show version history" },
+                { name: "republish", desc: "Republish a specific historical version" },
+                { name: "publish-history", desc: "Publish a historical version" },
+            ],
+        },
+    ],
+    flags: [
+        { name: "-bd, --biz-domain <s>", desc: "Business domain (default: bd_public)" },
+        { name: "--pretty / --compact", desc: "JSON output style (default: pretty)" },
+    ],
+    inheritedFlags: "--base-url, --token, --user, --help",
+    examples: [
+        "kweaver skill list --name kweaver",
+        "kweaver skill register --zip-file ./demo-skill.zip --source upload_zip",
+        "kweaver skill install skill-123 ./skills/demo-skill --force",
+    ],
+    learnMore: ["Use `kweaver skill <subcommand> --help` for flag details"],
+});
 function printSkillHelp(subcommand) {
     if (subcommand === "list") {
-        console.log(`kweaver skill list [--name kw] [--source src] [--status status] [--create-user user]
-                   [--page N] [--page-size N|--limit N] [--all] [-bd value] [--pretty|--compact]`);
+        console.log(renderHelp({
+            tagline: "List installed skills.",
+            usage: "kweaver skill list [--name kw] [--source src] [--status status] [--create-user user] [--page N] [--page-size N|--limit N] [--all] [-bd value] [--pretty|--compact]",
+            flags: [
+                { name: "--name kw", desc: "Filter by name keyword." },
+                { name: "--source src", desc: "Filter by source." },
+                { name: "--status status", desc: "Filter by status." },
+                { name: "--create-user user", desc: "Filter by creator." },
+                { name: "--page N", desc: "Page number." },
+                { name: "--page-size N", desc: "Page size (alias: --limit)." },
+                { name: "--all", desc: "Fetch all pages." },
+                { name: "-bd value", desc: "Override base URL." },
+                { name: "--pretty|--compact", desc: "Toggle pretty JSON output." },
+            ],
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
         return;
     }
     if (subcommand === "market") {
-        console.log(`kweaver skill market [--name kw] [--source src] [--page N] [--page-size N|--limit N]
-                     [--all] [-bd value] [--pretty|--compact]`);
+        console.log(renderHelp({
+            tagline: "Browse the skill marketplace.",
+            usage: "kweaver skill market [--name kw] [--source src] [--page N] [--page-size N|--limit N] [--all] [-bd value] [--pretty|--compact]",
+            flags: [
+                { name: "--name kw", desc: "Filter by name keyword." },
+                { name: "--source src", desc: "Filter by source." },
+                { name: "--page N", desc: "Page number." },
+                { name: "--page-size N", desc: "Page size (alias: --limit)." },
+                { name: "--all", desc: "Fetch all pages." },
+                { name: "-bd value", desc: "Override base URL." },
+                { name: "--pretty|--compact", desc: "Toggle pretty JSON output." },
+            ],
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
         return;
     }
     if (subcommand === "get") {
-        console.log("kweaver skill get <skill-id> [-bd value] [--pretty|--compact]");
+        console.log(renderHelp({
+            tagline: "Show installed skill details.",
+            usage: "kweaver skill get <skill-id> [-bd value] [--pretty|--compact]",
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
+        return;
+    }
+    if (subcommand === "market-get") {
+        console.log(renderHelp({
+            tagline: "Show marketplace skill details.",
+            usage: "kweaver skill market-get <skill-id> [-bd value] [--pretty|--compact]",
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
         return;
     }
     if (subcommand === "register") {
-        console.log(`kweaver skill register (--content-file <path> | --zip-file <path>)
-                       [--source src] [--extend-info json] [-bd value] [--pretty|--compact]
-
-  --content-file accepts either:
-    - a single file named SKILL.md (auto-bundled into a 1-file zip)
-    - a skill directory containing SKILL.md (bundled into a zip)
-  Both paths upload as multipart zip; the backend's file_type=content
-  registration is unreliable (publish-then-read returns 404) so the CLI
-  always goes through zip.
-  --zip-file accepts a pre-built .zip with SKILL.md at the archive root.`);
+        console.log(renderHelp({
+            tagline: "Register a new skill (multipart zip upload).",
+            usage: "kweaver skill register (--content-file <path> | --zip-file <path>) [--source src] [--extend-info json] [-bd value] [--pretty|--compact]",
+            flags: [
+                { name: "--content-file <path>", desc: "SKILL.md file or skill directory containing SKILL.md (auto-bundled into a zip)." },
+                { name: "--zip-file <path>", desc: "Pre-built .zip with SKILL.md at the archive root." },
+                { name: "--source src", desc: "Source tag." },
+                { name: "--extend-info json", desc: "Extra metadata as JSON object." },
+                { name: "-bd value", desc: "Override base URL." },
+                { name: "--pretty|--compact", desc: "Toggle pretty JSON output." },
+            ],
+            inheritedFlags: "--base-url, --token, --user, --help",
+            learnMore: [
+                "Both --content-file and --zip-file upload as multipart zip; the backend's",
+                "file_type=content registration is unreliable (publish-then-read returns 404)",
+                "so the CLI always goes through zip.",
+            ],
+        }));
         return;
     }
     if (subcommand === "set-status" || subcommand === "status") {
-        console.log("kweaver skill set-status <skill-id> <unpublish|published|offline> [-bd value] [--pretty|--compact]");
+        console.log(renderHelp({
+            tagline: "Set skill publish status.",
+            usage: "kweaver skill set-status <skill-id> <unpublish|published|offline> [-bd value] [--pretty|--compact]",
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
         return;
     }
     if (subcommand === "delete") {
-        console.log("kweaver skill delete <skill-id> [-y|--yes] [-bd value] [--pretty|--compact]");
+        console.log(renderHelp({
+            tagline: "Delete a skill.",
+            usage: "kweaver skill delete <skill-id> [-y|--yes] [-bd value] [--pretty|--compact]",
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
+        return;
+    }
+    if (subcommand === "update-metadata") {
+        console.log(renderHelp({
+            tagline: "Update skill metadata fields.",
+            usage: "kweaver skill update-metadata <skill-id> --name <name> --description <text> --category <other_category|system> [--source <custom|internal>] [--extend-info json] [-bd value] [--pretty|--compact]",
+            flags: [
+                { name: "--name <name>", desc: "Skill name." },
+                { name: "--description <text>", desc: "Skill description." },
+                { name: "--category <other_category|system>", desc: "Skill category." },
+                { name: "--source <custom|internal>", desc: "Source tag." },
+                { name: "--extend-info json", desc: "Extra metadata as JSON object." },
+                { name: "-bd value", desc: "Override base URL." },
+                { name: "--pretty|--compact", desc: "Toggle pretty JSON output." },
+            ],
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
+        return;
+    }
+    if (subcommand === "update-package") {
+        console.log(renderHelp({
+            tagline: "Replace skill package contents.",
+            usage: "kweaver skill update-package <skill-id> (--content-file <path> | --zip-file <path>) [-bd value] [--pretty|--compact]",
+            flags: [
+                { name: "--content-file <path>", desc: "SKILL.md file or skill directory (auto-bundled into a zip)." },
+                { name: "--zip-file <path>", desc: "Pre-built .zip with SKILL.md at the archive root." },
+                { name: "-bd value", desc: "Override base URL." },
+                { name: "--pretty|--compact", desc: "Toggle pretty JSON output." },
+            ],
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
+        return;
+    }
+    if (subcommand === "history") {
+        console.log(renderHelp({
+            tagline: "Show skill edit history.",
+            usage: "kweaver skill history <skill-id> [-bd value] [--pretty|--compact]",
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
+        return;
+    }
+    if (subcommand === "republish") {
+        console.log(renderHelp({
+            tagline: "Republish a previous skill version.",
+            usage: "kweaver skill republish <skill-id> --version <version> [-bd value] [--pretty|--compact]",
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
+        return;
+    }
+    if (subcommand === "publish-history") {
+        console.log(renderHelp({
+            tagline: "Show publish history for a version.",
+            usage: "kweaver skill publish-history <skill-id> --version <version> [-bd value] [--pretty|--compact]",
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
         return;
     }
     if (subcommand === "content") {
-        console.log("kweaver skill content <skill-id> [--raw] [--output file] [-bd value] [--pretty|--compact]");
+        console.log(renderHelp({
+            tagline: "Fetch installed skill SKILL.md content.",
+            usage: "kweaver skill content <skill-id> [--raw] [--output file] [-bd value] [--pretty|--compact]",
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
         return;
     }
     if (subcommand === "read-file") {
-        console.log("kweaver skill read-file <skill-id> <rel-path> [--raw] [--output file] [-bd value] [--pretty|--compact]");
+        console.log(renderHelp({
+            tagline: "Read a file from an installed skill.",
+            usage: "kweaver skill read-file <skill-id> <rel-path> [--raw] [--output file] [-bd value] [--pretty|--compact]",
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
         return;
     }
     if (subcommand === "download") {
-        console.log("kweaver skill download <skill-id> [--output file] [-bd value] [--pretty|--compact]");
+        console.log(renderHelp({
+            tagline: "Download an installed skill package.",
+            usage: "kweaver skill download <skill-id> [--output file] [-bd value] [--pretty|--compact]",
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
         return;
     }
     if (subcommand === "install") {
-        console.log("kweaver skill install <skill-id> [directory] [--force] [-bd value] [--pretty|--compact]");
+        console.log(renderHelp({
+            tagline: "Install a skill locally.",
+            usage: "kweaver skill install <skill-id> [directory] [--force] [-bd value] [--pretty|--compact]",
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
+        return;
+    }
+    if (subcommand === "management-content") {
+        console.log(renderHelp({
+            tagline: "Fetch management-side skill SKILL.md content.",
+            usage: "kweaver skill management-content <skill-id> [--raw] [--response-mode url|content] [--output file] [-bd value] [--pretty|--compact]",
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
+        return;
+    }
+    if (subcommand === "management-read-file") {
+        console.log(renderHelp({
+            tagline: "Read a file via management API.",
+            usage: "kweaver skill management-read-file <skill-id> <rel-path> [--response-mode url|content] [--output file] [-bd value] [--pretty|--compact]",
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
         return;
     }
-    console.log(`kweaver skill
-
-Subcommands:
-  list [--name kw] [--status status] [--page N] [--page-size N] [-bd value]
-  market [--name kw] [--source src] [--page N] [--page-size N] [-bd value]
-  get <skill-id> [-bd value]
-  register --content-file <path> | --zip-file <path> [--source src] [--extend-info json]
-           (--content-file accepts a file named SKILL.md or a directory; both auto-zip)
-  set-status <skill-id> <unpublish|published|offline> [-bd value]
-  delete <skill-id> [-y] [-bd value]
-  content <skill-id> [--raw] [--output file] [-bd value]
-  read-file <skill-id> <rel-path> [--raw] [--output file] [-bd value]
-  download <skill-id> [--output file] [-bd value]
-  install <skill-id> [directory] [--force] [-bd value]
-
-Examples:
-  kweaver skill list --name kweaver
-  kweaver skill register --zip-file ./demo-skill.zip --source upload_zip
-  kweaver skill content skill-123 --raw
-  kweaver skill read-file skill-123 references/guide.md --output ./guide.md
-  kweaver skill install skill-123 ./skills/demo-skill --force`);
+    if (subcommand === "management-download") {
+        console.log(renderHelp({
+            tagline: "Download a skill via management API.",
+            usage: "kweaver skill management-download <skill-id> [--response-mode url|content] [--output file] [-bd value] [--pretty|--compact]",
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
+        return;
+    }
+    console.log(SKILL_HELP);
 }
 function format(value, pretty) {
     return JSON.stringify(value, null, pretty ? 2 : 0);
@@ -276,6 +462,108 @@ function parseSkillGetArgs(args) {
     }
     return { ...base.opts, skillId };
 }
+export function parseSkillUpdateMetadataArgs(args) {
+    const skillId = args[0];
+    if (!skillId || skillId.startsWith("-"))
+        throw new Error("Missing skill-id");
+    let name;
+    let description;
+    let category;
+    let source;
+    let extendInfo;
+    const base = parseBaseArgs(args, 1);
+    for (let i = 1; i < base.args.length; i += 1) {
+        const arg = base.args[i];
+        if (arg === "--help" || arg === "-h")
+            throw new Error("help");
+        if (arg === "--name") {
+            name = base.args[i + 1];
+            i += 1;
+            continue;
+        }
+        if (arg === "--description") {
+            description = base.args[i + 1];
+            i += 1;
+            continue;
+        }
+        if (arg === "--category") {
+            const value = base.args[i + 1];
+            if (value !== "other_category" && value !== "system") {
+                throw new Error("Invalid --category. Expected other_category|system");
+            }
+            category = value;
+            i += 1;
+            continue;
+        }
+        if (arg === "--source") {
+            source = base.args[i + 1];
+            i += 1;
+            continue;
+        }
+        if (arg === "--extend-info") {
+            extendInfo = parseJsonFlag(base.args[i + 1], "--extend-info");
+            i += 1;
+            continue;
+        }
+        throw new Error(`Unsupported skill update-metadata argument: ${arg}`);
+    }
+    if (!name)
+        throw new Error("Missing --name");
+    if (!description)
+        throw new Error("Missing --description");
+    if (!category)
+        throw new Error("Missing --category");
+    return { ...base.opts, skillId, name, description, category, source, extendInfo };
+}
+export function parseSkillUpdatePackageArgs(args) {
+    const skillId = args[0];
+    if (!skillId || skillId.startsWith("-"))
+        throw new Error("Missing skill-id");
+    let contentFile;
+    let zipFile;
+    const base = parseBaseArgs(args, 1);
+    for (let i = 1; i < base.args.length; i += 1) {
+        const arg = base.args[i];
+        if (arg === "--help" || arg === "-h")
+            throw new Error("help");
+        if (arg === "--content-file") {
+            contentFile = base.args[i + 1];
+            i += 1;
+            continue;
+        }
+        if (arg === "--zip-file") {
+            zipFile = base.args[i + 1];
+            i += 1;
+            continue;
+        }
+        throw new Error(`Unsupported skill update-package argument: ${arg}`);
+    }
+    if ((contentFile ? 1 : 0) + (zipFile ? 1 : 0) !== 1) {
+        throw new Error("Use exactly one of --content-file or --zip-file");
+    }
+    return { ...base.opts, skillId, contentFile, zipFile };
+}
+export function parseSkillHistoryVersionArgs(args, commandName) {
+    const skillId = args[0];
+    if (!skillId || skillId.startsWith("-"))
+        throw new Error("Missing skill-id");
+    let version;
+    const base = parseBaseArgs(args, 1);
+    for (let i = 1; i < base.args.length; i += 1) {
+        const arg = base.args[i];
+        if (arg === "--help" || arg === "-h")
+            throw new Error("help");
+        if (arg === "--version") {
+            version = base.args[i + 1];
+            i += 1;
+            continue;
+        }
+        throw new Error(`Unsupported skill ${commandName} argument: ${arg}`);
+    }
+    if (!version)
+        throw new Error("Missing --version");
+    return { ...base.opts, skillId, version };
+}
 function parseSkillReadFileArgs(args) {
     const skillId = args[0];
     const relPath = args[1];
@@ -325,6 +613,101 @@ function parseSkillInstallArgs(args) {
     }
     return { ...base.opts, skillId, directory, force };
 }
+function parseManagementContentArgs(args) {
+    const skillId = args[0];
+    if (!skillId || skillId.startsWith("-"))
+        throw new Error("Missing skill-id");
+    let responseMode;
+    let fetchRaw = false;
+    let output;
+    const base = parseBaseArgs(args, 1);
+    for (let i = 1; i < base.args.length; i += 1) {
+        const arg = base.args[i];
+        if (arg === "--help" || arg === "-h")
+            throw new Error("help");
+        if (arg === "--raw") {
+            fetchRaw = true;
+            continue;
+        }
+        if (arg === "--response-mode") {
+            const value = base.args[i + 1];
+            if (value !== "url" && value !== "content") {
+                throw new Error("Invalid --response-mode. Expected url|content");
+            }
+            responseMode = value;
+            i += 1;
+            continue;
+        }
+        if (arg === "--output" || arg === "-o") {
+            output = base.args[i + 1];
+            i += 1;
+            continue;
+        }
+        throw new Error(`Unsupported skill management-content argument: ${arg}`);
+    }
+    return { ...base.opts, skillId, responseMode, fetchRaw, output };
+}
+function parseManagementReadFileArgs(args) {
+    const skillId = args[0];
+    const relPath = args[1];
+    if (!skillId || skillId.startsWith("-"))
+        throw new Error("Missing skill-id");
+    if (!relPath || relPath.startsWith("-"))
+        throw new Error("Missing rel-path");
+    let responseMode;
+    let output;
+    const base = parseBaseArgs(args, 2);
+    for (let i = 2; i < base.args.length; i += 1) {
+        const arg = base.args[i];
+        if (arg === "--help" || arg === "-h")
+            throw new Error("help");
+        if (arg === "--response-mode") {
+            const value = base.args[i + 1];
+            if (value !== "url" && value !== "content") {
+                throw new Error("Invalid --response-mode. Expected url|content");
+            }
+            responseMode = value;
+            i += 1;
+            continue;
+        }
+        if (arg === "--output" || arg === "-o") {
+            output = base.args[i + 1];
+            i += 1;
+            continue;
+        }
+        throw new Error(`Unsupported skill management-read-file argument: ${arg}`);
+    }
+    return { ...base.opts, skillId, relPath, responseMode, output };
+}
+function parseManagementDownloadArgs(args) {
+    const skillId = args[0];
+    if (!skillId || skillId.startsWith("-"))
+        throw new Error("Missing skill-id");
+    let responseMode;
+    let output;
+    const base = parseBaseArgs(args, 1);
+    for (let i = 1; i < base.args.length; i += 1) {
+        const arg = base.args[i];
+        if (arg === "--help" || arg === "-h")
+            throw new Error("help");
+        if (arg === "--response-mode") {
+            const value = base.args[i + 1];
+            if (value !== "url" && value !== "content") {
+                throw new Error("Invalid --response-mode. Expected url|content");
+            }
+            responseMode = value;
+            i += 1;
+            continue;
+        }
+        if (arg === "--output" || arg === "-o") {
+            output = base.args[i + 1];
+            i += 1;
+            continue;
+        }
+        throw new Error(`Unsupported skill management-download argument: ${arg}`);
+    }
+    return { ...base.opts, skillId, responseMode, output };
+}
 function parseStatusArgs(args) {
     const skillId = args[0];
     const status = args[1];
@@ -401,6 +784,16 @@ export async function runSkillCommand(args) {
                 console.log(format(result, opts.pretty));
                 return 0;
             }
+            if (subcommand === "market-get") {
+                const opts = parseSkillGetArgs(rest);
+                const result = await getSkillMarketDetail({
+                    ...token,
+                    businessDomain: opts.businessDomain,
+                    skillId: opts.skillId,
+                });
+                console.log(format(result, opts.pretty));
+                return 0;
+            }
             if (subcommand === "register") {
                 const opts = parseSkillRegisterArgs(rest);
                 if (opts.contentFile) {
@@ -463,6 +856,79 @@ export async function runSkillCommand(args) {
                 console.log(format(result, opts.pretty));
                 return 0;
             }
+            if (subcommand === "update-metadata") {
+                const opts = parseSkillUpdateMetadataArgs(rest);
+                const result = await updateSkillMetadata({
+                    ...token,
+                    businessDomain: opts.businessDomain,
+                    skillId: opts.skillId,
+                    name: opts.name,
+                    description: opts.description,
+                    category: opts.category,
+                    source: opts.source,
+                    extendInfo: opts.extendInfo,
+                });
+                console.log(format(result, opts.pretty));
+                return 0;
+            }
+            if (subcommand === "update-package") {
+                const opts = parseSkillUpdatePackageArgs(rest);
+                if (opts.contentFile) {
+                    const content = readFileSync(resolve(opts.contentFile), "utf8");
+                    const result = await updateSkillPackageContent({
+                        ...token,
+                        businessDomain: opts.businessDomain,
+                        skillId: opts.skillId,
+                        content,
+                    });
+                    console.log(format(result, opts.pretty));
+                    return 0;
+                }
+                if (opts.zipFile) {
+                    const bytes = new Uint8Array(readFileSync(resolve(opts.zipFile)));
+                    const result = await updateSkillPackageZip({
+                        ...token,
+                        businessDomain: opts.businessDomain,
+                        skillId: opts.skillId,
+                        filename: basename(resolve(opts.zipFile)),
+                        bytes,
+                    });
+                    console.log(format(result, opts.pretty));
+                    return 0;
+                }
+            }
+            if (subcommand === "history") {
+                const opts = parseSkillGetArgs(rest);
+                const result = await listSkillHistory({
+                    ...token,
+                    businessDomain: opts.businessDomain,
+                    skillId: opts.skillId,
+                });
+                console.log(format(result, opts.pretty));
+                return 0;
+            }
+            if (subcommand === "republish") {
+                const opts = parseSkillHistoryVersionArgs(rest, "republish");
+                const result = await republishSkillHistory({
+                    ...token,
+                    businessDomain: opts.businessDomain,
+                    skillId: opts.skillId,
+                    version: opts.version,
+                });
+                console.log(format(result, opts.pretty));
+                return 0;
+            }
+            if (subcommand === "publish-history") {
+                const opts = parseSkillHistoryVersionArgs(rest, "publish-history");
+                const result = await publishSkillHistory({
+                    ...token,
+                    businessDomain: opts.businessDomain,
+                    skillId: opts.skillId,
+                    version: opts.version,
+                });
+                console.log(format(result, opts.pretty));
+                return 0;
+            }
             if (subcommand === "content") {
                 const opts = parseSkillContentArgs(rest);
                 if (opts.fetchRaw || opts.output) {
@@ -533,6 +999,64 @@ export async function runSkillCommand(args) {
                 console.log(`Installed ${opts.skillId} to ${result.directory}`);
                 return 0;
             }
+            if (subcommand === "management-content") {
+                const opts = parseManagementContentArgs(rest);
+                if (opts.fetchRaw || opts.responseMode === "content" || opts.output) {
+                    const result = await getSkillManagementContent({
+                        ...token,
+                        businessDomain: opts.businessDomain,
+                        skillId: opts.skillId,
+                        responseMode: opts.responseMode,
+                    });
+                    if (opts.output && result.content) {
+                        ensureDirectoryForFile(resolve(opts.output));
+                        writeFileSync(resolve(opts.output), result.content, "utf8");
+                        console.log(`Saved ${opts.skillId} management content to ${resolve(opts.output)}`);
+                    }
+                    else if (opts.fetchRaw && result.content) {
+                        process.stdout.write(result.content);
+                        if (!result.content.endsWith("\n"))
+                            process.stdout.write("\n");
+                    }
+                    else {
+                        console.log(format(result, opts.pretty));
+                    }
+                    return 0;
+                }
+                const result = await getSkillManagementContent({
+                    ...token,
+                    businessDomain: opts.businessDomain,
+                    skillId: opts.skillId,
+                    responseMode: opts.responseMode,
+                });
+                console.log(format(result, opts.pretty));
+                return 0;
+            }
+            if (subcommand === "management-read-file") {
+                const opts = parseManagementReadFileArgs(rest);
+                const result = await readSkillManagementFile({
+                    ...token,
+                    businessDomain: opts.businessDomain,
+                    skillId: opts.skillId,
+                    relPath: opts.relPath,
+                });
+                console.log(format(result, opts.pretty));
+                return 0;
+            }
+            if (subcommand === "management-download") {
+                const opts = parseManagementDownloadArgs(rest);
+                const result = await downloadSkillManagementArchive({
+                    ...token,
+                    businessDomain: opts.businessDomain,
+                    skillId: opts.skillId,
+                    responseMode: opts.responseMode,
+                });
+                const output = resolve(opts.output ?? result.fileName);
+                ensureDirectoryForFile(output);
+                writeFileSync(output, result.bytes);
+                console.log(`Saved ${opts.skillId} management archive to ${output}`);
+                return 0;
+            }
             console.error(`Unknown skill subcommand: ${subcommand}`);
             return 1;
         });