Sourceright

Sourceright

Sourceright は、学術執筆、エージェントのワークフロー、および今後の法的引用作業に向けた、Rust を中心とする参考文献のトリアージと検証のためのインフラストラクチャです。現在は技術プレビューであり、開発者による評価やパイロット運用の検討に適しています。

対象ユーザー

• 監査可能な参考文献の整理を必要とする技術編集者や研究公正チーム。
• 決定論的な引用検証ワークフローを求める図書館、リポジトリ、出版社のチーム。
• サイドカー証拠を備えた CSL 中心の書誌パイプラインを必要とする開発者やエージェントのワークフロー。
• 学術用 CSL と混同せず、独立した法的引用の経路を評価するリーガルテックの研究者。

できること／できないこと

Sourceright は、文書やテキストから参考文献を取り込み、標準的な CSL JSON を生成し、レコードを標準化・クリーニングし、プロバイダーの証拠を収集します。不確かなレコードは手動レビューに回し、EndNote、Zotero、BibLaTeX などのツール向けに整理済みの参考文献ファイルをエクスポートします。

本番環境向けの機関製品、裁判所提出書類のコンプライアンスシステム、あるいは審査官レベルの最終検証の代替としての役割は謳っていません。引用の取り込みでは DOCX 原稿を直接解析できるようになりましたが、より広範な PDF 抽出、コアプロバイダーへのライブチェック、より優れた引用の曖昧性解消、URL／アーカイブの整合性、ノイズの少ない書き戻し提案は、引き続き強化が必要な項目です。

ワークフロー

document/text
  -> extracted references and in-text citations
  -> references.csl.json
  -> standardisation, cleaning, verification, enrichment
  -> references.verification.json and review-queue.jsonl
  -> conflict resolution, citation reconciliation, and reference integrity reports
  -> XML, ENW, RIS, BibLaTeX, and YAML exports

ロードマップ

• 学術参考文献の抽出と CSL JSON への標準化。
• まず Crossref を通じて検証し、その後、必要に応じて DOI 解決、DataCite、OpenAlex、PubMed/NCBI、ORCID を利用する、プロバイダーに基づく検証。
• 本文中の引用と参考文献リストの項目との照合。
• 人間とエージェント／サブエージェントによる検証を想定した手動レビューキュー。
• 編集ワークフロー向けのプラットフォーム中立なジャーナル審査出力。最初の公開統合対象は OJS です。
• 引用の整合性監査と、AI 関連の引用エラーの兆候を示す参考文献レポート。
• 同じ Rust コアを利用する CLI と MCP サーバーのインターフェース。
• 独立した法的引用モデルと公開プロバイダー用の拡張枠を備えた、法的引用の分析。
• 引用による裏付けを検出して構築する主張／出典／来歴グラフ。主張の真偽を断定するものではありません。
• より広範な PDF 抽出、ライブのプロバイダー証拠、機関著者の照合、URL／アーカイブのチェック、明示的な書き戻し計画に対応する、審査官レベルの監査強化。

実装トラックの一覧については、conductor/tracks.md を参照してください。 要件の正本とリポジトリの契約は docs/src/feature-contract-matrix.md にあり、 設計図は docs/src/design.md にあります。

現在の品質およびセキュリティ契約は docs/src/security-and-quality-gates.md に記載されています。 変更を開く前に、リポジトリの制限付きローカルゲートランナーを使用してください。

pwsh -NoProfile -ExecutionPolicy Bypass -File scripts/run-local-rust-gates.ps1
pwsh -NoProfile -ExecutionPolicy Bypass -File scripts/check-workflow-harness.ps1
pwsh -NoProfile -ExecutionPolicy Bypass -File scripts/check-release-parity.ps1

Linux または macOS では、Rust ゲートランナーとして ./scripts/run-local-rust-gates.sh も利用できます。ホストの stable ツールチェーンを使用し、 一時的な target ディレクトリを作成します。PowerShell ランナーも同じポリシーに従い、 GCC が利用可能な場合にのみ Windows GNU ツールチェーンを選択します。

現在の状況

Rust コアには、標準 CSL の処理、検証サイドカー、取り込み時のセグメンテーション、プロバイダーのエビデンス正規化、クリーニング、競合解決、引用の照合、手動レビューキュー、レポート作成、エクスポート、ジャーナル審査コントラクト、法的引用レコード、主張とソースの来歴グラフが含まれています。構造化されたトリアージと監査のワークフロー、および技術プレビューとして扱ってください。一方、進行中の Conductor プログラムでは、抽出、相互運用性、公開トライアル、外部レジストリでの受け入れに向けて強化を進めています。インポートされた参照ワークフローの資料は、監査、移植、または廃止されるまで、来歴およびリグレッション用の資料として legacy/humanizer-next/ に保管されています。

CLI

sourceright init [document-or-directory]
sourceright validate-csl [--json] <references.csl.json>
sourceright report [--json|--mcp-resource] [.sourceright-directory]
sourceright export --preview --all [.sourceright-directory]
sourceright bench [--json]
sourceright citation-sync [--preview|--apply] [.sourceright-directory]
sourceright mcp

bench は、ライブプロバイダーを使わずに、チェックイン済みのフィクスチャー一式を実行します。ベンチマーク機能は、決定論的なリグレッションチェックとストレスチェック向けの技術プレビューです。 citation-sync はデフォルトでプレビューモードで動作し、監査ログまたはリモートフィクスチャーのスナップショットを書き込むには、明示的に --apply を指定する必要があります。

report は CSL のみのディレクトリでも動作します。references.verification.json がない場合は、カバレッジ低下の診断を出力します。一方、不正なサイドカーがある場合は、低レベルのパーサーエラーだけを示すのではなく、パスと修復方法を提示して処理を失敗させます。

配布予定

• sourceright CLI バイナリ。
• sourceright mcp サーバーモード。
• プラットフォーム別バイナリ、チェックサム、来歴アーティファクトを含む GitHub Releases。
• リリースのドライランが成功した後の crates.io パッケージ。
• server.json と Dockerfile ラベルを使用した、公式 MCP Registry 向け OCI MCP イメージのメタデータ。
• ローカルの stdio/MCPB パスに対応する Smithery の準備。ホスト型 HTTP トランスポートは引き続き保留中です。
• glama.json による Glama 所有者メタデータ。
• リリースおよびタグ起点の公開ワークフローによる release-status.md アーティファクト。
• 定期実行されるカバレッジワークフローによる coverage-status.md アーティファクト。
• ネイティブのツールエコシステムで必要な場合に限る、薄いアダプターパッケージ。
• 現在進行中の強化プログラムは conductor/tracks.md に記録されています。ハーネス／セキュリティ／品質の CI、相互運用性フィクスチャー、抽出実験、オープンな公開プラットフォームでのトライアルが含まれます。
• 古いトラック番号は、履歴を追跡できるよう Conductor のアーカイブに残されています。現在の製品準備状況を示すものではありません。
• トラック 36〜40 では、審査担当者レベルの監査強化を扱います。文書抽出、ライブのコアプロバイダー、引用の曖昧性解消、URL／アーカイブの完全性、ノイズの少ない書き戻し提案が含まれます。
• これらのトラックの運用手順については、docs/src/release-runbook.md、docs/src/coverage-reporting.md、docs/src/docs-cutover.md を参照してください。
• v*.*.* タグを付けると、crate 公開ワークフローが自動で開始されます。また、MCP レジストリのワークフローはリリースワークフローの完了後に実行されます。

配布メタデータファイル

• server.json (io.github.edithatogo/sourceright)
• Dockerfile ラベル：
  • io.modelcontextprotocol.server.name
  • org.opencontainers.image.source
• glama.json

レジストリへの掲載は、外部の運用面にあたります。現在の状況と、メンテナーまたはプラットフォーム側に残っている阻害要因は conductor/submission-packets/live-evidence.json に記録されています。リポジトリのメタデータだけでは、スコアが公開されていることや、呼び出し可能なツールとして掲載されていることの証明とはみなしません。

開発

cargo check
cargo test
cargo fmt --check
cargo clippy --all-targets -- -D warnings
cargo run --bin sourceright -- bench
cargo package --locked
cargo publish --dry-run --locked
cargo machete
cargo semver-checks check-release --release-type minor  # advisory until the public Rust API is stabilized
cargo deny check advisories bans sources
cargo tree -d --locked
taplo lint Cargo.toml book.toml deny.toml lychee.toml rust-toolchain.toml taplo.toml typos.toml fuzz/Cargo.toml plugins/**/*.toml .cargo/config.toml
typos --config typos.toml
npm --prefix docs-site run typecheck
vale --minAlertLevel=error README.md docs/src docs/import-manifest.md .github/copilot-instructions.md
npx --yes [email protected] README.md "docs/**/*.md" ".github/**/*.md"
lychee --config lychee.toml --offline README.md docs/src/**/*.md docs/import-manifest.md
actionlint
zizmor --min-severity medium .github/workflows
cargo llvm-cov --locked --all-targets --fail-under-lines 85
cargo mutants --workspace
pwsh -NoProfile -ExecutionPolicy Bypass -File scripts/verify.ps1 -CoverageMinimum 85

CI とチェックイン済みの pre-commit フックでは、行カバレッジが 85 パーセントを超えることが引き続き必須です。

リリースワークフローと公開ワークフローは、それぞれ release-status.md アーティファクトを出力するため、最新のタグに対応するチェックリストを名前付きで確認できます。 カバレッジの実行では coverage-status.md アーティファクトを出力するため、最新の数値レポートに対応するチェックリストを名前付きで確認できます。

ライセンス

以下のいずれかのライセンスが適用されます。

• Apache License, Version 2.0
• MIT license

選択は任意です。