@bitcobblers/wod-wiki-core 0.44.2159 → 0.45.2166

package/dist/index.d.cts

@@ -1117,6 +1117,28 @@ interface WorkoutResults {
     completed: boolean;
 }
 
+/**
+ * Feed identity — the source-side vocabulary.
+ *
+ * A **feed** is one published directory the app subscribes to and syncs as a
+ * unit (the glossary's *Feed*). The word "seed" no longer names a source:
+ * a registered source is a feed, its id is a feed id, and the artifact it
+ * serves is a **Seed** (see `SeedManifest` in the engine's seed contract).
+ *
+ * A registered feed has ONE id — the registry id, `FeedSource.id` — and
+ * that id is also the note's `feedSourceId` and the suffix of the import
+ * checkpoint key (`seed:<id>`, whose `seed:` prefix is a persisted wire
+ * format, not a source name).
+ */
+/** A feed identifier — the id of one registered feed source. */
+type FeedId = string;
+/**
+ * How a record came to be: delivered by a feed (`'feed'`), or authored and
+ * owned by the user (`'user'`). The feed-side twin of the artifact-side
+ * `seedOrigin` (`'seed' | 'user'`) — the two agree on every imported note.
+ */
+type FeedOrigin = 'feed' | 'user';
+
 type NoteBlockKind = 'wod' | 'query' | 'widget' | 'embed';
 interface NoteBlock {
     id: string;
@@ -1138,7 +1160,7 @@ interface BlockRevision {
     dialect?: 'time' | 'log';
     sport?: string;
 }
-type NoteKind = 'journal' | 'template' | 'playground' | 'feed' | 'dashboard' | 'page' | (string & {});
+type NoteKind = 'journal' | 'playground' | 'dashboard' | 'page' | 'note' | (string & {});
 interface Note {
     id: string;
     title: string;
@@ -1149,14 +1171,22 @@ interface Note {
     createdAt: number;
     type?: NoteKind;
     sourceId?: string;
-    catalog?: string;
     /** Canonical notebook identifier ('notebook/{slug}', e.g. 'notebook/journal', 'notebook/playground', 'notebook/guides'). */
     notebookId?: string;
     tags?: string[];
+    /** Artifact provenance — which published bundle this note came from.
+     *  Persisted field names; the artifact they describe is a **Seed**. */
     seedOrigin?: 'seed' | 'user';
     seedVersion?: number;
     seedChunkId?: string;
-    /** Authored seed path used for deterministic identity and routing. */
+    /** Feed provenance — 'feed' for a note a feed delivered, 'user' for one the
+     *  user owns. The two agree: a feed-delivered note is seed-delivered, and
+     *  vice versa. */
+    feedOrigin?: FeedOrigin;
+    /** The registered feed that delivered this note (the feed's own id).
+     *  Read from here alone — never from the seed stamps. */
+    feedSourceId?: FeedId;
+    /** Authored corpus path used for deterministic identity and routing. */
     sourcePath?: string;
     /** Git commit hash in which this note was published or changed. */
     seedCommit?: string;
@@ -1175,7 +1205,7 @@ interface PageNote {
     position?: number;
     createdAt: number;
 }
-type TagType = 'template' | 'playground' | 'qualification' | 'notebook' | 'general' | (string & {});
+type TagType = 'playground' | 'qualification' | 'notebook' | 'general' | (string & {});
 interface TagTypeRecord {
     id: string;
     name: string;
@@ -1496,6 +1526,92 @@ interface Membership {
     updatedAt?: number;
 }
 
+/**
+ * Page placement — the resolved form of one `page_notes` junction row.
+ *
+ * Placement is many-to-many: a note may sit on several pages (a calendar
+ * day, a named collection, …) and a page may hold several notes. The
+ * junction row is the only membership record; a note carries no page
+ * reference of its own.
+ *
+ * One ordering decides everything placement-related — the **canonical
+ * placement order**: explicit `position` first (smaller first, a row
+ * without one last), then creation time, then the row id. It reads a
+ * page's notes in order and picks the *primary* placement when only one
+ * page may be shown.
+ */
+
+/** One placement of a note on a page. */
+interface NotePlacement {
+    /** The page the note is placed on. */
+    pageId: string;
+    /** The note that is placed on the page. */
+    noteId: string;
+    /** Ordinal within the page, when the placement carries one. */
+    position?: number;
+    /** When the placement was created — the second ordering tie-breaker. */
+    createdAt: number;
+    /** Calendar date of the page, when the page is a date page. */
+    date?: string;
+    /** Route slug of the page, when the page is a named page. */
+    slug?: string;
+    /** Display title of the page, when it has one. */
+    title?: string;
+}
+/**
+ * A page addressed by its public identity — a calendar date (`date`) or a
+ * named route (`slug`). A page row may carry both; either one resolves it.
+ */
+interface PageTarget {
+    /** YYYY-MM-DD — the calendar page for that day. */
+    date?: string;
+    /** Route slug — the named page for that route. */
+    slug?: string;
+}
+/**
+ * Canonical placement order: explicit position first (smaller first, a
+ * row without a position last), then creation time, then the row id.
+ *
+ * A placement written without an explicit position therefore lands after
+ * every positioned row — appending is the default.
+ */
+declare function comparePlacements(a: PageNote, b: PageNote): number;
+/** The canonical placement order of a note's junction rows. */
+declare function orderPlacements(links: readonly PageNote[]): PageNote[];
+/**
+ * Resolve junction rows into placements, in canonical order. Rows whose
+ * page is missing are dropped — a placement without a page addresses
+ * nothing.
+ */
+declare function resolvePlacements(links: readonly PageNote[], pages: readonly Page[]): NotePlacement[];
+/**
+ * The single-page projections of a note's placements.
+ *
+ * A note may sit on several pages, so `pageId`, `journalDate` and
+ * `pageSlug` are projections — never the membership itself. The rule is
+ * deterministic:
+ *
+ * - `pageId` — the page of the **primary placement**: the first placement
+ *   in the canonical placement order.
+ * - `journalDate` — the date of the first calendar placement in that order.
+ * - `pageSlug` — the slug of the first named placement (a page with a slug
+ *   and no date) in that order.
+ *
+ * A note placed on several pages keeps every placement; only these three
+ * fields are narrowed, and they always name the same placements for the
+ * same inputs.
+ */
+interface PlacementProjection {
+    /** The page id of the primary placement. */
+    pageId?: string;
+    /** The calendar date of the first calendar placement. */
+    journalDate?: string;
+    /** The route slug of the first named placement. */
+    pageSlug?: string;
+}
+/** Project a note's placements onto the single-page fields. */
+declare function projectPlacements(placements: readonly NotePlacement[]): PlacementProjection;
+
 /**
  * State of a WOD block
  */
@@ -1616,19 +1732,43 @@ interface SectionDocument {
  * (including the predefined default notebooks `notebook/journal`,
  * `notebook/playground`, and `notebook/guides`).
  */
+
 /** Predefined default notebook slugs always present in the application. */
-declare const DEFAULT_NOTEBOOK_SLUGS: readonly ["journal", "playground", "guides"];
+declare const DEFAULT_NOTEBOOK_SLUGS: readonly ["journal", "playground", "defaults", "guides"];
 type DefaultNotebookSlug = (typeof DEFAULT_NOTEBOOK_SLUGS)[number];
 type NotebookId = `notebook/${string}`;
-type NotebookOrigin = 'default' | 'user' | 'seed';
+/** Where a notebook comes from. 'feed' = delivered by a feed (the feed that
+ *  delivers it is named by `feedEntryId`); 'user' = the user owns it;
+ *  'default' = one of the predefined notebooks. */
+type NotebookOrigin = 'default' | 'user' | 'feed';
 /** Extract the bare slug from a `notebook/{slug}` or `notebook:{slug}` or bare identifier. */
 declare function notebookSlugFromId(slugOrId: string): string;
 /** Normalize any notebook slug or id to the canonical `notebook/{slug}` form. */
 declare function toNotebookId(slugOrId: string): NotebookId;
-/** Application-level editability rule: only user-created notes (`seedOrigin !== 'seed'`) are editable. */
+/** Application-level editability rule (ticket 05): a note is editable when
+ *  its NOTEBOOK is user-owned. `notebookOrigin` is the origin of the note's
+ *  resolved notebook (`notebookOfItem` + the notebook registry) — feed-delivered
+ *  notebooks are read-only, and a note cloned into a user-owned notebook
+ *  (e.g. `notebook/defaults`) is editable even though it keeps its seed/feed
+ *  provenance stamps. Without a resolved notebook origin the decision falls
+ *  back to the note's own stamps, which match the registry answer for every
+ *  importer-written row. */
 declare function isNoteEditable(note: {
     seedOrigin?: string | null;
-}): boolean;
+    feedOrigin?: string | null;
+}, notebookOrigin?: NotebookOrigin): boolean;
+interface BuiltinNotebookSpec {
+    slug: string;
+    notebookId: NotebookId;
+    name: string;
+    description: string;
+    icon: string;
+    href: string;
+    feedEntryId?: FeedId;
+    seedChunkId?: string;
+}
+/** Single source of truth for always-present built-in and core reference notebooks. */
+declare const BUILTIN_NOTEBOOKS: readonly BuiltinNotebookSpec[];
 interface Notebook {
     /** Canonical `notebook/{slug}` identifier. */
     id: NotebookId | string;
@@ -1640,18 +1780,11 @@ interface Notebook {
     description: string;
     icon: string;
     origin: NotebookOrigin;
-    /** Registered seed source entry id where the source is pulled from. */
-    sourceEntryId?: string;
-    /** Seed package id when delivered by a named package slice. */
-    packageId?: string;
-    /** Seed directory URL where the source is pulled from. */
-    sourceUrl?: string;
-    /** Published Git repository URL when declared by the source entry. */
-    repositoryUrl?: string;
+    /** Registered feed entry id — the feed that publishes this notebook. */
+    feedEntryId?: FeedId;
     /** Seed manifest chunk id when delivered by a seed. */
     seedChunkId?: string;
     createdAt: number;
-    lastEditedAt: number;
 }
 declare const NOTEBOOK_TAG_PREFIX = "notebook:";
 declare const toNotebookTag: (notebookId: string) => string;
@@ -1759,13 +1892,13 @@ declare function patchFrontmatterProperty(raw: string, path: readonly string[],
  * Auto-generated build version metadata.
  * Do not edit directly; updated by scripts/stamp-version.ts
  */
-declare const VERSION = "0.44.2159";
-declare const GIT_SHA = "30e43c7";
-declare const BUILD_TIME = "2026-10-24T23:07:22.311Z";
+declare const VERSION = "0.45.2166";
+declare const GIT_SHA = "32bda10";
+declare const BUILD_TIME = "2026-10-26T20:01:09.868Z";
 declare const SEMVER: {
-    readonly version: "0.44.2159";
-    readonly gitSha: "30e43c7";
-    readonly buildTime: "2026-10-24T23:07:22.311Z";
+    readonly version: "0.45.2166";
+    readonly gitSha: "32bda10";
+    readonly buildTime: "2026-10-26T20:01:09.868Z";
 };
 
-export { type AnalyticsDataPoint, type AnalyticsGraphConfig, type AnalyticsGroup, type Attachment, BUILD_TIME, type BlockEffort, type BlockEquipment, type BlockIndexRow, BlockKey, type BlockRevision, type CatalogBackfillState, CodeMetadata, CodeStatement, DEFAULT_NOTEBOOK_SLUGS, type DefaultNotebookSlug, 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, type ITagSource, 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 NotebookId, type NotebookOrigin, 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, TAG_REFERENCE_METADATA_KEY, type Tag, type TagContribution, type TagDefinition, type TagFunctionContribution, type TagIndex, type TagMetricContribution, type TagReferenceMetadata, type TagTagContribution, 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, createTagIndex, detectScriptBlocks, dimensionKeyOf, extractBlockContent, fieldRefFromKey, fieldRefKey, findBlockAtLine, flattenFieldLeaves, fromNotebookTag, getMetricOwnershipLayer, getReferenceMetadata, getTagReference, isNoteEditable, isNotebookTag, isWorkoutSectionType, lookupUnit, mapNoteBlockChanges, matchDialectFence, normalizeFieldComponent, normalizeFieldPath, notebookSlugFromId, ownershipRank, parseDocumentSections, patchFrontmatterProperty, reconcileNoteBlocks, resolveLayer, runAffordance, systemDefaultUnit, toNotebookId, toNotebookTag, validateNoteBlocks, valueKindOf };
+export { type AnalyticsDataPoint, type AnalyticsGraphConfig, type AnalyticsGroup, type Attachment, BUILD_TIME, BUILTIN_NOTEBOOKS, type BlockEffort, type BlockEquipment, type BlockIndexRow, BlockKey, type BlockRevision, type BuiltinNotebookSpec, type CatalogBackfillState, CodeMetadata, CodeStatement, DEFAULT_NOTEBOOK_SLUGS, type DefaultNotebookSlug, type DialectAnalysis, type DimensionKey, type DisplayStatus, type EventGrain, type EventRecord, type FeedId, type FeedOrigin, 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, type ITagSource, 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 NotePlacement, type NoteTag, type Notebook, type NotebookId, type NotebookOrigin, type NullValueKind, type Origin, OutputStatement, type OutputStatementOptions, type OutputStatementType, OwnershipResolver, type Page, type PageNote, type PageTarget, type ParseError, ParsedCodeStatement, type PlacementProjection, 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, TAG_REFERENCE_METADATA_KEY, type Tag, type TagContribution, type TagDefinition, type TagFunctionContribution, type TagIndex, type TagMetricContribution, type TagReferenceMetadata, type TagTagContribution, 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, comparePlacements, convertViaCatalog, createMetricOwnershipLedger, createTagIndex, detectScriptBlocks, dimensionKeyOf, extractBlockContent, fieldRefFromKey, fieldRefKey, findBlockAtLine, flattenFieldLeaves, fromNotebookTag, getMetricOwnershipLayer, getReferenceMetadata, getTagReference, isNoteEditable, isNotebookTag, isWorkoutSectionType, lookupUnit, mapNoteBlockChanges, matchDialectFence, normalizeFieldComponent, normalizeFieldPath, notebookSlugFromId, orderPlacements, ownershipRank, parseDocumentSections, patchFrontmatterProperty, projectPlacements, reconcileNoteBlocks, resolveLayer, resolvePlacements, runAffordance, systemDefaultUnit, toNotebookId, toNotebookTag, validateNoteBlocks, valueKindOf };

package/dist/index.d.ts

@@ -1117,6 +1117,28 @@ interface WorkoutResults {
     completed: boolean;
 }
 
+/**
+ * Feed identity — the source-side vocabulary.
+ *
+ * A **feed** is one published directory the app subscribes to and syncs as a
+ * unit (the glossary's *Feed*). The word "seed" no longer names a source:
+ * a registered source is a feed, its id is a feed id, and the artifact it
+ * serves is a **Seed** (see `SeedManifest` in the engine's seed contract).
+ *
+ * A registered feed has ONE id — the registry id, `FeedSource.id` — and
+ * that id is also the note's `feedSourceId` and the suffix of the import
+ * checkpoint key (`seed:<id>`, whose `seed:` prefix is a persisted wire
+ * format, not a source name).
+ */
+/** A feed identifier — the id of one registered feed source. */
+type FeedId = string;
+/**
+ * How a record came to be: delivered by a feed (`'feed'`), or authored and
+ * owned by the user (`'user'`). The feed-side twin of the artifact-side
+ * `seedOrigin` (`'seed' | 'user'`) — the two agree on every imported note.
+ */
+type FeedOrigin = 'feed' | 'user';
+
 type NoteBlockKind = 'wod' | 'query' | 'widget' | 'embed';
 interface NoteBlock {
     id: string;
@@ -1138,7 +1160,7 @@ interface BlockRevision {
     dialect?: 'time' | 'log';
     sport?: string;
 }
-type NoteKind = 'journal' | 'template' | 'playground' | 'feed' | 'dashboard' | 'page' | (string & {});
+type NoteKind = 'journal' | 'playground' | 'dashboard' | 'page' | 'note' | (string & {});
 interface Note {
     id: string;
     title: string;
@@ -1149,14 +1171,22 @@ interface Note {
     createdAt: number;
     type?: NoteKind;
     sourceId?: string;
-    catalog?: string;
     /** Canonical notebook identifier ('notebook/{slug}', e.g. 'notebook/journal', 'notebook/playground', 'notebook/guides'). */
     notebookId?: string;
     tags?: string[];
+    /** Artifact provenance — which published bundle this note came from.
+     *  Persisted field names; the artifact they describe is a **Seed**. */
     seedOrigin?: 'seed' | 'user';
     seedVersion?: number;
     seedChunkId?: string;
-    /** Authored seed path used for deterministic identity and routing. */
+    /** Feed provenance — 'feed' for a note a feed delivered, 'user' for one the
+     *  user owns. The two agree: a feed-delivered note is seed-delivered, and
+     *  vice versa. */
+    feedOrigin?: FeedOrigin;
+    /** The registered feed that delivered this note (the feed's own id).
+     *  Read from here alone — never from the seed stamps. */
+    feedSourceId?: FeedId;
+    /** Authored corpus path used for deterministic identity and routing. */
     sourcePath?: string;
     /** Git commit hash in which this note was published or changed. */
     seedCommit?: string;
@@ -1175,7 +1205,7 @@ interface PageNote {
     position?: number;
     createdAt: number;
 }
-type TagType = 'template' | 'playground' | 'qualification' | 'notebook' | 'general' | (string & {});
+type TagType = 'playground' | 'qualification' | 'notebook' | 'general' | (string & {});
 interface TagTypeRecord {
     id: string;
     name: string;
@@ -1496,6 +1526,92 @@ interface Membership {
     updatedAt?: number;
 }
 
+/**
+ * Page placement — the resolved form of one `page_notes` junction row.
+ *
+ * Placement is many-to-many: a note may sit on several pages (a calendar
+ * day, a named collection, …) and a page may hold several notes. The
+ * junction row is the only membership record; a note carries no page
+ * reference of its own.
+ *
+ * One ordering decides everything placement-related — the **canonical
+ * placement order**: explicit `position` first (smaller first, a row
+ * without one last), then creation time, then the row id. It reads a
+ * page's notes in order and picks the *primary* placement when only one
+ * page may be shown.
+ */
+
+/** One placement of a note on a page. */
+interface NotePlacement {
+    /** The page the note is placed on. */
+    pageId: string;
+    /** The note that is placed on the page. */
+    noteId: string;
+    /** Ordinal within the page, when the placement carries one. */
+    position?: number;
+    /** When the placement was created — the second ordering tie-breaker. */
+    createdAt: number;
+    /** Calendar date of the page, when the page is a date page. */
+    date?: string;
+    /** Route slug of the page, when the page is a named page. */
+    slug?: string;
+    /** Display title of the page, when it has one. */
+    title?: string;
+}
+/**
+ * A page addressed by its public identity — a calendar date (`date`) or a
+ * named route (`slug`). A page row may carry both; either one resolves it.
+ */
+interface PageTarget {
+    /** YYYY-MM-DD — the calendar page for that day. */
+    date?: string;
+    /** Route slug — the named page for that route. */
+    slug?: string;
+}
+/**
+ * Canonical placement order: explicit position first (smaller first, a
+ * row without a position last), then creation time, then the row id.
+ *
+ * A placement written without an explicit position therefore lands after
+ * every positioned row — appending is the default.
+ */
+declare function comparePlacements(a: PageNote, b: PageNote): number;
+/** The canonical placement order of a note's junction rows. */
+declare function orderPlacements(links: readonly PageNote[]): PageNote[];
+/**
+ * Resolve junction rows into placements, in canonical order. Rows whose
+ * page is missing are dropped — a placement without a page addresses
+ * nothing.
+ */
+declare function resolvePlacements(links: readonly PageNote[], pages: readonly Page[]): NotePlacement[];
+/**
+ * The single-page projections of a note's placements.
+ *
+ * A note may sit on several pages, so `pageId`, `journalDate` and
+ * `pageSlug` are projections — never the membership itself. The rule is
+ * deterministic:
+ *
+ * - `pageId` — the page of the **primary placement**: the first placement
+ *   in the canonical placement order.
+ * - `journalDate` — the date of the first calendar placement in that order.
+ * - `pageSlug` — the slug of the first named placement (a page with a slug
+ *   and no date) in that order.
+ *
+ * A note placed on several pages keeps every placement; only these three
+ * fields are narrowed, and they always name the same placements for the
+ * same inputs.
+ */
+interface PlacementProjection {
+    /** The page id of the primary placement. */
+    pageId?: string;
+    /** The calendar date of the first calendar placement. */
+    journalDate?: string;
+    /** The route slug of the first named placement. */
+    pageSlug?: string;
+}
+/** Project a note's placements onto the single-page fields. */
+declare function projectPlacements(placements: readonly NotePlacement[]): PlacementProjection;
+
 /**
  * State of a WOD block
  */
@@ -1616,19 +1732,43 @@ interface SectionDocument {
  * (including the predefined default notebooks `notebook/journal`,
  * `notebook/playground`, and `notebook/guides`).
  */
+
 /** Predefined default notebook slugs always present in the application. */
-declare const DEFAULT_NOTEBOOK_SLUGS: readonly ["journal", "playground", "guides"];
+declare const DEFAULT_NOTEBOOK_SLUGS: readonly ["journal", "playground", "defaults", "guides"];
 type DefaultNotebookSlug = (typeof DEFAULT_NOTEBOOK_SLUGS)[number];
 type NotebookId = `notebook/${string}`;
-type NotebookOrigin = 'default' | 'user' | 'seed';
+/** Where a notebook comes from. 'feed' = delivered by a feed (the feed that
+ *  delivers it is named by `feedEntryId`); 'user' = the user owns it;
+ *  'default' = one of the predefined notebooks. */
+type NotebookOrigin = 'default' | 'user' | 'feed';
 /** Extract the bare slug from a `notebook/{slug}` or `notebook:{slug}` or bare identifier. */
 declare function notebookSlugFromId(slugOrId: string): string;
 /** Normalize any notebook slug or id to the canonical `notebook/{slug}` form. */
 declare function toNotebookId(slugOrId: string): NotebookId;
-/** Application-level editability rule: only user-created notes (`seedOrigin !== 'seed'`) are editable. */
+/** Application-level editability rule (ticket 05): a note is editable when
+ *  its NOTEBOOK is user-owned. `notebookOrigin` is the origin of the note's
+ *  resolved notebook (`notebookOfItem` + the notebook registry) — feed-delivered
+ *  notebooks are read-only, and a note cloned into a user-owned notebook
+ *  (e.g. `notebook/defaults`) is editable even though it keeps its seed/feed
+ *  provenance stamps. Without a resolved notebook origin the decision falls
+ *  back to the note's own stamps, which match the registry answer for every
+ *  importer-written row. */
 declare function isNoteEditable(note: {
     seedOrigin?: string | null;
-}): boolean;
+    feedOrigin?: string | null;
+}, notebookOrigin?: NotebookOrigin): boolean;
+interface BuiltinNotebookSpec {
+    slug: string;
+    notebookId: NotebookId;
+    name: string;
+    description: string;
+    icon: string;
+    href: string;
+    feedEntryId?: FeedId;
+    seedChunkId?: string;
+}
+/** Single source of truth for always-present built-in and core reference notebooks. */
+declare const BUILTIN_NOTEBOOKS: readonly BuiltinNotebookSpec[];
 interface Notebook {
     /** Canonical `notebook/{slug}` identifier. */
     id: NotebookId | string;
@@ -1640,18 +1780,11 @@ interface Notebook {
     description: string;
     icon: string;
     origin: NotebookOrigin;
-    /** Registered seed source entry id where the source is pulled from. */
-    sourceEntryId?: string;
-    /** Seed package id when delivered by a named package slice. */
-    packageId?: string;
-    /** Seed directory URL where the source is pulled from. */
-    sourceUrl?: string;
-    /** Published Git repository URL when declared by the source entry. */
-    repositoryUrl?: string;
+    /** Registered feed entry id — the feed that publishes this notebook. */
+    feedEntryId?: FeedId;
     /** Seed manifest chunk id when delivered by a seed. */
     seedChunkId?: string;
     createdAt: number;
-    lastEditedAt: number;
 }
 declare const NOTEBOOK_TAG_PREFIX = "notebook:";
 declare const toNotebookTag: (notebookId: string) => string;
@@ -1759,13 +1892,13 @@ declare function patchFrontmatterProperty(raw: string, path: readonly string[],
  * Auto-generated build version metadata.
  * Do not edit directly; updated by scripts/stamp-version.ts
  */
-declare const VERSION = "0.44.2159";
-declare const GIT_SHA = "30e43c7";
-declare const BUILD_TIME = "2026-10-24T23:07:22.311Z";
+declare const VERSION = "0.45.2166";
+declare const GIT_SHA = "32bda10";
+declare const BUILD_TIME = "2026-10-26T20:01:09.868Z";
 declare const SEMVER: {
-    readonly version: "0.44.2159";
-    readonly gitSha: "30e43c7";
-    readonly buildTime: "2026-10-24T23:07:22.311Z";
+    readonly version: "0.45.2166";
+    readonly gitSha: "32bda10";
+    readonly buildTime: "2026-10-26T20:01:09.868Z";
 };
 
-export { type AnalyticsDataPoint, type AnalyticsGraphConfig, type AnalyticsGroup, type Attachment, BUILD_TIME, type BlockEffort, type BlockEquipment, type BlockIndexRow, BlockKey, type BlockRevision, type CatalogBackfillState, CodeMetadata, CodeStatement, DEFAULT_NOTEBOOK_SLUGS, type DefaultNotebookSlug, 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, type ITagSource, 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 NotebookId, type NotebookOrigin, 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, TAG_REFERENCE_METADATA_KEY, type Tag, type TagContribution, type TagDefinition, type TagFunctionContribution, type TagIndex, type TagMetricContribution, type TagReferenceMetadata, type TagTagContribution, 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, createTagIndex, detectScriptBlocks, dimensionKeyOf, extractBlockContent, fieldRefFromKey, fieldRefKey, findBlockAtLine, flattenFieldLeaves, fromNotebookTag, getMetricOwnershipLayer, getReferenceMetadata, getTagReference, isNoteEditable, isNotebookTag, isWorkoutSectionType, lookupUnit, mapNoteBlockChanges, matchDialectFence, normalizeFieldComponent, normalizeFieldPath, notebookSlugFromId, ownershipRank, parseDocumentSections, patchFrontmatterProperty, reconcileNoteBlocks, resolveLayer, runAffordance, systemDefaultUnit, toNotebookId, toNotebookTag, validateNoteBlocks, valueKindOf };
+export { type AnalyticsDataPoint, type AnalyticsGraphConfig, type AnalyticsGroup, type Attachment, BUILD_TIME, BUILTIN_NOTEBOOKS, type BlockEffort, type BlockEquipment, type BlockIndexRow, BlockKey, type BlockRevision, type BuiltinNotebookSpec, type CatalogBackfillState, CodeMetadata, CodeStatement, DEFAULT_NOTEBOOK_SLUGS, type DefaultNotebookSlug, type DialectAnalysis, type DimensionKey, type DisplayStatus, type EventGrain, type EventRecord, type FeedId, type FeedOrigin, 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, type ITagSource, 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 NotePlacement, type NoteTag, type Notebook, type NotebookId, type NotebookOrigin, type NullValueKind, type Origin, OutputStatement, type OutputStatementOptions, type OutputStatementType, OwnershipResolver, type Page, type PageNote, type PageTarget, type ParseError, ParsedCodeStatement, type PlacementProjection, 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, TAG_REFERENCE_METADATA_KEY, type Tag, type TagContribution, type TagDefinition, type TagFunctionContribution, type TagIndex, type TagMetricContribution, type TagReferenceMetadata, type TagTagContribution, 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, comparePlacements, convertViaCatalog, createMetricOwnershipLedger, createTagIndex, detectScriptBlocks, dimensionKeyOf, extractBlockContent, fieldRefFromKey, fieldRefKey, findBlockAtLine, flattenFieldLeaves, fromNotebookTag, getMetricOwnershipLayer, getReferenceMetadata, getTagReference, isNoteEditable, isNotebookTag, isWorkoutSectionType, lookupUnit, mapNoteBlockChanges, matchDialectFence, normalizeFieldComponent, normalizeFieldPath, notebookSlugFromId, orderPlacements, ownershipRank, parseDocumentSections, patchFrontmatterProperty, projectPlacements, reconcileNoteBlocks, resolveLayer, resolvePlacements, runAffordance, systemDefaultUnit, toNotebookId, toNotebookTag, validateNoteBlocks, valueKindOf };