specky-sdd 3.7.3 → 3.9.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 (140) hide show
  1. package/.apm/agents/{design-architect.agent.md → specky-design-architect.agent.md} +2 -2
  2. package/.apm/agents/{implementer.agent.md → specky-implementer.agent.md} +9 -9
  3. package/.apm/agents/specky-onboarding.agent.md +2 -2
  4. package/.apm/agents/specky-orchestrator.agent.md +10 -10
  5. package/.apm/agents/{quality-reviewer.agent.md → specky-quality-reviewer.agent.md} +6 -6
  6. package/.apm/agents/{release-engineer.agent.md → specky-release-engineer.agent.md} +11 -11
  7. package/.apm/agents/{requirements-engineer.agent.md → specky-requirements-engineer.agent.md} +8 -8
  8. package/.apm/agents/{research-analyst.agent.md → specky-research-analyst.agent.md} +9 -9
  9. package/.apm/agents/{sdd-clarify.agent.md → specky-sdd-clarify.agent.md} +4 -3
  10. package/.apm/agents/{sdd-init.agent.md → specky-sdd-init.agent.md} +3 -3
  11. package/.apm/agents/{spec-engineer.agent.md → specky-spec-engineer.agent.md} +2 -2
  12. package/.apm/agents/{task-planner.agent.md → specky-task-planner.agent.md} +2 -2
  13. package/.apm/agents/{test-verifier.agent.md → specky-test-verifier.agent.md} +2 -2
  14. package/.apm/hooks/scripts/{artifact-validator.sh → specky-artifact-validator.sh} +11 -11
  15. package/.apm/hooks/scripts/{auto-checkpoint.sh → specky-auto-checkpoint.sh} +1 -1
  16. package/.apm/hooks/scripts/{branch-validator.sh → specky-branch-validator.sh} +3 -3
  17. package/.apm/hooks/scripts/{cognitive-debt-alert.sh → specky-cognitive-debt-alert.sh} +1 -1
  18. package/.apm/hooks/scripts/{drift-monitor.sh → specky-drift-monitor.sh} +1 -1
  19. package/.apm/hooks/scripts/{ears-validator.sh → specky-ears-validator.sh} +1 -1
  20. package/.apm/hooks/scripts/{lgtm-gate.sh → specky-lgtm-gate.sh} +1 -1
  21. package/.apm/hooks/scripts/{metrics-dashboard.sh → specky-metrics-dashboard.sh} +2 -2
  22. package/.apm/hooks/scripts/{phase-gate.sh → specky-phase-gate.sh} +1 -1
  23. package/.apm/hooks/scripts/{pipeline-guard.sh → specky-pipeline-guard.sh} +3 -3
  24. package/.apm/hooks/scripts/{release-gate.sh → specky-release-gate.sh} +1 -1
  25. package/.apm/hooks/scripts/{security-scan.sh → specky-security-scan.sh} +2 -2
  26. package/.apm/hooks/scripts/{session-banner.sh → specky-session-banner.sh} +4 -4
  27. package/.apm/hooks/scripts/{spec-quality.sh → specky-spec-quality.sh} +1 -1
  28. package/.apm/hooks/scripts/{spec-sync.sh → specky-spec-sync.sh} +2 -2
  29. package/.apm/hooks/scripts/{task-tracer.sh → specky-task-tracer.sh} +1 -1
  30. package/.apm/hooks/sdd-hooks.json +51 -51
  31. package/.apm/hooks/specky-run.sh +32 -0
  32. package/.apm/instructions/claude-instructions.instructions.md +74 -0
  33. package/.apm/instructions/copilot-instructions.instructions.md +19 -25
  34. package/.apm/instructions/cursor-instructions.instructions.md +20 -0
  35. package/.apm/prompts/specky-api.prompt.md +2 -2
  36. package/.apm/prompts/specky-brownfield.prompt.md +2 -2
  37. package/.apm/prompts/specky-clarify.prompt.md +1 -1
  38. package/.apm/prompts/specky-debug-hook.prompt.md +1 -1
  39. package/.apm/prompts/specky-deploy.prompt.md +1 -1
  40. package/.apm/prompts/specky-design.prompt.md +1 -1
  41. package/.apm/prompts/specky-from-meeting.prompt.md +1 -1
  42. package/.apm/prompts/specky-greenfield.prompt.md +2 -2
  43. package/.apm/prompts/specky-implement.prompt.md +1 -1
  44. package/.apm/prompts/specky-migration.prompt.md +3 -3
  45. package/.apm/prompts/specky-onboarding.prompt.md +1 -0
  46. package/.apm/prompts/specky-pipeline-status.prompt.md +1 -0
  47. package/.apm/prompts/specky-release.prompt.md +1 -1
  48. package/.apm/prompts/specky-research.prompt.md +1 -1
  49. package/.apm/prompts/specky-specify.prompt.md +1 -1
  50. package/.apm/prompts/specky-tasks.prompt.md +1 -1
  51. package/.apm/prompts/specky-verify.prompt.md +1 -1
  52. package/.apm/skills/specky-design-architect/SKILL.md +21 -0
  53. package/.apm/skills/{implementer → specky-implementer}/SKILL.md +3 -3
  54. package/.apm/skills/specky-onboarding/SKILL.md +37 -31
  55. package/.apm/skills/specky-orchestrator/SKILL.md +28 -28
  56. package/.apm/skills/specky-quality-reviewer/SKILL.md +28 -0
  57. package/.apm/skills/{release-engineer → specky-release-engineer}/SKILL.md +7 -7
  58. package/.apm/skills/{research-analyst → specky-research-analyst}/SKILL.md +2 -2
  59. package/.apm/skills/specky-sdd-clarify/SKILL.md +25 -0
  60. package/.apm/skills/specky-sdd-init/SKILL.md +28 -0
  61. package/.apm/skills/{sdd-markdown-standard → specky-sdd-markdown-standard}/SKILL.md +2 -2
  62. package/.apm/skills/{sdd-pipeline → specky-sdd-pipeline}/SKILL.md +42 -49
  63. package/.apm/skills/specky-spec-engineer/SKILL.md +27 -0
  64. package/.apm/skills/specky-task-planner/SKILL.md +20 -0
  65. package/.apm/skills/{test-verifier → specky-test-verifier}/SKILL.md +2 -2
  66. package/CHANGELOG.md +57 -0
  67. package/README.md +189 -96
  68. package/apm-policy.yml +19 -0
  69. package/apm.lock.yaml +70 -61
  70. package/apm.yml +10 -7
  71. package/config.yml +35 -33
  72. package/dist/claude-hooks.json +51 -51
  73. package/dist/cli/commands/compile.d.ts +7 -0
  74. package/dist/cli/commands/compile.d.ts.map +1 -0
  75. package/dist/cli/commands/compile.js +127 -0
  76. package/dist/cli/commands/compile.js.map +1 -0
  77. package/dist/cli/commands/doctor.d.ts.map +1 -1
  78. package/dist/cli/commands/doctor.js +167 -18
  79. package/dist/cli/commands/doctor.js.map +1 -1
  80. package/dist/cli/commands/hooks.js +2 -2
  81. package/dist/cli/commands/hooks.js.map +1 -1
  82. package/dist/cli/commands/init.d.ts +1 -0
  83. package/dist/cli/commands/init.d.ts.map +1 -1
  84. package/dist/cli/commands/init.js +121 -19
  85. package/dist/cli/commands/init.js.map +1 -1
  86. package/dist/cli/commands/upgrade.d.ts.map +1 -1
  87. package/dist/cli/commands/upgrade.js +5 -2
  88. package/dist/cli/commands/upgrade.js.map +1 -1
  89. package/dist/cli/index.js +21 -2
  90. package/dist/cli/index.js.map +1 -1
  91. package/dist/cli/lib/apm/policy.d.ts.map +1 -1
  92. package/dist/cli/lib/apm/policy.js +47 -33
  93. package/dist/cli/lib/apm/policy.js.map +1 -1
  94. package/dist/cli/lib/asset-copier.d.ts +13 -0
  95. package/dist/cli/lib/asset-copier.d.ts.map +1 -1
  96. package/dist/cli/lib/asset-copier.js +107 -32
  97. package/dist/cli/lib/asset-copier.js.map +1 -1
  98. package/dist/cli/lib/gitignore-writer.d.ts.map +1 -1
  99. package/dist/cli/lib/gitignore-writer.js +11 -0
  100. package/dist/cli/lib/gitignore-writer.js.map +1 -1
  101. package/dist/cli/lib/harness/compilers/agent-skills.d.ts +7 -0
  102. package/dist/cli/lib/harness/compilers/agent-skills.d.ts.map +1 -0
  103. package/dist/cli/lib/harness/compilers/agent-skills.js +23 -0
  104. package/dist/cli/lib/harness/compilers/agent-skills.js.map +1 -0
  105. package/dist/cli/lib/harness/compilers/cursor.d.ts +8 -0
  106. package/dist/cli/lib/harness/compilers/cursor.d.ts.map +1 -0
  107. package/dist/cli/lib/harness/compilers/cursor.js +28 -0
  108. package/dist/cli/lib/harness/compilers/cursor.js.map +1 -0
  109. package/dist/cli/lib/harness/compilers/opencode.d.ts +7 -0
  110. package/dist/cli/lib/harness/compilers/opencode.d.ts.map +1 -0
  111. package/dist/cli/lib/harness/compilers/opencode.js +26 -0
  112. package/dist/cli/lib/harness/compilers/opencode.js.map +1 -0
  113. package/dist/cli/lib/harness/index.d.ts.map +1 -1
  114. package/dist/cli/lib/harness/index.js +6 -0
  115. package/dist/cli/lib/harness/index.js.map +1 -1
  116. package/dist/cli/lib/harness/tool-map.d.ts.map +1 -1
  117. package/dist/cli/lib/harness/tool-map.js +23 -1
  118. package/dist/cli/lib/harness/tool-map.js.map +1 -1
  119. package/dist/cli/lib/harness/types.d.ts +2 -2
  120. package/dist/cli/lib/harness/types.d.ts.map +1 -1
  121. package/dist/cli/lib/mcp-writer.d.ts +1 -0
  122. package/dist/cli/lib/mcp-writer.d.ts.map +1 -1
  123. package/dist/cli/lib/mcp-writer.js +5 -1
  124. package/dist/cli/lib/mcp-writer.js.map +1 -1
  125. package/dist/cli/lib/paths.d.ts +19 -0
  126. package/dist/cli/lib/paths.d.ts.map +1 -1
  127. package/dist/cli/lib/paths.js +21 -0
  128. package/dist/cli/lib/paths.js.map +1 -1
  129. package/dist/copilot-hooks.json +46 -46
  130. package/dist/cursor-hooks.json +288 -0
  131. package/dist/index.js +2 -3
  132. package/dist/index.js.map +1 -1
  133. package/dist/services/state-machine.d.ts +4 -3
  134. package/dist/services/state-machine.d.ts.map +1 -1
  135. package/dist/services/state-machine.js +17 -9
  136. package/dist/services/state-machine.js.map +1 -1
  137. package/package.json +6 -7
  138. package/site/specky-icon.png +0 -0
  139. /package/.apm/skills/{sdd-pipeline → specky-sdd-pipeline}/references/ears-notation.md +0 -0
  140. /package/.apm/skills/{sdd-pipeline → specky-sdd-pipeline}/references/model-routing.md +0 -0
@@ -5,7 +5,7 @@
5
5
  "hooks": [
6
6
  {
7
7
  "type": "command",
8
- "command": "bash .claude/hooks/scripts/session-banner.sh",
8
+ "command": "bash .claude/hooks/scripts/specky-session-banner.sh",
9
9
  "timeout": 5
10
10
  }
11
11
  ]
@@ -17,7 +17,7 @@
17
17
  "hooks": [
18
18
  {
19
19
  "type": "command",
20
- "command": "bash .claude/hooks/scripts/pipeline-guard.sh",
20
+ "command": "bash .claude/hooks/scripts/specky-pipeline-guard.sh",
21
21
  "timeout": 5
22
22
  }
23
23
  ]
@@ -29,7 +29,7 @@
29
29
  "hooks": [
30
30
  {
31
31
  "type": "command",
32
- "command": "bash .claude/hooks/scripts/branch-validator.sh",
32
+ "command": "bash .claude/hooks/scripts/specky-branch-validator.sh",
33
33
  "timeout": 5
34
34
  }
35
35
  ]
@@ -39,12 +39,12 @@
39
39
  "hooks": [
40
40
  {
41
41
  "type": "command",
42
- "command": "bash .claude/hooks/scripts/artifact-validator.sh",
42
+ "command": "bash .claude/hooks/scripts/specky-artifact-validator.sh",
43
43
  "timeout": 10
44
44
  },
45
45
  {
46
46
  "type": "command",
47
- "command": "bash .claude/hooks/scripts/branch-validator.sh",
47
+ "command": "bash .claude/hooks/scripts/specky-branch-validator.sh",
48
48
  "timeout": 5
49
49
  }
50
50
  ]
@@ -54,12 +54,12 @@
54
54
  "hooks": [
55
55
  {
56
56
  "type": "command",
57
- "command": "bash .claude/hooks/scripts/artifact-validator.sh",
57
+ "command": "bash .claude/hooks/scripts/specky-artifact-validator.sh",
58
58
  "timeout": 10
59
59
  },
60
60
  {
61
61
  "type": "command",
62
- "command": "bash .claude/hooks/scripts/branch-validator.sh",
62
+ "command": "bash .claude/hooks/scripts/specky-branch-validator.sh",
63
63
  "timeout": 5
64
64
  }
65
65
  ]
@@ -69,12 +69,12 @@
69
69
  "hooks": [
70
70
  {
71
71
  "type": "command",
72
- "command": "bash .claude/hooks/scripts/artifact-validator.sh",
72
+ "command": "bash .claude/hooks/scripts/specky-artifact-validator.sh",
73
73
  "timeout": 10
74
74
  },
75
75
  {
76
76
  "type": "command",
77
- "command": "bash .claude/hooks/scripts/branch-validator.sh",
77
+ "command": "bash .claude/hooks/scripts/specky-branch-validator.sh",
78
78
  "timeout": 5
79
79
  }
80
80
  ]
@@ -84,12 +84,12 @@
84
84
  "hooks": [
85
85
  {
86
86
  "type": "command",
87
- "command": "bash .claude/hooks/scripts/artifact-validator.sh",
87
+ "command": "bash .claude/hooks/scripts/specky-artifact-validator.sh",
88
88
  "timeout": 10
89
89
  },
90
90
  {
91
91
  "type": "command",
92
- "command": "bash .claude/hooks/scripts/branch-validator.sh",
92
+ "command": "bash .claude/hooks/scripts/specky-branch-validator.sh",
93
93
  "timeout": 5
94
94
  }
95
95
  ]
@@ -99,12 +99,12 @@
99
99
  "hooks": [
100
100
  {
101
101
  "type": "command",
102
- "command": "bash .claude/hooks/scripts/artifact-validator.sh",
102
+ "command": "bash .claude/hooks/scripts/specky-artifact-validator.sh",
103
103
  "timeout": 10
104
104
  },
105
105
  {
106
106
  "type": "command",
107
- "command": "bash .claude/hooks/scripts/branch-validator.sh",
107
+ "command": "bash .claude/hooks/scripts/specky-branch-validator.sh",
108
108
  "timeout": 5
109
109
  }
110
110
  ]
@@ -114,12 +114,12 @@
114
114
  "hooks": [
115
115
  {
116
116
  "type": "command",
117
- "command": "bash .claude/hooks/scripts/artifact-validator.sh",
117
+ "command": "bash .claude/hooks/scripts/specky-artifact-validator.sh",
118
118
  "timeout": 10
119
119
  },
120
120
  {
121
121
  "type": "command",
122
- "command": "bash .claude/hooks/scripts/branch-validator.sh",
122
+ "command": "bash .claude/hooks/scripts/specky-branch-validator.sh",
123
123
  "timeout": 5
124
124
  }
125
125
  ]
@@ -129,12 +129,12 @@
129
129
  "hooks": [
130
130
  {
131
131
  "type": "command",
132
- "command": "bash .claude/hooks/scripts/artifact-validator.sh",
132
+ "command": "bash .claude/hooks/scripts/specky-artifact-validator.sh",
133
133
  "timeout": 10
134
134
  },
135
135
  {
136
136
  "type": "command",
137
- "command": "bash .claude/hooks/scripts/branch-validator.sh",
137
+ "command": "bash .claude/hooks/scripts/specky-branch-validator.sh",
138
138
  "timeout": 5
139
139
  }
140
140
  ]
@@ -144,22 +144,22 @@
144
144
  "hooks": [
145
145
  {
146
146
  "type": "command",
147
- "command": "bash .claude/hooks/scripts/artifact-validator.sh",
147
+ "command": "bash .claude/hooks/scripts/specky-artifact-validator.sh",
148
148
  "timeout": 10
149
149
  },
150
150
  {
151
151
  "type": "command",
152
- "command": "bash .claude/hooks/scripts/branch-validator.sh",
152
+ "command": "bash .claude/hooks/scripts/specky-branch-validator.sh",
153
153
  "timeout": 5
154
154
  },
155
155
  {
156
156
  "type": "command",
157
- "command": "bash .claude/hooks/scripts/security-scan.sh",
157
+ "command": "bash .claude/hooks/scripts/specky-security-scan.sh",
158
158
  "timeout": 30
159
159
  },
160
160
  {
161
161
  "type": "command",
162
- "command": "bash .claude/hooks/scripts/release-gate.sh",
162
+ "command": "bash .claude/hooks/scripts/specky-release-gate.sh",
163
163
  "timeout": 15
164
164
  }
165
165
  ]
@@ -169,7 +169,7 @@
169
169
  "hooks": [
170
170
  {
171
171
  "type": "command",
172
- "command": "bash .claude/hooks/scripts/branch-validator.sh",
172
+ "command": "bash .claude/hooks/scripts/specky-branch-validator.sh",
173
173
  "timeout": 5
174
174
  }
175
175
  ]
@@ -181,12 +181,12 @@
181
181
  "hooks": [
182
182
  {
183
183
  "type": "command",
184
- "command": "bash .claude/hooks/scripts/phase-gate.sh",
184
+ "command": "bash .claude/hooks/scripts/specky-phase-gate.sh",
185
185
  "timeout": 10
186
186
  },
187
187
  {
188
188
  "type": "command",
189
- "command": "bash .claude/hooks/scripts/auto-checkpoint.sh",
189
+ "command": "bash .claude/hooks/scripts/specky-auto-checkpoint.sh",
190
190
  "timeout": 5
191
191
  }
192
192
  ]
@@ -196,32 +196,32 @@
196
196
  "hooks": [
197
197
  {
198
198
  "type": "command",
199
- "command": "bash .claude/hooks/scripts/phase-gate.sh",
199
+ "command": "bash .claude/hooks/scripts/specky-phase-gate.sh",
200
200
  "timeout": 10
201
201
  },
202
202
  {
203
203
  "type": "command",
204
- "command": "bash .claude/hooks/scripts/spec-quality.sh",
204
+ "command": "bash .claude/hooks/scripts/specky-spec-quality.sh",
205
205
  "timeout": 10
206
206
  },
207
207
  {
208
208
  "type": "command",
209
- "command": "bash .claude/hooks/scripts/ears-validator.sh",
209
+ "command": "bash .claude/hooks/scripts/specky-ears-validator.sh",
210
210
  "timeout": 10
211
211
  },
212
212
  {
213
213
  "type": "command",
214
- "command": "bash .claude/hooks/scripts/lgtm-gate.sh",
214
+ "command": "bash .claude/hooks/scripts/specky-lgtm-gate.sh",
215
215
  "timeout": 5
216
216
  },
217
217
  {
218
218
  "type": "command",
219
- "command": "bash .claude/hooks/scripts/spec-sync.sh",
219
+ "command": "bash .claude/hooks/scripts/specky-spec-sync.sh",
220
220
  "timeout": 10
221
221
  },
222
222
  {
223
223
  "type": "command",
224
- "command": "bash .claude/hooks/scripts/auto-checkpoint.sh",
224
+ "command": "bash .claude/hooks/scripts/specky-auto-checkpoint.sh",
225
225
  "timeout": 5
226
226
  }
227
227
  ]
@@ -231,22 +231,22 @@
231
231
  "hooks": [
232
232
  {
233
233
  "type": "command",
234
- "command": "bash .claude/hooks/scripts/phase-gate.sh",
234
+ "command": "bash .claude/hooks/scripts/specky-phase-gate.sh",
235
235
  "timeout": 10
236
236
  },
237
237
  {
238
238
  "type": "command",
239
- "command": "bash .claude/hooks/scripts/spec-sync.sh",
239
+ "command": "bash .claude/hooks/scripts/specky-spec-sync.sh",
240
240
  "timeout": 10
241
241
  },
242
242
  {
243
243
  "type": "command",
244
- "command": "bash .claude/hooks/scripts/lgtm-gate.sh",
244
+ "command": "bash .claude/hooks/scripts/specky-lgtm-gate.sh",
245
245
  "timeout": 5
246
246
  },
247
247
  {
248
248
  "type": "command",
249
- "command": "bash .claude/hooks/scripts/auto-checkpoint.sh",
249
+ "command": "bash .claude/hooks/scripts/specky-auto-checkpoint.sh",
250
250
  "timeout": 5
251
251
  }
252
252
  ]
@@ -256,27 +256,27 @@
256
256
  "hooks": [
257
257
  {
258
258
  "type": "command",
259
- "command": "bash .claude/hooks/scripts/phase-gate.sh",
259
+ "command": "bash .claude/hooks/scripts/specky-phase-gate.sh",
260
260
  "timeout": 10
261
261
  },
262
262
  {
263
263
  "type": "command",
264
- "command": "bash .claude/hooks/scripts/task-tracer.sh",
264
+ "command": "bash .claude/hooks/scripts/specky-task-tracer.sh",
265
265
  "timeout": 10
266
266
  },
267
267
  {
268
268
  "type": "command",
269
- "command": "bash .claude/hooks/scripts/lgtm-gate.sh",
269
+ "command": "bash .claude/hooks/scripts/specky-lgtm-gate.sh",
270
270
  "timeout": 5
271
271
  },
272
272
  {
273
273
  "type": "command",
274
- "command": "bash .claude/hooks/scripts/spec-sync.sh",
274
+ "command": "bash .claude/hooks/scripts/specky-spec-sync.sh",
275
275
  "timeout": 10
276
276
  },
277
277
  {
278
278
  "type": "command",
279
- "command": "bash .claude/hooks/scripts/auto-checkpoint.sh",
279
+ "command": "bash .claude/hooks/scripts/specky-auto-checkpoint.sh",
280
280
  "timeout": 5
281
281
  }
282
282
  ]
@@ -286,7 +286,7 @@
286
286
  "hooks": [
287
287
  {
288
288
  "type": "command",
289
- "command": "bash .claude/hooks/scripts/auto-checkpoint.sh",
289
+ "command": "bash .claude/hooks/scripts/specky-auto-checkpoint.sh",
290
290
  "timeout": 5
291
291
  }
292
292
  ]
@@ -296,12 +296,12 @@
296
296
  "hooks": [
297
297
  {
298
298
  "type": "command",
299
- "command": "bash .claude/hooks/scripts/spec-sync.sh",
299
+ "command": "bash .claude/hooks/scripts/specky-spec-sync.sh",
300
300
  "timeout": 10
301
301
  },
302
302
  {
303
303
  "type": "command",
304
- "command": "bash .claude/hooks/scripts/auto-checkpoint.sh",
304
+ "command": "bash .claude/hooks/scripts/specky-auto-checkpoint.sh",
305
305
  "timeout": 5
306
306
  }
307
307
  ]
@@ -311,12 +311,12 @@
311
311
  "hooks": [
312
312
  {
313
313
  "type": "command",
314
- "command": "bash .claude/hooks/scripts/phase-gate.sh",
314
+ "command": "bash .claude/hooks/scripts/specky-phase-gate.sh",
315
315
  "timeout": 10
316
316
  },
317
317
  {
318
318
  "type": "command",
319
- "command": "bash .claude/hooks/scripts/drift-monitor.sh",
319
+ "command": "bash .claude/hooks/scripts/specky-drift-monitor.sh",
320
320
  "timeout": 10
321
321
  }
322
322
  ]
@@ -326,22 +326,22 @@
326
326
  "hooks": [
327
327
  {
328
328
  "type": "command",
329
- "command": "bash .claude/hooks/scripts/phase-gate.sh",
329
+ "command": "bash .claude/hooks/scripts/specky-phase-gate.sh",
330
330
  "timeout": 10
331
331
  },
332
332
  {
333
333
  "type": "command",
334
- "command": "bash .claude/hooks/scripts/cognitive-debt-alert.sh",
334
+ "command": "bash .claude/hooks/scripts/specky-cognitive-debt-alert.sh",
335
335
  "timeout": 10
336
336
  },
337
337
  {
338
338
  "type": "command",
339
- "command": "bash .claude/hooks/scripts/metrics-dashboard.sh",
339
+ "command": "bash .claude/hooks/scripts/specky-metrics-dashboard.sh",
340
340
  "timeout": 5
341
341
  },
342
342
  {
343
343
  "type": "command",
344
- "command": "bash .claude/hooks/scripts/drift-monitor.sh",
344
+ "command": "bash .claude/hooks/scripts/specky-drift-monitor.sh",
345
345
  "timeout": 10
346
346
  }
347
347
  ]
@@ -351,12 +351,12 @@
351
351
  "hooks": [
352
352
  {
353
353
  "type": "command",
354
- "command": "bash .claude/hooks/scripts/spec-sync.sh",
354
+ "command": "bash .claude/hooks/scripts/specky-spec-sync.sh",
355
355
  "timeout": 10
356
356
  },
357
357
  {
358
358
  "type": "command",
359
- "command": "bash .claude/hooks/scripts/auto-checkpoint.sh",
359
+ "command": "bash .claude/hooks/scripts/specky-auto-checkpoint.sh",
360
360
  "timeout": 5
361
361
  }
362
362
  ]
@@ -368,7 +368,7 @@
368
368
  "hooks": [
369
369
  {
370
370
  "type": "command",
371
- "command": "bash .claude/hooks/scripts/security-scan.sh",
371
+ "command": "bash .claude/hooks/scripts/specky-security-scan.sh",
372
372
  "timeout": 30
373
373
  }
374
374
  ]
@@ -0,0 +1,7 @@
1
+ export interface CompileOptions {
2
+ target?: string;
3
+ dryRun: boolean;
4
+ workspace?: string;
5
+ }
6
+ export declare function runCompile(opts: CompileOptions): Promise<number>;
7
+ //# sourceMappingURL=compile.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/compile.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,cAAc;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAyFD,wBAAsB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAsCtE"}
@@ -0,0 +1,127 @@
1
+ /**
2
+ * compile.ts — `specky compile` — compile instruction primitives into root
3
+ * context files for target harnesses.
4
+ */
5
+ import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
6
+ import { dirname, resolve } from "node:path";
7
+ import { getCompiler, SUPPORTED_TARGETS } from "../lib/harness/index.js";
8
+ import { packageRoot, sourcePaths } from "../lib/paths.js";
9
+ const TARGET_ALIASES = {
10
+ "github-copilot": "copilot",
11
+ vscode: "copilot",
12
+ "claude-code": "claude",
13
+ both: "both",
14
+ all: "all",
15
+ };
16
+ function uniqueTargets(targets) {
17
+ return [...new Set(targets)];
18
+ }
19
+ function parseTargetToken(token) {
20
+ const normalized = token.trim().toLowerCase();
21
+ const aliased = TARGET_ALIASES[normalized] ?? normalized;
22
+ if (aliased === "both")
23
+ return ["claude", "copilot"];
24
+ if (aliased === "all")
25
+ return SUPPORTED_TARGETS.filter((target) => target !== "agent-skills");
26
+ if (SUPPORTED_TARGETS.includes(aliased))
27
+ return [aliased];
28
+ throw new Error(`[specky compile] Unknown target "${token}". Supported targets: ${SUPPORTED_TARGETS.join(", ")}, both, all`);
29
+ }
30
+ function resolveTargets(target) {
31
+ if (!target || target === "auto")
32
+ return ["copilot"];
33
+ return uniqueTargets(target.split(",").flatMap(parseTargetToken));
34
+ }
35
+ function stripFrontmatter(content) {
36
+ if (!content.startsWith("---\n"))
37
+ return content;
38
+ const end = content.indexOf("\n---\n", 4);
39
+ if (end < 0)
40
+ return content;
41
+ return content.slice(end + "\n---\n".length).trimStart();
42
+ }
43
+ function instructionFileForTarget(target) {
44
+ switch (target) {
45
+ case "claude":
46
+ return "claude-instructions.instructions.md";
47
+ case "cursor":
48
+ case "opencode":
49
+ return "cursor-instructions.instructions.md";
50
+ default:
51
+ return "copilot-instructions.instructions.md";
52
+ }
53
+ }
54
+ /**
55
+ * Select the single instruction primitive for a target. Each target has its own
56
+ * native variant; the Copilot primitive is the neutral fallback. Never merge all
57
+ * primitives — that would leak cross-target naming and duplicate content.
58
+ */
59
+ function readInstructionForTarget(instructionsDir, target) {
60
+ if (!existsSync(instructionsDir))
61
+ return null;
62
+ const candidates = [
63
+ instructionFileForTarget(target),
64
+ "copilot-instructions.instructions.md",
65
+ ];
66
+ for (const candidate of candidates) {
67
+ const path = resolve(instructionsDir, candidate);
68
+ if (existsSync(path) && statSync(path).isFile()) {
69
+ return readFileSync(path, "utf8");
70
+ }
71
+ }
72
+ return null;
73
+ }
74
+ function outputPathForTarget(workspace, target) {
75
+ switch (target) {
76
+ case "copilot":
77
+ return resolve(workspace, ".github/copilot-instructions.md");
78
+ case "claude":
79
+ return resolve(workspace, "CLAUDE.md");
80
+ case "cursor":
81
+ case "opencode":
82
+ return resolve(workspace, "AGENTS.md");
83
+ case "agent-skills":
84
+ return null;
85
+ }
86
+ }
87
+ function writeCompiled(path, content, dryRun) {
88
+ if (dryRun)
89
+ return;
90
+ mkdirSync(dirname(path), { recursive: true });
91
+ writeFileSync(path, content, "utf8");
92
+ }
93
+ export async function runCompile(opts) {
94
+ const workspace = opts.workspace ?? process.cwd();
95
+ const pkg = packageRoot();
96
+ const src = sourcePaths(pkg);
97
+ const targets = resolveTargets(opts.target);
98
+ if (!existsSync(src.instructionsDir) || readdirSync(src.instructionsDir).length === 0) {
99
+ console.error(`[specky compile] No instruction primitives found at ${src.instructionsDir}`);
100
+ return 1;
101
+ }
102
+ const written = new Set();
103
+ for (const target of targets) {
104
+ const out = outputPathForTarget(workspace, target);
105
+ if (!out) {
106
+ console.log(`[specky compile] ${target}: no root context output`);
107
+ continue;
108
+ }
109
+ if (written.has(out)) {
110
+ console.log(`[specky compile] ${target}: already covered by ${out}`);
111
+ continue;
112
+ }
113
+ const content = readInstructionForTarget(src.instructionsDir, target);
114
+ if (!content) {
115
+ console.error(`[specky compile] ${target}: no instruction primitive found`);
116
+ continue;
117
+ }
118
+ const compiler = getCompiler(target);
119
+ const body = stripFrontmatter(compiler.compileInstruction(content));
120
+ const compiled = `<!-- Generated by Specky CLI from .apm/instructions -->\n\n${body}`;
121
+ writeCompiled(out, compiled, opts.dryRun);
122
+ written.add(out);
123
+ console.log(`[specky compile] ${target}: ${opts.dryRun ? "would write" : "wrote"} ${out}`);
124
+ }
125
+ return 0;
126
+ }
127
+ //# sourceMappingURL=compile.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compile.js","sourceRoot":"","sources":["../../../src/cli/commands/compile.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAoND,wBAAsB,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAkEpE"}
1
+ {"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAwXD,wBAAsB,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAkEpE"}