@marinoscar/platform-api 0.0.0-stage → 0.1.0-next.3

package/dist/telemetry/telemetry.permissions.d.ts

@@ -0,0 +1,76 @@
+/**
+ * One permission the telemetry slice declares, in the shape an app's
+ * permission registry takes.
+ *
+ * @typeParam Id - the permission string.
+ *
+ * @stability experimental
+ */
+export interface TelemetryPermissionDeclaration<Id extends string = string> {
+    /** `'<resource>:<action>'`: the exact string the slice's routes enforce. */
+    readonly id: Id;
+    /** Seeded into `permissions.description`. */
+    readonly description: string;
+    /**
+     * What the permission operates: `'system'` (the deployment) or `'org'` (one
+     * organization). Every telemetry permission is `'system'`: telemetry is a
+     * deployment-wide operator surface.
+     */
+    readonly scope: 'system' | 'org';
+    /** Role ids the permission is granted to by default (seeded into `role_permissions`). */
+    readonly defaultGrants: readonly string[];
+}
+/**
+ * The telemetry permissions with their descriptions and default grants, keyed
+ * by the `PERMISSIONS` constant name the reference app derives from them.
+ * Register them with the app's permission registry.
+ *
+ * @example
+ * ```ts
+ * registerPermissions(TELEMETRY_PERMISSION_DECLARATIONS);
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export declare const TELEMETRY_PERMISSION_DECLARATIONS: {
+    /** `telemetry:read`: view telemetry settings and status. */
+    readonly TELEMETRY_READ: TelemetryPermissionDeclaration<'telemetry:read'>;
+    /** `telemetry:write`: change telemetry settings. */
+    readonly TELEMETRY_WRITE: TelemetryPermissionDeclaration<'telemetry:write'>;
+    /** `telemetry:query`: run SQL, export, the dashboard and the AI assistant. */
+    readonly TELEMETRY_QUERY: TelemetryPermissionDeclaration<'telemetry:query'>;
+};
+/**
+ * The permission strings the telemetry routes enforce: `READ` (settings and
+ * status), `WRITE` (change them) and `QUERY` (run SQL, export, the dashboard
+ * and the assistant).
+ *
+ * @stability stable
+ */
+export declare const TELEMETRY_PERMISSIONS: {
+    /** `telemetry:read`. */
+    readonly READ: 'telemetry:read';
+    /** `telemetry:write`. */
+    readonly WRITE: 'telemetry:write';
+    /** `telemetry:query`. */
+    readonly QUERY: 'telemetry:query';
+};
+/**
+ * Permissions the APP owns that telemetry routes also require; the app must
+ * declare them. `AI_USE`: the assistant spends an AI key (all-of with
+ * `telemetry:query`). `SYSTEM_SETTINGS_READ`/`SYSTEM_SETTINGS_WRITE`: the
+ * stack-agent routes (`/api/admin/telemetry/stack`) are deployment operations
+ * gated like the rest of the system settings.
+ *
+ * @stability experimental
+ */
+export declare const TELEMETRY_HOST_PERMISSIONS: {
+    /** `ai:use`: spend an AI key. */
+    readonly AI_USE: 'ai:use';
+    /** `system_settings:read`. */
+    readonly SYSTEM_SETTINGS_READ: 'system_settings:read';
+    /** `system_settings:write`. */
+    readonly SYSTEM_SETTINGS_WRITE: 'system_settings:write';
+};
+//# sourceMappingURL=telemetry.permissions.d.ts.map

package/dist/telemetry/telemetry.permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.permissions.d.ts","sourceRoot":"","sources":["../../src/telemetry/telemetry.permissions.ts"],"names":[],"mappings":"AAuBA;;;;;;;GAOG;AACH,MAAM,WAAW,8BAA8B,CAAC,EAAE,SAAS,MAAM,GAAG,MAAM;IACxE,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC;IAChB,6CAA6C;IAC7C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,KAAK,CAAC;IACjC,yFAAyF;IACzF,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iCAAiC,EAAE;IAC9C,4DAA4D;IAC5D,QAAQ,CAAC,cAAc,EAAE,8BAA8B,CAAC,gBAAgB,CAAC,CAAC;IAC1E,oDAAoD;IACpD,QAAQ,CAAC,eAAe,EAAE,8BAA8B,CAAC,iBAAiB,CAAC,CAAC;IAC5E,8EAA8E;IAC9E,QAAQ,CAAC,eAAe,EAAE,8BAA8B,CAAC,iBAAiB,CAAC,CAAC;CAoB7E,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE;IAClC,wBAAwB;IACxB,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,yBAAyB;IACzB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,yBAAyB;IACzB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;CAKnC,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,EAAE;IACvC,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,8BAA8B;IAC9B,QAAQ,CAAC,oBAAoB,EAAE,sBAAsB,CAAC;IACtD,+BAA+B;IAC/B,QAAQ,CAAC,qBAAqB,EAAE,uBAAuB,CAAC;CAKzD,CAAC"}

package/dist/telemetry/telemetry.permissions.js

@@ -0,0 +1,85 @@
+"use strict";
+// =============================================================================
+// Telemetry permissions (issue #676, PP-1.4; exported as data by #703)
+// =============================================================================
+//
+// Pure data: the slice's three permissions and their default role grants. The
+// app registers the declarations with its own permission registry (the
+// reference app: `common/permissions/permission.manifest.ts`, which also
+// derives `PERMISSIONS` from them in `common/constants/roles.constants.ts`).
+// The strings never change: they are rows in `permissions` and the exact
+// strings the controllers enforce.
+//
+// ADMIN ONLY, same reasoning as the other operational surfaces: telemetry
+// settings and ad-hoc queries against observability data start as narrow as
+// `db_backup:*`/`ai_config:*` and can be widened later without a migration,
+// since these are rows. THREE permissions, mirroring the `ai_config:*`/`ai:use`
+// split and the `db_backup:*` trio: `READ` and `WRITE` gate the
+// DEPLOYMENT-WIDE policy (whether telemetry is collected, its retention, and
+// the query/assistant bounds). `QUERY` is the separate act of actually running
+// SQL, exporting results, or invoking the AI assistant against telemetry data,
+// an act materially different from reading or changing the policy that
+// governs it.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TELEMETRY_HOST_PERMISSIONS = exports.TELEMETRY_PERMISSIONS = exports.TELEMETRY_PERMISSION_DECLARATIONS = void 0;
+/**
+ * The telemetry permissions with their descriptions and default grants, keyed
+ * by the `PERMISSIONS` constant name the reference app derives from them.
+ * Register them with the app's permission registry.
+ *
+ * @example
+ * ```ts
+ * registerPermissions(TELEMETRY_PERMISSION_DECLARATIONS);
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+exports.TELEMETRY_PERMISSION_DECLARATIONS = {
+    TELEMETRY_READ: {
+        id: 'telemetry:read',
+        description: 'View telemetry settings and status',
+        scope: 'system',
+        defaultGrants: ['admin'],
+    },
+    TELEMETRY_WRITE: {
+        id: 'telemetry:write',
+        description: 'Change telemetry settings',
+        scope: 'system',
+        defaultGrants: ['admin'],
+    },
+    TELEMETRY_QUERY: {
+        id: 'telemetry:query',
+        description: 'Run SQL, export and use the AI assistant against telemetry',
+        scope: 'system',
+        defaultGrants: ['admin'],
+    },
+};
+/**
+ * The permission strings the telemetry routes enforce: `READ` (settings and
+ * status), `WRITE` (change them) and `QUERY` (run SQL, export, the dashboard
+ * and the assistant).
+ *
+ * @stability stable
+ */
+exports.TELEMETRY_PERMISSIONS = {
+    READ: exports.TELEMETRY_PERMISSION_DECLARATIONS.TELEMETRY_READ.id,
+    WRITE: exports.TELEMETRY_PERMISSION_DECLARATIONS.TELEMETRY_WRITE.id,
+    QUERY: exports.TELEMETRY_PERMISSION_DECLARATIONS.TELEMETRY_QUERY.id,
+};
+/**
+ * Permissions the APP owns that telemetry routes also require; the app must
+ * declare them. `AI_USE`: the assistant spends an AI key (all-of with
+ * `telemetry:query`). `SYSTEM_SETTINGS_READ`/`SYSTEM_SETTINGS_WRITE`: the
+ * stack-agent routes (`/api/admin/telemetry/stack`) are deployment operations
+ * gated like the rest of the system settings.
+ *
+ * @stability experimental
+ */
+exports.TELEMETRY_HOST_PERMISSIONS = {
+    AI_USE: 'ai:use',
+    SYSTEM_SETTINGS_READ: 'system_settings:read',
+    SYSTEM_SETTINGS_WRITE: 'system_settings:write',
+};
+//# sourceMappingURL=telemetry.permissions.js.map

package/dist/telemetry/telemetry.permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.permissions.js","sourceRoot":"","sources":["../../src/telemetry/telemetry.permissions.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,uEAAuE;AACvE,gFAAgF;AAChF,EAAE;AACF,8EAA8E;AAC9E,uEAAuE;AACvE,yEAAyE;AACzE,6EAA6E;AAC7E,yEAAyE;AACzE,mCAAmC;AACnC,EAAE;AACF,0EAA0E;AAC1E,4EAA4E;AAC5E,4EAA4E;AAC5E,gFAAgF;AAChF,gEAAgE;AAChE,6EAA6E;AAC7E,+EAA+E;AAC/E,+EAA+E;AAC/E,uEAAuE;AACvE,cAAc;AACd,gFAAgF;;;AAyBhF;;;;;;;;;;;;GAYG;AACU,QAAA,iCAAiC,GAO1C;IACF,cAAc,EAAE;QACd,EAAE,EAAE,gBAAgB;QACpB,WAAW,EAAE,oCAAoC;QACjD,KAAK,EAAE,QAAQ;QACf,aAAa,EAAE,CAAC,OAAO,CAAC;KACzB;IACD,eAAe,EAAE;QACf,EAAE,EAAE,iBAAiB;QACrB,WAAW,EAAE,2BAA2B;QACxC,KAAK,EAAE,QAAQ;QACf,aAAa,EAAE,CAAC,OAAO,CAAC;KACzB;IACD,eAAe,EAAE;QACf,EAAE,EAAE,iBAAiB;QACrB,WAAW,EAAE,4DAA4D;QACzE,KAAK,EAAE,QAAQ;QACf,aAAa,EAAE,CAAC,OAAO,CAAC;KACzB;CACF,CAAC;AAEF;;;;;;GAMG;AACU,QAAA,qBAAqB,GAO9B;IACF,IAAI,EAAE,yCAAiC,CAAC,cAAc,CAAC,EAAE;IACzD,KAAK,EAAE,yCAAiC,CAAC,eAAe,CAAC,EAAE;IAC3D,KAAK,EAAE,yCAAiC,CAAC,eAAe,CAAC,EAAE;CAC5D,CAAC;AAEF;;;;;;;;GAQG;AACU,QAAA,0BAA0B,GAOnC;IACF,MAAM,EAAE,QAAQ;IAChB,oBAAoB,EAAE,sBAAsB;IAC5C,qBAAqB,EAAE,uBAAuB;CAC/C,CAAC"}

package/dist/telemetry/telemetry.settings.d.ts

@@ -0,0 +1,79 @@
+import type { TelemetrySettings } from '@marinoscar/platform-contract/telemetry';
+/**
+ * The namespace key under which the app stores the telemetry policy.
+ *
+ * @stability stable
+ */
+export declare const TELEMETRY_SETTINGS_NAMESPACE: "telemetry";
+/**
+ * The namespace's one-line description for the app's settings catalog.
+ *
+ * @stability experimental
+ */
+export declare const TELEMETRY_SETTINGS_DESCRIPTION = "Telemetry policy: whether telemetry is collected, how long it is kept, the bounds of an ad-hoc query, and the AI assistant over it.";
+/**
+ * The namespace's defaults: OFF and INERT, matching every namespace that ships
+ * ahead of its consumers. A fresh deployment does not collect or retain
+ * observability data nobody asked for.
+ *
+ * - `instanceId: null` follows the app's slug, resolved at the point of use,
+ *   so a renamed fork follows its new name until an administrator overrides it.
+ * - `assistant.enabled: false` on top of `enabled: false`: a second, narrower switch.
+ * - `assistant.shareResults: true`: an assistant that cannot see the rows it
+ *   queried cannot explain them; an administrator turns it off deliberately.
+ *
+ * @stability stable
+ */
+export declare const TELEMETRY_SETTINGS_DEFAULTS: TelemetrySettings;
+/**
+ * A partial update of the namespace: every field optional, `instanceId`,
+ * `assistant.provider` and `assistant.modelId` nullable (an explicit `null`
+ * clears them).
+ *
+ * @stability experimental
+ */
+export interface TelemetrySettingsPatch {
+    /** Whether telemetry is exported. */
+    enabled?: boolean;
+    /** The store's TTL, in days. */
+    retentionDays?: number;
+    /** The `app.instance.id` label; `null` follows the app's slug. */
+    instanceId?: string | null;
+    /** The bounds of an ad-hoc query. */
+    query?: {
+        /** Rows a query returns at most. */
+        maxRows?: number;
+        /** A query's timeout, seconds. */
+        timeoutSeconds?: number;
+    };
+    /** The telemetry assistant. */
+    assistant?: {
+        /** Whether the assistant is on. */
+        enabled?: boolean;
+        /** Its AI provider; `null` clears it. */
+        provider?: string | null;
+        /** Its model; `null` clears it. */
+        modelId?: string | null;
+        /** Whether row values are shown to the model. */
+        shareResults?: boolean;
+        /** Rows per statement the model sees at most. */
+        maxResultRowsToModel?: number;
+        /** Model round-trips per turn at most. */
+        maxSteps?: number;
+    };
+}
+/**
+ * Merges a patch over the current value, field by field, one level deep into
+ * `query` and `assistant`. An absent field keeps its stored value; the three
+ * NULLABLE fields (`instanceId`, `assistant.provider`, `assistant.modelId`)
+ * take an explicit `null` as "clear" (`!== undefined`, never `??`, or an
+ * operator could never clear a provider once set).
+ *
+ * @param current - the stored value.
+ * @param patch - the update, or `undefined` for none.
+ * @returns the merged value.
+ *
+ * @stability stable
+ */
+export declare function mergeTelemetrySettings(current: TelemetrySettings, patch: TelemetrySettingsPatch | undefined): TelemetrySettings;
+//# sourceMappingURL=telemetry.settings.d.ts.map

package/dist/telemetry/telemetry.settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.settings.d.ts","sourceRoot":"","sources":["../../src/telemetry/telemetry.settings.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAEjF;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,EAAG,WAAoB,CAAC;AAEjE;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,wIAC4F,CAAC;AAExI;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,2BAA2B,EAAE,iBAgBzC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,qCAAqC;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gCAAgC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,qCAAqC;IACrC,KAAK,CAAC,EAAE;QACN,oCAAoC;QACpC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,kCAAkC;QAClC,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,+BAA+B;IAC/B,SAAS,CAAC,EAAE;QACV,mCAAmC;QACnC,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,yCAAyC;QACzC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,mCAAmC;QACnC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,iDAAiD;QACjD,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,iDAAiD;QACjD,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,0CAA0C;QAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,sBAAsB,GAAG,SAAS,GACxC,iBAAiB,CAkBnB"}

package/dist/telemetry/telemetry.settings.js

@@ -0,0 +1,92 @@
+"use strict";
+// =============================================================================
+// The `telemetry` system-settings namespace, as data (issue #677; exported by #703)
+// =============================================================================
+//
+// The slice owns the namespace's SHAPE (the contract's `telemetrySettingsSchema`,
+// #702), its defaults and its merge rule; the app declares it in its own
+// settings-namespace registry with these (the reference app:
+// `apps/api/src/platform/telemetry/telemetry.system-settings.ts`), and stores
+// and validates it. Pure data: no Nest, no registry call.
+//
+// NO CREDENTIAL HERE: the assistant's provider key is resolved by the app's AI
+// platform like every other AI call (`TELEMETRY_SETTINGS_CARRIES_NO_SECRET`).
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TELEMETRY_SETTINGS_DEFAULTS = exports.TELEMETRY_SETTINGS_DESCRIPTION = exports.TELEMETRY_SETTINGS_NAMESPACE = void 0;
+exports.mergeTelemetrySettings = mergeTelemetrySettings;
+/**
+ * The namespace key under which the app stores the telemetry policy.
+ *
+ * @stability stable
+ */
+exports.TELEMETRY_SETTINGS_NAMESPACE = 'telemetry';
+/**
+ * The namespace's one-line description for the app's settings catalog.
+ *
+ * @stability experimental
+ */
+exports.TELEMETRY_SETTINGS_DESCRIPTION = 'Telemetry policy: whether telemetry is collected, how long it is kept, the bounds of an ad-hoc query, and the AI assistant over it.';
+/**
+ * The namespace's defaults: OFF and INERT, matching every namespace that ships
+ * ahead of its consumers. A fresh deployment does not collect or retain
+ * observability data nobody asked for.
+ *
+ * - `instanceId: null` follows the app's slug, resolved at the point of use,
+ *   so a renamed fork follows its new name until an administrator overrides it.
+ * - `assistant.enabled: false` on top of `enabled: false`: a second, narrower switch.
+ * - `assistant.shareResults: true`: an assistant that cannot see the rows it
+ *   queried cannot explain them; an administrator turns it off deliberately.
+ *
+ * @stability stable
+ */
+exports.TELEMETRY_SETTINGS_DEFAULTS = {
+    enabled: false,
+    retentionDays: 30,
+    instanceId: null,
+    query: {
+        maxRows: 10000,
+        timeoutSeconds: 30,
+    },
+    assistant: {
+        enabled: false,
+        provider: null,
+        modelId: null,
+        shareResults: true,
+        maxResultRowsToModel: 100,
+        maxSteps: 15,
+    },
+};
+/**
+ * Merges a patch over the current value, field by field, one level deep into
+ * `query` and `assistant`. An absent field keeps its stored value; the three
+ * NULLABLE fields (`instanceId`, `assistant.provider`, `assistant.modelId`)
+ * take an explicit `null` as "clear" (`!== undefined`, never `??`, or an
+ * operator could never clear a provider once set).
+ *
+ * @param current - the stored value.
+ * @param patch - the update, or `undefined` for none.
+ * @returns the merged value.
+ *
+ * @stability stable
+ */
+function mergeTelemetrySettings(current, patch) {
+    return {
+        enabled: patch?.enabled ?? current.enabled,
+        retentionDays: patch?.retentionDays ?? current.retentionDays,
+        instanceId: patch?.instanceId !== undefined ? patch.instanceId : current.instanceId,
+        query: {
+            maxRows: patch?.query?.maxRows ?? current.query.maxRows,
+            timeoutSeconds: patch?.query?.timeoutSeconds ?? current.query.timeoutSeconds,
+        },
+        assistant: {
+            enabled: patch?.assistant?.enabled ?? current.assistant.enabled,
+            provider: patch?.assistant?.provider !== undefined ? patch.assistant.provider : current.assistant.provider,
+            modelId: patch?.assistant?.modelId !== undefined ? patch.assistant.modelId : current.assistant.modelId,
+            shareResults: patch?.assistant?.shareResults ?? current.assistant.shareResults,
+            maxResultRowsToModel: patch?.assistant?.maxResultRowsToModel ?? current.assistant.maxResultRowsToModel,
+            maxSteps: patch?.assistant?.maxSteps ?? current.assistant.maxSteps,
+        },
+    };
+}
+//# sourceMappingURL=telemetry.settings.js.map

package/dist/telemetry/telemetry.settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.settings.js","sourceRoot":"","sources":["../../src/telemetry/telemetry.settings.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,oFAAoF;AACpF,gFAAgF;AAChF,EAAE;AACF,kFAAkF;AAClF,yEAAyE;AACzE,6DAA6D;AAC7D,8EAA8E;AAC9E,0DAA0D;AAC1D,EAAE;AACF,+EAA+E;AAC/E,8EAA8E;AAC9E,gFAAgF;;;AAqGhF,wDAqBC;AAtHD;;;;GAIG;AACU,QAAA,4BAA4B,GAAG,WAAoB,CAAC;AAEjE;;;;GAIG;AACU,QAAA,8BAA8B,GACzC,qIAAqI,CAAC;AAExI;;;;;;;;;;;;GAYG;AACU,QAAA,2BAA2B,GAAsB;IAC5D,OAAO,EAAE,KAAK;IACd,aAAa,EAAE,EAAE;IACjB,UAAU,EAAE,IAAI;IAChB,KAAK,EAAE;QACL,OAAO,EAAE,KAAK;QACd,cAAc,EAAE,EAAE;KACnB;IACD,SAAS,EAAE;QACT,OAAO,EAAE,KAAK;QACd,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,IAAI;QACb,YAAY,EAAE,IAAI;QAClB,oBAAoB,EAAE,GAAG;QACzB,QAAQ,EAAE,EAAE;KACb;CACF,CAAC;AAwCF;;;;;;;;;;;;GAYG;AACH,SAAgB,sBAAsB,CACpC,OAA0B,EAC1B,KAAyC;IAEzC,OAAO;QACL,OAAO,EAAE,KAAK,EAAE,OAAO,IAAI,OAAO,CAAC,OAAO;QAC1C,aAAa,EAAE,KAAK,EAAE,aAAa,IAAI,OAAO,CAAC,aAAa;QAC5D,UAAU,EAAE,KAAK,EAAE,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU;QACnF,KAAK,EAAE;YACL,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,OAAO;YACvD,cAAc,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,IAAI,OAAO,CAAC,KAAK,CAAC,cAAc;SAC7E;QACD,SAAS,EAAE;YACT,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,IAAI,OAAO,CAAC,SAAS,CAAC,OAAO;YAC/D,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ;YAC1G,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO;YACtG,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,IAAI,OAAO,CAAC,SAAS,CAAC,YAAY;YAC9E,oBAAoB,EAAE,KAAK,EAAE,SAAS,EAAE,oBAAoB,IAAI,OAAO,CAAC,SAAS,CAAC,oBAAoB;YACtG,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,IAAI,OAAO,CAAC,SAAS,CAAC,QAAQ;SACnE;KACF,CAAC;AACJ,CAAC"}

package/dist/telemetry/testing/coach-metric-group.fixture.d.ts

@@ -0,0 +1,17 @@
+import type { MetricGroupDef, MetricGroup } from '../metrics/metric-group.registry';
+/**
+ * The id of {@link COACH_METRIC_GROUP}.
+ *
+ * @stability experimental
+ */
+export declare const COACH_METRIC_GROUP_ID: MetricGroup;
+/**
+ * A sample app metric group shaped like EvoPath's AI Coach: nudges sent,
+ * suppressed and opened and audio generated and failed (counters), the
+ * health-summary p95 (a histogram), and two ratios, all filtered by service
+ * and instance.
+ *
+ * @stability experimental
+ */
+export declare const COACH_METRIC_GROUP: MetricGroupDef;
+//# sourceMappingURL=coach-metric-group.fixture.d.ts.map

package/dist/telemetry/testing/coach-metric-group.fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coach-metric-group.fixture.d.ts","sourceRoot":"","sources":["../../../src/telemetry/testing/coach-metric-group.fixture.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAGpF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAc,WAAW,CAAC;AAE5D;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,EAAE,cAoGhC,CAAC"}

package/dist/telemetry/testing/coach-metric-group.fixture.js

@@ -0,0 +1,128 @@
+"use strict";
+// A coach-shaped app metric group (issue #703, PP-4.6): what EvoPath registers
+// for its AI Coach, over the `app_*` tables of `APP_SAMPLE_METRIC_TAGS`, with the
+// table names of EvoPath's `APP_METRIC_NAMES`, expressed with the platform's own
+// family kinds, filters and units. It is the evidence behind the adoption
+// claim "EvoPath's coach group is a new extension, not a platform change": the
+// readiness test (`../metrics/coach-readiness.spec.ts`) runs it through the
+// conformance checks and the renderer with no platform edit. Also used by the
+// registry tests and the reference app's extension-points integration test.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COACH_METRIC_GROUP = exports.COACH_METRIC_GROUP_ID = void 0;
+const metric_catalog_helpers_1 = require("../metrics/metric-catalog.helpers");
+/**
+ * The id of {@link COACH_METRIC_GROUP}.
+ *
+ * @stability experimental
+ */
+exports.COACH_METRIC_GROUP_ID = 'coach';
+/**
+ * A sample app metric group shaped like EvoPath's AI Coach: nudges sent,
+ * suppressed and opened and audio generated and failed (counters), the
+ * health-summary p95 (a histogram), and two ratios, all filtered by service
+ * and instance.
+ *
+ * @stability experimental
+ */
+exports.COACH_METRIC_GROUP = {
+    id: exports.COACH_METRIC_GROUP_ID,
+    label: 'Coach',
+    title: 'AI Coach',
+    order: 70,
+    description: 'AI Coach nudges, audio and health-summary latency',
+    families: [
+        {
+            key: 'coachNudgesSent',
+            group: exports.COACH_METRIC_GROUP_ID,
+            label: 'Nudges sent',
+            table: 'app_coach_nudge_sent_total',
+            kind: 'counter',
+            unit: 'count',
+            rate: 'count',
+            groupBy: 'channel',
+            requiredColumns: ['channel'],
+            filters: metric_catalog_helpers_1.APP_FILTERS,
+        },
+        {
+            key: 'coachNudgesSuppressed',
+            group: exports.COACH_METRIC_GROUP_ID,
+            label: 'Nudges suppressed',
+            table: 'app_coach_nudge_suppressed_total',
+            kind: 'counter',
+            unit: 'count',
+            rate: 'count',
+            groupBy: 'reason',
+            requiredColumns: ['reason'],
+            filters: metric_catalog_helpers_1.APP_FILTERS,
+        },
+        {
+            key: 'coachNudgesOpened',
+            group: exports.COACH_METRIC_GROUP_ID,
+            label: 'Nudges opened',
+            table: 'app_coach_nudge_opened_total',
+            kind: 'counter',
+            unit: 'count',
+            rate: 'count',
+            groupBy: 'channel',
+            requiredColumns: ['channel'],
+            filters: metric_catalog_helpers_1.APP_FILTERS,
+        },
+        {
+            key: 'coachAudioGenerated',
+            group: exports.COACH_METRIC_GROUP_ID,
+            label: 'Audio generated',
+            table: 'app_coach_audio_generated_total',
+            kind: 'counter',
+            unit: 'count',
+            rate: 'count',
+            requiredColumns: [],
+            filters: metric_catalog_helpers_1.APP_FILTERS,
+        },
+        {
+            key: 'coachAudioFailed',
+            group: exports.COACH_METRIC_GROUP_ID,
+            label: 'Audio failed',
+            table: 'app_coach_audio_failed_total',
+            kind: 'counter',
+            unit: 'count',
+            rate: 'count',
+            groupBy: 'reason',
+            requiredColumns: ['reason'],
+            filters: metric_catalog_helpers_1.APP_FILTERS,
+        },
+        {
+            key: 'healthSummaryP95',
+            group: exports.COACH_METRIC_GROUP_ID,
+            label: 'Health summary p95',
+            table: 'app_health_summary_duration_seconds_bucket',
+            kind: 'histogram',
+            unit: 'ms',
+            quantile: 0.95,
+            scale: 1000,
+            requiredColumns: ['le'],
+            filters: metric_catalog_helpers_1.APP_FILTERS,
+        },
+    ],
+    ratios: [
+        {
+            key: 'coachNudgeOpenRate',
+            group: exports.COACH_METRIC_GROUP_ID,
+            label: 'Nudge open rate',
+            unit: '%',
+            numerator: [{ family: 'coachNudgesOpened' }],
+            denominator: [{ family: 'coachNudgesSent' }],
+            scale: 100,
+        },
+        {
+            key: 'coachAudioFailureRatio',
+            group: exports.COACH_METRIC_GROUP_ID,
+            label: 'Audio failure ratio',
+            unit: '%',
+            numerator: [{ family: 'coachAudioFailed' }],
+            denominator: [{ family: 'coachAudioGenerated' }],
+            addNumerator: true,
+            scale: 100,
+        },
+    ],
+};
+//# sourceMappingURL=coach-metric-group.fixture.js.map

package/dist/telemetry/testing/coach-metric-group.fixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coach-metric-group.fixture.js","sourceRoot":"","sources":["../../../src/telemetry/testing/coach-metric-group.fixture.ts"],"names":[],"mappings":"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"}