hermes-team-hub: 정적 팀 로그와 로컬 실시간 화면

이 저장소는 PM·Dev·Infra·QA·Ops 역할별 입력 화면과 팀 로그를 보여 준다. 공개 README는 Pages를 정적 데모, local/app.py를 Hermes 칸반·프로필·Coral 상태를 읽는 로컬 실행형으로 구분한다. 같은 이름의 허브라도 데이터 출처가 다르므로 두 경로를 합쳐 실시간 서비스로 설명하지 않는다. README

냉정한 기술 평가

평가일: 2026-10-28 · 근거 커밋: 1406ee05e3ea21a9e0c53aa0856879c976cd3ac5. 공개 소스의 정적 평가이며 실제 운영 결과나 개인의 기여 범위를 확정하지 않는다.

• 구조·설계 — 양호 Pages의 브라우저 저장 기록과 로컬 서버의 Hermes 조회를 별도 경로로 둔다. js/store.js 1–18행 local/app.py 1–17행
• 구현 품질 — 위험 로컬 HTTP의 GET 경로가 허용 목록의 일부 상태 변경 Hermes 명령을 실행하고, 응답은 모든 Origin을 허용하며 요청 출처 검사가 보이지 않는다. 루프백 서비스라도 다른 웹 페이지에서 요청을 유도할 가능성을 고려해야 한다. 실제 외부 호출은 확인하지 않았다. local/app.py의 Handler, 1091–1136·1221–1224행
• 운영 준비 — 보완 필요 서버는 루프백에 바인딩하지만 프로필 기본 위치는 특정 PC 형태다. 다른 기기에서 데이터 위치를 설정해야 하고, 로컬 명령 API의 브라우저 접근 경계도 보완해야 한다. local/app.py 29–31·1091–1097·1263–1268행
• 유지보수 — 보완 필요 정적 기록은 한 브라우저의 localStorage에만 저장된다. 팀 공유 기록으로 해석하지 않도록 데이터 범위와 백업 방법을 유지해야 한다. js/store.js 6–31행

좋은 점: 정적 기록과 로컬 실시간 조회의 데이터 경계를 나눴고 CLI 명령은 허용 목록으로 제한한다. 개선 우선순위: P1 — 상태 변경 명령을 읽기 GET에서 분리하고 요청 출처·확인 경계를 두어 로컬 API의 의도하지 않은 호출을 줄인다. P2 — 역할별 칸반 필터 상태와 프로필 기본 위치를 정리한다. 명령 허용 목록 1100–1136행 · 공유 필터 128–185행

Pages 쪽의 기록 흐름

js/app.js는 역할 탭과 대시보드를 렌더링한다. js/store.js의 HubStore는 hermes-team-hub.logs.v1 키로 입력한 기록을 브라우저 localStorage에 추가·조회·삭제하고 날짜·역할로 정렬한다. 이 데이터는 브라우저별 로컬 상태다. 다른 팀원의 기기와 자동 공유되는 DB가 아니다. 화면 로직 · 브라우저 저장소

로컬 실행형의 데이터 흐름

local/app.py는 Python 표준 라이브러리 ThreadingHTTPServer를 루프백 주소에 바인딩한다. /api/kanban은 hermes kanban list --json을 호출해 결과를 변환하고 5초 메모리 캐시를 둔다. /api/agents는 프로필의 SOUL 문서에서 표시 정보를 읽고, /api/coral, /api/logs 등의 로컬 조회 경로가 있다. 일부 POST API는 로컬 JSON을 저장한다. 별도의 GET 경로는 허용 목록의 Hermes 명령을 실행하며 이 목록에는 상태 변경 명령도 있다. 이는 읽기 전용 상태 조회와 구분해야 한다. 개인 PC 자료를 다루므로 Pages 데모의 공개 데이터와 혼동해서는 안 된다. 로컬 HTTP 서버의 GET·POST, 1162–1257행 · 명령 허용 목록 1100–1136행

local/team_hub.py는 log, view, timeline, report, reset 명령을 분기한다. 공통 모델의 append_activity는 역할을 검사하고 시각을 채워 activities.jsonl에 기록하며 load_activities는 날짜·역할·카드·태그 필터로 읽는다. JSONL 모델과 정적 Pages의 localStorage는 별도 저장 방식이다. CLI · JSONL 모델

정적 화면의 칸반 검색·상태 필터는 하나의 전역 상태를 공유한다. 역할별 검색 입력은 따로 저장하지만 탭 전환 후 필터가 섞일 수 있다. 이 판단은 코드의 상태 공유에서 나온 것이며 실제 화면 증상을 실행해 확인한 것은 아니다. js/app.js 128–185행

아직 확인하지 않은 연결

README는 hermes-env의 SOUL 파일로 소개 카드를 생성하는 연계를 예정이라고 표현한다. 이것은 완료된 자동 동기화의 근거가 아니다. 로컬 서버를 실행해 실제 Hermes·Coral 연결을 확인하지 않았고, 다른 기기 사이의 동기화도 검증하지 않았다. 연계 상태 원문

기준 커밋은 1406ee05e3ea21a9e0c53aa0856879c976cd3ac5다. 역할·데이터 분리는 코드로 확인했지만, 김동기의 개인 담당 범위와 설계 선택 이유·운영 성과는 확인하지 못했다.