style: run prettier on entire codebase

.claude/hooks/block-env.js

@@ -0,0 +1,14 @@
+// Block direct .env file edits (not .env.example, .env.production, .env.test)
+let data = '';
+process.stdin.on('data', chunk => data += chunk);
+process.stdin.on('end', () => {
+  try {
+    const input = JSON.parse(data);
+    const filePath = input.tool_input?.file_path || '';
+    const basename = filePath.split('/').pop().split('\\').pop();
+    if (basename === '.env') {
+      console.log(JSON.stringify({ decision: 'block', reason: 'Direct .env edits are blocked. Use .env.example instead.' }));
+      process.exit(1);
+    }
+  } catch {}
+});

.claude/hooks/format-on-save.js

@@ -0,0 +1,13 @@
+// Auto-format edited files with prettier
+const { execSync } = require('child_process');
+let data = '';
+process.stdin.on('data', chunk => data += chunk);
+process.stdin.on('end', () => {
+  try {
+    const input = JSON.parse(data);
+    const filePath = input.tool_response?.filePath || input.tool_input?.file_path || '';
+    if (filePath) {
+      execSync(`npx prettier --write "${filePath}" --ignore-unknown`, { stdio: 'ignore', timeout: 10000 });
+    }
+  } catch {}
+});

.claude/settings.json

@@ -0,0 +1,30 @@
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node .claude/hooks/block-env.js",
+            "timeout": 5,
+            "statusMessage": "Checking file permissions..."
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node .claude/hooks/format-on-save.js",
+            "timeout": 15,
+            "statusMessage": "Formatting..."
+          }
+        ]
+      }
+    ]
+  }
+}

.claude/skills/compare-php/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: compare-php
+description: Compare a feature between PHP boha-app and TS boha-app-ts to verify migration parity
+---
+
+# Compare PHP vs TS Implementation
+
+Compare a specific feature, component, or endpoint between the original PHP project (D:\cortex\boha-app) and the TypeScript migration (D:\cortex\boha-app-ts).
+
+## Usage
+
+The user will specify what to compare. Examples:
+- `/compare-php attendance print`
+- `/compare-php invoice PDF generation`
+- `/compare-php offer numbering logic`
+
+## Process
+
+1. Search the PHP codebase (D:\cortex\boha-app) for the relevant implementation
+2. Search the TS codebase (D:\cortex\boha-app-ts) for the same feature
+3. Compare:
+   - API endpoints and request/response shape
+   - Business logic and calculations
+   - Database queries
+   - Frontend behavior
+4. Report differences found — what's missing, what's different, what's extra
+
+## Key directories
+
+**PHP project:**
+- API handlers: `D:\cortex\boha-app\api\admin\handlers\`
+- API routes: `D:\cortex\boha-app\api\admin\`
+- Frontend pages: `D:\cortex\boha-app\src\admin\pages\`
+- Frontend components: `D:\cortex\boha-app\src\admin\components\`
+- Frontend hooks: `D:\cortex\boha-app\src\admin\hooks\`
+- Includes/utils: `D:\cortex\boha-app\api\includes\`
+
+**TS project:**
+- API routes: `D:\cortex\boha-app-ts\src\routes\admin\`
+- Services: `D:\cortex\boha-app-ts\src\services\`
+- Frontend pages: `D:\cortex\boha-app-ts\src\admin\pages\`
+- Frontend components: `D:\cortex\boha-app-ts\src\admin\components\`
+- Frontend hooks: `D:\cortex\boha-app-ts\src\admin\hooks\`