Draft: coodie gets a day job

.gitignore

@@ -12,3 +12,4 @@ Thumbs.db
 
 vendor/
 .bundle/
+_preview/out/

_preview/build.py

@@ -0,0 +1,100 @@
+"""Build a self-contained preview of a draft post for publishing as a claude.ai Artifact.
+
+Usage: python _preview/build.py [post-html-under-_site]
+Run after `jekyll build --drafts` (or while `jekyll serve --drafts` is running).
+Writes _preview/out/index.html plus the CSS, fonts and images it uses.
+"""
+
+import json
+import os
+import re
+import shutil
+import sys
+from pathlib import Path
+
+REPO = Path(__file__).resolve().parent.parent
+SITE = REPO / "_site"
+OUT = Path(os.environ.get("PREVIEW_OUT", REPO / "_preview" / "out"))
+POST = sys.argv[1] if len(sys.argv) > 1 else "python/2026/10/11/coodie-goes-to-production.html"
+THEME = "assets/themes/the-program"
+
+html = (SITE / POST).read_text()
+title = re.search(r"<title>(.*?)</title>", html, re.S).group(1).strip()
+body = re.search(r"<body>(.*)</body>", html, re.S).group(1)
+
+# Drop everything that needs a third-party host: share buttons, comments, scripts.
+body = re.sub(r"<!-- AddThis Button BEGIN -->.*?<!-- AddThis Button END -->", "", body, flags=re.S)
+body = re.sub(r'<div class="addthis_toolbox.*?</div>', "", body, flags=re.S)
+body = re.sub(r'<div class="comment">.*?</div>\s*</div><!-- misc-content -->', "</div><!-- misc-content -->", body, flags=re.S)
+body = re.sub(r"<script.*?</script>", "", body, flags=re.S)
+body = re.sub(r"<noscript>.*?</noscript>", "", body, flags=re.S)
+body = re.sub(r'<nav class="pagination">.*?</nav>', "", body, flags=re.S)
+# Site-absolute links: assets become relative files, other pages point at the live blog.
+body = body.replace('src="/assets/', 'src="assets/')
+body = re.sub(r'href="/(?!/)', 'href="https://fruch.github.io/', body)
+
+
+def annotate(body, notes):
+    """Highlight the paragraphs listed in notes["_focus"] (matched by text) and put each one's note above it."""
+    for item in notes["_focus"]:
+        idx = body.find(item["match"])
+        if idx < 0:
+            sys.exit(f"rewrite note: text not found in the post: {item['match']!r}")
+        bq = body.rfind("<blockquote", 0, idx)
+        tag = bq if bq > body.rfind("</blockquote>", 0, idx) else body.rfind("<p", 0, idx)  # whole quote, or the paragraph
+        name = body[tag + 1:body.index(">", tag)].split()[0]
+        body = (body[:tag] + f'<aside class="rw-note">{item["note"]}</aside>'
+                + f'<{name} class="rw"' + body[tag + 1 + len(name):])
+    first = body.find("<p")
+    return body[:first] + f'<aside class="rw-note rw-top">{notes["_top"]}</aside>' + body[first:]
+
+
+notes_file = REPO / "_preview" / "notes" / (Path(POST).stem + ".json")
+annotated = bool(os.environ.get("ANNOTATE")) and notes_file.exists()
+if annotated:  # only the post itself, not the site menu and footer
+    start = body.index('<div class="bd">'); end = body.index('<div class="meta">', start)
+    body = body[:start] + annotate(body[start:end], json.loads(notes_file.read_text())) + body[end:]
+
+banner = (
+    '<p class="draft-banner">Draft preview, not published yet. '
+    + ("Yellow: next 3 paragraphs to rewrite, plus Alexey's quote." if annotated else "Numbers and quotes may still change.")
+    + "</p>"
+)
+page = f"""<title>{title}</title>
+<link rel="stylesheet" href="{THEME}/css/style.css">
+<style>
+  :root {{ color-scheme: light; }}
+  body {{ background: #999999; }}
+  .draft-banner {{ margin: 0; padding: 8px 16px; background: #fdf3c8; color: #3a3220;
+    font: 14px/1.4 "Ubuntu Mono", monospace; text-align: center; }}
+  pre, .highlight {{ overflow-x: auto; }}
+  .rw {{ background: #fff6d6; box-shadow: -6px 0 0 #e0a800; }}
+  .ai-img img {{ outline: 4px dashed #e0a800; }}
+  .keep {{ box-shadow: -6px 0 0 #2f9e8f; }}
+  .rw-note {{ display: block; margin: 0.6em 0 1.2em; padding: 10px 14px; border: 1px solid #e0a800;
+    border-radius: 6px; background: #fffdf3; color: #3a3220; font-size: 0.85em; line-height: 1.5; }}
+  .rw-note::before {{ content: "Rewrite note: "; font-weight: bold; }}
+  .rw-top::before {{ content: "How to read the marks: "; }}
+  .rw-img::before {{ content: "Images: "; }}
+</style>
+{banner}
+{body}
+"""
+
+if OUT.exists():
+    shutil.rmtree(OUT)
+(OUT / THEME / "css").mkdir(parents=True)
+(OUT / "index.html").write_text(page)
+
+css = (SITE / THEME / "css/style.css").read_text().replace(f"url('/{THEME}/", "url('../")
+(OUT / THEME / "css/style.css").write_text(css)
+for sub in ("font", "skin"):
+    shutil.copytree(SITE / THEME / sub, OUT / THEME / sub, ignore=shutil.ignore_patterns("*.eot", "*.svg"))
+for src in sorted(set(re.findall(r'src="(assets/img/[^"]+)"', body))):
+    (OUT / src).parent.mkdir(parents=True, exist_ok=True)
+    shutil.copy(SITE / src, OUT / src)
+    if src.endswith(".svg"):  # the Artifact host rejects SVGs with a DOCTYPE (matplotlib adds one)
+        svg = (OUT / src).read_text()
+        (OUT / src).write_text(re.sub(r"<!DOCTYPE[^>]*>", "", svg, flags=re.S))
+
+print("\n".join(str(p.relative_to(OUT)) for p in sorted(OUT.rglob("*")) if p.is_file()))

_preview/notes/coodie-goes-to-production.json

@@ -0,0 +1,21 @@
+{
+  "_top": "Round 2: the next 3 paragraphs to put in your own words (yellow), plus Alexey's quote, still waiting for him. Your opening, perf and closing paragraphs are already in.",
+  "_focus": [
+    {
+      "match": "A blocking mapper inside a FastAPI app",
+      "note": "1 of 3: the async intro. GPTZero's second most-flagged sentence was in its first version ('Either way, you lose most of what async was supposed to give you'), and desklib ranked it second. One or two sentences on why sync cqlengine hurt Argus once it was on FastAPI."
+    },
+    {
+      "match": "Since then the benchmarks run in CI on every PR",
+      "note": "2 of 3: the CI benchmarks paragraph (your comment's spot; the Scylla perf-simple-query / perf-cql-raw links are now in it). Its 'CI runners are noisy' part was a top-2 AI score for three of the local models. Keep the links and facts, say it your way."
+    },
+    {
+      "match": "gives you <code",
+      "note": "3 of 3: the schema-migrations opener and the paragraph after it. On the rewritten draft, GPTZero's top AI sentences were exactly these ('coodie has a real schema toolkit on top of it', 'And for changes sync_table() shouldn't guess at...'). Facts: dry_run returns the CQL, Argus used it to verify names, drift warnings, versioned migration files + CLI."
+    },
+    {
+      "match": "Honestly, I expected the migration",
+      "note": "Alexey's quote: still the placeholder in his style. Waiting for his own words."
+    }
+  ]
+}