social-autoposter 1.6.62 → 1.6.63

package/bin/cli.js

@@ -705,6 +705,22 @@ function generatePlists() {
       stdoutLog: `${DEST}/skill/logs/launchd-self-update-stdout.log`,
       stderrLog: `${DEST}/skill/logs/launchd-self-update-stderr.log`,
     },
+    {
+      // On-screen overlay watcher supervisor. The overlay (harness status banner
+      // + interactive draft sidebar) only renders WHILE harness_overlay.py watch
+      // runs. The supervisor is idempotent (pgrep guard), so a 60s StartInterval
+      // is a no-op while the watcher is up and re-spawns it within a minute if it
+      // ever dies. RunAtLoad starts it right after install. This is what makes the
+      // overlay appear on headless / remote installs (Lane A); the MCP covers the
+      // pure-.mcpb lane by calling the same script on draft_cycle / autopilot.
+      file: 'com.m13v.social-overlay-watch.plist',
+      label: 'com.m13v.social-overlay-watch',
+      script: `${DEST}/skill/run-overlay-watch.sh`,
+      interval: 60,
+      runAtLoad: true,
+      stdoutLog: `${DEST}/skill/logs/launchd-overlay-watch-stdout.log`,
+      stderrLog: `${DEST}/skill/logs/launchd-overlay-watch-stderr.log`,
+    },
   ];
 
   const driver = scheduler.driverFor();

package/mcp/dist/index.js

@@ -222,6 +222,32 @@ function cycleProgressMessage(line) {
         return `Cycle stopped (${m[1]}).`;
     return null;
 }
+// Start the twitter-harness on-screen overlay watcher if it isn't already up.
+// The overlay (status banner + interactive draft sidebar) only renders WHILE
+// `harness_overlay.py watch` runs. The supervisor script is idempotent (pgrep
+// guard), so calling this on every draft_cycle / autopilot-enable / show-browser
+// is safe: it spawns at most one detached watcher and is a fast no-op otherwise.
+//
+// We thread SAPS_PYTHON (the owned uv runtime, so the watcher resolves a
+// playwright-capable interpreter on Lane B / .mcpb installs that have no system
+// python) and SAPS_LOG_DIR (the materialized repo's skill/logs, so the watcher
+// reads the SAME cycle logs this run writes to decide busy/idle). Fire-and-forget:
+// a failure here must never break the cycle it's decorating.
+async function ensureOverlayWatch() {
+    try {
+        await run("bash", ["skill/run-overlay-watch.sh"], {
+            timeoutMs: 20_000,
+            env: {
+                SAPS_PYTHON: resolvePython(),
+                SAPS_LOG_DIR: path.join(repoDir(), "skill", "logs"),
+                TWITTER_CDP_URL: process.env.TWITTER_CDP_URL || "http://127.0.0.1:9555",
+            },
+        });
+    }
+    catch {
+        /* best-effort: the overlay is a nicety, never a blocker */
+    }
+}
 async function produceDrafts(project, onProgress) {
     // Run the real pipeline in DRAFT_ONLY mode: scan -> score -> draft -> link-gen,
     // then STOP before posting. The script prints `DRAFT_ONLY_PLAN=<path>` and
@@ -240,6 +266,9 @@ async function produceDrafts(project, onProgress) {
     };
     if (project)
         env.SAPS_FORCE_PROJECT = project;
+    // Bring the on-screen overlay up alongside the live harness window so the user
+    // watching the scan/scrape sees status + queued drafts. Idempotent + detached.
+    await ensureOverlayWatch();
     let step = 0;
     let lastMsg = "";
     // ONE predictable, host-independent place to watch a draft_cycle run, so any
@@ -971,6 +1000,9 @@ tool("autopilot", {
         });
     }
     if (action === "enable") {
+        // Bring up the on-screen overlay watcher so background autopilot cycles
+        // still paint the harness status/sidebar. Idempotent + detached.
+        await ensureOverlayWatch();
         // 1) Cycle plist. Write one pointing at the self-update guard ONLY if no
         //    plist exists yet; never overwrite a hand-tuned/dev plist.
         const createdCycle = ensurePlist(TWITTER_AUTOPILOT_PLIST, plistXml({
@@ -1480,6 +1512,10 @@ tool("show_browser_to_user", {
         }
         return jsonContent({ ok: true, brought_to_front: true, port: res.port });
     }
+    // If the user is about to watch the live browser, make sure the on-screen
+    // overlay watcher is up too so the harness window carries status + drafts.
+    if (action === "start")
+        await ensureOverlayWatch();
     const ensured = await screencast.ensure(typeof args?.port === "number" ? args.port : undefined);
     if (!ensured.ok) {
         const message = ensured.error === "no_browser"

package/mcp/dist/version.json

@@ -1,4 +1,4 @@
 {
-  "version": "1.6.60",
-  "installedAt": "2026-06-05T02:22:33.297Z"
+  "version": "1.6.63",
+  "installedAt": "2026-06-05T03:14:19.604Z"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "social-autoposter",
-  "version": "1.6.62",
+  "version": "1.6.63",
   "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/skill/run-overlay-watch.sh

@@ -0,0 +1,79 @@
+#!/bin/bash
+# Idempotent supervisor for the twitter-harness on-screen overlay watcher.
+#
+# WHAT: keeps exactly ONE `harness_overlay.py watch` process alive. That watcher
+# injects the status overlay + interactive draft sidebar into the twitter-harness
+# Chrome window so a human watching the harness sees what the pipeline is doing
+# and can preview queued drafts.
+#
+# WHY a supervisor: the overlay only renders WHILE the watch process runs. It was
+# previously a manual, local-only process, so it never appeared on headless /
+# remote installs. This script makes it self-starting from BOTH install lanes:
+#   - Lane A (npm/cli): launchd job `com.m13v.social-overlay-watch` (StartInterval
+#     60 + RunAtLoad) re-invokes this script every minute; the pgrep guard makes
+#     re-invocation a no-op while the watcher is already up.
+#   - Lane B (.mcpb / pure MCP): the MCP calls this script on draft_cycle /
+#     autopilot-enable / show_browser_to_user, threading SAPS_PYTHON + SAPS_LOG_DIR.
+#
+# IDEMPOTENT: safe to call on a 60s timer. If a watcher is already running it
+# exits 0 immediately. Otherwise it spawns one detached (nohup, own session) and
+# returns; the spawned watcher then runs until the machine/MCP tears it down.
+#
+# This script is intentionally NOT locked: the overlay UX is expected to evolve.
+
+set -u
+
+# --- resolve the repo this script lives in (works from launchd + MCP cwd) -----
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_DIR="$(cd "${SCRIPT_DIR}/.." && pwd)"
+OVERLAY_PY="${REPO_DIR}/scripts/harness_overlay.py"
+
+if [ ! -f "${OVERLAY_PY}" ]; then
+  echo "[overlay-watch] harness_overlay.py not found at ${OVERLAY_PY}; nothing to do" >&2
+  exit 0
+fi
+
+# --- idempotency guard: at most one watcher, ever ----------------------------
+# Match the full `harness_overlay.py watch` invocation (NOT a bare `grep -r`, so
+# this never trips the BSD-grep-on-FIFO hang noted in the repo CLAUDE.md).
+if pgrep -f "harness_overlay.py watch" >/dev/null 2>&1; then
+  exit 0
+fi
+
+# --- resolve a python interpreter --------------------------------------------
+# harness_overlay.py self-heals to a playwright-capable interpreter on its own
+# (see _ensure_playwright_interpreter), so any python3 that exists is fine to
+# launch with. Prefer the MCP-threaded SAPS_PYTHON (owned uv runtime), then the
+# usual suspects.
+PYBIN=""
+for _cand in \
+  "${SAPS_PYTHON:-}" \
+  "/opt/homebrew/bin/python3.11" \
+  "/usr/bin/python3" \
+  "/opt/homebrew/bin/python3"
+do
+  if [ -n "${_cand}" ] && [ -x "${_cand}" ]; then PYBIN="${_cand}"; break; fi
+done
+if [ -z "${PYBIN}" ]; then
+  PYBIN="$(command -v python3 2>/dev/null || true)"
+fi
+if [ -z "${PYBIN}" ]; then
+  echo "[overlay-watch] no python3 found; cannot start overlay watcher" >&2
+  exit 0
+fi
+
+# --- env the watcher needs ---------------------------------------------------
+# SAPS_LOG_DIR: where harness_overlay.py reads cycle logs to decide busy/idle.
+# Default to this repo's skill/logs (MCP overrides it to the materialized repo).
+export SAPS_LOG_DIR="${SAPS_LOG_DIR:-${REPO_DIR}/skill/logs}"
+# CDP target for the twitter harness Chrome (honor BYO-Chrome installs).
+export TWITTER_CDP_URL="${TWITTER_CDP_URL:-http://127.0.0.1:9555}"
+mkdir -p "${SAPS_LOG_DIR}" 2>/dev/null || true
+WATCH_LOG="${SAPS_LOG_DIR}/overlay-watch.log"
+
+# --- spawn detached ----------------------------------------------------------
+cd "${REPO_DIR}" || exit 0
+echo "[overlay-watch] $(date '+%Y-%m-%d %H:%M:%S') starting watcher py=${PYBIN} cdp=${TWITTER_CDP_URL} log=${SAPS_LOG_DIR}" >>"${WATCH_LOG}" 2>&1
+nohup "${PYBIN}" "${OVERLAY_PY}" watch >>"${WATCH_LOG}" 2>&1 &
+disown 2>/dev/null || true
+exit 0