CodeSampleX

CodeSampleX

テスト済み。推測ではありません。

言語： English · 한국어 · 日本語 · 简体中文 · Español · Français · Deutsch · Português (BR) · Русский

まずはこちら： CLI クイックスタート · インストールせずに公開 REST API を利用する · MCP クライアントを接続する

CLI クイックスタート（Windows PowerShell）

インストールしてバイナリを確認したら、PowerShell で最初の質問をしてみましょう。

irm https://codesamplex.dev/install.ps1 | iex
csx version
csx search "axios multipart upload" --package pkg:npm/axios

インストーラーでは、JOIN COMMUNITY または LOCAL ONLY を選択します。コミュニティモードでは、初回のキャッシュを準備し、バックグラウンド同期を開始します。ローカルのみのモードではネットワークへの自動アクセスが無効になり、キャッシュが空の場合は結果が返らないことがあります。csx init --community または csx init --local-only を実行すれば、後からモードを変更できます。

csx version は csx v<version> を出力します。検索では、検出された環境に応じて評価された回答が返されます。利用する前に、各結果の環境差分を確認してください。NO_SAFE_MATCH は、検証済みの一致が見つからなかったことを意味し、インストールに失敗したという意味ではありません。依存関係とランタイムのコンテキストを含めるには、プロジェクトのディレクトリから検索を実行してください。

PowerShell で csx が見つからない場合は、新しいターミナルを開くか、& "$env:LOCALAPPDATA\csx\csx.exe" version でインストール済みのバイナリを確認してください。macOS / Linux とインストールの詳細または MCP クライアントのセットアップについては、以下をご覧ください。

CodeSampleX が記録する内容

CodeSampleX は、開発者向けライブラリ、ランタイム、ツールチェーンを対象とするオープンな互換性テストネットワークです。ドキュメントを要約したり、逸話を集めたりするものではありません。前提ではなく記録された環境で、実際のビルドが何をしたかを記録し、どこで動作し、どこで失敗し、どの環境で起きたのかを示します。

資産となるのは2つ、そして3つ目はボーナスです。

• エビデンス — 開発者の実機で行われた実際のビルドと、その環境、段階、構造化された終了情報、秘密情報を安全に扱う正規化済みの失敗フィンガープリントです。失敗の詳細が欠落している場合や古い場合は、原因を捏造せず、エビデンスの欠落として示します。csx がインストールされている場所ならどこでも自動的に届くため、コンテナレーンでは到達できないプラットフォームにも届きます。コンテナでは macOS ホストを再現できません。Mac 上の Docker は Linux VM を実行します。同じノート PC を装っていても、別のマシンです。npm は Windows イメージを公開しておらず、musl、ARM、企業向けベースイメージ、実際にインストールされているランタイムバージョンの多様性には限りがありません。マップを埋められるのはこれだけです。
• 調査結果 — エビデンスから検出した矛盾です。有能な開発者やモデルが予想することと、実際に起きたことを照らし合わせて測定します。これらは私たちが責任を持って提示するものであり、モデルが最も頻繁に間違える点でもあります。まさにドキュメントに書かれていないことだからです。
• サンプル — 私たち自身が作成し、検証した実行可能なコードです。あえてボーナスとしています。コンテナファームでは対象範囲をすべて網羅できないため、検証済みサンプルはエビデンスより上位の信頼度を示すものであり、回答を得るための必須条件ではありません。

だからこそ、該当例がなくても空ではありません。ケースについて何も実証されていない場合、評価は NO_SAFE_MATCH のままです。そして記録された観測結果も、そのまま記録どおりに返されます。

• 互換性マップ：https://codesamplex.dev
• 答える質問：そこで実行できますか？ — この API は、このバージョンで、この OS 上、このランタイムのもとで動作しますか？
• 提供する回答：何が起きたか、そしてどこで実行されたかを示します。 レポーターはローテーションするピアバケットを使用します。別途、ファーストパーティのアクティビティ分析では、名前や IP アドレスによる識別は行わず、安定した仮名化クライアント ID を使用します。分析の仕様を参照してください。

現在提供している機能

CodeSampleX は、もはや単なる検索コマンドではありません。現在提供している製品では、同じエビデンスモデルに基づく複数の機能を利用できます。

機能	現在の役割
互換性	パッケージ、バージョン、シンボル、環境ごとに記録された互換性を閲覧します
依存関係	逆依存関係のアトラスです。どの記録済み親リリースが、どの依存関係リリースを取り込んだかを示します。依存関係のエッジは、互換性の判定ではありません
ギャップ	Sample / Evidence / Dependency 全体の網羅状況を調査します。以前のウェブサイトの Wanted ランキングに代わるものです
調査結果	再現可能なサンプルに裏付けられた、測定済みの矛盾とバージョン／環境の境界を示します
機能	インストール不要の REST クイックスタート、REST / MCP / CLI の機能マトリックス、MCP ツールの仕様、および skill.md を提供します
サンプル · アダプター · 統計	検証済みの成果物、エコシステムの機能マトリックス、公開ネットワークの集計情報を提供します

CLI はローカルで利用する正式なインターフェースです。csx help はバイナリ内のコマンドから生成されます。この表はテストによって照合されるため、新しいコマンドが README に記載されないまま増えることはありません。

コマンド	機能
config	ローカル設定を読み取るか、変更します
daemon	バックグラウンド同期デーモンを実行、起動、停止、または調査します
doctor	ローカルのインストールを診断します。--fix は CSX が所有する安全な状態を修復し、再度検証します
hook	対応するコーディングエージェントにインストールされた、ビルド失敗時の自動検索機能を有効化、無効化、調査、またはセルフテストします
init	コミュニティモードまたはローカル限定モードを選択し、エージェントを設定し、初回キャッシュを準備して、バックグラウンド同期を開始します
login	サンプルの投稿者情報を明示した公開を行う場合に、GitHub にサインインします
mcp	エージェントクライアントが使用する stdio MCP サーバーを実行します
mcp-config	MCP クライアント向けの JSON/TOML/パス設定を出力します
run	コマンドを実行し、公開依存関係のサニタイズ済みエビデンスを記録します
sample	クリーンルームサンプルを提案、作成、プレビュー、検証、公開、削除、一覧表示するか、保留中のサンプルをレビューします
sample-worker	非公開の作成作業／セッション引き継ぎレーンを操作します
scan	ビルドを実行せずに、公開依存関係を検出します
search	対象環境に対する評価済みの検証済みサンプルを検索します
stats	ローカルキャッシュ、キュー、ヒット数、採用数のカウンターを表示します
sync	互換性シャードを準備し、キューに登録されたコミュニティアップロードを送信します（必要に応じて --uploads-only を指定します）
ui	ローカルダッシュボードとプライバシープレビューを開きます
update	署名済みアップデートを安全に確認、インストール、調査、またはロールバックします
version	インストールされている csx のバージョンを出力します
worker	Docker で隔離された cross/matrix 検証作業に参加します

このネットワークでは、対応するコーディングエージェントにオプションのビルド失敗フックもインストールします。エージェントのシェルでビルドに失敗すると、このフックは失敗したビルドステップを分類し、エラーをローカルでサニタイズして CodeSampleX を検索します。検索結果がない場合や無関係なコマンドの場合は、何も表示しません。csx hook status でインストール状況を確認できます。csx hook check では、使い捨てのビルド失敗を発生させ、登録されたフックのパスを検証できます。

ネットワークを読むだけならインストール不要です

CodeSampleX は、エージェント、ブラウザー、スクリプト向けに公開 REST インターフェースを提供します。サイトに表示されるすべての回答は、HTTPS リクエストを送るだけで取得できます。キーもアカウントもクライアントライブラリも不要で、どのオリジンからでも読み取れます。CLI をインストールするのは、ローカルでの実行記録、自動失敗ビルドフック、公開、またはワーカー機能が必要な場合だけです。

1 回のリクエストで、本番環境の実際の JSON を取得できます。そのままコピーしてください。

curl 'https://codesamplex.dev/v2/search?package=pkg:npm/axios&symbol=axios.post&os=linux&runtime=node&runtimeVersion=22'

回答には grade が含まれ、各結果には一致した環境の項目（exact[]）と、一致しなかった項目（different[]）が示されます。一致するものがない場合は grade: "NO_SAFE_MATCH" と明示されます。これは回答の失敗ではなく、実際の回答です。汎用のウェブ対応エージェントは https://codesamplex.dev/skill.md から契約全体を読み取れます。docs/rest.md には、人向けの同じクイックスタートが記載されています。

3 つの利用方法を比較します。各項目は、ルーターとコマンド一覧との照合をテストで確認しており、Features ページにも同じ表が掲載されています。

機能	Web REST（インストール不要）	MCP	CLI をインストール
検証済みサンプルを検索し、環境との適合度を評価	✅	✅	✅
パッケージ、バージョン、シンボル、環境による互換性の照会	✅	✅	⚠️ csx search は同期済みシャードに対して評価します。説明用コマンドはありません
1 つのサンプルのマニフェスト、レシート、ファイルを読む	✅	✅	⚠️ csx search --json 経由です。専用のサンプル読み取りコマンドはありません
Findings コレクションを読む	✅	❌ Web と REST のみ	❌ Web と REST のみ
gaps、wanted、公開統計を読む	✅	❌	⚠️ csx stats はローカルのカウンターのみを表示します
ブラウザー、クラウドエージェント、スクリプトから利用	✅	⚠️ エージェントの MCP ホスト上で csx をローカル実行する必要があります	❌ ローカルバイナリが必要です
インストール不要での利用	✅	⚠️ MCP サーバーは csx バイナリです。クライアントホストに csx がインストールされている必要があります	❌
ローカルプロジェクトと環境を自動検出	❌	⚠️ MCP ホストの背後で動作するローカルの csx から確認できる情報に限られます	✅
実際のローカルビルドまたはテストを実行	❌	⚠️ run_observed_command はローカルの csx 経由で実行します	✅
サニタイズ済みの構造化された実行証跡を取得	❌	⚠️ MCP ホストが実行するローカルの csx 経由に限られます	✅
署名なしの実行状況を送信	✅	❌ 代わりに、相関付けされた利用証拠をファイルに記録します	❌ 代わりに、相関付けされた利用証拠をファイルに記録します
失敗ビルド時の自動検索フック	❌	❌	✅
バックグラウンド同期とオフラインキャッシュ	❌	❌	✅
アップロード前にプライバシーをプレビュー	❌	❌	✅
検証済みサンプルを公開	❌	❌ 意図的に公開ツールはありません	✅ CLI で利用者が確認します
ワーカーとマトリックスによる検証	❌	❌	✅
署名付き検証レシート（ed25519、ワーカーから発行）	❌	❌	✅

REST はネットワークを読み取ります。CLI を使うと、ネットワークから現実を観測できます。 MCP は CLI のアダプターです。csx mcp は csx バイナリそのものなので、csx がインストールされていないホスト上の MCP クライアントには、通信先となるサーバーがありません。

そこで動作しますか？

すべての結果は、それを生成した環境に結び付いているため、同じデータをバージョン × シンボル、OS × ランタイム、バージョン × アーキテクチャ、ブラウザー／ランタイム、libc、その他の記録された軸で切り替えて表示できます。現在の件数は、ライブ互換性エクスプローラーまたはpgx/v5などのパッケージページをご覧ください。この README では、日付入りのスクリーンショットにライブネットワークの数値を固定することは意図的に避けています。以下の例は説明用です。

                                         v5.10.0     v5.9.2
github.com/jackc/pgx/v5                  ▤ —         —
Batch                                    ▤ —         —

マトリックスの各セルには観測結果があり、利用可能な場合はサンプルドキュメントも表示されます。観測件数が示すのは、記録されたビルドが到達した段階（コンパイル、型チェック、テスト）であり、ユーザー数でもマシン数でもありません。サンプルドキュメントは、その座標に再現可能なコントラクトが存在することを示し、その状態はサンプルの検証実行を反映します。この2種類のエビデンスは、意図的に決して合算しません。

したがって、プロジェクトのコンパイル成功を、個々のシンボルが動作する証拠として提示することはありません。—は引き続き不明を表し、サンプルがない場合はサンプルなしとして扱います。このマップは、その座標で実際に起きたことを記録するものであり、少数の実行結果を普遍的なPASS判定に格上げするものではありません。

テストが重要な理由

Documentation   → what should work
Code search     → how somebody used it
Community       → what somebody says worked
CodeSampleX     → what was actually tested

マップの信頼性を保つルールは次のとおりです。

• プロジェクトのコンパイル成功を、シンボルの動作として提示することは決してありません。観測結果と検証結果は別々に集計し、決して合算しません。
• 原因が不明な場合はUNKNOWNのままにします。誤ったHITはMISSよりも悪いため、NO_SAFE_MATCHも正当な回答です。
• エビデンスは劣化せず、古いとマークされるセルもありません。観測結果とは、特定のステージにおける、固定された1つのリリースと固定された1つの環境バケットの組み合わせであり、これらは変わりません。あるビルドがそこで失敗したという事実は、1年後も同じように真実です。変わり得るのは環境であり、異なる環境は別のセルです。
• 失敗原因は確率分布として報告し、確実性を捏造することはありません。

CLI をインストールする

CLI はローカルテスターです。実際のビルドをラップし、その結果を匿名のエビデンスに変換して、ネットワークから回答を取得します。

Windows（PowerShell）：インストール、バージョン確認、最初の検索については、上記のCLI クイックスタートに従ってください。

macOS / Linux：

curl -fsSL https://codesamplex.dev/install.sh | sh

このコマンドにはcurlとCA証明書が必要です。最小構成のイメージ（debian-slim、alpine、ほとんどのエージェントコンテナー）には含まれていません。また、パイプラインは最後のコマンドの終了ステータスを報告するため、curl … | shはcurlがない場合でも終了コード0で終了します。先に前提条件をインストールするか、wgetを使用してください。

apt-get install -y curl ca-certificates            # debian / ubuntu slim
apk add --no-cache curl ca-certificates            # alpine
wget -qO- https://codesamplex.dev/install.sh | sh  # needs neither

Windowsでは、インストーラーは安定版ランチャーを%LOCALAPPDATA%\csx\csx.exeに配置し、%LOCALAPPDATA%\csxをユーザーのPATHに追加します。macOS/Linuxでの既定の配置先は${CSX_INSTALL_DIR:-$HOME/.local/bin}/csxです。このディレクトリがすでにPATHに含まれていない場合は、追加してください。

export PATH="$HOME/.local/bin:$PATH"
csx version    # install check — the supported spelling is `csx version`

バイナリは1つ、質問も1つです。csx initは以下のコントラクトを表示し、JOIN COMMUNITYまたはLOCAL ONLYのどちらかを選ぶよう尋ねます。shにパイプすると、標準入力はダウンロード用のパイプによって消費されるため、initは提示された既定値であるJOIN COMMUNITYを選びます。csx init --local-onlyでいつでもオプトアウトできます。どちらのモードフラグも再実行可能で、非対話型です。スクリプトまたはCIの設定では、csx init --community --yes --no-agentsを使用してください。

PurplePulse v2の有効化で送信されるのは、project_id、保存されたランダムなinstall_id、バージョン、OS、platform（cliまたはmcp）、schema_version: 2、および任意の環境情報のみで、送信はUTC日付ごとに最大1回です。DO_NOT_TRACK=1またはCSX_TELEMETRY=0を設定すると無効になり、CI／コンテナー／サーバーレスの実行では本番テレメトリは送信されません。

テストと確認

csx run -- pnpm build                 # wrap a build/test; its result becomes sanitized evidence
csx search "axios multipart upload"   # verified answers graded for YOUR environment
csx --debug search "axios multipart upload" # same answer plus local decision trace
csx hook status                       # see which supported coding-agent hooks are installed
csx hook check                        # prove the failure-hook path with a throwaway failing build
csx scan                              # record public dependency usage without running a build
csx stats                             # local dashboard: cache, hits, adoption, queues
csx ui                                # browser dashboard + privacy preview
csx sync                              # manually refresh shards / flush queues when needed
csx mcp-config                        # print MCP client configuration
csx update check                      # verify whether a signed update is available

コミュニティモードでは、csx init がすでに範囲を限定した初回キャッシュウォームアップを実行し、バックグラウンド同期デーモンを起動します。新規インストールが正常なら、最初の質問の前に決まりごとのように csx sync を実行する必要はありません。インストーラーがウォームアップは一部のみ、または利用できなかったと伝えた場合は、明示的な復旧手段として csx sync を実行できます。csx sync --uploads-only は、シャードの再スキャンを行わずに、キューに入ったアップロードを送信します。サンプル作成者セッション内（CSX_SESSION_TOKEN が設定されている場合）では、直接バイナリを実行した場合も含め、同期は常にアップロードのみの経路を5分の期限付きで使用します。キャンセルするとゼロ以外のステータスが返され、保留データは保持されます。

local-only は意図的に動作が異なります。ネットワークへの自動アクセスが無効になっているため、設計上、互換性キャッシュが空の状態になる場合があります。後からネットワークに参加するには、明示的に csx init --community を再実行します。

csx search は、記録されたターゲット環境に照らして各結果を評価し、EXACT、COMPATIBLE、ADAPTATION_REQUIRED、REFERENCE_ONLY、NO_SAFE_MATCH のいずれかに分類します。また、近い環境での実行を同一のものと見せかけず、環境の具体的な差分を一覧表示します。

失敗の自動検索

エージェントが覚えておく必要のない部分が hook の経路です。対応するコーディングエージェントでは、失敗したシェルビルドを CodeSampleX に自動的に渡すことができます。フックは認識済みのビルド／テストコマンドに対してのみ介入し、生のログは送信せず、安全な一致がない場合は何も通知しません。無効にするには csx hook off を実行し、登録済みフックが引き続き動作することを実測して確認したい場合は、いつでも csx hook check を実行してください。

検証済みサンプル

サンプルは単なるスニペットではありません。これは、最小限のコンテンツアドレス指定プロジェクト（正規化されたアーティファクトの sha256:<hex>）であり、コントラクト（ピン留めされたコンテナー内でオフライン実行され、合格したアサーション）を備えています。タグではなくイメージダイジェストでピン留めされています。タグは読者向けの別名であり、実行に使われるのはダイジェストです。また、署名済みレシートには正確なイメージ参照が記載されるため、言葉を信じるのではなく、誰でも同じバイト列を再実行できます（docs/adapters.md）。クリーンルームでの作成手順は CLI のみです。

csx sample propose --goal "upload a file with axios"   # sanitized brief + scaffolded workspace
csx sample create <dir>      # ingest the clean-room project
csx sample preview <id>      # show EVERYTHING that would be published
csx sample verify <id>       # resolve → compile → contract, sandboxed
csx sample publish <id>      # requires typing exactly "yes"; leakage findings hard-refuse
csx sample pending           # list agent-prepared drafts waiting for human review

サンプルの公開に GitHub の本人情報を紐付ける場合は、csx login github を使用してください。匿名での公開も、明示的に CLI から選択できます。公開時にはシークレット、パス、プロジェクト名、プライベート URL をスキャンします。検出された場合は、上書きフラグなしで公開がブロックされます。サンプルソースのアップロードは、意図的に MCP の機能として提供していません。公開できるのは CLI を使う人間だけです。

指摘事項

どこで問題が起きるのでしょうか？指摘事項 は、測定によって得られた矛盾の一覧です。ドキュメント（または一般的な認識）の記述と、コントラクトで測定された結果を並べて表示し、ドキュメントとの不一致、環境固有の失敗、バージョンの境界を示します。各項目は、それを証明するコントラクトを持つ公開済みサンプルにリンクしているため、測定を再実行し、異議を唱えることができます。

機械的に導出される指摘事項は、修正対象となる認識を作成者が記録した公開済みサンプルから増えていきます。ページを編集して追加する人はいません。

依存関係アトラス

依存関係 は、子側から記録済みの依存関係グラフを読み取ります。この正確な依存関係リリースを取り込んだ親リリースはどれでしょうか？ これは、パッケージページだけでは答えられない影響範囲やアップグレードに関する質問に役立ちます。エッジは、観測されたプロジェクトでリゾルバーがそれらのリリースを組み合わせたことを意味します。2つのリリースに互換性がある証明としては、意図的に提示していません。

カバレッジの不足

不足状況 は、コーパスの網羅性を確認する画面です。誰かがたまたま検索した対象だけを順位付けするのではなく、各座標で独立した3つのアセット（サンプル、エビデンス、依存関係）のうち何が不足しているかを一覧表示します。需要キューは自動化とスケジューリング向けの GET /v1/wanted として引き続き存在しますが、需要と網羅性は異なる問いであるため、公開ウェブサイトでは /gaps を使用しています。

エビデンスと評価

各セルを信頼できる理由は何でしょうか。すべての結果には、弱いものから強いものへと並ぶエビデンスクラスが付与されます。

評価	実際に行われたこと
USAGE_OBSERVATION	実際のプロジェクトでパッケージを使ってビルド／型チェック／テストを実施しました。観測結果であり、信頼性は低めです
ADOPTION_EVIDENCE	サンプルを適用した人が、その後ビルドに成功したかどうかを報告しました
SAMPLE_VERIFICATION	サンプルのコントラクトを固定されたコンテナ内で実行し、成功しました
CROSS_PASS	公開元とは別のピアキーが再実行し、再度成功しました
MATRIX_PASS	成功したレシートが、2つ以上のOS／ランタイムのメジャーバージョン／ブラウザファミリーの境界にまたがっています
STABLE	3つ以上の異なるピアキーで成功し、30日間失敗が記録されていません

ピアとはキーであり、人やマシンではありません。ピアIDは、登録を伴わずに自己生成されたed25519キーのハッシュです。そのため、1人の運用者がワーカーの実行数だけキーを保有できます。「異なるピアキー」とは、同じ座標が複数の場所から報告されたことを意味します。人数を表すことは決してなく、ここに記録された情報から実行者を特定することもできません。

サンプルページには検証段階を示すバッジ L0_SOURCE_ONLY → L5_MATRIX_PASS も表示され、マトリックスの各セルには信頼度（HIGH／MEDIUM／LOW）、失敗率上昇フラグ、最終確認日が付与されます。resolvedPackages を申告できるのは署名済みの v2 レシートのみです。これは作成者が入力したバージョンではなく、検証者が実際にインストールしたバージョンを示します。スナップショットでは、各レシートが実際に実行されたバージョンの下に保存されます。

公開カウンターはロールアップであり、アカウントなしでJSONとして取得できます。

curl -fsSL https://codesamplex.dev/v1/stats

フィールド	集計内容
packages / symbols	カバレッジ：互換性データに含まれる公開パッケージ名と観測済みシンボル
evidence	受理された観測記録。ユーザー数、プロジェクト数、検証済みサンプル数ではありません
verifiedSamples	サンドボックスのコントラクトが成功したレシートを持つ、重複のないサンプル数
peers / projectsMonth	匿名の、重複のない日次／月次コントリビューターバケット数
activeInstallations1d / activeInstallations7d / activeInstallations30d	現在のUTC基準の1／7／30日間の各エポックにおける、通常クライアントまたは外部クライアントからの匿名プレゼンストークンの重複なし数。スライディングウィンドウでも人数でもありません
postHitBuildsReported	計測済みのPASSまたはFAILを含む導入レポート数

CodeSampleX は、信頼できる一意のユーザー数／アクティブユーザー数、稼働中のMCPプロセス数、インストール成功数をまだ計測していません。統計レスポンス内の estimated* フィールドはすべて、明示的に計算式に基づく推定値であり、計測値として解釈しないでください。計測は、フィールド優先のガードレールのもと、内部の検索品質とユーザー成果の価値という2つの異なるレイヤーに明確に分けられており、改善効果を捏造することはありません（docs/measurement-layers.md）。

コントリビューターワーカー

このネットワークの環境は、他の人が所有するマシンです。予備のマシンを使えば、MCPやエージェントの設定に触れずに、Dockerで隔離された検証に貢献できます。

csx init --community --yes --no-agents --no-daemon
csx worker start                         # idle-aware, 2 Docker lanes
csx worker start --parallel 4 --budget 15m

ワーカーが受け付けるのは、サーバーが割り当てたVERIFYジョブ（cross／matrix）のみです。キューから任意のシェルコマンドが送られることはありません。アーティファクトはコンテンツアドレス方式で管理され、ハッシュが検証されます。依存関係の解決はコンテナ内で行われ、コンパイルとコントラクトの各段階は、メモリ 512m／PID 256 の上限が固定された使い捨てのDockerワークスペースで、ネットワークを無効にして実行されます。Dockerデーモンがない場合は必ず拒否され、ホスト上での代替実行は行われません。結果はed25519署名付きのv2レシートです。各段階の生ログはローカルに保存されます。

API

アカウントなしで、ウェブサイトに表示されるのと同じデータを JSON で取得できます。読み取りルートはどのオリジンからでも利用できます（CORS *）。ゼロインストールの呼び出し元が書き込めるのは実行フットプリントのみで、署名のない自己申告として記録され、評価には一切影響しません。

エンドポイント	提供内容
GET /v2/search?q=&package=&symbol=&os=&runtime=&runtimeVersion=	URL から取得する評価済みの回答です。MCP ツールおよび CLI と同じパイプラインを使用します。一致しない場合は grade: NO_SAFE_MATCH になります
POST /v2/search	JSON 本文（{schemaVersion:2, query, packages[], symbols[], environment{}}）から取得する同じ回答です
POST /v1/search	v1 のレスポンス形式を固定して利用しているクライアント向けの、変更されない v1 レスポンス形式です
GET /v1/registry/packages/{purl}	パッケージの詳細とパッケージ単位のスナップショット
GET /v1/registry/symbols/{eco}/{package}/{family}	1 つのシンボルのバージョンごとのスナップショット
GET /v1/samples/{id}, …/artifact	サンプルのメタデータ、レシート、tar.gz ソース
GET /findings.json	Findings ページに表示される、測定済みのすべての矛盾と、それぞれを証明するサンプル
GET /v1/wanted	需要キュー API：リクエストされたものの回答されていない項目（ウェブサイトの網羅状況ビューは /gaps）
GET /v1/adapters	エコシステムごとの機能マトリックス
GET /v1/stats	日次のネットワーク集計
GET /v1/shards/{eco}/{package}/{major}	事前に生成された互換性シャード（ETag キャッシュ対応）
GET /v1/peers/for-sample/{sampleId}	このサーバーを使わずにサンプルを取得するための、そのサンプルを保持しているピア
POST /v1/footprints/execution	任意のゼロインストール実行フットプリント：{sampleId, outcome: pass|fail|could_not_run, stage, environment{os,arch,runtime,runtimeVersion}}。署名はなく、サンプルの昇格には使用されません
GET /skill.md	URL の取得以外の機能を持たないエージェント向けの、この API サーフェスの機械可読ガイド
GET /version	応答したサーバーのビルドと、その環境

実際のリクエストを使ったクイックスタート：docs/rest.md。

エージェントアダプター（MCP）

コーディングエージェントはアダプターを介して同じネットワークを利用します。MCP は CLI の上にあるコネクターであり、製品そのものではありません。REST API が本体で、CLI、MCP、そして今後登場するエージェントプロトコルは、すべて同じデータを利用するアダプターです：

CodeSampleX
├─ REST      ← zero-install read surface: agents, browsers, scripts, CI
├─ Web       ← compatibility map / reports, drawn from the same routes
├─ CLI       ← local execution, evidence capture, hooks, privacy preview, publishing, worker
├─ MCP       ← adapter on the CLI for MCP-capable agent clients (csx mcp IS the csx binary)
└─ skill.md  ← usage guide for generic web-capable agents, no adapter needed

csx init は Claude Code、Codex、Gemini CLI、Antigravity（agy）、OpenCode を自動的に設定します。その他の stdio MCP クライアント（Cursor、Windsurf、Cline、Zed、VS Code）は、csx mcp-config の出力を使って動作します（Codex の場合は --toml）。出力には絶対バイナリパスが含まれており、エディターから起動されたクライアントに必要です。実際の仕様は 機能 にも掲載されています。サーバー自体は csx mcp です。ツールは 10 個です：search_known_solution、get_sample、explain_compatibility、run_observed_command、report_sample_adoption、report_anomaly、report_csx_issue、propose_public_sample、list_local_hits、get_local_stats。公開ツールは意図的に用意していません。

ホスト IDE、コーディングエージェント、開発者プラットフォームは、コネクターの詳細を公開せずに、CodeSampleX を組み込みまたは推奨オプションとして提示できます。パートナー統合仕様 とその機械可読プロファイルでは、この方法におけるマネージドパッケージのライフサイクル、同意の境界、機能ポリシー、証拠の取り扱いを定義しています。

report_anomaly は、反対方向を向いた唯一のツールです。CSX の回答とエージェント自身のマシンの結果が具体的に食い違う場合（ネットワークでは通ると判定された依存関係がこちらでは失敗した、返されたシンボルのシグネチャがパッケージのエクスポート内容と異なるなど）、エージェントは検証を依頼できます。これはバグ報告ではありません。報告が行われると、ほかのすべての検証結果を生成するものと同じフリートで独立した再実行がキューに登録され、それを確認できるのはその検証結果だけです。測定結果を伴わない送信は拒否され、同じ不一致が 2 回報告されても報告と再実行は 1 件だけです。また、検証担当者が同意するまでは、報告内容が公開ページに掲載されることはありません。原因に関する報告者の推測は専用フィールドに記録され、判定には影響しません。

report_csx_issue は同じ考え方をパッケージではなく私たちに向けたものです。実際に確認していた失敗を別の回答が覆い隠した、質問に含まれていないエコシステムから推奨事項が返された、ツールの仕様によってモデルが誤った動作をした、といったケースが対象です。これは任意の機能で、意図的に目立たないようにしています。失敗後にエージェントへ報告を促す仕組みはなく、チケットも作成されません。報告がない週があっても通常どおりです。100 個のエージェントが遭遇した不具合も、発生回数が増える 1 行にまとめられ、その行がバグに紐付けられると、それ以降の報告にはそのリンクが返されます。2 つの報告経路は、取り込み、秘匿化、重複排除までは共有しますが、その後は何も共有しません。この製品の不具合が互換性の証拠になることはありません。

エージェント向けのインストール手順（MCPB バンドルおよび SHA256SUMS.txt を含む直接バイナリダウンロード）：llms-install.md。スタンドアロンのコミュニティ向けインストールは、Ed25519 署名付きマニフェストを使って自動更新します。バックグラウンド同期デーモン、csx mcp、csx worker start のうち実行中のものが更新を確認するため、MCP もワーカーも起動していない CLI とデーモンのみのインストールでも自動更新されます。csx update rollback でロールバックできます。local-only インストールでは更新リクエストを行いません。

契約

You get                              You contribute
✓ Public compatibility knowledge     ✓ Public package/version usage
✓ Verified code answers              ✓ Public API/symbol usage when detectable
✓ Local agent integration            ✓ Build/typecheck/test result
✓ Public sample cache                ✓ Sanitized failure fingerprints

Never shared automatically
✕ Source code        ✕ Repository/project name   ✕ File names or paths
✕ Source snippets    ✕ Secrets or env variables  ✕ Private packages
✕ Raw compiler/runtime logs

これは隠れたテレメトリではなく、プロトコルです。コミュニティのピアは、利用者であると同時に提供者でもあります。ローカルのみのモードでは、何も送信されません。エラーは使用される前に、ローカルでサニタイズされてフィンガープリントに変換されます。非公開のパッケージや不明なパッケージがマシンの外に送信されることはありません。csx ui のプライバシープレビューでは、送信前に正確なペイロードを確認できます。NO_SAFE_MATCH は、プライバシーに配慮した Wanted タプルに反映されます。そこに含まれるのは、公開パッケージ、その正確なバージョン、そしてリクエストで曖昧さなく特定できるパッケージが指定されている場合は、要求された公開シンボルです。ユーザーのプロンプトは含まれません。公開環境のデプロイでは、サンプルソースはシード済みのものに限定されます。検索、エビデンス、レシート、Wanted ボードは、アカウントなしで利用できます。

プライバシーポリシー

上記の契約は、コードの動作そのものです。PRIVACY.md では、同じ内容をポリシーとして項目ごとに示し、各境界を適用するファイルを明記しています。コミュニティモードでアップロードされる正確なドキュメント、アップロードではなくダウンロードにあたるリクエスト、サーバーが保存するデータとその保存期間、そして local-only が「何も送信しない」とする意味を説明しています。このポリシーは、痕跡を残さず編集できるページから配信されるのではなく、このリポジトリでバージョン管理されています。また、MCPB バンドルの privacy_policies 配列が参照する URL です。

エコシステム（Public v1）

スキャン・検証済み — プロジェクトが検出され、パッケージがロックファイルから解決され、サンプルがエンドツーエンドで検証されています。Node/TypeScript（npm、pnpm、yarn — リファレンス）、Python（pip、uv）、Go、Rust/Cargo が対象です。Node のサンプルは宣言されたランタイムで実行されるため、Bun と Deno の結果は推測ではなく実際のものです。

検証のみ — プロジェクトスキャナーはまだありませんが、公開されたサンプルは固定されたコンテナ内でビルドされ、コントラクトテストが行われます。PHP/Composer、Ruby/Bundler、Dart/pub、Elixir/Hex が対象です。Java（Maven/Gradle）のコントラクト検証では、JDK 8/11/17/21/25 の各レーンを固定します。

観測されたエビデンスのみ — コンテナ検証ツールを使わずに、プロジェクトの検出とビルドの観測を行います。Unreal Engine（adapters/unreal 経由の .uproject — 開発者のワークステーションで対象のエンジンバージョンを観測されたエビデンスとして報告します。コンテナ検証レーンはありません）。

誠実な機能マトリックスは docs/adapters.md を参照してください。シンボル解決の信頼度は、常に（EXACT／PROBABLE／UNKNOWN）として明示されます。

アーキテクチャ

単一の Go バイナリ（csx：デーモン＋CLI＋MCP＋ピアノード＋検証ツール）と、小規模なサーバー（csx-server：PostgreSQL＋Caddy の背後で動作するサーバーサイドレンダリングの互換性エクスプローラー）で構成されています。サンプルはコンテンツアドレス方式で管理され、ローカルキャッシュ → ピア → メインシーダーの順に配布されます。ダウンロードしたサンプルがホスト上で直接実行されることはありません。resolve は、エコシステムが対応している場合はインストールスクリプトを無効にした固定サンドボックス内で実行され、resolve 後にアーティファクトのハッシュが再計算され、コンパイルとコントラクトの各段階はネットワークを無効にして実行されます。現在の正規リファレンスは docs/architecture.md、docs/schema.md、docs/execution-context.md、docs/diagnostics.md、docs/operations.md、docs/activation-funnel.md です。最後のドキュメントでは、インストールから最初の有用な回答までの間に何を測定できるか、何を測定できないか、またユニークユーザー数やアクティブユーザー数がそのリストに含まれない理由を説明しています。goal.md は初期のプロダクト計画です。

運用モデル、原則、Public v1 の範囲

これらは初期計画から引き継がれた継続的な製品上の決定事項です（goal.md — 現在は非推奨のスタブです。計画の全文は git の履歴にあります）。実装が計画を超えて進化している箇所では、コードと上記のドキュメントが優先されます。

運用モデル。 パブリックネットワークには誰でも無料で参加できます。運営資金はスポンサーシップで賄います（初期計画の GitHub Sponsors モデルです。サイトのフッターに Sponsor リンクがあります）。計画では、証拠、ストレージ、検証のいずれにも貢献しない API 専用の利用者向けに、将来的な有料の Hosted API を設ける可能性を残しています。このプランは意図的に Public v1 の対象外としています。

譲れない原則。 以下のいずれかを変更するには、プロジェクトオーナーの明示的な承認が必要です。

• 実際のプロジェクトソースが自動的に送信されることはありません。また、自動証拠収集の対象はパブリックレジストリ上のパッケージに限られます。
• コミュニティのピアは、利用者であると同時に提供者でもあります。これがプロトコルであり、隠れたテレメトリーではありません。
• Evidence ネットワークと Sample プールは独立したシステムとして維持し、プロジェクトがコンパイルできたことを、個々の API が成功したかのように示すことは決してありません。
• 原因が不明な場合は UNKNOWN のままとし、無理に HIT とするより NO_SAFE_MATCH を優先します。
• 製品のデフォルト動作は、サーバー側の LLM 推論や一元的なビルドファームに依存しません。また、中央サーバーが停止している間も、ローカル機能は可能な限り動作し続けます。
• サンプルソースの公開と、アイドル状態の CPU による検証への貢献には、それぞれ個別の明示的な同意が必要です。
• コントラクトのないサンプルは、検証の段階で L2（コンパイル済み）を超えることはありません。
• ブロックチェーン、トークンエコノミー、グローバル台帳は、今後も一切採用しません。
• コアクライアントとパブリックプロトコルは、オープンソースのまま維持します。

Public v1 の対象外（初期計画での範囲に関する決定事項です。その後、提供済みの製品がさらに対応している場合（上記の検証済みエコシステムなど）は、提供済みの製品が優先されます）：エンタープライズ／プライベートパッケージネットワーク、SSO／SLA／オンプレミス、API 専用の課金、すべてのエディター向けの専用 IDE 拡張機能、すべてのエージェント向けの完全なシェルインターセプト、すべての言語向けのランタイムシンボル計測、Android／iOS／Unreal／Unity／C++ の検証（注：Unreal Engine プロジェクトの検出とエンジンバージョンの観測は adapters/unreal でサポートされています）、一元的な大規模ビルドファーム、汎用的なプロジェクトメモリやアーキテクチャ／ビジネスロジックの共有、ソースの自動公開、失敗原因の確定的な判定、DHT のみのネットワーク。

成功指標。 成功は、サンプル数やサインアップ数では判断しません。初期計画で掲げている指標は、エージェント検索の呼び出し率、Precision@1、HIT 受け入れ率、HIT 後のビルド成功率、適応距離、証拠のカバレッジ、相互検証率、失敗原因の特定に対する信頼度、推論の削減量の推定値です。最後の指標は明示的に推定値であり、実測値ではありません（上記の統計表を参照）。

ソースからのビルド

go build ./cmd/csx && go build ./cmd/csx-server
go test ./...

データベースは不要です。CSX_TEST_DSN が設定されていない場合、internal/serverstore の PostgreSQL テストは自動的にスキップされます。ただし、CI ではこれらのテストを省略できません。.github/workflows/ci.yml はすべてのプルリクエストに対して、一時的な postgres:17-alpine を使ってテストを実行し、いずれかがスキップされると実行を失敗させます。この実行は main の必須チェックであるため、失敗するとマージが停止します。その背後にあるルールセットと、ジョブ名が変更された場合の対応については、docs/operations.md を参照してください。ローカルで同じ方法で実行するには、次のようにします。

docker run -d --rm --name csx-pg -e POSTGRES_USER=csx -e POSTGRES_PASSWORD=csx \
  -e POSTGRES_DB=csx -p 5432:5432 postgres:17-alpine
CSX_TEST_DSN="postgres://csx:csx@localhost:5432/csx?sslmode=disable" \
  CSX_REQUIRE_TEST_DSN=1 go test ./...

各テストは使い捨てのスキーマを個別にマイグレーションし、その後削除するため、テストスイートは繰り返し実行でき、2 回の実行で 1 つのデータベースを共有できます。CSX_REQUIRE_TEST_DSN を設定すると、DSN がない場合にスキップではなく失敗になります。CI ではこの設定を使用しています。

ライセンス

コード：Apache-2.0。公開されているサンプルのデフォルトライセンスは MIT-0 です。エビデンスと集計された互換性データ：CDLA-Permissive-2.0（DATA_TERMS.md を参照）。

作成者のスーパーバイザーは、CSX_SAMPLE_WORKER_RESERVATION=SAMPLE を設定するか、csx sample-worker next --reservation SAMPLE を渡すことで、新しいクレームをサンプル用に予約できます。既存のクレームは通常どおり照合されます。対象となるサンプルキューが空の場合は NO_WORK が返されます。未対応のサーバーは、混合ワークにフォールバックせず、予約を拒否します。