@bitcobblers/wod-wiki-core 0.35.2116 → 0.35.2117

package/dist/index.d.cts

@@ -461,7 +461,9 @@ interface UnitDefinition {
  * unitless (factor 1).
  */
 declare const UNIT_CATALOG: readonly UnitDefinition[];
-/** Look up a unit by canonical spelling or alias (case-insensitive). */
+/** Look up a unit by canonical spelling or alias (case-insensitive). Stored
+ *  event rows are a trust boundary — a missing/legacy unit arrives as
+ *  undefined at runtime despite the static type. */
 declare function lookupUnit(spelling: string): UnitDefinition | undefined;
 /** The named result dimension of a unit spelling, or undefined when the
  *  spelling is not in the catalog. */
@@ -863,13 +865,7 @@ interface Segment {
     metrics?: MetricContainer;
 }
 
-/**
- * Content-stable identity for a workout block.
- *
- * A 32-bit FNV-1a hash of the trimmed fenced content, formatted as `bc-<8 hex>`.
- * Survives clone / reorder / edit-above so results and facts keyed by it stay
- * linked across runs.
- */
+/** Cross-note fingerprint of the trimmed, unfenced workout body. Never an occurrence ID. */
 declare function blockContentId(content: string): string;
 
 /**
@@ -936,20 +932,44 @@ interface WorkoutResults {
     completed: boolean;
 }
 
-type SegmentDataType = 'script' | 'youtube' | 'markdown' | 'header' | 'frontmatter' | 'wod' | 'title' | 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6';
+type NoteBlockKind = 'wod' | 'query' | 'widget' | 'embed';
+interface NoteBlock {
+    id: string;
+    kind: NoteBlockKind;
+    version: number;
+    sourceRevision: number;
+    from: number;
+    to: number;
+    dialect?: 'time' | 'log';
+    sport?: string;
+}
+interface BlockRevision {
+    noteId: string;
+    blockId: string;
+    version: number;
+    kind: NoteBlockKind;
+    rawContent: string;
+    savedAt: number;
+    dialect?: 'time' | 'log';
+    sport?: string;
+}
 type NoteKind = 'journal' | 'template' | 'playground' | 'feed' | 'dashboard' | 'page' | (string & {});
 interface Note {
     id: string;
     title: string;
+    rawContent: string;
+    sourceRevision: number;
+    blocks: Record<string, NoteBlock>;
     date?: number;
     createdAt: number;
     type?: NoteKind;
     sourceId?: string;
     catalog?: string;
     tags?: string[];
-    /** Original seed file path (e.g. `markdown/collections/girls/fran.md`) — the
-     *  deterministic UUID is derived from this path; retained for seed content
-     *  reconstruction (canvas routes, collection READMEs, block-index lookup). */
+    seedOrigin?: 'seed' | 'user';
+    seedVersion?: number;
+    seedChunkId?: string;
+    /** Authored seed path used for deterministic identity and routing. */
     sourcePath?: string;
 }
 interface Page {
@@ -985,48 +1005,36 @@ interface NoteTag {
     noteId: string;
     tagId: string;
 }
-interface NoteSegment {
-    id: string;
-    version: number;
-    noteId: string;
-    position?: number;
-    pageId?: string;
-    dataType: SegmentDataType;
-    data: unknown;
-    rawContent: string;
-    createdAt: number;
-    updatedAt?: number;
-    isHistory?: boolean;
-}
 interface BlockIndexRow {
-    /** Composite key: `${noteId}:${segmentId}:${segmentVersion}` */
+    /** Current occurrence key `${noteId}:${blockId}`. */
     id: string;
     noteId: string;
-    segmentId: string;
-    segmentVersion: number;
+    blockId: string;
+    blockVersion: number;
+    sourceRevision: number;
+    from: number;
+    to: number;
     position?: number;
-    dataType: string;
+    dataType: NoteBlock['kind'];
     blockContentId?: string;
     rawContent: string;
     noteTitle: string;
     createdAt: number;
     isStatic?: boolean;
     sourceId?: string;
+    sourcePath?: string;
+    routeId?: string;
 }
 type ResultOrigin = 'journal' | 'playground' | 'user';
 interface Session {
     id: string;
-    segmentId?: string;
-    segmentVersion?: number;
     noteId: string;
-    blockId?: string;
+    blockId: string;
+    blockVersion: number;
     blockContentId?: string;
-    version?: number;
     origin?: ResultOrigin;
     pageId?: string;
-    /** Write-path lifecycle (ticket 005): row born 'in-progress' at workout
-     *  start, flipped to 'completed' at finalize. Absent = 'completed'
-     *  (legacy rows predate streaming). */
+    /** Born in-progress at run start, completed when finalization commits. */
     status?: 'in-progress' | 'completed';
     /** When workout started */
     startTime: number;
@@ -1073,8 +1081,8 @@ interface AnalyticsDataPoint {
      *  partitions) — normalized key → value, resolved by factTagValue after
      *  the structural switch so `by {coach}` / `{coach:greg}` work. */
     dimensions?: Record<string, string>;
-    segmentId: string;
-    segmentVersion: number;
+    blockId: string;
+    blockVersion: number;
     resultId: string;
     type: string;
     value: unknown;
@@ -1145,8 +1153,8 @@ interface EventRecord {
     dialect?: string;
     stackLevel?: number;
     completionReason?: string;
-    segmentId?: string;
-    segmentVersion?: number;
+    blockId?: string;
+    blockVersion?: number;
     /** Per-metric temporal anchors (ticket 12) — parallel to `metrics` when
      *  the producing statement carries its own instants/dates:
      *  'instant' = recorded occurrence instant; 'civil-date' = recorded civil
@@ -1253,6 +1261,28 @@ interface CatalogBackfillState {
     revision: number;
     updatedAt: number;
 }
+interface BlockEffort {
+    id: string;
+    noteId: string;
+    blockId: string;
+    blockContentId?: string;
+    effortSlug: string;
+    isStatic?: boolean;
+    sourcePath?: string;
+    createdAt: number;
+}
+interface Membership {
+    id: string;
+    displayName: string;
+    picture?: string;
+    weight?: number;
+    weightUnit?: 'kg' | 'lb';
+    height?: number;
+    heightUnit?: 'cm' | 'in';
+    birthDate?: string;
+    createdAt: number;
+    updatedAt?: number;
+}
 
 /**
  * State of a WOD block
@@ -1292,7 +1322,7 @@ type FrontMatterSubtype = 'default' | 'youtube' | 'strava' | 'amazon' | 'file' |
 interface ScriptBlock {
     /** Unique identifier for this block */
     id: string;
-    /** Content-stable identity */
+    /** Cross-note content fingerprint, never occurrence identity. */
     contentId?: string;
     /** Workout fence tag ('time' runnable / 'log' recorded) */
     dialect?: FenceDialect;
@@ -1324,6 +1354,13 @@ interface Section {
     id: string;
     contentId?: string;
     type: SectionType;
+    /** Half-open UTF-16 offsets in the exact authored document. */
+    from: number;
+    to: number;
+    contentFrom?: number;
+    contentTo?: number;
+    querySuffix?: string;
+    separatorAfter?: string;
     subtype?: string;
     rawContent: string;
     displayContent: string;
@@ -1387,14 +1424,6 @@ interface IScript {
     getAt(index: number): ICodeStatement | undefined;
 }
 
-/**
- * Try to match a line against known workout fence patterns.
- * Returns the base tag and optional :sport suffix, or null otherwise.
- */
-declare function matchDialectFence(trimmedLine: string): {
-    dialect: FenceDialect;
-    sport?: string;
-} | null;
 /**
  * Detects all WOD blocks in markdown content.
  * Recognises ```time and ```log as valid workout fences (optional :sport suffix).
@@ -1421,33 +1450,44 @@ declare function findBlockAtLine(blocks: ScriptBlock[], lineNumber: number): Scr
  */
 declare function extractBlockContent(content: string, startLine: number, endLine: number): string;
 
-interface SectionMetadata {
-    id: string;
-    version: number;
-    createdAt: number;
-}
-/**
- * Generate a deterministic section ID from type, startLine (0-indexed), and a content hash.
- * Stable across re-parses when structure doesn't change.
- */
-declare function generateSectionId(type: SectionType | string, startLine: number, content: string): string;
-
-declare function parseDocumentSections(content: string, scriptBlocks?: ScriptBlock[]): Section[];
+declare const KNOWN_SECTION_WIDGETS: readonly string[];
+declare function matchDialectFence(trimmedLine: string): {
+    dialect: 'time' | 'log';
+    sport?: string;
+} | null;
+interface SectionRecognitionOptions {
+    registeredWidgets?: ReadonlySet<string> | readonly string[];
+}
+interface ReconcileNoteBlocksOptions extends SectionRecognitionOptions {
+    sourceRevision: number;
+    /** Current-source occurrence lineage, not a previous document's locations. */
+    blocks?: Record<string, NoteBlock>;
+    createId?: () => string;
+}
+declare function parseDocumentSections(content: string, options?: SectionRecognitionOptions): Section[];
+declare function actionableSectionKind(section: Section): NoteBlock['kind'] | null;
+declare function reconcileNoteBlocks(rawContent: string, options: ReconcileNoteBlocksOptions): Record<string, NoteBlock>;
+declare function validateNoteBlocks(rawContent: string, blocks: Record<string, NoteBlock>, sourceRevision: number, options?: SectionRecognitionOptions): void;
+interface NoteBlockChange {
+    from: number;
+    to: number;
+    insert: string;
+}
+declare function mapNoteBlockChanges(blocks: Record<string, NoteBlock>, changes: readonly NoteBlockChange[]): Record<string, NoteBlock>;
 declare function buildRawContent(sections: Section[]): string;
 declare function calculateTotalLines(sections: Section[]): number;
-declare function matchSectionIds(oldSections: Section[], newSections: Section[]): Section[];
 
 /**
  * Auto-generated build version metadata.
  * Do not edit directly; updated by scripts/stamp-version.ts
  */
-declare const VERSION = "0.35.2116";
-declare const GIT_SHA = "a4d411f";
-declare const BUILD_TIME = "2026-10-12T00:14:24.795Z";
+declare const VERSION = "0.35.2117";
+declare const GIT_SHA = "03d1dfc";
+declare const BUILD_TIME = "2026-10-12T20:08:12.374Z";
 declare const SEMVER: {
-    readonly version: "0.35.2116";
-    readonly gitSha: "a4d411f";
-    readonly buildTime: "2026-10-12T00:14:24.795Z";
+    readonly version: "0.35.2117";
+    readonly gitSha: "03d1dfc";
+    readonly buildTime: "2026-10-12T20:08:12.374Z";
 };
 
-export { type AnalyticsDataPoint, type AnalyticsGraphConfig, type AnalyticsGroup, type Attachment, BUILD_TIME, type BlockIndexRow, BlockKey, 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, LEGACY_ORIGIN_TO_OWNERSHIP_LAYER, METRIC_OWNERSHIP_LAYER_CHAIN, 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 NoteKind, type NoteSegment, type NoteTag, type Notebook, type NullValueKind, type Origin, OutputStatement, type OutputStatementOptions, type OutputStatementType, OwnershipResolver, type Page, type PageNote, type ParseError, ParsedCodeStatement, type ReducerStats, type ResultOrigin, SEMVER, SYSTEM_DEFAULT_OUTPUT_UNIT, type ScriptBlock, type ScriptBlockState, type Section, type SectionDocument, type SectionMetadata, type SectionType, type Segment, type SegmentDataType, 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, blockContentId, buildRawContent, calculateTotalLines, convertViaCatalog, createMetricOwnershipLedger, detectScriptBlocks, dimensionKeyOf, extractBlockContent, fieldRefFromKey, fieldRefKey, findBlockAtLine, flattenFieldLeaves, fromNotebookTag, generateSectionId, getMetricOwnershipLayer, isNotebookTag, isWorkoutSectionType, lookupUnit, matchDialectFence, matchSectionIds, normalizeFieldComponent, normalizeFieldPath, ownershipRank, parseDocumentSections, resolveLayer, runAffordance, systemDefaultUnit, toNotebookTag, valueKindOf };
+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 };

package/dist/index.d.ts

@@ -461,7 +461,9 @@ interface UnitDefinition {
  * unitless (factor 1).
  */
 declare const UNIT_CATALOG: readonly UnitDefinition[];
-/** Look up a unit by canonical spelling or alias (case-insensitive). */
+/** Look up a unit by canonical spelling or alias (case-insensitive). Stored
+ *  event rows are a trust boundary — a missing/legacy unit arrives as
+ *  undefined at runtime despite the static type. */
 declare function lookupUnit(spelling: string): UnitDefinition | undefined;
 /** The named result dimension of a unit spelling, or undefined when the
  *  spelling is not in the catalog. */
@@ -863,13 +865,7 @@ interface Segment {
     metrics?: MetricContainer;
 }
 
-/**
- * Content-stable identity for a workout block.
- *
- * A 32-bit FNV-1a hash of the trimmed fenced content, formatted as `bc-<8 hex>`.
- * Survives clone / reorder / edit-above so results and facts keyed by it stay
- * linked across runs.
- */
+/** Cross-note fingerprint of the trimmed, unfenced workout body. Never an occurrence ID. */
 declare function blockContentId(content: string): string;
 
 /**
@@ -936,20 +932,44 @@ interface WorkoutResults {
     completed: boolean;
 }
 
-type SegmentDataType = 'script' | 'youtube' | 'markdown' | 'header' | 'frontmatter' | 'wod' | 'title' | 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6';
+type NoteBlockKind = 'wod' | 'query' | 'widget' | 'embed';
+interface NoteBlock {
+    id: string;
+    kind: NoteBlockKind;
+    version: number;
+    sourceRevision: number;
+    from: number;
+    to: number;
+    dialect?: 'time' | 'log';
+    sport?: string;
+}
+interface BlockRevision {
+    noteId: string;
+    blockId: string;
+    version: number;
+    kind: NoteBlockKind;
+    rawContent: string;
+    savedAt: number;
+    dialect?: 'time' | 'log';
+    sport?: string;
+}
 type NoteKind = 'journal' | 'template' | 'playground' | 'feed' | 'dashboard' | 'page' | (string & {});
 interface Note {
     id: string;
     title: string;
+    rawContent: string;
+    sourceRevision: number;
+    blocks: Record<string, NoteBlock>;
     date?: number;
     createdAt: number;
     type?: NoteKind;
     sourceId?: string;
     catalog?: string;
     tags?: string[];
-    /** Original seed file path (e.g. `markdown/collections/girls/fran.md`) — the
-     *  deterministic UUID is derived from this path; retained for seed content
-     *  reconstruction (canvas routes, collection READMEs, block-index lookup). */
+    seedOrigin?: 'seed' | 'user';
+    seedVersion?: number;
+    seedChunkId?: string;
+    /** Authored seed path used for deterministic identity and routing. */
     sourcePath?: string;
 }
 interface Page {
@@ -985,48 +1005,36 @@ interface NoteTag {
     noteId: string;
     tagId: string;
 }
-interface NoteSegment {
-    id: string;
-    version: number;
-    noteId: string;
-    position?: number;
-    pageId?: string;
-    dataType: SegmentDataType;
-    data: unknown;
-    rawContent: string;
-    createdAt: number;
-    updatedAt?: number;
-    isHistory?: boolean;
-}
 interface BlockIndexRow {
-    /** Composite key: `${noteId}:${segmentId}:${segmentVersion}` */
+    /** Current occurrence key `${noteId}:${blockId}`. */
     id: string;
     noteId: string;
-    segmentId: string;
-    segmentVersion: number;
+    blockId: string;
+    blockVersion: number;
+    sourceRevision: number;
+    from: number;
+    to: number;
     position?: number;
-    dataType: string;
+    dataType: NoteBlock['kind'];
     blockContentId?: string;
     rawContent: string;
     noteTitle: string;
     createdAt: number;
     isStatic?: boolean;
     sourceId?: string;
+    sourcePath?: string;
+    routeId?: string;
 }
 type ResultOrigin = 'journal' | 'playground' | 'user';
 interface Session {
     id: string;
-    segmentId?: string;
-    segmentVersion?: number;
     noteId: string;
-    blockId?: string;
+    blockId: string;
+    blockVersion: number;
     blockContentId?: string;
-    version?: number;
     origin?: ResultOrigin;
     pageId?: string;
-    /** Write-path lifecycle (ticket 005): row born 'in-progress' at workout
-     *  start, flipped to 'completed' at finalize. Absent = 'completed'
-     *  (legacy rows predate streaming). */
+    /** Born in-progress at run start, completed when finalization commits. */
     status?: 'in-progress' | 'completed';
     /** When workout started */
     startTime: number;
@@ -1073,8 +1081,8 @@ interface AnalyticsDataPoint {
      *  partitions) — normalized key → value, resolved by factTagValue after
      *  the structural switch so `by {coach}` / `{coach:greg}` work. */
     dimensions?: Record<string, string>;
-    segmentId: string;
-    segmentVersion: number;
+    blockId: string;
+    blockVersion: number;
     resultId: string;
     type: string;
     value: unknown;
@@ -1145,8 +1153,8 @@ interface EventRecord {
     dialect?: string;
     stackLevel?: number;
     completionReason?: string;
-    segmentId?: string;
-    segmentVersion?: number;
+    blockId?: string;
+    blockVersion?: number;
     /** Per-metric temporal anchors (ticket 12) — parallel to `metrics` when
      *  the producing statement carries its own instants/dates:
      *  'instant' = recorded occurrence instant; 'civil-date' = recorded civil
@@ -1253,6 +1261,28 @@ interface CatalogBackfillState {
     revision: number;
     updatedAt: number;
 }
+interface BlockEffort {
+    id: string;
+    noteId: string;
+    blockId: string;
+    blockContentId?: string;
+    effortSlug: string;
+    isStatic?: boolean;
+    sourcePath?: string;
+    createdAt: number;
+}
+interface Membership {
+    id: string;
+    displayName: string;
+    picture?: string;
+    weight?: number;
+    weightUnit?: 'kg' | 'lb';
+    height?: number;
+    heightUnit?: 'cm' | 'in';
+    birthDate?: string;
+    createdAt: number;
+    updatedAt?: number;
+}
 
 /**
  * State of a WOD block
@@ -1292,7 +1322,7 @@ type FrontMatterSubtype = 'default' | 'youtube' | 'strava' | 'amazon' | 'file' |
 interface ScriptBlock {
     /** Unique identifier for this block */
     id: string;
-    /** Content-stable identity */
+    /** Cross-note content fingerprint, never occurrence identity. */
     contentId?: string;
     /** Workout fence tag ('time' runnable / 'log' recorded) */
     dialect?: FenceDialect;
@@ -1324,6 +1354,13 @@ interface Section {
     id: string;
     contentId?: string;
     type: SectionType;
+    /** Half-open UTF-16 offsets in the exact authored document. */
+    from: number;
+    to: number;
+    contentFrom?: number;
+    contentTo?: number;
+    querySuffix?: string;
+    separatorAfter?: string;
     subtype?: string;
     rawContent: string;
     displayContent: string;
@@ -1387,14 +1424,6 @@ interface IScript {
     getAt(index: number): ICodeStatement | undefined;
 }
 
-/**
- * Try to match a line against known workout fence patterns.
- * Returns the base tag and optional :sport suffix, or null otherwise.
- */
-declare function matchDialectFence(trimmedLine: string): {
-    dialect: FenceDialect;
-    sport?: string;
-} | null;
 /**
  * Detects all WOD blocks in markdown content.
  * Recognises ```time and ```log as valid workout fences (optional :sport suffix).
@@ -1421,33 +1450,44 @@ declare function findBlockAtLine(blocks: ScriptBlock[], lineNumber: number): Scr
  */
 declare function extractBlockContent(content: string, startLine: number, endLine: number): string;
 
-interface SectionMetadata {
-    id: string;
-    version: number;
-    createdAt: number;
-}
-/**
- * Generate a deterministic section ID from type, startLine (0-indexed), and a content hash.
- * Stable across re-parses when structure doesn't change.
- */
-declare function generateSectionId(type: SectionType | string, startLine: number, content: string): string;
-
-declare function parseDocumentSections(content: string, scriptBlocks?: ScriptBlock[]): Section[];
+declare const KNOWN_SECTION_WIDGETS: readonly string[];
+declare function matchDialectFence(trimmedLine: string): {
+    dialect: 'time' | 'log';
+    sport?: string;
+} | null;
+interface SectionRecognitionOptions {
+    registeredWidgets?: ReadonlySet<string> | readonly string[];
+}
+interface ReconcileNoteBlocksOptions extends SectionRecognitionOptions {
+    sourceRevision: number;
+    /** Current-source occurrence lineage, not a previous document's locations. */
+    blocks?: Record<string, NoteBlock>;
+    createId?: () => string;
+}
+declare function parseDocumentSections(content: string, options?: SectionRecognitionOptions): Section[];
+declare function actionableSectionKind(section: Section): NoteBlock['kind'] | null;
+declare function reconcileNoteBlocks(rawContent: string, options: ReconcileNoteBlocksOptions): Record<string, NoteBlock>;
+declare function validateNoteBlocks(rawContent: string, blocks: Record<string, NoteBlock>, sourceRevision: number, options?: SectionRecognitionOptions): void;
+interface NoteBlockChange {
+    from: number;
+    to: number;
+    insert: string;
+}
+declare function mapNoteBlockChanges(blocks: Record<string, NoteBlock>, changes: readonly NoteBlockChange[]): Record<string, NoteBlock>;
 declare function buildRawContent(sections: Section[]): string;
 declare function calculateTotalLines(sections: Section[]): number;
-declare function matchSectionIds(oldSections: Section[], newSections: Section[]): Section[];
 
 /**
  * Auto-generated build version metadata.
  * Do not edit directly; updated by scripts/stamp-version.ts
  */
-declare const VERSION = "0.35.2116";
-declare const GIT_SHA = "a4d411f";
-declare const BUILD_TIME = "2026-10-12T00:14:24.795Z";
+declare const VERSION = "0.35.2117";
+declare const GIT_SHA = "03d1dfc";
+declare const BUILD_TIME = "2026-10-12T20:08:12.374Z";
 declare const SEMVER: {
-    readonly version: "0.35.2116";
-    readonly gitSha: "a4d411f";
-    readonly buildTime: "2026-10-12T00:14:24.795Z";
+    readonly version: "0.35.2117";
+    readonly gitSha: "03d1dfc";
+    readonly buildTime: "2026-10-12T20:08:12.374Z";
 };
 
-export { type AnalyticsDataPoint, type AnalyticsGraphConfig, type AnalyticsGroup, type Attachment, BUILD_TIME, type BlockIndexRow, BlockKey, 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, LEGACY_ORIGIN_TO_OWNERSHIP_LAYER, METRIC_OWNERSHIP_LAYER_CHAIN, 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 NoteKind, type NoteSegment, type NoteTag, type Notebook, type NullValueKind, type Origin, OutputStatement, type OutputStatementOptions, type OutputStatementType, OwnershipResolver, type Page, type PageNote, type ParseError, ParsedCodeStatement, type ReducerStats, type ResultOrigin, SEMVER, SYSTEM_DEFAULT_OUTPUT_UNIT, type ScriptBlock, type ScriptBlockState, type Section, type SectionDocument, type SectionMetadata, type SectionType, type Segment, type SegmentDataType, 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, blockContentId, buildRawContent, calculateTotalLines, convertViaCatalog, createMetricOwnershipLedger, detectScriptBlocks, dimensionKeyOf, extractBlockContent, fieldRefFromKey, fieldRefKey, findBlockAtLine, flattenFieldLeaves, fromNotebookTag, generateSectionId, getMetricOwnershipLayer, isNotebookTag, isWorkoutSectionType, lookupUnit, matchDialectFence, matchSectionIds, normalizeFieldComponent, normalizeFieldPath, ownershipRank, parseDocumentSections, resolveLayer, runAffordance, systemDefaultUnit, toNotebookTag, valueKindOf };
+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 };