Skip to content

docs(v04): align spec with shipped runed/vault/envector SDKs - #97

Merged
couragehong merged 1 commit into
feat/go-migrationfrom
yg/docs-v04-align-shipped-sdks
May 5, 2026
Merged

couragehong merged 1 commit into
feat/go-migrationfrom
yg/docs-v04-align-shipped-sdks

Conversation

@couragehong

@couragehong couragehong commented May 4, 2026 •

Copy link
Copy Markdown
Contributor

Summary

docs/v04/의 spec 문서들을 형제 프로젝트(runed, rune-admin/vault, envector-go-sdk)의 실제 출하 상태와 정합화. 코드 변경 0줄.

정정 항목

  • embedder.md: placeholder를 실값으로 — runed.v1 / RunedService / github.com/CryptoLabInc/runed / ~/.runed/embedding.sock. runed/client 라이브러리 hybrid 활용 옵션 명시.
  • vault.md: RuneVaultService → VaultService (proto의 실제 service 이름). proto stub은 github.com/CryptoLabInc/rune-admin/vault/pkg/vaultpb import (자체 protoc 불필요).
  • envector.md:
    • "Vault-delegated 보안 모델" §의 SDK 패치 제안 → SDK가 WithKeyParts(KeyPartEnc, KeyPartEval)로 정식 지원 (Q4 Resolved)
    • 코드 샘플 EvalMode·Preset 라인 미지정 → SDK zero value 추적 (envector 서버 RMP deprecation 대비; SDK가 MM으로 default 전환 시 자동 따라감)
    • typed errors 8개 정확히 (ErrKeysNotForEncrypt/Decrypt/Register 추가, ErrDecryptorUnavailable·ErrKeysAlreadyActivated는 SDK에 없음)
    • libevi 5 OS/arch 모두 vendored (이전 "모두 빈 상태" 표기 정정)
  • README.md: 용어집 "runed = 폐기" → "embedder의 정식 이름으로 부활". Phase 4 envector PR 블로킹 메모 (Q4) 해소.
  • decisions.md: D30 entry placeholder → Resolved 값.
  • progress/README.md: phase-a6/a7/a8 행 + Phase 1 deps 실 import target 명세 (Go toolchain 1.26 bump 동반).

Validation

  • 정정 사항 모두 SDK 실제 코드와 대조 검증 완료 (envector errors.go/keysoptions.go/doc.go, runed proto/runed/v1/runed.proto/client/client.go, rune-admin/vault pkg/vaultpb)
  • N/A Tests: docs only

Cross-Agent Invariants

  • N/A — docs only, scripts·SKILL·command 변경 없음

Notes for Reviewers

  • envector EvalMode·Preset 라인 미지정은 의도적: SDK zero value 추적 전략 (rune-admin/vault/internal/crypto/keys.go와 동일 패턴)
  • runed의 go 1.26.2 directive로 rune-go(go 1.25.9) bump 필요는 별도 Phase 1 deps PR에서 처리 예정

🤖 Generated with Claude Code

- embedder: placeholder → 실값 (runed.v1 / RunedService /
  github.com/CryptoLabInc/runed / ~/.runed/embedding.sock).
  runed/client 라이브러리 hybrid 활용 옵션 명시
- vault: RuneVaultService → VaultService (실제 proto의 service 이름).
  proto stub은 rune-admin/vault/pkg/vaultpb 그대로 import
- envector: "조건 완화 PR" 통째 압축 (SDK가 WithKeyParts로 정식 지원).
  코드 샘플 EvalMode·Preset 미지정으로 SDK zero value 추적 (서버
  RMP deprecation 대비). typed errors 8개 정확히 정정. libevi
  5 OS/arch 모두 vendored
- README/decisions: 용어집 "runed=폐기" → "embedder 정식 이름으로
  부활". D30 entry placeholder → Resolved 값
- progress: phase-a6/a7/a8 행 + Phase 1 deps 실 import target 명세

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@couragehong
couragehong merged commit f6d7d66 into feat/go-migration May 5, 2026
1 check passed
@couragehong
couragehong deleted the yg/docs-v04-align-shipped-sdks branch May 5, 2026 13:42
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