RubyGems - releasehx - Versions diffs - 0.2.0 → 0.2.1 - Mend

releasehx 0.2.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (11) hide show

checksums.yaml +4 -4
data/README.adoc +22 -16
data/build/docs/_config.yml +3 -1
data/build/docs/_release_index.adoc +16 -6
data/build/docs/index.adoc +71 -287
data/build/docs/release-procedure.adoc +8 -2
data/build/docs/release-procedure.html +5 -4
data/build/docs/releasehx.1 +2 -2
data/lib/releasehx/generated.rb +1 -1
data/lib/releasehx/rhyml/templates/rhyml-change.yaml.liquid +7 -7
metadata +1 -1

checksums.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ac4d0a0b453e04e4d951efb1872442643c24d6acf38e10fc5e46ece9519a7d66
-  data.tar.gz: '03047949b1e979d21c2e1ba62e9724cf4d73fc70bad846f514d8ece952fd2274'
+  metadata.gz: 78e2b0461641bd5ccec859dc8cc3902b17cf253e0e93bbd67e9985d99b118aed
+  data.tar.gz: 61625da70d76384524914b4457f4803e2add183122cbd987a9406c3fe176e0b1
 SHA512:
-  metadata.gz: 51afc5d365a22fea9a30a0321a29c70635c792ced58cbdb90d6070507718b7be750d4f616d04c1042bef05862d0afc8fae29182baac8abcd5577fe90d5b0465b
-  data.tar.gz: 200ae529d58615589ede46426ea3d8cc932c9059e861089071bac4482268d99670910af5d97fd4ebd26f611926c78cc5a7d048ade90eff5e131293d12aa14630
+  metadata.gz: 37386a8549560e7ff8ebb64975b4907966e731fadd4d918bba0d93f177e9d05eafbb0a097f184f615c94d09c2b0aeb32b3155d6ce1762f1c24a412712ea7577d
+  data.tar.gz: 73cd6b547b271985f3f0df2e39c1e5636966788dc5492624591521ff97efa37031024515f67aea5a3c27f9a9cb9a18d0172c1aad4164f08cbd9235d1ecace1d5

data/README.adoc CHANGED Viewed

@@ -12,23 +12,25 @@
 :this_proj_slug: releasehx
 :this_proj_name: ReleaseHx
 // tag::universal-settings[]
+// ALL changes within this block must be made in prime template:
+//  DocOps/lab/gems/docopslab-dev/templates/README.asciidoc
 :docopslab_src_www_url: https://github.com/DocOps
 :docopslab_domain: docopslab.org
 :docopslab_www_url: https://{docopslab_domain}
 :docopslab_io_www_url: https://docopslab.github.io
 :docopslab_ruby_version: 3.2.7
-:docopslab_src_www_url: https://raw.githubusercontent.com/DocOps
 :docopslab_git_src_uri: git@github.com:DocOps
+:docopslab_src_raw_url: https://raw.githubusercontent.com/DocOps
 :this_proj_src_www_url: {docopslab_src_www_url}/{this_proj_slug}
-:this_proj_src_raw_url: https://raw.githubusercontent.com/DocOps/{this_proj_slug}/main
+:this_proj_src_raw_url: {docopslab_src_raw_url}/{this_proj_slug}
+:this_proj_src_main_raw_url: {this_proj_src_raw_url}/main
 :this_proj_src_main_files_url: {this_proj_src_www_url}/blob/main
-:this_proj_src_main_edit_url: {this_proj_src_www_url}/edit/main
 :this_proj_src_git_uri: {docopslab_git_src_uri}/{this_proj_slug}.git
 :this_proj_ruby_version: {docopslab_ruby_version}
 // tag::env-settings[]
-:extn:
+:docs_extn:
 ifdef::env-github[]
-:extn: .adoc
+:docs_extn: .adoc
 :icons: font
 :caution-caption: :fire:
 :important-caption: :exclamation:
@@ -37,15 +39,19 @@ ifdef::env-github[]
 :warning-caption: :warning:
 endif::[]
 // end::env-settings[]
+// Settings likely to be overridden locally
+:this_prod_slug: {this_proj_slug}
+:this_prod_name: {this_proj_name}
+:this_prod_src_www_url: {this_proj_src_www_url}
 // end::universal-settings[]
-:releasehx_demo_repo: {docopslab_src_www_url}/releasehx-demo
+:releasehx-demo_repo_www_url: {docopslab_src_www_url}/releasehx-demo
 // tag::product-settings[]
 :this_prod_slug: {this_proj_slug}
 // tag::version-settings[]
 :this_prod_vrsn_major: 0
 :this_prod_vrsn_minor: 2
 :this_prod_vrsn_majmin: {this_prod_vrsn_major}.{this_prod_vrsn_minor}
-:this_prod_vrsn_patch: 0
+:this_prod_vrsn_patch: 1
 :this_prod_vrsn: {this_prod_vrsn_majmin}.{this_prod_vrsn_patch}
 :next_prod_vrsn: 0.3.0
 :next_prod_vrsn_majmin: 0.3
@@ -461,7 +467,7 @@ Then have it consult `releasehx://config/sample` as a table of contents before u
 [[demo-setup]]
 ==== Demo Repo Setup
-If you want to play around with ReleaseHx before connecting it to your own Issues source via API, use the `link:{releasehx_demo_repo}[DocOps/releasehx-demo]` repository as instructed in this section.
+If you want to play around with ReleaseHx before connecting it to your own Issues source via API, use the `link:{releasehx-demo_repo_www_url}[DocOps/releasehx-demo]` repository as instructed in this section.
 Alternately, skip to <<issue-sources>> to begin configuring your own project/environment.
@@ -632,7 +638,7 @@ Out of the box, there are two issues in the `jira-customfield-note-1.1.0.json` f
 [.prompt.testable]
  rhx 1.1.0 --config configs/jira-customfield.yml --api-data _payloads/jira-customfield-note-1.1.0.json --html --pdf
-For more on the demo repo, visit its README at {releasehx_demo_repo}.
+For more on the demo repo, visit its README at {releasehx-demo_repo_www_url}.
 [[custom-configuration]]
 ==== Custom Configuration
@@ -923,7 +929,7 @@ For *custom field-based* release notes, the entire ADF content in the custom fie
 No heading extraction is performed.
 --
-See link:{releasehx_demo_repo}[releasehx-demo] repository for working examples with ADF payloads and configurations.
+See link:{releasehx-demo_repo_www_url}[releasehx-demo] repository for working examples with ADF payloads and configurations.
 [[github-issues]]
 ==== GitHub Issues
@@ -1350,7 +1356,7 @@ When rendered, the HTML will include:
 }
 ----
-For examples of dark theme in action, see the demo configurations in the {releasehx_demo_repo}[releasehx-demo repository], particularly `github-dark-mode.yml` and `github-bootstrap-dark.yml`.
+For examples of dark theme in action, see the demo configurations in the {releasehx-demo_repo_www_url}[releasehx-demo repository], particularly `github-dark-mode.yml` and `github-bootstrap-dark.yml`.
 [[html-wrapper-control]]
 ===== HTML Wrapper Control
@@ -1954,7 +1960,7 @@ ReleaseHx comes with a complete default configuration file as well as a series o
 The complete link:{default-config_www}[default config file] displays default values with commented descriptions of all available properties.
-The various sample configurations stored in the link:{releasehx_demo_repo}/blob/main/configs/[demo repository] may be a good start toward establishing your own setup.
+The various sample configurations stored in the link:{releasehx-demo_repo_www_url}/blob/main/configs/[demo repository] may be a good start toward establishing your own setup.
 [[env-vars]]
 === Environment Variables in ReleaseHx
@@ -2188,7 +2194,7 @@ For example, if your GitHub issues use labels like:
 Your ReleaseHx application will need an alternate mapping because the default GitHub mapping expects native `issue_type.name` fields.
 An example alternate mapping for label-based GitHub type extraction can be found at:
-link:{releasehx_demo_repo}/blob/main/_mappings_/legacy-labels/github.yaml[`releasehx-demo/_mappings_/legacy-labels/github.yaml`]
+link:{releasehx-demo_repo_www_url}/blob/main/_mappings_/legacy-labels/github.yaml[`releasehx-demo/_mappings_/legacy-labels/github.yaml`]
 This mapping includes Ruby logic to:
@@ -2240,7 +2246,7 @@ To use an alternate mapping:
 . Test with representative payload data to ensure proper extraction
-The link:{releasehx_demo_repo}[demo repository] contains working examples of these alternate mappings alongside their corresponding configurations and test payloads.
+The link:{releasehx-demo_repo_www_url}[demo repository] contains working examples of these alternate mappings alongside their corresponding configurations and test payloads.
 [NOTE]
 ReleaseHx by default looks for a mapping file that matches the name of the API you are using.
@@ -2276,7 +2282,7 @@ Using the ReleaseHx config file, you can manipulate:
 Most of this can be manipulated using the following sections: <<conf_ppty_history>>, <<conf_ppty_changelog>>, <<conf_ppty_notes>>, <<conf_ppty_links>>, as well as within change-metadata config blocks, where you can alter labels, icons, and such: <<conf_ppty_types>>, <<conf_ppty_parts>>, <<conf_ppty_tags>>.
-The various sample configurations found in the link:{releasehx_demo_repo}/blob/main/configs/[demo repository] illustrate many of these options.
+The various sample configurations found in the link:{releasehx-demo_repo_www_url}/blob/main/configs/[demo repository] illustrate many of these options.
 A complete link:{default-config_www}[sample config] displays default values and commented descriptions of all available properties.
@@ -2550,7 +2556,7 @@ To work with ReleaseHx source, clone both repositories side by side for the most
 +
 [.prompt]
  git clone {this_proj_src_www_url}
- git clone {releasehx_demo_repo}
+ git clone {releasehx-demo_repo_www_url}
 +
 This will give you `<source_dir>/releasehx` and `<source_dir>/releasehx-demo`, side by side.

data/build/docs/_config.yml CHANGED Viewed

@@ -1,6 +1,7 @@
 title: ReleaseHx Documentation
 theme: just-the-docs
 baseurl: /
+future: true
 plugins:
   - jekyll-asciidoc
@@ -31,7 +32,8 @@ exclude:
   - manpage.adoc
   - jekyll/
   - payloads/
-  - release/
+  - _releases/drafts
+  - _releases/payloads
   - yard/
   - release-procedure.adoc

data/build/docs/_release_index.adoc CHANGED Viewed

@@ -1,10 +1,20 @@
-== Available Releases
+== Release History
-Each release includes detailed notes about new features, improvements, bug fixes, and breaking changes.
+[cols="~,~"]
+|===
+| <<release-0-2-1,0.2.1>>
+| 28 May, 2026
+| <<release-0-2-0,0.2.0>>
+| 27 May, 2026
+| <<release-0-1-2,0.1.2>>
+| 30 January, 2026
+|===
-* link:../release/0.2.0[0.2.0] - 2026-05-27
-* link:../release/0.1.2[0.1.2] - 2026-01-30
+[[release-0-2-1]]
+include::_releases/0.2.1.adoc[leveloffset=+1]
-== Latest Release
+[[release-0-2-0]]
+include::_releases/0.2.0.adoc[leveloffset=+1]
-include::release/0.2.0.adoc[leveloffset=+1]
+[[release-0-1-2]]
+include::_releases/0.1.2.adoc[leveloffset=+1]

data/build/docs/index.adoc CHANGED Viewed

@@ -12,23 +12,25 @@
 :this_proj_slug: releasehx
 :this_proj_name: ReleaseHx
 // tag::universal-settings[]
+// ALL changes within this block must be made in prime template:
+//  DocOps/lab/gems/docopslab-dev/templates/README.asciidoc
 :docopslab_src_www_url: https://github.com/DocOps
 :docopslab_domain: docopslab.org
 :docopslab_www_url: https://{docopslab_domain}
 :docopslab_io_www_url: https://docopslab.github.io
 :docopslab_ruby_version: 3.2.7
-:docopslab_src_www_url: https://raw.githubusercontent.com/DocOps
 :docopslab_git_src_uri: git@github.com:DocOps
+:docopslab_src_raw_url: https://raw.githubusercontent.com/DocOps
 :this_proj_src_www_url: {docopslab_src_www_url}/{this_proj_slug}
-:this_proj_src_raw_url: https://raw.githubusercontent.com/DocOps/{this_proj_slug}/main
+:this_proj_src_raw_url: {docopslab_src_raw_url}/{this_proj_slug}
+:this_proj_src_main_raw_url: {this_proj_src_raw_url}/main
 :this_proj_src_main_files_url: {this_proj_src_www_url}/blob/main
-:this_proj_src_main_edit_url: {this_proj_src_www_url}/edit/main
 :this_proj_src_git_uri: {docopslab_git_src_uri}/{this_proj_slug}.git
 :this_proj_ruby_version: {docopslab_ruby_version}
 // tag::env-settings[]
-:extn:
+:docs_extn:
 ifdef::env-github[]
-:extn: .adoc
+:docs_extn: .adoc
 :icons: font
 :caution-caption: :fire:
 :important-caption: :exclamation:
@@ -37,15 +39,19 @@ ifdef::env-github[]
 :warning-caption: :warning:
 endif::[]
 // end::env-settings[]
+// Settings likely to be overridden locally
+:this_prod_slug: {this_proj_slug}
+:this_prod_name: {this_proj_name}
+:this_prod_src_www_url: {this_proj_src_www_url}
 // end::universal-settings[]
-:releasehx_demo_repo: {docopslab_src_www_url}/releasehx-demo
+:releasehx-demo_repo_www_url: {docopslab_src_www_url}/releasehx-demo
 // tag::product-settings[]
 :this_prod_slug: {this_proj_slug}
 // tag::version-settings[]
 :this_prod_vrsn_major: 0
 :this_prod_vrsn_minor: 2
 :this_prod_vrsn_majmin: {this_prod_vrsn_major}.{this_prod_vrsn_minor}
-:this_prod_vrsn_patch: 0
+:this_prod_vrsn_patch: 1
 :this_prod_vrsn: {this_prod_vrsn_majmin}.{this_prod_vrsn_patch}
 :next_prod_vrsn: 0.3.0
 :next_prod_vrsn_majmin: 0.3
@@ -79,6 +85,8 @@ endif::[]
 :enrich_file_types: HTML, PDF
 :enrich_extensions: .html, .pdf
 // end::product-settings[]
+:asciisourcerer_www_url: {docopslab_src_www_url}/asciisourcerer
+:schemagraphy_www_url: {docopslab_src_www_url}/schemagraphy
 // end::global-settings[]
 :toc: macro
 :toclevels: 3
@@ -459,7 +467,7 @@ Then have it consult `releasehx://config/sample` as a table of contents before u
 [[demo-setup]]
 ==== Demo Repo Setup
-If you want to play around with ReleaseHx before connecting it to your own Issues source via API, use the `link:{releasehx_demo_repo}[DocOps/releasehx-demo]` repository as instructed in this section.
+If you want to play around with ReleaseHx before connecting it to your own Issues source via API, use the `link:{releasehx-demo_repo_www_url}[DocOps/releasehx-demo]` repository as instructed in this section.
 Alternately, skip to <<issue-sources>> to begin configuring your own project/environment.
@@ -630,7 +638,7 @@ Out of the box, there are two issues in the `jira-customfield-note-1.1.0.json` f
 [.prompt.testable]
  rhx 1.1.0 --config configs/jira-customfield.yml --api-data _payloads/jira-customfield-note-1.1.0.json --html --pdf
-For more on the demo repo, visit its README at {releasehx_demo_repo}.
+For more on the demo repo, visit its README at {releasehx-demo_repo_www_url}.
 [[custom-configuration]]
 ==== Custom Configuration
@@ -921,7 +929,7 @@ For *custom field-based* release notes, the entire ADF content in the custom fie
 No heading extraction is performed.
 --
-See link:{releasehx_demo_repo}[releasehx-demo] repository for working examples with ADF payloads and configurations.
+See link:{releasehx-demo_repo_www_url}[releasehx-demo] repository for working examples with ADF payloads and configurations.
 [[github-issues]]
 ==== GitHub Issues
@@ -1348,7 +1356,7 @@ When rendered, the HTML will include:
 }
 ----
-For examples of dark theme in action, see the demo configurations in the {releasehx_demo_repo}[releasehx-demo repository], particularly `github-dark-mode.yml` and `github-bootstrap-dark.yml`.
+For examples of dark theme in action, see the demo configurations in the {releasehx-demo_repo_www_url}[releasehx-demo repository], particularly `github-dark-mode.yml` and `github-bootstrap-dark.yml`.
 [[html-wrapper-control]]
 ===== HTML Wrapper Control
@@ -1952,7 +1960,7 @@ ReleaseHx comes with a complete default configuration file as well as a series o
 The complete link:{default-config_www}[default config file] displays default values with commented descriptions of all available properties.
-The various sample configurations stored in the link:{releasehx_demo_repo}/blob/main/configs/[demo repository] may be a good start toward establishing your own setup.
+The various sample configurations stored in the link:{releasehx-demo_repo_www_url}/blob/main/configs/[demo repository] may be a good start toward establishing your own setup.
 [[env-vars]]
 === Environment Variables in ReleaseHx
@@ -2099,7 +2107,7 @@ The extracted value is available in the `path` local variable.
 ==== Sandboxed Ruby Transformations
 The `ruby` key provides a powerful way to perform complex data transformations using a secure, sandboxed Ruby environment.
-This sandbox is powered by the `SchemaGraphy::SafeTransform` class, which ensures that only an explicit allowlist of safe methods and language features can be used.
+This sandbox is powered by the `SchemaGraphy::SafeTransform` class (from link:{schemagraphy_www_url}[SchemaGraphy gem]), which ensures that only an explicit allowlist of safe methods and language features can be used.
 [[sandboxed-ruby-context]]
 ===== Execution Context
@@ -2186,7 +2194,7 @@ For example, if your GitHub issues use labels like:
 Your ReleaseHx application will need an alternate mapping because the default GitHub mapping expects native `issue_type.name` fields.
 An example alternate mapping for label-based GitHub type extraction can be found at:
-link:{releasehx_demo_repo}/blob/main/_mappings_/legacy-labels/github.yaml[`releasehx-demo/_mappings_/legacy-labels/github.yaml`]
+link:{releasehx-demo_repo_www_url}/blob/main/_mappings_/legacy-labels/github.yaml[`releasehx-demo/_mappings_/legacy-labels/github.yaml`]
 This mapping includes Ruby logic to:
@@ -2238,7 +2246,7 @@ To use an alternate mapping:
 . Test with representative payload data to ensure proper extraction
-The link:{releasehx_demo_repo}[demo repository] contains working examples of these alternate mappings alongside their corresponding configurations and test payloads.
+The link:{releasehx-demo_repo_www_url}[demo repository] contains working examples of these alternate mappings alongside their corresponding configurations and test payloads.
 [NOTE]
 ReleaseHx by default looks for a mapping file that matches the name of the API you are using.
@@ -2252,9 +2260,8 @@ The custom mappings path can be set using <<conf_ppty_paths_mappings_dir>> setti
 ReleaseHx generally uses enhanced *Liquid 4 templates* to generate new files and content from RHYML and configuration data.
-Notably, it employs *link:https://jekyllrb.com/docs/liquid/[Jekyll's extended tags and filters]*, as well as some additional tag and several filters provided by Sourcerer.
-Here we document the custom filters added by the Sourcerer module and ReleaseHx itself.
+Notably, it employs *link:https://jekyllrb.com/docs/liquid/[Jekyll's extended tags and filters]*, as well as some additional tag and several filters provided by AsciiSourcerer.
+Here we document the custom filters added by the link:{asciisourcerer_www_url}[AsciiSourcerer gem] and ReleaseHx itself.
 [[advanced-template-configuration]]
 ==== Advanced Template Configuration
@@ -2275,7 +2282,7 @@ Using the ReleaseHx config file, you can manipulate:
 Most of this can be manipulated using the following sections: <<conf_ppty_history>>, <<conf_ppty_changelog>>, <<conf_ppty_notes>>, <<conf_ppty_links>>, as well as within change-metadata config blocks, where you can alter labels, icons, and such: <<conf_ppty_types>>, <<conf_ppty_parts>>, <<conf_ppty_tags>>.
-The various sample configurations found in the link:{releasehx_demo_repo}/blob/main/configs/[demo repository] illustrate many of these options.
+The various sample configurations found in the link:{releasehx-demo_repo_www_url}/blob/main/configs/[demo repository] illustrate many of these options.
 A complete link:{default-config_www}[sample config] displays default values and commented descriptions of all available properties.
@@ -2487,18 +2494,6 @@ Solution::
 . Review Jekyll's Liquid documentation for supported tags and filters
-ifdef::site-gen-jekyll[]
-[[apis]]
-== APIs
-Documntation for th ReleaseHx, SchemaGraphy, and Sourcerer APIs is available at:
-* link:/api/releasehx[ReleaseHx API]
-* link:/api/schemagraphy[SchemaGraphy API]
-* link:/api/sourcerer[Sourcerer API]
-endif::[]
 ifndef::site-gen-jekyll[]
 // tag::releasehx-api[]
@@ -2561,7 +2556,7 @@ To work with ReleaseHx source, clone both repositories side by side for the most
 +
 [.prompt]
  git clone {this_proj_src_www_url}
- git clone {releasehx_demo_repo}
+ git clone {releasehx-demo_repo_www_url}
 +
 This will give you `<source_dir>/releasehx` and `<source_dir>/releasehx-demo`, side by side.
@@ -2681,7 +2676,7 @@ Additionally, the help screen itself is sourced here in this README and included
 The application help and manpage documentation is also sourced in this way.
 (Use `rhx --help` or `rhx --man` to reveal.)
-This capability is provided by the Sourcerer module introduced in this gem but intended to be spun off into it own gem for use in all my (and any of your) Ruby projects in the future.
+This capability is provided by the link:{asciisourcerer_www_url}[AsciiSourcerer gem].
 [[common-dev-tasks]]
 === Common Dev Tasks
@@ -2879,71 +2874,54 @@ Dockerfile                       # Docker image definition
 build/                           # Untracked, ephemeral path for generated assets
 docs/                            # Documentation build source (Jekyll, YARD)
 .config/                         # Config files for various tools
-├── sourcerer.yml                # Sourcerer prebuild manifest
-└── docopslab-dev.yml            # DocOpsLab Devtool config
+   ├── sourcerer.yml             # Sourcerer prebuild manifest
+   └── docopslab-dev.yml         # DocOpsLab Devtool config
 specs/
-   ├── data/                     # Schema/definition files
-   │   ├── config-def.yml            # Configuration definition
-   │   ├── rhyml-schema.yaml         # RHYML schema definition
-   │   ├── api-client-schema.yaml    # API client schema definition
-   │   ├── rhyml-mapping-schema.yaml # API -> RHYML schema definition
-   │   └── mcp-manifest.yml          # Asset registry for MCP server
-   └── tests/
-       ├── README.adoc
-       ├── rspec/                # RSpec tests
-       └── configs/              # Test configs
+├── data/                     # Schema/definition files
+│   ├── config-def.yml            # Configuration definition
+│   ├── rhyml-schema.yaml         # RHYML schema definition
+│   ├── api-client-schema.yaml    # API client schema definition
+│   ├── rhyml-mapping-schema.yaml # API -> RHYML schema definition
+│   └── mcp-manifest.yml          # Asset registry for MCP server
+└── tests/
+    ├── README.adoc
+    ├── rspec/                # RSpec tests
+    └── configs/              # Test configs
 lib/
-├── releasehx.rb                 # Application core
-├── schemagraphy.rb              # Special YAML handling
-├── sourcerer.rb                 # Single-sourcing tool
 ├── docopslab/
 │   ├── mcp/                     # MCP assets and packaging
 │   └── mcp.rb                   # DocOpsLab MCP entrypoint
-├── releasehx/
-│   ├── cli.rb                   # Thor CLI definition
-│   ├── configuration.rb         # CFGYML parsing
-│   ├── generated.rb             # Generated by prebuild (packaged)
-│   ├── helpers.rb               # Utility helpers
-│   ├── mcp/                     # MCP server assets
-│   ├── mcp.rb                   # MCP server entrypoint
-│   ├── README.adoc              # Internal developer notes
-│   ├── rhyml.rb                 # RHYML entrypoint
-│   ├── sgyml/                   # SGYML helpers
-│   │   └── helpers.rb           # module SgymlHelpers
-│   ├── transforms/              # Input transformations (ADF, etc)
-│   ├── version.rb               # Version constant
-│   ├── rest/                    # module REST
-│   │   ├── yaml_client.rb       # ReleaseHx::REST::YamlClient class
-│   │   └── clients/             # YAML files for API clients (jira.yaml, etc)
-│   ├── ops/                     # Main ReleaseHx methods
-│   │   ├── check_ops.rb         # ReleaseHx::CheckOps module
-│   │   ├── draft_ops.rb         # ReleaseHx::DraftOps module
-│   │   ├── enrich_ops.rb        # ReleaseHx::EnrichOps module
-│   │   ├── template_ops.rb      # ReleaseHx::TemplateOps module
-│   │   └── write_ops.rb         # ReleaseHx::WriteOps module
-│   ├── rhyml/                   # module RHYML
-│   │   ├── adapter.rb           # maps from JSON using a mapping file
-│   │   ├── change.rb            # Change class
-│   │   ├── liquid.rb            # Liquid filters for RHYML
-│   │   ├── release.rb           # Release class
-│   │   ├── loaders.rb           # loads RHYML YAML or JSON from disk
-│   │   ├── mappings/            # API -> RHYML mappings
-│   │   └── templates/           # RHYML output templates
-├── schemagraphy/
-│   ├── cfgyml/                  # CFGYML (OpenCFGY) parsing
-│   ├── attribute_resolver.rb    # Resolves {attribute_name} placeholders
-│   ├── loader.rb                # `SchemaGraphy::Loader`
-│   ├── regexp_utils.rb          # Regular expression utilities
-│   ├── schema_utils.rb          # `get_schema_defaults`, etc
-│   ├── tag_utils.rb             # `detag`, `tag_of`, etc
-│   ├── templates/               # CFGYML documentation templates
-│   │   └── cfgyml/              # Config reference templates (+ sample gen)
-│   └── templating.rb            # Defines handling of parsable YAML nodes
-└── sourcerer/
-    ├── builder.rb               # Writes snippets to files at build time
-    ├── jekyll.rb                # Jekyll and Liquid handling for Sourcerer
-    ├── plaintext_converter.rb   # Pre-processes AsciiDoc source files
-    └── templating.rb            # Liquid/ERB template handling
+├── releasehx.rb                 # Application core
+└── releasehx/
+    ├── cli.rb                   # Thor CLI definition
+    ├── configuration.rb         # CFGYML parsing
+    ├── generated.rb             # Generated by prebuild (packaged)
+    ├── helpers.rb               # Utility helpers
+    ├── mcp/                     # MCP server assets
+    ├── mcp.rb                   # MCP server entrypoint
+    ├── README.adoc              # Internal developer notes
+    ├── rhyml.rb                 # RHYML entrypoint
+    ├── sgyml/                   # SGYML helpers
+    │   └── helpers.rb           # module SgymlHelpers
+    ├── transforms/              # Input transformations (ADF, etc)
+    ├── version.rb               # Version constant
+    ├── rest/                    # module REST
+    │   ├── yaml_client.rb       # ReleaseHx::REST::YamlClient class
+    │   └── clients/             # YAML files for API clients (jira.yaml, etc)
+    ├── ops/                     # Main ReleaseHx methods
+    │   ├── check_ops.rb         # ReleaseHx::CheckOps module
+    │   ├── draft_ops.rb         # ReleaseHx::DraftOps module
+    │   ├── enrich_ops.rb        # ReleaseHx::EnrichOps module
+    │   ├── template_ops.rb      # ReleaseHx::TemplateOps module
+    │   └── write_ops.rb         # ReleaseHx::WriteOps module
+    └── rhyml/                   # module RHYML
+        ├── adapter.rb           # maps from JSON using a mapping file
+        ├── change.rb            # Change class
+        ├── liquid.rb            # Liquid filters for RHYML
+        ├── release.rb           # Release class
+        ├── loaders.rb           # loads RHYML YAML or JSON from disk
+        ├── mappings/            # API -> RHYML mappings
+        └── templates/           # RHYML output templates
 ----
 // end::ai-prompt[]
@@ -2957,200 +2935,6 @@ For now it's easier to test inside the one gem that is making immediate use of t
 If the MVP pans out (which is uncertain given how weak MCP tech is and how frustrating it was to get it working with various clients), I will upstream it for use in any Ruby projects.
-[[sourcerer]]
-=== Sourcerer
-// tag::sourcerer[]
-This gem introduces a module called Sourcerer, by which AsciiDoc files can be parsed and their contents harvested for use in the application build.
-The module also handles Liquid template processing with enhanced attribute resolution capabilities.
-[NOTE]
-Sourcerer is intended to be spun off as its own gem once it successfully proves the concept in this gem.
-It will probably be called _AsciiSourcerer_ and may replace an older and unmaintained utility of mine called LiquiDoc.
-It is invoked in the Rakefile, establishing global namespaces:
-* `ReleaseHx::ATTRIBUTES[:globals]` (derived from this `README.adoc` file)
-* `ReleaseHx.read_built_snippet(:<name>)` (such as `:helpscreen`)
-The Sourcerer module also generates files like `build/docs/manpage.adoc`, which generates the formatted terminal manual, using content from `build/docs/config-reference.adoc` and this README (`tags="cli_options"`, for instance).
-It also generates an AsciiDoc-formatted configuration reference, a machine-readable JSON reference, and a sample config using the `specs/data/config-def.yml` file.
-The Sourcerer system now supports *attribute resolution* from AsciiDoc source files, enabling templates to access README attributes during rendering, ensuring configuration documentation reflects actual default values.
-Sourcerer also performs basic testing of select commands in the ASciiDoc file that have been assigned a `testable` role.
-This is mostly just showing off what Sourcerer can do, and hopefully setting into habit some best practices for my more complicated apps.
-Sourcerer is also where integration with Jekyll's extensions of Liquid occurs, bringing ReleaseHx's templating powers closely in line with how Jekyll's work, as described in <<custom-liquid>>.
-// end::sourcerer[]
-[[schemagraphy]]
-=== SchemaGraphy
-This gem also introduces a module that derives from an unreleased gem I have been working on for some years: SchemaGraphy.
-SchemaGraphy is basically an extension of YAML, enabling Ruby developers and end users more broadly to powerfully interpret and schematize YAML-based data.
-Most relevant to our case, as enabled by the `SchemaGraphy` module in this gem, is its handling of *YAML custom tags*, *attribute resolution*, and what I am calling *"`templated fields`"*, where the value of a YAML node is a String that is intended to be further processed by a templating engine like Liquid or ERB, either immediately upon ingest or later in the runtime stack, when it can be mixed with additional data.
-SchemaGraphy facilitates handling these and other quirky power-ups we use with our fully valid YAML files, so low-code users can pass some dynamism along in their YAML configs and so forth.
-[[attribute-resolution]]
-==== Attribute Resolution
-SchemaGraphy provides *attribute resolution* capabilities through the `AttributeResolver` component.
-This enables YAML files to reference external attributes using placeholder syntax like `{attribute_name}`.
-When loading YAML with `.load_yaml_with_attributes(file_path, attributes)`, SchemaGraphy:
-. Loads the YAML file normally
-. Searches for `{attribute_name}` patterns in String values
-. Replaces them with corresponding values from the provided attributes Hash
-. Returns the resolved YAML data structure
-This is used extensively in ReleaseHx's configuration system to enable single-sourcing of defaults from README attributes.
-[[custom-yaml-tag-handling]]
-==== Custom YAML Tag Handling
-To enable end users to pass meta-instructions along with their data, wherever it will make sense to do so, SchemaGraphy offers a straightforward handling system.
-Wherever you parse YAML-formatted data using `.load_yaml_with_tags`, custom-tagged Scalar nodes are converted into Maps like so:
-.User's YAML
-[source,yaml]
-----
-some_property: !liquid "{{ some_value }}"
-----
-.Converted data TagMap
-[source,yaml]
-----
-some_property:
-  __tag__: liquid
-  value: "{{ some_value }}"
-----
-Developers may therefore conditionally interpret ingested data based on user-defined classifications, wherever the developer supports such things.
-Whether a Scalar has been transformed into a TagMap, you can resolve it using:
-[source,ruby]
-----
-SchemaGraphy::TagUtils.detag(some_property)
-# Or, with a local alias
-detag = ->(val) { SchemaGraphy::TagUtils.detag(val) }
-detag(some_property)
-----
-When tags are used this way, to convey a syntax/engine for processing a template or other dynamic content, SchemaGraphy can even help us handle the content in the manner designated by the tag.
-This will come up again in <<templated-fields,the next section>>.
-[NOTE]
-This capability is only available on Scalar node values.
-For now, tags applied to other compound node types (Arrays/sequences, Maps/mappings) will be ignored by SchemaGraphy interpreters.
-[WARNING]
-When you use `load_yaml_with_tags`, you will encounter errors downstream if a user places a tag on a node where you do not expect it.
-[[templated-fields]]
-==== Templated Property Values in YAML
-We are calling these "`templated fields`" to specify that we are talking about enabling end users to use Liquid, ERB, or eventually other templating syntaxes in YAML node values.
-In so doing, developer are able to designate that the value of certain YAML nodes should be handled by a templating engine, as well as when and how.
-We'll look at how this is done in <<templated-fields-handling>>.
-For now, the point is that sometimes files like `specs/data/config-def.yml` or an API-mapping file call for a little more runtime dynamism than a low-code solution like pure YAML can support.
-Therefore, when the value of a user-configurable or environment-deterimined "`setting`" is a string that must be generated from data defined outside that field, we parse and render the template at runtime, using data from the environment or elsewhere.
-For now, it is up to our calling code to provide the appropriate variables to the template depending on the context.
-[[config-def]]
-==== Configuration Definition (CFGYML)
-All user-configurable settings have a definition, if not also a default value.
-For single-sourcing purposes, these are defined in a YAML format called CFGYML -- a configuration-file modeling language.
-The file is at `{gem_config_definition_path}`.
-It is used to establish the literal default settings carried by the application, and also to document those settings for the user.
-This practice lets developers give end users extremely detailed configurations, always well documented.
-[[attribute-resolution-in-cfgyml]]
-===== Attribute Resolution in CFGYML
-CFGYML supports *attribute resolution* from AsciiDoc files (like this README) using placeholder syntax.
-Default values can reference README attributes using `{attribute_name}` syntax:
-[source,yaml]
-----
-properties:
-  $meta:
-    properties:
-      markup:
-        dflt: "{default_markup}"  # Resolved from README.adoc :default_markup: attribute
-----
-This enables single-sourcing of configuration defaults from README attributes, ensuring that documentation and defaults stay synchronized.
-[[cfgyml-schema-structure]]
-===== CFGYML Schema Structure
-The basic schema is somewhat straightforward.
-Essentially, you're nesting Map objects within a YAML key `properties`, and each property (setting) of the defined config file can be described and constrained.
-Each setting can have a type, description (`desc`), default (`dflt`), and templated-field instructions (`templating`).
-If the setting is itself a of type `Map` (YAML "`mapping`", JSON "`object`"), its own nested parameters can be established with a `properties:` block.
-For now, you can designate the type, which you will have to enforce in your code, as well as a default value.
-[[sgyml-schemas]]
-==== SGYML Schemas
-Similar to but more complicated than CFGYML definition files are SchemaGraphy schema files.
-This is a partially specified, partially developed, and as-yet-incomplete syntax for designating and constraining YAML documents.
-ReleaseHx at this time makes active use of only minimal aspects of these schemas, all of which are contained in the `specs/` directory at the root of the gem source.
-Each of the YAML formats used by ReleaseHx has its own schema in the repo.
-The cfgyml-schema.yaml file will eventually be spun off, but the `specs/data/rhyml-schema.yaml` and `specs/data/rhyml-mapping-schema.yaml` files will stay here, defining valid formats for the types of files they apply to.
-Since SchemaGraphy itself is still unreleased, CFGYML as introduced in this gem offers only a subset of what it will enable down the road.
-Once SchemaGraphy is generally available, this gem will call it as a dependency.
-At that point, a file like `specs/data/config-def.yml` (CFGYML) will be able to impose a more detailed `$schema` for any property.
-[[templated-fields-handling]]
-==== Dynamic Templated-field Handling
-The most powerful function of SchemaGraphy schemas that is now available in ReleaseHx is the ability to instruct how templated fields should be processed at different stages, and also to parse and render them as needed.
-Templated-field handling can be established between a combination of (1) CFGYML definition files or SGYML schema files and (2) configuration files to be applied at runtime.
-Developers can designate a given property to be `type: Template` in a schema or definition.
-This "`typing`" can be a trigger for downstream parsing/rendering of the template.
-[NOTE]
-Liquid uses these two stages.
-The _parse_ operation compiles a template into a `Liquid::Template` object.
-The _render_ operation applies a dataset to the loaded template, generating a String with Liquid tags resolved.
-[[nyi]]
-==== Not Yet Implemented
-Most aspects of SchemaGraphy/SGYML are not yet available in ReleaseHx, but some are worth pointing out.
-data types::
-As of now, the `type` node of any property in `specs/data/config-def.yml` is not particularly functional.
-I do have a whole table of "`data types`" in SGYML, most of which are extremely self-explanatory and drawn from fairly platonic, cross-language terms.
-+
-However, these are entirely unenforced in ReleaseHx -- for now, data still has to be type checked explicitly in the Ruby code, and user configs are not validated against any kind of typing system.
-schema docs::
-The schema files do not yet generate complete reference docs for the subject files that they govern.
-So for instance, you'll have to read files like `specs/data/rhyml-schema.yaml` and `specs/data/rhyml-mapping-schema.yaml` directly to understand the format of RHYML files and how they are mapped to REST response payloads.
-// end::schemagraphy[]
 [[docs-deployment]]
 === Documentation Deployment

data/build/docs/release-procedure.adoc CHANGED Viewed

@@ -1,4 +1,5 @@
 = ReleaseHx Release Procedure
+include::../README.adoc[tags="global-settings"]
 This document outlines the step-by-step procedure for releasing a new version of ReleaseHx.
@@ -10,7 +11,7 @@ It covers all stages from pre-release checks to post-release verification.
 - [ ] All changes merged to `release/0.x` branch
 - [ ] Version numbers updated in README.adoc attributes (`:this_prod_vrsn_major:` through `:next_prod_vrsn_majmin:`)
-- [ ] Release notes prepared in `docs/release/0.x.y.adoc`
+- [ ] Release notes prepared in `docs/_releases/0.x.y.adoc`
 - [ ] Clean working tree on `release/0.x`
 - [ ] RubyGems credentials configured (`~/.gem/credentials`)
 - [ ] Docker Hub credentials configured (`docker login`)
@@ -123,7 +124,7 @@ Confirm Release Notes::
 [source,bash]
 ----
 # Verify release notes file exists
-ls -lh docs/release/0.x.y.adoc
+ls -lh docs/_releases/0.x.y.adoc
 ----
 [[stage-build-artifacts]]
@@ -276,6 +277,11 @@ gh release create v0.x.y pkg/releasehx-0.x.y.gem \
   --notes "See release notes at https://releasehx.docopslab.org/docs/releases/"
 ----
+[[stage-demo-repo-release]]
+=== Stage {counter:stage}: Release releasehx-demo
+Follow the release process documented in the {releasehx-demo_repo_www_url}[releasehx-demo] repo's `README.adoc`.
 [[stage-release-verification]]
 === Stage {counter:stage}: Post-Release Verification

data/build/docs/release-procedure.html CHANGED Viewed

@@ -2,7 +2,7 @@
 <section id="preamble" aria-label="Preamble"><p>This document outlines the step-by-step procedure for releasing a new version of ReleaseHx.</p>
 <p>It covers all stages from pre-release checks to post-release verification.</p></section>
-<section class="doc-section level-1"><h2 id="prerequisites">Prerequisites</h2><div class="ulist"><ul class="task-list"><li class="task-list-item"><input class="task-list-item-checkbox" type="checkbox" disabled> All changes merged to <code>release/0.x</code> branch</li><li class="task-list-item"><input class="task-list-item-checkbox" type="checkbox" disabled> Version numbers updated in README.adoc attributes (<code>:this_prod_vrsn_major:</code> through <code>:next_prod_vrsn_majmin:</code>)</li><li class="task-list-item"><input class="task-list-item-checkbox" type="checkbox" disabled> Release notes prepared in <code>docs/release/0.x.y.adoc</code></li><li class="task-list-item"><input class="task-list-item-checkbox" type="checkbox" disabled> Clean working tree on <code>release/0.x</code></li><li class="task-list-item"><input class="task-list-item-checkbox" type="checkbox" disabled> RubyGems credentials configured (<code>~/.gem/credentials</code>)</li><li class="task-list-item"><input class="task-list-item-checkbox" type="checkbox" disabled> Docker Hub credentials configured (<code>docker login</code>)</li></ul></div></section>
+<section class="doc-section level-1"><h2 id="prerequisites">Prerequisites</h2><div class="ulist"><ul class="task-list"><li class="task-list-item"><input class="task-list-item-checkbox" type="checkbox" disabled> All changes merged to <code>release/0.x</code> branch</li><li class="task-list-item"><input class="task-list-item-checkbox" type="checkbox" disabled> Version numbers updated in README.adoc attributes (<code>:this_prod_vrsn_major:</code> through <code>:next_prod_vrsn_majmin:</code>)</li><li class="task-list-item"><input class="task-list-item-checkbox" type="checkbox" disabled> Release notes prepared in <code>docs/_releases/0.x.y.adoc</code></li><li class="task-list-item"><input class="task-list-item-checkbox" type="checkbox" disabled> Clean working tree on <code>release/0.x</code></li><li class="task-list-item"><input class="task-list-item-checkbox" type="checkbox" disabled> RubyGems credentials configured (<code>~/.gem/credentials</code>)</li><li class="task-list-item"><input class="task-list-item-checkbox" type="checkbox" disabled> Docker Hub credentials configured (<code>docker login</code>)</li></ul></div></section>
 <section class="doc-section level-1"><h2 id="release-stages">Release Stages</h2><section class="doc-section level-2"><h3 id="stage-pre-flight-checks">Stage 1: Pre-flight Checks</h3><div class="dlist"><dl><dt>Verify CI/CD Setup</dt><dd><div class="listing-block"><pre class="highlight"><code class="language-bash" data-lang="bash"># Check workflows exist
 ls .github/workflows/
 # Should see: ci-cd.yml, gh-pages.yml, docs-qa.yml</code></pre></div></dd><dt>Check Current State</dt><dd><div class="listing-block"><pre class="highlight"><code class="language-bash" data-lang="bash"># Verify branch and clean status
@@ -34,7 +34,7 @@ grep ":this_prod_vrsn" README.adoc
 grep "VERSION" lib/releasehx/version.rb</code></pre></div></dd><dt>Verify Gemfile</dt><dd><div class="listing-block"><pre class="highlight"><code class="language-bash" data-lang="bash"># Ensure no local path dependencies
 grep -E "path:|git:" Gemfile
 # Should be empty</code></pre></div></dd><dt>Confirm Release Notes</dt><dd><div class="listing-block"><pre class="highlight"><code class="language-bash" data-lang="bash"># Verify release notes file exists
-ls -lh docs/release/0.x.y.adoc</code></pre></div></dd></dl></div></section>
+ls -lh docs/_releases/0.x.y.adoc</code></pre></div></dd></dl></div></section>
 <section class="doc-section level-2"><h3 id="stage-build-artifacts">Stage 2: Build Artifacts</h3><div class="dlist"><dl><dt>Build Gem Package</dt><dd><div class="listing-block"><pre class="highlight"><code class="language-bash" data-lang="bash">bundle exec rake build:gem</code></pre></div></dd><dt>Verify Gem Package</dt><dd><div class="listing-block"><pre class="highlight"><code class="language-bash" data-lang="bash">ls -lh pkg/releasehx-*.gem
 # Confirm version number is correct</code></pre></div></dd></dl></div></section>
 <section class="doc-section level-2"><h3 id="stage-create-pull-request">Stage 3: Create Pull Request</h3><div class="dlist"><dl><dt>Push Release Branch</dt><dd><div class="listing-block"><pre class="highlight"><code class="language-bash" data-lang="bash">git push origin release/0.x</code></pre></div></dd><dt>Create Pull Request</dt><dd><ul><li>Via GitHub UI:
@@ -67,14 +67,15 @@ open https://hub.docker.com/r/docopslab/releasehx</code></pre></div></dd></dl></
 See release notes at <code><a class="bare" href="https://releasehx.docopslab.org/docs/releases/">https://releasehx.docopslab.org/docs/releases/</a></code></li><li>Upload: <code>pkg/releasehx-0.x.y.gem</code></li><li>Click &#x201c;Publish release&#x201d;</li></ol></dd><dt>Via CLI (if permissions allow)</dt><dd><div class="listing-block"><pre class="highlight"><code class="language-bash" data-lang="bash">gh release create v0.x.y pkg/releasehx-0.x.y.gem \
   --title "ReleaseHx 0.x.y" \
   --notes "See release notes at https://releasehx.docopslab.org/docs/releases/"</code></pre></div></dd></dl></div></section>
-<section class="doc-section level-2"><h3 id="stage-release-verification">Stage 10: Post-Release Verification</h3><div class="dlist"><dl><dt>Test Gem Installation</dt><dd><div class="listing-block"><pre class="highlight"><code class="language-bash" data-lang="bash">gem install releasehx --version 0.x.y
+<section class="doc-section level-2"><h3 id="stage-demo-repo-release">Stage 10: Release releasehx-demo</h3><p>Follow the release process documented in the <a href="https://github.com/DocOps/releasehx-demo">releasehx-demo</a> repo&#8217;s <code>README.adoc</code>.</p></section>
+<section class="doc-section level-2"><h3 id="stage-release-verification">Stage 11: Post-Release Verification</h3><div class="dlist"><dl><dt>Test Gem Installation</dt><dd><div class="listing-block"><pre class="highlight"><code class="language-bash" data-lang="bash">gem install releasehx --version 0.x.y
 rhx --version
 # Should show: 0.x.y</code></pre></div></dd><dt>Test Docker Image</dt><dd><div class="listing-block"><pre class="highlight"><code class="language-bash" data-lang="bash">docker pull docopslab/releasehx:0.x.y
 docker run --rm docopslab/releasehx:0.x.y rhx --version
 # Should show: 0.x.y</code></pre></div></dd><dt>Verify Documentation</dt><dd><div class="listing-block"><pre class="highlight"><code class="language-bash" data-lang="bash"># Check that docs are live
 open https://releasehx.docopslab.org/docs/releases/
 # Should show 0.x.y release notes</code></pre></div></dd></dl></div></section>
-<section class="doc-section level-2"><h3 id="stage-post-release-cleanup-optional">Stage 11: Post-Release Cleanup (Optional)</h3><div class="dlist"><dl><dt>Update Version for Next Release</dt><dd>Edit <code>README.adoc</code> to increment patch version; commit on <code>release/0.x</code> branch</dd><dt>Notify Stakeholders</dt><dd>Post announcement in relevant channels; update downstream projects</dd></dl></div></section></section>
+<section class="doc-section level-2"><h3 id="stage-post-release-cleanup-optional">Stage 12: Post-Release Cleanup (Optional)</h3><div class="dlist"><dl><dt>Update Version for Next Release</dt><dd>Edit <code>README.adoc</code> to increment patch version; commit on <code>release/0.x</code> branch</dd><dt>Notify Stakeholders</dt><dd>Post announcement in relevant channels; update downstream projects</dd></dl></div></section></section>
 <section class="doc-section level-1"><h2 id="troubleshooting">Troubleshooting</h2><section class="doc-section level-2"><h3 id="docker-buildkit-issues">Docker BuildKit Issues</h3><p>If you encounter TLS certificate errors with buildx:</p>
 <div class="listing-block"><pre class="highlight"><code class="language-bash" data-lang="bash"># Remove stale builder
 docker buildx rm releasehx-builder

data/build/docs/releasehx.1 CHANGED Viewed

@@ -2,12 +2,12 @@
 .\"     Title: releasehx
 .\"    Author: [see the "AUTHOR(S)" section]
 .\" Generator: Asciidoctor 2.0.26
-.\"      Date: 2026-05-14
+.\"      Date: 2026-05-27
 .\"    Manual: \ \&
 .\"    Source: \ \&
 .\"  Language: English
 .\"
-.TH "RELEASEHX" "1" "2026-05-14" "\ \&" "\ \&"
+.TH "RELEASEHX" "1" "2026-05-27" "\ \&" "\ \&"
 .ie \n(.g .ds Aq \(aq
 .el       .ds Aq '
 .ss \n[.ss] 0

data/lib/releasehx/generated.rb CHANGED Viewed

@@ -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.26", "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-05-27", "localyear"=>"2026", "localtime"=>"11:16:48 -0400", "localdatetime"=>"2026-05-27 11:16:48 -0400", "docdate"=>"2026-05-27", "docyear"=>"2026", "doctime"=>"10:37:27 -0400", "docdatetime"=>"2026-05-27 10:37:27 -0400", "page-layout"=>"default", "page-permalink"=>"/docs/", "page-title"=>"ReleaseHx Docs", "page-nav_order"=>"1", "doctitle"=>"ReleaseHx", "this_proj_slug"=>"releasehx", "this_proj_name"=>"ReleaseHx", "docopslab_src_www_url"=>"https://raw.githubusercontent.com/DocOps", "docopslab_domain"=>"docopslab.org", "docopslab_www_url"=>"https://docopslab.org", "docopslab_io_www_url"=>"https://docopslab.github.io", "docopslab_ruby_version"=>"3.2.7", "docopslab_git_src_uri"=>"git@github.com:DocOps", "this_proj_src_www_url"=>"https://raw.githubusercontent.com/DocOps/releasehx", "this_proj_src_raw_url"=>"https://raw.githubusercontent.com/DocOps/releasehx/main", "this_proj_src_main_files_url"=>"https://raw.githubusercontent.com/DocOps/releasehx/blob/main", "this_proj_src_main_edit_url"=>"https://raw.githubusercontent.com/DocOps/releasehx/edit/main", "this_proj_src_git_uri"=>"git@github.com:DocOps/releasehx.git", "this_proj_ruby_version"=>"3.2.7", "extn"=>"", "releasehx_demo_repo"=>"https://raw.githubusercontent.com/DocOps/releasehx-demo", "this_prod_slug"=>"releasehx", "this_prod_vrsn_major"=>"0", "this_prod_vrsn_minor"=>"2", "this_prod_vrsn_majmin"=>"0.2", "this_prod_vrsn_patch"=>"0", "this_prod_vrsn"=>"0.2.0", "next_prod_vrsn"=>"0.3.0", "next_prod_vrsn_majmin"=>"0.3", "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", "docker_run_command"=>"docker run -it --rm --user $(id -u):$(id -g) -v $(pwd):/workdir docopslab/releasehx rhx", "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", "asciisourcerer_www_url"=>"https://raw.githubusercontent.com/DocOps/asciisourcerer", "schemagraphy_www_url"=>"https://raw.githubusercontent.com/DocOps/schemagraphy", "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.26", "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-05-29", "localyear"=>"2026", "localtime"=>"01:39:22 -0400", "localdatetime"=>"2026-05-29 01:39:22 -0400", "docdate"=>"2026-05-29", "docyear"=>"2026", "doctime"=>"01:35:44 -0400", "docdatetime"=>"2026-05-29 01:35:44 -0400", "page-layout"=>"default", "page-permalink"=>"/docs/", "page-title"=>"ReleaseHx Docs", "page-nav_order"=>"1", "doctitle"=>"ReleaseHx", "this_proj_slug"=>"releasehx", "this_proj_name"=>"ReleaseHx", "docopslab_src_www_url"=>"https://github.com/DocOps", "docopslab_domain"=>"docopslab.org", "docopslab_www_url"=>"https://docopslab.org", "docopslab_io_www_url"=>"https://docopslab.github.io", "docopslab_ruby_version"=>"3.2.7", "docopslab_git_src_uri"=>"git@github.com:DocOps", "docopslab_src_raw_url"=>"https://raw.githubusercontent.com/DocOps", "this_proj_src_www_url"=>"https://github.com/DocOps/releasehx", "this_proj_src_raw_url"=>"https://raw.githubusercontent.com/DocOps/releasehx", "this_proj_src_main_raw_url"=>"https://raw.githubusercontent.com/DocOps/releasehx/main", "this_proj_src_main_files_url"=>"https://github.com/DocOps/releasehx/blob/main", "this_proj_src_git_uri"=>"git@github.com:DocOps/releasehx.git", "this_proj_ruby_version"=>"3.2.7", "docs_extn"=>"", "this_prod_slug"=>"releasehx", "this_prod_name"=>"ReleaseHx", "this_prod_src_www_url"=>"https://github.com/DocOps/releasehx", "releasehx-demo_repo_www_url"=>"https://github.com/DocOps/releasehx-demo", "this_prod_vrsn_major"=>"0", "this_prod_vrsn_minor"=>"2", "this_prod_vrsn_majmin"=>"0.2", "this_prod_vrsn_patch"=>"1", "this_prod_vrsn"=>"0.2.1", "next_prod_vrsn"=>"0.3.0", "next_prod_vrsn_majmin"=>"0.3", "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", "docker_run_command"=>"docker run -it --rm --user $(id -u):$(id -g) -v $(pwd):/workdir docopslab/releasehx rhx", "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", "asciisourcerer_www_url"=>"https://github.com/DocOps/asciisourcerer", "schemagraphy_www_url"=>"https://github.com/DocOps/schemagraphy", "toc"=>"", "toclevels"=>"3", "authorcount"=>0, "toc-position"=>"content"}}
   SNIPPET_LOOKUP = {"helpscreen"=>"helpscreen.txt"}

data/lib/releasehx/rhyml/templates/rhyml-change.yaml.liquid CHANGED Viewed

@@ -9,25 +9,25 @@
 {%- endif %}
 {%- if change.parts.size > 0 %}
   {%- if change.parts.size == 1 %}
-    part: {{ change.parts[0] }}
+  part: {{ change.parts[0] }}
   {%- else %}
-    parts:
+  parts:
     {%- for part in change.parts %}
-      - {{ part }}
+    - {{ part }}
     {%- endfor %}
   {%- endif %}
 {%- endif %}
 {%- if change.hash %}
   hash: {{ change.hash }}
 {%- endif %}
-summ: |
-{{ change.summ }}
+  summ: |
+    {{ change.summ }}
 {%- if change.head %}
   head: {{ change.head }}
 {%- endif %}
-{%- if change.note and change.note.strip != '' %}
+{%- if change.note and change.note != '' %}
   note: |
-  {{ _note | indent: 6 }}
+    {{ change.note | indent: 4 }}
 {%- endif %}
 {%- if change.tags.size > 0 %}
   tags:

metadata CHANGED Viewed

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: releasehx
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - DocOpsLab