trinity-agent 0.7.0__tar.gz → 0.7.2__tar.gz

{trinity_agent-0.7.0 → trinity_agent-0.7.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: trinity-agent
-Version: 0.7.0
+Version: 0.7.2
 Summary: Three minds, one context — Multi-agent AI orchestrator for Claude Code, Codex, and Gemini CLI.
 Project-URL: Homepage, https://github.com/hongdangmoo49/Trinity
 Project-URL: Repository, https://github.com/hongdangmoo49/Trinity
@@ -85,6 +85,9 @@ trinity init
 
 # 비대화형 실행 (기본 설정값 적용)
 trinity init --non-interactive
+
+# 격리된 provider-state에서 각 CLI의 auth/theme/trust 초기 설정을 완료합니다
+trinity bootstrap
 ```
 
 ### 첫 번째 토론(Deliberation) 실행
@@ -147,7 +150,7 @@ Trinity가 백그라운드에서 다음 단계를 자동으로 수행합니다:
 Trinity는 **Rich 라이브러리 기반의 미려한 터미널 UI(TUI)**를 제공하여, 에이전트 간의 실시간 토론 과정을 시각적으로 보여줍니다.
 
 ```
-  🧠 Trinity v0.7.0  —  세 개의 두뇌, 하나의 컨텍스트
+  🧠 Trinity v0.7.2  —  세 개의 두뇌, 하나의 컨텍스트
 
   🏗️ claude ✅    ⚙️ codex ✅    🔍 gemini ✅
 
@@ -202,6 +205,7 @@ Trinity는 **Rich 라이브러리 기반의 미려한 터미널 UI(TUI)**를 제
 | `trinity` | 대화형 TUI 세션 실행 |
 | `trinity init` | 현재 디렉토리에 Trinity 작업 공간(`.trinity/`) 초기화 |
 | `trinity init --non-interactive` | 사용자 입력 요청 없이 기본값으로 즉시 초기화 |
+| `trinity bootstrap` | 격리된 에이전트별 provider-state에서 CLI 초기 설정/auth/trust 진행 |
 | `trinity ask "질문"` | 입력한 프롬프트에 대해 즉시 단발성(One-shot) 토론 실행 |
 | `trinity status` | 현재 에이전트들의 활성화 및 연결 상태를 표 형태로 표시 |
 | `trinity status-watch` | 실시간으로 상태가 갱신되는 상태 모니터 대시보드 실행 |
@@ -224,9 +228,13 @@ Trinity는 **Rich 라이브러리 기반의 미려한 터미널 UI(TUI)**를 제
 | `/agent <이름> on\|off` | 특정 에이전트를 즉시 활성화하거나 비활성화 |
 | `/history` | 이전 라운드의 토론 히스토리 요약 조회 |
 | `/save` | 현재 토론 세션의 전체 결과를 파일로 영구 저장 |
+| `/resume [N\|latest\|ID]` | 저장된 workflow 세션을 선택해 재개 |
 | `/help` | 사용 가능한 인라인 명령어 도움말 표시 |
 | `/quit` | Trinity 종료 및 백그라운드 리소스 정리 |
 
+TUI는 기본적으로 새 workflow 세션으로 시작한다. 이전 active workflow는
+`.trinity/workflow/history/`에 보존되며 `/resume`으로 명시적으로 재개한다.
+
 ---
 
 ## ⚙️ 설정
@@ -404,8 +412,8 @@ uv publish --token <PYPI_TOKEN>
 
 | 지표 | 수치 |
 | :--- | :--- |
-| **버전** | 0.7.0 |
-| **테스트** | 882개 테스트 통과 |
+| **버전** | 0.7.2 |
+| **테스트** | 915개 테스트 통과 |
 | **커버리지** | 약 87% |
 | **소스 파일** | 50여 개 |
 | **주요 의존성 라이브러리** | `click`, `rich`, `prompt_toolkit`, `tomli` |

{trinity_agent-0.7.0 → trinity_agent-0.7.2}/README.en.md

@@ -59,6 +59,9 @@ trinity init
 
 # Non-interactive (uses defaults)
 trinity init --non-interactive
+
+# Complete CLI auth/theme/trust setup inside isolated provider-state homes
+trinity bootstrap
 ```
 
 ### Run Your First Deliberation
@@ -121,7 +124,7 @@ That's it. Trinity will:
 Trinity features a **Rich-based terminal UI** with real-time deliberation visualization.
 
 ```
-  🧠 Trinity v0.7.0  —  Three minds, one context
+  🧠 Trinity v0.7.2  —  Three minds, one context
 
   🏗️ claude ✅    ⚙️ codex ✅    🔍 gemini ✅
 
@@ -176,6 +179,7 @@ Trinity features a **Rich-based terminal UI** with real-time deliberation visual
 | `trinity` | Launch interactive TUI session |
 | `trinity init` | Initialize `.trinity/` in current directory |
 | `trinity init --non-interactive` | Initialize with defaults (no prompts) |
+| `trinity bootstrap` | Run provider first-use auth/trust setup in isolated provider-state homes |
 | `trinity ask "question"` | One-shot deliberation on a prompt |
 | `trinity status` | Show agent status table |
 | `trinity status-watch` | Live-updating status dashboard |
@@ -198,9 +202,14 @@ Inside the interactive TUI (`trinity` with no args):
 | `/agent <name> on\|off` | Enable/disable an agent |
 | `/history` | Show deliberation history |
 | `/save` | Save session results to file |
+| `/resume [N\|latest\|ID]` | Select and resume a saved workflow session |
 | `/help` | Show help |
 | `/quit` | Exit Trinity |
 
+The TUI starts with a new workflow session by default. The previous active
+workflow is preserved in `.trinity/workflow/history/` and can be resumed
+explicitly with `/resume`.
+
 ---
 
 ## ⚙️ Configuration
@@ -378,8 +387,8 @@ uv publish --token <PYPI_TOKEN>
 
 | Metric | Value |
 | :--- | :--- |
-| **Version** | 0.7.0 |
-| **Tests** | 882 passed |
+| **Version** | 0.7.2 |
+| **Tests** | 915 passed |
 | **Coverage** | ~87% |
 | **Source files** | 50+ |
 | **Dependencies** | `click`, `rich`, `prompt_toolkit`, `tomli` |

{trinity_agent-0.7.0 → trinity_agent-0.7.2}/README.md

@@ -57,6 +57,9 @@ trinity init
 
 # 비대화형 실행 (기본 설정값 적용)
 trinity init --non-interactive
+
+# 격리된 provider-state에서 각 CLI의 auth/theme/trust 초기 설정을 완료합니다
+trinity bootstrap
 ```
 
 ### 첫 번째 토론(Deliberation) 실행
@@ -119,7 +122,7 @@ Trinity가 백그라운드에서 다음 단계를 자동으로 수행합니다:
 Trinity는 **Rich 라이브러리 기반의 미려한 터미널 UI(TUI)**를 제공하여, 에이전트 간의 실시간 토론 과정을 시각적으로 보여줍니다.
 
 ```
-  🧠 Trinity v0.7.0  —  세 개의 두뇌, 하나의 컨텍스트
+  🧠 Trinity v0.7.2  —  세 개의 두뇌, 하나의 컨텍스트
 
   🏗️ claude ✅    ⚙️ codex ✅    🔍 gemini ✅
 
@@ -174,6 +177,7 @@ Trinity는 **Rich 라이브러리 기반의 미려한 터미널 UI(TUI)**를 제
 | `trinity` | 대화형 TUI 세션 실행 |
 | `trinity init` | 현재 디렉토리에 Trinity 작업 공간(`.trinity/`) 초기화 |
 | `trinity init --non-interactive` | 사용자 입력 요청 없이 기본값으로 즉시 초기화 |
+| `trinity bootstrap` | 격리된 에이전트별 provider-state에서 CLI 초기 설정/auth/trust 진행 |
 | `trinity ask "질문"` | 입력한 프롬프트에 대해 즉시 단발성(One-shot) 토론 실행 |
 | `trinity status` | 현재 에이전트들의 활성화 및 연결 상태를 표 형태로 표시 |
 | `trinity status-watch` | 실시간으로 상태가 갱신되는 상태 모니터 대시보드 실행 |
@@ -196,9 +200,13 @@ Trinity는 **Rich 라이브러리 기반의 미려한 터미널 UI(TUI)**를 제
 | `/agent <이름> on\|off` | 특정 에이전트를 즉시 활성화하거나 비활성화 |
 | `/history` | 이전 라운드의 토론 히스토리 요약 조회 |
 | `/save` | 현재 토론 세션의 전체 결과를 파일로 영구 저장 |
+| `/resume [N\|latest\|ID]` | 저장된 workflow 세션을 선택해 재개 |
 | `/help` | 사용 가능한 인라인 명령어 도움말 표시 |
 | `/quit` | Trinity 종료 및 백그라운드 리소스 정리 |
 
+TUI는 기본적으로 새 workflow 세션으로 시작한다. 이전 active workflow는
+`.trinity/workflow/history/`에 보존되며 `/resume`으로 명시적으로 재개한다.
+
 ---
 
 ## ⚙️ 설정
@@ -376,8 +384,8 @@ uv publish --token <PYPI_TOKEN>
 
 | 지표 | 수치 |
 | :--- | :--- |
-| **버전** | 0.7.0 |
-| **테스트** | 882개 테스트 통과 |
+| **버전** | 0.7.2 |
+| **테스트** | 915개 테스트 통과 |
 | **커버리지** | 약 87% |
 | **소스 파일** | 50여 개 |
 | **주요 의존성 라이브러리** | `click`, `rich`, `prompt_toolkit`, `tomli` |

{trinity_agent-0.7.0 → trinity_agent-0.7.2}/docs/checkpoint.md

@@ -21,21 +21,43 @@
 - Execution protocol MVP, dependency-level 병렬 dispatch, `Task Results` 기록
 - Subagent delegation reporting과 `Subtasks` 기록
 - Shared ledger renderer, LifecycleGuard MVP, peer review planning foundation
+- 명시적 `/answer` user decision UX, `/questions --select` 방향키 옵션 선택
+- `/questions --select --all` decision wizard
+- 한국어/번호형 open question parser 보강
 
 ### 운영 문서
 
 - [v0.7.0 Workflow Guide](workflow-v0.7.0-guide.md)
+- [v0.7.0 후속 구현 후보](plans/2026-06-04-v0.7.0-follow-up-implementation-candidates.md)
 - [Provider Readiness Troubleshooting](troubleshooting-provider-readiness.md)
 - [v0.7.0 Workflow Engine 테스트 결과](test-results/v0.7.0-workflow-engine.md)
 - [v0.7.0 WSL/tmux Smoke Test Checklist](test-results/v070-smoke-checklist.md)
 
 ### 검증 기준선
 
-- 패키지/CLI 버전: `0.7.0`
-- `uv run pytest -q` → 882 passed, 1 warning
+- 패키지/CLI 버전: `0.7.2`
+- `uv run pytest -q` → 915 passed, 1 warning
 - 변경 파일 대상 ruff check 통과
 - 실제 WSL/tmux/provider smoke는 릴리스 전 별도 수행 필요
 
+### Post-merge smoke follow-ups
+
+- [x] `needs_user_decision` 상태의 일반 텍스트 FIFO 자동 기록을 제거했다.
+  사용자는 `/answer <question-id|index|next> <answer>`로 대상 질문을 명시한다.
+- [x] `/questions`를 실행 가능한 답변 안내 panel로 바꾸고, `/questions --select`로
+  첫 pending question의 options를 방향키로 선택할 수 있게 했다.
+- [x] `/questions --select --all`은 pending question을 순서대로 처리하며,
+  options가 없는 질문은 자유 텍스트 답변을 받는다.
+- [x] 잘못 기록한 decision은 `/answer --replace <question-id|decision-id> <answer>`로 정정한다.
+- [x] 한국어 `질문/옵션/추천/이유` 필드와 빈 `Options:` 뒤 번호형 선택지를
+  structured open question parser가 options/recommended/rationale로 보존한다.
+- [x] WSL/tmux smoke 중 Codex pane의 과거 `model: loading` scrollback이 현재 ready prompt보다
+  먼저 판정되어 continuation deliberation을 차단하는 false positive가 확인됐다.
+  readiness 판정은 현재 prompt readiness를 stale loading/auth/banner scrollback보다 우선하도록 수정했다.
+- [x] 후속 구현 후보를 별도 문서로 정리했다.
+  우선순위는 실제 WSL/tmux smoke, peer review execution, lifecycle rotation 보강,
+  non-blocking question 정책, workflow repair/reset UX 순서다.
+
 ---
 
 ## Phase 1: 최소 작동 프로토타입 — ✅ 완료

trinity_agent-0.7.2/docs/plans/2026-06-04-isolated-provider-bootstrap.md

@@ -0,0 +1,60 @@
+# Isolated Provider Bootstrap Plan
+
+## Goal
+
+Keep Trinity's per-agent provider-state isolation, but add an explicit bootstrap
+flow so Claude, Codex, and Gemini can complete their first-run setup,
+authentication, and workspace trust prompts inside the same isolated homes that
+normal Trinity sessions use.
+
+## Problem
+
+Trinity launches each provider with a managed home:
+
+- `.trinity/agents/claude/provider-state`
+- `.trinity/agents/codex/provider-state`
+- `.trinity/agents/gemini/provider-state`
+
+This is correct for isolation, but it means provider CLIs do not see the user's
+normal WSL home configuration. A provider that is already authenticated in
+`/home/user` can still show first-run setup or auth prompts when launched by
+Trinity.
+
+## Implementation Plan
+
+1. Add a `trinity bootstrap` command that:
+   - loads the project config;
+   - prepares the same per-agent managed homes and launch directories used by
+     regular Trinity sessions;
+   - opens a tmux bootstrap session;
+   - launches each selected provider CLI with the isolated `HOME` and `XDG_*`
+     environment variables;
+   - optionally attaches to the session so the user can complete auth/setup.
+
+2. Keep isolation as the default and only supported behavior for this flow.
+   - Do not copy credentials from the user's real home.
+   - Do not symlink provider configs into `.trinity`.
+   - Do not disable `HOME`/`XDG_*` overrides.
+
+3. Improve readiness guidance so auth/trust failures point users to
+   `trinity bootstrap` instead of generic provider commands that would use the
+   wrong home directory.
+
+4. Add focused tests for:
+   - bootstrap target selection;
+   - isolated env command construction;
+   - CLI command behavior without launching real provider CLIs or tmux;
+   - readiness action hints.
+
+5. Document the completed behavior in a result note after implementation and
+   verification.
+
+## Acceptance Criteria
+
+- `trinity bootstrap` starts a separate tmux session for provider first-run
+  setup using isolated provider-state directories.
+- Running normal Trinity after bootstrap reuses the initialized provider-state.
+- The command supports agent filtering and disabled-agent inclusion for manual
+  preparation.
+- Existing print/interactive deliberation paths continue using isolated homes.
+- Unit tests pass for the changed areas.

trinity_agent-0.7.2/docs/plans/2026-06-04-v0.7.0-follow-up-implementation-candidates.md

@@ -0,0 +1,252 @@
+# Trinity v0.7.0 후속 구현 후보
+
+작성일: 2026-06-04  
+대상 브랜치: `codex/v070-workflow-followups`  
+상태: 후속 구현 후보 정리
+
+## 1. 현재 기준선
+
+v0.7.0 workflow engine의 주요 구조는 구현되어 있다.
+
+- Provider readiness/auth gating
+- Interactive response contract와 response artifact 저장
+- Workflow state machine과 user decision loop
+- Structured deliberation/blueprint consensus
+- Blueprint decomposition과 work package execution protocol MVP
+- Shared ledger renderer, LifecycleGuard MVP, peer review planning foundation
+- 명시적 `/answer` UX, `/questions --select`, `/questions --select --all`
+- 한국어/번호형 open question parser 보강
+
+자동 검증 기준선:
+
+```text
+uv run pytest -q
+901 passed, 1 warning
+```
+
+남은 작업은 크게 두 종류다.
+
+1. **릴리스 전 검증 게이트**: 실제 WSL/tmux/provider 환경에서 지금 구현이 동작하는지 확인한다.
+2. **후속 구현 후보**: v0.7.0 이후 또는 v0.7.x에서 workflow 완성도를 높이는 기능이다.
+
+## 2. 릴리스 전 검증 게이트
+
+### G0. WSL/tmux/provider end-to-end smoke
+
+이 항목은 코드 구현보다 먼저 수행해야 하는 검증이다.
+
+#### 이유
+
+현재 자동 테스트는 unit/mock 중심이다. provider CLI의 실제 TUI repaint, tmux pane 폭, 인증/모델 로딩 화면,
+prompt echo 경계는 자동 테스트만으로 완전히 검증하기 어렵다.
+
+#### 실행 범위
+
+- Claude/Codex/Gemini가 모두 ready 상태인 세션
+- readiness strict mode에서 unready provider 차단
+- degraded mode에서 ready provider만으로 진행
+- 설계 요청에서 structured open question 생성
+- `/questions --select --all`로 decision wizard 처리
+- decision 이후 deliberation 재개
+- blueprint 생성
+- execution package dispatch와 `Task Results` 기록
+
+#### 산출물
+
+- `docs/test-results/v070-smoke-checklist.md` Pass/Fail 업데이트
+- 실패 시 pane capture 일부와 원인 분류 기록
+- 실패가 재현 가능하면 별도 follow-up issue/PR 후보로 분리
+
+#### 완료 기준
+
+- 최소 1회 실제 3-provider smoke가 blueprint 또는 명확한 readiness failure까지 도달한다.
+- `needs_user_decision` 상태에서 일반 텍스트가 자동 decision으로 오기록되지 않는다.
+- `/questions --select --all`이 options 질문과 자유 텍스트 질문을 모두 처리한다.
+
+## 3. 후속 구현 후보
+
+### F1. Peer review prompt execution loop
+
+#### 현재 상태
+
+`PeerReviewPlanner`는 execution result 이후 review package를 계획하고 persistence한다.
+하지만 실제 reviewer agent에게 review prompt를 보내고 결과를 workflow state에 반영하는 loop는 아직 없다.
+
+#### 목표
+
+`REVIEWING` 상태를 실제 agent review 단계로 확장한다.
+
+```text
+EXECUTING
+  -> REVIEWING
+  -> review package dispatch
+  -> review result collect
+  -> DONE | NEEDS_USER_DECISION | FAILED
+```
+
+#### 구현 후보
+
+- `ReviewExecutionProtocol` 또는 `ExecutionProtocol` 내 review dispatch 경로 추가
+- `ReviewResult` persistence와 shared ledger `## Reviews` 렌더링
+- TUI 명령 추가 후보:
+  - `/reviews`: planned/running/done review 표시
+  - `/review run`: pending review 실행
+- reviewer response contract:
+
+```text
+## Review Summary
+## Findings
+## Required Changes
+## Approval
+APPROVE | CHANGES_REQUIRED | BLOCKED
+```
+
+#### 테스트 후보
+
+- `tests/test_peer_review.py`: review result parsing/serialization
+- `tests/test_workflow_engine.py`: `REVIEWING -> DONE/NEEDS_USER_DECISION/FAILED`
+- `tests/test_tui_session.py`: `/reviews` 표시
+- `tests/test_execution_protocol.py`: review prompt dispatch mock
+
+#### 완료 기준
+
+- execution이 모두 `DONE`이면 review package가 실제 reviewer agent에게 전송된다.
+- 모든 review가 `APPROVE`이면 workflow가 `DONE`으로 이동한다.
+- `CHANGES_REQUIRED` 또는 `BLOCKED`이면 work package 상태와 user decision/open question으로 연결된다.
+
+### F2. Lifecycle rotation 실 workflow 통합 보강
+
+#### 현재 상태
+
+`LifecycleGuard`는 process/readiness/context ratio/projected ratio를 평가한다.
+문서상 hook은 deliberation/execution 전후까지 확장되어 있지만, 실제 provider 세션에서
+rotation이 모든 workflow 구간에서 안정적으로 이어지는지는 smoke가 필요하다.
+
+#### 목표
+
+context threshold 도달 시 workflow state를 잃지 않고 다음 prompt 전에 세션 요약과 새 provider session을 보장한다.
+
+#### 구현 후보
+
+- user decision 이후 deliberation continuation prompt 직전 guard 평가
+- review dispatch 전후 guard 평가
+- rotation 발생 시 `events.jsonl`에 `rotation_requested`, `rotation_completed` 기록
+- `shared.md ## Session History`에 rotation summary가 누락되지 않도록 검증
+- TUI `/status`에 projected prompt ratio와 rotation action hint 표시
+
+#### 테스트 후보
+
+- `tests/test_lifecycle_guard.py`: user decision/review hook coverage
+- `tests/test_workflow_engine.py`: rotation event persistence
+- `tests/test_tui_session.py`: rotation hint rendering
+- 실제 smoke: context threshold를 낮춘 config로 강제 rotation
+
+#### 완료 기준
+
+- threshold 초과 시 다음 provider call 전에 rotation이 수행된다.
+- rotation 이후 workflow id, decisions, open questions, work packages가 유지된다.
+- rotation summary가 shared ledger와 event log에 남는다.
+
+### F3. Non-blocking question 정책
+
+#### 현재 상태
+
+`OpenQuestion.blocking` 필드는 존재하지만, workflow는 open question이 있으면 대체로
+`NEEDS_USER_DECISION`으로 이동한다. non-blocking question을 표시만 하고 진행하는 정책은 아직 명확하지 않다.
+
+#### 목표
+
+blocking question과 non-blocking question을 분리한다.
+
+```text
+blocking open question 있음 -> NEEDS_USER_DECISION
+non-blocking open question만 있음 -> workflow 계속 진행, /questions에 표시
+```
+
+#### 구현 후보
+
+- `WorkflowSession.blocking_open_questions` property 추가
+- `WorkflowEngine._apply_structured_questions()`에서 blocking 여부에 따라 state transition 분기
+- `/questions`에 `blocking` column/badge 표시
+- `/questions --select --all`은 blocking 질문을 우선 처리
+- non-blocking question answer는 workflow continuation을 강제로 시작하지 않음
+
+#### 테스트 후보
+
+- `tests/test_workflow_engine.py`: non-blocking question만 있을 때 `BLUEPRINT_READY` 또는 `DELIBERATING` 유지
+- `tests/test_tui_session.py`: blocking/non-blocking 표시
+- `tests/test_shared_ledger.py`: question blocking flag 렌더링
+
+#### 완료 기준
+
+- non-blocking question만 남아도 workflow가 멈추지 않는다.
+- 사용자는 `/questions`에서 non-blocking question을 확인하고 선택적으로 답할 수 있다.
+- blocking question은 기존처럼 answer 전까지 continuation을 막는다.
+
+### F4. Workflow repair/reset UX
+
+#### 현재 상태
+
+`/answer --replace`로 잘못 기록한 decision을 정정할 수 있다.
+하지만 smoke 중 깨진 workflow session을 깨끗하게 되돌리거나 특정 decision을 제거하는 UX는 없다.
+
+#### 목표
+
+실사용 중 잘못 기록된 workflow state를 안전하게 복구한다.
+
+#### 구현 후보
+
+- `/workflow reset`: 현재 workflow session을 백업 후 idle로 초기화
+- `/undo dec-001`: decision 제거 또는 이전 값 복원
+- `/workflow export`: session/debug bundle 생성
+- reset 전 확인 prompt 또는 `--yes` 옵션
+- `.trinity/workflow/backups/`에 reset 전 session snapshot 저장
+
+#### 테스트 후보
+
+- `tests/test_workflow_engine.py`: decision undo와 state recompute
+- `tests/test_workflow_persistence.py`: reset backup persistence
+- `tests/test_tui_session.py`: command routing과 확인 메시지
+
+#### 완료 기준
+
+- 사용자가 잘못된 decision/session을 삭제하지 않고 백업 후 초기화할 수 있다.
+- reset/undo 후 `session.json`과 `events.jsonl`이 일관된다.
+- 일반 입력 오기록 같은 smoke 실패를 사용자가 수동 파일 삭제 없이 복구할 수 있다.
+
+## 4. 권장 순서
+
+1. **G0 WSL/tmux/provider smoke**
+   - 지금 구현의 실제 수용 여부를 먼저 확인한다.
+2. **F1 Peer review prompt execution loop**
+   - workflow의 `REVIEWING` 상태를 실제 완료 루프로 연결한다.
+3. **F2 Lifecycle rotation 실 workflow 통합 보강**
+   - 긴 workflow에서 session/context 안정성을 확보한다.
+4. **F3 Non-blocking question 정책**
+   - 질문 UX를 blocking/non-blocking으로 정교화한다.
+5. **F4 Workflow repair/reset UX**
+   - 실사용 복구성과 디버깅 편의성을 높인다.
+
+## 5. PR 분리 기준
+
+각 후보는 별도 PR로 분리하는 것이 좋다.
+
+| 후보 | 권장 PR 범위 | 이유 |
+|------|--------------|------|
+| G0 | 문서/결과 기록 또는 smoke failure fix | 검증 결과에 따라 코드 수정 범위가 달라짐 |
+| F1 | review protocol + tests + docs | workflow state transition에 영향이 큼 |
+| F2 | lifecycle hooks + rotation evidence | provider/session runtime 리스크가 큼 |
+| F3 | question state policy + TUI 표시 | decision UX와 state transition 변경 |
+| F4 | persistence repair commands | destructive/backup UX가 필요 |
+
+## 6. 비목표
+
+다음은 이 후보 문서의 직접 범위가 아니다.
+
+- 새 provider 추가
+- GUI/web dashboard
+- provider 내부 subagent 직접 제어
+- secrets/config 자동 마이그레이션
+- release/publish 절차
+
+위 항목은 필요하면 별도 계획 문서로 분리한다.

trinity_agent-0.7.2/docs/test-results/2026-06-04-isolated-provider-bootstrap.md

@@ -0,0 +1,62 @@
+# Isolated Provider Bootstrap Result
+
+## Branch
+
+- `codex/isolated-provider-bootstrap`
+
+## Summary
+
+Implemented an explicit isolated provider bootstrap flow while keeping Trinity's
+per-agent provider-state isolation intact.
+
+The new command is:
+
+```bash
+trinity bootstrap
+```
+
+It starts a separate tmux session, launches selected provider CLIs with the same
+isolated `HOME` and `XDG_*` environment variables used by normal Trinity
+sessions, and lets the user complete first-run setup, authentication, theme
+selection, and workspace trust prompts inside `.trinity/agents/<agent>/provider-state`.
+
+## Implemented
+
+- Added `src/trinity/providers/bootstrap.py`.
+- Added `trinity bootstrap` CLI command.
+- Added options:
+  - `--agents claude,codex`
+  - `--all`
+  - `--session-name <name>`
+  - `--force`
+  - `--no-attach`
+- Changed readiness action hints to direct users to `trinity bootstrap` instead
+  of running provider CLIs in the normal user home.
+- Documented the flow in README files and provider readiness troubleshooting.
+- Added tests for bootstrap target selection, command construction, tmux launch
+  orchestration, CLI behavior, and readiness hints.
+
+## Verification
+
+```bash
+uv run pytest tests/test_provider_bootstrap.py tests/test_provider_readiness.py tests/test_cli.py -q
+```
+
+Result:
+
+```text
+41 passed in 0.20s
+```
+
+```bash
+uv run pytest -q
+```
+
+Result:
+
+```text
+909 passed, 1 warning in 19.65s
+```
+
+The remaining warning is an existing AsyncMock resource warning in the test
+suite and is not introduced by this change.

{trinity_agent-0.7.0 → trinity_agent-0.7.2}/docs/test-results/v0.7.0-workflow-engine.md

@@ -7,7 +7,7 @@
 | 항목 | 결과 |
 |------|------|
 | CLI 버전 | `trinity, version 0.7.0` |
-| 전체 테스트 | 882 passed |
+| 전체 테스트 | 901 passed |
 | 경고 | 1건: `unittest.mock` AsyncMock coroutine RuntimeWarning |
 | 실행 명령 | `uv run pytest -q` |
 | 변경 파일 ruff | `uv run --with ruff ruff check ...` 통과 |
@@ -22,8 +22,10 @@ v0.7.0 workflow engine redesign에서 추가한 다음 영역을 검증했다.
 | Provider readiness | `tests/test_provider_readiness.py`, `tests/test_orchestrator.py`, `tests/test_tui.py` |
 | Response contract/artifacts | `tests/test_response_contract.py`, `tests/test_protocol.py` |
 | Workflow state machine | `tests/test_workflow_engine.py`, `tests/test_tui_session.py` |
+| User decision UX | `tests/test_workflow_engine.py`, `tests/test_tui_session.py`, `tests/test_tui_prompt.py` |
 | Workflow persistence | `tests/test_workflow_persistence.py`, `tests/test_workflow_engine.py` |
 | Structured consensus | `tests/test_structured_consensus.py`, `tests/test_protocol.py` |
+| Open question parser | `tests/test_structured_consensus.py`, `tests/test_protocol.py` |
 | Blueprint decomposition | `tests/test_blueprint_decomposer.py`, `tests/test_workflow_engine.py` |
 | Execution protocol | `tests/test_execution_protocol.py`, `tests/test_workflow_engine.py` |
 | Subagent reporting | `tests/test_execution_protocol.py`, `tests/test_tui_session.py` |
@@ -54,6 +56,53 @@ uv run pytest -q \
 171 passed
 ```
 
+최근 user decision UX 후속 작업에서 실행한 집중 테스트:
+
+```bash
+uv run pytest -q \
+  tests/test_workflow_engine.py \
+  tests/test_tui_session.py \
+  tests/test_tui_prompt.py
+```
+
+결과:
+
+```text
+82 passed
+```
+
+최근 decision wizard 후속 작업에서 실행한 집중 테스트:
+
+```bash
+uv run pytest -q \
+  tests/test_tui_session.py \
+  tests/test_tui_prompt.py \
+  tests/test_workflow_engine.py
+```
+
+결과:
+
+```text
+85 passed
+```
+
+최근 open question parser 후속 작업에서 실행한 집중 테스트:
+
+```bash
+uv run pytest -q \
+  tests/test_structured_consensus.py \
+  tests/test_protocol.py \
+  tests/test_workflow_engine.py \
+  tests/test_tui_session.py \
+  tests/test_tui_prompt.py
+```
+
+결과:
+
+```text
+109 passed
+```
+
 전체 테스트:
 
 ```bash
@@ -63,7 +112,7 @@ uv run pytest -q
 결과:
 
 ```text
-882 passed, 1 warning
+901 passed, 1 warning
 ```
 
 ## 4. 구현 기준선
@@ -102,4 +151,4 @@ uv run pytest -q
 RuntimeWarning: coroutine 'AsyncMockMixin._execute_mock_call' was never awaited
 ```
 
-테스트 실패를 만들지는 않지만, error handling 계열 mock fixture 정리 여지가 있다.
+테스트 실패를 만들지는 않지만, e2e context 계열 mock fixture 정리 여지가 있다.