@bitcobblers/wod-wiki-wql 0.7.37 → 0.8.39

package/dist/index.d.cts

@@ -61,6 +61,23 @@ type WqlFindTarget = (typeof WQL_FIND_TARGETS)[number];
 /** Content query scopes (in <scope>). */
 declare const WQL_SCOPES: readonly ["journal", "collections", "feeds", "all"];
 type WqlScope = (typeof WQL_SCOPES)[number];
+/** Result planes — `rows:<plane>` narrows raw output-statement rows by the
+ *  unified store's promoted `outputType` column. The STORE vocabulary is
+ *  open (core KNOWN_OUTPUT_TYPES, ticket 002: unknowns are stored and
+ *  returned); the QUERY surface is a closed enum at parse (prototype C7) —
+ *  reopening toward a registry is a later, separate decision. Custom types
+ *  stay addressable programmatically via hand-built ASTs. */
+declare const WQL_RESULT_PLANES: readonly ["segment", "system", "load", "event", "compiler", "completion", "analytics", "wellness"];
+type WqlResultPlane = (typeof WQL_RESULT_PLANES)[number];
+/** All `rows:` targets — content planes plus result planes (rows model
+ *  §1.0: every query selects rows from a target) plus `all`, the explicit
+ *  no-narrowing pseudo-target (spec v2 decision 1: the bare `rows:{…}`
+ *  alias retires). Content-plane targets scope by content, not outputType
+ *  (C4). */
+declare const WQL_ROWS_TARGETS: readonly ["note", "block", "effort", "segment", "system", "load", "event", "compiler", "completion", "analytics", "wellness", "all"];
+type WqlRowsTarget = (typeof WQL_ROWS_TARGETS)[number];
+/** Rows scope filter keys (C4): the exact-match keys a rows query filters by. */
+declare const WQL_ROWS_SCOPE_KEYS: readonly ["result", "block", "note"];
 /** Content-specific filter keys (beyond the analytics tag keys). */
 declare const WQL_CONTENT_FILTER_KEYS: readonly ["type", "text", "has", "source", "catalog", "effort", "discipline", "intensity", "note", "page", "origin", "grain", "metric", "block", "result", "tags"];
 type WqlContentFilterKey = (typeof WQL_CONTENT_FILTER_KEYS)[number];
@@ -238,7 +255,12 @@ interface FindPredicate {
         unit: 'd' | 'w';
     };
 }
-interface ParsedQuery {
+/**
+ * Result of parsing an analytics (aggregate) query — `agg:metric{filters} …`.
+ * Discriminated union member: `family === 'aggregate'` (C5).
+ */
+interface ParsedAggregateQuery {
+    family: 'aggregate';
     raw: string;
     agg: Aggregator;
     /** Canonical Metric Key (fact row `metricKey`). */
@@ -258,8 +280,9 @@ interface ParsedQuery {
 }
 /** Result of parsing a content-discovery query (`find:target{filters} in scope`). */
 interface ParsedFindQuery {
+    family: 'find';
     raw: string;
-    /** Content target: 'note' or 'block'. */
+    /** Content target — a WQL_FIND_TARGETS value (C7 closed enum). */
     target: string;
     filters: TagFilter[];
     /** Where to look: journal | collections | feeds | all. */
@@ -273,11 +296,13 @@ interface ParsedFindQuery {
     join?: MetricPredicate;
     error?: string;
 }
-type AnyParsedQuery = ParsedQuery | ParsedFindQuery | ParsedRowsQuery;
+type AnyParsedQuery = ParsedAggregateQuery | ParsedFindQuery | ParsedRowsQuery;
 /** Type guard: true for content-discovery queries. */
 declare function isFindQuery(parsed: AnyParsedQuery): parsed is ParsedFindQuery;
 /** Type guard: true for rows queries. */
 declare function isRowsQuery(parsed: AnyParsedQuery): parsed is ParsedRowsQuery;
+/** Type guard: true for analytics (aggregate) queries. */
+declare function isAggregateQuery(parsed: AnyParsedQuery): parsed is ParsedAggregateQuery;
 interface SeriesPoint {
     ts: number;
     value: number;
@@ -290,7 +315,7 @@ interface SeriesPoint {
  */
 interface ParsedRowsQuery {
     raw: string;
-    /** Family discriminator (the other families are told apart by 'target'/'agg'). */
+    /** Family discriminator shared by all three query ASTs (C5). */
     family: 'rows';
     /** Output-statement type narrowing from the optional target (`rows:segment{…}`); undefined = all types. */
     outputType?: string;
@@ -309,9 +334,10 @@ interface Series {
     unit?: string;
 }
 /**
- * Parse a WQL query string into either an analytics ParsedQuery or a content
- * ParsedFindQuery. Dispatch is textual: a leading `find:` routes to the
- * content path, everything else to analytics.
+ * Parse a WQL query string into one of the three query families —
+ * analytics aggregate, content find, or rows — discriminated by `family`
+ * (C5). Dispatch is textual: a leading `find:` routes to the content path,
+ * `rows` to the rows path, everything else to analytics.
  */
 declare function parseQuery(raw: string): AnyParsedQuery;
 
@@ -632,7 +658,7 @@ interface FindOptions {
     anchorNow?: number;
 }
 interface QueryResult {
-    parsed: ParsedQuery;
+    parsed: ParsedAggregateQuery;
     series: Series[];
     stages: {
         selected: number;
@@ -672,9 +698,10 @@ declare class QueryService {
     getFactsByTimeRange(start: number, end: number): Promise<AnalyticsDataPoint[]>;
     runQuery(raw: string, options?: QueryOptions): Promise<QueryResult>;
     /**
-     * Execute a rows query (rows:{…}, #949) — the session results table plane.
-     * Reads event rows directly over the unified store (ticket 003): no
-     * WorkoutResult blob parsing; outputType narrowing hits the promoted column.
+     * Execute a rows query (rows:<target>{…}, #949/C4) — the session results
+     * table plane. Filter rules are validated at parse; this executes only.
+     * Reads event rows directly over the unified store: outputType narrowing
+     * hits the promoted column; content-plane targets scope by content.
      */
     runRows(parsed: ParsedRowsQuery, options?: {
         anchorNow?: number;
@@ -693,7 +720,7 @@ declare class QueryService {
      * Execute a find:effort query against the effort registry.
      */
     runFindEffort(parsed: ParsedFindQuery): Promise<FindQueryResult>;
-    run(parsed: ParsedQuery, options?: QueryOptions): Promise<QueryResult>;
+    run(parsed: ParsedAggregateQuery, options?: QueryOptions): Promise<QueryResult>;
     /**
      * Stages 2–4 — BUCKET → GROUP → AGGREGATE over an already-selected +
      * filtered `matched` set.
@@ -947,13 +974,13 @@ declare function parseFrontmatterProps(lines: string[]): Record<string, string>;
  * Auto-generated build version metadata.
  * Do not edit directly; updated by scripts/stamp-version.ts
  */
-declare const VERSION = "0.7.37";
-declare const GIT_SHA = "713c593";
-declare const BUILD_TIME = "2026-08-25T00:18:25.714Z";
+declare const VERSION = "0.8.39";
+declare const GIT_SHA = "3c19185";
+declare const BUILD_TIME = "2026-08-26T00:07:31.934Z";
 declare const SEMVER: {
-    readonly version: "0.7.37";
-    readonly gitSha: "713c593";
-    readonly buildTime: "2026-08-25T00:18:25.714Z";
+    readonly version: "0.8.39";
+    readonly gitSha: "3c19185";
+    readonly buildTime: "2026-08-26T00:07:31.934Z";
 };
 
-export { type Aggregator, type AnyParsedQuery, BUILD_TIME, type BlockQueryStore, type ComparisonOp, DASHBOARD_GRID_MAX_COLS, DASHBOARD_WIDGET_TYPES, DEFAULT_DASHBOARD_TITLE, DISCIPLINE_FACTORS, type DashboardDocument, type DashboardMeta, type DashboardParsedSection, type DashboardSectionInput, type DashboardToken, type DashboardWidget, type DashboardWidgetType, EFFORT_DISCIPLINES, type EffortDiscipline, type EffortQueryStore, type EventRowIdentity, type FindOptions, type FindPredicate, type FindQueryResult, GIT_SHA, type IEffort, KG_PER_LB, type LinkWidget, type MetricPredicate, type NoteQueryStore, PLANNED_WIDGET_TYPES, type ParsedFindQuery, type ParsedFrontmatter, type ParsedQuery, type ParsedRowsQuery, type ParsedWqlLastSuffix, type ParsedWqlRollupSuffix, type ParsedWqlSuffixes, type QueryOptions, type QueryResult, QueryService, type QueryServiceStores, type QueryWidgetSuffix, type RowsQueryResult, type RowsRun, SEMVER, type Series, type SeriesPoint, type SummaryFactIdentity, type SummaryFactSourceOutput, type TagFilter, type TagValue, UNIT_FAMILIES, type UnifiedEventStore, type UnitFamily, type UnitFamilyDef, VERSION, WQL_AGGREGATORS, WQL_CALC_TARGETS, WQL_COMPARISON_OPS, WQL_CONTENT_FILTER_KEYS, WQL_DISPLAY_UNITS, WQL_FIND_TARGETS, WQL_GRAINS, WQL_INTENSITY_TIERS, WQL_KEYWORDS, WQL_METRIC_AGGREGATES, WQL_METRIC_FAMILIES, WQL_ROLLUP_PERIODS, WQL_SCOPES, WQL_SOURCES, WQL_TAG_KEYS, WQL_VIRTUAL_DIMS, type WqlAggregator, type WqlCalcTarget, type WqlComparisonOp, type WqlCompletionOptions, type WqlContentFilterKey, type WqlDisplayUnit, type WqlFindTarget, type WqlGrain, type WqlIntensityTier, type WqlKeyword, type WqlMetricAggregate, type WqlMetricFamily, type WqlRollupPeriod, type WqlScope, type WqlSource, type WqlTagKey, type WqlVirtualDim, buildDashboardDocument, buildDashboardScaffold, convert, dashboardSlug, defaultTokenValues, disciplineFactorFor, extractDashboardTokens, extractFrontmatterTags, getList, getScalar, getUnitFamily, isDashboardMeta, isDashboardWidgetType, isEffortDiscipline, isFindQuery, isProposedMetric, isRowsQuery, normalizeSummaryFacts, parseDashboardNote, parseFlatProperties, parseFrontmatter, parseFrontmatterBody, parseFrontmatterCategories, parseFrontmatterProps, parseQuery, parseQueryWidgetSuffix, parseWqlSuffixes, projectEventToFacts, referencedTokens, resolveCanonicalMetricKey, resolveDisplayUnit, resolveWidgetType, serializeFrontmatter, setDashboardTokenValue, splitAtWhere, splitWidgetBody, staticNotesFromBlocks, staticTagIndexFromBlocks, stripFrontmatter, substituteTokens, toEventRows, toSummaryEventRows, unknownTokensMessage, unknownWidgetTypeMessage, wql, wqlCompletion, wqlCompletionSource, wqlHighlightStyle, wqlLanguage, parser as wqlParser, wql_parser_terms as wqlTerms };
+export { type Aggregator, type AnyParsedQuery, BUILD_TIME, type BlockQueryStore, type ComparisonOp, DASHBOARD_GRID_MAX_COLS, DASHBOARD_WIDGET_TYPES, DEFAULT_DASHBOARD_TITLE, DISCIPLINE_FACTORS, type DashboardDocument, type DashboardMeta, type DashboardParsedSection, type DashboardSectionInput, type DashboardToken, type DashboardWidget, type DashboardWidgetType, EFFORT_DISCIPLINES, type EffortDiscipline, type EffortQueryStore, type EventRowIdentity, type FindOptions, type FindPredicate, type FindQueryResult, GIT_SHA, type IEffort, KG_PER_LB, type LinkWidget, type MetricPredicate, type NoteQueryStore, PLANNED_WIDGET_TYPES, type ParsedAggregateQuery, type ParsedFindQuery, type ParsedFrontmatter, type ParsedRowsQuery, type ParsedWqlLastSuffix, type ParsedWqlRollupSuffix, type ParsedWqlSuffixes, type QueryOptions, type QueryResult, QueryService, type QueryServiceStores, type QueryWidgetSuffix, type RowsQueryResult, type RowsRun, SEMVER, type Series, type SeriesPoint, type SummaryFactIdentity, type SummaryFactSourceOutput, type TagFilter, type TagValue, UNIT_FAMILIES, type UnifiedEventStore, type UnitFamily, type UnitFamilyDef, VERSION, WQL_AGGREGATORS, WQL_CALC_TARGETS, WQL_COMPARISON_OPS, WQL_CONTENT_FILTER_KEYS, WQL_DISPLAY_UNITS, WQL_FIND_TARGETS, WQL_GRAINS, WQL_INTENSITY_TIERS, WQL_KEYWORDS, WQL_METRIC_AGGREGATES, WQL_METRIC_FAMILIES, WQL_RESULT_PLANES, WQL_ROLLUP_PERIODS, WQL_ROWS_SCOPE_KEYS, WQL_ROWS_TARGETS, WQL_SCOPES, WQL_SOURCES, WQL_TAG_KEYS, WQL_VIRTUAL_DIMS, type WqlAggregator, type WqlCalcTarget, type WqlComparisonOp, type WqlCompletionOptions, type WqlContentFilterKey, type WqlDisplayUnit, type WqlFindTarget, type WqlGrain, type WqlIntensityTier, type WqlKeyword, type WqlMetricAggregate, type WqlMetricFamily, type WqlResultPlane, type WqlRollupPeriod, type WqlRowsTarget, type WqlScope, type WqlSource, type WqlTagKey, type WqlVirtualDim, buildDashboardDocument, buildDashboardScaffold, convert, dashboardSlug, defaultTokenValues, disciplineFactorFor, extractDashboardTokens, extractFrontmatterTags, getList, getScalar, getUnitFamily, isAggregateQuery, isDashboardMeta, isDashboardWidgetType, isEffortDiscipline, isFindQuery, isProposedMetric, isRowsQuery, normalizeSummaryFacts, parseDashboardNote, parseFlatProperties, parseFrontmatter, parseFrontmatterBody, parseFrontmatterCategories, parseFrontmatterProps, parseQuery, parseQueryWidgetSuffix, parseWqlSuffixes, projectEventToFacts, referencedTokens, resolveCanonicalMetricKey, resolveDisplayUnit, resolveWidgetType, serializeFrontmatter, setDashboardTokenValue, splitAtWhere, splitWidgetBody, staticNotesFromBlocks, staticTagIndexFromBlocks, stripFrontmatter, substituteTokens, toEventRows, toSummaryEventRows, unknownTokensMessage, unknownWidgetTypeMessage, wql, wqlCompletion, wqlCompletionSource, wqlHighlightStyle, wqlLanguage, parser as wqlParser, wql_parser_terms as wqlTerms };

package/dist/index.d.ts

@@ -61,6 +61,23 @@ type WqlFindTarget = (typeof WQL_FIND_TARGETS)[number];
 /** Content query scopes (in <scope>). */
 declare const WQL_SCOPES: readonly ["journal", "collections", "feeds", "all"];
 type WqlScope = (typeof WQL_SCOPES)[number];
+/** Result planes — `rows:<plane>` narrows raw output-statement rows by the
+ *  unified store's promoted `outputType` column. The STORE vocabulary is
+ *  open (core KNOWN_OUTPUT_TYPES, ticket 002: unknowns are stored and
+ *  returned); the QUERY surface is a closed enum at parse (prototype C7) —
+ *  reopening toward a registry is a later, separate decision. Custom types
+ *  stay addressable programmatically via hand-built ASTs. */
+declare const WQL_RESULT_PLANES: readonly ["segment", "system", "load", "event", "compiler", "completion", "analytics", "wellness"];
+type WqlResultPlane = (typeof WQL_RESULT_PLANES)[number];
+/** All `rows:` targets — content planes plus result planes (rows model
+ *  §1.0: every query selects rows from a target) plus `all`, the explicit
+ *  no-narrowing pseudo-target (spec v2 decision 1: the bare `rows:{…}`
+ *  alias retires). Content-plane targets scope by content, not outputType
+ *  (C4). */
+declare const WQL_ROWS_TARGETS: readonly ["note", "block", "effort", "segment", "system", "load", "event", "compiler", "completion", "analytics", "wellness", "all"];
+type WqlRowsTarget = (typeof WQL_ROWS_TARGETS)[number];
+/** Rows scope filter keys (C4): the exact-match keys a rows query filters by. */
+declare const WQL_ROWS_SCOPE_KEYS: readonly ["result", "block", "note"];
 /** Content-specific filter keys (beyond the analytics tag keys). */
 declare const WQL_CONTENT_FILTER_KEYS: readonly ["type", "text", "has", "source", "catalog", "effort", "discipline", "intensity", "note", "page", "origin", "grain", "metric", "block", "result", "tags"];
 type WqlContentFilterKey = (typeof WQL_CONTENT_FILTER_KEYS)[number];
@@ -238,7 +255,12 @@ interface FindPredicate {
         unit: 'd' | 'w';
     };
 }
-interface ParsedQuery {
+/**
+ * Result of parsing an analytics (aggregate) query — `agg:metric{filters} …`.
+ * Discriminated union member: `family === 'aggregate'` (C5).
+ */
+interface ParsedAggregateQuery {
+    family: 'aggregate';
     raw: string;
     agg: Aggregator;
     /** Canonical Metric Key (fact row `metricKey`). */
@@ -258,8 +280,9 @@ interface ParsedQuery {
 }
 /** Result of parsing a content-discovery query (`find:target{filters} in scope`). */
 interface ParsedFindQuery {
+    family: 'find';
     raw: string;
-    /** Content target: 'note' or 'block'. */
+    /** Content target — a WQL_FIND_TARGETS value (C7 closed enum). */
     target: string;
     filters: TagFilter[];
     /** Where to look: journal | collections | feeds | all. */
@@ -273,11 +296,13 @@ interface ParsedFindQuery {
     join?: MetricPredicate;
     error?: string;
 }
-type AnyParsedQuery = ParsedQuery | ParsedFindQuery | ParsedRowsQuery;
+type AnyParsedQuery = ParsedAggregateQuery | ParsedFindQuery | ParsedRowsQuery;
 /** Type guard: true for content-discovery queries. */
 declare function isFindQuery(parsed: AnyParsedQuery): parsed is ParsedFindQuery;
 /** Type guard: true for rows queries. */
 declare function isRowsQuery(parsed: AnyParsedQuery): parsed is ParsedRowsQuery;
+/** Type guard: true for analytics (aggregate) queries. */
+declare function isAggregateQuery(parsed: AnyParsedQuery): parsed is ParsedAggregateQuery;
 interface SeriesPoint {
     ts: number;
     value: number;
@@ -290,7 +315,7 @@ interface SeriesPoint {
  */
 interface ParsedRowsQuery {
     raw: string;
-    /** Family discriminator (the other families are told apart by 'target'/'agg'). */
+    /** Family discriminator shared by all three query ASTs (C5). */
     family: 'rows';
     /** Output-statement type narrowing from the optional target (`rows:segment{…}`); undefined = all types. */
     outputType?: string;
@@ -309,9 +334,10 @@ interface Series {
     unit?: string;
 }
 /**
- * Parse a WQL query string into either an analytics ParsedQuery or a content
- * ParsedFindQuery. Dispatch is textual: a leading `find:` routes to the
- * content path, everything else to analytics.
+ * Parse a WQL query string into one of the three query families —
+ * analytics aggregate, content find, or rows — discriminated by `family`
+ * (C5). Dispatch is textual: a leading `find:` routes to the content path,
+ * `rows` to the rows path, everything else to analytics.
  */
 declare function parseQuery(raw: string): AnyParsedQuery;
 
@@ -632,7 +658,7 @@ interface FindOptions {
     anchorNow?: number;
 }
 interface QueryResult {
-    parsed: ParsedQuery;
+    parsed: ParsedAggregateQuery;
     series: Series[];
     stages: {
         selected: number;
@@ -672,9 +698,10 @@ declare class QueryService {
     getFactsByTimeRange(start: number, end: number): Promise<AnalyticsDataPoint[]>;
     runQuery(raw: string, options?: QueryOptions): Promise<QueryResult>;
     /**
-     * Execute a rows query (rows:{…}, #949) — the session results table plane.
-     * Reads event rows directly over the unified store (ticket 003): no
-     * WorkoutResult blob parsing; outputType narrowing hits the promoted column.
+     * Execute a rows query (rows:<target>{…}, #949/C4) — the session results
+     * table plane. Filter rules are validated at parse; this executes only.
+     * Reads event rows directly over the unified store: outputType narrowing
+     * hits the promoted column; content-plane targets scope by content.
      */
     runRows(parsed: ParsedRowsQuery, options?: {
         anchorNow?: number;
@@ -693,7 +720,7 @@ declare class QueryService {
      * Execute a find:effort query against the effort registry.
      */
     runFindEffort(parsed: ParsedFindQuery): Promise<FindQueryResult>;
-    run(parsed: ParsedQuery, options?: QueryOptions): Promise<QueryResult>;
+    run(parsed: ParsedAggregateQuery, options?: QueryOptions): Promise<QueryResult>;
     /**
      * Stages 2–4 — BUCKET → GROUP → AGGREGATE over an already-selected +
      * filtered `matched` set.
@@ -947,13 +974,13 @@ declare function parseFrontmatterProps(lines: string[]): Record<string, string>;
  * Auto-generated build version metadata.
  * Do not edit directly; updated by scripts/stamp-version.ts
  */
-declare const VERSION = "0.7.37";
-declare const GIT_SHA = "713c593";
-declare const BUILD_TIME = "2026-08-25T00:18:25.714Z";
+declare const VERSION = "0.8.39";
+declare const GIT_SHA = "3c19185";
+declare const BUILD_TIME = "2026-08-26T00:07:31.934Z";
 declare const SEMVER: {
-    readonly version: "0.7.37";
-    readonly gitSha: "713c593";
-    readonly buildTime: "2026-08-25T00:18:25.714Z";
+    readonly version: "0.8.39";
+    readonly gitSha: "3c19185";
+    readonly buildTime: "2026-08-26T00:07:31.934Z";
 };
 
-export { type Aggregator, type AnyParsedQuery, BUILD_TIME, type BlockQueryStore, type ComparisonOp, DASHBOARD_GRID_MAX_COLS, DASHBOARD_WIDGET_TYPES, DEFAULT_DASHBOARD_TITLE, DISCIPLINE_FACTORS, type DashboardDocument, type DashboardMeta, type DashboardParsedSection, type DashboardSectionInput, type DashboardToken, type DashboardWidget, type DashboardWidgetType, EFFORT_DISCIPLINES, type EffortDiscipline, type EffortQueryStore, type EventRowIdentity, type FindOptions, type FindPredicate, type FindQueryResult, GIT_SHA, type IEffort, KG_PER_LB, type LinkWidget, type MetricPredicate, type NoteQueryStore, PLANNED_WIDGET_TYPES, type ParsedFindQuery, type ParsedFrontmatter, type ParsedQuery, type ParsedRowsQuery, type ParsedWqlLastSuffix, type ParsedWqlRollupSuffix, type ParsedWqlSuffixes, type QueryOptions, type QueryResult, QueryService, type QueryServiceStores, type QueryWidgetSuffix, type RowsQueryResult, type RowsRun, SEMVER, type Series, type SeriesPoint, type SummaryFactIdentity, type SummaryFactSourceOutput, type TagFilter, type TagValue, UNIT_FAMILIES, type UnifiedEventStore, type UnitFamily, type UnitFamilyDef, VERSION, WQL_AGGREGATORS, WQL_CALC_TARGETS, WQL_COMPARISON_OPS, WQL_CONTENT_FILTER_KEYS, WQL_DISPLAY_UNITS, WQL_FIND_TARGETS, WQL_GRAINS, WQL_INTENSITY_TIERS, WQL_KEYWORDS, WQL_METRIC_AGGREGATES, WQL_METRIC_FAMILIES, WQL_ROLLUP_PERIODS, WQL_SCOPES, WQL_SOURCES, WQL_TAG_KEYS, WQL_VIRTUAL_DIMS, type WqlAggregator, type WqlCalcTarget, type WqlComparisonOp, type WqlCompletionOptions, type WqlContentFilterKey, type WqlDisplayUnit, type WqlFindTarget, type WqlGrain, type WqlIntensityTier, type WqlKeyword, type WqlMetricAggregate, type WqlMetricFamily, type WqlRollupPeriod, type WqlScope, type WqlSource, type WqlTagKey, type WqlVirtualDim, buildDashboardDocument, buildDashboardScaffold, convert, dashboardSlug, defaultTokenValues, disciplineFactorFor, extractDashboardTokens, extractFrontmatterTags, getList, getScalar, getUnitFamily, isDashboardMeta, isDashboardWidgetType, isEffortDiscipline, isFindQuery, isProposedMetric, isRowsQuery, normalizeSummaryFacts, parseDashboardNote, parseFlatProperties, parseFrontmatter, parseFrontmatterBody, parseFrontmatterCategories, parseFrontmatterProps, parseQuery, parseQueryWidgetSuffix, parseWqlSuffixes, projectEventToFacts, referencedTokens, resolveCanonicalMetricKey, resolveDisplayUnit, resolveWidgetType, serializeFrontmatter, setDashboardTokenValue, splitAtWhere, splitWidgetBody, staticNotesFromBlocks, staticTagIndexFromBlocks, stripFrontmatter, substituteTokens, toEventRows, toSummaryEventRows, unknownTokensMessage, unknownWidgetTypeMessage, wql, wqlCompletion, wqlCompletionSource, wqlHighlightStyle, wqlLanguage, parser as wqlParser, wql_parser_terms as wqlTerms };
+export { type Aggregator, type AnyParsedQuery, BUILD_TIME, type BlockQueryStore, type ComparisonOp, DASHBOARD_GRID_MAX_COLS, DASHBOARD_WIDGET_TYPES, DEFAULT_DASHBOARD_TITLE, DISCIPLINE_FACTORS, type DashboardDocument, type DashboardMeta, type DashboardParsedSection, type DashboardSectionInput, type DashboardToken, type DashboardWidget, type DashboardWidgetType, EFFORT_DISCIPLINES, type EffortDiscipline, type EffortQueryStore, type EventRowIdentity, type FindOptions, type FindPredicate, type FindQueryResult, GIT_SHA, type IEffort, KG_PER_LB, type LinkWidget, type MetricPredicate, type NoteQueryStore, PLANNED_WIDGET_TYPES, type ParsedAggregateQuery, type ParsedFindQuery, type ParsedFrontmatter, type ParsedRowsQuery, type ParsedWqlLastSuffix, type ParsedWqlRollupSuffix, type ParsedWqlSuffixes, type QueryOptions, type QueryResult, QueryService, type QueryServiceStores, type QueryWidgetSuffix, type RowsQueryResult, type RowsRun, SEMVER, type Series, type SeriesPoint, type SummaryFactIdentity, type SummaryFactSourceOutput, type TagFilter, type TagValue, UNIT_FAMILIES, type UnifiedEventStore, type UnitFamily, type UnitFamilyDef, VERSION, WQL_AGGREGATORS, WQL_CALC_TARGETS, WQL_COMPARISON_OPS, WQL_CONTENT_FILTER_KEYS, WQL_DISPLAY_UNITS, WQL_FIND_TARGETS, WQL_GRAINS, WQL_INTENSITY_TIERS, WQL_KEYWORDS, WQL_METRIC_AGGREGATES, WQL_METRIC_FAMILIES, WQL_RESULT_PLANES, WQL_ROLLUP_PERIODS, WQL_ROWS_SCOPE_KEYS, WQL_ROWS_TARGETS, WQL_SCOPES, WQL_SOURCES, WQL_TAG_KEYS, WQL_VIRTUAL_DIMS, type WqlAggregator, type WqlCalcTarget, type WqlComparisonOp, type WqlCompletionOptions, type WqlContentFilterKey, type WqlDisplayUnit, type WqlFindTarget, type WqlGrain, type WqlIntensityTier, type WqlKeyword, type WqlMetricAggregate, type WqlMetricFamily, type WqlResultPlane, type WqlRollupPeriod, type WqlRowsTarget, type WqlScope, type WqlSource, type WqlTagKey, type WqlVirtualDim, buildDashboardDocument, buildDashboardScaffold, convert, dashboardSlug, defaultTokenValues, disciplineFactorFor, extractDashboardTokens, extractFrontmatterTags, getList, getScalar, getUnitFamily, isAggregateQuery, isDashboardMeta, isDashboardWidgetType, isEffortDiscipline, isFindQuery, isProposedMetric, isRowsQuery, normalizeSummaryFacts, parseDashboardNote, parseFlatProperties, parseFrontmatter, parseFrontmatterBody, parseFrontmatterCategories, parseFrontmatterProps, parseQuery, parseQueryWidgetSuffix, parseWqlSuffixes, projectEventToFacts, referencedTokens, resolveCanonicalMetricKey, resolveDisplayUnit, resolveWidgetType, serializeFrontmatter, setDashboardTokenValue, splitAtWhere, splitWidgetBody, staticNotesFromBlocks, staticTagIndexFromBlocks, stripFrontmatter, substituteTokens, toEventRows, toSummaryEventRows, unknownTokensMessage, unknownWidgetTypeMessage, wql, wqlCompletion, wqlCompletionSource, wqlHighlightStyle, wqlLanguage, parser as wqlParser, wql_parser_terms as wqlTerms };

package/dist/index.mjs

@@ -1,16 +1,14 @@
+import { KNOWN_OUTPUT_TYPES, MetricType } from '@bitcobblers/wod-wiki-core';
 import { LRParser } from '@lezer/lr';
 import { LRLanguage, HighlightStyle, LanguageSupport, syntaxHighlighting, syntaxTree } from '@codemirror/language';
 import { autocompletion, snippetCompletion } from '@codemirror/autocomplete';
 import { styleTags, tags } from '@lezer/highlight';
-import { MetricType } from '@bitcobblers/wod-wiki-core';
 
 var __defProp = Object.defineProperty;
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
 };
-
-// src/vocabulary.ts
 var WQL_METRIC_FAMILIES = ["reps", "distance", "resistance", "elapsed", "power", "pace"];
 var WQL_METRIC_AGGREGATES = ["totalVolume", "totalDistance", "tis", "sessionLoad"];
 var WQL_AGGREGATORS = ["sum", "avg", "min", "max", "count", "last", "delta"];
@@ -56,6 +54,9 @@ var WQL_INTENSITY_TIERS = ["low", "moderate", "high"];
 var WQL_GRAINS = ["summary", "event"];
 var WQL_FIND_TARGETS = ["note", "block", "effort"];
 var WQL_SCOPES = ["journal", "collections", "feeds", "all"];
+var WQL_RESULT_PLANES = KNOWN_OUTPUT_TYPES;
+var WQL_ROWS_TARGETS = [...WQL_FIND_TARGETS, ...WQL_RESULT_PLANES, "all"];
+var WQL_ROWS_SCOPE_KEYS = ["result", "block", "note"];
 var WQL_CONTENT_FILTER_KEYS = ["type", "text", "has", "source", "catalog", ...WQL_TAG_KEYS];
 var WQL_SOURCES = ["journal", "collections", "feeds", "notes", "blocks", "efforts", "metrics"];
 var WQL_ROLLUP_PERIODS = ["1d", "1w"];
@@ -232,11 +233,14 @@ function parseWqlSuffixes(raw) {
 
 // src/wql.ts
 function isFindQuery(parsed) {
-  return "target" in parsed;
+  return parsed.family === "find";
 }
 function isRowsQuery(parsed) {
   return parsed.family === "rows";
 }
+function isAggregateQuery(parsed) {
+  return parsed.family === "aggregate";
+}
 var AGGS = WQL_AGGREGATORS;
 function cannotParse(text) {
   return `Cannot parse "${text}". Expected agg:metric{filters} by {dims} .rollup(period)`;
@@ -276,14 +280,28 @@ function parseQuery(raw) {
   return parseAnalyticsQuery(raw);
 }
 function cannotParseRows(text) {
-  return `Cannot parse "${text}". Expected rows:{result:\u2026|block:\u2026|note:\u2026} or rows:segment{\u2026} last 8w`;
+  return `Cannot parse "${text}". Expected rows:all{result:\u2026|block:\u2026|note:\u2026}, rows:<plane>{\u2026}, or rows:segment{\u2026} last 8w`;
+}
+function validateRowsFilters(filters) {
+  const scopeKeys = new Set(WQL_ROWS_SCOPE_KEYS);
+  const unsupported = filters.filter(
+    (f) => !scopeKeys.has(f.key) || f.negate || f.values.some((v) => v.wildcard)
+  );
+  if (unsupported.length > 0) {
+    return `Unsupported rows filter(s): ${unsupported.map((f) => (f.negate ? "!" : "") + f.key).join(", ")}. Rows queries support exact ${WQL_ROWS_SCOPE_KEYS.map((k) => `${k}:`).join(", ")} values.`;
+  }
+  if (!filters.some((f) => scopeKeys.has(f.key))) {
+    return `Rows query needs a scope: ${WQL_ROWS_SCOPE_KEYS.map((k) => `${k}:`).join(", ")}.`;
+  }
+  return void 0;
 }
+var BARE_ROWS_RETIRED = 'Bare "rows:" is retired \u2014 name a target: rows:all{\u2026} for every output type, or a plane like rows:segment{\u2026}.';
 function parseRowsQuery(raw) {
   const suffixes = parseWqlSuffixes(raw);
   const { where: whereText, last, groupBy, rollup, primaryText } = suffixes;
   const result = {
-    raw,
     family: "rows",
+    raw,
     filters: [],
     last: last ? { size: last.size, unit: last.unit } : void 0
   };
@@ -296,41 +314,48 @@ function parseRowsQuery(raw) {
     return result;
   }
   const text = primaryText.trim();
-  const brace = text.indexOf("{");
-  const head = (brace === -1 ? text : text.slice(0, brace)).trim();
-  const filterText = brace === -1 ? "" : text.slice(brace).trim();
-  if (head === "rows" || head === "rows:") ; else if (head.startsWith("rows:")) {
-    const target = head.slice("rows:".length).trim();
-    if (!target || /\s/.test(target)) {
-      result.error = cannotParseRows(text);
-      return result;
-    }
-    result.outputType = target;
-  } else {
+  if (/^rows:?\s*[{]?$/.test(text) || /^rows:?\s*[{]/.test(text)) {
+    result.error = BARE_ROWS_RETIRED;
+    return result;
+  }
+  const tree = parser.parse(text);
+  let syntaxError = false;
+  tree.iterate({ enter(node) {
+    if (node.type.isError) syntaxError = true;
+  } });
+  if (syntaxError) {
     result.error = cannotParseRows(text);
     return result;
   }
-  if (filterText) {
-    if (!/^\{.*\}$/.test(filterText)) {
-      result.error = cannotParseRows(text);
-      return result;
-    }
-    const synthetic = `find:_${filterText}`;
-    const tree = parser.parse(synthetic);
-    let syntaxError = false;
-    tree.iterate({ enter(node) {
-      if (node.type.isError) syntaxError = true;
-    } });
-    if (syntaxError) {
-      result.error = cannotParseRows(text);
-      return result;
-    }
-    result.filters = extractFilters(tree.topNode, synthetic);
-    const grainError = retiredGrainRollup(result.filters);
-    if (grainError) {
-      result.error = grainError;
-      return result;
-    }
+  const query = tree.topNode;
+  const head = query.getChild(Head);
+  const aggNode = head?.getChild(Aggregator);
+  const metricNode = head?.getChild(Metric);
+  if (!head || !aggNode || !metricNode) {
+    result.error = BARE_ROWS_RETIRED;
+    return result;
+  }
+  const aggText = text.slice(aggNode.from, aggNode.to);
+  if (aggText !== "rows") {
+    result.error = cannotParseRows(text);
+    return result;
+  }
+  const target = text.slice(metricNode.from, metricNode.to);
+  if (!WQL_ROWS_TARGETS.includes(target)) {
+    result.error = `Unknown rows target "${target}". Try: ${WQL_ROWS_TARGETS.join(", ")}`;
+    return result;
+  }
+  if (target !== "all") result.outputType = target;
+  result.filters = extractFilters(query, text);
+  const grainError = retiredGrainRollup(result.filters);
+  if (grainError) {
+    result.error = grainError;
+    return result;
+  }
+  const filterError = validateRowsFilters(result.filters);
+  if (filterError) {
+    result.error = filterError;
+    return result;
   }
   return result;
 }
@@ -371,6 +396,7 @@ function parseAnalyticsQuery(raw) {
   const suffixes = parseWqlSuffixes(raw);
   const { where: whereText, displayUnit, groupBy, rollup, primaryText: text } = suffixes;
   const base = {
+    family: "aggregate",
     raw,
     agg: "sum",
     metric: "",
@@ -438,6 +464,7 @@ function parseFindQuery(raw) {
   const suffixes = parseWqlSuffixes(raw);
   const { where: whereText, last, scope, primaryText: text } = suffixes;
   const result = {
+    family: "find",
     raw,
     target: "",
     filters: [],
@@ -471,6 +498,10 @@ function parseFindQuery(raw) {
     return result;
   }
   result.target = text.slice(metricNode.from, metricNode.to);
+  if (!WQL_FIND_TARGETS.includes(result.target)) {
+    result.error = `Unknown find target "${result.target}". Try: ${WQL_FIND_TARGETS.join(", ")}`;
+    return result;
+  }
   result.filters = extractFilters(query, text);
   const findGrainError = retiredGrainRollup(result.filters);
   if (findGrainError) {
@@ -1088,6 +1119,7 @@ function staticTagIndexFromBlocks(blocks) {
 
 // src/QueryService.ts
 var DAY = 864e5;
+var ROWS_CONTENT_PLANES = new Set(WQL_FIND_TARGETS);
 function localDateString(ts) {
   return new Date(ts).toLocaleDateString(void 0, { year: "numeric", month: "short", day: "numeric" });
 }
@@ -1296,7 +1328,7 @@ var QueryService = class {
     const parsed = parseQuery(raw);
     if (isFindQuery(parsed)) {
       return {
-        parsed: { raw, agg: "count", metric: parsed.target, filters: [], groupBy: [] },
+        parsed: { family: "aggregate", raw, agg: "count", metric: parsed.target, filters: [], groupBy: [] },
         series: [],
         stages: { selected: 0, buckets: 0, aggregated: 0, groups: 0 },
         matched: []
@@ -1304,7 +1336,7 @@ var QueryService = class {
     }
     if (isRowsQuery(parsed)) {
       return {
-        parsed: { raw, agg: "count", metric: "rows", filters: [], groupBy: [] },
+        parsed: { family: "aggregate", raw, agg: "count", metric: "rows", filters: [], groupBy: [] },
         series: [],
         stages: { selected: 0, buckets: 0, aggregated: 0, groups: 0 },
         matched: []
@@ -1313,29 +1345,20 @@ var QueryService = class {
     return this.run(parsed, options2);
   }
   /**
-   * Execute a rows query (rows:{…}, #949) — the session results table plane.
-   * Reads event rows directly over the unified store (ticket 003): no
-   * WorkoutResult blob parsing; outputType narrowing hits the promoted column.
+   * Execute a rows query (rows:<target>{…}, #949/C4) — the session results
+   * table plane. Filter rules are validated at parse; this executes only.
+   * Reads event rows directly over the unified store: outputType narrowing
+   * hits the promoted column; content-plane targets scope by content.
    */
   async runRows(parsed, options2 = {}) {
     const empty = { parsed, runs: [] };
     if (parsed.error) return { ...empty, error: parsed.error };
-    const ROWS_SCOPE_KEYS = /* @__PURE__ */ new Set(["result", "block", "note"]);
-    const unsupported = parsed.filters.filter(
-      (f) => !ROWS_SCOPE_KEYS.has(f.key) || f.negate || f.values.some((v) => v.wildcard)
-    );
-    if (unsupported.length > 0) {
-      return {
-        ...empty,
-        error: `Unsupported rows filter(s): ${unsupported.map((f) => (f.negate ? "!" : "") + f.key).join(", ")}. Rows queries support exact result:, block:, note: values.`
-      };
-    }
     const scopeValues = (key) => parsed.filters.filter((f) => f.key === key).flatMap((f) => f.values.map((v) => v.value));
     const resultIds = scopeValues("result");
     const blockIds = scopeValues("block");
     const noteIds = scopeValues("note");
     if (resultIds.length + blockIds.length + noteIds.length === 0) {
-      return { ...empty, error: "Rows query needs a scope: result:, block:, or note:." };
+      return { ...empty, runs: [] };
     }
     const byResult = /* @__PURE__ */ new Map();
     const collect = (rows) => {
@@ -1359,7 +1382,7 @@ var QueryService = class {
       resultId,
       noteId: rows[0].noteId,
       timestamp: rows[0].timestamp,
-      events: parsed.outputType ? rows.filter((row) => row.outputType === parsed.outputType) : rows
+      events: parsed.outputType && !ROWS_CONTENT_PLANES.has(parsed.outputType) ? rows.filter((row) => row.outputType === parsed.outputType) : rows
     })).filter((run) => run.events.length > 0);
     return { parsed, runs };
   }
@@ -1626,6 +1649,7 @@ var QueryService = class {
     };
     const join = parsed.join;
     const findResult = await this.runFind({
+      family: "find",
       raw: "",
       target: join.target,
       filters: join.filters,
@@ -2044,15 +2068,15 @@ sum:$metric{} rollup:1w
 }
 
 // src/version.ts
-var VERSION = "0.7.37";
-var GIT_SHA = "713c593";
-var BUILD_TIME = "2026-08-25T00:18:25.714Z";
+var VERSION = "0.8.39";
+var GIT_SHA = "3c19185";
+var BUILD_TIME = "2026-08-26T00:07:31.934Z";
 var SEMVER = {
-  version: "0.7.37",
-  gitSha: "713c593",
-  buildTime: "2026-08-25T00:18:25.714Z"
+  version: "0.8.39",
+  gitSha: "3c19185",
+  buildTime: "2026-08-26T00:07:31.934Z"
 };
 
-export { BUILD_TIME, DASHBOARD_GRID_MAX_COLS, DASHBOARD_WIDGET_TYPES, DEFAULT_DASHBOARD_TITLE, DISCIPLINE_FACTORS, EFFORT_DISCIPLINES, GIT_SHA, KG_PER_LB, PLANNED_WIDGET_TYPES, QueryService, SEMVER, UNIT_FAMILIES, VERSION, WQL_AGGREGATORS, WQL_CALC_TARGETS, WQL_COMPARISON_OPS, WQL_CONTENT_FILTER_KEYS, WQL_DISPLAY_UNITS, WQL_FIND_TARGETS, WQL_GRAINS, WQL_INTENSITY_TIERS, WQL_KEYWORDS, WQL_METRIC_AGGREGATES, WQL_METRIC_FAMILIES, WQL_ROLLUP_PERIODS, WQL_SCOPES, WQL_SOURCES, WQL_TAG_KEYS, WQL_VIRTUAL_DIMS, buildDashboardDocument, buildDashboardScaffold, convert, dashboardSlug, defaultTokenValues, disciplineFactorFor, extractDashboardTokens, extractFrontmatterTags, getList, getScalar, getUnitFamily, isDashboardMeta, isDashboardWidgetType, isEffortDiscipline, isFindQuery, isProposedMetric, isRowsQuery, normalizeSummaryFacts, parseDashboardNote, parseFlatProperties, parseFrontmatter, parseFrontmatterBody, parseFrontmatterCategories, parseFrontmatterProps, parseQuery, parseQueryWidgetSuffix, parseWqlSuffixes, projectEventToFacts, referencedTokens, resolveCanonicalMetricKey, resolveDisplayUnit, resolveWidgetType, serializeFrontmatter, setDashboardTokenValue, splitAtWhere, splitWidgetBody, staticNotesFromBlocks, staticTagIndexFromBlocks, stripFrontmatter, substituteTokens, toEventRows, toSummaryEventRows, unknownTokensMessage, unknownWidgetTypeMessage, wql, wqlCompletion, wqlCompletionSource, wqlHighlightStyle, wqlLanguage, parser as wqlParser, wql_parser_terms_exports as wqlTerms };
+export { BUILD_TIME, DASHBOARD_GRID_MAX_COLS, DASHBOARD_WIDGET_TYPES, DEFAULT_DASHBOARD_TITLE, DISCIPLINE_FACTORS, EFFORT_DISCIPLINES, GIT_SHA, KG_PER_LB, PLANNED_WIDGET_TYPES, QueryService, SEMVER, UNIT_FAMILIES, VERSION, WQL_AGGREGATORS, WQL_CALC_TARGETS, WQL_COMPARISON_OPS, WQL_CONTENT_FILTER_KEYS, WQL_DISPLAY_UNITS, WQL_FIND_TARGETS, WQL_GRAINS, WQL_INTENSITY_TIERS, WQL_KEYWORDS, WQL_METRIC_AGGREGATES, WQL_METRIC_FAMILIES, WQL_RESULT_PLANES, WQL_ROLLUP_PERIODS, WQL_ROWS_SCOPE_KEYS, WQL_ROWS_TARGETS, WQL_SCOPES, WQL_SOURCES, WQL_TAG_KEYS, WQL_VIRTUAL_DIMS, buildDashboardDocument, buildDashboardScaffold, convert, dashboardSlug, defaultTokenValues, disciplineFactorFor, extractDashboardTokens, extractFrontmatterTags, getList, getScalar, getUnitFamily, isAggregateQuery, isDashboardMeta, isDashboardWidgetType, isEffortDiscipline, isFindQuery, isProposedMetric, isRowsQuery, normalizeSummaryFacts, parseDashboardNote, parseFlatProperties, parseFrontmatter, parseFrontmatterBody, parseFrontmatterCategories, parseFrontmatterProps, parseQuery, parseQueryWidgetSuffix, parseWqlSuffixes, projectEventToFacts, referencedTokens, resolveCanonicalMetricKey, resolveDisplayUnit, resolveWidgetType, serializeFrontmatter, setDashboardTokenValue, splitAtWhere, splitWidgetBody, staticNotesFromBlocks, staticTagIndexFromBlocks, stripFrontmatter, substituteTokens, toEventRows, toSummaryEventRows, unknownTokensMessage, unknownWidgetTypeMessage, wql, wqlCompletion, wqlCompletionSource, wqlHighlightStyle, wqlLanguage, parser as wqlParser, wql_parser_terms_exports as wqlTerms };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map