@hasna/skills 0.1.62 → 0.1.63

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 (526) hide show
  1. package/README.md +10 -6
  2. package/bin/index.js +14271 -21602
  3. package/bin/mcp.js +3527 -11449
  4. package/bin/migrate.js +53 -3
  5. package/bin/server.js +5140 -2675
  6. package/bin/worker.js +4542 -2129
  7. package/dist/cli/commands/publish.d.ts +2 -0
  8. package/dist/cli/components/App.d.ts +2 -1
  9. package/dist/cli/components/CategorySelect.d.ts +2 -1
  10. package/dist/cli/components/Header.d.ts +2 -1
  11. package/dist/cli/components/InstallProgress.d.ts +2 -1
  12. package/dist/cli/components/SearchView.d.ts +2 -1
  13. package/dist/cli/components/SkillSelect.d.ts +2 -1
  14. package/dist/index.d.ts +4 -1
  15. package/dist/index.js +5094 -13755
  16. package/dist/lib/agent-sync.d.ts +38 -3
  17. package/dist/lib/home-adoption.d.ts +91 -0
  18. package/dist/lib/home-census.d.ts +22 -0
  19. package/dist/lib/home-migration.d.ts +61 -0
  20. package/dist/lib/portable-skills-files.d.ts +21 -1
  21. package/dist/lib/portable-skills-types.d.ts +46 -0
  22. package/dist/lib/pull.d.ts +66 -0
  23. package/dist/lib/remote-client.d.ts +6 -0
  24. package/dist/lib/run-state.d.ts +5 -0
  25. package/dist/lib/skill-bundles.d.ts +54 -0
  26. package/dist/lib/skill-contract.d.ts +35 -0
  27. package/dist/lib/skill-hash.d.ts +77 -0
  28. package/dist/sdk/cancel.d.ts +30 -0
  29. package/dist/sdk/dispatcher.d.ts +40 -0
  30. package/dist/sdk/event-sink.d.ts +2 -0
  31. package/dist/sdk/events.d.ts +79 -0
  32. package/dist/sdk/execution/admission.d.ts +44 -0
  33. package/dist/sdk/execution/dispatchers/e2b.d.ts +17 -0
  34. package/dist/sdk/execution/dispatchers/ecs.d.ts +151 -0
  35. package/dist/sdk/execution/image-profile.d.ts +73 -0
  36. package/dist/sdk/execution/index.d.ts +15 -0
  37. package/dist/sdk/execution/receipts.d.ts +44 -0
  38. package/dist/sdk/execution/state-machine.d.ts +38 -0
  39. package/dist/sdk/execution/storage.d.ts +158 -0
  40. package/dist/sdk/execution/types.d.ts +130 -0
  41. package/dist/sdk/executor.d.ts +17 -0
  42. package/dist/sdk/governance-store.d.ts +156 -0
  43. package/dist/sdk/governance.d.ts +92 -0
  44. package/dist/sdk/index.d.ts +26 -0
  45. package/dist/sdk/index.js +48730 -0
  46. package/dist/sdk/offline.d.ts +16 -0
  47. package/dist/sdk/outputs.d.ts +71 -0
  48. package/dist/sdk/registry.d.ts +28 -0
  49. package/dist/sdk/runs.d.ts +229 -0
  50. package/dist/sdk/server.d.ts +35 -0
  51. package/dist/sdk/spend.d.ts +36 -0
  52. package/dist/sdk/storage.d.ts +25 -0
  53. package/dist/server/app.d.ts +42 -0
  54. package/dist/server/artifact-storage.d.ts +102 -0
  55. package/dist/server/auth.d.ts +5 -0
  56. package/dist/server/config.d.ts +40 -0
  57. package/dist/server/database-url.d.ts +42 -0
  58. package/dist/server/handlers.d.ts +3 -0
  59. package/dist/server/index.d.ts +2 -0
  60. package/dist/server/migrate.d.ts +13 -0
  61. package/dist/server/migrations-dir.d.ts +18 -0
  62. package/dist/server/redaction.d.ts +1 -0
  63. package/dist/server/registry.d.ts +5 -0
  64. package/dist/server/rows.d.ts +23 -0
  65. package/dist/server/skills-api.d.ts +68 -0
  66. package/dist/server/sqlite-store.d.ts +114 -0
  67. package/dist/server/store-fixtures.d.ts +25 -0
  68. package/dist/server/store.d.ts +144 -0
  69. package/dist/server/types.d.ts +242 -0
  70. package/dist/server/worker.d.ts +4 -0
  71. package/dist/storage.js +32 -0
  72. package/docs/skill-standard.md +211 -39
  73. package/migrations/postgres/0003_run_outputs_governance.sql +83 -0
  74. package/migrations/sqlite/0003_run_outputs_governance.sql +58 -0
  75. package/package.json +11 -8
  76. package/schemas/skill.schema.json +181 -0
  77. package/agent-skills/README.md +0 -41
  78. package/agent-skills/fleet-package-rollout/SKILL.md +0 -169
  79. package/agent-skills/inbox/SKILL.md +0 -25
  80. package/agent-skills/inbox/scripts/inbox +0 -109
  81. package/agent-skills/inbox/tests/test_registered_sender_id.sh +0 -92
  82. package/agent-skills/inbox-monitor/SKILL.md +0 -41
  83. package/agent-skills/inbox-monitor/scripts/inbox_monitor.sh +0 -91
  84. package/agent-skills/inbox-monitor/scripts/test_inbox_monitor.sh +0 -71
  85. package/agent-skills/merge-pr/SKILL.md +0 -85
  86. package/agent-skills/merge-pr/references/merge-safety.md +0 -82
  87. package/agent-skills/merge-pr/scripts/merge_pr_guard.py +0 -694
  88. package/agent-skills/merge-pr/scripts/test_merge_pr_guard.py +0 -647
  89. package/agent-skills/merge-pr/tests/fixtures/multi-commit-synthesized.json +0 -28
  90. package/agent-skills/merge-pr/tests/fixtures/trailer-free-provider.json +0 -28
  91. package/agent-skills/skill-goal-execute/SKILL.md +0 -115
  92. package/agent-skills/skill-login/SKILL.md +0 -109
  93. package/agent-skills/skill-project-create/SKILL.md +0 -91
  94. package/agent-skills/skill-publish/SKILL.md +0 -254
  95. package/agent-skills/skill-publish/scripts/capture_registry.js +0 -47
  96. package/agent-skills/skill-publish/scripts/publish_with_git_head.sh +0 -143
  97. package/agent-skills/skill-publish/scripts/test_publish_with_git_head.sh +0 -231
  98. package/skills/_common/auth.ts +0 -45
  99. package/skills/_common/http-client.ts +0 -143
  100. package/skills/_common/index.ts +0 -26
  101. package/skills/_common/install.sh +0 -7
  102. package/skills/_common/installer.ts +0 -72
  103. package/skills/_common/skill-install.ts +0 -37
  104. package/skills/_common/vision.ts +0 -374
  105. package/skills/ad-creative-pack/SKILL.md +0 -55
  106. package/skills/ad-creative-pack/package.json +0 -10
  107. package/skills/analyze-data/CLAUDE.md +0 -16
  108. package/skills/analyze-data/SKILL.md +0 -112
  109. package/skills/analyze-data/package.json +0 -23
  110. package/skills/analyze-data/src/analysis.ts +0 -401
  111. package/skills/analyze-data/src/cli.ts +0 -66
  112. package/skills/analyze-data/src/formatters.ts +0 -235
  113. package/skills/analyze-data/src/index.ts +0 -74
  114. package/skills/analyze-data/src/logger.ts +0 -36
  115. package/skills/analyze-data/src/parsers.ts +0 -57
  116. package/skills/analyze-data/src/stats.ts +0 -151
  117. package/skills/analyze-data/src/types.ts +0 -85
  118. package/skills/analyze-data/tsconfig.json +0 -19
  119. package/skills/api-docs-portal/SKILL.md +0 -84
  120. package/skills/api-docs-portal/package.json +0 -35
  121. package/skills/api-docs-portal/src/index.ts +0 -919
  122. package/skills/api-docs-portal/tsconfig.json +0 -17
  123. package/skills/api-test-suite/CLAUDE.md +0 -19
  124. package/skills/api-test-suite/package.json +0 -27
  125. package/skills/api-test-suite/src/index.ts +0 -381
  126. package/skills/api-test-suite/tsconfig.json +0 -10
  127. package/skills/audio-extract/CLAUDE.md +0 -9
  128. package/skills/audio-extract/SKILL.md +0 -73
  129. package/skills/audio-extract/package.json +0 -23
  130. package/skills/audio-extract/src/index.ts +0 -323
  131. package/skills/audio-extract/tsconfig.json +0 -11
  132. package/skills/bio-sequence-tool/CLAUDE.md +0 -19
  133. package/skills/bio-sequence-tool/package.json +0 -27
  134. package/skills/bio-sequence-tool/src/index.ts +0 -85
  135. package/skills/bio-sequence-tool/tsconfig.json +0 -10
  136. package/skills/blog-article/CLAUDE.md +0 -12
  137. package/skills/blog-article/SKILL.md +0 -55
  138. package/skills/blog-article/package.json +0 -10
  139. package/skills/blog-article/tsconfig.json +0 -10
  140. package/skills/brand-assets/SKILL.md +0 -118
  141. package/skills/brand-assets/package.json +0 -35
  142. package/skills/brand-assets/src/cli.ts +0 -155
  143. package/skills/brand-assets/src/constants.ts +0 -8
  144. package/skills/brand-assets/src/extract.ts +0 -236
  145. package/skills/brand-assets/src/index.ts +0 -668
  146. package/skills/brand-assets/src/types.ts +0 -59
  147. package/skills/brand-assets/tsconfig.json +0 -17
  148. package/skills/brand-kit/SKILL.md +0 -54
  149. package/skills/brand-kit/package.json +0 -10
  150. package/skills/businessactivity/CLAUDE.md +0 -176
  151. package/skills/businessactivity/LICENSE +0 -192
  152. package/skills/businessactivity/README.md +0 -287
  153. package/skills/businessactivity/package.json +0 -25
  154. package/skills/businessactivity/scripts/publish.ts +0 -210
  155. package/skills/businessactivity/src/commands/activity.ts +0 -211
  156. package/skills/businessactivity/src/commands/function.ts +0 -227
  157. package/skills/businessactivity/src/commands/owner.ts +0 -193
  158. package/skills/businessactivity/src/commands/profile.ts +0 -121
  159. package/skills/businessactivity/src/commands/responsibility.ts +0 -264
  160. package/skills/businessactivity/src/commands/team.ts +0 -244
  161. package/skills/businessactivity/src/commands/workflow.ts +0 -359
  162. package/skills/businessactivity/src/index.ts +0 -3
  163. package/skills/businessactivity/src/lib/config.ts +0 -167
  164. package/skills/businessactivity/src/lib/output.ts +0 -76
  165. package/skills/businessactivity/src/lib/paths.ts +0 -79
  166. package/skills/businessactivity/src/lib/storage.ts +0 -95
  167. package/skills/businessactivity/src/types/index.ts +0 -86
  168. package/skills/businessactivity/tsconfig.json +0 -29
  169. package/skills/codefix/LICENSE +0 -192
  170. package/skills/codefix/README.md +0 -232
  171. package/skills/codefix/SKILL.md +0 -94
  172. package/skills/codefix/package.json +0 -21
  173. package/skills/codefix/src/fixers/batch.ts +0 -213
  174. package/skills/codefix/src/fixers/detector.ts +0 -160
  175. package/skills/codefix/src/fixers/index.ts +0 -7
  176. package/skills/codefix/src/fixers/runner.ts +0 -522
  177. package/skills/codefix/src/index-local.ts +0 -431
  178. package/skills/codefix/src/index.ts +0 -4
  179. package/skills/codefix/src/types.ts +0 -211
  180. package/skills/codefix/tsconfig.json +0 -15
  181. package/skills/commitpush/SKILL.md +0 -57
  182. package/skills/commitpush/package.json +0 -33
  183. package/skills/commitpush/src/index.ts +0 -34
  184. package/skills/commitpush/tsconfig.json +0 -17
  185. package/skills/commitpushpr/SKILL.md +0 -55
  186. package/skills/commitpushpr/package.json +0 -33
  187. package/skills/commitpushpr/src/index.ts +0 -34
  188. package/skills/commitpushpr/tsconfig.json +0 -17
  189. package/skills/compress-video/CLAUDE.md +0 -9
  190. package/skills/compress-video/SKILL.md +0 -79
  191. package/skills/compress-video/package.json +0 -23
  192. package/skills/compress-video/src/index.ts +0 -473
  193. package/skills/compress-video/tsconfig.json +0 -11
  194. package/skills/contract-review-report/SKILL.md +0 -52
  195. package/skills/contract-review-report/package.json +0 -10
  196. package/skills/customer-feedback-report/SKILL.md +0 -52
  197. package/skills/customer-feedback-report/package.json +0 -10
  198. package/skills/dashboard-builder/CLAUDE.md +0 -19
  199. package/skills/dashboard-builder/package.json +0 -29
  200. package/skills/dashboard-builder/src/index.ts +0 -150
  201. package/skills/dashboard-builder/tsconfig.json +0 -10
  202. package/skills/data-anonymizer/CLAUDE.md +0 -19
  203. package/skills/data-anonymizer/package.json +0 -27
  204. package/skills/data-anonymizer/src/index.ts +0 -183
  205. package/skills/data-anonymizer/tsconfig.json +0 -10
  206. package/skills/database-explorer/CLAUDE.md +0 -19
  207. package/skills/database-explorer/package.json +0 -29
  208. package/skills/database-explorer/src/index.ts +0 -95
  209. package/skills/database-explorer/tsconfig.json +0 -10
  210. package/skills/diff-viewer/CLAUDE.md +0 -19
  211. package/skills/diff-viewer/package.json +0 -30
  212. package/skills/diff-viewer/src/index.ts +0 -164
  213. package/skills/diff-viewer/tsconfig.json +0 -10
  214. package/skills/doc-read/SKILL.md +0 -45
  215. package/skills/doc-read/package.json +0 -29
  216. package/skills/doc-read/src/index.ts +0 -324
  217. package/skills/doc-read/tsconfig.json +0 -8
  218. package/skills/domainpurchase/LICENSE +0 -192
  219. package/skills/domainpurchase/SKILL.md +0 -29
  220. package/skills/domainpurchase/package.json +0 -30
  221. package/skills/domainpurchase/src/index.ts +0 -3
  222. package/skills/domainpurchase/tsconfig.json +0 -21
  223. package/skills/email-sequence/SKILL.md +0 -53
  224. package/skills/email-sequence/package.json +0 -10
  225. package/skills/experiment-power-calculator/CLAUDE.md +0 -19
  226. package/skills/experiment-power-calculator/package.json +0 -29
  227. package/skills/experiment-power-calculator/src/index.ts +0 -86
  228. package/skills/experiment-power-calculator/tsconfig.json +0 -10
  229. package/skills/extract-frames/CLAUDE.md +0 -19
  230. package/skills/extract-frames/package.json +0 -27
  231. package/skills/extract-frames/src/index.ts +0 -616
  232. package/skills/extract-frames/tsconfig.json +0 -10
  233. package/skills/file-organizer/CLAUDE.md +0 -19
  234. package/skills/file-organizer/package.json +0 -27
  235. package/skills/file-organizer/src/index.ts +0 -91
  236. package/skills/file-organizer/tsconfig.json +0 -10
  237. package/skills/folder-tree/CLAUDE.md +0 -19
  238. package/skills/folder-tree/package.json +0 -29
  239. package/skills/folder-tree/src/index.ts +0 -568
  240. package/skills/folder-tree/tsconfig.json +0 -10
  241. package/skills/form-filler/CLAUDE.md +0 -19
  242. package/skills/form-filler/package.json +0 -29
  243. package/skills/form-filler/src/index.ts +0 -81
  244. package/skills/form-filler/tsconfig.json +0 -10
  245. package/skills/generate-api-client/CLAUDE.md +0 -19
  246. package/skills/generate-api-client/package.json +0 -29
  247. package/skills/generate-api-client/src/generator.ts +0 -47
  248. package/skills/generate-api-client/src/index.ts +0 -92
  249. package/skills/generate-api-client/src/logger.ts +0 -34
  250. package/skills/generate-api-client/src/python-generator.ts +0 -245
  251. package/skills/generate-api-client/src/spec-loader.ts +0 -48
  252. package/skills/generate-api-client/src/type-mappers.ts +0 -79
  253. package/skills/generate-api-client/src/types.ts +0 -76
  254. package/skills/generate-api-client/src/typescript-generator.ts +0 -247
  255. package/skills/generate-api-client/tsconfig.json +0 -10
  256. package/skills/generate-chart/CLAUDE.md +0 -19
  257. package/skills/generate-chart/package.json +0 -27
  258. package/skills/generate-chart/src/index.ts +0 -510
  259. package/skills/generate-chart/tsconfig.json +0 -10
  260. package/skills/generate-dockerfile/CLAUDE.md +0 -19
  261. package/skills/generate-dockerfile/package.json +0 -27
  262. package/skills/generate-dockerfile/src/cli.ts +0 -78
  263. package/skills/generate-dockerfile/src/dockerfile-templates.ts +0 -392
  264. package/skills/generate-dockerfile/src/index.ts +0 -81
  265. package/skills/generate-dockerfile/src/logger.ts +0 -30
  266. package/skills/generate-dockerfile/src/project-detection.ts +0 -68
  267. package/skills/generate-dockerfile/src/support-files.ts +0 -171
  268. package/skills/generate-dockerfile/src/types.ts +0 -29
  269. package/skills/generate-dockerfile/tsconfig.json +0 -10
  270. package/skills/generate-env/CLAUDE.md +0 -19
  271. package/skills/generate-env/package.json +0 -29
  272. package/skills/generate-env/src/cli.ts +0 -85
  273. package/skills/generate-env/src/detection.ts +0 -161
  274. package/skills/generate-env/src/env-data.ts +0 -66
  275. package/skills/generate-env/src/generators.ts +0 -240
  276. package/skills/generate-env/src/index.ts +0 -120
  277. package/skills/generate-env/src/runtime.ts +0 -30
  278. package/skills/generate-env/src/types.ts +0 -32
  279. package/skills/generate-env/tsconfig.json +0 -10
  280. package/skills/generate-favicon/CLAUDE.md +0 -19
  281. package/skills/generate-favicon/package.json +0 -29
  282. package/skills/generate-favicon/src/index.ts +0 -421
  283. package/skills/generate-favicon/tsconfig.json +0 -10
  284. package/skills/generate-qrcode/CLAUDE.md +0 -19
  285. package/skills/generate-qrcode/package.json +0 -30
  286. package/skills/generate-qrcode/src/index.ts +0 -584
  287. package/skills/generate-qrcode/tsconfig.json +0 -10
  288. package/skills/generate-resume/CLAUDE.md +0 -19
  289. package/skills/generate-resume/package.json +0 -27
  290. package/skills/generate-resume/src/cli.ts +0 -157
  291. package/skills/generate-resume/src/index.ts +0 -178
  292. package/skills/generate-resume/src/parsers.ts +0 -95
  293. package/skills/generate-resume/src/renderers.ts +0 -538
  294. package/skills/generate-resume/src/security.ts +0 -39
  295. package/skills/generate-resume/src/types.ts +0 -86
  296. package/skills/generate-resume/tsconfig.json +0 -10
  297. package/skills/generate-sitemap/CLAUDE.md +0 -19
  298. package/skills/generate-sitemap/package.json +0 -27
  299. package/skills/generate-sitemap/src/index.ts +0 -626
  300. package/skills/generate-sitemap/tsconfig.json +0 -10
  301. package/skills/gif-maker/CLAUDE.md +0 -19
  302. package/skills/gif-maker/package.json +0 -30
  303. package/skills/gif-maker/src/index.ts +0 -600
  304. package/skills/gif-maker/tsconfig.json +0 -10
  305. package/skills/hook/LICENSE +0 -192
  306. package/skills/hook/README.md +0 -74
  307. package/skills/hook/SKILL.md +0 -85
  308. package/skills/hook/bunfig.toml +0 -5
  309. package/skills/hook/package.json +0 -28
  310. package/skills/hook/src/commands/create.ts +0 -112
  311. package/skills/hook/src/commands/events.ts +0 -37
  312. package/skills/hook/src/commands/validate.ts +0 -117
  313. package/skills/hook/src/index.ts +0 -118
  314. package/skills/hook/src/templates/root.ts +0 -196
  315. package/skills/hook/src/templates/source.ts +0 -647
  316. package/skills/hook/tsconfig.json +0 -18
  317. package/skills/http-server/CLAUDE.md +0 -19
  318. package/skills/http-server/package.json +0 -29
  319. package/skills/http-server/src/index.ts +0 -51
  320. package/skills/http-server/tsconfig.json +0 -10
  321. package/skills/implementation/LICENSE +0 -192
  322. package/skills/implementation/README.md +0 -53
  323. package/skills/implementation/SKILL.md +0 -57
  324. package/skills/implementation/bunfig.toml +0 -5
  325. package/skills/implementation/package.json +0 -28
  326. package/skills/implementation/src/commands/create.ts +0 -187
  327. package/skills/implementation/src/index.ts +0 -62
  328. package/skills/implementation/tsconfig.json +0 -18
  329. package/skills/implementation-plan/CLAUDE.md +0 -19
  330. package/skills/implementation-plan/package.json +0 -29
  331. package/skills/implementation-plan/src/index.ts +0 -520
  332. package/skills/implementation-plan/tsconfig.json +0 -10
  333. package/skills/implementation-todo/CLAUDE.md +0 -19
  334. package/skills/implementation-todo/package.json +0 -29
  335. package/skills/implementation-todo/src/index.ts +0 -429
  336. package/skills/implementation-todo/tsconfig.json +0 -10
  337. package/skills/invoice/.env.example +0 -3
  338. package/skills/invoice/CLAUDE.md +0 -31
  339. package/skills/invoice/LICENSE +0 -192
  340. package/skills/invoice/README.md +0 -70
  341. package/skills/invoice/package.json +0 -26
  342. package/skills/invoice/src/commands/companies.ts +0 -202
  343. package/skills/invoice/src/commands/config.ts +0 -132
  344. package/skills/invoice/src/commands/generate.ts +0 -177
  345. package/skills/invoice/src/commands/invoices.ts +0 -218
  346. package/skills/invoice/src/index.ts +0 -3
  347. package/skills/invoice/src/lib/api.ts +0 -124
  348. package/skills/invoice/src/lib/storage.ts +0 -171
  349. package/skills/invoice/src/types/index.ts +0 -86
  350. package/skills/invoice/src/utils/logger.ts +0 -33
  351. package/skills/invoice/src/utils/paths.ts +0 -25
  352. package/skills/invoice/tsconfig.json +0 -23
  353. package/skills/invoice-reconciliation/SKILL.md +0 -98
  354. package/skills/invoice-reconciliation/package.json +0 -36
  355. package/skills/invoice-reconciliation/src/index.ts +0 -743
  356. package/skills/invoice-reconciliation/tsconfig.json +0 -17
  357. package/skills/landing-page-pack/SKILL.md +0 -55
  358. package/skills/landing-page-pack/package.json +0 -10
  359. package/skills/latex-table-generator/CLAUDE.md +0 -19
  360. package/skills/latex-table-generator/package.json +0 -29
  361. package/skills/latex-table-generator/src/index.ts +0 -113
  362. package/skills/latex-table-generator/tsconfig.json +0 -10
  363. package/skills/logo-design/SKILL.md +0 -94
  364. package/skills/logo-design/package.json +0 -35
  365. package/skills/logo-design/src/cli.ts +0 -132
  366. package/skills/logo-design/src/constants.ts +0 -5
  367. package/skills/logo-design/src/docs.ts +0 -102
  368. package/skills/logo-design/src/geometry.ts +0 -324
  369. package/skills/logo-design/src/index.ts +0 -212
  370. package/skills/logo-design/src/palette.ts +0 -258
  371. package/skills/logo-design/src/types.ts +0 -50
  372. package/skills/logo-design/tsconfig.json +0 -17
  373. package/skills/lorem-generator/CLAUDE.md +0 -19
  374. package/skills/lorem-generator/package.json +0 -29
  375. package/skills/lorem-generator/src/index.ts +0 -59
  376. package/skills/lorem-generator/tsconfig.json +0 -10
  377. package/skills/managemcp/CLAUDE.md +0 -14
  378. package/skills/managemcp/README.md +0 -24
  379. package/skills/managemcp/package.json +0 -16
  380. package/skills/managemcp/src/index.ts +0 -3
  381. package/skills/managemcp/tsconfig.json +0 -27
  382. package/skills/markdown-validator/CLAUDE.md +0 -19
  383. package/skills/markdown-validator/package.json +0 -29
  384. package/skills/markdown-validator/src/index.ts +0 -92
  385. package/skills/markdown-validator/tsconfig.json +0 -10
  386. package/skills/market-research-report/SKILL.md +0 -51
  387. package/skills/market-research-report/package.json +0 -10
  388. package/skills/meeting-pack/SKILL.md +0 -52
  389. package/skills/meeting-pack/package.json +0 -10
  390. package/skills/merge-pdfs/CLAUDE.md +0 -19
  391. package/skills/merge-pdfs/package.json +0 -31
  392. package/skills/merge-pdfs/src/index.ts +0 -427
  393. package/skills/merge-pdfs/tsconfig.json +0 -10
  394. package/skills/migration-plan-pack/SKILL.md +0 -56
  395. package/skills/migration-plan-pack/package.json +0 -10
  396. package/skills/monitor/SKILL.md +0 -69
  397. package/skills/monitor/package.json +0 -33
  398. package/skills/monitor/src/index.ts +0 -34
  399. package/skills/monitor/tsconfig.json +0 -17
  400. package/skills/one-page-website/SKILL.md +0 -128
  401. package/skills/one-page-website/package.json +0 -34
  402. package/skills/one-page-website/src/design.ts +0 -336
  403. package/skills/one-page-website/src/docs.ts +0 -159
  404. package/skills/one-page-website/src/index.ts +0 -357
  405. package/skills/one-page-website/src/page.ts +0 -340
  406. package/skills/one-page-website/src/styles.ts +0 -508
  407. package/skills/one-page-website/src/types.ts +0 -78
  408. package/skills/one-page-website/tsconfig.json +0 -17
  409. package/skills/pdf-generate/CLAUDE.md +0 -19
  410. package/skills/pdf-generate/SKILL.md +0 -86
  411. package/skills/pdf-generate/package.json +0 -21
  412. package/skills/pdf-generate/src/cli.ts +0 -162
  413. package/skills/pdf-generate/src/html.ts +0 -84
  414. package/skills/pdf-generate/src/index.ts +0 -62
  415. package/skills/pdf-generate/src/markdown.ts +0 -27
  416. package/skills/pdf-generate/src/pdf-writer.ts +0 -78
  417. package/skills/pdf-generate/src/runtime.ts +0 -34
  418. package/skills/pdf-generate/src/security.ts +0 -37
  419. package/skills/pdf-generate/src/templates.ts +0 -311
  420. package/skills/pdf-generate/src/types.ts +0 -28
  421. package/skills/pdf-generate/tsconfig.json +0 -16
  422. package/skills/pdf-to-dataset/SKILL.md +0 -88
  423. package/skills/pdf-to-dataset/package.json +0 -37
  424. package/skills/pdf-to-dataset/src/index.ts +0 -790
  425. package/skills/pdf-to-dataset/tsconfig.json +0 -17
  426. package/skills/pdf-to-markdown/SKILL.md +0 -81
  427. package/skills/pdf-to-markdown/package.json +0 -35
  428. package/skills/pdf-to-markdown/src/index.ts +0 -694
  429. package/skills/pdf-to-markdown/tsconfig.json +0 -17
  430. package/skills/performance-audit-report/SKILL.md +0 -49
  431. package/skills/performance-audit-report/package.json +0 -10
  432. package/skills/pitch-deck/SKILL.md +0 -51
  433. package/skills/pitch-deck/package.json +0 -10
  434. package/skills/product-mockup/SKILL.md +0 -107
  435. package/skills/product-mockup/package.json +0 -32
  436. package/skills/product-mockup/src/cli.ts +0 -150
  437. package/skills/product-mockup/src/design.ts +0 -151
  438. package/skills/product-mockup/src/docs.ts +0 -134
  439. package/skills/product-mockup/src/index.ts +0 -182
  440. package/skills/product-mockup/src/render.ts +0 -407
  441. package/skills/product-mockup/src/types.ts +0 -66
  442. package/skills/product-mockup/tsconfig.json +0 -17
  443. package/skills/proposal-pack/SKILL.md +0 -53
  444. package/skills/proposal-pack/package.json +0 -10
  445. package/skills/read-csv/SKILL.md +0 -62
  446. package/skills/read-csv/package.json +0 -37
  447. package/skills/read-csv/src/index.ts +0 -356
  448. package/skills/read-csv/tsconfig.json +0 -17
  449. package/skills/read-excel/SKILL.md +0 -64
  450. package/skills/read-excel/package.json +0 -36
  451. package/skills/read-excel/src/index.ts +0 -266
  452. package/skills/read-excel/tsconfig.json +0 -17
  453. package/skills/regex-tester/CLAUDE.md +0 -19
  454. package/skills/regex-tester/package.json +0 -27
  455. package/skills/regex-tester/src/index.ts +0 -183
  456. package/skills/regex-tester/tsconfig.json +0 -10
  457. package/skills/repo-onboarding-report/SKILL.md +0 -52
  458. package/skills/repo-onboarding-report/package.json +0 -10
  459. package/skills/scancommitpr/SKILL.md +0 -178
  460. package/skills/scancommitpr/package.json +0 -34
  461. package/skills/scancommitpr/src/index.ts +0 -44
  462. package/skills/scancommitpr/tsconfig.json +0 -13
  463. package/skills/scancommitpush/SKILL.md +0 -174
  464. package/skills/scancommitpush/package.json +0 -32
  465. package/skills/scancommitpush/src/index.ts +0 -44
  466. package/skills/scancommitpush/tsconfig.json +0 -13
  467. package/skills/scientific-figure-check/CLAUDE.md +0 -19
  468. package/skills/scientific-figure-check/package.json +0 -29
  469. package/skills/scientific-figure-check/src/index.ts +0 -83
  470. package/skills/scientific-figure-check/tsconfig.json +0 -10
  471. package/skills/security-audit/CLAUDE.md +0 -19
  472. package/skills/security-audit/package.json +0 -27
  473. package/skills/security-audit/src/index.ts +0 -145
  474. package/skills/security-audit/tsconfig.json +0 -10
  475. package/skills/security-audit-report/SKILL.md +0 -52
  476. package/skills/security-audit-report/package.json +0 -10
  477. package/skills/seo-content-pack/SKILL.md +0 -54
  478. package/skills/seo-content-pack/package.json +0 -10
  479. package/skills/siteanalyze/SKILL.md +0 -25
  480. package/skills/siteanalyze/package.json +0 -27
  481. package/skills/siteanalyze/src/index.ts +0 -592
  482. package/skills/slide-deck-generator/SKILL.md +0 -93
  483. package/skills/slide-deck-generator/package.json +0 -38
  484. package/skills/slide-deck-generator/src/cli.ts +0 -133
  485. package/skills/slide-deck-generator/src/index.ts +0 -148
  486. package/skills/slide-deck-generator/src/model.ts +0 -307
  487. package/skills/slide-deck-generator/src/pptx.ts +0 -143
  488. package/skills/slide-deck-generator/src/render.ts +0 -248
  489. package/skills/slide-deck-generator/src/types.ts +0 -114
  490. package/skills/slide-deck-generator/src/utils.ts +0 -53
  491. package/skills/slide-deck-generator/tsconfig.json +0 -17
  492. package/skills/social-content-calendar/SKILL.md +0 -54
  493. package/skills/social-content-calendar/package.json +0 -10
  494. package/skills/split-pdf/CLAUDE.md +0 -19
  495. package/skills/split-pdf/package.json +0 -30
  496. package/skills/split-pdf/src/index.ts +0 -301
  497. package/skills/split-pdf/tsconfig.json +0 -10
  498. package/skills/statistical-test-selector/CLAUDE.md +0 -19
  499. package/skills/statistical-test-selector/package.json +0 -27
  500. package/skills/statistical-test-selector/src/index.ts +0 -75
  501. package/skills/statistical-test-selector/tsconfig.json +0 -10
  502. package/skills/test-suite-generator/SKILL.md +0 -51
  503. package/skills/test-suite-generator/package.json +0 -10
  504. package/skills/tmux-session/SKILL.md +0 -109
  505. package/skills/tmux-session/package.json +0 -33
  506. package/skills/tmux-session/src/index.ts +0 -34
  507. package/skills/tmux-session/tsconfig.json +0 -17
  508. package/skills/todos-plan/SKILL.md +0 -363
  509. package/skills/todos-plan/agents/openai.yaml +0 -4
  510. package/skills/todos-plan/package.json +0 -9
  511. package/skills/todos-plan/src/index.ts +0 -68
  512. package/skills/tsconfig.base.json +0 -12
  513. package/skills/validate-config/CLAUDE.md +0 -19
  514. package/skills/validate-config/package.json +0 -29
  515. package/skills/validate-config/src/index.ts +0 -56
  516. package/skills/validate-config/tsconfig.json +0 -10
  517. package/skills/video-downloader/CLAUDE.md +0 -19
  518. package/skills/video-downloader/package.json +0 -29
  519. package/skills/video-downloader/src/index.ts +0 -561
  520. package/skills/video-downloader/tsconfig.json +0 -10
  521. package/skills/video-highlight-pack/SKILL.md +0 -54
  522. package/skills/video-highlight-pack/package.json +0 -10
  523. package/skills/watermark/CLAUDE.md +0 -19
  524. package/skills/watermark/package.json +0 -32
  525. package/skills/watermark/src/index.ts +0 -587
  526. package/skills/watermark/tsconfig.json +0 -10
@@ -1,668 +0,0 @@
1
- #!/usr/bin/env bun
2
-
3
- import { mkdir, writeFile } from "fs/promises";
4
- import { basename, join, resolve, relative } from "path";
5
-
6
- import { loadHtmlParser, normalizeUrl, parseArgs } from "./cli.js";
7
- import {
8
- MAX_ASSET_BYTES,
9
- MAX_PALETTE_ENTRIES,
10
- MAX_STYLESHEET_BYTES,
11
- MAX_STYLESHEETS,
12
- USER_AGENT,
13
- VERSION,
14
- } from "./constants.js";
15
- import {
16
- extensionFor,
17
- extractColorsFromCss,
18
- extractFontsFromCss,
19
- fetchPage,
20
- fetchWithTimeout,
21
- looksLikeLogo,
22
- safeResolve,
23
- sanitizeFilename,
24
- toHex,
25
- } from "./extract.js";
26
- import type {
27
- AssetCandidate,
28
- ColorHit,
29
- ColorKind,
30
- DownloadedAsset,
31
- FontHit,
32
- } from "./types.js";
33
-
34
- interface WrittenFile {
35
- path: string;
36
- type: string;
37
- bytes: number;
38
- }
39
-
40
- async function main(): Promise<void> {
41
- const options = parseArgs(process.argv.slice(2));
42
- const target = normalizeUrl(options.url!);
43
- const outDir = resolve(options.output);
44
- const parse = await loadHtmlParser();
45
-
46
- const { html, finalUrl, contentType } = await fetchPage(target.toString(), options.timeout);
47
- const root = parse(html);
48
- const base = safeResolve(root.querySelector("base")?.getAttribute("href"), finalUrl) ?? finalUrl;
49
-
50
- /* ---- metadata ---- */
51
-
52
- const metaOf = (selector: string): string | undefined =>
53
- root.querySelector(selector)?.getAttribute("content")?.trim();
54
-
55
- const pageTitle = root.querySelector("title")?.text?.trim();
56
- const siteName = metaOf('meta[property="og:site_name"]');
57
- const ogTitle = metaOf('meta[property="og:title"]');
58
- const description = metaOf('meta[name="description"]') ?? metaOf('meta[property="og:description"]');
59
-
60
- const brandName =
61
- siteName ??
62
- (ogTitle ? ogTitle.split(/[|–—-]/)[0].trim() : undefined) ??
63
- (pageTitle ? pageTitle.split(/[|–—-]/)[0].trim() : undefined) ??
64
- new URL(finalUrl).hostname.replace(/^www\./, "");
65
-
66
- /* ---- colors ---- */
67
-
68
- const colors: ColorHit[] = [];
69
- for (const node of root.querySelectorAll('meta[name="theme-color"]')) {
70
- const value = node.getAttribute("content")?.trim();
71
- const hex = value ? toHex(value) : null;
72
- if (hex) {
73
- const media = node.getAttribute("media");
74
- colors.push({
75
- hex,
76
- raw: value!,
77
- name: "theme-color",
78
- kind: "meta",
79
- foundIn: media ? `<meta name="theme-color" media="${media}">` : '<meta name="theme-color">',
80
- });
81
- }
82
- }
83
- for (const node of root.querySelectorAll('meta[name="msapplication-TileColor"]')) {
84
- const value = node.getAttribute("content")?.trim();
85
- const hex = value ? toHex(value) : null;
86
- if (hex) colors.push({ hex, raw: value!, name: "msapplication-TileColor", kind: "meta", foundIn: "<meta>" });
87
- }
88
-
89
- const fonts: FontHit[] = [];
90
-
91
- const inlineStyles = root.querySelectorAll("style");
92
- inlineStyles.forEach((node, index) => {
93
- const css = node.rawText ?? node.text ?? "";
94
- colors.push(...extractColorsFromCss(css, `inline <style> #${index + 1}`));
95
- fonts.push(...extractFontsFromCss(css, `inline <style> #${index + 1}`));
96
- });
97
-
98
- for (const node of root.querySelectorAll("[style]")) {
99
- const css = node.getAttribute("style");
100
- if (!css) continue;
101
- const where = `inline style attribute on <${node.tagName?.toLowerCase() ?? "element"}>`;
102
- fonts.push(...extractFontsFromCss(css, where));
103
- colors.push(...extractColorsFromCss(css, where));
104
- }
105
-
106
- /* ---- linked stylesheets ---- */
107
-
108
- const stylesheetUrls: string[] = [];
109
- for (const node of root.querySelectorAll('link[rel~="stylesheet"], link[rel="preload"][as="style"]')) {
110
- const href = safeResolve(node.getAttribute("href"), base);
111
- if (href && !stylesheetUrls.includes(href)) stylesheetUrls.push(href);
112
- }
113
-
114
- const stylesheetResults: Array<{ url: string; status: string; bytes?: number }> = [];
115
- for (const url of stylesheetUrls.slice(0, MAX_STYLESHEETS)) {
116
- try {
117
- const response = await fetchWithTimeout(url, options.timeout, "text/css,*/*;q=0.1");
118
- if (!response.ok) {
119
- stylesheetResults.push({ url, status: `HTTP ${response.status}` });
120
- continue;
121
- }
122
- const css = (await response.text()).slice(0, MAX_STYLESHEET_BYTES);
123
- colors.push(...extractColorsFromCss(css, url));
124
- fonts.push(...extractFontsFromCss(css, url));
125
- stylesheetResults.push({ url, status: "ok", bytes: Buffer.byteLength(css, "utf8") });
126
- } catch (error) {
127
- stylesheetResults.push({ url, status: error instanceof Error ? error.message : String(error) });
128
- }
129
- }
130
- for (const url of stylesheetUrls.slice(MAX_STYLESHEETS)) {
131
- stylesheetResults.push({ url, status: `skipped (limit ${MAX_STYLESHEETS})` });
132
- }
133
-
134
- /* ---- asset candidates ---- */
135
-
136
- const candidates: AssetCandidate[] = [];
137
- const seenUrls = new Set<string>();
138
-
139
- const addCandidate = (role: string, href: string | undefined, attributes: Record<string, string> = {}) => {
140
- const url = safeResolve(href, base);
141
- if (!url || seenUrls.has(url)) return;
142
- seenUrls.add(url);
143
- candidates.push({ role, sourceUrl: url, attributes });
144
- };
145
-
146
- for (const node of root.querySelectorAll("link[rel]")) {
147
- const rel = (node.getAttribute("rel") ?? "").toLowerCase();
148
- const href = node.getAttribute("href");
149
- const attributes: Record<string, string> = {};
150
- for (const key of ["sizes", "type", "color", "media"]) {
151
- const value = node.getAttribute(key);
152
- if (value) attributes[key] = value;
153
- }
154
- if (/\bapple-touch-icon\b/.test(rel)) addCandidate("apple-touch-icon", href, attributes);
155
- else if (/\bmask-icon\b/.test(rel)) addCandidate("mask-icon", href, attributes);
156
- else if (/\bicon\b/.test(rel)) addCandidate("icon", href, attributes);
157
- else if (/\bmanifest\b/.test(rel)) addCandidate("manifest", href, attributes);
158
- }
159
-
160
- // Root favicon fallback when the page declares none.
161
- if (!candidates.some((candidate) => candidate.role === "icon" || candidate.role === "apple-touch-icon")) {
162
- addCandidate("icon", new URL("/favicon.ico", base).toString(), { note: "conventional fallback" });
163
- }
164
-
165
- for (const [selector, role] of [
166
- ['meta[property="og:image"]', "og:image"],
167
- ['meta[property="og:image:secure_url"]', "og:image"],
168
- ['meta[name="twitter:image"]', "twitter:image"],
169
- ['meta[name="twitter:image:src"]', "twitter:image"],
170
- ] as const) {
171
- for (const node of root.querySelectorAll(selector)) {
172
- addCandidate(role, node.getAttribute("content"), {});
173
- }
174
- }
175
-
176
- for (const node of root.querySelectorAll("img")) {
177
- if (!looksLikeLogo(node)) continue;
178
- const src = node.getAttribute("src") ?? node.getAttribute("data-src");
179
- addCandidate("logo-img", src, {
180
- alt: node.getAttribute("alt") ?? "",
181
- class: node.getAttribute("class") ?? "",
182
- });
183
- }
184
-
185
- /* ---- web app manifest ---- */
186
-
187
- let webManifest: Record<string, unknown> | null = null;
188
- const manifestCandidate = candidates.find((candidate) => candidate.role === "manifest");
189
- if (manifestCandidate) {
190
- try {
191
- const response = await fetchWithTimeout(manifestCandidate.sourceUrl, options.timeout, "application/manifest+json,application/json");
192
- if (response.ok) {
193
- webManifest = (await response.json()) as Record<string, unknown>;
194
- for (const key of ["theme_color", "background_color"]) {
195
- const value = webManifest[key];
196
- const hex = typeof value === "string" ? toHex(value) : null;
197
- if (hex) {
198
- colors.push({ hex, raw: String(value), name: key, kind: "manifest", foundIn: manifestCandidate.sourceUrl });
199
- }
200
- }
201
- const icons = webManifest.icons;
202
- if (Array.isArray(icons)) {
203
- for (const icon of icons as Array<Record<string, unknown>>) {
204
- if (typeof icon.src === "string") {
205
- addCandidate("manifest-icon", new URL(icon.src, manifestCandidate.sourceUrl).toString(), {
206
- sizes: typeof icon.sizes === "string" ? icon.sizes : "",
207
- type: typeof icon.type === "string" ? icon.type : "",
208
- });
209
- }
210
- }
211
- }
212
- }
213
- } catch {
214
- // A missing or malformed manifest is not fatal; it is reported in sources.json.
215
- }
216
- }
217
-
218
- /* ---- inline svg logos ---- */
219
-
220
- const inlineSvgs: Array<{ file: string; markup: string; foundIn: string }> = [];
221
- const svgNodes = root.querySelectorAll("header svg, nav svg, a svg, [class*=logo] svg, svg[class*=logo]");
222
- let svgIndex = 0;
223
- for (const node of svgNodes) {
224
- const markup = node.toString();
225
- if (markup.length > 200000) continue;
226
- if (inlineSvgs.some((entry) => entry.markup === markup)) continue;
227
- svgIndex += 1;
228
- if (svgIndex > 3) break;
229
- inlineSvgs.push({
230
- file: `assets/inline-logo-${String(svgIndex).padStart(2, "0")}.svg`,
231
- markup: markup.startsWith("<?xml") ? markup : `<?xml version="1.0" encoding="UTF-8"?>\n${markup}\n`,
232
- foundIn: finalUrl,
233
- });
234
- }
235
-
236
- /* ---- download ---- */
237
-
238
- const files: WrittenFile[] = [];
239
- const downloaded: DownloadedAsset[] = [];
240
- const usedNames = new Set<string>();
241
-
242
- const downloadable = candidates.filter((candidate) => candidate.role !== "manifest");
243
- const limit = options.download ? Math.min(options.maxAssets, downloadable.length) : 0;
244
-
245
- for (let i = 0; i < downloadable.length; i += 1) {
246
- const candidate = downloadable[i];
247
- if (i >= limit) {
248
- downloaded.push({
249
- role: candidate.role,
250
- file: null,
251
- sourceUrl: candidate.sourceUrl,
252
- contentType: null,
253
- bytes: null,
254
- status: "skipped",
255
- note: options.download ? `beyond --max-assets ${options.maxAssets}` : "--no-download",
256
- attributes: candidate.attributes,
257
- });
258
- continue;
259
- }
260
-
261
- try {
262
- const response = await fetchWithTimeout(candidate.sourceUrl, options.timeout, "image/*,*/*;q=0.5");
263
- if (!response.ok) {
264
- downloaded.push({
265
- role: candidate.role,
266
- file: null,
267
- sourceUrl: candidate.sourceUrl,
268
- contentType: response.headers.get("content-type"),
269
- bytes: null,
270
- status: "failed",
271
- note: `HTTP ${response.status}`,
272
- attributes: candidate.attributes,
273
- });
274
- continue;
275
- }
276
-
277
- const type = response.headers.get("content-type");
278
- const buffer = Buffer.from(await response.arrayBuffer());
279
- if (buffer.byteLength > MAX_ASSET_BYTES) {
280
- downloaded.push({
281
- role: candidate.role,
282
- file: null,
283
- sourceUrl: candidate.sourceUrl,
284
- contentType: type,
285
- bytes: buffer.byteLength,
286
- status: "skipped",
287
- note: `larger than ${MAX_ASSET_BYTES} bytes`,
288
- attributes: candidate.attributes,
289
- });
290
- continue;
291
- }
292
-
293
- const ext = extensionFor(type, candidate.sourceUrl);
294
- const stem = sanitizeFilename(basename(new URL(candidate.sourceUrl).pathname, ext) || candidate.role, candidate.role);
295
- let name = `${candidate.role}-${stem}${ext}`.replace(/-+/g, "-");
296
- let suffix = 2;
297
- while (usedNames.has(name)) {
298
- name = `${candidate.role}-${stem}-${suffix}${ext}`.replace(/-+/g, "-");
299
- suffix += 1;
300
- }
301
- usedNames.add(name);
302
-
303
- const relPath = `assets/${name}`;
304
- await mkdir(join(outDir, "assets"), { recursive: true });
305
- await writeFile(join(outDir, relPath), buffer);
306
- files.push({ path: relPath, type: type ?? "application/octet-stream", bytes: buffer.byteLength });
307
- downloaded.push({
308
- role: candidate.role,
309
- file: relPath,
310
- sourceUrl: candidate.sourceUrl,
311
- contentType: type,
312
- bytes: buffer.byteLength,
313
- status: "downloaded",
314
- attributes: candidate.attributes,
315
- });
316
- } catch (error) {
317
- downloaded.push({
318
- role: candidate.role,
319
- file: null,
320
- sourceUrl: candidate.sourceUrl,
321
- contentType: null,
322
- bytes: null,
323
- status: "failed",
324
- note: error instanceof Error ? error.message : String(error),
325
- attributes: candidate.attributes,
326
- });
327
- }
328
- }
329
-
330
- for (const svg of inlineSvgs) {
331
- if (!options.download) {
332
- downloaded.push({
333
- role: "inline-svg-logo",
334
- file: null,
335
- sourceUrl: svg.foundIn,
336
- contentType: "image/svg+xml",
337
- bytes: null,
338
- status: "skipped",
339
- note: "--no-download",
340
- attributes: {},
341
- });
342
- continue;
343
- }
344
- await mkdir(join(outDir, "assets"), { recursive: true });
345
- await writeFile(join(outDir, svg.file), svg.markup, "utf8");
346
- const bytes = Buffer.byteLength(svg.markup, "utf8");
347
- files.push({ path: svg.file, type: "image/svg+xml", bytes });
348
- downloaded.push({
349
- role: "inline-svg-logo",
350
- file: svg.file,
351
- sourceUrl: svg.foundIn,
352
- contentType: "image/svg+xml",
353
- bytes,
354
- status: "downloaded",
355
- attributes: { note: "extracted from the page markup, not a separate request" },
356
- });
357
- }
358
-
359
- /* ---- dedupe colors and fonts ---- */
360
-
361
- const KIND_RANK: Record<ColorKind, number> = {
362
- meta: 0,
363
- manifest: 1,
364
- "custom-property": 2,
365
- declaration: 3,
366
- };
367
-
368
- // Utility-framework internals (Tailwind's --tw-*, for example) are real colors
369
- // but they are plumbing, not brand tokens, so they rank below hand-authored ones.
370
- const rankOf = (hit: { kind: ColorKind; name: string }): number =>
371
- KIND_RANK[hit.kind] + (/^--(tw|bs-internal|un)-/.test(hit.name) ? 1.5 : 0);
372
-
373
- const paletteMap = new Map<
374
- string,
375
- ColorHit & { occurrences: number; sources: string[]; properties: string[]; kinds: ColorKind[] }
376
- >();
377
- for (const hit of colors) {
378
- const existing = paletteMap.get(hit.hex);
379
- if (existing) {
380
- existing.occurrences += 1;
381
- if (!existing.sources.includes(hit.foundIn)) existing.sources.push(hit.foundIn);
382
- if (!existing.properties.includes(hit.name)) existing.properties.push(hit.name);
383
- if (!existing.kinds.includes(hit.kind)) existing.kinds.push(hit.kind);
384
- if (rankOf(hit) < rankOf(existing)) {
385
- existing.kind = hit.kind;
386
- existing.name = hit.name;
387
- existing.raw = hit.raw;
388
- }
389
- continue;
390
- }
391
- paletteMap.set(hit.hex, {
392
- ...hit,
393
- occurrences: 1,
394
- sources: [hit.foundIn],
395
- properties: [hit.name],
396
- kinds: [hit.kind],
397
- });
398
- }
399
- const palette = [...paletteMap.values()]
400
- .sort((a, b) => rankOf(a) - rankOf(b) || b.occurrences - a.occurrences || a.hex.localeCompare(b.hex))
401
- .slice(0, MAX_PALETTE_ENTRIES);
402
-
403
- const fontMap = new Map<string, FontHit & { occurrences: number; sources: string[] }>();
404
- for (const hit of fonts) {
405
- const key = hit.families.join("|").toLowerCase();
406
- const existing = fontMap.get(key);
407
- if (existing) {
408
- existing.occurrences += 1;
409
- if (!existing.sources.includes(hit.foundIn)) existing.sources.push(hit.foundIn);
410
- continue;
411
- }
412
- fontMap.set(key, { ...hit, occurrences: 1, sources: [hit.foundIn] });
413
- }
414
- const typography = [...fontMap.values()].sort((a, b) => b.occurrences - a.occurrences);
415
-
416
- /* ---- write outputs ---- */
417
-
418
- const writeText = async (relPath: string, contents: string, type: string) => {
419
- const targetPath = join(outDir, relPath);
420
- await mkdir(join(targetPath, ".."), { recursive: true });
421
- await writeFile(targetPath, contents, "utf8");
422
- files.push({ path: relPath, type, bytes: Buffer.byteLength(contents, "utf8") });
423
- };
424
-
425
- const brandProfile = {
426
- requestedUrl: target.toString(),
427
- finalUrl,
428
- fetchedAt: new Date().toISOString(),
429
- contentType,
430
- brandName,
431
- pageTitle: pageTitle ?? null,
432
- siteName: siteName ?? null,
433
- description: description ?? null,
434
- webManifest: webManifest
435
- ? {
436
- name: webManifest.name ?? null,
437
- shortName: webManifest.short_name ?? null,
438
- themeColor: webManifest.theme_color ?? null,
439
- backgroundColor: webManifest.background_color ?? null,
440
- iconCount: Array.isArray(webManifest.icons) ? webManifest.icons.length : 0,
441
- }
442
- : null,
443
- assets: downloaded,
444
- palette,
445
- typography,
446
- stylesheets: stylesheetResults,
447
- counts: {
448
- assetsDiscovered: candidates.length + inlineSvgs.length,
449
- assetsDownloaded: downloaded.filter((asset) => asset.status === "downloaded").length,
450
- colors: palette.length,
451
- fontStacks: typography.length,
452
- stylesheetsInspected: stylesheetResults.filter((entry) => entry.status === "ok").length,
453
- },
454
- };
455
-
456
- await writeText("brand-profile.json", `${JSON.stringify(brandProfile, null, 2)}\n`, "application/json");
457
-
458
- await writeText(
459
- "palette.json",
460
- `${JSON.stringify(
461
- {
462
- source: finalUrl,
463
- colors: palette.map((entry) => ({
464
- hex: entry.hex,
465
- declaredAs: entry.raw,
466
- property: entry.name,
467
- properties: entry.properties,
468
- kind: entry.kind,
469
- kinds: entry.kinds,
470
- occurrences: entry.occurrences,
471
- foundIn: entry.sources,
472
- })),
473
- },
474
- null,
475
- 2,
476
- )}\n`,
477
- "application/json",
478
- );
479
-
480
- await writeText(
481
- "sources.json",
482
- `${JSON.stringify(
483
- {
484
- page: finalUrl,
485
- fetchedAt: brandProfile.fetchedAt,
486
- userAgent: USER_AGENT,
487
- assets: downloaded.map((asset) => ({
488
- file: asset.file,
489
- role: asset.role,
490
- sourceUrl: asset.sourceUrl,
491
- status: asset.status,
492
- note: asset.note ?? null,
493
- contentType: asset.contentType,
494
- bytes: asset.bytes,
495
- })),
496
- stylesheets: stylesheetResults,
497
- },
498
- null,
499
- 2,
500
- )}\n`,
501
- "application/json",
502
- );
503
-
504
- const profileMd = `# Brand profile — ${brandName}
505
-
506
- | Field | Value |
507
- |-------|-------|
508
- | Requested URL | ${target.toString()} |
509
- | Final URL | ${finalUrl} |
510
- | Fetched at | ${brandProfile.fetchedAt} |
511
- | Page title | ${pageTitle ?? "_not found_"} |
512
- | og:site_name | ${siteName ?? "_not found_"} |
513
- | Description | ${description ?? "_not found_"} |
514
- | Assets discovered | ${brandProfile.counts.assetsDiscovered} |
515
- | Assets downloaded | ${brandProfile.counts.assetsDownloaded} |
516
- | Colors found | ${palette.length} |
517
- | Font stacks found | ${typography.length} |
518
- | Stylesheets inspected | ${brandProfile.counts.stylesheetsInspected} of ${stylesheetUrls.length} linked |
519
-
520
- ## Assets
521
-
522
- ${
523
- downloaded.length === 0
524
- ? "_No asset candidates were found on this page._"
525
- : `| Role | File | Status | Source |
526
- |------|------|--------|--------|
527
- ${downloaded
528
- .map(
529
- (asset) =>
530
- `| ${asset.role} | ${asset.file ? `\`${asset.file}\`` : "—"} | ${asset.status}${
531
- asset.note ? ` (${asset.note})` : ""
532
- } | ${asset.sourceUrl} |`,
533
- )
534
- .join("\n")}`
535
- }
536
-
537
- ## Palette
538
-
539
- ${
540
- palette.length === 0
541
- ? "_No colors were declared in a way this skill could read. The site may set colors from a JS bundle or from a stylesheet beyond the fetch limit._"
542
- : `Colors are ranked by how authoritative the source is: \`<meta>\` and web app
543
- manifest first, then CSS custom properties, then ordinary declarations.
544
-
545
- | Hex | Declared as | Property | Kind | Seen | First source |
546
- |-----|-------------|----------|------|------|--------------|
547
- ${palette
548
- .map(
549
- (entry) =>
550
- `| \`${entry.hex}\` | \`${entry.raw}\` | \`${entry.name}\` | ${entry.kind} | ${entry.occurrences}x | ${entry.sources[0]} |`,
551
- )
552
- .join("\n")}`
553
- }
554
-
555
- ## Typography
556
-
557
- ${
558
- typography.length === 0
559
- ? "_No font-family declarations were found in the HTML or the stylesheets that were fetched._"
560
- : typography
561
- .slice(0, 12)
562
- .map((entry) => `- **${entry.families[0]}** — \`${entry.stack}\` (${entry.property}, ${entry.occurrences}x)`)
563
- .join("\n")
564
- }
565
-
566
- ${webManifest ? `## Web app manifest\n\n- Name: ${String(webManifest.name ?? "—")}\n- Short name: ${String(webManifest.short_name ?? "—")}\n- Theme color: ${String(webManifest.theme_color ?? "—")}\n- Background color: ${String(webManifest.background_color ?? "—")}\n- Icons declared: ${Array.isArray(webManifest.icons) ? webManifest.icons.length : 0}\n` : ""}
567
- ## Provenance and reuse
568
-
569
- Every file in \`assets/\` was downloaded from the URL recorded against it in
570
- \`sources.json\`. These are someone else's trademarks. Confirm you have the right
571
- to use them before you ship anything, and check the site's brand or press page
572
- for official guidelines and higher-resolution originals.
573
- `;
574
-
575
- await writeText("brand-profile.md", profileMd, "text/markdown");
576
-
577
- const typographyMd = `# Typography — ${brandName}
578
-
579
- Source: ${finalUrl}
580
-
581
- ${
582
- typography.length === 0
583
- ? `No \`font-family\` declarations were readable.
584
-
585
- This usually means one of:
586
-
587
- - fonts are set inside a JavaScript bundle rather than CSS,
588
- - the stylesheet that declares them is beyond the ${MAX_STYLESHEETS}-stylesheet fetch limit,
589
- - or the page uses only system font keywords that this skill filters out.
590
-
591
- Open the site's devtools > Computed > font-family on a heading and a paragraph to confirm by hand.`
592
- : typography
593
- .map(
594
- (entry, index) => `## ${index + 1}. ${entry.families[0]}
595
-
596
- \`\`\`css
597
- ${entry.property}: ${entry.stack};
598
- \`\`\`
599
-
600
- - Fallback chain: ${entry.families.join(" → ")}
601
- - Declared ${entry.occurrences} time(s)
602
- - Found in: ${entry.sources.slice(0, 4).join(", ")}${entry.sources.length > 4 ? `, +${entry.sources.length - 4} more` : ""}
603
- `,
604
- )
605
- .join("\n")
606
- }
607
-
608
- ## Matching the type without the font files
609
-
610
- This skill does not download webfont binaries — licensing almost never permits
611
- redistributing them. To reproduce the look:
612
-
613
- 1. Take the first family in each stack above and look it up on the foundry's or
614
- Google Fonts' site to confirm the license.
615
- 2. Keep the whole fallback chain, not just the first name; that is what the site
616
- actually renders on machines missing the webfont.
617
- 3. Match weights and optical sizes from the site's own CSS before matching the
618
- family — weight mismatch reads as "wrong" faster than family mismatch.
619
- `;
620
-
621
- await writeText("typography.md", typographyMd, "text/markdown");
622
-
623
- const manifest = {
624
- skill: "brand-assets",
625
- version: VERSION,
626
- generatedAt: brandProfile.fetchedAt,
627
- input: {
628
- url: target.toString(),
629
- finalUrl,
630
- timeout: options.timeout,
631
- maxAssets: options.maxAssets,
632
- download: options.download,
633
- },
634
- brandName,
635
- counts: brandProfile.counts,
636
- outputDir: outDir,
637
- files: files.slice().sort((a, b) => a.path.localeCompare(b.path)),
638
- };
639
-
640
- const manifestPath = join(outDir, "manifest.json");
641
- await mkdir(outDir, { recursive: true });
642
- await writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`, "utf8");
643
-
644
- if (options.json) {
645
- process.stdout.write(`${JSON.stringify({ ...manifest, brandProfile }, null, 2)}\n`);
646
- return;
647
- }
648
-
649
- console.log(`brand-assets: wrote ${files.length + 1} files to ${outDir}`);
650
- console.log(` brand ${brandName}`);
651
- console.log(` page ${finalUrl}`);
652
- console.log(
653
- ` assets ${brandProfile.counts.assetsDownloaded} downloaded / ${brandProfile.counts.assetsDiscovered} discovered`,
654
- );
655
- console.log(` palette ${palette.length} color(s)${palette.length ? `: ${palette.slice(0, 6).map((c) => c.hex).join(", ")}` : ""}`);
656
- console.log(` typography ${typography.length} font stack(s)${typography.length ? `: ${typography.slice(0, 3).map((f) => f.families[0]).join(", ")}` : ""}`);
657
- console.log(` css ${brandProfile.counts.stylesheetsInspected} of ${stylesheetUrls.length} linked stylesheet(s) inspected`);
658
- for (const asset of downloaded.filter((entry) => entry.status === "failed")) {
659
- console.log(` ! failed ${asset.role} ${asset.sourceUrl} (${asset.note})`);
660
- }
661
- console.log(` manifest ${relative(process.cwd(), manifestPath) || manifestPath}`);
662
- }
663
-
664
- main().catch((error) => {
665
- const message = error instanceof Error ? error.message : String(error);
666
- process.stderr.write(`brand-assets: ${message}\n`);
667
- process.exit(1);
668
- });