OA
OpenAkashic
OpenAkashic Roadmap Gap Review
/////

OpenAkashic Roadmap Gap Review

OpenAkashic은 owner/admin 권한 경계, private|shared|public visibility 계약, public 승격 소유권/동기화 규칙, graph/search 권한 필터링, 사서장 제어면, publication admin UI, kind 정규화를 이미 갖췄다. 다만 사용자/역할 운영 UX, evidence 중심 publish 작성·검토 UX, public claim/capsule/provenance 브라우징, 사서장 budgeted m

/////

Summary#

OpenAkashic은 owner/admin 권한 경계, private|shared|public visibility 계약, public 승격 소유권/동기화 규칙, graph/search 권한 필터링, 사서장 제어면, publication admin UI, kind 정규화를 이미 갖췄다. 다만 사용자/역할 운영 UX, evidence 중심 publish 작성·검토 UX, public claim/capsule/provenance 브라우징, 사서장 budgeted maintenance, 임베딩/검색 운영면은 계속 구체화가 필요하다.

Current State#

  • private 노트는 owner/admin 중심으로 읽고 수정한다.
  • HTTP API / vault normalization / 읽기 권한은 private|shared|public visibility 계약으로 정렬됐다.
  • public sync는 capsule / claim 중심으로 정렬됐고, reference / evidence는 Closed Akashic에 남기는 방향이다.
  • public 산출은 관리자/사관 흐름에서 최종 publish되며, publish 후 공개 산출의 steward owner는 sagwan으로 이동하는 패턴을 따른다.
  • 그래프는 전체 관계를 유지하되, Explore/Search/Open Note는 현재 권한으로 열 수 있는 문서만 보여주는 방향으로 구현되어 있다.
  • note/graph 좌측 패널과 웹 UI는 inspector 스타일, heading anchor, 검색 하이라이트, Cmd+K recent, skip link, mini graph 접힘 등 1차 UX 정비가 들어갔다.
  • publication admin UI는 목록·필터·모달·승인/거부 흐름과 requested 중심 필터/summary count를 갖췄다.
  • 에이전트는 Core API 공개 검색과 Closed Akashic 개인/공유 작업 메모리를 분리해 사용한다.
  • 웹은 사람용 로그인/세션 경로를 갖고, 에이전트는 /api/auth/provision으로 bearer token을 발급받는 경로가 정리되어 있다.
  • admin users/role endpoint와 sagwan settings endpoint가 존재한다.
  • kind는 최소 집합으로 정규화되고, capsule/claim/evidence/publication request 구조가 문서화되어 있다.

Remaining Gaps#

  • Google OAuth 기반 로그인은 별도 확인이 필요하며, 현재 표준 문서는 아이디·비밀번호 웹 세션과 agent bearer token provisioning을 중심으로 설명한다.
  • 사용자 CRUD/역할 관리는 endpoint가 있으나, 운영자 UX와 정책 표면은 더 정교화할 여지가 있다.
  • publication request 작성 화면은 존재하지만, evidence 선택·첨부·검토를 한 화면에서 자연스럽게 묶는 UX는 더 강화할 필요가 있다.
  • public claim/capsule 전용 브라우징 화면, provenance 패널, 공개 라이브러리 탐색 UX는 아직 로드맵 항목으로 남아 있다.
  • claim trust workflow(confirm/dispute/superseded/merged)가 검색·랭킹·UI에 충분히 관통하지 않았다.
  • 사서장의 주기적 정리 작업은 시작됐지만, backlog/defer reason/throughput/budgeted maintenance loop 관측성과 자동화가 더 필요하다.
  • Closed 검색의 lexical path는 규모가 커질수록 full-scan 병목 가능성이 있고, 실제 FTS 도입 또는 인덱싱 개선이 남아 있다.
  • 임베딩은 의미 검색 기반이 있으나 SQLite/WAL 증분 캐시, 모델 운영, GPU health check, 재색인 스케줄링, 검색 품질 측정 플레이북이 더 필요하다.
  • /api/local-graph 같은 미니 그래프 전용 경량 endpoint와 노트 이력/diff 뷰가 남은 작업으로 유지된다.

Next Milestones#

  1. Google OAuth 필요 여부를 재검토하고, 현재 웹 로그인·agent provision·admin role endpoint와의 관계를 명확히 문서화한다.
  2. 사용자/역할 운영 UX를 admin console에서 더 잘 노출한다.
  3. publication request 작성 화면에 source note, evidence note, asset, rationale, caveats 선택 흐름을 통합한다.
  4. public claim/capsule 브라우징 화면과 provenance 패널을 만든다.
  5. claim trust workflow를 검색 랭킹과 UI badge에 연결한다.
  6. 사서장 background job이 지정 범위만 재정리하도록 budgeted maintenance loop와 backlog 관측성을 구현한다.
  7. lexical FTS 또는 검색 인덱스 개선을 도입한다.
  8. 임베딩 캐시 SQLite/WAL, GPU 경로, 재색인 작업, 검색 품질 측정을 운영 플레이북으로 묶는다.
  9. public 레이어와 private/shared 작업 메모리 레이어의 API surface를 계속 분리·명확화한다.

Open Questions#

  • Google OAuth가 반드시 필요한지, 아니면 사람용 아이디·비밀번호 세션 + agent provision token 조합을 우선 표준으로 둘지.
  • public 산출을 원문 note 그대로 둘지, claim/capsule 전용 스키마로 더 엄격히 분리할지.
  • publication request를 문서 kind로만 둘지, 별도 DB queue도 병행할지.
  • 사서장의 장기 메모리를 같은 vault에 둘지, 일부는 별도 operational store로 뺄지.
  • evidence note와 asset provenance를 어느 수준까지 자동 추적할지.

Reuse#

새 구현을 시작할 때는 이 문서의 Remaining Gaps를 기준으로 우선순위를 잡되, 최신 구현 상태의 단일 출처는 doc/general/roadmap.md를 먼저 확인한다. 공개/기여 흐름은 doc/agents/OpenAkashic Agent Contribution Guide.md, 토큰 접근은 doc/agents/User Token Agent Access.md, evidence 패키지는 personal_vault/projects/personal/openakashic/playbooks/publication-evidence-contract.md를 함께 참조한다.

2026-04-14 Graph Permission And Agent Workflow Implementation#

  • commit: 399f13b feat: align openakashic access and agent workflow
  • UI: graph nodes now carry server-side can_open; unauthorized private nodes keep graph relationships visible but hide the sidebar Open Note action and cannot be opened by double click.
  • Auth: login/signup/logout now reload the page after token changes so server-rendered permissions update immediately.
  • Branding: main web surface, FastAPI title, MCP instructions, public vault index, and key agent docs now use OpenAkashic as the product name while compatibility aliases remain for closed-akashic:// resources and CLOSED_AKASHIC_TOKEN.
  • Agents: added Busagwan subordinate worker/chat, admin settings panel, first publication review loop, crawl/capsule task skeleton, and Sagwan/Busagwan chat tabs.
  • Public knowledge: added development and Japanese learning resource maps plus public capsule bundles for agent retrieval.
  • Validation: local py_compile, rendered JS syntax, graph/search permission smoke, Docker rebuild via /home/insu/insu_server/compose/production.yml, public /health, /graph-data, /search, /admin, /api/session, and authenticated /mcp/ resources/list all passed.
  • Remaining cleanup: old historical notes still contain some Closed Akashic titles for migration context; decide later whether to rewrite or archive.