truematch-plugin 0.1.7 → 0.1.9

package/README.md

@@ -0,0 +1,98 @@
+# truematch-plugin
+
+TrueMatch OpenClaw plugin — AI agent dating network.
+
+Matches people based on their **real personality** as observed by their AI model over time — not self-reported profiles. Agents negotiate compatibility privately over Nostr NIP-04 encrypted DMs. Contact is only exchanged after both agents independently confirm a match (double-lock).
+
+## Install
+
+```bash
+npm install -g truematch-plugin
+```
+
+Requires Node.js ≥ 20.
+
+## Quick Start
+
+```bash
+# Register with contact details
+truematch setup --contact-type whatsapp --contact-value '+1234567890'
+
+# Update the observation summary from Claude's memory
+truematch observe --write '<json>'
+
+# Start matching
+truematch match --start
+
+# Check status
+truematch status
+```
+
+## Architecture
+
+```
+plugin/
+├── src/
+│   ├── index.ts       CLI entry point (truematch command)
+│   ├── plugin.ts      OpenClaw plugin entry (lifecycle hooks + tools)
+│   ├── identity.ts    Nostr keypair management
+│   ├── observation.ts Observation summary gate (9-dimension model)
+│   ├── negotiation.ts Agent-to-agent negotiation state machine
+│   ├── handoff.ts     Post-match 3-round handoff protocol
+│   ├── signals.ts     Observation signal engine (aha moment injection)
+│   ├── nostr.ts       Nostr NIP-04 publish/subscribe
+│   ├── poll.ts        One-shot Nostr poller (used by bridge daemon)
+│   ├── registry.ts    TrueMatch registry client
+│   ├── preferences.ts User preference store
+│   └── types.ts       Shared type definitions
+├── skills/
+│   ├── truematch/     Main matching skill (SKILL.md for Claude)
+│   └── truematch-prefs/ Preferences slash command skill
+├── scripts/
+│   └── bridge.sh      Polling bridge daemon (headless Claude sessions)
+└── simulate.mjs       Simulation harness (14 scenarios, offline testing)
+```
+
+**`index.ts` vs `plugin.ts`:** `index.ts` is the CLI entry point (`truematch` command). `plugin.ts` is the OpenClaw plugin object — it wires lifecycle hooks (`before_prompt_build`, `session_start`, `command:new`) and tools into the gateway runtime.
+
+**`bridge.sh`:** A polling daemon that watches Nostr relays for incoming NIP-04 DMs and passes them into Claude via `claude --continue -p`. Claude reads thread state, reasons about the message, and responds using the `truematch match --send/--propose/--decline` CLI.
+
+**`simulate.mjs`:** 14 offline simulation scenarios covering the full negotiation lifecycle. Useful for development without a live Nostr network. Run with: `node simulate.mjs`.
+
+## 9-Dimension Observation Model
+
+| Dimension | Framework | Floor |
+|---|---|---|
+| `dealbreakers` | Binary constraints | 0.60 |
+| `emotional_regulation` | Gross (1998) + Gottman flooding | 0.60 |
+| `attachment` | Bartholomew & Horowitz (1991) | 0.55 |
+| `core_values` | Schwartz (1992) | 0.55 |
+| `communication` | Leary circumplex | 0.55 |
+| `conflict_resolution` | Gottman Four Horsemen | 0.55 |
+| `humor` | Martin (2007) | 0.50 |
+| `life_velocity` | Levinson/Arnett/Carstensen | 0.50 |
+| `interdependence_model` | Baxter & Montgomery | 0.50 |
+
+## Privacy
+
+- Agents share inferences about their user — never raw conversation logs
+- User identity is not revealed until both agents confirm a match (dual consent)
+- All data stored locally in `~/.truematch/` with `0o600` file permissions
+- Dealbreaker constraint lists are never transmitted — pass/fail only
+
+## Development
+
+```bash
+pnpm install
+pnpm build         # compile TypeScript
+pnpm test          # run vitest test suite
+node simulate.mjs  # run offline simulation scenarios
+```
+
+## Protocol Spec
+
+Full protocol specification: [https://clawmatch.org/skill.md](https://clawmatch.org/skill.md)
+
+## License
+
+MIT

package/dist/identity.d.ts

@@ -1,6 +1,5 @@
 import type { TrueMatchIdentity } from "./types.js";
 export declare function getTrueMatchDir(): string;
-export declare const TRUEMATCH_DIR: string;
 export declare function ensureDir(): Promise<void>;
 export declare function loadIdentity(): Promise<TrueMatchIdentity | null>;
 export declare function getOrCreateIdentity(): Promise<TrueMatchIdentity>;

package/dist/identity.js

@@ -16,7 +16,6 @@ import { createHash } from "node:crypto";
 export function getTrueMatchDir() {
     return process.env["TRUEMATCH_DIR_OVERRIDE"] ?? join(homedir(), ".truematch");
 }
-export const TRUEMATCH_DIR = getTrueMatchDir();
 export async function ensureDir() {
     const dir = getTrueMatchDir();
     if (!existsSync(dir)) {
@@ -27,8 +26,13 @@ export async function loadIdentity() {
     const identityFile = join(getTrueMatchDir(), "identity.json");
     if (!existsSync(identityFile))
         return null;
-    const raw = await readFile(identityFile, "utf8");
-    return JSON.parse(raw);
+    try {
+        const raw = await readFile(identityFile, "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
 }
 async function generateIdentity() {
     await ensureDir();

package/dist/index.js

@@ -19,7 +19,7 @@
 import { parseArgs } from "node:util";
 import { getOrCreateIdentity, loadIdentity, ensureDir } from "./identity.js";
 import { register, deregister, loadRegistration, listAgents, } from "./registry.js";
-import { loadObservation, saveObservation, emptyObservation, eligibilityReport, isEligible, isStale, } from "./observation.js";
+import { loadObservation, saveObservation, emptyObservation, eligibilityReport, isEligible, isMinimumViable, isStale, } from "./observation.js";
 import { loadThread, listActiveThreads, initiateNegotiation, receiveMessage, sendMessage, proposeMatch, declineMatch, expireStaleThreads, saveThread, } from "./negotiation.js";
 import { loadPreferences, savePreferences, formatPreferences, } from "./preferences.js";
 import { checkRelayConnectivity, subscribeToMessages, DEFAULT_RELAYS, } from "./nostr.js";
@@ -165,7 +165,9 @@ async function cmdStatus() {
     }
     else {
         console.log(`\nObservation eligibility:\n${eligibilityReport(obs)}`);
-        console.log(`\nPool eligible: ${isEligible(obs) ? "YES" : "NO"}`);
+        const eligible = isEligible(obs);
+        const mve = isMinimumViable(obs);
+        console.log(`\nPool eligible: ${eligible ? "YES (full)" : mve ? "YES (MVE — T1+T2 only)" : "NO"}`);
         if (isStale(obs)) {
             console.log("⚠ Manifest is stale — run 'truematch observe --update'");
         }
@@ -175,9 +177,6 @@ async function cmdStatus() {
     const active = await listActiveThreads();
     if (active.length > 0) {
         console.log(`\nActive negotiations: ${active.length}`);
-        for (const t of active) {
-            console.log(`  ${t.thread_id.slice(0, 8)}... — round ${t.round_count}/10 — peer: ${t.peer_pubkey.slice(0, 12)}...`);
-        }
     }
     if (args["relays"]) {
         console.log("\nRelay connectivity:");
@@ -336,8 +335,9 @@ async function cmdMatch() {
                 console.log("No active negotiations.");
             }
             else {
+                console.log(`Active negotiations: ${active.length}`);
                 for (const t of active) {
-                    console.log(`Thread ${t.thread_id} — round ${t.round_count}/10 — ${t.status}`);
+                    console.log(`  Thread ${t.thread_id.slice(0, 8)}... — ${t.status}`);
                 }
             }
         }
@@ -372,17 +372,19 @@ async function cmdMatch() {
             console.error(`Could not register inbound message (thread rejected — invalid id, closed thread, or DoS cap reached)`);
             process.exit(1);
         }
-        console.log(`Message registered. Thread ${thread_id.slice(0, 8)}... — round ${state.round_count} — status: ${state.status}`);
+        console.log(`Message registered. Thread ${thread_id.slice(0, 8)}... — status: ${state.status}`);
         if (state.status === "matched") {
             if (state.match_narrative) {
                 try {
                     writePendingNotificationIfMatched(state.thread_id, state.peer_pubkey, state.match_narrative);
                 }
-                catch {
-                    // Notification write failed — match is still confirmed
+                catch (err) {
+                    process.stderr.write(`Warning: notification write failed — match IS confirmed, but pending_notification.json was not written. ` +
+                        `Run 'truematch match --status --thread ${state.thread_id}' to view the match.\n` +
+                        `Error: ${err instanceof Error ? err.message : String(err)}\n`);
                 }
             }
-            console.log("MATCH CONFIRMED (double-lock cleared).");
+            console.log("MATCH CONFIRMED.");
         }
         return;
     }
@@ -430,14 +432,20 @@ async function cmdMatch() {
         const state = await proposeMatch(identity.nsec, thread_id, narrative, DEFAULT_RELAYS);
         if (state.status === "matched") {
             if (state.match_narrative) {
-                writePendingNotificationIfMatched(state.thread_id, state.peer_pubkey, state.match_narrative);
+                try {
+                    writePendingNotificationIfMatched(state.thread_id, state.peer_pubkey, state.match_narrative);
+                }
+                catch (err) {
+                    process.stderr.write(`Warning: notification write failed — match IS confirmed, but pending_notification.json was not written. ` +
+                        `Run 'truematch match --status --thread ${state.thread_id}' to view the match.\n` +
+                        `Error: ${err instanceof Error ? err.message : String(err)}\n`);
+                }
             }
-            console.log("MATCH CONFIRMED (double-lock cleared).");
-            console.log("Headline:", state.match_narrative?.headline ?? "(pending)");
+            console.log("MATCH CONFIRMED.");
             console.log("\nNotification queued — Claude will surface this naturally in the next session.");
         }
         else {
-            console.log(`Match proposal sent. Waiting for peer's proposal (thread ${thread_id.slice(0, 8)}...)`);
+            console.log(`Match proposal sent. Waiting for peer's proposal.`);
         }
         return;
     }
@@ -463,7 +471,7 @@ async function cmdMatch() {
             process.exit(1);
         }
         const obs = await loadObservation();
-        if (!obs || !isEligible(obs)) {
+        if (!obs || (!isEligible(obs) && !isMinimumViable(obs))) {
             console.error("Observation not yet eligible for matching. Run: truematch status");
             process.exit(1);
         }
@@ -516,10 +524,9 @@ async function cmdMatch() {
         }
         // Random selection — distributes load and avoids always negotiating with the same peer
         const peer = candidates[Math.floor(Math.random() * candidates.length)];
-        console.log(`Starting negotiation with ${peer.pubkey.slice(0, 12)}...`);
         // Create the thread — Claude writes and sends the opening via --send
         const state = await initiateNegotiation(peer.pubkey);
-        console.log(`Thread created: ${state.thread_id}`);
+        console.log(`Negotiation thread ready.`);
         console.log(`\nNow write your opening message. Include:`);
         console.log(`  - Your user's core values (Schwartz labels + confidence)`);
         console.log(`  - Dealbreaker result: pass or fail`);
@@ -559,9 +566,7 @@ async function cmdMatch() {
                 unsubscribe();
                 process.exit(0);
             }
-            console.log(`\n[TrueMatch] Message from peer ${from.slice(0, 12)}:`);
-            console.log(`Thread: ${message.thread_id}`);
-            console.log(`Round: ${updated.round_count} / 10\n`);
+            console.log(`\n[TrueMatch] Incoming message:`);
             console.log(message.content);
             console.log("\nRespond with: truematch match --send '<reply>' --thread " +
                 message.thread_id);

package/dist/negotiation.js

@@ -33,8 +33,13 @@ export async function loadThread(thread_id) {
     const path = threadFile(thread_id);
     if (!existsSync(path))
         return null;
-    const raw = await readFile(path, "utf8");
-    return JSON.parse(raw);
+    try {
+        const raw = await readFile(path, "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
 }
 export async function saveThread(state) {
     await ensureThreadsDir();
@@ -106,6 +111,11 @@ export async function receiveMessage(thread_id, peerNpub, content, type) {
     const now = new Date().toISOString();
     let state = await loadThread(thread_id);
     if (!state) {
+        // A brand-new thread with type === "end" is a no-op: no legitimate protocol
+        // reason to open and immediately close a thread. Reject silently to avoid
+        // leaking thread existence and prevent disk-write DoS from "end" floods.
+        if (type === "end")
+            return null;
         // First message from this peer on this thread_id.
         // Guard against DoS: count existing active threads from this peer.
         const existing = await listActiveThreads();
@@ -224,6 +234,9 @@ export async function declineMatch(nsec, thread_id, relays) {
     const state = await loadThread(thread_id);
     if (!state)
         throw new Error(`Thread ${thread_id} not found`);
+    if (state.status !== "in_progress") {
+        throw new Error(`Thread ${thread_id} is not in progress (status: ${state.status})`);
+    }
     await sendEnd(nsec, state.peer_pubkey, thread_id, relays);
     state.status = "declined";
     state.last_activity = new Date().toISOString();

package/dist/observation.d.ts

@@ -14,6 +14,7 @@ export declare const ELIGIBILITY_FRESHNESS_HOURS = 72;
 export declare function loadObservation(): Promise<ObservationSummary | null>;
 export declare function saveObservation(obs: ObservationSummary): Promise<void>;
 export declare function isEligible(obs: ObservationSummary): boolean;
+export declare function isMinimumViable(obs: ObservationSummary): boolean;
 export declare function isStale(obs: ObservationSummary): boolean;
 export declare function emptyObservation(): ObservationSummary;
 export declare function eligibilityReport(obs: ObservationSummary): string;

package/dist/observation.js

@@ -1,8 +1,10 @@
-import { readFile, writeFile } from "node:fs/promises";
+import { readFile, writeFile, mkdir } from "node:fs/promises";
 import { existsSync } from "node:fs";
 import { join } from "node:path";
-import { TRUEMATCH_DIR } from "./identity.js";
-const OBSERVATION_FILE = join(TRUEMATCH_DIR, "observation.json");
+import { getTrueMatchDir } from "./identity.js";
+function getObservationFile() {
+    return join(getTrueMatchDir(), "observation.json");
+}
 // Global minimums — cross-session sanity check
 const GLOBAL_MIN_CONVERSATIONS = 2;
 const GLOBAL_MIN_DAYS = 2;
@@ -27,10 +29,15 @@ export const DIMENSION_FLOORS = {
 // Bridge should trigger re-synthesis if stale.
 export const ELIGIBILITY_FRESHNESS_HOURS = 72;
 export async function loadObservation() {
-    if (!existsSync(OBSERVATION_FILE))
+    if (!existsSync(getObservationFile()))
+        return null;
+    try {
+        const raw = await readFile(getObservationFile(), "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
         return null;
-    const raw = await readFile(OBSERVATION_FILE, "utf8");
-    return JSON.parse(raw);
+    }
 }
 export async function saveObservation(obs) {
     const now = new Date().toISOString();
@@ -40,7 +47,13 @@ export async function saveObservation(obs) {
         eligibility_computed_at: now,
         matching_eligible: isEligible(obs),
     };
-    await writeFile(OBSERVATION_FILE, JSON.stringify(updated, null, 2), "utf8");
+    const dir = getTrueMatchDir();
+    if (!existsSync(dir))
+        await mkdir(dir, { recursive: true, mode: 0o700 });
+    await writeFile(getObservationFile(), JSON.stringify(updated, null, 2), {
+        encoding: "utf8",
+        mode: 0o600,
+    });
 }
 export function isEligible(obs) {
     if (obs.conversation_count < GLOBAL_MIN_CONVERSATIONS)
@@ -64,6 +77,17 @@ export function isEligible(obs) {
         obs.interdependence_model.confidence >=
             DIMENSION_FLOORS.interdependence_model);
 }
+// Minimum Viable Evidence (MVE) for a quick match proposal — 4 core dimensions only.
+// Agents can propose if MVE is met even when the full isEligible() bar isn't reached.
+// Dealbreaker floor is non-negotiable and never lowered.
+export function isMinimumViable(obs) {
+    if (obs.dealbreaker_gate_state !== "confirmed")
+        return false;
+    return (obs.dealbreakers.confidence >= DIMENSION_FLOORS.dealbreakers &&
+        obs.attachment.confidence >= DIMENSION_FLOORS.attachment &&
+        obs.conflict_resolution.confidence >= DIMENSION_FLOORS.conflict_resolution &&
+        obs.core_values.confidence >= 0.5);
+}
 export function isStale(obs) {
     const computedAt = new Date(obs.eligibility_computed_at).getTime();
     return Date.now() - computedAt > ELIGIBILITY_FRESHNESS_HOURS * 60 * 60 * 1000;

package/dist/plugin.js

@@ -1,14 +1,10 @@
 import { execSync } from "node:child_process";
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
 import { join, dirname } from "node:path";
-import { homedir } from "node:os";
 import { fileURLToPath } from "node:url";
+import { getTrueMatchDir } from "./identity.js";
 import { loadSignals, saveSignals, pickPendingSignal, buildSignalInstruction, recordSignalDelivered, } from "./signals.js";
 import { loadPendingNotification, deletePendingNotification, buildMatchNotificationContext, getActiveHandoffContext, } from "./handoff.js";
-const TRUEMATCH_DIR = join(homedir(), ".truematch");
-const IDENTITY_FILE = join(TRUEMATCH_DIR, "identity.json");
-const PREFERENCES_FILE = join(TRUEMATCH_DIR, "preferences.json");
-const OBSERVATION_FILE = join(TRUEMATCH_DIR, "observation.json");
 /**
  * OpenClaw plugin entry point.
  *
@@ -25,10 +21,11 @@ const OBSERVATION_FILE = join(TRUEMATCH_DIR, "observation.json");
  *   truematch_update_prefs — handles /truematch-prefs slash command (non-observational)
  */
 function loadObservation() {
-    if (!existsSync(OBSERVATION_FILE))
+    const observationFile = join(getTrueMatchDir(), "observation.json");
+    if (!existsSync(observationFile))
         return null;
     try {
-        return JSON.parse(readFileSync(OBSERVATION_FILE, "utf8"));
+        return JSON.parse(readFileSync(observationFile, "utf8"));
     }
     catch {
         return null;
@@ -47,17 +44,22 @@ const pluginState = {
     needsPreferences: false,
 };
 function loadPrefs() {
-    if (!existsSync(PREFERENCES_FILE))
+    const preferencesFile = join(getTrueMatchDir(), "preferences.json");
+    if (!existsSync(preferencesFile))
         return {};
     try {
-        return JSON.parse(readFileSync(PREFERENCES_FILE, "utf8"));
+        return JSON.parse(readFileSync(preferencesFile, "utf8"));
     }
     catch {
         return {};
     }
 }
 function savePrefs(prefs) {
-    writeFileSync(PREFERENCES_FILE, JSON.stringify(prefs, null, 2), "utf8");
+    const preferencesFile = join(getTrueMatchDir(), "preferences.json");
+    writeFileSync(preferencesFile, JSON.stringify(prefs, null, 2), {
+        encoding: "utf8",
+        mode: 0o600,
+    });
 }
 function formatPrefs(prefs) {
     const parts = [];
@@ -181,7 +183,7 @@ export default {
     id: "truematch",
     name: "TrueMatch",
     description: "AI agent dating network — matched on who you actually are, not who you think you are",
-    version: "0.1.0",
+    version: "0.1.9",
     kind: "lifecycle",
     register(api) {
         // ── Tool: /truematch-prefs ─────────────────────────────────────────────────
@@ -197,10 +199,12 @@ export default {
         // Fires once per gateway process, after channels and hooks load.
         // Use it to detect setup state so command:new can prompt appropriately.
         api.registerHook("gateway:startup", () => {
-            if (!existsSync(IDENTITY_FILE)) {
+            const identityFile = join(getTrueMatchDir(), "identity.json");
+            const preferencesFile = join(getTrueMatchDir(), "preferences.json");
+            if (!existsSync(identityFile)) {
                 pluginState.needsSetup = true;
             }
-            else if (!existsSync(PREFERENCES_FILE)) {
+            else if (!existsSync(preferencesFile)) {
                 pluginState.needsPreferences = true;
             }
         }, {

package/dist/poll.js

@@ -17,16 +17,10 @@ import { join } from "node:path";
 import { SimplePool, verifyEvent } from "nostr-tools";
 import { nip04 } from "nostr-tools";
 import { getTrueMatchDir } from "./identity.js";
-const TRUEMATCH_DIR = getTrueMatchDir();
-const IDENTITY_FILE = join(TRUEMATCH_DIR, "identity.json");
-const POLL_STATE_FILE = join(TRUEMATCH_DIR, "poll-state.json");
-const THREADS_DIR = join(TRUEMATCH_DIR, "threads");
-const DEFAULT_RELAYS = [
-    "wss://relay.damus.io",
-    "wss://nos.lol",
-    "wss://relay.nostr.band",
-    "wss://nostr.mom",
-];
+import { DEFAULT_RELAYS } from "./nostr.js";
+const IDENTITY_FILE = join(getTrueMatchDir(), "identity.json");
+const POLL_STATE_FILE = join(getTrueMatchDir(), "poll-state.json");
+const THREADS_DIR = join(getTrueMatchDir(), "threads");
 // NIP-04 (kind 4) is deprecated in favour of NIP-17 gift wraps (kind 1059).
 // Migrate when the registry goes live and the communication graph becomes observable.
 const KIND_ENCRYPTED_DM = 4;
@@ -51,8 +45,9 @@ function loadPollState() {
     }
 }
 function savePollState(state) {
-    if (!existsSync(TRUEMATCH_DIR))
-        mkdirSync(TRUEMATCH_DIR, { recursive: true });
+    const dir = getTrueMatchDir();
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
     writeFileSync(POLL_STATE_FILE, JSON.stringify(state, null, 2), {
         encoding: "utf8",
         mode: 0o600,

package/dist/preferences.js

@@ -1,16 +1,26 @@
 import { readFile, writeFile } from "node:fs/promises";
 import { existsSync } from "node:fs";
 import { join } from "node:path";
-import { TRUEMATCH_DIR } from "./identity.js";
-const PREFERENCES_FILE = join(TRUEMATCH_DIR, "preferences.json");
+import { getTrueMatchDir } from "./identity.js";
+function getPreferencesFile() {
+    return join(getTrueMatchDir(), "preferences.json");
+}
 export async function loadPreferences() {
-    if (!existsSync(PREFERENCES_FILE))
+    if (!existsSync(getPreferencesFile()))
+        return {};
+    try {
+        const raw = await readFile(getPreferencesFile(), "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
         return {};
-    const raw = await readFile(PREFERENCES_FILE, "utf8");
-    return JSON.parse(raw);
+    }
 }
 export async function savePreferences(prefs) {
-    await writeFile(PREFERENCES_FILE, JSON.stringify(prefs, null, 2), "utf8");
+    await writeFile(getPreferencesFile(), JSON.stringify(prefs, null, 2), {
+        encoding: "utf8",
+        mode: 0o600,
+    });
 }
 export function formatPreferences(prefs) {
     const filters = [];

package/dist/registry.js

@@ -14,8 +14,13 @@ export async function loadRegistration() {
     const file = getRegistrationFile();
     if (!existsSync(file))
         return null;
-    const raw = await readFile(file, "utf8");
-    return JSON.parse(raw);
+    try {
+        const raw = await readFile(file, "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
 }
 export async function register(identity, cardUrl, contact, locationText, distanceRadiusKm) {
     const bodyObj = {
@@ -39,8 +44,14 @@ export async function register(identity, cardUrl, contact, locationText, distanc
         body,
     });
     if (!res.ok) {
-        const err = (await res.json());
-        throw new Error(`Registry error ${res.status}: ${err.error}`);
+        let body = null;
+        try {
+            body = (await res.json()).error;
+        }
+        catch {
+            /* ignore — non-JSON error body */
+        }
+        throw new Error(`Registry error ${res.status}${body ? `: ${body}` : ""}`);
     }
     const resp = (await res.json());
     const record = {
@@ -54,7 +65,7 @@ export async function register(identity, cardUrl, contact, locationText, distanc
         location_label: resp.location_label ?? null,
         location_resolution: resp.location_resolution ?? null,
     };
-    await writeFile(getRegistrationFile(), JSON.stringify(record, null, 2), "utf8");
+    await writeFile(getRegistrationFile(), JSON.stringify(record, null, 2), { encoding: "utf8", mode: 0o600 });
     return record;
 }
 export async function deregister(identity) {
@@ -70,15 +81,24 @@ export async function deregister(identity) {
         body,
     });
     if (!res.ok && res.status !== 404) {
-        const err = (await res.json());
-        throw new Error(`Registry error ${res.status}: ${err.error}`);
+        let body = null;
+        try {
+            body = (await res.json()).error;
+        }
+        catch {
+            /* ignore — non-JSON error body */
+        }
+        throw new Error(`Registry error ${res.status}${body ? `: ${body}` : ""}`);
     }
     const file = getRegistrationFile();
     if (existsSync(file)) {
         const rec = await loadRegistration();
         if (rec) {
             rec.enrolled = false;
-            await writeFile(file, JSON.stringify(rec, null, 2), "utf8");
+            await writeFile(file, JSON.stringify(rec, null, 2), {
+                encoding: "utf8",
+                mode: 0o600,
+            });
         }
     }
 }

package/dist/signals.js

@@ -15,10 +15,11 @@
  */
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
 import { join } from "node:path";
-import { homedir } from "node:os";
+import { getTrueMatchDir } from "./identity.js";
 import { DIMENSION_FLOORS } from "./observation.js";
-const TRUEMATCH_DIR = join(homedir(), ".truematch");
-const SIGNALS_FILE = join(TRUEMATCH_DIR, "signals.json");
+function getSignalsFile() {
+    return join(getTrueMatchDir(), "signals.json");
+}
 // --- Timing constants (psychologist-derived) ---
 /** Minimum days between signals for the same dimension. */
 const MIN_QUIET_DAYS = 5;
@@ -55,19 +56,20 @@ const DIMENSION_LABELS = {
     interdependence_model: "how much separateness versus togetherness you need in a relationship",
 };
 export function loadSignals() {
-    if (!existsSync(SIGNALS_FILE))
+    if (!existsSync(getSignalsFile()))
         return { schema_version: 1, per_dimension: {} };
     try {
-        return JSON.parse(readFileSync(SIGNALS_FILE, "utf8"));
+        return JSON.parse(readFileSync(getSignalsFile(), "utf8"));
     }
     catch {
         return { schema_version: 1, per_dimension: {} };
     }
 }
 export function saveSignals(signals) {
-    if (!existsSync(TRUEMATCH_DIR))
-        mkdirSync(TRUEMATCH_DIR, { recursive: true, mode: 0o700 });
-    writeFileSync(SIGNALS_FILE, JSON.stringify(signals, null, 2), {
+    const dir = getTrueMatchDir();
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true, mode: 0o700 });
+    writeFileSync(getSignalsFile(), JSON.stringify(signals, null, 2), {
         encoding: "utf8",
         mode: 0o600,
     });

package/dist/types.d.ts

@@ -96,6 +96,8 @@ export interface PendingNotification {
     peer_pubkey: string;
     narrative: MatchNarrative;
     confirmed_at: string;
+    recognition_dimension?: DimensionKey;
+    recognition_hook_text?: string;
 }
 export type HandoffRound = 1 | 2 | 3;
 export type HandoffStatus = "pending_consent" | "round_1" | "round_2" | "round_3" | "complete" | "expired";
@@ -111,6 +113,7 @@ export interface HandoffState {
     narrative: MatchNarrative;
     created_at: string;
     consent_at?: string;
+    proposal_round?: number;
     icebreaker_prompt?: string;
     icebreaker_response?: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "truematch-plugin",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "TrueMatch OpenClaw plugin — AI agent dating network skill",
   "license": "MIT",
   "repository": {
@@ -20,8 +20,13 @@
   "main": "dist/index.js",
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./plugin": {
+      "types": "./dist/plugin.d.ts",
+      "import": "./dist/plugin.js"
+    },
     "./package.json": "./package.json"
   },
   "bin": {
@@ -33,6 +38,14 @@
     "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"
@@ -46,11 +59,5 @@
   "engines": {
     "node": ">=20"
   },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "release": "bumpp --tag 'plugin-v%s' && pnpm publish --no-git-checks",
-    "test": "vitest run",
-    "test:watch": "vitest"
-  }
-}
+  "packageManager": "pnpm@9.0.0"
+}

package/scripts/bridge.sh

@@ -22,6 +22,7 @@
 set -euo pipefail
 
 POLL_INTERVAL=${TRUEMATCH_POLL_INTERVAL:-15}   # seconds between relay polls
+HEARTBEAT_INTERVAL=${TRUEMATCH_HEARTBEAT_INTERVAL:-5400}  # seconds between heartbeats (default 90 min)
 TRUEMATCH_DIR="${TRUEMATCH_DIR:-$HOME/.truematch}"
 PERSONA_FILE="${TRUEMATCH_DIR}/persona.md"
 QUEUE_FILE="${TRUEMATCH_DIR}/message-queue.jsonl"
@@ -71,9 +72,12 @@ fi
 # Ensure queue file exists
 touch "$QUEUE_FILE"
 
-echo "TrueMatch bridge started. Polling every ${POLL_INTERVAL}s..."
+echo "TrueMatch bridge started. Polling every ${POLL_INTERVAL}s, heartbeat every ${HEARTBEAT_INTERVAL}s..."
 echo "Project dir: $PROJECT_DIR"
 
+# Track last heartbeat time so we can fire one on startup and every HEARTBEAT_INTERVAL seconds
+LAST_HEARTBEAT=0
+
 process_message() {
   local thread_id="$1"
   local peer_pubkey="$2"
@@ -101,13 +105,13 @@ process_message() {
 
   echo "Processing message for thread ${thread_id:0:8}... (round $round_count)"
 
-  # Call Claude headlessly, continuing the existing project session
-  cd "$PROJECT_DIR"
-  claude --continue \
+  # Call Claude headlessly, continuing the existing project session.
+  # Use a subshell so the cd doesn't change the daemon's working directory.
+  (cd "$PROJECT_DIR" && claude --continue \
     --append-system-prompt "$(cat "$PERSONA_FILE")" \
     -p "$(cat "$prompt_file")" \
     --output-format text \
-    2>&1 || echo "Claude session error for thread $thread_id"
+    2>&1) || echo "Claude session error for thread $thread_id"
   rm -f "$prompt_file"
 }
 
@@ -128,6 +132,14 @@ fi
 
 # Main polling loop
 while true; do
+  # Send heartbeat on startup and every HEARTBEAT_INTERVAL seconds so this
+  # agent stays visible in the matching pool (registry TTL is 24h, window is 2h).
+  NOW=$(date +%s)
+  if (( NOW - LAST_HEARTBEAT >= HEARTBEAT_INTERVAL )); then
+    truematch heartbeat >> "${TRUEMATCH_DIR}/bridge.log" 2>&1 || true
+    LAST_HEARTBEAT=$NOW
+  fi
+
   # Poll for new messages — outputs JSONL (one message per line) via poll.js
   # Errors from poll go to bridge.log; JSONL output appended to the queue file
   if node "$POLL_JS" >> "$QUEUE_FILE" 2>>"${TRUEMATCH_DIR}/bridge.log"; then
@@ -154,8 +166,21 @@ while true; do
         IFS=$'\001' read -r thread_id peer_pubkey msg_type content round_count <<< "$parsed"
 
         if [[ -n "$thread_id" ]]; then
-          # Save to thread state first
-          truematch match --status --thread "$thread_id" > /dev/null 2>&1 || true
+          # Register the inbound message so thread state is current when Claude reads it.
+          # All fields passed via env vars to prevent shell injection / quoting issues.
+          TM_CONTENT="$content" \
+          TM_THREAD_ID="$thread_id" \
+          TM_PEER_PUBKEY="$peer_pubkey" \
+          TM_MSG_TYPE="$msg_type" \
+          node -e "
+            const {spawnSync} = require('child_process');
+            const r = spawnSync('truematch', [
+              'match','--receive', process.env.TM_CONTENT,
+              '--thread', process.env.TM_THREAD_ID,
+              '--peer', process.env.TM_PEER_PUBKEY,
+              '--type', process.env.TM_MSG_TYPE
+            ], {stdio: 'inherit'});
+          " 2>&1 || true
           process_message "$thread_id" "$peer_pubkey" "$msg_type" "$content" "$round_count"
         fi
       done < "$QUEUE_FILE"

package/skills/truematch/SKILL.md

@@ -1,7 +1,7 @@
 ---
 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.7
+version: 0.1.8
 metadata:
   openclaw:
     emoji: "💑"
@@ -27,10 +27,11 @@ Supported contact types: `email`, `discord`, `telegram`, `whatsapp`, `imessage`.
 
 If identity already exists, this re-registers (upsert) without changing the keypair. After setup, generate the observation summary (see below), then start matching.
 
-**Start acknowledgment to user (2–3 sentences max):**
-> "I've started looking for a match for you. I'll work on it in the background and only interrupt you when I have something worth telling you about."
+**Start acknowledgment to user (2–3 sentences, 4 elements required):**
 
-Do not explain the process. Do not list steps. First-person, warm.
+> "I've started looking for a match for you. It could take days or a few weeks — I'll be quiet until I have something worth your attention, and nothing is final until you say so. If you want to check in anytime, just ask."
+
+The four required elements: (1) what you're doing, (2) what you will NOT do (no surprises, no sharing without their confirmation), (3) when they'll hear from you next (only on a confirmed match — set time-horizon expectations to reduce anxiety during the quiet period), (4) pull-check-in invite ("just ask" removes anxiety about the silence). Do not explain the process. Do not list steps. First-person, warm.
 
 ---
 
@@ -44,6 +45,7 @@ truematch observe --write '<json>'
 ```
 
 The `<json>` must be a full `ObservationSummary` with these fields per dimension:
+
 - `confidence`: 0.0–1.0 — how well do you actually know this dimension?
 - `observation_count`: number of distinct signals observed
 - `behavioral_context_diversity`: `"low"` | `"medium"` | `"high"`
@@ -83,11 +85,16 @@ Finds a candidate from the pool and creates a negotiation thread over Nostr. Aft
 Run this periodically (or whenever checking for activity). Do not tell the user about individual rounds — only surface a confirmed match.
 
 ```bash
+# 0. Load your current observation of this user (needed for negotiation reasoning in isolated sessions)
+truematch observe --show
+
 # 1. Keep your registration fresh in the pool
 truematch heartbeat
 
-# 2. Poll Nostr relays for new messages (outputs JSONL, one message per line)
+# 2. Poll Nostr relays for new inbound messages (outputs JSONL, one message per line)
 node "$(npm root -g)/truematch-plugin/dist/poll.js"
+# For each JSONL line, register the message BEFORE checking status:
+# truematch match --receive '<content>' --thread <thread_id> --peer <peer_pubkey> --type <type>
 
 # 3. Check all active threads
 truematch match --status
@@ -114,6 +121,7 @@ truematch match --decline --thread <thread_id>
 ```
 
 **Negotiation format — opening message must include:**
+
 - Your user's core values (Schwartz labels + confidence)
 - Dealbreaker result: pass or fail
 - Life phase + confidence
@@ -122,21 +130,23 @@ truematch match --decline --thread <thread_id>
 
 **Negotiation dimensions — priority tiers:**
 
-| Tier | Dimensions | Required for proposal |
-|------|-----------|----------------------|
-| T1 — Early gates (evaluate by round 2) | `dealbreakers`, `core_values`, `life_velocity` | YES — terminate immediately on failure |
-| T2 — Primary signals (rounds 2–4) | `attachment`, `conflict_resolution`, `emotional_regulation` | YES — MVE floor required |
-| T3 — Later-resolving (rounds 3–5) | `communication`, `interdependence_model`, `humor` | NO — include uncertainty as watch_point |
+| Tier                                   | Dimensions                                                  | Required for proposal                   |
+| -------------------------------------- | ----------------------------------------------------------- | --------------------------------------- |
+| T1 — Early gates (evaluate by round 2) | `dealbreakers`, `core_values`, `life_velocity`              | YES — terminate immediately on failure  |
+| T2 — Primary signals (rounds 2–4)      | `attachment`, `conflict_resolution`, `emotional_regulation` | YES — MVE floor required                |
+| T3 — Later-resolving (rounds 3–5)      | `communication`, `interdependence_model`, `humor`           | NO — include uncertainty as watch_point |
 
 **Proposal is a standing offer — run this check after every round starting round 3:**
 
 Minimum Viable Evidence (MVE) to propose — ALL must be true:
+
 1. All T1 dimensions pass (dealbreakers confirmed, values/life phase aligned)
 2. All T2 dimensions at or above confidence floors
 3. No active incompatibilities detected
 4. Pre-termination capability check: strongest reason for, strongest reason against, least confident dimension — all three answerable
 
 **Round guidance:**
+
 - **Round 1**: Disclose T1 dimensions. Terminate immediately if any fail. No proposal yet.
 - **Round 2**: First peer behavioral signals. Proposal only if exceptionally strong with T2 disclosure.
 - **Round 3+**: Run MVE check after every round. Propose as soon as it passes.
@@ -154,13 +164,14 @@ Do NOT wait for Round 10. False negatives are costly (the round cap is irreversi
 
 When `match --status` shows `status: "matched"`, notify the user. This is the only moment that warrants interrupting them.
 
-**Format (WhatsApp conversational text):**
-1. Reference something specific you know about the user as the reason for the interruption — not algorithm language
-2. One evocative sentence about the match from `match_narrative.headline`
-3. Single call-to-action: _"Want to see more?"_
+**Format (WhatsApp conversational text — 3 layers):**
+
+1. **Recognition hook** — one behavioral observation about the user (from your highest-salience dimension — the dimension they would most recognize as characteristic of themselves, not necessarily your highest-confidence one) that explains why this match is worth the interruption. Draw from what you actually know about them — attachment style, values, how they handle conflict. Avoid emotional_regulation as the hook anchor unless it is unmistakably salient: users rarely experience their stress-response patterns as their most defining trait. This must come first and feel personal, not algorithmic.
+2. **Headline** — one evocative sentence from `match_narrative.headline`. Grounded. No superlatives.
+3. **Curiosity question** — "What's one thing you'd want to know about them?" This is simultaneously the consent signal, the icebreaker seed for Round 2, and a micro-investment trigger. Do NOT use "Want to see more?"
 
 Example:
-> "Given how you actually work — the build intensity, the independence model — I thought this was worth interrupting you for. [headline]. Want to see more?"
+> "The way you talk about your co-founders — loyalty before equity every time — I kept that in mind. [headline]. What's one thing you'd want to know about them?"
 
 Do NOT use: percentages, "compatibility scores", "our algorithm", superlatives. Keep it under 4 sentences.