fix(summaries): friendly empty state when summaries.json is missing

Previously a workspace without summaries.json showed a red error banner
'File not found: summaries.json'. The 404 is the expected state on a
fresh workspace — polish hasn't run yet — not an error.

Now detects the 404 specifically and renders a centered empty-state
card with the exact command to generate the file (attune-author polish)
plus a one-paragraph explanation of what the file does. Other failure
modes (corrupt JSON, real I/O errors) still surface the danger banner.

Adds .empty-state and .cmd-snippet styles in static_cw/style.css.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: silversurfer562

sidecar/attune_gui/routes/cowork_pages.py

@@ -163,6 +163,8 @@ async def page_summaries(request: Request) -> HTMLResponse:
 
     summaries: dict[str, str] = {}
     error: str | None = None
+    not_yet_generated = False
+
     try:
         data = await cowork_files.read_file(root="summaries", path="summaries.json")
         try:
@@ -173,10 +175,23 @@ async def page_summaries(request: Request) -> HTMLResponse:
         except json.JSONDecodeError as exc:
             error = f"Invalid JSON in summaries.json: {exc}"
     except HTTPException as exc:
-        error = exc.detail if isinstance(exc.detail, str) else "Could not load summaries.json"
+        # 404 = file simply hasn't been generated yet → friendly empty state
+        # rather than a red error banner.
+        if exc.status_code == 404:
+            not_yet_generated = True
+        else:
+            error = exc.detail if isinstance(exc.detail, str) else "Could not load summaries.json"
 
     return templates.TemplateResponse(
-        request, "summaries.html", _ctx(request, "summaries", summaries=summaries, error=error)
+        request,
+        "summaries.html",
+        _ctx(
+            request,
+            "summaries",
+            summaries=summaries,
+            error=error,
+            not_yet_generated=not_yet_generated,
+        ),
     )
 
 

sidecar/attune_gui/static_cw/style.css

@@ -444,6 +444,34 @@ code, .mono {
   padding: 10px 14px;
 }
 
+/* Friendly empty states (page-level, not inline) */
+.empty-state {
+  text-align: center;
+  padding: 36px 28px;
+  max-width: 520px;
+  margin: 32px auto;
+}
+.empty-state-title {
+  margin: 0 0 8px;
+  font-size: 1.1rem;
+  font-weight: 600;
+  letter-spacing: -0.01em;
+}
+.empty-state-body {
+  color: var(--ink-soft);
+  margin: 0 0 14px;
+}
+.cmd-snippet {
+  display: inline-block;
+  background: var(--ink);
+  color: #f5f5f7;
+  font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+  font-size: 0.85rem;
+  padding: 8px 14px;
+  border-radius: var(--radius-sm);
+  margin: 0;
+}
+
 /* ── Banners ───────────────────────────────────────────────────────────── */
 
 .banner {

sidecar/attune_gui/templates/summaries.html

@@ -3,40 +3,57 @@
 {% block title %}Summaries{% endblock %}
 
 {% block content %}
-  <p class="banner warn">
-    ⚠ <code>summaries.json</code> is fully regenerated by <code>attune-author polish</code>.
-    Manual edits will be overwritten on the next run.
-  </p>
+  {% if not_yet_generated %}
+    <div class="card empty-state">
+      <h2 class="empty-state-title">No summaries yet</h2>
+      <p class="empty-state-body">
+        <code class="mono">summaries.json</code> hasn't been generated for this
+        workspace yet. Run the polish pass to create it:
+      </p>
+      <pre class="cmd-snippet">attune-author polish</pre>
+      <p class="dim small" style="margin-top:1rem;">
+        Once generated, this page will show every entry in a table you can
+        edit inline. The polish command runs an LLM pass over your templates
+        to produce path-keyed summaries that the RAG retriever uses for boost
+        scoring.
+      </p>
+    </div>
+  {% else %}
+    <p class="banner warn">
+      ⚠ <code>summaries.json</code> is fully regenerated by <code>attune-author polish</code>.
+      Manual edits will be overwritten on the next run.
+    </p>
 
-  {% if error %}
-    <p class="banner danger">{{ error }}</p>
-  {% endif %}
+    {% if error %}
+      <p class="banner danger">{{ error }}</p>
+    {% endif %}
 
-  {% if summaries %}
-    <div class="table-wrap">
-      <table class="data-table">
-        <thead>
-          <tr>
-            <th style="width: 38%;">Path</th>
-            <th>Summary</th>
-            <th style="width: 7rem;"></th>
-          </tr>
-        </thead>
-        <tbody>
-        {% for path, summary in summaries.items() %}
-          <tr>
-            <td><code class="mono">{{ path }}</code></td>
-            <td>
-              <textarea class="inline-edit" data-key="{{ path }}" rows="2">{{ summary }}</textarea>
-            </td>
-            <td><button class="btn ghost btn-save" data-key="{{ path }}">Save</button></td>
-          </tr>
-        {% endfor %}
-        </tbody>
-      </table>
-    </div>
-  {% elif not error %}
-    <p class="empty">No summaries yet. Run <code>attune-author polish</code> to generate them.</p>
+    {% if summaries %}
+      <div class="table-wrap">
+        <table class="data-table">
+          <thead>
+            <tr>
+              <th style="width: 38%;">Path</th>
+              <th>Summary</th>
+              <th style="width: 7rem;"></th>
+            </tr>
+          </thead>
+          <tbody>
+          {% for path, summary in summaries.items() %}
+            <tr>
+              <td><code class="mono">{{ path }}</code></td>
+              <td>
+                <textarea class="inline-edit" data-key="{{ path }}" rows="2">{{ summary }}</textarea>
+              </td>
+              <td><button class="btn ghost btn-save" data-key="{{ path }}">Save</button></td>
+            </tr>
+          {% endfor %}
+          </tbody>
+        </table>
+      </div>
+    {% elif not error %}
+      <p class="empty">summaries.json is empty.</p>
+    {% endif %}
   {% endif %}
 {% endblock %}