@theronap/agnoclast-mcp 0.9.229 → 0.9.230

package/lib/server.mjs

@@ -5177,19 +5177,22 @@ function renderNudge(payload) {
       description: 'Set the CURRENCY of one of YOUR OWN authored pages so the brain can filter out stale info: "current" (reflects reality now — the default), "superseded" (replaced by a newer page — pass superseded_by with that page\'s name), or "historical" (kept for the record, no longer current). Optionally set modality: "reality" (as-built), "plan" (intended, not yet real), or "construction" (being built now). Call this the moment your understanding changes that a page is no longer the live truth — e.g. right after you author the new reality, mark the old page superseded. Owner-only.',
       inputSchema: {
         kind: z.enum(['project', 'person', 'org', 'user']).describe('the page kind'),
-        name: z.string().describe('the exact page name'),
+        name: z.string().optional().describe('the exact page name (or pass `ref` instead — one of the two is required)'),
+        ref: z.string().optional().describe('the page\'s stable id, printed as `ref:` by read_page. PREFER THIS over name when you have it: a ref is unique across brains, so it never hits ambiguous_page_name.'),
+        brain: z.string().optional().describe('optional: which brain the named page lives in, when the same name exists in several'),
         validity: z.enum(['current', 'superseded', 'historical']).describe('the currency state'),
         modality: z.enum(['reality', 'plan', 'construction']).optional().describe('what the page describes (optional)'),
         superseded_by: z.string().optional().describe('for superseded: the name of the page that replaced it'),
       },
     },
-    async ({ kind, name, validity, modality, superseded_by }) => {
+    async ({ kind, name, ref, brain, validity, modality, superseded_by }) => {
+      if (!name && !ref) return toolError('Could not set validity: pass `name` or `ref` (read_page prints the ref).')
       let res
       try {
         res = await fetchCortex(`${BASE}/api/brain/validity`, {
           method: 'POST',
           headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' },
-          body: JSON.stringify({ kind, name, validity, modality, superseded_by }),
+          body: JSON.stringify({ kind, name, ref, brain, validity, modality, superseded_by }),
         })
       } catch (e) {
         return toolError(`Could not set validity: ${e.message}`)
@@ -5199,7 +5202,7 @@ function renderNudge(payload) {
         return toolError(`Could not set validity: ${d.message}`)
       }
       const out = await res.json()
-      return { content: [{ type: 'text', text: `Done — "${out.name}" is now ${out.validity}${out.modality ? ` / ${out.modality}` : ''} (${out.docs_updated} tier-doc(s) updated).` }] }
+      return { content: [{ type: 'text', text: `Done — "${out.name ?? out.ref}" (${out.brain ?? 'brain ?'}) is now ${out.validity}${out.modality ? ` / ${out.modality}` : ''} (${out.docs_updated} tier-doc(s) updated).` }] }
     },
   )
 

package/package.json

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