@docubook/cli 0.2.4 → 0.2.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docubook/cli",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "DocuBook CLI tool that helps you initialize, update, and deploy documentation directly from your terminal.",
   "type": "module",
   "files": [

package/src/cli/program.js

@@ -9,6 +9,107 @@ import { detectPackageManager, getPackageManagerInfo, getPackageManagerVersion }
 import { getAvailableTemplates, getTemplate, getDefaultTemplate } from "../utils/templateDetect.js";
 import { execSync } from "child_process";
 import ora from "ora";
+import fs from "fs";
+import os from "os";
+import path from "path";
+
+// Helpers to show changelog once per installed version. Stores shown versions under
+// $HOME/.docubook_cli_seen_changelogs.json as a map: { "@docubook/cli": ["1.2.3"] }
+const _CHANGELOG_STORE = path.join(os.homedir(), ".docubook_cli_seen_changelogs.json");
+function _readChangelogStore() {
+  try {
+    const raw = fs.readFileSync(_CHANGELOG_STORE, "utf8");
+    return JSON.parse(raw || "{}");
+  } catch {
+    return {};
+  }
+}
+function _writeChangelogStore(obj) {
+  try {
+    fs.writeFileSync(_CHANGELOG_STORE, JSON.stringify(obj, null, 2), { mode: 0o600 });
+  } catch {
+    // non-fatal
+  }
+}
+
+async function _fetchChangelogFromGitHub(tag) {
+  // Try to fetch CHANGELOG.md from the repo tag. Support several tag-name variants
+  // (e.g. v1.2.3, 1.2.3, cli-v1.2.3, cli-1.2.3) and common filename variants.
+  const repo = "DocuBook/docubook";
+
+  const bare = tag.replace(/^v/, "");
+  const variants = [tag, bare, `cli-${tag}`, `cli-${bare}`].filter(Boolean);
+
+  const candidates = [];
+  for (const v of variants) {
+    candidates.push(`https://raw.githubusercontent.com/${repo}/${v}/CHANGELOG.md`);
+    candidates.push(`https://raw.githubusercontent.com/${repo}/${v}/CHANGELOG.MD`);
+  }
+  // final fallback to main branch
+  candidates.push(`https://raw.githubusercontent.com/${repo}/main/CHANGELOG.md`);
+
+  for (const url of candidates) {
+    try {
+      const res = await fetch(url);
+      if (res && res.ok) return await res.text();
+    } catch {
+      // ignore and try next
+    }
+  }
+  return null;
+}
+
+function _extractVersionSection(changelogText, version) {
+  if (!changelogText) return null;
+  const lines = changelogText.split(/\r?\n/);
+  // Look for headings that include the version (e.g. "## v1.2.3" or "## 1.2.3")
+  const headerRe = new RegExp(`^#{1,3}\\s*(?:v)?${version.replace(/\./g, "\\.")}(?:\\b|\\D)`, "i");
+  let start = -1;
+  for (let i = 0; i < lines.length; i++) {
+    if (headerRe.test(lines[i])) {
+      start = i;
+      break;
+    }
+  }
+  if (start === -1) return changelogText.slice(0, 2000); // fallback: return beginning of changelog
+
+  let end = lines.length;
+  for (let j = start + 1; j < lines.length; j++) {
+    if (/^#{1,3}\s*/.test(lines[j])) {
+      end = j;
+      break;
+    }
+  }
+  return lines.slice(start, end).join("\n");
+}
+
+async function showChangelogOnce(pkgName, version) {
+  try {
+    const store = _readChangelogStore();
+    const seen = Array.isArray(store[pkgName]) ? store[pkgName] : [];
+    if (seen.includes(version)) return;
+
+    const tag = version.startsWith("v") ? version : `v${version}`;
+    const changelog = await _fetchChangelogFromGitHub(tag);
+    if (!changelog) return;
+
+    const section = _extractVersionSection(changelog, version);
+    if (!section) return;
+
+    // Print a concise changelog section
+    console.log("\n=== DocuBook CLI changelog (new) ===\n");
+    console.log(section.trim());
+    console.log("\nFor full changelog, visit:");
+    console.log(`  https://github.com/DocuBook/docubook/blob/main/CHANGELOG.md\n`);
+
+    // Mark as shown
+    store[pkgName] = Array.from(new Set([...seen, version]));
+    _writeChangelogStore(store);
+  } catch {
+    // silent on any error - changelog is a nicety
+  }
+}
+
 
 /**
  * Initializes the CLI program
@@ -59,6 +160,12 @@ export function initializeProgram(version) {
         try {
           execSync(cmd, { stdio: "inherit" });
           console.log(`Successfully updated to ${latest}`);
+          // Try to show changelog for the newly installed version once
+          try {
+            await showChangelogOnce(pkgName, latest);
+          } catch {
+            // non-fatal
+          }
         } catch (installErr) {
           // If install fails, provide a helpful message
           console.error(`Update failed: ${installErr.message || installErr}`);
@@ -73,6 +180,16 @@ export function initializeProgram(version) {
       }
     });
 
+  // Expose a `version` subcommand: `docubook version`
+  program
+    .command('version')
+    .description('Print the DocuBook CLI version')
+    .action(() => {
+      console.log(`DocuBook CLI ${version}`);
+      console.log("Run 'docubook update' to check for updates.");
+      process.exit(0);
+    });
+
   // Default behavior (create project)
   program
     .argument("[directory]", "The name of the project directory")

package/src/index.js

@@ -14,9 +14,9 @@ const packageJsonPath = path.join(__dirname, '..', 'package.json');
 const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
 const VERSION = packageJson.version;
 
-// Handle --version / -V early to print custom output
+// Handle --version / -v early to print custom output
 const args = process.argv.slice(2);
-if (args.includes('--version') || args.includes('-V')) {
+if (args.includes('--version') || args.includes('-v')) {
   console.log(`DocuBook CLI ${VERSION}`);
   console.log("Run 'docubook update' to check for updates.");
   process.exit(0);

package/src/tui/ascii.js

@@ -62,7 +62,7 @@ export function createWelcomeBanner(version) {
   const logoMid = `${colors.cyan}${colors.bright}▌>_▐${colors.reset}`
   const logoBot = `${colors.cyan}▙▄▄▟${colors.reset}`
 
-  const title = `${colors.cyan}${colors.bright}DocuBook${colors.reset} v${version}`
+  const title = `${colors.cyan}${colors.bright}DocuBook CLI${colors.reset} v${version}`
   const subtitle = `${colors.gray}Initialize, build, and deploy docs from terminal.${colors.reset}`
 
   const tip = `${colors.gray}Visit our documentation.${colors.reset}`
@@ -103,16 +103,8 @@ export function createBoxedMessage(title, content, color = colors.green) {
   const reset = "\x1b[0m";
   const termWidth = process.stdout.columns || 80;
 
-  // 1. Tentukan total lebar box (termasuk border)
   const boxWidth = Math.min(80, termWidth - 4);
-
-  // 2. width adalah panjang garis horizontal (─) di atas dan bawah
-  // Total lebar box adalah width + 2 (untuk karakter pojok ┌ dan ┐)
   const width = boxWidth - 2;
-
-  // 3. inner adalah ruang bersih di dalam box untuk teks (tanpa padding spasi)
-  // Kita beri padding 2 spasi di kiri dan 2 spasi di kanan (total 4)
-  // Jadi: 1(│) + 2(spasi) + inner + 2(spasi) + 1(│) = width + 2
   const inner = (width + 2) - 6;
 
   const centerTitle = () => {
@@ -126,16 +118,11 @@ export function createBoxedMessage(title, content, color = colors.green) {
 
   const pad = (text = "") => {
     const len = stringWidth(text);
-    // Tambahkan spasi hingga tepat mengisi 'inner'
     return text + " ".repeat(Math.max(0, inner - len));
   };
 
   const lines = [];
-
-  // Header
   lines.push(`${color}┌${centerTitle()}┐${reset}`);
-
-  // Padding atas (opsional)
   lines.push(`${color}│${reset}  ${pad("")}  ${color}│${reset}`);
 
   const items = typeof content === "string"
@@ -145,15 +132,10 @@ export function createBoxedMessage(title, content, color = colors.green) {
   for (const line of items) {
     const wrapped = wrapText(line, inner);
     wrapped.forEach((w) => {
-      // Pastikan struktur: │ + spasi(2) + konten + spasi(2) + │
       lines.push(`${color}│${reset}  ${pad(w)}  ${color}│${reset}`);
     });
   }
-
-  // Padding bawah (opsional)
   lines.push(`${color}│${reset}  ${pad("")}  ${color}│${reset}`);
-
-  // Footer
   lines.push(`${color}└${"─".repeat(width)}┘${reset}`);
 
   return "\n" + lines.join("\n") + "\n";

package/src/utils/packageManager.js

@@ -1,32 +1,6 @@
-import { execSync } from "child_process";
 import fs from "fs";
 import path from "path";
 
-/**
- * Gets the version of the specified package manager
- * @param {string} pm - Package manager name
- * @returns {string|null} Version string or null if not installed
- */
-export function getPackageManagerVersion(pm) {
-  try {
-    return execSync(`${pm} --version`).toString().trim();
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Detects the default package manager from user environment
- * @returns {string} Default package manager name
- */
-export function detectDefaultPackageManager() {
-  const userAgent = process.env.npm_config_user_agent || "";
-  if (userAgent.includes("pnpm")) return "pnpm";
-  if (userAgent.includes("yarn")) return "yarn";
-  if (userAgent.includes("bun")) return "bun";
-  return "npm";
-}
-
 /**
  * Updates postcss config file extension for Bun compatibility
  * @param {string} projectPath - Path to the project directory

package/templates.json

@@ -16,6 +16,23 @@
       ],
       "url": "https://github.com/DocuBook/docubook/tree/main/packages/template/nextjs-vercel"
     },
+    {
+      "id": "nextjs-docker",
+      "name": "nextjs-docker",
+      "description": "Modern documentation with Next.js standalone and Docker deployment",
+      "features": [
+        "Next.js 16",
+        "React 19",
+        "TypeScript",
+        "Tailwind CSS",
+        "MDX Support",
+        "Dark Mode",
+        "Search (Algolia)",
+        "Responsive Design",
+        "Docker Deployment"
+      ],
+      "url": "https://github.com/DocuBook/docubook/tree/main/packages/template/nextjs-docker"
+    },
     {
       "id": "react-router",
       "name": "react-router",