@restforgejs/mcp-server 1.2.3 → 1.2.4

package/dist/server.js

@@ -6,6 +6,9 @@ import { registerSetupTools } from './tools/setup/index.js';
 import { registerCodegenTools } from './tools/codegen/index.js';
 import { registerRuntimeTools } from './tools/runtime/index.js';
 import { registerDesignerTools } from './tools/designer/index.js';
+import { registerDataTools } from './tools/data/index.js';
+import { registerKeyTools } from './tools/key/index.js';
+import { registerProjectTools } from './tools/project/index.js';
 const SERVER_NAME = 'restforge-mcp';
 // Read the version from package.json at runtime so the advertised server version
 // never drifts from the published package version. createRequire resolves the JSON
@@ -218,8 +221,10 @@ that is NOT covered by an available catalog tool:
   2. Do NOT guess based on similar frameworks.
   3. Either:
      (a) Acknowledge that the specific information is not available via
-         this MCP server and suggest consulting the canonical docs at
-         https://restforge.dev/docs.
+         this MCP server and suggest consulting the canonical, up-to-date
+         RESTForge handbook at https://github.com/restforge/handbook.
+         (Do NOT point users to https://restforge.dev/docs — that site is
+         outdated; the GitHub handbook is the live source of truth.)
      (b) Ask the user to clarify if the question can be reframed to
          match an available catalog tool.
 
@@ -279,11 +284,19 @@ build or generate a frontend UDF, route along this flow:
   codegen_migrate_payload -> designer_get_udf_catalog ->
   designer_validate_payload -> designer_preview_files -> designer_generate
 
-- On-ramp: if the user has a backend RDF but no UDF yet, start with
-  'codegen_migrate_payload' — it converts an existing backend payload (RDF)
-  into a split multi-file UDF set (this verb belongs to the backend
-  'restforge' CLI, so it lives in the codegen domain even though its output
-  is a UDF).
+- CREATING a UDF — START HERE (firm rule): the FIRST path to produce a UDF
+  is ALWAYS 'codegen_migrate_payload'. RESTForge is backend-first; a UDF is
+  normally DERIVED from an existing backend payload (RDF), not written by
+  hand. 'codegen_migrate_payload' converts an existing RDF into a split
+  multi-file UDF set (this verb belongs to the backend 'restforge' CLI, so it
+  lives in the codegen domain even though its output is a UDF).
+  - Do NOT hand-author a UDF from scratch (writing the JSON yourself) when a
+    backend RDF payload exists. Convert it with 'codegen_migrate_payload'
+    first, then refine the generated UDF.
+  - Author a UDF from scratch (grounded by 'designer_get_udf_catalog') ONLY
+    when there is genuinely no backend RDF to migrate from. If unsure whether
+    an RDF exists, ask the user or look for the backend 'payload/' directory
+    BEFORE hand-authoring.
 - Grounding: the authoritative structure and rules of a UDF (valid field
   types, required appConfig fields, enums, limits, dashboard widget/chart/
   data-source options) come from 'designer_get_udf_catalog', which is
@@ -295,6 +308,35 @@ build or generate a frontend UDF, route along this flow:
 - Then validate ('designer_validate_payload'), preview
   ('designer_preview_files'), and finally generate ('designer_generate'),
   pointing those at the aggregator UDF file, not the page fragments.
+
+INTERACTIVE COMMANDS — knowledge only, NOT wrapped as tools:
+Some restforge commands are interactive and are intentionally NOT exposed as
+tools. When the user asks about them, EXPLAIN what they do and give the exact
+command for the user to run themselves in their terminal — this server cannot
+drive the interactive prompts.
+
+- 'fast-track' — command: npx restforge fast-track --project=<name> --schema-path=<dir> [--config=<file>] [--license=<KEY>] [--overwrite]
+  Purpose: a single interactive flow that scaffolds a full REST API (and
+  optionally the frontend app) from an SDF. It does NOT add new generation
+  logic; it ORCHESTRATES the existing restforge steps in order: write env (init
+  if needed) -> validate --auto-create-db -> config set-default -> schema
+  migrate -> payload generate -> payload sync --expand-fk -> endpoint create,
+  then (if frontend scope) migrate RDF->UDF -> designer generate, and finally
+  writes a server-start launcher.
+  Interactive prompts: license + DB params, a scope menu (1 = REST API only,
+  2 = REST API + frontend), and a confirmation. Because of these prompts it
+  cannot be invoked by this server.
+  How to help the user:
+  * When the user wants the FASTEST path from an SDF to a running app, tell them
+    to run the command above in their terminal and walk them through the prompts
+    (license, database, scope choice, confirm).
+  * '--overwrite' is DESTRUCTIVE (drops tables and regenerates) — warn before
+    suggesting it.
+  * If the user prefers a non-interactive / step-by-step path, the same pipeline
+    can be reproduced with the individual tools: schema migrate -> generate
+    payload -> sync payload (expand FK) -> create endpoint, then (frontend)
+    codegen_migrate_payload -> designer validate/preview/generate. Offer this as
+    the automatable alternative to fast-track.
 `.trim();
 export async function startServer() {
     const server = new McpServer({
@@ -308,6 +350,9 @@ export async function startServer() {
     registerCodegenTools(server);
     registerRuntimeTools(server);
     registerDesignerTools(server);
+    registerDataTools(server);
+    registerKeyTools(server);
+    registerProjectTools(server);
     const transport = new StdioServerTransport();
     await server.connect(transport);
 }

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,MAAM,WAAW,GAAG,eAAe,CAAC;AAEpC,iFAAiF;AACjF,mFAAmF;AACnF,6EAA6E;AAC7E,mFAAmF;AACnF,gFAAgF;AAChF,kFAAkF;AAClF,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAEtF,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwR3B,CAAC,IAAI,EAAE,CAAC;AAET,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,cAAc;KACxB,EACD;QACE,YAAY,EAAE,mBAAmB;KAClC,CACF,CAAC;IAEF,mBAAmB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC5C,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAE9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,MAAM,WAAW,GAAG,eAAe,CAAC;AAEpC,iFAAiF;AACjF,mFAAmF;AACnF,6EAA6E;AAC7E,mFAAmF;AACnF,gFAAgF;AAChF,kFAAkF;AAClF,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAEtF,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+T3B,CAAC,IAAI,EAAE,CAAC;AAET,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,cAAc;KACxB,EACD;QACE,YAAY,EAAE,mBAAmB;KAClC,CACF,CAAC;IAEF,mBAAmB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC5C,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAE7B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC"}

package/dist/tools/codegen/create-kafka-consumer.d.ts

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

package/dist/tools/codegen/create-kafka-consumer.js

@@ -0,0 +1,140 @@
+import { z } from 'zod';
+import { access } from 'node:fs/promises';
+import { resolve, join } from 'node:path';
+import { execProcess } from '../../lib/exec.js';
+export function registerCodegenCreateKafkaConsumer(server) {
+    server.registerTool('codegen_create_kafka_consumer', {
+        title: 'Create Kafka Consumer',
+        description: `Generate Kafka consumer source code from a payload JSON file, by wrapping restforge kafka consumer-create. The output is written under src/consumers/<project>/<name>/ and is later run by the internal 'restforge-consumer' binary.
+
+USE WHEN:
+- The user wants to create or scaffold a Kafka consumer from a consumer payload, e.g. "buat kafka consumer", "generate consumer", "create kafka consumer dari payload"
+- The user has a consumer payload JSON and wants the matching consumer code generated into a backend project
+- The user mentions consuming Kafka topics/events and needs the handler scaffolded
+
+DO NOT USE FOR:
+- Generating a REST endpoint -> use 'codegen_create_endpoint'
+- Generating a processor / background job -> use 'codegen_create_processor'
+- Deploying or running the consumer -> out of scope (the generated code is run by the internal 'restforge-consumer' binary, not this server)
+
+This tool runs: npx restforge kafka consumer-create --project=<project> --name=<name> --payload=<payload> [--force] in the given cwd.
+
+Preconditions:
+- The project must have @restforgejs/platform installed in node_modules.
+- The named consumer payload JSON must exist. This tool does not pre-check it — if the CLI fails, the failure response surfaces the cause.
+- Without 'force', the command fails if the consumer files already exist.
+
+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 Kafka consumer").
+- Speak in plain language; summarise the result. Do not paste raw CLI output unless the user explicitly asks.
+- Mention that the generated consumer is run separately by the internal consumer runtime, not by this assistant.
+- 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)'),
+            project: z.string().min(1).describe('Target project name. REQUIRED.'),
+            name: z.string().min(1).describe('Consumer name to create. REQUIRED.'),
+            payload: z
+                .string()
+                .min(1)
+                .describe('Path or file name of the consumer payload JSON. REQUIRED.'),
+            force: z
+                .boolean()
+                .optional()
+                .describe('Overwrite existing consumer files. Without it, the command fails if the files already exist.'),
+        },
+        annotations: {
+            title: 'Create Kafka Consumer',
+            readOnlyHint: false,
+            idempotentHint: false,
+            destructiveHint: false,
+        },
+    }, async ({ cwd, project, name, payload, force }) => {
+        const projectCwd = resolve(cwd);
+        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 consumer: ${name}
+Requested payload: ${payload}
+
+For the assistant:
+- The user needs to install the RESTForge package before a Kafka consumer can be generated.
+- Suggest installing the package first, then retry. When explaining, say something like "the RESTForge package isn't installed yet — should I install it first?". Do not mention internal tool names.`,
+                    },
+                ],
+                isError: false,
+            };
+        }
+        const args = ['restforge', 'kafka', 'consumer-create', `--project=${project}`, `--name=${name}`, `--payload=${payload}`];
+        if (force)
+            args.push('--force');
+        const result = await execProcess('npx', args, { cwd: projectCwd, timeout: 60_000 });
+        if (!result.success) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to create the Kafka consumer.
+
+Project path: ${projectCwd}
+Project: ${project}
+Consumer: ${name}
+Payload: ${payload}
+Command: ${result.command}
+Exit code: ${result.exitCode}
+
+--- CLI output ---
+stdout:
+${result.stdout}
+
+stderr:
+${result.stderr}
+--- end CLI output ---
+
+For the assistant:
+- Tell the user the Kafka consumer was not generated successfully.
+- Summarise the most likely cause from the CLI output in plain language (common causes: the payload file was not found, the payload is invalid, the consumer files already exist without force, or the target project does not exist). Do not paste raw output unless the user asks.
+- Offer to retry once the issue is resolved. Do not mention internal tool names.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Kafka consumer created.
+
+Project path: ${projectCwd}
+Project: ${project}
+Consumer: ${name}
+Payload: ${payload}
+Command: ${result.command}
+
+--- CLI output ---
+${result.stdout}
+--- end CLI output ---
+
+For the assistant:
+- Confirm the Kafka consumer source was generated under src/consumers/<project>/<name>/.
+- Mention that the consumer is run separately by the internal consumer runtime (restforge-consumer), not by this assistant.
+- Keep the reply concise. Do not paste raw CLI output unless the user explicitly asks. Do not mention internal tool names.`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=create-kafka-consumer.js.map

package/dist/tools/codegen/create-kafka-consumer.js.map

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

package/dist/tools/codegen/create-processor.d.ts

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

package/dist/tools/codegen/create-processor.js

@@ -0,0 +1,157 @@
+import { z } from 'zod';
+import { access } from 'node:fs/promises';
+import { resolve, join } from 'node:path';
+import { execProcess } from '../../lib/exec.js';
+export function registerCodegenCreateProcessor(server) {
+    server.registerTool('codegen_create_processor', {
+        title: 'Create Processor Module',
+        description: `Generate a processor (a background job / custom business-logic handler) from a payload JSON file, by wrapping restforge processor create. The processor exposes an endpoint whose router + metadata is always regenerated, while the implementation file holds the custom business logic.
+
+USE WHEN:
+- The user wants to create or scaffold a processor, background job, or custom business-logic handler from a processor payload, e.g. "buat processor", "generate processor", "create background job", "scaffold business logic handler"
+- The user has a processor payload JSON and wants the matching code generated into a backend project
+- The user wants to re-generate a processor's routing while keeping their hand-written logic (re-run WITHOUT force preserves custom code)
+
+DO NOT USE FOR:
+- Generating a standard REST endpoint from a payload -> use 'codegen_create_endpoint'
+- Generating a dashboard endpoint -> use 'codegen_create_dashboard'
+- Generating a Kafka consumer -> use 'codegen_create_kafka_consumer'
+- Generating a backend payload from a database table -> use 'codegen_generate_payload'
+
+This tool runs: npx restforge processor create --project=<project> --name=<name> --payload=<payload> [--database] [--force] [--skip-sql-validation] in the given cwd.
+
+Re-run behavior (important):
+- WITHOUT 'force': the endpoint router + metadata are regenerated, but the processor implementation file is SKIPPED ("custom code preserved") — safe to re-run to refresh routing without losing hand-written logic.
+- WITH 'force': the implementation file is archived first, then overwritten with a fresh scaffold — custom code survives only in the archive.
+
+Preconditions:
+- The project must have @restforgejs/platform installed in node_modules.
+- The named processor payload JSON must exist. This tool does not pre-check it — if the CLI fails, the failure response surfaces 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. "generate the processor", "regenerate the routing").
+- Speak in plain language; summarise the result. Do not paste raw CLI output unless the user explicitly asks.
+- If the user wants to overwrite existing custom implementation, warn that without archiving they would lose hand-written logic; 'force' archives the old file before overwriting.
+- 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)'),
+            project: z.string().min(1).describe('Target project name. REQUIRED.'),
+            name: z.string().min(1).describe('Processor name (also the endpoint name). REQUIRED.'),
+            payload: z
+                .string()
+                .min(1)
+                .describe('Path or file name of the processor payload JSON. REQUIRED.'),
+            database: z
+                .enum(['postgres', 'mysql', 'oracle', 'sqlite'])
+                .optional()
+                .describe('Database type. When omitted, the CLI uses its default (postgres / auto-detect).'),
+            force: z
+                .boolean()
+                .optional()
+                .describe('Archive then overwrite an existing processor implementation file. Without it, the implementation file is preserved (only routing/metadata regenerate).'),
+            skipSqlValidation: z
+                .boolean()
+                .optional()
+                .describe('Skip SQL keyword validation. When omitted, the CLI validates SQL as usual.'),
+        },
+        annotations: {
+            title: 'Create Processor Module',
+            readOnlyHint: false,
+            idempotentHint: false,
+            destructiveHint: false,
+        },
+    }, async ({ cwd, project, name, payload, database, force, skipSqlValidation }) => {
+        const projectCwd = resolve(cwd);
+        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 processor: ${name}
+Requested payload: ${payload}
+
+For the assistant:
+- The user needs to install the RESTForge package before a processor can be generated.
+- Suggest installing the package first, then retry. When explaining, say something like "the RESTForge package isn't installed yet — should I install it first?". Do not mention internal tool names.`,
+                    },
+                ],
+                isError: false,
+            };
+        }
+        const args = ['restforge', 'processor', 'create', `--project=${project}`, `--name=${name}`, `--payload=${payload}`];
+        if (database)
+            args.push(`--database=${database}`);
+        if (force)
+            args.push('--force');
+        if (skipSqlValidation)
+            args.push('--skip-sql-validation');
+        const result = await execProcess('npx', args, { cwd: projectCwd, timeout: 60_000 });
+        if (!result.success) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to create the processor.
+
+Project path: ${projectCwd}
+Project: ${project}
+Processor: ${name}
+Payload: ${payload}
+Command: ${result.command}
+Exit code: ${result.exitCode}
+
+--- CLI output ---
+stdout:
+${result.stdout}
+
+stderr:
+${result.stderr}
+--- end CLI output ---
+
+For the assistant:
+- Tell the user the processor was not generated successfully.
+- Summarise the most likely cause from the CLI output in plain language (common causes: the payload file was not found, the payload is invalid, SQL validation failed, or the target project does not exist). Do not paste raw output unless the user asks.
+- Offer to retry once the issue is resolved. Do not mention internal tool names.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Processor created.
+
+Project path: ${projectCwd}
+Project: ${project}
+Processor: ${name}
+Payload: ${payload}
+Force: ${force ? 'yes (old implementation archived then overwritten)' : 'no (existing implementation preserved)'}
+Command: ${result.command}
+
+--- CLI output ---
+${result.stdout}
+--- end CLI output ---
+
+For the assistant:
+- Confirm the processor was generated. Mention the endpoint routing/metadata was (re)generated.
+- If this was a re-run without force, note that any existing custom implementation was preserved. If force was used, note the old implementation was archived before being overwritten.
+- Keep the reply concise. Do not paste raw CLI output unless the user explicitly asks. Do not mention internal tool names.`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=create-processor.js.map

package/dist/tools/codegen/create-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-processor.js","sourceRoot":"","sources":["../../../src/tools/codegen/create-processor.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,8BAA8B,CAAC,MAAiB;IAC9D,MAAM,CAAC,YAAY,CACjB,0BAA0B,EAC1B;QACE,KAAK,EAAE,yBAAyB;QAChC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;uGA4BoF;QACjG,WAAW,EAAE;YACX,GAAG,EAAE,CAAC;iBACH,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,+FAA+F,CAAC;YAC5G,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gCAAgC,CAAC;YACrE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,oDAAoD,CAAC;YACtF,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,4DAA4D,CAAC;YACzE,QAAQ,EAAE,CAAC;iBACR,IAAI,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;iBAC/C,QAAQ,EAAE;iBACV,QAAQ,CAAC,iFAAiF,CAAC;YAC9F,KAAK,EAAE,CAAC;iBACL,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,wJAAwJ,CAAC;YACrK,iBAAiB,EAAE,CAAC;iBACjB,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,4EAA4E,CAAC;SAC1F;QACD,WAAW,EAAE;YACX,KAAK,EAAE,yBAAyB;YAChC,YAAY,EAAE,KAAK;YACnB,cAAc,EAAE,KAAK;YACrB,eAAe,EAAE,KAAK;SACvB;KACF,EACD,KAAK,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,iBAAiB,EAAE,EAAE,EAAE;QAC5E,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAEhC,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;;uBAEH,IAAI;qBACN,OAAO;;;;sMAI0K;qBACzL;iBACF;gBACD,OAAO,EAAE,KAAK;aACf,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,OAAO,EAAE,EAAE,UAAU,IAAI,EAAE,EAAE,aAAa,OAAO,EAAE,CAAC,CAAC;QACpH,IAAI,QAAQ;YAAE,IAAI,CAAC,IAAI,CAAC,cAAc,QAAQ,EAAE,CAAC,CAAC;QAClD,IAAI,KAAK;YAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAChC,IAAI,iBAAiB;YAAE,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QAE1D,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAEpF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;gBAEJ,UAAU;WACf,OAAO;aACL,IAAI;WACN,OAAO;WACP,MAAM,CAAC,OAAO;aACZ,MAAM,CAAC,QAAQ;;;;EAI1B,MAAM,CAAC,MAAM;;;EAGb,MAAM,CAAC,MAAM;;;;;;iFAMkE;qBACpE;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;gBAEF,UAAU;WACf,OAAO;aACL,IAAI;WACN,OAAO;SACT,KAAK,CAAC,CAAC,CAAC,oDAAoD,CAAC,CAAC,CAAC,wCAAwC;WACrG,MAAM,CAAC,OAAO;;;EAGvB,MAAM,CAAC,MAAM;;;;;;2HAM4G;iBAChH;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/codegen/generate-test.d.ts

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

package/dist/tools/codegen/generate-test.js

@@ -0,0 +1,149 @@
+import { z } from 'zod';
+import { access } from 'node:fs/promises';
+import { resolve, join } from 'node:path';
+import { execProcess } from '../../lib/exec.js';
+export function registerCodegenGenerateTest(server) {
+    server.registerTool('codegen_generate_test', {
+        title: 'Generate Integration Test',
+        description: `Generate a Jest + Supertest integration test file for an EXISTING endpoint, by wrapping restforge test generate.
+
+USE WHEN:
+- The user wants to generate, scaffold, or create an integration test for an existing endpoint, e.g. "generate test untuk endpoint", "buat integration test", "scaffold jest test", "create supertest test"
+- The user just generated an endpoint and now wants its test
+- The user wants to initialise the Jest test-data configuration for a project (with 'init')
+
+DO NOT USE FOR:
+- Generating the endpoint itself -> use 'codegen_create_endpoint'
+- Running the tests -> out of scope (the user runs the generated tests with their own test runner)
+- Validating a payload or SQL -> use 'codegen_validate_payload' / 'codegen_validate_sql'
+
+This tool runs: npx restforge test generate --project=<project> --endpoint=<endpoint> [--port] [--init] [--force] in the given cwd.
+
+Preconditions:
+- The project must have @restforgejs/platform installed in node_modules.
+- The named endpoint must already exist in the project. This tool does not pre-check it — if the CLI fails, the failure response surfaces 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. "generate the integration test").
+- Speak in plain language; summarise the result. Do not paste raw CLI output unless the user explicitly asks.
+- On the first test for a project, suggest using 'init' to set up the Jest test-data configuration.
+- 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)'),
+            project: z.string().min(1).describe('Target project name. REQUIRED.'),
+            endpoint: z.string().min(1).describe('Name of the existing endpoint to test. REQUIRED.'),
+            port: z
+                .number()
+                .int()
+                .min(1)
+                .max(65535)
+                .optional()
+                .describe('Server port used when the test runs. When omitted, the CLI uses its default (3000).'),
+            init: z
+                .boolean()
+                .optional()
+                .describe('Initialise the Jest test-data configuration (global + per-endpoint) if not present. Use on the first test for a project.'),
+            force: z
+                .boolean()
+                .optional()
+                .describe('Overwrite an existing test file. Without it, the command will not replace an existing test.'),
+        },
+        annotations: {
+            title: 'Generate Integration Test',
+            readOnlyHint: false,
+            idempotentHint: false,
+            destructiveHint: false,
+        },
+    }, async ({ cwd, project, endpoint, port, init, force }) => {
+        const projectCwd = resolve(cwd);
+        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 endpoint: ${endpoint}
+
+For the assistant:
+- The user needs to install the RESTForge package before an integration test can be generated.
+- Suggest installing the package first, then retry. When explaining, say something like "the RESTForge package isn't installed yet — should I install it first?". Do not mention internal tool names.`,
+                    },
+                ],
+                isError: false,
+            };
+        }
+        const args = ['restforge', 'test', 'generate', `--project=${project}`, `--endpoint=${endpoint}`];
+        if (port !== undefined)
+            args.push(`--port=${port}`);
+        if (init)
+            args.push('--init');
+        if (force)
+            args.push('--force');
+        const result = await execProcess('npx', args, { cwd: projectCwd, timeout: 60_000 });
+        if (!result.success) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to generate the integration test.
+
+Project path: ${projectCwd}
+Project: ${project}
+Endpoint: ${endpoint}
+Command: ${result.command}
+Exit code: ${result.exitCode}
+
+--- CLI output ---
+stdout:
+${result.stdout}
+
+stderr:
+${result.stderr}
+--- end CLI output ---
+
+For the assistant:
+- Tell the user the integration test was not generated successfully.
+- Summarise the most likely cause from the CLI output in plain language (common causes: the endpoint does not exist yet, the project does not exist, or an existing test blocks generation without force). Do not paste raw output unless the user asks.
+- Offer to retry once the issue is resolved. Do not mention internal tool names.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Integration test generated.
+
+Project path: ${projectCwd}
+Project: ${project}
+Endpoint: ${endpoint}
+Port: ${port ?? 'default (3000)'}
+Init: ${init ? 'yes' : 'no'}
+Command: ${result.command}
+
+--- CLI output ---
+${result.stdout}
+--- end CLI output ---
+
+For the assistant:
+- Confirm the Jest + Supertest integration test was generated for the endpoint.
+- Mention the user runs the test with their own test runner; this server does not run it.
+- Keep the reply concise. Do not paste raw CLI output unless the user explicitly asks. Do not mention internal tool names.`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=generate-test.js.map

package/dist/tools/codegen/generate-test.js.map

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

package/dist/tools/codegen/index.js

@@ -8,6 +8,9 @@ import { registerCodegenGetQueryDeclarativeCatalog } from './get-query-declarati
 import { registerCodegenGetDashboardCatalog } from './get-dashboard-catalog.js';
 import { registerCodegenCreateEndpoint } from './create-endpoint.js';
 import { registerCodegenCreateDashboard } from './create-dashboard.js';
+import { registerCodegenCreateProcessor } from './create-processor.js';
+import { registerCodegenCreateKafkaConsumer } from './create-kafka-consumer.js';
+import { registerCodegenGenerateTest } from './generate-test.js';
 import { registerCodegenValidateDashboardPayload } from './validate-dashboard-payload.js';
 import { registerCodegenListTables } from './list-tables.js';
 import { registerCodegenDescribeTable } from './describe-table.js';
@@ -33,6 +36,9 @@ export function registerCodegenTools(server) {
     registerCodegenGetDashboardCatalog(server);
     registerCodegenCreateEndpoint(server);
     registerCodegenCreateDashboard(server);
+    registerCodegenCreateProcessor(server);
+    registerCodegenCreateKafkaConsumer(server);
+    registerCodegenGenerateTest(server);
     registerCodegenValidateDashboardPayload(server);
     registerCodegenListTables(server);
     registerCodegenDescribeTable(server);

package/dist/tools/codegen/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/codegen/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,wCAAwC,EAAE,MAAM,mCAAmC,CAAC;AAC7F,OAAO,EAAE,yCAAyC,EAAE,MAAM,oCAAoC,CAAC;AAC/F,OAAO,EAAE,kCAAkC,EAAE,MAAM,4BAA4B,CAAC;AAChF,OAAO,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,uCAAuC,EAAE,MAAM,iCAAiC,CAAC;AAC1F,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,iCAAiC,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,kCAAkC,EAAE,MAAM,4BAA4B,CAAC;AAChF,OAAO,EAAE,iCAAiC,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AAEzE,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,8BAA8B,CAAC,MAAM,CAAC,CAAC;IACvC,8BAA8B,CAAC,MAAM,CAAC,CAAC;IACvC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACnC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACnC,6BAA6B,CAAC,MAAM,CAAC,CAAC;IACtC,wCAAwC,CAAC,MAAM,CAAC,CAAC;IACjD,yCAAyC,CAAC,MAAM,CAAC,CAAC;IAClD,kCAAkC,CAAC,MAAM,CAAC,CAAC;IAC3C,6BAA6B,CAAC,MAAM,CAAC,CAAC;IACtC,8BAA8B,CAAC,MAAM,CAAC,CAAC;IACvC,uCAAuC,CAAC,MAAM,CAAC,CAAC;IAChD,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAClC,4BAA4B,CAAC,MAAM,CAAC,CAAC;IACrC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACnC,iCAAiC,CAAC,MAAM,CAAC,CAAC;IAC1C,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACpC,+BAA+B,CAAC,MAAM,CAAC,CAAC;IACxC,6BAA6B,CAAC,MAAM,CAAC,CAAC;IACtC,kCAAkC,CAAC,MAAM,CAAC,CAAC;IAC3C,iCAAiC,CAAC,MAAM,CAAC,CAAC;IAC1C,8BAA8B,CAAC,MAAM,CAAC,CAAC;IACvC,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACpC,4BAA4B,CAAC,MAAM,CAAC,CAAC;IACrC,+BAA+B,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/codegen/index.ts"],"names":[],"mappings":"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"}

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

@@ -7,7 +7,10 @@ export function registerCodegenMigratePayload(server) {
         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.
 
+PRIMARY PATH TO CREATE A UDF (firm): this is the FIRST and preferred way to produce a UDF. RESTForge is backend-first — a UDF is normally DERIVED from an existing backend RDF via this tool, not written by hand. Whenever a backend RDF payload exists and the user wants a UDF/frontend, START HERE. Only hand-author a UDF from scratch (grounded by 'designer_get_udf_catalog') when there is genuinely no RDF to migrate from.
+
 USE WHEN:
+- The user wants to CREATE or start a frontend UDF and a backend RDF payload exists — this is the default on-ramp, before any hand-authoring
 - 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