@restforgejs/mcp-server 1.2.0

package/dist/tools/setup/get-init-template.js

@@ -0,0 +1,130 @@
+import { z } from 'zod';
+import { access } from 'node:fs/promises';
+import { resolve, join } from 'node:path';
+import { execProcess } from '../../lib/exec.js';
+export function registerSetupGetInitTemplate(server) {
+    server.registerTool('setup_get_init_template', {
+        title: 'Get Init Template',
+        description: `Get raw template content of db-connection.env without writing any file.
+Useful as reference after current file has been modified, or for comparing
+current config against template defaults (drift detection).
+
+USE WHEN:
+- The agent needs to see template defaults after the current file has been modified
+- Comparing current config with template (drift detection)
+- Restoring template content reference without re-running init
+- The user asks things like "show me the default template", "lihat template config default",
+  "apa isi template defaultnya", "what does the default config look like",
+  "bandingkan dengan template asli", "compare against the original template"
+
+DO NOT USE FOR:
+- Generating new config files in the project -> use 'setup_init_config'
+- Reading current config -> use 'setup_read_env'
+- Getting structured schema (JSON) -> use 'setup_get_config_schema'
+
+This tool runs: npx restforge config:template in the given cwd.
+This tool is READ-ONLY and safe to call repeatedly. No file is written.
+Requires @restforgejs/platform >= 2.3.1.
+
+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. "install the package", "set up the initial config", "show the active configuration").
+- Speak in plain language. Summarise what the template contains (sections present, total parameters); do not paste the entire template body unless the user explicitly asks for it.
+- When a precondition is not met (e.g. the package is not installed), frame it as a question or next-step suggestion rather than an error.`,
+        inputSchema: {
+            cwd: z.string().min(1).describe('Absolute path of the project folder (must have @restforgejs/platform installed in node_modules)'),
+        },
+        annotations: {
+            title: 'Get Init Template',
+            readOnlyHint: true,
+            idempotentHint: true,
+        },
+    }, async ({ cwd }) => {
+        const projectCwd = resolve(cwd);
+        // Precondition check: @restforgejs/platform must be installed before this CLI command can run.
+        // 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
+
+For the assistant:
+- The default config template can only be retrieved once the RESTForge package is installed locally.
+- Suggest installing the package first, then retry getting the template.
+- 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
+            };
+        }
+        // Run subprocess with NODE_ENV=production to suppress legacy banner output.
+        // stripFinalNewline=false to preserve byte-perfect template content
+        // (matches the trailing newline in db-connection.env file written by `restforge init`).
+        const result = await execProcess('npx', ['restforge', 'config', 'template'], {
+            cwd: projectCwd,
+            timeout: 15_000,
+            env: { NODE_ENV: 'production' },
+            stripFinalNewline: false,
+        });
+        // CLI failure: real error per §3.4; structured per §3.5.
+        if (!result.success) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to retrieve the configuration template.
+
+Project path: ${projectCwd}
+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 default template could not be retrieved.
+- A common cause is an older RESTForge version that does not yet expose the template command (requires @restforgejs/platform >= 2.3.1). Suggest upgrading the package as a likely fix.
+- Do not paste the raw stdout/stderr unless the user explicitly asks. Do not mention internal tool names.`,
+                    },
+                ],
+                isError: true, // per §3.4
+            };
+        }
+        // Success: one-line summary + labeled facts + fenced template body per §3.5.
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Configuration template retrieved successfully.
+
+Project path: ${projectCwd}
+Source: restforge (matches the template that 'init' would write into config/db-connection.env)
+Note: this is a read-only preview; no file was written.
+
+--- Template (db-connection.env) ---
+${result.stdout}--- end Template (db-connection.env) ---
+
+For the assistant:
+- Confirm to the user that the default template is available.
+- Summarise the template in plain language: which sections are present (database, license, optional Live Sync / Redis / Kafka / Logging) and the total parameter count.
+- Do not paste the full template body unless the user explicitly asks for it. If the user is doing drift detection, the full template content is available between the fenced markers above for programmatic comparison.
+- Do not mention internal tool names.`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=get-init-template.js.map

package/dist/tools/setup/get-init-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-init-template.js","sourceRoot":"","sources":["../../../src/tools/setup/get-init-template.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,4BAA4B,CAAC,MAAiB;IAC5D,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;2IAyBwH;QACrI,WAAW,EAAE;YACX,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,iGAAiG,CAAC;SACnI;QACD,WAAW,EAAE;YACX,KAAK,EAAE,mBAAmB;YAC1B,YAAY,EAAE,IAAI;YAClB,cAAc,EAAE,IAAI;SACrB;KACF,EACD,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;QAChB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAEhC,+FAA+F;QAC/F,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;;;;;;gKAMsI;qBACnJ;iBACF;gBACD,OAAO,EAAE,KAAK,EAAE,WAAW;aAC5B,CAAC;QACJ,CAAC;QAED,4EAA4E;QAC5E,oEAAoE;QACpE,wFAAwF;QACxF,MAAM,MAAM,GAAG,MAAM,WAAW,CAC9B,KAAK,EACL,CAAC,WAAW,EAAE,QAAQ,EAAE,UAAU,CAAC,EACnC;YACE,GAAG,EAAE,UAAU;YACf,OAAO,EAAE,MAAM;YACf,GAAG,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE;YAC/B,iBAAiB,EAAE,KAAK;SACzB,CACF,CAAC;QAEF,yDAAyD;QACzD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;gBAEJ,UAAU;WACf,MAAM,CAAC,OAAO;aACZ,MAAM,CAAC,QAAQ;;;;EAI1B,MAAM,CAAC,MAAM;;;EAGb,MAAM,CAAC,MAAM;;;;;;0GAM2F;qBAC7F;iBACF;gBACD,OAAO,EAAE,IAAI,EAAE,WAAW;aAC3B,CAAC;QACJ,CAAC;QAED,6EAA6E;QAC7E,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;gBAEF,UAAU;;;;;EAKxB,MAAM,CAAC,MAAM;;;;;;sCAMuB;iBAC3B;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/setup/index.d.ts

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

package/dist/tools/setup/index.js

@@ -0,0 +1,21 @@
+import { registerSetupCreateFolder } from './create-folder.js';
+import { registerSetupInstallPackage } from './install-package.js';
+import { registerSetupInitConfig } from './init-config.js';
+import { registerSetupWriteEnv } from './write-env.js';
+import { registerSetupReadEnv } from './read-env.js';
+import { registerSetupUpdateEnv } from './update-env.js';
+import { registerSetupValidateConfig } from './validate-config.js';
+import { registerSetupGetConfigSchema } from './get-config-schema.js';
+import { registerSetupGetInitTemplate } from './get-init-template.js';
+export function registerSetupTools(server) {
+    registerSetupCreateFolder(server);
+    registerSetupInstallPackage(server);
+    registerSetupInitConfig(server);
+    registerSetupWriteEnv(server);
+    registerSetupReadEnv(server);
+    registerSetupUpdateEnv(server);
+    registerSetupValidateConfig(server);
+    registerSetupGetConfigSchema(server);
+    registerSetupGetInitTemplate(server);
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/setup/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAEtE,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAClC,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACpC,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAChC,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACpC,4BAA4B,CAAC,MAAM,CAAC,CAAC;IACrC,4BAA4B,CAAC,MAAM,CAAC,CAAC;AACvC,CAAC"}

package/dist/tools/setup/init-config.d.ts

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

package/dist/tools/setup/init-config.js

@@ -0,0 +1,120 @@
+import { z } from 'zod';
+import { access } from 'node:fs/promises';
+import { resolve, join } from 'node:path';
+import { execProcess } from '../../lib/exec.js';
+export function registerSetupInitConfig(server) {
+    server.registerTool('setup_init_config', {
+        title: 'Init RESTForge Config',
+        description: `Generate skeleton config and sample payloads in the project folder via restforge.
+
+USE WHEN:
+- The project has @restforgejs/platform installed in node_modules
+- The config/ and payload/ folders do not exist yet, or you want to reset them to the default template
+- Starting RESTForge project configuration from scratch
+
+DO NOT USE FOR:
+- Installing @restforgejs/platform -> use 'setup_install_package'
+- Filling in credentials in db-connection.env -> use 'setup_write_env'
+
+This tool runs: npx restforge init in the given cwd.
+Output: config/db-connection.env (empty template), payload/samples.json, payload/query/samples-datatables.sql.
+
+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. "install the package", "fill in the credentials").
+- Speak in plain language. Summarise the result; 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 project folder'),
+        },
+        annotations: {
+            title: 'Init Config',
+            readOnlyHint: false,
+            idempotentHint: false,
+        },
+    }, async ({ cwd }) => {
+        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
+
+For the assistant:
+- The user needs to install the RESTForge package before the initial config can be generated.
+- Use the appropriate package-installation tool to do this, then retry generating the config.
+- 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,
+            };
+        }
+        const result = await execProcess('npx', ['restforge', 'init'], { cwd: projectCwd, timeout: 30_000 });
+        // CLI failure: real error per §3.4; structured per §3.5.
+        if (!result.success) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to generate the initial RESTForge configuration.
+
+Project path: ${projectCwd}
+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 initialisation command did not complete successfully.
+- Summarise the likely cause from the CLI output in plain language; do not paste the raw stdout/stderr unless the user explicitly asks for it.
+- Offer to retry once the underlying issue is resolved. Do not mention internal tool names.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Success: one-line summary + labeled facts + fenced raw output per §3.5.
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Initial RESTForge configuration generated successfully.
+
+Project path: ${projectCwd}
+Files created:
+- config/db-connection.env (empty template, awaiting credentials)
+- payload/samples.json
+- payload/query/samples-datatables.sql
+
+--- CLI output ---
+${result.stdout}
+--- end CLI output ---
+
+For the assistant:
+- Confirm to the user that the project skeleton is ready.
+- Suggest the next step in plain words: the credentials file (license and database connection) still needs to be filled in before the project can run.
+- Keep the reply concise. Do not paste the raw CLI output unless the user explicitly asks. Do not mention internal tool names.`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=init-config.js.map

package/dist/tools/setup/init-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-config.js","sourceRoot":"","sources":["../../../src/tools/setup/init-config.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,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EAAE;;;;;;;;;;;;;;;;;;uGAkBoF;QACjG,WAAW,EAAE;YACX,GAAG,EAAE,CAAC;iBACH,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,qCAAqC,CAAC;SACnD;QACD,WAAW,EAAE;YACX,KAAK,EAAE,aAAa;YACpB,YAAY,EAAE,KAAK;YACnB,cAAc,EAAE,KAAK;SACtB;KACF,EACD,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;QAChB,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;;;;;;gKAMsI;qBACnJ;iBACF;gBACD,OAAO,EAAE,KAAK;aACf,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,WAAW,CAC9B,KAAK,EACL,CAAC,WAAW,EAAE,MAAM,CAAC,EACrB,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,CACrC,CAAC;QAEF,yDAAyD;QACzD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;gBAEJ,UAAU;WACf,MAAM,CAAC,OAAO;aACZ,MAAM,CAAC,QAAQ;;;;EAI1B,MAAM,CAAC,MAAM;;;EAGb,MAAM,CAAC,MAAM;;;;;;4FAM6E;qBAC/E;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,0EAA0E;QAC1E,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;gBAEF,UAAU;;;;;;;EAOxB,MAAM,CAAC,MAAM;;;;;;+HAMgH;iBACpH;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/setup/install-package.d.ts

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

package/dist/tools/setup/install-package.js

@@ -0,0 +1,133 @@
+import { z } from 'zod';
+import { access } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { execProcess } from '../../lib/exec.js';
+export function registerSetupInstallPackage(server) {
+    server.registerTool('setup_install_package', {
+        title: 'Install @restforgejs/platform Package',
+        description: `Install the @restforgejs/platform package into the project's node_modules via npm.
+
+USE WHEN:
+- The user wants to install RESTForge (@restforgejs/platform) into a project
+- The project folder exists but does not yet have @restforgejs/platform in node_modules
+- Setting up a new project before the configuration stage
+- Updating @restforgejs/platform to a specific tag or version
+- The user says things like "install restforge", "tambahkan @restforgejs/platform",
+  "pasang package restforge", "set up the package", "siapkan project ini",
+  "upgrade @restforgejs/platform", "ganti versi restforge"
+
+DO NOT USE FOR:
+- Creating a new project folder -> use 'setup_create_folder'
+- Generating config skeleton -> use 'setup_init_config'
+- Filling in credentials -> use 'setup_write_env'
+- Validating the configuration -> use 'setup_validate_config'
+
+This tool sits in the middle of the new-project setup chain: typically run
+after 'setup_create_folder' creates the project folder, and before
+'setup_init_config' which generates the configuration skeleton. 'setup_init_config'
+will return a precondition message if this tool has not been run first. // per §5.2
+
+This tool runs: npm install @restforgejs/platform@<version> in the given cwd (local install, not global).
+Default version is "beta" because RESTForge is currently a public pre-release. Use "latest" once stable, or a specific version (e.g. "1.2.3").
+
+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. "create the project folder", "generate the initial config", "fill in the credentials").
+- Speak in plain language. Summarise the result; do not paste raw npm output unless the user explicitly asks.
+- When a precondition is not met (e.g. the project folder is missing), frame it as a question or next-step suggestion rather than an error.`,
+        inputSchema: {
+            cwd: z
+                .string()
+                .min(1)
+                .describe('Absolute path of the project folder (must exist before this tool runs)'),
+            version: z
+                .string()
+                .default('beta')
+                .describe('npm version or tag: "beta" (default), "latest", or a specific version (e.g. "1.2.3")'),
+        },
+        annotations: {
+            title: 'Install @restforgejs/platform',
+            readOnlyHint: false,
+            idempotentHint: true,
+        },
+    }, async ({ cwd, version }) => {
+        const projectCwd = resolve(cwd);
+        // Precondition check: the project folder must exist.
+        // Treated as a non-error precondition per the authoring guide §3.4.
+        try {
+            await access(projectCwd);
+        }
+        catch {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Precondition not met: the project folder does not exist yet.
+
+Project path: ${projectCwd}
+
+For the assistant:
+- The user is trying to install the RESTForge package into a folder that has not been created yet.
+- Suggest creating the project folder first, then retry the installation.
+- When explaining to the user, say something like "the project folder isn't there yet — should I create it first?". Do not mention internal tool names.`,
+                    },
+                ],
+                isError: false, // per §3.4
+            };
+        }
+        const result = await execProcess('npm', ['install', `@restforgejs/platform@${version}`], { cwd: projectCwd, timeout: 180_000 });
+        // CLI failure: real error per §3.4; structured per §3.5.
+        if (!result.success) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to install the RESTForge package.
+
+Project path: ${projectCwd}
+Requested version: ${version}
+Command: ${result.command}
+Exit code: ${result.exitCode}
+
+--- npm output ---
+stdout:
+${result.stdout}
+
+stderr:
+${result.stderr}
+--- end npm output ---
+
+For the assistant:
+- Tell the user that the installation did not complete successfully.
+- Summarise the likely cause from the npm output in plain language (network, registry, version not found, peer dependency); do not paste the raw stdout/stderr unless the user explicitly asks.
+- Offer to retry once the underlying issue is resolved. Do not mention internal tool names.`,
+                    },
+                ],
+                isError: true, // per §3.4
+            };
+        }
+        // Success: one-line summary + labeled facts + fenced raw output per §3.5.
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `RESTForge package installed successfully.
+
+Project path: ${projectCwd}
+Installed version: @restforgejs/platform@${version}
+Install location: node_modules/@restforgejs/platform
+
+--- npm output ---
+${result.stdout}
+--- end npm output ---
+
+For the assistant:
+- Confirm to the user that the RESTForge package is installed in this project.
+- Suggest the next step in plain words: generating the initial configuration skeleton (config and payload templates) so the project can be configured.
+- Keep the reply concise. Do not paste the raw npm output unless the user explicitly asks. Do not mention internal tool names.`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=install-package.js.map

package/dist/tools/setup/install-package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-package.js","sourceRoot":"","sources":["../../../src/tools/setup/install-package.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,UAAU,2BAA2B,CAAC,MAAiB;IAC3D,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,KAAK,EAAE,uCAAuC;QAC9C,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4IA6ByH;QACtI,WAAW,EAAE;YACX,GAAG,EAAE,CAAC;iBACH,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,wEAAwE,CAAC;YACrF,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,OAAO,CAAC,MAAM,CAAC;iBACf,QAAQ,CAAC,sFAAsF,CAAC;SACpG;QACD,WAAW,EAAE;YACX,KAAK,EAAE,+BAA+B;YACtC,YAAY,EAAE,KAAK;YACnB,cAAc,EAAE,IAAI;SACrB;KACF,EACD,KAAK,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE;QACzB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAEhC,qDAAqD;QACrD,oEAAoE;QACpE,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;gBAEJ,UAAU;;;;;wJAK8H;qBAC3I;iBACF;gBACD,OAAO,EAAE,KAAK,EAAE,WAAW;aAC5B,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,WAAW,CAC9B,KAAK,EACL,CAAC,SAAS,EAAE,yBAAyB,OAAO,EAAE,CAAC,EAC/C,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,CACtC,CAAC;QAEF,yDAAyD;QACzD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;gBAEJ,UAAU;qBACL,OAAO;WACjB,MAAM,CAAC,OAAO;aACZ,MAAM,CAAC,QAAQ;;;;EAI1B,MAAM,CAAC,MAAM;;;EAGb,MAAM,CAAC,MAAM;;;;;;4FAM6E;qBAC/E;iBACF;gBACD,OAAO,EAAE,IAAI,EAAE,WAAW;aAC3B,CAAC;QACJ,CAAC;QAED,0EAA0E;QAC1E,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;gBAEF,UAAU;2CACiB,OAAO;;;;EAIhD,MAAM,CAAC,MAAM;;;;;;+HAMgH;iBACpH;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/setup/read-env.d.ts

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

package/dist/tools/setup/read-env.js

@@ -0,0 +1,138 @@
+import { z } from 'zod';
+import { readFile, access } from 'node:fs/promises';
+import { resolve, join } from 'node:path';
+import { parseEnvFile, isSensitiveKey, maskValue } from '../../lib/env-parser.js';
+export function registerSetupReadEnv(server) {
+    server.registerTool('setup_read_env', {
+        title: 'Read Database Connection Env',
+        description: `Read and parse the config/db-connection.env file, returning all parameters as KEY=value lines. Sensitive fields (LICENSE, DB_PASSWORD, REDIS_PASSWORD, KAFKA_SASL_PASSWORD) are masked by default.
+
+USE WHEN:
+- The user asks to see the active/current configuration, parameters, 
+  settings, or env values of a RESTForge project
+- The user asks questions like "tampilkan parameter yang aktif", 
+  "config apa yang sudah di-set", "show current settings", "cek konfigurasi", 
+  "what's configured in this project"
+- Verifying the current configuration before calling 'setup_write_env' or 
+  'setup_update_env' to make changes
+- Auditing the active config after a change
+- Listing every parameter present in the file (including optional sections 
+  like Live Sync, Redis, Kafka, Logging)
+- Checking whether a RESTForge project has been set up at all (this tool 
+  returns a clear "file not found" precondition if not)
+
+DO NOT USE FOR:
+- Writing values -> use 'setup_write_env' or 'setup_update_env'
+- Validating connection -> use 'setup_validate_config'
+
+This tool is READ-ONLY and safe to call repeatedly. Pass unmask=true to see real values of sensitive fields (use with care).
+
+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. "set up the initial config", "fill in the credentials", "update a single value", "validate the connection").
+- Speak in plain language. Summarise the result; do not paste the full KEY=value list unless the user explicitly asks for it.
+- Even when unmask=true, do not echo sensitive values (license keys, passwords) into chat unless the user explicitly asks. Prefer to confirm presence and length only.
+- When a precondition is not met (e.g. config file is missing), frame it as a question or next-step suggestion rather than an error.`,
+        inputSchema: {
+            cwd: z.string().min(1).describe('Absolute path of the project folder'),
+            configFile: z
+                .string()
+                .default('db-connection.env')
+                .describe('Config file name in the config/ folder. Default: db-connection.env'),
+            unmask: z
+                .boolean()
+                .default(false)
+                .describe('When true, show real values of sensitive fields (LICENSE, *_PASSWORD). Default: false'),
+        },
+        annotations: {
+            title: 'Read Env Config',
+            readOnlyHint: true,
+            idempotentHint: true,
+        },
+    }, async ({ cwd, configFile, unmask }) => {
+        const projectCwd = resolve(cwd);
+        const envPath = join(projectCwd, 'config', configFile);
+        // Precondition check: the config file must exist before it can be read.
+        // Treated as a non-error precondition per the authoring guide §3.4.
+        try {
+            await access(envPath);
+        }
+        catch {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Precondition not met: the configuration file does not exist yet.
+
+Project path: ${projectCwd}
+Expected file: ${envPath}
+
+For the assistant:
+- The user is trying to read a configuration that has not been created yet.
+- Suggest generating the initial RESTForge configuration first, then retry reading it.
+- When explaining to the user, say something like "the configuration file isn't there yet — should I set up the initial config first?". Do not mention internal tool names.`,
+                    },
+                ],
+                isError: false,
+            };
+        }
+        // Real I/O failure: surface as error per §3.4.
+        let content;
+        try {
+            content = await readFile(envPath, 'utf-8');
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to read the configuration file.
+
+Project path: ${projectCwd}
+File: ${envPath}
+Reason: ${msg}
+
+For the assistant:
+- Tell the user that the configuration file exists but could not be read.
+- Summarise the likely cause (permissions, file lock, encoding) in plain language; do not paste the raw error unless the user explicitly asks.
+- Offer to retry once the underlying issue is resolved. Do not mention internal tool names.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const entries = parseEnvFile(content);
+        const kvEntries = entries.filter((e) => e.kind === 'kv');
+        // Success: one-line summary + labeled facts + fenced parameter block per §3.5.
+        const paramLines = [];
+        for (const entry of kvEntries) {
+            const displayValue = !unmask && isSensitiveKey(entry.key) ? maskValue(entry.value) : entry.value;
+            paramLines.push(`${entry.key}=${displayValue}`);
+        }
+        const sensitiveNote = unmask
+            ? 'Sensitive fields: UNMASKED (real values present in the parameter block below).'
+            : 'Sensitive fields masked: LICENSE, DB_PASSWORD, REDIS_PASSWORD, KAFKA_SASL_PASSWORD.';
+        const text = `Configuration file read successfully.
+
+Project path: ${projectCwd}
+File: ${envPath}
+Total parameters: ${kvEntries.length}
+${sensitiveNote}
+
+--- Parameters ---
+${paramLines.join('\n')}
+--- end Parameters ---
+
+For the assistant:
+- Confirm to the user that the configuration was read successfully.
+- Summarise in plain language: how many parameters are set, and which key sections appear to be configured (e.g. database, license, optional Redis/Kafka/Live Sync).
+- Do not paste the full parameter block unless the user explicitly asks to see every value.
+- ${unmask
+            ? 'Sensitive values are unmasked in the parameter block. Do NOT echo license keys or passwords into chat. Only confirm their presence (or length) unless the user explicitly asks for the literal value.'
+            : 'Sensitive values are masked. If the user wants to verify a real value, suggest re-running with the unmask option enabled.'}
+- Do not mention internal tool names.`;
+        return { content: [{ type: 'text', text }] };
+    });
+}
+//# sourceMappingURL=read-env.js.map

package/dist/tools/setup/read-env.js.map

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

package/dist/tools/setup/update-env.d.ts

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