jeffnewberry/cite-viewer

Cite viewer（引用ビューア）

引用ビューアは、ユーザーのドラフト（またはその一部）を表示するローカルWebページです。すべての引用はリンクになっており、そのステータスに応じた色で下線が引かれています。引用をクリックすると、ソースから引用されたページが表示され、引用または依拠した文言がハイライトされ、その箇所が文をサポートしているかどうかの注釈、そのページで全文ソースを開くリンク、ユーザーが修正を入力できるメモボックスが表示されます。

このビューアは、判例を読むことや、Citator（KeyCiteやShepard's）の代わりにはなりません。これにより読む速度が向上し、各引用箇所がそれを引用する文をサポートしているかどうかを記録します。

決して変わらない2つのルール

• ビューアを公開したり、どこかにホストしたりしないでください。 ビューアにはユーザーのドラフトが含まれており、レコードリンクがある場合はレコード資料を指します。ユーザーのコンピュータ上にダブルクリックで開くファイルとして残ります。共有可能なリンクに変換することを提案しないでください。ユーザーが公開を求めた場合でも、まずクライアントの守秘義務について警告してください。
• ドラフトを決して変更しないでください。 ビューアは問題を報告するものであり、修正するものではありません。ユーザーが別途依頼した場合にのみ、ドラフトを変更してください。

適したタイミング

このビューアは、テキストが確定し、引用がすでに引用チェックとCitatorを通過した後、最終校正前のドラフトに最適です。ユーザーがそれより早い段階で依頼した場合は、その旨を1行で伝え、それでもユーザーが希望する場合は構築してください。

開始前

ユーザーがまだ言っていないことだけを、1つの短いブロックで質問してください。

1. どのドラフトか。添付してもらうか、ファイル名を指定してもらってください。
2. 範囲: ドキュメント全体、または指定されたセクション。ドラフトが短い場合でもこれを質問し、自分で範囲を決めないでください。
3. ソース: 「Westlawから判例を取得しましょうか？それともご自身でPDFをフォルダに入れますか？」（Westlawユーザー: ステップ3を参照。Lexisまたはその他のユーザー: ステップ3aを参照。）
4. レコード引用: 「レコード引用もリンクしますか？もしそうなら、レコードが保存されているコンピュータ上のフォルダはどこですか？また、どのように引用しますか？ドラフトからの引用例を1つ教えてください（例: 12 R.R. 41、ROA.1234、Dkt. 52 at 3、JA 123）。」どのフォルダでも機能します（Dropbox、OneDrive、通常のフォルダ）。ビューアはファイルをその場所でリンクし、コピーは作成しません。ユーザーが「いいえ」と答えた場合、レコード引用は「ソース未ロード」と表示されます。

ビューアの依頼は、ビューワーフォルダを保存し、ステップ3のコスト警告後、ソースを取得するためのゴーサインです。

手順

1. 引用テーブルの構築

ドラフトをテキストに変換します。範囲を順に辿り、すべての引用をリストアップします: 完全引用、ショート引用、id.、supra、法律、二次資料、レコード引用。それぞれについて以下を記録します:

• ID（c1、c2など）、および正確に記述された引用;
• それが解決する権威（*id.*およびショート引用を完全な権威に解決）;
• ピンサイトまたはピンサイト群;
• それがサポートする文からの命題、および引用された文言;
• 引用がソース内の特定の資料（判決、テスト、引用）に依存するか、またはケース全体を名前として挙げるだけか（ステップ6を参照）。

範囲内で引用がない法的記述に注意してください。ページはこれらもマークします。

ドラフトがどこにも完全引用がないショート引用またはsupraを使用している場合、黙って推測しないでください。引用を「一般知識、未検証」とラベル付けて提供するか、除外してフラグを立ててください。

2. ソースリストの構築

権威ごとに1エントリ: リポーター引用（「466 U.S. 668」）、未発表意見のWL引用、法律の法典とセクション、論文の「巻名 最初のページ」。エントリはセミコロンで区切り、最大100個まで。レコード引用およびWestlawが扱わないものは除外し、レポート用にリストアップします。

3. Westlawからのソース取得（Find & Print）

• 何かを取得する前に、Find & PrintリクエストがWestlawプランで課金される可能性があることをユーザーに1回伝え、確認を得た後にのみ進めてください。
• ブラウザでWestlawを開き、ユーザーに通常の方法でサインインするよう依頼してください: ファームサインオン、ロースクールポータル、またはThomson Reuters ID。開いたページが通常使用するページでない場合は、同じブラウザウィンドウで通常のサインインページに移動できることを伝えてください。パスワードを絶対に入力しないでください。ユーザーがサインインしたら、残りを行います。
• Find & Printに移動し、リストを貼り付けます。
• 設定: 判例 → 意見のみ（ヘッドノートなし）; 法律 → 法定テキストのみ; 「リポーター画像に置き換える」のチェックを外します（スター改ページはテキストである必要があるため）; 配信 → ダウンロード; フォーマット → PDF; 形式 → 複数ファイル（ZIP）; 二段組レイアウトをオフにします。
• 送信します。Westlawが一部の引用を拒否した場合、それらを除外し、続行して報告します。
• ダウンロードの準備ができたら、Westlawのダウンロードボタンをクリックします。ブラウザは独自の保存ウィンドウを表示しますが、これは自動操作できません。ユーザーにそのウィンドウが表示されることを伝え、保存（またはダウンロード）をクリックするよう依頼してください。ZIPはユーザーのダウンロードフォルダに保存されます。

3a. ユーザーが提供するソース

ユーザーに権威ごとに1つのPDFをフォルダに入れ、そのフォルダを教えてもらうよう依頼してください。テキストPDFのみ。PDFがテキストのないスキャンの場合、テキスト版を依頼してください。

4. PDFの取得

ダウンロードが保存されたフォルダ（または3aのフォルダ）へのアクセスを依頼します。ダウンロードフォルダ外の作業フォルダに解凍します。各PDFをその権威に一致させ、戻ってこなかったものをフラグします。

5. 引用箇所の抽出

Westlaw PDFはテキスト内にスター改ページをマークします: 一次リポーターには*688、パラレルリポーターには**2055および***、WL引用には*1、*2。パラレルマーカーを削除し、シングルスターでテキストを分割し、各ピンサイトページのテキストと、その前のページの最後の数百文字を取得して、前のページで始まる文が完全に読めるようにします。各マーカーが表示されるPDFページを見つけ、「全文ソースを開く」リンク（#page=N）用に記録します。ページヘッダーとフッターを削除します。このファイルの最後にあるスクリプトを使用してください。ピンがスター改ページでない場合（法評論ページ、法律のサブセクション、または他のサービスのPDF）、引用または依拠した文言を検索して該当箇所を見つけます。

5a. レコード引用（ユーザーが選択した場合のみ）

• ユーザーの例示引用から、引用のどの部分がファイル名（巻、文書番号または事件番号、付録）を示し、どの番号がページ番号（印刷されたトランスクリプトページ、ROA.1234などのスタンプされたレコードページ、裁判所のヘッダーページ、または付録ページ）を示すかを特定します。レコードは1つのファイルまたは複数のファイルである場合があります。
• ユーザーのフォルダ内のレコードファイルをリストアップし、各引用をそのファイルに一致させます（例: 「Vol. 39」または「RR39」を39 R.R.に; 「ECF 52」をDkt. 52に; ROA引用には連続してスタンプされた1つのレコード）。一致が不明確な場合は、ユーザーにマッピングを表示し、先に進む前に確認してください。
• 引用されたページのみを読みます。引用で使用されているページ番号を、ページ自体に表示されている通りに見つけます。PDFのページカウントでは決して見つけないでください（両者はほとんど一致しません）。ページに2つの番号がある場合（裁判所のヘッダーページとドキュメント自体のページなど）、ユーザーの例がどちらを意味するかを確定できない場合は、質問してください。番号が見つからない場合は、引用を「check」とマークし、その旨を伝えてください。
• 各レコード引用について、両方の番号を記録します: 引用が使用するページ番号と、それが該当するPDFページ。
• 各レコード引用を、ビューアのHTMLファイルからユーザーのコンピュータ上のレコードファイルへの相対リンクで、PDFページにリンクします。たとえば、ビューワーフォルダとレコードの両方がダウンロードフォルダにある場合: ../volume.pdf#page=N。ユーザーのコンピュータ上の実際のパス（フォルダ一覧に表示される通り）からリンクを構築し、自分のワークスペース内のパスからは決して構築しないでください。完全なfile:///アドレスは使用しないでください（ブラウザが拒否することがよくあります）。ビューワーフォルダに何もコピーしないでください。
• レコードは、ユーザーのコンピュータ上にあるテキスト検索可能なPDFである必要があります。オンラインのみに保存されているファイル（ダウンロードされていないクラウドファイル、またはウェブサイト経由でアクセスするドキュメントボールト）はリンクできません。該当するものがあればユーザーに伝えてください。

6. 各引用のチェック

各引用箇所を、それがサポートする文と照らし合わせて読みます。ステータスを1つ割り当てます:

• ok — サポートされています。 該当箇所は文の内容をそのまま示しています。引用が正確に一致しているか、角括弧がすべての変更を説明しています。引用が文の一部として、特定の箇所に依存せずにケース全体を名前として挙げるテキスト文（Bluebook R. 3.2(a)）の場合のみ、引用文を抜粋せずにokを使用します。命題をサポートする引用文や引用節は、複数のケースを同時に引用する場合でも、常に特定の資料に依存し、ピンが必要です。ケース全体の引用の注釈には「ケース全体を名前として挙げています。ピンは不要です（Bluebook R. 3.2(a)）。」と記載します。
• check — 要確認。 引用が一致しない、該当箇所が文の一部のみをサポートする、ピンが間違っている、または文がソースを不正確に説明している場合。具体的に何が間違っているかを正確に述べ、修正方法（正しいピン、または角括弧による訂正）を示してください。
• pin — ピンク漏れ。 特定の資料への引用でピンのないもの。近くのテキストが依存するページを示します。文が特定の資料に依存するかどうか不明確な場合は、checkを使用してそのように述べ、ユーザーが判断できるようにします。
• none — ソース未ロード。 PDFやレコードフォルダにないもの。ユーザーが追加する必要があるものを指定します。

注釈はソースが述べていることのみを記述します。それを超える内容には「推測:」を前置きします。実質的な問題のみをフラグします: 誤引用、間違ったピン、判決の誇張または誤った特徴付け、レコードページがサポートしていない事実。単なるタイプミスは無視します。各抜粋で正確に依拠した単語をハイライトします。

7. ページの構築

ユーザーのダウンロードフォルダ（またはユーザーが指定した場所）に、ドラフト名に「-cite-viewer」と日付を追加した名前のフォルダを保存します。含まれるもの:

• HTMLファイル;
• sources/フォルダ（ケースPDFを含む）。（レコードファイルは元の場所に残ります。）

ページのルール:

• 左側にドラフト、右側に引用箇所パネル。狭い画面では積み重なります。
• 上部の凡例には、各ステータスのカウントと「赤い点線テキスト = 引用のない法的記述」を表示します。
• ドラフトテキストを正確に表示します。
• 引用箇所を薄い青色でシェーディングします。左揃えテキスト、セリフフォント。
• ライトモードとダークモードの両方で動作します。
• 引用をクリックすると、ステータスバッジ、記述された引用、注釈、各抜粋（ページヘッダーと「全文ソースを開く ↗」リンク付き）、およびメモボックスが表示されます。
• 各抜粋ヘッダーは、両方の番号付けでページを名前指定し、ユーザーがファイルを開かなくてもページを確認できるようにします: 判例の場合「466 U.S. at 694 · PDF page 7」、レコードの場合「12 R.R. 45 · PDF page 10」。
• 引用されていない法的記述もクリック可能です。クリックすると、「引用なし」バッジ、記述されたステートメント、1行の注釈（例: 「法的ルールを述べています。引用を追加するか削除してください。」）、およびメモボックスが表示されます。

メモボックス。 すべてのフラグのパネル（引用および引用されていないステートメントの両方）の下に、「あなたのメモ（例: 希望する修正）」というラベルのテキストボックスがあります。メモはブラウザに自動保存されます（このファイル用）。すべての保存と読み込みをtry/catchでラップし、ブラウザがストレージをブロックしてもページが機能するようにします。メモのあるフラグには、ドラフト内に小さなドットが表示されます。上部の「すべてのメモをコピー」ボタンは、すべてのメモをドラフト順の番号付きリストとしてコピーし、各行は記述された引用（または「引用なし:」とステートメントの最初の単語）で始まります。ユーザーはこのリストをClaudeに貼り付けたり、Wordの横に保持したりできます。メモはそのブラウザのそのコンピュータにのみ存在することをユーザーに一度伝えてください。コピーしたリストが安全なコピーです。

8. ページの確認

ページを開き、各ステータスの引用を少なくとも1つずつ、および引用されていないステートメントを1つクリックします。抜粋にハイライトされた文言と両方のページ番号が表示されること、メモがパネルの上部にあること、すべてのフラグにメモボックスがあること、「すべてのメモをコピー」が機能することを確認します。

レコードリンクは別途確認が必要です。ユーザーのコンピュータ上でリンクをクリックできないためです。各レコードリンクについて、ユーザーのコンピュータ上のビューアHTMLファイルからリンクがどこを指しているかを特定し、そのフォルダをリストアップしてファイルが存在することを確認します。その後、ユーザーに1つのレコードリンクをクリックし、正しいページが開かれたかどうかを教えてもらうよう依頼してください。ユーザーが確認するまで、レコードリンクが機能していると報告せず、「リンク済み、未確認」として報告してください。

9. 報告

簡潔に、最も重要なポイントから順に:

• フォルダの場所とビューアの開き方: 「Google Chromeでビューアを開いてください（HTMLファイルを右クリックし、プログラムから開く → Google Chromeを選択）。作成者はMacのChromeでテストし、動作することを確認しています。Safariはレコードリンクをブロックします。作成者はテキサス形式のレコード引用（12 R.R. 41）でレコードリンクをテストしましたが、他の形式ではまだテストしていません。Windows PCではテストしていません。ChromeはWindowsでも動作するはずですが、Microsoft Edgeも可能性がありますが、作成者は試していません。」
• ステータスごとのカウント。
• 各「check」アイテムを1〜2行で、修正方法とともに。
• 「ピンク漏れ」の引用、引用されていないステートメント、ロードされなかったか拒否されたソース、およびリンクできなかったレコードファイル。
• レコードリンクが確認されたかどうか（ステップ8を参照）。
• 作業を進める2つの方法: Claudeと各フラグについて話し合い、リストを保持し、ユーザーの承認後に変更を行う。または、Wordで作業し、ビューアを横に開き、メモボックスに修正を入力する。「すべてのメモをコピー」はビューア内のボタンで、ユーザーのみが押すことができ、コピーしたリストをこのチャットに貼り戻せることを伝えてください。

スクリプト

star_extract.py: PDFとスター改ページのリストを受け取り、各ページのテキスト、前のページの末尾、および各マーカーが表示されるPDFページを返します。

import re, subprocess, sys, json

def pdf_pages(pdf):
    info = subprocess.run(['pdfinfo', pdf], capture_output=True, text=True).stdout
    n = int(re.search(r'Pages:\s+(\d+)', info).group(1))
    return [subprocess.run(['pdftotext', '-f', str(i), '-l', str(i), pdf, '-'],
                           capture_output=True, text=True).stdout for i in range(1, n + 1)]

def clean(t):
    t = re.sub(r'WESTLAW\s*©.*?For Educational Use Only[^\n]*\n', '', t, flags=re.S)
    t = re.sub(r'\*\*\*?\d+\s?', '', t)          # パラレルリポーターマーカーを削除
    t = re.sub(r'-\n(?=[a-z])', '', t)
    return re.sub(r'\s+', ' ', t)

def segments(pages):
    parts

…

[翻訳のため一部省略]