shakers-cli-beta 0.8.0-beta.0

package/bin/add-agent.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+'use strict';
+
+const { detectReportLang, getCatalog } = require('../src/i18n');
+const { loadAuthSession, sessionStatus } = require('../src/auth-session-store');
+const { createStdinAsk } = require('../src/stdin-ask');
+const { run: runLogin } = require('./login');
+const { runAddAgents } = require('../src/start-add-agents');
+
+const VALID_LANGS = new Set(['es', 'en']);
+
+const COPY = {
+  es: {
+    help: 'add-agent — añade a tu perfil de Talento un agente de tu inventario descubierto. Uso: add-agent [--lang es|en] [--accept-disclaimer]',
+    gate: '"add-agent" requiere una sesión activa.\n  Falta: iniciar sesión. Ejecuta primero: shakers login',
+    missingAccept: 'Modo no interactivo: falta --accept-disclaimer.\n  add-agent es un flujo interactivo (elegir agente, editar campos) y su borrado por IA envía datos.\n  Reejecuta con --accept-disclaimer, aportando las respuestas por stdin.',
+  },
+  en: {
+    help: 'add-agent — add an agent from your discovered inventory to your Talent profile. Usage: add-agent [--lang es|en] [--accept-disclaimer]',
+    gate: '"add-agent" requires an active session.\n  Missing: sign-in. Run `shakers login` first.',
+    missingAccept: 'Non-interactive mode: --accept-disclaimer is missing.\n  add-agent is an interactive flow (pick an agent, edit fields) and its AI draft sends data.\n  Re-run with --accept-disclaimer, feeding the answers over stdin.',
+  },
+};
+
+function parseArgs(argv) {
+  const o = { root: null, lang: null, help: false, acceptDisclaimer: false };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === '--root') o.root = argv[++i];
+    else if (a.startsWith('--root=')) o.root = a.slice(7);
+    else 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 === '--accept-disclaimer') o.acceptDisclaimer = true;
+    else if (a === '--help' || a === '-h') o.help = true;
+  }
+  return o;
+}
+
+async function run(
+  argv = process.argv.slice(2),
+  { ask: injectedAsk = null, stdinIsTTY: ttyOverride = undefined, session: injectedSession = null } = {},
+) {
+  const o = parseArgs(argv);
+  const lang = o.lang || detectReportLang();
+  const catalog = getCatalog(lang);
+  const c = COPY[lang] || COPY.en;
+
+  if (o.help) {
+    process.stdout.write(`\n  ${c.help}\n\n`);
+    return;
+  }
+
+  const session = injectedSession || loadAuthSession();
+  if (sessionStatus(session) !== 'active') {
+    process.stderr.write(`\n  ${c.gate}\n\n`);
+    process.exitCode = 1;
+    return;
+  }
+
+  const stdinIsTTY = ttyOverride !== undefined ? ttyOverride : !!process.stdin.isTTY;
+
+  if (!stdinIsTTY && !o.acceptDisclaimer) {
+    process.stderr.write(`\n  ${c.missingAccept}\n\n`);
+    process.exitCode = 1;
+    return;
+  }
+
+  const ask = injectedAsk || createStdinAsk();
+  try {
+    await runAddAgents({
+      ask,
+      catalog,
+      root: o.root || process.cwd(),
+      session,
+      stdinIsTTY,
+      preAccepted: o.acceptDisclaimer,
+      deps: { runLogin },
+    });
+  } finally {
+    if (!injectedAsk) ask.close();
+  }
+}
+
+module.exports = { run, parseArgs };
+
+if (require.main === module) {
+  run();
+}

package/bin/add-project.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+'use strict';
+
+const { detectReportLang, getCatalog } = require('../src/i18n');
+const { loadAuthSession, sessionStatus } = require('../src/auth-session-store');
+const { createStdinAsk } = require('../src/stdin-ask');
+const { run: runLogin } = require('./login');
+const { runAddPortfolio } = require('../src/start-add-portfolio');
+
+const VALID_LANGS = new Set(['es', 'en']);
+
+const COPY = {
+  es: {
+    help: 'add-project — añade este proyecto a tu portfolio de Talento. Uso: add-project [--root <dir>] [--lang es|en] [--accept-disclaimer]',
+    gate: '"add-project" requiere una sesión activa.\n  Falta: iniciar sesión. Ejecuta primero: shakers login',
+    missingAccept: 'Modo no interactivo: falta --accept-disclaimer.\n  add-project es un flujo interactivo (título, tipo, descripción, skills) y su borrador por IA envía datos.\n  Reejecuta con --accept-disclaimer, aportando las respuestas por stdin.',
+  },
+  en: {
+    help: 'add-project — add this project to your Talent portfolio. Usage: add-project [--root <dir>] [--lang es|en] [--accept-disclaimer]',
+    gate: '"add-project" requires an active session.\n  Missing: sign-in. Run `shakers login` first.',
+    missingAccept: 'Non-interactive mode: --accept-disclaimer is missing.\n  add-project is an interactive flow (title, type, description, skills) and its AI draft sends data.\n  Re-run with --accept-disclaimer, feeding the answers over stdin.',
+  },
+};
+
+function parseArgs(argv) {
+  const o = { root: null, lang: null, help: false, acceptDisclaimer: false };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === '--root') o.root = argv[++i];
+    else if (a.startsWith('--root=')) o.root = a.slice(7);
+    else 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 === '--accept-disclaimer') o.acceptDisclaimer = true;
+    else if (a === '--help' || a === '-h') o.help = true;
+  }
+  return o;
+}
+
+async function run(
+  argv = process.argv.slice(2),
+  { ask: injectedAsk = null, stdinIsTTY: ttyOverride = undefined, session: injectedSession = null } = {},
+) {
+  const o = parseArgs(argv);
+  const lang = o.lang || detectReportLang();
+  const catalog = getCatalog(lang);
+  const c = COPY[lang] || COPY.en;
+
+  if (o.help) {
+    process.stdout.write(`\n  ${c.help}\n\n`);
+    return;
+  }
+
+  const session = injectedSession || loadAuthSession();
+  if (sessionStatus(session) !== 'active') {
+    process.stderr.write(`\n  ${c.gate}\n\n`);
+    process.exitCode = 1;
+    return;
+  }
+
+  const stdinIsTTY = ttyOverride !== undefined ? ttyOverride : !!process.stdin.isTTY;
+
+  if (!stdinIsTTY && !o.acceptDisclaimer) {
+    process.stderr.write(`\n  ${c.missingAccept}\n\n`);
+    process.exitCode = 1;
+    return;
+  }
+
+  const ask = injectedAsk || createStdinAsk();
+  try {
+    await runAddPortfolio({
+      ask,
+      catalog,
+      root: o.root || process.cwd(),
+      session,
+      stdinIsTTY,
+      preAccepted: o.acceptDisclaimer,
+      deps: { runLogin },
+    });
+  } finally {
+    if (!injectedAsk) ask.close();
+  }
+}
+
+module.exports = { run, parseArgs };
+
+if (require.main === module) {
+  run();
+}

package/bin/add-role.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+'use strict';
+
+// `add-role` — add a role (GROWTH cluster) to the talent's profile (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 { runAddRole, 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.addHelp + '\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 runAddRole({ 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/add-skill.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+'use strict';
+
+const { detectReportLang, getCatalog } = require('../src/i18n');
+const { loadAuthSession, sessionStatus } = require('../src/auth-session-store');
+const { createStdinAsk } = require('../src/stdin-ask');
+const { run: runLogin } = require('./login');
+const { runAddSkills } = require('../src/start-add-skills');
+
+const VALID_LANGS = new Set(['es', 'en']);
+
+const COPY = {
+  es: {
+    help: 'add-skill — añade a tu perfil de Talento Skills de tu inventario descubierto. Uso: add-skill [--lang es|en] [--accept-disclaimer]',
+    gate: '"add-skill" requiere una sesión activa.\n  Falta: iniciar sesión. Ejecuta primero: shakers login',
+    missingAccept: 'Modo no interactivo: falta --accept-disclaimer.\n  add-skill es un flujo interactivo (elegir Skills de tu inventario descubierto) y su declaración envía datos.\n  Reejecuta con --accept-disclaimer, aportando las respuestas por stdin.',
+  },
+  en: {
+    help: 'add-skill — add Skills from your discovered inventory to your Talent profile. Usage: add-skill [--lang es|en] [--accept-disclaimer]',
+    gate: '"add-skill" requires an active session.\n  Missing: sign-in. Run `shakers login` first.',
+    missingAccept: 'Non-interactive mode: --accept-disclaimer is missing.\n  add-skill is an interactive flow (pick Skills from your discovered inventory) and its declaration sends data.\n  Re-run with --accept-disclaimer, feeding the answers over stdin.',
+  },
+};
+
+function parseArgs(argv) {
+  const o = { root: null, lang: null, help: false, acceptDisclaimer: false };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === '--root') o.root = argv[++i];
+    else if (a.startsWith('--root=')) o.root = a.slice(7);
+    else 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 === '--accept-disclaimer') o.acceptDisclaimer = true;
+    else if (a === '--help' || a === '-h') o.help = true;
+  }
+  return o;
+}
+
+async function run(
+  argv = process.argv.slice(2),
+  { ask: injectedAsk = null, stdinIsTTY: ttyOverride = undefined, session: injectedSession = null } = {},
+) {
+  const o = parseArgs(argv);
+  const lang = o.lang || detectReportLang();
+  const catalog = getCatalog(lang);
+  const c = COPY[lang] || COPY.en;
+
+  if (o.help) {
+    process.stdout.write(`\n  ${c.help}\n\n`);
+    return;
+  }
+
+  const session = injectedSession || loadAuthSession();
+  if (sessionStatus(session) !== 'active') {
+    process.stderr.write(`\n  ${c.gate}\n\n`);
+    process.exitCode = 1;
+    return;
+  }
+
+  const stdinIsTTY = ttyOverride !== undefined ? ttyOverride : !!process.stdin.isTTY;
+
+  if (!stdinIsTTY && !o.acceptDisclaimer) {
+    process.stderr.write(`\n  ${c.missingAccept}\n\n`);
+    process.exitCode = 1;
+    return;
+  }
+
+  const ask = injectedAsk || createStdinAsk();
+  try {
+    await runAddSkills({
+      ask,
+      catalog,
+      root: o.root || process.cwd(),
+      session,
+      stdinIsTTY,
+      preAccepted: o.acceptDisclaimer,
+      deps: { runLogin },
+    });
+  } finally {
+    if (!injectedAsk) ask.close();
+  }
+}
+
+module.exports = { run, parseArgs };
+
+if (require.main === module) {
+  run();
+}

package/bin/ai-usage.js

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+'use strict';
+
+const { classify } = require('../src/maturity');
+const { detectReportLang, getCatalog } = require('../src/i18n');
+const { parseArgs } = require('../src/cli-args');
+const { loadConsentState } = require('../src/share');
+const { handleOneShotCommand } = require('../src/usage-oneshot-commands');
+const {
+  resolveRepoScope,
+  machineWideToplevels,
+  promptScope,
+} = require('../src/usage-repo-scope');
+const {
+  performScan,
+  prepareIdentityAndUsage,
+  resolveAiConsent,
+  runAggregation,
+  runModelCalls,
+  renderAndFinalize,
+} = require('../src/usage-run-steps');
+
+// `run(argv, { ask })`: shared by the dispatcher and register flow; an injected
+// `ask` is caller-owned. `bypassThrottle` (options, not argv) stays register-only.
+async function run(argv = process.argv.slice(2), { ask: injectedAsk = null, bypassThrottle = false, inRegistration = false } = {}) {
+  const opts = parseArgs(argv);
+
+  // Resolve language first so even --help is localized.
+  const lang = opts.lang || detectReportLang();
+  const catalog = getCatalog(lang);
+
+  if (opts.help) {
+    process.stdout.write(catalog.cli.help);
+    return;
+  }
+
+  // One-shot commands (consent/endpoint config): act immediately, do NOT scan.
+  if (await handleOneShotCommand({ opts, catalog, injectedAsk })) return;
+
+  // 1. Local scan + classify (always computed and shown, ADR-011/013).
+  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.
+  const { gate: identityGate } = prepareIdentityAndUsage({ report, catalog });
+  const gate = (inRegistration && identityGate.showRoadmap)
+    ? { ...identityGate, showRoadmap: false }
+    : identityGate;
+
+  // 3. Consent gate before any AI/egress call (ADR-051); a decline still renders.
+  const aiConsentGranted = await resolveAiConsent({ opts, catalog, gate, injectedAsk });
+
+  // 4. Repo scoping (exclude client work).
+  const scope = await resolveRepoScope({ opts, cwd: rootDir, injectedAsk, catalog });
+  const consentEmail = (loadConsentState() || {}).email || null;
+  const agentRoots = scope.toplevels;
+
+  // 5. Aggregate scoped signals + rebuild scan/org-chart over the selection, re-classify.
+  runAggregation({ report, scope, consentEmail, agentRoots, root, catalog });
+  const maturity = classify(report);
+  const hasAgents = Array.isArray(report.agents) && report.agents.length > 0;
+  report.analyzedRepos =
+    scope.mode === 'all'
+      ? null
+      : scope.toplevels.map((tl) => tl.split(/[/\\]/).pop() || tl);
+
+  // 6. The three ephemeral model calls, serialized and gated by consent (ADR-051).
+  await runModelCalls({
+    report, maturity, aiConsentGranted, opts, gate, hasAgents, agentRoots, rootDir, lang, catalog,
+  });
+
+  // 7. Render (or emit --json), persist, optional --build-next-level, auto-share.
+  await renderAndFinalize({ report, maturity, lang, opts, root, gate, catalog, bypassThrottle });
+}
+
+module.exports = { run, resolveRepoScope, machineWideToplevels, promptScope };
+
+// Auto-run only when executed directly, not when require()'d by the dispatcher.
+if (require.main === module) {
+  run();
+}

package/bin/alma.js

@@ -0,0 +1,99 @@
+#!/usr/bin/env node
+'use strict';
+
+const { detectReportLang, getCatalog } = require('../src/i18n');
+const { loadAuthSession, sessionStatus } = require('../src/auth-session-store');
+const { createStdinAsk } = require('../src/stdin-ask');
+const { promptSelect } = require('../src/prompt-select');
+const { makeIo } = require('./register');
+const { runAlmaShell } = require('../src/alma-shell');
+const { makeAlmaDeps } = require('../src/alma-flow');
+const { run: runLogin } = require('./login');
+
+function parseArgs(argv = []) {
+  const o = { lang: null, help: false };
+  for (let i = 0; i < argv.length; i++) {
+    const x = argv[i];
+    if (x === '--help' || x === '-h') o.help = true;
+    else if (x === '--lang') { const v = argv[++i]; o.lang = v === 'es' || v === 'en' ? v : null; }
+    else if (x.startsWith('--lang=')) { const v = x.slice(7); o.lang = v === 'es' || v === 'en' ? v : null; }
+  }
+  return o;
+}
+
+async function ensureSession({ lang, catalog, ask, stdinIsTTY, out }) {
+  let session = loadAuthSession();
+  if (sessionStatus(session) === 'active') return session;
+  if (!stdinIsTTY) return null;
+
+  const r = catalog.cli.accountReminder;
+  const choice = await promptSelect({
+    ask,
+    stdinIsTTY,
+    out: (line) => out(`  ${line}\n`),
+    header: r.question,
+    hint: r.hint,
+    items: [{ id: 'yes', label: r.yes }, { id: 'no', label: r.no }],
+    labelFor: (it) => it.label,
+  });
+  if (!choice || choice.id !== 'yes') return null;
+
+  await runLogin(['--lang', lang]);
+  session = loadAuthSession();
+  return sessionStatus(session) === 'active' ? session : null;
+}
+
+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 a = catalog.alma;
+  const write = out || ((s) => process.stdout.write(s));
+  const d = deps || makeAlmaDeps();
+
+  if (opts.help) {
+    write(a.help + '\n');
+    return;
+  }
+
+  const stdinIsTTY = ttyOverride !== undefined ? ttyOverride : !!process.stdin.isTTY;
+  if (!stdinIsTTY && !injectedSession) {
+    process.stderr.write(`\n  ${a.needTty}\n\n`);
+    process.exitCode = 1;
+    return;
+  }
+
+  const ask = injectedAsk || createStdinAsk();
+  try {
+    const session = injectedSession
+      || (await ensureSession({ lang, catalog, ask, stdinIsTTY, out: write }));
+    if (!session) {
+      process.stderr.write(`\n  ${a.loginRequired}\n\n`);
+      process.exitCode = 1;
+      return;
+    }
+    const io = makeIo({ ask, lang, out: write, stdinIsTTY });
+    return await runAlmaShell({
+      io,
+      ask,
+      stdinIsTTY,
+      streamIsTTY: !!process.stdout.isTTY,
+      env: process.env,
+      rawOut: write,
+      session,
+      catalog,
+      deps: d,
+    });
+  } finally {
+    if (!injectedAsk) ask.close();
+  }
+}
+
+module.exports = { run, parseArgs };
+
+if (require.main === module) {
+  run();
+}

package/bin/applications.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+'use strict';
+
+// `applications` — the positions the talent applied to (src/applications-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 { runApplications, makeApplicationsDeps } = require('../src/applications-flow');
+
+function parseApplicationsArgs(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 = parseApplicationsArgs(argv);
+  const lang = opts.lang || detectReportLang();
+  const catalog = getCatalog(lang);
+  const fp = catalog.applications;
+  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 runApplications({
+      io, rawOut: sink.write, session, catalog,
+      opts: { json: opts.json },
+      deps: deps || makeApplicationsDeps(),
+    });
+    await sink.finish();
+    if (result && result.ok === false) process.exitCode = 1;
+    return result;
+  } finally {
+    if (!injectedAsk) ask.close();
+  }
+}
+
+module.exports = { run, parseApplicationsArgs };
+
+if (require.main === module) {
+  run();
+}

package/bin/availability.js

@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+'use strict';
+
+// `availability` — view or set the talent's availability (src/availability-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 { runAvailability, makeAvailabilityDeps } = require('../src/availability-flow');
+
+function parseAvailabilityArgs(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 = parseAvailabilityArgs(argv);
+  const lang = opts.lang || detectReportLang();
+  const catalog = getCatalog(lang);
+  const fp = catalog.availability;
+  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 runAvailability({
+      io, rawOut: sink.write, ask, session, catalog,
+      opts: { json: opts.json, set: opts.set, stdinIsTTY },
+      deps: deps || makeAvailabilityDeps(),
+    });
+    await sink.finish();
+    if (result && result.ok === false) process.exitCode = 1;
+    return result;
+  } finally {
+    if (!injectedAsk) ask.close();
+  }
+}
+
+module.exports = { run, parseAvailabilityArgs };
+
+if (require.main === module) {
+  run();
+}