@restforgejs/mcp-server 1.2.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+# MIT License
+
+Copyright (c) 2026 restforge
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,149 @@
+# @restforgejs/mcp-server
+
+MCP (Model Context Protocol) server for the RESTForge framework. Exposes RESTForge capabilities to AI Agents (Claude Desktop, Cursor, Claude CLI, and other MCP clients) so agents can operate RESTForge through natural language without manually invoking CLI commands.
+
+## Requirements
+
+- Node.js >= 18
+- npm >= 9
+- For full setup workflow: PostgreSQL / MySQL / Oracle / SQLite, RESTForge license key
+
+## Installation
+
+```bash
+npm install -g @restforgejs/mcp-server
+```
+
+After installation, the `restforge-mcp` command is available in PATH.
+
+## Quick Start
+
+### 1. Verify Install
+
+```bash
+echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | restforge-mcp
+```
+
+Output should list 29 tools across the `health_*`, `setup_*`, `codegen_*`, and `runtime_*` domains.
+
+### 2. Register with MCP Client
+
+**Claude CLI** (user scope, applies to all projects):
+
+```bash
+claude mcp add --transport stdio --scope user restforge -- restforge-mcp
+```
+
+**Cursor** (`.cursor/mcp.json` in project root):
+
+```json
+{
+  "mcpServers": {
+    "restforge": {
+      "command": "restforge-mcp"
+    }
+  }
+}
+```
+
+**Claude Desktop** (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "restforge": {
+      "command": "restforge-mcp"
+    }
+  }
+}
+```
+
+### 3. Use via Natural Language
+
+In your AI client chat, type prompts like:
+
+> Setup a new RESTForge project at `d:/projects/api-test` with PostgreSQL on localhost:5432, license `XXXX-XXXX-XXXX-XXXX`
+
+> Generate a CRUD endpoint for the `customer` table
+
+> Run my RESTForge server (the agent generates a launcher script for the user to execute)
+
+The agent orchestrates the appropriate tools to fulfill the request end-to-end.
+
+## Available Tools
+
+29 tools organized by domain. AI agents call these via the MCP protocol; end users do not invoke them directly.
+
+### Health Domain (1 tool)
+
+| Tool | Description |
+|------|-------------|
+| `health_ping` | Smoke test MCP transport. Returns `pong` + ISO timestamp + server version |
+
+### Setup Domain (9 tools)
+
+| Tool | Description |
+|------|-------------|
+| `setup_create_folder` | Create a new project folder for RESTForge |
+| `setup_install_package` | Install `@restforgejs/platform` into the project's `node_modules` via npm |
+| `setup_init_config` | Generate skeleton config and sample payloads via `restforge init` |
+| `setup_write_env` | Write `config/db-connection.env` with license, server, and database settings |
+| `setup_read_env` | Read current values from `config/db-connection.env` |
+| `setup_update_env` | Update individual fields in `config/db-connection.env` |
+| `setup_validate_config` | Validate license and connections to database, redis, and kafka |
+| `setup_get_config_schema` | Get JSON schema of all 63 parameters available in `db-connection.env` |
+| `setup_get_init_template` | Get raw `db-connection.env` template content |
+
+### Codegen Domain (13 tools)
+
+| Tool | Description |
+|------|-------------|
+| `codegen_list_tables` | List all tables in the project's database (live introspection) |
+| `codegen_describe_table` | Describe columns, primary key, and foreign keys of a specific table |
+| `codegen_generate_payload` | Generate payload JSON from a database table |
+| `codegen_validate_payload` | Validate payload JSON structure and constraints |
+| `codegen_validate_dashboard_payload` | Validate dashboard payload structure |
+| `codegen_diff_payload` | Diff payload JSON against the database schema |
+| `codegen_sync_payload` | Sync payload JSON with the database schema |
+| `codegen_create_endpoint` | Scaffold an endpoint module from a payload spec |
+| `codegen_create_dashboard` | Scaffold a dashboard module from a payload spec |
+| `codegen_validate_sql` | Validate a SELECT or WITH (CTE) SQL statement via EXPLAIN against the live database |
+| `codegen_get_field_validation_catalog` | Get the field validation catalog (for grounding payload constraints) |
+| `codegen_get_query_declarative_catalog` | Get the query declarative catalog (for grounding query JSON) |
+| `codegen_get_dashboard_catalog` | Get the dashboard widget catalog (for grounding dashboard config) |
+
+### Runtime Domain (6 tools)
+
+| Tool | Description |
+|------|-------------|
+| `runtime_detect_project` | Scan `src/modules/*.js` to list project names |
+| `runtime_detect_config` | Scan `config/*.env` to list available config files |
+| `runtime_validate_preflight` | Validate config + check PID file + check port availability before launch |
+| `runtime_check_launcher_exists` | Check if launcher files (`server-start.bat`/`.sh`, `ecosystem.config.js`) exist in the project root |
+| `runtime_generate_launcher` | Generate `server-start.bat`/`.sh` + `server-stop.bat`/`.sh` (and `ecosystem.config.js` for PM2 mode) |
+| `runtime_check_status` | Detect if the server is running (host or PM2 mode) with optional HTTP health probe |
+
+> **Runtime principle**: AI agents never start, stop, or restart the server directly. The runtime tools only generate launcher scripts that the user executes themselves, so the running server lives independently of the AI session.
+
+## Compatibility
+
+This MCP server works with any MCP client that supports the stdio transport, including but not limited to:
+
+- Claude Desktop
+- Claude CLI (Claude Code)
+- Cursor
+- Windsurf
+- Cline (VS Code extension)
+- Continue (VS Code/JetBrains extension)
+- Zed
+
+The model used (Claude, GPT, Gemini, etc.) depends on the client configuration. Tool selection accuracy is best with frontier models that have mature tool-calling support.
+
+## Repository
+
+- Source: [https://github.com/restforge-dev/mcp-server](https://github.com/restforge-dev/mcp-server)
+- Issues: [https://github.com/restforge-dev/mcp-server/issues](https://github.com/restforge-dev/mcp-server/issues)
+
+## License
+
+MIT — see [LICENSE.md](LICENSE.md).

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { startServer } from './server.js';
+startServer().catch((error) => {
+    console.error('[restforge-mcp] Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC5B,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;IACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/lib/env-parser.d.ts

@@ -0,0 +1,30 @@
+export type EnvEntry = {
+    kind: 'kv';
+    key: string;
+    value: string;
+    commentInline?: string;
+} | {
+    kind: 'comment';
+    text: string;
+} | {
+    kind: 'blank';
+};
+export type EnvFieldValue = string | number | boolean;
+export declare function parseEnvFile(content: string): EnvEntry[];
+export declare function serializeEnvFile(entries: EnvEntry[]): string;
+export interface MergeResult {
+    entries: EnvEntry[];
+    updated: Array<{
+        key: string;
+        before: string;
+        after: string;
+    }>;
+    added: Array<{
+        key: string;
+        value: string;
+    }>;
+    unchanged: string[];
+}
+export declare function mergeEnvEntries(existing: EnvEntry[], updates: Record<string, EnvFieldValue>): MergeResult;
+export declare function isSensitiveKey(key: string): boolean;
+export declare function maskValue(value: string): string;

package/dist/lib/env-parser.js

@@ -0,0 +1,150 @@
+const KV_REGEX = /^\s*([A-Za-z_][A-Za-z0-9_]*)\s*=(.*)$/;
+function stripQuotes(raw) {
+    const trimmed = raw.trim();
+    if (trimmed.length >= 2) {
+        const first = trimmed[0];
+        const last = trimmed[trimmed.length - 1];
+        if ((first === '"' && last === '"') || (first === "'" && last === "'")) {
+            return trimmed.slice(1, -1);
+        }
+    }
+    return trimmed;
+}
+function splitInlineComment(rawValue) {
+    const trimmed = rawValue.trimStart();
+    if (trimmed.startsWith('"') || trimmed.startsWith("'")) {
+        const quote = trimmed[0];
+        const closingIdx = trimmed.indexOf(quote, 1);
+        if (closingIdx !== -1) {
+            const afterQuote = trimmed.slice(closingIdx + 1);
+            const hashIdx = afterQuote.indexOf('#');
+            if (hashIdx !== -1) {
+                return {
+                    value: trimmed.slice(0, closingIdx + 1),
+                    comment: afterQuote.slice(hashIdx + 1).trim(),
+                };
+            }
+            return { value: trimmed };
+        }
+        return { value: trimmed };
+    }
+    const hashIdx = trimmed.indexOf(' #');
+    if (hashIdx !== -1) {
+        return {
+            value: trimmed.slice(0, hashIdx).trimEnd(),
+            comment: trimmed.slice(hashIdx + 2).trim(),
+        };
+    }
+    return { value: trimmed.trimEnd() };
+}
+export function parseEnvFile(content) {
+    const lines = content.split(/\r?\n/);
+    const entries = [];
+    const lastIsTrailingNewline = lines.length > 0 && lines[lines.length - 1] === '';
+    const effectiveLines = lastIsTrailingNewline ? lines.slice(0, -1) : lines;
+    for (const rawLine of effectiveLines) {
+        const trimmed = rawLine.trim();
+        if (trimmed === '') {
+            entries.push({ kind: 'blank' });
+            continue;
+        }
+        if (trimmed.startsWith('#')) {
+            entries.push({ kind: 'comment', text: rawLine });
+            continue;
+        }
+        const match = KV_REGEX.exec(rawLine);
+        if (!match) {
+            entries.push({ kind: 'comment', text: rawLine });
+            continue;
+        }
+        const key = match[1];
+        const { value: rawValue, comment } = splitInlineComment(match[2]);
+        const value = stripQuotes(rawValue);
+        const entry = { kind: 'kv', key, value };
+        if (comment !== undefined)
+            entry.commentInline = comment;
+        entries.push(entry);
+    }
+    return entries;
+}
+function needsQuoting(value) {
+    if (value === '')
+        return false;
+    return /[\s#"'=]/.test(value);
+}
+function quoteValue(value) {
+    const escaped = value.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+    return `"${escaped}"`;
+}
+function formatValue(value) {
+    return needsQuoting(value) ? quoteValue(value) : value;
+}
+export function serializeEnvFile(entries) {
+    const out = [];
+    for (const entry of entries) {
+        if (entry.kind === 'blank') {
+            out.push('');
+        }
+        else if (entry.kind === 'comment') {
+            out.push(entry.text);
+        }
+        else {
+            const valuePart = formatValue(entry.value);
+            const line = entry.commentInline
+                ? `${entry.key}=${valuePart} # ${entry.commentInline}`
+                : `${entry.key}=${valuePart}`;
+            out.push(line);
+        }
+    }
+    return out.join('\n') + '\n';
+}
+function normalizeFieldValue(value) {
+    if (typeof value === 'boolean')
+        return value ? 'true' : 'false';
+    if (typeof value === 'number')
+        return String(value);
+    return value;
+}
+export function mergeEnvEntries(existing, updates) {
+    const updateKeys = new Set(Object.keys(updates));
+    const updated = [];
+    const added = [];
+    const unchanged = [];
+    const next = existing.map((entry) => {
+        if (entry.kind !== 'kv')
+            return entry;
+        if (!updateKeys.has(entry.key)) {
+            unchanged.push(entry.key);
+            return entry;
+        }
+        const newValue = normalizeFieldValue(updates[entry.key]);
+        updateKeys.delete(entry.key);
+        if (entry.value === newValue) {
+            unchanged.push(entry.key);
+            return entry;
+        }
+        updated.push({ key: entry.key, before: entry.value, after: newValue });
+        return { ...entry, value: newValue };
+    });
+    for (const remainingKey of updateKeys) {
+        const value = normalizeFieldValue(updates[remainingKey]);
+        next.push({ kind: 'kv', key: remainingKey, value });
+        added.push({ key: remainingKey, value });
+    }
+    return { entries: next, updated, added, unchanged };
+}
+const SENSITIVE_KEYS = new Set([
+    'LICENSE',
+    'DB_PASSWORD',
+    'REDIS_PASSWORD',
+    'KAFKA_SASL_PASSWORD',
+]);
+export function isSensitiveKey(key) {
+    return SENSITIVE_KEYS.has(key);
+}
+export function maskValue(value) {
+    if (value === '')
+        return '';
+    return '****';
+}
+//# sourceMappingURL=env-parser.js.map

package/dist/lib/env-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-parser.js","sourceRoot":"","sources":["../../src/lib/env-parser.ts"],"names":[],"mappings":"AAOA,MAAM,QAAQ,GAAG,uCAAuC,CAAC;AAEzD,SAAS,WAAW,CAAC,GAAW;IAC9B,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACvE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,kBAAkB,CAAC,QAAgB;IAC1C,MAAM,OAAO,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;IACrC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACvD,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC7C,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;YACtB,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;YACjD,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACxC,IAAI,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC;gBACnB,OAAO;oBACL,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC;oBACvC,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE;iBAC9C,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QAC5B,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IAC5B,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC;QACnB,OAAO;YACL,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE;YAC1C,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE;SAC3C,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,OAAO,GAAe,EAAE,CAAC;IAE/B,MAAM,qBAAqB,GACzB,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;IACrD,MAAM,cAAc,GAAG,qBAAqB,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAE1E,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC/B,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;YACnB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YAChC,SAAS;QACX,CAAC;QACD,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YACjD,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YACjD,SAAS;QACX,CAAC;QACD,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACrB,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAClE,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,KAAK,GAAa,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;QACnD,IAAI,OAAO,KAAK,SAAS;YAAE,KAAK,CAAC,aAAa,GAAG,OAAO,CAAC;QACzD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IAC/B,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAClE,OAAO,IAAI,OAAO,GAAG,CAAC;AACxB,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAmB;IAClD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC3B,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACpC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC3C,MAAM,IAAI,GAAG,KAAK,CAAC,aAAa;gBAC9B,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,IAAI,SAAS,MAAM,KAAK,CAAC,aAAa,EAAE;gBACtD,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,IAAI,SAAS,EAAE,CAAC;YAChC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAC/B,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAoB;IAC/C,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IAChE,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACpD,OAAO,KAAK,CAAC;AACf,CAAC;AASD,MAAM,UAAU,eAAe,CAC7B,QAAoB,EACpB,OAAsC;IAEtC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACjD,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,MAAM,KAAK,GAAyB,EAAE,CAAC;IACvC,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,MAAM,IAAI,GAAe,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC9C,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QACtC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC1B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QACzD,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC7B,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC1B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACvE,OAAO,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,KAAK,MAAM,YAAY,IAAI,UAAU,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;QACpD,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AACtD,CAAC;AAED,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC;IAC7B,SAAS;IACT,aAAa;IACb,gBAAgB;IAChB,qBAAqB;CACtB,CAAC,CAAC;AAEH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,OAAO,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IAC5B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/lib/exec.d.ts

@@ -0,0 +1,29 @@
+export interface ExecResult {
+    success: boolean;
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    command: string;
+}
+export interface ExecOptions {
+    cwd?: string;
+    timeout?: number;
+    /**
+     * Environment variables for the subprocess. Merged with parent process env
+     * via spread: { ...process.env, ...options.env }. Use this to suppress
+     * tooling banners (e.g. NODE_ENV: 'production') or pass tool-specific config.
+     */
+    env?: NodeJS.ProcessEnv;
+    /**
+     * Whether to strip the trailing newline from stdout/stderr. Default true
+     * (matches execa default). Set to false when byte-perfect passthrough is
+     * required (e.g. CLI commands that output template files where the final
+     * newline matters).
+     */
+    stripFinalNewline?: boolean;
+}
+/**
+ * Execute subprocess dengan structured result. Tidak throw — selalu return result.
+ * Cocok untuk wrapping CLI calls seperti npm, npx, restforge.
+ */
+export declare function execProcess(command: string, args: string[], options?: ExecOptions): Promise<ExecResult>;

package/dist/lib/exec.js

@@ -0,0 +1,38 @@
+import { execa } from 'execa';
+/**
+ * Execute subprocess dengan structured result. Tidak throw — selalu return result.
+ * Cocok untuk wrapping CLI calls seperti npm, npx, restforge.
+ */
+export async function execProcess(command, args, options = {}) {
+    const { cwd = process.cwd(), timeout = 60_000, env, stripFinalNewline = true } = options;
+    const fullCommand = `${command} ${args.join(' ')}`;
+    // Merge env: parent env first, custom env overrides
+    const mergedEnv = env ? { ...process.env, ...env } : undefined;
+    try {
+        const result = await execa(command, args, {
+            cwd,
+            timeout,
+            reject: false,
+            stripFinalNewline,
+            ...(mergedEnv ? { env: mergedEnv } : {}),
+        });
+        return {
+            success: result.exitCode === 0,
+            stdout: result.stdout,
+            stderr: result.stderr,
+            exitCode: result.exitCode ?? -1,
+            command: fullCommand,
+        };
+    }
+    catch (error) {
+        const e = error;
+        return {
+            success: false,
+            stdout: e.stdout?.toString() ?? '',
+            stderr: e.stderr?.toString() ?? e.message,
+            exitCode: e.exitCode ?? -1,
+            command: fullCommand,
+        };
+    }
+}
+//# sourceMappingURL=exec.js.map

package/dist/lib/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/lib/exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAmB,MAAM,OAAO,CAAC;AA4B/C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAe,EACf,IAAc,EACd,UAAuB,EAAE;IAEzB,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,EAAE,iBAAiB,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IACzF,MAAM,WAAW,GAAG,GAAG,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IAEnD,oDAAoD;IACpD,MAAM,SAAS,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAE/D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE;YACxC,GAAG;YACH,OAAO;YACP,MAAM,EAAE,KAAK;YACb,iBAAiB;YACjB,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzC,CAAC,CAAC;QACH,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,QAAQ,KAAK,CAAC;YAC9B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;YAC/B,OAAO,EAAE,WAAW;SACrB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,GAAG,KAAmB,CAAC;QAC9B,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE;YAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,OAAO;YACzC,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC;YAC1B,OAAO,EAAE,WAAW;SACrB,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1 @@
+export declare function startServer(): Promise<void>;