@gitpagedocs/cli 0.0.2 → 0.0.4

package/README.md

@@ -169,9 +169,8 @@ permissions on POSIX systems:
 - Linux: `$XDG_CONFIG_HOME/gitpagedocs/.gitpagedocsconfig` (or `~/.config/gitpagedocs/.gitpagedocsconfig`)
 
 Set `GITPAGEDOCS_CONFIG_DIR` to override the directory; delete the stored file,
-the vault and their credentials with `gitpagedocs config clear`; a legacy
-`.gitpagedocsconfig` in the repository root is migrated automatically on the next
-run. You can create/edit this file manually and then run `npx @gitpagedocs/cli ai`:
+the vault and their credentials with `gitpagedocs config clear`. You can create/edit
+this file manually and then run `npx @gitpagedocs/cli ai`:
 
 ```json
 {
@@ -200,8 +199,8 @@ derived from your password with PBKDF2-HMAC-SHA-256, 210k iterations) and the co
   (3 attempts, then the run aborts with `Vault password rejected`).
 - `GITPAGEDOCS_VAULT_PASSWORD` supplies the password without a prompt (CI, pipes, no TTY);
   on a first run it initializes the vault, otherwise it must match the existing one.
-- A legacy plaintext `"apiKey"` still present in an old file is sealed into the vault and
-  removed from the file the next time the config is read.
+- A plaintext `"apiKey"` written by 0.0.1 is sealed into the vault and removed from the file
+  the next time the config is read.
 - If you hand-write the file, leave the key out: enter it in the `gitpagedocs ai` prompt (it is
   sealed on save). `gitpagedocs chat` can also read the provider's environment variable
   (`gitpagedocs provider <id>` lists it) when no key is stored.

package/ai/application/resolve-chat-credentials.ts

@@ -13,7 +13,6 @@ export interface ResolvedChatCredentials {
 }
 
 export interface ResolveChatCredentialsInput {
-  readonly cwd: string;
   /** Overrides the stored/detected provider (e.g. a `--provider` flag). */
   readonly providerOverride?: string;
   /** Overrides the stored/detected model (e.g. a `--model` flag). */
@@ -40,7 +39,7 @@ export async function resolveChatCredentials(
   input: ResolveChatCredentialsInput,
 ): Promise<ResolvedChatCredentials | null> {
   const env = input.env ?? process.env;
-  const configRepo = input.configRepo ?? new AiConfigFileRepository({ cwd: input.cwd });
+  const configRepo = input.configRepo ?? new AiConfigFileRepository();
   const stored = await configRepo.read().catch(() => null);
 
   const providerId = resolveProviderId(input.providerOverride, stored, env);

package/ai/application/run-ai-cli-command.ts

@@ -172,11 +172,7 @@ async function saveConfig(config: AiCliConfig, deps: SaveConfigDeps): Promise<vo
 
 export async function runAiCliCommand(options: RunAiCliCommandOptions): Promise<{ summary: AiCliRunSummary; runConfigScaffold: boolean }> {
   const logInfo = options.onInfo ?? (() => undefined);
-  const configRepo = new AiConfigFileRepository({
-    cwd: options.cwd,
-    onMigrate: (fromPath, toPath) =>
-      logInfo(`[gitpagedocs:ai] Moved configuration from ${fromPath} to ${toPath} (secure user config directory).`),
-  });
+  const configRepo = new AiConfigFileRepository();
   const vault = options.vault ?? new AiKeyVault();
   const prompt = options.passwordPrompt ?? clackVaultPasswordPrompt;
 

package/ai/infrastructure/ai-config-file.ts

@@ -12,12 +12,8 @@ const CONFIG_DIR_MODE = 0o700;
 const CONFIG_FILE_MODE = 0o600;
 
 export interface AiConfigFileRepositoryOptions {
-  /** Working directory searched for a legacy `<cwd>/.gitpagedocsconfig`. */
-  cwd?: string;
   /** Destination directory; defaults to the per-user OS config directory. */
   configDir?: string;
-  /** Notified after a legacy config is moved into the user config directory. */
-  onMigrate?: (fromPath: string, toPath: string) => void;
 }
 
 /**
@@ -25,47 +21,32 @@ export interface AiConfigFileRepositoryOptions {
  * (`%APPDATA%\gitpagedocs` on Windows, `~/Library/Application Support/gitpagedocs`
  * on macOS, `$XDG_CONFIG_HOME/gitpagedocs` elsewhere) with owner-only
  * permissions, so the API key never lives inside a repository checkout.
- * A legacy `<cwd>/.gitpagedocsconfig` is migrated automatically on first read.
  */
 export class AiConfigFileRepository {
-  private readonly cwd: string;
   private readonly configDir: string;
-  private readonly onMigrate?: (fromPath: string, toPath: string) => void;
 
   constructor(options: AiConfigFileRepositoryOptions = {}) {
-    this.cwd = options.cwd ?? process.cwd();
     this.configDir = options.configDir ?? resolveUserConfigDir();
-    this.onMigrate = options.onMigrate;
   }
 
   getConfigPath(): string {
     return path.join(this.configDir, AI_CLI_CONFIG_FILENAME);
   }
 
-  getLegacyConfigPath(): string {
-    return path.join(this.cwd, AI_CLI_CONFIG_FILENAME);
-  }
-
   async read(): Promise<AiCliConfig | null> {
-    const current = await this.readFrom(this.getConfigPath());
-    if (current) return current;
-    return this.migrateLegacyConfig();
+    return this.readFrom(this.getConfigPath());
   }
 
-  /** Delete the stored configuration (secure and legacy locations), wiping
-   * any saved credentials. Returns the paths that were actually removed. */
+  /** Delete the stored configuration, wiping any saved settings. Returns the removed path, if any. */
   async clear(): Promise<string[]> {
-    const removed: string[] = [];
-    const candidates = new Set([this.getConfigPath(), this.getLegacyConfigPath()].map((p) => path.resolve(p)));
-    for (const configPath of candidates) {
-      try {
-        await fs.rm(configPath);
-        removed.push(configPath);
-      } catch {
-        // Missing file: nothing to remove at this location.
-      }
+    const configPath = path.resolve(this.getConfigPath());
+    try {
+      await fs.rm(configPath);
+      return [configPath];
+    } catch {
+      // Missing file: nothing to remove.
+      return [];
     }
-    return removed;
   }
 
   async write(config: AiCliConfig): Promise<void> {
@@ -84,18 +65,4 @@ export class AiConfigFileRepository {
     }
   }
 
-  private async migrateLegacyConfig(): Promise<AiCliConfig | null> {
-    const legacyPath = this.getLegacyConfigPath();
-    if (path.resolve(legacyPath) === path.resolve(this.getConfigPath())) return null;
-    const legacy = await this.readFrom(legacyPath);
-    if (!legacy) return null;
-    try {
-      await this.write(legacy);
-      await fs.rm(legacyPath, { force: true });
-      this.onMigrate?.(legacyPath, this.getConfigPath());
-    } catch {
-      // Migration is best-effort: keep serving the legacy config on failure.
-    }
-    return legacy;
-  }
 }

package/builders/theme-template.mjs

@@ -3,6 +3,14 @@
 import { PACKAGE_VERSION } from "../contracts/doc-versions.mjs";
 import { THEME_COLORS } from "../data/theme-colors.mjs";
 
+/** `#RRGGBB` (or `#RGB`) to `rgba(r, g, b, alpha)` for palette-derived glows and borders. */
+function rgba(hex, alpha) {
+  const digits = String(hex).replace("#", "");
+  const full = digits.length === 3 ? digits.replace(/./g, (c) => c + c) : digits.slice(0, 6);
+  const value = Number.parseInt(full, 16);
+  return `rgba(${(value >> 16) & 255}, ${(value >> 8) & 255}, ${value & 255}, ${alpha})`;
+}
+
 export function createThemeTemplate(layout, themeColors = THEME_COLORS) {
   const colors = themeColors[layout.id] ?? themeColors.default;
   const dark = layout.mode === "dark";
@@ -40,22 +48,24 @@ export function createThemeTemplate(layout, themeColors = THEME_COLORS) {
         padding: "24px",
         boxShadow: dark ? "0 18px 60px rgba(0, 0, 0, 0.45)" : "0 18px 50px rgba(15, 23, 42, 0.08)",
       },
+      // Controls follow the layout's own palette (card surface, card border,
+      // primary accent) so a green or amber theme never gets a slate select.
       button: {
         borderRadius: "12px",
         padding: "10px 18px",
-        border: dark ? "1px solid #334155" : "1px solid #E2E8F0",
-        hoverGlow: dark ? "0 0 0 3px rgba(124, 58, 237, 0.18)" : "0 0 0 4px rgba(109, 40, 217, 0.15)",
+        border: `1px solid ${colors.cardBorder}`,
+        hoverGlow: `0 0 0 3px ${rgba(colors.primary, 0.18)}`,
       },
       select: {
         borderRadius: "12px",
         padding: "10px 40px 10px 16px",
-        border: dark ? "1px solid #334155" : "1px solid #E2E8F0",
-        backgroundColor: dark ? "#0F172A" : "#FFFFFF",
+        border: `1px solid ${colors.cardBorder}`,
+        backgroundColor: colors.cardBackground,
         textAlign: "center",
         iconColor: colors.secondary,
-        hoverBorderColor: dark ? "rgba(34, 211, 238, 0.7)" : "rgba(8, 145, 178, 0.7)",
-        focusBorderColor: dark ? "rgba(124, 58, 237, 0.8)" : "rgba(109, 40, 217, 0.8)",
-        focusGlow: dark ? "0 0 0 4px rgba(124, 58, 237, 0.18)" : "0 0 0 4px rgba(109, 40, 217, 0.15)",
+        hoverBorderColor: rgba(colors.primary, 0.7),
+        focusBorderColor: rgba(colors.primary, 0.85),
+        focusGlow: `0 0 0 4px ${rgba(colors.primary, 0.18)}`,
       },
       checkbox: {
         width: "20px",

package/content/docs-en.mjs

@@ -188,7 +188,7 @@ The docs ship an AI assistant in two surfaces: an in-docs **chat drawer** (the A
 
 - **14 providers** via one shared core: OpenAI, Anthropic, Gemini, OpenRouter, Ollama, Azure OpenAI, Mistral, DeepSeek, Cohere, Groq, xAI, Together, Fireworks, Perplexity.
 - **Model selection** — pick from each provider's catalog (\`gitpagedocs models <provider>\`); a stored model id the provider has retired is replaced by the provider default automatically.
-- **Encrypted at rest** — your API key is sealed with AES-256-GCM behind a **local password** and is never stored in plaintext or logged. A legacy plaintext key is migrated and wiped on first unlock.
+- **Encrypted at rest** — your API key is sealed with AES-256-GCM behind a **local password** and is never stored in plaintext or logged.
 - **Inactivity auto-lock** — the chat drawer locks itself after \`site.AiChatAutoLockSeconds\` idle seconds (default 30, \`0\` disables): a centered countdown modal in your language lets you cancel or lock now, and unlocking asks for the password again.
 - **Resilient providers** — transient provider errors are retried (3 attempts) and a final failure is a plain message ending with "Try again!".
 - **AI documentation generation** — \`gitpagedocs ai\` scans chosen paths and writes multilingual markdown (pt/en/es); reusable via \`.gitpagedocsconfig\`, whose API key lives sealed in the encrypted \`.gitpagedocsvault\` (the vault password is asked on every run). \`gitpagedocs chat\` brings the same assistant to the terminal.
@@ -325,7 +325,7 @@ Runtime configuration lives in \`gitpagedocs/config.json\`. UI text lives next t
 
 - \`site.languages\` in \`gitpagedocs/config.json\` switches each language on (\`true\`) or off (\`false\`), in menu order: \`{ "languages": { "en": true, "pt": true, "es": false } }\`. A language set to \`false\` disappears from the language selector and its strings are not loaded, even when its docs exist.
 - \`gitpagedocs/langs/<lang>.json\` holds that language's strings: \`langmenu\` (header, search, source viewer, audio player, AI chat and docs-access labels) and \`translations\` (\`notFound\`, \`navigation\`, \`footer\`).
-- To add a language, create \`langs/<lang>.json\` and add \`"<lang>": true\` to \`site.languages\`. There is no \`langs.json\` any more: a manifest left by release 1.1.68 is still read by configs without \`site.languages\`, and the generator removes it.
+- To add a language, create \`langs/<lang>.json\` and add \`"<lang>": true\` to \`site.languages\`.
 - Older \`config.json\` files that still inline \`site.langmenu\` / \`translations\` keep working; when both exist, the \`langs/\` files win and any missing key is backfilled from the current release.
 
 ## \`site\` section
@@ -391,6 +391,10 @@ Version configs support multiple content types:
 
 Each route can include \`title\`, \`description\` (per language), \`titleCss\`, \`titlePosition: "center"\`, \`descriptionPosition: "center"\`, \`titleIsVisible\`, \`descriptionIsVisible\`.
 
+Settings every route shares are written once in \`routeDefaults\` at the top of the version config; each route keeps only its own values, and a value written on a route wins over \`routeDefaults\`.
+
+Header icons live in \`site.icons\`: \`defaults\` holds what all icons share (\`reactIcon\`, \`colorDark\`, \`colorLight\`, \`size\`, \`imgDark\`, \`imgLight\`, \`imgWidth\`, \`imgHeight\`) and each icon entry sets its \`tag\` plus any difference (\`null\` removes a field). The older flat keys (\`IconNavMenuOpenReactIconesTag\`, …) still work and win when both are present.
+
 ## Route-level variables (blockLink, container, url, browseAll)
 
 Per-route options for \`routes-md\`, \`routes-html\`, \`routes-video\`, and \`routes-audio\`:
@@ -505,8 +509,6 @@ Themes are JSON templates mapped by \`layoutsConfig.json\`.
 - \`gitpagelayouts/layoutsFallbackConfig.json\`
 - \`gitpagelayouts/templates/*.json\`
 
-The legacy \`gitpagedocs/layouts/\` location is no longer generated. It is still read by the viewer, and the CLI offers to move it into the layouts home - only after you confirm.
-
 ## Template model
 
 Each template usually includes:

package/content/docs-es.mjs

@@ -172,7 +172,7 @@ Los docs traen un asistente de IA en dos superficies: un **panel de chat** dentr
 
 - **14 proveedores** en un unico core compartido: OpenAI, Anthropic, Gemini, OpenRouter, Ollama, Azure OpenAI, Mistral, DeepSeek, Cohere, Groq, xAI, Together, Fireworks, Perplexity.
 - **Eleccion de modelo** — desde el catalogo de cada proveedor (\`gitpagedocs models <proveedor>\`); un id de modelo guardado que el proveedor retiro se reemplaza por el predeterminado del proveedor automaticamente.
-- **Cifrado en reposo** — tu clave de API se sella con AES-256-GCM detras de una **contrasena local** y nunca queda en texto plano ni en logs. Una clave heredada en texto plano se migra y se borra en el primer desbloqueo.
+- **Cifrado en reposo** — tu clave de API se sella con AES-256-GCM detras de una **contrasena local** y nunca queda en texto plano ni en logs.
 - **Bloqueo por inactividad** — el panel de chat se bloquea solo tras \`site.AiChatAutoLockSeconds\` segundos sin uso (por defecto 30, \`0\` lo desactiva): un modal centrado con cuenta regresiva, en tu idioma, permite cancelar o bloquear ahora, y desbloquear pide la contrasena de nuevo.
 - **Proveedores resilientes** — los errores transitorios del proveedor se reintentan (3 intentos) y un fallo final es un mensaje simple que termina en "¡Inténtalo de nuevo!".
 - **Generacion de documentacion con IA** — \`gitpagedocs ai\` recorre las rutas elegidas y escribe markdown multilingue (pt/en/es); reutilizable via \`.gitpagedocsconfig\`, cuya clave de API queda sellada en la boveda cifrada \`.gitpagedocsvault\` (la contrasena de la boveda se pide en cada ejecucion). \`gitpagedocs chat\` lleva el mismo asistente a la terminal.
@@ -189,7 +189,7 @@ La configuracion de runtime esta en \`gitpagedocs/config.json\`. Los textos de l
 
 - \`site.languages\` en \`gitpagedocs/config.json\` activa (\`true\`) o desactiva (\`false\`) cada idioma, en el orden del menu: \`{ "languages": { "en": true, "pt": true, "es": false } }\`. Un idioma en \`false\` desaparece del selector de idiomas y sus textos no se cargan, aunque existan sus docs.
 - \`gitpagedocs/langs/<lang>.json\` guarda los textos de ese idioma: \`langmenu\` (cabecera, busqueda, visor de codigo, reproductor de audio, chat de IA y acceso a los docs) y \`translations\` (\`notFound\`, \`navigation\`, \`footer\`).
-- Para agregar un idioma, crea \`langs/<lang>.json\` y agrega \`"<lang>": true\` en \`site.languages\`. Ya no existe \`langs.json\`: un manifiesto dejado por la version 1.1.68 aun se lee en configs antiguos sin \`site.languages\`, y el generador lo elimina.
+- Para agregar un idioma, crea \`langs/<lang>.json\` y agrega \`"<lang>": true\` en \`site.languages\`.
 - Los \`config.json\` antiguos que aun traen \`site.langmenu\` / \`translations\` inline siguen funcionando; cuando existen ambos, los archivos de \`langs/\` prevalecen y cualquier clave ausente se completa desde la version actual.
 
 ## Seccion \`site\`
@@ -205,6 +205,7 @@ Claves principales:
 - \`docsVersion\`: version seleccionada por defecto
 - \`ActiveNavigation\`: habilita anterior/siguiente
 - \`FocusMode\`: habilita modo foco/lectura
+- \`icons\`: iconos de la cabecera. \`icons.defaults\` guarda lo que todos comparten (\`reactIcon\`, \`colorDark\`, \`colorLight\`, \`size\`, \`imgDark\`, \`imgLight\`, \`imgWidth\`, \`imgHeight\`) y cada icono define su \`tag\` y lo que cambia (\`null\` quita un campo). Las claves planas de abajo siguen valiendo y ganan cuando existen ambas formas.
 - \`IconImageMenuHeaderImgWidth\`, \`IconImageMenuHeaderImgHeight\`: tamano del icono principal
 - \`IconImageMenuHeaderLightImg\`, \`IconImageMenuHeaderDarkImg\`: icono principal (light/dark)
 - \`IconProjectLinkImgWidth\`, \`IconProjectLinkImgHeight\`: tamano del icono enlace del proyecto
@@ -256,6 +257,8 @@ Los configs de version soportan multiples tipos:
 
 Cada ruta puede incluir \`title\`, \`description\` (por idioma), \`titleCss\`, \`titlePosition: "center"\`, \`descriptionPosition: "center"\`, \`titleIsVisible\`, \`descriptionIsVisible\`.
 
+Los ajustes que comparten todas las rutas se escriben una sola vez en \`routeDefaults\`, al inicio del config de la version; cada ruta guarda solo sus propios valores, y un valor escrito en la ruta gana sobre \`routeDefaults\`.
+
 ## Variables por ruta (blockLink, container, url, browseAll)
 
 Opciones por ruta en \`routes-md\`, \`routes-html\` y \`routes-video\`:

package/content/docs-pt.mjs

@@ -172,7 +172,7 @@ Os docs trazem um assistente de IA em duas superficies: um **chat drawer** dentr
 
 - **14 provedores** em um unico core compartilhado: OpenAI, Anthropic, Gemini, OpenRouter, Ollama, Azure OpenAI, Mistral, DeepSeek, Cohere, Groq, xAI, Together, Fireworks, Perplexity.
 - **Escolha de modelo** — a partir do catalogo de cada provedor (\`gitpagedocs models <provedor>\`); um id de modelo salvo que o provedor aposentou e trocado pelo padrao do provedor automaticamente.
-- **Criptografia em repouso** — sua chave de API e selada com AES-256-GCM atras de uma **senha local** e nunca fica em texto puro nem em logs. Uma chave legada em texto puro e migrada e apagada no primeiro desbloqueio.
+- **Criptografia em repouso** — sua chave de API e selada com AES-256-GCM atras de uma **senha local** e nunca fica em texto puro nem em logs.
 - **Bloqueio por inatividade** — o chat drawer se bloqueia sozinho apos \`site.AiChatAutoLockSeconds\` segundos sem uso (padrao 30, \`0\` desativa): um modal centralizado com contagem regressiva, no seu idioma, permite cancelar ou bloquear agora, e desbloquear pede a senha de novo.
 - **Provedores resilientes** — erros transitorios do provedor sao repetidos (3 tentativas) e uma falha final vira uma mensagem simples terminando em "Tente novamente!".
 - **Geracao de documentacao com IA** — \`gitpagedocs ai\` varre os caminhos escolhidos e escreve markdown multilingue (pt/en/es); reutilizavel via \`.gitpagedocsconfig\`, cuja chave de API fica selada no cofre criptografado \`.gitpagedocsvault\` (a senha do cofre e pedida em toda execucao). \`gitpagedocs chat\` leva o mesmo assistente ao terminal.
@@ -189,7 +189,7 @@ A configuracao de runtime fica em \`gitpagedocs/config.json\`. Os textos da UI f
 
 - \`site.languages\` em \`gitpagedocs/config.json\` liga (\`true\`) ou desliga (\`false\`) cada idioma, na ordem do menu: \`{ "languages": { "en": true, "pt": true, "es": false } }\`. Um idioma em \`false\` some do seletor de idiomas e seus textos nao sao carregados, mesmo que os docs existam.
 - \`gitpagedocs/langs/<lang>.json\` guarda os textos daquele idioma: \`langmenu\` (cabecalho, busca, visualizador de codigo, player de audio, chat de IA e acesso aos docs) e \`translations\` (\`notFound\`, \`navigation\`, \`footer\`).
-- Para adicionar um idioma, crie \`langs/<lang>.json\` e inclua \`"<lang>": true\` em \`site.languages\`. Nao existe mais \`langs.json\`: um manifesto deixado pela versao 1.1.68 ainda e lido por configs antigos sem \`site.languages\`, e o gerador o remove.
+- Para adicionar um idioma, crie \`langs/<lang>.json\` e inclua \`"<lang>": true\` em \`site.languages\`.
 - Arquivos \`config.json\` antigos que ainda trazem \`site.langmenu\` / \`translations\` inline continuam funcionando; quando os dois existem, os arquivos de \`langs/\` prevalecem e qualquer chave ausente e preenchida a partir da versao atual.
 
 ## Secao \`site\`
@@ -205,6 +205,7 @@ Principais chaves:
 - \`docsVersion\`: versao inicial selecionada
 - \`ActiveNavigation\`: habilita comportamento de anterior/proximo
 - \`FocusMode\`: habilita modo foco/leitura
+- \`icons\`: icones do cabecalho. \`icons.defaults\` guarda o que todos compartilham (\`reactIcon\`, \`colorDark\`, \`colorLight\`, \`size\`, \`imgDark\`, \`imgLight\`, \`imgWidth\`, \`imgHeight\`) e cada icone define seu \`tag\` e o que muda (\`null\` remove um campo). As chaves planas abaixo continuam valendo e vencem quando as duas formas existem.
 - \`IconImageMenuHeaderImgWidth\`, \`IconImageMenuHeaderImgHeight\`: tamanho do icone principal
 - \`IconImageMenuHeaderLightImg\`, \`IconImageMenuHeaderDarkImg\`: icone principal (light/dark)
 - \`IconProjectLinkImgWidth\`, \`IconProjectLinkImgHeight\`: tamanho do icone link do projeto
@@ -256,6 +257,8 @@ Configs de versao suportam multiplos tipos:
 
 Cada rota pode incluir \`title\`, \`description\` (por idioma), \`titleCss\`, \`titlePosition: "center"\`, \`descriptionPosition: "center"\`, \`titleIsVisible\`, \`descriptionIsVisible\`.
 
+Configuracoes que todas as rotas compartilham ficam uma unica vez em \`routeDefaults\`, no topo do config da versao; cada rota guarda so os proprios valores, e um valor escrito na rota vence o \`routeDefaults\`.
+
 ## Variaveis por rota (blockLink, container, url, browseAll)
 
 Opcoes por rota em \`routes-md\`, \`routes-html\` e \`routes-video\`:

package/contracts/doc-versions.mjs

@@ -1,3 +1,3 @@
-export const PACKAGE_VERSION = "0.0.2";
+export const PACKAGE_VERSION = "0.0.4";
 
 export const DOC_VERSIONS = [PACKAGE_VERSION];

package/contracts/index.mjs

@@ -4,8 +4,6 @@ export {
   LAYOUTS_CONFIG_FILENAME,
   LAYOUTS_FALLBACK_CONFIG_FILENAME,
   LAYOUTS_TEMPLATES_DIRNAME,
-  LEGACY_LAYOUTS_SUBDIR,
   normalizeLayoutsDir,
-  legacyLayoutsDir,
   layoutsArtifactPaths,
 } from "./layouts-paths.mjs";

package/contracts/langs-paths.mjs

@@ -4,24 +4,21 @@
  *   <outputDir>/config.json        `site.languages` — enable (true) / disable (false) each language
  *   <outputDir>/langs/<lang>.json  UI strings (langmenu + translations) of one language
  *
- * `<outputDir>/langs.json` was the 1.1.68 manifest; `site.languages` replaced
- * it, so the generator deletes a stale copy. The file names come from
- * @gitpagedocs/tools so the generator and the viewer never disagree about where
- * the bundles live.
+ * The file names come from @gitpagedocs/tools so the generator and the viewer
+ * never disagree about where the bundles live.
  */
-import { LANGS_DIRNAME, LANGS_MANIFEST_FILENAME } from "@gitpagedocs/tools/i18n";
+import { LANGS_DIRNAME } from "@gitpagedocs/tools/i18n";
 
 /**
  * Repo-relative POSIX paths of the language artifacts for a docs output dir.
  *
  * @param {string} outputDir Docs output dir (e.g. `gitpagedocs`).
- * @returns {{ config: string, legacyManifest: string, dir: string, bundle: (language: string) => string }}
+ * @returns {{ config: string, dir: string, bundle: (language: string) => string }}
  */
 export function languageArtifactPaths(outputDir) {
   const dir = `${outputDir}/${LANGS_DIRNAME}`;
   return {
     config: `${outputDir}/config.json`,
-    legacyManifest: `${outputDir}/${LANGS_MANIFEST_FILENAME}`,
     dir,
     bundle: (language) => `${dir}/${language}.json`,
   };

package/contracts/languages.mjs

@@ -1,6 +1,6 @@
 /**
- * Languages the generator ships UI strings and docs for, in menu order. This
- * is the list written to `gitpagedocs/langs.json`; every entry must have a
- * `langs/<lang>.json` bundle and a docs content module.
+ * Languages the generator ships UI strings and docs for, in menu order (the
+ * keys of `site.languages`); every entry must have a `langs/<lang>.json`
+ * bundle and a docs content module.
  */
 export const SUPPORTED_LANGUAGES = Object.freeze(["en", "pt", "es"]);

package/contracts/layouts-paths.d.mts

@@ -10,8 +10,6 @@ export declare const DEFAULT_LAYOUTS_DIR: string;
 export declare const LAYOUTS_CONFIG_FILENAME: string;
 export declare const LAYOUTS_FALLBACK_CONFIG_FILENAME: string;
 export declare const LAYOUTS_TEMPLATES_DIRNAME: string;
-export declare const LEGACY_LAYOUTS_SUBDIR: string;
 
 export declare function normalizeLayoutsDir(dir: string): string;
-export declare function legacyLayoutsDir(outputDir: string): string;
 export declare function layoutsArtifactPaths(layoutsDir: string): LayoutsArtifactPaths;

package/contracts/layouts-paths.mjs

@@ -4,9 +4,7 @@ import { trimSlashes } from "./path-segments.mjs";
  * Canonical locations for layout artifacts.
  *
  * Local layouts are generated into the standalone `gitpagelayouts/` home at the
- * project root. `<outputDir>/layouts/` is the legacy location that earlier
- * versions wrote: the viewer still reads it, and the CLI offers to migrate it,
- * but nothing is generated there any more.
+ * project root.
  *
  * Every consumer derives its paths from here so the folder name exists in one
  * place only.
@@ -24,9 +22,6 @@ export const LAYOUTS_FALLBACK_CONFIG_FILENAME = "layoutsFallbackConfig.json";
 /** Folder holding one JSON template per layout, inside a layouts folder. */
 export const LAYOUTS_TEMPLATES_DIRNAME = "templates";
 
-/** Sub-folder of the docs output dir that older versions generated into. */
-export const LEGACY_LAYOUTS_SUBDIR = "layouts";
-
 /**
  * Normalize a user-supplied folder name to a repo-relative POSIX path with no
  * leading/trailing separators, so it can be joined and stored in config.json
@@ -41,16 +36,6 @@ export function normalizeLayoutsDir(dir) {
   return normalized || DEFAULT_LAYOUTS_DIR;
 }
 
-/**
- * Legacy layouts folder for a given docs output dir.
- *
- * @param {string} outputDir Docs output dir (e.g. `gitpagedocs`).
- * @returns {string} Repo-relative POSIX path (e.g. `gitpagedocs/layouts`).
- */
-export function legacyLayoutsDir(outputDir) {
-  return `${normalizeLayoutsDir(outputDir)}/${LEGACY_LAYOUTS_SUBDIR}`;
-}
-
 /**
  * Repo-relative paths of every artifact a layouts folder owns.
  *

package/data/i18n-langmenu.mjs

@@ -7,6 +7,10 @@ export const defaultLangMenu = {
           menuOpen: "Menu",
           menuClose: "Fechar",
           showMenu: "Abrir menu",
+          mdCopyLabel: "Copiar Markdown",
+          mdCopiedLabel: "Copiado!",
+          mdCopyErrorLabel: "Não foi possível copiar",
+          mdDownloadLabel: "Baixar .md",
           hideMenu: "Fechar menu",
           quickNavigation: "Ctrl+K",
           searchOwnerLabel: "Usuario (ex: Vidigal-code)",
@@ -86,12 +90,24 @@ export const defaultLangMenu = {
           aiChatAutoLockDesc: "Você não usou a IA por um tempo. O chat será bloqueado e suas chaves continuarão criptografadas em {seconds}s.",
           aiChatAutoLockConfirmBtn: "Salvar",
           aiChatAutoLockCancelBtn: "Cancelar",
+          aiChatInfoBtn: "Como usar e riscos",
+          aiChatInfoTitle: "Como funciona o Assistente de IA",
+          aiChatInfoIntro: "O assistente responde perguntas sobre esta documentação usando o provedor de IA que você escolher (OpenAI, Anthropic Claude, Google Gemini ou um Ollama local). Este site não tem servidor próprio: o seu navegador fala direto com o provedor usando a sua própria chave de API. Leia os riscos antes de usar.",
+          aiChatInfoWorksTitle: "Como funciona",
+          aiChatInfoWorksItems: "Senha local: na primeira vez você cria uma senha. Ela nunca sai deste navegador e nunca é gravada; serve só para derivar a chave de criptografia (PBKDF2-SHA-256, 210.000 iterações).\nCofre criptografado: suas chaves de API ficam salvas criptografadas com AES-256-GCM no localStorage deste navegador. Sem a senha, os dados guardados são ilegíveis.\nDesbloqueio: enquanto o chat está desbloqueado, a senha fica só na memória desta página. A chave de API em si não fica guardada descriptografada.\nCada pergunta: a chave é descriptografada no momento do envio, usada só naquela requisição e liberada quando a resposta termina.\nRequisição: a pergunta, a conversa recente e o texto da página que você está lendo vão por HTTPS direto para o provedor escolhido, que devolve a resposta em tempo real.\nBloqueio: o botão de cadeado, ou o tempo de inatividade, remove a senha da página e volta para a tela de senha. As chaves salvas continuam criptografadas.",
+          aiChatInfoHowTitle: "Como usar",
+          aiChatInfoHowItems: "Crie uma senha local (mínimo de 4 caracteres; uma senha longa e única é mais segura). Anote: ela não pode ser recuperada.\nEscolha o provedor e o modelo e cole a sua chave de API. No Ollama, informe o endereço do servidor local (por exemplo http://localhost:11434).\nPergunte sobre a página que está lendo; a resposta aparece em tempo real. Você pode anexar imagens nos provedores que aceitam.\nAo terminar, clique no cadeado. Para voltar, digite a senha de novo.\nBotões do topo: engrenagem troca provedor ou chave; balão limpa a conversa; banco de dados apaga as chaves salvas; ponto de exclamação abre este guia.",
+          aiChatInfoFlowTitle: "O que pode acontecer",
+          aiChatInfoFlowItems: "Senha errada: o cofre não abre e nada é apagado. Você pode tentar de novo quantas vezes quiser.\nEsqueceu a senha: \"Redefinir senha\" apaga todas as chaves salvas e a senha; depois você cria uma senha nova e cola as chaves de novo.\nInatividade: depois de {seconds}s sem usar o chat aparece uma contagem regressiva. Cancelar mantém a sessão; senão o chat é bloqueado e pede a senha.\nErro temporário do provedor (limite de uso, servidor ocupado ou fora do ar): a requisição é repetida automaticamente até 3 vezes. Se continuar falhando, aparece uma mensagem terminando em \"Tente novamente!\".\nChave inválida, vencida ou sem crédito: o provedor recusa a requisição e aparece um erro de autenticação. Atualize a chave pela engrenagem.\nModelo desativado pelo provedor: o chat troca sozinho para o modelo padrão daquele provedor.\nOllama: precisa estar rodando no seu computador e aceitar requisições deste site (CORS). Caso contrário aparece erro de conexão.\nSem internet ou rede que bloqueia o provedor: a requisição falha com erro de conexão; nada é perdido.\nLimpar os dados do navegador, usar janela anônima ou outro navegador: o cofre não existe lá, então você cria uma senha e cola a chave de novo.",
+          aiChatInfoRisksTitle: "Riscos que você corre",
+          aiChatInfoRisksItems: "A chave viaja em cada requisição. Quem usar este computador com as ferramentas de desenvolvedor abertas (aba Rede) consegue vê-la enquanto você conversa. No Google Gemini ela vai na URL da requisição.\nUma senha fraca pode ser descoberta por quem copiar o armazenamento deste navegador. Use uma senha longa que você não usa em nenhum outro lugar.\nO bloqueio remove a senha da página, mas o navegador só libera essa memória depois. Não use o assistente em computadores compartilhados ou públicos.\nExtensões do navegador com acesso a este site podem ler o que a página vê, inclusive a chave enquanto está descriptografada. Use um perfil de navegador sem extensões desconhecidas.\nSuas perguntas, a conversa e o texto da página atual são enviados ao provedor escolhido e seguem a política de privacidade dele. Não envie senhas, dados pessoais ou informações confidenciais.\nO uso é cobrado na sua conta do provedor. Configure limites de gasto no painel do provedor e revogue a chave na hora se suspeitar de vazamento.\nRespostas de IA podem estar erradas ou inventadas. Confira informações importantes na própria documentação.",
+          aiChatInfoBackBtn: "Voltar ao chat",
           aiChatProviderLabel: "Provedor:",
           aiChatApiKeyLabel: "Chave de API (deixe em branco para IA local):",
-          aiChatProviderOpenAI: "OpenAI (GPT-4o-mini)",
-          aiChatProviderClaude: "Anthropic Claude (Sonnet 4.6)",
-          aiChatProviderGemini: "Google Gemini (2.5 Flash)",
-          aiChatProviderOllama: "Ollama Network (Local LLMs)",
+          aiChatProviderOpenAI: "OpenAI",
+          aiChatProviderClaude: "Anthropic Claude",
+          aiChatProviderGemini: "Google Gemini",
+          aiChatProviderOllama: "Ollama",
           aiChatEmptyPageContent: "Nenhuma página ativa compatível.",
           aiChatNoPageId: "Sem página",
           aiChatOllamaUrlLabel: "URL da API Ollama (deixe em branco para local)",
@@ -128,6 +144,10 @@ export const defaultLangMenu = {
           menuOpen: "Menu",
           menuClose: "Close",
           showMenu: "Show menu",
+          mdCopyLabel: "Copy markdown",
+          mdCopiedLabel: "Copied!",
+          mdCopyErrorLabel: "Could not copy",
+          mdDownloadLabel: "Download .md",
           hideMenu: "Hide menu",
           quickNavigation: "Ctrl+K",
           searchOwnerLabel: "Owner (ex: Vidigal-code)",
@@ -207,12 +227,24 @@ export const defaultLangMenu = {
           aiChatAutoLockDesc: "You have not used the AI for a while. The chat locks and your keys stay encrypted in {seconds}s.",
           aiChatAutoLockConfirmBtn: "OK",
           aiChatAutoLockCancelBtn: "Cancel",
+          aiChatInfoBtn: "How to use and risks",
+          aiChatInfoTitle: "How the AI Assistant works",
+          aiChatInfoIntro: "The assistant answers questions about this documentation using an AI provider you choose (OpenAI, Anthropic Claude, Google Gemini or a local Ollama). This site has no server of its own: your browser talks directly to the provider with your own API key. Read the risks before using it.",
+          aiChatInfoWorksTitle: "How it works",
+          aiChatInfoWorksItems: "Local password: the first time, you create a password. It never leaves this browser and is never stored; it only derives the encryption key (PBKDF2-SHA-256, 210,000 iterations).\nEncrypted vault: your API keys are saved encrypted with AES-256-GCM in this browser's localStorage. Without the password the stored data is unreadable.\nUnlocking: while the chat is unlocked, the password is kept only in this page's memory. The API key itself is not kept decrypted.\nEach question: the key is decrypted at the moment you send, used for that single request and released when the answer ends.\nRequest: the question, the recent conversation and the text of the page you are reading are sent over HTTPS directly to the chosen provider, which streams the answer back.\nLocking: the lock button, or the inactivity timer, removes the password from the page and brings back the password screen. The saved keys stay encrypted.",
+          aiChatInfoHowTitle: "How to use",
+          aiChatInfoHowItems: "Create a local password (at least 4 characters; a long, unique password is safer). Write it down: it cannot be recovered.\nPick the provider and model, then paste your API key. For Ollama, enter the address of your local server (for example http://localhost:11434).\nAsk about the page you are reading; the answer appears in real time. You can attach images to providers that support them.\nWhen you finish, press the lock button. To come back, type the password again.\nHeader buttons: gear changes provider or key; speech bubble clears the conversation; database erases the saved keys; exclamation mark opens this guide.",
+          aiChatInfoFlowTitle: "What can happen",
+          aiChatInfoFlowItems: "Wrong password: the vault does not open and nothing is erased. You can try again as many times as you want.\nForgot the password: \"Reset password\" erases every saved key and the password; then you create a new password and paste the keys again.\nInactivity: after {seconds}s without using the chat, a countdown appears. Cancel keeps the session; otherwise the chat locks and asks for the password.\nTemporary provider error (rate limit, busy or unavailable server): the request is retried automatically up to 3 times. If it keeps failing, a message ending in \"Try again!\" appears.\nInvalid, expired or unfunded key: the provider refuses the request and an authentication error appears. Update the key with the gear button.\nModel retired by the provider: the chat switches automatically to that provider's default model.\nOllama: it must be running on your computer and allow requests from this site (CORS). Otherwise a connection error appears.\nNo internet or a blocking network: the request fails with a connection error; nothing is lost.\nClearing browser data, using a private window or another browser: the vault is not there, so you create a password and paste the key again.",
+          aiChatInfoRisksTitle: "Risks you take",
+          aiChatInfoRisksItems: "The key travels in every request. Anyone using this computer with the developer tools open (Network tab) can see it while you chat. With Google Gemini it goes in the request URL.\nA weak password can be guessed by someone who copies this browser's storage. Use a long password you do not use anywhere else.\nLocking removes the password from the page, but the browser frees that memory only later. Do not use the assistant on shared or public computers.\nBrowser extensions with access to this site can read what the page sees, including the key while it is decrypted. Use a browser profile without unknown extensions.\nYour questions, the conversation and the text of the current page are sent to the chosen provider and fall under its privacy policy. Do not send passwords, personal data or confidential information.\nUsage is billed to your provider account. Set spending limits in the provider's dashboard and revoke the key right away if you suspect a leak.\nAI answers can be wrong or invented. Check important information in the documentation itself.",
+          aiChatInfoBackBtn: "Back to chat",
           aiChatProviderLabel: "Provider:",
           aiChatApiKeyLabel: "API Key (leave blank for Local AI):",
-          aiChatProviderOpenAI: "OpenAI (GPT-4o-mini)",
-          aiChatProviderClaude: "Anthropic Claude (Sonnet 4.6)",
-          aiChatProviderGemini: "Google Gemini (2.5 Flash)",
-          aiChatProviderOllama: "Ollama Network (Local LLMs)",
+          aiChatProviderOpenAI: "OpenAI",
+          aiChatProviderClaude: "Anthropic Claude",
+          aiChatProviderGemini: "Google Gemini",
+          aiChatProviderOllama: "Ollama",
           aiChatEmptyPageContent: "No compatible active page.",
           aiChatNoPageId: "No page",
           aiChatOllamaUrlLabel: "Ollama API URL (leave blank for local)",
@@ -249,6 +281,10 @@ export const defaultLangMenu = {
           menuOpen: "Menu",
           menuClose: "Cerrar",
           showMenu: "Abrir menu",
+          mdCopyLabel: "Copiar Markdown",
+          mdCopiedLabel: "¡Copiado!",
+          mdCopyErrorLabel: "No se pudo copiar",
+          mdDownloadLabel: "Descargar .md",
           hideMenu: "Cerrar menu",
           quickNavigation: "Ctrl+K",
           searchOwnerLabel: "Usuario (ej: Vidigal-code)",
@@ -328,12 +364,24 @@ export const defaultLangMenu = {
           aiChatAutoLockDesc: "No has usado la IA por un tiempo. El chat se bloqueará y tus claves seguirán cifradas en {seconds}s.",
           aiChatAutoLockConfirmBtn: "Guardar",
           aiChatAutoLockCancelBtn: "Cancelar",
+          aiChatInfoBtn: "Cómo usar y riesgos",
+          aiChatInfoTitle: "Cómo funciona el Asistente de IA",
+          aiChatInfoIntro: "El asistente responde preguntas sobre esta documentación usando el proveedor de IA que elijas (OpenAI, Anthropic Claude, Google Gemini o un Ollama local). Este sitio no tiene servidor propio: tu navegador habla directamente con el proveedor usando tu propia clave de API. Lee los riesgos antes de usarlo.",
+          aiChatInfoWorksTitle: "Cómo funciona",
+          aiChatInfoWorksItems: "Contraseña local: la primera vez creas una contraseña. Nunca sale de este navegador y nunca se guarda; solo sirve para derivar la clave de cifrado (PBKDF2-SHA-256, 210.000 iteraciones).\nBóveda cifrada: tus claves de API se guardan cifradas con AES-256-GCM en el localStorage de este navegador. Sin la contraseña, los datos guardados son ilegibles.\nDesbloqueo: mientras el chat está desbloqueado, la contraseña queda solo en la memoria de esta página. La clave de API en sí no se guarda descifrada.\nCada pregunta: la clave se descifra en el momento del envío, se usa solo en esa solicitud y se libera cuando termina la respuesta.\nSolicitud: la pregunta, la conversación reciente y el texto de la página que estás leyendo van por HTTPS directamente al proveedor elegido, que devuelve la respuesta en tiempo real.\nBloqueo: el botón de candado, o el tiempo de inactividad, quita la contraseña de la página y vuelve a la pantalla de contraseña. Las claves guardadas siguen cifradas.",
+          aiChatInfoHowTitle: "Cómo usar",
+          aiChatInfoHowItems: "Crea una contraseña local (mínimo 4 caracteres; una contraseña larga y única es más segura). Anótala: no se puede recuperar.\nElige el proveedor y el modelo y pega tu clave de API. En Ollama, indica la dirección del servidor local (por ejemplo http://localhost:11434).\nPregunta sobre la página que estás leyendo; la respuesta aparece en tiempo real. Puedes adjuntar imágenes en los proveedores que lo admiten.\nAl terminar, pulsa el candado. Para volver, escribe la contraseña de nuevo.\nBotones superiores: engranaje cambia proveedor o clave; globo limpia la conversación; base de datos borra las claves guardadas; signo de exclamación abre esta guía.",
+          aiChatInfoFlowTitle: "Qué puede pasar",
+          aiChatInfoFlowItems: "Contraseña incorrecta: la bóveda no se abre y no se borra nada. Puedes intentarlo cuantas veces quieras.\nOlvidaste la contraseña: \"Restablecer contraseña\" borra todas las claves guardadas y la contraseña; luego creas una contraseña nueva y pegas las claves otra vez.\nInactividad: tras {seconds}s sin usar el chat aparece una cuenta regresiva. Cancelar mantiene la sesión; si no, el chat se bloquea y pide la contraseña.\nError temporal del proveedor (límite de uso, servidor ocupado o caído): la solicitud se repite automáticamente hasta 3 veces. Si sigue fallando, aparece un mensaje que termina en \"¡Inténtalo de nuevo!\".\nClave inválida, vencida o sin saldo: el proveedor rechaza la solicitud y aparece un error de autenticación. Actualiza la clave con el engranaje.\nModelo retirado por el proveedor: el chat cambia solo al modelo predeterminado de ese proveedor.\nOllama: debe estar ejecutándose en tu computadora y aceptar solicitudes de este sitio (CORS). Si no, aparece un error de conexión.\nSin internet o con una red que bloquea al proveedor: la solicitud falla con error de conexión; no se pierde nada.\nBorrar los datos del navegador, usar una ventana privada u otro navegador: la bóveda no existe allí, así que creas una contraseña y pegas la clave otra vez.",
+          aiChatInfoRisksTitle: "Riesgos que corres",
+          aiChatInfoRisksItems: "La clave viaja en cada solicitud. Quien use esta computadora con las herramientas de desarrollador abiertas (pestaña Red) puede verla mientras conversas. En Google Gemini va en la URL de la solicitud.\nUna contraseña débil puede ser descubierta por quien copie el almacenamiento de este navegador. Usa una contraseña larga que no uses en ningún otro lugar.\nEl bloqueo quita la contraseña de la página, pero el navegador libera esa memoria solo después. No uses el asistente en computadoras compartidas o públicas.\nLas extensiones del navegador con acceso a este sitio pueden leer lo que ve la página, incluida la clave mientras está descifrada. Usa un perfil de navegador sin extensiones desconocidas.\nTus preguntas, la conversación y el texto de la página actual se envían al proveedor elegido y quedan sujetos a su política de privacidad. No envíes contraseñas, datos personales ni información confidencial.\nEl uso se cobra en tu cuenta del proveedor. Configura límites de gasto en el panel del proveedor y revoca la clave de inmediato si sospechas una filtración.\nLas respuestas de IA pueden ser incorrectas o inventadas. Verifica la información importante en la propia documentación.",
+          aiChatInfoBackBtn: "Volver al chat",
           aiChatProviderLabel: "Proveedor:",
           aiChatApiKeyLabel: "Clave de API (déjalo en blanco para IA local):",
-          aiChatProviderOpenAI: "OpenAI (GPT-4o-mini)",
-          aiChatProviderClaude: "Anthropic Claude (Sonnet 4.6)",
-          aiChatProviderGemini: "Google Gemini (2.5 Flash)",
-          aiChatProviderOllama: "Ollama Network (Local LLMs)",
+          aiChatProviderOpenAI: "OpenAI",
+          aiChatProviderClaude: "Anthropic Claude",
+          aiChatProviderGemini: "Google Gemini",
+          aiChatProviderOllama: "Ollama",
           aiChatEmptyPageContent: "Ninguna página activa compatible.",
           aiChatNoPageId: "Sin página",
           aiChatOllamaUrlLabel: "URL de la API de Ollama (déjalo en blanco para local)",

package/data/urls.mjs

@@ -1,12 +1,7 @@
-/** 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. */
+/** Official layout URLs: the root `gitpagelayouts/` folder of git-page-docs. */
 
 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,6 +1,6 @@
 {
   "name": "@gitpagedocs/cli",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "CLI that scaffolds and maintains gitpagedocs documentation, generates docs with AI, configures GitHub Pages, and runs the MCP server.",
   "bin": {
     "gitpagedocs": "index.mjs"
@@ -29,8 +29,8 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.5.1",
-    "@gitpagedocs/mcp": "^0.0.2",
-    "@gitpagedocs/tools": "^0.0.2",
+    "@gitpagedocs/mcp": "^0.0.4",
+    "@gitpagedocs/tools": "^0.0.4",
     "tsx": "^4.21.0"
   },
   "repository": {

package/presentation/commands/chat.ts

@@ -219,9 +219,8 @@ function printSetupHelp(providerHint: string): void {
  */
 export async function runChat(ctx: CommandContext): Promise<void> {
   const flags = parseChatArgs(ctx.args);
-  const configRepo = new AiConfigFileRepository({ cwd: ctx.cwd });
+  const configRepo = new AiConfigFileRepository();
   const creds: ResolvedChatCredentials | null = await resolveChatCredentials({
-    cwd: ctx.cwd,
     providerOverride: flags.provider,
     modelOverride: flags.model,
     configRepo,

package/presentation/commands/config-clear.ts

@@ -4,11 +4,11 @@ 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) together with the
- * encrypted key vault, wiping the saved AI credentials, provider and scan paths.
+ * per-user config directory together with the encrypted key vault, wiping the
+ * saved AI credentials, provider and scan paths.
  */
-export async function runConfigClear(ctx: CommandContext): Promise<void> {
-  const repository = new AiConfigFileRepository({ cwd: ctx.cwd });
+export async function runConfigClear(_ctx: CommandContext): Promise<void> {
+  const repository = new AiConfigFileRepository();
   const vault = new AiKeyVault();
   const removed = await repository.clear();
   if (await vault.clear()) removed.push(vault.getVaultPath());

package/presentation/commands/config-info.ts

@@ -1,13 +1,5 @@
 import path from "node:path";
-import { readFile } from "node:fs/promises";
-import {
-  DEFAULT_LANGS_MANIFEST_PATH,
-  defaultConfigLoader,
-  getEnabledLanguages,
-  isAppError,
-  parseLanguageManifest,
-  parseLanguageToggles,
-} from "@gitpagedocs/tools";
+import { defaultConfigLoader, getEnabledLanguages, isAppError, parseLanguageToggles } from "@gitpagedocs/tools";
 import type { CommandContext } from "./run-command";
 
 const UNKNOWN = "—";
@@ -17,19 +9,8 @@ interface LanguageSummary {
   disabled: string[];
 }
 
-/** The 1.1.68 manifest, read only for sites whose config.json predates `site.languages`. */
-async function readLegacyManifestLanguages(cwd: string): Promise<string[]> {
-  try {
-    const manifest = parseLanguageManifest(JSON.parse(await readFile(path.join(cwd, DEFAULT_LANGS_MANIFEST_PATH), "utf-8")));
-    if (manifest) return manifest.languages;
-  } catch {
-    // No manifest: nothing to report.
-  }
-  return [];
-}
-
-/** `site.languages` toggles from config.json, else the legacy inline list, else the legacy manifest. */
-async function summarizeLanguages(cwd: string, site: Record<string, unknown>): Promise<LanguageSummary> {
+/** `site.languages` toggles from config.json, else the resolved `supportedLanguages` list. */
+function summarizeLanguages(site: Record<string, unknown>): LanguageSummary {
   const toggles = parseLanguageToggles(site.languages);
   if (toggles) {
     const enabled = getEnabledLanguages(toggles);
@@ -38,7 +19,7 @@ async function summarizeLanguages(cwd: string, site: Record<string, unknown>): P
   if (Array.isArray(site.supportedLanguages)) {
     return { enabled: site.supportedLanguages as string[], disabled: [] };
   }
-  return { enabled: await readLegacyManifestLanguages(cwd), disabled: [] };
+  return { enabled: [], disabled: [] };
 }
 
 function formatList(languages: string[]): string {
@@ -55,7 +36,7 @@ export async function runConfig(ctx: CommandContext): Promise<void> {
   try {
     const { config, sourcePath, extension } = await defaultConfigLoader.loadGitPageDocsConfig(ctx.cwd);
     const site = (config as { site?: Record<string, unknown> }).site ?? {};
-    const languages = await summarizeLanguages(ctx.cwd, site);
+    const languages = summarizeLanguages(site);
     // eslint-disable-next-line no-console
     console.log(
       `\n  Config: ${path.relative(ctx.cwd, sourcePath)} (${extension})\n` +

package/presentation/index.ts

@@ -4,7 +4,6 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { printBanner, printCredits } from "./ui/banner";
 import { resolveOptions } from "./options/resolver";
-import { migrateLegacyLayoutsInteractive } from "./ui/layouts-prompts";
 import { runNewCommand } from "./commands/run-command";
 import { dispatchMode } from "../application/use-cases/dispatch-mode";
 import type {
@@ -60,12 +59,6 @@ async function main(): Promise<void> {
 
   const options = await resolveOptions(process.argv, process.env);
 
-  // Layouts moved out of <outputDir>/layouts/. Offer to relocate anything left
-  // behind before generating, so the config written next points at one folder.
-  if (options.mode === "config-only") {
-    await migrateLegacyLayoutsInteractive(root, options);
-  }
-
   const configOnlyRuntime = createConfigOnlyRuntime() as ConfigOnlyRuntimePort;
   const homeRuntime = createHomeRuntime() as HomeRuntimePort;
   await dispatchMode(options, params, {

package/presentation/ui/layouts-prompts.ts

@@ -1,27 +1,9 @@
-/**
- * Layout-related prompts: where layouts come from, where they are written, and
- * the opt-in migration away from the legacy `<outputDir>/layouts/` folder.
- */
-import path from "node:path";
-import { askConfirm, askSelect, askText, note } from "./clack";
-import { interactivePromptsAvailable } from "./tty";
-import {
-  DEFAULT_LAYOUTS_DIR,
-  normalizeLayoutsDir,
-  legacyLayoutsDir,
-} from "../../contracts/layouts-paths.mjs";
-import { planLayoutsMigration } from "../../domain/services/layouts-migration.mjs";
-import { listFilesRecursively, executeLayoutsMigration } from "../../runtime/layouts-migrator.mjs";
+/** Layout-related prompts: where layouts come from and where they are written. */
+import { askSelect, askText } from "./clack";
+import { DEFAULT_LAYOUTS_DIR, normalizeLayoutsDir } from "../../contracts/layouts-paths.mjs";
 
 type LayoutsSource = "official" | "local";
 
-/** Outcome of a completed migration, for the caller to report. */
-export interface LayoutsMigrationOutcome {
-  from: string;
-  to: string;
-  movedCount: number;
-}
-
 /** Ask whether layouts come from the official remote source or a local folder. */
 export async function askLayoutsSource(useLocal: boolean): Promise<boolean> {
   const choice = await askSelect<LayoutsSource>(
@@ -52,73 +34,3 @@ export async function askLayoutsDir(current: string): Promise<string> {
   });
   return normalizeLayoutsDir(answer);
 }
-
-function toAbsolute(root: string, repoRelative: string): string {
-  return path.join(root, ...repoRelative.split("/"));
-}
-
-/**
- * Offer to move layouts left behind in the legacy folder.
- *
- * Nothing is moved without an explicit confirmation. Outside a TTY the legacy
- * folder is reported and left alone — the viewer still reads it, so declining
- * (or automating) never breaks an existing site.
- *
- * @returns The outcome when files were moved, otherwise `null`.
- */
-export async function migrateLegacyLayoutsInteractive(
-  root: string,
-  options: { outputDir: string; layoutsDir: string },
-): Promise<LayoutsMigrationOutcome | null> {
-  const from = legacyLayoutsDir(options.outputDir);
-  const to = normalizeLayoutsDir(options.layoutsDir);
-
-  const plan = planLayoutsMigration({
-    outputDir: options.outputDir,
-    layoutsDir: to,
-    legacyFiles: listFilesRecursively(toAbsolute(root, from)),
-    targetFiles: listFilesRecursively(toAbsolute(root, to)),
-  });
-
-  if (!plan.required) return null;
-
-  if (!interactivePromptsAvailable()) {
-    note(
-      `${plan.files.length} layout file(s) still live in ${plan.from}/.\n` +
-        `The viewer still reads them. Run this in a terminal to move them to ${plan.to}/.`,
-      "Legacy layouts",
-    );
-    return null;
-  }
-
-  const overwriteWarning =
-    plan.overwrites.length > 0
-      ? `\n${plan.overwrites.length} file(s) already in ${plan.to}/ would be replaced.`
-      : "";
-  note(
-    `Found ${plan.files.length} layout file(s) in ${plan.from}/.\n` +
-      `Layouts are now generated in ${plan.to}/.${overwriteWarning}`,
-    "Legacy layouts",
-  );
-
-  const confirmed = await askConfirm(
-    `Move them to ${plan.to}/ now?`,
-    plan.overwrites.length === 0,
-  );
-  if (!confirmed) {
-    note(`Left untouched — the viewer still reads ${plan.from}/.`, "Legacy layouts");
-    return null;
-  }
-
-  const result = executeLayoutsMigration(root, plan);
-
-  if (result.failed.length > 0) {
-    note(
-      `${result.failed.length} file(s) could not be moved:\n` +
-        result.failed.map((entry) => `- ${entry.file}: ${entry.reason}`).join("\n"),
-      "Migration incomplete",
-    );
-  }
-
-  return { from: plan.from, to: plan.to, movedCount: result.moved.length };
-}

package/runtime/output.mjs

@@ -1,4 +1,4 @@
-import { existsSync, readdirSync, rmSync } from "node:fs";
+import { existsSync } from "node:fs";
 import { mkdir, writeFile } from "node:fs/promises";
 import path from "node:path";
 import {
@@ -11,6 +11,7 @@ import {
 import { layoutsArtifactPaths } from "../contracts/layouts-paths.mjs";
 import { languageArtifactPaths } from "../contracts/langs-paths.mjs";
 import { SUPPORTED_LANGUAGES } from "../contracts/languages.mjs";
+import { compactSiteIcons, factorRouteDefaults } from "@gitpagedocs/tools/config-format";
 
 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">
@@ -20,28 +21,6 @@ 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 SUPPORTED_LANGUAGES) {
-      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 });
@@ -77,32 +56,17 @@ async function writeLayoutArtifacts(options) {
   }
 }
 
-/**
- * Write one UI-strings bundle per shipped language. Which ones are on is
- * `site.languages` in config.json, so the 1.1.68 `langs.json` manifest is
- * removed: a stale copy would only mislead.
- */
+/** Write one UI-strings bundle per shipped language; `site.languages` in config.json switches them. */
 async function writeLanguageArtifacts(root, outputDir, artifacts) {
   const paths = languageArtifactPaths(outputDir);
-  rmSync(path.join(root, paths.legacyManifest), { force: true });
   for (const [language, bundle] of Object.entries(artifacts.languageBundles)) {
     await writeJson(root, paths.bundle(language), bundle);
   }
 }
 
-/** Keep only versioned docs output in docs/, removing legacy root language folders. */
-function removeLegacyLanguageDirs(root, outputDir) {
-  for (const legacyLanguageDir of SUPPORTED_LANGUAGES) {
-    const legacyPath = path.join(root, outputDir, "docs", legacyLanguageDir);
-    if (existsSync(legacyPath)) {
-      rmSync(legacyPath, { recursive: true, force: true });
-    }
-  }
-}
-
 async function writeVersionConfigs(root, outputDir, versionConfigs) {
   for (const [versionId, versionConfig] of Object.entries(versionConfigs)) {
-    await writeJson(root, `${outputDir}/docs/versions/${versionId}/config.json`, versionConfig);
+    await writeJson(root, `${outputDir}/docs/versions/${versionId}/config.json`, factorRouteDefaults(versionConfig));
   }
 }
 
@@ -180,9 +144,8 @@ export async function writeConfigOnlyOutput(options) {
     createThemeTemplate,
   } = options;
 
-  removeLegacyLanguageDirs(root, outputDir);
-
-  await writeJson(root, `${outputDir}/config.json`, artifacts.rootConfig);
+  // Stored compact: shared icon values and route settings are written once.
+  await writeJson(root, `${outputDir}/config.json`, { ...artifacts.rootConfig, site: compactSiteIcons(artifacts.rootConfig.site) });
   await writeLanguageArtifacts(root, outputDir, artifacts);
   await writeText(root, `${outputDir}/icon.svg`, DEFAULT_ICON_SVG);
   await writeLayoutArtifacts({
@@ -195,7 +158,6 @@ export async function writeConfigOnlyOutput(options) {
   });
   await writeVersionConfigs(root, outputDir, artifacts.versionConfigs);
 
-  removeLegacySourceViewerFiles(root, outputDir);
 
   await writeVersionedDocs(root, outputDir, artifacts);
 }

package/domain/services/layouts-migration.d.mts

@@ -1,15 +0,0 @@
-/** A planned move from the legacy layouts folder to the standalone home. */
-export interface LayoutsMigrationPlan {
-  required: boolean;
-  from: string;
-  to: string;
-  files: string[];
-  overwrites: string[];
-}
-
-export declare function planLayoutsMigration(options: {
-  outputDir: string;
-  layoutsDir: string;
-  legacyFiles?: string[];
-  targetFiles?: string[];
-}): LayoutsMigrationPlan;

package/domain/services/layouts-migration.mjs

@@ -1,74 +0,0 @@
-/**
- * Legacy layouts migration — planning only.
- *
- * Deciding *what* should move is domain logic, so it stays free of prompts and
- * filesystem writes: callers list the two folders, ask the user, and perform
- * the move. That keeps the rule testable with plain arrays.
- */
-import { legacyLayoutsDir, normalizeLayoutsDir } from "../../contracts/layouts-paths.mjs";
-
-/**
- * @typedef {Object} LayoutsMigrationPlan
- * @property {boolean} required     True when the legacy folder holds files to move.
- * @property {string}  from         Repo-relative legacy folder.
- * @property {string}  to           Repo-relative destination folder.
- * @property {string[]} files       Paths relative to `from`, sorted.
- * @property {string[]} overwrites  Subset of `files` already present at `to`.
- */
-
-/**
- * Plan the move from the legacy layouts folder to the standalone home.
- *
- * @param {Object} options
- * @param {string} options.outputDir     Docs output dir (owns the legacy folder).
- * @param {string} options.layoutsDir    Destination layouts folder.
- * @param {string[]} [options.legacyFiles] Paths relative to the legacy folder.
- * @param {string[]} [options.targetFiles] Paths relative to the destination folder.
- * @returns {LayoutsMigrationPlan}
- */
-export function planLayoutsMigration(options = {}) {
-  const { outputDir, layoutsDir, legacyFiles, targetFiles } = options;
-
-  const from = legacyLayoutsDir(outputDir);
-  const to = normalizeLayoutsDir(layoutsDir);
-
-  const files = toSortedPaths(legacyFiles);
-  const present = new Set(toSortedPaths(targetFiles));
-
-  return {
-    required: files.length > 0 && from !== to,
-    from,
-    to,
-    files,
-    overwrites: files.filter((file) => present.has(file)),
-  };
-}
-
-/**
- * Normalize, de-duplicate and sort a list of relative paths so a plan is
- * deterministic regardless of directory-read order.
- *
- * @param {unknown} paths
- * @returns {string[]}
- */
-function toSortedPaths(paths) {
-  if (!Array.isArray(paths)) return [];
-  const normalized = paths
-    .filter((entry) => typeof entry === "string" && entry.trim().length > 0)
-    .map((entry) => entry.replace(/[\\/]+/g, "/").replace(/^\/+/, ""));
-  return [...new Set(normalized)].sort(compareCodeUnits);
-}
-
-/**
- * Plain UTF-16 code-unit order (what `sort()` does by default), spelled out so
- * a plan never depends on the runtime locale.
- *
- * @param {string} a
- * @param {string} b
- * @returns {number}
- */
-function compareCodeUnits(a, b) {
-  if (a < b) return -1;
-  if (a > b) return 1;
-  return 0;
-}

package/runtime/layouts-migrator.d.mts

@@ -1,11 +0,0 @@
-export interface LayoutsMigrationResult {
-  moved: string[];
-  failed: Array<{ file: string; reason: string }>;
-}
-
-export declare function listFilesRecursively(absoluteDir: string): string[];
-
-export declare function executeLayoutsMigration(
-  root: string,
-  plan: { from: string; to: string; files: string[] },
-): LayoutsMigrationResult;

package/runtime/layouts-migrator.mjs

@@ -1,117 +0,0 @@
-/**
- * Filesystem side of the legacy layouts migration.
- *
- * The decision of *what* moves lives in the domain planner; this module only
- * reads directories and performs the move, so both halves stay testable on
- * their own.
- */
-import {
-  existsSync,
-  readdirSync,
-  statSync,
-  mkdirSync,
-  renameSync,
-  copyFileSync,
-  rmSync,
-} from "node:fs";
-import path from "node:path";
-
-/**
- * List every file under a directory, as POSIX paths relative to it.
- *
- * @param {string} absoluteDir
- * @returns {string[]} Empty when the directory is absent or unreadable.
- */
-export function listFilesRecursively(absoluteDir) {
-  if (!absoluteDir || !existsSync(absoluteDir)) return [];
-
-  const found = [];
-  const walk = (currentDir, prefix) => {
-    let entries;
-    try {
-      entries = readdirSync(currentDir);
-    } catch {
-      return;
-    }
-    for (const entry of entries) {
-      const absolute = path.join(currentDir, entry);
-      const relative = prefix ? `${prefix}/${entry}` : entry;
-      let isDirectory = false;
-      try {
-        isDirectory = statSync(absolute).isDirectory();
-      } catch {
-        continue;
-      }
-      if (isDirectory) walk(absolute, relative);
-      else found.push(relative);
-    }
-  };
-
-  walk(absoluteDir, "");
-  return found.sort(compareCodeUnits);
-}
-
-/**
- * Plain UTF-16 code-unit order (what `sort()` does by default), spelled out so
- * the listing never depends on the runtime locale.
- *
- * @param {string} a
- * @param {string} b
- * @returns {number}
- */
-function compareCodeUnits(a, b) {
-  if (a < b) return -1;
-  if (a > b) return 1;
-  return 0;
-}
-
-/**
- * Move one file, falling back to copy + delete when rename is not possible
- * (different volumes, or a locked handle on Windows).
- *
- * @param {string} fromAbsolute
- * @param {string} toAbsolute
- */
-function moveFile(fromAbsolute, toAbsolute) {
-  mkdirSync(path.dirname(toAbsolute), { recursive: true });
-  try {
-    renameSync(fromAbsolute, toAbsolute);
-  } catch {
-    copyFileSync(fromAbsolute, toAbsolute);
-    rmSync(fromAbsolute, { force: true });
-  }
-}
-
-/**
- * Execute a migration plan produced by `planLayoutsMigration`.
- *
- * Files are moved one by one so a single failure is reported without aborting
- * the rest; the legacy folder is removed only once it is genuinely empty.
- *
- * @param {string} root Project root the plan's paths are relative to.
- * @param {{ from: string, to: string, files: string[] }} plan
- * @returns {{ moved: string[], failed: Array<{ file: string, reason: string }> }}
- */
-export function executeLayoutsMigration(root, plan) {
-  const moved = [];
-  const failed = [];
-
-  const fromRoot = path.join(root, ...plan.from.split("/"));
-  const toRoot = path.join(root, ...plan.to.split("/"));
-
-  for (const file of plan.files) {
-    const segments = file.split("/");
-    try {
-      moveFile(path.join(fromRoot, ...segments), path.join(toRoot, ...segments));
-      moved.push(file);
-    } catch (error) {
-      failed.push({ file, reason: error instanceof Error ? error.message : String(error) });
-    }
-  }
-
-  if (failed.length === 0 && listFilesRecursively(fromRoot).length === 0) {
-    rmSync(fromRoot, { recursive: true, force: true });
-  }
-
-  return { moved, failed };
-}