markly-merge 1.0.0 → 7.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eda4c38ea47fea966c967f58d230c3bfc11c23df464bf56380fe355d65d2572c
-  data.tar.gz: 64c51d0efc87b2769e59250bf84cdb1f0520838afa6e34243dbd59399cfec62b
+  metadata.gz: 2bc0c8d4bb0e436eae32e17d678a6c07f90ba5ae1d5f3c7aa8e50e2404b017bd
+  data.tar.gz: 38861c64bf98a31c6d675923b0ca661678bd58e5d593730e3c8d9ae9a700ae32
 SHA512:
-  metadata.gz: b4f54cf28d6b325f6a89de94681733d8cf0ab47e38847f28bf152cac1bc13c9b45d5e762f5239ecff78345272dd01677b4d879a77e8fe15602aed6ff1cec4ae8
-  data.tar.gz: 92b2b675dbd018b5868fd3d4908ca6c4e135fb632b4624f28c682605831f5208708e8c0126b680bbc441f66f8f99181422c816b6f9bec708507a4a56718bd8ad
+  metadata.gz: b378f15866f81c77510c908ef06c46698de471a2cca6c6d4f74b30e0490e623638fed9f5ecf67b8462bdd138e6a44c92e1e9b022f8ac76bf9f4459c14ea403ef
+  data.tar.gz: 3ab96bb04c38cceebe97b83dd758275334558ce7b6f42fbfaee896606edd7beb425e6ba961a1b4277a854087aaea378de3fc6db67a5200a1fa661dafbf0d6e15

data/lib/markly/merge/version.rb

@@ -2,11 +2,10 @@
 
 module Markly
   module Merge
-    # Version information for Markly::Merge
     module Version
-      # Current version of the markly-merge gem
-      VERSION = "1.0.0"
+      VERSION = "7.0.0"
     end
-    VERSION = Version::VERSION # traditional location
+
+    VERSION = Version::VERSION
   end
 end

data/lib/markly/merge.rb

@@ -1,110 +1,496 @@
 # frozen_string_literal: true
 
-# Hard dependency - ensures markly gem is installed
+require "markdown-merge"
 require "markly"
 
-# External gems
-require "version_gem"
+module Markly
+  module Merge
+    extend self
 
-# Shared merge infrastructure (includes tree_haver)
-require "markdown/merge"
+    PACKAGE_NAME = "markly-merge"
+    BACKEND_REFERENCE = TreeHaver::BackendReference.new(id: "markly", family: "native").freeze
+    TreeHaver::BackendRegistry.register(BACKEND_REFERENCE)
 
-# This gem
-require_relative "merge/version"
+    def markdown_feature_profile
+      Markdown::Merge.markdown_feature_profile
+    end
 
-module Markly
-  # Smart merging for Markdown files using Markly AST.
-  #
-  # Markly::Merge provides intelligent merging of Markdown files by:
-  # - Parsing Markdown into AST using Markly (cmark-gfm) via tree_haver
-  # - Matching structural elements (headings, paragraphs, lists, etc.) between files
-  # - Preserving frozen sections marked with HTML comments
-  # - Resolving conflicts based on configurable preferences
-  #
-  # This is a thin wrapper around Markdown::Merge that:
-  # - Provides hard dependency on the markly gem
-  # - Sets markly-specific defaults (freeze token, inner_merge_code_blocks)
-  # - Exposes markly-specific options (flags, extensions)
-  # - Maintains API compatibility for existing users
-  #
-  # @example Basic merge
-  #   merger = Markly::Merge::SmartMerger.new(template, destination)
-  #   result = merger.merge
-  #   puts result.content if result.success?
-  #
-  # @example With freeze blocks
-  #   # In your Markdown file:
-  #   # <!-- markly-merge:freeze -->
-  #   # ## Custom Section
-  #   # This content is preserved during merges.
-  #   # <!-- markly-merge:unfreeze -->
-  #
-  # @see SmartMerger Main entry point for merging
-  # @see Markdown::Merge::SmartMerger Underlying implementation
-  module Merge
-    # Base error class for Markly::Merge
-    # Inherits from Markdown::Merge::Error for consistency across merge gems.
-    class Error < Markdown::Merge::Error; end
-
-    # Raised when a Markdown file has parsing errors.
-    # Inherits from Markdown::Merge::ParseError for consistency across merge gems.
-    class ParseError < Markdown::Merge::ParseError; end
-
-    # Raised when the template file has syntax errors.
-    class TemplateParseError < ParseError; end
-
-    # Raised when the destination file has syntax errors.
-    class DestinationParseError < ParseError; end
-
-    # Default freeze token for markly-merge
-    # @return [String]
-    DEFAULT_FREEZE_TOKEN = "markly-merge"
-
-    # Default inner_merge_code_blocks setting for markly-merge
-    # @return [Boolean]
-    DEFAULT_INNER_MERGE_CODE_BLOCKS = true
-
-    # Re-export shared classes from markdown-merge
-    # Re-export shared classes from markdown-merge
-    FileAligner = Markdown::Merge::FileAligner
-    ConflictResolver = Markdown::Merge::ConflictResolver
-    MergeResult = Markdown::Merge::MergeResult
-    TableMatchAlgorithm = Markdown::Merge::TableMatchAlgorithm
-    TableMatchRefiner = Markdown::Merge::TableMatchRefiner
-    CodeBlockMerger = Markdown::Merge::CodeBlockMerger
-    NodeTypeNormalizer = Markdown::Merge::NodeTypeNormalizer
-
-    autoload :DebugLogger, "markly/merge/debug_logger"
-    autoload :FreezeNode, "markly/merge/freeze_node"
-    autoload :FileAnalysis, "markly/merge/file_analysis"
-    autoload :SmartMerger, "markly/merge/smart_merger"
-    autoload :Backend, "markly/merge/backend"
-
-    # Eagerly load and register backend when this module is loaded
-    # This ensures the backend is available for tree_haver before any parsing happens
-    class << self
-      def ensure_backend_loaded!
-        Backend # Access constant to trigger autoload
-      end
+    def available_markdown_backends
+      [BACKEND_REFERENCE]
     end
-  end
-end
 
-# Ensure backend is loaded and registered
-Markly::Merge.ensure_backend_loaded!
-
-# Register with ast-merge's MergeGemRegistry for RSpec dependency tags
-# Only register if MergeGemRegistry is loaded (i.e., in test environment)
-if defined?(Ast::Merge::RSpec::MergeGemRegistry)
-  Ast::Merge::RSpec::MergeGemRegistry.register(
-    :markly_merge,
-    require_path: "markly/merge",
-    merger_class: "Markly::Merge::SmartMerger",
-    test_source: "# Test\n\nParagraph",
-    category: :markdown,
-  )
-end
+    def markdown_backend_feature_profile(backend: nil)
+      requested = backend.to_s.empty? ? BACKEND_REFERENCE.id : backend.to_s
+      return unsupported_feature_result("Unsupported Markdown backend #{requested}.") unless requested == BACKEND_REFERENCE.id
+
+      markdown_feature_profile.merge(backend: BACKEND_REFERENCE.id, backend_ref: BACKEND_REFERENCE.to_h)
+    end
+
+    def markdown_plan_context(backend: nil)
+      profile = markdown_backend_feature_profile(backend: backend)
+      return profile if profile[:ok] == false
+
+      {
+        family_profile: markdown_feature_profile,
+        feature_profile: {
+          backend: profile[:backend],
+          supports_dialects: true,
+          supported_policies: []
+        }
+      }
+    end
+
+    def markdown_structured_edit_provider_profile
+      {
+        package: PACKAGE_NAME,
+        backend: BACKEND_REFERENCE.id,
+        structured_edit_profile: {
+          family: "markdown",
+          structure_profile: Ast::Merge.structured_edit_structure_profile(
+            owner_scope: "heading_sections",
+            owner_selector: "heading_sections",
+            owner_selector_family: "section_branch",
+            known_owner_selector: true,
+            supported_comment_regions: [],
+            metadata: { family: "markdown", provider: BACKEND_REFERENCE.id, source: "legacy_crispr_reference" }
+          ),
+          selection_profile: Ast::Merge.structured_edit_selection_profile(
+            owner_scope: "heading_sections",
+            owner_selector: "heading_sections",
+            owner_selector_family: "section_branch",
+            selector_kind: "heading_section",
+            selection_intent: "section_branch",
+            selection_intent_family: "section_branch",
+            known_selection_intent: true,
+            comment_region: nil,
+            include_trailing_gap: false,
+            comment_anchored: false,
+            metadata: { family: "markdown", provider: BACKEND_REFERENCE.id, source: "legacy_crispr_reference" }
+          ),
+          match_profile: Ast::Merge.structured_edit_match_profile(
+            start_boundary: "owner_start",
+            start_boundary_family: "structural_owner",
+            known_start_boundary: true,
+            end_boundary: "owner_end",
+            end_boundary_family: "structural_owner",
+            known_end_boundary: true,
+            payload_kind: "section_branch",
+            payload_family: "section_branch",
+            known_payload_kind: true,
+            comment_anchored: false,
+            trailing_gap_extended: false,
+            metadata: { family: "markdown", provider: BACKEND_REFERENCE.id, source: "legacy_crispr_reference" }
+          )
+        }
+      }
+    end
+
+    def markdown_structured_edit_request_projection
+      {
+        package: PACKAGE_NAME,
+        backend: BACKEND_REFERENCE.id,
+        structured_edit_request: Ast::Merge.structured_edit_request(
+          operation_kind: "replace",
+          content: "# Title\n\n## Synopsis\n\nOld synopsis.\n\n## Install\n\nInstall text.\n",
+          source_label: "README.md",
+          target_selector: "Synopsis@2",
+          target_selector_family: "section_branch",
+          target_selection: Ast::Merge.structured_edit_target_selection(
+            selector_kind: "heading_section",
+            selection_intent: "section_branch",
+            selection_intent_family: "section_branch",
+            known_selection_intent: true,
+            comment_region: nil,
+            include_trailing_gap: false,
+            comment_anchored: false,
+            metadata: { family: "markdown", provider: BACKEND_REFERENCE.id, source: "legacy_crispr_reference" }
+          ),
+          target_match: Ast::Merge.structured_edit_target_match(
+            start_boundary: "owner_start",
+            start_boundary_family: "structural_owner",
+            known_start_boundary: true,
+            end_boundary: "owner_end",
+            end_boundary_family: "structural_owner",
+            known_end_boundary: true,
+            payload_kind: "section_branch",
+            payload_family: "section_branch",
+            known_payload_kind: true,
+            comment_anchored: false,
+            trailing_gap_extended: false,
+            metadata: { family: "markdown", provider: BACKEND_REFERENCE.id, source: "legacy_crispr_reference" }
+          ),
+          payload_text: "## Synopsis\n\nNew synopsis.\n",
+          metadata: { family: "markdown", provider: BACKEND_REFERENCE.id, source: "legacy_crispr_reference" }
+        )
+      }
+    end
+
+    def markdown_structured_edit_result_projection
+      {
+        package: PACKAGE_NAME,
+        backend: BACKEND_REFERENCE.id,
+        structured_edit_result: Ast::Merge.structured_edit_result(
+          operation_kind: "replace",
+          updated_content: "# Title\n\n## Synopsis\n\nNew synopsis.\n\n## Install\n\nInstall text.\n",
+          changed: true,
+          captured_text: "## Synopsis\n\nOld synopsis.\n",
+          match_count: 1,
+          operation_profile: Ast::Merge.structured_edit_operation_profile(
+            operation_kind: "replace",
+            operation_family: "rewrite",
+            known_operation_kind: true,
+            source_requirement: "required",
+            destination_requirement: "none",
+            replacement_source: "explicit_text",
+            captures_source_text: true,
+            supports_if_missing: false,
+            metadata: { source: "legacy_crispr_reference" }
+          ),
+          metadata: { family: "markdown", provider: BACKEND_REFERENCE.id, source: "legacy_crispr_reference" }
+        )
+      }
+    end
+
+    def markdown_structured_edit_application_projection
+      {
+        package: PACKAGE_NAME,
+        backend: BACKEND_REFERENCE.id,
+        structured_edit_application: Ast::Merge.structured_edit_application(
+          request: markdown_structured_edit_request_projection[:structured_edit_request],
+          result: markdown_structured_edit_result_projection[:structured_edit_result],
+          metadata: { family: "markdown", provider: BACKEND_REFERENCE.id, source: "legacy_crispr_reference" }
+        )
+      }
+    end
+
+    def markdown_structured_edit_execution_report_projection
+      {
+        package: PACKAGE_NAME,
+        backend: BACKEND_REFERENCE.id,
+        structured_edit_execution_report: Ast::Merge.structured_edit_execution_report(
+          application: markdown_structured_edit_application_projection[:structured_edit_application],
+          provider_family: "markdown",
+          provider_backend: BACKEND_REFERENCE.id,
+          diagnostics: [],
+          metadata: { source: "legacy_crispr_reference" }
+        )
+      }
+    end
+
+    def markdown_structured_edit_batch_request_projection
+      content = "# Title\n\n## Synopsis\n\nOld synopsis.\n\n## Usage\n\nExisting text.\n\n## Deprecated\n\nDeprecated text.\n"
+      {
+        package: PACKAGE_NAME,
+        backend: BACKEND_REFERENCE.id,
+        structured_edit_batch_request: Ast::Merge.structured_edit_batch_request(
+          requests: [
+            Ast::Merge.structured_edit_request(
+              operation_kind: "replace",
+              content: content,
+              source_label: "README.md",
+              target_selector: "Synopsis@2",
+              target_selector_family: "section_branch",
+              payload_text: "## Synopsis\n\nNew synopsis.\n",
+              metadata: { family: "markdown", provider: BACKEND_REFERENCE.id, source: "legacy_crispr_reference" }
+            ),
+            Ast::Merge.structured_edit_request(
+              operation_kind: "insert",
+              content: content,
+              source_label: "source",
+              destination_selector: "/heading/usage",
+              destination_selector_family: "section_branch",
+              payload_text: "### Managed Usage\n\nInserted usage text.\n",
+              if_missing: "append",
+              metadata: { family: "markdown", provider: BACKEND_REFERENCE.id, source: "legacy_crispr_reference" }
+            ),
+            Ast::Merge.structured_edit_request(
+              operation_kind: "delete",
+              content: content,
+              source_label: "README.md",
+              target_selector: "Deprecated@2",
+              target_selector_family: "section_branch",
+              metadata: { family: "markdown", provider: BACKEND_REFERENCE.id, source: "legacy_crispr_reference" }
+            )
+          ],
+          metadata: { batch_label: "markdown_markly_triad", source: "legacy_crispr_reference" }
+        )
+      }
+    end
+
+    def markdown_structured_edit_batch_report_projection
+      content = "# Title\n\n## Synopsis\n\nOld synopsis.\n\n## Usage\n\nExisting text.\n\n## Deprecated\n\nDeprecated text.\n"
+      {
+        package: PACKAGE_NAME,
+        backend: BACKEND_REFERENCE.id,
+        structured_edit_batch_report: Ast::Merge.structured_edit_batch_report(
+          reports: [
+            Ast::Merge.structured_edit_execution_report(
+              application: Ast::Merge.structured_edit_application(
+                request: Ast::Merge.structured_edit_request(
+                  operation_kind: "replace",
+                  content: content,
+                  source_label: "README.md",
+                  target_selector: "Synopsis@2",
+                  target_selector_family: "section_branch",
+                  payload_text: "## Synopsis\n\nNew synopsis.\n",
+                  metadata: { family: "markdown", provider: BACKEND_REFERENCE.id, source: "legacy_crispr_reference" }
+                ),
+                result: Ast::Merge.structured_edit_result(
+                  operation_kind: "replace",
+                  updated_content: "# Title\n\n## Synopsis\n\nNew synopsis.\n\n## Usage\n\nExisting text.\n\n## Deprecated\n\nDeprecated text.\n",
+                  changed: true,
+                  captured_text: "## Synopsis\n\nOld synopsis.\n",
+                  match_count: 1,
+                  operation_profile: Ast::Merge.structured_edit_operation_profile(
+                    operation_kind: "replace",
+                    operation_family: "rewrite",
+                    known_operation_kind: true,
+                    source_requirement: "required",
+                    destination_requirement: "none",
+                    replacement_source: "explicit_text",
+                    captures_source_text: true,
+                    supports_if_missing: false,
+                    metadata: { source: "legacy_crispr_reference" }
+                  ),
+                  metadata: { family: "markdown", provider: BACKEND_REFERENCE.id, source: "legacy_crispr_reference" }
+                ),
+                metadata: { family: "markdown", provider: BACKEND_REFERENCE.id, source: "legacy_crispr_reference" }
+              ),
+              provider_family: "markdown",
+              provider_backend: BACKEND_REFERENCE.id,
+              diagnostics: [],
+              metadata: { source: "legacy_crispr_reference" }
+            ),
+            Ast::Merge.structured_edit_execution_report(
+              application: Ast::Merge.structured_edit_application(
+                request: Ast::Merge.structured_edit_request(
+                  operation_kind: "insert",
+                  content: content,
+                  source_label: "source",
+                  destination_selector: "/heading/usage",
+                  destination_selector_family: "section_branch",
+                  payload_text: "### Managed Usage\n\nInserted usage text.\n",
+                  if_missing: "append",
+                  metadata: { family: "markdown", provider: BACKEND_REFERENCE.id, source: "legacy_crispr_reference" }
+                ),
+                result: Ast::Merge.structured_edit_result(
+                  operation_kind: "insert",
+                  updated_content: "# Title\n\n## Synopsis\n\nOld synopsis.\n\n## Usage\n\nExisting text.\n### Managed Usage\n\nInserted usage text.\n\n## Deprecated\n\nDeprecated text.\n",
+                  changed: true,
+                  operation_profile: Ast::Merge.structured_edit_operation_profile(
+                    operation_kind: "insert",
+                    operation_family: "insertion",
+                    known_operation_kind: true,
+                    source_requirement: "none",
+                    destination_requirement: "optional",
+                    replacement_source: "explicit_text",
+                    captures_source_text: false,
+                    supports_if_missing: true,
+                    metadata: { source: "legacy_crispr_reference" }
+                  ),
+                  destination_profile: Ast::Merge.structured_edit_destination_profile(
+                    resolution_kind: "append_fallback",
+                    resolution_source: "none",
+                    anchor_boundary: "none",
+                    resolution_family: "append",
+                    resolution_source_family: "implicit",
+                    anchor_boundary_family: "none",
+                    known_resolution_kind: true,
+                    known_resolution_source: true,
+                    known_anchor_boundary: true,
+                    used_if_missing: true,
+                    metadata: { family: "shared", source: "legacy_crispr_reference" }
+                  ),
+                  metadata: { family: "markdown", provider: BACKEND_REFERENCE.id, source: "legacy_crispr_reference" }
+                ),
+                metadata: { family: "markdown", provider: BACKEND_REFERENCE.id, source: "legacy_crispr_reference" }
+              ),
+              provider_family: "markdown",
+              provider_backend: BACKEND_REFERENCE.id,
+              diagnostics: [],
+              metadata: { source: "legacy_crispr_reference" }
+            ),
+            Ast::Merge.structured_edit_execution_report(
+              application: Ast::Merge.structured_edit_application(
+                request: Ast::Merge.structured_edit_request(
+                  operation_kind: "delete",
+                  content: content,
+                  source_label: "README.md",
+                  target_selector: "Deprecated@2",
+                  target_selector_family: "section_branch",
+                  metadata: { family: "markdown", provider: BACKEND_REFERENCE.id, source: "legacy_crispr_reference" }
+                ),
+                result: Ast::Merge.structured_edit_result(
+                  operation_kind: "delete",
+                  updated_content: "# Title\n\n## Synopsis\n\nOld synopsis.\n\n## Usage\n\nExisting text.\n",
+                  changed: true,
+                  captured_text: "## Deprecated\n\nDeprecated text.\n",
+                  match_count: 1,
+                  operation_profile: Ast::Merge.structured_edit_operation_profile(
+                    operation_kind: "delete",
+                    operation_family: "removal",
+                    known_operation_kind: true,
+                    source_requirement: "required",
+                    destination_requirement: "none",
+                    replacement_source: "none",
+                    captures_source_text: true,
+                    supports_if_missing: false,
+                    metadata: { source: "legacy_crispr_reference" }
+                  ),
+                  metadata: { family: "markdown", provider: BACKEND_REFERENCE.id, source: "legacy_crispr_reference" }
+                ),
+                metadata: { family: "markdown", provider: BACKEND_REFERENCE.id, source: "legacy_crispr_reference" }
+              ),
+              provider_family: "markdown",
+              provider_backend: BACKEND_REFERENCE.id,
+              diagnostics: [],
+              metadata: { source: "legacy_crispr_reference" }
+            )
+          ],
+          diagnostics: [
+            {
+              severity: "info",
+              category: "assumed_default",
+              message: "markdown batch preserved request ordering."
+            }
+          ],
+          metadata: { batch_label: "markdown_markly_triad", source: "legacy_crispr_reference" }
+        )
+      }
+    end
+
+    def parse_markdown(source, dialect, backend: nil)
+      requested = backend.to_s.empty? ? BACKEND_REFERENCE.id : backend.to_s
+      return unsupported_feature_result("Unsupported Markdown backend #{requested}.") unless requested == BACKEND_REFERENCE.id
 
-Markly::Merge::Version.class_eval do
-  extend VersionGem::Basic
+      ::Markly.parse(source, flags: ::Markly::DEFAULT, extensions: [:table])
+      normalized = Markdown::Merge.normalize_source(source)
+      {
+        ok: true,
+        diagnostics: [],
+        analysis: {
+          kind: "markdown",
+          dialect: dialect,
+          normalized_source: normalized,
+          root_kind: "document",
+          owners: Markdown::Merge.collect_markdown_owners(normalized)
+        },
+        policies: []
+      }
+    rescue StandardError => e
+      {
+        ok: false,
+        diagnostics: [{ severity: "error", category: "parse_error", message: e.message }],
+        policies: []
+      }
+    end
+
+    def match_markdown_owners(template, destination)
+      Markdown::Merge.match_markdown_owners(template, destination)
+    end
+
+    def merge_markdown(template_source, destination_source, dialect, backend: nil)
+      requested = backend.to_s.empty? ? BACKEND_REFERENCE.id : backend.to_s
+      return unsupported_feature_result("Unsupported Markdown backend #{requested}.") unless requested == BACKEND_REFERENCE.id
+
+      Markdown::Merge.merge_markdown(template_source, destination_source, dialect)
+    end
+
+    def merge_markdown_with_reviewed_nested_outputs(template_source, destination_source, dialect, review_state, applied_children, backend: nil)
+      requested = backend.to_s.empty? ? BACKEND_REFERENCE.id : backend.to_s
+      return unsupported_feature_result("Unsupported Markdown backend #{requested}.") unless requested == BACKEND_REFERENCE.id
+
+      Markdown::Merge.merge_markdown_with_reviewed_nested_outputs(
+        template_source,
+        destination_source,
+        dialect,
+        review_state,
+        applied_children
+      )
+    end
+
+    def merge_markdown_with_reviewed_nested_outputs_from_replay_bundle(template_source, destination_source, dialect, replay_bundle, backend: nil)
+      requested = backend.to_s.empty? ? BACKEND_REFERENCE.id : backend.to_s
+      return unsupported_feature_result("Unsupported Markdown backend #{requested}.") unless requested == BACKEND_REFERENCE.id
+
+      Markdown::Merge.merge_markdown_with_reviewed_nested_outputs_from_replay_bundle(
+        template_source,
+        destination_source,
+        dialect,
+        replay_bundle
+      )
+    end
+
+    def merge_markdown_with_reviewed_nested_outputs_from_replay_bundle_envelope(template_source, destination_source, dialect, envelope, backend: nil)
+      requested = backend.to_s.empty? ? BACKEND_REFERENCE.id : backend.to_s
+      return unsupported_feature_result("Unsupported Markdown backend #{requested}.") unless requested == BACKEND_REFERENCE.id
+
+      Markdown::Merge.merge_markdown_with_reviewed_nested_outputs_from_replay_bundle_envelope(
+        template_source,
+        destination_source,
+        dialect,
+        envelope
+      )
+    end
+
+    def merge_markdown_with_reviewed_nested_outputs_from_review_state(template_source, destination_source, dialect, review_state, backend: nil)
+      requested = backend.to_s.empty? ? BACKEND_REFERENCE.id : backend.to_s
+      return unsupported_feature_result("Unsupported Markdown backend #{requested}.") unless requested == BACKEND_REFERENCE.id
+
+      Markdown::Merge.merge_markdown_with_reviewed_nested_outputs_from_review_state(
+        template_source,
+        destination_source,
+        dialect,
+        review_state
+      )
+    end
+
+    def merge_markdown_with_reviewed_nested_outputs_from_review_state_envelope(template_source, destination_source, dialect, envelope, backend: nil)
+      requested = backend.to_s.empty? ? BACKEND_REFERENCE.id : backend.to_s
+      return unsupported_feature_result("Unsupported Markdown backend #{requested}.") unless requested == BACKEND_REFERENCE.id
+
+      Markdown::Merge.merge_markdown_with_reviewed_nested_outputs_from_review_state_envelope(
+        template_source,
+        destination_source,
+        dialect,
+        envelope
+      )
+    end
+
+    def markdown_embedded_families(analysis)
+      Markdown::Merge.markdown_embedded_families(analysis)
+    end
+
+    def unsupported_feature_result(message)
+      {
+        ok: false,
+        diagnostics: [{ severity: "error", category: "unsupported_feature", message: message }],
+        policies: []
+      }
+    end
+
+    module_function(
+      :markdown_feature_profile,
+      :available_markdown_backends,
+      :markdown_backend_feature_profile,
+      :markdown_plan_context,
+      :markdown_structured_edit_provider_profile,
+      :markdown_structured_edit_request_projection,
+      :markdown_structured_edit_result_projection,
+      :markdown_structured_edit_application_projection,
+      :markdown_structured_edit_execution_report_projection,
+      :markdown_structured_edit_batch_request_projection,
+      :markdown_structured_edit_batch_report_projection,
+      :parse_markdown,
+      :match_markdown_owners,
+      :merge_markdown,
+      :merge_markdown_with_reviewed_nested_outputs,
+      :merge_markdown_with_reviewed_nested_outputs_from_replay_bundle,
+      :merge_markdown_with_reviewed_nested_outputs_from_replay_bundle_envelope,
+      :merge_markdown_with_reviewed_nested_outputs_from_review_state,
+      :merge_markdown_with_reviewed_nested_outputs_from_review_state_envelope,
+      :markdown_embedded_families,
+      :unsupported_feature_result
+    )
+  end
 end

data/lib/markly-merge.rb

@@ -1,6 +1,3 @@
 # frozen_string_literal: true
 
-# For technical reasons, if we move to Zeitwerk, this cannot be require_relative.
-#   See: https://github.com/fxn/zeitwerk#for_gem_extension
-# Hook for other libraries to load this library (e.g. via bundler)
-require "markly/merge"
+require_relative "markly/merge"