social-autoposter 1.6.166 → 1.6.168

package/mcp/dist/index.js

@@ -271,9 +271,10 @@ const server = new McpServer({
         "user and offer to run `runtime` with action:'update'. The `project_config` tool's status also " +
         "surfaces `update_available` and an `update_hint`.\n\n" +
         "TYPICAL FLOW: `project_config` (connect X + scan the profile) -> `engagement_mode` (after the " +
-        "profile scan, ASK the user: grow their personal brand or promote a product, and set it — this " +
-        "provisions the persona) -> `project_config` (configure the product project; always, regardless " +
-        "of mode) -> `queue_setup` + " +
+        "profile scan: personal-brand is ON by default, so ASK the user the ONE question — do they ALSO " +
+        "want to promote a product? — and call action:'set' with personal_brand:true and " +
+        "promotion:true|false; this provisions the persona) -> IF they wanted promotion, `project_config` " +
+        "(configure the product project) -> `queue_setup` + " +
         "`create_scheduled_task` (set up the draft autopilot once) -> the autopilot then runs on its own " +
         "(scans, drafts via the queue + worker, and merges into the approval cards; nothing posts) -> the " +
         "user approves in the menu bar -> `post_drafts` (post the approved ones) -> `get_stats` (see " +
@@ -1042,26 +1043,39 @@ const WEBSITE_RESEARCH_INSTRUCTIONS = "PRODUCT RESEARCH (do this before saving t
 // provisions the persona project (grounded in the profile scan), then the agent
 // continues to product setup — a product is always configured regardless of mode.
 tool("engagement_mode", {
-    title: "Choose engagement mode (personal brand vs product)",
-    description: "Set or read the engagement MODE the autopilot drafts in. This is a SETUP step: AFTER X is " +
-        "connected and the profile is scanned, and BEFORE configuring the product, ASK the user which " +
-        "they want — (a) grow their PERSONAL BRAND (organic, link-free engagement in their own voice) or " +
-        "(b) PROMOTE a PRODUCT (the default marketing pipeline) — then call action:'set' with their " +
-        "choice. Pass the voice/description/topics you extracted from the profile scan so the persona is " +
-        "grounded in who they actually are (do this even for promotion, so the menu-bar toggle can flip " +
-        "to a good persona later). EITHER way, continue to configure the product project as usual " +
-        "afterward; a product is always set up. The user flips this mode any time from the menu-bar " +
-        "toggle.",
+    title: "Choose engagement lanes (personal brand + optional product promotion)",
+    description: "Set or read the engagement LANES the autopilot drafts in. There are TWO independent lanes that " +
+        "can BOTH be on (the cycle then splits 50/50): PERSONAL BRAND (organic, link-free engagement in " +
+        "the user's own voice — ON by default) and PRODUCT PROMOTION (the marketing pipeline, link " +
+        "replies — OFF by default, opt-in). This is a SETUP step: AFTER X is connected and the profile " +
+        "is scanned, personal-brand is already the default, so ASK the user the ONE question: do they " +
+        "ALSO want to promote a product? Then call action:'set' with personal_brand:true and " +
+        "promotion:true|false. Pass the voice/description/topics you extracted from the profile scan so " +
+        "the persona is grounded in who they actually are. If they want promotion too, continue to " +
+        "configure the product project with project_config afterward. The user flips either lane any " +
+        "time from the menu-bar checkmarks.",
     inputSchema: {
         action: z
             .enum(["get", "set", "toggle"])
             .optional()
-            .describe("get = read current mode + persona status. set = record the user's chosen mode (provisions the persona). toggle = lightweight flip promotion<->personal_brand (mode.json only, no persona work) — the dashboard/menu-bar quick toggle."),
+            .describe("get = read current lane flags + persona status. set = record the user's chosen lanes (provisions the persona). toggle = lightweight flip of ONE lane (pass `lane`); mode.json only, no persona work — the dashboard/menu-bar quick toggle."),
+        personal_brand: z
+            .boolean()
+            .optional()
+            .describe("action:'set' — turn the personal-brand lane on/off. Defaults to true (the out-of-the-box lane)."),
+        promotion: z
+            .boolean()
+            .optional()
+            .describe("action:'set' — turn the product-promotion lane on/off. Defaults to false; set true when the user says they also want to promote a product."),
+        lane: z
+            .enum(["personal_brand", "promotion"])
+            .optional()
+            .describe("action:'toggle' — which single lane to flip."),
         mode: z
             .enum(["personal_brand", "promotion"])
             .optional()
-            .describe("Required for action:'set'. personal_brand = organic brand growth (link-free, the user's " +
-            "own voice); promotion = market the configured product (default)."),
+            .describe("LEGACY (compat). Single-lane shorthand for action:'set': turns the named lane ON and the " +
+            "other OFF. Prefer the explicit personal_brand/promotion booleans."),
         description: z
             .string()
             .optional()
@@ -1081,37 +1095,62 @@ tool("engagement_mode", {
     },
 }, async (args) => {
     const action = args.action || "get";
+    const readFlags = async () => {
+        const cur = await runPython("scripts/saps_mode.py", ["flags"], { timeoutMs: 15_000 });
+        try {
+            const f = JSON.parse((cur.stdout || "").trim());
+            return { personal_brand: !!f.personal_brand, promotion: !!f.promotion };
+        }
+        catch {
+            return { personal_brand: true, promotion: false };
+        }
+    };
     if (action === "get") {
-        const cur = await runPython("scripts/saps_mode.py", ["get"], { timeoutMs: 15_000 });
-        const mode = (cur.stdout || "").trim() || "promotion";
+        const flags = await readFlags();
         const persona = findPersonaProject();
-        return jsonContent({ mode, persona: persona ? persona.name : null });
+        const mode = flags.personal_brand ? "personal_brand" : "promotion";
+        return jsonContent({ flags, mode, persona: persona ? persona.name : null });
     }
-    // Lightweight flip (the dashboard/menu-bar quick toggle): just rewrite
-    // mode.json via saps_mode.py — NO persona provisioning. Mirrors the menu
-    // bar's pure-local _toggle_mode so flipping from either surface is cheap.
+    // Lightweight flip of ONE lane (the dashboard/menu-bar quick toggle): just
+    // rewrite mode.json via saps_mode.py — NO persona provisioning. Mirrors the
+    // menu bar's pure-local _toggle_lane so flipping from either surface is cheap.
     if (action === "toggle") {
-        const cur = await runPython("scripts/saps_mode.py", ["get"], { timeoutMs: 15_000 });
-        const now = (cur.stdout || "").trim() || "promotion";
-        const next = now === "personal_brand" ? "promotion" : "personal_brand";
-        const res = await runPython("scripts/saps_mode.py", ["set", next], { timeoutMs: 15_000 });
+        const lane = args.lane === "promotion" ? "promotion" : "personal_brand";
+        const res = await runPython("scripts/saps_mode.py", ["toggle", lane], { timeoutMs: 15_000 });
         if (res.code !== 0) {
             const tail = (res.stderr || res.stdout).trim().split("\n").slice(-1)[0] || "unknown error";
-            return textContent(`Could not switch mode: ${tail}`);
+            return textContent(`Could not switch lane: ${tail}`);
+        }
+        try {
+            return jsonContent({ flags: JSON.parse((res.stdout || "").trim()) });
+        }
+        catch {
+            return jsonContent({ flags: await readFlags() });
         }
-        return jsonContent({ mode: next });
     }
-    const mode = args.mode;
-    if (mode !== "personal_brand" && mode !== "promotion") {
-        return textContent("Ask the user which they want, then call again with mode:'personal_brand' (organic brand " +
-            "growth, link-free) or mode:'promotion' (market the product, the default).");
+    // action === 'set'. Resolve the two lane flags. Explicit booleans win; the
+    // legacy `mode` shorthand maps to single-lane; default is personal ON.
+    let personalBrand;
+    let promotion;
+    if (args.mode === "personal_brand" || args.mode === "promotion") {
+        personalBrand = args.mode === "personal_brand";
+        promotion = args.mode === "promotion";
     }
-    recordOnboardingAttempt("mode_chosen", { mode });
-    const setRes = await runPython("scripts/saps_mode.py", ["set", mode], { timeoutMs: 15_000 });
+    else {
+        personalBrand = args.personal_brand === undefined ? true : !!args.personal_brand;
+        promotion = !!args.promotion;
+    }
+    if (!personalBrand && !promotion) {
+        return textContent("At least one lane must be on. personal_brand is the default; set promotion:true if the user " +
+            "also wants product promotion (both on -> the cycle splits 50/50).");
+    }
+    const mode = personalBrand ? "personal_brand" : "promotion";
+    recordOnboardingAttempt("mode_chosen", { personal_brand: personalBrand, promotion });
+    const setRes = await runPython("scripts/saps_mode.py", ["set-flags", personalBrand ? "1" : "0", promotion ? "1" : "0"], { timeoutMs: 15_000 });
     if (setRes.code !== 0) {
         const tail = (setRes.stderr || setRes.stdout).trim().split("\n").slice(-1)[0] || "unknown error";
-        blockOnboardingMilestone("mode_chosen", "mode_set_failed", tail, { mode });
-        return textContent(`Couldn't save the engagement mode: ${tail}`);
+        blockOnboardingMilestone("mode_chosen", "mode_set_failed", tail, { personal_brand: personalBrand, promotion });
+        return textContent(`Couldn't save the engagement lanes: ${tail}`);
     }
     // Provision the persona (grounded from the scan when supplied) regardless of
     // mode, so the toggle always has a real persona to flip to.
@@ -1144,21 +1183,28 @@ tool("engagement_mode", {
         personaTopicCount = m ? Number(m[1]) : 0;
         personaTopicsSeeded = true;
     }
-    completeOnboardingMilestone("mode_chosen", { mode, persona: personaName });
+    completeOnboardingMilestone("mode_chosen", { personal_brand: personalBrand, promotion, persona: personaName });
+    const bothOn = personalBrand && promotion;
+    const next_step = promotion
+        ? (bothOn
+            ? "Personal brand + product promotion are BOTH on (the cycle splits 50/50), and the persona " +
+                "is provisioned + topic-seeded. "
+            : "Product promotion is on and the persona is provisioned. ") +
+            "NOW CONTINUE SETUP: configure the product project with project_config (research the product " +
+            "site and fill description, icp, voice, search_topics)."
+        : "Personal-brand lane is on (the default) and the persona is provisioned + topic-seeded. The " +
+            "user did not ask for product promotion, so no product project is needed; they can turn on " +
+            "the promotion lane any time from the menu-bar checkmark. Setup can finish here.";
     return jsonContent({
         ok: true,
+        flags: { personal_brand: personalBrand, promotion },
         mode,
         persona: personaName,
         persona_created: personaCreated,
         persona_topics_seeded: personaTopicsSeeded,
         persona_topic_count: personaTopicCount,
         onboarding: onboardingSnapshot(),
-        next_step: (mode === "personal_brand"
-            ? "Personal-brand mode is set and the persona is provisioned + topic-seeded. "
-            : "Promotion mode is set (the default), and the persona is provisioned so the user can flip " +
-                "to personal-brand from the menu-bar toggle any time. ") +
-            "NOW CONTINUE SETUP: configure the product project with project_config (research the product " +
-            "site and fill description, icp, voice, search_topics) — a product is set up regardless of mode.",
+        next_step,
     });
 });
 tool("project_config", {
@@ -1411,17 +1457,19 @@ tool("project_config", {
                 "as GROUND TRUTH and, per grounding_instructions, extract their profession/identity, " +
                 "voice & vibe (tone, phrasing, casing, tics), 2-4 verbatim golden-rule example replies, " +
                 "a phrase bank + things they avoid, their icp, and recurring themes -> search_topics. " +
-                "SECOND (engagement mode — ASK THE USER, do not infer): ask whether they want to grow their " +
-                "PERSONAL BRAND (organic, link-free engagement in their own voice) or PROMOTE a PRODUCT (the " +
-                "default marketing pipeline), then call the `engagement_mode` tool action:'set' with their " +
-                "choice AND the voice/description/topics you just extracted (this provisions a persona " +
-                "grounded in this scan; pass the grounding even for promotion). " +
-                "THIRD (product, from their website — always, regardless of mode): follow " +
+                "SECOND (engagement lanes — ASK THE USER, do not infer): the PERSONAL BRAND lane (organic, " +
+                "link-free engagement in their own voice) is ON by default, so ask the ONE question — do they " +
+                "ALSO want to PROMOTE a PRODUCT (the marketing lane, link replies)? Both lanes can run (the " +
+                "cycle splits 50/50). Call the `engagement_mode` tool action:'set' with personal_brand:true, " +
+                "promotion:true|false AND the voice/description/topics you just extracted (this provisions a " +
+                "persona grounded in this scan). " +
+                "THIRD (product, ONLY if they wanted promotion): follow " +
                 "website_research_instructions — discover the product URL from config, context, profile " +
                 "links/posts, or public research and read 5+ of its pages to fill description, " +
                 "differentiator, icp, get_started_link, and content_guardrails, written in the voice you " +
                 "just captured. Save the best conservative supported fields without a confirmation " +
-                "round-trip. Ask only if no product can be identified or a required field is unknowable.",
+                "round-trip. Ask only if no product can be identified or a required field is unknowable. If " +
+                "they only want personal brand, SKIP the product step.",
         });
     }
     // Status / discovery mode: no project name supplied, or explicitly asked.
@@ -1467,6 +1515,7 @@ tool("project_config", {
             latest_version: ver.latest,
             update_available: ver.update_available,
             mode: currentMode(),
+            flags: currentFlags(),
             update_hint: ver.update_available
                 ? `A newer version (${ver.latest}) is available — you're on ${ver.installed}. ` +
                     `Tell the user and offer to run the \`runtime\` tool with action:'update' ` +
@@ -2819,7 +2868,7 @@ async function buildSnapshot() {
             auto_update_on: false, version: VERSION, latest_version: null,
             update_available: false, runtime_ready: runtimeReady(),
             runtime_provisioning: isProvisioning(), setup_complete: false,
-            mode: "promotion", onboarding: onboardingSnapshot(),
+            mode: currentMode(), flags: currentFlags(), onboarding: onboardingSnapshot(),
         };
     }
     // MCP-only side effects (snapshot.py is a pure reader and does none of these):
@@ -2994,17 +3043,31 @@ function modeChosen() {
         return false;
     }
 }
-// The current engagement mode ('promotion' | 'personal_brand'), surfaced in the
-// snapshot so the dashboard AND menu bar read it from ONE place (mode.json, the
-// same file saps_mode.py writes). Defaults to promotion when unset.
-function currentMode() {
+// The current engagement lane flags, surfaced in the snapshot so the dashboard
+// AND menu bar read them from ONE place (mode.json, the same file saps_mode.py
+// writes). Mirrors saps_mode.py get_flags(): explicit flag keys win; else map a
+// legacy {"mode": ...} string; else default personal ON / promotion OFF.
+function currentFlags() {
     try {
-        const m = (JSON.parse(fs.readFileSync(path.join(sapsStateDir(), "mode.json"), "utf-8")).mode || "").trim();
-        return m === "personal_brand" ? "personal_brand" : "promotion";
+        const d = JSON.parse(fs.readFileSync(path.join(sapsStateDir(), "mode.json"), "utf-8"));
+        if ("personal_brand" in d || "promotion" in d) {
+            return { personal_brand: !!d.personal_brand, promotion: !!d.promotion };
+        }
+        const m = (d.mode || "").trim();
+        if (m === "personal_brand")
+            return { personal_brand: true, promotion: false };
+        if (m === "promotion")
+            return { personal_brand: false, promotion: true };
     }
     catch {
-        return "promotion";
+        /* fall through to default */
     }
+    return { personal_brand: true, promotion: false };
+}
+// Derived legacy single-mode string (personal wins when on). Defaults to
+// personal_brand when unset (2026-06-29 default flip).
+function currentMode() {
+    return currentFlags().personal_brand ? "personal_brand" : "promotion";
 }
 // ---- Cross-instance "posting active" flag ----------------------------------
 // posting-active.json in the shared state dir is the CROSS-MCP-INSTANCE version