@gitpagedocs/cli 1.1.53 → 1.1.55

package/index.mjs

@@ -1,38 +1,38 @@
-#!/usr/bin/env node
-
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { spawnSync } from "node:child_process";
-
-const scriptPath = fileURLToPath(import.meta.url);
-const scriptDir = path.dirname(scriptPath);
-const tsEntry = path.join(scriptDir, "presentation", "index.ts");
-
-// Resolve tsx from THIS package's location, not the user's cwd. `node --import
-// tsx` would otherwise resolve the bare "tsx" specifier relative to the current
-// working directory, which fails when the CLI is installed globally and run
-// from a project that doesn't depend on tsx (ERR_MODULE_NOT_FOUND 'tsx').
-let tsxLoader = "tsx";
-try {
-  tsxLoader = import.meta.resolve("tsx");
-} catch {
-  // Older Node without a stable import.meta.resolve — fall back to the bare
-  // specifier (works when tsx is resolvable from the cwd or globally).
-}
-
-const result = spawnSync(
-  process.execPath,
-  ["--import", tsxLoader, tsEntry, ...process.argv.slice(2)],
-  {
-    stdio: "inherit",
-    cwd: process.cwd(),
-    env: process.env,
-  },
-);
-
-if (result.error) {
-  console.error("[gitpagedocs] Failed to run TypeScript CLI runtime.", result.error);
-  process.exitCode = 1;
-} else if (typeof result.status === "number" && result.status !== 0) {
-  process.exitCode = result.status;
-}
+#!/usr/bin/env node
+
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { spawnSync } from "node:child_process";
+
+const scriptPath = fileURLToPath(import.meta.url);
+const scriptDir = path.dirname(scriptPath);
+const tsEntry = path.join(scriptDir, "presentation", "index.ts");
+
+// Resolve tsx from THIS package's location, not the user's cwd. `node --import
+// tsx` would otherwise resolve the bare "tsx" specifier relative to the current
+// working directory, which fails when the CLI is installed globally and run
+// from a project that doesn't depend on tsx (ERR_MODULE_NOT_FOUND 'tsx').
+let tsxLoader = "tsx";
+try {
+  tsxLoader = import.meta.resolve("tsx");
+} catch {
+  // Older Node without a stable import.meta.resolve — fall back to the bare
+  // specifier (works when tsx is resolvable from the cwd or globally).
+}
+
+const result = spawnSync(
+  process.execPath,
+  ["--import", tsxLoader, tsEntry, ...process.argv.slice(2)],
+  {
+    stdio: "inherit",
+    cwd: process.cwd(),
+    env: process.env,
+  },
+);
+
+if (result.error) {
+  console.error("[gitpagedocs] Failed to run TypeScript CLI runtime.", result.error);
+  process.exitCode = 1;
+} else if (typeof result.status === "number" && result.status !== 0) {
+  process.exitCode = result.status;
+}

package/infrastructure/gitpagedocs-config-file.ts

@@ -1,47 +1,47 @@
-import fs from "node:fs/promises";
-import { defaultConfigLoader } from "@gitpagedocs/tools";
-
-export interface DocsAccessConfig {
-  enabled: boolean;
-  publicKey: string;
-}
-
-/**
- * Reads and patches the generated gitpagedocs/config.json IN PLACE, preserving
- * every existing key (raw-JSON round-trip — it never reserializes through a typed
- * model that could drop unknown fields). Used by interactive commands that need
- * to persist a single value (e.g. the documentation password public key).
- */
-export class GitPageDocsConfigRepository {
-  constructor(private readonly cwd: string = process.cwd()) {}
-
-  /** Absolute path to the JSON config, or throws a friendly, actionable error. */
-  async resolvePath(): Promise<string> {
-    const resolved = await defaultConfigLoader.resolveConfigPath(this.cwd);
-    if (!resolved) {
-      throw new Error("gitpagedocs config.json not found. Run `gitpagedocs` first to generate it.");
-    }
-    if (!resolved.endsWith(".json")) {
-      throw new Error(`Expected a JSON config to patch, found "${resolved}". Use a gitpagedocs/config.json.`);
-    }
-    return resolved;
-  }
-
-  /**
-   * Set `site.docsAccess = { enabled, publicKey }`, leaving all other config keys
-   * untouched. Returns the path that was written.
-   */
-  async patchDocsAccess(publicKey: string, enabled = true): Promise<string> {
-    const configPath = await this.resolvePath();
-    const raw = await fs.readFile(configPath, "utf-8");
-    const config = JSON.parse(raw) as Record<string, unknown>;
-    const site =
-      config.site && typeof config.site === "object"
-        ? (config.site as Record<string, unknown>)
-        : {};
-    site.docsAccess = { enabled, publicKey } satisfies DocsAccessConfig;
-    config.site = site;
-    await fs.writeFile(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf-8");
-    return configPath;
-  }
-}
+import fs from "node:fs/promises";
+import { defaultConfigLoader } from "@gitpagedocs/tools";
+
+export interface DocsAccessConfig {
+  enabled: boolean;
+  publicKey: string;
+}
+
+/**
+ * Reads and patches the generated gitpagedocs/config.json IN PLACE, preserving
+ * every existing key (raw-JSON round-trip — it never reserializes through a typed
+ * model that could drop unknown fields). Used by interactive commands that need
+ * to persist a single value (e.g. the documentation password public key).
+ */
+export class GitPageDocsConfigRepository {
+  constructor(private readonly cwd: string = process.cwd()) {}
+
+  /** Absolute path to the JSON config, or throws a friendly, actionable error. */
+  async resolvePath(): Promise<string> {
+    const resolved = await defaultConfigLoader.resolveConfigPath(this.cwd);
+    if (!resolved) {
+      throw new Error("gitpagedocs config.json not found. Run `gitpagedocs` first to generate it.");
+    }
+    if (!resolved.endsWith(".json")) {
+      throw new Error(`Expected a JSON config to patch, found "${resolved}". Use a gitpagedocs/config.json.`);
+    }
+    return resolved;
+  }
+
+  /**
+   * Set `site.docsAccess = { enabled, publicKey }`, leaving all other config keys
+   * untouched. Returns the path that was written.
+   */
+  async patchDocsAccess(publicKey: string, enabled = true): Promise<string> {
+    const configPath = await this.resolvePath();
+    const raw = await fs.readFile(configPath, "utf-8");
+    const config = JSON.parse(raw) as Record<string, unknown>;
+    const site =
+      config.site && typeof config.site === "object"
+        ? (config.site as Record<string, unknown>)
+        : {};
+    site.docsAccess = { enabled, publicKey } satisfies DocsAccessConfig;
+    config.site = site;
+    await fs.writeFile(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf-8");
+    return configPath;
+  }
+}

package/package.json

@@ -1,60 +1,60 @@
-{
-  "name": "@gitpagedocs/cli",
-  "version": "1.1.53",
-  "description": "CLI that scaffolds and maintains gitpagedocs documentation, generates docs with AI, configures GitHub Pages, and runs the MCP server.",
-  "bin": {
-    "gitpagedocs": "index.mjs"
-  },
-  "main": "index.mjs",
-  "files": [
-    "index.mjs",
-    "start.mjs",
-    "ai",
-    "application",
-    "builders",
-    "content",
-    "contracts",
-    "data",
-    "domain",
-    "home",
-    "infrastructure",
-    "presentation",
-    "runtime",
-    "ui",
-    "prebuilt",
-    "README.md"
-  ],
-  "engines": {
-    "node": ">=20"
-  },
-  "dependencies": {
-    "@clack/prompts": "^1.5.1",
-    "@gitpagedocs/mcp": "^1.1.53",
-    "@gitpagedocs/tools": "^1.1.53",
-    "tsx": "^4.21.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Vidigal-code/git-page-docs.git",
-    "directory": "cli"
-  },
-  "keywords": [
-    "gitpagedocs",
-    "documentation",
-    "markdown",
-    "spa",
-    "cli",
-    "github-pages",
-    "create-gitpagedocs"
-  ],
-  "author": "Vidigal-code",
-  "license": "ISC",
-  "bugs": {
-    "url": "https://github.com/Vidigal-code/git-page-docs/issues"
-  },
-  "homepage": "https://vidigal-code.github.io/git-page-docs/",
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org/",
-    "access": "public"
-  }
-}
+{
+  "name": "@gitpagedocs/cli",
+  "version": "1.1.55",
+  "description": "CLI that scaffolds and maintains gitpagedocs documentation, generates docs with AI, configures GitHub Pages, and runs the MCP server.",
+  "bin": {
+    "gitpagedocs": "index.mjs"
+  },
+  "main": "index.mjs",
+  "files": [
+    "index.mjs",
+    "start.mjs",
+    "ai",
+    "application",
+    "builders",
+    "content",
+    "contracts",
+    "data",
+    "domain",
+    "home",
+    "infrastructure",
+    "presentation",
+    "runtime",
+    "ui",
+    "prebuilt",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.5.1",
+    "@gitpagedocs/mcp": "^1.1.54",
+    "@gitpagedocs/tools": "^1.1.54",
+    "tsx": "^4.21.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Vidigal-code/git-page-docs.git",
+    "directory": "cli"
+  },
+  "keywords": [
+    "gitpagedocs",
+    "documentation",
+    "markdown",
+    "spa",
+    "cli",
+    "github-pages",
+    "create-gitpagedocs"
+  ],
+  "author": "Vidigal-code",
+  "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/Vidigal-code/git-page-docs/issues"
+  },
+  "homepage": "https://vidigal-code.github.io/git-page-docs/",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  }
+}

package/presentation/commands/password.ts

@@ -1,62 +1,62 @@
-import { NodeCryptoService, deriveDocAccessKeys } from "@gitpagedocs/tools";
-import type { CommandContext } from "./run-command";
-import { askPassword, note, outro } from "../ui/clack";
-import { interactivePromptsAvailable } from "../ui/prompts";
-import { GitPageDocsConfigRepository } from "../../infrastructure/gitpagedocs-config-file";
-
-const MIN_PASSWORD_LENGTH = 4;
-
-/**
- * `gitpagedocs password` — interactively set a documentation access password.
- *
- * Type + confirm a password, derive the double-hash key pair, write the PUBLIC
- * key into gitpagedocs/config.json (which makes the frontend gate the docs), and
- * print the PRIVATE key for the user to copy. The password itself is never stored.
- */
-export async function runPassword(ctx: CommandContext): Promise<void> {
-  if (!interactivePromptsAvailable()) {
-    // eslint-disable-next-line no-console
-    console.log("\n  `gitpagedocs password` is interactive — run it in a terminal (TTY).\n");
-    return;
-  }
-
-  const password = await askPassword({
-    message: "Documentation password:",
-    validate: (v) =>
-      v && v.trim().length >= MIN_PASSWORD_LENGTH
-        ? undefined
-        : `Use at least ${MIN_PASSWORD_LENGTH} characters.`,
-  });
-  const confirmation = await askPassword({
-    message: "Confirm password:",
-    validate: (v) => (v ? undefined : "Required."),
-  });
-
-  if (password !== confirmation) {
-    note("Passwords do not match. Nothing was changed.", "Aborted");
-    return;
-  }
-
-  const { privateKey, publicKey } = await deriveDocAccessKeys(password, new NodeCryptoService());
-
-  let configPath: string;
-  try {
-    configPath = await new GitPageDocsConfigRepository(ctx.cwd).patchDocsAccess(publicKey);
-  } catch (error) {
-    note(error instanceof Error ? error.message : String(error), "Could not save");
-    return;
-  }
-
-  note(
-    `Public key saved to ${configPath}\nThe documentation is now password-protected.`,
-    "Saved",
-  );
-  // eslint-disable-next-line no-console
-  console.log(
-    "\n  PRIVATE KEY (copy & keep it safe — it also unlocks the docs):\n\n" +
-      `    ${privateKey}\n\n` +
-      "  Readers can unlock with the password OR this private key.\n" +
-      "  To remove protection, set site.docsAccess.enabled to false in config.json.\n",
-  );
-  outro("Done.");
-}
+import { NodeCryptoService, deriveDocAccessKeys } from "@gitpagedocs/tools";
+import type { CommandContext } from "./run-command";
+import { askPassword, note, outro } from "../ui/clack";
+import { interactivePromptsAvailable } from "../ui/prompts";
+import { GitPageDocsConfigRepository } from "../../infrastructure/gitpagedocs-config-file";
+
+const MIN_PASSWORD_LENGTH = 4;
+
+/**
+ * `gitpagedocs password` — interactively set a documentation access password.
+ *
+ * Type + confirm a password, derive the double-hash key pair, write the PUBLIC
+ * key into gitpagedocs/config.json (which makes the frontend gate the docs), and
+ * print the PRIVATE key for the user to copy. The password itself is never stored.
+ */
+export async function runPassword(ctx: CommandContext): Promise<void> {
+  if (!interactivePromptsAvailable()) {
+    // eslint-disable-next-line no-console
+    console.log("\n  `gitpagedocs password` is interactive — run it in a terminal (TTY).\n");
+    return;
+  }
+
+  const password = await askPassword({
+    message: "Documentation password:",
+    validate: (v) =>
+      v && v.trim().length >= MIN_PASSWORD_LENGTH
+        ? undefined
+        : `Use at least ${MIN_PASSWORD_LENGTH} characters.`,
+  });
+  const confirmation = await askPassword({
+    message: "Confirm password:",
+    validate: (v) => (v ? undefined : "Required."),
+  });
+
+  if (password !== confirmation) {
+    note("Passwords do not match. Nothing was changed.", "Aborted");
+    return;
+  }
+
+  const { privateKey, publicKey } = await deriveDocAccessKeys(password, new NodeCryptoService());
+
+  let configPath: string;
+  try {
+    configPath = await new GitPageDocsConfigRepository(ctx.cwd).patchDocsAccess(publicKey);
+  } catch (error) {
+    note(error instanceof Error ? error.message : String(error), "Could not save");
+    return;
+  }
+
+  note(
+    `Public key saved to ${configPath}\nThe documentation is now password-protected.`,
+    "Saved",
+  );
+  // eslint-disable-next-line no-console
+  console.log(
+    "\n  PRIVATE KEY (copy & keep it safe — it also unlocks the docs):\n\n" +
+      `    ${privateKey}\n\n` +
+      "  Readers can unlock with the password OR this private key.\n" +
+      "  To remove protection, set site.docsAccess.enabled to false in config.json.\n",
+  );
+  outro("Done.");
+}

package/presentation/options/resolver.ts

@@ -1,48 +1,48 @@
-import type { CliOptions } from "../../domain/models/cli-options";
-import { parseCliOptions } from "./parser";
-import {
-  shouldRunInteractive,
-  promptConfigOnlyOptions,
-  promptHomeOptions,
-  promptDeployOptions,
-  ensureGitRepoInteractive,
-  interactivePromptsAvailable,
-} from "../ui/prompts";
-import { DEFAULTS } from "./schema";
-// @ts-expect-error .mjs runtime module is type-less in this package.
-import { detectRepoFromGit } from "../../runtime/git-ops.mjs";
-
-export async function resolveOptions(argv: string[], env: NodeJS.ProcessEnv): Promise<CliOptions> {
-  const parsed = parseCliOptions(argv, env);
-
-  if (parsed.mode === "home") {
-    parsed.repositorySearch = parsed.repositorySearch ?? DEFAULTS.home.repositorySearch;
-    parsed.basePath = parsed.basePath ?? parsed.docsPath ?? DEFAULTS.home.basePath;
-  }
-
-  // `deploy` / `--push` need owner + repo AND a git repo. If anything is
-  // missing, prompt interactively (owner/repo pre-filled from the git origin
-  // remote; offer to `git init`) instead of throwing. In CI/non-TTY we fall
-  // through so the explicit guards in the push flow still fire clearly.
-  if (parsed.shouldPush && interactivePromptsAvailable()) {
-    let resolved = parsed;
-    if (!parsed.githubOwner || !parsed.githubRepo) {
-      const detected = detectRepoFromGit(process.cwd()) as { owner: string; repo: string } | null;
-      resolved = await promptDeployOptions(parsed, detected);
-    }
-    await ensureGitRepoInteractive(process.cwd());
-    return resolved;
-  }
-
-  const runHomeInteractive = parsed.isInteractive || (shouldRunInteractive(argv) && parsed.mode === "home");
-  if (runHomeInteractive && parsed.mode === "home") {
-    return promptHomeOptions(parsed);
-  }
-
-  const runConfigInteractive = parsed.isInteractive || (shouldRunInteractive(argv) && parsed.mode === "config-only");
-  if (runConfigInteractive && parsed.mode === "config-only") {
-    return promptConfigOnlyOptions(parsed);
-  }
-
-  return parsed;
-}
+import type { CliOptions } from "../../domain/models/cli-options";
+import { parseCliOptions } from "./parser";
+import {
+  shouldRunInteractive,
+  promptConfigOnlyOptions,
+  promptHomeOptions,
+  promptDeployOptions,
+  ensureGitRepoInteractive,
+  interactivePromptsAvailable,
+} from "../ui/prompts";
+import { DEFAULTS } from "./schema";
+// @ts-expect-error .mjs runtime module is type-less in this package.
+import { detectRepoFromGit } from "../../runtime/git-ops.mjs";
+
+export async function resolveOptions(argv: string[], env: NodeJS.ProcessEnv): Promise<CliOptions> {
+  const parsed = parseCliOptions(argv, env);
+
+  if (parsed.mode === "home") {
+    parsed.repositorySearch = parsed.repositorySearch ?? DEFAULTS.home.repositorySearch;
+    parsed.basePath = parsed.basePath ?? parsed.docsPath ?? DEFAULTS.home.basePath;
+  }
+
+  // `deploy` / `--push` need owner + repo AND a git repo. If anything is
+  // missing, prompt interactively (owner/repo pre-filled from the git origin
+  // remote; offer to `git init`) instead of throwing. In CI/non-TTY we fall
+  // through so the explicit guards in the push flow still fire clearly.
+  if (parsed.shouldPush && interactivePromptsAvailable()) {
+    let resolved = parsed;
+    if (!parsed.githubOwner || !parsed.githubRepo) {
+      const detected = detectRepoFromGit(process.cwd()) as { owner: string; repo: string } | null;
+      resolved = await promptDeployOptions(parsed, detected);
+    }
+    await ensureGitRepoInteractive(process.cwd());
+    return resolved;
+  }
+
+  const runHomeInteractive = parsed.isInteractive || (shouldRunInteractive(argv) && parsed.mode === "home");
+  if (runHomeInteractive && parsed.mode === "home") {
+    return promptHomeOptions(parsed);
+  }
+
+  const runConfigInteractive = parsed.isInteractive || (shouldRunInteractive(argv) && parsed.mode === "config-only");
+  if (runConfigInteractive && parsed.mode === "config-only") {
+    return promptConfigOnlyOptions(parsed);
+  }
+
+  return parsed;
+}

package/runtime/output.mjs

@@ -1,4 +1,4 @@
-import { existsSync, rmSync } from "node:fs";
+import { existsSync, readdirSync, rmSync } from "node:fs";
 import { mkdir, writeFile } from "node:fs/promises";
 import path from "node:path";
 import {
@@ -15,15 +15,37 @@ function isWithin(parent, child) {
   return !rel.startsWith("..") && !path.isAbsolute(rel);
 }
 
-const DEFAULT_ICON_SVG = `<?xml version="1.0" encoding="utf-8"?>
+const DEFAULT_ICON_SVG = `<?xml version="1.0" encoding="utf-8"?>
 <svg width="800px" height="800px" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
 <path opacity="0.1" fill-rule="evenodd" clip-rule="evenodd" d="M12 3C4.5885 3 3 4.5885 3 12C3 19.4115 4.5885 21 12 21C19.4115 21 21 19.4115 21 12C21 4.5885 19.4115 3 12 3ZM14.2695 9.03471C15.1872 8.34452 15.7204 8.25293 15.9299 8.25017C16.1326 8.86788 16.1588 9.54654 16.0042 10.1835C15.9945 10.2234 15.9842 10.263 15.9731 10.3025C15.941 10.4168 15.9647 10.5393 16.0366 10.6333L16.0377 10.6347C16.0521 10.6537 16.0664 10.6728 16.0805 10.6922C16.5194 11.2949 16.7603 12.0687 16.7497 12.8714L16.7496 12.8747C16.7496 14.5738 16.3076 15.5644 15.6994 16.1583C15.0859 16.7572 14.2627 16.9938 13.4137 17.0968L13.3898 17.0997L13.3777 17.1014C12.443 17.2601 11.5456 17.2688 10.6078 17.1286L10.604 17.1281L10.5687 17.1233C9.72415 17.0085 8.90483 16.7616 8.29455 16.1566C7.68912 15.5564 7.25036 14.5643 7.25038 12.8747L7.25034 12.8714C7.23972 12.0687 7.48056 11.2949 7.91949 10.6922C7.93482 10.6711 7.9504 10.6503 7.96621 10.6297C8.03648 10.538 8.05962 10.4184 8.02812 10.3068L8.02599 10.2993C8.01523 10.2608 8.00513 10.2222 7.99569 10.1834C7.84087 9.54684 7.86561 8.86863 8.0659 8.25016C8.27679 8.2528 8.81228 8.34432 9.73045 9.03473C9.76619 9.0616 9.80249 9.08937 9.83937 9.11807C9.93139 9.19 10.0529 9.21205 10.1644 9.17703L10.1657 9.17661C10.2268 9.15768 10.2882 9.13972 10.3496 9.12272C11.4349 8.82255 12.5651 8.82255 13.6504 9.12272C13.7088 9.13888 13.7671 9.15592 13.8253 9.17382L13.8277 9.17457C13.9431 9.21015 14.0704 9.18836 14.1678 9.11252C14.2022 9.08578 14.2361 9.05985 14.2695 9.03471Z" fill="#323232"/>
 <path d="M13.717 8.88177C12.5881 8.56954 11.4119 8.56954 10.283 8.88177C10.2637 8.8871 10.2444 8.89254 10.2252 8.89808C10.1067 8.93218 9.97923 8.909 9.8807 8.83491V8.83491C8.69311 7.94193 8.07278 7.98181 7.91927 8.01161V8.01161C7.8946 8.0164 7.87585 8.03481 7.86732 8.05844C7.86516 8.06441 7.86303 8.07038 7.8609 8.07636C7.61639 8.76505 7.57904 9.52813 7.75277 10.2425C7.76289 10.2841 7.77371 10.3255 7.78525 10.3667C7.78601 10.3694 7.78677 10.3721 7.78753 10.3748C7.79754 10.4102 7.7902 10.4483 7.7678 10.4776V10.4776C7.75074 10.4998 7.73394 10.5223 7.71741 10.545C7.24479 11.1939 6.98907 12.0213 7.00036 12.8747C7.00036 16.3399 8.80396 17.1358 10.535 17.3711L10.5708 17.3758C11.5347 17.5199 12.4587 17.511 13.4195 17.3479L13.4438 17.345C15.1832 17.1339 16.9996 16.3587 16.9996 12.8747C17.0109 12.0213 16.7552 11.1939 16.2826 10.545C16.2674 10.5242 16.252 10.5035 16.2364 10.483C16.236 10.4825 16.2356 10.482 16.2352 10.4815C16.211 10.4498 16.203 10.4085 16.2138 10.3701V10.3701C16.2257 10.3277 16.2368 10.2852 16.2471 10.2425C16.421 9.52611 16.3815 8.76076 16.1329 8.07176C16.1313 8.06753 16.1298 8.06331 16.1283 8.05909C16.1195 8.03503 16.1004 8.01628 16.0752 8.01142V8.01142C15.921 7.98164 15.3041 7.94381 14.1193 8.83491V8.83491C14.0208 8.90896 13.8933 8.93197 13.7748 8.89804C13.7556 8.89252 13.7363 8.8871 13.717 8.88177Z" stroke="#323232" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
 <path d="M3 12C3 4.5885 4.5885 3 12 3C19.4115 3 21 4.5885 21 12C21 19.4115 19.4115 21 12 21C4.5885 21 3 19.4115 3 12Z" stroke="#323232" stroke-width="2"/>
-</svg>
-`;
-
-async function writeJson(root, relativePath, data) {
+</svg>
+`;
+
+function listExistingVersionIds(root, outputDir) {
+  const versionsRoot = path.join(root, outputDir, "docs", "versions");
+  if (!existsSync(versionsRoot)) return [];
+  return readdirSync(versionsRoot, { withFileTypes: true })
+    .filter((entry) => entry.isDirectory())
+    .map((entry) => entry.name);
+}
+
+function removeLegacySourceViewerFiles(root, outputDir) {
+  const versionIds = listExistingVersionIds(root, outputDir);
+  for (const versionId of versionIds) {
+    for (const language of ["pt", "en", "es"]) {
+      for (const fileName of ["source-viewer", "source-viewer.html"]) {
+        const legacyPath = path.join(root, outputDir, "docs", "versions", versionId, language, fileName);
+        if (existsSync(legacyPath)) {
+          rmSync(legacyPath, { force: true });
+        }
+      }
+    }
+  }
+}
+
+async function writeJson(root, relativePath, data) {
   const absolutePath = path.join(root, relativePath);
   await mkdir(path.dirname(absolutePath), { recursive: true });
   await writeFile(absolutePath, `${JSON.stringify(data, null, 2)}\n`, "utf-8");
@@ -71,11 +93,13 @@ export async function writeConfigOnlyOutput(options) {
     rmSync(layoutsPath, { recursive: true, force: true });
   }
 
-  for (const [versionId, versionConfig] of Object.entries(artifacts.versionConfigs)) {
-    await writeJson(root, `${outputDir}/docs/versions/${versionId}/config.json`, versionConfig);
-  }
-
-  for (const [versionId, versionConfig] of Object.entries(artifacts.versionConfigs)) {
+  for (const [versionId, versionConfig] of Object.entries(artifacts.versionConfigs)) {
+    await writeJson(root, `${outputDir}/docs/versions/${versionId}/config.json`, versionConfig);
+  }
+
+  removeLegacySourceViewerFiles(root, outputDir);
+
+  for (const [versionId, versionConfig] of Object.entries(artifacts.versionConfigs)) {
     const versionRoutesMd = versionConfig["routes-md"] ?? versionConfig.routes ?? [];
     for (const route of versionRoutesMd) {
       for (const docPath of Object.values(route.path ?? {})) {