@ghostpaw/affinity 0.6.0 → 0.6.1

package/dist/mcp-server.js

@@ -296,7 +296,7 @@ var init_mcp_stdio = __esm({
 var affinityVersion;
 var init_version = __esm({
   "src/version.ts"() {
-    affinityVersion = "0.6.0";
+    affinityVersion = "0.6.1";
   }
 });
 
@@ -767,6 +767,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)
@@ -1082,14 +1084,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));
@@ -1109,7 +1106,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 };
 }
@@ -2289,7 +2286,7 @@ var init_event_metadata_schema = __esm({
     );
     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."
@@ -2876,6 +2873,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;
@@ -2893,7 +2897,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
       );
@@ -3408,6 +3412,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 = ?"
@@ -3578,7 +3587,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) {
@@ -3642,6 +3674,8 @@ var init_manage_attribute_tool = __esm({
     init_replace_attributes();
     init_set_attribute();
     init_unset_attribute();
+    init_event_metadata();
+    init_event_metadata_schema();
     init_tool_metadata();
     init_tool_mutation();
     init_tool_names();
@@ -3672,7 +3706,8 @@ var init_manage_attribute_tool = __esm({
           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."
               ),
@@ -3730,7 +3765,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(
@@ -5538,7 +5575,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,
@@ -9200,12 +9237,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
   );
@@ -9923,12 +9962,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;
@@ -9980,7 +10019,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
@@ -9994,9 +10033,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": {
@@ -10284,7 +10324,7 @@ var init_review_affinity_tool = __esm({
         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.",
@@ -10389,13 +10429,17 @@ var init_review_affinity_tool = __esm({
           ]),
           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"],
@@ -10733,10 +10777,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;
 }
@@ -10778,6 +10830,12 @@ var init_timestamp_schema = __esm({
 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
     ) ? {
@@ -11464,9 +11522,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();
@@ -11476,6 +11534,7 @@ async function openAffinityDb(path) {
 var init_open_affinity_db = __esm({
   "src/surface/open_affinity_db.ts"() {
     init_init_affinity_tables();
+    init_with_transaction();
   }
 });
 function resolveAffinityDbPath(options = {}) {

package/dist/mcp.cjs

@@ -5,7 +5,7 @@ var node_path = require('node:path');
 var node_os = require('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.";
@@ -382,6 +382,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)
@@ -672,14 +674,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));
@@ -699,7 +696,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 };
 }
@@ -1739,7 +1736,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."
@@ -2289,6 +2286,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;
@@ -2306,7 +2310,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
       );
@@ -2743,6 +2747,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 = ?"
@@ -2882,7 +2891,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) {
@@ -2964,7 +2996,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."
           ),
@@ -3020,7 +3053,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(
@@ -4692,7 +4727,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,
@@ -7833,12 +7868,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
   );
@@ -8490,12 +8527,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;
@@ -8547,7 +8584,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
@@ -8561,9 +8598,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": {
@@ -8822,7 +8860,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.",
@@ -8927,13 +8965,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"],
@@ -9227,10 +9269,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;
 }
@@ -9262,6 +9312,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
     ) ? {
@@ -9862,9 +9918,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();