@theronap/cortex-mcp 0.9.20 → 0.9.22

package/lib/server.mjs

@@ -213,13 +213,32 @@ export async function runServer(version) {
     'project_status',
     {
       title: 'Project status',
-      description: 'Status of a specific project by key (e.g. checkout-v2). Returns only what you can see.',
+      description: 'Status of a specific project by key (e.g. checkout-v2). Returns the AUTHORED wiki page (the synthesized understanding) when one exists, falling back to the records-derived line. Returns only what you can see.',
       inputSchema: { key: z.string().describe('project key, e.g. checkout-v2') },
     },
     async ({ key }) => {
+      // Prefer the AUTHORED page (synthesized understanding, sovereign over records). Freshest tier leads,
+      // each dated, so diverged tiers read as "newest first" instead of an undated stale/fresh blend.
+      try {
+        const res = await fetchCortex(`${BASE}/api/brain/page?kind=project&key=${encodeURIComponent(key)}`,
+          { headers: { Authorization: `Bearer ${TOKEN}` } })
+        if (res.ok) {
+          const page = await res.json()
+          if (page?.authored && Array.isArray(page.tiers) && page.tiers.length) {
+            const day = (d) => (d ? String(d).slice(0, 10) : '')
+            const blocks = page.tiers.map((t) => {
+              const secs = (t.sections ?? []).map((s) => `### ${s.heading}\n${s.body}`).join('\n\n')
+              const head = `[${t.tier}${day(t.updated_at) ? ` · authored ${day(t.updated_at)}` : ''}${t.validity && t.validity !== 'current' ? ` · ${t.validity}` : ''}]`
+              return [head, t.summary, secs].filter(Boolean).join('\n')
+            })
+            return { content: [{ type: 'text', text: `# ${page.title ?? key} (authored page)\n\n${blocks.join('\n\n---\n\n')}` }] }
+          }
+        }
+      } catch { /* fall through to the records-derived line */ }
+      // Fallback: no authored page yet — surface the records-derived line from the context snapshot.
       const text = await fetchContext()
       const line = text.split('\n').find((l) => l.includes(`**${key}**`) || l.includes(key))
-      return { content: [{ type: 'text', text: line ? `Project ${key}:\n${line.trim()}` : `No visible project "${key}".` }] }
+      return { content: [{ type: 'text', text: line ? `Project ${key} (records-derived; not yet authored):\n${line.trim()}` : `No visible project "${key}".` }] }
     },
   )
 
@@ -464,6 +483,39 @@ export async function runServer(version) {
     },
   )
 
+  server.registerTool(
+    'set_page_validity',
+    {
+      title: 'Mark a wiki page current / superseded / historical',
+      description: 'Set the CURRENCY of one of YOUR OWN authored pages so the brain can filter out stale info: "current" (reflects reality now — the default), "superseded" (replaced by a newer page — pass superseded_by with that page\'s name), or "historical" (kept for the record, no longer current). Optionally set modality: "reality" (as-built), "plan" (intended, not yet real), or "construction" (being built now). Call this the moment your understanding changes that a page is no longer the live truth — e.g. right after you author the new reality, mark the old page superseded. Owner-only.',
+      inputSchema: {
+        kind: z.enum(['project', 'person', 'org', 'user']).describe('the page kind'),
+        name: z.string().describe('the exact page name'),
+        validity: z.enum(['current', 'superseded', 'historical']).describe('the currency state'),
+        modality: z.enum(['reality', 'plan', 'construction']).optional().describe('what the page describes (optional)'),
+        superseded_by: z.string().optional().describe('for superseded: the name of the page that replaced it'),
+      },
+    },
+    async ({ kind, name, validity, modality, superseded_by }) => {
+      let res
+      try {
+        res = await fetchCortex(`${BASE}/api/brain/validity`, {
+          method: 'POST',
+          headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' },
+          body: JSON.stringify({ kind, name, validity, modality, superseded_by }),
+        })
+      } catch (e) {
+        return { content: [{ type: 'text', text: `Could not set validity: ${e.message}` }] }
+      }
+      if (!res.ok) {
+        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 set validity: ${d.message}` }] }
+      }
+      const out = await res.json()
+      return { content: [{ type: 'text', text: `Done — "${out.name}" is now ${out.validity}${out.modality ? ` / ${out.modality}` : ''} (${out.docs_updated} tier-doc(s) updated).` }] }
+    },
+  )
+
   // ── File requests: ask the owner for a record's FULL original (lives on their machine) ──
   const fail = (verb, res) => async () =>
     ({ content: [{ type: 'text', text: `Could not ${verb}: ${classify(res.status, res.headers.get('content-type'), await res.text(), res.headers.get('x-vercel-id')).message}` }] })

package/package.json

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