@uptimizr/metrics 0.1.0 → 0.2.0

package/dist/narrative.js

@@ -0,0 +1,150 @@
+/**
+ * The **session narrative** contract (ADR 0051 §7, design sketch §G.2).
+ *
+ * A narrative is an ordered, compacted account of what one session did — scene
+ * changes, mesh dwell, interactions, performance dips, errors and the reason it
+ * ended — with every timestamp relative to the session's first event. It exists
+ * because the two things an agent could otherwise ask for are both useless to
+ * it: the aggregate metrics say nothing about *one* session, and the raw NDJSON
+ * stream is tens of thousands of lines of sampled telemetry.
+ *
+ * Only the **shapes and bounds** live here, in the dependency-free registry
+ * package, because three packages need them and none of them may depend on the
+ * others:
+ *
+ * - `@uptimizr/db` computes a narrative from `AnyEvent[]` (`src/narrative/`);
+ * - the collector serves it on `GET /api/v1/sessions/:id/narrative` and bounds
+ *   its querystring with the same numbers;
+ * - the registry entry below it (`session_narrative`) advertises the row schema
+ *   to OpenAPI, the agent tool catalog and the docs tables.
+ *
+ * **Privacy (ADR 0003).** A narrative is derived from raw per-session events, so
+ * it is reachable only on a collector with `ENABLE_RAW_SESSION_RETENTION` and
+ * only with a key holding `query:raw`. Even then it is a *projection*: an entry
+ * carries a relative timestamp, a templated one-line summary and at most a mesh
+ * name, a scene id and a custom-event name. It never carries the visitor hash,
+ * the page URL, `pageMeta`, positions, rays, or anything from the `device` block
+ * beyond the engine/graphics API. Custom-event **property values** are excluded
+ * unless the caller explicitly asks for them; the property *keys* are always
+ * safe to show because they are developer-chosen field names.
+ */
+import { z } from "zod";
+/**
+ * What one narrative entry is about.
+ *
+ * - `scene` — the session entered a scene (`session_start` or `scene_change`).
+ * - `dwell` — a mesh held the viewer's attention for at least `minDwellMs`,
+ *   aggregated across the session from `mesh_visibility` / `hover_dwell`.
+ * - `interaction` — a discrete act: a mesh interaction, a click that hit a mesh,
+ *   a named input action, or a custom event.
+ * - `perf_dip` — a run of consecutive `frame_perf` samples below `fpsThreshold`,
+ *   collapsed into one entry with the run's duration and sample count.
+ * - `error` — a `runtime_error`, message truncated.
+ * - `diagnostic` — a `graphics_diagnostic`, by category and severity.
+ * - `capability` — a `capability_change` (quality drop, tracking loss, backend
+ *   fallback).
+ * - `xr` — entering/leaving immersive input, and a boundary-proximity summary.
+ * - `end` — how the session finished (`session_end` reason), when it reported.
+ * - `summary` — the single closing entry carrying the session's totals.
+ */
+export const NARRATIVE_ENTRY_KINDS = [
+    "scene",
+    "dwell",
+    "interaction",
+    "perf_dip",
+    "error",
+    "diagnostic",
+    "capability",
+    "xr",
+    "end",
+    "summary",
+];
+/** {@link NARRATIVE_ENTRY_KINDS} as a Zod enum. */
+export const narrativeEntryKindSchema = z.enum(NARRATIVE_ENTRY_KINDS);
+/**
+ * The named things an entry points at. Deliberately only three, and all three
+ * are developer-assigned identifiers rather than anything about a person: the
+ * mesh/object name, the scene id, and the name of a custom event or input
+ * action.
+ */
+export const narrativeRefsSchema = z.object({
+    mesh: z.string().optional(),
+    scene: z.string().optional(),
+    name: z.string().optional(),
+});
+/**
+ * Session-wide totals, carried on the closing `summary` entry so a reader that
+ * only keeps the last line still knows the shape of what it just read.
+ */
+export const sessionNarrativeTotalsSchema = z.object({
+    /** Events the narrative was compacted from (every type, before filtering). */
+    events: z.number().int().nonnegative(),
+    /** Wall-clock span of the session, first to last event. */
+    durationMs: z.number().int().nonnegative(),
+    /** Distinct scene ids visited. */
+    scenes: z.number().int().nonnegative(),
+    /** Distinct mesh names the session touched or dwelled on. */
+    meshes: z.number().int().nonnegative(),
+    /** Interaction entries (mesh interactions, clicks, input actions, customs). */
+    interactions: z.number().int().nonnegative(),
+    /** Performance dips detected. */
+    dips: z.number().int().nonnegative(),
+    /** Runtime errors plus `error`/`fatal` graphics diagnostics. */
+    errors: z.number().int().nonnegative(),
+});
+/**
+ * One line of the narrative.
+ *
+ * `summary` is a **templated** one-line sentence composed from the fields
+ * already on the entry — never free text copied out of an event payload — so
+ * that what an LLM reads cannot contain anything the structured fields do not.
+ */
+export const sessionNarrativeEntrySchema = z.object({
+    /** Milliseconds since the session's first event. Never a wall-clock time. */
+    tMs: z.number().int().nonnegative(),
+    kind: narrativeEntryKindSchema,
+    /** One templated line of prose describing the entry. */
+    summary: z.string(),
+    refs: narrativeRefsSchema,
+    /** How long the entry spans, for the kinds that cover a stretch of time. */
+    durationMs: z.number().int().nonnegative().optional(),
+    /** How many source events the entry collapses (dwell samples, dip frames, …). */
+    count: z.number().int().nonnegative().optional(),
+    /** Session totals. Present on the closing `summary` entry only. */
+    totals: sessionNarrativeTotalsSchema.optional(),
+    /**
+     * Whether entries were dropped to honour `maxEntries`. Present on the closing
+     * `summary` entry only, so the bound is always visible to whoever reads the
+     * last line.
+     */
+    truncated: z.boolean().optional(),
+});
+/**
+ * The bounds and defaults every consumer shares. The collector's querystring
+ * schema, the generated tool's input schema and the compaction function all read
+ * them from here, so "the default dwell floor" is one number rather than three.
+ */
+export const NARRATIVE_LIMITS = {
+    /** Default dwell floor: below this a mesh is a glance, not attention. */
+    defaultMinDwellMs: 1_000,
+    /** Largest dwell floor a caller may ask for (one hour). */
+    maxMinDwellMs: 3_600_000,
+    /** Default FPS floor below which a frame sample counts towards a dip. */
+    defaultFpsThreshold: 30,
+    /** Largest FPS floor a caller may ask for. */
+    maxFpsThreshold: 240,
+    /**
+     * Consecutive sub-threshold `frame_perf` samples before a dip is reported.
+     * Two, so a single unlucky sample (a tab switch, a GC pause) is not a story.
+     */
+    dipMinSamples: 2,
+    /** Default entry cap — the "under 200 lines" bound issue #314 asks for. */
+    defaultMaxEntries: 200,
+    /** Hard cap: no caller can ask for an unbounded narrative (ADR 0051 §9). */
+    maxMaxEntries: 1_000,
+    /** Error/diagnostic messages are truncated to this many characters. */
+    maxMessageLength: 200,
+    /** At most this many custom-event property **keys** are listed per entry. */
+    maxCustomPropKeys: 12,
+};
+//# sourceMappingURL=narrative.js.map

package/dist/narrative.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"narrative.js","sourceRoot":"","sources":["../src/narrative.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,OAAO;IACP,OAAO;IACP,aAAa;IACb,UAAU;IACV,OAAO;IACP,YAAY;IACZ,YAAY;IACZ,IAAI;IACJ,KAAK;IACL,SAAS;CACD,CAAC;AAKX,mDAAmD;AACnD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;AAEtE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAC;AAKH;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,8EAA8E;IAC9E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACtC,2DAA2D;IAC3D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC1C,kCAAkC;IAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACtC,6DAA6D;IAC7D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACtC,+EAA+E;IAC/E,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC5C,iCAAiC;IACjC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACpC,gEAAgE;IAChE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;CACvC,CAAC,CAAC;AAKH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,6EAA6E;IAC7E,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACnC,IAAI,EAAE,wBAAwB;IAC9B,wDAAwD;IACxD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,mBAAmB;IACzB,4EAA4E;IAC5E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACrD,iFAAiF;IACjF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IAChD,mEAAmE;IACnE,MAAM,EAAE,4BAA4B,CAAC,QAAQ,EAAE;IAC/C;;;;OAIG;IACH,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAKH;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,yEAAyE;IACzE,iBAAiB,EAAE,KAAK;IACxB,2DAA2D;IAC3D,aAAa,EAAE,SAAS;IACxB,yEAAyE;IACzE,mBAAmB,EAAE,EAAE;IACvB,8CAA8C;IAC9C,eAAe,EAAE,GAAG;IACpB;;;OAGG;IACH,aAAa,EAAE,CAAC;IAChB,2EAA2E;IAC3E,iBAAiB,EAAE,GAAG;IACtB,4EAA4E;IAC5E,aAAa,EAAE,KAAK;IACpB,uEAAuE;IACvE,gBAAgB,EAAE,GAAG;IACrB,6EAA6E;IAC7E,iBAAiB,EAAE,EAAE;CACb,CAAC"}

package/dist/panelSpec.d.ts

@@ -0,0 +1,145 @@
+/**
+ * **Registry validation for declarative panel specs** (ADR 0051 §7, sketch §G.3).
+ *
+ * The same split the query DSL makes, one level up. `@uptimizr/schema`'s
+ * `panelSpecV1Schema` answers "is this a well-formed spec?" — a known chart
+ * name, bounded strings, a closed query grammar. It cannot answer the question
+ * that actually decides whether the panel will *draw anything*: does this chart
+ * suit this metric's grain, and do these encoding columns exist in its result.
+ * Those are questions about the vocabulary, and the vocabulary is this package.
+ *
+ * So {@link validatePanelSpec} runs `validateQuery` over the spec's query and
+ * then adds the two checks only the registry can make. It returns objections as
+ * data in exactly the {@link QueryIssue} shape the DSL already uses, so the
+ * collector turns a bad spec into one `400` with the same body a bad query
+ * gets, and a test can assert on codes rather than prose.
+ *
+ * ## Why the chart is checked at all
+ *
+ * Because a pinned panel is read much later than it is written. A `line` over
+ * `top_meshes` is not a crash — it is a chart with no axis to walk along, which
+ * renders as *something*, and a week later somebody reads that something as a
+ * trend. Refusing it at pin time is the only moment anybody is paying attention.
+ *
+ * ## The compatibility rules, in words
+ *
+ * - `table` — every metric. Rows are rows; this is the honest fallback and the
+ *   reason no metric is unpinnable.
+ * - `stat` — a metric whose result *is* one row: `project` grain with nothing
+ *   keying the rows. One number, big. A `stat` over a ranked list would show
+ *   the first row and silently hide the rest.
+ * - `bar` — a label to name each bar and a measure to size it, over a grain
+ *   that is a *list* rather than a grid: the ranked grains (`mesh`, `scene`,
+ *   `session`, `row`) plus `bucket`, which is what a histogram or a funnel
+ *   already is. A spatial grid's key is a coordinate, and bars of coordinates
+ *   say nothing.
+ * - `line` / `area` — an **ordered axis** to walk along: a column the registry
+ *   marks `axis`, which it guarantees is exactly the `bucket`-grain metrics
+ *   (`registry.test.ts` pins that). Everything else has an order chosen by the
+ *   query, and a line drawn through a ranking is a lie about continuity.
+ * - `heatmap2d` — a `bin` grain: the metric already bins its input into a grid,
+ *   which is the only thing the 2D heatmap canvas can paint.
+ * - `world3d` — a `voxel` grain, for the same reason in three dimensions.
+ */
+import type { PanelChartKind, PanelSpecV1, QueryV1 } from "@uptimizr/schema";
+import { type MetricDefinition, type MetricId } from "./registry.js";
+import { type QueryIssue, type QueryTier } from "./query.js";
+/** Why a panel spec was rejected. Extends the DSL's codes rather than replacing them. */
+export type PanelSpecIssueCode = 
+/** The `chart` cannot draw this metric's grain. */
+"chart_grain_mismatch"
+/** An `encoding` column the metric's result does not contain. */
+ | "unknown_encoding_column";
+/** One objection to a panel spec: a DSL issue, or one of the two above. */
+export type PanelSpecIssue = Omit<QueryIssue, "code"> & {
+    code: QueryIssue["code"] | PanelSpecIssueCode;
+};
+/** The outcome of validating a panel spec against the registry. */
+export interface PanelSpecValidation {
+    /** Empty when the spec can be stored and rendered. */
+    issues: readonly PanelSpecIssue[];
+    /** The resolved metric, when the spec's query named one it could compile. */
+    metric?: MetricDefinition;
+    /** The tier the spec's query runs on, when it resolved. */
+    tier?: QueryTier;
+}
+/**
+ * One row of the chart/grain compatibility table: which chart, what it needs,
+ * and the predicate that decides it.
+ *
+ * Declared as data rather than as a `switch` so the docs table, the validator
+ * and the `suggestChart` fallback all read from one place. `docs/` renders
+ * {@link PANEL_CHART_RULES} and `src/__tests__/panelSpec.test.ts` pins the
+ * rendering, so the published table cannot drift from the code that enforces it.
+ */
+export interface PanelChartRule {
+    chart: PanelChartKind;
+    /** What the chart needs from the metric, in words, for the error and the docs. */
+    requires: string;
+    /** Whether this metric can be drawn this way. */
+    accepts: (metric: MetricDefinition) => boolean;
+}
+/** The metric's ordered axis column, when it has one (only `bucket` grains do). */
+export declare function axisColumn(metric: MetricDefinition): string | undefined;
+/** The metric's row-naming column, when it has one. */
+export declare function labelColumn(metric: MetricDefinition): string | undefined;
+/** The metric's headline measure column, when it has one. */
+export declare function measureColumn(metric: MetricDefinition): string | undefined;
+/**
+ * The chart/grain compatibility table. The single source of truth for the
+ * validator, the docs and the `suggestChart` fallback.
+ */
+export declare const PANEL_CHART_RULES: readonly PanelChartRule[];
+/** Whether `chart` can draw `metric`. The predicate behind the table above. */
+export declare function chartSuitsMetric(chart: PanelChartKind, metric: MetricDefinition): boolean;
+/** Every chart that can draw this metric, in the table's order. */
+export declare function chartsForMetric(metric: MetricDefinition): readonly PanelChartKind[];
+/**
+ * The columns one row of this query's result carries.
+ *
+ * On the delegated tier that is the metric's declared `row` shape, unchanged —
+ * the canned builder runs and returns exactly what it always did. On the
+ * generic tier the builder projects the grouped dimensions plus the metric's
+ * declared measures instead, so the encoding has to be checked against *those*:
+ * a regrouped `top_meshes` has no `mesh` column when it was grouped by `source`.
+ */
+export declare function resultColumns(metric: MetricDefinition, query: QueryV1): readonly string[];
+/**
+ * Check a structurally-valid panel spec against the registry.
+ *
+ * Runs the DSL's own validation first — a spec whose query cannot be answered
+ * is not a panel, whatever chart it asks for — and stops there if the metric
+ * did not resolve, because every remaining check is about that metric. Chart
+ * and encoding objections are then collected together, so an agent that got
+ * both wrong learns both in one round trip.
+ */
+export declare function validatePanelSpec(spec: PanelSpecV1): PanelSpecValidation;
+/**
+ * The chart to pre-fill when an agent pins an answer it just computed.
+ *
+ * Pure, registry-only and deliberately unambitious: it reads the grain and
+ * picks the drawing that grain *is*. A voxelised metric is a world heatmap, a
+ * binned one is a 2D heatmap, a bucketed one is a line, a single record is a
+ * stat, a ranked list is bars — and anything left over is a table, which can
+ * always be drawn. The result always satisfies {@link chartSuitsMetric}, so the
+ * assistant's "Pin as panel" never proposes a spec the collector would refuse.
+ *
+ * `query` is taken so a *regrouped* metric is suggested on the shape it will
+ * actually return: `top_meshes` grouped by `source` is still a ranked list, but
+ * a generic-tier query that drops the metric's own label column should not be
+ * offered a bar it cannot name.
+ */
+export declare function suggestChart(metric: MetricDefinition | MetricId, query: QueryV1): PanelChartKind;
+/**
+ * The default encoding for a chart over a metric: the metric's own axis or
+ * label on `x`, its headline measure on `y`.
+ *
+ * Shared by the assistant's pre-fill and by the renderer's fallback when a spec
+ * carries no `encoding` at all, so "what does this panel draw when nobody said"
+ * has exactly one answer.
+ */
+export declare function defaultEncoding(metric: MetricDefinition, chart: PanelChartKind): {
+    x?: string;
+    y?: string;
+};
+//# sourceMappingURL=panelSpec.d.ts.map

package/dist/panelSpec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panelSpec.d.ts","sourceRoot":"","sources":["../src/panelSpec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAGL,KAAK,gBAAgB,EAErB,KAAK,QAAQ,EACd,MAAM,eAAe,CAAC;AACvB,OAAO,EAKL,KAAK,UAAU,EACf,KAAK,SAAS,EACf,MAAM,YAAY,CAAC;AAiBpB,yFAAyF;AACzF,MAAM,MAAM,kBAAkB;AAC5B,mDAAmD;AACjD,sBAAsB;AACxB,iEAAiE;GAC/D,yBAAyB,CAAC;AAE9B,2EAA2E;AAC3E,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG;IACtD,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,kBAAkB,CAAC;CAC/C,CAAC;AAEF,mEAAmE;AACnE,MAAM,WAAW,mBAAmB;IAClC,sDAAsD;IACtD,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC;IAClC,6EAA6E;IAC7E,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,2DAA2D;IAC3D,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,cAAc,CAAC;IACtB,kFAAkF;IAClF,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,OAAO,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC;CAChD;AAOD,mFAAmF;AACnF,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAEvE;AAED,uDAAuD;AACvD,wBAAgB,WAAW,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAExE;AAED,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAE1E;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,cAAc,EAuCtD,CAAC;AAMF,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAEzF;AAED,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,cAAc,EAAE,CAEnF;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,gBAAgB,EAAE,KAAK,EAAE,OAAO,GAAG,SAAS,MAAM,EAAE,CAYzF;AA2BD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,mBAAmB,CAuCxE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,QAAQ,EAAE,KAAK,EAAE,OAAO,GAAG,cAAc,CA8BhG;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,cAAc,GACpB;IAAE,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAU5B"}

package/dist/panelSpec.js

@@ -0,0 +1,286 @@
+/**
+ * **Registry validation for declarative panel specs** (ADR 0051 §7, sketch §G.3).
+ *
+ * The same split the query DSL makes, one level up. `@uptimizr/schema`'s
+ * `panelSpecV1Schema` answers "is this a well-formed spec?" — a known chart
+ * name, bounded strings, a closed query grammar. It cannot answer the question
+ * that actually decides whether the panel will *draw anything*: does this chart
+ * suit this metric's grain, and do these encoding columns exist in its result.
+ * Those are questions about the vocabulary, and the vocabulary is this package.
+ *
+ * So {@link validatePanelSpec} runs `validateQuery` over the spec's query and
+ * then adds the two checks only the registry can make. It returns objections as
+ * data in exactly the {@link QueryIssue} shape the DSL already uses, so the
+ * collector turns a bad spec into one `400` with the same body a bad query
+ * gets, and a test can assert on codes rather than prose.
+ *
+ * ## Why the chart is checked at all
+ *
+ * Because a pinned panel is read much later than it is written. A `line` over
+ * `top_meshes` is not a crash — it is a chart with no axis to walk along, which
+ * renders as *something*, and a week later somebody reads that something as a
+ * trend. Refusing it at pin time is the only moment anybody is paying attention.
+ *
+ * ## The compatibility rules, in words
+ *
+ * - `table` — every metric. Rows are rows; this is the honest fallback and the
+ *   reason no metric is unpinnable.
+ * - `stat` — a metric whose result *is* one row: `project` grain with nothing
+ *   keying the rows. One number, big. A `stat` over a ranked list would show
+ *   the first row and silently hide the rest.
+ * - `bar` — a label to name each bar and a measure to size it, over a grain
+ *   that is a *list* rather than a grid: the ranked grains (`mesh`, `scene`,
+ *   `session`, `row`) plus `bucket`, which is what a histogram or a funnel
+ *   already is. A spatial grid's key is a coordinate, and bars of coordinates
+ *   say nothing.
+ * - `line` / `area` — an **ordered axis** to walk along: a column the registry
+ *   marks `axis`, which it guarantees is exactly the `bucket`-grain metrics
+ *   (`registry.test.ts` pins that). Everything else has an order chosen by the
+ *   query, and a line drawn through a ranking is a lie about continuity.
+ * - `heatmap2d` — a `bin` grain: the metric already bins its input into a grid,
+ *   which is the only thing the 2D heatmap canvas can paint.
+ * - `world3d` — a `voxel` grain, for the same reason in three dimensions.
+ */
+import { getMetric, } from "./registry.js";
+import { dimensionColumn, nativeDimensions, queryTier, validateQuery, } from "./query.js";
+/**
+ * Grains whose result is a **list of named things** — the shapes a bar chart
+ * can rank. Deliberately the same set the DSL calls orderable, plus `bucket`:
+ * a histogram, a funnel and a daily count are all drawn as bars, and the DSL
+ * excludes `bucket` from *reordering* for a different reason (its order is the
+ * axis, and re-sorting it would destroy the thing being shown).
+ */
+const BAR_GRAINS = new Set([
+    "mesh",
+    "scene",
+    "session",
+    "row",
+    "bucket",
+]);
+/** Whether the metric's result is a single record rather than a list of rows. */
+function isSingleRecord(metric) {
+    return metric.grain === "project" && nativeDimensions(metric).length === 0;
+}
+/** The metric's ordered axis column, when it has one (only `bucket` grains do). */
+export function axisColumn(metric) {
+    return Object.entries(metric.columns).find(([, semantics]) => semantics.axis === true)?.[0];
+}
+/** The metric's row-naming column, when it has one. */
+export function labelColumn(metric) {
+    return Object.entries(metric.columns).find(([, semantics]) => semantics.label === true)?.[0];
+}
+/** The metric's headline measure column, when it has one. */
+export function measureColumn(metric) {
+    return Object.entries(metric.columns).find(([, semantics]) => semantics.measure === true)?.[0];
+}
+/**
+ * The chart/grain compatibility table. The single source of truth for the
+ * validator, the docs and the `suggestChart` fallback.
+ */
+export const PANEL_CHART_RULES = [
+    {
+        chart: "table",
+        requires: "nothing — any metric's rows can be listed",
+        accepts: () => true,
+    },
+    {
+        chart: "stat",
+        requires: "a single-record result (a `project`-grain metric with no grain dimensions)",
+        accepts: isSingleRecord,
+    },
+    {
+        chart: "bar",
+        requires: "a label column, a measure column, and a ranked or bucketed grain " +
+            "(`mesh`, `scene`, `session`, `row`, `bucket`)",
+        accepts: (metric) => BAR_GRAINS.has(metric.grain) && labelColumn(metric) != null && measureColumn(metric) != null,
+    },
+    {
+        chart: "line",
+        requires: "an ordered axis column — in practice a `bucket`-grain metric",
+        accepts: (metric) => axisColumn(metric) != null,
+    },
+    {
+        chart: "area",
+        requires: "an ordered axis column — in practice a `bucket`-grain metric",
+        accepts: (metric) => axisColumn(metric) != null,
+    },
+    {
+        chart: "heatmap2d",
+        requires: "a `bin` grain (the metric already bins its input into a grid)",
+        accepts: (metric) => metric.grain === "bin",
+    },
+    {
+        chart: "world3d",
+        requires: "a `voxel` grain (the metric already bins its input into world-space cells)",
+        accepts: (metric) => metric.grain === "voxel",
+    },
+];
+const RULE_BY_CHART = new Map(PANEL_CHART_RULES.map((rule) => [rule.chart, rule]));
+/** Whether `chart` can draw `metric`. The predicate behind the table above. */
+export function chartSuitsMetric(chart, metric) {
+    return RULE_BY_CHART.get(chart)?.accepts(metric) ?? false;
+}
+/** Every chart that can draw this metric, in the table's order. */
+export function chartsForMetric(metric) {
+    return PANEL_CHART_RULES.filter((rule) => rule.accepts(metric)).map((rule) => rule.chart);
+}
+/**
+ * The columns one row of this query's result carries.
+ *
+ * On the delegated tier that is the metric's declared `row` shape, unchanged —
+ * the canned builder runs and returns exactly what it always did. On the
+ * generic tier the builder projects the grouped dimensions plus the metric's
+ * declared measures instead, so the encoding has to be checked against *those*:
+ * a regrouped `top_meshes` has no `mesh` column when it was grouped by `source`.
+ */
+export function resultColumns(metric, query) {
+    const tier = queryTier(metric, query);
+    if (tier === "delegated")
+        return Object.keys(metric.row.shape);
+    // `query.dimensions` is bounded-identifier-typed by the schema (the grammar
+    // cannot know the registry's union); `validateQuery` has already rejected any
+    // that is not one of the metric's declared dimensions by the time a caller
+    // reaches here through `validatePanelSpec`.
+    const dimensions = query.dimensions ?? nativeDimensions(metric);
+    const grouped = dimensions.map((dimension) => dimensionColumn(metric, dimension));
+    const measures = (metric.genericGroupBy?.measures ?? []).map((measure) => measure.column);
+    return [...new Set([...grouped, ...measures])];
+}
+/** `` `a`, `b` `` — for a message listing what would have been accepted. */
+function list(values) {
+    return values.length === 0 ? "none" : values.map((value) => `\`${value}\``).join(", ");
+}
+/**
+ * The query a spec runs, as a `queryV1` the DSL validator understands.
+ *
+ * `range: "inherit"` is the host's business, not the registry's: whichever
+ * window is substituted, it is a window, and nothing `validateQuery` checks
+ * depends on which. Substituting a placeholder here keeps the spec validator
+ * from needing its own copy of the DSL's rules.
+ */
+function asQuery(spec) {
+    const { range, ...rest } = spec.query;
+    return {
+        ...rest,
+        range: range === "inherit" ? { since: 0, until: 1 } : range,
+        // The two keys the spec grammar drops, restored at their DSL defaults so the
+        // document `validateQuery` sees is a complete one.
+        format: "full",
+        explain: false,
+    };
+}
+/**
+ * Check a structurally-valid panel spec against the registry.
+ *
+ * Runs the DSL's own validation first — a spec whose query cannot be answered
+ * is not a panel, whatever chart it asks for — and stops there if the metric
+ * did not resolve, because every remaining check is about that metric. Chart
+ * and encoding objections are then collected together, so an agent that got
+ * both wrong learns both in one round trip.
+ */
+export function validatePanelSpec(spec) {
+    const query = asQuery(spec);
+    const { issues: queryIssues, metric, tier } = validateQuery(query);
+    const issues = queryIssues.map((issue) => ({
+        ...issue,
+        path: `query.${issue.path}`,
+    }));
+    if (!metric || tier == null)
+        return { issues };
+    // --- chart vs grain -----------------------------------------------------
+    if (!chartSuitsMetric(spec.chart, metric)) {
+        const rule = RULE_BY_CHART.get(spec.chart);
+        const alternatives = chartsForMetric(metric);
+        issues.push({
+            code: "chart_grain_mismatch",
+            path: "chart",
+            message: `"${metric.id}" cannot be drawn as a ${spec.chart}: that chart needs ${rule?.requires ?? "something this metric does not have"}, ` +
+                `and this metric's rows are one per ${metric.grain}. Draw it as ${list([...alternatives])}.`,
+            accepted: [...alternatives],
+        });
+    }
+    // --- encoding vs the result's columns -----------------------------------
+    const columns = resultColumns(metric, query);
+    const columnSet = new Set(columns);
+    for (const [channel, column] of Object.entries(spec.encoding ?? {})) {
+        if (column == null || columnSet.has(column))
+            continue;
+        issues.push({
+            code: "unknown_encoding_column",
+            path: `encoding.${channel}`,
+            message: `"${metric.id}" returns no column "${column}"${tier === "generic" ? " when grouped this way" : ""}. Its result columns are ${list(columns)}.`,
+            accepted: columns,
+        });
+    }
+    return { issues, metric, tier };
+}
+/**
+ * The chart to pre-fill when an agent pins an answer it just computed.
+ *
+ * Pure, registry-only and deliberately unambitious: it reads the grain and
+ * picks the drawing that grain *is*. A voxelised metric is a world heatmap, a
+ * binned one is a 2D heatmap, a bucketed one is a line, a single record is a
+ * stat, a ranked list is bars — and anything left over is a table, which can
+ * always be drawn. The result always satisfies {@link chartSuitsMetric}, so the
+ * assistant's "Pin as panel" never proposes a spec the collector would refuse.
+ *
+ * `query` is taken so a *regrouped* metric is suggested on the shape it will
+ * actually return: `top_meshes` grouped by `source` is still a ranked list, but
+ * a generic-tier query that drops the metric's own label column should not be
+ * offered a bar it cannot name.
+ */
+export function suggestChart(metric, query) {
+    const resolved = typeof metric === "string" ? getMetric(metric) : metric;
+    if (resolved == null)
+        return "table";
+    const columns = new Set(resultColumns(resolved, query));
+    const preference = [
+        "world3d",
+        "heatmap2d",
+        "stat",
+        "line",
+        "bar",
+        "table",
+    ];
+    for (const chart of preference) {
+        if (!chartSuitsMetric(chart, resolved))
+            continue;
+        // A generic-tier regrouping can project away the very column the chart
+        // would have been drawn from, so the suggestion is checked against the
+        // columns the query really returns rather than against the metric's own.
+        if (chart === "bar") {
+            const label = labelColumn(resolved);
+            const measure = measureColumn(resolved);
+            if (label == null || measure == null)
+                continue;
+            if (!columns.has(label) || !columns.has(measure))
+                continue;
+        }
+        if (chart === "line") {
+            const axis = axisColumn(resolved);
+            if (axis == null || !columns.has(axis))
+                continue;
+        }
+        return chart;
+    }
+    return "table";
+}
+/**
+ * The default encoding for a chart over a metric: the metric's own axis or
+ * label on `x`, its headline measure on `y`.
+ *
+ * Shared by the assistant's pre-fill and by the renderer's fallback when a spec
+ * carries no `encoding` at all, so "what does this panel draw when nobody said"
+ * has exactly one answer.
+ */
+export function defaultEncoding(metric, chart) {
+    const measure = measureColumn(metric);
+    const x = chart === "line" || chart === "area"
+        ? (axisColumn(metric) ?? labelColumn(metric))
+        : labelColumn(metric);
+    return {
+        ...(x != null ? { x } : {}),
+        ...(measure != null ? { y: measure } : {}),
+    };
+}
+//# sourceMappingURL=panelSpec.js.map

package/dist/panelSpec.js.map

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