@bitcobblers/wod-wiki-core 0.37.2137 → 0.37.2140

package/dist/index.d.cts

@@ -114,6 +114,14 @@ declare enum MetricType {
     Total = "total",
     Rep = "rep",
     Effort = "effort",
+    /**
+     * **Equipment** (Core) — ordered deduplicated canonical equipment slugs for a
+     * statement (e.g. `["dumbbell"]` from `10 Dumbbell Snatch`). One metric per
+     * statement; `metadata.refs` carries structured ReferenceRef entries,
+     * `metadata.source` the authored label, `metadata.diagnostics` any
+     * unknown/ambiguous/malformed reference findings.
+     */
+    Equipment = "equipment",
     Distance = "distance",
     Rounds = "rounds",
     CurrentRound = "current-round",
@@ -483,6 +491,66 @@ declare function systemDefaultUnit(dimension: DimensionKey): string | undefined;
  */
 declare function convertViaCatalog(value: number, from: string, to: string): number;
 
+/**
+ * Structured canonical reference metadata — the additive payload shapes hung on
+ * `IMetric.metadata` by the shared reference resolver
+ * (`@bitcobblers/wod-wiki-lang` → `createReferenceIndex`).
+ *
+ * Pure data: survives the stored-logs / JSON round-trip so runtime consumers
+ * and the editor can read canonical refs without re-parsing authored labels.
+ */
+/** Kind of registry entity a canonical reference points at. */
+type ReferenceKind = 'effort' | 'equipment';
+/**
+ * A canonical, resolved reference (slug + canonical display label).
+ * Durable identity lives in `slug`; `label` is display-only.
+ */
+interface ReferenceRef {
+    kind: ReferenceKind;
+    /** Canonical identifier — lowercase, hyphenated, unique per kind. */
+    slug: string;
+    /** Canonical human-readable label (e.g. "Snatch", "Dumbbell"). */
+    label: string;
+}
+/** Why a reference could not be resolved. Stable vocabulary for editor UIs. */
+type ReferenceDiagnosticReason = /** Remaining movement not found exactly (no slug/alias match). */ 'unknown-effort' | /** Authored equipment token is not a known equipment slug/alias. */ 'unknown-equipment' | /** Multiple efforts claim the same exact slug/alias. */ 'ambiguous-effort' | /** Multiple equipment entities claim the same exact slug/alias. */ 'ambiguous-equipment' | /** Explicit ref names an entity missing from the catalog. */ 'invalid-explicit' | /** Explicit ref contradicts the authored line (e.g. different equipment prefix). */ 'conflict' | /** Explicit JSON ref could not be parsed. */ 'malformed-json';
+/** A visible, consumable reference-resolution finding. */
+interface ReferenceDiagnostic {
+    reason: ReferenceDiagnosticReason;
+    /** Human-readable explanation (author-facing). */
+    message: string;
+    /** The authored fragment that failed, when attributable. */
+    token?: string;
+    /** Stable-ordered candidate slugs for "select existing" actions. */
+    candidates?: string[];
+}
+/** How a statement's references were resolved. */
+type ReferenceMatchKind = 'explicit' | 'split' | 'whole' | 'default' | 'none';
+/**
+ * `IMetric.metadata` payload under the `references` key: canonical refs,
+ * authored source, and diagnostics for one statement/block label.
+ */
+interface ReferenceMetadata {
+    /** How the label was resolved. */
+    matched: ReferenceMatchKind;
+    /** Full authored label — never rewritten. */
+    source: string;
+    /** Canonical resolved refs (effort first, then ordered deduped equipment). */
+    refs?: ReferenceRef[];
+    /** Remaining movement text after equipment-prefix strip (split path). */
+    remaining?: string;
+    /** Unknown/ambiguous/invalid findings — never silently dropped. */
+    diagnostics?: ReferenceDiagnostic[];
+}
+/** Metadata key under which {@link ReferenceMetadata} is stored on a metric. */
+declare const REFERENCE_METADATA_KEY = "references";
+/**
+ * Read reference metadata off a metric's metadata record. Validates shape
+ * before trusting persisted input: unknown-shape payloads are ignored rather
+ * than partially honored.
+ */
+declare function getReferenceMetadata(metadata: Record<string, unknown> | undefined): ReferenceMetadata | undefined;
+
 interface ICodeMetadata {
     line: number;
     startOffset: number;
@@ -1271,6 +1339,17 @@ interface BlockEffort {
     sourcePath?: string;
     createdAt: number;
 }
+/** Containment link block → canonical equipment, mirroring BlockEffort. */
+interface BlockEquipment {
+    id: string;
+    noteId: string;
+    blockId: string;
+    blockContentId?: string;
+    equipmentSlug: string;
+    isStatic?: boolean;
+    sourcePath?: string;
+    createdAt: number;
+}
 interface Membership {
     id: string;
     displayName: string;
@@ -1314,8 +1393,11 @@ type SectionType = 'title' | 'markdown' | 'time' | 'log' | 'frontmatter' | 'embe
 type WorkoutSectionType = Extract<SectionType, FenceDialect>;
 /** Type guard for workout sections */
 declare function isWorkoutSectionType(type: SectionType): type is WorkoutSectionType;
-/** Typed front matter subtypes */
-type FrontMatterSubtype = 'default' | 'youtube' | 'strava' | 'amazon' | 'file' | 'effort';
+/**
+ * Typed front matter subtypes. `effort`/`equipment` are registry definition
+ * notes (family `markdown/efforts|equipment/<slug>.md`).
+ */
+type FrontMatterSubtype = 'default' | 'youtube' | 'strava' | 'amazon' | 'file' | 'effort' | 'equipment';
 /**
  * Represents a single WOD block within the markdown document
  */
@@ -1477,17 +1559,49 @@ declare function mapNoteBlockChanges(blocks: Record<string, NoteBlock>, changes:
 declare function buildRawContent(sections: Section[]): string;
 declare function calculateTotalLines(sections: Section[]): number;
 
+/**
+ * Source-preserving frontmatter property patching.
+ *
+ * `patchFrontmatterProperty` rewrites exactly one property's source range
+ * (key line plus any deeper-indented subtree) inside the leading YAML
+ * frontmatter block of a markdown document. Everything else — comments,
+ * sibling/unknown nested properties, line-ending style, body — passes
+ * through byte-identical, so editors can apply the old→new diff as a single
+ * undo step instead of reserializing flat metadata.
+ *
+ * ponytail: bounded line/indent range patch, not a YAML engine — explicit
+ * path segments only (no key parsing beyond `[A-Za-z][\w.-]*`), two-space
+ * nesting; upgrade path is swapping the range finder for a CST if formats
+ * ever outgrow it.
+ */
+type FrontmatterPatchValue = string | number | readonly string[] | null;
+/**
+ * Patch a single frontmatter property in a markdown document.
+ *
+ * `path` segments are explicit: a single segment is a literal key verbatim
+ * (`["metrics.equipment"]` stays a flat dotted key); multiple segments walk
+ * nested two-space-indented maps (`["baseAttributes","met"]`).
+ *
+ * `value` scalars replace the property line (a safe inline comment on the old
+ * line is carried over); arrays serialize as block lists; `null` removes the
+ * property range — and any now-childless nested parent left behind.
+ * Documents without frontmatter gain a minimal block with the original raw
+ * text preserved as body; absent properties are inserted at the end of their
+ * parent block. Unpatchable input (empty path, invalid key) returns `raw`.
+ */
+declare function patchFrontmatterProperty(raw: string, path: readonly string[], value: FrontmatterPatchValue): string;
+
 /**
  * Auto-generated build version metadata.
  * Do not edit directly; updated by scripts/stamp-version.ts
  */
-declare const VERSION = "0.37.2137";
-declare const GIT_SHA = "b82a721";
-declare const BUILD_TIME = "2026-10-16T20:56:02.597Z";
+declare const VERSION = "0.37.2140";
+declare const GIT_SHA = "bcf7960";
+declare const BUILD_TIME = "2026-10-18T21:43:29.081Z";
 declare const SEMVER: {
-    readonly version: "0.37.2137";
-    readonly gitSha: "b82a721";
-    readonly buildTime: "2026-10-16T20:56:02.597Z";
+    readonly version: "0.37.2140";
+    readonly gitSha: "bcf7960";
+    readonly buildTime: "2026-10-18T21:43:29.081Z";
 };
 
-export { type AnalyticsDataPoint, type AnalyticsGraphConfig, type AnalyticsGroup, type Attachment, BUILD_TIME, type BlockEffort, type BlockIndexRow, BlockKey, type BlockRevision, type CatalogBackfillState, CodeMetadata, CodeStatement, type DialectAnalysis, type DimensionKey, type DisplayStatus, type EventGrain, type EventRecord, type FenceDialect, type FieldCatalogEntry, type FieldContribution, type FieldLeaf, type FieldRef, type FieldSourceRecord, type FieldValueKind, type FieldValueRecord, type FrontMatterSubtype, GIT_SHA, type IBlockKey, type ICodeMetadata, type ICodeStatement, type IDialect, type IDialectTagDescriptor, type IMetric, type IMetricOwnershipResolver, type IMetricSource, type IOutputStatement, type IScript, KNOWN_OUTPUT_TYPES, KNOWN_SECTION_WIDGETS, LEGACY_ORIGIN_TO_OWNERSHIP_LAYER, METRIC_OWNERSHIP_LAYER_CHAIN, type Membership, Metric, type MetricAction, MetricContainer, type MetricFilter, type MetricOrigin, type MetricOwnershipLayer, type MetricOwnershipLedger, type MetricOwnershipOutcome, type MetricOwnershipPromotionCandidate, type MetricOwnershipQuery, type MetricOwnershipResolvedContribution, type MetricOwnershipTypeExplanation, type MetricTemporal, MetricType, type MetricWithOptionalOwnershipLayer, NOTEBOOK_TAG_PREFIX, type Note, type NoteBlock, type NoteBlockChange, type NoteBlockKind, type NoteKind, type NoteTag, type Notebook, type NullValueKind, type Origin, OutputStatement, type OutputStatementOptions, type OutputStatementType, OwnershipResolver, type Page, type PageNote, type ParseError, ParsedCodeStatement, type ReconcileNoteBlocksOptions, type ReducerStats, type ResultOrigin, SEMVER, SYSTEM_DEFAULT_OUTPUT_UNIT, type ScriptBlock, type ScriptBlockState, type Section, type SectionDocument, type SectionRecognitionOptions, type SectionType, type Segment, type Session, type StoredOutputStatement, type SummaryCoverage, type Tag, type TagType, type TagTypeRecord, type TimeSpan, UNIT_CATALOG, UnitConversionError, type UnitDefinition, type UnitErrorCode, VALID_FENCE_DIALECTS, VERSION, type VisualizerFilter, type VisualizerSize, type WorkoutResults, type WorkoutSectionType, actionableSectionKind, blockContentId, buildRawContent, calculateTotalLines, convertViaCatalog, createMetricOwnershipLedger, detectScriptBlocks, dimensionKeyOf, extractBlockContent, fieldRefFromKey, fieldRefKey, findBlockAtLine, flattenFieldLeaves, fromNotebookTag, getMetricOwnershipLayer, isNotebookTag, isWorkoutSectionType, lookupUnit, mapNoteBlockChanges, matchDialectFence, normalizeFieldComponent, normalizeFieldPath, ownershipRank, parseDocumentSections, reconcileNoteBlocks, resolveLayer, runAffordance, systemDefaultUnit, toNotebookTag, validateNoteBlocks, valueKindOf };
+export { type AnalyticsDataPoint, type AnalyticsGraphConfig, type AnalyticsGroup, type Attachment, BUILD_TIME, type BlockEffort, type BlockEquipment, type BlockIndexRow, BlockKey, type BlockRevision, type CatalogBackfillState, CodeMetadata, CodeStatement, type DialectAnalysis, type DimensionKey, type DisplayStatus, type EventGrain, type EventRecord, type FenceDialect, type FieldCatalogEntry, type FieldContribution, type FieldLeaf, type FieldRef, type FieldSourceRecord, type FieldValueKind, type FieldValueRecord, type FrontMatterSubtype, type FrontmatterPatchValue, GIT_SHA, type IBlockKey, type ICodeMetadata, type ICodeStatement, type IDialect, type IDialectTagDescriptor, type IMetric, type IMetricOwnershipResolver, type IMetricSource, type IOutputStatement, type IScript, KNOWN_OUTPUT_TYPES, KNOWN_SECTION_WIDGETS, LEGACY_ORIGIN_TO_OWNERSHIP_LAYER, METRIC_OWNERSHIP_LAYER_CHAIN, type Membership, Metric, type MetricAction, MetricContainer, type MetricFilter, type MetricOrigin, type MetricOwnershipLayer, type MetricOwnershipLedger, type MetricOwnershipOutcome, type MetricOwnershipPromotionCandidate, type MetricOwnershipQuery, type MetricOwnershipResolvedContribution, type MetricOwnershipTypeExplanation, type MetricTemporal, MetricType, type MetricWithOptionalOwnershipLayer, NOTEBOOK_TAG_PREFIX, type Note, type NoteBlock, type NoteBlockChange, type NoteBlockKind, type NoteKind, type NoteTag, type Notebook, type NullValueKind, type Origin, OutputStatement, type OutputStatementOptions, type OutputStatementType, OwnershipResolver, type Page, type PageNote, type ParseError, ParsedCodeStatement, REFERENCE_METADATA_KEY, type ReconcileNoteBlocksOptions, type ReducerStats, type ReferenceDiagnostic, type ReferenceDiagnosticReason, type ReferenceKind, type ReferenceMatchKind, type ReferenceMetadata, type ReferenceRef, type ResultOrigin, SEMVER, SYSTEM_DEFAULT_OUTPUT_UNIT, type ScriptBlock, type ScriptBlockState, type Section, type SectionDocument, type SectionRecognitionOptions, type SectionType, type Segment, type Session, type StoredOutputStatement, type SummaryCoverage, type Tag, type TagType, type TagTypeRecord, type TimeSpan, UNIT_CATALOG, UnitConversionError, type UnitDefinition, type UnitErrorCode, VALID_FENCE_DIALECTS, VERSION, type VisualizerFilter, type VisualizerSize, type WorkoutResults, type WorkoutSectionType, actionableSectionKind, blockContentId, buildRawContent, calculateTotalLines, convertViaCatalog, createMetricOwnershipLedger, detectScriptBlocks, dimensionKeyOf, extractBlockContent, fieldRefFromKey, fieldRefKey, findBlockAtLine, flattenFieldLeaves, fromNotebookTag, getMetricOwnershipLayer, getReferenceMetadata, isNotebookTag, isWorkoutSectionType, lookupUnit, mapNoteBlockChanges, matchDialectFence, normalizeFieldComponent, normalizeFieldPath, ownershipRank, parseDocumentSections, patchFrontmatterProperty, reconcileNoteBlocks, resolveLayer, runAffordance, systemDefaultUnit, toNotebookTag, validateNoteBlocks, valueKindOf };

package/dist/index.d.ts

@@ -114,6 +114,14 @@ declare enum MetricType {
     Total = "total",
     Rep = "rep",
     Effort = "effort",
+    /**
+     * **Equipment** (Core) — ordered deduplicated canonical equipment slugs for a
+     * statement (e.g. `["dumbbell"]` from `10 Dumbbell Snatch`). One metric per
+     * statement; `metadata.refs` carries structured ReferenceRef entries,
+     * `metadata.source` the authored label, `metadata.diagnostics` any
+     * unknown/ambiguous/malformed reference findings.
+     */
+    Equipment = "equipment",
     Distance = "distance",
     Rounds = "rounds",
     CurrentRound = "current-round",
@@ -483,6 +491,66 @@ declare function systemDefaultUnit(dimension: DimensionKey): string | undefined;
  */
 declare function convertViaCatalog(value: number, from: string, to: string): number;
 
+/**
+ * Structured canonical reference metadata — the additive payload shapes hung on
+ * `IMetric.metadata` by the shared reference resolver
+ * (`@bitcobblers/wod-wiki-lang` → `createReferenceIndex`).
+ *
+ * Pure data: survives the stored-logs / JSON round-trip so runtime consumers
+ * and the editor can read canonical refs without re-parsing authored labels.
+ */
+/** Kind of registry entity a canonical reference points at. */
+type ReferenceKind = 'effort' | 'equipment';
+/**
+ * A canonical, resolved reference (slug + canonical display label).
+ * Durable identity lives in `slug`; `label` is display-only.
+ */
+interface ReferenceRef {
+    kind: ReferenceKind;
+    /** Canonical identifier — lowercase, hyphenated, unique per kind. */
+    slug: string;
+    /** Canonical human-readable label (e.g. "Snatch", "Dumbbell"). */
+    label: string;
+}
+/** Why a reference could not be resolved. Stable vocabulary for editor UIs. */
+type ReferenceDiagnosticReason = /** Remaining movement not found exactly (no slug/alias match). */ 'unknown-effort' | /** Authored equipment token is not a known equipment slug/alias. */ 'unknown-equipment' | /** Multiple efforts claim the same exact slug/alias. */ 'ambiguous-effort' | /** Multiple equipment entities claim the same exact slug/alias. */ 'ambiguous-equipment' | /** Explicit ref names an entity missing from the catalog. */ 'invalid-explicit' | /** Explicit ref contradicts the authored line (e.g. different equipment prefix). */ 'conflict' | /** Explicit JSON ref could not be parsed. */ 'malformed-json';
+/** A visible, consumable reference-resolution finding. */
+interface ReferenceDiagnostic {
+    reason: ReferenceDiagnosticReason;
+    /** Human-readable explanation (author-facing). */
+    message: string;
+    /** The authored fragment that failed, when attributable. */
+    token?: string;
+    /** Stable-ordered candidate slugs for "select existing" actions. */
+    candidates?: string[];
+}
+/** How a statement's references were resolved. */
+type ReferenceMatchKind = 'explicit' | 'split' | 'whole' | 'default' | 'none';
+/**
+ * `IMetric.metadata` payload under the `references` key: canonical refs,
+ * authored source, and diagnostics for one statement/block label.
+ */
+interface ReferenceMetadata {
+    /** How the label was resolved. */
+    matched: ReferenceMatchKind;
+    /** Full authored label — never rewritten. */
+    source: string;
+    /** Canonical resolved refs (effort first, then ordered deduped equipment). */
+    refs?: ReferenceRef[];
+    /** Remaining movement text after equipment-prefix strip (split path). */
+    remaining?: string;
+    /** Unknown/ambiguous/invalid findings — never silently dropped. */
+    diagnostics?: ReferenceDiagnostic[];
+}
+/** Metadata key under which {@link ReferenceMetadata} is stored on a metric. */
+declare const REFERENCE_METADATA_KEY = "references";
+/**
+ * Read reference metadata off a metric's metadata record. Validates shape
+ * before trusting persisted input: unknown-shape payloads are ignored rather
+ * than partially honored.
+ */
+declare function getReferenceMetadata(metadata: Record<string, unknown> | undefined): ReferenceMetadata | undefined;
+
 interface ICodeMetadata {
     line: number;
     startOffset: number;
@@ -1271,6 +1339,17 @@ interface BlockEffort {
     sourcePath?: string;
     createdAt: number;
 }
+/** Containment link block → canonical equipment, mirroring BlockEffort. */
+interface BlockEquipment {
+    id: string;
+    noteId: string;
+    blockId: string;
+    blockContentId?: string;
+    equipmentSlug: string;
+    isStatic?: boolean;
+    sourcePath?: string;
+    createdAt: number;
+}
 interface Membership {
     id: string;
     displayName: string;
@@ -1314,8 +1393,11 @@ type SectionType = 'title' | 'markdown' | 'time' | 'log' | 'frontmatter' | 'embe
 type WorkoutSectionType = Extract<SectionType, FenceDialect>;
 /** Type guard for workout sections */
 declare function isWorkoutSectionType(type: SectionType): type is WorkoutSectionType;
-/** Typed front matter subtypes */
-type FrontMatterSubtype = 'default' | 'youtube' | 'strava' | 'amazon' | 'file' | 'effort';
+/**
+ * Typed front matter subtypes. `effort`/`equipment` are registry definition
+ * notes (family `markdown/efforts|equipment/<slug>.md`).
+ */
+type FrontMatterSubtype = 'default' | 'youtube' | 'strava' | 'amazon' | 'file' | 'effort' | 'equipment';
 /**
  * Represents a single WOD block within the markdown document
  */
@@ -1477,17 +1559,49 @@ declare function mapNoteBlockChanges(blocks: Record<string, NoteBlock>, changes:
 declare function buildRawContent(sections: Section[]): string;
 declare function calculateTotalLines(sections: Section[]): number;
 
+/**
+ * Source-preserving frontmatter property patching.
+ *
+ * `patchFrontmatterProperty` rewrites exactly one property's source range
+ * (key line plus any deeper-indented subtree) inside the leading YAML
+ * frontmatter block of a markdown document. Everything else — comments,
+ * sibling/unknown nested properties, line-ending style, body — passes
+ * through byte-identical, so editors can apply the old→new diff as a single
+ * undo step instead of reserializing flat metadata.
+ *
+ * ponytail: bounded line/indent range patch, not a YAML engine — explicit
+ * path segments only (no key parsing beyond `[A-Za-z][\w.-]*`), two-space
+ * nesting; upgrade path is swapping the range finder for a CST if formats
+ * ever outgrow it.
+ */
+type FrontmatterPatchValue = string | number | readonly string[] | null;
+/**
+ * Patch a single frontmatter property in a markdown document.
+ *
+ * `path` segments are explicit: a single segment is a literal key verbatim
+ * (`["metrics.equipment"]` stays a flat dotted key); multiple segments walk
+ * nested two-space-indented maps (`["baseAttributes","met"]`).
+ *
+ * `value` scalars replace the property line (a safe inline comment on the old
+ * line is carried over); arrays serialize as block lists; `null` removes the
+ * property range — and any now-childless nested parent left behind.
+ * Documents without frontmatter gain a minimal block with the original raw
+ * text preserved as body; absent properties are inserted at the end of their
+ * parent block. Unpatchable input (empty path, invalid key) returns `raw`.
+ */
+declare function patchFrontmatterProperty(raw: string, path: readonly string[], value: FrontmatterPatchValue): string;
+
 /**
  * Auto-generated build version metadata.
  * Do not edit directly; updated by scripts/stamp-version.ts
  */
-declare const VERSION = "0.37.2137";
-declare const GIT_SHA = "b82a721";
-declare const BUILD_TIME = "2026-10-16T20:56:02.597Z";
+declare const VERSION = "0.37.2140";
+declare const GIT_SHA = "bcf7960";
+declare const BUILD_TIME = "2026-10-18T21:43:29.081Z";
 declare const SEMVER: {
-    readonly version: "0.37.2137";
-    readonly gitSha: "b82a721";
-    readonly buildTime: "2026-10-16T20:56:02.597Z";
+    readonly version: "0.37.2140";
+    readonly gitSha: "bcf7960";
+    readonly buildTime: "2026-10-18T21:43:29.081Z";
 };
 
-export { type AnalyticsDataPoint, type AnalyticsGraphConfig, type AnalyticsGroup, type Attachment, BUILD_TIME, type BlockEffort, type BlockIndexRow, BlockKey, type BlockRevision, type CatalogBackfillState, CodeMetadata, CodeStatement, type DialectAnalysis, type DimensionKey, type DisplayStatus, type EventGrain, type EventRecord, type FenceDialect, type FieldCatalogEntry, type FieldContribution, type FieldLeaf, type FieldRef, type FieldSourceRecord, type FieldValueKind, type FieldValueRecord, type FrontMatterSubtype, GIT_SHA, type IBlockKey, type ICodeMetadata, type ICodeStatement, type IDialect, type IDialectTagDescriptor, type IMetric, type IMetricOwnershipResolver, type IMetricSource, type IOutputStatement, type IScript, KNOWN_OUTPUT_TYPES, KNOWN_SECTION_WIDGETS, LEGACY_ORIGIN_TO_OWNERSHIP_LAYER, METRIC_OWNERSHIP_LAYER_CHAIN, type Membership, Metric, type MetricAction, MetricContainer, type MetricFilter, type MetricOrigin, type MetricOwnershipLayer, type MetricOwnershipLedger, type MetricOwnershipOutcome, type MetricOwnershipPromotionCandidate, type MetricOwnershipQuery, type MetricOwnershipResolvedContribution, type MetricOwnershipTypeExplanation, type MetricTemporal, MetricType, type MetricWithOptionalOwnershipLayer, NOTEBOOK_TAG_PREFIX, type Note, type NoteBlock, type NoteBlockChange, type NoteBlockKind, type NoteKind, type NoteTag, type Notebook, type NullValueKind, type Origin, OutputStatement, type OutputStatementOptions, type OutputStatementType, OwnershipResolver, type Page, type PageNote, type ParseError, ParsedCodeStatement, type ReconcileNoteBlocksOptions, type ReducerStats, type ResultOrigin, SEMVER, SYSTEM_DEFAULT_OUTPUT_UNIT, type ScriptBlock, type ScriptBlockState, type Section, type SectionDocument, type SectionRecognitionOptions, type SectionType, type Segment, type Session, type StoredOutputStatement, type SummaryCoverage, type Tag, type TagType, type TagTypeRecord, type TimeSpan, UNIT_CATALOG, UnitConversionError, type UnitDefinition, type UnitErrorCode, VALID_FENCE_DIALECTS, VERSION, type VisualizerFilter, type VisualizerSize, type WorkoutResults, type WorkoutSectionType, actionableSectionKind, blockContentId, buildRawContent, calculateTotalLines, convertViaCatalog, createMetricOwnershipLedger, detectScriptBlocks, dimensionKeyOf, extractBlockContent, fieldRefFromKey, fieldRefKey, findBlockAtLine, flattenFieldLeaves, fromNotebookTag, getMetricOwnershipLayer, isNotebookTag, isWorkoutSectionType, lookupUnit, mapNoteBlockChanges, matchDialectFence, normalizeFieldComponent, normalizeFieldPath, ownershipRank, parseDocumentSections, reconcileNoteBlocks, resolveLayer, runAffordance, systemDefaultUnit, toNotebookTag, validateNoteBlocks, valueKindOf };
+export { type AnalyticsDataPoint, type AnalyticsGraphConfig, type AnalyticsGroup, type Attachment, BUILD_TIME, type BlockEffort, type BlockEquipment, type BlockIndexRow, BlockKey, type BlockRevision, type CatalogBackfillState, CodeMetadata, CodeStatement, type DialectAnalysis, type DimensionKey, type DisplayStatus, type EventGrain, type EventRecord, type FenceDialect, type FieldCatalogEntry, type FieldContribution, type FieldLeaf, type FieldRef, type FieldSourceRecord, type FieldValueKind, type FieldValueRecord, type FrontMatterSubtype, type FrontmatterPatchValue, GIT_SHA, type IBlockKey, type ICodeMetadata, type ICodeStatement, type IDialect, type IDialectTagDescriptor, type IMetric, type IMetricOwnershipResolver, type IMetricSource, type IOutputStatement, type IScript, KNOWN_OUTPUT_TYPES, KNOWN_SECTION_WIDGETS, LEGACY_ORIGIN_TO_OWNERSHIP_LAYER, METRIC_OWNERSHIP_LAYER_CHAIN, type Membership, Metric, type MetricAction, MetricContainer, type MetricFilter, type MetricOrigin, type MetricOwnershipLayer, type MetricOwnershipLedger, type MetricOwnershipOutcome, type MetricOwnershipPromotionCandidate, type MetricOwnershipQuery, type MetricOwnershipResolvedContribution, type MetricOwnershipTypeExplanation, type MetricTemporal, MetricType, type MetricWithOptionalOwnershipLayer, NOTEBOOK_TAG_PREFIX, type Note, type NoteBlock, type NoteBlockChange, type NoteBlockKind, type NoteKind, type NoteTag, type Notebook, type NullValueKind, type Origin, OutputStatement, type OutputStatementOptions, type OutputStatementType, OwnershipResolver, type Page, type PageNote, type ParseError, ParsedCodeStatement, REFERENCE_METADATA_KEY, type ReconcileNoteBlocksOptions, type ReducerStats, type ReferenceDiagnostic, type ReferenceDiagnosticReason, type ReferenceKind, type ReferenceMatchKind, type ReferenceMetadata, type ReferenceRef, type ResultOrigin, SEMVER, SYSTEM_DEFAULT_OUTPUT_UNIT, type ScriptBlock, type ScriptBlockState, type Section, type SectionDocument, type SectionRecognitionOptions, type SectionType, type Segment, type Session, type StoredOutputStatement, type SummaryCoverage, type Tag, type TagType, type TagTypeRecord, type TimeSpan, UNIT_CATALOG, UnitConversionError, type UnitDefinition, type UnitErrorCode, VALID_FENCE_DIALECTS, VERSION, type VisualizerFilter, type VisualizerSize, type WorkoutResults, type WorkoutSectionType, actionableSectionKind, blockContentId, buildRawContent, calculateTotalLines, convertViaCatalog, createMetricOwnershipLedger, detectScriptBlocks, dimensionKeyOf, extractBlockContent, fieldRefFromKey, fieldRefKey, findBlockAtLine, flattenFieldLeaves, fromNotebookTag, getMetricOwnershipLayer, getReferenceMetadata, isNotebookTag, isWorkoutSectionType, lookupUnit, mapNoteBlockChanges, matchDialectFence, normalizeFieldComponent, normalizeFieldPath, ownershipRank, parseDocumentSections, patchFrontmatterProperty, reconcileNoteBlocks, resolveLayer, runAffordance, systemDefaultUnit, toNotebookTag, validateNoteBlocks, valueKindOf };

package/dist/index.mjs

@@ -34,6 +34,7 @@ var MetricType = /* @__PURE__ */ ((MetricType2) => {
   MetricType2["Total"] = "total";
   MetricType2["Rep"] = "rep";
   MetricType2["Effort"] = "effort";
+  MetricType2["Equipment"] = "equipment";
   MetricType2["Distance"] = "distance";
   MetricType2["Rounds"] = "rounds";
   MetricType2["CurrentRound"] = "current-round";
@@ -528,6 +529,29 @@ function convertViaCatalog(value, from, to) {
   return value * fromDef.factor / toDef.factor;
 }
 
+// src/models/ReferenceMetadata.ts
+var REFERENCE_METADATA_KEY = "references";
+var REFERENCE_MATCH_KINDS = ["explicit", "split", "whole", "default", "none"];
+function isValidReferenceRef(value) {
+  if (!value || typeof value !== "object") return false;
+  const candidate = value;
+  return (candidate.kind === "effort" || candidate.kind === "equipment") && typeof candidate.slug === "string" && !!candidate.slug && typeof candidate.label === "string";
+}
+function isValidReferenceDiagnostic(value) {
+  if (!value || typeof value !== "object") return false;
+  return typeof value.reason === "string";
+}
+function getReferenceMetadata(metadata) {
+  const value = metadata?.[REFERENCE_METADATA_KEY];
+  if (!value || typeof value !== "object") return void 0;
+  const candidate = value;
+  if (typeof candidate.matched !== "string" || !REFERENCE_MATCH_KINDS.includes(candidate.matched)) return void 0;
+  if (typeof candidate.source !== "string") return void 0;
+  if (candidate.refs !== void 0 && (!Array.isArray(candidate.refs) || !candidate.refs.every(isValidReferenceRef))) return void 0;
+  if (candidate.diagnostics !== void 0 && (!Array.isArray(candidate.diagnostics) || !candidate.diagnostics.every(isValidReferenceDiagnostic))) return void 0;
+  return value;
+}
+
 // src/models/CodeMetadata.ts
 var CodeMetadata = class {
   constructor(line, startOffset, endOffset, length, columnStart = 0, columnEnd = 0, raw = "") {
@@ -986,13 +1010,14 @@ function matchDialectFence(trimmedLine) {
 }
 function frontmatterSubtype(properties) {
   const type = properties.type?.toLowerCase();
-  if (type === "youtube" || type === "strava" || type === "amazon" || type === "file" || type === "effort") return type;
+  if (type === "youtube" || type === "strava" || type === "amazon" || type === "file" || type === "effort" || type === "equipment") return type;
   const url = properties.url || properties.link || "";
   const host = url.replace(/^[a-z][a-z0-9+.-]*:\/\//i, "").split(/[/?#:]/, 1)[0].toLowerCase();
   if (host === "youtu.be" || host === "youtube.com" || host.endsWith(".youtube.com")) return "youtube";
   if (host === "strava.com" || host.endsWith(".strava.com")) return "strava";
   if (host === "amzn.to" || host === "amazon.com" || host.endsWith(".amazon.com")) return "amazon";
   if (["baseAttributes", "discipline", "effortType", "targetRPE", "equipment", "aliases", "derivation"].some((key) => key in properties)) return "effort";
+  if (["slug", "label", "registrySource", "ownerNoteId", "sourcePath"].some((key) => key in properties)) return "equipment";
   return "default";
 }
 function markdownSubtype(text) {
@@ -1209,16 +1234,175 @@ function extractBlockContent(content, startLine, endLine) {
   return parseDocumentSections(content).find((section) => section.startLine === startLine && section.endLine === endLine && section.scriptBlock)?.scriptBlock?.content ?? "";
 }
 
+// src/sections/frontmatter.ts
+var KEY_RE = /^[A-Za-z][\w.-]*$/;
+var FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---/;
+function escapeRe(s) {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function isBlankOrComment(line) {
+  const t = line.trim();
+  return t === "" || t.startsWith("#");
+}
+function isList(value) {
+  return Array.isArray(value);
+}
+function quoteYamlScalar(value) {
+  if (value === "") return '""';
+  const looksNumeric = !isNaN(Number(value));
+  const looksKeyword = /^(true|false|null|yes|no|on|off)$/i.test(value);
+  if (/[:"'\n#{}[\],&*?|<>=%!@`]/.test(value) || value !== value.trim() || value.startsWith("-") || looksNumeric || looksKeyword) {
+    return `"${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\n/g, "\\n").replace(/\r/g, "\\r").replace(/\t/g, "\\t")}"`;
+  }
+  return value;
+}
+function propertyLines(indent, key, value) {
+  const pad = " ".repeat(indent);
+  if (isList(value)) {
+    if (value.length === 0) return [`${pad}${key}: []`];
+    return [`${pad}${key}:`, ...value.map((item) => `${pad}  - ${typeof item === "number" ? String(item) : quoteYamlScalar(item)}`)];
+  }
+  return [`${pad}${key}: ${typeof value === "number" ? String(value) : quoteYamlScalar(value)}`];
+}
+function missingChainLines(path, from, value, baseIndent) {
+  const out = [];
+  let indent = baseIndent;
+  for (let i = from; i < path.length; i++) {
+    if (i === path.length - 1) {
+      out.push(...propertyLines(indent, path[i], value));
+    } else {
+      out.push(`${" ".repeat(indent)}${path[i]}:`);
+    }
+    indent += 2;
+  }
+  return out;
+}
+function inlineCommentIndex(line) {
+  let inSingle = false;
+  let inDouble = false;
+  for (let i = 0; i < line.length; i++) {
+    const c = line[i];
+    if (inDouble) {
+      if (c === "\\") i++;
+      else if (c === '"') inDouble = false;
+      continue;
+    }
+    if (inSingle) {
+      if (c === "'") inSingle = false;
+      continue;
+    }
+    if (c === '"') inDouble = true;
+    else if (c === "'") inSingle = true;
+    else if (c === "#" && (i === 0 || /\s/.test(line[i - 1]))) return i;
+  }
+  return -1;
+}
+function propertyExtent(lines, start, indent) {
+  const extent = [start];
+  let pending = [];
+  for (let j = start + 1; j < lines.length; j++) {
+    const line = lines[j];
+    if (isBlankOrComment(line)) {
+      pending.push(j);
+      continue;
+    }
+    if (line.length - line.trimStart().length > indent) {
+      extent.push(...pending, j);
+      pending = [];
+    } else {
+      break;
+    }
+  }
+  return extent;
+}
+function findProperty(lines, key, indent, from, to) {
+  const re = new RegExp(`^ {${indent}}${escapeRe(key)}\\s*:`);
+  for (let i = from; i < to; i++) {
+    if (re.test(lines[i])) return i;
+  }
+  return -1;
+}
+function patchFrontmatterProperty(raw, path, value) {
+  if (path.length === 0 || !path.every((k) => typeof k === "string" && KEY_RE.test(k))) return raw;
+  const eol = raw.includes("\r\n") ? "\r\n" : "\n";
+  const m = raw.match(FRONTMATTER_RE);
+  if (!m) {
+    if (value === null) return raw;
+    const inner = missingChainLines(path, 0, value, 0);
+    const block = `---${eol}${inner.join(eol)}${eol}---${eol}`;
+    return raw.length ? block + raw : block;
+  }
+  const lines = m[1] === "" ? [] : m[1].split(/\r?\n/);
+  let searchStart = 0;
+  let searchEnd = lines.length;
+  let foundDepth = -1;
+  let foundIdx = -1;
+  let foundExtent = [];
+  for (let d = 0; d < path.length; d++) {
+    const indent = d * 2;
+    const idx = findProperty(lines, path[d], indent, searchStart, searchEnd);
+    if (idx === -1) break;
+    foundDepth = d;
+    foundIdx = idx;
+    foundExtent = propertyExtent(lines, idx, indent);
+    searchStart = idx + 1;
+    searchEnd = foundExtent[foundExtent.length - 1] + 1;
+  }
+  if (value === null) {
+    if (foundDepth !== path.length - 1) return raw;
+    const doomed = new Set(foundExtent);
+    for (let d = foundDepth - 1; d >= 0; d--) {
+      const indent = d * 2;
+      const idx = findProperty(lines, path[d], indent, 0, lines.length);
+      if (idx === -1 || doomed.has(idx)) break;
+      let hasChild = false;
+      for (let j = idx + 1; j < lines.length; j++) {
+        if (doomed.has(j)) continue;
+        const line = lines[j];
+        if (isBlankOrComment(line)) continue;
+        if (line.length - line.trimStart().length > indent) hasChild = true;
+        break;
+      }
+      if (hasChild) break;
+      doomed.add(idx);
+    }
+    const next2 = lines.filter((_, i) => !doomed.has(i));
+    return `---${eol}${next2.length ? next2.join(eol) + eol : ""}---` + raw.slice(m[0].length);
+  }
+  let spliceIndex;
+  let removeCount;
+  let replacement;
+  if (foundDepth === path.length - 1) {
+    replacement = propertyLines(foundDepth * 2, path[foundDepth], value);
+    if (!isList(value)) {
+      const ci = inlineCommentIndex(lines[foundIdx]);
+      if (ci !== -1) {
+        const comment = lines[foundIdx].slice(ci).trim();
+        replacement[0] = `${replacement[0]} ${comment}`;
+      }
+    }
+    spliceIndex = foundExtent[0];
+    removeCount = foundExtent.length;
+  } else {
+    spliceIndex = foundDepth === -1 ? lines.length : searchEnd;
+    removeCount = 0;
+    replacement = missingChainLines(path, foundDepth + 1, value, (foundDepth + 1) * 2);
+  }
+  const next = [...lines];
+  next.splice(spliceIndex, removeCount, ...replacement);
+  return `---${eol}${next.length ? next.join(eol) + eol : ""}---` + raw.slice(m[0].length);
+}
+
 // src/version.ts
-var VERSION = "0.37.2137";
-var GIT_SHA = "b82a721";
-var BUILD_TIME = "2026-10-16T20:56:02.597Z";
+var VERSION = "0.37.2140";
+var GIT_SHA = "bcf7960";
+var BUILD_TIME = "2026-10-18T21:43:29.081Z";
 var SEMVER = {
-  version: "0.37.2137",
-  gitSha: "b82a721",
-  buildTime: "2026-10-16T20:56:02.597Z"
+  version: "0.37.2140",
+  gitSha: "bcf7960",
+  buildTime: "2026-10-18T21:43:29.081Z"
 };
 
-export { BUILD_TIME, BlockKey, CodeMetadata, CodeStatement, GIT_SHA, KNOWN_OUTPUT_TYPES, KNOWN_SECTION_WIDGETS, LEGACY_ORIGIN_TO_OWNERSHIP_LAYER, METRIC_OWNERSHIP_LAYER_CHAIN, Metric, MetricContainer, MetricType, NOTEBOOK_TAG_PREFIX, OutputStatement, OwnershipResolver, ParsedCodeStatement, SEMVER, SYSTEM_DEFAULT_OUTPUT_UNIT, UNIT_CATALOG, UnitConversionError, VALID_FENCE_DIALECTS, VERSION, actionableSectionKind, blockContentId, buildRawContent, calculateTotalLines, convertViaCatalog, createMetricOwnershipLedger, detectScriptBlocks, dimensionKeyOf, extractBlockContent, fieldRefFromKey, fieldRefKey, findBlockAtLine, flattenFieldLeaves, fromNotebookTag, getMetricOwnershipLayer, isNotebookTag, isWorkoutSectionType, lookupUnit, mapNoteBlockChanges, matchDialectFence, normalizeFieldComponent, normalizeFieldPath, ownershipRank, parseDocumentSections, reconcileNoteBlocks, resolveLayer, runAffordance, systemDefaultUnit, toNotebookTag, validateNoteBlocks, valueKindOf };
+export { BUILD_TIME, BlockKey, CodeMetadata, CodeStatement, GIT_SHA, KNOWN_OUTPUT_TYPES, KNOWN_SECTION_WIDGETS, LEGACY_ORIGIN_TO_OWNERSHIP_LAYER, METRIC_OWNERSHIP_LAYER_CHAIN, Metric, MetricContainer, MetricType, NOTEBOOK_TAG_PREFIX, OutputStatement, OwnershipResolver, ParsedCodeStatement, REFERENCE_METADATA_KEY, SEMVER, SYSTEM_DEFAULT_OUTPUT_UNIT, UNIT_CATALOG, UnitConversionError, VALID_FENCE_DIALECTS, VERSION, actionableSectionKind, blockContentId, buildRawContent, calculateTotalLines, convertViaCatalog, createMetricOwnershipLedger, detectScriptBlocks, dimensionKeyOf, extractBlockContent, fieldRefFromKey, fieldRefKey, findBlockAtLine, flattenFieldLeaves, fromNotebookTag, getMetricOwnershipLayer, getReferenceMetadata, isNotebookTag, isWorkoutSectionType, lookupUnit, mapNoteBlockChanges, matchDialectFence, normalizeFieldComponent, normalizeFieldPath, ownershipRank, parseDocumentSections, patchFrontmatterProperty, reconcileNoteBlocks, resolveLayer, runAffordance, systemDefaultUnit, toNotebookTag, validateNoteBlocks, valueKindOf };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map