@restforgejs/mcp-server 1.2.0 → 1.2.2

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

@@ -0,0 +1,352 @@
+import { z } from 'zod';
+import { access } from 'node:fs/promises';
+import { resolve, join } from 'node:path';
+import { execProcess } from '../../lib/exec.js';
+// Extract a printable name from a drift item. Items in onlyInSdf/onlyInDb/mismatched
+// can be plain strings or objects depending on the section; fall back to JSON for
+// unknown shapes. Defensive access per the verified JSON shape (phase 00 T3.1).
+function itemName(item) {
+    if (typeof item === 'string')
+        return item;
+    if (item !== null && typeof item === 'object') {
+        const o = item;
+        if (typeof o.name === 'string')
+            return o.name;
+        if (typeof o.field === 'string')
+            return o.field;
+        if (typeof o.column === 'string')
+            return o.column;
+    }
+    return JSON.stringify(item);
+}
+// Summarise one { onlyInSdf, onlyInDb, mismatched } drift section. Returns null when
+// the section is absent or has no drift, so clean sections stay out of the summary.
+function summariseListSection(section) {
+    if (section === null || typeof section !== 'object')
+        return null;
+    const s = section;
+    const labels = {
+        onlyInSdf: 'only-in-SDF',
+        onlyInDb: 'only-in-DB',
+        mismatched: 'mismatched',
+    };
+    const parts = [];
+    for (const key of ['onlyInSdf', 'onlyInDb', 'mismatched']) {
+        const arr = Array.isArray(s[key]) ? s[key] : [];
+        if (arr.length > 0) {
+            parts.push(`${labels[key]} [${arr.map(itemName).join(', ')}]`);
+        }
+    }
+    return parts.length > 0 ? parts.join('; ') : null;
+}
+// Summarise a { match, sdf, db } section (primaryKey, softDelete). Returns null when
+// match is not explicitly false or the shape is unknown.
+function summariseMatchSection(section) {
+    if (section === null || typeof section !== 'object')
+        return null;
+    const s = section;
+    if (s.match !== false)
+        return null;
+    return `mismatch (SDF: ${JSON.stringify(s.sdf ?? null)} vs DB: ${JSON.stringify(s.db ?? null)})`;
+}
+// Build the per-table drift lines for the response text. Section order follows the
+// JSON shape from phase 00 T3.1: fields, primaryKey, indexes, uniques, foreignKeys,
+// checks, softDelete (the last two are optional in the report).
+function buildDriftSummary(tables) {
+    const lines = [];
+    for (const t of tables) {
+        if (t === null || typeof t !== 'object')
+            continue;
+        const table = t;
+        if (table.hasDrift !== true)
+            continue;
+        const name = typeof table.tableName === 'string' ? table.tableName : '(unknown table)';
+        const sectionLines = [];
+        const fields = summariseListSection(table.fields);
+        if (fields)
+            sectionLines.push(`    fields: ${fields}`);
+        const pk = summariseMatchSection(table.primaryKey);
+        if (pk)
+            sectionLines.push(`    primaryKey: ${pk}`);
+        for (const key of ['indexes', 'uniques', 'foreignKeys', 'checks']) {
+            const summary = summariseListSection(table[key]);
+            if (summary)
+                sectionLines.push(`    ${key}: ${summary}`);
+        }
+        const softDelete = summariseMatchSection(table.softDelete);
+        if (softDelete)
+            sectionLines.push(`    softDelete: ${softDelete}`);
+        if (sectionLines.length === 0) {
+            sectionLines.push('    (drift flagged but no recognised section detail — see the raw JSON below)');
+        }
+        lines.push(`- ${name}:`, ...sectionLines);
+    }
+    return lines.join('\n');
+}
+export function registerCodegenDbschemaDiff(server) {
+    server.registerTool('codegen_dbschema_diff', {
+        title: 'Diff dbschema-kit Files Against Database',
+        description: `Detect schema drift between dbschema-kit SDF files and the live database structure (read-only, bidirectional), by wrapping restforge schema diff. The CLI loads the SDF files, introspects the matching tables in the database, and reports differences in both directions: only-in-SDF (declared but missing in the database), only-in-DB (present in the database but not declared), and mismatched (present on both sides but different). Nothing is written to the database or the filesystem.
+
+EXIT CODE SEMANTICS (important):
+- Exit 0 = no drift; schema and database are in sync.
+- Exit 1 = drift detected. This is a NORMAL, meaningful result — NOT a failure. The response summarises the drift; treat it as the answer to "is my schema in sync?".
+- Exit 2 = system error (invalid config, connection failure, schema path not found, SDF load error).
+
+USE WHEN:
+- The user asks "is my schema in sync with the database?", "apakah schema saya sinkron dengan database?", "ada drift nggak?", "cek drift schema"
+- After editing SDF files — to check the impact against the live database before deciding what to apply
+- After a manual database change (e.g. an ad-hoc ALTER) — to see how far the database diverged from the SDF source
+- Before running 'codegen_dbschema_migrate' on an existing database — to know what differs first
+- The user wants a safe read-only comparison without modifying anything
+- Periodic drift audit of an environment (staging/production) against the SDF folder
+
+DO NOT USE FOR:
+- Applying the detected drift to the database -> use 'codegen_dbschema_apply', the incremental complement of this diff (additive ALTER by default; destructive changes need explicit opt-in).
+- Full CREATE/DROP deployment of a schema -> use 'codegen_dbschema_migrate' (full apply, mutates the database — a different operation from drift detection)
+- Validating SDF file correctness without a database -> use 'codegen_dbschema_validate'
+- Reverse-engineering SDF files from the database -> use 'codegen_dbschema_introspect'
+- Listing tables or describing a single table -> use 'codegen_list_tables' / 'codegen_describe_table'
+- Comparing RDF payload files against the database -> use 'codegen_diff_payload'
+
+This tool runs: npx restforge schema diff --path=<path> --config=<config> --json [--table=<name>] in the given cwd. The --json flag is always sent; the tool parses the JSON drift report (version, summary, per-table sections).
+
+Soft-delete note: the diff is soft-delete aware but non-strict. Drift in the softDelete block is reported as-is in the table's softDelete section without blocking the diff — unlike introspect, which can block on a broken soft-delete contract.
+
+Limitations:
+- The sqlite dialect is not supported by schema diff.
+- A table declared in SDF but absent in the database is reported as only-in-SDF drift, not as an 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.
+- SDF files must exist at the given path. The --path flag is required by the CLI.
+
+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. "compare the schema with the database", "check for drift").
+- Drift detected is NOT an error. Present it as a factual comparison result: which tables drifted and in which direction (only-in-SDF / only-in-DB / mismatched).
+- Speak in plain language. Summarise per table; do not paste the raw JSON unless the user explicitly asks.
+- This is a read-only live comparison: the database is introspected at diff time and never modified.
+- 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 (must contain node_modules/@restforgejs/platform and the config file)'),
+            config: z
+                .string()
+                .min(1)
+                .default('db-connection.env')
+                .describe('Config file name relative to the project, used by the CLI to connect to the database'),
+            path: z
+                .string()
+                .min(1)
+                .describe('Path to schema file or folder relative to cwd (e.g. "./schema" or "schema/users.js"). Required by the CLI.'),
+            table: z
+                .string()
+                .min(1)
+                .optional()
+                .describe('Diff only one specific table. When omitted, all tables in the schema path are compared.'),
+        },
+        annotations: {
+            title: 'Diff dbschema-kit Files Against Database',
+            readOnlyHint: true,
+            idempotentHint: true,
+        },
+    }, async ({ cwd, config, path, table }) => {
+        const projectCwd = resolve(cwd);
+        // Precondition check: @restforgejs/platform must be present in node_modules. per §3.4
+        try {
+            await access(join(projectCwd, 'node_modules', '@restforgejs', 'platform'));
+        }
+        catch {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Precondition not met: the RESTForge package is not installed in this project.
+
+Project path: ${projectCwd}
+Expected location: node_modules/@restforgejs/platform
+Requested config: ${config}
+Requested schema path: ${path}
+Requested table filter: ${table ?? 'all tables'}
+
+For the assistant:
+- The user needs to install the RESTForge package before the schema can be diffed against the database.
+- Suggest installing the package first, then retry the drift check.
+- 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
+            };
+        }
+        // --json is always sent: the CLI default is a human-readable report, while this
+        // tool depends on JSON.parse of stdout. There is no --dry-run flag — schema diff
+        // is read-only by design. Optional flags forwarded only when supplied. per §3.5
+        const cliArgs = [
+            'restforge',
+            'schema',
+            'diff',
+            `--path=${path}`,
+            `--config=${config}`,
+            '--json',
+        ];
+        if (table !== undefined)
+            cliArgs.push(`--table=${table}`);
+        const result = await execProcess('npx', cliArgs, {
+            cwd: projectCwd,
+            timeout: 60_000, // diff introspects every table in the schema path; more headroom than a single catalog query
+            env: { NODE_ENV: 'production' },
+            stripFinalNewline: true,
+        });
+        // Exit code semantics are part of the CLI spec: 0 = no drift, 1 = drift detected
+        // (a meaningful result, NOT an error), 2 = system error. execProcess treats only
+        // exit 0 as success, so exit 1 is re-routed into the result branches below.
+        const driftDetected = result.exitCode === 1;
+        // Branch C: system error (exit 2 or any other non-0/1 exit). per §3.4
+        if (!result.success && !driftDetected) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to diff schema against the database.
+
+Project path: ${projectCwd}
+Config: ${config}
+Schema path: ${path}
+Table filter: ${table ?? 'all tables'}
+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 drift check could not run. This is a system error, not a drift result.
+- Summarise the most likely cause from the CLI output in plain language. Common causes:
+  * Config file not found or invalid — suggest verifying the config path and its content.
+  * Database connection failed — suggest verifying credentials, host, and port.
+  * Schema path not found — the CLI cannot locate the path. Suggest verifying the folder or file name passed via --path.
+  * SDF load error — a schema file has invalid syntax or violates the defineModel contract. Suggest running the validate action first to surface the specific issue.
+  * Unsupported dialect — schema diff does not support sqlite. Suggest checking DB_TYPE in the config.
+  * Unknown command 'schema diff' — 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.
+- Offer to retry once the underlying issue is resolved.`,
+                    },
+                ],
+                isError: true, // per §3.4
+            };
+        }
+        // Branch D: JSON parse failure on exit 0/1 — real error per §3.4 (the CLI
+        // completed but produced output this tool cannot read).
+        let parsed;
+        try {
+            parsed = JSON.parse(result.stdout);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to parse the schema drift report as JSON.
+
+Project path: ${projectCwd}
+Config: ${config}
+Schema path: ${path}
+Exit code: ${result.exitCode}
+Reason: ${msg}
+
+--- Raw stdout ---
+${result.stdout}
+--- end Raw stdout ---
+
+For the assistant:
+- The CLI returned output that is not valid JSON, so the drift result could not be read.
+- Summarise this to the user in plain language; do not paste the raw stdout unless they explicitly ask.
+- Suggest checking that the installed RESTForge package version is compatible. Do not mention internal tool names.`,
+                    },
+                ],
+                isError: true, // per §3.4
+            };
+        }
+        // Defensive labeled facts: if the JSON shape changes upstream, fall back to
+        // 'unknown' rather than crashing. Mirror the list-tables pattern.
+        const root = (parsed ?? {});
+        const summary = (root.summary ?? {});
+        const totalTables = typeof summary.totalTables === 'number' ? summary.totalTables : 'unknown';
+        const tablesWithDrift = typeof summary.tablesWithDrift === 'number' ? summary.tablesWithDrift : 'unknown';
+        const tablesClean = typeof summary.tablesClean === 'number' ? summary.tablesClean : 'unknown';
+        const tables = Array.isArray(root.tables) ? root.tables : [];
+        const prettyJson = JSON.stringify(parsed, null, 2);
+        // Branch B (no drift): exit 0 — schema and database are in sync. per §3.5
+        if (!driftDetected) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Schema drift check completed: no drift detected.
+
+Project path: ${projectCwd}
+Config: ${config}
+Schema path: ${path}
+Table filter: ${table ?? 'all tables'}
+totalTables: ${totalTables}
+tablesWithDrift: ${tablesWithDrift}
+tablesClean: ${tablesClean}
+
+For the assistant:
+- Confirm to the user that the schema files and the database are in sync — mention the number of tables compared in plain language.
+- This was a read-only comparison; nothing in the database or the filesystem was modified.
+- No follow-up action is required. If the user expected drift, suggest double-checking that the schema path and config point at the intended files and database.
+- Match the user's language.`,
+                    },
+                ],
+            };
+        }
+        // Branch B (drift): exit 1 — drift detected, a meaningful result, NOT an error. per §3.5
+        const driftSummary = buildDriftSummary(tables);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Schema drift check completed: drift detected (this is a result, not an error).
+
+Project path: ${projectCwd}
+Config: ${config}
+Schema path: ${path}
+Table filter: ${table ?? 'all tables'}
+totalTables: ${totalTables}
+tablesWithDrift: ${tablesWithDrift}
+tablesClean: ${tablesClean}
+
+--- Drift summary per table ---
+${driftSummary}
+--- end Drift summary ---
+
+--- Drift report (JSON) ---
+${prettyJson}
+--- end Drift report (JSON) ---
+
+For the assistant:
+- Present this as a factual comparison result, NOT a failure: the schema files and the database differ.
+- Summarise per drifted table in plain language: only-in-SDF means declared in the schema files but missing in the database; only-in-DB means present in the database but not declared; mismatched means present on both sides with different definitions.
+- A whole table reported as only-in-SDF fields drift usually means the table does not exist in the database yet.
+- Drift in the softDelete section is informational (non-strict) — report it as-is without treating it as a blocker.
+- Do not paste the full JSON unless the user asks; the per-table summary above is usually enough.
+- For next steps, depending on direction: additive changes can be applied incrementally via 'codegen_dbschema_apply' (preview with dryRun=true first; destructive changes need explicit user opt-in); a full re-deploy goes through the migrate action (destructive — needs explicit confirmation). When speaking to the user, describe these as actions — do not mention internal tool names.
+- This was a read-only comparison; nothing was modified.
+- Match the user's language.`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=dbschema-diff.js.map

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

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

package/dist/tools/codegen/dbschema-generate-ddl.js

@@ -23,7 +23,9 @@ DO NOT USE FOR:
 - Generating DDL for tables not defined in schema files -> out of scope (only schema-as-code files are processed)
 - Validating schema correctness -> use 'codegen_dbschema_validate'
 
-This tool runs: npx restforge schema generate-ddl <path> --dialect=<X> [--out=<file>] [--drop=<bool>] in the given cwd.
+This tool runs: npx restforge schema generate-ddl --path=<path> --dialect=<X> [--out=<file>] [--drop=<bool>] in the given cwd.
+
+SOFT-DELETE EMISSION: a table declared with softDelete enabled emits a consistency CHECK constraint named chk_<table>_soft_delete_consistency and emits its non-unique indexes as PostgreSQL partial indexes (WHERE is_deleted = FALSE); UNIQUE constraints are never made partial. Soft-delete is PostgreSQL-only in Phase 1: generating DDL for any other dialect fails with a clear error ("soft-delete is PostgreSQL-only in Phase 1") instead of emitting wrong DDL silently.
 
 Preconditions:
 - The project must have @restforgejs/platform installed in node_modules.
@@ -100,7 +102,7 @@ For the assistant:
             'restforge',
             'schema',
             'generate-ddl',
-            path,
+            `--path=${path}`,
             `--dialect=${dialect}`,
         ];
         if (out !== undefined)
@@ -141,7 +143,8 @@ For the assistant:
 - Tell the user that generating the DDL did not complete successfully.
 - Summarise the most likely cause from the CLI output in plain language. Common causes:
   * Schema validation failure — a 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.
+  * Schema folder not found — the CLI cannot locate the path. Suggest verifying the folder name passed via --path.
+  * Missing required flag --path or --dialect — the CLI now requires both explicitly. Confirm both values with the user.
   * Invalid dialect — only postgres, mysql, oracle, sqlite are supported.
   * Output path issue (parent folder missing) — the CLI does not auto-create intermediate folders. Suggest creating them first.
   * Unknown command 'schema generate-ddl' — the installed RESTForge version may be older than this CLI subcommand; suggest upgrading the package.

package/dist/tools/codegen/dbschema-generate-ddl.js.map

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

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

@@ -17,17 +17,23 @@ USE WHEN:
 - The user mentions a new domain entity (e.g. "I need a customer_invoice table") and wants a schema file as a starting point
 
 DO NOT USE FOR:
+- Scaffolding a real, fleshed-out common table (sales_order, invoice, product, ...) from the reference collection -> use 'codegen_dbschema_template' (generate mode); this tool only creates a minimal dummy skeleton
 - Editing an existing schema file -> use Edit/Write tools directly
 - Generating schema files from a live database -> use 'codegen_dbschema_introspect'
 - Creating a CRUD payload (different concept) -> use 'codegen_generate_payload'
 - Validating the schema -> use 'codegen_dbschema_validate'
 - Generating DDL -> use 'codegen_dbschema_generate_ddl'
 
-This tool runs: npx restforge schema init <path> in the given cwd.
+This tool runs: npx restforge schema init --path=<path> in the given cwd.
 The CLI writes a JavaScript factory function file to the target path. The path must end with '.js' and the file must NOT already exist.
 
+IMPLEMENTATION NOTE (matters for cross-platform behaviour): schema init is a thin wrapper over 'schema template --table=dummy --generate --lang=sdf'. It therefore depends on the same native binary (sdf-tools.exe) that the template feature uses, and that binary is currently WINDOWS-ONLY. On a non-Windows host (or if the binary is missing from the installed package) the CLI exits with code 3 and no file is created — that is a platform limitation, not a user error.
+
+For scaffolding a real, fleshed-out table from the reference collection (e.g. sales_order, customer_invoice) instead of the minimal dummy skeleton, use 'codegen_dbschema_template' (generate mode).
+
 Preconditions:
 - The project must have @restforgejs/platform installed in node_modules.
+- The init feature requires the Windows-only sdf-tools.exe binary shipped with the package (exit 3 otherwise — see IMPLEMENTATION NOTE).
 - The target file must NOT already exist (CLI fails otherwise — the user can pick a different name or remove the existing file first).
 - The parent folder of the target path must exist (CLI does not create intermediate folders).
 
@@ -81,7 +87,7 @@ For the assistant:
         }
         // Subprocess call. The CLI handles all filesystem validation
         // (extension, parent folder existence, target file non-existence). per §3.5
-        const cliArgs = ['restforge', 'schema', 'init', path];
+        const cliArgs = ['restforge', 'schema', 'init', `--path=${path}`];
         const result = await execProcess('npx', cliArgs, {
             cwd: projectCwd,
             timeout: 10_000,
@@ -115,6 +121,7 @@ For the assistant:
   * The target file already exists — suggest picking a different filename or removing the existing file first.
   * The path does not end with '.js' — schema files use the JavaScript factory function pattern; suggest correcting the extension.
   * The parent folder does not exist — the CLI does not auto-create intermediate folders. Suggest creating the folder first.
+  * Exit code 3 / non-Windows platform — init depends on the Windows-only sdf-tools.exe binary (it wraps 'schema template --generate'). On a non-Windows host the skeleton cannot be generated. Offer alternatives: author the schema file by hand (ground it with the schema catalog), or reverse-engineer it from an existing database table. Present this as a platform limitation, not a user error.
   * Unknown command 'schema init' — 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.`,
                     },

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

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

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

@@ -5,7 +5,7 @@ import { execProcess } from '../../lib/exec.js';
 export function registerCodegenDbschemaIntrospect(server) {
     server.registerTool('codegen_dbschema_introspect', {
         title: 'Introspect Database into dbschema-kit Files',
-        description: `Reverse-engineer an existing database into dbschema-kit definition files (factory function pattern), by wrapping restforge schema introspect. Useful for migrating legacy projects to declarative schema-as-code, or for capturing the current database structure under version control. Mode (single-table, bulk single-schema, bulk multi-schema, all-schemas) is derived from the combination of 'table', 'schema', 'allSchemas', and 'output'.
+        description: `Reverse-engineer an existing database into dbschema-kit definition files (factory function pattern), by wrapping restforge schema introspect. Useful for migrating legacy projects to declarative schema-as-code, or for capturing the current database structure under version control. Mode (single-table, bulk single-schema, bulk multi-schema, all-schemas) is derived from the combination of 'table', 'schema', and 'allSchemas'.
 
 USE WHEN:
 - The user asks to reverse-engineer a database, "buatkan schema dari database existing", "introspect DB ke schema files"
@@ -25,19 +25,21 @@ DO NOT USE FOR:
 - Modifying database schema (CREATE/ALTER/DROP) -> use 'codegen_dbschema_migrate'
 - Querying actual row data -> out of scope (returns metadata only)
 
-This tool runs: npx restforge schema introspect --config=<file> [--output=<path>] [--table=<name>] [--schema=<name>] [--all-schemas] [--force] [--dry-run] in the given cwd.
+This tool runs: npx restforge schema introspect --config=<file> --schema-path=<path> [--table=<name>] [--schema=<name>] [--all-schemas] [--force] [--dry-run] in the given cwd.
 The mode is derived by the CLI from the flag combination. The MCP layer passes flags through and does not validate mutual exclusivity — the CLI is the single source of truth for mode resolution.
 
+SOFT-DELETE STRICT BLOCK: on PostgreSQL, any table that has soft-delete columns (is_deleted/deleted_at/deleted_by) is validated against the soft-delete contract. A non-conforming table BLOCKS the whole introspect run with exit code 1 in three cases: (1) only a partial set of the three columns exists, (2) the columns exist but their types do not match the contract, or (3) the columns are complete and correctly typed but the consistency CHECK constraint is missing. The CLI error message starts with "[restforge] ERROR: introspect blocked for table '<name>'" and lists concrete mitigation options (complete the contract or drop the soft-delete columns; the missing-CHECK case includes a ready-to-run ALTER TABLE ... ADD CONSTRAINT statement). Relay that message and its options to the user — never report it as a generic failure. A fully conforming table introspects normally and the generated SDF carries softDelete: { enabled: true }.
+
 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.
-- 'output' is required unless 'dryRun' is true.
+- 'schemaPath' is required for every mode. The CLI declares --schema-path as a required flag and rejects the call at parse level without it, even when 'dryRun' is true.
 
 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. "introspect the database", "validate the schema", "preview before writing").
 - Speak in plain language. Confirm the mode (single-table / bulk / dry-run) and the output target; do not paste raw CLI output unless the user explicitly asks.
-- Mode is derived from the combination of 'table', 'schema', 'allSchemas', and 'output'. Confirm with the user before invoking — different modes produce different file layouts (flat vs subfolder).
+- Mode is derived from the combination of 'table', 'schema', and 'allSchemas'. Confirm with the user before invoking — different modes produce different file layouts (flat vs subfolder).
 - Without 'force', the tool refuses to overwrite existing files. If the user wants to refresh introspection, confirm before passing force=true.
 - 'dryRun=true' is the safe path for preview. Suggest dry-run first when the user is exploring an unfamiliar database.
 - This is a write operation in non-dry-run mode. Files in the output target may have been created or overwritten.
@@ -52,11 +54,10 @@ PRESENTATION GUIDANCE:
                 .min(1)
                 .default('db-connection.env')
                 .describe('Config file name relative to the project, used by the CLI to connect to the database'),
-            output: z
+            schemaPath: z
                 .string()
                 .min(1)
-                .optional()
-                .describe('Output target relative to cwd. Required unless dryRun=true. For single-table mode: a .js file path; for bulk modes: a folder path. Multi-schema bulk uses subfolders inside this folder.'),
+                .describe('Schema output target relative to cwd, mapped to the CLI flag --schema-path. Required for every mode, including dry-run. For single-table mode: a .js file path; for bulk modes: a folder path. Multi-schema bulk uses subfolders inside this folder.'),
             table: z
                 .string()
                 .min(1)
@@ -85,7 +86,7 @@ PRESENTATION GUIDANCE:
             destructiveHint: false, // writes files (and may overwrite with force=true), but no live DB mutation; reversible by deleting outputs
             idempotentHint: false, // first call writes new files; subsequent calls behave differently depending on force
         },
-    }, async ({ cwd, config, output, table, schema, allSchemas, force, dryRun }) => {
+    }, async ({ cwd, config, schemaPath, table, schema, allSchemas, force, dryRun }) => {
         const projectCwd = resolve(cwd);
         // Precondition check: @restforgejs/platform must be present in node_modules. per §3.4
         try {
@@ -101,7 +102,7 @@ PRESENTATION GUIDANCE:
 Project path: ${projectCwd}
 Expected location: node_modules/@restforgejs/platform
 Requested config: ${config}
-Requested output: ${output ?? '(none)'}
+Requested schemaPath: ${schemaPath}
 Requested table: ${table ?? '(none)'}
 Requested schema: ${schema ?? '(none)'}
 Requested allSchemas: ${allSchemas ?? false}
@@ -119,9 +120,7 @@ For the assistant:
         }
         // Forward only the arguments the user supplied. The CLI handles mode resolution
         // and mutual-exclusivity rules. per §3.5
-        const cliArgs = ['restforge', 'schema', 'introspect', `--config=${config}`];
-        if (output !== undefined)
-            cliArgs.push(`--output=${output}`);
+        const cliArgs = ['restforge', 'schema', 'introspect', `--config=${config}`, `--schema-path=${schemaPath}`];
         if (table !== undefined)
             cliArgs.push(`--table=${table}`);
         if (schema !== undefined)
@@ -138,9 +137,15 @@ For the assistant:
             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;
+        // The CLI signals "dry-run completed" with exit code 2 (it throws 'schema introspect
+        // dry-run complete' with exitCode=2), but usage errors also exit 2. Exit 2 only counts
+        // as dry-run success when dry-run was actually requested AND the combined output carries
+        // the dry-run completion marker; any other exit 2 falls through to the error branch.
+        // per D-00.2 / D-00.6
+        const combinedOutput = `${result.stdout}\n${result.stderr}`;
+        const isDryRunSuccess = dryRun === true &&
+            result.exitCode === 2 &&
+            /dry-run complete/i.test(combinedOutput);
         // Branch C: real CLI failure (any non-zero exit other than dry-run sentinel). per §3.4
         if (!result.success && !isDryRunSuccess) {
             return {
@@ -151,7 +156,7 @@ For the assistant:
 
 Project path: ${projectCwd}
 Config: ${config}
-Output: ${output ?? '(none)'}
+SchemaPath: ${schemaPath}
 Table: ${table ?? '(none)'}
 Schema: ${schema ?? '(none)'}
 allSchemas: ${allSchemas ?? false}
@@ -173,9 +178,10 @@ For the assistant:
 - Summarise the most likely cause from the CLI output in plain language. Common causes:
   * Config file not found — suggest verifying the config path and that the file exists.
   * Database connection failed — suggest verifying credentials, host, and port.
-  * Output target missing or invalid (the CLI requires --output unless --dry-run).
-  * Output file exists without --force — suggest passing force=true if the user really wants to overwrite, or picking a different output path.
+  * Schema path missing or invalid — the CLI requires --schema-path for every mode, including dry-run.
+  * Output file exists without --force — suggest passing force=true if the user really wants to overwrite, or picking a different schema path.
   * Conflicting flags — e.g. table together with allSchemas, or schema together with allSchemas. The CLI rejects these combinations; suggest picking a single mode.
+  * Soft-delete contract violation (PostgreSQL) — the output contains "introspect blocked for table". This is a strict block, NOT a generic failure: the message lists the exact non-conformance (partial columns, wrong types, or missing consistency CHECK) and concrete mitigation options (possibly including a ready-to-run ALTER TABLE statement). Present the full blocked-table message including its options to the user — this is an exception to the no-paste rule below.
   * Unknown command 'schema introspect' — 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.
 - Offer to retry once the issue is resolved.`,
@@ -216,7 +222,7 @@ For the assistant:
 Project path: ${projectCwd}
 Config: ${config}
 Mode: ${modeLabel}
-Output target: ${output ?? '(none — dry-run)'}
+Schema path: ${schemaPath}
 Table: ${table ?? '(not specified)'}
 Schema: ${schema ?? '(not specified)'}
 allSchemas: ${allSchemas ?? false}

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

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