@hasna/skills 0.1.61 → 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 (523) 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 -207
  95. package/skills/_common/auth.ts +0 -45
  96. package/skills/_common/http-client.ts +0 -143
  97. package/skills/_common/index.ts +0 -26
  98. package/skills/_common/install.sh +0 -7
  99. package/skills/_common/installer.ts +0 -72
  100. package/skills/_common/skill-install.ts +0 -37
  101. package/skills/_common/vision.ts +0 -374
  102. package/skills/ad-creative-pack/SKILL.md +0 -55
  103. package/skills/ad-creative-pack/package.json +0 -10
  104. package/skills/analyze-data/CLAUDE.md +0 -16
  105. package/skills/analyze-data/SKILL.md +0 -112
  106. package/skills/analyze-data/package.json +0 -23
  107. package/skills/analyze-data/src/analysis.ts +0 -401
  108. package/skills/analyze-data/src/cli.ts +0 -66
  109. package/skills/analyze-data/src/formatters.ts +0 -235
  110. package/skills/analyze-data/src/index.ts +0 -74
  111. package/skills/analyze-data/src/logger.ts +0 -36
  112. package/skills/analyze-data/src/parsers.ts +0 -57
  113. package/skills/analyze-data/src/stats.ts +0 -151
  114. package/skills/analyze-data/src/types.ts +0 -85
  115. package/skills/analyze-data/tsconfig.json +0 -19
  116. package/skills/api-docs-portal/SKILL.md +0 -84
  117. package/skills/api-docs-portal/package.json +0 -35
  118. package/skills/api-docs-portal/src/index.ts +0 -919
  119. package/skills/api-docs-portal/tsconfig.json +0 -17
  120. package/skills/api-test-suite/CLAUDE.md +0 -19
  121. package/skills/api-test-suite/package.json +0 -27
  122. package/skills/api-test-suite/src/index.ts +0 -381
  123. package/skills/api-test-suite/tsconfig.json +0 -10
  124. package/skills/audio-extract/CLAUDE.md +0 -9
  125. package/skills/audio-extract/SKILL.md +0 -73
  126. package/skills/audio-extract/package.json +0 -23
  127. package/skills/audio-extract/src/index.ts +0 -323
  128. package/skills/audio-extract/tsconfig.json +0 -11
  129. package/skills/bio-sequence-tool/CLAUDE.md +0 -19
  130. package/skills/bio-sequence-tool/package.json +0 -27
  131. package/skills/bio-sequence-tool/src/index.ts +0 -85
  132. package/skills/bio-sequence-tool/tsconfig.json +0 -10
  133. package/skills/blog-article/CLAUDE.md +0 -12
  134. package/skills/blog-article/SKILL.md +0 -55
  135. package/skills/blog-article/package.json +0 -10
  136. package/skills/blog-article/tsconfig.json +0 -10
  137. package/skills/brand-assets/SKILL.md +0 -118
  138. package/skills/brand-assets/package.json +0 -35
  139. package/skills/brand-assets/src/cli.ts +0 -155
  140. package/skills/brand-assets/src/constants.ts +0 -8
  141. package/skills/brand-assets/src/extract.ts +0 -236
  142. package/skills/brand-assets/src/index.ts +0 -668
  143. package/skills/brand-assets/src/types.ts +0 -59
  144. package/skills/brand-assets/tsconfig.json +0 -17
  145. package/skills/brand-kit/SKILL.md +0 -54
  146. package/skills/brand-kit/package.json +0 -10
  147. package/skills/businessactivity/CLAUDE.md +0 -176
  148. package/skills/businessactivity/LICENSE +0 -192
  149. package/skills/businessactivity/README.md +0 -287
  150. package/skills/businessactivity/package.json +0 -25
  151. package/skills/businessactivity/scripts/publish.ts +0 -210
  152. package/skills/businessactivity/src/commands/activity.ts +0 -211
  153. package/skills/businessactivity/src/commands/function.ts +0 -227
  154. package/skills/businessactivity/src/commands/owner.ts +0 -193
  155. package/skills/businessactivity/src/commands/profile.ts +0 -121
  156. package/skills/businessactivity/src/commands/responsibility.ts +0 -264
  157. package/skills/businessactivity/src/commands/team.ts +0 -244
  158. package/skills/businessactivity/src/commands/workflow.ts +0 -359
  159. package/skills/businessactivity/src/index.ts +0 -3
  160. package/skills/businessactivity/src/lib/config.ts +0 -167
  161. package/skills/businessactivity/src/lib/output.ts +0 -76
  162. package/skills/businessactivity/src/lib/paths.ts +0 -79
  163. package/skills/businessactivity/src/lib/storage.ts +0 -95
  164. package/skills/businessactivity/src/types/index.ts +0 -86
  165. package/skills/businessactivity/tsconfig.json +0 -29
  166. package/skills/codefix/LICENSE +0 -192
  167. package/skills/codefix/README.md +0 -232
  168. package/skills/codefix/SKILL.md +0 -94
  169. package/skills/codefix/package.json +0 -21
  170. package/skills/codefix/src/fixers/batch.ts +0 -213
  171. package/skills/codefix/src/fixers/detector.ts +0 -160
  172. package/skills/codefix/src/fixers/index.ts +0 -7
  173. package/skills/codefix/src/fixers/runner.ts +0 -522
  174. package/skills/codefix/src/index-local.ts +0 -431
  175. package/skills/codefix/src/index.ts +0 -4
  176. package/skills/codefix/src/types.ts +0 -211
  177. package/skills/codefix/tsconfig.json +0 -15
  178. package/skills/commitpush/SKILL.md +0 -57
  179. package/skills/commitpush/package.json +0 -33
  180. package/skills/commitpush/src/index.ts +0 -34
  181. package/skills/commitpush/tsconfig.json +0 -17
  182. package/skills/commitpushpr/SKILL.md +0 -55
  183. package/skills/commitpushpr/package.json +0 -33
  184. package/skills/commitpushpr/src/index.ts +0 -34
  185. package/skills/commitpushpr/tsconfig.json +0 -17
  186. package/skills/compress-video/CLAUDE.md +0 -9
  187. package/skills/compress-video/SKILL.md +0 -79
  188. package/skills/compress-video/package.json +0 -23
  189. package/skills/compress-video/src/index.ts +0 -473
  190. package/skills/compress-video/tsconfig.json +0 -11
  191. package/skills/contract-review-report/SKILL.md +0 -52
  192. package/skills/contract-review-report/package.json +0 -10
  193. package/skills/customer-feedback-report/SKILL.md +0 -52
  194. package/skills/customer-feedback-report/package.json +0 -10
  195. package/skills/dashboard-builder/CLAUDE.md +0 -19
  196. package/skills/dashboard-builder/package.json +0 -29
  197. package/skills/dashboard-builder/src/index.ts +0 -150
  198. package/skills/dashboard-builder/tsconfig.json +0 -10
  199. package/skills/data-anonymizer/CLAUDE.md +0 -19
  200. package/skills/data-anonymizer/package.json +0 -27
  201. package/skills/data-anonymizer/src/index.ts +0 -183
  202. package/skills/data-anonymizer/tsconfig.json +0 -10
  203. package/skills/database-explorer/CLAUDE.md +0 -19
  204. package/skills/database-explorer/package.json +0 -29
  205. package/skills/database-explorer/src/index.ts +0 -95
  206. package/skills/database-explorer/tsconfig.json +0 -10
  207. package/skills/diff-viewer/CLAUDE.md +0 -19
  208. package/skills/diff-viewer/package.json +0 -30
  209. package/skills/diff-viewer/src/index.ts +0 -164
  210. package/skills/diff-viewer/tsconfig.json +0 -10
  211. package/skills/doc-read/SKILL.md +0 -45
  212. package/skills/doc-read/package.json +0 -29
  213. package/skills/doc-read/src/index.ts +0 -324
  214. package/skills/doc-read/tsconfig.json +0 -8
  215. package/skills/domainpurchase/LICENSE +0 -192
  216. package/skills/domainpurchase/SKILL.md +0 -29
  217. package/skills/domainpurchase/package.json +0 -30
  218. package/skills/domainpurchase/src/index.ts +0 -3
  219. package/skills/domainpurchase/tsconfig.json +0 -21
  220. package/skills/email-sequence/SKILL.md +0 -53
  221. package/skills/email-sequence/package.json +0 -10
  222. package/skills/experiment-power-calculator/CLAUDE.md +0 -19
  223. package/skills/experiment-power-calculator/package.json +0 -29
  224. package/skills/experiment-power-calculator/src/index.ts +0 -86
  225. package/skills/experiment-power-calculator/tsconfig.json +0 -10
  226. package/skills/extract-frames/CLAUDE.md +0 -19
  227. package/skills/extract-frames/package.json +0 -27
  228. package/skills/extract-frames/src/index.ts +0 -616
  229. package/skills/extract-frames/tsconfig.json +0 -10
  230. package/skills/file-organizer/CLAUDE.md +0 -19
  231. package/skills/file-organizer/package.json +0 -27
  232. package/skills/file-organizer/src/index.ts +0 -91
  233. package/skills/file-organizer/tsconfig.json +0 -10
  234. package/skills/folder-tree/CLAUDE.md +0 -19
  235. package/skills/folder-tree/package.json +0 -29
  236. package/skills/folder-tree/src/index.ts +0 -568
  237. package/skills/folder-tree/tsconfig.json +0 -10
  238. package/skills/form-filler/CLAUDE.md +0 -19
  239. package/skills/form-filler/package.json +0 -29
  240. package/skills/form-filler/src/index.ts +0 -81
  241. package/skills/form-filler/tsconfig.json +0 -10
  242. package/skills/generate-api-client/CLAUDE.md +0 -19
  243. package/skills/generate-api-client/package.json +0 -29
  244. package/skills/generate-api-client/src/generator.ts +0 -47
  245. package/skills/generate-api-client/src/index.ts +0 -92
  246. package/skills/generate-api-client/src/logger.ts +0 -34
  247. package/skills/generate-api-client/src/python-generator.ts +0 -245
  248. package/skills/generate-api-client/src/spec-loader.ts +0 -48
  249. package/skills/generate-api-client/src/type-mappers.ts +0 -79
  250. package/skills/generate-api-client/src/types.ts +0 -76
  251. package/skills/generate-api-client/src/typescript-generator.ts +0 -247
  252. package/skills/generate-api-client/tsconfig.json +0 -10
  253. package/skills/generate-chart/CLAUDE.md +0 -19
  254. package/skills/generate-chart/package.json +0 -27
  255. package/skills/generate-chart/src/index.ts +0 -510
  256. package/skills/generate-chart/tsconfig.json +0 -10
  257. package/skills/generate-dockerfile/CLAUDE.md +0 -19
  258. package/skills/generate-dockerfile/package.json +0 -27
  259. package/skills/generate-dockerfile/src/cli.ts +0 -78
  260. package/skills/generate-dockerfile/src/dockerfile-templates.ts +0 -392
  261. package/skills/generate-dockerfile/src/index.ts +0 -81
  262. package/skills/generate-dockerfile/src/logger.ts +0 -30
  263. package/skills/generate-dockerfile/src/project-detection.ts +0 -68
  264. package/skills/generate-dockerfile/src/support-files.ts +0 -171
  265. package/skills/generate-dockerfile/src/types.ts +0 -29
  266. package/skills/generate-dockerfile/tsconfig.json +0 -10
  267. package/skills/generate-env/CLAUDE.md +0 -19
  268. package/skills/generate-env/package.json +0 -29
  269. package/skills/generate-env/src/cli.ts +0 -85
  270. package/skills/generate-env/src/detection.ts +0 -161
  271. package/skills/generate-env/src/env-data.ts +0 -66
  272. package/skills/generate-env/src/generators.ts +0 -240
  273. package/skills/generate-env/src/index.ts +0 -120
  274. package/skills/generate-env/src/runtime.ts +0 -30
  275. package/skills/generate-env/src/types.ts +0 -32
  276. package/skills/generate-env/tsconfig.json +0 -10
  277. package/skills/generate-favicon/CLAUDE.md +0 -19
  278. package/skills/generate-favicon/package.json +0 -29
  279. package/skills/generate-favicon/src/index.ts +0 -421
  280. package/skills/generate-favicon/tsconfig.json +0 -10
  281. package/skills/generate-qrcode/CLAUDE.md +0 -19
  282. package/skills/generate-qrcode/package.json +0 -30
  283. package/skills/generate-qrcode/src/index.ts +0 -584
  284. package/skills/generate-qrcode/tsconfig.json +0 -10
  285. package/skills/generate-resume/CLAUDE.md +0 -19
  286. package/skills/generate-resume/package.json +0 -27
  287. package/skills/generate-resume/src/cli.ts +0 -157
  288. package/skills/generate-resume/src/index.ts +0 -178
  289. package/skills/generate-resume/src/parsers.ts +0 -95
  290. package/skills/generate-resume/src/renderers.ts +0 -538
  291. package/skills/generate-resume/src/security.ts +0 -39
  292. package/skills/generate-resume/src/types.ts +0 -86
  293. package/skills/generate-resume/tsconfig.json +0 -10
  294. package/skills/generate-sitemap/CLAUDE.md +0 -19
  295. package/skills/generate-sitemap/package.json +0 -27
  296. package/skills/generate-sitemap/src/index.ts +0 -626
  297. package/skills/generate-sitemap/tsconfig.json +0 -10
  298. package/skills/gif-maker/CLAUDE.md +0 -19
  299. package/skills/gif-maker/package.json +0 -30
  300. package/skills/gif-maker/src/index.ts +0 -600
  301. package/skills/gif-maker/tsconfig.json +0 -10
  302. package/skills/hook/LICENSE +0 -192
  303. package/skills/hook/README.md +0 -74
  304. package/skills/hook/SKILL.md +0 -85
  305. package/skills/hook/bunfig.toml +0 -5
  306. package/skills/hook/package.json +0 -28
  307. package/skills/hook/src/commands/create.ts +0 -112
  308. package/skills/hook/src/commands/events.ts +0 -37
  309. package/skills/hook/src/commands/validate.ts +0 -117
  310. package/skills/hook/src/index.ts +0 -118
  311. package/skills/hook/src/templates/root.ts +0 -196
  312. package/skills/hook/src/templates/source.ts +0 -647
  313. package/skills/hook/tsconfig.json +0 -18
  314. package/skills/http-server/CLAUDE.md +0 -19
  315. package/skills/http-server/package.json +0 -29
  316. package/skills/http-server/src/index.ts +0 -51
  317. package/skills/http-server/tsconfig.json +0 -10
  318. package/skills/implementation/LICENSE +0 -192
  319. package/skills/implementation/README.md +0 -53
  320. package/skills/implementation/SKILL.md +0 -57
  321. package/skills/implementation/bunfig.toml +0 -5
  322. package/skills/implementation/package.json +0 -28
  323. package/skills/implementation/src/commands/create.ts +0 -187
  324. package/skills/implementation/src/index.ts +0 -62
  325. package/skills/implementation/tsconfig.json +0 -18
  326. package/skills/implementation-plan/CLAUDE.md +0 -19
  327. package/skills/implementation-plan/package.json +0 -29
  328. package/skills/implementation-plan/src/index.ts +0 -520
  329. package/skills/implementation-plan/tsconfig.json +0 -10
  330. package/skills/implementation-todo/CLAUDE.md +0 -19
  331. package/skills/implementation-todo/package.json +0 -29
  332. package/skills/implementation-todo/src/index.ts +0 -429
  333. package/skills/implementation-todo/tsconfig.json +0 -10
  334. package/skills/invoice/.env.example +0 -3
  335. package/skills/invoice/CLAUDE.md +0 -31
  336. package/skills/invoice/LICENSE +0 -192
  337. package/skills/invoice/README.md +0 -70
  338. package/skills/invoice/package.json +0 -26
  339. package/skills/invoice/src/commands/companies.ts +0 -202
  340. package/skills/invoice/src/commands/config.ts +0 -132
  341. package/skills/invoice/src/commands/generate.ts +0 -177
  342. package/skills/invoice/src/commands/invoices.ts +0 -218
  343. package/skills/invoice/src/index.ts +0 -3
  344. package/skills/invoice/src/lib/api.ts +0 -124
  345. package/skills/invoice/src/lib/storage.ts +0 -171
  346. package/skills/invoice/src/types/index.ts +0 -86
  347. package/skills/invoice/src/utils/logger.ts +0 -33
  348. package/skills/invoice/src/utils/paths.ts +0 -25
  349. package/skills/invoice/tsconfig.json +0 -23
  350. package/skills/invoice-reconciliation/SKILL.md +0 -98
  351. package/skills/invoice-reconciliation/package.json +0 -36
  352. package/skills/invoice-reconciliation/src/index.ts +0 -743
  353. package/skills/invoice-reconciliation/tsconfig.json +0 -17
  354. package/skills/landing-page-pack/SKILL.md +0 -55
  355. package/skills/landing-page-pack/package.json +0 -10
  356. package/skills/latex-table-generator/CLAUDE.md +0 -19
  357. package/skills/latex-table-generator/package.json +0 -29
  358. package/skills/latex-table-generator/src/index.ts +0 -113
  359. package/skills/latex-table-generator/tsconfig.json +0 -10
  360. package/skills/logo-design/SKILL.md +0 -94
  361. package/skills/logo-design/package.json +0 -35
  362. package/skills/logo-design/src/cli.ts +0 -132
  363. package/skills/logo-design/src/constants.ts +0 -5
  364. package/skills/logo-design/src/docs.ts +0 -102
  365. package/skills/logo-design/src/geometry.ts +0 -324
  366. package/skills/logo-design/src/index.ts +0 -212
  367. package/skills/logo-design/src/palette.ts +0 -258
  368. package/skills/logo-design/src/types.ts +0 -50
  369. package/skills/logo-design/tsconfig.json +0 -17
  370. package/skills/lorem-generator/CLAUDE.md +0 -19
  371. package/skills/lorem-generator/package.json +0 -29
  372. package/skills/lorem-generator/src/index.ts +0 -59
  373. package/skills/lorem-generator/tsconfig.json +0 -10
  374. package/skills/managemcp/CLAUDE.md +0 -14
  375. package/skills/managemcp/README.md +0 -24
  376. package/skills/managemcp/package.json +0 -16
  377. package/skills/managemcp/src/index.ts +0 -3
  378. package/skills/managemcp/tsconfig.json +0 -27
  379. package/skills/markdown-validator/CLAUDE.md +0 -19
  380. package/skills/markdown-validator/package.json +0 -29
  381. package/skills/markdown-validator/src/index.ts +0 -92
  382. package/skills/markdown-validator/tsconfig.json +0 -10
  383. package/skills/market-research-report/SKILL.md +0 -51
  384. package/skills/market-research-report/package.json +0 -10
  385. package/skills/meeting-pack/SKILL.md +0 -52
  386. package/skills/meeting-pack/package.json +0 -10
  387. package/skills/merge-pdfs/CLAUDE.md +0 -19
  388. package/skills/merge-pdfs/package.json +0 -31
  389. package/skills/merge-pdfs/src/index.ts +0 -427
  390. package/skills/merge-pdfs/tsconfig.json +0 -10
  391. package/skills/migration-plan-pack/SKILL.md +0 -56
  392. package/skills/migration-plan-pack/package.json +0 -10
  393. package/skills/monitor/SKILL.md +0 -69
  394. package/skills/monitor/package.json +0 -33
  395. package/skills/monitor/src/index.ts +0 -34
  396. package/skills/monitor/tsconfig.json +0 -17
  397. package/skills/one-page-website/SKILL.md +0 -128
  398. package/skills/one-page-website/package.json +0 -34
  399. package/skills/one-page-website/src/design.ts +0 -336
  400. package/skills/one-page-website/src/docs.ts +0 -159
  401. package/skills/one-page-website/src/index.ts +0 -357
  402. package/skills/one-page-website/src/page.ts +0 -340
  403. package/skills/one-page-website/src/styles.ts +0 -508
  404. package/skills/one-page-website/src/types.ts +0 -78
  405. package/skills/one-page-website/tsconfig.json +0 -17
  406. package/skills/pdf-generate/CLAUDE.md +0 -19
  407. package/skills/pdf-generate/SKILL.md +0 -86
  408. package/skills/pdf-generate/package.json +0 -21
  409. package/skills/pdf-generate/src/cli.ts +0 -162
  410. package/skills/pdf-generate/src/html.ts +0 -84
  411. package/skills/pdf-generate/src/index.ts +0 -62
  412. package/skills/pdf-generate/src/markdown.ts +0 -27
  413. package/skills/pdf-generate/src/pdf-writer.ts +0 -78
  414. package/skills/pdf-generate/src/runtime.ts +0 -34
  415. package/skills/pdf-generate/src/security.ts +0 -37
  416. package/skills/pdf-generate/src/templates.ts +0 -311
  417. package/skills/pdf-generate/src/types.ts +0 -28
  418. package/skills/pdf-generate/tsconfig.json +0 -16
  419. package/skills/pdf-to-dataset/SKILL.md +0 -88
  420. package/skills/pdf-to-dataset/package.json +0 -37
  421. package/skills/pdf-to-dataset/src/index.ts +0 -790
  422. package/skills/pdf-to-dataset/tsconfig.json +0 -17
  423. package/skills/pdf-to-markdown/SKILL.md +0 -81
  424. package/skills/pdf-to-markdown/package.json +0 -35
  425. package/skills/pdf-to-markdown/src/index.ts +0 -694
  426. package/skills/pdf-to-markdown/tsconfig.json +0 -17
  427. package/skills/performance-audit-report/SKILL.md +0 -49
  428. package/skills/performance-audit-report/package.json +0 -10
  429. package/skills/pitch-deck/SKILL.md +0 -51
  430. package/skills/pitch-deck/package.json +0 -10
  431. package/skills/product-mockup/SKILL.md +0 -107
  432. package/skills/product-mockup/package.json +0 -32
  433. package/skills/product-mockup/src/cli.ts +0 -150
  434. package/skills/product-mockup/src/design.ts +0 -151
  435. package/skills/product-mockup/src/docs.ts +0 -134
  436. package/skills/product-mockup/src/index.ts +0 -182
  437. package/skills/product-mockup/src/render.ts +0 -407
  438. package/skills/product-mockup/src/types.ts +0 -66
  439. package/skills/product-mockup/tsconfig.json +0 -17
  440. package/skills/proposal-pack/SKILL.md +0 -53
  441. package/skills/proposal-pack/package.json +0 -10
  442. package/skills/read-csv/SKILL.md +0 -62
  443. package/skills/read-csv/package.json +0 -37
  444. package/skills/read-csv/src/index.ts +0 -356
  445. package/skills/read-csv/tsconfig.json +0 -17
  446. package/skills/read-excel/SKILL.md +0 -64
  447. package/skills/read-excel/package.json +0 -36
  448. package/skills/read-excel/src/index.ts +0 -266
  449. package/skills/read-excel/tsconfig.json +0 -17
  450. package/skills/regex-tester/CLAUDE.md +0 -19
  451. package/skills/regex-tester/package.json +0 -27
  452. package/skills/regex-tester/src/index.ts +0 -183
  453. package/skills/regex-tester/tsconfig.json +0 -10
  454. package/skills/repo-onboarding-report/SKILL.md +0 -52
  455. package/skills/repo-onboarding-report/package.json +0 -10
  456. package/skills/scancommitpr/SKILL.md +0 -178
  457. package/skills/scancommitpr/package.json +0 -34
  458. package/skills/scancommitpr/src/index.ts +0 -44
  459. package/skills/scancommitpr/tsconfig.json +0 -13
  460. package/skills/scancommitpush/SKILL.md +0 -174
  461. package/skills/scancommitpush/package.json +0 -32
  462. package/skills/scancommitpush/src/index.ts +0 -44
  463. package/skills/scancommitpush/tsconfig.json +0 -13
  464. package/skills/scientific-figure-check/CLAUDE.md +0 -19
  465. package/skills/scientific-figure-check/package.json +0 -29
  466. package/skills/scientific-figure-check/src/index.ts +0 -83
  467. package/skills/scientific-figure-check/tsconfig.json +0 -10
  468. package/skills/security-audit/CLAUDE.md +0 -19
  469. package/skills/security-audit/package.json +0 -27
  470. package/skills/security-audit/src/index.ts +0 -145
  471. package/skills/security-audit/tsconfig.json +0 -10
  472. package/skills/security-audit-report/SKILL.md +0 -52
  473. package/skills/security-audit-report/package.json +0 -10
  474. package/skills/seo-content-pack/SKILL.md +0 -54
  475. package/skills/seo-content-pack/package.json +0 -10
  476. package/skills/siteanalyze/SKILL.md +0 -25
  477. package/skills/siteanalyze/package.json +0 -27
  478. package/skills/siteanalyze/src/index.ts +0 -592
  479. package/skills/slide-deck-generator/SKILL.md +0 -93
  480. package/skills/slide-deck-generator/package.json +0 -38
  481. package/skills/slide-deck-generator/src/cli.ts +0 -133
  482. package/skills/slide-deck-generator/src/index.ts +0 -148
  483. package/skills/slide-deck-generator/src/model.ts +0 -307
  484. package/skills/slide-deck-generator/src/pptx.ts +0 -143
  485. package/skills/slide-deck-generator/src/render.ts +0 -248
  486. package/skills/slide-deck-generator/src/types.ts +0 -114
  487. package/skills/slide-deck-generator/src/utils.ts +0 -53
  488. package/skills/slide-deck-generator/tsconfig.json +0 -17
  489. package/skills/social-content-calendar/SKILL.md +0 -54
  490. package/skills/social-content-calendar/package.json +0 -10
  491. package/skills/split-pdf/CLAUDE.md +0 -19
  492. package/skills/split-pdf/package.json +0 -30
  493. package/skills/split-pdf/src/index.ts +0 -301
  494. package/skills/split-pdf/tsconfig.json +0 -10
  495. package/skills/statistical-test-selector/CLAUDE.md +0 -19
  496. package/skills/statistical-test-selector/package.json +0 -27
  497. package/skills/statistical-test-selector/src/index.ts +0 -75
  498. package/skills/statistical-test-selector/tsconfig.json +0 -10
  499. package/skills/test-suite-generator/SKILL.md +0 -51
  500. package/skills/test-suite-generator/package.json +0 -10
  501. package/skills/tmux-session/SKILL.md +0 -109
  502. package/skills/tmux-session/package.json +0 -33
  503. package/skills/tmux-session/src/index.ts +0 -34
  504. package/skills/tmux-session/tsconfig.json +0 -17
  505. package/skills/todos-plan/SKILL.md +0 -363
  506. package/skills/todos-plan/agents/openai.yaml +0 -4
  507. package/skills/todos-plan/package.json +0 -9
  508. package/skills/todos-plan/src/index.ts +0 -68
  509. package/skills/tsconfig.base.json +0 -12
  510. package/skills/validate-config/CLAUDE.md +0 -19
  511. package/skills/validate-config/package.json +0 -29
  512. package/skills/validate-config/src/index.ts +0 -56
  513. package/skills/validate-config/tsconfig.json +0 -10
  514. package/skills/video-downloader/CLAUDE.md +0 -19
  515. package/skills/video-downloader/package.json +0 -29
  516. package/skills/video-downloader/src/index.ts +0 -561
  517. package/skills/video-downloader/tsconfig.json +0 -10
  518. package/skills/video-highlight-pack/SKILL.md +0 -54
  519. package/skills/video-highlight-pack/package.json +0 -10
  520. package/skills/watermark/CLAUDE.md +0 -19
  521. package/skills/watermark/package.json +0 -32
  522. package/skills/watermark/src/index.ts +0 -587
  523. 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
- });