@smartsoft001-mobilems/claude-plugins 2.89.0 → 2.90.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smartsoft001-mobilems/claude-plugins",
-  "version": "2.89.0",
+  "version": "2.90.0",
   "publishConfig": {
     "access": "public"
   },

package/plugins/mobilems/.claude-plugin/plugin.json

@@ -1,5 +1,5 @@
 {
   "name": "mobilems",
   "description": "MobilEMS-specific Claude Code skills (MuzaCMS / MobileMS indexer API)",
-  "version": "2.89.0"
+  "version": "2.90.0"
 }

package/plugins/mobilems/skills/mobilems-articles/SKILL.md

@@ -78,11 +78,16 @@ README) — never a per-module copy. `scripts/verify-module.sh` fails the run on
    Also add any **extra third-party packages the copied pages import** that aren't already in the
    workspace — e.g. the reference list page uses `lodash-decorators` (`@debounce`); grep the pages you
    copy for non-`@angular`/`@smartsoft001` imports and add the missing ones.
-3. **Library** — create `libs/museum-<name>/{domain,shell/angular}` per `references/lib-contents.md`:
-   the thin domain entity (`Museum<Name> extends Article`), the shell (`Museum<Name>Module`, routes,
-   `pages/{list,item}`, services, and — if the module keeps feature state — `+state/<name>.reducer.ts`),
-   threading `<PREFIX>` and the chosen name/entity. Add the two `tsconfig.base.json` paths
-   (`@<PREFIX>/museum-<name>/domain` + `/shell/angular`).
+3. **Library** — scaffold `libs/museum-news` with this package's Nx generator (deterministic — do
+   NOT copy files by hand when the generator is available):
+   ```bash
+   npx nx g @smartsoft001-mobilems/articles-shell-angular:museum-module \
+     --referenceRoot=<reference-repo> --prefix=<PREFIX>
+   ```
+   It copies the lib from the reference, threads `@<PREFIX>/`, adds both `tsconfig.base.json`
+   paths, normalizes `project.json` paths and copies the module's translation groups (pl+en).
+   Fallback (older framework line without the generator): do the same by hand per
+   `references/lib-contents.md`. For a NON-news article module (different `<name>`/entity), the generator's `news` output is the starting point — rename per `references/lib-contents.md` after generating, or fall back to the manual path entirely.
 4. **Module + route** — see `references/module-and-routes.md`: `Museum<Name>Module` wraps
    `ArticlesSharedModule.forFeature` with `type: Article`, the chosen `entity`, and
    `baseQuery: [{ key: 'template', value: '<template>', type: '=', hidden: true }]`, plus the `Masonry`
@@ -95,7 +100,11 @@ README) — never a per-module copy. `scripts/verify-module.sh` fails the run on
    and list cards (`<name>-grid-item`, `<name>-list-item`) in `libs/shared/angular` and export them; if
    the module renders article-gallery content blocks, also build the article gallery widget and register
    it in the widget content-type map (build once, idempotent across article modules).
-6. **Verify** — run `scripts/verify-module.sh <workspace-root> <PREFIX> <name> [template]`: asserts the
+6. **Translations** — copy the module's translation groups (`NEWS` + `ARTICLES` for the aktualności instance (override with `TRANS_GROUPS` when the module uses different groups)) from the reference
+   repo's `apps/web/public/translations.json` into the app's file, for BOTH `pl` and `en`.
+   Complete group = every reference key present; every key referenced in the module's code
+   must exist in both languages — a raw `GROUP.key` rendered in the UI is a defect.
+7. **Verify** — run `REF_ROOT=<reference-repo> scripts/verify-module.sh <workspace-root> <PREFIX> <name> [template]`: asserts the
    library exists, the `forFeature` carries the chosen `entity` (and template, if given), the route is
    registered, and the article card shared components are built and exported. Fix and re-run.
 

package/plugins/mobilems/skills/mobilems-articles/scripts/check-translations.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+/**
+ * check-translations.js "<GROUP GROUP …>" [reference-root]
+ *
+ * Run from the workspace root (verify-module.sh cd's there). Verifies the
+ * module's translation groups in apps/web/public/translations.json:
+ *   1. each group exists and is non-empty in BOTH pl and en,
+ *   2. every literal GROUP.* key referenced in libs/ or apps/web/src exists
+ *      in both languages (dead references = defect),
+ *   3. with a reference root: every reference key of the group exists in the
+ *      generated file — missing keys are listed (the module is incomplete).
+ * Prints PASS/FAIL lines in the verify-module.sh idiom; exit 1 on any FAIL.
+ */
+const fs = require("fs");
+
+const [groupsArg, refRoot] = process.argv.slice(2);
+const groups = (groupsArg || "").split(/\s+/).filter(Boolean);
+if (!groups.length) { console.log("  FAIL: no translation groups given"); process.exit(1); }
+
+const TRANS = "apps/web/public/translations.json";
+let fail = 0;
+const pass = (m) => console.log(`  PASS: ${m}`);
+const bad = (m) => { console.log(`  FAIL: ${m}`); fail = 1; };
+
+const flat = (obj, prefix) => Object.entries(obj || {}).flatMap(([k, v]) =>
+  v && typeof v === "object" ? flat(v, `${prefix}.${k}`) : [`${prefix}.${k}`]);
+
+const readTrans = (p) => { try { return JSON.parse(fs.readFileSync(p, "utf8")).data.translations; } catch { return null; } };
+
+const gen = readTrans(TRANS);
+if (!gen) { bad(`cannot read ${TRANS}`); process.exit(1); }
+
+// 1. groups present + non-empty in both languages
+const genKeys = { pl: new Set(), en: new Set() };
+for (const lang of ["pl", "en"]) {
+  for (const g of groups) {
+    const keys = flat(gen[lang]?.[g], g);
+    keys.forEach((k) => genKeys[lang].add(k));
+    if (keys.length) pass(`${g} present in ${lang} (${keys.length} keys)`);
+    else bad(`${g} missing or empty in ${lang}`);
+  }
+}
+
+// 2. dead references — literal GROUP.* keys used in sources must exist.
+// Dynamic tails (`GROUP.${x}`) don't match the literal regex, and a matched
+// PREFIX that is a parent of existing keys counts as present.
+const walk = (dir) => {
+  let out = [];
+  for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
+    if (e.name === "node_modules" || e.name.startsWith(".")) continue;
+    const p = `${dir}/${e.name}`;
+    if (e.isDirectory()) out = out.concat(walk(p));
+    else if (/\.(ts|html)$/.test(e.name)) out.push(p);
+  }
+  return out;
+};
+let src = "";
+for (const d of ["libs", "apps/web/src"]) {
+  if (fs.existsSync(d)) src += walk(d).map((f) => { try { return fs.readFileSync(f, "utf8"); } catch { return ""; } }).join("\n");
+}
+const re = new RegExp(`\\b(?:${groups.join("|")})(?:\\.[A-Za-z0-9_]+)+`, "g");
+const used = new Set(src.match(re) || []);
+const dead = { pl: [], en: [] };
+for (const key of used) {
+  for (const lang of ["pl", "en"]) {
+    const ks = genKeys[lang];
+    if (!ks.has(key) && ![...ks].some((k) => k.startsWith(`${key}.`))) dead[lang].push(key);
+  }
+}
+for (const lang of ["pl", "en"]) {
+  if (dead[lang].length) bad(`${lang}: keys referenced in code but missing in ${TRANS}: ${dead[lang].slice(0, 8).join(", ")}${dead[lang].length > 8 ? ` (+${dead[lang].length - 8})` : ""}`);
+  else pass(`no dead ${lang} references (${used.size} literal keys checked)`);
+}
+
+// 3. completeness vs reference
+if (refRoot) {
+  const ref = readTrans(`${refRoot}/apps/web/public/translations.json`);
+  if (!ref) bad(`cannot read reference translations under ${refRoot}`);
+  else {
+    for (const lang of ["pl", "en"]) {
+      const missing = groups.flatMap((g) => flat(ref[lang]?.[g], g)).filter((k) => !genKeys[lang].has(k));
+      if (missing.length) bad(`${lang}: ${missing.length} reference keys missing: ${missing.slice(0, 8).join(", ")}${missing.length > 8 ? " …" : ""}`);
+      else pass(`${lang}: all reference keys covered`);
+    }
+  }
+} else {
+  console.log("  SKIP: no reference root given — completeness vs reference not checked");
+}
+
+process.exit(fail);

package/plugins/mobilems/skills/mobilems-articles/scripts/verify-module.sh

@@ -11,6 +11,7 @@ ROOT="${1:?usage: verify-module.sh <workspace-root> <PREFIX> <name> [template]}"
 PREFIX="${2:?usage: verify-module.sh <workspace-root> <PREFIX> <name> [template]}"
 NAME="${3:?usage: verify-module.sh <workspace-root> <PREFIX> <name> [template]}"
 TEMPLATE="${4:-}"
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 cd "$ROOT" 2>/dev/null || { echo "ERROR: no such dir: $ROOT" >&2; exit 2; }
 
 LIBF="museum-$NAME"
@@ -99,6 +100,15 @@ else
   pass "no filters component in this module"
 fi
 
+echo "== Translations (REF_ROOT=${REF_ROOT:-unset}) =="
+# Groups: present in pl+en, no dead references, complete vs the reference repo
+# (export REF_ROOT=<reference-repo-root> to enable the completeness diff).
+if node "$SCRIPT_DIR/check-translations.js" "${TRANS_GROUPS:-NEWS ARTICLES}" "${REF_ROOT:-}"; then
+  pass "translation groups complete"
+else
+  bad "translation gaps — fix the FAIL lines above"
+fi
+
 echo
 if [ "$fail" = 0 ]; then echo "VERIFY: all checks passed."; else echo "VERIFY: FAILED — fix the items above and re-run." >&2; fi
 exit "$fail"

package/plugins/mobilems/skills/mobilems-object-collections/SKILL.md

@@ -50,10 +50,16 @@ README) — never a per-module copy. `scripts/verify-module.sh` fails the run on
    `@smartsoft001-mobilems/public-collections-shell-angular`,
    `@smartsoft001-mobilems/public-collections-shell-dtos` (match the installed mobilems line).
    Resolve versions at run time; do not `npm install` unless asked. No extra third-party viewer deps.
-2. **Library** — create `libs/museum-collections/{domain,shell/angular}` per `references/lib-contents.md`:
-   copy the domain entity (`MuseumCollection extends PublicCollection`) and the shell
-   (`MuseumCollectionsModule`, routes, `components/filters`, `pages/{list,item}`, `services`), thread
-   `<PREFIX>`. Add the two `tsconfig.base.json` paths and the `museum-collections` commit scope.
+2. **Library** — scaffold `libs/museum-collections` with this package's Nx generator (deterministic — do
+   NOT copy files by hand when the generator is available):
+   ```bash
+   npx nx g @smartsoft001-mobilems/public-collections-shell-angular:museum-module \
+     --referenceRoot=<reference-repo> --prefix=<PREFIX>
+   ```
+   It copies the lib from the reference, threads `@<PREFIX>/`, adds both `tsconfig.base.json`
+   paths, normalizes `project.json` paths and copies the module's translation groups (pl+en).
+   Fallback (older framework line without the generator): do the same by hand per
+   `references/lib-contents.md`. The `museum-collections` commit scope registers automatically from the `libs/` dir name.
 3. **Module + routes** — see `references/module-and-routes.md`: `MuseumCollectionsModule` wraps
    `PublicCollectionsSharedModule.forFeature({ routing: false, config: { type: MuseumCollection, apiUrl, entity: 'publicCollections' } })`
    with the `Masonry` SSR factory and the `CrudService → CollectionsService` provider. Add the lazy
@@ -63,7 +69,11 @@ README) — never a per-module copy. `scripts/verify-module.sh` fails the run on
    `components/collections-grid-item` (it imports `public-collections-domain`) in the shared lib and
    export it from `components/index.ts`. Collections contributes no widget-map entry and no model type
    (those are objects-only).
-5. **Verify** — run `scripts/verify-module.sh <workspace-root> <PREFIX>`: asserts the lib +
+5. **Translations** — copy the module's translation groups (`COLLECTIONS`) from the reference
+   repo's `apps/web/public/translations.json` into the app's file, for BOTH `pl` and `en`.
+   Complete group = every reference key present; every key referenced in the module's code
+   must exist in both languages — a raw `GROUP.key` rendered in the UI is a defect.
+6. **Verify** — run `REF_ROOT=<reference-repo> scripts/verify-module.sh <workspace-root> <PREFIX>`: asserts the lib +
    `MuseumCollection` entity exist, the `forFeature` is wired, the `kolekcje` route is registered
    (top-level + search child), the `collections-grid-item` component is built and exported, and the
    three public-collections deps are present. Fix and re-run.

package/plugins/mobilems/skills/mobilems-object-collections/scripts/check-translations.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+/**
+ * check-translations.js "<GROUP GROUP …>" [reference-root]
+ *
+ * Run from the workspace root (verify-module.sh cd's there). Verifies the
+ * module's translation groups in apps/web/public/translations.json:
+ *   1. each group exists and is non-empty in BOTH pl and en,
+ *   2. every literal GROUP.* key referenced in libs/ or apps/web/src exists
+ *      in both languages (dead references = defect),
+ *   3. with a reference root: every reference key of the group exists in the
+ *      generated file — missing keys are listed (the module is incomplete).
+ * Prints PASS/FAIL lines in the verify-module.sh idiom; exit 1 on any FAIL.
+ */
+const fs = require("fs");
+
+const [groupsArg, refRoot] = process.argv.slice(2);
+const groups = (groupsArg || "").split(/\s+/).filter(Boolean);
+if (!groups.length) { console.log("  FAIL: no translation groups given"); process.exit(1); }
+
+const TRANS = "apps/web/public/translations.json";
+let fail = 0;
+const pass = (m) => console.log(`  PASS: ${m}`);
+const bad = (m) => { console.log(`  FAIL: ${m}`); fail = 1; };
+
+const flat = (obj, prefix) => Object.entries(obj || {}).flatMap(([k, v]) =>
+  v && typeof v === "object" ? flat(v, `${prefix}.${k}`) : [`${prefix}.${k}`]);
+
+const readTrans = (p) => { try { return JSON.parse(fs.readFileSync(p, "utf8")).data.translations; } catch { return null; } };
+
+const gen = readTrans(TRANS);
+if (!gen) { bad(`cannot read ${TRANS}`); process.exit(1); }
+
+// 1. groups present + non-empty in both languages
+const genKeys = { pl: new Set(), en: new Set() };
+for (const lang of ["pl", "en"]) {
+  for (const g of groups) {
+    const keys = flat(gen[lang]?.[g], g);
+    keys.forEach((k) => genKeys[lang].add(k));
+    if (keys.length) pass(`${g} present in ${lang} (${keys.length} keys)`);
+    else bad(`${g} missing or empty in ${lang}`);
+  }
+}
+
+// 2. dead references — literal GROUP.* keys used in sources must exist.
+// Dynamic tails (`GROUP.${x}`) don't match the literal regex, and a matched
+// PREFIX that is a parent of existing keys counts as present.
+const walk = (dir) => {
+  let out = [];
+  for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
+    if (e.name === "node_modules" || e.name.startsWith(".")) continue;
+    const p = `${dir}/${e.name}`;
+    if (e.isDirectory()) out = out.concat(walk(p));
+    else if (/\.(ts|html)$/.test(e.name)) out.push(p);
+  }
+  return out;
+};
+let src = "";
+for (const d of ["libs", "apps/web/src"]) {
+  if (fs.existsSync(d)) src += walk(d).map((f) => { try { return fs.readFileSync(f, "utf8"); } catch { return ""; } }).join("\n");
+}
+const re = new RegExp(`\\b(?:${groups.join("|")})(?:\\.[A-Za-z0-9_]+)+`, "g");
+const used = new Set(src.match(re) || []);
+const dead = { pl: [], en: [] };
+for (const key of used) {
+  for (const lang of ["pl", "en"]) {
+    const ks = genKeys[lang];
+    if (!ks.has(key) && ![...ks].some((k) => k.startsWith(`${key}.`))) dead[lang].push(key);
+  }
+}
+for (const lang of ["pl", "en"]) {
+  if (dead[lang].length) bad(`${lang}: keys referenced in code but missing in ${TRANS}: ${dead[lang].slice(0, 8).join(", ")}${dead[lang].length > 8 ? ` (+${dead[lang].length - 8})` : ""}`);
+  else pass(`no dead ${lang} references (${used.size} literal keys checked)`);
+}
+
+// 3. completeness vs reference
+if (refRoot) {
+  const ref = readTrans(`${refRoot}/apps/web/public/translations.json`);
+  if (!ref) bad(`cannot read reference translations under ${refRoot}`);
+  else {
+    for (const lang of ["pl", "en"]) {
+      const missing = groups.flatMap((g) => flat(ref[lang]?.[g], g)).filter((k) => !genKeys[lang].has(k));
+      if (missing.length) bad(`${lang}: ${missing.length} reference keys missing: ${missing.slice(0, 8).join(", ")}${missing.length > 8 ? " …" : ""}`);
+      else pass(`${lang}: all reference keys covered`);
+    }
+  }
+} else {
+  console.log("  SKIP: no reference root given — completeness vs reference not checked");
+}
+
+process.exit(fail);

package/plugins/mobilems/skills/mobilems-object-collections/scripts/verify-module.sh

@@ -9,6 +9,7 @@ set -eu
 
 ROOT="${1:?usage: verify-module.sh <workspace-root> <PREFIX>}"
 PREFIX="${2:?usage: verify-module.sh <workspace-root> <PREFIX>}"
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 cd "$ROOT" 2>/dev/null || { echo "ERROR: no such dir: $ROOT" >&2; exit 2; }
 
 fail=0
@@ -59,13 +60,14 @@ if grep -rq "provide: Masonry" "$LIBDIR" 2>/dev/null; then
     bad "module provides Masonry but never renders <smart-mobilems-masonry-grid> — hand-rolled grid"
   fi
 fi
-# 3. a list page must render through the framework grid
-LISTP="$(find "$LIBDIR/pages" -maxdepth 1 -type d -name 'list*' 2>/dev/null || true)"
-if [ -n "$LISTP" ]; then
-  if grep -rq "smart-mobilems-masonry-grid" $LISTP 2>/dev/null; then
-    pass "list page renders via <smart-mobilems-masonry-grid>"
+# 3. the ITEM page renders its objects grid through the framework grid — in the
+#    reference the collections LIST is a plain grid; masonry lives on the item page
+ITEMP="$(find "$LIBDIR/pages" -maxdepth 1 -type d -name 'item*' 2>/dev/null || true)"
+if [ -n "$ITEMP" ]; then
+  if grep -rq "smart-mobilems-masonry-grid" $ITEMP 2>/dev/null; then
+    pass "item page renders via <smart-mobilems-masonry-grid>"
   else
-    bad "list page does not render <smart-mobilems-masonry-grid> (README.md#masonrygridcomponent)"
+    bad "item page does not render <smart-mobilems-masonry-grid> (README.md#masonrygridcomponent)"
   fi
 fi
 # 4. filters must EXTEND the framework base class — `context.` alone proves nothing, and a
@@ -82,6 +84,15 @@ else
   pass "no filters component in this module"
 fi
 
+echo "== Translations (REF_ROOT=${REF_ROOT:-unset}) =="
+# Groups: present in pl+en, no dead references, complete vs the reference repo
+# (export REF_ROOT=<reference-repo-root> to enable the completeness diff).
+if node "$SCRIPT_DIR/check-translations.js" "COLLECTIONS" "${REF_ROOT:-}"; then
+  pass "translation groups complete"
+else
+  bad "translation gaps — fix the FAIL lines above"
+fi
+
 echo
 if [ "$fail" = 0 ]; then echo "VERIFY: all checks passed."; else echo "VERIFY: FAILED — fix the items above and re-run." >&2; fi
 exit "$fail"

package/plugins/mobilems/skills/mobilems-objects/SKILL.md

@@ -51,10 +51,16 @@ README) — never a per-module copy. `scripts/verify-module.sh` fails the run on
    `@smartsoft001-mobilems/objects-shell-dtos` (match the installed mobilems line) and
    `online-3d-viewer` (the 3D tab; `leaflet`/`openseadragon`/`swiper` are already foundation deps).
    Resolve versions at run time; do not `npm install` unless asked.
-2. **Library** — create `libs/museum-objects/{domain,shell/angular}` per `references/lib-contents.md`:
-   copy the domain entity/enums and the shell (`MuseumObjectsModule`, routes, `components/*`,
-   `pages/{list,item}`, `services`), thread `<PREFIX>`. Add the two `tsconfig.base.json` paths and the
-   `museum-objects` commit scope.
+2. **Library** — scaffold `libs/museum-objects` with this package's Nx generator (deterministic — do
+   NOT copy files by hand when the generator is available):
+   ```bash
+   npx nx g @smartsoft001-mobilems/objects-shell-angular:museum-module \
+     --referenceRoot=<reference-repo> --prefix=<PREFIX>
+   ```
+   It copies the lib from the reference, threads `@<PREFIX>/`, adds both `tsconfig.base.json`
+   paths, normalizes `project.json` paths and copies the module's translation groups (pl+en).
+   Fallback (older framework line without the generator): do the same by hand per
+   `references/lib-contents.md`. The `museum-objects` commit scope registers automatically from the `libs/` dir name.
 3. **Module + routes** — see `references/module-and-routes.md`: `MuseumObjectsModule` wraps
    `ObjectsSharedModule.forFeature({ routing: false, config: { type: MsObject, apiUrl, entity: 'objects' } })`
    with the `Masonry` SSR factory. Add the lazy `obiekty` route to `appRoutes` in
@@ -63,7 +69,11 @@ README) — never a per-module copy. `scripts/verify-module.sh` fails the run on
    `objects-list-item`, and the object gallery widget (`widget/gallery-object`) in the shared lib +
    export them; register the object gallery widget in the widget content-type map (`GALLERY_OBJECT`);
    and add `ISpecificObject` (extends `MsObject`) to `models/objects.model.ts`.
-5. **Verify** — run `scripts/verify-module.sh <workspace-root> <PREFIX>`: asserts the lib exists, the
+5. **Translations** — copy the module's translation groups (`OBJECTS`, `DETAILS_PAGE`, `GALLERY`) from the reference
+   repo's `apps/web/public/translations.json` into the app's file, for BOTH `pl` and `en`.
+   Complete group = every reference key present; every key referenced in the module's code
+   must exist in both languages — a raw `GROUP.key` rendered in the UI is a defect.
+6. **Verify** — run `REF_ROOT=<reference-repo> scripts/verify-module.sh <workspace-root> <PREFIX>`: asserts the lib exists, the
    `obiekty` route is registered (top-level + search child), the objects shared components are built
    and exported, the widget map registers the object gallery widget, and `ISpecificObject` is present.
    Fix and re-run.

package/plugins/mobilems/skills/mobilems-objects/scripts/check-translations.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+/**
+ * check-translations.js "<GROUP GROUP …>" [reference-root]
+ *
+ * Run from the workspace root (verify-module.sh cd's there). Verifies the
+ * module's translation groups in apps/web/public/translations.json:
+ *   1. each group exists and is non-empty in BOTH pl and en,
+ *   2. every literal GROUP.* key referenced in libs/ or apps/web/src exists
+ *      in both languages (dead references = defect),
+ *   3. with a reference root: every reference key of the group exists in the
+ *      generated file — missing keys are listed (the module is incomplete).
+ * Prints PASS/FAIL lines in the verify-module.sh idiom; exit 1 on any FAIL.
+ */
+const fs = require("fs");
+
+const [groupsArg, refRoot] = process.argv.slice(2);
+const groups = (groupsArg || "").split(/\s+/).filter(Boolean);
+if (!groups.length) { console.log("  FAIL: no translation groups given"); process.exit(1); }
+
+const TRANS = "apps/web/public/translations.json";
+let fail = 0;
+const pass = (m) => console.log(`  PASS: ${m}`);
+const bad = (m) => { console.log(`  FAIL: ${m}`); fail = 1; };
+
+const flat = (obj, prefix) => Object.entries(obj || {}).flatMap(([k, v]) =>
+  v && typeof v === "object" ? flat(v, `${prefix}.${k}`) : [`${prefix}.${k}`]);
+
+const readTrans = (p) => { try { return JSON.parse(fs.readFileSync(p, "utf8")).data.translations; } catch { return null; } };
+
+const gen = readTrans(TRANS);
+if (!gen) { bad(`cannot read ${TRANS}`); process.exit(1); }
+
+// 1. groups present + non-empty in both languages
+const genKeys = { pl: new Set(), en: new Set() };
+for (const lang of ["pl", "en"]) {
+  for (const g of groups) {
+    const keys = flat(gen[lang]?.[g], g);
+    keys.forEach((k) => genKeys[lang].add(k));
+    if (keys.length) pass(`${g} present in ${lang} (${keys.length} keys)`);
+    else bad(`${g} missing or empty in ${lang}`);
+  }
+}
+
+// 2. dead references — literal GROUP.* keys used in sources must exist.
+// Dynamic tails (`GROUP.${x}`) don't match the literal regex, and a matched
+// PREFIX that is a parent of existing keys counts as present.
+const walk = (dir) => {
+  let out = [];
+  for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
+    if (e.name === "node_modules" || e.name.startsWith(".")) continue;
+    const p = `${dir}/${e.name}`;
+    if (e.isDirectory()) out = out.concat(walk(p));
+    else if (/\.(ts|html)$/.test(e.name)) out.push(p);
+  }
+  return out;
+};
+let src = "";
+for (const d of ["libs", "apps/web/src"]) {
+  if (fs.existsSync(d)) src += walk(d).map((f) => { try { return fs.readFileSync(f, "utf8"); } catch { return ""; } }).join("\n");
+}
+const re = new RegExp(`\\b(?:${groups.join("|")})(?:\\.[A-Za-z0-9_]+)+`, "g");
+const used = new Set(src.match(re) || []);
+const dead = { pl: [], en: [] };
+for (const key of used) {
+  for (const lang of ["pl", "en"]) {
+    const ks = genKeys[lang];
+    if (!ks.has(key) && ![...ks].some((k) => k.startsWith(`${key}.`))) dead[lang].push(key);
+  }
+}
+for (const lang of ["pl", "en"]) {
+  if (dead[lang].length) bad(`${lang}: keys referenced in code but missing in ${TRANS}: ${dead[lang].slice(0, 8).join(", ")}${dead[lang].length > 8 ? ` (+${dead[lang].length - 8})` : ""}`);
+  else pass(`no dead ${lang} references (${used.size} literal keys checked)`);
+}
+
+// 3. completeness vs reference
+if (refRoot) {
+  const ref = readTrans(`${refRoot}/apps/web/public/translations.json`);
+  if (!ref) bad(`cannot read reference translations under ${refRoot}`);
+  else {
+    for (const lang of ["pl", "en"]) {
+      const missing = groups.flatMap((g) => flat(ref[lang]?.[g], g)).filter((k) => !genKeys[lang].has(k));
+      if (missing.length) bad(`${lang}: ${missing.length} reference keys missing: ${missing.slice(0, 8).join(", ")}${missing.length > 8 ? " …" : ""}`);
+      else pass(`${lang}: all reference keys covered`);
+    }
+  }
+} else {
+  console.log("  SKIP: no reference root given — completeness vs reference not checked");
+}
+
+process.exit(fail);

package/plugins/mobilems/skills/mobilems-objects/scripts/verify-module.sh

@@ -8,6 +8,7 @@ set -eu
 
 ROOT="${1:?usage: verify-module.sh <workspace-root> <PREFIX>}"
 PREFIX="${2:?usage: verify-module.sh <workspace-root> <PREFIX>}"
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 cd "$ROOT" 2>/dev/null || { echo "ERROR: no such dir: $ROOT" >&2; exit 2; }
 
 fail=0
@@ -89,6 +90,15 @@ else
   pass "no filters component in this module"
 fi
 
+echo "== Translations (REF_ROOT=${REF_ROOT:-unset}) =="
+# Groups: present in pl+en, no dead references, complete vs the reference repo
+# (export REF_ROOT=<reference-repo-root> to enable the completeness diff).
+if node "$SCRIPT_DIR/check-translations.js" "OBJECTS DETAILS_PAGE GALLERY" "${REF_ROOT:-}"; then
+  pass "translation groups complete"
+else
+  bad "translation gaps — fix the FAIL lines above"
+fi
+
 echo
 if [ "$fail" = 0 ]; then echo "VERIFY: all checks passed."; else echo "VERIFY: FAILED — fix the items above and re-run." >&2; fi
 exit "$fail"

package/plugins/mobilems/skills/mobilems-partners/SKILL.md

@@ -72,7 +72,11 @@ README) — never a per-module copy. `scripts/verify-module.sh` fails the run on
    `partnerzy` route to the `appRoutes` array in `apps/web/src/app/app.routes.ts` as a top-level
    route, and a matching child under the `wyszukaj/:text` search route (partners appears in site
    search).
-4. **Verify** — run `scripts/verify-module.sh <workspace-root> <PREFIX>`: asserts the lib + entity
+4. **Translations** — copy the module's translation groups (`PARTNERS`) from the reference
+   repo's `apps/web/public/translations.json` into the app's file, for BOTH `pl` and `en`.
+   Complete group = every reference key present; every key referenced in the module's code
+   must exist in both languages — a raw `GROUP.key` rendered in the UI is a defect.
+5. **Verify** — run `REF_ROOT=<reference-repo> scripts/verify-module.sh <workspace-root> <PREFIX>`: asserts the lib + entity
    exist, both tsconfig paths are added, `ArticlesSharedModule.forFeature` is wired with
    `entity: 'partners'` + `reducerFactory: getReducer`, the `+state/partners.reducer.ts` exports
    `getReducer`, the `components/{grid-item,list-item}` cards are present in the partners lib, the

package/plugins/mobilems/skills/mobilems-partners/scripts/check-translations.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+/**
+ * check-translations.js "<GROUP GROUP …>" [reference-root]
+ *
+ * Run from the workspace root (verify-module.sh cd's there). Verifies the
+ * module's translation groups in apps/web/public/translations.json:
+ *   1. each group exists and is non-empty in BOTH pl and en,
+ *   2. every literal GROUP.* key referenced in libs/ or apps/web/src exists
+ *      in both languages (dead references = defect),
+ *   3. with a reference root: every reference key of the group exists in the
+ *      generated file — missing keys are listed (the module is incomplete).
+ * Prints PASS/FAIL lines in the verify-module.sh idiom; exit 1 on any FAIL.
+ */
+const fs = require("fs");
+
+const [groupsArg, refRoot] = process.argv.slice(2);
+const groups = (groupsArg || "").split(/\s+/).filter(Boolean);
+if (!groups.length) { console.log("  FAIL: no translation groups given"); process.exit(1); }
+
+const TRANS = "apps/web/public/translations.json";
+let fail = 0;
+const pass = (m) => console.log(`  PASS: ${m}`);
+const bad = (m) => { console.log(`  FAIL: ${m}`); fail = 1; };
+
+const flat = (obj, prefix) => Object.entries(obj || {}).flatMap(([k, v]) =>
+  v && typeof v === "object" ? flat(v, `${prefix}.${k}`) : [`${prefix}.${k}`]);
+
+const readTrans = (p) => { try { return JSON.parse(fs.readFileSync(p, "utf8")).data.translations; } catch { return null; } };
+
+const gen = readTrans(TRANS);
+if (!gen) { bad(`cannot read ${TRANS}`); process.exit(1); }
+
+// 1. groups present + non-empty in both languages
+const genKeys = { pl: new Set(), en: new Set() };
+for (const lang of ["pl", "en"]) {
+  for (const g of groups) {
+    const keys = flat(gen[lang]?.[g], g);
+    keys.forEach((k) => genKeys[lang].add(k));
+    if (keys.length) pass(`${g} present in ${lang} (${keys.length} keys)`);
+    else bad(`${g} missing or empty in ${lang}`);
+  }
+}
+
+// 2. dead references — literal GROUP.* keys used in sources must exist.
+// Dynamic tails (`GROUP.${x}`) don't match the literal regex, and a matched
+// PREFIX that is a parent of existing keys counts as present.
+const walk = (dir) => {
+  let out = [];
+  for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
+    if (e.name === "node_modules" || e.name.startsWith(".")) continue;
+    const p = `${dir}/${e.name}`;
+    if (e.isDirectory()) out = out.concat(walk(p));
+    else if (/\.(ts|html)$/.test(e.name)) out.push(p);
+  }
+  return out;
+};
+let src = "";
+for (const d of ["libs", "apps/web/src"]) {
+  if (fs.existsSync(d)) src += walk(d).map((f) => { try { return fs.readFileSync(f, "utf8"); } catch { return ""; } }).join("\n");
+}
+const re = new RegExp(`\\b(?:${groups.join("|")})(?:\\.[A-Za-z0-9_]+)+`, "g");
+const used = new Set(src.match(re) || []);
+const dead = { pl: [], en: [] };
+for (const key of used) {
+  for (const lang of ["pl", "en"]) {
+    const ks = genKeys[lang];
+    if (!ks.has(key) && ![...ks].some((k) => k.startsWith(`${key}.`))) dead[lang].push(key);
+  }
+}
+for (const lang of ["pl", "en"]) {
+  if (dead[lang].length) bad(`${lang}: keys referenced in code but missing in ${TRANS}: ${dead[lang].slice(0, 8).join(", ")}${dead[lang].length > 8 ? ` (+${dead[lang].length - 8})` : ""}`);
+  else pass(`no dead ${lang} references (${used.size} literal keys checked)`);
+}
+
+// 3. completeness vs reference
+if (refRoot) {
+  const ref = readTrans(`${refRoot}/apps/web/public/translations.json`);
+  if (!ref) bad(`cannot read reference translations under ${refRoot}`);
+  else {
+    for (const lang of ["pl", "en"]) {
+      const missing = groups.flatMap((g) => flat(ref[lang]?.[g], g)).filter((k) => !genKeys[lang].has(k));
+      if (missing.length) bad(`${lang}: ${missing.length} reference keys missing: ${missing.slice(0, 8).join(", ")}${missing.length > 8 ? " …" : ""}`);
+      else pass(`${lang}: all reference keys covered`);
+    }
+  }
+} else {
+  console.log("  SKIP: no reference root given — completeness vs reference not checked");
+}
+
+process.exit(fail);

package/plugins/mobilems/skills/mobilems-partners/scripts/verify-module.sh

@@ -10,6 +10,7 @@ set -eu
 
 ROOT="${1:?usage: verify-module.sh <workspace-root> <PREFIX>}"
 PREFIX="${2:?usage: verify-module.sh <workspace-root> <PREFIX>}"
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 cd "$ROOT" 2>/dev/null || { echo "ERROR: no such dir: $ROOT" >&2; exit 2; }
 
 fail=0
@@ -97,6 +98,15 @@ else
   pass "no filters component in this module"
 fi
 
+echo "== Translations (REF_ROOT=${REF_ROOT:-unset}) =="
+# Groups: present in pl+en, no dead references, complete vs the reference repo
+# (export REF_ROOT=<reference-repo-root> to enable the completeness diff).
+if node "$SCRIPT_DIR/check-translations.js" "PARTNERS" "${REF_ROOT:-}"; then
+  pass "translation groups complete"
+else
+  bad "translation gaps — fix the FAIL lines above"
+fi
+
 echo
 if [ "$fail" = 0 ]; then echo "VERIFY: all checks passed."; else echo "VERIFY: FAILED — fix the items above and re-run." >&2; fi
 exit "$fail"