voidlight00/3fools-pingpong/3fools-context-store

3fools-context-store

목적

3 pane이 공유하는 단일 진실 store. SPEC.md §5 스키마 그대로 구현. append-only · lock · redact 강제.

파일별 스키마 (SPEC §5)

context.jsonl

{"ts":"<ISO8601 UTC>","kind":"directive|classification|dispatch|result|block|note","from":"user|pane2|pane3|pane4","to":"<optional>","content":"<string|object>","refs":["<file:line>"]}

decisions.jsonl

{"ts":"<ISO8601>","domain":"arch|impl|verify","owner":"pane4|pane2|pane3","decision":"<one-sentence>","rationale":"<one-sentence>","supersedes":"<prev-decision-id|null>"}

handoffs.jsonl

{"ts":"<ISO8601>","id":"hf-<seq>","from":"pane<n>","to":"pane<m>","status":"sent|completed|failed|timeout","prompt_en":"<...>","expect":"<...>","result_ko":"<...>","duration_s":<int>}

append 룰 (SPEC §8 S3)

1. lock 획득 — .3fools/locks/<filename>.lock 파일 생성 (PID + ts)
2. append — 한 줄 JSON, 줄바꿈 1개로 끝
3. lock 해제 — lock 파일 unlink

lock 보유 중 2회째 시도 = 후순위 abort (재시도 1회만).

domain 권한 (SPEC D14)

• decisions.jsonl 에 쓸 때 domain ↔ owner 매칭 강제:
• arch owner는 pane4만
• impl owner는 pane2만
• verify owner는 pane3만
• 위반 시 항목 reject (S4)

redact 자동 적용

모든 append 전에 content/decision/rationale/prompt_en/result_ko 필드에 redact 패턴 적용 (3fools-oauth-mesh 스킬의 패턴 표 참조).

size 가드

• 단일 파일 100MB 초과 시 archivist 자동 호출 → rotate (context.jsonl.YYYY-MM-DD-<n> 백업)
• 단일 라인 64KB 초과 시 거부 (대용량 content는 별도 파일에 저장 후 refs 링크)

조회 API (read-only)

• tail : 마지막 N개 (status 모드)
• grep : 패턴 매칭 (특정 핸드오프 추적)
• since <ts> : 특정 시각 이후 (resume 모드)

사용 에이전트

• 3fools-router-claude (모든 분류·dispatch·종합 append)
• 3fools-impl-gpt (handoffs completed append)
• 3fools-explorer-gemini (handoffs completed append)
• 3fools-conductor (RUN_MANIFEST 갱신 + size 가드 모니터)
• 3fools-archivist (kill --archive 시 read-only 종합)