@aryacode/dsh-engineering 0.8.3 → 0.9.0

package/CHANGELOG.md

@@ -1,5 +1,48 @@
 # Changelog
 
+## [0.9.0] - 2026-10-27
+
+### Added
+
+- **Model-agnostic engineering resources: a local standards corpus.** 34 authored pages across six domains
+  (IEC 61131-3, Rockwell, Yaskawa, FactoryTalk View/HMI, Optix, craft) with front-matter provenance and 100+
+  rule IDs (`CRAFT-NAME-01`, `VIEW-HPM-02`, …). `engineering_reference` lists the contents, ranks pages for a
+  query and returns one page with its rules; search is deterministic and needs no network, embedding model or
+  tokenizer. `scripts/gen-resources.mjs` validates every page (fields, domains, id/file agreement, rule
+  uniqueness, size and word budgets) and generates `index.json`/`SOURCE.json`; `pnpm resources:check` fails on
+  a stale index.
+- **House-style profiles.** `engineering_profile` reads the conventions of the open project — L5X tag prefixes
+  and case, seal-in and latch forms, comment density; FactoryTalk View palette, fonts, button geometry,
+  navigation and popups — with counts, evidence and a `low`/`medium`/`high` confidence. A profile is evidence,
+  not authority, and the tool says which project and SHA-256 it came from.
+- **Generation follows the profile.** `ftview_draft_display_create` applies the profile's background colour and
+  `ftview_draft_object_add` its button geometry and font when the caller omits them, reporting
+  `profile_applied`.
+- **New `resources` row and the `engineering-standards` skill.** The row mounts the two tools and the skill
+  that tells a model to read the relevant page and the project profile before authoring. Tools 97 → 99, rows
+  5 → 6.
+- `docs/resources.md` documents the corpus, its provenance, the index commands and the profile schema.
+
+### Known limits
+
+- `engineering_review` (rule-based draft review) and MWI/Optix profile extraction are planned for 0.9.1; the
+  corpus already applies to those products and the product validation still judges the result.
+## [0.8.4] - 2026-10-27
+
+### Added
+
+- **`ftview_export` now brings the alarm setup and the tag database.** The vendor export server covers
+  displays, global objects and project settings; alarms and tags live beside the application in the
+  Studio project store and were missing from a "full" export, so tag bindings had nothing to check
+  against. The export now copies `Alarms/Alarms.xml` and `Tags/<application>.csv` into the export in the
+  same layout Studio uses, and reports a warning for each when the stored snapshot is older than the
+  application database (on the commissioning application both were dated 2026-09-29 against a database
+  modified 2026-10-27).
+
+### Documentation
+
+- FTView skill, getting-started and the handbook now describe the alarms/tags copy and its staleness
+  warning instead of "the vendor export carries no tag CSV".
 ## [0.8.3] - 2026-10-27
 
 ### Documentation

package/README.md

@@ -4,7 +4,7 @@
 MotionWorks IEC and FactoryTalk Optix sit behind a single install, one row per surface. A row is the
 switch: disable it and that plugin unloads, so its tool schemas leave the request.
 
-`@aryacode/dsh-engineering` · 97 tools · 5 rows · 4 products · MIT
+`@aryacode/dsh-engineering` · 99 tools · 6 rows · 4 products · MIT
 
 **New here? Start with [Getting started](docs/getting-started.md)** — what each row needs, the loop every
 product follows, and the first prompt to paste for each of the four.
@@ -43,6 +43,7 @@ bundle.
 | **FactoryTalk View ME** | 22 | all on | Node for an export folder; FactoryTalk View Studio ME for discovery and the handoff |
 | **MotionWorks IEC** | 24 | all on | MotionWorks IEC 3 Pro installed; verified against 1.19 |
 | **FactoryTalk Optix** | 10 (3 need preview) | all on | Optix Studio installed; Tesseract for OCR |
+| **Engineering resources** | 2 | all on | none; a profile needs an L5X or FactoryTalk View project open |
 
 Tool groups, by product:
 
@@ -51,6 +52,9 @@ Tool groups, by product:
 - **FactoryTalk View** — 6 read, 5 staged edits, 3 Studio handoff
 - **MotionWorks IEC** — 7 session, 7 saved-project reads, 3 verify, 7 direct edits
 - **Optix** — 10 tools, linked to the `factorytalk-optix` guidance; `optix_netlogic` reads the pinned NetLogic cheat-sheet snapshot, and the 9 bridge tools need Studio
+- **Engineering resources** — 2 tools and the `engineering-standards` skill: `engineering_reference` reads the
+  local 34-page corpus (IEC 61131-3, Rockwell, Yaskawa, HMI, Optix, craft) and `engineering_profile` infers the
+  open project's own naming, idioms and HMI palette, with evidence and a confidence level
 
 ## Switches
 
@@ -65,6 +69,7 @@ down:
 | `ftview` | FactoryTalk View ME read, guidance and edits; optionally the Studio handoff | `edit` (on), `studio` (on) |
 | `mwi` | MotionWorks IEC session, reads, verify, guidance and the edits | `workspace` (empty), `edit` (on) |
 | `viewers` | ladder + ME display previews | — |
+| `resources` | the engineering corpus, the house-style profile and the `engineering-standards` skill; no project of its own | `reference` (on) |
 | `optix` | FactoryTalk Optix Studio authoring and the NetLogic reader | `bridgeUrls` (8768), `bridgeToken` (empty), `allowWrites` (on), `allowDestructive` (on), `allowInvoke` (on), `preview` (on), `allowPreviewInput` (on), `cdpUrl`, `previewUrl`, `ocrExecutable` (empty), `ocrLanguage` (`eng`), `ocrTessdataDirectory` (empty), `netlogic` (on) |
 
 **Why the row list collapsed.** The Plugins page lists a bundle's rows flat and skips `cordis:group`
@@ -238,6 +243,7 @@ even when the implementation behind a row is replaced.
 | Document | Owns |
 |---|---|
 | [Getting started](docs/getting-started.md) | The first session: what each row needs, the shared loop, and a paste-ready prompt per product |
+| [Engineering resources](docs/resources.md) | The 34-page standards corpus, its rule IDs, the generated index, and the house-style profile |
 | [Workflow handbook (PDF)](docs/handbook/Engineering-Handbook.pdf) | The whole surface as a printable handbook with the four workflow diagrams; [editable DOCX](docs/handbook/Engineering-Handbook.docx) and [HTML](docs/handbook/Engineering-Handbook.html) beside it |
 | [Tool reference](docs/reference/tools.md) | Every tool, parameter and description (generated) |
 | [Examples](docs/examples.md) | End-to-end sessions per product |

package/cordis.patch.yml

@@ -38,6 +38,13 @@
     # context, so this row is independent of every product row above.
     - id: viewers
       name: '@aryacode/dsh-engineering'
+    # Cross-product engineering resources: a local standards corpus (IEC 61131-3,
+    # Rockwell, Yaskawa, HMI and craft rules), a house-style profile read from the
+    # open project, and the engineering-standards skill that says to read both
+    # before authoring. Disable it in a lean profile; it adds no product row.
+    - id: resources
+      name: '@aryacode/dsh-engineering/resources'
+
     # FactoryTalk Optix: vendored like the other three products, so one install
     # carries every surface and no component package is a dependency.
     - id: optix

package/entries/resources.js

@@ -0,0 +1,23 @@
+/**
+ * The engineering resources row: the standards corpus, the house-style profile
+ * and the `engineering-standards` skill.
+ *
+ * The corpus and the index are generated data shipped inside the vendored
+ * package; this entry only mounts them. A profile needs a product row to have a
+ * project open, and says so when none is.
+ */
+import * as resources from '../vendor/resources/lib/index.js'
+
+export const name = 'engineering-resources'
+
+/** The tools need the registry; the skill is registered when the host offers it. */
+export const inject = ['tools']
+
+/**
+ * Mount the resources surface.
+ * @param ctx - plugin context.
+ * @param config - `reference` (default true) controls the two read tools.
+ */
+export function apply(ctx, config = {}) {
+  resources.apply(ctx, config)
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aryacode/dsh-engineering",
-  "version": "0.8.3",
+  "version": "0.9.0",
   "description": "AryaCode engineering bundle: one install surface for the Studio 5000 L5X, FactoryTalk View ME, MotionWorks IEC and FactoryTalk Optix surfaces, one row per product, with the ladder and display previews.",
   "keywords": [
     "dsh",
@@ -93,13 +93,16 @@
     "./mwi/read": "./vendor/mwi/lib/read.js",
     "./mwi/skill": "./vendor/mwi/lib/skill.js",
     "./mwi/verify": "./vendor/mwi/lib/verify.js",
-    "./mwi/edit": "./vendor/mwi/lib/edit.js"
+    "./mwi/edit": "./vendor/mwi/lib/edit.js",
+    "./resources": "./entries/resources.js"
   },
   "scripts": {
-    "test": "node --import tsx --test test/patch.spec.mjs test/docs.spec.mjs test/tool-reference.spec.mjs test/manifests.spec.mjs test/client-face.spec.mjs test/config.spec.mjs test/netlogic.spec.mjs",
+    "test": "node --import tsx --test test/patch.spec.mjs test/docs.spec.mjs test/tool-reference.spec.mjs test/manifests.spec.mjs test/client-face.spec.mjs test/config.spec.mjs test/netlogic.spec.mjs test/resources.spec.mjs",
     "docs:tools": "tsx scripts/gen-tool-reference.ts",
     "docs:check": "tsx scripts/gen-tool-reference.ts --check",
     "netlogic:sync": "node scripts/sync-netlogic.mjs",
+    "resources:build": "node scripts/resources.mjs",
+    "resources:check": "node scripts/resources.mjs --check",
     "build:client": "node scripts/build-client.mjs",
     "assemble": "node scripts/assemble.mjs"
   }

package/vendor/ftview/SKILL.md

@@ -77,7 +77,10 @@ Start from the application, not from a folder someone emailed:
 
 1. `ftview_apps` lists the ME applications installed on this host.
 2. `ftview_export` writes one to a NEW folder through the vendor export server. No Studio window is
-   needed and the application is not modified.
+   needed and the application is not modified. It also copies the alarm setup (`Alarms/Alarms.xml`) and
+   the tag CSV (`Tags/<application>.csv`) from the Studio project store, and reports a `warning` for
+   either when the stored file is older than the application database — say so rather than treating
+   those tags or alarms as current.
 3. `ftview_open` that folder, then author against it:
    - `ftview_draft_display_create` for a new display;
    - `ftview_draft_object_add` for one object (`text`, `panel`, `momentaryButton`, `numericDisplay`,

package/vendor/ftview/lib/edit/tools.d.ts

@@ -20,6 +20,6 @@ import type { EditOperation } from './operations.ts';
  * @param maxOperations - Inclusive operations per draft.
  * @returns Tool definitions in registration order.
  */
-export declare function editTools(session: ViewSession, drafts: EditDrafts, fs: FsService, maxOperations: number): readonly ToolDefinition[];
+export declare function editTools(session: ViewSession, drafts: EditDrafts, fs: FsService, maxOperations: number, profileOf?: (id: string) => unknown): readonly ToolDefinition[];
 /** A helper kept for callers that want the operation count type. */
 export type { EditOperation };

package/vendor/ftview/lib/edit/tools.js

@@ -75,13 +75,13 @@ function jsonObject(value, name) {
  * @param maxOperations - Inclusive operations per draft.
  * @returns Tool definitions in registration order.
  */
-export function editTools(session, drafts, fs, maxOperations) {
+export function editTools(session, drafts, fs, maxOperations, profileOf) {
     /** Resolve the view and append one operation. */
     const stage = (exec, viewId, operation) => {
         const view = session.require(viewId, exec);
         return { view, draft: drafts.append(exec, view.id, operation, maxOperations) };
     };
-    const staged = (draft, operation) => success(`Draft ${draft.id}: ${draft.operations.length} ${draft.operations.length === 1 ? 'operation' : 'operations'}.`, { draft_id: draft.id, operation_count: draft.operations.length, last_operation: operation }, nextValidate(draft.id), EDIT_COVERAGE);
+    const staged = (draft, operation, profileId) => success(`Draft ${draft.id}: ${draft.operations.length} ${draft.operations.length === 1 ? 'operation' : 'operations'}.`, { draft_id: draft.id, operation_count: draft.operations.length, last_operation: operation, ...(profileId === undefined ? {} : { profile_applied: profileId }) }, nextValidate(draft.id), EDIT_COVERAGE);
     return [
         tool({
             name: 'ftview_draft_display_set',
@@ -182,6 +182,7 @@ export function editTools(session, drafts, fs, maxOperations) {
                 back_color: string('Optional background colour. Example: "#C6C6C6".'),
                 display_number: integer('Optional display number.', { minimum: 0 }),
                 file: string('Optional export-relative file path. Defaults to "Displays/<name>.xml".'),
+                profile_id: string('Optional house-style profile from engineering_profile; its background colour is used when back_color is absent.'),
             }, ['name', 'width', 'height']),
             async run(args, exec) {
                 const view = session.require(optionalString(args, 'view_id'), exec);
@@ -190,7 +191,9 @@ export function editTools(session, drafts, fs, maxOperations) {
                     throw new EngineeringError('COMPONENT_EXISTS', `A display named ${JSON.stringify(name)} already exists in this export.`, 'Pass a new display name.');
                 }
                 const displayType = optionalString(args, 'display_type');
-                const backColor = optionalString(args, 'back_color');
+                const profileId = optionalString(args, 'profile_id');
+                const profile = profileId === undefined ? undefined : profileOf?.(profileId);
+                const backColor = optionalString(args, 'back_color') ?? profile?.hmi?.palette?.[0]?.value;
                 const displayNumber = optionalInteger(args, 'display_number');
                 const { draft } = stage(exec, optionalString(args, 'view_id'), {
                     kind: 'display_create',
@@ -202,7 +205,7 @@ export function editTools(session, drafts, fs, maxOperations) {
                     ...(backColor === undefined ? {} : { backColor }),
                     ...(displayNumber === undefined ? {} : { displayNumber }),
                 });
-                return staged(draft, draft.operations[draft.operations.length - 1]);
+                return staged(draft, draft.operations[draft.operations.length - 1], profileId);
             },
         }),
         tool({
@@ -218,11 +221,28 @@ export function editTools(session, drafts, fs, maxOperations) {
                 connections_json: string('Optional connections as a JSON object, e.g. {"Value":"SystemRunning"}.'),
                 parent: string('Optional group name to add inside. Omit to add at the display root.'),
                 index: integer('Optional position among siblings, for z-order.', { minimum: 0 }),
+                profile_id: string('Optional house-style profile from engineering_profile; its button geometry and font are used when the attributes omit them.'),
             }, ['display', 'type', 'name']),
             async run(args, exec) {
                 const view = session.require(optionalString(args, 'view_id'), exec);
                 const display = displayOf(view, requiredString(args, 'display'));
+                const type = requiredString(args, 'type');
                 const attributes = { ...jsonObject(args.attributes_json, 'attributes_json') };
+                const profileId = optionalString(args, 'profile_id');
+                const profile = profileId === undefined ? undefined : profileOf?.(profileId);
+                if (profile !== undefined) {
+                    const cluster = profile.hmi?.button?.[0]?.value;
+                    if (/button$/iu.test(type) && cluster !== undefined && attributes.width === undefined && attributes.height === undefined) {
+                        const [width, height] = cluster.split('x');
+                        if (width !== undefined && height !== undefined) {
+                            attributes.width = width;
+                            attributes.height = height;
+                        }
+                    }
+                    const font = profile.hmi?.fonts?.[0]?.value;
+                    if (font !== undefined && attributes.fontFamily === undefined && (/text$/iu.test(type) || /button$/iu.test(type)))
+                        attributes.fontFamily = font;
+                }
                 const caption = optionalString(args, 'caption');
                 if (caption !== undefined)
                     attributes.caption = caption;
@@ -232,14 +252,14 @@ export function editTools(session, drafts, fs, maxOperations) {
                 const { draft } = stage(exec, optionalString(args, 'view_id'), {
                     kind: 'object_add',
                     file: display.file,
-                    type: requiredString(args, 'type'),
+                    type,
                     name: requiredString(args, 'name'),
                     attributes,
                     ...(parent === undefined ? {} : { parent }),
                     ...(index === undefined ? {} : { index }),
                     ...(Object.keys(connections).length === 0 ? {} : { connections }),
                 });
-                return staged(draft, draft.operations[draft.operations.length - 1]);
+                return staged(draft, draft.operations[draft.operations.length - 1], profileId);
             },
         }),
         tool({

package/vendor/ftview/lib/edit.js

@@ -30,7 +30,8 @@ export function apply(ctx, config = {}) {
     if (!Number.isInteger(maxDraftOperations) || maxDraftOperations <= 0) {
         throw new Error('ftview-edit: maxDraftOperations must be a positive integer');
     }
-    for (const definition of editTools(session, new EditDrafts(), stringFs(ctx.fs), maxDraftOperations))
+    const profiles = ctx.get?.('engineeringProfiles');
+    for (const definition of editTools(session, new EditDrafts(), stringFs(ctx.fs), maxDraftOperations, profiles?.get.bind(profiles)))
         ctx.tools.register(definition);
 }
 export { EditDrafts } from "./edit/drafts.js";

package/vendor/ftview/lib/session.d.ts

@@ -9,6 +9,7 @@
  */
 import { type ExecContext, type FsService } from './core.ts';
 import { type Application } from './model.ts';
+import { type FtviewStyleProfile } from './style.ts';
 /** One opened export folder. */
 export interface OpenView {
     readonly id: string;
@@ -35,6 +36,14 @@ export declare class ViewSession {
      * @returns The retained view.
      */
     open(requestedRoot: string, exec?: ExecContext): Promise<OpenView>;
+    /**
+     * Read the house style of one open export.
+     *
+     * @param viewId - Explicit handle, or undefined to use the chat's only view.
+     * @param exec - Calling context.
+     * @returns The visual profile of the export.
+     */
+    styleProfile(viewId: string | undefined, exec?: ExecContext): FtviewStyleProfile;
     /**
      * Resolve the view a call applies to.
      *

package/vendor/ftview/lib/session.js

@@ -10,6 +10,7 @@
 import { randomUUID } from 'node:crypto';
 import { EngineeringError } from "./core.js";
 import { scanApplication } from "./model.js";
+import { styleProfileOf } from "./style.js";
 /** The scanned export store, keyed by chat. */
 export class ViewSession {
     fs;
@@ -57,6 +58,16 @@ export class ViewSession {
         }
         return view;
     }
+    /**
+     * Read the house style of one open export.
+     *
+     * @param viewId - Explicit handle, or undefined to use the chat's only view.
+     * @param exec - Calling context.
+     * @returns The visual profile of the export.
+     */
+    styleProfile(viewId, exec) {
+        return styleProfileOf(this.require(viewId, exec).app);
+    }
     /**
      * Resolve the view a call applies to.
      *

package/vendor/ftview/lib/style.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Infer the visual style of one FactoryTalk View ME export.
+ *
+ * Counts only what the export states: colours, fonts, button geometry,
+ * navigation and popup usage. Group screens inherited from another project and
+ * a two-display export are reported as low confidence rather than dressed up as
+ * a standard.
+ *
+ * @module dsh-engineering-ftview/style
+ */
+import type { Application } from './model.ts';
+/** One counted value. */
+interface Counted {
+    readonly value: string;
+    readonly count: number;
+}
+/** Evidence for one claim. */
+interface Evidence {
+    readonly file?: string;
+    readonly count?: number;
+    readonly note: string;
+}
+/** The profile, structurally compatible with the resources schema. */
+export interface FtviewStyleProfile {
+    readonly schema: 1;
+    readonly source: {
+        readonly kind: 'ftview';
+        readonly path: string;
+        readonly sha256: string;
+    };
+    readonly naming: {
+        readonly displays: {
+            readonly case: string;
+            readonly examples: readonly string[];
+        };
+    };
+    readonly hmi: {
+        readonly palette: readonly Counted[];
+        readonly fonts: readonly Counted[];
+        readonly button: readonly Counted[];
+        readonly navigation: {
+            readonly displaysWithNav: number;
+            readonly displays: number;
+        };
+        readonly popups: {
+            readonly onTop: number;
+            readonly replace: number;
+        };
+    };
+    readonly evidence: readonly Evidence[];
+    readonly confidence: 'low' | 'medium' | 'high';
+}
+/**
+ * Read the style of one export.
+ *
+ * @param app - The scanned export.
+ * @returns The profile.
+ */
+export declare function styleProfileOf(app: Application): FtviewStyleProfile;
+export {};

package/vendor/ftview/lib/style.js

@@ -0,0 +1,109 @@
+/**
+ * Infer the visual style of one FactoryTalk View ME export.
+ *
+ * Counts only what the export states: colours, fonts, button geometry,
+ * navigation and popup usage. Group screens inherited from another project and
+ * a two-display export are reported as low confidence rather than dressed up as
+ * a standard.
+ *
+ * @module dsh-engineering-ftview/style
+ */
+/** The most common value in a counter, with its count. */
+function top(counts) {
+    let best;
+    for (const [value, count] of counts) {
+        if (best === undefined || count > best.count)
+            best = { value, count };
+    }
+    return best;
+}
+/** Normalise a hex colour to lower case with a leading hash. */
+function colour(value) {
+    if (value === undefined)
+        return undefined;
+    const trimmed = value.trim().toLowerCase();
+    return /^#[0-9a-f]{3,8}$/u.test(trimmed) ? trimmed : undefined;
+}
+/** Classify one display name's case convention. */
+function nameCase(name) {
+    if (/^[A-Z][a-z]+(?: [A-Z][a-z]+)+$/u.test(name))
+        return 'Title Case';
+    if (/^[A-Z][A-Za-z0-9]*$/u.test(name))
+        return 'PascalCase';
+    if (/^[a-z0-9]+(?:_[a-z0-9]+)+$/u.test(name))
+        return 'snake_case';
+    return 'other';
+}
+/**
+ * Read the style of one export.
+ *
+ * @param app - The scanned export.
+ * @returns The profile.
+ */
+export function styleProfileOf(app) {
+    const palette = new Map();
+    const fonts = new Map();
+    const buttons = new Map();
+    const displayCases = new Map();
+    let displaysWithNav = 0;
+    let onTop = 0;
+    let replace = 0;
+    const evidence = [];
+    for (const display of app.displays) {
+        displayCases.set(nameCase(display.name), (displayCases.get(nameCase(display.name)) ?? 0) + 1);
+        let gotoButtons = 0;
+        for (const object of display.objects) {
+            const back = colour(object.attributes.backColor);
+            if (back !== undefined)
+                palette.set(back, (palette.get(back) ?? 0) + 1);
+            const family = object.attributes.fontFamily;
+            if (family !== undefined && family.trim() !== '')
+                fonts.set(family, (fonts.get(family) ?? 0) + 1);
+            if (/button$/iu.test(object.type)) {
+                const width = object.attributes.width;
+                const height = object.attributes.height;
+                if (width !== undefined && height !== undefined) {
+                    const key = `${width}x${height}`;
+                    buttons.set(key, (buttons.get(key) ?? 0) + 1);
+                }
+            }
+            if (object.type === 'gotoButton')
+                gotoButtons += 1;
+            if (object.type === 'displaySettings') {
+                const type = object.attributes.displayType;
+                if (type === 'onTop')
+                    onTop += 1;
+                if (type === 'replace')
+                    replace += 1;
+            }
+        }
+        if (gotoButtons >= 3)
+            displaysWithNav += 1;
+    }
+    const back = top(palette);
+    const family = top(fonts);
+    const button = top(buttons);
+    const displayCase = top(displayCases);
+    if (back !== undefined)
+        evidence.push({ count: back.count, note: `background "${back.value}" used ${back.count} time(s)` });
+    if (family !== undefined)
+        evidence.push({ count: family.count, note: `font "${family.value}" used ${family.count} time(s)` });
+    if (button !== undefined)
+        evidence.push({ count: button.count, note: `button geometry ${button.value} used ${button.count} time(s)` });
+    evidence.push({ count: app.displays.length, note: `${app.displays.length} display(s) read` });
+    const confidence = app.displays.length >= 8 && (back?.count ?? 0) >= 5 ? 'high' : app.displays.length >= 3 ? 'medium' : 'low';
+    return {
+        schema: 1,
+        source: { kind: 'ftview', path: app.root, sha256: '' },
+        naming: { displays: { case: displayCase?.value ?? 'Title Case', examples: app.displays.slice(0, 5).map(display => display.name) } },
+        hmi: {
+            palette: [...palette].sort((left, right) => right[1] - left[1]).slice(0, 6).map(([value, count]) => ({ value, count })),
+            fonts: [...fonts].sort((left, right) => right[1] - left[1]).slice(0, 4).map(([value, count]) => ({ value, count })),
+            button: [...buttons].sort((left, right) => right[1] - left[1]).slice(0, 4).map(([value, count]) => ({ value, count })),
+            navigation: { displaysWithNav, displays: app.displays.length },
+            popups: { onTop, replace },
+        },
+        evidence,
+        confidence,
+    };
+}

package/vendor/ftview/lib/vendor-tools.js

@@ -64,10 +64,13 @@ export function vendorTools(fs) {
                 if (exported.error !== undefined) {
                     throw new EngineeringError('VENDOR_EXPORT_FAILED', exported.error, 'Check that the application is not open in Studio, then retry with a new output_root.');
                 }
-                const files = exported.value ?? [];
+                const files = exported.value?.files ?? [];
+                const warnings = exported.value?.warnings ?? [];
                 const displays = files.filter(file => /\/Displays\/.+\.xml$/iu.test(file) && !/batchimport/iu.test(file));
                 const manifests = files.filter(file => /batchimport/iu.test(file));
-                return success(`Exported ${application}: ${files.length} file(s), ${displays.length} display(s)${manifests.length === 0 ? '' : `, ${manifests.length} import manifest(s)`}.`, { application, output_root: destination, files, display_count: displays.length, manifests }, [{ tool: 'ftview_open', args: { root: destination }, why: 'Open the fresh export and author against it.' }], VENDOR_COVERAGE);
+                const alarms = files.filter(file => /^Alarms\//iu.test(file));
+                const tags = files.filter(file => /^Tags\/.+\.csv$/iu.test(file));
+                return success(`Exported ${application}: ${files.length} file(s), ${displays.length} display(s)${alarms.length === 0 ? ', no alarms' : ', alarms'}${tags.length === 0 ? ', no tags CSV' : ', tags CSV'}${manifests.length === 0 ? '' : `, ${manifests.length} import manifest(s)`}${warnings.length === 0 ? '' : `; ${warnings.length} warning(s)`}.`, { application, output_root: destination, files, display_count: displays.length, alarms, tags, manifests, warnings }, [{ tool: 'ftview_open', args: { root: destination }, why: 'Open the fresh export and author against it.' }], VENDOR_COVERAGE);
             },
         }),
     ];

package/vendor/ftview/lib/vendor.d.ts

@@ -37,13 +37,53 @@ export interface VendorResult<T> {
  */
 export declare function listApplications(): Promise<VendorResult<readonly MeApplication[]>>;
 /**
- * Export one application's displays and globals into a new folder.
+ * Export one application's displays, globals, alarms and tags into a new folder.
+ *
+ * The export server covers displays, global objects and project settings. The
+ * alarm setup and the tag database live beside the application in the Studio
+ * project store, and `ExportAll` does not copy them, so this function does:
+ * without them a "full" export has no tags to bind and no alarms to review.
+ *
+ * Those two files are snapshots Studio writes when it exports them from their
+ * editors, not live views of the database, so each copy is checked against the
+ * application database's timestamp and a stale one is reported rather than
+ * silently handed over as current.
  *
  * @param application - Application name as listed.
  * @param destination - Folder to create and fill.
- * @returns Files written, relative to the destination.
+ * @param documentsRoot - Public Documents folder, injectable for tests.
+ * @returns Files written and any freshness warnings.
+ */
+export declare function exportApplication(application: string, destination: string, documentsRoot?: string): Promise<VendorResult<ExportResult>>;
+/** One export run's files and freshness warnings. */
+export interface ExportResult {
+    /** Files written, relative to the destination. */
+    readonly files: readonly string[];
+    /** Components that are missing or older than the application database. */
+    readonly warnings: readonly string[];
+}
+/** What the project store contributed to an export. */
+export interface ProjectExtras {
+    /** Export-relative paths copied from the store. */
+    readonly copied: readonly string[];
+    /** Why a component is missing or possibly stale. */
+    readonly warnings: readonly string[];
+}
+/** The Studio project store that holds one application's alarms and tags. */
+export declare function projectFolder(application: string, documentsRoot?: string): string | undefined;
+/**
+ * Copy the alarm setup and the tag CSV from the project store into an export.
+ *
+ * The file names and layout match what Studio writes when it exports the whole
+ * application (`Alarms/Alarms.xml`, `Tags/<application>.csv`), so a reader
+ * cannot tell this export from a hand-made one.
+ *
+ * @param application - Application name.
+ * @param destination - Export folder that already exists.
+ * @param documentsRoot - Public Documents folder, injectable for tests.
+ * @returns Paths copied and any staleness warnings.
  */
-export declare function exportApplication(application: string, destination: string): Promise<VendorResult<readonly string[]>>;
+export declare function copyProjectExtras(application: string, destination: string, documentsRoot?: string): ProjectExtras;
 /**
  * Back one application up to a zip.
  *