@gitpagedocs/cli 1.1.62 → 1.1.63

package/presentation/commands/password.ts

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

package/presentation/commands/run-command.ts

@@ -1,70 +1,70 @@
-/**
- * New-verb command layer (Phase 6). Intercepts the informational/utility
- * commands that are NOT part of the legacy flag flow (version, doctor, provider,
- * models, config, mcp, update) and routes them to thin handlers that consume
- * @gitpagedocs/tools. Alias verbs (init, document, deploy, pages) are mapped in
- * the parser and fall through to the legacy dispatch, so this returns false for
- * them.
- */
-export interface CommandContext {
-  argv: string[];
-  args: string[];
-  pkgRoot: string;
-  cwd: string;
-}
-
-export type CommandHandler = (ctx: CommandContext) => Promise<void>;
-
-import { runVersion, runDoctor, runUpdate } from "./diagnostics";
-import { runProvider, runModels } from "./ai-info";
-import { runConfig } from "./config-info";
-import { runConfigClear } from "./config-clear";
-import { runMcp } from "./mcp";
-import { runDocs } from "./docs";
-import { runPagesActions, runPagesDeploy } from "./pages";
-import { runPassword } from "./password";
-
-const REGISTRY: Record<string, CommandHandler> = {
-  version: runVersion,
-  "--version": runVersion,
-  "-v": runVersion,
-  doctor: runDoctor,
-  update: runUpdate,
-  provider: runProvider,
-  providers: runProvider,
-  models: runModels,
-  config: runConfig,
-  mcp: runMcp,
-  docs: runDocs,
-  password: runPassword,
-};
-
-/** Returns true if a new command handled the invocation (skip legacy flow). */
-export async function runNewCommand(argv: string[], pkgRoot: string): Promise<boolean> {
-  const args = argv.slice(2);
-  const ctx: CommandContext = { argv, args, pkgRoot, cwd: process.cwd() };
-
-  // Configure-only Pages→Actions: `--pages-actions` flag or `pages actions` verb.
-  if (args.includes("--pages-actions") || (args[0] === "pages" && args[1] === "actions")) {
-    await runPagesActions(ctx);
-    return true;
-  }
-  // Full deploy: `pages deploy` (detect owner/repo, confirm, run the proven
-  // push flow, print URL). Bare `pages`/`deploy` still fall through to legacy.
-  if (args[0] === "pages" && args[1] === "deploy") {
-    await runPagesDeploy(ctx);
-    return true;
-  }
-  // Wipe the stored AI credentials config: `config clear`.
-  if (args[0] === "config" && args[1] === "clear") {
-    await runConfigClear(ctx);
-    return true;
-  }
-
-  const handler = REGISTRY[args[0] ?? ""];
-  if (!handler) return false;
-  await handler(ctx);
-  return true;
-}
-
-export const NEW_COMMAND_NAMES = Object.keys(REGISTRY).filter((n) => !n.startsWith("-"));
+/**
+ * New-verb command layer (Phase 6). Intercepts the informational/utility
+ * commands that are NOT part of the legacy flag flow (version, doctor, provider,
+ * models, config, mcp, update) and routes them to thin handlers that consume
+ * @gitpagedocs/tools. Alias verbs (init, document, deploy, pages) are mapped in
+ * the parser and fall through to the legacy dispatch, so this returns false for
+ * them.
+ */
+export interface CommandContext {
+  argv: string[];
+  args: string[];
+  pkgRoot: string;
+  cwd: string;
+}
+
+export type CommandHandler = (ctx: CommandContext) => Promise<void>;
+
+import { runVersion, runDoctor, runUpdate } from "./diagnostics";
+import { runProvider, runModels } from "./ai-info";
+import { runConfig } from "./config-info";
+import { runConfigClear } from "./config-clear";
+import { runMcp } from "./mcp";
+import { runDocs } from "./docs";
+import { runPagesActions, runPagesDeploy } from "./pages";
+import { runPassword } from "./password";
+
+const REGISTRY: Record<string, CommandHandler> = {
+  version: runVersion,
+  "--version": runVersion,
+  "-v": runVersion,
+  doctor: runDoctor,
+  update: runUpdate,
+  provider: runProvider,
+  providers: runProvider,
+  models: runModels,
+  config: runConfig,
+  mcp: runMcp,
+  docs: runDocs,
+  password: runPassword,
+};
+
+/** Returns true if a new command handled the invocation (skip legacy flow). */
+export async function runNewCommand(argv: string[], pkgRoot: string): Promise<boolean> {
+  const args = argv.slice(2);
+  const ctx: CommandContext = { argv, args, pkgRoot, cwd: process.cwd() };
+
+  // Configure-only Pages→Actions: `--pages-actions` flag or `pages actions` verb.
+  if (args.includes("--pages-actions") || (args[0] === "pages" && args[1] === "actions")) {
+    await runPagesActions(ctx);
+    return true;
+  }
+  // Full deploy: `pages deploy` (detect owner/repo, confirm, run the proven
+  // push flow, print URL). Bare `pages`/`deploy` still fall through to legacy.
+  if (args[0] === "pages" && args[1] === "deploy") {
+    await runPagesDeploy(ctx);
+    return true;
+  }
+  // Wipe the stored AI credentials config: `config clear`.
+  if (args[0] === "config" && args[1] === "clear") {
+    await runConfigClear(ctx);
+    return true;
+  }
+
+  const handler = REGISTRY[args[0] ?? ""];
+  if (!handler) return false;
+  await handler(ctx);
+  return true;
+}
+
+export const NEW_COMMAND_NAMES = Object.keys(REGISTRY).filter((n) => !n.startsWith("-"));

package/presentation/index.ts

@@ -1,124 +1,124 @@
-#!/usr/bin/env node
-
-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 {
-  CliRuntimeParams,
-  ConfigOnlyRuntimePort,
-  HomeRuntimePort,
-} from "../application/ports/cli-runtime-ports";
-// @ts-expect-error .mjs modules are runtime-only in this package.
-import { buildConfigArtifacts } from "../builders/config-orchestrator.mjs";
-// @ts-expect-error .mjs modules are runtime-only in this package.
-import { createThemeTemplate } from "../builders/theme-template.mjs";
-// @ts-expect-error .mjs modules are runtime-only in this package.
-import { LAYOUTS } from "../data/layouts.mjs";
-// @ts-expect-error .mjs modules are runtime-only in this package.
-import { executeConfigOnly } from "../application/config-only/handler.mjs";
-// @ts-expect-error .mjs modules are runtime-only in this package.
-import { executeHome } from "../application/home/handler.mjs";
-// @ts-expect-error .mjs modules are runtime-only in this package.
-import { createConfigOnlyRuntime } from "../infrastructure/config-only/runtime.mjs";
-// @ts-expect-error .mjs modules are runtime-only in this package.
-import { createHomeRuntime } from "../infrastructure/home/runtime.mjs";
-
-const scriptDir = path.dirname(fileURLToPath(import.meta.url));
-const root = process.cwd();
-// cli/ is the published package root (bin = cli/index.mjs). scriptDir is
-// cli/presentation, so pkgRoot = cli/ and the bundled prebuilt/ ships at
-// cli/prebuilt — works identically in-repo and when installed via npm.
-const pkgRoot = path.join(scriptDir, "..");
-const prebuiltDir = path.join(pkgRoot, "prebuilt");
-
-const params: CliRuntimeParams = {
-  root,
-  pkgRoot,
-  prebuiltDir,
-  buildConfigArtifacts,
-  createThemeTemplate,
-  layouts: LAYOUTS,
-};
-
-async function main(): Promise<void> {
-  // `mcp start` owns stdout (the MCP stdio channel) — no banner/credits there.
-  const stdoutOwnedByCommand = process.argv[2] === "mcp";
-  if (!stdoutOwnedByCommand) printBanner();
-
-  // New informational/utility commands (version, doctor, provider, models,
-  // config, mcp, update) are handled before the legacy flag flow. Alias verbs
-  // (init, document, deploy, pages) are mapped in the parser and fall through.
-  if (await runNewCommand(process.argv, pkgRoot)) {
-    if (!stdoutOwnedByCommand) printCredits();
-    return;
-  }
-
-  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, {
-    runConfigOnly: async (context) => {
-      const safePrebuiltDir =
-        typeof context.prebuiltDir === "string"
-          ? context.prebuiltDir
-          : path.join(String(context.pkgRoot ?? process.cwd()), "prebuilt");
-      await executeConfigOnly(
-        {
-          ...context,
-          prebuiltDir: safePrebuiltDir,
-        },
-        configOnlyRuntime,
-      );
-    },
-    runHome: async (context) => {
-      await executeHome(context, homeRuntime);
-    },
-    runAi: async (context) => {
-      console.log("[gitpagedocs] Iniciando Módulo de IA na CLI...");
-      const safePrebuiltDir =
-        typeof context.prebuiltDir === "string"
-          ? context.prebuiltDir
-          : path.join(String(context.pkgRoot ?? process.cwd()), "prebuilt");
-      // @ts-ignore
-      const { runAiCliCommand } = await import("../ai/application/run-ai-cli-command.ts");
-      const result = await runAiCliCommand({
-        cwd: process.cwd(),
-        onInfo: (message: string) => console.log(message),
-        // Scaffold the base gitpagedocs/ structure before AI pages are wired in.
-        onScaffold: async () => {
-          await executeConfigOnly({ ...context, prebuiltDir: safePrebuiltDir }, configOnlyRuntime);
-        },
-      });
-
-      if (result.summary.scannedFilesCount === 0) {
-        console.log("[gitpagedocs:ai] Nenhum arquivo elegível foi encontrado nos paths informados.");
-        return;
-      }
-
-      const pages = result.summary.pages ?? [];
-      console.log(
-        `\nProcesso completo. Páginas no padrão gitpagedocs: ${pages.join(", ") || "(nenhuma)"}`,
-      );
-      console.log(
-        `[gitpagedocs:ai] ${result.summary.outputs.length} arquivos markdown gerados e conectados ao config.json da versão mais recente.`,
-      );
-    },
-  });
-  printCredits();
-}
-
-main().catch((err: unknown) => {
-  console.error("Failed to create Git Page Docs scaffold.", err);
-  process.exitCode = 1;
-});
+#!/usr/bin/env node
+
+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 {
+  CliRuntimeParams,
+  ConfigOnlyRuntimePort,
+  HomeRuntimePort,
+} from "../application/ports/cli-runtime-ports";
+// @ts-expect-error .mjs modules are runtime-only in this package.
+import { buildConfigArtifacts } from "../builders/config-orchestrator.mjs";
+// @ts-expect-error .mjs modules are runtime-only in this package.
+import { createThemeTemplate } from "../builders/theme-template.mjs";
+// @ts-expect-error .mjs modules are runtime-only in this package.
+import { LAYOUTS } from "../data/layouts.mjs";
+// @ts-expect-error .mjs modules are runtime-only in this package.
+import { executeConfigOnly } from "../application/config-only/handler.mjs";
+// @ts-expect-error .mjs modules are runtime-only in this package.
+import { executeHome } from "../application/home/handler.mjs";
+// @ts-expect-error .mjs modules are runtime-only in this package.
+import { createConfigOnlyRuntime } from "../infrastructure/config-only/runtime.mjs";
+// @ts-expect-error .mjs modules are runtime-only in this package.
+import { createHomeRuntime } from "../infrastructure/home/runtime.mjs";
+
+const scriptDir = path.dirname(fileURLToPath(import.meta.url));
+const root = process.cwd();
+// cli/ is the published package root (bin = cli/index.mjs). scriptDir is
+// cli/presentation, so pkgRoot = cli/ and the bundled prebuilt/ ships at
+// cli/prebuilt — works identically in-repo and when installed via npm.
+const pkgRoot = path.join(scriptDir, "..");
+const prebuiltDir = path.join(pkgRoot, "prebuilt");
+
+const params: CliRuntimeParams = {
+  root,
+  pkgRoot,
+  prebuiltDir,
+  buildConfigArtifacts,
+  createThemeTemplate,
+  layouts: LAYOUTS,
+};
+
+async function main(): Promise<void> {
+  // `mcp start` owns stdout (the MCP stdio channel) — no banner/credits there.
+  const stdoutOwnedByCommand = process.argv[2] === "mcp";
+  if (!stdoutOwnedByCommand) printBanner();
+
+  // New informational/utility commands (version, doctor, provider, models,
+  // config, mcp, update) are handled before the legacy flag flow. Alias verbs
+  // (init, document, deploy, pages) are mapped in the parser and fall through.
+  if (await runNewCommand(process.argv, pkgRoot)) {
+    if (!stdoutOwnedByCommand) printCredits();
+    return;
+  }
+
+  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, {
+    runConfigOnly: async (context) => {
+      const safePrebuiltDir =
+        typeof context.prebuiltDir === "string"
+          ? context.prebuiltDir
+          : path.join(String(context.pkgRoot ?? process.cwd()), "prebuilt");
+      await executeConfigOnly(
+        {
+          ...context,
+          prebuiltDir: safePrebuiltDir,
+        },
+        configOnlyRuntime,
+      );
+    },
+    runHome: async (context) => {
+      await executeHome(context, homeRuntime);
+    },
+    runAi: async (context) => {
+      console.log("[gitpagedocs] Iniciando Módulo de IA na CLI...");
+      const safePrebuiltDir =
+        typeof context.prebuiltDir === "string"
+          ? context.prebuiltDir
+          : path.join(String(context.pkgRoot ?? process.cwd()), "prebuilt");
+      // @ts-ignore
+      const { runAiCliCommand } = await import("../ai/application/run-ai-cli-command.ts");
+      const result = await runAiCliCommand({
+        cwd: process.cwd(),
+        onInfo: (message: string) => console.log(message),
+        // Scaffold the base gitpagedocs/ structure before AI pages are wired in.
+        onScaffold: async () => {
+          await executeConfigOnly({ ...context, prebuiltDir: safePrebuiltDir }, configOnlyRuntime);
+        },
+      });
+
+      if (result.summary.scannedFilesCount === 0) {
+        console.log("[gitpagedocs:ai] Nenhum arquivo elegível foi encontrado nos paths informados.");
+        return;
+      }
+
+      const pages = result.summary.pages ?? [];
+      console.log(
+        `\nProcesso completo. Páginas no padrão gitpagedocs: ${pages.join(", ") || "(nenhuma)"}`,
+      );
+      console.log(
+        `[gitpagedocs:ai] ${result.summary.outputs.length} arquivos markdown gerados e conectados ao config.json da versão mais recente.`,
+      );
+    },
+  });
+  printCredits();
+}
+
+main().catch((err: unknown) => {
+  console.error("Failed to create Git Page Docs scaffold.", err);
+  process.exitCode = 1;
+});