@dforge-core/dforge-mcp 0.2.45 → 0.2.47

package/CHANGELOG.md

@@ -4,6 +4,51 @@ All notable changes to `@dforge-core/dforge-mcp`. This project uses semver-ish
 `0.1.0-rc.N` pre-release tags; the published version is set at publish time via
 the release workflow, so committed `package.json` versions are placeholders.
 
+## Unreleased
+
+## 0.2.46 — 2026-10-29
+
+Requires `@dforge-core/dforge-cli` 0.2.37 and `@dforge-core/metadata` 0.0.47; the vendored `dforge://schema/data-views` now accepts the grouping keys.
+
+**`SLICE()`: an information register's value on a date, per row.** A formula function for `F` columns —
+`SLICE('module.register', 'resource', date, 'dimension', value, …)`, 1C's `СрезПоследних` — so a print form prints each
+line's price on its document's date, read in the query that loads the lines. Database-only (the browser keeps the loaded
+value), read with the user's rights on the register, refused in `G` columns; install checks the register, resource and
+dimensions. `references/formulas.md` documents it, `print-templates.md` and `registers.md` point to it. Print responses
+(`print.render`, `print.renderPdf`, DSL `printPdf()`) now carry `warnings` for what printed empty, and an upgrade deletes
+the print templates a package no longer declares. **Needs a platform with the `SLICE()` release (CLI 0.2.37).**
+
+**Grids and lists group by a column.** A `grid` or `list` view's `viewConfig` can ship a default grouping:
+`groupByField`, `groupByOptions` (narrows the Group menu) and `collapsedGroups`, plus `inlineAdd` on a list.
+`dforge_module_validate` checks them as the install does (core `ViewGroupingValidator`, #1556): each named column is a
+dropdown, flags, reference or user column, `groupByOptions` includes `groupByField`, and `collapsedGroups` lists option
+values of a valid `groupByField`. `references/data-views.md` documents the keys and the validation checklist lists the
+rules. The vendored `dforge://schema/data-views` carries them from metadata 0.0.47. **Needs platform 1.28.11.**
+
+**`dforge-1c-import`: porting a 1C infobase.** A fifth skill. It carries the decisions a 1C port turns on, each with the
+measurement that settles it: a register's kind, where a posting takes each value, what to carry, physical columns through
+DBNames, vendor against client. It adds `references/loading.md` (copying the rows: swapped uuid halves, the empty reference
+and the empty date as values in register keys and periods, the year offset, enums by `_EnumOrder`, composite references,
+register state, triggers, dangling references, verification) and `references/print-forms.md` (MXL templates, the print
+procedure, `Строка`/`Формат` in SQL, reproducing 1C's slips, datasets as queries). `scripts/` ships the Python toolkit
+from a real port: it exports the infobase without 1C, generates and validates modules, copies and
+reconciles the rows, checks postings and reads print templates, pointed at a port by `DF1C_ROOT` / `DF1C_PROJECT` and
+started from `scripts/project-template/`. `install-skills` installs it with the other four.
+
+The toolkit has two layers. `dump1c` is the only part that reads 1C. It reads either a server infobase on MS SQL or a
+file infobase (`1Cv8.1CD`, formats 8.2.14 and 8.3.8, through a pure-Python reader), and writes one export to `out/`:
+the configuration, DBNames, the schema, every table's rows as Parquet, and a manifest with the year offset and the
+horizons. Everything else reads that export, with DuckDB for the rows (`store.py`). The export is the same whichever
+kind of infobase it came from, so a project's `sources.QUERIES` are DuckDB SQL. **Breaking for an existing port:** a
+query written in T-SQL (`[_Fld12]`, `TOP`, `0x01`, `CONVERT`) fails until it is rewritten (`"_Fld12"`, `LIMIT`,
+`from_hex('01')`, `CAST`). `dump1c data --changes [--since <day>]` brings an MS SQL export up to date by reading
+only what 1C changed. It rebuilds each table's file in place, so `delta` follows a cutover in minutes rather than
+after a full export. It also catches accounting entries switched on or off without the document being written.
+Register totals and document journals are left out of the export by default; name one, or pass `--derived`, to
+export it. `delta` needs an MS SQL export: a file
+infobase has no database-wide rowversion. `meta` now finds the configuration's root from `root` instead of a GUID
+fixed to one configuration.
+
 ## 0.2.45 — 2026-10-25
 
 **English is the base locale, and it lives in the definitions.** Install never reads

package/README.md

@@ -2,7 +2,7 @@
 
 MCP server for dForge module authoring. Exposes 35 composable tools and the canonical schemas so AI agents (Claude Code, Cursor, Zed, etc.) can drive the full module lifecycle — scaffold → entities → actions → views → security → install — through structured tool calls instead of free-form JSON generation.
 
-Ships with **four Claude Skills** (`skills/`): a router plus one skill per lifecycle stage — design (Phase 0), build (Phases 1-5), and ship (Phase 6). The router directory carries 25 reference files (field types, flags, traits, formulas, DSL, security, etc.) and two annotated example modules.
+Ships with **five Claude Skills** (`skills/`): a router plus one skill per lifecycle stage — design (Phase 0), build (Phases 1-5), and ship (Phase 6) — and `dforge-1c-import` for porting a 1C infobase, with its Python toolkit. The router directory carries 25 reference files (field types, flags, traits, formulas, DSL, security, etc.) and two annotated example modules.
 
 **New here?** Start with **[docs/creating-modules.md](docs/creating-modules.md)** — three ways to scaffold a module (terminal CLI, VS Code sidebar, AI wizard) and when to pick each.
 
@@ -206,6 +206,7 @@ Authoring guidance ships as **four** skills, split by lifecycle stage. Each stag
 | `dforge-module-design` | 0a–0d | Identity, intake guardrails, design doc, pre-scaffold validation. Ends at `readyToScaffold: true`. |
 | `dforge-module-build` | 1–5 | Entities, behavior, views/menus, polish, security. Loading-policy table, core-rules cheat sheet, backtrack protocol. |
 | `dforge-module-ship` | 6 | Validate → pre-pack review → version audit → pack → install-fix loop. |
+| `dforge-1c-import` | — | Porting a 1C:Enterprise infobase: register kinds, posting bindings, what to carry, the row copy and its conversions, print forms. `scripts/` holds the Python toolkit (read the infobase from MS SQL without 1C, generate modules, load, reconcile, check postings, read MXL templates). |
 
 The handoff is deterministic rather than vibes-based: `dforge_module_plan({ action: "check" })` returns `currentPhase` **and** `nextSkill`, derived from the Phase 0 artifacts, the phase ledger in `docs/phase.json`, and evidence read from the module itself (entities without fields, entities without a view, entities without a Select grant).
 

package/dist/server.js

@@ -31002,7 +31002,7 @@ var import_node_crypto = require("crypto");
 var fs2 = __toESM(require("fs"));
 var path2 = __toESM(require("path"));
 
-// node_modules/.pnpm/@dforge-core+dforge-cli@0.2.36/node_modules/@dforge-core/dforge-cli/dist/lib.mjs
+// node_modules/.pnpm/@dforge-core+dforge-cli@0.2.37/node_modules/@dforge-core/dforge-cli/dist/lib.mjs
 function buildManifest(opts, moduleId) {
   const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
   const manifest = {
@@ -31243,7 +31243,7 @@ function buildZedTasks() {
 var fs = __toESM(require("fs"));
 var path = __toESM(require("path"));
 
-// node_modules/.pnpm/@dforge-core+metadata@0.0.46/node_modules/@dforge-core/metadata/dist/index.js
+// node_modules/.pnpm/@dforge-core+metadata@0.0.47/node_modules/@dforge-core/metadata/dist/index.js
 var AggType = {
   Sum: "sum",
   Count: "count",
@@ -34612,7 +34612,7 @@ var path10 = __toESM(require("path"));
 var fs7 = __toESM(require("fs"));
 var path9 = __toESM(require("path"));
 
-// node_modules/.pnpm/@dforge-core+metadata@0.0.46/node_modules/@dforge-core/metadata/dist/dsl/index.js
+// node_modules/.pnpm/@dforge-core+metadata@0.0.47/node_modules/@dforge-core/metadata/dist/dsl/index.js
 var PUNCT3 = ["===", "!=="];
 var PUNCT2 = [
   "==",
@@ -38255,6 +38255,73 @@ function checkMenus(ctx) {
   };
   for (const [mcode, m] of Object.entries(menus)) walk(m, `menus \u2192 ${mcode}`);
 }
+function checkViewGrouping(ctx) {
+  const { err, entities, fieldDefsOf, views } = ctx;
+  for (const [vcode, v] of Object.entries(views)) {
+    const viewType = v.viewType ?? "grid";
+    if (viewType !== "grid" && viewType !== "list") continue;
+    const config2 = v.viewConfig;
+    if (!config2 || typeof config2 !== "object" || Array.isArray(config2)) continue;
+    const cfg = config2;
+    const ent = v.dataSources?.[0]?.entityCode;
+    if (!ent) continue;
+    const defs = fieldDefsOf[ent];
+    if (!defs || entities[ent]?.extends) continue;
+    const where = `data_views \u2192 ${vcode}`;
+    const resolve8 = (key, cd) => {
+      const f = defs[cd];
+      if (!f) err(where, `names '${cd}' in '${key}', which entity '${ent}' does not define`);
+      else if (!isGroupable(f)) err(where, `names '${cd}' in '${key}', which is not a dropdown, reference or user column`);
+      else return f;
+      return void 0;
+    };
+    const readStrings = (key) => {
+      const val = cfg[key];
+      if (!Array.isArray(val)) return void 0;
+      const items = [];
+      for (const item of val) {
+        if (typeof item === "string") items.push(item);
+        else err(where, `has a non-string item in '${key}'`);
+      }
+      return items;
+    };
+    const groupBy = typeof cfg.groupByField === "string" ? cfg.groupByField : void 0;
+    const groupField = groupBy !== void 0 ? resolve8("groupByField", groupBy) : void 0;
+    const options = readStrings("groupByOptions");
+    if (options) {
+      for (const cd of options) resolve8("groupByOptions", cd);
+      if (groupBy !== void 0 && !options.includes(groupBy)) {
+        err(where, `has 'groupByOptions' without its 'groupByField' '${groupBy}'`);
+      }
+    }
+    const collapsed = readStrings("collapsedGroups");
+    if (collapsed) {
+      if (!groupField) err(where, "sets 'collapsedGroups' without a valid 'groupByField'");
+      else if (isDropdown(groupField)) {
+        const values = optionValues(groupField);
+        for (const val of collapsed.filter((c) => !values.has(c))) {
+          err(where, `lists '${val}' in 'collapsedGroups', which is not an option of '${groupBy}'`);
+        }
+      }
+    }
+  }
+}
+function isDropdown(f) {
+  return f.fieldTypeCd === "dropdown" || f.fieldTypeCd === "flags";
+}
+function isGroupable(f) {
+  return isDropdown(f) || f.fieldTypeCd === "user" || f.columnType === "R";
+}
+function optionValues(f) {
+  const result = /* @__PURE__ */ new Set();
+  const options = f.params?.options;
+  if (!Array.isArray(options)) return result;
+  for (const item of options) {
+    const val = item && typeof item === "object" ? item.value : item;
+    if (typeof val === "string" || typeof val === "number") result.add(String(val));
+  }
+  return result;
+}
 
 // src/tools/validate/security.ts
 var fs14 = __toESM(require("fs"));
@@ -38525,6 +38592,7 @@ var CHECKS = [
   checkEntityViews,
   checkDataViews,
   checkVisibleColumns,
+  checkViewGrouping,
   checkMenus,
   checkRoleRights,
   checkSelectCoverage,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dforge-core/dforge-mcp",
-  "version": "0.2.45",
+  "version": "0.2.47",
   "description": "MCP server for dForge module authoring. Exposes 35 scaffold/patch/validate/pack/install tools and schema resources so AI agents (Claude Code, Cursor, Zed) can create and ship dForge modules.",
   "license": "MIT",
   "homepage": "https://github.com/iash44/dForge-core",
@@ -26,8 +26,8 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@dforge-core/dforge-cli": "^0.2.36",
-    "@dforge-core/metadata": "^0.0.46",
+    "@dforge-core/dforge-cli": "^0.2.37",
+    "@dforge-core/metadata": "^0.0.47",
     "@modelcontextprotocol/sdk": "^1.30.0",
     "zod": "^4.4.3"
   },

package/resources/docs/dsl-reference.md

@@ -569,7 +569,7 @@ if (info.mimeType != 'application/pdf') { error('Receipt must be PDF') }
 ```
 
 #### `printPdf(entityCd, key, templateCd)`
-Render a print template to a PDF as the current user and return the archived file as `{ fileId, fileName, mimeType, size, checksum }`; attach it with `sendEmail()`. Pass a qualified entity code. Not in a scheduled job or a background action; max 10 per run.
+Render a print template to a PDF as the current user and return the archived file as `{ fileId, fileName, mimeType, size, checksum }`, plus `warnings` when a value printed empty because the user may not read it; attach it with `sendEmail()`. Pass a qualified entity code. Not in a scheduled job or a background action; max 10 per run.
 
 ```dsl
 execute:

package/resources/schemas/data-views.schema.json

@@ -52,6 +52,7 @@
 			},
 			"additionalProperties": false,
 			"allOf": [
+				{ "$ref": "#/$defs/rules/grid" },
 				{ "$ref": "#/$defs/rules/kanban" },
 				{ "$ref": "#/$defs/rules/calendar" },
 				{ "$ref": "#/$defs/rules/tree-grid" },
@@ -62,6 +63,17 @@
 		},
 
 		"rules": {
+			"grid": {
+				"if": {
+					"properties": { "viewType": { "const": "grid" } },
+					"required": ["viewType"]
+				},
+				"then": {
+					"properties": {
+						"viewConfig": { "$ref": "#/$defs/gridViewConfig" }
+					}
+				}
+			},
 			"kanban": {
 				"if": {
 					"properties": { "viewType": { "const": "kanban" } },
@@ -131,6 +143,26 @@
 			}
 		},
 
+		"gridViewConfig": {
+			"type": "object",
+			"properties": {
+				"groupByField": {
+					"type": "string",
+					"description": "Dropdown, reference or user column the rows are grouped by under header rows"
+				},
+				"groupByOptions": {
+					"type": "array",
+					"items": { "type": "string" },
+					"description": "Columns the Group by menu offers; must include groupByField"
+				},
+				"collapsedGroups": {
+					"type": "array",
+					"items": { "type": "string" },
+					"description": "Option values of groupByField whose groups start collapsed"
+				}
+			},
+			"additionalProperties": false
+		},
 		"kanbanViewConfig": {
 			"type": "object",
 			"required": ["groupByField"],
@@ -195,6 +227,24 @@
 					"type": "array",
 					"items": { "$ref": "#/$defs/listLevelConfig" },
 					"description": "Hierarchical child levels for expandable list rows"
+				},
+				"groupByField": {
+					"type": "string",
+					"description": "Dropdown, reference or user column the rows are grouped by"
+				},
+				"groupByOptions": {
+					"type": "array",
+					"items": { "type": "string" },
+					"description": "Columns the user may regroup by; must include groupByField"
+				},
+				"collapsedGroups": {
+					"type": "array",
+					"items": { "type": "string" },
+					"description": "Option values of groupByField whose groups start collapsed"
+				},
+				"inlineAdd": {
+					"type": "boolean",
+					"description": "Show an add row in each group (at the top when ungrouped)"
 				}
 			},
 			"additionalProperties": false

package/scripts/install-skills.mjs

@@ -32,6 +32,7 @@ const SKILLS = [
 	["dforge-module-design", "Phase 0  — identity, intake, design, validation"],
 	["dforge-module-build", "Phases 1-5 — entities, behavior, views, security"],
 	["dforge-module-ship", "Phase 6  — validate, pack, install-fix loop"],
+	["dforge-1c-import", "porting a 1C infobase — decisions, loading, print forms,\n                        and the Python toolkit that does the mechanical half"],
 ];
 
 const PKG = "@dforge-core/dforge-mcp";