shakers-cli-beta 0.10.3 → 0.10.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shakers-cli-beta",
-  "version": "0.10.3",
+  "version": "0.10.4",
   "description": "Shakers AI usage & skills evaluator: a local-first CLI (`shakers` binary) plus a local MCP server. Commands: ai-usage (scan + classify your AI-tool setup, T0-T7), certify (certify Skills from your code), share (branded LinkedIn card).",
   "type": "commonjs",
   "bin": {

package/src/certify-dimension-client.js

@@ -4,6 +4,7 @@
 
 const { postJsonWithTimeout } = require('./backend-request');
 const { reasonForError } = require('./onboarding-client');
+const { toUpperLang } = require('./lang-codes');
 
 const DEFAULT_TIMEOUT_MS = 20000;
 
@@ -153,9 +154,87 @@ async function discoverOfferableDimensions(deps = {}, { accessToken, hubAccessTo
   return { ok: true, mainRole: mine.mainRole, offerable, unmatched };
 }
 
+async function requestCreateCertificationInterview(
+  { dimensionKey, languageCode, accessToken } = {},
+  { endpoint, timeoutMs = DEFAULT_TIMEOUT_MS } = {},
+) {
+  if (!endpoint) return { ok: false, reason: 'no-endpoint' };
+  if (!dimensionKey) return { ok: false, reason: 'no-dimension' };
+  const body = { dimensionKey };
+  if (languageCode) body.languageCode = toUpperLang(languageCode);
+  let res;
+  try {
+    res = await postJsonWithTimeout(endpoint, body, timeoutMs, 'POST', null, bearerHeaders(accessToken));
+  } catch (e) {
+    return { ok: false, reason: (e && e.kind) || 'network-error' };
+  }
+  if (res.status < 200 || res.status >= 300) {
+    const reason = reasonForError(res.status, res.raw);
+    if (reason !== 'dimension-on-cooldown') return { ok: false, reason };
+    // certs puts the date in the message only: "... available on 2026-10-28T14:50:38.265Z".
+    const available = String(res.raw || '').match(/available on (\d{4}-\d{2}-\d{2}T[\d:.]+Z)/);
+    return { ok: false, reason, availableOn: available ? available[1] : null };
+  }
+  const data = payloadOf(res.raw);
+  const interviewId = pick(data || {}, ['interviewId', 'id']);
+  if (!interviewId) return { ok: false, reason: 'bad-response' };
+  return { ok: true, interviewId, language: pick(data || {}, ['language', 'languageCode']) || null };
+}
+
+// Poll the verdict; a 2xx/404/425/202 with no band yet resolves `ready:false` (retriable).
+async function requestCertificationReport(
+  { interviewId, accessToken } = {},
+  { base, timeoutMs = DEFAULT_TIMEOUT_MS } = {},
+) {
+  if (!base) return { ok: false, reason: 'no-endpoint' };
+  if (!interviewId) return { ok: false, reason: 'no-interview' };
+  const url = `${base.replace(/\/+$/, '')}/${encodeURIComponent(interviewId)}/report`;
+  let res;
+  try {
+    res = await postJsonWithTimeout(url, null, timeoutMs, 'GET', null, bearerHeaders(accessToken));
+  } catch (e) {
+    return { ok: false, reason: (e && e.kind) || 'network-error' };
+  }
+  if (res.status === 404 || res.status === 425 || res.status === 202) return { ok: true, ready: false, report: null };
+  if (res.status < 200 || res.status >= 300) return { ok: false, reason: reasonForError(res.status, res.raw) };
+  const data = payloadOf(res.raw);
+  if (data === undefined || data === null || typeof data !== 'object') return { ok: true, ready: false, report: null };
+  const band = pick(data, ['band', 'level', 'combinedLevel']);
+  // A report with too little evidence for a level has band null; it is still finished.
+  if (!band && !pick(data, ['evaluationId'])) return { ok: true, ready: false, report: null };
+  return { ok: true, ready: true, report: data };
+}
+
+// The case the web preview shows before starting (works `get-dimension-case`): the exercise statement, else the
+// version's brief. `case: null` for a template with neither.
+async function requestDimensionCase(
+  { dimensionKey, accessToken } = {},
+  { base, timeoutMs = DEFAULT_TIMEOUT_MS } = {},
+) {
+  if (!base) return { ok: false, reason: 'no-endpoint' };
+  if (!dimensionKey) return { ok: false, reason: 'no-dimension' };
+  const path = String(dimensionKey).split('/').map(encodeURIComponent).join('/');
+  const url = `${base.replace(/\/+$/, '')}/dimension/${path}/case`;
+  let res;
+  try {
+    res = await postJsonWithTimeout(url, null, timeoutMs, 'GET', null, bearerHeaders(accessToken));
+  } catch (e) {
+    return { ok: false, reason: (e && e.kind) || 'network-error' };
+  }
+  if (res.status < 200 || res.status >= 300) return { ok: false, reason: reasonForError(res.status, res.raw) };
+  const data = payloadOf(res.raw);
+  if (!data || typeof data !== 'object') return { ok: false, reason: 'bad-response' };
+  const text = (value) => (typeof value === 'string' && value.trim() ? value.trim() : null);
+  const brief = text(data.statement) || text(data.candidateBrief);
+  return { ok: true, case: brief ? { brief, testType: text(data.testType) } : null };
+}
+
 module.exports = {
   requestMyCertifications,
   requestTemplatesByDimension,
+  requestCreateCertificationInterview,
+  requestCertificationReport,
+  requestDimensionCase,
   composeDimensionKey,
   composeOfferableDimensions,
   discoverOfferableDimensions,

package/src/certify-dimension-flow.js

@@ -1,15 +1,24 @@
 'use strict';
 
-// `certify` dimension flow: discover -> pick -> hand off to the web interview.
+// `certify` dimension flow: discover -> pick -> create -> LiveKit interview -> poll verdict.
 
 const { runInteractiveMultiSelect } = require('./interactive-select');
 
 function makeCertifyDimensionDeps(overrides = {}) {
   const config = require('./config');
   const client = require('./certify-dimension-client');
+  const onboardingFlow = require('./onboarding-flow');
   return {
-    getTalentProfileUrl: config.getTalentProfileUrl,
+    getCertificationInterviewsEndpoint: config.getCertificationInterviewsEndpoint,
+    // `{certsBase}/interviews` — shared base for LiveKit start/complete + the report poll.
+    getInterviewsBase: config.getOnboardingInterviewsEndpoint,
     discoverOfferableDimensions: (opts) => client.discoverOfferableDimensions({}, opts),
+    requestCreateCertificationInterview: client.requestCreateCertificationInterview,
+    requestCertificationReport: client.requestCertificationReport,
+    requestDimensionCase: client.requestDimensionCase,
+    conductLivekitInterview: onboardingFlow.conductLivekitInterview,
+    onboardingDeps: onboardingFlow.makeDeps(),
+    sleep: (ms) => new Promise((r) => setTimeout(r, ms)),
     ...overrides,
   };
 }
@@ -53,19 +62,51 @@ function resolveDimensionArg(arg, items) {
   return items.find((d) => d.dimensionKey === raw || d.slug === raw) || undefined;
 }
 
-// Deep link into the talent's Shakers web profile, filtered to the chosen dimension.
-// One dimension can publish more than one assessment, so the filtered catalog is the
-// robust target rather than a single templateId.
-function buildWebLink(profileUrl, dimension) {
-  if (!profileUrl || !dimension || !dimension.clusterId || !dimension.slug) return null;
-  let origin;
-  try {
-    origin = new URL(profileUrl).origin;
-  } catch {
-    return null;
+// The evaluation lands one to two minutes after the interview ends, four when the queue is busy.
+async function pollReport(deps, { interviewId, accessToken }, { base, attempts = 60, intervalMs = 5000 } = {}) {
+  for (let i = 0; i < attempts; i++) {
+    const res = await deps.requestCertificationReport({ interviewId, accessToken }, { base });
+    if (!res.ok) return { ok: false, reason: res.reason };
+    if (res.ready) return { ok: true, report: res.report };
+    if (i < attempts - 1) await deps.sleep(intervalMs);
   }
-  const key = `${encodeURIComponent(dimension.clusterId)}/${encodeURIComponent(dimension.slug)}`;
-  return `${origin}/certifications?dimension=${key}`;
+  return { ok: false, reason: 'timeout' };
+}
+
+function formatDay(iso, lang) {
+  const d = iso ? new Date(iso) : null;
+  if (!d || Number.isNaN(d.getTime())) return null;
+  return d.toLocaleDateString(lang === 'en' ? 'en-GB' : 'es-ES', { day: 'numeric', month: 'long', year: 'numeric' });
+}
+
+function renderVerdict(report, cd) {
+  const lines = [];
+  const band = report.band || report.level || report.combinedLevel;
+  const dimension = report.dimensionName || report.dimension || report.dimensionKey;
+  if (dimension) lines.push(cd.verdictDimension(dimension));
+  if (band) lines.push(cd.verdictBand(band));
+  if (typeof report.certified === 'boolean') lines.push(report.certified ? cd.verdictCertified : cd.verdictNotCertified);
+  const summary = report.summary || report.rationale || report.feedback;
+  if (typeof summary === 'string' && summary.trim()) lines.push(summary.trim());
+  const areas = Array.isArray(report.areas) ? report.areas : null;
+  if (areas && areas.length) {
+    for (const a of areas) {
+      const name = a && (a.name || a.area || a.tag);
+      const note = a && (a.note || a.comment);
+      if (name) lines.push(`- ${name}${note ? `: ${note}` : ''}`);
+    }
+  }
+  return lines.join('\n  ');
+}
+
+// The statement is Markdown; the terminal shows it without the emphasis markers.
+function renderCase(dimensionCase, cd) {
+  const brief = dimensionCase.brief.replace(/(\*\*|__)(.+?)\1/g, '$2');
+  const expectations = cd.caseExpectations[dimensionCase.testType];
+  const lines = brief.split('\n');
+  if (expectations) lines.push('', cd.caseExpectationsTitle, ...Object.values(expectations).map((e) => `- ${e}`));
+  lines.push('', cd.caseBeforeStart);
+  return lines.join('\n  ');
 }
 
 async function runCertifyDimension({ io, ask, stdinIsTTY, session, lang, catalog, opts = {}, deps = makeCertifyDimensionDeps() }) {
@@ -116,11 +157,52 @@ async function runCertifyDimension({ io, ask, stdinIsTTY, session, lang, catalog
     }
   }
 
-  const webLink = buildWebLink(deps.getTalentProfileUrl(), chosen);
-  io.notify(cd.webHandoff);
-  if (webLink) io.success(cd.webHandoffLink(webLink));
-  else io.notify(cd.webHandoffNoLink);
-  return { ok: true, handoff: true, dimensionKey: chosen.dimensionKey, webLink };
+  const createEndpoint = deps.getCertificationInterviewsEndpoint();
+  const created = await io.withProgress(cd.creating, () =>
+    deps.requestCreateCertificationInterview(
+      { dimensionKey: chosen.dimensionKey, languageCode: lang, accessToken },
+      { endpoint: createEndpoint },
+    ));
+  if (!created.ok) {
+    io.error(created.reason === 'dimension-on-cooldown'
+      ? cd.onCooldown(formatDay(created.availableOn, lang))
+      : cd.createFailed(created.reason));
+    return { ok: false, reason: created.reason, step: 'create' };
+  }
+
+  // A failed read leaves the run as it was before the case existed, like the web preview does.
+  const caseRead = await deps.requestDimensionCase(
+    { dimensionKey: chosen.dimensionKey, accessToken },
+    { base: deps.getInterviewsBase() },
+  );
+  if (caseRead.ok && caseRead.case) {
+    io.section(cd.caseTitle);
+    io.notify(renderCase(caseRead.case, cd));
+    if (stdinIsTTY) await ask(`  ${cd.caseReadyPrompt}`);
+  }
+
+  const interview = await deps.conductLivekitInterview(io, deps.onboardingDeps, {
+    interviewId: created.interviewId,
+    language: lang,
+    plain: true,
+  });
+  if (!interview.ok) {
+    io.warn(interview.reason === 'needs-web' ? cd.needsWeb : cd.interviewUnavailable(interview.reason));
+    return { ok: false, reason: interview.reason, step: 'interview' };
+  }
+
+  const reportBase = deps.getInterviewsBase();
+  const polled = await io.withProgress(cd.reportPolling, () =>
+    pollReport(deps, { interviewId: created.interviewId, accessToken }, { base: reportBase }));
+  if (!polled.ok) {
+    io.warn(polled.reason === 'timeout' ? cd.reportTimeout : cd.reportFailed(polled.reason));
+    return { ok: true, completed: 'interview', verdict: null };
+  }
+
+  io.section(cd.verdictTitle);
+  io.notify(renderVerdict(polled.report, cd));
+  io.success(cd.done);
+  return { ok: true, completed: 'interview', verdict: polled.report };
 }
 
 module.exports = {
@@ -128,5 +210,7 @@ module.exports = {
   runCertifyDimension,
   chooseDimension,
   resolveDimensionArg,
-  buildWebLink,
+  pollReport,
+  renderVerdict,
+  renderCase,
 };

package/src/config.js

@@ -318,6 +318,14 @@ function getTemplatesByDimensionEndpoint(env = process.env) {
   return base ? `${base}/templates/by-dimension` : null;
 }
 
+// The Talent's assessments with their retry availability (certs, talent Bearer).
+function getMyAssessmentsEndpoint(env = process.env) {
+  const explicit = readEnv(env, 'MY_ASSESSMENTS_ENDPOINT');
+  if (explicit && explicit.trim()) return explicit.trim();
+  const base = getCertsBase(env);
+  return base ? `${base}/users/me/assessments` : null;
+}
+
 // Find Positions list (hub `works/positions/find`, talent Bearer). Serves the
 // All/Recommended/Saved tabs via `criteria.savedByMe`; ordered by match desc.
 function getFindPositionsEndpoint(env = process.env) {
@@ -749,6 +757,7 @@ module.exports = {
   getSetMainRoleEndpoint,
   getAssignedClustersEndpoint,
   getTemplatesByDimensionEndpoint,
+  getMyAssessmentsEndpoint,
   // Find Positions list (`find-projects` command / `find_projects` MCP tool).
   getFindPositionsEndpoint,
   // Marketplace (show-project / save-project / unsave-project / invitations).

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: {
@@ -714,6 +714,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 +724,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:
@@ -1805,26 +1838,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.
@@ -2309,6 +2342,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 +2352,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:

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,
     },