anchi-kit 2.0.3 → 2.2.0

package/src/commands/doctor.js

@@ -0,0 +1,106 @@
+// =============================================================================
+// anchi-kit Doctor Command
+// Diagnose and check setup health
+// =============================================================================
+
+const fs = require('fs');
+const path = require('path');
+
+async function doctor(targetDir = process.cwd()) {
+    console.log('');
+    console.log('🩺 anchi-kit Doctor');
+    console.log('═══════════════════════════════════════════════════════════════');
+    console.log('');
+
+    const checks = [];
+
+    // Check .cursor folder
+    const cursorDir = path.join(targetDir, '.cursor');
+    checks.push({
+        name: '.cursor folder',
+        ok: fs.existsSync(cursorDir),
+        fix: 'Run: npx anchi-kit init'
+    });
+
+    // Check commands
+    const commandsDir = path.join(cursorDir, 'commands');
+    const commandCount = fs.existsSync(commandsDir)
+        ? fs.readdirSync(commandsDir, { recursive: true }).filter(f => f.endsWith('.md')).length
+        : 0;
+    checks.push({
+        name: 'Commands',
+        ok: commandCount > 0,
+        value: `${commandCount} files`,
+        fix: 'Run: npx anchi-kit install'
+    });
+
+    // Check agents
+    const agentsDir = path.join(cursorDir, 'agents');
+    const agentCount = fs.existsSync(agentsDir)
+        ? fs.readdirSync(agentsDir).filter(f => f.endsWith('.md')).length
+        : 0;
+    checks.push({
+        name: 'Agents',
+        ok: agentCount > 0,
+        value: `${agentCount} files`,
+        fix: 'Run: npx anchi-kit install'
+    });
+
+    // Check .cursorrules
+    const rulesFile = path.join(targetDir, '.cursorrules');
+    checks.push({
+        name: '.cursorrules',
+        ok: fs.existsSync(rulesFile),
+        fix: 'Run: /use-preset [name]'
+    });
+
+    // Check config
+    const configFile = path.join(cursorDir, 'anchi-kit.config.yaml');
+    checks.push({
+        name: 'Config file',
+        ok: fs.existsSync(configFile),
+        fix: 'Run: npx anchi-kit init'
+    });
+
+    // Check docs
+    const docsDir = path.join(targetDir, 'docs');
+    checks.push({
+        name: 'Docs folder',
+        ok: fs.existsSync(docsDir),
+        fix: 'Run: npx anchi-kit install'
+    });
+
+    // Check package.json
+    const pkgFile = path.join(targetDir, 'package.json');
+    checks.push({
+        name: 'package.json',
+        ok: fs.existsSync(pkgFile),
+        fix: 'Run: npm init -y'
+    });
+
+    // Display results
+    let allOk = true;
+    for (const check of checks) {
+        const status = check.ok ? '✅' : '❌';
+        const value = check.value ? ` (${check.value})` : '';
+        console.log(`  ${status} ${check.name}${value}`);
+        if (!check.ok) {
+            console.log(`     💡 Fix: ${check.fix}`);
+            allOk = false;
+        }
+    }
+
+    console.log('');
+    console.log('═══════════════════════════════════════════════════════════════');
+
+    if (allOk) {
+        console.log('✅ All checks passed! anchi-kit is healthy.');
+    } else {
+        console.log('⚠️  Some issues found. See fixes above.');
+    }
+    console.log('');
+
+    return allOk;
+}
+
+module.exports = { doctor };

package/src/lib/configManager.js

@@ -0,0 +1,200 @@
+// =============================================================================
+// anchi-kit Config Manager
+// Handles loading, saving, and merging configuration
+// =============================================================================
+
+const fs = require('fs');
+const path = require('path');
+
+const CONFIG_FILENAME = 'anchi-kit.config.yaml';
+
+// Default configuration
+const DEFAULT_CONFIG = {
+    version: '2.1',
+    profile: 'developer',
+
+    model_preference: {
+        default: 'auto',
+        complex: 'opus',
+        economy: 'haiku',
+    },
+
+    features: {
+        auto_commit: false,
+        auto_push: false,
+        progress_indicators: true,
+        summary_cards: true,
+        quick_actions: true,
+    },
+
+    team: {
+        role: null,  // frontend, backend, fullstack, lead, etc.
+        slack_webhook: null,
+        notifications: true,
+    },
+
+    hooks: {
+        enabled: false,
+        pre_commit: [],
+        post_merge: [],
+    },
+};
+
+/**
+ * Parse simple YAML (subset)
+ */
+function parseYaml(content) {
+    const result = {};
+    const lines = content.split('\n');
+    const stack = [{ obj: result, indent: -1 }];
+
+    for (const line of lines) {
+        if (line.trim() === '' || line.trim().startsWith('#')) continue;
+
+        const match = line.match(/^(\s*)([^:]+):\s*(.*)$/);
+        if (!match) continue;
+
+        const indent = match[1].length;
+        const key = match[2].trim();
+        let value = match[3].trim();
+
+        // Pop stack until we find parent
+        while (stack.length > 1 && stack[stack.length - 1].indent >= indent) {
+            stack.pop();
+        }
+
+        const parent = stack[stack.length - 1].obj;
+
+        if (value === '' || value === null) {
+            // Nested object
+            parent[key] = {};
+            stack.push({ obj: parent[key], indent: indent });
+        } else {
+            // Parse value
+            if (value === 'true') value = true;
+            else if (value === 'false') value = false;
+            else if (value === 'null') value = null;
+            else if (!isNaN(value)) value = Number(value);
+            else if (value.startsWith('"') && value.endsWith('"')) value = value.slice(1, -1);
+            else if (value.startsWith('[') && value.endsWith(']')) {
+                value = value.slice(1, -1).split(',').map(s => s.trim());
+            }
+            parent[key] = value;
+        }
+    }
+
+    return result;
+}
+
+/**
+ * Stringify to YAML
+ */
+function stringifyYaml(obj, indent = 0) {
+    let result = '';
+    const prefix = '  '.repeat(indent);
+
+    for (const [key, value] of Object.entries(obj)) {
+        if (value === null) {
+            result += `${prefix}${key}: null\n`;
+        } else if (typeof value === 'object' && !Array.isArray(value)) {
+            result += `${prefix}${key}:\n`;
+            result += stringifyYaml(value, indent + 1);
+        } else if (Array.isArray(value)) {
+            result += `${prefix}${key}: [${value.join(', ')}]\n`;
+        } else if (typeof value === 'string') {
+            result += `${prefix}${key}: "${value}"\n`;
+        } else {
+            result += `${prefix}${key}: ${value}\n`;
+        }
+    }
+
+    return result;
+}
+
+/**
+ * Deep merge objects
+ */
+function deepMerge(target, source) {
+    const result = { ...target };
+
+    for (const key of Object.keys(source)) {
+        if (source[key] && typeof source[key] === 'object' && !Array.isArray(source[key])) {
+            result[key] = deepMerge(target[key] || {}, source[key]);
+        } else {
+            result[key] = source[key];
+        }
+    }
+
+    return result;
+}
+
+/**
+ * Load config from target directory
+ */
+function loadConfig(targetDir) {
+    const configPath = path.join(targetDir, '.cursor', CONFIG_FILENAME);
+
+    if (!fs.existsSync(configPath)) {
+        return DEFAULT_CONFIG;
+    }
+
+    try {
+        const content = fs.readFileSync(configPath, 'utf-8');
+        const userConfig = parseYaml(content);
+        return deepMerge(DEFAULT_CONFIG, userConfig);
+    } catch (e) {
+        console.warn(`Warning: Could not parse config: ${e.message}`);
+        return DEFAULT_CONFIG;
+    }
+}
+
+/**
+ * Save config to target directory
+ */
+function saveConfig(targetDir, config) {
+    const cursorDir = path.join(targetDir, '.cursor');
+    const configPath = path.join(cursorDir, CONFIG_FILENAME);
+
+    if (!fs.existsSync(cursorDir)) {
+        fs.mkdirSync(cursorDir, { recursive: true });
+    }
+
+    const header = `# anchi-kit Configuration
+# https://github.com/ANCHI-STE/anchi-webkit-dev
+# ═══════════════════════════════════════════════════════════════
+
+`;
+
+    fs.writeFileSync(configPath, header + stringifyYaml(config));
+    return configPath;
+}
+
+/**
+ * Get config value by path (e.g., 'features.auto_commit')
+ */
+function getConfigValue(config, keyPath) {
+    return keyPath.split('.').reduce((obj, key) => obj?.[key], config);
+}
+
+/**
+ * Set config value by path
+ */
+function setConfigValue(config, keyPath, value) {
+    const keys = keyPath.split('.');
+    const lastKey = keys.pop();
+    const target = keys.reduce((obj, key) => obj[key] = obj[key] || {}, config);
+    target[lastKey] = value;
+    return config;
+}
+
+module.exports = {
+    DEFAULT_CONFIG,
+    CONFIG_FILENAME,
+    loadConfig,
+    saveConfig,
+    parseYaml,
+    stringifyYaml,
+    deepMerge,
+    getConfigValue,
+    setConfigValue,
+};

package/docs/PROJECT_SUMMARY.md

@@ -1,86 +0,0 @@
-# 📋 Project Summary - Executive View
-
-> **Auto-generated by `/summary`** | Last updated: [DATE]
-> 
-> 🎯 Quick overview for stakeholders. Chi tiết xem files bên dưới.
-
----
-
-## 🎯 Project At a Glance
-
-| Field | Value |
-|-------|-------|
-| **Name** | [Project Name] |
-| **Status** | ⬜ Dev / 🔄 Staging / ✅ Production |
-| **Version** | [0.0.0] |
-| **Preset** | 🚀 Rapid / 🏢 Professional / 🏛️ Enterprise |
-
-**Description:** [Mô tả 1 câu về dự án]
-
----
-
-## � Progress Overview
-
-| Total Features | Done | In Progress | Planned |
-|----------------|------|-------------|---------|
-| [X] | [X] ✅ | [X] 🔄 | [X] ⬜ |
-
-### Current Sprint/Milestone
-- 🎯 **Goal:** [Current goal]
-- 📅 **Deadline:** [Date]
-- 📈 **Progress:** [X%]
-
----
-
-## � Quick Links
-
-| Resource | Link |
-|----------|------|
-| 📖 **Planning Details** | [project-overview-pdr.md](./project-overview-pdr.md) |
-| 💻 **Technical Details** | [codebase-summary.md](./codebase-summary.md) |
-| �️ **Roadmap** | [project-roadmap.md](./project-roadmap.md) |
-| 📏 **Code Standards** | [code-standards.md](./code-standards.md) |
-| 🏗️ **Architecture** | [system-architecture.md](./system-architecture.md) |
-
----
-
-## 📈 Key Metrics
-
-| Metric | Value | Target |
-|--------|-------|--------|
-| Features Done | [X/Y] | 100% |
-| Test Coverage | [X%] | 80% |
-| API Endpoints | [X] | - |
-| DB Models | [X] | - |
-
----
-
-## � Blockers & Risks
-
-| Issue | Impact | Owner |
-|-------|--------|-------|
-| [Blocker 1] | High | [Name] |
-| [Risk 1] | Medium | [Name] |
-
----
-
-## 👥 Contacts
-
-| Role | Person |
-|------|--------|
-| Team Lead | [Name] |
-| Tech Lead | [Name] |
-
----
-
-## 📝 Recent Updates
-
-| Date | Update |
-|------|--------|
-| [Date] | [Summary] |
-
----
-
-> 💡 **Navigation:**
-> - **Planning (WHY/WHAT):** [project-overview-pdr.md](./project-overview-pdr.md)
-> - **Technical (HOW):** [codebase-summary.md](./codebase-summary.md)