@smartsoft001-mobilems/claude-plugins 2.86.0 → 2.88.0

package/plugins/mobilems/skills/mobilems-object-collections/references/module-and-routes.md

@@ -0,0 +1,116 @@
+# MuseumCollectionsModule + route registration
+
+## `libs/museum-collections/shell/angular/src/lib/collections.module.ts`
+
+Thread `<PREFIX>` (the `environment` + domain imports). `PublicCollectionsSharedModule.forFeature`
+provides the list/detail behaviour over `MuseumCollection`; `CollectionsService` is provided as the
+`CrudService`; the `Masonry` factory returns the real library in the browser and a no-op mock during
+SSR. Note: unlike the objects module this one does NOT import `SmartSharedModule`.
+
+```ts
+import { NgModule } from '@angular/core';
+import { FormsModule } from '@angular/forms';
+import { RouterModule } from '@angular/router';
+import { CrudService } from '@smartsoft001/crud-shell-angular';
+import { PublicCollectionsSharedModule } from '@smartsoft001-mobilems/public-collections-shell-angular';
+import { Masonry } from '@thisissoon/angular-masonry';
+
+import { environment } from '@<PREFIX>/angular';
+import { MuseumCollection } from '@<PREFIX>/museum-collections/domain';
+
+import { routes } from './collections.routes';
+import { CollectionsService } from './services';
+
+@NgModule({
+  providers: [
+    CollectionsService,
+    {
+      provide: CrudService,
+      useClass: CollectionsService,
+    },
+    {
+      provide: Masonry,
+      useFactory: () => {
+        if (typeof window !== 'undefined' && (window as any)['Masonry']) {
+          return (window as any)['Masonry'];
+        }
+        // Return a mock for SSR
+        return class {
+          constructor() {
+            // no-op
+          }
+          layout() {
+            return;
+          }
+          reloadItems() {
+            return;
+          }
+          destroy() {
+            return;
+          }
+        };
+      },
+    },
+  ],
+  imports: [
+    FormsModule,
+    PublicCollectionsSharedModule.forFeature({
+      routing: false,
+      config: {
+        type: MuseumCollection,
+        apiUrl: environment.apiUrl,
+        entity: 'publicCollections',
+      },
+    }),
+    RouterModule.forChild(routes),
+  ],
+})
+export class MuseumCollectionsModule {}
+```
+
+## `collections.routes.ts`
+
+Identical shape to the objects routes (`:id/:slug` → Item, `:id` → Item, `''` → List).
+
+```ts
+import { Route } from '@angular/router';
+
+import { ItemComponent, ListComponent } from './pages';
+
+export const routes: Route[] = [
+  { path: ':id/:slug', component: ItemComponent },
+  { path: ':id', component: ItemComponent },
+  { path: '', component: ListComponent },
+];
+```
+
+## Register in `apps/web/src/app/app.routes.ts`
+
+Add the collections route to the `appRoutes` array (idempotently — if a `kolekcje` route already
+exists, skip). Add it as a top-level route, and as a child of the `wyszukaj/:text` search route so
+`/wyszukaj/:text/kolekcje` works.
+
+Top-level — add to `appRoutes`:
+
+```ts
+  {
+    path: 'kolekcje',
+    loadChildren: () =>
+      import('@<PREFIX>/museum-collections/shell/angular').then(
+        (m) => m.MuseumCollectionsModule,
+      ),
+  },
+```
+
+Search child — add to the `children` of the `wyszukaj/:text` route, before the
+`{ path: '', redirectTo: 'obiekty' }` default:
+
+```ts
+          {
+            path: 'kolekcje',
+            loadChildren: () =>
+              import('@<PREFIX>/museum-collections/shell/angular').then(
+                (m) => m.MuseumCollectionsModule,
+              ),
+          },
+```

package/plugins/mobilems/skills/mobilems-object-collections/references/shared-components.md

@@ -0,0 +1,61 @@
+# Collections shared components
+
+The collections module contributes one shared component to `libs/shared/angular` — the part of the
+shared UI that renders a museum collection and therefore depends on
+`@smartsoft001-mobilems/public-collections-domain`. Build it by copying from the reference repo's
+`libs/shared/angular/src/lib` and threading `<PREFIX>`. Every step is idempotent — if the target
+already exists, leave it.
+
+All paths below are under `libs/shared/angular/src/lib`.
+
+## 1. Collection card component
+
+Build this component directory and export it from `components/index.ts`:
+
+| Component                          | Renders                            |
+| ---------------------------------- | ---------------------------------- |
+| `components/collections-grid-item` | a collection card in the grid view |
+
+```ts
+// components/index.ts — this export belongs to the collections module:
+export * from './collections-grid-item';
+```
+
+`collections-grid-item` carries its own `index.ts`
+(`export * from './collections-grid-item.component';`) plus the `.component.ts` + `.component.html`.
+Build the whole dir from the reference and thread `<PREFIX>`.
+
+The build-safety grep over the reference shared lib confirms which components depend on the
+public-collections feature package — it should list only `collections-grid-item`:
+
+```bash
+grep -rlnE "from '@[^']*/(public-collections)-(domain|shell-angular|shell-dtos)'" \
+  <reference-repo>/libs/shared/angular/src
+```
+
+## 2. No widget, no model type
+
+Unlike `mobilems-objects`, collections contributes **nothing** to the widget container
+(`components/widget/widget.component.ts`) and **no** model type to `models/`. There is no
+`GALLERY_COLLECTION` widget type. Do not touch the widget container or the models dir.
+
+## 3. Cross-module dependency — the collection detail page renders related objects + articles
+
+The collection **item/detail page** (`libs/museum-collections/shell/angular/.../pages/item`) shows
+related objects and articles, so it imports the object and article card shared components
+(`ObjectsGridItemComponent`/`ObjectsListItemComponent` and `ArticlesGridItemComponent`/
+`ArticlesListItemComponent`) from `@<PREFIX>/angular`, and uses `MsObject` (objects-domain) /
+`Article` (articles-domain). Those cards are built by `mobilems-objects` / `mobilems-articles`, so the
+collections module is **not** fully standalone — its detail page assumes those modules' card
+components exist.
+
+When you add collections, check which of those cards the copied item page imports and confirm they're
+exported from `components/index.ts`. If a needed card isn't there yet (its module hasn't been added),
+either add that module first, build the missing card component here (it's just an Article/MsObject
+card — copy it from the reference like `collections-grid-item`), or remove the related-content section
+from the item page. Don't leave a dangling import — it will not compile.
+
+## Verify
+
+`scripts/verify-module.sh` checks that the `collections-grid-item` component exists and is exported
+from `components/index.ts`.

package/plugins/mobilems/skills/mobilems-object-collections/scripts/detect-init.sh

@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+#
+# detect-init.sh <workspace-root>
+#
+# Precondition gate for mobilems-objects (and the other module skills follow the same shape):
+# confirm the MobilEMS foundation from mobilems-project-init is present. Portable to macOS bash 3.2.
+#
+# Exit 0 → foundation present, OK to add the module.
+# Exit 3 → foundation missing (tell the user to run /mobilems:project-init first).
+set -eu
+
+ROOT="${1:?usage: detect-init.sh <workspace-root>}"
+cd "$ROOT" 2>/dev/null || { echo "ERROR: no such dir: $ROOT" >&2; exit 2; }
+
+miss() {
+  echo "FOUNDATION MISSING: $1" >&2
+  echo "Run /mobilems:project-init first to lay down the MobilEMS foundation." >&2
+  exit 3
+}
+
+[ -f apps/web/src/app/app.config.ts ] || miss "app.config.ts missing"
+grep -q "SharedModule.forRoot" apps/web/src/app/app.config.ts || miss "SharedModule.forRoot not in app.config.ts (foundation not applied)"
+grep -q "./lib/components" libs/shared/angular/src/index.ts 2>/dev/null || miss "shared-lib components barrel not populated"
+[ -f apps/web/src/app/app.routes.ts ] || miss "app.routes.ts missing"
+
+PREFIX="$(grep -oE '@[a-z0-9-]+/angular' tsconfig.base.json | head -1 | sed -E 's#@([a-z0-9-]+)/angular#\1#')"
+echo "FOUNDATION OK. Detected prefix: ${PREFIX:-<unknown>}"
+[ -d libs/museum-objects ] && echo "NOTE: libs/museum-objects already exists — build steps must be idempotent." >&2
+exit 0

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

@@ -0,0 +1,44 @@
+#!/usr/bin/env bash
+#
+# verify-module.sh <workspace-root> <PREFIX>
+#
+# Post-condition check for mobilems-object-collections: library created, route registered (top-level
+# + search child), the collections shared component built + exported, public-collections deps present.
+# macOS bash 3.2 safe.
+set -eu
+
+ROOT="${1:?usage: verify-module.sh <workspace-root> <PREFIX>}"
+PREFIX="${2:?usage: verify-module.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 "== Library =="
+[ -f libs/museum-collections/shell/angular/src/lib/collections.module.ts ] && pass "MuseumCollectionsModule present" || bad "collections.module.ts missing"
+[ -f libs/museum-collections/domain/src/lib/entities/museum-collection.entity.ts ] && pass "MuseumCollection entity present" || bad "domain entity missing"
+grep -q "MuseumCollection" libs/museum-collections/domain/src/lib/entities/museum-collection.entity.ts 2>/dev/null && pass "MuseumCollection class declared" || bad "MuseumCollection class missing"
+grep -q "museum-collections/shell/angular" tsconfig.base.json && pass "tsconfig path added" || bad "tsconfig.base.json path missing"
+grep -q "PublicCollectionsSharedModule.forFeature" libs/museum-collections/shell/angular/src/lib/collections.module.ts 2>/dev/null && pass "forFeature wired" || bad "PublicCollectionsSharedModule.forFeature missing"
+
+echo "== Route registration =="
+ROUTES=apps/web/src/app/app.routes.ts
+grep -q "museum-collections/shell/angular" "$ROUTES" && pass "collections route registered" || bad "collections route not in app.routes.ts"
+# top-level + search child — expect at least 2 occurrences
+n=$(grep -c "museum-collections/shell/angular" "$ROUTES" || true)
+[ "${n:-0}" -ge 2 ] && pass "registered top-level + search child ($n)" || bad "expected route top-level + search child, found $n"
+
+echo "== Collections shared components =="
+COMP=libs/shared/angular/src/lib/components
+[ -d "$COMP/collections-grid-item" ] && pass "built collections-grid-item" || bad "missing $COMP/collections-grid-item"
+grep -q "collections-grid-item" "$COMP/index.ts" && pass "collections-grid-item exported" || bad "collections-grid-item export missing"
+
+echo "== Deps =="
+grep -q "@smartsoft001-mobilems/public-collections-domain" package.json && pass "public-collections-domain dep" || bad "public-collections-domain dep missing"
+grep -q "@smartsoft001-mobilems/public-collections-shell-angular" package.json && pass "public-collections-shell-angular dep" || bad "public-collections-shell-angular dep missing"
+grep -q "@smartsoft001-mobilems/public-collections-shell-dtos" package.json && pass "public-collections-shell-dtos dep" || bad "public-collections-shell-dtos dep missing"
+
+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

@@ -0,0 +1,80 @@
+---
+name: mobilems-objects
+description: Add the museum OBJECTS feature module to a MobilEMS app initialized with mobilems-project-init. Use whenever the user wants to add / scaffold / wire the objects (obiekty) module, museum object list + detail pages, object tabs (images, map, audio, 3D, animation, virtual walk), or asks to "dodaj moduł obiektów / eksponatów". Creates libs/museum-objects (domain + shell/angular), registers the /obiekty route, builds the objects shared components, and adds the objects npm packages. Requires the MobilEMS foundation to exist first.
+user-invocable: true
+allowed-tools: Bash, Read, Write, Edit, Glob, Grep, AskUserQuestion
+---
+
+# MobilEMS objects module
+
+Add the **objects** (obiekty) feature module to a MobilEMS app whose foundation was built by
+`mobilems-project-init`. This skill builds the `libs/museum-objects` library, the objects shared
+components, the objects route, and adds the objects npm packages.
+
+Objects is the richest module — a list/detail view with a tabbed detail (images deep-zoom, Leaflet
+map, audio, 3D model, animation, virtual walk) backed by `ObjectsSharedModule.forFeature` over the
+`MsObject` entity.
+
+## 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/objects-domain`, `@smartsoft001-mobilems/objects-shell-angular`,
+   `@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.
+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
+   `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`.
+5. **Verify** — run `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.
+
+## Known QA pitfalls (from live deployments — fix while copying, not after)
+
+Each of these was a real Linear bug on a museum project built with this skill (Ostrowiec MOB-960/991,
+Tomaszów MOB-949/993). The cross-cutting rules live in `mobilems-project-init`
+`references/qa-hardening.md`; these are the objects-specific ones:
+
+- **Search debounce.** The panel full-text search (`app-objects-searchbar variant="panel"`) must
+  re-emit through a handler with `@debounce(250)` (`lodash-decorators`) — without it every keystroke
+  hits the API. Collections and news filters already do this; keep the modules consistent.
+- **List page:** show the total result count (`facade.totalCount()`) and add the shared
+  `NextPageComponent` at the bottom (same `selectedPage`/`lastPageIndex` pattern as the news list).
+- **Map tab coordinates.** Read coordinates through ONE helper (`getObjectCoordinates()`) used by
+  both the tab-visibility predicate and the map render: `archeoMap.latitude/longitude` first, then
+  fall back to the first valid `createPlaces[]` entry; accept **both `lon` and `long`** (upstream
+  `MsObjectPlace` says `long`, the real API sends `lon`); validate with `Number.isFinite` (lat `0`
+  is valid; `Number('') === 0` — reject empty strings explicitly). Duplicating the predicate in two
+  components caused a "map never renders" bug.
+- **Field labels match the client's field spec everywhere** — list card, detail and filters must use
+  the same names (QA rejected "Materiał" vs "Tworzywo", "Miejsca:" vs "Miejsce powstania").
+- **Keywords section** maps the API `tags[]` field (not `keywords[]`) and renders clickable links
+  that filter the list.
+- **Warning-clean templates:** after copying, remove needless `?.` on non-nullable signals (NG8107)
+  and drop unused entries from `imports: []` (NG8113 — the tab container often imports
+  Model3d/Map/VirtualWalk tabs its template no longer references). Masonry grid items must not set
+  `width` after change detection (NG0100).
+- **A11y:** exactly one `h1` (detail = object title); cards exposed as `role="link"` must activate
+  on Enter/Space; focused/hovered cards change label colours together with the rest of the content.
+
+## Notes
+
+- This skill builds only the objects module + its shared components + its route. It never adds other
+  feature modules and never re-runs the foundation.
+- Bundled `references/` + `scripts/` ship automatically. Do not hand-edit `plugin.json`.

package/plugins/mobilems/skills/mobilems-objects/references/lib-contents.md

@@ -0,0 +1,68 @@
+# libs/museum-objects — structure to create
+
+Copy from the reference repo's `libs/museum-objects` and thread `<PREFIX>`. The lib has two
+projects: a `domain` (entities/enums) and a `shell/angular` (the Angular module + UI).
+
+```
+libs/museum-objects/
+├── domain/                              # project: museum-objects-domain
+│   └── src/
+│       ├── index.ts                     # export * from './lib/entities'; export * from './lib/enums';
+│       └── lib/
+│           ├── entities/                # MuseumObject extends MsObject (+ index)
+│           ├── enums/                   # connection-type.enum (+ index)
+│           ├── specifications/
+│           └── value-objects/
+└── shell/angular/                       # project: museum-objects-shell-angular
+    └── src/
+        ├── index.ts                     # export * from './pages'; export * from './objects.module';
+        ├── __mocks__/                   # jest mocks for the @smartsoft001-mobilems/* feature pkgs
+        └── lib/
+            ├── objects.module.ts        # MuseumObjectsModule (references/module-and-routes.md)
+            ├── objects.routes.ts
+            ├── components/              # description, filter-input, high-def-request-modal,
+            │                            #   menu, objects-searchbar, tabs/*
+            ├── pages/                   # list (ListComponent), item (ItemComponent) + index
+            └── services/               # objects.service.ts + index
+```
+
+## Domain entity (verbatim, thread nothing — pure types)
+
+```ts
+import { Field, Model } from '@smartsoft001/models';
+import { MsObject } from '@smartsoft001-mobilems/objects-domain';
+
+@Model({})
+export class MuseumObject extends MsObject {
+  historicalProvenance?: any;
+  seriesTitles?: any;
+  imageDesktop?: any;
+  virtualExhibitionSlides?: any;
+  shareMuseumObjectMultimediaEnabled!: boolean;
+}
+```
+
+## Wiring
+
+- **tsconfig.base.json paths** (add both):
+  ```json
+  "@<PREFIX>/museum-objects/domain": ["libs/museum-objects/domain/src/index.ts"],
+  "@<PREFIX>/museum-objects/shell/angular": ["libs/museum-objects/shell/angular/src/index.ts"]
+  ```
+- **project.json / build config** — copy each project's build config and normalize every path field
+  that the reference baked to its origin location — `sourceRoot`, `dest`, `outputPath`,
+  `coverageDirectory`, `jestConfig`, `lintFilePatterns`, and the jest `displayName` — to `libs/museum-objects/...`. Some
+  reference modules carry stale values here (e.g. a shell `sourceRoot` missing the `shell/angular`
+  segment, or a `coverageDirectory` under `packages/...`) while others are already correct — verify
+  each field against a known-good sibling lib and fix only the ones that are actually wrong. The
+  `domain` project may ship no `project.json` at all (Nx infers its targets from `package.json` +
+  `jest.config`) — that's fine, leave it inferred; just set its `package.json` `name` to
+  `museum-objects-domain`.
+- **commit scope** — `commitlint.config.js` reads `libs/` dir names, so `museum-objects` becomes a
+  valid scope automatically; no edit needed.
+- **jest `__mocks__`** — keep the `src/__mocks__/@smartsoft001-mobilems/*` stubs from the reference;
+  they let the shell unit-test without the real feature packages.
+
+The tabs (`tabs/*`) include the 3D model tab, which uses `online-3d-viewer` — that's why this skill
+adds that dep. The map tab uses `leaflet`, images use `openseadragon`/`swiper` — already foundation
+deps.

package/plugins/mobilems/skills/mobilems-objects/references/module-and-routes.md

@@ -0,0 +1,108 @@
+# MuseumObjectsModule + route registration
+
+## `libs/museum-objects/shell/angular/src/lib/objects.module.ts`
+
+Thread `<PREFIX>` (the `environment` import). `ObjectsSharedModule.forFeature` provides the list/detail
+behaviour over `MsObject`; the `Masonry` factory returns the real library in the browser and a no-op
+mock during SSR.
+
+```ts
+import { NgModule } from '@angular/core';
+import { FormsModule } from '@angular/forms';
+import { RouterModule } from '@angular/router';
+import { SharedModule as SmartSharedModule } from '@smartsoft001/angular';
+import { MsObject } from '@smartsoft001-mobilems/objects-domain';
+import { ObjectsSharedModule } from '@smartsoft001-mobilems/objects-shell-angular';
+import { Masonry } from '@thisissoon/angular-masonry';
+
+import { environment } from '@<PREFIX>/angular';
+
+import { routes } from './objects.routes';
+
+@NgModule({
+  providers: [
+    {
+      provide: Masonry,
+      useFactory: () => {
+        if (typeof window !== 'undefined' && (window as any)['Masonry']) {
+          return (window as any)['Masonry'];
+        }
+        // Return a mock for SSR
+        return class {
+          constructor() {
+            // no-op
+          }
+          layout() {
+            return;
+          }
+          reloadItems() {
+            return;
+          }
+          destroy() {
+            return;
+          }
+        };
+      },
+    },
+  ],
+  imports: [
+    FormsModule,
+    SmartSharedModule,
+    ObjectsSharedModule.forFeature({
+      routing: false,
+      config: {
+        type: MsObject,
+        apiUrl: environment.apiUrl,
+        entity: 'objects',
+      },
+    }),
+    RouterModule.forChild(routes),
+  ],
+})
+export class MuseumObjectsModule {}
+```
+
+## `objects.routes.ts`
+
+```ts
+import { Route } from '@angular/router';
+
+import { ItemComponent, ListComponent } from './pages';
+
+export const routes: Route[] = [
+  { path: ':id/:slug', component: ItemComponent },
+  { path: ':id', component: ItemComponent },
+  { path: '', component: ListComponent },
+];
+```
+
+## Register in `apps/web/src/app/app.routes.ts`
+
+Add the objects route to the `appRoutes` array (idempotently — if an `obiekty` route already exists,
+skip). Add it as a top-level route, and as a child of the `wyszukaj/:text` search route so
+`/wyszukaj/:text/obiekty` works and the search view's `redirectTo: 'obiekty'` default resolves.
+
+Top-level — add to `appRoutes`:
+
+```ts
+  {
+    path: 'obiekty',
+    loadChildren: () =>
+      import('@<PREFIX>/museum-objects/shell/angular').then(
+        (m) => m.MuseumObjectsModule,
+      ),
+  },
+```
+
+Search child — add to the `children` of the `wyszukaj/:text` route, before the
+`{ path: '', redirectTo: 'obiekty' }` default:
+
+```ts
+          {
+            path: 'obiekty',
+            loadChildren: () =>
+              import('@<PREFIX>/museum-objects/shell/angular').then(
+                (m) => m.MuseumObjectsModule,
+              ),
+          },
+```

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

@@ -0,0 +1,69 @@
+# Objects shared components
+
+The objects module contributes a few shared components to `libs/shared/angular` — the parts of the
+shared UI that render a museum object and therefore depend on `@smartsoft001-mobilems/objects-domain`.
+Build them by copying from the reference repo's `libs/shared/angular/src/lib` and threading
+`<PREFIX>`. Every step is idempotent — if the target already exists, leave it.
+
+All paths below are under `libs/shared/angular/src/lib`.
+
+## 1. Object card components
+
+Build these component directories and export them from `components/index.ts`:
+
+| Component                      | Renders                         |
+| ------------------------------ | ------------------------------- |
+| `components/objects-grid-item` | an object card in the grid view |
+| `components/objects-list-item` | an object row in the list view  |
+
+```ts
+// components/index.ts — these exports belong to the objects module:
+export * from './objects-grid-item';
+export * from './objects-list-item';
+```
+
+## 2. Object gallery widget
+
+Build `components/widget/gallery-object` and export it from the widget barrel:
+
+```ts
+// components/widget/index.ts:
+export * from './gallery-object/widget-gallery-object.component';
+```
+
+Register it in the widget content-type map in `components/widget/widget.component.ts` so the page
+renderer can render `GALLERY_OBJECT` content blocks:
+
+```ts
+import { WidgetGalleryObjectComponent } from './gallery-object/widget-gallery-object.component';
+// …in the ArticleWidgetType → component map:
+[ArticleWidgetType.GALLERY_OBJECT]: WidgetGalleryObjectComponent,
+```
+
+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
+
+`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.
+
+## 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`.

package/plugins/mobilems/skills/mobilems-objects/scripts/detect-init.sh

@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+#
+# detect-init.sh <workspace-root>
+#
+# Precondition gate for mobilems-objects (and the other module skills follow the same shape):
+# confirm the MobilEMS foundation from mobilems-project-init is present. Portable to macOS bash 3.2.
+#
+# Exit 0 → foundation present, OK to add the module.
+# Exit 3 → foundation missing (tell the user to run /mobilems:project-init first).
+set -eu
+
+ROOT="${1:?usage: detect-init.sh <workspace-root>}"
+cd "$ROOT" 2>/dev/null || { echo "ERROR: no such dir: $ROOT" >&2; exit 2; }
+
+miss() {
+  echo "FOUNDATION MISSING: $1" >&2
+  echo "Run /mobilems:project-init first to lay down the MobilEMS foundation." >&2
+  exit 3
+}
+
+[ -f apps/web/src/app/app.config.ts ] || miss "app.config.ts missing"
+grep -q "SharedModule.forRoot" apps/web/src/app/app.config.ts || miss "SharedModule.forRoot not in app.config.ts (foundation not applied)"
+grep -q "./lib/components" libs/shared/angular/src/index.ts 2>/dev/null || miss "shared-lib components barrel not populated"
+[ -f apps/web/src/app/app.routes.ts ] || miss "app.routes.ts missing"
+
+PREFIX="$(grep -oE '@[a-z0-9-]+/angular' tsconfig.base.json | head -1 | sed -E 's#@([a-z0-9-]+)/angular#\1#')"
+echo "FOUNDATION OK. Detected prefix: ${PREFIX:-<unknown>}"
+[ -d libs/museum-objects ] && echo "NOTE: libs/museum-objects already exists — build steps must be idempotent." >&2
+exit 0

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

@@ -0,0 +1,51 @@
+#!/usr/bin/env bash
+#
+# 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.
+set -eu
+
+ROOT="${1:?usage: verify-module.sh <workspace-root> <PREFIX>}"
+PREFIX="${2:?usage: verify-module.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 "== Library =="
+[ -f libs/museum-objects/shell/angular/src/lib/objects.module.ts ] && pass "MuseumObjectsModule present" || bad "objects.module.ts missing"
+[ -f libs/museum-objects/domain/src/lib/entities/museum-object.entity.ts ] && pass "MuseumObject entity present" || bad "domain entity missing"
+grep -q "museum-objects/shell/angular" tsconfig.base.json && pass "tsconfig path added" || bad "tsconfig.base.json path missing"
+grep -q "ObjectsSharedModule.forFeature" libs/museum-objects/shell/angular/src/lib/objects.module.ts 2>/dev/null && pass "forFeature wired" || bad "ObjectsSharedModule.forFeature missing"
+
+echo "== Route registration =="
+ROUTES=apps/web/src/app/app.routes.ts
+grep -q "museum-objects/shell/angular" "$ROUTES" && pass "objects route registered" || bad "objects route not in app.routes.ts"
+# top-level + search child — expect at least 2 occurrences
+n=$(grep -c "museum-objects/shell/angular" "$ROUTES" || true)
+[ "${n:-0}" -ge 2 ] && pass "registered top-level + search child ($n)" || bad "expected route top-level + search child, found $n"
+
+echo "== Objects shared components =="
+COMP=libs/shared/angular/src/lib/components
+for d in objects-grid-item objects-list-item widget/gallery-object; do
+  [ -d "$COMP/$d" ] && pass "built $d" || bad "missing $COMP/$d"
+done
+grep -q "objects-grid-item" "$COMP/index.ts" && pass "objects-grid-item exported" || bad "objects-grid-item export missing"
+grep -q "gallery-object" "$COMP/widget/index.ts" && pass "gallery-object exported" || bad "gallery-object export missing"
+
+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"
+
+echo "== Deps =="
+grep -q "@smartsoft001-mobilems/objects-domain" package.json && pass "objects-domain dep" || bad "objects-domain dep missing"
+grep -q "online-3d-viewer" package.json && pass "online-3d-viewer dep" || bad "online-3d-viewer dep missing"
+
+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"