v0.1.0
여러 호스트/작업 공간의 지식을 출처(provenance)를 보존한 채 온톨로지(개념/관계 그래프)로
통합하고 MCP 로 질의/탐색하는, 임베디드/파일 기반 Rust 서버의 첫 릴리스입니다.
supragnosis= supra(위/너머) + gnosis(앎) - 지식 위의 지식(메타지식).
하이라이트
MCP 도구 (LLM 에이전트 표면)
observe- 지식 조각을 불변 관측(진실의 원천)으로 적재하고 엔티티/관계를 온톨로지에 링크search_knowledge- 의미 + 키워드 하이브리드 검색 (응답mode로 degrade 여부 표기)get_entity- 엔티티 + 관계 + 출처 조회 (부재는 거짓이 아니라 미지 - 열린 세계 가정)traverse- 관계 그래프 n-hop 순회workspace_map- 공동출현 맥락(하이퍼엣지)을 이름으로 개관, 검색 전 오리엔테이션- 리소스: 온톨로지 그래프 / 하이퍼그래프 / 관측 역참조(원문 + 출처 + 계보)
지식 모델
- event sourcing - 불변 관측 로그가 진실의 원천, 그래프는 결정적 프로젝션
- 출처 1급 시민 - 위임 사슬 + 신뢰 등급, 콘텐츠 주소(blake3)로 경로 무관 dedup
- 하이퍼그래프(이차 구조) - 한 관측이 공동 주장한 엔티티 집합을 되살려, 이진 관계가
버린 "무엇이 함께 말해졌는가"(맥락)를 회복. 스키마 유도/해소/응고의 결정적 입력 - Cozo/RocksDB 영속 - 관계 + 그래프 + 벡터(HNSW) 통합, 헥사고날 포트-어댑터
실행 모드
- stdio MCP - 에이전트가 자식 프로세스로 기동
- standalone HTTP 데몬 - localhost 상시 데몬 하나가 db 를 잡고 여러 에이전트가 공유
- 라이브 온톨로지 뷰어 - localhost canvas: 하이퍼엣지 hull 오버레이, visibility 토글,
관계 종류별 엣지 색상, 검색/순회 발자국
설치
curl -fsSL https://raw.githubusercontent.com/Ashon/supragnosis/main/scripts/install.sh | sh또는 아래 자산에서 플랫폼 tar.gz 를 직접 내려받아 압축 해제 후 supragnosis 를 PATH 에 둡니다.
- 지원 플랫폼: macOS(arm64 / x86_64), Linux(x86_64). 각 자산에
.sha256체크섬 포함. - 등록 예:
claude mcp add supragnosis -- ~/.local/bin/supragnosis
참고 / 한계
- prebuilt 바이너리는 키워드 + hashing 검색입니다. 로컬 ONNX 의미 검색은 소스에서
cargo build --release --features fastembed로 빌드하세요(무거운 ONNX 런타임 의존이라 제외). - HTTP 데몬 / 뷰어는 loopback 전용(무인증) - 로컬 신뢰 표면. 원격 노출/인증/TLS 는 후속.
- 0.x 초기 릴리스 - 저장 포맷과 표면이 향후 바뀔 수 있습니다.
설계 문서
- 아키텍처:
docs/architecture.md - 설계 원칙:
docs/principles.md - 제안 워크플로:
docs/proposal-workflow.md