asciidoc-pubkit 0.6.3 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bce892bd925140f338afaba12cce7b039e5863d7b082ef6ddb7c18b3930a5b9f
-  data.tar.gz: 6490e4783d15787651083e083bd57687d01a446d47c69a5202638e8493b9d541
+  metadata.gz: 5e6439ccb97f49f7e31290cb8d60b1f361cf444889ac0631cdd1f9e28f8a0d9c
+  data.tar.gz: 484ff3e7ac4475ea693ff7d5751bc34e1537b66dda90bb7d425bb55acb467322
 SHA512:
-  metadata.gz: 3bf0e618fc48a4c45f67429e1b74f3996a3d6aa2d71029bc87e112091551d3f612f1b4b2c1b5ed8e78f314fd87be412175b8009c00c741f711f902d0c9ffe89e
-  data.tar.gz: 2827a75447bac7e95bf5161bac061a3d5a089f7d0390801bbfe22a51851cdf206b4a6e512d61074e4021481aac01c2d3fd63bf7caf8db3f46e8fd8628fd30b06
+  metadata.gz: 9ccf0130e06770e7b12774385daab670fffde6a128e83af1d67300ada91ea6c15fc281645cfae6da6b7b009cca36d01429287ee36461c11f2d43c439d8307fe5
+  data.tar.gz: f70b717d0633729647ac733670604e3d6ace15354efc31167f8af8994b62531ddba1c74f6456c293ccf16bbee4833ddbd2efb655c520151edee6b6559d94ca0c

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.8.0 — 2026-10-01
+
+- Add explicit `replace check`, `replace diff`, and `replace apply` commands for
+  mapped running prose using a strict subset of prh-format YAML rules. Protect
+  blocks and recognized inline spans, reject overlapping edits, test rule specs,
+  and validate staged sources before applying replacements without MeCab or AI.
+
 ## 0.6.3 — 2026-10-01
 
 - Summarize review and scoring features at the start of the README architecture

data/README.md

@@ -7,9 +7,10 @@
 
 A toolkit for authoring and reviewing AsciiDoc books.
 
-Version 0.6.3 provides shared Japanese technical writing criteria, an authoring
+Version 0.8.0 provides shared Japanese technical writing criteria, an authoring
 prompt, separate prose and heading review prompts, manuscript scoring, and
-baseline verification for edited manuscripts.
+baseline verification for edited manuscripts, plus explicit prose-only mechanical
+replacements using a limited prh-format rule set.
 The CLI, diagnostics, documentation, and generated instructions are in English.
 Japanese text is retained in manuscript excerpts, rule dictionaries, and fixtures.
 
@@ -18,7 +19,9 @@ Japanese text is retained in manuscript excerpts, rule dictionaries, and fixture
 Version 0.6.3 adds separate heading review with `review scan --scope headings`.
 See [Heading review](#heading-review).
 
-The CLI does not automatically rewrite manuscripts or publish books. EPUB, image,
+Version 0.8.0 adds explicit prose replacements with `replace apply`;
+see [Prose replacements](#prose-replacements). Review and scoring do not edit
+manuscripts. The CLI does not publish books. EPUB, image,
 and book scaffolding commands are planned extensions, not available features.
 
 Ruby 3.2 or later is required. Asciidoctor is installed as a gem dependency.
@@ -33,7 +36,7 @@ configured model provider. No scoring mode edits manuscripts.
 
 Version 0.1.1 added morphological analysis. Version 0.1.0 used literal matching.
 
-The CLI has `writing` and `review` command groups. Both default to `--lang ja`.
+The CLI has `writing`, `review`, and `replace` command groups. All default to `--lang ja`.
 Language-specific criteria live under `data/writing/<language>/`; review rules
 use `data/review-rules.<language>.yml`. Writing and review have separate lists
 of supported languages, so a future writing language need not imply review
@@ -83,7 +86,7 @@ Add the gem to your project's `Gemfile` to manage its version with Bundler:
 
 ```ruby
 source 'https://rubygems.org'
-gem 'asciidoc-pubkit', '~> 0.6.3'
+gem 'asciidoc-pubkit', '~> 0.8.0'
 ```
 
 Then install dependencies and run the CLI through Bundler:
@@ -105,7 +108,7 @@ git clone https://github.com/cybergarage/asciidoc-pubkit.git
 cd asciidoc-pubkit
 bundle install
 gem build asciidoc-pubkit.gemspec
-gem install ./asciidoc-pubkit-0.6.3.gem
+gem install ./asciidoc-pubkit-0.8.0.gem
 asciidoc-pubkit --version
 ```
 
@@ -129,7 +132,7 @@ asciidoc-pubkit writing prompt --lang ja --output writing-prompt.md
 ```
 
 For example, `--lang en` exits with an unsupported-language error. No English
-review or writing criteria are shipped in 0.6.3.
+review or writing criteria are shipped in 0.8.0.
 
 For a small trial, use `examples/book.adoc` as the scan input. Its Japanese
 paragraphs deliberately contain review candidates; its code block must remain
@@ -750,6 +753,107 @@ Regex patterns are not interpreted in glossary or allow-list entries. Unknown
 configuration keys are rejected. A bare `mecab_command` is resolved through PATH;
 use an absolute path for an explicit executable override.
 
+## Prose replacements
+
+Available starting with version 0.8.0.
+It applies author-supplied mechanical replacement rules without MeCab or an AI
+CLI. Review candidates and glossary variants remain advisory and are never
+implicitly applied. Replacement rules are separate from review rules.
+
+```sh
+asciidoc-pubkit replace check book.adoc --rules replacements.yml
+asciidoc-pubkit replace diff book.adoc --rules replacements.yml
+asciidoc-pubkit replace apply book.adoc --rules replacements.yml
+```
+
+`check` reports original text, proposed text, rule IDs (`rule-1`, etc.), source
+paths, one-based Unicode lines/columns, and a coverage-notice count. Its exit code
+is 1 when replacements are available, 0 otherwise. `diff` previews unified diffs
+without editing; it requires the external `diff` command. `apply` explicitly
+authorizes source replacement without prompting. Successful diff/apply commands
+return 0; invalid rules, conflicts, unsafe edits, and input/output failures return
+2. Check/diff accept `--output` for a new file only; apply rejects `--output`.
+
+All three accept `--lang ja`, `--base-dir`, `--config`, and `--only` (an included
+source file). Normal configuration discovery and `review.base_dir`, `language`,
+`attributes`, and `exclude` control parsing and selection. `--rules` is required;
+`review.rules` and glossary entries do not supply replacement rules. There are
+no built-in replacement rules and no automatic search for `prh.yml`.
+
+### Limited prh-format rules
+
+The supported format is a strict subset of [prh](https://github.com/prh/prh):
+
+```yaml
+version: 1
+rules:
+  - expected: '®'
+    pattern: '&reg;'
+  - expected: '($1)'
+    pattern: '/（([^（）\r\n]+)）/'
+    specs:
+      - from: '設定（任意）'
+        to: '設定(任意)'
+  - expected: '/'
+    patterns:
+      - '／'
+```
+
+The root contains exactly `version: 1` and `rules`. Each rule requires a string
+`expected` (empty strings permit deletion) and exactly one of `pattern` (a
+nonempty string) or `patterns` (a nonempty array of nonempty strings). Optional
+`specs` is an array of exact `from`/`to` string pairs, validated on load. Specs
+exercise the rule on plain text, not AsciiDoc selection or inline protection.
+
+Strings not beginning with `/` match literally. `/.../` denotes a regex with no
+flags; all occurrences are collected. The implementation uses Ruby regexes with
+a timeout and accepts a limited common syntax: character classes, ordinary
+captures, noncapturing groups, lookarounds, alternatives, anchors, quantifiers,
+and the escapes `\n`, `\r`, `\t`, `\d`, `\D`, `\s`, `\S`, `\w`, `\W`
+and escaped punctuation. Ruby regex character-class behavior applies; this is
+not a JavaScript regex engine or a promise of full prh equivalence. Engine-specific
+groups/escapes and flags are rejected. A leading literal slash must be expressed
+as an escaped regex, for example `/\//`. Zero-length matches are rejected.
+
+Replacement strings support `$1` through `$99` for existing capture groups and
+`$$` for a literal dollar sign. Unsupported dollar references are rejected when
+matched. Missing optional captures expand to empty strings. YAML single quotes
+are recommended to keep backslashes literal. Unknown fields, including `imports`,
+`options`, and `regexpMustEmpty`, and omitted patterns are rejected rather than
+ignored. Regex flags and prh's automatic pattern generation are not supported.
+
+### Selection and preservation
+
+Only unambiguously source-mapped running prose in the existing default review
+scope is eligible. Headings, lists, tables, quotations, listing/source, literal,
+and passthrough blocks are excluded. Recognized inline code, quotations, URLs,
+macros, and attribute references are protected by the existing conservative
+inline heuristic, not a complete inline parser. A match overlapping any protected
+span is skipped; matching is performed on the original text, never on blanked
+placeholders. Backtick-to-bold and list-marker conversions are outside this scope.
+
+Candidates are calculated once against the original sources; replacement results
+are not searched again. Overlapping edits are conflicts, not resolved by rule
+order. Matches/results containing line breaks are rejected. Source files retain
+UTF-8 bytes, original line endings, and unrelated content; repeated include
+occurrences must not create overlapping edits.
+
+Before presenting a plan, the complete captured source set is copied to temporary
+staging and reparsed. Parsing diagnostics, structural changes, new/deleted protected
+inline tokens, and protected-content/source-membership changes reject the plan.
+Relative includes within the base directory are supported. Absolute includes and
+includes whose paths depend on the original filesystem may fail staged validation;
+they are not rewritten or silently accepted. Symlink entrypoints are rejected.
+
+Apply stages all changed files beside their destinations, checks all captured
+source bytes against the plan, and renames the prepared files into place while
+preserving permission bits. An ordinary installation error restores sources
+already installed. This is not a crash-atomic transaction across multiple files;
+keep manuscripts under version control and avoid concurrent edits during apply.
+No review session is created or replaced. Existing sessions retain their original
+baselines; applying replacements can make a session stale for prompt generation.
+Mechanical validation does not establish semantic correctness.
+
 ## Rules and coverage
 
 | Rule | Severity | Purpose |
@@ -840,12 +944,12 @@ reports analyzer changes instead of treating results from different dictionaries
 as directly comparable. Prompt generation uses saved evidence and does not need
 MeCab. Changed rules or dictionary settings require a new scan.
 
-Sessions from earlier tool versions are not compatible with 0.6.3 (session schema 2). Keep the original baseline for
+Sessions from earlier tool versions are not compatible with 0.8.0 (session schema 2). Keep the original baseline for
 an ongoing review and finish it with the original version, or start a new review
 pass in a different directory:
 
 ```sh
-asciidoc-pubkit review scan book.adoc --output .pubkit/review-0.6.3
+asciidoc-pubkit review scan book.adoc --output .pubkit/review-0.8.0
 ```
 
 Severity describes review priority, not proof of an error. There is no AI-authorship

data/examples/replacements.yml

@@ -0,0 +1,17 @@
+version: 1
+
+rules:
+  - expected: '®'
+    pattern: '®'
+    specs:
+      - from: '製品®'
+        to: '製品®'
+  - expected: '($1)'
+    pattern: '/（([^（）\r\n]+)）/'
+    specs:
+      - from: '設定（任意）'
+        to: '設定(任意)'
+  - expected: ' '
+    pattern: '　'
+  - expected: '/'
+    pattern: '／'

data/lib/asciidoc_pubkit/cli.rb

@@ -12,6 +12,9 @@ module AsciidocPubkit
         review score FILE      Score Japanese prose; optionally use a local AI CLI
         review prompt SESSION  Generate an English review prompt with Japanese source excerpts
         review verify SESSION  Compare edited sources with the saved baseline
+        replace check FILE     Report prose-only replacement candidates
+        replace diff FILE      Preview prose replacements as a unified diff
+        replace apply FILE     Validate and apply explicit replacement rules
 
       Options:
         --help                 Show help (also supported for each command)
@@ -19,7 +22,7 @@ module AsciidocPubkit
 
       Use --lang ja with writing commands and review commands. Other review and
       writing languages are not supported yet and return an error.
-      No command edits manuscripts. review score --agent explicitly invokes a
+      Only replace apply edits manuscripts. review score --agent explicitly invokes a
       local Codex or Claude CLI, which may connect to its configured AI service.
     TEXT
 
@@ -29,21 +32,27 @@ module AsciidocPubkit
         out.puts VERSION
         return 0
       end
-      if args.empty? || args == ['--help'] || args == ['-h'] || %w[review writing].any? { |group| args == [group, '--help'] }
+      if args.empty? || args == ['--help'] || args == ['-h'] || %w[review writing replace].any? { |group| args == [group, '--help'] }
         out.puts HELP
         return 0
       end
       group, command = args.shift(2)
       valid = (group == 'review' && %w[scan score prompt verify].include?(command)) ||
-              (group == 'writing' && %w[criteria prompt].include?(command))
+              (group == 'writing' && %w[criteria prompt].include?(command)) ||
+              (group == 'replace' && %w[check diff apply].include?(command))
       raise Error, 'Unknown command. Use --help.' unless valid
       options = { attributes: {} }
       parser = OptionParser.new do |opts|
-        input_name = group == 'writing' ? '' : (%w[scan score].include?(command) ? ' FILE' : ' SESSION')
+        input_name = group == 'writing' ? '' : ((group == 'replace' || %w[scan score].include?(command)) ? ' FILE' : ' SESSION')
         opts.banner = "Usage: asciidoc-pubkit #{group} #{command} [options]#{input_name}"
         opts.on('-o', '--output PATH', group == 'review' && command == 'scan' ? 'New session directory (default: .pubkit/review for prose, .pubkit/headings for headings)' : 'New output file (default: standard output)') { |v| options[:output] = v }
         opts.on('--lang LANG', 'Language (ja only in this release)') { |v| options[:language] = v }
-        if group == 'review' && %w[scan score].include?(command)
+        if group == 'replace'
+          opts.on('--rules FILE', 'Required prh-format replacement rules (limited compatibility)') { |v| options[:rules] = v }
+          opts.on('--base-dir DIR', 'Set the Asciidoctor base directory') { |v| options[:base_dir] = v }
+          opts.on('--config FILE', 'Use review parsing configuration and exclusions') { |v| options[:config] = v }
+          opts.on('--only FILE', 'Select one included file') { |v| options[:only] = v }
+        elsif group == 'review' && %w[scan score].include?(command)
           if command == 'scan'
             opts.on('--scope SCOPE', 'prose (default) or headings; separate review sessions') { |v| options[:scope] = v }
             opts.on('--heading-rules FILE', 'Replace default heading rules with a YAML rule set') { |v| options[:heading_rules] = v }
@@ -85,6 +94,15 @@ module AsciidocPubkit
       end
       raise Error, 'Exactly one input is required. Use --help.' unless args.length == 1
       Language.validate!(options[:language], operation: 'review') if options[:language]
+      if group == 'replace'
+        raise Error, 'replace apply does not accept --output.' if command == 'apply' && options[:output]
+        replacement = Replacement.new(args.first, options)
+        content = command == 'diff' ? replacement.diff : replacement.report
+        replacement.apply if command == 'apply'
+        content += "Applied #{replacement.candidates.length} replacements.\n" if command == 'apply'
+        output(content, options[:output], out)
+        return command == 'check' && !replacement.candidates.empty? ? 1 : 0
+      end
       if command == 'score'
         if options[:output] && (File.exist?(options[:output]) || File.symlink?(options[:output]))
           raise Error, "Output already exists: #{options[:output]}"

data/lib/asciidoc_pubkit/replacement.rb

@@ -0,0 +1,210 @@
+# frozen_string_literal: true
+
+require 'tmpdir'
+require 'tempfile'
+require 'open3'
+
+module AsciidocPubkit
+  class ReplacementRules
+    def self.load(path)
+      data = YAML.safe_load(AsciidocPubkit.read_text(path), permitted_classes: [], aliases: false)
+      RuleSet.mapping(data, %w[version rules], 'Replacement rules')
+      raise Error, 'Replacement version must be integer 1.' unless data['version'].is_a?(Integer) && data['version'] == 1
+      raise Error, 'rules must be an array.' unless data['rules'].is_a?(Array)
+      data['rules'].each_with_index.map do |rule, index|
+        unless rule.is_a?(Hash) && (rule.keys - %w[expected pattern patterns specs]).empty? &&
+               rule['expected'].is_a?(String) && (rule.key?('pattern') ^ rule.key?('patterns'))
+          raise Error, "Rule #{index + 1} requires expected and exactly one of pattern or patterns; unsupported keys are rejected."
+        end
+        patterns = rule.key?('pattern') ? [rule['pattern']] : rule['patterns']
+        unless patterns.is_a?(Array) && !patterns.empty? && patterns.all? { |p| p.is_a?(String) && !p.empty? }
+          raise Error, 'Replacement patterns must be nonempty strings.'
+        end
+        compiled = patterns.map do |pattern|
+          if pattern.start_with?('/')
+            match = pattern.match(%r{\A/(.*)/([a-z]*)\z}m)
+            raise Error, 'Regex flags are unsupported; omit flags (all matches are collected).' unless match && match[2].empty?
+            body = match[1]
+            # Deliberately small common JavaScript/Ruby subset; Ruby-only escapes
+            # and engine-specific groups must not silently change JS semantics.
+            if body.match?(/\\[^\\\/.*+?()\[\]{}^$|nrtdDsSwW-]/) || body.match?(/\(\?(?![:=!]|<[=!])/) || body.include?('&&')
+              raise Error, 'Unsupported regex syntax in replacement rule.'
+            end
+            Regexp.new(body.gsub('\\/', '/'), timeout: 0.1)
+          else
+            Regexp.new(Regexp.escape(pattern), timeout: 0.1)
+          end
+        end
+        compiled.each do |regex|
+          regex.match('') # Detect common empty matches; runtime checks cover contextual ones.
+          raise Error, 'Zero-length replacement matches are unsupported.' if regex.match('')
+        end
+        specs = rule.fetch('specs', [])
+        raise Error, 'specs must be an array.' unless specs.is_a?(Array)
+        specs.each do |spec|
+          RuleSet.mapping(spec, %w[from to], 'Replacement spec')
+          raise Error, 'Spec from/to must be strings.' unless spec.values.all? { |v| v.is_a?(String) }
+          result = spec['from'].dup
+          edits = matches(spec['from'], compiled, rule['expected'])
+          reject_overlaps!(edits)
+          edits.reverse_each { |edit| result[edit[:start]...edit[:finish]] = edit[:after] }
+          raise Error, "Replacement spec failed for rule #{index + 1}." unless result == spec['to']
+        end
+        { id: "rule-#{index + 1}", patterns: compiled, expected: rule['expected'] }
+      end
+    rescue RegexpError, Regexp::TimeoutError => e
+      raise Error, "Invalid replacement regex: #{e.message}"
+    end
+
+    def self.expand(template, match)
+      template.gsub(/\$\$|\$[1-9][0-9]?|\$./) do |ref|
+        if ref == '$$'
+          '$'
+        elsif ref.match?(/\A\$[1-9][0-9]?\z/) && ref[1..].to_i < match.length
+          match[ref[1..].to_i] || ''
+        else
+          raise Error, "Unsupported replacement reference: #{ref}"
+        end
+      end
+    end
+
+    def self.matches(text, patterns, expected)
+      patterns.flat_map do |regex|
+        text.to_enum(:scan, regex).map do
+          match = Regexp.last_match
+          raise Error, 'Zero-length replacement matches are unsupported.' if match.begin(0) == match.end(0)
+          { start: match.begin(0), finish: match.end(0), before: match[0], after: expand(expected, match) }
+        end
+      end.reject { |edit| edit[:before] == edit[:after] }.uniq.sort_by { |edit| edit[:start] }
+    rescue Regexp::TimeoutError
+      raise Error, 'Replacement regex timed out.'
+    end
+
+    def self.reject_overlaps!(edits)
+      edits.sort_by { |edit| edit[:start] }.each_cons(2) do |left, right|
+        raise Error, 'Conflicting replacement candidates overlap; revise the rules.' if left[:finish] > right[:start]
+      end
+    end
+  end
+
+  class Replacement
+    attr_reader :candidates
+
+    def initialize(entry, options)
+      raise Error, 'Replacement commands require --rules FILE.' unless options[:rules]
+      raise Error, 'Replacement entry must not be a symlink.' if File.symlink?(entry)
+      @entry = File.realpath(entry)
+      @only = options[:only] && File.realpath(options[:only])
+      @settings = Settings.new(entry, options.merge(replacement: true)).data
+      @document = Document.new(entry, @settings, only: options[:only])
+      raise Error, 'Replacement input has parsing diagnostics.' unless @document.diagnostics.empty?
+      rules = ReplacementRules.load(options[:rules])
+      @candidates = []
+      @document.paragraphs.each do |paragraph|
+        text = paragraph['text']
+        protected_ranges = text.to_enum(:scan, Rules::INLINE).map do
+          match = Regexp.last_match
+          match.begin(0)...match.end(0)
+        end
+        raw = @document.sources.fetch(paragraph['file'])
+        lines = raw.lines
+        line_offsets = [0]
+        lines.each { |line| line_offsets << line_offsets.last + line.length }
+        rules.each do |rule|
+          ReplacementRules.matches(text, rule[:patterns], rule[:expected]).each do |edit|
+            next if protected_ranges.any? { |range| edit[:start] < range.end && edit[:finish] > range.begin }
+            # Keep physical line boundaries intact, including CRLF.
+            raise Error, 'Replacement matches and results must stay on one line.' if (edit[:before] + edit[:after]).match?(/[\r\n]/)
+            prefix = text[0...edit[:start]]
+            line = paragraph['line'] + prefix.count("\n")
+            column = (prefix.rindex("\n") ? prefix.length - prefix.rindex("\n") : prefix.length + 1)
+            start = line_offsets.fetch(line - 1) + column - 1
+            raise Error, 'Replacement source mapping is ambiguous.' unless raw[start, edit[:before].length] == edit[:before]
+            @candidates << edit.merge(start: start, finish: start + edit[:before].length,
+                                     file: paragraph['file'], line: line, column: column, rule: rule[:id])
+          end
+        end
+      end
+      @candidates.uniq!
+      @candidates.sort_by! { |edit| [edit[:file], edit[:start], edit[:rule]] }
+      @candidates.group_by { |edit| edit[:file] }.each_value { |edits| ReplacementRules.reject_overlaps!(edits) }
+      @updated = @document.sources.transform_values(&:dup)
+      @candidates.reverse_each { |edit| @updated[edit[:file]][edit[:start]...edit[:finish]] = edit[:after] }
+      validate unless @candidates.empty?
+    end
+
+    def report
+      candidates.map { |edit| "#{edit[:file]}:#{edit[:line]}:#{edit[:column]}: #{edit[:rule]} #{edit[:before].inspect} -> #{edit[:after].inspect}\n" }.join +
+        "#{candidates.length} replacements; #{@document.coverage.length} coverage notices. Only mapped running prose is eligible.\n"
+    end
+
+    def changed
+      @updated.select { |path, text| text != @document.sources[path] }
+    end
+
+    def diff
+      changed.map do |path, text|
+        Tempfile.create('pubkit-before') do |before|
+          Tempfile.create('pubkit-after') do |after|
+            before.binmode.write(@document.sources[path]); before.flush
+            after.binmode.write(text); after.flush
+            output, error, status = Open3.capture3('diff', '-u', '--label', "#{path} (before)", '--label', "#{path} (after)", before.path, after.path)
+            raise Error, "Cannot generate diff: #{error}" unless [0, 1].include?(status.exitstatus)
+            output
+          end
+        end
+      end.join
+    end
+
+    def validate
+      root = File.realpath(@settings['base_dir'])
+      Dir.mktmpdir('pubkit-replacement-') do |stage|
+        stage = File.realpath(stage)
+        @updated.each do |path, text|
+          destination = File.join(stage, Pathname.new(path).relative_path_from(Pathname.new(root)).to_s)
+          FileUtils.mkdir_p(File.dirname(destination))
+          File.binwrite(destination, text)
+        end
+        staged_entry = File.join(stage, Pathname.new(@entry).relative_path_from(Pathname.new(root)).to_s)
+        staged_only = @only && File.join(stage, Pathname.new(@only).relative_path_from(Pathname.new(root)).to_s)
+        staged = Document.new(staged_entry, @settings.merge('base_dir' => stage), only: staged_only)
+        raise Error, 'Replacement changes parsing or document structure.' unless staged.diagnostics.empty? && staged.structure == @document.structure
+        original = Session.protected_content(@document).transform_keys { |path| Pathname.new(path).relative_path_from(Pathname.new(root)).to_s }
+        result = Session.protected_content(staged).transform_keys { |path| Pathname.new(path).relative_path_from(Pathname.new(stage)).to_s }
+        # --only can leave otherwise eligible paragraphs protected in the original.
+        if original != result
+          raise Error, 'Replacement changes source membership or protected content.'
+        end
+      end
+    end
+
+    def apply
+      installed = []
+      prepared = []
+      begin
+        changed.each do |path, text|
+          file = Tempfile.new('.pubkit-replace-', File.dirname(path))
+          prepared << [path, file]
+          file.binmode.write(text)
+          file.flush
+          file.fsync
+          File.chmod(File.stat(path).mode & 0o777, file.path)
+        end
+        @document.sources.each do |path, raw|
+          unless !File.symlink?(path) && File.binread(path) == raw.b
+            raise Error, "Source changed before replacement: #{path}"
+          end
+        end
+        prepared.each do |path, file|
+          File.rename(file.path, path)
+          installed << path
+        end
+      rescue StandardError
+        installed.reverse_each { |path| File.binwrite(path, @document.sources.fetch(path)) }
+        raise
+      ensure
+        prepared.each { |_, file| file.close! }
+      end
+    end
+  end
+end

data/lib/asciidoc_pubkit/settings.rb

@@ -39,7 +39,7 @@ module AsciidocPubkit
         raise Error, '--heading-rules requires --scope headings.'
       end
       heading_rules_path = options[:heading_rules] ? File.expand_path(options[:heading_rules]) : (review['heading_rules'] ? File.expand_path(review['heading_rules'], base) : HeadingRuleSet.default_path(language))
-      rules_path = options[:rules] ? File.expand_path(options[:rules]) : (review['rules'] ? File.expand_path(review['rules'], base) : RuleSet.default_path(language))
+      rules_path = options[:replacement] ? RuleSet.default_path(language) : options[:rules] ? File.expand_path(options[:rules]) : (review['rules'] ? File.expand_path(review['rules'], base) : RuleSet.default_path(language))
       @data = {
         'scope' => scope,
         'heading_rules' => scope == 'headings' ? HeadingRuleSet.load(heading_rules_path) : nil,

data/lib/asciidoc_pubkit.rb

@@ -9,7 +9,7 @@ require 'pathname'
 require 'optparse'
 
 module AsciidocPubkit
-  VERSION = '0.6.3'
+  VERSION = '0.8.0'
   class Error < StandardError; end
 
   def self.hash_text(text)
@@ -34,4 +34,5 @@ require_relative 'asciidoc_pubkit/rules'
 require_relative 'asciidoc_pubkit/session'
 require_relative 'asciidoc_pubkit/local_evaluator'
 require_relative 'asciidoc_pubkit/score'
+require_relative 'asciidoc_pubkit/replacement'
 require_relative 'asciidoc_pubkit/cli'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: asciidoc-pubkit
 version: !ruby/object:Gem::Version
-  version: 0.6.3
+  version: 0.8.0
 platform: ruby
 authors:
 - CyberGarage
@@ -38,7 +38,8 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '1.0'
 description: Generate Japanese technical writing prompts, review AsciiDoc prose and
-  section headings separately, and verify protected manuscript content.
+  section headings separately, verify protected manuscript content, and explicitly
+  apply prose-only mechanical replacements.
 executables:
 - asciidoc-pubkit
 extensions: []
@@ -52,6 +53,7 @@ files:
 - data/writing/ja/criteria.md
 - data/writing/ja/headings.md
 - examples/book.adoc
+- examples/replacements.yml
 - exe/asciidoc-pubkit
 - lib/asciidoc_pubkit.rb
 - lib/asciidoc_pubkit/cli.rb
@@ -60,6 +62,7 @@ files:
 - lib/asciidoc_pubkit/language.rb
 - lib/asciidoc_pubkit/local_evaluator.rb
 - lib/asciidoc_pubkit/morphology.rb
+- lib/asciidoc_pubkit/replacement.rb
 - lib/asciidoc_pubkit/rule_set.rb
 - lib/asciidoc_pubkit/rules.rb
 - lib/asciidoc_pubkit/score.rb