Linewatch

時間経過に伴うインターネット品質 — エージェントネイティブ。 1つの数値で止まらない、シンプルなspeedtest.net。測定し続け、傾向をグラフ化し、切断を記録し、その証拠をクリーンなJSONとしてあなた（またはAIエージェント）に渡します。

2026年8月19日作成。仮のラベル — 名前は後で通常のプロセスで決めます。

存在理由

ある時点のスピードテストでは、回線が実際には毎晩フラッピング（不安定）したり低下していたりしても、問題ないように見えることがあります。3つの障害モードには、3種類の測定が必要です：

設計原則：重いテストはまばらに、軽いテストは高密度に。

自前のサーバーは不要：測定はCloudflareの公開・CORSオープンなスピードエンドポイント（speed.cloudflare.com）に対して実行されるため、エンジンはどのブラウザやNode.jsプロセスからでも無料で動作します。

Related MCP server: connectivity-diagnostics

レイアウト

packages/core   isomorphic measurement engine + stats + types (browser & Node)
packages/cli    `linewatch` CLI — every command speaks --json; JSONL store in ~/.linewatch/
packages/mcp    MCP server (stdio) — agents run tests & read history, zero login
apps/web        PWA — GO button + live gauge, Monitor mode, history charts, CSV export

クイックスタート

npm install
npm run build

# human: web app
npm run dev                      # → http://localhost:5173  (installable as a PWA)

# human or agent: CLI
node packages/cli/dist/index.js test            # one speed test
node packages/cli/dist/index.js monitor         # test every 15m + probe every 45s
node packages/cli/dist/index.js summary --since 7d --json

# agent: MCP (Claude Code)
claude mcp add -s user linewatch -- node $(pwd)/packages/mcp/dist/index.js

MCPツール： run_speed_test、run_latency_probe、get_history、get_summary、get_store_info。

エージェントネイティブの原則

1. マシン向けの対話型認証は不要。 CLIとMCPは同じローカルJSONLストア（~/.linewatch/results.jsonl）にアクセスします — 追記のみ、grep可能、解析可能。

2. JSONが第一級の出力です。 人間向けUIは同じ行のレンダリングにすぎません。

3. 自律利用のための低コストなプリミティブ： ネットワーク障害を疑うエージェントはrun_latency_probe（2秒未満、データほぼゼロ）を呼び出し、必要な場合にのみrun_speed_test（約20秒、約100〜500MB）にエスカレーションします — ツールの説明にこれらのコストが記載されているため、エージェントが判断できます。

データに関する注意

• スピードテストは、フルレートで約18秒間データを転送します：テストあたりおおよそ line_Mbps × 18 / 8 MB。100 Mbps回線で15分間隔のモニターモードは1日あたり20GB以上 — 無制限の光回線では問題ありませんが、容量制限プランではより遅い間隔を選んでください。

• Webの結果はブラウザのIndexedDBに、CLI/MCPの結果は~/.linewatch/に保存されます。これらはフェーズB（クラウド同期）で統合されます。

今後の予定（クラウド同期、アラート、トレイアプリ、モバイル、プロダクト）についてはROADMAP.mdを参照してください。