@bitcobblers/wod-wiki-lang 0.48.2171 → 0.48.2173

package/dist/{browserRuntimeNow-CqyFh_Jd.d.cts → browserRuntimeNow-DUJFkpUq.d.cts}

@@ -800,6 +800,13 @@ declare function compoundName(d: DimVector): string | undefined;
 
 type CalcOrigin = 'analyzed' | 'analyzed-estimated' | 'user';
 type CalcScope = 'segment' | 'workout' | 'store';
+/** A note summary that failed registration — surfaced, never silently dropped. */
+interface CalcRegistrationDiagnostic {
+    /** The summary calc id that failed to register. */
+    id: string;
+    /** Why it was skipped (the registration error message). */
+    message: string;
+}
 interface CalcNode {
     id: string;
     kind: 'metric' | 'lookup' | 'builtin' | 'wql' | 'expr';
@@ -994,6 +1001,8 @@ interface ShakeOutQueueOptions {
     readonly sources: readonly PropertyRuleInput[];
     readonly lookups?: LookupRegistry;
     readonly lastEffortSlug?: string;
+    /** Structural outputs may evaluate rules without surfacing diagnostics. */
+    readonly emitDiagnostics?: boolean;
 }
 /**
  * Extract `metrics:` and `summaries:` maps from a parsed frontmatter record
@@ -1006,12 +1015,13 @@ declare function extractPropertyRulesFromMeta(meta: Readonly<Record<string, unkn
  * `summaries.<key>` contributions on tags (including nested tags).
  */
 declare function extractTagPropertyRules(tags: TagIndex | undefined, slugs: readonly string[]): PropertyRuleInput[];
-/**
- * Compile `summaries:` equations across stacked Property Notes into workout-scope
- * `CalculationDefinition` records. Higher-precedence layers shadow lower layers
- * when both define the same summary key.
- */
+/** Compiled note summaries plus the unresolved dependencies found while compiling. */
+interface CompiledPropertySummaries {
+    defs: CalculationDefinition[];
+    diagnostics: CalcRegistrationDiagnostic[];
+}
 declare function compilePropertySummaryCalcs(sources: readonly PropertyRuleInput[]): CalculationDefinition[];
+declare function compilePropertySummaryCalcsWithDiagnostics(sources: readonly PropertyRuleInput[]): CompiledPropertySummaries;
 /**
  * Run the two-stage Metric Shake-Out Queue on a statement's MetricContainer.
  */
@@ -1541,6 +1551,21 @@ interface IBlockRef {
     markComplete(reason?: string): void;
 }
 
+/**
+ * INowProvider — the only seam for "what time is it" in the runtime.
+ * Events, actions, and behaviors that need a timestamp take a now-fn
+ * in their constructor; the runtime passes its single provider down.
+ * Tests pass a frozen clock so the timeline is deterministic.
+ */
+interface INowProvider {
+    now(): Date;
+    nowMs(): number;
+}
+/** Default provider: reads wall clock. */
+declare const wallClockNow: INowProvider;
+/** A provider that always returns the same Date (for tests). */
+declare function frozenNow(at: Date): INowProvider;
+
 /**
  * TimeSpan represents a discrete segment of a block's **Time** — a single
  * start/stop recording within the spans collection.
@@ -1580,21 +1605,6 @@ declare class TimeSpan implements TimeSpan$1 {
     get endDate(): Date | undefined;
 }
 
-/**
- * INowProvider — the only seam for "what time is it" in the runtime.
- * Events, actions, and behaviors that need a timestamp take a now-fn
- * in their constructor; the runtime passes its single provider down.
- * Tests pass a frozen clock so the timeline is deterministic.
- */
-interface INowProvider {
-    now(): Date;
-    nowMs(): number;
-}
-/** Default provider: reads wall clock. */
-declare const wallClockNow: INowProvider;
-/** A provider that always returns the same Date (for tests). */
-declare function frozenNow(at: Date): INowProvider;
-
 /**
  * IRuntimeClock provides time tracking for the runtime.
  *
@@ -1877,6 +1887,8 @@ interface IBehaviorContext {
     readonly block: IBlockRef;
     /** Current runtime clock */
     readonly clock: IRuntimeClock;
+    /** Live wall-clock provider, independent of execution snapshots. */
+    readonly nowProvider: INowProvider;
     /**
      * Current stack level (depth) of the block.
      * 0 = root block, 1 = first child, etc.
@@ -2991,4 +3003,4 @@ declare function getRuntimeNowMs(): number;
 /** Creates an INowProvider that reads the browser sender-clock when available. */
 declare function createBrowserRuntimeNow(): INowProvider;
 
-export { type SoundProfile as $, type AnalyticsContext as A, type BehaviorEventType as B, type IMemoryLocation as C, type IRuntimeBehavior as D, type EffortResolverOptions as E, type IBlockContext as F, type MetricVisibility as G, type BlockLifecycleOptions as H, type IEquipment as I, type CompletionDecision as J, type IRuntimeMemory as K, TypedMemoryReference as L, type MemoryTag as M, type MemorySearchCriteria as N, type OutputListener as O, type IMemoryReference as P, type RuntimeStackLogger as Q, type ReferenceIndex as R, type SubscribeOptions as S, TimeSpan as T, type Unsubscribe as U, type StackObserver as V, WhiteboardScript as W, type StackSnapshot as X, type StackListener as Y, MemoryTypeEnum as Z, type IAnchorValue as _, type ReferenceResolutionDefaults as a, type MemoryValueOf as a$, type ButtonConfig as a0, type IEventHandler as a1, type HandlerScope as a2, type IScriptRuntime as a3, type TestableBlockConfig as a4, type IRuntimeOptions as a5, ScriptRuntime as a6, type EventHandlerOptions as a7, type EventCallback as a8, type TimerState as a9, DIM_LENGTH as aA, DIM_MASS as aB, DIM_TIME as aC, DIM_ZERO as aD, DISCIPLINE_FACTORS as aE, type DisplayState as aF, EFFORT_DISCIPLINES as aG, EFFORT_REGISTRY_ORIGINS as aH, type EffortBaseAttributes as aI, type EffortDerivation as aJ, type EffortDiscipline as aK, type EffortMaterializer as aL, type EffortResolvedFrom as aM, type EvalContext as aN, type FenceDialect as aO, type FragmentDisplayState as aP, type FragmentState as aQ, type IAnalyticsProcessorDescriptor as aR, INTENSITY_TIERS as aS, type IScript as aT, type IntensityTier as aU, type InterceptMode as aV, type LookupFieldDef as aW, type LookupLayer as aX, MemoryLocation as aY, type MemoryType as aZ, type MemoryTypeMap as a_, type CalculationDefinition as aa, type PropertyRuleInput as ab, type IRealtimeProcessor as ac, type ISummaryProcessor as ad, type DimVector as ae, type CalcLine as af, type ExprNode as ag, type CalcScope as ah, type ILookupTable as ai, LookupRegistry as aj, type ProjectionResult as ak, ABSENT as al, type BinaryOp as am, type ButtonVariant as an, type ButtonsState as ao, CalcEvalError as ap, type CalcNode as aq, type CalcOrigin as ar, type CalcVariant as as, type ChildrenStatusState as at, type CompletionState as au, DEFAULT_RESOLVER_OPTIONS as av, DEFAULT_RUNTIME_OPTIONS as aw, DEFAULT_SOUND_PROFILE as ax, DIM_COUNT as ay, DIM_ENERGY as az, type IEffort as b, NAMED_COMPOUNDS as b0, type PropertySourceLayer as b1, type ReferenceCatalog as b2, type ResolvedReferences as b3, type RoundState as b4, type RuntimeState as b5, SEED_PRECEDENCE_RANK as b6, type ScriptRuntimeDependencies as b7, type SeedPrecedenceTier as b8, type ShakeOutQueueOptions as b9, getMetricVisibility as bA, getRuntimeNowMs as bB, isDimensionless as bC, isEffortDiscipline as bD, isFragmentTag as bE, num as bF, parseSoundTrigger as bG, resolveEntityRank as bH, resolveEntityTier as bI, resolveProfileRules as bJ, resolveSourceRank as bK, resolveSourceTier as bL, runMetricShakeOutQueue as bM, slugifyRefLabel as bN, str as bO, subDim as bP, truthy as bQ, wallClockNow as bR, type ShakeOutResult as ba, type SkippedDependencyDiagnostic as bb, type SoundRule as bc, type SoundTriggerAnchor as bd, type SoundTriggerPoint as be, type StackEvent as bf, type TimerDirection as bg, VISIBILITY_ICONS as bh, VISIBILITY_LABELS as bi, type Val as bj, addDim as bk, compilePropertySummaryCalcs as bl, compoundName as bm, createBrowserRuntimeNow as bn, createReferenceIndex as bo, dedupeEntitiesByPrecedence as bp, dimEquals as bq, disciplineFactorFor as br, evaluate as bs, extractPropertyRulesFromMeta as bt, extractStatementRefs as bu, extractTagPropertyRules as bv, filterTagsByVisibility as bw, formatDim as bx, formatSoundTrigger as by, frozenNow as bz, type IEffortResolver as c, type IEffortRegistry as d, type EffortResolutionOptions as e, type ResolvedEffort as f, type EffortRegistrySource as g, type IEquipmentRegistry as h, type EquipmentStorageAdapter as i, type EffortStorageAdapter as j, type IRuntimeActionable as k, type IEventBus as l, type IRuntimeStack as m, type IRuntimeClock as n, type IJitCompiler as o, type INowProvider as p, type RuntimeStackOptions as q, type RuntimeError as r, type IEvent as s, type IRuntimeAction as t, type IAnalyticsEngine as u, type IRuntimeBlock as v, type IBehaviorContext as w, type BehaviorEventListener as x, type Unsubscribe$1 as y, type OutputOptions as z };
+export { type SoundProfile as $, type AnalyticsContext as A, type BehaviorEventType as B, type IMemoryLocation as C, type IRuntimeBehavior as D, type EffortResolverOptions as E, type IBlockContext as F, type MetricVisibility as G, type BlockLifecycleOptions as H, type IEquipment as I, type CompletionDecision as J, type IRuntimeMemory as K, TypedMemoryReference as L, type MemoryTag as M, type MemorySearchCriteria as N, type OutputListener as O, type IMemoryReference as P, type RuntimeStackLogger as Q, type ReferenceIndex as R, type SubscribeOptions as S, TimeSpan as T, type Unsubscribe as U, type StackObserver as V, WhiteboardScript as W, type StackSnapshot as X, type StackListener as Y, MemoryTypeEnum as Z, type IAnchorValue as _, type ReferenceResolutionDefaults as a, type MemoryType as a$, type ButtonConfig as a0, type IEventHandler as a1, type HandlerScope as a2, type IScriptRuntime as a3, type TestableBlockConfig as a4, type IRuntimeOptions as a5, ScriptRuntime as a6, type EventHandlerOptions as a7, type EventCallback as a8, type TimerState as a9, DIM_COUNT as aA, DIM_ENERGY as aB, DIM_LENGTH as aC, DIM_MASS as aD, DIM_TIME as aE, DIM_ZERO as aF, DISCIPLINE_FACTORS as aG, type DisplayState as aH, EFFORT_DISCIPLINES as aI, EFFORT_REGISTRY_ORIGINS as aJ, type EffortBaseAttributes as aK, type EffortDerivation as aL, type EffortDiscipline as aM, type EffortMaterializer as aN, type EffortResolvedFrom as aO, type EvalContext as aP, type FenceDialect as aQ, type FragmentDisplayState as aR, type FragmentState as aS, type IAnalyticsProcessorDescriptor as aT, INTENSITY_TIERS as aU, type IScript as aV, type IntensityTier as aW, type InterceptMode as aX, type LookupFieldDef as aY, type LookupLayer as aZ, MemoryLocation as a_, type CalculationDefinition as aa, type PropertyRuleInput as ab, type IRealtimeProcessor as ac, type ISummaryProcessor as ad, type DimVector as ae, type CalcLine as af, type ExprNode as ag, type CalcScope as ah, type ILookupTable as ai, LookupRegistry as aj, type CalcRegistrationDiagnostic as ak, type ProjectionResult as al, ABSENT as am, type BinaryOp as an, type ButtonVariant as ao, type ButtonsState as ap, CalcEvalError as aq, type CalcNode as ar, type CalcOrigin as as, type CalcVariant as at, type ChildrenStatusState as au, type CompiledPropertySummaries as av, type CompletionState as aw, DEFAULT_RESOLVER_OPTIONS as ax, DEFAULT_RUNTIME_OPTIONS as ay, DEFAULT_SOUND_PROFILE as az, type IEffort as b, type MemoryTypeMap as b0, type MemoryValueOf as b1, NAMED_COMPOUNDS as b2, type PropertySourceLayer as b3, type ReferenceCatalog as b4, type ResolvedReferences as b5, type RoundState as b6, type RuntimeState as b7, SEED_PRECEDENCE_RANK as b8, type ScriptRuntimeDependencies as b9, formatDim as bA, formatSoundTrigger as bB, frozenNow as bC, getMetricVisibility as bD, getRuntimeNowMs as bE, isDimensionless as bF, isEffortDiscipline as bG, isFragmentTag as bH, num as bI, parseSoundTrigger as bJ, resolveEntityRank as bK, resolveEntityTier as bL, resolveProfileRules as bM, resolveSourceRank as bN, resolveSourceTier as bO, runMetricShakeOutQueue as bP, slugifyRefLabel as bQ, str as bR, subDim as bS, truthy as bT, wallClockNow as bU, type SeedPrecedenceTier as ba, type ShakeOutQueueOptions as bb, type ShakeOutResult as bc, type SkippedDependencyDiagnostic as bd, type SoundRule as be, type SoundTriggerAnchor as bf, type SoundTriggerPoint as bg, type StackEvent as bh, type TimerDirection as bi, VISIBILITY_ICONS as bj, VISIBILITY_LABELS as bk, type Val as bl, addDim as bm, compilePropertySummaryCalcs as bn, compilePropertySummaryCalcsWithDiagnostics as bo, compoundName as bp, createBrowserRuntimeNow as bq, createReferenceIndex as br, dedupeEntitiesByPrecedence as bs, dimEquals as bt, disciplineFactorFor as bu, evaluate as bv, extractPropertyRulesFromMeta as bw, extractStatementRefs as bx, extractTagPropertyRules as by, filterTagsByVisibility as bz, type IEffortResolver as c, type IEffortRegistry as d, type EffortResolutionOptions as e, type ResolvedEffort as f, type EffortRegistrySource as g, type IEquipmentRegistry as h, type EquipmentStorageAdapter as i, type EffortStorageAdapter as j, type IRuntimeActionable as k, type IEventBus as l, type IRuntimeStack as m, type IRuntimeClock as n, type IJitCompiler as o, type INowProvider as p, type RuntimeStackOptions as q, type RuntimeError as r, type IEvent as s, type IRuntimeAction as t, type IAnalyticsEngine as u, type IRuntimeBlock as v, type IBehaviorContext as w, type BehaviorEventListener as x, type Unsubscribe$1 as y, type OutputOptions as z };

package/dist/{browserRuntimeNow-CqyFh_Jd.d.ts → browserRuntimeNow-DUJFkpUq.d.ts}

@@ -800,6 +800,13 @@ declare function compoundName(d: DimVector): string | undefined;
 
 type CalcOrigin = 'analyzed' | 'analyzed-estimated' | 'user';
 type CalcScope = 'segment' | 'workout' | 'store';
+/** A note summary that failed registration — surfaced, never silently dropped. */
+interface CalcRegistrationDiagnostic {
+    /** The summary calc id that failed to register. */
+    id: string;
+    /** Why it was skipped (the registration error message). */
+    message: string;
+}
 interface CalcNode {
     id: string;
     kind: 'metric' | 'lookup' | 'builtin' | 'wql' | 'expr';
@@ -994,6 +1001,8 @@ interface ShakeOutQueueOptions {
     readonly sources: readonly PropertyRuleInput[];
     readonly lookups?: LookupRegistry;
     readonly lastEffortSlug?: string;
+    /** Structural outputs may evaluate rules without surfacing diagnostics. */
+    readonly emitDiagnostics?: boolean;
 }
 /**
  * Extract `metrics:` and `summaries:` maps from a parsed frontmatter record
@@ -1006,12 +1015,13 @@ declare function extractPropertyRulesFromMeta(meta: Readonly<Record<string, unkn
  * `summaries.<key>` contributions on tags (including nested tags).
  */
 declare function extractTagPropertyRules(tags: TagIndex | undefined, slugs: readonly string[]): PropertyRuleInput[];
-/**
- * Compile `summaries:` equations across stacked Property Notes into workout-scope
- * `CalculationDefinition` records. Higher-precedence layers shadow lower layers
- * when both define the same summary key.
- */
+/** Compiled note summaries plus the unresolved dependencies found while compiling. */
+interface CompiledPropertySummaries {
+    defs: CalculationDefinition[];
+    diagnostics: CalcRegistrationDiagnostic[];
+}
 declare function compilePropertySummaryCalcs(sources: readonly PropertyRuleInput[]): CalculationDefinition[];
+declare function compilePropertySummaryCalcsWithDiagnostics(sources: readonly PropertyRuleInput[]): CompiledPropertySummaries;
 /**
  * Run the two-stage Metric Shake-Out Queue on a statement's MetricContainer.
  */
@@ -1541,6 +1551,21 @@ interface IBlockRef {
     markComplete(reason?: string): void;
 }
 
+/**
+ * INowProvider — the only seam for "what time is it" in the runtime.
+ * Events, actions, and behaviors that need a timestamp take a now-fn
+ * in their constructor; the runtime passes its single provider down.
+ * Tests pass a frozen clock so the timeline is deterministic.
+ */
+interface INowProvider {
+    now(): Date;
+    nowMs(): number;
+}
+/** Default provider: reads wall clock. */
+declare const wallClockNow: INowProvider;
+/** A provider that always returns the same Date (for tests). */
+declare function frozenNow(at: Date): INowProvider;
+
 /**
  * TimeSpan represents a discrete segment of a block's **Time** — a single
  * start/stop recording within the spans collection.
@@ -1580,21 +1605,6 @@ declare class TimeSpan implements TimeSpan$1 {
     get endDate(): Date | undefined;
 }
 
-/**
- * INowProvider — the only seam for "what time is it" in the runtime.
- * Events, actions, and behaviors that need a timestamp take a now-fn
- * in their constructor; the runtime passes its single provider down.
- * Tests pass a frozen clock so the timeline is deterministic.
- */
-interface INowProvider {
-    now(): Date;
-    nowMs(): number;
-}
-/** Default provider: reads wall clock. */
-declare const wallClockNow: INowProvider;
-/** A provider that always returns the same Date (for tests). */
-declare function frozenNow(at: Date): INowProvider;
-
 /**
  * IRuntimeClock provides time tracking for the runtime.
  *
@@ -1877,6 +1887,8 @@ interface IBehaviorContext {
     readonly block: IBlockRef;
     /** Current runtime clock */
     readonly clock: IRuntimeClock;
+    /** Live wall-clock provider, independent of execution snapshots. */
+    readonly nowProvider: INowProvider;
     /**
      * Current stack level (depth) of the block.
      * 0 = root block, 1 = first child, etc.
@@ -2991,4 +3003,4 @@ declare function getRuntimeNowMs(): number;
 /** Creates an INowProvider that reads the browser sender-clock when available. */
 declare function createBrowserRuntimeNow(): INowProvider;
 
-export { type SoundProfile as $, type AnalyticsContext as A, type BehaviorEventType as B, type IMemoryLocation as C, type IRuntimeBehavior as D, type EffortResolverOptions as E, type IBlockContext as F, type MetricVisibility as G, type BlockLifecycleOptions as H, type IEquipment as I, type CompletionDecision as J, type IRuntimeMemory as K, TypedMemoryReference as L, type MemoryTag as M, type MemorySearchCriteria as N, type OutputListener as O, type IMemoryReference as P, type RuntimeStackLogger as Q, type ReferenceIndex as R, type SubscribeOptions as S, TimeSpan as T, type Unsubscribe as U, type StackObserver as V, WhiteboardScript as W, type StackSnapshot as X, type StackListener as Y, MemoryTypeEnum as Z, type IAnchorValue as _, type ReferenceResolutionDefaults as a, type MemoryValueOf as a$, type ButtonConfig as a0, type IEventHandler as a1, type HandlerScope as a2, type IScriptRuntime as a3, type TestableBlockConfig as a4, type IRuntimeOptions as a5, ScriptRuntime as a6, type EventHandlerOptions as a7, type EventCallback as a8, type TimerState as a9, DIM_LENGTH as aA, DIM_MASS as aB, DIM_TIME as aC, DIM_ZERO as aD, DISCIPLINE_FACTORS as aE, type DisplayState as aF, EFFORT_DISCIPLINES as aG, EFFORT_REGISTRY_ORIGINS as aH, type EffortBaseAttributes as aI, type EffortDerivation as aJ, type EffortDiscipline as aK, type EffortMaterializer as aL, type EffortResolvedFrom as aM, type EvalContext as aN, type FenceDialect as aO, type FragmentDisplayState as aP, type FragmentState as aQ, type IAnalyticsProcessorDescriptor as aR, INTENSITY_TIERS as aS, type IScript as aT, type IntensityTier as aU, type InterceptMode as aV, type LookupFieldDef as aW, type LookupLayer as aX, MemoryLocation as aY, type MemoryType as aZ, type MemoryTypeMap as a_, type CalculationDefinition as aa, type PropertyRuleInput as ab, type IRealtimeProcessor as ac, type ISummaryProcessor as ad, type DimVector as ae, type CalcLine as af, type ExprNode as ag, type CalcScope as ah, type ILookupTable as ai, LookupRegistry as aj, type ProjectionResult as ak, ABSENT as al, type BinaryOp as am, type ButtonVariant as an, type ButtonsState as ao, CalcEvalError as ap, type CalcNode as aq, type CalcOrigin as ar, type CalcVariant as as, type ChildrenStatusState as at, type CompletionState as au, DEFAULT_RESOLVER_OPTIONS as av, DEFAULT_RUNTIME_OPTIONS as aw, DEFAULT_SOUND_PROFILE as ax, DIM_COUNT as ay, DIM_ENERGY as az, type IEffort as b, NAMED_COMPOUNDS as b0, type PropertySourceLayer as b1, type ReferenceCatalog as b2, type ResolvedReferences as b3, type RoundState as b4, type RuntimeState as b5, SEED_PRECEDENCE_RANK as b6, type ScriptRuntimeDependencies as b7, type SeedPrecedenceTier as b8, type ShakeOutQueueOptions as b9, getMetricVisibility as bA, getRuntimeNowMs as bB, isDimensionless as bC, isEffortDiscipline as bD, isFragmentTag as bE, num as bF, parseSoundTrigger as bG, resolveEntityRank as bH, resolveEntityTier as bI, resolveProfileRules as bJ, resolveSourceRank as bK, resolveSourceTier as bL, runMetricShakeOutQueue as bM, slugifyRefLabel as bN, str as bO, subDim as bP, truthy as bQ, wallClockNow as bR, type ShakeOutResult as ba, type SkippedDependencyDiagnostic as bb, type SoundRule as bc, type SoundTriggerAnchor as bd, type SoundTriggerPoint as be, type StackEvent as bf, type TimerDirection as bg, VISIBILITY_ICONS as bh, VISIBILITY_LABELS as bi, type Val as bj, addDim as bk, compilePropertySummaryCalcs as bl, compoundName as bm, createBrowserRuntimeNow as bn, createReferenceIndex as bo, dedupeEntitiesByPrecedence as bp, dimEquals as bq, disciplineFactorFor as br, evaluate as bs, extractPropertyRulesFromMeta as bt, extractStatementRefs as bu, extractTagPropertyRules as bv, filterTagsByVisibility as bw, formatDim as bx, formatSoundTrigger as by, frozenNow as bz, type IEffortResolver as c, type IEffortRegistry as d, type EffortResolutionOptions as e, type ResolvedEffort as f, type EffortRegistrySource as g, type IEquipmentRegistry as h, type EquipmentStorageAdapter as i, type EffortStorageAdapter as j, type IRuntimeActionable as k, type IEventBus as l, type IRuntimeStack as m, type IRuntimeClock as n, type IJitCompiler as o, type INowProvider as p, type RuntimeStackOptions as q, type RuntimeError as r, type IEvent as s, type IRuntimeAction as t, type IAnalyticsEngine as u, type IRuntimeBlock as v, type IBehaviorContext as w, type BehaviorEventListener as x, type Unsubscribe$1 as y, type OutputOptions as z };
+export { type SoundProfile as $, type AnalyticsContext as A, type BehaviorEventType as B, type IMemoryLocation as C, type IRuntimeBehavior as D, type EffortResolverOptions as E, type IBlockContext as F, type MetricVisibility as G, type BlockLifecycleOptions as H, type IEquipment as I, type CompletionDecision as J, type IRuntimeMemory as K, TypedMemoryReference as L, type MemoryTag as M, type MemorySearchCriteria as N, type OutputListener as O, type IMemoryReference as P, type RuntimeStackLogger as Q, type ReferenceIndex as R, type SubscribeOptions as S, TimeSpan as T, type Unsubscribe as U, type StackObserver as V, WhiteboardScript as W, type StackSnapshot as X, type StackListener as Y, MemoryTypeEnum as Z, type IAnchorValue as _, type ReferenceResolutionDefaults as a, type MemoryType as a$, type ButtonConfig as a0, type IEventHandler as a1, type HandlerScope as a2, type IScriptRuntime as a3, type TestableBlockConfig as a4, type IRuntimeOptions as a5, ScriptRuntime as a6, type EventHandlerOptions as a7, type EventCallback as a8, type TimerState as a9, DIM_COUNT as aA, DIM_ENERGY as aB, DIM_LENGTH as aC, DIM_MASS as aD, DIM_TIME as aE, DIM_ZERO as aF, DISCIPLINE_FACTORS as aG, type DisplayState as aH, EFFORT_DISCIPLINES as aI, EFFORT_REGISTRY_ORIGINS as aJ, type EffortBaseAttributes as aK, type EffortDerivation as aL, type EffortDiscipline as aM, type EffortMaterializer as aN, type EffortResolvedFrom as aO, type EvalContext as aP, type FenceDialect as aQ, type FragmentDisplayState as aR, type FragmentState as aS, type IAnalyticsProcessorDescriptor as aT, INTENSITY_TIERS as aU, type IScript as aV, type IntensityTier as aW, type InterceptMode as aX, type LookupFieldDef as aY, type LookupLayer as aZ, MemoryLocation as a_, type CalculationDefinition as aa, type PropertyRuleInput as ab, type IRealtimeProcessor as ac, type ISummaryProcessor as ad, type DimVector as ae, type CalcLine as af, type ExprNode as ag, type CalcScope as ah, type ILookupTable as ai, LookupRegistry as aj, type CalcRegistrationDiagnostic as ak, type ProjectionResult as al, ABSENT as am, type BinaryOp as an, type ButtonVariant as ao, type ButtonsState as ap, CalcEvalError as aq, type CalcNode as ar, type CalcOrigin as as, type CalcVariant as at, type ChildrenStatusState as au, type CompiledPropertySummaries as av, type CompletionState as aw, DEFAULT_RESOLVER_OPTIONS as ax, DEFAULT_RUNTIME_OPTIONS as ay, DEFAULT_SOUND_PROFILE as az, type IEffort as b, type MemoryTypeMap as b0, type MemoryValueOf as b1, NAMED_COMPOUNDS as b2, type PropertySourceLayer as b3, type ReferenceCatalog as b4, type ResolvedReferences as b5, type RoundState as b6, type RuntimeState as b7, SEED_PRECEDENCE_RANK as b8, type ScriptRuntimeDependencies as b9, formatDim as bA, formatSoundTrigger as bB, frozenNow as bC, getMetricVisibility as bD, getRuntimeNowMs as bE, isDimensionless as bF, isEffortDiscipline as bG, isFragmentTag as bH, num as bI, parseSoundTrigger as bJ, resolveEntityRank as bK, resolveEntityTier as bL, resolveProfileRules as bM, resolveSourceRank as bN, resolveSourceTier as bO, runMetricShakeOutQueue as bP, slugifyRefLabel as bQ, str as bR, subDim as bS, truthy as bT, wallClockNow as bU, type SeedPrecedenceTier as ba, type ShakeOutQueueOptions as bb, type ShakeOutResult as bc, type SkippedDependencyDiagnostic as bd, type SoundRule as be, type SoundTriggerAnchor as bf, type SoundTriggerPoint as bg, type StackEvent as bh, type TimerDirection as bi, VISIBILITY_ICONS as bj, VISIBILITY_LABELS as bk, type Val as bl, addDim as bm, compilePropertySummaryCalcs as bn, compilePropertySummaryCalcsWithDiagnostics as bo, compoundName as bp, createBrowserRuntimeNow as bq, createReferenceIndex as br, dedupeEntitiesByPrecedence as bs, dimEquals as bt, disciplineFactorFor as bu, evaluate as bv, extractPropertyRulesFromMeta as bw, extractStatementRefs as bx, extractTagPropertyRules as by, filterTagsByVisibility as bz, type IEffortResolver as c, type IEffortRegistry as d, type EffortResolutionOptions as e, type ResolvedEffort as f, type EffortRegistrySource as g, type IEquipmentRegistry as h, type EquipmentStorageAdapter as i, type EffortStorageAdapter as j, type IRuntimeActionable as k, type IEventBus as l, type IRuntimeStack as m, type IRuntimeClock as n, type IJitCompiler as o, type INowProvider as p, type RuntimeStackOptions as q, type RuntimeError as r, type IEvent as s, type IRuntimeAction as t, type IAnalyticsEngine as u, type IRuntimeBlock as v, type IBehaviorContext as w, type BehaviorEventListener as x, type Unsubscribe$1 as y, type OutputOptions as z };

package/dist/index.cjs

@@ -4609,7 +4609,7 @@ function tagToDocument(tag) {
     lines.push(`# ${tag.label}`);
     lines.push("");
     lines.push("```query");
-    lines.push(`find:note{${filterExpr}}`);
+    lines.push(`:note{${filterExpr}}`);
     lines.push("```");
   }
   return lines.join("\n");
@@ -7115,6 +7115,9 @@ var BehaviorContext = class {
    * capabilities.
    */
   _capabilities;
+  get nowProvider() {
+    return this.runtime.nowProvider;
+  }
   // ============================================================================
   // Event Subscription
   // ============================================================================
@@ -8018,15 +8021,10 @@ var CountdownTimerBehavior = class {
     }
     this.subscriptions.push(
       ctx.subscribe("tick", (_event, tickCtx) => {
-        const timer = readTimer(tickCtx);
-        if (!timer || timer.direction !== "down" || timer.durationMs === void 0) {
-          return [];
-        }
         if (mode === "complete-block" && tickCtx.block.isComplete) {
           return [];
         }
-        const elapsed = calculateElapsed(timer, tickCtx.clock.currentDate.getTime());
-        if (elapsed < timer.durationMs) return [];
+        if (!this.hasExpired(tickCtx)) return [];
         this.handleExpiry(tickCtx, mode);
         return [new ClearChildrenAction(tickCtx.block.key.toString())];
       }, { scope: "bubble" })
@@ -8055,6 +8053,10 @@ var CountdownTimerBehavior = class {
     return [];
   }
   onNext(ctx) {
+    if ((this.config.mode ?? "complete-block") === "complete-block" && !ctx.block.isComplete && this.hasExpired(ctx)) {
+      ctx.markComplete("timer-expired");
+      return [new PopBlockAction(), new ClearChildrenAction(ctx.block.key.toString())];
+    }
     if (this.config.required && !ctx.block.isComplete) {
       ctx.emitEvent({
         name: "timer:skip-attempt",
@@ -8126,6 +8128,18 @@ var CountdownTimerBehavior = class {
       }
     }
   }
+  /**
+   * True when the countdown has fully elapsed against the context's clock.
+   * Single definition of "expired" shared by the tick subscription and the
+   * Next-time reconcile, so display (spans) and runtime cannot diverge.
+   */
+  hasExpired(ctx) {
+    const timer = readTimer(ctx);
+    if (!timer || timer.direction !== "down" || timer.durationMs === void 0) {
+      return false;
+    }
+    return calculateElapsed(timer, ctx.nowProvider.nowMs()) >= timer.durationMs;
+  }
   getRemainingCountdownMs(ctx) {
     const timer = readTimer(ctx);
     if (!timer || timer.direction !== "down" || !timer.durationMs) {
@@ -8677,7 +8691,11 @@ var CalcUnitError = class extends Error {
   }
 };
 function composeMulUnit(a, aDim, b, bDim, resultDim) {
-  if (dimEquals(resultDim, DIM_ZERO)) return void 0;
+  if (dimEquals(resultDim, DIM_ZERO)) {
+    if (a && !b) return a;
+    if (b && !a) return b;
+    return dimEquals(aDim, bDim) ? a ?? b : void 0;
+  }
   const parts = [];
   for (const [u, d] of [[a, aDim], [b, bDim]]) {
     if (!u || dimEquals(d, DIM_ZERO)) continue;
@@ -9676,34 +9694,51 @@ function extractTagPropertyRules(tags2, slugs) {
   for (const slug of slugs) {
     const resolved = resolveTagContributions(tags2, slug);
     if (resolved.metrics.length === 0) continue;
-    const metrics = {};
-    const summaries = {};
-    for (const m of resolved.metrics) {
-      const key = m.type.trim();
-      if (!key) continue;
-      if (key.startsWith("summaries.")) {
-        const subKey = key.slice("summaries.".length).trim();
-        if (subKey && !(subKey in summaries)) {
-          summaries[subKey] = String(m.value);
+    const tagMetrics = {};
+    const tagSummaries = {};
+    const categoryMetrics = {};
+    const categorySummaries = {};
+    for (const involvedSlug of resolved.tags) {
+      const definition = tags2.resolve(involvedSlug);
+      if (!definition) continue;
+      const metrics = definition.isCategory ? categoryMetrics : tagMetrics;
+      const summaries = definition.isCategory ? categorySummaries : tagSummaries;
+      for (const m of definition.contributions) {
+        if (m.kind !== "metric") continue;
+        const key = m.type.trim();
+        if (!key) continue;
+        if (key.startsWith("summaries.")) {
+          const subKey = key.slice("summaries.".length).trim();
+          if (subKey && !(subKey in summaries)) {
+            summaries[subKey] = String(m.value);
+          }
+        } else if (!(key in metrics)) {
+          metrics[key] = m.unit ? `${String(m.value)} ${m.unit}` : m.value === null || typeof m.value === "boolean" ? String(m.value) : m.value;
         }
-      } else if (!(key in metrics)) {
-        metrics[key] = m.unit ? `${String(m.value)} ${m.unit}` : m.value === null || typeof m.value === "boolean" ? String(m.value) : m.value;
       }
     }
-    if (Object.keys(metrics).length > 0 || Object.keys(summaries).length > 0) {
-      rules.push({
-        layer: "tag",
-        sourceSlug: slug,
-        metrics,
-        summaries
-      });
+    if (Object.keys(tagMetrics).length > 0 || Object.keys(tagSummaries).length > 0) {
+      rules.push({ layer: "tag", sourceSlug: slug, metrics: tagMetrics, summaries: tagSummaries });
+    }
+    if (Object.keys(categoryMetrics).length > 0 || Object.keys(categorySummaries).length > 0) {
+      rules.push({ layer: "category", sourceSlug: slug, metrics: categoryMetrics, summaries: categorySummaries });
     }
   }
   return rules;
 }
+var SUMMARY_LAYER_PRECEDENCE = {
+  note: 6,
+  tag: 5,
+  effort: 4,
+  equipment: 3,
+  category: 1
+};
 function compilePropertySummaryCalcs(sources) {
+  return compilePropertySummaryCalcsWithDiagnostics(sources).defs;
+}
+function compilePropertySummaryCalcsWithDiagnostics(sources) {
   const ordered = [...sources].sort(
-    (a, b) => LAYER_PRECEDENCE[b.layer] - LAYER_PRECEDENCE[a.layer]
+    (a, b) => SUMMARY_LAYER_PRECEDENCE[b.layer] - SUMMARY_LAYER_PRECEDENCE[a.layer]
   );
   const chosen = /* @__PURE__ */ new Map();
   for (const source of ordered) {
@@ -9728,6 +9763,19 @@ function compilePropertySummaryCalcs(sources) {
       }
     }
   }
+  const diagnostics = [];
+  for (const [key, expr2] of chosen) {
+    try {
+      const missing = [...collectRequiredRefs(parseCalcLine(`summary = ${expr2}`).expr)].filter((ref) => !customAtomsMap.has(ref) && STREAM_ATOMS[ref] === void 0 && CONTEXT_ATOMS[ref] === void 0);
+      for (const ref of missing) {
+        customAtomsMap.set(ref, DIM_ZERO);
+      }
+      if (missing.length > 0) {
+        diagnostics.push({ id: key, message: `Summary ${key}: missing ${[...new Set(missing)].join(", ")}` });
+      }
+    } catch {
+    }
+  }
   const customAtoms = Object.fromEntries(customAtomsMap);
   const defs = [];
   for (const [key, expr2] of chosen) {
@@ -9751,7 +9799,7 @@ function compilePropertySummaryCalcs(sources) {
     } catch {
     }
   }
-  return defs;
+  return { defs, diagnostics };
 }
 function collectRequiredRefs(node, into = /* @__PURE__ */ new Set()) {
   if (!node) return into;
@@ -10006,6 +10054,7 @@ function runMetricShakeOutQueue(container, options) {
   }
   const unresolved = new Set(pendingEquations);
   const notApplicable = /* @__PURE__ */ new Set();
+  const unresolvable = /* @__PURE__ */ new Set();
   const makeEvalContext = () => ({
     resolveRef: (name2) => readContainerMetricAtom(container, name2, inferredDims, options.lastEffortSlug),
     callFunction: (name2, args, rawArgs) => {
@@ -10029,7 +10078,12 @@ function runMetricShakeOutQueue(container, options) {
         continue;
       }
       const val = evaluate(rule.ast, ctx);
-      if (val.kind !== "number") continue;
+      if (val.kind !== "number") {
+        unresolved.delete(rule);
+        unresolvable.add(rule);
+        progressed = true;
+        continue;
+      }
       let dim = val.dim;
       if (rule.unit && AUTHORITATIVE_CASTS[rule.unit]) {
         dim = DIM_ZERO;
@@ -10061,14 +10115,8 @@ function runMetricShakeOutQueue(container, options) {
   const deferredRuntime = [];
   const diagnostics = [];
   const finalCtx = makeEvalContext();
-  for (const rule of unresolved) {
-    if (notApplicable.has(rule)) continue;
-    const missing = rule.dependencies.filter((dep) => finalCtx.resolveRef(dep).kind === "absent");
-    if (missing.length === 0) continue;
-    if (options.stage === "plan") {
-      deferredRuntime.push(rule.key);
-      continue;
-    }
+  const emitDiagnostic = (rule, missing) => {
+    if (options.emitDiagnostics === false) return;
     const diag = {
       target: rule.key,
       expression: rule.expression,
@@ -10080,8 +10128,8 @@ function runMetricShakeOutQueue(container, options) {
     container.add({
       type: wodWikiCore.MetricType.Diagnostic,
       name: `diagnostic.${rule.key}`,
-      value: `Skipped ${rule.key}: missing ${missing.join(", ")}`,
-      image: `Skipped ${rule.key} (missing ${missing.join(", ")})`,
+      value: `Skipped ${rule.key}: ${missing.length > 0 ? `missing ${missing.join(", ")}` : "expression could not be evaluated"}`,
+      image: `Skipped ${rule.key} (${missing.length > 0 ? `missing ${missing.join(", ")}` : "expression could not be evaluated"})`,
       origin: "diagnostic",
       metadata: {
         diagnostic: "skipped-dependency",
@@ -10092,6 +10140,23 @@ function runMetricShakeOutQueue(container, options) {
         missing
       }
     });
+  };
+  for (const rule of unresolved) {
+    if (notApplicable.has(rule)) continue;
+    const missing = rule.dependencies.filter((dep) => finalCtx.resolveRef(dep).kind === "absent");
+    if (missing.length === 0) continue;
+    if (options.stage === "plan") {
+      deferredRuntime.push(rule.key);
+      continue;
+    }
+    emitDiagnostic(rule, missing);
+  }
+  for (const rule of unresolvable) {
+    if (options.stage === "plan") {
+      deferredRuntime.push(rule.key);
+      continue;
+    }
+    emitDiagnostic(rule, []);
   }
   return {
     resolved,
@@ -12438,6 +12503,8 @@ var CalcEngine = class {
   activatedTags = /* @__PURE__ */ new Set();
   /** The tags the run activates — a note-level bundle of attachments. */
   runTags;
+  /** Registration diagnostics are stamped once per workout, on the first leaf. */
+  summaryDiagnosticsStamped = false;
   /**
    * Whether a calculation runs here.
    *
@@ -12474,12 +12541,41 @@ var CalcEngine = class {
     const appliedTags = this.appliedTags(output);
     const tagSources = extractTagPropertyRules(this.deps.tags, appliedTags);
     const allSources = [...tagSources, ...this.deps.propertySources ?? []];
+    const hasExerciseStatement = output.metrics.rawMetrics.some((metric) => metric.type === wodWikiCore.MetricType.Effort && String(metric.value ?? metric.image ?? "").trim().toLowerCase() !== "rest");
+    if (!this.summaryDiagnosticsStamped && (this.deps.summaryDiagnostics?.length ?? 0) > 0) {
+      this.summaryDiagnosticsStamped = true;
+      for (const diagnostic of this.deps.summaryDiagnostics ?? []) {
+        output.metrics.add({
+          type: wodWikiCore.MetricType.Diagnostic,
+          name: `diagnostic.${diagnostic.id}`,
+          value: diagnostic.message,
+          image: diagnostic.message,
+          origin: "diagnostic",
+          timestamp: /* @__PURE__ */ new Date(),
+          metadata: { diagnostic: "summary-registration", target: diagnostic.id }
+        });
+      }
+    }
     if (allSources.length > 0) {
+      const spanMs = typeof output.timeSpan?.started === "number" && typeof output.timeSpan.ended === "number" ? output.timeSpan.ended - output.timeSpan.started : 0;
+      const existingElapsed = output.metrics.rawMetrics.map((m) => m.type === wodWikiCore.MetricType.Elapsed && typeof m.value === "number" ? m.value : void 0).reduce((found, v) => v ?? found, void 0);
+      if (spanMs > 0 && (existingElapsed === void 0 || existingElapsed === 0)) {
+        output.metrics.add({
+          type: wodWikiCore.MetricType.Elapsed,
+          name: "elapsed",
+          value: spanMs,
+          unit: "ms",
+          image: `${spanMs} ms`,
+          origin: "analyzed",
+          timestamp: /* @__PURE__ */ new Date()
+        });
+      }
       runMetricShakeOutQueue(output.metrics, {
         stage: "log",
         sources: allSources,
         lookups: this.deps.lookups,
-        lastEffortSlug: this.lastSegmentEffort
+        lastEffortSlug: this.lastSegmentEffort,
+        emitDiagnostics: hasExerciseStatement
       });
     }
     const atoms = buildSegmentAtoms(output, this.lastSegmentEffort);
@@ -13718,12 +13814,21 @@ function createCalcStack(options) {
   const allTagSlugs = (options.tags?.list() ?? []).map((t2) => t2.slug);
   const tagRules = extractTagPropertyRules(options.tags, allTagSlugs);
   const combinedSources = [...options.propertySources ?? [], ...tagRules];
+  const diagnostics = [];
   if (combinedSources.length > 0) {
-    for (const def of compilePropertySummaryCalcs(combinedSources)) {
-      registry.register(def);
+    const compiled = compilePropertySummaryCalcsWithDiagnostics(combinedSources);
+    diagnostics.push(...compiled.diagnostics);
+    for (const def of compiled.defs) {
+      try {
+        registry.register(def);
+      } catch (err) {
+        const message = `Skipped summary ${def.id}: ${err instanceof Error ? err.message : String(err)}`;
+        diagnostics.push({ id: def.id, message });
+        console.error(`[createCalcStack] ${message}`);
+      }
     }
   }
-  return { lookups, registry };
+  return { lookups, registry, diagnostics };
 }
 function createCalcEngine(dialect, options) {
   const stack = createCalcStack(options);
@@ -13733,7 +13838,8 @@ function createCalcEngine(dialect, options) {
     userProfile: options.userProfile,
     tags: options.tags,
     activeTags: options.activeTags,
-    propertySources: options.propertySources
+    propertySources: options.propertySources,
+    summaryDiagnostics: stack.diagnostics
   });
 }
 
@@ -15994,6 +16100,7 @@ exports.commonFixtureSet = commonFixtureSet;
 exports.compareStatement = compareStatement;
 exports.compileLineForm = compileLineForm;
 exports.compilePropertySummaryCalcs = compilePropertySummaryCalcs;
+exports.compilePropertySummaryCalcsWithDiagnostics = compilePropertySummaryCalcsWithDiagnostics;
 exports.composeDivUnit = composeDivUnit;
 exports.composeMulUnit = composeMulUnit;
 exports.compoundName = compoundName;