@theronap/agnoclast-mcp 0.9.197 → 0.9.198

package/lib/obligations_render.mjs

@@ -19,16 +19,26 @@
 export function renderObligations(obs, now = Date.now()) {
   if (!obs?.length) return 'Nothing open.'
   const proposed = obs.filter((o) => o.state === 'proposed').length
+  // ADR-0073: every obligation lives on a page. `needsPage` is sent only by a server that knows the
+  // rule, so against an older one this count is zero and the output is exactly what it was.
+  const homeless = obs.filter((o) => o.needsPage === true).length
   const lines = [
     proposed
       ? `${obs.length} open — ${proposed} of them PROPOSED: extracted from a record, not entered by you. A wrong one: resolve_obligation with state "cancelled".`
       : `${obs.length} open:`,
+    ...(homeless
+      ? [`${homeless} of them ${homeless === 1 ? 'is' : 'are'} on NO PAGE anyone chose — marked ⚠ below. Read the page each belongs on, then \`set_obligation_pages\`. Do not guess: ask when it is not clear.`]
+      : []),
     '',
   ]
   for (const o of obs) {
     const when = describeDue(o, now)
     lines.push(`${o.id}`)
     lines.push(`  ${o.subject}  — ${when}${o.state === 'snoozed' ? ' (snooze expired)' : ''}${o.state === 'proposed' ? '  [PROPOSED]' : ''}`)
+    // Where it lives. Page titles are other people's text as much as subjects are: quoted, one line.
+    const pages = Array.isArray(o.pages) ? o.pages.filter((p) => p?.origin !== 'fallback') : []
+    if (pages.length) lines.push(`  on: ${pages.slice(0, 4).map((p) => `“${String(p.title ?? '').replace(/\s+/g, ' ').trim().slice(0, 60)}”`).join(' · ')}${pages.length > 4 ? ` … and ${pages.length - 4} more` : ''}`)
+    if (o.needsPage === true) lines.push('  ⚠ on no page anyone chose — set_obligation_pages')
     // ⚠ EVIDENCE IS RENDERED AS A QUESTION, NEVER AS A VERDICT. The phrasing is the feature:
     // "is this done?" costs the reader a second, "you still owe this" about finished work costs
     // the channel its credibility.

package/lib/server.mjs

@@ -2918,22 +2918,23 @@ function renderNudge(payload) {
     'track_obligation',
     {
       title: 'Record something you owe',
-      description: "Record something you owe: a subject, optionally when it comes due, optionally whose reply would discharge it. ⚠ ONLY A DATE MAKES IT COME BACK. A DATED obligation is raised to the person's sessions by time, unasked, BEFORE it lapses: counted on the day it is due, and named when a stated clock time is within the hour. Once late it is never raised again, and an UNDATED one is never raised by anything — it surfaces only when someone asks with my_obligations. ⚠ NEVER INVENT A DUE DATE — and that matters more now, because an invented date will interrupt someone. Omit due_at when there genuinely is no deadline (a standing obligation); a guessed date is indistinguishable from a real one the moment it is stored, and it is the direct route to nagging about something that was never actually late. `anchor_identifier` is the useful part: give it the counterparty's address as `email:someone@example.com` and any record arriving from them is automatically offered as evidence that this may be done — computed when the record lands, not by a scanner.",
+      description: "Record something you owe: a subject, the page or pages it is about, optionally when it comes due, optionally whose reply would discharge it. ⚠ EVERY OBLIGATION LIVES ON A PAGE, CHOSEN NOW. `pages` is required: READ the page this is about first (read_page prints its `ref:`), then pass that ref — several when it genuinely belongs on several. Never guess a page to get past the check, and never default to the person's own page: if you cannot tell where it belongs, ask them. A page says where the obligation is FOUND; it stays visible to its owner only. ⚠ ONLY A DATE MAKES IT COME BACK. A DATED obligation is raised to the person's sessions by time, unasked, BEFORE it lapses: counted on the day it is due, and named when a stated clock time is within the hour. Once late it is never raised again, and an UNDATED one is never raised by anything — it surfaces only when someone asks with my_obligations. ⚠ NEVER INVENT A DUE DATE — and that matters more now, because an invented date will interrupt someone. Omit due_at when there genuinely is no deadline (a standing obligation); a guessed date is indistinguishable from a real one the moment it is stored, and it is the direct route to nagging about something that was never actually late. `anchor_identifier` is the useful part: give it the counterparty's address as `email:someone@example.com` and any record arriving from them is automatically offered as evidence that this may be done — computed when the record lands, not by a scanner.",
       inputSchema: {
         subject: z.string().describe('what is owed, in your own words'),
+        pages: z.array(z.string()).min(1).describe('REQUIRED. The `ref:` of each page this obligation is about, exactly as read_page prints it. Read the page first; do not guess.'),
         due_at: z.string().optional().describe('ISO 8601. OMIT when there is no real deadline — never guess one.'),
         anchor_identifier: z.string().optional().describe('e.g. "email:ben@example.com" — records from them become evidence this may be done'),
         source_record_id: z.string().optional().describe('the record this came from, if any'),
         brain: z.string().optional().describe('required only if you belong to more than one brain'),
       },
     },
-    async ({ subject, due_at, anchor_identifier, source_record_id, brain }) => {
+    async ({ subject, pages, due_at, anchor_identifier, source_record_id, brain }) => {
       let res
       try {
         res = await fetchCortex(`${BASE}/api/obligations`, {
           method: 'POST',
           headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' },
-          body: JSON.stringify({ subject, dueAt: due_at, anchorIdentifier: anchor_identifier, sourceRecordId: source_record_id, brain }),
+          body: JSON.stringify({ subject, pages, dueAt: due_at, anchorIdentifier: anchor_identifier, sourceRecordId: source_record_id, brain }),
         })
       } catch (e) { return toolError(`Could not reach obligations: ${e.message}`) }
       const out = await res.json().catch(() => null)
@@ -2946,7 +2947,34 @@ function renderNudge(payload) {
       const note = anchor_identifier
         ? `\nRecords carrying ${anchor_identifier} will be offered as evidence this is done. ${nudge}`
         : `\n${nudge}`
-      return { content: [{ type: 'text', text: `Recorded: ${subject}${due_at ? ` (due ${due_at.slice(0, 10)})` : ' (no deadline)'}\n${out.id}${note}` }] }
+      const on = Number(out.pages) > 0 ? ` — on ${out.pages} page${out.pages === 1 ? '' : 's'}` : ''
+      return { content: [{ type: 'text', text: `Recorded: ${subject}${due_at ? ` (due ${due_at.slice(0, 10)})` : ' (no deadline)'}${on}\n${out.id}${note}` }] }
+    },
+  )
+
+  server.registerTool(
+    'set_obligation_pages',
+    {
+      title: 'Say which pages an obligation lives on',
+      description: "Say which page or pages an existing obligation lives on (ADR-0073). The list you pass REPLACES what it had, so pass the complete set. Use it for an obligation my_obligations marks ⚠ — one created before pages were required, or one a machine put on its owner's own page for want of anywhere better — and to correct a wrong placement. READ the pages first and choose; when it is not clear where something belongs, ask the person rather than guessing. An obligation can never be left on zero pages, only its owner can place it, and it stays visible to its owner only.",
+      inputSchema: {
+        obligation_id: z.string().describe('from my_obligations'),
+        pages: z.array(z.string()).min(1).describe('the COMPLETE list of page refs it should live on, as read_page prints them'),
+      },
+    },
+    async ({ obligation_id, pages }) => {
+      let res
+      try {
+        res = await fetchCortex(`${BASE}/api/obligations/pages`, {
+          method: 'POST',
+          headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' },
+          body: JSON.stringify({ obligationId: obligation_id, pages }),
+        })
+      } catch (e) { return toolError(`Could not reach obligations: ${e.message}`) }
+      const out = await res.json().catch(() => null)
+      if (!res.ok) return toolError(`Could not place it: ${out?.detail ?? out?.error ?? res.status}`)
+      const titles = (out?.pages ?? []).map((p) => `“${String(p.title ?? '').replace(/\s+/g, ' ').trim().slice(0, 60)}”`)
+      return { content: [{ type: 'text', text: `It now lives on: ${titles.join(' · ') || '(no page returned)'}` }] }
     },
   )
 

package/package.json

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