@m13v/s4l 1.6.197-rc.10

package/package.json

@@ -0,0 +1,160 @@
+{
+  "name": "@m13v/s4l",
+  "version": "1.6.197-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",
+    "s4l": "bin/cli.js"
+  },
+  "scripts": {
+    "start": "node bin/server.js",
+    "dev": "node --watch bin/server.js",
+    "release:mcpb": "bash scripts/release-mcpb.sh",
+    "test": "node test/platform.test.js && node test/launchd-golden.test.js && node test/systemd-golden.test.js && node mcp/scripts/test_onboarding_contract.mjs && node mcp/scripts/test_onboarding_ledger.mjs"
+  },
+  "files": [
+    "bin/",
+    "!bin/server.js",
+    "!bin/auth.js",
+    "scripts/*.py",
+    "!scripts/db_direct.py",
+    "!scripts/backfill_real_clicks.py",
+    "!scripts/historical_engagement.py",
+    "!scripts/style_length_report.py",
+    "!scripts/install_lane_monitor.py",
+    "!scripts/li_discover_insert.py",
+    "!scripts/_dm_record_sent.sh",
+    "!scripts/send_batch_dms.sh",
+    "!scripts/mint_podlog_subpage_*.py",
+    "!scripts/tmp_*.py",
+    "!scripts/insert_post*.py",
+    "!scripts/_insert_post_*.py",
+    "!scripts/_log_cyrano_*.py",
+    "!scripts/_redditlink_finalize.py",
+    "!scripts/_seo_lane_roi.py",
+    "!scripts/check_improve_runs.py",
+    "!scripts/classify_all_dms.py",
+    "!scripts/migrate_*.py",
+    "!scripts/_gsc_roi_query.py",
+    "!scripts/batch_send_dms.py",
+    "!scripts/finalize_post_*.py",
+    "!scripts/insert_li_notifs.py",
+    "!scripts/li_notif_scan_process.py",
+    "!scripts/phase_d_edit.py",
+    "!scripts/phase_d_new_comments.py",
+    "!scripts/realign_sequences.py",
+    "!scripts/scratch_*.py",
+    "!scripts/seed_dashboard_users.py",
+    "!scripts/send_dashboard_invite.py",
+    "!scripts/_dm_icp_batch.py",
+    "!scripts/_li_discover_pending.py",
+    "!scripts/_phaseA_build_envelope.py",
+    "!scripts/_phaseA_select_5AI7GO.py",
+    "!scripts/_scan_aggregate.py",
+    "!scripts/_scan_timeline.py",
+    "!scripts/_serp_report.py",
+    "!scripts/_serp_vs_gsc_report.py",
+    "!scripts/_test_since_hook.py",
+    "!scripts/add_deploy_metadata.py",
+    "!scripts/add_nightowl_to_config.py",
+    "!scripts/amplitude_user_lookup.py",
+    "!scripts/audit_signup_wiring.py",
+    "!scripts/backfill_aggregate_stats.py",
+    "!scripts/backfill_claude_session_subagents.py",
+    "!scripts/backfill_crossroute_attribution.py",
+    "!scripts/backfill_ensure_dms.py",
+    "!scripts/backfill_icp_precheck.py",
+    "!scripts/backfill_linkedin_activity_urns.py",
+    "!scripts/backfill_mk0r_get_started.py",
+    "!scripts/backfill_run_monitor.py",
+    "!scripts/backfill_seo_authors.py",
+    "!scripts/backfill_seo_engagement.py",
+    "!scripts/backfill_target_project.py",
+    "!scripts/blog_refactor_single_route.py",
+    "!scripts/browser_watch.py",
+    "!scripts/check_analytics_wiring.py",
+    "!scripts/check_backfill_replied.py",
+    "!scripts/check_contrast.py",
+    "!scripts/check_deploy_wiring.py",
+    "!scripts/check_layout_wiring.py",
+    "!scripts/check_link_rules.py",
+    "!scripts/check_pep604_annotations.py",
+    "!scripts/cleanup_moltbook_dupes_16060.py",
+    "!scripts/cohort_score_distribution.py",
+    "!scripts/daily_stats_email.py",
+    "!scripts/delete_twitter_posts.py",
+    "!scripts/dm_helper.py",
+    "!scripts/export_cdp_storage_state.py",
+    "!scripts/export_kent_handoff.py",
+    "!scripts/extract_user_messages_today.py",
+    "!scripts/fazm_seo_health.py",
+    "!scripts/fix_mdx_light_mode.py",
+    "!scripts/fix_style_lengths_20260601.py",
+    "!scripts/fix_svg_paragraph_wrap.py",
+    "!scripts/ig_collate_transcripts.py",
+    "!scripts/ingest_human_seo_replies.py",
+    "!scripts/install_lane_digest.py",
+    "!scripts/li_process_notifications.py",
+    "!scripts/li_process_notifs.py",
+    "!scripts/octolens_threads.py",
+    "!scripts/octolens_twitter_batch.py",
+    "!scripts/octolens_twitter_cdp.py",
+    "!scripts/poll_web_chat.py",
+    "!scripts/process_li_notifs.py",
+    "!scripts/project_deploy_status.py",
+    "!scripts/regenerate_ig_plists.py",
+    "!scripts/send_comment_replies.py",
+    "!scripts/seo_health_all_projects.py",
+    "!scripts/snapshot_style_targets.py",
+    "!scripts/socialcrawl.py",
+    "!scripts/sweep_guide_chrome.py",
+    "!scripts/sync_web_chat_config.py",
+    "!scripts/test_own_reply_dedup.py",
+    "!scripts/twitter_compose_dm.py",
+    "scripts/*.sh",
+    "!scripts/_dm_icp_batch.sh",
+    "config.example.json",
+    "requirements.txt",
+    "SKILL.md",
+    "skill/*.sh",
+    "skill/lib/*.sh",
+    "setup/SKILL.md",
+    "browser-agent-configs/",
+    "mcp-servers/",
+    "mcp/dist/",
+    "!mcp/dist/pipeline.tgz",
+    "mcp/shared/",
+    "mcp/menubar/",
+    "mcp/package.json",
+    "mcp/manifest.json",
+    "mcp/install.mjs",
+    "mcp/install-runtime.mjs",
+    "!**/__pycache__/**",
+    "!**/*.pyc"
+  ],
+  "keywords": [
+    "social-media",
+    "automation",
+    "claude",
+    "claude-code",
+    "ai-agent",
+    "reddit",
+    "twitter",
+    "linkedin"
+  ],
+  "author": "Matthew Diakonov",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/m13v/social-autoposter.git"
+  },
+  "homepage": "https://github.com/m13v/social-autoposter",
+  "engines": {
+    "node": ">=16"
+  },
+  "dependencies": {
+    "firebase-admin": "^13.8.0",
+    "pg": "^8.20.0",
+    "ws": "^8.0.0"
+  }
+}

package/requirements.txt

@@ -0,0 +1,20 @@
+# social-autoposter Python deps.
+# Installed by bin/cli.js on init/update into the SAPS_PYTHON interpreter
+# (Homebrew python), via `<saps_python> -m pip install -r requirements.txt`.
+# Playwright browser binaries are downloaded separately (same interpreter:
+# `<saps_python> -m playwright install chromium`).
+
+playwright
+# CDP client used by scripts/restore_twitter_session.py and the cookie-grab/
+# CDP-driven helpers. Required on AppMaker VMs for the post-substitution
+# auto-restore flow (bootstrap-vm, restore_twitter_session.py, CDP inject).
+websocket-client
+# AES-CBC decrypt of Chromium cookie values for scripts/copy_browser_cookies.py
+# (the connect_x auto-import that copies the user's x.com session from their
+# everyday browser into the autoposter's managed Chrome). Without this, the
+# MCP setup connect_x step cannot auto-import and falls back to manual login.
+cryptography
+# Error reporting for the Python posting pipeline -> Sentry (org mediar-n5),
+# initialized best-effort by scripts/sentry_init.py via scripts/http_api.py.
+# Safe no-op when absent or when no DSN is configured.
+sentry-sdk

package/scripts/_compute_allowlist.py

@@ -0,0 +1,58 @@
+import os, re, json, subprocess, glob
+REPO = os.path.expanduser("~/social-autoposter"); os.chdir(REPO)
+all_py = {os.path.basename(p) for p in glob.glob("scripts/*.py")}
+
+entry_surfaces = glob.glob("skill/*.sh") + glob.glob("skill/lib/*.sh")
+entry_surfaces += ["SKILL.md", "setup/SKILL.md", "bin/cli.js"]
+entry_surfaces += glob.glob("mcp/dist/*.js") + glob.glob("mcp/*.mjs")
+
+ref_re = re.compile(r"scripts/([A-Za-z0-9_]+)\.py")
+def refs_in_text(txt):
+    return {m+".py" for m in ref_re.findall(txt) if (m+".py") in all_py}
+
+entries, surface_hits = set(), {}
+for s in entry_surfaces:
+    if not os.path.exists(s): continue
+    txt = open(s, encoding="utf-8", errors="ignore").read()
+    # strip // comments for js, # comments for md is harder; keep simple: count all refs but mark cli.js comment lines
+    for fn in refs_in_text(txt):
+        entries.add(fn); surface_hits.setdefault(fn,set()).add(s)
+
+imp_res = [re.compile(r"^\s*import\s+([A-Za-z0-9_]+)", re.M),
+           re.compile(r"^\s*from\s+([A-Za-z0-9_]+)\s+import", re.M),
+           re.compile(r"^\s*from\s+scripts\s+import\s+([A-Za-z0-9_,\s]+)", re.M),
+           re.compile(r"^\s*from\s+scripts\.([A-Za-z0-9_]+)\s+import", re.M),
+           re.compile(r"^\s*import\s+scripts\.([A-Za-z0-9_]+)", re.M)]
+def expand(fn):
+    path=os.path.join("scripts",fn)
+    if not os.path.exists(path): return set()
+    txt=open(path,encoding="utf-8",errors="ignore").read()
+    found=set()
+    for rx in imp_res:
+        for g in rx.findall(txt):
+            for name in re.split(r"[,\s]+",g):
+                name=name.strip()
+                if name and (name+".py") in all_py: found.add(name+".py")
+    found |= refs_in_text(txt)   # NEW: intra-python subprocess scripts/X.py refs
+    # follow symlink targets too (update_stats.py -> stats.py)
+    if os.path.islink(path):
+        tgt=os.path.basename(os.readlink(path))
+        if tgt in all_py: found.add(tgt)
+    return found
+
+closure=set(entries); stack=list(entries)
+while stack:
+    for d in expand(stack.pop()):
+        if d not in closure: closure.add(d); stack.append(d)
+
+out=subprocess.run(["npm","pack","--dry-run","--json"],capture_output=True,text=True)
+shipped=sorted(os.path.basename(f["path"]) for f in json.loads(out.stdout)[0]["files"] if f["path"].startswith("scripts/") and f["path"].endswith(".py"))
+drop=sorted(set(shipped)-closure); keep=sorted(set(shipped)&closure)
+print("entries:",len(entries),"| closure:",len(closure),"| shipped:",len(shipped))
+print(f"\n=== KEEP (shipped & needed): {len(keep)}")
+print(f"=== DROP (shipped but unreferenced anywhere consumer): {len(drop)}")
+for d in drop:
+    if d=="_compute_allowlist.py": continue
+    print("   -",d)
+open("/tmp/keep.txt","w").write("\n".join(k for k in keep if k!="_compute_allowlist.py"))
+open("/tmp/drop.txt","w").write("\n".join(d for d in drop if d!="_compute_allowlist.py"))

package/scripts/_db_update.py

@@ -0,0 +1,20 @@
+#!/usr/bin/env python3
+"""Scratch driver: read JSON list of {post_id, session, text} from argv[1] and
+run link_edit_helper mark-edited + dm_short_links backfill-post for each.
+Gitignored scratch helper for the reddit link-edit run."""
+import json, subprocess, sys, os
+
+HERE = os.path.dirname(os.path.abspath(__file__))
+items = json.load(open(sys.argv[1]))
+for it in items:
+    pid = str(it["post_id"]); sess = it["session"]; text = it["text"]
+    src = it.get("source", "plain_url_ab_skip")
+    r1 = subprocess.run([sys.executable, os.path.join(HERE, "link_edit_helper.py"),
+                         "mark-edited", "--post-id", pid, "--content", text, "--source", src],
+                        capture_output=True, text=True)
+    r2 = subprocess.run([sys.executable, os.path.join(HERE, "dm_short_links.py"),
+                         "backfill-post", "--minted-session", sess, "--post-id", pid],
+                        capture_output=True, text=True)
+    bf = (r2.stdout or "").strip().splitlines()[-1:] or [""]
+    print(f"post {pid}: mark_edited_rc={r1.returncode} backfill={bf[0]}"
+          + (f" ERR1={r1.stderr.strip()}" if r1.returncode else ""))

package/scripts/_filt.py

@@ -0,0 +1,9 @@
+import sys,json
+d=json.load(sys.stdin)
+print("result_count:",d.get("result_count"),"error:",d.get("error"))
+for r in d.get("results",[])[:5]:
+    name=r.get("author_name")
+    hl=(r.get("author_headline") or "")[:75]
+    t=(r.get("post_text") or "")[:170].replace("\n"," ")
+    print("  - %s | %s | age=%sh rx=%s c=%s vs=%s" % (name,hl,r.get("age_hours"),r.get("reactions"),r.get("comments"),r.get("velocity_score")))
+    print("      "+t)

package/scripts/_li_notif_match.py

@@ -0,0 +1,76 @@
+import json, re
+
+items = json.load(open("/tmp/li_actionable.json"))
+cids = set(l.strip() for l in open("/tmp/li_cids.txt") if l.strip())
+pairs = set(l.strip() for l in open("/tmp/li_pairs.txt") if l.strip())
+posts = []
+for l in open("/tmp/li_posts.txt"):
+    l=l.strip()
+    if not l: continue
+    pid, _, url = l.partition("|")
+    posts.append((pid, url))
+
+EXCLUDED = {"louis030195","louis3195"}
+OWN = {"matthew diakonov","m13v"}
+
+def parse_urn(urn):
+    # urn:li:comment:(NS:PARENT,COMMENT)
+    m = re.match(r"urn:li:comment:\((\w+):(\d+),(\d+)\)", urn or "")
+    if not m: return (None,None,None)
+    return m.group(1), m.group(2), m.group(3)
+
+def find_post_id(parent_id):
+    for pid, url in posts:
+        if parent_id and parent_id in url:
+            return pid
+    return None
+
+def author_engaged(author, parent_id):
+    # any engaged pair with same author AND url containing parent_id
+    al = author.strip().lower()
+    for p in pairs:
+        a, _, url = p.partition("|||")
+        if a.strip().lower()==al and parent_id and parent_id in url:
+            return True
+    return False
+
+seen_batch = set()
+plan = []
+counts = dict(new=0, already=0, engaged=0, excluded=0, own=0, nourn=0, dup_batch=0)
+
+for it in items:
+    urn = it.get("comment_urn")
+    author = (it.get("author") or "").strip()
+    ns, parent_id, comment_id = parse_urn(urn)
+    rec = dict(it, ns=ns, parent_id=parent_id, comment_id=comment_id, decision=None, post_id=None)
+
+    if not urn or not parent_id:
+        rec["decision"]="skip:no_comment_urn"; counts["nourn"]+=1; plan.append(rec); continue
+    if urn in seen_batch:
+        rec["decision"]="skip:dup_in_batch"; counts["dup_batch"]+=1; plan.append(rec); continue
+    seen_batch.add(urn)
+    if urn in cids:
+        rec["decision"]="skip:already_tracked"; counts["already"]+=1; plan.append(rec); continue
+    al = author.lower()
+    if al in OWN or any(al==e for e in EXCLUDED):
+        rec["decision"]="skip:own_or_excluded"
+        if al in OWN: counts["own"]+=1
+        else: counts["excluded"]+=1
+        plan.append(rec); continue
+    if author_engaged(author, parent_id):
+        rec["decision"]="skip:author_already_engaged"; counts["engaged"]+=1; plan.append(rec); continue
+    pid = find_post_id(parent_id)
+    rec["post_id"]=pid
+    rec["decision"]="insert" if pid else "create_post+insert"
+    counts["new"]+=1
+    plan.append(rec)
+
+json.dump(plan, open("/tmp/li_plan.json","w"), indent=2)
+print("COUNTS:", counts)
+print("TOTAL inspected:", len(items))
+print()
+for r in plan:
+    if r["decision"].startswith("skip"): continue
+    print(f"[{r['decision']}] {r['author']} | ns={r['ns']} parent={r['parent_id']} post_id={r['post_id']}")
+    print(f"    urn: {r['comment_urn']}")
+    print(f"    snip: {r['snippet'][:120]}")

package/scripts/_li_notif_orchestrate.py

@@ -0,0 +1,126 @@
+#!/usr/bin/env python3
+import json, re, subprocess, os, sys
+
+REPO = os.path.expanduser("~/social-autoposter")
+LID = os.path.join(REPO, "scripts", "li_discovery.py")
+
+EXCLUDED_AUTHORS = {"louis030195", "louis3195"}
+OWN = {"matthew diakonov", "m13v"}
+
+def run(args):
+    r = subprocess.run([sys.executable, LID] + args, capture_output=True, text=True)
+    return (r.stdout or "").strip(), (r.stderr or "").strip(), r.returncode
+
+# one context dump
+ctx_out, ctx_err, rc = run(["context"])
+ctx = json.loads(ctx_out) if ctx_out else {}
+existing = set(ctx.get("existing_comment_ids") or [])
+engaged_pairs = ctx.get("engaged_pairs") or []
+posts = ctx.get("posts") or []
+
+PARENT_RE = re.compile(r"urn:li:(?:activity|ugcPost|share):(\d+)")
+
+# build parent_id -> post_id map
+parent_to_post = {}
+for p in posts:
+    u = p.get("our_url") or ""
+    m = PARENT_RE.search(u)
+    if m:
+        parent_to_post.setdefault(m.group(1), p["id"])
+
+# build engaged set (author_lower, parent_id)
+engaged_set = set()
+for pair in engaged_pairs:
+    if "|||" not in pair:
+        continue
+    author, url = pair.split("|||", 1)
+    m = PARENT_RE.search(url)
+    if m:
+        engaged_set.add((author.strip().lower(), m.group(1)))
+
+CU_RE = re.compile(r"\((?:activity|ugcPost|share):(\d+),(\d+)\)")
+
+data = json.load(open("/tmp/li_notifs.json"))
+
+counts = dict(scanned=len(data), new=0, already=0, engaged=0, excluded=0, own=0, no_urn=0)
+new_items = []
+
+def proj_for(snippet):
+    s = (snippet or "").lower()
+    # our niche is claude code / ai agents -> fazm flagship
+    if any(k in s for k in ["claude code", "claude.md", "agent", "context window", "mcp", "subagent", "harness", "codex", "anthropic", "llm", "ai "]):
+        return "fazm"
+    return "general"
+
+for it in data:
+    cu = it.get("comment_urn")
+    author = (it.get("author") or "").strip()
+    if not cu:
+        counts["no_urn"] += 1
+        continue
+    m = CU_RE.search(cu)
+    if not m:
+        counts["no_urn"] += 1
+        continue
+    parent_id = m.group(1)
+    al = author.lower()
+    # exclusion
+    if al in OWN or author in ("unknown",):
+        counts["own"] += 1
+        continue
+    if al in EXCLUDED_AUTHORS or any(x in al for x in EXCLUDED_AUTHORS):
+        counts["excluded"] += 1
+        continue
+    if cu in existing:
+        counts["already"] += 1
+        continue
+    if (al, parent_id) in engaged_set:
+        counts["engaged"] += 1
+        continue
+    # find or create post
+    post_id = parent_to_post.get(parent_id)
+    if not post_id:
+        proj = proj_for(it.get("snippet"))
+        out, err, rc = run(["create-post", "--activity-id", parent_id, "--project", proj, "--author", author])
+        post_id = out.strip().splitlines()[-1] if out.strip() else ""
+        if not post_id:
+            print(f"  [create-post FAILED parent={parent_id}] err={err}", file=sys.stderr)
+            continue
+        parent_to_post[parent_id] = post_id
+    # insert reply
+    out, err, rc = run([
+        "insert-reply", "--post-id", str(post_id),
+        "--comment-urn", cu, "--author", author,
+        "--content", (it.get("snippet") or "")[:3000],
+        "--href", it.get("href") or "",
+    ])
+    res = out.strip().splitlines()[-1] if out.strip() else ""
+    if res == "duplicate":
+        counts["already"] += 1
+    elif res.startswith("gated"):
+        counts["engaged"] += 1  # gated by blocklist/velocity, not actionable
+        print(f"  [gated] {author} parent={parent_id} -> {res}", file=sys.stderr)
+    elif res:
+        counts["new"] += 1
+        new_items.append((res, author, parent_id, cu))
+        # mark as existing to dedup within this run
+        existing.add(cu)
+        engaged_set.add((al, parent_id))
+    else:
+        print(f"  [insert FAILED] {author} parent={parent_id} err={err}", file=sys.stderr)
+
+print("\n=== NEW REPLIES INSERTED ===")
+for rid, author, parent, cu in new_items:
+    print(f"  reply_id={rid} author={author} parent={parent}")
+
+print("\n=== SUMMARY ===")
+print(f"New replies discovered:        {counts['new']}")
+print(f"Already tracked:               {counts['already']}")
+print(f"Author already engaged thread: {counts['engaged']}")
+print(f"Excluded:                      {counts['excluded']}")
+print(f"Own account:                   {counts['own']}")
+print(f"No comment URN:                {counts['no_urn']}")
+print(f"Total scanned:                 {counts['scanned']}")
+
+excl_total = counts["excluded"] + counts["own"]
+print(f"\nLINKEDIN_SCAN_SUMMARY: scanned={counts['scanned']} new={counts['new']} already={counts['already']} excluded={excl_total} unmatched={counts['no_urn']}")

package/scripts/_lock_preempt_test.py

@@ -0,0 +1,60 @@
+import json, os, sys, time, subprocess, signal
+sys.path.insert(0, os.path.join(os.path.dirname(__file__)))
+
+LOCK = os.path.expanduser("~/.claude/twitter-browser-lock.json")
+os.makedirs(os.path.dirname(LOCK), exist_ok=True)
+
+def write_lock(pid, role):
+    with open(LOCK, "w") as f:
+        json.dump({"session_id": f"python:{pid}", "timestamp": int(time.time()), "role": role}, f)
+
+def clean():
+    try: os.remove(LOCK)
+    except OSError: pass
+
+# ---- TEST 1: poster preempts a LIVE scan holder ----
+clean()
+victim = subprocess.Popen(["sleep", "120"])
+write_lock(victim.pid, "scan")
+os.environ["SAPS_LOCK_ROLE"] = "post"
+import importlib, twitter_browser
+importlib.reload(twitter_browser)
+t0 = time.time()
+twitter_browser._acquire_browser_lock()
+dt = time.time() - t0
+held = json.load(open(LOCK))
+victim_alive = victim.poll() is None
+print(f"TEST1 poster-preempts-scan: took={dt:.1f}s holder_now={held['session_id']} role={held.get('role')} victim_alive={victim_alive}")
+assert held["session_id"] == f"python:{os.getpid()}", "poster should hold lock"
+assert held.get("role") == "post"
+assert not victim_alive, "scan victim should be killed"
+assert dt < 10, "should preempt fast, not wait 45s"
+if victim.poll() is None: victim.kill()
+print("TEST1 PASS")
+
+# ---- TEST 2: scanner does NOT preempt a live POST holder (waits then gives up) ----
+clean()
+poster = subprocess.Popen(["sleep", "120"])
+write_lock(poster.pid, "post")
+os.environ["SAPS_LOCK_ROLE"] = "scan"
+twitter_browser.LOCK_WAIT_MAX = 4  # shorten the give-up window for the test
+twitter_browser.LOCK_ROLE = "scan"
+twitter_browser._LOCK_SESSION_ID = f"python:{os.getpid()}"
+twitter_browser._LOCK_INHERITED = False
+import io, contextlib
+t0 = time.time()
+rc = None
+try:
+    twitter_browser._acquire_browser_lock()
+    rc = "acquired"
+except SystemExit as e:
+    rc = f"exit:{e.code}"
+dt = time.time() - t0
+poster_alive = poster.poll() is None
+print(f"TEST2 scanner-vs-post: result={rc} took={dt:.1f}s poster_alive={poster_alive}")
+assert rc == "exit:1", "scanner must NOT take a live post holder; should give up"
+assert poster_alive, "scanner must NOT kill the poster"
+if poster.poll() is None: poster.kill()
+print("TEST2 PASS")
+clean()
+print("ALL PASS")

package/scripts/_run_icp_precheck.py

@@ -0,0 +1,57 @@
+#!/usr/bin/env python3
+"""Throwaway helper: run dm_conversation.py set-icp-precheck for every project.
+
+Usage:
+  python3 _run_icp_precheck.py --dm-id 4583 --default-label icp_miss \
+      --default-notes "crypto researcher, not target vertical" \
+      --override 'fazm=icp_miss=engaged on agentic token cost but no claude-code-wrapper signal' \
+      --override 'Agora=icp_miss=crypto researcher not a protocol governance buyer'
+
+Any project NOT overridden gets the default label/notes.
+"""
+import argparse, subprocess, sys
+
+PROJECTS = [
+    "fazm", "Terminator", "macOS MCP", "Vipassana", "S4L", "AI Browser Profile",
+    "WhatsApp MCP", "macOS Session Replay", "Cyrano", "Assrt", "PieLine", "Clone",
+    "mk0r", "fde10x", "claude-meter", "c0nsl", "tenxats", "paperback-expert",
+    "studyly", "Mediar", "NightOwl", "Runner", "Agora", "Podlog", "ccmd",
+]
+SCRIPT = "/Users/matthewdi/social-autoposter/scripts/dm_conversation.py"
+
+def main():
+    ap = argparse.ArgumentParser()
+    ap.add_argument("--dm-id", required=True)
+    ap.add_argument("--default-label", default="icp_miss")
+    ap.add_argument("--default-notes", default="not target vertical")
+    ap.add_argument("--override", action="append", default=[],
+                    help="PROJECT=LABEL=NOTES")
+    args = ap.parse_args()
+
+    overrides = {}
+    for o in args.override:
+        parts = o.split("=", 2)
+        if len(parts) != 3:
+            print("bad override:", o); sys.exit(2)
+        overrides[parts[0]] = (parts[1], parts[2])
+
+    # validate override keys
+    for k in overrides:
+        if k not in PROJECTS:
+            print("UNKNOWN project in override:", k); sys.exit(2)
+
+    fails = 0
+    for p in PROJECTS:
+        label, notes = overrides.get(p, (args.default_label, args.default_notes))
+        r = subprocess.run(
+            ["python3", SCRIPT, "set-icp-precheck", "--dm-id", args.dm_id,
+             "--project", p, "--label", label, "--notes", notes],
+            capture_output=True, text=True)
+        tag = "ok" if r.returncode == 0 else "FAIL"
+        if r.returncode != 0:
+            fails += 1
+        print(f"{tag} {p}={label}", (r.stderr or r.stdout or "").strip()[:120])
+    print(f"DONE dm={args.dm_id} fails={fails}")
+
+if __name__ == "__main__":
+    main()