@theronap/cortex-mcp 0.4.3 → 0.4.5

package/bin/cortex-mcp.mjs

@@ -16,7 +16,7 @@
  * Get your token from the Cortex console → Connect your AI.
  */
 
-const VERSION = '0.4.3'
+const VERSION = '0.4.5'
 const cmd = process.argv[2]
 const rest = process.argv.slice(3)
 
@@ -35,6 +35,7 @@ if (cmd === '--help' || cmd === '-h' || cmd === 'help') {
     `Subcommands:\n` +
     `  setup <token>   wire MCP server + capture hook into ~/.claude config\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` +
     `  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`,
@@ -59,6 +60,12 @@ if (cmd === 'setup') {
   process.exitCode = await runDoctor()
   const { closeFetch } = await import('../lib/diagnose.mjs')
   await closeFetch()
+} else if (cmd === 'status') {
+  // One-line SessionStart health signal (wired by setup). Always exit 0.
+  const { runStatus } = await import('../lib/doctor.mjs')
+  await runStatus()
+  const { closeFetch } = await import('../lib/diagnose.mjs')
+  await closeFetch()
 } else if (cmd === 'capture') {
   const { runCapture } = await import('../lib/capture.mjs')
   await runCapture()

package/lib/capture.mjs

@@ -1,6 +1,21 @@
 import { readFileSync } from 'fs'
+import { homedir } from 'os'
+import { resolve } from 'path'
 import { fetchCortex, classify, resolveBase } from './diagnose.mjs'
 
+// Project name from the hook cwd — cross-platform. Windows hooks send backslash paths,
+// and splitting on '/' alone turned the WHOLE path into one garbage project slug
+// ("c-users-webst-onedrive-…", three-machine dry-run finding 2026-06-09). A session run
+// from the home directory itself is 'general', not a project named after the user.
+export function projectFrom(cwd) {
+  if (!cwd) return 'general'
+  try {
+    if (resolve(String(cwd)) === homedir()) return 'general'
+  } catch { /* unresolvable path — fall through to basename */ }
+  const base = String(cwd).split(/[\\/]+/).filter((s) => s && !/^[A-Za-z]:$/.test(s)).pop()
+  return base ?? 'general'
+}
+
 // Claude Code Stop hook → POSTs a session digest to Cortex cloud, which
 // summarizes server-side and upserts ONE record per session. Node-native
 // (no bun, no repo clone). Always exits 0 — capture must never break a session.
@@ -36,7 +51,7 @@ export async function runCapture() {
 
   let hook = {}
   try { hook = JSON.parse(readStdin()) } catch { /* no/invalid stdin */ }
-  const repo = hook.cwd?.split('/').filter(Boolean).pop() ?? 'general'
+  const repo = projectFrom(hook.cwd)
   const transcript = hook.transcript_path ? transcriptTail(hook.transcript_path) : ''
 
   if (!transcript && !hook.session_id) { process.stderr.write('cortex: empty session, skipping\n'); return }

package/lib/doctor.mjs

@@ -24,6 +24,32 @@ function resolveToken() {
   return { token: null, source: null }
 }
 
+// `status` — the one-line SessionStart variant of doctor: a visible "is Cortex capturing?"
+// signal inside Claude Code itself (three-machine dry-run finding 2026-06-09: with no
+// indicator, a user can't tell whether their sessions are flowing to the org).
+// Always returns 0 — a status line must never break a session start.
+export async function runStatus() {
+  const base = resolveBase(process.env.CORTEX_URL)
+  const out = (m) => process.stdout.write(m + '\n')
+  const { token } = resolveToken()
+  if (!token) {
+    out('Cortex: NOT connected — no token found. Run: npx -y @theronap/cortex-mcp setup <token>')
+    return 0
+  }
+  try {
+    const r = await checkToken(token, base)
+    if (r.ok) {
+      const n = typeof r.projectCount === 'number' ? ` · ${r.projectCount} project${r.projectCount === 1 ? '' : 's'} visible` : ''
+      out(`Cortex: connected — sessions on this machine are captured to your org${n}.`)
+    } else {
+      out(`Cortex: NOT connected — ${r.diagnosis?.message ?? 'check failed'}. Run: npx -y @theronap/cortex-mcp doctor`)
+    }
+  } catch (e) {
+    out(`Cortex: status check failed (${e?.message ?? String(e)}) — run doctor.`)
+  }
+  return 0
+}
+
 export async function runDoctor() {
   const base = resolveBase(process.env.CORTEX_URL)
   const out = (m) => process.stdout.write(m + '\n')

package/lib/setup.mjs

@@ -100,9 +100,24 @@ export async function runSetup(argv, version) {
     grp.hooks = grp.hooks ?? []
     grp.hooks.push({ type: 'command', command: captureCmd })
 
+    // Connected-status SessionStart hook: one line inside Claude Code itself saying whether
+    // this machine's sessions are flowing to the org (dry-run finding: silence is unreadable).
+    // `status` reads the token from ~/.claude.json, so the command carries no secret.
+    s.hooks.SessionStart = Array.isArray(s.hooks.SessionStart) ? s.hooks.SessionStart : []
+    const statusCmd = `npx -y ${spec} status`
+    for (const sg of s.hooks.SessionStart) {
+      if (Array.isArray(sg.hooks)) {
+        sg.hooks = sg.hooks.filter((h) => !/cortex-mcp(@[^ ]*)? status/.test(h.command ?? ''))
+      }
+    }
+    let sgrp = s.hooks.SessionStart.find((g) => (g.matcher ?? '') === '')
+    if (!sgrp) { sgrp = { matcher: '', hooks: [] }; s.hooks.SessionStart.push(sgrp) }
+    sgrp.hooks = sgrp.hooks ?? []
+    sgrp.hooks.push({ type: 'command', command: statusCmd })
+
     ensureDir(settingsJson)
     writeFileSync(settingsJson, JSON.stringify(s, null, 2))
-    log(`  ✓ Capture hook → ${settingsJson}${bak ? ' (backup saved)' : ''}`)
+    log(`  ✓ Capture hook + status line → ${settingsJson}${bak ? ' (backup saved)' : ''}`)
   } catch (e) {
     process.stderr.write(`  ✗ failed to update ${settingsJson}: ${e.message}\n`)
     process.exit(1)

package/package.json

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