@hasna/skills 0.1.62 → 0.1.64

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