codymaster 5.2.0 → 7.0.1

package/scripts/postinstall.js

@@ -1,298 +1,65 @@
 #!/usr/bin/env node
+/**
+ * CodyMaster postinstall — minimal, friendly, no surprise actions.
+ * The actual platform install runs through `cm` (the onboarding wizard) so
+ * users always opt in interactively.
+ */
+
+const fs = require('fs');
+const path = require('path');
 
-const G = '\x1b[32m';
 const C = '\x1b[36m';
-const W = '\x1b[37m';
+const G = '\x1b[32m';
 const O = '\x1b[33m';
-const Y = '\x1b[1;33m';
-const BOLD = '\x1b[1m';
+const W = '\x1b[1;37m';
 const DIM = '\x1b[2m';
 const NC = '\x1b[0m';
 
-const fs = require('fs');
-const path = require('path');
-const { execSync, execFileSync } = require('child_process');
-
-let skillCount = 68;
+let skillCount = 60;
 try {
   const skillsDir = path.join(__dirname, '..', 'skills');
   if (fs.existsSync(skillsDir)) {
-    skillCount = fs.readdirSync(skillsDir)
-      .filter(f => {
-        const fullPath = path.join(skillsDir, f);
-        return f.startsWith('cm-') && fs.statSync(fullPath).isDirectory() && fs.existsSync(path.join(fullPath, 'SKILL.md'));
-      })
-      .length;
-  }
-} catch (e) {}
-
-
-// Simple check for Vietnamese environment for the CORE UI
-const isVi = Intl.DateTimeFormat().resolvedOptions().locale.startsWith('vi');
-
-const sentiments = {
-  start: [
-    "🐹: Whiskers twitching... CodyMaster incoming!",
-    `🐹: Let's fill these cheeks with ${skillCount} skills! ✨`,
-    "🐹: Waking up from a power nap! Let's build! 🐭"
-  ],
-  progress: [
-    "🐹: Sniffing out your AI agents...",
-    "🐹: Running on the wheel to speed this up! 🏃💨",
-    "🐹: Found a skill! Stashing it in my pocket... 💎"
-  ],
-  finish: [
-    "🐹: Mission accomplished! Can I have a walnut now? 🥜",
-    `🐹: My cheeks are stuffed with ${skillCount} skills for you! ✨`,
-    "🐹: Terminal is Hamster-approved! Better than a wheel! 🎡",
-    `🐹: ${skillCount} skills stored. I'm ready for vibe coding! ⚡`
-  ]
-};
-
-const getSentiment = (state) => {
-  const list = sentiments[state];
-  return `    ${C}${list[Math.floor(Math.random() * list.length)]}${NC}`;
-};
-
-const showSkillGuide = (choice) => {
-  console.clear();
-  console.log(`     ${G}\\${NC} ${O}( \\_/ )${NC} ${G}/${NC}`);
-  console.log(`    ${G}\\${NC} ${O}(${NC} ${G}^ u ^${NC} ${O})${NC} ${G}/${NC}`);
-  console.log(`   ${G}--${NC} ${O}(  ___  )${NC} ${G}--${NC}`);
-  console.log('');
-  
-  if (isVi) {
-    switch(choice) {
-      case '1':
-        console.log(`${Y}${BOLD}1. Hướng dẫn toàn tập${NC} (${C}cm-how-it-work${NC})`);
-        console.log(`${BOLD}🎯 Tình huống:${NC} Bạn mới cài CodyMaster và chưa biết bắt đầu từ đâu.`);
-        console.log(`${BOLD}🚀 Câu lệnh:${NC} \`cm @/cm-how-it-work\``);
-        console.log(`${BOLD}💡 Thử copy prompt này:${NC} "Giải thích quy trình từ ý tưởng đến lúc deploy một ứng dụng web bằng bộ skill này."`);
-        break;
-      case '2':
-        console.log(`${Y}${BOLD}2. Vibe Coding (Zero Code)${NC} (${C}cm-start${NC})`);
-        console.log(`${BOLD}🎯 Tình huống:${NC} Bạn có ý tưởng nhưng lười gõ từng dòng code.`);
-        console.log(`${BOLD}🚀 Câu lệnh:${NC} \`cm @/cm-start\``);
-        console.log(`${BOLD}💡 Thử copy prompt này:${NC} "Tôi muốn làm một trang web bán cà phê có giỏ hàng, dùng Tailwind CSS."`);
-        break;
-      case '3':
-        console.log(`${Y}${BOLD}3. Tham gia dự án có sẵn${NC} (${C}cm-brainstorm-idea${NC})`);
-        console.log(`${BOLD}🎯 Tình huống:${NC} Bạn nhảy vào một dự án có sẵn và thấy code quá rắc rối.`);
-        console.log(`${BOLD}🚀 Câu lệnh:${NC} \`cm @/cm-brainstorm-idea\``);
-        console.log(`${BOLD}💡 Thử copy prompt này:${NC} "Đọc toàn bộ project này và chỉ cho tôi 3 điểm yếu lớn nhất cần cải thiện ngay."`);
-        break;
-      case '4':
-        console.log(`${Y}${BOLD}4. Thiết kế giao diện (UX/UI)${NC} (${C}cm-ux-master / cm-ui-preview${NC})`);
-        console.log(`${BOLD}🎯 Tình huống:${NC} Bạn muốn web của mình đẹp như Apple hay Linear.`);
-        console.log(`${BOLD}🚀 Câu lệnh:${NC} \`cm @/cm-ux-master\``);
-        console.log(`${BOLD}💡 Thử copy prompt này:${NC} "Lấy style từ trang stripe.com và thiết kế cho tôi một trang thanh toán cực sang."`);
-        break;
-      case '5':
-        console.log(`${Y}${BOLD}5. Lập trình TDD & Pair code${NC} (${C}cm-tdd${NC})`);
-        console.log(`${BOLD}🎯 Tình huống:${NC} Bạn muốn code chắc chắn, không có lỗi khi chạy production.`);
-        console.log(`${BOLD}🚀 Câu lệnh:${NC} \`cm @/cm-tdd\``);
-        console.log(`${BOLD}💡 Thử copy prompt này:${NC} "Viết test case trước, sau đó code chức năng đăng ký người dùng cho tôi."`);
-        break;
-      case '6':
-        console.log(`${Y}${BOLD}6. Dọn dẹp & Tái cấu trúc${NC} (${C}cm-clean-code${NC})`);
-        console.log(`${BOLD}🎯 Tình huống:${NC} Code chạy được nhưng nhìn như "bãi rác".`);
-        console.log(`${BOLD}🚀 Câu lệnh:${NC} \`cm @/cm-clean-code\``);
-        console.log(`${BOLD}💡 Thử copy prompt này:${NC} "Tối ưu lại file này: xóa code thừa, đặt lại tên biến cho chuẩn và dễ hiểu hơn."`);
-        break;
-      case '7':
-        console.log(`${Y}${BOLD}7. Quét & Sửa lỗi bảo mật${NC} (${C}cm-security-gate${NC})`);
-        console.log(`${BOLD}🎯 Tình huống:${NC} Sợ lộ API key hoặc web bị hack XSS.`);
-        console.log(`${BOLD}🚀 Câu lệnh:${NC} \`cm @/cm-security-gate\``);
-        console.log(`${BOLD}💡 Thử copy prompt này:${NC} "Kiểm tra xem project có lỗ hổng bảo mật nào không trước khi tôi push lên GitHub."`);
-        break;
-      case '8':
-        console.log(`${Y}${BOLD}8. Viết tài liệu Docs & API${NC} (${C}cm-dockit${NC})`);
-        console.log(`${BOLD}🎯 Tình huống:${NC} Lười viết tài liệu hướng dẫn cho đồng nghiệp hoặc khách hàng.`);
-        console.log(`${BOLD}🚀 Câu lệnh:${NC} \`cm @/cm-dockit\``);
-        console.log(`${BOLD}💡 Thử copy prompt này:${NC} "Tự động tạo file hướng dẫn sử dụng (README) cho toàn bộ project này."`);
-        break;
-      case '9':
-        console.log(`${Y}${BOLD}9. Tạo WOW Landing Page${NC} (${C}cm-cro-methodology${NC})`);
-        console.log(`${BOLD}🎯 Tình huống:${NC} Web có người vào nhưng không ai mua hàng/đăng ký.`);
-        console.log(`${BOLD}🚀 Câu lệnh:${NC} \`cm @/cm-cro-methodology\``);
-        console.log(`${BOLD}💡 Thử copy prompt này:${NC} "Phân tích trang web này và chỉ cách tăng gấp đôi tỷ lệ khách hàng đăng ký."`);
-        break;
-      case '10':
-        console.log(`${Y}${BOLD}10. Bảng theo dõi tiến độ${NC} (${C}cm dashboard${NC})`);
-        console.log(`${BOLD}🎯 Tình huống:${NC} Muốn biết mình đã làm được bao nhiêu % công việc rồi.`);
-        console.log(`${BOLD}🚀 Câu lệnh:${NC} \`cm dashboard\``);
-        console.log(`${BOLD}💡 Thử copy prompt này:${NC} "Hiện bảng dashboard để tôi xem tiến độ các task hiện tại."`);
-        break;
-      case '11':
-        console.log(`${Y}${BOLD}11. Xem Demo (Claude Code)${NC} (${C}/cm:demo${NC})`);
-        console.log(`${BOLD}🎯 Tình huống:${NC} Muốn xem CodyMaster tự "múa" code như thế nào.`);
-        console.log(`${BOLD}🚀 Câu lệnh:${NC} \`/cm:demo\``);
-        console.log(`${BOLD}💡 Thử copy prompt này:${NC} "Bắt đầu demo: tự tạo một ứng dụng TodoList từ A-Z trong 1 phút."`);
-        break;
-      case '12':
-        console.log(`${Y}${BOLD}12. Trợ giúp & Cú pháp lệnh${NC} (${C}cm help${NC})`);
-        console.log(`${BOLD}🎯 Tình huống:${NC} Quên lệnh hoặc muốn tìm thêm skill xịn khác.`);
-        console.log(`${BOLD}🚀 Câu lệnh:${NC} \`cm help\``);
-        console.log(`${BOLD}💡 Thử copy prompt này:${NC} "Liệt kê các skill liên quan đến Growth Hacking và Marketing."`);
-        break;
-    }
-  } else {
-    switch(choice) {
-      case '1':
-        console.log(`${Y}${BOLD}1. The Ultimate Guide${NC} (${C}cm-how-it-work${NC})`);
-        console.log(`${BOLD}🎯 Situation:${NC} You just installed CodyMaster and don't know where to start.`);
-        console.log(`${BOLD}🚀 Command:${NC} \`cm @/cm-how-it-work\``);
-        console.log(`${BOLD}💡 Try this prompt:${NC} "Explain the process from idea to deployment using this skill kit."`);
-        break;
-      case '2':
-        console.log(`${Y}${BOLD}2. Vibe Coding (Zero Code)${NC} (${C}cm-start${NC})`);
-        console.log(`${BOLD}🎯 Situation:${NC} You have an idea but are too lazy to write code manually.`);
-        console.log(`${BOLD}🚀 Command:${NC} \`cm @/cm-start\``);
-        console.log(`${BOLD}💡 Try this prompt:${NC} "Build a coffee shop website with a cart using Tailwind CSS."`);
-        break;
-      case '3':
-        console.log(`${Y}${BOLD}3. Code an Existing Project${NC} (${C}cm-brainstorm-idea${NC})`);
-        console.log(`${BOLD}🎯 Situation:${NC} You're joining an existing project and the code is a mess.`);
-        console.log(`${BOLD}🚀 Command:${NC} \`cm @/cm-brainstorm-idea\``);
-        console.log(`${BOLD}💡 Try this prompt:${NC} "Read this entire project and tell me the 3 biggest weaknesses."`);
-        break;
-      case '4':
-        console.log(`${Y}${BOLD}4. Generate UX/UI Designs${NC} (${C}cm-ux-master / cm-ui-preview${NC})`);
-        console.log(`${BOLD}🎯 Situation:${NC} You want your web app to look as premium as Apple or Linear.`);
-        console.log(`${BOLD}🚀 Command:${NC} \`cm @/cm-ux-master\``);
-        console.log(`${BOLD}💡 Try this prompt:${NC} "Copy the style from stripe.com and design a high-end checkout page."`);
-        break;
-      case '5':
-        console.log(`${Y}${BOLD}5. Code TDD & Pair Coding${NC} (${C}cm-tdd${NC})`);
-        console.log(`${BOLD}🎯 Situation:${NC} You want reliable code that doesn't break in production.`);
-        console.log(`${BOLD}🚀 Command:${NC} \`cm @/cm-tdd\``);
-        console.log(`${BOLD}💡 Try this prompt:${NC} "Write test cases first, then implement user registration for me."`);
-        break;
-      case '6':
-        console.log(`${Y}${BOLD}6. Clean & Refactor Codebase${NC} (${C}cm-clean-code${NC})`);
-        console.log(`${BOLD}🎯 Situation:${NC} The code works but it looks like a "garbage dump".`);
-        console.log(`${BOLD}🚀 Command:${NC} \`cm @/cm-clean-code\``);
-        console.log(`${BOLD}💡 Try this prompt:${NC} "Optimize this file: remove dead code and rename variables for clarity."`);
-        break;
-      case '7':
-        console.log(`${Y}${BOLD}7. Scan for Vulnerabilities${NC} (${C}cm-security-gate${NC})`);
-        console.log(`${BOLD}🎯 Situation:${NC} Worried about leaking API keys or XSS hacks.`);
-        console.log(`${BOLD}🚀 Command:${NC} \`cm @/cm-security-gate\``);
-        console.log(`${BOLD}💡 Try this prompt:${NC} "Check if there are any security vulnerabilities before I push to GitHub."`);
-        break;
-      case '8':
-        console.log(`${Y}${BOLD}8. Write Docs & Generate APIs${NC} (${C}cm-dockit${NC})`);
-        console.log(`${BOLD}🎯 Situation:${NC} Lazy to write documentation for teammates or clients.`);
-        console.log(`${BOLD}🚀 Command:${NC} \`cm @/cm-dockit\``);
-        console.log(`${BOLD}💡 Try this prompt:${NC} "Automatically generate a README guide for this entire project."`);
-        break;
-      case '9':
-        console.log(`${Y}${BOLD}9. Release WOW Landing Page${NC} (${C}cm-cro-methodology${NC})`);
-        console.log(`${BOLD}🎯 Situation:${NC} Visitors come to your site but don't buy or sign up.`);
-        console.log(`${BOLD}🚀 Command:${NC} \`cm @/cm-cro-methodology\``);
-        console.log(`${BOLD}💡 Try this prompt:${NC} "Analyze this website and show me how to double my sign-up rate."`);
-        break;
-      case '10':
-        console.log(`${Y}${BOLD}10. Open Progress Dashboard${NC} (${C}cm dashboard${NC})`);
-        console.log(`${BOLD}🎯 Situation:${NC} Want to know how much work is actually completed.`);
-        console.log(`${BOLD}🚀 Command:${NC} \`cm dashboard\``);
-        console.log(`${BOLD}💡 Try this prompt:${NC} "Show the dashboard so I can see the progress of current tasks."`);
-        break;
-      case '11':
-        console.log(`${Y}${BOLD}11. See an Interactive Demo${NC} (${C}/cm:demo${NC})`);
-        console.log(`${BOLD}🎯 Situation:${NC} Want to see CodyMaster perform its magic automatically.`);
-        console.log(`${BOLD}🚀 Command:${NC} \`/cm:demo\``);
-        console.log(`${BOLD}💡 Try this prompt:${NC} "Start demo: build a TodoList app from scratch in 1 minute."`);
-        break;
-      case '12':
-        console.log(`${Y}${BOLD}12. Help & Command List${NC} (${C}cm help${NC})`);
-        console.log(`${BOLD}🎯 Situation:${NC} Forgot a command or looking for more cool skills.`);
-        console.log(`${BOLD}🚀 Command:${NC} \`cm help\``);
-        console.log(`${BOLD}💡 Try this prompt:${NC} "List all skills related to Growth Hacking and Marketing."`);
-        break;
-    }
+    skillCount = fs
+      .readdirSync(skillsDir)
+      .filter((f) => {
+        const full = path.join(skillsDir, f);
+        return (
+          f.startsWith('cm-') &&
+          fs.statSync(full).isDirectory() &&
+          fs.existsSync(path.join(full, 'SKILL.md'))
+        );
+      }).length;
   }
-
-  console.log('');
-};
-
-const printMenu = () => {
-  console.clear();
-  console.log(`     ${G}\\${NC} ${O}( \\_/ )${NC} ${G}/${NC}`);
-  console.log(`    ${G}\\${NC} ${O}(${NC} ${G}^ u ^${NC} ${O})${NC} ${G}/${NC}`);
-  console.log(`   ${G}--${NC} ${O}(  ___  )${NC} ${G}--${NC}    ${G}${BOLD}${isVi ? '✅ Hoàn tất!' : '✅ Done!'}${NC}`);
-  console.log(`    ${O}| [     ] |${NC}`);
-  console.log(`     ${O}'--w-w--'${NC}`);
-  console.log('');
-  
-  if (isVi) {
-    console.log(`    ${W}${BOLD}🎉 Thành công! Bạn đã mở khóa ${skillCount} kỹ năng AI toàn năng:${NC}`);
-  } else {
-    console.log(`    ${W}${BOLD}🎉 Success! You just unlocked ${skillCount} omnipotent AI skills:${NC}`);
-  }
-  
-  console.log('');
-  console.log(getSentiment('finish'));
-  console.log('');
-  
-  if (isVi) {
-    console.log(`  ${C}🎯 Orchestration${NC} : Lên kế hoạch & Điều phối Agent`);
-    console.log(`  ${C}🎨 Product${NC}       : Thiết kế UX/UI & Tâm lý hành vi`);
-    console.log(`  ${C}🔧 Engineering${NC}   : Code Full-stack & Tái cấu trúc`);
-    console.log(`  ${C}🔒 Security${NC}      : Bảo mật tự động & Chống rò rỉ`);
-    console.log(`  ${C}⚙️ Operations${NC}    : Triển khai an toàn & Quản lý CI/CD`);
-    console.log(`  ${C}📈 Growth${NC}        : Tối ưu chuyển đổi (CRO) & Tracking`);
-    console.log('');
-    console.log(`    ${W}${BOLD}🌟 Lệnh phổ biến:${NC}`);
-    console.log('');
-    console.log(`   🔸 ${Y}Bảng tiến độ (Dashboard)    ${NC} → cm dashboard`);
-    console.log(`   🔸 ${Y}Cần trợ giúp / Tìm kỹ năng    ${NC} → cm help`);
-    console.log(`   🔸 ${Y}Cách CodyMaster hoạt động  ${NC} → cm-how-it-work`);
-  } else {
-    console.log(`  ${C}🎯 Orchestration${NC} : Task Planning & Agent Synergy`);
-    console.log(`  ${C}🎨 Product${NC}       : UX/UI Mastery & User Psychology`);
-    console.log(`  ${C}🔧 Engineering${NC}   : Full-stack TDD & Refactoring`);
-    console.log(`  ${C}🔒 Security${NC}      : Automated Gates & Secret Shields`);
-    console.log(`  ${C}⚙️ Operations${NC}    : Safe Deployments & CI/CD Excellence`);
-    console.log(`  ${C}📈 Growth${NC}        : Conversion Tracking & Hacks`);
-    console.log('');
-    console.log(`    ${W}${BOLD}🌟 Popular Commands:${NC}`);
-    console.log('');
-    console.log(`   🔸 ${Y}Open progress dashboard    ${NC} → cm dashboard`);
-    console.log(`   🔸 ${Y}Help & Command list        ${NC} → cm help`);
-    console.log(`   🔸 ${Y}The ultimate guide         ${NC} → cm-how-it-work`);
-  }
-  
-  console.log('');
-  console.log(`    ${W}${BOLD}${isVi ? '📚 Tài liệu:' : '📚 Documentation:'}${NC} ${C}https://cody.todyle.com/docs${NC}`);
-  console.log('');
-};
-
-const isInstalledAsNpmDependency = () => {
-  const root = path.resolve(__dirname, '..').replace(/\\/g, '/');
-  return /[/\\]node_modules[/\\]codymaster$/i.test(root);
-};
-
-const npmCmd = () => (process.platform === 'win32' ? 'npm.cmd' : 'npm');
-
-const activateCli = () => {
-  const pkgRoot = path.join(__dirname, '..');
-
-  if (isInstalledAsNpmDependency()) {
-    console.log(`  ${C}CodyMaster CLI (per-project install — official path):${NC}`);
-    console.log(`    ${W}npx cm${NC}   or   ${W}npx codymaster${NC}`);
-    console.log(
-      `  ${DIM}Optional — bare ${W}cm${DIM} in any terminal: ${W}npm install -g codymaster${NC}`,
-    );
-    return;
-  }
-
-
-};
-
-const main = () => {
-  activateCli();
-  printMenu();
-};
-
-main();
+} catch {}
+
+const sentiments = [
+  `🐹: ${skillCount} skills stuffed in my cheeks. Ready when you are! ✨`,
+  `🐹: Whiskers twitching — type ${W}cm${NC}${C} to start the wizard.`,
+  '🐹: Power-nap over. Let\'s build! 🐭',
+];
+const pick = (arr) => arr[Math.floor(Math.random() * arr.length)];
+
+const isGlobal =
+  process.env.npm_config_global === 'true' ||
+  /[/\\]npm[/\\]node_modules[/\\]codymaster$/i.test(path.resolve(__dirname, '..').replace(/\\/g, '/'));
+
+console.log('');
+console.log(`     ${G}\\${NC} ${O}( \\_/ )${NC} ${G}/${NC}`);
+console.log(`    ${G}\\${NC} ${O}(${NC} ${G}^ u ^${NC} ${O})${NC} ${G}/${NC}`);
+console.log(`   ${G}--${NC} ${O}(  ___  )${NC} ${G}--${NC}    ${G}${W}CodyMaster ready${NC}`);
+console.log(`    ${O}| [     ] |${NC}`);
+console.log(`     ${O}'--w-w--'${NC}`);
+console.log('');
+console.log(`    ${C}${pick(sentiments)}${NC}`);
+console.log('');
+
+if (isGlobal) {
+  console.log(`    Next: run  ${W}cm${NC}  to start the onboarding wizard.`);
+  console.log(`    ${DIM}It will detect your AI coding tools and install skills where you choose.${NC}`);
+} else {
+  console.log(`    Next: run  ${W}npx cm${NC}  inside this project to start the wizard.`);
+  console.log(`    ${DIM}For a global \`cm\` command:  ${W}npm install -g codymaster${NC}${DIM}.${NC}`);
+}
+console.log('');
+console.log(`    ${DIM}Docs: https://cody.todyle.com/docs${NC}`);
+console.log('');

package/scripts/release.sh

@@ -0,0 +1,126 @@
+#!/bin/bash
+# CodyMaster Release Script
+# Usage: bash scripts/release.sh [patch|minor|major|v1.2.3]
+#
+# Bumps version, updates changelog, commits, tags, and pushes.
+# GitHub Actions will handle npm publish on tag push.
+
+set -e
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+BOLD='\033[1m'
+RESET='\033[0m'
+
+info()  { echo -e "${BLUE}  ℹ ${RESET}$1"; }
+ok()    { echo -e "${GREEN}  ✅ ${RESET}$1"; }
+warn()  { echo -e "${YELLOW}  ⚠️  ${RESET}$1"; }
+err()   { echo -e "${RED}  ❌ ${RESET}$1"; exit 1; }
+
+BUMP_TYPE="${1:-patch}"
+REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+PKG_JSON="$REPO_ROOT/package.json"
+
+# ─── Pre-checks ──────────────────────────────────────────────────
+echo ""
+echo -e "${BOLD}  🐹 CodyMaster Release${RESET}"
+echo ""
+
+# Ensure clean working tree
+if [ -n "$(git status --porcelain)" ]; then
+  err "Working tree is not clean. Commit or stash changes first."
+fi
+
+# Ensure on main/master
+CURRENT_BRANCH=$(git branch --show-current)
+if [ "$CURRENT_BRANCH" != "main" ] && [ "$CURRENT_BRANCH" != "master" ]; then
+  warn "Not on main branch (currently on: $CURRENT_BRANCH)"
+  read -p "  Continue anyway? (y/N) " -n 1 -r
+  echo ""
+  if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+    exit 1
+  fi
+fi
+
+# ─── Calculate new version ───────────────────────────────────────
+CURRENT_VERSION=$(node -p "require('./package.json').version" 2>/dev/null)
+info "Current version: v$CURRENT_VERSION"
+
+case "$BUMP_TYPE" in
+  patch)  NEW_VERSION=$(echo "$CURRENT_VERSION" | awk -F. '{print $1"."$2"."$3+1}') ;;
+  minor)  NEW_VERSION=$(echo "$CURRENT_VERSION" | awk -F. '{print $1"."$2+1".0"}') ;;
+  major)  NEW_VERSION=$(echo "$CURRENT_VERSION" | awk -F. '{print $1+1".0.0"}' ;;
+  v*)     NEW_VERSION="${BUMP_TYPE#v}" ;;
+  *)
+    err "Usage: $0 [patch|minor|major|v1.2.3]"
+    ;;
+esac
+
+info "New version: v$NEW_VERSION"
+echo ""
+
+# Confirm
+read -p "  Release v$NEW_VERSION? (y/N) " -n 1 -r
+echo ""
+if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+  info "Aborted."
+  exit 0
+fi
+
+# ─── Bump version in package.json ────────────────────────────────
+info "Bumping version in package.json..."
+node -e "
+  const fs = require('fs');
+  const pkg = JSON.parse(fs.readFileSync('$PKG_JSON', 'utf-8'));
+  pkg.version = '$NEW_VERSION';
+  fs.writeFileSync('$PKG_JSON', JSON.stringify(pkg, null, 2) + '\n');
+"
+ok "package.json updated"
+
+# ─── Sync MCP server version ─────────────────────────────────────
+MCP_FILE="$REPO_ROOT/src/mcp-context-server.ts"
+if [ -f "$MCP_FILE" ]; then
+  sed -i '' "s/SERVER_VERSION = '[^']*'/SERVER_VERSION = '$NEW_VERSION'/" "$MCP_FILE" 2>/dev/null || \
+  sed -i "s/SERVER_VERSION = '[^']*'/SERVER_VERSION = '$NEW_VERSION'/" "$MCP_FILE" 2>/dev/null
+  ok "MCP server version synced"
+fi
+
+# ─── Update changelog ────────────────────────────────────────────
+info "Updating changelog..."
+if [ -f "$REPO_ROOT/scripts/update-changelog.sh" ]; then
+  bash "$REPO_ROOT/scripts/update-changelog.sh" || warn "Changelog update failed (non-fatal)"
+  ok "Changelog updated"
+else
+  warn "Changelog script not found, skipping"
+fi
+
+# ─── Build ───────────────────────────────────────────────────────
+info "Building..."
+npm run build 2>/dev/null || npx tsc
+ok "Build complete"
+
+# ─── Commit & Tag ────────────────────────────────────────────────
+info "Committing..."
+git add -A
+git commit -m "chore: release v$NEW_VERSION"
+git tag -a "v$NEW_VERSION" -m "Release v$NEW_VERSION"
+ok "Tagged v$NEW_VERSION"
+
+# ─── Push ────────────────────────────────────────────────────────
+info "Pushing to origin..."
+git push origin "$CURRENT_BRANCH"
+git push origin "v$NEW_VERSION"
+ok "Pushed to origin"
+
+echo ""
+echo -e "${GREEN}  ✅ Release v$NEW_VERSION complete!${RESET}"
+echo ""
+echo -e "  ${BOLD}What happens next:${RESET}"
+echo -e "  1. GitHub Actions will run CI tests"
+echo -e "  2. On tag push, npm publish runs automatically"
+echo -e "  3. GitHub Release is created with release notes"
+echo ""
+echo -e "  ${BOLD}Monitor:${RESET}  https://github.com/todyle/codymaster/actions"
+echo ""

package/scripts/update-changelog.sh

@@ -0,0 +1,88 @@
+#!/bin/bash
+# update-changelog.sh — Auto-update CHANGELOG.md from git commits
+#
+# Usage:
+#   bash scripts/update-changelog.sh          # Update CHANGELOG.md
+#   bash scripts/update-changelog.sh --dry-run # Preview without writing
+#
+# Follows conventional commits format:
+#   feat: → 🚀 Features
+#   fix: → 🐛 Bug Fixes
+#   security: → 🔒 Security
+#   improve/refactor/perf: → 🚀 Improvements
+
+set -e
+
+REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+CHANGELOG="$REPO_ROOT/CHANGELOG.md"
+DRY_RUN=false
+
+if [[ "$1" == "--dry-run" ]]; then
+  DRY_RUN=true
+fi
+
+# Get last tag
+LAST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "")
+
+# Get commits since last tag
+if [ -z "$LAST_TAG" ]; then
+  COMMITS=$(git log --oneline -20 --no-merges)
+else
+  COMMITS=$(git log --oneline "$LAST_TAG"..HEAD --no-merges)
+fi
+
+if [ -z "$COMMITS" ]; then
+  echo "No commits found since last tag."
+  exit 0
+fi
+
+# Categorize commits
+FEATURES=$(echo "$COMMITS" | grep -iE "^[a-f0-9]+ feat:" | sed 's/^[a-f0-9]* /- /' || true)
+FIXES=$(echo "$COMMITS" | grep -iE "^[a-f0-9]+ fix:" | sed 's/^[a-f0-9]* /- /' || true)
+SECURITY=$(echo "$COMMITS" | grep -iE "^[a-f0-9]+ (security|sec):" | sed 's/^[a-f0-9]* /- /' || true)
+IMPROVEMENTS=$(echo "$COMMITS" | grep -iE "^[a-f0-9]+ (improve|refactor|perf):" | sed 's/^[a-f0-9]* /- /' || true)
+OTHER=$(echo "$COMMITS" | grep -ivE "^[a-f0-9]+ (feat|fix|security|sec|improve|refactor|perf):" | sed 's/^[a-f0-9]* /- /' || true)
+
+# Generate changelog entry
+DATE=$(date +%Y-%m-%d)
+VERSION=$(node -p "require('$REPO_ROOT/package.json').version" 2>/dev/null || echo "unreleased")
+
+ENTRY="## [$VERSION] - $DATE\n\n"
+
+if [ -n "$FEATURES" ]; then
+  ENTRY+="### 🚀 Features\n$FEATURES\n\n"
+fi
+
+if [ -n "$FIXES" ]; then
+  ENTRY+="### 🐛 Bug Fixes\n$FIXES\n\n"
+fi
+
+if [ -n "$SECURITY" ]; then
+  ENTRY+="### 🔒 Security\n$SECURITY\n\n"
+fi
+
+if [ -n "$IMPROVEMENTS" ]; then
+  ENTRY+="### 🚀 Improvements\n$IMPROVEMENTS\n\n"
+fi
+
+if [ -n "$OTHER" ]; then
+  ENTRY+="### 📦 Other\n$OTHER\n\n"
+fi
+
+if [ "$DRY_RUN" = true ]; then
+  echo "=== DRY RUN — would add to CHANGELOG.md ==="
+  echo -e "$ENTRY"
+  exit 0
+fi
+
+# Prepend to CHANGELOG.md
+if [ -f "$CHANGELOG" ]; then
+  TEMP=$(mktemp)
+  echo -e "$ENTRY" > "$TEMP"
+  cat "$CHANGELOG" >> "$TEMP"
+  mv "$TEMP" "$CHANGELOG"
+else
+  echo -e "# Changelog\n\nAll notable changes to this project will be documented in this file.\n\nCategories: 🚀 **Improvements** | 🐛 **Bug Fixes** | 🔒 **Security**\n\n---\n\n$ENTRY" > "$CHANGELOG"
+fi
+
+echo "✅ CHANGELOG.md updated (version: $VERSION)"