Add detailed optimizer debug trace for candidate-level visibility

Expose per-iteration sentence edits, candidate scores, validity flags, rejection reasons, and chosen variants in UI to diagnose why optimization steps are accepted or rejected.

Made-with: Cursor

optimizer.py

@@ -505,6 +505,7 @@ def optimize_text(request_data: Dict[str, Any]) -> Dict[str, Any]:
                         "goal_improved": goal_improved,
                         "invalid_reasons": invalid_reasons,
                         "delta_score": delta_score,
+                        "candidate_score": cand_metrics.get("score"),
                     }
                 )
             except Exception as e:
@@ -516,6 +517,7 @@ def optimize_text(request_data: Dict[str, Any]) -> Dict[str, Any]:
                         "goal_improved": False,
                         "invalid_reasons": [str(e)],
                         "delta_score": -999.0,
+                        "candidate_score": None,
                     }
                 )
 
@@ -535,6 +537,8 @@ def optimize_text(request_data: Dict[str, Any]) -> Dict[str, Any]:
                             "goal_improved": c.get("goal_improved", False),
                             "invalid_reasons": c.get("invalid_reasons", []),
                             "delta_score": c.get("delta_score"),
+                            "candidate_score": c.get("candidate_score"),
+                            "sentence_after": c.get("sentence_after"),
                             "error": c.get("error"),
                         }
                         for c in candidates
@@ -559,6 +563,22 @@ def optimize_text(request_data: Dict[str, Any]) -> Dict[str, Any]:
                     "reason": "Best valid candidate did not improve total score.",
                     "best_candidate_score": best["metrics"]["score"],
                     "current_score": current_metrics["score"],
+                    "best_candidate_index": best.get("candidate_index"),
+                    "best_candidate_goal_improved": best.get("goal_improved", False),
+                    "best_candidate_sentence_after": best.get("sentence_after"),
+                    "candidates": [
+                        {
+                            "candidate_index": c.get("candidate_index"),
+                            "valid": c.get("valid", False),
+                            "goal_improved": c.get("goal_improved", False),
+                            "invalid_reasons": c.get("invalid_reasons", []),
+                            "delta_score": c.get("delta_score"),
+                            "candidate_score": c.get("candidate_score"),
+                            "sentence_after": c.get("sentence_after"),
+                            "error": c.get("error"),
+                        }
+                        for c in candidates
+                    ],
                 }
             )
             continue
@@ -580,6 +600,20 @@ def optimize_text(request_data: Dict[str, Any]) -> Dict[str, Any]:
                 "metrics_before": prev_metrics,
                 "metrics_after": current_metrics,
                 "delta_score": round(current_metrics["score"] - prev_metrics["score"], 3),
+                "chosen_candidate_index": best.get("candidate_index"),
+                "candidates": [
+                    {
+                        "candidate_index": c.get("candidate_index"),
+                        "valid": c.get("valid", False),
+                        "goal_improved": c.get("goal_improved", False),
+                        "invalid_reasons": c.get("invalid_reasons", []),
+                        "delta_score": c.get("delta_score"),
+                        "candidate_score": c.get("candidate_score"),
+                        "sentence_after": c.get("sentence_after"),
+                        "error": c.get("error"),
+                    }
+                    for c in candidates
+                ],
             }
         )
 

templates/index.html

@@ -825,6 +825,13 @@
             ['Semantic gaps', base.semantic_gap_count, fin.semantic_gap_count],
         ].map(r => `<tr><td>${r[0]}</td><td>${r[1]}</td><td>${r[2]}</td></tr>`).join('');
 
+        const safeHtml = (v) => String(v ?? '')
+            .replace(/&/g, '&amp;')
+            .replace(/</g, '&lt;')
+            .replace(/>/g, '&gt;')
+            .replace(/"/g, '&quot;')
+            .replace(/'/g, '&#39;');
+
         const iterRows = (data.iterations || []).map(it => {
             const before = it.metrics_before ? it.metrics_before.score : '-';
             const after = it.metrics_after ? it.metrics_after.score : '-';
@@ -840,6 +847,53 @@
             </tr>`;
         }).join('');
 
+        const iterationDebugHtml = (data.iterations || []).map(it => {
+            const candidates = Array.isArray(it.candidates) ? it.candidates : [];
+            const candidateRows = candidates.map(c => {
+                const reasons = Array.isArray(c.invalid_reasons) ? c.invalid_reasons.join(', ') : '';
+                const sentAfter = c.sentence_after ? safeHtml(c.sentence_after) : '-';
+                return `
+                    <tr>
+                        <td>${c.candidate_index ?? '-'}</td>
+                        <td>${c.valid ? 'yes' : 'no'}</td>
+                        <td>${c.goal_improved ? 'yes' : 'no'}</td>
+                        <td>${c.delta_score ?? '-'}</td>
+                        <td>${c.candidate_score ?? '-'}</td>
+                        <td>${safeHtml(reasons || c.error || '-')}</td>
+                        <td><div style="max-width: 520px; white-space: normal;">${sentAfter}</div></td>
+                    </tr>
+                `;
+            }).join('');
+
+            const sentBefore = it.sentence_before ? safeHtml(it.sentence_before) : '-';
+            const sentAfterChosen = it.sentence_after
+                ? safeHtml(it.sentence_after)
+                : (it.best_candidate_sentence_after ? safeHtml(it.best_candidate_sentence_after) : '-');
+
+            return `
+            <div class="card mb-3 border-0 shadow-sm">
+                <div class="card-body">
+                    <div class="d-flex justify-content-between align-items-center mb-2">
+                        <div><strong>Шаг ${it.step}</strong> — ${safeHtml(it.status || '-')}</div>
+                        <span class="badge bg-secondary">${safeHtml(it.goal ? (it.goal.type + ': ' + (it.goal.label || '')) : '-')}</span>
+                    </div>
+                    <div class="small mb-2"><strong>Причина:</strong> ${safeHtml(it.reason || '-')}</div>
+                    <div class="small mb-2"><strong>Исходное предложение:</strong><br><span class="text-muted">${sentBefore}</span></div>
+                    <div class="small mb-2"><strong>Выбранный вариант:</strong><br><span class="text-muted">${sentAfterChosen}</span></div>
+                    <div class="table-responsive">
+                        <table class="table table-sm table-bordered mb-0">
+                            <thead class="table-light">
+                                <tr>
+                                    <th>#cand</th><th>valid</th><th>goal+</th><th>Δ</th><th>score</th><th>reject reason/error</th><th>кандидат правки</th>
+                                </tr>
+                            </thead>
+                            <tbody>${candidateRows || '<tr><td colspan="7" class="text-center text-muted">Нет кандидатов</td></tr>'}</tbody>
+                        </table>
+                    </div>
+                </div>
+            </div>`;
+        }).join('');
+
         container.innerHTML = `
             <div class="stat-card">
                 <h6 class="card-title">Результат оптимизации</h6>
@@ -860,6 +914,10 @@
                         <tbody>${iterRows || '<tr><td colspan="7" class="text-muted text-center">Нет данных</td></tr>'}</tbody>
                     </table>
                 </div>
+            </div>
+            <div class="stat-card">
+                <h6 class="card-title">Подробный debug-лог итераций</h6>
+                ${iterationDebugHtml || '<div class="text-muted">Нет данных.</div>'}
             </div>`;
     }