releasehx 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 36a63bdf0f36ba445d5fa83993aa354dcf3ded8d562bec625ddaf07dd94b4967
-  data.tar.gz: c10c4bf04cbe1c7654f552b2c01ee8304db375d8eb4cade74cd5534e9d152b4e
+  metadata.gz: b1a5f031876899a54910d8cf53694c15fc56f7ded648e2f30e0da4321bac0489
+  data.tar.gz: f2d8c4c2e09bb013844aa1915456c1d30dd7e6499ab546c86ade44ba34fce037
 SHA512:
-  metadata.gz: ce79b848b9cd3cd72cf27b54aa6ab0351f3b1c921d5399ac0b9bceeaed7abcbf75ae0eff7a937edbc5d097bf4e2097ec221e96cba0ce379d4f79b03fbdc2787e
-  data.tar.gz: 35d211eedd404ff1b41f4f6884eb558a41ea91ebf98ecdf3ec76db668f567c845134cdb2882d37b9bf587f95dd11df0299214404723c2697e76ed18bade406ec
+  metadata.gz: 3041a79a2f37e0277710ff11f66b46e2afb82a9c54e667719fc8f8ecb17a5f9902d43123d6fdadddb9aae39323d1d6c38e89f2544058460ae542382c3c8c2a6e
+  data.tar.gz: ede775257fe7a1661dc8f37b2a7f5211cb99400c6926e662fcb8b4f83abee82d83cff74ad2ccdd423a5a4079e84d26925786589e4777b8561229a73c8a6f6b21

data/README.adoc

@@ -1,5 +1,6 @@
 :page-layout: default
-:page-permalink: /docs
+:page-permalink: /docs/
+:page-title: ReleaseHx Docs
 :page-nav_order: 1
 [[releasehx]]
 = ReleaseHx
@@ -15,7 +16,7 @@
 :this_prod_vrsn_major: 0
 :this_prod_vrsn_minor: 1
 :this_prod_vrsn_major-minor: {this_prod_vrsn_major}.{this_prod_vrsn_minor}
-:this_prod_vrsn_patch: 0
+:this_prod_vrsn_patch: 2
 :this_prod_vrsn: {this_prod_vrsn_major-minor}.{this_prod_vrsn_patch}
 :next_prod_vrsn: 0.2.0
 :tagline: Generate formatted release histories from Jira, GitHub, GitLab, YAML, or JSON sources.
@@ -2475,6 +2476,7 @@ Use `PORT=NNNN` environment argument to specify a different port.
 [.prompt]
  PORT=4000 bundle exec rake serve
 
+[[docopslab-devtool]]
 ==== DocOps Lab Devtool (`docopslab-dev`)
 
 Special dev Rake tasks and libraries are available via the `docopslab-dev` gem.

data/build/docs/_config.yml

@@ -4,12 +4,24 @@ baseurl: /
 
 plugins:
   - jekyll-asciidoc
+  - jekyll-redirect-from
+
+collections:
+  releases:
+    output: true
+    permalink: /docs/releases/:name/
 
 defaults:
   - scope:
-      path: "api"
+      path: "docs/api"
     values:
       render_with_liquid: false
+  - scope:
+      path: ""
+      type: "releases"
+    values:
+      layout: default
+      nav_exclude: true
 
 include:
   - index.adoc
@@ -17,6 +29,10 @@ include:
 
 exclude:
   - manpage.adoc
+  - jekyll/
+  - payloads/
+  - release/
+  - yard/
 
 # Enable Rouge for syntax highlighting in AsciiDoc blocks
 asciidoctor:

data/build/docs/_release_index.adoc

@@ -0,0 +1,9 @@
+== Available Releases
+
+Each release includes detailed notes about new features, improvements, bug fixes, and breaking changes.
+
+* link:../release/0.1.2.html[0.1.2] - 2026-01-29
+
+== Latest Release
+
+include::release/0.1.2.adoc[leveloffset=+1]

data/build/docs/config-reference.adoc

@@ -1,7 +1,4 @@
-:page-layout: default
-:page-permalink: /config-reference/
-:page-nav_order: 2
-:page-title: Configuration Reference
+
 
 [[conf_ppty_DOLLARSIGN_meta,config.$meta]]
 $meta::
@@ -359,6 +356,9 @@ Defaults to `issue_body` for GitHub and GitLab, but to `custom_field` for Jira.
 
 [horizontal]
 type;; String
+default;;
++
+`+++issue_body+++`
 path;; `xref:conf_ppty_conversions_note[config.conversions.note]`
 --
 
@@ -395,7 +395,7 @@ type;; RegExp
 default;;
 +
 ....
-/^((#|=)+ (Draft )?Release Note.*)|(<!-- (draft )?release note -->)\n(?<note>\w(.|\n)+)/gmi
+/^(((#|=)+ (Draft )?Release Note.*?)|(<!-- (draft )?release note -->))\n+(?<note>(.| )+)/gmi
 ....
 path;; `xref:conf_ppty_conversions_note_pattern[config.conversions.note_pattern]`
 --
@@ -3161,7 +3161,7 @@ This value will apply either when <<conf_ppty_rhyml_max_parts>> is set to `1` or
 type;; String
 default;;
 +
-`+++Part+++`
+`+++Component+++`
 path;; `xref:conf_ppty_history_labeling_part_label[config.history.labeling.part_label]`
 --
 

data/build/docs/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",
@@ -1228,7 +1229,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/build/docs/index.adoc

@@ -1,5 +1,6 @@
 :page-layout: default
-:page-permalink: /docs
+:page-permalink: /docs/
+:page-title: ReleaseHx Docs
 :page-nav_order: 1
 [[releasehx]]
 = ReleaseHx
@@ -15,7 +16,7 @@
 :this_prod_vrsn_major: 0
 :this_prod_vrsn_minor: 1
 :this_prod_vrsn_major-minor: {this_prod_vrsn_major}.{this_prod_vrsn_minor}
-:this_prod_vrsn_patch: 0
+:this_prod_vrsn_patch: 2
 :this_prod_vrsn: {this_prod_vrsn_major-minor}.{this_prod_vrsn_patch}
 :next_prod_vrsn: 0.2.0
 :tagline: Generate formatted release histories from Jira, GitHub, GitLab, YAML, or JSON sources.

data/build/docs/landing.adoc

@@ -1,6 +1,7 @@
 :page-permalink: /
 :page-layout: minimal
 :page-liquid: true
+:page-nav_exclude: true
 = ReleaseHx
 
 ++++
@@ -10,9 +11,15 @@
       <h1 class="title">
         ReleaseHx
       </h1>
-      <h2 class="subtitle">
-        {{ site.tagline }}
-      </h2>
+      <nav class="top-nav">
+        <a href="/docs/" class="button is-primary is-medium">
+          Documentation
+        </a>
+        &nbsp;|&nbsp;
+        <a href="/docs/releases/" class="button is-link is-medium">
+          Releases
+        </a>
+      </nav>
     </div>
   </div>
 </div>

data/build/docs/releases.adoc

@@ -0,0 +1,28 @@
+---
+layout: default
+title: Releases
+nav_order: 90
+permalink: /docs/releases/
+---
+= Release History
+:page-layout: default
+:page-title: Releases
+:page-nav_order: 90
+:page-permalink: /docs/releases/
+
+Complete release history for ReleaseHx, generated using ReleaseHx itself.
+
+ifdef::env-site[]
+// Generated during prebuild - includes release index and content
+include::_release_index.adoc[]
+endif::[]
+
+ifndef::env-site[]
+== Development Mode
+
+Release history is generated during the prebuild process. Run `bundle exec rake prebuild` to generate the full release index.
+endif::[]
+
+---
+
+For more information about ReleaseHx, see the link:/docs/[main documentation].

data/build/docs/sample-config.adoc

@@ -1,4 +1,6 @@
 :page-nav_order: 3
+:page-permalink: /docs/sample-config/
+:page-redirect_from: /sample-config.html
 = Sample Configuration File
 
 This is a "`kitchen sink`" example of the ReleaseHx configuration settings.

data/build/docs/sample-config.yml

@@ -22,7 +22,7 @@ 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.
@@ -195,7 +195,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

data/lib/releasehx/cli.rb

@@ -688,23 +688,32 @@ module ReleaseHx
     end
 
     def create_rhyml_from_source source_path, version
-      # Determine source type from configuration, not just file extension
-      configured_source_type = @settings.dig('origin', 'source') || 'json'
-
-      # Handle different source types based on configuration
-      case configured_source_type
-      when 'rhyml'
+      # First check if source_path is actually a file (overrides config)
+      if version_or_file(source_path) == :file && File.exist?(source_path)
         # Load RHYML data directly from YAML file
+        ReleaseHx.logger.debug "Loading RHYML from file: #{source_path}" if options[:verbose]
         rhyml_data = SchemaGraphy::Loader.load_yaml_with_tags(source_path)
         release_data = rhyml_data['releases'] ? rhyml_data['releases'].first : rhyml_data
 
         # Convert hash keys to keyword arguments for Release constructor
-        ReleaseHx::RHYML::Release.new(
+        return ReleaseHx::RHYML::Release.new(
           code: release_data['code'] || version,
           date: release_data['date'],
           hash: release_data['hash'],
           memo: release_data['memo'],
           changes: release_data['changes'] || [])
+      end
+
+      # Determine source type from configuration
+      configured_source_type = @settings.dig('origin', 'source') || 'json'
+
+      # Handle different source types based on configuration
+      case configured_source_type
+      when 'rhyml'
+        # Config says rhyml but source_path is not a file - error
+        raise Thor::Error,
+              "ERROR: origin.source is 'rhyml' but no YAML file provided. " \
+              'Specify a YAML file path as the first argument.'
       when 'json'
         # For json type, only use local files (never API calls)
         if options[:api_data]

data/lib/releasehx/generated.rb

@@ -2,7 +2,7 @@
 # Auto-generated by Sourcerer::Builder
 
 module ReleaseHx
-  ATTRIBUTES = {:globals=>{"attribute-undefined"=>"drop-line", "attribute-missing"=>"skip", "appendix-caption"=>"Appendix", "appendix-refsig"=>"Appendix", "caution-caption"=>"Caution", "chapter-refsig"=>"Chapter", "example-caption"=>"Example", "figure-caption"=>"Figure", "important-caption"=>"Important", "last-update-label"=>"Last updated", "note-caption"=>"Note", "part-refsig"=>"Part", "prewrap"=>"", "sectids"=>"", "section-refsig"=>"Section", "table-caption"=>"Table", "tip-caption"=>"Tip", "toc-placement"=>"macro", "toc-title"=>"Table of Contents", "untitled-label"=>"Untitled", "version-label"=>"Version", "warning-caption"=>"Warning", "notitle"=>"", "docfile"=>"/home/brian/Documents/work/releasehx/README.adoc", "docdir"=>"/home/brian/Documents/work/releasehx", "docfilesuffix"=>".adoc", "docname"=>"README", "embedded"=>"", "asciidoctor"=>"", "asciidoctor-version"=>"2.0.23", "safe-mode-name"=>"unsafe", "safe-mode-unsafe"=>"", "safe-mode-level"=>0, "max-include-depth"=>64, "user-home"=>"/home/brian", "doctype"=>"article", "htmlsyntax"=>"html", "backend-html5-doctype-article"=>"", "doctype-article"=>"", "backend-html5"=>"", "backend"=>"html5", "outfilesuffix"=>".html", "filetype"=>"html", "filetype-html"=>"", "basebackend-html-doctype-article"=>"", "basebackend-html"=>"", "basebackend"=>"html", "stylesdir"=>".", "iconsdir"=>"./images/icons", "localdate"=>"2026-01-01", "localyear"=>"2026", "localtime"=>"13:06:29 -0500", "localdatetime"=>"2026-01-01 13:06:29 -0500", "docdate"=>"2026-01-01", "docyear"=>"2026", "doctime"=>"04:37:26 -0500", "docdatetime"=>"2026-01-01 04:37:26 -0500", "page-layout"=>"default", "page-permalink"=>"/docs", "page-nav_order"=>"1", "doctitle"=>"ReleaseHx", "docopslab_git_www"=>"https://github.com/DocOps", "this_prod_slug"=>"releasehx", "releasehx_prod_repo"=>"https://github.com/DocOps/releasehx", "releasehx_demo_repo"=>"https://github.com/DocOps/releasehx-demo", "this_prod_repo"=>"https://github.com/DocOps/releasehx", "this_prod_vrsn_major"=>"0", "this_prod_vrsn_minor"=>"1", "this_prod_vrsn_major-minor"=>"0.1", "this_prod_vrsn_patch"=>"0", "this_prod_vrsn"=>"0.1.0", "next_prod_vrsn"=>"0.2.0", "tagline"=>"Generate formatted release histories from Jira, GitHub, GitLab, YAML, or JSON sources.", "description"=>"CLI utility and Ruby API for generating structured release notes and changelog documents from various issue-tracking platforms or YAML definitions into plaintext drafts (<strong>AsciiDoc</strong>, <strong>Markdown</strong>, <strong>YAML</strong>) and rich-text output (<strong>HTML</strong> and <strong>PDF</strong>).", "gem_config_definition_path"=>"./specs/data/config-def.yml", "app_default_config_path"=>"./.releasehx.yml", "default_markup"=>"markdown", "default_slug_type"=>"kebab", "default_tplt_lang"=>"liquid", "default_drafts_dir"=>"_drafts", "default_enrich_dir"=>"_publish", "default_output_dir"=>".", "default_payloads_dir"=>"_payloads", "default_templates_dir"=>"_templates", "default_mappings_dir"=>"_mappings", "default_api_clients_dir"=>"_apis", "default_cache_dir"=>".releasehx/cache", "default_api_cred_env"=>"RELEASEHX_API_CRED", "default_api_key_env"=>"RELEASEHX_API_KEY", "default_api_user_env"=>"RELEASEHX_API_USER", "default_api_org_env"=>"RELEASEHX_API_ORG", "markdown_extensions"=>".md, .markdown", "asciidoc_extensions"=>".adoc, .ad, .asciidoc", "yaml_extensions"=>".yml, .yaml, .rhyml", "draft_source_file_types"=>"AsciiDoc, Markdown, YAML", "draft_source_extensions"=>".md, .markdown, .adoc, .ad, .asciidoc, .yml, .yaml, .rhyml", "enrich_file_types"=>"HTML, PDF", "enrich_extensions"=>".html, .pdf", "docker_base_command"=>"docker run -it --rm --user $(id -u):$(id -g) -v $(pwd):/workdir docopslab/releasehx rhx", "this_prod_repo_branch"=>"https://github.com/DocOps/releasehx/tree/release/0.1", "docs_extn"=>"", "toc"=>"", "toclevels"=>"3", "authorcount"=>0, "toc-position"=>"content"}}
+  ATTRIBUTES = {:globals=>{"attribute-undefined"=>"drop-line", "attribute-missing"=>"skip", "appendix-caption"=>"Appendix", "appendix-refsig"=>"Appendix", "caution-caption"=>"Caution", "chapter-refsig"=>"Chapter", "example-caption"=>"Example", "figure-caption"=>"Figure", "important-caption"=>"Important", "last-update-label"=>"Last updated", "note-caption"=>"Note", "part-refsig"=>"Part", "prewrap"=>"", "sectids"=>"", "section-refsig"=>"Section", "table-caption"=>"Table", "tip-caption"=>"Tip", "toc-placement"=>"macro", "toc-title"=>"Table of Contents", "untitled-label"=>"Untitled", "version-label"=>"Version", "warning-caption"=>"Warning", "notitle"=>"", "docfile"=>"/home/brian/Documents/work/releasehx/README.adoc", "docdir"=>"/home/brian/Documents/work/releasehx", "docfilesuffix"=>".adoc", "docname"=>"README", "embedded"=>"", "asciidoctor"=>"", "asciidoctor-version"=>"2.0.23", "safe-mode-name"=>"unsafe", "safe-mode-unsafe"=>"", "safe-mode-level"=>0, "max-include-depth"=>64, "user-home"=>"/home/brian", "doctype"=>"article", "htmlsyntax"=>"html", "backend-html5-doctype-article"=>"", "doctype-article"=>"", "backend-html5"=>"", "backend"=>"html5", "outfilesuffix"=>".html", "filetype"=>"html", "filetype-html"=>"", "basebackend-html-doctype-article"=>"", "basebackend-html"=>"", "basebackend"=>"html", "stylesdir"=>".", "iconsdir"=>"./images/icons", "localdate"=>"2026-01-30", "localyear"=>"2026", "localtime"=>"01:33:36 -0500", "localdatetime"=>"2026-01-30 01:33:36 -0500", "docdate"=>"2026-01-30", "docyear"=>"2026", "doctime"=>"00:47:36 -0500", "docdatetime"=>"2026-01-30 00:47:36 -0500", "page-layout"=>"default", "page-permalink"=>"/docs/", "page-title"=>"ReleaseHx Docs", "page-nav_order"=>"1", "doctitle"=>"ReleaseHx", "docopslab_git_www"=>"https://github.com/DocOps", "this_prod_slug"=>"releasehx", "releasehx_prod_repo"=>"https://github.com/DocOps/releasehx", "releasehx_demo_repo"=>"https://github.com/DocOps/releasehx-demo", "this_prod_repo"=>"https://github.com/DocOps/releasehx", "this_prod_vrsn_major"=>"0", "this_prod_vrsn_minor"=>"1", "this_prod_vrsn_major-minor"=>"0.1", "this_prod_vrsn_patch"=>"2", "this_prod_vrsn"=>"0.1.2", "next_prod_vrsn"=>"0.2.0", "tagline"=>"Generate formatted release histories from Jira, GitHub, GitLab, YAML, or JSON sources.", "description"=>"CLI utility and Ruby API for generating structured release notes and changelog documents from various issue-tracking platforms or YAML definitions into plaintext drafts (<strong>AsciiDoc</strong>, <strong>Markdown</strong>, <strong>YAML</strong>) and rich-text output (<strong>HTML</strong> and <strong>PDF</strong>).", "gem_config_definition_path"=>"./specs/data/config-def.yml", "app_default_config_path"=>"./.releasehx.yml", "default_markup"=>"markdown", "default_slug_type"=>"kebab", "default_tplt_lang"=>"liquid", "default_drafts_dir"=>"_drafts", "default_enrich_dir"=>"_publish", "default_output_dir"=>".", "default_payloads_dir"=>"_payloads", "default_templates_dir"=>"_templates", "default_mappings_dir"=>"_mappings", "default_api_clients_dir"=>"_apis", "default_cache_dir"=>".releasehx/cache", "default_api_cred_env"=>"RELEASEHX_API_CRED", "default_api_key_env"=>"RELEASEHX_API_KEY", "default_api_user_env"=>"RELEASEHX_API_USER", "default_api_org_env"=>"RELEASEHX_API_ORG", "markdown_extensions"=>".md, .markdown", "asciidoc_extensions"=>".adoc, .ad, .asciidoc", "yaml_extensions"=>".yml, .yaml, .rhyml", "draft_source_file_types"=>"AsciiDoc, Markdown, YAML", "draft_source_extensions"=>".md, .markdown, .adoc, .ad, .asciidoc, .yml, .yaml, .rhyml", "enrich_file_types"=>"HTML, PDF", "enrich_extensions"=>".html, .pdf", "docker_base_command"=>"docker run -it --rm --user $(id -u):$(id -g) -v $(pwd):/workdir docopslab/releasehx rhx", "this_prod_repo_branch"=>"https://github.com/DocOps/releasehx/tree/release/0.1", "docs_extn"=>"", "toc"=>"", "toclevels"=>"3", "authorcount"=>0, "toc-position"=>"content"}}
 
   SNIPPET_LOOKUP = {"helpscreen"=>"helpscreen.txt"}
 

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

@@ -165,6 +165,7 @@ properties:
           Must be `issue_body`, `custom_field`, or `commit_message`.
 
           Defaults to `issue_body` for GitHub and GitLab, but to `custom_field` for Jira.
+        dflt: issue_body
       note_custom_field:
         type: String
         desc: |
@@ -182,7 +183,8 @@ properties:
           Uses Capture group `note` in the Regular Expression to establish the entire note content.
 
           See the `conversions.head_pattern` property for details on extracting a heading (`head` in RHYML) from the `note` content.
-        dflt: '/^((#|=)+ (Draft )?Release Note.*)|(<!-- (draft )?release note -->)\n(?<note>\w(.|\n)+)/gmi'
+        dflt: '/^(((#|=)+ (Draft )?Release Note.*?)|(<!-- (draft )?release note -->))\n+(?<note>(.|
+)+)/gmi'
       head_pattern:
         type: RegExp
         desc: |
@@ -1162,7 +1164,7 @@ properties:
               The label to use for the _singular_ part/component affected by the change, when only one part is permitted.
 
               This 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`.
-            dflt: Part
+            dflt: Component
           parts_icon:
             type: String
             desc: |

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

@@ -1,7 +1,4 @@
-:page-layout: default
-:page-permalink: /config-reference/
-:page-nav_order: 2
-:page-title: Configuration Reference
+
 
 [[conf_ppty_DOLLARSIGN_meta,config.$meta]]
 $meta::
@@ -359,6 +356,9 @@ Defaults to `issue_body` for GitHub and GitLab, but to `custom_field` for Jira.
 
 [horizontal]
 type;; String
+default;;
++
+`+++issue_body+++`
 path;; `xref:conf_ppty_conversions_note[config.conversions.note]`
 --
 
@@ -395,7 +395,7 @@ type;; RegExp
 default;;
 +
 ....
-/^((#|=)+ (Draft )?Release Note.*)|(<!-- (draft )?release note -->)\n(?<note>\w(.|\n)+)/gmi
+/^(((#|=)+ (Draft )?Release Note.*?)|(<!-- (draft )?release note -->))\n+(?<note>(.| )+)/gmi
 ....
 path;; `xref:conf_ppty_conversions_note_pattern[config.conversions.note_pattern]`
 --
@@ -3161,7 +3161,7 @@ This value will apply either when <<conf_ppty_rhyml_max_parts>> is set to `1` or
 type;; String
 default;;
 +
-`+++Part+++`
+`+++Component+++`
 path;; `xref:conf_ppty_history_labeling_part_label[config.history.labeling.part_label]`
 --
 

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",
@@ -1228,7 +1229,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,7 +22,7 @@ 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.
@@ -195,7 +195,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

data/lib/releasehx/rhyml/adapter.rb

@@ -349,7 +349,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 +406,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 +421,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/changelog.adoc.liquid

@@ -0,0 +1,14 @@
+{%- assign content_config = config.changelog %}
+{%- assign section_type = "changelog" %}
+{%- embed config-cascade.liquid %}
+{%- embed changes-sorter.liquid %}
+{%- assign level = content_config.htag | replace: "h", "" | default: dflt_next_header_level | plus: 0 %}
+{%- capture header_chars %}
+{%-   for i in (1..level) %}{{ header_char }}{% endfor %}
+{%- endcapture %}
+{%- include header.liquid format=format level=level text=content_config.head %}
+{%- assign dflt_next_header_level = level | plus: 1 -%}
+{%- assign item_count = 0 %}
+{%- embed section-text.liquid %}
+
+{%- embed groupings.liquid %}

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

@@ -0,0 +1,14 @@
+{%- assign content_config = config.changelog %}
+{%- embed changes-sorter.liquid %}
+{%- assign level = content_config.htag | replace: "h", "" | default: dflt_next_header_level | plus: 0 %}
+{%- 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 %}
+
+    {%- embed section-text.liquid %}
+
+    {%- embed groupings.liquid %}
+</div>
+

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

@@ -0,0 +1,11 @@
+{%- assign content_config = config.changelog %}
+{%- assign section_type = "changelog" %}
+{%- embed config-cascade.liquid %}
+{% embed changes-sorter.liquid %}
+{%- assign level = content_config.htag | replace: "h", "" | default: dflt_next_header_level | plus: 0 %}
+{%- include header.liquid format=format level=level text=content_config.head %}
+{%- assign dflt_next_header_level = level | plus: 1 -%}
+{%- assign item_count = 0 %}
+{%- embed section-text.liquid %}
+
+{%- embed groupings.liquid %}

data/lib/releasehx/rhyml/templates/changes-sorter.liquid

@@ -0,0 +1,64 @@
+{%- assign groups = '' | split: ',' %}
+{%- assign grouping1 = '' | split: ',' %}
+{%- assign grouping2 = '' | split: ',' %}
+
+{%- for group_expr in content_config.sort %}
+{%-   assign kind = group_expr | split: ':' | first %}
+{%-   assign target = group_expr | split: ':' | last %}
+
+{%-   if kind == 'tag' or kind == 'tags' %}
+{%-     for tag_entry in config.tags %}
+{%-       assign tag_name = tag_entry[0] %}
+{%-       if tag_name == '_include' or tag_name == '_exclude' %}
+{%-         continue %}
+{%-       endif %}
+{%-       assign group = 'tag:' | append: tag_name %}
+{%-       assign group = group | split: ',' %}
+{%-       if target == 'grouping1' %}
+{%-         assign grouping1 = grouping1 | concat: group %}
+{%-       elsif target == 'grouping2' %}
+{%-         assign grouping2 = grouping2 | concat: group %}
+{%-       endif %}
+{%-     endfor %}
+
+{%-   elsif kind == 'type' %}
+{%-     for type_entry in config.types %}
+{%-       assign type_name = type_entry[0] %}
+{%-       if type_name contains "<" %}
+{%-         continue %}
+{%-       endif %}
+{%-       assign group = 'type:' | append: type_name | split: ',' %}
+{%-       if target == 'grouping1' %}
+{%-         assign grouping1 = grouping1 | concat: group %}
+{%-       elsif target == 'grouping2' %}
+{%-         assign grouping2 = grouping2 | concat: group %}
+{%-       endif %}
+{%-     endfor %}
+
+{%-   elsif kind == 'part' %}
+{%-     for part_entry in config.parts %}
+{%-       assign part_name = part_entry[0] %}
+{%-       if part_name contains "<" or part_name == 'label_prefix' %}
+{%-         continue %}
+{%-       endif %}
+{%-       assign group = 'part:' | append: part_name | split: ',' %}
+{%-       if target == 'grouping1' %}
+{%-         assign grouping1 = grouping1 | concat: group %}
+{%-       elsif target == 'grouping2' %}
+{%-         assign grouping2 = grouping2 | concat: group %}
+{%-       endif %}
+{%-     endfor %}
+
+{%-   else %}
+{%-     assign group = 'tag:' | append: kind | split: ',' %}
+{%-     if target == 'grouping1' %}
+{%-       assign grouping1 = grouping1 | concat: group %}
+{%-     elsif target == 'grouping2' %}
+{%-       assign grouping2 = grouping2 | concat: group %}
+{%-     endif %}
+{%-   endif %}
+{%- endfor %}
+
+{%- if grouping2.size > 0 and grouping1 == empty %}
+Invalid sort: cannot define grouping2 without grouping1
+{%- endif %}