@theronap/agnoclast-mcp 0.9.201 → 0.9.203

package/lib/diagnose.mjs

@@ -515,6 +515,11 @@ const PATH_TOOLS = {
   'intake/claim': 'intake_claim', 'intake/materialize': 'intake_materialize', 'staged': 'staged_records', 'brains': 'my_brains',
   'session-ping': 'session_ping', 'session-signals': 'session_signals', 'skills': 'skills',
   'ingest': 'capture', 'node-types': 'capture', 'obligations/candidates': 'capture',
+  // Named 2026-10-02 (obligation bbb5a8b5): these hook and cron endpoints were filing as `other`, which the
+  // server cannot trace. cli_paths_named.test.mjs now fails on any endpoint the CLI calls without a name.
+  'ingest/route': 'capture', 'staged/promote': 'capture', 'pressing/ack': 'arrivals_notice',
+  'resolve-candidates': 'resolve', 'resolve-apply': 'resolve', 'timeline/graphify': 'graphify_sync',
+  'brain/capture-default': 'set_capture_brain',
 }
 
 /** PURE. The tool an outage on `url` belongs to: the running tool if known, else a path mapping, else 'other'. */

package/lib/server.mjs

@@ -20,6 +20,7 @@ import { repoFullNameFrom, workingFilesFrom } from './capture.mjs'
 import { findTranscript, createWorkedFilesTracker } from './working_files.mjs'
 import { spawnObligationWorker } from './obligations_worker.mjs'
 import { renderObligations, renderPageObligations, tierReads, who } from './obligations_render.mjs'
+import { renderSettings } from './settings_render.mjs'
 import { formatCreated, formatDryRun, formatSources, homeFromArgs, pickSource, renderHomeProblem } from './custom_sources.mjs'
 
 // PAGE tiers (ADR-0071). Six for a PAGE; a RECORD keeps three (`privacy` on log_session and
@@ -2980,6 +2981,58 @@ function renderNudge(payload) {
     },
   )
 
+  // ADR-0074 — a person's own settings. The August 2026 ruling is "notices are on by default, and you
+  // turn one off by telling the assistant"; these two tools are how the assistant does that.
+  server.registerTool(
+    'my_settings',
+    {
+      title: 'My settings',
+      description: "The person's own Agnoclast settings: which notices they get without asking (meetings about to start, deadlines within the hour, what is due today, hand-offs, lapses) and their timezone. The same settings as the Settings page in the console. Read this before answering \"why am I (not) being told about X\".",
+      inputSchema: {},
+    },
+    async () => {
+      let res
+      try {
+        res = await fetchCortex(`${BASE}/api/settings`, { headers: { Authorization: `Bearer ${TOKEN}` } })
+      } catch (e) { return toolError(`Could not reach settings: ${e.message}`) }
+      const out = await res.json().catch(() => null)
+      if (!res.ok) return toolError(`Could not read settings: ${out?.detail ?? out?.error ?? res.status}`)
+      return { content: [{ type: 'text', text: renderSettings(out) }] }
+    },
+  )
+
+  server.registerTool(
+    'set_setting',
+    {
+      title: 'Change one of my settings',
+      description: "Change one of the person's own settings — ONLY when they asked you to (\"stop telling me what's due today\", \"set my timezone to Denver\"). Never on your own initiative, and never to quiet something you find noisy: a notice the person did not turn off is one they rely on. Pass `key` and `value` for a notice (keys from my_settings, e.g. notices.due_today = false), or `timezone` alone with an IANA name such as America/Denver. Say what you changed, and that they can change it back in Settings.",
+      inputSchema: {
+        key: z.string().optional().describe('the setting, exactly as my_settings lists it, e.g. notices.due_today'),
+        value: z.boolean().optional().describe('true = on, false = off'),
+        timezone: z.string().optional().describe('instead of key/value: an IANA timezone, e.g. America/Denver'),
+      },
+    },
+    async ({ key, value, timezone }) => {
+      const body = timezone ? { timezone } : { key, value }
+      let res
+      try {
+        res = await fetchCortex(`${BASE}/api/settings`, {
+          method: 'POST',
+          headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' },
+          body: JSON.stringify(body),
+        })
+      } catch (e) { return toolError(`Could not reach settings: ${e.message}`) }
+      const out = await res.json().catch(() => null)
+      if (!res.ok) return toolError(`Not changed: ${out?.detail ?? out?.error ?? res.status}`)
+      const text = timezone
+        ? `Timezone set to ${out.timezone} on ${out.memberships} brain${out.memberships === 1 ? '' : 's'}. They can change it in Settings.`
+        : !out.changed
+          ? `${out.key} was already ${out.value ? 'on' : 'off'} — nothing changed.`
+          : `${out.key} is now ${out.value ? 'ON' : 'OFF'}. They can turn it back ${out.value ? 'off' : 'on'} in Settings (or ask you).`
+      return { content: [{ type: 'text', text }] }
+    },
+  )
+
   server.registerTool(
     'set_obligation_tier',
     {

package/lib/settings_render.mjs

@@ -0,0 +1,21 @@
+// PURE: what my_settings prints (ADR-0074). Out of server.mjs so a test can reach it.
+//
+// Says ON/OFF per notice with the person's own words for it, and names the default when a setting has
+// been changed from it — "off (default on)" is the line that answers "why am I not hearing about X?".
+const one = (s) => String(s ?? '').replace(/\s+/g, ' ').trim().slice(0, 160)
+
+export function renderSettings(view) {
+  const settings = Array.isArray(view?.settings) ? view.settings : []
+  const lines = ['NOTICES — what Agnoclast tells this person without being asked (sessions and desktop):']
+  for (const s of settings) {
+    const state = s.value ? 'ON ' : 'OFF'
+    const changed = s.value !== s.default ? `  (changed — default ${s.default ? 'on' : 'off'})` : ''
+    lines.push(`  ${state}  ${one(s.key)} — ${one(s.label)}${changed}`)
+  }
+  if (!settings.length) lines.push('  (none returned — the server may predate settings)')
+  lines.push('')
+  lines.push(`TIMEZONE: ${view?.timezone ? one(view.timezone) : 'not set'}`)
+  lines.push('')
+  lines.push('Change one only when the person asks: set_setting. They can also change these in Settings (console avatar menu, or ⌘, in the desktop app).')
+  return lines.join('\n')
+}

package/package.json

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