shakers-cli-beta 0.8.0-beta.5 → 0.9.0

package/src/mcp-auth-form.js

@@ -18,24 +18,26 @@ const FONT_STACK = '"Inter", ui-sans-serif, system-ui, -apple-system, BlinkMacSy
 
 const COPY = {
   en: {
-    signin: 'Sign in', create: 'Create account', welcome: 'Welcome to Shakers — create your talent account to get started.',
+    signin: 'Sign in', create: 'Create account', welcome: 'Welcome to Shakers. Create your talent account to get started.',
     email: 'Email', password: 'Password', repeat: 'Repeat password', first: 'First name', last: 'Last name',
     lang: 'Language', newsletter: 'Receive the newsletter', how: 'How do you work?', intent: 'Freelance intent',
-    hint: 'Your password stays on this machine. It is never sent to the chat.', mismatch: 'Passwords do not match.',
-    done: 'You are signed in.', doneSub: 'You can close this tab and return to your AI app.',
+    hint: 'Your password stays on this computer. We never send it to the chat.', mismatch: 'The passwords do not match.',
+    done: 'You are signed in.', doneSub: 'You can close this tab and go back to your AI app.',
     chooseTitleLogin: 'How do you want to sign in?', chooseTitleRegister: 'How do you want to create your account?',
-    continueGoogle: 'Continue with Google', continueEmail: 'Email and password', continueEmailRegister: 'Continue with email',
-    googleOpening: 'Opening Google sign-in…', googleOpeningSub: 'A Google window is opening. You can return to your AI app; it will confirm once you finish.',
+    continueGoogle: 'Continue with Google', continueLinkedin: 'Continue with LinkedIn', continueEmail: 'Email and password', continueEmailRegister: 'Continue with email',
+    socialOpening: (name) => `Opening sign-in with ${name}…`,
+    socialOpeningSub: 'A sign-in window just opened. Finish there and come back to your AI app, it will carry on.',
   },
   es: {
-    signin: 'Iniciar sesión', create: 'Crear cuenta', welcome: 'Bienvenido a Shakers — crea tu cuenta de talento para empezar.',
+    signin: 'Iniciar sesión', create: 'Crear cuenta', welcome: 'Bienvenido a Shakers. Crea tu cuenta de talento para empezar.',
     email: 'Email', password: 'Contraseña', repeat: 'Repite la contraseña', first: 'Nombre', last: 'Apellidos',
     lang: 'Idioma', newsletter: 'Recibir la newsletter', how: '¿Cómo trabajas?', intent: 'Intención freelance',
-    hint: 'Tu contraseña se queda en este equipo. Nunca se envía al chat.', mismatch: 'Las contraseñas no coinciden.',
+    hint: 'Tu contraseña se queda en este equipo. Nunca la enviamos al chat.', mismatch: 'Las contraseñas no coinciden.',
     done: 'Sesión iniciada.', doneSub: 'Puedes cerrar esta pestaña y volver a tu app de IA.',
     chooseTitleLogin: '¿Cómo quieres iniciar sesión?', chooseTitleRegister: '¿Cómo quieres crear tu cuenta?',
-    continueGoogle: 'Continuar con Google', continueEmail: 'Email y contraseña', continueEmailRegister: 'Continuar con email',
-    googleOpening: 'Abriendo el acceso con Google…', googleOpeningSub: 'Se está abriendo una ventana de Google. Puedes volver a tu app de IA; te confirmará cuando termines.',
+    continueGoogle: 'Continuar con Google', continueLinkedin: 'Continuar con LinkedIn', continueEmail: 'Email y contraseña', continueEmailRegister: 'Continuar con email',
+    socialOpening: (name) => `Abriendo el acceso con ${name}…`,
+    socialOpeningSub: 'Se acaba de abrir una ventana para terminar el acceso. Cuando acabes, vuelve a tu app de IA y seguirá por su cuenta.',
   },
 };
 
@@ -56,7 +58,7 @@ function styles() {
     + `:root{--background:#ffffff;--foreground:#18181b;--primary:#05342c;--primary-foreground:#fafafa;`
     + `--secondary:#e2f2f0;--secondary-foreground:#0b5a4c;--muted-foreground:#3f3f46;--accent:#e2f2f0;--accent-foreground:#08473c;`
     + `--input:#d4d4d8;--border:#e4e4e7;--ring:#0e7d69;--destructive:#e11d48;--radius:0.625rem;--radius-md:calc(var(--radius) - 2px);`
-    + `--shadow-xs:0 1px 2px 0 rgb(0 0 0 / .05)}`
+    + `--shadow-xs:0 1px 3px 0px rgb(0 0 0 / .05)}`
     + `*{box-sizing:border-box}`
     + `body{font-family:${FONT_STACK};margin:0;min-height:100vh;display:flex;align-items:center;justify-content:center;background:#fafafa;color:var(--foreground);padding:1.5rem;-webkit-font-smoothing:antialiased;text-rendering:optimizeLegibility}`
     + `.card{width:100%;max-width:26rem;background:var(--background);border:1px solid var(--border);border-radius:var(--radius);box-shadow:0 10px 30px rgb(3 33 28 / .08);overflow:hidden}`
@@ -104,7 +106,7 @@ function errorBanner(reason) {
 
 function loginFormHtml(lang, { error } = {}) {
   const c = copy(lang);
-  return page(`Shakers — ${c.signin}`, {
+  return page(`Shakers · ${c.signin}`, {
     inner: `<h1>${c.signin}</h1>${errorBanner(error)}`
       + `<form method="post" action="/submit">`
       + `<label>${c.email}</label><input name="email" type="email" required autofocus>`
@@ -117,7 +119,7 @@ function loginFormHtml(lang, { error } = {}) {
 
 function registerFormHtml(lang, { error } = {}) {
   const c = copy(lang);
-  return page(`Shakers — ${c.create}`, {
+  return page(`Shakers · ${c.create}`, {
     banner: panel(c.welcome),
     inner: `<h1>${c.create}</h1>${errorBanner(error)}`
       + `<form method="post" action="/submit">`
@@ -140,22 +142,28 @@ const GOOGLE_G = '<svg class="g" viewBox="0 0 48 48" aria-hidden="true">'
   + '<path fill="#FBBC05" d="M10.4 28.3c-.5-1.5-.8-3.1-.8-4.8s.3-3.3.8-4.8l-7.8-6.1C.9 15.9 0 19.8 0 23.5s.9 7.6 2.6 10.9l7.8-6.1z"/>'
   + '<path fill="#34A853" d="M24 47c6.5 0 11.9-2.1 15.9-5.8l-7.3-5.7c-2 1.4-4.7 2.3-8.6 2.3-6.4 0-11.8-3.8-13.6-9.8l-7.8 6.1C6.5 41.6 14.6 47 24 47z"/></svg>';
 
+const LINKEDIN_IN = '<svg class="g" viewBox="0 0 24 24" aria-hidden="true">'
+  + '<path fill="#0A66C2" d="M20.45 20.45h-3.56v-5.57c0-1.33-.03-3.04-1.85-3.04-1.86 0-2.14 1.45-2.14 2.94v5.67H9.35V9h3.41v1.56h.05c.47-.9 1.63-1.85 3.36-1.85 3.6 0 4.26 2.37 4.26 5.45v6.29zM5.34 7.43a2.06 2.06 0 1 1 0-4.13 2.06 2.06 0 0 1 0 4.13zM7.12 20.45H3.56V9h3.56v11.45zM22.22 0H1.77C.79 0 0 .77 0 1.73v20.54C0 23.22.79 24 1.77 24h20.45c.98 0 1.78-.78 1.78-1.73V1.73C24 .77 23.2 0 22.22 0z"/></svg>';
+
 // The method-choice screen (talents-ai-score) — the FIRST screen of the loopback form when more than one method is offered for this flow.
 function methodChoiceHtml(mode, lang, methods) {
   const c = copy(lang);
   const title = mode === 'register' ? c.chooseTitleRegister : c.chooseTitleLogin;
   const emailLabel = mode === 'register' ? c.continueEmailRegister : c.continueEmail;
-  const buttons = methods.map((id) => (id === 'google'
-    ? `<a class="mbtn primary" href="/google">${GOOGLE_G}${c.continueGoogle}</a>`
-    : `<a class="mbtn secondary" href="/email">${emailLabel}</a>`)).join('');
-  return page(`Shakers — ${title}`, {
+  const buttons = methods.map((id) => {
+    if (id === 'google') return `<a class="mbtn primary" href="/google">${GOOGLE_G}${c.continueGoogle}</a>`;
+    if (id === 'linkedin') return `<a class="mbtn secondary" href="/linkedin">${LINKEDIN_IN}${c.continueLinkedin}</a>`;
+    return `<a class="mbtn secondary" href="/email">${emailLabel}</a>`;
+  }).join('');
+  return page(`Shakers · ${title}`, {
     inner: `<h1>${title}</h1><div class="actions">${buttons}</div><p class="hint">${c.hint}</p>`,
   });
 }
 
-function googleHandoffHtml(lang) {
+function socialHandoffHtml(lang, provider) {
   const c = copy(lang);
-  return page('Shakers', { inner: `<h1>${c.googleOpening}</h1><p>${c.googleOpeningSub}</p>` });
+  const name = provider === 'linkedin' ? 'LinkedIn' : 'Google';
+  return page('Shakers', { inner: `<h1>${c.socialOpening(name)}</h1><p>${c.socialOpeningSub}</p>` });
 }
 
 function successHtml(lang) {
@@ -247,8 +255,14 @@ function runLoopbackAuth(
       }
       if (req.method === 'GET' && url.pathname === '/google' && methods.includes('google')) {
         res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
-        res.end(googleHandoffHtml(lang));
-        finish({ ok: true, viaGoogle: true });
+        res.end(socialHandoffHtml(lang, 'google'));
+        finish({ ok: true, viaSocial: true, provider: 'google' });
+        return;
+      }
+      if (req.method === 'GET' && url.pathname === '/linkedin' && methods.includes('linkedin')) {
+        res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+        res.end(socialHandoffHtml(lang, 'linkedin'));
+        finish({ ok: true, viaSocial: true, provider: 'linkedin' });
         return;
       }
       if (req.method === 'POST' && url.pathname === '/submit') {
@@ -279,4 +293,4 @@ function runLoopbackAuth(
   });
 }
 
-module.exports = { runLoopbackAuth, doAuth, loginFormHtml, registerFormHtml, methodChoiceHtml, googleHandoffHtml, DEFAULT_TIMEOUT_MS };
+module.exports = { runLoopbackAuth, doAuth, loginFormHtml, registerFormHtml, methodChoiceHtml, socialHandoffHtml, DEFAULT_TIMEOUT_MS };

package/src/mcp-certify-dimension-tools.js

@@ -1,6 +1,6 @@
 'use strict';
 
-// MCP: list the offerable dimensions (the interview itself runs over LiveKit in the CLI).
+// MCP: list the offerable dimensions (the certification interview itself is done on the web).
 
 const LIST_CERTIFIABLE_DIMENSIONS_SCHEMA = {
   type: 'object',
@@ -45,7 +45,7 @@ function makeCertifyDimensionTools(deps = {}) {
   return [
     {
       name: 'list_certifiable_dimensions',
-      description: "List the dimensions the talent can certify by CLI right now: their main role's hub dimensions whose interview runs by text (terminal or spoken-case templates) and not already CERTIFIED (UNCERTIFIED/EXPIRED). Requires an active session. The certification interview itself runs over LiveKit via `shakers certify` in the terminal. The dimensionKey/clusterId in each item are INTERNAL handles for tools only — never show or mention them to the talent; refer to a dimension by its name.",
+      description: "List the dimensions the talent can certify right now: their main role's hub dimensions whose interview runs by text (terminal or spoken-case templates) and not already CERTIFIED (UNCERTIFIED/EXPIRED). Requires an active session. The certification interview itself is done on the web; running `shakers certify` in the terminal hands the talent the web link to take it. The dimensionKey/clusterId in each item are INTERNAL handles for tools only — never show or mention them to the talent; refer to a dimension by its name.",
       inputSchema: LIST_CERTIFIABLE_DIMENSIONS_SCHEMA,
       handler: listCertifiableDimensions,
     },

package/src/mcp-onboarding-tools.js

@@ -131,7 +131,7 @@ function makeOnboardingTools(deps = {}) {
   // No explicit `method`: the loopback form opens on its email/social choice screen.
   async function loginViaForm({ method = null } = {}) {
     const result = await runLoopbackAuth(method ? { mode: 'login', method } : { mode: 'login' });
-    if (result.viaGoogle) return socialSigninPointer('login', 'google');
+    if (result.viaSocial) return socialSigninPointer('login', result.provider || 'google');
     if (!result.ok) return { ok: false, reason: result.reason || 'login-failed' };
     return { ok: true, method: 'email', email: result.email || null };
   }

package/src/mcp-prompts.js

@@ -0,0 +1,71 @@
+'use strict';
+
+// MCP prompts = in-client slash-commands. Each is a thin wrapper that injects a user turn
+// telling the assistant which Shakers tool(s) to use — the logic stays in the tools, so
+// there is no duplication. `buildMessages(args)` returns the prompts/get message list.
+
+function userText(text) {
+  return [{ role: 'user', content: { type: 'text', text } }];
+}
+
+// Only reference tools that exist in the FULL server; `available(toolNames)` hides a prompt
+// when its tool isn't registered (e.g. the --local scan-only server).
+const PROMPTS = [
+  {
+    name: 'ai_usage',
+    description: 'Evaluate and showcase how you work with AI (scans this machine, builds your "My work with AI").',
+    tools: ['ai_usage'],
+    buildMessages: () => userText(
+      'Evaluate how I work with AI for my Shakers profile. First ask me for consent and the email to attribute it to, then call the `ai_usage` tool and show me the resulting report verbatim. Never show internal ids/codes.',
+    ),
+  },
+  {
+    name: 'onboarding',
+    description: 'Register and onboard on Shakers (profile import, pricing, availability, interview).',
+    tools: ['register', 'suggest_register_context'],
+    buildMessages: () => userText(
+      'Help me get set up on Shakers. Use `suggest_register_context` to pre-fill what you can, show me `register_preview`, then `register`, and offer the `onboarding_interview_*` tools. Ask me only for what you cannot infer.',
+    ),
+  },
+  {
+    name: 'find_projects',
+    description: 'Find open Shakers projects/positions matched to you.',
+    tools: ['find_projects'],
+    buildMessages: () => userText(
+      'Find open Shakers positions that match me: call `find_projects` and summarize them by title/company (never show internal ids). Offer `save_project` / `show_project` for ones I like.',
+    ),
+  },
+  {
+    name: 'certify',
+    description: 'See which role dimensions you can certify and start a certification.',
+    tools: ['list_certifiable_dimensions'],
+    buildMessages: () => userText(
+      'Help me certify on Shakers: call `list_certifiable_dimensions`, present the dimensions I can certify by name, and guide me through certifying the one I pick.',
+    ),
+  },
+  {
+    name: 'ask',
+    description: 'Ask Alma, the Shakers AI assistant, a question.',
+    tools: ['ask'],
+    arguments: [{ name: 'message', description: 'What to ask Alma.', required: false }],
+    buildMessages: (args = {}) => userText(
+      `Ask Alma (the Shakers assistant) and relay her answer as-is. My question: ${typeof args.message === 'string' && args.message ? args.message : '(ask me what I want to know first)'}`,
+    ),
+  },
+  {
+    name: 'my_profile',
+    description: 'Show your Shakers profile (role, rate, availability, "My work with AI").',
+    tools: ['get_profile'],
+    buildMessages: () => userText(
+      'Show my Shakers profile: call `get_profile` (and `get_rate` / `get_availability` if useful) and present it in plain terms. Any ids/codes are internal — never show them.',
+    ),
+  },
+];
+
+function makePrompts(toolNames = null) {
+  const available = toolNames instanceof Set ? toolNames : null;
+  // Keep a prompt only if at least one of its tools is present in this server.
+  return PROMPTS.filter((p) => !available || p.tools.some((t) => available.has(t)));
+}
+
+module.exports = { makePrompts, PROMPTS };

package/src/mcp-register-tools.js

@@ -244,15 +244,17 @@ function makeRegisterTools(deps = {}) {
     if (!check.ok) return { ok: false, step: 'signup', reason: check.reason };
 
     const created = await runLoopbackAuth({ mode: 'register', deps: resolved, lang, registerFields });
-    if (created.viaGoogle) {
+    if (created.viaSocial) {
       // Social registration is the device flow (start/poll tools), not this single blocking call.
+      const provider = created.provider || 'google';
       return {
         ok: false,
         step: 'signup',
         reason: 'use-device-flow',
         next: 'social_signin_start',
         mode: 'register',
-        message: `To register with a social provider, call social_signin_start (provider "google" or "linkedin", mode "register", freelanceType "${registerFields.freelanceType || ''}") to get a URL and code to show the talent, then social_signin_poll. Once it returns authorized, run the profile steps (import, work situation, pricing).`,
+        provider,
+        message: `To register with ${provider}, call social_signin_start (provider "${provider}", mode "register", freelanceType "${registerFields.freelanceType || ''}") to get a URL and code to show the talent, then social_signin_poll. Once it returns authorized, run the profile steps (import, work situation, pricing).`,
       };
     }
     if (!created.ok) {

package/src/mcp-server.js

@@ -27,7 +27,7 @@ function errorResponse(id, code, message, data) {
   return { jsonrpc: JSONRPC, id: id === undefined ? null : id, error };
 }
 
-function createMcpServer({ tools = [], serverInfo = {}, protocolVersion, beforeCall = null, instructions = null } = {}) {
+function createMcpServer({ tools = [], prompts = [], serverInfo = {}, protocolVersion, beforeCall = null, instructions = null } = {}) {
   const registry = new Map();
   for (const t of tools) {
     if (!t || !t.name || typeof t.handler !== 'function') {
@@ -36,6 +36,14 @@ function createMcpServer({ tools = [], serverInfo = {}, protocolVersion, beforeC
     registry.set(t.name, t);
   }
 
+  const promptRegistry = new Map();
+  for (const p of prompts) {
+    if (!p || !p.name || typeof p.buildMessages !== 'function') {
+      throw new Error('each prompt needs a name and a buildMessages function');
+    }
+    promptRegistry.set(p.name, p);
+  }
+
   const advertisedVersion = protocolVersion || DEFAULT_PROTOCOL_VERSION;
 
   function shapeTool(t) {
@@ -50,6 +58,27 @@ function createMcpServer({ tools = [], serverInfo = {}, protocolVersion, beforeC
     return { tools: [...registry.values()].map(shapeTool) };
   }
 
+  function shapePrompt(p) {
+    const out = { name: p.name, description: p.description || '' };
+    if (Array.isArray(p.arguments)) out.arguments = p.arguments;
+    return out;
+  }
+
+  function listPrompts() {
+    return { prompts: [...promptRegistry.values()].map(shapePrompt) };
+  }
+
+  function getPrompt(params) {
+    const name = params && params.name;
+    const prompt = name && promptRegistry.get(name);
+    if (!prompt) {
+      const err = new Error(`unknown prompt: ${name}`);
+      err.rpcCode = ERROR.INVALID_PARAMS;
+      throw err;
+    }
+    return { description: prompt.description || '', messages: prompt.buildMessages((params && params.arguments) || {}) };
+  }
+
   async function listAvailableTools() {
     const out = [];
     for (const t of registry.values()) {
@@ -112,7 +141,10 @@ function createMcpServer({ tools = [], serverInfo = {}, protocolVersion, beforeC
           const requested = msg.params && msg.params.protocolVersion;
           return resultResponse(id, {
             protocolVersion: requested || advertisedVersion,
-            capabilities: { tools: { listChanged: false } },
+            capabilities: {
+              tools: { listChanged: false },
+              ...(promptRegistry.size ? { prompts: { listChanged: false } } : {}),
+            },
             serverInfo: {
               name: serverInfo.name || 'shakers-mcp',
               version: serverInfo.version || '0.0.0',
@@ -128,6 +160,10 @@ function createMcpServer({ tools = [], serverInfo = {}, protocolVersion, beforeC
           return resultResponse(id, await listAvailableTools());
         case 'tools/call':
           return resultResponse(id, await callTool(msg.params));
+        case 'prompts/list':
+          return resultResponse(id, listPrompts());
+        case 'prompts/get':
+          return resultResponse(id, getPrompt(msg.params));
         default:
           if (isNotification(msg)) return null;
           return errorResponse(id, ERROR.METHOD_NOT_FOUND, `method not found: ${method}`);

package/src/scanner.js

@@ -202,7 +202,19 @@ function computeRecency(paths) {
 /* ---------- version: ONLY runs the ALREADY detected binary, with --version ---------- */
 /* Never arbitrary commands; all output is discarded except the version pattern. */
 
+// scan() runs once per selected repo; remember each binary's version for a minute instead of asking again.
+const VERSION_TTL_MS = 60 * 1000;
+const versionCache = new Map();
+
 function getVersion(bin) {
+  const cached = versionCache.get(bin);
+  if (cached && Date.now() - cached.at <= VERSION_TTL_MS) return cached.version;
+  const version = readVersion(bin);
+  versionCache.set(bin, { version, at: Date.now() });
+  return version;
+}
+
+function readVersion(bin) {
   try {
     const out = execFileSync(bin, ['--version'], {
       timeout: 3000,
@@ -609,4 +621,4 @@ function mergeReports(reports) {
   };
 }
 
-module.exports = { scan, scanForRoots };
+module.exports = { scan, scanForRoots, getVersion };

package/src/session-normalizers.js

@@ -0,0 +1,174 @@
+'use strict';
+
+// Input normalizers: map a RAW session record into the Claude-shaped internal object model
+// that session-scan harvest + transcript-turns already consume
+// ({ cwd, timestamp, type, message:{ role, content:[{type:'text'|'tool_use', ...}] } }).
+// They ONLY translate input shape — downstream redaction/upload (share.js#derivePayload
+// -> POST usage/reports) is unchanged; no field is read that the Claude path didn't expose.
+// FAIL-CLOSED: every normalizer returns null / [] when a record does not match the expected
+// shape — it never fabricates or guesses fields. A documented format that differs from the
+// real one yields "no data for that tool", never wrong data.
+
+function str(v) {
+  return typeof v === 'string' && v ? v : null;
+}
+
+function textFromParts(parts) {
+  if (typeof parts === 'string') return parts.trim() || null;
+  if (!Array.isArray(parts)) return null;
+  const out = [];
+  for (const p of parts) {
+    if (typeof p === 'string') out.push(p);
+    else if (p && typeof p === 'object' && typeof p.text === 'string') out.push(p.text);
+  }
+  const joined = out.join('').trim();
+  return joined || null;
+}
+
+// --- Codex (~/.codex/sessions/**/rollout-*.jsonl) ---
+// Reads timestamp, cwd (session_meta), user text, and shell commands; a record matching none
+// of those passes through only its own real timestamp/cwd, else is dropped.
+function codexCommand(args) {
+  let a = args;
+  if (typeof a === 'string') {
+    try { a = JSON.parse(a); } catch { return a.trim() || null; }
+  }
+  if (!a || typeof a !== 'object') return null;
+  const cmd = a.command ?? a.cmd ?? a.commandLine;
+  if (Array.isArray(cmd)) return cmd.map(String).join(' ').trim() || null;
+  return str(cmd);
+}
+
+function normalizeCodexRecord(raw) {
+  if (!raw || typeof raw !== 'object') return null;
+  const payload = raw.payload && typeof raw.payload === 'object' ? raw.payload : null;
+  const item = payload || raw;
+  const out = {};
+  const ts = str(raw.timestamp) || str(item.timestamp);
+  if (ts) out.timestamp = ts;
+  const cwd = str(raw.cwd) || str(item.cwd);
+  if (cwd) out.cwd = cwd;
+
+  const role = str(item.role);
+  if (role === 'user') {
+    const text = textFromParts(item.content);
+    if (text) {
+      out.type = 'user';
+      out.message = { role: 'user', content: [{ type: 'text', text }] };
+      return out;
+    }
+  }
+
+  const type = str(raw.type) || str(item.type);
+  const name = str(item.name) || (type === 'function_call' ? 'shell' : null);
+  if (name && /shell|exec|bash|terminal|command/i.test(name)) {
+    const command = codexCommand(item.arguments ?? item.input ?? item.args);
+    if (command) {
+      out.message = { content: [{ type: 'tool_use', name: 'Shell', input: { command } }] };
+      return out;
+    }
+  }
+
+  return out.timestamp || out.cwd ? out : null;
+}
+
+// --- Gemini CLI (~/.gemini/tmp/<project-hash>/chats/logs.json | session-*.jsonl) ---
+// logs.json = JSON array of { type:'user'|'model', message, timestamp }; session-*.jsonl =
+// per-line { role, parts }. No cwd is recorded (the dir is a one-way SHA-256 hash), so cwd
+// stays null — global session/time metrics still count; per-repo scoping can't.
+function normalizeGeminiRecord(raw) {
+  if (!raw || typeof raw !== 'object') return null;
+  const out = {};
+  const ts = str(raw.timestamp) || str(raw.time);
+  if (ts) out.timestamp = ts;
+
+  const isUser = str(raw.type) === 'user' || str(raw.role) === 'user';
+  if (isUser) {
+    const text = str(raw.message) || textFromParts(raw.parts) || textFromParts(raw.content);
+    if (text) {
+      out.type = 'user';
+      out.message = { role: 'user', content: [{ type: 'text', text }] };
+      return out;
+    }
+  }
+  return out.timestamp ? out : null;
+}
+
+// --- Continue (continue.dev) ~/.continue/sessions/*.json ---
+// Each file is one session object; expand its history into per-turn objects, carrying
+// workspaceDirectory as cwd (good repo attribution).
+function normalizeContinueRecord(raw) {
+  if (!raw || typeof raw !== 'object') return null;
+  const cwd = str(raw.workspaceDirectory) || str(raw.workspace) || str(raw.cwd);
+  const history = Array.isArray(raw.history) ? raw.history
+    : (Array.isArray(raw.messages) ? raw.messages : (Array.isArray(raw.conversation) ? raw.conversation : null));
+  // A single message object (not a session) — handle defensively too.
+  if (!history) {
+    const msg = raw.message && typeof raw.message === 'object' ? raw.message : raw;
+    if (str(msg.role) === 'user') {
+      const text = typeof msg.content === 'string' ? msg.content.trim() : textFromParts(msg.content);
+      if (text) return oneUser(text, cwd, str(raw.timestamp) || str(raw.createdAt));
+    }
+    return null;
+  }
+  const out = [];
+  for (const entry of history) {
+    const msg = entry && entry.message && typeof entry.message === 'object' ? entry.message : entry;
+    if (!msg || typeof msg !== 'object') continue;
+    const ts = str(entry.timestamp) || str(entry.createdAt) || str(msg.timestamp);
+    // Only emit on a real user turn (with text) or a record carrying a real timestamp.
+    if (str(msg.role) === 'user') {
+      const text = typeof msg.content === 'string' ? msg.content.trim() : textFromParts(msg.content);
+      if (text) { out.push(oneUser(text, cwd, ts)); continue; }
+    }
+    if (ts) out.push(cwd ? { cwd, timestamp: ts } : { timestamp: ts });
+  }
+  return out.length ? out : null;
+}
+
+// --- Cline / Roo Code: VS Code globalStorage .../tasks/<id>/api_conversation_history.json ---
+// One JSON array of Anthropic messages (role/content); no cwd and no timestamp in this file
+// (ui_messages.json has ts) → cwd/time attribution absent. Emits only real user turns.
+function normalizeClineRecord(raw) {
+  if (!raw || typeof raw !== 'object') return null;
+  if (str(raw.role) !== 'user') return null;
+  const text = typeof raw.content === 'string' ? raw.content.trim() : textFromParts(raw.content);
+  return text ? oneUser(text, null, null) : null;
+}
+
+// --- Aider: per-repo .aider.chat.history.md (markdown) ---
+// Repo-level source → cwd is the repo toplevel (good attribution). Markdown parse:
+// '# aider chat started at <ts>' sets the session time; '#### <text>' lines are user
+// instructions. A file matching neither pattern yields 0 records.
+function parseAiderHistory(text, cwd) {
+  if (typeof text !== 'string' || !text) return [];
+  const out = [];
+  let ts = null;
+  for (const line of text.split('\n')) {
+    const started = /^#\s*aider chat started at\s+(.+?)\s*$/i.exec(line);
+    if (started) {
+      const t = Date.parse(started[1].replace(' ', 'T'));
+      ts = Number.isFinite(t) ? new Date(t).toISOString() : null;
+      if (ts) out.push(cwd ? { cwd, timestamp: ts } : { timestamp: ts });
+      continue;
+    }
+    const user = /^####\s+(.*)$/.exec(line);
+    if (user && user[1].trim()) out.push(oneUser(user[1].trim(), cwd, ts));
+  }
+  return out;
+}
+
+function oneUser(text, cwd, ts) {
+  const o = { type: 'user', message: { role: 'user', content: [{ type: 'text', text }] } };
+  if (cwd) o.cwd = cwd;
+  if (ts) o.timestamp = ts;
+  return o;
+}
+
+module.exports = {
+  normalizeCodexRecord,
+  normalizeGeminiRecord,
+  normalizeContinueRecord,
+  normalizeClineRecord,
+  parseAiderHistory,
+};