shakers-cli-beta 0.10.3 → 0.11.0

package/src/i18n.js

@@ -203,26 +203,26 @@ const catalogs = {
       blockingLabel: 'Criterio exacto que te impide subir de tier:',
       maxTierNote: 'Cumples todos los criterios de la escalera T0-T7: no hay un criterio adicional bloqueando tu progreso.',
       criterion: {
-        t1Met: (n) => `Tienes al menos una herramienta de IA detectada y configurada en tu entorno (\`totalDetected = ${n}\`).`,
-        t2Met: (n) => `Dispones de al menos un fichero de contexto persistente — instrucciones, configuración o reglas — para alguna herramienta (\`context = ${n}\`).`,
-        t3Met: (n) => `Tienes al menos un servidor MCP conectado, dando a la IA acceso a datos o herramientas externas (\`mcpServers = ${n}\`).`,
-        t4Met: (n) => `Has creado activos propios — skills, comandos o reglas personalizadas — más allá de la configuración por defecto (\`custom = ${n}\`).`,
-        t5Met: (hasAgentic, mcp, custom) => `Operas con una CLI agéntica (Claude Code, Aider, Gemini CLI, Codex CLI o Amazon Q Developer) combinada con MCP y activos propios (\`hasAgentic = ${hasAgentic}\`, \`mcpServers = ${mcp}\`, \`custom = ${custom}\`).`,
-        t6Met: (n) => `Tienes un equipo de al menos 2 agentes especializados definidos (\`agentCounts.agents = ${n}\`).`,
-        t7Met: (n) => `Tienes automatización basada en hooks configurada (\`hooks = ${n}\`).`,
-        t1Blocking: (n) => `Para subir a T1 (Primera herramienta) necesitas al menos una herramienta de IA detectada — actualmente \`totalDetected = ${n}\`.`,
-        t2Blocking: (n) => `Para subir a T2 (Banco con notas) necesitas al menos un fichero de contexto persistente (instrucciones, configuración o reglas) — actualmente \`context = ${n}\`.`,
-        t3Blocking: (n) => `Para subir a T3 (Banco conectado) necesitas conectar al menos un servidor MCP — actualmente \`mcpServers = ${n}\`.`,
-        t4Blocking: (n) => `Para subir a T4 (Herramienta propia) necesitas crear al menos un activo propio — skill, comando o regla — más allá de la configuración por defecto — actualmente \`custom = ${n}\`.`,
+        t1Met: (n) => `Tienes al menos una herramienta de IA detectada y configurada en tu entorno (detectadas: ${n}).`,
+        t2Met: (n) => `Dispones de al menos un fichero de contexto persistente — instrucciones, configuración o reglas — para alguna herramienta (tienes ${n}).`,
+        t3Met: (n) => `Tienes al menos un servidor MCP conectado, dando a la IA acceso a datos o herramientas externas (tienes ${n}).`,
+        t4Met: (n) => `Has creado activos propios — skills, comandos o reglas personalizadas — más allá de la configuración por defecto (tienes ${n}).`,
+        t5Met: (hasAgentic, mcp, custom) => `Operas con una CLI agéntica (Claude Code, Aider, Gemini CLI, Codex CLI o Amazon Q Developer) combinada con MCP y activos propios (${mcp} servidores MCP y ${custom} activos propios).`,
+        t6Met: (n) => `Tienes un equipo de al menos 2 agentes especializados definidos (tienes ${n}).`,
+        t7Met: (n) => `Tienes automatización basada en hooks configurada (tienes ${n}).`,
+        t1Blocking: (n) => `Para subir a T1 (Primera herramienta) necesitas al menos una herramienta de IA detectada — ahora tienes ${n}.`,
+        t2Blocking: (n) => `Para subir a T2 (Banco con notas) necesitas al menos un fichero de contexto persistente (instrucciones, configuración o reglas) — ahora tienes ${n}.`,
+        t3Blocking: (n) => `Para subir a T3 (Banco conectado) necesitas conectar al menos un servidor MCP — ahora tienes ${n}.`,
+        t4Blocking: (n) => `Para subir a T4 (Herramienta propia) necesitas crear al menos un activo propio — skill, comando o regla — más allá de la configuración por defecto — ahora tienes ${n}.`,
         t5Blocking: (hasAgentic, mcp, custom) => {
           const missing = [];
           if (!hasAgentic) missing.push('una CLI agéntica (Claude Code, Aider, Gemini CLI, Codex CLI o Amazon Q Developer)');
           if (mcp < 1) missing.push('al menos 1 servidor MCP');
           if (custom < 1) missing.push('al menos 1 activo propio (skill, comando o regla)');
-          return `Para subir a T5 (Operador agéntico) te falta: ${missing.join('; ')} (\`hasAgentic = ${hasAgentic}\`, \`mcpServers = ${mcp}\`, \`custom = ${custom}\`).`;
+          return `Para subir a T5 (Operador agéntico) te falta: ${missing.join('; ')}.`;
         },
         t6Blocking: (n) => `Para subir a T6 (Multi-agente) necesitas al menos 2 agentes especializados definidos en \`.claude/agents/\` — actualmente tienes ${n}.`,
-        t7Blocking: (n) => `Para subir a T7 (Taller orquestado) necesitas al menos un hook de automatización configurado — actualmente \`hooks = ${n}\`.`,
+        t7Blocking: (n) => `Para subir a T7 (Taller orquestado) necesitas al menos un hook de automatización configurado — ahora tienes ${n}.`,
       },
     },
     ladder: {
@@ -487,6 +487,39 @@ const catalogs = {
         yes: 'Sí, iniciar sesión',
         no: 'No, continuar sin cuenta',
       },
+      // `update` command: actualiza el CLI a la última versión publicada (solo CLI, no MCP).
+      update: {
+        help:
+          'update — actualiza el CLI de Shakers a la última versión publicada.\n\n'
+          + '  Uso: shakers update [--check]\n\n'
+          + '    (sin flag)   Comprueba la última versión y, si hay una más nueva, la instala\n'
+          + '                 por el mismo método con el que se instaló este CLI.\n'
+          + '    --check      Solo informa de tu versión frente a la última publicada; no instala.\n'
+          + '    --json       Salida JSON (paquete, versión actual/última, si hay actualización).\n',
+        checking: 'Comprobando actualizaciones…',
+        current: (v) => `Versión instalada: ${v}`,
+        upToDate: (v) => `Ya tienes la última versión (${v}).`,
+        available: (from, to) => `Hay una actualización disponible: ${from} → ${to}`,
+        checkHint: 'Ejecuta `shakers update` (sin --check) para instalarla.',
+        detected: (label) => `Instalación detectada: ${label}`,
+        updating: (name, from, to) => `Actualizando ${name}: ${from} → ${to}…`,
+        success: (v) => `Actualizado a la versión ${v}.`,
+        reRun: 'Vuelve a ejecutar tu comando para usar la nueva versión.',
+        latestUnknown: (reason) =>
+          `No se pudo determinar la última versión (${reason}). Revisa tu conexión y el acceso al registro.`,
+        failInstall: (reason) => `La actualización falló (${reason}).`,
+        failHint: (cmd) =>
+          `Revisa tu conexión y permisos y vuelve a intentarlo, o actualiza a mano:\n    ${cmd}`,
+        sourceCheckout:
+          'Este CLI se ejecuta desde un checkout de código — actualízalo con `git pull` en ese repositorio.',
+        unknownInstall: (cmd) =>
+          `No se pudo detectar cómo se instaló este CLI. Actualiza a mano:\n    ${cmd}`,
+      },
+      // Aviso pasivo "hay una versión nueva" al arrancar cualquier comando (lectura de caché, sin red en el camino caliente).
+      updateNotifier: {
+        available: (from, to) => `Hay una versión nueva del CLI de Shakers: ${from} → ${to}`,
+        howTo: 'Ejecuta `shakers update` para actualizar.',
+      },
       // `report` command (ADR-016): genera y ABRE el informe HTML completo y compartible de este proyecto (uso de IA + Skills certificadas).
       report: {
         help: 'report — genera y abre el informe HTML completo de este proyecto (uso de IA + Skills certificadas) para compartir con tu equipo.\n'
@@ -714,6 +747,8 @@ const catalogs = {
       discoverFailed: (reason) => `No se pudieron obtener tus dimensiones (${reason}). Inténtalo de nuevo en un momento.`,
       unmatchedNote: (keys) => `Aviso: algunas dimensiones no tienen plantilla asociada y no se pueden ofrecer aquí (${keys}).`,
       noneOfferable: 'Ahora mismo no hay dimensiones certificables por aquí. Vuelve a intentarlo cuando tengas alguna disponible.',
+      onCooldownNote: (items) => `Aún no puedes repetir: ${items}.`,
+      onCooldownItem: (slug, day) => `${slug} (disponible el ${day})`,
       mainRole: (role) => `Tu rol principal: ${role}`,
       selectHeading: 'Elige la dimensión que quieres certificar:',
       selectHint: '↑/↓ para moverte, Enter para elegir, Esc para cancelar.',
@@ -722,10 +757,41 @@ const catalogs = {
       selectNoneChosen: 'No se eligió ninguna dimensión.',
       stateExpired: 'caducada',
       dimensionInvalid: 'Esa dimensión no está entre las certificables ahora mismo.',
+      dimensionOnCooldown: (slug, day) => `Aún no puedes repetir ${slug}: estará disponible el ${day}.`,
       dimensionUsing: (slug) => `Dimensión elegida: ${slug}`,
-      webHandoff: 'La entrevista de certificación se hace en la web.',
-      webHandoffLink: (url) => `Ábrela aquí para certificar esta dimensión:\n  ${url}`,
-      webHandoffNoLink: 'Entra en tu perfil de Shakers en la web y ve a Certificaciones para hacerla.',
+      creating: 'Creando la entrevista…',
+      createFailed: (reason) => `No se pudo crear la entrevista (${reason}).`,
+      onCooldown: (day) => (day
+        ? `Ya hiciste esta dimensión hace poco. Podrás repetirla a partir del ${day}.`
+        : 'Ya hiciste esta dimensión hace poco y todavía no se puede repetir.'),
+      needsWeb: 'Esta dimensión lleva un ejercicio que por ahora solo se hace en la web, no por terminal.',
+      interviewUnavailable: (reason) => `La entrevista no pudo completarse (${reason}).`,
+      reportPolling: 'Calculando tu veredicto…',
+      reportTimeout: 'El veredicto todavía se está calculando. Consúltalo en tu perfil en unos minutos.',
+      reportFailed: (reason) => `No se pudo obtener el veredicto (${reason}). Consúltalo en tu perfil.`,
+      verdictTitle: 'Veredicto',
+      verdictDimension: (dim) => `Dimensión: ${dim}`,
+      verdictBand: (band) => `Nivel: ${band}`,
+      verdictCertified: 'Resultado: certificada',
+      verdictNotCertified: 'Resultado: no certificada esta vez',
+      done: 'Certificación completada.',
+      // The same case copy the web preview shows (works `certifications.preview`).
+      caseTitle: 'El caso',
+      caseExpectationsTitle: 'Qué se espera',
+      caseExpectations: {
+        CASE_STUDY: {
+          reasoning: 'Se evalúa tu razonamiento y los supuestos que haces, no una respuesta perfecta.',
+          askForData: 'Puedes pedir datos que no están en el caso: di para qué los quieres.',
+          takeTime: 'Puedes pararte a pensar antes de responder.',
+        },
+        ROLE_PLAY: {
+          reasoning: 'Se evalúa cómo razonas en la conversación y los supuestos que haces, no una respuesta perfecta.',
+          askForData: 'Puedes pedir a la otra parte datos que no están en el caso.',
+          takeTime: 'Puedes pararte a pensar antes de responder.',
+        },
+      },
+      caseBeforeStart: 'Alma te va a hacer preguntas sobre este caso. Si te falta algún dato, pídeselo durante la entrevista.',
+      caseReadyPrompt: 'Pulsa Enter cuando lo hayas leído para empezar la entrevista.',
     },
     findProjects: {
       help:
@@ -949,6 +1015,7 @@ const catalogs = {
       noTerminal: 'No hay una terminal donde preguntarte, así que no he tocado nada. Vuelve a ejecutar el instalador en tu terminal para conectarlo.',
       restart: 'Reinicia las apps que estén abiertas para que carguen Shakers.',
       noneFound: 'No he encontrado ninguna app de IA compatible en esta máquina.',
+      failedAll: 'No he podido conectar Shakers a tus apps de IA. Vuelve a ejecutar el instalador para reintentarlo.',
     },
     rate: {
       help: 'rate — ver o fijar tu tarifa por proyecto.\n\nUso:\n  rate [--lang es|en] [--json]      ver tu tarifa\n  rate --set [--lang es|en]         fijarla (interactivo, con confirmación)\n\nRequiere una sesión activa (shakers login).',
@@ -1805,26 +1872,26 @@ const catalogs = {
       blockingLabel: 'Exact criterion blocking your next tier:',
       maxTierNote: "You meet every criterion in the T0-T7 ladder: there's no additional criterion blocking your progress.",
       criterion: {
-        t1Met: (n) => `You have at least one AI tool detected and configured in your environment (\`totalDetected = ${n}\`).`,
-        t2Met: (n) => `You have at least one persistent context file — instructions, config or rules — for some tool (\`context = ${n}\`).`,
-        t3Met: (n) => `You have at least one connected MCP server, giving the AI access to external data or tools (\`mcpServers = ${n}\`).`,
-        t4Met: (n) => `You've created your own assets — skills, commands or custom rules — beyond the default configuration (\`custom = ${n}\`).`,
-        t5Met: (hasAgentic, mcp, custom) => `You operate an agentic CLI (Claude Code, Aider, Gemini CLI, Codex CLI or Amazon Q Developer) combined with MCP and your own assets (\`hasAgentic = ${hasAgentic}\`, \`mcpServers = ${mcp}\`, \`custom = ${custom}\`).`,
-        t6Met: (n) => `You have a team of at least 2 specialized agents defined (\`agentCounts.agents = ${n}\`).`,
-        t7Met: (n) => `You have hook-based automation configured (\`hooks = ${n}\`).`,
-        t1Blocking: (n) => `To reach T1 (First tool) you need at least one detected AI tool — currently \`totalDetected = ${n}\`.`,
-        t2Blocking: (n) => `To reach T2 (Bench with notes) you need at least one persistent context file (instructions, config or rules) — currently \`context = ${n}\`.`,
-        t3Blocking: (n) => `To reach T3 (Connected bench) you need to connect at least one MCP server — currently \`mcpServers = ${n}\`.`,
-        t4Blocking: (n) => `To reach T4 (Own tooling) you need to create at least one asset of your own — skill, command or rule — currently \`custom = ${n}\`.`,
+        t1Met: (n) => `You have at least one AI tool detected and configured in your environment (detected: ${n}).`,
+        t2Met: (n) => `You have at least one persistent context file — instructions, config or rules — for some tool (you have ${n}).`,
+        t3Met: (n) => `You have at least one connected MCP server, giving the AI access to external data or tools (you have ${n}).`,
+        t4Met: (n) => `You've created your own assets — skills, commands or custom rules — beyond the default configuration (you have ${n}).`,
+        t5Met: (hasAgentic, mcp, custom) => `You operate an agentic CLI (Claude Code, Aider, Gemini CLI, Codex CLI or Amazon Q Developer) combined with MCP and your own assets (${mcp} MCP servers and ${custom} assets of your own).`,
+        t6Met: (n) => `You have a team of at least 2 specialized agents defined (you have ${n}).`,
+        t7Met: (n) => `You have hook-based automation configured (you have ${n}).`,
+        t1Blocking: (n) => `To reach T1 (First tool) you need at least one detected AI tool — you have ${n} now.`,
+        t2Blocking: (n) => `To reach T2 (Bench with notes) you need at least one persistent context file (instructions, config or rules) — you have ${n} now.`,
+        t3Blocking: (n) => `To reach T3 (Connected bench) you need to connect at least one MCP server — you have ${n} now.`,
+        t4Blocking: (n) => `To reach T4 (Own tooling) you need to create at least one asset of your own — skill, command or rule — you have ${n} now.`,
         t5Blocking: (hasAgentic, mcp, custom) => {
           const missing = [];
           if (!hasAgentic) missing.push('an agentic CLI (Claude Code, Aider, Gemini CLI, Codex CLI or Amazon Q Developer)');
           if (mcp < 1) missing.push('at least 1 MCP server');
           if (custom < 1) missing.push('at least 1 asset of your own (skill, command or rule)');
-          return `To reach T5 (Agentic operator) you're missing: ${missing.join('; ')} (\`hasAgentic = ${hasAgentic}\`, \`mcpServers = ${mcp}\`, \`custom = ${custom}\`).`;
+          return `To reach T5 (Agentic operator) you're missing: ${missing.join('; ')}.`;
         },
         t6Blocking: (n) => `To reach T6 (Multi-agent) you need at least 2 specialized agents defined under \`.claude/agents/\` — currently you have ${n}.`,
-        t7Blocking: (n) => `To reach T7 (Orchestrated workshop) you need at least one automation hook configured — currently \`hooks = ${n}\`.`,
+        t7Blocking: (n) => `To reach T7 (Orchestrated workshop) you need at least one automation hook configured — you have ${n} now.`,
       },
     },
     // Progression ladder (skill-code-certification, report req 1) — see the es block.
@@ -2089,6 +2156,39 @@ const catalogs = {
         yes: 'Yes, sign in',
         no: 'No, continue without an account',
       },
+      // `update` command: updates the CLI to the latest published version (CLI-only, not MCP).
+      update: {
+        help:
+          'update — update the Shakers CLI to the latest published version.\n\n'
+          + '  Usage: shakers update [--check]\n\n'
+          + '    (no flag)    Check the latest version and, if a newer one exists, install it\n'
+          + '                 the same way this CLI was installed.\n'
+          + '    --check      Only report your version vs the latest published; do not install.\n'
+          + '    --json       JSON output (package, current/latest version, whether an update exists).\n',
+        checking: 'Checking for updates…',
+        current: (v) => `Installed version: ${v}`,
+        upToDate: (v) => `You are on the latest version (${v}).`,
+        available: (from, to) => `An update is available: ${from} → ${to}`,
+        checkHint: 'Run `shakers update` (without --check) to install it.',
+        detected: (label) => `Detected install: ${label}`,
+        updating: (name, from, to) => `Updating ${name}: ${from} → ${to}…`,
+        success: (v) => `Updated to version ${v}.`,
+        reRun: 'Re-run your command to use the new version.',
+        latestUnknown: (reason) =>
+          `Could not determine the latest version (${reason}). Check your network and registry access.`,
+        failInstall: (reason) => `The update failed (${reason}).`,
+        failHint: (cmd) =>
+          `Check your network and permissions and try again, or update manually:\n    ${cmd}`,
+        sourceCheckout:
+          'This CLI is running from a source checkout — update it with `git pull` in that repository.',
+        unknownInstall: (cmd) =>
+          `Could not detect how this CLI was installed. Update manually:\n    ${cmd}`,
+      },
+      // Passive "a newer version exists" notice printed when any command starts (cache read, no network on the hot path).
+      updateNotifier: {
+        available: (from, to) => `A newer Shakers CLI is available: ${from} → ${to}`,
+        howTo: 'Run `shakers update` to upgrade.',
+      },
       // `report` command (ADR-016): builds and OPENS the full, shareable HTML report for this project (AI usage + certified Skills).
       report: {
         help: 'report — build and open the full HTML report for this project (AI usage + certified Skills) to share with your team.\n'
@@ -2309,6 +2409,8 @@ const catalogs = {
       discoverFailed: (reason) => `Could not fetch your dimensions (${reason}). Try again in a moment.`,
       unmatchedNote: (keys) => `Note: some dimensions have no matching template and can't be offered here (${keys}).`,
       noneOfferable: 'There are no dimensions you can certify here right now. Check back when one becomes available.',
+      onCooldownNote: (items) => `Not available to retake yet: ${items}.`,
+      onCooldownItem: (slug, day) => `${slug} (available on ${day})`,
       mainRole: (role) => `Your main role: ${role}`,
       selectHeading: 'Pick the dimension you want to certify:',
       selectHint: '↑/↓ to move, Enter to pick, Esc to cancel.',
@@ -2317,10 +2419,41 @@ const catalogs = {
       selectNoneChosen: 'No dimension chosen.',
       stateExpired: 'expired',
       dimensionInvalid: 'That dimension is not among the certifiable ones right now.',
+      dimensionOnCooldown: (slug, day) => `You can't retake ${slug} yet: it will be available on ${day}.`,
       dimensionUsing: (slug) => `Chosen dimension: ${slug}`,
-      webHandoff: 'The certification interview is done on the web.',
-      webHandoffLink: (url) => `Open it here to certify this dimension:\n  ${url}`,
-      webHandoffNoLink: 'Open your Shakers profile on the web and go to Certifications to take it.',
+      creating: 'Creating the interview…',
+      createFailed: (reason) => `Could not create the interview (${reason}).`,
+      onCooldown: (day) => (day
+        ? `You took this dimension recently. You can retake it from ${day}.`
+        : 'You took this dimension recently and cannot retake it yet.'),
+      needsWeb: 'This dimension has an exercise that for now is only taken on the web, not in the terminal.',
+      interviewUnavailable: (reason) => `The interview could not be completed (${reason}).`,
+      reportPolling: 'Computing your verdict…',
+      reportTimeout: 'The verdict is still being computed. Check your profile in a few minutes.',
+      reportFailed: (reason) => `Could not fetch the verdict (${reason}). Check your profile.`,
+      verdictTitle: 'Verdict',
+      verdictDimension: (dim) => `Dimension: ${dim}`,
+      verdictBand: (band) => `Level: ${band}`,
+      verdictCertified: 'Result: certified',
+      verdictNotCertified: 'Result: not certified this time',
+      done: 'Certification complete.',
+      // The same case copy the web preview shows (works `certifications.preview`).
+      caseTitle: 'The case',
+      caseExpectationsTitle: 'What is expected',
+      caseExpectations: {
+        CASE_STUDY: {
+          reasoning: 'We assess your reasoning and the assumptions you make, not a perfect answer.',
+          askForData: 'You can ask for data that is not in the case: say what you want it for.',
+          takeTime: 'You can stop to think before you answer.',
+        },
+        ROLE_PLAY: {
+          reasoning: 'We assess how you reason in the conversation and the assumptions you make, not a perfect answer.',
+          askForData: 'You can ask the other side for data that is not in the case.',
+          takeTime: 'You can stop to think before you answer.',
+        },
+      },
+      caseBeforeStart: 'Alma is going to ask you questions about this case. If you are missing any data, ask her for it during the interview.',
+      caseReadyPrompt: 'Press Enter once you have read it to start the interview.',
     },
     findProjects: {
       help:
@@ -2544,6 +2677,7 @@ const catalogs = {
       noTerminal: 'There is no terminal to ask you on, so nothing was touched. Run the installer again in your terminal to connect it.',
       restart: 'Restart any of these apps that is open so it loads Shakers.',
       noneFound: 'Found no supported AI app on this machine.',
+      failedAll: 'Could not connect Shakers to your AI apps. Re-run this installer to retry.',
     },
     rate: {
       help: 'rate — view or set your per-project rate.\n\nUsage:\n  rate [--lang es|en] [--json]      view your rate\n  rate --set [--lang es|en]         set it (interactive, with confirmation)\n\nRequires an active session (shakers login).',

package/src/mcp-ai-usage-tool.js

@@ -3,7 +3,7 @@
 const fs = require('fs');
 const { execFileSync } = require('child_process');
 const { isRefusedWalkRoot } = require('./scan-exclusions');
-const { askChoice } = require('./mcp-choice');
+const { askChoice, chatChoice, queueNotice } = require('./mcp-choice');
 
 function isExistingDir(p) {
   try {
@@ -31,17 +31,13 @@ const AI_USAGE_INPUT_SCHEMA = {
     consent: {
       type: 'object',
       description:
-        "The talent's explicit answer to the AI-usage question, asked right after showing both disclaimers verbatim. Nothing is scanned without granted:true. A yes to anything else is not this answer.",
+        "The talent's explicit answer to the AI-usage question this tool asks together with both disclaimers. Nothing is scanned without granted:true. A yes to anything else is not this answer.",
       properties: {
         granted: { type: 'boolean', description: 'true ONLY after the talent explicitly said yes to the AI-usage question; false when they said no. Omit it to get the disclaimers and the question to ask.' },
         email: { type: 'string', description: 'The talent email the report is attributed to. Required when granted is true.' },
       },
       required: ['granted'],
     },
-    disclaimersShown: {
-      type: 'boolean',
-      description: 'true only after you showed the talent both AI-usage disclaimers word for word, right before this call. Without consent, it then asks the AI-usage question in a dialog when the client has one.',
-    },
     repoScope: {
       type: 'object',
       description: 'Which repositories feed the evaluation. Defaults to the current repository only.',
@@ -152,35 +148,21 @@ function makeAiUsageTool(deps = {}) {
     }, () => ({ ok: false, skipped: true, reason: 'scan-failed' }));
     return current.uploading;
   }
-  function consentRequired(lang, ctx) {
-    const c = signupCopy(lang);
-    const disclaimers = Object.values(usageDisclaimers(lang));
-    if (ctx && ctx.elicitation) {
-      return {
-        ok: false,
-        reason: 'consent-required',
-        relayVerbatim: disclaimers,
-        message: 'Nothing was scanned. Show the talent each relayVerbatim text word for word, each as its own block, without labels or paraphrase; then call ai_usage again with disclaimersShown:true and no consent: it asks the question in a dialog.',
-      };
-    }
-    return {
-      ok: false,
-      reason: 'consent-required',
-      relayVerbatim: disclaimers,
-      question: c.aiUsageQuestion,
-      options: [c.aiUsageYes, c.aiUsageSkip],
-      message: 'Nothing was scanned. Show the talent each relayVerbatim text word for word, each as its own block, without labels or paraphrase, then `question` with its `options` (your native choice buttons if you have them, otherwise a short numbered list). Then call again with consent.granted:true only after they pick the first option, or consent.granted:false if they skip it.',
-    };
-  }
-
   function declined(lang) {
     recordConsent('denied');
-    return { ok: false, reason: 'consent-declined', relayVerbatim: signupCopy(lang).aiUsageSkipped, message: 'Nothing was scanned. Show relayVerbatim once, word for word, and carry on with the interview offer.' };
+    if (signupPhase() === 'account') {
+      queueNotice(signupCopy(lang).aiUsageSkipped);
+      return { ok: false, reason: 'consent-declined', message: 'Nothing was scanned. Say nothing about it: its fixed line for the talent comes with the next question. Carry on with the interview offer.' };
+    }
+    return { ok: false, reason: 'consent-declined', relayVerbatim: signupCopy(lang).aiUsageSkipped, message: 'Nothing was scanned. Show relayVerbatim once, word for word.' };
   }
 
   async function askConsent(lang, ctx) {
     const c = signupCopy(lang);
-    const asked = await askChoice(ctx, { question: c.aiUsageQuestion, options: [c.aiUsageYes, c.aiUsageSkip] });
+    const texts = Object.values(usageDisclaimers(lang));
+    const asked = ctx && ctx.elicitation
+      ? await askChoice(ctx, { texts, question: c.aiUsageQuestion, options: [c.aiUsageYes, c.aiUsageSkip] })
+      : { chat: chatChoice(c.aiUsageQuestion, [c.aiUsageYes, c.aiUsageSkip], texts) };
     if (asked.answer === c.aiUsageSkip) {
       dialogConsent = 'denied';
       return declined(lang);
@@ -194,7 +176,7 @@ function makeAiUsageTool(deps = {}) {
       reason: 'consent-required',
       ...(asked.dismissed ? { dismissed: asked.dismissed } : {}),
       ...asked.chat,
-      message: `Nothing was scanned. The disclaimers are already shown: do not repeat them. ${asked.chat.choiceMessage} Then call again with consent.granted:true only after an explicit yes, or consent.granted:false if they say no.`,
+      message: `Nothing was scanned. ${asked.chat.choiceMessage} Then call ai_usage again with consent.granted:true only after they pick the first option, or consent.granted:false if they skip it.`,
     };
   }
 
@@ -214,7 +196,6 @@ function makeAiUsageTool(deps = {}) {
       return { ok: false, reason: 'consent-declined', message: 'The talent skipped the AI-usage step in the dialog: nothing is scanned. Carry on without it. If they later ask for the scan themselves, call ai_usage without consent to ask them again.' };
     }
     if (consent.granted !== true) {
-      if (args.disclaimersShown !== true || !(ctx && ctx.elicitation)) return consentRequired(textLang, ctx);
       const answered = await askConsent(textLang, ctx);
       // In the sign-up a yes in the dialog runs the scan right away, in the background.
       if (!(answered.reason === 'consent-granted' && phase === 'account')) return answered;
@@ -405,7 +386,7 @@ function makeAiUsageTool(deps = {}) {
   return {
     name: 'ai_usage',
     description:
-      "Measure how a Shakers talent uses AI in their work: scans this machine and repository for AI-tool usage (subagents, MCP servers, sessions, git activity), scores their AI-maturity tier (T0-T7), and, with the talent's consent, submits the report to Shakers so their profile reflects it. Runs entirely on the talent's own machine. Before any scan, show the talent both AI-usage disclaimers word for word, each as its own block, right before the AI-usage question (call without consent to get those texts and the question); only an explicit yes allows consent.granted:true, and skipping is consent.granted:false. In the sign-up it is the step right after the account exists and before the interview: on yes it runs and uploads in the background, never wait for it. Submission also requires an active, email-verified Shakers session (via `shakers login` / registration OTP): without a verified session the report stays on this machine and nothing is sent — check the `send` field for the outcome. Always fast and deterministic: it runs no LLM on the machine. Agent descriptions and catalog classification are produced by Shakers server-side. This waits briefly (~30s) and, if classification finishes, returns the enriched agents inline; otherwise it returns enrichment:'pending' (normal progress, not an error) and you should call `ai_usage_result` to get them. The `text` field is a ready-to-show plain-text 'My work with AI' report (Markdown, no ANSI) mirroring the CLI terminal — render it verbatim to the talent; the matrix grid is inside a fenced code block, keep it fenced so it stays aligned. Use the `display` block for structured access: show the tier (with the tierLegend explaining T0-T7) and the agent list by NAME and category/role. IDs and codes (agent `code`, skillId, catalogId) are internal handles for the add_* tools only — never show raw IDs or codes to the talent.",
+      "Measure how a Shakers talent uses AI in their work: scans this machine and repository for AI-tool usage (subagents, MCP servers, sessions, git activity), scores their AI-maturity tier (T0-T7), and, with the talent's consent, submits the report to Shakers so their profile reflects it. Runs entirely on the talent's own machine. Before any scan, call it without consent: it asks the AI-usage question with both disclaimers in the same block (a dialog, or `say` to print word for word); only an explicit yes allows consent.granted:true, and skipping is consent.granted:false. In the sign-up it is the step right after the account exists and before the interview: on yes it runs and uploads in the background, never wait for it. Submission also requires an active, email-verified Shakers session (via `shakers login` / registration OTP): without a verified session the report stays on this machine and nothing is sent — check the `send` field for the outcome. Always fast and deterministic: it runs no LLM on the machine. Agent descriptions and catalog classification are produced by Shakers server-side. This waits briefly (~30s) and, if classification finishes, returns the enriched agents inline; otherwise it returns enrichment:'pending' (normal progress, not an error) and you should call `ai_usage_result` to get them. The `text` field is a ready-to-show plain-text 'My work with AI' report (Markdown, no ANSI) mirroring the CLI terminal — render it verbatim to the talent; the matrix grid is inside a fenced code block, keep it fenced so it stays aligned. Use the `display` block for structured access: show the tier (with the tierLegend explaining T0-T7) and the agent list by NAME and category/role. IDs and codes (agent `code`, skillId, catalogId) are internal handles for the add_* tools only — never show raw IDs or codes to the talent.",
     inputSchema: AI_USAGE_INPUT_SCHEMA,
     handler,
   };

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

@@ -39,13 +39,19 @@ function makeCertifyDimensionTools(deps = {}) {
         state: d.state,
         band: d.band || null,
       })),
+      onCooldown: (res.onCooldown || []).map((d) => ({
+        dimensionKey: d.dimensionKey,
+        slug: d.slug,
+        clusterId: d.clusterId,
+        availableAt: d.availableAt,
+      })),
     };
   }
 
   return [
     {
       name: 'list_certifiable_dimensions',
-      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.",
+      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). Dimensions the talent cannot retake yet are NOT in `dimensions`; they come in `onCooldown` with the ISO date they free up, so tell the talent when they can retry instead of offering them. 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-choice.js

@@ -1,47 +1,69 @@
 'use strict';
 
-// Closed questions of the MCP sign-up: a dialog when the client can elicit, otherwise options the model offers in the chat.
+// Closed questions of the MCP sign-up: a dialog when the client can elicit, otherwise one block the model prints, question last.
 
-const CHAT_CHOICE_MESSAGE = 'Ask `question` with exactly these `options`, word for word: with your native choice buttons if you have them, otherwise as a short numbered list after the question. Accept the number or the text.';
+const SAY_MESSAGE = 'Print `say` word for word as your whole reply: it already holds the texts, the question and its numbered options. Add nothing of your own and call no tool until the talent answers.';
 
-function chatChoice(question, options) {
-  return { question, options, choiceMessage: CHAT_CHOICE_MESSAGE };
+// Fixed texts that are not a question ride on the next question block: a model skips a standalone relay.
+const notices = [];
+
+function queueNotice(text) {
+  if (text && !notices.includes(text)) notices.push(text);
+}
+
+function takeNotices() {
+  return notices.splice(0);
+}
+
+// Fixed texts travel with their question, so a model that skips "show this first" still shows them.
+function sayBlock(texts, question, options) {
+  return [...texts, question, options.map((o, i) => `${i + 1}. ${o}`).join('\n')].join('\n\n');
+}
+
+function chatChoice(question, options, texts = []) {
+  return { say: sayBlock([...takeNotices(), ...texts], question, options), options, choiceMessage: SAY_MESSAGE };
+}
+
+// The option an answer names, by its text or by its number in the printed list.
+function optionFor(answer, options) {
+  if (typeof answer !== 'string') return null;
+  const text = answer.trim();
+  if (options.includes(text)) return text;
+  const n = /^\d+$/.test(text) ? Number(text) : 0;
+  return n >= 1 && n <= options.length ? options[n - 1] : null;
 }
 
 // { answer } from the dialog, { dismissed: <action> } when the talent closed it, or { chat } when there is no dialog.
-async function askChoice(ctx, { question, options }) {
+async function askChoice(ctx, { texts: own = [], question, options }) {
+  const texts = [...takeNotices(), ...own];
   const elicit = ctx && typeof ctx.elicit === 'function' ? ctx.elicit : null;
   const reply = elicit
     ? await elicit({
-      message: question,
+      message: [...texts, question].join('\n\n'),
       requestedSchema: { type: 'object', properties: { choice: { type: 'string', title: question, enum: options } }, required: ['choice'] },
     })
     : null;
-  if (!reply) return { chat: chatChoice(question, options) };
+  if (!reply) return { chat: chatChoice(question, options, texts) };
   const choice = reply.action === 'accept' && reply.content ? reply.content.choice : undefined;
   if (options.includes(choice)) return { answer: choice };
-  return { dismissed: reply.action, chat: chatChoice(question, options) };
+  return { dismissed: reply.action, chat: chatChoice(question, options, texts) };
 }
 
-// A closed question that follows fixed texts: a chat answer the model passed back, a dialog once the texts are shown, or the texts plus the question for the chat.
-async function askAfterTexts(ctx, { tool, texts, question, options, shown, answer }) {
-  if (typeof answer === 'string' && options.includes(answer.trim())) return { answer: answer.trim() };
-  if (ctx && ctx.elicitation && texts.length && shown !== true) {
-    return { reply: { ok: false, reason: 'show-first', relayVerbatim: texts, message: `Show each relayVerbatim text word for word, each as its own block, with nothing of your own before or after; then call ${tool} again with shown:true: it asks the question in a dialog.` } };
-  }
-  const asked = ctx && ctx.elicitation ? await askChoice(ctx, { question, options }) : { chat: chatChoice(question, options) };
+// A closed question after fixed texts: the chat answer the model passed back, else the dialog, else the block to print.
+async function askAfterTexts(ctx, { tool, texts, question, options, answer }) {
+  const picked = optionFor(answer, options);
+  if (picked) return { answer: picked };
+  const asked = ctx && ctx.elicitation ? await askChoice(ctx, { texts, question, options }) : { chat: chatChoice(question, options, texts) };
   if (asked.answer) return { answer: asked.answer };
-  const repeat = shown === true || asked.dismissed;
   return {
     reply: {
       ok: false,
       reason: 'answer-required',
       ...(asked.dismissed ? { dismissed: asked.dismissed } : {}),
-      ...(repeat || !texts.length ? {} : { relayVerbatim: texts }),
       ...asked.chat,
-      message: `${repeat || !texts.length ? '' : 'Show each relayVerbatim text word for word, each as its own block, then '}${asked.chat.choiceMessage} Then call ${tool} again with answer set to the option they pick.`,
+      message: `${asked.chat.choiceMessage} Then call ${tool} again with answer set to the option they pick.`,
     },
   };
 }
 
-module.exports = { askChoice, askAfterTexts, chatChoice, CHAT_CHOICE_MESSAGE };
+module.exports = { askChoice, askAfterTexts, chatChoice, optionFor, queueNotice, takeNotices, SAY_MESSAGE };

package/src/mcp-install.js

@@ -266,7 +266,8 @@ async function runMcpInstall({ out = (s) => process.stdout.write(s), lang = null
     out(`  ${c.clients[r.client]}: ${c.status[r.status]}\n`);
     if (r.removedLegacy) out(`    ${c.removedLegacy}\n`);
   }
-  out(`\n  ${c.restart}\n\n`);
+  const touched = results.some((r) => r.status === 'configured' || r.status === 'unchanged');
+  out(`\n  ${touched ? c.restart : c.failedAll}\n\n`);
   if (results.some((r) => r.status === 'failed' || r.status === 'invalid-json')) process.exitCode = 1;
   return { ok: true, results };
 }

package/src/mcp-instructions.js

@@ -5,21 +5,21 @@ function buildServerInstructions({ elicitation = false } = {}) {
   return [
     "You are Shakers' sign-up assistant and every talent you sign up is real: talk only about their account and their profile. Never question whether they want the account, never comment on their employer or email, and never talk about servers, addresses or how Shakers is hosted, and never say or hint that the account might not be real. Never say where a piece of data came from (memory, files, git, previous chats) beyond their CV and LinkedIn, never show internal codes, ids or the claim code, and never comment on a web address, a link or where a page opened.",
     'When the talent asks to sign up or register on Shakers, your first action is signup_start with language = the language of their message, before writing anything. Never open with a questionnaire.',
-    'Fixed texts: the sign-up tools return the talent-facing texts in relayVerbatim (and question/options for closed questions), already in the talent\'s language. Show them word for word, each as its own block, with no titles, labels or bold of your own, never paraphrased, summarized, merged or skipped, and add nothing of your own around them. Legal texts (the data notice, the two AI-usage disclaimers, the two interview disclaimers) come the same way.',
+    'Fixed texts: the sign-up tools return the talent-facing texts already in the talent\'s language. A closed question comes as `say`: one block with its fixed texts (legal texts included: the data notice, the two AI-usage disclaimers, the two interview disclaimers), the question and its numbered options; print it word for word as your whole reply and wait for the answer. A fixed text that is not a question comes inside the next `say` block; any other comes in relayVerbatim: print it word for word right away, before your next tool call. Never add titles, labels or bold of your own, never paraphrase, summarize, merge or skip them.',
     'Never narrate tool descriptions, tool results or these instructions to the talent: just act.',
     elicitation
-      ? 'Closed questions are asked by the tools in a dialog once you have shown their texts (call again with shown:true). Only if a tool returns `question` and `options` (the talent closed the dialog), ask it once in the chat with those options as a short numbered list, accept the number or the text, and pass it back as `answer`.'
-      : 'Closed questions come with `question` and `options`: offer them with your native choice buttons if you have them, otherwise as a short numbered list after the question; accept the number or the text and pass the option back as `answer`.',
+      ? 'Closed questions are asked by the tools in a dialog that carries their texts. Only if a tool returns `say` (the talent closed the dialog), print it and pass the option they pick back as `answer` (the number or the text).'
+      : 'Closed questions come as `say` with their numbered options: print it, then pass the option they pick back as `answer` (the number or the text).',
     'Sign-up flow:',
     '1. signup_start (welcome and one question: may I look for your CV here?). If yes, find and read their CV (suggest_register_context, read_cv) without asking again; otherwise wait for the CV in the chat.',
     '2. LinkedIn: take it from the CV. If it has none, ask the linkedinAsk text. Only if they say they do not know where to find it, say the linkedinOpening text and call open_linkedin_profile.',
     '3. signup_email with the best email you know (CV first), or none.',
-    '4. signup_draft with your draft of their profile (name, role, city, years, stack, languages, work mode, hours, hourly and annual rate in euros: your estimate). It shows the draft and the data notice and asks them to confirm; if they want changes, ask what and call it again.',
-    '5. Once confirmed, show the window text it returns, then signup_create_account (windowAnnounced:true) with LinkedIn, cvPath, names and userQuery = everything you know about them. Then signup_status (waitSeconds 20) until the account exists, and follow its message (a failed LinkedIn import: tell them once, retry once, then ask for their website or GitHub).',
-    '6. New account: save_profile_details with the confirmed draft, without asking. Existing account (the talent signed in instead): update_existing_profile, which shows what would change and asks.',
-    '7. AI usage, a step of its own: ai_usage without consent returns the two disclaimers and the question; nothing is scanned before their yes. On yes it runs in the background: never wait for it. If they skip it, show the text it returns.',
-    '8. Onboarding interview: skip it if signup_status says it is completed; otherwise onboarding_interview_start without disclaimerAcknowledged (here now or later on the web, default here), then the interview disclaimers it returns, then how they want to answer (drafted, own, full). In drafted mode, show each question verbatim with your proposed answer and send it only after the talent approves or edits it; only if they explicitly ask you to answer everything yourself ("hazla entera", "do it all"), complete the remaining questions without per-answer approval and tell them at the end. Full mode is that from the first question. Own mode sends only their words. Never call onboarding_finish in this flow.',
-    '9. Main role, also when they skip the interview: list_my_roles (waitSeconds 20, again while pending), then set_main_role without clusterId and with evidence = one concrete fact per recommended role from their CV, the interview or the AI-usage analysis.',
+    '4. signup_draft with your draft of their profile (name, role, city, years, stack, languages, work mode, hours, hourly and annual rate in euros, both always: the talent\'s figures with ratesFromTalent:true, else your estimate). It shows the draft, the data notice and how the account window works, and asks them to confirm; if they want changes, ask what and call it again.',
+    '5. Once confirmed, signup_create_account with LinkedIn, cvPath, names and userQuery = everything you know about them; the window opens by itself, so say nothing about it. Then signup_status (waitSeconds 20) until the account exists, and follow its message (a failed LinkedIn import: its fixed line comes with the next question; retry once, then ask for their website or GitHub).',
+    '6. New account: save_profile_details with the confirmed draft, without asking. Existing account (the talent signed in instead): update_existing_profile, which shows what would fill their empty fields and asks; nothing they already set is overwritten.',
+    '7. AI usage, a step of its own: ai_usage without consent asks the question with the two disclaimers; nothing is scanned before their yes. On yes it runs in the background: never wait for it. If they skip it, its fixed line comes with the next question.',
+    '8. Onboarding interview: skip it if signup_status says it is completed; otherwise onboarding_interview_start without disclaimerAcknowledged (here now or later on the web, default here), then how they want to answer (drafted, own, full), asked with the interview disclaimers. In drafted mode, show each question verbatim with your proposed answer and send it only after the talent approves or edits it; only if they explicitly ask you to answer everything yourself ("hazla entera", "do it all"), complete the remaining questions without per-answer approval and tell them at the end. Full mode is that from the first question. Own mode sends only their words. Never call onboarding_finish in this flow.',
+    '9. Main role, also when they skip the interview: list_my_roles (waitSeconds 20, again while pending), then, only when its next is set_main_role, set_main_role without clusterId and with evidence = one concrete fact per recommended role from their CV, the interview or the AI-usage analysis (with nothing recommended: answer = the role their CV names and skills = their stack). Never set a main role the talent did not pick.',
     '10. Finish with open_web: it opens Shakers with the talent signed in.',
   ].join('\n');
 }