Skip to content

v0.1.0

Choose a tag to compare

@github-actions github-actions released this 21 Jul 06:59

여러 호스트/작업 공간의 지식을 출처(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 초기 릴리스 - 저장 포맷과 표면이 향후 바뀔 수 있습니다.

설계 문서