@theronap/agnoclast-mcp 0.9.182 → 0.9.183

package/lib/server.mjs

@@ -89,6 +89,27 @@ export function intakeMaterializePath(mode) {
 }
 
 /** ADR-0062 §5.2. Which page governs a materialized record, and who chose it — or '' for an older server. */
+// ADR-0051's refusal, rendered as INSTRUCTIONS — shared by route_record and intake_materialize so the two
+// verbs cannot drift apart (the server shares OTHER_HOMES_DETAIL for the same reason). The agent is one
+// call from succeeding, and the whole point of the gate is the question it asks; a bare
+// "other_homes_unchecked" reads as a malfunction and gets retried verbatim.
+function otherHomesRefusalText(opener) {
+  return [
+    opener,
+    '',
+    'What OTHER pages does this record belong on? A record is usually about more than the page an',
+    'identifier matched: the project it concerns, the person it is about, the decision it bears on.',
+    '',
+    '  know some already   → add them to documentIds and call again',
+    '  none come to mind   → go look first. grep or read for pages this could belong to;',
+    '                        you know the namespace better than any matcher does',
+    '  looked, found none  → call again with searchedForOtherHomes: true',
+    '',
+    'Parking is still a complete answer, and a wrong attachment is still worse than none. The gate',
+    'asks that you looked, not that you found something.',
+  ].join('\n')
+}
+
 export function renderGoverningLine(governing) {
   if (!governing || typeof governing !== 'object') return ''
   const name = governing.title || 'a page'
@@ -1117,7 +1138,8 @@ function renderNudge(payload) {
       description:
         'Atomically publish a claimed intake item into one brain — the disclosure moment (ADR-0062). Deterministic identifier homes in that brain are always attached; documentIds may add further pages. The record is born at the strictest of its source baseline, what the producer asked for, and every attached page; a source floor (iMessage, claude-code) pins it. ' +
         'Name the governing page with governingPage (one of documentIds, never a person page) — otherwise the ranking picks it. ' +
-        'Pass mode "preview" first when your choice differs from the claim\'s proposal: it returns the pages, the governing page and the tier this exact call would produce, and writes nothing. Never writes private intake into search/history before this call.',
+        'Pass mode "preview" first when your choice differs from the claim\'s proposal: it returns the pages, the governing page and the tier this exact call would produce, and writes nothing. Never writes private intake into search/history before this call. ' +
+        '⚠ ADR-0051: a unit does not finish until you looked for its OTHER homes. A call whose documentIds add nothing beyond the deterministic homes it gets anyway is REFUSED once — name the pages this unit is about (the design it implements, the project, the person), or go look, or say you looked with searchedForOtherHomes.',
       inputSchema: {
         intakeItemId: z.string().describe('intake item uuid'),
         orgId: z.string().describe('destination brain org uuid'),
@@ -1136,6 +1158,12 @@ function renderNudge(payload) {
         mode: z.enum(['preview', 'apply']).optional().describe(
           '"preview": report the pages, governing page and tier this call would produce, and write nothing. Default "apply".',
         ),
+        searchedForOtherHomes: z.boolean().optional().describe(
+          'ADR-0051. "I looked for other homes and there are genuinely none." Only consulted when documentIds add no page ' +
+          'beyond the deterministic homes. ⚠ DO NOT SEND THIS ON THE FIRST CALL AS A MATTER OF COURSE — it is the answer AFTER ' +
+          'looking, not a way past the question. Measured 2026-09-25: 30 records filed through this verb in one afternoon with no ' +
+          'judged page on any of them.',
+        ),
       },
     },
     async (args) => {
@@ -1158,10 +1186,20 @@ function renderNudge(payload) {
           },
           attachmentMeta: (args.documentIds ?? []).map(() => ({ origin: args.origin ?? 'llm' })),
           ...(args.governingPage ? { governingDocumentId: args.governingPage } : {}),
+          ...(args.searchedForOtherHomes ? { searchedForOtherHomes: true } : {}),
         }),
       })
       if (!res.ok) {
         const body = await res.text()
+        if (res.status === 409) {
+          let err = null
+          try { err = JSON.parse(body)?.error } catch { /* not JSON: fall through to the raw text */ }
+          if (err === 'other_homes_unchecked') {
+            return toolError(otherHomesRefusalText(
+              'Not filed yet — every page named is one this unit gets anyway, so this would publish it without adding anything of your judgment.',
+            ))
+          }
+        }
         if (preview && res.status === 404) {
           return toolError('This server cannot preview a materialization yet — nothing was written. Materialize without mode, or wait for the server to update.')
         }
@@ -4641,22 +4679,9 @@ function renderNudge(payload) {
       // agent is one call from succeeding and the whole point of the gate is the question it asks. A
       // bare "other_homes_unchecked" would read as a malfunction and get retried verbatim.
       if (!res.ok && out?.error === 'other_homes_unchecked') {
-        return toolError([
-          park
-            ? 'Not parked yet — before a record is filed as having no home, look for its other homes.'
-            : 'Not routed yet — every page you named is already attached, so this call would finish the record without adding anything.',
-          '',
-          'What OTHER pages does this record belong on? A record is usually about more than the page an',
-          'identifier matched: the project it concerns, the person it is about, the decision it bears on.',
-          '',
-          '  know some already   → add them to documentIds and call again',
-          '  none come to mind   → go look first. grep or read for pages this could belong to;',
-          '                        you know the namespace better than any matcher does',
-          '  looked, found none  → call again with searchedForOtherHomes: true',
-          '',
-          'Parking is still a complete answer, and a wrong attachment is still worse than none. The gate',
-          'asks that you looked, not that you found something.',
-        ].join('\n'))
+        return toolError(otherHomesRefusalText(park
+          ? 'Not parked yet — before a record is filed as having no home, look for its other homes.'
+          : 'Not routed yet — every page you named is already attached, so this call would finish the record without adding anything.'))
       }
       if (!res.ok) return toolError(`Could not route record: ${out?.error ?? res.status}${out?.detail ? ` — ${out.detail}` : ''}`)
       if (park) return { content: [{ type: 'text', text: 'Parked. It stays visible and unrouted rather than badly attached.' }] }

package/package.json

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