ligarb 0.4.0 → 0.5.0

data/lib/ligarb/template.rb

@@ -12,7 +12,7 @@ module Ligarb
       @css_path      = File.join(ASSETS_DIR, "style.css")
     end
 
-    def render(config:, chapters:, structure:, assets:, index_entries: [])
+    def render(config:, chapters:, structure:, assets:, index_entries: [], bibliography: [])
       css = File.read(@css_path)
       template = File.read(@template_path)
 
@@ -34,6 +34,7 @@ module Ligarb
       b.local_variable_set(:ai_generated, config.ai_generated)
       b.local_variable_set(:footer, config.effective_footer)
       b.local_variable_set(:index_tree, build_index_tree(index_entries, chapters))
+      b.local_variable_set(:bibliography, bibliography)
 
       ERB.new(template, trim_mode: "-").result(b)
     end

data/lib/ligarb/version.rb

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

data/lib/ligarb/writer.rb

@@ -1,10 +1,13 @@
 # frozen_string_literal: true
 
 require "yaml"
+require "json"
 require "fileutils"
 
 module Ligarb
   class Writer
+    class WriterError < RuntimeError; end
+
     BRIEF_FIELDS_FOR_BOOK_YML = %w[author output_dir chapter_numbers style repository].freeze
 
     def initialize(brief_path, no_build: false)
@@ -19,8 +22,7 @@ module Ligarb
       book_yml_path = File.join(output_dir, "book.yml")
 
       if File.exist?(book_yml_path)
-        $stderr.puts "Error: #{book_yml_path} already exists. Remove it first to regenerate."
-        exit 1
+        raise WriterError, "#{book_yml_path} already exists. Remove it first to regenerate."
       end
 
       FileUtils.mkdir_p(output_dir)
@@ -28,8 +30,7 @@ module Ligarb
       run_claude(prompt)
 
       unless File.exist?(book_yml_path)
-        $stderr.puts "Error: Claude did not generate book.yml in #{output_dir}"
-        exit 1
+        raise WriterError, "Claude did not generate book.yml in #{output_dir}"
       end
 
       puts "Book files generated in #{output_dir}"
@@ -39,6 +40,8 @@ module Ligarb
         require_relative "builder"
         Builder.new(book_yml_path).build
       end
+
+      book_yml_path
     end
 
     def self.init_brief(directory = nil)
@@ -47,8 +50,7 @@ module Ligarb
       path = File.join(target, "brief.yml")
 
       if File.exist?(path)
-        $stderr.puts "Error: #{path} already exists."
-        exit 1
+        raise WriterError, "#{path} already exists."
       end
 
       FileUtils.mkdir_p(target)
@@ -95,21 +97,18 @@ module Ligarb
 
     def check_claude_installed!
       unless system("claude", "--version", out: File::NULL, err: File::NULL)
-        $stderr.puts "Error: 'claude' command not found. Install Claude Code first."
-        exit 1
+        raise WriterError, "'claude' command not found. Install Claude Code first."
       end
     end
 
     def load_brief
       unless File.exist?(@brief_path)
-        $stderr.puts "Error: #{@brief_path} not found."
-        exit 1
+        raise WriterError, "#{@brief_path} not found."
       end
 
       brief = YAML.safe_load_file(@brief_path)
       unless brief.is_a?(Hash) && brief["title"] && !brief["title"].empty?
-        $stderr.puts "Error: 'title' is required in #{@brief_path}."
-        exit 1
+        raise WriterError, "'title' is required in #{@brief_path}."
       end
 
       brief
@@ -148,6 +147,13 @@ module Ligarb
         lines << "In book.yml, set: #{settings}"
       end
 
+      sources = parse_brief_sources(brief)
+      if sources.any?
+        lines << ""
+        lines << "Reference sources (read these files for context):"
+        sources.each { |src| lines << "- #{src[:label]}: #{src[:path]}" }
+      end
+
       lines << ""
       lines << "Create all files in: #{abs_output_dir}"
       lines << "In book.yml, always set: ai_generated: true"
@@ -156,18 +162,65 @@ module Ligarb
       lines << "Each chapter: substantive content with multiple ## sections."
       lines << "Use code blocks, admonitions, mermaid diagrams where appropriate."
       lines << "Chapter filenames: 01-topic.md, 02-topic.md, etc."
+      lines << ""
+      lines << "Create references.bib with real bibliography entries in BibTeX format."
+      lines << "In book.yml, set: bibliography: references.bib"
+      lines << "Cite references in chapter text using [text](#cite:key) syntax."
+      lines << "Search the web to find accurate bibliographic information (DOI, pages, volume, etc.)."
+      lines << "Do NOT fabricate references. Only include real, verifiable publications."
+      lines << "Use entry types: @article, @inproceedings, @book, @misc as appropriate."
+      lines << "Use UTF-8 directly for special characters (no LaTeX commands like \\c{c})."
+      lines << "BibTeX keys: authorsurname+year (e.g. knuth1984, cousot1977)."
 
       lines.join("\n")
     end
 
+    def parse_brief_sources(brief)
+      base_dir = File.dirname(@brief_path)
+      (brief["sources"] || []).map do |entry|
+        case entry
+        when String
+          { path: File.expand_path(entry, base_dir), label: File.basename(entry) }
+        when Hash
+          path = entry["path"] or raise WriterError, "source entry missing 'path'"
+          { path: File.expand_path(path, base_dir), label: entry.fetch("label", File.basename(path)) }
+        else
+          raise WriterError, "invalid source entry: #{entry.inspect}"
+        end
+      end
+    end
+
     def run_claude(prompt)
-      tools = "Write,Bash,WebFetch,WebSearch"
-      allowed = "Write,Bash(mkdir:*),Bash(ls:*),Bash(ligarb:*),WebFetch,WebSearch"
-      cmd = ["claude", "-p", "--verbose", prompt, "--tools", tools, "--allowedTools", allowed]
-      unless system(*cmd)
-        $stderr.puts "Error: Claude process failed."
-        exit 1
+      tools = "Read,Write,Bash,WebFetch,WebSearch"
+      allowed = "Read,Write,Bash(mkdir:*),Bash(ls:*),Bash(ligarb:*),WebFetch,WebSearch"
+      cmd = ["claude", "-p", prompt, "--tools", tools, "--allowedTools", allowed,
+             "--output-format", "stream-json", "--verbose"]
+      puts "Writing with Claude... (this may take a few minutes)"
+      unparsed_lines = []
+      IO.popen(cmd, err: [:child, :out]) do |io|
+        io.each_line do |line|
+          unless parse_stream_event(line)
+            unparsed_lines << line.rstrip
+          end
+        end
+      end
+      unless $?.success?
+        msg = unparsed_lines.reject(&:empty?).last(10).join("\n")
+        raise WriterError, "Claude process failed.#{"\n#{msg}" unless msg.empty?}"
+      end
+    end
+
+    def parse_stream_event(line)
+      json = JSON.parse(line) rescue (return false)
+      case json["type"]
+      when "content_block_start"
+        tool = json.dig("content_block", "tool_use")
+        if tool
+          name = tool["name"]
+          puts "  [#{name}]..." if name
+        end
       end
+      true
     end
   end
 end

data/templates/book.html.erb

@@ -110,6 +110,11 @@
       </li>
         <%- end -%>
       <%- end -%>
+      <%- unless bibliography.empty? -%>
+      <li class="toc-chapter" data-chapter="__bibliography__">
+        <a href="#__bibliography__" class="toc-h1" onclick="showChapter('__bibliography__')"><%= language == 'ja' ? '参考文献' : 'Bibliography' %></a>
+      </li>
+      <%- end -%>
       <%- unless index_tree.empty? -%>
       <li class="toc-chapter" data-chapter="__index__">
         <a href="#__index__" class="toc-h1" onclick="showChapter('__index__')"><%= language == 'ja' ? '索引' : 'Index' %></a>
@@ -147,6 +152,16 @@
     <%- end -%>
   </section>
   <%- end -%>
+  <%- unless bibliography.empty? -%>
+  <section class="chapter bibliography-chapter" id="chapter-__bibliography__" style="display: none;">
+    <h1><%= language == 'ja' ? '参考文献' : 'Bibliography' %></h1>
+    <ul class="bibliography-list">
+      <%- bibliography.each do |entry| -%>
+      <li id="bib-<%= entry[:key] %>"><span class="bib-label">[<%= entry[:label] %>]</span> <%= entry[:formatted_html] %></li>
+      <%- end -%>
+    </ul>
+  </section>
+  <%- end -%>
   <%- unless index_tree.empty? -%>
   <section class="chapter index-chapter" id="chapter-__index__" style="display: none;">
     <h1><%= language == 'ja' ? '索引' : 'Index' %></h1>
@@ -175,10 +190,12 @@
 
 <script>
 (function() {
-  var chapters = [<%= chapters.map { |c| "\"#{c.slug}\"" }.join(", ") %><%= ', "__index__"' unless index_tree.empty? %>];
+  var chapters = [<%= chapters.map { |c| "\"#{c.slug}\"" }.join(", ") %><%= ', "__bibliography__"' unless bibliography.empty? %><%= ', "__index__"' unless index_tree.empty? %>];
   var currentChapter = null;
 
-  function showChapter(slug) {
+  var navigating = false; // flag to suppress pushState during popstate/initial load
+
+  function showChapter(slug, hash) {
     chapters.forEach(function(ch) {
       var el = document.getElementById('chapter-' + ch);
       if (el) el.style.display = (ch === slug) ? 'block' : 'none';
@@ -195,7 +212,10 @@
     });
 
     currentChapter = slug;
-    history.replaceState(null, '', '#' + slug);
+    var newHash = '#' + (hash || slug);
+    if (!navigating) {
+      history.pushState(null, '', newHash);
+    }
     window.scrollTo(0, 0);
 
     // Re-apply highlight if search is active
@@ -231,36 +251,53 @@
   }
 
   function showChapterAndScroll(slug, headingId) {
-    showChapter(slug);
-    history.replaceState(null, '', '#' + headingId);
+    showChapter(slug, headingId);
     setTimeout(function() {
       var target = document.getElementById(headingId);
       if (target) target.scrollIntoView({ behavior: 'smooth' });
     }, 50);
   }
 
-  // Handle initial hash
+  // Navigate to chapter/heading based on current URL hash
   function handleHash() {
+    navigating = true;
     var hash = location.hash.replace('#', '');
     if (!hash) {
       if (chapters.length > 0) showChapter(chapters[0]);
+      navigating = false;
       return;
     }
 
     // Check if hash matches a chapter slug directly
     if (chapters.indexOf(hash) !== -1) {
       showChapter(hash);
+      navigating = false;
+      return;
+    }
+
+    <%- unless bibliography.empty? -%>
+    // Check for bibliography entry (bib-KEY)
+    var bibMatch = hash.match(/^bib-(.+)/);
+    if (bibMatch) {
+      showChapter('__bibliography__', hash);
+      setTimeout(function() {
+        var target = document.getElementById(hash);
+        if (target) target.scrollIntoView({ behavior: 'smooth' });
+      }, 50);
+      navigating = false;
       return;
     }
+    <%- end -%>
 
     // Check for footnote links (fn: or fnref:)
     var fnMatch = hash.match(/^(?:fn|fnref):(.+?)--/);
     if (fnMatch) {
       var fnChSlug = fnMatch[1];
       if (chapters.indexOf(fnChSlug) !== -1) {
-        if (currentChapter !== fnChSlug) showChapter(fnChSlug);
+        if (currentChapter !== fnChSlug) showChapter(fnChSlug, hash);
         var fnTarget = document.getElementById(hash);
         if (fnTarget) fnTarget.scrollIntoView({ behavior: 'smooth' });
+        navigating = false;
         return;
       }
     }
@@ -271,26 +308,98 @@
       var chSlug = parts[0];
       if (chapters.indexOf(chSlug) !== -1) {
         showChapterAndScroll(chSlug, hash);
+        navigating = false;
         return;
       }
     }
 
     // Fallback
     if (chapters.length > 0) showChapter(chapters[0]);
+    navigating = false;
   }
 
   // TOC search + content highlight
   var searchInput = document.getElementById('toc-search');
   var clearBtn = document.getElementById('search-clear');
 
+  // Build text cache for full-text search (lazy, built on first search)
+  var chapterTextCache = null;
+  function buildTextCache() {
+    if (chapterTextCache) return;
+    chapterTextCache = {};
+    chapters.forEach(function(slug) {
+      var section = document.getElementById('chapter-' + slug);
+      if (section) {
+        chapterTextCache[slug] = section.textContent.toLowerCase();
+      }
+    });
+  }
+
+  function countMatches(text, query) {
+    var count = 0;
+    var idx = text.indexOf(query);
+    while (idx !== -1) {
+      count++;
+      idx = text.indexOf(query, idx + query.length);
+    }
+    return count;
+  }
+
   function updateSearch() {
     var query = searchInput.value.toLowerCase();
+    clearBtn.style.display = query ? 'block' : 'none';
+
+    // Remove existing match count badges
+    document.querySelectorAll('.search-match-count').forEach(function(el) { el.remove(); });
+
     var items = document.querySelectorAll('.toc-chapter');
+    var partItems = document.querySelectorAll('.toc-part, .toc-appendix');
+
+    if (!query || query.length < 2) {
+      // Show all items when query is too short
+      items.forEach(function(item) { item.style.display = ''; });
+      partItems.forEach(function(item) { item.style.display = ''; });
+      highlightContent('');
+      return;
+    }
+
+    buildTextCache();
+
+    // Track which chapters match (content or TOC text)
+    var matchingSlugs = {};
     items.forEach(function(item) {
-      var text = item.textContent.toLowerCase();
-      item.style.display = text.indexOf(query) !== -1 ? '' : 'none';
+      var slug = item.dataset.chapter;
+      var tocText = item.textContent.toLowerCase();
+      var contentText = chapterTextCache[slug] || '';
+      var tocMatch = tocText.indexOf(query) !== -1;
+      var contentMatch = contentText.indexOf(query) !== -1;
+
+      if (tocMatch || contentMatch) {
+        item.style.display = '';
+        matchingSlugs[slug] = true;
+        // Show match count badge for content matches
+        if (contentMatch) {
+          var count = countMatches(contentText, query);
+          var badge = document.createElement('span');
+          badge.className = 'search-match-count';
+          badge.textContent = count;
+          var link = item.querySelector('a');
+          if (link) link.appendChild(badge);
+        }
+      } else {
+        item.style.display = 'none';
+      }
     });
-    clearBtn.style.display = query ? 'block' : 'none';
+
+    // Show/hide part and appendix headers based on whether they have visible children
+    partItems.forEach(function(item) {
+      var children = item.querySelectorAll('.toc-chapter');
+      var hasVisible = Array.prototype.some.call(children, function(ch) {
+        return ch.style.display !== 'none';
+      });
+      item.style.display = hasVisible ? '' : 'none';
+    });
+
     highlightContent(searchInput.value);
   }
 
@@ -410,9 +519,12 @@
   window.showChapterAndScroll = showChapterAndScroll;
   window.renderSpecialBlocks = function() { if (currentChapter) renderSpecialBlocks(currentChapter); };
 
-  // Initialize
+  // Initialize (replace initial entry so first back goes to previous page, not same page)
+  navigating = true;
   handleHash();
-  window.addEventListener('hashchange', handleHash);
+  history.replaceState(null, '', location.hash || '#' + (chapters[0] || ''));
+  navigating = false;
+  window.addEventListener('popstate', handleHash);
 })();
 </script>
 <%- if assets.need?(:highlight) -%>

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ligarb
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - ligarb contributors
@@ -37,6 +37,34 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: webrick
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: fiddle
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.1'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -72,14 +100,21 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- assets/review.css
+- assets/review.js
+- assets/serve.js
 - assets/style.css
 - exe/ligarb
 - lib/ligarb/asset_manager.rb
 - lib/ligarb/builder.rb
 - lib/ligarb/chapter.rb
+- lib/ligarb/claude_runner.rb
 - lib/ligarb/cli.rb
 - lib/ligarb/config.rb
 - lib/ligarb/initializer.rb
+- lib/ligarb/inotify.rb
+- lib/ligarb/review_store.rb
+- lib/ligarb/server.rb
 - lib/ligarb/template.rb
 - lib/ligarb/version.rb
 - lib/ligarb/writer.rb