@hasna/skills 0.1.62 → 0.1.63
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +10 -6
- package/bin/index.js +14271 -21602
- package/bin/mcp.js +3527 -11449
- package/bin/migrate.js +53 -3
- package/bin/server.js +5140 -2675
- package/bin/worker.js +4542 -2129
- package/dist/cli/commands/publish.d.ts +2 -0
- package/dist/cli/components/App.d.ts +2 -1
- package/dist/cli/components/CategorySelect.d.ts +2 -1
- package/dist/cli/components/Header.d.ts +2 -1
- package/dist/cli/components/InstallProgress.d.ts +2 -1
- package/dist/cli/components/SearchView.d.ts +2 -1
- package/dist/cli/components/SkillSelect.d.ts +2 -1
- package/dist/index.d.ts +4 -1
- package/dist/index.js +5094 -13755
- package/dist/lib/agent-sync.d.ts +38 -3
- package/dist/lib/home-adoption.d.ts +91 -0
- package/dist/lib/home-census.d.ts +22 -0
- package/dist/lib/home-migration.d.ts +61 -0
- package/dist/lib/portable-skills-files.d.ts +21 -1
- package/dist/lib/portable-skills-types.d.ts +46 -0
- package/dist/lib/pull.d.ts +66 -0
- package/dist/lib/remote-client.d.ts +6 -0
- package/dist/lib/run-state.d.ts +5 -0
- package/dist/lib/skill-bundles.d.ts +54 -0
- package/dist/lib/skill-contract.d.ts +35 -0
- package/dist/lib/skill-hash.d.ts +77 -0
- package/dist/sdk/cancel.d.ts +30 -0
- package/dist/sdk/dispatcher.d.ts +40 -0
- package/dist/sdk/event-sink.d.ts +2 -0
- package/dist/sdk/events.d.ts +79 -0
- package/dist/sdk/execution/admission.d.ts +44 -0
- package/dist/sdk/execution/dispatchers/e2b.d.ts +17 -0
- package/dist/sdk/execution/dispatchers/ecs.d.ts +151 -0
- package/dist/sdk/execution/image-profile.d.ts +73 -0
- package/dist/sdk/execution/index.d.ts +15 -0
- package/dist/sdk/execution/receipts.d.ts +44 -0
- package/dist/sdk/execution/state-machine.d.ts +38 -0
- package/dist/sdk/execution/storage.d.ts +158 -0
- package/dist/sdk/execution/types.d.ts +130 -0
- package/dist/sdk/executor.d.ts +17 -0
- package/dist/sdk/governance-store.d.ts +156 -0
- package/dist/sdk/governance.d.ts +92 -0
- package/dist/sdk/index.d.ts +26 -0
- package/dist/sdk/index.js +48730 -0
- package/dist/sdk/offline.d.ts +16 -0
- package/dist/sdk/outputs.d.ts +71 -0
- package/dist/sdk/registry.d.ts +28 -0
- package/dist/sdk/runs.d.ts +229 -0
- package/dist/sdk/server.d.ts +35 -0
- package/dist/sdk/spend.d.ts +36 -0
- package/dist/sdk/storage.d.ts +25 -0
- package/dist/server/app.d.ts +42 -0
- package/dist/server/artifact-storage.d.ts +102 -0
- package/dist/server/auth.d.ts +5 -0
- package/dist/server/config.d.ts +40 -0
- package/dist/server/database-url.d.ts +42 -0
- package/dist/server/handlers.d.ts +3 -0
- package/dist/server/index.d.ts +2 -0
- package/dist/server/migrate.d.ts +13 -0
- package/dist/server/migrations-dir.d.ts +18 -0
- package/dist/server/redaction.d.ts +1 -0
- package/dist/server/registry.d.ts +5 -0
- package/dist/server/rows.d.ts +23 -0
- package/dist/server/skills-api.d.ts +68 -0
- package/dist/server/sqlite-store.d.ts +114 -0
- package/dist/server/store-fixtures.d.ts +25 -0
- package/dist/server/store.d.ts +144 -0
- package/dist/server/types.d.ts +242 -0
- package/dist/server/worker.d.ts +4 -0
- package/dist/storage.js +32 -0
- package/docs/skill-standard.md +211 -39
- package/migrations/postgres/0003_run_outputs_governance.sql +83 -0
- package/migrations/sqlite/0003_run_outputs_governance.sql +58 -0
- package/package.json +11 -8
- package/schemas/skill.schema.json +181 -0
- package/agent-skills/README.md +0 -41
- package/agent-skills/fleet-package-rollout/SKILL.md +0 -169
- package/agent-skills/inbox/SKILL.md +0 -25
- package/agent-skills/inbox/scripts/inbox +0 -109
- package/agent-skills/inbox/tests/test_registered_sender_id.sh +0 -92
- package/agent-skills/inbox-monitor/SKILL.md +0 -41
- package/agent-skills/inbox-monitor/scripts/inbox_monitor.sh +0 -91
- package/agent-skills/inbox-monitor/scripts/test_inbox_monitor.sh +0 -71
- package/agent-skills/merge-pr/SKILL.md +0 -85
- package/agent-skills/merge-pr/references/merge-safety.md +0 -82
- package/agent-skills/merge-pr/scripts/merge_pr_guard.py +0 -694
- package/agent-skills/merge-pr/scripts/test_merge_pr_guard.py +0 -647
- package/agent-skills/merge-pr/tests/fixtures/multi-commit-synthesized.json +0 -28
- package/agent-skills/merge-pr/tests/fixtures/trailer-free-provider.json +0 -28
- package/agent-skills/skill-goal-execute/SKILL.md +0 -115
- package/agent-skills/skill-login/SKILL.md +0 -109
- package/agent-skills/skill-project-create/SKILL.md +0 -91
- package/agent-skills/skill-publish/SKILL.md +0 -254
- package/agent-skills/skill-publish/scripts/capture_registry.js +0 -47
- package/agent-skills/skill-publish/scripts/publish_with_git_head.sh +0 -143
- package/agent-skills/skill-publish/scripts/test_publish_with_git_head.sh +0 -231
- package/skills/_common/auth.ts +0 -45
- package/skills/_common/http-client.ts +0 -143
- package/skills/_common/index.ts +0 -26
- package/skills/_common/install.sh +0 -7
- package/skills/_common/installer.ts +0 -72
- package/skills/_common/skill-install.ts +0 -37
- package/skills/_common/vision.ts +0 -374
- package/skills/ad-creative-pack/SKILL.md +0 -55
- package/skills/ad-creative-pack/package.json +0 -10
- package/skills/analyze-data/CLAUDE.md +0 -16
- package/skills/analyze-data/SKILL.md +0 -112
- package/skills/analyze-data/package.json +0 -23
- package/skills/analyze-data/src/analysis.ts +0 -401
- package/skills/analyze-data/src/cli.ts +0 -66
- package/skills/analyze-data/src/formatters.ts +0 -235
- package/skills/analyze-data/src/index.ts +0 -74
- package/skills/analyze-data/src/logger.ts +0 -36
- package/skills/analyze-data/src/parsers.ts +0 -57
- package/skills/analyze-data/src/stats.ts +0 -151
- package/skills/analyze-data/src/types.ts +0 -85
- package/skills/analyze-data/tsconfig.json +0 -19
- package/skills/api-docs-portal/SKILL.md +0 -84
- package/skills/api-docs-portal/package.json +0 -35
- package/skills/api-docs-portal/src/index.ts +0 -919
- package/skills/api-docs-portal/tsconfig.json +0 -17
- package/skills/api-test-suite/CLAUDE.md +0 -19
- package/skills/api-test-suite/package.json +0 -27
- package/skills/api-test-suite/src/index.ts +0 -381
- package/skills/api-test-suite/tsconfig.json +0 -10
- package/skills/audio-extract/CLAUDE.md +0 -9
- package/skills/audio-extract/SKILL.md +0 -73
- package/skills/audio-extract/package.json +0 -23
- package/skills/audio-extract/src/index.ts +0 -323
- package/skills/audio-extract/tsconfig.json +0 -11
- package/skills/bio-sequence-tool/CLAUDE.md +0 -19
- package/skills/bio-sequence-tool/package.json +0 -27
- package/skills/bio-sequence-tool/src/index.ts +0 -85
- package/skills/bio-sequence-tool/tsconfig.json +0 -10
- package/skills/blog-article/CLAUDE.md +0 -12
- package/skills/blog-article/SKILL.md +0 -55
- package/skills/blog-article/package.json +0 -10
- package/skills/blog-article/tsconfig.json +0 -10
- package/skills/brand-assets/SKILL.md +0 -118
- package/skills/brand-assets/package.json +0 -35
- package/skills/brand-assets/src/cli.ts +0 -155
- package/skills/brand-assets/src/constants.ts +0 -8
- package/skills/brand-assets/src/extract.ts +0 -236
- package/skills/brand-assets/src/index.ts +0 -668
- package/skills/brand-assets/src/types.ts +0 -59
- package/skills/brand-assets/tsconfig.json +0 -17
- package/skills/brand-kit/SKILL.md +0 -54
- package/skills/brand-kit/package.json +0 -10
- package/skills/businessactivity/CLAUDE.md +0 -176
- package/skills/businessactivity/LICENSE +0 -192
- package/skills/businessactivity/README.md +0 -287
- package/skills/businessactivity/package.json +0 -25
- package/skills/businessactivity/scripts/publish.ts +0 -210
- package/skills/businessactivity/src/commands/activity.ts +0 -211
- package/skills/businessactivity/src/commands/function.ts +0 -227
- package/skills/businessactivity/src/commands/owner.ts +0 -193
- package/skills/businessactivity/src/commands/profile.ts +0 -121
- package/skills/businessactivity/src/commands/responsibility.ts +0 -264
- package/skills/businessactivity/src/commands/team.ts +0 -244
- package/skills/businessactivity/src/commands/workflow.ts +0 -359
- package/skills/businessactivity/src/index.ts +0 -3
- package/skills/businessactivity/src/lib/config.ts +0 -167
- package/skills/businessactivity/src/lib/output.ts +0 -76
- package/skills/businessactivity/src/lib/paths.ts +0 -79
- package/skills/businessactivity/src/lib/storage.ts +0 -95
- package/skills/businessactivity/src/types/index.ts +0 -86
- package/skills/businessactivity/tsconfig.json +0 -29
- package/skills/codefix/LICENSE +0 -192
- package/skills/codefix/README.md +0 -232
- package/skills/codefix/SKILL.md +0 -94
- package/skills/codefix/package.json +0 -21
- package/skills/codefix/src/fixers/batch.ts +0 -213
- package/skills/codefix/src/fixers/detector.ts +0 -160
- package/skills/codefix/src/fixers/index.ts +0 -7
- package/skills/codefix/src/fixers/runner.ts +0 -522
- package/skills/codefix/src/index-local.ts +0 -431
- package/skills/codefix/src/index.ts +0 -4
- package/skills/codefix/src/types.ts +0 -211
- package/skills/codefix/tsconfig.json +0 -15
- package/skills/commitpush/SKILL.md +0 -57
- package/skills/commitpush/package.json +0 -33
- package/skills/commitpush/src/index.ts +0 -34
- package/skills/commitpush/tsconfig.json +0 -17
- package/skills/commitpushpr/SKILL.md +0 -55
- package/skills/commitpushpr/package.json +0 -33
- package/skills/commitpushpr/src/index.ts +0 -34
- package/skills/commitpushpr/tsconfig.json +0 -17
- package/skills/compress-video/CLAUDE.md +0 -9
- package/skills/compress-video/SKILL.md +0 -79
- package/skills/compress-video/package.json +0 -23
- package/skills/compress-video/src/index.ts +0 -473
- package/skills/compress-video/tsconfig.json +0 -11
- package/skills/contract-review-report/SKILL.md +0 -52
- package/skills/contract-review-report/package.json +0 -10
- package/skills/customer-feedback-report/SKILL.md +0 -52
- package/skills/customer-feedback-report/package.json +0 -10
- package/skills/dashboard-builder/CLAUDE.md +0 -19
- package/skills/dashboard-builder/package.json +0 -29
- package/skills/dashboard-builder/src/index.ts +0 -150
- package/skills/dashboard-builder/tsconfig.json +0 -10
- package/skills/data-anonymizer/CLAUDE.md +0 -19
- package/skills/data-anonymizer/package.json +0 -27
- package/skills/data-anonymizer/src/index.ts +0 -183
- package/skills/data-anonymizer/tsconfig.json +0 -10
- package/skills/database-explorer/CLAUDE.md +0 -19
- package/skills/database-explorer/package.json +0 -29
- package/skills/database-explorer/src/index.ts +0 -95
- package/skills/database-explorer/tsconfig.json +0 -10
- package/skills/diff-viewer/CLAUDE.md +0 -19
- package/skills/diff-viewer/package.json +0 -30
- package/skills/diff-viewer/src/index.ts +0 -164
- package/skills/diff-viewer/tsconfig.json +0 -10
- package/skills/doc-read/SKILL.md +0 -45
- package/skills/doc-read/package.json +0 -29
- package/skills/doc-read/src/index.ts +0 -324
- package/skills/doc-read/tsconfig.json +0 -8
- package/skills/domainpurchase/LICENSE +0 -192
- package/skills/domainpurchase/SKILL.md +0 -29
- package/skills/domainpurchase/package.json +0 -30
- package/skills/domainpurchase/src/index.ts +0 -3
- package/skills/domainpurchase/tsconfig.json +0 -21
- package/skills/email-sequence/SKILL.md +0 -53
- package/skills/email-sequence/package.json +0 -10
- package/skills/experiment-power-calculator/CLAUDE.md +0 -19
- package/skills/experiment-power-calculator/package.json +0 -29
- package/skills/experiment-power-calculator/src/index.ts +0 -86
- package/skills/experiment-power-calculator/tsconfig.json +0 -10
- package/skills/extract-frames/CLAUDE.md +0 -19
- package/skills/extract-frames/package.json +0 -27
- package/skills/extract-frames/src/index.ts +0 -616
- package/skills/extract-frames/tsconfig.json +0 -10
- package/skills/file-organizer/CLAUDE.md +0 -19
- package/skills/file-organizer/package.json +0 -27
- package/skills/file-organizer/src/index.ts +0 -91
- package/skills/file-organizer/tsconfig.json +0 -10
- package/skills/folder-tree/CLAUDE.md +0 -19
- package/skills/folder-tree/package.json +0 -29
- package/skills/folder-tree/src/index.ts +0 -568
- package/skills/folder-tree/tsconfig.json +0 -10
- package/skills/form-filler/CLAUDE.md +0 -19
- package/skills/form-filler/package.json +0 -29
- package/skills/form-filler/src/index.ts +0 -81
- package/skills/form-filler/tsconfig.json +0 -10
- package/skills/generate-api-client/CLAUDE.md +0 -19
- package/skills/generate-api-client/package.json +0 -29
- package/skills/generate-api-client/src/generator.ts +0 -47
- package/skills/generate-api-client/src/index.ts +0 -92
- package/skills/generate-api-client/src/logger.ts +0 -34
- package/skills/generate-api-client/src/python-generator.ts +0 -245
- package/skills/generate-api-client/src/spec-loader.ts +0 -48
- package/skills/generate-api-client/src/type-mappers.ts +0 -79
- package/skills/generate-api-client/src/types.ts +0 -76
- package/skills/generate-api-client/src/typescript-generator.ts +0 -247
- package/skills/generate-api-client/tsconfig.json +0 -10
- package/skills/generate-chart/CLAUDE.md +0 -19
- package/skills/generate-chart/package.json +0 -27
- package/skills/generate-chart/src/index.ts +0 -510
- package/skills/generate-chart/tsconfig.json +0 -10
- package/skills/generate-dockerfile/CLAUDE.md +0 -19
- package/skills/generate-dockerfile/package.json +0 -27
- package/skills/generate-dockerfile/src/cli.ts +0 -78
- package/skills/generate-dockerfile/src/dockerfile-templates.ts +0 -392
- package/skills/generate-dockerfile/src/index.ts +0 -81
- package/skills/generate-dockerfile/src/logger.ts +0 -30
- package/skills/generate-dockerfile/src/project-detection.ts +0 -68
- package/skills/generate-dockerfile/src/support-files.ts +0 -171
- package/skills/generate-dockerfile/src/types.ts +0 -29
- package/skills/generate-dockerfile/tsconfig.json +0 -10
- package/skills/generate-env/CLAUDE.md +0 -19
- package/skills/generate-env/package.json +0 -29
- package/skills/generate-env/src/cli.ts +0 -85
- package/skills/generate-env/src/detection.ts +0 -161
- package/skills/generate-env/src/env-data.ts +0 -66
- package/skills/generate-env/src/generators.ts +0 -240
- package/skills/generate-env/src/index.ts +0 -120
- package/skills/generate-env/src/runtime.ts +0 -30
- package/skills/generate-env/src/types.ts +0 -32
- package/skills/generate-env/tsconfig.json +0 -10
- package/skills/generate-favicon/CLAUDE.md +0 -19
- package/skills/generate-favicon/package.json +0 -29
- package/skills/generate-favicon/src/index.ts +0 -421
- package/skills/generate-favicon/tsconfig.json +0 -10
- package/skills/generate-qrcode/CLAUDE.md +0 -19
- package/skills/generate-qrcode/package.json +0 -30
- package/skills/generate-qrcode/src/index.ts +0 -584
- package/skills/generate-qrcode/tsconfig.json +0 -10
- package/skills/generate-resume/CLAUDE.md +0 -19
- package/skills/generate-resume/package.json +0 -27
- package/skills/generate-resume/src/cli.ts +0 -157
- package/skills/generate-resume/src/index.ts +0 -178
- package/skills/generate-resume/src/parsers.ts +0 -95
- package/skills/generate-resume/src/renderers.ts +0 -538
- package/skills/generate-resume/src/security.ts +0 -39
- package/skills/generate-resume/src/types.ts +0 -86
- package/skills/generate-resume/tsconfig.json +0 -10
- package/skills/generate-sitemap/CLAUDE.md +0 -19
- package/skills/generate-sitemap/package.json +0 -27
- package/skills/generate-sitemap/src/index.ts +0 -626
- package/skills/generate-sitemap/tsconfig.json +0 -10
- package/skills/gif-maker/CLAUDE.md +0 -19
- package/skills/gif-maker/package.json +0 -30
- package/skills/gif-maker/src/index.ts +0 -600
- package/skills/gif-maker/tsconfig.json +0 -10
- package/skills/hook/LICENSE +0 -192
- package/skills/hook/README.md +0 -74
- package/skills/hook/SKILL.md +0 -85
- package/skills/hook/bunfig.toml +0 -5
- package/skills/hook/package.json +0 -28
- package/skills/hook/src/commands/create.ts +0 -112
- package/skills/hook/src/commands/events.ts +0 -37
- package/skills/hook/src/commands/validate.ts +0 -117
- package/skills/hook/src/index.ts +0 -118
- package/skills/hook/src/templates/root.ts +0 -196
- package/skills/hook/src/templates/source.ts +0 -647
- package/skills/hook/tsconfig.json +0 -18
- package/skills/http-server/CLAUDE.md +0 -19
- package/skills/http-server/package.json +0 -29
- package/skills/http-server/src/index.ts +0 -51
- package/skills/http-server/tsconfig.json +0 -10
- package/skills/implementation/LICENSE +0 -192
- package/skills/implementation/README.md +0 -53
- package/skills/implementation/SKILL.md +0 -57
- package/skills/implementation/bunfig.toml +0 -5
- package/skills/implementation/package.json +0 -28
- package/skills/implementation/src/commands/create.ts +0 -187
- package/skills/implementation/src/index.ts +0 -62
- package/skills/implementation/tsconfig.json +0 -18
- package/skills/implementation-plan/CLAUDE.md +0 -19
- package/skills/implementation-plan/package.json +0 -29
- package/skills/implementation-plan/src/index.ts +0 -520
- package/skills/implementation-plan/tsconfig.json +0 -10
- package/skills/implementation-todo/CLAUDE.md +0 -19
- package/skills/implementation-todo/package.json +0 -29
- package/skills/implementation-todo/src/index.ts +0 -429
- package/skills/implementation-todo/tsconfig.json +0 -10
- package/skills/invoice/.env.example +0 -3
- package/skills/invoice/CLAUDE.md +0 -31
- package/skills/invoice/LICENSE +0 -192
- package/skills/invoice/README.md +0 -70
- package/skills/invoice/package.json +0 -26
- package/skills/invoice/src/commands/companies.ts +0 -202
- package/skills/invoice/src/commands/config.ts +0 -132
- package/skills/invoice/src/commands/generate.ts +0 -177
- package/skills/invoice/src/commands/invoices.ts +0 -218
- package/skills/invoice/src/index.ts +0 -3
- package/skills/invoice/src/lib/api.ts +0 -124
- package/skills/invoice/src/lib/storage.ts +0 -171
- package/skills/invoice/src/types/index.ts +0 -86
- package/skills/invoice/src/utils/logger.ts +0 -33
- package/skills/invoice/src/utils/paths.ts +0 -25
- package/skills/invoice/tsconfig.json +0 -23
- package/skills/invoice-reconciliation/SKILL.md +0 -98
- package/skills/invoice-reconciliation/package.json +0 -36
- package/skills/invoice-reconciliation/src/index.ts +0 -743
- package/skills/invoice-reconciliation/tsconfig.json +0 -17
- package/skills/landing-page-pack/SKILL.md +0 -55
- package/skills/landing-page-pack/package.json +0 -10
- package/skills/latex-table-generator/CLAUDE.md +0 -19
- package/skills/latex-table-generator/package.json +0 -29
- package/skills/latex-table-generator/src/index.ts +0 -113
- package/skills/latex-table-generator/tsconfig.json +0 -10
- package/skills/logo-design/SKILL.md +0 -94
- package/skills/logo-design/package.json +0 -35
- package/skills/logo-design/src/cli.ts +0 -132
- package/skills/logo-design/src/constants.ts +0 -5
- package/skills/logo-design/src/docs.ts +0 -102
- package/skills/logo-design/src/geometry.ts +0 -324
- package/skills/logo-design/src/index.ts +0 -212
- package/skills/logo-design/src/palette.ts +0 -258
- package/skills/logo-design/src/types.ts +0 -50
- package/skills/logo-design/tsconfig.json +0 -17
- package/skills/lorem-generator/CLAUDE.md +0 -19
- package/skills/lorem-generator/package.json +0 -29
- package/skills/lorem-generator/src/index.ts +0 -59
- package/skills/lorem-generator/tsconfig.json +0 -10
- package/skills/managemcp/CLAUDE.md +0 -14
- package/skills/managemcp/README.md +0 -24
- package/skills/managemcp/package.json +0 -16
- package/skills/managemcp/src/index.ts +0 -3
- package/skills/managemcp/tsconfig.json +0 -27
- package/skills/markdown-validator/CLAUDE.md +0 -19
- package/skills/markdown-validator/package.json +0 -29
- package/skills/markdown-validator/src/index.ts +0 -92
- package/skills/markdown-validator/tsconfig.json +0 -10
- package/skills/market-research-report/SKILL.md +0 -51
- package/skills/market-research-report/package.json +0 -10
- package/skills/meeting-pack/SKILL.md +0 -52
- package/skills/meeting-pack/package.json +0 -10
- package/skills/merge-pdfs/CLAUDE.md +0 -19
- package/skills/merge-pdfs/package.json +0 -31
- package/skills/merge-pdfs/src/index.ts +0 -427
- package/skills/merge-pdfs/tsconfig.json +0 -10
- package/skills/migration-plan-pack/SKILL.md +0 -56
- package/skills/migration-plan-pack/package.json +0 -10
- package/skills/monitor/SKILL.md +0 -69
- package/skills/monitor/package.json +0 -33
- package/skills/monitor/src/index.ts +0 -34
- package/skills/monitor/tsconfig.json +0 -17
- package/skills/one-page-website/SKILL.md +0 -128
- package/skills/one-page-website/package.json +0 -34
- package/skills/one-page-website/src/design.ts +0 -336
- package/skills/one-page-website/src/docs.ts +0 -159
- package/skills/one-page-website/src/index.ts +0 -357
- package/skills/one-page-website/src/page.ts +0 -340
- package/skills/one-page-website/src/styles.ts +0 -508
- package/skills/one-page-website/src/types.ts +0 -78
- package/skills/one-page-website/tsconfig.json +0 -17
- package/skills/pdf-generate/CLAUDE.md +0 -19
- package/skills/pdf-generate/SKILL.md +0 -86
- package/skills/pdf-generate/package.json +0 -21
- package/skills/pdf-generate/src/cli.ts +0 -162
- package/skills/pdf-generate/src/html.ts +0 -84
- package/skills/pdf-generate/src/index.ts +0 -62
- package/skills/pdf-generate/src/markdown.ts +0 -27
- package/skills/pdf-generate/src/pdf-writer.ts +0 -78
- package/skills/pdf-generate/src/runtime.ts +0 -34
- package/skills/pdf-generate/src/security.ts +0 -37
- package/skills/pdf-generate/src/templates.ts +0 -311
- package/skills/pdf-generate/src/types.ts +0 -28
- package/skills/pdf-generate/tsconfig.json +0 -16
- package/skills/pdf-to-dataset/SKILL.md +0 -88
- package/skills/pdf-to-dataset/package.json +0 -37
- package/skills/pdf-to-dataset/src/index.ts +0 -790
- package/skills/pdf-to-dataset/tsconfig.json +0 -17
- package/skills/pdf-to-markdown/SKILL.md +0 -81
- package/skills/pdf-to-markdown/package.json +0 -35
- package/skills/pdf-to-markdown/src/index.ts +0 -694
- package/skills/pdf-to-markdown/tsconfig.json +0 -17
- package/skills/performance-audit-report/SKILL.md +0 -49
- package/skills/performance-audit-report/package.json +0 -10
- package/skills/pitch-deck/SKILL.md +0 -51
- package/skills/pitch-deck/package.json +0 -10
- package/skills/product-mockup/SKILL.md +0 -107
- package/skills/product-mockup/package.json +0 -32
- package/skills/product-mockup/src/cli.ts +0 -150
- package/skills/product-mockup/src/design.ts +0 -151
- package/skills/product-mockup/src/docs.ts +0 -134
- package/skills/product-mockup/src/index.ts +0 -182
- package/skills/product-mockup/src/render.ts +0 -407
- package/skills/product-mockup/src/types.ts +0 -66
- package/skills/product-mockup/tsconfig.json +0 -17
- package/skills/proposal-pack/SKILL.md +0 -53
- package/skills/proposal-pack/package.json +0 -10
- package/skills/read-csv/SKILL.md +0 -62
- package/skills/read-csv/package.json +0 -37
- package/skills/read-csv/src/index.ts +0 -356
- package/skills/read-csv/tsconfig.json +0 -17
- package/skills/read-excel/SKILL.md +0 -64
- package/skills/read-excel/package.json +0 -36
- package/skills/read-excel/src/index.ts +0 -266
- package/skills/read-excel/tsconfig.json +0 -17
- package/skills/regex-tester/CLAUDE.md +0 -19
- package/skills/regex-tester/package.json +0 -27
- package/skills/regex-tester/src/index.ts +0 -183
- package/skills/regex-tester/tsconfig.json +0 -10
- package/skills/repo-onboarding-report/SKILL.md +0 -52
- package/skills/repo-onboarding-report/package.json +0 -10
- package/skills/scancommitpr/SKILL.md +0 -178
- package/skills/scancommitpr/package.json +0 -34
- package/skills/scancommitpr/src/index.ts +0 -44
- package/skills/scancommitpr/tsconfig.json +0 -13
- package/skills/scancommitpush/SKILL.md +0 -174
- package/skills/scancommitpush/package.json +0 -32
- package/skills/scancommitpush/src/index.ts +0 -44
- package/skills/scancommitpush/tsconfig.json +0 -13
- package/skills/scientific-figure-check/CLAUDE.md +0 -19
- package/skills/scientific-figure-check/package.json +0 -29
- package/skills/scientific-figure-check/src/index.ts +0 -83
- package/skills/scientific-figure-check/tsconfig.json +0 -10
- package/skills/security-audit/CLAUDE.md +0 -19
- package/skills/security-audit/package.json +0 -27
- package/skills/security-audit/src/index.ts +0 -145
- package/skills/security-audit/tsconfig.json +0 -10
- package/skills/security-audit-report/SKILL.md +0 -52
- package/skills/security-audit-report/package.json +0 -10
- package/skills/seo-content-pack/SKILL.md +0 -54
- package/skills/seo-content-pack/package.json +0 -10
- package/skills/siteanalyze/SKILL.md +0 -25
- package/skills/siteanalyze/package.json +0 -27
- package/skills/siteanalyze/src/index.ts +0 -592
- package/skills/slide-deck-generator/SKILL.md +0 -93
- package/skills/slide-deck-generator/package.json +0 -38
- package/skills/slide-deck-generator/src/cli.ts +0 -133
- package/skills/slide-deck-generator/src/index.ts +0 -148
- package/skills/slide-deck-generator/src/model.ts +0 -307
- package/skills/slide-deck-generator/src/pptx.ts +0 -143
- package/skills/slide-deck-generator/src/render.ts +0 -248
- package/skills/slide-deck-generator/src/types.ts +0 -114
- package/skills/slide-deck-generator/src/utils.ts +0 -53
- package/skills/slide-deck-generator/tsconfig.json +0 -17
- package/skills/social-content-calendar/SKILL.md +0 -54
- package/skills/social-content-calendar/package.json +0 -10
- package/skills/split-pdf/CLAUDE.md +0 -19
- package/skills/split-pdf/package.json +0 -30
- package/skills/split-pdf/src/index.ts +0 -301
- package/skills/split-pdf/tsconfig.json +0 -10
- package/skills/statistical-test-selector/CLAUDE.md +0 -19
- package/skills/statistical-test-selector/package.json +0 -27
- package/skills/statistical-test-selector/src/index.ts +0 -75
- package/skills/statistical-test-selector/tsconfig.json +0 -10
- package/skills/test-suite-generator/SKILL.md +0 -51
- package/skills/test-suite-generator/package.json +0 -10
- package/skills/tmux-session/SKILL.md +0 -109
- package/skills/tmux-session/package.json +0 -33
- package/skills/tmux-session/src/index.ts +0 -34
- package/skills/tmux-session/tsconfig.json +0 -17
- package/skills/todos-plan/SKILL.md +0 -363
- package/skills/todos-plan/agents/openai.yaml +0 -4
- package/skills/todos-plan/package.json +0 -9
- package/skills/todos-plan/src/index.ts +0 -68
- package/skills/tsconfig.base.json +0 -12
- package/skills/validate-config/CLAUDE.md +0 -19
- package/skills/validate-config/package.json +0 -29
- package/skills/validate-config/src/index.ts +0 -56
- package/skills/validate-config/tsconfig.json +0 -10
- package/skills/video-downloader/CLAUDE.md +0 -19
- package/skills/video-downloader/package.json +0 -29
- package/skills/video-downloader/src/index.ts +0 -561
- package/skills/video-downloader/tsconfig.json +0 -10
- package/skills/video-highlight-pack/SKILL.md +0 -54
- package/skills/video-highlight-pack/package.json +0 -10
- package/skills/watermark/CLAUDE.md +0 -19
- package/skills/watermark/package.json +0 -32
- package/skills/watermark/src/index.ts +0 -587
- 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
|
-
});
|