변경 이력

Prism 플러그인은 Semantic Versioning을 따릅니다. 플러그인 소스는 grumatic/optra-prism-plugin에 있으며, 권위 있는 파일은 해당 저장소의 CHANGELOG.md입니다. 여기서는 상위 수준의 주제만 요약합니다.

플러그인 — v0.8.0 (현재)

• 커밋·저장소 근거 수집. 프롬프트를 캡처할 때 그 시점의 저장소 스냅샷(정제된 원격 호스트, 소유자·그룹 경로, 브랜치, 헤드 커밋, 작업 트리 상태 등)을 함께 남기고, 응답이 안전하게 기록된 뒤에는 그 턴에 만들어진 커밋의 추가·삭제 줄 수를 보고할 수 있습니다. 파일 경로·diff·커밋 메시지·작성자 정보는 수집하지 않습니다.
• 옵트인 방식. 커밋 보고는 Prism 서버가 받겠다고 알려 줄 때만 전송됩니다(최대 5분에 한 번 확인, 키·대상별 캐시). 확인이 1시간 넘게 오래되면 다시 받을 때까지 보고를 멈추며, 그전까지는 이전 릴리스와 똑같이 동작합니다.
• 격리된 큐. 커밋 보고는 프롬프트·응답 캡처와 별도의 디스크 큐를 쓰므로, 보고 큐가 막히거나 실패해도 프롬프트·응답 전달을 지연·유실·재정렬시키지 않습니다.
• 강한 프라이버시 보장. 원격 URL은 호스트와 경로만 남기고 자격 증명·포트·쿼리·프래그먼트를 버립니다. 저장소 지문은 설치마다 한 번 만든 32바이트 비밀키로 HMAC 처리하며, 커밋된 작업만 측정합니다(스테이징·미추적 변경은 세지 않음). 큐에 쌓인 보고는 소유자 전용 권한으로 저장되어 30일 뒤 삭제됩니다.
• /prism:status 확대. 커밋 보고가 활성인지, 큐에 몇 개가 쌓였고 처리됐는지를 개수와 사유로 함께 보여 줍니다.

플러그인 — v0.7.x

• 업데이트 인지. 세션 시작 시 새 버전이 게시되었는지 하루 한 번 이내로 확인해 시작 메시지 하나로 알려 줍니다. 플러그인을 새로 불러온 뒤 첫 프롬프트에서는 재시작을 권합니다.
• 키가 환경에 묶입니다. /prism:setup은 키를 발급받은 ingest 대상에 묶습니다. 이후 apiKey나 ingest_url을 손으로 바꾸면 로컬에서 감지해 거부하므로, 데이터가 엉뚱한 곳으로 조용히 전송되지 않습니다. 이 릴리스 이전 설치는 다음 /prism:setup 전까지 그대로 동작합니다.
• 더 안전한 제거. /prism:uninstall이 무엇을 지울지 먼저 보여 주고, 실제로 건드리기 직전에 다시 확인하며, 그사이 무엇이든 달라졌으면 아무것도 바꾸지 않고 중단합니다. 다른 플러그인의 설정은 건드리지 않습니다.
• 비용은 서버에서 옵니다. 응답 비용은 플러그인에 박아 둔 가격표가 아니라 Prism이 제공하는 모델 카탈로그를 사용하며, 가격을 알 수 없는 모델은 틀린 숫자 대신 cost n/a로 표시됩니다.
• 응답 유실 없음. 응답은 디스크에 쌓아 두고 서버가 수신을 확인할 때까지 재시도하므로, 네트워크 문제나 재시작으로 응답이 사라지지 않습니다.
• /prism:doctor 진단 확대. 관리 헬퍼 상태와 디버그 로깅 활성화 여부, 그리고 로그가 기록되는 파일을 보고합니다.
• 명령이 격리된 에이전트로 실행됩니다. 각 슬래시 명령은 가벼운 컨트롤러를 두고, 실제 실행은 필요한 도구만 가진 포그라운드 에이전트에 위임합니다.
• 프롬프트·응답 본문 상한 상향. 예전의 2000자 클라이언트 상한을 없애고 백엔드 상한(2 MiB)까지 담으며, 드물게 잘릴 때는 잘림 표시를 붙입니다.

플러그인 — v0.6.x

플러그인의 실시간 및 구성 표면입니다.

• /prism:realtime — 현재 세션에 대한 온디맨드 요약: 서브세션별 등급, 턴 및 토큰 활동, 그리고 짧은 서술입니다. 서버 측 점수를 사용합니다(로컬 “Lite” 등급은 제거되었습니다). 실시간 요약은 옵트인 방식입니다(show_realtime_summary, 기본값 off).
• /prism:config — 명시적인 show / help / set / unset 액션으로 런타임 구성을 관리합니다. /prism:config와 /prism:help는 사용자가 편집할 수 있는 필드를 현재 값 및 기본값과 함께 열거합니다. 설정의 기준은 ~/.prism/config.json 한 곳에 있습니다.
• API 키 — Prism API 키(prism_*)는 레거시 gck_* 접두사와 함께 지원됩니다. 셋업은 비어 있지 않은 모든 키를 불투명한(opaque) 값으로 취급하며, 인증 판별은 백엔드에 맡깁니다.
• Ingest 오버라이드 — 로컬 개발을 위해 ingest 베이스 URL을 환경 변수 또는 구성으로 오버라이드할 수 있습니다. 플러그인 버전 출처(provenance)가 요청에 첨부됩니다.
• 정리 — Stop 훅(hook)의 컨텍스트 넛지와 로컬 토큰 추적이 제거되었습니다. 플러그인은 더 이상 Claude Code 연결 설정을 수정하지 않습니다.

플러그인 — v0.4.x

• /prism:doctor — 결정론적 검사를 수행하는 진단 명령입니다. 스코프 인지 정리로 좀비 플러그인의 부활을 방지합니다.
• /prism:report — 주간 비교용으로 재작성되었으며, 토큰 사용량 차트를 포함합니다. 채점은 사양 기준 공식을 따르고, 등급 렌더링은 대시보드와 일치합니다.
• 게이트웨이 라우팅 제거. 플러그인은 더 이상 Claude Code의 API 호출을 Optra 게이트웨이로 우회시키지 않으며, Claude Code의 연결 설정도 건드리지 않습니다. 요청은 Anthropic으로 바로 가고, 텔레메트리와 채점에는 영향이 없습니다.
• 도메인 마이그레이션 optra-prism.com으로 이전.
• 설치 스코프 감지 및 수동 설치 수정.

플러그인 — v0.1.0 (2026-04-02)

grumatic/optra-prism-plugin 마켓플레이스를 통한 첫 독립형 플러그인 릴리스입니다. 초기 슬래시 명령과 핵심 텔레메트리를 담았습니다: OTEL 전송(로그, 메트릭), 세션 비용/토큰 추적, 그리고 SessionStart / UserPromptSubmit / Stop / PostCompact 라이프사이클 훅.

현재 슬래시 명령: /prism:setup, /prism:status, /prism:config, /prism:doctor, /prism:realtime, /prism:report, /prism:help, /prism:uninstall.

플랫폼 (API + 대시보드)

API와 대시보드는 grumatic/optra-prism에 있으며 독립적으로 버전이 매겨지지 않습니다. 현재 출시된 주요 기능은 다음과 같습니다:

• 채점 — 프롬프트 점수(Prompt Score, 현재 대표 수치): 대표 수치 지표는 프롬프트 점수입니다. 평균 프롬프트 등급을 0–100 점수에 문자 등급(letter grade)과 함께 표시한 값입니다. 프롬프트별 루브릭(항목 7개 × 의도 클래스 8개 → 등급)을 채점된 서브세션 전반에 걸쳐 평균 낸 것에서 계산됩니다. 채점 모델을 참고하세요.
• 완료율(Completion rate, 보조 지표): 채점된 서브세션 중 완료된 비율입니다. 실질 기준을 넘고, 목표에 도달하고, 이후 다시 하지 않은 서브세션을 셉니다. 프롬프트 점수와 나란히 표시되며, 대표 수치가 아닙니다.
• 보조 지표: 속도(CSPW, 곧 기간당 완료한 서브세션 수, 그리고 TTC), 토큰 사용량(완료당 토큰 = 완료한 서브세션당 토큰 중앙값), 역량(습관 기반 역량 지수 0–100과 역량 티어 초보→최상위).
• 서브세션: 각 세션은 편집 가능한 제목과 LLM 생성 요약을 가진 목표 단위 서브세션으로 분할됩니다. 실시간 SSE가 업데이트를 대시보드로 푸시합니다.
• 스로틀 감지: 네 가지 검사(요청량 제한, 지연 급증, 프롬프트 재시도, 서비스 장애)를 /v1/intelligence/throttle와 /insights/throttle 페이지에서 제공합니다.
• 적정화: 요금제 판단에 참고할 API 환산 비용과 관측된 사용량 제한 신호를 Parquet에서 직접 제공합니다. 모델이나 요금제를 추천하지는 않습니다. /v1/intelligence/rightsizing + /insights/rightsizing.
• Advisor 및 요약: LLM 세션 요약과 서브세션별 프롬프트 코칭으로, 리포트와 실시간 화면에 표시됩니다.
• 리포트: 기간 리포트와 전송 이력, 선택적 Slack 전송. 리포트 콘텐츠는 채점 파이프라인에서 나옵니다.
• Ingest: OTLP/HTTP JSON만 지원(protobuf는 415 반환), gzip 지원, NATS JetStream 백프레셔는 Retry-After: 5와 함께 503을 반환합니다. API 엔드포인트 일부가 플러그인/외부 호출자를 위해 ingest로 프록시됩니다.
• 대시보드: 내 작업(개요, 실시간, 리포트, 일일 리캡), 분석(프롬프트 점수, 속도, 토큰 사용, 역량), 인사이트(세션, 생산성, 활동, 스로틀), 고급(텔레메트리, 적정화), 팀(매니저 콘솔 — 개요 / 성과 / 비용 / 리포트)으로 구성됩니다. 설정(프로필, 조직 관리, 사용자 관리, 팀 관리)은 헤더의 계정 메뉴에서 엽니다.

제거됨 / 은퇴됨

• 집계 “PRISM Score” 지표 — “PRISM Score”라는 이름으로 브랜딩되었던 이전의 단일 0–100 완료율 수치는 더 이상 대표 수치로 표시되지 않습니다. 현재 노출되는 대표 수치는 프롬프트 점수(평균 프롬프트 등급)이며, 완료 측정치는 보조 지표인 완료율로 남습니다.
• 채점 모델 계보 — 원래의 6-차원 모델(12 metrics)은 v2.1 three-score 모델(Speed / Skill / Efficiency)로 대체되었고, 이후 완전히 은퇴되었습니다. 버전 토글은 없으며, score_version_pref 스위치와 독립형 /scoring/ v2.1 문서 섹션은 제거되었습니다.
• Waste 감지 — 7개 검사 카탈로그는 여전히 prism.waste_events에 기록하지만, /v1/intelligence/waste 읽기 엔드포인트는 제거되었습니다. waste 관점은 이제 생성된 리포트 챕터 안에서만 나타납니다.
• Recommendations API — /v1/intelligence/recommendations와 그 상태 워크플로가 제거되었습니다. 적정화와 어드바이저 코칭이 이를 대체합니다.
• Vibe Metrics — UI와 /v1/telemetry/vibe-metrics 엔드포인트가 모두 제거되었습니다.
• 레거시 v2.1 /prism/* API — 전체 /prism/* 계열과 POST /v1/intelligence/score-prompt가 제거되었습니다. 프롬프트별 채점은 이제 파이프라인 내부로 편입되었습니다. GET /v1/intelligence/prism은 하위 호환을 위해 빈 결과를 반환하는 인증된 스텁으로만 남아 있습니다.