@ultikits/cli 1.1.0 → 1.2.0

package/README.md

@@ -13,14 +13,13 @@ Requires Node.js 18 or later.
 ## Quick Start
 
 ```bash
-# 1. Log in to your UltiKits developer account
-ultikits login
-
-# 2. Initialize project config (optional, recommended)
-ultikits init
+# 1. Scaffold a new UltiTools module project
+ultikits create
 
-# 3. Build your plugin and publish
+# 2. Build and publish to UltiCloud
+cd MyModule
 mvn clean package
+ultikits login
 ultikits publish
 ```
 
@@ -58,6 +57,28 @@ Credentials are stored in `~/.ultikits/credentials.json`.
 
 ## Commands
 
+### `ultikits create`
+
+Scaffold a new UltiTools module project. Interactive prompts collect module name, package name, description, author, and API version, then generate a complete project with:
+
+- `pom.xml` — Maven build config with UltiTools-API dependency, test deps, JaCoCo
+- `src/main/java/.../ModuleName.java` — Main class with `@UltiToolsModule` annotation
+- `src/main/resources/plugin.yml` — Plugin descriptor
+- `src/main/resources/lang/en.yml` and `zh.yml` — i18n language files
+- `README.md` — Bilingual project readme
+- `.gitignore` — Standard Java/Maven ignores
+- `.git/` — Initialized git repository
+
+```bash
+# Create in current directory (prompts for module name)
+ultikits create
+
+# Create in a specific directory
+ultikits create my-plugin-dir
+```
+
+The generated project compiles immediately with `mvn compile`.
+
 ### `ultikits login`
 
 Authenticate with UltiKits. Choose between browser-based magic link or pasting an access token.

package/dist/bin/ultikits.js

@@ -12,7 +12,7 @@ const program = new Command();
 program
     .name('ultikits')
     .description('CLI for publishing UltiTools plugin modules to UltiCloud')
-    .version('1.1.0');
+    .version('1.2.0');
 registerLoginCommand(program);
 registerLogoutCommand(program);
 registerWhoamiCommand(program);

package/dist/src/commands/modules.js

@@ -1,7 +1,16 @@
+import fs from 'node:fs';
 import inquirer from 'inquirer';
 import { readCredentials } from '../lib/config.js';
 import { ApiClient } from '../lib/api-client.js';
 import * as log from '../lib/logger.js';
+const CATEGORY_NAMES = {
+    1: 'Utilities',
+    2: 'Economy',
+    3: 'World Management',
+    4: 'Social & Chat',
+    5: 'Permissions & Security',
+    6: 'Gameplay',
+};
 export function registerModulesCommand(program) {
     const modules = program
         .command('modules')
@@ -43,14 +52,98 @@ export function registerModulesCommand(program) {
             process.exit(1);
         }
         const mod = res.data;
+        const category = mod.categoryId ? (CATEGORY_NAMES[mod.categoryId] ?? `#${mod.categoryId}`) : 'N/A';
         console.log();
         console.log(`  Name:        ${mod.name}`);
         console.log(`  ID:          ${mod.identifyString}`);
-        console.log(`  Description: ${mod.shortDescription || 'N/A'}`);
+        console.log(`  Summary:     ${mod.shortDescription || 'N/A'}`);
+        console.log(`  Category:    ${category}`);
+        console.log(`  Compatible:  ${mod.compatibleVersions || 'N/A'}`);
+        console.log(`  Tags:        ${mod.tags?.length ? mod.tags.join(', ') : 'N/A'}`);
         console.log(`  Downloads:   ${mod.downloads ?? 0}`);
         console.log(`  Version:     ${mod.latestVersion?.version ?? 'N/A'}`);
+        if (mod.description) {
+            const preview = mod.description.length > 200
+                ? mod.description.slice(0, 200) + '...'
+                : mod.description;
+            console.log(`  Description: ${preview.split('\n')[0]}`);
+            const lines = preview.split('\n').slice(1);
+            for (const line of lines) {
+                console.log(`               ${line}`);
+            }
+        }
+        else {
+            console.log(`  Description: N/A`);
+        }
         console.log();
     });
+    modules
+        .command('update <identifyString>')
+        .description('Update module metadata')
+        .option('--name <name>', 'Display name')
+        .option('--short-description <text>', 'Short description (one-liner)')
+        .option('--description <text>', 'Full description (Markdown)')
+        .option('--description-file <path>', 'Read full description from a file')
+        .option('--category <id>', 'Category ID (1-6)')
+        .option('--compatible-versions <range>', 'Compatible MC versions (e.g. "1.8-1.21+")')
+        .option('--tags <csv>', 'Comma-separated tags (max 5)')
+        .option('-y, --yes', 'Skip confirmation')
+        .action(async (identifyString, options) => {
+        const client = getClient();
+        const spin = log.spinner('Loading module...');
+        spin.start();
+        const infoRes = await client.get(`/plugin/get?identifyString=${identifyString}`);
+        if (infoRes.code !== '200' || !infoRes.data) {
+            spin.fail('Module not found: ' + identifyString);
+            process.exit(1);
+        }
+        spin.succeed(`Found module: ${infoRes.data.name}`);
+        const mod = infoRes.data;
+        const hasFlags = options.name || options.shortDescription || options.description
+            || options.descriptionFile || options.category || options.compatibleVersions || options.tags;
+        let updates;
+        if (hasFlags) {
+            updates = buildUpdatesFromFlags(options);
+        }
+        else {
+            updates = await promptForUpdates(mod);
+        }
+        if (Object.keys(updates).length === 0) {
+            log.info('No changes to apply.');
+            return;
+        }
+        // Show summary
+        console.log();
+        for (const [key, value] of Object.entries(updates)) {
+            const display = key === 'description'
+                ? value.split('\n')[0].slice(0, 80) + (value.length > 80 ? '...' : '')
+                : key === 'tags'
+                    ? value.join(', ')
+                    : String(value);
+            console.log(`  ${key}: ${display}`);
+        }
+        console.log();
+        if (!options.yes) {
+            const { confirm } = await inquirer.prompt([
+                {
+                    type: 'confirm',
+                    name: 'confirm',
+                    message: `Update module "${identifyString}"?`,
+                    default: true,
+                },
+            ]);
+            if (!confirm)
+                return;
+        }
+        const updateSpin = log.spinner('Updating module...');
+        updateSpin.start();
+        const res = await client.put(`/developer/modules/${mod.id}`, updates);
+        if (res.code !== '200') {
+            updateSpin.fail('Failed to update: ' + res.msg);
+            process.exit(1);
+        }
+        updateSpin.succeed(`Updated module: ${identifyString}`);
+    });
     modules
         .command('delete <identifyString>')
         .description('Delete a module')
@@ -80,6 +173,132 @@ export function registerModulesCommand(program) {
         log.success(`Deleted module: ${identifyString}`);
     });
 }
+function buildUpdatesFromFlags(options) {
+    const updates = {};
+    if (options.name)
+        updates.name = options.name;
+    if (options.shortDescription)
+        updates.shortDescription = options.shortDescription;
+    if (options.descriptionFile) {
+        const filePath = options.descriptionFile;
+        if (!fs.existsSync(filePath)) {
+            log.error(`File not found: ${filePath}`);
+            process.exit(1);
+        }
+        updates.description = fs.readFileSync(filePath, 'utf-8');
+    }
+    else if (options.description) {
+        updates.description = options.description;
+    }
+    if (options.category) {
+        const id = parseInt(options.category);
+        if (isNaN(id) || id < 1 || id > 6) {
+            log.error('Category must be 1-6');
+            process.exit(1);
+        }
+        updates.categoryId = id;
+    }
+    if (options.compatibleVersions)
+        updates.compatibleVersions = options.compatibleVersions;
+    if (options.tags) {
+        const tags = options.tags.split(',').map((t) => t.trim()).filter(Boolean);
+        if (tags.length > 5) {
+            log.error('Maximum 5 tags allowed');
+            process.exit(1);
+        }
+        updates.tags = tags;
+    }
+    return updates;
+}
+async function promptForUpdates(mod) {
+    const updates = {};
+    const { name } = await inquirer.prompt([{
+            type: 'input',
+            name: 'name',
+            message: 'Display name:',
+            default: mod.name,
+        }]);
+    if (name !== mod.name)
+        updates.name = name;
+    const { shortDesc } = await inquirer.prompt([{
+            type: 'input',
+            name: 'shortDesc',
+            message: 'Short description:',
+            default: mod.shortDescription || '',
+        }]);
+    if (shortDesc !== (mod.shortDescription || ''))
+        updates.shortDescription = shortDesc;
+    const { descMode } = await inquirer.prompt([{
+            type: 'list',
+            name: 'descMode',
+            message: 'Full description:',
+            choices: [
+                { name: 'Keep current', value: 'keep' },
+                { name: 'Enter text', value: 'text' },
+                { name: 'Read from file', value: 'file' },
+            ],
+        }]);
+    if (descMode === 'text') {
+        const { desc } = await inquirer.prompt([{
+                type: 'editor',
+                name: 'desc',
+                message: 'Enter description (opens editor):',
+                default: mod.description || '',
+            }]);
+        if (desc.trim())
+            updates.description = desc.trim();
+    }
+    else if (descMode === 'file') {
+        const { filePath } = await inquirer.prompt([{
+                type: 'input',
+                name: 'filePath',
+                message: 'File path:',
+            }]);
+        if (filePath && fs.existsSync(filePath)) {
+            updates.description = fs.readFileSync(filePath, 'utf-8');
+        }
+        else if (filePath) {
+            log.warn('File not found, skipping description.');
+        }
+    }
+    const { category } = await inquirer.prompt([{
+            type: 'list',
+            name: 'category',
+            message: 'Category:',
+            choices: [
+                { name: `Keep current (${CATEGORY_NAMES[mod.categoryId] ?? 'N/A'})`, value: 0 },
+                ...Object.entries(CATEGORY_NAMES).map(([id, label]) => ({
+                    name: `${id}. ${label}`,
+                    value: parseInt(id),
+                })),
+            ],
+        }]);
+    if (category !== 0 && category !== mod.categoryId)
+        updates.categoryId = category;
+    const { compat } = await inquirer.prompt([{
+            type: 'input',
+            name: 'compat',
+            message: 'Compatible MC versions:',
+            default: mod.compatibleVersions || '',
+        }]);
+    if (compat !== (mod.compatibleVersions || ''))
+        updates.compatibleVersions = compat;
+    const currentTags = mod.tags?.join(', ') || '';
+    const { tags } = await inquirer.prompt([{
+            type: 'input',
+            name: 'tags',
+            message: 'Tags (comma-separated, max 5):',
+            default: currentTags,
+        }]);
+    const tagList = tags.split(',').map((t) => t.trim()).filter(Boolean);
+    if (tags !== currentTags && tagList.length <= 5) {
+        updates.tags = tagList;
+    }
+    else if (tagList.length > 5) {
+        log.warn('Too many tags (max 5), skipping.');
+    }
+    return updates;
+}
 function getClient() {
     const credentials = readCredentials();
     const client = ApiClient.fromEnvOrCredentials(credentials);

package/dist/src/lib/api-client.d.ts

@@ -8,5 +8,6 @@ export declare class ApiClient {
     get<T = any>(path: string): Promise<ApiResponse<T>>;
     post<T = any>(path: string, body?: any): Promise<ApiResponse<T>>;
     postMultipart<T = any>(path: string, formData: FormData, extraHeaders?: Record<string, string>): Promise<ApiResponse<T>>;
+    put<T = any>(path: string, body?: any): Promise<ApiResponse<T>>;
     delete<T = any>(path: string): Promise<ApiResponse<T>>;
 }

package/dist/src/lib/api-client.js

@@ -60,6 +60,18 @@ export class ApiClient {
         });
         return response.json();
     }
+    async put(path, body) {
+        const headers = {
+            ...this.getHeaders(),
+            'Content-Type': 'application/json',
+        };
+        const response = await fetch(`${this.baseUrl}${path}`, {
+            method: 'PUT',
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        return response.json();
+    }
     async delete(path) {
         const response = await fetch(`${this.baseUrl}${path}`, {
             method: 'DELETE',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultikits/cli",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "CLI tool for publishing UltiTools plugin modules to UltiCloud marketplace",
   "type": "module",
   "bin": {