Skip to content

feat: Knowledge 런타임 후보 해석 경계 도입 - #391

Merged
HyungminYoon1 merged 10 commits into
devfrom
feature/mba-232
Jul 13, 2026
Merged

HyungminYoon1 merged 10 commits into
devfrom
feature/mba-232

Conversation

@HyungminYoon1

Copy link
Copy Markdown
Contributor

변경 사항

  • 서버가 소유한 direct Knowledge Base와 명시적으로 선택한 Knowledge Collection을 현재 권한·준비 상태에 따라 실행 후보로 해석하는 runtime resolver 계약을 추가했습니다.
  • authenticated/anonymous audience를 명시적 타입으로 분리하고, direct-first, Collection round-robin, canonical KB 중복 제거, 최대 20개 budget 정책을 Shared 순수 도메인 정책으로 구현했습니다.
  • Workflow Engine application port/use case와 PostgreSQL adapter/composition을 추가했습니다. Adapter는 invocation마다 새 REPEATABLE READ, READ ONLY transaction을 사용하고 candidate/authorization 결과를 invocation 사이에 cache하지 않습니다.
  • Collection별 ordered LATERAL cap을 global window 전에 적용해 membership scan을 제한하고, 하나의 timezone-aware transaction_timestamp()로 source-policy/provenance 만료를 평가합니다.
  • authenticated source-managed KB는 materialized source authorization provenance를 기준으로 fail-closed하며, anonymous source-managed KB는 public exposure primitive가 없어 제외합니다. Live connector 호출과 runtime source cache는 포함하지 않습니다.
  • 실제 PostgreSQL two-transaction 테스트로 membership, Collection route, KB use, organization membership, source provenance, Collection/KB lifecycle 변경 시 현재 invocation의 일관성과 다음 invocation의 변경 반영을 검증했습니다.
  • 관련 경로 변경 시 실제 PostgreSQL 검증을 실행하는 GitHub Actions workflow와 ADR-0036 및 Knowledge 공식 문서를 추가·갱신했습니다.
  • API, graph schema/migration, Builder/preflight, LLM node, retrieval fan-out 연결은 이번 범위에 포함하지 않으며 후속 이슈에서 resolver를 연결합니다.

관련 이슈

Linear: MBA-232

변경 유형

  • 버그 수정
  • 새로운 기능
  • 리팩토링
  • 문서 수정
  • 기타: PostgreSQL 동시성 검증 및 경로 기반 CI

테스트

  • 로컬에서 테스트 완료

  • 기존 테스트 통과 확인

  • Workflow Engine: 571 passed

  • Shared permission/domain: 423 passed, 9 skipped

  • Gateway Knowledge/root regression: 183 passed, 1 skipped

  • 실제 PostgreSQL snapshot/adapter: 33 passed

  • Focused Knowledge/runtime: 65 passed, 9 skipped

  • 변경 Python 파일 Ruff, workflow YAML parsing, conflict marker 검사, git diff --check: 통과

9 skipped는 opt-in disposable PostgreSQL 테스트이며, 별도의 임시 PostgreSQL 실행에서는 해당 테스트를 포함해 모두 통과했습니다. 1 skipped는 기존 환경 의존 Gateway integration 테스트입니다.

스크린샷 (UI 변경 시)

UI 변경 없음

@linear-code

linear-code Bot commented Jul 13, 2026

Copy link
Copy Markdown

MBA-232

@HyungminYoon1

Copy link
Copy Markdown
Contributor Author

@codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. 🚀

Reviewed commit: 391370f609

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@HyungminYoon1
HyungminYoon1 marked this pull request as ready for review July 13, 2026 10:11
@HyungminYoon1
HyungminYoon1 merged commit 740f318 into dev Jul 13, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant