releasehx 0.1.1 → 0.2.0

data/lib/releasehx/mcp/assets/config-reference.json

@@ -129,7 +129,8 @@
         "note": {
           "path": "conversions.note",
           "desc": "The source of the release notes content.\nMust be `issue_body`, `custom_field`, or `commit_message`.\n\nDefaults to `issue_body` for GitHub and GitLab, but to `custom_field` for Jira.\n",
-          "type": "String"
+          "type": "String",
+          "default": "issue_body"
         },
         "note_custom_field": {
           "path": "conversions.note_custom_field",
@@ -140,7 +141,7 @@
           "path": "conversions.note_pattern",
           "desc": "The Regular Expressions pattern to match in the body of an issue or commit message, after which all content is considered the release `note` matter.\n\nDefaults to a Markdown or AsciiDoc header or HTML comment with the case-insensitive string `release note` in it.\n\nUses Capture group `note` in the Regular Expression to establish the entire note content.\n\nSee the `conversions.head_pattern` property for details on extracting a heading (`head` in RHYML) from the `note` content.\n",
           "type": "RegExp",
-          "default": "/^((#|=)+ (Draft )?Release Note.*)|(<!-- (draft )?release note -->)\\n(?<note>\\w(.|\\n)+)/gmi"
+          "default": "/^(((#|=)+ (Draft )?Release Note.*?)|(<!-- (draft )?release note -->))\\n+(?<note>(.| )+)/gmi"
         },
         "head_pattern": {
           "path": "conversions.head_pattern",
@@ -154,10 +155,23 @@
           "type": "String",
           "default": "markdown"
         },
-        "engine": {
-          "path": "conversions.engine",
-          "desc": "The markup converter to use for the issues.\nDefaults to `asciidoctor` for AsciiDoc and `redcarpet` for Markdown.\nOptions include `asciidoctor`, `redcarpet`, `commonmarker`, `kramdown`, or `pandoc`.\n",
-          "type": "String"
+        "engines": {
+          "path": "conversions.engines",
+          "desc": "Specifies the conversion engines to use when enriching to various output formats.\n\nThese settings determine which tool processes the conversion from draft formats to rich output.\nIntelligent defaults are applied based on source format when engines are not explicitly configured.\n",
+          "properties": {
+            "html": {
+              "path": "conversions.engines.html",
+              "desc": "Engine for converting to HTML format.\n\nValid engines:\n\n[horizontal]\n`asciidoctor-html5`:: Standard Asciidoctor HTML5 backend (nested div structure)\n`asciidoctor-html5s`:: Semantic HTML5 backend (cleaner section-based markup)\n`kramdown`:: Kramdown Markdown converter (for Markdown sources)\n`pandoc`:: Universal document converter (if available)\n\nWhen not specified, intelligent defaults apply:\n\n- AsciiDoc → HTML: `asciidoctor-html5s` (semantic HTML5)\n- Markdown → HTML: `kramdown`\n- RHYML → HTML: Liquid templates (no engine needed)\n",
+              "docs": "The html5s backend produces cleaner, more semantic HTML with `<section>` elements\ninstead of nested `<div class=\"sect1\"><div class=\"sectionbody\">` structures.\n\nThis is particularly useful when you want to apply custom CSS or when generating\nHTML that will be further processed or embedded in other systems.\n\nFor backwards compatibility or when you need the traditional Asciidoctor structure,\nuse `asciidoctor-html5`.\n",
+              "type": "String"
+            },
+            "pdf": {
+              "path": "conversions.engines.pdf",
+              "desc": "Engine for converting to PDF format.\n\nValid engines:\n\n[horizontal]\n`asciidoctor-pdf`:: Asciidoctor PDF converter (default for AsciiDoc)\n`asciidoctor-web-pdf`:: Web-based PDF converter using headless Chrome\n`pandoc`:: Universal document converter (if available)\n\nWhen not specified, intelligent defaults apply:\n\n- AsciiDoc → PDF: `asciidoctor-pdf`\n- Markdown → PDF: `pandoc` (if available)\n",
+              "docs": "The default `asciidoctor-pdf` engine provides excellent typography and layout\nfor technical documentation with support for themes, fonts, and advanced formatting.\n",
+              "type": "String"
+            }
+          }
         }
       }
     },
@@ -995,8 +1009,8 @@
       "path": "modes",
       "desc": "Default settings for `rhx` command executions.\n",
       "properties": {
-        "wrapped": {
-          "path": "modes.wrapped",
+        "html_wrap": {
+          "path": "modes.html_wrap",
           "desc": "Include (or exclude) head, header, and footer elements when enriching to HTML.\n",
           "type": "Boolean",
           "default": false
@@ -1016,7 +1030,8 @@
         "asciidoc_frontmatter": {
           "path": "modes.asciidoc_frontmatter",
           "desc": "Include frontmatter in AsciiDoc drafts.\n\nUses the `templates.asciidoc_frontmatter` template.\n",
-          "type": "Boolean"
+          "type": "Boolean",
+          "default": false
         },
         "fetch": {
           "path": "modes.fetch",
@@ -1125,6 +1140,41 @@
           "type": "Liquid",
           "default": "---\ntitle: Release History for {{ release.code }}\nversion: {{ release.code }}\ndate: {{ release.date }}\n---\n"
         },
+        "html_framework": {
+          "path": "history.html_framework",
+          "desc": "The HTML framework to use when enriching to HTML.\n\nValid entries:\n\n[horizontal]\n`bare`:: minimal HTML structure\n`bootstrap4`:: Bootstrap 4 framework\n`bootstrap5`:: Bootstrap 5 framework\n",
+          "type": "String",
+          "default": "bare"
+        },
+        "styling": {
+          "path": "history.styling",
+          "desc": "Configuration options for HTML styling and CSS framework integration.\n",
+          "properties": {
+            "mode": {
+              "path": "history.styling.mode",
+              "desc": "The HTML styling approach to use when generating wrapped HTML output.\n\nValid options:\n\n* `minimal` -- Basic semantic HTML with minimal inline styles\n* `embedded` -- Include comprehensive CSS in `<style>` block \n* `external` -- Reference external stylesheet via `<link>` tag\n* `framework` -- Use configured CSS framework only (Bootstrap, etc.)\n\nWhen `mode: framework`, styling relies entirely on the configured CSS framework.\nWhen `mode: embedded`, CSS is included inline for standalone HTML files.\nWhen `mode: external`, a custom CSS file must be provided via `css_url`.\n",
+              "type": "String",
+              "default": "framework"
+            },
+            "theme": {
+              "path": "history.styling.theme",
+              "desc": "The visual theme variant to apply to HTML output.\n\nBuilt-in themes:\n\n* `default` -- Standard professional appearance\n* `compact` -- Reduced spacing and condensed layout\n* `detailed` -- Enhanced metadata display with expanded information\n\nTheme selection affects spacing, typography, and metadata prominence.\n",
+              "type": "String",
+              "default": "default"
+            },
+            "embed_css": {
+              "path": "history.styling.embed_css",
+              "desc": "Include comprehensive CSS directly in the HTML `<style>` block.\n\nWhen enabled, generates standalone HTML files that display correctly\nwithout external dependencies. CSS includes framework customizations,\nresponsive design rules, and print optimizations.\n\nAutomatically enabled when `mode: embedded`.\n",
+              "type": "Boolean",
+              "default": false
+            },
+            "css_url": {
+              "path": "history.styling.css_url",
+              "desc": "URL or path to external CSS stylesheet for custom styling.\n\nWhen `mode: external`, this stylesheet is linked via `<link rel=\"stylesheet\">`.\nCan be a relative path, absolute URL, or CDN link.\n\nExample: `assets/custom-releasehx.css` or `https://example.com/styles.css`\n\nWhen provided, framework CSS and embedded CSS are disabled.\n",
+              "type": "String"
+            }
+          }
+        },
         "items": {
           "path": "history.items",
           "desc": "Settings pertaining to displayed items across Changelog and Release Notes sections.\n\nMost of these settings can be defined separately for each section under <<conf_ppty_changelog_items>> and <<conf_ppty_notes_items>>.\nIf an identically named setting exists, it will override the primary designator defined in this `config.history.items` block.\n",
@@ -1228,7 +1278,7 @@
               "path": "history.labeling.part_label",
               "desc": "The label to use for the _singular_ part/component affected by the change, when only one part is permitted.\n\nThis value will apply either when <<conf_ppty_rhyml_max_parts>> is set to `1` or when the change has only one part _and_ <<conf_ppty_history_labeling_singularize_labels>> is `true`.\n",
               "type": "String",
-              "default": "Part"
+              "default": "Component"
             },
             "parts_icon": {
               "path": "history.labeling.parts_icon",

data/lib/releasehx/mcp/assets/sample-config.yml

@@ -22,10 +22,12 @@ origin: # The API or file source for the issues.
 conversions: # Details about content origination, as well as markup sources and conversion.
   summ: issue # The source of the summary (Changelog) content.
 #   head:  # The source of release-note headlines, when it is not the same as the summary.
-#   note:  # The source of the release notes content.
+  note: issue_body # The source of the release notes content.
 #   note_custom_field:  # The name of the custom field to use for the release notes content.Liquid error: wrong number of arguments (given 3, expected 1..2)Liquid error: wrong number of arguments (given 3, expected 1..2)
   markup: markdown # The origin markup format for notes.
-#   engine:  # The markup converter to use for the issues.
+  engines: # Specifies the conversion engines to use when enriching to various output formats.
+#     html:  # Engine for converting to HTML format.
+#     pdf:  # Engine for converting to PDF format.
 extensions: # Default file extensions.
   markdown: md # File extension for Markdown drafts.
   asciidoc: adoc # File extension for AsciiDoc drafts.
@@ -72,7 +74,7 @@ tags: # Handling for tags, labels, or toggles associated with source Issues.
     - breaking
     - experimental
     - changelog
-  _exclude: # The list of tags that cause a change/issue to be excluded from the release history.
+  _exclude: [] # The list of tags that cause a change/issue to be excluded from the release history.
   highlight: # The tag, label, or toggle that indicates an issue is to be highlighted or prioritized in sorts.
     head: Highlights # How this tag will display as a grouping title.
     text: highlight # How this tag will display as a label.
@@ -163,10 +165,10 @@ paths: # The configuration for the paths to include in the release history listi
   mappings_dir: _mappings # The path to the directory containing user-defined API mappings.
   api_clients_dir: _apis # The path to the directory containing user-defined API client definitions.
 modes: # Default settings for rhx command executions.
-  wrapped: false # Include (or exclude) head, header, and footer elements when enriching to HTML.
+  html_wrap: false # Include (or exclude) head, header, and footer elements when enriching to HTML.
   html_frontmatter: true # Include frontmatter in the rendered HTML.
   markdown_frontmatter: false # Include frontmatter in Markdown drafts.
-#   asciidoc_frontmatter:  # Include frontmatter in AsciiDoc drafts.
+  asciidoc_frontmatter: false # Include frontmatter in AsciiDoc drafts.
   fetch: notes-only # What to fetch when gathering issues from API.
   remove_excess_lines: 1 # Reduces N+ consecutive blank lines to N lines.
 rhyml: # Settings related to RHYML data objects and documents.
@@ -178,6 +180,12 @@ rhyml: # Settings related to RHYML data objects and documents.
   pasterize_head: false # Whether to convert verbs in the head property to past tense when drafting.
 history: # Configurations for the overall document, when applicable.Liquid error: wrong number of arguments (given 3, expected 1..2)
   htag: h1 # The heading level (H1, H2, etc) for the release history header.Liquid error: wrong number of arguments (given 3, expected 1..2)Liquid error: wrong number of arguments (given 3, expected 1..2)Liquid error: wrong number of arguments (given 3, expected 1..2)
+  html_framework: bare # The HTML framework to use when enriching to HTML.
+  styling: # Configuration options for HTML styling and CSS framework integration.
+    mode: framework # The HTML styling approach to use when generating wrapped HTML output.
+    theme: default # The visual theme variant to apply to HTML output.
+    embed_css: false # Include comprehensive CSS directly in the HTML <style> block.
+#     css_url:  # URL or path to external CSS stylesheet for custom styling.
   items: # Settings pertaining to displayed items across Changelog and Release Notes sections.
     allow_redundant: false # Whether to allow duplicate entries in a given section, for instance across groups for part:group sorts where a change affects...
     show_issue_links: false # Whether to include web links in item metadata.
@@ -195,7 +203,7 @@ history: # Configurations for the overall document, when applicable.Liquid error
     type_label: type # The label to use for the type of change.
 #     type_icon:  # The icon to use for the type of change.
     parts_label: Components # The label to use for the part/component affected by the change.
-    part_label: Part # The label to use for the singular part/component affected by the change, when only one part is permitted.
+    part_label: Component # The label to use for the singular part/component affected by the change, when only one part is permitted.
     parts_icon: puzzle-piece # The icon to use for the part/component affected by the change.
     tags_label: # The tags associated with the change, if any.
       - Tags
@@ -210,8 +218,7 @@ changelog: # The configuration for the changelog output.
   head: Changelog # The header for the changelog output.Liquid error: wrong number of arguments (given 3, expected 1..2)
   htag: h2 # The heading level (H1, H2, etc) for the changelog section header.
   spot: 2 # Where in the document to place the changelog (1 = top, 2 = bottom).
-  sort: # The sort order for the changelog output.
-    - part:grouping1
+  sort: [part:grouping1] # The sort order for the changelog output.
   items: # Settings that affect the frame/shape and arrangement of individual changelog entries.
     frame: unordered # The layout for the changelog entry display.
     allow_redundant: false # Whether to allow duplicate entries in a given section, for instance across groups for part:group sorts where a change affects...
@@ -248,4 +255,4 @@ notes: # The configuration for the Release Notes listing section.
     show_parts_label: false # Whether to show the parts label in the item metadata output.
     show_tags_label: false # Whether to show the tags label in the item metadata output.
     show_lead_label: false # Whether to show the lead label in the item metadata output.
-    show_auths_label: false # Whether to show the authors label in the item metadata output.
+    show_auths_label: false # Whether to show the authors label in the item metadata output.

data/lib/releasehx/mcp/server.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require 'json'
-require_relative '../../schemagraphy'
 require_relative '../../docopslab/mcp/server'
 require_relative 'manifest'
 require_relative 'resource_pack'

data/lib/releasehx/ops/enrich_ops.rb

@@ -34,7 +34,16 @@ module ReleaseHx
       when :html
         # Direct Liquid template rendering to HTML
         html_content = DraftOps.process_template_content(release: release, config: config, format: :html)
-        WriteOps.safe_write(outpath, html_content)
+
+        # Wrap HTML with Bootstrap styling if enabled
+        enriched = if config && config.dig('modes', 'html_wrap') != false
+                     ReleaseHx.logger.debug('Applying HTML wrapper')
+                     wrap_html(html_content, config)
+                   else
+                     html_content
+                   end
+
+        WriteOps.safe_write(outpath, enriched)
       when :pdf
         # Two-stage process: RHYML → AsciiDoc → PDF
         asciidoc_content = DraftOps.process_template_content(release: release, config: config, format: :adoc)
@@ -49,7 +58,7 @@ module ReleaseHx
     # Generates rich-text output from source draft files of various formats.
     #
     # Automatically detects the input file type and applies the appropriate conversion
-    #  strategy, supporting YAML (via RHYML), Markdown, and AsciiDoc source formats.
+    #  strategy, supporting YAML (via RHYML) and AsciiDoc source formats.
     #
     # @param file_path [String] The path to the source draft file.
     # @param format [Symbol] The target output format (:html or :pdf).
@@ -75,9 +84,6 @@ module ReleaseHx
         # RHYML/YAML files: load as Release object and use Liquid templates
         release = load_rhyml_from_yaml(file_path, config: config)
         enrich_from_rhyml(release: release, config: config, format: format, outpath: outpath, force: true)
-      when '.md'
-        # Markdown files: use native converter
-        convert_markdown(file_path, format: format, config: config, outpath: outpath, force: true)
       when '.adoc'
         # AsciiDoc files: use native converter
         convert_asciidoc(file_path, format: format, config: config, outpath: outpath, force: true)
@@ -86,70 +92,41 @@ module ReleaseHx
       end
     end
 
-    # Converts Markdown files to rich-text formats using native converters.
+    # Converts AsciiDoc content or files to rich-text formats using configured engines.
     #
-    # Uses Kramdown for HTML generation and Tilt with Pandoc for PDF conversion.
-    # Note: Some parameters are reserved for API consistency across conversion methods.
-    #
-    # @param file_path [String] The path to the source Markdown file.
-    # @param format [Symbol] The target output format (:html or :pdf).
-    # @param config [ReleaseHx::Configuration] Reserved for future use.
-    # @param outpath [String] The target output file path.
-    # @param force [Boolean] Reserved for future use.
-    # @return [String] The path to the generated output file.
-    # rubocop:disable Lint/UnusedMethodArgument
-    def self.convert_markdown file_path, format:, config:, outpath:, force:
-      # NOTE: config and force parameters are currently unused but kept for API consistency
-      content = File.read(file_path)
-
-      case format.to_sym
-      when :html
-        require 'kramdown'
-        enriched = Kramdown::Document.new(content).to_html
-        WriteOps.safe_write(outpath, enriched)
-      when :pdf
-        # Use Tilt with Pandoc for direct Markdown to PDF conversion
-        require 'tilt'
-        require 'tilt/pandoc'
-
-        template = Tilt::PandocTemplate.new(file_path)
-        enriched = template.render(nil, to: 'pdf')
-        WriteOps.safe_write(outpath, enriched)
-        ReleaseHx.logger.info("PDF generated via Tilt/Pandoc: #{outpath}")
-      else
-        raise "Unsupported format for Markdown: #{format}"
-      end
-
-      outpath
-    end
-    # rubocop:enable Lint/UnusedMethodArgument
-
-    # Converts AsciiDoc content or files to rich-text formats using Asciidoctor.
+    # Accepts either file paths or raw content strings as input. Selects appropriate
+    # converter engine based on config.conversions.engines.html/pdf settings with intelligent defaults:
+    # - AsciiDoc → HTML: asciidoctor-html5s (default)
+    # - AsciiDoc → PDF: asciidoctor-pdf (default)
     #
-    # Accepts either file paths or raw content strings as input. Uses Asciidoctor
-    # for HTML generation and Asciidoctor-PDF for direct PDF output.
+    # HTML output can be wrapped with Bootstrap CSS when config.modes.html_wrap is enabled.
     #
     # @param file_path_or_content [String] File path or raw AsciiDoc content.
     # @param format [Symbol] The target output format (:html or :pdf).
     # @param outpath [String] The target output file path.
-    # @param config [ReleaseHx::Configuration] Reserved for future use.
-    # @param force [Boolean] Reserved for future use.
+    # @param config [ReleaseHx::Configuration] Configuration for engines and wrapping options.
+    # @param force [Boolean] Whether to overwrite existing files.
     # @return [String] The path to the generated output file.
-    # rubocop:disable Lint/UnusedMethodArgument
     def self.convert_asciidoc file_path_or_content, format:, outpath:, config: nil, force: nil
-      # NOTE: config and force parameters are currently unused but kept for API consistency
       # Determine if input is file path or raw content
       is_file = file_path_or_content.is_a?(String) && File.exist?(file_path_or_content)
       content = is_file ? File.read(file_path_or_content) : file_path_or_content
 
       case format.to_sym
       when :html
-        require 'asciidoctor'
-        enriched = Asciidoctor.convert(content, safe: :safe, backend: 'html5')
+        engine = resolve_engine(format: :html, source_format: :asciidoc, config: config)
+        html_fragment = convert_with_engine(content, engine: engine, format: :html)
+
+        # Wrap HTML with Bootstrap styling if enabled
+        enriched = if config && config.dig('modes', 'html_wrap') != false
+                     ReleaseHx.logger.debug('Applying wrapper to AsciiDoc-derived HTML')
+                     wrap_html(html_fragment, config)
+                   else
+                     html_fragment
+                   end
       when :pdf
-        require 'asciidoctor'
-        require 'asciidoctor-pdf'
-        Asciidoctor.convert(content, to_file: outpath, safe: :safe, backend: 'pdf')
+        engine = resolve_engine(format: :pdf, source_format: :asciidoc, config: config)
+        convert_with_engine(content, engine: engine, format: :pdf, outpath: outpath)
         return outpath
       else
         raise "Unsupported format for AsciiDoc: #{format}"
@@ -163,7 +140,6 @@ module ReleaseHx
       WriteOps.safe_write(outpath, enriched)
       outpath
     end
-    # rubocop:enable Lint/UnusedMethodArgument
 
     # Loads RHYML data from a YAML file and creates a Release object.
     #
@@ -217,5 +193,135 @@ module ReleaseHx
       filename = SchemaGraphy::Templating.render_field_if_template(filename_template, context)
       File.join(output_dir, enrich_dir, filename.strip)
     end
+
+    # Wraps an HTML fragment with Bootstrap CSS and semantic HTML structure.
+    #
+    # Takes a raw HTML fragment and wraps it with proper DOCTYPE, head section with Bootstrap CDN link, and body tag.
+    # Uses the wrapper.html.liquid template for markup generation.
+    #
+    # @param html_fragment [String] The raw HTML content to wrap.
+    # @param config [ReleaseHx::Configuration] Configuration object for title and settings.
+    # @return [String] Complete HTML document with Bootstrap styling.
+    def self.wrap_html html_fragment, config
+      # Extract and parse framework setting
+      framework_spec = config.dig('history', 'html_framework') || 'bare'
+      framework_name, framework_version = parse_framework_spec(framework_spec)
+
+      template_path = WriteOps.resolve_template_path('wrapper.html.liquid', config)
+
+      template_vars = {
+        'config' => config,
+        'content' => html_fragment,
+        'framework' => framework_name,
+        'framework_version' => framework_version
+      }
+
+      WriteOps.process_template(template_path, template_vars, config)
+    end
+
+    # Parses framework specification string into name and version.
+    #
+    # @param spec [String] Framework specification like 'bootstrap5' or 'bootstrap:5.3.0'
+    # @return [Array<String, String>] Tuple of [framework_name, framework_version]
+    def self.parse_framework_spec spec
+      case spec.to_s
+      when /^(.+):(.+)$/
+        # Format: "bootstrap:5.3.0"
+        [::Regexp.last_match(1), ::Regexp.last_match(2)]
+      when 'bootstrap5'
+        ['bootstrap', '5.3.0']
+      when 'bootstrap4'
+        ['bootstrap', '4.6.2']
+      else
+        ['bare', nil]
+      end
+    end
+
+    # Resolves the appropriate conversion engine based on format and source.
+    #
+    # Applies intelligent defaults based on source format:
+    # - AsciiDoc → HTML: asciidoctor-html5s
+    # - AsciiDoc → PDF: asciidoctor-pdf
+    # - Markdown → HTML: kramdown
+    # - Markdown → PDF: pandoc
+    #
+    # @param format [Symbol] Output format (:html or :pdf)
+    # @param source_format [Symbol] Source format (:asciidoc or :markdown)
+    # @param config [Hash] Configuration hash
+    # @return [String] Engine name
+    def self.resolve_engine format:, source_format:, config: nil
+      # Check for explicit engine configuration
+      explicit_engine = config&.dig('conversions', 'engines', format.to_s)
+      return explicit_engine if explicit_engine
+
+      # Apply intelligent defaults based on source format
+      case [source_format, format]
+      when %i[asciidoc html]
+        'asciidoctor-html5s'
+      when %i[asciidoc pdf]
+        'asciidoctor-pdf'
+      when %i[markdown html]
+        'kramdown'
+      when %i[markdown pdf]
+        'pandoc'
+      else
+        raise "Unsupported conversion: #{source_format} → #{format}"
+      end
+    end
+
+    # Converts content using the specified engine.
+    #
+    # @param content [String] Source content to convert
+    # @param engine [String] Engine name (e.g., 'asciidoctor-html5s', 'asciidoctor-pdf')
+    # @param format [Symbol] Output format (:html or :pdf)
+    # @param outpath [String, nil] Output file path (required for PDF)
+    # @return [String] Converted content (for HTML) or output path (for PDF)
+    # rubocop:disable Lint/UnusedMethodArgument
+    def self.convert_with_engine content, engine:, format:, outpath: nil
+      case engine
+      when 'asciidoctor-html5', 'asciidoctor-html5s'
+        require 'asciidoctor'
+        backend = engine.split('-').last # 'html5' or 'html5s'
+
+        if backend == 'html5s'
+          begin
+            require 'asciidoctor-html5s'
+            ReleaseHx.logger.debug('Using asciidoctor-html5s backend for semantic HTML5')
+          rescue LoadError
+            ReleaseHx.logger.warn('asciidoctor-html5s not available, falling back to html5')
+            backend = 'html5'
+          end
+        end
+
+        Asciidoctor.convert(content, safe: :safe, backend: backend)
+
+      when 'asciidoctor-pdf'
+        require 'asciidoctor'
+        require 'asciidoctor-pdf'
+        ReleaseHx.logger.debug('Using asciidoctor-pdf for PDF generation')
+        Asciidoctor.convert(content, to_file: outpath, safe: :safe, backend: 'pdf')
+        outpath
+
+      when 'asciidoctor-web-pdf'
+        require 'asciidoctor'
+        require 'asciidoctor-web-pdf'
+        ReleaseHx.logger.debug('Using asciidoctor-web-pdf for PDF generation')
+        Asciidoctor.convert(content, to_file: outpath, safe: :safe, backend: 'web-pdf')
+        outpath
+
+      when 'kramdown'
+        require 'kramdown'
+        ReleaseHx.logger.debug('Using Kramdown for HTML conversion')
+        Kramdown::Document.new(content).to_html
+
+      when 'pandoc'
+        # Future implementation - would shell out to pandoc
+        raise 'Pandoc engine not yet implemented'
+
+      else
+        raise "Unsupported engine: #{engine}"
+      end
+    end
+    # rubocop:enable Lint/UnusedMethodArgument
   end
 end

data/lib/releasehx/ops/template_ops.rb

@@ -53,7 +53,7 @@ module ReleaseHx
           releasehx_debug: true
         })
 
-      raise "Template rendering failed:\n#{rendered}" if rendered.include?('Liquid error')
+      raise "Template rendering failed:\n#{rendered}" if rendered.match?(/Liquid error[:(]/)
 
       rendered
     end

data/lib/releasehx/rhyml/adapter.rb

@@ -6,9 +6,6 @@ require 'liquid'
 require 'erb'
 require 'yaml'
 require 'json'
-require_relative '../../schemagraphy'
-require_relative '../../schemagraphy/safe_expression'
-require_relative '../../sourcerer/jekyll'
 
 module ReleaseHx
   module RHYML
@@ -349,7 +346,7 @@ module ReleaseHx
         note_pattern = sources['note_pattern'] || templates['note_pattern']
         head_pattern = sources['head_pattern'] || templates['head_pattern']
         head_source = sources['head_source']
-        note_source = sources['note_source']
+        note_source = sources['note']
 
         extract_note!(data, note_source, note_pattern)
         extract_head!(data, head_source, head_pattern)
@@ -406,10 +403,10 @@ module ReleaseHx
         end
 
         # STEP 2: Apply regex pattern extraction if configured
-        return unless note_source =~ /issue_body/i && original_content.is_a?(String) && note_pattern.is_a?(String)
+        return unless note_source == 'issue_body' && original_content.is_a?(String) && note_pattern
 
         ReleaseHx.logger.debug "Extracting note using pattern: #{note_pattern}"
-        ReleaseHx.logger.debug "Original content: #{original_content}"
+        ReleaseHx.logger.debug "Original content: #{original_content[0..100]}..."
 
         begin
           # Apply sensible default flag 'm' (multiline/dotall in Ruby) when no flags provided
@@ -421,11 +418,18 @@ module ReleaseHx
             pattern_info,
             'note')
 
-          # Only update if we got a match
-          data['note'] = extracted_note.strip if extracted_note
+          if extracted_note
+            # Pattern matched - use extracted content
+            data['note'] = extracted_note.strip
+            ReleaseHx.logger.debug "Extracted note (#{extracted_note.length} chars)"
+          else
+            # Pattern didn't match - clear the note so empty_notes policy applies
+            ReleaseHx.logger.warn "Note pattern did not match for issue #{data['tick']} - no Release Note section found"
+            data['note'] = nil
+          end
         rescue RegexpError => e
           ReleaseHx.logger.warn "Invalid note_pattern '#{note_pattern}': #{e.message}"
-          data['note'] = original_content # Restore original on error
+          # Preserve original content on pattern error - don't lose data due to bad config
         end
       end
 

data/lib/releasehx/rhyml/mappings/github.yaml

@@ -25,7 +25,9 @@ note:
 
 # Extract type from the native GitHub Issues type field (modern approach)
 type:
-  path: "issue_type.name"
+  path: "type.name"
+  ruby: |
+    path&.downcase
 
 # Derive `parts` from labels using direct key matching or slug override
 parts:

data/lib/releasehx/rhyml/templates/bootstrap-overrides.css

@@ -0,0 +1,15 @@
+/* Bootstrap Overrides for ReleaseHx */
+/* Users can override this file by placing bootstrap-overrides.css in their _templates directory */
+
+/* Dark Mode Fixes */
+@media (prefers-color-scheme: dark) {
+  /* Fix .bg-light in card headers - use semantic card background instead */
+  .card-header.bg-light {
+    background-color: var(--bs-card-cap-bg) !important;
+    border-bottom: var(--bs-card-border-width) solid var(--bs-card-border-color);
+  }
+}
+
+.container-lg {
+  max-width: 900px;
+}

data/lib/releasehx/rhyml/templates/changelog.adoc.liquid

@@ -11,4 +11,6 @@
 {%- assign item_count = 0 %}
 {%- embed section-text.liquid %}
 
+[.changelog-section]
+
 {%- embed groupings.liquid %}

data/lib/releasehx/rhyml/templates/changelog.html.liquid

@@ -4,11 +4,13 @@
 {%- assign dflt_next_header_level = level | plus: 1 -%}
 {%- assign item_count = 0 %}
 
-<div class="changelog-section">
-    {%- include header.liquid format=format level=level text=content_config.head %}
+<section class="changelog-section py-4 px-3 mb-4 rounded">
+  {%- include header.liquid format=format level=level text=content_config.head %}
 
-    {%- embed section-text.liquid %}
+  {%- embed section-text.liquid %}
 
+  <div class="changelog-content mt-4">
     {%- embed groupings.liquid %}
-</div>
+  </div>
+</section>
 

data/lib/releasehx/rhyml/templates/changelog.md.liquid

@@ -1,3 +1,4 @@
+<!-- .changelog-section -->
 {%- assign content_config = config.changelog %}
 {%- assign section_type = "changelog" %}
 {%- embed config-cascade.liquid %}