@m13v/s4l 1.7.3 → 1.7.4-rc.10

package/mcp/dist/index.js

@@ -1394,6 +1394,31 @@ async function seedSearchQueriesForProject(project, rawQueries) {
         return { note: ` (Search-query seeding skipped — ${e.message}.)`, queries };
     }
 }
+// After a project save, persist the profile scan's engagement-ranked top
+// replies into that project's voice.examples (and the persona_corpus.txt
+// exemplar section when the project is the persona). Every drafting prompt on
+// every platform already mirrors voice.examples, so this ONE write feeds them
+// all. scripts/voice_exemplars.py reads the last_profile_scan.json sidecar
+// scan_x_profile.py wrote and only quotes the user's own public replies
+// verbatim (mechanical ranking, no synthesis). Best-effort by design: no scan
+// yet, no usable replies, or hand-written voice.examples (exit 3, respected)
+// all return null and never block the save.
+async function applyScannedVoiceExamples(project) {
+    try {
+        const res = await runPython("scripts/voice_exemplars.py", ["apply", "--project", project], {
+            timeoutMs: 30_000,
+        });
+        const last = res.stdout.trim().split("\n").slice(-1)[0] || "";
+        const parsed = JSON.parse(last);
+        if (parsed.ok && parsed.voice_examples_written) {
+            return `Stored ${parsed.voice_examples_written} of their top-performing real replies (ranked by engagement, with the threads they answered) as voice.examples — every drafter now mirrors them.`;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
 // ---- engagement_mode: choose personal-brand vs product (setup-time) --------
 // Part of onboarding: AFTER X connect + profile_scan, BEFORE product config, the
 // agent asks the user which mode they want and calls this. It persists the mode
@@ -1603,6 +1628,10 @@ tool("engagement_mode", {
         return textContent(`Mode saved as ${mode}, but provisioning the persona project failed: ${e?.message || e}. ` +
             `Retry engagement_mode action:'set'.`);
     }
+    // Persist the profile scan's top-performing real replies as the persona's
+    // voice.examples + the persona_corpus.txt exemplar section (best-effort;
+    // see applyScannedVoiceExamples).
+    const personaExemplarNote = await applyScannedVoiceExamples(personaName);
     // Seed the persona's topics into the DB universe the cycle reads (best-effort;
     // the cycle's own fail-loud path still reports if topics are missing).
     let personaTopicsSeeded = false;
@@ -1687,6 +1716,7 @@ tool("engagement_mode", {
         persona_topic_count: personaTopicCount,
         persona_query_count: personaQueryCount,
         persona_query_note: personaQueryNote || null,
+        persona_voice_examples: personaExemplarNote,
         kicker_installed: kickerInstall ? kickerInstall.ok : null,
         kicker_detail: kickerInstall ? kickerInstall.detail : null,
         onboarding: onboardingSnapshot(),
@@ -1966,12 +1996,17 @@ tool("project_config", {
             counts: scan.counts,
             posts: scan.posts,
             comments: scan.comments,
+            top_posts: scan.top_posts,
+            top_replies: scan.top_replies,
             grounding_instructions: scan.grounding_instructions,
             website_research_instructions: WEBSITE_RESEARCH_INSTRUCTIONS,
             onboarding: onboardingSnapshot(),
             next_step: "FOUR steps, in order. FIRST (VOICE, from this scan): read the bio, posts, and comments " +
                 "as GROUND TRUTH and, per grounding_instructions, extract their profession/identity, " +
-                "voice & vibe (tone, phrasing, casing, tics), 2-4 verbatim golden-rule example replies, " +
+                "voice & vibe (tone, phrasing, casing, tics), verbatim golden-rule example replies (the " +
+                "scan pre-ranks these by real engagement in top_replies/top_posts, with stats, parent " +
+                "tweets, and thread continuations; persist them into the project's voice.examples so " +
+                "every drafter mirrors them), " +
                 "a phrase bank + things they avoid, and their icp. The scan is BACKWARD-LOOKING (only what " +
                 "they already posted) so it is the source for VOICE, not the primary source for topics. " +
                 "SECOND (the DICTATION interview — this is where TOPICS + grounding corpus come from, do NOT " +
@@ -2084,6 +2119,13 @@ tool("project_config", {
             });
         }
         const result = applySetup(args);
+        // Persist the profile scan's engagement-ranked exemplars into this
+        // project's voice.examples (+ the persona corpus section when the target
+        // is the persona). Reads the last_profile_scan.json sidecar the scanner
+        // wrote; verbatim quotes of the user's own public replies, so no
+        // synthesis happens here. Best-effort: no scan yet or hand-written
+        // examples present (exit 3) are both fine, and never block the save.
+        const exemplarNote = await applyScannedVoiceExamples(result.project);
         if (result.persona) {
             // no-op on the onboarding ledger; readiness is reported below as usual.
         }
@@ -2181,6 +2223,7 @@ tool("project_config", {
             kicker_detail: kickerInstall ? kickerInstall.detail : null,
             fields_set: result.fields_set,
             fields_removed: result.fields_removed,
+            voice_examples: exemplarNote,
             config_path: configPath(),
             onboarding: onboardingSnapshot(),
             note: (result.persona
@@ -2197,7 +2240,8 @@ tool("project_config", {
                     : `Saved what you provided for '${result.project}'. Still need: ${result.missing_required.join(", ")}. ` +
                         `First derive those fields from existing context, profile_scan, and website research, then ` +
                         `call project_config again with name='${result.project}'. Ask only if a required field is genuinely unknowable.`) +
-                advancedNote,
+                advancedNote +
+                (exemplarNote ? ` ${exemplarNote}` : ""),
         });
     }
     catch (e) {
@@ -5266,6 +5310,31 @@ async function main() {
     void sendStateSnapshot("startup");
     const ss = setInterval(() => void sendStateSnapshot("interval"), 15 * 60_000);
     ss.unref();
+    // One-shot voice-exemplar catch-up for installs onboarded BEFORE the
+    // exemplar feature: if the persona has no voice.examples_scanned_at, rescan
+    // the connected X profile and store the top-performing replies as
+    // voice.examples + the persona_corpus.txt exemplar section. Additive only
+    // (regenerates just its own marked corpus section; respects hand-written
+    // examples) and self-limiting (no cooldown by design: success stamps
+    // examples_scanned_at which makes later boots a no-op, and until then it
+    // WAITS politely on the twitter-browser lock, polling while holding
+    // nothing, until cycles/DM runs free the browser, up to 12h before
+    // deferring to the next boot). Delayed so boot-time work (runtime
+    // provision, kicker install) settles first.
+    const backfill = setTimeout(() => {
+        if (isPaused())
+            return;
+        // timeout covers the 12h lock wait plus generous room for the scan itself
+        void runPython("scripts/voice_exemplars.py", ["backfill"], { timeoutMs: 13 * 3600_000 })
+            .then((r) => {
+            const last = r.stdout.trim().split("\n").slice(-1)[0] || "";
+            console.error(`[social-autoposter-mcp] voice-exemplars backfill: ${last}`);
+        })
+            .catch((e) => {
+            console.error("[social-autoposter-mcp] voice-exemplars backfill failed:", e?.message || e);
+        });
+    }, 3 * 60_000);
+    backfill.unref();
 }
 main().catch(async (err) => {
     console.error("[social-autoposter-mcp] fatal:", err);

package/mcp/dist/twitterAuth.js

@@ -60,8 +60,9 @@ export async function xScanProfile(opts) {
         args.push("--handle", opts.handle);
     args.push("--posts", String(opts?.posts ?? 20));
     args.push("--comments", String(opts?.comments ?? 50));
-    // The scan scrolls two timelines; give it room but keep it bounded.
-    const res = await runPython("scripts/scan_x_profile.py", args, { timeoutMs: 180_000 });
+    // The scan scrolls two timelines plus visits the top posts' permalinks for
+    // thread expansion; give it room but keep it bounded.
+    const res = await runPython("scripts/scan_x_profile.py", args, { timeoutMs: 240_000 });
     try {
         return JSON.parse(res.stdout.trim().split("\n").slice(-1).join("\n"));
     }

package/mcp/dist/version.json

@@ -1,4 +1,4 @@
 {
-  "version": "1.7.3",
-  "installedAt": "2026-07-10T18:26:15.755Z"
+  "version": "1.7.4-rc.10",
+  "installedAt": "2026-07-11T01:28:53.237Z"
 }

package/mcp/manifest.json

@@ -2,7 +2,7 @@
   "dxt_version": "0.1",
   "name": "social-autoposter",
   "display_name": "S4L",
-  "version": "1.7.3",
+  "version": "1.7.4-rc.10",
   "description": "Draft, review, approve, and autopilot X/Twitter posts.",
   "long_description": "## **⚠️ The disclaimer above is generic Claude boilerplate.** Anthropic shows the same warning on every plugin regardless of what it does; any plugin has the same level of access as any app you download from the internet.\n\nS4L is an open source product developed by Mediar.ai Incorporated, a VC-backed San Francisco-based startup.\n\nTo get started:\n\n1\\. Copy this prompt: **Set me up on S4L plugin end to end**\n\n2\\. Quit with CMD+Q, reopen Claude, paste into a new chat.\n\nWhat happens next:\n\n* About every 5 minutes S4L scans X for posts that match your topics and drafts replies in your voice.\n* Drafts show up as review cards, usually the first within a few minutes. Nothing is posted automatically; you approve each one.\n* Posting autopilot stays off until you explicitly turn it on.",
   "author": {

package/mcp/menubar/s4l_card.py

@@ -732,6 +732,21 @@ class _ReviewController(NSObject):
         self._selected_draft = None
         self._draft_textviews = {}
         self._draft_scrolls = {}
+        # Per-draft hover dwell (two-draft cards, 2026-07-10): accumulated
+        # milliseconds the pointer spent over each draft box, so the feedback
+        # digest can tell an informed keep of Draft A (they read B and stayed)
+        # from a fast approve that says nothing about B. Raw ms ship on the
+        # decision; the read-vs-skim threshold lives digest-side so it can be
+        # tuned without a client release. _draft_hover_open holds the enter
+        # timestamp of any hover still in progress (flushed on decision).
+        self._draft_hover_ms = {0: 0, 1: 0}
+        self._draft_hover_open = {}
+        # Slots the caret has actually been in this card (2026-07-10 follow-up):
+        # lets the decision distinguish "clicked into B, then came BACK to A"
+        # (an explicit head-to-head choice of A, per user) from "never touched
+        # B at all". Only the UNCHOSEN slot's membership matters at decision
+        # time; the selected slot is trivially visited.
+        self._draft_visited = set()
         # Attention anchors for the unattended-review watchdog: the stack counts
         # as "touched" on present, on any tracked interaction, and on any
         # decision. No touch past the watchdog threshold = the user is not
@@ -1059,6 +1074,9 @@ class _ReviewController(NSObject):
             self._interactions = []
             self._card_shown_at = time.time()
             self._selected_draft = None
+            self._draft_hover_ms = {0: 0, 1: 0}
+            self._draft_hover_open = {}
+            self._draft_visited = set()
         self._reason_field = None
         content = NSView.alloc().initWithFrame_(NSMakeRect(0, 0, W, H))
 
@@ -1389,6 +1407,19 @@ class _ReviewController(NSObject):
                 tv.setDelegate_(self)
                 outline.addSubview_(scroll)
                 content.addSubview_(outline)
+                # Hover dwell per draft box (same NSTrackingArea pattern as the
+                # eye buttons): enter/exit timestamps accumulate into
+                # _draft_hover_ms[slot] so the decision can say whether the
+                # reviewer actually READ the draft they didn't pick. slot rides
+                # on userInfo, mirroring the eyes' `kind` routing.
+                outline.addTrackingArea_(
+                    NSTrackingArea.alloc().initWithRect_options_owner_userInfo_(
+                        outline.bounds(),
+                        NSTrackingMouseEnteredAndExited | NSTrackingActiveAlways,
+                        self,
+                        {"kind": "draft", "slot": slot},
+                    )
+                )
                 self._draft_scrolls[slot] = scroll
                 self._draft_outlines[slot] = outline
                 self._draft_textviews[slot] = tv
@@ -1542,21 +1573,32 @@ class _ReviewController(NSObject):
         self._show_details_popover()
 
     @objc.python_method
-    def _hover_kind(self, event):
-        """Which eye a tracking-area event belongs to ('stats' | 'details'),
-        from the userInfo stamped in _eye_button. Defaults to stats (the
-        original single-eye behavior) if the area carries no info."""
+    def _hover_info(self, event):
+        """(kind, slot) a tracking-area event belongs to, from the userInfo
+        stamped at creation: ('stats'|'details', None) for the eye icons,
+        ('draft', 0|1) for the two draft boxes. Defaults to ('stats', None),
+        the original single-eye behavior, if the area carries no info."""
         try:
             info = event.trackingArea().userInfo()
-            if info and info.get("kind") == "details":
-                return "details"
+            if info:
+                kind = info.get("kind")
+                if kind == "draft":
+                    return "draft", int(info.get("slot"))
+                if kind == "details":
+                    return "details", None
         except Exception:
             pass
-        return "stats"
+        return "stats", None
 
-    # NSTrackingArea owner callbacks (hover over either eye icon).
+    # NSTrackingArea owner callbacks (hover over either eye icon or, on
+    # two-draft cards, either draft box). Draft hovers only bank dwell time
+    # (no popover, no logging: the boxes are big and enter/exit fires on
+    # every pass of the pointer).
     def mouseEntered_(self, event):
-        kind = self._hover_kind(event)
+        kind, slot = self._hover_info(event)
+        if kind == "draft":
+            self._draft_hover_open[slot] = time.time()
+            return
         _log(f"{kind} eye hover enter")
         if kind == "details":
             self._show_details_popover()
@@ -1564,9 +1606,32 @@ class _ReviewController(NSObject):
             self._show_stats_popover()
 
     def mouseExited_(self, event):
+        kind, slot = self._hover_info(event)
+        if kind == "draft":
+            started = self._draft_hover_open.pop(slot, None)
+            if started is not None:
+                self._draft_hover_ms[slot] = self._draft_hover_ms.get(slot, 0) + int(
+                    (time.time() - started) * 1000
+                )
+            return
         _log("eye hover exit")
         self._close_stats_popover()
 
+    @objc.python_method
+    def _flush_draft_hovers(self):
+        """Bank any hover still in progress (pointer inside a draft box at
+        decision time, e.g. a keyboard approve) so _record reads final
+        totals."""
+        now = time.time()
+        for slot, started in list(self._draft_hover_open.items()):
+            self._draft_hover_ms[slot] = self._draft_hover_ms.get(slot, 0) + int(
+                (now - started) * 1000
+            )
+            # Keep the hover open (re-anchored at now) rather than deleting
+            # it: the pointer really is still inside the box, so a later
+            # mouseExited_ must not double-count the pre-flush span.
+            self._draft_hover_open[slot] = now
+
     @objc.python_method
     def _add_link(self, content, frame, text, url, *, size=12, bold=False, right=False, kind="link_click"):
         """Borderless button styled as a link (system link color, underlined).
@@ -1630,11 +1695,18 @@ class _ReviewController(NSObject):
         except Exception:
             return
         for slot, cand_tv in (self._draft_textviews or {}).items():
-            if cand_tv is tv and slot != self._selected_draft:
+            if cand_tv is not tv:
+                continue
+            # Visited even when it's already the selected slot: membership of
+            # the eventually-UNCHOSEN slot is what _record reads, and that
+            # slot only ever gets the caret via a deliberate user click (the
+            # auto-focus seat in _render targets the selected slot only).
+            self._draft_visited.add(slot)
+            if slot != self._selected_draft:
                 self._selected_draft = slot
                 self._textview = cand_tv
                 self._update_draft_borders()
-                break
+            break
 
     @objc.python_method
     def _update_draft_borders(self):
@@ -1704,9 +1776,32 @@ class _ReviewController(NSObject):
             chosen_draft = drafts[sel_idx]
             orig = (chosen_draft.get("text") or "").strip()
             draft_variant = chosen_draft.get("variant") or ("a" if sel_idx == 0 else "b")
+            # Full pairwise context for the feedback digest (2026-07-10): the
+            # UNCHOSEN draft's text+style ride along so "picked B over A" (or
+            # "kept A after reading B", per the hover dwell) is a usable
+            # preference PAIR, not just a winner with no loser. Shipped as one
+            # nested dict end to end (decision -> review event -> jsonb column)
+            # so adding a field never needs another schema hop.
+            self._flush_draft_hovers()
+            other = drafts[1 - sel_idx]
+            draft_choice = {
+                "variant": draft_variant,
+                "index": sel_idx,
+                "auto_selected": bool(sel_idx == 0),
+                "style": chosen_draft.get("style") or None,
+                "unchosen_text": (other.get("text") or "").strip() or None,
+                "unchosen_style": other.get("style") or None,
+                "hover_a_ms": int(self._draft_hover_ms.get(0, 0)),
+                "hover_b_ms": int(self._draft_hover_ms.get(1, 0)),
+                # True = the caret was in the unchosen box at some point, i.e.
+                # they tried the other draft and came back: an explicit choice
+                # even when the winner is the preselected default.
+                "visited_other": bool((1 - sel_idx) in self._draft_visited),
+            }
         else:
             orig = (d.get("reply_text") or "").strip()
             draft_variant = None
+            draft_choice = None
         link = d.get("link_url") or ""
         drop_link = False
         if approved:
@@ -1762,6 +1857,11 @@ class _ReviewController(NSObject):
                 "draft_variant": draft_variant,
                 "draft_index": sel_idx,
                 "draft_auto_selected": bool(dual and sel_idx == 0),
+                # Nested pairwise record (chosen vs unchosen text/style plus
+                # per-box hover dwell); None on single-draft candidates. The
+                # flat three fields above stay for their existing consumers
+                # (edit-learning variant stamp in s4l_menubar).
+                "draft_choice": draft_choice,
             }
         )
         self._last_decision_at = time.time()

package/mcp/menubar/s4l_menubar.py

@@ -2941,6 +2941,13 @@ class S4LMenuBar(rumps.App):
                     # posts); English translations on the card are display-only
                     # and never shipped here.
                     "language": decision.get("language"),
+                    # Two-draft pairwise context (None on single-draft cards):
+                    # {variant, index, auto_selected, style, unchosen_text,
+                    # unchosen_style, hover_a_ms, hover_b_ms}. Lets the
+                    # feedback digest learn "picked B over A" / "kept A after
+                    # actually reading B" as preference pairs. Older servers
+                    # simply ignore the key.
+                    "draft_choice": decision.get("draft_choice"),
                 }
             )
         except Exception:

package/mcp/menubar/s4l_state.py

@@ -786,6 +786,10 @@ def store_stamp_decision(batch, decision):
             "drop_link": bool(decision.get("drop_link")),
             "loved": bool(decision.get("loved")),
             "reject_category": decision.get("reject_category"),
+            # Two-draft pairwise record (chosen vs unchosen + hover dwell),
+            # None on single-draft cards. Durable locally so the choice
+            # survives even if the review-events flush never lands.
+            "draft_choice": decision.get("draft_choice"),
             "decided_at": time_iso(),
         }
         if decision.get("approved"):

package/mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m13v/s4l-mcp",
-  "version": "1.7.3",
+  "version": "1.7.4-rc.10",
   "private": true,
   "description": "Desktop MCP client for social-autoposter (X/Twitter rail): manual draft/review/approve loop, autopilot control, and stats. Thin wrapper over the existing pipeline scripts.",
   "license": "MIT",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m13v/s4l",
-  "version": "1.7.3",
+  "version": "1.7.4-rc.10",
   "description": "Automated social posting pipeline for Reddit, X/Twitter, LinkedIn, and Moltbook. Install as a Claude Code agent skill.",
   "bin": {
     "social-autoposter": "bin/cli.js",

package/scripts/build_persona.py

@@ -90,9 +90,14 @@ GROUNDING_INSTRUCTIONS = (
     "  description    2-3 sentences: who this person is as a builder/voice.\n"
     "  content_angle  one paragraph of concrete, first-hand experience the "
     "persona can speak from (real projects, real numbers, real pain).\n"
-    "  voice          {tone, never[]}: how they actually write (read their own "
-    "posts/replies in the x source). Keep the organic rules: first person, "
-    "specific, no links, no feature lists, no sales, no em dashes.\n"
+    "  voice          {tone, never[], examples[]}: how they actually write (read "
+    "their own posts/replies in the x source). Keep the organic rules: first "
+    "person, specific, no links, no feature lists, no sales, no em dashes. For "
+    "examples[], the x source pre-ranks their best real replies/posts by "
+    "engagement (top_replies / top_posts, each with stats, the parent tweet, and "
+    "thread continuations): keep up to 5 verbatim, or run "
+    "`voice_exemplars.py apply --scan <x-source.json>` after apply to write "
+    "voice.examples + the persona_corpus.txt exemplar section deterministically.\n"
     "  search_topics  ~15 topics they have genuine experience with.\n"
     "  content_corpus (OPTIONAL but STRONGLY encouraged) the RAW gathered "
     "corpus as one plain-text block: the persona's actual posts, replies, repo "

package/scripts/engagement_styles.py

@@ -1034,7 +1034,18 @@ def compute_target_distribution(platform, context="posting"):
 # mode="invent" and the prompt hands the model the top N as reference
 # material to derive a new style from.
 
-INVENT_RATE = 0.05  # ~1 in 20 posts forces a new-style invention
+# 2026-07-10: inline invention retired (rate 0). It ran inside the drafting
+# prep session with the top-performers leaderboard + winner exemplars in
+# context, so every "new" style was a renamed clone of the winning
+# agree-then-relocate move; combined with name-only dedup the registry hit
+# ~938 styles that were mostly one structure. Invention now lives in the
+# standalone scripts/invent_styles.py job (operator-only launchd
+# com.m13v.s4l-invent-styles: the registry is global across installs, so a
+# central daily run replaces per-post rolls). The invent-mode plumbing in
+# pickers/posters is kept intact: register_style() is what the standalone
+# job calls, and a nonzero rate here re-enables the inline path if ever
+# wanted.
+INVENT_RATE = 0.0  # retired inline roll (was 0.05, ~1 in 20 posts)
 CURATED_TOP_N = 5   # size of the invent-mode reference list (top 5 by score)
 
 # Fallback target comment length (chars) for any style that lacks an explicit