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

package/mcp/dist/version.json

@@ -1,4 +1,4 @@
 {
-  "version": "1.7.4-rc.28",
-  "installedAt": "2026-07-13T21:52:37.483Z"
+  "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.28",
+  "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_card.py

@@ -46,10 +46,11 @@ menu bar registers at boot via `set_feedback_handler` (it ships
 decision='feedback' review events).
 
 Rejecting is a two-step flow: the Reject button swaps the card body for a
-reason picker (three one-tap categories plus Other, with an optional free-text
-note). The category feeds the feedback-digest loop that distills human
-rejections into each project's learned_preferences config block; "Skip" keeps
-the old zero-friction reject (no reason recorded). Link clicks (author profile,
+reason picker (three one-tap categories, all optional, plus an optional
+free-text note). The category feeds the feedback-digest loop that distills
+human rejections into each project's learned_preferences config block; the
+picker's red Reject button commits with no category (the note, if typed, is
+still sent). Link clicks (author profile,
 thread ↗) and per-card dwell time ride along on the decision so the digest can
 infer intent (e.g. profile-checked-then-rejected = author-quality signal) even
 when the reason is skipped.
@@ -185,13 +186,15 @@ M = 16
 NS_BEZEL_BORDER = 2  # NSBezelBorder
 
 # Reject-reason categories, in display order. Tags are 1-based button tags on
-# the reason picker; values must match the review_events.reject_category CHECK
-# constraint server-side (wrong_author | off_topic | bad_draft | other).
+# the reason picker; values must be a subset of the review_events.reject_category
+# CHECK constraint server-side (wrong_author | off_topic | bad_draft | other).
+# "other" is still valid server-side but no longer offered as a button: picking
+# a category is optional (the red Reject button commits without one) and the
+# free-text note covers everything a generic Other chip used to.
 REJECT_REASONS = (
     ("wrong_author", "Wrong author / audience"),
     ("off_topic", "Off-topic thread"),
-    ("bad_draft", "Draft doesn't sound right"),
-    ("other", "Other"),
+    ("bad_draft", "Feels like AI writing"),
 )
 
 # Client-side cap on tracked interactions per card (server clips at 50 too).
@@ -1990,10 +1993,11 @@ class _ReviewController(NSObject):
         content = NSView.alloc().initWithFrame_(NSMakeRect(0, 0, W, H))
 
         # Buttons at the TOP, above the title, mirroring the card's action
-        # row so the cursor doesn't have to travel between steps: "Reject,
-        # no reason" sits right-aligned exactly where Reject was (one-click
-        # double-tap keeps the old zero-friction reject), Back sits at the
-        # left where Approve was.
+        # row so the cursor doesn't have to travel between steps: "Reject"
+        # sits exactly where the card's Reject was (one-click double-tap
+        # keeps the old zero-friction reject) and commits with no category,
+        # since picking one is optional; Back sits at the left where Approve
+        # was.
         back = NSButton.alloc().initWithFrame_(NSMakeRect(M, H - 42, 90, 30))
         back.setTitle_("Back")
         back.setBezelStyle_(NSBezelStyleRounded)
@@ -2001,8 +2005,8 @@ class _ReviewController(NSObject):
         back.setAction_("rejectBack:")
         content.addSubview_(back)
 
-        skip = NSButton.alloc().initWithFrame_(NSMakeRect(W - M - 150, H - 42, 150, 30))
-        skip.setTitle_("Reject, no reason")
+        skip = NSButton.alloc().initWithFrame_(NSMakeRect(W - M - 66, H - 42, 66, 30))
+        skip.setTitle_("Reject")
         skip.setBezelStyle_(NSBezelStyleRounded)
         try:
             skip.setHasDestructiveAction_(True)  # red title on macOS 12+
@@ -2013,7 +2017,7 @@ class _ReviewController(NSObject):
         content.addSubview_(skip)
 
         content.addSubview_(
-            _label(NSMakeRect(M, H - 72, W - 2 * M, 20), "Why reject this draft?", size=13, bold=True)
+            _label(NSMakeRect(M, H - 72, W - 2 * M, 20), "Why reject this draft? (optional)", size=13, bold=True)
         )
         y = H - 106
         for i, (_, title) in enumerate(REJECT_REASONS):
@@ -2061,7 +2065,7 @@ class _ReviewController(NSObject):
         note.setEditable_(True)
         note.setFont_(NSFont.systemFontOfSize_(12))
         try:
-            note.setPlaceholderString_("Optional note (sent with whichever reason you pick)")
+            note.setPlaceholderString_("Optional note (sent with or without a reason)")
             note.cell().setWraps_(True)
         except Exception:
             pass

package/mcp/menubar/s4l_menubar.py

@@ -463,6 +463,14 @@ REVIEW_UNATTENDED_SENTRY_SECONDS = 3600.0
 REVIEW_SNOOZE_SECONDS = float(os.environ.get("S4L_REVIEW_SNOOZE_S", "3600"))
 SNOOZE_FILE = os.path.join(st.state_dir(), "review-snooze.json")
 
+# Reveal cadence (2026-07-13): how often FRESH draft cards may pop, independent
+# of how often the pipeline drafts (mode.json `reveal_cadence_secs`, default 1h,
+# 0 = as soon as ready). Only fresh presentations are paced: an already-open
+# card still grows live via extend_active, snooze still parks everything, and
+# the menu's "Review N pending drafts" always bypasses. The last-presented
+# epoch is persisted so a menubar restart mid-interval doesn't re-pop early.
+REVEAL_STAMP_FILE = os.path.join(st.state_dir(), "review-last-presented.json")
+
 
 def _label_elapsed_secs(label):
     """Parse the trailing duration the producer encodes in a drafting activity
@@ -547,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
@@ -1127,6 +1138,40 @@ class S4LMenuBar(rumps.App):
         """Menu callback shim: rumps passes the clicked MenuItem last."""
         self._set_split(share)
 
+    # Reveal-cadence presets (seconds between fresh card pop-ups; 0 = as soon
+    # as drafts are ready). Manual mode.json edits can set any value; the
+    # checkmark then lands on an exact match or none, same as the lane split.
+    REVEAL_CADENCE_PRESETS = (
+        (0, "Immediately"),
+        (1800, "Every 30 minutes"),
+        (3600, "Every hour"),
+        (14400, "Every 4 hours"),
+    )
+
+    def _cadence_label(self, secs=None):
+        """Human label for a cadence value, for menu copy."""
+        if secs is None:
+            secs = st.read_reveal_cadence()
+        for preset, label in self.REVEAL_CADENCE_PRESETS:
+            if round(secs) == preset:
+                return label
+        m = round(secs / 60)
+        return f"Every {m} min" if m else "Immediately"
+
+    def _on_cadence_preset(self, secs, _sender=None):
+        """Menu callback shim: rumps passes the clicked MenuItem last."""
+        written = st.write_reveal_cadence(secs)
+        self._notify(
+            "S4L draft cards",
+            f"New draft cards will show: {self._cadence_label(written).lower()}",
+        )
+        self._sig = None
+        try:
+            self._tick(None)
+        except Exception as e:
+            sys.stderr.write(f"[s4l-menubar] cadence rebuild failed: {e}\n")
+            sys.stderr.flush()
+
     def _set_split(self, share):
         """Set the personal-brand share (pure local mode.json write, same
         contract as _toggle_lane) and rebuild so the checkmark moves instantly."""
@@ -2625,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
@@ -2723,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
@@ -2804,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
@@ -2827,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
@@ -3415,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
@@ -3553,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/menubar/s4l_state.py

@@ -1251,6 +1251,46 @@ def write_split(share):
     return share
 
 
+# Draft-card reveal cadence: minimum seconds between FRESH card pop-ups
+# (0 = present as soon as drafts are ready). Drafting itself is untouched;
+# drafts keep accumulating in the review store and the menubar just paces the
+# pop-up. Lives in mode.json (every writer preserves unknown keys). Presets
+# are the menubar's REVEAL_CADENCE_PRESETS; any non-negative value is valid.
+REVEAL_CADENCE_DEFAULT = 3600.0
+
+
+def read_reveal_cadence():
+    """Seconds between draft-card reveals (0 = immediately, default 1 hour)."""
+    d = read_json(MODE_FILE)
+    try:
+        secs = float(d.get("reveal_cadence_secs"))
+    except (TypeError, ValueError, AttributeError):
+        return REVEAL_CADENCE_DEFAULT
+    return max(0.0, secs)
+
+
+def write_reveal_cadence(secs):
+    """Persist the reveal cadence, preserving every other mode.json key.
+    Returns the written value. Never raises (a menu click must not crash)."""
+    try:
+        secs = max(0.0, float(secs))
+    except (TypeError, ValueError):
+        return read_reveal_cadence()
+    try:
+        payload = read_json(MODE_FILE)
+        if not isinstance(payload, dict):
+            payload = {}
+        payload["reveal_cadence_secs"] = secs
+        p = Path(state_dir()) / MODE_FILE
+        p.parent.mkdir(parents=True, exist_ok=True)
+        tmp = p.with_suffix(".json.tmp")
+        tmp.write_text(json.dumps(payload))
+        os.replace(str(tmp), str(p))
+    except Exception:
+        pass
+    return secs
+
+
 def write_mode(mode):
     """Legacy single-mode setter: named lane ON, the other OFF (compat)."""
     if mode not in _VALID_MODES:

package/mcp/package.json

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