Linewatch

인터넷 품질을 시간에 따라 측정 — 에이전트 네이티브. 단일 숫자에 그치지 않는 간소화된 speedtest.net: 계속 측정하고, 추세를 차트로 그리고, 끊김을 기록하며, 증거를 깔끔한 JSON으로 당신(또는 AI 에이전트)에게 전달합니다.

2026년 8월 19일 제작. 작업 라벨 — 이름은 나중에 평소처럼 정하면 됩니다.

존재 이유

특정 시점의 속도 테스트는 회선이 매일 저녁 실제로 끊기거나 처지는 동안에도 정상으로 보일 수 있습니다. 세 가지 실패 모드에는 세 가지 종류의 측정이 필요합니다:

설계 원칙: 무거운 테스트는 드물게, 저렴한 테스트는 자주.

자체 서버 없음: 측정은 Cloudflare의 공개 CORS 개방 속도 엔드포인트(speed.cloudflare.com)를 대상으로 실행되므로 엔진은 모든 브라우저나 Node 프로세스에서 무료로 작동합니다.

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초, ~0 데이터)를 호출하고 필요할 때만 run_speed_test(~20초, ~100–500MB)로 확대합니다 — 도구 설명에 이러한 비용이 명시되어 에이전트가 결정할 수 있습니다.

데이터 참고 사항

• 속도 테스트는 ~18초 동안 전체 회선 속도로 데이터를 전송합니다: 테스트당 대략 line_Mbps × 18 / 8 MB. 100Mbps 회선에서 15분 모니터 모드는 하루 약 20GB 이상 — 무제한 광섬유에서는 괜찮지만, 데이터 제한 요금제에서는 더 느린 주기를 선택하세요.

• 웹 결과는 브라우저의 IndexedDB에 저장되고, CLI/MCP 결과는 ~/.linewatch/에 저장됩니다. 이들은 Phase B(클라우드 동기화)에서 병합됩니다.

이 프로젝트의 방향(클라우드 동기화, 알림, 트레이 앱, 모바일, 제품)은 ROADMAP.md를 참조하세요.