@m13v/s4l 1.7.5-rc.34 → 1.7.5-rc.35

package/mcp/dist/index.js

@@ -5893,17 +5893,22 @@ 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.
+    // Voice-exemplar catch-up + periodic refresh, checked on every boot
+    // (2026-07-16, extended from the original one-shot-for-legacy-installs
+    // version): rescans the connected X profile and re-stores voice.examples +
+    // the persona_corpus.txt exemplar section whenever
+    // scripts/voice_exemplars.py's _needs_rescan() says so -- never scanned,
+    // scanned by an older SCANNER_VERSION (so a scraper fix like the 2026-07-15
+    // stall-detection bug reaches already-scanned installs on their next boot
+    // instead of silently never re-running), or the last scan is more than
+    // RESCAN_MAX_AGE_DAYS (14) old. Additive only (regenerates just its own
+    // marked corpus section; respects hand-written examples). Each boot is
+    // cheap when nothing needs it (stamped examples_scanned_at +
+    // examples_scanner_version make it a no-op until either goes stale), and
+    // when something DOES need it, 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;

package/mcp/dist/version.json

@@ -1,4 +1,4 @@
 {
-  "version": "1.7.5-rc.34",
-  "installedAt": "2026-07-16T01:35:05.419Z"
+  "version": "1.7.5-rc.35",
+  "installedAt": "2026-07-16T02:02:31.387Z"
 }

package/mcp/manifest.json

@@ -2,7 +2,7 @@
   "dxt_version": "0.1",
   "name": "social-autoposter",
   "display_name": "S4L",
-  "version": "1.7.5-rc.34",
+  "version": "1.7.5-rc.35",
   "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_canvas.py

@@ -100,7 +100,7 @@ from AppKit import (
     NSLinkAttributeName,
     NSWindowOcclusionStateVisible,
     NSBackingStoreBuffered,
-    NSFloatingWindowLevel,
+    NSNormalWindowLevel,
     NSApplicationActivationPolicyAccessory,
     NSWindowStyleMaskTitled,
     NSWindowStyleMaskClosable,
@@ -314,8 +314,13 @@ class _CanvasController(NSObject):
         # that overlapped the header row under the title bar (2026-07-16 user
         # report). Keep the real content size around for _render().
         self._content_size = NSMakeSize(frame.size.width, frame.size.height)
-        panel.setLevel_(NSFloatingWindowLevel)
-        panel.setFloatingPanel_(True)
+        # Normal window level, NOT floating (2026-07-16 user report): this is
+        # a large, deliberate review session the reviewer works IN, unlike
+        # the corner card's small always-on-top notification -- it should
+        # behave like any other window (other apps can come to front over
+        # it) rather than staying glued above everything.
+        panel.setLevel_(NSNormalWindowLevel)
+        panel.setFloatingPanel_(False)
         panel.setBecomesKeyOnlyIfNeeded_(True)
         panel.setHidesOnDeactivate_(False)
         panel.setReleasedWhenClosed_(False)

package/mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m13v/s4l-mcp",
-  "version": "1.7.5-rc.34",
+  "version": "1.7.5-rc.35",
   "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.5-rc.34",
+  "version": "1.7.5-rc.35",
   "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/scan_x_profile.py

@@ -60,6 +60,14 @@ CDP = os.environ.get(
     os.environ.get("TWITTER_CDP_URL", "http://127.0.0.1:9555"),
 ).rstrip("/")
 
+# Bump whenever the scraping/ranking logic changes materially enough that an
+# install's existing scan should be considered stale and worth redoing, even
+# though it "succeeded" under the old code (e.g. the 2026-07-15 stall-detection
+# fix: old scans from accounts where S4L posts heavily silently undercounted
+# organic replies). scripts/voice_exemplars.py stamps this alongside
+# examples_scanned_at and treats a lower stamped version as a rescan trigger.
+SCANNER_VERSION = 2
+
 
 # --------------------------------------------------------------------------- #
 # CDP attach (mirrors setup_twitter_auth.py::_attach so behavior is identical).
@@ -560,6 +568,7 @@ def main() -> int:
             "counts": {"posts": len(posts), "comments": len(comments),
                        "s4l_posted_excluded": len(s4l_ids)},
             "grounding_instructions": GROUNDING_INSTRUCTIONS,
+            "scanner_version": SCANNER_VERSION,
         }
 
         # Persist the corpus beside config.json so the later project-save step

package/scripts/voice_exemplars.py

@@ -59,10 +59,41 @@ HERE = Path(__file__).resolve().parent
 sys.path.insert(0, str(HERE))
 
 import s4l_mode  # noqa: E402
+from scan_x_profile import SCANNER_VERSION  # noqa: E402
 
 EXEMPLARS_START = "=== S4L SCANNED EXEMPLARS START (auto-generated by voice_exemplars.py; regenerated on rescan, do not hand-edit) ==="
 EXEMPLARS_END = "=== S4L SCANNED EXEMPLARS END ==="
 
+# Periodic staleness refresh (2026-07-16): even a scan done with the current
+# scanner can go stale as the account posts/replies more over time. Re-scan
+# any persona project whose last scan is older than this, on top of the
+# version-triggered rescan below.
+RESCAN_MAX_AGE_DAYS = 14
+
+
+def _needs_rescan(proj: dict) -> bool:
+    """True if this persona project should get a fresh profile scan:
+    never scanned, hand-written examples (exempt from auto-touch, but also
+    never "need" a rescan since we'd never apply one), the last scan predates
+    the current SCANNER_VERSION (a scraping/ranking fix shipped since), or the
+    last scan is older than RESCAN_MAX_AGE_DAYS. An unparseable timestamp is
+    treated as stale rather than silently never-rescanned."""
+    if _is_hand_written(proj):
+        return False
+    voice = proj.get("voice")
+    if not isinstance(voice, dict) or not voice.get("examples_scanned_at"):
+        return True
+    if int(voice.get("examples_scanner_version") or 0) < SCANNER_VERSION:
+        return True
+    try:
+        scanned_at = datetime.fromisoformat(voice["examples_scanned_at"])
+        if scanned_at.tzinfo is None:
+            scanned_at = scanned_at.replace(tzinfo=timezone.utc)
+        age_days = (datetime.now(timezone.utc) - scanned_at).days
+        return age_days >= RESCAN_MAX_AGE_DAYS
+    except Exception:
+        return True
+
 
 def _score(item: dict) -> int:
     """Mirror scan_x_profile.rank_top's weighting for scans that predate it."""
@@ -215,6 +246,7 @@ def _set_examples(proj: dict, scan: dict, top: int, min_chars: int,
         proj["voice"] = voice
     voice["examples"] = examples
     voice["examples_scanned_at"] = datetime.now(timezone.utc).isoformat(timespec="seconds")
+    voice["examples_scanner_version"] = scan.get("scanner_version") or SCANNER_VERSION
     return True, "ok", examples
 
 
@@ -339,15 +371,23 @@ def _release_browser_lock() -> None:
 
 
 def cmd_backfill(args) -> int:
-    """Called best-effort on MCP boot. If the persona project predates the
-    exemplar feature (no voice.examples_scanned_at), run a fresh profile scan
-    and apply. Scoped to the PERSONA project only: every install provisions one
-    at onboarding, and it is where the author's own voice lives; product
-    projects pick exemplars up on their next project_config save instead. The
-    corpus write is additive (the marked section is the only thing replaced;
-    dictation and hand-added material stay). No cooldown by design (user rule
-    2026-07-10): every boot retries until the scan succeeds; success stamps
-    examples_scanned_at, which makes all later boots a cheap no-op. Boots are
+    """Called best-effort on MCP boot. Runs a fresh profile scan and (re)applies
+    exemplars for any persona project that _needs_rescan() flags: never
+    scanned (predates the exemplar feature), scanned by an older
+    SCANNER_VERSION (a scraping/ranking fix shipped since -- e.g. the
+    2026-07-15 stall-detection fix silently undercounted replies on accounts
+    where S4L posts heavily, so those pre-fix scans need redoing even though
+    they "succeeded"), or scanned more than RESCAN_MAX_AGE_DAYS ago (2026-07-16:
+    periodic staleness refresh, since the account keeps posting/replying after
+    the last scan). Scoped to the PERSONA project only: every install
+    provisions one at onboarding, and it is where the author's own voice
+    lives; product projects pick exemplars up on their next project_config
+    save instead. The corpus write is additive (the marked section is the
+    only thing replaced; dictation and hand-added material stay). No cooldown
+    beyond the staleness window by design (user rule 2026-07-10 extended
+    2026-07-16): every boot retries until the scan succeeds; success stamps
+    examples_scanned_at + examples_scanner_version, which makes all later
+    boots a cheap no-op UNTIL either goes stale again. Boots are
     user-triggered (Desktop launch), so the worst case is one scan attempt per
     launch, and concurrent waiters from overlapping boots dedupe via the
     post-lock eligibility re-check."""
@@ -357,9 +397,7 @@ def cmd_backfill(args) -> int:
         return 0
     cfg = json.loads(cfg_path.read_text())
     personas = [p for p in cfg.get("projects", []) if p.get("persona") is True]
-    eligible = [p for p in personas
-                if not (isinstance(p.get("voice"), dict) and p["voice"].get("examples_scanned_at"))
-                and not _is_hand_written(p)]
+    eligible = [p for p in personas if _needs_rescan(p)]
     if not eligible:
         print(json.dumps({"ok": True, "did": "nothing", "reason": "already_done_or_hand_written"}))
         return 0
@@ -375,9 +413,7 @@ def cmd_backfill(args) -> int:
         # meanwhile. Re-read config and re-check before burning a scan.
         cfg = json.loads(cfg_path.read_text())
         personas = [p for p in cfg.get("projects", []) if p.get("persona") is True]
-        eligible = [p for p in personas
-                    if not (isinstance(p.get("voice"), dict) and p["voice"].get("examples_scanned_at"))
-                    and not _is_hand_written(p)]
+        eligible = [p for p in personas if _needs_rescan(p)]
         if not eligible:
             _release_browser_lock()
             print(json.dumps({"ok": True, "did": "nothing", "reason": "done_while_waiting"}))