@theronap/agnoclast-mcp 0.9.224 → 0.9.225

package/lib/server.mjs

@@ -5270,13 +5270,14 @@ function renderNudge(payload) {
     'set_routing_identifier',
     {
       title: 'Claim a routing identifier on a page',
-      description: 'Declare that a page is a Gate 4 attach HOME for an identifier (repo:owner/name or file:owner/name:path). Body [[repo:…]] stamps are navigation only and do NOT drive attach — use this instead. Prefer the narrowest id: mother pages own repo:; feature pages own file: paths. Do not copy every body mention into a routing claim.',
+      description: 'Declare that a page is a Gate 4 attach HOME for an identifier (repo:owner/name or file:owner/name:path). Body [[repo:…]] stamps are navigation only and do NOT drive attach — use this instead. Prefer the narrowest id: mother pages own repo:; feature pages own file: paths. Do not copy every body mention into a routing claim. ' +
+        'PRIVATE CONTACT CLAIMS (ADR-0079): on a PERSON page you may claim `phone:<number>` (normalized to E.164, US default — `phone:(801) 636-7505` stores `phone:+18016367505`) or `email:<address>` (lowercased). These are visible ONLY to you — never in the page body, grep, or to other brain members — and they make your captured texts / mail from that contact propose that person page. This is the right place for a contact\'s number; never put it in page text.',
       inputSchema: {
         kind: z.enum(['project', 'person', 'org', 'user']).describe('the page kind'),
         name: z.string().optional().describe('page title (or pass ref)'),
         ref: z.string().optional().describe('node ref from read_page — prefer over name when available'),
         brain: z.string().optional().describe('brain label when the title is ambiguous across brains'),
-        identifier: z.string().describe('canonical identifier, e.g. repo:theronap/cortex or file:theronap/cortex:web/lib/engine/github_intake.ts'),
+        identifier: z.string().describe('canonical identifier, e.g. repo:theronap/cortex, file:theronap/cortex:web/lib/engine/github_intake.ts, or on a person page phone:+18015550123 / email:someone@example.com (private to you)'),
       },
     },
     async ({ kind, name, ref, brain, identifier }) => {
@@ -5292,7 +5293,12 @@ function renderNudge(payload) {
         return toolError(`Could not set routing identifier: ${e.message}`)
       }
       const out = await res.json().catch(() => null)
-      if (!res.ok) return toolError(`Could not set routing identifier: ${out?.error ?? res.status}`)
+      if (!res.ok) {
+        // A per-identifier refusal arrives in `errors[]` with a top-level 400 — name it, not just the status.
+        const why = out?.error ?? out?.errors?.map((e) => e.error).join(', ') ?? res.status
+        const hint = /phone_claims_person_pages_only/.test(String(why)) ? ' A phone: claim goes on the PERSON page for that contact (kind: person).' : ''
+        return toolError(`Could not set routing identifier: ${why}.${hint}`)
+      }
       const set = out?.set?.join(', ') ?? identifier
       // ⚠ SAY WHAT ALREADY HAPPENED, NOT ONLY WHAT WILL. The claim heals history in the same
       // statement, so by the time this renders, existing records are ALREADY attached. The previous
@@ -5306,7 +5312,11 @@ function renderNudge(payload) {
         : healed > 0
           ? ` ${healed} existing record(s) ALREADY attached to this page as a result.`
           : ' 0 existing records attached — either nothing carries this identifier yet, or records do but belong to another owner (an identity claim only attaches your own).'
-      return { content: [{ type: 'text', text: `Routing identifier set on document ${out?.documentId ?? '?'}: ${set}.${healedLine} Future matching events will attach here too (body mentions alone will not).` }] }
+      const isContact = /^(phone|email):/.test(String(out?.set?.[0] ?? identifier).toLowerCase())
+      const privacyLine = isContact
+        ? ' This contact claim is PRIVATE to you: no other brain member can see it, and it is never rendered in the page. Your captured texts/mail from this contact will now propose this page.'
+        : ''
+      return { content: [{ type: 'text', text: `Routing identifier set on document ${out?.documentId ?? '?'}: ${set}.${healedLine} Future matching events will attach here too (body mentions alone will not).${privacyLine}` }] }
     },
   )
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theronap/agnoclast-mcp",
-  "version": "0.9.224",
+  "version": "0.9.225",
   "description": "Connect your AI assistant to Cortex — your org's projects, activity, gaps, and directives, scoped to you.",
   "type": "module",
   "bin": {