evnict-kit 0.2.1

package/src/utils/config.js

@@ -0,0 +1,167 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import yaml from 'js-yaml';
+
+export function loadConfig(cwd = process.cwd()) {
+  const configPath = join(cwd, '.evnict', 'config.yaml');
+  if (!existsSync(configPath)) return null;
+  try {
+    const raw = yaml.load(readFileSync(configPath, 'utf8'));
+    return normalizeConfig(raw);
+  } catch (e) {
+    console.warn(`⚠️  Lỗi đọc config.yaml: ${e.message}`);
+    return null;
+  }
+}
+
+/**
+ * Normalize config — hỗ trợ cả v0.1.3 (object) và v0.1.4 (array) format cho repos.
+ * v0.1.3: repos: { backend: {folder, tech}, frontend: {folder, tech} }
+ * v0.1.4: repos: [ {folder, type, tech}, ... ]
+ */
+export function normalizeConfig(config) {
+  if (!config || !config.repos) return config;
+
+  // Already v0.1.4 array format
+  if (Array.isArray(config.repos)) return config;
+
+  // v0.1.3 object format → convert to array
+  const repos = [];
+  if (config.repos.backend) {
+    repos.push({
+      folder: config.repos.backend.folder,
+      type: 'backend',
+      tech: config.repos.backend.tech || 'springboot',
+    });
+  }
+  if (config.repos.frontend) {
+    repos.push({
+      folder: config.repos.frontend.folder,
+      type: 'frontend',
+      tech: config.repos.frontend.tech || 'angular',
+    });
+  }
+  // Preserve database at top level (not in repos array)
+  const database = config.repos.database || config.database;
+  config.repos = repos;
+  if (database) config.database = database;
+  return config;
+}
+
+export function mergeWithConfig(cliOptions, cwd = process.cwd()) {
+  const config = loadConfig(cwd);
+  if (!config) return cliOptions;
+
+  // Extract first backend/frontend from repos array for backward compat
+  const beRepo = config.repos?.find(r => r.type === 'backend');
+  const feRepo = config.repos?.find(r => r.type === 'frontend');
+
+  return {
+    name: cliOptions.name || config.project?.name,
+    be: cliOptions.be || beRepo?.folder,
+    fe: cliOptions.fe || feRepo?.folder,
+    tool: cliOptions.tool || config.ai_tool || 'antigravity',
+    techBe: cliOptions.techBe || beRepo?.tech || 'springboot',
+    techFe: cliOptions.techFe || feRepo?.tech || 'angular',
+    db: cliOptions.db || config.database?.type || 'oracle',
+    ...cliOptions,
+  };
+}
+
+export const TECH_LABELS = {
+  springboot: 'Java Spring Boot',
+  aspnet: 'ASP.NET Core',
+  javaee: 'Java EE',
+  angular: 'Angular',
+  'react-web': 'React (Web)',
+  'react-mobile': 'React Native (Mobile)',
+  'nextjs': 'Next.js',
+  'nodejs': 'Node.js',
+  oracle: 'Oracle Database',
+  sqlserver: 'SQL Server',
+};
+
+/**
+ * Auto-detect suggested type based on tech stack
+ */
+export const TECH_TYPE_HINTS = {
+  springboot: 'backend',
+  aspnet: 'backend',
+  javaee: 'backend',
+  nodejs: 'backend',
+  angular: 'frontend',
+  'react-web': 'frontend',
+  'react-mobile': 'frontend',
+  'nextjs': 'frontend',
+};
+
+/**
+ * Tool-specific directory and file mapping
+ * Mỗi AI tool có cách tổ chức riêng — v0.2.1 Multi-Tool Support
+ */
+export const TOOL_MAP = {
+  antigravity: {
+    agentDir: '.agent',
+    contextFile: 'AGENTS.md',
+    rulesDir: '.agent/rules',
+    skillsDir: '.agent/skills',
+    workflowsDir: '.agent/workflows',
+    contextDir: '.agent/context',
+    ruleExt: '.md',
+    deployMode: 'flat',        // flat files in dirs
+  },
+  claude: {
+    agentDir: '.claude',
+    contextFile: 'CLAUDE.md',
+    rulesDir: null,            // Rules gộp TRONG CLAUDE.md, không tách file
+    skillsDir: null,           // Skills = commands
+    workflowsDir: '.claude/commands',  // Everything is a command
+    contextDir: null,
+    ruleExt: '.md',
+    deployMode: 'mega-file',   // 1 big CLAUDE.md + commands/
+  },
+  cursor: {
+    agentDir: '.cursor',
+    contextFile: '.cursorrules',
+    rulesDir: '.cursor/rules',
+    skillsDir: null,           // Cursor không có native skills
+    workflowsDir: null,        // Cursor không có native workflows
+    contextDir: null,
+    ruleExt: '.mdc',           // Cursor uses .mdc extension!
+    deployMode: 'rules-only',  // Only rules + context
+  },
+  copilot: {
+    agentDir: '.github',
+    contextFile: '.github/copilot-instructions.md',
+    rulesDir: null,            // Rules gộp trong instructions.md
+    skillsDir: null,
+    workflowsDir: null,
+    contextDir: null,
+    ruleExt: null,
+    deployMode: 'single-file', // Everything in 1 file
+  },
+  codex: {
+    agentDir: '.agent',
+    contextFile: 'AGENTS.md',
+    rulesDir: '.agent/rules',
+    skillsDir: '.agent/skills',
+    workflowsDir: '.agent/workflows',
+    contextDir: '.agent/context',
+    ruleExt: '.md',
+    deployMode: 'flat',        // Same as antigravity
+  },
+};
+
+/**
+ * Tools that have templates ready — v0.2.1: ALL 5 tools supported
+ */
+export const SUPPORTED_TOOLS = ['antigravity', 'claude', 'cursor', 'copilot', 'codex'];
+
+export function getToolMap(tool) {
+  const map = TOOL_MAP[tool];
+  if (!map) {
+    console.error(`❌ Tool "${tool}" chưa hỗ trợ. Chọn: ${Object.keys(TOOL_MAP).join('|')}`);
+    process.exit(1);
+  }
+  return map;
+}

package/src/utils/file.js

@@ -0,0 +1,53 @@
+import { mkdirSync, writeFileSync, readFileSync, existsSync, readdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+export const PACKAGE_ROOT = join(__dirname, '../..');
+export const TEMPLATES_DIR = join(PACKAGE_ROOT, 'templates');
+
+export function ensureDir(dir, cwd = '') {
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+    const display = cwd ? dir.replace(cwd, '.') : dir;
+    console.log(`   📁 ${display}`);
+    return true;
+  }
+  return false;
+}
+
+export function writeFile(filePath, content, { overwrite = false, cwd = '', silent = false } = {}) {
+  if (existsSync(filePath) && !overwrite) {
+    if (!silent) {
+      const display = cwd ? filePath.replace(cwd, '.') : filePath;
+      console.log(`   ⏭️  Skip: ${display} (exists)`);
+    }
+    return false;
+  }
+  const dir = dirname(filePath);
+  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+  writeFileSync(filePath, content, 'utf8');
+  if (!silent) {
+    const display = cwd ? filePath.replace(cwd, '.') : filePath;
+    console.log(`   ✅ ${display}`);
+  }
+  return true;
+}
+
+export function copyTemplateDir(srcDir, destDir, cwd = '') {
+  if (!existsSync(srcDir)) return 0;
+  let count = 0;
+  const entries = readdirSync(srcDir, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = join(srcDir, entry.name);
+    const destPath = join(destDir, entry.name);
+    if (entry.isDirectory()) {
+      ensureDir(destPath, cwd);
+      count += copyTemplateDir(srcPath, destPath, cwd);
+    } else {
+      if (writeFile(destPath, readFileSync(srcPath, 'utf8'), { cwd })) count++;
+    }
+  }
+  return count;
+}

package/templates/GETTING-STARTED.md

@@ -0,0 +1,196 @@
+# EVNICT-KIT — Hướng Dẫn Sử Dụng
+> File này được tạo bởi evnict-kit v0.2.1
+> Đọc file này để biết dùng workflow nào cho công việc nào
+
+---
+
+## 📋 Danh sách Workflows theo Case Công Việc
+
+### 🚀 Lần đầu setup dự án
+| Bước | Lệnh | Mô tả |
+|------|-------|-------|
+| 1 | `evnict-kit init` | Chạy ở terminal workspace, tạo cấu trúc |
+| 2 | `/evnict-kit:init-rules` | Mở Agent trong project, Agent đọc code → điền rules |
+| 3 | `/evnict-kit:init-context` | Agent sinh file AGENTS.md từ rules |
+| 4 | `/evnict-kit:init-check` | Agent sinh demo code để verify conventions |
+| 5 | `/evnict-kit:init-wiki` | Setup wiki repo (nếu chưa có) |
+| 6 | `/evnict-kit:wiki-scan-project` | Scan code hiện có → nạp wiki |
+
+---
+
+### 🔧 Phát triển Feature LỚN (cần cả BE + FE + DB)
+| Bước | Lệnh | Mô tả |
+|------|-------|-------|
+| 1 | `/evnict-kit:feature-large "mô tả"` | Brainstorm → Spec → Clarify |
+| 2 | `/evnict-kit:plan` | Sinh plan + task files chi tiết |
+| 3 | `/evnict-kit:implement` | TDD per subtask (STOP-AND-ASK) |
+| 4 | `/evnict-kit:handoff` | Chuyển giao cho FE/BE Agent |
+| 5 | `/evnict-kit:review` | Auto review trước merge |
+| 6 | `/evnict-kit:wiki-archive-feature` | Nạp tri thức vào wiki |
+
+---
+
+### 🔨 Phát triển Feature NHỎ (sửa UI, thêm field)
+| Bước | Lệnh | Mô tả |
+|------|-------|-------|
+| 1 | `/evnict-kit:feature-small "mô tả"` | Query wiki → plan nhanh |
+| 2 | `/evnict-kit:implement` | TDD implement |
+| 3 | `/evnict-kit:wiki-archive-feature` | Nạp wiki (nếu > 20 dòng) |
+
+---
+
+### 🐛 Sửa Bug
+| Bước | Lệnh | Mô tả |
+|------|-------|-------|
+| 1 | `/evnict-kit:bug-fix "mô tả bug"` | Query wiki → classify → TDD fix |
+| 2 | `/evnict-kit:wiki-archive-feature` | Nạp wiki (tùy chọn) |
+
+---
+
+### 🔒 Kiểm tra / Fix ATTT
+| Bước | Lệnh | Mô tả |
+|------|-------|-------|
+| 1 | `/evnict-kit:attt --scan` | Quét toàn bộ project |
+| 2 | `/evnict-kit:attt "module"` | Check module cụ thể |
+| 3 | Wiki tự động push | ATTT fix luôn nạp wiki |
+
+---
+
+### 📚 Wiki — Quản lý Tri thức
+| Lệnh | Khi nào |
+|-------|---------|
+| `/evnict-kit:wiki-query "từ khóa"` | Tìm thông tin trước khi làm task |
+| `/evnict-kit:wiki-archive-feature` | Nạp tri thức sau khi xong feature |
+| `/evnict-kit:wiki-scan-project` | Scan code → nạp wiki (lần đầu) |
+| `/evnict-kit:init-wiki` | Setup wiki repo |
+
+---
+
+### 🤝 Handoff — Trao đổi giữa BE↔FE
+| Lệnh | Khi nào |
+|-------|---------|
+| `/evnict-kit:handoff` | BE xong API → chuyển cho FE |
+| Đọc `handoff.md` | FE mở project → đọc yêu cầu từ BE |
+
+---
+
+### 👀 Review + Merge
+| Lệnh | Khi nào |
+|-------|---------|
+| `/evnict-kit:review` | Trước khi merge PR |
+| `/evnict-kit:finish-branch` | Merge/PR/cleanup branch (tham khảo skill) |
+
+---
+
+### 👋 Onboard Member Mới
+| Lệnh | Khi nào |
+|-------|---------|
+| `/evnict-kit:wiki-query "overview"` | Tìm hiểu project |
+| Đọc `AGENTS.md` | Context file tổng quan |
+| Đọc `GETTING-STARTED.md` | File này! |
+
+---
+
+## 📂 Cấu trúc thư mục Agent
+```
+.agent/
+├── rules/          ← 5 files: quy tắc chung, security, BE, FE, project
+├── skills/         ← 22 folders: kỹ năng cho Agent  
+├── workflows/      ← 17 files: quy trình cho từng loại công việc
+└── context/        ← Context bổ sung
+AGENTS.md           ← Context file chính (Agent đọc đầu tiên)
+Instruct-Agent-AI.md ← Hướng dẫn init rules/context
+GETTING-STARTED.md  ← File này — hướng dẫn sử dụng
+```
+
+---
+
+## ⚡ Quick Tips
+- Mọi lệnh `/evnict-kit:xxx` gõ trong Agent chat, không phải terminal
+- Agent tự biết đọc workflow file khi nhận lệnh
+- Tri thức wiki dùng chung giữa BE+FE (qua symlink)
+- Handoff dùng file `.evnict/handoff/handoff.md` — mở để xem yêu cầu từ Agent khác
+- Sau mỗi feature → nhớ nạp wiki (Agent sẽ gợi ý)
+
+---
+
+## ❓ Workflow thường dùng — Quick Ref
+
+### Luồng phát triển đầy đủ (Feature Large)
+```
+feature-large → plan → implement → handoff → review → wiki-archive-feature
+```
+
+### Luồng phát triển nhanh (Feature Small)
+```
+feature-small → implement → wiki-archive-feature (optional)
+```
+
+### Luồng sửa lỗi
+```
+bug-fix → implement fix → wiki-archive-feature (optional)
+```
+
+### Luồng ATTT
+```
+attt --scan → fix issues → re-scan → wiki (auto)
+```
+
+### Luồng setup ban đầu
+```
+evnict-kit init → init-rules → init-context → init-check → init-wiki → wiki-scan-project
+```
+
+---
+
+## 🔄 Handoff — Trao đổi giữa BE↔FE Agents
+
+### BE Agent xong → chuyển cho FE
+1. Chạy `/evnict-kit:handoff` trong project BE
+2. Agent tự sinh entry mới trong `.evnict/handoff/handoff.md`
+3. Entry có status 🔴 Chờ xử lý
+4. Chuyển sang FE project → Agent đọc `handoff.md` → implement
+
+### FE Agent xong → báo lại BE
+1. FE Agent update status entry → 🟢 Đã xử lý
+2. Điền "Kết quả xử lý" trong entry
+
+### Theo dõi trạng thái
+- 🔴 Chờ xử lý — chưa ai xử lý
+- 🟡 Đang xử lý — đang được Agent xử lý
+- 🟢 Đã xử lý — hoàn thành
+
+---
+
+## 📚 Wiki — Best Practices
+
+### Khi nào nạp wiki?
+- ✅ Sau khi xong feature lớn → `/evnict-kit:wiki-archive-feature`
+- ✅ Sau khi fix bug quan trọng → option A trong bug-fix
+- ✅ ATTT fix → tự động nạp (bắt buộc)
+- ✅ Lần đầu setup → `/evnict-kit:wiki-scan-project`
+
+### Khi nào truy vấn wiki?
+- 🔍 Trước khi bắt đầu feature mới
+- 🔍 Khi cần hiểu business rule
+- 🔍 Khi fix bug → tìm context
+- 🔍 Khi onboard member mới
+
+---
+
+## 🆘 Khi gặp vấn đề
+| Vấn đề | Giải pháp |
+|--------|-----------|
+| Agent không hiểu lệnh | Kiểm tra file workflow trong `.agent/workflows/` |
+| Wiki không truy cập được | Check symlink: `ls -la {project_name}-wiki/` |
+| Handoff không thấy | Check `.evnict/handoff/handoff.md` |
+| Muốn thêm project | Chạy `evnict-kit add <folder>` ở terminal workspace |
+| Wiki trống sau init | Chạy `/evnict-kit:wiki-scan-project` |
+| Ingest lỗi | Chạy `/evnict-kit:init-wiki` rồi thử lại |
+
+---
+
+## 📌 Phiên bản
+- **evnict-kit:** v0.2.1
+- **Ngày tạo:** {{DATE}}
+- **Project:** {{PROJECT_NAME}}