shakers-cli 0.16.0 → 0.17.0

package/src/onboarding-flow.js

@@ -669,18 +669,15 @@ function trackImport(funnel, attempted, importRes, durationMs) {
   const bySource = new Map();
   const report = importRes.ok && importRes.report ? importRes.report.sources : [];
   for (const src of report) bySource.set(sourceTypeFor(src.source), src);
-  const connected = [];
   for (const type of attempted) {
     const src = bySource.get(type);
     const ok = importRes.ok && (!src || src.status === 'imported');
     if (ok) {
-      connected.push(type);
       funnel.track('source_import_completed', 'import_sources', { source_type: type, duration_ms: durationMs });
     } else {
       funnel.track('source_import_failed', 'import_sources', { source_type: type, duration_ms: durationMs, failure_reason: (src && src.code) || importRes.reason });
     }
   }
-  return connected;
 }
 
 // Blocking orchestrator used by the CLI (`bin/onboarding.js`).
@@ -689,9 +686,10 @@ async function runOnboarding(io, deps = makeDeps(), { method = 'email', openBrow
   const c = getCatalog(io.lang).onboarding;
 
   funnel.begin();
+  funnel.viewed('start');
   funnel.completed('start');
   io.section(c.signupTitle);
-  funnel.viewed('account_creation');
+  funnel.viewed('account_creation', { auth_methods_offered: require('./auth-methods').methodIdsForFlow('register') });
   funnel.flush();
   const accountFailed = (reason) => {
     funnel.errored('account_creation', reason);
@@ -711,8 +709,8 @@ async function runOnboarding(io, deps = makeDeps(), { method = 'email', openBrow
       io.error(c.signupError);
       return accountFailed(reg.reason);
     }
-    funnel.completed('account_creation', { auth_method: method, is_returning_account: reg.kind === 'account-already-exists' });
-    funnel.identified();
+    funnel.completed('account_creation', { auth_method: method, auth_attempts: 1, is_returning_account: reg.kind === 'account-already-exists' });
+    funnel.identified({ newAccount: reg.kind !== 'account-already-exists' });
     if (reg.kind === 'account-already-exists') {
       // Existing account: already signed in — stop, no wizard re-run.
       io.warn(c.accountExists);
@@ -738,8 +736,8 @@ async function runOnboarding(io, deps = makeDeps(), { method = 'email', openBrow
       io.warn(c.accountExists);
       const logged = await io.login(account.email);
       if (!logged) return accountFailed('login-failed');
-      funnel.completed('account_creation', { auth_method: 'email', is_returning_account: true });
-      funnel.identified();
+      funnel.completed('account_creation', { auth_method: 'email', auth_attempts: 1, is_returning_account: true });
+      funnel.identified({ newAccount: false });
       return { ok: true, alreadyRegistered: true };
     }
     const sess = await establishSessionFromCredentials(deps, { email: account.email, password: account.password });
@@ -747,13 +745,13 @@ async function runOnboarding(io, deps = makeDeps(), { method = 'email', openBrow
       io.error(c.sessionError);
       return accountFailed(sess.reason);
     }
-    funnel.completed('account_creation', { auth_method: 'email', is_returning_account: false });
+    funnel.completed('account_creation', { auth_method: 'email', auth_attempts: 1, is_returning_account: false });
     funnel.identified();
     notifyOk(io, c.accountReady);
   }
 
   io.section(c.title);
-  funnel.viewed('import_sources');
+  funnel.viewed('import_sources', { sources_offered: ['linkedin', 'cv', 'github', 'web_page'] });
   const linkedinUrl = (await io.ask(c.askLinkedin) || '').trim();
   if (!linkedinUrl) {
     funnel.errored('import_sources', 'no-linkedin', { error_field: 'linkedin' });
@@ -772,15 +770,15 @@ async function runOnboarding(io, deps = makeDeps(), { method = 'email', openBrow
   const importStartedAt = Date.now();
   const importRes = await withProgress(c.importChecking, () =>
     startProfileImport(deps, { linkedinUrl, cvPath, githubUrl, websiteUrl, language: io.lang }));
-  const connected = trackImport(funnel, attempted, importRes, Date.now() - importStartedAt);
-  funnel.completed('import_sources', { sources_attempted: attempted, sources_connected: connected, sources_connected_count: connected.length });
+  trackImport(funnel, attempted, importRes, Date.now() - importStartedAt);
+  funnel.completed('import_sources', { sources_attempted: attempted, sources_connected: attempted, sources_connected_count: attempted.length });
   funnel.flush();
   if (importRes.ok) notifyOk(io, c.importDone);
   else io.warn(c.importUnavailable);
 
   // Steps 4-8 are saved out of funnel order: sent together once all are answered.
   io.section(c.professionalTitle);
-  funnel.viewed('work_situation');
+  funnel.viewed('work_situation', { is_prefilled: false });
   const workSituationInput = await io.askWorkSituation(c);
   const workSituationRes = await saveWorkSituation(deps, workSituationInput);
   if (!workSituationRes.ok) {
@@ -788,11 +786,11 @@ async function runOnboarding(io, deps = makeDeps(), { method = 'email', openBrow
     funnel.flush();
     return { ok: false, reason: workSituationRes.reason, step: 'work-situation' };
   }
-  funnel.completed('work_situation', { work_situation: workSituationValue(String(workSituationInput.situation || '').trim().toUpperCase()) });
+  funnel.completed('work_situation', { work_situation: workSituationValue(String(workSituationInput.situation || '').trim().toUpperCase()), was_edited: true });
   notifyOk(io, c.professionalSaved);
 
   io.section(c.pricingTitle);
-  funnel.viewed('rates');
+  funnel.viewed('rates', { suggested_rate_shown: false });
   const pricingInput = await io.askPricing(c);
   const priceRes = await savePricing(deps, pricingInput);
   if (!priceRes.ok) {
@@ -805,23 +803,31 @@ async function runOnboarding(io, deps = makeDeps(), { method = 'email', openBrow
     rate_types_selected: selectedRates,
     rate_type: selectedRates[0],
     rate_currency: normalizeCurrency(pricingInput.partTimeSelected === true ? pricingInput.partTimeCurrency : pricingInput.fullTimeCurrency) || undefined,
+    was_edited: true,
   });
   notifyOk(io, c.pricingSaved);
 
   // Optional/skippable and fail-soft: a decline or a failed write never aborts the alta.
   io.section(c.availabilityTitle);
-  funnel.viewed('availability');
+  funnel.viewed('availability', { is_prefilled: false });
   if (await io.confirm(c.availabilityAsk)) {
-    const availabilityInput = await io.askAvailability(c);
+    let availabilityTime;
+    const availabilityInput = await io.askAvailability(c, {
+      onLocation: () => {
+        availabilityTime = funnel.stepTime('availability');
+        funnel.viewed('location', { is_prefilled: false });
+      },
+    });
     const availRes = await saveAvailability(deps, availabilityInput);
     if (availRes.ok) {
-      funnel.completed('availability', { availability_hours_per_week: weeklyHours(normalizeMonthlyHours(availabilityInput.monthlyHours)) });
+      funnel.completed('availability', { availability_hours_per_week: weeklyHours(normalizeMonthlyHours(availabilityInput.monthlyHours)), time_on_step_ms: availabilityTime, was_edited: true });
       const country = normalizeCountry(availabilityInput.country);
       const modes = Array.isArray(availabilityInput.workModes) ? availabilityInput.workModes.map((m) => String(m).trim().toUpperCase()) : [];
       funnel.completed('location', {
         location_country: country ? country.toLowerCase() : undefined,
         location_method: 'manual',
         is_remote_only: modes.length ? modes.every((m) => m === 'REMOTE') : undefined,
+        was_edited: true,
       });
       notifyOk(io, c.availabilitySaved);
     } else {
@@ -839,13 +845,13 @@ async function runOnboarding(io, deps = makeDeps(), { method = 'email', openBrow
   }
 
   io.section(c.languagesTitle);
-  funnel.viewed('languages');
+  funnel.viewed('languages', { is_prefilled: false });
   if (await io.confirm(c.languagesAsk)) {
     const languageRows = await io.askLanguages(c);
     const langRes = await saveLanguages(deps, languageRows);
     if (langRes.ok) {
       const codes = validateLanguageRows(languageRows).rows.map((r) => r.language);
-      funnel.completed('languages', { languages_count: codes.length, languages: codes });
+      funnel.completed('languages', { languages_count: codes.length, languages: codes, was_edited: true });
       notifyOk(io, c.languagesSaved);
     } else {
       funnel.errored('languages', langRes.reason);
@@ -888,20 +894,35 @@ async function runOnboarding(io, deps = makeDeps(), { method = 'email', openBrow
   // Every ending points the Talent at their profile, and opens it when a browser is at hand.
   const showProfile = () => {
     const url = profileUrl(deps);
+    funnel.viewed('profile_summary');
     notifyOk(io, url ? c.profileReadyUrl(url) : c.profileReadyNoUrl);
     if (url && typeof openProfile === 'function') {
       try { openProfile(url); } catch { /* the printed link covers it */ }
     }
+    funnel.completed('profile_summary');
+    funnel.flush();
     return url;
   };
 
   const mainRole = async () => {
-    const role = await runMainRoleFinalStep(io, deps);
-    if (role && role.ok && role.chosen) funnel.completed('supercluster', { supercluster: role.chosen });
-    else if (role && role.ok) funnel.skipped('supercluster');
+    let shown = null;
+    const role = await runMainRoleFinalStep(io, deps, {
+      onRolesShown: (info) => {
+        shown = info;
+        funnel.viewed('supercluster', { suggested_superclusters: info.suggested, suggestion_source: 'assigned_clusters', suggestions_count: info.suggested.length });
+      },
+    });
+    if (role && role.ok && role.chosen) {
+      funnel.completed('supercluster', {
+        supercluster: role.chosen,
+        clusters_count: shown ? shown.clustersCount : undefined,
+        was_suggestion_accepted: shown ? shown.suggested.includes(role.chosen) : undefined,
+      });
+    } else if (role && role.ok) funnel.skipped('supercluster');
     funnel.flush();
   };
 
+  funnel.holdUntil('profile_summary');
   io.section(c.interviewTitle);
   funnel.viewed('pre_interview');
   io.disclaimer(c.interviewInfoAccessed, c.interviewGoalDuration);
@@ -1010,14 +1031,14 @@ async function conductLivekitInterview(io, deps, { interviewId = null, language
 }
 
 // Runs the final main-role step, degrading softly (never aborts the flow / never throws).
-async function runMainRoleFinalStep(io, deps, session = null) {
-  const active = session || (typeof deps.loadAuthSession === 'function' ? deps.loadAuthSession() : null);
+async function runMainRoleFinalStep(io, deps, { onRolesShown } = {}) {
+  const active = typeof deps.loadAuthSession === 'function' ? deps.loadAuthSession() : null;
   if (typeof deps.runMainRoleStep !== 'function' || !active) return;
   const { getCatalog } = require('./i18n');
   const catalog = getCatalog(io.lang);
   try {
     const rolesDeps = typeof deps.makeRolesDeps === 'function' ? deps.makeRolesDeps() : undefined;
-    return await deps.runMainRoleStep({ io, session: active, catalog, deps: rolesDeps });
+    return await deps.runMainRoleStep({ io, session: active, catalog, deps: rolesDeps, onRolesShown });
   } catch {
     return null;
   }

package/src/onboarding-funnel.js

@@ -196,8 +196,17 @@ function createFunnel({
   let active = false;
   let mcpClient = null;
   let cachedDeviceId;
+  let begunAt = null;
+  let lastCompletedAt = null;
+  let heldFrom = null;
   const seen = new Set();
   const inflight = new Set();
+  const viewedAt = new Map();
+
+  function stepTime(stepName) {
+    const since = viewedAt.has(stepName) ? viewedAt.get(stepName) : (lastCompletedAt ?? begunAt);
+    return since === null ? undefined : Math.max(0, now() - since);
+  }
 
   function track(eventType, stepName, properties = {}) {
     if (!active || !EVENT_TYPES.includes(eventType) || !STEP_INDEX[stepName]) return false;
@@ -206,9 +215,20 @@ function createFunnel({
       if (seen.has(key)) return false;
       seen.add(key);
     }
+    const at = now();
+    const own = cleanProperties(properties);
+    if (eventType === 'onboarding_step_viewed') viewedAt.set(stepName, at);
+    if (eventType === 'onboarding_step_completed') {
+      if (own.time_on_step_ms === undefined) {
+        const elapsed = stepTime(stepName);
+        if (elapsed !== undefined) own.time_on_step_ms = elapsed;
+      }
+      lastCompletedAt = at;
+    }
+    if (heldFrom === STEP_INDEX[stepName] && (eventType === 'onboarding_step_completed' || eventType === 'onboarding_step_skipped')) heldFrom = null;
     const common = { step_name: stepName, step_index: STEP_INDEX[stepName], flow_version: FLOW_VERSION, surface };
     if (surface === 'mcp') common.mcp_client = mcpClient || 'other';
-    pending.push({ eventType, insertId: uuid(), at: now(), seq: seq++, properties: { ...cleanProperties(properties), ...common } });
+    pending.push({ eventType, insertId: uuid(), at, seq: seq++, properties: { ...own, ...common } });
     return true;
   }
 
@@ -220,9 +240,16 @@ function createFunnel({
   // Funnel order, each time strictly after the previous one sent.
   function stamp(batch) {
     const ordered = [...batch].sort((a, b) => a.properties.step_index - b.properties.step_index || a.seq - b.seq);
-    return ordered.map((item) => {
+    const latest = [];
+    let next = Infinity;
+    for (let i = ordered.length - 1; i >= 0; i--) {
+      const item = ordered[i];
+      latest[i] = item.time !== undefined ? item.time : Math.min(item.at, next - 1);
+      next = latest[i];
+    }
+    return ordered.map((item, i) => {
       if (item.time === undefined) {
-        lastTime = Math.max(item.at, lastTime + 1);
+        lastTime = Math.max(latest[i], lastTime + 1);
         item.time = lastTime;
       }
       return { item, time: item.time };
@@ -246,8 +273,9 @@ function createFunnel({
     const url = safe(endpoint);
     // Never send under another account signed in since.
     if (!token || !url || accountOf(token) !== account) return Promise.resolve();
-    const batch = pending;
-    pending = [];
+    const batch = heldFrom === null ? pending : pending.filter((e) => e.properties.step_index < heldFrom);
+    if (!batch.length) return Promise.resolve();
+    pending = pending.filter((e) => !batch.includes(e));
     const id = currentDeviceId();
     const toWire = ({ item, time }) => ({ event_type: item.eventType, insert_id: item.insertId, time, ...(id ? { device_id: id } : {}), properties: item.properties });
     return post(stamp(batch), toWire, (events) => send({ endpoint: url, events, hubAccessToken: token })).then(() => undefined);
@@ -288,6 +316,10 @@ function createFunnel({
     surface,
     begin() {
       seen.clear();
+      viewedAt.clear();
+      lastCompletedAt = null;
+      heldFrom = null;
+      begunAt = now();
       active = true;
     },
     get active() { return active; },
@@ -296,8 +328,13 @@ function createFunnel({
     viewed: (step, props) => track('onboarding_step_viewed', step, props),
     completed: (step, props) => track('onboarding_step_completed', step, props),
     skipped: (step, props) => track('onboarding_step_skipped', step, props),
+    stepTime: (step) => (active ? stepTime(step) : undefined),
+    holdUntil(step) {
+      if (active && STEP_INDEX[step]) heldFrom = STEP_INDEX[step];
+    },
     errored: (step, reason, props = {}) => track('onboarding_step_errored', step, { error_type: errorTypeFor(reason), ...props }),
-    identified() {
+    identified({ newAccount = true } = {}) {
+      if (!newAccount) pending = pending.filter((e) => !(e.eventType === 'onboarding_step_completed' && STEP_INDEX[e.properties.step_name] <= STEP_INDEX.account_creation));
       const token = safe(hubToken);
       if (!token) return Promise.resolve();
       account = accountOf(token);
@@ -307,6 +344,7 @@ function createFunnel({
     flush,
     idle,
     settle(capMs = EXIT_FLUSH_CAP_MS) {
+      heldFrom = null;
       flush();
       let timer;
       const cap = new Promise((resolve) => { timer = setTimeout(resolve, capMs); });
@@ -334,6 +372,8 @@ const NOOP_FUNNEL = Object.freeze({
   viewed: () => false,
   completed: () => false,
   skipped: () => false,
+  stepTime: () => undefined,
+  holdUntil() {},
   errored: () => false,
   identified: () => Promise.resolve(),
   flush: () => Promise.resolve(),

package/src/render-report-text.js

@@ -14,7 +14,7 @@ function renderFullReportText(report, maturity, aiProfile, { lang = 'en', gate }
   );
   let terminal = '';
   try {
-    terminal = stripAnsi(renderTerminal(report, maturity, lang, { gate: gate || reportGateForIdentity() }))
+    terminal = stripAnsi(renderTerminal(report, maturity, lang, { gate: { ...(gate || reportGateForIdentity()), showRoadmap: false } }))
       .replace(/[ \t]+$/gm, '')
       .replace(/\n{3,}/g, '\n\n')
       .trim();

package/src/report-gating.js

@@ -2,11 +2,12 @@
 
 const { loadAuthSession, sessionStatus, isPlatformTalent } = require('./auth-session-store');
 const { getProfile } = require('./config');
+const { hasAccountTrace } = require('./account-trace');
 
 // THE ONE LAYER THAT DECIDES WHAT THE REPORT SHOWS ACCORDING TO IDENTITY.
 
 // Pure: identity in, policy out.
-function resolveReportGate({ loggedIn = false, status = null, email = null, userType = null, profile = 'talent' } = {}) {
+function resolveReportGate({ loggedIn = false, accountTrace = false, status = null, email = null, userType = null, profile = 'talent' } = {}) {
   const showEverything = !loggedIn;
   const resolvedProfile = profile === 'external' ? 'external' : 'talent';
   return Object.freeze({
@@ -16,7 +17,7 @@ function resolveReportGate({ loggedIn = false, status = null, email = null, user
     email: loggedIn && typeof email === 'string' && email ? email : null,
     // --roadmap AND its server-side computation/egress (see bin/report.js): a
     // logged-in Talent's roadmap is not merely hidden, it is not requested.
-    showRoadmap: showEverything,
+    showRoadmap: showEverything && !accountTrace,
     // Per-agent "how to improve this agent" tips in the footprint report.
     showAgentSuggestions: showEverything,
     // The copyable remediation prompt in a `certify` verdict.
@@ -35,6 +36,7 @@ function reportGateForIdentity(env = process.env, now = Date.now()) {
   const status = sessionStatus(session, now);
   return resolveReportGate({
     loggedIn: status === 'active',
+    accountTrace: hasAccountTrace(env),
     status,
     email: session ? session.email : null,
     userType: session ? session.userType : null,

package/src/report-store.js

@@ -54,10 +54,10 @@ function migrateFromV1(parsed) {
   return { schemaVersion: SCHEMA_VERSION, updatedAt: (parsed && parsed.updatedAt) || null, projects };
 }
 
-function loadState() {
+function loadState(env = process.env) {
   let parsed;
   try {
-    parsed = JSON.parse(fs.readFileSync(statePath(), 'utf8'));
+    parsed = JSON.parse(fs.readFileSync(statePath(env), 'utf8'));
   } catch {
     return freshState();
   }
@@ -154,6 +154,10 @@ function recordBackendAcceptance({ root, kind, backend }) {
   return stampAndSaveState(state, absRoot);
 }
 
+function hasRecordedUpload(env = process.env) {
+  return Object.values(loadState(env).projects).some((p) => !!(p && p.backendAcceptance && Object.keys(p.backendAcceptance).length));
+}
+
 function loadFootprint({ root } = {}) {
   const absRoot = path.resolve(root || process.cwd());
   const state = loadState();
@@ -220,6 +224,7 @@ module.exports = {
   loadAgentClassifications,
   loadFootprint,
   recordBackendAcceptance,
+  hasRecordedUpload,
   materializeProjectReport,
   certKey,
   SCHEMA_VERSION,

package/src/roles-flow.js

@@ -88,6 +88,7 @@ async function runAddRole({ io, session, catalog, deps = makeRolesDeps() }) {
 // deduped, for setting/switching the MAIN role.
 async function fetchHeldRoles({ deps, hubAccessToken }) {
   const held = [];
+  const assigned = [];
   let mainClusterId = null;
   const certEndpoint = deps.getMyCertificationsEndpoint();
   if (certEndpoint) {
@@ -99,10 +100,11 @@ async function fetchHeldRoles({ deps, hubAccessToken }) {
   }
   const assignedEndpoint = deps.getAssignedClustersEndpoint();
   if (assignedEndpoint) {
-    const assigned = await deps.requestAssignedClusters({ hubAccessToken }, { endpoint: assignedEndpoint });
-    if (assigned.ok) for (const c of assigned.clusters || []) held.push(c);
+    const res = await deps.requestAssignedClusters({ hubAccessToken }, { endpoint: assignedEndpoint });
+    if (res.ok) assigned.push(...(res.clusters || []));
   }
-  return { held: dedupeByCluster(held), mainClusterId };
+  held.push(...assigned);
+  return { held: dedupeByCluster(held), assigned, mainClusterId };
 }
 
 // `change-role`: switch the MAIN role to one of the roles the talent already holds.
@@ -130,12 +132,12 @@ async function runChangeMainRole({ io, session, catalog, deps = makeRolesDeps()
 
 // The onboarding final step: pick a MAIN role from the roles resolved for the
 // talent (interview recommendations + any held). Degrades gracefully to a skip.
-async function runOnboardingMainRoleStep({ io, session, catalog, deps = makeRolesDeps() }) {
+async function runOnboardingMainRoleStep({ io, session, catalog, deps = makeRolesDeps(), onRolesShown = () => {} }) {
   const r = catalog.roles;
   const hubAccessToken = session ? session.hubAccessToken : null;
 
   io.section(r.mainRoleTitle);
-  const { held, mainClusterId } = await io.withProgress(r.loadingHeld, () => fetchHeldRoles({ deps, hubAccessToken }));
+  const { held, assigned, mainClusterId } = await io.withProgress(r.loadingHeld, () => fetchHeldRoles({ deps, hubAccessToken }));
 
   // Prefer the talent's own/recommended roles; fall back to the catalog for a
   // fresh talent so a main role can always be set (picking one adds it first).
@@ -150,6 +152,7 @@ async function runOnboardingMainRoleStep({ io, session, catalog, deps = makeRole
     io.notify(r.mainRolePending);
     return { ok: true, chosen: null };
   }
+  onRolesShown({ suggested: assigned.filter((c) => c.type === 'RECOMMENDED').map((c) => c.clusterId), clustersCount: assigned.length });
   const choice = await chooseRole({
     io, roles, header: r.mainRolePrompt, hint: r.selectHint, initialClusterId: mainClusterId,
   });

package/src/share-consent-state.js

@@ -19,9 +19,9 @@ const SEND_THROTTLE_MS = 60 * 60 * 1000;
 
 // consent state (~/.config/ai-footprint/consent.json) Replaces the old `credentials.json` (token model).
 
-function loadConsentState() {
+function loadConsentState(env = process.env) {
   try {
-    return JSON.parse(fs.readFileSync(consentPath(), 'utf8'));
+    return JSON.parse(fs.readFileSync(consentPath(env), 'utf8'));
   } catch {
     return null;
   }