@ghostpaw/affinity 0.6.0 → 0.6.1

package/dist/index.cjs

@@ -1399,6 +1399,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)
@@ -1689,14 +1691,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));
@@ -1716,7 +1713,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 };
 }
@@ -2437,7 +2434,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(
@@ -5634,7 +5633,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,
@@ -5762,12 +5761,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
   );
@@ -6062,7 +6063,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.
@@ -6324,7 +6325,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.
@@ -6390,7 +6391,8 @@ var recordObservationsAndReferralsSkill = defineAffinitySkill({
   content: `# 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.
@@ -6769,7 +6771,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."
@@ -7308,6 +7310,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;
@@ -7325,7 +7334,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
       );
@@ -7719,6 +7728,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 = ?"
@@ -7858,7 +7872,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) {
@@ -7940,7 +7977,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."
           ),
@@ -9816,12 +9854,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;
@@ -9873,7 +9911,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
@@ -9887,9 +9925,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": {
@@ -10148,7 +10187,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.",
@@ -10253,13 +10292,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"],

package/dist/index.d.cts

@@ -273,6 +273,7 @@ interface ExternalRef {
 /** Journal entry with explicit participants — CONCEPT.md EventRecord. */
 interface EventRecord {
     content?: string;
+    provenance?: unknown;
     externalRef?: ExternalRef;
     channel?: string;
     parentRef?: ExternalRef;
@@ -846,6 +847,7 @@ declare function searchEvents(db: AffinityDb, query: string, options?: {
     offset?: number;
 }): EventSearchItem[];
 declare function getEventThread(db: AffinityDb, source: string, id: string, options?: {
+    eventTypes?: readonly EventType[];
     includeContent?: boolean;
     channel?: string;
     limit?: number;
@@ -1491,6 +1493,11 @@ type AttributeTargetInput = {
 } | {
     kind: "event";
     eventId: number;
+    ref?: never;
+} | {
+    kind: "event";
+    ref: ExternalRef;
+    eventId?: never;
 };
 type ManageAttributeToolInput = {
     action: "set";

package/dist/index.d.ts

@@ -273,6 +273,7 @@ interface ExternalRef {
 /** Journal entry with explicit participants — CONCEPT.md EventRecord. */
 interface EventRecord {
     content?: string;
+    provenance?: unknown;
     externalRef?: ExternalRef;
     channel?: string;
     parentRef?: ExternalRef;
@@ -846,6 +847,7 @@ declare function searchEvents(db: AffinityDb, query: string, options?: {
     offset?: number;
 }): EventSearchItem[];
 declare function getEventThread(db: AffinityDb, source: string, id: string, options?: {
+    eventTypes?: readonly EventType[];
     includeContent?: boolean;
     channel?: string;
     limit?: number;
@@ -1491,6 +1493,11 @@ type AttributeTargetInput = {
 } | {
     kind: "event";
     eventId: number;
+    ref?: never;
+} | {
+    kind: "event";
+    ref: ExternalRef;
+    eventId?: never;
 };
 type ManageAttributeToolInput = {
     action: "set";

package/dist/index.js

@@ -1397,6 +1397,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)
@@ -1687,14 +1689,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));
@@ -1714,7 +1711,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 };
 }
@@ -2435,7 +2432,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(
@@ -5632,7 +5631,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,
@@ -5760,12 +5759,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
   );
@@ -6060,7 +6061,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.
@@ -6322,7 +6323,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.
@@ -6388,7 +6389,8 @@ var recordObservationsAndReferralsSkill = defineAffinitySkill({
   content: `# 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.
@@ -6767,7 +6769,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."
@@ -7306,6 +7308,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;
@@ -7323,7 +7332,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
       );
@@ -7717,6 +7726,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 = ?"
@@ -7856,7 +7870,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) {
@@ -7938,7 +7975,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."
           ),
@@ -9814,12 +9852,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;
@@ -9871,7 +9909,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
@@ -9885,9 +9923,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": {
@@ -10146,7 +10185,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.",
@@ -10251,13 +10290,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"],