@rtorcato/repo-tooling 2.59.0

package/dist/cli/generators/docs-site.js

@@ -0,0 +1,436 @@
+import path from 'node:path';
+import fs from 'fs-extra';
+import { copyPreset, PRESETS } from '../utils/copy-preset.js';
+import { buildBadgeRow, parseRepository } from './badges.js';
+import { inferSubpathsFromExports } from './treeshake.js';
+/**
+ * Docs-site (Docusaurus) generator — the Phase 2 counterpart to the shared
+ * assets shipped in #54. Scaffolds a working Docusaurus site under `apps/docs`,
+ * inferring name/org/repo from package.json (+ the shared design tokens and
+ * sync-changelog script), matching the layout the `Docs site` doctor check
+ * verifies. Every file is written only when absent, so `fix docs-site` is
+ * idempotent and never clobbers a hand-edited site.
+ */
+const DOCS_APP = 'apps/docs';
+/** Docusaurus's neutral green — the default accent, meant to be branded over. */
+const DEFAULT_ACCENT = { light: '#2e8555', dark: '#25c2a0' };
+/**
+ * Source modules to document with TypeDoc: single-segment subpath exports
+ * (`./errors` → `errors`), which map to `src/<id>/index.ts`. Multi-segment
+ * subpaths (`./typescript/base`) are config/asset exports, not source modules,
+ * so they're filtered out.
+ */
+function inferTypedocModules(pkg) {
+    return inferSubpathsFromExports(pkg).allCandidates.filter((id) => !id.includes('/'));
+}
+/** Derive the docs package name from the consumer's own name (`<name>-docs`). */
+function docsPackageName(pkgName) {
+    if (!pkgName)
+        return 'docs';
+    return `${pkgName}-docs`;
+}
+function inferSiteMeta(pkg) {
+    const pkgName = pkg?.name;
+    const parsed = parseRepository(pkg?.repository);
+    const base = pkgName ? (pkgName.split('/').pop() ?? pkgName) : 'docs';
+    return {
+        docsPkgName: docsPackageName(pkgName),
+        title: parsed?.repo ?? base,
+        tagline: pkg?.description ?? 'Documentation',
+        owner: parsed?.owner ?? null,
+        repo: parsed?.repo ?? null,
+    };
+}
+/** Write `contents` at `rel` under targetDir only if it doesn't already exist. */
+async function writeIfMissing(targetDir, rel, contents) {
+    const file = path.join(targetDir, rel);
+    if (await fs.pathExists(file))
+        return null;
+    await fs.ensureDir(path.dirname(file));
+    await fs.writeFile(file, contents);
+    return rel;
+}
+/** Ensure `pnpm-workspace.yaml` lists `apps/*` (idempotent). */
+async function ensureWorkspace(targetDir) {
+    const rel = 'pnpm-workspace.yaml';
+    const file = path.join(targetDir, rel);
+    if (await fs.pathExists(file)) {
+        const body = await fs.readFile(file, 'utf8');
+        // Already a workspace covering apps/* (either `apps/*` or a broader glob).
+        if (/^\s*-\s*['"]?apps\/\*/m.test(body))
+            return null;
+        if (/^packages:/m.test(body)) {
+            const next = body.replace(/^packages:\n/m, "packages:\n  - 'apps/*'\n");
+            await fs.writeFile(file, next);
+            return rel;
+        }
+        await fs.writeFile(file, `packages:\n  - 'apps/*'\n\n${body}`);
+        return rel;
+    }
+    await fs.writeFile(file, "packages:\n  - 'apps/*'\n");
+    return rel;
+}
+/** The GitHub Pages base path Docusaurus serves under, e.g. `/repo-tooling/`. */
+function siteBaseUrl(meta) {
+    return `/${meta.repo ?? meta.title}/`;
+}
+function docusaurusConfig(meta, typedocModules) {
+    const owner = meta.owner ?? 'your-org';
+    const repo = meta.repo ?? meta.title;
+    const ghUrl = `https://github.com/${owner}/${repo}`;
+    // TypeDoc plugins (opt-in) generate docs/api/<id>; the autogenerated sidebar
+    // picks the api/ folder up automatically, so no sidebar change is needed.
+    const typedocImport = typedocModules.length
+        ? "import { getTypedocPlugins } from '@rtorcato/repo-tooling/docusaurus'\n"
+        : '';
+    const typedocPlugins = typedocModules.length
+        ? `    ...getTypedocPlugins(${JSON.stringify(typedocModules)}),\n`
+        : '';
+    return `import type * as Preset from '@docusaurus/preset-classic'
+import type { Config } from '@docusaurus/types'
+import { themes as prismThemes } from 'prism-react-renderer'
+${typedocImport}
+const config: Config = {
+  title: '${meta.title}',
+  tagline: ${JSON.stringify(meta.tagline)},
+  favicon: 'img/favicon.ico',
+
+  url: 'https://${owner}.github.io',
+  baseUrl: '/${repo}/',
+
+  organizationName: '${owner}',
+  projectName: '${repo}',
+
+  onBrokenLinks: 'warn',
+
+  markdown: {
+    format: 'detect',
+    hooks: {
+      onBrokenMarkdownLinks: 'warn',
+    },
+  },
+
+  i18n: {
+    defaultLocale: 'en',
+    locales: ['en'],
+  },
+
+  presets: [
+    [
+      'classic',
+      {
+        docs: {
+          sidebarPath: './sidebars.ts',
+          routeBasePath: '/docs',
+          editUrl: '${ghUrl}/edit/main/apps/docs/',
+        },
+        blog: false,
+        theme: {
+          customCss: './src/css/custom.css',
+        },
+      } satisfies Preset.Options,
+    ],
+  ],
+
+  plugins: [
+${typedocPlugins}    [
+      '@easyops-cn/docusaurus-search-local',
+      {
+        hashed: true,
+        indexDocs: true,
+        indexBlog: false,
+        docsRouteBasePath: '/docs',
+        highlightSearchTermsOnTargetPage: true,
+        searchBarShortcutHint: false,
+      },
+    ],
+  ],
+
+  themeConfig: {
+    colorMode: {
+      defaultMode: 'dark',
+      respectPrefersColorScheme: true,
+    },
+    navbar: {
+      title: '${meta.title}',
+      items: [
+        { to: '/docs', position: 'left', label: 'Docs' },
+        {
+          href: '${ghUrl}',
+          label: 'GitHub',
+          position: 'right',
+        },
+      ],
+    },
+    footer: {
+      style: 'dark',
+      links: [
+        {
+          title: 'Docs',
+          items: [{ label: 'Getting Started', to: '/docs' }],
+        },
+        {
+          title: 'More',
+          items: [
+            { label: 'GitHub', href: '${ghUrl}' },
+            { label: 'Issues', href: '${ghUrl}/issues' },
+          ],
+        },
+      ],
+      copyright: \`Copyright © \${new Date().getFullYear()} ${meta.title}. Built with Docusaurus.\`,
+    },
+    prism: {
+      theme: prismThemes.vsDark,
+      darkTheme: prismThemes.vsDark,
+      additionalLanguages: ['bash', 'json', 'typescript'],
+    },
+  } satisfies Preset.ThemeConfig,
+}
+
+export default config
+`;
+}
+const SIDEBARS = `import type { SidebarsConfig } from '@docusaurus/plugin-content-docs'
+
+// Autogenerated from the docs/ folder structure — add markdown files and they
+// appear here. Swap for an explicit list when you want to control ordering.
+const sidebars: SidebarsConfig = {
+  docs: [{ type: 'autogenerated', dirName: '.' }],
+}
+
+export default sidebars
+`;
+const TSCONFIG = `// Improves IDE type-checking; not used by \`docusaurus start/build\`.
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "ignoreDeprecations": "6.0",
+    "strict": true,
+    "target": "ES2020",
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "jsx": "react-jsx",
+    "module": "ESNext",
+    "moduleResolution": "node",
+    "resolveJsonModule": true,
+    "allowJs": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "exclude": [".docusaurus", "build"]
+}
+`;
+function customCss(accent) {
+    // Import the shared tokens, then override only the accent (per #54's model).
+    return `/* Site theme: shared @rtorcato tokens + this project's accent. */
+@import "./_jt-tokens.css";
+
+:root {
+  --ifm-color-primary: ${accent.light};
+  --jt-accent: ${accent.light};
+}
+
+[data-theme="dark"] {
+  --ifm-color-primary: ${accent.dark};
+  --jt-accent: ${accent.dark};
+}
+`;
+}
+function docsPackageJson(meta, typedoc) {
+    const typedocDevDeps = typedoc
+        ? {
+            '@rtorcato/repo-tooling': '^2.47.0',
+            'docusaurus-plugin-typedoc': '^1.4.0',
+            typedoc: '^0.28.0',
+            'typedoc-plugin-markdown': '^4.9.0',
+        }
+        : {};
+    const pkg = {
+        name: meta.docsPkgName,
+        version: '0.0.1',
+        private: true,
+        scripts: {
+            docusaurus: 'docusaurus',
+            'sync-changelog': 'node ../../scripts/sync-changelog.mjs',
+            // pnpm 8 doesn't run pre* hooks reliably — chain sync-changelog explicitly.
+            start: 'pnpm run sync-changelog && docusaurus start',
+            dev: 'pnpm run sync-changelog && docusaurus start',
+            build: 'pnpm run sync-changelog && docusaurus build',
+            serve: 'docusaurus serve',
+            clear: 'docusaurus clear',
+            typecheck: 'tsc --noEmit',
+            // Opt-in smoke test — builds, serves, and checks the site renders. Heavy
+            // browser install, so it's a manual/CI-gated run, not part of `build`.
+            'test:e2e': 'playwright test',
+        },
+        dependencies: {
+            '@docusaurus/core': '^3.10.2',
+            '@docusaurus/preset-classic': '^3.8.1',
+            '@easyops-cn/docusaurus-search-local': '^0.55.2',
+            '@mdx-js/react': '^3.1.0',
+            clsx: '^2.1.1',
+            'prism-react-renderer': '^2.4.1',
+            react: '^19.0.0',
+            'react-dom': '^19.0.0',
+        },
+        devDependencies: {
+            '@docusaurus/module-type-aliases': '^3.10.2',
+            '@docusaurus/tsconfig': '^3.8.1',
+            '@docusaurus/types': '^3.10.2',
+            '@playwright/test': '^1.49.0',
+            '@rtorcato/repo-tooling': '^2.47.0',
+            '@types/react': '^19.0.0',
+            typescript: '~5.6.3',
+            ...typedocDevDeps,
+        },
+        browserslist: {
+            production: ['>0.5%', 'not dead', 'not op_mini all'],
+            development: ['last 3 chrome version', 'last 3 firefox version', 'last 5 safari version'],
+        },
+        engines: { node: '>=22.0' },
+    };
+    return `${JSON.stringify(pkg, null, 2)}\n`;
+}
+function introDoc(meta, badges) {
+    return `---
+title: ${meta.title}
+slug: /
+sidebar_position: 0
+---
+
+# ${meta.title}
+${badges ? `\n${badges}\n` : ''}
+${meta.tagline}
+
+Welcome to the docs. Edit \`apps/docs/docs/intro.md\` to get started, and add
+more markdown files under \`apps/docs/docs/\` — they appear in the sidebar
+automatically.
+`;
+}
+/** The per-repo workflow that drives the shared reusable deploy on push to main. */
+function docsWorkflow(meta) {
+    return `name: 📚 Docs
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'apps/docs/**'
+      - 'CHANGELOG.md'
+      - '.github/workflows/docs.yml'
+  workflow_dispatch:
+
+jobs:
+  docs:
+    permissions:
+      contents: read
+      pages: write
+      id-token: write
+    uses: rtorcato/repo-tooling/.github/workflows/docs-deploy.yml@main
+    with:
+      build-filter: '${meta.docsPkgName}'
+`;
+}
+/**
+ * Playwright config for the docs smoke test. Reuses the shipped preset, then
+ * builds + serves the site on :3000 and points the base URL at the site's
+ * GitHub Pages base path so routes resolve exactly as in production. One
+ * browser keeps the CI browser install light.
+ */
+function playwrightConfig(meta) {
+    const url = `http://localhost:3000${siteBaseUrl(meta)}`;
+    return `import { defineConfig, devices } from '@playwright/test'
+import base from '@rtorcato/repo-tooling/playwright'
+
+export default defineConfig({
+  ...base,
+  testDir: './tests',
+  projects: [{ name: 'chromium', use: { ...devices['Desktop Chrome'] } }],
+  use: {
+    ...base.use,
+    baseURL: process.env.PLAYWRIGHT_BASE_URL ?? '${url}',
+  },
+  webServer: {
+    command: 'pnpm run build && pnpm exec docusaurus serve --port 3000',
+    url: process.env.PLAYWRIGHT_BASE_URL ?? '${url}',
+    reuseExistingServer: !process.env.CI,
+    timeout: 180_000,
+  },
+})
+`;
+}
+const SMOKE_SPEC = `import { expect, test } from '@playwright/test'
+
+// Smoke test: assert the built site serves and its core UI renders. Deliberately
+// content-agnostic — it validates "the site builds and boots", not copy.
+test('homepage responds and renders the shell', async ({ page }) => {
+  const res = await page.goto('./')
+  expect(res?.ok()).toBeTruthy()
+  await expect(page.locator('.navbar')).toBeVisible()
+})
+
+test('the starter doc renders a heading', async ({ page }) => {
+  await page.goto('./')
+  await expect(page.locator('h1')).toBeVisible()
+})
+`;
+/**
+ * Scaffold the Docusaurus docs site. Writes each file only when missing and
+ * returns the relative paths actually written, so `fix docs-site` is safe to
+ * re-run. Also drops in the shared sync-changelog script + design tokens.
+ */
+export async function generateDocsSite(pkg, targetDir, options = {}) {
+    const meta = inferSiteMeta(pkg);
+    const accent = options.primaryColor ?? DEFAULT_ACCENT;
+    const written = [];
+    // Shared assets (only-if-missing copies of the shipped presets).
+    written.push(...(await copyPresetIfMissing('docusaurus-sync-changelog', targetDir)));
+    written.push(...(await copyPresetIfMissing('docusaurus-theme-tokens', targetDir)));
+    // The docs homepage carries the same badge set as the README (#169), derived
+    // from package.json + repo; visibility-aware (private repos drop npm/coverage).
+    // Plain row (no upsert delimiters) to stay MDX-safe in the generated intro.
+    const badges = buildBadgeRow({
+        name: pkg?.name,
+        owner: meta.owner ?? undefined,
+        repo: meta.repo ?? undefined,
+        isPrivate: pkg?.private === true,
+    });
+    // Opt-in TypeDoc API section (#229): only wire it when enabled AND the
+    // package actually exposes source modules to document.
+    const typedocModules = options.typedoc ? inferTypedocModules(pkg) : [];
+    // Project-specific scaffold.
+    const files = [
+        [`${DOCS_APP}/package.json`, docsPackageJson(meta, typedocModules.length > 0)],
+        [`${DOCS_APP}/docusaurus.config.ts`, docusaurusConfig(meta, typedocModules)],
+        [`${DOCS_APP}/sidebars.ts`, SIDEBARS],
+        [`${DOCS_APP}/tsconfig.json`, TSCONFIG],
+        [`${DOCS_APP}/src/css/custom.css`, customCss(accent)],
+        [`${DOCS_APP}/docs/intro.md`, introDoc(meta, badges)],
+        [`${DOCS_APP}/playwright.config.ts`, playwrightConfig(meta)],
+        [`${DOCS_APP}/tests/smoke.spec.ts`, SMOKE_SPEC],
+        ['.github/workflows/docs.yml', docsWorkflow(meta)],
+    ];
+    // TypeDoc emits docs/api/<id> on build — keep the generated tree out of git.
+    if (typedocModules.length) {
+        files.push([
+            `${DOCS_APP}/.gitignore`,
+            '# Generated by TypeDoc on build\ndocs/api/\n\n# Docusaurus build artifacts\nbuild/\n.docusaurus/\n',
+        ]);
+    }
+    for (const [rel, contents] of files) {
+        const w = await writeIfMissing(targetDir, rel, contents);
+        if (w)
+            written.push(w);
+    }
+    const ws = await ensureWorkspace(targetDir);
+    if (ws)
+        written.push(ws);
+    return written;
+}
+/** Copy a shipped preset only when its target file is absent. */
+async function copyPresetIfMissing(name, targetDir) {
+    const rel = PRESETS[name].target;
+    if (await fs.pathExists(path.join(targetDir, rel)))
+        return [];
+    const res = await copyPreset(name, targetDir);
+    return [res.target];
+}

package/dist/cli/generators/git.js

@@ -0,0 +1,164 @@
+import fs from 'fs-extra';
+import path from 'node:path';
+export const PRE_PUSH_HOOK_CONTENT = `echo "🔍 Running pre-push verify..."
+pnpm verify
+STATUS=$?
+if [ $STATUS -ne 0 ]; then
+  echo "❌ Verify failed — push aborted."
+  exit 1
+fi
+echo "✅ Verify passed — pushing."
+`;
+export async function generateGitConfigs(config, targetDir) {
+    if (config.gitHooks) {
+        await generateHuskyConfig(config, targetDir);
+    }
+    if (config.commitLint) {
+        await generateCommitlintConfig(targetDir);
+    }
+    // Generate .gitignore
+    await generateGitignore(config, targetDir);
+}
+export async function generateHuskyConfig(config, targetDir) {
+    const huskyDir = path.join(targetDir, '.husky');
+    await fs.ensureDir(huskyDir);
+    // Pre-commit hook. husky v10 format: just the command — the v9 shebang +
+    // `. "$(dirname ...)/_/husky.sh"` bootstrap is deprecated (warns on every
+    // hook run in v9, fails outright in v10).
+    const preCommitPath = path.join(huskyDir, 'pre-commit');
+    const preCommitContent = 'npx lint-staged\n';
+    await fs.writeFile(preCommitPath, preCommitContent);
+    await fs.chmod(preCommitPath, 0o755);
+    // Pre-push hook — only when the package.json already has a `verify` script.
+    // In the setup flow, generatePackageJson runs before this and writes verify
+    // when 2+ tools are enabled. In the `fix husky` path, a pre-existing verify
+    // script is what unlocks the hook.
+    const pkgPath = path.join(targetDir, 'package.json');
+    if (await fs.pathExists(pkgPath)) {
+        const pkg = (await fs.readJson(pkgPath));
+        const scripts = pkg.scripts ?? {};
+        if (scripts.verify) {
+            await generatePrePushHook(targetDir);
+        }
+    }
+    // Commit-msg hook (if commitlint is enabled). husky v10 format — no v9
+    // bootstrap. $1 is still the commit-message file path git passes through.
+    if (config.commitLint) {
+        const commitMsgPath = path.join(huskyDir, 'commit-msg');
+        const commitMsgContent = 'npx --no -- commitlint --edit $1\n';
+        await fs.writeFile(commitMsgPath, commitMsgContent);
+        await fs.chmod(commitMsgPath, 0o755);
+    }
+    // lint-staged configuration in package.json
+    const packageJsonPath = path.join(targetDir, 'package.json');
+    const packageJson = await fs.readJson(packageJsonPath);
+    // No explicit `git add` — lint-staged stages tool output itself, and the
+    // extra add races its index lock. `--no-errors-on-unmatched` keeps biome
+    // from failing a commit when every matched file is biome-ignored.
+    const useBiome = config.linting.tool === 'biome' || config.linting.tool === 'both';
+    packageJson['lint-staged'] = {
+        '*.{js,ts,jsx,tsx}': useBiome ? 'biome check --fix --no-errors-on-unmatched' : 'eslint --fix',
+        '*.{json,md,yml,yaml}': useBiome
+            ? 'biome format --write --no-errors-on-unmatched'
+            : 'prettier --write',
+    };
+    await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
+}
+export async function generatePrePushHook(targetDir) {
+    const huskyDir = path.join(targetDir, '.husky');
+    await fs.ensureDir(huskyDir);
+    const prePushPath = path.join(huskyDir, 'pre-push');
+    await fs.writeFile(prePushPath, PRE_PUSH_HOOK_CONTENT);
+    await fs.chmod(prePushPath, 0o755);
+}
+export async function generateCommitlintConfig(targetDir) {
+    const commitlintConfigPath = path.join(targetDir, 'commitlint.config.mjs');
+    const commitlintConfig = `export { default } from '@rtorcato/repo-tooling/commitlint/config'
+`;
+    await fs.writeFile(commitlintConfigPath, commitlintConfig);
+}
+async function generateGitignore(config, targetDir) {
+    const gitignorePath = path.join(targetDir, '.gitignore');
+    let gitignoreContent = `# Dependencies
+node_modules/
+.pnpm-store
+
+# Build outputs
+dist/
+build/
+out/
+
+# Environment files
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Claude Code (worktrees + local settings are per-machine; agents/commands are shared)
+.claude/worktrees/
+.claude/settings.local.json
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Coverage directory used by tools like istanbul
+coverage/
+*.lcov
+
+# TypeScript
+*.tsbuildinfo
+`;
+    // Add framework-specific ignores
+    if (config.projectType === 'nextjs-app') {
+        gitignoreContent += `
+# Next.js
+.next/
+.vercel
+`;
+    }
+    if (config.bundler === 'vite') {
+        gitignoreContent += `
+# Vite
+.vite/
+`;
+    }
+    if (config.testing.framework === 'playwright') {
+        gitignoreContent += `
+# Playwright
+/test-results/
+/playwright-report/
+/playwright/.cache/
+`;
+    }
+    if (config.testing.framework === 'cypress') {
+        gitignoreContent += `
+# Cypress
+/cypress/videos/
+/cypress/screenshots/
+/cypress/downloads/
+`;
+    }
+    await fs.writeFile(gitignorePath, gitignoreContent);
+}

package/dist/cli/generators/github-actions.js

@@ -0,0 +1,35 @@
+import fs from 'fs-extra';
+import path from 'node:path';
+import { renderGitHubWorkflow } from '../../base/ci.js';
+import { githubJobs, usesCoverage } from '../../languages/js/ci.js';
+// Minimal Codecov config — auto targets keep it from failing a fresh repo that
+// has no baseline yet, while the 1% threshold tolerates rounding noise.
+// https://docs.codecov.com/docs/codecov-yaml
+const CODECOV_YML = `coverage:
+  status:
+    project:
+      default:
+        target: auto
+        threshold: 1%
+    patch:
+      default:
+        target: auto
+        threshold: 1%
+`;
+export async function generateGitHubActions(config, targetDir) {
+    const workflowsDir = path.join(targetDir, '.github', 'workflows');
+    await fs.ensureDir(workflowsDir);
+    // This is the JS path specifically. Swift (#287) renders its own workflow
+    // from `src/languages/swift/ci.ts` rather than dispatching through here: it
+    // takes no ProjectConfig at all (its jobs derive from Package.swift), so a
+    // shared entry point would mean inventing a fake config to pass in. Both
+    // paths meet at renderGitHubWorkflow() in src/base/ci.ts, which is the seam
+    // that actually matters.
+    const workflow = renderGitHubWorkflow(githubJobs(config));
+    await fs.writeFile(path.join(workflowsDir, 'ci.yml'), workflow);
+    // codecov.yml is the CI's coverage-upload companion — emit it alongside ci.yml
+    // whenever the workflow uploads coverage, so the codecov badge isn't red.
+    if (usesCoverage(config)) {
+        await fs.writeFile(path.join(targetDir, 'codecov.yml'), CODECOV_YML);
+    }
+}

package/dist/cli/generators/github-workflows.js

@@ -0,0 +1,24 @@
+import path from 'node:path';
+import fs from 'fs-extra';
+import { getPackageRoot } from '../utils/copy-preset.js';
+/**
+ * Optional GitHub Actions deploy workflows, scaffolded on demand via
+ * `fix <name>`. They're static templates (no config-driven branching) copied
+ * verbatim from tooling/, unlike the config-aware ci.yml generator. Setup does
+ * not scaffold these — they're too deploy-target-specific to assume.
+ */
+export const GH_WORKFLOWS = [
+    'docker-publish',
+    'vercel-deploy',
+    'cloudflare-pages',
+    'preview-deployments',
+];
+export async function generateGhWorkflow(name, targetDir) {
+    const source = path.join(getPackageRoot(), 'tooling/github-actions/workflows', `${name}.yml`);
+    const relTarget = path.join('.github', 'workflows', `${name}.yml`);
+    // Self-enforced safe-add: these fixers have no doctor check, so the fix
+    // command's own safe-add guard (which keys off an `ok` check) can't kick in.
+    // overwrite:false keeps a user-customized workflow of the same name intact.
+    await fs.copy(source, path.join(targetDir, relTarget), { overwrite: false, errorOnExist: false });
+    return relTarget;
+}

package/dist/cli/generators/gitlab-ci.js

@@ -0,0 +1,10 @@
+import path from 'node:path';
+import fs from 'fs-extra';
+import { renderGitLabCI } from '../../base/ci.js';
+import { gitlabSpec } from '../../languages/js/ci.js';
+export async function generateGitLabCI(config, targetDir) {
+    const yamlPath = path.join(targetDir, '.gitlab-ci.yml');
+    // ponytail: direct JS import until a second language module ships CI (#287).
+    await fs.writeFile(yamlPath, renderGitLabCI(gitlabSpec(config)));
+    return '.gitlab-ci.yml';
+}