@gitpagedocs/cli 1.1.54 → 1.1.56

package/data/i18n-langmenu.mjs

@@ -17,9 +17,21 @@ export const defaultLangMenu = {
           focusMode: "Modo foco",
           versionLinksLabel: "Links do repositorio",
           titleHeaderMenuMd: "Markdown",
+          titleHeaderMenuSourceViewer: "Codigo fonte",
           titleHeaderMenuVideo: "Vídeo",
           titleHeaderMenuAudio: "Áudio",
           titleHeaderMenuHtml: "Páginas",
+          sourceViewerBranchLabel: "Branch",
+          sourceViewerFilterLabel: "Filtrar arquivos",
+          sourceViewerClearLabel: "Limpar",
+          sourceViewerLoadingTree: "Carregando arvore do repositorio...",
+          sourceViewerLoadingFile: "Carregando arquivo...",
+          sourceViewerNotFound: "Repositorio, branch ou arvore de codigo nao encontrado.",
+          sourceViewerFileError: "Nao foi possivel carregar o arquivo.",
+          sourceViewerEmpty: "Nenhuma entrada encontrada.",
+          sourceViewerSelectFile: "Selecione um arquivo",
+          sourceViewerPreview: "Preview",
+          sourceViewerCode: "Codigo",
           lastUpdateVersionLabel: "Ultima versao de atualizacao",
           darkMode: "Modo escuro",
           lightMode: "Modo claro",
@@ -118,9 +130,21 @@ export const defaultLangMenu = {
           focusMode: "Focus mode",
           versionLinksLabel: "Repository links",
           titleHeaderMenuMd: "Markdown",
+          titleHeaderMenuSourceViewer: "Source code",
           titleHeaderMenuVideo: "Video",
           titleHeaderMenuAudio: "Audio",
           titleHeaderMenuHtml: "Pages",
+          sourceViewerBranchLabel: "Branch",
+          sourceViewerFilterLabel: "Filter files",
+          sourceViewerClearLabel: "Clear",
+          sourceViewerLoadingTree: "Loading source tree...",
+          sourceViewerLoadingFile: "Loading file...",
+          sourceViewerNotFound: "Repository, branch, or source tree was not found.",
+          sourceViewerFileError: "File could not be loaded.",
+          sourceViewerEmpty: "No entries found.",
+          sourceViewerSelectFile: "Select a file",
+          sourceViewerPreview: "Preview",
+          sourceViewerCode: "Code",
           lastUpdateVersionLabel: "Last update version",
           darkMode: "Dark mode",
           lightMode: "Light mode",
@@ -219,9 +243,21 @@ export const defaultLangMenu = {
           focusMode: "Modo foco",
           versionLinksLabel: "Enlaces del repositorio",
           titleHeaderMenuMd: "Markdown",
+          titleHeaderMenuSourceViewer: "Codigo fuente",
           titleHeaderMenuVideo: "Vídeo",
           titleHeaderMenuAudio: "Áudio",
           titleHeaderMenuHtml: "Páginas",
+          sourceViewerBranchLabel: "Branch",
+          sourceViewerFilterLabel: "Filtrar archivos",
+          sourceViewerClearLabel: "Limpiar",
+          sourceViewerLoadingTree: "Cargando arbol del repositorio...",
+          sourceViewerLoadingFile: "Cargando archivo...",
+          sourceViewerNotFound: "Repositorio, branch o arbol de codigo no encontrado.",
+          sourceViewerFileError: "No se pudo cargar el archivo.",
+          sourceViewerEmpty: "No se encontraron entradas.",
+          sourceViewerSelectFile: "Selecciona un archivo",
+          sourceViewerPreview: "Preview",
+          sourceViewerCode: "Codigo",
           lastUpdateVersionLabel: "Ultima version de actualizacion",
           darkMode: "Modo oscuro",
           lightMode: "Modo claro",

package/data/path-mappings.mjs

@@ -1,34 +1,26 @@
-/** Path and media mappings for doc versions */
-
-export const ROUTE_PATHS = {
-  1: { pt: "getting-started.md", en: "getting-started.md", es: "getting-started.md" },
-  2: { pt: "project-overview.md", en: "project-overview.md", es: "project-overview.md" },
-  3: { pt: "functionalities.md", en: "functionalities.md", es: "functionalities.md" },
-  4: { pt: "github-issues-projects.md", en: "github-issues-projects.md", es: "github-issues-projects.md" },
-  5: { pt: "git-introduction.md", en: "git-introduction.md", es: "git-introduction.md" },
-  6: { pt: "authorized-routes.md", en: "authorized-routes.md", es: "authorized-routes.md" },
-};
-
-export const VIDEO_IDS = ["bdIJkGr2NV0", "c67GaAkf1BE", "N3my6W_Rdwg", "r8jQ9hVA2qs"];
-
-export const PAGE2_AUDIO = {
-  enabled: true,
-  autoPlayOnLoad: true,
-  loopEnabled: false,
-  tracks: [
-    {
-      url: "https://www.youtube.com/watch?v=0w80F8FffQ4",
-      type: "youtube",
-      title: { pt: "Música página 2", en: "Page 2 music", es: "Música página 2" },
-    },
-  ],
-};
-
-export const SOURCE_VIEWER_META = {
-  titles: { pt: "Código fonte", en: "Source code", es: "Código fuente" },
-  descriptions: {
-    pt: "Visualizar código-fonte do projeto",
-    en: "View project source code",
-    es: "Ver código fuente del proyecto",
-  },
-};
+/** Path and media mappings for doc versions */
+
+export const ROUTE_PATHS = {
+  1: { pt: "getting-started.md", en: "getting-started.md", es: "getting-started.md" },
+  2: { pt: "project-overview.md", en: "project-overview.md", es: "project-overview.md" },
+  3: { pt: "functionalities.md", en: "functionalities.md", es: "functionalities.md" },
+  4: { pt: "github-issues-projects.md", en: "github-issues-projects.md", es: "github-issues-projects.md" },
+  5: { pt: "git-introduction.md", en: "git-introduction.md", es: "git-introduction.md" },
+  6: { pt: "authorized-routes.md", en: "authorized-routes.md", es: "authorized-routes.md" },
+};
+
+export const VIDEO_IDS = ["bdIJkGr2NV0", "c67GaAkf1BE", "N3my6W_Rdwg", "r8jQ9hVA2qs"];
+export const AUDIO_IDS = ["0w80F8FffQ4"];
+
+export const PAGE2_AUDIO = {
+  enabled: true,
+  autoPlayOnLoad: true,
+  loopEnabled: false,
+  tracks: [
+    {
+      url: "https://www.youtube.com/watch?v=0w80F8FffQ4",
+      type: "youtube",
+      title: { pt: "Musica pagina 2", en: "Page 2 music", es: "Musica pagina 2" },
+    },
+  ],
+};

package/data/route-metas.mjs

@@ -1,73 +1,93 @@
-/** Route and video metadata for doc versions */
-
-export const DEFAULT_HIERARCHY = { md: 0, html: 1, video: 2, audio: 3 };
-
-export const ROUTE_META_ID1 = {
-  titles: { pt: "Primeiros passos", en: "Getting Started", es: "Primeros pasos" },
-  descriptions: { pt: "Configure o repositório do zero", en: "Configure repository from zero", es: "Configura el repositorio desde cero" },
-};
-
-export const ROUTE_META_ID2 = {
-  titles: { pt: "Visão geral do projeto", en: "Project overview", es: "Visión general del proyecto" },
-  descriptions: { pt: "Stack, objetivo e estrutura do Git Page Docs", en: "Stack, goals and structure of Git Page Docs", es: "Stack, objetivos y estructura de Git Page Docs" },
-};
-
-export const ROUTE_META_ID3 = {
-  titles: { pt: "Funcionalidades", en: "Functionalities", es: "Funcionalidades" },
-  descriptions: { pt: "CLI, opções, configuração e recursos", en: "CLI, options, configuration and features", es: "CLI, opciones, configuración y funciones" },
-};
-
-export const ROUTE_META_ID4 = {
-  titles: { pt: "GitHub Issues e Projects", en: "GitHub issues and projects", es: "GitHub issues y projects" },
-  descriptions: { pt: "Como usar Issues e Projects no GitHub", en: "How to use GitHub Issues and Projects", es: "Cómo usar GitHub Issues y Projects" },
-};
-
-export const ROUTE_META_ID5 = {
-  titles: { pt: "Introdução ao Git", en: "Introduction to Git", es: "Introducción a Git" },
-  descriptions: { pt: "Conceitos básicos de Git para iniciantes", en: "Basic Git concepts for beginners", es: "Conceptos básicos de Git para principiantes" },
-};
-
-export const ROUTE_META_ID6 = {
-  titles: { pt: "Rotas autorizadas", en: "Authorized routes", es: "Rutas autorizadas" },
-  descriptions: {
-    pt: "Controle acesso por chave, roles e provedores externos",
-    en: "Control access by key, roles and external providers",
-    es: "Controla acceso por clave, roles y proveedores externos",
-  },
-};
-
-export const VIDEO_META_ID1 = {
-  title: { pt: "Interactive vs non-interactive modes | Copilot CLI for beginners", en: "Interactive vs non-interactive modes | Copilot CLI for beginners", es: "Interactive vs non-interactive modes | Copilot CLI for beginners" },
-  description: {
-    pt: "Quer saber a forma mais rápida de usar o GitHub Copilot no terminal? Neste tutorial, exploramos os dois modos principais do Copilot CLI.",
-    en: "Want to know the fastest way to prompt GitHub Copilot from your terminal? In this beginner tutorial, we explore the two main modes of the Copilot CLI. Discover how to use the interactive mode to have GitHub Copilot run your project locally or use the non-interactive mode with the -p flag for quick summaries without leaving your shell context.",
-    es: "¿Quieres conocer la forma más rápida de usar GitHub Copilot desde tu terminal? En este tutorial exploramos los dos modos principales del Copilot CLI.",
-  },
-};
-
-export const VIDEO_META_ID2 = {
-  title: { pt: "How to use GitHub issues and projects | GitHub for Beginners", en: "How to use GitHub issues and projects | GitHub for Beginners", es: "How to use GitHub issues and projects | GitHub for Beginners" },
-  description: {
-    pt: "Aprenda a usar GitHub Issues e Projects para gerenciar seu trabalho.",
-    en: "Learn how to use GitHub Issues and Projects to manage your work effectively.",
-    es: "Aprende a usar GitHub Issues y Projects para gestionar tu trabajo.",
-  },
-};
-
-export const VIDEO_META_ID3 = {
-  title: { pt: "How I built an AI Python tutor with the GitHub Copilot SDK", en: "How I built an AI Python tutor with the GitHub Copilot SDK", es: "How I built an AI Python tutor with the GitHub Copilot SDK" },
-  description: {
-    pt: "Construindo um tutor de Python com IA usando o GitHub Copilot SDK.",
-    en: "Building an AI Python tutor using the GitHub Copilot SDK.",
-    es: "Construyendo un tutor de Python con IA usando el GitHub Copilot SDK.",
-  },
-};
-
-export const VIDEO_META_ID4 = {
-  title: { pt: "A brief introduction to Git for beginners | GitHub", en: "A brief introduction to Git for beginners | GitHub", es: "A brief introduction to Git for beginners | GitHub" },
-  description: {
-    pt: "Introdução ao Git para iniciantes.",
-    en: "A brief introduction to Git for beginners.",
-    es: "Una breve introducción a Git para principiantes.",
-  },
-};
+/** Route and video metadata for doc versions */
+
+export const DEFAULT_HIERARCHY = { md: 0, "source-viewer": 1, html: 2, video: 3, audio: 4 };
+
+export const ROUTE_META_ID1 = {
+  titles: { pt: "Primeiros passos", en: "Getting Started", es: "Primeros pasos" },
+  descriptions: { pt: "Configure o repositório do zero", en: "Configure repository from zero", es: "Configura el repositorio desde cero" },
+};
+
+export const ROUTE_META_ID2 = {
+  titles: { pt: "Visão geral do projeto", en: "Project overview", es: "Visión general del proyecto" },
+  descriptions: { pt: "Stack, objetivo e estrutura do Git Page Docs", en: "Stack, goals and structure of Git Page Docs", es: "Stack, objetivos y estructura de Git Page Docs" },
+};
+
+export const ROUTE_META_ID3 = {
+  titles: { pt: "Funcionalidades", en: "Functionalities", es: "Funcionalidades" },
+  descriptions: { pt: "CLI, opções, configuração e recursos", en: "CLI, options, configuration and features", es: "CLI, opciones, configuración y funciones" },
+};
+
+export const ROUTE_META_ID4 = {
+  titles: { pt: "GitHub Issues e Projects", en: "GitHub issues and projects", es: "GitHub issues y projects" },
+  descriptions: { pt: "Como usar Issues e Projects no GitHub", en: "How to use GitHub Issues and Projects", es: "Cómo usar GitHub Issues y Projects" },
+};
+
+export const ROUTE_META_ID5 = {
+  titles: { pt: "Introdução ao Git", en: "Introduction to Git", es: "Introducción a Git" },
+  descriptions: { pt: "Conceitos básicos de Git para iniciantes", en: "Basic Git concepts for beginners", es: "Conceptos básicos de Git para principiantes" },
+};
+
+export const ROUTE_META_ID6 = {
+  titles: { pt: "Rotas autorizadas", en: "Authorized routes", es: "Rutas autorizadas" },
+  descriptions: {
+    pt: "Controle acesso por chave, roles e provedores externos",
+    en: "Control access by key, roles and external providers",
+    es: "Controla acceso por clave, roles y proveedores externos",
+  },
+};
+
+export const SOURCE_VIEWER_META = {
+  id: 7,
+  titles: { pt: "Codigo fonte", en: "Source code", es: "Codigo fuente" },
+  descriptions: {
+    pt: "Explore a arvore do repositorio, navegue por pastas e visualize arquivos diretamente na documentacao.",
+    en: "Explore the repository tree, browse folders, and preview files directly inside the documentation.",
+    es: "Explora el arbol del repositorio, navega por carpetas y previsualiza archivos directamente en la documentacion.",
+  },
+};
+
+export const AUDIO_META_ID12 = {
+  id: 12,
+  title: { pt: "Trilha de audio", en: "Audio track", es: "Pista de audio" },
+  description: {
+    pt: "Ouça uma faixa de exemplo diretamente na documentacao.",
+    en: "Listen to a sample track directly inside the documentation.",
+    es: "Escucha una pista de ejemplo directamente en la documentacion.",
+  },
+};
+
+export const VIDEO_META_ID1 = {
+  title: { pt: "Interactive vs non-interactive modes | Copilot CLI for beginners", en: "Interactive vs non-interactive modes | Copilot CLI for beginners", es: "Interactive vs non-interactive modes | Copilot CLI for beginners" },
+  description: {
+    pt: "Quer saber a forma mais rápida de usar o GitHub Copilot no terminal? Neste tutorial, exploramos os dois modos principais do Copilot CLI.",
+    en: "Want to know the fastest way to prompt GitHub Copilot from your terminal? In this beginner tutorial, we explore the two main modes of the Copilot CLI. Discover how to use the interactive mode to have GitHub Copilot run your project locally or use the non-interactive mode with the -p flag for quick summaries without leaving your shell context.",
+    es: "¿Quieres conocer la forma más rápida de usar GitHub Copilot desde tu terminal? En este tutorial exploramos los dos modos principales del Copilot CLI.",
+  },
+};
+
+export const VIDEO_META_ID2 = {
+  title: { pt: "How to use GitHub issues and projects | GitHub for Beginners", en: "How to use GitHub issues and projects | GitHub for Beginners", es: "How to use GitHub issues and projects | GitHub for Beginners" },
+  description: {
+    pt: "Aprenda a usar GitHub Issues e Projects para gerenciar seu trabalho.",
+    en: "Learn how to use GitHub Issues and Projects to manage your work effectively.",
+    es: "Aprende a usar GitHub Issues y Projects para gestionar tu trabajo.",
+  },
+};
+
+export const VIDEO_META_ID3 = {
+  title: { pt: "How I built an AI Python tutor with the GitHub Copilot SDK", en: "How I built an AI Python tutor with the GitHub Copilot SDK", es: "How I built an AI Python tutor with the GitHub Copilot SDK" },
+  description: {
+    pt: "Construindo um tutor de Python com IA usando o GitHub Copilot SDK.",
+    en: "Building an AI Python tutor using the GitHub Copilot SDK.",
+    es: "Construyendo un tutor de Python con IA usando el GitHub Copilot SDK.",
+  },
+};
+
+export const VIDEO_META_ID4 = {
+  title: { pt: "A brief introduction to Git for beginners | GitHub", en: "A brief introduction to Git for beginners | GitHub", es: "A brief introduction to Git for beginners | GitHub" },
+  description: {
+    pt: "Introdução ao Git para iniciantes.",
+    en: "A brief introduction to Git for beginners.",
+    es: "Una breve introducción a Git para principiantes.",
+  },
+};

package/data/urls.mjs

@@ -1,7 +1,12 @@
-/** Official layout URLs for git-page-docs repository */
-
-export const OFFICIAL_LAYOUTS_CONFIG_URL =
-  "https://github.com/Vidigal-code/git-page-docs/blob/main/gitpagedocs/layouts/layoutsConfig.json";
-
-export const OFFICIAL_LAYOUTS_TEMPLATES_URL =
-  "https://github.com/Vidigal-code/git-page-docs/blob/main/gitpagedocs/layouts/templates";
+/** Official layout URLs for git-page-docs repository.
+ * The canonical home is the root `gitpagelayouts/` folder; the legacy
+ * `gitpagedocs/layouts/` folder stays online for older deployments. */
+
+export const OFFICIAL_LAYOUTS_CONFIG_URL =
+  "https://github.com/Vidigal-code/git-page-docs/blob/main/gitpagelayouts/layoutsConfig.json";
+
+export const OFFICIAL_LAYOUTS_TEMPLATES_URL =
+  "https://github.com/Vidigal-code/git-page-docs/blob/main/gitpagelayouts/templates";
+
+export const LEGACY_OFFICIAL_LAYOUTS_CONFIG_URL =
+  "https://github.com/Vidigal-code/git-page-docs/blob/main/gitpagedocs/layouts/layoutsConfig.json";

package/package.json

@@ -1,60 +1,60 @@
-{
-  "name": "@gitpagedocs/cli",
-  "version": "1.1.54",
-  "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.56",
+  "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.56",
+    "@gitpagedocs/tools": "^1.1.56",
+    "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/config-clear.ts

@@ -0,0 +1,23 @@
+import { AiConfigFileRepository } from "../../ai/infrastructure/ai-config-file";
+import type { CommandContext } from "./run-command";
+
+/**
+ * `gitpagedocs config clear` — delete the stored `.gitpagedocsconfig` from the
+ * per-user config directory and any legacy repo-root copy, wiping the saved AI
+ * credentials (API key, provider, scan paths).
+ */
+export async function runConfigClear(ctx: CommandContext): Promise<void> {
+  const repository = new AiConfigFileRepository({ cwd: ctx.cwd });
+  const removed = await repository.clear();
+
+  if (!removed.length) {
+    // eslint-disable-next-line no-console
+    console.log("\n  No stored .gitpagedocsconfig found - nothing to clear.\n");
+    return;
+  }
+
+  // eslint-disable-next-line no-console
+  console.log(
+    ["", "  Stored AI configuration removed (credentials wiped):", ...removed.map((p) => `    - ${p}`), ""].join("\n"),
+  );
+}

package/presentation/commands/diagnostics.ts

@@ -50,7 +50,7 @@ export async function runDoctor(ctx: CommandContext): Promise<void> {
   console.log("\n  gitpagedocs doctor\n");
   for (const c of checks) {
     // eslint-disable-next-line no-console
-    console.log(`  ${c.ok ? "✓" : "✗"}  ${c.label.padEnd(22)} ${c.detail}`);
+    console.log(`  ${c.ok ? "[ok]" : "[x] "} ${c.label.padEnd(22)} ${c.detail}`);
   }
   const failed = checks.filter((c) => !c.ok && c.label !== "gh (GitHub CLI)").length;
   // eslint-disable-next-line no-console

package/presentation/commands/run-command.ts

@@ -18,6 +18,7 @@ export type CommandHandler = (ctx: CommandContext) => Promise<void>;
 import { runVersion, runDoctor, runUpdate } from "./diagnostics";
 import { runProvider, runModels } from "./ai-info";
 import { runConfig } from "./config-info";
+import { runConfigClear } from "./config-clear";
 import { runMcp } from "./mcp";
 import { runDocs } from "./docs";
 import { runPagesActions, runPagesDeploy } from "./pages";
@@ -54,6 +55,11 @@ export async function runNewCommand(argv: string[], pkgRoot: string): Promise<bo
     await runPagesDeploy(ctx);
     return true;
   }
+  // Wipe the stored AI credentials config: `config clear`.
+  if (args[0] === "config" && args[1] === "clear") {
+    await runConfigClear(ctx);
+    return true;
+  }
 
   const handler = REGISTRY[args[0] ?? ""];
   if (!handler) return false;

package/presentation/index.ts

@@ -100,7 +100,7 @@ async function main(): Promise<void> {
 
       const pages = result.summary.pages ?? [];
       console.log(
-        `\n🎉 Processo completo! Páginas no padrão gitpagedocs: ${pages.join(", ") || "(nenhuma)"}`,
+        `\nProcesso completo. Páginas no padrão gitpagedocs: ${pages.join(", ") || "(nenhuma)"}`,
       );
       console.log(
         `[gitpagedocs:ai] ${result.summary.outputs.length} arquivos markdown gerados e conectados ao config.json da versão mais recente.`,

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 {
@@ -23,6 +23,28 @@ const DEFAULT_ICON_SVG = `<?xml version="1.0" encoding="utf-8"?>
 </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 });
@@ -75,6 +97,8 @@ export async function writeConfigOnlyOutput(options) {
     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) {