commenter 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 077fd6e045907b803d3f6b33d305bab0a4544b37ede3855fb26af1974f48385a
-  data.tar.gz: ffe50dadee86e040ce1b0b5fbb367f5e5233f4bd668248e9f473c2f9bfbccfb3
+  metadata.gz: e569c1e1d181c27078d97e4bcaa8a63c54b055aa7aff5dff88646be1237c6a65
+  data.tar.gz: 5d156b1e49c82c9b8002e47f7ab870d98e133622b4830768e02b9bf32c2db993
 SHA512:
-  metadata.gz: f3a1e36e43d5dc1d16717afab89546c3c8151c38c56c8b2f8cdbf5885a0cb5d38a34f6a6a1869892bc07a1ff0efe4f4d229a4137241565d74d4e4920555eba4b
-  data.tar.gz: d368ce137f669d56ec8c72da5c3a106c7acc95e19c8daa0c3371e09cc91c5af79e6d0af0cfd4498ac466aef96c26377c5020647b8132a59fce453574a303217a
+  metadata.gz: 66daebbb66df3c881828bccd0a36c8cb0e1c524d74c19efef579770f707a366c2f48a51b2871041dd3519db0b26ad4431f0065395b02d85685f08eed9862e39e
+  data.tar.gz: 6ea9b41315c94d87c8356350be9b55235d1dfd07e341bbbc133a6feea27b807f36ac9df05bc32430ed314c73c5b5c8a25d9e1ff5066beb0f36f90032c3b9330a

data/CONTEXT.md

@@ -31,3 +31,5 @@ keep this current when concepts sharpen.
   policy, close dispositioned issues. `GitHubSync`.
 - **Unique ID** — stage-aware identity of a comment's GitHub issue
   (`[DIS] GB-001` by default), used for duplicate detection.
+- **Out of scope** — CEN/CENELEC comment exports (decided 2026-08-29: we
+  don't have CEN; do not propose a CEN adapter again).

data/README.adoc

@@ -248,6 +248,19 @@ Comments are matched by ID and classified as new, withdrawn, repeated
 (unchanged text), or revised; a comment whose later version carries a
 disposition counts as resolved. Markdown (default) or `--format yaml`.
 
+=== Exporting the final disposition document
+
+One command for the ballot's last step — pull the observations recorded in
+GitHub issues and write the completed comment sheet:
+
+[source,shell]
+----
+commenter export comments.yaml --config github_config.yaml -o disposition.docx --shading
+----
+
+Retrieves observations from closed issues (updating the YAML), then fills the
+template with sheet metadata, comments, observations, and status shading.
+
 === Filling DOCX templates from YAML
 
 This gem contains a command-line utility to fill a DOCX template with comments

data/lib/commenter/cli.rb

@@ -110,6 +110,27 @@ module Commenter
       puts "Filled template to #{output_docx}"
     end
 
+    desc "export INPUT.yaml", "Retrieve observations from GitHub issues and write the final disposition DOCX"
+    option :config, type: :string, aliases: :c, required: true, desc: "GitHub configuration YAML file"
+    option :output, type: :string, aliases: :o, default: "disposition_comments.docx", desc: "Output DOCX file"
+    option :template, type: :string, aliases: :t, desc: "Custom template file"
+    option :shading, type: :boolean, aliases: :s, desc: "Apply status-based shading"
+    option :include_open, type: :boolean, desc: "Include observations from open issues (not recommended)"
+    def export(input_yaml)
+      retriever = GitHubIssueRetriever.new(options[:config])
+      retriever.retrieve_observations_from_yaml(input_yaml, include_open: options[:include_open])
+
+      comment_sheet = CommentSheet.from_yaml(File.read(input_yaml))
+      raise "No comments found in YAML file" if comment_sheet.comments.empty?
+
+      template_path = options[:template] || File.join(__dir__, "../../data/iso_comment_template_2012-03.docx")
+      fill_options = options.merge(
+        date: comment_sheet.date, document: comment_sheet.document, project: comment_sheet.project
+      ).compact
+      Filler.new.fill(template_path, options[:output], comment_sheet.comments, fill_options)
+      puts "Retrieved observations and wrote disposition sheet to #{options[:output]}"
+    end
+
     desc "github-create INPUT.yaml", "Create GitHub issues from comments"
     option :config, type: :string, aliases: :c, required: true, desc: "GitHub configuration YAML file"
     option :output, type: :string, aliases: :o, desc: "Output YAML file (default: update original)"

data/lib/commenter/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Commenter
-  VERSION = "0.5.0"
+  VERSION = "0.6.0"
 end

data/spec/commenter/cli_spec.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "spec_helper"
+require "zip"
 require "commenter/cli"
 require_relative "../support/osd_fixtures"
 require_relative "../support/xlsx_builder"
@@ -74,3 +75,29 @@ RSpec.describe Commenter::Cli do
     end
   end
 end
+
+RSpec.describe Commenter::Cli do
+  describe "#export" do
+    it "retrieves observations and writes the disposition DOCX" do
+      Dir.mktmpdir do |dir|
+        config = File.join(dir, "config.yaml")
+        File.write(config, { "github" => { "repository" => "t/t", "token" => "dummy" } }.to_yaml)
+        input = File.join(dir, "comments.yaml")
+        File.write(input, {
+          "version" => "2012-03", "date" => "2026-08-29", "document" => "ISO 2533:2026",
+          "comments" => [{ "id" => "DE-001", "body" => "DE", "comments" => "Remark",
+                           "observations" => "Accepted." }]
+        }.to_yaml)
+        output = File.join(dir, "disposition.docx")
+
+        described_class.start(["export", input, "--config", config, "--output", output])
+
+        expect(File).to exist(output)
+        header = Zip::File.open(output) do |zip|
+          zip.entries.find { |e| e.name == "word/header2.xml" }.get_input_stream(&:read)
+        end
+        expect(header).to include("Date: 2026-08-29")
+      end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: commenter
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Ribose