cc-pushback 0.3.0__tar.gz → 0.5.0__tar.gz

{cc_pushback-0.3.0 → cc_pushback-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cc-pushback
-Version: 0.3.0
+Version: 0.5.0
 Summary: Learn your pushback style from past Claude Code feedback and code reviews, and replicate it with a language model.
 Keywords: 
 Author: Yasyf Mohamedali
@@ -14,11 +14,11 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Typing :: Typed
 Requires-Dist: anyio>=4.4
-Requires-Dist: cc-transcript>=3.0,<4
+Requires-Dist: cc-transcript>=5,<6
 Requires-Dist: click>=8
 Requires-Dist: fastapi>=0.115
 Requires-Dist: pydantic>=2
-Requires-Dist: spawnllm>=0.1.3
+Requires-Dist: spawnllm>=0.4.0
 Requires-Dist: uvicorn>=0.30
 Requires-Dist: pytest>=8.0 ; extra == 'dev'
 Requires-Dist: ty>=0.0.44 ; extra == 'dev'

cc_pushback-0.5.0/cc_pushback/assets/base.css

@@ -0,0 +1,66 @@
+:root{--bg:#0d1117;--panel:#161b22;--border:#30363d;--fg:#e6edf3;--muted:#8b949e;--accent:#58a6ff}
+*{box-sizing:border-box}
+body{margin:0;background:var(--bg);color:var(--fg);font:14px/1.5 ui-monospace,SFMono-Regular,Menlo,monospace}
+h1,h2{font-weight:600}
+header.top{padding:24px;border-bottom:1px solid var(--border)}
+header.top .sub{color:var(--muted)}
+section{padding:16px 24px}
+.stat-cards{display:flex;gap:12px;flex-wrap:wrap}
+.stat{background:var(--panel);border:1px solid var(--border);border-radius:8px;padding:12px 16px}
+.stat .n{font-size:20px;font-weight:600}
+.stat .l{color:var(--muted);font-size:12px}
+table.dist{border-collapse:collapse;margin-top:14px}
+table.dist td{padding:2px 10px 2px 0;white-space:nowrap}
+.bar{display:inline-block;height:10px;background:var(--accent);border-radius:3px;vertical-align:middle}
+.narrative{background:var(--panel);border:1px solid var(--border);border-left:3px solid var(--accent);
+border-radius:8px;padding:14px 18px;max-width:80ch;margin-top:14px}
+.card{background:var(--panel);border:1px solid var(--border);border-radius:8px;padding:12px 16px;margin:12px 0}
+.card header{display:flex;gap:8px;align-items:center;flex-wrap:wrap;margin-bottom:8px}
+.badge{font-size:11px;padding:2px 8px;border-radius:10px;background:#21262d;border:1px solid var(--border)}
+.badge-transcript_message{color:#8b949e}.badge-review_comment{color:#7ee787}.badge-plan_review{color:#d2a8ff}
+.badge-interrupt_rejection{color:#ff7b72}.badge-superset_issue{color:#ffa657}
+time{color:var(--muted);font-size:12px}
+.chip{font-size:11px;color:var(--muted);background:#21262d;border-radius:6px;padding:1px 6px}
+.text pre{white-space:pre-wrap;word-break:break-word;margin:0;font:inherit}
+details.ctx{margin-top:10px}
+details.ctx summary{color:var(--accent);cursor:pointer}
+.turn{border-left:2px solid var(--border);padding:4px 0 4px 10px;margin:6px 0}
+.turn .role{font-size:10px;text-transform:uppercase;color:var(--muted)}
+.turn .tools{font-size:10px;color:var(--accent);margin-left:6px}
+.turn pre{white-space:pre-wrap;word-break:break-word;margin:2px 0 0;font:inherit;color:var(--muted)}
+.turn-user pre{color:var(--fg)}
+.turn-trigger{border-left-color:var(--accent)}
+.turn-trigger .role::after{content:" \2190 pushed back on";color:var(--accent)}
+.lineage{display:flex;flex-direction:column;gap:14px}
+.stage{background:var(--panel);border:1px solid var(--border);border-radius:8px;padding:12px 16px}
+.stage h3{margin:0 0 10px;font-size:13px;color:var(--muted);text-transform:uppercase;letter-spacing:.04em}
+.stage-detector{border-left:3px solid var(--muted)}
+.stage-judge{border-left:3px solid var(--accent)}
+.stage-auditor{border-left:3px solid #d2a8ff}
+.stage-refiner{border-left:3px solid #7ee787}
+.stage-golden{border-left:3px solid #ffa657}
+.verdict,.pair{border:1px solid var(--border);border-radius:6px;padding:8px 10px;margin:8px 0}
+.vhead{display:flex;gap:6px;align-items:center;flex-wrap:wrap;margin-bottom:6px}
+.vsum,.vrat,.paction,.pcomplaint{white-space:pre-wrap;word-break:break-word;margin:2px 0;font:inherit}
+.vrat,.pcomplaint{color:var(--muted)}
+.pverbatim{border-left:2px solid #7ee787;margin:6px 0;padding:2px 0 2px 10px;color:var(--fg)}
+.orig pre{white-space:pre-wrap;word-break:break-word;margin:0 0 8px;color:var(--muted)}
+mark{background:#7ee78733;color:var(--fg);border-radius:3px}
+.evidence{margin-top:8px}
+.panes{display:flex;gap:8px;flex-wrap:wrap;margin:6px 0}
+.pane{flex:1;min-width:220px;border:1px solid var(--border);border-radius:6px;padding:6px 8px}
+.pane .plabel{font-size:10px;text-transform:uppercase;color:var(--muted);margin-bottom:4px}
+.pane .del,.pane .ins{white-space:pre-wrap;word-break:break-word;padding:0 4px;border-radius:3px}
+.pane .del{background:#ff7b7222}
+.pane .ins{background:#7ee78722}
+.pane .del::before{content:"- ";color:#ff7b72}
+.pane .ins::before{content:"+ ";color:#7ee787}
+.chip-git{color:#ffa657}
+.flip{font-size:11px;color:#ffa657}
+.agree{font-size:11px;color:#7ee787}
+.disagree{font-size:11px;color:#ff7b72}
+.muted{color:var(--muted)}
+.badge.pass{color:#7ee787}.badge.fail{color:#ff7b72}
+.cat-wrong_approach{color:#ff7b72}.cat-incorrect_change{color:#ffa657}.cat-unwanted_action{color:#f0883e}
+.cat-style_violation{color:#d2a8ff}.cat-premature{color:#79c0ff}
+.cat-operational_directive,.cat-status_update,.cat-new_task,.cat-question,.cat-other{color:#8b949e}

cc_pushback-0.5.0/cc_pushback/assets/dashboard.css

@@ -0,0 +1,58 @@
+header.top{display:flex;justify-content:space-between;align-items:flex-start;gap:16px}
+.head-right{display:flex;align-items:center;gap:12px}
+#stat-strip{color:var(--muted);font-size:12px;text-align:right}
+#stats-toggle{background:var(--panel);color:var(--fg);border:1px solid var(--border);
+border-radius:8px;padding:4px 12px;cursor:pointer;font:inherit}
+#stats.hidden{display:none}
+.comp h2{font-size:13px;color:var(--muted);text-transform:uppercase;letter-spacing:.04em;margin:18px 0 0}
+.comp table.dist td{padding:3px 12px 3px 0}
+.app{display:flex;align-items:flex-start}
+#filters{width:236px;flex:none;position:sticky;top:0;max-height:100vh;overflow:auto;
+padding:16px;border-right:1px solid var(--border)}
+.facet-group{margin-bottom:18px}
+.facet-group h3{font-size:11px;text-transform:uppercase;letter-spacing:.05em;color:var(--muted);margin:0 0 8px}
+.facet-row{display:flex;align-items:center;gap:8px;width:100%;text-align:left;background:none;
+border:0;color:var(--fg);font:inherit;padding:4px 6px;border-radius:6px;cursor:pointer}
+.facet-row:hover{background:var(--panel)}
+.facet-row.on{background:var(--panel);box-shadow:inset 2px 0 0 var(--accent)}
+.facet-row.empty{opacity:.4}
+.facet-row .fcheck{width:12px;color:var(--accent)}
+.facet-row .fv{overflow:hidden;text-overflow:ellipsis;white-space:nowrap;max-width:130px}
+.facet-count{margin-left:auto;color:var(--muted);font-size:11px}
+main{flex:1;min-width:0;padding:0 24px 48px}
+#toolbar{display:flex;gap:10px;align-items:center;flex-wrap:wrap;position:sticky;top:0;
+background:var(--bg);padding:14px 0;z-index:2;border-bottom:1px solid var(--border)}
+.views{display:flex;gap:6px}
+.view-btn{background:var(--panel);color:var(--fg);border:1px solid var(--border);border-radius:14px;
+padding:4px 12px;cursor:pointer;font:inherit}
+.view-btn.active{background:var(--accent);color:#0d1117;border-color:var(--accent)}
+#search{flex:1;min-width:200px;background:var(--panel);color:var(--fg);border:1px solid var(--border);
+border-radius:6px;padding:6px 10px;font:inherit}
+#count{color:var(--muted)}
+#active{display:flex;flex-wrap:wrap;gap:6px;padding:10px 0}
+#active:empty{display:none}
+.achip{background:var(--panel);border:1px solid var(--border);border-radius:12px;color:var(--fg);
+font:inherit;font-size:12px;padding:2px 10px;cursor:pointer}
+.achip:hover{border-color:var(--accent)}
+.achip.clear{color:var(--muted)}
+.card{cursor:pointer}
+.card:hover{border-color:var(--accent)}
+.card.sel{border-color:var(--accent);box-shadow:0 0 0 1px var(--accent)}
+.card-head{display:flex;gap:8px;align-items:center;flex-wrap:wrap;margin-bottom:8px}
+.complaint{color:var(--accent);margin-top:6px}
+.chip-lang{color:var(--accent);border:1px solid var(--accent)}
+.st-refined{color:#7ee787}.st-accepted{color:#58a6ff}.st-noise{color:#8b949e}.st-unjudged{color:#6e7681}
+details.diff{margin-top:8px}
+details.diff summary{color:var(--accent);cursor:pointer}
+#backdrop{position:fixed;inset:0;background:#00000066;opacity:0;pointer-events:none;
+transition:opacity .22s ease;z-index:10}
+#backdrop.open{opacity:1;pointer-events:auto}
+#detail{position:fixed;top:0;right:0;height:100vh;width:min(760px,92vw);background:var(--bg);
+border-left:1px solid var(--border);transform:translateX(100%);transition:transform .22s ease;
+z-index:20;overflow:auto;box-shadow:-16px 0 40px #00000066}
+#detail.open{transform:translateX(0)}
+#detail-bar{position:sticky;top:0;display:flex;justify-content:flex-end;padding:8px;
+background:var(--bg);border-bottom:1px solid var(--border)}
+#detail-close{background:var(--panel);color:var(--fg);border:1px solid var(--border);
+border-radius:8px;width:30px;height:30px;cursor:pointer;font:inherit}
+#detail-body{padding:16px 24px}

cc_pushback-0.5.0/cc_pushback/assets/index.html

@@ -0,0 +1,44 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>cc-pushback dashboard</title>
+<link rel="stylesheet" href="/static/base.css">
+<link rel="stylesheet" href="/static/dashboard.css">
+</head>
+<body>
+<header class="top">
+  <div>
+    <h1>cc-pushback — training pairs</h1>
+    <div class="sub">refined pairs &amp; their lineage</div>
+  </div>
+  <div class="head-right">
+    <span id="stat-strip"></span>
+    <button id="stats-toggle">stats ▾</button>
+  </div>
+</header>
+<section id="stats" class="hidden"></section>
+<div class="app">
+  <aside id="filters"></aside>
+  <main>
+    <div id="toolbar">
+      <div class="views">
+        <button class="view-btn active" data-view="pairs">refined pairs</button>
+        <button class="view-btn" data-view="candidates">all candidates</button>
+      </div>
+      <input id="search" type="search" placeholder="search…">
+      <span id="count"></span>
+    </div>
+    <div id="active"></div>
+    <div id="list"></div>
+  </main>
+</div>
+<div id="backdrop"></div>
+<aside id="detail">
+  <div id="detail-bar"><button id="detail-close">✕</button></div>
+  <div id="detail-body"><p class="muted">select a row to see its lineage</p></div>
+</aside>
+<script type="module" src="/static/js/main.js"></script>
+</body>
+</html>

cc_pushback-0.5.0/cc_pushback/assets/js/cards.js

@@ -0,0 +1,38 @@
+import { state } from "./state.js";
+import { esc, chip, badge, diffPane } from "./dom.js";
+
+export function evidenceHtml(ev) {
+  if (!ev) return "";
+  const git = ev.source === "git" ? '<span class="chip chip-git">git</span>' : "";
+  const correct = ev.correct ? diffPane("correct", ev.correct) : "";
+  return `<details class="diff"><summary>code evidence</summary>` +
+    `<div class="vhead"><span class="chip">${esc(ev.file_path)}</span>${git}</div>` +
+    `<div class="panes">${diffPane("incorrect", ev.incorrect)}${correct}</div></details>`;
+}
+
+function pairRow(r) {
+  const file = r.evidence ? `<span class="chip">${esc(r.evidence.file_path)}</span>` : "";
+  const lang = r.language ? `<span class="chip chip-lang">${esc(r.language)}</span>` : "";
+  return `<article class="card" data-key="${esc(r.dedup_key)}"><header class="card-head">` +
+    badge("cat-" + (r.category || "other"), r.category || "—") + badge("badge-" + r.source_kind, r.source_kind) +
+    `${chip(r.project)}<span class="chip">pair ${r.pair_index}</span>${file}${lang}</header>` +
+    `<div class="text"><pre>${esc(r.action)}</pre></div>` +
+    `<blockquote class="pverbatim">${esc(r.complaint_verbatim)}</blockquote>` +
+    `<div class="complaint">↳ ${esc(r.complaint)}</div>${evidenceHtml(r.evidence)}</article>`;
+}
+
+function candRow(r) {
+  const cat = r.category ? badge("cat-" + r.category, r.category) : "";
+  const pc = r.pair_count ? `<span class="chip">${r.pair_count} pairs</span>` : "";
+  const flip = r.flipped ? '<span class="flip">flip</span>' : "";
+  const agree = r.agreement ? `<span class="${esc(r.agreement)}">${esc(r.agreement)}</span>` : "";
+  const gold = r.golden ? badge(r.golden, "golden " + r.golden) : "";
+  return `<article class="card" data-key="${esc(r.dedup_key)}"><header class="card-head">` +
+    badge("st-" + r.status, r.status) + cat + badge("badge-" + r.source_kind, r.source_kind) +
+    `${chip(r.project)}${pc}${flip}${agree}${gold}</header>` +
+    `<div class="text"><pre>${esc(r.text)}</pre></div></article>`;
+}
+
+export function rowHtml(r) {
+  return state.view === "pairs" ? pairRow(r) : candRow(r);
+}

cc_pushback-0.5.0/cc_pushback/assets/js/detail.js

@@ -0,0 +1,20 @@
+import { state } from "./state.js";
+import { lineageHtml } from "./lineage.js";
+
+export function openDetail(key) {
+  for (const c of state.cards) c.classList.toggle("sel", c.dataset.key === key);
+  document.getElementById("detail").classList.add("open");
+  document.getElementById("backdrop").classList.add("open");
+  const body = document.getElementById("detail-body");
+  body.innerHTML = '<p class="muted">loading…</p>';
+  body.scrollTop = 0;
+  fetch("/api/lineage/" + encodeURIComponent(key))
+    .then((res) => res.ok ? res.json().then(lineageHtml) : '<p class="muted">no lineage</p>')
+    .then((html) => { body.innerHTML = html; });
+}
+
+export function closeDetail() {
+  document.getElementById("detail").classList.remove("open");
+  document.getElementById("backdrop").classList.remove("open");
+  for (const c of state.cards) c.classList.remove("sel");
+}

cc_pushback-0.5.0/cc_pushback/assets/js/dom.js

@@ -0,0 +1,27 @@
+// Small HTML-building helpers shared across the renderers. esc() is the single
+// escape point — every value interpolated into markup must pass through it.
+export function esc(s) {
+  return (s == null ? "" : String(s))
+    .replaceAll("&", "&")
+    .replaceAll("<", "&lt;")
+    .replaceAll(">", "&gt;")
+    .replaceAll('"', "&quot;")
+    .replaceAll("'", "&#x27;");
+}
+
+export function chip(t) {
+  return t ? `<span class="chip">${esc(t)}</span>` : "";
+}
+
+export function badge(cls, t) {
+  return `<span class="badge ${cls}">${esc(t)}</span>`;
+}
+
+function diffLines(cls, text) {
+  return text.split("\n").map((l) => `<div class="${cls}">${esc(l)}</div>`).join("");
+}
+
+export function diffPane(label, side) {
+  return `<div class="pane"><div class="plabel">${esc(label)}</div>` +
+    diffLines("del", side.old) + diffLines("ins", side.new) + "</div>";
+}

cc_pushback-0.5.0/cc_pushback/assets/js/filters.js

@@ -0,0 +1,116 @@
+import { state } from "./state.js";
+import { esc, badge } from "./dom.js";
+
+// Facet groups, ordered as they render in the sidebar. `views` gates each group
+// to the view where it means something; list facets are multi-select with
+// drill-down counts, toggle facets are booleans.
+export const GROUPS = [
+  { label: "Status", views: ["candidates"], list: { key: "status", get: (r) => r.status } },
+  { label: "Category", views: ["pairs", "candidates"], list: { key: "category", get: (r) => r.category, badge: "cat" } },
+  { label: "Kind", views: ["pairs", "candidates"], list: { key: "source_kind", get: (r) => r.source_kind, badge: "kind" } },
+  { label: "Project", views: ["pairs", "candidates"], list: { key: "project", get: (r) => r.project } },
+  { label: "Language", views: ["pairs"], list: { key: "language", get: (r) => r.language } },
+  { label: "Evidence", views: ["pairs"], toggles: [{ key: "evidence", text: "has code", match: (r) => !!r.evidence }] },
+  { label: "Quality", views: ["candidates"], toggles: [
+    { key: "golden", text: "golden", match: (r) => !!r.golden },
+    { key: "flipped", text: "flipped", match: (r) => !!r.flipped },
+    { key: "disagree", text: "disagreements", match: (r) => r.agreement === "disagree" },
+  ] },
+];
+
+export function rowText(r) {
+  const parts = [];
+  const walk = (v) => {
+    if (v == null) return;
+    if (typeof v === "object") Object.values(v).forEach(walk);
+    else parts.push(String(v));
+  };
+  walk(r);
+  return parts.join(" ").toLowerCase();
+}
+
+function groupsFor(view) {
+  return GROUPS.filter((g) => g.views.includes(view));
+}
+
+function matchRow(r, except) {
+  for (const g of groupsFor(state.view)) {
+    if (g.list) {
+      if (g.list.key !== except) {
+        const sel = state.picks[g.list.key];
+        if (sel && sel.size && !sel.has(g.list.get(r))) return false;
+      }
+    } else {
+      for (const t of g.toggles) {
+        if (t.key !== except && state.flags[t.key] && !t.match(r)) return false;
+      }
+    }
+  }
+  return !state.q || r._text.includes(state.q);
+}
+
+function listCounts(facet) {
+  const m = new Map();
+  for (const r of state.rows) {
+    if (matchRow(r, facet.key)) {
+      const v = facet.get(r);
+      if (v != null) m.set(v, (m.get(v) || 0) + 1);
+    }
+  }
+  return m;
+}
+
+function facetGroupHtml(g) {
+  if (g.list) {
+    const counts = listCounts(g.list);
+    const sel = state.picks[g.list.key] || new Set();
+    const vals = [...new Set(state.rows.map(g.list.get).filter((v) => v != null))].sort();
+    if (!vals.length) return "";
+    const body = vals.map((v) => {
+      const n = counts.get(v) || 0;
+      const on = sel.has(v);
+      const label = g.list.badge === "cat" ? badge("cat-" + v, v)
+        : g.list.badge === "kind" ? badge("badge-" + v, v) : `<span class="fv">${esc(v)}</span>`;
+      return `<button class="facet-row${on ? " on" : ""}${n ? "" : " empty"}" data-facet="${esc(g.list.key)}" ` +
+        `data-value="${esc(v)}"><span class="fcheck">${on ? "✓" : ""}</span>${label}` +
+        `<span class="facet-count">${n}</span></button>`;
+    }).join("");
+    return `<div class="facet-group"><h3>${esc(g.label)}</h3>${body}</div>`;
+  }
+  const body = g.toggles.map((t) => {
+    const n = state.rows.filter((r) => matchRow(r, t.key) && t.match(r)).length;
+    const on = !!state.flags[t.key];
+    return `<button class="facet-row${on ? " on" : ""}${n ? "" : " empty"}" data-toggle="${esc(t.key)}">` +
+      `<span class="fcheck">${on ? "✓" : ""}</span><span class="fv">${esc(t.text)}</span>` +
+      `<span class="facet-count">${n}</span></button>`;
+  }).join("");
+  return `<div class="facet-group"><h3>${esc(g.label)}</h3>${body}</div>`;
+}
+
+function renderFacets() {
+  document.getElementById("filters").innerHTML = groupsFor(state.view).map(facetGroupHtml).join("");
+}
+
+function chipsHtml() {
+  const items = [];
+  for (const g of groupsFor(state.view)) {
+    if (g.list) for (const v of state.picks[g.list.key] || []) items.push([g.list.key, v, v]);
+    else for (const t of g.toggles) if (state.flags[t.key]) items.push(["@" + t.key, t.key, t.text]);
+  }
+  if (!items.length) return "";
+  return items.map(([k, v, label]) => `<button class="achip" data-k="${esc(k)}" data-v="${esc(v)}">${esc(label)} ✕</button>`).join("") +
+    '<button class="achip clear" data-clear="1">clear all ✕</button>';
+}
+
+export function apply() {
+  state.q = document.getElementById("search").value.trim().toLowerCase();
+  let shown = 0;
+  state.rows.forEach((r, i) => {
+    const ok = matchRow(r);
+    state.cards[i].style.display = ok ? "" : "none";
+    if (ok) shown++;
+  });
+  document.getElementById("count").textContent = shown + " / " + state.rows.length;
+  renderFacets();
+  document.getElementById("active").innerHTML = chipsHtml();
+}

cc_pushback-0.5.0/cc_pushback/assets/js/lineage.js

@@ -0,0 +1,84 @@
+import { esc, diffPane } from "./dom.js";
+
+// Renders one candidate's pipeline trail as a five-stage rail from the JSON the
+// `/api/lineage/{key}` endpoint returns. The markup and class names mirror the
+// shared stylesheet (base.css) exactly.
+
+function goldenLabel(isPushback) {
+  return isPushback ? "pushback" : "noise";
+}
+
+function metaChips(meta) {
+  return meta.map((m) => `<span class="chip">${esc(m)}</span>`).join("");
+}
+
+function turnHtml(t) {
+  const cls = "turn turn-" + t.role + (t.is_trigger ? " turn-trigger" : "");
+  const tools = t.tool_calls ? `<span class="tools">${t.tool_calls} tool calls</span>` : "";
+  return `<div class="${cls}"><span class="role">${esc(t.role)}</span>${tools}<pre>${esc(t.preview)}</pre></div>`;
+}
+
+function contextHtml(ctx) {
+  if (!ctx) return "";
+  return `<details class="ctx"><summary>context (${ctx.turns.length} turns)</summary>${ctx.turns.map(turnHtml).join("")}</details>`;
+}
+
+function verdictHtml(v) {
+  const flag = v.flipped ? '<span class="flip">flipped across versions</span>' : "";
+  return `<div class="verdict stage-${esc(v.role)}"><div class="vhead">` +
+    `<span class="badge cat-${esc(v.category)}">${esc(v.category)}</span>` +
+    `<span class="chip">${esc(v.role)} v${v.prompt_version} · ${esc(v.model)}</span>` +
+    `<span class="chip">conf ${v.confidence.toFixed(2)}</span>` +
+    `<span class="chip">${goldenLabel(v.is_pushback)}</span>${flag}</div>` +
+    `<pre class="vsum">${esc(v.what_claude_did)}</pre>` +
+    `<pre class="vrat">${esc(v.rationale)}</pre></div>`;
+}
+
+function auditorHtml(a) {
+  if (!a) return '<p class="muted">not audited</p>';
+  return verdictHtml(a) + `<span class="${esc(a.agreement)}">${esc(a.agreement)} with judge</span>`;
+}
+
+function evidenceHtml(ev) {
+  const git = ev.source === "git" ? '<span class="chip chip-git">git</span>' : "";
+  const correct = ev.correct ? diffPane("correct", ev.correct) : "";
+  return `<div class="evidence"><div class="vhead"><span class="chip">${esc(ev.file_path)}</span>${git}</div>` +
+    `<div class="panes">${diffPane("incorrect", ev.incorrect)}${correct}</div></div>`;
+}
+
+function highlightSpans(text, spans) {
+  let out = esc(text);
+  for (const span of spans) out = out.split(esc(span)).join(`<mark>${esc(span)}</mark>`);
+  return out;
+}
+
+function refinerHtml(refiner) {
+  if (!refiner.pairs.length) return '<p class="muted">not yet refined</p>';
+  const cards = refiner.pairs.map((p) =>
+    `<div class="pair"><div class="vhead"><span class="chip">pair ${p.pair_index}</span>` +
+    `<span class="chip">v${p.prompt_version} · ${esc(p.model)}</span></div>` +
+    `<pre class="paction">${esc(p.action)}</pre>` +
+    `<blockquote class="pverbatim">${esc(p.complaint_verbatim)}</blockquote>` +
+    `<pre class="pcomplaint">${esc(p.complaint)}</pre>` +
+    `${p.evidence ? evidenceHtml(p.evidence) : ""}</div>`).join("");
+  return `<div class="orig"><pre>${highlightSpans(refiner.original, refiner.spans)}</pre></div>${cards}`;
+}
+
+function goldenHtml(g) {
+  if (!g) return '<p class="muted">not in golden set</p>';
+  return `<span class="badge ${esc(g.verdict)}">golden ${esc(g.verdict)} · expected ${esc(goldenLabel(g.expected))}</span>`;
+}
+
+export function lineageHtml(d) {
+  const det = d.detector;
+  return `<div class="lineage">` +
+    `<section class="stage stage-detector"><h3>1 · detector</h3>` +
+    `<header class="card-head"><span class="badge badge-${esc(det.source_kind)}">${esc(det.source_kind)}</span>` +
+    `<time>${esc(det.occurred_at)}</time>${metaChips(det.meta)}</header>` +
+    `<div class="text"><pre>${esc(det.text)}</pre></div>${contextHtml(det.context)}</section>` +
+    `<section class="stage stage-judge"><h3>2 · judge</h3>${d.judge.map(verdictHtml).join("") || '<p class="muted">unjudged</p>'}</section>` +
+    `<section class="stage stage-auditor"><h3>3 · auditor</h3>${auditorHtml(d.auditor)}</section>` +
+    `<section class="stage stage-refiner"><h3>4 · refiner — atomic pairs</h3>${refinerHtml(d.refiner)}</section>` +
+    `<section class="stage stage-golden"><h3>5 · golden gate</h3>${goldenHtml(d.golden)}</section>` +
+    `</div>`;
+}

cc_pushback-0.5.0/cc_pushback/assets/js/main.js

@@ -0,0 +1,64 @@
+import { state } from "./state.js";
+import { rowHtml } from "./cards.js";
+import { apply, rowText } from "./filters.js";
+import { loadStats } from "./stats.js";
+import { openDetail, closeDetail } from "./detail.js";
+
+function render() {
+  const listEl = document.getElementById("list");
+  listEl.innerHTML = state.rows.map(rowHtml).join("") || '<p class="muted">none</p>';
+  state.cards = [...listEl.querySelectorAll(".card")];
+  for (const c of state.cards) c.addEventListener("click", () => openDetail(c.dataset.key));
+  for (const s of listEl.querySelectorAll("details.diff summary")) s.addEventListener("click", (e) => e.stopPropagation());
+  apply();
+}
+
+async function load() {
+  const data = await (await fetch(state.view === "pairs" ? "/api/pairs" : "/api/candidates")).json();
+  state.rows = state.view === "pairs" ? data.pairs : data.candidates;
+  state.rows.forEach((r) => { r._text = rowText(r); });
+  state.picks = {};
+  state.flags = {};
+  document.getElementById("search").value = "";
+  render();
+}
+
+for (const b of document.querySelectorAll(".view-btn")) b.addEventListener("click", () => {
+  state.view = b.dataset.view;
+  for (const x of document.querySelectorAll(".view-btn")) x.classList.toggle("active", x === b);
+  closeDetail();
+  load();
+});
+
+document.getElementById("search").addEventListener("input", apply);
+
+document.getElementById("filters").addEventListener("click", (e) => {
+  const row = e.target.closest(".facet-row");
+  if (!row) return;
+  if (row.dataset.facet) {
+    const set = state.picks[row.dataset.facet] || (state.picks[row.dataset.facet] = new Set());
+    set.has(row.dataset.value) ? set.delete(row.dataset.value) : set.add(row.dataset.value);
+  } else {
+    state.flags[row.dataset.toggle] = !state.flags[row.dataset.toggle];
+  }
+  apply();
+});
+
+document.getElementById("active").addEventListener("click", (e) => {
+  const c = e.target.closest(".achip");
+  if (!c) return;
+  if (c.dataset.clear) { state.picks = {}; state.flags = {}; }
+  else if (c.dataset.k[0] === "@") state.flags[c.dataset.k.slice(1)] = false;
+  else state.picks[c.dataset.k].delete(c.dataset.v);
+  apply();
+});
+
+document.getElementById("backdrop").addEventListener("click", closeDetail);
+document.getElementById("detail-close").addEventListener("click", closeDetail);
+document.addEventListener("keydown", (e) => { if (e.key === "Escape") closeDetail(); });
+document.getElementById("stats-toggle").addEventListener("click", (e) => {
+  e.target.textContent = document.getElementById("stats").classList.toggle("hidden") ? "stats ▾" : "stats ▴";
+});
+
+loadStats();
+load();

cc_pushback-0.5.0/cc_pushback/assets/js/state.js

@@ -0,0 +1,10 @@
+// Shared mutable client state. ES-module live bindings make this single object
+// the one source of truth every module reads and mutates.
+export const state = {
+  view: "pairs",
+  rows: [],
+  cards: [],
+  picks: {},
+  flags: {},
+  q: "",
+};

cc_pushback-0.5.0/cc_pushback/assets/js/stats.js

@@ -0,0 +1,37 @@
+import { esc } from "./dom.js";
+
+function statHtml(label, val) {
+  return `<div class="stat"><div class="n">${esc(val)}</div><div class="l">${esc(label)}</div></div>`;
+}
+
+function compHtml(comp) {
+  const cats = Object.keys(comp);
+  if (!cats.length) return "";
+  const kinds = [...new Set(cats.flatMap((c) => Object.keys(comp[c])))].sort();
+  const max = Math.max(1, ...cats.flatMap((c) => kinds.map((k) => comp[c][k] || 0)));
+  const head = `<tr><td></td>${kinds.map((k) => `<td>${esc(k)}</td>`).join("")}<td>total</td></tr>`;
+  const body = cats.map((c) => {
+    const tot = kinds.reduce((a, k) => a + (comp[c][k] || 0), 0);
+    const cells = kinds.map((k) => {
+      const n = comp[c][k] || 0;
+      return `<td>${n ? `<span class="bar" style="width:${Math.round(40 * n / max)}px"></span> ${n}` : "·"}</td>`;
+    }).join("");
+    return `<tr><td><span class="badge cat-${esc(c)}">${esc(c)}</span></td>${cells}<td>${tot}</td></tr>`;
+  }).join("");
+  return `<div class="comp"><h2>composition · accepted by category × kind</h2>` +
+    `<table class="dist"><tbody>${head}${body}</tbody></table></div>`;
+}
+
+export async function loadStats() {
+  const s = await (await fetch("/api/stats")).json();
+  const p = s.pipeline, c = s.corpus;
+  const statCards = [["events", c.total], ["accepted", p.accepted], ["refined", p.refined], ["pending", p.pending],
+    ["atomic pairs", p.total_pairs], ["pairs/event", p.pairs_per_event.toFixed(2)], ["noise", p.noise_judged],
+    ["unjudged", p.unjudged], ["audited", p.audited], ["disagree", p.disagree], ["flips", p.flips],
+    ["golden", p.golden_pass + "/" + p.golden_total]];
+  document.getElementById("stats").innerHTML = `<div class="stat-cards">${statCards.map((x) => statHtml(x[0], x[1])).join("")}</div>` +
+    compHtml(p.by_category_kind) +
+    (s.narrative ? `<div class="narrative">${esc(s.narrative)}</div>` : "");
+  document.getElementById("stat-strip").textContent =
+    `${c.total} events · ${p.accepted} accepted · ${p.refined} refined · ${p.total_pairs} pairs`;
+}

cc_pushback-0.5.0/cc_pushback/claude.py

@@ -0,0 +1,56 @@
+"""A thin shell-out to the ``claude`` CLI for a single headless text completion.
+
+The run is driven by the shared ``spawnllm`` library: :func:`spawnllm.run`
+spawns ``claude``, retries transient envelopes, and returns captured output, and
+:func:`spawnllm.parse_result_envelope` unwraps the ``{is_error, result}`` JSON.
+It uses the user's existing Claude Code auth (no API key), so the package stays
+offline unless ``claude`` is actually on the path. The structured path lives in
+:mod:`cc_transcript.judge` (``run_structured``/``structured_judge``).
+"""
+
+from __future__ import annotations
+
+import shutil
+
+from spawnllm import ClaudeConfig, RunSpec, parse_result_envelope, run
+
+CLAUDE_TIMEOUT = 180
+
+
+def claude_available() -> bool:
+    """Returns whether the ``claude`` CLI is on ``PATH``."""
+    return shutil.which("claude") is not None
+
+
+async def run_claude(prompt: str, *, system: str, model: str) -> str:
+    """Runs one headless ``claude`` turn and returns its text result.
+
+    Args:
+        prompt: The user message to send.
+        system: The system prompt.
+        model: The model to run, for example ``claude-sonnet-4-6``.
+
+    Returns:
+        The assistant's text response — the ``result`` field of the JSON output.
+
+    Raises:
+        subprocess.SubprocessError: If ``claude`` exits non-zero, times out, or
+            reports an error in its JSON envelope.
+    """
+    rr = await run(
+        RunSpec(
+            prompt=prompt,
+            model=model,
+            timeout=CLAUDE_TIMEOUT,
+            provider_configs={
+                "claude": ClaudeConfig(
+                    system_prompt=system,
+                    max_turns=1,
+                    tools="",
+                    disable_slash_commands=True,
+                    output_format="json",
+                )
+            },
+        )
+    )
+    return parse_result_envelope(rr.stdout.encode(), argv=[], stderr=rr.stderr.encode())