shakers-cli 0.15.0 → 0.17.0

package/src/interactive-select.js

@@ -3,7 +3,7 @@
 const { palette, styleQuestion } = require('./ansi');
 const { BRAND_ANSI } = require('./brand-ansi');
 
-// Zero-dependency interactive multi-select (skill-code-certification, issue 011).
+// Zero-dependency interactive multi-select.
 
 // COLOUR goes through the one gate (src/ansi.js).
 const ANSI = palette({

package/src/interview-client.js

@@ -100,7 +100,7 @@ class InterviewClient {
 
     // The end of the interview is a protocol message, not a sentence: matching the
     // goodbye text never fired (certs sends no closingMessage), so the CLI kept
-    // asking for answers until its turn-timeout (new-works, 2026-09-25).
+    // asking for answers until its turn-timeout.
     if (RoomEvent && RoomEvent.DataReceived && typeof room.on === 'function') {
       room.on(RoomEvent.DataReceived, (payload, _participant, _kind, topic) => {
         if (topic !== PROTOCOL_TOPIC) return;
@@ -216,8 +216,13 @@ class InterviewClient {
   }
 }
 
+function createInterviewClient(opts) {
+  return new InterviewClient(opts);
+}
+
 module.exports = {
   InterviewClient,
+  createInterviewClient,
   LiveKitNotInstalledError,
   loadLiveKitSdk,
   CHAT_TOPIC,

package/src/interview-transcript.js

@@ -4,7 +4,7 @@
 
 // Upper case: certs validates the role against its AGENT/USER enum and 400s the
 // whole PATCH otherwise, so every terminal onboarding lost its transcript
-// ("no se pudo guardar la transcripcion (http-400)", new-works 2026-09-25).
+// ("no se pudo guardar la transcripcion (http-400)").
 const ROLE_AGENT = 'AGENT';
 const ROLE_USER = 'USER';
 

package/src/legal-notice.js

@@ -1,6 +1,6 @@
 'use strict';
 
-// Shared PRESENTATION for the CLI's legal/consent disclosures (talents-ai-score).
+// Shared PRESENTATION for the CLI's legal/consent disclosures.
 
 const { palette, colorEnabled } = require('./ansi');
 const { BRAND_ANSI } = require('./brand-ansi');

package/src/maturity.js

@@ -12,7 +12,7 @@ const LEVELS = [
   { level: 4, key: 'orchestrator', name: 'Orquestador', emoji: '●' },
 ];
 
-// DECISION (talents-ai-score, signal expansion): the level definitions (LEVELS, HANDOFF §4) have NOT been touched.
+// DECISION: the level definitions (LEVELS) have NOT been touched.
 function depthTotals(tools) {
   let instructions = 0; // project instructions/rules files
   let mcp = 0; // configured MCP servers
@@ -30,7 +30,7 @@ function depthTotals(tools) {
   return { instructions, mcp, custom, hooks };
 }
 
-// Score model 0-100 for the visual meter — RECALIBRATED (ADR-008, skill-code-certification).
+// Score model 0-100 for the visual meter — RECALIBRATED.
 const SCORE_MODEL = [
   { key: 'breadth', weight: 12, full: 3 }, // number of AI tools detected
   { key: 'context', weight: 16, full: 2 }, // instructions + config files
@@ -61,7 +61,7 @@ function classify(report) {
       ? report.agentCounts.agents
       : 0;
 
-  // Score scope reverted to PROJECT ∪ HOME (skill-code-certification / ADR-010, which reverts ADR-009).
+  // Score scope reverted to PROJECT ∪ HOME.
   const score = computeScore({
     breadth,
     context: d.instructions, // depthTotals already folds `config` into instructions
@@ -72,7 +72,7 @@ function classify(report) {
     multiAgent: agentCount,
   });
 
-  // Band 0-4 derived from the tier engine (issue 019, single source of truth).
+  // Band 0-4 derived from the tier engine (single source of truth).
   const tierResult = computeTierResult(report);
   const level = tierResult.band;
   const meta = LEVELS[level];
@@ -87,11 +87,11 @@ function classify(report) {
     depth: d,
     hasAgentic,
     next: nextStep(level, { breadth, ...d, hasAgentic }),
-    // Tier (T0-T7, issue 019): the fine-grained axis the band is derived from.
+    // Tier (T0-T7): the fine-grained axis the band is derived from.
     tier: tierResult.tier,
     tierKey: tierResult.tierKey,
     tierName: tierResult.tierName,
-    // Setup Level (ADR-016): the 3-value rollup shown to the talent, derived
+    // Setup Level: the 3-value rollup shown to the talent, derived
     // from the tier. `{key, code, rank, emoji}`; label localized via i18n.
     setupLevel: tierResult.setupLevel,
   };

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

@@ -52,6 +52,8 @@ async function pollClassifiedInventory({
   }
 }
 
+const RESULT_MESSAGE = 'Print relayVerbatim word for word: the result in "My work with AI", what it means and how to ask for a human review.';
+const PROFILE_PENDING_MESSAGE = 'The profile result is not ready yet: call ai_usage_result again in a few minutes.';
 const READY_MESSAGE = 'Shakers finished classifying the agents.';
 const PENDING_MESSAGE = 'Shakers is still classifying the agents — this is normal, call ai_usage_result again shortly to keep waiting.';
 
@@ -65,6 +67,12 @@ function makeAiUsageResultTool(deps = {}) {
     now = () => Date.now(),
     intervalMs = POLL_INTERVAL_MS,
     capMs = POLL_CAP_MS,
+    resolveAiProfilePreview = require('./ai-profile-preview').resolveAiProfilePreview,
+    getAiProfileEndpoint = require('./config').getAiProfileEndpoint,
+    ensureFreshSession = require('./session-refresh').ensureFreshSession,
+    aiProfileWaitMs = 30000,
+    resultText = require('./ai-usage-review').resultText,
+    lang = () => require('./signup-language').signupLanguage(require('./i18n').detectFlowLang()),
   } = deps;
 
   async function handler() {
@@ -77,27 +85,41 @@ function makeAiUsageResultTool(deps = {}) {
       throw new Error('discovered-inventory endpoint is not configured (set SHAKERS_CLI_INGEST_ENDPOINT).');
     }
 
-    const result = await pollClassifiedInventory({
-      accessToken: session.accessToken,
-      endpoint,
-      requestDiscoveredInventory,
-      sleep,
-      now,
-      intervalMs,
-      capMs,
-    });
+    const [result, aiProfile] = await Promise.all([
+      pollClassifiedInventory({
+        accessToken: session.accessToken,
+        endpoint,
+        requestDiscoveredInventory,
+        sleep,
+        now,
+        intervalMs,
+        capMs,
+      }),
+      resolveAiProfilePreview(
+        { session, endpoint: getAiProfileEndpoint(), timeoutMs: aiProfileWaitMs },
+        {
+          refreshToken: async () => {
+            const fresh = await ensureFreshSession(process.env);
+            return fresh ? { accessToken: fresh.accessToken, hubAccessToken: fresh.hubAccessToken } : null;
+          },
+        },
+      ).catch(() => ({ status: 'unavailable', preview: null })),
+    ]);
+    const profileReady = aiProfile.status === 'ready';
     return {
       ...result,
-      message: result.status === 'ready' ? READY_MESSAGE : PENDING_MESSAGE,
+      aiProfile,
+      relayVerbatim: resultText(lang(), profileReady ? aiProfile.preview : null),
+      message: `${RESULT_MESSAGE} ${result.status === 'ready' ? READY_MESSAGE : PENDING_MESSAGE}${profileReady ? '' : ` ${PROFILE_PENDING_MESSAGE}`}`,
     };
   }
 
   return {
     name: 'ai_usage_result',
     title: 'Results of your AI analysis',
-    description: 'Fetches from Shakers the description of each AI agent found in the analysis you approved. It reads nothing on this computer.',
+    description: 'Fetches from Shakers the result of the AI analysis you approved, what it means, and the description of each AI agent found. It reads nothing on this computer.',
     guidance:
-      "Retrieve the enriched Shakers classification for the talent's agents after ai_usage. Shakers classifies agents and writes their descriptions server-side (no client LLM), so this reads the result: per agent { name, tools, model, category, role, level, code, whatItDoes }. Session-keyed, no arguments. Server-side classification can take a few minutes, so this does a bounded internal poll (~90s max, never a long-held call): returns { status: 'ready', agents } once every agent has been classified, or { status: 'pending', agents } while Shakers is still processing (call it again to keep waiting — 'pending' is normal progress, not an error). Present agents to the talent by NAME and category/role only; the `code` field is an internal handle for add_agent, never show it. Requires an active session.",
+      "Retrieve the result after an approved upload: relayVerbatim is the 'My work with AI' result with its levels and explanation in plain words, and how to ask for a human review; print it word for word. It also returns the enriched Shakers classification for the talent's agents. Shakers classifies agents and writes their descriptions server-side (no client LLM), so this reads the result: per agent { name, tools, model, category, role, level, code, whatItDoes }. Session-keyed, no arguments. Server-side classification can take a few minutes, so this does a bounded internal poll (~90s max, never a long-held call): returns { status: 'ready', agents } once every agent has been classified, or { status: 'pending', agents } while Shakers is still processing (call it again to keep waiting — 'pending' is normal progress, not an error). Present agents to the talent by NAME and category/role only; the `code` field is an internal handle for add_agent, never show it. Requires an active session.",
     inputSchema: RESULT_INPUT_SCHEMA,
     handler,
   };