ligarb 0.3.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)
 
@@ -31,7 +31,10 @@ module Ligarb
       b.local_variable_set(:assets, assets)
       b.local_variable_set(:repository, config.repository)
       b.local_variable_set(:appendix_label, config.appendix_label)
+      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.3.0"
+  VERSION = "0.5.0"
 end

data/lib/ligarb/writer.rb

@@ -0,0 +1,226 @@
+# 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)
+      @brief_path = File.expand_path(brief_path)
+      @no_build = no_build
+    end
+
+    def run
+      check_claude_installed!
+      brief = load_brief
+      output_dir = output_dir_for(brief)
+      book_yml_path = File.join(output_dir, "book.yml")
+
+      if File.exist?(book_yml_path)
+        raise WriterError, "#{book_yml_path} already exists. Remove it first to regenerate."
+      end
+
+      FileUtils.mkdir_p(output_dir)
+      prompt = build_prompt(brief, output_dir)
+      run_claude(prompt)
+
+      unless File.exist?(book_yml_path)
+        raise WriterError, "Claude did not generate book.yml in #{output_dir}"
+      end
+
+      puts "Book files generated in #{output_dir}"
+
+      unless @no_build
+        puts "Building..."
+        require_relative "builder"
+        Builder.new(book_yml_path).build
+      end
+
+      book_yml_path
+    end
+
+    def self.init_brief(directory = nil)
+      dir = directory || "."
+      target = File.expand_path(dir)
+      path = File.join(target, "brief.yml")
+
+      if File.exist?(path)
+        raise WriterError, "#{path} already exists."
+      end
+
+      FileUtils.mkdir_p(target)
+
+      File.write(path, <<~YAML)
+        # brief.yml - Book brief for ligarb write
+        title: "My Book"
+        language: ja
+        audience: ""
+        notes: |
+          5章くらいで。
+      YAML
+
+      claude_md = File.join(target, "CLAUDE.md")
+      created_claude_md = false
+      unless File.exist?(claude_md)
+        File.write(claude_md, <<~MD)
+          # ligarb book project
+
+          This is a book project using [ligarb](https://github.com/ko1/ligarb).
+
+          ## Commands
+
+          - `ligarb build` — Build the book (generates build/index.html)
+          - `ligarb help` — Show full specification (Markdown syntax, config options, etc.)
+
+          ## Key rules
+
+          - All chapter files are Markdown (.md), listed in book.yml
+          - The first h1 in each file is the chapter title
+          - Use ```mermaid, ```math, admonitions (> [!NOTE]), etc. as needed
+          - Run `ligarb build` after changes to verify the output
+        MD
+        created_claude_md = true
+      end
+
+      puts "Created #{path}"
+      puts "Created #{claude_md}" if created_claude_md
+      brief_arg = directory ? " #{path}" : ""
+      puts "Edit brief.yml, then run 'ligarb write#{brief_arg}' to generate the book."
+    end
+
+    private
+
+    def check_claude_installed!
+      unless system("claude", "--version", out: File::NULL, err: File::NULL)
+        raise WriterError, "'claude' command not found. Install Claude Code first."
+      end
+    end
+
+    def load_brief
+      unless File.exist?(@brief_path)
+        raise WriterError, "#{@brief_path} not found."
+      end
+
+      brief = YAML.safe_load_file(@brief_path)
+      unless brief.is_a?(Hash) && brief["title"] && !brief["title"].empty?
+        raise WriterError, "'title' is required in #{@brief_path}."
+      end
+
+      brief
+    end
+
+    def output_dir_for(_brief)
+      File.dirname(@brief_path)
+    end
+
+    def build_prompt(brief, output_dir)
+      abs_output_dir = File.expand_path(output_dir)
+      spec = CLI.spec_text
+
+      lines = []
+      lines << "You are writing a book using the ligarb tool."
+      lines << ""
+      lines << "<ligarb-spec>"
+      lines << spec
+      lines << "</ligarb-spec>"
+      lines << ""
+      lines << "Write a complete book based on this brief:"
+      lines << "- Title: #{brief["title"]}"
+      lines << "- Language: #{brief["language"] || "ja"}"
+      lines << "- Target audience: #{brief["audience"]}" if brief["audience"] && !brief["audience"].empty?
+
+      if brief["notes"] && !brief["notes"].strip.empty?
+        lines << ""
+        lines << "Additional instructions:"
+        lines << brief["notes"].strip
+      end
+
+      book_yml_fields = BRIEF_FIELDS_FOR_BOOK_YML.select { |k| brief.key?(k) }
+      if book_yml_fields.any?
+        settings = book_yml_fields.map { |k| "#{k}: #{brief[k].inspect}" }.join(", ")
+        lines << ""
+        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"
+      lines << "Create book.yml first, then each chapter .md file."
+      lines << "Include a cover page for books with 4+ chapters."
+      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 = "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

@@ -4,6 +4,10 @@
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <title><%= title %></title>
+<%- if ai_generated -%>
+<meta name="robots" content="noindex, nofollow, noarchive">
+<meta name="robots" content="noai, noimageai">
+<%- end -%>
 <style>
 <%= css %>
 </style>
@@ -35,6 +39,9 @@
     <%- unless author.empty? -%>
     <p class="book-author"><%= author %></p>
     <%- end -%>
+    <%- if ai_generated -%>
+    <span class="ai-badge"><%= language == 'ja' ? 'AI 生成' : 'AI Generated' %></span>
+    <%- end -%>
   </div>
   <div class="search-box">
     <input type="text" id="toc-search" placeholder="Search..." autocomplete="off">
@@ -103,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>
@@ -123,7 +135,10 @@
       <a href="<%= repository.chomp('/') %>/blob/HEAD/<%= chapter.relative_path %>" target="_blank" rel="noopener">View on GitHub</a>
     </div>
     <%- end -%>
-    <%- unless chapter.part_title? || chapter.cover? -%>
+    <%- if footer && !chapter.part_title? && !chapter.cover? -%>
+    <div class="chapter-footer"><%= footer %></div>
+    <%- end -%>
+    <%- unless chapter.cover? -%>
     <nav class="chapter-nav">
       <%- if idx > 0 -%>
       <a href="#" class="nav-prev" onclick="showChapter('<%= chapters[idx-1].slug %>'); return false;">&larr; <%= chapters[idx-1].display_title %></a>
@@ -137,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>
@@ -165,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';
@@ -185,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
@@ -211,40 +241,63 @@
           catch(e) { el.textContent = el.getAttribute('data-math'); }
         }
       });
+      section.querySelectorAll('.math-inline[data-math]').forEach(function(el) {
+        if (el.childNodes.length === 0) {
+          try { katex.render(el.getAttribute('data-math'), el, {displayMode: false, throwOnError: false}); }
+          catch(e) { el.textContent = el.getAttribute('data-math'); }
+        }
+      });
     }
   }
 
   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;
       }
     }
@@ -255,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);
   }
 
@@ -394,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.3.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,16 +100,24 @@ 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
 - templates/book.html.erb
 homepage: https://github.com/ligarb/ligarb
 licenses: