vona-cli-set-api 1.1.179 → 1.1.181

package/cli/templates/tools/crudBasic/boilerplate/src/controller/{{resourceName}}.ts_

@@ -3,7 +3,7 @@ import type { IQueryParams, TypeAnalysisGroupParams, TypeAnalysisAggregateParams
 import type { IDecoratorControllerOptions } from 'vona-module-a-web';
 
 import { BeanBase } from 'vona';
-import { Api, Resource, v } from 'vona-module-a-openapiutils';
+import { Api, Mcp, Resource, v } from 'vona-module-a-openapiutils';
 import { z } from 'zod';
 import { Passport } from 'vona-module-a-user';
 import { Arg, Controller, Web } from 'vona-module-a-web';
@@ -28,6 +28,10 @@ export interface IControllerOptions<%=argv.resourceNameCapitalize%> extends IDec
 })
 @Resource()
 export class Controller<%=argv.resourceNameCapitalize%> extends BeanBase {
+  @Mcp.tool({
+    description: $locale('<%=argv.resourceNameCapitalize%>CreateDescription'),
+    readOnly: false,
+  })
   @Web.post('', { summary: $locale('<%=argv.resourceNameCapitalize%>Create') })
   @Api.body(v.tableIdentity())
   @Passport.rbac()
@@ -35,6 +39,10 @@ export class Controller<%=argv.resourceNameCapitalize%> extends BeanBase {
     return (await this.scope.service.<%=argv.resourceName%>.create(<%=argv.resourceName%>)).id;
   }
 
+  @Mcp.tool({
+    description: $locale('<%=argv.resourceNameCapitalize%>SelectDescription'),
+    readOnly: true,
+  })
   @Web.get('', { summary: $locale('<%=argv.resourceNameCapitalize%>Select') })
   @Api.body(Dto<%=argv.resourceNameCapitalize%>SelectRes)
   @Passport.rbac()
@@ -42,6 +50,10 @@ export class Controller<%=argv.resourceNameCapitalize%> extends BeanBase {
     return await this.scope.service.<%=argv.resourceName%>.select(params);
   }
 
+  @Mcp.tool({
+    description: $locale('<%=argv.resourceNameCapitalize%>GroupDescription'),
+    readOnly: true,
+  })
   @Web.get('group', { summary: $locale('<%=argv.resourceNameCapitalize%>Group') })
   @Api.body(v.array(v.object(Dto<%=argv.resourceNameCapitalize%>GroupResItem)))
   @Passport.rbac({ actionInherit: 'select' })
@@ -49,6 +61,10 @@ export class Controller<%=argv.resourceNameCapitalize%> extends BeanBase {
     return await this.scope.service.<%=argv.resourceName%>.group(params);
   }
 
+  @Mcp.tool({
+    description: $locale('<%=argv.resourceNameCapitalize%>AggregateDescription'),
+    readOnly: true,
+  })
   @Web.get('aggregate', { summary: $locale('<%=argv.resourceNameCapitalize%>Aggregate') })
   @Api.body(Dto<%=argv.resourceNameCapitalize%>AggregateRes)
   @Passport.rbac({ actionInherit: 'select' })
@@ -56,6 +72,10 @@ export class Controller<%=argv.resourceNameCapitalize%> extends BeanBase {
     return await this.scope.service.<%=argv.resourceName%>.aggregate(params);
   }
 
+  @Mcp.tool({
+    description: $locale('<%=argv.resourceNameCapitalize%>ViewDescription'),
+    readOnly: true,
+  })
   @Web.get(':id', { summary: $locale('<%=argv.resourceNameCapitalize%>View') })
   @Api.body(v.optional(), v.object(Dto<%=argv.resourceNameCapitalize%>View))
   @Passport.rbac()
@@ -63,6 +83,10 @@ export class Controller<%=argv.resourceNameCapitalize%> extends BeanBase {
     return await this.scope.service.<%=argv.resourceName%>.view(id);
   }
 
+  @Mcp.tool({
+    description: $locale('<%=argv.resourceNameCapitalize%>UpdateDescription'),
+    readOnly: false,
+  })
   @Web.patch(':id', { summary: $locale('<%=argv.resourceNameCapitalize%>Update') })
   @Api.body(z.null())
   @Passport.rbac()
@@ -70,6 +94,10 @@ export class Controller<%=argv.resourceNameCapitalize%> extends BeanBase {
     await this.scope.service.<%=argv.resourceName%>.update(id, <%=argv.resourceName%>);
   }
 
+  @Mcp.tool({
+    description: $locale('<%=argv.resourceNameCapitalize%>DeleteDescription'),
+    readOnly: false,
+  })
   @Web.delete(':id', { summary: $locale('<%=argv.resourceNameCapitalize%>Delete') })
   @Api.body(z.null())
   @Passport.rbac()
@@ -77,6 +105,10 @@ export class Controller<%=argv.resourceNameCapitalize%> extends BeanBase {
     await this.scope.service.<%=argv.resourceName%>.delete(id);
   }
 
+  @Mcp.tool({
+    description: $locale('<%=argv.resourceNameCapitalize%>DeleteBulkDescription'),
+    readOnly: false,
+  })
   @Web.post('bulk/delete', { summary: $locale('<%=argv.resourceNameCapitalize%>DeleteBulk') })
   @Api.body(z.null())
   @Passport.rbac({ actionInherit: 'delete' })

package/cli/templates/tools/crudBasic/snippets/3-en-us.ts

@@ -42,6 +42,14 @@ export default metadataCustomSnippet({
       [`${resource}DeleteBulk`]: `Bulk Delete ${resource}`,
       [`${resource}Group`]: `Group ${resource}`,
       [`${resource}Aggregate`]: `Aggregate ${resource}`,
+      [`${resource}CreateDescription`]: `Create ${resource}.`,
+      [`${resource}SelectDescription`]: `Query the ${resource} list.`,
+      [`${resource}GroupDescription`]: `Group ${resource} records.`,
+      [`${resource}AggregateDescription`]: `Aggregate ${resource} records.`,
+      [`${resource}ViewDescription`]: `View a ${resource} by ID.`,
+      [`${resource}UpdateDescription`]: `Update a ${resource} by ID.`,
+      [`${resource}DeleteDescription`]: `Delete a ${resource} by ID.`,
+      [`${resource}DeleteBulkDescription`]: `Delete multiple ${resource} records by ID.`,
     };
     return locale_transform({ ast, argv, resources });
   },

package/cli/templates/tools/crudBasic/snippets/4-zh-cn.ts

@@ -25,6 +25,14 @@ export default metadataCustomSnippet({
       [`${resource}DeleteBulk`]: `批量删除${resource}`,
       [`${resource}Group`]: `${resource}分组统计`,
       [`${resource}Aggregate`]: `${resource}汇总统计`,
+      [`${resource}CreateDescription`]: `创建${resource}。`,
+      [`${resource}SelectDescription`]: `查询${resource}列表。`,
+      [`${resource}GroupDescription`]: `对${resource}进行分组统计。`,
+      [`${resource}AggregateDescription`]: `对${resource}进行汇总统计。`,
+      [`${resource}ViewDescription`]: `按 ID 查看${resource}。`,
+      [`${resource}UpdateDescription`]: `按 ID 更新${resource}。`,
+      [`${resource}DeleteDescription`]: `按 ID 删除${resource}。`,
+      [`${resource}DeleteBulkDescription`]: `按 ID 批量删除${resource}。`,
     };
     return locale_transform({ ast, argv, resources });
   },

package/cli/templates/tools/crudBasic/utils.ts

@@ -10,6 +10,18 @@ export async function locale_transform({
   resources: any;
 }) {
   const values = evaluateSimple(ast.replace('export default', '').replace(';', ''));
+  const pendingDescriptions = new Set(
+    [...ast.matchAll(/^\s*\/\/ TODO\(mcp-description\): (\w+) -.*$/gm)].map(match => match[1]),
+  );
+  for (const key of Object.keys(resources)) {
+    if (
+      key.startsWith(argv.resourceNameCapitalize) &&
+      key.endsWith('Description') &&
+      !Object.hasOwn(values, key)
+    ) {
+      pendingDescriptions.add(key);
+    }
+  }
   resources = Object.assign(
     {},
     resources,
@@ -19,6 +31,9 @@ export async function locale_transform({
   const keys = Object.keys(resources).sort();
   let content = '';
   for (const key of keys) {
+    if (pendingDescriptions.has(key)) {
+      content += `  // TODO(mcp-description): ${key} - refine using the actual Action, DTO and Service behavior.\n`;
+    }
     content += `  ${key}: '${resources[key].replaceAll("'", "\\'")}',\n`;
   }
   ast = `export default {\n${content}};\n`;

package/cli/templates/tools/crudStart/boilerplate/src/controller/{{resourceName}}.ts_

@@ -4,7 +4,7 @@ import type { IRbacScopeAccess } from 'vona-module-a-rbac';
 import type { IDecoratorControllerOptions } from 'vona-module-a-web';
 
 import { BeanBase } from 'vona';
-import { Api, Resource, v } from 'vona-module-a-openapiutils';
+import { Api, Mcp, Resource, v } from 'vona-module-a-openapiutils';
 import { z } from 'zod';
 import { Passport } from 'vona-module-a-user';
 import { Arg, Controller, Web } from 'vona-module-a-web';
@@ -29,6 +29,10 @@ export interface IControllerOptions<%=argv.resourceNameCapitalize%> extends IDec
 })
 @Resource()
 export class Controller<%=argv.resourceNameCapitalize%> extends BeanBase {
+  @Mcp.tool({
+    description: $locale('<%=argv.resourceNameCapitalize%>CreateDescription'),
+    readOnly: false,
+  })
   @Web.post('', { summary: $locale('<%=argv.resourceNameCapitalize%>Create') })
   @Api.body(v.tableIdentity())
   @Passport.rbac()
@@ -36,6 +40,10 @@ export class Controller<%=argv.resourceNameCapitalize%> extends BeanBase {
     return (await this.scope.service.<%=argv.resourceName%>.create(<%=argv.resourceName%>)).id;
   }
 
+  @Mcp.tool({
+    description: $locale('<%=argv.resourceNameCapitalize%>SelectDescription'),
+    readOnly: true,
+  })
   @Web.get('', { summary: $locale('<%=argv.resourceNameCapitalize%>Select') })
   @Api.body(Dto<%=argv.resourceNameCapitalize%>SelectRes)
   @Passport.rbac()
@@ -43,6 +51,10 @@ export class Controller<%=argv.resourceNameCapitalize%> extends BeanBase {
     return await this.scope.service.<%=argv.resourceName%>.select(params);
   }
 
+  @Mcp.tool({
+    description: $locale('<%=argv.resourceNameCapitalize%>GroupDescription'),
+    readOnly: true,
+  })
   @Web.get('group', { summary: $locale('<%=argv.resourceNameCapitalize%>Group') })
   @Api.body(v.array(v.object(Dto<%=argv.resourceNameCapitalize%>GroupResItem)))
   @Passport.rbac({ actionInherit: 'select' })
@@ -50,6 +62,10 @@ export class Controller<%=argv.resourceNameCapitalize%> extends BeanBase {
     return await this.scope.service.<%=argv.resourceName%>.group(params);
   }
 
+  @Mcp.tool({
+    description: $locale('<%=argv.resourceNameCapitalize%>AggregateDescription'),
+    readOnly: true,
+  })
   @Web.get('aggregate', { summary: $locale('<%=argv.resourceNameCapitalize%>Aggregate') })
   @Api.body(Dto<%=argv.resourceNameCapitalize%>AggregateRes)
   @Passport.rbac({ actionInherit: 'select' })
@@ -57,6 +73,10 @@ export class Controller<%=argv.resourceNameCapitalize%> extends BeanBase {
     return await this.scope.service.<%=argv.resourceName%>.aggregate(params);
   }
 
+  @Mcp.tool({
+    description: $locale('<%=argv.resourceNameCapitalize%>ViewDescription'),
+    readOnly: true,
+  })
   @Web.get(':id', { summary: $locale('<%=argv.resourceNameCapitalize%>View') })
   @Api.body(v.optional(), v.object(Dto<%=argv.resourceNameCapitalize%>View))
   @Passport.rbac()
@@ -64,6 +84,10 @@ export class Controller<%=argv.resourceNameCapitalize%> extends BeanBase {
     return await this.scope.service.<%=argv.resourceName%>.view(id);
   }
 
+  @Mcp.tool({
+    description: $locale('<%=argv.resourceNameCapitalize%>UpdateDescription'),
+    readOnly: false,
+  })
   @Web.patch(':id', { summary: $locale('<%=argv.resourceNameCapitalize%>Update') })
   @Api.body(z.null())
   @Passport.rbac()
@@ -71,6 +95,10 @@ export class Controller<%=argv.resourceNameCapitalize%> extends BeanBase {
     await this.scope.service.<%=argv.resourceName%>.update(id, <%=argv.resourceName%>);
   }
 
+  @Mcp.tool({
+    description: $locale('<%=argv.resourceNameCapitalize%>DeleteDescription'),
+    readOnly: false,
+  })
   @Web.delete(':id', { summary: $locale('<%=argv.resourceNameCapitalize%>Delete') })
   @Api.body(z.null())
   @Passport.rbac()
@@ -78,6 +106,10 @@ export class Controller<%=argv.resourceNameCapitalize%> extends BeanBase {
     await this.scope.service.<%=argv.resourceName%>.delete(id);
   }
 
+  @Mcp.tool({
+    description: $locale('<%=argv.resourceNameCapitalize%>DeleteBulkDescription'),
+    readOnly: false,
+  })
   @Web.post('bulk/delete', { summary: $locale('BulkDelete') })
   @Api.body(z.null())
   @Passport.rbac({ actionInherit: 'delete' })

package/cli/templates/tools/crudStart/snippets/3-en-us.ts

@@ -42,6 +42,14 @@ export default metadataCustomSnippet({
       [`${resource}Delete`]: `Delete ${resource}`,
       [`${resource}Group`]: `Group ${resource}`,
       [`${resource}Aggregate`]: `Aggregate ${resource}`,
+      [`${resource}CreateDescription`]: `Create ${resource}.`,
+      [`${resource}SelectDescription`]: `Query the ${resource} list.`,
+      [`${resource}GroupDescription`]: `Group ${resource} records.`,
+      [`${resource}AggregateDescription`]: `Aggregate ${resource} records.`,
+      [`${resource}ViewDescription`]: `View a ${resource} by ID.`,
+      [`${resource}UpdateDescription`]: `Update a ${resource} by ID.`,
+      [`${resource}DeleteDescription`]: `Delete a ${resource} by ID.`,
+      [`${resource}DeleteBulkDescription`]: `Delete multiple ${resource} records by ID.`,
     };
     return locale_transform({ ast, argv, resources });
   },

package/cli/templates/tools/crudStart/snippets/4-zh-cn.ts

@@ -25,6 +25,14 @@ export default metadataCustomSnippet({
       [`${resource}Delete`]: `删除${resource}`,
       [`${resource}Group`]: `${resource}分组统计`,
       [`${resource}Aggregate`]: `${resource}汇总统计`,
+      [`${resource}CreateDescription`]: `创建${resource}。`,
+      [`${resource}SelectDescription`]: `查询${resource}列表。`,
+      [`${resource}GroupDescription`]: `对${resource}进行分组统计。`,
+      [`${resource}AggregateDescription`]: `对${resource}进行汇总统计。`,
+      [`${resource}ViewDescription`]: `按 ID 查看${resource}。`,
+      [`${resource}UpdateDescription`]: `按 ID 更新${resource}。`,
+      [`${resource}DeleteDescription`]: `按 ID 删除${resource}。`,
+      [`${resource}DeleteBulkDescription`]: `按 ID 批量删除${resource}。`,
     };
     return locale_transform({ ast, argv, resources });
   },

package/cli/templates/tools/crudStart/utils.ts

@@ -10,6 +10,18 @@ export async function locale_transform({
   resources: any;
 }) {
   const values = evaluateSimple(ast.replace('export default', '').replace(';', ''));
+  const pendingDescriptions = new Set(
+    [...ast.matchAll(/^\s*\/\/ TODO\(mcp-description\): (\w+) -.*$/gm)].map(match => match[1]),
+  );
+  for (const key of Object.keys(resources)) {
+    if (
+      key.startsWith(argv.resourceNameCapitalize) &&
+      key.endsWith('Description') &&
+      !Object.hasOwn(values, key)
+    ) {
+      pendingDescriptions.add(key);
+    }
+  }
   resources = Object.assign(
     {},
     resources,
@@ -19,6 +31,9 @@ export async function locale_transform({
   const keys = Object.keys(resources).sort();
   let content = '';
   for (const key of keys) {
+    if (pendingDescriptions.has(key)) {
+      content += `  // TODO(mcp-description): ${key} - refine using the actual Action, DTO and Service behavior.\n`;
+    }
     content += `  ${key}: '${resources[key].replaceAll("'", "\\'")}',\n`;
   }
   ast = `export default {\n${content}};\n`;

package/dist/index.js

@@ -23,7 +23,7 @@ import { resolveTestRunId, TEST_RUN_ID_ENV, getTestAppName, requiresFreshTestRes
 import chalk from 'chalk';
 import { spawn } from 'node:child_process';
 import nodemon from 'nodemon';
-import { catchError, combineApiPathControllerAndActionRaw, replaceTemplate } from '@cabloy/utils';
+import { catchError, combineApiPathControllerAndActionRaw, evaluateSimple, replaceTemplate } from '@cabloy/utils';
 import { getOnionScenesMeta, getOnionMetasMeta, relativeNameToCapitalize } from '@cabloy/module-info';
 import { toUpperCaseFirstChar, stringToCapitalize, replaceTemplate as replaceTemplate$1 } from '@cabloy/word-utils';
 import fs from 'node:fs';
@@ -2013,6 +2013,7 @@ class CliToolsCrudBasic extends BeanCliBase {
         cwd: argv.projectPath
       });
     }
+    await this.console.log('MCP Actions generated with minimal descriptions, including bulk delete. After implementing the business behavior, refine the descriptions in src/config/locale/*.ts using the actual Action, DTO and Service behavior. Resolve TODO(mcp-description) before completion; report any unresolved descriptions as unfinished.');
   }
 }
 
@@ -2054,6 +2055,7 @@ class CliToolsCrudStart extends BeanCliBase {
         cwd: argv.projectPath
       });
     }
+    await this.console.log('MCP Actions generated with minimal descriptions, including bulk delete. After implementing the business behavior, refine the descriptions in src/config/locale/*.ts using the actual Action, DTO and Service behavior. Resolve TODO(mcp-description) before completion; report any unresolved descriptions as unfinished.');
   }
 }
 
@@ -2237,6 +2239,7 @@ class CliToolsMasterDetail extends BeanCliBase {
     await this._renderMasterDetailDtos();
     await this._patchMasterModule();
     await this._refreshMetadata();
+    await this._reportMcpFollowUp();
   }
   _prepareArgv() {
     const {
@@ -2615,9 +2618,41 @@ class CliToolsMasterDetail extends BeanCliBase {
     const {
       argv
     } = this.context;
+    const existingLocaleKeys = new Map();
+    if (argv.detailMode === 'aggregate') {
+      for (const locale of this._masterLocales()) {
+        const fileName = path.join(this._detailPaths().localeDir, `${locale}.ts`);
+        const content = fs.existsSync(fileName) ? this._readFile(fileName) : 'export default {};';
+        const values = evaluateSimple(content.replace('export default', '').replace(';', ''));
+        existingLocaleKeys.set(locale, new Set(Object.keys(values)));
+      }
+    }
     await this.helper.invokeCli([argv.detailCrudCommand, argv.detailResourceName, `--module=${argv.detailModule}`, '--nometadata'], {
       cwd: argv.projectPath
     });
+    if (argv.detailMode === 'aggregate') {
+      await this._removeGeneratedDetailMcpDescriptions(existingLocaleKeys);
+    }
+  }
+  async _removeGeneratedDetailMcpDescriptions(existingLocaleKeys) {
+    const resource = this.context.argv.detailResourceNameCapitalize;
+    const keys = new Set(['Create', 'Select', 'Group', 'Aggregate', 'View', 'Update', 'Delete', 'DeleteBulk'].map(action => `${resource}${action}Description`));
+    for (const [locale, existingKeys] of existingLocaleKeys) {
+      const fileName = path.join(this._detailPaths().localeDir, `${locale}.ts`);
+      const content = this._readFile(fileName);
+      const updated = content.replace(/^[ \t]*\/\/ TODO\(mcp-description\): (\w+) - refine using the actual Action, DTO and Service behavior\.\r?\n[ \t]*(\w+):\s*'(?:\\.|[^'\\])*',\r?\n/gm, (entry, markerKey, key) => {
+        return markerKey === key && keys.has(key) && !existingKeys.has(key) ? '' : entry;
+      });
+      if (updated !== content) await this._saveFile(fileName, updated);
+    }
+  }
+  async _reportMcpFollowUp() {
+    const {
+      argv
+    } = this.context;
+    const detail = `${argv.detailModule}:${argv.detailResourceName}`;
+    const modeMessage = argv.detailMode === 'aggregate' ? `${detail} has no standalone MCP Actions; the earlier child CRUD description reminder does not apply to removed Actions.` : `Review retained standalone MCP Actions for ${detail}, including the ${argv.fk} ownership context and bulk delete.`;
+    await this.console.log(`Final MCP description follow-up (${argv.detailMode}): ${modeMessage} Review already MCP-enabled parent Actions for ${argv.module}:${argv.resourceName}, especially create/view/update/delete affected by ${argv.relationName}. After implementing business behavior, inspect the actual Action, DTO and Service and refine descriptions in every locale. Review ancestor Actions only where their actual DTO/Service path exposes the changed nested contract. Recheck readOnly; do not assume deleteBulk has the single-delete relation behavior. Preserve authored text and existing MCP opt-in decisions; resolve only completed TODO(mcp-description) entries and report unresolved descriptions as unfinished.`);
   }
   _handleAggregateDetailMode(hasStandaloneSurface) {
     const {
@@ -2665,6 +2700,7 @@ class CliToolsMasterDetail extends BeanCliBase {
     const detailRoot = argv._detailModule.root;
     return {
       root: detailRoot,
+      localeDir: path.join(detailRoot, 'src/config/locale'),
       entity: path.join(detailRoot, 'src/entity', `${argv.detailResourceName}.tsx`),
       model: path.join(detailRoot, 'src/model', `${argv.detailResourceName}.ts`),
       controller: path.join(detailRoot, 'src/controller', `${argv.detailResourceName}.ts`),

package/dist/lib/bean/cli.tools.masterDetail.d.ts

@@ -75,6 +75,8 @@ export declare class CliToolsMasterDetail extends BeanCliBase {
     private _detailDtoClassCapitalize;
     private _masterLocaleAdditions;
     private _createDetailCoreResource;
+    private _removeGeneratedDetailMcpDescriptions;
+    private _reportMcpFollowUp;
     private _handleAggregateDetailMode;
     private _handleStandaloneDetailMode;
     private _detailModuleShape;

package/dist-cli/templates/tools/crudBasic/snippets/3-en-us.js

@@ -32,6 +32,14 @@ export default metadataCustomSnippet({
             [`${resource}DeleteBulk`]: `Bulk Delete ${resource}`,
             [`${resource}Group`]: `Group ${resource}`,
             [`${resource}Aggregate`]: `Aggregate ${resource}`,
+            [`${resource}CreateDescription`]: `Create ${resource}.`,
+            [`${resource}SelectDescription`]: `Query the ${resource} list.`,
+            [`${resource}GroupDescription`]: `Group ${resource} records.`,
+            [`${resource}AggregateDescription`]: `Aggregate ${resource} records.`,
+            [`${resource}ViewDescription`]: `View a ${resource} by ID.`,
+            [`${resource}UpdateDescription`]: `Update a ${resource} by ID.`,
+            [`${resource}DeleteDescription`]: `Delete a ${resource} by ID.`,
+            [`${resource}DeleteBulkDescription`]: `Delete multiple ${resource} records by ID.`,
         };
         return locale_transform({ ast, argv, resources });
     },

package/dist-cli/templates/tools/crudBasic/snippets/4-zh-cn.js

@@ -22,6 +22,14 @@ export default metadataCustomSnippet({
             [`${resource}DeleteBulk`]: `批量删除${resource}`,
             [`${resource}Group`]: `${resource}分组统计`,
             [`${resource}Aggregate`]: `${resource}汇总统计`,
+            [`${resource}CreateDescription`]: `创建${resource}。`,
+            [`${resource}SelectDescription`]: `查询${resource}列表。`,
+            [`${resource}GroupDescription`]: `对${resource}进行分组统计。`,
+            [`${resource}AggregateDescription`]: `对${resource}进行汇总统计。`,
+            [`${resource}ViewDescription`]: `按 ID 查看${resource}。`,
+            [`${resource}UpdateDescription`]: `按 ID 更新${resource}。`,
+            [`${resource}DeleteDescription`]: `按 ID 删除${resource}。`,
+            [`${resource}DeleteBulkDescription`]: `按 ID 批量删除${resource}。`,
         };
         return locale_transform({ ast, argv, resources });
     },

package/dist-cli/templates/tools/crudBasic/utils.js

@@ -1,10 +1,21 @@
 import { evaluateSimple } from '@cabloy/utils';
 export async function locale_transform({ ast, argv, resources, }) {
     const values = evaluateSimple(ast.replace('export default', '').replace(';', ''));
+    const pendingDescriptions = new Set([...ast.matchAll(/^\s*\/\/ TODO\(mcp-description\): (\w+) -.*$/gm)].map(match => match[1]));
+    for (const key of Object.keys(resources)) {
+        if (key.startsWith(argv.resourceNameCapitalize) &&
+            key.endsWith('Description') &&
+            !Object.hasOwn(values, key)) {
+            pendingDescriptions.add(key);
+        }
+    }
     resources = Object.assign({}, resources, { [argv.resourceNameCapitalize]: argv.resourceNameCapitalize }, values);
     const keys = Object.keys(resources).sort();
     let content = '';
     for (const key of keys) {
+        if (pendingDescriptions.has(key)) {
+            content += `  // TODO(mcp-description): ${key} - refine using the actual Action, DTO and Service behavior.\n`;
+        }
         content += `  ${key}: '${resources[key].replaceAll("'", "\\'")}',\n`;
     }
     ast = `export default {\n${content}};\n`;

package/dist-cli/templates/tools/crudStart/snippets/3-en-us.js

@@ -32,6 +32,14 @@ export default metadataCustomSnippet({
             [`${resource}Delete`]: `Delete ${resource}`,
             [`${resource}Group`]: `Group ${resource}`,
             [`${resource}Aggregate`]: `Aggregate ${resource}`,
+            [`${resource}CreateDescription`]: `Create ${resource}.`,
+            [`${resource}SelectDescription`]: `Query the ${resource} list.`,
+            [`${resource}GroupDescription`]: `Group ${resource} records.`,
+            [`${resource}AggregateDescription`]: `Aggregate ${resource} records.`,
+            [`${resource}ViewDescription`]: `View a ${resource} by ID.`,
+            [`${resource}UpdateDescription`]: `Update a ${resource} by ID.`,
+            [`${resource}DeleteDescription`]: `Delete a ${resource} by ID.`,
+            [`${resource}DeleteBulkDescription`]: `Delete multiple ${resource} records by ID.`,
         };
         return locale_transform({ ast, argv, resources });
     },

package/dist-cli/templates/tools/crudStart/snippets/4-zh-cn.js

@@ -22,6 +22,14 @@ export default metadataCustomSnippet({
             [`${resource}Delete`]: `删除${resource}`,
             [`${resource}Group`]: `${resource}分组统计`,
             [`${resource}Aggregate`]: `${resource}汇总统计`,
+            [`${resource}CreateDescription`]: `创建${resource}。`,
+            [`${resource}SelectDescription`]: `查询${resource}列表。`,
+            [`${resource}GroupDescription`]: `对${resource}进行分组统计。`,
+            [`${resource}AggregateDescription`]: `对${resource}进行汇总统计。`,
+            [`${resource}ViewDescription`]: `按 ID 查看${resource}。`,
+            [`${resource}UpdateDescription`]: `按 ID 更新${resource}。`,
+            [`${resource}DeleteDescription`]: `按 ID 删除${resource}。`,
+            [`${resource}DeleteBulkDescription`]: `按 ID 批量删除${resource}。`,
         };
         return locale_transform({ ast, argv, resources });
     },

package/dist-cli/templates/tools/crudStart/utils.js

@@ -1,10 +1,21 @@
 import { evaluateSimple } from '@cabloy/utils';
 export async function locale_transform({ ast, argv, resources, }) {
     const values = evaluateSimple(ast.replace('export default', '').replace(';', ''));
+    const pendingDescriptions = new Set([...ast.matchAll(/^\s*\/\/ TODO\(mcp-description\): (\w+) -.*$/gm)].map(match => match[1]));
+    for (const key of Object.keys(resources)) {
+        if (key.startsWith(argv.resourceNameCapitalize) &&
+            key.endsWith('Description') &&
+            !Object.hasOwn(values, key)) {
+            pendingDescriptions.add(key);
+        }
+    }
     resources = Object.assign({}, resources, { [argv.resourceNameCapitalize]: argv.resourceNameCapitalize }, values);
     const keys = Object.keys(resources).sort();
     let content = '';
     for (const key of keys) {
+        if (pendingDescriptions.has(key)) {
+            content += `  // TODO(mcp-description): ${key} - refine using the actual Action, DTO and Service behavior.\n`;
+        }
         content += `  ${key}: '${resources[key].replaceAll("'", "\\'")}',\n`;
     }
     ast = `export default {\n${content}};\n`;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "vona-cli-set-api",
-  "version": "1.1.179",
-  "gitHead": "c94b659a5ab1819ad7714ddacb6875c4f8cbc022",
+  "version": "1.1.181",
+  "gitHead": "d1a9a68c5d48db9bc82945c17984dabbec724d8c",
   "description": "vona cli-set-api",
   "keywords": [
     "framework",
@@ -45,10 +45,10 @@
     "@babel/plugin-proposal-decorators": "^7.29.0",
     "@babel/plugin-transform-class-properties": "^7.28.6",
     "@babel/plugin-transform-typescript": "^7.28.6",
-    "@cabloy/cli": "^3.1.31",
+    "@cabloy/cli": "^3.1.32",
     "@cabloy/dotenv": "^1.2.9",
     "@cabloy/extend": "^3.2.8",
-    "@cabloy/module-glob": "^5.3.19",
+    "@cabloy/module-glob": "^5.3.20",
     "@cabloy/module-info": "^2.0.3",
     "@cabloy/utils": "^2.1.27",
     "@cabloy/word-utils": "^2.1.8",
@@ -63,7 +63,7 @@
     "@rollup/plugin-typescript": "^12.3.0",
     "@swc-node/register": "^1.12.1",
     "babel-plugin-transform-typescript-metadata": "^0.3.2",
-    "babel-plugin-vona-bean-module": "^1.1.11",
+    "babel-plugin-vona-bean-module": "^1.1.12",
     "chalk": "^3.0.0",
     "cli-table3": "^0.6.5",
     "compressing": "^1.10.4",
@@ -77,7 +77,7 @@
     "rollup": "^4.60.1",
     "urllib": "^4.9.0",
     "uuid": "^11.1.0",
-    "vona-core": "^5.1.59",
+    "vona-core": "^5.1.61",
     "why-is-node-running": "^3.2.2",
     "yargs-parser": "^22.0.0"
   }