Knowledge Trust Core

AI 지향 지식 시스템을 위한 이식 가능하고 결정적인 신뢰 정책입니다.

Knowledge Trust Core는 좁지만 중요한 질문에 답합니다. 이 지식이 이 목적을 위해, 이 위험 수준에서, 이 범위 내에서 사용될 수 있는가? 증거 성숙도, 출처(provenance), Claim 유형, 의도된 용도, 소스 패밀리 독립성을 실행 가능한 SDK 및 CLI, 읽기 전용 MCP 판정으로 변환합니다.

이것은 진실 오라클이 아니며 숫자로 된 'truth score'를 내보내지 않습니다. 정교하게 다듬어진 주장도 여전히 틀릴 수 있습니다. 이 패키지는 사용자가 선언한 증거 경계만을 강제할 뿐입니다.

왜 이런 것이 필요한가

대부분의 지식 베이스는 출처와 결론을 저장하지만 최종 안전 규칙은 프롬프트에 남겨 둡니다. 어떤 Agent는 seed를 존중하는 반면, 다른 Agent는 그것을 조용히 사실로 취급합니다. Knowledge Trust Core는 그 규칙을 이식 가능하고 테스트 가능하게 만듭니다.

• 동일한 작성자가 스무 번 반복되어도 여전히 하나의 소스 패밀리로 간주됩니다.

• External Source 페이지는 아이디어, 실험, 질문 또는 카피에 영감을 줄 수 있지만, 기본적인 사실적 답변이 될 수는 없습니다.

• 운영 용도에는 확증(corroboration)이 필요하며, 고위험 및 공개적 사실 용도에는 검증(validation)이 필요합니다.

• 명시적 금지와 범위 불일치는 항상 성숙도보다 우선합니다.

• 모든 판정은 안정적인 이유 코드, 주의사항, 증거 공백, 적용 중인 정책 버전을 반환합니다.

Related MCP server: vigile-mcp

포함된 내용

• 검증, 의도된 용도 판정 및 승격 검사를 위한 TypeScript SDK

• 버전 관리되는 기본 정책 및 감사 가능한 사용자 지정 정책 로딩

• 카노니컬 JSON Schema 계약

• 중국어 Claim 라벨이 포함된 읽기 전용 Markdown/Obsidian 어댑터

• 읽기 전용 CLI: validate, evaluate, promotion-check, audit

• 읽기 전용 MCP 도구: trust_validate, trust_evaluate, trust_promotion_check

• 합성 JSON, Obsidian 및 선택적 GBrain-host 예제

의도적으로 제외된 것

이 패키지는 지식을 저장, 검색, 순위화, 편집, 커밋, 인덱싱 또는 동기화하지 않습니다. Git, 데이터베이스, 벡터 인덱스, GBrain-write 또는 proposal-queue 기능이 없습니다. 어떤 저장소나 검색 시스템과도 함께 사용할 수 있으며, 검색 후 Agent가 결과를 사용하기 전에 호출하면 됩니다.

빠른 시작

git clone https://github.com/haorantang97/knowledge-trust-core.git
cd knowledge-trust-core
npm install
npm run verify

SDK:

import { evaluateUse, validateRecord } from "knowledge-trust-core";

const parsed = validateRecord(candidate);
if (!parsed.ok) throw new Error(JSON.stringify(parsed.issues));

const verdict = evaluateUse(parsed.record, {
  intended_use: "operational_decision",
  risk_level: "ordinary",
  scope: ["ordinary internal workflow"]
});

if (verdict.decision === "deny") {
  console.error(verdict.reason_codes);
}

CLI:

npm run build
node dist/src/cli.js validate examples/obsidian/seed-rhetoric.md --json
node dist/src/cli.js evaluate examples/obsidian/seed-rhetoric.md \
  --use copywriting_inspiration --json
node dist/src/cli.js audit examples --json

MCP:

KNOWLEDGE_TRUST_ALLOWED_ROOTS=/absolute/path/to/knowledge \
  node dist/src/mcp/server.js

Payload 기반 MCP 호출은 파일시스템 접근이 필요하지 않습니다. 파일 기반 호출은 대상의 카노니컬 경로가 KNOWLEDGE_TRUST_ALLOWED_ROOTS 내부에 있을 때만 허용되며, 심링크를 통한 이탈은 거부됩니다.

기본 성숙도 정책

전체 매트릭스는 Claim 유형, 출처 귀속, 명시적 허용/금지 목록, 범위 및 증거 공백도 확인합니다. docs/model.md를 참조하세요.

소스 패밀리 독립성

n > 1만으로는 충분하지 않습니다. 동일한 업스트림 작성자의 리포스트, 클립, 반복된 주장은 여전히 하나의 소스 패밀리입니다. seed에서 corroborated로의 승격에는 적어도 두 개의 진정으로 독립적인 패밀리의 지지가 필요하며, 미해결된 충돌 패밀리가 없어야 합니다. validated로의 승격에는 추가로 선언된 범위 내에서의 반복 테스트 또는 고품질 증거가 필요합니다.

저장소 어댑터

카노니컬 JSON이 경계입니다. 포함된 Markdown 어댑터는 노트를 수정하지 않고 신뢰 메타데이터를 읽으며, 참조 ID에서 Obsidian 별칭(alias)과 앵커(anchor)를 제거하고, 누락된 성숙도를 추측하지 않습니다. 기존의 산문 우선(prose-first) 지식 베이스는 명시적 계약으로의 점진적 마이그레이션이 필요할 수 있습니다. docs/migration.md를 참조하세요. GBrain은 선택 사항이며 단지 가능한 검색 호스트로만 취급됩니다. docs/integration.md 및 examples/gbrain-host를 참조하세요.

개발

npm test
npm run typecheck
npm run build
npm run privacy-check
npm run verify

릴리스 게이트는 타입 검사를 수행하고, 모든 테스트를 실행하며, JSON Schema를 재구축하고, 개인 경로 또는 자격 증명을 스캔하며, npm 패키지 매니페스트를 검사합니다.

중국어 소개

이것은 사실 판정기가 아니라 삽입 가능한 '지식 사용 경계' 엔진입니다. seed / corroborated / validated, 소스 패밀리 독립성, Claim 유형, 적용 범위 및 의도된 용도를 결정적인 코드 규칙으로 만듭니다. Obsidian, 벡터 라이브러리, GBrain 또는 임의의 검색 시스템 뒤에 연결하여 저성숙도 자료가 Agent에 의해 기본 사실이나 고위험 결정의 근거로 취급되는 것을 차단할 수 있습니다.

라이선스

MIT