LLM_Op: add safeguarded natural-language manifest planning

[JANG00000]

Important

2026-08-12 최신 상태: geon 1999d79 동기화와 Guard-first 승인 Flow 연결을 완료했고, LLM_Op head는 4334d74입니다. GitHub Actions의 browser contract·Go test·vet·CLI·team validation이 모두 통과했습니다. 아래 초기 본문의 “Go 테스트 미실행” 상태는 이 안내와 최신 갱신 댓글로 대체합니다. geon 작업자가 브랜치 안에서 역할 경계를 확인할 수 있는 docs-only Draft는 PR #2입니다.

@gunsun2000 안녕하세요. 이 Draft PR은 geon을 대체하거나 바로 병합하기 위한 PR이 아니라, 별도 LLM_Op 작업의 존재와 경계를 공유하고 API 결합점·버그를 지속적으로 협의하기 위한 채널입니다.

게시·검증 상태

• 이 본문은 base=geon, head=LLM_Op Draft PR의 협업 메시지로 사용합니다. geon 브랜치에 직접 push하거나 별도 cherry-pick을 요구하지 않습니다.
• 요구사항정의서상 SFR-OPS-04~06은 2027 항목이며, 이 PR은 해당 흐름을 앞서 구체화하는 2026 선행 PoC·부분 구현입니다. 공식 요구사항 완료를 주장하지 않습니다.
• 현재 증적은 fixture JSON 구문 확인과 소스·계약의 정적 검토입니다. 작업 환경 보안 정책에 따라 Go 테스트와 demo command는 아직 실행하지 않았습니다.
• 따라서 아래 HANDOFF_READY는 구문·책임 경계·자원 상한과 명시 자원값/Profile 최소값/선택 Resource exact 값/fresh availability boolean의 결정적 모순 검사를 통과한 prepare-only 초안이라는 구현 의도를 뜻합니다. 일반 자연어 의미의 정답, 관측 provenance, 실제 capacity, Qwen·AppDeployer 종단간 성공 증적을 뜻하지 않습니다.

LLM_Op의 범위

• 사용자 자연어 요청 + AppDeployer 상태·로그·bounded metric 정규화
• 잠정 10분 freshness·1분 timestamp skew, 입력 log 500개·보존 log 50개, Qwen user message 128 KiB, collection·문자열 제한, Bearer/API key/PEM·신뢰 ID redaction
• parameters JSON 64 KiB·깊이 16·node 1,000·key 128 rune 제한과 credential·runtime·Target·endpoint·command key/value 거부
• 상위 계층이 지정한 Candidate 설정을 결합하는 OpenAI 호환 Qwen 연결 코드. 모델 비교·선택 로직은 없고 AllowLiveCompletion=false가 기본이며 실제 endpoint·과금 API는 호출하지 않음
• 같은 caller-bound candidate와 공통 정규화 context를 사용하되 review/Proposal별 required_output 계약을 분리한 두 단계. fixture demo는 두 고정 JSON만 사용
• Completion content 64 KiB 제한과 status·candidate/provider/model의 adapter/config 일관성 검사(provider attestation은 아님)
• Safeguard LLM에는 allow/clarify/reject만, Proposal LLM에는 제한된 자원 Proposal만 허용
• 구조화 제약이 없으면 자연어 CPU·GPU·memory·storage exact 값, 있으면 자연어 양수 값/Profile 하한·명시적 GPU 0 exact no-GPU·선택 Resource candidate exact 값을 Proposal과 대조하고, CPU·memory·storage 0, 모호·범위·상충 값과 fresh readiness 모순을 fail-closed
• trusted app_version_id/requested_by/optional target hint는 Go mapper가 적용
• create confidence 0.5 이상과 CPU 256·GPU 16·memory 2Ti·storage 64Ti 상한 및 AppDeploy Go Manifest Guard 통과 후 HANDOFF_READY 반환
• evidence.input.*_included는 정제된 관측 본문의 prompt 포함 여부이며 실제 추론 사용·feasibility 증명이 아님
• demo completion은 실제 Qwen 호출이 아닌 고정 JSON fixture
• 현재 검증 경로의 Qwen·AppDeployer 네트워크 호출 수와 API 비용은 0
• 초기에는 prepare_only이며 AppDeployer POST를 호출하지 않음
• HANDOFF_READY의 next_endpoint는 정보성 상대 경로이며 호출·승인·도달 가능성을 뜻하지 않음
• handoff.prepared_request와 golden fixture는 AppDeploy DeploymentCreateRequest의 정확한 body key를 제공하지만 실제 전송하지 않음
• AppDeployer 제출 adapter와 승인 reference 검증 adapter는 아직 없음
• Repair는 자동 값 수정·재호출이 아니라 clarify/reject로 fail-closed하며 사용자 왕복·재시도 계약은 후속 범위
• 필수 ID 누락, 비-prepare_only mode, 임의 approval reference, parameter 경계 위반은 REQUEST_REJECTED; Safeguard review의 reject_request와 Proposal의 reject_unsafe_request도 같은 상태 사용
• 공식 종단 진입점은 llmop.SafeguardedPlanner; 내부 llmop.Planner 직접 호출은 review를 우회하므로 Proposal 단위 테스트 외 통합 경로에서 사용 금지

geon과 겹치지 않도록 한 부분

• 새 코드는 internal/llmop, internal/llmopbridge, cmd/llmop-demo, examples/llm-op에 격리했습니다.
• 기존 deploymentplanner.GenerateInput, ControlRun, Agent Registry, API route, OpenAPI는 아직 수정하지 않았습니다.
• 기존 Agent Control의 ApplicationProfile → ResourceRecommendation → Common JSON envelope는 수정하지 않았습니다. 별도 bridge는 correlation/trace/causation과 Profile/Recommendation join을 확인해 Profile minima와 선택된 single-node Resource candidate exact 값을 분리 투영하며 ModelRecommendation·artifact·resource hint는 제외합니다. 실제 LocalRequirementAnalyzer 기본 CPU Profile보다 큰 catalog 후보도 exact 값으로 보존하고, device-memory minimum이 있는 자연어 GPU 경로는 AppDeploy v1에서 강제할 수 없어 fail-closed합니다. 공식 route 결합 위치는 이 PR에서 합의해야 합니다.
• 공식 HTTP 결합점은 geon 방향을 확인한 뒤 별도 작은 커밋으로 제안하겠습니다.

먼저 확인할 문서:

• docs/coordination/to-geon-llm-op-handoff.md
• docs/coordination/geon-bug-notes.md
• docs/llm-op/01-contract.md
• docs/llm-op/03-common-json-bridge.md
• examples/llm-op/README.md

확인을 요청하는 사항

1. 공식 결합점을 기존 ControlRun으로 둘지 별도 prepare-only Planner endpoint로 둘지
2. AppDeployer 관측값을 geon이 수집해 전달할지, LLM_Op 요청자가 제공할지
3. 승인 검증·idempotency 계약이 생기기 전 prepare_only 경계를 유지하는 데 동의하는지
4. geon에서 변경 예정인 충돌 고위험 파일이나 계약이 있는지
5. 10분 age·1분 skew·50개 retained log 및 자원 상한을 provisional defaults로 유지할지 실제 운영 주기에 맞춰 조정할지
6. 모델 선택은 상위 계층 책임으로 유지하고 LLM_Op에는 명시적 candidate 결합만 둘지
7. 현재 bridge가 fail-closed하는 SLO·cost·GPU device memory·multi-replica minimum을 어느 계약에서 표현할지
8. LocalRequirementAnalyzer가 자연어 GPU 요청에 넣는 device-memory minimum을 AppDeploy v1이 표현하지 못하는 현재 계약 공백을 어떻게 해소할지

정적 검토 중 공유할 버그

• AppDeployer COMPLETED를 geon polling이 성공 terminal로 처리하지 않는 문제
• 한글 요청 길이가 Request Guard에서는 rune, Generator에서는 byte로 계산되는 불일치
• DeploymentManifest JSON Schema가 OpenAPI/Go 모델보다 느슨하고 requirements가 누락된 drift
• X-Request-ID 전달과 idempotency가 분리되어 있지 않아 POST 재시도 시 중복 Deployment 위험이 있는 계약 공백
• AppDeployer와 geon에 approval reference를 검증할 verifier 계약이 없는 공백
• 기존 full-Manifest Qwen Generator와 새 bounded-Proposal LLM_Op을 동시에 공개할 경우 Guard·상태 계약이 갈라지는 위험

위 항목은 실행 재현 결과가 아니라 정적 검토 발견이며 상세 근거는 docs/coordination/geon-bug-notes.md에 있습니다. 버그를 서로 발견하거나 재현 결과가 달라지면 이 Draft PR에서 근거와 영향을 교환하겠습니다.

[JANG00000]

2026-08-12 geon 동기화 및 Guard-first 기준 갱신

이 갱신은 PR 본문의 초기 정적 검토 상태보다 최신이며, 아래 상태를 현재 기준으로 봐 주십시오.

• 최신 geon 1999d79를 LLM_Op에 병합했고 현재 head는 4334d74입니다.
• 권위 통합 순서는 Registry binding → Review* → allow_request only → geon 분석/추천/DEPLOY/Guards/INITIAL revision → ProjectApprovedInitialFlow → PrepareApproved*입니다. 시스템의 최초 live LLM 호출 전에 LLM_Op Safeguard가 와야 합니다.
• 별도 서비스나 Agent로 다시 구현하더라도 action 의미, fail-closed, 두 Manifest의 소유권, prepare-only 경계는 LLM_Op 호환 기준을 따라야 합니다.
• LLM_Op은 최초 자연어 Safeguard와 bounded AppDeploy prepare-only 투영을, geon은 canonical Flow/DesiredDeploymentSpec/ManifestRevision 및 Operation Optimization을 소유합니다. AppDeploy/후단만 실제 Target·Runtime ID, 배치, 제출을 소유합니다.
• geon 브랜치 안에서도 기준을 발견할 수 있도록 docs-only Draft PR #2를 열었습니다: docs(geon): establish LLM_Op guard-first compatibility baseline #2
• 기준 문서: docs/coordination/llm-op-guard-first-integration-standard.md
• 최신 CI는 browser contract, Go 전체 test, vet, CLI, team validation을 모두 통과했습니다: https://github.com/cloud-barista/ai-ops/actions/runs/31560338837

현재 release boundary도 유지합니다. public HTTP route/orchestrator는 아직 연결하지 않았고 AppDeploy POST도 하지 않습니다. plain SHA-256 continuation은 trusted in-process 연결 증거일 뿐 외부 인증 토큰이 아닙니다. geon LocalRequirementAnalyzer의 replica default, GPU 0 해석, GPU device-memory default는 structured provenance가 정리되기 전까지 fail-closed하며 우회 성공으로 바꾸지 않습니다. 실제 과금 모델 호출은 기본 차단되어 있습니다.