@restforgejs/mcp-server 1.2.1 → 1.2.3

package/dist/tools/codegen/migrate-payload.js

@@ -0,0 +1,207 @@
+import { z } from 'zod';
+import { access } from 'node:fs/promises';
+import { resolve, join } from 'node:path';
+import { execProcess } from '../../lib/exec.js';
+export function registerCodegenMigratePayload(server) {
+    server.registerTool('codegen_migrate_payload', {
+        title: 'Migrate Payload (RDF backend -> UDF frontend)',
+        description: `Convert an existing backend payload file (RDF) into a frontend payload (UDF) for RESTForge Designer, by wrapping restforge payload migrate. The output is always a SPLIT multi-file set written into an output directory (app-config.json, one file per page under pages/, and an aggregator <appCode>.json), not a single UDF file. The migrator also auto-discovers JOINed tables, so one JOINed RDF can produce several pages at once.
+
+USE WHEN:
+- The user wants to build a frontend UDF from an existing backend payload, e.g. "buat UDF dari payload backend", "konversi RDF ke UDF", "migrate payload ke frontend", "bikin payload designer dari backend existing"
+- The user has a working backend payload and now wants to start authoring the matching frontend in RESTForge Designer (on-ramp from backend to frontend)
+- The user mentions migrating, converting, or porting a backend payload over to the designer / frontend side
+
+DO NOT USE FOR:
+- Generating the actual frontend web application from a UDF that already exists -> use the designer generate action (describe it by what it does, do not name the tool)
+- Validating a backend payload against the database schema -> use 'codegen_validate_payload'
+- Generating a backend payload from a database table that has no payload yet -> use 'codegen_generate_payload'
+
+This tool runs: npx restforge payload migrate --name=<name> --project=<project> [--output] [--config] [--app-name] [--app-code] [--plugin] [--port] [--overwrite] in the given cwd.
+The CLI reads the backend RDF (resolved relative to cwd or cwd/payload/), reads SERVER_ADDRESS/SERVER_PORT from the DB config (or the default config) to build apiBaseUrl, and writes the split UDF files into the output directory (default frontend/payload/).
+
+Cross-reference (downstream UDF flow):
+- This tool is the on-ramp that creates a UDF from an existing backend RDF. Its split UDF output is consumed by the designer tools: validate it with 'designer_validate_payload', dry-run it with 'designer_preview_files', and generate the frontend with 'designer_generate' — always point those at the aggregator file (<appCode>.json), not the individual page fragments.
+- To see the target UDF structure and rules (valid field types, required appConfig fields, enums, limits), use 'designer_get_udf_catalog'.
+- Canonical UDF flow: codegen_migrate_payload -> designer_get_udf_catalog -> designer_validate_payload -> designer_preview_files -> designer_generate.
+
+Preconditions:
+- The project must have @restforgejs/platform installed in node_modules.
+- The named RDF payload file must exist (resolved relative to cwd or cwd/payload/).
+- Without --overwrite, the command fails if any split output file already exists in the output directory.
+  This tool does not pre-check those — if the CLI fails, the failure response will surface the cause.
+
+PRESENTATION GUIDANCE:
+- Match the user's language. If the user writes in Indonesian, respond in Indonesian.
+- Never mention internal tool names in the reply to the user. Describe actions by what they do (e.g. "convert the backend payload into a frontend payload", "validate the frontend payload", "generate the frontend application").
+- Speak in plain language. Confirm the migration, mention the output directory and that the result is a split multi-file UDF; do not paste the raw CLI output unless the user explicitly asks.
+- After a successful migration, the usual next steps are to validate the resulting UDF, preview it, or generate the frontend application from it. Describe those steps by what they do; do not name internal tools.
+- When a precondition is not met, frame it as a question or next-step suggestion rather than an error.`,
+        inputSchema: {
+            cwd: z
+                .string()
+                .min(1)
+                .describe('Absolute path of the backend project folder (must contain node_modules/@restforgejs/platform; the RDF payload is read from here)'),
+            name: z
+                .string()
+                .min(1)
+                .describe('Backend RDF payload file name (e.g. visitors.json). Resolved relative to cwd or cwd/payload/. REQUIRED.'),
+            project: z
+                .string()
+                .min(1)
+                .describe('Project name in kebab-case, used as the path segment in apiBaseUrl (http://{host}:{port}/api/{project}). REQUIRED.'),
+            output: z
+                .string()
+                .min(1)
+                .optional()
+                .describe('Output directory for the split UDF files, relative to cwd. When omitted, the CLI uses its default (frontend/payload/). A value ending in .json is reduced to its parent directory.'),
+            config: z
+                .string()
+                .min(1)
+                .optional()
+                .describe('Database config file (.env) read for SERVER_ADDRESS/SERVER_PORT (backend host/port). When omitted, the CLI falls back to the default config.'),
+            appName: z
+                .string()
+                .min(1)
+                .optional()
+                .describe('Value for appConfig.appName in the UDF output. When omitted, derived from project in Title Case (e.g. visitors-app -> "Visitors App").'),
+            appCode: z
+                .string()
+                .min(1)
+                .optional()
+                .describe('Value for appConfig.appCode in the UDF output (kebab-case). Also used as the aggregator file name (<appCode>.json). When omitted, follows project.'),
+            plugin: z
+                .string()
+                .min(1)
+                .optional()
+                .describe('Designer plugin ID written to appConfig.plugin. When omitted, the CLI uses its default (vanilla-js-basic).'),
+            port: z
+                .number()
+                .int()
+                .min(1)
+                .max(65535)
+                .optional()
+                .describe('Frontend application port written to appConfig.port. Independent of the backend port used in apiBaseUrl. When omitted, the CLI uses its default (8000).'),
+            overwrite: z
+                .boolean()
+                .optional()
+                .describe('Overwrite existing split output files. Without it, the command fails if any split file already exists in the output directory.'),
+        },
+        annotations: {
+            title: 'Migrate Payload (RDF backend -> UDF frontend)',
+            readOnlyHint: false,
+            idempotentHint: false, // re-running can fail or overwrite depending on --overwrite
+            destructiveHint: false,
+        },
+    }, async ({ cwd, name, project, output, config, appName, appCode, plugin, port, overwrite }) => {
+        const projectCwd = resolve(cwd);
+        // Precondition check: @restforgejs/platform must be present in node_modules.
+        // Treated as a non-error precondition per the authoring guide §3.4.
+        try {
+            await access(join(projectCwd, 'node_modules', '@restforgejs', 'platform'));
+        }
+        catch {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Precondition not met: the RESTForge package is not installed in this project.
+
+Project path: ${projectCwd}
+Expected location: node_modules/@restforgejs/platform
+Requested RDF: ${name}
+Requested project: ${project}
+
+For the assistant:
+- The user needs to install the RESTForge package before a backend payload can be migrated into a frontend payload.
+- Suggest installing the package first, then retry the migration.
+- When explaining to the user, say something like "the RESTForge package isn't installed yet — should I install it first?". Do not mention internal tool names.`,
+                    },
+                ],
+                isError: false, // per §3.4
+            };
+        }
+        // Forward only the arguments the user supplied. CLI defaults
+        // (frontend/payload/ output, vanilla-js-basic plugin, port 8000, etc.)
+        // stay in effect when the user does not specify them. per §3.5
+        const args = ['restforge', 'payload', 'migrate', `--name=${name}`, `--project=${project}`];
+        if (output)
+            args.push(`--output=${output}`);
+        if (config)
+            args.push(`--config=${config}`);
+        if (appName)
+            args.push(`--app-name=${appName}`);
+        if (appCode)
+            args.push(`--app-code=${appCode}`);
+        if (plugin)
+            args.push(`--plugin=${plugin}`);
+        if (port !== undefined)
+            args.push(`--port=${port}`);
+        if (overwrite)
+            args.push('--overwrite');
+        const result = await execProcess('npx', args, { cwd: projectCwd, timeout: 60_000 });
+        // Branch C: CLI failure — real error per §3.4. A failed or partial migration
+        // needs recovery, so this is isError: true. Structured per §3.5.
+        if (!result.success) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to migrate the backend payload into a frontend payload.
+
+Project path: ${projectCwd}
+RDF name: ${name}
+Project: ${project}
+Output: ${output ?? 'default (frontend/payload/)'}
+Config: ${config ?? 'default config'}
+Command: ${result.command}
+Exit code: ${result.exitCode}
+
+--- CLI output ---
+stdout:
+${result.stdout}
+
+stderr:
+${result.stderr}
+--- end CLI output ---
+
+For the assistant:
+- Tell the user that the payload migration did not complete successfully, and that any partially written output may need cleanup.
+- Summarise the most likely cause from the CLI output in plain language. Common causes:
+  * The named RDF payload was not found — it is resolved relative to cwd or cwd/payload/. Suggest checking the file name and location.
+  * The database config could not be read (missing or incomplete SERVER_ADDRESS/SERVER_PORT), or no default config is set. Suggest pointing at a valid config file.
+  * Output files already exist and --overwrite was not set — suggest re-running with overwrite enabled or choosing a different output directory.
+- Do not paste the raw stdout/stderr unless the user explicitly asks. Do not mention internal tool names.`,
+                    },
+                ],
+                isError: true, // per §3.4
+            };
+        }
+        // Branch B: success — labeled facts + fenced raw output per §3.5.
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Payload migration completed (RDF backend -> UDF frontend).
+
+Project path: ${projectCwd}
+RDF name: ${name}
+Project: ${project}
+Output dir: ${output ?? 'default (frontend/payload/)'}
+Command: ${result.command}
+
+--- CLI output ---
+${result.stdout}
+--- end CLI output ---
+
+For the assistant:
+- Confirm to the user that the backend payload was converted into a frontend payload. Mention that the output is a split multi-file set (a shared app-config file, one file per page under pages/, and an aggregator file) written into the output directory above.
+- Read the CLI output for the number of pages and the file list; mention how many pages were produced (auto-discovered JOINs can produce more than one page from a single RDF).
+- Suggest the usual next steps in plain language: validate the resulting frontend payload, preview it, or generate the frontend application from it (always pointing at the aggregator file, not the individual page fragments). Do not name internal tools.
+- Keep the reply concise. Do not paste the raw CLI output unless the user explicitly asks. Do not mention internal tool names.`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=migrate-payload.js.map

package/dist/tools/codegen/migrate-payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-payload.js","sourceRoot":"","sources":["../../../src/tools/codegen/migrate-payload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,UAAU,6BAA6B,CAAC,MAAiB;IAC7D,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,KAAK,EAAE,+CAA+C;QACtD,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uGA+BoF;QACjG,WAAW,EAAE;YACX,GAAG,EAAE,CAAC;iBACH,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,kIAAkI,CAAC;YAC/I,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,yGAAyG,CAAC;YACtH,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,oHAAoH,CAAC;YACjI,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,EAAE;iBACV,QAAQ,CAAC,oLAAoL,CAAC;YACjM,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,EAAE;iBACV,QAAQ,CAAC,8IAA8I,CAAC;YAC3J,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,EAAE;iBACV,QAAQ,CAAC,wIAAwI,CAAC;YACrJ,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,EAAE;iBACV,QAAQ,CAAC,oJAAoJ,CAAC;YACjK,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,EAAE;iBACV,QAAQ,CAAC,4GAA4G,CAAC;YACzH,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,KAAK,CAAC;iBACV,QAAQ,EAAE;iBACV,QAAQ,CAAC,yJAAyJ,CAAC;YACtK,SAAS,EAAE,CAAC;iBACT,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,gIAAgI,CAAC;SAC9I;QACD,WAAW,EAAE;YACX,KAAK,EAAE,+CAA+C;YACtD,YAAY,EAAE,KAAK;YACnB,cAAc,EAAE,KAAK,EAAE,4DAA4D;YACnF,eAAe,EAAE,KAAK;SACvB;KACF,EACD,KAAK,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE;QAC1F,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAEhC,6EAA6E;QAC7E,oEAAoE;QACpE,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,CAAC,CAAC,CAAC;QAC7E,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;gBAEJ,UAAU;;iBAET,IAAI;qBACA,OAAO;;;;;gKAKoI;qBACnJ;iBACF;gBACD,OAAO,EAAE,KAAK,EAAE,WAAW;aAC5B,CAAC;QACJ,CAAC;QAED,6DAA6D;QAC7D,uEAAuE;QACvE,+DAA+D;QAC/D,MAAM,IAAI,GAAG,CAAC,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,IAAI,EAAE,EAAE,aAAa,OAAO,EAAE,CAAC,CAAC;QAC3F,IAAI,MAAM;YAAE,IAAI,CAAC,IAAI,CAAC,YAAY,MAAM,EAAE,CAAC,CAAC;QAC5C,IAAI,MAAM;YAAE,IAAI,CAAC,IAAI,CAAC,YAAY,MAAM,EAAE,CAAC,CAAC;QAC5C,IAAI,OAAO;YAAE,IAAI,CAAC,IAAI,CAAC,cAAc,OAAO,EAAE,CAAC,CAAC;QAChD,IAAI,OAAO;YAAE,IAAI,CAAC,IAAI,CAAC,cAAc,OAAO,EAAE,CAAC,CAAC;QAChD,IAAI,MAAM;YAAE,IAAI,CAAC,IAAI,CAAC,YAAY,MAAM,EAAE,CAAC,CAAC;QAC5C,IAAI,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;QACpD,IAAI,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAExC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAEpF,6EAA6E;QAC7E,iEAAiE;QACjE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;gBAEJ,UAAU;YACd,IAAI;WACL,OAAO;UACR,MAAM,IAAI,6BAA6B;UACvC,MAAM,IAAI,gBAAgB;WACzB,MAAM,CAAC,OAAO;aACZ,MAAM,CAAC,QAAQ;;;;EAI1B,MAAM,CAAC,MAAM;;;EAGb,MAAM,CAAC,MAAM;;;;;;;;;0GAS2F;qBAC7F;iBACF;gBACD,OAAO,EAAE,IAAI,EAAE,WAAW;aAC3B,CAAC;QACJ,CAAC;QAED,kEAAkE;QAClE,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;gBAEF,UAAU;YACd,IAAI;WACL,OAAO;cACJ,MAAM,IAAI,6BAA6B;WAC1C,MAAM,CAAC,OAAO;;;EAGvB,MAAM,CAAC,MAAM;;;;;;;+HAOgH;iBACpH;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/designer/generate.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerDesignerGenerate(server: McpServer): void;

package/dist/tools/designer/generate.js

@@ -0,0 +1,217 @@
+import { z } from 'zod';
+import { resolve } from 'node:path';
+import { execProcess } from '../../lib/exec.js';
+export function registerDesignerGenerate(server) {
+    server.registerTool('designer_generate', {
+        title: 'Generate Designer Frontend',
+        description: `Generate frontend code from a UI Definition File (UDF) payload, by running restforge-designer generate. This WRITES the generated frontend files to disk.
+
+USE WHEN:
+- The user asks to generate / build the frontend application from a UDF payload
+- The user asks things like "generate aplikasi frontend dari UDF", "build frontend dari payload", "generate satu page/form" (scope=form), "generate the frontend code", "build the frontend from this UI definition", "generate frontend designer"
+- The user has a valid UDF payload and wants the real frontend files produced (not just a preview)
+- The user wants to generate a single page/form rather than the whole app (use scope=form with the page id)
+
+DO NOT USE FOR:
+- Previewing which files would be generated WITHOUT writing them -> use 'designer_preview_files'
+- Validating that the UDF payload is structurally correct -> use 'designer_validate_payload'
+- Initialising a new project from a plugin -> use 'designer_init_project'
+- Creating a new custom plugin from a template -> use 'designer_scaffold_plugin'
+
+This tool wraps the RESTForge Designer CLI command: restforge-designer generate --payload=<payload> --output=<output> [optional flags], run in the given cwd.
+The --payload and --output flags are always sent so the binary never drops into interactive prompt mode. Optional flags (plugin override, overwrite, scope, page, skip shared, plugins dir, license) are forwarded only when supplied; the binary defaults to scope 'app' when --scope is omitted.
+This operation is license-gated: the RESTForge Designer license must be active for generation to succeed.
+The recommended flow is read-before-write (§5.3): validate the payload, then preview the files, then generate.
+
+Cross-reference (grounding & on-ramp):
+- Before authoring or generating from a UDF, ground its shape (valid field types, required appConfig fields, enums, limits) against the designer's own rules via 'designer_get_udf_catalog' — the authoritative source of UDF structure.
+- If no UDF payload exists yet but the user has a backend RDF, the on-ramp is 'codegen_migrate_payload' (RDF -> split UDF set); validate and preview it before generating.
+- Canonical UDF flow: codegen_migrate_payload -> designer_get_udf_catalog -> designer_validate_payload -> designer_preview_files -> designer_generate.
+
+Preconditions:
+- The 'restforge-designer' binary must be installed and reachable on PATH. This tool pre-checks that by running
+  'restforge-designer --version'; if the binary is missing, the response will surface that as a non-error precondition.
+- A valid, active RESTForge Designer license is required (the operation is license-gated).
+
+PRESENTATION GUIDANCE:
+- Match the user's language. If the user writes in Indonesian, respond in Indonesian.
+- Never mention internal tool names in the reply to the user. Describe actions by what they do (e.g. "generate the frontend code", "validate the UI definition", "preview the generated files").
+- Speak in plain language. Confirm what was generated and where; do not paste raw CLI output unless the user explicitly asks.
+- When a precondition is not met, frame it as a question or next-step suggestion rather than an error.`,
+        inputSchema: {
+            cwd: z
+                .string()
+                .min(1)
+                .describe('Absolute path of the working directory where the binary is run'),
+            payload: z
+                .string()
+                .min(1)
+                .describe('Path to the UDF payload JSON file (relative to cwd or absolute). Required.'),
+            output: z
+                .string()
+                .min(1)
+                .describe('Path to the output folder where the frontend files will be written (relative to cwd or absolute). Required.'),
+            plugin: z
+                .string()
+                .min(1)
+                .optional()
+                .describe('Override the plugin id taken from the payload.'),
+            overwrite: z
+                .boolean()
+                .optional()
+                .describe('When true, overwrite existing files in the output directory.'),
+            scope: z
+                .enum(['app', 'form'])
+                .optional()
+                .describe('What to generate: the whole app or a single form/page. When omitted, the binary defaults to "app".'),
+            page: z
+                .string()
+                .min(1)
+                .optional()
+                .describe('The page/form id to generate, used with scope "form".'),
+            skipShared: z
+                .boolean()
+                .optional()
+                .describe('When true, skip generating the shared/common files.'),
+            pluginsDir: z
+                .string()
+                .min(1)
+                .optional()
+                .describe('Override path to the plugins folder. When omitted, the binary auto-detects the plugins directory.'),
+            license: z
+                .string()
+                .min(1)
+                .optional()
+                .describe('License key override for this license-gated operation. When omitted, the binary uses the activated license.'),
+        },
+        annotations: {
+            title: 'Generate Designer Frontend',
+            destructiveHint: false, // writes generated files; overwrites only when overwrite=true is supplied
+            idempotentHint: false, // each call regenerates files
+        },
+    }, async ({ cwd, payload, output, plugin, overwrite, scope, page, skipShared, pluginsDir, license, }) => {
+        const projectCwd = resolve(cwd);
+        // Precondition check: the restforge-designer binary must be reachable on PATH.
+        // Treated as a non-error precondition per the authoring guide §3.4.
+        const probe = await execProcess('restforge-designer', ['--version'], {
+            cwd: projectCwd,
+            timeout: 10_000,
+        });
+        if (!probe.success) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Precondition not met: the RESTForge Designer command-line tool is not installed or not on PATH.
+
+Working directory: ${projectCwd}
+Payload: ${payload}
+Output: ${output}
+Plugins dir: ${pluginsDir ?? 'auto-detect'}
+Probe command: ${probe.command}
+Exit code: ${probe.exitCode}
+
+For the assistant:
+- The user needs to install RESTForge Designer (and ensure it is on the system PATH) before frontend code can be generated.
+- When explaining to the user, say something like "the RESTForge Designer tool isn't installed or isn't on your PATH yet — please install it and try again". Do not mention internal tool names.
+- Once it is installed, retry generating the frontend code.`,
+                    },
+                ],
+                isError: false, // per §3.4
+            };
+        }
+        // Always send the required flags (--payload, --output) so the binary never drops
+        // into interactive prompt mode. Forward optional flags only when supplied; --scope
+        // is omitted to keep the binary's "app" default. per §3.5 / D6
+        const args = ['generate', `--payload=${payload}`, `--output=${output}`];
+        if (plugin)
+            args.push(`--plugin=${plugin}`);
+        if (overwrite)
+            args.push('--overwrite');
+        if (scope)
+            args.push(`--scope=${scope}`);
+        if (page)
+            args.push(`--page=${page}`);
+        if (skipShared)
+            args.push('--skip-shared');
+        if (pluginsDir)
+            args.push(`--plugins-dir=${pluginsDir}`);
+        if (license)
+            args.push(`--license=${license}`);
+        const result = await execProcess('restforge-designer', args, {
+            cwd: projectCwd,
+            timeout: 120_000,
+        });
+        // D9: write tool. A non-zero exit (incl. -1 crash/timeout) means generation did not
+        // complete cleanly — files may be missing or partial, so the model needs to recover
+        // -> isError: true.
+        if (result.exitCode !== 0) {
+            const stderrBlock = result.stderr
+                ? `\n--- stderr ---\n${result.stderr}\n--- end stderr ---\n`
+                : '';
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Generating the frontend code did not complete.
+
+Working directory: ${projectCwd}
+Payload: ${payload}
+Output: ${output}
+Scope: ${scope ?? 'app (default)'}
+Plugins dir: ${pluginsDir ?? 'auto-detect'}
+Command: ${result.command}
+Exit code: ${result.exitCode}
+
+--- stdout ---
+${result.stdout}
+--- end stdout ---
+${stderrBlock}
+For the assistant:
+- The generation did not finish successfully, so the output files may be missing or partial. Read the CLI output above and explain the most likely cause to the user in plain language. Common causes:
+  * The RESTForge Designer license is not active — this operation is license-gated. Suggest the user activate their RESTForge Designer license through the Designer desktop application or its own CLI, then retry. Do not name any internal tool.
+  * The UDF payload is invalid — suggest validating the payload first to pinpoint the structural errors, then retry.
+  * The payload relies on 'extends' / 'include' references — soft note: if the same payload passes validation but generation fails with an appConfig/plugin error (e.g. the plugin or app config "not found"), the payload may use 'extends' / 'include' that generate does not appear to merge the way validation does. As a possible workaround, suggest a self-contained payload (inline appConfig and pages) or an already-merged file. This is a tentative hint, not a guaranteed rule — do not state it as certain or tie it to a specific version.
+  * The payload file path is wrong / the file was not found — suggest checking the path.
+  * The plugin id in the payload (or the plugins directory) could not be resolved — suggest listing the available plugins.
+  * The output directory already exists and overwrite was not enabled — suggest retrying with overwrite, or choosing a different output path.
+  * Exit code -1 — the command crashed or timed out; offer to retry.
+- Do not paste the raw CLI output unless the user explicitly asks. Do not mention internal tool names. Match the user's language.`,
+                    },
+                ],
+                isError: true, // per §3.4 / D9 — write did not complete
+            };
+        }
+        // D9: success — exit 0. Labeled facts + fenced raw output per §3.5.
+        const stderrBlock = result.stderr
+            ? `\n--- stderr ---\n${result.stderr}\n--- end stderr ---\n`
+            : '';
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Frontend code generated successfully.
+
+Working directory: ${projectCwd}
+Payload: ${payload}
+Output: ${output}
+Scope: ${scope ?? 'app (default)'}
+Plugins dir: ${pluginsDir ?? 'auto-detect'}
+Command: ${result.command}
+Exit code: ${result.exitCode}
+
+--- stdout ---
+${result.stdout}
+--- end stdout ---
+${stderrBlock}
+For the assistant:
+- Confirm to the user that the frontend code was generated. Mention the output location and the scope (whole app, or a single page/form) in plain language.
+- Summarise what was produced from the CLI output (how many files, what kind) rather than pasting it.
+- Suggest a sensible next step, e.g. running or inspecting the generated frontend.
+- Do not paste the raw CLI output unless the user explicitly asks. Do not mention internal tool names. Match the user's language.`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=generate.js.map

package/dist/tools/designer/generate.js.map

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

package/dist/tools/designer/get-udf-catalog.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerDesignerGetUdfCatalog(server: McpServer): void;