@dforge-core/dforge-mcp 0.1.0-rc.1

package/resources/schemas/entity.schema.json

@@ -0,0 +1,444 @@
+{
+	"$schema": "http://json-schema.org/draft-07/schema#",
+	"$id": "https://dforge.dev/schemas/entity.schema.json",
+	"title": "dForge Entity Definition",
+	"description": "Defines an entity (table/view mapping) for a dForge module",
+	"type": "object",
+	"required": ["fields"],
+	"properties": {
+		"extends": {
+			"type": "string",
+			"pattern": "^[a-z][a-z0-9_]*\\.[a-z][a-z0-9_]*$",
+			"description": "Qualified entity code of the target entity to extend (e.g. 'fin.invoice'). When set, this entity definition adds columns to an existing entity owned by another module instead of creating a new entity. Physical columns are stored in a 1:1 extension table."
+		},
+		"description": {
+			"type": "string",
+			"description": "Human-readable description of the entity"
+		},
+		"schema": {
+			"type": "string",
+			"description": "Database schema name override (defaults to module schema)"
+		},
+		"dbObject": {
+			"type": "string",
+			"description": "Database table or view name (defaults to entity code)"
+		},
+		"isView": {
+			"type": "boolean",
+			"description": "When true, entity maps to a SQL view (read-only, no DDL generation). Default: false (table-backed).",
+			"default": false
+		},
+		"viewSql": {
+			"type": "string",
+			"description": "SQL SELECT statement for view-backed entities (isView=true). Executed as CREATE OR REPLACE VIEW during module install."
+		},
+		"toString": {
+			"type": "string",
+			"description": "Display pattern using column placeholders, e.g. \"{first_name} {last_name}\""
+		},
+		"traits": {
+			"type": "array",
+			"description": "Entity traits expanded during module install (authoring shortcut). Trait definitions loaded from DB (seeded by metadata module).",
+			"items": {
+				"type": "string",
+				"enum": ["identity", "audit", "audit-full", "soft-delete", "sorting", "postable", "accumulation", "ledger", "period", "file-library"]
+			},
+			"uniqueItems": true
+		},
+		"fields": {
+			"type": "object",
+			"description": "Column definitions keyed by column code",
+			"additionalProperties": {
+				"$ref": "#/$defs/field"
+			}
+		},
+		"constraints": {
+			"type": "object",
+			"description": "Database constraints (unique, check, etc.)"
+		},
+		"references": {
+			"type": "object",
+			"description": "Foreign key reference definitions (legacy format, prefer 'link' on field)",
+			"additionalProperties": {
+				"$ref": "#/$defs/entityReference"
+			}
+		},
+		"indexes": {
+			"type": "object",
+			"description": "Database index definitions"
+		},
+		"numberSequence": {
+			"$ref": "#/$defs/numberSequence",
+			"description": "Automatic document numbering configuration for this entity"
+		},
+		"period": {
+			"$ref": "#/$defs/periodConfig",
+			"description": "Period entity configuration. Requires 'period' trait."
+		},
+		"accumulation": {
+			"$ref": "#/$defs/accumulationConfig",
+			"description": "Accumulation registry configuration (simple document without lines). Requires 'accumulation' trait."
+		},
+		"params": {
+			"type": "object",
+			"description": "Entity-level parameters for platform behavior flags",
+			"properties": {
+				"restricted": {
+					"type": "boolean",
+					"description": "When true, blocks generic data.get/data.set access. Entity must be accessed via dedicated API methods.",
+					"default": false
+				}
+			},
+			"additionalProperties": true
+		}
+	},
+	"additionalProperties": false,
+	"$defs": {
+		"field": {
+			"type": "object",
+			"description": "Entity column/field definition",
+			"properties": {
+				"dbDatatype": {
+					"type": "string",
+					"description": "PostgreSQL data type (e.g. uuid, varchar, int4, bool, text, json, numeric, date, timestamp, timestamptz, bpchar)"
+				},
+				"baseDatatypeCd": {
+					"type": "string",
+					"enum": ["binary", "bool", "cuid", "culture", "date", "guid", "link", "number", "project", "string", "time", "timestamp", "xml", "json"],
+					"description": "Base data type code from field_type table (e.g. string, number, boolean, date, time, timestamp, json, binary)"
+				},
+				"columnType": {
+					"type": "string",
+					"enum": ["D", "R", "S", "F", "A", "L", "G"],
+					"description": "Column type: D=Data (physical column), R=Reference (N:1 lookup), S=Set (1:N collection), F=Formula (virtual calculated), G=Generated/Computed (physical, auto-maintained), A=Accumulation registry, L=Ledger registry"
+				},
+				"fieldTypeCd": {
+					"type": "string",
+					"enum": [
+						"text", "email", "phone", "url", "textarea", "number", "currency", "percent",
+						"checkbox", "date", "datetime", "time",
+						"dropdown", "flags", "tags", "json", "hidden", "color", "image", "file",
+						"richtext", "lookup", "user", "grid", "entitylink", "code"
+					],
+					"description": "UI field type code from field_type table"
+				},
+				"flags": {
+					"type": "string",
+					"pattern": "^[VIEMH]*$",
+					"description": "Display flags: V=Visible, I=Identity, E=Editable, M=Mandatory, H=Hidden"
+				},
+				"isPk": {
+					"type": "boolean",
+					"description": "Whether this column is part of the primary key"
+				},
+				"isNullable": {
+					"type": "boolean",
+					"description": "Whether the column allows NULL values"
+				},
+				"isIdentity": {
+					"type": "boolean",
+					"description": "Whether the column value is auto-generated (e.g. CUID primary key). Identity columns are not editable and excluded from required validation."
+				},
+				"formula": {
+					"type": "string",
+					"description": "Formula expression (for columnType 'F' or default values)"
+				},
+				"orderNum": {
+					"type": "integer",
+					"description": "Display order number"
+				},
+				"description": {
+					"type": "string",
+					"description": "Human-readable column description"
+				},
+				"maxLen": {
+					"type": "integer",
+					"description": "Maximum length for varchar/text columns"
+				},
+				"precision": {
+					"type": "integer",
+					"description": "Numeric precision for decimal/currency columns"
+				},
+				"editMask": {
+					"type": "string",
+					"description": "Input mask pattern for editing"
+				},
+				"displayFmt": {
+					"type": "string",
+					"description": "Display format pattern"
+				},
+				"params": {
+					"type": "object",
+					"description": "Field-type-specific configuration (e.g. dropdown options, currency settings)",
+					"properties": {
+						"options": {
+							"type": "array",
+							"items": {
+								"oneOf": [
+									{ "type": "string" },
+									{
+										"type": "object",
+										"required": ["value", "label"],
+										"properties": {
+											"value": { "type": "string" },
+											"label": { "type": "string" },
+											"icon": { "type": "string" },
+											"color": { "type": "string" }
+										},
+										"additionalProperties": false
+									}
+								]
+							},
+							"description": "Options for dropdown/flags field types"
+						}
+					}
+				},
+				"link": {
+					"$ref": "#/$defs/fieldLink",
+					"description": "Relationship link for Reference (R) and Set (S) columns"
+				},
+				"refFilter": {
+					"description": "Filter criteria for reference lookups"
+				}
+			},
+			"oneOf": [
+				{
+					"title": "Data column",
+					"description": "Physical DB column (columnType 'D' or unspecified). Requires 'dbDatatype'. Must NOT have 'link'.",
+					"required": ["dbDatatype"],
+					"properties": {
+						"columnType": { "enum": ["D"] },
+						"link": false
+					}
+				},
+				{
+					"title": "Inferred-type column",
+					"description": "Physical column where dbDatatype is inferred from fieldTypeCd (e.g. user, color)",
+					"required": ["fieldTypeCd"],
+					"properties": {
+						"columnType": { "enum": ["D"] },
+						"link": false,
+						"dbDatatype": false
+					}
+				},
+				{
+					"title": "Reference column (R)",
+					"description": "N:1 lookup (columnType 'R'). Requires 'link' and 'fieldTypeCd'. Must NOT have 'dbDatatype'.",
+					"required": ["columnType", "fieldTypeCd", "link"],
+					"properties": {
+						"columnType": { "const": "R" },
+						"dbDatatype": false
+					}
+				},
+				{
+					"title": "Set column (S)",
+					"description": "1:N collection (columnType 'S'). Requires 'link' and 'fieldTypeCd'. Must NOT have 'dbDatatype'.",
+					"required": ["columnType", "fieldTypeCd", "link"],
+					"properties": {
+						"columnType": { "const": "S" },
+						"dbDatatype": false
+					}
+				},
+				{
+					"title": "Formula column (F)",
+					"description": "Calculated virtual column (columnType 'F'). Requires 'formula'. Must NOT have 'link' or 'dbDatatype'.",
+					"required": ["columnType", "formula", "baseDatatypeCd"],
+					"properties": {
+						"columnType": { "const": "F" },
+						"link": false,
+						"baseDatatypeCd": true,
+						"dbDatatype": false
+					}
+				},
+				{
+					"title": "Accumulation registry column (A)",
+					"description": "Accumulation registry state (bool) + config. Physical column storing posted state. Config in params defines balance entity, dimensions, resources.",
+					"required": ["columnType", "dbDatatype", "params"],
+					"properties": {
+						"columnType": { "const": "A" },
+						"dbDatatype": { "const": "bool" },
+						"link": false
+					}
+				},
+				{
+					"title": "Ledger registry column (L)",
+					"description": "Ledger registry state (bool) + config. Physical column storing posted state. Config in params defines lines, movement entity, balance entity.",
+					"required": ["columnType", "dbDatatype", "params"],
+					"properties": {
+						"columnType": { "const": "L" },
+						"dbDatatype": { "const": "bool" },
+						"link": false
+					}
+				},
+				{
+					"title": "Generated/Computed column (G)",
+					"description": "Physical column auto-computed by DB trigger (aggregate over child set) or PostgreSQL GENERATED ALWAYS AS (same-row expression). Requires 'dbDatatype' and 'formula'. Formula syntax: SUM([setCol].[childField]) for aggregates, or plain SQL expression for same-row generated columns.",
+					"required": ["columnType", "dbDatatype", "formula"],
+					"properties": {
+						"columnType": { "const": "G" },
+						"link": false
+					}
+				}
+			],
+			"required": ["orderNum", "description"],
+			"additionalProperties": false
+		},
+		"fieldLink": {
+			"type": "object",
+			"description": "Relationship definition for Reference and Set columns",
+			"required": ["entity", "thisKey", "otherKey"],
+			"properties": {
+				"entity": {
+					"type": "string",
+					"description": "Target entity code (the entity being referenced or collected)"
+				},
+				"thisKey": {
+					"type": "string",
+					"description": "Column(s) in this entity (comma-separated for compound keys)"
+				},
+				"otherKey": {
+					"type": "string",
+					"description": "Column(s) in the target entity (comma-separated for compound keys)"
+				}
+			},
+			"additionalProperties": false
+		},
+		"numberSequence": {
+			"type": "object",
+			"description": "Automatic document numbering. Auto-generates a formatted number on INSERT when the target column is empty.",
+			"required": ["column", "defaultPrefix"],
+			"properties": {
+				"column": {
+					"type": "string",
+					"description": "Column code that receives the auto-generated number"
+				},
+				"prefixSettingCd": {
+					"type": "string",
+					"description": "Module setting code to resolve the prefix from (folder-scoped inheritance)"
+				},
+				"defaultPrefix": {
+					"type": "string",
+					"description": "Fallback prefix when no setting is configured"
+				},
+				"pattern": {
+					"type": "string",
+					"description": "Number format pattern. Placeholders: {prefix}, {yyyy}, {yy}, {mm}, {dd}, {seq:N}",
+					"default": "{prefix}{yyyy}-{seq:3}"
+				},
+				"resetPeriod": {
+					"type": "string",
+					"enum": ["year", "month", "day", "never"],
+					"description": "Counter reset period",
+					"default": "year"
+				}
+			},
+			"additionalProperties": false
+		},
+		"periodConfig": {
+			"type": "object",
+			"description": "Configuration for entities with the 'period' trait. Defines how date values map to period keys.",
+			"required": ["keyFormat"],
+			"properties": {
+				"keyFormat": {
+					"type": "string",
+					"description": "Format string for deriving period key from a date. Placeholders: {yyyy}, {yy}, {MM}, {dd}, {q} (quarter 1-4).",
+					"examples": ["{yyyy}-{MM}", "{yyyy}-Q{q}", "FY{yyyy}"]
+				}
+			},
+			"additionalProperties": false
+		},
+		"accumulationConfig": {
+			"type": "object",
+			"description": "Configuration for simple accumulation (document without lines, e.g. receipt → stock).",
+			"required": ["balanceEntity", "dimensions", "resources"],
+			"properties": {
+				"balanceEntity": { "type": "string", "description": "Balance entity code (e.g. 'stock')" },
+				"dimensions": {
+					"description": "Balance row lookup dimensions. Array of field names (same name on both entities) or object mapping balance_field → document_field.",
+					"oneOf": [
+						{ "type": "array", "items": { "type": "string" } },
+						{ "type": "object", "additionalProperties": { "type": "string" } }
+					]
+				},
+				"resources": {
+					"type": "object",
+					"description": "Document field → balance field resource mappings",
+					"additionalProperties": {
+						"type": "object",
+						"required": ["balanceField"],
+						"properties": {
+							"balanceField": { "type": "string" }
+						}
+					}
+				},
+				"direction": { "type": "string", "enum": ["increase", "decrease"], "description": "Fixed direction for all postings" },
+				"sign": { "$ref": "#/$defs/signConfig", "description": "Dynamic sign based on a field value (alternative to direction)" },
+				"autoCreateBalance": { "type": "boolean", "default": true },
+				"allowNegative": { "type": "boolean", "default": true },
+				"lockedFields": { "type": "array", "items": { "type": "string" }, "description": "Document fields locked when posted" }
+			},
+			"additionalProperties": false
+		},
+		"signConfig": {
+			"type": "object",
+			"description": "Dynamic sign determination based on a field value",
+			"required": ["field", "positive", "negative"],
+			"properties": {
+				"field": { "type": "string", "description": "Field code that determines direction" },
+				"positive": { "type": "array", "items": { "type": "string" }, "description": "Values that mean increase" },
+				"negative": { "type": "array", "items": { "type": "string" }, "description": "Values that mean decrease" }
+			},
+			"additionalProperties": false
+		},
+		"ledgerRegistryEntry": {
+			"type": "object",
+			"description": "Single registry target within an L-column's registries array",
+			"required": ["movementEntity", "movementMapping", "balanceEntity", "balanceMapping"],
+			"properties": {
+				"movementEntity": { "type": "string", "description": "Movement entity code (e.g. 'posting_record')" },
+				"movementMapping": {
+					"type": "object",
+					"description": "Line field → movement field mapping",
+					"additionalProperties": { "type": "string" }
+				},
+				"balanceEntity": { "type": "string", "description": "Balance entity code (e.g. 'balance_register')" },
+				"balanceMapping": {
+					"type": "object",
+					"required": ["dimensions", "debitResource", "creditResource"],
+					"properties": {
+						"dimensions": { "type": "array", "items": { "type": "string" }, "description": "Balance row dimension columns" },
+						"debitResource": { "type": "string", "description": "Balance column for debit turnover" },
+						"creditResource": { "type": "string", "description": "Balance column for credit turnover" }
+					},
+					"additionalProperties": false
+				}
+			},
+			"additionalProperties": false
+		},
+		"entityReference": {
+			"type": "object",
+			"description": "Foreign key reference definition (legacy format)",
+			"required": ["from", "to"],
+			"properties": {
+				"from": {
+					"type": "object",
+					"required": ["field"],
+					"properties": {
+						"field": { "type": "string" }
+					},
+					"additionalProperties": false
+				},
+				"to": {
+					"type": "object",
+					"required": ["entity", "field"],
+					"properties": {
+						"entity": { "type": "string" },
+						"field": { "type": "string" }
+					},
+					"additionalProperties": false
+				}
+			},
+			"additionalProperties": false
+		}
+	}
+}

package/resources/schemas/manifest.schema.json

@@ -0,0 +1,100 @@
+{
+	"$schema": "http://json-schema.org/draft-07/schema#",
+	"$id": "https://dforge.dev/schemas/manifest.schema.json",
+	"title": "dForge Module Manifest",
+	"description": "Module package manifest defining metadata, dependencies, and entity references",
+	"type": "object",
+	"required": ["packageFormat", "moduleId", "code", "version", "dbSchemaVersion", "displayName"],
+	"properties": {
+		"packageFormat": {
+			"type": "integer",
+			"minimum": 1,
+			"description": "Package format version (currently 1)"
+		},
+		"moduleId": {
+			"type": "string",
+			"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
+			"description": "Globally unique module UUID"
+		},
+		"code": {
+			"type": "string",
+			"pattern": "^[a-z][a-z0-9_-]*$",
+			"description": "Human-readable module code (becomes schema name and module_cd in DB)"
+		},
+		"version": {
+			"type": "string",
+			"pattern": "^\\d+\\.\\d+\\.\\d+",
+			"description": "Module version (semver)"
+		},
+		"dbSchemaVersion": {
+			"type": "string",
+			"pattern": "^\\d+\\.\\d+\\.\\d+",
+			"description": "Database schema version (semver)"
+		},
+		"displayName": {
+			"type": "string",
+			"description": "Human-readable module name"
+		},
+		"description": {
+			"type": "string",
+			"description": "Module description"
+		},
+		"schemaName": {
+			"type": "string",
+			"description": "Database schema name override (defaults to module code, system modules use 'dForge')"
+		},
+		"system": {
+			"type": "boolean",
+			"description": "System module flag (cannot be uninstalled, admin-only). Omit for regular modules."
+		},
+		"author": {
+			"type": "object",
+			"properties": {
+				"name": {
+					"type": "string",
+					"description": "Author name"
+				},
+				"url": {
+					"type": "string",
+					"description": "Author URL"
+				}
+			},
+			"required": ["name"],
+			"additionalProperties": false
+		},
+		"license": {
+			"type": "string",
+			"description": "License identifier (e.g. 'proprietary', 'MIT')"
+		},
+		"dependencies": {
+			"type": "object",
+			"description": "Module dependencies: module code → semver range",
+			"additionalProperties": {
+				"type": "string",
+				"description": "Semver version range (e.g. '>=1.0.0')"
+			}
+		},
+		"entities": {
+			"type": "object",
+			"description": "Entity definitions and extensions: entity code → relative path to entity JSON file. Dotted keys (e.g. 'fin.invoice') indicate extensions of other modules' entities (the entity file must have an 'extends' property).",
+			"additionalProperties": {
+				"type": "string",
+				"pattern": "^(\\./)?entities/.+\\.json$"
+			}
+		},
+		"category": {
+			"type": "string",
+			"description": "Module category for display (e.g. 'Integration', 'Finance')"
+		},
+		"icon": {
+			"type": "string",
+			"description": "Bootstrap icon class (e.g. 'bi-link-45deg')"
+		},
+		"supportedLocales": {
+			"type": "array",
+			"items": { "type": "string", "pattern": "^[a-z]{2,3}(-[A-Z]{2})?$" },
+			"description": "Non-English locales the package promises to translate. Each entry MUST match a translations/<locale>.json file, and every translatable resource (entity/field labels, folders, views, menus + items, actions + params, reports + datasets + params, settings) MUST have a label in that file. English is the default — don't list 'en' or 'en-US'."
+		}
+	},
+	"additionalProperties": false
+}

package/skills/dforge-mcp-author/SKILL.md

@@ -0,0 +1,107 @@
+---
+name: dforge-mcp-author
+description: Author dForge modules using the dforge-mcp tool surface. Use when the user has the @dforge-core/dforge-mcp MCP server connected and asks to scaffold, extend, pack, or install a dForge module. Replaces hand-writing JSON files with structured tool calls that produce schema-valid output on the first try.
+---
+
+# dForge Module Author (MCP-driven)
+
+You're authoring a dForge module via the `dforge-mcp` MCP server. dForge is a metadata-driven, multi-tenant business platform — modules are JSON metadata + DSL scripts.
+
+**Your edge here** is that you have *tools*, not just text generation. Always prefer a tool call over writing a file by hand. Every tool either returns a file map (so the user can preview before commit) or shells out to the validated native CLI.
+
+---
+
+## Tool surface
+
+| Tool | What it does | Returns |
+|---|---|---|
+| `dforge_module_create` | Build a brand-new module's file map | `{ files: {...} }` — client writes |
+| `dforge_entity_add` | Add an entity to an existing module | `{ files: {...}, warning?: ... }` — client writes |
+| `dforge_module_pack` | Pack a module dir into a `.dforge` tarball | `{ tarballPath, sizeBytes }` (writes the tarball) |
+| `dforge_module_install` | Install a module to a tenant | `{ ok, output }` (live action) |
+| `dforge_dbml_import` | Generate from DBML (stub) | not yet implemented |
+
+## Resources
+
+Read these *before* generating any module content so your output matches the canonical schema:
+
+- `dforge://schema/manifest` — manifest.json shape (required fields, patterns)
+- `dforge://schema/entity` — entity JSON shape (fields, traits, refs)
+- `dforge://schema/data-view` — data view shape (viewType, dataSources)
+- `dforge://docs/conventions` — naming, FK+Reference pattern, traits, security model
+
+Load them when you start a session, not after a wrong guess.
+
+---
+
+## Standard workflow
+
+### 1. Gather requirements (one short turn)
+
+Ask the user, in order:
+1. **What's the module for?** One sentence is enough.
+2. **What's the module code?** Lowercase, hyphen-or-underscore, e.g. `crm`, `pm`, `hr-admin`.
+3. **What entities does it own?** Rough list with one-line descriptions each.
+4. **Greenfield or extending an existing module?** If extending, ask which.
+
+Don't ask about field types, view layouts, or DSL actions yet — those come *after* a working skeleton.
+
+### 2. Read the schemas + conventions
+
+Pull `dforge://schema/manifest`, `dforge://schema/entity`, and `dforge://docs/conventions` into context. Skim, don't memorise.
+
+### 3. Call `dforge_module_create`
+
+Pass:
+- `code`, `displayName`, `description` from the user's answers
+- `entities`: array of `{ name, label, traits }` — default traits to `"identity+audit"`
+- `preset`: `"minimal"` unless the user wants full template (settings/translations/seed)
+- `dependencies`: usually `["admin", "metadata"]` — both are required for typical modules
+
+You'll get back `{ summary, files: { "<relPath>": "<contents>", ... } }`.
+
+### 4. Preview the file map with the user
+
+Show the file list (paths only) + the manifest contents. Ask "write these to `./<code>`?". Don't write without confirmation.
+
+### 5. Write the files
+
+Use your filesystem tool (Write / bash heredoc / fs.writeFileSync, whatever your client offers). Each value in `files` is the literal file contents — including JSON indentation. Don't re-format.
+
+### 6. Iterate
+
+Use `dforge_entity_add` to add more entities incrementally — it reads the existing manifest, regenerates the dependent UI/security files, and returns ONLY the files that change. Re-preview each time before writing.
+
+For fields, ref columns, actions, formulas, settings, reports — write those directly into the entity JSON / new files under `logic/`, `ui/`, etc. The schemas are your guide; the tools don't (yet) cover field-level changes.
+
+### 7. Pack + install
+
+Once the module is shaped right:
+1. `dforge_module_pack` with `moduleDir: "./<code>"` → returns the tarball path.
+2. (Optional) `dforge_module_install` with `pathOrTarball: <tarballPath or moduleDir>` and a `tenantUrl` + `token` (or rely on `DFORGE_URL`/`DFORGE_TOKEN` env). This runs the *full* server-side validator — the only validator available. Surface its output verbatim; if it fails, fix and re-pack.
+
+---
+
+## Hard rules
+
+- **Always preview file maps before writing.** Tools return — the user decides.
+- **Use `dforge_entity_add`, not regenerate-from-scratch.** It preserves the existing manifest's UUID, version, dependencies, etc.
+- **Tabs in JSON.** All emitted files use `\t` indentation. Don't re-pretty-print with spaces.
+- **Don't invent `code` or `moduleId`.** `code` comes from the user; `moduleId` is auto-generated by the tool (UUID). Never hand-write a UUID.
+- **Refer to the conventions doc for FK+Reference, traits, flags.** The MCP server doesn't enforce these — your output does. The first install will catch violations, but a clean first install is the goal.
+
+---
+
+## When NOT to use the tools
+
+- **Modifying a single existing field in an entity JSON.** Just edit the file.
+- **Writing an action DSL script.** No tool for that — write to `logic/actions/<name>.dsl` directly. Reference the `dforge://docs/conventions` doc for DSL syntax.
+- **Querying live tenant state.** No tool for that either — shell out to `dforge-cli` via your bash tool if the user has it installed.
+
+---
+
+## Sanity check before declaring done
+
+- `dforge_module_pack` succeeded → archive size is non-trivial (>100 KB usually)
+- `dforge_module_install --code <tenant>` exited 0 → server validated everything
+- The user confirms the install log looks right (entities created, no warnings about missing translations / orphan rights)