@gitpagedocs/cli 1.1.44

package/data/theme-colors.mjs

@@ -0,0 +1,387 @@
+export const THEME_COLORS = {
+  "matrix-dark": {
+    background: "#030606",
+    primary: "#22C55E",
+    secondary: "#4ADE80",
+    text: "#DCFCE7",
+    textSecondary: "#86EFAC",
+    cardBackground: "#04120A",
+    cardBorder: "#14532D",
+    error: "#F87171",
+    success: "#22C55E",
+  },
+  "matrix-light": {
+    background: "#F0FDF4",
+    primary: "#15803D",
+    secondary: "#16A34A",
+    text: "#052E16",
+    textSecondary: "#166534",
+    cardBackground: "#FFFFFF",
+    cardBorder: "#BBF7D0",
+    error: "#DC2626",
+    success: "#16A34A",
+  },
+  default: {
+    background: "#FFFFFF",
+    primary: "#0EA5E9",
+    secondary: "#2563EB",
+    text: "#0F172A",
+    textSecondary: "#334155",
+    cardBackground: "#FFFFFF",
+    cardBorder: "#E2E8F0",
+    error: "#DC2626",
+    success: "#16A34A",
+  },
+  "github-dark": {
+    background: "#0D1117",
+    primary: "#58A6FF",
+    secondary: "#2EA043",
+    text: "#E6EDF3",
+    textSecondary: "#8B949E",
+    cardBackground: "#161B22",
+    cardBorder: "#30363D",
+    error: "#F85149",
+    success: "#3FB950",
+  },
+  "github-light": {
+    background: "#FFFFFF",
+    primary: "#0969DA",
+    secondary: "#1A7F37",
+    text: "#1F2328",
+    textSecondary: "#57606A",
+    cardBackground: "#FFFFFF",
+    cardBorder: "#D0D7DE",
+    error: "#D1242F",
+    success: "#1A7F37",
+  },
+  "cyberpunk-dark": {
+    background: "#090014",
+    primary: "#F472B6",
+    secondary: "#22D3EE",
+    text: "#F5D0FE",
+    textSecondary: "#C4B5FD",
+    cardBackground: "#160024",
+    cardBorder: "#7E22CE",
+    error: "#FB7185",
+    success: "#2DD4BF",
+  },
+  "cyberpunk-light": {
+    background: "#FFF1F8",
+    primary: "#DB2777",
+    secondary: "#0891B2",
+    text: "#4A044E",
+    textSecondary: "#6D28D9",
+    cardBackground: "#FFFFFF",
+    cardBorder: "#F5D0FE",
+    error: "#E11D48",
+    success: "#0D9488",
+  },
+  "aurora-dark": {
+    background: "#070A14",
+    primary: "#7C3AED",
+    secondary: "#22D3EE",
+    text: "#E5E7EB",
+    textSecondary: "#B8C3D6",
+    cardBackground: "#101726",
+    cardBorder: "#334155",
+    error: "#FB7185",
+    success: "#34D399",
+  },
+  "aurora-light": {
+    background: "#F8FAFC",
+    primary: "#6D28D9",
+    secondary: "#0891B2",
+    text: "#0F172A",
+    textSecondary: "#475569",
+    cardBackground: "#FFFFFF",
+    cardBorder: "#E2E8F0",
+    error: "#E11D48",
+    success: "#059669",
+  },
+  "nord-dark": {
+    background: "#2E3440",
+    primary: "#88C0D0",
+    secondary: "#81A1C1",
+    text: "#ECEFF4",
+    textSecondary: "#D8DEE9",
+    cardBackground: "#3B4252",
+    cardBorder: "#4C566A",
+    error: "#BF616A",
+    success: "#A3BE8C",
+  },
+  "nord-light": {
+    background: "#ECEFF4",
+    primary: "#5E81AC",
+    secondary: "#81A1C1",
+    text: "#2E3440",
+    textSecondary: "#4C566A",
+    cardBackground: "#FFFFFF",
+    cardBorder: "#D8DEE9",
+    error: "#BF616A",
+    success: "#5E81AC",
+  },
+  "sunset-dark": {
+    background: "#1A0F0C",
+    primary: "#FB923C",
+    secondary: "#F472B6",
+    text: "#FFE4D6",
+    textSecondary: "#FDBA74",
+    cardBackground: "#2A1611",
+    cardBorder: "#7C2D12",
+    error: "#FB7185",
+    success: "#4ADE80",
+  },
+  "sunset-light": {
+    background: "#FFF7ED",
+    primary: "#EA580C",
+    secondary: "#DB2777",
+    text: "#431407",
+    textSecondary: "#9A3412",
+    cardBackground: "#FFFFFF",
+    cardBorder: "#FED7AA",
+    error: "#E11D48",
+    success: "#16A34A",
+  },
+  "mono-dark": {
+    background: "#0B0F0C",
+    primary: "#A3E635",
+    secondary: "#65A30D",
+    text: "#ECFCCB",
+    textSecondary: "#BEF264",
+    cardBackground: "#141A16",
+    cardBorder: "#365314",
+    error: "#F87171",
+    success: "#84CC16",
+  },
+  "mono-light": {
+    background: "#F7FEE7",
+    primary: "#4D7C0F",
+    secondary: "#65A30D",
+    text: "#1A2E05",
+    textSecondary: "#3F6212",
+    cardBackground: "#FFFFFF",
+    cardBorder: "#D9F99D",
+    error: "#DC2626",
+    success: "#4D7C0F",
+  },
+  "oceanic-dark": {
+    background: "#06121A",
+    primary: "#0EA5E9",
+    secondary: "#22D3EE",
+    text: "#DDF6FF",
+    textSecondary: "#9CC5D8",
+    cardBackground: "#0C1C27",
+    cardBorder: "#1E3A4B",
+    error: "#F87171",
+    success: "#34D399",
+  },
+  "oceanic-light": {
+    background: "#F0F9FF",
+    primary: "#0284C7",
+    secondary: "#0891B2",
+    text: "#0C4A6E",
+    textSecondary: "#1D4E89",
+    cardBackground: "#FFFFFF",
+    cardBorder: "#BAE6FD",
+    error: "#DC2626",
+    success: "#0F766E",
+  },
+  "rose-dark": {
+    background: "#1B0B13",
+    primary: "#F43F5E",
+    secondary: "#FB7185",
+    text: "#FFE4EA",
+    textSecondary: "#F9A8D4",
+    cardBackground: "#28111C",
+    cardBorder: "#7A1F3D",
+    error: "#FB7185",
+    success: "#34D399",
+  },
+  "rose-light": {
+    background: "#FFF1F5",
+    primary: "#E11D48",
+    secondary: "#DB2777",
+    text: "#7A1733",
+    textSecondary: "#9D174D",
+    cardBackground: "#FFFFFF",
+    cardBorder: "#FBCFE8",
+    error: "#DC2626",
+    success: "#059669",
+  },
+  "forest-dark": {
+    background: "#0A140F",
+    primary: "#22C55E",
+    secondary: "#4ADE80",
+    text: "#DCFCE7",
+    textSecondary: "#86EFAC",
+    cardBackground: "#122017",
+    cardBorder: "#275A3F",
+    error: "#F87171",
+    success: "#22C55E",
+  },
+  "forest-light": {
+    background: "#F3FFF5",
+    primary: "#15803D",
+    secondary: "#16A34A",
+    text: "#14532D",
+    textSecondary: "#166534",
+    cardBackground: "#FFFFFF",
+    cardBorder: "#BBF7D0",
+    error: "#DC2626",
+    success: "#15803D",
+  },
+  "graphite-dark": {
+    background: "#0B0F14",
+    primary: "#60A5FA",
+    secondary: "#93C5FD",
+    text: "#E5E7EB",
+    textSecondary: "#9CA3AF",
+    cardBackground: "#141A22",
+    cardBorder: "#2A3442",
+    error: "#F87171",
+    success: "#34D399",
+  },
+  "graphite-light": {
+    background: "#F8FAFC",
+    primary: "#2563EB",
+    secondary: "#3B82F6",
+    text: "#0F172A",
+    textSecondary: "#475569",
+    cardBackground: "#FFFFFF",
+    cardBorder: "#CBD5E1",
+    error: "#DC2626",
+    success: "#059669",
+  },
+  "lava-dark": {
+    background: "#1A0D08",
+    primary: "#F97316",
+    secondary: "#FB923C",
+    text: "#FFE7D5",
+    textSecondary: "#FDBA74",
+    cardBackground: "#2B1610",
+    cardBorder: "#7C2D12",
+    error: "#FB7185",
+    success: "#4ADE80",
+  },
+  "lava-light": {
+    background: "#FFF7ED",
+    primary: "#EA580C",
+    secondary: "#F97316",
+    text: "#7C2D12",
+    textSecondary: "#9A3412",
+    cardBackground: "#FFFFFF",
+    cardBorder: "#FED7AA",
+    error: "#DC2626",
+    success: "#16A34A",
+  },
+  "skyline-dark": {
+    background: "#080E1E",
+    primary: "#3B82F6",
+    secondary: "#22D3EE",
+    text: "#E0E7FF",
+    textSecondary: "#93C5FD",
+    cardBackground: "#101A2F",
+    cardBorder: "#2B3A67",
+    error: "#F87171",
+    success: "#34D399",
+  },
+  "skyline-light": {
+    background: "#EFF6FF",
+    primary: "#2563EB",
+    secondary: "#0EA5E9",
+    text: "#1E3A8A",
+    textSecondary: "#1D4ED8",
+    cardBackground: "#FFFFFF",
+    cardBorder: "#BFDBFE",
+    error: "#DC2626",
+    success: "#059669",
+  },
+  "emerald-dark": {
+    background: "#07150F",
+    primary: "#10B981",
+    secondary: "#34D399",
+    text: "#D1FAE5",
+    textSecondary: "#6EE7B7",
+    cardBackground: "#10231A",
+    cardBorder: "#1F6A4C",
+    error: "#F87171",
+    success: "#10B981",
+  },
+  "emerald-light": {
+    background: "#ECFDF5",
+    primary: "#059669",
+    secondary: "#10B981",
+    text: "#064E3B",
+    textSecondary: "#065F46",
+    cardBackground: "#FFFFFF",
+    cardBorder: "#A7F3D0",
+    error: "#DC2626",
+    success: "#059669",
+  },
+  "violet-dark": {
+    background: "#12081F",
+    primary: "#8B5CF6",
+    secondary: "#A78BFA",
+    text: "#EDE9FE",
+    textSecondary: "#C4B5FD",
+    cardBackground: "#1E1033",
+    cardBorder: "#4C1D95",
+    error: "#FB7185",
+    success: "#34D399",
+  },
+  "violet-light": {
+    background: "#F5F3FF",
+    primary: "#7C3AED",
+    secondary: "#8B5CF6",
+    text: "#4C1D95",
+    textSecondary: "#5B21B6",
+    cardBackground: "#FFFFFF",
+    cardBorder: "#DDD6FE",
+    error: "#DC2626",
+    success: "#059669",
+  },
+  "amber-dark": {
+    background: "#1A1306",
+    primary: "#F59E0B",
+    secondary: "#FBBF24",
+    text: "#FEF3C7",
+    textSecondary: "#FCD34D",
+    cardBackground: "#2A1E0D",
+    cardBorder: "#7C5B13",
+    error: "#FB7185",
+    success: "#4ADE80",
+  },
+  "amber-light": {
+    background: "#FFFBEB",
+    primary: "#D97706",
+    secondary: "#F59E0B",
+    text: "#78350F",
+    textSecondary: "#92400E",
+    cardBackground: "#FFFFFF",
+    cardBorder: "#FDE68A",
+    error: "#DC2626",
+    success: "#16A34A",
+  },
+  "slate-dark": {
+    background: "#0B1120",
+    primary: "#64748B",
+    secondary: "#94A3B8",
+    text: "#E2E8F0",
+    textSecondary: "#CBD5E1",
+    cardBackground: "#111827",
+    cardBorder: "#334155",
+    error: "#F87171",
+    success: "#34D399",
+  },
+  "slate-light": {
+    background: "#F8FAFC",
+    primary: "#475569",
+    secondary: "#64748B",
+    text: "#1E293B",
+    textSecondary: "#334155",
+    cardBackground: "#FFFFFF",
+    cardBorder: "#CBD5E1",
+    error: "#DC2626",
+    success: "#16A34A",
+  },
+};

package/data/urls.mjs

@@ -0,0 +1,7 @@
+/** Official layout URLs for git-page-docs repository */
+
+export const OFFICIAL_LAYOUTS_CONFIG_URL =
+  "https://github.com/Vidigal-code/git-page-docs/blob/main/gitpagedocs/layouts/layoutsConfig.json";
+
+export const OFFICIAL_LAYOUTS_TEMPLATES_URL =
+  "https://github.com/Vidigal-code/git-page-docs/blob/main/gitpagedocs/layouts/templates";

package/data/version-constants.mjs

@@ -0,0 +1,3 @@
+/** Document version identifiers for gitpagedocs */
+
+export { DOC_VERSIONS } from "../contracts/doc-versions.mjs";

package/domain/models/cli-options.ts

@@ -0,0 +1,18 @@
+export type CliMode = "home" | "full" | "config-only" | "ai";
+
+export interface CliOptions {
+  isBuild: boolean;
+  isServe: boolean;
+  mode: CliMode;
+  aiCommand?: string;
+  outputDir: string;
+  useLocalLayoutConfig: boolean;
+  shouldPush: boolean;
+  githubOwner: string;
+  githubRepo: string;
+  docsPath: string;
+  basePath: string;
+  repositorySearch?: boolean;
+  isInteractive: boolean;
+  hasArgs: boolean;
+}

package/domain/services/sanitize-segment.mjs

@@ -0,0 +1,7 @@
+/** Domain-level sanitization for owner/repo/path segments */
+
+export function sanitizeSegment(value) {
+  if (!value) return "";
+  const normalized = value.trim();
+  return /^[A-Za-z0-9._-]+$/.test(normalized) ? normalized : "";
+}

package/home/constants.mjs

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

package/home/home-file-writer.mjs

@@ -0,0 +1,20 @@
+/** 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 { getEnvTemplate, getDockerfileTemplate, getReadmeTemplate } from "./templates.mjs";
+
+/**
+ * @param {string} root
+ * @param {string} outputDir - e.g. gitpagedocshome or .
+ * @param {{ repositorySearch?: boolean; basePath?: string }} opts
+ */
+export async function writeHomeFiles(root, outputDir, opts = {}) {
+  const basePath = outputDir === "." || outputDir === "./" ? root : path.join(root, outputDir);
+  await mkdir(basePath, { recursive: true });
+
+  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");
+}

package/home/templates.mjs

@@ -0,0 +1,48 @@
+/** Template content for home distribution files */
+
+export function getEnvTemplate({ repositorySearch = false, basePath = "" }) {
+  const pathLine = basePath
+    ? `GITPAGEDOCS_PATH=${basePath}`
+    : `# GITPAGEDOCS_PATH=gi-page-docs`;
+  return `# GitPageDocs - Local development
+# Set to "true" to enable the search aggregator home.
+GITPAGEDOCS_REPOSITORY_SEARCH=${String(repositorySearch)}
+
+# Base path (when GITPAGEDOCS_REPOSITORY_SEARCH=false).
+# Example: localhost:3000/gi-page-docs
+${pathLine}
+`;
+}
+
+export function getDockerfileTemplate() {
+  return `FROM nginx:alpine
+COPY . /usr/share/nginx/html
+EXPOSE 80
+CMD ["nginx", "-g", "daemon off;"]
+`;
+}
+
+export function getReadmeTemplate({ outputDir = "gitpagedocshome" }) {
+  const cdDir = outputDir === "." || outputDir === "./" ? "." : outputDir;
+  return `# GitPageDocs Home
+
+Pre-built GitPageDocs static site by Vidigal-code.
+
+## Quick start
+
+\`\`\`bash
+npx serve .
+\`\`\`
+
+## Docker
+
+\`\`\`bash
+docker build -t gitpagedocshome .
+docker run -p 3000:80 gitpagedocshome
+\`\`\`
+
+## Credits
+
+Powered by Vidigal-code - https://github.com/Vidigal-code/git-page-docs
+`;
+}

package/index.mjs

@@ -0,0 +1,26 @@
+#!/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");
+
+const result = spawnSync(
+  process.execPath,
+  ["--import", "tsx", 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/config-only/runtime.mjs

@@ -0,0 +1,17 @@
+import { existsSync } from "node:fs";
+import { getCurrentGitBranch, runGitPushForGeneratedArtifacts } from "../../runtime/git-ops.mjs";
+import { writeConfigOnlyOutput, writeText } from "../../runtime/output.mjs";
+import { ensureGitHubPagesWorkflow } from "../../runtime/workflow.mjs";
+import { logInfo } from "../../ui/logger.mjs";
+
+export function createConfigOnlyRuntime() {
+  return {
+    hasPath: existsSync,
+    writeConfigOnlyOutput,
+    writeText,
+    ensureGitHubPagesWorkflow,
+    getCurrentGitBranch,
+    runGitPushForGeneratedArtifacts,
+    logInfo,
+  };
+}

package/infrastructure/home/runtime.mjs

@@ -0,0 +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,
+  };
+}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@gitpagedocs/cli",
+  "version": "1.1.44",
+  "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": "workspace:*",
+    "@gitpagedocs/tools": "workspace:*",
+    "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"
+  }
+}