shakers-cli-beta 0.8.0-beta.0

package/src/onboarding-livekit-client.js

@@ -0,0 +1,102 @@
+'use strict';
+
+// Thin certs adapter: exchange a created onboarding interview for LiveKit room credentials so the CLI can join over text (lk.chat).
+
+const { postJsonWithTimeout } = require('./backend-request');
+const { reasonForError } = require('./onboarding-client');
+const { toUpperLang } = require('./lang-codes');
+
+const DEFAULT_TIMEOUT_MS = 20000;
+// Sub-path appended to `{base}/{interviewId}/` — the real post-merge certs
+// route (sibling of `text-session`). Change this ONE constant if it moves.
+const LIVEKIT_SESSION_PATH = 'livekit-text-session';
+// Completion route: `PATCH {base}/{interviewId}/complete`.
+const COMPLETE_SESSION_PATH = 'complete';
+
+function parseJson(raw) {
+  try {
+    return raw ? JSON.parse(raw) : null;
+  } catch {
+    return null;
+  }
+}
+
+function envelopeData(raw) {
+  const json = parseJson(raw);
+  if (!json || typeof json !== 'object' || json.status !== 'OK') return undefined;
+  return json.data;
+}
+
+function bearerHeaders(accessToken) {
+  const headers = {};
+  if (typeof accessToken === 'string' && accessToken) headers.Authorization = `Bearer ${accessToken}`;
+  return headers;
+}
+
+function pickString(obj, keys) {
+  for (const k of keys) {
+    const v = obj && obj[k];
+    if (typeof v === 'string' && v) return v;
+  }
+  return null;
+}
+
+async function requestStartOnboardingLivekitSession(
+  { interviewId, language, accessToken } = {},
+  { base, path = LIVEKIT_SESSION_PATH, 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)}/${path}`;
+  const body = { language: toUpperLang(language) };
+  let res;
+  try {
+    res = await postJsonWithTimeout(url, body, timeoutMs, 'POST', 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 = envelopeData(res.raw);
+  if (data === undefined || !data || typeof data !== 'object') return { ok: false, reason: 'bad-response' };
+
+  const livekitUrl = pickString(data, ['livekitUrl', 'url', 'wsUrl', 'serverUrl']);
+  const token = pickString(data, ['token', 'accessToken', 'participantToken']);
+  const roomName = pickString(data, ['roomName', 'room', 'room_name']);
+  const closingMessage = pickString(data, ['closingMessage', 'closing']);
+  const resolvedId = pickString(data, ['interviewId', 'id']) || interviewId;
+
+  if (!livekitUrl || !token) return { ok: false, reason: 'bad-response' };
+  return { ok: true, livekitUrl, token, roomName: roomName || null, interviewId: resolvedId, closingMessage: closingMessage || null };
+}
+
+// Persist the onboarding interview's transcript on session end (the LiveKit text flow is the one path that was not sending it; certs already stores + serves it).
+async function requestCompleteOnboardingLivekitSession(
+  { interviewId, durationSeconds, transcripts, accessToken } = {},
+  { base, path = COMPLETE_SESSION_PATH, timeoutMs = DEFAULT_TIMEOUT_MS } = {},
+) {
+  if (!base) return { ok: false, reason: 'no-endpoint' };
+  if (!interviewId) return { ok: false, reason: 'no-interview' };
+  if (!Array.isArray(transcripts) || transcripts.length === 0) return { ok: false, reason: 'no-transcript' };
+
+  const url = `${base.replace(/\/+$/, '')}/${encodeURIComponent(interviewId)}/${path}`;
+  const body = { transcripts };
+  if (Number.isInteger(durationSeconds) && durationSeconds >= 0) body.durationSeconds = durationSeconds;
+
+  let res;
+  try {
+    res = await postJsonWithTimeout(url, body, timeoutMs, 'PATCH', 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) };
+  return { ok: true };
+}
+
+module.exports = {
+  requestStartOnboardingLivekitSession,
+  requestCompleteOnboardingLivekitSession,
+  LIVEKIT_SESSION_PATH,
+  COMPLETE_SESSION_PATH,
+};

package/src/onboarding-status-client.js

@@ -0,0 +1,42 @@
+'use strict';
+
+const { postJsonWithTimeout } = require('./backend-request');
+
+const DEFAULT_TIMEOUT_MS = 12000;
+
+function parseJson(raw) {
+  try {
+    return raw ? JSON.parse(raw) : null;
+  } catch {
+    return null;
+  }
+}
+
+function authHeaders({ accessToken } = {}) {
+  const headers = {};
+  if (typeof accessToken === 'string' && accessToken) headers.Authorization = `Bearer ${accessToken}`;
+  return headers;
+}
+
+async function requestOnboardingStatus({ accessToken } = {}, { endpoint, timeoutMs = DEFAULT_TIMEOUT_MS } = {}) {
+  if (!endpoint) return { ok: false, reason: 'no-endpoint' };
+
+  let res;
+  try {
+    res = await postJsonWithTimeout(endpoint, null, timeoutMs, 'GET', null, authHeaders({ accessToken }));
+  } catch (e) {
+    return { ok: false, reason: (e && e.kind) || 'network-error' };
+  }
+
+  if (res.status < 200 || res.status >= 300) {
+    return { ok: false, reason: `http-${res.status}` };
+  }
+
+  const json = parseJson(res.raw);
+  const data = json && typeof json === 'object' ? json.data : null;
+  if (!data || typeof data !== 'object') return { ok: false, reason: 'bad-response' };
+
+  return { ok: true, completed: data.completed === true };
+}
+
+module.exports = { requestOnboardingStatus };

package/src/open-file.js

@@ -0,0 +1,32 @@
+'use strict';
+
+const { spawn } = require('child_process');
+
+// Zero-dependency, best-effort "open this file in the OS default app" (ADR-016, used by the `report` command to open the generated HTML in the browser).
+function openPath(target) {
+  let cmd;
+  let args;
+  if (process.platform === 'darwin') {
+    cmd = 'open';
+    args = [target];
+  } else if (process.platform === 'win32') {
+    // `start` needs an (empty) title arg first when the target may be quoted.
+    cmd = 'cmd';
+    args = ['/c', 'start', '', target];
+  } else {
+    cmd = 'xdg-open';
+    args = [target];
+  }
+  try {
+    const child = spawn(cmd, args, { stdio: 'ignore', detached: true });
+    // An absent opener (ENOENT) surfaces as an async 'error' — swallow it so it
+    // never becomes an unhandled exception that breaks the REPL.
+    child.on('error', () => {});
+    child.unref();
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+module.exports = { openPath };

package/src/osc-link.js

@@ -0,0 +1,16 @@
+'use strict';
+
+// OSC 8 terminal hyperlink helper (talents-ai-score, user request: links were printed as plain text and could NOT be clicked in iTerm2).
+
+const OSC = '\x1b]8;;';
+const ST = '\x1b\\';
+
+// Wrap `label` as an OSC 8 hyperlink to `url`.
+function oscLink(url, label) {
+  const target = url == null ? '' : String(url);
+  const text = label == null || label === '' ? target : String(label);
+  if (!target) return text;
+  return `${OSC}${target}${ST}${text}${OSC}${ST}`;
+}
+
+module.exports = { oscLink };

package/src/portfolio-client.js

@@ -0,0 +1,164 @@
+'use strict';
+
+const { postJsonWithTimeout, postMultipartWithTimeout } = require('./backend-request');
+const { reasonForError, WORKS_CODE_TO_REASON } = require('./skills-client');
+
+// Talent-portfolio client (talents-ai-score, ADR-059 — `start`'s "Add project to portfolio" route, src/start-add-portfolio.js).
+
+const DEFAULT_TIMEOUT_MS = 20000;
+
+function parseJson(raw) {
+  try {
+    return raw ? JSON.parse(raw) : null;
+  } catch {
+    return null;
+  }
+}
+
+function authHeaders({ accessToken, hubAccessToken } = {}) {
+  const headers = {};
+  if (typeof accessToken === 'string' && accessToken) headers.Authorization = `Bearer ${accessToken}`;
+  if (typeof hubAccessToken === 'string' && hubAccessToken) headers['X-Hub-Token'] = hubAccessToken;
+  return headers;
+}
+
+function hubHeaders({ hubAccessToken } = {}) {
+  const headers = {};
+  if (typeof hubAccessToken === 'string' && hubAccessToken) headers.Authorization = `Bearer ${hubAccessToken}`;
+  return headers;
+}
+
+// `GET .../portfolios`.
+async function requestListPortfolios({ accessToken, hubAccessToken } = {}, { endpoint, timeoutMs = DEFAULT_TIMEOUT_MS } = {}) {
+  if (!endpoint) return { ok: false, reason: 'no-endpoint' };
+  if (!hubAccessToken) return { ok: false, reason: 'no-hub-token' };
+
+  let res;
+  try {
+    res = await postJsonWithTimeout(endpoint, null, timeoutMs, 'GET', null, authHeaders({ accessToken, hubAccessToken }));
+  } 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 json = parseJson(res.raw);
+  const data = json && typeof json === 'object' && Array.isArray(json.data) ? json.data : null;
+  if (!data) return { ok: false, reason: 'bad-response' };
+
+  const portfolios = data
+    .map((entry) => ({
+      id: entry && typeof entry.id === 'string' ? entry.id : null,
+      name: entry && typeof entry.name === 'string' ? entry.name : null,
+      type: entry && typeof entry.type === 'string' ? entry.type : null,
+      skillIds: entry && Array.isArray(entry.skillIds) ? entry.skillIds : [],
+      startDate: entry && typeof entry.startDate === 'string' ? entry.startDate : null,
+      endDate: entry && typeof entry.endDate === 'string' ? entry.endDate : null,
+      isCurrent: entry ? entry.isCurrent === true : false,
+    }))
+    .filter((p) => p.name !== null);
+  return { ok: true, portfolios };
+}
+
+// `POST .../portfolios/declare`.
+async function requestDeclarePortfolio(
+  { name, type, skillIds, description, url, clientName, clientDomain, startDate, endDate, accessToken, hubAccessToken } = {},
+  { endpoint, timeoutMs = DEFAULT_TIMEOUT_MS } = {},
+) {
+  if (!endpoint) return { ok: false, reason: 'no-endpoint' };
+  if (!hubAccessToken) return { ok: false, reason: 'no-hub-token' };
+
+  const body = { name, type };
+  if (Array.isArray(skillIds) && skillIds.length > 0) body.skillIds = skillIds;
+  if (typeof description === 'string' && description) body.description = description;
+  if (typeof url === 'string' && url) body.url = url;
+  if (typeof clientName === 'string' && clientName) body.clientName = clientName;
+  if (typeof clientDomain === 'string' && clientDomain) body.clientDomain = clientDomain;
+  if (typeof startDate === 'string' && startDate) body.startDate = startDate;
+  if (typeof endDate === 'string' && endDate) body.endDate = endDate;
+  body.generatedWith = 'AI';
+
+  let res;
+  try {
+    res = await postJsonWithTimeout(endpoint, body, timeoutMs, 'POST', null, authHeaders({ accessToken, hubAccessToken }));
+  } 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 json = parseJson(res.raw);
+  if (!json || json.status !== 'OK') return { ok: false, reason: 'bad-response' };
+  return { ok: true };
+}
+
+// `POST .../portfolios/draft-description`.
+async function requestDraftDescription(
+  { name, technologies, readme, packageDescription, accessToken } = {},
+  { endpoint, timeoutMs = DEFAULT_TIMEOUT_MS } = {},
+) {
+  if (!endpoint) return { ok: false, reason: 'no-endpoint' };
+
+  const body = {
+    consent: true,
+    name,
+    technologies: Array.isArray(technologies) ? technologies.filter((t) => typeof t === 'string' && t) : [],
+  };
+  if (typeof readme === 'string' && readme) body.readme = readme;
+  if (typeof packageDescription === 'string' && packageDescription) body.packageDescription = packageDescription;
+
+  let res;
+  try {
+    res = await postJsonWithTimeout(endpoint, body, timeoutMs, 'POST', null, authHeaders({ 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 json = parseJson(res.raw);
+  const description = json && json.status === 'OK' && json.data && typeof json.data.description === 'string'
+    ? json.data.description
+    : null;
+  if (!description) return { ok: false, reason: 'bad-response' };
+  return { ok: true, description };
+}
+
+async function requestUpdatePortfolioSkills(
+  { portfolioId, skillIds, hubAccessToken } = {},
+  { endpoint, timeoutMs = DEFAULT_TIMEOUT_MS } = {},
+) {
+  if (!endpoint) return { ok: false, reason: 'no-endpoint' };
+  if (!hubAccessToken) return { ok: false, reason: 'no-hub-token' };
+  if (!portfolioId) return { ok: false, reason: 'no-portfolio' };
+
+  const url = `${endpoint.replace(/\/+$/, '')}/${encodeURIComponent(portfolioId)}`;
+  const fields = { skillIds: (Array.isArray(skillIds) ? skillIds : []).join(',') };
+  let res;
+  try {
+    res = await postMultipartWithTimeout(url, fields, timeoutMs, 'PATCH', hubHeaders({ hubAccessToken }));
+  } 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 json = parseJson(res.raw);
+  if (!json || json.status !== 'OK') return { ok: false, reason: 'bad-response' };
+  return { ok: true };
+}
+
+module.exports = {
+  requestListPortfolios,
+  requestDeclarePortfolio,
+  requestDraftDescription,
+  requestUpdatePortfolioSkills,
+  WORKS_CODE_TO_REASON,
+};

package/src/portfolio-git-info.js

@@ -0,0 +1,61 @@
+'use strict';
+
+const { execFileSync } = require('child_process');
+
+// Git-derived signals for the "Add project to portfolio" route (talents-ai- score, ADR-059): the remote URL (step 4) and the first/last-commit date range (auto `startDate`/`endDate`).
+
+const GIT_TIMEOUT_MS = 15000;
+
+function runGit(root, args) {
+  try {
+    return execFileSync('git', ['-C', root, ...args], {
+      encoding: 'utf8',
+      timeout: GIT_TIMEOUT_MS,
+      stdio: ['ignore', 'pipe', 'ignore'],
+      maxBuffer: 8 * 1024 * 1024,
+    });
+  } catch {
+    return null;
+  }
+}
+
+function getRemoteUrl(root) {
+  const raw = runGit(root, ['remote', 'get-url', 'origin']);
+  if (!raw || !raw.trim()) return null;
+  return normalizeRemoteUrl(raw.trim());
+}
+
+function normalizeRemoteUrl(url) {
+  const stripped = url.replace(/\.git$/, '');
+  const scp = stripped.match(/^[^@/]+@([^:]+):(.+)$/); // git@host:owner/repo
+  if (scp) return `https://${scp[1]}/${scp[2]}`;
+  try {
+    const u = new URL(stripped);
+    if (u.protocol !== 'http:' && u.protocol !== 'https:') return null; // e.g. an ssh:// scheme
+    return `${u.protocol}//${u.host}${u.pathname}`.replace(/\/+$/, '');
+  } catch {
+    return null; // not a URL this function recognizes — never guess
+  }
+}
+
+function getCommitDateRange(root) {
+  const endRaw = runGit(root, ['log', '-1', '--format=%aI']);
+  const endDate = isoDateOnly(endRaw);
+
+  const rootShas = runGit(root, ['rev-list', '--max-parents=0', 'HEAD']);
+  const firstSha = rootShas && rootShas.trim() ? rootShas.trim().split('\n')[0] : null;
+  const startRaw = firstSha ? runGit(root, ['show', '-s', '--format=%aI', firstSha]) : null;
+  const startDate = isoDateOnly(startRaw);
+
+  return { startDate, endDate };
+}
+
+function isoDateOnly(raw) {
+  const s = raw && raw.trim();
+  if (!s) return null;
+  const d = new Date(s);
+  if (Number.isNaN(d.getTime())) return null;
+  return s.slice(0, 10); // %aI is already ISO 8601 (e.g. 2026-08-01T12:00:00+02:00); take the date part
+}
+
+module.exports = { getRemoteUrl, normalizeRemoteUrl, getCommitDateRange };

package/src/portfolios-client.js

@@ -0,0 +1,85 @@
+'use strict';
+
+// Portfolio entries client (hub `works/me/portfolios`, talent Bearer). ONE
+// entity with a `type` discriminator: EXPERIENCE (work history) vs PORTFOLIO
+// (showcase pieces). `experiences` and `portfolios` are the two `?type=` subsets.
+
+const { postJsonWithTimeout } = require('./backend-request');
+const { reasonForError } = require('./onboarding-client');
+
+const DEFAULT_TIMEOUT_MS = 20000;
+const TYPES = { experiences: 'EXPERIENCE', portfolios: 'PORTFOLIO' };
+
+function parseJson(raw) {
+  try {
+    return raw ? JSON.parse(raw) : null;
+  } catch {
+    return null;
+  }
+}
+
+function bearerHeaders(accessToken) {
+  const headers = {};
+  if (typeof accessToken === 'string' && accessToken) headers.Authorization = `Bearer ${accessToken}`;
+  return headers;
+}
+
+function str(v) {
+  return typeof v === 'string' && v ? v : null;
+}
+
+// Keep only the human-useful fields (+ id/projectId for --json/tools).
+function normalizePortfolio(raw) {
+  const it = raw && typeof raw === 'object' ? raw : {};
+  const skills = Array.isArray(it.skillIds)
+    ? it.skillIds.map((s) => (s && typeof s === 'object' ? str(s.name) : str(s))).filter(Boolean)
+    : [];
+  return {
+    id: str(it.id),
+    name: str(it.name),
+    company: str(it.clientName),
+    startDate: it.startDate ? String(it.startDate) : null,
+    endDate: it.endDate ? String(it.endDate) : null,
+    isCurrent: it.isCurrent === true,
+    location: str(it.location),
+    description: str(it.aboutDescription),
+    url: str(it.aboutUrl),
+    skills,
+    projectId: str(it.projectId),
+    generatedWith: str(it.generatedWith),
+  };
+}
+
+async function requestPortfolios({ hubAccessToken } = {}, { endpoint, type, timeoutMs = DEFAULT_TIMEOUT_MS } = {}) {
+  if (!endpoint) return { ok: false, reason: 'no-endpoint' };
+  if (!hubAccessToken) return { ok: false, reason: 'no-hub-token' };
+  const url = type ? `${endpoint}${endpoint.includes('?') ? '&' : '?'}type=${encodeURIComponent(type)}` : endpoint;
+  let res;
+  try {
+    res = await postJsonWithTimeout(url, null, timeoutMs, 'GET', null, bearerHeaders(hubAccessToken));
+  } 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 env = parseJson(res.raw);
+  const data = env && env.status === 'OK' ? env.data : env;
+  const rows = Array.isArray(data) ? data : (Array.isArray(data && data.items) ? data.items : null);
+  if (!rows) return { ok: false, reason: 'bad-response' };
+  return { ok: true, items: rows.map(normalizePortfolio) };
+}
+
+// `kind` = 'experiences' | 'portfolios' → the matching `type` filter.
+async function fetchPortfolios(deps = {}, { hubAccessToken, kind, timeoutMs = DEFAULT_TIMEOUT_MS } = {}) {
+  const getEndpoint = deps.getMePortfoliosEndpoint || require('./config').getMePortfoliosEndpoint;
+  const request = deps.requestPortfolios || requestPortfolios;
+  const endpoint = getEndpoint();
+  if (!endpoint) return { ok: false, reason: 'no-endpoint' };
+  return request({ hubAccessToken }, { endpoint, type: TYPES[kind] || null, timeoutMs });
+}
+
+module.exports = {
+  TYPES,
+  normalizePortfolio,
+  requestPortfolios,
+  fetchPortfolios,
+};

package/src/portfolios-flow.js

@@ -0,0 +1,79 @@
+'use strict';
+
+// Shared flow for `experiences` (type=EXPERIENCE) and `portfolios`
+// (type=PORTFOLIO): both list the talent's portfolio entries, read-only, with
+// the same shape. `kind` selects the `?type=` subset and the i18n namespace.
+
+const { styleLabelPrefix } = require('./ansi');
+const { resolveName } = require('./translations-client');
+
+function makePortfoliosDeps(overrides = {}) {
+  const client = require('./portfolios-client');
+  return {
+    fetchPortfolios: (opts) => client.fetchPortfolios({}, opts),
+    fetchTranslationMap: (opts) => require('./translations-client').fetchTranslationMap({}, opts),
+    ...overrides,
+  };
+}
+
+// Skill names arrive as static-data i18n KEYS; resolve them to readable names
+// (only fetch the translations map when there is at least one key to resolve).
+async function resolveSkillNames(items, { deps, hubAccessToken, lang }) {
+  const needs = items.some((it) => (it.skills || []).some((s) => /^staticData/.test(s)));
+  if (!needs) return items;
+  const tm = await deps.fetchTranslationMap({ hubAccessToken, lang });
+  const map = tm && tm.ok ? tm.map : null;
+  if (!map) return items;
+  return items.map((it) => ({ ...it, skills: (it.skills || []).map((s) => resolveName(map, s)) }));
+}
+
+function dateRange(item, fp) {
+  const start = item.startDate ? item.startDate.slice(0, 10) : null;
+  const end = item.isCurrent ? fp.current : (item.endDate ? item.endDate.slice(0, 10) : null);
+  if (!start && !end) return null;
+  return `${start || '—'} → ${end || '—'}`;
+}
+
+// Human render never prints ids (they ride --json / the tools).
+function formatItem(item, index, fp) {
+  const headline = item.name || fp.untitled;
+  const lines = [`${index}) ${headline}${item.company ? ` — ${item.company}` : ''}`];
+  const range = dateRange(item, fp);
+  if (range) lines.push(`   ${styleLabelPrefix(fp.datesLabel(range))}`);
+  if (item.location) lines.push(`   ${styleLabelPrefix(fp.locationLabel(item.location))}`);
+  if (item.skills.length) lines.push(`   ${styleLabelPrefix(fp.skillsLabel(item.skills.join(', ')))}`);
+  return lines.join('\n  ');
+}
+
+async function runPortfolioList({ io, rawOut, lang = 'en', session, catalog, kind, opts = {}, deps = makePortfoliosDeps() }) {
+  const fp = catalog[kind];
+  const hubAccessToken = session ? session.hubAccessToken : null;
+
+  const doFetch = () => deps.fetchPortfolios({ hubAccessToken, kind });
+  const res = opts.json ? await doFetch() : await io.withProgress(fp.loading, doFetch);
+  if (!res.ok) {
+    io.error(fp.fetchFailed(res.reason));
+    return { ok: false, reason: res.reason };
+  }
+  const items = await resolveSkillNames(Array.isArray(res.items) ? res.items : [], { deps, hubAccessToken, lang });
+
+  if (opts.json) {
+    (rawOut || ((s) => process.stdout.write(s)))(`${JSON.stringify({ ok: true, items }, null, 2)}\n`);
+    return { ok: true, items };
+  }
+
+  io.section(fp.title);
+  if (items.length === 0) {
+    io.notify(fp.none);
+    return { ok: true, items };
+  }
+  items.forEach((item, i) => {
+    if (i > 0) io.notify('');
+    io.notify(formatItem(item, i + 1, fp));
+  });
+  io.notify(styleLabelPrefix(fp.countNote(items.length)));
+  io.success(fp.done);
+  return { ok: true, items };
+}
+
+module.exports = { makePortfoliosDeps, runPortfolioList, formatItem };