@gitpagedocs/cli 1.1.62 → 1.1.63

package/data/urls.mjs

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

package/domain/models/cli-options.ts

@@ -1,33 +1,33 @@
-export type CliMode = "home" | "full" | "config-only" | "ai";
-
-/**
- * Values the user supplied explicitly on the command line. Interactive mode
- * only asks for what is missing, so an explicit flag is never re-asked.
- */
-export interface CliExplicitFlags {
-  useLocalLayoutConfig: boolean;
-  layoutsDir: boolean;
-  githubOwner: boolean;
-  githubRepo: boolean;
-  outputDir: boolean;
-}
-
-export interface CliOptions {
-  isBuild: boolean;
-  isServe: boolean;
-  mode: CliMode;
-  aiCommand?: string;
-  outputDir: string;
-  /** Standalone layouts home (repo-relative); local layouts are generated here. */
-  layoutsDir: string;
-  useLocalLayoutConfig: boolean;
-  shouldPush: boolean;
-  githubOwner: string;
-  githubRepo: string;
-  docsPath: string;
-  basePath: string;
-  repositorySearch?: boolean;
-  isInteractive: boolean;
-  hasArgs: boolean;
-  explicit: CliExplicitFlags;
-}
+export type CliMode = "home" | "full" | "config-only" | "ai";
+
+/**
+ * Values the user supplied explicitly on the command line. Interactive mode
+ * only asks for what is missing, so an explicit flag is never re-asked.
+ */
+export interface CliExplicitFlags {
+  useLocalLayoutConfig: boolean;
+  layoutsDir: boolean;
+  githubOwner: boolean;
+  githubRepo: boolean;
+  outputDir: boolean;
+}
+
+export interface CliOptions {
+  isBuild: boolean;
+  isServe: boolean;
+  mode: CliMode;
+  aiCommand?: string;
+  outputDir: string;
+  /** Standalone layouts home (repo-relative); local layouts are generated here. */
+  layoutsDir: string;
+  useLocalLayoutConfig: boolean;
+  shouldPush: boolean;
+  githubOwner: string;
+  githubRepo: string;
+  docsPath: string;
+  basePath: string;
+  repositorySearch?: boolean;
+  isInteractive: boolean;
+  hasArgs: boolean;
+  explicit: CliExplicitFlags;
+}

package/home/constants.mjs

@@ -1,4 +1,4 @@
-/** Constants for home distribution */
-
-export const STATIC_OUTPUT_DIR = "frontend/out";
-export const ARTIFACTS_DIR = "gitpagedocs";
+/** Constants for home distribution */
+
+export const STATIC_OUTPUT_DIR = "frontend/out";
+export const ARTIFACTS_DIR = "gitpagedocs";

package/index.mjs

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

package/infrastructure/gitpagedocs-config-file.ts

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

package/infrastructure/home/runtime.mjs

@@ -1,37 +1,37 @@
-import path from "node:path";
-import { cpSync, existsSync, readdirSync, rmSync } from "node:fs";
-import { execSync } from "node:child_process";
-import { writeConfigOnlyOutput, writeText } from "../../runtime/output.mjs";
-import { writeHomeFiles } from "../../home/home-file-writer.mjs";
-import { logInfo, logSuccess } from "../../ui/logger.mjs";
-
-function ensureDirEmpty(root, relativeDir) {
-  const target = path.join(root, relativeDir);
-  if (existsSync(target)) {
-    rmSync(target, { recursive: true, force: true });
-  }
-}
-
-function copyRecursive(src, dest) {
-  cpSync(src, dest, { recursive: true, force: true });
-}
-
-function runNextBuild(root, env) {
-  execSync("npx next build frontend", { cwd: root, env, stdio: "inherit" });
-}
-
-export function createHomeRuntime() {
-  return {
-    joinPath: (...parts) => path.join(...parts),
-    ensureDirEmpty,
-    copyRecursive,
-    readDirNames: (absolutePath) => readdirSync(absolutePath),
-    existsPath: existsSync,
-    runNextBuild,
-    writeConfigOnlyOutput,
-    writeHomeFiles,
-    writeText,
-    logSuccess,
-    logInfo,
-  };
-}
+import path from "node:path";
+import { cpSync, existsSync, readdirSync, rmSync } from "node:fs";
+import { execSync } from "node:child_process";
+import { writeConfigOnlyOutput, writeText } from "../../runtime/output.mjs";
+import { writeHomeFiles } from "../../home/home-file-writer.mjs";
+import { logInfo, logSuccess } from "../../ui/logger.mjs";
+
+function ensureDirEmpty(root, relativeDir) {
+  const target = path.join(root, relativeDir);
+  if (existsSync(target)) {
+    rmSync(target, { recursive: true, force: true });
+  }
+}
+
+function copyRecursive(src, dest) {
+  cpSync(src, dest, { recursive: true, force: true });
+}
+
+function runNextBuild(root, env) {
+  execSync("npx next build frontend", { cwd: root, env, stdio: "inherit" });
+}
+
+export function createHomeRuntime() {
+  return {
+    joinPath: (...parts) => path.join(...parts),
+    ensureDirEmpty,
+    copyRecursive,
+    readDirNames: (absolutePath) => readdirSync(absolutePath),
+    existsPath: existsSync,
+    runNextBuild,
+    writeConfigOnlyOutput,
+    writeHomeFiles,
+    writeText,
+    logSuccess,
+    logInfo,
+  };
+}

package/package.json

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

package/presentation/commands/ai-info.ts

@@ -1,57 +1,57 @@
-import { PROVIDER_CATALOG, ALL_PROVIDER_IDS, createModelRegistry, type AiProviderId } from "@gitpagedocs/tools";
-import type { CommandContext } from "./run-command";
-
-function capsLabel(caps: { streaming: boolean; vision: boolean; audio: boolean }): string {
-  const parts: string[] = [];
-  if (caps.streaming) parts.push("stream");
-  if (caps.vision) parts.push("vision");
-  if (caps.audio) parts.push("audio");
-  return parts.join(", ") || "text";
-}
-
-/** `gitpagedocs provider [id]` — list providers or show one provider's detail. */
-export async function runProvider(ctx: CommandContext): Promise<void> {
-  const requested = ctx.args[1] as AiProviderId | undefined;
-  if (requested && PROVIDER_CATALOG[requested]) {
-    const spec = PROVIDER_CATALOG[requested];
-    // eslint-disable-next-line no-console
-    console.log(
-      `\n  ${spec.label} (${spec.id})\n` +
-        `    default model : ${spec.defaultModel}\n` +
-        `    capabilities  : ${capsLabel(spec.capabilities)}\n` +
-        `    base url      : ${spec.baseUrl || "(user-provided)"}\n` +
-        `    models        : ${spec.models.map((m) => m.id).join(", ")}\n`,
-    );
-    return;
-  }
-
-  // eslint-disable-next-line no-console
-  console.log(`\n  AI providers (${ALL_PROVIDER_IDS.length}):\n`);
-  for (const id of ALL_PROVIDER_IDS) {
-    const spec = PROVIDER_CATALOG[id];
-    // eslint-disable-next-line no-console
-    console.log(`  ${id.padEnd(14)} ${spec.label.padEnd(18)} ${spec.defaultModel}`);
-  }
-  // eslint-disable-next-line no-console
-  console.log("\n  Detail: gitpagedocs provider <id>\n");
-}
-
-/** `gitpagedocs models [provider]` — list models for one or all providers. */
-export async function runModels(ctx: CommandContext): Promise<void> {
-  const models = createModelRegistry();
-  const requested = ctx.args[1] as AiProviderId | undefined;
-  const ids = requested && PROVIDER_CATALOG[requested] ? [requested] : ALL_PROVIDER_IDS;
-  // eslint-disable-next-line no-console
-  console.log("");
-  for (const id of ids) {
-    const list = models.list(id);
-    // eslint-disable-next-line no-console
-    console.log(`  ${PROVIDER_CATALOG[id].label} (${id}):`);
-    for (const m of list) {
-      // eslint-disable-next-line no-console
-      console.log(`    - ${m.id}${m.id === PROVIDER_CATALOG[id].defaultModel ? "  (default)" : ""}`);
-    }
-  }
-  // eslint-disable-next-line no-console
-  console.log("");
-}
+import { PROVIDER_CATALOG, ALL_PROVIDER_IDS, createModelRegistry, type AiProviderId } from "@gitpagedocs/tools";
+import type { CommandContext } from "./run-command";
+
+function capsLabel(caps: { streaming: boolean; vision: boolean; audio: boolean }): string {
+  const parts: string[] = [];
+  if (caps.streaming) parts.push("stream");
+  if (caps.vision) parts.push("vision");
+  if (caps.audio) parts.push("audio");
+  return parts.join(", ") || "text";
+}
+
+/** `gitpagedocs provider [id]` — list providers or show one provider's detail. */
+export async function runProvider(ctx: CommandContext): Promise<void> {
+  const requested = ctx.args[1] as AiProviderId | undefined;
+  if (requested && PROVIDER_CATALOG[requested]) {
+    const spec = PROVIDER_CATALOG[requested];
+    // eslint-disable-next-line no-console
+    console.log(
+      `\n  ${spec.label} (${spec.id})\n` +
+        `    default model : ${spec.defaultModel}\n` +
+        `    capabilities  : ${capsLabel(spec.capabilities)}\n` +
+        `    base url      : ${spec.baseUrl || "(user-provided)"}\n` +
+        `    models        : ${spec.models.map((m) => m.id).join(", ")}\n`,
+    );
+    return;
+  }
+
+  // eslint-disable-next-line no-console
+  console.log(`\n  AI providers (${ALL_PROVIDER_IDS.length}):\n`);
+  for (const id of ALL_PROVIDER_IDS) {
+    const spec = PROVIDER_CATALOG[id];
+    // eslint-disable-next-line no-console
+    console.log(`  ${id.padEnd(14)} ${spec.label.padEnd(18)} ${spec.defaultModel}`);
+  }
+  // eslint-disable-next-line no-console
+  console.log("\n  Detail: gitpagedocs provider <id>\n");
+}
+
+/** `gitpagedocs models [provider]` — list models for one or all providers. */
+export async function runModels(ctx: CommandContext): Promise<void> {
+  const models = createModelRegistry();
+  const requested = ctx.args[1] as AiProviderId | undefined;
+  const ids = requested && PROVIDER_CATALOG[requested] ? [requested] : ALL_PROVIDER_IDS;
+  // eslint-disable-next-line no-console
+  console.log("");
+  for (const id of ids) {
+    const list = models.list(id);
+    // eslint-disable-next-line no-console
+    console.log(`  ${PROVIDER_CATALOG[id].label} (${id}):`);
+    for (const m of list) {
+      // eslint-disable-next-line no-console
+      console.log(`    - ${m.id}${m.id === PROVIDER_CATALOG[id].defaultModel ? "  (default)" : ""}`);
+    }
+  }
+  // eslint-disable-next-line no-console
+  console.log("");
+}

package/presentation/commands/config-clear.ts

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

package/presentation/commands/config-info.ts

@@ -1,24 +1,24 @@
-import path from "node:path";
-import { defaultConfigLoader, isAppError } from "@gitpagedocs/tools";
-import type { CommandContext } from "./run-command";
-
-/** `gitpagedocs config` — resolve and summarize the active gitpagedocs config. */
-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 ?? {};
-    // eslint-disable-next-line no-console
-    console.log(
-      `\n  Config: ${path.relative(ctx.cwd, sourcePath)} (${extension})\n` +
-        `    site name        : ${String(site.name ?? "—")}\n` +
-        `    default language : ${String(site.defaultLanguage ?? "—")}\n` +
-        `    languages        : ${
-          Array.isArray(site.supportedLanguages) ? (site.supportedLanguages as string[]).join(", ") : "—"
-        }\n`,
-    );
-  } catch (error) {
-    const message = isAppError(error) ? error.message : String(error);
-    // eslint-disable-next-line no-console
-    console.log(`\n  No usable config found: ${message}\n  Run \`gitpagedocs init\` to generate one.\n`);
-  }
-}
+import path from "node:path";
+import { defaultConfigLoader, isAppError } from "@gitpagedocs/tools";
+import type { CommandContext } from "./run-command";
+
+/** `gitpagedocs config` — resolve and summarize the active gitpagedocs config. */
+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 ?? {};
+    // eslint-disable-next-line no-console
+    console.log(
+      `\n  Config: ${path.relative(ctx.cwd, sourcePath)} (${extension})\n` +
+        `    site name        : ${String(site.name ?? "—")}\n` +
+        `    default language : ${String(site.defaultLanguage ?? "—")}\n` +
+        `    languages        : ${
+          Array.isArray(site.supportedLanguages) ? (site.supportedLanguages as string[]).join(", ") : "—"
+        }\n`,
+    );
+  } catch (error) {
+    const message = isAppError(error) ? error.message : String(error);
+    // eslint-disable-next-line no-console
+    console.log(`\n  No usable config found: ${message}\n  Run \`gitpagedocs init\` to generate one.\n`);
+  }
+}