@smartsoft001-mobilems/claude-plugins 2.86.0 → 2.88.0

package/plugins/mobilems/skills/mobilems-project-init/references/shared-lib.md

@@ -0,0 +1,125 @@
+# Build the foundation shared library
+
+The shared library `libs/shared/angular` (alias `@<PREFIX>/angular`) holds the museum's shared
+Angular building blocks: the `App` shell, header, footer, the generic page renderer, filters,
+gallery, map, slider, carousels, content widgets, WCAG + SEO services, interceptors, pipes,
+directives, tools, models, and `configs.module.ts`. Build it by copying from the reference repo's
+`libs/shared/angular/src/lib` and threading `<PREFIX>` (the reference uses `@msr`).
+
+The library starts as the base shell that exports only `environment` + `EnvironmentService` with
+empty `lib/` placeholder dirs — fill those dirs with the **foundation shared components**.
+
+## Foundation shared components vs feature shared components
+
+The shared library contains two kinds of shared component, separated by a simple structural rule:
+
+- A **foundation shared component** depends only on Angular, the smartsoft framework packages, and
+  other foundation shared components. **Build these here.**
+- A **feature shared component** imports a feature domain package
+  (`@smartsoft001-mobilems/objects-domain`, `…/articles-domain`, `…/public-collections-domain`) to
+  render that entity, e.g. the per-entity grid/list cards and the object/article gallery widgets.
+  Each of these belongs to its feature's module skill (`mobilems-objects`,
+  `mobilems-object-collections`, `mobilems-articles`), which builds it alongside the feature's npm
+  package. The foundation does not build them, because the foundation does not install those
+  packages.
+
+This rule keeps the layering clean and lets the foundation library build on its own. The home-page
+carousels (`new-objects-carousel`, `news-carousel`, `partners-carousel`) and the home page are
+**foundation** shared components — they take `IObject` / `IArticle` / `IPartner` from the shared
+`models/data.interface.ts` and never import a feature package, so build them here.
+
+## Identify the foundation set
+
+Run `python3 scripts/classify-shared-components.py <reference-repo>/libs/shared/angular/src/lib/components`.
+It prints two lists — **FOUNDATION** (build here) and **FEATURE-OWNED** (built by a module skill) —
+by following imports: any component that imports a feature package, or a component that does, is
+FEATURE-OWNED. A typical FEATURE-OWNED set (confirm with the classifier on your reference app) is:
+
+| Feature shared component                   | Built by                       |
+| ------------------------------------------ | ------------------------------ |
+| `objects-grid-item`, `objects-list-item`   | `mobilems-objects`             |
+| `widget/gallery-object`                    | `mobilems-objects`             |
+| `collections-grid-item`                    | `mobilems-object-collections`  |
+| `articles-grid-item`, `articles-list-item` | `mobilems-articles` (articles) |
+| `news-grid-item`, `news-list-item`         | `mobilems-articles` (news)     |
+| `widget/gallery-article`                   | `mobilems-articles`            |
+
+Build everything else — `app`, `header`, `footer`, `page`, the `filter*` family, `breadcrumbs`,
+`pagination`, `searchbar`, `loader`, `error-retry`, `scroll-top`, `skip-links`, `wcag`, `gallery`,
+`map`, `slider`, `carousel`, the three carousels above, `category-dropdown`, `dropdown`, `menu-item`,
+`next-page`, `calendar`, `confirmation-modal`, `newsletter-*`, `image-info-panel`, `icons`, `tabs`,
+and the `widget` container with its foundation widgets.
+
+> Trust the script over this table for the **leaf** components (the grid/list cards and the
+> `widget/gallery-*` sub-widgets) — if the reference diverges, the script is authoritative there.
+> **One expected exception:** the script also lists the `widget` **container** (`components/widget`)
+> as FEATURE-OWNED, because the reference container imports the feature gallery sub-widgets. That is
+> not a signal to skip it — the container is foundation infrastructure. Build it (see "The widget
+> container" below) registering only the foundation widgets.
+
+## The widget container
+
+`components/widget/widget.component.ts` renders content blocks by mapping an `ArticleWidgetType` to a
+component. The classifier flags this container FEATURE-OWNED (the reference one imports the feature
+gallery sub-widgets), but build it here — it is foundation infrastructure the page renderer needs.
+Build it registering only the **foundation widgets** — `text`, `image`, `video`, `audio`,
+`gallery-image`, `media` — and their type-map entries; do not import or register the
+`gallery-object` / `gallery-article` sub-widgets (those don't exist in the foundation). The
+`mobilems-objects` / `mobilems-articles` skills add their `GALLERY_OBJECT` / `GALLERY_ARTICLE` imports
+and type-map entries when they build those widgets. Build the widget barrel
+(`components/widget/index.ts`) exporting the foundation widgets only.
+
+## models/objects.model.ts
+
+This file holds foundation model types the shared components use (`SortType`, `KeyValue` → `dropdown`,
+`AdvancedFilterType` → `filter-dictionary-input`, `FileType`, `MULTIMEDIA_DICTIONARY`,
+`IModel3DObject`, `IAnimationObject`, …). Build it with those types. The one object-specific type,
+`ISpecificObject extends MsObject`, is a feature type — the `mobilems-objects` skill adds it (with
+the `MsObject` import) when it builds the objects module. Keep `models/index.ts` exporting
+`./objects.model`.
+
+## The rest of the lib
+
+Build `services/`, `pipes/`, `directives/`, `tools/`, `models/` (incl. `data.interface.ts` with
+`IObject`/`IArticle`/`IPartner`), `interceptors/`, `environments/` (with the `multimediaUrl` field —
+see `server-env.md`), and `configs.module.ts`. These are foundation code. Confirm with the
+build-safety grep below; if any of these files imports a feature package on your reference, it is
+feature code and belongs to a module skill — leave it out.
+
+## Barrels
+
+- `src/index.ts` — the full barrel: re-export `./lib/components`, `./lib/services`,
+  `./lib/configs.module`, `./lib/models`, `./lib/pipes`, `./lib/tools`, `./lib/interceptors`,
+  `./lib/directives`, `./lib/environments`.
+- `components/index.ts` — export the foundation shared components (and keep the `COMPONENTS` array,
+  which holds `AppComponent`/`FooterComponent`/`HeaderComponent`). Module skills add their feature
+  shared components' exports when they build them.
+
+## Build-safety invariant
+
+The foundation library must build with no feature package installed. The check is positive and
+authoritative — this grep over the workspace's shared lib returns nothing:
+
+```bash
+grep -rlnE "from '@[^']*/(objects|articles|public-collections)-(domain|shell-angular|shell-dtos)'" \
+  libs/shared/angular/src
+```
+
+`verify-init.sh` runs it, plus checks the `widget` container imports no gallery-object/article and
+`objects.model.ts` carries no `MsObject` import.
+
+## project.json / build config
+
+Keep the base's normalized `libs/shared/angular/project.json`, `ng-package.json`, `jest.config.ts`,
+and tsconfigs (a full base already fixed the generator's `packages/shared/angular` leftover). Verify
+`tsconfig.lib.json` keeps `"types": ["node"]` (the env code uses `process.env`). If the base's shared
+lib is minimal and ships only `src/` (no `project.json`/`ng-package.json`/`jest.config.ts`/tsconfigs),
+copy those from the reference and normalize their `dest`/`coverageDirectory`/paths to
+`libs/shared/angular/...`.
+
+## Thread the prefix everywhere — including the lib's own package.json
+
+After copying, the only reference-prefix string left should be gone. Beyond the import statements,
+remember to thread `<PREFIX>` in `libs/shared/angular/package.json` `"name"` (it reads
+`@<reference-prefix>/angular` in the reference → set it to `@<PREFIX>/angular`). A workspace-wide grep
+for the reference prefix (`@msr/`) should return nothing.

package/plugins/mobilems/skills/mobilems-project-init/references/tailwind-styles.md

@@ -0,0 +1,112 @@
+# Tailwind (smart- prefix) layered onto scss
+
+The base is scss-only. MobilEMS adds Tailwind with the **`smart-`** class prefix (so utilities read
+`smart-flex`, `smart-container`, …) and a museum global stylesheet. Tailwind processes the scss via
+postcss, so scss and Tailwind coexist — no migration.
+
+## 1. `tailwind.config.js` (workspace root — create verbatim, no placeholders)
+
+```js
+/** @type {import('tailwindcss').Config} */
+module.exports = {
+  content: ['./apps/web/src/**/*.{html,ts}', './libs/**/*.{html,ts}'],
+  prefix: 'smart-',
+  darkMode: ['class', '[class~="contrast-high"]'],
+  theme: {
+    extend: {
+      colors: {
+        primary: {
+          DEFAULT: '#414141',
+          active: 'rgb(223 223 223)',
+          red: 'rgb(193 18 31)',
+        },
+        dark: {
+          DEFAULT: '#100f0d',
+          yellow: '#ffff00',
+        },
+      },
+      gridTemplateColumns: {
+        'auto-fit': 'repeat(auto-fit, minmax(min(350px, 100%), 1fr))',
+      },
+      boxShadow: {
+        custom:
+          '0px 5px 5px rgba(0, 0, 0, 0.2), 0 10px 10px rgba(0, 0, 0, 0.1), 0 20px 20px rgba(0, 0, 0, 0.15)',
+      },
+      fontFamily: {
+        satoshi: [
+          'Satoshi',
+          'Satoshi Fallback',
+          'Satoshi Fallback Android',
+          'sans-serif',
+        ],
+        oswald: [
+          'Oswald',
+          'Oswald Fallback',
+          'Oswald Fallback Android',
+          'sans-serif',
+        ],
+        'fira-sans': [
+          'Fira Sans',
+          'Fira Sans Fallback',
+          'Fira Sans Fallback Android',
+          'sans-serif',
+        ],
+      },
+      fontWeight: { extralight: '200' },
+    },
+  },
+  plugins: [],
+};
+```
+
+> The `content` globs already cover `libs/**`, so feature libs added later are picked up — no edit
+> needed when modules arrive. `darkMode` keys off `contrast-high` for the WCAG high-contrast toggle.
+
+> **QA gotcha (fonts):** when the project's design swaps in its own heading font, verify it covers
+> Polish diacritics (`ą ć ę ł ń ś ź ż` + uppercase). Bacasime Antique, Prata and Italiana lack them
+> — titles silently render in a fallback font and QA rejects it (verified replacements: Gilda
+> Display, Playfair Display). Never leave a `fontFamily` entry as an empty array — it falls back to
+> system sans. See `references/qa-hardening.md` §5.
+
+## 2. postcss
+
+Add Tailwind + autoprefixer to postcss. If the base has a `postcss.config.js`/`.json`, add the
+plugins; otherwise create `postcss.config.js`:
+
+```js
+module.exports = {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {},
+  },
+};
+```
+
+Add `tailwindcss` + `autoprefixer` to `devDependencies` (resolve current lines via `npm view`). The
+base `.eslintignore` already ignores `**/tailwind.config.js`.
+
+## 3. `apps/web/src/styles.scss` (overwrite)
+
+**Reference mode:** copy `apps/web/src/styles.scss` from the reference repo verbatim. It is ~500
+lines of pure CSS/scss — font-face metric-override fallbacks (CLS mitigation), the Tailwind
+directives (`@tailwind base/components/utilities`), the swiper + leaflet css imports, `.smart-container*`
+layout utilities, WCAG body classes (`text-small`/`text-large`/letter+word spacing/grayscale),
+masonry column widths, fullscreen-`dialog` rules, and the Windows `forced-colors` block. It targets
+some feature selectors (e.g. `app-thematic-paths-menu`) but that is harmless — CSS for absent
+elements is a no-op, so copy it whole.
+
+**Foundation-only mode:** write a minimal `styles.scss` with just the Tailwind directives + the
+`@import` lines for swiper/leaflet and the `.smart-container` utility; note the rest in the TODO doc.
+
+The structure is:
+
+```scss
+@import 'swiper/swiper-bundle.css';
+@import 'leaflet/dist/leaflet.css';
+
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+/* font-face fallbacks, @layer utilities { .smart-container … }, WCAG, masonry, dialogs, forced-colors */
+```

package/plugins/mobilems/skills/mobilems-project-init/scripts/classify-shared-components.py

@@ -0,0 +1,114 @@
+#!/usr/bin/env python3
+"""classify-shared-components.py <shared-lib components dir>
+
+Split a MobilEMS shared-lib `components` tree into FOUNDATION shared components (mobilems-project-init
+builds these) and FEATURE-OWNED shared components (built by the owning mobilems-<module> skill,
+because they depend on a feature package).
+
+A "component" is a directory holding a non-spec *.component.ts. It is FEATURE-OWNED when it:
+  1. imports a feature package (objects/articles/public-collections/news/partners domain|shell,
+     or a @.../museum-<x> subpath), OR
+  2. imports another FEATURE-OWNED component — by relative path or by that component's exported
+     symbol (transitive, to a fixpoint).
+
+Trust this over any hand-maintained table: if the reference repo diverges, this is authoritative.
+Exit 0 on success; prints two sections (FEATURE-OWNED, FOUNDATION), one path per line, relative to <dir>.
+"""
+import os
+import re
+import sys
+
+FEATURE_RE = re.compile(
+    r"(objects|articles|public-collections|news|partners)-(domain|shell-angular|shell-dtos)"
+    r"|/museum-[a-z-]+"
+)
+EXPORT_RE = re.compile(r"export\s+(?:class|const|interface|type)\s+([A-Za-z0-9_]+)")
+IMPORT_LINE_RE = re.compile(r"^\s*import\b|from\s+['\"]")
+REL_IMPORT_RE = re.compile(r"from\s+['\"](\.\.?/[^'\"]+)['\"]")
+
+
+def unit_ts_files(unit):
+    return [
+        os.path.join(unit, f)
+        for f in os.listdir(unit)
+        if f.endswith(".ts") and not f.endswith(".spec.ts")
+    ]
+
+
+def read(files):
+    out = []
+    for f in files:
+        try:
+            with open(f, encoding="utf-8") as fh:
+                out.append(fh.read())
+        except OSError:
+            pass
+    return "\n".join(out)
+
+
+def main():
+    if len(sys.argv) != 2:
+        sys.exit("usage: classify-shared-components.py <shared-lib/src/lib/components>")
+    root = os.path.abspath(sys.argv[1])
+    if not os.path.isdir(root):
+        sys.exit(f"ERROR: not a directory: {root}")
+
+    # discover units (dirs with a non-spec *.component.ts)
+    units = sorted(
+        {
+            dirpath
+            for dirpath, _, files in os.walk(root)
+            if any(f.endswith(".component.ts") and not f.endswith(".spec.ts") for f in files)
+        }
+    )
+
+    text = {u: read(unit_ts_files(u)) for u in units}
+    imports = {u: "\n".join(l for l in text[u].splitlines() if IMPORT_LINE_RE.search(l)) for u in units}
+    exports = {
+        u: set(EXPORT_RE.findall(text[u])) for u in units
+    }
+
+    feature_owned = {u for u in units if FEATURE_RE.search(imports[u])}
+
+    changed = True
+    while changed:
+        changed = False
+        feature_owned_symbols = {}
+        for d in feature_owned:
+            for s in exports[d]:
+                feature_owned_symbols.setdefault(s, d)
+        for u in units:
+            if u in feature_owned:
+                continue
+            hit = False
+            # (a) relative import into a feature_owned unit's directory
+            for rel in REL_IMPORT_RE.findall(imports[u]):
+                target = os.path.normpath(os.path.join(u, rel))
+                if any(target == d or target.startswith(d + os.sep) for d in feature_owned):
+                    hit = True
+                    break
+            # (b) imports a symbol exported by a feature_owned unit
+            if not hit:
+                for s in feature_owned_symbols:
+                    if re.search(r"\b" + re.escape(s) + r"\b", imports[u]):
+                        hit = True
+                        break
+            if hit:
+                feature_owned.add(u)
+                changed = True
+
+    def rel(u):
+        return os.path.relpath(u, root)
+
+    print("FEATURE-OWNED:")
+    for u in units:
+        if u in feature_owned:
+            print("  " + rel(u))
+    print("FOUNDATION:")
+    for u in units:
+        if u not in feature_owned:
+            print("  " + rel(u))
+
+
+if __name__ == "__main__":
+    main()

package/plugins/mobilems/skills/mobilems-project-init/scripts/detect-base.sh

@@ -0,0 +1,49 @@
+#!/usr/bin/env bash
+#
+# detect-base.sh <workspace-root>
+#
+# Precondition gate for mobilems-project-init. Confirms the target is a scaffold-nx-workspace BASE
+# (generic Nx + Angular-SSR shell) that has NOT yet had the MobilEMS delta applied. Portable to the
+# macOS system bash (3.2) — no bash-4 features.
+#
+# Exit 0  → base detected, OK to apply the delta.
+# Exit 3  → no base shell found (tell the user to run /smart:scaffold-nx-workspace first).
+# Exit 4  → MobilEMS delta already present (init looks already applied).
+set -eu
+
+ROOT="${1:?usage: detect-base.sh <workspace-root>}"
+cd "$ROOT" 2>/dev/null || { echo "ERROR: no such dir: $ROOT" >&2; exit 2; }
+
+fail_no_base() {
+  echo "NOT A BASE: $1" >&2
+  echo "Run /smart:scaffold-nx-workspace first to create the generic Nx + Angular-SSR shell." >&2
+  exit 3
+}
+
+# --- base shell signals ---
+[ -f apps/web/src/server.ts ]            || fail_no_base "apps/web/src/server.ts missing"
+[ -f apps/web/src/app/app.config.ts ]    || fail_no_base "apps/web/src/app/app.config.ts missing"
+[ -f apps/web/src/app/app.routes.ts ]    || fail_no_base "apps/web/src/app/app.routes.ts missing"
+[ -f libs/shared/angular/src/index.ts ]  || fail_no_base "libs/shared/angular/src/index.ts missing"
+[ -f tsconfig.base.json ]                || fail_no_base "tsconfig.base.json missing"
+
+# base app.routes.ts has no feature loadChildren yet
+if grep -qE "loadChildren" apps/web/src/app/app.routes.ts; then
+  echo "WARNING: app.routes.ts already has loadChildren — base may already be extended." >&2
+fi
+
+# --- already-applied signals (any one → likely already MobilEMS) ---
+applied=0
+[ -f tailwind.config.js ] && grep -q "smart-" tailwind.config.js 2>/dev/null && applied=1
+grep -q "@smartsoft001-mobilems/angular" package.json 2>/dev/null && applied=1
+[ -d libs/museum-objects ] && applied=1
+if [ "$applied" = 1 ]; then
+  echo "ALREADY APPLIED: MobilEMS signals found (tailwind smart- prefix / mobilems dep / libs/museum-*)." >&2
+  echo "If you meant to re-run, revert the delta first." >&2
+  exit 4
+fi
+
+# --- report the detected prefix (from the single tsconfig path) ---
+PREFIX="$(grep -oE '@[a-z0-9-]+/angular' tsconfig.base.json | head -1 | sed -E 's#@([a-z0-9-]+)/angular#\1#')"
+echo "BASE OK. Detected prefix: ${PREFIX:-<unknown — inspect tsconfig.base.json paths>}"
+exit 0

package/plugins/mobilems/skills/mobilems-project-init/scripts/verify-init.sh

@@ -0,0 +1,81 @@
+#!/usr/bin/env bash
+#
+# verify-init.sh <workspace-root> <PREFIX>
+#
+# Post-condition check for mobilems-project-init. Asserts the MobilEMS delta landed AND the hard
+# foundation is self-contained (no feature modules / no feature routes / shared lib imports no
+# feature package).
+# Portable to macOS system bash (3.2). Exit 0 = all pass; exit 1 = one or more checks failed.
+set -eu
+
+ROOT="${1:?usage: verify-init.sh <workspace-root> <PREFIX>}"
+PREFIX="${2:?usage: verify-init.sh <workspace-root> <PREFIX>}"
+cd "$ROOT" 2>/dev/null || { echo "ERROR: no such dir: $ROOT" >&2; exit 2; }
+
+fail=0
+pass() { echo "  PASS: $1"; }
+bad()  { echo "  FAIL: $1" >&2; fail=1; }
+
+echo "== Delta applied =="
+[ -f tailwind.config.js ] && grep -q "prefix: 'smart-'" tailwind.config.js && pass "tailwind smart- prefix" || bad "tailwind.config.js with smart- prefix"
+grep -q "@smartsoft001-mobilems/angular" package.json && pass "mobilems framework dep" || bad "@smartsoft001-mobilems/angular in package.json"
+grep -q "@ngrx/store" package.json && pass "ngrx dep" || bad "@ngrx/store in package.json"
+grep -q "SharedModule.forRoot" apps/web/src/app/app.config.ts && pass "SharedModule.forRoot in app.config" || bad "SharedModule.forRoot in app.config.ts"
+grep -q "SEARCH_CONFIG_TOKEN" apps/web/src/app/app.config.ts && pass "SEARCH_CONFIG_TOKEN" || bad "SEARCH_CONFIG_TOKEN in app.config.ts"
+grep -q "multimediaUrl" apps/web/src/server.ts && pass "multimediaUrl in server.ts" || bad "multimediaUrl in server.ts"
+grep -q "/api/translations" apps/web/src/server.ts && pass "/api/translations endpoint" || bad "/api/translations in server.ts"
+
+echo "== QA hardening (references/qa-hardening.md) =="
+# dynamic sitemap/robots endpoints (static copies shipped another museum's domain in past projects)
+grep -q "sitemap.xml" apps/web/src/server.ts && pass "dynamic /sitemap.xml endpoint" || bad "/sitemap.xml endpoint in server.ts (SITE_URL-driven, never a static copy)"
+grep -q "robots.txt" apps/web/src/server.ts && pass "dynamic /robots.txt endpoint" || bad "/robots.txt endpoint in server.ts (SITE_URL-driven, never a static copy)"
+if ls apps/web/public/favicon.ico apps/web/src/favicon.ico >/dev/null 2>&1; then pass "favicon present"; else bad "favicon.ico missing (QA bug 'Brak ikony' in two projects)"; fi
+# an empty fontFamily array silently falls back to system sans (QA-rejected typography)
+if grep -qE ":\s*\[\s*\]" tailwind.config.js 2>/dev/null; then bad "empty fontFamily array in tailwind.config.js (heading font falls back to system sans)"; else pass "no empty fontFamily entries"; fi
+grep -q "./lib/components" libs/shared/angular/src/index.ts && pass "shared-lib components barrel populated" || bad "components barrel in shared-lib index.ts"
+[ -f .claude/settings.json ] && grep -q "flow@mobilems" .claude/settings.json && pass "flow@mobilems enabled" || bad "flow@mobilems in .claude/settings.json"
+
+echo "== Foundation scope (no feature modules yet) =="
+if ls -d libs/museum-* >/dev/null 2>&1; then bad "libs/museum-* present (feature modules are built by the module skills)"; else pass "no libs/museum-*"; fi
+# feature routes reference a museum-* lib; loadChildren + the import often span lines, so match museum- anywhere
+if grep -qE "museum-" apps/web/src/app/app.routes.ts; then bad "feature route (museum-*) in app.routes.ts"; else pass "no feature routes"; fi
+
+echo "== Foundation shared library is self-contained =="
+COMP=libs/shared/angular/src/lib/components
+# the widget container registers only foundation widgets (feature gallery widgets are added by module skills)
+WID="$COMP/widget/widget.component.ts"
+if [ -f "$WID" ]; then
+  if grep -qE "WidgetGalleryObjectComponent|WidgetGalleryArticleComponent" "$WID"; then
+    bad "widget container references a feature gallery widget — build it with foundation widgets only"
+  else
+    pass "widget container has foundation widgets only"
+  fi
+else
+  bad "widget container missing"
+fi
+# objects.model holds only the foundation model types (the object-specific ISpecificObject is feature code)
+OBJMODEL=libs/shared/angular/src/lib/models/objects.model.ts
+if [ -f "$OBJMODEL" ]; then
+  grep -qE "from '[^']*objects-domain'" "$OBJMODEL" && bad "objects.model imports MsObject — foundation holds only the generic types" || pass "objects.model holds foundation types only"
+  grep -qE "AdvancedFilterType|KeyValue" "$OBJMODEL" && pass "foundation model types present" || bad "foundation model types missing from objects.model.ts"
+fi
+
+echo "== Build-safety invariant: shared lib imports no feature package =="
+LEAK="$(grep -rlnE "from '@[^']*/(objects|articles|public-collections)-(domain|shell-angular|shell-dtos)'" libs/shared/angular/src 2>/dev/null || true)"
+if [ -n "$LEAK" ]; then
+  bad "shared lib still imports a feature package — foundation will not build without it:"
+  printf '        %s\n' $LEAK >&2
+else
+  pass "shared lib imports no feature package"
+fi
+
+echo "== Prefix threaded =="
+if grep -rq "@msr/" libs/shared/angular/src apps/web/src 2>/dev/null && [ "$PREFIX" != "msr" ]; then
+  bad "stray @msr/ imports (prefix not fully threaded to @$PREFIX/)"
+else
+  pass "no stray reference-prefix imports"
+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-thematic-publications/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: mobilems-thematic-publications
+description: Add the museum THEMATIC PATHS / PUBLICATIONS feature module (ścieżki tematyczne) to a MobilEMS app initialized with mobilems-project-init. Use whenever the user wants to add / scaffold / wire the thematic paths / thematic publications module, the "ścieżki tematyczne" pages (list + paged publication reader with widgets), or asks to "dodaj moduł ścieżek tematycznych / publikacji tematycznych". Creates libs/museum-thematic-paths (domain + shell/angular), registers the /sciezki-tematyczne route, and adds the Articles npm packages it reuses. Requires the MobilEMS foundation to exist first.
+user-invocable: true
+allowed-tools: Bash, Read, Write, Edit, Glob, Grep, AskUserQuestion
+---
+
+# MobilEMS thematic paths / publications module
+
+Add the **thematic paths / publications** (ścieżki tematyczne) feature module on top of a MobilEMS
+foundation produced by `mobilems-project-init`. This module's entire UI lives inside its own
+`libs/museum-thematic-paths` library, so this skill builds that library and registers a single
+top-level route.
+
+> **Naming heads-up.** This skill is named _thematic-publications_ (the museum-domain term users say),
+> but the artifact it generates is **thematic-paths**: folder `libs/museum-thematic-paths`, class
+> `MuseumThematicPathsModule`, route `sciezki-tematyczne`, entity `'thematicPaths'`. Always emit the
+> _thematic-paths_ names — "publications" is only the spoken alias.
+
+The module is a list/detail feature where each entry is a multi-page publication: a `ListComponent`
+of thematic paths plus an `ItemComponent` that renders a paged reader (intro, menu, page, widgets —
+page-header, text, image, video, audio, image-gallery) backed by `ArticlesSharedModule.forFeature`
+over the `MuseumThematicPath` entity. It REUSES the Articles shared module (like news) but with its
+OWN domain entity, its OWN reducer (`getReducer`), and **no `baseQuery`**.
+
+## Precondition
+
+Run `scripts/detect-init.sh <workspace-root>`. It confirms the MobilEMS foundation is present
+(`SharedModule.forRoot` in `app.config.ts`, a populated shared-lib barrel). If not, tell the user to
+run `/mobilems:project-init` first. Hold `<PREFIX>` (from `tsconfig.base.json`; reference uses
+`@msr`) and the reference repo path (same one init used).
+
+## Steps
+
+1. **npm deps** — add `@smartsoft001-mobilems/articles-domain`,
+   `@smartsoft001-mobilems/articles-shell-angular`, `@smartsoft001-mobilems/articles-shell-dtos`
+   (this module reuses the Articles shared module — `ArticlesSharedModule` + `ArticlesService`).
+   Match the installed mobilems line; resolve versions at run time; do not `npm install` unless
+   asked. Adding is idempotent — if `mobilems-articles` already installed these, nothing changes.
+2. **Library** — create `libs/museum-thematic-paths/{domain,shell/angular}` per
+   `references/lib-contents.md`: copy the domain entity/interfaces/enums and the shell
+   (`MuseumThematicPathsModule`, routes, `+state/*`, `components/*`, `pages/{list,item}`, `services`,
+   `directives`), thread `<PREFIX>`. Add the two `tsconfig.base.json` paths and the
+   `museum-thematic-paths` commit scope.
+3. **Module + routes** — see `references/module-and-routes.md`: `MuseumThematicPathsModule` wraps
+   `ArticlesSharedModule.forFeature({ routing: false, config: { reducerFactory: getReducer, type: MuseumThematicPath, apiUrl, entity: 'thematicPaths' } })`
+   (note: **no baseQuery**) with the `Masonry` SSR factory and provides `ThematicPathsFacade` +
+   `SERVICES`. Add the lazy `sciezki-tematyczne` route to the `appRoutes` array in
+   `apps/web/src/app/app.routes.ts` as a single top-level route.
+4. **Verify** — run `scripts/verify-module.sh <workspace-root> <PREFIX>`: asserts the lib + entity
+   exist, the tsconfig path is added, `ArticlesSharedModule.forFeature` is wired with
+   `entity: 'thematicPaths'` + `MuseumThematicPath` + `reducerFactory`, `ThematicPathsFacade` is
+   provided, the `+state` files are present, the `sciezki-tematyczne` route is registered as a single
+   top-level route, and the three Articles deps are in `package.json`. Fix and re-run.
+
+## Notes
+
+- This skill ONLY touches the thematic-paths module + its route. It never adds other feature modules,
+  never re-runs the foundation, and never edits `libs/shared/angular`.
+- Bundled `references/` + `scripts/` ship automatically. Do not hand-edit `plugin.json`.