@rtorcato/repo-tooling 4.8.0 → 5.0.1

package/AGENTS.md

@@ -84,7 +84,6 @@ npx @rtorcato/repo-tooling doctor --json -d ./existing-repo
 # Apply one fixer from the list (run `list --json` for every target)
 npx @rtorcato/repo-tooling fix dependabot --yes --json
 npx @rtorcato/repo-tooling fix engines --yes --json
-npx @rtorcato/repo-tooling fix docs-site --yes --json   # scaffold a Docusaurus docs site under apps/docs
 npx @rtorcato/repo-tooling fix bun --yes --json         # Bun runtime/test config
 ```
 

package/dist/base/checks.js

@@ -100,81 +100,6 @@ export async function checkCommunityHealth(dir) {
         hint: 'Run `npx @rtorcato/repo-tooling fix community-health` to scaffold them',
     };
 }
-const BRAND_HINT = 'Run `npx @rtorcato/repo-tooling fix brand` to scaffold brand/ (SVG sources + render.sh) and render the PNGs (needs librsvg)';
-/** The two banners the README consumes — the pair `brand/` exists to keep regenerable. */
-const BANNERS = ['banner', 'banner-mobile'];
-/**
- * Brand assets (#395). A committed PNG with no SVG beside it can't be
- * recoloured, retitled or resized — which was the state of every repo in the
- * family but one. Three signals, all language-agnostic:
- *
- * 1. a rendered banner with no `brand/<name>.svg` source
- * 2. a `brand/` folder with no `render.sh` — sources nobody can render
- * 3. a README still pointing at the pre-amendment root-level `./banner.png`
- *
- * A repo with no brand images at all is `optional-missing`, not a finding:
- * there's nothing broken to fix, and banners are opt-in.
- */
-export async function checkBrand(dir) {
-    const check = 'Brand assets';
-    const has = (rel) => fs.pathExists(path.join(dir, rel));
-    const problems = [];
-    const orphans = [];
-    for (const name of BANNERS) {
-        const rendered = (await has(`${name}.png`)) || (await has(`brand/${name}.png`));
-        if (rendered && !(await has(`brand/${name}.svg`)))
-            orphans.push(`${name}.png`);
-    }
-    if (orphans.length > 0) {
-        problems.push(`${orphans.join(' + ')} committed with no brand/*.svg source`);
-    }
-    const brandDir = await has('brand');
-    if (brandDir && !(await has('brand/render.sh'))) {
-        problems.push('brand/ has no render.sh — the PNGs cannot be regenerated');
-    }
-    const readmePath = path.join(dir, 'README.md');
-    if (await fs.pathExists(readmePath)) {
-        const readme = await fs.readFile(readmePath, 'utf-8');
-        if (/(?<!brand\/)banner(?:-mobile)?\.png/.test(readme)) {
-            problems.push('README points at root-level banner PNGs (the spec moved them to brand/)');
-        }
-    }
-    if (problems.length > 0) {
-        return { check, status: 'drift', detail: problems.join('; '), hint: BRAND_HINT };
-    }
-    // Name the pieces still missing (#679). Severity is unchanged: brand is optional.
-    const missing = [];
-    if (!(await has('brand/favicon.svg')))
-        missing.push('favicon (brand/favicon.svg)');
-    const unrendered = [];
-    for (const n of ['banner', 'banner-mobile', 'social-card', 'favicon-512']) {
-        if (!(await has(`brand/${n}.png`)))
-            unrendered.push(`${n}.png`);
-    }
-    if (unrendered.length > 0)
-        missing.push(`rendered PNGs (brand/${unrendered.join(', ')})`);
-    const readmeFile = path.join(dir, 'README.md');
-    const readmeText = (await fs.pathExists(readmeFile)) ? await fs.readFile(readmeFile, 'utf-8') : '';
-    if (!/brand\/banner(?:-mobile)?\.png/.test(readmeText))
-        missing.push('README banner');
-    if (!brandDir) {
-        return {
-            check,
-            status: 'optional-missing',
-            detail: `no brand/ folder — missing: ${missing.join('; ')}`,
-            hint: BRAND_HINT,
-        };
-    }
-    if (missing.length > 0) {
-        return {
-            check,
-            status: 'ok',
-            detail: `brand/ holds the SVG sources and render.sh; missing: ${missing.join('; ')}`,
-            hint: BRAND_HINT,
-        };
-    }
-    return { check, status: 'ok', detail: 'brand/ holds the SVG sources and render.sh' };
-}
 /**
  * `org/action@vN`, the only form the generators emit. Same shape as the scan in
  * tests/cli/generators/action-pins.test.ts — major-only, because that's the

package/dist/base/fixers.js

@@ -15,7 +15,6 @@ import path from 'node:path';
 import chalk from 'chalk';
 import fs from 'fs-extra';
 import { installAgentRules, installAiSetup } from '../cli/generators/agent-rules.js';
-import { addReadmeBanner, generateBrand, renderBrand, resolveBrandMeta, syncBrandToDocs, } from '../cli/generators/brand.js';
 import { generateCommunityHealth } from '../cli/generators/community-health.js';
 import { generateCommitlintConfig } from '../cli/generators/git.js';
 import { generateCodeowners, generateEditorConfig } from '../cli/generators/misc.js';
@@ -247,41 +246,6 @@ export const BASE_FIXERS = [
             return { filesWritten };
         },
     },
-    {
-        target: 'brand',
-        selfSafe: true,
-        description: 'Scaffold brand/ — favicon, banner, mobile-banner and social-card SVG sources + render.sh — render the PNGs and favicon.ico when rsvg-convert is on PATH, and add the README banner',
-        appliesTo: ['Brand assets'],
-        outputs: [
-            'brand/favicon.svg',
-            'brand/banner.svg',
-            'brand/banner-mobile.svg',
-            'brand/social-card.svg',
-            'brand/render.sh',
-            'brand/banner.png',
-            'brand/banner-mobile.png',
-            'brand/social-card.png',
-            'brand/favicon-512.png',
-            'brand/favicon.ico',
-            'README.md',
-        ],
-        // Every SVG is written only when absent, PNGs are re-rendered only when
-        // older than their source, and the README edit is a delimited block (or
-        // two image paths) — hand-edited art is never clobbered.
-        riskLevel: 'safe-merge',
-        canFixDrift: true,
-        async run({ targetDir, pkg, lock }) {
-            const tagline = lock?.rules?.brand?.tagline;
-            const filesWritten = await generateBrand(pkg, targetDir, tagline);
-            filesWritten.push(...((await renderBrand(targetDir)) ?? []));
-            filesWritten.push(...(await syncBrandToDocs(targetDir)));
-            const { name } = await resolveBrandMeta(pkg, targetDir, tagline);
-            const readme = await addReadmeBanner(targetDir, name);
-            if (readme && !filesWritten.includes(readme))
-                filesWritten.push(readme);
-            return { filesWritten };
-        },
-    },
     {
         target: 'ai',
         description: 'Install all AI agent files at once (AGENTS.md, CLAUDE.md, Cursor, Copilot, Claude skill, MCP example)',

package/dist/cli/commands/doctor.js

@@ -21,8 +21,8 @@ import { checkCopiedAssets } from '../utils/copied-assets.js';
 import { LOCKFILE_VERSION, readLockfile } from '../utils/lockfile.js';
 import { compareRulesWithReference } from '../utils/reference-rules.js';
 import { declinedInLock, getFixTargetForCheck } from './fix-targets.js';
-import { checkAiSetup, checkBrand, checkCodeowners, checkCodeQL, checkCommunityHealth, checkCoverageUpload, checkDependabot, checkEditorConfig, checkFile, checkGitHooks, checkGitHubActions, checkGitLabCI, checkNestedLanguages, checkPrePushHook, checkReadmeBadges, checkRecommendedMcp, COMMITLINT_FILE_CHECK, } from '../../base/checks.js';
-import { allDeps, checkAreTheTypesWrong, checkBiome, checkClaudeWorktreeSettings, checkConfigSchemaVersions, checkDocsSite, checkEnginesNode, checkExportsBuildable, checkGitDependencies, checkKnip, checkLintStaged, checkNodeVersionConsistency, checkNodeVersionPin, checkPackageJson, checkPackageManager, checkPeerVersions, checkPublint, checkSemanticRelease, checkSizeLimit, checkTailwind, checkBuildApprovals, checkPnpmWorkspace, checkTreeshakeSetup, checkTurborepo, checkTypedoc, checkVerifyScript, checkVscodeExtensions, evaluateNodeVersion, FILE_CHECKS, findDocsAppDir, jsBadgeAudience, jsGitHooksProfile, readPackageJson, } from '../../languages/js/checks.js';
+import { checkAiSetup, checkCodeowners, checkCodeQL, checkCommunityHealth, checkCoverageUpload, checkDependabot, checkEditorConfig, checkFile, checkGitHooks, checkGitHubActions, checkGitLabCI, checkNestedLanguages, checkPrePushHook, checkReadmeBadges, checkRecommendedMcp, COMMITLINT_FILE_CHECK, } from '../../base/checks.js';
+import { allDeps, checkAreTheTypesWrong, checkBiome, checkClaudeWorktreeSettings, checkConfigSchemaVersions, checkEnginesNode, checkExportsBuildable, checkGitDependencies, checkKnip, checkLintStaged, checkNodeVersionConsistency, checkNodeVersionPin, checkPackageJson, checkPackageManager, checkPeerVersions, checkPublint, checkSemanticRelease, checkSizeLimit, checkTailwind, checkBuildApprovals, checkPnpmWorkspace, checkTreeshakeSetup, checkTurborepo, checkTypedoc, checkVerifyScript, checkVscodeExtensions, evaluateNodeVersion, FILE_CHECKS, jsBadgeAudience, jsGitHooksProfile, readPackageJson, } from '../../languages/js/checks.js';
 export { evaluateNodeVersion };
 const PACKAGE = '@rtorcato/repo-tooling';
 // Detects the broken-release-on-protected-main footgun: a workflow that runs
@@ -218,7 +218,6 @@ async function runBaseChecks(dir, lock, opts) {
     results.push(await checkGitLabCI(dir));
     results.push(await checkCodeowners(dir));
     results.push(await checkCommunityHealth(dir));
-    results.push(await checkBrand(dir));
     results.push(await checkAiSetup(dir));
     // #534: advisory. Absent `mcp.recommended` means the repo has nothing to say
     // about MCP, which is not a finding.
@@ -375,11 +374,6 @@ export async function runDoctor(dir) {
     if (await fs.pathExists(path.join(targetDir, 'pnpm-workspace.yaml'))) {
         results.push(await checkTurborepo(targetDir));
     }
-    // Docs site is opt-in — only surface the check when a Docusaurus site exists.
-    const docsAppDir = await findDocsAppDir(targetDir);
-    if (docsAppDir) {
-        results.push(await checkDocsSite(targetDir, docsAppDir));
-    }
     // Tailwind is opt-in — only surface the check when the repo actually depends on it.
     if ('tailwindcss' in allDeps(pkg)) {
         results.push(await checkTailwind(targetDir, pkg));

package/dist/cli/commands/fix-targets.js

@@ -45,7 +45,6 @@ export const FIX_TARGETS = {
     'are-the-types-wrong': 'attw',
     publint: 'publint',
     'README badges': 'badges',
-    'Brand assets': 'brand',
     TypeDoc: 'typedoc',
     'AI setup': 'ai',
     'Claude worktree settings': 'ai',
@@ -177,8 +176,6 @@ export function declinedInLock(lock, checkName) {
             return c.turborepo === false;
         case 'Tailwind':
             return c.tailwind === false;
-        case 'Brand assets':
-            return c.brand === false;
         default:
             return false;
     }
@@ -248,12 +245,8 @@ export function lockfilePatchForTarget(target, lock) {
             return c.nx ? null : { nx: true };
         case 'tailwind':
             return c.tailwind ? null : { tailwind: true };
-        case 'docs-site':
-            return c.docsSite ? null : { docsSite: true };
         case 'bun':
             return c.bun ? null : { bun: true };
-        case 'brand':
-            return c.brand ? null : { brand: true };
         default:
             return null;
     }

package/dist/cli/commands/setup-presets.js

@@ -59,7 +59,6 @@ export function buildPresetConfig(name, projectName) {
                 semanticRelease: true,
                 bundler: 'tsup',
                 publint: true,
-                brand: true,
             };
         case 'web-app':
             return {
@@ -210,8 +209,9 @@ export const CONFIG_SCHEMA = {
         turborepo: { type: 'boolean' },
         nx: { type: 'boolean' },
         tailwind: { type: 'boolean' },
-        docsSite: { type: 'boolean' },
-        brand: { type: 'boolean' },
+        // Deprecated (#718): both scaffolds moved to @rtorcato/shared-docs. Accepted, inert.
+        docsSite: { type: 'boolean', deprecated: true },
+        brand: { type: 'boolean', deprecated: true },
         bun: { type: 'boolean' },
     },
 };
@@ -317,8 +317,6 @@ export function computeFileList(config) {
         files.push('postcss.config.mjs', 'src/styles/globals.css');
     if (config.bun)
         files.push('bunfig.toml');
-    if (config.brand)
-        files.push('brand/banner.svg', 'brand/banner-mobile.svg', 'brand/social-card.svg', 'brand/render.sh');
     files.push('README.md');
     return files;
 }

package/dist/cli/commands/setup.js

@@ -24,7 +24,6 @@ const REVIEWABLE_FEATURES = [
     { key: 'securityAutomation', label: 'Security automation (Dependabot + CodeQL)' },
     { key: 'badges', label: 'README status badges' },
     { key: 'aiSetup', label: 'AI agent rules (AGENTS.md, CLAUDE.md, Cursor, Copilot)' },
-    { key: 'brand', label: 'Brand assets (brand/ banner + social-card SVGs, render.sh)' },
 ];
 /**
  * A preset run may only ask questions when a human is on both ends of the pipe.
@@ -461,13 +460,6 @@ async function promptForConfig(targetDir, seed) {
             message: '🤖 Add AI agent rules (AGENTS.md, CLAUDE.md, Cursor, Copilot, Claude skill)?',
             default: seed?.aiSetup ?? true,
         },
-        {
-            type: 'confirm',
-            name: 'brand',
-            message: '🎨 Add brand assets (brand/ banner + social-card SVG sources, render.sh)?',
-            // On by default for libraries — the ones that publish a README to npm.
-            default: (answers) => seed?.brand ?? answers.projectType === 'library',
-        },
         {
             type: 'select',
             name: 'orchestrator',
@@ -557,7 +549,6 @@ async function promptForConfig(targetDir, seed) {
         publint: answers.publint ?? false,
         badges: answers.badges ?? false,
         aiSetup: answers.aiSetup ?? false,
-        brand: answers.brand ?? false,
         turborepo: answers.orchestrator === 'turbo',
         nx: answers.orchestrator === 'nx',
         tailwind: answers.tailwind ?? false,

package/dist/cli/generators/index.js

@@ -19,7 +19,6 @@ import { generateTailwind } from './tailwind.js';
 import { generateTurborepo } from './turborepo.js';
 import { generateNx } from './nx.js';
 import { generateBun } from './bun.js';
-import { generateBrand } from './brand.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 export async function generateConfigs(config, targetDir) {
@@ -123,11 +122,6 @@ export async function generateConfigs(config, targetDir) {
     }
     // Generate README
     await generateReadme(config, targetDir);
-    // brand/ (#677) — the same generator as `fix brand`. After the README so the
-    // banner-path repoint sees it; no tagline yet, as the lockfile isn't written.
-    if (config.brand) {
-        await generateBrand(await fs.readJson(path.join(targetDir, 'package.json')), targetDir);
-    }
     // Copy ts-reset if TypeScript is enabled
     if (config.typescript.enabled) {
         await copyTSReset(targetDir);

package/dist/cli/index.js

@@ -178,12 +178,6 @@ const TOOL_CATALOG = [
         exports: ['@rtorcato/repo-tooling/typedoc'],
         fixTarget: 'typedoc',
     },
-    {
-        name: 'Docs site',
-        description: 'Docusaurus docs site (apps/docs) with shared tokens + GitHub Pages deploy',
-        exports: [],
-        fixTarget: 'docs-site',
-    },
     {
         name: 'esbuild',
         description: 'Fast JavaScript bundler configuration',
@@ -340,7 +334,16 @@ program
         '\n  `npx @rtorcato/repo-ai fix claude-skills --force-skills`.');
     process.exitCode = 1;
 });
+// The docs-site and brand scaffolds moved to @rtorcato/shared-docs (#718). The
+// fix targets stay as hidden pointers so old instructions fail with the fix.
+const MOVED_TARGETS = { 'docs-site': 'init', brand: 'brand' };
 program.hook('preAction', async (_, actionCommand) => {
+    const target = actionCommand.args[0];
+    if (actionCommand.name() === 'fix' && target && Object.hasOwn(MOVED_TARGETS, target)) {
+        console.error(chalk.red(`\`repo-tooling fix ${target}\` moved to @rtorcato/shared-docs.`) +
+            `\n  Run \`npx @rtorcato/shared-docs ${MOVED_TARGETS[target]}\` instead.`);
+        process.exit(1);
+    }
     const refusal = await selfRepoRefusal(actionCommand.name(), actionCommand.args[0], actionCommand.opts());
     if (refusal) {
         console.log(chalk.yellow('\n⚠️  This command cannot be run inside the @rtorcato/repo-tooling repo itself.\n'));

package/dist/cli/utils/copy-preset.js

@@ -96,26 +96,6 @@ export const PRESETS = {
         target: '.mcp.json.example',
         desc: 'Commented MCP server template (copy to .mcp.json to activate)',
     },
-    'docusaurus-sync-changelog': {
-        source: 'tooling/docusaurus/sync-changelog.mjs',
-        target: 'scripts/sync-changelog.mjs',
-        desc: 'Canonical CHANGELOG → docs sync script for Docusaurus sites',
-    },
-    'docusaurus-docs-helpers': {
-        source: 'tooling/docusaurus/docs-helpers.mjs',
-        target: 'scripts/docs-helpers.mjs',
-        desc: 'Docs-generator helpers (markdown-table escaping, export parser, generated-block splice)',
-    },
-    'docusaurus-theme-tokens': {
-        source: 'tooling/docusaurus/theme-tokens.css',
-        target: 'apps/docs/src/css/_jt-tokens.css',
-        desc: 'Shared Docusaurus design tokens (Geist + navy surfaces; accent per-project)',
-    },
-    'docusaurus-theme': {
-        source: 'tooling/docusaurus/theme.css',
-        target: 'apps/docs/src/css/theme.css',
-        desc: 'Shared Docusaurus component theme (navbar, cards, sidebar, footer, tables; accent-agnostic — @import after docusaurus-theme-tokens)',
-    },
 };
 export function getPackageRoot() {
     const cliFile = new URL(import.meta.url).pathname;

package/dist/cli/utils/lockfile.js

@@ -163,18 +163,20 @@ export function lockfileSchema() {
                     brand: {
                         type: 'object',
                         additionalProperties: false,
-                        description: 'Inputs to `fix brand`, which scaffolds the banner and social-card SVGs.',
+                        deprecated: true,
+                        description: 'Deprecated: the brand scaffold moved to @rtorcato/shared-docs. Still accepted so existing files validate; removed in the next major.',
                         properties: {
                             tagline: {
                                 type: 'string',
-                                description: 'Short line for the banners and social card, used in place of the package.json description. Keep it to two lines of about 42 characters; `fix brand` warns when it is longer.',
+                                description: 'Short line for the banners and social card, used in place of the package.json description. Keep it to two lines of about 42 characters.',
                             },
                         },
                     },
                     docs: {
                         type: 'object',
                         additionalProperties: false,
-                        description: 'Inputs to `fix docs-site`.',
+                        deprecated: true,
+                        description: 'Deprecated: the docs-site scaffold moved to @rtorcato/shared-docs, which has the sibling list natively. Still accepted so existing files validate; removed in the next major.',
                         properties: {
                             siblings: {
                                 type: 'array',

package/dist/languages/js/checks.js

@@ -1425,68 +1425,6 @@ export async function checkBuildApprovals(dir, pkg) {
         hint: `Record a decision per package under \`allowBuilds:\` in ${WORKSPACE_FILE} (\`name: true\` to run it, \`false\` to skip). pnpm 11 fails \`pnpm install --frozen-lockfile\` outright while any is undecided, so CI cannot pass until each is answered.`,
     };
 }
-/** The docs app dir (apps/docs or apps/doc) if a Docusaurus config lives there. */
-export async function findDocsAppDir(dir) {
-    for (const app of ['apps/docs', 'apps/doc']) {
-        if (await fs.pathExists(path.join(dir, app, 'docusaurus.config.ts')))
-            return app;
-    }
-    return null;
-}
-// Only surfaced when a Docusaurus site exists (see runDoctor). Verifies the
-// shared-asset wiring #54 standardizes: sync-changelog present + chained into
-// the docs app's build/start, and the deploy artifact path is `build` (not
-// `dist`). Opt-in, so a repo without a docs site never sees this.
-export async function checkDocsSite(dir, docsAppDir) {
-    const check = 'Docs site';
-    const deltas = [];
-    // sync-changelog pumps a root CHANGELOG.md into the site — a semantic-release
-    // shape. Changesets writes per-package changelogs and leaves the (private)
-    // root package without one, so don't require the script there (#425). If a
-    // Changesets repo keeps the script anyway, it still has to be wired.
-    const syncPath = path.join(dir, 'scripts', 'sync-changelog.mjs');
-    if (!(await fs.pathExists(syncPath))) {
-        if (!(await usesChangesets(dir)))
-            deltas.push('scripts/sync-changelog.mjs missing');
-    }
-    else {
-        const pkgPath = path.join(dir, docsAppDir, 'package.json');
-        if (await fs.pathExists(pkgPath)) {
-            try {
-                const docsPkg = (await fs.readJson(pkgPath));
-                const scripts = docsPkg.scripts ?? {};
-                const chained = ['build', 'start'].some((s) => typeof scripts[s] === 'string' && /sync-changelog/.test(scripts[s]));
-                // pnpm 8 doesn't run pre* hooks reliably, so build/start must chain it explicitly.
-                if (!chained)
-                    deltas.push(`${docsAppDir} build/start does not chain sync-changelog`);
-            }
-            catch {
-                // Unparseable package.json — a separate check owns that; skip here.
-            }
-        }
-    }
-    // The GitHub Pages deploy must upload `apps/doc*/build` (Docusaurus emits
-    // `build/`, not `dist/`).
-    const workflowsDir = path.join(dir, '.github', 'workflows');
-    if (await fs.pathExists(workflowsDir)) {
-        for (const file of await fs.readdir(workflowsDir)) {
-            if (!/\.ya?ml$/.test(file))
-                continue;
-            const body = await fs.readFile(path.join(workflowsDir, file), 'utf-8').catch(() => '');
-            if (new RegExp(`${docsAppDir}/dist`).test(body)) {
-                deltas.push(`${file} deploys ${docsAppDir}/dist (should be ${docsAppDir}/build)`);
-            }
-        }
-    }
-    if (deltas.length)
-        return {
-            check,
-            status: 'drift',
-            detail: deltas.join('; '),
-            hint: 'Align the docs site with the shared standard (sync-changelog wiring, build/ artifact path)',
-        };
-    return { check, status: 'ok', detail: `${docsAppDir} wired per standard` };
-}
 // Only called when `tailwindcss` is a dependency (see runDoctor) — Tailwind is
 // opt-in per project, so nudging repos that don't use it would be noise. v4 is
 // CSS-first: the wiring is a PostCSS plugin (or the Vite plugin), not a config

package/dist/languages/js/fixers.js

@@ -72,11 +72,10 @@ import { generateTailwind } from '../../cli/generators/tailwind.js';
 import { generateTurborepo } from '../../cli/generators/turborepo.js';
 import { generateNx } from '../../cli/generators/nx.js';
 import { generateBun } from '../../cli/generators/bun.js';
-import { generateDocsSite } from '../../cli/generators/docs-site.js';
 import { generateTypedocConfig, generateTypedocWorkflow } from '../../cli/generators/typedoc.js';
 import { copyPreset } from '../../cli/utils/copy-preset.js';
 import { identifiablePresetHashes } from '../../cli/utils/copied-assets.js';
-import { LOCKFILE_NAME, readLockfile, writeLockfile } from '../../cli/utils/lockfile.js';
+import { LOCKFILE_NAME, writeLockfile } from '../../cli/utils/lockfile.js';
 // The fixer contract moved to src/base/fixers.ts when Swift became the second
 // module (#286) — import it from there.
 import { FixerAbort } from '../../base/fixers.js';
@@ -739,48 +738,6 @@ export const FIXERS = [
             return { filesWritten };
         },
     },
-    {
-        target: 'docs-site',
-        description: 'Scaffold a Docusaurus docs site under apps/docs (config/sidebars/tokens + reusable Pages deploy), inferring name/org/repo from package.json',
-        // Manual/opt-in target — the "Docs site" doctor check is opt-in (only
-        // surfaces once a site exists), so this never nags a repo without one.
-        appliesTo: [],
-        outputs: [
-            'apps/docs/**',
-            'scripts/sync-changelog.mjs',
-            'pnpm-workspace.yaml',
-            '.github/workflows/docs.yml',
-        ],
-        riskLevel: 'safe-add',
-        async run({ targetDir, pkg }) {
-            // Wire the TypeDoc API section (#229) when the repo already uses TypeDoc —
-            // a typedoc config on disk or the dep installed. No new CLI flag needed.
-            const deps = {
-                ...(pkg?.dependencies ?? {}),
-                ...(pkg?.devDependencies ?? {}),
-            };
-            const typedocConfigs = [
-                'typedoc.json',
-                'typedoc.config.js',
-                'typedoc.config.mjs',
-                'typedoc.config.cjs',
-                'typedoc.config.ts',
-            ];
-            let hasTypedocConfig = false;
-            for (const c of typedocConfigs) {
-                if (await fs.pathExists(path.join(targetDir, c))) {
-                    hasTypedocConfig = true;
-                    break;
-                }
-            }
-            const typedoc = hasTypedocConfig || 'typedoc' in deps;
-            const filesWritten = await generateDocsSite(pkg, targetDir, {
-                typedoc,
-                siblings: (await readLockfile(targetDir))?.rules?.docs?.siblings,
-            });
-            return { filesWritten };
-        },
-    },
     {
         target: 'attw',
         description: 'Install @arethetypeswrong/cli + add an `attw` script (esm-only profile when applicable) and wire it into verify',

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@rtorcato/repo-tooling",
-	"version": "4.8.0",
+	"version": "5.0.1",
 	"description": "One CLI to scaffold, audit and fix your repo's whole toolchain — linting, tests, commits, releases & CI.",
 	"type": "module",
 	"keywords": [
@@ -85,12 +85,6 @@
 		"tooling/rollup/rollup.config.d.mts",
 		"tooling/rolldown/rolldown.config.mjs",
 		"tooling/rolldown/rolldown.config.d.mts",
-		"tooling/docusaurus/index.mjs",
-		"tooling/docusaurus/index.d.mts",
-		"tooling/docusaurus/sync-changelog.mjs",
-		"tooling/docusaurus/docs-helpers.mjs",
-		"tooling/docusaurus/theme-tokens.css",
-		"tooling/docusaurus/theme.css",
 		"tooling/biome/preset.json",
 		"tooling/bun/bunfig.toml",
 		"tooling/nx/nx.json",
@@ -199,10 +193,6 @@
 			"types": "./tooling/rolldown/rolldown.config.d.mts",
 			"import": "./tooling/rolldown/rolldown.config.mjs"
 		},
-		"./docusaurus": {
-			"types": "./tooling/docusaurus/index.d.mts",
-			"import": "./tooling/docusaurus/index.mjs"
-		},
 		"./biome": "./tooling/biome/preset.json",
 		"./nx": "./tooling/nx/nx.json",
 		"./changesets": "./tooling/changesets/config.json",

package/tooling/semantic-release/github.mjs

@@ -84,7 +84,7 @@ export default {
 // and the `version` field in package.json stop moving on the default branch.**
 // The git tag, the npm publish and the GitHub Release are unaffected and are
 // the source of truth for what shipped. Build any user-facing changelog from
-// GitHub Releases — `repo-tooling copy docusaurus-sync-changelog` does exactly
+// GitHub Releases — `@rtorcato/shared-docs`'s sync-changelog script does exactly
 // that — never from the frozen file.
 //
 // Adding a bypass actor to the ruleset would also make the push succeed. It is