@theronap/cortex-mcp 0.9.54 → 0.9.55

package/lib/server.mjs

@@ -499,7 +499,15 @@ export async function runServer(version) {
       const day = (d) => (d ? String(d).slice(0, 10) : '')
       const renderMatch = (m, tagBrain) => {
         const blocks = m.tiers.map((t) => {
-          const secs = (t.sections ?? []).map((s) => `### ${s.heading}\n${s.body}`).join('\n\n')
+          const secs = (t.sections ?? []).map((s) => {
+            // Undefined is an older-server response during a rolling deploy: do
+            // not invent a currency verdict until this server has computed one.
+            const currency = s.hasExplicitDate === false
+              ? '\n⚠ **Undated section — verify before relying on its claims.**\n'
+              : ''
+            const asOf = s.asOf ? ` · as of ${day(s.asOf)}` : ''
+            return `### ${s.heading}${asOf}${currency}${s.body}`
+          }).join('\n\n')
           // ADR-0018: a null version isn't "nothing to show" — it means this variant predates content-
           // hash tracking (a 2026-06-29 import scar) and CANNOT be re-authored via base_version until an
           // admin backfills it. Silently omitting the line here is exactly what sent callers into an
@@ -1375,7 +1383,7 @@ export async function runServer(version) {
     {
       title: 'Authoring context (call before author)',
       description:
-        'Fetch the scaffolding to author a Cortex wiki node: the canonical NAMESPACE (existing node names — link to these with the EXACT name inside [[ ]]) and the node-type CONNECTION RULES (what kinds of links to look for). ALWAYS call this BEFORE `author` so the page links to real nodes by their established names instead of minting synonyms. Reference a node in the namespace as [[Name]]; if you reference something real that is NOT in the namespace, still write [[Name]] — that is a red-link marking a node worth creating. If the page IS about a specific code repo or chat channel, also stamp it once — [[repo:owner/name]] or [[channel:name]] (lowercase, no #) — identifier join keys, not page links.',
+        'Fetch the scaffolding to author a Cortex wiki node: the canonical NAMESPACE (current node names — link to these with the EXACT name inside [[ ]]), any deliberately RETIRED page names and their successors, and the node-type CONNECTION RULES. ALWAYS call this BEFORE `author` so the page links to current knowledge rather than minting synonyms or reviving a retired page. Reference a node in the namespace as [[Name]]; if you reference something real that is NOT in the namespace, still write [[Name]] — that is a red-link marking a node worth creating. If the page IS about a specific code repo or chat channel, also stamp it once — [[repo:owner/name]] or [[channel:name]] (lowercase, no #) — identifier join keys, not page links.',
       inputSchema: {
         kind: z.enum(['project', 'person', 'org', 'user']).optional().describe('the node type you are about to author (default project)'),
       },
@@ -1392,12 +1400,17 @@ export async function runServer(version) {
         const d = classify(res.status, res.headers.get('content-type'), await res.text(), res.headers.get('x-vercel-id'))
         return { content: [{ type: 'text', text: `Could not fetch authoring context: ${d.message}` }] }
       }
-      const { connectionRules, namespace } = await res.json()
+      const { connectionRules, namespace, retiredLinks } = await res.json()
       const ns = Array.isArray(namespace) ? namespace : []
       const nsList = ns.map((n) => `[[${n}]]`).join(', ')
+      const retired = Array.isArray(retiredLinks) ? retiredLinks : []
+      const retiredList = retired.length
+        ? `\n\nRETIRED PAGES — do not treat these as current or author over them: ${retired.map((r) => `[[${r.name}]] (${r.validity}${r.supersededBy ? ` → [[${r.supersededBy}]]` : ''})`).join(', ')}`
+        : ''
       const text =
         `Authoring a "${k}" node. Connection rules (kinds of links to look for):\n${connectionRules}\n\n` +
         `NAMESPACE — ${ns.length} existing nodes; link with the EXACT name inside [[ ]]:\n${nsList}\n\n` +
+        retiredList +
         `Now author the page (summary + sections) with inline [[links]] woven into the prose. Link, do not restate. ` +
         `For something real that is not in this namespace, still write [[Name]] (a red-link). Then call \`author\`.`
       return { content: [{ type: 'text', text }] }
@@ -1444,11 +1457,13 @@ export async function runServer(version) {
       }
       const out = await res.json()
       const blue = out?.links?.blue ?? 0
+      const retired = out?.links?.retired ?? 0
       const red = out?.links?.red ?? 0
       const redList = Array.isArray(out?.redLinks) && out.redLinks.length ? `\nRed-links (wanted nodes): ${out.redLinks.map((r) => `[[${r}]]`).join(', ')}` : ''
+      const retiredList = Array.isArray(out?.retiredLinks) && out.retiredLinks.length ? `\nRetired links (not current or wanted): ${out.retiredLinks.map((r) => `[[${r}]]`).join(', ')}` : ''
       const stamps = Array.isArray(out?.identifiers) && out.identifiers.length ? `\nIdentifier stamps (join keys): ${out.identifiers.map((i) => `[[${i}]]`).join(', ')}` : ''
       const verb = out?.created ? 'Created + authored' : 'Authored'
-      const note = out?.built ? `${verb} "${name}" (${out.built} tier${out.built === 1 ? '' : 's'}). Links: ${blue} resolved, ${red} red.${redList}${stamps}`
+      const note = out?.built ? `${verb} "${name}" (${out.built} tier${out.built === 1 ? '' : 's'}). Links: ${blue} resolved, ${retired} retired, ${red} red.${retiredList}${redList}${stamps}`
         : `No change to "${name}"${out?.skipped?.length ? ` (${out.skipped.join(', ')})` : ''}.`
       return { content: [{ type: 'text', text: note }] }
     },

package/package.json

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