@rathnasgala/cli 0.0.22 → 1.1.4

package/src/github-pages-provisioning.js

@@ -1,107 +0,0 @@
-import { describeHttpFailure } from './http-failure.js';
-const GITHUB_API_VERSION = '2026-03-10';
-const SEGMENT = /^[A-Za-z0-9_.-]+$/;
-const SHA = /^[0-9a-f]{40}$/;
-
-function required(value, field, pattern = null) {
-  if (typeof value !== 'string' || value.length === 0 || (pattern != null && !pattern.test(value))) {
-    throw new TypeError(`${field} is invalid`);
-  }
-  return value;
-}
-
-function headers(accessToken) {
-  return {
-    accept: 'application/vnd.github+json',
-    authorization: `Bearer ${accessToken}`,
-    'content-type': 'application/json',
-    'x-github-api-version': GITHUB_API_VERSION
-  };
-}
-
-async function json(response, operation) {
-  if (!response.ok) throw new Error(await describeHttpFailure(response, `GitHub ${operation}`));
-  return response.json();
-}
-
-export async function provisionGithubPages({
-  owner, repository, accessToken, commitSha, fetchImpl = fetch,
-  customDomain = null,
-  sleep = (milliseconds) => new Promise((resolve) => setTimeout(resolve, milliseconds)),
-  pollIntervalMs = 5_000, maxPolls = 120
-}) {
-  const normalizedOwner = required(owner, 'owner', SEGMENT);
-  const normalizedRepository = required(repository, 'repository', SEGMENT);
-  const token = required(accessToken, 'accessToken');
-  const sha = required(commitSha, 'commitSha', SHA);
-  if (customDomain != null && (typeof customDomain !== 'string'
-      || !/^(?=.{1,253}$)(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/.test(customDomain))) {
-    throw new TypeError('customDomain is invalid');
-  }
-  if (!Number.isSafeInteger(pollIntervalMs) || pollIntervalMs < 0) {
-    throw new TypeError('pollIntervalMs must be a non-negative safe integer');
-  }
-  if (!Number.isSafeInteger(maxPolls) || maxPolls <= 0) {
-    throw new TypeError('maxPolls must be a positive safe integer');
-  }
-  const requestHeaders = headers(token);
-  const repositoryUrl = `https://api.github.com/repos/${encodeURIComponent(normalizedOwner)}/${encodeURIComponent(normalizedRepository)}`;
-  const query = new URLSearchParams({ event: 'push', head_sha: sha, per_page: '10' });
-  let run = null;
-  for (let poll = 0; poll < maxPolls; poll += 1) {
-    const response = await fetchImpl(`${repositoryUrl}/actions/workflows/publish.yml/runs?${query}`, {
-      method: 'GET', headers: requestHeaders
-    });
-    const payload = await json(response, 'publish workflow runs request');
-    run = payload.workflow_runs?.find((candidate) => candidate.head_sha === sha) ?? null;
-    if (run?.status === 'completed') break;
-    if (poll + 1 < maxPolls) await sleep(pollIntervalMs);
-  }
-  if (run == null || run.status !== 'completed') {
-    throw new Error(`Timed out waiting for the publish workflow for ${sha}`);
-  }
-  if (run.conclusion !== 'success') {
-    throw new Error(`Initial publish workflow failed: ${run.html_url}`);
-  }
-  const branch = await fetchImpl(`${repositoryUrl}/branches/gh-pages`, {
-    method: 'GET', headers: requestHeaders
-  });
-  if (!branch.ok) {
-    throw new Error(`Successful publish run created no gh-pages branch: ${run.html_url}`);
-  }
-  const current = await fetchImpl(`${repositoryUrl}/pages`, { method: 'GET', headers: requestHeaders });
-  if (current.ok) {
-    const configuration = await current.json();
-    if (configuration.source?.branch !== 'gh-pages' || configuration.source?.path !== '/') {
-      throw new Error('Existing GitHub Pages configuration does not use gh-pages at /');
-    }
-    if ((configuration.cname ?? null) !== customDomain) {
-      const updated = await fetchImpl(`${repositoryUrl}/pages`, {
-        method: 'PUT', headers: requestHeaders,
-        body: JSON.stringify({ cname: customDomain, source: { branch: 'gh-pages', path: '/' } })
-      });
-      if (updated.status !== 204) {
-        throw new Error(`GitHub Pages custom-domain update failed with HTTP ${updated.status}`);
-      }
-    }
-    return Object.freeze({ created: false, url: configuration.html_url, runUrl: run.html_url });
-  }
-  if (current.status !== 404) {
-    throw new Error(await describeHttpFailure(current, 'GitHub Pages configuration request'));
-  }
-  const created = await fetchImpl(`${repositoryUrl}/pages`, {
-    method: 'POST', headers: requestHeaders,
-    body: JSON.stringify({ source: { branch: 'gh-pages', path: '/' } })
-  });
-  const configuration = await json(created, 'Pages activation');
-  if (customDomain != null) {
-    const updated = await fetchImpl(`${repositoryUrl}/pages`, {
-      method: 'PUT', headers: requestHeaders,
-      body: JSON.stringify({ cname: customDomain, source: { branch: 'gh-pages', path: '/' } })
-    });
-    if (updated.status !== 204) {
-      throw new Error(`GitHub Pages custom-domain update failed with HTTP ${updated.status}`);
-    }
-  }
-  return Object.freeze({ created: true, url: configuration.html_url, runUrl: run.html_url });
-}

package/src/github-repository-secret.js

@@ -1,82 +0,0 @@
-import sodium from 'libsodium-wrappers';
-
-const GITHUB_API_VERSION = '2026-03-10';
-const OWNER_OR_REPOSITORY = /^[A-Za-z0-9_.-]+$/;
-const SECRET_NAME = /^[A-Z_][A-Z0-9_]*$/;
-
-function required(value, field, pattern) {
-  if (typeof value !== 'string' || !pattern.test(value)) {
-    throw new TypeError(`${field} is invalid`);
-  }
-  return value;
-}
-
-function requiredSecret(value, field) {
-  if (typeof value !== 'string' || value.length === 0) {
-    throw new TypeError(`${field} must not be empty`);
-  }
-  return value;
-}
-
-function headers(accessToken) {
-  return {
-    accept: 'application/vnd.github+json',
-    authorization: `Bearer ${accessToken}`,
-    'content-type': 'application/json',
-    'x-github-api-version': GITHUB_API_VERSION
-  };
-}
-
-async function requireSuccess(response, operation) {
-  if (!response?.ok) {
-    const status = Number.isInteger(response?.status) ? response.status : 'unknown';
-    throw new Error(`GitHub ${operation} failed with HTTP ${status}`);
-  }
-}
-
-export async function installRepositorySecret({
-  owner,
-  repository,
-  accessToken,
-  secretName,
-  secretValue,
-  fetchImpl = fetch,
-  sodiumImpl = sodium
-}) {
-  const normalizedOwner = required(owner, 'owner', OWNER_OR_REPOSITORY);
-  const normalizedRepository = required(repository, 'repository', OWNER_OR_REPOSITORY);
-  const normalizedSecretName = required(secretName, 'secretName', SECRET_NAME);
-  const token = requiredSecret(accessToken, 'accessToken');
-  const plaintext = requiredSecret(secretValue, 'secretValue');
-
-  await sodiumImpl.ready;
-
-  const baseUrl = `https://api.github.com/repos/${encodeURIComponent(normalizedOwner)}/${encodeURIComponent(normalizedRepository)}/actions/secrets`;
-  const publicKeyResponse = await fetchImpl(`${baseUrl}/public-key`, {
-    method: 'GET',
-    headers: headers(token)
-  });
-  await requireSuccess(publicKeyResponse, 'repository public-key request');
-  const publicKeyPayload = await publicKeyResponse.json();
-  const keyId = requiredSecret(publicKeyPayload?.key_id, 'GitHub key_id');
-  const publicKey = requiredSecret(publicKeyPayload?.key, 'GitHub public key');
-
-  const ciphertext = sodiumImpl.crypto_box_seal(
-    sodiumImpl.from_string(plaintext),
-    sodiumImpl.from_base64(publicKey, sodiumImpl.base64_variants.ORIGINAL)
-  );
-  const encryptedValue = sodiumImpl.to_base64(
-    ciphertext,
-    sodiumImpl.base64_variants.ORIGINAL
-  );
-
-  const uploadResponse = await fetchImpl(
-    `${baseUrl}/${encodeURIComponent(normalizedSecretName)}`,
-    {
-      method: 'PUT',
-      headers: headers(token),
-      body: JSON.stringify({ encrypted_value: encryptedValue, key_id: keyId })
-    }
-  );
-  await requireSuccess(uploadResponse, 'repository secret upload');
-}

package/src/github-repository-variable.js

@@ -1,56 +0,0 @@
-import { describeHttpFailure } from './http-failure.js';
-const GITHUB_API_VERSION = '2026-03-10';
-const OWNER_OR_REPOSITORY = /^[A-Za-z0-9_.-]+$/;
-const VARIABLE_NAME = /^[A-Z_][A-Z0-9_]*$/;
-
-function required(value, field, pattern) {
-  if (typeof value !== 'string' || !pattern.test(value)) {
-    throw new TypeError(`${field} is invalid`);
-  }
-  return value;
-}
-
-function requiredValue(value, field) {
-  if (typeof value !== 'string' || value.length === 0) {
-    throw new TypeError(`${field} must not be empty`);
-  }
-  return value;
-}
-
-function headers(accessToken) {
-  return {
-    accept: 'application/vnd.github+json',
-    authorization: `Bearer ${accessToken}`,
-    'content-type': 'application/json',
-    'x-github-api-version': GITHUB_API_VERSION
-  };
-}
-
-export async function installRepositoryVariable({
-  owner, repository, accessToken, variableName, variableValue, fetchImpl = fetch
-}) {
-  const normalizedOwner = required(owner, 'owner', OWNER_OR_REPOSITORY);
-  const normalizedRepository = required(repository, 'repository', OWNER_OR_REPOSITORY);
-  const normalizedName = required(variableName, 'variableName', VARIABLE_NAME);
-  const token = requiredValue(accessToken, 'accessToken');
-  const value = requiredValue(variableValue, 'variableValue');
-  const baseUrl = `https://api.github.com/repos/${encodeURIComponent(normalizedOwner)}/${encodeURIComponent(normalizedRepository)}/actions/variables`;
-  const requestHeaders = headers(token);
-  const update = await fetchImpl(`${baseUrl}/${encodeURIComponent(normalizedName)}`, {
-    method: 'PATCH',
-    headers: requestHeaders,
-    body: JSON.stringify({ name: normalizedName, value })
-  });
-  if (update.ok) return;
-  if (update.status !== 404) {
-    throw new Error(await describeHttpFailure(update, 'GitHub repository variable update'));
-  }
-  const create = await fetchImpl(baseUrl, {
-    method: 'POST',
-    headers: requestHeaders,
-    body: JSON.stringify({ name: normalizedName, value })
-  });
-  if (!create.ok) {
-    throw new Error(await describeHttpFailure(create, 'GitHub repository variable creation'));
-  }
-}

package/src/github-template-repository.js

@@ -1,171 +0,0 @@
-import { spawn } from 'node:child_process';
-import path from 'node:path';
-import { describeHttpFailure } from './http-failure.js';
-import { gitCredentialArguments, gitEnvironment } from './git-credentials.js';
-
-const GITHUB_API_VERSION = '2026-03-10';
-const REPOSITORY_IDENTITY = /^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/;
-
-function requiredString(value, field) {
-  if (typeof value !== 'string' || value.trim() === '') {
-    throw new TypeError(`${field} is required`);
-  }
-  return value.trim();
-}
-
-function repositorySegment(value, field) {
-  const segment = requiredString(value, field);
-  if (!/^[A-Za-z0-9_.-]+$/.test(segment)) {
-    throw new TypeError(`${field} contains unsupported characters`);
-  }
-  return segment;
-}
-
-export async function generateRepositoryFromTemplate({
-  accessToken,
-  templateOwner,
-  templateRepository,
-  owner,
-  repository,
-  description,
-  fetchImpl = fetch,
-  sleep,
-  readinessAttempts,
-  readinessIntervalMs
-}) {
-  const token = requiredString(accessToken, 'accessToken');
-  const sourceOwner = repositorySegment(templateOwner, 'templateOwner');
-  const sourceRepository = repositorySegment(templateRepository, 'templateRepository');
-  const targetOwner = repositorySegment(owner, 'owner');
-  const targetRepository = repositorySegment(repository, 'repository');
-  if (description != null && typeof description !== 'string') {
-    throw new TypeError('description must be a string');
-  }
-
-  const response = await fetchImpl(
-    `https://api.github.com/repos/${encodeURIComponent(sourceOwner)}/${encodeURIComponent(sourceRepository)}/generate`,
-    {
-      method: 'POST',
-      headers: {
-        accept: 'application/vnd.github+json',
-        authorization: `Bearer ${token}`,
-        'content-type': 'application/json',
-        'x-github-api-version': GITHUB_API_VERSION
-      },
-      body: JSON.stringify({
-        owner: targetOwner,
-        name: targetRepository,
-        description: description ?? '',
-        include_all_branches: false,
-        private: false
-      })
-    }
-  );
-  if (response.status !== 201) {
-    throw new Error(await describeHttpFailure(response, 'GitHub template generation'));
-  }
-  const payload = await response.json();
-  if (payload == null || Array.isArray(payload) || typeof payload !== 'object') {
-    throw new TypeError('GitHub repository response must be a JSON object');
-  }
-  const fullName = requiredString(payload.full_name, 'full_name');
-  if (!REPOSITORY_IDENTITY.test(fullName)) {
-    throw new TypeError('GitHub repository response contains an invalid full_name');
-  }
-  if (fullName.toLowerCase() !== `${targetOwner}/${targetRepository}`.toLowerCase()) {
-    throw new TypeError('GitHub generated an unexpected repository');
-  }
-
-  const cloneUrl = new URL(requiredString(payload.clone_url, 'clone_url'));
-  if (
-    cloneUrl.protocol !== 'https:'
-    || cloneUrl.hostname !== 'github.com'
-    || cloneUrl.username !== ''
-    || cloneUrl.password !== ''
-    || cloneUrl.search !== ''
-    || cloneUrl.hash !== ''
-    || cloneUrl.pathname.toLowerCase() !== `/${fullName}.git`.toLowerCase()
-  ) {
-    throw new TypeError('GitHub repository response contains an invalid clone_url');
-  }
-
-  // Last, so a malformed response fails immediately instead of after the readiness wait.
-  await awaitRepositoryContent({
-    accessToken: token, owner: targetOwner, repository: targetRepository, fetchImpl,
-    ...(sleep == null ? {} : { sleep }),
-    ...(readinessAttempts == null ? {} : { attempts: readinessAttempts }),
-    ...(readinessIntervalMs == null ? {} : { intervalMs: readinessIntervalMs })
-  });
-
-  return Object.freeze({ fullName, cloneUrl: cloneUrl.href });
-}
-
-/**
- * Waits for a generated repository to actually contain the template.
- *
- * Generating from a template is asynchronous: GitHub answers 201 with the repository's full name
- * and clone URL, and copies the content in afterwards. Cloning on the 201 produced
- * "warning: You appear to have cloned an empty repository", and scaffolding then failed on a
- * missing site.config.yml — a confusing error about a file the template certainly contains.
- *
- * Readiness is the presence of a branch. `size` is not usable: GitHub still reported 0 for a
- * repository that already had `main` and commits.
- */
-export async function awaitRepositoryContent({
-  accessToken, owner, repository, fetchImpl = fetch,
-  sleep = (milliseconds) => new Promise((resolve) => setTimeout(resolve, milliseconds)),
-  attempts = 30, intervalMs = 1_000
-}) {
-  const url = `https://api.github.com/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repository)}/branches?per_page=1`;
-  for (let attempt = 0; attempt < attempts; attempt += 1) {
-    if (attempt > 0) await sleep(intervalMs);
-    const response = await fetchImpl(url, {
-      headers: {
-        accept: 'application/vnd.github+json',
-        authorization: `Bearer ${accessToken}`,
-        'x-github-api-version': GITHUB_API_VERSION
-      }
-    });
-    if (!response.ok) throw new Error(await describeHttpFailure(response, 'GitHub branch lookup'));
-    const branches = await response.json();
-    if (Array.isArray(branches) && branches.length > 0) return;
-  }
-  throw new Error(
-    `GitHub created ${owner}/${repository} from the template but it was still empty after `
-    + `${Math.round((attempts * intervalMs) / 1000)}s. Re-run scaffold with --resume once it has content.`
-  );
-}
-
-export function cloneRepository({ cloneUrl, target, spawnProcess = spawn, accessToken }) {
-  const source = new URL(requiredString(cloneUrl, 'cloneUrl'));
-  if (
-    source.protocol !== 'https:'
-    || source.hostname !== 'github.com'
-    || source.username !== ''
-    || source.password !== ''
-    || source.search !== ''
-    || source.hash !== ''
-  ) {
-    throw new TypeError('cloneUrl must be an uncredentialed GitHub HTTPS URL');
-  }
-  const resolvedTarget = path.resolve(requiredString(target, 'target'));
-
-  return new Promise((resolve, reject) => {
-    const child = spawnProcess(
-      'git',
-      [...gitCredentialArguments(accessToken), 'clone', source.href, resolvedTarget],
-      {
-        cwd: path.dirname(resolvedTarget),
-        shell: false,
-        stdio: 'inherit',
-        env: gitEnvironment(accessToken)
-      }
-    );
-    child.once('error', reject);
-    child.once('exit', (code, signal) => {
-      if (signal) reject(new Error(`Git clone terminated by signal ${signal}`));
-      else if (code !== 0) reject(new Error(`Git clone exited with code ${code}`));
-      else resolve(resolvedTarget);
-    });
-  });
-}

package/src/hook-command.js

@@ -1,64 +0,0 @@
-import { lstat, mkdir, readFile, writeFile } from 'node:fs/promises';
-import path from 'node:path';
-
-const MARKER = '// Managed by @rathnasgala/cli. Do not edit.\n';
-const HOOK = `#!/usr/bin/env node
-${MARKER}const { spawnSync } = require('node:child_process');
-const path = require('node:path');
-
-const root = process.cwd();
-const executable = path.join(
-  root,
-  'node_modules',
-  '.bin',
-  process.platform === 'win32' ? 'gala.cmd' : 'gala'
-);
-const result = spawnSync(executable, ['validate', '--root', root], {
-  cwd: root,
-  shell: false,
-  stdio: 'inherit'
-});
-if (result.error) {
-  console.error('Gala validation hook failed to start:', result.error.message);
-  process.exit(1);
-}
-process.exit(result.status ?? 1);
-`;
-
-async function metadata(file, allowMissing = false) {
-  try {
-    return await lstat(file);
-  } catch (error) {
-    if (allowMissing && error.code === 'ENOENT') return null;
-    throw error;
-  }
-}
-
-export async function installPrePushHook(root) {
-  const resolvedRoot = path.resolve(root);
-  const gitDirectory = path.join(resolvedRoot, '.git');
-  const gitMetadata = await metadata(gitDirectory);
-  if (!gitMetadata.isDirectory() || gitMetadata.isSymbolicLink()) {
-    throw new TypeError('.git must be a real directory');
-  }
-
-  const hooksDirectory = path.join(gitDirectory, 'hooks');
-  const hooksMetadata = await metadata(hooksDirectory, true);
-  if (hooksMetadata?.isSymbolicLink() || (hooksMetadata && !hooksMetadata.isDirectory())) {
-    throw new TypeError('.git/hooks must be a real directory');
-  }
-  if (!hooksMetadata) await mkdir(hooksDirectory);
-
-  const target = path.join(hooksDirectory, 'pre-push');
-  const existing = await metadata(target, true);
-  if (existing) {
-    if (!existing.isFile() || existing.isSymbolicLink()) {
-      throw new TypeError('Existing pre-push hook must be a regular file');
-    }
-    if (await readFile(target, 'utf8') === HOOK) return { target, installed: false };
-    throw new Error('Refusing to overwrite an existing pre-push hook');
-  }
-
-  await writeFile(target, HOOK, { encoding: 'utf8', flag: 'wx', mode: 0o755 });
-  return { target, installed: true };
-}

package/src/http-failure.js

@@ -1,55 +0,0 @@
-/**
- * What the server actually said, instead of only what it scored.
- *
- * Every failure in this CLI reported `failed with HTTP 403` and discarded the response body. GitHub
- * puts the reason there and nowhere else — an organisation's OAuth App restrictions, a missing
- * scope, a rename, a rate limit all arrive as 403 with a sentence explaining which — so the one
- * fact worth having was the one being thrown away. Diagnosing anything meant guessing between
- * causes the server had already distinguished.
- *
- * Only the response is read. Request bodies, tokens and secrets never pass through here.
- */
-const MAX_DETAIL = 400;
-
-export async function describeHttpFailure(response, action) {
-  const status = response?.status ?? 0;
-  let detail = '';
-  try {
-    // Cloned so a caller that also reads the body still can; a response whose body is already
-    // consumed simply yields no detail rather than a second failure on top of the first.
-    const text = await (typeof response.clone === 'function' ? response.clone() : response).text();
-    detail = extract(text);
-  } catch {
-    detail = '';
-  }
-  return `${action} failed with HTTP ${status}${detail === '' ? '' : `: ${detail}`}`;
-}
-
-function extract(text) {
-  if (typeof text !== 'string' || text.trim() === '') return '';
-  let payload;
-  try {
-    payload = JSON.parse(text);
-  } catch {
-    return truncate(text);
-  }
-  if (payload == null || typeof payload !== 'object') return truncate(text);
-  const parts = [];
-  if (typeof payload.message === 'string' && payload.message.trim() !== '') parts.push(payload.message.trim());
-  // GitHub's `errors` array carries the specific field or reason behind a generic message.
-  if (Array.isArray(payload.errors)) {
-    for (const error of payload.errors) {
-      const reason = typeof error === 'string' ? error : error?.message ?? error?.code;
-      if (typeof reason === 'string' && reason.trim() !== '') parts.push(reason.trim());
-    }
-  }
-  if (typeof payload.error_description === 'string') parts.push(payload.error_description.trim());
-  if (typeof payload.code === 'string' && parts.length === 0) parts.push(payload.code);
-  if (typeof payload.documentation_url === 'string') parts.push(`See ${payload.documentation_url}`);
-  return truncate(parts.length === 0 ? text : parts.join(' — '));
-}
-
-function truncate(value) {
-  const flattened = value.replace(/\s+/g, ' ').trim();
-  return flattened.length > MAX_DETAIL ? `${flattened.slice(0, MAX_DETAIL)}…` : flattened;
-}

package/src/new-command.js

@@ -1,54 +0,0 @@
-import { mkdir, readFile, readdir, writeFile } from 'node:fs/promises';
-import path from 'node:path';
-
-import {
-  createPostMetadata,
-  isContentId,
-  parseFrontmatter,
-  slugifyTitle
-} from '@rathnasgala/content-validation';
-import { stringify } from 'yaml';
-import { repositoryEvaluationDate } from './evaluation-date.js';
-
-export async function createPost({ root, title, language, today, now = Date.now }) {
-  const siteRoot = path.resolve(root);
-  const creationTimestamp = now();
-  const publishAfterDate = today ?? await repositoryEvaluationDate({
-    root: siteRoot,
-    now: () => creationTimestamp
-  });
-  const metadata = createPostMetadata({
-    title,
-    language,
-    today: publishAfterDate,
-    timestamp: creationTimestamp
-  });
-  const postDirectory = path.join(siteRoot, 'content', 'posts', slugifyTitle(title));
-  const mediaDirectory = path.join(postDirectory, 'media');
-  const postPath = path.join(postDirectory, `index.${metadata.language}.md`);
-
-  await mkdir(postDirectory, { recursive: true });
-  const variants = (await readdir(postDirectory, { withFileTypes: true }))
-    .filter((entry) => entry.isFile() && /^index\.[^.]+\.md$/.test(entry.name));
-  const existingIds = new Set();
-  for (const variant of variants) {
-    const variantPath = path.join(postDirectory, variant.name);
-    const parsed = parseFrontmatter(await readFile(variantPath, 'utf8'));
-    if (parsed.errors.length > 0) {
-      throw new Error(`Existing variant has invalid frontmatter: ${variantPath}`);
-    }
-    if (!isContentId(parsed.data.id)) {
-      throw new Error(`Existing variant is missing a valid article id: ${variantPath}`);
-    }
-    existingIds.add(parsed.data.id);
-  }
-  if (existingIds.size > 1) {
-    throw new Error(`Existing variants have conflicting article ids: ${postDirectory}`);
-  }
-  if (existingIds.size === 1) metadata.id = existingIds.values().next().value;
-
-  await mkdir(mediaDirectory, { recursive: true });
-  const source = `---\n${stringify(metadata).trimEnd()}\n---\n\n# ${title}\n`;
-  await writeFile(postPath, source, { encoding: 'utf8', flag: 'wx' });
-  return { metadata, postPath, mediaDirectory };
-}

package/src/open-browser.js

@@ -1,40 +0,0 @@
-import { spawn } from 'node:child_process';
-
-/**
- * Opens a URL in the writer's browser, best effort.
- *
- * Printing "Open https://…" and a code asks someone to copy a URL out of a terminal by hand, three
- * times over in one scaffold. The URL is still always printed — this only saves the copying, and it
- * has to keep working when it cannot: over SSH, in a container, in CI, on a machine with no browser
- * at all. So nothing here is allowed to fail the command.
- *
- * Deliberately not attempted when there is no terminal. A CI job that silently spawns a browser
- * process is a hang waiting to happen, and there is nobody there to look at it.
- */
-export function openInBrowser(url, {
-  platform = process.platform,
-  environment = process.env,
-  interactive = process.stdin.isTTY === true,
-  spawnProcess = spawn
-} = {}) {
-  if (!interactive) return false;
-  // Respected by convention across CLI tooling, and the escape hatch for anyone who does not want
-  // their browser taken over.
-  if (environment.GALA_NO_BROWSER || environment.CI || environment.NO_BROWSER) return false;
-  if (!/^https:\/\//.test(url)) return false;
-
-  const [command, args] = platform === 'darwin' ? ['open', [url]]
-    : platform === 'win32' ? ['cmd', ['/c', 'start', '', url]]
-      : ['xdg-open', [url]];
-
-  try {
-    const child = spawnProcess(command, args, { stdio: 'ignore', detached: true, shell: false });
-    // Without this the CLI waits for the browser to exit before it can finish.
-    child.unref?.();
-    // A missing opener is an ordinary outcome on a headless box, not something to report.
-    child.on?.('error', () => {});
-    return true;
-  } catch {
-    return false;
-  }
-}