obsidian_fetch 1.1.2 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6148753dd141c067fc88a83068d2751944bf8b70c096532228d806fc3c9ba1ca
-  data.tar.gz: 850207c673687d7fe21de00ad2a7761a43d7bbfe92463baa4a987d3c20ea272f
+  metadata.gz: f05f834b38c590fcbccce689668144c14f442bf7ff08899e04f2feb1f807eb95
+  data.tar.gz: cc9d23ced95dd85719d0f0666a3363929e40ff8b2983962cc58930e3d2793157
 SHA512:
-  metadata.gz: 31e95b02fc5d2937e22b622e4629833512018e5ca66de2a168b7eb0c212a17b35e9863394105305b238d70bf4bcd2ca7574f382353fcc1b1289af7c778faa5b6
-  data.tar.gz: d2e6cb6b19c502f80e00784b45fe47d1daf1933048acaa7135f94fa2a4b09c919580640f771c50c1ad9ee4ca24d7c7374b05c932e88d7f00637f8aaae5ed7a43
+  metadata.gz: 366348161c4e8a2352c9a715787f9f86ebb96d0aee0878d83720a4da623d3ab378878e5dd4c0c86ba9dc1ef92421c27f162c40dcbbfadf0ea033c35d5cf6fc19
+  data.tar.gz: 731c8660944590029ab2383da67fb2cfc8499bc89ef7bcde7460798b62651df76e7ec104f79165048a6d20a76760c93f3cf52c271a8cb84d5d4bcf4b5252d004

data/AGENTS.md

@@ -0,0 +1,5 @@
+# このリポジトリにおけるエージェントの行動指針
+
+## テストの実行
+
+テストは `bundle exec rake test` で実行する。

data/Rakefile

@@ -1,4 +1,15 @@
 # frozen_string_literal: true
 
 require "bundler/gem_tasks"
-task default: %i[]
+require 'rake/testtask'
+
+task default: [:test]
+
+task :test do
+  # テスト実行前にカバレッジデータをリセット
+  Dir.glob('coverage/.resultset.json*').each { |f| File.delete(f) if File.exist?(f) }
+end
+
+Rake::TestTask.new('test') do |t|
+  t.test_files = FileList['test/test_*.rb']
+end

data/lib/exe.rb

@@ -78,14 +78,13 @@ vault_paths.each do |path|
   end
 end
 
-# Obsidian Vaultの初期化
-$vault = ObsidianFetch::Vault.new(vault_paths)
-STDERR.puts "Found #{$vault.notes.size} notes"
-STDERR.puts "Found #{$vault.links_by_file_name.size} links and #{$vault.links_by_file_path.size} files linked by notes"
+$manager = ObsidianFetch::VaultManager.new(vault_paths)
+STDERR.puts "Found #{$manager.vault.notes.size} notes"
+STDERR.puts "Found #{$manager.vault.links_by_file_name.size} links and #{$manager.vault.links_by_file_path.size} files linked by notes"
 STDERR.puts "Transport type: #{transport_type}"
 STDERR.puts "Port: #{port}" if transport_type == 'streamable-http'
 
-# readツールの定義
+# MCPツール定義
 class ReadTool < MCP::Tool
   description "Read a note from Obsidian vault. If multiple notes with the same name are found, all will be shown."
   input_schema(
@@ -94,18 +93,13 @@ class ReadTool < MCP::Tool
     },
     required: ["name"]
   )
-
   def self.call(name:)
-    # 名前が文字列でない場合
-    return MCP::Tool::Response.new([{ type: "text", text: "Name must be a string" }]) unless name.is_a?(String)
-
-    # Vaultからノートを読み取る
-    result = $vault.tool_read(name)
-    MCP::Tool::Response.new([{ type: "text", text: result }])
+    return MCP::Tool::Response.new([{ type: "text", text: "Name must be a string" }], error: true) unless name.is_a?(String)
+    result = ObsidianFetch.read_note($manager.vault, name)
+    MCP::Tool::Response.new([{ type: "text", text: result.text }], error: result.error)
   end
 end
 
-# listツールの定義
 class ListTool < MCP::Tool
   description "Search for files with matching names partially."
   input_schema(
@@ -116,19 +110,16 @@ class ListTool < MCP::Tool
   )
 
   def self.call(name:)
-    # 名前が文字列でない場合
-    return MCP::Tool::Response.new([{ type: "text", text: "Name must be a string" }]) unless name.is_a?(String)
-
-    # Vaultからノートを検索
-    result = $vault.tool_list(name)
-    MCP::Tool::Response.new([{ type: "text", text: result }])
+    return MCP::Tool::Response.new([{ type: "text", text: "Name must be a string" }], error: true) unless name.is_a?(String)
+    result = ObsidianFetch.list_notes($manager.vault, name)
+    MCP::Tool::Response.new([{ type: "text", text: result.text }], error: result.error)
   end
 end
 
 # MCPサーバーの初期化
 server = MCP::Server.new(
   name: "obsidian-fetch",
-  version: "0.1.0",
+  version: ObsidianFetch::VERSION,
   tools: [ReadTool, ListTool],
 )
 
@@ -137,31 +128,22 @@ case transport_type
 when 'streamable-http'
   require 'puma'
   require 'rack'
-
-  # Streamable HTTP トランスポートを使用してサーバーを起動
   transport = MCP::Server::Transports::StreamableHTTPTransport.new(server, stateless: true)
-
-  # PumaでRack appとして起動
   $stdout.sync = true
   $stderr.sync = true
-
   server_obj = Puma::Server.new(transport) do
     max_threads 16
     min_threads 1
   end
   server_obj.add_tcp_listener "0.0.0.0", port
-
   STDERR.puts "Streamable HTTP transport started on http://localhost:#{port}"
   STDERR.puts "Press Ctrl+C to stop"
-
-  # サーバーを起動してメインプロセスをブロックする
   server_thread = server_obj.run
   server_thread.join
 when 'stdio'
-  # Stdioトランスポートを使用してサーバーを起動
   transport = MCP::Server::Transports::StdioTransport.new(server)
   transport.open
 else
   STDERR.puts "Unknown transport type: #{transport_type}. Supported: stdio, sse"
   exit 1
-end
+end

data/lib/obsidian_fetch/logic.rb

@@ -0,0 +1,133 @@
+# frozen_string_literal: true
+
+module ObsidianFetch
+  # ツール呼び出しの結果を保持する
+  Result = Struct.new(:text, :error, keyword_init: true) do
+    def initialize(text:, error: false)
+      super(text: text, error: error)
+    end
+  end
+
+  MAX_LIST_SIZE = 20
+
+  # ノート名を正規化する
+  # ファイル名に使えない文字については除去しない。aliasで設定されている場合もあるため。
+  def self.normalize_note_name(note_name)
+    note_name.gsub(/[\[\]\#\^|]/, '')
+  end
+
+  # --- ツールロジック ---
+  def self.read_note(vault, name)
+    name = ObsidianFetch.normalize_note_name(name)
+    file_pathes = vault.notes[name]
+
+    preface = ""
+    # 名前のノートが見つからないが、nameがパスっぽい場合は、パスを修正したうえでもう一度試す
+    if file_pathes.nil? && name.include?('/')
+      fixed_name = File.basename(name, '.md')
+      file_pathes = vault.notes[fixed_name]
+      if file_pathes.nil?
+        # もしも名前で見つからなければ、リンクにも存在しないか確認する
+        link_pathes = vault.links_by_file_name[fixed_name]
+        if link_pathes.nil?
+          return Result.new(text: note_not_found(name), error: true)
+        else
+          # リンク先のノートが見つかった場合は、prefaceを追加する
+          preface = <<~EOS
+            Presumably a path was specified. The process was automatically renamed and processed.
+          EOS
+          return Result.new(text: list_links(fixed_name, preface, vault), error: true)
+        end
+      else
+        # ノート名が見つかった場合は、prefaceを追加する
+        preface = <<~EOS
+          Presumably a path was specified. The process was automatically renamed and processed.
+        EOS
+        return Result.new(text: open_file(fixed_name, file_pathes, preface, vault))
+      end
+    end
+
+    # 名前のノートが存在しない場合
+    if file_pathes.nil?
+      return Result.new(text: note_not_found(name), error: true) if vault.links_by_file_name[name].nil?
+      return Result.new(text: list_links(name, preface, vault), error: true)
+    end
+
+    Result.new(text: open_file(name, file_pathes, preface, vault))
+  end
+
+  def self.list_notes(vault, name)
+    name = ObsidianFetch.normalize_note_name(name)
+    split_name = name.split(/[\t \u3000]+/)
+    # 空白文字で検索された場合は失敗した旨を返す
+    # 仮に全ノートからランダムなMAX_LIST_SIZEを返してしまうと、LLMが誤って呼び出した場合に偽の関連性を持ってしまうため
+    if split_name.empty?
+      return Result.new(text: <<~EOS, error: true)
+        It cannot be listed in a blank string.
+      EOS
+    end
+    matched_notes = vault.notes.select do |note_name, _file_pathes|
+      split_name.map { |name_part| note_name.include?(name_part) }.all?
+    end
+    # 名前で検索したが見つからない場合
+    if matched_notes.empty?
+      has_found_link = vault.links_by_file_name[name] && !vault.links_by_file_name[name].empty?
+      return Result.new(text: <<~EOS, error: true) unless has_found_link
+        Note not found: #{name}
+        Search again with a substring or a string with a different notation.
+      EOS
+      return Result.new(text: <<~EOS, error: true)
+        Note not found: #{name}
+        However, I found other notes linked to this note.
+        #{vault.links_by_file_name[name].shuffle.map { |file_path| "- #{File.basename(file_path, '.md')}" }.join("\n")}
+      EOS
+    end
+    # マッチした名前の数が多すぎる場合は、ランダムにMAX_LIST_SIZE個選ぶ
+    preface = "Notes matching '#{name}' are as follows.\n"
+    if matched_notes.size > MAX_LIST_SIZE
+      matched_notes = matched_notes.to_a.sample(MAX_LIST_SIZE).to_h
+      preface = "Too many notes matched. I will show you only #{MAX_LIST_SIZE} of them.\n" + preface
+    end
+    # マッチした名前のリストで返す
+    list = matched_notes.keys.shuffle.map { |note_name| "- #{note_name}" }.join("\n")
+    Result.new(text: preface + list)
+  end
+
+  # --- ヘルパーメソッド ---
+  def self.note_not_found(name)
+    <<~EOS
+      Note not found: #{name}
+    EOS
+  end
+
+  def self.list_links(name, preface, vault)
+    <<~EOS
+      #{preface}
+      Note not found: #{name}
+      However, I found other notes linked to this note.
+      #{vault.links_by_file_name[name].shuffle.map { |file_path| "- #{File.basename(file_path, '.md')}" }.join("\n")}
+    EOS
+  end
+
+  def self.open_file(name, file_pathes, preface, vault)
+    # 複数のファイルがある場合は、---とファイル名で区切って返す
+    result = file_pathes.map do |file_path|
+      content = open(file_path) { |f| f.read.force_encoding('UTF-8') }
+      link_notes = if vault.links_by_file_path[file_path].nil?
+        ""
+      else
+        <<~EOS
+          This note is linked by the following notes:
+          #{(vault.links_by_file_path[file_path] || []).shuffle.map { |file_path| "- #{File.basename(file_path, '.md')}" }.join("\n")}
+        EOS
+      end
+      metadata = <<~EOS
+        The contents of the note '#{name}' is as follows.
+        #{link_notes}
+        ---
+      EOS
+      metadata + content
+    end.join("\n\n---\n\n")
+    preface + result
+  end
+end

data/lib/obsidian_fetch/vault.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module ObsidianFetch
+  # Vaultスナップショットを表現するイミュータブルなデータ構造
+  class Vault
+    attr_reader :vault_pathes
+    attr_reader :notes
+    attr_reader :links_by_file_path
+    attr_reader :links_by_file_name
+
+    # @param vault_pathes [Array<String>] 保管庫パスのリスト
+    # @param notes [Hash{String => Array<String>}] {ノート名 → [ファイルパス]}
+    # @param links_by_file_path [Hash{String => Array<String>}] {ファイルパス → [逆引きパス]}
+    # @param links_by_file_name [Hash{String => Array<String>}] {ノート名 → [逆引きパス]}
+    def initialize(vault_pathes, notes:, links_by_file_path:, links_by_file_name:)
+      @vault_pathes = vault_pathes
+      @notes = notes
+      @links_by_file_path = links_by_file_path
+      @links_by_file_name = links_by_file_name
+    end
+  end
+end

data/lib/obsidian_fetch/vault_manager.rb

@@ -0,0 +1,187 @@
+# frozen_string_literal: true
+
+require 'set'
+
+module ObsidianFetch
+  # Vaultスナップショットのライフサイクルを管理
+  # ファイル変更を検知し、Vaultを再構築する
+  class VaultManager
+
+    def initialize(vault_pathes)
+      @vault_pathes = vault_pathes
+      scan!
+    end
+
+    # 最新のVaultを返す。変更があれば自動的に再スキャンする。
+    def vault
+      refresh_if_changed
+      @vault
+    end
+
+    private
+
+    # 変更があれば再スキャン
+    def refresh_if_changed
+      return unless changed?
+      scan!
+    end
+
+    # 再スキャン: Vaultを再構築し、内部状態を更新
+    def scan!
+      @last_scan_time = Time.now
+      @notes_cache = collect_notes
+      @vault = build_vault
+      @known_paths = collect_pathes.to_set
+      @known_mtimes = {}
+      @known_sizes = {}
+      @known_paths.each do |path|
+        stat = File.stat(path) rescue nil
+        @known_mtimes[path] = stat&.mtime&.to_f
+        @known_sizes[path] = stat&.size
+      end
+    end
+
+    # 変更検知
+    # チェックサムは計算しない（mtimeとサイズだけで変更を検知）
+    # パスごとに stat を1回だけ実行し、mtime と size を両方取得
+    # mtime は浮動小数点で比較（マイクロ秒の差も検知）
+    # 1. 既知のパスがファイルシステムに存在しない → 削除
+    # 2. mtime または size が前回と異なる → 変更
+    # 3. 新しい.mdファイルが追加されている → 追加
+    def changed?
+      current_paths = collect_pathes
+
+      # 追加検知
+      if (current_paths.to_set - @known_paths).any?
+        return true
+      end
+
+      # 削除検知と変更検知を1パスで実行
+      @known_paths.each do |path|
+        stat = File.stat(path) rescue nil
+        unless stat
+          return true  # 既知のパスが存在しなくなった = 削除
+        end
+        previous_mtime = @known_mtimes[path]
+        previous_size  = @known_sizes[path]
+        if stat.mtime.to_f != previous_mtime || stat.size != previous_size
+          return true
+        end
+      end
+
+      false
+    end
+
+    # .mdファイルのパスを収集
+    def collect_pathes
+      @vault_pathes.flat_map do |vault_path|
+        Dir.glob("#{vault_path}/**/*.md")
+      end
+    end
+
+    # ノート名・aliasの抽出
+    # 戻り値: {ノート名 → [ファイルパス]} のハッシュ
+    def collect_notes
+      # ノートを整理するための処理
+      notes = {}
+      collect_pathes.each do |file_path|
+        file_name = File.basename(file_path, '.md')
+        # ノート名を正規化する
+        # ファイル名に使えない文字については除去しない。aliasで設定されている場合もあるため。
+        file_name = ObsidianFetch.normalize_note_name(file_name)
+        notes[file_name] ||= []
+        notes[file_name] << file_path
+
+        content = open(file_path) { |f| f.read.force_encoding('UTF-8') }
+        frontmatter_str = content.match(/\A---(.*?\n)---/m)&.[](1)
+        if frontmatter_str
+          begin
+            frontmatter = YAML.safe_load(frontmatter_str,
+              symbolize_names: true, aliases: true, permitted_classes: [Date])
+          rescue Psych::SyntaxError => e
+            puts "YAML syntax error in #{file_path}: #{e.message}"
+            next
+          end
+          Array(frontmatter&.[](:aliases) || []).each do |alias_name|
+            # もしaliasが設定されていれば、それも追加する
+            alias_name = ObsidianFetch.normalize_note_name(alias_name)
+            notes[alias_name] ||= []
+            notes[alias_name] << file_path
+          end
+        end
+      end
+      notes.each { |_name, file_pathes| file_pathes.uniq! }
+      notes
+    end
+
+    # [[link]]と[link](path)の解析
+    # 戻り値: [links_by_file_path, links_by_file_name] の2要素配列
+    def collect_links
+      links_by_file_path = {}
+      links_by_file_name = {}
+
+      # リンクを整理するための処理
+      # リンクを整理するためにノート名のリストを使用するため、ここで処理する
+      collect_pathes.each do |file_path|
+        file_name = File.basename(file_path, '.md')
+        file_name = ObsidianFetch.normalize_note_name(file_name)
+        content = open(file_path) { |f| f.read.force_encoding('UTF-8') }
+        # もしリンクが設定されていれば、linksに追加する
+        # [[link]]と[[link|displayname]]の場合
+        # linkに.mdが付いている場合、付いていない場合両方を考慮する
+        # TODO : linkにディレクトリ名が着くことがあるので、それを除去する
+        content.scan(/\[\[(.*?)(?:\|.*)?\]\]/) do |match|
+          link_name = match[0]
+          link_name = link_name.sub(/\.md$/, '') # .mdを削除
+          # #、^以降の文字列を削除
+          link_name = link_name.sub(/#.*$/, '')
+          link_name = ObsidianFetch.normalize_note_name(link_name)
+          next if link_name == file_name # 自分自身をリンクしている場合は無視する
+          # 同名のノートがある場合に、どこにリンクしているかを処理するのは結構難しい
+          # ここでは簡単のため、同名のノートがある場合はすべてのファイルをリンク先として追加する
+          # ただし、aliasは除外する
+          links_by_file_name[link_name] ||= []
+          links_by_file_name[link_name] << file_path
+          linked_candidates = (@notes_cache[link_name] || []).filter { |path| path.include?(link_name + '.md') }
+          linked_candidates.each do |linked_candidate|
+            links_by_file_path[linked_candidate] ||= []
+            links_by_file_path[linked_candidate] << file_path
+          end
+        end
+
+        # [displayname](path)の場合
+        # pathの末尾に.mdが付いている場合、付いていない場合両方を考慮する
+        content.scan(/\[(.*?)\]\((?!\[\[)(.*?)(?<!\]\])\)/) do |match|
+          path = match[1]
+          # `(.+)://`から始まる場合は除外する
+          next if path =~ /^[a-z]+:\/\// # 外部リンク
+          # #、^以降の文字列を削除
+          path = path.sub(/#.*$/, '')
+          path = path.sub(/\.md$/, '') # .mdを削除
+          link_name = File.basename(path)
+          link_name = ObsidianFetch.normalize_note_name(link_name)
+          links_by_file_name[link_name] ||= []
+          links_by_file_name[link_name] << file_path
+          path_from_vault = File.join(File.dirname(file_path), path) + '.md'
+          # Obsidianはかなり賢くて、リンク先のファイルが無い場合には、その配下のファイルを探してくれる
+          # 今回の実装ではそこまで考慮せず、pathを信用する
+          links_by_file_path[path_from_vault] ||= []
+          links_by_file_path[path_from_vault] << file_path
+        end
+      end
+
+      links_by_file_name.each { |_file_name, file_pathes| file_pathes.uniq! }
+      links_by_file_path.each { |_file_path, file_pathes| file_pathes.uniq! }
+      [links_by_file_path, links_by_file_name]
+    end
+
+    # Vaultスナップショットを生成
+    def build_vault
+      links_by_file_path, links_by_file_name = collect_links
+      Vault.new(@vault_pathes,
+                notes: @notes_cache,
+                links_by_file_path: links_by_file_path,
+                links_by_file_name: links_by_file_name)
+    end
+  end
+end

data/lib/obsidian_fetch/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ObsidianFetch
-  VERSION = "1.1.2"
+  VERSION = "1.2.0"
 end

data/lib/obsidian_fetch.rb

@@ -4,247 +4,10 @@ require 'yaml'
 require 'date'
 
 require_relative "obsidian_fetch/version"
+require_relative "obsidian_fetch/vault"
+require_relative "obsidian_fetch/vault_manager"
+require_relative "obsidian_fetch/logic"
 
 module ObsidianFetch
   class Error < StandardError; end
-  
-  class Vault
-    attr_reader :notes, :links_by_file_path, :links_by_file_name
-  
-    def initialize vault_pathes
-      @vault_pathes = vault_pathes
-  
-      # key: note_name, value: [file_pathes]
-      @notes = {}
-  
-      # key: file_path, value: [file_pathes]
-      @links_by_file_path = {}
-  
-      # ノートが見つからなかった場合に被リンクを表示するためのハッシュ
-      # key: note_name, value: [file_pathes]
-      @links_by_file_name = {}
-  
-      collect_pathes()
-      collect_notes()
-      collect_links()
-    end
-  
-    private
-  
-    def collect_pathes
-      @all_pathes = @vault_pathes.flat_map do |vault_path|
-        Dir.glob("#{vault_path}/**/*.md")
-      end
-    end
-  
-    # ノート名を正規化する
-    # ファイル名に使えない文字については除去しない。aliasで設定されている場合もあるため。
-    def self.normalize_note_name(note_name)
-      # ノート名を小文字に変換し、リンクに使えない文字を除去する
-      note_name.gsub(/[\[\]#\^\|]/, '')
-    end
-  
-    def collect_notes
-      # ノート名を整理するための処理
-      @all_pathes.each do |file_path|
-        file_name = File.basename(file_path, '.md')
-        file_name = Vault.normalize_note_name(file_name)
-        @notes[file_name] ||= []
-        @notes[file_name] << file_path
-        content = open(file_path) { |f| f.read.force_encoding('UTF-8') }
-        # もしaliasが設定されていれば、それも追加する
-        frontmatter_str = content.match(/\A---(.*?\n)---/m)&.[](1)
-        if frontmatter_str
-          begin
-            frontmatter = YAML.safe_load(frontmatter_str, symbolize_names: true, aliases: true, permitted_classes: [Date])
-          rescue Psych::SyntaxError => e
-            puts "YAML syntax error in #{file_path}: #{e.message}"
-            next
-          end
-          Array(frontmatter&.[](:aliases) || []).each do |alias_name|
-            alias_name = Vault.normalize_note_name(alias_name)
-            @notes[alias_name] ||= []
-            @notes[alias_name] << file_path
-          end
-        end
-      end
-      @notes.each{|_name, file_pathes| file_pathes.uniq!}
-    end
-  
-    def collect_links
-      # リンクを整理するための処理
-      # リンクを整理するためにノート名のリストを使用するため、ここで処理する
-      @all_pathes.each do |file_path|
-        file_name = File.basename(file_path, '.md')
-        file_name = Vault.normalize_note_name(file_name)
-        content = open(file_path) { |f| f.read.force_encoding('UTF-8') }
-        # もしリンクが設定されていれば、linksに追加する
-        # [[link]]と[[link|displayname]]の場合
-        # linkに.mdが付いている場合、付いていない場合両方を考慮する
-        # TODO : linkにディレクトリ名が着くことがあるので、それを除去する
-        content.scan(/\[\[(.*?)(?:\|.*)?\]\]/) do |match|
-          link_name = match[0]
-          link_name = link_name.sub(/\.md$/, '') # .mdを削除
-          # #、^以降の文字列を削除
-          link_name = link_name.sub(/#.*$/, '')
-          link_name = Vault.normalize_note_name(link_name)
-          next if link_name == file_name # 自分自身をリンクしている場合は無視する
-          @links_by_file_name[link_name] ||= []
-          @links_by_file_name[link_name] << file_path
-          # 同名のノートがある場合に、どこにリンクしているかを処理するのは結構難しい
-          # ここでは簡単のため、同名のノートがある場合はすべてのファイルをリンク先として追加する
-          # ただし、aliasは除外する
-          linked_candidates = (@notes[link_name] || []).filter{|path| path.include?(link_name + '.md') }
-          linked_candidates.each do |linked_candidate|
-            @links_by_file_path[linked_candidate] ||= []
-            @links_by_file_path[linked_candidate] << file_path
-          end
-        end
-        # [displayname](path)の場合
-        # pathの末尾に.mdが付いている場合、付いていない場合両方を考慮する
-        content.scan(/\[(.*?)\]\((?!\[\[)(.*?)(?<!\]\])\)/) do |match|
-          path = match[1]
-          # `(.+)://`から始まる場合は除外する
-          next if path =~ /^[a-z]+:\/\// # 外部リンク
-          # #、^以降の文字列を削除
-          path = path.sub(/#.*$/, '')
-          path = path.sub(/\.md$/, '') # .mdを削除
-          link_name = File.basename(path)
-          link_name = Vault.normalize_note_name(link_name)
-          @links_by_file_name[link_name] ||= []
-          @links_by_file_name[link_name] << file_path
-          # Obsidianはかなり賢くて、リンク先のファイルが無い場合には、その配下のファイルを探してくれる
-          # 今回の実装ではそこまで考慮せず、pathを信用する
-          path_from_vault = File.join(File.dirname(file_path), path) + '.md'
-          @links_by_file_path[path_from_vault] ||= []
-          @links_by_file_path[path_from_vault] << file_path
-        end
-      end
-      @links_by_file_name.each do |_file_name, file_pathes|
-        file_pathes.uniq!
-      end
-      @links_by_file_path.each do |_file_path, file_pathes|
-        file_pathes.uniq!
-      end
-    end
-
-    public
-
-    def tool_read name
-      name = Vault.normalize_note_name(name)
-      file_pathes = @notes[name]
-
-      # 名前のノートが見つからないが、nameがパスっぽい場合は、パスを修正したうえでもう一度試す
-      preface = ""
-      if file_pathes.nil? && name.include?('/')
-        fixed_name = File.basename(name, '.md')
-        file_pathes = @notes[fixed_name]
-        if file_pathes.nil?
-          # もしも名前で見つからなければ、リンクにも存在しないか確認する
-          link_pathes = @links_by_file_name[fixed_name]
-          if link_pathes.nil?
-            return note_not_found(name)
-          else
-            # リンク先のノートが見つかった場合は、prefaceを追加する
-            preface = <<~EOS
-              Presumably a path was specified. The process was automatically renamed and processed.
-            EOS
-            return list_links(fixed_name, preface)
-          end
-        else
-          # ノート名が見つかった場合は、prefaceを追加する
-          preface = <<~EOS
-            Presumably a path was specified. The process was automatically renamed and processed.
-          EOS
-          return open_file(fixed_name, file_pathes, preface)
-        end
-      end
-
-      # 名前のノートが存在しない場合
-      if file_pathes.nil?
-        return note_not_found(name) if @links_by_file_name[name].nil?
-        return list_links(name, preface)
-      end
-
-      open_file(name, file_pathes, preface)
-    end
-
-    private def note_not_found name
-      return <<~EOS
-        Note not found: #{name}
-      EOS
-    end
-
-    private def list_links name, preface
-      return <<~EOS
-        #{preface}
-        Note not found: #{name}
-        However, I found other notes linked to this note.
-        #{@links_by_file_name[name].shuffle.map { |file_path| "- #{File.basename(file_path, '.md')}" }.join("\n")}
-      EOS
-    end
-
-    private def open_file name, file_pathes, preface
-      # 複数のファイルがある場合は、---とファイル名で区切って返す
-      result = file_pathes.map do |file_path|
-        content = open(file_path) { |f| f.read.force_encoding('UTF-8') }
-        link_notes = if @links_by_file_path[file_path].nil?
-          ""
-        else
-          <<~EOS
-            This note is linked by the following notes:
-            #{(@links_by_file_path[file_path] || []).shuffle.map { |file_path| "- #{File.basename(file_path, '.md')}" }.join("\n")}
-          EOS
-        end
-        metadata = <<~EOS
-          The contents of the note '#{name}' is as follows.
-          #{link_notes}
-          ---
-        EOS
-        metadata + content
-      end.join("\n\n---\n\n")
-      preface + result
-    end
-
-    MAX_LIST_SIZE = 20
-    def tool_list name
-      name = Vault.normalize_note_name(name)
-      split_name = name.split(/[\s　]+/)
-      # 空白文字で検索された場合は失敗した旨を返す
-      # 仮に全ノートからランダムなMAX_LIST_SIZEを返してしまうと、LLMが誤って呼び出した場合に偽の関連性を持ってしまうため
-      if split_name.empty?
-        return <<~EOS
-          It cannot be listed in a blank string.
-        EOS
-      end
-      matched_notes = @notes.select do |note_name, _file_pathes|
-        split_name.map {|name_part| note_name.include?(name_part) }.all?
-      end
-      # 名前で検索したが見つからない場合
-      if matched_notes.empty?
-        has_found_link = @links_by_file_name[name] && !@links_by_file_name[name].empty?
-        return <<~EOS unless has_found_link
-          Note not found: #{name}
-          Search again with a substring or a string with a different notation.
-        EOS
-        return <<~EOS
-          Note not found: #{name}
-          However, I found other notes linked to this note.
-          #{@links_by_file_name[name].shuffle.map { |file_path| "- #{File.basename(file_path, '.md')}" }.join("\n")}
-        EOS
-      end
-      # マッチした名前の数が多すぎる場合は、ランダムにMAX_LIST_SIZE個選ぶ
-      preface = "Notes matching '#{name}' are as follows.\n"
-      if matched_notes.size > MAX_LIST_SIZE
-        matched_notes = matched_notes.to_a.sample(MAX_LIST_SIZE).to_h
-        preface = "Too many notes matched. I will show you only #{MAX_LIST_SIZE} of them.\n" + preface
-      end
-      # マッチした名前のリストで返す
-      list = matched_notes.keys.shuffle.map do |note_name|
-        "- #{note_name}"
-      end.join("\n")
-      preface + list
-    end
-  end
-
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: obsidian_fetch
 version: !ruby/object:Gem::Version
-  version: 1.1.2
+  version: 1.2.0
 platform: ruby
 authors:
 - sou7
@@ -58,6 +58,7 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- AGENTS.md
 - CHANGELOG.md
 - LICENSE.txt
 - README.md
@@ -66,6 +67,9 @@ files:
 - exe/obsidian_fetch
 - lib/exe.rb
 - lib/obsidian_fetch.rb
+- lib/obsidian_fetch/logic.rb
+- lib/obsidian_fetch/vault.rb
+- lib/obsidian_fetch/vault_manager.rb
 - lib/obsidian_fetch/version.rb
 - sig/obsidian_fetch.rbs
 homepage: https://ob.sou7.io/2025-04/week17/obsidian_fetch