shakers-cli 0.0.0-stage → 0.14.1

package/bin/certifications.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+'use strict';
+
+// `certifications` — the talent's dimension certifications (src/certifications-flow.js).
+
+const { detectReportLang, getCatalog } = require('../src/i18n');
+const { loadAuthSession, sessionStatus } = require('../src/auth-session-store');
+const { createStdinAsk } = require('../src/stdin-ask');
+const { makeIo } = require('./register');
+const { makeRevealSink } = require('../src/reveal-output');
+const { runCertifications, makeCertificationsDeps } = require('../src/certifications-flow');
+
+function parseCertificationsArgs(argv = []) {
+  const o = { lang: null, help: false, json: false };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === '--help' || a === '-h') o.help = true;
+    else if (a === '--lang') { const v = argv[++i]; o.lang = v === 'es' || v === 'en' ? v : null; }
+    else if (a.startsWith('--lang=')) { const v = a.slice(7); o.lang = v === 'es' || v === 'en' ? v : null; }
+    else if (a === '--json') o.json = true;
+  }
+  return o;
+}
+
+async function run(
+  argv = process.argv.slice(2),
+  { ask: injectedAsk = null, stdinIsTTY: ttyOverride = undefined, deps = null, session: injectedSession = null, out = null } = {},
+) {
+  const opts = parseCertificationsArgs(argv);
+  const lang = opts.lang || detectReportLang();
+  const catalog = getCatalog(lang);
+  const fp = catalog.certifications;
+  const write = out || ((s) => process.stdout.write(s));
+
+  if (opts.help) {
+    write(fp.help + '\n');
+    return;
+  }
+
+  const session = injectedSession || loadAuthSession();
+  if (sessionStatus(session) !== 'active') {
+    process.stderr.write(`\n  ${fp.loginRequired}\n\n`);
+    process.exitCode = 1;
+    return;
+  }
+
+  const stdinIsTTY = ttyOverride !== undefined ? ttyOverride : !!process.stdin.isTTY;
+  const ask = injectedAsk || createStdinAsk();
+  const sink = makeRevealSink({ json: opts.json, interactive: false, out, env: process.env });
+  try {
+    const io = makeIo({ ask, lang, out: sink.write, stdinIsTTY });
+    const result = await runCertifications({
+      io, rawOut: sink.write, session, catalog,
+      opts: { json: opts.json },
+      deps: deps || makeCertificationsDeps(),
+    });
+    await sink.finish();
+    if (result && result.ok === false) process.exitCode = 1;
+    return result;
+  } finally {
+    if (!injectedAsk) ask.close();
+  }
+}
+
+module.exports = { run, parseCertificationsArgs };
+
+if (require.main === module) {
+  run();
+}

package/bin/certify.js

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+'use strict';
+
+// `certify` — discover + pick a dimension, then hand over the web link (src/certify-dimension-flow.js).
+
+const { detectReportLang, getCatalog } = require('../src/i18n');
+const { loadAuthSession, sessionStatus } = require('../src/auth-session-store');
+const { createStdinAsk } = require('../src/stdin-ask');
+const { makeIo } = require('./register');
+const { runCertifyDimension, makeCertifyDimensionDeps } = require('../src/certify-dimension-flow');
+
+function parseCertifyArgs(argv = []) {
+  const o = { lang: null, help: false, dimension: null, acceptDisclaimer: false };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === '--help' || a === '-h') o.help = true;
+    else if (a === '--lang') { const v = argv[++i]; o.lang = v === 'es' || v === 'en' ? v : null; }
+    else if (a.startsWith('--lang=')) { const v = a.slice(7); o.lang = v === 'es' || v === 'en' ? v : null; }
+    else if (a === '--dimension') o.dimension = argv[++i] != null ? argv[i] : null;
+    else if (a.startsWith('--dimension=')) o.dimension = a.slice('--dimension='.length);
+    else if (a === '--accept-disclaimer') o.acceptDisclaimer = true;
+  }
+  return o;
+}
+
+async function run(
+  argv = process.argv.slice(2),
+  { ask: injectedAsk = null, stdinIsTTY: ttyOverride = undefined, deps = null, session: injectedSession = null, out = null, input = undefined, output = undefined } = {},
+) {
+  const opts = parseCertifyArgs(argv);
+  const lang = opts.lang || detectReportLang();
+  const catalog = getCatalog(lang);
+  const cd = catalog.certifyDimension;
+  const write = out || ((s) => process.stdout.write(s));
+
+  if (opts.help) {
+    write(cd.help + '\n');
+    return;
+  }
+
+  const session = injectedSession || loadAuthSession();
+  if (sessionStatus(session) !== 'active') {
+    process.stderr.write(`\n  ${cd.loginRequired}\n\n`);
+    process.exitCode = 1;
+    return;
+  }
+
+  const stdinIsTTY = ttyOverride !== undefined ? ttyOverride : !!process.stdin.isTTY;
+  const ask = injectedAsk || createStdinAsk();
+  try {
+    const io = makeIo({ ask, lang, out: write, acceptDisclaimer: opts.acceptDisclaimer, stdinIsTTY });
+    const result = await runCertifyDimension({
+      io,
+      ask,
+      stdinIsTTY,
+      session,
+      lang,
+      catalog,
+      opts: { dimension: opts.dimension, input, output },
+      deps: deps || makeCertifyDimensionDeps(),
+    });
+    if (result && result.ok === false) process.exitCode = 1;
+    return result;
+  } finally {
+    if (!injectedAsk) ask.close();
+  }
+}
+
+module.exports = { run, parseCertifyArgs };
+
+if (require.main === module) {
+  run();
+}

package/bin/change-role.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+'use strict';
+
+// `change-role` — set the MAIN role to one the talent already holds (src/roles-flow.js).
+
+const { detectReportLang, getCatalog } = require('../src/i18n');
+const { loadAuthSession, sessionStatus } = require('../src/auth-session-store');
+const { createStdinAsk } = require('../src/stdin-ask');
+const { makeIo } = require('./register');
+const { runChangeMainRole, makeRolesDeps } = require('../src/roles-flow');
+
+function parseArgs(argv = []) {
+  const o = { lang: null, help: false };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === '--help' || a === '-h') o.help = true;
+    else if (a === '--lang') { const v = argv[++i]; o.lang = v === 'es' || v === 'en' ? v : null; }
+    else if (a.startsWith('--lang=')) { const v = a.slice(7); o.lang = v === 'es' || v === 'en' ? v : null; }
+  }
+  return o;
+}
+
+async function run(
+  argv = process.argv.slice(2),
+  { ask: injectedAsk = null, stdinIsTTY: ttyOverride = undefined, deps = null, session: injectedSession = null, out = null } = {},
+) {
+  const opts = parseArgs(argv);
+  const lang = opts.lang || detectReportLang();
+  const catalog = getCatalog(lang);
+  const r = catalog.roles;
+  const write = out || ((s) => process.stdout.write(s));
+
+  if (opts.help) {
+    write(r.changeHelp + '\n');
+    return;
+  }
+
+  const session = injectedSession || loadAuthSession();
+  if (sessionStatus(session) !== 'active') {
+    process.stderr.write(`\n  ${r.loginRequired}\n\n`);
+    process.exitCode = 1;
+    return;
+  }
+
+  const stdinIsTTY = ttyOverride !== undefined ? ttyOverride : !!process.stdin.isTTY;
+  const ask = injectedAsk || createStdinAsk();
+  try {
+    const io = makeIo({ ask, lang, out: write, stdinIsTTY });
+    const result = await runChangeMainRole({ io, session, catalog, deps: deps || makeRolesDeps() });
+    if (result && result.ok === false) process.exitCode = 1;
+    return result;
+  } finally {
+    if (!injectedAsk) ask.close();
+  }
+}
+
+module.exports = { run, parseArgs };
+
+if (require.main === module) {
+  run();
+}

package/bin/config.js

@@ -0,0 +1,124 @@
+#!/usr/bin/env node
+'use strict';
+
+const { detectReportLang } = require('../src/i18n');
+const {
+  loadConfigFile,
+  saveConfigFile,
+  validateEndpoint,
+  getCertsBase,
+  getHubBase,
+  getTalentProfileUrl,
+  getIngestEndpoint,
+} = require('../src/config');
+
+const VALID_LANGS = new Set(['es', 'en']);
+const ENDPOINT_KEYS = new Set(['certsBase', 'hubBase', 'ingestEndpoint', 'profileUrl']);
+const PROFILE_VALUES = new Set(['external', 'talent']);
+const SETTABLE = new Set([...ENDPOINT_KEYS, 'profile', 'lang']);
+
+const COPY = {
+  es: {
+    help: 'config — lee/escribe la configuracion NO sensible del CLI (bases de hub/certs, perfil, idioma). Uso: shakers config <list|get [clave]|set clave valor>\n  Claves: certsBase, hubBase, ingestEndpoint, profileUrl, profile, lang.\n  Los secretos (tokens/credenciales) NUNCA se guardan aqui: se obtienen con `shakers login` o por entorno.',
+    unknownKey: (k) => `clave desconocida: ${k}. Claves validas: ${[...SETTABLE].join(', ')}.`,
+    needValue: 'set necesita <clave> <valor>.',
+    badEndpoint: (k, r) => `valor invalido para ${k} (${r}). Debe ser una URL http de loopback o https.`,
+    badProfile: 'profile debe ser "external" o "talent".',
+    badLang: 'lang debe ser "es" o "en".',
+    saved: (k, v) => `guardado ${k} = ${v}`,
+    resolvedHeading: 'Resueltos (env > config.json > default local):',
+  },
+  en: {
+    help: 'config — read/write the CLI NON-sensitive configuration (hub/certs bases, profile, language). Usage: shakers config <list|get [key]|set key value>\n  Keys: certsBase, hubBase, ingestEndpoint, profileUrl, profile, lang.\n  Secrets (tokens/credentials) are NEVER stored here: get them via `shakers login` or the environment.',
+    unknownKey: (k) => `unknown key: ${k}. Valid keys: ${[...SETTABLE].join(', ')}.`,
+    needValue: 'set needs <key> <value>.',
+    badEndpoint: (k, r) => `invalid value for ${k} (${r}). Must be a loopback http URL or https.`,
+    badProfile: 'profile must be "external" or "talent".',
+    badLang: 'lang must be "es" or "en".',
+    saved: (k, v) => `saved ${k} = ${v}`,
+    resolvedHeading: 'Resolved (env > config.json > local default):',
+  },
+};
+
+function parseArgs(argv) {
+  const o = { lang: null, help: false, rest: [] };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === '--lang') o.lang = VALID_LANGS.has(argv[++i]) ? argv[i] : null;
+    else if (a.startsWith('--lang=')) { const v = a.slice(7); o.lang = VALID_LANGS.has(v) ? v : null; }
+    else if (a === '--help' || a === '-h') o.help = true;
+    else o.rest.push(a);
+  }
+  return o;
+}
+
+function resolvedView(env) {
+  return {
+    certsBase: getCertsBase(env),
+    hubBase: getHubBase(env),
+    ingestEndpoint: getIngestEndpoint(env),
+    profileUrl: getTalentProfileUrl(env),
+  };
+}
+
+async function run(argv = process.argv.slice(2), { env = process.env, out = null } = {}) {
+  const o = parseArgs(argv);
+  const lang = o.lang || detectReportLang();
+  const c = COPY[lang] || COPY.en;
+  const write = out || ((s) => process.stdout.write(s));
+  const line = (s) => write(`  ${s}\n`);
+
+  if (o.help || o.rest.length === 0) {
+    write(`\n  ${c.help}\n\n`);
+    return;
+  }
+
+  const [sub, key, ...valueParts] = o.rest;
+
+  if (sub === 'list') {
+    const config = loadConfigFile(env);
+    for (const k of SETTABLE) {
+      if (config[k] !== undefined) line(`${k} = ${config[k]}`);
+    }
+    line(c.resolvedHeading);
+    const r = resolvedView(env);
+    for (const k of Object.keys(r)) line(`  ${k} = ${r[k] === null ? '(unset)' : r[k]}`);
+    return;
+  }
+
+  if (sub === 'get') {
+    if (!key) { line(c.needValue); process.exitCode = 1; return; }
+    if (!SETTABLE.has(key)) { line(c.unknownKey(key)); process.exitCode = 1; return; }
+    const config = loadConfigFile(env);
+    line(config[key] !== undefined ? String(config[key]) : '(unset)');
+    return;
+  }
+
+  if (sub === 'set') {
+    const value = valueParts.join(' ').trim();
+    if (!key || !value) { line(c.needValue); process.exitCode = 1; return; }
+    if (!SETTABLE.has(key)) { line(c.unknownKey(key)); process.exitCode = 1; return; }
+    if (key === 'profile') {
+      if (!PROFILE_VALUES.has(value)) { line(c.badProfile); process.exitCode = 1; return; }
+    } else if (key === 'lang') {
+      if (!VALID_LANGS.has(value)) { line(c.badLang); process.exitCode = 1; return; }
+    } else if (key !== 'profileUrl') {
+      const v = validateEndpoint(value);
+      if (!v.ok) { line(c.badEndpoint(key, v.reason)); process.exitCode = 1; return; }
+    }
+    const config = loadConfigFile(env);
+    config[key] = value;
+    try { saveConfigFile(config, env); } catch { line('could not write config.json'); process.exitCode = 1; return; }
+    line(c.saved(key, value));
+    return;
+  }
+
+  write(`\n  ${c.help}\n\n`);
+  process.exitCode = 1;
+}
+
+module.exports = { run, parseArgs, SETTABLE, ENDPOINT_KEYS };
+
+if (require.main === module) {
+  run();
+}

package/bin/experiences.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+'use strict';
+
+// `experiences` — the talent's work experiences (portfolios type=EXPERIENCE).
+
+const { detectReportLang, getCatalog } = require('../src/i18n');
+const { loadAuthSession, sessionStatus } = require('../src/auth-session-store');
+const { createStdinAsk } = require('../src/stdin-ask');
+const { makeIo } = require('./register');
+const { makeRevealSink } = require('../src/reveal-output');
+const { runPortfolioList, makePortfoliosDeps } = require('../src/portfolios-flow');
+
+function parseArgs(argv = []) {
+  const o = { lang: null, help: false, json: false };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === '--help' || a === '-h') o.help = true;
+    else if (a === '--lang') { const v = argv[++i]; o.lang = v === 'es' || v === 'en' ? v : null; }
+    else if (a.startsWith('--lang=')) { const v = a.slice(7); o.lang = v === 'es' || v === 'en' ? v : null; }
+    else if (a === '--json') o.json = true;
+  }
+  return o;
+}
+
+async function run(
+  argv = process.argv.slice(2),
+  { ask: injectedAsk = null, stdinIsTTY: ttyOverride = undefined, deps = null, session: injectedSession = null, out = null } = {},
+) {
+  const opts = parseArgs(argv);
+  const lang = opts.lang || detectReportLang();
+  const catalog = getCatalog(lang);
+  const fp = catalog.experiences;
+  const write = out || ((s) => process.stdout.write(s));
+
+  if (opts.help) {
+    write(fp.help + '\n');
+    return;
+  }
+
+  const session = injectedSession || loadAuthSession();
+  if (sessionStatus(session) !== 'active') {
+    process.stderr.write(`\n  ${fp.loginRequired}\n\n`);
+    process.exitCode = 1;
+    return;
+  }
+
+  const stdinIsTTY = ttyOverride !== undefined ? ttyOverride : !!process.stdin.isTTY;
+  const ask = injectedAsk || createStdinAsk();
+  const sink = makeRevealSink({ json: opts.json, out, env: process.env });
+  try {
+    const io = makeIo({ ask, lang, out: sink.write, stdinIsTTY });
+    const result = await runPortfolioList({
+      io, rawOut: sink.write, lang, session, catalog, kind: 'experiences',
+      opts: { json: opts.json },
+      deps: deps || makePortfoliosDeps(),
+    });
+    await sink.finish();
+    if (result && result.ok === false) process.exitCode = 1;
+    return result;
+  } finally {
+    if (!injectedAsk) ask.close();
+  }
+}
+
+module.exports = { run, parseArgs };
+
+if (require.main === module) {
+  run();
+}

package/bin/find-projects.js

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+'use strict';
+
+// `find-projects` — list the Positions/Projects available to the talent (src/find-projects-flow.js).
+
+const { detectReportLang, getCatalog } = require('../src/i18n');
+const { loadAuthSession, sessionStatus } = require('../src/auth-session-store');
+const { createStdinAsk } = require('../src/stdin-ask');
+const { makeIo } = require('./register');
+const { runFindProjects, makeFindProjectsDeps } = require('../src/find-projects-flow');
+const { makeRevealSink } = require('../src/reveal-output');
+
+function toInt(v) {
+  const n = Number.parseInt(v, 10);
+  return Number.isInteger(n) ? n : null;
+}
+
+function parseFindProjectsArgs(argv = []) {
+  const o = { lang: null, help: false, tab: null, json: false, limit: null, page: null, attendance: null, country: null, recommended: false };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === '--help' || a === '-h') o.help = true;
+    else if (a === '--lang') { const v = argv[++i]; o.lang = v === 'es' || v === 'en' ? v : null; }
+    else if (a.startsWith('--lang=')) { const v = a.slice(7); o.lang = v === 'es' || v === 'en' ? v : null; }
+    else if (a === '--tab') o.tab = argv[++i] != null ? argv[i] : null;
+    else if (a.startsWith('--tab=')) o.tab = a.slice('--tab='.length);
+    else if (a === '--limit') o.limit = toInt(argv[++i]);
+    else if (a.startsWith('--limit=')) o.limit = toInt(a.slice('--limit='.length));
+    else if (a === '--page') o.page = toInt(argv[++i]);
+    else if (a.startsWith('--page=')) o.page = toInt(a.slice('--page='.length));
+    else if (a === '--attendance') o.attendance = argv[++i] != null ? argv[i] : null;
+    else if (a.startsWith('--attendance=')) o.attendance = a.slice('--attendance='.length);
+    else if (a === '--country') o.country = argv[++i] != null ? argv[i] : null;
+    else if (a.startsWith('--country=')) o.country = a.slice('--country='.length);
+    else if (a === '--recommended') o.recommended = true;
+    else if (a === '--json') o.json = true;
+  }
+  return o;
+}
+
+async function run(
+  argv = process.argv.slice(2),
+  { ask: injectedAsk = null, stdinIsTTY: ttyOverride = undefined, deps = null, session: injectedSession = null, out = null } = {},
+) {
+  const opts = parseFindProjectsArgs(argv);
+  const lang = opts.lang || detectReportLang();
+  const catalog = getCatalog(lang);
+  const fp = catalog.findProjects;
+  const write = out || ((s) => process.stdout.write(s));
+
+  if (opts.help) {
+    write(fp.help + '\n');
+    return;
+  }
+
+  const session = injectedSession || loadAuthSession();
+  if (sessionStatus(session) !== 'active') {
+    process.stderr.write(`\n  ${fp.loginRequired}\n\n`);
+    process.exitCode = 1;
+    return;
+  }
+
+  const stdinIsTTY = ttyOverride !== undefined ? ttyOverride : !!process.stdin.isTTY;
+  const ask = injectedAsk || createStdinAsk();
+  const sink = makeRevealSink({ json: opts.json, out, env: process.env });
+  try {
+    const io = makeIo({ ask, lang, out: sink.write, stdinIsTTY });
+    const result = await runFindProjects({
+      io,
+      rawOut: sink.write,
+      session,
+      lang,
+      catalog,
+      opts: { tab: opts.tab, json: opts.json, limit: opts.limit, page: opts.page, attendance: opts.attendance, country: opts.country, recommended: opts.recommended },
+      deps: deps || makeFindProjectsDeps(),
+    });
+    await sink.finish();
+    if (result && result.ok === false) process.exitCode = 1;
+    return result;
+  } finally {
+    if (!injectedAsk) ask.close();
+  }
+}
+
+module.exports = { run, parseFindProjectsArgs };
+
+if (require.main === module) {
+  run();
+}

package/bin/invitations.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+'use strict';
+
+// `invitations` — the talent's unread position invitations (src/invitations-flow.js).
+
+const { detectReportLang, getCatalog } = require('../src/i18n');
+const { loadAuthSession, sessionStatus } = require('../src/auth-session-store');
+const { createStdinAsk } = require('../src/stdin-ask');
+const { makeIo } = require('./register');
+const { makeRevealSink } = require('../src/reveal-output');
+const { runInvitations, makeInvitationsDeps } = require('../src/invitations-flow');
+
+function parseInvitationsArgs(argv = []) {
+  const o = { lang: null, help: false, json: false };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === '--help' || a === '-h') o.help = true;
+    else if (a === '--lang') { const v = argv[++i]; o.lang = v === 'es' || v === 'en' ? v : null; }
+    else if (a.startsWith('--lang=')) { const v = a.slice(7); o.lang = v === 'es' || v === 'en' ? v : null; }
+    else if (a === '--json') o.json = true;
+  }
+  return o;
+}
+
+async function run(
+  argv = process.argv.slice(2),
+  { ask: injectedAsk = null, stdinIsTTY: ttyOverride = undefined, deps = null, session: injectedSession = null, out = null } = {},
+) {
+  const opts = parseInvitationsArgs(argv);
+  const lang = opts.lang || detectReportLang();
+  const catalog = getCatalog(lang);
+  const fp = catalog.invitations;
+  const write = out || ((s) => process.stdout.write(s));
+
+  if (opts.help) {
+    write(fp.help + '\n');
+    return;
+  }
+
+  const session = injectedSession || loadAuthSession();
+  if (sessionStatus(session) !== 'active') {
+    process.stderr.write(`\n  ${fp.loginRequired}\n\n`);
+    process.exitCode = 1;
+    return;
+  }
+
+  const stdinIsTTY = ttyOverride !== undefined ? ttyOverride : !!process.stdin.isTTY;
+  const ask = injectedAsk || createStdinAsk();
+  const sink = makeRevealSink({ json: opts.json, interactive: false, out, env: process.env });
+  try {
+    const io = makeIo({ ask, lang, out: sink.write, stdinIsTTY });
+    const result = await runInvitations({
+      io, rawOut: sink.write, session, catalog,
+      opts: { json: opts.json },
+      deps: deps || makeInvitationsDeps(),
+    });
+    await sink.finish();
+    if (result && result.ok === false) process.exitCode = 1;
+    return result;
+  } finally {
+    if (!injectedAsk) ask.close();
+  }
+}
+
+module.exports = { run, parseInvitationsArgs };
+
+if (require.main === module) {
+  run();
+}

package/bin/lang.js

@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+'use strict';
+
+// `lang` — view or set the talent's languages (src/lang-flow.js).
+
+const { detectReportLang, getCatalog } = require('../src/i18n');
+const { loadAuthSession, sessionStatus } = require('../src/auth-session-store');
+const { createStdinAsk } = require('../src/stdin-ask');
+const { makeIo } = require('./register');
+const { makeRevealSink } = require('../src/reveal-output');
+const { runLang, makeLangDeps } = require('../src/lang-flow');
+
+function parseLangArgs(argv = []) {
+  const o = { lang: null, help: false, json: false, set: false };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === '--help' || a === '-h') o.help = true;
+    else if (a === '--lang') { const v = argv[++i]; o.lang = v === 'es' || v === 'en' ? v : null; }
+    else if (a.startsWith('--lang=')) { const v = a.slice(7); o.lang = v === 'es' || v === 'en' ? v : null; }
+    else if (a === '--json') o.json = true;
+    else if (a === '--set') o.set = true;
+  }
+  return o;
+}
+
+async function run(
+  argv = process.argv.slice(2),
+  { ask: injectedAsk = null, stdinIsTTY: ttyOverride = undefined, deps = null, session: injectedSession = null, out = null } = {},
+) {
+  const opts = parseLangArgs(argv);
+  const lang = opts.lang || detectReportLang();
+  const catalog = getCatalog(lang);
+  const fp = catalog.lang;
+  const write = out || ((s) => process.stdout.write(s));
+
+  if (opts.help) {
+    write(fp.help + '\n');
+    return;
+  }
+
+  const session = injectedSession || loadAuthSession();
+  if (sessionStatus(session) !== 'active') {
+    process.stderr.write(`\n  ${fp.loginRequired}\n\n`);
+    process.exitCode = 1;
+    return;
+  }
+
+  const stdinIsTTY = ttyOverride !== undefined ? ttyOverride : !!process.stdin.isTTY;
+  const ask = injectedAsk || createStdinAsk();
+  const sink = makeRevealSink({ json: opts.json, interactive: !!opts.set, out, env: process.env });
+  try {
+    const io = makeIo({ ask, lang, out: sink.write, stdinIsTTY });
+    const result = await runLang({
+      io, rawOut: sink.write, ask, session, catalog,
+      opts: { json: opts.json, set: opts.set, stdinIsTTY },
+      deps: deps || makeLangDeps(),
+    });
+    await sink.finish();
+    if (result && result.ok === false) process.exitCode = 1;
+    return result;
+  } finally {
+    if (!injectedAsk) ask.close();
+  }
+}
+
+module.exports = { run, parseLangArgs };
+
+if (require.main === module) {
+  run();
+}