heraspec 0.1.14 → 0.1.16

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 (236) hide show
  1. package/LICENSE +187 -0
  2. package/README.md +140 -107
  3. package/bin/heraspec.js +1491 -155
  4. package/bin/heraspec.js.map +4 -4
  5. package/dist/cli/index.d.ts +2 -0
  6. package/dist/commands/audit.d.ts +37 -0
  7. package/dist/commands/create.d.ts +11 -0
  8. package/dist/commands/explore.d.ts +17 -0
  9. package/dist/commands/helper.d.ts +13 -0
  10. package/dist/commands/hotfix.d.ts +9 -0
  11. package/dist/commands/make-code.d.ts +14 -0
  12. package/dist/commands/make-docs.d.ts +36 -0
  13. package/dist/commands/make-test.d.ts +60 -0
  14. package/dist/commands/memory.d.ts +101 -0
  15. package/dist/commands/pack.d.ts +17 -0
  16. package/dist/commands/show.d.ts +8 -0
  17. package/dist/commands/skill.d.ts +8 -0
  18. package/dist/commands/suggest.d.ts +32 -0
  19. package/dist/commands/validate.d.ts +8 -0
  20. package/dist/core/archive.d.ts +14 -0
  21. package/dist/core/config.d.ts +33 -0
  22. package/dist/core/init.d.ts +97 -0
  23. package/dist/core/list.d.ts +7 -0
  24. package/dist/core/memory/config-advisor.d.ts +30 -0
  25. package/dist/core/memory/context-config.d.ts +14 -0
  26. package/dist/core/memory/context-generator.d.ts +19 -0
  27. package/dist/core/memory/index.d.ts +12 -0
  28. package/dist/core/memory/memory-schema.d.ts +34 -0
  29. package/dist/core/memory/memory-search.d.ts +45 -0
  30. package/dist/core/memory/memory-store.d.ts +71 -0
  31. package/dist/core/memory/memory-types.d.ts +159 -0
  32. package/dist/core/memory/memory-vector.d.ts +23 -0
  33. package/dist/core/parsers/code-parser.d.ts +53 -0
  34. package/dist/core/parsers/markdown-parser.d.ts +18 -0
  35. package/dist/core/restore.d.ts +9 -0
  36. package/dist/core/schemas/base.schema.d.ts +55 -0
  37. package/dist/core/schemas/change.schema.d.ts +35 -0
  38. package/dist/core/schemas/index.d.ts +7 -0
  39. package/dist/core/schemas/spec.schema.d.ts +50 -0
  40. package/dist/core/skills/index.d.ts +6 -0
  41. package/dist/core/skills/skill-manager.d.ts +28 -0
  42. package/dist/core/skills/skill-parser.d.ts +24 -0
  43. package/dist/core/sync.d.ts +6 -0
  44. package/dist/core/templates/index.d.ts +10 -0
  45. package/dist/core/templates/skills/README.md +44 -38
  46. package/dist/core/templates/skills/campaign-plan/skill.md +76 -0
  47. package/dist/core/templates/skills/campaign-plan/skill.vi.md +76 -0
  48. package/dist/core/templates/skills/campaign-plan-skill.md +76 -0
  49. package/dist/core/templates/skills/campaign-plan-skill.vi.md +76 -0
  50. package/dist/core/templates/skills/code-review/skill.md +70 -0
  51. package/dist/core/templates/skills/code-review/skill.vi.md +70 -0
  52. package/dist/core/templates/skills/code-review-skill.md +70 -0
  53. package/dist/core/templates/skills/code-review-skill.vi.md +70 -0
  54. package/dist/core/templates/skills/content-creation/skill.md +69 -0
  55. package/dist/core/templates/skills/content-creation/skill.vi.md +69 -0
  56. package/dist/core/templates/skills/content-creation-skill.md +69 -0
  57. package/dist/core/templates/skills/content-creation-skill.vi.md +69 -0
  58. package/dist/core/templates/skills/content-optimization/skill.md +104 -0
  59. package/dist/core/templates/skills/debug/skill.md +69 -0
  60. package/dist/core/templates/skills/debug/skill.vi.md +69 -0
  61. package/dist/core/templates/skills/debug-skill.md +69 -0
  62. package/dist/core/templates/skills/debug-skill.vi.md +69 -0
  63. package/dist/core/templates/skills/deploy-documentation/skill.md +408 -0
  64. package/dist/core/templates/skills/design-system/knowledge/design-systems/airbnb/DESIGN.md +246 -0
  65. package/dist/core/templates/skills/design-system/knowledge/design-systems/airtable/DESIGN.md +89 -0
  66. package/dist/core/templates/skills/design-system/knowledge/design-systems/apple/DESIGN.md +313 -0
  67. package/dist/core/templates/skills/design-system/knowledge/design-systems/bmw/DESIGN.md +180 -0
  68. package/dist/core/templates/skills/design-system/knowledge/design-systems/cal/DESIGN.md +259 -0
  69. package/dist/core/templates/skills/design-system/knowledge/design-systems/claude/DESIGN.md +312 -0
  70. package/dist/core/templates/skills/design-system/knowledge/design-systems/clay/DESIGN.md +304 -0
  71. package/dist/core/templates/skills/design-system/knowledge/design-systems/clickhouse/DESIGN.md +281 -0
  72. package/dist/core/templates/skills/design-system/knowledge/design-systems/cohere/DESIGN.md +266 -0
  73. package/dist/core/templates/skills/design-system/knowledge/design-systems/coinbase/DESIGN.md +129 -0
  74. package/dist/core/templates/skills/design-system/knowledge/design-systems/composio/DESIGN.md +307 -0
  75. package/dist/core/templates/skills/design-system/knowledge/design-systems/cursor/DESIGN.md +309 -0
  76. package/dist/core/templates/skills/design-system/knowledge/design-systems/elevenlabs/DESIGN.md +265 -0
  77. package/dist/core/templates/skills/design-system/knowledge/design-systems/expo/DESIGN.md +281 -0
  78. package/dist/core/templates/skills/design-system/knowledge/design-systems/figma/DESIGN.md +220 -0
  79. package/dist/core/templates/skills/design-system/knowledge/design-systems/framer/DESIGN.md +246 -0
  80. package/dist/core/templates/skills/design-system/knowledge/design-systems/hashicorp/DESIGN.md +278 -0
  81. package/dist/core/templates/skills/design-system/knowledge/design-systems/ibm/DESIGN.md +332 -0
  82. package/dist/core/templates/skills/design-system/knowledge/design-systems/index.json +72 -0
  83. package/dist/core/templates/skills/design-system/knowledge/design-systems/intercom/DESIGN.md +146 -0
  84. package/dist/core/templates/skills/design-system/knowledge/design-systems/kraken/DESIGN.md +125 -0
  85. package/dist/core/templates/skills/design-system/knowledge/design-systems/linear.app/DESIGN.md +367 -0
  86. package/dist/core/templates/skills/design-system/knowledge/design-systems/lovable/DESIGN.md +298 -0
  87. package/dist/core/templates/skills/design-system/knowledge/design-systems/minimax/DESIGN.md +257 -0
  88. package/dist/core/templates/skills/design-system/knowledge/design-systems/mintlify/DESIGN.md +326 -0
  89. package/dist/core/templates/skills/design-system/knowledge/design-systems/miro/DESIGN.md +108 -0
  90. package/dist/core/templates/skills/design-system/knowledge/design-systems/mistral.ai/DESIGN.md +261 -0
  91. package/dist/core/templates/skills/design-system/knowledge/design-systems/mongodb/DESIGN.md +266 -0
  92. package/dist/core/templates/skills/design-system/knowledge/design-systems/notion/DESIGN.md +309 -0
  93. package/dist/core/templates/skills/design-system/knowledge/design-systems/nvidia/DESIGN.md +293 -0
  94. package/dist/core/templates/skills/design-system/knowledge/design-systems/ollama/DESIGN.md +267 -0
  95. package/dist/core/templates/skills/design-system/knowledge/design-systems/opencode.ai/DESIGN.md +281 -0
  96. package/dist/core/templates/skills/design-system/knowledge/design-systems/pinterest/DESIGN.md +230 -0
  97. package/dist/core/templates/skills/design-system/knowledge/design-systems/posthog/DESIGN.md +256 -0
  98. package/dist/core/templates/skills/design-system/knowledge/design-systems/raycast/DESIGN.md +268 -0
  99. package/dist/core/templates/skills/design-system/knowledge/design-systems/replicate/DESIGN.md +261 -0
  100. package/dist/core/templates/skills/design-system/knowledge/design-systems/resend/DESIGN.md +303 -0
  101. package/dist/core/templates/skills/design-system/knowledge/design-systems/revolut/DESIGN.md +185 -0
  102. package/dist/core/templates/skills/design-system/knowledge/design-systems/runwayml/DESIGN.md +244 -0
  103. package/dist/core/templates/skills/design-system/knowledge/design-systems/sanity/DESIGN.md +357 -0
  104. package/dist/core/templates/skills/design-system/knowledge/design-systems/sentry/DESIGN.md +262 -0
  105. package/dist/core/templates/skills/design-system/knowledge/design-systems/spacex/DESIGN.md +194 -0
  106. package/dist/core/templates/skills/design-system/knowledge/design-systems/spotify/DESIGN.md +246 -0
  107. package/dist/core/templates/skills/design-system/knowledge/design-systems/stripe/DESIGN.md +322 -0
  108. package/dist/core/templates/skills/design-system/knowledge/design-systems/supabase/DESIGN.md +255 -0
  109. package/dist/core/templates/skills/design-system/knowledge/design-systems/superhuman/DESIGN.md +252 -0
  110. package/dist/core/templates/skills/design-system/knowledge/design-systems/together.ai/DESIGN.md +263 -0
  111. package/dist/core/templates/skills/design-system/knowledge/design-systems/uber/DESIGN.md +295 -0
  112. package/dist/core/templates/skills/design-system/knowledge/design-systems/vercel/DESIGN.md +310 -0
  113. package/dist/core/templates/skills/design-system/knowledge/design-systems/voltagent/DESIGN.md +323 -0
  114. package/dist/core/templates/skills/design-system/knowledge/design-systems/warp/DESIGN.md +253 -0
  115. package/dist/core/templates/skills/design-system/knowledge/design-systems/webflow/DESIGN.md +92 -0
  116. package/dist/core/templates/skills/design-system/knowledge/design-systems/wise/DESIGN.md +173 -0
  117. package/dist/core/templates/skills/design-system/knowledge/design-systems/x.ai/DESIGN.md +257 -0
  118. package/dist/core/templates/skills/design-system/knowledge/design-systems/zapier/DESIGN.md +328 -0
  119. package/dist/core/templates/skills/design-system/skill.md +176 -0
  120. package/dist/core/templates/skills/documents/skill.md +104 -0
  121. package/dist/core/templates/skills/e2e-test/skill.md +119 -0
  122. package/dist/core/templates/skills/email-sequence/skill.md +68 -0
  123. package/dist/core/templates/skills/email-sequence/skill.vi.md +68 -0
  124. package/dist/core/templates/skills/email-sequence-skill.md +68 -0
  125. package/dist/core/templates/skills/email-sequence-skill.vi.md +68 -0
  126. package/dist/core/templates/skills/git-embed/skill.md +57 -0
  127. package/dist/core/templates/skills/integration-test/skill.md +118 -0
  128. package/dist/core/templates/skills/knowledge/README.md +63 -63
  129. package/dist/core/templates/skills/knowledge/design-systems/index.json +72 -72
  130. package/dist/core/templates/skills/knowledge/frameworks/php/codeigniter/rise-cms/profile.json +27 -27
  131. package/dist/core/templates/skills/knowledge/frameworks/php/codeigniter/rise-cms/structure.md +137 -137
  132. package/dist/core/templates/skills/knowledge/frameworks/php/laravel/botble/profile.json +39 -39
  133. package/dist/core/templates/skills/knowledge/frameworks/php/laravel/botble/structure.md +207 -207
  134. package/dist/core/templates/skills/knowledge/frameworks/php/wordpress/core/profile.json +51 -51
  135. package/dist/core/templates/skills/knowledge/frameworks/php/wordpress/core/structure.md +369 -369
  136. package/dist/core/templates/skills/knowledge/index.json +65 -65
  137. package/dist/core/templates/skills/perfex-module/code-quality-guidelines/skill.md +130 -0
  138. package/dist/core/templates/skills/perfex-module/envato-review-guidelines/skill.md +132 -0
  139. package/dist/core/templates/skills/perfex-module/module-codebase/scripts/scaffold-module.js +151 -0
  140. package/dist/core/templates/skills/perfex-module/module-codebase/skill.md +204 -0
  141. package/dist/core/templates/skills/perfex-module/module-codebase/templates/Test_Module.php +79 -0
  142. package/dist/core/templates/skills/perfex-module/module-codebase/templates/controller-admin.php +71 -0
  143. package/dist/core/templates/skills/perfex-module/module-codebase/templates/controller-api.php +58 -0
  144. package/dist/core/templates/skills/perfex-module/module-codebase/templates/deploy.ps1 +97 -0
  145. package/dist/core/templates/skills/perfex-module/module-codebase/templates/helper.php +97 -0
  146. package/dist/core/templates/skills/perfex-module/module-codebase/templates/install.php +30 -0
  147. package/dist/core/templates/skills/perfex-module/module-codebase/templates/model-main.php +94 -0
  148. package/dist/core/templates/skills/perfex-module/module-codebase/templates/module-main.php +91 -0
  149. package/dist/core/templates/skills/perfex-module/module-codebase/templates/package.json +30 -0
  150. package/dist/core/templates/skills/perfex-module/module-codebase/templates/uninstall.php +11 -0
  151. package/dist/core/templates/skills/perfex-module/module-codebase/templates/webpack.config.js +163 -0
  152. package/dist/core/templates/skills/perfex-module/skill.md +50 -0
  153. package/dist/core/templates/skills/project-memory/skill.md +222 -0
  154. package/dist/core/templates/skills/project-memory/skill.vi.md +223 -0
  155. package/dist/core/templates/skills/seo-audit/skill.md +75 -0
  156. package/dist/core/templates/skills/seo-audit/skill.vi.md +75 -0
  157. package/dist/core/templates/skills/seo-audit-skill.md +75 -0
  158. package/dist/core/templates/skills/seo-audit-skill.vi.md +75 -0
  159. package/dist/core/templates/skills/smart-explore/skill.md +141 -0
  160. package/dist/core/templates/skills/sourcecode-analyzer/skill.md +210 -0
  161. package/dist/core/templates/skills/sourcecode-analyzer/skill.vi.md +210 -0
  162. package/dist/core/templates/skills/spec-writer/skill.md +61 -0
  163. package/dist/core/templates/skills/spec-writer/skill.vi.md +61 -0
  164. package/dist/core/templates/skills/spec-writer-skill.md +61 -0
  165. package/dist/core/templates/skills/spec-writer-skill.vi.md +61 -0
  166. package/dist/core/templates/skills/sql-queries/skill.md +67 -0
  167. package/dist/core/templates/skills/sql-queries/skill.vi.md +67 -0
  168. package/dist/core/templates/skills/sql-queries-skill.md +67 -0
  169. package/dist/core/templates/skills/sql-queries-skill.vi.md +67 -0
  170. package/dist/core/templates/skills/suggestion/skill.md +118 -0
  171. package/dist/core/templates/skills/system-design/skill.md +70 -0
  172. package/dist/core/templates/skills/system-design/skill.vi.md +70 -0
  173. package/dist/core/templates/skills/system-design-skill.md +70 -0
  174. package/dist/core/templates/skills/system-design-skill.vi.md +70 -0
  175. package/dist/core/templates/skills/tech-debt/skill.md +70 -0
  176. package/dist/core/templates/skills/tech-debt/skill.vi.md +70 -0
  177. package/dist/core/templates/skills/tech-debt-skill.md +70 -0
  178. package/dist/core/templates/skills/tech-debt-skill.vi.md +70 -0
  179. package/dist/core/templates/skills/ui-ux/data/charts.csv +26 -0
  180. package/dist/core/templates/skills/ui-ux/data/colors.csv +97 -0
  181. package/dist/core/templates/skills/ui-ux/data/design-systems.csv +54 -0
  182. package/dist/core/templates/skills/ui-ux/data/landing.csv +31 -0
  183. package/dist/core/templates/skills/ui-ux/data/pages-proposed.csv +22 -0
  184. package/dist/core/templates/skills/ui-ux/data/pages.csv +10 -0
  185. package/dist/core/templates/skills/ui-ux/data/products.csv +97 -0
  186. package/dist/core/templates/skills/ui-ux/data/prompts.csv +24 -0
  187. package/dist/core/templates/skills/ui-ux/data/stacks/flutter.csv +53 -0
  188. package/dist/core/templates/skills/ui-ux/data/stacks/html-tailwind.csv +56 -0
  189. package/dist/core/templates/skills/ui-ux/data/stacks/nextjs.csv +53 -0
  190. package/dist/core/templates/skills/ui-ux/data/stacks/react-native.csv +52 -0
  191. package/dist/core/templates/skills/ui-ux/data/stacks/react.csv +54 -0
  192. package/dist/core/templates/skills/ui-ux/data/stacks/svelte.csv +54 -0
  193. package/dist/core/templates/skills/ui-ux/data/stacks/swiftui.csv +51 -0
  194. package/dist/core/templates/skills/ui-ux/data/stacks/vue.csv +50 -0
  195. package/dist/core/templates/skills/ui-ux/data/styles.csv +59 -0
  196. package/dist/core/templates/skills/ui-ux/data/typography.csv +58 -0
  197. package/dist/core/templates/skills/ui-ux/data/ux-guidelines.csv +100 -0
  198. package/dist/core/templates/skills/ui-ux/scripts/CODE_EXPLANATION.md +394 -0
  199. package/dist/core/templates/skills/ui-ux/scripts/SEARCH_ALGORITHMS_COMPARISON.md +421 -0
  200. package/dist/core/templates/skills/ui-ux/scripts/SEARCH_MODES_GUIDE.md +238 -0
  201. package/dist/core/templates/skills/ui-ux/scripts/core.py +391 -0
  202. package/dist/core/templates/skills/ui-ux/scripts/search.py +73 -0
  203. package/dist/core/templates/skills/ui-ux/skill.md +595 -0
  204. package/dist/core/templates/skills/ui-ux/templates/accessibility-checklist.md +40 -0
  205. package/dist/core/templates/skills/ui-ux/templates/example-prompt-full-theme.md +333 -0
  206. package/dist/core/templates/skills/ui-ux/templates/page-types-guide.md +338 -0
  207. package/dist/core/templates/skills/ui-ux/templates/pages-proposed-summary.md +273 -0
  208. package/dist/core/templates/skills/ui-ux/templates/pre-delivery-checklist.md +42 -0
  209. package/dist/core/templates/skills/ui-ux/templates/prompt-template-full-theme.md +313 -0
  210. package/dist/core/templates/skills/ui-ux/templates/responsive-design.md +40 -0
  211. package/dist/core/templates/skills/unit-test/skill.md +111 -0
  212. package/dist/core/templates/skills/wordpress/plugin-check/skill.md +151 -0
  213. package/dist/core/templates/skills/wordpress/plugin-directory/skill.md +396 -0
  214. package/dist/core/templates/skills/wordpress/plugin-standard/skill.md +100 -0
  215. package/dist/core/templates/skills/wordpress/plugin-standard/templates/admin-dashboard.php +47 -0
  216. package/dist/core/templates/skills/wordpress/plugin-standard/templates/admin-settings.php +60 -0
  217. package/dist/core/templates/skills/wordpress/plugin-standard/templates/assets/admin-css.css +22 -0
  218. package/dist/core/templates/skills/wordpress/plugin-standard/templates/assets/admin-js.js +15 -0
  219. package/dist/core/templates/skills/wordpress/plugin-standard/templates/plugin-main.php +169 -0
  220. package/dist/core/templates/skills/wordpress/plugin-standard/templates/readme.txt +41 -0
  221. package/dist/core/templates/skills/wordpress/plugin-standard/templates/uninstall.php +21 -0
  222. package/dist/core/templates/skills/wordpress/ux-element/skill.md +83 -0
  223. package/dist/core/templates/skills/wordpress/ux-element/templates/Controller.php +50 -0
  224. package/dist/core/templates/skills/wordpress/ux-element/templates/Shortcode.php +23 -0
  225. package/dist/core/templates/skills/wordpress/ux-element/templates/Template.html +20 -0
  226. package/dist/core/templates/skills/wordpress/ux-element/templates/Thumbnail.svg +8 -0
  227. package/dist/core/templates/skills/wordpress/ux-element/templates/View.php +21 -0
  228. package/dist/core/templates/skills-template-map.d.ts +29 -0
  229. package/dist/core/validation/validator.d.ts +26 -0
  230. package/dist/core/view.d.ts +4 -0
  231. package/dist/index.d.ts +11 -0
  232. package/dist/index.js +350 -114
  233. package/dist/utils/file-system.d.ts +19 -0
  234. package/dist/utils/index.d.ts +6 -0
  235. package/dist/utils/task-parser.d.ts +26 -0
  236. package/package.json +2 -2
package/dist/index.js CHANGED
@@ -63,6 +63,8 @@ var init_config = __esm({
63
63
  ],
64
64
  "perfex-module": [
65
65
  "module-codebase",
66
+ "code-quality-guidelines",
67
+ "envato-review-guidelines",
66
68
  "module-registration",
67
69
  "permission-group",
68
70
  "admin-menu-item",
@@ -294,95 +296,168 @@ var init_skills_template_map = __esm({
294
296
  SKILL_TEMPLATE_MAP = {
295
297
  // Cross-cutting skills
296
298
  "ui-ux": {
297
- templateFileName: "ui-ux-skill.md",
299
+ templateFileName: "ui-ux/skill.md",
298
300
  isCrossCutting: true,
299
- resourceDirs: ["scripts", "templates", "data"]
301
+ resourceDirs: ["ui-ux/scripts", "ui-ux/templates", "ui-ux/data"]
300
302
  },
301
303
  "design-system": {
302
- templateFileName: "design-system-skill.md",
304
+ templateFileName: "design-system/skill.md",
303
305
  isCrossCutting: true,
304
- resourceDirs: ["scripts", "data", "knowledge/design-systems"]
306
+ resourceDirs: ["ui-ux/scripts", "ui-ux/data", "design-system/knowledge/design-systems"]
305
307
  },
306
308
  "documents": {
307
- templateFileName: "documents-skill.md",
309
+ templateFileName: "documents/skill.md",
308
310
  isCrossCutting: true,
309
311
  resourceDirs: ["documents/templates"]
310
312
  },
311
313
  "content-optimization": {
312
- templateFileName: "content-optimization-skill.md",
314
+ templateFileName: "content-optimization/skill.md",
313
315
  isCrossCutting: true
314
316
  },
315
317
  "unit-test": {
316
- templateFileName: "unit-test-skill.md",
318
+ templateFileName: "unit-test/skill.md",
317
319
  isCrossCutting: true
318
320
  },
319
321
  "integration-test": {
320
- templateFileName: "integration-test-skill.md",
322
+ templateFileName: "integration-test/skill.md",
321
323
  isCrossCutting: true
322
324
  },
323
325
  "e2e-test": {
324
- templateFileName: "e2e-test-skill.md",
326
+ templateFileName: "e2e-test/skill.md",
325
327
  isCrossCutting: true
326
328
  },
327
329
  "suggestion": {
328
- templateFileName: "suggestion-skill.md",
330
+ templateFileName: "suggestion/skill.md",
329
331
  isCrossCutting: true
330
332
  },
331
333
  "sourcecode-analyzer": {
332
- templateFileName: "sourcecode-analyzer-skill.md",
334
+ templateFileName: "sourcecode-analyzer/skill.md",
333
335
  isCrossCutting: true,
334
- viFileName: "sourcecode-analyzer-skill.vi.md"
336
+ viFileName: "sourcecode-analyzer/skill.vi.md"
335
337
  },
336
338
  "project-memory": {
337
- templateFileName: "project-memory-skill.md",
338
- viFileName: "project-memory-skill.vi.md",
339
+ templateFileName: "project-memory/skill.md",
340
+ viFileName: "project-memory/skill.vi.md",
339
341
  isCrossCutting: true
340
342
  },
341
343
  "smart-explore": {
342
- templateFileName: "smart-explore-skill.md",
344
+ templateFileName: "smart-explore/skill.md",
343
345
  isCrossCutting: true
344
346
  },
345
347
  "deploy-documentation": {
346
- templateFileName: "deploy-documentation-skill.md",
348
+ templateFileName: "deploy-documentation/skill.md",
347
349
  isCrossCutting: true,
348
- resourceDirs: ["templates"]
350
+ resourceDirs: ["ui-ux/templates"]
351
+ },
352
+ "code-review": {
353
+ templateFileName: "code-review/skill.md",
354
+ viFileName: "code-review/skill.vi.md",
355
+ isCrossCutting: true
356
+ },
357
+ "debug": {
358
+ templateFileName: "debug/skill.md",
359
+ viFileName: "debug/skill.vi.md",
360
+ isCrossCutting: true
361
+ },
362
+ "system-design": {
363
+ templateFileName: "system-design/skill.md",
364
+ viFileName: "system-design/skill.vi.md",
365
+ isCrossCutting: true
366
+ },
367
+ "tech-debt": {
368
+ templateFileName: "tech-debt/skill.md",
369
+ viFileName: "tech-debt/skill.vi.md",
370
+ isCrossCutting: true
371
+ },
372
+ "spec-writer": {
373
+ templateFileName: "spec-writer/skill.md",
374
+ viFileName: "spec-writer/skill.vi.md",
375
+ isCrossCutting: true
376
+ },
377
+ "seo-audit": {
378
+ templateFileName: "seo-audit/skill.md",
379
+ viFileName: "seo-audit/skill.vi.md",
380
+ isCrossCutting: true
381
+ },
382
+ "campaign-plan": {
383
+ templateFileName: "campaign-plan/skill.md",
384
+ viFileName: "campaign-plan/skill.vi.md",
385
+ isCrossCutting: true
386
+ },
387
+ "content-creation": {
388
+ templateFileName: "content-creation/skill.md",
389
+ viFileName: "content-creation/skill.vi.md",
390
+ isCrossCutting: true
391
+ },
392
+ "email-sequence": {
393
+ templateFileName: "email-sequence/skill.md",
394
+ viFileName: "email-sequence/skill.vi.md",
395
+ isCrossCutting: true
396
+ },
397
+ "sql-queries": {
398
+ templateFileName: "sql-queries/skill.md",
399
+ viFileName: "sql-queries/skill.vi.md",
400
+ isCrossCutting: true
349
401
  },
350
402
  // Perfex module skills
403
+ "perfex-module": {
404
+ templateFileName: "perfex-module/skill.md",
405
+ isCrossCutting: true,
406
+ resourceDirs: [
407
+ "perfex-module/module-codebase",
408
+ "perfex-module/code-quality-guidelines",
409
+ "perfex-module/envato-review-guidelines"
410
+ ]
411
+ },
351
412
  "perfex-module:module-codebase": {
352
- templateFileName: "module-codebase-skill.md",
413
+ templateFileName: "perfex-module/module-codebase/skill.md",
414
+ isCrossCutting: false,
415
+ projectType: "perfex-module",
416
+ resourceDirs: [
417
+ "perfex-module/module-codebase/templates",
418
+ "perfex-module/module-codebase/scripts"
419
+ ]
420
+ },
421
+ "perfex-module:code-quality-guidelines": {
422
+ templateFileName: "perfex-module/code-quality-guidelines/skill.md",
423
+ isCrossCutting: false,
424
+ projectType: "perfex-module"
425
+ },
426
+ "perfex-module:envato-review-guidelines": {
427
+ templateFileName: "perfex-module/envato-review-guidelines/skill.md",
353
428
  isCrossCutting: false,
354
429
  projectType: "perfex-module"
355
430
  },
356
431
  "wordpress:ux-element": {
357
- templateFileName: "ux-element-skill.md",
432
+ templateFileName: "wordpress/ux-element/skill.md",
358
433
  isCrossCutting: false,
359
434
  projectType: "wordpress",
360
- resourceDirs: ["ux-element/templates"]
435
+ resourceDirs: ["wordpress/ux-element/templates"]
361
436
  },
362
437
  "wordpress:plugin-standard": {
363
- templateFileName: "wordpress-plugin-standard-skill.md",
438
+ templateFileName: "wordpress/plugin-standard/skill.md",
364
439
  isCrossCutting: false,
365
440
  projectType: "wordpress",
366
- resourceDirs: ["wordpress-plugin-standard/templates"]
441
+ resourceDirs: ["wordpress/plugin-standard/templates"]
367
442
  },
368
443
  "wordpress:plugin-check": {
369
- templateFileName: "wordpress-plugin-check-skill.md",
444
+ templateFileName: "wordpress/plugin-check/skill.md",
370
445
  isCrossCutting: false,
371
446
  projectType: "wordpress"
372
447
  },
373
448
  "wordpress:plugin-directory": {
374
- templateFileName: "plugin-directory-skill.md",
449
+ templateFileName: "wordpress/plugin-directory/skill.md",
375
450
  isCrossCutting: false,
376
451
  projectType: "wordpress"
377
452
  },
378
453
  // WordPress Plugin specific (matches PROJECT_TYPES)
379
454
  "wordpress-plugin:plugin-check": {
380
- templateFileName: "wordpress-plugin-check-skill.md",
455
+ templateFileName: "wordpress/plugin-check/skill.md",
381
456
  isCrossCutting: false,
382
457
  projectType: "wordpress-plugin"
383
458
  },
384
459
  "wordpress-plugin:plugin-directory": {
385
- templateFileName: "plugin-directory-skill.md",
460
+ templateFileName: "wordpress/plugin-directory/skill.md",
386
461
  isCrossCutting: false,
387
462
  projectType: "wordpress-plugin"
388
463
  }
@@ -2593,8 +2668,12 @@ var init_skill_parser = __esm({
2593
2668
  const sectionName = line.replace(/^##+\s+/, "").toLowerCase();
2594
2669
  currentSection = sectionName;
2595
2670
  if (sectionName.includes("m\u1EE5c \u0111\xEDch") || sectionName.includes("purpose")) {
2596
- if (i + 1 < lines.length && lines[i + 1].trim()) {
2597
- skill.purpose = lines[i + 1].trim();
2671
+ for (let j = i + 1; j < lines.length && !lines[j].startsWith("##"); j++) {
2672
+ const nextLine = lines[j].trim();
2673
+ if (nextLine) {
2674
+ skill.purpose = nextLine;
2675
+ break;
2676
+ }
2598
2677
  }
2599
2678
  }
2600
2679
  continue;
@@ -2701,7 +2780,7 @@ var init_skill_manager = __esm({
2701
2780
  projectType,
2702
2781
  skillName
2703
2782
  );
2704
- if (await FileSystemUtils.fileExists(path6.join(projectSkillPath, "skill.md"))) {
2783
+ if (await FileSystemUtils.fileExists(path6.join(projectSkillPath, "skill.md")) || await FileSystemUtils.fileExists(path6.join(projectSkillPath, "SKILL.md"))) {
2705
2784
  return projectSkillPath;
2706
2785
  }
2707
2786
  const crossCuttingPath = path6.join(
@@ -2710,7 +2789,7 @@ var init_skill_manager = __esm({
2710
2789
  SKILLS_DIR_NAME,
2711
2790
  skillName
2712
2791
  );
2713
- if (await FileSystemUtils.fileExists(path6.join(crossCuttingPath, "skill.md"))) {
2792
+ if (await FileSystemUtils.fileExists(path6.join(crossCuttingPath, "skill.md")) || await FileSystemUtils.fileExists(path6.join(crossCuttingPath, "SKILL.md"))) {
2714
2793
  return crossCuttingPath;
2715
2794
  }
2716
2795
  return null;
@@ -2748,9 +2827,15 @@ var init_skill_manager = __esm({
2748
2827
  if (isProjectType) {
2749
2828
  const projectSkills = await this.listSkillsInDirectory(entryPath, entry);
2750
2829
  skills.push(...projectSkills);
2830
+ if (await FileSystemUtils.fileExists(path6.join(entryPath, "skill.md")) || await FileSystemUtils.fileExists(path6.join(entryPath, "SKILL.md"))) {
2831
+ skills.push({
2832
+ projectType: entry,
2833
+ skillName: entry,
2834
+ path: entryPath
2835
+ });
2836
+ }
2751
2837
  } else {
2752
- const skillMdPath = path6.join(entryPath, "skill.md");
2753
- if (await FileSystemUtils.fileExists(skillMdPath)) {
2838
+ if (await FileSystemUtils.fileExists(path6.join(entryPath, "skill.md")) || await FileSystemUtils.fileExists(path6.join(entryPath, "SKILL.md"))) {
2754
2839
  skills.push({
2755
2840
  skillName: entry,
2756
2841
  path: entryPath
@@ -2787,8 +2872,7 @@ var init_skill_manager = __esm({
2787
2872
  const entryPath = path6.join(dir, entry);
2788
2873
  const stats = await FileSystemUtils.stat(entryPath);
2789
2874
  if (stats.isDirectory()) {
2790
- const skillMdPath = path6.join(entryPath, "skill.md");
2791
- if (await FileSystemUtils.fileExists(skillMdPath)) {
2875
+ if (await FileSystemUtils.fileExists(path6.join(entryPath, "skill.md")) || await FileSystemUtils.fileExists(path6.join(entryPath, "SKILL.md"))) {
2792
2876
  skills.push({
2793
2877
  projectType,
2794
2878
  skillName: entry,
@@ -3121,17 +3205,7 @@ var init_skill = __esm({
3121
3205
  }
3122
3206
  const isUpdate = await FileSystemUtils.fileExists(destPath);
3123
3207
  if (isUpdate) {
3124
- spinner.info(`Skill "${skillName}" already exists at ${destPath}`);
3125
- spinner.start(`Removing old version to update with latest...`);
3126
- try {
3127
- await FileSystemUtils.removeDirectory(destPath, true);
3128
- spinner.succeed(`Removed old skill "${skillName}"`);
3129
- } catch (error) {
3130
- spinner.fail(`Failed to remove old skill: ${error instanceof Error ? error.message : "Unknown error"}`);
3131
- process.exitCode = 1;
3132
- return;
3133
- }
3134
- spinner.start(`Adding updated skill "${skillName}"...`);
3208
+ spinner.info(`Skill "${skillName}" already exists at ${destPath} - updating template files (custom files preserved)...`);
3135
3209
  }
3136
3210
  await FileSystemUtils.createDirectory(destPath);
3137
3211
  const coreTemplatesDir = await getCoreTemplatesDir();
@@ -3147,6 +3221,10 @@ var init_skill = __esm({
3147
3221
  return;
3148
3222
  }
3149
3223
  await FileSystemUtils.copyFile(templateFile, path7.join(destPath, "skill.md"));
3224
+ const upperTemplateFile = path7.join(path7.dirname(templateFile), "SKILL.md");
3225
+ if (await FileSystemUtils.fileExists(upperTemplateFile)) {
3226
+ await FileSystemUtils.copyFile(upperTemplateFile, path7.join(destPath, "SKILL.md"));
3227
+ }
3150
3228
  if (templateInfo.viFileName) {
3151
3229
  const viFile = path7.join(coreTemplatesDir, templateInfo.viFileName);
3152
3230
  if (await FileSystemUtils.fileExists(viFile)) {
@@ -3156,7 +3234,7 @@ var init_skill = __esm({
3156
3234
  if (templateInfo.resourceDirs) {
3157
3235
  for (const resourceDir of templateInfo.resourceDirs) {
3158
3236
  const srcResourceDir = path7.join(coreTemplatesDir, resourceDir);
3159
- const destResourceDir = path7.join(destPath, resourceDir);
3237
+ const destResourceDir = path7.join(destPath, path7.basename(resourceDir));
3160
3238
  if (await FileSystemUtils.fileExists(srcResourceDir)) {
3161
3239
  await FileSystemUtils.copyDirectory(srcResourceDir, destResourceDir);
3162
3240
  }
@@ -3312,6 +3390,7 @@ This document defines the workflow for AI agents working with HeraSpec.
3312
3390
  - **SKILL PREREQUISITE**: If a task maps to a skill (e.g., "Generate documentation"), you **MUST** verify the skill folder exists in \`heraspec/skills/\`. If missing:
3313
3391
  - **Preferred**: Proactively install it via \`heraspec skill add <name>\` (e.g., \`heraspec skill add documents\`) if you have terminal access.
3314
3392
  - **Fallback**: If you cannot install it, **STOP** and ask the user to add it. **DO NOT** attempt manual generation without the skill.
3393
+ - **IGNORE VIETNAMESE SKILL FILES**: When reading and executing skill workflows, you **MUST ONLY** look at the English version of the skill instructions (e.g., \`skill.md\`). You **MUST completely ignore** all Vietnamese versions (e.g., \`skill.vi.md\` or files ending with \`*.vi.md\`). These Vietnamese files are for reference/development purposes by the user only.
3315
3394
  - **USER CONFIRMATION**: For destructive actions or public releases, always request explicit User approval first.
3316
3395
 
3317
3396
  ### Restricted Commands (REQUIRE USER CONFIRMATION)
@@ -3402,6 +3481,7 @@ The following commands are classified by risk level. You **MUST NOT** execute th
3402
3481
  - Understand purpose, steps, inputs, outputs
3403
3482
  - Follow tone, rules, and limitations
3404
3483
  - Check available templates and scripts
3484
+ - **Ignore Vietnamese Skill Files**: Only read the English \`skill.md\` instructions. Completely ignore any \`*.vi.md\` translation files.
3405
3485
 
3406
3486
  4. **Use skill resources**:
3407
3487
  - Run scripts from \`scripts/\` folder if needed
@@ -3478,6 +3558,24 @@ The following commands are classified by risk level. You **MUST NOT** execute th
3478
3558
  - **CRITICAL**: Agent MUST present full report and **wait for user confirmation** before making changes
3479
3559
  - Reference guideline numbers (e.g., "Guideline 7: User Tracking Consent")
3480
3560
 
3561
+ **Special case - Perfex Module Engineering skills:**
3562
+ - Tasks: \`(projectType: perfex-module, skill: module-codebase)\` or \`(projectType: perfex-module, skill: code-quality-guidelines)\` or \`(skill: perfex-module)\`
3563
+ - Install: \`heraspec skill add perfex-module\` or \`heraspec skill add module-codebase --project-type perfex-module\` or \`heraspec skill add code-quality-guidelines --project-type perfex-module\`
3564
+ - Agent reads: \`heraspec/skills/perfex-module/skill.md\`, \`heraspec/skills/perfex-module/module-codebase/skill.md\`, and \`heraspec/skills/perfex-module/code-quality-guidelines/skill.md\`
3565
+ - Agent MUST adhere to **10 Enterprise Code Quality & Clean Code Standards**:
3566
+ 1. **Separation of Concerns (Zero Inline Code)**: 0 inline <script> or <style> blocks in views and documentation HTML.
3567
+ 2. **Static Analysis Neutrality**: 0 occurrences of high-risk scanner triggers (inject, seeder, bypass, eval, unserialize).
3568
+ 3. **Safe Stylesheet Loading**: Use editor.dom.loadCSS() for TinyMCE/iframes; never inject raw CSS string arrays.
3569
+ 4. **Scoped Admin JS**: Enclose scripts in window.addEventListener('load') + strict IIFE.
3570
+ 5. **Concurrency & Performance**: Always call session_write_close() at the start of read/search AJAX endpoints.
3571
+ 6. **Clean Release Packaging**: Exclude package.json, webpack.config.js, tests/, scratch/, .git in deploy.ps1.
3572
+ 7. **Defensive PHP Security & Guards**: 100% PHP files start with defined('BASEPATH') or exit('No direct script access allowed');. Use CI Query Builder with auto-escaping.
3573
+ 8. **DOM XSS Prevention (CWE-79)**: Use .textContent, .innerText, or strict HTML escaping helper; purify rich text.
3574
+ 9. **100% Multilingual Parity**: 100% labels and messages use _l('key') with zero missing keys across languages.
3575
+ 10. **Zero Emojis**: 0 Unicode emojis across custom code, comments, views, documentation, and UI.
3576
+ - Use templates from \`heraspec/skills/perfex-module/module-codebase/templates/\` (module-main.php, install.php, uninstall.php, controller-admin.php, controller-api.php, model-main.php, helper.php, deploy.ps1, webpack.config.js).
3577
+
3578
+
3481
3579
 
3482
3580
  - Follow tasks.md
3483
3581
  - Mark tasks completed: \`- [x]\`
@@ -3608,6 +3706,7 @@ If \\\`heraspec/skills/smart-explore/\\\` exists, prefer token-efficient explora
3608
3706
  > heraspec skill add documents"
3609
3707
  - **DO NOT** create a task plan or attempt manual generation without the skill language.
3610
3708
  3. **Execute After Install**: Only after the skill folder is created (or installed), read the \`skill.md\` and proceed with the task.
3709
+ 4. **Ignore Vietnamese Skill Files**: You MUST only read the English \`skill.md\` file inside the skill folder. Completely ignore all \`*.vi.md\` files (e.g., \`skill.vi.md\`), as they are strictly for reference purposes by human developers.
3611
3710
 
3612
3711
  **Example prompt for Documents skill:**
3613
3712
  If you need to generate multi-format documentation, use this prompt:
@@ -3974,20 +4073,86 @@ ${section.content.trimEnd()}`);
3974
4073
  }
3975
4074
  }
3976
4075
  /**
3977
- * Generic section replacer: replace content from marker to next ## header
4076
+ * Find the index of the next top-level H2 section in the markdown content.
4077
+ * Tracks fenced code blocks to ignore H2 headers inside code blocks.
4078
+ */
4079
+ findSectionEndIndex(content, startIndex) {
4080
+ const lines = content.substring(startIndex).split(/\r?\n/);
4081
+ let offset = startIndex;
4082
+ let inCodeBlock = false;
4083
+ for (let i = 0; i < lines.length; i++) {
4084
+ const line = lines[i];
4085
+ const lineLengthWithNewline = line.length + (content.charAt(offset + line.length) === "\r" ? 2 : 1);
4086
+ if (i === 0) {
4087
+ offset += lineLengthWithNewline;
4088
+ continue;
4089
+ }
4090
+ if (line.trim().startsWith("```")) {
4091
+ inCodeBlock = !inCodeBlock;
4092
+ }
4093
+ if (!inCodeBlock && line.startsWith("## ")) {
4094
+ return offset;
4095
+ }
4096
+ offset += lineLengthWithNewline;
4097
+ }
4098
+ return content.length;
4099
+ }
4100
+ /**
4101
+ * Finds the start index of the next standard section in the sequence.
4102
+ * This is used to replace the entire section cleanly, even if there are internal H2s or duplicates.
4103
+ */
4104
+ findNextSectionIndex(content, startIndex, currentHeader) {
4105
+ const sectionsOrder = [
4106
+ ["## Universal Safety Rules"],
4107
+ ["## Core Workflow"],
4108
+ ["## Skills System", "## Skills system", "### Skills System", "### skills system"],
4109
+ ["## Proactive Memory-Aware Development", "## Memory-Aware Development"]
4110
+ ];
4111
+ let currentGroupIndex = -1;
4112
+ for (let i = 0; i < sectionsOrder.length; i++) {
4113
+ if (sectionsOrder[i].some((h) => currentHeader.toLowerCase().trim() === h.toLowerCase().trim())) {
4114
+ currentGroupIndex = i;
4115
+ break;
4116
+ }
4117
+ }
4118
+ if (currentGroupIndex === -1) {
4119
+ return this.findSectionEndIndex(content, startIndex);
4120
+ }
4121
+ let nextSectionIndex = -1;
4122
+ for (let i = currentGroupIndex + 1; i < sectionsOrder.length; i++) {
4123
+ const variations = sectionsOrder[i];
4124
+ for (const variation of variations) {
4125
+ const idx = content.indexOf(variation, startIndex + currentHeader.length);
4126
+ if (idx !== -1) {
4127
+ if (nextSectionIndex === -1 || idx < nextSectionIndex) {
4128
+ nextSectionIndex = idx;
4129
+ }
4130
+ }
4131
+ }
4132
+ }
4133
+ if (nextSectionIndex !== -1) {
4134
+ return nextSectionIndex;
4135
+ }
4136
+ return this.findSectionEndIndex(content, startIndex);
4137
+ }
4138
+ /**
4139
+ * Generic section replacer: replace content from marker to next H2 header or endMarker
3978
4140
  */
3979
- replaceSection(content, sectionMarker, newSection) {
4141
+ replaceSection(content, sectionMarker, newSection, endMarker) {
3980
4142
  const startIndex = content.indexOf(sectionMarker);
3981
4143
  if (startIndex === -1) return content;
3982
- let endIndex = content.indexOf("\n## ", startIndex + sectionMarker.length);
4144
+ let endIndex = -1;
4145
+ if (endMarker) {
4146
+ endIndex = content.indexOf(endMarker, startIndex + sectionMarker.length);
4147
+ }
3983
4148
  if (endIndex === -1) {
3984
- endIndex = content.length;
4149
+ endIndex = this.findNextSectionIndex(content, startIndex, sectionMarker);
3985
4150
  }
3986
4151
  const before = content.substring(0, startIndex).trimEnd();
3987
4152
  const after = content.substring(endIndex);
3988
4153
  return before + "\n\n" + newSection + (after.trimStart().startsWith("\n") ? "" : "\n\n") + after;
3989
4154
  }
3990
- replaceSkillsSection(existingContent, newSkillsSection) {
4155
+ replaceSkillsSection(existingContent, newSkillsSection, endMarker) {
3991
4156
  const startMarkers = ["## Skills System", "## Skills system", "### Skills System", "### Skills system"];
3992
4157
  let startIndex = -1;
3993
4158
  let foundMarker = "";
@@ -4001,28 +4166,19 @@ ${section.content.trimEnd()}`);
4001
4166
  if (startIndex === -1) {
4002
4167
  return this.appendSkillsSection(existingContent, newSkillsSection);
4003
4168
  }
4004
- let endIndex = existingContent.indexOf("\n## ", startIndex + foundMarker.length);
4005
- if (endIndex === -1) {
4006
- endIndex = existingContent.indexOf("\n### ", startIndex + foundMarker.length);
4169
+ let endIndex = -1;
4170
+ if (endMarker) {
4171
+ endIndex = existingContent.indexOf(endMarker, startIndex + foundMarker.length);
4007
4172
  }
4008
4173
  if (endIndex === -1) {
4009
- endIndex = existingContent.length;
4174
+ endIndex = this.findNextSectionIndex(existingContent, startIndex, foundMarker);
4010
4175
  }
4011
4176
  const before = existingContent.substring(0, startIndex).trimEnd();
4012
4177
  const after = existingContent.substring(endIndex);
4013
4178
  return before + "\n\n" + newSkillsSection + (after.trimStart().startsWith("\n") ? "" : "\n\n") + after;
4014
4179
  }
4015
4180
  replaceSafetyRules(existingContent, newSafetySection) {
4016
- const marker = "## Universal Safety Rules";
4017
- const startIndex = existingContent.indexOf(marker);
4018
- if (startIndex === -1) return existingContent;
4019
- let endIndex = existingContent.indexOf("\n## ", startIndex + marker.length);
4020
- if (endIndex === -1) {
4021
- endIndex = existingContent.length;
4022
- }
4023
- const before = existingContent.substring(0, startIndex).trimEnd();
4024
- const after = existingContent.substring(endIndex);
4025
- return before + "\n\n" + newSafetySection + (after.trimStart().startsWith("\n") ? "" : "\n\n") + after;
4181
+ return this.replaceSection(existingContent, "## Universal Safety Rules", newSafetySection, "## Core Workflow");
4026
4182
  }
4027
4183
  appendSkillsSection(existingContent, skillsSection) {
4028
4184
  const rulesMarker = "\n## Rules\n";
@@ -4077,36 +4233,78 @@ ${section.content.trimEnd()}`);
4077
4233
  }
4078
4234
  return null;
4079
4235
  }
4236
+ /**
4237
+ * Refactor legacy installed skills if new standards or companion skills were added to HeraSpec.
4238
+ * Ensures backward compatibility and non-destructive enhancement for existing projects.
4239
+ */
4240
+ async refactorLegacySkills(skillsDir, coreTemplatesDir) {
4241
+ const perfexSkillDir = path8.join(skillsDir, "perfex-module");
4242
+ if (await FileSystemUtils.fileExists(perfexSkillDir)) {
4243
+ const rootSkillMd = path8.join(perfexSkillDir, "skill.md");
4244
+ const rootSkillUpperMd = path8.join(perfexSkillDir, "SKILL.md");
4245
+ const templateRootSkill = path8.join(coreTemplatesDir, "perfex-module", "skill.md");
4246
+ const templateRootUpper = path8.join(coreTemplatesDir, "perfex-module", "SKILL.md");
4247
+ if (!await FileSystemUtils.fileExists(rootSkillMd) && await FileSystemUtils.fileExists(templateRootSkill)) {
4248
+ await FileSystemUtils.copyFile(templateRootSkill, rootSkillMd);
4249
+ }
4250
+ if (!await FileSystemUtils.fileExists(rootSkillUpperMd) && await FileSystemUtils.fileExists(templateRootUpper)) {
4251
+ await FileSystemUtils.copyFile(templateRootUpper, rootSkillUpperMd);
4252
+ }
4253
+ const qualityGuidelinesDir = path8.join(perfexSkillDir, "code-quality-guidelines");
4254
+ const templateQualityDir = path8.join(coreTemplatesDir, "perfex-module", "code-quality-guidelines");
4255
+ if (!await FileSystemUtils.fileExists(qualityGuidelinesDir) && await FileSystemUtils.fileExists(templateQualityDir)) {
4256
+ console.log(chalk2.cyan(" \u2713 Refactored perfex-module: added code-quality-guidelines skill"));
4257
+ await FileSystemUtils.copyDirectory(templateQualityDir, qualityGuidelinesDir);
4258
+ }
4259
+ const codebaseDir = path8.join(perfexSkillDir, "module-codebase");
4260
+ const templateCodebaseDir = path8.join(coreTemplatesDir, "perfex-module", "module-codebase");
4261
+ if (await FileSystemUtils.fileExists(codebaseDir) && await FileSystemUtils.fileExists(templateCodebaseDir)) {
4262
+ await FileSystemUtils.copyDirectory(templateCodebaseDir, codebaseDir);
4263
+ }
4264
+ }
4265
+ }
4080
4266
  /**
4081
4267
  * Update installed built-in skills on re-init.
4082
4268
  *
4083
4269
  * Rules:
4084
4270
  * - Only update skills that exist in SKILL_TEMPLATE_MAP (built-in / known skills)
4085
4271
  * - Skip skills NOT in the template map (custom skills added by the project)
4272
+ * - Strictly preserve custom project skills: NEVER delete or overwrite them
4086
4273
  * - For each matching skill: update skill.md + re-copy resourceDirs from template
4087
- * but PRESERVE templates/, scripts/, examples/ sub-folders added by user
4274
+ * safely preserving any user files in templates/, scripts/, examples/ sub-folders
4088
4275
  */
4089
4276
  async updateInstalledSkills(heraspecPath) {
4090
4277
  const skillsDir = path8.join(heraspecPath, SKILLS_DIR_NAME);
4091
4278
  if (!await FileSystemUtils.fileExists(skillsDir)) return;
4092
4279
  const coreTemplatesDir = await this.getCoreTemplatesDir();
4093
4280
  if (!coreTemplatesDir) return;
4281
+ await this.refactorLegacySkills(skillsDir, coreTemplatesDir);
4094
4282
  const allTemplates = getAllSkillTemplates();
4095
4283
  let updatedCount = 0;
4096
- let skippedCount = 0;
4284
+ const preservedSkills = [];
4097
4285
  const installedSkillPaths = await this.collectInstalledSkillPaths(skillsDir);
4098
4286
  for (const { skillPath, skillName, projectType } of installedSkillPaths) {
4099
4287
  const templateInfo = getSkillTemplateInfo(skillName, projectType);
4100
4288
  if (!templateInfo) {
4101
- skippedCount++;
4289
+ const displayName = projectType ? `${projectType}/${skillName}` : skillName;
4290
+ if (!preservedSkills.includes(displayName)) {
4291
+ preservedSkills.push(displayName);
4292
+ }
4102
4293
  continue;
4103
4294
  }
4104
4295
  const templateFile = path8.join(coreTemplatesDir, templateInfo.templateFileName);
4105
4296
  if (!await FileSystemUtils.fileExists(templateFile)) {
4106
- skippedCount++;
4297
+ const displayName = projectType ? `${projectType}/${skillName}` : skillName;
4298
+ if (!preservedSkills.includes(displayName)) {
4299
+ preservedSkills.push(displayName);
4300
+ }
4107
4301
  continue;
4108
4302
  }
4109
4303
  await FileSystemUtils.copyFile(templateFile, path8.join(skillPath, "skill.md"));
4304
+ const upperTemplateFile = path8.join(path8.dirname(templateFile), "SKILL.md");
4305
+ if (await FileSystemUtils.fileExists(upperTemplateFile)) {
4306
+ await FileSystemUtils.copyFile(upperTemplateFile, path8.join(skillPath, "SKILL.md"));
4307
+ }
4110
4308
  if (templateInfo.viFileName) {
4111
4309
  const viFile = path8.join(coreTemplatesDir, templateInfo.viFileName);
4112
4310
  if (await FileSystemUtils.fileExists(viFile)) {
@@ -4116,11 +4314,8 @@ ${section.content.trimEnd()}`);
4116
4314
  if (templateInfo.resourceDirs) {
4117
4315
  for (const resourceDir of templateInfo.resourceDirs) {
4118
4316
  const srcResourceDir = path8.join(coreTemplatesDir, resourceDir);
4119
- const destResourceDir = path8.join(skillPath, resourceDir);
4317
+ const destResourceDir = path8.join(skillPath, path8.basename(resourceDir));
4120
4318
  if (await FileSystemUtils.fileExists(srcResourceDir)) {
4121
- if (await FileSystemUtils.fileExists(destResourceDir)) {
4122
- await FileSystemUtils.removeDirectory(destResourceDir, true);
4123
- }
4124
4319
  await FileSystemUtils.copyDirectory(srcResourceDir, destResourceDir);
4125
4320
  }
4126
4321
  }
@@ -4131,7 +4326,13 @@ ${section.content.trimEnd()}`);
4131
4326
  updatedCount++;
4132
4327
  }
4133
4328
  if (updatedCount > 0) {
4134
- console.log(chalk2.gray(` \u2713 Updated ${updatedCount} built-in skill(s)${skippedCount > 0 ? `, skipped ${skippedCount} custom skill(s)` : ""}`));
4329
+ console.log(chalk2.gray(` \u2713 Updated ${updatedCount} built-in skill(s)`));
4330
+ }
4331
+ if (preservedSkills.length > 0) {
4332
+ console.log(chalk2.green(` \u2713 Preserved ${preservedSkills.length} custom project skill(s) (never deleted or overwritten):`));
4333
+ for (const skill of preservedSkills) {
4334
+ console.log(chalk2.gray(` \u2022 ${skill}`));
4335
+ }
4135
4336
  }
4136
4337
  }
4137
4338
  /**
@@ -4153,20 +4354,25 @@ ${section.content.trimEnd()}`);
4153
4354
  "multi-stack"
4154
4355
  ];
4155
4356
  for (const entry of entries) {
4357
+ if (entry === "README.md" || entry === "UI_UX_SKILL_QUICK_REFERENCE.md") continue;
4156
4358
  const entryPath = path8.join(skillsDir, entry);
4157
4359
  const stats = await FileSystemUtils.stat(entryPath);
4158
4360
  if (!stats.isDirectory()) continue;
4159
4361
  if (knownProjectTypes.includes(entry)) {
4160
4362
  const subEntries = await FileSystemUtils.readDirectory(entryPath);
4161
4363
  for (const sub of subEntries) {
4364
+ if (["templates", "scripts", "examples", "data", "knowledge", "tests", "docs"].includes(sub)) continue;
4162
4365
  const subPath = path8.join(entryPath, sub);
4163
4366
  const subStats = await FileSystemUtils.stat(subPath);
4164
- if (subStats.isDirectory() && await FileSystemUtils.fileExists(path8.join(subPath, "skill.md"))) {
4367
+ if (subStats.isDirectory()) {
4165
4368
  result.push({ skillPath: subPath, skillName: sub, projectType: entry });
4166
4369
  }
4167
4370
  }
4371
+ if (await FileSystemUtils.fileExists(path8.join(entryPath, "skill.md")) || await FileSystemUtils.fileExists(path8.join(entryPath, "SKILL.md"))) {
4372
+ result.push({ skillPath: entryPath, skillName: entry, projectType: entry });
4373
+ }
4168
4374
  } else {
4169
- if (await FileSystemUtils.fileExists(path8.join(entryPath, "skill.md"))) {
4375
+ if (await FileSystemUtils.fileExists(path8.join(entryPath, "skill.md")) || await FileSystemUtils.fileExists(path8.join(entryPath, "SKILL.md"))) {
4170
4376
  result.push({ skillPath: entryPath, skillName: entry });
4171
4377
  }
4172
4378
  }
@@ -4417,15 +4623,12 @@ python3 heraspec/skills/ui-ux/scripts/search.py "pricing plans" --domain pages
4417
4623
  1. Copy skill from HeraSpec core:
4418
4624
  \`\`\`bash
4419
4625
  # Copy UI/UX skill
4420
- cp -r /path/to/HeraSpec/src/core/templates/skills/ui-ux-skill.md heraspec/skills/ui-ux/
4421
- cp -r /path/to/HeraSpec/src/core/templates/skills/scripts heraspec/skills/ui-ux/
4422
- cp -r /path/to/HeraSpec/src/core/templates/skills/data heraspec/skills/ui-ux/
4423
- cp -r /path/to/HeraSpec/src/core/templates/skills/templates heraspec/skills/ui-ux/
4626
+ cp -r /path/to/HeraSpec/src/core/templates/skills/ui-ux heraspec/skills/
4424
4627
  \`\`\`
4425
4628
 
4426
4629
  2. Or use \`heraspec skill add ui-ux\` (if available)
4427
4630
 
4428
- 3. Read \`heraspec/skills/ui-ux/ui-ux-skill.md\` for complete documentation
4631
+ 3. Read \`heraspec/skills/ui-ux/skill.md\` for complete documentation
4429
4632
 
4430
4633
  ### Flatsome UX Element Skill
4431
4634
 
@@ -4575,7 +4778,7 @@ python3 heraspec/skills/ui-ux/scripts/search.py "product-detail single-product"
4575
4778
  ## \u{1F4DA} Detailed Documentation
4576
4779
 
4577
4780
  After copying UI/UX skill to your project, see:
4578
- - \`heraspec/skills/ui-ux/ui-ux-skill.md\` - Complete skill documentation
4781
+ - \`heraspec/skills/ui-ux/skill.md\` - Complete skill documentation
4579
4782
  - \`heraspec/skills/ui-ux/templates/example-prompt-full-theme.md\` - Detailed prompt examples
4580
4783
  - \`heraspec/skills/ui-ux/templates/prompt-template-full-theme.md\` - Copy-paste templates
4581
4784
 
@@ -4591,10 +4794,7 @@ After copying UI/UX skill to your project, see:
4591
4794
 
4592
4795
  1. Copy UI/UX skill to project:
4593
4796
  \`\`\`bash
4594
- cp -r /path/to/HeraSpec/src/core/templates/skills/ui-ux-skill.md heraspec/skills/ui-ux/
4595
- cp -r /path/to/HeraSpec/src/core/templates/skills/scripts heraspec/skills/ui-ux/
4596
- cp -r /path/to/HeraSpec/src/core/templates/skills/data heraspec/skills/ui-ux/
4597
- cp -r /path/to/HeraSpec/src/core/templates/skills/templates heraspec/skills/ui-ux/
4797
+ cp -r /path/to/HeraSpec/src/core/templates/skills/ui-ux heraspec/skills/
4598
4798
  \`\`\`
4599
4799
 
4600
4800
  2. Use prompt template from above
@@ -4621,32 +4821,45 @@ After copying UI/UX skill to your project, see:
4621
4821
  async updateReadmeFile(readmePath) {
4622
4822
  const existingContent = await FileSystemUtils.readFile(readmePath);
4623
4823
  const heraspecSection = this.getHeraSpecReadmeSection();
4624
- const sectionMarkers = [
4625
- "## HeraSpec",
4626
- "## HeraSpec Development",
4627
- "### HeraSpec",
4628
- "### HeraSpec Development",
4629
- "<!-- HeraSpec Section -->"
4630
- ];
4631
- let hasHeraSpecSection = false;
4632
4824
  let sectionStartIndex = -1;
4633
4825
  let sectionEndIndex = -1;
4634
- for (const marker of sectionMarkers) {
4635
- const index = existingContent.indexOf(marker);
4636
- if (index !== -1) {
4637
- hasHeraSpecSection = true;
4638
- sectionStartIndex = index;
4639
- sectionEndIndex = existingContent.indexOf("\n## ", index + marker.length);
4640
- if (sectionEndIndex === -1) {
4641
- sectionEndIndex = existingContent.indexOf("\n### ", index + marker.length);
4642
- }
4643
- if (sectionEndIndex === -1) {
4644
- sectionEndIndex = existingContent.length;
4826
+ const commentMarker = "<!-- HeraSpec Section -->";
4827
+ const commentIndex = existingContent.indexOf(commentMarker);
4828
+ if (commentIndex !== -1) {
4829
+ sectionStartIndex = commentIndex;
4830
+ const firstHeaderIndex = existingContent.indexOf("## ", commentIndex + commentMarker.length);
4831
+ if (firstHeaderIndex !== -1) {
4832
+ let nextHeaderIndex = existingContent.indexOf("\n## ", firstHeaderIndex + 3);
4833
+ if (nextHeaderIndex === -1) {
4834
+ nextHeaderIndex = existingContent.indexOf("\n### ", firstHeaderIndex + 3);
4835
+ }
4836
+ sectionEndIndex = nextHeaderIndex !== -1 ? nextHeaderIndex : existingContent.length;
4837
+ } else {
4838
+ sectionEndIndex = existingContent.length;
4839
+ }
4840
+ } else {
4841
+ const sectionMarkers = [
4842
+ "## HeraSpec Development",
4843
+ "## HeraSpec",
4844
+ "### HeraSpec Development",
4845
+ "### HeraSpec"
4846
+ ];
4847
+ for (const marker of sectionMarkers) {
4848
+ const index = existingContent.indexOf(marker);
4849
+ if (index !== -1) {
4850
+ sectionStartIndex = index;
4851
+ sectionEndIndex = existingContent.indexOf("\n## ", index + marker.length);
4852
+ if (sectionEndIndex === -1) {
4853
+ sectionEndIndex = existingContent.indexOf("\n### ", index + marker.length);
4854
+ }
4855
+ if (sectionEndIndex === -1) {
4856
+ sectionEndIndex = existingContent.length;
4857
+ }
4858
+ break;
4645
4859
  }
4646
- break;
4647
4860
  }
4648
4861
  }
4649
- if (hasHeraSpecSection && sectionStartIndex !== -1) {
4862
+ if (sectionStartIndex !== -1) {
4650
4863
  const before = existingContent.substring(0, sectionStartIndex).trimEnd();
4651
4864
  const after = existingContent.substring(sectionEndIndex);
4652
4865
  const updatedContent = before + "\n\n" + heraspecSection + (after.trimStart().startsWith("\n") ? "" : "\n\n") + after;
@@ -5026,7 +5239,6 @@ This will archive "${changeName}" and merge delta specs into source specs.`);
5026
5239
  const archiveDir = path10.join(
5027
5240
  ".",
5028
5241
  HERASPEC_DIR_NAME,
5029
- CHANGES_DIR_NAME,
5030
5242
  ARCHIVES_DIR_NAME
5031
5243
  );
5032
5244
  await FileSystemUtils.createDirectory(archiveDir);
@@ -5360,19 +5572,31 @@ var Validator = class {
5360
5572
  const spec = parser.parseSpec(specName);
5361
5573
  const result = SpecSchema.safeParse(spec);
5362
5574
  if (!result.success) {
5363
- result.error.errors.forEach((err) => {
5364
- errors.push(`${err.path.join(".")}: ${err.message}`);
5575
+ result.error.issues.forEach((err) => {
5576
+ errors.push({
5577
+ message: `${err.path.join(".")}: ${err.message}`,
5578
+ autoFixable: false
5579
+ });
5365
5580
  });
5366
5581
  }
5367
5582
  if (spec.requirements.length === 0) {
5368
- errors.push("Spec must have at least one requirement");
5583
+ errors.push({
5584
+ message: "Spec must have at least one requirement",
5585
+ autoFixable: false
5586
+ });
5369
5587
  }
5370
5588
  for (const req of spec.requirements) {
5371
5589
  if (!req.description || req.description.trim().length === 0) {
5372
- errors.push(`Requirement "${req.name}" must have a description`);
5590
+ errors.push({
5591
+ message: `Requirement "${req.name}" must have a description`,
5592
+ autoFixable: false
5593
+ });
5373
5594
  }
5374
5595
  if (!req.scenarios || req.scenarios.length === 0) {
5375
- warnings.push(`Requirement "${req.name}" has no scenarios`);
5596
+ warnings.push({
5597
+ message: `Requirement "${req.name}" has no scenarios`,
5598
+ autoFixable: false
5599
+ });
5376
5600
  }
5377
5601
  }
5378
5602
  return {
@@ -5383,7 +5607,10 @@ var Validator = class {
5383
5607
  } catch (error) {
5384
5608
  return {
5385
5609
  valid: false,
5386
- errors: [error instanceof Error ? error.message : "Unknown error"],
5610
+ errors: [{
5611
+ message: error instanceof Error ? error.message : "Unknown error",
5612
+ autoFixable: false
5613
+ }],
5387
5614
  warnings: []
5388
5615
  };
5389
5616
  }
@@ -5550,6 +5777,15 @@ var Validator = class {
5550
5777
  const match = content.match(reqRegex);
5551
5778
  return match ? match[0].trim() : null;
5552
5779
  }
5780
+ getParseErrorSuggestion(errorMessage) {
5781
+ if (errorMessage.includes("YAML") || errorMessage.includes("frontmatter")) {
5782
+ return "Check the YAML frontmatter syntax at the top of the file.";
5783
+ }
5784
+ if (errorMessage.includes("header") || errorMessage.includes("heading")) {
5785
+ return "Ensure headers follow markdown format (# Title, ## Section).";
5786
+ }
5787
+ return void 0;
5788
+ }
5553
5789
  };
5554
5790
  export {
5555
5791
  ARCHIVES_DIR_NAME,