@theronap/cortex-mcp 0.9.133 → 0.9.134

package/lib/server.mjs

@@ -2253,6 +2253,45 @@ function renderNudge(payload) {
     },
   )
 
+  server.registerTool(
+    'supersede_record',
+    {
+      title: 'Mark a record as no longer the answer',
+      description: "Say that a record is wrong, outdated or replaced — WITHOUT deleting it. Use it when you re-capture something properly and the old copy should stop showing up: a transcript filed with a bad occurred_at, a duplicate capture, a low-fidelity copy replaced by a content_path one. \u26a0 NOTHING IS DESTROYED AND THIS IS REVERSIBLE (`restore: true`). The row, its page attachments and its containment all stay exactly as they were; only the READS change — it disappears from its pages, from its container's contents, and from the \"holds N\" count on find_sessions. It stays SEARCHABLE on purpose: hiding a record from search would be most of the way to deleting it without the audit trail. \u26a0 THERE IS NO DELETE, DELIBERATELY (ADR-0049) — 13 of the 15 foreign keys to a record CASCADE, so a real delete would unfile everything inside a container, drop clearance anchors and rewrite the claim ledger, while still leaving revision rows behind. If you actually need content destroyed rather than hidden, say so to the user rather than reaching for this. \u26a0 REFUSED ON A CONTAINER (a class session, a meeting): hiding an event that still holds other records leaves their placements pointing at nothing. Supersede the records INSIDE it instead.",
+      inputSchema: {
+        record_id: z.string().describe('the record that is no longer the answer'),
+        reason: z.string().optional().describe('WHY it is no longer right — required unless restoring, and the one thing that cannot be inferred later'),
+        superseded_by: z.string().optional().describe('the record that REPLACES it, if there is one. Must be in the same brain. Optional: "this is wrong" is a complete statement on its own.'),
+        restore: z.boolean().optional().describe('true = undo a previous supersede and make it current again'),
+      },
+    },
+    async ({ record_id, reason, superseded_by, restore }) => {
+      let res
+      try {
+        res = await fetchCortex(`${BASE}/api/records/supersede`, {
+          method: 'POST',
+          headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' },
+          body: JSON.stringify({ recordId: record_id, reason, supersededBy: superseded_by, restore }),
+        })
+      } catch (e) {
+        return toolError(`Could not reach Agnoclast: ${e.message}`)
+      }
+      const body = await res.json().catch(() => ({}))
+      if (!res.ok || !body?.ok) {
+        return toolError(`Could not supersede ${record_id}: ${body?.error ?? res.status}${body?.detail ? ` \u2014 ${body.detail}` : ''}`)
+      }
+      if (restore) {
+        return { content: [{ type: 'text', text: `Restored ${record_id} — it is a current record again and reappears on its pages and in its container.` }] }
+      }
+      const l = [`Superseded ${record_id}.`]
+      if (body.supersededBy) l.push(`Replaced by ${body.supersededBy}.`)
+      // \u26a0 SAY WHAT DID NOT HAPPEN. The caller's next question is always whether this deleted
+      // something. It did not, and a reader who assumes it did will not think to restore.
+      l.push('Nothing was deleted — the row, its page attachments and its containment are intact. It is hidden from its pages, its container contents and session holds-counts, and stays searchable. `restore: true` reverses this.')
+      return { content: [{ type: 'text', text: l.join('\n') }] }
+    },
+  )
+
   server.registerTool(
     'find_sessions',
     {

package/package.json

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