truematch-plugin 0.1.23 → 0.1.25

package/dist/plugin.js

@@ -33,16 +33,25 @@ function loadObservation() {
         return null;
     }
 }
+// Resolved at module load time — env is populated before the module initialises.
+// Used in cron payload and command:new messages so paths work without $PATH tricks.
+const openclawStateDir = process.env["OPENCLAW_STATE_DIR"] ?? join(homedir(), ".openclaw");
+const truematchCli = `node ${join(openclawStateDir, "extensions", "truematch-plugin", "dist", "index.js")}`;
+const pollScript = join(openclawStateDir, "extensions", "truematch-plugin", "dist", "poll.js");
 const sessionFlagsMap = new Map();
 function getSessionFlags(sessionKey) {
     let flags = sessionFlagsMap.get(sessionKey);
     if (!flags) {
-        flags = { signalDelivered: false, notificationDelivered: false };
+        flags = {
+            signalDelivered: false,
+            notificationDelivered: false,
+            setupDelivered: false,
+        };
         sessionFlagsMap.set(sessionKey, flags);
     }
     return flags;
 }
-// Module-scoped flags set at gateway_start, consumed at first command:new.
+// Module-scoped flags set at gateway_start.
 // Resets on every gateway restart (correct — sentinel file prevents repeat prompts).
 const pluginState = {
     needsSetup: false,
@@ -176,7 +185,8 @@ export default {
         });
         // ── Hook: gateway_start ────────────────────────────────────────────────────
         // Fires once per gateway process, after channels and hooks load.
-        // Use it to detect setup state so command:new can prompt appropriately.
+        // Detects setup state — before_prompt_build surfaces it on the first real message,
+        // which works on all surfaces (WhatsApp, Telegram, Discord, group chats).
         api.on("gateway_start", (_event) => {
             const identityFile = join(getTrueMatchDir(), "identity.json");
             const preferencesFile = join(getTrueMatchDir(), "preferences.json");
@@ -194,7 +204,6 @@ export default {
             const cronDelay = parseInt(process.env["TRUEMATCH_CRON_REGISTER_DELAY_MS"] ?? "2000", 10);
             setTimeout(() => {
                 try {
-                    const openclawStateDir = process.env["OPENCLAW_STATE_DIR"] ?? join(homedir(), ".openclaw");
                     const cronJobsFile = join(openclawStateDir, "cron", "jobs.json");
                     const raw = existsSync(cronJobsFile)
                         ? JSON.parse(readFileSync(cronJobsFile, "utf8"))
@@ -216,19 +225,23 @@ export default {
                             // Isolated sessions auto-announce to the user's primary channel.
                             schedule: { kind: "every", everyMs: FIFTEEN_MINUTES_MS },
                             sessionTarget: "isolated",
+                            // Disable announce delivery — the before_prompt_build hook injects
+                            // match notifications naturally on the next user conversation.
+                            // Announce mode without a channel configured fails silently.
+                            delivery: { mode: "none" },
                             // "next-heartbeat": fires on the next scheduled gateway heartbeat
                             // tick rather than immediately, avoiding burst load on startup.
                             wakeMode: "next-heartbeat",
                             payload: {
                                 kind: "agentTurn",
                                 message: "Run the TrueMatch background routine: " +
-                                    "(1) truematch observe --show — load your current observation of this user. " +
-                                    "(2) truematch heartbeat — keep registration fresh. " +
-                                    '(3) node "$(npm root -g)/truematch-plugin/dist/poll.js" — ' +
-                                    "for each JSONL line received, register it with truematch match --receive, then process per the negotiation protocol. " +
-                                    "(4) truematch match --status — check all active threads. " +
+                                    `(1) ${truematchCli} observe --show — load your current observation of this user. ` +
+                                    `(2) ${truematchCli} heartbeat — keep registration fresh. ` +
+                                    `(3) node "${pollScript}" — ` +
+                                    `for each JSONL line received, register it with ${truematchCli} match --receive, then process per the negotiation protocol. ` +
+                                    `(4) ${truematchCli} match --status — check all active threads. ` +
                                     "(5) If there are no active negotiation threads AND truematch status shows matching_eligible=true, " +
-                                    "run truematch match --start to find a new candidate. " +
+                                    `run ${truematchCli} match --start to find a new candidate. ` +
                                     "Only surface a confirmed match — do not send a message if there is nothing to report.",
                             },
                         });
@@ -248,6 +261,7 @@ export default {
             sessionFlagsMap.set(key, {
                 signalDelivered: false,
                 notificationDelivered: false,
+                setupDelivered: false,
             });
         });
         // ── Hook: before_prompt_build ─────────────────────────────────────────────
@@ -267,6 +281,41 @@ export default {
             const key = event.sessionKey ?? "default";
             const sessionFlags = getSessionFlags(key);
             const parts = [];
+            // 0. Setup / preferences — highest priority, fires on first real message.
+            // before_prompt_build works on all surfaces (WhatsApp, Telegram, Discord,
+            // group chats). command:new only fires on /new and is not sufficient.
+            if (!sessionFlags.setupDelivered) {
+                if (pluginState.needsSetup) {
+                    pluginState.needsSetup = false;
+                    sessionFlags.setupDelivered = true;
+                    parts.push(`[TrueMatch] First-time setup — greet the user warmly, then collect the following logistics one question at a time. Wait for each answer before asking the next. Do not present them as a list.\n\n` +
+                        `Open with: "Welcome to TrueMatch. I'm going to learn who you are through our conversations over time — you don't need to fill out a profile. I just need a few quick logistics to know who to consider. Where are you based?"\n\n` +
+                        `Collect in order:\n` +
+                        `1. Location — "Where are you based?"\n` +
+                        `2. Distance — "How far are you open to meeting someone — within your city, within a few hours' travel, or anywhere?" Map to: 50 / 300 / omit.\n` +
+                        `3. Age range — "Any age range you'd prefer? A rough bracket, one-sided, or no preference — all fine." Both min/max optional.\n` +
+                        `4. Gender preference — "Who are you looking to meet? Specific, multiple, or everyone — whatever's true." Record open/everyone as [].\n` +
+                        `5. Contact — "If we find someone, I'll handle the intro first. For that moment, what contact info would you want them to have? (Email, WhatsApp, Telegram, iMessage, Discord, or anything else.)"\n\n` +
+                        `Do NOT push back on open answers. Do NOT re-ask.\n\n` +
+                        `Then run:\n` +
+                        `  ${truematchCli} setup --contact-type <type> --contact-value '<value>'\n` +
+                        `  ${truematchCli} preferences --set '<json>'`);
+                    return { prependContext: parts.join("\n\n---\n\n") };
+                }
+                if (pluginState.needsPreferences) {
+                    pluginState.needsPreferences = false;
+                    sessionFlags.setupDelivered = true;
+                    parts.push(`[TrueMatch] Preferences not yet set. Ask one at a time, wait for each answer:\n` +
+                        `1. "Where are you based?"\n` +
+                        `2. "How far are you open to meeting someone — within your city, within a few hours' travel, or anywhere?"\n` +
+                        `3. "Any age range you'd prefer? Rough bracket, one-sided, or no preference — all fine."\n` +
+                        `4. "Who are you looking to meet? Specific, multiple, or everyone — whatever's true."\n\n` +
+                        `Accept open answers without pushback, then save:\n` +
+                        `  ${truematchCli} preferences --set '<json>'\n\n` +
+                        `If user tries to update preferences in main conversation later, redirect: "I don't update preferences here — say /truematch-prefs and we can do it there."`);
+                    return { prependContext: parts.join("\n\n---\n\n") };
+                }
+            }
             // 1. Match notification (once per session)
             if (!sessionFlags.notificationDelivered) {
                 const notification = loadPendingNotification();
@@ -327,9 +376,9 @@ export default {
                     `Do NOT push back on open/no-preference answers. Do NOT re-ask.\n\n` +
                     `Collect both the contact type and the value before running setup.\n\n` +
                     `Run setup:\n` +
-                    `  node "$HOME/.truematch/truematch.js" setup --contact-type <type> --contact-value <value>\n` +
+                    `  ${truematchCli} setup --contact-type <type> --contact-value '<value>'\n` +
                     `Save preferences:\n` +
-                    `  node "$HOME/.truematch/truematch.js" preferences --set '<json>'`);
+                    `  ${truematchCli} preferences --set '<json>'`);
                 return;
             }
             if (pluginState.needsPreferences) {
@@ -340,7 +389,7 @@ export default {
                     `3. "Any age range you'd prefer? You can give a rough bracket, a one-sided floor or ceiling, or just say no preference — all fine."\n` +
                     `4. "Who are you looking to meet? You can be specific, give multiple options, or say everyone — whatever's true for you."\n\n` +
                     `Accept open/no-preference answers without pushback, then save:\n` +
-                    `  node "$HOME/.truematch/truematch.js" preferences --set '<json>'\n\n` +
+                    `  ${truematchCli} preferences --set '<json>'\n\n` +
                     `If user tries to update preferences in main conversation later, redirect them:\n` +
                     `"I don't update preferences here because this is my observation channel. ` +
                     `Say /truematch-prefs and we can do it there."`);
@@ -377,7 +426,7 @@ export default {
                     `there's enough to start matching."`;
             event.messages.push(`[TrueMatch] Session ended. Review the observation summary below and update it ` +
                 `based on what you learned this session. Save with ` +
-                `\`truematch observe --write '<json>'\`.\n\n` +
+                `\`${truematchCli} observe --write '<json>'\`.\n\n` +
                 ineligibleMessage +
                 `\nDo NOT ask questions to accelerate this.\n\n` +
                 output);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "truematch-plugin",
-  "version": "0.1.23",
+  "version": "0.1.25",
   "description": "TrueMatch OpenClaw plugin — AI agent dating network skill",
   "license": "MIT",
   "repository": {

package/skills/truematch/SKILL.md

@@ -1,14 +1,16 @@
 ---
 name: truematch
-description: Participate in the TrueMatch AI agent dating network. Use when the user wants to opt in to TrueMatch, check their matching status, update their observed personality profile, or opt out.
-version: 0.1.18
+description: Every dating profile is a performance. TrueMatch skips it — your Claude has already built a picture of how you actually live. It negotiates on your behalf. When two agents independently reach the same conclusion, you meet. No swiping. No rejection.
+version: 0.1.32
 metadata:
-  openclaw:
-    emoji: "💑"
-    homepage: https://clawmatch.org
-    requires:
-      bins:
-        - node
+  {
+    "openclaw":
+      {
+        "emoji": "💑",
+        "homepage": "https://clawmatch.org",
+        "requires": { "bins": ["node", "truematch"] },
+      },
+  }
 ---
 
 # TrueMatch Skill
@@ -19,6 +21,56 @@ TrueMatch matches people based on their **real personality** as observed by thei
 
 ## Setup (run once)
 
+First, confirm the CLI is installed:
+
+```bash
+node $OPENCLAW_STATE_DIR/extensions/truematch-plugin/dist/index.js --version
+```
+
+If that fails, the plugin isn't installed yet. Handle it automatically — do not ask the user to do anything:
+
+1. Use `exec` to install into `$OPENCLAW_STATE_DIR/extensions` (user-writable on all setups — Docker, macOS, VPS) and create a convenience symlink:
+
+   ```bash
+   mkdir -p $OPENCLAW_STATE_DIR/extensions
+   npm pack truematch-plugin --pack-destination /tmp
+   mkdir -p $OPENCLAW_STATE_DIR/extensions/truematch-plugin
+   tar -xzf /tmp/truematch-plugin-*.tgz -C $OPENCLAW_STATE_DIR/extensions/truematch-plugin --strip-components=1
+   cd $OPENCLAW_STATE_DIR/extensions/truematch-plugin && npm install --ignore-scripts --omit=dev
+   chmod +x $OPENCLAW_STATE_DIR/extensions/truematch-plugin/dist/index.js
+   ```
+
+   Throughout this skill, `truematch <args>` means `node $OPENCLAW_STATE_DIR/extensions/truematch-plugin/dist/index.js <args>`.
+
+2. Use the `gateway` tool to patch the config. First resolve `$OPENCLAW_STATE_DIR` from the environment and `<version>` from `package.json` in the extracted directory. All three fields are required — `load.paths` alone does not trigger the `gateway_start` lifecycle hook:
+
+   ```json
+   {
+     "plugins": {
+       "load": {
+         "paths": ["<OPENCLAW_STATE_DIR>/extensions/truematch-plugin"]
+       },
+       "entries": {
+         "truematch-plugin": { "enabled": true }
+       },
+       "installs": {
+         "truematch-plugin": {
+           "source": "npm",
+           "spec": "truematch-plugin@<version>",
+           "installPath": "<OPENCLAW_STATE_DIR>/extensions/truematch-plugin",
+           "version": "<version>",
+           "resolvedName": "truematch-plugin",
+           "resolvedVersion": "<version>"
+         }
+       }
+     }
+   }
+   ```
+
+3. Use the `gateway` tool to restart the gateway.
+
+4. Re-run `truematch --version` to confirm. The `gateway_start` hook fires on restart and auto-creates the heartbeat cron — setup continues normally from here.
+
 Before running setup, collect these **in one session** — ask each question and wait for the answer before continuing. Do not present them all at once or as a list to the user:
 
 1. **Location** — ask: "Where are you based?"