Cursor rule

1> This file extends [common/hooks.md](../common/hooks.md) with web-specific hook recommendations.
2 
3# Web Hooks
4 
5## Recommended PostToolUse Hooks
6 
7Prefer project-local tooling. Do not wire hooks to remote one-off package execution.
8 
9### Format on Save
10 
11Use the project's existing formatter entrypoint after edits:
12 
13```json
14{
15  "hooks": {
16    "PostToolUse": [
17      {
18        "matcher": "Write|Edit",
19        "command": "pnpm prettier --write \"$FILE_PATH\"",
20        "description": "Format edited frontend files"
21      }
22    ]
23  }
24}
25```
26 
27Equivalent local commands via `yarn prettier` or `npm exec prettier --` are fine when they use repo-owned dependencies.
28 
29### Lint Check
30 
31```json
32{
33  "hooks": {
34    "PostToolUse": [
35      {
36        "matcher": "Write|Edit",
37        "command": "pnpm eslint --fix \"$FILE_PATH\"",
38        "description": "Run ESLint on edited frontend files"
39      }
40    ]
41  }
42}
43```
44 
45### Type Check
46 
47```json
48{
49  "hooks": {
50    "PostToolUse": [
51      {
52        "matcher": "Write|Edit",
53        "command": "pnpm tsc --noEmit --pretty false",
54        "description": "Type-check after frontend edits"
55      }
56    ]
57  }
58}
59```
60 
61### CSS Lint
62 
63```json
64{
65  "hooks": {
66    "PostToolUse": [
67      {
68        "matcher": "Write|Edit",
69        "command": "pnpm stylelint --fix \"$FILE_PATH\"",
70        "description": "Lint edited stylesheets"
71      }
72    ]
73  }
74}
75```
76 
77## PreToolUse Hooks
78 
79### Guard File Size
80 
81Block oversized writes from tool input content, not from a file that may not exist yet:
82 
83```json
84{
85  "hooks": {
86    "PreToolUse": [
87      {
88        "matcher": "Write",
89        "command": "node -e \"let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{const i=JSON.parse(d);const c=i.tool_input?.content||'';const lines=c.split('\\n').length;if(lines>800){console.error('[Hook] BLOCKED: File exceeds 800 lines ('+lines+' lines)');console.error('[Hook] Split into smaller modules');process.exit(2)}console.log(d)})\"",
90        "description": "Block writes that exceed 800 lines"
91      }
92    ]
93  }
94}
95```
96 
97## Stop Hooks
98 
99### Final Build Verification
100 
101```json
102{
103  "hooks": {
104    "Stop": [
105      {
106        "command": "pnpm build",
107        "description": "Verify the production build at session end"
108      }
109    ]
110  }
111}
112```
113 
114## Ordering
115 
116Recommended order:
1171. format
1182. lint
1193. type check
1204. build verification
121