Add phase status display to web portal (research/dev/review badges)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: JihaoXin

ark/webapp/routes.py

@@ -495,6 +495,59 @@ def _read_current_iteration(project_dir: Path) -> int:
         return 0
 
 
+def _read_phase_status(project_dir: Path, project) -> dict:
+    """Read current phase, dev iteration, and review iteration status.
+
+    Returns a dict with: phase, dev_iter, max_dev_iter, review_iter, max_review_iter
+    """
+    state_dir = project_dir / "auto_research" / "state"
+    result = {
+        "phase": "",
+        "dev_iter": 0,
+        "max_dev_iter": project.max_dev_iterations,
+        "review_iter": 0,
+        "max_review_iter": project.max_iterations,
+    }
+
+    # Read dev phase state
+    dev_state_file = state_dir / "dev_phase_state.yaml"
+    if dev_state_file.exists():
+        try:
+            ds = yaml.safe_load(dev_state_file.read_text()) or {}
+            result["dev_iter"] = int(ds.get("iteration", 0))
+            dev_status = ds.get("status", "pending")
+            if dev_status == "complete":
+                result["phase"] = "review"
+            elif dev_status == "in_progress":
+                result["phase"] = "dev"
+        except Exception:
+            pass
+
+    # Read paper (review) state
+    paper_state_file = state_dir / "paper_state.yaml"
+    if paper_state_file.exists():
+        try:
+            ps = yaml.safe_load(paper_state_file.read_text()) or {}
+            reviews = ps.get("reviews") or []
+            if reviews:
+                result["review_iter"] = int(reviews[-1].get("iteration", len(reviews)))
+                result["phase"] = "review"
+            paper_status = ps.get("status", "")
+            if paper_status in ("accepted", "accepted_pending_cleanup"):
+                result["phase"] = "accepted"
+        except Exception:
+            pass
+
+    # Check for research phase
+    deep_research_file = state_dir / "deep_research.md"
+    if deep_research_file.exists() and not result["phase"]:
+        result["phase"] = "research"
+    elif not result["phase"] and project.status == "running":
+        result["phase"] = "initializing"
+
+    return result
+
+
 def _read_cost_report(project_dir: Path) -> dict:
     """Read cost_report.yaml and return a slim summary suitable for the UI.
 
@@ -1260,6 +1313,7 @@ async def api_get_project(project_id: str, request: Request):
             "score_history": _read_score_history(pdir),
             "current_iteration": _read_current_iteration(pdir),
             "max_iterations": project.max_iterations,
+            "phase_status": _read_phase_status(pdir, project),
             "has_pdf": pdf is not None,
             "has_pdf_upload": bool(project.has_pdf_upload),
             "slurm_job_id": project.slurm_job_id,

ark/webapp/static/app.html

@@ -1322,7 +1322,7 @@ <h3>User Settings & API Keys</h3>
     // detail info
     info_venue: 'Venue', info_user: 'User', info_model: 'Model',
     info_environment: 'Environment', info_created: 'Created', info_updated: 'Updated',
-    info_status: 'Status',
+    info_status: 'Status', info_phase: 'Phase',
     completed_iter: 'Completed (%d iterations)',
     running_iter: 'Running (%d / %d iterations)',
     running_plain: 'Running',
@@ -1434,7 +1434,7 @@ <h3>User Settings & API Keys</h3>
     status_waiting_template: '⏳ في انتظار القالب', status_pending: '⏳ في قائمة الانتظار',
     info_venue: 'المؤتمر', info_user: 'المستخدم', info_model: 'النموذج',
     info_environment: 'البيئة', info_created: 'تاريخ الإنشاء', info_updated: 'آخر تحديث',
-    info_status: 'الحالة',
+    info_status: 'الحالة', info_phase: 'المرحلة',
     completed_iter: 'مكتمل (%d تكرارات)',
     running_iter: 'قيد التشغيل (%d / %d تكرارات)',
     running_plain: 'قيد التشغيل',
@@ -1537,7 +1537,7 @@ <h3>User Settings & API Keys</h3>
     status_waiting_template: '⏳ 等待模板', status_pending: '⏳ 排队中',
     info_venue: '会议', info_user: '用户', info_model: '模型',
     info_environment: '环境', info_created: '创建时间', info_updated: '更新时间',
-    info_status: '状态',
+    info_status: '状态', info_phase: '阶段',
     completed_iter: '已完成（%d 次迭代）',
     running_iter: '运行中（%d / %d 次迭代）',
     running_plain: '运行中',
@@ -1966,6 +1966,59 @@ <h3>User Settings & API Keys</h3>
     </div>`;
 }
 
+// ══════════════════════════════════════════════════════
+//  Phase status helper
+// ══════════════════════════════════════════════════════
+function _renderPhaseStatus(p) {
+  const ps = p.phase_status;
+  if (!ps || !ps.phase) {
+    // Fallback for older backends
+    return `<div><b>Iteration:</b> ${p.current_iteration || 0} / ${p.max_iterations}</div>`;
+  }
+
+  const phaseLabels = {
+    research: t('phase_research') || 'Research',
+    dev: t('phase_dev') || 'Dev',
+    review: t('phase_review') || 'Review',
+    accepted: '✓ Accepted',
+    initializing: 'Initializing',
+  };
+  const phaseColors = {
+    research: '#8b5cf6',
+    dev: '#f59e0b',
+    review: '#3b82f6',
+    accepted: '#10b981',
+    initializing: 'var(--text-muted)',
+  };
+
+  const phaseName = phaseLabels[ps.phase] || ps.phase;
+  const phaseColor = phaseColors[ps.phase] || 'var(--text)';
+
+  // Build iteration detail string
+  let iterDetail = '';
+  if (ps.phase === 'dev') {
+    iterDetail = ` (${ps.dev_iter}/${ps.max_dev_iter})`;
+  } else if (ps.phase === 'review') {
+    iterDetail = ` (${ps.review_iter}/${ps.max_review_iter})`;
+  }
+
+  const badge = `<span style="display:inline-block;padding:1px 8px;border-radius:10px;font-size:.82em;font-weight:600;color:#fff;background:${phaseColor}">${esc(phaseName)}${iterDetail}</span>`;
+
+  // Build dev + review iteration summary line
+  const parts = [];
+  if (ps.max_dev_iter > 0) {
+    parts.push(`Dev ${ps.dev_iter}/${ps.max_dev_iter}`);
+  }
+  if (ps.max_review_iter > 0) {
+    parts.push(`Review ${ps.review_iter}/${ps.max_review_iter}`);
+  }
+  const iterLine = parts.length
+    ? `<div style="color:var(--text-muted);font-size:.88em;margin-top:2px">${parts.join(' · ')}</div>`
+    : '';
+
+  return `<div><b>${t('info_phase') || 'Phase'}:</b> ${badge}${iterLine}</div>`;
+}
+
 // ══════════════════════════════════════════════════════
 //  Project Detail
 // ══════════════════════════════════════════════════════
@@ -2024,7 +2077,7 @@ <h3>User Settings & API Keys</h3>
     <div><b>Project ID:</b> <code style="font-size:.85em;background:var(--bg-hover);padding:1px 5px;border-radius:4px">${esc(p.id)}</code></div>
     <div><b>${t('info_venue')}:</b> ${esc(p.venue)}</div>
     <div><b>${t('info_model')}:</b> ${esc(p.model || 'claude-sonnet-4-6')}</div>
-    <div><b>Iteration:</b> ${p.current_iteration || 0} / ${p.max_iterations}</div>
+    ${_renderPhaseStatus(p)}
     <div><b>${t('info_environment')}:</b> ${esc(p.environment || 'Local')}</div>
     ${condaEnvLine}
     <div><b>${t('info_user')}:</b> ${esc(p.user_email || '')}</div>