ai-workflow-init 1.3.0 → 1.3.1

package/README.md

@@ -7,24 +7,44 @@ Initialize standardized AI workflow docs and command templates into ANY reposito
 > Requires: [Node.js](https://nodejs.org/) (>= 14)
 
 Run in the root of your target project:
+
 ```bash
 npx ai-workflow-init
 ```
-This will automatically fetch and place:
+
+The installer will prompt you to select which AI tool(s) to configure:
+
+- **1. Cursor** → installs `.cursor/commands` and `.cursor/prompts`
+- **2. GitHub Copilot** → installs `.github/prompts`
+- **3. Both** → installs both command sets and prompts
+
+All installations include:
+
 - `docs/ai` (planning, implementation, testing, project standards)
-- `.cursor/commands` (AI agent commands)
-- `AGENTS.md`
+- `AGENTS.md` with rules and workflow overview
+
+## Smart Installation Features
+
+- **Protected Files**: Core documentation files (`CODE_CONVENTIONS.md`, `PROJECT_STRUCTURE.md`) are never overwritten if they already exist
+- **Selective Updates**: Only `template-feature.md` and `README.md` files are updated in each documentation subfolder
+- **Safe Cloning**: Uses temporary directories to ensure no data loss
 
 ## Notes
+
 - Works on Windows (PowerShell/CMD/Git Bash), macOS, and Linux.
-- If the destination folders already exist, the installer will overwrite files as needed.
 - After installation, commit the new files to your repository so your team can use them.
 
 ## What gets installed
-- Documentation templates and guides under `docs/ai/`
-- AI agent commands under `.cursor/commands/`
-- `AGENTS.md` with rules and workflow overview
+
+- **Always installed**:
+  - Documentation templates and guides under `docs/ai/`
+  - `AGENTS.md` with rules and workflow overview
+- **Based on your choice**:
+  - `.cursor/commands/` and `.cursor/prompts/` (if Cursor is selected)
+  - `.github/prompts/` (if GitHub Copilot is selected)
 
 ## Troubleshooting
+
 - Ensure Node.js is installed and accessible in your PATH.
 - If your network blocks npm registry calls, try again on a different network or with a VPN.
+- Ensure you have write permissions in your project directory.

package/cli.js

@@ -1,8 +1,9 @@
 #!/usr/bin/env node
 
 const { execSync } = require("child_process");
-const { existsSync, mkdirSync } = require("fs");
+const { existsSync, mkdirSync, rmSync, cpSync, readdirSync } = require("fs");
 const readline = require("readline");
+const path = require("path");
 
 // Repo workflow gốc của bạn
 const REPO = "phananhtuan09/ai-agent-workflow";
@@ -23,13 +24,149 @@ function run(cmd) {
   }
 }
 
-// Hỏi user chọn IDE
-const rl = readline.createInterface({
-  input: process.stdin,
-  output: process.stdout,
-});
+// Clone folder luôn ghi đè
+function cloneFolderForce(source, dest) {
+  mkdirSync(path.dirname(dest), { recursive: true });
+  const tempDir = path.join(dest, ".temp-clone");
+
+  // Xóa temp folder nếu tồn tại
+  if (existsSync(tempDir)) {
+    rmSync(tempDir, { recursive: true, force: true });
+  }
+
+  run(`npx degit ${source} ${tempDir} --force`);
+
+  // Tạo dest folder nếu chưa có
+  if (!existsSync(dest)) {
+    mkdirSync(dest, { recursive: true });
+  }
+
+  // Copy tất cả files từ temp vào dest (ghi đè toàn bộ)
+  const filesToCopy = execSync(`find ${tempDir} -type f`, { encoding: "utf8" })
+    .trim()
+    .split("\n")
+    .filter(Boolean);
+
+  for (const file of filesToCopy) {
+    const relativePath = path.relative(tempDir, file);
+    const destFile = path.join(dest, relativePath);
+
+    // Tạo folder nếu cần
+    mkdirSync(path.dirname(destFile), { recursive: true });
+
+    // Copy file với ghi đè
+    cpSync(file, destFile, { force: true });
+  }
+
+  // Xóa temp folder
+  rmSync(tempDir, { recursive: true, force: true });
+}
+
+// Clone folder docs/ai một cách an toàn
+function cloneDocsAI(source, dest) {
+  mkdirSync(dest, { recursive: true });
+  const tempDir = path.join(dest, ".temp-clone");
+
+  // Xóa temp folder nếu tồn tại
+  if (existsSync(tempDir)) {
+    rmSync(tempDir, { recursive: true, force: true });
+  }
+
+  run(`npx degit ${source} ${tempDir} --force`);
+
+  // Xử lý từng subfolder
+  const subfolders = ["implementation", "planning", "testing"];
+
+  // Xử lý folders: implementation, planning, testing
+  for (const subfolder of subfolders) {
+    const tempSubfolder = path.join(tempDir, subfolder);
+    const destSubfolder = path.join(dest, subfolder);
+
+    if (existsSync(tempSubfolder)) {
+      mkdirSync(destSubfolder, { recursive: true });
+
+      // Chỉ copy file template và README.md
+      const filesToCopy = ["README.md", "feature-template.md"];
 
+      for (const file of filesToCopy) {
+        const srcFile = path.join(tempSubfolder, file);
+        const destFile = path.join(destSubfolder, file);
+
+        if (existsSync(srcFile)) {
+          cpSync(srcFile, destFile, { force: true });
+        }
+      }
+    }
+  }
+
+  // Xử lý folder: project
+  const tempProject = path.join(tempDir, "project");
+  const destProject = path.join(dest, "project");
+
+  if (existsSync(tempProject)) {
+    mkdirSync(destProject, { recursive: true });
+
+    // 1. Chỉ tạo CODE_CONVENTIONS.md và PROJECT_STRUCTURE.md nếu chưa có
+    const protectedFiles = [
+      "CODE_CONVENTIONS.md",
+      "PROJECT_STRUCTURE.md",
+      "README.md",
+    ];
+
+    for (const file of protectedFiles) {
+      const srcFile = path.join(tempProject, file);
+      const destFile = path.join(destProject, file);
+
+      if (existsSync(srcFile)) {
+        // Nếu là CODE_CONVENTIONS.md hoặc PROJECT_STRUCTURE.md, chỉ tạo nếu chưa có
+        if (
+          (file === "CODE_CONVENTIONS.md" || file === "PROJECT_STRUCTURE.md") &&
+          existsSync(destFile)
+        ) {
+          console.log(`⏭️  Skipping (already exists): docs/ai/project/${file}`);
+          continue;
+        }
+
+        // Các file khác luôn ghi đè
+        cpSync(srcFile, destFile, { force: true });
+      }
+    }
+
+    // 2. Ghi đè folder template-convention
+    const tempTemplateConvention = path.join(
+      tempProject,
+      "template-convention"
+    );
+    const destTemplateConvention = path.join(
+      destProject,
+      "template-convention"
+    );
+
+    if (existsSync(tempTemplateConvention)) {
+      // Xóa folder cũ nếu tồn tại
+      if (existsSync(destTemplateConvention)) {
+        rmSync(destTemplateConvention, { recursive: true, force: true });
+      }
+
+      // Copy folder mới
+      cpSync(tempTemplateConvention, destTemplateConvention, {
+        recursive: true,
+        force: true,
+      });
+    }
+  }
+
+  // Xóa temp folder
+  rmSync(tempDir, { recursive: true, force: true });
+}
+
+// Hỏi user chọn IDE
 function askIDE() {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
   return new Promise((resolve) => {
     console.log("\n🤖 Which AI tool(s) do you want to setup?");
     console.log("1. Cursor");
@@ -53,15 +190,11 @@ async function main() {
     process.exit(1);
   }
 
-  // Kiểm tra và tạo folder nếu chưa có
-  if (!existsSync("docs/ai")) {
-    mkdirSync("docs/ai", { recursive: true });
-  }
-
+  // Clone docs/ai một cách an toàn, bảo vệ các file quan trọng
   step("🚚 Downloading workflow template (docs/ai)...");
-  run(`npx degit ${REPO}/docs/ai docs/ai --force`);
+  cloneDocsAI(`${REPO}/docs/ai`, "docs/ai");
 
-  // Clone Cursor commands
+  // Clone Cursor commands (luôn ghi đè)
   if (installCursor) {
     if (!existsSync(".cursor/commands")) {
       mkdirSync(".cursor/commands", { recursive: true });
@@ -70,16 +203,26 @@ async function main() {
     run(`npx degit ${REPO}/.cursor/commands .cursor/commands --force`);
   }
 
-  // Clone GitHub Copilot commands (nếu có folder khác)
+  // Clone GitHub Copilot prompts (luôn ghi đè)
   if (installCopilot) {
-    if (!existsSync(".copilot/commands")) {
-      mkdirSync(".copilot/commands", { recursive: true });
+    if (!existsSync(".github/prompts")) {
+      mkdirSync(".github/prompts", { recursive: true });
+    }
+    step("🚚 Downloading GitHub Copilot prompts (.github/prompts)...");
+    run(`npx degit ${REPO}/.github/prompts .github/prompts --force`);
+  }
+
+  // Clone Cursor prompts (luôn ghi đè)
+  if (installCursor) {
+    if (!existsSync(".cursor/prompts")) {
+      mkdirSync(".cursor/prompts", { recursive: true });
     }
-    step("🚚 Downloading GitHub Copilot agent commands (.copilot/commands)...");
-    run(`npx degit ${REPO}/.copilot/commands .copilot/commands --force`);
+    step("🚚 Downloading Cursor prompts (.cursor/prompts)...");
+    run(`npx degit ${REPO}/.cursor/prompts .cursor/prompts --force`);
   }
 
-  step("🚚 Downloading AGENTS.md ...");
+  // Download AGENTS.md (luôn ghi đè)
+  step("🚚 Downloading AGENTS.md...");
   try {
     run(`curl -fsSL ${RAW_BASE}/AGENTS.md -o AGENTS.md`);
   } catch (_) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-workflow-init",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "Initialize AI workflow docs & commands into any repo with one command",
   "bin": {
     "ai-workflow-init": "./cli.js"