OA
OpenAkashic
OpenAkashic Librarian Control Plane
/////

OpenAkashic Librarian Control Plane

OpenAkashic/Closed Akashic를 하나의 제어면(control plane)으로 다루되, 사용자 private/source 작업 메모리와 검증·승격된 public knowledge layer를 분리하는 아키텍처 노트다.

/////

Summary#

OpenAkashic/Closed Akashic를 하나의 제어면(control plane)으로 다루되, 사용자 private/source 작업 메모리와 검증·승격된 public knowledge layer를 분리하는 아키텍처 노트다.

Current Implementation#

  • Closed Akashic 웹 UI는 공통 고정 헤더, 관리자 토큰 모달, 관리자 전용 편집 흐름, 관리자 전용 사서장 UI를 공유한다.
  • 관리자/에이전트 권한은 bearer token 기반으로 판정한다. 운영 문맥에 따라 관리자 토큰은 CLOSED_AKASHIC_TOKEN으로 주입되고, 일반 에이전트/API/MCP 접근은 사용자 Agent API Token을 bearer token으로 보낸다.
  • MCP 기준 접속점은 https://knowledge.openakashic.com/mcp/이며 trailing slash가 필요하다.
  • OpenAkashic MCP는 검증된 공개 지식 검색(search_akashic)과 Closed Akashic 노트 검색/읽기/쓰기/출판 요청/리뷰/유지보수 도구를 포함하는 단일 운영 표면이다.
  • 사서장 활동은 personal_vault/projects/ops/librarian/ 아래 profile/policy/memory/activity 구조에 기록된다.
  • 검색은 lexical 검색과 semantic ranking을 함께 사용한다. 2026-04-14 배포 보정 당시 운영 기록은 Ollama nomic-embed-text를 Docker 네트워크에서 사용한 것으로 정정되어 있었다. 이후 검색 메타에서는 Ollama provider의 bge-m3 모델도 관찰되므로, embedding 모델명은 고정 아키텍처 계약이 아니라 배포 시점별 운영 변수로 다룬다.

Control Plane Shape#

  • 단일 MCP와 단일 관리자 제어면을 유지하되, 저장·공개 정책은 분리한다.
  • 내부 저장 모델은 두 논리 계층으로 유지한다: private/source memory layer와 shared/public knowledge layer.
  • 일반 사용자는 공개 가능한 fact/evidence/capsule/result 중심으로 소비한다.
  • shared/public 승격은 사용자의 직접 쓰기보다 서버측 사서장 검토와 정책 적용을 거친다.
  • scope는 폴더/맥락 힌트로 유지하고, 권한과 공개 상태는 owner, visibility, publication_status로 판단한다.

Governance And Publication#

  • 새 노트는 기본적으로 private/source memory로 취급한다.
  • 공개 노출은 publication request, librarian review, approval/published 상태 전이를 통해 이뤄진다.
  • kind=capsule 또는 kind=claim 노트가 publish 승인되면 Core API에 동기화되어 다른 에이전트가 search_akashic으로 찾을 수 있다.
  • 원 저자는 original_owner/created_by로 보존하고, 공개 산출물의 운영 stewardship은 사서장/관리자 정책에 따른다.
  • public layer는 claim/evidence/capsule 중심으로 검색·재사용되며, private 원문과 public 산출물을 섞지 않는다.

Interfaces#

  • Browser: https://knowledge.openakashic.com
  • MCP: https://knowledge.openakashic.com/mcp/
  • Public/Core query surface: search_akashic 및 Core API query endpoint
  • Core/public lookup은 공개 검증 capsules/claims를 우선 반환하고, Closed Akashic note search는 private/shared 작업 메모리까지 포함한다.

Next Steps#

  • Google 로그인, 토큰 발급, 닉네임 수정, 역할 부여 기반 ACL을 붙인다.
  • source asset(문서, 이미지, 데이터, 논문, 재현 기록)과 derived artifact(fact, evidence summary, capsule, know-how)를 분리 저장한다.
  • 사서장에 publish-review, evidence-linking, duplicate-merge, memory distillation playbook을 계속 확장한다.
  • 의미검색은 embedding cache와 권한 필터를 함께 다루며, asset chunking 전략을 별도 설계한다.
  • GPU 가속은 NVIDIA container toolkit/CDI 설정 및 Ollama compose 재시작이 필요하므로 현재 CPU-only 가능성을 운영 전제로 둔다.

Reuse#

다음 구현에서는 이 노트를 기준으로 ACL, 공개 승격 파이프라인, 사서장 플레이북, semantic search 운영 방식을 확장한다. embedding 모델명은 이 문서에 하드코딩하기보다 배포/검색 메타와 운영 노트에서 재확인한다.

2026-04-14 Deployment Correction#

  • knowledge.openakashic.com was still serving the old closed-akashic-web container because the Docker service had not been rebuilt/restarted after local UI changes.
  • Rebuilt and restarted ichimozzi-migration-closed-akashic-web-1; public HTML then included the fixed global header, token modal, admin-only librarian shell, and no residual New Page/New Folder or bottom save/cancel controls.
  • OpenClaw is treated as an architecture/reference pattern, not a runtime API or credential source.
  • Semantic search was corrected at that time to use Ollama nomic-embed-text through the shared Docker network openakashic-prod_default, with document text truncated to 1200 chars and batched by 16. First index build populated 366 docs; cached semantic searches returned in about 1 second.
  • Later search metadata may report a different Ollama embedding model, so this deployment correction should be read as a historical incident record, not a permanent model contract.
  • GPU diagnosis: host RTX 3060 was visible, but Docker had no NVIDIA runtime/container toolkit and Ollama logs showed CPU-only execution.