evnict-kit 0.2.1

package/README.md

@@ -0,0 +1,19 @@
+# EVNICT-KIT v0.1.2
+
+> Bộ công cụ hỗ trợ PTPM với AI — theo QĐ-TTPM
+> Tích hợp OpenSpec (SDD) + TDD Workflow + LLM Wiki
+
+## Quick Start
+
+```bash
+npm install -g evnict-kit
+cd /path/to/workspace       # chứa cmis-be/ và cmis-fe/
+evnict-kit init --name=cmis --be=cmis-be --fe=cmis-fe
+```
+
+Mở AI Agent trong cmis-be/ → chạy: /evnict-kit:init-rules
+
+## Multi-tool: --tool=antigravity|claude|cursor|copilot|codex
+
+## Stats: 35 rules | 20 skills | 10 workflows
+## License: UNLICENSED (EVNICT internal)

package/bin/cli.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { initCommand } from '../src/commands/init.js';
+import { addCommand } from '../src/commands/add.js';
+import { initRulesCommand } from '../src/commands/init-rules.js';
+import { initContextCommand } from '../src/commands/init-context.js';
+import { initWorkflowCommand } from '../src/commands/init-workflow.js';
+import { initCheckCommand } from '../src/commands/init-check.js';
+
+const program = new Command();
+program.name('evnict-kit').description('EVNICT AI-Assisted Development Toolkit v0.2.1').version('0.2.1');
+
+program.command('init')
+  .description('Khởi tạo workspace + deploy rules/skills/workflows vào từng project (interactive hoặc flags)')
+  .option('--name <n>', 'Tên dự án (nếu bỏ qua → interactive wizard)')
+  .option('--be <folder>', 'Folder backend (default: <n>-be)')
+  .option('--fe <folder>', 'Folder frontend (default: <n>-fe)')
+  .option('--tool <tool>', 'AI tool: antigravity|claude|cursor|copilot|codex', 'antigravity')
+  .option('--tech-be <tech>', 'springboot|aspnet|javaee', 'springboot')
+  .option('--tech-fe <tech>', 'angular|react-web|react-mobile', 'angular')
+  .option('--db <db>', 'oracle|sqlserver', 'oracle')
+  .option('--no-wiki', 'Không setup wiki')
+  .option('--no-interactive', 'Bắt buộc chạy non-interactive (cần --name)')
+  .action(initCommand);
+
+program.command('add <folder>')
+  .description('Thêm 1 project vào workspace đã init (deploy rules/skills/workflows + symlinks)')
+  .option('--type <type>', 'backend|frontend')
+  .option('--tech <tech>', 'springboot|angular|react-web|react-mobile|aspnet')
+  .option('--tool <tool>', 'AI tool override')
+  .action(addCommand);
+
+program.command('init-rules').description('Scaffold rules vào từng project (theo --tool)').option('--tool <tool>','','antigravity').action(initRulesCommand);
+program.command('init-context').description('Scaffold context files vào từng project').option('--tool <tool>','','antigravity').action(initContextCommand);
+program.command('init-workflow').description('Scaffold workflows & skills vào từng project').option('--tool <tool>','','antigravity').action(initWorkflowCommand);
+program.command('init-check').description('Chuẩn bị demo-check directory').option('--tool <tool>','','antigravity').action(initCheckCommand);
+
+program.parse();

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "evnict-kit",
+  "version": "0.2.1",
+  "description": "EVNICT AI-Assisted Development Toolkit - Bộ công cụ hỗ trợ phát triển phần mềm với AI theo quy định QĐ-TTPM",
+  "type": "module",
+  "bin": {
+    "evnict-kit": "./bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "templates/",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "node test/test.js",
+    "link": "npm link"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "js-yaml": "^4.1.0"
+  },
+  "keywords": [
+    "evnict",
+    "evn",
+    "ai",
+    "development",
+    "toolkit",
+    "coding-agent"
+  ],
+  "author": "EVNICT - Trung tâm Phát triển Phần mềm",
+  "thirdPartyLicenses": {
+    "llm-wiki": {
+      "version": "1.0.0",
+      "license": "MIT",
+      "repository": "https://github.com/mduongvandinh/llm-wiki",
+      "note": "Minimal scaffold bundled in templates/wiki/"
+    }
+  },
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/NhanVAT/evnict-kit"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/commands/add.js

@@ -0,0 +1,129 @@
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import readline from 'node:readline';
+import yaml from 'js-yaml';
+import { deployToProject, createSymlinks, updateGitignore, detectTech } from './init.js';
+import { loadConfig, getToolMap, TECH_LABELS, TECH_TYPE_HINTS, SUPPORTED_TOOLS } from '../utils/config.js';
+
+/**
+ * evnict-kit add <folder>
+ * Thêm 1 project vào workspace đã init — deploy rules/skills/workflows + tạo symlinks
+ */
+export async function addCommand(folder, options) {
+  const cwd = process.cwd();
+
+  // Load existing config
+  const config = loadConfig(cwd);
+  if (!config) {
+    console.error('❌ Không tìm thấy .evnict/config.yaml. Chạy evnict-kit init trước.');
+    process.exit(1);
+  }
+
+  const name = config.project?.name;
+  if (!name) {
+    console.error('❌ config.yaml thiếu project.name.');
+    process.exit(1);
+  }
+
+  // Check if folder exists
+  const projectPath = join(cwd, folder);
+  if (!existsSync(projectPath)) {
+    console.error(`❌ Folder "${folder}" không tồn tại trong workspace.`);
+    process.exit(1);
+  }
+
+  // Check if already in config
+  const existing = config.repos?.find(r => r.folder === folder);
+  if (existing) {
+    console.log(`⚠️  "${folder}" đã có trong config.yaml (type: ${existing.type}). Deploy lại...`);
+  }
+
+  // Detect tech
+  const detectedTech = detectTech(projectPath);
+  const techLabel = detectedTech ? TECH_LABELS[detectedTech] || detectedTech : 'unknown';
+  console.log(`\n📂 Folder: ${folder} (detected: ${techLabel})`);
+
+  // Determine type and tech
+  let type = options.type;
+  let tech = options.tech || detectedTech;
+  const tool = options.tool || config.ai_tool || 'antigravity';
+
+  if (!SUPPORTED_TOOLS.includes(tool)) {
+    console.error(`❌ Tool "${tool}" chưa có templates.`);
+    process.exit(1);
+  }
+
+  // If type/tech not provided via flags, ask interactively
+  if (!type) {
+    const suggestedType = detectedTech ? (TECH_TYPE_HINTS[detectedTech] || 'backend') : 'backend';
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    const ask = (q) => new Promise(r => rl.question(q, r));
+
+    const typeInput = (await ask(`? Loại cho ${folder} (${techLabel}) [${suggestedType}]: `)).trim();
+    type = typeInput || suggestedType;
+
+    if (!tech) {
+      const defaultTech = type === 'backend' ? 'springboot' : 'angular';
+      const techInput = (await ask(`? Tech stack [${defaultTech}]: `)).trim();
+      tech = techInput || defaultTech;
+    }
+
+    rl.close();
+  }
+
+  type = type || 'backend';
+  tech = tech || (type === 'backend' ? 'springboot' : 'angular');
+  const db = config.database?.type || 'oracle';
+  const toolMap = getToolMap(tool);
+
+  console.log(`\n🚀 Deploying evnict-kit vào ${folder} (${type}/${TECH_LABELS[tech] || tech})...\n`);
+
+  // Build allRepos (existing + new)
+  const allRepos = [...(config.repos || [])];
+  if (!existing) {
+    allRepos.push({ folder, type, tech });
+  }
+
+  // Deploy
+  deployToProject(projectPath, cwd, {
+    tool, toolMap, name, type, tech, db,
+    allRepos,
+  });
+
+  // Symlinks
+  createSymlinks(projectPath, cwd, name);
+
+  // Update .gitignore
+  updateGitignore(projectPath, name);
+
+  // Update config.yaml — add new repo
+  if (!existing) {
+    const configPath = join(cwd, '.evnict', 'config.yaml');
+    const rawConfig = yaml.load(readFileSync(configPath, 'utf8'));
+
+    // Ensure repos is array (migration)
+    if (!Array.isArray(rawConfig.repos)) {
+      // Convert old format
+      const repos = [];
+      if (rawConfig.repos?.backend) repos.push({ folder: rawConfig.repos.backend.folder, type: 'backend', tech: rawConfig.repos.backend.tech });
+      if (rawConfig.repos?.frontend) repos.push({ folder: rawConfig.repos.frontend.folder, type: 'frontend', tech: rawConfig.repos.frontend.tech });
+      rawConfig.repos = repos;
+    }
+
+    rawConfig.repos.push({ folder, type, tech });
+    writeFileSync(configPath, yaml.dump(rawConfig, { lineWidth: -1 }), 'utf8');
+    console.log(`\n   ✅ config.yaml updated — added ${folder}`);
+  }
+
+  console.log(`
+╔═══════════════════════════════════════════════════════╗
+║  ✅  "${folder}" added to workspace "${name}"!         ║
+╠═══════════════════════════════════════════════════════╣
+║                                                       ║
+║  📋 Next: Mở AI Agent trong ${folder}/                ║
+║     /evnict-kit:init-rules  → điền rules              ║
+║     /evnict-kit:init-context → sinh context file       ║
+║                                                       ║
+╚═══════════════════════════════════════════════════════╝
+`);
+}

package/src/commands/init-check.js

@@ -0,0 +1,19 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { ensureDir, writeFile } from '../utils/file.js';
+import { mergeWithConfig, getToolMap } from '../utils/config.js';
+
+export async function initCheckCommand(options) {
+  const cwd = process.cwd();
+  const opts = mergeWithConfig(options, cwd);
+  const toolMap = getToolMap(opts.tool || 'antigravity');
+
+  console.log('\n🔍 EVNICT-KIT v0.1.2: Init Check\n');
+  const projects = [opts.be, opts.fe].filter(f => f && existsSync(join(cwd, f)));
+  for (const folder of projects) {
+    const checkDir = join(cwd, folder, toolMap.agentDir, 'demo-check');
+    ensureDir(checkDir, cwd);
+    writeFile(join(checkDir, 'REVIEW.md'), `# Demo Check — ${folder}\nChạy /evnict-kit:init-check trong Agent để sinh demo code.\n\n## Checklist\n- [ ] Naming convention đúng?\n- [ ] Package structure đúng?\n- [ ] API format đúng?\n- [ ] Error handling đúng?\n- [ ] Test pattern đúng?\n`, { cwd, overwrite: true });
+  }
+  console.log('\n✅ Demo-check prepared. Mở Agent → /evnict-kit:init-check\n');
+}

package/src/commands/init-context.js

@@ -0,0 +1,37 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { ensureDir, writeFile, TEMPLATES_DIR } from '../utils/file.js';
+import { mergeWithConfig, getToolMap, TECH_LABELS } from '../utils/config.js';
+
+export async function initContextCommand(options) {
+  const cwd = process.cwd();
+  const opts = mergeWithConfig(options, cwd);
+  const tool = opts.tool || 'antigravity';
+  const toolMap = getToolMap(tool);
+
+  console.log(`\n📋 EVNICT-KIT v0.1.2: Scaffold Context (tool: ${tool})\n`);
+
+  const evnictDir = join(cwd, '.evnict');
+  if (!existsSync(evnictDir)) { console.error('❌ Chạy "evnict-kit init" trước.'); process.exit(1); }
+
+  const ctxMap = { antigravity:'AGENT.md.template', claude:'CLAUDE.md.template', cursor:'cursorrules.template', copilot:'AGENT.md.template', codex:'AGENT.md.template' };
+  const projects = [
+    { folder: opts.be, tech: opts.techBe, type: 'backend' },
+    { folder: opts.fe, tech: opts.techFe, type: 'frontend' },
+  ];
+
+  for (const { folder, tech, type } of projects) {
+    if (!folder || !existsSync(join(cwd, folder))) continue;
+    console.log(`── ${folder} ──`);
+    const tplPath = join(TEMPLATES_DIR, 'context', ctxMap[tool]);
+    if (existsSync(tplPath)) {
+      let content = readFileSync(tplPath, 'utf8')
+        .replaceAll('{{PROJECT_NAME}}', opts.name || '')
+        .replaceAll('{{TECH_STACK}}', TECH_LABELS[tech] || tech)
+        .replaceAll('{{DATABASE}}', TECH_LABELS[opts.db] || opts.db || '');
+      writeFile(join(cwd, folder, toolMap.contextFile), content, { cwd });
+    }
+    ensureDir(join(cwd, folder, toolMap.contextDir), cwd);
+  }
+  console.log('\n✅ Context scaffolded. Next: mở Agent → /evnict-kit:init-context\n');
+}

package/src/commands/init-rules.js

@@ -0,0 +1,42 @@
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { ensureDir, copyTemplateDir, writeFile, TEMPLATES_DIR } from '../utils/file.js';
+import { mergeWithConfig, getToolMap } from '../utils/config.js';
+
+export async function initRulesCommand(options) {
+  const cwd = process.cwd();
+  const opts = mergeWithConfig(options, cwd);
+  const tool = opts.tool || 'antigravity';
+  const toolMap = getToolMap(tool);
+
+  console.log(`\n📏 EVNICT-KIT v0.1.2: Scaffold Rules (tool: ${tool})\n`);
+
+  // Detect if we're inside a project or workspace
+  const evnictDir = join(cwd, '.evnict');
+  if (!existsSync(evnictDir)) {
+    console.error('❌ Chưa init workspace. Chạy "evnict-kit init" trước.');
+    process.exit(1);
+  }
+
+  // Read config to find project folders
+  const config = opts;
+  const projects = [];
+  if (config.be && existsSync(join(cwd, config.be))) projects.push({ folder: config.be, cats: ['common','backend','security','project'] });
+  if (config.fe && existsSync(join(cwd, config.fe))) projects.push({ folder: config.fe, cats: ['common','frontend','security','project'] });
+
+  for (const { folder, cats } of projects) {
+    console.log(`\n── ${folder} ──`);
+    for (const cat of cats) {
+      const src = join(TEMPLATES_DIR, 'rules', cat);
+      const dest = join(cwd, folder, toolMap.rulesDir, cat);
+      if (existsSync(src)) {
+        ensureDir(dest, cwd);
+        copyTemplateDir(src, dest, cwd);
+      }
+    }
+    const idxSrc = join(TEMPLATES_DIR, 'rules', 'INDEX.md');
+    if (existsSync(idxSrc)) writeFile(join(cwd, folder, toolMap.rulesDir, 'INDEX.md'), readFileSync(idxSrc,'utf8'), {cwd, overwrite:true});
+  }
+
+  console.log('\n✅ Rules deployed. Next: mở Agent → /evnict-kit:init-rules\n');
+}

package/src/commands/init-workflow.js

@@ -0,0 +1,36 @@
+import { existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { ensureDir, copyTemplateDir, TEMPLATES_DIR } from '../utils/file.js';
+import { mergeWithConfig, getToolMap } from '../utils/config.js';
+
+export async function initWorkflowCommand(options) {
+  const cwd = process.cwd();
+  const opts = mergeWithConfig(options, cwd);
+  const tool = opts.tool || 'antigravity';
+  const toolMap = getToolMap(tool);
+
+  console.log(`\n🔄 EVNICT-KIT v0.1.2: Scaffold Workflows & Skills (tool: ${tool})\n`);
+
+  const projects = [opts.be, opts.fe].filter(f => f && existsSync(join(cwd, f)));
+  for (const folder of projects) {
+    console.log(`── ${folder} ──`);
+    // Workflows
+    for (const cat of ['init','work']) {
+      const src = join(TEMPLATES_DIR, 'workflows', cat);
+      const dest = join(cwd, folder, toolMap.workflowsDir, cat);
+      if (existsSync(src)) { ensureDir(dest,cwd); copyTemplateDir(src,dest,cwd); }
+    }
+    // Skills
+    const skillsSrc = join(TEMPLATES_DIR, 'skills');
+    if (existsSync(skillsSrc)) {
+      for (const d of readdirSync(skillsSrc, {withFileTypes:true})) {
+        if (d.isDirectory()) {
+          const dest = join(cwd, folder, toolMap.skillsDir, d.name);
+          ensureDir(dest,cwd);
+          copyTemplateDir(join(skillsSrc,d.name), dest, cwd);
+        }
+      }
+    }
+  }
+  console.log('\n✅ Workflows + Skills deployed.\n');
+}