gap-analysis doc: record the UI bug batch (log viewer, skill detail, artifact click-through)

Three real self-hosting fixes (log content never written, skill detail page missing real content, artifact list not clickable), two design questions set aside per user's request (unified Planner-driven work graph across all org agents, loop visualization on the graph), three bugs left for a future batch, and two infrastructure bugs found and fixed along the way (manual_resume not actually continuing execution for most block reasons, run_goal_to_completion crashing instead of blocking on unrouted exceptions). Also upgrades the RollbackPathBFailureTest flakiness note -- three independent real sessions have now hit it. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

gap-analysis doc: record the UI bug batch (log viewer, skill detail, artifact click-through)
Three real self-hosting fixes (log content never written, skill detail page missing real content, artifact list not clickable), two design questions set aside per user's request (unified Planner-driven work graph across all org agents, loop visualization on the graph), three bugs left for a future batch, and two infrastructure bugs found and fixed along the way (manual_resume not actually continuing execution for most block reasons, run_goal_to_completion crashing instead of blocking on unrouted exceptions). Also upgrades the RollbackPathBFailureTest flakiness note -- three independent real sessions have now hit it. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
bboonnee
1 parent f9c2e854
Showing 1 changed file with 62 additions and 0 deletions
docs/implementation-gap-analysis.md
@@ -139,6 +139,68 @@ gap御ｽ**蜈ｨ螻閠碁撼謖蛾｡ｹ逶ｮ逧ｹｶ蜿醍ｻ溯ｮ｡**譏ｯ荳肴弍譛画э荳ｺ荵具ｼ悟ｼ蠕玲
 ---
+## 7. 謗ｧ蛻ｶ蜿ｰ UI Bug 謇ｹ谺｡2026-08-04/05檎畑謌ｷ逶ｴ謗･謠蝉ｾ帷噪 9 譚｡貂黒
+
+霍溽ｬｬ 6 闃ら噪邉ｻ扈滓ｧ gap 荳榊酔瑚ｿ呎音譏ｯ逕ｨ謌ｷ螳樣刔逕ｨ謗ｧ蛻ｶ蜿ｰ譌ｶ隶ｰ蠖慕噪蜈ｷ菴 UI/菴馴ｪ碁琉鬚倥る先擅謗呈衍莉｣遐∫鴫迥ｶ蜷趣ｼ悟謌蝉ｸ臥ｱｻ螟炊
+
+**7.1 蟾ｲ菫ｮ螟搾ｼ3 譚｡悟驛ｨ逵溷ｮ櫁ｵｰ graphlemon 閾ｪ荳ｾ豬∫ｨ具ｼ碁撼莠ｺ蟾･謾ｹ莉｣遐ｼ**
+
+- **Bug1+Bug6亥粋蟷ｶ謌蝉ｸ荳ｪ莉ｻ蜉｡悟酔譬ｹ蝗**哦raph 鬘ｵ髱｢譌･蠢怜玄蝓滓ｰｸ霑懈仞遉ｺ"證よ裏譌･蠢怜螳ｹ"帑ｸ玖ｽｽ螳梧紛譌･蠢玲冠髞呵ｷｳ
+  蛻ｰ荳榊ｭ伜惠逧｡ｵ髱｢縲よｹ蝗啻execution_log.append_log()` 蜃ｽ謨ｰ譛ｬ霄ｫ螳梧紛御ｽ函莠ｧ莉｣遐∽ｻ取擂豐｡譛芽ｰ畑霑ｮｼ形execution_log_file`
+  逎∫尨譁ｻｶ莉取悴陲ｫ逵滓ｭ｣蜀呵ｿ螳ｹ窶披泌燕遶ｯ譏ｾ遉ｺ遨ｺ譏ｯ蟇ｹ遨ｺ謨ｰ謐ｮ逧ｭ｣遑ｮ蜿榊ｺ費ｼ御ｸ玖ｽｽ謚･髞呎弍 `_send_file_download()` 豐｡謗･
+  `FileNotFoundError`縲**菫ｮ螟**壽滑 `append_log()` 謗･蜈･ `work_graph_orchestrate.py` 逧 `_make_run_fn()`conn`
+  荳霍ｯ莨霑帛悉会ｼ瑚鰍轤ｹ蠑蟋/螳梧/螟ｱ雍･/髯先ｵ∝推蜀吩ｸ譚｡逵溷ｮ樊律蠢嶺ｺ倶ｻｶ帑ｸ玖ｽｽ謗･蜿｣陦･荳雁ｹｲ蜃逧 404 螟炊縲**逵溷ｮ樣ｪ瑚ｯ**壻ｿｮ螟
+  蜷亥ｹｶ蜷取眠襍ｷ逧ｻｻ蜉｡悟ｮ樊慮譟･隸｢ `GET /api/work-nodes/:id/log` 逵溽噪閭ｽ隸ｻ蛻ｰ `{"event": "node_start", ...}` 霑咏ｱｻ逵溷ｮ槫
+  螳ｹ井ｸ肴弍髱 Validator 謚･蜻奇ｼ梧弍謌題蟾ｱ蝨ｨ霑呎音莉ｻ蜉｡霑占｡瑚ｿｨ倶ｸｭ逶ｴ謗･譟･隸｢遑ｮ隶､逧ｼ峨
+- **Bug8**啻http://.../#/skills` 鬘ｵ髱｢轤ｹ蜃ｻ skill 蜿ｪ譏ｾ遉ｺ"蠖灘燕豐｡譛芽ｿｭ莉｣隶ｰ蠖"檎悄螳槫螳ｹ荳肴仞遉ｺ縲よｹ蝗啻skill_query.py`
+  蜿ｪ隸ｻ DB 驥檎噪 `skill`/`skill_iteration` 陦ｨ郁ｿｭ莉｣隶ｰ蠖包ｼ梧悽譚･蟆ｱ譏ｯ遨ｺ逧ｲ｡髞呻ｼ会ｼ御ｻ取ｲ｡譛牙謨ｰ隸ｻ `skills/<skill_id>/SKILL.md`
+  霑呎音逎∫尨荳顔噪逵溷ｮ槫螳ｹ亥ｰｱ譏ｯ譛ｬ譁｡｣ 6.2 闃る｡ｺ蠎 3 驍｣谺｡霑∫ｧｻ霑帶擂逧ｼ峨**菫ｮ螟**壽眠蠅 `get_skill_content()`**荳､螻りｷｯ
+  蠕ｩｿ雜企亟謚､**realpath` + `commonpath` containment 蜿碁譬｡鬪鯉ｼ碁亟豁｢ `skill_id` 驥悟ｸｦ `../` 霍ｳ蜃ｺ `skills/` 逶ｮ蠖包ｼ会ｼ
+  Validator 逕ｨ逵溷ｮ樒ｼ也∵判蜃ｻ蟄礼ｬｦ荳ｲ%2e%2e%2f`縲〜..%2f..%2f` 遲会ｼ牙ｯｹ逹荳荳ｪ逵溷ｮ樊叛蝨ｨ `skills/` 螟夜擇逧"遘伜ｯ枚莉ｶ"鬪
+  隸∬ｿ亟謚､遑ｮ螳樊協蠕嶺ｽ擾ｼ帛燕遶ｯ譁ｰ蠅樒噪"Skill 蜀ｮｹ"髱｢譚ｿ霍溷ｷｲ譛臥噪"霑ｭ莉｣隶ｰ蠖"髱｢譚ｿ蟷ｶ蛻怜ｱ慕､ｺ御ｸ肴弍莠碁我ｸ縲
+- **Bug2**啀lanner 莠ｧ蜃ｺ諤ｻ隗育噪譁ｻｶ/莉｣遐∝陦ｨ鬘ｹ轤ｹ蜃ｻ豐｡蜿榊ｺ斐よｹ蝗啻renderArtifactSummaryList()` 貂ｲ譟鍋ｺｯ `<li>`碁峺
+  轤ｹ蜃ｻ莠倶ｻｶ縲**菫ｮ螟**壼陦ｨ鬘ｹ蜉 `data-artifact-id` + 轤ｹ蜃ｻ霍ｳ霓ｬ悟､咲畑蟾ｲ譛臥噪 `v_artifact_browser`c_artifact_get`会ｼ
+  豐｡譛蛾譁ｰ蟒ｺ荳螂怜螳ｹ螻慕､ｺ譛ｺ蛻ｶ"譟･逵句驛ｨ"霍ｳ譛ｪ霑ｻ､蛻苓｡ｨ逧里譛芽｡御ｸｺ蜴滓ｷ菫晉蕗縲７alidator 閾ｪ蟾ｱ謳ｭ莠ｸ荳ｪ DOM/fetch 讓｡諡
+  邇ｯ蠅★遶ｯ蛻ｰ遶ｯ鬪瑚ｯｼ御ｸｭ騾泌書邇ｰ閾ｪ蟾ｱ謳ｭ逧ｪ瑚ｯ∫識蠅悽霄ｫ譛 bug井ｸ肴弍陲ｫ豬倶ｻ｣遐琉鬚假ｼ会ｼ悟菫ｮ螂ｽ鬪瑚ｯ∝ｷ･蜈ｷ蜀咲ｻｧ扈ｭ蛻､螳壹
+
+**7.2 譏守｡ｮ荳榊ｻｺ莉ｻ蜉｡縲怙隕∝隶ｨ隶ｺ隶ｾ隶｡2 譚｡梧潔逕ｨ謌ｷ隕∵ｱゆｿ晉蕗**
+
+- **Bug3**夂畑謌ｷ諠ｳ謚 Coder/Validator 逧 Work Graph 隗謠仙燕扈滉ｸ蛻ｰ Planner 髦ｶ谿ｵ荳蟷ｶ莠ｧ蜃ｺrd-prd-sdd-benchmark-
+  workgraph for other org agent峨ゆｻ｣遐∫鴫迥ｶ譬ｸ螳橸ｼ啻e2e_pipeline.py` 逧 `implement_code()` 逶ｮ蜑肴ｰｸ霑懃畑荳荳ｪ蜀呎ｭｻ逧
+  蜊戊鰍轤ｹ蜷域 manifest 隹畑 Coder形work_graph_plan.py` 逧 Prompt/萓晁ｵ夜得讓｡譚ｿ遑ｬ郛也∵ｭｻ莠 Planner 閾ｪ蟾ｱ驍｣蝗ｺ螳夂噪蝗幄鰍
+  轤ｹ體ｾ梧ｲ｡譛我ｻｻ菴墓惻蛻ｶ閭ｽ謇ｩ螻募芦隕尠蜈ｶ莉 Agent娵alidator 螳悟荳咲畑蝗ｾ縲りｿ呵ｷ溽ｬｬ 3 闃"Coder 髦ｶ谿ｵ逧､壽ｨ｡蝮 Work Graph
+  隗"譏ｯ蜷御ｸ荳ｪ豁､蜑榊ｰｱ陲ｫ蛻､譁ｭ荳ｺ"雜闌峩逧眠閭ｽ蜉"逧哨蟄撰ｼ瑚ｿ呎ｬ｡逕ｨ謌ｷ逧ｯ画ｱよ峩霑帑ｸ豁･井ｸ榊宵譏ｯ Coder 閾ｪ蟾ｱ莨夊ｧ瑚
+  譏ｯ Planner 扈滉ｸ隗蜈ｨ驛ｨ荳我ｸｪ Agent 逧崟俄披**豐｡譛牙蟒ｺ task**悟ｱ樔ｺ手ｮｾ隶｡蜀ｳ遲厄ｼ碁怙隕∝隶ｨ隶ｺ譁ｹ譯医
+- **Bug9**唹rg-level Loop 逧ｿｭ莉｣alidator FAIL 竊 驥肴眠隗/菫ｮ螟搾ｼ牙ｺ碑ｯ･諤惹ｹ亥惠蝗ｾ荳雁ｱ慕､ｺ縲ゆｻ｣遐∫鴫迥ｶ譬ｸ螳橸ｼ壼ｹｶ髱樔ｻ朱峺
+  蠑蟋銀披覗task.work_graph_runs` 譛ｬ譚･蟆ｱ譏ｯ荳荳ｪ run 荳荳ｪ迢ｬ遶 DAG 髱｢譚ｿ悟､夊ｽｮ loop 螟ｩ辟ｶ莨壻ｺｧ逕溷､壻ｸｪ髱｢譚ｿ嫣task.route`
+  莨壽ｸｲ譟謎ｸ譚｡"驥崎ｯ慕識"逧ｳｨ霎ｹ縲らｼｺ逧弍霍ｨ霓ｮ谺｡髱｢譚ｿ荵矩龍逧ｧｧ芽ｿ樊磁御ｻ･蜿頑ｳｨ霎ｹ蜿ｪ蜿肴丐蠖灘燕蜊穂ｸ `route` 蛟ｼ縲∵ｲ｡譛画潔霓ｮ
+  谺｡逧紙蜿ｲ縲**豐｡譛牙蟒ｺ task**悟ｱ樔ｺ手ｮｾ隶｡蜀ｳ遲厄ｼ碁怙隕∝隶ｨ隶ｺ諤惹ｹ亥争邇ｰ豈碑ｾ粋逅
+
+**7.3 蟆壽悴螟炊ug4縲。ug5縲。ug7梧悽谺｡莨夊ｯ晄悴謗抵ｼ**
+
+- Bug4rg Graph 闃らせ荳榊庄轤ｹ峨。ug5郁ｿ占｡悟紙蜿ｲ轤ｹ蜃ｻ霍ｳ髞吝慍譁ｹ檎ｼｺ荳謨ｴ荳ｪ霑占｡瑚ｯｦ諠/譌･蠢鈴｡ｵ蜷ｫ螳樊慮 tail -f峨。ug7
+  亥ｯｼ闊ｪ譬冗ｼｺ鬘ｹ逶ｮ蜷+莉ｻ蜉｡逵区攸蟆 dashboard俄披比ｻ｣遐∝ｱる擇蟾ｲ扈乗賜譟･霑ｹ蝗郁ｧ∵悽闃ょｯｹ蠎皮皮ｩｶ隶ｰ蠖包ｼ会ｼ瑚ｧｨ｡莉"荳ｭ"蛻ｰ"荳ｭ
+  螟ｧ"荳咲ｭ会ｼ沓ug5 譏ｯ逵溽噪郛ｺ荳謨ｴ荳ｪ譁ｰ鬘ｵ髱｢御ｸ榊宵譏ｯ謗･郤ｿ髣ｮ鬚倥ら蕗蠕ｸ倶ｸ謇ｹ螟炊縲
+
+**7.4 霑吩ｸ謇ｹ鬘ｺ蟶ｦ菫ｮ螟咲噪荳､荳ｪ蝓ｺ遑隶ｾ譁ｽ bug井ｸ榊惠蜴溷ｧ 9 譚｡貂黒驥鯉ｼ瑚ｿ占｡瑚ｿｨ倶ｸｭ逵溷ｮ樣∞蛻ｰ謇榊書邇ｰ**
+
+- **`manual_resume` 荵句燕蜿ｪ蟇ｹ逕ｨ謌ｷ荳ｻ蜉ｨ證ょ●/蛛懈ｭ｢逕滓譜**壻ｸ谺｡逵溷ｮ樒ｽ醍ｻ懃椪譁ｭENOTFOUND`牙ｯｼ閾ｴ莉ｻ蜉｡ `execution_error`
+  髦ｻ蝪橸ｼ罫esume 蜷主宵譏ｯ迥ｶ諤∫ｿｻ蝗槫悉縲∵ｲ｡譛臥悄逧ｻｭ霍托ｼ形/execute` 蜿郁ｦ∵ｱ `status=queued`窶披排esume 螳御ｸ､霎ｹ驛ｽ螟滉ｸ咲捩悟今豁ｻ縲
+  謾ｹ謌宣勁 `budget_exceeded`/`loop_limit_reached`井ｸ､閠推譛我ｸ灘ｱ樒ｻｭ霍題ｷｯ蠕ｼ牙､厄ｼ悟菴吝次蝗 resume 蜷朱逵溽噪莨夊蜉ｨ扈ｭ霍代
+- **`scheduler.run_goal_to_completion()` 蟇ｹ荳榊庄霍ｯ逕ｱ蠑ょｸｸ豐｡譛牙蠎**壻ｸ谺｡逵溷ｮ"API Response stalled mid-stream"
+  髞呵ｯｯWorkGraphExecuteError`御ｸ榊惠 `_ROUTABLE_EXCEPTIONS` 驥鯉ｼ臥峩謗･謚願ｰ畑霑帷ｨ句ｴｩ貅ｼ御ｻｻ蜉｡蜊｡蝨ｨ荳荳ｪ譌｢荳崎ｿ占｡御ｹ滉ｸ
+  譏ｯ `blocked_pending_human` 逧悄遨ｺ迥ｶ諤ｼ形blocked_reason` 譏ｯ遨ｺ逧ｼ梧而蛻ｶ蜿ｰ荳頑ｲ｡譛我ｻｻ菴募蜿｣閭ｽ諱｢螟榊ｮり｡･莠ｸ荳ｪ霍
+  `task_execution._mark_blocked()` 蟇ｹ遘ｰ逧蠎包ｼ壻ｻｻ菴墓悴霍ｯ逕ｱ蠑ょｸｸ邇ｰ蝨ｨ驛ｽ莨夊誠謌 `blocked_pending_human` +
+  `execution_error` + 逵溷ｮ樣漠隸ｯ隸ｦ諠ｼ御ｸ堺ｼ壼譌螢ｰ蜊｡豁ｻ縲
+
+**7.5 `test_deploy_rollback.RollbackPathBFailureTest` 逧蜿大､ｱ雍･瑚ｯ∵紺蜊ｺｧ**夂ｬｬ 6 闃る｡ｺ蠎 3 譌ｶ隨ｬ荳谺｡陲ｫ Validator
+謚･蜻雁､ｱ雍･縲∵譛ｬ蝨ｰ螟咲鴫荳堺ｺｼ幄ｿ呎ｬ｡鬘ｺ蠎 B 蜿郁｢ｫ迢ｬ遶区冠蜻贋ｺｸ谺｡螟ｱ雍･井ｸ碑ｿ呎ｬ｡ Validator 閾ｪ蟾ｱ譽蜃ｺ莠 diff 蜑咲噪辷ｶ commit
+遑ｮ隶､驍｣荳ｪ迚域悽荳雁酔譬ｷ螟ｱ雍･瑚ｯ∝ｮ樔ｸ取悽谺｡謾ｹ蜉ｨ譌蜈ｳ峨**邏ｯ隶｡荳画ｬ｡荳榊酔逧悄螳樔ｼ夊ｯ晄冠蜻雁､ｱ雍･梧閾ｪ蟾ｱ謇句勘驥崎ｷ大ｧ狗ｻ 3/3 騾
+霑**窶披比ｸ榊蠖捺"蛛ｶ蜿代∝荳咲ｮ｡"悟合郤ｧ謌"遑ｮ隶､蟄伜惠縲∝ｾｸ馴葎謗呈衍"悟ｾ亥庄閭ｽ霑俶弍霑吩ｸｪ螂嶺ｻｶ蟾ｲ遏･逧ｭ､蜆ｿ霑帷ｨ/襍ｺ千ｫ樔ｺ臥ｱｻ
+髣ｮ鬚假ｼ御ｽｲ｡譛牙豺ｱ謖匁ｹ蝗縲
+
+---
+
 ## 譛蛟ｼ蠕怜豕ｨ逧ｸ画擅
 1. 隹ｺｦ蝎ｨ豐｡謗･蜈･逕滉ｺｧ蜈･蜿｣檎ｳｻ扈溯ｿ倅ｸ肴弍逵滓ｭ｣閾ｪ鬩ｱ蜉ｨ逧ｼ育ｬｬ 2 闃ゑｼ峨