@m13v/s4l 1.7.4-rc.29 → 1.7.4-rc.30

package/mcp/dist/version.json

@@ -1,4 +1,4 @@
 {
-  "version": "1.7.4-rc.29",
-  "installedAt": "2026-07-13T22:06:08.099Z"
+  "version": "1.7.4-rc.30",
+  "installedAt": "2026-07-13T22:13:17.873Z"
 }

package/mcp/manifest.json

@@ -2,7 +2,7 @@
   "dxt_version": "0.1",
   "name": "social-autoposter",
   "display_name": "S4L",
-  "version": "1.7.4-rc.29",
+  "version": "1.7.4-rc.30",
   "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_menubar.py

@@ -555,6 +555,9 @@ class S4LMenuBar(rumps.App):
         # (0 = not snoozed). Loaded from disk so a menubar restart mid-snooze
         # doesn't re-pop the card the user just put away.
         self._review_snooze_until = self._read_snooze_until()
+        # Reveal cadence: when the last fresh card presentation happened (epoch,
+        # 0 = never). Loaded from disk so a restart mid-interval doesn't re-pop.
+        self._last_presented_at = self._read_last_presented()
         # Unattended-review watchdog state (_maybe_heal_review).
         self._review_heal_at = 0.0
         self._review_unattended_notified = False
@@ -2667,6 +2670,11 @@ class S4LMenuBar(rumps.App):
             int(self._review_snooze_until)
             if time.time() < self._review_snooze_until
             else 0,
+            # Reveal cadence: rebuilds when the preset changes (checkmark +
+            # submenu title) and when a hold starts or lapses (the "Next cards
+            # around HH:MM" line in _state_c).
+            round(st.read_reveal_cadence()),
+            int(self._reveal_hold_until(pending_count)),
         )
         if sig != self._sig:
             self._sig = sig
@@ -2765,6 +2773,37 @@ class S4LMenuBar(rumps.App):
         except Exception:
             pass
 
+    def _read_last_presented(self):
+        try:
+            with open(REVEAL_STAMP_FILE) as f:
+                return float((json.load(f) or {}).get("at") or 0.0)
+        except Exception:
+            return 0.0
+
+    def _stamp_presented(self):
+        """Record a fresh card presentation, mirrored to disk (restart-safe).
+        Starts the next reveal-cadence interval."""
+        self._last_presented_at = time.time()
+        try:
+            with open(REVEAL_STAMP_FILE, "w") as f:
+                json.dump({"at": self._last_presented_at}, f)
+        except Exception:
+            pass
+
+    def _reveal_hold_until(self, pending_count):
+        """Epoch until which the reveal cadence is actually holding fresh cards
+        back (0.0 = no hold). A hold only exists while there is something to
+        hold: pending drafts, no review in flight, and not snoozed (the snooze
+        label and gate take precedence)."""
+        if pending_count <= 0 or self._review_active:
+            return 0.0
+        now = time.time()
+        if now < self._review_snooze_until:
+            return 0.0
+        cadence = st.read_reveal_cadence()
+        until = self._last_presented_at + cadence
+        return until if (cadence > 0 and now < until) else 0.0
+
     def _review_now(self, _=None):
         """Menu: bring the pending draft cards up right now. Clears any snooze;
         this is the one presentation path that may take keyboard focus (the
@@ -2846,6 +2885,17 @@ class S4LMenuBar(rumps.App):
                     sys.stderr.flush()
                 self._last_review_sig = sig
             return
+        # Reveal cadence: hold FRESH pop-ups until the configured interval since
+        # the last presentation has passed (0 = show immediately). Drafting is
+        # untouched; the backlog keeps accumulating and is presented whole once
+        # due. Deliberately after the extend-open-card path above (an on-screen
+        # card keeps growing live) and skipped for focus=True (the menu's
+        # "Review N pending drafts" is an explicit ask). _last_review_sig is NOT
+        # stamped on a hold, so the same set still presents fresh when due.
+        if not focus:
+            cadence = st.read_reveal_cadence()
+            if cadence > 0 and time.time() - self._last_presented_at < cadence:
+                return
         with self._review_lock:
             self._reset_posting_progress_locked()
             self._review_active = True
@@ -2869,6 +2919,7 @@ class S4LMenuBar(rumps.App):
             # Record as shown only AFTER the cards are actually up, so a transient
             # card-UI failure never permanently suppresses this pending set.
             self._last_review_sig = sig
+            self._stamp_presented()
             # No macOS notification for fresh drafts, per explicit user
             # request (2026-07-03): the card itself is the surface. A missed
             # card is the unattended watchdog's job (it heals the window and
@@ -3457,6 +3508,22 @@ class S4LMenuBar(rumps.App):
                 split_menu.add(it)
             items.append(split_menu)
 
+        # Reveal cadence: how often fresh draft cards may pop (the drafting
+        # pipeline is unchanged; this only paces the pop-up). Always offered:
+        # it is the "don't interrupt me every few minutes" control.
+        cadence = st.read_reveal_cadence()
+        cadence_menu = rumps.MenuItem(
+            f"Show draft cards: {self._cadence_label(cadence).lower()}"
+        )
+        for preset, label in self.REVEAL_CADENCE_PRESETS:
+            it = rumps.MenuItem(
+                label,
+                callback=functools.partial(self._on_cadence_preset, preset),
+            )
+            it.state = 1 if round(cadence) == preset else 0
+            cadence_menu.add(it)
+        items.append(cadence_menu)
+
         items.append(rumps.separator)
         items.append(rumps.MenuItem("Open dashboard", callback=self._open_dashboard))
         # The one entry point for overall feedback (the review card no longer
@@ -3595,6 +3662,18 @@ class S4LMenuBar(rumps.App):
                     )
                 )
             )
+        else:
+            # Reveal-cadence hold: the backlog exists but the pop-up is being
+            # paced. Same courtesy line as the snooze; "Review N pending
+            # drafts" above shows them right now regardless.
+            hold_until = self._reveal_hold_until(pending_count)
+            if hold_until:
+                items.append(
+                    self._label(
+                        "Next cards around "
+                        + time.strftime("%H:%M", time.localtime(hold_until))
+                    )
+                )
         # No bulk-discard item here anymore: "Discard all…" lives in the
         # review card's title bar (2026-07-10). Reaching it with no card open
         # is "Review N pending drafts" -> Discard all, two clicks.

package/mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m13v/s4l-mcp",
-  "version": "1.7.4-rc.29",
+  "version": "1.7.4-rc.30",
   "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.4-rc.29",
+  "version": "1.7.4-rc.30",
   "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",