npm - thanh-kit - Versions diffs - 2.5.0 → 2.5.2 - Mend

thanh-kit 2.5.0 → 2.5.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (886) hide show

package/templates/commands/worktree.md DELETED Viewed

@@ -1,126 +0,0 @@
----
-description: Create isolated git worktree for parallel development
-argument-hint: [feature-description] OR [project] [feature] (monorepo)
----
-Create an isolated git worktree for parallel feature development.
-## Workflow
-### Step 1: Get Repository Info
-```bash
-node .claude/scripts/worktree.cjs info --json
-```
-**Response fields:**
-- `repoType`: "monorepo" or "standalone"
-- `baseBranch`: detected base branch
-- `projects`: array of {name, path} for monorepo
-- `envFiles`: array of .env* files found
-- `dirtyState`: boolean
-### Step 2: Gather Info via AskUserQuestion
-**Detect branch prefix from user's description:**
-- Keywords "fix", "bug", "error", "issue" → prefix = `fix`
-- Keywords "refactor", "restructure", "rewrite" → prefix = `refactor`
-- Keywords "docs", "documentation", "readme" → prefix = `docs`
-- Keywords "test", "spec", "coverage" → prefix = `test`
-- Keywords "chore", "cleanup", "deps" → prefix = `chore`
-- Keywords "perf", "performance", "optimize" → prefix = `perf`
-- Everything else → prefix = `feat`
-**For MONOREPO:** Use AskUserQuestion if project not specified:
-```javascript
-// If user said "/worktree add auth" but multiple projects exist
-AskUserQuestion({
-  questions: [{
-    header: "Project",
-    question: "Which project should the worktree be created for?",
-    options: projects.map(p => ({ label: p.name, description: p.path })),
-    multiSelect: false
-  }]
-})
-```
-**For env files:** Always ask which to copy:
-```javascript
-AskUserQuestion({
-  questions: [{
-    header: "Env files",
-    question: "Which environment files should be copied to the worktree?",
-    options: envFiles.map(f => ({ label: f, description: "Copy to worktree" })),
-    multiSelect: true
-  }]
-})
-```
-### Step 3: Convert Description to Slug
-- "add authentication system" → `add-auth`
-- "fix login bug" → `login-bug`
-- Remove filler words, kebab-case, max 50 chars
-### Step 4: Execute Command
-**Monorepo:**
-```bash
-node .claude/scripts/worktree.cjs create "<PROJECT>" "<SLUG>" --prefix <TYPE> --env "<FILES>"
-```
-**Standalone:**
-```bash
-node .claude/scripts/worktree.cjs create "<SLUG>" --prefix <TYPE> --env "<FILES>"
-```
-**Options:**
-- `--prefix` - Branch type: feat|fix|refactor|docs|test|chore|perf
-- `--env` - Comma-separated .env files to copy
-- `--json` - Output JSON for parsing
-- `--dry-run` - Preview without executing
-## Commands
-| Command | Usage | Description |
-|---------|-------|-------------|
-| `create` | `create [project] <feature>` | Create new worktree |
-| `remove` | `remove <name-or-path>` | Remove worktree and branch |
-| `info` | `info` | Get repo info |
-| `list` | `list` | List existing worktrees |
-## Error Codes
-| Code | Meaning | Action |
-|------|---------|--------|
-| `MISSING_ARGS` | Missing project/feature for monorepo | Ask for both |
-| `MISSING_FEATURE` | No feature name (standalone) | Ask for feature |
-| `PROJECT_NOT_FOUND` | Project not in .gitmodules | Show available projects |
-| `MULTIPLE_PROJECTS_MATCH` | Ambiguous project name | Use AskUserQuestion |
-| `MULTIPLE_WORKTREES_MATCH` | Ambiguous worktree for remove | Use AskUserQuestion |
-| `BRANCH_CHECKED_OUT` | Branch in use elsewhere | Suggest different name |
-| `WORKTREE_EXISTS` | Path already exists | Suggest use or remove |
-| `WORKTREE_CREATE_FAILED` | Git command failed | Show git error |
-| `WORKTREE_REMOVE_FAILED` | Cannot remove worktree | Check uncommitted changes |
-## Example Session
-```
-User: /worktree fix the login validation bug
-Claude: [Runs: node .claude/scripts/worktree.cjs info --json]
-        [Detects: standalone repo, envFiles: [".env.example"]]
-        [Detects prefix from "fix" keyword: fix]
-        [Converts slug: "login-validation-bug"]
-Claude: [Uses AskUserQuestion for env files]
-        "Which environment files should be copied?"
-        Options: .env.example
-User: .env.example
-Claude: [Runs: node .claude/scripts/worktree.cjs create "login-validation-bug" --prefix fix --env ".env.example"]
-Output: Worktree created at ../worktrees/myrepo-login-validation-bug
-        Branch: fix/login-validation-bug
-```

package/templates/hooks/.python-cache.json DELETED Viewed

	@@ -1 +0,0 @@
1	- {"version":"Python 3.12.10","timestamp":1767230959174}

package/templates/hooks/README.md DELETED Viewed

@@ -1,246 +0,0 @@
-# ⚡ 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 DELETED Viewed

@@ -1,223 +0,0 @@
-#!/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();