feat(doc-store): #75 PR 1 — schema 재정의 (8 collections + assignment_id rename)

[hagyutae]

Summary

#75 재설계의 첫 implementation PR. Doc Store MCP 의 collection 구조를 chat tier (sessions / chats / assignments) + A2A tier (a2a_contexts / a2a_messages / a2a_tasks / a2a_task_status_updates / a2a_task_artifacts) + 도메인 산출물 (issues / wiki_pages) 로 재정의. 기존 agent_tasks / agent_sessions / agent_items 폐기 (cut-over).

본 PR 은 schema / repositories / tools / typed client / migration 영역만. UG chat protocol / handler / Chronicler 본 처리 로직 / Primary 의 Assignment 발급 등은 후속 PR.

새 Schema (8 테이블)

Tier	테이블
Chat tier	sessions / chats (immutable) / assignments
A2A tier	a2a_contexts / a2a_messages (immutable) / a2a_tasks / a2a_task_status_updates (immutable) / a2a_task_artifacts (immutable)
도메인 산출물 (기존 유지)	issues / wiki_pages (FK 컬럼 agent_task_id → assignment_id rename)

자세한 schema 는 knowledge-model §4.2.

Migration (004_redesign_chat_a2a)

• forward + rollback 한 쌍.
• forward: 기존 3 테이블 drop → 새 8 테이블 create → issues / wiki_pages 의 FK column rename → 새 FK 제약 추가.
• rollback: 새 8 테이블 drop → 컬럼 이름 복원 → 기존 3 테이블 재생성 + FK 복원. (cut-over 라 기존 데이터 복원 불가.)
• yoyo-migrations 가 부팅 시 자동 적용.

Downstream cleanup

영역	변경
shared/event_bus/events.py	본 PR 미수정 — agent_task_id 필드명 / 어휘는 PR 2 에서 3 layer 이벤트 분리 시 함께 정리
chronicler/processors/*	3 processor 모두 stub (no-op + warn-log). PR 2 에서 본 처리 로직 재작성
agents/librarian/tools.py	agent_* read 도구 → 새 collection 의 read 도구 21 개로 재정의 (assignments / sessions / chats / a2a_*)
agents/librarian/config/base.yaml	persona / skill description 어휘 정렬
agents/primary/tools/doc_store.py	agent_tasks_get/list 제거 (Assignment 발급은 chat protocol 도입 — PR 4 — 이후)

검증

단위 / 통합 테스트

모듈	테스트 수	결과
shared	55	✓
mcp/doc-store (schemas + repositories integration)	24	✓
chronicler (stub no-op 검증)	6	✓
agents/librarian	21	✓
agents/primary	23	✓

실 환경 부팅

• docker compose --profile agents up -d --build → 10 컨테이너 정상 부팅
• Migration 004 자동 적용 — \dt 결과 8 새 테이블 + 2 도메인 = 10 collection
• Primary lifespan 로그: primary tools wired: doc_store=on, issue_tracker=on, wiki=on, librarian=on, total=21
• Librarian: librarian agent ready (..., tools=21)
• 양 agent / Chronicler 모두 정상 부팅

후속 PR (#75 implementation roadmap)

• PR 2: shared/event_bus 새 이벤트 (chat / assignment / A2A 3 layer × 종류) + Chronicler processor 재작성 (현재 stub 을 본 처리 로직으로)
• PR 3: shared/a2a chat handler + 자동 Task wrap fix (trivial / stateful 분기) + BatchQueueConcurrency hook (P / A thread-level queue + batch merge — 응답 중 추가 발화 의미 판단 #72)
• PR 4: UG chat protocol routes (REST POST + 영속 SSE per session) + FE Chat.tsx 재작성 (multi-chat UI + localStorage)
• PR 5: Primary chat handler 통합 + persona 가이드 + 통합 검증

본 PR 머지 후 PR 2 진행.

기존 이슈 영향

• Chronicler 적재 누락 / 버그 — agent_tasks/sessions/items 데이터 모델 의도와 어긋남 #69 / UG/FE 대화 thread 영속화 + 다중 채팅 UI — 리프레시 복구 + 새 채팅 / 이력 관리 #70 / UG/FE 인터페이스 결함 — streaming flag stuck + Stop 버튼 + queued 이벤트 표시 #71 / P / A thread-level queue + batch merge — 응답 중 추가 발화 의미 판단 #72 — 본 PR 머지 후 body 재작성 (M3 재설계 — UG↔P/A chat tier 분리 + schema 재정의 + 어휘 정렬 #75 §7 plan)
• shared/a2a: graph entry partial state sanity — cancel 후 dangling user / tool 안전망 #73 / PR feat(shared/a2a): graph entry partial state sanity (#73) #74 — A2A tier 에 그대로 적용 가능. 본 재설계 implementation 마무리 후 PR feat(shared/a2a): graph entry partial state sanity (#73) #74 재개

Refs #75

🤖 Generated with Claude Code