@gitpagedocs/cli 1.1.68 → 1.1.69

package/ai/application/ai-command.ts

@@ -5,7 +5,7 @@
 import { ILLMProvider } from '../core/ports/illm-provider';
 
 export class AiCommandService {
-    constructor(private provider: ILLMProvider) { }
+    constructor(private readonly provider: ILLMProvider) { }
 
     /**
      * Executes the AI Documentation Generation for a specific content

package/ai/application/docs-pattern.ts

@@ -14,21 +14,25 @@ export interface AiDocPage {
   body: string;
 }
 
-const PAGE_DELIMITER = /^===\s*PAGE:\s*(.+?)\s*\|\s*(.*?)\s*===\s*$/;
+// Slug is everything up to the first `|`, title everything up to the closing
+// `===`; both are trimmed by the caller. Kept free of overlapping quantifiers
+// so a hostile line cannot make the match super-linear.
+const PAGE_DELIMITER = /^===\s*PAGE:([^|]*)\|(.*)===\s*$/;
 
 /** Turn an arbitrary heading into a safe lowercase-kebab slug. */
 export function slugify(raw: string): string {
   const slug = (raw ?? "")
     .toLowerCase()
     .normalize("NFKD")
-    .replace(/[^a-z0-9]+/g, "-")
-    .replace(/^-+|-+$/g, "")
+    .split(/[^a-z0-9]+/)
+    .filter(Boolean)
+    .join("-")
     .slice(0, 60);
   return slug || "page";
 }
 
 export function parseAiPages(markdown: string): AiDocPage[] {
-  const text = (markdown ?? "").replace(/\r\n/g, "\n").trim();
+  const text = (markdown ?? "").replaceAll("\r\n", "\n").trim();
   if (!text) return [];
 
   const pages: AiDocPage[] = [];
@@ -41,7 +45,7 @@ export function parseAiPages(markdown: string): AiDocPage[] {
   };
 
   for (const line of text.split("\n")) {
-    const match = line.match(PAGE_DELIMITER);
+    const match = PAGE_DELIMITER.exec(line);
     if (match) {
       flush();
       const rawSlug = match[1].trim();

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

@@ -2,6 +2,7 @@ import { legacyProviderToCatalogId, resolveApiKeyFromEnv } from "@gitpagedocs/to
 import type { AiProviderId } from "@gitpagedocs/tools/ports";
 import { PROVIDER_CATALOG } from "@gitpagedocs/tools";
 import { AiConfigFileRepository } from "../infrastructure/ai-config-file";
+import type { AiCliConfig } from "../core/models/ai-cli-config";
 
 export interface ResolvedChatCredentials {
   readonly providerId: AiProviderId;
@@ -35,12 +36,7 @@ export async function resolveChatCredentials(
   const configRepo = input.configRepo ?? new AiConfigFileRepository({ cwd: input.cwd });
   const stored = await configRepo.read().catch(() => null);
 
-  const providerId = input.providerOverride
-    ? legacyProviderToCatalogId(input.providerOverride)
-    : stored
-      ? legacyProviderToCatalogId(stored.ai.provider)
-      : firstProviderFromEnv(env) ?? "openai";
-
+  const providerId = resolveProviderId(input.providerOverride, stored, env);
   const spec = PROVIDER_CATALOG[providerId];
   const model = input.modelOverride?.trim() || stored?.ai.model?.trim() || spec.defaultModel;
   const baseUrl = stored?.ai.baseUrl?.trim() || undefined;
@@ -52,6 +48,17 @@ export async function resolveChatCredentials(
   return { providerId, model, apiKey, baseUrl };
 }
 
+/** Explicit override > stored config > first provider with an env key > openai. */
+function resolveProviderId(
+  override: string | undefined,
+  stored: AiCliConfig | null,
+  env: Readonly<Record<string, string | undefined>>,
+): AiProviderId {
+  if (override) return legacyProviderToCatalogId(override);
+  if (stored) return legacyProviderToCatalogId(stored.ai.provider);
+  return firstProviderFromEnv(env) ?? "openai";
+}
+
 function firstProviderFromEnv(
   env: Readonly<Record<string, string | undefined>>,
 ): AiProviderId | undefined {

package/ai/core/models/parse-ai-cli-config.ts

@@ -1,8 +1,10 @@
 import { AI_MODEL_DEFAULTS, type AiProviderId } from "../../config";
 import type { AiCliConfig } from "./ai-cli-config";
 
-const SUPPORTED_PROVIDERS = Object.keys(AI_MODEL_DEFAULTS) as AiProviderId[];
-const SUPPORTED_LANGUAGES: ReadonlyArray<AiCliConfig["ai"]["languages"][number]> = ["pt", "en", "es"];
+type SupportedLanguage = AiCliConfig["ai"]["languages"][number];
+
+const SUPPORTED_PROVIDERS: ReadonlySet<string> = new Set(Object.keys(AI_MODEL_DEFAULTS));
+const SUPPORTED_LANGUAGES: ReadonlySet<string> = new Set<SupportedLanguage>(["pt", "en", "es"]);
 
 /** Fallbacks for optional fields, mirroring the interactive prompt defaults. */
 const DEFAULT_LANGUAGES: AiCliConfig["ai"]["languages"] = ["en", "pt", "es"];
@@ -27,17 +29,13 @@ function asPaths(value: unknown): string[] {
 
 function asLanguages(value: unknown): AiCliConfig["ai"]["languages"] {
   const languages = Array.isArray(value)
-    ? value.filter((language): language is AiCliConfig["ai"]["languages"][number] =>
-        SUPPORTED_LANGUAGES.includes(language as AiCliConfig["ai"]["languages"][number]),
-      )
+    ? value.filter((language): language is SupportedLanguage => isString(language) && SUPPORTED_LANGUAGES.has(language))
     : [];
   return languages.length > 0 ? languages : [...DEFAULT_LANGUAGES];
 }
 
 function asProviderId(value: unknown): AiProviderId | null {
-  return isString(value) && SUPPORTED_PROVIDERS.includes(value as AiProviderId)
-    ? (value as AiProviderId)
-    : null;
+  return isString(value) && SUPPORTED_PROVIDERS.has(value) ? (value as AiProviderId) : null;
 }
 
 /**

package/application/home/handler.mjs

@@ -1,6 +1,7 @@
 /** Home distribution use case - static site + auxiliary files */
 
 import { STATIC_OUTPUT_DIR, ARTIFACTS_DIR } from "../../home/constants.mjs";
+import { trimSlashes } from "../../contracts/path-segments.mjs";
 
 /**
  * Execute home distribution use case
@@ -30,7 +31,7 @@ export async function executeHome(params, runtime) {
     runtime.ensureDirEmpty(root, outputDir);
   }
 
-  const pathSegment = basePath ? basePath.replace(/^\/+|\/+$/g, "") : "";
+  const pathSegment = basePath ? trimSlashes(basePath) : "";
   const buildEnv = {
     ...process.env,
     GITHUB_ACTIONS: "true",
@@ -83,3 +84,4 @@ export async function executeHome(params, runtime) {
   runtime.logInfo(`Serve: cd ${cdDir} && npx serve .`);
   runtime.logInfo(`Docker: cd ${cdDir} && docker build -t gitpagedocshome . && docker run -p 3000:80 gitpagedocshome`);
 }
+

package/application/ports/cli-runtime-ports.ts

@@ -16,6 +16,8 @@ export interface LayoutDefinition {
 
 export interface BuiltConfigArtifacts {
   rootConfig: unknown;
+  /** UI-string bundle per language, written to `<outputDir>/langs/<lang>.json`. */
+  languageBundles: Record<string, unknown>;
   layoutsConfig: unknown;
   fallbackLayoutsConfig: unknown;
   docs?: Record<string, Record<string, string>>;

package/application/report/config-only-reporter.mjs

@@ -8,7 +8,7 @@ export function reportConfigOnlySuccess(options) {
   const langs = languageArtifactPaths(options.outputDir);
   return [
     `Generated: ${options.outputDir}/ (config-only)`,
-    `UI strings: ${langs.manifest} + ${langs.dir}/{${SUPPORTED_LANGUAGES.join(",")}}.json`,
+    `UI strings: ${langs.dir}/{${SUPPORTED_LANGUAGES.join(",")}}.json (enable/disable each language in ${langs.config} -> site.languages)`,
     "No index.html/index.js generated.",
   ];
 }
@@ -51,10 +51,7 @@ export function reportPrebuiltDetected() {
 }
 
 export function reportAll(options, prebuiltDetected) {
-  const lines = [];
-  lines.push(...reportConfigOnlySuccess(options));
-  lines.push(...reportLayoutConfig(options));
-  lines.push(...reportRenderingUrl(options));
+  const lines = [...reportConfigOnlySuccess(options), ...reportLayoutConfig(options), ...reportRenderingUrl(options)];
   if (options.shouldPush) {
     lines.push(...reportPushMode());
   }

package/builders/config-orchestrator.mjs

@@ -9,14 +9,12 @@ import { buildLanguageArtifacts } from "./language-bundles-builder.mjs";
 
 /**
  * Build all config artifacts (root, languages, layouts, versions, docs).
- * @param {object} options - { useLocalLayoutConfig, githubOwner, githubRepo, root }
- * @returns {object} { rootConfig, languageManifest, languageBundles, layoutsConfig, fallbackLayoutsConfig, docs, docsHtml, versionConfigs }
+ * @param {object} options - { useLocalLayoutConfig, githubOwner, githubRepo, layoutsDir }
+ * @returns {object} { rootConfig, languageBundles, layoutsConfig, fallbackLayoutsConfig, docs, docsHtml, versionConfigs }
  */
 export function buildConfigArtifacts(options = {}) {
-  const root = options.root ?? process.cwd();
-
-  const rootConfig = buildRootConfig(options);
-  const { languageManifest, languageBundles } = buildLanguageArtifacts();
+  const { languageToggles, languageBundles } = buildLanguageArtifacts();
+  const rootConfig = buildRootConfig({ ...options, languageToggles });
   const layoutsConfig = { layouts: LAYOUTS };
   const fallbackLayoutsConfig = { layouts: FALLBACK_LAYOUTS };
 
@@ -27,7 +25,6 @@ export function buildConfigArtifacts(options = {}) {
 
   return {
     rootConfig,
-    languageManifest,
     languageBundles,
     layoutsConfig,
     fallbackLayoutsConfig,

package/builders/language-bundles-builder.mjs

@@ -1,5 +1,5 @@
-/** Build the language manifest + per-language UI string bundles for gitpagedocs */
-import { buildLanguageManifest, splitLanguageBundles } from "@gitpagedocs/tools/i18n";
+/** Build the `site.languages` toggles + per-language UI string bundles for gitpagedocs */
+import { buildLanguageToggles, splitLanguageBundles } from "@gitpagedocs/tools/i18n";
 import { SUPPORTED_LANGUAGES } from "../contracts/languages.mjs";
 import { defaultLangMenu } from "../data/i18n-langmenu.mjs";
 import { defaultTranslations } from "../data/i18n-translations.mjs";
@@ -12,13 +12,13 @@ function assertLanguageStrings(languages) {
 }
 
 /**
- * @returns {{ languageManifest: { languages: string[] }, languageBundles: Record<string, object> }}
+ * @returns {{ languageToggles: Record<string, boolean>, languageBundles: Record<string, object> }}
  */
 export function buildLanguageArtifacts() {
   const languages = [...SUPPORTED_LANGUAGES];
   assertLanguageStrings(languages);
   return {
-    languageManifest: buildLanguageManifest(languages),
+    languageToggles: buildLanguageToggles(languages),
     languageBundles: splitLanguageBundles(languages, defaultLangMenu, defaultTranslations),
   };
 }

package/builders/root-config-builder.mjs

@@ -34,7 +34,7 @@ export function buildRootConfig(options = {}) {
     "source-viewer-path": sourceViewerPath,
   }));
 
-  const baseSiteConfig = getDefaultSiteConfig(projectLink);
+  const baseSiteConfig = getDefaultSiteConfig(projectLink, options.languageToggles);
 
   return {
     site: {

package/content/docs-en.mjs

@@ -175,7 +175,7 @@ The version config can render a **Source code** container through \`routes-sourc
 - \`name\`, \`defaultLanguage\`
 - \`docsVersion\`, \`rendering\`, \`ThemeDefault\`, \`ThemeModeDefault\`
 - \`ProjectLink\`, \`layoutsConfigPathOficial\`, \`layoutsConfigPath\`
-- Languages and UI strings: \`gitpagedocs/langs.json\` + \`gitpagedocs/langs/<lang>.json\`
+- Languages: \`site.languages\` (enable/disable each one); UI strings: \`gitpagedocs/langs/<lang>.json\`
 
 ## Environment variables
 
@@ -319,11 +319,11 @@ Supported adapters:
 
 Runtime configuration lives in \`gitpagedocs/config.json\`. UI text lives next to it, one file per language.
 
-## Languages (\`langs.json\` + \`langs/\`)
+## Languages (\`site.languages\` + \`langs/\`)
 
-- \`gitpagedocs/langs.json\` lists the shipped languages in menu order: \`{ "languages": ["en", "pt", "es"] }\`.
+- \`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 append its code to \`langs.json\`.
+- 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.
 - 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

package/content/docs-es.mjs

@@ -159,7 +159,7 @@ El config de version puede renderizar un contenedor **Codigo fuente** via \`rout
 - \`name\`, \`defaultLanguage\`
 - \`docsVersion\`, \`rendering\`, \`ThemeDefault\`, \`ThemeModeDefault\`
 - \`ProjectLink\`, \`layoutsConfigPathOficial\`, \`layoutsConfigPath\`
-- Idiomas y textos de la UI: \`gitpagedocs/langs.json\` + \`gitpagedocs/langs/<lang>.json\`
+- Idiomas: \`site.languages\` (activa/desactiva cada uno); textos de la UI: \`gitpagedocs/langs/<lang>.json\`
 
 ## Variables de entorno
 
@@ -170,11 +170,11 @@ El config de version puede renderizar un contenedor **Codigo fuente** via \`rout
 
 La configuracion de runtime esta en \`gitpagedocs/config.json\`. Los textos de la UI viven al lado, un archivo por idioma.
 
-## Idiomas (\`langs.json\` + \`langs/\`)
+## Idiomas (\`site.languages\` + \`langs/\`)
 
-- \`gitpagedocs/langs.json\` lista los idiomas disponibles en el orden del menu: \`{ "languages": ["en", "pt", "es"] }\`.
+- \`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 su codigo a \`langs.json\`.
+- 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.
 - 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\`

package/content/docs-pt.mjs

@@ -159,7 +159,7 @@ O config da versao pode renderizar um container **Codigo fonte** via \`routes-so
 - \`name\`, \`defaultLanguage\`
 - \`docsVersion\`, \`rendering\`, \`ThemeDefault\`, \`ThemeModeDefault\`
 - \`ProjectLink\`, \`layoutsConfigPathOficial\`, \`layoutsConfigPath\`
-- Idiomas e textos da UI: \`gitpagedocs/langs.json\` + \`gitpagedocs/langs/<lang>.json\`
+- Idiomas: \`site.languages\` (liga/desliga cada um); textos da UI: \`gitpagedocs/langs/<lang>.json\`
 
 ## Variaveis de ambiente
 
@@ -170,11 +170,11 @@ O config da versao pode renderizar um container **Codigo fonte** via \`routes-so
 
 A configuracao de runtime fica em \`gitpagedocs/config.json\`. Os textos da UI ficam ao lado, um arquivo por idioma.
 
-## Idiomas (\`langs.json\` + \`langs/\`)
+## Idiomas (\`site.languages\` + \`langs/\`)
 
-- \`gitpagedocs/langs.json\` lista os idiomas disponiveis na ordem do menu: \`{ "languages": ["en", "pt", "es"] }\`.
+- \`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 o codigo em \`langs.json\`.
+- 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.
 - 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\`

package/contracts/doc-versions.mjs

@@ -1,3 +1,3 @@
-export const PACKAGE_VERSION = "1.1.68";
+export const PACKAGE_VERSION = "1.1.69";
 
 export const DOC_VERSIONS = [PACKAGE_VERSION];

package/contracts/langs-paths.mjs

@@ -1,11 +1,13 @@
 /**
  * Canonical locations for the language artifacts inside the docs output dir:
  *
- *   <outputDir>/langs.json         manifest listing the shipped languages
+ *   <outputDir>/config.json        `site.languages` — enable (true) / disable (false) each language
  *   <outputDir>/langs/<lang>.json  UI strings (langmenu + translations) of one language
  *
- * The file names come from @gitpagedocs/tools so the generator and the viewer
- * never disagree about where the bundles live.
+ * `<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.
  */
 import { LANGS_DIRNAME, LANGS_MANIFEST_FILENAME } from "@gitpagedocs/tools/i18n";
 
@@ -13,12 +15,13 @@ import { LANGS_DIRNAME, LANGS_MANIFEST_FILENAME } 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 {{ manifest: string, dir: string, bundle: (language: string) => string }}
+ * @returns {{ config: string, legacyManifest: string, dir: string, bundle: (language: string) => string }}
  */
 export function languageArtifactPaths(outputDir) {
   const dir = `${outputDir}/${LANGS_DIRNAME}`;
   return {
-    manifest: `${outputDir}/${LANGS_MANIFEST_FILENAME}`,
+    config: `${outputDir}/config.json`,
+    legacyManifest: `${outputDir}/${LANGS_MANIFEST_FILENAME}`,
     dir,
     bundle: (language) => `${dir}/${language}.json`,
   };

package/contracts/layouts-paths.mjs

@@ -1,3 +1,5 @@
+import { trimSlashes } from "./path-segments.mjs";
+
 /**
  * Canonical locations for layout artifacts.
  *
@@ -34,10 +36,8 @@ export const LEGACY_LAYOUTS_SUBDIR = "layouts";
  * @returns {string} Normalized path, or `DEFAULT_LAYOUTS_DIR` when empty.
  */
 export function normalizeLayoutsDir(dir) {
-  const normalized = String(dir ?? "")
-    .replace(/[\\/]+/g, "/")
-    .replace(/^\/+|\/+$/g, "")
-    .trim();
+  const collapsed = String(dir ?? "").replace(/[\\/]+/g, "/");
+  const normalized = trimSlashes(collapsed).trim();
   return normalized || DEFAULT_LAYOUTS_DIR;
 }
 

package/contracts/path-segments.d.mts

@@ -0,0 +1,2 @@
+/** Strip every leading and trailing `/` from a path segment. */
+export function trimSlashes(value: string): string;

package/contracts/path-segments.mjs

@@ -0,0 +1,15 @@
+/**
+ * Strip every leading and trailing `/` from a user-supplied path segment in a
+ * single forward/backward scan. Same result as `.replace(/^\/+|\/+$/g, "")`
+ * without the super-linear backtracking that regex incurs on long slash runs.
+ *
+ * @param {string} value Raw segment such as "/docs/" or "///".
+ * @returns {string} The segment without surrounding slashes ("" when only slashes).
+ */
+export function trimSlashes(value) {
+  let start = 0;
+  let end = value.length;
+  while (start < end && value[start] === "/") start += 1;
+  while (end > start && value[end - 1] === "/") end -= 1;
+  return value.slice(start, end);
+}

package/data/default-site-config.mjs

@@ -1,8 +1,15 @@
-/** Site chrome defaults. The language list and UI strings live in langs.json + langs/. */
-export function getDefaultSiteConfig(projectLink) {
+/**
+ * Site chrome defaults. `languages` enables (true) / disables (false) each
+ * language; the UI strings themselves live in langs/<lang>.json.
+ */
+import { buildLanguageToggles } from "@gitpagedocs/tools/i18n";
+import { SUPPORTED_LANGUAGES } from "../contracts/languages.mjs";
+
+export function getDefaultSiteConfig(projectLink, languageToggles = buildLanguageToggles(SUPPORTED_LANGUAGES)) {
     return {
         name: "Git Pages Docs",
         defaultLanguage: "en",
+        languages: { ...languageToggles },
         HideThemeSelector: false,
         ThemeDefault: "aurora-dark",
         ThemeModeDefault: "dark",

package/domain/services/layouts-migration.mjs

@@ -56,5 +56,19 @@ function toSortedPaths(paths) {
   const normalized = paths
     .filter((entry) => typeof entry === "string" && entry.trim().length > 0)
     .map((entry) => entry.replace(/[\\/]+/g, "/").replace(/^\/+/, ""));
-  return [...new Set(normalized)].sort();
+  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/home/home-file-writer.mjs

@@ -1,8 +1,7 @@
 /** Write .env, Dockerfile, README to home output directory */
 
 import path from "node:path";
-import { mkdir } from "node:fs/promises";
-import { writeFile } from "node:fs/promises";
+import { mkdir, writeFile } from "node:fs/promises";
 import { getEnvTemplate, getDockerfileTemplate, getReadmeTemplate } from "./templates.mjs";
 
 /**
@@ -16,5 +15,5 @@ export async function writeHomeFiles(root, outputDir, opts = {}) {
 
   await writeFile(path.join(basePath, ".env"), getEnvTemplate(opts), "utf-8");
   await writeFile(path.join(basePath, "Dockerfile"), getDockerfileTemplate(), "utf-8");
-  await writeFile(path.join(basePath, "README.md"), getReadmeTemplate({ outputDir }), "utf-8");
+  await writeFile(path.join(basePath, "README.md"), getReadmeTemplate(), "utf-8");
 }

package/home/templates.mjs

@@ -22,8 +22,11 @@ CMD ["nginx", "-g", "daemon off;"]
 `;
 }
 
-export function getReadmeTemplate({ outputDir = "gitpagedocshome" }) {
-  const cdDir = outputDir === "." || outputDir === "./" ? "." : outputDir;
+/**
+ * README shipped next to the static export. Every command runs from the
+ * folder the file lives in, so it never needs to know the output dir name.
+ */
+export function getReadmeTemplate() {
   return `# GitPageDocs Home
 
 Pre-built GitPageDocs static site by Vidigal-code.

package/infrastructure/home/runtime.mjs

@@ -1,6 +1,6 @@
 import path from "node:path";
 import { cpSync, existsSync, readdirSync, rmSync } from "node:fs";
-import { execSync } from "node:child_process";
+import { runExecutable } from "../../runtime/exec.mjs";
 import { writeConfigOnlyOutput, writeText } from "../../runtime/output.mjs";
 import { writeHomeFiles } from "../../home/home-file-writer.mjs";
 import { logInfo, logSuccess } from "../../ui/logger.mjs";
@@ -17,7 +17,7 @@ function copyRecursive(src, dest) {
 }
 
 function runNextBuild(root, env) {
-  execSync("npx next build frontend", { cwd: root, env, stdio: "inherit" });
+  runExecutable("npx", ["next", "build", "frontend"], { cwd: root, env, stdio: "inherit" });
 }
 
 export function createHomeRuntime() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gitpagedocs/cli",
-  "version": "1.1.68",
+  "version": "1.1.69",
   "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": "^1.1.68",
-    "@gitpagedocs/tools": "^1.1.68",
+    "@gitpagedocs/mcp": "^1.1.69",
+    "@gitpagedocs/tools": "^1.1.69",
     "tsx": "^4.21.0"
   },
   "repository": {

package/presentation/commands/config-info.ts

@@ -1,19 +1,53 @@
 import path from "node:path";
 import { readFile } from "node:fs/promises";
-import { DEFAULT_LANGS_MANIFEST_PATH, defaultConfigLoader, isAppError, parseLanguageManifest } from "@gitpagedocs/tools";
+import {
+  DEFAULT_LANGS_MANIFEST_PATH,
+  defaultConfigLoader,
+  getEnabledLanguages,
+  isAppError,
+  parseLanguageManifest,
+  parseLanguageToggles,
+} from "@gitpagedocs/tools";
 import type { CommandContext } from "./run-command";
 
 const UNKNOWN = "—";
 
-/** Languages from `gitpagedocs/langs.json`, else the legacy inline `site.supportedLanguages`. */
-async function resolveLanguages(cwd: string, site: Record<string, unknown>): Promise<string[]> {
+interface LanguageSummary {
+  enabled: string[];
+  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: fall back to the inline list below.
+    // 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> {
+  const toggles = parseLanguageToggles(site.languages);
+  if (toggles) {
+    const enabled = getEnabledLanguages(toggles);
+    return { enabled, disabled: Object.keys(toggles).filter((language) => !enabled.includes(language)) };
   }
-  return Array.isArray(site.supportedLanguages) ? (site.supportedLanguages as string[]) : [];
+  if (Array.isArray(site.supportedLanguages)) {
+    return { enabled: site.supportedLanguages as string[], disabled: [] };
+  }
+  return { enabled: await readLegacyManifestLanguages(cwd), disabled: [] };
+}
+
+function formatList(languages: string[]): string {
+  return languages.length > 0 ? languages.join(", ") : UNKNOWN;
+}
+
+/** Scalars print as-is; anything else (missing, object) prints as unknown instead of "[object Object]". */
+function formatScalar(value: unknown): string {
+  return typeof value === "string" || typeof value === "number" || typeof value === "boolean" ? String(value) : UNKNOWN;
 }
 
 /** `gitpagedocs config` — resolve and summarize the active gitpagedocs config. */
@@ -21,13 +55,14 @@ 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 resolveLanguages(ctx.cwd, site);
+    const languages = await summarizeLanguages(ctx.cwd, site);
     // eslint-disable-next-line no-console
     console.log(
       `\n  Config: ${path.relative(ctx.cwd, sourcePath)} (${extension})\n` +
-        `    site name        : ${String(site.name ?? UNKNOWN)}\n` +
-        `    default language : ${String(site.defaultLanguage ?? UNKNOWN)}\n` +
-        `    languages        : ${languages.length > 0 ? languages.join(", ") : UNKNOWN}\n`,
+        `    site name        : ${formatScalar(site.name)}\n` +
+        `    default language : ${formatScalar(site.defaultLanguage)}\n` +
+        `    languages        : ${formatList(languages.enabled)}\n` +
+        `    disabled         : ${formatList(languages.disabled)}\n`,
     );
   } catch (error) {
     const message = isAppError(error) ? error.message : String(error);