@theronap/agnoclast-mcp 0.9.256 → 0.9.257

package/lib/folder_decisions.mjs

@@ -29,13 +29,16 @@ export function renderFolderQuestions(body) {
   if (open.length) {
     lines.push('', `Open (${open.length}):`)
     for (const x of open) {
-      const what = x.kind === 'file' ? `file in grab-bag \`${x.grabBag ?? '?'}\`` : `folder (${x.files?.length ?? 0} changed file${x.files?.length === 1 ? '' : 's'})`
+      const what = `folder (${x.files?.length ?? 0} changed file${x.files?.length === 1 ? '' : 's'})`
       lines.push(`- \`${x.identifier}\` — ${what}`)
       if (Array.isArray(x.answerWith) && x.answerWith.length > 1) {
         lines.push(`    may also be answered at: ${x.answerWith.slice(1).map((a) => `\`${a}\``).join(', ')}`)
       }
       if (x.earlier) {
-        lines.push(`    asked before: declined ${x.earlier.kind} on \`${x.earlier.identifier}\`${x.earlier.decidedBy ? ` by ${x.earlier.decidedBy}` : ''} ${String(x.earlier.decidedAt).slice(0, 10)} — "${x.earlier.reason ?? ''}". That decision has lapsed.`)
+        const why = x.earlier.kind === 'not_yet'
+          ? '"not yet" is no longer an answer for a GitHub folder — choose its page, or never.'
+          : 'That decision has lapsed.'
+        lines.push(`    asked before: declined ${x.earlier.kind} on \`${x.earlier.identifier}\`${x.earlier.decidedBy ? ` by ${x.earlier.decidedBy}` : ''} ${String(x.earlier.decidedAt).slice(0, 10)} — "${x.earlier.reason ?? ''}". ${why}`)
       }
     }
   }
@@ -44,11 +47,10 @@ export function renderFolderQuestions(body) {
     for (const p of pages) lines.push(`- ${q(p.title)} (${p.tier}) — ref ${p.ref}${p.tier !== 'accessible' ? ' — needs confirmTier: true' : ''}`)
   }
   if (open.length) {
-    const example = open.slice(0, 3).map((x) => (pages[0]
-      ? { identifier: x.identifier, claim: pages[0].ref }
-      : { identifier: x.identifier, decline: 'not_yet', reason: 'why it belongs to no page' }))
+    // Never a `never` in the example: it is permanent, so it must be typed on purpose, not copied.
+    const example = open.slice(0, 3).map((x) => ({ identifier: x.identifier, claim: pages[0]?.ref ?? '<ref of the page about this folder>' }))
     lines.push('', `Answer shape: folderDecisions: ${JSON.stringify(example)}`)
-    lines.push('No page fits? Author a small area page about the folder (`author`), then claim onto its ref. Generated/vendored/lockfiles/fixtures: decline "never".')
+    lines.push('No page fits? Author a small area page about the folder (`author`), then claim onto its ref. Belongs to no page (generated/vendored/lockfiles/fixtures)? {identifier, decline: "never", reason} — permanent until someone claims it. There is no "not yet".')
     if (body?.cold) lines.push('You are a cold judge here: {identifier, defer: true} hands a question to the next session that touches it.')
   }
   return lines.join('\n')
@@ -73,7 +75,10 @@ export function renderDeclines(declines, { heading = 'Declines' } = {}) {
   if (!list.length) return []
   const lines = [`${heading} (${list.length}) — a decline covers the identifier and everything under it:`]
   for (const d of list) {
-    const state = d.active ? (d.kind === 'never' ? 'never' : d.kind === 'not_yet' ? 'not yet' : 'snoozed') : `${d.kind}, lapsed — will be asked again`
+    const retiredPath = d.kind === 'not_yet' && String(d.identifier).startsWith('file:')
+    const state = retiredPath
+      ? 'not yet — retired for GitHub paths, asked again at the next commit there'
+      : d.active ? (d.kind === 'never' ? 'never' : d.kind === 'not_yet' ? 'not yet' : 'snoozed') : `${d.kind}, lapsed — will be asked again`
     lines.push(`  ${d.active ? '⊘' : '·'} \`${d.identifier}\`${d.brain ? ` · ${d.brain}` : ''} — ${state}${d.reason ? ` — "${d.reason}"` : ''}${d.decidedBy ? ` · ${d.decidedBy}` : ''}${d.cold ? ' (cold judge)' : ''} · ${String(d.decidedAt).slice(0, 10)}`)
   }
   return lines

package/lib/server.mjs

@@ -1309,7 +1309,7 @@ function renderNudge(payload) {
         'Pass mode "preview" first when your choice differs from the claim\'s proposal: it returns the pages, the governing page and the tier this exact call would produce, and writes nothing. Never writes private intake into search/history before this call. ' +
         '⚠ ADR-0051 — BEFORE you file, look for this unit\'s OTHER homes: the pages it is about beyond what an identifier matched (the design it implements, the project, the person, the decision it bears on). grep or read for them, then name them in documentIds. A call that names nothing beyond the deterministic homes still FILES, on those homes only, and says so — add pages later with route_record. ' +
         '⚠ A meeting or lecture TRANSCRIPT files with NOTES in `summary` (Theron, 2026-10-08): the gist, decisions, action items and dates, names spelled right. Without them the call is REFUSED; the transcript itself is kept on the record unchanged. ' +
-        '⚠ ADR-0077: a GitHub commit or PR does not finish until every changed path has an answer. If a changed file\'s deepest folder (or, in a grab-bag folder like web/lib/engine/ or db/supabase/, the file itself) has no claim and no decline, the call is REFUSED with the open questions; answer each in folderDecisions and call again.',
+        '⚠ ADR-0077: a GitHub commit or PR does not finish until every changed AREA FOLDER has an answer. If a changed file\'s deepest folder has no claim and no decline, the call is REFUSED with the open questions; answer each in folderDecisions (a page to claim it onto, or decline "never") and call again. Questions are about folders, never single files: a file directly in a grab-bag folder (e.g. db/supabase/) is never asked about — it files onto its nearest claimed ancestor\'s page, or the repo\'s page.',
       inputSchema: {
         intakeItemId: z.string().optional().describe('intake item uuid (required — intake_item_id is accepted too)'),
         intake_item_id: z.string().optional().describe(INTAKE_ID_ALIAS_NOTE),
@@ -1347,12 +1347,12 @@ function renderNudge(payload) {
         folderDecisions: z.array(z.object({
           identifier: z.string().describe('the open question\'s identifier, or a folder above it that its answerWith lists'),
           claim: z.string().optional().describe('page `ref:` (or document id) of a project page ABOUT this path — never the repo\'s mother page, a person or a user page'),
-          decline: z.enum(['never', 'not_yet']).optional().describe('never = generated/build output, lockfiles, fixtures, vendored code; not_yet = asked again after 10 more commits or 90 days'),
+          decline: z.enum(['never']).optional().describe('never = belongs to no page (generated/build output, lockfiles, fixtures, vendored code). Permanent until someone claims the folder onto a page. There is no "not yet" for a GitHub folder: pick the page it is about, or never'),
           reason: z.string().optional().describe('required with decline: why it belongs to no page — the next session asked will read it'),
           defer: z.boolean().optional().describe('cold judges only (a cleanup lease): hand the question to the next session that touches it'),
           confirmTier: z.boolean().optional().describe('required to claim onto a page narrower than accessible — its tier will govern every future commit there'),
         })).optional().describe(
-          'ADR-0077: one answer per open folder question from a refused call — exactly one of claim, decline or defer each. ' +
+          'ADR-0077: one answer per open folder question from a refused call — exactly one of claim, decline ("never") or defer (cold judges only) each. ' +
           'Send only after the server has listed the questions; claims and declines are written when the unit is filed.',
         ),
         obligations: z.array(z.object({
@@ -2714,7 +2714,7 @@ function renderNudge(payload) {
         brain: z.string().optional().describe('which brain to stop surfacing it in. Required when you belong to more than one — the call refuses rather than picking.'),
         days: z.number().optional().describe('how long to stay quiet (1-365, default 90).'),
         reason: z.string().optional().describe('why it belongs nowhere, in one phrase — the next person to see it resurface will want this. REQUIRED with kind.'),
-        kind: z.enum(['never', 'not_yet']).optional().describe('ADR-0077: record a DECLINE instead of silencing the notice. never = generated/build output, lockfiles, fixtures, vendored code (a cold judge — a session holding cleanup leases — may not write it); not_yet = asked again after 10 more commits touch it or 90 days. A decline covers the identifier and everything under it, and claiming the identifier clears it.'),
+        kind: z.enum(['never', 'not_yet']).optional().describe('ADR-0077: record a DECLINE instead of silencing the notice. never = generated/build output, lockfiles, fixtures, vendored code (a cold judge — a session holding cleanup leases — may not write it); not_yet = asked again after 10 more commits touch it or 90 days — NOT for a GitHub path (file:…), which takes a page or never (2026-10-22). A decline covers the identifier and everything under it, and claiming the identifier clears it.'),
         remove: z.boolean().optional().describe('ADR-0077: UN-decline — delete the decline (or snooze) on this identifier, so the next commit that touches it is asked again.'),
       },
     },

package/package.json

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