@beyondwork/docx-react-component 1.0.66 → 1.0.69

package/src/core/commands/section-layout-commands.ts

@@ -15,6 +15,7 @@ import type {
 import type {
   CanonicalDocument as CanonicalDocumentEnvelope,
   ColumnProperties,
+  MutableCanonicalDocument,
   PageMargins,
   PageNumbering,
   PageSize,
@@ -128,7 +129,7 @@ export function insertSectionBreak(
   breakType: SectionBreakType,
   _context: SectionLayoutCommandContext,
 ): SectionLayoutMutationResult {
-  const cloned = structuredClone(document) as CanonicalDocumentEnvelope;
+  const cloned = structuredClone(document) as MutableCanonicalDocument;
   const surface = snapshot.surface;
 
   if (!surface) {
@@ -168,7 +169,7 @@ export function insertSectionBreakAfterSectionIndex(
   breakType: SectionBreakType,
   context: SectionLayoutCommandContext,
 ): SectionLayoutMutationResult {
-  const cloned = structuredClone(document) as CanonicalDocumentEnvelope;
+  const cloned = structuredClone(document) as MutableCanonicalDocument;
   const insertionIndex = findSectionInsertionIndex(cloned, sectionIndex);
   if (insertionIndex < 0) {
     return noopResult(document, createSelectionSnapshot(0, 0));
@@ -207,7 +208,7 @@ export function deleteSectionBreak(
   snapshot: RuntimeRenderSnapshot,
   _context: SectionLayoutCommandContext,
 ): SectionLayoutMutationResult {
-  const cloned = structuredClone(document) as CanonicalDocumentEnvelope;
+  const cloned = structuredClone(document) as MutableCanonicalDocument;
 
   const breakIndex = findNearestSectionBreak(cloned, snapshot);
   if (breakIndex < 0) {
@@ -240,7 +241,7 @@ export function deleteSectionBreakAtSectionIndex(
     return noopResult(document, createSelectionSnapshot(0, 0));
   }
 
-  const cloned = structuredClone(document) as CanonicalDocumentEnvelope;
+  const cloned = structuredClone(document) as MutableCanonicalDocument;
   const breakIndex = findSectionBreakNodeIndexForSection(cloned, sectionIndex);
   if (breakIndex < 0) {
     return noopResult(document, createSelectionSnapshot(0, 0));
@@ -269,7 +270,7 @@ export function updateSectionLayout(
   patch: SectionLayoutPatch,
   _context: SectionLayoutCommandContext,
 ): SectionLayoutMutationResult {
-  const cloned = structuredClone(document) as CanonicalDocumentEnvelope;
+  const cloned = structuredClone(document) as MutableCanonicalDocument;
   const surface = snapshot.surface;
 
   if (!surface) {
@@ -317,7 +318,7 @@ export function updateSectionLayoutAtSectionIndex(
   patch: SectionLayoutPatch,
   context: SectionLayoutCommandContext,
 ): SectionLayoutMutationResult {
-  const cloned = structuredClone(document) as CanonicalDocumentEnvelope;
+  const cloned = structuredClone(document) as MutableCanonicalDocument;
   const target = resolveSectionPropertiesOwner(cloned, sectionIndex);
   if (!target) {
     return noopResult(document, createSelectionSnapshot(0, 0));
@@ -355,7 +356,7 @@ export function setSectionPageNumberingAtSectionIndex(
   pageNumbering: Partial<PageNumbering> | null,
   context: SectionLayoutCommandContext,
 ): SectionLayoutMutationResult {
-  const cloned = structuredClone(document) as CanonicalDocumentEnvelope;
+  const cloned = structuredClone(document) as MutableCanonicalDocument;
   const target = resolveSectionPropertiesOwner(cloned, sectionIndex);
   if (!target) {
     return noopResult(document, createSelectionSnapshot(0, 0));
@@ -402,7 +403,7 @@ export function setHeaderFooterLinkAtSectionIndex(
   patch: SectionLinkPatch,
   context: SectionLayoutCommandContext,
 ): SectionLayoutMutationResult {
-  const cloned = structuredClone(document) as CanonicalDocumentEnvelope;
+  const cloned = structuredClone(document) as MutableCanonicalDocument;
   const target = resolveSectionPropertiesOwner(cloned, sectionIndex);
   if (!target) {
     return noopResult(document, createSelectionSnapshot(0, 0));

package/src/core/schema/text-schema.ts

@@ -11,6 +11,13 @@ import type {
 export interface ParagraphProperties {
   styleId?: string;
   numbering?: ParagraphNode["numbering"];
+  /**
+   * w14:paraId / w14:textId — stable across reopen. Must round-trip
+   * through the text-transaction rebuild so paragraph-kind scope ids
+   * (see `src/runtime/scopes/enumerate-scopes.ts:204`) survive a text
+   * replace. Fix for coord-08 §11 / harness finding B2.
+   */
+  wordExtensionIds?: ParagraphNode["wordExtensionIds"];
 }
 
 export interface TextStory {
@@ -451,6 +458,9 @@ export function cloneParagraphProperties(
           },
         }
       : {}),
+    ...(properties.wordExtensionIds
+      ? { wordExtensionIds: { ...properties.wordExtensionIds } }
+      : {}),
   };
 }
 
@@ -553,6 +563,9 @@ function extractParagraphProperties(paragraph: ParagraphNode): ParagraphProperti
           },
         }
       : {}),
+    ...(paragraph.wordExtensionIds
+      ? { wordExtensionIds: { ...paragraph.wordExtensionIds } }
+      : {}),
   };
 }
 
@@ -568,6 +581,9 @@ function createParagraph(properties: ParagraphProperties): ParagraphNode {
           },
         }
       : {}),
+    ...(properties.wordExtensionIds
+      ? { wordExtensionIds: { ...properties.wordExtensionIds } }
+      : {}),
     children: [],
   };
 }

package/src/core/selection/mapping.ts

@@ -1,54 +1,37 @@
 import type { EditorStoryTarget } from "../../api/public-types";
-
-export type Position = number;
-export type Assoc = -1 | 1;
-
-export interface DocRange {
-  from: Position;
-  to: Position;
-}
-
-export interface BoundaryAssoc {
-  start: Assoc;
-  end: Assoc;
-}
-
-export interface RangeAnchor {
-  kind: "range";
-  range: DocRange;
-  assoc: BoundaryAssoc;
-}
-
-export interface NodeAnchor {
-  kind: "node";
-  at: Position;
-  assoc: Assoc;
-}
-
-export interface DetachedAnchor {
-  kind: "detached";
-  lastKnownRange: DocRange;
-  reason: "deleted" | "invalidatedByStructureChange" | "importAmbiguity";
-}
-
-/**
- * Internal representation of an anchor projection — uses `DocRange` so
- * mapping helpers compose ranges independently of assoc semantics. The
- * public-facing shape lives at `src/api/public-types.ts` (same simple name
- * `EditorAnchorProjection`) and is flat (`{ kind: "range", from, to, assoc }`).
- * Conversion between the two goes through `src/core/selection/anchor-conversion.ts`.
- */
-export type InternalEditorAnchorProjection = RangeAnchor | NodeAnchor | DetachedAnchor;
-
-/**
- * @deprecated X3 Phase 5 — prefer `InternalEditorAnchorProjection` to avoid
- * name-collision with the public `EditorAnchorProjection` from
- * `src/api/public-types.ts`. Internal call-sites have migrated (via
- * `import type { EditorAnchorProjection as InternalEditorAnchorProjection }`
- * aliasing in `document-runtime.ts`). This alias stays for one release cycle
- * so third-party internal consumers don't break. Remove in v2.1+.
- */
-export type EditorAnchorProjection = InternalEditorAnchorProjection;
+import {
+  createDetachedAnchor,
+  DEFAULT_BOUNDARY_ASSOC,
+  normalizeRange,
+  type Assoc,
+  type BoundaryAssoc,
+  type DetachedAnchor,
+  type DocRange,
+  type EditorAnchorProjection,
+  type InternalEditorAnchorProjection,
+  type NodeAnchor,
+  type Position,
+  type RangeAnchor,
+} from "../../model/anchor.ts";
+
+// Anchor data shapes + pure factories live at `src/model/anchor.ts`.
+// Re-exported here for back-compat with every site that already imports
+// anchor types / createDetachedAnchor from `core/selection/mapping`. The
+// mapping machinery below operates on them.
+export {
+  createDetachedAnchor,
+  DEFAULT_BOUNDARY_ASSOC,
+  normalizeRange,
+  type Assoc,
+  type BoundaryAssoc,
+  type DetachedAnchor,
+  type DocRange,
+  type EditorAnchorProjection,
+  type InternalEditorAnchorProjection,
+  type NodeAnchor,
+  type Position,
+  type RangeAnchor,
+};
 
 export interface MappingStep {
   from: Position;
@@ -78,11 +61,6 @@ export interface TransactionMapping {
   };
 }
 
-export const DEFAULT_BOUNDARY_ASSOC: BoundaryAssoc = {
-  start: 1,
-  end: -1,
-};
-
 export function createRangeAnchor(
   from: Position,
   to = from,
@@ -103,29 +81,12 @@ export function createNodeAnchor(at: Position, assoc: Assoc = 1): NodeAnchor {
   };
 }
 
-export function createDetachedAnchor(
-  lastKnownRange: DocRange,
-  reason: DetachedAnchor["reason"],
-): DetachedAnchor {
-  return {
-    kind: "detached",
-    lastKnownRange: normalizeRange(lastKnownRange),
-    reason,
-  };
-}
-
 export function createEmptyMapping(): TransactionMapping {
   return {
     steps: [],
   };
 }
 
-export function normalizeRange(range: DocRange): DocRange {
-  return range.from <= range.to
-    ? { from: range.from, to: range.to }
-    : { from: range.to, to: range.from };
-}
-
 export function getEffectiveRange(anchor: EditorAnchorProjection): DocRange {
   if (anchor.kind === "range") {
     return anchor.range;

package/src/core/state/editor-state.ts

@@ -3,9 +3,14 @@ import {
   createDetachedAnchor,
   createNodeAnchor,
   createRangeAnchor,
-  type EditorAnchorProjection,
+  type EditorAnchorProjection as InternalEditorAnchorProjection,
 } from "../selection/mapping.ts";
-import { isUuid } from "../../model/cds-1.0.0.ts";
+import {
+  createPublicDetachedAnchor,
+  createPublicNodeAnchor,
+  createPublicRangeAnchor,
+} from "../selection/anchor-conversion.ts";
+import type { EditorAnchorProjection } from "../../api/public-types.ts";
 import {
   assertPersistedEditorSnapshot as assertModelPersistedEditorSnapshot,
   createPersistedEditorSnapshot as createModelPersistedEditorSnapshot,
@@ -15,6 +20,9 @@ import {
 } from "../../model/snapshot.ts";
 import {
   assertCanonicalDocument,
+  createCanonicalDocumentId,
+  createEmptyCanonicalDocument as createEmptyCanonicalDocumentModel,
+  repairCanonicalDocumentEnvelope,
   type CanonicalDocument,
   type CommentEntry as ModelCommentEntry,
   type CommentResolution as ModelCommentResolution,
@@ -23,75 +31,53 @@ import {
   type RevisionRecord as ModelRevisionRecord,
 } from "../../model/canonical-document.ts";
 
+export { createCanonicalDocumentId };
+
 export type RuntimePhase = "loading" | "ready" | "error";
-export type EditorWarningCode =
-  | "unsupported_ooxml_preserved"
-  | "unsupported_ooxml_locked"
-  | "import_normalized"
-  | "export_roundtrip_risk"
-  | "comment_anchor_detached"
-  | "revision_anchor_detached"
-  | "workflow_scope_invalidated"
-  | "large_document_degraded"
-  | "font_substitution"
-  | "image_missing"
-  | "review_target_not_found";
-
-export interface EditorWarning {
-  warningId: string;
-  code: EditorWarningCode;
-  severity: "info" | "warning";
-  message: string;
-  source:
-    | "import"
-    | "runtime"
-    | "review"
-    | "preservation"
-    | "validation"
-    | "export";
-  affectedAnchor?: EditorAnchorProjection;
-  featureEntryId?: string;
-  details?: Record<string, unknown>;
-  diagnostic?: import("../../api/public-types.ts").EditorDiagnostic;
-}
-
-export interface EditorError {
-  errorId: string;
-  code:
-    | "import_failed"
-    | "export_failed"
-    | "package_corrupt"
-    | "validation_failed"
-    | "datastore_failed"
-    | "internal_invariant";
-  message: string;
-  isFatal: boolean;
-  source: "import" | "runtime" | "validation" | "datastore" | "host" | "export";
-  details?: Record<string, unknown>;
-}
-
-export type CompatibilityFeatureClass =
-  | "supported-roundtrip"
-  | "preserve-only"
-  | "unsupported-fatal";
-
-export interface CompatibilityFeatureEntry {
-  featureEntryId: string;
-  featureKey: string;
-  featureClass: CompatibilityFeatureClass;
-  message: string;
-  affectedAnchor?: EditorAnchorProjection;
-  details?: Record<string, unknown>;
-}
-
-export interface CompatibilityReport {
-  reportVersion: "compatibility-report/1";
-  generatedAt: string;
-  blockExport: boolean;
-  featureEntries: CompatibilityFeatureEntry[];
-  warnings: EditorWarning[];
-  errors: EditorError[];
-}
+
+/**
+ * Review-record types — `EditorWarning`, `EditorError`,
+ * `CompatibilityFeatureEntry`, `CompatibilityReport`,
+ * `CompatibilityFeatureClass`, and the code enums — are re-exports of
+ * the public shapes in `src/api/public-types.ts`. Until 2026-04-22 the
+ * runtime held distinct `Internal*`-flavored copies that differed from
+ * the public types *only* on `affectedAnchor` (nested
+ * `{range: {from, to}}` vs flat `{from, to}`). That drift forced
+ * `src/api/diagnostic-conversion.ts` at every boundary between the
+ * runtime and the public API.
+ *
+ * Resolution: flatten at the **record-attachment boundary**. Internal
+ * code that constructs records with nested anchors now wraps with
+ * `createPublicRangeAnchor` / `toPublicAnchorProjection` at the
+ * construction site — the resulting record carries a flat anchor
+ * end-to-end. The nested shape remains the authoritative mapping-
+ * composition format inside `src/core/selection/mapping.ts`; the flat
+ * shape is the record-attachment format. `src/core/selection/anchor-
+ * conversion.ts` is kept as the named seam; `src/api/diagnostic-
+ * conversion.ts` was deleted because the record-type conversion
+ * became identity.
+ *
+ * See `docs/plans/cross-layer-coord-02.md §8`.
+ */
+import type {
+  EditorWarning,
+  EditorError,
+  EditorWarningCode,
+  EditorErrorCode,
+  CompatibilityFeatureClass,
+  CompatibilityFeatureEntry,
+  CompatibilityReport,
+} from "../../api/public-types.ts";
+
+export type {
+  EditorWarning,
+  EditorError,
+  EditorWarningCode,
+  EditorErrorCode,
+  CompatibilityFeatureClass,
+  CompatibilityFeatureEntry,
+  CompatibilityReport,
+};
 
 export type CommentEntryRecord = ModelCommentEntry;
 export type CommentResolutionRecord = ModelCommentResolution;
@@ -105,7 +91,15 @@ export interface SelectionSnapshot {
   anchor: number;
   head: number;
   isCollapsed: boolean;
-  activeRange: EditorAnchorProjection;
+  /**
+   * Internal nested-range shape (`{kind:"range", range:{from,to}, assoc}`).
+   * SelectionSnapshot is runtime-internal state used for mapping composition
+   * through `src/core/selection/mapping.ts`; the nested shape is load-bearing
+   * for `DocRange`-unit remap helpers. Public surfaces that expose a
+   * selection convert to the public flat shape via `toPublicAnchorProjection`
+   * at the boundary.
+   */
+  activeRange: InternalEditorAnchorProjection;
 }
 
 export interface DocumentStats {
@@ -218,40 +212,16 @@ export function createDefaultCanonicalDocument(
   documentId: string,
   timestamp: string,
 ): CanonicalDocumentEnvelope {
-  return {
-    schemaVersion: "cds/1.0.0",
+  // Thin wrapper around the model-layer factory. The canonical shape of
+  // "an empty document" belongs to Layer 02 so every construction path
+  // agrees on the default envelope; this file's remaining responsibility
+  // is to derive a stable per-session `docId` from the host's
+  // `documentId` (not a model concern — the hash is a session-layer
+  // convention that happens to resolve to a UUID-shaped string).
+  return createEmptyCanonicalDocumentModel({
     docId: createCanonicalDocumentId(documentId),
     createdAt: timestamp,
-    updatedAt: timestamp,
-    metadata: {
-      customProperties: {},
-    },
-    styles: {
-      paragraphs: {},
-      characters: {},
-      tables: {},
-    },
-    numbering: {
-      abstractDefinitions: {},
-      instances: {},
-    },
-    media: {
-      items: {},
-    },
-    content: {
-      type: "doc",
-      children: [{ type: "paragraph", children: [] }],
-    },
-    review: createEmptyReviewStore(),
-    preservation: {
-      opaqueFragments: {},
-      packageParts: {},
-    },
-    diagnostics: {
-      warnings: [],
-      errors: [],
-    },
-  };
+  });
 }
 
 export function createSelectionSnapshot(anchor = 0, head = anchor): SelectionSnapshot {
@@ -385,63 +355,16 @@ function normalizeCanonicalDocumentEnvelope(
   documentId: string,
   timestamp: string,
 ): CanonicalDocumentEnvelope {
-  const base = createDefaultCanonicalDocument(documentId, timestamp);
-  const record = isRecord(value) ? value : {};
-  const metadata = isRecord(record.metadata) ? record.metadata : {};
-
-  return {
-    ...base,
-    ...record,
-    schemaVersion: "cds/1.0.0",
-    docId: isUuid(record.docId) ? record.docId : createCanonicalDocumentId(documentId),
-    createdAt:
-      typeof record.createdAt === "string" && record.createdAt.length > 0
-        ? record.createdAt
-        : base.createdAt,
-    updatedAt:
-      typeof record.updatedAt === "string" && record.updatedAt.length > 0
-        ? record.updatedAt
-        : base.updatedAt,
-    metadata: {
-      ...base.metadata,
-      ...metadata,
-      customProperties: isRecord(metadata.customProperties)
-        ? (Object.fromEntries(
-            Object.entries(metadata.customProperties).filter(([, entry]) => typeof entry === "string"),
-          ) as Record<string, string>)
-        : {},
-    },
-    styles:
-      record.styles === undefined
-        ? base.styles
-        : (record.styles as CanonicalDocumentEnvelope["styles"]),
-    numbering:
-      record.numbering === undefined
-        ? base.numbering
-        : (record.numbering as CanonicalDocumentEnvelope["numbering"]),
-    media:
-      record.media === undefined
-        ? base.media
-        : (record.media as CanonicalDocumentEnvelope["media"]),
-    content: isRecord(record.content)
-      ? (record.content as unknown as CanonicalDocumentEnvelope["content"])
-      : base.content,
-    review:
-      record.review === undefined
-        ? base.review
-        : (record.review as CanonicalDocumentEnvelope["review"]),
-    preservation:
-      record.preservation === undefined
-        ? base.preservation
-        : (record.preservation as CanonicalDocumentEnvelope["preservation"]),
-    diagnostics:
-      record.diagnostics === undefined
-        ? base.diagnostics
-        : (record.diagnostics as CanonicalDocumentEnvelope["diagnostics"]),
-    ...(isRecord(record.subParts)
-      ? { subParts: record.subParts as unknown as CanonicalDocumentEnvelope["subParts"] }
-      : {}),
-  };
+  // Delegated to the model layer so the repair path recognises every
+  // optional field the canonical envelope actually owns — `subParts`,
+  // `fieldRegistry`, and `fontTable`. The previous local copy dropped
+  // `fieldRegistry` and `fontTable`, which silently lost canonical data
+  // on any load-persist-reload cycle.
+  return repairCanonicalDocumentEnvelope(value, {
+    fallbackDocId: createCanonicalDocumentId(documentId),
+    fallbackCreatedAt: timestamp,
+    fallbackUpdatedAt: timestamp,
+  });
 }
 
 function coerceCompatibilityReport(
@@ -692,6 +615,14 @@ function normalizeCompatibilityReport(report: CompatibilityReport): Compatibilit
   };
 }
 
+/**
+ * Defensive anchor-projection normalizer — accepts either shape
+ * (public flat `{kind:"range", from, to, assoc}` *or* legacy nested
+ * `{kind:"range", range:{from,to}, assoc}` from pre-2026-04-22
+ * snapshots) and returns the canonical public flat shape. Records
+ * carry flat anchors by contract, but this normalizer still copes with
+ * the nested shape from older persisted snapshots.
+ */
 function normalizeAnchorProjection(anchor: EditorAnchorProjection): EditorAnchorProjection {
   switch (anchor.kind) {
     case "range": {
@@ -702,13 +633,13 @@ function normalizeAnchorProjection(anchor: EditorAnchorProjection): EditorAnchor
         assoc: { start: -1 | 1; end: -1 | 1 };
       };
       return rangeAnchor.range
-        ? createRangeAnchor(rangeAnchor.range.from, rangeAnchor.range.to, rangeAnchor.assoc)
-        : createRangeAnchor(rangeAnchor.from ?? 0, rangeAnchor.to ?? 0, rangeAnchor.assoc);
+        ? createPublicRangeAnchor(rangeAnchor.range.from, rangeAnchor.range.to, rangeAnchor.assoc)
+        : createPublicRangeAnchor(rangeAnchor.from ?? 0, rangeAnchor.to ?? 0, rangeAnchor.assoc);
     }
     case "node":
-      return createNodeAnchor(anchor.at, anchor.assoc);
+      return createPublicNodeAnchor(anchor.at, anchor.assoc);
     case "detached":
-      return createDetachedAnchor(anchor.lastKnownRange, anchor.reason);
+      return createPublicDetachedAnchor(anchor.lastKnownRange, anchor.reason);
   }
 }
 
@@ -735,30 +666,6 @@ function isRecord(value: unknown): value is Record<string, unknown> {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
 
-export function createCanonicalDocumentId(documentId: string): string {
-  const hashWord = (seed: string): string => {
-    let hash = 0x811c9dc5;
-    for (const char of seed) {
-      hash ^= char.charCodeAt(0);
-      hash = Math.imul(hash, 0x01000193);
-    }
-    return (hash >>> 0).toString(16).padStart(8, "0");
-  };
-
-  const raw =
-    hashWord(`${documentId}:0`) +
-    hashWord(`${documentId}:1`) +
-    hashWord(`${documentId}:2`) +
-    hashWord(`${documentId}:3`);
-
-  return [
-    raw.slice(0, 8),
-    raw.slice(8, 12),
-    `4${raw.slice(13, 16)}`,
-    `8${raw.slice(17, 20)}`,
-    raw.slice(20, 32),
-  ].join("-");
-}
 
 export function normalizeCommentThreadRecord(value: unknown): CommentThreadRecord {
   const record = isRecord(value) ? value : {};
@@ -858,7 +765,7 @@ export function normalizeCommentThreadRecord(value: unknown): CommentThreadRecor
         : "comment-generated",
     anchor:
       isRecord(record.anchor) && typeof record.anchor.kind === "string"
-        ? (record.anchor as unknown as EditorAnchorProjection)
+        ? (record.anchor as unknown as InternalEditorAnchorProjection)
         : createDetachedAnchor({ from: 0, to: 0 }, "importAmbiguity"),
     createdAt,
     createdBy: authorId,

package/src/index.ts

@@ -7,19 +7,38 @@ export {
   validateEditorSessionState,
   EDITOR_SESSION_STATE_VERSION,
 } from "./api/session-state.ts";
+
+// Layer 01 — package/session seam. Host consumers open documents
+// through this class rather than reaching into `src/io/docx-session.ts`.
+// See `docs/architecture/01-package-session.md` § Public entry points.
+export {
+  DocxSession,
+  SessionNotOpenError,
+  SessionNotWiredError,
+} from "./session/index.ts";
+export type {
+  OpenOptions,
+  OpenResult,
+  ExportOptions,
+  ValidateOptions,
+  ValidationReport,
+  ValidationFinding,
+  PreservationSnapshot,
+  EmbeddedDocumentManifest,
+} from "./session/index.ts";
 // R2 — issue metadata id for scope-card-overlay P1.
 // K1-light — review-action metadata id for scope-card-overlay P2.
 export { ISSUE_METADATA_ID, REVIEW_ACTION_METADATA_ID } from "./api/public-types.ts";
 // P17 — metadata persistence error class.
 export { MetadataResolverMissingError } from "./api/public-types.ts";
 
-// Collab substrate (P1 – P8f + P14). See docs/plans/lane-4-collab-clm-vallor.md
+// Collab substrate (P1 – P8f + P14). See CLAUDE.md (lane status table)
 // for the shipped-slice table. Surfaces are stable for host integration;
 // the chrome preset + markdown renderer land in P9 / P10.
 export { createCollabSession } from "./runtime/collab-session.ts";
 export { createCollabSessionBridge } from "./runtime/collab-session-bridge.ts";
 export { createCollabSessionFacet } from "./runtime/collab-session-facet.ts";
-export { createTamperGate } from "./runtime/tamper-gate.ts";
+export { createTamperGate } from "./runtime/workflow/tamper-gate.ts";
 export { resignPayload } from "./runtime/resign-payload.ts";
 export {
   setLocalIdentity,
@@ -61,7 +80,7 @@ export type {
   TamperGateArgs,
   AttachArgs as TamperGateAttachArgs,
   GuardResult as TamperGateGuardResult,
-} from "./runtime/tamper-gate.ts";
+} from "./runtime/workflow/tamper-gate.ts";
 export type {
   RuntimeSendToExternalArgs,
   RuntimeSendToExternalResult,
@@ -309,7 +328,7 @@ export type {
 // L7 Phase 2.5 — prerender cache public API. Platforms / ingest workers
 // call `prerenderDocument(buffer)` on template upload to populate the
 // cache; end-user opens read the cache and skip the layout pass. See
-// docs/plans/lane-2-render-performance.md §Phase 2.5.
+// CLAUDE.md (lane status table) §Phase 2.5.
 export { prerenderDocument } from "./runtime/prerender/prerender-document.ts";
 export type {
   PrerenderOptions,

package/src/io/chart-preview-resolver.ts

@@ -13,7 +13,7 @@
  * (runs at import time only) so §Performance Invariants in CLAUDE.md
  * about synchronous layout reads do not apply.
  *
- * See docs/plans/lane-5-charts.md §2 Task 2.
+ * See CLAUDE.md (lane status table) §2 Task 2.
  */
 
 import type {