@ethlete/cli 2.0.1-next.2 → 2.1.0-next.10

package/design/web/host.ts

@@ -0,0 +1,445 @@
+import type { Call, CallVariant, CallRound } from '@design-explore';
+import { calls, defaultCall } from 'virtual:design-explore';
+import './host.css';
+
+/** The contact sheet draws about five 1100px frames per screen at this scale. */
+const SHEET_SCALE = 0.32;
+
+const params = new URLSearchParams(location.search);
+const slugs = Object.keys(calls);
+const asked = params.get('call') ?? '';
+const landing = defaultCall && slugs.includes(defaultCall) ? defaultCall : (slugs.at(-1) ?? '');
+const slug = slugs.includes(asked) ? asked : landing;
+const view = params.get('view') === 'sheet' ? 'sheet' : 'rounds';
+const opened = new Set((params.get('open') ?? '').split(',').filter(Boolean));
+const picked = (params.get('pick') ?? '').split(',').filter(Boolean);
+
+const esc = (text: string) => text.replace(/[&<>]/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;' })[c] ?? c);
+
+const link = (next: Record<string, string | null>) => {
+  const url = new URLSearchParams(params);
+  for (const [name, value] of Object.entries(next)) {
+    if (value === null) url.delete(name);
+    else url.set(name, value);
+  }
+  return `?${url}`;
+};
+
+const listLink = (name: string, list: string[], key: string) => {
+  const next = list.includes(key) ? list.filter((entry) => entry !== key) : [...list, key];
+  return link({ [name]: next.length > 0 ? next.join(',') : null });
+};
+
+const toggleOpen = (key: string) => listLink('open', [...opened], key);
+const togglePick = (key: string) => listLink('pick', picked, key);
+
+type Band = { key: string | null; number: number; round: CallRound | null; variants: CallVariant[] };
+
+/**
+ * The variants are the call. A band exists because a variant names it, never because `rounds`
+ * declares it, so a variant added without its round entry still gets a band, a heading and a
+ * menu row - all three say the bare key until somebody writes the prose.
+ */
+const bandsOf = (call: Call): Band[] => {
+  const declared = new Map((call.rounds ?? []).map((round) => [round.key, round]));
+  const bands = new Map<string, Band>();
+
+  for (const variant of call.variants) {
+    const key = variant.round ?? '';
+    const band = bands.get(key) ?? { key: key || null, number: 0, round: declared.get(key) ?? null, variants: [] };
+    band.variants.push(variant);
+    bands.set(key, band);
+  }
+
+  let number = 0;
+  for (const band of bands.values()) if (band.key) band.number = ++number;
+
+  return [...bands.values()];
+};
+
+/** Prose that no variant claims is stale prose, and it is the one thing the variants cannot show. */
+const problemsOf = (call: Call, bands: Band[]) => {
+  const keys = (call.rounds ?? []).map((round) => round.key);
+  const drawn = new Set(bands.map((band) => band.key));
+
+  return [
+    ...[...new Set(keys.filter((key, index) => keys.indexOf(key) !== index))].map(
+      (key) => `two rounds share the key "${key}"`,
+    ),
+    ...keys.filter((key) => !drawn.has(key)).map((key) => `round "${key}" has no variants`),
+  ];
+};
+
+/**
+ * A call is resolved once every round has ruled and at least one round has a winner. Its rounds
+ * then draw nothing, because each winner is the one before it plus a change, so the last of them
+ * already holds all the others.
+ */
+const chainOf = (bands: Band[]) => {
+  const named = bands.filter((band) => band.key);
+  const ruled = named.length > 1 && named.every((band) => band.variants.every((variant) => variant.verdict));
+  const chain = named
+    .map((band) => band.variants.find((variant) => variant.verdict === 'chosen'))
+    .filter((variant): variant is CallVariant => !!variant);
+
+  return ruled && chain.length > 0 ? chain : [];
+};
+
+/** A call's folder path is its place in the tree, so the sidebar nests on the path segments. */
+const tree = (bands: Band[]) => {
+  const groups = new Map<string, string[]>();
+  for (const s of slugs) {
+    const parts = s.split('/');
+    const group = parts.slice(0, -1).join(' / ');
+    groups.set(group, [...(groups.get(group) ?? []), s]);
+  }
+
+  const named = bands.filter((band) => band.key);
+
+  const rounds = (s: string) =>
+    s !== slug || view === 'sheet' || named.length < 2
+      ? ''
+      : `<div class="nav-rounds">${named
+          .map(
+            (band) =>
+              `<a href="#round-${esc(band.key ?? '')}">${band.number} · ${esc(band.round?.title ?? band.key ?? '')}</a>`,
+          )
+          .join('')}</div>`;
+
+  return [...groups]
+    .map(
+      ([group, members]) => `
+      <section>
+        ${group ? `<h3>${esc(group)}</h3>` : ''}
+        ${members
+          .map(
+            (s) =>
+              `<a href="${link({ call: s, open: null, pick: null })}" ${s === slug ? 'aria-current="page"' : ''}>${esc(
+                s.split('/').at(-1) ?? s,
+              )}</a>${rounds(s)}`,
+          )
+          .join('')}
+      </section>`,
+    )
+    .join('');
+};
+
+const load = slug ? calls[slug] : undefined;
+
+if (!load) {
+  document.body.innerHTML = `<p class="empty">No call under .ethlete/design/calls.</p>`;
+} else {
+  const call: Call = (await load()).default;
+  const bands = bandsOf(call);
+  const chain = chainOf(bands);
+  const result = chain.at(-1);
+  const isView = call.variants.length === 1 && !call.variants[0]?.claim;
+  const geometry = `--frame-width:${call.frameWidth}px`;
+
+  const frame = (variant: CallVariant) => `
+    <iframe
+      src="frame.html?call=${encodeURIComponent(slug)}&variant=${encodeURIComponent(variant.key)}"
+      data-variant="${esc(variant.key)}"
+      title="${esc(variant.name)}"
+      style="width:${call.frameWidth}px"
+    ></iframe>`;
+
+  const column = (variant: CallVariant) => `
+    <div class="column" data-verdict="${variant.verdict ?? 'open'}" ${picked.includes(variant.key) ? 'data-picked' : ''}>
+      ${
+        isView
+          ? ''
+          : `<h3>
+        <a href="${togglePick(variant.key)}">${esc(variant.name)}</a>
+        <span class="tag">${variant.verdict ?? 'open'}</span>
+      </h3>`
+      }
+      <div class="stage">${frame(variant)}</div>
+      ${variant.claim ? `<p class="claim">${esc(variant.claim)}</p>` : ''}
+      ${variant.cost ? `<p class="cost">${esc(variant.cost)}</p>` : ''}
+    </div>`;
+
+  const grid = (variants: CallVariant[]) =>
+    variants.length === 0
+      ? ''
+      : `<div class="grid" style="${geometry}" ${isView ? 'data-view' : ''}>${variants.map(column).join('')}</div>`;
+
+  const rows = (variants: CallVariant[]) =>
+    variants.length === 0
+      ? ''
+      : `<ul class="folded">${variants
+          .map(
+            (variant) =>
+              `<li data-verdict="${variant.verdict ?? 'open'}"><a href="${togglePick(variant.key)}">${esc(
+                variant.name,
+              )}</a><span class="tag">${variant.verdict ?? 'open'}</span></li>`,
+          )
+          .join('')}</ul>`;
+
+  const band = ({ key, number, round, variants }: Band) => {
+    const settled = variants.every((variant) => variant.verdict);
+    const open = !key || !settled || opened.has(key);
+    const drawn = open ? variants : chain.length > 0 ? [] : variants.filter((variant) => variant.verdict === 'chosen');
+    const folded = variants.filter((variant) => !drawn.includes(variant));
+
+    const head = !key
+      ? ''
+      : `<div class="round-head">
+          <span class="eyebrow">Round ${number}${settled ? ' · settled' : ''}</span>
+          <h2>${esc(round?.title ?? key)}</h2>
+          ${round?.note ? `<p>${esc(round.note)}</p>` : ''}
+          ${
+            settled
+              ? `<a class="fold" href="${toggleOpen(key)}">${
+                  open ? `Fold ${variants.length} variants away` : `Show all ${variants.length} variants`
+                }</a>`
+              : ''
+          }
+        </div>`;
+
+    return `
+      <section class="round" ${key ? `id="round-${esc(key)}"` : ''}>
+        ${head}
+        ${grid(drawn)}
+        ${rows(folded)}
+      </section>`;
+  };
+
+  /** Each step is the one before it plus a change, so the arrow is the order they were drawn in. */
+  const trail = () =>
+    chain
+      .map((variant) => {
+        const band = bands.find((entry) => entry.variants.includes(variant));
+        const target = band?.key ? `${toggleOpen(band.key)}#round-${band.key}` : togglePick(variant.key);
+        return `<a href="${esc(target)}" ${variant === result ? 'aria-current="step"' : ''}>${esc(
+          variant.key.toUpperCase(),
+        )}</a>`;
+      })
+      .join('<span class="arrow">→</span>');
+
+  const resultBand = () =>
+    !result
+      ? ''
+      : `<section class="round result">
+          <div class="round-head">
+            <span class="eyebrow">Result</span>
+            <h2>${esc(result.name)}</h2>
+            ${result.claim ? `<p>${esc(result.claim)}</p>` : ''}
+            <div class="trail">${trail()}</div>
+          </div>
+          <div class="grid" style="${geometry}">
+            <div class="column" data-verdict="chosen">
+              <div class="stage">${frame(result)}</div>
+              ${result.cost ? `<p class="cost">${esc(result.cost)}</p>` : ''}
+            </div>
+          </div>
+        </section>`;
+
+  const tray = () => {
+    const variants = picked
+      .map((key) => call.variants.find((variant) => variant.key === key))
+      .filter((variant): variant is CallVariant => !!variant);
+    if (variants.length === 0) return '';
+
+    const two = variants.length === 2;
+
+    return `
+      <section class="round tray">
+        <div class="round-head">
+          <span class="eyebrow">Compare · ${variants.length}</span>
+          <h2>${variants.map((variant) => esc(variant.name)).join('  ·  ')}</h2>
+          <div class="switch">
+            ${variants
+              .map((variant, index) => `<button data-step="${index}">${esc(variant.key.toUpperCase())}</button>`)
+              .join('')}
+            <span class="hint">${
+              two ? 'click or space to blink · arrows to wipe' : 'click or space for the next one'
+            }</span>
+          </div>
+          <a class="fold" href="${link({ pick: null })}">Clear the comparison</a>
+        </div>
+        <div class="overlay" data-two="${two}" style="width:${call.frameWidth}px">
+          ${variants.map(frame).join('')}
+          <div class="seam"></div>
+        </div>
+      </section>`;
+  };
+
+  const sheet = () => `
+    <div class="grid sheet" style="${geometry};--de-scale:${SHEET_SCALE}">
+      ${call.variants
+        .map(
+          (variant) => `
+        <a class="thumb" href="${togglePick(variant.key)}" data-verdict="${variant.verdict ?? 'open'}" ${
+          picked.includes(variant.key) ? 'data-picked' : ''
+        }>
+          <div class="thumb-frame">${frame(variant)}</div>
+          <span class="thumb-name">${esc(variant.name)}</span>
+        </a>`,
+        )
+        .join('')}
+    </div>`;
+
+  const views = () =>
+    isView
+      ? ''
+      : `<div class="views">
+          <a href="${link({ view: null })}" ${view === 'rounds' ? 'aria-current="page"' : ''}>rounds</a>
+          <a href="${link({ view: 'sheet' })}" ${view === 'sheet' ? 'aria-current="page"' : ''}>all ${
+            call.variants.length
+          }</a>
+        </div>`;
+
+  document.body.innerHTML = `
+    <nav>${tree(bands)}</nav>
+    <main>
+      <header>
+        <span class="eyebrow">${esc(call.eyebrow)}</span>
+        <h1>${esc(call.headline)}</h1>
+        <p>${esc(call.intro)}</p>
+        ${views()}
+      </header>
+      ${problemsOf(call, bands)
+        .map((problem) => `<p class="problem">design-explore: ${esc(problem)}</p>`)
+        .join('')}
+      ${tray()}
+      ${view === 'sheet' ? sheet() : `${resultBand()}${bands.map(band).join('')}`}
+    </main>`;
+}
+
+/**
+ * A frame reports its height late, so the page grows under the reader for a second or two after
+ * load. The scroll is put back on every one of those reports, until the reader scrolls or the
+ * frames go quiet, because a single restore lands on a page that is still the wrong height.
+ */
+const scrollKey = `design-explore:scroll:${slug}:${view}`;
+
+history.scrollRestoration = 'manual';
+
+let restoring = true;
+const target = Number(sessionStorage.getItem(scrollKey) ?? 0);
+
+const stopRestore = () => {
+  restoring = false;
+};
+
+if (target > 0 && !location.hash) {
+  for (const event of ['wheel', 'touchstart', 'keydown', 'pointerdown'] as const) {
+    addEventListener(event, stopRestore, { once: true, passive: true });
+  }
+  setTimeout(stopRestore, 3000);
+  scrollTo(0, target);
+} else {
+  restoring = false;
+}
+
+addEventListener(
+  'scroll',
+  () => {
+    if (!restoring) sessionStorage.setItem(scrollKey, String(Math.round(scrollY)));
+  },
+  { passive: true },
+);
+
+const heights = new Map<string, number>();
+
+/** The overlay is as tall as its tallest pick, so no frame is cut and none of them move. */
+const size = () => {
+  for (const frame of document.querySelectorAll<HTMLIFrameElement>('iframe[data-variant]')) {
+    const height = heights.get(frame.dataset.variant ?? '');
+    if (!height) continue;
+
+    frame.style.height = `${height}px`;
+
+    const box = frame.parentElement;
+    if (box?.classList.contains('thumb-frame')) box.style.height = `${Math.ceil(height * SHEET_SCALE)}px`;
+  }
+
+  const overlay = document.querySelector<HTMLElement>('.overlay');
+  if (!overlay) return;
+
+  const tallest = [...overlay.querySelectorAll<HTMLIFrameElement>('iframe')]
+    .map((frame) => heights.get(frame.dataset.variant ?? '') ?? 0)
+    .reduce((a, b) => Math.max(a, b), 0);
+
+  if (tallest > 0) overlay.style.height = `${tallest}px`;
+};
+
+addEventListener('message', (event) => {
+  const data = event.data as { type?: string; variant?: string; height?: number };
+  if (data?.type !== 'design-explore:height' || !data.height || !data.variant) return;
+
+  heights.set(data.variant, data.height);
+  size();
+
+  if (restoring) scrollTo(0, target);
+});
+
+/**
+ * Two drawings that differ by a few pixels can only be told apart in one place, so the picks are
+ * stacked at full size and the reader switches between them. Two picks also get a wipe: the
+ * second one is clipped from the left, so dragging the seam turns one into the other.
+ */
+const overlay = document.querySelector<HTMLElement>('.overlay');
+
+if (overlay) {
+  const frames = [...overlay.querySelectorAll<HTMLIFrameElement>('iframe')];
+  const steps = [...document.querySelectorAll<HTMLButtonElement>('.switch button')];
+  const seam = overlay.querySelector<HTMLElement>('.seam');
+  const two = overlay.dataset.two === 'true';
+
+  let wipe = 50;
+  let active = 0;
+
+  const paint = () => {
+    frames.forEach((frame, index) => {
+      if (two && index === 1) {
+        frame.style.clipPath = `inset(0 0 0 ${wipe}%)`;
+        frame.style.opacity = '1';
+      } else if (two) {
+        frame.style.opacity = '1';
+      } else {
+        frame.style.opacity = index === active ? '1' : '0';
+      }
+    });
+
+    if (seam) {
+      seam.style.left = `${wipe}%`;
+      seam.hidden = !two || wipe === 0 || wipe === 100;
+    }
+
+    const shown = two ? (wipe > 50 ? 0 : 1) : active;
+    steps.forEach((step, index) => step.toggleAttribute('aria-current', index === shown));
+  };
+
+  const next = () => {
+    if (two) wipe = wipe > 50 ? 0 : 100;
+    else active = (active + 1) % frames.length;
+    paint();
+  };
+
+  const go = (index: number) => {
+    if (two) wipe = index === 0 ? 100 : 0;
+    else active = index;
+    paint();
+  };
+
+  steps.forEach((step, index) => step.addEventListener('click', () => go(index)));
+  overlay.addEventListener('click', next);
+
+  addEventListener('keydown', (event) => {
+    if (event.target !== document.body) return;
+
+    if (event.key === ' ') next();
+    else if (two && event.key === 'ArrowLeft') wipe = Math.max(0, wipe - 5);
+    else if (two && event.key === 'ArrowRight') wipe = Math.min(100, wipe + 5);
+    else if (!two && event.key === 'ArrowLeft') active = (active - 1 + frames.length) % frames.length;
+    else if (!two && event.key === 'ArrowRight') active = (active + 1) % frames.length;
+    else return;
+
+    event.preventDefault();
+    paint();
+  });
+
+  paint();
+}

package/design/web/index.html

@@ -0,0 +1,11 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>Design explore</title>
+  </head>
+  <body>
+    <script type="module" src="./host.ts"></script>
+  </body>
+</html>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ethlete/cli",
-  "version": "2.0.1-next.2",
+  "version": "2.1.0-next.10",
   "license": "MIT",
   "type": "commonjs",
   "main": "./src/index.js",
@@ -8,8 +8,19 @@
   "bin": {
     "et": "./src/index.js"
   },
+  "dependencies": {
+    "@tailwindcss/postcss": "4.3.3",
+    "typescript": "6.0.3",
+    "vite": "8.1.5"
+  },
   "peerDependencies": {
+    "playwright": "1.61.1",
     "tslib": "2.8.1"
   },
+  "peerDependenciesMeta": {
+    "playwright": {
+      "optional": true
+    }
+  },
   "types": "./src/index.d.ts"
 }

package/src/index.d.ts

@@ -1 +1 @@
-export {};
+export * from './lib';

package/src/index.js

@@ -2,19 +2,105 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 const lib_1 = require("./lib");
+const USAGE_ROWS = [
+    { subcommand: 'release', args: '', lines: ['Turn pending changesets into a tagged, pushed release commit'] },
+    {
+        subcommand: 'api',
+        args: ' <cmd> <api>',
+        lines: [
+            "Run an API from this repo's ethlete.apis.js locally",
+            "(up, down, logs, shell, setup, plus that API's own exec entries)",
+        ],
+    },
+    {
+        subcommand: 'auth',
+        args: ' [host] <token>',
+        lines: [
+            "Write a GitLab token into composer's auth.json, which the",
+            'API containers mount, after checking it can download code',
+        ],
+    },
+    {
+        subcommand: 'doctor',
+        args: '',
+        lines: ["Check this machine's ethlete.config.local.json, container engine", 'and every API checkout'],
+    },
+    {
+        subcommand: 'design',
+        args: ' [checkout]',
+        lines: [
+            "Serve the design page of a checkout's .ethlete/design folder,",
+            'or run `design check` to find out why a call does not render',
+        ],
+    },
+    {
+        subcommand: 'update',
+        args: ' [packages...]',
+        lines: ['Move the @ethlete/* packages to a newer version and run the', 'migrations those versions ship'],
+    },
+];
+const usage = (root) => {
+    const rows = USAGE_ROWS.map((row) => (Object.assign(Object.assign({}, row), { command: `${(0, lib_1.repoInvocation)({ root, subcommand: row.subcommand })}${row.args}` })));
+    const width = Math.max(...rows.map((row) => row.command.length));
+    return [
+        'et — Ethlete repo tooling',
+        '',
+        ...rows.flatMap((row) => row.lines.map((line, index) => `  ${(index === 0 ? row.command : '').padEnd(width)}  ${line}`)),
+        '',
+    ].join('\n');
+};
 const cli = (args) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
-    const cliFunctionArg = args[0];
-    switch (cliFunctionArg) {
+    switch (args[0]) {
         case 'release':
-            yield (0, lib_1.release)(args);
-            break;
+            // `release` reads its flags from a list that was split on "=" before this switch existed.
+            // Keep that shape here so its own parsing is untouched.
+            yield (0, lib_1.release)(args.join('=').split('='));
+            return 0;
+        case 'api':
+            return (0, lib_1.apiCommand)({
+                root: process.cwd(),
+                argv: args.slice(1),
+                invocation: (0, lib_1.repoInvocation)({ root: process.cwd(), subcommand: 'api' }),
+            });
+        case 'auth':
+            return (0, lib_1.authCommand)({
+                root: process.cwd(),
+                argv: args.slice(1),
+                invocation: (0, lib_1.repoInvocation)({ root: process.cwd(), subcommand: 'auth' }),
+            });
+        case 'design':
+            return (0, lib_1.designCommand)({
+                root: process.cwd(),
+                argv: args.slice(1),
+                invocation: (0, lib_1.repoInvocation)({ root: process.cwd(), subcommand: 'design' }),
+            });
+        case 'update':
+            return (0, lib_1.updateCommand)({
+                root: process.cwd(),
+                argv: args.slice(1),
+                invocation: (0, lib_1.repoInvocation)({ root: process.cwd(), subcommand: 'update' }),
+            });
+        case 'doctor':
+            // Every fix it names is an `et api` command, so it needs that script rather than its own.
+            return (0, lib_1.doctorCommand)({
+                root: process.cwd(),
+                apiInvocation: (0, lib_1.repoInvocation)({ root: process.cwd(), subcommand: 'api' }),
+            });
         default:
-            console.log(`No command found named ${cliFunctionArg}. Available commands are: release`);
-            break;
+            console.log(usage(process.cwd()));
+            return args[0] === undefined || args[0] === '--help' || args[0] === '-h' ? 0 : 1;
     }
 });
-// Get the command line arguments and normalize them
-const args = process.argv.slice(2).join('=').split('=');
-cli(args);
-// Burst cache
+tslib_1.__exportStar(require("./lib"), exports);
+// Guarded so the package can also be imported as a library without running the CLI.
+if (require.main === module) {
+    cli(process.argv.slice(2))
+        .then((code) => {
+        process.exitCode = code;
+    })
+        .catch((error) => {
+        console.error(error instanceof Error ? error.message : error);
+        process.exitCode = 1;
+    });
+}
 //# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/cli/src/index.ts"],"names":[],"mappings":";;;AAAA,+BAAgC;AAEhC,MAAM,GAAG,GAAG,CAAO,IAAc,EAAE,EAAE;IACnC,MAAM,cAAc,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAE/B,QAAQ,cAAc,EAAE,CAAC;QACvB,KAAK,SAAS;YACZ,MAAM,IAAA,aAAO,EAAC,IAAI,CAAC,CAAC;YACpB,MAAM;QAER;YACE,OAAO,CAAC,GAAG,CAAC,0BAA0B,cAAc,mCAAmC,CAAC,CAAC;YACzF,MAAM;IACV,CAAC;AACH,CAAC,CAAA,CAAC;AAEF,oDAAoD;AACpD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAExD,GAAG,CAAC,IAAI,CAAC,CAAC;AAEV,cAAc"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/cli/src/index.ts"],"names":[],"mappings":"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"}

package/src/lib/api/api-command.d.ts

@@ -0,0 +1,5 @@
+export declare const apiCommand: ({ root, argv, invocation }: {
+    root: string;
+    argv: string[];
+    invocation?: string;
+}) => 1 | Promise<number>;

package/src/lib/api/api-command.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.apiCommand = void 0;
+const load_definitions_1 = require("./load-definitions");
+const run_1 = require("./run");
+const apiCommand = ({ root, argv, invocation }) => {
+    const { found, apis } = (0, load_definitions_1.loadApiDefinitions)(root);
+    if (!found) {
+        console.error(`No API definitions found. Create ${load_definitions_1.API_DEFINITIONS_FILE_NAMES[0]} in the repo root:\n\n` +
+            `  const { sshKeyPath } = require('@ethlete/cli');\n\n` +
+            `  module.exports = {\n` +
+            `    hub: {\n` +
+            `      composeDir: 'development',\n` +
+            `      services: ['app', 'database'],\n` +
+            `      execService: 'app',\n` +
+            `      port: 8040,\n` +
+            `      envFile: '.env',\n` +
+            `      setupCommand: 'make setup',\n` +
+            `      exec: { install: ['composer', 'install'] },\n` +
+            `    },\n` +
+            `  };`);
+        return 1;
+    }
+    return (0, run_1.runApiCommand)({ apis, argv, root, invocation });
+};
+exports.apiCommand = apiCommand;
+//# sourceMappingURL=api-command.js.map

package/src/lib/api/api-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-command.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/api/api-command.ts"],"names":[],"mappings":";;;AAAA,yDAAoF;AACpF,+BAAsC;AAE/B,MAAM,UAAU,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAyD,EAAE,EAAE;IAC9G,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAA,qCAAkB,EAAC,IAAI,CAAC,CAAC;IAEjD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CACX,oCAAoC,6CAA0B,CAAC,CAAC,CAAC,wBAAwB;YACvF,uDAAuD;YACvD,wBAAwB;YACxB,cAAc;YACd,oCAAoC;YACpC,wCAAwC;YACxC,6BAA6B;YAC7B,qBAAqB;YACrB,0BAA0B;YAC1B,qCAAqC;YACrC,qDAAqD;YACrD,UAAU;YACV,MAAM,CACT,CAAC;QAEF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,IAAA,mBAAa,EAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;AACzD,CAAC,CAAC;AAxBW,QAAA,UAAU,cAwBrB"}

package/src/lib/api/auth-hint.d.ts

@@ -0,0 +1,16 @@
+/**
+ * A private dependency that will not download is the most common way these commands fail, and git
+ * and the package managers report it as a bare 403 or a public-key error. This says what to check.
+ */
+export declare const printPrivateDependencyHint: (options: {
+    repoHost?: string;
+}) => void;
+/** The host of a git url, for naming it in the hint. Undefined when the url has no host. */
+export declare const gitUrlHost: (repoUrl: string) => string | undefined;
+/**
+ * The host a user names on the command line, which is often pasted as a url: `https://git.example.com/`
+ * holds the same host as `git.example.com`. Undefined when there is no host name in it at all.
+ */
+export declare const gitHostFromInput: (value: string) => string | undefined;
+/** The `group/project` part of a git url, for addressing the project in a host's own API. */
+export declare const gitUrlProjectPath: (repoUrl: string) => string | undefined;