@theronap/agnoclast-mcp 0.9.233 → 0.9.234

package/lib/server.mjs

@@ -31,6 +31,7 @@ import { formatCreated, formatDryRun, formatSources, homeFromArgs, pickSource, r
 import { formatSeriesRefusal, formatSeriesUpdated } from './series_render.mjs'
 import { formatSends } from './sends_render.mjs'
 import { applyLock, fetchLockState, lockedAnswerFor, lockStateWithin } from './locked_tools.mjs'
+import { filterUnshownSettling } from './settling_shown.mjs'
 
 // PAGE tiers (ADR-0071). Six for a PAGE; a RECORD keeps three (`privacy` on log_session and
 // set_record_privacy below) — an owner-relative tier is applied to a page's records when they are read
@@ -450,9 +451,18 @@ function renderArrival(payload) {
     ` — \`staged_records\` lists them. Not offered to you, just counted; \`ignore_arrivals\` if this is noise right now.`
 }
 
+// ASK ONCE, THEN ONLY WHAT IS NEW (Theron, 2026-10-14). This block rode on EVERY tool reply, unchanged,
+// and an offer that can be ignored on every call is ignored on every call — measured that day: 869
+// pending, 0 claimed, while the block was printed to every session. Now a unit is shown to this process
+// (one MCP server = one session) the first time only, framed as a decision owed before other work.
+// Units every session passes on are escalated to the PERSON at the next session start
+// (web/lib/engine/orphan_escalation.ts), so a unit dropped here is never lost — it changes audience.
+const settlingShown = new Set()
+
 function renderSettling(payload) {
   const feed = payload?.settling
-  const offers = Array.isArray(feed?.offers) ? feed.offers : []
+  const firstSight = settlingShown.size === 0
+  const offers = filterUnshownSettling(Array.isArray(feed?.offers) ? feed.offers : [], settlingShown)
   if (!offers.length) return ''
   const total = Number(feed?.total ?? offers.length)
 
@@ -483,7 +493,10 @@ function renderSettling(payload) {
     ? `\n— ⚠ ${maxHolders} live sessions of yours hold a matching identifier, so these are offered to all of them. \`intake_claim\` takes a lease — claim before you work, not after, or two sessions judge the same arrival.`
     : ''
 
-  return `\n\n⚡ ARRIVALS SETTLING — yours alone, and no one else can see these yet:\n${lines.join('\n')}\n` +
+  const head = firstSight
+    ? `\n\n⚡ ARRIVALS SETTLING — DECIDE EACH LINE BEFORE CONTINUING: \`intake_claim\` it if it belongs to this session's work, otherwise \`not_mine\`. You are asked once; when every session has passed, the person is told at the next session start.\n`
+    : `\n\n⚡ NEW ARRIVALS SETTLING — decide each: \`intake_claim\` or \`not_mine\`:\n`
+  return `${head}${lines.join('\n')}\n` +
     `— These are unjudged ARRIVALS, not records. Since automatic materialization was deleted, nothing files them for you.\n` +
     `— \`intake_look <id>\` reads the full body without claiming it — looking is free, non-exclusive and logged, so look rather than guess from the headline.\n` +
     `— Then \`intake_claim {intakeItemIds: ["<id>"]}\` to take a lease on THAT unit (the array is required; without an id you claim the head of the queue instead), then \`intake_materialize\` into the brain and pages it belongs to — or \`intake_discard\`, or \`intake_defer\` with a question when only the owner can decide.\n` +

package/lib/settling_shown.mjs

@@ -0,0 +1,9 @@
+// Ask-once filter for the ⚡ ARRIVALS SETTLING block (2026-10-14). Pure, so it is testable without
+// importing server.mjs. An offer is fresh if ANY id it stands for has not been shown to this session;
+// a text conversation counts as one offer carrying many ids, so one new text re-raises its chat.
+export function filterUnshownSettling(offers, shown) {
+  const idsOf = (x) => (x.conversation?.ids?.length ? x.conversation.ids : [x.intakeItemId])
+  const fresh = offers.filter((x) => idsOf(x).some((id) => !shown.has(id)))
+  for (const x of fresh) for (const id of idsOf(x)) shown.add(id)
+  return fresh
+}

package/package.json

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