@smartsoft001-mobilems/claude-plugins 2.107.0 → 2.109.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smartsoft001-mobilems/claude-plugins",
-  "version": "2.107.0",
+  "version": "2.109.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.107.0"
+  "version": "2.109.0"
 }

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

@@ -57,6 +57,10 @@ list — re-implementing framework code is a defect, not a shortcut:
 
 | Do not hand-roll                                             | Use                                                                                                                                               |
 | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
+| The list page logic (first read from `?filter=`/persisted filter, persistence, sort/limit/page, search tab, read guard, list mode, list SEO) | `ArticlesCatalogBaseComponent` (`super({ defaults, persistKey, listPath, searchTab, seo })`) on `createCatalog`; cycle tags: `createArticleCycleTags(this.catalog)` |
+| The details page logic (SEO + SSR SEO, parent title, scroll, visit counter, widgets, authors, cycle tags) | `ArticleDetailsBaseComponent`; related module: `createArticleRelated(id)` |
+| Card logic (image, authors, tags, `?filter=` links) and `logVisit` / `related` HTTP calls | `ArticleCardBaseComponent`; `ArticlesService.logVisit` / `getRelated` |
+| A `Masonry` `useFactory` in the module | `provideBrowserMasonry()` |
 | a masonry grid (`new Masonry(...)`, per-page masonry JS/CSS) | `<smart-mobilems-masonry-grid>` (`MasonryGridComponent`) with a `#masonryContentTpl`; the `Masonry` provider only feeds it                        |
 | filter state / hand-built `query` arrays                     | `FiltersBaseComponent<Article>` + its `FiltersContext` accessors (`searchText`, `authors`, `cycles`, `publicationDateFrom/To`, `page`, `sort`, …) |
 | list/detail plumbing (facade wiring, id-from-route, PDF)     | the `ArticlesListComponent` / `ArticlesItemComponent` base classes                                                                                |
@@ -137,6 +141,6 @@ article-module-specific ones:
 
 - One run builds one named article module. Run the skill again — with a different name + template — for
   each additional content type the project needs.
-- Article modules reuse the foundation's generic `IArticle` model and the foundation's news carousel —
+- Article modules reuse the foundation's generic `IArticleListItem` model (`@smartsoft001-mobilems/angular`) and the foundation's news carousel —
   this skill does not rebuild them.
 - Bundled `references/` + `scripts/` ship automatically. Do not hand-edit `plugin.json`.

package/plugins/mobilems/skills/mobilems-articles/references/shared-components.md

@@ -23,9 +23,9 @@ export * from './<name>-grid-item';
 export * from './<name>-list-item';
 ```
 
-These render an `Article` (via the foundation's generic `IArticle` model), so they depend on
+These render an `Article` (via the framework's generic `IArticleListItem` model), so they depend on
 `@smartsoft001-mobilems/articles-domain` — which this skill installs. There is no module-specific
-model type to add (contrast `mobilems-objects`, which adds `ISpecificObject` to `objects.model.ts`).
+model type to add.
 
 ## Optional: article gallery widget
 

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

@@ -67,15 +67,15 @@ README) — never a per-module copy. `scripts/verify-module.sh` fails the run on
    `apps/web/src/app/app.routes.ts` and a matching child under the `wyszukaj/:text` search route.
 4. **Objects shared components** — see `references/shared-components.md`: build `objects-grid-item`,
    `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`.
+   export them; and register the object gallery widget in the widget content-type map (`GALLERY_OBJECT`).
+   `ISpecificObject` and the filter models come from `@smartsoft001-mobilems/objects-shell-angular`.
 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.
+   and exported, the widget map registers the object gallery widget, and no local `objects.model.ts` exists.
    Fix and re-run.
 
 ## Known pitfalls (fix while copying, not after)

package/plugins/mobilems/skills/mobilems-objects/references/shared-components.md

@@ -43,27 +43,15 @@ import { WidgetGalleryObjectComponent } from './gallery-object/widget-gallery-ob
 The widget container renders sub-widgets via `NgComponentOutlet`, so the gallery widget goes in the
 type-map only — it does **not** go in the container's `imports` array.
 
-## 3. Object model type
+## 3. Object model types — framework
 
-`models/objects.model.ts` holds the foundation model types plus the object-specific `ISpecificObject`,
-which extends `MsObject`. Add the import and the **full** interface — copy `ISpecificObject` verbatim
-from the reference's `models/objects.model.ts` (it has a real field set; do not leave it as an empty
-stub, or the objects `description-container` component won't compile):
-
-```ts
-import { MsObject } from '@smartsoft001-mobilems/objects-domain';
-// …
-export interface ISpecificObject extends MsObject {
-  // …copy the full field set from the reference objects.model.ts…
-}
-```
-
-`ISpecificObject` is consumed by the objects `description-container` component, so it must be present
-(with its real fields) before that compiles. Note `verify-module.sh` only checks the interface
-exists — it can't tell a stub from the real thing, so copy the fields.
+`ISpecificObject` (extends `MsObject`, used by the `description-container` component) and the filter
+models (`SortType`, `IKeyValue`, `AdvancedFilterType`, `FormFeatureType`, `FileType`,
+`MULTIMEDIA_DICTIONARY`, …) are exported by `@smartsoft001-mobilems/objects-shell-angular`. Import
+them from there; do not create `models/objects.model.ts` (reference repos still have one — re-point its
+imports, and rename `KeyValue` → `IKeyValue`, `MultimediaDictionaryItem` → `IMultimediaDictionaryItem`).
 
 ## Verify
 
 `scripts/verify-module.sh` checks the two card components + the gallery widget exist and are exported,
-the widget map registers `WidgetGalleryObjectComponent`, and `ISpecificObject` is present in
-`objects.model.ts`.
+and the widget map registers `WidgetGalleryObjectComponent`.

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

@@ -3,7 +3,7 @@
 # verify-module.sh <workspace-root> <PREFIX>
 #
 # Post-condition check for mobilems-objects: library created, route registered (top-level + search
-# child), objects shared components built + wired into the widget map + objects.model. bash 3.2 safe.
+# child), objects shared components built + wired into the widget map; no local objects.model. bash 3.2 safe.
 set -eu
 
 ROOT="${1:?usage: verify-module.sh <workspace-root> <PREFIX>}"
@@ -40,8 +40,7 @@ echo "== Widget map + object model =="
 WID="$COMP/widget/widget.component.ts"
 grep -q "WidgetGalleryObjectComponent" "$WID" && pass "object gallery widget registered in widget map" || bad "object gallery widget not in widget map"
 OBJM=libs/shared/angular/src/lib/models/objects.model.ts
-grep -q "objects-domain" "$OBJM" && pass "objects.model imports MsObject" || bad "objects.model MsObject import missing"
-grep -qE "interface ISpecificObject" "$OBJM" && pass "ISpecificObject present" || bad "ISpecificObject missing"
+[ ! -f "$OBJM" ] && pass "no local objects.model.ts (framework objects-shell-angular)" || bad "$OBJM duplicates @smartsoft001-mobilems/objects-shell-angular models — import them from there"
 
 echo "== Deps =="
 grep -q "@smartsoft001-mobilems/objects-domain" package.json && pass "objects-domain dep" || bad "objects-domain dep missing"

package/plugins/mobilems/skills/mobilems-project-init/SKILL.md

@@ -104,8 +104,9 @@ stylesheet is pure CSS — copying it verbatim is safe even before the component
 
 ### 5. Runtime env + entry files on the framework
 
-Per `references/server-env.md`: add `multimediaUrl` to `environment.ts`/`.prod.ts` and
-`EnvironmentService`, then **overwrite** the three base entry files with the framework-backed ones —
+Per `references/server-env.md`: replace `environment.ts` with `createMobilemsEnvironment()` (delete
+`environment.prod.ts` and its `fileReplacements`), take `EnvironmentService` from the framework
+(`env-init.ts` calls `EnvironmentService.initFromProcessEnv(environment)`), then **overwrite** the three base entry files with the framework-backed ones —
 `main.ts` (`bootstrapApplication` from `@smartsoft001-mobilems/angular/bootstrap`, registers masonry
 on `window`), `main.server.ts` (`bootstrapServerApplication` from
 `@smartsoft001-mobilems/angular/bootstrap/server`; `./env-init` stays the first import) and
@@ -128,10 +129,11 @@ component that depends only on Angular + the framework packages + other foundati
 Run `python3 scripts/classify-shared-components.py` against the reference's
 `libs/shared/angular/src/lib/components` to list which shared components are FOUNDATION (build here)
 vs FEATURE-OWNED (built by a module skill, because they import a feature package). Build the
-foundation components (including the home-page carousels) + all services/pipes/directives/tools/models
+foundation components (including the home-page carousels) + the app-only services/pipes/tools
 
 - `configs.module.ts`, thread `<PREFIX>`, export them from the barrels, and build the `widget`
-  container + `models/objects.model.ts` with their foundation parts. A shared component that imports a
+  container. Models, the common pipes/directives/services/tools and the objects filter models are
+  framework exports (`references/shared-lib.md`) — never copy them. A shared component that imports a
   feature domain package is feature code — a module skill builds it.
 
 ### 8. App shell + static pages + routes

package/plugins/mobilems/skills/mobilems-project-init/references/config-providers.md

@@ -8,7 +8,7 @@ are overwritten in step 5 (`references/server-env.md` §3).
 The framework provides the whole provider set (`provideMobilemsCore()`: hydration, zoneless, router,
 HttpClient + the MobilEMS interceptors, NgRx, Masonry, ngx-translate, `SharedModule.forRoot`) and the app
 plumbing (`provideMobilemsApp()`: language, translations fetch, config load, SEO constants, skip links,
-focus). Only `environment` / `EnvironmentService` come from the shared lib (step 7). Museum-specific
+focus). Only `environment` comes from the shared lib (step 5); `EnvironmentService` is a framework export. Museum-specific
 interceptors (e.g. a JWT one) go through `provideMobilemsCore({ interceptors: [...] })`.
 
 ```ts
@@ -21,12 +21,13 @@ import {
 import { provideStoreDevtools } from '@ngrx/store-devtools';
 import {
   ISearchData,
+  EnvironmentService,
   provideMobilemsApp,
   provideMobilemsCore,
   SEARCH_CONFIG_TOKEN,
 } from '@smartsoft001-mobilems/angular';
 
-import { environment, EnvironmentService } from '@<PREFIX>/angular';
+import { environment } from '@<PREFIX>/angular';
 
 import { appRoutes } from './app.routes';
 
@@ -42,7 +43,7 @@ export const appConfig: ApplicationConfig = {
       },
     }),
     provideMobilemsApp({
-      version: environment.version,
+      environment, // provides MOBILEMS_ENVIRONMENT; `version` defaults to environment.version
       languages: { available: ['pl', 'en'], default: 'pl' },
       skipLinks: {
         home: [

package/plugins/mobilems/skills/mobilems-project-init/references/server-env.md

@@ -1,30 +1,44 @@
 # Runtime env delta — multimediaUrl + framework entry files
 
 The base shipped `environment.{ts,prod.ts}`, `EnvironmentService`, a `server.ts` with `/env.js`, and
-the SSRF allowed-hosts list — all keyed on `API_URL` / `SITE_URL` / `APP_VERSION` only. MobilEMS adds
-a **`multimediaUrl`** key (media/CDN host), and replaces the three entry files (`main.ts`,
+the SSRF allowed-hosts list — all keyed on `API_URL` / `SITE_URL` / `APP_VERSION` only. MobilEMS swaps
+the environment for the framework one (which adds the **`multimediaUrl`** media/CDN key), and replaces the three entry files (`main.ts`,
 `main.server.ts`, `server.ts`) with thin wrappers over the framework entry points (section 3).
 
-## 1. `libs/shared/angular/src/lib/environments/environment.ts` + `environment.prod.ts`
+## 1. `libs/shared/angular/src/lib/environments/environment.ts` — `createMobilemsEnvironment`
 
-Add the `multimediaUrl` field to **both** files, mirroring the existing keys:
+Replace the base `environment.ts` with the framework factory and **delete `environment.prod.ts`** plus
+its `fileReplacements` entry in `apps/web/project.json` (`production` is `!isDevMode()`):
 
 ```ts
-  multimediaUrl:
-    typeof window !== 'undefined' && (window as any)['env']
-      ? (window as any)['env']['multimediaUrl']
-      : process.env['MULTIMEDIA_URL'],
+import { createMobilemsEnvironment } from '@smartsoft001-mobilems/angular';
+
+/** Runtime config: `window.env` in the browser, `process.env` on the server. */
+export const environment = createMobilemsEnvironment();
 ```
 
-(Append after `siteUrl`. In reference mode the copied shared lib already carries this — verify it's
-present rather than duplicating.)
+It carries `production`, `version` (`APP_VERSION`, then `VERSION`), `apiUrl`, `siteUrl`,
+`multimediaUrl` and `useLocalTranslations` — the same keys `/env.js` serves. A museum-specific key goes
+in the type argument and the definition map, e.g.
+`createMobilemsEnvironment<{ gtmId: string }>({ gtmId: { env: 'GTM_ID' } })` (mirror it in
+`createMobilemsServer({ env })`, section 3c).
+
+## 2. `EnvironmentService` — from the framework
 
-## 2. `EnvironmentService` (shared lib)
+Delete the base `EnvironmentService` from the shared lib and import it from
+`@smartsoft001-mobilems/angular`. `apps/web/src/env-init.ts` becomes:
+
+```ts
+import { EnvironmentService } from '@smartsoft001-mobilems/angular';
+
+import { environment } from '@<PREFIX>/angular';
+
+EnvironmentService.initFromProcessEnv(environment);
+```
 
-In `EnvironmentService.initFromProcessEnv()` and `init()`, propagate `multimediaUrl` alongside
-`apiUrl`/`siteUrl`/`version` (set from `process.env['MULTIMEDIA_URL']` on the server; copy from the
-transfer-state / `window.env` on the client). In reference mode this comes with the copied service —
-just confirm it.
+`provideMobilemsApp({ environment, … })` provides `MOBILEMS_ENVIRONMENT`, which `init()` (the app
+initializer in `app.config.ts`) and the framework services read. The shared lib keeps exporting only
+`environment`.
 
 ## 3. Entry files — replace the base versions with the framework ones
 

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

@@ -10,8 +10,8 @@ Filter components are **not** on that list. Each module builds its own by extend
 `FiltersBaseComponent<T>` (see `SKILL.md` → "Framework first"); the shared lib holds no filter
 implementation to copy.
 
-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**.
+The library starts as the base shell that exports only `environment` (built with the framework's
+`createMobilemsEnvironment`, see `server-env.md`) with empty `lib/` placeholder dirs — fill those dirs with the **foundation shared components**.
 
 ## Foundation shared components vs feature shared components
 
@@ -29,8 +29,8 @@ The shared library contains two kinds of shared component, separated by a simple
 
 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.
+**foundation** shared components — they take `IObject` / `IArticleListItem` / `IPartner` from
+`@smartsoft001-mobilems/angular` and never import a feature package, so build them here.
 
 ## Identify the foundation set
 
@@ -74,22 +74,22 @@ Build it registering only the **foundation widgets** — `text`, `image`, `video
 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
+## Models — framework, not the lib
 
-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 museum API models (`IObject`, `IImage`, `IDictionary`, `IDictionaryEntry`, `IArticleListItem`,
+`IAuthorDetails`, `IPartner`, …, `IHomePage`, `PARENT_TITLE_TOKEN`) come from
+`@smartsoft001-mobilems/angular`; the objects filter models (`SortType`, `IKeyValue`,
+`AdvancedFilterType`, `FormFeatureType`, `FileType`, `MULTIMEDIA_DICTIONARY`, `ISpecificObject`,
+`IModel3DObject`, `IAnimationObject`) from `@smartsoft001-mobilems/objects-shell-angular`. Do **not**
+create `models/data.interface.ts`, `models/home-page.interface.ts` or `models/objects.model.ts`.
+Reference repos still carry them under the old names `IDictionaryItem`, `IArticle`, `IAuthor` — use
+the framework names.
 
 ## 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.
+Build the app-only `services/`, `pipes/`, `tools/`, `models/`, 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.
 
 **Build each of these ONCE here — module skills reuse them and must never re-create a local copy.**
 Check the framework catalog (`node_modules/@smartsoft001-mobilems/angular/README.md`, in-repo
@@ -99,30 +99,32 @@ first: if the framework already exports it — `MasonryGridComponent` and `Filte
 `SearchService`, `WcagService`, `ContrastService`, `StyleService`, `ModalService`,
 `ClickOutsideDirective`, `HoverDirective`, `ScrollableDirective`, … — import it instead of copying
 the reference's version. The reference repo predates parts of the framework, so several of its shared
-components duplicate exports that now exist; copying those is the single most common defect in this
-step. The app-level set the framework does **not** provide, and that the module skills expect to find
-here:
+files duplicate exports that now exist; copying those is the single most common defect in this step.
 
-| Kind         | Expected members                                                                                                  |
-| ------------ | ----------------------------------------------------------------------------------------------------------------- |
-| pipes        | `altText`, `fileUrl`, `truncateHtml` (`capitalize` is a framework pipe)                                           |
-| tools        | `isInternalLink`, `normalizeUrl`, `stripHtml` (+ the shared `tools.ts` helpers)                                   |
-| directives   | `externalLink`                                                                                                    |
-| interceptors | none — `LanguageInterceptor`, `PreviewAuthInterceptor`, `SsrTimeoutInterceptor`, `DedupeRequestInterceptor` are framework classes |
-| services     | `filter-persistence`, `orientation`, `confirmation-modal`, `contact`, `data`, `environment`, `wcag` (`museum-seo` is the framework `MuseumSeoService`) |
+Framework now — do **not** generate (import from `@smartsoft001-mobilems/angular`):
 
-`local-storage`, `configs-cache`, `museum-seo`, `not-found-content`, the interceptors and `decode-html-entities` are gone: language lives in the framework `TranslationService`
-(`setLanguage()` for the header switcher, `currentLanguage` for `museum-seo`), the config cache in
-`ConfigsFacade.init()`.
+| Kind         | Framework exports                                                                                                  |
+| ------------ | ------------------------------------------------------------------------------------------------------------------ |
+| environment  | `createMobilemsEnvironment`, `MOBILEMS_ENVIRONMENT`, `EnvironmentService`                                           |
+| pipes        | `altText`, `fileUrl`, `backgroundUrl`, `plainText`, `stripAnchors`, `capitalize`                                   |
+| tools        | `classifyLink`, `isInternalLink`, `normalizeUrl`, `stripHtml`, `formatNamedEntries`, `normalizeSearchText`, `newTabText`, `pageToOffset`, `decodeHtmlEntities` |
+| directives   | `a[smartExternalLink]`, `[smartExternalLinks]`, `[smartFocusTrap]`, `[smartTruncatedTitle]` (references use `app…` — rename the attributes) |
+| services     | `ConfirmationModalService`, `ExternalLinkConfirmationService`, `FilterPersistenceService`, `OrientationService`, `WcagChangesService`, `ContactService`, `DataService`, `MuseumSeoService` |
+| interceptors | `LanguageInterceptor`, `PreviewAuthInterceptor`, `SsrTimeoutInterceptor`, `DedupeRequestInterceptor`              |
 
-Adjust to what the reference actually ships, but keep the rule: one implementation, in this lib,
-exported from the barrel, documented in the app's own README so the module skills can find it.
+What stays in the app lib: the confirmation-modal **component** (markup; it reads
+`ConfirmationModalService`), `truncateHtml`, the `line-height` service of the WCAG panel and any
+museum-only tools. `local-storage`, `configs-cache`, `not-found-content` are gone: language lives in
+the framework `TranslationService`, the config cache in `ConfigsFacade.init()`.
+
+Adjust to what the reference actually ships, but keep the rule: one implementation, exported from the
+barrel, documented in the app's own README so the module skills can find it.
 
 ## 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`.
+  `./lib/configs.module`, `./lib/models`, `./lib/pipes`, `./lib/tools`, `./lib/environments` (only
+  the folders that still have files).
 - `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.
@@ -147,8 +149,8 @@ grep -rlnE "from '@[^']*/(objects|articles|public-collections)-(domain|shell-ang
   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.
+`verify-init.sh` runs it, plus checks the `widget` container imports no gallery-object/article and that
+no local copy of a framework model/service exists.
 
 ## project.json / build config
 

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

@@ -25,7 +25,10 @@ grep -q "@smartsoft001-mobilems/angular" package.json && pass "mobilems framewor
 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" libs/shared/angular/src/lib/environments/environment.ts && pass "multimediaUrl in environment.ts" || bad "multimediaUrl in libs/shared/angular/src/lib/environments/environment.ts"
+ENVF=libs/shared/angular/src/lib/environments/environment.ts
+grep -q "createMobilemsEnvironment" "$ENVF" && pass "environment.ts uses createMobilemsEnvironment" || bad "$ENVF must export createMobilemsEnvironment(...) (references/server-env.md §1)"
+[ ! -f libs/shared/angular/src/lib/environments/environment.prod.ts ] && pass "no environment.prod.ts" || bad "delete environment.prod.ts and its fileReplacements (production = !isDevMode())"
+grep -q "initFromProcessEnv(environment)" apps/web/src/env-init.ts && pass "env-init passes environment to EnvironmentService" || bad "apps/web/src/env-init.ts must call EnvironmentService.initFromProcessEnv(environment)"
 # the three entry files are thin wrappers over the framework entry points (references/server-env.md §3)
 grep -q "@smartsoft001-mobilems/angular/bootstrap'" apps/web/src/main.ts && pass "main.ts uses bootstrapApplication from @smartsoft001-mobilems/angular/bootstrap" || bad "main.ts must import bootstrapApplication from @smartsoft001-mobilems/angular/bootstrap (registers masonry on window)"
 grep -q "@smartsoft001-mobilems/angular/bootstrap/server" apps/web/src/main.server.ts && pass "main.server.ts uses bootstrapServerApplication" || bad "main.server.ts must import bootstrapServerApplication from @smartsoft001-mobilems/angular/bootstrap/server"
@@ -102,12 +105,18 @@ if [ -f "$WID" ]; then
 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
+# models, common pipes/directives/services are framework exports — no local copies (references/shared-lib.md)
+LIB=libs/shared/angular/src/lib
+for f in objects.model.ts data.interface.ts home-page.interface.ts environment.service.ts \
+  data.service.ts confirmation-modal.service.ts external-link-confirmation.service.ts \
+  filter-persistence.service.ts orientation.service.ts contact.service.ts \
+  external-link.directive.ts external-links.directive.ts focus-trap.directive.ts \
+  alt-text.pipe.ts file-url.pipe.ts; do
+  # flat (services/x.ts) or foldered (services/x/x.ts) — any location in the lib
+  dup=$(find "$LIB" -name "$f" -not -name '*.spec.ts' 2>/dev/null | head -1)
+  [ -n "$dup" ] && bad "$dup duplicates a framework export — import it from @smartsoft001-mobilems/*" || true
+done
+pass "no local copies of framework models/services checked"
 
 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)"