@mrmtsu/mcms-cli 0.1.0 → 0.2.1

package/dist/core/spec.js

@@ -0,0 +1,197 @@
+import { createRequire } from "node:module";
+import { EXIT_CODE } from "./exit-codes.js";
+const DEFAULT_VERSION = "0.1.0";
+export function getCliSpec() {
+    return {
+        name: "microcms",
+        version: resolveVersion(),
+        jsonContractVersion: "0.x",
+        globalOptions: GLOBAL_OPTIONS,
+        exitCodes: {
+            SUCCESS: EXIT_CODE.SUCCESS,
+            UNKNOWN: EXIT_CODE.UNKNOWN,
+            INVALID_INPUT: EXIT_CODE.INVALID_INPUT,
+            AUTH: EXIT_CODE.AUTH,
+            PERMISSION: EXIT_CODE.PERMISSION,
+            NETWORK: EXIT_CODE.NETWORK,
+            CONFLICT: EXIT_CODE.CONFLICT
+        },
+        commands: COMMANDS
+    };
+}
+function resolveVersion() {
+    try {
+        const require = createRequire(import.meta.url);
+        const pkg = require("../../package.json");
+        if (typeof pkg.version === "string" && pkg.version.length > 0) {
+            return pkg.version;
+        }
+    }
+    catch {
+        // fallback for non-standard runtime layouts
+    }
+    return DEFAULT_VERSION;
+}
+const GLOBAL_OPTIONS = [
+    { name: "--json", description: "machine-readable JSON output" },
+    { name: "--plain", description: "human output mode (line-oriented)" },
+    { name: "--table", description: "human output mode (table)" },
+    { name: "--select <fields>", description: "comma-separated field names for --table output" },
+    { name: "--profile <name>", description: "profile name to resolve service domain / keychain key" },
+    { name: "--service-domain <serviceDomain>", description: "microCMS service domain" },
+    { name: "--api-key <apiKey>", description: "microCMS API key (less secure)" },
+    { name: "--api-key-stdin", description: "read microCMS API key from stdin" },
+    { name: "--timeout <ms>", description: "request timeout in milliseconds (default: 10000)" },
+    { name: "--retry <count>", description: "retry count for retryable failures (default: 2)" },
+    { name: "--retry-max-delay <ms>", description: "max retry delay in milliseconds (default: 3000)" },
+    { name: "--verbose", description: "verbose error output" },
+    { name: "--no-color", description: "disable colorized output" }
+];
+const COMMANDS = [
+    {
+        path: "auth login",
+        description: "save API key in keychain (OAuth is not supported in MVP)",
+        args: [],
+        options: ["--profile <name>", "--service-domain <serviceDomain>", "--api-key <apiKey>", "--api-key-stdin", "--prompt"],
+        readOnly: false
+    },
+    {
+        path: "auth status",
+        description: "show auth resolution status",
+        args: [],
+        options: [],
+        readOnly: true
+    },
+    {
+        path: "auth profile list",
+        description: "list configured profiles",
+        args: [],
+        options: [],
+        readOnly: true
+    },
+    {
+        path: "auth profile add",
+        description: "add or update a profile",
+        args: ["<name>"],
+        options: ["--service-domain <serviceDomain>", "--set-default"],
+        readOnly: false
+    },
+    {
+        path: "auth profile use",
+        description: "set default profile",
+        args: ["<name>"],
+        options: [],
+        readOnly: false
+    },
+    {
+        path: "auth profile remove",
+        description: "remove profile from config",
+        args: ["<name>"],
+        options: [],
+        readOnly: false
+    },
+    { path: "api list", description: "list APIs", args: [], options: [], readOnly: true },
+    { path: "api info", description: "show API details", args: ["<endpoint>"], options: [], readOnly: true },
+    { path: "config doctor", description: "show resolved auth/config sources and common risks", args: [], options: [], readOnly: true },
+    {
+        path: "completion install",
+        description: "install completion script for your shell",
+        args: ["[shell]"],
+        options: [],
+        readOnly: false
+    },
+    { path: "completion uninstall", description: "remove installed completion scripts", args: [], options: [], readOnly: false },
+    { path: "completion endpoints", description: "print endpoint candidates for shell completion", args: [], options: [], readOnly: true },
+    {
+        path: "content list",
+        description: "list content",
+        args: ["<endpoint>"],
+        options: ["--limit <limit>", "--offset <offset>", "--orders <orders>", "--q <q>", "--filters <filters>", "--fields <fields>", "--ids <ids>", "--depth <depth>", "--draft-key <draftKey>", "--all"],
+        readOnly: true
+    },
+    {
+        path: "content get",
+        description: "get content by id",
+        args: ["<endpoint>", "<id>"],
+        options: ["--draft-key <draftKey>"],
+        readOnly: true
+    },
+    {
+        path: "content create",
+        description: "create content",
+        args: ["<endpoint>"],
+        options: ["--file <path>", "--dry-run"],
+        readOnly: false
+    },
+    {
+        path: "content update",
+        description: "update content",
+        args: ["<endpoint>", "<id>"],
+        options: ["--file <path>", "--dry-run"],
+        readOnly: false
+    },
+    {
+        path: "content delete",
+        description: "delete content",
+        args: ["<endpoint>", "<id>"],
+        options: ["--dry-run"],
+        readOnly: false
+    },
+    {
+        path: "media upload",
+        description: "upload media",
+        args: ["<path>"],
+        options: ["--dry-run"],
+        readOnly: false
+    },
+    {
+        path: "schema pull",
+        description: "fetch API schema metadata and save to file",
+        args: [],
+        options: ["--out <path>", "--endpoints <list>"],
+        readOnly: true
+    },
+    {
+        path: "types generate",
+        description: "generate declaration file from schema bundle",
+        args: [],
+        options: ["--schema <path>", "--out <path>"],
+        readOnly: true
+    },
+    {
+        path: "validate",
+        description: "run lightweight payload precheck before create/update",
+        args: ["<endpoint>"],
+        options: ["--file <path>", "--strict-warnings"],
+        readOnly: true
+    },
+    {
+        path: "docs list",
+        description: "list official documentation metadata",
+        args: [],
+        options: ["--source <source>", "--category <name>", "--limit <n>"],
+        readOnly: true
+    },
+    {
+        path: "docs get",
+        description: "get official documentation markdown",
+        args: [],
+        options: ["--category <name>", "--file <filename>", "--max-chars <n>", "--source <source>"],
+        readOnly: true
+    },
+    {
+        path: "search",
+        description: "search docs/spec for agent-friendly references",
+        args: ["<query>"],
+        options: ["--source <source>", "--scope <scope>", "--category <name>", "--limit <n>"],
+        readOnly: true
+    },
+    {
+        path: "spec",
+        description: "output machine-readable CLI spec",
+        args: [],
+        options: [],
+        readOnly: true
+    }
+];
+//# sourceMappingURL=spec.js.map

package/dist/core/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../src/core/spec.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrmtsu/mcms-cli",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "AI/CI friendly CLI for microCMS",
   "license": "MIT",
   "type": "module",
@@ -24,6 +24,7 @@
   },
   "dependencies": {
     "commander": "^13.1.0",
+    "microcms-document-mcp-server": "0.2.5",
     "microcms-js-sdk": "^3.1.1",
     "zod": "^3.24.1"
   },