@theronap/cortex-mcp 0.9.3 → 0.9.5

package/README.md

@@ -19,8 +19,9 @@ Connect your AI assistant to **Cortex** — your org's projects, recent activity
 }
 ```
 
-3. Restart Claude Code. Your AI now sees your org context automatically, and the managed startup skill
-   will prefer query-centered `session_context` on substantive session opens.
+3. Restart Claude Code. Your AI now sees your org context automatically, the managed startup skill
+   will prefer query-centered `session_context` on substantive session opens, and each session start
+   will log the exact baseline Cortex context to `~/.cortex/context-snapshots/`.
 
 No clone, no path, no build step — `npx` fetches and runs it.
 
@@ -31,6 +32,13 @@ No clone, no path, no build step — `npx` fetches and runs it.
 - **search_org** — search your visible activity and projects by keyword.
 - **project_status** — status of a specific project by key.
 
+## Startup snapshots
+
+Every Claude session start runs `snapshot-context`, which fetches the exact `my_context` payload and writes:
+- `~/.cortex/context-snapshots/latest.md`
+- `~/.cortex/context-snapshots/<timestamp>.md`
+- `~/.cortex/context-snapshots/index.jsonl`
+
 ## Environment
 
 | Var | Required | Default |

package/bin/cortex-mcp.mjs

@@ -7,6 +7,7 @@
  *   setup <TOKEN>     wire BOTH the MCP server + capture hook into your Claude config
  *   doctor            live health check — is the token actually working? (no restart needed)
  *   capture           the Stop-hook capturer (invoked by Claude Code, not by hand)
+ *   snapshot-context  save the exact startup context served by Cortex to a local log file
  *   --version | -v
  *   --help | -h
  *
@@ -16,7 +17,7 @@
  * Get your token from the Cortex console → Connect your AI.
  */
 
-const VERSION = '0.9.3'
+const VERSION = '0.9.5'
 const cmd = process.argv[2]
 const rest = process.argv.slice(3)
 
@@ -34,9 +35,11 @@ if (cmd === '--help' || cmd === '-h' || cmd === 'help') {
     `sessions flow into the org automatically. Restart Claude Code after.\n\n` +
     `Subcommands:\n` +
     `  setup <token>   wire MCP server + capture hook into ~/.claude config\n` +
+    `  repair          re-run setup at the latest version using your existing token (no token needed)\n` +
     `  doctor          live health check — confirm your token works (no restart needed)\n` +
     `  status          one-line connected/not-connected check (used by the SessionStart hook)\n` +
     `  skills          install/repair the managed Cortex skills (also wired by setup)\n` +
+    `  snapshot-context save the exact startup context Cortex served to a local snapshot\n` +
     `  capture         Stop-hook capturer (invoked by Claude Code)\n` +
     `  (no args)       run the MCP server (used by your Claude config)\n\n` +
     `Get your token from the Cortex console → Connect your AI.\n`,
@@ -56,6 +59,13 @@ if (cmd === 'setup') {
   await runSetup(rest, VERSION)
   const { closeFetch } = await import('../lib/diagnose.mjs')
   await closeFetch()
+} else if (cmd === 'repair' || cmd === 'update') {
+  // Re-run setup at THIS version using the already-wired token (no token arg needed). Fixes a
+  // machine set up with an older version: re-pins MCP + hooks, reinstalls skills to the flat path.
+  const { runRepair } = await import('../lib/setup.mjs')
+  await runRepair(VERSION)
+  const { closeFetch } = await import('../lib/diagnose.mjs')
+  await closeFetch()
 } else if (cmd === 'doctor') {
   const { runDoctor } = await import('../lib/doctor.mjs')
   process.exitCode = await runDoctor()
@@ -72,6 +82,11 @@ if (cmd === 'setup') {
   await runCapture()
   const { closeFetch } = await import('../lib/diagnose.mjs')
   await closeFetch()
+} else if (cmd === 'snapshot-context') {
+  const { runSnapshotContext } = await import('../lib/context_log.mjs')
+  process.exitCode = await runSnapshotContext()
+  const { closeFetch } = await import('../lib/diagnose.mjs')
+  await closeFetch()
 } else if (cmd === 'skills') {
   // Install / repair the managed Cortex skills repository. No network — exits naturally.
   const { runSkills } = await import('../lib/skills.mjs')

package/lib/context_log.mjs

@@ -0,0 +1,80 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs'
+import { homedir } from 'os'
+import { join } from 'path'
+import { fetchCortex, classify, resolveBase } from './diagnose.mjs'
+
+function resolveToken() {
+  if (process.env.CORTEX_TOKEN) return process.env.CORTEX_TOKEN
+  const claudeJson = join(homedir(), '.claude.json')
+  if (!existsSync(claudeJson)) return null
+  try {
+    const cfg = JSON.parse(readFileSync(claudeJson, 'utf8'))
+    return cfg?.mcpServers?.cortex?.env?.CORTEX_TOKEN ?? null
+  } catch {
+    return null
+  }
+}
+
+function ensureDir(path) {
+  if (!existsSync(path)) mkdirSync(path, { recursive: true })
+}
+
+function stamp(now = new Date()) {
+  const pad = (n) => String(n).padStart(2, '0')
+  return `${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())}T${pad(now.getHours())}-${pad(now.getMinutes())}-${pad(now.getSeconds())}`
+}
+
+function snapshotDir() {
+  return join(homedir(), '.cortex', 'context-snapshots')
+}
+
+export async function runSnapshotContext() {
+  const out = (m) => process.stdout.write(m + '\n')
+  const token = resolveToken()
+  if (!token) {
+    out('Cortex: context snapshot skipped — no token found.')
+    return 0
+  }
+
+  const base = resolveBase(process.env.CORTEX_URL)
+  let res
+  try {
+    res = await fetchCortex(`${base}/api/mcp-context`, { headers: { Authorization: `Bearer ${token}` } })
+  } catch (e) {
+    out(`Cortex: context snapshot failed — ${e?.message ?? String(e)}`)
+    return 0
+  }
+
+  if (!res.ok) {
+    const body = await res.text()
+    out(`Cortex: context snapshot failed — ${classify(res.status, res.headers.get('content-type'), body, res.headers.get('x-vercel-id')).message}`)
+    return 0
+  }
+
+  const payload = await res.json().catch(() => ({}))
+  const context = typeof payload?.context === 'string' ? payload.context : ''
+  const dir = snapshotDir()
+  ensureDir(dir)
+
+  const capturedAt = new Date().toISOString()
+  const file = join(dir, `${stamp()}.md`)
+  const header = [
+    '# Cortex startup context snapshot',
+    `- Captured: ${capturedAt}`,
+    `- Source: ${base}/api/mcp-context`,
+    '',
+  ].join('\n')
+  const text = `${header}${context}\n`
+
+  writeFileSync(file, text)
+  writeFileSync(join(dir, 'latest.md'), text)
+  writeFileSync(join(dir, 'index.jsonl'), JSON.stringify({
+    captured_at: capturedAt,
+    file,
+    base,
+    chars: context.length,
+  }) + '\n', { flag: 'a' })
+
+  out(`Cortex: logged startup context → ${file}`)
+  return 0
+}

package/lib/setup.mjs

@@ -170,6 +170,14 @@ export async function runSetup(argv, version) {
     }
     sgrp.hooks.push({ type: 'command', command: skillsCmd })
 
+    const snapshotCmd = `npx -y ${spec} snapshot-context`
+    for (const sg of s.hooks.SessionStart) {
+      if (Array.isArray(sg.hooks)) {
+        sg.hooks = sg.hooks.filter((h) => !/cortex-mcp(@[^ ]*)? snapshot-context/.test(h.command ?? ''))
+      }
+    }
+    sgrp.hooks.push({ type: 'command', command: snapshotCmd })
+
     ensureDir(settingsJson)
     writeFileSync(settingsJson, JSON.stringify(s, null, 2))
     log(`  ✓ Capture hook + status line → ${settingsJson}${bak ? ' (backup saved)' : ''}`)
@@ -207,3 +215,35 @@ export async function runSetup(argv, version) {
   log(`   Console: ${base}`)
   log('')
 }
+
+// Find the token already wired on this machine, so `repair` can re-run setup without re-pasting it.
+// Checks Claude's config first, then Codex's config.toml.
+export function readWiredToken() {
+  try {
+    const cfg = readJson(join(homedir(), '.claude.json'))
+    const t = cfg?.mcpServers?.cortex?.env?.CORTEX_TOKEN
+    if (t) return t
+  } catch { /* fall through */ }
+  try {
+    const toml = readFileSync(join(homedir(), '.codex', 'config.toml'), 'utf8')
+    const m = toml.match(/\[mcp_servers\.cortex\.env\][\s\S]*?CORTEX_TOKEN\s*=\s*"([^"]+)"/)
+    if (m) return m[1]
+  } catch { /* fall through */ }
+  return null
+}
+
+// `repair`: re-run the FULL setup at THIS version using the already-wired token. The one-command fix
+// for a machine set up with an older version (e.g. when skills were installed to the old nested path,
+// or the hooks are pinned to a stale version). No token argument needed.
+export async function runRepair(version) {
+  const token = readWiredToken()
+  if (!token) {
+    process.stderr.write(
+      'No existing Cortex token found in ~/.claude.json or ~/.codex/config.toml.\n' +
+      'Run setup once with your token:  npx -y @theronap/cortex-mcp setup <YOUR_TOKEN>\n',
+    )
+    process.exit(1)
+  }
+  process.stdout.write('Cortex repair — re-running setup with your existing token at this version…\n')
+  await runSetup([token], version)
+}

package/package.json

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