model profile 저장소 위치와 XGENY_CONFIG_HOME을 문서에 명시 - #61
Merged
Conversation
격리된 측정에서 XGENY_STATE_HOME만 설정하고 model setup을 실행하자 사용자의 실제 프로필 저장소에 profile이 생기고 active가 바뀌었다. 프로필 저장소는 state root가 아니라 XGENY_CONFIG_HOME이 정하는 config root를 쓰는데, 이 변수는 코드와 테스트에만 있고 사용자·개발 문서 어디에도 없었다. getting-started의 삭제 절에 profile 파일의 platform 경로와 XGENY_STATE_HOME이 profile 위치를 바꾸지 않는다는 사실을, model-onboarding에 XGENY_CONFIG_HOME과 그 검증 규칙(절대경로, base directory 거부, Unix 0700)을, public-local-run-resume의 격리 안내에 두 변수가 독립이라는 문장을 넣었다. 실측: 0700 빈 directory를 XGENY_CONFIG_HOME으로 주면 model list가 빈 목록을 보이고 실제 저장소는 그대로다. 0755 directory는 profile_store_unavailable로 거부된다. scripts/check-rc3-public-docs.sh PASS. 코드 변경 없음.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
배경
격리된 측정(2026-09-07 vLLM dry run)에서
XGENY_STATE_HOME만 설정하고model setup을 실행하자 사용자의 실제 프로필 저장소(~/Library/Application Support/XGENy/model-profiles.json)에vllm프로필이 생기고 active가 바뀌었다. 프로필 저장소는 state root가 아니라XGENY_CONFIG_HOME이 정하는 config root를 쓴다(model_profile.rs::discover_config_root). 이 변수는 코드와 통합 테스트(model_profiles.rs,environment_onboarding.rs,interactive_repl.rs)에만 있고 사용자·개발 문서 어디에도 없었다.변경 사항
docs/getting-started.md삭제 절: profile 파일의 platform 경로(Linux$XDG_CONFIG_HOME/xgeny·$HOME/.config/xgeny, macOS$HOME/Library/Application Support/XGENy, Windows%APPDATA%\XGENy),XGENY_STATE_HOME은 profile 위치를 바꾸지 않는다는 사실, credential까지 지우려면model remove를 먼저 실행하라는 안내.docs/development/model-onboarding.mdProfile 관리 절:XGENY_CONFIG_HOME과 검증 규칙(절대경로, home/config base directory와./..거부, Unix0700), 격리 실험에서 저장소를 건드리지 않는 두 방법(XGENY_CONFIG_HOME병행 설정 또는--base-url/--model/--tokenizer명시).docs/development/public-local-run-resume.md실행 절: 두 변수가 독립이라는 한 문장.코드 변경 없음.
실제로 동작하게 된 것
문서만 바뀌었다. 사용자가 격리 test나 measurement를 만들 때 실제 프로필 저장소를 오염시키지 않는 방법을 문서에서 찾을 수 있다.
데이터 경계
변화 없음. 저장소 경로와 권한 검증은 ADR-0032 그대로다.
검증
XGENY_CONFIG_HOME에 0700 빈 directory를 주고model list→No model profiles configured, 실제 저장소(default,qwen38active)는 그대로.FAIL reason=profile_store_unavailable(exit 69). 문서의0700규칙 문장과 일치.sh scripts/check-rc3-public-docs.shPASS.범위 밖
XGENY_STATE_HOME을 따르게 하는 코드 변경(ADR-0032 경계 변경이라 별도 ADR 필요).--help문구에 config 경로를 넣는 것.