@gitpagedocs/cli 1.1.53 → 1.1.54

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;
-}
+#!/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;
+}

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/package.json

@@ -1,60 +1,60 @@
-{
-  "name": "@gitpagedocs/cli",
-  "version": "1.1.53",
-  "description": "CLI that scaffolds and maintains gitpagedocs documentation, generates docs with AI, configures GitHub Pages, and runs the MCP server.",
-  "bin": {
-    "gitpagedocs": "index.mjs"
-  },
-  "main": "index.mjs",
-  "files": [
-    "index.mjs",
-    "start.mjs",
-    "ai",
-    "application",
-    "builders",
-    "content",
-    "contracts",
-    "data",
-    "domain",
-    "home",
-    "infrastructure",
-    "presentation",
-    "runtime",
-    "ui",
-    "prebuilt",
-    "README.md"
-  ],
-  "engines": {
-    "node": ">=20"
-  },
-  "dependencies": {
-    "@clack/prompts": "^1.5.1",
-    "@gitpagedocs/mcp": "^1.1.53",
-    "@gitpagedocs/tools": "^1.1.53",
-    "tsx": "^4.21.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Vidigal-code/git-page-docs.git",
-    "directory": "cli"
-  },
-  "keywords": [
-    "gitpagedocs",
-    "documentation",
-    "markdown",
-    "spa",
-    "cli",
-    "github-pages",
-    "create-gitpagedocs"
-  ],
-  "author": "Vidigal-code",
-  "license": "ISC",
-  "bugs": {
-    "url": "https://github.com/Vidigal-code/git-page-docs/issues"
-  },
-  "homepage": "https://vidigal-code.github.io/git-page-docs/",
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org/",
-    "access": "public"
-  }
-}
+{
+  "name": "@gitpagedocs/cli",
+  "version": "1.1.54",
+  "description": "CLI that scaffolds and maintains gitpagedocs documentation, generates docs with AI, configures GitHub Pages, and runs the MCP server.",
+  "bin": {
+    "gitpagedocs": "index.mjs"
+  },
+  "main": "index.mjs",
+  "files": [
+    "index.mjs",
+    "start.mjs",
+    "ai",
+    "application",
+    "builders",
+    "content",
+    "contracts",
+    "data",
+    "domain",
+    "home",
+    "infrastructure",
+    "presentation",
+    "runtime",
+    "ui",
+    "prebuilt",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.5.1",
+    "@gitpagedocs/mcp": "^1.1.53",
+    "@gitpagedocs/tools": "^1.1.53",
+    "tsx": "^4.21.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Vidigal-code/git-page-docs.git",
+    "directory": "cli"
+  },
+  "keywords": [
+    "gitpagedocs",
+    "documentation",
+    "markdown",
+    "spa",
+    "cli",
+    "github-pages",
+    "create-gitpagedocs"
+  ],
+  "author": "Vidigal-code",
+  "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/Vidigal-code/git-page-docs/issues"
+  },
+  "homepage": "https://vidigal-code.github.io/git-page-docs/",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  }
+}

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/options/resolver.ts

@@ -1,48 +1,48 @@
-import type { CliOptions } from "../../domain/models/cli-options";
-import { parseCliOptions } from "./parser";
-import {
-  shouldRunInteractive,
-  promptConfigOnlyOptions,
-  promptHomeOptions,
-  promptDeployOptions,
-  ensureGitRepoInteractive,
-  interactivePromptsAvailable,
-} from "../ui/prompts";
-import { DEFAULTS } from "./schema";
-// @ts-expect-error .mjs runtime module is type-less in this package.
-import { detectRepoFromGit } from "../../runtime/git-ops.mjs";
-
-export async function resolveOptions(argv: string[], env: NodeJS.ProcessEnv): Promise<CliOptions> {
-  const parsed = parseCliOptions(argv, env);
-
-  if (parsed.mode === "home") {
-    parsed.repositorySearch = parsed.repositorySearch ?? DEFAULTS.home.repositorySearch;
-    parsed.basePath = parsed.basePath ?? parsed.docsPath ?? DEFAULTS.home.basePath;
-  }
-
-  // `deploy` / `--push` need owner + repo AND a git repo. If anything is
-  // missing, prompt interactively (owner/repo pre-filled from the git origin
-  // remote; offer to `git init`) instead of throwing. In CI/non-TTY we fall
-  // through so the explicit guards in the push flow still fire clearly.
-  if (parsed.shouldPush && interactivePromptsAvailable()) {
-    let resolved = parsed;
-    if (!parsed.githubOwner || !parsed.githubRepo) {
-      const detected = detectRepoFromGit(process.cwd()) as { owner: string; repo: string } | null;
-      resolved = await promptDeployOptions(parsed, detected);
-    }
-    await ensureGitRepoInteractive(process.cwd());
-    return resolved;
-  }
-
-  const runHomeInteractive = parsed.isInteractive || (shouldRunInteractive(argv) && parsed.mode === "home");
-  if (runHomeInteractive && parsed.mode === "home") {
-    return promptHomeOptions(parsed);
-  }
-
-  const runConfigInteractive = parsed.isInteractive || (shouldRunInteractive(argv) && parsed.mode === "config-only");
-  if (runConfigInteractive && parsed.mode === "config-only") {
-    return promptConfigOnlyOptions(parsed);
-  }
-
-  return parsed;
-}
+import type { CliOptions } from "../../domain/models/cli-options";
+import { parseCliOptions } from "./parser";
+import {
+  shouldRunInteractive,
+  promptConfigOnlyOptions,
+  promptHomeOptions,
+  promptDeployOptions,
+  ensureGitRepoInteractive,
+  interactivePromptsAvailable,
+} from "../ui/prompts";
+import { DEFAULTS } from "./schema";
+// @ts-expect-error .mjs runtime module is type-less in this package.
+import { detectRepoFromGit } from "../../runtime/git-ops.mjs";
+
+export async function resolveOptions(argv: string[], env: NodeJS.ProcessEnv): Promise<CliOptions> {
+  const parsed = parseCliOptions(argv, env);
+
+  if (parsed.mode === "home") {
+    parsed.repositorySearch = parsed.repositorySearch ?? DEFAULTS.home.repositorySearch;
+    parsed.basePath = parsed.basePath ?? parsed.docsPath ?? DEFAULTS.home.basePath;
+  }
+
+  // `deploy` / `--push` need owner + repo AND a git repo. If anything is
+  // missing, prompt interactively (owner/repo pre-filled from the git origin
+  // remote; offer to `git init`) instead of throwing. In CI/non-TTY we fall
+  // through so the explicit guards in the push flow still fire clearly.
+  if (parsed.shouldPush && interactivePromptsAvailable()) {
+    let resolved = parsed;
+    if (!parsed.githubOwner || !parsed.githubRepo) {
+      const detected = detectRepoFromGit(process.cwd()) as { owner: string; repo: string } | null;
+      resolved = await promptDeployOptions(parsed, detected);
+    }
+    await ensureGitRepoInteractive(process.cwd());
+    return resolved;
+  }
+
+  const runHomeInteractive = parsed.isInteractive || (shouldRunInteractive(argv) && parsed.mode === "home");
+  if (runHomeInteractive && parsed.mode === "home") {
+    return promptHomeOptions(parsed);
+  }
+
+  const runConfigInteractive = parsed.isInteractive || (shouldRunInteractive(argv) && parsed.mode === "config-only");
+  if (runConfigInteractive && parsed.mode === "config-only") {
+    return promptConfigOnlyOptions(parsed);
+  }
+
+  return parsed;
+}

package/runtime/workflow.mjs

@@ -14,6 +14,7 @@ export async function ensureGitHubPagesWorkflow(getCurrentGitBranch, writeText,
         env:
           GITHUB_ACTIONS: "true"
           GITHUB_REPOSITORY: \${{ github.repository }}
+          GITPAGEDOCS_REPOSITORY_SEARCH: "true"
           GITPAGEDOCS_PATH: "${pathSegment}"
 
       - name: Relocate output to custom docs path
@@ -27,7 +28,8 @@ export async function ensureGitHubPagesWorkflow(getCurrentGitBranch, writeText,
         working-directory: .gitpagedocs-runtime
         env:
           GITHUB_ACTIONS: "true"
-          GITHUB_REPOSITORY: \${{ github.repository }}`;
+          GITHUB_REPOSITORY: \${{ github.repository }}
+          GITPAGEDOCS_REPOSITORY_SEARCH: "true"`;
   const currentBranch = getCurrentGitBranch();
   const workflowPath = ".github/workflows/gitpagedocs-pages.yml";
   const workflowContent = `name: Deploy GitPageDocs