factorix 0.8.1 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 93bb2e6485db7f9e122f3b7380bfe4d4785f55f20aa7b9bf3db784ffd7a1b42d
-  data.tar.gz: be85a4df980159362e3b3d774865b819375f89ee93c5d293fd234a45d7367d18
+  metadata.gz: 970e619a2c58b6ee5c7502adc6803469accf6ee618e41e580df5f950a8b2ed15
+  data.tar.gz: 6651e0dea495831ede26d577410722d5ea08542c6ee2516772c413ddec1b7b55
 SHA512:
-  metadata.gz: d224c1f72f0d1311ca9afc8dbf8b56a04edbb7fdb1129b68515dc4c14a95cdf90ff0f444930e7d823ea3e60cf0b98c23a8e7c623eeca512a0bb408bae0a00f6b
-  data.tar.gz: 062a2b3f368975e4dddbb3c9f1941ed68447af5301b5bf7a24d88afd5f36cecf499a3bf049be8f29ce80a62f7462d5fdfdfbd23327a12df70ed60c57062fe1d4
+  metadata.gz: 6d10a143153a82c1d2b969d928ce85dd22c8c9bf95c793fe27e3287cc5f7408a00fcec47d839295d40390655667a3b1b6e1ab8e76947c9ce98eec8455f87438f
+  data.tar.gz: 2feeb57d5fc6835ee674f3c024b7ef5a4710e3b4f496dc7ada5ecc76add61e1b0fc3dcc3c7e95aea2ae57d131b28d124da04c83bb7ca1c04869067cac251e4c7

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 ## [Unreleased]
 
+## [0.9.0] - 2026-02-20
+
+### Added
+
+- Add `mod changelog add` command to add entries to MOD changelog
+- Add `mod changelog check` command to validate MOD changelog structure
+- Add `mod changelog release` command to convert Unreleased section to a versioned section
+
 ## [0.8.1] - 2026-02-17
 
 ### Added

data/completion/_factorix.bash

@@ -20,7 +20,7 @@ _factorix() {
   local commands="version man launch path download mod cache completion"
 
   # mod subcommands
-  local mod_commands="check list show enable disable install uninstall update download upload edit search sync image settings"
+  local mod_commands="changelog check list show enable disable install uninstall update download upload edit search sync image settings"
 
   # cache subcommands
   local cache_commands="stat evict"
@@ -170,6 +170,43 @@ _factorix() {
               COMPREPLY=($(compgen -f -X '!*.zip' -- "$cur"))
             fi
             ;;
+          changelog)
+            if [[ $cword -eq 3 ]]; then
+              COMPREPLY=($(compgen -W "add check release" -- "$cur"))
+            else
+              case "${words[3]}" in
+                add)
+                  if [[ "$prev" == "--version" ]]; then
+                    COMPREPLY=($(compgen -W "Unreleased" -- "$cur"))
+                  elif [[ "$prev" == "--category" ]]; then
+                    local categories="'Major Features' Features 'Minor Features' Graphics Sounds Optimizations Balancing 'Combat Balancing' 'Circuit Network' Changes Bugfixes Modding Scripting Gui Control Translation Debug 'Ease of use' Info Locale Compatibility"
+                    COMPREPLY=($(compgen -W "$categories" -- "$cur"))
+                  elif [[ "$prev" == "--changelog" ]]; then
+                    COMPREPLY=($(compgen -f -- "$cur"))
+                  elif [[ "$cur" == -* ]]; then
+                    COMPREPLY=($(compgen -W "$global_opts --version --category --changelog" -- "$cur"))
+                  fi
+                  ;;
+                check)
+                  if [[ "$prev" == "--changelog" ]] || [[ "$prev" == "--info-json" ]]; then
+                    COMPREPLY=($(compgen -f -- "$cur"))
+                  elif [[ "$cur" == -* ]]; then
+                    COMPREPLY=($(compgen -W "$global_opts --release --changelog --info-json" -- "$cur"))
+                  fi
+                  ;;
+                release)
+                  if [[ "$prev" == "--changelog" ]] || [[ "$prev" == "--info-json" ]]; then
+                    COMPREPLY=($(compgen -f -- "$cur"))
+                  elif [[ "$cur" == -* ]]; then
+                    COMPREPLY=($(compgen -W "$global_opts --version --date --changelog --info-json" -- "$cur"))
+                  fi
+                  ;;
+                *)
+                  COMPREPLY=($(compgen -W "$global_opts" -- "$cur"))
+                  ;;
+              esac
+            fi
+            ;;
           image)
             if [[ $cword -eq 3 ]]; then
               COMPREPLY=($(compgen -W "$image_commands" -- "$cur"))

data/completion/_factorix.fish

@@ -64,6 +64,40 @@ function __factorix_using_subcommand
     return 1
 end
 
+# Helper function to check 3-level nested subcommand (e.g., mod changelog add)
+function __factorix_using_sub_subcommand
+    set -l cmd (commandline -opc)
+    set -l argc (count $cmd)
+
+    if test $argc -lt 4
+        return 1
+    end
+
+    set -l parent $argv[1]
+    set -l sub $argv[2]
+    set -l subsub $argv[3]
+
+    set -l level 0
+    for i in (seq 2 $argc)
+        switch $cmd[$i]
+            case '-*'
+                continue
+            case '*'
+                if test $level -eq 0
+                    test "$cmd[$i]" = "$parent"; or return 1
+                    set level 1
+                else if test $level -eq 1
+                    test "$cmd[$i]" = "$sub"; or return 1
+                    set level 2
+                else
+                    test "$cmd[$i]" = "$subsub"; and return 0
+                    return 1
+                end
+        end
+    end
+    return 1
+end
+
 # Disable file completion by default
 complete -c factorix -f
 
@@ -125,6 +159,7 @@ complete -c factorix -n "__factorix_using_command mod" -a upload -d 'Upload MOD
 complete -c factorix -n "__factorix_using_command mod" -a edit -d 'Edit MOD metadata on Factorio MOD Portal'
 complete -c factorix -n "__factorix_using_command mod" -a search -d 'Search MODs on Factorio MOD Portal'
 complete -c factorix -n "__factorix_using_command mod" -a sync -d 'Sync MOD states from a save file'
+complete -c factorix -n "__factorix_using_command mod" -a changelog -d 'MOD changelog management'
 complete -c factorix -n "__factorix_using_command mod" -a image -d 'MOD image management'
 complete -c factorix -n "__factorix_using_command mod" -a settings -d 'MOD settings management'
 
@@ -195,6 +230,27 @@ complete -c factorix -n "__factorix_using_subcommand mod sync" -s y -l yes -d 'S
 complete -c factorix -n "__factorix_using_subcommand mod sync" -s j -l jobs -d 'Number of parallel downloads' -r
 complete -c factorix -n "__factorix_using_subcommand mod sync" -ra '(__fish_complete_suffix .zip)'
 
+# mod changelog subcommands
+complete -c factorix -n "__factorix_using_subcommand mod changelog" -a add -d 'Add an entry to MOD changelog'
+complete -c factorix -n "__factorix_using_subcommand mod changelog" -a check -d 'Validate MOD changelog structure'
+complete -c factorix -n "__factorix_using_subcommand mod changelog" -a release -d 'Release Unreleased changelog section with a version'
+
+# mod changelog add options
+complete -c factorix -n "__factorix_using_sub_subcommand mod changelog add" -l version -d 'Version (X.Y.Z or Unreleased)' -ra 'Unreleased'
+complete -c factorix -n "__factorix_using_sub_subcommand mod changelog add" -l category -d 'Category name' -xa "'Major Features' Features 'Minor Features' Graphics Sounds Optimizations Balancing 'Combat Balancing' 'Circuit Network' Changes Bugfixes Modding Scripting Gui Control Translation Debug 'Ease of use' Info Locale Compatibility"
+complete -c factorix -n "__factorix_using_sub_subcommand mod changelog add" -l changelog -d 'Path to changelog file' -rF
+
+# mod changelog check options
+complete -c factorix -n "__factorix_using_sub_subcommand mod changelog check" -l release -d 'Disallow Unreleased section'
+complete -c factorix -n "__factorix_using_sub_subcommand mod changelog check" -l changelog -d 'Path to changelog file' -rF
+complete -c factorix -n "__factorix_using_sub_subcommand mod changelog check" -l info-json -d 'Path to info.json file' -rF
+
+# mod changelog release options
+complete -c factorix -n "__factorix_using_sub_subcommand mod changelog release" -l version -d 'Version (X.Y.Z)' -r
+complete -c factorix -n "__factorix_using_sub_subcommand mod changelog release" -l date -d 'Release date (YYYY-MM-DD)' -r
+complete -c factorix -n "__factorix_using_sub_subcommand mod changelog release" -l changelog -d 'Path to changelog file' -rF
+complete -c factorix -n "__factorix_using_sub_subcommand mod changelog release" -l info-json -d 'Path to info.json file' -rF
+
 # mod image subcommands
 complete -c factorix -n "__factorix_using_subcommand mod image" -a list -d 'List MOD images'
 complete -c factorix -n "__factorix_using_subcommand mod image" -a add -d 'Add an image to a MOD'

data/completion/_factorix.zsh

@@ -147,6 +147,7 @@ _factorix_mod() {
         'edit:Edit MOD metadata on Factorio MOD Portal'
         'search:Search MODs on Factorio MOD Portal'
         'sync:Sync MOD states from a save file'
+        'changelog:MOD changelog management'
         'image:MOD image management'
         'settings:MOD settings management'
       )
@@ -257,6 +258,9 @@ _factorix_mod() {
             '(-j --jobs)'{-j,--jobs}'[Number of parallel downloads]:jobs:' \
             '1:save file:_files -g "*.zip"'
           ;;
+        changelog)
+          _factorix_mod_changelog
+          ;;
         image)
           _factorix_mod_image
           ;;
@@ -268,6 +272,61 @@ _factorix_mod() {
   esac
 }
 
+_factorix_mod_changelog() {
+  local context state state_descr line
+  typeset -A opt_args
+
+  local -a global_opts
+  global_opts=(
+    '(-c --config-path)'{-c,--config-path}'[Path to configuration file]:config file:_files'
+    '--log-level[Set log level]:level:(debug info warn error fatal)'
+    '(-q --quiet)'{-q,--quiet}'[Suppress non-essential output]'
+  )
+
+  _arguments -C \
+    '1:subcommand:->subcommand' \
+    '*::arg:->args'
+
+  case $state in
+    subcommand)
+      local -a subcommands
+      subcommands=(
+        'add:Add an entry to MOD changelog'
+        'check:Validate MOD changelog structure'
+        'release:Release Unreleased changelog section with a version'
+      )
+      _describe -t subcommands 'changelog subcommand' subcommands
+      ;;
+    args)
+      case $line[1] in
+        add)
+          _arguments \
+            $global_opts \
+            '--version[Version (X.Y.Z or Unreleased)]:version:(Unreleased)' \
+            '--category[Category name]:category:(Major\ Features Features Minor\ Features Graphics Sounds Optimizations Balancing Combat\ Balancing Circuit\ Network Changes Bugfixes Modding Scripting Gui Control Translation Debug Ease\ of\ use Info Locale Compatibility)' \
+            '--changelog[Path to changelog file]:changelog file:_files' \
+            '*:entry text:'
+          ;;
+        check)
+          _arguments \
+            $global_opts \
+            '--release[Disallow Unreleased section]' \
+            '--changelog[Path to changelog file]:changelog file:_files' \
+            '--info-json[Path to info.json file]:info.json file:_files'
+          ;;
+        release)
+          _arguments \
+            $global_opts \
+            '--version[Version (X.Y.Z)]:version:' \
+            '--date[Release date (YYYY-MM-DD)]:date:' \
+            '--changelog[Path to changelog file]:changelog file:_files' \
+            '--info-json[Path to info.json file]:info.json file:_files'
+          ;;
+      esac
+      ;;
+  esac
+}
+
 _factorix_mod_image() {
   local context state state_descr line
   typeset -A opt_args

data/lib/factorix/changelog.rb

@@ -0,0 +1,192 @@
+# frozen_string_literal: true
+
+require "parslet"
+
+module Factorix
+  # Parser and writer for Factorio MOD changelog.txt files
+  #
+  # @see https://wiki.factorio.com/Tutorial:Mod_changelog_format
+  class Changelog
+    SEPARATOR = ("-" * 99).freeze
+    public_constant :SEPARATOR
+
+    UNRELEASED = "Unreleased"
+    public_constant :UNRELEASED
+
+    Section = Data.define(:version, :date, :categories)
+    private_class_method :new
+
+    # Load a changelog from a file
+    #
+    # @param path [Pathname] path to changelog.txt
+    # @return [Changelog]
+    # @raise [ChangelogParseError] if the file content is malformed
+    def self.load(path)
+      return new([]) unless path.exist?
+
+      parse(path.read)
+    end
+
+    # Parse changelog text content
+    #
+    # @param text [String] changelog content
+    # @return [Changelog]
+    # @raise [ChangelogParseError] if the content is malformed
+    def self.parse(text)
+      tree = Grammar.new.parse(text)
+      sections = Transform.new.apply(tree)
+      new(Array(sections))
+    rescue Parslet::ParseFailed => e
+      raise ChangelogParseError, e.message
+    end
+
+    # @param sections [Array<Section>] changelog sections
+    def initialize(sections)
+      @sections = sections
+    end
+
+    # @return [Array<Section>]
+    attr_reader :sections
+
+    # Save the changelog to a file
+    #
+    # @param path [Pathname] path to write
+    # @return [void]
+    def save(path)
+      path.write(to_s)
+    end
+
+    # Add an entry to the changelog
+    #
+    # @param version [MODVersion, String] target version (or Changelog::UNRELEASED)
+    # @param category [String] category name
+    # @param entry [String] entry text
+    # @return [void]
+    # @raise [InvalidArgumentError] if the entry already exists
+    def add_entry(version, category, entry)
+      raise InvalidArgumentError, "entry must not be blank" if entry.match?(/\A[[:space:]]*\z/)
+
+      section = find_or_create_section(version)
+      entries = (section.categories[category] ||= [])
+      raise InvalidArgumentError, "duplicate entry: #{entry}" if entries.include?(entry)
+
+      entries << entry
+    end
+
+    # Replace the first section (Unreleased) with a versioned section
+    # @param version [MODVersion] target version
+    # @param date [String] release date (YYYY-MM-DD)
+    # @return [void]
+    def release_section(version, date:)
+      raise InvalidOperationError, "First section is not Unreleased" unless @sections.first&.version == UNRELEASED
+      raise InvalidOperationError, "Version #{version} already exists" if @sections.any? {|s| s.version == version }
+
+      unreleased = @sections.first
+      @sections[0] = Section[version:, date:, categories: unreleased.categories]
+    end
+
+    # Render the changelog as a string
+    #
+    # @return [String]
+    def to_s
+      @sections.map {|section| format_section(section) }.join("\n") + "\n"
+    end
+
+    private def find_or_create_section(version)
+      @sections.find {|s| s.version == version } || create_section(version)
+    end
+
+    private def create_section(version)
+      section = Section[version:, date: nil, categories: {}]
+      @sections.unshift(section)
+      section
+    end
+
+    private def format_section(section)
+      lines = [SEPARATOR]
+      lines << "Version: #{section.version}"
+      lines << "Date: #{section.date}" if section.date
+      section.categories.each do |cat, entries|
+        lines << "  #{cat}:"
+        entries.each do |entry|
+          first, *rest = entry.split("\n")
+          lines << "    - #{first}"
+          rest.each {|line| lines << "      #{line}" }
+        end
+      end
+      lines.join("\n")
+    end
+
+    # Parslet grammar for Factorio changelog.txt
+    class Grammar < Parslet::Parser
+      rule(:newline) { str("\r\n") | str("\n") }
+      rule(:rest_of_line) { (newline.absent? >> any).repeat(1) }
+      rule(:blank_line) { match[' \t'].repeat >> newline }
+
+      rule(:separator) { str("-").repeat(99, 99) >> newline }
+
+      rule(:version_line) { str("Version: ") >> rest_of_line.as(:version) >> newline }
+      rule(:date_line) { str("Date: ") >> rest_of_line.as(:date) >> newline }
+
+      # Category name: everything between "  " and ":\n", captured via negative lookahead
+      rule(:category_line) { str("  ") >> ((str(":\n") | str(":\r\n")).absent? >> any).repeat(1).as(:category) >> str(":") >> newline }
+
+      rule(:entry_first_line) { str("    - ") >> rest_of_line.as(:first) >> newline }
+      rule(:continuation_line) { str("      ") >> rest_of_line >> newline }
+      rule(:entry) { entry_first_line >> continuation_line.repeat.as(:rest) }
+
+      rule(:category_block) { category_line >> entry.repeat(1).as(:entries) }
+
+      rule(:section) do
+        separator >>
+          version_line >>
+          date_line.maybe.as(:date_line) >>
+          blank_line.repeat >>
+          category_block.repeat.as(:categories) >>
+          blank_line.repeat
+      end
+
+      rule(:changelog) { section.repeat(1).as(:sections) }
+
+      root(:changelog)
+    end
+    private_constant :Grammar
+
+    # Transform parsed tree into Section objects
+    class Transform < Parslet::Transform
+      rule(first: simple(:first), rest: subtree(:rest)) do
+        continuations = rest.is_a?(Array) ? rest : [rest]
+        parts = [first.to_s]
+        continuations.each {|c| parts << c.to_s.delete_prefix("      ") if c.is_a?(Parslet::Slice) }
+        parts.join("\n")
+      end
+
+      rule(category: simple(:cat), entries: subtree(:entries)) do
+        entry_list = entries.is_a?(Array) ? entries : [entries]
+        {cat.to_s => entry_list}
+      end
+
+      rule(version: simple(:ver), date_line: subtree(:date_data), categories: subtree(:cats)) do
+        ver_str = ver.to_s.strip
+        version = ver_str.casecmp("unreleased").zero? ? UNRELEASED : MODVersion.from_string(ver_str)
+
+        date = date_data.is_a?(Hash) ? date_data[:date].to_s.strip : nil
+
+        categories = {}
+        cat_list = cats.is_a?(Array) ? cats : [cats]
+        cat_list.each do |cat_hash|
+          next unless cat_hash.is_a?(Hash)
+
+          categories.merge!(cat_hash)
+        end
+
+        Section[version:, date:, categories:]
+      end
+
+      rule(sections: subtree(:secs)) do
+        secs.is_a?(Array) ? secs : [secs]
+      end
+    end
+    private_constant :Transform
+  end
+end

data/lib/factorix/cli/commands/mod/changelog/add.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Factorix
+  class CLI
+    module Commands
+      module MOD
+        module Changelog
+          # Add an entry to a MOD's changelog.txt
+          class Add < Base
+            desc "Add an entry to MOD changelog"
+
+            option :version, default: "Unreleased", desc: "Version (X.Y.Z or Unreleased)"
+            option :category, required: true, desc: "Category (e.g., Features, Bugfixes)"
+            option :changelog, default: "changelog.txt", desc: "Path to changelog file"
+
+            argument :entry, type: :array, required: true, desc: "Entry text"
+
+            # @param version [String] version string (X.Y.Z or Unreleased)
+            # @param category [String] category name
+            # @param entry [Array<String>] entry text words
+            # @param changelog [String] path to changelog file
+            # @return [void]
+            def call(version:, category:, entry:, changelog: "changelog.txt", **)
+              target_version = version.casecmp("unreleased").zero? ? Factorix::Changelog::UNRELEASED : MODVersion.from_string(version)
+              path = Pathname(changelog)
+              log = Factorix::Changelog.load(path)
+              log.add_entry(target_version, category, entry.join(" "))
+              log.save(path)
+              say "Added entry to #{target_version} [#{category}]", prefix: :success
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/factorix/cli/commands/mod/changelog/check.rb

@@ -0,0 +1,99 @@
+# frozen_string_literal: true
+
+module Factorix
+  class CLI
+    module Commands
+      module MOD
+        module Changelog
+          # Validate the structure of a MOD changelog file
+          class Check < Base
+            desc "Validate MOD changelog structure"
+
+            option :release, type: :flag, default: false, desc: "Disallow Unreleased section"
+            option :changelog, default: "changelog.txt", desc: "Path to changelog file"
+            option :info_json, default: "info.json", desc: "Path to info.json file"
+
+            # @param release [Boolean] disallow Unreleased section
+            # @param changelog [String] path to changelog file
+            # @param info_json [String] path to info.json file
+            # @return [void]
+            def call(release: false, changelog: "changelog.txt", info_json: "info.json", **)
+              errors = []
+
+              log = parse_changelog(Pathname(changelog), errors)
+              return report(errors) unless log
+
+              validate_unreleased_position(log, errors)
+              validate_version_order(log, errors)
+
+              if release
+                validate_release_mode(log, Pathname(info_json), errors)
+              end
+
+              report(errors)
+            end
+
+            private def parse_changelog(path, errors)
+              Factorix::Changelog.load(path)
+            rescue ChangelogParseError => e
+              errors << "Failed to parse changelog: #{e.message}"
+              nil
+            end
+
+            private def validate_unreleased_position(log, errors)
+              log.sections.each_with_index do |section, index|
+                next unless section.version == Factorix::Changelog::UNRELEASED
+                next if index.zero?
+
+                errors << "Unreleased section must be the first section"
+                break
+              end
+            end
+
+            private def validate_version_order(log, errors)
+              versioned = log.sections.select {|s| s.version.is_a?(MODVersion) }
+              versioned.each_cons(2) do |a, b|
+                next if a.version > b.version
+
+                errors << "Versions are not in descending order: #{a.version} should be greater than #{b.version}"
+              end
+            end
+
+            private def validate_release_mode(log, info_json_path, errors)
+              if log.sections.any? {|s| s.version == Factorix::Changelog::UNRELEASED }
+                errors << "Unreleased section is not allowed in release mode"
+              end
+
+              validate_info_json_version(log, info_json_path, errors)
+            end
+
+            private def validate_info_json_version(log, info_json_path, errors)
+              unless info_json_path.exist?
+                errors << "info.json not found: #{info_json_path}"
+                return
+              end
+
+              info = InfoJSON.from_json(info_json_path.read)
+              first_versioned = log.sections.find {|s| s.version.is_a?(MODVersion) }
+              return unless first_versioned
+
+              return if info.version == first_versioned.version
+
+              errors << "info.json version (#{info.version}) does not match first changelog version (#{first_versioned.version})"
+            end
+
+            private def report(errors)
+              if errors.empty?
+                say "Changelog is valid", prefix: :success
+              else
+                say "Changelog validation failed:", prefix: :error
+                errors.each {|msg| say "  - #{msg}" }
+                raise ValidationError, "Changelog validation failed"
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/factorix/cli/commands/mod/changelog/release.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Factorix
+  class CLI
+    module Commands
+      module MOD
+        module Changelog
+          # Convert the Unreleased section to a versioned release
+          class Release < Base
+            desc "Convert Unreleased changelog section to a versioned section"
+
+            option :version, desc: "Version (X.Y.Z, default: from info.json)"
+            option :date, desc: "Release date (YYYY-MM-DD, default: today UTC)"
+            option :changelog, default: "changelog.txt", desc: "Path to changelog file"
+            option :info_json, default: "info.json", desc: "Path to info.json file"
+
+            # @param version [String, nil] version string (X.Y.Z)
+            # @param date [String, nil] release date (YYYY-MM-DD)
+            # @param changelog [String] path to changelog file
+            # @param info_json [String] path to info.json file
+            # @return [void]
+            def call(version: nil, date: nil, changelog: "changelog.txt", info_json: "info.json", **)
+              parsed_version = resolve_version(version, Pathname(info_json))
+              release_date = date || Time.now.utc.strftime("%Y-%m-%d")
+              path = Pathname(changelog)
+              log = Factorix::Changelog.load(path)
+              log.release_section(parsed_version, date: release_date)
+              log.save(path)
+              say "Converted Unreleased to #{parsed_version} (#{release_date})", prefix: :success
+            end
+
+            private def resolve_version(version, info_json_path)
+              if version
+                MODVersion.from_string(version)
+              else
+                info = InfoJSON.from_json(info_json_path.read)
+                info.version
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/factorix/cli.rb

@@ -19,6 +19,9 @@ module Factorix
     register "path", Commands::Path
     register "download", Commands::Download
     register "completion", Commands::Completion
+    register "mod changelog add", Commands::MOD::Changelog::Add
+    register "mod changelog check", Commands::MOD::Changelog::Check
+    register "mod changelog release", Commands::MOD::Changelog::Release
     register "mod check", Commands::MOD::Check
     register "mod list", Commands::MOD::List
     register "mod show", Commands::MOD::Show

data/lib/factorix/errors.rb

@@ -69,6 +69,8 @@ module Factorix
   # MOD settings file errors
   class MODSectionNotFoundError < FileFormatError; end
 
+  class ChangelogParseError < FileFormatError; end
+
   # =====================================
   # Domain layer errors
   # =====================================

data/lib/factorix/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Factorix
-  VERSION = "0.8.1"
+  VERSION = "0.9.0"
   public_constant :VERSION
 end

data/sig/factorix/changelog.rbs

@@ -0,0 +1,34 @@
+# RBS type signature file
+# NOTE: Do not include private method definitions in RBS files.
+#       Only public interfaces should be documented here.
+
+module Factorix
+  class Changelog
+    class Section < Data
+      attr_reader version: MODVersion | String
+      attr_reader date: String?
+      attr_reader categories: Hash[String, Array[String]]
+
+      def self.[]: (version: MODVersion | String, date: String?, categories: Hash[String, Array[String]]) -> Section
+    end
+
+    SEPARATOR: String
+    UNRELEASED: String
+
+    def self.load: (Pathname path) -> Changelog
+
+    def self.parse: (String text) -> Changelog
+
+    private def self.new: (Array[Section] sections) -> instance
+
+    def save: (Pathname path) -> void
+
+    def add_entry: (MODVersion | String version, String category, String entry) -> void
+
+    def release_section: (MODVersion version, date: String) -> void
+
+    attr_reader sections: Array[Section]
+
+    def to_s: () -> String
+  end
+end

data/sig/factorix/cli/commands/mod/changelog/add.rbs

@@ -0,0 +1,17 @@
+# RBS type signature file
+# NOTE: Do not include private method definitions in RBS files.
+#       Only public interfaces should be documented here.
+
+module Factorix
+  class CLI
+    module Commands
+      module MOD
+        module Changelog
+          class Add < Base
+            def call: (?version: String, category: String, entry: Array[String], ?changelog: String, **untyped) -> void
+          end
+        end
+      end
+    end
+  end
+end

data/sig/factorix/cli/commands/mod/changelog/check.rbs

@@ -0,0 +1,17 @@
+# RBS type signature file
+# NOTE: Do not include private method definitions in RBS files.
+#       Only public interfaces should be documented here.
+
+module Factorix
+  class CLI
+    module Commands
+      module MOD
+        module Changelog
+          class Check < Base
+            def call: (?release: bool, ?changelog: String, ?info_json: String, **untyped) -> void
+          end
+        end
+      end
+    end
+  end
+end

data/sig/factorix/cli/commands/mod/changelog/release.rbs

@@ -0,0 +1,17 @@
+# RBS type signature file
+# NOTE: Do not include private method definitions in RBS files.
+#       Only public interfaces should be documented here.
+
+module Factorix
+  class CLI
+    module Commands
+      module MOD
+        module Changelog
+          class Release < Base
+            def call: (?version: String?, ?date: String?, ?changelog: String, ?info_json: String, **untyped) -> void
+          end
+        end
+      end
+    end
+  end
+end

data/sig/factorix/errors.rbs

@@ -76,6 +76,9 @@ module Factorix
   class MODSectionNotFoundError < FileFormatError
   end
 
+  class ChangelogParseError < FileFormatError
+  end
+
   # =====================================
   # Domain layer errors
   # =====================================

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: factorix
 version: !ruby/object:Gem::Version
-  version: 0.8.1
+  version: 0.9.0
 platform: ruby
 authors:
 - OZAWA Sakuro
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-02-17 00:00:00.000000000 Z
+date: 2026-02-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -255,6 +255,7 @@ files:
 - lib/factorix/cache/file_system.rb
 - lib/factorix/cache/redis.rb
 - lib/factorix/cache/s3.rb
+- lib/factorix/changelog.rb
 - lib/factorix/cli.rb
 - lib/factorix/cli/commands/backup_support.rb
 - lib/factorix/cli/commands/base.rb
@@ -267,6 +268,9 @@ files:
 - lib/factorix/cli/commands/download_support.rb
 - lib/factorix/cli/commands/launch.rb
 - lib/factorix/cli/commands/man.rb
+- lib/factorix/cli/commands/mod/changelog/add.rb
+- lib/factorix/cli/commands/mod/changelog/check.rb
+- lib/factorix/cli/commands/mod/changelog/release.rb
 - lib/factorix/cli/commands/mod/check.rb
 - lib/factorix/cli/commands/mod/disable.rb
 - lib/factorix/cli/commands/mod/download.rb
@@ -362,6 +366,7 @@ files:
 - sig/factorix/cache/file_system.rbs
 - sig/factorix/cache/redis.rbs
 - sig/factorix/cache/s3.rbs
+- sig/factorix/changelog.rbs
 - sig/factorix/cli.rbs
 - sig/factorix/cli/commands/base.rbs
 - sig/factorix/cli/commands/cache/evict.rbs
@@ -371,6 +376,9 @@ files:
 - sig/factorix/cli/commands/confirmable.rbs
 - sig/factorix/cli/commands/download_support.rbs
 - sig/factorix/cli/commands/launch.rbs
+- sig/factorix/cli/commands/mod/changelog/add.rbs
+- sig/factorix/cli/commands/mod/changelog/check.rbs
+- sig/factorix/cli/commands/mod/changelog/release.rbs
 - sig/factorix/cli/commands/mod/check.rbs
 - sig/factorix/cli/commands/mod/disable.rbs
 - sig/factorix/cli/commands/mod/download.rbs