PubLedge

PubLedge

2者間の事実に即した書面による解釈（共同解釈合意（JIA）、規制上の緩和合意（RMA）、不執行通知、私的書面回答、助言意見、および類似の市民向け文書（HOAの決定記録、協同組合のガバナンス記録、飛行クラブの資産合意など））を対象とする、オープンな記録管理プロトコルです。

構造化されたフロントマターを持つプレーンなMarkdownです。SHA-256マニフェストのチェックにより、ソースとマニフェストの整合性を確認します。Semantic Arts gist上位オントロジーに準拠しているため、異なる当局の記録をまとめて照会できます。

公開され、保守されています。パッケージ v0.2.5、プロトコル仕様 v0.2.0です。MCP サーバーは、MCP 2026-07-28のステートレスコアと、従来の2024-11-05ハンドシェイクに対応しています。npm、MCP Registry、GitHubタグ、GitHub Releaseの最新の観測結果は、公開状態に記録されています。具体的な法的グラフまたは導入者からの需要が確認されるまで、独立した製品への拡張は保留されています。

対象者

事実に即した書面による解釈を発行または依拠し、それらを移植可能で照会可能な形式で記録する必要がある規制当局、規制対象の当事者、市民団体を対象としています。

解決する課題

事実に即した解釈（不執行通知、私的裁定、JIA、HOAの決定）は、当局をまたいで比較できない、分散した非構造化記録として存在しています。PubLedgeは、共通オントロジーに準拠し、マニフェストで検証されたMarkdownとして記録するオープンプロトコルです。

正規URL

https://publedge.org/

PAICE法的グラフの一部

PubLedgeは、PAICE法的グラフ（EveryAILaw、AI Incident Law、Obligation Firstと連携）の構成要素の1つです。意図的にオープンにしています。コードはApache 2.0、プロトコルとコンテンツはCC BY 4.0で、クレジット表記を条件に商用利用が認められています。オープンな姉妹プロジェクトは、グラフ内で唯一の制限レイヤーであるEveryAILaw Proによって資金提供されています。ここをオープンにしているのは、PBC憲章に基づく意図的な選択です。正規モデルはPAICE Foundation INTENTにあります。

このリポジトリの内容

次の3つをまとめています。

1. プロトコル — PROTOCOL.md仕様と、その策定の背景を示す調査資料PRIOR-ART.mdです。
2. ユタ州に基づく参照コンテンツ — UtahのAI Policy Act（Utah Code §13-72a）およびGenAI safe-harbor（§13-75-104）に基づく5つのJIA/RMAテンプレートに加え、8つの当局（Utah OAIP、Utah Legislature、Colorado Legislature、SEC、CFPB、IRS Chief Counsel、IRS TEGE、CFTC）と7種類の文書（JIA、RMA、不執行通知、助言意見、私的書面回答、解釈書、制定法）にまたがる18の実例文書がdata/examples/instruments/にあります。data/examples/obligations/にある35件の第一級義務記録は、data/examples/mapping/index.ymlを介して文書に対応付けられています。法的なライフサイクルは、編集上の成熟度とは別に追跡されます。
3. 公開サイト — docs/にHTMLが生成され、GitHub Pagesによってmain /docsから配信されます。コミット前にnode scripts/build.js && node scripts/build-extras.jsを実行して再生成してください。docs/がソースと一致しない場合、CIは失敗します。

メンテナンスの範囲

週次チェックでは、期限超過の記録や時間的な不整合にフラグを付け、人によるレビューを促します。別途実施する手動パイロットでは、選定した3つの公式ソースを監視し、アクセスできないソースと未解決の調査結果を保持します。検証日や法的ステータスを更新したり、コーパス全体を対象にしたりするものではありません。実行漏れの独立した監視と、復旧メールの受け入れ確認は引き続き未対応です。日付入りの証拠とレビュー範囲については、メンテナンスパイロットを参照してください。

機械可読エンドポイント

エージェントがスクレイピングせずにレジストリをたどれるよう、すべての記録とインデックスはHTMLと構造化形式で並行して公開されています。

サーフェス	形式
/	WebSite、Organization、DataCatalog の JSON-LD（@graph）。すべてのデータセット配布先へのリンクを含みます
/us/{jurisdiction}/{authority}/{type}/{instance}/	記録ごとの正規階層 URL。インラインの Schema.org LegalDocument JSON-LD を含みます。PDF と OCR テキストを同じ場所に配置しています
/us/{jurisdiction}/{authority}/{type}/{instance}/record.json	同じ記録を JSON で提供します。形式は /schema/json/record.schema.json で検証されます。該当する場合は authority_response 注釈を含みます
/instruments.html、/obligations.html、/authorities.html	ItemList JSON-LD。人が使えるフィルターと並べ替えを備えています
/matrix.html	Dataset JSON-LD とカバレッジマトリックス。/api/v1/matrix.json に DataDownload 配布があります
/definitions/	文書の種類とステータスを DefinedTerm として含む DefinedTermSet
/api/v1/*.json	機械可読マニフェスト：コンテナ、主要文書、当局、マッピング、マトリックス、近日予定、最近の変更
/api/v1/of/*.json	当局、文書、用語、義務、および行政上の発行判断を対象とする Obligation-First バインディング記録
/calendar.ics	執行カレンダー（iCal）
/feed.xml、/atom.xml、/feed.json	RSS 2.0、Atom 1.0、JSON Feed 1.1
/sitemap.xml	サイトマップインデックス → セクション別サイトマップ（records、authorities、statutes、reference、templates、bridges、meta）
/llms.txt、/agents.json	エージェント向けの発見情報と機能
/.well-known/mcp.json	インストール可能な MCP サーバーの発見情報。正確なパッケージ識別情報とプロバイダーに関する観察結果は、公開状態に記録されています
/robots.txt	17のAIクローラー（GPTBot、ClaudeBot、PerplexityBot、Google-Extended、Applebot-Extendedなど）を明示的に許可します
mcp-server.js	読み取り専用の13個のツールを公開する MCP サーバー：list_<legal-instruments>（管轄、当局、種類、ステータスによるフィルター付き）、get_<legal-instrument>、list_obligations、get_obligation、list_authorities、get_authority、search、search_obligations、get_matrix、get_mappings、fetch_by_url、get_upcoming、get_recently_changed

このリポジトリに該当しないもの

• 規制当局ではありません。PubLedge は裁定を下しません。
• 法律事務所ではありません。ここにあるテンプレートは先行事例であり、法的助言ではありません。
• CMSではありません。編集者は Git 内の Markdown を編集します。
• ブロックチェーンではありません。完全性レイヤーは、プレーンなファイルに対する単純な SHA-256 です。

クイックスタート

git clone https://github.com/snapsynapse/publedge.git
cd publedge
./scripts/validate-hashes.sh           # verify integrity
node scripts/validate.js               # cross-reference checks
node scripts/build.js                  # regenerate docs/ entity pages + API
node scripts/build-extras.js           # copy reference HTML, feeds, discovery files

Obligation-First バインディングを検証するには、このリポジトリの隣に snapsynapse/obligation-first をチェックアウトするか、OBLIGATION_FIRST_DIR を設定してから、npm run validate:of を実行してください。

意図的にコンテンツを編集した後は、ハッシュを更新してください。

./scripts/validate-hashes.sh --update

CI では、上記すべてに加えて、サイトマップ内のすべての URL を対象とした pa11y-ci WCAG 2.1 AA チェックを、プッシュとプルリクエストのたびに実行します。

PubLedge を 5 分で使う

用途に合った方法を選んでください。

1. 文書一覧を閲覧するか、SEC CorpFin のノーアクションレターなどの標準レコードを開きます。
2. HTML をスクレイピングせずにインデックスを照会します。

curl -sS https://publedge.org/api/v1/containers.json | jq '.[0]'

3. 標準レコードの URL の末尾に record.json を追加して、レコード形式の JSON 表現を取得します。

curl -sS https://publedge.org/us/federal/sec-corpfin/nal/2025-001/record.json | jq '.id, .status'

4. 公開状態でプロバイダー検証済みの npm バージョンを確認し、そのパッケージバージョンを stdio 対応クライアントに追加します。以下の例では、このパッケージバージョンを使用しています。

{
  "mcpServers": {
    "publedge": {
      "command": "npx",
      "args": ["-y", "[email protected]"]
    }
  }
}

5. search を使ってレコードを見つけ、標準的な PubLedge URL がすでに分かっている場合は fetch_by_url を使います。このパッケージでは、上記の 13 個のツールを利用できます。エンドポイントと機能の全一覧は、api/v1/index.json、agents.json、ソース管理された公開状態にあります。

data/examples/ 内の標準 Markdown が、保守対象のソースです。公開 HTML、API インデックス、および各 record.json は生成された表現であり、直接編集しないでください。リポジトリのチェックアウト手順はソースコードを対象としたものであり、インストール可能であることを示すものではありません。プロバイダー検証済みのパッケージを選ぶには、標準の公開状態を使用してください。

リポジトリの構成

パス	目的
PROTOCOL.md	PubLedge の仕様
INTENT.md	リポジトリの正式な方針、進行中の作業、および再検討の契機
PRIOR-ART.md	類似する文書プログラムの調査
DEFINITIONS.md	標準用語（ステータス値、文書の種類、義務の種類）
MANIFEST.yaml	すべての標準ファイルの SHA-256 ハッシュ
_templates/jia/, _templates/rma/	{{variable}} プレースホルダーを含む記入用テンプレート
data/examples/instruments/	18 件の文書例。ファイル名は安定した ID（例：us-ut-oaip-rma-2025-001.md）
data/examples/authorities/	各発行機関の機関レコード
data/examples/obligations/	文書から参照される義務の定義
data/examples/mapping/	義務と法令の対応付けインデックス
about/	手作業で作成された /about/ のソースページ（docs/ にそのままコピー）
reference/	手作業で作成された参照 HTML（先行事例、免責事項、用語集）
schema/json/	JSON Schema と JSON-LD コンテキスト
vendor/gist/	Semantic Arts gist コアオントロジーの固定スナップショット
scripts/	バリデーター（validate.js、verify.js）、ビルド（build.js、build-extras.js）、ハッシュ確認
_workshop/	サイトオントロジーのワークショップ成果物（分類体系、サイトマップ、コンテンツガイド、ロードマップ）

_workshop/ ディレクトリには、上記の構成に関する設計上の判断が記録されています。構造変更を提案する前に、_workshop/TAXONOMY.md、_workshop/SITEMAP.md、_workshop/CONTENT-GUIDE.mdをお読みください。

文書を追加する

1. _templates/jia/ または _templates/rma/ のテンプレートを選びます。
2. すべての {{variable_name}} を該当する値に置き換えます。
3. id を {jurisdiction}-{authority}-{type}-{YYYY-NNN}（例：us-ut-oaip-rma-2025-003）に設定します。ファイル名も一致させる必要があります：us-ut-oaip-rma-2025-003.md。
4. 法的な status: proposed と editorial_status: draft を設定します。parties: の下に当事者を追加します。
5. ファイルを data/examples/instruments/ に配置します。
6. ./scripts/validate-hashes.sh --update を実行して、MANIFEST.yaml を更新します。
7. node scripts/build.js && node scripts/build-extras.js を実行し、サイトが問題なく再生成されることを確認します。
8. プルリクエストを作成します。

義務エントリー、ソース PDF、OCR ワークフローを含む規約の詳細は、CONTRIBUTING.md を参照してください。

ライセンス

PubLedge はデュアルライセンスです。

• コンテンツ（markdown、YAML、HTML）— CC-BY 4.0
• コード（スクリプト、スキーマ、ビルドツール）— Apache 2.0

ライセンスの適用範囲については、LICENSE をご覧ください。ベンダー提供のスナップショットには、引き続きそれぞれの上流ライセンスが適用されます。固定済みの gist コアオントロジー は CC-BY 4.0（Semantic Arts）です。クレジットの詳細は ATTRIBUTION.md をご覧ください。

基盤

• Knowledge as Code — PubLedge が受け継ぐ、4 つの役割からなるエンティティパターン（Authority / Container / Secondary / Primary）。
• gist (Semantic Arts) — PubLedge のエンティティに結び付けられたオープンな上位オントロジー。
• Every AI Law — statute_anchors[] の法令アンカー URL の推奨ソース。
• skill-provenance — validate-hashes.sh に適用されたハッシュ機構のパターン。PubLedge は skill-provenance プロトコル全体を採用していません。

ステータスとロードマップ

マイルストーン	ステータス
ワークショップ、分類体系、サイトマップ、コンテンツガイド	完了
プロトコル仕様（PROTOCOL.md）	完了
先行事例調査（PRIOR-ART.md）	完了
Utah 向け初期テンプレート（JIA 3 件、RMA 2 件）	完了
最初のレジストリインスタンス（us-ut-oaip-jia-2026-001）	完了
ハッシュ固定による完全性の確保 + CI 検証	完了
ディスカバリーファイル（llms.txt、agents.json、feed.xml）	完了
MCP サーバー（mcp-server.js）	完了
CLI バリデーター（scripts/validate.js、scripts/verify.js）	完了
JSON スキーマ + JSON-LD コンテキスト（schema/json/）	完了
統合サイトジェネレーター（build.js + build-extras.js）	完了
フロントマタースペック v0.2	完了
連邦 + Utah のデモ用リマップ 9 件	完了
Utah の法令 4 件を第一級の文書レコードとして登録	完了
正規 URL アーキテクチャ（/{country}/{jurisdiction}/{authority}/{type}/{YYYY-NNN}/）	完了
各文書の record.json（Schema.org LegalDocument JSON-LD）	完了
calendar.ics、api/v1/upcoming.json、api/v1/recently_changed.json	完了
ステータス語彙（9 値）+ DEFINITIONS.md + /definitions/ ページ	完了
作成者による取り込み用 publedge-source-ingest スキル	完了
/reference/disclaimer/ の免責事項とソースポリシー	完了
義務 + マッピングのキュレーションパス（義務 35 件、マッピング 16 件）	完了
トップレベルページの JSON-LD（ホームの @graph、ItemList インデックス、DefinedTermSet、Dataset）	完了
分割サイトマップインデックス + 7 つのセクションサイトマップ	完了
RSS と併せて JSON Feed 1.1 + Atom 1.0 フィードを提供	完了
/schema/json/record.schema.json（JSON Schema draft 2020-12）	完了
MCP ツールの拡張（13 ツール。フィルター、URL ベースの取得、近日公開、最近の変更）	完了
robots.txt に AI クローラーの明示的な許可リストを設定	完了
権限応答プロトコルのフィールド、レンダリング、スキーマ、検証	完了
audits/ + .a11y-audit/ のエージェント対応状況 + a11y 監査成果物	完了
Axe-core WCAG 2.1 AA の修正（ルール 4 件、インスタンス 70 件 → 0 件）	完了
リリース前レビュー用のプライベートスナップショット	送付済み
弁護士レビュー（SLC の弁護士）	保留中。需要に応じて実施
リポジトリの仕上げ	完了
リポジトリの公開	完了
Obligation-First v0.4.x 命名プロファイル	完了
promo-orchestrator + 公開告知	保留
ブラウザー側のレジストリブラウザー + 比較ツール	保留
再利用可能なプロトコルテンプレートへのブランチ分岐と不要部分の削除	保留

フェーズ分けについては ROADMAP.md を、元のワークショップ計画については _workshop/ROADMAP.md をご覧ください。