asciidoc-pubkit 1.0.2 → 1.1.0

data/lib/asciidoc_pubkit/rules.rb

@@ -113,6 +113,7 @@ module AsciidocPubkit
       tokens.each_with_index do |token, index|
         next if token['unknown'] || phrase_ranges.any? { |range| range.cover?(token['offset']) }
         lemma = token['lemma']
+        next if lemma == '人' && !standalone_human?(text, token['offset'])
         rule = nil
         finish_index = index
         compound = rules.fetch('compound_nouns').find do |term|
@@ -185,6 +186,7 @@ module AsciidocPubkit
         surfaces.each do |surface|
           text.to_enum(:scan, Regexp.new(Regexp.escape(surface))).each do
             match = Regexp.last_match
+            next if surface == '人' && !standalone_human?(text, match.begin(0))
             next if contextual.any? { |start, finish, _, candidate_rule, *_| start == match.begin(0) && finish == match.end(0) && candidate_rule == rule }
             candidates << [match.begin(0), match.end(0), surface, rule, question]
           end
@@ -200,6 +202,18 @@ module AsciidocPubkit
       end
     end
 
+    # Exclude compound words, identifiers and counts in both tokenizer modes.
+    # Hiragana context such as その人 or 人による remains a review cue.
+    def self.standalone_human?(text, offset)
+      compound = /[\p{Han}\p{N}\p{Latin}\p{Katakana}_]/
+      previous = offset.positive? ? text[offset - 1] : nil
+      following = text[offset + 1]
+      return false if previous == 'ー' || previous&.match?(compound)
+      return true if text[(offset + 1)..].start_with?('向け')
+
+      following != 'ー' && !following&.match?(compound)
+    end
+
     def self.find_term(findings, paragraph, text, term, rule, severity, question)
       text.to_enum(:scan, Regexp.new(Regexp.escape(term))).each do
         match = Regexp.last_match

data/lib/asciidoc_pubkit/session.rb

@@ -51,6 +51,7 @@ module AsciidocPubkit
           'protected' => protected_content(document),
           'numeric_tokens' => numeric_tokens(document)
         }
+        manifest['outline_criteria'] = Writing.outline_criteria(settings.data['language']) if settings.data['scope'] == 'headings'
         write_json(File.join(staging, 'document.json'), document.to_h)
         write_json(File.join(staging, 'findings.json'), findings)
         manifest['artifacts'] = %w[document.json findings.json].to_h do |name|
@@ -157,14 +158,21 @@ module AsciidocPubkit
       @manifest.fetch('settings').fetch('language')
     end
 
-    def prompt(mode)
+    def prompt(mode, view: 'full')
+      raise Error, 'view must be full or outline.' unless %w[full outline].include?(view)
+      if view == 'outline' && @manifest.fetch('settings').fetch('scope', 'prose') != 'headings'
+        raise Error, 'Outline view requires a heading session.'
+      end
+      if view == 'outline' && !@manifest['outline_criteria'].is_a?(String)
+        raise Error, 'Outline view requires saved outline criteria. Create a new heading session without replacing the existing baseline.'
+      end
       raise Error, 'mode must be revise or diagnose.' unless %w[revise diagnose].include?(mode)
       stale = @manifest['sources'].select do |source|
         !File.file?(source['path']) || Digest::SHA256.file(source['path']).hexdigest != source['sha256']
       end
       raise Error, 'Sources have changed since scanning. Create a new scan before generating a prompt.' unless stale.empty?
       language = Language.validate!(@manifest.fetch('settings').fetch('language'), operation: 'review')
-      return heading_prompt(mode, language) if @manifest.fetch('settings').fetch('scope', 'prose') == 'headings'
+      return heading_prompt(mode, language, view: view) if @manifest.fetch('settings').fetch('scope', 'prose') == 'headings'
       list_scope = @manifest['settings']['scope'] == 'lists'
       criteria = @manifest.fetch('writing_criteria')
       instructions = <<~TEXT
@@ -332,7 +340,7 @@ module AsciidocPubkit
       end
     end
 
-    def heading_prompt(mode, language)
+    def heading_prompt(mode, language, view: 'full')
       text = <<~TEXT
         # Japanese heading review
 
@@ -399,6 +407,14 @@ module AsciidocPubkit
         ## Selected headings
 
       TEXT
+      if view == 'outline'
+        text.sub!('# Japanese heading review', '# Japanese outline review')
+        text.sub!(prompt_data(JSON.generate(@document.fetch('outline')), 'json'), outline_view_data)
+        text.sub!('## Outline (reference data)', outline_review_guidance + "\n## Outline (reference data)")
+      end
+      if (depth = @manifest['settings']['heading_depth'])
+        text.sub!('## Selected headings', "Selected heading depth: #{depth} (maximum Asciidoctor section level).\nDeeper titles are reference data only and remain protected.\n\n## Selected headings")
+      end
       grouped = @findings.group_by { |finding| finding['heading_id'] }
       @document.fetch('headings').each do |heading|
         text << "### Heading #{heading['id']}\n\n"
@@ -415,6 +431,28 @@ module AsciidocPubkit
       text
     end
 
+    def outline_review_guidance
+      @manifest.fetch('outline_criteria')
+    end
+
+    def outline_view_data
+      selected = @document.fetch('headings').to_h { |h| [h['index'], h] }
+      numbers = {}
+      siblings = Hash.new(0)
+      rows = @document.fetch('outline').map do |heading|
+        parent = heading['parent_index']
+        siblings[parent] += 1
+        number = (numbers[parent] || []) + [siblings[parent]]
+        numbers[heading['index']] = number
+        source = selected[heading['index']] || heading
+        location = source['file'] ? "#{source['file']}:#{source['line'] || '?'}" : 'source position unavailable'
+        status = selected.key?(heading['index']) ? 'editable' : 'reference-only'
+        "#{'  ' * (number.length - 1)}#{number.join('-')}. #{heading['text']} " \
+          "[#{status}; level #{heading['level']}; section_id #{heading['section_id']}; #{location}]"
+      end
+      prompt_data(rows.join("\n"), 'text')
+    end
+
     def review_process(unit, mode)
       <<~TEXT
         ## Review decisions and completion
@@ -427,6 +465,8 @@ module AsciidocPubkit
         Review #{unit}s without candidates against the shared criteria as well. For concerns outside the editable scope, report the location and a separate out-of-scope proposal; do not count protection as an editorial keep decision or edit protected content.
         #{mode == 'revise' ? 'Compare the original and edited passages, check both information loss and unsupported additions, and reconcile each recorded decision with the actual diff. After verification, individually inspect newly detected or remaining candidates; retain the original candidate IDs in the review record.' : 'Compare each proposed revision with the original passage for information loss and unsupported additions. A revise decision means a proposed revision, not an applied edit.'}
         Report mechanical preservation, candidate decisions, and #{unit}-level quality review separately. State selected and reviewed #{unit} counts, candidate decision counts, pending items, needs-evidence items, out-of-scope concerns, and evidence used. Recheck retained role metaphors by their actual roles and cite the individual decisions; listing remaining words is not enough. Out-of-scope concerns cover only evidence actually inspected; the supplied prose/body context omits lists and other excluded blocks, so do not claim those were reviewed. If any selected item or candidate remains pending, report the review as incomplete.
+        For an explicitly task-limited review (such as human-role terminology), state the objective and relevant entry IDs separately from the total scanned entries. Report task-specific decisions and full-quality review counts separately. Scanning the whole book or completing a terminology pass does not establish full editorial review; unrelated unreviewed entries and candidates remain pending, not automatic keep decisions. This reporting distinction does not change saved edit permissions or add a selection filter.
+        Check related tables, figures and alternative text when terminology changes affect them. Report updates outside this session's edit scope separately; this prompt does not authorize those edits. Preserve the original baseline and phase-end verification when separately authorized synchronization follows.
         Mechanical verification does not read or validate these decision records. Its passed result and candidate counts do not establish review completion or writing quality; meaning_verified remains false. Do not claim semantic correctness from those checks.
       TEXT
     end

data/lib/asciidoc_pubkit/settings.rb

@@ -23,7 +23,7 @@ module AsciidocPubkit
       reject_keys(config, ['review'], 'configuration')
       review = config.fetch('review', {})
       raise Error, 'review must be a mapping.' unless review.is_a?(Hash)
-      reject_keys(review, %w[language style glossary exclude allows attributes base_dir tokenizer mecab_command mecab_dictionary rules heading_rules], 'review')
+      reject_keys(review, %w[language style glossary exclude allows attributes base_dir tokenizer mecab_command mecab_dictionary rules heading_rules heading_depth], 'review')
       raise Error, 'attributes must be a mapping.' unless review.fetch('attributes', {}).is_a?(Hash)
       %w[base_dir glossary mecab_command mecab_dictionary rules heading_rules].each do |key|
         raise Error, "#{key} must be a nonempty path string." if review.key?(key) && (!review[key].is_a?(String) || review[key].empty?)
@@ -38,6 +38,16 @@ module AsciidocPubkit
       if scope != 'headings' && options[:heading_rules]
         raise Error, '--heading-rules requires --scope headings.'
       end
+      if options.key?(:depth) && scope != 'headings'
+        raise Error, '--depth requires --scope headings.'
+      end
+      if review.key?('heading_depth') && (!review['heading_depth'].is_a?(Integer) || review['heading_depth'] < 1)
+        raise Error, 'heading_depth must be a positive integer.'
+      end
+      depth = options.fetch(:depth, review['heading_depth']) if scope == 'headings'
+      if depth && (!depth.is_a?(Integer) || depth < 1)
+        raise Error, 'Depth must be a positive integer.'
+      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[: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 = {
@@ -58,6 +68,7 @@ module AsciidocPubkit
         'base_dir' => File.expand_path(options[:base_dir] || review.fetch('base_dir', base), options[:base_dir] ? Dir.pwd : base),
         'glossary' => {}
       }
+      @data['heading_depth'] = depth if depth
       raise Error, 'tokenizer must be mecab or literal.' unless %w[mecab literal].include?(@data['tokenizer'])
       raise Error, 'style must be preserve, desu-masu, or dearu.' unless %w[preserve desu-masu dearu].include?(@data['style'])
       %w[exclude allows].each do |key|

data/lib/asciidoc_pubkit/writing.rb

@@ -18,6 +18,11 @@ module AsciidocPubkit
       AsciidocPubkit.read_text(File.join(DATA_ROOT, language, 'headings.md'))
     end
 
+    def self.outline_criteria(language = Language::DEFAULT)
+      Language.validate!(language, operation: 'review')
+      AsciidocPubkit.read_text(File.join(DATA_ROOT, language, 'outline.md'))
+    end
+
     def self.prompt(language = Language::DEFAULT)
       guide = prompt_criteria(language)
       <<~TEXT

data/lib/asciidoc_pubkit.rb

@@ -9,7 +9,7 @@ require 'pathname'
 require 'optparse'
 
 module AsciidocPubkit
-  VERSION = '1.0.2'
+  VERSION = '1.1.0'
   class Error < StandardError; end
 
   def self.hash_text(text)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: asciidoc-pubkit
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.1.0
 platform: ruby
 authors:
 - CyberGarage
@@ -53,6 +53,8 @@ files:
 - data/review-rules.ja.yml
 - data/writing/ja/criteria.md
 - data/writing/ja/headings.md
+- data/writing/ja/outline.md
+- docs/agent-review-tutorial.md
 - docs/architecture.md
 - docs/configuration.md
 - docs/custom-rules.md
@@ -61,15 +63,18 @@ files:
 - docs/english-review-research.md
 - docs/installation.md
 - docs/list-review.md
+- docs/outline-review.md
 - docs/prose-evaluation.md
 - docs/references.md
 - docs/replacements.md
 - docs/review-workflow.md
 - docs/rules-and-coverage.md
 - docs/scoring.md
+- docs/skill-integration.md
 - docs/writing.md
 - examples/book.adoc
 - examples/replacements.yml
+- examples/skills/review-asciidoc-manuscript/SKILL.md
 - exe/asciidoc-pubkit
 - lib/asciidoc_pubkit.rb
 - lib/asciidoc_pubkit/cli.rb