thanh-kit 2.5.0

package/templates/hooks/README.md

@@ -0,0 +1,246 @@
+# ⚡ Hooks - Tự Động Hóa Theo Sự Kiện
+
+## Hooks là gì?
+
+**Hooks** là các "trigger tự động" - code sẽ tự chạy khi có sự kiện nhất định xảy ra. Giống như cài báo thức vậy - đến giờ thì tự động reo, không cần bạn bấm gì.
+
+**Ví dụ đơn giản:**
+- Khi **bắt đầu session** → Tự động chào và kiểm tra trạng thái dự án
+- Khi **sửa file** → Tự động format code (Prettier)
+- Khi **hoàn thành task** → Tự động review lại code
+- Khi **kết thúc session** → Tự động ghi log công việc
+
+---
+
+## Danh Sách Hooks
+
+### 🟢 Hooks Khởi Động
+
+| Hook | Chạy Khi Nào | Làm Gì |
+|------|--------------|--------|
+| **session-init.cjs** | Bắt đầu session mới | Load context, kiểm tra dự án |
+| **subagent-init.cjs** | Khởi tạo subagent | Chuẩn bị context cho subagent |
+
+### 📝 Hooks Khi Sửa File
+
+| Hook | Chạy Khi Nào | Làm Gì |
+|------|--------------|--------|
+| **post-edit-prettier.cjs** | Sau khi sửa file | Format code bằng Prettier |
+| **write-compact-marker.cjs** | Khi ghi file | Đánh dấu compact writes |
+
+### 🔍 Hooks Review & Kiểm Tra
+
+| Hook | Chạy Khi Nào | Làm Gì |
+|------|--------------|--------|
+| **post-task-review.cjs** | Sau khi hoàn thành task | Tự động review code |
+| **workflow-router.cjs** | Khi cần chọn workflow | Định tuyến đến workflow phù hợp |
+| **dev-rules-reminder.cjs** | Khi code | Nhắc nhở quy tắc phát triển |
+
+### 🔒 Hooks Bảo Mật
+
+| Hook | Chạy Khi Nào | Làm Gì |
+|------|--------------|--------|
+| **privacy-block.cjs** | Khi truy cập dữ liệu | Chặn truy cập dữ liệu nhạy cảm |
+| **scout-block.cjs** | Khi tìm kiếm | Chặn tìm kiếm vào vùng cấm |
+
+### 📚 Hooks Context
+
+| Hook | Chạy Khi Nào | Làm Gì |
+|------|--------------|--------|
+| **backend-csharp-context.cjs** | Làm việc với C# | Load context cho C# |
+| **frontend-typescript-context.cjs** | Làm việc với TypeScript | Load context cho TS |
+| **design-system-context.cjs** | Thiết kế UI | Load design system |
+| **scss-styling-context.cjs** | Làm với SCSS | Load SCSS context |
+
+### 📢 Hooks Thông Báo
+
+| Hook | Chạy Khi Nào | Làm Gì |
+|------|--------------|--------|
+| **notify-waiting.js** | AI đang chờ input | Gửi thông báo cho user |
+| **session-end.cjs** | Kết thúc session | Ghi log, dọn dẹp |
+
+---
+
+## Cách Hooks Hoạt Động
+
+### Luồng hoạt động
+
+```
+   Sự kiện xảy ra (ví dụ: sửa file)
+              ↓
+   Hệ thống kiểm tra có hook nào cần chạy
+              ↓
+┌─────────────────────────────────┐
+│  Hook được kích hoạt            │
+│  (post-edit-prettier.cjs)       │
+│                                 │
+│  1. Nhận thông tin file         │
+│  2. Chạy Prettier format        │
+│  3. Lưu file đã format          │
+└─────────────────────────────────┘
+              ↓
+   Tiếp tục công việc bình thường
+```
+
+### Ví dụ cụ thể
+
+**Bạn sửa file `App.tsx`:**
+
+```
+1. Bạn lưu file
+2. Hook post-edit-prettier.cjs tự động chạy
+3. Prettier format lại code
+4. File được cập nhật với format chuẩn
+```
+
+Bạn không cần làm gì - tất cả tự động!
+
+---
+
+## Cấu Trúc Thư Mục Hooks
+
+```
+hooks/
+├── session-init.cjs            ← Khởi động session
+├── session-end.cjs             ← Kết thúc session
+├── post-edit-prettier.cjs      ← Format sau khi edit
+├── post-task-review.cjs        ← Review sau task
+├── workflow-router.cjs         ← Định tuyến workflow
+├── privacy-block.cjs           ← Bảo vệ privacy
+├── scout-block.cjs             ← Chặn tìm kiếm cấm
+├── dev-rules-reminder.cjs      ← Nhắc quy tắc
+├── notify-waiting.js           ← Thông báo chờ
+│
+├── lib/                        ← Thư viện dùng chung
+│   └── helpers.js
+│
+├── notifications/              ← Cấu hình thông báo
+│   └── config.json
+│
+├── docs/                       ← Tài liệu hooks
+│   └── how-to-create.md
+│
+└── tests/                      ← Tests cho hooks
+    └── *.test.js
+```
+
+---
+
+## Hooks Quan Trọng Nhất
+
+### 1. session-init.cjs - Khởi Động Session
+
+**Chạy khi:** Bạn bắt đầu làm việc với Claude
+
+**Làm gì:**
+- Đọc context dự án
+- Load settings
+- Kiểm tra có task dang dở không
+- Chào bạn và tóm tắt trạng thái
+
+---
+
+### 2. post-edit-prettier.cjs - Auto Format
+
+**Chạy khi:** Bạn sửa file code
+
+**Làm gì:**
+- Phát hiện loại file (JS, TS, CSS...)
+- Chạy Prettier với config phù hợp
+- Lưu file đã format
+
+**Lợi ích:** Code luôn format chuẩn, không cần manual format
+
+---
+
+### 3. post-task-review.cjs - Auto Review
+
+**Chạy khi:** Hoàn thành một task
+
+**Làm gì:**
+- Review code vừa viết
+- Check conventions
+- Báo cáo nếu có vấn đề
+
+**Lợi ích:** Phát hiện lỗi sớm, trước khi commit
+
+---
+
+### 4. privacy-block.cjs - Bảo Vệ Dữ Liệu
+
+**Chạy khi:** AI truy cập files
+
+**Làm gì:**
+- Kiểm tra file có nhạy cảm không (.env, secrets...)
+- Chặn truy cập nếu cấm
+- Log các truy cập
+
+**Lợi ích:** Bảo vệ dữ liệu nhạy cảm
+
+---
+
+## Tạo Hook Mới
+
+Nếu muốn tạo hook riêng:
+
+**1. Tạo file trong thư mục hooks:**
+```
+hooks/my-custom-hook.cjs
+```
+
+**2. Viết code hook:**
+```javascript
+// hooks/my-custom-hook.cjs
+
+module.exports = {
+  // Tên hook
+  name: 'my-custom-hook',
+  
+  // Chạy khi nào
+  trigger: 'post-edit', // hoặc 'pre-edit', 'session-start'...
+  
+  // Logic xử lý
+  async run(context) {
+    // Lấy thông tin file vừa sửa
+    const { filePath, content } = context;
+    
+    // Làm gì đó
+    console.log(`File ${filePath} đã được sửa`);
+    
+    // Trả về kết quả (nếu cần)
+    return { success: true };
+  }
+};
+```
+
+**3. Đăng ký hook** (trong settings.json)
+
+---
+
+## Tóm Tắt
+
+| Khái niệm | Giải thích |
+|-----------|------------|
+| **Hook là gì** | Code tự động chạy khi có sự kiện |
+| **Có bao nhiêu** | ~15 hooks có sẵn |
+| **Khi nào chạy** | Tự động theo trigger (edit, save, session start...) |
+| **Có thể tạo thêm** | Có, theo template trên |
+
+---
+
+## Lợi Ích Của Hooks
+
+| Không có Hooks | Có Hooks |
+|----------------|----------|
+| Phải manual format code | ✅ Tự động format |
+| Quên review trước commit | ✅ Tự động review |
+| Context bị mất giữa sessions | ✅ Tự động load context |
+| Có thể truy cập file nhạy cảm | ✅ Tự động chặn |
+
+---
+
+## Xem Thêm
+
+- [Scripts (Công cụ)](../scripts/README.md)
+- [Workflows (Quy trình)](../workflows/README.md)
+- [Settings (Cấu hình)](../settings.json)

package/templates/hooks/backend-csharp-context.cjs

@@ -0,0 +1,223 @@
+#!/usr/bin/env node
+/**
+ * Backend C# Context Injector - PreToolUse Hook
+ *
+ * Automatically injects backend C# development guide when editing
+ * .cs files in backend services. Uses file path patterns to detect
+ * backend service files.
+ *
+ * Pattern Matching:
+ *   src/PlatformExampleApp/*        → Example/reference app
+ *   src/Platform/*                  → Easy.Platform framework
+ *
+ * Exit Codes:
+ *   0 - Success (non-blocking)
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// ═══════════════════════════════════════════════════════════════════════════
+// CONFIGURATION
+// ═══════════════════════════════════════════════════════════════════════════
+
+const BACKEND_GUIDE_PATH = 'docs/claude/backend-csharp-complete-guide.md';
+
+const BACKEND_PATTERNS = [
+  {
+    name: 'Example App',
+    patterns: [
+      /src[\/\\]PlatformExampleApp[\/\\]/i
+    ],
+    description: 'Platform example/reference application (TextSnippet)'
+  },
+  {
+    name: 'Platform Framework',
+    patterns: [
+      /src[\/\\]Platform[\/\\]/i
+    ],
+    description: 'Easy.Platform framework core'
+  }
+];
+
+// Service-specific patterns for more detailed guidance
+const SERVICE_PATTERNS = {
+  'TextSnippet': /PlatformExampleApp[\/\\].*TextSnippet/i
+};
+
+// ═══════════════════════════════════════════════════════════════════════════
+// HELPER FUNCTIONS
+// ═══════════════════════════════════════════════════════════════════════════
+
+/**
+ * Check if backend context was recently injected
+ * Reads the transcript to avoid duplicate injections
+ */
+function wasRecentlyInjected(transcriptPath) {
+  try {
+    if (!transcriptPath || !fs.existsSync(transcriptPath)) return false;
+    const transcript = fs.readFileSync(transcriptPath, 'utf-8');
+    // Check last 200 lines for recent injection
+    const recentLines = transcript.split('\n').slice(-200).join('\n');
+    return recentLines.includes('**Backend C# Context Detected**');
+  } catch (e) {
+    return false;
+  }
+}
+
+function isCSharpFile(filePath) {
+  if (!filePath) return false;
+  return path.extname(filePath).toLowerCase() === '.cs';
+}
+
+function detectBackendContext(filePath) {
+  if (!filePath) return null;
+
+  // Normalize path separators
+  const normalizedPath = filePath.replace(/\\/g, '/');
+
+  for (const context of BACKEND_PATTERNS) {
+    for (const pattern of context.patterns) {
+      if (pattern.test(normalizedPath)) {
+        return context;
+      }
+    }
+  }
+
+  return null;
+}
+
+function detectService(filePath) {
+  if (!filePath) return null;
+
+  const normalizedPath = filePath.replace(/\\/g, '/');
+
+  for (const [serviceName, pattern] of Object.entries(SERVICE_PATTERNS)) {
+    if (pattern.test(normalizedPath)) {
+      return serviceName;
+    }
+  }
+
+  return null;
+}
+
+function shouldInject(filePath, transcriptPath) {
+  // Skip non-C# files
+  if (!isCSharpFile(filePath)) return false;
+
+  // Skip if no backend context detected
+  const context = detectBackendContext(filePath);
+  if (!context) return false;
+
+  // Skip if already injected recently
+  if (wasRecentlyInjected(transcriptPath)) return false;
+
+  return true;
+}
+
+function buildInjection(context, filePath, service) {
+  const fileName = path.basename(filePath);
+
+  const lines = [
+    '',
+    '## Backend C# Context Detected',
+    '',
+    `**Context:** ${context.name}`,
+    `**File:** ${fileName}`,
+    service ? `**Service:** ${service}` : '',
+    '',
+    '### Required Reading',
+    '',
+    `Before implementing backend changes, you MUST read:`,
+    '',
+    `**\`${BACKEND_GUIDE_PATH}\`**`,
+    '',
+    'This guide contains:',
+    '- SOLID, DRY, KISS, YAGNI principles with code examples',
+    '- Repository patterns (use IPlatformQueryableRootRepository<T, TKey>)',
+    '- CQRS Command/Query patterns (Command + Result + Handler in ONE file)',
+    '- Entity, DTO, and Validation patterns (PlatformValidationResult fluent API)',
+    '- Event-driven architecture (side effects in Entity Event Handlers)',
+    '- Background jobs and data migrations',
+    '',
+    '### Critical Rules',
+    '',
+    '1. **Repository:** Use `IPlatformQueryableRootRepository<T, TKey>` - the platform standard',
+    '2. **Validation:** Use `PlatformValidationResult` fluent API - NEVER throw ValidationException',
+    '3. **Side Effects:** Handle in `UseCaseEvents/` event handlers - NEVER in command handlers',
+    '4. **DTO Mapping:** DTOs own mapping via `PlatformEntityDto.MapToEntity()` - NEVER map in handlers',
+    '5. **Cross-Service:** Use message bus - NEVER direct database access',
+    ''
+  ];
+
+  // Add service-specific guidance
+  if (service) {
+    lines.push(
+      '### Service-Specific Notes',
+      '',
+      `Working in **${service}** service:`,
+      ''
+    );
+
+    if (service.includes('TextSnippet')) {
+      lines.push(
+        '- Use `IPlatformQueryableRootRepository<T, TKey>` for all entities',
+        '- Example text snippet management domain',
+        ''
+      );
+    }
+  }
+
+  // Filter out empty lines from middle
+  return lines.filter((line, i, arr) => {
+    if (line === '' && arr[i - 1] === '') return false;
+    return true;
+  }).join('\n');
+}
+
+// ═══════════════════════════════════════════════════════════════════════════
+// MAIN EXECUTION
+// ═══════════════════════════════════════════════════════════════════════════
+
+async function main() {
+  try {
+    const stdin = fs.readFileSync(0, 'utf-8').trim();
+    if (!stdin) process.exit(0);
+
+    const payload = JSON.parse(stdin);
+    const toolName = payload.tool_name || '';
+    const toolInput = payload.tool_input || {};
+    const transcriptPath = payload.transcript_path || '';
+
+    // Only process Edit, Write, MultiEdit tools
+    if (!['Edit', 'Write', 'MultiEdit'].includes(toolName)) {
+      process.exit(0);
+    }
+
+    // Extract file path from tool input
+    const filePath = toolInput.file_path || toolInput.filePath || '';
+    if (!filePath) process.exit(0);
+
+    // Check if we should inject
+    if (!shouldInject(filePath, transcriptPath)) {
+      process.exit(0);
+    }
+
+    // Detect context and service
+    const context = detectBackendContext(filePath);
+    if (!context) process.exit(0);
+
+    const service = detectService(filePath);
+
+    // Output the injection
+    const injection = buildInjection(context, filePath, service);
+    console.log(injection);
+
+    process.exit(0);
+  } catch (error) {
+    // Non-blocking - just exit silently
+    process.exit(0);
+  }
+}
+
+main();

package/templates/hooks/design-system-context.cjs

@@ -0,0 +1,185 @@
+#!/usr/bin/env node
+/**
+ * Design System Context Injector - PreToolUse Hook
+ *
+ * Automatically injects design system documentation guidance when editing
+ * frontend files. Uses file path patterns to select the appropriate guide.
+ *
+ * Pattern Matching:
+ *   src/PlatformExampleAppWeb/*    → WebV2DesignSystem.md (Angular 19 example app)
+ *
+ * Exit Codes:
+ *   0 - Success (non-blocking)
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// ═══════════════════════════════════════════════════════════════════════════
+// CONFIGURATION
+// ═══════════════════════════════════════════════════════════════════════════
+
+const DESIGN_SYSTEM_DOCS_PATH = 'docs/design-system';
+
+const APP_PATTERNS = [
+  {
+    name: 'PlatformExampleAppWeb',
+    patterns: [
+      /src[\/\\]PlatformExampleAppWeb[\/\\]/i,
+      /libs[\/\\]apps-domains[\/\\]/i,
+      /libs[\/\\]platform-core[\/\\]/i
+    ],
+    docFile: 'WebV2DesignSystem.md',
+    description: 'Angular 19 standalone components with shared-mixin SCSS'
+  }
+];
+
+// File extensions that indicate frontend files
+const FRONTEND_EXTENSIONS = [
+  '.html', '.htm',
+  '.scss', '.css', '.less', '.sass',
+  '.ts', '.tsx', '.js', '.jsx',
+  '.vue', '.svelte'
+];
+
+// ═══════════════════════════════════════════════════════════════════════════
+// HELPER FUNCTIONS
+// ═══════════════════════════════════════════════════════════════════════════
+
+/**
+ * Check if design system context was recently injected for this app
+ * Reads the transcript to avoid duplicate injections
+ */
+function wasRecentlyInjected(transcriptPath, appName) {
+  try {
+    if (!transcriptPath || !fs.existsSync(transcriptPath)) return false;
+    const transcript = fs.readFileSync(transcriptPath, 'utf-8');
+    // Check last 200 lines for recent injection of same app context
+    const recentLines = transcript.split('\n').slice(-200).join('\n');
+    return recentLines.includes(`**Detected App:** ${appName}`);
+  } catch (e) {
+    return false;
+  }
+}
+
+function isFrontendFile(filePath) {
+  if (!filePath) return false;
+  const ext = path.extname(filePath).toLowerCase();
+  return FRONTEND_EXTENSIONS.includes(ext);
+}
+
+function detectAppFromPath(filePath) {
+  if (!filePath) return null;
+
+  // Normalize path separators
+  const normalizedPath = filePath.replace(/\\/g, '/');
+
+  for (const app of APP_PATTERNS) {
+    for (const pattern of app.patterns) {
+      if (pattern.test(normalizedPath)) {
+        return app;
+      }
+    }
+  }
+
+  return null;
+}
+
+function shouldInject(filePath, transcriptPath) {
+  // Skip non-frontend files
+  if (!isFrontendFile(filePath)) return false;
+
+  // Skip if no app detected
+  const app = detectAppFromPath(filePath);
+  if (!app) return false;
+
+  // Skip if already injected for this app recently
+  if (wasRecentlyInjected(transcriptPath, app.name)) return false;
+
+  return true;
+}
+
+function buildInjection(app, filePath) {
+  const docPath = `${DESIGN_SYSTEM_DOCS_PATH}/${app.docFile}`;
+  const indexPath = `${DESIGN_SYSTEM_DOCS_PATH}/README.md`;
+
+  const lines = [
+    '',
+    '## Design System Context',
+    '',
+    `**Detected App:** ${app.name}`,
+    `**File:** ${path.basename(filePath)}`,
+    '',
+    '### Required Reading',
+    '',
+    `Before implementing UI changes, you MUST read the design system documentation:`,
+    '',
+    `1. **Primary Guide:** \`${docPath}\``,
+    `   - ${app.description}`,
+    '',
+    `2. **Index (for navigation):** \`${indexPath}\``,
+    '',
+    '### Quick Reference',
+    ''
+  ];
+
+  // Add app-specific quick tips
+  if (app.name === 'PlatformExampleAppWeb') {
+    lines.push(
+      '- **SCSS:** Use `@use \'shared-mixin\'` imports',
+      '- **Colors:** Use CSS variables `--bg-pri-cl`, `--text-primary-cl`',
+      '- **Layout:** Use flex mixins `@include flex-column-container()`',
+      '- **Components:** Angular 19 standalone with signals',
+      '- **BEM:** Block__element with separate --modifier class'
+    );
+  }
+
+  lines.push('');
+
+  return lines.join('\n');
+}
+
+// ═══════════════════════════════════════════════════════════════════════════
+// MAIN EXECUTION
+// ═══════════════════════════════════════════════════════════════════════════
+
+async function main() {
+  try {
+    const stdin = fs.readFileSync(0, 'utf-8').trim();
+    if (!stdin) process.exit(0);
+
+    const payload = JSON.parse(stdin);
+    const toolName = payload.tool_name || '';
+    const toolInput = payload.tool_input || {};
+    const transcriptPath = payload.transcript_path || '';
+
+    // Only process Edit, Write, MultiEdit tools
+    if (!['Edit', 'Write', 'MultiEdit'].includes(toolName)) {
+      process.exit(0);
+    }
+
+    // Extract file path from tool input
+    const filePath = toolInput.file_path || toolInput.filePath || '';
+    if (!filePath) process.exit(0);
+
+    // Check if we should inject
+    if (!shouldInject(filePath, transcriptPath)) {
+      process.exit(0);
+    }
+
+    // Detect app and build injection
+    const app = detectAppFromPath(filePath);
+    if (!app) process.exit(0);
+
+    // Output the injection
+    const injection = buildInjection(app, filePath);
+    console.log(injection);
+
+    process.exit(0);
+  } catch (error) {
+    // Non-blocking - just exit silently
+    process.exit(0);
+  }
+}
+
+main();