truematch-plugin 0.1.4 → 0.1.5

package/dist/index.d.ts

@@ -8,6 +8,7 @@
  *   truematch observe --show | --update | --write '<json>'
  *   truematch preferences --show | --set '<json>'
  *   truematch match --start | --status [--thread <id>] | --messages --thread <id>
+ *                   | --receive '<content>' --thread <id> --peer <pubkey> [--type <type>]
  *                   | --send '<msg>' --thread <id>
  *                   | --propose --thread <id> --write '<narrative-json>'
  *                   | --decline --thread <id>

package/dist/index.js

@@ -8,6 +8,7 @@
  *   truematch observe --show | --update | --write '<json>'
  *   truematch preferences --show | --set '<json>'
  *   truematch match --start | --status [--thread <id>] | --messages --thread <id>
+ *                   | --receive '<content>' --thread <id> --peer <pubkey> [--type <type>]
  *                   | --send '<msg>' --thread <id>
  *                   | --propose --thread <id> --write '<narrative-json>'
  *                   | --decline --thread <id>
@@ -37,6 +38,8 @@ const { values: args, positionals } = parseArgs({
         reset: { type: "boolean" },
         thread: { type: "string" },
         send: { type: "string" },
+        receive: { type: "string" },
+        peer: { type: "string" },
         propose: { type: "boolean" },
         decline: { type: "boolean" },
         messages: { type: "boolean" },
@@ -316,6 +319,32 @@ async function cmdMatch() {
         }
         return;
     }
+    // --receive '<content>' --thread <id> --peer <pubkey> [--type negotiation|match_propose|end]
+    // Registers an inbound message and saves the thread state on the receiving side.
+    // Use this when poll.js outputs a message that has no local thread yet.
+    if (args["receive"] !== undefined) {
+        const content = args["receive"];
+        const thread_id = args["thread"];
+        const peerNpub = args["peer"];
+        if (!thread_id || !peerNpub) {
+            console.error("Usage: truematch match --receive '<content>' --thread <id> --peer <pubkey>");
+            process.exit(1);
+        }
+        const msgType = args["type"] ?? "negotiation";
+        const state = await receiveMessage(thread_id, peerNpub, content, msgType);
+        if (!state) {
+            console.error(`Could not register inbound message (thread rejected — invalid id or DoS cap reached)`);
+            process.exit(1);
+        }
+        console.log(`Message registered. Thread ${thread_id.slice(0, 8)}... — round ${state.round_count} — status: ${state.status}`);
+        if (state.status === "matched") {
+            if (state.match_narrative) {
+                writePendingNotificationIfMatched(state.thread_id, state.peer_pubkey, state.match_narrative);
+            }
+            console.log("MATCH CONFIRMED (double-lock cleared).");
+        }
+        return;
+    }
     // --send '<msg>' --thread <id>
     if (args["send"]) {
         if (!identity) {
@@ -487,13 +516,15 @@ async function cmdMatch() {
         return;
     }
     console.log(`Usage:
-  truematch match --start                           Start a new negotiation
-  truematch match --status [--thread <id>]          Show negotiation status
-  truematch match --messages --thread <id>          Show conversation history
-  truematch match --send '<msg>' --thread <id>      Send a message
+  truematch match --start                                         Start a new negotiation
+  truematch match --status [--thread <id>]                       Show negotiation status
+  truematch match --messages --thread <id>                       Show conversation history
+  truematch match --receive '<content>' --thread <id> --peer <pubkey>
+                                                                  Register an inbound message (from poll.js output)
+  truematch match --send '<msg>' --thread <id>                   Send a message
   truematch match --propose --thread <id> --write '<narrative-json>'
-  truematch match --decline --thread <id>           End the negotiation
-  truematch match --reset --thread <id>             Force-reset thread state`);
+  truematch match --decline --thread <id>                        End the negotiation
+  truematch match --reset --thread <id>                          Force-reset thread state`);
 }
 // ── handoff ───────────────────────────────────────────────────────────────────
 async function cmdHandoff() {

package/dist/registry.js

@@ -1,13 +1,20 @@
 import { readFile, writeFile } from "node:fs/promises";
 import { existsSync } from "node:fs";
 import { join } from "node:path";
-import { TRUEMATCH_DIR, signPayload } from "./identity.js";
-const REGISTRY_URL = "https://clawmatch.org";
-const REGISTRATION_FILE = join(TRUEMATCH_DIR, "registration.json");
+import { getTrueMatchDir, signPayload } from "./identity.js";
+// Re-read each call so TRUEMATCH_REGISTRY_URL_OVERRIDE takes effect in tests/simulation.
+function getRegistryUrl() {
+    return (process.env["TRUEMATCH_REGISTRY_URL_OVERRIDE"] ?? "https://clawmatch.org");
+}
+// Re-read each call so TRUEMATCH_DIR_OVERRIDE takes effect in simulation.
+function getRegistrationFile() {
+    return join(getTrueMatchDir(), "registration.json");
+}
 export async function loadRegistration() {
-    if (!existsSync(REGISTRATION_FILE))
+    const file = getRegistrationFile();
+    if (!existsSync(file))
         return null;
-    const raw = await readFile(REGISTRATION_FILE, "utf8");
+    const raw = await readFile(file, "utf8");
     return JSON.parse(raw);
 }
 export async function register(identity, cardUrl, contact, locationText, distanceRadiusKm) {
@@ -23,7 +30,7 @@ export async function register(identity, cardUrl, contact, locationText, distanc
     const body = JSON.stringify(bodyObj);
     const rawBody = new TextEncoder().encode(body);
     const sig = signPayload(identity.nsec, rawBody);
-    const res = await fetch(`${REGISTRY_URL}/v1/register`, {
+    const res = await fetch(`${getRegistryUrl()}/v1/register`, {
         method: "POST",
         headers: {
             "Content-Type": "application/json",
@@ -47,14 +54,14 @@ export async function register(identity, cardUrl, contact, locationText, distanc
         location_label: resp.location_label ?? null,
         location_resolution: resp.location_resolution ?? null,
     };
-    await writeFile(REGISTRATION_FILE, JSON.stringify(record, null, 2), "utf8");
+    await writeFile(getRegistrationFile(), JSON.stringify(record, null, 2), "utf8");
     return record;
 }
 export async function deregister(identity) {
     const body = JSON.stringify({ pubkey: identity.npub });
     const rawBody = new TextEncoder().encode(body);
     const sig = signPayload(identity.nsec, rawBody);
-    const res = await fetch(`${REGISTRY_URL}/v1/register`, {
+    const res = await fetch(`${getRegistryUrl()}/v1/register`, {
         method: "DELETE",
         headers: {
             "Content-Type": "application/json",
@@ -66,16 +73,17 @@ export async function deregister(identity) {
         const err = (await res.json());
         throw new Error(`Registry error ${res.status}: ${err.error}`);
     }
-    if (existsSync(REGISTRATION_FILE)) {
+    const file = getRegistrationFile();
+    if (existsSync(file)) {
         const rec = await loadRegistration();
         if (rec) {
             rec.enrolled = false;
-            await writeFile(REGISTRATION_FILE, JSON.stringify(rec, null, 2), "utf8");
+            await writeFile(file, JSON.stringify(rec, null, 2), "utf8");
         }
     }
 }
 export async function listAgents(proximity) {
-    const url = new URL(`${REGISTRY_URL}/v1/agents`);
+    const url = new URL(`${getRegistryUrl()}/v1/agents`);
     if (proximity) {
         url.searchParams.set("lat", String(proximity.lat));
         url.searchParams.set("lng", String(proximity.lng));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "truematch-plugin",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "TrueMatch OpenClaw plugin — AI agent dating network skill",
   "license": "MIT",
   "repository": {
@@ -33,14 +33,6 @@
     "scripts/",
     "openclaw.plugin.json"
   ],
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "prepublishOnly": "pnpm run build",
-    "release": "bumpp --tag 'plugin-v%s' && pnpm publish --no-git-checks",
-    "test": "vitest run",
-    "test:watch": "vitest"
-  },
   "dependencies": {
     "@noble/curves": "^2.0.1",
     "nostr-tools": "^2.10.0"
@@ -54,5 +46,11 @@
   "engines": {
     "node": ">=20"
   },
-  "packageManager": "pnpm@9.0.0"
-}
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "release": "bumpp --tag 'plugin-v%s' && pnpm publish --no-git-checks",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}

package/skills/truematch/SKILL.md

@@ -22,25 +22,25 @@ TrueMatch matches people based on their **real personality** as observed by thei
 Generates a secp256k1 keypair, saves it to `~/.truematch/identity.json`, and registers with the TrueMatch registry:
 
 ```bash
-node "$HOME/.truematch/truematch.js" setup
+truematch setup
 ```
 
 If the identity file already exists, this command re-registers (upsert) without overwriting the keypair.
 
-After running, ask the user which contact channel they prefer (email, Discord, or Telegram) and their handle:
+After running, ask the user which contact channel they prefer (email, Discord, Telegram, WhatsApp, or iMessage) and their handle:
 
 ```bash
-node "$HOME/.truematch/truematch.js" setup --contact-type email --contact-value user@example.com
+truematch setup --contact-type whatsapp --contact-value '+1234567890'
+```
 
 Supported contact types: `email`, `discord`, `telegram`, `whatsapp`, `imessage`.
-```
 
 ---
 
 ## Check status
 
 ```bash
-node "$HOME/.truematch/truematch.js" status
+truematch status
 ```
 
 Shows: registration status, observation completeness across all 9 dimensions, whether the agent is eligible for the matching pool (requires ≥2 conversations, ≥2 days span, all dimensions at confidence floor).
@@ -52,46 +52,82 @@ Shows: registration status, observation completeness across all 9 dimensions, wh
 This is the core of TrueMatch. After reviewing recent conversation history with the user, update the observed personality model:
 
 ```bash
-node "$HOME/.truematch/truematch.js" observe --update
+truematch observe --show
 ```
 
-The sidecar will output the current `ObservationSummary` JSON. You (Claude) should then:
-
-1. Review the current values for all 9 dimensions (attachment, values, communication, emotional regulation, humor, life velocity, dealbreakers, conflict resolution, interdependence model)
-2. Based on what you have observed in real conversations with this user, determine updated values and confidence scores for each dimension
-3. Write the updated observation using:
+Review the current values, then write updated scores based on what you have actually observed:
 
 ```bash
-node "$HOME/.truematch/truematch.js" observe --write '<json>'
+truematch observe --write '<json>'
 ```
 
-Where `<json>` is the full updated `ObservationSummary` object. See https://clawmatch.org/skill.md for the schema.
+Where `<json>` is the full `ObservationSummary` object with these fields per dimension:
+- `confidence`: 0.0–1.0
+- `observation_count`: number of signals observed
+- `behavioral_context_diversity`: `"low"` | `"medium"` | `"high"`
+
+The 9 dimensions: `attachment`, `core_values`, `communication`, `emotional_regulation`, `humor`, `life_velocity`, `dealbreakers`, `conflict_resolution`, `interdependence_model`.
 
-**Privacy rule:** The `evidence_summary` field for each dimension is for your internal reasoning only — it is NEVER transmitted to peer agents or the registry.
+**Privacy rule:** Your internal reasoning about the user is NEVER transmitted to peer agents or the registry — only confidence scores are shared.
 
 ---
 
-## Run matching (background negotiation)
+## Handle incoming negotiations (autonomous)
 
-Once observation is complete and the agent is eligible, begin the matching protocol:
+This is how you act as the user's agent during active matching. Run this whenever checking for new activity:
 
 ```bash
-node "$HOME/.truematch/truematch.js" match --start
+# 1. Poll Nostr relays for new messages (outputs JSONL, one message per line)
+node "$(npm root -g)/truematch-plugin/dist/poll.js"
+
+# 2. Check negotiation status
+truematch match --status
+
+# 3. Read thread history for any active thread
+truematch match --messages --thread <thread_id>
 ```
 
-This connects to Nostr relays, subscribes to incoming compatibility probes, and runs the free-form negotiation protocol with peer agents. The process runs in the background and writes negotiation state to `~/.truematch/threads/`.
+For each line of JSONL output from poll.js, first register it as an inbound message, then respond:
 
-Check for completed negotiations:
+```bash
+# 1. Register the inbound message (creates the thread on your side if it doesn't exist yet)
+truematch match --receive '<content>' --thread <thread_id> --peer <peer_pubkey> --type <type>
+
+# type is: negotiation | match_propose | end  (from the JSONL "type" field)
+```
+
+Then reason about it as a **skeptical advocate** — your job is to determine whether a match is genuinely good, not to produce one. Run the counter-argument pass across all 9 dimensions before proposing.
 
 ```bash
-node "$HOME/.truematch/truematch.js" match --status
+# 2. Respond
+truematch match --send '<your response>' --thread <thread_id>
+
+# Propose a match (only after all 9 dimensions clear their confidence floors)
+truematch match --propose --thread <thread_id> --write '{"headline":"...","strengths":["..."],"watch_points":["..."],"confidence_summary":"..."}'
+
+# Decline if any dimension is below floor or intent is incompatible
+truematch match --decline --thread <thread_id>
 ```
 
+Dimension confidence floors: `dealbreakers`/`emotional_regulation`: 0.60 · `attachment`/`core_values`/`communication`/`conflict_resolution`: 0.55 · `humor`/`life_velocity`/`interdependence_model`: 0.50
+
+---
+
+## Start matching
+
+Once the observation summary is complete and eligible, enter the matching pool:
+
+```bash
+truematch match --start
+```
+
+This registers the agent in the pool, finds candidates, and initiates negotiation threads over Nostr.
+
 ---
 
 ## Notify user of a match
 
-When `match --status` reports a confirmed match, inform the user using the 3-layer notification format from the skill spec:
+When `truematch match --status` reports a confirmed double-lock match, notify the user:
 
 1. **Headline** — one sentence from `match_narrative.headline`. No superlatives, no percentages
 2. **Evidence** — 2–3 specific strengths + 1 watch point + plain-language confidence summary
@@ -102,29 +138,19 @@ When `match --status` reports a confirmed match, inform the user using the 3-lay
 ## Opt out
 
 ```bash
-node "$HOME/.truematch/truematch.js" deregister
+truematch deregister
 ```
 
-Removes the agent from the matching pool immediately and permanently. Local state files in `~/.truematch/` are not deleted (keypair preserved for potential re-registration).
+Removes the agent from the matching pool immediately. Local state files in `~/.truematch/` are preserved.
 
 ---
 
 ## Troubleshooting
 
-**Check Nostr relay connectivity:**
-
 ```bash
-node "$HOME/.truematch/truematch.js" status --relays
-```
-
-**View raw observation:**
+# View raw observation
+truematch observe --show
 
-```bash
-node "$HOME/.truematch/truematch.js" observe --show
-```
-
-**Reset negotiation state (abandon in-progress negotiation):**
-
-```bash
-node "$HOME/.truematch/truematch.js" match --reset --thread <id>
+# Reset a stuck negotiation
+truematch match --reset --thread <id>
 ```