thanh-kit 2.5.0 → 2.5.2

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

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

package/templates/hooks/frontend-typescript-context.cjs

@@ -1,233 +0,0 @@
-#!/usr/bin/env node
-/**
- * Frontend TypeScript Context Injector - PreToolUse Hook
- *
- * Automatically injects frontend TypeScript development guide when editing
- * .ts files in frontend applications. Uses file path patterns to detect
- * frontend TypeScript files.
- *
- * Pattern Matching:
- *   src/PlatformExampleAppWeb/*    → Angular 19 example app
- *   libs/platform-core/*           → Platform core library
- *   libs/apps-domains/*            → Domain library
- *
- * Exit Codes:
- *   0 - Success (non-blocking)
- */
-
-const fs = require('fs');
-const path = require('path');
-
-// ═══════════════════════════════════════════════════════════════════════════
-// CONFIGURATION
-// ═══════════════════════════════════════════════════════════════════════════
-
-const FRONTEND_GUIDE_PATH = 'docs/claude/frontend-typescript-complete-guide.md';
-
-const FRONTEND_PATTERNS = [
-  {
-    name: 'Example App',
-    patterns: [
-      /src[\/\\]PlatformExampleAppWeb[\/\\]/i
-    ],
-    description: 'Angular 19 standalone example app (TextSnippet)'
-  },
-  {
-    name: 'Platform Core',
-    patterns: [
-      /libs[\/\\]platform-core[\/\\]/i
-    ],
-    description: 'Platform core framework library'
-  },
-  {
-    name: 'Apps Domains',
-    patterns: [
-      /libs[\/\\]apps-domains[\/\\]/i
-    ],
-    description: 'Domain models and API services'
-  }
-];
-
-// App-specific patterns for more detailed guidance
-const APP_PATTERNS = {
-  'playground-text-snippet': /PlatformExampleAppWeb[\/\\]apps[\/\\]playground-text-snippet/i
-};
-
-// ═══════════════════════════════════════════════════════════════════════════
-// HELPER FUNCTIONS
-// ═══════════════════════════════════════════════════════════════════════════
-
-/**
- * Check if frontend TypeScript 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('**Frontend TypeScript Context Detected**');
-  } catch (e) {
-    return false;
-  }
-}
-
-function isTypeScriptFile(filePath) {
-  if (!filePath) return false;
-  const ext = path.extname(filePath).toLowerCase();
-  return ext === '.ts' || ext === '.tsx';
-}
-
-function detectFrontendContext(filePath) {
-  if (!filePath) return null;
-
-  // Normalize path separators
-  const normalizedPath = filePath.replace(/\\/g, '/');
-
-  for (const context of FRONTEND_PATTERNS) {
-    for (const pattern of context.patterns) {
-      if (pattern.test(normalizedPath)) {
-        return context;
-      }
-    }
-  }
-
-  return null;
-}
-
-function detectApp(filePath) {
-  if (!filePath) return null;
-
-  const normalizedPath = filePath.replace(/\\/g, '/');
-
-  for (const [appName, pattern] of Object.entries(APP_PATTERNS)) {
-    if (pattern.test(normalizedPath)) {
-      return appName;
-    }
-  }
-
-  return null;
-}
-
-function shouldInject(filePath, transcriptPath) {
-  // Skip non-TypeScript files
-  if (!isTypeScriptFile(filePath)) return false;
-
-  // Skip if no frontend context detected
-  const context = detectFrontendContext(filePath);
-  if (!context) return false;
-
-  // Skip if already injected recently
-  if (wasRecentlyInjected(transcriptPath)) return false;
-
-  return true;
-}
-
-function buildInjection(context, filePath, app) {
-  const fileName = path.basename(filePath);
-
-  const lines = [
-    '',
-    '## Frontend TypeScript Context Detected',
-    '',
-    `**Context:** ${context.name}`,
-    `**File:** ${fileName}`,
-    app ? `**App:** ${app}` : '',
-    '',
-    '### Required Reading',
-    '',
-    `Before implementing frontend TypeScript changes, you MUST read:`,
-    '',
-    `**\`${FRONTEND_GUIDE_PATH}\`**`,
-    '',
-    'This guide contains:',
-    '- Component patterns (PlatformComponent, PlatformVmStore, AppBaseFormComponent)',
-    '- State management (PlatformVmStore with signals)',
-    '- API service patterns (extend PlatformApiService)',
-    '- Form patterns with validation (PlatformFormComponent)',
-    '- RxJS operators and subscription management (.untilDestroyed())',
-    '- BEM class naming conventions for templates',
-    '',
-    '### Critical Rules',
-    '',
-    '1. **Components:** Extend `AppBaseComponent`, `AppBaseVmStoreComponent`, or `AppBaseFormComponent` - NEVER raw Component',
-    '2. **State:** Use `PlatformVmStore` for state management - NEVER manual signals',
-    '3. **API:** Extend `PlatformApiService` for HTTP calls - NEVER direct HttpClient',
-    '4. **Subscriptions:** Always use `.pipe(this.untilDestroyed())` - NEVER manual unsubscribe',
-    '5. **Templates:** All elements MUST have BEM classes (block__element --modifier)',
-    ''
-  ];
-
-  // Add app-specific guidance
-  if (app) {
-    lines.push(
-      '### App-Specific Notes',
-      '',
-      `Working in **${app}** app:`,
-      ''
-    );
-
-    if (app === 'playground-text-snippet') {
-      lines.push(
-        '- Angular 19 standalone components with signals',
-        '- Use `@use \'shared-mixin\'` for SCSS imports',
-        '- Use CSS variables for theming',
-        ''
-      );
-    }
-  }
-
-  // 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 app
-    const context = detectFrontendContext(filePath);
-    if (!context) process.exit(0);
-
-    const app = detectApp(filePath);
-
-    // Output the injection
-    const injection = buildInjection(context, filePath, app);
-    console.log(injection);
-
-    process.exit(0);
-  } catch (error) {
-    // Non-blocking - just exit silently
-    process.exit(0);
-  }
-}
-
-main();

package/templates/hooks/lib/ck-paths.cjs

@@ -1,110 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-/**
- * ClaudeKit Paths - Centralized path constants for all temporary/runtime files
- *
- * All ClaudeKit temp files consolidated under /tmp/ck/ namespace for:
- * - Cleaner /tmp directory (single namespace)
- * - Easier cleanup (rm -rf /tmp/ck/)
- * - Debugging (all state in one place)
- * - No collisions with other tools
- *
- * Fixes:
- * - #177: Race condition from shared global state file
- * - #178: Scattered temp files consolidation
- *
- * @module ck-paths
- */
-
-const path = require('path');
-const os = require('os');
-const fs = require('fs');
-
-// Root directory for all ClaudeKit temp files
-const CK_TMP_DIR = path.join(os.tmpdir(), 'ck');
-
-// Session-specific marker files (per-session, no race conditions)
-const MARKERS_DIR = path.join(CK_TMP_DIR, 'markers');
-
-// Global calibration data (shared by design - records compact thresholds)
-const CALIBRATION_PATH = path.join(CK_TMP_DIR, 'calibration.json');
-
-// Debug logs directory
-const DEBUG_DIR = path.join(CK_TMP_DIR, 'debug');
-
-/**
- * Ensure directory exists
- * @param {string} dirPath - Directory path to create
- */
-function ensureDir(dirPath) {
-  try {
-    if (!fs.existsSync(dirPath)) {
-      fs.mkdirSync(dirPath, { recursive: true });
-    }
-  } catch (err) {
-    // Silent fail - non-critical, but log for debugging
-    if (process.env.CK_DEBUG) {
-      console.error(`[CK] Failed to create ${dirPath}: ${err.message}`);
-    }
-  }
-}
-
-/**
- * Get marker file path for a session
- * @param {string} sessionId - Session ID
- * @returns {string} Full path to marker file
- */
-function getMarkerPath(sessionId) {
-  return path.join(MARKERS_DIR, `${sessionId}.json`);
-}
-
-/**
- * Get debug log path for a session
- * @param {string} sessionId - Session ID
- * @returns {string} Full path to debug log
- */
-function getDebugLogPath(sessionId) {
-  return path.join(DEBUG_DIR, `${sessionId}.log`);
-}
-
-/**
- * Initialize ClaudeKit temp directories
- * Call this at startup to ensure directories exist
- */
-function initDirs() {
-  ensureDir(CK_TMP_DIR);
-  ensureDir(MARKERS_DIR);
-  ensureDir(DEBUG_DIR);
-}
-
-/**
- * Clean up all ClaudeKit temp files
- * Useful for testing or manual cleanup
- */
-function cleanAll() {
-  try {
-    if (fs.existsSync(CK_TMP_DIR)) {
-      fs.rmSync(CK_TMP_DIR, { recursive: true, force: true });
-    }
-  } catch (err) {
-    // Silent fail
-  }
-}
-
-module.exports = {
-  // Directories
-  CK_TMP_DIR,
-  MARKERS_DIR,
-  DEBUG_DIR,
-
-  // Files
-  CALIBRATION_PATH,
-
-  // Helpers
-  ensureDir,
-  getMarkerPath,
-  getDebugLogPath,
-  initDirs,
-  cleanAll
-};