tfx-persist

tfx-persist (DEPRECATED → tfx-auto alias)

DEPRECATED. /tfx-auto --retry ralph 로 리다이렉트. Phase 3 부터 true ralph state machine — hub/team/retry-state-machine.mjs.

동작

canonical 위임 이전 에 아래 bash 블록을 한 번 실행한다. Phase 5 (v11) 물리 삭제 게이트는 .omc/state/alias-usage.log 의 7일 zero-usage 검증에 의존 — 이 logging 이 빠지면 게이트가 영영 열리지 않는다.

mkdir -p .omc/state
echo "[deprecated] tfx-persist -> use: tfx-auto --retry ralph" >&2
echo "[DEPRECATED] tfx-persist — see tfx-auto --retry ralph"
echo "$(date -u +%Y-%m-%dT%H:%M:%SZ) tfx-persist -> tfx-auto --retry ralph" >> .omc/state/alias-usage.log

1. 위 bash 블록 실행 (stderr 경고 + stdout [DEPRECATED] 마커 + alias-usage.log append).
2. ARGUMENTS 전체 앞에 --retry ralph 를 prepend 하여 Skill("tfx-auto") 호출.
3. 스킬 경유 시 기본 --max-iterations 0 (unlimited) 로 진입. CLI 직접 호출 시 bounded 1 로 진입 (임시 합의안, Phase 3 Open question #2).

등가 플래그

--retry ralph (Phase 3)

deep mode 이 필요한 경우에만 --mode deep --retry ralph. 기존 --mode deep 강제는 제거 — ralph 의미는 plan/PRD 오버헤드와 독립.

이 alias 의 의미

tfx-persist 는 "끝까지, 멈추지 마" (ralph) 의미. Phase 2 까지는 bounded verify/fix 3회 루프로 degrade 되었으나, Phase 3 에서 true state machine 도입으로 의미 회복.

Phase 3 상태 전이:

PLANNING → EXECUTING → (VERIFY.fail) → DIAGNOSING → EXECUTING …
                    → (VERIFY.success) → DONE
                    → stuckCounter ≥ 3 → STUCK (동일 failureReason 3회 연속 시 중단)
                    → iterations ≥ max → BUDGET_EXCEEDED (max_iterations 0 이면 비활성)

상태는 .omc/state/ralph-<sessionId>.json 에 jsonl append 로 저장 — compaction survive. resumeFromStateFile() 로 재개 가능.

마이그레이션 가이드

기존 호출	새 호출
/tfx-persist "작업"	/tfx-auto "작업" --retry ralph
/tfx-persist "작업" --max 10	/tfx-auto "작업" --retry ralph --max-iterations 10