@agentic15.com/agentic15-claude-zen 1.0.0 → 1.1.0

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 (23) hide show
  1. package/CHANGELOG.md +60 -45
  2. package/LICENSE +1 -1
  3. package/README.md +6 -4
  4. package/bin/create-agentic15-claude-zen.js +1 -1
  5. package/dist/index.js +8 -8
  6. package/dist/index.js.map +3 -3
  7. package/package.json +64 -61
  8. package/src/core/DependencyInstaller.js +1 -1
  9. package/src/core/GitHubClient.js +170 -0
  10. package/src/core/GitHubConfig.js +192 -0
  11. package/src/core/GitInitializer.js +1 -1
  12. package/src/core/HookInstaller.js +71 -54
  13. package/src/core/ProjectInitializer.js +1 -1
  14. package/src/core/TaskIssueMapper.js +137 -0
  15. package/src/core/TemplateManager.js +1 -1
  16. package/src/index.js +1 -1
  17. package/src/utils/updateTaskGitHubStatus.js +81 -0
  18. package/templates/.claude/POST-INSTALL.md +367 -248
  19. package/templates/.claude/hooks/complete-task.js +224 -0
  20. package/templates/.claude/hooks/post-merge.js +163 -0
  21. package/templates/.claude/hooks/start-task.js +233 -0
  22. package/templates/.claude/settings.json +272 -262
  23. package/templates/.claude/settings.local.json.example +11 -0
package/templates/.claude/settings.json CHANGED
@@ -1,262 +1,272 @@
1
- {
2
- "permissions": {
3
- "allow": [
4
- "Read(**)",
5
- "Glob",
6
- "Grep",
7
- "Bash(npm run *)",
8
- "Bash(git status*)",
9
- "Bash(git log*)",
10
- "Bash(git diff*)",
11
- "Bash(git branch*)",
12
- "Bash(git checkout main)",
13
- "Bash(git add *)",
14
- "Bash(git commit*)",
15
- "Bash(git push*)",
16
- "Edit(./Agent/**)",
17
- "Write(./Agent/**)",
18
- "Edit(./scripts/**)",
19
- "Write(./scripts/**)",
20
- "Write(./.claude/PROJECT-PLAN.json)"
21
- ],
22
- "ask": [
23
- "Edit(./package.json)",
24
- "Edit(./tsconfig.json)",
25
- "Edit(./jest.config.*)",
26
- "Write(./config/**)"
27
- ],
28
- "deny": [
29
- "Edit(**/*.md)",
30
- "Write(**/*.md)",
31
- "Edit(./docs/**)",
32
- "Write(./docs/**)",
33
- "Edit(./README.md)",
34
- "Edit(./CHANGELOG.md)",
35
- "Edit(./.env*)",
36
- "Write(./.env*)",
37
- "Edit(./.claude/PROJECT-PLAN.json)",
38
- "Edit(./.claude/settings.json)",
39
- "Edit(./.claude/hooks/**)",
40
- "Write(./.claude/hooks/**)",
41
- "Edit(./.claude/CLAUDE.md)",
42
- "Edit(./.claude/TASK-TRACKER.json)",
43
- "Bash(curl*)",
44
- "Bash(wget*)",
45
- "Bash(rm -rf*)",
46
- "Bash(sudo*)",
47
- "Bash(npm install*)",
48
- "Bash(npm publish*)",
49
- "Bash(git push --force*)",
50
- "Bash(git merge*)",
51
- "Bash(psql*)",
52
- "Bash(mysql*)",
53
- "Bash(sqlite3*)",
54
- "Bash(mongosh*)",
55
- "Bash(redis-cli*)",
56
- "Bash(node ./scripts/**)",
57
- "Bash(node ./Agent/db/**)",
58
- "Bash(bash ./scripts/**)",
59
- "Bash(sh ./scripts/**)",
60
- "Bash(git checkout -b *)",
61
- "WebFetch",
62
- "WebSearch"
63
- ]
64
- },
65
- "sandbox": {
66
- "enabled": true,
67
- "autoAllowBashIfSandboxed": true,
68
- "allowUnsandboxedCommands": false
69
- },
70
- "env": {
71
- "DISABLE_PROMPT_CACHING": "0",
72
- "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "8192",
73
- "DISABLE_NON_ESSENTIAL_MODEL_CALLS": "1"
74
- },
75
- "testing": {
76
- "ui": {
77
- "strictMode": true,
78
- "requireTestFile": true,
79
- "requireImport": true,
80
- "requireRender": true,
81
- "requireProps": true,
82
- "requireEventTests": true,
83
- "requireApiMocking": true,
84
- "requireStateTests": true,
85
- "requireFormTests": true,
86
- "requireConditionalTests": true,
87
- "requireIntegrationSite": true,
88
- "integrationSiteDir": "test-site",
89
- "conditionalThreshold": 3,
90
- "requireVisualCheck": true,
91
- "requireContract": false,
92
- "comment": "⚠️ ALL UI testing requirements are HARD REQUIREMENTS (cannot be disabled). Commits will be blocked if any requirement is violated."
93
- },
94
- "visual": {
95
- "enabled": true,
96
- "strictMode": false,
97
- "autoApprove": false,
98
- "requireBaseline": true,
99
- "pixelMatchThreshold": 0.1,
100
- "diffThreshold": 1.0,
101
- "browsers": ["chromium"],
102
- "viewports": [
103
- {
104
- "name": "desktop",
105
- "width": 1920,
106
- "height": 1080,
107
- "deviceScaleFactor": 1
108
- },
109
- {
110
- "name": "tablet",
111
- "width": 768,
112
- "height": 1024,
113
- "deviceScaleFactor": 2
114
- },
115
- {
116
- "name": "mobile",
117
- "width": 375,
118
- "height": 667,
119
- "deviceScaleFactor": 2
120
- }
121
- ],
122
- "excludePatterns": [
123
- "**/node_modules/**",
124
- "**/dist/**",
125
- "**/build/**"
126
- ],
127
- "baselineDir": ".claude/visual-baselines",
128
- "diffDir": ".claude/visual-diffs",
129
- "tempDir": ".claude/visual-temp",
130
- "comment": "Visual regression testing configuration. Triggers on UI component changes (.tsx, .jsx, .vue, .svelte). Set enabled:false to disable."
131
- }
132
- },
133
- "hooks": {
134
- "SessionStart": [
135
- {
136
- "matcher": "startup",
137
- "hooks": [
138
- {
139
- "type": "command",
140
- "command": "node node_modules/.agentic15-claude-zen/hooks/session-start-context.js"
141
- },
142
- {
143
- "type": "command",
144
- "command": "node node_modules/.agentic15-claude-zen/hooks/detect-pending-reviews.js"
145
- }
146
- ]
147
- }
148
- ],
149
- "PreToolUse": [
150
- {
151
- "matcher": "*",
152
- "hooks": [
153
- {
154
- "type": "command",
155
- "command": "node node_modules/.agentic15-claude-zen/hooks/enforce-hard-requirements.js"
156
- },
157
- {
158
- "type": "command",
159
- "command": "node node_modules/.agentic15-claude-zen/hooks/prevent-read-bypass.js"
160
- },
161
- {
162
- "type": "command",
163
- "command": "node node_modules/.agentic15-claude-zen/hooks/enforce-structured-development.js"
164
- },
165
- {
166
- "type": "command",
167
- "command": "node node_modules/.agentic15-claude-zen/hooks/enforce-plan-template.js"
168
- }
169
- ]
170
- },
171
- {
172
- "matcher": "Bash",
173
- "hooks": [
174
- {
175
- "type": "command",
176
- "command": "node node_modules/.agentic15-claude-zen/hooks/validate-git-workflow.js"
177
- },
178
- {
179
- "type": "command",
180
- "command": "node node_modules/.agentic15-claude-zen/hooks/validate-task-completion.js"
181
- }
182
- ]
183
- }
184
- ],
185
- "PostToolUse": [
186
- {
187
- "matcher": "Edit|Write",
188
- "hooks": [
189
- {
190
- "type": "command",
191
- "command": "node node_modules/.agentic15-claude-zen/hooks/enforce-structured-development.js"
192
- },
193
- {
194
- "type": "command",
195
- "command": "node node_modules/.agentic15-claude-zen/hooks/auto-format.js"
196
- },
197
- {
198
- "type": "command",
199
- "command": "node node_modules/.agentic15-claude-zen/hooks/validate-ui-syntax.js"
200
- },
201
- {
202
- "type": "command",
203
- "command": "node node_modules/.agentic15-claude-zen/hooks/validate-ui-runtime.js"
204
- },
205
- {
206
- "type": "command",
207
- "command": "node node_modules/.agentic15-claude-zen/hooks/validate-ui-visual-native.js"
208
- },
209
- {
210
- "type": "command",
211
- "command": "node node_modules/.agentic15-claude-zen/hooks/validate-component-contract.js"
212
- },
213
- {
214
- "type": "command",
215
- "command": "node node_modules/.agentic15-claude-zen/hooks/validate-test-quality.js"
216
- },
217
- {
218
- "type": "command",
219
- "command": "node node_modules/.agentic15-claude-zen/hooks/validate-ui-integration.js"
220
- },
221
- {
222
- "type": "command",
223
- "command": "node node_modules/.agentic15-claude-zen/hooks/validate-integration-site.js"
224
- },
225
- {
226
- "type": "command",
227
- "command": "node node_modules/.agentic15-claude-zen/hooks/validate-database-changes.js"
228
- },
229
- {
230
- "type": "command",
231
- "command": "node node_modules/.agentic15-claude-zen/hooks/validate-migration-impact.js"
232
- },
233
- {
234
- "type": "command",
235
- "command": "node node_modules/.agentic15-claude-zen/hooks/validate-visual-regression.js"
236
- }
237
- ]
238
- },
239
- {
240
- "matcher": "Bash",
241
- "hooks": [
242
- {
243
- "type": "command",
244
- "command": "node node_modules/.agentic15-claude-zen/hooks/validate-test-results.js"
245
- },
246
- {
247
- "type": "command",
248
- "command": "node node_modules/.agentic15-claude-zen/hooks/validate-e2e-coverage.js"
249
- },
250
- {
251
- "type": "command",
252
- "command": "node node_modules/.agentic15-claude-zen/hooks/enforce-test-pyramid.js"
253
- },
254
- {
255
- "type": "command",
256
- "command": "node node_modules/.agentic15-claude-zen/hooks/enforce-migration-workflow.js"
257
- }
258
- ]
259
- }
260
- ]
261
- }
262
- }
1
+ {
2
+ "permissions": {
3
+ "allow": [
4
+ "Read(**)",
5
+ "Glob",
6
+ "Grep",
7
+ "Bash(npm run *)",
8
+ "Bash(git status*)",
9
+ "Bash(git log*)",
10
+ "Bash(git diff*)",
11
+ "Bash(git branch*)",
12
+ "Bash(git checkout main)",
13
+ "Bash(git add *)",
14
+ "Bash(git commit*)",
15
+ "Bash(git push*)",
16
+ "Edit(./Agent/**)",
17
+ "Write(./Agent/**)",
18
+ "Edit(./scripts/**)",
19
+ "Write(./scripts/**)",
20
+ "Write(./.claude/PROJECT-PLAN.json)"
21
+ ],
22
+ "ask": [
23
+ "Edit(./package.json)",
24
+ "Edit(./tsconfig.json)",
25
+ "Edit(./jest.config.*)",
26
+ "Write(./config/**)"
27
+ ],
28
+ "deny": [
29
+ "Edit(**/*.md)",
30
+ "Write(**/*.md)",
31
+ "Edit(./docs/**)",
32
+ "Write(./docs/**)",
33
+ "Edit(./README.md)",
34
+ "Edit(./CHANGELOG.md)",
35
+ "Edit(./.env*)",
36
+ "Write(./.env*)",
37
+ "Edit(./.claude/PROJECT-PLAN.json)",
38
+ "Edit(./.claude/settings.json)",
39
+ "Edit(./.claude/hooks/**)",
40
+ "Write(./.claude/hooks/**)",
41
+ "Edit(./.claude/CLAUDE.md)",
42
+ "Edit(./.claude/TASK-TRACKER.json)",
43
+ "Bash(curl*)",
44
+ "Bash(wget*)",
45
+ "Bash(rm -rf*)",
46
+ "Bash(sudo*)",
47
+ "Bash(npm install*)",
48
+ "Bash(npm publish*)",
49
+ "Bash(git push --force*)",
50
+ "Bash(git merge*)",
51
+ "Bash(psql*)",
52
+ "Bash(mysql*)",
53
+ "Bash(sqlite3*)",
54
+ "Bash(mongosh*)",
55
+ "Bash(redis-cli*)",
56
+ "Bash(node ./scripts/**)",
57
+ "Bash(node ./Agent/db/**)",
58
+ "Bash(bash ./scripts/**)",
59
+ "Bash(sh ./scripts/**)",
60
+ "Bash(git checkout -b *)",
61
+ "WebFetch",
62
+ "WebSearch"
63
+ ]
64
+ },
65
+ "sandbox": {
66
+ "enabled": true,
67
+ "autoAllowBashIfSandboxed": true,
68
+ "allowUnsandboxedCommands": false
69
+ },
70
+ "env": {
71
+ "DISABLE_PROMPT_CACHING": "0",
72
+ "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "8192",
73
+ "DISABLE_NON_ESSENTIAL_MODEL_CALLS": "1"
74
+ },
75
+ "github": {
76
+ "enabled": true,
77
+ "autoCreate": true,
78
+ "autoUpdate": true,
79
+ "autoClose": true,
80
+ "token": null,
81
+ "owner": null,
82
+ "repo": null,
83
+ "comment": "GitHub Issues integration. Configure in .claude/settings.local.json or via environment variables (GITHUB_TOKEN, GITHUB_OWNER, GITHUB_REPO). Owner/repo auto-detected from git remote if not set."
84
+ },
85
+ "testing": {
86
+ "ui": {
87
+ "strictMode": true,
88
+ "requireTestFile": true,
89
+ "requireImport": true,
90
+ "requireRender": true,
91
+ "requireProps": true,
92
+ "requireEventTests": true,
93
+ "requireApiMocking": true,
94
+ "requireStateTests": true,
95
+ "requireFormTests": true,
96
+ "requireConditionalTests": true,
97
+ "requireIntegrationSite": true,
98
+ "integrationSiteDir": "test-site",
99
+ "conditionalThreshold": 3,
100
+ "requireVisualCheck": true,
101
+ "requireContract": false,
102
+ "comment": "⚠️ ALL UI testing requirements are HARD REQUIREMENTS (cannot be disabled). Commits will be blocked if any requirement is violated."
103
+ },
104
+ "visual": {
105
+ "enabled": true,
106
+ "strictMode": false,
107
+ "autoApprove": false,
108
+ "requireBaseline": true,
109
+ "pixelMatchThreshold": 0.1,
110
+ "diffThreshold": 1.0,
111
+ "browsers": ["chromium"],
112
+ "viewports": [
113
+ {
114
+ "name": "desktop",
115
+ "width": 1920,
116
+ "height": 1080,
117
+ "deviceScaleFactor": 1
118
+ },
119
+ {
120
+ "name": "tablet",
121
+ "width": 768,
122
+ "height": 1024,
123
+ "deviceScaleFactor": 2
124
+ },
125
+ {
126
+ "name": "mobile",
127
+ "width": 375,
128
+ "height": 667,
129
+ "deviceScaleFactor": 2
130
+ }
131
+ ],
132
+ "excludePatterns": [
133
+ "**/node_modules/**",
134
+ "**/dist/**",
135
+ "**/build/**"
136
+ ],
137
+ "baselineDir": ".claude/visual-baselines",
138
+ "diffDir": ".claude/visual-diffs",
139
+ "tempDir": ".claude/visual-temp",
140
+ "comment": "Visual regression testing configuration. Triggers on UI component changes (.tsx, .jsx, .vue, .svelte). Set enabled:false to disable."
141
+ }
142
+ },
143
+ "hooks": {
144
+ "SessionStart": [
145
+ {
146
+ "matcher": "startup",
147
+ "hooks": [
148
+ {
149
+ "type": "command",
150
+ "command": "node node_modules/.agentic15-claude-zen/hooks/session-start-context.js"
151
+ },
152
+ {
153
+ "type": "command",
154
+ "command": "node node_modules/.agentic15-claude-zen/hooks/detect-pending-reviews.js"
155
+ }
156
+ ]
157
+ }
158
+ ],
159
+ "PreToolUse": [
160
+ {
161
+ "matcher": "*",
162
+ "hooks": [
163
+ {
164
+ "type": "command",
165
+ "command": "node node_modules/.agentic15-claude-zen/hooks/enforce-hard-requirements.js"
166
+ },
167
+ {
168
+ "type": "command",
169
+ "command": "node node_modules/.agentic15-claude-zen/hooks/prevent-read-bypass.js"
170
+ },
171
+ {
172
+ "type": "command",
173
+ "command": "node node_modules/.agentic15-claude-zen/hooks/enforce-structured-development.js"
174
+ },
175
+ {
176
+ "type": "command",
177
+ "command": "node node_modules/.agentic15-claude-zen/hooks/enforce-plan-template.js"
178
+ }
179
+ ]
180
+ },
181
+ {
182
+ "matcher": "Bash",
183
+ "hooks": [
184
+ {
185
+ "type": "command",
186
+ "command": "node node_modules/.agentic15-claude-zen/hooks/validate-git-workflow.js"
187
+ },
188
+ {
189
+ "type": "command",
190
+ "command": "node node_modules/.agentic15-claude-zen/hooks/validate-task-completion.js"
191
+ }
192
+ ]
193
+ }
194
+ ],
195
+ "PostToolUse": [
196
+ {
197
+ "matcher": "Edit|Write",
198
+ "hooks": [
199
+ {
200
+ "type": "command",
201
+ "command": "node node_modules/.agentic15-claude-zen/hooks/enforce-structured-development.js"
202
+ },
203
+ {
204
+ "type": "command",
205
+ "command": "node node_modules/.agentic15-claude-zen/hooks/auto-format.js"
206
+ },
207
+ {
208
+ "type": "command",
209
+ "command": "node node_modules/.agentic15-claude-zen/hooks/validate-ui-syntax.js"
210
+ },
211
+ {
212
+ "type": "command",
213
+ "command": "node node_modules/.agentic15-claude-zen/hooks/validate-ui-runtime.js"
214
+ },
215
+ {
216
+ "type": "command",
217
+ "command": "node node_modules/.agentic15-claude-zen/hooks/validate-ui-visual-native.js"
218
+ },
219
+ {
220
+ "type": "command",
221
+ "command": "node node_modules/.agentic15-claude-zen/hooks/validate-component-contract.js"
222
+ },
223
+ {
224
+ "type": "command",
225
+ "command": "node node_modules/.agentic15-claude-zen/hooks/validate-test-quality.js"
226
+ },
227
+ {
228
+ "type": "command",
229
+ "command": "node node_modules/.agentic15-claude-zen/hooks/validate-ui-integration.js"
230
+ },
231
+ {
232
+ "type": "command",
233
+ "command": "node node_modules/.agentic15-claude-zen/hooks/validate-integration-site.js"
234
+ },
235
+ {
236
+ "type": "command",
237
+ "command": "node node_modules/.agentic15-claude-zen/hooks/validate-database-changes.js"
238
+ },
239
+ {
240
+ "type": "command",
241
+ "command": "node node_modules/.agentic15-claude-zen/hooks/validate-migration-impact.js"
242
+ },
243
+ {
244
+ "type": "command",
245
+ "command": "node node_modules/.agentic15-claude-zen/hooks/validate-visual-regression.js"
246
+ }
247
+ ]
248
+ },
249
+ {
250
+ "matcher": "Bash",
251
+ "hooks": [
252
+ {
253
+ "type": "command",
254
+ "command": "node node_modules/.agentic15-claude-zen/hooks/validate-test-results.js"
255
+ },
256
+ {
257
+ "type": "command",
258
+ "command": "node node_modules/.agentic15-claude-zen/hooks/validate-e2e-coverage.js"
259
+ },
260
+ {
261
+ "type": "command",
262
+ "command": "node node_modules/.agentic15-claude-zen/hooks/enforce-test-pyramid.js"
263
+ },
264
+ {
265
+ "type": "command",
266
+ "command": "node node_modules/.agentic15-claude-zen/hooks/enforce-migration-workflow.js"
267
+ }
268
+ ]
269
+ }
270
+ ]
271
+ }
272
+ }
package/templates/.claude/settings.local.json.example ADDED
@@ -0,0 +1,11 @@
1
+ {
2
+ "github": {
3
+ "enabled": true,
4
+ "autoCreate": true,
5
+ "autoUpdate": true,
6
+ "autoClose": true,
7
+ "token": "ghp_YOUR_GITHUB_TOKEN_HERE",
8
+ "owner": "your-github-username",
9
+ "repo": "your-repo-name"
10
+ }
11
+ }