@dforge-core/dforge-cli 0.2.16 → 0.2.18

package/dist/cli.js

@@ -272,7 +272,7 @@ function fD({ input: e2 = import_node_process.stdin, output: u2 = import_node_pr
     e2.off("keypress", i), F2 && u2.write(import_sisteransi.cursor.show), e2.isTTY && !AD && e2.setRawMode(false), s.terminal = false, s.close();
   };
 }
-var import_sisteransi, import_node_process, g, import_node_readline, import_node_stream, import_picocolors, uD, W, tD, eD, FD, sD, w, N, I, R, r, iD, CD, ED, d, oD, y, V, nD, G, _, z, K, aD, k, hD, lD, xD, B, AD, S, gD, vD, h, x, dD, A, kD, $D, H, SD, OD, PD, J, LD, RD;
+var import_sisteransi, import_node_process, g, import_node_readline, import_node_stream, import_picocolors, uD, W, tD, eD, FD, sD, w, N, I, R, r, iD, CD, ED, d, oD, y, V, nD, G, _, z, K, aD, k, hD, lD, xD, B, AD, S, gD, vD, h, x, dD, A, OD, PD, J, LD, RD;
 var init_dist = __esm({
   "node_modules/.pnpm/@clack+core@0.5.0/node_modules/@clack/core/dist/index.mjs"() {
     "use strict";
@@ -514,41 +514,6 @@ var init_dist = __esm({
       }
     };
     A = /* @__PURE__ */ new WeakMap();
-    kD = Object.defineProperty;
-    $D = (e2, u2, t) => u2 in e2 ? kD(e2, u2, { enumerable: true, configurable: true, writable: true, value: t }) : e2[u2] = t;
-    H = (e2, u2, t) => ($D(e2, typeof u2 != "symbol" ? u2 + "" : u2, t), t);
-    SD = class extends x {
-      constructor(u2) {
-        super(u2, false), H(this, "options"), H(this, "cursor", 0), this.options = u2.options, this.value = [...u2.initialValues ?? []], this.cursor = Math.max(this.options.findIndex(({ value: t }) => t === u2.cursorAt), 0), this.on("key", (t) => {
-          t === "a" && this.toggleAll();
-        }), this.on("cursor", (t) => {
-          switch (t) {
-            case "left":
-            case "up":
-              this.cursor = this.cursor === 0 ? this.options.length - 1 : this.cursor - 1;
-              break;
-            case "down":
-            case "right":
-              this.cursor = this.cursor === this.options.length - 1 ? 0 : this.cursor + 1;
-              break;
-            case "space":
-              this.toggleValue();
-              break;
-          }
-        });
-      }
-      get _value() {
-        return this.options[this.cursor].value;
-      }
-      toggleAll() {
-        const u2 = this.value.length === this.options.length;
-        this.value = u2 ? [] : this.options.map((t) => t.value);
-      }
-      toggleValue() {
-        const u2 = this.value.includes(this._value);
-        this.value = u2 ? this.value.filter((t) => t !== this._value) : [...this.value, this._value];
-      }
-    };
     OD = Object.defineProperty;
     PD = (e2, u2, t) => u2 in e2 ? OD(e2, u2, { enumerable: true, configurable: true, writable: true, value: t }) : e2[u2] = t;
     J = (e2, u2, t) => (PD(e2, typeof u2 != "symbol" ? u2 + "" : u2, t), t);
@@ -598,7 +563,7 @@ var init_dist = __esm({
 function ce() {
   return import_node_process2.default.platform !== "win32" ? import_node_process2.default.env.TERM !== "linux" : !!import_node_process2.default.env.CI || !!import_node_process2.default.env.WT_SESSION || !!import_node_process2.default.env.TERMINUS_SUBLIME || import_node_process2.default.env.ConEmuTask === "{cmd::Cmder}" || import_node_process2.default.env.TERM_PROGRAM === "Terminus-Sublime" || import_node_process2.default.env.TERM_PROGRAM === "vscode" || import_node_process2.default.env.TERM === "xterm-256color" || import_node_process2.default.env.TERM === "alacritty" || import_node_process2.default.env.TERMINAL_EMULATOR === "JetBrains-JediTerm";
 }
-var import_node_util, import_node_process2, import_picocolors2, import_sisteransi2, V2, u, le, L2, W2, C, ue, o, d2, k2, P2, A2, T, F, $e, _2, me, de, pe, q, D, U, K2, b2, G2, he, ye, ve, fe, xe, Ie, Se, J2, Y2, Ce;
+var import_node_util, import_node_process2, import_picocolors2, import_sisteransi2, V2, u, le, L2, W2, C, ue, o, d2, k2, P2, A2, T, F, $e, _2, me, de, pe, q, D, U, K2, b2, G2, he, ye, ve, xe, Ie, Se, J2, Y2, Ce;
 var init_dist2 = __esm({
   "node_modules/.pnpm/@clack+prompts@0.11.0/node_modules/@clack/prompts/dist/index.mjs"() {
     "use strict";
@@ -722,46 +687,6 @@ ${import_picocolors2.default.gray(o)}`;
             return `${r2}${import_picocolors2.default.cyan(o)}  ${G2({ cursor: this.cursor, options: this.options, maxItems: t.maxItems, style: (i, s) => n(i, s ? "active" : "inactive") }).join(`
 ${import_picocolors2.default.cyan(o)}  `)}
 ${import_picocolors2.default.cyan(d2)}
-`;
-        }
-      } }).prompt();
-    };
-    fe = (t) => {
-      const n = (r2, i) => {
-        const s = r2.label ?? String(r2.value);
-        return i === "active" ? `${import_picocolors2.default.cyan(A2)} ${s} ${r2.hint ? import_picocolors2.default.dim(`(${r2.hint})`) : ""}` : i === "selected" ? `${import_picocolors2.default.green(T)} ${import_picocolors2.default.dim(s)} ${r2.hint ? import_picocolors2.default.dim(`(${r2.hint})`) : ""}` : i === "cancelled" ? `${import_picocolors2.default.strikethrough(import_picocolors2.default.dim(s))}` : i === "active-selected" ? `${import_picocolors2.default.green(T)} ${s} ${r2.hint ? import_picocolors2.default.dim(`(${r2.hint})`) : ""}` : i === "submitted" ? `${import_picocolors2.default.dim(s)}` : `${import_picocolors2.default.dim(F)} ${import_picocolors2.default.dim(s)}`;
-      };
-      return new SD({ options: t.options, initialValues: t.initialValues, required: t.required ?? true, cursorAt: t.cursorAt, validate(r2) {
-        if (this.required && r2.length === 0) return `Please select at least one option.
-${import_picocolors2.default.reset(import_picocolors2.default.dim(`Press ${import_picocolors2.default.gray(import_picocolors2.default.bgWhite(import_picocolors2.default.inverse(" space ")))} to select, ${import_picocolors2.default.gray(import_picocolors2.default.bgWhite(import_picocolors2.default.inverse(" enter ")))} to submit`))}`;
-      }, render() {
-        const r2 = `${import_picocolors2.default.gray(o)}
-${b2(this.state)}  ${t.message}
-`, i = (s, c) => {
-          const a = this.value.includes(s.value);
-          return c && a ? n(s, "active-selected") : a ? n(s, "selected") : n(s, c ? "active" : "inactive");
-        };
-        switch (this.state) {
-          case "submit":
-            return `${r2}${import_picocolors2.default.gray(o)}  ${this.options.filter(({ value: s }) => this.value.includes(s)).map((s) => n(s, "submitted")).join(import_picocolors2.default.dim(", ")) || import_picocolors2.default.dim("none")}`;
-          case "cancel": {
-            const s = this.options.filter(({ value: c }) => this.value.includes(c)).map((c) => n(c, "cancelled")).join(import_picocolors2.default.dim(", "));
-            return `${r2}${import_picocolors2.default.gray(o)}  ${s.trim() ? `${s}
-${import_picocolors2.default.gray(o)}` : ""}`;
-          }
-          case "error": {
-            const s = this.error.split(`
-`).map((c, a) => a === 0 ? `${import_picocolors2.default.yellow(d2)}  ${import_picocolors2.default.yellow(c)}` : `   ${c}`).join(`
-`);
-            return `${r2 + import_picocolors2.default.yellow(o)}  ${G2({ options: this.options, cursor: this.cursor, maxItems: t.maxItems, style: i }).join(`
-${import_picocolors2.default.yellow(o)}  `)}
-${s}
-`;
-          }
-          default:
-            return `${r2}${import_picocolors2.default.cyan(o)}  ${G2({ options: this.options, cursor: this.cursor, maxItems: t.maxItems, style: i }).join(`
-${import_picocolors2.default.cyan(o)}  `)}
-${import_picocolors2.default.cyan(d2)}
 `;
         }
       } }).prompt();
@@ -802,7 +727,7 @@ ${import_picocolors2.default.gray(d2)}  ${t}
       }, R2 = (m2) => m2.replace(/\.+$/, ""), O2 = (m2) => {
         const h2 = (performance.now() - m2) / 1e3, w2 = Math.floor(h2 / 60), I2 = Math.floor(h2 % 60);
         return w2 > 0 ? `[${w2}m ${I2}s]` : `[${I2}s]`;
-      }, H2 = (m2 = "") => {
+      }, H = (m2 = "") => {
         a = true, s = fD(), l2 = R2(m2), g2 = performance.now(), process.stdout.write(`${import_picocolors2.default.gray(o)}
 `);
         let h2 = 0, w2 = 0;
@@ -825,7 +750,7 @@ ${import_picocolors2.default.gray(d2)}  ${t}
 `) : process.stdout.write(`${w2}  ${l2}
 `), E(), s();
       };
-      return { start: H2, stop: N2, message: (m2 = "") => {
+      return { start: H, stop: N2, message: (m2 = "") => {
         l2 = R2(m2 ?? l2);
       } };
     };
@@ -902,19 +827,46 @@ function buildManifest(opts, moduleId) {
   if (opts.license) manifest.license = opts.license;
   if (opts.dependencies.length > 0) {
     manifest.dependencies = Object.fromEntries(
-      opts.dependencies.map((d3) => [d3, ">=0.0.1"])
+      opts.dependencies.map(
+        (d3) => typeof d3 === "string" ? [d3, DEPENDENCY_RANGE] : [d3.module, { version: DEPENDENCY_RANGE, entities: d3.entities }]
+      )
     );
   }
   return manifest;
 }
+function buildDepsContract(dep, consumerCode) {
+  return {
+    module: dep.module,
+    version: DEPENDENCY_RANGE,
+    entities: Object.fromEntries(
+      dep.entities.map((e2) => [
+        e2,
+        { pk: `${e2}_id`, use: [`ref:${consumerCode}`] }
+      ])
+    )
+  };
+}
 function buildEntity(entity) {
   const traits = entity.traits === "identity+audit" ? ["identity", "audit"] : ["identity"];
   const built = {
     description: entity.label,
     dbObject: entity.name,
-    toString: "{id}",
+    // The traits only add a PK and audit stamps, so an entity with no fields
+    // of its own has nothing renderable: its grid view fails the data-view
+    // column check and `toString` has nothing to interpolate. Scaffold one
+    // visible name column so the module validates and the grid shows a row.
+    toString: `{${NAME_FIELD}}`,
     traits,
-    fields: {}
+    fields: {
+      [NAME_FIELD]: {
+        dbDatatype: "varchar",
+        fieldTypeCd: "text",
+        flags: "VEM",
+        maxLen: 200,
+        orderNum: 10,
+        description: "Name"
+      }
+    }
   };
   if (entity.constraints?.length) {
     built.constraints = Object.fromEntries(
@@ -999,7 +951,8 @@ function buildTranslations(opts) {
   for (const e2 of opts.entities) {
     const fields = {
       // identity trait → primary key column
-      [`${e2.name}_id`]: { label: `${e2.label} ID` }
+      [`${e2.name}_id`]: { label: `${e2.label} ID` },
+      [NAME_FIELD]: { label: "Name" }
     };
     if (e2.traits === "identity+audit") {
       fields.created_date = { label: "Created Date" };
@@ -1040,8 +993,9 @@ function buildTranslations(opts) {
     }
   };
 }
-function buildSeedData() {
-  return [];
+function buildSeedData(entity) {
+  const entityCode = typeof entity === "string" ? entity : entity?.name ?? "";
+  return { entityCode, records: [] };
 }
 function buildGitignore() {
   return [
@@ -1055,30 +1009,78 @@ function buildGitignore() {
     ""
   ].join("\n");
 }
+function schemaEntries() {
+  return SCHEMA_BINDINGS.map((b3) => ({
+    fileMatch: b3.fileMatch,
+    url: `${SCHEMA_BASE}/${b3.schema}.schema.json`
+  }));
+}
 function buildVscodeSettings() {
-  return {
-    "json.schemas": SCHEMA_BINDINGS.map((b3) => ({
-      fileMatch: b3.fileMatch,
-      url: `${SCHEMA_BASE}/${b3.schema}.schema.json`
-    }))
-  };
+  return { "json.schemas": schemaEntries() };
 }
 function buildZedSettings() {
   return {
-    languages: {
-      JSON: {
-        "json.schemas": SCHEMA_BINDINGS.map((b3) => ({
-          fileMatch: b3.fileMatch,
-          url: `${SCHEMA_BASE}/${b3.schema}.schema.json`
-        }))
+    lsp: {
+      "json-language-server": {
+        settings: { json: { schemas: schemaEntries() } }
+      }
+    },
+    context_servers: {
+      dforge: {
+        source: "custom",
+        command: "npx",
+        args: ["-y", "@dforge-core/dforge-mcp@latest"],
+        env: {}
       }
     }
   };
 }
-var SCHEMA_BASE, SCHEMA_BINDINGS;
+function buildZedTasks() {
+  const CLI = "npx";
+  const CLI_ARGS = ["-y", "@dforge-core/dforge-cli@latest"];
+  const DEFAULT_TENANT = "http://localhost:5179";
+  const task = (label, args) => ({
+    label: `dForge: ${label}`,
+    command: CLI,
+    args: [...CLI_ARGS, ...args],
+    cwd: "$ZED_WORKTREE_ROOT",
+    env: { DFORGE_URL: DEFAULT_TENANT },
+    use_new_terminal: false,
+    allow_concurrent_runs: false,
+    reveal: "always"
+  });
+  return [
+    task("Pack module", ["module", "pack", "$ZED_WORKTREE_ROOT"]),
+    // --force matches the extension's dev-loop default: without it the CLI
+    // skips the reinstall when the version hasn't changed and your edits
+    // silently never reach the tenant.
+    task("Install module to tenant", [
+      "module",
+      "install",
+      "--path",
+      "$ZED_WORKTREE_ROOT",
+      "--url",
+      "$DFORGE_URL",
+      "--force"
+    ]),
+    task("Sign in to tenant", [
+      "auth",
+      "login",
+      "--url",
+      "$DFORGE_URL",
+      "--login-url",
+      "$DFORGE_URL"
+    ]),
+    task("Show signed-in user", ["auth", "whoami", "--url", "$DFORGE_URL"]),
+    task("List installed modules", ["module", "list", "--url", "$DFORGE_URL"])
+  ];
+}
+var DEPENDENCY_RANGE, NAME_FIELD, SCHEMA_BASE, SCHEMA_BINDINGS;
 var init_templates = __esm({
   "src/init/templates.ts"() {
     "use strict";
+    DEPENDENCY_RANGE = ">=0.0.1";
+    NAME_FIELD = "name";
     SCHEMA_BASE = "https://cdn.jsdelivr.net/npm/@dforge-core/dforge-mcp@latest/resources/schemas";
     SCHEMA_BINDINGS = [
       { fileMatch: ["manifest.json"], schema: "manifest" },
@@ -1087,8 +1089,12 @@ var init_templates = __esm({
       { fileMatch: ["ui/folders.json"], schema: "folders" },
       { fileMatch: ["ui/menus.json"], schema: "menus" },
       { fileMatch: ["ui/reports.json"], schema: "reports" },
+      { fileMatch: ["ui/print_templates.json"], schema: "print-templates" },
       { fileMatch: ["security/roles.json"], schema: "roles" },
       { fileMatch: ["logic/jobs.json"], schema: "jobs" },
+      { fileMatch: ["logic/triggers.json"], schema: "triggers" },
+      { fileMatch: ["logic/webhooks.json"], schema: "webhooks" },
+      { fileMatch: ["deps/*.json"], schema: "deps" },
       { fileMatch: ["seed-data/*.json"], schema: "seed-data" },
       { fileMatch: ["settings.json"], schema: "settings" }
     ];
@@ -1156,6 +1162,12 @@ async function runInitModule(argv2) {
     Se(`Created module ${opts.code} at ${opts.path}`);
   }
   console.log("");
+  if (opts.dependencies.length > 0) {
+    const files = opts.dependencies.map((d3) => `deps/${typeof d3 === "string" ? d3 : d3.module}.json`).join(", ");
+    console.log(`Wrote ${files}. Correct each entity's 'pk' against the provider and`);
+    console.log("replace the placeholder 'use' token with the real usage before you pack.");
+    console.log("");
+  }
   console.log("Next steps:");
   console.log(`  cd ${path2.relative(process.cwd(), opts.path) || "."}`);
   console.log(`  dforge-cli module install --path . --code <tenant>`);
@@ -1266,11 +1278,33 @@ function buildOptsFromArgs(absPath, args) {
     license: args.license ?? "MIT",
     version,
     dbSchemaVersion,
-    dependencies: args.dependencies ?? ["admin", "metadata"],
+    dependencies: parseDependencies(args.dependencies ?? []),
     preset,
     entities
   };
 }
+function parseDependencies(tokens) {
+  return tokens.map((token) => {
+    const [module2, entityList] = token.split(":");
+    if (!module2 || !entityList) {
+      throw new Error(
+        `dforge-cli init module: --dependencies "${token}" must name the entities you consume, as module:entity[+entity]. Every dependency needs a deps/${module2 || "<module>"}.json contract declaring at least one entity, so a dependency with no named entity cannot be scaffolded. If you do not consume anything from it yet, leave it out and add it later with dforge_dependency_add.`
+      );
+    }
+    if (SYSTEM_MODULES.has(module2)) {
+      throw new Error(
+        `dforge-cli init module: '${module2}' is a system module \u2014 it is provisioned into every tenant, so depending on it buys nothing. Declare it by hand only to require a minimum platform version for a feature you use (e.g. "metadata": ">=1.5.0"), with a contract naming the entity that feature introduced.`
+      );
+    }
+    const entities = entityList.split("+").map((e2) => e2.trim()).filter(Boolean);
+    if (entities.length === 0) {
+      throw new Error(
+        `dforge-cli init module: --dependencies "${token}" names no entities after the colon.`
+      );
+    }
+    return { module: module2, entities };
+  });
+}
 function printModuleHelp() {
   console.log("Usage: dforge-cli init module <path> [options]");
   console.log("");
@@ -1285,7 +1319,8 @@ function printModuleHelp() {
   console.log("  --license <id>             Default: MIT");
   console.log("  --version <semver>         Default: 0.1.0");
   console.log("  --db-schema-version <ver>  Default: 0.0.1");
-  console.log("  --dependencies <a,b>       Default: admin,metadata");
+  console.log("  --dependencies <mod:ent>   Consumed module + entities, e.g. fin:invoice+line.");
+  console.log("                             Repeatable/comma-separated. Default: none.");
   console.log("  --preset <p>               minimal | minimal-plus | full  (default: minimal)");
   console.log("  --entity <name[,name\u2026]>    Entities to scaffold (default: item). Repeatable.");
   console.log("  --traits <t>               identity+audit | identity  (default: identity+audit)");
@@ -1328,15 +1363,6 @@ async function collectOpts(absPath) {
         initialValue: "0.0.1",
         validate: validateSemver
       }),
-      dependencies: () => fe({
-        message: "Depend on system modules (space to toggle)",
-        options: [
-          { value: "admin", label: "admin (required for most modules)" },
-          { value: "metadata", label: "metadata (required for most modules)" }
-        ],
-        initialValues: ["admin", "metadata"],
-        required: false
-      }),
       preset: () => ve({
         message: "Scaffold preset",
         options: [
@@ -1386,7 +1412,7 @@ async function collectOpts(absPath) {
     license: meta.license ?? "MIT",
     version: meta.version,
     dbSchemaVersion: meta.dbSchemaVersion,
-    dependencies: meta.dependencies ?? [],
+    dependencies: [],
     preset: meta.preset,
     entities
   };
@@ -1442,16 +1468,24 @@ function writeAll(opts) {
   writeJson(path2.join(root, "ui", "menus.json"), buildMenus(opts));
   writeJson(path2.join(root, "ui", "actions.json"), buildActions());
   writeJson(path2.join(root, "security", "roles.json"), buildRoles(opts));
+  for (const dep of opts.dependencies) {
+    if (typeof dep === "string") continue;
+    writeJson(
+      path2.join(root, "deps", `${dep.module}.json`),
+      buildDepsContract(dep, opts.code)
+    );
+  }
   writeText(path2.join(root, ".gitignore"), buildGitignore());
   writeJson(path2.join(root, ".vscode", "settings.json"), buildVscodeSettings());
   writeJson(path2.join(root, ".zed", "settings.json"), buildZedSettings());
+  writeJson(path2.join(root, ".zed", "tasks.json"), buildZedTasks());
   if (opts.preset === "full") {
     writeJson(path2.join(root, "settings.json"), buildSettings());
     writeJson(path2.join(root, "translations", "en-US.json"), buildTranslations(opts));
     for (const e2 of opts.entities) {
       writeJson(
         path2.join(root, "seed-data", `01-${e2.name}.json`),
-        buildSeedData()
+        buildSeedData(e2)
       );
     }
     ensureDir(path2.join(root, "logic", "actions"));
@@ -1480,7 +1514,7 @@ function tryGitUserName() {
     return void 0;
   }
 }
-var fs2, path2, import_node_child_process2, import_node_crypto, CANCEL_EXIT, PRESETS, TRAITS_VALUES;
+var fs2, path2, import_node_child_process2, import_node_crypto, CANCEL_EXIT, PRESETS, TRAITS_VALUES, SYSTEM_MODULES;
 var init_module = __esm({
   "src/init/module.ts"() {
     "use strict";
@@ -1494,6 +1528,7 @@ var init_module = __esm({
     CANCEL_EXIT = 130;
     PRESETS = /* @__PURE__ */ new Set(["minimal", "minimal-plus", "full"]);
     TRAITS_VALUES = /* @__PURE__ */ new Set(["identity+audit", "identity"]);
+    SYSTEM_MODULES = /* @__PURE__ */ new Set(["admin", "metadata", "workspace"]);
   }
 });
 

package/dist/lib.d.mts

@@ -13,6 +13,16 @@ interface EntitySpec {
     traits: Traits;
     constraints?: ConstraintSpec[];
 }
+/**
+ * One declared dependency. `entities` is what the module consumes from it and
+ * is never empty: the platform requires a deps/<module>.json contract naming at
+ * least one entity for every manifest dependency, so a dependency we cannot
+ * name an entity for is one we must not scaffold.
+ */
+interface DependencySpec {
+    module: string;
+    entities: string[];
+}
 interface ScaffoldOpts {
     path: string;
     code: string;
@@ -22,7 +32,11 @@ interface ScaffoldOpts {
     license: string;
     version: string;
     dbSchemaVersion: string;
-    dependencies: string[];
+    /**
+     * Accepts bare module codes too: @dforge-core/dforge-mcp calls these builders
+     * across a caret range and older published versions still pass string[].
+     */
+    dependencies: Array<DependencySpec | string>;
     preset: Preset;
     entities: EntitySpec[];
 }
@@ -38,7 +52,15 @@ interface Manifest {
         name: string;
     };
     license?: string;
-    dependencies?: Record<string, string>;
+    /**
+     * Either a bare semver range or the object form that narrows the dependency
+     * to named entities. The scaffolder always writes the object form, since it
+     * only declares a dependency whose consumed entities it knows.
+     */
+    dependencies?: Record<string, string | {
+        version: string;
+        entities: string[];
+    }>;
     entities: Record<string, string>;
     created?: string;
     updated?: string;
@@ -61,6 +83,22 @@ interface DataView {
 }
 
 declare function buildManifest(opts: ScaffoldOpts, moduleId: string): Manifest;
+/** Range written for a scaffolded dependency, in the manifest and its contract alike. */
+declare const DEPENDENCY_RANGE = ">=0.0.1";
+/**
+ * The deps/<module>.json contract that every manifest dependency requires —
+ * without it the module fails `module validate`, `module pack` and install.
+ * `pk` follows the identity trait's `<entity>_id`, and `use` is a placeholder
+ * naming this module: both are starting points the author has to correct, which
+ * is what the post-scaffold note says.
+ */
+declare function buildDepsContract(dep: DependencySpec, consumerCode: string): Record<string, unknown>;
+/**
+ * The one field every scaffolded entity gets: a visible, editable, mandatory
+ * label column. It is what `toString` interpolates and what the entity's grid
+ * renders.
+ */
+declare const NAME_FIELD = "name";
 declare function buildEntity(entity: EntitySpec): Entity;
 declare function buildDataViews(entities: EntitySpec[]): Record<string, DataView>;
 declare function buildFolders(opts: ScaffoldOpts): Record<string, unknown>;
@@ -69,9 +107,15 @@ declare function buildRoles(opts: ScaffoldOpts): Record<string, unknown>;
 declare function buildActions(): Record<string, unknown>;
 declare function buildSettings(): Record<string, unknown>;
 declare function buildTranslations(opts: ScaffoldOpts): Record<string, unknown>;
-declare function buildSeedData(): unknown[];
+/**
+ * A seed file is an OBJECT ({ entityCode, records }), not a bare array — a bare
+ * array fails to deserialize and takes `module validate` down with it. Ships
+ * with no records: seeding needs explicit PKs, which only the author can pick.
+ */
+declare function buildSeedData(entity?: EntitySpec | string): Record<string, unknown>;
 declare function buildGitignore(): string;
 declare function buildVscodeSettings(): Record<string, unknown>;
 declare function buildZedSettings(): Record<string, unknown>;
+declare function buildZedTasks(): unknown[];
 
-export { type ConstraintSpec, type DataView, type Entity, type EntitySpec, type Manifest, type Preset, type ScaffoldOpts, type Traits, buildActions, buildDataViews, buildEntity, buildFolders, buildGitignore, buildManifest, buildMenus, buildRoles, buildSeedData, buildSettings, buildTranslations, buildVscodeSettings, buildZedSettings };
+export { type ConstraintSpec, DEPENDENCY_RANGE, type DataView, type DependencySpec, type Entity, type EntitySpec, type Manifest, NAME_FIELD, type Preset, type ScaffoldOpts, type Traits, buildActions, buildDataViews, buildDepsContract, buildEntity, buildFolders, buildGitignore, buildManifest, buildMenus, buildRoles, buildSeedData, buildSettings, buildTranslations, buildVscodeSettings, buildZedSettings, buildZedTasks };

package/dist/lib.d.ts

@@ -13,6 +13,16 @@ interface EntitySpec {
     traits: Traits;
     constraints?: ConstraintSpec[];
 }
+/**
+ * One declared dependency. `entities` is what the module consumes from it and
+ * is never empty: the platform requires a deps/<module>.json contract naming at
+ * least one entity for every manifest dependency, so a dependency we cannot
+ * name an entity for is one we must not scaffold.
+ */
+interface DependencySpec {
+    module: string;
+    entities: string[];
+}
 interface ScaffoldOpts {
     path: string;
     code: string;
@@ -22,7 +32,11 @@ interface ScaffoldOpts {
     license: string;
     version: string;
     dbSchemaVersion: string;
-    dependencies: string[];
+    /**
+     * Accepts bare module codes too: @dforge-core/dforge-mcp calls these builders
+     * across a caret range and older published versions still pass string[].
+     */
+    dependencies: Array<DependencySpec | string>;
     preset: Preset;
     entities: EntitySpec[];
 }
@@ -38,7 +52,15 @@ interface Manifest {
         name: string;
     };
     license?: string;
-    dependencies?: Record<string, string>;
+    /**
+     * Either a bare semver range or the object form that narrows the dependency
+     * to named entities. The scaffolder always writes the object form, since it
+     * only declares a dependency whose consumed entities it knows.
+     */
+    dependencies?: Record<string, string | {
+        version: string;
+        entities: string[];
+    }>;
     entities: Record<string, string>;
     created?: string;
     updated?: string;
@@ -61,6 +83,22 @@ interface DataView {
 }
 
 declare function buildManifest(opts: ScaffoldOpts, moduleId: string): Manifest;
+/** Range written for a scaffolded dependency, in the manifest and its contract alike. */
+declare const DEPENDENCY_RANGE = ">=0.0.1";
+/**
+ * The deps/<module>.json contract that every manifest dependency requires —
+ * without it the module fails `module validate`, `module pack` and install.
+ * `pk` follows the identity trait's `<entity>_id`, and `use` is a placeholder
+ * naming this module: both are starting points the author has to correct, which
+ * is what the post-scaffold note says.
+ */
+declare function buildDepsContract(dep: DependencySpec, consumerCode: string): Record<string, unknown>;
+/**
+ * The one field every scaffolded entity gets: a visible, editable, mandatory
+ * label column. It is what `toString` interpolates and what the entity's grid
+ * renders.
+ */
+declare const NAME_FIELD = "name";
 declare function buildEntity(entity: EntitySpec): Entity;
 declare function buildDataViews(entities: EntitySpec[]): Record<string, DataView>;
 declare function buildFolders(opts: ScaffoldOpts): Record<string, unknown>;
@@ -69,9 +107,15 @@ declare function buildRoles(opts: ScaffoldOpts): Record<string, unknown>;
 declare function buildActions(): Record<string, unknown>;
 declare function buildSettings(): Record<string, unknown>;
 declare function buildTranslations(opts: ScaffoldOpts): Record<string, unknown>;
-declare function buildSeedData(): unknown[];
+/**
+ * A seed file is an OBJECT ({ entityCode, records }), not a bare array — a bare
+ * array fails to deserialize and takes `module validate` down with it. Ships
+ * with no records: seeding needs explicit PKs, which only the author can pick.
+ */
+declare function buildSeedData(entity?: EntitySpec | string): Record<string, unknown>;
 declare function buildGitignore(): string;
 declare function buildVscodeSettings(): Record<string, unknown>;
 declare function buildZedSettings(): Record<string, unknown>;
+declare function buildZedTasks(): unknown[];
 
-export { type ConstraintSpec, type DataView, type Entity, type EntitySpec, type Manifest, type Preset, type ScaffoldOpts, type Traits, buildActions, buildDataViews, buildEntity, buildFolders, buildGitignore, buildManifest, buildMenus, buildRoles, buildSeedData, buildSettings, buildTranslations, buildVscodeSettings, buildZedSettings };
+export { type ConstraintSpec, DEPENDENCY_RANGE, type DataView, type DependencySpec, type Entity, type EntitySpec, type Manifest, NAME_FIELD, type Preset, type ScaffoldOpts, type Traits, buildActions, buildDataViews, buildDepsContract, buildEntity, buildFolders, buildGitignore, buildManifest, buildMenus, buildRoles, buildSeedData, buildSettings, buildTranslations, buildVscodeSettings, buildZedSettings, buildZedTasks };

package/dist/lib.js

@@ -20,8 +20,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/lib.ts
 var lib_exports = {};
 __export(lib_exports, {
+  DEPENDENCY_RANGE: () => DEPENDENCY_RANGE,
+  NAME_FIELD: () => NAME_FIELD,
   buildActions: () => buildActions,
   buildDataViews: () => buildDataViews,
+  buildDepsContract: () => buildDepsContract,
   buildEntity: () => buildEntity,
   buildFolders: () => buildFolders,
   buildGitignore: () => buildGitignore,
@@ -32,7 +35,8 @@ __export(lib_exports, {
   buildSettings: () => buildSettings,
   buildTranslations: () => buildTranslations,
   buildVscodeSettings: () => buildVscodeSettings,
-  buildZedSettings: () => buildZedSettings
+  buildZedSettings: () => buildZedSettings,
+  buildZedTasks: () => buildZedTasks
 });
 module.exports = __toCommonJS(lib_exports);
 
@@ -57,19 +61,48 @@ function buildManifest(opts, moduleId) {
   if (opts.license) manifest.license = opts.license;
   if (opts.dependencies.length > 0) {
     manifest.dependencies = Object.fromEntries(
-      opts.dependencies.map((d) => [d, ">=0.0.1"])
+      opts.dependencies.map(
+        (d) => typeof d === "string" ? [d, DEPENDENCY_RANGE] : [d.module, { version: DEPENDENCY_RANGE, entities: d.entities }]
+      )
     );
   }
   return manifest;
 }
+var DEPENDENCY_RANGE = ">=0.0.1";
+function buildDepsContract(dep, consumerCode) {
+  return {
+    module: dep.module,
+    version: DEPENDENCY_RANGE,
+    entities: Object.fromEntries(
+      dep.entities.map((e) => [
+        e,
+        { pk: `${e}_id`, use: [`ref:${consumerCode}`] }
+      ])
+    )
+  };
+}
+var NAME_FIELD = "name";
 function buildEntity(entity) {
   const traits = entity.traits === "identity+audit" ? ["identity", "audit"] : ["identity"];
   const built = {
     description: entity.label,
     dbObject: entity.name,
-    toString: "{id}",
+    // The traits only add a PK and audit stamps, so an entity with no fields
+    // of its own has nothing renderable: its grid view fails the data-view
+    // column check and `toString` has nothing to interpolate. Scaffold one
+    // visible name column so the module validates and the grid shows a row.
+    toString: `{${NAME_FIELD}}`,
     traits,
-    fields: {}
+    fields: {
+      [NAME_FIELD]: {
+        dbDatatype: "varchar",
+        fieldTypeCd: "text",
+        flags: "VEM",
+        maxLen: 200,
+        orderNum: 10,
+        description: "Name"
+      }
+    }
   };
   if (entity.constraints?.length) {
     built.constraints = Object.fromEntries(
@@ -154,7 +187,8 @@ function buildTranslations(opts) {
   for (const e of opts.entities) {
     const fields = {
       // identity trait → primary key column
-      [`${e.name}_id`]: { label: `${e.label} ID` }
+      [`${e.name}_id`]: { label: `${e.label} ID` },
+      [NAME_FIELD]: { label: "Name" }
     };
     if (e.traits === "identity+audit") {
       fields.created_date = { label: "Created Date" };
@@ -195,8 +229,9 @@ function buildTranslations(opts) {
     }
   };
 }
-function buildSeedData() {
-  return [];
+function buildSeedData(entity) {
+  const entityCode = typeof entity === "string" ? entity : entity?.name ?? "";
+  return { entityCode, records: [] };
 }
 function buildGitignore() {
   return [
@@ -218,35 +253,88 @@ var SCHEMA_BINDINGS = [
   { fileMatch: ["ui/folders.json"], schema: "folders" },
   { fileMatch: ["ui/menus.json"], schema: "menus" },
   { fileMatch: ["ui/reports.json"], schema: "reports" },
+  { fileMatch: ["ui/print_templates.json"], schema: "print-templates" },
   { fileMatch: ["security/roles.json"], schema: "roles" },
   { fileMatch: ["logic/jobs.json"], schema: "jobs" },
+  { fileMatch: ["logic/triggers.json"], schema: "triggers" },
+  { fileMatch: ["logic/webhooks.json"], schema: "webhooks" },
+  { fileMatch: ["deps/*.json"], schema: "deps" },
   { fileMatch: ["seed-data/*.json"], schema: "seed-data" },
   { fileMatch: ["settings.json"], schema: "settings" }
 ];
+function schemaEntries() {
+  return SCHEMA_BINDINGS.map((b) => ({
+    fileMatch: b.fileMatch,
+    url: `${SCHEMA_BASE}/${b.schema}.schema.json`
+  }));
+}
 function buildVscodeSettings() {
-  return {
-    "json.schemas": SCHEMA_BINDINGS.map((b) => ({
-      fileMatch: b.fileMatch,
-      url: `${SCHEMA_BASE}/${b.schema}.schema.json`
-    }))
-  };
+  return { "json.schemas": schemaEntries() };
 }
 function buildZedSettings() {
   return {
-    languages: {
-      JSON: {
-        "json.schemas": SCHEMA_BINDINGS.map((b) => ({
-          fileMatch: b.fileMatch,
-          url: `${SCHEMA_BASE}/${b.schema}.schema.json`
-        }))
+    lsp: {
+      "json-language-server": {
+        settings: { json: { schemas: schemaEntries() } }
+      }
+    },
+    context_servers: {
+      dforge: {
+        source: "custom",
+        command: "npx",
+        args: ["-y", "@dforge-core/dforge-mcp@latest"],
+        env: {}
       }
     }
   };
 }
+function buildZedTasks() {
+  const CLI = "npx";
+  const CLI_ARGS = ["-y", "@dforge-core/dforge-cli@latest"];
+  const DEFAULT_TENANT = "http://localhost:5179";
+  const task = (label, args) => ({
+    label: `dForge: ${label}`,
+    command: CLI,
+    args: [...CLI_ARGS, ...args],
+    cwd: "$ZED_WORKTREE_ROOT",
+    env: { DFORGE_URL: DEFAULT_TENANT },
+    use_new_terminal: false,
+    allow_concurrent_runs: false,
+    reveal: "always"
+  });
+  return [
+    task("Pack module", ["module", "pack", "$ZED_WORKTREE_ROOT"]),
+    // --force matches the extension's dev-loop default: without it the CLI
+    // skips the reinstall when the version hasn't changed and your edits
+    // silently never reach the tenant.
+    task("Install module to tenant", [
+      "module",
+      "install",
+      "--path",
+      "$ZED_WORKTREE_ROOT",
+      "--url",
+      "$DFORGE_URL",
+      "--force"
+    ]),
+    task("Sign in to tenant", [
+      "auth",
+      "login",
+      "--url",
+      "$DFORGE_URL",
+      "--login-url",
+      "$DFORGE_URL"
+    ]),
+    task("Show signed-in user", ["auth", "whoami", "--url", "$DFORGE_URL"]),
+    task("List installed modules", ["module", "list", "--url", "$DFORGE_URL"])
+  ];
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  DEPENDENCY_RANGE,
+  NAME_FIELD,
   buildActions,
   buildDataViews,
+  buildDepsContract,
   buildEntity,
   buildFolders,
   buildGitignore,
@@ -257,5 +345,6 @@ function buildZedSettings() {
   buildSettings,
   buildTranslations,
   buildVscodeSettings,
-  buildZedSettings
+  buildZedSettings,
+  buildZedTasks
 });

package/dist/lib.mjs

@@ -19,19 +19,48 @@ function buildManifest(opts, moduleId) {
   if (opts.license) manifest.license = opts.license;
   if (opts.dependencies.length > 0) {
     manifest.dependencies = Object.fromEntries(
-      opts.dependencies.map((d) => [d, ">=0.0.1"])
+      opts.dependencies.map(
+        (d) => typeof d === "string" ? [d, DEPENDENCY_RANGE] : [d.module, { version: DEPENDENCY_RANGE, entities: d.entities }]
+      )
     );
   }
   return manifest;
 }
+var DEPENDENCY_RANGE = ">=0.0.1";
+function buildDepsContract(dep, consumerCode) {
+  return {
+    module: dep.module,
+    version: DEPENDENCY_RANGE,
+    entities: Object.fromEntries(
+      dep.entities.map((e) => [
+        e,
+        { pk: `${e}_id`, use: [`ref:${consumerCode}`] }
+      ])
+    )
+  };
+}
+var NAME_FIELD = "name";
 function buildEntity(entity) {
   const traits = entity.traits === "identity+audit" ? ["identity", "audit"] : ["identity"];
   const built = {
     description: entity.label,
     dbObject: entity.name,
-    toString: "{id}",
+    // The traits only add a PK and audit stamps, so an entity with no fields
+    // of its own has nothing renderable: its grid view fails the data-view
+    // column check and `toString` has nothing to interpolate. Scaffold one
+    // visible name column so the module validates and the grid shows a row.
+    toString: `{${NAME_FIELD}}`,
     traits,
-    fields: {}
+    fields: {
+      [NAME_FIELD]: {
+        dbDatatype: "varchar",
+        fieldTypeCd: "text",
+        flags: "VEM",
+        maxLen: 200,
+        orderNum: 10,
+        description: "Name"
+      }
+    }
   };
   if (entity.constraints?.length) {
     built.constraints = Object.fromEntries(
@@ -116,7 +145,8 @@ function buildTranslations(opts) {
   for (const e of opts.entities) {
     const fields = {
       // identity trait → primary key column
-      [`${e.name}_id`]: { label: `${e.label} ID` }
+      [`${e.name}_id`]: { label: `${e.label} ID` },
+      [NAME_FIELD]: { label: "Name" }
     };
     if (e.traits === "identity+audit") {
       fields.created_date = { label: "Created Date" };
@@ -157,8 +187,9 @@ function buildTranslations(opts) {
     }
   };
 }
-function buildSeedData() {
-  return [];
+function buildSeedData(entity) {
+  const entityCode = typeof entity === "string" ? entity : entity?.name ?? "";
+  return { entityCode, records: [] };
 }
 function buildGitignore() {
   return [
@@ -180,34 +211,87 @@ var SCHEMA_BINDINGS = [
   { fileMatch: ["ui/folders.json"], schema: "folders" },
   { fileMatch: ["ui/menus.json"], schema: "menus" },
   { fileMatch: ["ui/reports.json"], schema: "reports" },
+  { fileMatch: ["ui/print_templates.json"], schema: "print-templates" },
   { fileMatch: ["security/roles.json"], schema: "roles" },
   { fileMatch: ["logic/jobs.json"], schema: "jobs" },
+  { fileMatch: ["logic/triggers.json"], schema: "triggers" },
+  { fileMatch: ["logic/webhooks.json"], schema: "webhooks" },
+  { fileMatch: ["deps/*.json"], schema: "deps" },
   { fileMatch: ["seed-data/*.json"], schema: "seed-data" },
   { fileMatch: ["settings.json"], schema: "settings" }
 ];
+function schemaEntries() {
+  return SCHEMA_BINDINGS.map((b) => ({
+    fileMatch: b.fileMatch,
+    url: `${SCHEMA_BASE}/${b.schema}.schema.json`
+  }));
+}
 function buildVscodeSettings() {
-  return {
-    "json.schemas": SCHEMA_BINDINGS.map((b) => ({
-      fileMatch: b.fileMatch,
-      url: `${SCHEMA_BASE}/${b.schema}.schema.json`
-    }))
-  };
+  return { "json.schemas": schemaEntries() };
 }
 function buildZedSettings() {
   return {
-    languages: {
-      JSON: {
-        "json.schemas": SCHEMA_BINDINGS.map((b) => ({
-          fileMatch: b.fileMatch,
-          url: `${SCHEMA_BASE}/${b.schema}.schema.json`
-        }))
+    lsp: {
+      "json-language-server": {
+        settings: { json: { schemas: schemaEntries() } }
+      }
+    },
+    context_servers: {
+      dforge: {
+        source: "custom",
+        command: "npx",
+        args: ["-y", "@dforge-core/dforge-mcp@latest"],
+        env: {}
       }
     }
   };
 }
+function buildZedTasks() {
+  const CLI = "npx";
+  const CLI_ARGS = ["-y", "@dforge-core/dforge-cli@latest"];
+  const DEFAULT_TENANT = "http://localhost:5179";
+  const task = (label, args) => ({
+    label: `dForge: ${label}`,
+    command: CLI,
+    args: [...CLI_ARGS, ...args],
+    cwd: "$ZED_WORKTREE_ROOT",
+    env: { DFORGE_URL: DEFAULT_TENANT },
+    use_new_terminal: false,
+    allow_concurrent_runs: false,
+    reveal: "always"
+  });
+  return [
+    task("Pack module", ["module", "pack", "$ZED_WORKTREE_ROOT"]),
+    // --force matches the extension's dev-loop default: without it the CLI
+    // skips the reinstall when the version hasn't changed and your edits
+    // silently never reach the tenant.
+    task("Install module to tenant", [
+      "module",
+      "install",
+      "--path",
+      "$ZED_WORKTREE_ROOT",
+      "--url",
+      "$DFORGE_URL",
+      "--force"
+    ]),
+    task("Sign in to tenant", [
+      "auth",
+      "login",
+      "--url",
+      "$DFORGE_URL",
+      "--login-url",
+      "$DFORGE_URL"
+    ]),
+    task("Show signed-in user", ["auth", "whoami", "--url", "$DFORGE_URL"]),
+    task("List installed modules", ["module", "list", "--url", "$DFORGE_URL"])
+  ];
+}
 export {
+  DEPENDENCY_RANGE,
+  NAME_FIELD,
   buildActions,
   buildDataViews,
+  buildDepsContract,
   buildEntity,
   buildFolders,
   buildGitignore,
@@ -218,5 +302,6 @@ export {
   buildSettings,
   buildTranslations,
   buildVscodeSettings,
-  buildZedSettings
+  buildZedSettings,
+  buildZedTasks
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@dforge-core/dforge-cli",
-	"version": "0.2.16",
+	"version": "0.2.18",
 	"description": "dForge CLI - validate, pack, publish, and install dForge modules. Distributes a single-file native binary per platform via optionalDependencies (esbuild-style).",
 	"license": "MIT",
 	"homepage": "https://github.com/dforge-core/dforge-cli",
@@ -41,11 +41,11 @@
 		"typescript": "^6.0.3"
 	},
 	"optionalDependencies": {
-		"@dforge-core/dforge-cli-darwin-arm64": "0.2.16",
-		"@dforge-core/dforge-cli-darwin-x64": "0.2.16",
-		"@dforge-core/dforge-cli-linux-arm64": "0.2.16",
-		"@dforge-core/dforge-cli-linux-x64": "0.2.16",
-		"@dforge-core/dforge-cli-win32-arm64": "0.2.16",
-		"@dforge-core/dforge-cli-win32-x64": "0.2.16"
+		"@dforge-core/dforge-cli-darwin-arm64": "0.2.18",
+		"@dforge-core/dforge-cli-darwin-x64": "0.2.18",
+		"@dforge-core/dforge-cli-linux-arm64": "0.2.18",
+		"@dforge-core/dforge-cli-linux-x64": "0.2.18",
+		"@dforge-core/dforge-cli-win32-arm64": "0.2.18",
+		"@dforge-core/dforge-cli-win32-x64": "0.2.18"
 	}
 }