@restforgejs/mcp-server 1.2.0 → 1.2.1

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

@@ -25,13 +25,14 @@ DO NOT USE FOR:
 - Incremental ALTER migration — this tool does full apply only. For incremental migrations, suggest a manual SQL migration script.
 - Production database without explicit user authorisation — DESTRUCTIVE; never proceed without confirmation.
 
-This tool runs: npx restforge schema migrate [<path>] --config=<file> [--drop=<bool>] [--dry-run] in the given cwd.
-The CLI auto-detects the dialect from the config file (DB_TYPE=postgresql|mysql|oracle|sqlite). Exit codes: 0 apply success, 1 error, 2 dry-run success.
+This tool runs: npx restforge schema migrate --path=<path> --config=<file> [--drop=<bool>] [--dry-run] [--max-name-length=<N>] [--auto-create-db] in the given cwd.
+The CLI auto-detects the dialect from the config file (DB_TYPE=postgresql|mysql|oracle|sqlite). The CLI exits 0 on success for BOTH a real apply and a dry-run preview (the legacy exit code 2 for dry-run has been removed); any non-zero exit is an error. This tool distinguishes a dry-run preview from a real apply by the dryRun parameter, not by the exit code.
+Tables declared with softDelete enabled emit the same soft-delete DDL as generate-ddl: a consistency CHECK named chk_<table>_soft_delete_consistency and PostgreSQL partial indexes (WHERE is_deleted = FALSE) for non-unique indexes. Soft-delete is PostgreSQL-only in Phase 1 — migrating such a schema against any other dialect fails with a clear error.
 
 Preconditions:
 - The project must have @restforgejs/platform installed in node_modules.
 - The config file (default 'db-connection.env') must exist and contain valid database credentials.
-- Schema files must exist at the given path (default './schema') and pass validation.
+- Schema files must exist at the given path and pass validation. The --path flag is required by the CLI.
 
 PRESENTATION GUIDANCE:
 - Match the user's language. If the user writes in Indonesian, respond in Indonesian.
@@ -41,6 +42,7 @@ PRESENTATION GUIDANCE:
 - When the user uses drop=true, ALL DATA in the affected tables is destroyed. Confirm explicitly that the user understands this — quote the tables that will be dropped if known.
 - Production database operations should be opt-in. If the config points to production (verify by reading DB_HOST or similar), strongly suggest dry-run + manual review first.
 - There is no rollback on failure mid-migration — DDL changes that already executed are NOT automatically reverted. Plan for forward-fix only.
+- The user must specify --path (e.g. './schema'). The CLI no longer accepts a positional argument or default. If the user does not mention a path, confirm it before invoking.
 - When a precondition is not met, frame it as a question or next-step suggestion rather than an error.`,
         inputSchema: {
             cwd: z
@@ -55,8 +57,7 @@ PRESENTATION GUIDANCE:
             path: z
                 .string()
                 .min(1)
-                .optional()
-                .describe('Path to schema file or folder relative to cwd. When omitted, the CLI uses its default (./schema).'),
+                .describe('Path to schema file or folder relative to cwd (e.g. "./schema"). Required by the CLI.'),
             drop: z
                 .boolean()
                 .optional()
@@ -65,13 +66,21 @@ PRESENTATION GUIDANCE:
                 .boolean()
                 .optional()
                 .describe('Default false. When true, generate DDL and preview it without applying. Safe path: prefer this on the first call.'),
+            maxNameLength: z
+                .number()
+                .optional()
+                .describe('Optional override for the maximum database identifier length, mapped to --max-name-length=<N>. Sent only when supplied. The CLI already applies the correct default per dialect (postgres 63, mysql 64, oracle 128, sqlite 63), so this is rarely needed — leave it unset unless a specific identifier-length conflict requires a smaller bound.'),
+            autoCreateDb: z
+                .boolean()
+                .optional()
+                .describe('Default false. PostgreSQL/MySQL only; mapped to the bare flag --auto-create-db, sent only when true. When the target database does not yet exist, the CLI creates it and then STOPS with exit 0 and a re-run instruction — it does NOT continue to apply the tables in the same call. After an auto-create, the migrate action must be invoked a second time to apply the schema. Read the CLI output to tell "database created, please re-run" apart from "tables applied".'),
         },
         annotations: {
             title: 'Migrate dbschema-kit Files to Database',
             destructiveHint: true, // mutates live DB; with drop=true also destroys data
             idempotentHint: false, // re-running on a fresh DB will fail (tables already exist) unless drop=true
         },
-    }, async ({ cwd, config, path, drop, dryRun }) => {
+    }, async ({ cwd, config, path, drop, dryRun, maxNameLength, autoCreateDb }) => {
         const projectCwd = resolve(cwd);
         // Precondition check: @restforgejs/platform must be present in node_modules. per §3.4
         try {
@@ -87,7 +96,7 @@ PRESENTATION GUIDANCE:
 Project path: ${projectCwd}
 Expected location: node_modules/@restforgejs/platform
 Requested config: ${config}
-Requested schema path: ${path ?? 'default (./schema)'}
+Requested schema path: ${path}
 Requested drop: ${drop ?? false}
 Requested dryRun: ${dryRun ?? false}
 
@@ -100,27 +109,35 @@ For the assistant:
                 isError: false, // per §3.4
             };
         }
-        // Forward only the arguments the user supplied. CLI defaults remain in
-        // effect when the user does not specify them. per §3.5
-        const cliArgs = ['restforge', 'schema', 'migrate'];
-        if (path !== undefined)
-            cliArgs.push(path);
-        cliArgs.push(`--config=${config}`);
+        // CLI v4+ requires --path as a flag (no positional, no default). Other
+        // optional flags are only forwarded when the user supplied them. per §3.5
+        const cliArgs = [
+            'restforge',
+            'schema',
+            'migrate',
+            `--path=${path}`,
+            `--config=${config}`,
+        ];
         if (drop !== undefined)
             cliArgs.push(`--drop=${drop}`);
         if (dryRun === true)
             cliArgs.push('--dry-run');
+        if (maxNameLength !== undefined)
+            cliArgs.push(`--max-name-length=${maxNameLength}`);
+        if (autoCreateDb === true)
+            cliArgs.push('--auto-create-db');
         const result = await execProcess('npx', cliArgs, {
             cwd: projectCwd,
             timeout: 120_000, // schema apply on a populated DB can be slow
             env: { NODE_ENV: 'production' },
             stripFinalNewline: true,
         });
-        // The CLI uses exit code 2 to signal "dry-run completed successfully". execProcess
-        // treats only exit 0 as success, so we re-route exit 2 back into the success branch.
-        const isDryRunSuccess = !result.success && result.exitCode === 2;
-        // Branch C: real CLI failure (any non-zero exit other than dry-run sentinel). per §3.4
-        if (!result.success && !isDryRunSuccess) {
+        // The CLI now exits 0 for a successful dry-run as well as a real apply (the
+        // legacy exit code 2 dry-run sentinel was removed in platform v5.1.17). The
+        // dry-run vs apply distinction is therefore driven by the dryRun parameter,
+        // not by the exit code. per D-06.2
+        // Branch C: real CLI failure (any non-zero exit). per §3.4
+        if (!result.success) {
             return {
                 content: [
                     {
@@ -129,7 +146,7 @@ For the assistant:
 
 Project path: ${projectCwd}
 Config: ${config}
-Schema path: ${path ?? 'default (./schema)'}
+Schema path: ${path}
 Drop: ${drop ?? false}
 DryRun: ${dryRun ?? false}
 Command: ${result.command}
@@ -149,7 +166,8 @@ For the assistant:
   * Config file not found — suggest verifying the config path and that the file exists.
   * Database connection failed — suggest verifying credentials, host, and port.
   * Schema validation error — a schema file has invalid syntax or a broken FK reference. Suggest running the validate action first to surface the specific issue.
-  * Schema folder not found — the CLI cannot locate the path. Suggest verifying the folder name (default is './schema').
+  * Schema folder not found — the CLI cannot locate the path. Suggest verifying the folder name passed via --path.
+  * Missing required flag --path — the CLI now requires this flag explicitly. Confirm the path with the user.
   * Apply error mid-transaction — DDL changes that already executed before the failure are NOT automatically reverted. The user must inspect the DB state manually and plan a forward-fix.
   * Tables already exist (without drop=true) — the CLI does full apply only. Suggest dry-run + manual review of the existing schema, or pass drop=true with explicit user confirmation.
   * Unknown command 'schema migrate' — the installed RESTForge version may be older than this CLI subcommand; suggest upgrading the package.
@@ -160,8 +178,9 @@ For the assistant:
                 isError: true, // per §3.4
             };
         }
-        if (isDryRunSuccess) {
-            // Branch B (dry-run): preview only, no DDL applied. per §3.5
+        if (dryRun === true) {
+            // Branch B (dry-run): preview only, no DDL applied. Reached on exit 0 with
+            // dryRun=true (the CLI printed the DDL preview and exited cleanly). per §3.5
             return {
                 content: [
                     {
@@ -170,7 +189,7 @@ For the assistant:
 
 Project path: ${projectCwd}
 Config: ${config}
-Schema path: ${path ?? 'default (./schema)'}
+Schema path: ${path}
 Mode: dry-run
 
 --- DDL preview ---
@@ -186,7 +205,16 @@ For the assistant:
                 ],
             };
         }
-        // Branch B (apply): real apply succeeded. per §3.5
+        // When autoCreateDb is enabled, the CLI may CREATE THE DATABASE ONLY and then
+        // stop (exit 0) with a re-run instruction instead of applying tables — see
+        // platform migrate.js (handleMissingDatabase: created -> return). That output
+        // lands in this success branch, so the guidance must steer the assistant to
+        // read stdout rather than assume the tables were applied. per §3.5
+        const autoCreateNote = autoCreateDb === true
+            ? `
+- CAUTION — auto-create-db was enabled. If the target database did not exist, the CLI may have CREATED ONLY THE DATABASE and then STOPPED with a re-run instruction, WITHOUT applying any tables. Read the CLI output above carefully: if it contains a re-run instruction (for example "database created ... re-run the command"), do NOT claim the tables were created. Instead tell the user the database was provisioned and the migrate action must be run a second time to apply the schema.`
+            : '';
+        // Branch B (apply): real apply succeeded (exit 0 with dryRun not requested). per §3.5
         return {
             content: [
                 {
@@ -195,16 +223,17 @@ For the assistant:
 
 Project path: ${projectCwd}
 Config: ${config}
-Schema path: ${path ?? 'default (./schema)'}
+Schema path: ${path}
 Mode: apply
 Drop tables before recreate: ${drop ?? false}
+Auto-create database: ${autoCreateDb ?? false}
 
 --- CLI output ---
 ${result.stdout}
 --- end CLI output ---
 
 For the assistant:
-- Confirm to the user that the migration was applied. Read the CLI output above and mention the database type and the count of tables/indexes/foreign keys created (when present).
+- Confirm to the user that the migration was applied. Read the CLI output above and mention the database type and the count of tables/indexes/foreign keys created (when present).${autoCreateNote}
 - This is a DESTRUCTIVE operation: tables, indexes, and foreign keys were created in the live database. With drop=true, existing tables and their data were also removed before recreation.
 - The user should verify the database state matches expectation. Suggest listing tables (read-only) for confirmation.
 - For follow-up changes, the user authors updated schema files and reruns the migrate action. Caution: there is no incremental ALTER migration in this version — full apply only. Schema-driven incremental migration is out of scope.

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

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

package/dist/tools/codegen/dbschema-models.js

@@ -22,17 +22,18 @@ DO NOT USE FOR:
 - Generating DDL -> use 'codegen_dbschema_generate_ddl'
 - Looking up schema syntax -> use 'codegen_get_dbschema_catalog'
 
-This tool runs: npx restforge schema models [<path>] in the given cwd.
+This tool runs: npx restforge schema models --path=<path> in the given cwd.
 
 Preconditions:
 - The project must have @restforgejs/platform installed in node_modules.
-- The schema path (default './schema') must exist. If the CLI fails because the folder is missing, the failure response surfaces the underlying cause.
+- The schema path must exist. If the CLI fails because the folder is missing, the failure response surfaces the underlying 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. "list the schema models", "validate the schema", "generate the DDL").
 - Speak in plain language. Summarise the result (model count, schemas in use); do not paste the tabular output verbatim if many models are listed.
 - Models listing skips cross-model validation. If FK references are broken, listing still works; that is by design — use the validate action for correctness check.
+- The user must specify --path (e.g. './schema'). The CLI no longer accepts a positional argument or default. If the user does not mention a path, confirm it before invoking.
 - When a precondition is not met, frame it as a question or next-step suggestion rather than an error.`,
         inputSchema: {
             cwd: z
@@ -42,8 +43,7 @@ PRESENTATION GUIDANCE:
             path: z
                 .string()
                 .min(1)
-                .optional()
-                .describe('Path to schema file or folder relative to cwd. When omitted, the CLI uses its default (./schema).'),
+                .describe('Path to schema folder relative to cwd (e.g. "./schema"). Required by the CLI.'),
         },
         annotations: {
             title: 'List dbschema-kit Models',
@@ -65,7 +65,7 @@ PRESENTATION GUIDANCE:
 
 Project path: ${projectCwd}
 Expected location: node_modules/@restforgejs/platform
-Requested schema path: ${path ?? 'default (./schema)'}
+Requested schema path: ${path}
 
 For the assistant:
 - The user needs to install the RESTForge package before models can be listed.
@@ -76,10 +76,8 @@ For the assistant:
                 isError: false, // per §3.4
             };
         }
-        // Forward only the arguments the user supplied. CLI default './schema' applies otherwise. per §3.5
-        const cliArgs = ['restforge', 'schema', 'models'];
-        if (path !== undefined)
-            cliArgs.push(path);
+        // CLI v4+ requires --path as a flag (no positional, no default). per §3.5
+        const cliArgs = ['restforge', 'schema', 'models', `--path=${path}`];
         const result = await execProcess('npx', cliArgs, {
             cwd: projectCwd,
             timeout: 30_000,
@@ -95,7 +93,7 @@ For the assistant:
                         text: `Failed to list schema models.
 
 Project path: ${projectCwd}
-Schema path: ${path ?? 'default (./schema)'}
+Schema path: ${path}
 Command: ${result.command}
 Exit code: ${result.exitCode}
 
@@ -110,7 +108,8 @@ ${result.stderr}
 For the assistant:
 - Tell the user that listing the schema models did not complete successfully.
 - Summarise the most likely cause from the CLI output in plain language. Common causes:
-  * Schema folder not found — the CLI cannot locate the path. Suggest verifying the folder name (default is './schema').
+  * Schema folder not found — the CLI cannot locate the path. Suggest verifying the folder name passed via --path.
+  * Missing required flag --path — the CLI now requires this flag explicitly. Confirm the path with the user.
   * Single-model parse error — a file has invalid factory function content. Suggest opening the file and confirming it exports a defineModel call. The validate action surfaces field-level errors more precisely.
   * Unknown command 'schema models' — the installed RESTForge version may be older than this CLI subcommand; suggest upgrading the package.
 - Do not paste the raw stdout/stderr unless the user explicitly asks. Do not mention internal tool names.`,
@@ -127,7 +126,7 @@ For the assistant:
                     text: `Schema models listed successfully.
 
 Project path: ${projectCwd}
-Schema path: ${path ?? 'default (./schema)'}
+Schema path: ${path}
 
 --- CLI output ---
 ${result.stdout}

package/dist/tools/codegen/dbschema-models.js.map

@@ -1 +1 @@
-{"version":3,"file":"dbschema-models.js","sourceRoot":"","sources":["../../../src/tools/codegen/dbschema-models.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,UAAU,6BAA6B,CAAC,MAAiB;IAC7D,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,KAAK,EAAE,0BAA0B;QACjC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;uGA4BoF;QACjG,WAAW,EAAE;YACX,GAAG,EAAE,CAAC;iBACH,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,uFAAuF,CAAC;YACpG,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,EAAE;iBACV,QAAQ,CAAC,mGAAmG,CAAC;SACjH;QACD,WAAW,EAAE;YACX,KAAK,EAAE,0BAA0B;YACjC,YAAY,EAAE,IAAI;YAClB,cAAc,EAAE,IAAI;SACrB;KACF,EACD,KAAK,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE;QACtB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAEhC,sFAAsF;QACtF,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;;yBAED,IAAI,IAAI,oBAAoB;;;;;gKAK2G;qBACnJ;iBACF;gBACD,OAAO,EAAE,KAAK,EAAE,WAAW;aAC5B,CAAC;QACJ,CAAC;QAED,mGAAmG;QACnG,MAAM,OAAO,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAClD,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE3C,MAAM,MAAM,GAAG,MAAM,WAAW,CAC9B,KAAK,EACL,OAAO,EACP;YACE,GAAG,EAAE,UAAU;YACf,OAAO,EAAE,MAAM;YACf,GAAG,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE;YAC/B,iBAAiB,EAAE,IAAI;SACxB,CACF,CAAC;QAEF,wDAAwD;QACxD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;gBAEJ,UAAU;eACX,IAAI,IAAI,oBAAoB;WAChC,MAAM,CAAC,OAAO;aACZ,MAAM,CAAC,QAAQ;;;;EAI1B,MAAM,CAAC,MAAM;;;EAGb,MAAM,CAAC,MAAM;;;;;;;;;0GAS2F;qBAC7F;iBACF;gBACD,OAAO,EAAE,IAAI,EAAE,WAAW;aAC3B,CAAC;QACJ,CAAC;QAED,kEAAkE;QAClE,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;gBAEF,UAAU;eACX,IAAI,IAAI,oBAAoB;;;EAGzC,MAAM,CAAC,MAAM;;;;;;;6BAOc;iBAClB;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"dbschema-models.js","sourceRoot":"","sources":["../../../src/tools/codegen/dbschema-models.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,UAAU,6BAA6B,CAAC,MAAiB;IAC7D,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,KAAK,EAAE,0BAA0B;QACjC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uGA6BoF;QACjG,WAAW,EAAE;YACX,GAAG,EAAE,CAAC;iBACH,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,uFAAuF,CAAC;YACpG,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,+EAA+E,CAAC;SAC7F;QACD,WAAW,EAAE;YACX,KAAK,EAAE,0BAA0B;YACjC,YAAY,EAAE,IAAI;YAClB,cAAc,EAAE,IAAI;SACrB;KACF,EACD,KAAK,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE;QACtB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAEhC,sFAAsF;QACtF,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;;yBAED,IAAI;;;;;gKAKmI;qBACnJ;iBACF;gBACD,OAAO,EAAE,KAAK,EAAE,WAAW;aAC5B,CAAC;QACJ,CAAC;QAED,0EAA0E;QAC1E,MAAM,OAAO,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,IAAI,EAAE,CAAC,CAAC;QAEpE,MAAM,MAAM,GAAG,MAAM,WAAW,CAC9B,KAAK,EACL,OAAO,EACP;YACE,GAAG,EAAE,UAAU;YACf,OAAO,EAAE,MAAM;YACf,GAAG,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE;YAC/B,iBAAiB,EAAE,IAAI;SACxB,CACF,CAAC;QAEF,wDAAwD;QACxD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;gBAEJ,UAAU;eACX,IAAI;WACR,MAAM,CAAC,OAAO;aACZ,MAAM,CAAC,QAAQ;;;;EAI1B,MAAM,CAAC,MAAM;;;EAGb,MAAM,CAAC,MAAM;;;;;;;;;;0GAU2F;qBAC7F;iBACF;gBACD,OAAO,EAAE,IAAI,EAAE,WAAW;aAC3B,CAAC;QACJ,CAAC;QAED,kEAAkE;QAClE,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;gBAEF,UAAU;eACX,IAAI;;;EAGjB,MAAM,CAAC,MAAM;;;;;;;6BAOc;iBAClB;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/codegen/dbschema-template.d.ts

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