worsoft-frontend-codegen-local-mcp 0.1.33 → 0.1.36

package/mcp_server.js

@@ -5,7 +5,7 @@ const fs = require('fs');
 const path = require('path');
 
 const SERVER_NAME = 'worsoft-codegen-local';
-const SERVER_VERSION = '0.1.33';
+const SERVER_VERSION = '0.1.36';
 const PROTOCOL_VERSION = '2024-11-05';
 const TOOL_NAME = 'worsoft_codegen_local_generate_frontend';
 const STYLE_CATALOG_PATH = path.join(__dirname, 'assets', 'style-catalog.json');
@@ -148,19 +148,19 @@ export function createCrudSchema(
 const TOOL_SCHEMA = {
   type: 'object',
   properties: {
-    featureTitle: { type: 'string', description: 'Feature title from structured metadata.' },
-    tableName: { type: 'string', description: 'Target main table name from the structured feature metadata.' },
-    tableComment: { type: 'string', description: 'Main table comment or feature label for menu/title generation.' },
-    apiPath: { type: 'string', description: 'Backend API base path from structured metadata, for example iwmEmpOutsourcePerson.' },
+    featureTitle: { type: 'string', description: 'Feature title from pre-parsed structured metadata.' },
+    tableName: { type: 'string', description: 'Canonical main table name from PRD-aligned structured metadata.' },
+    tableComment: { type: 'string', description: 'Canonical main table comment or feature label from PRD-aligned structured metadata.' },
+    apiPath: { type: 'string', description: 'Backend API base path from pre-parsed structured metadata, for example iwmEmpOutsourcePerson.' },
     pageType: {
       type: 'string',
       enum: ['feature', 'dictionary', 'non_standard', 'business', 'dict'],
-      description: 'Structured page type from parseResult. Dictionary pages are restricted to dialog-based templates.',
+      description: 'Structured page type from parseResult. MCP consumes this value but does not derive it. Dictionary pages are restricted to dialog-based templates.',
     },
-    style: { type: 'string', enum: Object.keys(STYLE_CATALOG), description: 'Style id from assets/style-catalog.json.' },
-    fields: {
-      type: 'array',
-      description: 'Structured main-table field metadata provided by the caller.',
+    style: { type: 'string', enum: Object.keys(STYLE_CATALOG), description: 'Final style id from parseResult or translated mcpPayload. MCP validates it but does not infer it.' },
+    fields: {
+      type: 'array',
+      description: 'Structured main-table field metadata already translated by the caller. MCP only consumes these low-level generation parameters.',
       items: {
         type: 'object',
         properties: {
@@ -177,8 +177,10 @@ const TOOL_SCHEMA = {
           queryType: { type: ['string', 'number'], description: 'Structured query type for list filtering, for example 20 for date ranges or 30 for dictionary filters.' },
           dictType: { type: 'string', description: 'Dictionary type code from structured metadata.' },
           defaultValue: { type: ['string', 'number', 'boolean'], description: 'Optional default value.' },
-          description: { type: 'string', description: 'Field description or notes.' },
-          sourceKind: { type: 'string', enum: ['entity', 'display', 'virtual', 'common'], description: 'Field source kind.' },
+          description: { type: 'string', description: 'Field description or notes.' },
+          componentType: { type: 'string', description: 'Explicit component type from PRD structured metadata, for example text, textarea, select, number or datetime.' },
+          formType: { type: 'string', description: 'Explicit form control type translated by the caller. MCP consumes this value first and only falls back to legacy heuristics when omitted.' },
+          sourceKind: { type: 'string', enum: ['entity', 'display', 'virtual', 'common'], description: 'Field source kind.' },
           primary: { type: ['boolean', 'string'], description: 'Whether the field is the primary key.' },
         },
         required: ['fieldName', 'label', 'type'],
@@ -187,7 +189,7 @@ const TOOL_SCHEMA = {
     },
     children: {
       type: 'array',
-      description: 'Optional direct child-table structures for master_child_jump. When provided, MCP renders all listed direct child tables on the same main form.',
+      description: 'Optional direct child-table structures for master_child_jump. When provided, MCP renders all listed direct child tables on the same main form. The caller must determine semantic truth before passing them in.',
       items: {
         type: 'object',
         properties: {
@@ -216,8 +218,10 @@ const TOOL_SCHEMA = {
                 queryType: { type: ['string', 'number'], description: 'Structured query type for list filtering, for example 20 for date ranges or 30 for dictionary filters.' },
                 dictType: { type: 'string', description: 'Dictionary type code from structured metadata.' },
                 defaultValue: { type: ['string', 'number', 'boolean'], description: 'Optional default value.' },
-                description: { type: 'string', description: 'Field description or notes.' },
-                sourceKind: { type: 'string', enum: ['entity', 'display', 'virtual', 'common'], description: 'Field source kind.' },
+                description: { type: 'string', description: 'Field description or notes.' },
+                componentType: { type: 'string', description: 'Explicit component type from PRD structured metadata.' },
+                formType: { type: 'string', description: 'Explicit form control type translated by the caller.' },
+                sourceKind: { type: 'string', enum: ['entity', 'display', 'virtual', 'common'], description: 'Field source kind.' },
                 primary: { type: ['boolean', 'string'], description: 'Whether the field is the primary key.' },
               },
               required: ['fieldName', 'label', 'type'],
@@ -243,8 +247,8 @@ const TOOL_SCHEMA = {
             items: {
               type: 'object',
               properties: {
-                tableName: { type: 'string', description: 'Module table name.' },
-                tableComment: { type: 'string', description: 'Module display label.' },
+                tableName: { type: 'string', description: 'Canonical module table name from PRD-aligned structured metadata.' },
+                tableComment: { type: 'string', description: 'Canonical module display label from PRD-aligned structured metadata.' },
                 apiPath: { type: 'string', description: 'Backend API base path for this module.' },
                 primaryKey: { type: 'string', description: 'Primary key field name. Defaults to id when omitted.' },
                 queryParentField: { type: 'string', description: 'Direct parent foreign key field used for page queries.' },
@@ -271,8 +275,10 @@ const TOOL_SCHEMA = {
                       queryType: { type: ['string', 'number'], description: 'Structured query type for list filtering, for example 20 for date ranges or 30 for dictionary filters.' },
                       dictType: { type: 'string', description: 'Dictionary type code from structured metadata.' },
                       defaultValue: { type: ['string', 'number', 'boolean'], description: 'Optional default value.' },
-                      description: { type: 'string', description: 'Field description or notes.' },
-                      sourceKind: { type: 'string', enum: ['entity', 'display', 'virtual', 'common'], description: 'Field source kind.' },
+                      description: { type: 'string', description: 'Field description or notes.' },
+                      componentType: { type: 'string', description: 'Explicit component type from PRD structured metadata.' },
+                      formType: { type: 'string', description: 'Explicit form control type translated by the caller.' },
+                      sourceKind: { type: 'string', enum: ['entity', 'display', 'virtual', 'common'], description: 'Field source kind.' },
                       primary: { type: ['boolean', 'string'], description: 'Whether the field is the primary key.' }
                     },
                     required: ['fieldName', 'label', 'type'],
@@ -303,11 +309,6 @@ const TOOL_SCHEMA = {
       type: 'string',
       description: 'Explicit zh-cn i18n namespace, for example admin.iwmSysTrade. When provided, MCP writes zh-cn content to the matching file path and namespace instead of deriving them from moduleName and functionName.',
     },
-    generationMode: {
-      type: 'string',
-      enum: ['create_new', 'overwrite_existing', 'patch_existing'],
-      description: 'Structured generation mode from parseResult. MCP currently uses this as a pass-through runtime hint and result annotation.',
-    },
     writeToDisk: { type: 'boolean', default: true, description: 'Whether to write generated files.' },
     overwrite: { type: 'boolean', default: true, description: 'Whether to overwrite existing files. If false, existing files are skipped.' },
     writeSupportFiles: {
@@ -850,15 +851,34 @@ function findDictType(comment) {
   return extractDictType(comment);
 }
 
-function mapFieldType(field) {
-  if (field.dictType) return 'select';
-  if (field.sqlType === 'DATETIME' || field.sqlType === 'TIMESTAMP') return 'datetime';
-  if (field.sqlType === 'DATE') return 'date';
-  if (['INT', 'BIGINT', 'DECIMAL', 'NUMERIC'].includes(field.sqlType)) return 'number';
-  if (field.sqlType === 'TEXT') return 'textarea';
-  if (field.sqlType === 'VARCHAR' && field.length && Number(field.length) > 64) return 'textarea';
-  return 'text';
-}
+function mapFieldType(field) {
+  if (field.dictType) return 'select';
+  if (field.sqlType === 'DATETIME' || field.sqlType === 'TIMESTAMP') return 'datetime';
+  if (field.sqlType === 'DATE') return 'date';
+  if (['INT', 'BIGINT', 'DECIMAL', 'NUMERIC'].includes(field.sqlType)) return 'number';
+  if (field.sqlType === 'TEXT') return 'textarea';
+  if (field.sqlType === 'VARCHAR' && field.length && Number(field.length) > 64) return 'textarea';
+  return 'text';
+}
+
+function normalizeStructuredFormType(value) {
+  const normalized = String(value || '').trim().toLowerCase();
+  if (!normalized) return '';
+  if (normalized === 'date') return 'date';
+  if (normalized === 'datetime') return 'datetime';
+  if (normalized === 'microme-operator') return 'number';
+  if (normalized === 'upload' || normalized === 'picker') {
+    throw new Error(
+      'Explicit component/form type "' +
+        normalized +
+        '" is not yet supported by worsoft-codegen-local templates. Please keep it in parseResult for downstream handling or extend MCP template support first.'
+    );
+  }
+  if (['text', 'select', 'textarea', 'number'].includes(normalized)) {
+    return normalized;
+  }
+  throw new Error('Unsupported explicit component/form type: ' + normalized);
+}
 
 function escapeForRegex(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
@@ -1013,6 +1033,7 @@ function normalizeStructuredField(inputField, index, contextLabel) {
   }
 
   const { length, scale } = normalizeStructuredLengthAndScale(inputField.length, inputField.scale);
+  const explicitFormType = normalizeStructuredFormType(inputField.formType || inputField.componentType);
   const explicitQueryType =
     inputField.queryType === undefined || inputField.queryType === null || inputField.queryType === ''
       ? undefined
@@ -1028,6 +1049,7 @@ function normalizeStructuredField(inputField, index, contextLabel) {
     comment: label,
     label,
     description: String(inputField.description || '').trim(),
+    formType: explicitFormType,
     dictType: normalizeDictType(inputField.dictType),
     notNull: parseBooleanLike(inputField.required, false),
     defaultValue: normalizeDefaultValue(inputField.defaultValue),
@@ -1221,12 +1243,29 @@ function getStylePreset(styleId) {
 function normalizePageTypeInput(pageType) {
   if (pageType === undefined || pageType === null || pageType === '') return '';
   const normalized = String(pageType).trim();
-  if (normalized === 'dict') return 'dictionary';
-  if (normalized === 'business') return 'feature';
+  if (normalized === 'dict' || normalized === 'business') {
+    throw new Error(`Legacy pageType alias "${normalized}" is not allowed. Use canonical pageType "dictionary" or "feature" from parseResult.`);
+  }
   if (['feature', 'dictionary', 'non_standard'].includes(normalized)) return normalized;
   throw new Error('Unsupported pageType: ' + normalized);
 }
 
+function rejectSemanticStageInputs(input) {
+  const forbiddenKeys = [
+    'parseResult',
+    'prdFile',
+    'apiDocFile',
+    'fieldMappings',
+    'dictionaryMeta',
+    'listQueryMeta',
+    'fieldUiMeta',
+  ];
+  const present = forbiddenKeys.filter((key) => Object.prototype.hasOwnProperty.call(input, key));
+  if (present.length) {
+    throw new Error(`worsoft_codegen_local_generate_frontend only accepts translated low-level generation parameters. Unsupported semantic-stage keys: ${present.join(', ')}`);
+  }
+}
+
 function validatePageTypeAndStyle(pageType, style) {
   if (!pageType) return;
   if (pageType === 'non_standard') {
@@ -1242,9 +1281,9 @@ function hasRuntimeSupport(stylePreset) {
   return Boolean(stylePreset.runtime && stylePreset.runtime.supported && stylePreset.runtime.templateDir);
 }
 
-function normalizeFields(parsed) {
-  return parsed.fields.map((field) => ({ ...field, formType: mapFieldType(field), isAudit: isAuditField(field.fieldName) }));
-}
+function normalizeFields(parsed) {
+  return parsed.fields.map((field) => ({ ...field, formType: field.formType || mapFieldType(field), isAudit: isAuditField(field.fieldName) }));
+}
 
 function ensureFieldExists(fields, fieldName, tableName, role) {
   const field = fields.find((item) => item.fieldName === fieldName);
@@ -1357,7 +1396,6 @@ function buildMultiLevelDictModel(safeArgs) {
     targetViewDir: resolvedTargets.targetViewDir,
     targetApiModule: resolvedTargets.targetApiModule,
     targetI18nKey: resolvedTargets.targetI18nKey,
-    generationMode: safeArgs.generationMode,
     frontendPath: path.resolve(safeArgs.frontendPath),
     style: safeArgs.style,
     levels: builtLevels,
@@ -1452,7 +1490,6 @@ function buildModel(safeArgs) {
     targetViewDir: resolvedTargets.targetViewDir,
     targetApiModule: resolvedTargets.targetApiModule,
     targetI18nKey: resolvedTargets.targetI18nKey,
-    generationMode: safeArgs.generationMode,
     pk: pkField,
     fields,
     optionFields,
@@ -2618,11 +2655,12 @@ function renderFiles(model, stylePreset, sharedSupport, localeZhSupport) {
   return files;
 }
 
-function ensureArguments(input) {
-  if (!input || typeof input !== 'object') throw new Error('Arguments must be an object');
-  for (const key of TOOL_SCHEMA.required) {
-    if (input[key] === undefined || input[key] === null || input[key] === '') throw new Error(key + ' is required');
-  }
+function ensureArguments(input) {
+  if (!input || typeof input !== 'object') throw new Error('Arguments must be an object');
+  rejectSemanticStageInputs(input);
+  for (const key of TOOL_SCHEMA.required) {
+    if (input[key] === undefined || input[key] === null || input[key] === '') throw new Error(key + ' is required');
+  }
 
   const style = String(input.style);
   const pageType = normalizePageTypeInput(input.pageType);
@@ -2655,7 +2693,6 @@ function ensureArguments(input) {
     targetViewDir: input.targetViewDir ? String(input.targetViewDir) : '',
     targetApiModule: input.targetApiModule ? String(input.targetApiModule) : '',
     targetI18nKey: input.targetI18nKey ? String(input.targetI18nKey) : '',
-    generationMode: input.generationMode ? String(input.generationMode) : 'create_new',
     writeToDisk: input.writeToDisk === undefined ? true : Boolean(input.writeToDisk),
     overwrite: input.overwrite === undefined ? true : Boolean(input.overwrite),
     writeSupportFiles: input.writeSupportFiles === undefined ? true : Boolean(input.writeSupportFiles),
@@ -2699,7 +2736,6 @@ function buildManifest(model, safeArgs, stylePreset, files, note) {
       targetViewDir: model.targetViewDir,
       targetApiModule: model.targetApiModule,
       targetI18nKey: model.targetI18nKey,
-      generationMode: model.generationMode || safeArgs.generationMode,
       writeToDisk: safeArgs.writeToDisk,
       sideEffects: {
         writeSupportFiles: safeArgs.writeSupportFiles,
@@ -2756,7 +2792,6 @@ function buildManifest(model, safeArgs, stylePreset, files, note) {
     targetViewDir: model.targetViewDir,
     targetApiModule: model.targetApiModule,
     targetI18nKey: model.targetI18nKey,
-    generationMode: model.generationMode || safeArgs.generationMode,
     writeToDisk: safeArgs.writeToDisk,
     sideEffects: {
       writeSupportFiles: safeArgs.writeSupportFiles,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "worsoft-frontend-codegen-local-mcp",
-  "version": "0.1.33",
+  "version": "0.1.36",
   "description": "Worsoft frontend local-template code generation MCP server.",
   "license": "UNLICENSED",
   "author": "worsoft <sw@worsoft.vip>",