Context Surface Analyzer

로컬의 결정론적 유틸리로, 하나의 명시적 에이전트 도구 카탈로그 스냅샷을 측정하고 두 스냅샷을 비교합니다.

정규 UTF-8 바이트와 SHA-256 다이제스트, 도구/스키마 개수, 완전히 일치하는 중복 스키마, 하드 이름 충돌, 선언된 예산 검사, 그리고 델타를 보고합니다. 선택 토큰 개수는 외부에서 측정된 값으로 남아 있으며 완전히 라벨링돠게 같습니다. 이 제품은 바이트로부터 토큰를 추론하거나 어떤 도구가 유용인지 판단하지 않습니다.

실행

Node.js 22 이상이 필요하며, 제삼자 런타임 의존성이 없습니다.

npm run check
node src/cli.js analyze examples/baseline.json
node src/cli.js diff examples/baseline.json examples/updated.json
npm start

웹 화면은 http://127.0.0.1:4173에서 열립니다. 임시 포트를 선택하려면 --port 0을 사용하세요. 스냅샷은 붕여넣거나 크기가 제한된 로컬 JSON 파일에서 불러올 수 있습니다. 페이지를 닫은 뒤에도 브라우저는 스냅샷을 보유하지 않습니다.

Related MCP server: repo-health

스냅샷 출처

각 스냅샷은 현재의 제공자, 호스트, 또는 인가된 내보내기 도구로부터 획득해야 합니다. 이 제품은 의도적으로 호스트를 찾지 않으며, 임의 MCP 서버를 실행하지 않거나 파일을 크롤링하지 않고, 리포지토리의 스처를 현재 installed 카탈로그로 취급하지 않습니다. 분석 전에 내보낸 카탈로그를 폐쇄 context-surface.snapshot.v0.1 형식으로 변환하고, 추출하는 내보내기·제공자·모든 버전을 기록의 원천으로 계속 개, 유지해야 합니다.

MCP

개행으로 구분된 JSON-RPC stdio 서버를 실행하세요.

npm run mcp

다음과 같은 읽기 전용 도구 두 가지를 제공합니다.

• context.analyze: 스냅샷 하나를 분석 하나로;

• context.diff: 이전 및 이후 스냅샷을 비교 결과 하나로.

두 도구 모두 스냅샷 JSON을 크기가 제한된 문자열로 받습니다. 그래서 Agent 경로에는 암묵적인 파일시스템 권한이 없습니다. 스냅샷 계약과 정확한 의미는 제품 모델을 참조하세요.

이 이식 가능한 런타임은 의도적으로 MCP 2025 레거시 시대를 위해 리버전 2025-11-25까지 제공됩니다. 이중 시대 클라이언트는 server/discover 메서드 없음 응답에서 그 경계를 발견하고 initialize로 폴백할 수 있습니다. 2026 전용 현대 전송 계층은 이 의존성 없는 플러그인에 적용되지 않습니다.

로컬 Codex 플러그인

리포지터리 로컬 플러그인을 빌드하고 검증한 다음, 이 리포지터리를 로컬 마켓플레이스로 추가하고 플러그인을 설치하세요.

npm run check
codex plugin marketplace add <repository-root>
codex plugin add context-surface-analyzer@context-surface-analyzer

설치를 완료한 후 새 Codex 작업을 시작하면, Skill과 MCP 도구가 동일한 캐시 버전의 플러그인에서 로드됩니다.

상태

이것은 로컬 MVP입니다. 개발 검증, 직접 런타임 실행, 설치된 Codex 라우팅, 프로덕션 부하 동작, 공개 릴리스 준비, 그리고 당신의 시각적 승인은 별개 항목으로 나중에 처리됩니다.

라이선스

Apache License 2.0. LICENSE 및 NOTICE를 참조하세요.