feedback: thumb up/down on logs + reviewer self-score 0-10

Two unrelated features bundled because they ship together and share
migration 0028.

Strategic-log feedback (thumb up/down):
- New strategic_log_feedback table with UNIQUE(log_id, user_id) so each
  user has one vote per log, flippable in place (up -> down -> clear).
  UI shows aggregate counts only.
- app/services/log_feedback.py: set_vote, get_counts, sign/verify
  feedback tokens (same itsdangerous pattern as auth.sign_pending,
  30-day TTL for email links).
- POST /api/log/{id}/feedback: web vote, auth required, returns counts
  + the requesting user's own vote.
- GET /feedback?token=...&vote=...: email-link target, no auth, signed
  token encodes (user, log, vote), renders feedback_thanks.html.
- partials/log.html: thumbs row below content, JS-driven swap via the
  POST endpoint. Dashboard latest-log card and /log page both render
  this partial via htmx, so the buttons appear in all three surfaces.
- digest emails: a "How was today's read?" row above the unsub footer,
  with signed-token URLs against the latest StrategicLog at send time.
  Plain-text fallback included.

Reviewer self-score (0-10):
- _SYSTEM_PROMPT asks for an integer score with anchors (10 exemplary,
  5 borderline, 0 unfit). Verdict gains score: int | None.
- Deterministic-layer hits get score=0 (hard rule, no nuance);
  error rows get None; LLM rows get the model's score clamped 0..10.
- ReviewerVerdict.score, StrategicLog.reviewer_score, and
  IndicatorSummary.reviewer_score all new SMALLINT NULL columns.
- ai_log_job + indicator_summary_job persist verdict.score onto their
  content rows when committing the row alongside content.

Tests:
- tests/test_strategic_log_feedback.py: vote, flip, clear, aggregate
  across users, invalid vote, token round-trip + tamper + garbage +
  'clear' not signable for email path.
- tests/test_output_review.py: score parsing, clamping (>10, <0),
  missing/non-numeric -> None, deterministic-layer score=0.

Full suite: 427 passed (was 412), 5 skipped, no regressions.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

app/jobs/ai_log_job.py

@@ -234,6 +234,7 @@ async def run() -> None:
                     prompt_tokens=result.prompt_tokens,
                     completion_tokens=result.completion_tokens,
                     cost_usd=full_cost,
+                    reviewer_score=verdict.score,
                 )
                 session.add(slog)
                 session.add(AICall(

app/jobs/email_digest_job.py

@@ -198,17 +198,32 @@ def _pick_variant(
 
 
 async def _send_one(user: User, kind: str, content_html: str, date_str: str,
-                    session) -> None:
+                    session, *, latest_log_id: int | None = None) -> None:
     settings_url = f"{branding.SITE_URL}/settings"
     unsubscribe_url = (
         f"{branding.SITE_URL}/email/unsubscribe"
         f"?token={sign_unsubscribe_token(user.id)}"
     )
+
+    # Build signed feedback URLs against the latest strategic log at send
+    # time. The token encodes (user, log, vote) so the recipient can
+    # click without being logged in; the receiving /feedback endpoint
+    # verifies the signature and applies the vote.
+    feedback_up_url = feedback_down_url = None
+    if latest_log_id is not None:
+        from app.services.log_feedback import sign_feedback_token
+        up_tok = sign_feedback_token(user.id, latest_log_id, "up")
+        down_tok = sign_feedback_token(user.id, latest_log_id, "down")
+        feedback_up_url = f"{branding.SITE_URL}/feedback?token={up_tok}&vote=up"
+        feedback_down_url = f"{branding.SITE_URL}/feedback?token={down_tok}&vote=down"
+
     subject, text_body, html_body = render_digest_email(
         kind=kind, date_str=date_str,
         content_html=content_html,
         unsubscribe_url=unsubscribe_url,
         settings_url=settings_url,
+        feedback_up_url=feedback_up_url,
+        feedback_down_url=feedback_down_url,
     )
     try:
         await send_email(to=user.email, subject=subject,
@@ -288,6 +303,18 @@ async def run() -> None:
                 client, variants, active_non_en,
             )
 
+        # Resolve the latest strategic log once per job — used as the
+        # target of the email's thumb up/down feedback links. None if
+        # nothing has been generated yet (shouldn't happen at this point
+        # in the flow, but defensible).
+        from sqlalchemy import desc, select
+        from app.models import StrategicLog
+        latest_log_id = (await session.execute(
+            select(StrategicLog.id)
+            .order_by(desc(StrategicLog.generated_at))
+            .limit(1)
+        )).scalar_one_or_none()
+
         written = 0
         for u in fresh:
             tone = (u.digest_tone or "INTERMEDIATE").upper()
@@ -296,7 +323,8 @@ async def run() -> None:
                 tone=tone,
                 lang=(u.lang or "en"),
             )
-            await _send_one(u, kind, content, date_str, session)
+            await _send_one(u, kind, content, date_str, session,
+                            latest_log_id=latest_log_id)
             await asyncio.sleep(0.1)
             written += 1
 

app/jobs/indicator_summary_job.py

@@ -215,6 +215,7 @@ async def _generate_one(
         # Include the reviewer's cost in the row's recorded spend so the
         # monthly budget tracking covers the full pipeline cost.
         cost_usd=(result.cost_usd or 0.0) + (verdict.cost_usd or 0.0),
+        reviewer_score=verdict.score,
     )
     session.add(summary)
     session.add(AICall(
@@ -342,6 +343,7 @@ async def run() -> None:
                                 prompt_tokens=result.prompt_tokens,
                                 completion_tokens=result.completion_tokens,
                                 cost_usd=full_cost,
+                                reviewer_score=verdict.score,
                             )
                             session.add(agg_summary)
                             session.add(AICall(

app/models.py

@@ -118,6 +118,10 @@ class StrategicLog(Base):
     prompt_tokens: Mapped[int | None] = mapped_column(Integer)
     completion_tokens: Mapped[int | None] = mapped_column(Integer)
     cost_usd: Mapped[float | None] = mapped_column(Float)
+    # Reviewer self-rating 0-10 (10 = exemplary, 0 = unfit). Nullable for
+    # rows generated before the score field existed; new rows always
+    # carry the value the reviewer returned alongside its clean verdict.
+    reviewer_score: Mapped[int | None] = mapped_column(SmallInteger)
 
 
 class StrategicLogTranslation(Base):
@@ -170,6 +174,8 @@ class IndicatorSummary(Base):
     prompt_tokens: Mapped[int | None] = mapped_column(Integer)
     completion_tokens: Mapped[int | None] = mapped_column(Integer)
     cost_usd: Mapped[float | None] = mapped_column(Float)
+    # Reviewer self-rating 0-10. See StrategicLog.reviewer_score.
+    reviewer_score: Mapped[int | None] = mapped_column(SmallInteger)
 
     __table_args__ = (Index("ix_indsumm_group_generated", "group_name", "generated_at"),)
 
@@ -244,6 +250,45 @@ class ReviewerVerdict(Base):
     layer: Mapped[str] = mapped_column(String(16), nullable=False)
     # LLM-layer model id, nullable for deterministic / error rows.
     model: Mapped[str | None] = mapped_column(String(64))
+    # Reviewer self-rating 0-10. Deterministic-layer hits get 0 (hard
+    # reject by rule), error rows get NULL, LLM rows get the model's score.
+    score: Mapped[int | None] = mapped_column(SmallInteger)
+
+
+class StrategicLogFeedback(Base):
+    """Anonymous-in-UI thumb up/down votes on strategic-log rows.
+
+    One row per (log_id, user_id) — flippable: a user can change their
+    vote (up → down) by overwriting, or clear it by deleting. The UI
+    surfaces only aggregate counts; user attribution is server-side
+    only and exists purely so we can dedup and let the voter see/flip
+    their own vote. See app/services/log_feedback.py."""
+    __tablename__ = "strategic_log_feedback"
+    id: Mapped[int] = mapped_column(_PK, primary_key=True, autoincrement=True)
+    log_id: Mapped[int] = mapped_column(
+        BigInteger().with_variant(Integer(), "sqlite"),
+        ForeignKey("strategic_logs.id", ondelete="CASCADE"),
+        nullable=False,
+    )
+    user_id: Mapped[int] = mapped_column(
+        Integer,
+        ForeignKey("users.id", ondelete="CASCADE"),
+        nullable=False,
+    )
+    # 'up' or 'down'. Service layer enforces the enum.
+    vote: Mapped[str] = mapped_column(String(8), nullable=False)
+    created_at: Mapped[datetime] = mapped_column(
+        DateTime(timezone=True), nullable=False, default=utcnow,
+    )
+    updated_at: Mapped[datetime] = mapped_column(
+        DateTime(timezone=True), nullable=False, default=utcnow,
+        onupdate=utcnow,
+    )
+
+    __table_args__ = (
+        UniqueConstraint("log_id", "user_id", name="uq_slf_log_user"),
+        Index("ix_strategic_log_feedback_log", "log_id"),
+    )
 
 
 class UserAcknowledgement(Base):

app/routers/api.py

@@ -285,11 +285,13 @@ async def news_list(
 def _log_partial_payload(
     row: StrategicLog | None,
     content_override: str | None = None,
+    feedback: object | None = None,
 ) -> dict | None:
     if row is None:
         return None
     content = content_override if content_override is not None else row.content
     return {
+        "id": row.id,
         "content_html": _md_to_html(content),
         "generated_at": row.generated_at,
         "model": row.model,
@@ -299,6 +301,7 @@ def _log_partial_payload(
         "cost_usd": row.cost_usd,
         "prompt_tokens": row.prompt_tokens,
         "completion_tokens": row.completion_tokens,
+        "feedback": feedback,
     }
 
 
@@ -404,9 +407,12 @@ async def log_latest(
 
     if as_ == "html":
         content_override = await _localized_content(session, row, principal)
+        feedback = await _feedback_for(session, row, principal)
         return templates.TemplateResponse(
             request, "partials/log.html",
-            {"log": _log_partial_payload(row, content_override=content_override),
+            {"log": _log_partial_payload(
+                row, content_override=content_override, feedback=feedback,
+             ),
              "tone": wanted_tone, "paid": not free_only},
         )
 
@@ -415,6 +421,21 @@ async def log_latest(
     return StrategicLogOut.model_validate(row, from_attributes=True)
 
 
+async def _feedback_for(
+    session: AsyncSession,
+    row: StrategicLog | None,
+    principal: CurrentUser | None,
+):
+    """Aggregate up/down counts + the principal's own vote, or None when
+    there's no log to fetch feedback for. Always safe to await; runs two
+    indexed queries."""
+    if row is None:
+        return None
+    from app.services.log_feedback import get_counts
+    user_id = principal.user.id if (principal and principal.user) else None
+    return await get_counts(session, log_id=row.id, user_id=user_id)
+
+
 @router.get("/log/by-date/{day}")
 async def log_by_date(
     request: Request,
@@ -459,9 +480,12 @@ async def log_by_date(
 
     if as_ == "html":
         content_override = await _localized_content(session, row, principal)
+        feedback = await _feedback_for(session, row, principal)
         return templates.TemplateResponse(
             request, "partials/log.html",
-            {"log": _log_partial_payload(row, content_override=content_override),
+            {"log": _log_partial_payload(
+                row, content_override=content_override, feedback=feedback,
+             ),
              "tone": wanted_tone, "paid": not free_only},
         )
     if row is None:
@@ -469,6 +493,53 @@ async def log_by_date(
     return StrategicLogOut.model_validate(row, from_attributes=True)
 
 
+# --- Log feedback (thumb up/down) --------------------------------------------
+
+
+class FeedbackIn(BaseModel):
+    vote: Literal["up", "down", "clear"]
+
+
+class FeedbackOut(BaseModel):
+    up: int
+    down: int
+    user_vote: str | None
+
+
+@router.post("/log/{log_id}/feedback", response_model=FeedbackOut)
+async def post_log_feedback(
+    log_id: int,
+    body: FeedbackIn,
+    session: AsyncSession = Depends(get_session),
+    principal: CurrentUser = Depends(require_token),
+) -> FeedbackOut:
+    """Record (or flip / clear) the authenticated user's thumb on a log.
+
+    Anonymous-in-UI: the response carries only aggregate counts plus the
+    *requesting* user's own vote (so the UI can highlight it). Other
+    users' votes are never exposed."""
+    if principal.user is None:
+        raise HTTPException(status_code=400, detail="admin token cannot vote")
+
+    # Guard against votes on non-existent logs (don't want orphan FKs).
+    exists = (await session.execute(
+        select(StrategicLog.id).where(StrategicLog.id == log_id).limit(1)
+    )).scalar_one_or_none()
+    if exists is None:
+        raise HTTPException(status_code=404, detail="log not found")
+
+    from app.services.log_feedback import FeedbackError, set_vote
+    try:
+        counts = await set_vote(
+            session, log_id=log_id, user_id=principal.user.id, vote=body.vote,
+        )
+    except FeedbackError as e:
+        raise HTTPException(status_code=400, detail=str(e))
+    return FeedbackOut(
+        up=counts.up, down=counts.down, user_vote=counts.user_vote,
+    )
+
+
 # --- Calendar archive --------------------------------------------------------
 
 

app/routers/pages.py

@@ -176,6 +176,60 @@ async def log_page_day(
     )
 
 
+@router.get("/feedback", response_class=HTMLResponse)
+async def log_feedback_via_token(
+    request: Request,
+    token: str,
+    vote: str | None = None,
+    session: AsyncSession = Depends(get_session),
+):
+    """Email-link target for thumb up/down votes on a strategic log.
+
+    The signed token encodes (user_id, log_id, intended_vote). The query
+    param ``vote`` is informational (lets the URL be self-describing in
+    the inbox); the canonical vote is what's in the token. If the two
+    disagree the token wins.
+
+    Renders a small thank-you confirmation. No auth required — the token
+    is the auth-equivalent for this single side-effecting action."""
+    from app.services.log_feedback import (
+        FeedbackError, set_vote, verify_feedback_token,
+    )
+
+    payload = verify_feedback_token(token)
+    if payload is None:
+        return templates.TemplateResponse(
+            request, "feedback_thanks.html",
+            {"ok": False, "message": "This link has expired or is invalid.",
+             "log_id": None, "vote": None},
+            status_code=400,
+        )
+
+    try:
+        counts = await set_vote(
+            session,
+            log_id=payload["log_id"],
+            user_id=payload["user_id"],
+            vote=payload["vote"],
+        )
+    except FeedbackError as e:
+        return templates.TemplateResponse(
+            request, "feedback_thanks.html",
+            {"ok": False, "message": str(e), "log_id": payload["log_id"],
+             "vote": payload["vote"]},
+            status_code=400,
+        )
+
+    return templates.TemplateResponse(
+        request, "feedback_thanks.html",
+        {"ok": True,
+         "vote": payload["vote"],
+         "log_id": payload["log_id"],
+         "counts": counts,
+         "message": None},
+    )
+
+
 @router.get("/settings", response_class=HTMLResponse)
 async def settings_page(
     request: Request,

app/services/digest_email.py

@@ -47,6 +47,7 @@ _DIGEST_HTML_TEMPLATE = """\
       </div>
       <div style="height:24px; line-height:24px; font-size:0;">&nbsp;</div>
       <div style="border-top:1px solid {L_border};"></div>
+      {feedback_row}
       <div style="height:14px; line-height:14px; font-size:0;">&nbsp;</div>
       <div class="muted" style="font-size:11px; color:{L_muted};">
         <a href="{unsubscribe_url}" style="color:{L_accent};">Unsubscribe in one click</a>
@@ -70,6 +71,32 @@ def _strip_html_to_text(html_body: str) -> str:
     return text.strip()
 
 
+def _feedback_row_html(
+    feedback_up_url: str | None,
+    feedback_down_url: str | None,
+    light_accent: str,
+    light_muted: str,
+) -> str:
+    """Build the optional 'How was today's read?' row that sits between
+    the digest content and the unsubscribe footer. Empty string when no
+    feedback URLs were supplied (e.g. there's no latest log to vote on)."""
+    if not feedback_up_url or not feedback_down_url:
+        return ""
+    return (
+        '<div style="height:14px; line-height:14px; font-size:0;">&nbsp;</div>'
+        f'<div class="muted" style="font-size:12px; color:{light_muted};">'
+        "How was today&rsquo;s read? "
+        f'<a href="{feedback_up_url}" '
+        f'style="color:{light_accent}; text-decoration:none;">'
+        "&#x1F44D; Helpful</a>"
+        " &middot; "
+        f'<a href="{feedback_down_url}" '
+        f'style="color:{light_accent}; text-decoration:none;">'
+        "&#x1F44E; Not useful</a>"
+        "</div>"
+    )
+
+
 def render_digest_email(
     *,
     kind: str,
@@ -77,10 +104,17 @@ def render_digest_email(
     content_html: str,
     unsubscribe_url: str,
     settings_url: str,
+    feedback_up_url: str | None = None,
+    feedback_down_url: str | None = None,
 ) -> tuple[str, str, str]:
     """Returns (subject, text_body, html_body) for a digest email.
 
-    `kind` is "daily" or "weekly". Anything else raises ValueError."""
+    `kind` is "daily" or "weekly". Anything else raises ValueError.
+
+    When ``feedback_up_url`` and ``feedback_down_url`` are both supplied,
+    a small thumb up/down row is rendered above the unsubscribe footer.
+    Both must be signed-token URLs pointing at /feedback (see
+    ``app.services.log_feedback.sign_feedback_token``)."""
     if kind == "daily":
         label = "Daily"
         subject = f"{branding.BRAND_NAME} · Daily — {date_str}"
@@ -90,6 +124,12 @@ def render_digest_email(
     else:
         raise ValueError(f"unknown digest kind: {kind!r}")
 
+    feedback_row = _feedback_row_html(
+        feedback_up_url, feedback_down_url,
+        light_accent=branding.LIGHT["accent"],
+        light_muted=branding.LIGHT["muted"],
+    )
+
     html_body = _DIGEST_HTML_TEMPLATE.format(
         brand=branding.BRAND_NAME,
         brand_upper=branding.BRAND_NAME.upper(),
@@ -99,6 +139,7 @@ def render_digest_email(
         content_html=content_html,
         unsubscribe_url=unsubscribe_url,
         settings_url=settings_url,
+        feedback_row=feedback_row,
         **{f"L_{k.replace('-', '_')}": v for k, v in branding.LIGHT.items()},
         **{f"D_{k.replace('-', '_')}": v for k, v in branding.DARK.items()},
     )
@@ -109,8 +150,16 @@ def render_digest_email(
         "",
         _strip_html_to_text(content_html),
         "",
+    ]
+    if feedback_up_url and feedback_down_url:
+        text_lines.extend([
+            f"Was this read useful? Helpful: {feedback_up_url}",
+            f"                      Not useful: {feedback_down_url}",
+            "",
+        ])
+    text_lines.extend([
         f"Unsubscribe: {unsubscribe_url}",
         f"Manage preferences: {settings_url}",
-    ]
+    ])
     text_body = "\n".join(text_lines)
     return subject, text_body, html_body

app/services/log_feedback.py

@@ -0,0 +1,177 @@
+"""Thumb up/down votes on strategic-log rows.
+
+The model is one row per (log_id, user_id) — see
+``app/models.py::StrategicLogFeedback``. The UI shows aggregate counts
+only; user attribution is server-side state, not surface state. A user
+can flip up → down (or vice versa) by re-submitting; "clear" deletes
+the row.
+
+For email-digest feedback links we sign a short payload with the same
+itsdangerous serialiser pattern used elsewhere (``app/auth.py``). The
+link is single-purpose: it identifies the (user, log, intended vote)
+combination, lets the recipient click without being logged in, and
+expires after EMAIL_FEEDBACK_TTL_SECONDS.
+"""
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from itsdangerous import BadSignature, SignatureExpired, URLSafeTimedSerializer
+from sqlalchemy import delete, func, select
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from app.config import get_settings
+from app.db import utcnow
+from app.models import StrategicLogFeedback
+
+
+# Email-link tokens are valid for 30 days so a user can click the thumb
+# in last week's Sunday digest. Long enough for slow readers; short
+# enough that the signing-secret rotation can shake stale tokens off.
+EMAIL_FEEDBACK_TTL_SECONDS = 30 * 24 * 60 * 60
+
+# Discriminated enum of acceptable votes. "clear" is a sentinel that
+# means "remove your existing vote, if any".
+VALID_VOTES = ("up", "down", "clear")
+
+
+class FeedbackError(ValueError):
+    """Raised on bad input. Message is safe to surface to the user."""
+
+
+@dataclass(frozen=True)
+class FeedbackCounts:
+    up: int
+    down: int
+    user_vote: str | None  # 'up' | 'down' | None
+
+
+# ---------------------------------------------------------------------------
+# Service
+# ---------------------------------------------------------------------------
+
+
+def _validate_vote(vote: str) -> str:
+    v = (vote or "").strip().lower()
+    if v not in VALID_VOTES:
+        raise FeedbackError(
+            f"vote must be one of {VALID_VOTES!r}; got {vote!r}"
+        )
+    return v
+
+
+async def set_vote(
+    session: AsyncSession,
+    *,
+    log_id: int,
+    user_id: int,
+    vote: str,
+) -> FeedbackCounts:
+    """Insert / update / clear the user's vote on ``log_id``. Returns the
+    resulting aggregate counts plus the user's new vote state.
+
+    "clear" removes the row entirely; "up"/"down" upserts. The unique
+    index on (log_id, user_id) guarantees there's never more than one
+    row per pair."""
+    v = _validate_vote(vote)
+
+    if v == "clear":
+        await session.execute(
+            delete(StrategicLogFeedback)
+            .where(StrategicLogFeedback.log_id == log_id)
+            .where(StrategicLogFeedback.user_id == user_id)
+        )
+        await session.commit()
+        return await get_counts(session, log_id=log_id, user_id=user_id)
+
+    # Upsert by hand — SQLAlchemy's portable dialect doesn't expose
+    # ON DUPLICATE KEY UPDATE across MySQL+SQLite reliably for our test
+    # path, so SELECT then INSERT-or-UPDATE is the simplest correct shape.
+    existing = (await session.execute(
+        select(StrategicLogFeedback)
+        .where(StrategicLogFeedback.log_id == log_id)
+        .where(StrategicLogFeedback.user_id == user_id)
+    )).scalar_one_or_none()
+    if existing is None:
+        session.add(StrategicLogFeedback(
+            log_id=log_id, user_id=user_id, vote=v,
+            created_at=utcnow(), updated_at=utcnow(),
+        ))
+    else:
+        existing.vote = v
+        existing.updated_at = utcnow()
+    await session.commit()
+    return await get_counts(session, log_id=log_id, user_id=user_id)
+
+
+async def get_counts(
+    session: AsyncSession,
+    *,
+    log_id: int,
+    user_id: int | None = None,
+) -> FeedbackCounts:
+    """Aggregate up/down counts for one log, plus the requesting user's
+    own vote (if ``user_id`` is supplied). One indexed query for the
+    counts; a second indexed lookup for the personal vote."""
+    rows = (await session.execute(
+        select(
+            StrategicLogFeedback.vote,
+            func.count(StrategicLogFeedback.id),
+        )
+        .where(StrategicLogFeedback.log_id == log_id)
+        .group_by(StrategicLogFeedback.vote)
+    )).all()
+    counts = {vote: int(n) for vote, n in rows}
+    user_vote: str | None = None
+    if user_id is not None:
+        user_vote = (await session.execute(
+            select(StrategicLogFeedback.vote)
+            .where(StrategicLogFeedback.log_id == log_id)
+            .where(StrategicLogFeedback.user_id == user_id)
+        )).scalar_one_or_none()
+    return FeedbackCounts(
+        up=counts.get("up", 0),
+        down=counts.get("down", 0),
+        user_vote=user_vote,
+    )
+
+
+# ---------------------------------------------------------------------------
+# Email-link token helpers (parallel to app.auth.sign_pending)
+# ---------------------------------------------------------------------------
+
+
+def _feedback_serializer() -> URLSafeTimedSerializer:
+    s = get_settings()
+    secret = s.CASSANDRA_SESSION_SECRET or s.CASSANDRA_TOKEN or "dev-insecure-secret"
+    return URLSafeTimedSerializer(secret, salt="cassandra-log-feedback-v1")
+
+
+def sign_feedback_token(user_id: int, log_id: int, vote: str) -> str:
+    """Signed token for an email-digest thumb link. Encodes the intended
+    (user, log, vote) tuple. The recipient clicks the link without being
+    logged in; the receiving endpoint verifies the signature, applies the
+    vote, and shows a thank-you page."""
+    v = _validate_vote(vote)
+    if v == "clear":
+        raise FeedbackError("clear is not a valid email-link vote")
+    return _feedback_serializer().dumps({
+        "uid": int(user_id), "lid": int(log_id), "v": v,
+    })
+
+
+def verify_feedback_token(token: str) -> dict | None:
+    """Returns {"user_id": int, "log_id": int, "vote": "up"|"down"} on
+    valid + un-expired tokens, or None on bad signature / expired / bad
+    payload. The TTL is ``EMAIL_FEEDBACK_TTL_SECONDS``."""
+    try:
+        data = _feedback_serializer().loads(
+            token, max_age=EMAIL_FEEDBACK_TTL_SECONDS,
+        )
+        return {
+            "user_id": int(data["uid"]),
+            "log_id": int(data["lid"]),
+            "vote": str(data["v"]),
+        }
+    except (BadSignature, SignatureExpired, KeyError, TypeError, ValueError):
+        return None

app/services/output_review.py

@@ -123,8 +123,19 @@ Mark UNCLEAN if the text contains ANY of:
   claim on a *named* instrument is not.
 - Anything else other than the finished, publishable commentary.
 
+Also assign a SCORE 0-10 to the candidate:
+- 10 = exemplary editorial: sharp, well-grounded, no perimeter risk, clean prose.
+- 7-9 = publishable as-is, varying degrees of polish.
+- 4-6 = borderline: scratchpad leakage, mild perimeter drift, or weak structure,
+  but not yet outright unfit. (Anything ≤4 should usually be clean=false.)
+- 1-3 = unfit: clear chain-of-thought, partial / truncated, or financial-advice drift.
+- 0 = unfit by hard rule (deterministic catch territory).
+
+Clean=true implies a score of ~7+; clean=false implies ~4 or lower. Use the
+score to communicate confidence within the verdict.
+
 Return ONLY a JSON object with this exact shape:
-{"clean": true | false, "reason": "<≤20 words, plain text>"}
+{"clean": true | false, "reason": "<≤20 words, plain text>", "score": 0-10}
 No preamble, no markdown fences, no other fields.
 """
 
@@ -171,6 +182,12 @@ class Verdict:
     reason: str
     cost_usd: float | None  # cost of the review call itself, for the ledger
     layer: str = "llm"      # "deterministic" | "llm" | "error"
+    # Integer 0-10. None for error rows; 0 for deterministic-layer hits
+    # (rejected by hard rule, no nuance to score); 0-10 from the model
+    # on LLM-layer verdicts. Stored alongside the content row for
+    # future analysis — see StrategicLog.reviewer_score and
+    # IndicatorSummary.reviewer_score.
+    score: int | None = None
 
 
 # Truncation cap for the audit log's candidate_text column. Generous enough
@@ -199,6 +216,7 @@ async def _record_verdict(
             reason=verdict.reason[:240] if verdict.reason else None,
             layer=verdict.layer,
             model=model,
+            score=verdict.score,
         )
         session.add(row)
         await session.flush()
@@ -237,7 +255,7 @@ async def review_read(
 
     if not candidate or not candidate.strip():
         verdict = Verdict(clean=False, reason="empty candidate", cost_usd=0.0,
-                          layer="deterministic")
+                          layer="deterministic", score=0)
         await _record_verdict(session, surface=surface, candidate=candidate or "",
                               verdict=verdict, model=None)
         return verdict
@@ -250,6 +268,7 @@ async def review_read(
             reason=f"lexicon:{hit.rule}: {hit.snippet}",
             cost_usd=0.0,
             layer="deterministic",
+            score=0,
         )
         log.info("review.deterministic_reject",
                  rule=hit.rule, snippet=hit.snippet, surface=surface)
@@ -293,7 +312,7 @@ async def review_read(
     except Exception as e:
         log.warning("review.call_failed", error=str(e)[:200])
         verdict = Verdict(clean=False, reason=f"reviewer error: {str(e)[:80]}",
-                          cost_usd=None, layer="error")
+                          cost_usd=None, layer="error", score=None)
         await _record_verdict(session, surface=surface, candidate=candidate,
                               verdict=verdict, model=reviewer_model)
         return verdict
@@ -317,7 +336,7 @@ async def review_read(
     except json.JSONDecodeError:
         log.warning("review.parse_failed", preview=result.content[:200])
         verdict = Verdict(clean=False, reason="reviewer returned non-JSON",
-                          cost_usd=result.cost_usd, layer="error")
+                          cost_usd=result.cost_usd, layer="error", score=None)
         await _record_verdict(session, surface=surface, candidate=candidate,
                               verdict=verdict, model=reviewer_model)
         return verdict
@@ -326,13 +345,25 @@ async def review_read(
     reason = parsed.get("reason") or ""
     if not isinstance(clean, bool):
         verdict = Verdict(clean=False, reason="reviewer omitted bool 'clean'",
-                          cost_usd=result.cost_usd, layer="error")
+                          cost_usd=result.cost_usd, layer="error", score=None)
         await _record_verdict(session, surface=surface, candidate=candidate,
                               verdict=verdict, model=reviewer_model)
         return verdict
 
+    # Score is optional and bounded; the verdict is still valid without it.
+    raw_score = parsed.get("score")
+    score: int | None
+    if isinstance(raw_score, bool):
+        # bool is a subclass of int — exclude it explicitly to avoid
+        # silently treating True/False as 1/0.
+        score = None
+    elif isinstance(raw_score, (int, float)):
+        score = max(0, min(10, int(raw_score)))
+    else:
+        score = None
+
     verdict = Verdict(clean=clean, reason=str(reason)[:200],
-                      cost_usd=result.cost_usd, layer="llm")
+                      cost_usd=result.cost_usd, layer="llm", score=score)
     await _record_verdict(session, surface=surface, candidate=candidate,
                           verdict=verdict, model=reviewer_model)
     return verdict
@@ -391,7 +422,7 @@ async def generate_with_review(
                 content=None,
                 verdict=Verdict(clean=False,
                                 reason=f"generator error: {str(e)[:80]}",
-                                cost_usd=None, layer="error"),
+                                cost_usd=None, layer="error", score=None),
                 attempts=attempt,
             )
 
@@ -411,6 +442,7 @@ async def generate_with_review(
     return ReviewedGeneration(
         content=None,
         verdict=last_verdict or Verdict(clean=False, reason="no attempts",
-                                        cost_usd=None, layer="error"),
+                                        cost_usd=None, layer="error",
+                                        score=None),
         attempts=max_attempts,
     )

app/templates/feedback_thanks.html

@@ -0,0 +1,30 @@
+{% extends "public_base.html" %}
+{% block title %}{{ BRAND_NAME }} · Feedback{% endblock %}
+
+{% block main %}
+<section class="public-section" style="max-width:520px; margin:60px auto; text-align:center;">
+  {% if ok %}
+    <h1 class="public-section__head" style="margin-bottom:14px;">
+      {% if vote == 'up' %}Thanks for the thumbs up.{% else %}Thanks for the thumbs down.{% endif %}
+    </h1>
+    <p style="color:var(--muted); font-size:14px; line-height:1.55;">
+      Your vote on this strategic log is recorded.
+      {% if counts %}
+        Current tally: <strong>{{ counts.up }}</strong> &#x1F44D; ·
+        <strong>{{ counts.down }}</strong> &#x1F44E;.
+      {% endif %}
+    </p>
+    <p style="margin-top:24px;">
+      <a href="/" class="btn-primary">Open the dashboard</a>
+    </p>
+  {% else %}
+    <h1 class="public-section__head" style="margin-bottom:14px;">Couldn&rsquo;t record that vote</h1>
+    <p style="color:var(--muted); font-size:14px; line-height:1.55;">
+      {{ message or "Something went wrong; please try again from the dashboard." }}
+    </p>
+    <p style="margin-top:24px;">
+      <a href="/" class="btn-primary">Open the dashboard</a>
+    </p>
+  {% endif %}
+</section>
+{% endblock %}

app/templates/partials/log.html

@@ -9,4 +9,78 @@
      title="Last generated {{ log.generated_at.strftime('%Y-%m-%d %H:%M UTC') }}">
   {{ log.content_html | safe | glossary(tone) }}
 </div>
+
+{% if log.feedback %}
+{# Anonymous-in-UI thumb up/down. Server stores (user, log, vote) for dedup
+   so a vote can be flipped; UI shows aggregate counts only.
+   POST clicks JSON-fetch and swap this partial back in place — no full
+   reload, the log content stays put. #}
+<div class="log-feedback" id="log-feedback-{{ log.id }}"
+     data-log-id="{{ log.id }}"
+     style="display:flex; align-items:center; gap:14px; margin-top:18px;
+            padding-top:14px; border-top:1px solid var(--border);
+            font-size:13px; color:var(--muted);">
+  <span>Was this useful?</span>
+  <button type="button" class="log-feedback__btn log-feedback__btn--up"
+          data-vote="up"
+          aria-pressed="{{ 'true' if log.feedback.user_vote == 'up' else 'false' }}"
+          title="Helpful"
+          style="background:none; border:1px solid var(--border);
+                 padding:4px 10px; border-radius:4px; cursor:pointer;
+                 {% if log.feedback.user_vote == 'up' %}background:var(--accent-bg, #eef);
+                 border-color:var(--accent);{% endif %}">
+    👍 <span class="log-feedback__count">{{ log.feedback.up }}</span>
+  </button>
+  <button type="button" class="log-feedback__btn log-feedback__btn--down"
+          data-vote="down"
+          aria-pressed="{{ 'true' if log.feedback.user_vote == 'down' else 'false' }}"
+          title="Not useful"
+          style="background:none; border:1px solid var(--border);
+                 padding:4px 10px; border-radius:4px; cursor:pointer;
+                 {% if log.feedback.user_vote == 'down' %}background:var(--accent-bg, #fee);
+                 border-color:var(--accent);{% endif %}">
+    👎 <span class="log-feedback__count">{{ log.feedback.down }}</span>
+  </button>
+  <span class="log-feedback__status" aria-live="polite"
+        style="font-size:12px; opacity:0.7;"></span>
+</div>
+<script>
+(function () {
+  var root = document.getElementById('log-feedback-{{ log.id }}');
+  if (!root || root.dataset.wired) return;
+  root.dataset.wired = '1';
+  var logId = root.dataset.logId;
+  var statusEl = root.querySelector('.log-feedback__status');
+  root.querySelectorAll('.log-feedback__btn').forEach(function (btn) {
+    btn.addEventListener('click', async function () {
+      var currentlyPressed = btn.getAttribute('aria-pressed') === 'true';
+      // Clicking the already-pressed vote clears it (toggle off).
+      var vote = currentlyPressed ? 'clear' : btn.dataset.vote;
+      statusEl.textContent = '…';
+      try {
+        var r = await fetch('/api/log/' + logId + '/feedback', {
+          method: 'POST',
+          headers: {'content-type': 'application/json'},
+          body: JSON.stringify({vote: vote}),
+          credentials: 'same-origin',
+        });
+        if (!r.ok) throw new Error('Vote failed: ' + r.status);
+        var data = await r.json();
+        // Update counts + pressed state in place. Server is source of truth.
+        var upBtn = root.querySelector('.log-feedback__btn--up');
+        var downBtn = root.querySelector('.log-feedback__btn--down');
+        upBtn.querySelector('.log-feedback__count').textContent = data.up;
+        downBtn.querySelector('.log-feedback__count').textContent = data.down;
+        upBtn.setAttribute('aria-pressed', data.user_vote === 'up' ? 'true' : 'false');
+        downBtn.setAttribute('aria-pressed', data.user_vote === 'down' ? 'true' : 'false');
+        statusEl.textContent = 'thanks';
+        setTimeout(function () { statusEl.textContent = ''; }, 1800);
+      } catch (e) {
+        statusEl.textContent = 'could not save';
+      }
+    });
+  });
+})();
+</script>
+{% endif %}
 {% endif %}