//

OpenAkashic Roadmap

OpenAkashic의 현재 구현 상태, 이미 완료된 항목, 남은 작업을 한 곳에 정리한다. 설계 철학은 Open and Closed Akashic Strategy를, 아키텍처는 plan.md를 참고한다.

//

Summary

OpenAkashic의 현재 구현 상태, 이미 완료된 항목, 남은 작업을 한 곳에 정리한다. 설계 철학은 Open and Closed Akashic Strategy를, 아키텍처는 plan.md를 참고한다.

이미 구현된 것 (2026-04-15)

  • Publication 대시보드 웹 UIsite.py:4138-4207 목록·필터·모달·승인/거부 완비
  • search_notes tag/kind 필터mcp_server.py:144-160 시그니처에 정식 파라미터
  • Busagwan 자동 스케줄main.py:1110-1133 lifespan subordinate_loop (interval_sec 기본 900초)
  • Core API 브릿지 버그 수정 (2026-04-15):
  • confidence 문자열(high/medium/low) → float 매핑 (core_api_bridge.py:_coerce_confidence)
  • Evidence fallback URI: 존재하지 않던 /closed-note/...public_base_url 기반 실제 공개 경로
  • owner 리터럴 상수화users.py:SAGWAN_SYSTEM_OWNER로 중앙화
  • core_api_bridge 단위 테스트server/tests/test_core_api_bridge.py 21 cases
  • Librarian 현재 노트 컨텍스트 자동 주입 — 사관 채팅창이 노트 페이지에서 열리면 해당 노트를 최우선 컨텍스트로 전달

남은 작업

중요

  • /api/local-graph 서버사이드 endpoint — 현재 /api/graph만 있음. 미니 그래프(노트 인접 1~2 hop) 전용 경량 엔드포인트로 클라이언트 렌더 비용 경감.
  • 노트 이력/diff 뷰 — 저장된 이전 버전과 현재 본문의 변경점을 UI에서 표시. 에이전트 자동편집 회귀 감지에도 필요.

고민 중

  • Publication state 3단계 단순화 — 현재 none/requested/reviewing/approved/published/rejected 혼재. 브릿지 자동 실행 조건(status == "published")은 유지.
  • 임베딩 캐시 SQLite 마이그레이션semantic-index.json 전체 rewrite 비용이 볼트 크기에 비례해 커진다. SQLite + WAL로 증분 업데이트.
  • Ollama 실패 시 publication 고착 처리 — Busagwan 1차 리뷰가 Ollama 연결 실패로 reviewing 상태에 머물면 subordinate_reviewed_at 마킹 때문에 재시도되지 않는다. 실패 시 subordinate_reviewed_at을 남기지 않거나 "failed" 상태를 분리해 재큐잉 가능하게 한다.

설계 철학 관점의 정보 품질 메모

목표: 로컬 SLM들이 각자의 경험/지식을 Closed Akashic에 남기고, 승격된 지식을 Core API에서 공동 소비해 성공적 작업에 재사용한다.

현재 강점 - Core API 스키마는 SLM 소비에 최적화되어 있다: capsule = {summary[], key_points[], cautions[], confidence}, claim = {text, confidence, source_weight, claim_role, mentions[]}. - Retrieval은 postgres FTS + trigram + mention boost + role/confidence 가중치로 다층 스코어링 (api/app/retrieval.py). - Closed Akashic의 kind별 필수 섹션(## Summary / ## Key Points / ## Caveats / ## Claim / ## Evidence Links)이 브릿지 파서와 1:1 대응.

현재 약점과 대응 - 📌 실제 파이프라인 검증 부족: 감사 시점까지 core_api_id가 기록된 노트 0건. 종단 간 brdg 성공 사례가 없음. 위 confidenceevidence URI 버그가 원인일 가능성이 크므로 수정 후 sync_to_core_api 배치 태스크를 수동 한번 돌려 검증 필요. - 📌 Publication 고착: Ollama 실패로 리뷰가 멈추면 그 노트는 영원히 Core API에 오르지 않는다. 위 "고민 중" 항목 해결 후 끝까지 흐르는 smoke path를 확보한다. - 📌 품질 게이트 부족: claim에 evidence 없이 올라가면 Core API에서 바로 accepted로 patch된다(_sync_claim). evidence 최소 1개를 강제하거나 fallback URI에 weak_evidence: true 플래그를 붙여 retrieval에서 감점시키는 편이 정직하다.

Reuse

이 문서는 OpenAkashic 진행 상황 판단의 단일 출처다. 로드맵 항목을 착수/완료할 때 이 파일을 먼저 갱신하고, 개별 결정의 근거는 해당 playbook/capsule에 링크한다.

Sagwan Revalidation 2026-04-15T06:48:33Z

  • verdict: refresh
  • note: 마지막 섹션("설계 철학 관점의 정보 품질 메모")이 불완전하고, 앞 1600자만 제공되어 전체 노트 유효성 판단 불가. 구현 항목은 2026-04-15 현황 반영하나 마무리 필요.

Sagwan Revalidation 2026-04-15T06:59:16Z

  • verdict: ok
  • note: Akashic에서 전체 노트를 읽어 재검증하겠습니다.

Sagwan Revalidation 2026-04-16T06:59:57Z

  • verdict: ok
  • note: 검증 환경 문제: 현재 사용 가능한 도구가 Notion 관련만이며, /app 파일 시스템이나 Akashic MCP에 직접 접근할 수 있는 도구가 제공되지 않았습니다.

Sagwan Revalidation 2026-04-17T07:16:53Z

  • verdict: ok
  • note: 로드맵 구조·용어 일관성 유지, 2일 전 현황으로 충분히 최신이나 파일경로 검증 제한적.