@bitcobblers/wod-wiki-wql 0.6.31 → 0.6.36

package/dist/index.d.cts

@@ -2,7 +2,7 @@ import { LRParser } from '@lezer/lr';
 import { LanguageSupport, HighlightStyle, LRLanguage } from '@codemirror/language';
 import { CompletionContext, CompletionResult } from '@codemirror/autocomplete';
 import { Extension } from '@codemirror/state';
-import { ResultOrigin, AnalyticsDataPoint, BlockIndexRow, Note, WorkoutResult, StoredOutputStatement } from '@bitcobblers/wod-wiki-core';
+import { ResultOrigin, AnalyticsDataPoint, UnifiedEventRecord, StoredOutputStatement, BlockIndexRow, Note } from '@bitcobblers/wod-wiki-core';
 
 /**
  * WQL vocabulary — the single owner of the WQL dictionary: aggregators,
@@ -50,7 +50,10 @@ declare const WQL_CALC_TARGETS: readonly ["calc.metMinutes", "calc.acwr", "calc.
 type WqlCalcTarget = (typeof WQL_CALC_TARGETS)[number];
 declare const WQL_INTENSITY_TIERS: readonly ["low", "moderate", "high"];
 type WqlIntensityTier = (typeof WQL_INTENSITY_TIERS)[number];
-declare const WQL_GRAINS: readonly ["segment", "summary", "rollup"];
+/** Unified store grains (ticket 003): 'summary' | 'event'. The legacy
+ *  'segment' grain was renamed to 'event' (ticket 002); 'rollup' is retired —
+ *  rollups are computed at read time via the .rollup suffix, never stored. */
+declare const WQL_GRAINS: readonly ["summary", "event"];
 type WqlGrain = (typeof WQL_GRAINS)[number];
 /** Content-discovery query targets (find:<target>). */
 declare const WQL_FIND_TARGETS: readonly ["note", "block", "effort"];
@@ -460,6 +463,29 @@ interface SummaryFactSourceOutput {
  * into persisted fact rows — one row per result × Canonical Metric Key.
  */
 declare function normalizeSummaryFacts(logs: readonly SummaryFactSourceOutput[], identity: SummaryFactIdentity): AnalyticsDataPoint[];
+/** Identity for unified event-row emission — same fields as the fact identity. */
+type EventRowIdentity = SummaryFactIdentity;
+/**
+ * Logs → event rows, 1:1 per statement (ticket 002). Deterministic ids
+ * `${resultId}:${seq}`; canonical workout time wins over the statement's own
+ * timeSpan; query-critical scalars promoted top-level.
+ */
+declare function toEventRows(logs: readonly StoredOutputStatement[], identity: SummaryFactIdentity): UnifiedEventRecord[];
+/**
+ * Tier-2 analytics outputs → deterministic summary event rows (tickets
+ * 002/004): id `${resultId}:summary:${rowKey}` — no timestamp salt, so
+ * re-finalize overwrites cleanly. Fold identity lives in metrics[0].metadata
+ * (canonicalKey, effort metadata, groupTags) — shape-uniform with events.
+ */
+declare function toSummaryEventRows(logs: readonly StoredOutputStatement[], identity: SummaryFactIdentity): UnifiedEventRecord[];
+/**
+ * Event row → flat fact currency for the four-stage plan (ticket 003):
+ * one AnalyticsDataPoint per numeric metric. Canonical key resolution
+ * mirrors the summary fold — metadata.canonicalKey first, name-derived
+ * from the row's label metric as fallback. Deterministic fact ids:
+ * `${record.id}:${factOrdinal}`.
+ */
+declare function projectEventToFacts(record: UnifiedEventRecord): AnalyticsDataPoint[];
 
 /**
  * Pure projection of a block_index into static Notes — one Note per distinct
@@ -480,18 +506,42 @@ declare function staticTagIndexFromBlocks(blocks: BlockIndexRow[]): Map<string,
 /**
  * Injected store interfaces for WQL QueryService.
  * Zero database/storage dependencies — 100% pure abstractions.
+ *
+ * Ticket 003: FactQueryStore + ResultLogStore collapsed into the single
+ * UnifiedEventStore — two names for one data source. The content plane
+ * (notes / blocks / efforts) is unchanged by workout-data unification.
  */
 
-/** Store surface the Query Service needs for fact rows. */
-interface FactQueryStore {
-    getFactsByMetric(metricKey: string): Promise<AnalyticsDataPoint[]>;
-    getFactsByTimeRange(start: number, end: number): Promise<AnalyticsDataPoint[]>;
-    getNoteTagLabels(noteId: string): Promise<string[]>;
+/**
+ * Store surface for the unified event table — every workout-data read the
+ * Query Service needs, plus the write contract owned by the write-path
+ * lifecycle (ticket 005).
+ */
+interface UnifiedEventStore {
+    /** Windowed fetch — the one proven culling index (ticket 001). */
+    getEventsByTimeRange(start: number, end: number): Promise<UnifiedEventRecord[]>;
+    /** Per-result fetch (rows:{result:…}, re-finalize, orphan inspection). */
+    getEventsByResult(resultId: string): Promise<UnifiedEventRecord[]>;
+    /** Note-scoped fetch (rows:{note:…}). */
+    getEventsForNote(noteId: string): Promise<UnifiedEventRecord[]>;
+    /** Content-scoped fetch — the cross-store join hot path (indexed). */
+    getEventsByContent(blockContentId: string): Promise<UnifiedEventRecord[]>;
+    /** Full scan — all-time SELECT leg (ticket 001: scan beats non-selective indexes). */
+    scanAll(): Promise<UnifiedEventRecord[]>;
+    /** Append event rows (per-statement flush; same-tick coalescing allowed). */
+    appendEvents(rows: UnifiedEventRecord[]): Promise<void>;
+    /** Atomic finalize: clear the result's engine-authored summaries, write finals. */
+    finalizeSummaries(resultId: string, rows: UnifiedEventRecord[]): Promise<void>;
+    /** Reconcile deletes (wellness note-save) + GC sweeps. */
+    deleteEvents(ids: string[]): Promise<void>;
 }
 /** Store surface for content queries (`find:note`). */
 interface NoteQueryStore {
     getAllNotes(): Promise<Note[]>;
     getNoteIdsForTag(label: string): Promise<Set<string>>;
+    /** Note-tags label set of one note (moved here from FactQueryStore — it
+     *  reads note tags, not facts). */
+    getNoteTagLabels(noteId: string): Promise<string[]>;
 }
 /** Store surface for block-index queries (`find:block`). */
 interface BlockQueryStore {
@@ -516,39 +566,33 @@ interface IEffort {
 interface EffortQueryStore {
     getAllEfforts(): Promise<IEffort[]>;
 }
-/** Store surface for raw WorkoutResult logs — the cross-store join & rows source. */
-interface ResultLogStore {
-    getResultsByContentId(blockContentId: string): Promise<WorkoutResult[]>;
-    /** Rows plane (#949): single-result scope (`rows:{result:…}`). */
-    getResultById(resultId: string): Promise<WorkoutResult | undefined>;
-    /** Rows plane (#949): whole-note scope (`rows:{note:…}`). */
-    getResultsForNote(noteId: string): Promise<WorkoutResult[]>;
-}
 /** Optional bundle of stores for QueryService initialization. */
 interface QueryServiceStores {
-    factStore?: FactQueryStore;
+    eventStore?: UnifiedEventStore;
     noteStore?: NoteQueryStore;
     blockStore?: BlockQueryStore;
-    resultStore?: ResultLogStore;
     effortStore?: EffortQueryStore;
     staticNoteStore?: NoteQueryStore;
     staticBlockStore?: BlockQueryStore;
 }
 
 /**
- * Query Service — the executor of WQL against the Analytics Store
- * (CONTEXT.md glossary). Four-stage physical plan:
+ * Query Service — the executor of WQL against the unified event store.
+ * Four-stage physical plan:
  *
- *   SELECT (index-first: by-metric + by-timestamp IDBKeyRange fetches,
- *           intersected in memory)
+ *   SELECT (window-first hybrid, ticket 003: windowed queries fetch through
+ *           by-timestamp — the one proven culling index; all-time queries
+ *           scan; by-metric is never used. Event rows are flattened to the
+ *           legacy flat-fact currency by projectEventToFacts.)
  *   BUCKET (time dim or rollup period)
  *   AGGREGATE (per bucket)
  *   GROUP (tag-dimension fan-out)
  *
  * Inputs are uncapped — personal-journal scale; widgets and tables are dumb
- * consumers of QueryResult. Fact rows are summary-grain AnalyticsDataPoint
- * rows; Tags are query-time dimensions read off the row (effort, discipline,
- * note, intensity, …) — 'tags' resolves through the note_tags store.
+ * consumers of QueryResult. The store serves UnifiedEventRecord rows
+ * (grain 'event' | 'summary'); Tags are query-time dimensions read off the
+ * projected fact row (effort, discipline, note, intensity, …) — 'tags'
+ * resolves through the note_tags store.
  *
  * Fully inverted dependencies: zero IndexedDB/storage module-level imports.
  */
@@ -600,11 +644,14 @@ interface QueryResult {
     /** Result display unit, if determined by directive, preference, or fact metadata. */
     unit?: string;
 }
-/** One run in a rows result: the stored result plus the output statements
- *  that survived the optional output-type narrowing (`rows:segment{…}`). */
+/** One run in a rows result: the canonical result identity plus the event
+ *  rows that survived the optional output-type narrowing (`rows:segment{…}`). */
 interface RowsRun {
-    result: WorkoutResult;
-    logs: StoredOutputStatement[];
+    resultId: string;
+    noteId: string;
+    /** Canonical workout time (result.createdAt under the unified model). */
+    timestamp: number;
+    events: UnifiedEventRecord[];
 }
 interface RowsQueryResult {
     parsed: ParsedRowsQuery;
@@ -615,17 +662,17 @@ declare class QueryService {
     private readonly store;
     private readonly noteStore;
     private readonly blockStore;
-    private readonly resultStore;
     private readonly effortStore;
     private readonly staticNoteStore?;
     private readonly staticBlockStore?;
-    constructor(storesOrFactStore?: QueryServiceStores | FactQueryStore, noteStore?: NoteQueryStore, blockStore?: BlockQueryStore, resultStore?: ResultLogStore, effortStore?: EffortQueryStore, staticNoteStore?: NoteQueryStore, staticBlockStore?: BlockQueryStore);
+    constructor(storesOrEventStore?: QueryServiceStores | UnifiedEventStore, noteStore?: NoteQueryStore, blockStore?: BlockQueryStore, effortStore?: EffortQueryStore, staticNoteStore?: NoteQueryStore, staticBlockStore?: BlockQueryStore);
+    /** Windowed flat-fact fetch — the projected view over the event store. */
     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.
-     * Re-derives output statements from raw WorkoutResult logs through the
-     * ResultLogStore seam ("logs win" — facts are never read for this path).
+     * Reads event rows directly over the unified store (ticket 003): no
+     * WorkoutResult blob parsing; outputType narrowing hits the promoted column.
      */
     runRows(parsed: ParsedRowsQuery, options?: {
         anchorNow?: number;
@@ -663,9 +710,10 @@ declare class QueryService {
     /** Filter per-effort vs un-attributed overall summary rows to avoid
      *  double-counting. */
     private applyEffortScope;
-    /** Re-derive summary facts for one Canonical Metric Key from RAW WorkoutResult
-     *  logs across the given content ids — the cross-store join source. One fact
-     *  row per result (normalizeSummaryFacts dedupes within a result). */
+    /** Summary facts for one Canonical Metric Key across the given content ids —
+     *  the cross-store join source. Reads finalize-written summary rows straight
+     *  off the content index (ticket 003: the store is authoritative; the old
+     *  freshness re-derivation is moot). One fact row per result × rowKey. */
     private deriveMetricFacts;
     /** All content blocks across the journal + static corpus. */
     private allContentBlocks;
@@ -897,13 +945,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.6.31";
-declare const GIT_SHA = "d53a937";
-declare const BUILD_TIME = "2026-08-21T14:17:13.519Z";
+declare const VERSION = "0.6.36";
+declare const GIT_SHA = "c5ad2b0";
+declare const BUILD_TIME = "2026-08-24T20:14:33.951Z";
 declare const SEMVER: {
-    readonly version: "0.6.31";
-    readonly gitSha: "d53a937";
-    readonly buildTime: "2026-08-21T14:17:13.519Z";
+    readonly version: "0.6.36";
+    readonly gitSha: "c5ad2b0";
+    readonly buildTime: "2026-08-24T20:14:33.951Z";
 };
 
-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 FactQueryStore, 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 ResultLogStore, type RowsQueryResult, type RowsRun, SEMVER, type Series, type SeriesPoint, type SummaryFactIdentity, type SummaryFactSourceOutput, type TagFilter, type TagValue, UNIT_FAMILIES, 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, referencedTokens, resolveCanonicalMetricKey, resolveDisplayUnit, resolveWidgetType, serializeFrontmatter, setDashboardTokenValue, splitAtWhere, splitWidgetBody, staticNotesFromBlocks, staticTagIndexFromBlocks, stripFrontmatter, substituteTokens, 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 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 };

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import { LRParser } from '@lezer/lr';
 import { LanguageSupport, HighlightStyle, LRLanguage } from '@codemirror/language';
 import { CompletionContext, CompletionResult } from '@codemirror/autocomplete';
 import { Extension } from '@codemirror/state';
-import { ResultOrigin, AnalyticsDataPoint, BlockIndexRow, Note, WorkoutResult, StoredOutputStatement } from '@bitcobblers/wod-wiki-core';
+import { ResultOrigin, AnalyticsDataPoint, UnifiedEventRecord, StoredOutputStatement, BlockIndexRow, Note } from '@bitcobblers/wod-wiki-core';
 
 /**
  * WQL vocabulary — the single owner of the WQL dictionary: aggregators,
@@ -50,7 +50,10 @@ declare const WQL_CALC_TARGETS: readonly ["calc.metMinutes", "calc.acwr", "calc.
 type WqlCalcTarget = (typeof WQL_CALC_TARGETS)[number];
 declare const WQL_INTENSITY_TIERS: readonly ["low", "moderate", "high"];
 type WqlIntensityTier = (typeof WQL_INTENSITY_TIERS)[number];
-declare const WQL_GRAINS: readonly ["segment", "summary", "rollup"];
+/** Unified store grains (ticket 003): 'summary' | 'event'. The legacy
+ *  'segment' grain was renamed to 'event' (ticket 002); 'rollup' is retired —
+ *  rollups are computed at read time via the .rollup suffix, never stored. */
+declare const WQL_GRAINS: readonly ["summary", "event"];
 type WqlGrain = (typeof WQL_GRAINS)[number];
 /** Content-discovery query targets (find:<target>). */
 declare const WQL_FIND_TARGETS: readonly ["note", "block", "effort"];
@@ -460,6 +463,29 @@ interface SummaryFactSourceOutput {
  * into persisted fact rows — one row per result × Canonical Metric Key.
  */
 declare function normalizeSummaryFacts(logs: readonly SummaryFactSourceOutput[], identity: SummaryFactIdentity): AnalyticsDataPoint[];
+/** Identity for unified event-row emission — same fields as the fact identity. */
+type EventRowIdentity = SummaryFactIdentity;
+/**
+ * Logs → event rows, 1:1 per statement (ticket 002). Deterministic ids
+ * `${resultId}:${seq}`; canonical workout time wins over the statement's own
+ * timeSpan; query-critical scalars promoted top-level.
+ */
+declare function toEventRows(logs: readonly StoredOutputStatement[], identity: SummaryFactIdentity): UnifiedEventRecord[];
+/**
+ * Tier-2 analytics outputs → deterministic summary event rows (tickets
+ * 002/004): id `${resultId}:summary:${rowKey}` — no timestamp salt, so
+ * re-finalize overwrites cleanly. Fold identity lives in metrics[0].metadata
+ * (canonicalKey, effort metadata, groupTags) — shape-uniform with events.
+ */
+declare function toSummaryEventRows(logs: readonly StoredOutputStatement[], identity: SummaryFactIdentity): UnifiedEventRecord[];
+/**
+ * Event row → flat fact currency for the four-stage plan (ticket 003):
+ * one AnalyticsDataPoint per numeric metric. Canonical key resolution
+ * mirrors the summary fold — metadata.canonicalKey first, name-derived
+ * from the row's label metric as fallback. Deterministic fact ids:
+ * `${record.id}:${factOrdinal}`.
+ */
+declare function projectEventToFacts(record: UnifiedEventRecord): AnalyticsDataPoint[];
 
 /**
  * Pure projection of a block_index into static Notes — one Note per distinct
@@ -480,18 +506,42 @@ declare function staticTagIndexFromBlocks(blocks: BlockIndexRow[]): Map<string,
 /**
  * Injected store interfaces for WQL QueryService.
  * Zero database/storage dependencies — 100% pure abstractions.
+ *
+ * Ticket 003: FactQueryStore + ResultLogStore collapsed into the single
+ * UnifiedEventStore — two names for one data source. The content plane
+ * (notes / blocks / efforts) is unchanged by workout-data unification.
  */
 
-/** Store surface the Query Service needs for fact rows. */
-interface FactQueryStore {
-    getFactsByMetric(metricKey: string): Promise<AnalyticsDataPoint[]>;
-    getFactsByTimeRange(start: number, end: number): Promise<AnalyticsDataPoint[]>;
-    getNoteTagLabels(noteId: string): Promise<string[]>;
+/**
+ * Store surface for the unified event table — every workout-data read the
+ * Query Service needs, plus the write contract owned by the write-path
+ * lifecycle (ticket 005).
+ */
+interface UnifiedEventStore {
+    /** Windowed fetch — the one proven culling index (ticket 001). */
+    getEventsByTimeRange(start: number, end: number): Promise<UnifiedEventRecord[]>;
+    /** Per-result fetch (rows:{result:…}, re-finalize, orphan inspection). */
+    getEventsByResult(resultId: string): Promise<UnifiedEventRecord[]>;
+    /** Note-scoped fetch (rows:{note:…}). */
+    getEventsForNote(noteId: string): Promise<UnifiedEventRecord[]>;
+    /** Content-scoped fetch — the cross-store join hot path (indexed). */
+    getEventsByContent(blockContentId: string): Promise<UnifiedEventRecord[]>;
+    /** Full scan — all-time SELECT leg (ticket 001: scan beats non-selective indexes). */
+    scanAll(): Promise<UnifiedEventRecord[]>;
+    /** Append event rows (per-statement flush; same-tick coalescing allowed). */
+    appendEvents(rows: UnifiedEventRecord[]): Promise<void>;
+    /** Atomic finalize: clear the result's engine-authored summaries, write finals. */
+    finalizeSummaries(resultId: string, rows: UnifiedEventRecord[]): Promise<void>;
+    /** Reconcile deletes (wellness note-save) + GC sweeps. */
+    deleteEvents(ids: string[]): Promise<void>;
 }
 /** Store surface for content queries (`find:note`). */
 interface NoteQueryStore {
     getAllNotes(): Promise<Note[]>;
     getNoteIdsForTag(label: string): Promise<Set<string>>;
+    /** Note-tags label set of one note (moved here from FactQueryStore — it
+     *  reads note tags, not facts). */
+    getNoteTagLabels(noteId: string): Promise<string[]>;
 }
 /** Store surface for block-index queries (`find:block`). */
 interface BlockQueryStore {
@@ -516,39 +566,33 @@ interface IEffort {
 interface EffortQueryStore {
     getAllEfforts(): Promise<IEffort[]>;
 }
-/** Store surface for raw WorkoutResult logs — the cross-store join & rows source. */
-interface ResultLogStore {
-    getResultsByContentId(blockContentId: string): Promise<WorkoutResult[]>;
-    /** Rows plane (#949): single-result scope (`rows:{result:…}`). */
-    getResultById(resultId: string): Promise<WorkoutResult | undefined>;
-    /** Rows plane (#949): whole-note scope (`rows:{note:…}`). */
-    getResultsForNote(noteId: string): Promise<WorkoutResult[]>;
-}
 /** Optional bundle of stores for QueryService initialization. */
 interface QueryServiceStores {
-    factStore?: FactQueryStore;
+    eventStore?: UnifiedEventStore;
     noteStore?: NoteQueryStore;
     blockStore?: BlockQueryStore;
-    resultStore?: ResultLogStore;
     effortStore?: EffortQueryStore;
     staticNoteStore?: NoteQueryStore;
     staticBlockStore?: BlockQueryStore;
 }
 
 /**
- * Query Service — the executor of WQL against the Analytics Store
- * (CONTEXT.md glossary). Four-stage physical plan:
+ * Query Service — the executor of WQL against the unified event store.
+ * Four-stage physical plan:
  *
- *   SELECT (index-first: by-metric + by-timestamp IDBKeyRange fetches,
- *           intersected in memory)
+ *   SELECT (window-first hybrid, ticket 003: windowed queries fetch through
+ *           by-timestamp — the one proven culling index; all-time queries
+ *           scan; by-metric is never used. Event rows are flattened to the
+ *           legacy flat-fact currency by projectEventToFacts.)
  *   BUCKET (time dim or rollup period)
  *   AGGREGATE (per bucket)
  *   GROUP (tag-dimension fan-out)
  *
  * Inputs are uncapped — personal-journal scale; widgets and tables are dumb
- * consumers of QueryResult. Fact rows are summary-grain AnalyticsDataPoint
- * rows; Tags are query-time dimensions read off the row (effort, discipline,
- * note, intensity, …) — 'tags' resolves through the note_tags store.
+ * consumers of QueryResult. The store serves UnifiedEventRecord rows
+ * (grain 'event' | 'summary'); Tags are query-time dimensions read off the
+ * projected fact row (effort, discipline, note, intensity, …) — 'tags'
+ * resolves through the note_tags store.
  *
  * Fully inverted dependencies: zero IndexedDB/storage module-level imports.
  */
@@ -600,11 +644,14 @@ interface QueryResult {
     /** Result display unit, if determined by directive, preference, or fact metadata. */
     unit?: string;
 }
-/** One run in a rows result: the stored result plus the output statements
- *  that survived the optional output-type narrowing (`rows:segment{…}`). */
+/** One run in a rows result: the canonical result identity plus the event
+ *  rows that survived the optional output-type narrowing (`rows:segment{…}`). */
 interface RowsRun {
-    result: WorkoutResult;
-    logs: StoredOutputStatement[];
+    resultId: string;
+    noteId: string;
+    /** Canonical workout time (result.createdAt under the unified model). */
+    timestamp: number;
+    events: UnifiedEventRecord[];
 }
 interface RowsQueryResult {
     parsed: ParsedRowsQuery;
@@ -615,17 +662,17 @@ declare class QueryService {
     private readonly store;
     private readonly noteStore;
     private readonly blockStore;
-    private readonly resultStore;
     private readonly effortStore;
     private readonly staticNoteStore?;
     private readonly staticBlockStore?;
-    constructor(storesOrFactStore?: QueryServiceStores | FactQueryStore, noteStore?: NoteQueryStore, blockStore?: BlockQueryStore, resultStore?: ResultLogStore, effortStore?: EffortQueryStore, staticNoteStore?: NoteQueryStore, staticBlockStore?: BlockQueryStore);
+    constructor(storesOrEventStore?: QueryServiceStores | UnifiedEventStore, noteStore?: NoteQueryStore, blockStore?: BlockQueryStore, effortStore?: EffortQueryStore, staticNoteStore?: NoteQueryStore, staticBlockStore?: BlockQueryStore);
+    /** Windowed flat-fact fetch — the projected view over the event store. */
     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.
-     * Re-derives output statements from raw WorkoutResult logs through the
-     * ResultLogStore seam ("logs win" — facts are never read for this path).
+     * Reads event rows directly over the unified store (ticket 003): no
+     * WorkoutResult blob parsing; outputType narrowing hits the promoted column.
      */
     runRows(parsed: ParsedRowsQuery, options?: {
         anchorNow?: number;
@@ -663,9 +710,10 @@ declare class QueryService {
     /** Filter per-effort vs un-attributed overall summary rows to avoid
      *  double-counting. */
     private applyEffortScope;
-    /** Re-derive summary facts for one Canonical Metric Key from RAW WorkoutResult
-     *  logs across the given content ids — the cross-store join source. One fact
-     *  row per result (normalizeSummaryFacts dedupes within a result). */
+    /** Summary facts for one Canonical Metric Key across the given content ids —
+     *  the cross-store join source. Reads finalize-written summary rows straight
+     *  off the content index (ticket 003: the store is authoritative; the old
+     *  freshness re-derivation is moot). One fact row per result × rowKey. */
     private deriveMetricFacts;
     /** All content blocks across the journal + static corpus. */
     private allContentBlocks;
@@ -897,13 +945,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.6.31";
-declare const GIT_SHA = "d53a937";
-declare const BUILD_TIME = "2026-08-21T14:17:13.519Z";
+declare const VERSION = "0.6.36";
+declare const GIT_SHA = "c5ad2b0";
+declare const BUILD_TIME = "2026-08-24T20:14:33.951Z";
 declare const SEMVER: {
-    readonly version: "0.6.31";
-    readonly gitSha: "d53a937";
-    readonly buildTime: "2026-08-21T14:17:13.519Z";
+    readonly version: "0.6.36";
+    readonly gitSha: "c5ad2b0";
+    readonly buildTime: "2026-08-24T20:14:33.951Z";
 };
 
-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 FactQueryStore, 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 ResultLogStore, type RowsQueryResult, type RowsRun, SEMVER, type Series, type SeriesPoint, type SummaryFactIdentity, type SummaryFactSourceOutput, type TagFilter, type TagValue, UNIT_FAMILIES, 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, referencedTokens, resolveCanonicalMetricKey, resolveDisplayUnit, resolveWidgetType, serializeFrontmatter, setDashboardTokenValue, splitAtWhere, splitWidgetBody, staticNotesFromBlocks, staticTagIndexFromBlocks, stripFrontmatter, substituteTokens, 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 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 };