shakers-cli 0.16.0 → 0.17.0

package/src/signup-copy.js

@@ -405,6 +405,177 @@ const COPY = {
   },
 };
 
+const REVIEW = {
+  es: {
+    cliQuestion: '¿Lo subo a tu perfil? [s/N]:',
+    cliIncludeExcerpts: '¿Incluir los extractos de texto? [S/n]:',
+    cliExcludeAgents: 'Si quieres dejar fuera algún agente, escribe sus nombres separados por comas (Enter para ninguno):',
+    cliUnknownAgents: (unknown, known) => `No reconozco: ${unknown}. Los agentes son: ${known}.`,
+    cliRepoHint: 'Para dejar fuera un repositorio, vuelve a ejecutar el comando eligiendo solo los que quieras con --repos.',
+    title: 'Todavía no se ha subido nada a tu perfil de Shakers. Esto es lo que se subiría:',
+    sentTitle: 'Esto es lo que se ha subido:',
+    tools: (list) => `Herramientas de IA detectadas: ${list}.`,
+    technologies: (list) => `Tecnologías de tus proyectos: ${list}.`,
+    activity: (sessions, days) => `Tu actividad con IA: ${sessions === 1 ? '1 sesión' : `${sessions} sesiones`}${days === null ? '' : `, unos ${days} días activos por semana`}.`,
+    repos: (list, commits) => `Repositorios analizados: ${list}. De ellos solo se envían cifras (${commits === 1 ? '1 commit' : `${commits} commits`}, líneas cambiadas, tipos de fichero), nunca su nombre ni su código.`,
+    agents: (list, definitions, summaries) => `Agentes de IA detectados: ${list}. De cada uno se envía ${listOf('es', ['su nombre', 'sus herramientas', 'su modelo', 'de qué agente depende', ...(definitions > 0 ? ['el texto de su definición (sin secretos)'] : []), ...(summaries > 0 ? ['el resumen de lo que hace'] : [])])}.`,
+    excerpts: (conversation, commands) => `Extractos de texto: ${conversation} frases cortas de lo que le pides a la IA y ${commands} comandos, de 200 caracteres como máximo, sin secretos, rutas ni emails.`,
+    noExcerpts: 'Extractos de texto: ninguno.',
+    notSent: 'No se envía: tu código, tus conversaciones completas ni los nombres de tus repositorios.',
+    explanationTitle: 'Qué hace Shakers con esto:',
+    explanation: [
+      'Te sitúa en dos ejes. Configuración: qué tienes montado (herramientas, servidores MCP, agentes), de menos a más: Asistido, Extendido u Orquestado. Uso: cómo diriges a la IA (si le das instrucciones concretas, si revisas lo que propone), de menos a más: Reactivo, Deliberado o Riguroso.',
+      'La configuración se calcula con reglas fijas a partir de lo detectado. El nivel de uso y los textos sobre cómo trabajas los escribe un modelo de IA en los servidores de Shakers.',
+      'En tu perfil aparece la sección «Mi trabajo con IA»: tus dos niveles, tu casilla en la matriz (por ejemplo Practitioner o Architect), tus herramientas y agentes, y dos textos que puedes editar en la web.',
+    ],
+    afterwards: 'Si no estás de acuerdo con el resultado, pulsa «Solicitar revisión humana» en esa sección de la web o escribe a talent@shakersworks.com. Hoy no puedes ocultar la sección tú mismo; para pedir que se borre, escribe a ese mismo correo.',
+    excludeHint: 'Si quieres dejar fuera algún repositorio, algún agente o los extractos de texto, dímelo al responder.',
+    question: '¿Lo subo a tu perfil?',
+    yes: 'Subir a mi perfil',
+    no: 'No subir',
+    formExcerpts: 'Incluir los extractos de texto',
+    formRepo: (name) => `Incluir el repositorio ${name}`,
+    formAgent: (name) => `Incluir el agente ${name}`,
+    declined: 'No se ha subido nada. El análisis se queda solo en tu equipo.',
+    nothingLeft: 'Has dejado fuera todos los repositorios, así que no se ha subido nada.',
+    throttled: 'Ya subiste un análisis hace menos de una hora, así que no se ha subido nada. Puedes volver a intentarlo más tarde.',
+    uploaded: 'Subido a tu perfil. Shakers lo está evaluando y el resultado tarda unos minutos.',
+    uploadFailed: 'No se ha podido subir. Tu análisis se queda solo en tu equipo; puedes volver a intentarlo más tarde.',
+    resultTitle: 'Tu resultado en «Mi trabajo con IA»:',
+    setupLevel: (level) => `Configuración: ${level}.`,
+    usageLevel: (level) => `Uso: ${level}.`,
+    cell: (name) => `Tu casilla en la matriz: ${name}.`,
+    levels: { ASSISTED: 'Asistido', EXTENDED: 'Extendido', ORCHESTRATED: 'Orquestado', REACTIVE: 'Reactivo', DELIBERATE: 'Deliberado', RIGOROUS: 'Riguroso' },
+    resultPending: 'Tu resultado todavía no está en «Mi trabajo con IA». Si acabas de subir tu análisis, aparecerá en unos minutos.',
+  },
+  en: {
+    cliQuestion: 'Shall I upload it to your profile? [y/N]:',
+    cliIncludeExcerpts: 'Include the text excerpts? [Y/n]:',
+    cliExcludeAgents: 'If you want to leave out an agent, type their names separated by commas (Enter for none):',
+    cliUnknownAgents: (unknown, known) => `I do not recognise: ${unknown}. The agents are: ${known}.`,
+    cliRepoHint: 'To leave out a repository, run the command again choosing only the ones you want with --repos.',
+    title: 'Nothing has been uploaded to your Shakers profile yet. This is what would be uploaded:',
+    sentTitle: 'This is what was uploaded:',
+    tools: (list) => `AI tools detected: ${list}.`,
+    technologies: (list) => `Technologies in your projects: ${list}.`,
+    activity: (sessions, days) => `Your AI activity: ${sessions === 1 ? '1 session' : `${sessions} sessions`}${days === null ? '' : `, about ${days} active days a week`}.`,
+    repos: (list, commits) => `Repositories analysed: ${list}. Only figures about them are sent (${commits === 1 ? '1 commit' : `${commits} commits`}, lines changed, file types), never their name or their code.`,
+    agents: (list, definitions, summaries) => `AI agents detected: ${list}. For each one we send ${listOf('en', ['its name', 'its tools', 'its model', 'which agent it reports to', ...(definitions > 0 ? ['the text of its definition (with secrets removed)'] : []), ...(summaries > 0 ? ['the summary of what it does'] : [])])}.`,
+    excerpts: (conversation, commands) => `Text excerpts: ${conversation} short sentences of what you ask the AI and ${commands} commands, 200 characters at most, with secrets, paths and emails removed.`,
+    noExcerpts: 'Text excerpts: none.',
+    notSent: 'Not sent: your code, your full conversations or the names of your repositories.',
+    explanationTitle: 'What Shakers does with it:',
+    explanation: [
+      'It places you on two axes. Setup: what you have in place (tools, MCP servers, agents), from less to more: Assisted, Extended or Orchestrated. Usage: how you steer the AI (whether you give it concrete instructions, whether you review what it proposes), from less to more: Reactive, Deliberate or Rigorous.',
+      'Setup is worked out with fixed rules from what was detected. The usage level and the texts about how you work are written by an AI model on Shakers servers.',
+      'Your profile shows the "My work with AI" section: your two levels, your square in the matrix (for example Practitioner or Architect), your tools and agents, and two texts you can edit on the web.',
+    ],
+    afterwards: 'If you disagree with the result, press "Request human review" in that section on the web or write to talent@shakersworks.com. Today you cannot hide the section yourself; to ask for it to be deleted, write to that same address.',
+    excludeHint: 'If you want to leave out a repository, an agent or the text excerpts, tell me when you answer.',
+    question: 'Shall I upload it to your profile?',
+    yes: 'Upload to my profile',
+    no: 'Do not upload',
+    formExcerpts: 'Include the text excerpts',
+    formRepo: (name) => `Include the repository ${name}`,
+    formAgent: (name) => `Include the agent ${name}`,
+    declined: 'Nothing was uploaded. The analysis stays on your computer only.',
+    nothingLeft: 'You left out every repository, so nothing was uploaded.',
+    throttled: 'You uploaded an analysis less than an hour ago, so nothing was uploaded. You can try again later.',
+    uploaded: 'Uploaded to your profile. Shakers is evaluating it and the result takes a few minutes.',
+    uploadFailed: 'It could not be uploaded. Your analysis stays on your computer only; you can try again later.',
+    resultTitle: 'Your result in "My work with AI":',
+    setupLevel: (level) => `Setup: ${level}.`,
+    usageLevel: (level) => `Usage: ${level}.`,
+    cell: (name) => `Your square in the matrix: ${name}.`,
+    levels: { ASSISTED: 'Assisted', EXTENDED: 'Extended', ORCHESTRATED: 'Orchestrated', REACTIVE: 'Reactive', DELIBERATE: 'Deliberate', RIGOROUS: 'Rigorous' },
+    resultPending: 'Your result is not in "My work with AI" yet. If you have just uploaded your analysis, it will show in a few minutes.',
+  },
+  it: {
+    cliQuestion: 'Lo carico sul tuo profilo? [s/N]:',
+    cliIncludeExcerpts: 'Includere gli estratti di testo? [S/n]:',
+    cliExcludeAgents: 'Se vuoi escludere un agente, scrivi i nomi separati da virgole (Invio per nessuno):',
+    cliUnknownAgents: (unknown, known) => `Non riconosco: ${unknown}. Gli agenti sono: ${known}.`,
+    cliRepoHint: 'Per escludere un repository, esegui di nuovo il comando scegliendo solo quelli che vuoi con --repos.',
+    title: "Non è stato ancora caricato nulla sul tuo profilo Shakers. Ecco cosa verrebbe caricato:",
+    sentTitle: "Ecco cosa è stato caricato:",
+    tools: (list) => `Strumenti di IA rilevati: ${list}.`,
+    technologies: (list) => `Tecnologie dei tuoi progetti: ${list}.`,
+    activity: (sessions, days) => `La tua attività con l'IA: ${sessions === 1 ? '1 sessione' : `${sessions} sessioni`}${days === null ? '' : `, circa ${days} giorni attivi a settimana`}.`,
+    repos: (list, commits) => `Repository analizzati: ${list}. Di questi si inviano solo cifre (${commits} commit, righe modificate, tipi di file), mai il nome né il codice.`,
+    agents: (list, definitions, summaries) => `Agenti di IA rilevati: ${list}. Di ognuno si inviano ${listOf('it', ['il nome', 'gli strumenti', 'il modello', 'da quale agente dipende', ...(definitions > 0 ? ['il testo della sua definizione (senza segreti)'] : []), ...(summaries > 0 ? ['il riassunto di ciò che fa'] : [])])}.`,
+    excerpts: (conversation, commands) => `Estratti di testo: ${conversation} frasi brevi di ciò che chiedi all'IA e ${commands} comandi, al massimo 200 caratteri, senza segreti, percorsi né email.`,
+    noExcerpts: 'Estratti di testo: nessuno.',
+    notSent: 'Non si inviano: il tuo codice, le tue conversazioni complete né i nomi dei tuoi repository.',
+    explanationTitle: 'Cosa fa Shakers con questi dati:',
+    explanation: [
+      "Ti colloca su due assi. Configurazione: cosa hai impostato (strumenti, server MCP, agenti), dal meno al più: Assistito, Esteso o Orchestrato. Uso: come guidi l'IA (se le dai istruzioni concrete, se controlli ciò che propone), dal meno al più: Reattivo, Deliberato o Rigoroso.",
+      "La configurazione si calcola con regole fisse da ciò che è stato rilevato. Il livello di uso e i testi su come lavori li scrive un modello di IA sui server di Shakers.",
+      "Sul tuo profilo compare la sezione «Il mio lavoro con l'IA»: i tuoi due livelli, la tua casella nella matrice (per esempio Practitioner o Architect), i tuoi strumenti e agenti, e due testi che puoi modificare sul sito.",
+    ],
+    afterwards: 'Se non sei d\'accordo con il risultato, premi «Richiedi una revisione umana» in quella sezione del sito o scrivi a talent@shakersworks.com. Oggi non puoi nascondere la sezione da solo; per chiedere che venga cancellata, scrivi allo stesso indirizzo.',
+    excludeHint: 'Se vuoi escludere un repository, un agente o gli estratti di testo, dimmelo quando rispondi.',
+    question: 'Lo carico sul tuo profilo?',
+    yes: 'Carica sul mio profilo',
+    no: 'Non caricare',
+    formExcerpts: 'Includi gli estratti di testo',
+    formRepo: (name) => `Includi il repository ${name}`,
+    formAgent: (name) => `Includi l'agente ${name}`,
+    declined: "Non è stato caricato nulla. L'analisi resta solo sul tuo computer.",
+    nothingLeft: 'Hai escluso tutti i repository, quindi non è stato caricato nulla.',
+    throttled: "Hai caricato un'analisi meno di un'ora fa, quindi non è stato caricato nulla. Puoi riprovare più tardi.",
+    uploaded: 'Caricato sul tuo profilo. Shakers lo sta valutando e il risultato richiede qualche minuto.',
+    uploadFailed: 'Non è stato possibile caricarlo. La tua analisi resta solo sul tuo computer; puoi riprovare più tardi.',
+    resultTitle: "Il tuo risultato in «Il mio lavoro con l'IA»:",
+    setupLevel: (level) => `Configurazione: ${level}.`,
+    usageLevel: (level) => `Uso: ${level}.`,
+    cell: (name) => `La tua casella nella matrice: ${name}.`,
+    levels: { ASSISTED: 'Assistito', EXTENDED: 'Esteso', ORCHESTRATED: 'Orchestrato', REACTIVE: 'Reattivo', DELIBERATE: 'Deliberato', RIGOROUS: 'Rigoroso' },
+    resultPending: "Il tuo risultato non è ancora in «Il mio lavoro con l'IA». Se hai appena caricato la tua analisi, comparirà tra qualche minuto.",
+  },
+  pt: {
+    cliQuestion: 'Carrego-o no seu perfil? [s/N]:',
+    cliIncludeExcerpts: 'Incluir os excertos de texto? [S/n]:',
+    cliExcludeAgents: 'Se quiser deixar de fora algum agente, escreva os nomes separados por vírgulas (Enter para nenhum):',
+    cliUnknownAgents: (unknown, known) => `Não reconheço: ${unknown}. Os agentes são: ${known}.`,
+    cliRepoHint: 'Para deixar de fora um repositório, volte a executar o comando escolhendo só os que quiser com --repos.',
+    title: 'Ainda não foi carregado nada no seu perfil da Shakers. Isto é o que seria carregado:',
+    sentTitle: 'Isto é o que foi carregado:',
+    tools: (list) => `Ferramentas de IA detetadas: ${list}.`,
+    technologies: (list) => `Tecnologias dos seus projetos: ${list}.`,
+    activity: (sessions, days) => `A sua atividade com IA: ${sessions === 1 ? '1 sessão' : `${sessions} sessões`}${days === null ? '' : `, cerca de ${days} dias ativos por semana`}.`,
+    repos: (list, commits) => `Repositórios analisados: ${list}. Deles só se enviam números (${commits === 1 ? '1 commit' : `${commits} commits`}, linhas alteradas, tipos de ficheiro), nunca o nome nem o código.`,
+    agents: (list, definitions, summaries) => `Agentes de IA detetados: ${list}. De cada um envia-se ${listOf('pt', ['o nome', 'as ferramentas', 'o modelo', 'de que agente depende', ...(definitions > 0 ? ['o texto da sua definição (sem segredos)'] : []), ...(summaries > 0 ? ['o resumo do que faz'] : [])])}.`,
+    excerpts: (conversation, commands) => `Excertos de texto: ${conversation} frases curtas do que pede à IA e ${commands} comandos, com 200 caracteres no máximo, sem segredos, caminhos nem emails.`,
+    noExcerpts: 'Excertos de texto: nenhum.',
+    notSent: 'Não se envia: o seu código, as suas conversas completas nem os nomes dos seus repositórios.',
+    explanationTitle: 'O que a Shakers faz com isto:',
+    explanation: [
+      'Situa-o em dois eixos. Configuração: o que tem montado (ferramentas, servidores MCP, agentes), de menos para mais: Assistido, Estendido ou Orquestrado. Uso: como orienta a IA (se lhe dá instruções concretas, se revê o que propõe), de menos para mais: Reativo, Deliberado ou Rigoroso.',
+      'A configuração calcula-se com regras fixas a partir do que foi detetado. O nível de uso e os textos sobre como trabalha são escritos por um modelo de IA nos servidores da Shakers.',
+      'No seu perfil aparece a secção «Meu trabalho com IA»: os seus dois níveis, a sua casa na matriz (por exemplo Practitioner ou Architect), as suas ferramentas e agentes, e dois textos que pode editar na web.',
+    ],
+    afterwards: 'Se não concordar com o resultado, carregue em «Solicitar revisão humana» nessa secção da web ou escreva para talent@shakersworks.com. Hoje não pode ocultar a secção sozinho; para pedir que seja apagada, escreva para esse mesmo endereço.',
+    excludeHint: 'Se quiser deixar de fora algum repositório, algum agente ou os excertos de texto, diga-me ao responder.',
+    question: 'Carrego-o no seu perfil?',
+    yes: 'Carregar no meu perfil',
+    no: 'Não carregar',
+    formExcerpts: 'Incluir os excertos de texto',
+    formRepo: (name) => `Incluir o repositório ${name}`,
+    formAgent: (name) => `Incluir o agente ${name}`,
+    declined: 'Não foi carregado nada. A análise fica só no seu computador.',
+    nothingLeft: 'Deixou de fora todos os repositórios, por isso não foi carregado nada.',
+    throttled: 'Carregou uma análise há menos de uma hora, por isso não foi carregado nada. Pode tentar mais tarde.',
+    uploaded: 'Carregado no seu perfil. A Shakers está a avaliá-lo e o resultado demora alguns minutos.',
+    uploadFailed: 'Não foi possível carregá-lo. A sua análise fica só no seu computador; pode tentar mais tarde.',
+    resultTitle: 'O seu resultado em «Meu trabalho com IA»:',
+    setupLevel: (level) => `Configuração: ${level}.`,
+    usageLevel: (level) => `Uso: ${level}.`,
+    cell: (name) => `A sua casa na matriz: ${name}.`,
+    levels: { ASSISTED: 'Assistido', EXTENDED: 'Estendido', ORCHESTRATED: 'Orquestrado', REACTIVE: 'Reativo', DELIBERATE: 'Deliberado', RIGOROUS: 'Rigoroso' },
+    resultPending: 'O seu resultado ainda não está em «Meu trabalho com IA». Se acabou de carregar a sua análise, vai aparecer dentro de alguns minutos.',
+  },
+};
+
 function toSignupLanguage(code) {
   const base = String(code || '').toLowerCase().split(/[-_]/)[0];
   return SIGNUP_LANGUAGES.includes(base) ? base : null;
@@ -418,6 +589,10 @@ function legalCopy(lang) {
   return LEGAL[toSignupLanguage(lang) || 'en'];
 }
 
+function reviewCopy(lang) {
+  return REVIEW[toSignupLanguage(lang) || 'en'];
+}
+
 // The profile draft the talent confirms before the account exists: one line per group, empty parts left out.
 function renderDraft(lang, d = {}) {
   const c = signupCopy(lang);
@@ -447,4 +622,4 @@ function renderRole(lang, { name, source, evidence, openProjects, recommended })
   ].filter(Boolean).join('\n');
 }
 
-module.exports = { SIGNUP_LANGUAGES, LEGAL, signupCopy, legalCopy, toSignupLanguage, renderDraft, renderRole, amount };
+module.exports = { SIGNUP_LANGUAGES, LEGAL, REVIEW, signupCopy, legalCopy, reviewCopy, toSignupLanguage, renderDraft, renderRole, amount };

package/src/stdin-ask.js

@@ -126,4 +126,16 @@ function createStdinAsk({ onInterrupt } = {}) {
   return ask;
 }
 
-module.exports = { createStdinAsk, createLineQueueAsk };
+function createLazyStdinAsk() {
+  let real = null;
+  const open = () => { real = real || createStdinAsk(); return real; };
+  const ask = (question) => open()(question);
+  ask.secret = (question) => open().secret(question);
+  ask.drain = () => { if (real) real.drain(); };
+  ask.close = () => { if (real) real.close(); };
+  ask.suspend = () => { if (real) real.suspend(); };
+  ask.resume = () => { if (real) real.resume(); };
+  return ask;
+}
+
+module.exports = { createStdinAsk, createLazyStdinAsk, createLineQueueAsk };

package/src/usage-run-steps.js

@@ -8,6 +8,7 @@ const {
   getConsentDecision,
   autoShare,
   consentPath,
+  isThrottled,
 } = require('./share');
 const { runConsentPrompt } = require('./consent-flow');
 const { createStdinAsk } = require('./stdin-ask');
@@ -22,8 +23,10 @@ const { withSpinner } = require('./terminal-progress');
 const { computeConsentSkip } = require('./consent-skip');
 const { collectIdentityAndUsage, storedAiConsent, reanchorReusedGrant } = require('./usage-scan');
 const { doBuildNextLevel } = require('./usage-oneshot-commands');
+const { uploadFacts, withoutExcluded, summaryText, explanationText } = require('./ai-usage-review');
+const { reviewCopy } = require('./signup-copy');
+const { askYesNo } = require('./consent-flow');
 
-// Automatic, silent PERSISTING once consent is `granted` (consent controls persistence only, never what's shown).
 async function maybeAutoShare(report, maturity, root, catalog, { bypassThrottle = false } = {}) {
   try {
     const result = await autoShare(report, maturity, { root, bypassThrottle });
@@ -103,7 +106,54 @@ async function resolveAiConsent({ opts, catalog, gate, injectedAsk }) {
   return aiConsentGranted;
 }
 
-async function renderAndFinalize({ report, maturity, lang, opts, root, gate, catalog, bypassThrottle = false }) {
+function matchNames(raw, known) {
+  const wanted = String(raw || '').split(',').map((x) => x.trim()).filter(Boolean);
+  const byLower = new Map(known.map((name) => [name.toLowerCase(), name]));
+  return {
+    matched: wanted.map((w) => byLower.get(w.toLowerCase())).filter(Boolean),
+    unknown: wanted.filter((w) => !byLower.has(w.toLowerCase())),
+  };
+}
+
+async function askExcludedAgents(ask, c, known, out) {
+  for (let attempt = 0; attempt < 3; attempt += 1) {
+    const { matched, unknown } = matchNames(await ask(c.cliExcludeAgents), known);
+    if (unknown.length === 0) return matched;
+    out.write(`  ${c.cliUnknownAgents(unknown.join(', '), known.join(', '))}\n`);
+  }
+  return null;
+}
+
+async function reviewUpload({ report, maturity, repos = [], lang, catalog, injectedAsk = null, out = process.stdout, bypassThrottle = false }) {
+  const state = loadConsentState();
+  if (getConsentDecision(state) !== 'granted' || !state || state.emailVerified === false || !state.email || (!bypassThrottle && isThrottled(state))) {
+    return { approved: true, report, maturity };
+  }
+  const c = reviewCopy(lang);
+  const facts = uploadFacts({ report, maturity, repos });
+  out.write(`\n${summaryText(lang, facts)}\n\n${explanationText(lang)}\n\n`);
+  if (facts.repos.length > 1) out.write(`${c.cliRepoHint}\n\n`);
+  const ask = injectedAsk || createStdinAsk();
+  try {
+    const approved = await askYesNo(ask, c.cliQuestion, catalog, { defaultNo: true });
+    if (!approved) {
+      out.write(`  ${c.declined}\n`);
+      return { approved: false };
+    }
+    const agents = facts.agents.length > 0 ? await askExcludedAgents(ask, c, facts.agents, out) : [];
+    if (agents === null) {
+      out.write(`  ${c.declined}\n`);
+      return { approved: false };
+    }
+    const hasExcerpts = facts.conversationExcerpts + facts.commandExcerpts > 0;
+    const excerpts = hasExcerpts ? (await askYesNo(ask, c.cliIncludeExcerpts, catalog, { defaultYes: true })) === true : true;
+    return { approved: true, ...withoutExcluded(report, { agents, excerpts }) };
+  } finally {
+    if (!injectedAsk) ask.close();
+  }
+}
+
+async function renderAndFinalize({ report, maturity, lang, opts, root, gate, catalog, bypassThrottle = false, repos = [], injectedAsk = null }) {
   if (opts.json) {
     process.stdout.write(JSON.stringify({ report, maturity }, null, 2) + '\n');
     return;
@@ -133,8 +183,10 @@ async function renderAndFinalize({ report, maturity, lang, opts, root, gate, cat
     doBuildNextLevel(root, maturity, opts.force, catalog);
   }
 
-  // Auto-send at the end (bypassThrottle only true on the register path).
-  const shareResult = await maybeAutoShare(report, maturity, root, catalog, { bypassThrottle });
+  const reviewed = await reviewUpload({ report, maturity, repos, lang, catalog, injectedAsk, bypassThrottle });
+  if (!reviewed.approved) return;
+  const shareResult = await maybeAutoShare(reviewed.report, reviewed.maturity, root, catalog, { bypassThrottle });
+  if (shareResult && shareResult.ok) process.stdout.write(`\n  ${reviewCopy(lang).afterwards}\n`);
 
   // "My work with AI" preview, best-effort after the send; never blocks/breaks the run.
   await maybeRenderAiProfile({ report, maturity, lang, root, save: opts.save, submitOk: !!(shareResult && shareResult.ok), catalog });
@@ -194,6 +246,7 @@ async function maybeRenderAiProfile({ report, maturity, lang, root, save, submit
 }
 
 module.exports = {
+  reviewUpload,
   prepareIdentityAndUsage,
   resolveAiConsent,
   renderAndFinalize,

package/src/usage-scan.js

@@ -124,9 +124,10 @@ async function runModelCalls({
   const willAttemptSynthesis = aiConsentGranted && hasAgents && !!getSynthesisEndpoint();
   const willAttemptEvaluation = aiConsentGranted && hasAgents && !!getAgentEvaluationEndpoint();
   const roadmapEntryForTier = maturity.tierKey ? getRoadmapEntry(maturity.tierKey, lang) : null;
+  const roadmapRequested = opts.roadmap === true && gate.showRoadmap;
   const willAttemptRoadmapPersonalization =
     aiConsentGranted
-    && gate.showRoadmap
+    && roadmapRequested
     && !!roadmapEntryForTier && !roadmapEntryForTier.maxTier
     && !!getRoadmapEndpoint();
 
@@ -151,7 +152,7 @@ async function runModelCalls({
       )
       : null;
     // `runPhase` runs `call()` whether or not a spinner is shown, so gating the roadmap CANNOT be done by flipping `willAttempt` — that only hides the spinner.
-    roadmapPersonalization = gate.showRoadmap
+    roadmapPersonalization = roadmapRequested
       ? await runPhase(
         willAttemptRoadmapPersonalization,
         catalog.cli.personalizingRoadmapLabel,
@@ -183,8 +184,7 @@ async function computeUsage({
   // 1. Local scan + classify (always computed and shown).
   const { report, root, rootDir } = performScan({ opts, catalog });
 
-  // 2. Identity gate + local agent-usage signal. Roadmap only for anonymous runs
-  //    (gate.showRoadmap = !loggedIn) AND never during register/onboarding.
+  // 2. Identity gate + local agent-usage signal.
   const { gate: identityGate } = prepareIdentity({ report, catalog, quiet: opts.json === true });
   const gate = (inRegistration && identityGate.showRoadmap)
     ? { ...identityGate, showRoadmap: false }
@@ -212,15 +212,15 @@ async function computeUsage({
   await runModelCalls({
     report, maturity, aiConsentGranted, opts, gate, hasAgents, agentRoots, rootDir, lang, catalog,
   });
-  return { report, maturity, root, gate };
+  return { report, maturity, root, gate, repos: scope.toplevels };
 }
 
 // The MCP's scan: same steps, returned instead of printed, since stdout is its JSON-RPC channel.
 async function scanUsage(argv) {
-  const opts = parseArgs(argv);
+  const opts = { ...parseArgs(argv), roadmap: false };
   const lang = opts.lang || detectReportLang();
-  const { report, maturity } = await computeUsage({ opts, catalog: getCatalog(lang), lang });
-  return { report, maturity };
+  const { report, maturity, repos } = await computeUsage({ opts, catalog: getCatalog(lang), lang });
+  return { report, maturity, repos };
 }
 
 module.exports = {