@rathnasgala/cli 0.0.22 → 1.1.4

package/src/preview-command.js

@@ -1,60 +0,0 @@
-import { spawn } from 'node:child_process';
-import path from 'node:path';
-
-import { regenerateBuildManifest } from './validate-command.js';
-
-const BUILD_WARNING_DELAY_MS = (5 * 60 * 1000) + 1;
-const INITIAL_BUILD_COMPLETE = /\bWrote \d+ files?\b/;
-
-export async function previewSite({
-  root,
-  today,
-  spawnProcess = spawn,
-  schedule = setTimeout,
-  cancel = clearTimeout,
-  output = process.stdout,
-  warningOutput = process.stderr
-}) {
-  const siteRoot = path.resolve(root);
-  const { results: validation } = await regenerateBuildManifest({ root: siteRoot, today });
-  const failures = validation.filter(({ errors }) => errors.length > 0);
-  if (failures.length > 0) {
-    throw new Error(`Preview refused: ${failures.length} post variant(s) failed validation`);
-  }
-
-  const cli = path.join(siteRoot, 'node_modules', '@11ty', 'eleventy', 'cmd.cjs');
-  const child = spawnProcess(process.execPath, [cli, '--serve', '--watch'], {
-    cwd: siteRoot,
-    env: { ...process.env, GALA_EVALUATION_DATE: today },
-    shell: false,
-    stdio: ['inherit', 'pipe', 'pipe']
-  });
-
-  return new Promise((resolve, reject) => {
-    let initialOutput = '';
-    let warningTimer = schedule(() => {
-      warningOutput.write('warning\tbuild-duration-5m\n');
-      warningTimer = undefined;
-    }, BUILD_WARNING_DELAY_MS);
-    const stopTimer = () => {
-      if (warningTimer !== undefined) cancel(warningTimer);
-      warningTimer = undefined;
-    };
-    child.stdout?.on('data', (chunk) => {
-      output.write(chunk);
-      initialOutput = `${initialOutput}${chunk}`.slice(-256);
-      if (INITIAL_BUILD_COMPLETE.test(initialOutput)) stopTimer();
-    });
-    child.stderr?.on('data', (chunk) => warningOutput.write(chunk));
-    child.once('error', (error) => {
-      stopTimer();
-      reject(error);
-    });
-    child.once('exit', (code, signal) => {
-      stopTimer();
-      if (signal) reject(new Error(`Preview terminated by signal ${signal}`));
-      else if (code !== 0) reject(new Error(`Preview exited with code ${code}`));
-      else resolve();
-    });
-  });
-}

package/src/publication-creation-client.js

@@ -1,155 +0,0 @@
-/**
- * Creates the publication repository the way the browser editor does.
- *
- * The CLI used to call `POST /repos/{template}/generate` itself. That is a second, worse
- * implementation of something the API already does and does properly:
- *
- *  - it tries the template, then falls back to creating an empty repository and seeding it, then
- *    reports that the writer must do it by hand — the CLI's single attempt had no rung below it;
- *  - it waits for the Gala App installation to actually reach the new repository before calling it
- *    ready, which is why repositories the CLI created never appeared in the web UI;
- *  - it returns the installation id, so registration cannot disagree with creation about which
- *    installation owns the repository.
- *
- * One implementation, exercised by both clients, is the only way the two stay in step.
- */
-import { describeHttpFailure } from './http-failure.js';
-import { exchangeGithubAuthorization } from './site-registration-client.js';
-
-export async function createPublication({
-  apiBaseUrl = 'https://api.gala67.com',
-  galaAccessToken,
-  githubAccessToken,
-  name,
-  fetchImpl = fetch,
-  authorize = exchangeGithubAuthorization,
-  notify = () => {},
-  ask,
-  openUrl = () => false,
-  shareAttempts = 3,
-  selfLogin
-}) {
-  let created = false;
-  let shareUrl = 'https://github.com/settings/installations';
-  let repositoryOwner = selfLogin ?? '';
-  let repositoryName = name;
-  for (let attempt = 0; attempt < Math.max(1, shareAttempts); attempt += 1) {
-    const result = await requestPublication({
-      apiBaseUrl, galaAccessToken, githubAccessToken, name, fetchImpl, authorize
-    });
-    if (result.ready) return result.publication;
-
-    /*
-     * The repository exists with the right content; the App installation simply cannot see it,
-     * because it is scoped to selected repositories rather than all of them. Sharing it is a click,
-     * and asking again then returns READY — the server short-circuits on a repository it can
-     * already see. The browser editor recovers the same way; without this the CLI dead-ends on a
-     * state that is one click from working.
-     *
-     * After the first attempt the repository exists, so a further refusal reports UNSUPPORTED
-     * rather than NEEDS_SHARING — the same situation under a different name.
-     */
-    const shareable = result.status === 'NEEDS_SHARING' || created;
-    if (result.status === 'NEEDS_SHARING') {
-      created = true;
-      shareUrl = installationSettingsUrl(result.installationId, result.owner, selfLogin);
-      repositoryName = result.repository ?? repositoryName;
-      repositoryOwner = result.owner ?? repositoryOwner;
-    }
-    if (!shareable) throw result.failure;
-    if (typeof ask !== 'function') {
-      /*
-       * No terminal to prompt at — CI, or a piped run. The repository exists and is one grant from
-       * working, so the failure has to carry everything needed to finish it by hand. Falling back
-       * to the generic message here threw away the deep link that had just been computed.
-       */
-      throw new Error(
-        `${repositoryOwner}/${repositoryName} was created, but the Gala GitHub App cannot reach it `
-        + `yet. Add that one repository to the installation at ${shareUrl}, then run scaffold again.`
-      );
-    }
-
-    notify(`${repositoryOwner}/${repositoryName} was created, but the Gala GitHub App cannot reach `
-      + 'it yet — its installation covers only selected repositories, which is the right way to '
-      + 'have it. Add this one repository to the installation; nothing else needs granting.');
-    notify(`${openUrl(shareUrl) ? 'Opened' : 'Open'} ${shareUrl}`);
-    await ask('Press enter once the App can access that repository. ');
-  }
-  throw new Error(
-    `The Gala GitHub App still cannot reach ${repositoryOwner}/${repositoryName}. Add that `
-    + `repository to the installation at ${shareUrl}, then run scaffold again.`
-  );
-}
-
-/**
- * The page that grants one repository, rather than the list of every app ever installed.
- *
- * GitHub keeps user and organisation installation settings on different paths, and only the caller
- * knows which this is: the created owner differing from the token's own account means the
- * installation lives on an organisation.
- */
-export function installationSettingsUrl(installationId, owner, selfLogin) {
-  const generic = 'https://github.com/settings/installations';
-  if (!Number.isSafeInteger(Number(installationId)) || Number(installationId) <= 0) return generic;
-  const isOrganization = typeof owner === 'string' && typeof selfLogin === 'string'
-    && owner.toLowerCase() !== selfLogin.toLowerCase();
-  return isOrganization
-    ? `https://github.com/organizations/${encodeURIComponent(owner)}/settings/installations/${installationId}`
-    : `https://github.com/settings/installations/${installationId}`;
-}
-
-async function requestPublication({
-  apiBaseUrl, galaAccessToken, githubAccessToken, name, fetchImpl, authorize
-}) {
-  const authorization = await authorize({
-    apiBaseUrl, galaAccessToken, githubAccessToken, fetchImpl
-  });
-  const response = await fetchImpl(`${String(apiBaseUrl).replace(/\/$/, '')}/v1/auth/github/publications`, {
-    method: 'POST',
-    headers: {
-      accept: 'application/json',
-      authorization: `Bearer ${galaAccessToken}`,
-      'content-type': 'application/json',
-      'GitHub-Authorization': authorization
-    },
-    body: JSON.stringify({ name })
-  });
-  if (!response.ok) throw new Error(await describeHttpFailure(response, 'Gala publication creation'));
-
-  const payload = await response.json();
-  const status = payload?.status;
-  const owner = payload?.owner;
-  const repository = payload?.name;
-
-  if (status !== 'READY') {
-    return {
-      ready: false, status, owner, repository,
-      // Carried even though the repository is not in the installation yet: it is what makes the
-      // grant a deep link rather than a hunt.
-      installationId: payload?.installationId,
-      failure: new Error(
-        `Gala could not create the publication repository (${payload?.outcome ?? status}). `
-        + 'Give the Gala GitHub App access to it at https://github.com/settings/installations, or '
-        + 'create it from https://github.com/rathnasgala/site-template yourself and run scaffold '
-        + 'with --empty-existing-repository.'
-      )
-    };
-  }
-  if (typeof owner !== 'string' || typeof repository !== 'string') {
-    throw new TypeError('Gala publication creation returned no repository identity');
-  }
-  const installationId = Number(payload?.installationId);
-  if (!Number.isSafeInteger(installationId) || installationId <= 0) {
-    throw new TypeError('Gala publication creation returned no installation');
-  }
-
-  return { ready: true, status, owner, repository, publication: Object.freeze({
-    owner,
-    repository,
-    installationId,
-    outcome: payload?.outcome ?? null,
-    // The server names the repository it actually made, which may differ from what was asked for.
-    fullName: `${owner}/${repository}`,
-    cloneUrl: `https://github.com/${owner}/${repository}.git`
-  }) };
-}

package/src/publication-state.js

@@ -1,7 +0,0 @@
-import {
-  PUBLICATION_STATE_PATH,
-  readPublicationState,
-  recordSuccessfulDeployment
-} from '@rathnasgala/content-validation';
-
-export { PUBLICATION_STATE_PATH, readPublicationState, recordSuccessfulDeployment };

package/src/publish-command.js

@@ -1,37 +0,0 @@
-import path from 'node:path';
-import { spawn } from 'node:child_process';
-import { regenerateBuildManifest } from './validate-command.js';
-
-export async function publishSite({
-  root,
-  today,
-  force = false,
-  spawnProcess = spawn,
-  warn = (message) => process.stderr.write(`${message}\n`)
-}) {
-  const siteRoot = path.resolve(root);
-  if (!force) {
-    const { results } = await regenerateBuildManifest({ root: siteRoot, today });
-    const failures = results.filter(({ errors }) => errors.length > 0);
-    if (failures.length > 0) {
-      throw new Error(`Publish refused: ${failures.length} post variant(s) failed validation`);
-    }
-    for (const result of results) {
-      for (const warning of result.warnings) warn(`${result.file}: warning: ${warning}`);
-    }
-  }
-
-  return new Promise((resolve, reject) => {
-    const child = spawnProcess('git', ['-C', siteRoot, 'push'], {
-      cwd: siteRoot,
-      shell: false,
-      stdio: 'inherit'
-    });
-    child.once('error', reject);
-    child.once('exit', (code, signal) => {
-      if (signal) reject(new Error(`Publish terminated by signal ${signal}`));
-      else if (code !== 0) reject(new Error(`Git push exited with code ${code}`));
-      else resolve();
-    });
-  });
-}

package/src/record-deployment-command.js

@@ -1,147 +0,0 @@
-import { readFile } from 'node:fs/promises';
-import { lstat } from 'node:fs/promises';
-import { spawn } from 'node:child_process';
-import { createHash } from 'node:crypto';
-import path from 'node:path';
-import { parseFrontmatter } from '@rathnasgala/content-validation';
-
-import { repositoryEvaluationDate } from './evaluation-date.js';
-import { recordSuccessfulDeployment } from './publication-state.js';
-import { BUILD_MANIFEST_PATH } from './validate-command.js';
-
-function runGit(root, args, spawnProcess) {
-  return new Promise((resolve, reject) => {
-    const child = spawnProcess('git', ['-C', root, ...args], {
-      cwd: root,
-      shell: false,
-      stdio: 'inherit'
-    });
-    child.once('error', reject);
-    child.once('exit', (code, signal) => {
-      if (signal) reject(new Error(`Git terminated by signal ${signal}`));
-      else resolve(code);
-    });
-  });
-}
-
-function readHead(root, spawnProcess) {
-  return new Promise((resolve, reject) => {
-    const child = spawnProcess('git', ['-C', root, 'rev-parse', '--verify', 'HEAD'], {
-      cwd: root,
-      shell: false,
-      stdio: ['ignore', 'pipe', 'inherit']
-    });
-    let output = '';
-    child.stdout?.on('data', (chunk) => { output += chunk; });
-    child.once('error', reject);
-    child.once('exit', (code, signal) => {
-      if (signal) reject(new Error(`Git terminated by signal ${signal}`));
-      else if (code !== 0) reject(new Error(`Git rev-parse exited with code ${code}`));
-      else {
-        const sha = output.trim();
-        if (!/^[0-9a-f]{40}$/.test(sha)) reject(new Error('Git returned an invalid HEAD SHA'));
-        else resolve(sha);
-      }
-    });
-  });
-}
-
-async function assignedContentPaths(root, manifest) {
-  const assigned = manifest.assignedContentIds ?? [];
-  if (!Array.isArray(assigned)) throw new TypeError('assignedContentIds must be a list');
-  const sources = new Set();
-  for (const item of assigned) {
-    if (item == null
-        || typeof item.source !== 'string'
-        || !/^content\/posts\/[a-z0-9]+(?:-[a-z0-9]+)*\/index\.[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*\.md$/.test(item.source)
-        || typeof item.id !== 'string'
-        || !/^[0-7][0-9A-HJKMNP-TV-Z]{25}$/.test(item.id)
-        || typeof item.fileHash !== 'string'
-        || !/^[a-f0-9]{64}$/.test(item.fileHash)
-        || sources.has(item.source)) {
-      throw new TypeError('assignedContentIds contains an invalid entry');
-    }
-    const file = path.resolve(root, item.source);
-    const metadata = await lstat(file);
-    if (!metadata.isFile() || metadata.isSymbolicLink()) {
-      throw new TypeError(`Assigned-ID source must be a regular file: ${item.source}`);
-    }
-    const bytes = await readFile(file);
-    if (createHash('sha256').update(bytes).digest('hex') !== item.fileHash) {
-      throw new Error(`Assigned-ID source changed after the deployed build: ${item.source}`);
-    }
-    const parsed = parseFrontmatter(bytes.toString('utf8'));
-    if (parsed.errors.length > 0 || parsed.data.id !== item.id) {
-      throw new Error(`Assigned-ID source no longer contains its deployed ULID: ${item.source}`);
-    }
-    sources.add(item.source);
-  }
-  return [...sources].sort();
-}
-
-export async function recordDeployment({
-  root,
-  deployedOn,
-  now,
-  deployedCommitSha,
-  spawnProcess = spawn
-}) {
-  const siteRoot = path.resolve(root);
-  const manifestPath = path.join(siteRoot, BUILD_MANIFEST_PATH);
-  let manifest;
-  try {
-    manifest = JSON.parse(await readFile(manifestPath, 'utf8'));
-  } catch (error) {
-    if (error.code === 'ENOENT') {
-      throw new Error('Current validated build manifest is missing; deployment cannot be recorded');
-    }
-    throw new TypeError(`Current validated build manifest is invalid: ${error.message}`);
-  }
-  const date = deployedOn ?? await repositoryEvaluationDate({ root: siteRoot, now });
-  if (typeof deployedCommitSha !== 'string' || !/^[0-9a-f]{40}$/.test(deployedCommitSha)) {
-    throw new TypeError('record-deployment requires --commit-sha <lowercase 40-character SHA>');
-  }
-  const head = await readHead(siteRoot, spawnProcess);
-  if (deployedCommitSha !== head) {
-    throw new Error(`Deployment SHA ${deployedCommitSha} does not match checkout HEAD ${head}`);
-  }
-  const state = await recordSuccessfulDeployment({
-    root: siteRoot,
-    manifest,
-    deployedOn: date,
-    deployedCommitSha
-  });
-  const statePath = '.gala/publication-state.yml';
-  const contentPaths = await assignedContentPaths(siteRoot, manifest);
-  const committedPaths = [statePath, ...contentPaths];
-  const addCode = await runGit(siteRoot, ['add', '--', ...committedPaths], spawnProcess);
-  if (addCode !== 0) throw new Error(`Git add exited with code ${addCode}`);
-  const diffCode = await runGit(
-    siteRoot,
-    ['diff', '--cached', '--quiet', '--exit-code', '--', ...committedPaths],
-    spawnProcess
-  );
-  if (diffCode === 0) return { state, pushed: false, recordedStateSha: head };
-  if (diffCode !== 1) throw new Error(`Git diff exited with code ${diffCode}`);
-  const assignmentTrailers = (manifest.assignedContentIds ?? []).map(
-    ({ id, source }) => `Gala-Assigned-ID: ${id} ${source}`
-  );
-  const commitMessage = [
-    'chore(gala): record successful deployment [skip ci]',
-    '',
-    `Gala-Deployed-SHA: ${deployedCommitSha}`,
-    ...assignmentTrailers
-  ].join('\n');
-  const commitCode = await runGit(siteRoot, [
-    'commit', '--only', '-m', commitMessage,
-    '--', ...committedPaths
-  ], spawnProcess);
-  if (commitCode !== 0) throw new Error(`Git commit exited with code ${commitCode}`);
-  const recordedStateSha = await readHead(siteRoot, spawnProcess);
-  if (recordedStateSha === deployedCommitSha) {
-    throw new Error('Git did not create a distinct recorded-state commit');
-  }
-  const pushCode = await runGit(siteRoot, ['push'], spawnProcess);
-  if (pushCode !== 0) throw new Error(`Git push exited with code ${pushCode}`);
-  return { state, pushed: true, recordedStateSha };
-}

package/src/refresh-command.js

@@ -1,104 +0,0 @@
-import { lstat, readFile, rename, rm, writeFile } from 'node:fs/promises';
-import path from 'node:path';
-import { spawn } from 'node:child_process';
-import { parse } from 'yaml';
-
-import { readGalaCredential } from './gala-credential-store.js';
-
-const ULID = /^[0-7][0-9A-HJKMNP-TV-Z]{25}$/;
-const UTC_INSTANT = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{3})?Z$/;
-const SNAPSHOT_PATH = '.engagement-snapshot.json';
-
-async function runGit(root, args) {
-  return new Promise((resolve, reject) => {
-    const child = spawn('git', ['-C', root, ...args], { shell: false, stdio: 'inherit' });
-    child.once('error', reject);
-    child.once('exit', (code, signal) => {
-      if (signal) reject(new Error(`git terminated by signal ${signal}`));
-      else if (code !== 0) reject(new Error(`git ${args[0]} exited with code ${code}`));
-      else resolve();
-    });
-  });
-}
-
-async function commitRefreshedSnapshot(root, relativePath) {
-  await runGit(root, [
-    'commit', '--only', '--message', 'chore(gala): refresh engagement snapshot', '--', relativePath
-  ]);
-  await runGit(root, ['push']);
-}
-
-function validateSnapshot(payload) {
-  if (payload?.schemaVersion !== 1 || !UTC_INSTANT.test(payload.refreshedAt)
-      || payload.articles == null || Array.isArray(payload.articles)
-      || typeof payload.articles !== 'object') {
-    throw new TypeError('Engagement snapshot response is invalid');
-  }
-  for (const [articleId, counts] of Object.entries(payload.articles)) {
-    if (!ULID.test(articleId) || counts == null || Array.isArray(counts)
-        || typeof counts !== 'object'
-        || Object.keys(counts).sort().join(',') !== 'comments,reactions,views'
-        || !['reactions', 'comments', 'views'].every(
-          (field) => Number.isSafeInteger(counts[field]) && counts[field] >= 0
-        )) {
-      throw new TypeError('Engagement snapshot response is invalid');
-    }
-  }
-  return payload;
-}
-
-async function requireRegularFile(target, label, { allowMissing = false } = {}) {
-  try {
-    const metadata = await lstat(target);
-    if (!metadata.isFile() || metadata.isSymbolicLink()) {
-      throw new TypeError(`${label} must be a regular file`);
-    }
-    return true;
-  } catch (error) {
-    if (allowMissing && error.code === 'ENOENT') return false;
-    throw error;
-  }
-}
-
-export async function refreshEngagementSnapshot({
-  root = process.cwd(),
-  readCredential = readGalaCredential,
-  fetchImpl = fetch,
-  commitSnapshot = commitRefreshedSnapshot
-} = {}) {
-  const siteRoot = path.resolve(root);
-  const configPath = path.join(siteRoot, 'site.config.yml');
-  await requireRegularFile(configPath, 'site.config.yml');
-  const config = parse(await readFile(configPath, 'utf8'));
-  const siteId = config?.site?.id;
-  if (!ULID.test(siteId)) throw new TypeError('site.config.yml site.id must be a canonical ULID');
-
-  const credential = await readCredential();
-  const endpoint = new URL(`/v1/sites/${siteId}/engagement-snapshot`, credential.apiBaseUrl);
-  const loopback = endpoint.protocol === 'http:'
-    && ['127.0.0.1', 'localhost', '::1'].includes(endpoint.hostname);
-  if ((endpoint.protocol !== 'https:' && !loopback) || endpoint.username || endpoint.password) {
-    throw new TypeError('Gala API URL must be credential-free HTTPS or HTTP loopback');
-  }
-  const response = await fetchImpl(endpoint, {
-    method: 'GET',
-    headers: { Authorization: `Bearer ${credential.accessToken}`, Accept: 'application/json' }
-  });
-  if (!response.ok) throw new Error(`Engagement snapshot refresh failed with HTTP ${response.status}`);
-  const snapshot = validateSnapshot(await response.json());
-  const next = `${JSON.stringify(snapshot, null, 2)}\n`;
-  const target = path.join(siteRoot, SNAPSHOT_PATH);
-  const exists = await requireRegularFile(target, 'Engagement snapshot', { allowMissing: true });
-  if (exists && await readFile(target, 'utf8') === next) return Object.freeze({ changed: false });
-
-  const temporary = `${target}.gala-${process.pid}`;
-  try {
-    await writeFile(temporary, next, { flag: 'wx' });
-    await rename(temporary, target);
-  } catch (error) {
-    await rm(temporary, { force: true });
-    throw error;
-  }
-  await commitSnapshot(siteRoot, SNAPSHOT_PATH);
-  return Object.freeze({ changed: true });
-}

package/src/repository-limits.js

@@ -1,94 +0,0 @@
-import { spawn } from 'node:child_process';
-import { lstat, readdir } from 'node:fs/promises';
-import path from 'node:path';
-
-const MEBIBYTE = 1024 * 1024;
-
-function gitRepositoryBytes(root, spawnProcess) {
-  return new Promise((resolve, reject) => {
-    const child = spawnProcess('git', ['-C', root, 'count-objects', '-v'], {
-      cwd: root,
-      shell: false,
-      stdio: ['ignore', 'pipe', 'pipe']
-    });
-    let output = '';
-    let errors = '';
-    child.stdout.on('data', (chunk) => { output += chunk; });
-    child.stderr.on('data', (chunk) => { errors += chunk; });
-    child.once('error', reject);
-    child.once('exit', (code, signal) => {
-      if (signal) return reject(new Error(`Repository inspection terminated by signal ${signal}`));
-      if (code !== 0) return reject(new Error(`Repository inspection failed: ${errors.trim()}`));
-      const values = Object.fromEntries(output.trim().split('\n').map((line) => {
-        const separator = line.indexOf(':');
-        return [line.slice(0, separator), Number(line.slice(separator + 1).trim())];
-      }));
-      if (!Number.isFinite(values.size) || !Number.isFinite(values['size-pack'])) {
-        return reject(new Error('Git returned invalid repository size metadata'));
-      }
-      resolve((values.size + values['size-pack']) * 1024);
-    });
-  });
-}
-
-async function countPosts(directory) {
-  const entries = await readdir(directory, { withFileTypes: true });
-  const counts = await Promise.all(entries.map((entry) => {
-    if (entry.isDirectory()) return countPosts(path.join(directory, entry.name));
-    return Promise.resolve(entry.isFile() && /^index\.[^.]+\.md$/.test(entry.name) ? 1 : 0);
-  }));
-  return counts.reduce((total, count) => total + count, 0);
-}
-
-export function repositoryLimitWarnings({ repositoryBytes, postCount, buildDurationMs }) {
-  const warnings = [];
-  if (repositoryBytes > 800 * MEBIBYTE) {
-    warnings.push({ severity: 'critical', code: 'repository-size-800mb' });
-  } else if (repositoryBytes > 500 * MEBIBYTE) {
-    warnings.push({ severity: 'warning', code: 'repository-size-500mb' });
-  }
-  if (postCount > 1000) warnings.push({ severity: 'warning', code: 'post-count-1000' });
-  if (buildDurationMs != null && buildDurationMs > 5 * 60 * 1000) {
-    warnings.push({ severity: 'warning', code: 'build-duration-5m' });
-  }
-  return warnings;
-}
-
-export async function inspectRepositoryLimits(root, { spawnProcess = spawn, buildDurationMs } = {}) {
-  const resolvedRoot = path.resolve(root);
-  const [repositoryBytes, postCount] = await Promise.all([
-    gitRepositoryBytes(resolvedRoot, spawnProcess),
-    countPosts(path.join(resolvedRoot, 'content', 'posts'))
-  ]);
-  return {
-    repositoryBytes,
-    postCount,
-    warnings: repositoryLimitWarnings({ repositoryBytes, postCount, buildDurationMs })
-  };
-}
-
-export async function reportRepositoryLimitWarnings(
-  root,
-  { spawnProcess = spawn, output = process.stderr } = {}
-) {
-  const resolvedRoot = path.resolve(root);
-  try {
-    const [gitMetadata, config, posts] = await Promise.all([
-      lstat(path.join(resolvedRoot, '.git')),
-      lstat(path.join(resolvedRoot, 'site.config.yml')),
-      lstat(path.join(resolvedRoot, 'content', 'posts'))
-    ]);
-    if ((!gitMetadata.isDirectory() && !gitMetadata.isFile())
-      || !config.isFile() || config.isSymbolicLink()
-      || !posts.isDirectory() || posts.isSymbolicLink()) {
-      return [];
-    }
-  } catch (error) {
-    if (error.code === 'ENOENT') return [];
-    throw error;
-  }
-
-  const { warnings } = await inspectRepositoryLimits(resolvedRoot, { spawnProcess });
-  for (const { severity, code } of warnings) output.write(`${severity}\t${code}\n`);
-  return warnings;
-}