@ghostpaw/affinity 0.6.0 → 0.6.1

package/dist/mcp.js

@@ -3,7 +3,7 @@ import { dirname, join, resolve } from 'node:path';
 import { homedir } from 'node:os';
 
 // src/version.ts
-var affinityVersion = "0.6.0";
+var affinityVersion = "0.6.1";
 
 // src/surface/affinity_mcp_instructions.ts
 var affinityMcpInstructions = "Affinity is a local relationship model and social CRM. Search before creating contacts. Inspect before revising or merging. Record direct evidence honestly, keep identities and structural ties distinct from social links, and ask for clarification when a target is ambiguous. Review commitments and recurring dates regularly. Derived scores guide attention and do not prove relationship quality.";
@@ -380,6 +380,8 @@ function mapEventRowToEventRecord(row, participants) {
     momentKind: row.moment_kind,
     participants
   };
+  if (row.provenance_json != null)
+    base.provenance = JSON.parse(row.provenance_json);
   if (row.content != null) base.content = decodeEventText(row.content);
   if (row.channel != null) base.channel = row.channel;
   if (row.external_source != null && row.external_id != null)
@@ -670,14 +672,9 @@ function parseCalendarTime(value, field = "time", now = Date.now()) {
     text = text.replace(" ", "T");
     if (!/(?:Z|[+-]\d{2}:\d{2})$/.test(text)) text += "Z";
   }
-  let rounding = 0;
   text = text.replace(
     /\.(\d{4,})(?=Z|[+-]\d{2}:\d{2}$)/,
-    (_, digits) => {
-      const ms = Math.round(Number(`0.${digits}`) * 1e3);
-      rounding = ms === 1e3 ? 1 : 0;
-      return `.${String(ms === 1e3 ? 999 : ms).padStart(3, "0")}`;
-    }
+    (_, digits) => `.${digits.slice(0, 3)}`
   );
   if (/^(today|yesterday|tomorrow|[+-]\d+d)$/.test(text)) {
     const offset = text === "today" ? 0 : text === "tomorrow" ? 1 : text === "yesterday" ? -1 : Number(text.slice(0, -1));
@@ -697,7 +694,7 @@ function parseCalendarTime(value, field = "time", now = Date.now()) {
   const midnight = Date.parse(`${day}T00:00:00Z`);
   if (!Number.isFinite(midnight) || new Date(midnight).toISOString().slice(0, 10) !== day)
     return fail();
-  const timestamp = dateOnly ? midnight + (field.split(".").at(-1) === "dueAt" ? 86399999 : 0) : Date.parse(text) + rounding;
+  const timestamp = dateOnly ? midnight + (field.split(".").at(-1) === "dueAt" ? 86399999 : 0) : Date.parse(text);
   if (!Number.isFinite(timestamp)) return fail();
   return { timestamp, day };
 }
@@ -1737,7 +1734,7 @@ var externalRefSchema = objectSchema(
 );
 var eventMetadataSchema = {
   affectsBond: booleanSchema(
-    "Whether evidence affects the relationship; defaults false for observations with significance <=2."
+    "Whether evidence affects the relationship; defaults false for like/follow/repost labels and observations with significance <=2; explicit true opts in."
   ),
   content: stringSchema(
     "Verbatim text, including empty text; at most 1 MB UTF-8. Summary may be omitted when content is supplied."
@@ -2287,6 +2284,13 @@ function validateToolInput(schema, value, path = "input", injectedNow = Date.now
             `${path}.${key}`,
             referenceNow
           );
+          if (!path.endsWith(".patch") && ["occurredAt", "dueAt"].includes(key) && typeof object[key] === "string" && /\.\d{4,}/.test(object[key])) {
+            const provenance = object.provenance;
+            object.provenance = {
+              ...provenance && typeof provenance === "object" ? provenance : {},
+              [`raw${key[0]?.toUpperCase()}${key.slice(1)}`]: object[key]
+            };
+          }
           object[key] = parsed.timestamp;
           if (!path.endsWith(".patch") && ["occurredAt", "dueAt"].includes(key))
             object[key.replace(/At$/, "On")] ??= parsed.day;
@@ -2304,7 +2308,7 @@ function validateToolInput(schema, value, path = "input", injectedNow = Date.now
       const error = validateToolInput(
         child,
         object[key],
-        `${path}.${key}`,
+        key === "input" && path === "input" ? path : `${path}.${key}`,
         referenceNow,
         strict
       );
@@ -2741,6 +2745,11 @@ function setAttribute(db, target, name, value) {
     const stored = normalizeAttributeValue(value);
     const now = resolveNow();
     const existing = getLiveAttributeRow(db, target, key);
+    if (existing?.value === stored)
+      return buildAttributeMutationReceipt(
+        mapAttributeRowToAttributeRecord(existing),
+        {}
+      );
     if (existing) {
       db.prepare(
         "UPDATE attributes SET value = ?, updated_at = ? WHERE id = ?"
@@ -2880,7 +2889,30 @@ function linkLocatorSchema2(description) {
   };
 }
 function resolveAttributeTarget(db, target) {
-  if (target.kind === "event") return { kind: "ok", target };
+  if (target.kind === "event") {
+    if (target.eventId === void 0 === (target.ref === void 0))
+      return {
+        kind: "error",
+        result: toolFailure(
+          "protocol",
+          "invalid_input",
+          "Invalid event target.",
+          "Provide exactly one of target.eventId or target.ref."
+        )
+      };
+    const eventId = target.eventId ?? (target.ref && getEventByExternalRef(db, target.ref.source, target.ref.id)?.id);
+    if (eventId === void 0)
+      return {
+        kind: "error",
+        result: toolFailure(
+          "domain",
+          "not_found",
+          "Event not found.",
+          "No event matches target.ref."
+        )
+      };
+    return { kind: "ok", target: { kind: "event", eventId } };
+  }
   if (target.kind === "contact") {
     const contact = resolveContactLocator(db, target.contact, "target.contact");
     if (!contact.ok) {
@@ -2962,7 +2994,8 @@ var manageAttributeTool = defineAffinityTool({
       target: objectSchema(
         {
           kind: enumSchema("Target kind.", ["contact", "link", "event"]),
-          eventId: integerSchema("Target event id."),
+          eventId: integerSchema("Target event id; provide eventId or ref."),
+          ref: externalRefSchema,
           contact: contactLocatorSchema2(
             "Contact locator. Required when kind=contact. Provide contactId or identity."
           ),
@@ -3018,7 +3051,9 @@ function insertJournalEvent(db, params) {
   );
   const eventId = Number(result.lastInsertRowid);
   db.prepare("UPDATE events SET affects_bond=? WHERE id=?").run(
-    params.affectsBond === void 0 ? params.type === "observation" && params.significance <= 2 ? 0 : 1 : Number(params.affectsBond),
+    params.affectsBond === void 0 ? params.type === "observation" && params.significance <= 2 || ["activity", "milestone", "observation"].includes(params.type) && /^(?:follow(?:ed|ing)?|like(?:d)?|repost(?:ed)?)(?:\b|[-_])/i.test(
+      summary
+    ) && !/^follow[ -]up\b/i.test(summary) ? 0 : 1 : Number(params.affectsBond),
     eventId
   );
   db.prepare("UPDATE events SET declared_moment_kind=? WHERE id=?").run(
@@ -4690,7 +4725,7 @@ function exportContact(db, id) {
   const contact = query("SELECT * FROM contacts WHERE id = ?", id)[0];
   if (!contact) throw new AffinityNotFoundError("contact not found");
   const events = query(
-    "SELECT DISTINCT e.*, CAST(e.content AS BLOB) AS content, CAST(e.summary AS BLOB) AS summary FROM events e JOIN event_participants p ON p.event_id = e.id WHERE p.contact_id = ? AND e.type != 'date_anchor' ORDER BY e.id",
+    "SELECT DISTINCT e.*, COALESCE(e.parent_event_id, (SELECT parent.id FROM events parent WHERE parent.external_source=e.parent_source AND parent.external_id=e.parent_ref_id AND parent.deleted_at IS NULL)) AS parent_event_id, CAST(e.content AS BLOB) AS content, CAST(e.summary AS BLOB) AS summary FROM events e JOIN event_participants p ON p.event_id = e.id WHERE p.contact_id = ? AND e.type != 'date_anchor' ORDER BY e.id",
     id
   ).map((event) => ({
     ...event,
@@ -7831,12 +7866,14 @@ function getEventThread(db, source, id, options) {
   const rows = db.prepare(`WITH RECURSIVE thread(id) AS (
     SELECT ? UNION SELECT e.id FROM events e JOIN thread t JOIN events p ON p.id=t.id
     WHERE e.deleted_at IS NULL AND (e.parent_event_id=p.id OR (e.parent_source=p.external_source AND e.parent_ref_id=p.external_id) OR (e.thread_source=? AND e.thread_id=?))
-  ) SELECT e.id FROM events e JOIN thread t ON e.id=t.id WHERE e.deleted_at IS NULL AND (? IS NULL OR e.channel=?) ORDER BY e.occurred_at,e.id LIMIT ? OFFSET ?`).all(
+  ) SELECT e.id FROM events e JOIN thread t ON e.id=t.id WHERE e.deleted_at IS NULL AND (? IS NULL OR e.channel=?) AND (? IS NULL OR e.type IN (SELECT value FROM json_each(?))) ORDER BY e.occurred_at,e.id LIMIT ? OFFSET ?`).all(
     root.id,
     root.externalRef?.source ?? null,
     root.externalRef?.id ?? null,
     options?.channel ?? null,
     options?.channel?.trim().toLowerCase() ?? null,
+    options?.eventTypes === void 0 ? null : JSON.stringify(options.eventTypes),
+    options?.eventTypes === void 0 ? null : JSON.stringify(options.eventTypes),
     limit,
     offset
   );
@@ -8488,12 +8525,12 @@ function reviewPage(db, rawInput, pageOnly) {
     if (!pageOnly && input.view !== "graph.chart") {
       const limit = input.limit ?? 50;
       const offset = input.offset ?? 0;
-      if (!Number.isInteger(limit) || limit < 1 || limit > 250 || !Number.isInteger(offset) || offset < 0)
+      if (!Number.isInteger(limit) || limit < 1 || limit > 1e4 || !Number.isInteger(offset) || offset < 0)
         return toolFailure(
           "protocol",
           "invalid_input",
           "Invalid pagination.",
-          "limit must be 1..250; offset must be non-negative"
+          "limit must be 1..10000; use offset to page through larger results; offset must be non-negative"
         );
       const all = [];
       let page;
@@ -8545,7 +8582,7 @@ function reviewPage(db, rawInput, pageOnly) {
           {
             ...input.contactIds === void 0 ? {} : { contactIds: input.contactIds },
             ...input.exactOnly === void 0 ? {} : { exactOnly: input.exactOnly },
-            ...input.minScore === void 0 ? {} : { minScore: input.minScore },
+            ...input.minScore === void 0 ? { minScore: 0.5 } : { minScore: input.minScore },
             ...input.includeDismissed === void 0 ? {} : { includeDismissed: input.includeDismissed }
           },
           options
@@ -8559,9 +8596,10 @@ function reviewPage(db, rawInput, pageOnly) {
             "Missing thread reference.",
             "ref is required for events.thread."
           );
-        items = getEventThread(db, input.ref.source, input.ref.id, options).map(
-          toEventListToolItem
-        );
+        items = getEventThread(db, input.ref.source, input.ref.id, {
+          ...options,
+          ...input.eventTypes === void 0 ? {} : { eventTypes: input.eventTypes }
+        }).map(toEventListToolItem);
         break;
       }
       case "events.contact_journal": {
@@ -8820,7 +8858,7 @@ var reviewAffinityTool = defineAffinityTool({
     includeDismissed: "Whether dismissed pairs should be included in duplicate review (marked with dismissed flag).",
     since: "Optional lower timestamp bound for time-based views.",
     until: "Optional upper timestamp bound for time-based views.",
-    limit: "Optional result limit.",
+    limit: "Optional result limit, 1..10000 (default 50); use offset for paging.",
     offset: "Optional result offset."
   },
   outputDescription: "Returns compact review items, a count, the applied filters, and the chart payload for graph review.",
@@ -8925,13 +8963,17 @@ var reviewAffinityTool = defineAffinityTool({
       ]),
       horizonDays: integerSchema("Optional horizon-days filter."),
       exactOnly: booleanSchema("Whether duplicate review is exact-only."),
-      minScore: numberSchema("Optional duplicate minimum score."),
+      minScore: numberSchema(
+        "Optional duplicate minimum score (default 0.5; use 0 for all candidates)."
+      ),
       includeDismissed: booleanSchema(
         "Whether dismissed pairs are included in duplicate review (marked with dismissed flag)."
       ),
       since: integerSchema("Optional lower timestamp bound."),
       until: integerSchema("Optional upper timestamp bound."),
-      limit: integerSchema("Optional result limit."),
+      limit: integerSchema(
+        "Optional result limit, 1..10000 (default 50); use offset for paging."
+      ),
       offset: integerSchema("Optional result offset.")
     },
     ["view"],
@@ -9225,10 +9267,18 @@ function normalizeTimeInputs(value, now = Date.now(), inPatch = false) {
           `Invalid timestamp "${item}". ${error.message}`
         );
       }
+      if (!inPatch && ["occurredAt", "dueAt"].includes(key) && typeof item === "string" && /\.\d{4,}/.test(item)) {
+        const provenance = result.provenance ?? value.provenance;
+        result.provenance = {
+          ...provenance && typeof provenance === "object" ? provenance : {},
+          [`raw${key[0]?.toUpperCase()}${key.slice(1)}`]: item
+        };
+      }
       result[key] = parsed.timestamp;
       if (!inPatch && ["occurredAt", "dueAt"].includes(key))
         result[key.replace(/At$/, "On")] = parsed.day;
-    } else result[key] = normalizeTimeInputs(item, now, key === "patch");
+    } else if (key !== "provenance" || result.provenance === void 0)
+      result[key] = key === "provenance" ? item : normalizeTimeInputs(item, now, key === "patch");
   }
   return result;
 }
@@ -9260,6 +9310,12 @@ function timestampSchema(schema) {
 function surfaceProperties(tool) {
   return {
     ...tool.inputSchema.properties,
+    ...tool.name === "review_affinity" ? {
+      includeContent: {
+        type: "boolean",
+        description: "Deprecated alias for --with-content; includes verbatim event content."
+      }
+    } : {},
     ...["inspect_affinity_item", "review_affinity", "manage_event"].includes(
       tool.name
     ) ? {
@@ -9860,9 +9916,9 @@ async function openAffinityDb(path) {
   }
   const db = new sqlite.DatabaseSync(path);
   try {
-    db.exec("PRAGMA journal_mode=WAL; PRAGMA busy_timeout=5000;");
+    db.exec("PRAGMA busy_timeout=5000; PRAGMA journal_mode=WAL;");
     const context = db;
-    initAffinityTables(context);
+    withTransaction(context, () => initAffinityTables(context));
     return context;
   } catch (error) {
     db.close();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ghostpaw/affinity",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Relationship intelligence and social CRM model for Node.js — SQLite, zero dependencies, with a built-in LLM tool facade",
   "license": "MIT",
   "author": {

package/skills/affinity/references/import-history-without-faking-evidence.md

@@ -12,7 +12,7 @@ Use ghostpaw-affinity batch [--chunk 500] with JSONL {tool,args}, or
 Use externalRef {source:"bluesky",id:recordUri}, verbatim content and channel.
 Participant contact locators may use identities, including did, instead of ids.
 Read JSON flags from stdin with --input - or from @file for large payloads (E2BIG).
-SQLite date-times without offsets mean UTC; microseconds round to milliseconds.
+SQLite date-times without offsets mean UTC; microseconds truncate to milliseconds; raw timestamps remain in provenance.
 Missing inbound-follow timestamps should use a known first_seen or be counted as skipped.
 The synthetic scripts/examples/import_social_jsonl.mjs and import_dry_run.mjs
 show the mapping and verify an idempotent retry and byte-identical text.

package/skills/affinity/references/record-direct-evidence-well.md

@@ -11,7 +11,7 @@ arrive. Commitments and resolutions never reset contact recency or cadence.
 Imported text and event maintenance:
 - Use externalRef: {source, id} for idempotent intake; retries return no_op and the existing id.
 - Store verbatim text in content (up to 1,048,576 UTF-8 bytes, empty allowed). Summary is optional when content exists; its derived label is at most 140 characters.
-- Use channel for the medium, parentRef or parentEventId for replies, and threadRef for the root. Event attributes use target {kind: "event", eventId}.
+- Use channel for the medium, parentRef or parentEventId for replies, and threadRef for the root. Event attributes use target {kind: "event", eventId} or {kind: "event", ref: {source, id}}. Unchanged values return no_op.
 - Inspect kind "event" by eventId or ref. Search scope "events" or "all" discovers event ids; default scope remains contacts.
 - Review journals/timelines with includeContent: true only when needed; CLI uses --with-content. Filter with channel. Review events.thread by ref for chronological context.
 - Use manage_event revise with patch: summary, content, occurredAt, significance, channel, type within the same kind, or externalRef only when absent. Unknown keys fail validation.

package/skills/affinity/references/record-observations-and-referrals.md

@@ -1,7 +1,8 @@
 # Record Observations And Referrals
 
 Likes, reposts and follows are ambient observations, not milestones. Record them
-with affectsBond:false; observations with significance <=2 default to false.
+with affectsBond:false. Like/follow/repost labels default to false across families;
+explicit true opts in. Observations with significance <=2 also default to false.
 They stay in journals but do not change affinity or meaningful-contact recency.
 provenance.ambient:true also suppresses effects. Use explicit owner and other
 participants, actor/recipient roles, and the correct directionality.

package/skills/affinity/references/tools.md

@@ -58,7 +58,7 @@ Read-only.
 | Parameter | Type | Required | Values / description |
 | --- | --- | --- | --- |
 | ref | object | no |  |
-| includeContent | boolean | no | Include verbatim content in event rows; defaults to false. |
+| includeContent | boolean | no | Deprecated alias for --with-content; includes verbatim event content. |
 | channel | string | no | Filter events by channel. |
 | view | string | yes | contacts.list, contacts.duplicates, events.thread, events.contact_journal, events.link_timeline, events.moments, commitments.open, links.owner, links.observed, links.progression_readiness, links.radar, dates.upcoming, graph.chart, merges.history, merges.dismissed. Which review surface to return. |
 | now | integer / string | no | Optional current timestamp for overdue calculations. Accepts epoch milliseconds integer, ISO 8601 date-time with Z/offset, YYYY-MM-DD, DD.MM.YYYY, today, tomorrow, yesterday, +3d or -2d. UTC midnight for dates; dueAt uses UTC end of day. |
@@ -81,11 +81,11 @@ Read-only.
 | recurrenceKind | string | no | birthday, anniversary, renewal, memorial, custom_yearly. Optional recurrence-kind filter. |
 | horizonDays | integer | no | Optional horizon-days filter. |
 | exactOnly | boolean | no | Whether duplicate review is exact-only. |
-| minScore | number | no | Optional duplicate minimum score. |
+| minScore | number | no | Optional duplicate minimum score (default 0.5; use 0 for all candidates). |
 | includeDismissed | boolean | no | Whether dismissed pairs are included in duplicate review (marked with dismissed flag). |
 | since | integer / string | no | Optional lower timestamp bound. Accepts epoch milliseconds integer, ISO 8601 date-time with Z/offset, YYYY-MM-DD, DD.MM.YYYY, today, tomorrow, yesterday, +3d or -2d. UTC midnight for dates; dueAt uses UTC end of day. |
 | until | integer / string | no | Optional upper timestamp bound. Accepts epoch milliseconds integer, ISO 8601 date-time with Z/offset, YYYY-MM-DD, DD.MM.YYYY, today, tomorrow, yesterday, +3d or -2d. UTC midnight for dates; dueAt uses UTC end of day. |
-| limit | integer | no | Optional result limit. |
+| limit | integer | no | Optional result limit, 1..10000 (default 50); use offset for paging. |
 | offset | integer | no | Optional result offset. |
 | refSource | string | no | External reference source. |
 | refId | string | no | External reference id. |
@@ -302,7 +302,7 @@ Writes: writes_state.
 | kind | string | yes | interaction, observation, milestone, transaction. Event kind. |
 | input | object | yes | Event payload. Always required. Interaction events also require `type`. |
 | input.type | string | no | Interaction subtype. Required when kind=interaction, omit otherwise. |
-| input.affectsBond | boolean | no | Whether evidence affects the relationship; defaults false for observations with significance <=2. |
+| input.affectsBond | boolean | no | Whether evidence affects the relationship; defaults false for like/follow/repost labels and observations with significance <=2; explicit true opts in. |
 | input.content | string | no | Verbatim text, including empty text; at most 1 MB UTF-8. Summary may be omitted when content is supplied. |
 | input.externalRef | object | no |  |
 | input.channel | string | no | Free-text channel, trimmed and lowercased, at most 40 characters. |
@@ -340,7 +340,7 @@ Writes: writes_state.
 | resolution | string | no | kept, cancelled, broken. How the commitment was resolved. Required when action=resolve. |
 | options | object | no | Optional metadata. |
 | input.commitmentType | string | yes | Promise or agreement. |
-| input.affectsBond | boolean | no | Whether evidence affects the relationship; defaults false for observations with significance <=2. |
+| input.affectsBond | boolean | no | Whether evidence affects the relationship; defaults false for like/follow/repost labels and observations with significance <=2; explicit true opts in. |
 | input.content | string | no | Verbatim text, including empty text; at most 1 MB UTF-8. Summary may be omitted when content is supplied. |
 | input.externalRef | object | no |  |
 | input.channel | string | no | Free-text channel, trimmed and lowercased, at most 40 characters. |
@@ -421,7 +421,8 @@ Writes: writes_state.
 | entries | array | no | Key-value map to replace all attributes. Required when action=replace. |
 | removedAt | integer / string | no | Removal timestamp. Optional for action=unset. Accepts epoch milliseconds integer, ISO 8601 date-time with Z/offset, YYYY-MM-DD, DD.MM.YYYY, today, tomorrow, yesterday, +3d or -2d. UTC midnight for dates; dueAt uses UTC end of day. |
 | target.kind | string | yes | Target kind. |
-| target.eventId | integer | no | Target event id. |
+| target.eventId | integer | no | Target event id; provide eventId or ref. |
+| target.ref | object | no |  |
 | target.contact | object | no | Contact locator. Required when kind=contact. Provide contactId or identity. |
 | target.link | object | no | Link locator. Required when kind=link. Provide linkId or endpoints. |
 | entries.name | string | yes | Attribute name. |