spreen-wiki 0.1.0 → 0.2.0

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: spreen-wiki
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - hayat01sh1da
@@ -22,29 +22,29 @@ files:
 - README.md
 - exe/spreen
 - lib/spreen-wiki.rb
-- lib/spreen/wiki.rb
-- lib/spreen/wiki/application.rb
-- lib/spreen/wiki/cli.rb
-- lib/spreen/wiki/configuration.rb
-- lib/spreen/wiki/home.rb
-- lib/spreen/wiki/sidebar.rb
-- lib/spreen/wiki/templates/category/english.md
-- lib/spreen/wiki/templates/category/japanese.md
-- lib/spreen/wiki/templates/owner/english.md
-- lib/spreen/wiki/templates/owner/japanese.md
-- lib/spreen/wiki/unknown_wiki_count_list_exporter.rb
-- lib/spreen/wiki/unknown_wiki_list_exporter_for_llm.rb
-- lib/spreen/wiki/version.rb
+- lib/spreen_wiki.rb
+- lib/spreen_wiki/application.rb
+- lib/spreen_wiki/cli.rb
+- lib/spreen_wiki/configuration.rb
+- lib/spreen_wiki/home.rb
+- lib/spreen_wiki/sidebar.rb
+- lib/spreen_wiki/templates/category/english.md
+- lib/spreen_wiki/templates/category/japanese.md
+- lib/spreen_wiki/templates/owner/english.md
+- lib/spreen_wiki/templates/owner/japanese.md
+- lib/spreen_wiki/unknown_wiki_count_list_exporter.rb
+- lib/spreen_wiki/unknown_wiki_list_exporter_for_llm.rb
+- lib/spreen_wiki/version.rb
 - sig/generated/spreen-wiki.rbs
-- sig/generated/spreen/wiki.rbs
-- sig/generated/spreen/wiki/application.rbs
-- sig/generated/spreen/wiki/cli.rbs
-- sig/generated/spreen/wiki/configuration.rbs
-- sig/generated/spreen/wiki/home.rbs
-- sig/generated/spreen/wiki/sidebar.rbs
-- sig/generated/spreen/wiki/unknown_wiki_count_list_exporter.rbs
-- sig/generated/spreen/wiki/unknown_wiki_list_exporter_for_llm.rbs
-- sig/generated/spreen/wiki/version.rbs
+- sig/generated/spreen_wiki.rbs
+- sig/generated/spreen_wiki/application.rbs
+- sig/generated/spreen_wiki/cli.rbs
+- sig/generated/spreen_wiki/configuration.rbs
+- sig/generated/spreen_wiki/home.rbs
+- sig/generated/spreen_wiki/sidebar.rbs
+- sig/generated/spreen_wiki/unknown_wiki_count_list_exporter.rbs
+- sig/generated/spreen_wiki/unknown_wiki_list_exporter_for_llm.rbs
+- sig/generated/spreen_wiki/version.rbs
 - sig/generated/test/application_test.rbs
 - sig/generated/test/configuration_test.rbs
 - sig/generated/test/home_test.rbs

data/lib/spreen/wiki/application.rb

@@ -1,151 +0,0 @@
-# frozen_string_literal: true
-# rbs_inline: enabled
-
-require_relative 'configuration'
-
-module Spreen
-  module Wiki
-    # Base class for the wiki-organising commands. Loads the wiki tree under
-    # base_path, groups it by Owner or Category in either English or Japanese,
-    # and exposes the resulting maps to its subclasses. Grouping criteria,
-    # languages and labels are resolved through Configuration and can be
-    # extended via a `.spreen.yml` file.
-    class Application
-      class NotImplementedError < StandardError; end
-
-      # @rbs base_path: String
-      # @rbs group_by: String
-      # @rbs language: String
-      # @rbs home_overflow: (bool | String)
-      # @rbs **options: untyped
-      # @rbs return: untyped
-      def self.run(base_path: Dir.pwd, group_by: 'Owner', language: 'English', home_overflow: 'false', **)
-        instance = new(base_path:, group_by:, language:, home_overflow:, **)
-        instance.validate!
-        instance.run
-      end
-
-      # @rbs base_path: String
-      # @rbs group_by: String
-      # @rbs language: String
-      # @rbs home_overflow: (bool | String)
-      # @rbs config: Configuration?
-      # @rbs **options: untyped
-      # @rbs return: void
-      def initialize(base_path: Dir.pwd, group_by: 'Owner', language: 'English', home_overflow: 'false',
-                     config: nil, **)
-        @base_path       = base_path
-        @group_by        = group_by
-        @language        = language
-        @home_overflow   = parse_home_overflow(home_overflow)
-        @config          = config || Configuration.new(base_path:, **)
-        @path_to_home    = File.join(base_path, 'Home.md')
-        @path_to_sidebar = File.join(base_path, '_Sidebar.md')
-        @paths_to_wikis  = Dir[File.join(base_path, '**', '*.md')]
-        @excluded_paths  = @config.excluded_dirs.flat_map { |dir| Dir[File.join(base_path, dir, '**', '*.md')] }
-      end
-
-      # @rbs return: void
-      def validate!
-        raise ArgumentError, "Invalid group_by: `#{group_by}`" unless config.group_bys.include?(group_by)
-        raise ArgumentError, "Invalid language: `#{language}`" unless config.languages(group_by).include?(language)
-
-        validate_home_overflow!
-      end
-
-      # @rbs return: untyped
-      def run
-        raise NotImplementedError, 'This method must be implemented in each subclass.'
-      end
-
-      private
-
-      attr_reader :base_path,
-                  :group_by,
-                  :language,
-                  :home_overflow,
-                  :config,
-                  :path_to_home,
-                  :path_to_sidebar,
-                  :paths_to_wikis,
-                  :excluded_paths
-
-      # @rbs return: void
-      def validate_home_overflow!
-        return if [true, false].include?(home_overflow)
-
-        raise ArgumentError, "Invalid home_overflow: `#{home_overflow}` must be boolean"
-      end
-
-      # @rbs raw: (bool | String)
-      # @rbs return: (bool | String)
-      def parse_home_overflow(raw)
-        case raw
-        when 'true'  then true
-        when 'false' then false
-        else raw
-        end
-      end
-
-      # @rbs return: Array[String]
-      def target_paths
-        @target_paths ||= paths_to_wikis.reject do |path_to_wiki|
-          path_to_wiki == path_to_home ||
-            path_to_wiki == path_to_sidebar ||
-            excluded_paths.include?(path_to_wiki)
-        end
-      end
-
-      # @rbs return: Regexp
-      def target_regexp
-        @target_regexp ||= config.target_regexp(group_by)
-      end
-
-      # @rbs return: String
-      def no_declaration
-        @no_declaration ||= config.no_declaration(group_by, language)
-      end
-
-      # @rbs return: Hash[String, Array[String]]
-      def wiki_maps_with_namespace
-        @wiki_maps_with_namespace ||= begin
-          named      = Hash.new { |hash, namespace| hash[namespace] = [] } #: Hash[String, Array[String]]
-          undeclared = Hash.new { |hash, namespace| hash[namespace] = [] } #: Hash[String, Array[String]]
-          target_paths.each { |target_path| populate_namespace(target_path, named, undeclared) }
-          named.sort.to_h.merge(undeclared)
-        end
-      end
-
-      # @rbs target_path: String
-      # @rbs named: Hash[String, Array[String]]
-      # @rbs undeclared: Hash[String, Array[String]]
-      # @rbs return: void
-      def populate_namespace(target_path, named, undeclared)
-        return unless File.exist?(target_path)
-
-        namespace = namespace_for(target_path)
-        bucket    = namespace == no_declaration ? undeclared : named
-        bucket[namespace] << File.basename(target_path)
-      end
-
-      # @rbs target_path: String
-      # @rbs return: String
-      def namespace_for(target_path)
-        declaration = File.open(target_path, &:gets)
-        return no_declaration unless declaration&.start_with?(target_regexp)
-
-        declaration.chomp.gsub(target_regexp, '')
-      end
-
-      # @rbs return: Hash[String, Array[String]]
-      def owned_wiki_maps
-        @owned_wiki_maps ||= wiki_maps_with_namespace.select { |namespace, _| namespace.include?('@') }
-      end
-
-      # @rbs return: Hash[String, Array[String]]
-      def plain_wiki_maps
-        @plain_wiki_maps ||= wiki_maps_with_namespace.reject { |namespace, _| namespace.include?('@') }
-      end
-    end
-  end
-end

data/lib/spreen/wiki/cli.rb

@@ -1,159 +0,0 @@
-# frozen_string_literal: true
-# rbs_inline: enabled
-
-require 'optparse'
-require_relative 'version'
-require_relative 'home'
-require_relative 'sidebar'
-require_relative 'unknown_wiki_count_list_exporter'
-require_relative 'unknown_wiki_list_exporter_for_llm'
-
-module Spreen
-  module Wiki
-    # Command line interface behind the `spreen` executable:
-    # `spreen <update|count-report|llm-export> [options]`.
-    class CLI
-      HELP = <<~HELP
-        Usage: spreen <command> [options]
-
-        Commands:
-          update        Regenerate Home.md and _Sidebar.md from the wiki tree
-          count-report  Export a count report of the unknown-namespace wikis
-          llm-export    Export the unknown-namespace wiki list for an LLM
-          version       Print the version
-
-        Run `spreen <command> --help` to list the command's options.
-      HELP
-
-      # Flags shared by every command, mapped to the keyword arguments of the
-      # underlying classes. --exclude and the per-command flags are wired up
-      # separately because they need a type or a fixed value.
-      COMMON_OPTIONS = {
-        '--path PATH' => [:base_path, 'Path to the wiki clone (default: current directory)'],
-        '--group-by GROUP_BY' => [:group_by, 'Grouping criteria (default: Owner)'],
-        '--language LANGUAGE' => [:language, 'Language of the labels (default: English)'],
-        '--org ORGANISATION' => [:organisation, 'GitHub organisation/user hosting the wiki'],
-        '--repo REPOSITORY' => [:repository, 'GitHub repository whose wiki is organised'],
-        '--wiki-url URL' => [:wiki_url, 'Wiki URL (overrides the one derived from --org/--repo)'],
-        '--template-dir DIR' => [:template_dir, 'Directory of <group_by>/<language>.md Home templates'],
-        '--config FILE' => [:config_path, 'Config file path (default: <path>/.spreen.yml)']
-      }.freeze
-
-      # @rbs argv: Array[String]
-      # @rbs return: Integer
-      def self.start(argv = ARGV)
-        new(argv).run
-      end
-
-      # @rbs argv: Array[String]
-      # @rbs return: void
-      def initialize(argv)
-        @argv    = argv.dup
-        @options = { base_path: Dir.pwd, group_by: 'Owner', language: 'English', home_overflow: 'false' }
-      end
-
-      # @rbs return: Integer
-      def run
-        command = argv.shift
-        case command
-        when 'update', 'count-report', 'llm-export' then execute(command)
-        when 'version', '--version', '-v'           then print_version
-        when nil, 'help', '--help', '-h'            then print_help(command)
-        else unknown_command(command)
-        end
-      end
-
-      private
-
-      attr_reader :argv, :options
-
-      # @rbs command: String
-      # @rbs return: Integer
-      def execute(command)
-        parser(command).parse!(argv)
-        __send__(command.tr('-', '_'))
-        0
-      rescue ArgumentError, OptionParser::ParseError => e
-        warn e.message
-        1
-      end
-
-      # @rbs return: Integer
-      def print_version
-        puts VERSION
-        0
-      end
-
-      # @rbs command: String?
-      # @rbs return: Integer
-      def print_help(command)
-        puts HELP
-        command.nil? ? 1 : 0
-      end
-
-      # @rbs command: String
-      # @rbs return: Integer
-      def unknown_command(command)
-        warn "Unknown command: `#{command}`"
-        warn HELP
-        1
-      end
-
-      # @rbs return: void
-      def update
-        wiki_url = Home.run(**options)
-        Sidebar.run(**options)
-        puts 'Updated Home.md and _Sidebar.md.'
-        puts "Check them out at '#{wiki_url}' !!" if wiki_url
-      end
-
-      # @rbs return: void
-      def count_report
-        count_list_by_namespace, path_to_export = UnknownWikiCountListExporter.run(**options)
-        puts count_list_by_namespace
-        puts "Exported the unknown wiki count report to '#{path_to_export}'."
-      end
-
-      # @rbs return: void
-      def llm_export
-        path_to_export = UnknownWikiListExporterForLLM.run(**options)
-        puts "Exported the unknown wiki list for LLM to '#{path_to_export}'."
-      end
-
-      # @rbs command: String
-      # @rbs return: OptionParser
-      def parser(command)
-        OptionParser.new("Usage: spreen #{command} [options]") do |opt|
-          add_common_options(opt)
-          add_command_options(opt, command)
-        end
-      end
-
-      # @rbs opt: OptionParser
-      # @rbs return: void
-      def add_common_options(opt)
-        COMMON_OPTIONS.each do |flag, (key, description)|
-          opt.on(flag, description) { |value| options[key] = value }
-        end
-        opt.on('--exclude DIR1,DIR2', Array, 'Directories to skip while scanning') do |dirs|
-          options[:excluded_dirs] = dirs
-        end
-      end
-
-      # @rbs opt: OptionParser
-      # @rbs command: String
-      # @rbs return: void
-      def add_command_options(opt, command)
-        if command == 'update'
-          opt.on('--overflow', 'Split Home into per-namespace pages under wikis-by-owner/') do
-            options[:home_overflow] = 'true'
-          end
-        else
-          opt.on('--output FILENAME', 'Export filename (relative to --path unless absolute)') do |filename|
-            options[:output] = filename
-          end
-        end
-      end
-    end
-  end
-end

data/lib/spreen/wiki/configuration.rb

@@ -1,217 +0,0 @@
-# frozen_string_literal: true
-# rbs_inline: enabled
-
-require 'yaml'
-
-module Spreen
-  module Wiki
-    # Resolves the runtime configuration for a wiki checkout. Every value is
-    # looked up with the same precedence: explicit keyword argument, then the
-    # `.spreen.yml` file under base_path (or config_path), then the
-    # ORGANISATION_NAME environment variable (organisation only), then the
-    # built-in defaults.
-    class Configuration
-      CONFIG_FILENAME = '.spreen.yml'
-      EMPTY_HASH = {}.freeze #: Hash[String, untyped]
-      DEFAULT_TEMPLATE_DIR = File.expand_path(File.join(__dir__.to_s, 'templates'))
-      DEFAULT_EXCLUDED_DIRS = %w[spreen-wiki wikis-by-owner].freeze
-
-      # Built-in labels: how the first line of a wiki page is parsed (regexp),
-      # which namespace collects pages without a declaration (no_declaration),
-      # which namespaces the count report covers (unknown_namespaces) and which
-      # namespace the LLM export targets (llm_target_namespace). A config file
-      # can override any of these, add languages or add group_by criteria.
-      DEFAULT_LABELS = {
-        'Owner' => {
-          'regexp' => '[Oo]wner:\s?',
-          'languages' => {
-            'English' => {
-              'no_declaration' => 'Unowned',
-              'unknown_namespaces' => ['Unknown Owner nor Necessity', 'Unowned but Necessary', 'Unowned'],
-              'llm_target_namespace' => 'Unknown Owner nor Necessity'
-            },
-            'Japanese' => {
-              'no_declaration' => 'Owner記名なし',
-              'unknown_namespaces' => [
-                'Ownerチームが不明だが必要なページ群',
-                'Ownerチーム・要or不要が不明なページ群',
-                'Owner記名なし'
-              ],
-              'llm_target_namespace' => 'Ownerチーム・要or不要が不明なページ群'
-            }
-          }
-        },
-        'Category' => {
-          'regexp' => '[Cc]ategory:\s?',
-          'languages' => {
-            'English' => {
-              'no_declaration' => 'Uncategorised',
-              'unknown_namespaces' => ['Uncategorised'],
-              'llm_target_namespace' => 'Uncategorised'
-            },
-            'Japanese' => {
-              'no_declaration' => 'Category記載なし',
-              'unknown_namespaces' => ['Category記載なし'],
-              'llm_target_namespace' => 'Category記載なし'
-            }
-          }
-        }
-      }.freeze
-
-      attr_reader :organisation, :repository, :wiki_url, :owner_base_url, :excluded_dirs, :template_dir
-
-      # @rbs!
-      #   @organisation: String?
-      #   @repository: String?
-      #   @wiki_url: String?
-      #   @owner_base_url: String?
-      #   @excluded_dirs: Array[String]
-      #   @template_dir: String
-      #   @file: Hash[String, untyped]
-      #   @labels: Hash[String, untyped]
-
-      # @rbs base_path: String
-      # @rbs config_path: String?
-      # @rbs organisation: String?
-      # @rbs repository: String?
-      # @rbs wiki_url: String?
-      # @rbs owner_base_url: String?
-      # @rbs excluded_dirs: Array[String]?
-      # @rbs template_dir: String?
-      # @rbs return: void
-      def initialize(base_path:, config_path: nil, organisation: nil, repository: nil, wiki_url: nil,
-                     owner_base_url: nil, excluded_dirs: nil, template_dir: nil)
-        @file           = load_file(config_path || File.join(base_path, CONFIG_FILENAME))
-        @organisation   = resolve_organisation(organisation)
-        @repository     = resolve(repository, 'repository')
-        @wiki_url       = resolve_wiki_url(wiki_url)
-        @owner_base_url = resolve_owner_base_url(owner_base_url)
-        @excluded_dirs  = excluded_dirs || file.fetch('exclude', DEFAULT_EXCLUDED_DIRS)
-        @template_dir   = template_dir || file.fetch('template_dir', DEFAULT_TEMPLATE_DIR)
-        @labels         = deep_merge(DEFAULT_LABELS, file.fetch('labels', EMPTY_HASH))
-      end
-
-      # @rbs return: Array[String]
-      def group_bys
-        labels.keys
-      end
-
-      # @rbs group_by: String
-      # @rbs return: Array[String]
-      def languages(group_by)
-        label_for(group_by).fetch('languages', EMPTY_HASH).keys
-      end
-
-      # @rbs group_by: String
-      # @rbs return: Regexp
-      def target_regexp(group_by)
-        Regexp.new(label_for(group_by).fetch('regexp', ''))
-      end
-
-      # @rbs group_by: String
-      # @rbs language: String
-      # @rbs return: String
-      def no_declaration(group_by, language)
-        language_labels(group_by, language).fetch('no_declaration', '')
-      end
-
-      # @rbs group_by: String
-      # @rbs language: String
-      # @rbs return: Array[String]
-      def unknown_namespaces(group_by, language)
-        language_labels(group_by, language).fetch('unknown_namespaces', [])
-      end
-
-      # @rbs group_by: String
-      # @rbs language: String
-      # @rbs return: String
-      def llm_target_namespace(group_by, language)
-        language_labels(group_by, language).fetch('llm_target_namespace', '')
-      end
-
-      # @rbs group_by: String
-      # @rbs language: String
-      # @rbs return: String
-      def path_to_template(group_by, language)
-        File.join(template_dir, group_by.downcase, "#{language.downcase}.md")
-      end
-
-      private
-
-      attr_reader :file, :labels
-
-      # Treats empty strings the same as nil so that callers can pass values
-      # straight from optional environment variables or CLI flags.
-      # @rbs value: String?
-      # @rbs return: String?
-      def presence(value)
-        value unless value.nil? || value.empty?
-      end
-
-      # @rbs explicit: String?
-      # @rbs key: String
-      # @rbs return: String?
-      def resolve(explicit, key)
-        presence(explicit) || presence(file[key])
-      end
-
-      # @rbs explicit: String?
-      # @rbs return: String?
-      def resolve_organisation(explicit)
-        resolve(explicit, 'organisation') || presence(ENV.fetch('ORGANISATION_NAME', nil))
-      end
-
-      # @rbs explicit: String?
-      # @rbs return: String?
-      def resolve_wiki_url(explicit)
-        resolve(explicit, 'wiki_url') || default_wiki_url
-      end
-
-      # @rbs explicit: String?
-      # @rbs return: String?
-      def resolve_owner_base_url(explicit)
-        resolve(explicit, 'owner_base_url') || default_owner_base_url
-      end
-
-      # @rbs path: String
-      # @rbs return: Hash[String, untyped]
-      def load_file(path)
-        return {} unless File.exist?(path)
-
-        YAML.safe_load_file(path) || {}
-      end
-
-      # @rbs group_by: String
-      # @rbs return: Hash[String, untyped]
-      def label_for(group_by)
-        labels.fetch(group_by, EMPTY_HASH)
-      end
-
-      # @rbs group_by: String
-      # @rbs language: String
-      # @rbs return: Hash[String, untyped]
-      def language_labels(group_by, language)
-        label_for(group_by).fetch('languages', EMPTY_HASH).fetch(language, EMPTY_HASH)
-      end
-
-      # @rbs return: String?
-      def default_wiki_url
-        "https://github.com/#{organisation}/#{repository}/wiki" if organisation && repository
-      end
-
-      # @rbs return: String?
-      def default_owner_base_url
-        "https://github.com/orgs/#{organisation}/teams/" if organisation
-      end
-
-      # @rbs base: Hash[String, untyped]
-      # @rbs override: Hash[String, untyped]
-      # @rbs return: Hash[String, untyped]
-      def deep_merge(base, override)
-        base.merge(override) do |_key, old_value, new_value|
-          old_value.is_a?(Hash) && new_value.is_a?(Hash) ? deep_merge(old_value, new_value) : new_value
-        end
-      end
-    end
-  end
-end

data/lib/spreen/wiki/home.rb

@@ -1,102 +0,0 @@
-# frozen_string_literal: true
-# rbs_inline: enabled
-
-require 'fileutils'
-require_relative 'application'
-
-module Spreen
-  module Wiki
-    # Generates the wiki Home page, optionally splitting per-owner content out
-    # into `wikis-by-owner/<owner>.md` when home_overflow is enabled. Returns
-    # the configured wiki URL (if any) so callers can point at the result.
-    class Home < Application
-      # @rbs return: String?
-      def run
-        home_overflow ? write_concise_home_passage : write_home_passage
-        config.wiki_url
-      end
-
-      private
-
-      # @rbs return: String
-      def path_to_wikis_by_owner
-        @path_to_wikis_by_owner ||= File.join(base_path, 'wikis-by-owner')
-      end
-
-      # @rbs return: String
-      def path_to_home_template
-        path = config.path_to_template(group_by, language)
-        unless File.exist?(path)
-          raise ArgumentError, "Missing Home template: `#{path}`. Ship one there or configure template_dir."
-        end
-
-        path
-      end
-
-      # @rbs return: Array[String]
-      def home_passage
-        @home_passage ||= File.readlines(path_to_home_template).append("\n")
-      end
-
-      # @rbs return: void
-      def write_home_passage
-        FileUtils.rm_rf(path_to_wikis_by_owner)
-        owned_wiki_maps.each { |namespace, wikis| append_block(home_passage, namespace, wikis, owned: true) }
-        plain_wiki_maps.each { |namespace, wikis| append_block(home_passage, namespace, wikis, owned: false) }
-        File.write(path_to_home, home_passage.join.chomp)
-      end
-
-      # @rbs return: void
-      def write_concise_home_passage
-        FileUtils.mkdir_p(path_to_wikis_by_owner)
-        write_per_namespace_files
-        write_home_table_of_contents
-      end
-
-      # @rbs return: void
-      def write_per_namespace_files
-        owned_wiki_maps.each { |namespace, wikis| write_overflow_block(namespace, wikis, owned: true) }
-        plain_wiki_maps.each { |namespace, wikis| write_overflow_block(namespace, wikis, owned: false) }
-      end
-
-      # @rbs return: void
-      def write_home_table_of_contents
-        (owned_wiki_maps.keys + plain_wiki_maps.keys).each { |namespace| home_passage << "- [[#{namespace}]]\n" }
-        home_passage << "\n"
-        File.write(path_to_home, home_passage.join.chomp)
-      end
-
-      # @rbs passage: Array[String]
-      # @rbs namespace: String
-      # @rbs wikis: Array[String]
-      # @rbs owned: bool
-      # @rbs return: void
-      def append_block(passage, namespace, wikis, owned:)
-        passage << "#{heading_for(namespace, owned:)}\n"
-        passage << "\n"
-        wikis.each { |wiki| passage << "- [[#{wiki.gsub('.md', '')}]]\n" }
-        passage << "\n"
-      end
-
-      # @rbs namespace: String
-      # @rbs wikis: Array[String]
-      # @rbs owned: bool
-      # @rbs return: void
-      def write_overflow_block(namespace, wikis, owned:)
-        scratch = [] #: Array[String]
-        append_block(scratch, namespace, wikis, owned:)
-        File.write(File.join(path_to_wikis_by_owner, "#{namespace}.md"), scratch.join.chomp)
-      end
-
-      # @rbs namespace: String
-      # @rbs owned: bool
-      # @rbs return: String
-      def heading_for(namespace, owned:)
-        owner_base_url = config.owner_base_url
-        return "## #{namespace}" unless owned && owner_base_url
-
-        "## [#{namespace}](#{owner_base_url + namespace.delete('@')})"
-      end
-    end
-  end
-end