VergeCommon

VergeCommon

保全活動をオープンソースプロジェクトにできるとしたら？

VergeCommon のご紹介：共有する場所を大切にする人々のためのオープンなツールです。

地域の保全プロジェクトを企画し、作業を記録し、みんなで決定を下しましょう。生け垣や雑木林から広大な景観まで、地域の人々が頼りにするツールを確認し、調整し、改善できるようにする必要があります。

協同組合による初期パイロットです。 ブラウザーアカウント、非公開の協同組合、スコープを限定したエージェントアクセスを備えた共有ウェブサイトが稼働しています。リポジトリには、セルフホスト可能なアカウント／ストレージのランタイムと、ネイティブの参加機能のソースも含まれています。ぜひ私たちと一緒に構築し、テストしてください。実際のパートナーによる導入と、検証済みの環境への影響は、まだ実証されていません。現在の状況と稼働中のサービス範囲、今後の予定については、現在の状況とサービスの対象範囲をご覧ください。

最初の貢献を見つける

あなたの経験	こちらから始めましょう
地域の保全活動の経験	合成データを使って1つのアクティビティを試し、最初に戸惑った手順を報告してください。
現地調査または研究の経験	モニタリングのワークフローを確認し、不足している証拠や不確実性を特定してください。
デザインまたはアクセシビリティのスキル	キーボードまたは狭い画面でプランナーを試し、再現可能な障壁を報告してください。
開発スキル	プロジェクトをローカルで実行し、コントリビューターガイドから範囲の明確なタスクを選んでください。

クイックスタート · 貢献ガイド · ロードマップ · パイロットチェックリスト · ローンチキットとリリースゲート

プロジェクトを見る

ウェブサイト · 保全ネットワーク · メンバー用ワークスペース · アカウントとデバイスのアクセス · 貢献する

vergecommon.com は正式なサービスアドレスです。現在稼働中の機能、検証済みの内容、未解決の項目については、STATUS.mdをご覧ください。 デプロイ済みサービスには、ローンチ基盤（PR #2）、会話アクション、ソーシャルサインインの対応（PR #3）が含まれます。日付入りのデプロイ記録とレビューはdocs/history/にあります。協同組合とプロジェクトの公開は任意です。メンバーの記録と非公開の土地に関する証拠には、サーバー側のアクセスルールが引き続き適用されます。

独自のコミュニティを始める

セルフホストするアプリケーションでは、Node 24.19.0を使用し、単一サーバー運用者ガイドに従ってください。ブラウザーアカウント、SQLite、非公開の証拠ファイル、デバイストークン、ホスト型MCP、デプロイ設定、バックアップ／復元手順が含まれています。公開する前に、隔離されたローカルインスタンスを構築して動作を確認してください。

従来のCloudflare/Sites開発パスも、Node.js 22.13+でnpm run launchを実行して利用できます。このパスのIDは開発用のフィクスチャです。開発サーバーを決して公開しないでください。どちらのワークフローでも、協同組合を作成し、開始チェックリストに従ってください。地域ごとの設定については、世界各地への導入をご覧ください。

Viridis オープンコモンズの一部

VergeCommon は、相互に連携する5つのオープンプロジェクトの1つです。それぞれ単独でも役立ちますが、組み合わせることで、土地を地図から検証済みの成果へとつなげます。

プロジェクト	内容	場所
Dendritic Forest Management (DFM)	既存の道路や水路を起点に、伐採計画を進めるなかで、保全対象の森林のつながりが維持されるかを確認します。MIT。	hdfm-framework · dendriticforest.com
VergeCommon	近隣住民が地域の保全協同組合を運営できるようにします。非公開の地図作成、区画ごとの同意、証拠の共有、共同での意思決定を支援します。森林地帯でのプロジェクトでは、DFM を実行します。AGPL-3.0。	verge-common · vergecommon.com
Global Soil Intelligence Project (GSIP)	オープンな土壌スペクトル参照ライブラリを構築し、スマートフォンとウェブからデータを収集します。コードは MIT、データは ODbL。	gsip
ViridisOS	検証済みの成果を、誰でも確認できる再計算可能な保全モジュールと証明書に変換します。Apache-2.0。	viridisos
Viridis Research	手法の根拠となる、公開され機械検証された研究記録です。CC BY 4.0。	viridis-research

連携の仕組み：DFM が回廊の位置を特定します。回廊はほぼ必ず敷地の境界をまたぐため、VergeCommon は沿線の近隣住民が非公開で組織を作り、同意を得る場を提供します。GSIP は同じ土地の土壌に関する証拠を追加します。ViridisOS を使えば、誰でも主張の内容を再計算でき、Viridis Research にはその検証の根拠となる証明が収められています。Viridis Conservation (viridisconservation.com) は、支援を必要とするチーム向けに、有料のデータ準備、評価、サポートを提供します。

これらのプロジェクトを使って何かを作りましたか？バッジを追加して、イシューでお知らせください。こちらからリンクを掲載します。

[![Part of the Viridis open commons](https://img.shields.io/badge/Viridis-open%20commons-2e7d32)](https://github.com/jdhart81/hdfm-framework#part-of-the-viridis-open-commons)

エージェントと MCP

VergeCommon について学ぶエージェントは、llms.txt（ソース：public/llms.txt）と AGENTS.md から始められます。これらには、協同組合の設立を人に支援する方法や、プロジェクトへの貢献方法が記載されています。

MCP サーバーは、セルフホスト環境でローカルの stdio と、認証済みの Streamable HTTP（/mcp）をサポートします。ローカルの stdio では、公開情報の検索と、仮想的な共同出資・割り当ての下書き作成ができます。mcp:read を持つホスト型トークンでは、所有者がアクセスを許可したワークスペースも読み取れます。mcp:write を追加すると、範囲を限定したプロジェクト、メンバー更新、タスク、出欠確認のコマンドが利用できます。アプリトークンと MCP トークンのスコープは別々です。

公開情報の検索と計画用の5つのツールは、アカウントなしでホスト型エンドポイントから利用できます（レート制限あり）。非公開の協同組合ツールを利用するには、/account から個人用エージェントトークンを作成し、クライアントのシークレット設定に保存して、利用後に失効させてください。非公開アクセスには bearer 対応が必要です。OAuth は実装されていません。エージェントは、法務・財務記録の承認、メンバーシップの昇格、クレジットの発行、支払いの実行、公開更新の投稿はできません。本番エンドポイントは、2026年9月19日に、初期化、非公開データの読み取り、範囲を限定した書き込み、財務関連コマンドの拒否について受け入れ確認に合格しました。

エージェントから試す

5つの公開ツールは、アカウントもトークンも必要ありません。Claude Code では次のようにします。

claude mcp add --transport http vergecommon https://vergecommon.com/mcp

JSON 設定を受け付けるその他の MCP クライアントでは、ヘッダーなしのリモート Streamable HTTP サーバーとして追加できます（フィールド名はクライアントによって異なります。タイプに streamable-http を指定するものもあれば、url だけでよいものもあります）。

{
  "mcpServers": {
    "vergecommon": {
      "type": "http",
      "url": "https://vergecommon.com/mcp"
    }
  }
}

トークンなしで使える、貼り付け用のプロンプト：

1. VergeCommon はアカウントがなくても何ができますか。また、参考にできる公開の保全協同組合はありますか？
2. 保全協同組合がどのように作業を共同で行い、収入を分配するかについて、VergeCommon の例を示し、わかりやすく説明してください。
3. VergeCommon を使って、例の共同プール案を、メンバーの持分を 50％、30％、20％、生態学的準備金を 30％として再計算してください。各メンバーの試算上の分配額はいくらになりますか？

制限事項：トークンがない場合に利用できるのは、5つの公開ツール（vergecommon_capabilities、list_public_coops、get_public_coop、example_pooling_draft、prepare_pooling_draft）のみです。レート制限はクライアントごとに毎分 60 リクエスト、全体で毎分 600 リクエストです。プライベートな協同組合のツールを使うには、アカウントページで作成した個人用エージェントトークンを、Authorization: Bearer ヘッダーとして送信する必要があります。

実装済みの機能

• 表示中のオンラインブラウザーワークスペースは、マウント済みの下書きを破棄することなく30秒ごとに更新されます。権限を考慮したレビューリマインダーには、モニタリング記録と財務記録が含まれます。

• メンバーの支払い領収書に加えて、スチュワードシップと財務管理の領収書を利用できます。これらには、独立したレビュー、正確な配分の照合、プロジェクトに紐づく証拠が含まれます。これらの記録によって送金が行われることはありません。

• Discussion 内で、非公開のマッピング、同意、証拠、パートナーの参加、契約、ガバナンス、外部領収書に関する協同組合のアクションをガイドします。役割に応じた選択肢があり、下書きも保持されます。会話アクション。

• 永続性のある SQLite と非公開の証拠ファイルを備えた単一サーバーの Node ランタイム、認証済みゲートウェイ、ユーザー名とパスワードによるアカウント、復旧コード、アカウントのエクスポートと閉鎖、取り消し可能なデバイス／エージェントトークン。

• 境界に基づく面積の推定、重複のスクリーニング、レビュー済みの区画ごとの同意、適用範囲を限定した契約、古い記録の検出、撤回／取り消し履歴。プーリングの安全対策。

• 認証済みのメンバーワークスペース、メンバーの投稿、明示的なフィールド下書きの送信、写真／PDF／テキスト証拠の明示的な送信に対応する iPhone／iPad 向けソース。保護されたアカウント紐づけ型キューは、中断された接続でも正確な再試行リクエストを保持します。公開情報の探索機能と保護されたオフラインジャーナルは引き続き利用できます。署名、デバイスの承認、Apple による配布は、別途リリース手順が必要です。

• エクスポート可能な画像処理ジョブと独立した NDVI スクリーニングワーカーを備え、検証済み結果のインポートと人によるレビューに対応します。ワーカーの手順。

• 非公開のバージョン管理された GeoJSON 境界、独立したレビュー、外部検索への明示的な同意、Copernicus Sentinel-2 カタログの検索、レビュー済みの現地観測に対応します。モニタリングを参照してください。

• メンバー向けコミュニティ掲示板。共有イベント、定員を考慮した出欠確認、非公開のカレンダーダウンロード、プロジェクトのディスカッション、スチュワードによるモデレーションに対応します。

• 6つのステップで進める協同組合のセットアップ、地域の組織を見つけるリンク、自己申告による組織プロフィール。

• 有効期限と取り消しを設定でき、記録へのアクセス前にスチュワードの承認が必要な、一度だけ使用できる非公開招待。

• 国／地域と会計通貨の設定、通貨の最小単位への対応、ヘクタール／エーカー／m²による入力。

• 方法論の参考情報と独立した人によるレビューを含む、スナップショットに基づく炭素経路評価。

• メンバーがポリシーを提案して投票する前に確認できる、支払いのサンプル計算。

• スチュワード／メンバーの役割とメンバーシップ申請に対応した、サインイン済みの永続的な協同組合ワークスペース。

• オプトイン式の協同組合／プロジェクト検索、一般的な地域検索、共有可能なリンク、更新、モデレーション。

• プロジェクト、割り当て済みの保全活動、完了記録、非公開の区画／同意の受付。

• 独立したレビューと外部で締結された契約文書への参照を含む、非公開の契約提出。

• 非公開の PDF／画像／テキストのアップロード、SHA-256 ファイルダイジェスト、証拠の提出と独立したレビュー。アップロードの正確な再試行、キャンセル、有効期限、永続的なクリーンアップにも対応します。

• パートナー代表者の招待、承諾、固有の権限証拠、協同組合による独立したレビュー、参加の撤回。これによって追加の権限が付与されることはなく、組織が独立して検証されることもありません。

• 大まかな容量警告と、許可された安全対策のための有限の予備枠。通常の追加はハードリミットに達する前に一時停止します。

• 選挙権者を固定する、バージョン管理された配分憲章の提案。メンバー投票、定足数、集計に対応します。

• 外部の法的権限、クレジットの連番管理、決済、配分、支払い領収書、償却の記録。

• 2名によるレビュー、セント単位の配分、協同組合ごとの数量上限、参照の重複検出、相互に紐づく監査履歴。

• 範囲を限定した JSON エクスポート、メンバーシップの削除、メンバーの脱退、ワークスペースのアーカイブ。

• 別個の仮想的な /coop/ 計算ツールと、デバイス内で完結する /demo/ スチュワードシッププランナー。

システムが実行しないこと

Verge Common は、法的な協同組合の設立、権利証書の作成や記録、生態学的測定の認証、レジストリクレジットの発行や移転、販売の開始、支払いの送金、銀行やレジストリの受領証の独立した検証を行いません。これらの操作は、権限を持つ人や外部機関が実行します。システムは、それらを裏付ける記録とレビュー判断を保存します。

協同組合の準備と運用記録のワークフローは実装済みですが、レジストリや決済プロバイダーとの直接連携は実装されていません。reviewed の受領証は、別の管理者がレビューを記録したことを意味し、銀行やレジストリがソフトウェアに対して独立して認証したことを意味するものではありません。OPERATIONS.md と COOPERATIVE_SYSTEM.md を参照してください。

ローカル開発

セルフホスト可能な本番ビルドをローカルで実行する場合は、Node 24.19.0 を使用します。

npm ci
npm run build:selfhost
VERGE_DATA_DIR=/tmp/vergecommon-local-data npm run start:selfhost

表示されたループバック URL を開き、ローカルアカウントを登録します。リカバリーコードは非公開で保管してください。データパスは永続化されるため、合成データによる受け入れテストには専用の空のパスを使用してください。正規のオリジン、リバースプロキシ、永続ボリューム、本番設定については、運用ガイドに従ってください。

従来の Cloudflare/Sites 開発ワークフローでは、Node.js 22.13 以降と npm を使用します。この開発専用のサインインサーバーは、ローカルでのみ実行してください。

npm ci
npm run db:migrate:local
npm run dev

表示されたローカル URL を開き、「サインイン」を使用します。ローカルデータとファイルは、無視対象の .wrangler/ の下に保存されます。デフォルトのローカル ID は開発用フィクスチャであり、本番アカウントではありません。

検証

オープンな DFM エンジンを使用して再現した森林地帯の回廊チェックを含む、期待される出力付きの正確なコマンドについては、クイックスタートを参照してください。VergeCommon を引用する場合は、CITATION.cff を使用してください。

npm test
npm run typecheck
npm run lint
npm run build:selfhost

専用の合成データを使用してローカルのセルフホスト可能な本番ビルドを実行している状態で：

VERGE_TEST_ORIGIN=http://127.0.0.1:3100 python3 tests/selfhost_acceptance.py

これにより、独立したアカウント、招待とアクセス境界、バージョンの競合と再試行、証拠の保存、トークンのスコープと失効、ホスト型 MCP、アカウントの閉鎖を検証します。ランナーはデフォルトでローカルサービスを使用し、正規の本番サービス上にある非公開の合成フィクスチャを使うには明示的なオプトインが必要です。実際の結果については、機能受け入れテストとデプロイ受領記録を確認してください。

従来の Cloudflare 開発サーバーを実行している状態で、HTTP の永続性と並行処理のチェックを実行します。

python3 tests/http_integration.py

ローカルテストでは合成レコードを使用し、作業領域をアーカイブします。別途承認された本番受け入れテストでも、非公開の合成レコードを使用し、作業領域をアーカイブしたうえで、テスト用ログインアカウントを閉鎖しました。

ホスティングと認証

2つの実行方式で、同じルート、SQL スキーマ、協同組合の状態転送、ドメインコマンドを共有します。

• セルフホスト型 Node： npm run build:selfhost で、同梱ゲートウェイ向けの共有アプリをビルドします。SQLite アダプターが D1 を置き換え、非公開のローカル証拠データが R2 を置き換えます。単一のアプリケーションプロセスを Caddy の背後で実行し、アプリケーション内部のリスナーはループバックからのみアクセスできます。ブラウザーアカウントでは、ソルト付き scrypt パスワードハッシュと安全なセッション Cookie を使用します。有効期限付きのデバイス／エージェントトークンはハッシュ化して保存され、リクエストごとに検証され、失効させることができます。Cookie の書き込みには正規のオリジンが必要です。検証済みのベアラークライアントは、ブラウザーの Cookie をコピーせずに独自のスコープを使用します。
• Cloudflare／Sites： npm run build では、Worker、D1、R2 を使用するデプロイ構成が維持されます。Sites ディスパッチャーが認証済みの ID を提供し、呼び出し元の ID ヘッダーを削除します。.openai/hosting.json には元のホスティングプロジェクト ID が保持されています。フォークでは、独自のプロジェクトとストレージバインディングを使用する必要があります。

どちらの方式でも、非公開 API 内で協同組合のメンバーシップとロールを適用します。アプリケーション内部のリスナーを公開したり、呼び出し元が提供した ID ヘッダーを信頼したりしないでください。セルフホスト型アカウントでは、ユーザー名と一度限りのリカバリーコードを使用し、メール認証、メールによるリセット、MFA、OAuth プロバイダーには対応していません。リカバリーコードは安全に保管してください。パスワードを変更または復旧すると、それ以前のセッションとトークンは失効します。セキュリティ、アーキテクチャ、運用者向けガイドを参照してください。

セルフホスト型アダプターは、既存の初期 SQL マイグレーションをトランザクション内で適用します。既存の Sites デプロイからデータや ID を自動的にコピーすることはありません。デプロイ済みのマイグレーション履歴を保持し、以降のスキーマ移行やレコード移行は、バックアップを使ってリハーサルしてください。

データ境界と運用上の制限

公開プロフィールに表示されるのは、明示的に公開されたプロジェクトの概要／更新情報、一般的な地域、アクティブなメンバー数のみです。契約、土地の参照情報、証拠データは、それらを提出したメンバーと管理担当者に限定されます。メンバーは協同組合のガバナンス記録と財務記録を閲覧できますが、支払い用の銀行口座情報は収集されません。ファイルは添付ファイルとしてダウンロードされます。プライバシーポリシーを確認してください。

セルフホスト型ランタイムがサポートするのは、単一のアプリケーションプロセスと単一のローカル SQLite データベースです。レプリケーション構成や高可用性構成でのデプロイには対応していません。ローカルでの毎日のバックアップが有効になっており、ステージング環境と本番環境での復元検証に合格し、初回分の本番アーカイブも照合したうえでホスト外にコピー済みです。復旧の正確な結果については、デプロイレシートを参照してください。定期的な暗号化済みオフサイトバックアップのスケジュールと復旧キーの管理は、引き続き運用者による設定が必要です。各協同組合は、アトミックにバージョン管理される集約データです。アプリケーションのハード上限は 750 KB、メンバーレコードは 500 件、監査イベントは 5,000 件です。次の候補リリースでは、認可された安全確保のための措置に有限の容量を確保できるよう、通常のデータ増加を 650 KB または監査イベント 4,500 件で一時停止します。非公開の容量バナーでメンバーに警告します。ファイルストレージは、協同組合ごとに最大 200 ファイル、1 ファイルあたり 4 MB です。このアーキテクチャは、初期のパートナー協同組合での正確性を優先しています。より大規模なデプロイの前に、正規化されたイベント／レコードストアが必要です。協同組合間またはインストール間でのレジストリー上の主張については、外部レジストリーによる権威ある重複／保管確認が引き続き必要です。

ミッションと持続可能性

このプラットフォームは、クレジット販売から手数料を徴収しません。協同組合が承認した管理運営費と財務資金の割り当ては、協同組合の資金として扱われます。任意のホスティング運用／サポートがメンテナンス費用の原資となる場合があります。このリリースは、有料サービスも金銭的な成果も約束しません。

リポジトリには、一般公開用のクリーンなシステムが含まれています。非公開の研究、実証候補、本番記録、非公開パイロットのソースコードは、一括リリースとして公開していません。正式な認証や生態学的認証は主張していません。

Viridis オープンソース・コモンズの一部

道路や川沿いの管理を計画していますか？ DFM は、協同組合が一緒に検討できる保全案を作成し、GSIP は土壌観測データを追加します。現時点では、両者のデータ連携は手作業です。

このプロジェクトは、Viridis の連携するオープンツール群の一つです。それぞれ単独で利用できますが、組み合わせれば、現場の証拠から検証済みの判断までを支援します。

保全コモンズ

• VergeCommon（このリポジトリ）：合意に基づく土地マッピング、現場の証拠、グループでの意思決定を備えた、地域の保全協同組合
• Dendritic Forest Management (DFM)：追跡可能な入力情報と持ち運び可能なレポートを使って、道路や水路周辺の森林保全案を比較します
• Global Soil Intelligence Project (GSIP)：土壌観測データを提供し、不確実性を明示したオープンな土壌マップを確認できます

検証可能な科学

• Viridis Canon：生態系に関する意思決定のための、機械検証済みの Lean 4 数学。各結果に DOI が付与されています
• ViridisOS：DOI に裏付けられた意思決定モジュールと再計算可能な結果のための、オープンなリファレンスランタイム
• Viridis Research：夜間に更新される公開研究記録。各主張には、検証器が実際に確認した内容がラベル付けされています
• ProofLens：証明を読む前に、Lean の命題が意味する内容を確認できます

エージェントツール

• Viridis Agent Fleet：決定論的で監査可能なコアを備えたオープンソースの MCP エージェント
• EnergyAI MCP：AI エージェント向けのエネルギー計画の推定値とインセンティブ情報源

すべてのプロジェクトはViridis プロフィールでご覧いただけます。このプロジェクトがお役に立った場合は、スターを付けていただくと、ほかの人にも見つけてもらいやすくなります。

ライセンス

オリジナルコードおよびオリジナルのワークフローテンプレート：GNU AGPL v3.0 のみ。詳しくは LICENSE、NOTICE、THIRD_PARTY_NOTICES.md をご覧ください。依存関係にあるコードには、それぞれ独自のライセンスが適用されます。フォークは歓迎しますが、Verge Common の名称を使って、推奨を受けているかのように示さないでください。

共有サービスとネイティブアプリ

ウェブサイトとネイティブクライアントは、このリポジトリの協同組合サービスを利用します。アーキテクチャとレガシー機能の調整および iPhone/iPad のビルド状況をご覧ください。ネイティブアプリでの一般向け情報検索、個人デバイス認証、メンバーの投稿、保護された明示的な再試行機能を備えた非公開のディスカッション返信、明示的な現場観測データの送信は、https://vergecommon.com を対象に実装されています。高度なガバナンス、招待、マッピング、財務関連のワークフローにはウェブサイトを使用します。実機での受け入れ確認、署名、TestFlight／App Store での配布は、引き続きリリース要件です。ソースコードに実装されていることは、モバイル版が配布済みであることを意味しません。

v0.9.0 の参加の流れ

ソーシャルプレビューと QR コードを備えた、公開プロジェクト、活動、進捗ページを一つ共有します。受信者はサインイン前に目的を確認し、スチュワードの承認を申請して、同じ活動ページに戻ります。実際の出席と完了した作業を記録し、別のスチュワードに確認してもらってから、公開結果をプレビューして公開するか、取り下げます。詳細な集合場所の案内、境界情報、メンバー名、ファイルは非公開のままです。

協同組合内の Care & participation を開くと、日付指定または定期的な管理作業と、環境変化への対応を割り当て、裏付けとなる証拠を提出し、完了状況を確認し、任意のブラウザー通知を有効にして、スチュワード向けの参加者レポートを表示できます。そのレポートを使う前に、テストアカウントには適切な表示を設定してください。匿名の訪問者や、因果関係のある口コミの広がりは測定されません。サービスの対応状況、プライバシー、運用担当者向け復旧手順をご覧ください。