Skip to content

Latest commit

ย 

History

History
165 lines (125 loc) ยท 10.3 KB

interactive-repl.md

File metadata and controls

165 lines (125 loc) ยท 10.3 KB

XGEN ๋Œ€ํ™”ํ˜• REPL

๋น ๋ฅธ ์‹œ์ž‘

ํ”„๋กœ์ ํŠธ root์—์„œ subcommand ์—†์ด ์‹คํ–‰ํ•œ๋‹ค. TTY์—์„œ profile์ด ์—†์œผ๋ฉด ์ œ๊ณต์ž ์„ ํƒ, ์ˆจ๊น€ API key ์ž…๋ ฅ, model ์„ ํƒ๊ณผ ์—ฐ๊ฒฐ ๊ฒ€์ฆ์„ ์ง„ํ–‰ํ•œ๋‹ค. DeepSeek์™€ OpenAI๋Š” preset์œผ๋กœ URL๊ณผ wire ์˜ต์…˜์„ ์ฑ„์šฐ๋ฉฐ, ๋‹ค๋ฅธ OpenAI-compatible endpoint๋Š” URL์„ ์ง์ ‘ ์ž…๋ ฅํ•œ๋‹ค. ์ €์žฅ๋œ ์„ค์ •์€ ๋‹ค์Œ ์‹คํ–‰๋ถ€ํ„ฐ ์žฌ์‚ฌ์šฉํ•œ๋‹ค.

cd my-project
xgen

API key๋Š” OS credential store์— ์ €์žฅํ•œ๋‹ค. ์ €์žฅ์†Œ๋ฅผ ์“ธ ์ˆ˜ ์—†์œผ๋ฉด ์ˆจ๊น€ ์ž…๋ ฅํ•œ key๋Š” ํ˜„์žฌ process์˜ ๋ฉ”๋ชจ๋ฆฌ์—๋งŒ ๋‘๊ณ  ๋‹ค์Œ ์‹คํ–‰ ๋•Œ ๋‹ค์‹œ ๋ฌป๋Š”๋‹ค. ํ‰๋ฌธ key file์ด๋‚˜ tool process ํ™˜๊ฒฝ๋ณ€์ˆ˜๋กœ ์˜ฎ๊ธฐ์ง€ ์•Š๋Š”๋‹ค. ์ž๋™ํ™”์˜ --store-token์€ ์—ฌ์ „ํžˆ ์ €์žฅ ์‹คํŒจ๋ฅผ ์˜ค๋ฅ˜๋กœ ๋ฐ˜ํ™˜ํ•œ๋‹ค.

๊ธฐ๋ณธ approval mode๋Š” ๋ชจ๋‘ ask๋‹ค. Model prompt์—๋Š” ํ˜„์žฌ goal, ์ œํ•œ๋œ ์ด์ „ ์š”์ฒญยท๋‹ต๋ณ€๊ณผ ์ดํ›„ tool observation์ด ํฌํ•จ๋  ์ˆ˜ ์žˆ๋‹ค. Read, write์™€ process execute๋Š” ๊ฐ๊ฐ ๋ณ„๋„๋กœ ๋ฌป๋Š”๋‹ค. ํ•œ goal์„ ์ฒ˜๋ฆฌํ•˜๋Š” ๋™์•ˆ ์Šน์ธํ•œ ์ข…๋ฅ˜๋Š” ์ดํ›„ continuation์—์„œ๋„ ์œ ์ง€ํ•˜๋ฉฐ, ๋‹ค์Œ goal์ด๋‚˜ ๋ช…์‹œ์ ์ธ /resume์—์„œ๋Š” ๋‹ค์‹œ ๊ธฐ๋ณธ approval mode๋ฅผ ์ ์šฉํ•œ๋‹ค. deny๋Š” ๊ณ„์† ์‹คํ–‰์„ ์ฐจ๋‹จํ•œ๋‹ค.

์Šน์ธ prompt์˜ ๋‹ต์€ ์„ธ ๊ฐ€์ง€๋‹ค(ADR-0058). y๋Š” ์ง€๊ธˆ์ฒ˜๋Ÿผ ์ด๋ฒˆ goal์—๋งŒ ํ—ˆ์šฉํ•œ๋‹ค. a๋Š” ๊ทธ ์ข…๋ฅ˜๋ฅผ ๋‚จ์€ REPL session ๋™์•ˆ allow๋กœ ๋ฐ”๊พธ๋ฉฐ /permissions KIND allow์™€ ๊ฐ™๋‹ค. ๋ฐ”๋€ ์‚ฌ์‹ค๊ณผ ๋˜๋Œ๋ฆฌ๋Š” ๋ช…๋ น์„ ํ•œ ์ค„๋กœ ํ‘œ์‹œํ•œ๋‹ค. ๊ทธ ๋ฐ–์˜ ์ž…๋ ฅ์€ ๊ฑฐ์ ˆ์ด๋‹ค. Session ํ—ˆ์šฉ์€ ํŒŒ์ผ์— ์ €์žฅํ•˜์ง€ ์•Š๊ณ  process๊ฐ€ ๋๋‚˜๋ฉด ์‚ฌ๋ผ์ง„๋‹ค.

xgen --trust๋Š” ๋„ค ์ข…๋ฅ˜๋ฅผ ๋ชจ๋‘ allow๋กœ ๋‘” ์ฑ„ session์„ ์‹œ์ž‘ํ•ด ์Šน์ธ์„ ๋ฌป์ง€ ์•Š๋Š”๋‹ค (ADR-0059). ์‹œ์ž‘ํ•  ๋•Œ ํ•œ ์ค„๋กœ ์•Œ๋ฆฌ๊ณ , /permissions KIND ask๋กœ ์ผ๋ถ€๋ฅผ ๋‹ค์‹œ ๋ฌป๊ฒŒ ํ•  ์ˆ˜ ์žˆ๋‹ค. ๊ธฐ๋ก, Changes ํ‘œ์‹œ, Ctrl+C, /resume์€ ๊ฐ™๋‹ค. ์‹ ๋ขฐ ๋ชจ๋“œ๋Š” ์‚ฌ์šฉ์ž์˜ shell(SHELL์ด bashยทzshยทsh๋ฉด ๊ทธ๊ฒƒ, ์•„๋‹ˆ๋ฉด PATH์˜ bashโ†’zshโ†’sh, Windows๋Š” pwshโ†’powershell)๋„ catalog์— ๋„ฃ๋Š”๋‹ค(ADR-0060). ๋ชจ๋ธ์€ ์ด๊ฒƒ์œผ๋กœ ํŒŒ์ดํ”„์™€ catalog์— ์—†๋Š” ๋ช…๋ น์„ ์‹คํ–‰ํ•œ๋‹ค. ์‹ ๋ขฐ ๋ชจ๋“œ์˜ goal๋‹น model turn ๊ธฐ๋ณธ๊ฐ’์€ 24๊ฐ€ ์•„๋‹ˆ๋ผ 96์ด๋‹ค(ADR-0062). --max-model-turns๋ฅผ ์ฃผ๋ฉด ๊ทธ ๊ฐ’์ด ์šฐ์„ ํ•œ๋‹ค. ์‹ ๋ขฐ ๋ชจ๋“œ๋Š” goal ๋’ค์— workspace ์ ˆ๋Œ€ ๊ฒฝ๋กœ, home, workspace ๋ฐ–์€ shell๋กœ ๊ฐ€๋ผ๋Š” ์•ˆ๋‚ด ํ•œ ๋‹จ๋ฝ์„ ๋ถ™์ธ๋‹ค (ADR-0063).

xgen> ํ”„๋กœ์ ํŠธ ๊ตฌ์กฐ๋ฅผ ๋ณด๊ณ  ํ…Œ์ŠคํŠธ ์‹คํŒจ๋ฅผ ์ˆ˜์ •ํ•ด์ค˜.
Allow sending the goal, session context, and tool observations to the model? [y/a/N] y
Thinkingโ€ฆ ยท 2s
Allow read for this durable continuation? [y/a/N] a
read allowed for this session (/permissions read ask to undo)

์ค„ ๋์— unescaped \๋ฅผ ์“ฐ๋ฉด ๋‹ค์Œ ์ค„์„ ๊ฐ™์€ goal๋กœ ์ž…๋ ฅํ•œ๋‹ค.

xgen> src๋ฅผ ํƒ์ƒ‰ํ•˜๊ณ  \
...> ์‹คํŒจํ•œ ํ…Œ์ŠคํŠธ๋งŒ ์ˆ˜์ •ํ•ด์ค˜.

๋ช…๋ น

/model [PROFILE]
/status
/permissions
/permissions model|read|write|execute ask|allow|deny
/resume [RUN_ID]
/clear
/exit

allow๋Š” ํ˜„์žฌ REPL session์—์„œ ์‚ฌ์šฉ์ž๊ฐ€ ๋ช…์‹œํ•œ ์„ ํƒ์ด๋‹ค. Process executable์€ PATH์—์„œ ๋ฐœ๊ฒฌํ•œ ๊ณ ์ •๋œ ๊ณตํ†ต ๊ฐœ๋ฐœ ๋„๊ตฌ allowlist์˜ absolute native executable๋งŒ catalogํ•œ๋‹ค. /permissions๋Š” model์— ๋ณด์ด๋Š” logical ID๋งŒ ์ถœ๋ ฅํ•˜๋ฉฐ host path๋Š” ์ถœ๋ ฅํ•˜์ง€ ์•Š๋Š”๋‹ค. Catalog๋Š” ์‹คํ–‰ ๊ถŒํ•œ์ด ์•„๋‹ˆ๊ณ , ์‹คํ–‰์€ ๋ณ„๋„ approval๊ณผ Core authorization์„ ๊ฑฐ์นœ๋‹ค. Catalog snapshot์€ ์ฒซ ์‹ค์ œ goal์—์„œ ๋งŒ๋“ค์–ด ๊ฐ™์€ REPL process์˜ resume์— ์žฌ์‚ฌ์šฉํ•˜๋ฉฐ, ์„ ํƒ๋œ binary๋Š” ๋งค ์‹คํ–‰ ์ง์ „์— ๋‹ค์‹œ ๊ฒ€์ฆํ•œ๋‹ค.

์„ธ์…˜๊ณผ ์žฌ๊ฐœ

ํ•œ goal์€ ํ•˜๋‚˜์˜ durable Run์ด๋‹ค. ์ผ๋ฐ˜ ์งˆ๋ฌธ์ด๋‚˜ ์ด์ „ ์„ค๋ช…์— ๋Œ€ํ•œ ํ›„์† ์งˆ๋ฌธ์€ ๋„๊ตฌ ์‹คํ–‰ ์—†์ด ๋‹ตํ•  ์ˆ˜ ์žˆ๋‹ค. ์ด ๊ฒฝ์šฐ /status๋Š” responded๋ฅผ ํ‘œ์‹œํ•˜๊ณ  ํŒŒ์ผยทprocess ์‹คํ–‰ ์Šน์ธ์„ ๋ฌป์ง€ ์•Š๋Š”๋‹ค. ๋„๊ตฌ Step์„ ๊ณ„ํšํ•œ Run์€ ๋Œ€ํ™” ์‘๋‹ต์œผ๋กœ ์ข…๋ฃŒํ•  ์ˆ˜ ์—†๊ณ , ๊ธฐ์กด๋Œ€๋กœ Receipt ๊ฒ€์ฆ ๋’ค ์ž‘์—… ์™„๋ฃŒ ์‘๋‹ต์„ ์ถœ๋ ฅํ•œ๋‹ค.

์ตœ๊ทผ ์š”์ฒญยท๋‹ต๋ณ€์€ ์ตœ๋Œ€ 8 turn, JSON ๊ธฐ์ค€ 12 KiB์˜ ๋น„์‹ ๋ขฐ context๋กœ ์ด์–ด์ง„๋‹ค. ํ˜„์žฌ ์š”์ฒญ์€ ์œ ์ง€ํ•˜๊ณ  ํ•œ๋„์— ๋งž์ง€ ์•Š๋Š” ์˜ค๋ž˜๋œ ๋ฌธ๋งฅ๋ถ€ํ„ฐ ์ƒ๋žตํ•œ๋‹ค. ๋ณ„๋„ ์žฅ๊ธฐ transcript๋Š” ์ €์žฅํ•˜์ง€ ์•Š์ง€๋งŒ ๋‹ค์Œ Run์— ์ „๋‹ฌํ•œ ๋ฌธ๋งฅ์€ ๊ทธ Run์˜ goal์— ํฌํ•จ๋œ๋‹ค. /clear๋Š” ๋ฌธ๋งฅ๊ณผ active/last pointer๋งŒ ์ œ๊ฑฐํ•˜๋ฉฐ SQLite Run์„ ์‚ญ์ œํ•˜์ง€ ์•Š๋Š”๋‹ค.

๊ฐ™์€ ์„ธ์…˜์—์„œ๋Š” /resume์œผ๋กœ ํ˜„์žฌ/๋งˆ์ง€๋ง‰ Run์„ ์žฌ๊ฐœํ•œ๋‹ค. ๋‹ค๋ฅธ process์—์„œ ์žฌ๊ฐœํ•˜๋ ค๋ฉด /status์˜ Run ID๋ฅผ ๊ธฐ๋กํ•œ๋‹ค. --debug ๋˜๋Š” pipe ๋ชจ๋“œ์—์„œ๋Š” stderr์˜ XGEN_STARTED run_id=...๋„ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๋‹ค.

xgen> /resume run-0123456789abcdef0123456789abcdef

์ž‘์—… ์™„๋ฃŒ์™€ ๋Œ€ํ™” ์‘๋‹ต์„ ์ €์žฅํ•œ Run์€ model, workspace ๋˜๋Š” tool effect ์—†์ด summary๋ฅผ offline replayํ•œ๋‹ค. Approval ๋Œ€๊ธฐ Run์€ ๋™์ผํ•œ physical workspace์™€ ์ž๋™ catalog snapshot์ด ํ•„์š”ํ•˜๋‹ค. ๋„๊ตฌ binary, PATH ๋˜๋Š” safe environment๊ฐ€ ๋ฐ”๋€Œ์–ด execution profile์ด ๋‹ฌ๋ผ์ง€๋ฉด configuration mismatch๋กœ fail-closedํ•  ์ˆ˜ ์žˆ๋‹ค.

Progress์™€ Ctrl+C

์ผ๋ฐ˜ TTY ํ™”๋ฉด์€ ์š”์ฒญ ์ฒ˜๋ฆฌ ์ค‘ Thinkingโ€ฆ๊ณผ ๊ฒฝ๊ณผ ์‹œ๊ฐ„์„ ํ‘œ์‹œํ•œ๋‹ค. ์ด ํ‘œ์‹œ๋Š” model ํ˜ธ์ถœ๋ฟ ์•„๋‹ˆ๋ผ ๋„๊ตฌ ์‹คํ–‰๊ณผ ๊ฒฐ๊ณผ ๊ฒ€์ฆ ์‹œ๊ฐ„์„ ํฌํ•จํ•˜๋ฉฐ, model์˜ ๋‚ด๋ถ€ reasoning text๋ฅผ ๋œปํ•˜์ง€ ์•Š๋Š”๋‹ค. ์Šน์ธ ์ž…๋ ฅ์ด๋‚˜ ๊ฒฐ๊ณผ ์ถœ๋ ฅ ์ „์— ํ‘œ์‹œ๋ฅผ ์ง€์šด๋‹ค. ์ตœ์ข… summary๋งŒ durable completion ๊ฒ€์ฆ ๋’ค control character๋ฅผ escapeํ•ด ์ถœ๋ ฅํ•˜๋ฉฐ, Run ID๋Š” /status์—์„œ ํ™•์ธํ•  ์ˆ˜ ์žˆ๋‹ค. ์ด ๊ฒ€์ฆ์€ Receipt์™€ ๊ฒฐ๊ณผ ์ €์žฅ์˜ ๊ฒฐํ•ฉยท๋ฌด๊ฒฐ์„ฑ์„ ํ™•์ธํ•˜๋ฉฐ, summary์˜ ๋ชจ๋“  ์ž์—ฐ์–ด ์„ค๋ช…์ด ์‹ค์ œ ๋ณ€๊ฒฝ๊ณผ ์ผ์น˜ํ•จ์„ ๋ณด์žฅํ•˜์ง€ ์•Š๋Š”๋‹ค.

# ๊ธฐ์กด durable progress์™€ Run ID ๋กœ๊ทธ ํ™•์ธ
xgen --debug

--debug์™€ pipe ์ž…๋ ฅ์—์„œ๋Š” ๊ธฐ์กด progress: event ๋ฐ XGEN_STARTED ๊ณ„์•ฝ์„ ์œ ์ง€ํ•˜๊ณ  ANSI animation์„ ์ถœ๋ ฅํ•˜์ง€ ์•Š๋Š”๋‹ค. Progress๋Š” runtime์˜ redacted lifecycle event์ด๋ฉฐ strict JSON proposal์€ ํ‘œ์‹œํ•˜์ง€ ์•Š๋Š”๋‹ค.

--debug๋Š” run๊ณผ resume์—๋„ ๊ฐ™์€ progress: event๋ฅผ ๊ฐ™์€ formatter๋กœ ๋‚ด๋ณด๋‚ธ๋‹ค. ์ „๋ถ€ stderr์˜ ๊ธฐ์กด XGEN_* ๊ฒฐ๊ณผ ์ค„ ์˜†์— ์“ฐ๋ฏ€๋กœ stdout์€ ์ตœ์ข… ์‘๋‹ต๋งŒ ๋‹ด๋Š”๋‹ค. ํ”Œ๋ž˜๊ทธ๋ฅผ ์ฃผ์ง€ ์•Š์œผ๋ฉด ์•„๋ฌด event๋„ ๋‚ด๋ณด๋‚ด์ง€ ์•Š์•„์„œ, ๊ฒฐ๊ณผ ์ค„๋งŒ ํŒŒ์‹ฑํ•˜๋Š” host๋Š” ๋ฌป์ง€ ์•Š์€ prefix๋ฅผ ๋ฐ›์ง€ ์•Š๋Š”๋‹ค. ์ง„ํ–‰ ํ‘œ์‹œ ์“ฐ๊ธฐ๊ฐ€ ์‹คํŒจํ•ด๋„ Run์€ ๊ณ„์†ํ•œ๋‹ค. ์ง„๋‹จ ํ•œ ์ค„์„ ์žƒ์€ ๊ฒƒ์ด ์ด๋ฏธ ์ง„ํ–‰ ์ค‘์ธ durable ์ž‘์—…์„ ๋ฒ„๋ฆด ์ด์œ ๋Š” ์•„๋‹ˆ๊ณ , run์˜ ์ค‘๋‹จ์€ process-level signal handler๊ฐ€ ์†Œ์œ ํ•œ๋‹ค.

Ctrl+C๋Š” ๋‹ค์Œ ์•ˆ์ „ํ•œ durable ๊ฒฝ๊ณ„์—์„œ ๋ฉˆ์ถ˜๋‹ค. Model request๋‚˜ process outcome์ด ์ด๋ฏธ ๋ถˆํ™•์ •ํ•ด์กŒ์œผ๋ฉด user_cancelled๋ณด๋‹ค model_call_unknown/effect_outcome_unknown์ด ์šฐ์„ ํ•˜๊ณ  ์ž๋™ ์žฌ์‹คํ–‰ํ•˜์ง€ ์•Š๋Š”๋‹ค. Network/process call์ด ์ง„ํ–‰ ์ค‘์ด๋ฉด configured timeout๊นŒ์ง€ ๊ธฐ๋‹ค๋ฆด ์ˆ˜ ์žˆ๋‹ค.

๊ธด ๊ฒฐ๊ณผ ๋ณด๊ธฐ

์ผ๋ฐ˜ TUI๋Š” ์™„๋ฃŒ๋œ ๋‹ต๋ณ€๊ณผ Changes๋ฅผ ๊ฒฐ๊ณผ ๋ธ”๋ก์œผ๋กœ ๋ณด๊ด€ํ•œ๋‹ค. ๋ฐ›์€ ์‹œ์ ์˜ ์ฐฝ ํญ์œผ๋กœ 12ํ–‰์„ ๋„˜์œผ๋ฉด ์•ž 4ํ–‰๊ณผ ๋’ค 2ํ–‰๋งŒ ํ‘œ์‹œํ•˜๊ณ  Ctrl+O ์•ˆ๋‚ด๋ฅผ ๋„ฃ๋Š”๋‹ค. ํ•œ ์ค„์งœ๋ฆฌ ๊ธด ๋ฌธ๋‹จ๋„ ํ‘œ์‹œ ํญ์„ ๊ธฐ์ค€์œผ๋กœ ์ ‘๋Š”๋‹ค.

  • Ctrl+O: ์ตœ๊ทผ ๊ฒฐ๊ณผ ์ „์ฒด ๋ณด๊ธฐ. ๋ฐฉํ–ฅํ‚ค ์œ„ยท์•„๋ž˜, PgUpยทPgDnยทSpace, HomeยทEnd๋กœ ์ด๋™ํ•œ๋‹ค.
  • ๋ฐฉํ–ฅํ‚ค ์ขŒยท์šฐ: ๋ณด๊ด€๋œ ๋‹ค๋ฅธ ๋‹ต๋ณ€ยท๋ณ€๊ฒฝ ๋‚ด์—ญ์œผ๋กœ ์ด๋™ํ•œ๋‹ค.
  • Esc, q, Ctrl+O, Ctrl+C, Ctrl+D: ์ „์ฒด ๋ณด๊ธฐ๋ฅผ ๋‹ซ๊ณ  ์ž…๋ ฅ์ฐฝ์œผ๋กœ ๋Œ์•„๊ฐ„๋‹ค. ์ „์ฒด ๋ณด๊ธฐ์—์„œ Ctrl+C๋Š” Run์„ ์ทจ์†Œํ•˜์ง€ ์•Š๋Š”๋‹ค. ๋Œ์•„์˜จ ๋’ค Ctrl+C๋ฅผ ๋ˆ„๋ฅด๋ฉด ๊ธฐ์กด ์ทจ์†Œ ๋™์ž‘์„ ํ•œ๋‹ค.

์ „์ฒด ๋ณด๊ธฐ๋Š” ์ฝ๊ธฐ ์ „์šฉ์ด๋‹ค. Enter๋‚˜ ๋ถ™์—ฌ๋„ฃ๊ธฐ๋กœ ๋ชฉํ‘œ๋ฅผ ๋ณด๋‚ด๊ฑฐ๋‚˜ ์Šน์ธํ•˜์ง€ ์•Š๋Š”๋‹ค. ์—ด๊ธฐ ์ „์˜ ์ž…๋ ฅ๊ณผ ๋Œ€๊ธฐ์—ด์„ ์œ ์ง€ํ•˜๊ณ , Run์ด ๊ณ„์† ์ง„ํ–‰๋ผ ์Šน์ธ์ด๋‚˜ ์ƒˆ ๊ฒฐ๊ณผ๊ฐ€ ๋„์ฐฉํ•˜๋ฉด ์•„๋ž˜์ชฝ์— ์•ˆ๋‚ดํ•œ๋‹ค. Esc๋กœ ๋Œ์•„์˜ค๋ฉด ์Šน์ธ prompt์™€ ์ƒˆ ์ถœ๋ ฅ์ด ๋‚˜ํƒ€๋‚œ๋‹ค. ์ „์ฒด ๋ณด๊ธฐ์—๋งŒ ์ž„์‹œ alternate screen์„ ์‚ฌ์šฉํ•˜๊ณ , ๋‹ซ์œผ๋ฉด ๊ธฐ์กด terminal scrollback์œผ๋กœ ๋Œ์•„์˜จ๋‹ค.

TUI ๋ณ€๊ฒฝ ๋‚ด์—ญ์€ ํŒŒ์ผ๋‹น 12์ค„ยท์ „์ฒด 40์ค„๋กœ ์ž˜๋ฆฐ ๋ฏธ๋ฆฌ๋ณด๊ธฐ ๋Œ€์‹  ์ „์ฒด rendered ๋‚ด์šฉ์„ ๋ณด๊ด€ํ•˜๋ฏ€๋กœ, ์ „์ฒด ๋ณด๊ธฐ์—์„œ ๊ทธ ๋’ค์˜ editยท์ƒˆ ํŒŒ์ผยท๊ต์ฒด ํŒŒ์ผ ๋‚ด์šฉ๊ณผ ์‹คํ–‰ ๋ช…๋ น ์ธ์ž๋„ ์ฝ์„ ์ˆ˜ ์žˆ๋‹ค. ์›๋ฌธ์€ ํ™”๋ฉด ์ถœ๋ ฅ์šฉ escape๋ฅผ ๊ฑฐ์นœ ๋‚ด์šฉ์ด๋‹ค.

์บ์‹œ๋Š” ์ตœ๊ทผ 20๊ฐœ ๊ฒฐ๊ณผ ๋ธ”๋ก, ์›๋ฌธยทํ–‰ ๋ฐฐ์—ด ํ•ฉ๊ณ„ 8 MiB๊นŒ์ง€๋‹ค. ์˜ค๋ž˜๋œ ํ•ญ๋ชฉ์€ ์ „์ฒด ๋ณด๊ธฐ ๋ชฉ๋ก์—์„œ ๋น ์ง€์ง€๋งŒ durable Run ๊ธฐ๋ก์€ ์‚ญ์ œํ•˜์ง€ ์•Š๋Š”๋‹ค. ํ•œ ๋ธ”๋ก์ด ํ•œ๋„๋ณด๋‹ค ํฌ๋ฉด ์ ‘์ง€ ์•Š๊ณ  ์ „์ฒด๋ฅผ ์ถœ๋ ฅํ•œ๋‹ค. ์ „์ฒด ๋ณด๊ธฐ ์ค‘ ๋ณด๋ฅ˜ํ•  ์ƒˆ ์ถœ๋ ฅ์ด 8 MiB๋ฅผ ๋„˜์œผ๋ฉด ์ „์ฒด ๋ณด๊ธฐ๋ฅผ ๋‹ซ๊ณ  ์ถœ๋ ฅํ•ด ๋‚ด์šฉ์„ ์žƒ์ง€ ์•Š๋Š”๋‹ค.

--debug, pipe ์ž…๋ ฅ, headless runยทresume์€ ์ ‘์ง€ ์•Š๋Š”๋‹ค. ํ‚ค์™€ ๊ฒฝ๊ณ„๋Š” ADR-0078์„ ๋”ฐ๋ฅธ๋‹ค.

Headless

Pipe ์ž…๋ ฅ์—์„œ๋Š” first-run hidden prompt๋ฅผ ์ž๋™์œผ๋กœ ์—ด์ง€ ์•Š๋Š”๋‹ค. Profile์ด๋‚˜ ํ™˜๊ฒฝ๋ณ€์ˆ˜๋ฅผ ๋จผ์ € ๊ณต๊ธ‰ํ•˜๋ฉด ๊ฒฐ์ •์  smoke script๋ฅผ ์‹คํ–‰ํ•  ์ˆ˜ ์žˆ๋‹ค. Secret์€ script text๋‚˜ argv์— ๋„ฃ์ง€ ์•Š๋Š”๋‹ค.

printf '/status\n/exit\n' | xgen

์‹ค์ œ goal์„ pipe๋กœ ์‹คํ–‰ํ•  ๋•Œ ์›๊ฒฉ HTTPS credential์€ XGEN_OPENAI_API_KEY ๊ฐ™์€ ์™ธ๋ถ€ secret injection์„ ์‚ฌ์šฉํ•œ๋‹ค. ์ผ๋ฐ˜ ์ž๋™ํ™”๋Š” exit code์™€ ๊ณ ์ • stderr ๊ณ„์•ฝ์ด ๋” ๋‹จ์ˆœํ•œ ๊ธฐ์กด xgen run/resume์„ ๊ถŒ์žฅํ•œ๋‹ค.

๋Œ€ํ™” ์‘๋‹ต์˜ ์ €์žฅยท๊ฒ€์ฆ ๊ณ„์•ฝ์€ ADR-0047์„ ๋”ฐ๋ฅธ๋‹ค.

์ƒํƒœ ํด๋” ๊ถŒํ•œ ์˜ค๋ฅ˜

Unix์—์„œ error: state_directory_permissions๊ฐ€ ๋‚˜์˜ค๋ฉด ํ•จ๊ป˜ ํ‘œ์‹œ๋œ state_directory์™€ permissions๋ฅผ ํ™•์ธํ•œ๋‹ค. ํ•ด๋‹น ํด๋”์˜ group/other ์ ‘๊ทผ์„ ์ œ๊ฑฐํ•ด์•ผ ํ•œ๋‹ค. ํ™•์ธํ•œ ๊ฒฝ๋กœ์— chmod go-rwx -- PATH๋ฅผ ์ง์ ‘ ์‹คํ–‰ํ•˜๋ฉด ์†Œ์œ ์ž ๊ถŒํ•œ์€ ์œ ์ง€๋œ๋‹ค. ํ”„๋กœ๊ทธ๋žจ์€ ๊ถŒํ•œ์„ ์ž๋™ ๋ณ€๊ฒฝํ•˜๊ฑฐ๋‚˜ ์žฌ๊ท€์ ์œผ๋กœ ๊ณ ์น˜์ง€ ์•Š๋Š”๋‹ค. ๊ฒฝ๋กœ๋Š” ์ œ์–ด ๋ฌธ์ž๋ฅผ escapeํ•œ ์ธ์šฉ ํ‘œ๊ธฐ๋‹ค.

headless runยทresumeยทusageยทrecover๋Š” ๊ฐ™์€ code์™€ ์ง„๋‹จ์„ stderr์— ๋‚ด๋ณด๋‚ด๊ณ  exit 64๋กœ ๋๋‚œ๋‹ค. symlink๋‚˜ ์ผ๋ฐ˜ I/O ์‹คํŒจ์—๋Š” ์ด ๋ณต๊ตฌ ์•ˆ๋‚ด๋ฅผ ๋ถ™์ด์ง€ ์•Š๋Š”๋‹ค. ์ž์„ธํ•œ ๋ฒ”์œ„๋Š” ADR-0080์„ ๋”ฐ๋ฅธ๋‹ค.