@loom-framework/core 0.1.0-alpha.9 → 0.1.0-alpha.91

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 (447) hide show
  1. package/builtin-skills/antd/SKILL.md +266 -0
  2. package/builtin-skills/antv-g2-chart/SKILL.md +1067 -0
  3. package/builtin-skills/antv-g2-chart/references/animations/g2-animation-intro.md +176 -0
  4. package/builtin-skills/antv-g2-chart/references/animations/g2-animation-keyframe.md +149 -0
  5. package/builtin-skills/antv-g2-chart/references/animations/g2-animation-types.md +253 -0
  6. package/builtin-skills/antv-g2-chart/references/components/g2-comp-annotation.md +237 -0
  7. package/builtin-skills/antv-g2-chart/references/components/g2-comp-axis-config.md +648 -0
  8. package/builtin-skills/antv-g2-chart/references/components/g2-comp-axis-radar.md +219 -0
  9. package/builtin-skills/antv-g2-chart/references/components/g2-comp-label-config.md +174 -0
  10. package/builtin-skills/antv-g2-chart/references/components/g2-comp-legend-category.md +278 -0
  11. package/builtin-skills/antv-g2-chart/references/components/g2-comp-legend-config.md +363 -0
  12. package/builtin-skills/antv-g2-chart/references/components/g2-comp-legend-continuous.md +264 -0
  13. package/builtin-skills/antv-g2-chart/references/components/g2-comp-scrollbar.md +276 -0
  14. package/builtin-skills/antv-g2-chart/references/components/g2-comp-slider.md +333 -0
  15. package/builtin-skills/antv-g2-chart/references/components/g2-comp-title.md +149 -0
  16. package/builtin-skills/antv-g2-chart/references/components/g2-comp-tooltip-config.md +358 -0
  17. package/builtin-skills/antv-g2-chart/references/compositions/g2-comp-facet-circle.md +97 -0
  18. package/builtin-skills/antv-g2-chart/references/compositions/g2-comp-facet-rect.md +241 -0
  19. package/builtin-skills/antv-g2-chart/references/compositions/g2-comp-geo-map.md +210 -0
  20. package/builtin-skills/antv-g2-chart/references/compositions/g2-comp-geoview.md +143 -0
  21. package/builtin-skills/antv-g2-chart/references/compositions/g2-comp-repeat-matrix.md +171 -0
  22. package/builtin-skills/antv-g2-chart/references/compositions/g2-comp-space-flex.md +142 -0
  23. package/builtin-skills/antv-g2-chart/references/compositions/g2-comp-space-layer.md +149 -0
  24. package/builtin-skills/antv-g2-chart/references/compositions/g2-comp-timing-keyframe.md +91 -0
  25. package/builtin-skills/antv-g2-chart/references/compositions/g2-comp-view.md +309 -0
  26. package/builtin-skills/antv-g2-chart/references/concepts/g2-concept-chart-selection.md +235 -0
  27. package/builtin-skills/antv-g2-chart/references/concepts/g2-concept-color-theory.md +287 -0
  28. package/builtin-skills/antv-g2-chart/references/concepts/g2-concept-visual-channels.md +180 -0
  29. package/builtin-skills/antv-g2-chart/references/coordinates/g2-coord-cartesian.md +131 -0
  30. package/builtin-skills/antv-g2-chart/references/coordinates/g2-coord-fisheye.md +131 -0
  31. package/builtin-skills/antv-g2-chart/references/coordinates/g2-coord-helix.md +141 -0
  32. package/builtin-skills/antv-g2-chart/references/coordinates/g2-coord-parallel.md +129 -0
  33. package/builtin-skills/antv-g2-chart/references/coordinates/g2-coord-polar.md +143 -0
  34. package/builtin-skills/antv-g2-chart/references/coordinates/g2-coord-radial.md +214 -0
  35. package/builtin-skills/antv-g2-chart/references/coordinates/g2-coord-theta.md +171 -0
  36. package/builtin-skills/antv-g2-chart/references/coordinates/g2-coord-transpose.md +195 -0
  37. package/builtin-skills/antv-g2-chart/references/core/g2-core-chart-init.md +266 -0
  38. package/builtin-skills/antv-g2-chart/references/core/g2-core-encode-channel.md +197 -0
  39. package/builtin-skills/antv-g2-chart/references/core/g2-core-view-composition.md +224 -0
  40. package/builtin-skills/antv-g2-chart/references/data/g2-data-ema.md +190 -0
  41. package/builtin-skills/antv-g2-chart/references/data/g2-data-fetch.md +167 -0
  42. package/builtin-skills/antv-g2-chart/references/data/g2-data-filter.md +212 -0
  43. package/builtin-skills/antv-g2-chart/references/data/g2-data-fold.md +260 -0
  44. package/builtin-skills/antv-g2-chart/references/data/g2-data-format-tabular.md +280 -0
  45. package/builtin-skills/antv-g2-chart/references/data/g2-data-kde.md +426 -0
  46. package/builtin-skills/antv-g2-chart/references/data/g2-data-log.md +140 -0
  47. package/builtin-skills/antv-g2-chart/references/data/g2-data-slice.md +147 -0
  48. package/builtin-skills/antv-g2-chart/references/data/g2-data-sort.md +251 -0
  49. package/builtin-skills/antv-g2-chart/references/data/g2-data-sortby.md +183 -0
  50. package/builtin-skills/antv-g2-chart/references/data/g2-data-transform-patterns.md +394 -0
  51. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-adaptive-filter.md +118 -0
  52. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-brush-axis.md +112 -0
  53. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-brush-filter.md +122 -0
  54. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-brush-x-y-highlight.md +127 -0
  55. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-brush-xy.md +118 -0
  56. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-brush.md +184 -0
  57. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-brushx-filter.md +170 -0
  58. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-brushx-highlight.md +186 -0
  59. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-brushy-filter.md +170 -0
  60. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-brushy-highlight.md +185 -0
  61. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-chart-index.md +127 -0
  62. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-drilldown.md +149 -0
  63. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-element-highlight-by.md +125 -0
  64. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-element-highlight.md +235 -0
  65. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-element-hover-scale.md +109 -0
  66. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-element-point-move.md +152 -0
  67. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-element-select-by.md +133 -0
  68. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-element-select.md +249 -0
  69. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-fisheye.md +117 -0
  70. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-legend-filter.md +130 -0
  71. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-legend-highlight.md +130 -0
  72. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-poptip.md +105 -0
  73. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-scrollbar-filter.md +144 -0
  74. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-slider-filter.md +231 -0
  75. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-slider-wheel.md +138 -0
  76. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-tooltip.md +192 -0
  77. package/builtin-skills/antv-g2-chart/references/interactions/g2-interaction-treemap-drilldown.md +152 -0
  78. package/builtin-skills/antv-g2-chart/references/label-transform/g2-label-transform-contrast-reverse.md +170 -0
  79. package/builtin-skills/antv-g2-chart/references/label-transform/g2-label-transform-exceed-adjust.md +146 -0
  80. package/builtin-skills/antv-g2-chart/references/label-transform/g2-label-transform-overflow-hide.md +185 -0
  81. package/builtin-skills/antv-g2-chart/references/label-transform/g2-label-transform-overflow-stroke.md +147 -0
  82. package/builtin-skills/antv-g2-chart/references/label-transform/g2-label-transform-overlap-dodge-y.md +225 -0
  83. package/builtin-skills/antv-g2-chart/references/label-transform/g2-label-transform-overlap-hide.md +213 -0
  84. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-arc-diagram.md +196 -0
  85. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-arc-donut.md +148 -0
  86. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-arc-pie.md +212 -0
  87. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-area-basic.md +168 -0
  88. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-area-stacked.md +150 -0
  89. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-beeswarm.md +134 -0
  90. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-bi-directional-bar.md +297 -0
  91. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-box-boxplot.md +163 -0
  92. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-boxplot.md +340 -0
  93. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-bullet.md +203 -0
  94. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-cell-heatmap.md +370 -0
  95. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-chord.md +341 -0
  96. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-connector.md +126 -0
  97. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-contourline.md +243 -0
  98. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-density.md +457 -0
  99. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-distribution-curve.md +298 -0
  100. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-funnel.md +329 -0
  101. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-gantt.md +208 -0
  102. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-gauge.md +247 -0
  103. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-heatmap.md +130 -0
  104. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-histogram.md +186 -0
  105. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-image.md +129 -0
  106. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-interval-basic.md +528 -0
  107. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-interval-grouped.md +161 -0
  108. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-interval-normalized.md +147 -0
  109. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-interval-stacked.md +183 -0
  110. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-k-chart.md +237 -0
  111. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-line-basic.md +353 -0
  112. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-line-multi.md +156 -0
  113. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-linex-liney.md +176 -0
  114. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-link.md +134 -0
  115. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-liquid.md +125 -0
  116. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-mosaic.md +257 -0
  117. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-pack.md +424 -0
  118. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-parallel.md +195 -0
  119. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-partition.md +275 -0
  120. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-path.md +135 -0
  121. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-point-bubble.md +138 -0
  122. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-point-scatter.md +177 -0
  123. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-polygon.md +130 -0
  124. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-radar.md +231 -0
  125. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-radial-bar.md +226 -0
  126. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-range-rangey.md +253 -0
  127. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-rangex.md +293 -0
  128. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-rect.md +115 -0
  129. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-regression-curve.md +276 -0
  130. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-rose.md +182 -0
  131. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-sankey.md +217 -0
  132. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-shape.md +160 -0
  133. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-spiral.md +257 -0
  134. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-sunburst.md +327 -0
  135. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-text.md +309 -0
  136. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-tree.md +235 -0
  137. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-treemap.md +426 -0
  138. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-vector.md +108 -0
  139. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-venn.md +204 -0
  140. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-violin.md +307 -0
  141. package/builtin-skills/antv-g2-chart/references/marks/g2-mark-wordcloud.md +155 -0
  142. package/builtin-skills/antv-g2-chart/references/palette/g2-palette-category10.md +196 -0
  143. package/builtin-skills/antv-g2-chart/references/palette/g2-palette-category20.md +238 -0
  144. package/builtin-skills/antv-g2-chart/references/patterns/g2-pattern-performance.md +181 -0
  145. package/builtin-skills/antv-g2-chart/references/patterns/g2-pattern-responsive.md +232 -0
  146. package/builtin-skills/antv-g2-chart/references/patterns/g2-pattern-v4-to-v5.md +223 -0
  147. package/builtin-skills/antv-g2-chart/references/scales/g2-scale-band.md +127 -0
  148. package/builtin-skills/antv-g2-chart/references/scales/g2-scale-linear.md +259 -0
  149. package/builtin-skills/antv-g2-chart/references/scales/g2-scale-log.md +226 -0
  150. package/builtin-skills/antv-g2-chart/references/scales/g2-scale-ordinal.md +135 -0
  151. package/builtin-skills/antv-g2-chart/references/scales/g2-scale-point.md +242 -0
  152. package/builtin-skills/antv-g2-chart/references/scales/g2-scale-pow-sqrt.md +124 -0
  153. package/builtin-skills/antv-g2-chart/references/scales/g2-scale-quantile-quantize.md +119 -0
  154. package/builtin-skills/antv-g2-chart/references/scales/g2-scale-sequential.md +267 -0
  155. package/builtin-skills/antv-g2-chart/references/scales/g2-scale-threshold.md +133 -0
  156. package/builtin-skills/antv-g2-chart/references/scales/g2-scale-time.md +159 -0
  157. package/builtin-skills/antv-g2-chart/references/themes/g2-theme-builtin.md +192 -0
  158. package/builtin-skills/antv-g2-chart/references/themes/g2-theme-custom.md +183 -0
  159. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-bin.md +153 -0
  160. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-binx.md +133 -0
  161. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-diffy.md +130 -0
  162. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-dodgex.md +90 -0
  163. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-flexx.md +115 -0
  164. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-group.md +233 -0
  165. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-groupcolor.md +182 -0
  166. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-groupx.md +265 -0
  167. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-groupy.md +167 -0
  168. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-jitter.md +149 -0
  169. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-jitterx.md +177 -0
  170. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-jittery.md +177 -0
  171. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-normalizey.md +83 -0
  172. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-pack.md +164 -0
  173. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-sample.md +143 -0
  174. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-select.md +147 -0
  175. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-selectx.md +179 -0
  176. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-selecty.md +179 -0
  177. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-sort-color.md +115 -0
  178. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-sortx.md +285 -0
  179. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-sorty.md +117 -0
  180. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-stack-enter.md +158 -0
  181. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-stacky.md +218 -0
  182. package/builtin-skills/antv-g2-chart/references/transforms/g2-transform-symmetryy.md +122 -0
  183. package/builtin-skills/app-skill/SKILL.md +27 -0
  184. package/builtin-skills/app-skill/references/data-semantics.md +44 -0
  185. package/builtin-skills/app-skill/references/models.md +31 -0
  186. package/builtin-skills/chart-visualization/SKILL.md +101 -0
  187. package/builtin-skills/loom/SKILL.md +168 -0
  188. package/builtin-skills/loom/references/README.md +128 -0
  189. package/builtin-skills/loom/references/dashboard.md +196 -0
  190. package/builtin-skills/loom/references/data-model.md +78 -0
  191. package/dist/adapter-base.d.ts +29 -0
  192. package/dist/adapter-base.d.ts.map +1 -0
  193. package/dist/adapter-base.js +62 -0
  194. package/dist/adapter-base.js.map +1 -0
  195. package/dist/adapter-factory.d.ts +8 -0
  196. package/dist/adapter-factory.d.ts.map +1 -0
  197. package/dist/adapter-factory.js +25 -0
  198. package/dist/adapter-factory.js.map +1 -0
  199. package/dist/adapter-filesystem.d.ts +6 -11
  200. package/dist/adapter-filesystem.d.ts.map +1 -1
  201. package/dist/adapter-filesystem.js +56 -41
  202. package/dist/adapter-filesystem.js.map +1 -1
  203. package/dist/adapter-sqlite.d.ts +6 -23
  204. package/dist/adapter-sqlite.d.ts.map +1 -1
  205. package/dist/adapter-sqlite.js +65 -50
  206. package/dist/adapter-sqlite.js.map +1 -1
  207. package/dist/backend/ai/button-resolver.d.ts +18 -0
  208. package/dist/backend/ai/button-resolver.d.ts.map +1 -0
  209. package/dist/backend/ai/button-resolver.js +58 -0
  210. package/dist/backend/ai/button-resolver.js.map +1 -0
  211. package/dist/backend/ai/engine.d.ts +52 -0
  212. package/dist/backend/ai/engine.d.ts.map +1 -0
  213. package/dist/backend/ai/engine.js +186 -0
  214. package/dist/backend/ai/engine.js.map +1 -0
  215. package/dist/backend/ai/index.d.ts +11 -0
  216. package/dist/backend/ai/index.d.ts.map +1 -0
  217. package/dist/backend/ai/index.js +8 -0
  218. package/dist/backend/ai/index.js.map +1 -0
  219. package/dist/backend/ai/output-parser.d.ts +29 -0
  220. package/dist/backend/ai/output-parser.d.ts.map +1 -0
  221. package/dist/backend/ai/output-parser.js +247 -0
  222. package/dist/backend/ai/output-parser.js.map +1 -0
  223. package/dist/backend/ai/session-manager.d.ts +103 -0
  224. package/dist/backend/ai/session-manager.d.ts.map +1 -0
  225. package/dist/backend/ai/session-manager.js +298 -0
  226. package/dist/backend/ai/session-manager.js.map +1 -0
  227. package/dist/backend/index.d.ts +61 -0
  228. package/dist/backend/index.d.ts.map +1 -0
  229. package/dist/backend/index.js +161 -0
  230. package/dist/backend/index.js.map +1 -0
  231. package/dist/backend/observe/index.d.ts +6 -0
  232. package/dist/backend/observe/index.d.ts.map +1 -0
  233. package/dist/backend/observe/index.js +5 -0
  234. package/dist/backend/observe/index.js.map +1 -0
  235. package/dist/backend/observe/logger.d.ts +28 -0
  236. package/dist/backend/observe/logger.d.ts.map +1 -0
  237. package/dist/backend/observe/logger.js +80 -0
  238. package/dist/backend/observe/logger.js.map +1 -0
  239. package/dist/backend/observe/types.d.ts +26 -0
  240. package/dist/backend/observe/types.d.ts.map +1 -0
  241. package/dist/backend/observe/types.js +7 -0
  242. package/dist/backend/observe/types.js.map +1 -0
  243. package/dist/backend/routes/chat.d.ts +31 -0
  244. package/dist/backend/routes/chat.d.ts.map +1 -0
  245. package/dist/backend/routes/chat.js +426 -0
  246. package/dist/backend/routes/chat.js.map +1 -0
  247. package/dist/backend/routes/data.d.ts +13 -0
  248. package/dist/backend/routes/data.d.ts.map +1 -0
  249. package/dist/backend/routes/data.js +134 -0
  250. package/dist/backend/routes/data.js.map +1 -0
  251. package/dist/backend/routes/health.d.ts +7 -0
  252. package/dist/backend/routes/health.d.ts.map +1 -0
  253. package/dist/backend/routes/health.js +15 -0
  254. package/dist/backend/routes/health.js.map +1 -0
  255. package/dist/backend/routes/index.d.ts +11 -0
  256. package/dist/backend/routes/index.d.ts.map +1 -0
  257. package/dist/backend/routes/index.js +9 -0
  258. package/dist/backend/routes/index.js.map +1 -0
  259. package/dist/backend/routes/skills.d.ts +16 -0
  260. package/dist/backend/routes/skills.d.ts.map +1 -0
  261. package/dist/backend/routes/skills.js +590 -0
  262. package/dist/backend/routes/skills.js.map +1 -0
  263. package/dist/backend/routes/upload.d.ts +24 -0
  264. package/dist/backend/routes/upload.d.ts.map +1 -0
  265. package/dist/backend/routes/upload.js +67 -0
  266. package/dist/backend/routes/upload.js.map +1 -0
  267. package/dist/bin.d.ts +8 -0
  268. package/dist/bin.d.ts.map +1 -0
  269. package/dist/bin.js +12 -0
  270. package/dist/bin.js.map +1 -0
  271. package/dist/capability-generator.d.ts +21 -6
  272. package/dist/capability-generator.d.ts.map +1 -1
  273. package/dist/capability-generator.js +88 -261
  274. package/dist/capability-generator.js.map +1 -1
  275. package/dist/cli/commands/build.d.ts +11 -0
  276. package/dist/cli/commands/build.d.ts.map +1 -0
  277. package/dist/cli/commands/build.js +170 -0
  278. package/dist/cli/commands/build.js.map +1 -0
  279. package/dist/cli/commands/data.d.ts +12 -0
  280. package/dist/cli/commands/data.d.ts.map +1 -0
  281. package/dist/cli/commands/data.js +158 -0
  282. package/dist/cli/commands/data.js.map +1 -0
  283. package/dist/cli/commands/dev.d.ts +9 -0
  284. package/dist/cli/commands/dev.d.ts.map +1 -0
  285. package/dist/cli/commands/dev.js +114 -0
  286. package/dist/cli/commands/dev.js.map +1 -0
  287. package/dist/cli/commands/generate-capabilities.d.ts +8 -0
  288. package/dist/cli/commands/generate-capabilities.d.ts.map +1 -0
  289. package/dist/cli/commands/generate-capabilities.js +40 -0
  290. package/dist/cli/commands/generate-capabilities.js.map +1 -0
  291. package/dist/cli/commands/generate-cli-command.d.ts +8 -0
  292. package/dist/cli/commands/generate-cli-command.d.ts.map +1 -0
  293. package/dist/cli/commands/generate-cli-command.js +64 -0
  294. package/dist/cli/commands/generate-cli-command.js.map +1 -0
  295. package/dist/cli/commands/generate-dashboard.d.ts +9 -0
  296. package/dist/cli/commands/generate-dashboard.d.ts.map +1 -0
  297. package/dist/cli/commands/generate-dashboard.js +466 -0
  298. package/dist/cli/commands/generate-dashboard.js.map +1 -0
  299. package/dist/cli/commands/generate-page.d.ts +9 -0
  300. package/dist/cli/commands/generate-page.d.ts.map +1 -0
  301. package/dist/cli/commands/generate-page.js +352 -0
  302. package/dist/cli/commands/generate-page.js.map +1 -0
  303. package/dist/cli/commands/generate-skill.d.ts +8 -0
  304. package/dist/cli/commands/generate-skill.d.ts.map +1 -0
  305. package/dist/cli/commands/generate-skill.js +75 -0
  306. package/dist/cli/commands/generate-skill.js.map +1 -0
  307. package/dist/cli/commands/generate.d.ts +6 -0
  308. package/dist/cli/commands/generate.d.ts.map +1 -0
  309. package/dist/cli/commands/generate.js +19 -0
  310. package/dist/cli/commands/generate.js.map +1 -0
  311. package/dist/cli/commands/init.d.ts +8 -0
  312. package/dist/cli/commands/init.d.ts.map +1 -0
  313. package/dist/cli/commands/init.js +301 -0
  314. package/dist/cli/commands/init.js.map +1 -0
  315. package/dist/cli/commands/observe.d.ts +9 -0
  316. package/dist/cli/commands/observe.d.ts.map +1 -0
  317. package/dist/cli/commands/observe.js +142 -0
  318. package/dist/cli/commands/observe.js.map +1 -0
  319. package/dist/cli/commands/skill.d.ts +9 -0
  320. package/dist/cli/commands/skill.d.ts.map +1 -0
  321. package/dist/cli/commands/skill.js +186 -0
  322. package/dist/cli/commands/skill.js.map +1 -0
  323. package/dist/cli/generators/capability-generator.d.ts +35 -0
  324. package/dist/cli/generators/capability-generator.d.ts.map +1 -0
  325. package/dist/cli/generators/capability-generator.js +115 -0
  326. package/dist/cli/generators/capability-generator.js.map +1 -0
  327. package/dist/cli/helpers/app-tsx-wiring.d.ts +19 -0
  328. package/dist/cli/helpers/app-tsx-wiring.d.ts.map +1 -0
  329. package/dist/cli/helpers/app-tsx-wiring.js +143 -0
  330. package/dist/cli/helpers/app-tsx-wiring.js.map +1 -0
  331. package/dist/cli/helpers/column-template.d.ts +18 -0
  332. package/dist/cli/helpers/column-template.d.ts.map +1 -0
  333. package/dist/cli/helpers/column-template.js +151 -0
  334. package/dist/cli/helpers/column-template.js.map +1 -0
  335. package/dist/cli/helpers/duration.d.ts +5 -0
  336. package/dist/cli/helpers/duration.d.ts.map +1 -0
  337. package/dist/cli/helpers/duration.js +19 -0
  338. package/dist/cli/helpers/duration.js.map +1 -0
  339. package/dist/cli/helpers/field-template.d.ts +14 -0
  340. package/dist/cli/helpers/field-template.d.ts.map +1 -0
  341. package/dist/cli/helpers/field-template.js +101 -0
  342. package/dist/cli/helpers/field-template.js.map +1 -0
  343. package/dist/cli/helpers/naming.d.ts +12 -0
  344. package/dist/cli/helpers/naming.d.ts.map +1 -0
  345. package/dist/cli/helpers/naming.js +25 -0
  346. package/dist/cli/helpers/naming.js.map +1 -0
  347. package/dist/cli/index.d.ts +9 -0
  348. package/dist/cli/index.d.ts.map +1 -0
  349. package/dist/cli/index.js +33 -0
  350. package/dist/cli/index.js.map +1 -0
  351. package/dist/cli/templates/backend-entry.d.ts +5 -0
  352. package/dist/cli/templates/backend-entry.d.ts.map +1 -0
  353. package/dist/cli/templates/backend-entry.js +17 -0
  354. package/dist/cli/templates/backend-entry.js.map +1 -0
  355. package/dist/cli/templates/frontend-entry.d.ts +11 -0
  356. package/dist/cli/templates/frontend-entry.d.ts.map +1 -0
  357. package/dist/cli/templates/frontend-entry.js +70 -0
  358. package/dist/cli/templates/frontend-entry.js.map +1 -0
  359. package/dist/cli/templates/gitignore.d.ts +5 -0
  360. package/dist/cli/templates/gitignore.d.ts.map +1 -0
  361. package/dist/cli/templates/gitignore.js +13 -0
  362. package/dist/cli/templates/gitignore.js.map +1 -0
  363. package/dist/cli/templates/index.d.ts +12 -0
  364. package/dist/cli/templates/index.d.ts.map +1 -0
  365. package/dist/cli/templates/index.js +12 -0
  366. package/dist/cli/templates/index.js.map +1 -0
  367. package/dist/cli/templates/loom-config.d.ts +10 -0
  368. package/dist/cli/templates/loom-config.d.ts.map +1 -0
  369. package/dist/cli/templates/loom-config.js +31 -0
  370. package/dist/cli/templates/loom-config.js.map +1 -0
  371. package/dist/cli/templates/package-json.d.ts +9 -0
  372. package/dist/cli/templates/package-json.d.ts.map +1 -0
  373. package/dist/cli/templates/package-json.js +40 -0
  374. package/dist/cli/templates/package-json.js.map +1 -0
  375. package/dist/cli/templates/readme.d.ts +9 -0
  376. package/dist/cli/templates/readme.d.ts.map +1 -0
  377. package/dist/cli/templates/readme.js +47 -0
  378. package/dist/cli/templates/readme.js.map +1 -0
  379. package/dist/cli/templates/tsconfig.d.ts +6 -0
  380. package/dist/cli/templates/tsconfig.d.ts.map +1 -0
  381. package/dist/cli/templates/tsconfig.js +41 -0
  382. package/dist/cli/templates/tsconfig.js.map +1 -0
  383. package/dist/cli/templates/vite-config.d.ts +5 -0
  384. package/dist/cli/templates/vite-config.d.ts.map +1 -0
  385. package/dist/cli/templates/vite-config.js +24 -0
  386. package/dist/cli/templates/vite-config.js.map +1 -0
  387. package/dist/cli/utils.d.ts +10 -0
  388. package/dist/cli/utils.d.ts.map +1 -0
  389. package/dist/cli/utils.js +31 -0
  390. package/dist/cli/utils.js.map +1 -0
  391. package/dist/commands.d.ts +1 -5
  392. package/dist/commands.d.ts.map +1 -1
  393. package/dist/commands.js +0 -11
  394. package/dist/commands.js.map +1 -1
  395. package/dist/config.d.ts +21 -52
  396. package/dist/config.d.ts.map +1 -1
  397. package/dist/config.js +8 -9
  398. package/dist/config.js.map +1 -1
  399. package/dist/dashboard-config.d.ts +117 -0
  400. package/dist/dashboard-config.d.ts.map +1 -0
  401. package/dist/dashboard-config.js +59 -0
  402. package/dist/dashboard-config.js.map +1 -0
  403. package/dist/index.d.ts +9 -4
  404. package/dist/index.d.ts.map +1 -1
  405. package/dist/index.js +8 -2
  406. package/dist/index.js.map +1 -1
  407. package/dist/server-bin.d.ts +12 -0
  408. package/dist/server-bin.d.ts.map +1 -0
  409. package/dist/server-bin.js +43 -0
  410. package/dist/server-bin.js.map +1 -0
  411. package/dist/types/adapter.d.ts +28 -0
  412. package/dist/types/adapter.d.ts.map +1 -0
  413. package/dist/types/adapter.js +5 -0
  414. package/dist/types/adapter.js.map +1 -0
  415. package/dist/types/ai.d.ts +52 -0
  416. package/dist/types/ai.d.ts.map +1 -0
  417. package/dist/types/ai.js +5 -0
  418. package/dist/types/ai.js.map +1 -0
  419. package/dist/types/chat.d.ts +46 -0
  420. package/dist/types/chat.d.ts.map +1 -0
  421. package/dist/types/chat.js +5 -0
  422. package/dist/types/chat.js.map +1 -0
  423. package/dist/types/command.d.ts +25 -0
  424. package/dist/types/command.d.ts.map +1 -0
  425. package/dist/types/command.js +5 -0
  426. package/dist/types/command.js.map +1 -0
  427. package/dist/types/config.d.ts +30 -0
  428. package/dist/types/config.d.ts.map +1 -0
  429. package/dist/types/config.js +5 -0
  430. package/dist/types/config.js.map +1 -0
  431. package/dist/types/dashboard.d.ts +42 -0
  432. package/dist/types/dashboard.d.ts.map +1 -0
  433. package/dist/types/dashboard.js +5 -0
  434. package/dist/types/dashboard.js.map +1 -0
  435. package/dist/types/index.d.ts +14 -0
  436. package/dist/types/index.d.ts.map +1 -0
  437. package/dist/types/index.js +8 -0
  438. package/dist/types/index.js.map +1 -0
  439. package/dist/types/model.d.ts +59 -0
  440. package/dist/types/model.d.ts.map +1 -0
  441. package/dist/types/model.js +5 -0
  442. package/dist/types/model.js.map +1 -0
  443. package/dist/types.d.ts +4 -199
  444. package/dist/types.d.ts.map +1 -1
  445. package/dist/types.js +4 -3
  446. package/dist/types.js.map +1 -1
  447. package/package.json +18 -3
@@ -0,0 +1,11 @@
1
+ /**
2
+ * Routes - Barrel Export
3
+ */
4
+ export { registerDataRoutes } from './data.js';
5
+ export { registerHealthRoute } from './health.js';
6
+ export { registerUploadRoutes, saveUploadedFile } from './upload.js';
7
+ export { registerChatRoutes } from './chat.js';
8
+ export type { ChatRouteOptions } from './chat.js';
9
+ export { registerSkillRoutes } from './skills.js';
10
+ export type { SkillRouteOptions } from './skills.js';
11
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/backend/routes/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Routes - Barrel Export
3
+ */
4
+ export { registerDataRoutes } from './data.js';
5
+ export { registerHealthRoute } from './health.js';
6
+ export { registerUploadRoutes, saveUploadedFile } from './upload.js';
7
+ export { registerChatRoutes } from './chat.js';
8
+ export { registerSkillRoutes } from './skills.js';
9
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/backend/routes/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}
@@ -0,0 +1,16 @@
1
+ /**
2
+ * Skill Management Routes - REST API for managing skills in .claude/skills/
3
+ *
4
+ * POST /api/v1/skills — Create a new skill
5
+ * GET /api/v1/skills — List all skills with metadata
6
+ * GET /api/v1/skills/:skillName — Get skill details
7
+ * DELETE /api/v1/skills/:skillName — Delete a skill
8
+ * GET /api/v1/skills/:skillName/file/:filePath — Get a file's content
9
+ * POST /api/v1/skills/:skillName/file — Upload/replace a file in a skill
10
+ */
11
+ import type { FastifyInstance } from 'fastify';
12
+ export interface SkillRouteOptions {
13
+ projectRoot: string;
14
+ }
15
+ export declare function registerSkillRoutes(fastify: FastifyInstance, options: SkillRouteOptions): void;
16
+ //# sourceMappingURL=skills.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../src/backend/routes/skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AA2X/C,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,iBAAiB,GACzB,IAAI,CAoSN"}
@@ -0,0 +1,590 @@
1
+ /**
2
+ * Skill Management Routes - REST API for managing skills in .claude/skills/
3
+ *
4
+ * POST /api/v1/skills — Create a new skill
5
+ * GET /api/v1/skills — List all skills with metadata
6
+ * GET /api/v1/skills/:skillName — Get skill details
7
+ * DELETE /api/v1/skills/:skillName — Delete a skill
8
+ * GET /api/v1/skills/:skillName/file/:filePath — Get a file's content
9
+ * POST /api/v1/skills/:skillName/file — Upload/replace a file in a skill
10
+ */
11
+ import { promises as fs } from 'node:fs';
12
+ import path from 'node:path';
13
+ import AdmZip from 'adm-zip';
14
+ // ── Schemas ──
15
+ const skillNameParamSchema = {
16
+ type: 'object',
17
+ required: ['skillName'],
18
+ properties: {
19
+ skillName: { type: 'string', minLength: 1 },
20
+ },
21
+ };
22
+ const createSkillBodySchema = {
23
+ type: 'object',
24
+ required: ['name'],
25
+ properties: {
26
+ name: { type: 'string', minLength: 1, maxLength: 64 },
27
+ skillMd: { type: 'string' },
28
+ references: {
29
+ type: 'array',
30
+ items: {
31
+ type: 'object',
32
+ required: ['name', 'content'],
33
+ properties: {
34
+ name: { type: 'string' },
35
+ content: { type: 'string' },
36
+ },
37
+ },
38
+ },
39
+ scripts: {
40
+ type: 'array',
41
+ items: {
42
+ type: 'object',
43
+ required: ['name', 'content'],
44
+ properties: {
45
+ name: { type: 'string' },
46
+ content: { type: 'string' },
47
+ },
48
+ },
49
+ },
50
+ files: {
51
+ type: 'array',
52
+ items: {
53
+ type: 'object',
54
+ required: ['path', 'content'],
55
+ properties: {
56
+ path: { type: 'string' },
57
+ content: { type: 'string' },
58
+ },
59
+ },
60
+ },
61
+ },
62
+ };
63
+ const parseArchiveBodySchema = {
64
+ type: 'object',
65
+ required: ['data'],
66
+ properties: {
67
+ data: { type: 'string', minLength: 1 },
68
+ },
69
+ };
70
+ const uploadFileBodySchema = {
71
+ type: 'object',
72
+ required: ['filename', 'content'],
73
+ properties: {
74
+ filename: { type: 'string', minLength: 1 },
75
+ content: { type: 'string' },
76
+ },
77
+ };
78
+ // ── Helpers ─
79
+ /**
80
+ * Parse YAML frontmatter from markdown content using simple regex.
81
+ */
82
+ function parseFrontmatter(content) {
83
+ const match = content.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
84
+ if (!match)
85
+ return { metadata: {}, body: content };
86
+ try {
87
+ const metadata = {};
88
+ const lines = match[1].split('\n');
89
+ let currentKey = '';
90
+ let currentValues = [];
91
+ let inArray = false;
92
+ let inBlock = false;
93
+ let blockLines = [];
94
+ const flushBlock = () => {
95
+ if (inBlock && currentKey) {
96
+ metadata[currentKey] = blockLines.join('\n').trim();
97
+ }
98
+ inBlock = false;
99
+ blockLines = [];
100
+ };
101
+ for (const line of lines) {
102
+ if (inBlock) {
103
+ if (/^[ \t]+/.test(line) || (line === '' && blockLines.length > 0)) {
104
+ blockLines.push(line.replace(/^[ \t]+/, ''));
105
+ continue;
106
+ }
107
+ else {
108
+ flushBlock();
109
+ }
110
+ }
111
+ const trimmed = line.trim();
112
+ if (!trimmed)
113
+ continue;
114
+ const arrayMatch = trimmed.match(/^-\s+(.+)$/);
115
+ if (inArray && arrayMatch) {
116
+ currentValues.push(arrayMatch[1].replace(/^['"]|['"]$/g, '').trim());
117
+ continue;
118
+ }
119
+ if (inArray && currentKey) {
120
+ metadata[currentKey] = currentValues;
121
+ inArray = false;
122
+ currentValues = [];
123
+ }
124
+ const kvMatch = trimmed.match(/^([a-zA-Z_-][a-zA-Z0-9_-]*):\s*(.*)$/);
125
+ if (kvMatch) {
126
+ currentKey = kvMatch[1];
127
+ let val = kvMatch[2].trim();
128
+ if ((val.startsWith("'") && val.endsWith("'")) || (val.startsWith('"') && val.endsWith('"'))) {
129
+ val = val.slice(1, -1);
130
+ }
131
+ if (val === '|' || val === '>') {
132
+ inBlock = true;
133
+ blockLines = [];
134
+ continue;
135
+ }
136
+ if (val === '[') {
137
+ inArray = true;
138
+ currentValues = [];
139
+ continue;
140
+ }
141
+ if (val.startsWith('[') && val.endsWith(']')) {
142
+ metadata[currentKey] = val.slice(1, -1).split(',').map((s) => s.trim().replace(/^['"]|['"]$/g, ''));
143
+ currentKey = '';
144
+ continue;
145
+ }
146
+ metadata[currentKey] = val;
147
+ currentKey = '';
148
+ }
149
+ }
150
+ if (inArray && currentKey) {
151
+ metadata[currentKey] = currentValues;
152
+ }
153
+ flushBlock();
154
+ return { metadata, body: match[2] || '' };
155
+ }
156
+ catch {
157
+ return { metadata: {}, body: content };
158
+ }
159
+ }
160
+ /**
161
+ * Recursively scan a directory for files, returning relative paths.
162
+ * Excludes SKILL.md (handled separately).
163
+ */
164
+ async function scanDirFiles(dir, base) {
165
+ const results = [];
166
+ let entries;
167
+ try {
168
+ entries = await fs.readdir(dir, { withFileTypes: true });
169
+ }
170
+ catch {
171
+ return results;
172
+ }
173
+ for (const entry of entries) {
174
+ if (entry.isDirectory()) {
175
+ const subFiles = await scanDirFiles(path.join(dir, entry.name), base);
176
+ results.push(...subFiles);
177
+ }
178
+ else {
179
+ const relPath = path.relative(base, path.join(dir, entry.name));
180
+ results.push(relPath);
181
+ }
182
+ }
183
+ return results;
184
+ }
185
+ /**
186
+ * Safely resolve a file path within a directory. Rejects '..' traversal.
187
+ */
188
+ function safeResolve(baseDir, filePath) {
189
+ if (filePath.includes('..'))
190
+ return null;
191
+ const resolved = path.resolve(baseDir, filePath);
192
+ if (!resolved.startsWith(baseDir))
193
+ return null;
194
+ return resolved;
195
+ }
196
+ /**
197
+ * Validate skill name.
198
+ */
199
+ function isValidSkillName(name) {
200
+ return /^[a-zA-Z][a-zA-Z0-9_-]*$/.test(name);
201
+ }
202
+ /**
203
+ * Text file extensions that should be kept when parsing zip archives.
204
+ */
205
+ const TEXT_EXTENSIONS = new Set([
206
+ '.md', '.json', '.yaml', '.yml', '.txt', '.ts', '.js', '.tsx', '.jsx',
207
+ '.xml', '.html', '.css', '.sh', '.py', '.rb', '.go', '.rs', '.java',
208
+ '.kt', '.swift', '.c', '.cpp', '.h', '.hpp', '.toml', '.ini', '.cfg',
209
+ '.env', '.gitignore', '.prettierrc', '.eslintrc', '.conf', '.properties',
210
+ ]);
211
+ /**
212
+ * Check if a file path looks like a text file based on extension.
213
+ */
214
+ function isTextFile(filePath) {
215
+ const ext = path.extname(filePath).toLowerCase();
216
+ if (TEXT_EXTENSIONS.has(ext))
217
+ return true;
218
+ // Files with no extension but common names
219
+ const basename = path.basename(filePath).toLowerCase();
220
+ if (['readme', 'license', 'makefile', 'dockerfile', '.gitkeep', '.gitignore'].includes(basename))
221
+ return true;
222
+ if (basename.startsWith('.git'))
223
+ return true;
224
+ return false;
225
+ }
226
+ /**
227
+ * Parse a zip archive buffer and extract skill structure.
228
+ */
229
+ function parseZipArchive(buffer) {
230
+ const zip = new AdmZip(buffer);
231
+ const entries = zip.getEntries();
232
+ // Collect valid file entries
233
+ const validEntries = entries.filter((entry) => {
234
+ if (entry.isDirectory)
235
+ return false;
236
+ const entryPath = entry.entryName;
237
+ // Skip macOS metadata
238
+ if (entryPath.startsWith('__MACOSX/'))
239
+ return false;
240
+ // Skip .DS_Store and hidden files in root
241
+ const parts = entryPath.split('/');
242
+ if (parts.some((p) => p.startsWith('.') && p !== '.gitkeep' && p !== '.gitignore'))
243
+ return false;
244
+ return true;
245
+ });
246
+ if (validEntries.length === 0) {
247
+ throw new Error('压缩包中没有任何有效文件');
248
+ }
249
+ // Detect common top-level directory prefix
250
+ let prefix = '';
251
+ const firstEntry = validEntries[0].entryName;
252
+ const slashIdx = firstEntry.indexOf('/');
253
+ if (slashIdx > 0) {
254
+ const candidate = firstEntry.substring(0, slashIdx + 1);
255
+ if (validEntries.every((e) => e.entryName.startsWith(candidate))) {
256
+ prefix = candidate;
257
+ }
258
+ }
259
+ // Strip prefix and collect files
260
+ const allFiles = [];
261
+ for (const entry of validEntries) {
262
+ let relPath = entry.entryName;
263
+ if (prefix && relPath.startsWith(prefix)) {
264
+ relPath = relPath.substring(prefix.length);
265
+ }
266
+ // Skip if empty after stripping prefix
267
+ if (!relPath)
268
+ continue;
269
+ // Only keep text files
270
+ if (!isTextFile(relPath))
271
+ continue;
272
+ const content = entry.getData().toString('utf-8');
273
+ allFiles.push({ path: relPath, content });
274
+ }
275
+ // Find SKILL.md
276
+ const skillMdEntry = allFiles.find((f) => f.path === 'SKILL.md');
277
+ if (!skillMdEntry) {
278
+ throw new Error('压缩包中未找到 SKILL.md 文件');
279
+ }
280
+ // Check for duplicate SKILL.md in subdirectories
281
+ const skillMdCount = allFiles.filter((f) => path.basename(f.path) === 'SKILL.md').length;
282
+ if (skillMdCount > 1) {
283
+ throw new Error('压缩包中包含多个 SKILL.md 文件,请确保只有一个');
284
+ }
285
+ // Extract skill name from frontmatter or directory name
286
+ const { metadata } = parseFrontmatter(skillMdEntry.content);
287
+ let skillName = metadata.name;
288
+ if (!skillName || typeof skillName !== 'string') {
289
+ // Fallback to directory name from prefix
290
+ if (prefix) {
291
+ skillName = prefix.replace(/\/$/, '');
292
+ }
293
+ else {
294
+ throw new Error('无法确定 Skill 名称,请在 SKILL.md 的 frontmatter 中指定 name 字段');
295
+ }
296
+ }
297
+ // Validate skill name
298
+ if (!isValidSkillName(skillName)) {
299
+ throw new Error(`Skill 名称 "${skillName}" 不合法,只能包含字母、数字、中划线和下划线,且以字母开头`);
300
+ }
301
+ // Separate SKILL.md from other files
302
+ const files = allFiles.filter((f) => f.path !== 'SKILL.md');
303
+ return { skillName, skillMd: skillMdEntry.content, files };
304
+ }
305
+ /**
306
+ * Get MIME type for a file extension.
307
+ */
308
+ function getContentType(filePath) {
309
+ const ext = path.extname(filePath).toLowerCase();
310
+ const types = {
311
+ '.md': 'text/markdown',
312
+ '.txt': 'text/plain',
313
+ '.json': 'application/json',
314
+ '.xml': 'application/xml',
315
+ '.yaml': 'text/yaml',
316
+ '.yml': 'text/yaml',
317
+ '.ts': 'text/typescript',
318
+ '.js': 'text/javascript',
319
+ '.html': 'text/html',
320
+ '.css': 'text/css',
321
+ };
322
+ return types[ext] || 'text/plain';
323
+ }
324
+ export function registerSkillRoutes(fastify, options) {
325
+ const skillsDir = path.join(options.projectRoot, '.claude', 'skills');
326
+ const ensureSkillsDir = async () => {
327
+ await fs.mkdir(skillsDir, { recursive: true });
328
+ };
329
+ // ── GET /api/v1/skills ──
330
+ fastify.get('/api/v1/skills', async (_request, reply) => {
331
+ await ensureSkillsDir();
332
+ let entries;
333
+ try {
334
+ entries = await fs.readdir(skillsDir, { withFileTypes: true });
335
+ }
336
+ catch {
337
+ return reply.send({ data: [] });
338
+ }
339
+ const skills = [];
340
+ for (const entry of entries) {
341
+ if (!entry.isDirectory())
342
+ continue;
343
+ const skillDir = path.join(skillsDir, entry.name);
344
+ const skillMdPath = path.join(skillDir, 'SKILL.md');
345
+ let metadata = {};
346
+ try {
347
+ const content = await fs.readFile(skillMdPath, 'utf-8');
348
+ metadata = parseFrontmatter(content).metadata;
349
+ }
350
+ catch {
351
+ // SKILL.md doesn't exist or is unreadable
352
+ }
353
+ // Scan subdirectories dynamically (any folder name, not just 'references')
354
+ let subDirs = [];
355
+ try {
356
+ const dirEntries = await fs.readdir(skillDir, { withFileTypes: true });
357
+ subDirs = dirEntries.filter((e) => e.isDirectory()).map((e) => e.name);
358
+ }
359
+ catch {
360
+ // ignore
361
+ }
362
+ skills.push({ name: entry.name, metadata, subDirs });
363
+ }
364
+ return reply.send({ data: skills });
365
+ });
366
+ // ── POST /api/v1/skills/parse-archive ──
367
+ fastify.post('/api/v1/skills/parse-archive', {
368
+ schema: { body: parseArchiveBodySchema },
369
+ }, async (request, reply) => {
370
+ const body = request.body;
371
+ let buffer;
372
+ try {
373
+ buffer = Buffer.from(body.data, 'base64');
374
+ }
375
+ catch {
376
+ return reply.status(400).send({ error: '无效的 base64 编码' });
377
+ }
378
+ try {
379
+ const result = parseZipArchive(buffer);
380
+ return reply.send({ data: result });
381
+ }
382
+ catch (err) {
383
+ const msg = err instanceof Error ? err.message : '解析压缩包失败';
384
+ return reply.status(400).send({ error: msg });
385
+ }
386
+ });
387
+ // ── GET /api/v1/skills/:skillName ──
388
+ fastify.get('/api/v1/skills/:skillName', {
389
+ schema: { params: skillNameParamSchema },
390
+ }, async (request, reply) => {
391
+ const { skillName } = request.params;
392
+ const skillDir = path.join(skillsDir, skillName);
393
+ const exists = await fs.access(skillDir).then(() => true, () => false);
394
+ if (!exists) {
395
+ return reply.status(404).send({ error: `Skill "${skillName}" not found` });
396
+ }
397
+ let skillMd = '';
398
+ let metadata = {};
399
+ try {
400
+ skillMd = await fs.readFile(path.join(skillDir, 'SKILL.md'), 'utf-8');
401
+ metadata = parseFrontmatter(skillMd).metadata;
402
+ }
403
+ catch {
404
+ // SKILL.md doesn't exist
405
+ }
406
+ // Dynamically scan all files in subdirectories
407
+ const allFiles = await scanDirFiles(skillDir, skillDir);
408
+ const files = allFiles.map((p) => ({
409
+ name: path.basename(p),
410
+ path: p,
411
+ }));
412
+ return reply.send({ data: { name: skillName, metadata, skillMd, files } });
413
+ });
414
+ // ── GET /api/v1/skills/:skillName/archive ──
415
+ fastify.get('/api/v1/skills/:skillName/archive', {
416
+ schema: { params: skillNameParamSchema },
417
+ }, async (request, reply) => {
418
+ const { skillName } = request.params;
419
+ const skillDir = path.join(skillsDir, skillName);
420
+ const exists = await fs.access(skillDir).then(() => true, () => false);
421
+ if (!exists) {
422
+ return reply.status(404).send({ error: `Skill "${skillName}" not found` });
423
+ }
424
+ const zip = new AdmZip();
425
+ // Add SKILL.md
426
+ const skillMdPath = path.join(skillDir, 'SKILL.md');
427
+ try {
428
+ const skillMd = await fs.readFile(skillMdPath, 'utf-8');
429
+ zip.addFile('SKILL.md', Buffer.from(skillMd, 'utf-8'));
430
+ }
431
+ catch {
432
+ // SKILL.md doesn't exist, skip
433
+ }
434
+ // Add all other files, preserving directory structure
435
+ const allFiles = await scanDirFiles(skillDir, skillDir);
436
+ for (const filePath of allFiles) {
437
+ if (filePath === 'SKILL.md')
438
+ continue;
439
+ const resolvedPath = safeResolve(skillDir, filePath);
440
+ if (!resolvedPath)
441
+ continue;
442
+ try {
443
+ const content = await fs.readFile(resolvedPath);
444
+ // Store under skillName/ prefix for proper extraction
445
+ zip.addFile(`${skillName}/${filePath}`, content);
446
+ }
447
+ catch {
448
+ // skip unreadable files
449
+ }
450
+ }
451
+ // Also put SKILL.md under the prefix
452
+ zip.deleteFile('SKILL.md');
453
+ try {
454
+ const skillMd = await fs.readFile(skillMdPath, 'utf-8');
455
+ zip.addFile(`${skillName}/SKILL.md`, Buffer.from(skillMd, 'utf-8'));
456
+ }
457
+ catch {
458
+ // skip
459
+ }
460
+ const zipBuffer = zip.toBuffer();
461
+ reply.header('Content-Type', 'application/zip');
462
+ reply.header('Content-Disposition', `attachment; filename="${skillName}.zip"`);
463
+ return reply.send(zipBuffer);
464
+ });
465
+ // ── GET /api/v1/skills/:skillName/file/* ──
466
+ fastify.get('/api/v1/skills/:skillName/file/*', async (request, reply) => {
467
+ const { skillName } = request.params;
468
+ const filePath = request.params['*'];
469
+ const skillDir = path.join(skillsDir, skillName);
470
+ const exists = await fs.access(skillDir).then(() => true, () => false);
471
+ if (!exists) {
472
+ return reply.status(404).send({ error: `Skill "${skillName}" not found` });
473
+ }
474
+ const resolvedPath = safeResolve(skillDir, filePath);
475
+ if (!resolvedPath) {
476
+ return reply.status(400).send({ error: 'Invalid file path' });
477
+ }
478
+ const fileExists = await fs.access(resolvedPath).then(() => true, () => false);
479
+ if (!fileExists) {
480
+ return reply.status(404).send({ error: `File "${filePath}" not found` });
481
+ }
482
+ try {
483
+ const content = await fs.readFile(resolvedPath, 'utf-8');
484
+ return reply.send({ data: { content, path: filePath } });
485
+ }
486
+ catch (err) {
487
+ return reply.status(500).send({ error: `Failed to read file: ${err}` });
488
+ }
489
+ });
490
+ // ── POST /api/v1/skills ──
491
+ fastify.post('/api/v1/skills', {
492
+ schema: { body: createSkillBodySchema },
493
+ }, async (request, reply) => {
494
+ const body = request.body;
495
+ const { name, skillMd, references, scripts: scriptFiles, files: archiveFiles } = body;
496
+ if (!isValidSkillName(name)) {
497
+ return reply.status(400).send({ error: 'Invalid skill name. Use alphanumeric, hyphens, and underscores only.' });
498
+ }
499
+ const skillDir = path.join(skillsDir, name);
500
+ const exists = await fs.access(skillDir).then(() => true, () => false);
501
+ if (exists) {
502
+ return reply.status(409).send({ error: `Skill "${name}" already exists` });
503
+ }
504
+ await fs.mkdir(skillDir, { recursive: true });
505
+ const contentToWrite = skillMd || `---
506
+ name: ${name}
507
+ description: ''
508
+ version: 1.0.0
509
+ ---
510
+
511
+ # ${name}
512
+
513
+ ## Overview
514
+
515
+ [Describe what this skill does]
516
+
517
+ ## Usage Scenarios
518
+
519
+ - "User prompt" → [what the skill does]
520
+ `;
521
+ await fs.writeFile(path.join(skillDir, 'SKILL.md'), contentToWrite, 'utf-8');
522
+ if (references && references.length > 0) {
523
+ const refDir = path.join(skillDir, 'references');
524
+ await fs.mkdir(refDir, { recursive: true });
525
+ for (const ref of references) {
526
+ const safePath = safeResolve(refDir, ref.name);
527
+ if (safePath) {
528
+ await fs.mkdir(path.dirname(safePath), { recursive: true });
529
+ await fs.writeFile(safePath, ref.content, 'utf-8');
530
+ }
531
+ }
532
+ }
533
+ if (scriptFiles && scriptFiles.length > 0) {
534
+ const scriptsDir = path.join(skillDir, 'scripts');
535
+ await fs.mkdir(scriptsDir, { recursive: true });
536
+ for (const script of scriptFiles) {
537
+ const safePath = safeResolve(scriptsDir, script.name);
538
+ if (safePath) {
539
+ await fs.mkdir(path.dirname(safePath), { recursive: true });
540
+ await fs.writeFile(safePath, script.content, 'utf-8');
541
+ }
542
+ }
543
+ }
544
+ if (archiveFiles && archiveFiles.length > 0) {
545
+ for (const file of archiveFiles) {
546
+ const safePath = safeResolve(skillDir, file.path);
547
+ if (safePath) {
548
+ await fs.mkdir(path.dirname(safePath), { recursive: true });
549
+ await fs.writeFile(safePath, file.content, 'utf-8');
550
+ }
551
+ }
552
+ }
553
+ const metadata = parseFrontmatter(contentToWrite).metadata;
554
+ return reply.code(201).send({ data: { name, metadata } });
555
+ });
556
+ // ── DELETE /api/v1/skills/:skillName ──
557
+ fastify.delete('/api/v1/skills/:skillName', {
558
+ schema: { params: skillNameParamSchema },
559
+ }, async (request, reply) => {
560
+ const { skillName } = request.params;
561
+ const skillDir = path.join(skillsDir, skillName);
562
+ const exists = await fs.access(skillDir).then(() => true, () => false);
563
+ if (!exists) {
564
+ return reply.status(404).send({ error: `Skill "${skillName}" not found` });
565
+ }
566
+ await fs.rm(skillDir, { recursive: true, force: true });
567
+ return reply.send({ success: true });
568
+ });
569
+ // ── POST /api/v1/skills/:skillName/file ──
570
+ fastify.post('/api/v1/skills/:skillName/file', {
571
+ schema: { params: skillNameParamSchema, body: uploadFileBodySchema },
572
+ }, async (request, reply) => {
573
+ const { skillName } = request.params;
574
+ const body = request.body;
575
+ const { filename, content } = body;
576
+ const skillDir = path.join(skillsDir, skillName);
577
+ const exists = await fs.access(skillDir).then(() => true, () => false);
578
+ if (!exists) {
579
+ return reply.status(404).send({ error: `Skill "${skillName}" not found` });
580
+ }
581
+ const resolvedPath = safeResolve(skillDir, filename);
582
+ if (!resolvedPath) {
583
+ return reply.status(400).send({ error: 'Invalid file path' });
584
+ }
585
+ await fs.mkdir(path.dirname(resolvedPath), { recursive: true });
586
+ await fs.writeFile(resolvedPath, content, 'utf-8');
587
+ return reply.send({ success: true, path: filename });
588
+ });
589
+ }
590
+ //# sourceMappingURL=skills.js.map