@vodailoc/kilo-kit-mcp 1.1.0 → 1.1.1
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/.mcp/kilo-kit.codex-windows.toml +5 -0
- package/LICENSE +190 -190
- package/QUICKSTART.md +265 -255
- package/README.md +290 -266
- package/mcp/README.md +29 -5
- package/mcp/dist/server.js +1 -1
- package/mcp/package.json +1 -2
- package/package.json +3 -2
- package/skills/README.md +647 -647
- package/skills/SKILLS_INDEX.md +139 -139
- package/skills/ai-media/ai-multimodal/.env.example +97 -97
- package/skills/ai-media/ai-multimodal/SKILL.md +357 -357
- package/skills/ai-media/ai-multimodal/references/audio-processing.md +373 -373
- package/skills/ai-media/ai-multimodal/references/image-generation.md +558 -558
- package/skills/ai-media/ai-multimodal/references/video-analysis.md +502 -502
- package/skills/ai-media/ai-multimodal/references/vision-understanding.md +483 -483
- package/skills/ai-media/ai-multimodal/scripts/document_converter.py +395 -395
- package/skills/ai-media/ai-multimodal/scripts/gemini_batch_process.py +480 -480
- package/skills/ai-media/ai-multimodal/scripts/media_optimizer.py +506 -506
- package/skills/ai-media/ai-multimodal/scripts/requirements.txt +26 -26
- package/skills/ai-media/ai-multimodal/scripts/tests/requirements.txt +20 -20
- package/skills/ai-media/ai-multimodal/scripts/tests/test_document_converter.py +299 -299
- package/skills/ai-media/ai-multimodal/scripts/tests/test_gemini_batch_process.py +362 -362
- package/skills/ai-media/ai-multimodal/scripts/tests/test_media_optimizer.py +373 -373
- package/skills/ai-media/media-processing/SKILL.md +358 -358
- package/skills/ai-media/media-processing/references/ffmpeg-encoding.md +358 -358
- package/skills/ai-media/media-processing/references/ffmpeg-filters.md +503 -503
- package/skills/ai-media/media-processing/references/ffmpeg-streaming.md +403 -403
- package/skills/ai-media/media-processing/references/format-compatibility.md +375 -375
- package/skills/ai-media/media-processing/references/imagemagick-batch.md +612 -612
- package/skills/ai-media/media-processing/references/imagemagick-editing.md +623 -623
- package/skills/ai-media/media-processing/scripts/batch_resize.py +342 -342
- package/skills/ai-media/media-processing/scripts/media_convert.py +311 -311
- package/skills/ai-media/media-processing/scripts/requirements.txt +24 -24
- package/skills/ai-media/media-processing/scripts/tests/requirements.txt +2 -2
- package/skills/ai-media/media-processing/scripts/tests/test_batch_resize.py +372 -372
- package/skills/ai-media/media-processing/scripts/tests/test_media_convert.py +259 -259
- package/skills/ai-media/media-processing/scripts/tests/test_video_optimize.py +397 -397
- package/skills/ai-media/media-processing/scripts/video_optimize.py +414 -414
- package/skills/ai-media/screenshot/LICENSE.txt +201 -201
- package/skills/ai-media/screenshot/SKILL.md +267 -267
- package/skills/ai-media/screenshot/agents/openai.yaml +6 -6
- package/skills/ai-media/screenshot/assets/screenshot-small.svg +5 -5
- package/skills/ai-media/screenshot/scripts/ensure_macos_permissions.sh +54 -54
- package/skills/ai-media/screenshot/scripts/macos_display_info.swift +22 -22
- package/skills/ai-media/screenshot/scripts/macos_permissions.swift +40 -40
- package/skills/ai-media/screenshot/scripts/macos_window_info.swift +126 -126
- package/skills/ai-media/screenshot/scripts/take_screenshot.ps1 +163 -163
- package/skills/ai-media/screenshot/scripts/take_screenshot.py +585 -585
- package/skills/ai-media/sora/LICENSE.txt +201 -201
- package/skills/ai-media/sora/SKILL.md +153 -153
- package/skills/ai-media/sora/agents/openai.yaml +6 -6
- package/skills/ai-media/sora/assets/sora-small.svg +4 -4
- package/skills/ai-media/sora/references/cinematic-shots.md +53 -53
- package/skills/ai-media/sora/references/cli.md +248 -248
- package/skills/ai-media/sora/references/codex-network.md +28 -28
- package/skills/ai-media/sora/references/prompting.md +137 -137
- package/skills/ai-media/sora/references/sample-prompts.md +95 -95
- package/skills/ai-media/sora/references/social-ads.md +42 -42
- package/skills/ai-media/sora/references/troubleshooting.md +58 -58
- package/skills/ai-media/sora/references/video-api.md +45 -45
- package/skills/ai-media/sora/scripts/sora.py +970 -970
- package/skills/design/aesthetic/SKILL.md +121 -121
- package/skills/design/aesthetic/assets/design-guideline-template.md +163 -163
- package/skills/design/aesthetic/assets/design-story-template.md +135 -135
- package/skills/design/aesthetic/references/design-principles.md +62 -62
- package/skills/design/aesthetic/references/design-resources.md +75 -75
- package/skills/design/aesthetic/references/micro-interactions.md +53 -53
- package/skills/design/aesthetic/references/storytelling-design.md +50 -50
- package/skills/design/figma/LICENSE.txt +202 -202
- package/skills/design/figma/SKILL.md +42 -42
- package/skills/design/figma/agents/openai.yaml +14 -14
- package/skills/design/figma/assets/figma-small.svg +3 -3
- package/skills/design/figma/assets/icon.svg +28 -28
- package/skills/design/figma/references/figma-mcp-config.md +35 -35
- package/skills/design/figma/references/figma-tools-and-prompts.md +34 -34
- package/skills/design/figma-implement-design/LICENSE.txt +202 -202
- package/skills/design/figma-implement-design/SKILL.md +264 -264
- package/skills/design/figma-implement-design/agents/openai.yaml +14 -14
- package/skills/design/figma-implement-design/assets/figma-small.svg +3 -3
- package/skills/design/figma-implement-design/assets/icon.svg +28 -28
- package/skills/design/frontend-design/SKILL.md +41 -41
- package/skills/design/frontend-design/references/animejs.md +395 -395
- package/skills/design/ui-styling/LICENSE.txt +201 -201
- package/skills/design/ui-styling/SKILL.md +321 -321
- package/skills/design/ui-styling/canvas-fonts/ArsenalSC-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/BigShoulders-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/Boldonse-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/BricolageGrotesque-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/CrimsonPro-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/DMMono-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/EricaOne-OFL.txt +94 -94
- package/skills/design/ui-styling/canvas-fonts/GeistMono-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/Gloock-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/IBMPlexMono-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/InstrumentSans-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/Italiana-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/JetBrainsMono-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/Jura-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/LibreBaskerville-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/Lora-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/NationalPark-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/NothingYouCouldDo-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/Outfit-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/PixelifySans-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/PoiretOne-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/RedHatMono-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/Silkscreen-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/SmoochSans-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/Tektur-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/WorkSans-OFL.txt +93 -93
- package/skills/design/ui-styling/canvas-fonts/YoungSerif-OFL.txt +93 -93
- package/skills/design/ui-styling/references/canvas-design-system.md +320 -320
- package/skills/design/ui-styling/references/shadcn-accessibility.md +471 -471
- package/skills/design/ui-styling/references/shadcn-components.md +424 -424
- package/skills/design/ui-styling/references/shadcn-theming.md +373 -373
- package/skills/design/ui-styling/references/tailwind-customization.md +483 -483
- package/skills/design/ui-styling/references/tailwind-responsive.md +382 -382
- package/skills/design/ui-styling/references/tailwind-utilities.md +455 -455
- package/skills/design/ui-styling/scripts/requirements.txt +17 -17
- package/skills/design/ui-styling/scripts/shadcn_add.py +292 -292
- package/skills/design/ui-styling/scripts/tailwind_config_gen.py +456 -456
- package/skills/design/ui-styling/scripts/tests/requirements.txt +3 -3
- package/skills/design/ui-styling/scripts/tests/test_shadcn_add.py +266 -266
- package/skills/design/ui-styling/scripts/tests/test_tailwind_config_gen.py +336 -336
- package/skills/engineering/aspnet-core/LICENSE.txt +201 -201
- package/skills/engineering/aspnet-core/SKILL.md +61 -61
- package/skills/engineering/aspnet-core/agents/openai.yaml +5 -5
- package/skills/engineering/aspnet-core/references/_sections.md +40 -40
- package/skills/engineering/aspnet-core/references/apis-minimal-and-controllers.md +81 -81
- package/skills/engineering/aspnet-core/references/data-state-and-services.md +69 -69
- package/skills/engineering/aspnet-core/references/program-and-pipeline.md +103 -103
- package/skills/engineering/aspnet-core/references/realtime-grpc-and-background-work.md +58 -58
- package/skills/engineering/aspnet-core/references/security-and-identity.md +75 -75
- package/skills/engineering/aspnet-core/references/source-map.md +43 -43
- package/skills/engineering/aspnet-core/references/stack-selection.md +63 -63
- package/skills/engineering/aspnet-core/references/testing-performance-and-operations.md +92 -92
- package/skills/engineering/aspnet-core/references/ui-blazor.md +53 -53
- package/skills/engineering/aspnet-core/references/ui-mvc.md +56 -56
- package/skills/engineering/aspnet-core/references/ui-razor-pages.md +55 -55
- package/skills/engineering/aspnet-core/references/versioning-and-upgrades.md +51 -51
- package/skills/engineering/backend-development/SKILL.md +95 -95
- package/skills/engineering/backend-development/references/backend-api-design.md +495 -495
- package/skills/engineering/backend-development/references/backend-architecture.md +454 -454
- package/skills/engineering/backend-development/references/backend-authentication.md +338 -338
- package/skills/engineering/backend-development/references/backend-code-quality.md +659 -659
- package/skills/engineering/backend-development/references/backend-debugging.md +904 -904
- package/skills/engineering/backend-development/references/backend-devops.md +494 -494
- package/skills/engineering/backend-development/references/backend-mindset.md +387 -387
- package/skills/engineering/backend-development/references/backend-performance.md +397 -397
- package/skills/engineering/backend-development/references/backend-security.md +290 -290
- package/skills/engineering/backend-development/references/backend-technologies.md +256 -256
- package/skills/engineering/backend-development/references/backend-testing.md +429 -429
- package/skills/engineering/better-auth/SKILL.md +204 -204
- package/skills/engineering/better-auth/references/advanced-features.md +553 -553
- package/skills/engineering/better-auth/references/database-integration.md +577 -577
- package/skills/engineering/better-auth/references/email-password-auth.md +416 -416
- package/skills/engineering/better-auth/references/oauth-providers.md +430 -430
- package/skills/engineering/better-auth/scripts/better_auth_init.py +521 -521
- package/skills/engineering/better-auth/scripts/requirements.txt +15 -15
- package/skills/engineering/better-auth/scripts/tests/test_better_auth_init.py +421 -421
- package/skills/engineering/code-review/SKILL.md +140 -140
- package/skills/engineering/code-review/references/code-review-reception.md +208 -208
- package/skills/engineering/code-review/references/requesting-code-review.md +104 -104
- package/skills/engineering/code-review/references/verification-before-completion.md +138 -138
- package/skills/engineering/context-engineering/SKILL.md +86 -86
- package/skills/engineering/context-engineering/references/context-compression.md +84 -84
- package/skills/engineering/context-engineering/references/context-degradation.md +93 -93
- package/skills/engineering/context-engineering/references/context-fundamentals.md +75 -75
- package/skills/engineering/context-engineering/references/context-optimization.md +82 -82
- package/skills/engineering/context-engineering/references/evaluation.md +89 -89
- package/skills/engineering/context-engineering/references/memory-systems.md +88 -88
- package/skills/engineering/context-engineering/references/multi-agent-patterns.md +90 -90
- package/skills/engineering/context-engineering/references/project-development.md +97 -97
- package/skills/engineering/context-engineering/references/tool-design.md +86 -86
- package/skills/engineering/context-engineering/scripts/compression_evaluator.py +329 -329
- package/skills/engineering/context-engineering/scripts/context_analyzer.py +294 -294
- package/skills/engineering/databases/SKILL.md +232 -232
- package/skills/engineering/databases/references/mongodb-aggregation.md +447 -447
- package/skills/engineering/databases/references/mongodb-atlas.md +465 -465
- package/skills/engineering/databases/references/mongodb-crud.md +408 -408
- package/skills/engineering/databases/references/mongodb-indexing.md +442 -442
- package/skills/engineering/databases/references/postgresql-administration.md +594 -594
- package/skills/engineering/databases/references/postgresql-performance.md +527 -527
- package/skills/engineering/databases/references/postgresql-psql-cli.md +467 -467
- package/skills/engineering/databases/references/postgresql-queries.md +475 -475
- package/skills/engineering/databases/scripts/db_backup.py +502 -502
- package/skills/engineering/databases/scripts/db_migrate.py +414 -414
- package/skills/engineering/databases/scripts/db_performance_check.py +444 -444
- package/skills/engineering/databases/scripts/requirements.txt +20 -20
- package/skills/engineering/databases/scripts/tests/requirements.txt +4 -4
- package/skills/engineering/databases/scripts/tests/test_db_backup.py +340 -340
- package/skills/engineering/databases/scripts/tests/test_db_migrate.py +277 -277
- package/skills/engineering/databases/scripts/tests/test_db_performance_check.py +370 -370
- package/skills/engineering/diagnose/SKILL.md +117 -117
- package/skills/engineering/diagnose/scripts/hitl-loop.template.sh +41 -41
- package/skills/engineering/docs-seeker/SKILL.md +207 -207
- package/skills/engineering/docs-seeker/WORKFLOWS.md +505 -505
- package/skills/engineering/docs-seeker/references/best-practices.md +632 -632
- package/skills/engineering/docs-seeker/references/documentation-sources.md +461 -461
- package/skills/engineering/docs-seeker/references/error-handling.md +621 -621
- package/skills/engineering/docs-seeker/references/limitations.md +821 -821
- package/skills/engineering/docs-seeker/references/performance.md +574 -574
- package/skills/engineering/docs-seeker/references/tool-selection.md +262 -262
- package/skills/engineering/frontend-development/SKILL.md +398 -398
- package/skills/engineering/frontend-development/resources/common-patterns.md +330 -330
- package/skills/engineering/frontend-development/resources/complete-examples.md +871 -871
- package/skills/engineering/frontend-development/resources/component-patterns.md +501 -501
- package/skills/engineering/frontend-development/resources/data-fetching.md +766 -766
- package/skills/engineering/frontend-development/resources/file-organization.md +501 -501
- package/skills/engineering/frontend-development/resources/loading-and-error-states.md +500 -500
- package/skills/engineering/frontend-development/resources/performance.md +405 -405
- package/skills/engineering/frontend-development/resources/routing-guide.md +363 -363
- package/skills/engineering/frontend-development/resources/styling-guide.md +427 -427
- package/skills/engineering/frontend-development/resources/typescript-standards.md +417 -417
- package/skills/engineering/improve-codebase-architecture/DEEPENING.md +37 -37
- package/skills/engineering/improve-codebase-architecture/INTERFACE-DESIGN.md +44 -44
- package/skills/engineering/improve-codebase-architecture/LANGUAGE.md +53 -53
- package/skills/engineering/improve-codebase-architecture/SKILL.md +71 -71
- package/skills/engineering/openai-docs/LICENSE.txt +201 -201
- package/skills/engineering/openai-docs/SKILL.md +69 -69
- package/skills/engineering/openai-docs/agents/openai.yaml +14 -14
- package/skills/engineering/openai-docs/assets/openai-small.svg +3 -3
- package/skills/engineering/openai-docs/references/gpt-5p4-prompting-guide.md +433 -433
- package/skills/engineering/openai-docs/references/latest-model.md +35 -35
- package/skills/engineering/openai-docs/references/upgrading-to-gpt-5p4.md +164 -164
- package/skills/engineering/playwright/LICENSE.txt +201 -201
- package/skills/engineering/playwright/NOTICE.txt +14 -14
- package/skills/engineering/playwright/SKILL.md +147 -147
- package/skills/engineering/playwright/agents/openai.yaml +6 -6
- package/skills/engineering/playwright/assets/playwright-small.svg +3 -3
- package/skills/engineering/playwright/references/cli.md +116 -116
- package/skills/engineering/playwright/references/workflows.md +95 -95
- package/skills/engineering/playwright/scripts/playwright_cli.sh +25 -25
- package/skills/engineering/playwright-interactive/LICENSE.txt +201 -201
- package/skills/engineering/playwright-interactive/NOTICE.txt +13 -13
- package/skills/engineering/playwright-interactive/SKILL.md +689 -689
- package/skills/engineering/playwright-interactive/agents/openai.yaml +6 -6
- package/skills/engineering/playwright-interactive/assets/playwright-small.svg +3 -3
- package/skills/engineering/render-deploy/LICENSE.txt +201 -201
- package/skills/engineering/render-deploy/SKILL.md +479 -479
- package/skills/engineering/render-deploy/agents/openai.yaml +14 -14
- package/skills/engineering/render-deploy/assets/docker.yaml +62 -62
- package/skills/engineering/render-deploy/assets/go-api.yaml +35 -35
- package/skills/engineering/render-deploy/assets/nextjs-postgres.yaml +35 -35
- package/skills/engineering/render-deploy/assets/node-express.yaml +25 -25
- package/skills/engineering/render-deploy/assets/python-django.yaml +89 -89
- package/skills/engineering/render-deploy/assets/render-small.svg +3 -3
- package/skills/engineering/render-deploy/assets/static-site.yaml +54 -54
- package/skills/engineering/render-deploy/references/blueprint-spec.md +718 -718
- package/skills/engineering/render-deploy/references/codebase-analysis.md +49 -49
- package/skills/engineering/render-deploy/references/configuration-guide.md +603 -603
- package/skills/engineering/render-deploy/references/deployment-details.md +224 -224
- package/skills/engineering/render-deploy/references/direct-creation.md +113 -113
- package/skills/engineering/render-deploy/references/error-patterns.md +13 -13
- package/skills/engineering/render-deploy/references/post-deploy-checks.md +36 -36
- package/skills/engineering/render-deploy/references/runtimes.md +473 -473
- package/skills/engineering/render-deploy/references/service-types.md +450 -450
- package/skills/engineering/render-deploy/references/troubleshooting-basics.md +36 -36
- package/skills/engineering/repomix/SKILL.md +215 -215
- package/skills/engineering/repomix/references/configuration.md +211 -211
- package/skills/engineering/repomix/references/usage-patterns.md +232 -232
- package/skills/engineering/repomix/scripts/README.md +179 -179
- package/skills/engineering/repomix/scripts/repomix_batch.py +455 -455
- package/skills/engineering/repomix/scripts/repos.example.json +15 -15
- package/skills/engineering/repomix/scripts/requirements.txt +15 -15
- package/skills/engineering/repomix/scripts/tests/test_repomix_batch.py +531 -531
- package/skills/engineering/setup-matt-pocock-skills/SKILL.md +121 -121
- package/skills/engineering/setup-matt-pocock-skills/domain.md +51 -51
- package/skills/engineering/setup-matt-pocock-skills/issue-tracker-github.md +22 -22
- package/skills/engineering/setup-matt-pocock-skills/issue-tracker-gitlab.md +23 -23
- package/skills/engineering/setup-matt-pocock-skills/issue-tracker-local.md +19 -19
- package/skills/engineering/setup-matt-pocock-skills/triage-labels.md +15 -15
- package/skills/engineering/shopify/README.md +66 -66
- package/skills/engineering/shopify/SKILL.md +319 -319
- package/skills/engineering/shopify/references/app-development.md +470 -470
- package/skills/engineering/shopify/references/extensions.md +493 -493
- package/skills/engineering/shopify/references/themes.md +498 -498
- package/skills/engineering/shopify/scripts/requirements.txt +19 -19
- package/skills/engineering/shopify/scripts/shopify_init.py +423 -423
- package/skills/engineering/shopify/scripts/tests/test_shopify_init.py +385 -385
- package/skills/engineering/tdd/SKILL.md +109 -109
- package/skills/engineering/tdd/deep-modules.md +33 -33
- package/skills/engineering/tdd/interface-design.md +31 -31
- package/skills/engineering/tdd/mocking.md +59 -59
- package/skills/engineering/tdd/refactoring.md +10 -10
- package/skills/engineering/tdd/tests.md +61 -61
- package/skills/engineering/to-issues/SKILL.md +81 -81
- package/skills/engineering/to-prd/SKILL.md +74 -74
- package/skills/engineering/triage/AGENT-BRIEF.md +168 -168
- package/skills/engineering/triage/OUT-OF-SCOPE.md +101 -101
- package/skills/engineering/triage/SKILL.md +103 -103
- package/skills/engineering/web-frameworks/SKILL.md +324 -324
- package/skills/engineering/web-frameworks/references/nextjs-app-router.md +465 -465
- package/skills/engineering/web-frameworks/references/nextjs-data-fetching.md +459 -459
- package/skills/engineering/web-frameworks/references/nextjs-optimization.md +511 -511
- package/skills/engineering/web-frameworks/references/nextjs-server-components.md +495 -495
- package/skills/engineering/web-frameworks/references/remix-icon-integration.md +603 -603
- package/skills/engineering/web-frameworks/references/turborepo-caching.md +551 -551
- package/skills/engineering/web-frameworks/references/turborepo-pipelines.md +517 -517
- package/skills/engineering/web-frameworks/references/turborepo-setup.md +542 -542
- package/skills/engineering/web-frameworks/scripts/nextjs_init.py +547 -547
- package/skills/engineering/web-frameworks/scripts/requirements.txt +16 -16
- package/skills/engineering/web-frameworks/scripts/tests/requirements.txt +3 -3
- package/skills/engineering/web-frameworks/scripts/tests/test_nextjs_init.py +319 -319
- package/skills/engineering/web-frameworks/scripts/tests/test_turborepo_migrate.py +374 -374
- package/skills/engineering/web-frameworks/scripts/turborepo_migrate.py +394 -394
- package/skills/engineering/write-a-skill/SKILL.md +117 -117
- package/skills/kilo-kit/SKILL.md +346 -346
- package/skills/kilo-kit/_template/SKILL.md +185 -185
- package/skills/kilo-kit/debugging/root-cause/SKILL.md +360 -360
- package/skills/kilo-kit/debugging/systematic/SKILL.md +339 -339
- package/skills/kilo-kit/debugging/verification/SKILL.md +424 -424
- package/skills/kilo-kit/development/backend/SKILL.md +540 -540
- package/skills/kilo-kit/development/security/SKILL.md +529 -529
- package/skills/kilo-kit/quality/code-review/SKILL.md +297 -297
- package/skills/kilo-kit/quality/testing/SKILL.md +540 -540
- package/skills/kilo-kit/references/output-formats.md +204 -204
- package/skills/kilo-kit/references/patterns.md +156 -156
- package/skills/kilo-kit/references/performance-benchmarks.md +90 -90
- package/skills/operations/chrome-devtools/SKILL.md +392 -392
- package/skills/operations/chrome-devtools/references/cdp-domains.md +694 -694
- package/skills/operations/chrome-devtools/references/performance-guide.md +940 -940
- package/skills/operations/chrome-devtools/references/puppeteer-reference.md +953 -953
- package/skills/operations/chrome-devtools/scripts/PERSISTENT-BROWSER.md +107 -107
- package/skills/operations/chrome-devtools/scripts/README.md +213 -213
- package/skills/operations/chrome-devtools/scripts/__tests__/selector.test.js +210 -210
- package/skills/operations/chrome-devtools/scripts/click.js +79 -79
- package/skills/operations/chrome-devtools/scripts/close-persistent.js +36 -36
- package/skills/operations/chrome-devtools/scripts/console.js +75 -75
- package/skills/operations/chrome-devtools/scripts/evaluate.js +49 -49
- package/skills/operations/chrome-devtools/scripts/fill.js +72 -72
- package/skills/operations/chrome-devtools/scripts/install-deps.sh +181 -181
- package/skills/operations/chrome-devtools/scripts/install.sh +83 -83
- package/skills/operations/chrome-devtools/scripts/launch-persistent.js +71 -71
- package/skills/operations/chrome-devtools/scripts/lib/browser.js +144 -144
- package/skills/operations/chrome-devtools/scripts/lib/selector.js +178 -178
- package/skills/operations/chrome-devtools/scripts/navigate.js +46 -46
- package/skills/operations/chrome-devtools/scripts/network.js +102 -102
- package/skills/operations/chrome-devtools/scripts/package-lock.json +1206 -1206
- package/skills/operations/chrome-devtools/scripts/package.json +15 -15
- package/skills/operations/chrome-devtools/scripts/performance.js +145 -145
- package/skills/operations/chrome-devtools/scripts/screenshot.js +180 -180
- package/skills/operations/chrome-devtools/scripts/snapshot.js +131 -131
- package/skills/operations/devops/.env.example +76 -76
- package/skills/operations/devops/SKILL.md +285 -285
- package/skills/operations/devops/references/browser-rendering.md +305 -305
- package/skills/operations/devops/references/cloudflare-d1-kv.md +123 -123
- package/skills/operations/devops/references/cloudflare-platform.md +271 -271
- package/skills/operations/devops/references/cloudflare-r2-storage.md +280 -280
- package/skills/operations/devops/references/cloudflare-workers-advanced.md +312 -312
- package/skills/operations/devops/references/cloudflare-workers-apis.md +309 -309
- package/skills/operations/devops/references/cloudflare-workers-basics.md +418 -418
- package/skills/operations/devops/references/docker-basics.md +297 -297
- package/skills/operations/devops/references/docker-compose.md +292 -292
- package/skills/operations/devops/references/gcloud-platform.md +297 -297
- package/skills/operations/devops/references/gcloud-services.md +304 -304
- package/skills/operations/devops/scripts/cloudflare_deploy.py +269 -269
- package/skills/operations/devops/scripts/docker_optimize.py +320 -320
- package/skills/operations/devops/scripts/requirements.txt +20 -20
- package/skills/operations/devops/scripts/tests/requirements.txt +3 -3
- package/skills/operations/devops/scripts/tests/test_cloudflare_deploy.py +285 -285
- package/skills/operations/devops/scripts/tests/test_docker_optimize.py +436 -436
- package/skills/operations/mcp-builder/LICENSE.txt +201 -201
- package/skills/operations/mcp-builder/SKILL.md +328 -328
- package/skills/operations/mcp-builder/reference/evaluation.md +601 -601
- package/skills/operations/mcp-builder/reference/mcp_best_practices.md +915 -915
- package/skills/operations/mcp-builder/reference/node_mcp_server.md +915 -915
- package/skills/operations/mcp-builder/reference/python_mcp_server.md +751 -751
- package/skills/operations/mcp-builder/scripts/connections.py +151 -151
- package/skills/operations/mcp-builder/scripts/evaluation.py +373 -373
- package/skills/operations/mcp-builder/scripts/example_evaluation.xml +22 -22
- package/skills/operations/mcp-builder/scripts/requirements.txt +2 -2
- package/skills/operations/mcp-management/README.md +219 -219
- package/skills/operations/mcp-management/SKILL.md +175 -175
- package/skills/operations/mcp-management/assets/tools.json +3043 -3043
- package/skills/operations/mcp-management/references/configuration.md +114 -114
- package/skills/operations/mcp-management/references/gemini-cli-integration.md +201 -201
- package/skills/operations/mcp-management/references/mcp-protocol.md +116 -116
- package/skills/operations/mcp-management/scripts/.env.example +10 -10
- package/skills/operations/mcp-management/scripts/cli.ts +155 -155
- package/skills/operations/mcp-management/scripts/dist/analyze-tools.js +70 -70
- package/skills/operations/mcp-management/scripts/dist/cli.js +131 -131
- package/skills/operations/mcp-management/scripts/dist/mcp-client.js +115 -115
- package/skills/operations/mcp-management/scripts/mcp-client.ts +163 -163
- package/skills/operations/mcp-management/scripts/package.json +18 -18
- package/skills/operations/mcp-management/scripts/tsconfig.json +15 -15
- package/skills/problem-solving/collision-zone-thinking/SKILL.md +62 -62
- package/skills/problem-solving/defense-in-depth/SKILL.md +130 -130
- package/skills/problem-solving/inversion-exercise/SKILL.md +58 -58
- package/skills/problem-solving/meta-pattern-recognition/SKILL.md +54 -54
- package/skills/problem-solving/root-cause-tracing/SKILL.md +177 -177
- package/skills/problem-solving/root-cause-tracing/find-polluter.sh +63 -63
- package/skills/problem-solving/scale-game/SKILL.md +63 -63
- package/skills/problem-solving/sequential-thinking/README.md +118 -118
- package/skills/problem-solving/sequential-thinking/SKILL.md +93 -93
- package/skills/problem-solving/sequential-thinking/references/advanced.md +122 -122
- package/skills/problem-solving/sequential-thinking/references/examples.md +274 -274
- package/skills/problem-solving/simplification-cascades/SKILL.md +76 -76
- package/skills/problem-solving/when-stuck/SKILL.md +88 -88
- package/skills/productivity/caveman/SKILL.md +49 -49
- package/skills/productivity/grill-me/SKILL.md +10 -10
- package/skills/productivity/grill-with-docs/ADR-FORMAT.md +47 -47
- package/skills/productivity/grill-with-docs/CONTEXT-FORMAT.md +77 -77
- package/skills/productivity/grill-with-docs/SKILL.md +88 -88
- package/skills/productivity/writing-skills/graphviz-conventions.dot +171 -171
- package/skills/productivity/zoom-out/SKILL.md +7 -7
- package/skills/writing-docs/doc/LICENSE.txt +201 -201
- package/skills/writing-docs/doc/SKILL.md +80 -80
- package/skills/writing-docs/doc/agents/openai.yaml +6 -6
- package/skills/writing-docs/doc/assets/doc-small.svg +3 -3
- package/skills/writing-docs/doc/scripts/render_docx.py +296 -296
- package/skills/writing-docs/docx/LICENSE.txt +30 -30
- package/skills/writing-docs/docx/SKILL.md +196 -196
- package/skills/writing-docs/docx/docx-js.md +349 -349
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-chart.xsd +1499 -1499
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-chartDrawing.xsd +146 -146
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-diagram.xsd +1085 -1085
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-lockedCanvas.xsd +11 -11
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-main.xsd +3081 -3081
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-picture.xsd +23 -23
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-spreadsheetDrawing.xsd +185 -185
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-wordprocessingDrawing.xsd +287 -287
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/pml.xsd +1676 -1676
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-additionalCharacteristics.xsd +28 -28
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-bibliography.xsd +144 -144
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-commonSimpleTypes.xsd +174 -174
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlDataProperties.xsd +25 -25
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlSchemaProperties.xsd +18 -18
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd +59 -59
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesExtended.xsd +56 -56
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesVariantTypes.xsd +195 -195
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-math.xsd +582 -582
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-relationshipReference.xsd +25 -25
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/sml.xsd +4439 -4439
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-main.xsd +570 -570
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-officeDrawing.xsd +509 -509
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-presentationDrawing.xsd +12 -12
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-spreadsheetDrawing.xsd +108 -108
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-wordprocessingDrawing.xsd +96 -96
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/wml.xsd +3646 -3646
- package/skills/writing-docs/docx/ooxml/schemas/ISO-IEC29500-4_2016/xml.xsd +116 -116
- package/skills/writing-docs/docx/ooxml/schemas/ecma/fouth-edition/opc-contentTypes.xsd +42 -42
- package/skills/writing-docs/docx/ooxml/schemas/ecma/fouth-edition/opc-coreProperties.xsd +50 -50
- package/skills/writing-docs/docx/ooxml/schemas/ecma/fouth-edition/opc-digSig.xsd +49 -49
- package/skills/writing-docs/docx/ooxml/schemas/ecma/fouth-edition/opc-relationships.xsd +33 -33
- package/skills/writing-docs/docx/ooxml/schemas/mce/mc.xsd +75 -75
- package/skills/writing-docs/docx/ooxml/schemas/microsoft/wml-2010.xsd +560 -560
- package/skills/writing-docs/docx/ooxml/schemas/microsoft/wml-2012.xsd +67 -67
- package/skills/writing-docs/docx/ooxml/schemas/microsoft/wml-2018.xsd +14 -14
- package/skills/writing-docs/docx/ooxml/schemas/microsoft/wml-cex-2018.xsd +20 -20
- package/skills/writing-docs/docx/ooxml/schemas/microsoft/wml-cid-2016.xsd +13 -13
- package/skills/writing-docs/docx/ooxml/schemas/microsoft/wml-sdtdatahash-2020.xsd +4 -4
- package/skills/writing-docs/docx/ooxml/schemas/microsoft/wml-symex-2015.xsd +8 -8
- package/skills/writing-docs/docx/ooxml/scripts/pack.py +159 -159
- package/skills/writing-docs/docx/ooxml/scripts/unpack.py +29 -29
- package/skills/writing-docs/docx/ooxml/scripts/validate.py +69 -69
- package/skills/writing-docs/docx/ooxml/scripts/validation/__init__.py +15 -15
- package/skills/writing-docs/docx/ooxml/scripts/validation/base.py +951 -951
- package/skills/writing-docs/docx/ooxml/scripts/validation/docx.py +274 -274
- package/skills/writing-docs/docx/ooxml/scripts/validation/pptx.py +315 -315
- package/skills/writing-docs/docx/ooxml/scripts/validation/redlining.py +279 -279
- package/skills/writing-docs/docx/ooxml.md +609 -609
- package/skills/writing-docs/docx/scripts/__init__.py +1 -1
- package/skills/writing-docs/docx/scripts/document.py +1276 -1276
- package/skills/writing-docs/docx/scripts/templates/comments.xml +2 -2
- package/skills/writing-docs/docx/scripts/templates/commentsExtended.xml +2 -2
- package/skills/writing-docs/docx/scripts/templates/commentsExtensible.xml +2 -2
- package/skills/writing-docs/docx/scripts/templates/commentsIds.xml +2 -2
- package/skills/writing-docs/docx/scripts/templates/people.xml +2 -2
- package/skills/writing-docs/docx/scripts/utilities.py +374 -374
- package/skills/writing-docs/mermaidjs-v11/SKILL.md +115 -115
- package/skills/writing-docs/mermaidjs-v11/references/cli-usage.md +228 -228
- package/skills/writing-docs/mermaidjs-v11/references/configuration.md +232 -232
- package/skills/writing-docs/mermaidjs-v11/references/diagram-types.md +315 -315
- package/skills/writing-docs/mermaidjs-v11/references/examples.md +344 -344
- package/skills/writing-docs/mermaidjs-v11/references/integration.md +310 -310
- package/skills/writing-docs/pdf/LICENSE.txt +30 -30
- package/skills/writing-docs/pdf/SKILL.md +294 -294
- package/skills/writing-docs/pdf/forms.md +205 -205
- package/skills/writing-docs/pdf/reference.md +611 -611
- package/skills/writing-docs/pdf/scripts/check_bounding_boxes.py +70 -70
- package/skills/writing-docs/pdf/scripts/check_bounding_boxes_test.py +226 -226
- package/skills/writing-docs/pdf/scripts/check_fillable_fields.py +12 -12
- package/skills/writing-docs/pdf/scripts/convert_pdf_to_images.py +35 -35
- package/skills/writing-docs/pdf/scripts/create_validation_image.py +41 -41
- package/skills/writing-docs/pdf/scripts/extract_form_field_info.py +152 -152
- package/skills/writing-docs/pdf/scripts/fill_fillable_fields.py +114 -114
- package/skills/writing-docs/pdf/scripts/fill_pdf_form_with_annotations.py +107 -107
- package/skills/writing-docs/pptx/LICENSE.txt +30 -30
- package/skills/writing-docs/pptx/SKILL.md +483 -483
- package/skills/writing-docs/pptx/html2pptx.md +624 -624
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-chart.xsd +1499 -1499
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-chartDrawing.xsd +146 -146
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-diagram.xsd +1085 -1085
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-lockedCanvas.xsd +11 -11
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-main.xsd +3081 -3081
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-picture.xsd +23 -23
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-spreadsheetDrawing.xsd +185 -185
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-wordprocessingDrawing.xsd +287 -287
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/pml.xsd +1676 -1676
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-additionalCharacteristics.xsd +28 -28
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-bibliography.xsd +144 -144
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-commonSimpleTypes.xsd +174 -174
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlDataProperties.xsd +25 -25
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlSchemaProperties.xsd +18 -18
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd +59 -59
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesExtended.xsd +56 -56
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesVariantTypes.xsd +195 -195
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-math.xsd +582 -582
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-relationshipReference.xsd +25 -25
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/sml.xsd +4439 -4439
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-main.xsd +570 -570
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-officeDrawing.xsd +509 -509
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-presentationDrawing.xsd +12 -12
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-spreadsheetDrawing.xsd +108 -108
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-wordprocessingDrawing.xsd +96 -96
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/wml.xsd +3646 -3646
- package/skills/writing-docs/pptx/ooxml/schemas/ISO-IEC29500-4_2016/xml.xsd +116 -116
- package/skills/writing-docs/pptx/ooxml/schemas/ecma/fouth-edition/opc-contentTypes.xsd +42 -42
- package/skills/writing-docs/pptx/ooxml/schemas/ecma/fouth-edition/opc-coreProperties.xsd +50 -50
- package/skills/writing-docs/pptx/ooxml/schemas/ecma/fouth-edition/opc-digSig.xsd +49 -49
- package/skills/writing-docs/pptx/ooxml/schemas/ecma/fouth-edition/opc-relationships.xsd +33 -33
- package/skills/writing-docs/pptx/ooxml/schemas/mce/mc.xsd +75 -75
- package/skills/writing-docs/pptx/ooxml/schemas/microsoft/wml-2010.xsd +560 -560
- package/skills/writing-docs/pptx/ooxml/schemas/microsoft/wml-2012.xsd +67 -67
- package/skills/writing-docs/pptx/ooxml/schemas/microsoft/wml-2018.xsd +14 -14
- package/skills/writing-docs/pptx/ooxml/schemas/microsoft/wml-cex-2018.xsd +20 -20
- package/skills/writing-docs/pptx/ooxml/schemas/microsoft/wml-cid-2016.xsd +13 -13
- package/skills/writing-docs/pptx/ooxml/schemas/microsoft/wml-sdtdatahash-2020.xsd +4 -4
- package/skills/writing-docs/pptx/ooxml/schemas/microsoft/wml-symex-2015.xsd +8 -8
- package/skills/writing-docs/pptx/ooxml/scripts/pack.py +159 -159
- package/skills/writing-docs/pptx/ooxml/scripts/unpack.py +29 -29
- package/skills/writing-docs/pptx/ooxml/scripts/validate.py +69 -69
- package/skills/writing-docs/pptx/ooxml/scripts/validation/__init__.py +15 -15
- package/skills/writing-docs/pptx/ooxml/scripts/validation/base.py +951 -951
- package/skills/writing-docs/pptx/ooxml/scripts/validation/docx.py +274 -274
- package/skills/writing-docs/pptx/ooxml/scripts/validation/pptx.py +315 -315
- package/skills/writing-docs/pptx/ooxml/scripts/validation/redlining.py +279 -279
- package/skills/writing-docs/pptx/ooxml.md +426 -426
- package/skills/writing-docs/pptx/scripts/html2pptx.js +978 -978
- package/skills/writing-docs/pptx/scripts/inventory.py +1020 -1020
- package/skills/writing-docs/pptx/scripts/rearrange.py +231 -231
- package/skills/writing-docs/pptx/scripts/replace.py +385 -385
- package/skills/writing-docs/pptx/scripts/thumbnail.py +450 -450
- package/skills/writing-docs/slides/LICENSE.txt +201 -201
- package/skills/writing-docs/slides/SKILL.md +71 -71
- package/skills/writing-docs/slides/agents/openai.yaml +6 -6
- package/skills/writing-docs/slides/assets/pptxgenjs_helpers/code.js +104 -104
- package/skills/writing-docs/slides/assets/pptxgenjs_helpers/image.js +333 -333
- package/skills/writing-docs/slides/assets/pptxgenjs_helpers/index.js +33 -33
- package/skills/writing-docs/slides/assets/pptxgenjs_helpers/latex.js +51 -51
- package/skills/writing-docs/slides/assets/pptxgenjs_helpers/layout.js +643 -643
- package/skills/writing-docs/slides/assets/pptxgenjs_helpers/layout_builders.js +358 -358
- package/skills/writing-docs/slides/assets/pptxgenjs_helpers/svg.js +36 -36
- package/skills/writing-docs/slides/assets/pptxgenjs_helpers/text.js +789 -789
- package/skills/writing-docs/slides/assets/pptxgenjs_helpers/util.js +24 -24
- package/skills/writing-docs/slides/assets/slides-small.svg +3 -3
- package/skills/writing-docs/slides/references/pptxgenjs-helpers.md +61 -61
- package/skills/writing-docs/slides/scripts/create_montage.py +300 -300
- package/skills/writing-docs/slides/scripts/detect_font.py +873 -873
- package/skills/writing-docs/slides/scripts/ensure_raster_image.py +202 -202
- package/skills/writing-docs/slides/scripts/render_slides.py +273 -273
- package/skills/writing-docs/slides/scripts/slides_test.py +201 -201
- package/skills/writing-docs/template-skill/SKILL.md +26 -26
- package/skills/writing-docs/xlsx/LICENSE.txt +30 -30
- package/skills/writing-docs/xlsx/SKILL.md +288 -288
- package/skills/writing-docs/xlsx/recalc.py +177 -177
- package/src/core/KILO_MASTER.md +448 -448
- package/src/tools/validate-skill.js +421 -421
|
@@ -1,521 +1,521 @@
|
|
|
1
|
-
#!/usr/bin/env python3
|
|
2
|
-
"""
|
|
3
|
-
Better Auth Initialization Script
|
|
4
|
-
|
|
5
|
-
Interactive script to initialize Better Auth configuration.
|
|
6
|
-
Supports multiple databases, ORMs, and authentication methods.
|
|
7
|
-
|
|
8
|
-
.env loading order: process.env > skill/.env > skills/.env > .claude/.env
|
|
9
|
-
"""
|
|
10
|
-
|
|
11
|
-
import os
|
|
12
|
-
import sys
|
|
13
|
-
import json
|
|
14
|
-
import secrets
|
|
15
|
-
from pathlib import Path
|
|
16
|
-
from typing import Optional, Dict, Any, List
|
|
17
|
-
from dataclasses import dataclass
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
@dataclass
|
|
21
|
-
class EnvConfig:
|
|
22
|
-
"""Environment configuration holder."""
|
|
23
|
-
secret: str
|
|
24
|
-
url: str
|
|
25
|
-
database_url: Optional[str] = None
|
|
26
|
-
github_client_id: Optional[str] = None
|
|
27
|
-
github_client_secret: Optional[str] = None
|
|
28
|
-
google_client_id: Optional[str] = None
|
|
29
|
-
google_client_secret: Optional[str] = None
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
class BetterAuthInit:
|
|
33
|
-
"""Better Auth configuration initializer."""
|
|
34
|
-
|
|
35
|
-
def __init__(self, project_root: Optional[Path] = None):
|
|
36
|
-
"""
|
|
37
|
-
Initialize the Better Auth configuration tool.
|
|
38
|
-
|
|
39
|
-
Args:
|
|
40
|
-
project_root: Project root directory. Auto-detected if not provided.
|
|
41
|
-
"""
|
|
42
|
-
self.project_root = project_root or self._find_project_root()
|
|
43
|
-
self.env_config: Optional[EnvConfig] = None
|
|
44
|
-
|
|
45
|
-
@staticmethod
|
|
46
|
-
def _find_project_root() -> Path:
|
|
47
|
-
"""
|
|
48
|
-
Find project root by looking for package.json.
|
|
49
|
-
|
|
50
|
-
Returns:
|
|
51
|
-
Path to project root.
|
|
52
|
-
|
|
53
|
-
Raises:
|
|
54
|
-
RuntimeError: If project root cannot be found.
|
|
55
|
-
"""
|
|
56
|
-
current = Path.cwd()
|
|
57
|
-
while current != current.parent:
|
|
58
|
-
if (current / "package.json").exists():
|
|
59
|
-
return current
|
|
60
|
-
current = current.parent
|
|
61
|
-
|
|
62
|
-
raise RuntimeError("Could not find project root (no package.json found)")
|
|
63
|
-
|
|
64
|
-
def _load_env_files(self) -> Dict[str, str]:
|
|
65
|
-
"""
|
|
66
|
-
Load environment variables from .env files in order.
|
|
67
|
-
|
|
68
|
-
Loading order: process.env > skill/.env > skills/.env > .claude/.env
|
|
69
|
-
|
|
70
|
-
Returns:
|
|
71
|
-
Dictionary of environment variables.
|
|
72
|
-
"""
|
|
73
|
-
env_vars = {}
|
|
74
|
-
|
|
75
|
-
# Define search paths in reverse priority order
|
|
76
|
-
skill_dir = Path(__file__).parent.parent
|
|
77
|
-
env_paths = [
|
|
78
|
-
self.project_root / ".claude" / ".env",
|
|
79
|
-
self.project_root / ".claude" / "skills" / ".env",
|
|
80
|
-
skill_dir / ".env",
|
|
81
|
-
]
|
|
82
|
-
|
|
83
|
-
# Load from files (lowest priority first)
|
|
84
|
-
for env_path in env_paths:
|
|
85
|
-
if env_path.exists():
|
|
86
|
-
env_vars.update(self._parse_env_file(env_path))
|
|
87
|
-
|
|
88
|
-
# Override with process environment (highest priority)
|
|
89
|
-
env_vars.update(os.environ)
|
|
90
|
-
|
|
91
|
-
return env_vars
|
|
92
|
-
|
|
93
|
-
@staticmethod
|
|
94
|
-
def _parse_env_file(path: Path) -> Dict[str, str]:
|
|
95
|
-
"""
|
|
96
|
-
Parse .env file into dictionary.
|
|
97
|
-
|
|
98
|
-
Args:
|
|
99
|
-
path: Path to .env file.
|
|
100
|
-
|
|
101
|
-
Returns:
|
|
102
|
-
Dictionary of key-value pairs.
|
|
103
|
-
"""
|
|
104
|
-
env_vars = {}
|
|
105
|
-
try:
|
|
106
|
-
with open(path, "r") as f:
|
|
107
|
-
for line in f:
|
|
108
|
-
line = line.strip()
|
|
109
|
-
if line and not line.startswith("#") and "=" in line:
|
|
110
|
-
key, value = line.split("=", 1)
|
|
111
|
-
# Remove quotes if present
|
|
112
|
-
value = value.strip().strip('"').strip("'")
|
|
113
|
-
env_vars[key.strip()] = value
|
|
114
|
-
except Exception as e:
|
|
115
|
-
print(f"Warning: Could not parse {path}: {e}")
|
|
116
|
-
|
|
117
|
-
return env_vars
|
|
118
|
-
|
|
119
|
-
@staticmethod
|
|
120
|
-
def generate_secret(length: int = 32) -> str:
|
|
121
|
-
"""
|
|
122
|
-
Generate cryptographically secure random secret.
|
|
123
|
-
|
|
124
|
-
Args:
|
|
125
|
-
length: Length of secret in bytes.
|
|
126
|
-
|
|
127
|
-
Returns:
|
|
128
|
-
Hex-encoded secret string.
|
|
129
|
-
"""
|
|
130
|
-
return secrets.token_hex(length)
|
|
131
|
-
|
|
132
|
-
def prompt_database(self) -> Dict[str, Any]:
|
|
133
|
-
"""
|
|
134
|
-
Prompt user for database configuration.
|
|
135
|
-
|
|
136
|
-
Returns:
|
|
137
|
-
Database configuration dictionary.
|
|
138
|
-
"""
|
|
139
|
-
print("\nDatabase Configuration")
|
|
140
|
-
print("=" * 50)
|
|
141
|
-
print("1. Direct Connection (PostgreSQL/MySQL/SQLite)")
|
|
142
|
-
print("2. Drizzle ORM")
|
|
143
|
-
print("3. Prisma")
|
|
144
|
-
print("4. Kysely")
|
|
145
|
-
print("5. MongoDB")
|
|
146
|
-
|
|
147
|
-
choice = input("\nSelect database option (1-5): ").strip()
|
|
148
|
-
|
|
149
|
-
db_configs = {
|
|
150
|
-
"1": self._prompt_direct_db,
|
|
151
|
-
"2": self._prompt_drizzle,
|
|
152
|
-
"3": self._prompt_prisma,
|
|
153
|
-
"4": self._prompt_kysely,
|
|
154
|
-
"5": self._prompt_mongodb,
|
|
155
|
-
}
|
|
156
|
-
|
|
157
|
-
handler = db_configs.get(choice)
|
|
158
|
-
if not handler:
|
|
159
|
-
print("Invalid choice. Defaulting to direct PostgreSQL.")
|
|
160
|
-
return self._prompt_direct_db()
|
|
161
|
-
|
|
162
|
-
return handler()
|
|
163
|
-
|
|
164
|
-
def _prompt_direct_db(self) -> Dict[str, Any]:
|
|
165
|
-
"""Prompt for direct database connection."""
|
|
166
|
-
print("\nDatabase Type:")
|
|
167
|
-
print("1. PostgreSQL")
|
|
168
|
-
print("2. MySQL")
|
|
169
|
-
print("3. SQLite")
|
|
170
|
-
|
|
171
|
-
db_type = input("Select (1-3): ").strip()
|
|
172
|
-
|
|
173
|
-
if db_type == "3":
|
|
174
|
-
db_path = input("SQLite file path [./dev.db]: ").strip() or "./dev.db"
|
|
175
|
-
return {
|
|
176
|
-
"type": "sqlite",
|
|
177
|
-
"import": "import Database from 'better-sqlite3';",
|
|
178
|
-
"config": f'database: new Database("{db_path}")'
|
|
179
|
-
}
|
|
180
|
-
elif db_type == "2":
|
|
181
|
-
db_url = input("MySQL connection string: ").strip()
|
|
182
|
-
return {
|
|
183
|
-
"type": "mysql",
|
|
184
|
-
"import": "import { createPool } from 'mysql2/promise';",
|
|
185
|
-
"config": f"database: createPool({{ connectionString: process.env.DATABASE_URL }})",
|
|
186
|
-
"env_var": ("DATABASE_URL", db_url)
|
|
187
|
-
}
|
|
188
|
-
else:
|
|
189
|
-
db_url = input("PostgreSQL connection string: ").strip()
|
|
190
|
-
return {
|
|
191
|
-
"type": "postgresql",
|
|
192
|
-
"import": "import { Pool } from 'pg';",
|
|
193
|
-
"config": "database: new Pool({ connectionString: process.env.DATABASE_URL })",
|
|
194
|
-
"env_var": ("DATABASE_URL", db_url)
|
|
195
|
-
}
|
|
196
|
-
|
|
197
|
-
def _prompt_drizzle(self) -> Dict[str, Any]:
|
|
198
|
-
"""Prompt for Drizzle ORM configuration."""
|
|
199
|
-
print("\nDrizzle Provider:")
|
|
200
|
-
print("1. PostgreSQL")
|
|
201
|
-
print("2. MySQL")
|
|
202
|
-
print("3. SQLite")
|
|
203
|
-
|
|
204
|
-
provider = input("Select (1-3): ").strip()
|
|
205
|
-
provider_map = {"1": "pg", "2": "mysql", "3": "sqlite"}
|
|
206
|
-
provider_name = provider_map.get(provider, "pg")
|
|
207
|
-
|
|
208
|
-
return {
|
|
209
|
-
"type": "drizzle",
|
|
210
|
-
"provider": provider_name,
|
|
211
|
-
"import": "import { drizzleAdapter } from 'better-auth/adapters/drizzle';\nimport { db } from '@/db';",
|
|
212
|
-
"config": f"database: drizzleAdapter(db, {{ provider: '{provider_name}' }})"
|
|
213
|
-
}
|
|
214
|
-
|
|
215
|
-
def _prompt_prisma(self) -> Dict[str, Any]:
|
|
216
|
-
"""Prompt for Prisma configuration."""
|
|
217
|
-
print("\nPrisma Provider:")
|
|
218
|
-
print("1. PostgreSQL")
|
|
219
|
-
print("2. MySQL")
|
|
220
|
-
print("3. SQLite")
|
|
221
|
-
|
|
222
|
-
provider = input("Select (1-3): ").strip()
|
|
223
|
-
provider_map = {"1": "postgresql", "2": "mysql", "3": "sqlite"}
|
|
224
|
-
provider_name = provider_map.get(provider, "postgresql")
|
|
225
|
-
|
|
226
|
-
return {
|
|
227
|
-
"type": "prisma",
|
|
228
|
-
"provider": provider_name,
|
|
229
|
-
"import": "import { prismaAdapter } from 'better-auth/adapters/prisma';\nimport { PrismaClient } from '@prisma/client';\n\nconst prisma = new PrismaClient();",
|
|
230
|
-
"config": f"database: prismaAdapter(prisma, {{ provider: '{provider_name}' }})"
|
|
231
|
-
}
|
|
232
|
-
|
|
233
|
-
def _prompt_kysely(self) -> Dict[str, Any]:
|
|
234
|
-
"""Prompt for Kysely configuration."""
|
|
235
|
-
return {
|
|
236
|
-
"type": "kysely",
|
|
237
|
-
"import": "import { kyselyAdapter } from 'better-auth/adapters/kysely';\nimport { db } from '@/db';",
|
|
238
|
-
"config": "database: kyselyAdapter(db, { provider: 'pg' })"
|
|
239
|
-
}
|
|
240
|
-
|
|
241
|
-
def _prompt_mongodb(self) -> Dict[str, Any]:
|
|
242
|
-
"""Prompt for MongoDB configuration."""
|
|
243
|
-
mongo_uri = input("MongoDB connection string: ").strip()
|
|
244
|
-
db_name = input("Database name: ").strip()
|
|
245
|
-
|
|
246
|
-
return {
|
|
247
|
-
"type": "mongodb",
|
|
248
|
-
"import": "import { mongodbAdapter } from 'better-auth/adapters/mongodb';\nimport { client } from '@/db';",
|
|
249
|
-
"config": f"database: mongodbAdapter(client, {{ databaseName: '{db_name}' }})",
|
|
250
|
-
"env_var": ("MONGODB_URI", mongo_uri)
|
|
251
|
-
}
|
|
252
|
-
|
|
253
|
-
def prompt_auth_methods(self) -> List[str]:
|
|
254
|
-
"""
|
|
255
|
-
Prompt user for authentication methods.
|
|
256
|
-
|
|
257
|
-
Returns:
|
|
258
|
-
List of selected auth method codes.
|
|
259
|
-
"""
|
|
260
|
-
print("\nAuthentication Methods")
|
|
261
|
-
print("=" * 50)
|
|
262
|
-
print("Select authentication methods (space-separated, e.g., '1 2 3'):")
|
|
263
|
-
print("1. Email/Password")
|
|
264
|
-
print("2. GitHub OAuth")
|
|
265
|
-
print("3. Google OAuth")
|
|
266
|
-
print("4. Discord OAuth")
|
|
267
|
-
print("5. Two-Factor Authentication (2FA)")
|
|
268
|
-
print("6. Passkeys (WebAuthn)")
|
|
269
|
-
print("7. Magic Link")
|
|
270
|
-
print("8. Username")
|
|
271
|
-
|
|
272
|
-
choices = input("\nYour selection: ").strip().split()
|
|
273
|
-
return [c for c in choices if c in "12345678"]
|
|
274
|
-
|
|
275
|
-
def generate_auth_config(
|
|
276
|
-
self,
|
|
277
|
-
db_config: Dict[str, Any],
|
|
278
|
-
auth_methods: List[str],
|
|
279
|
-
) -> str:
|
|
280
|
-
"""
|
|
281
|
-
Generate auth.ts configuration file content.
|
|
282
|
-
|
|
283
|
-
Args:
|
|
284
|
-
db_config: Database configuration.
|
|
285
|
-
auth_methods: Selected authentication methods.
|
|
286
|
-
|
|
287
|
-
Returns:
|
|
288
|
-
Generated TypeScript configuration code.
|
|
289
|
-
"""
|
|
290
|
-
imports = ["import { betterAuth } from 'better-auth';"]
|
|
291
|
-
plugins = []
|
|
292
|
-
plugin_imports = []
|
|
293
|
-
config_parts = []
|
|
294
|
-
|
|
295
|
-
# Database import
|
|
296
|
-
if db_config.get("import"):
|
|
297
|
-
imports.append(db_config["import"])
|
|
298
|
-
|
|
299
|
-
# Email/Password
|
|
300
|
-
if "1" in auth_methods:
|
|
301
|
-
config_parts.append(""" emailAndPassword: {
|
|
302
|
-
enabled: true,
|
|
303
|
-
autoSignIn: true
|
|
304
|
-
}""")
|
|
305
|
-
|
|
306
|
-
# OAuth providers
|
|
307
|
-
social_providers = []
|
|
308
|
-
if "2" in auth_methods:
|
|
309
|
-
social_providers.append(""" github: {
|
|
310
|
-
clientId: process.env.GITHUB_CLIENT_ID!,
|
|
311
|
-
clientSecret: process.env.GITHUB_CLIENT_SECRET!,
|
|
312
|
-
}""")
|
|
313
|
-
|
|
314
|
-
if "3" in auth_methods:
|
|
315
|
-
social_providers.append(""" google: {
|
|
316
|
-
clientId: process.env.GOOGLE_CLIENT_ID!,
|
|
317
|
-
clientSecret: process.env.GOOGLE_CLIENT_SECRET!,
|
|
318
|
-
}""")
|
|
319
|
-
|
|
320
|
-
if "4" in auth_methods:
|
|
321
|
-
social_providers.append(""" discord: {
|
|
322
|
-
clientId: process.env.DISCORD_CLIENT_ID!,
|
|
323
|
-
clientSecret: process.env.DISCORD_CLIENT_SECRET!,
|
|
324
|
-
}""")
|
|
325
|
-
|
|
326
|
-
if social_providers:
|
|
327
|
-
config_parts.append(f" socialProviders: {{\n{',\\n'.join(social_providers)}\n }}")
|
|
328
|
-
|
|
329
|
-
# Plugins
|
|
330
|
-
if "5" in auth_methods:
|
|
331
|
-
plugin_imports.append("import { twoFactor } from 'better-auth/plugins';")
|
|
332
|
-
plugins.append("twoFactor()")
|
|
333
|
-
|
|
334
|
-
if "6" in auth_methods:
|
|
335
|
-
plugin_imports.append("import { passkey } from 'better-auth/plugins';")
|
|
336
|
-
plugins.append("passkey()")
|
|
337
|
-
|
|
338
|
-
if "7" in auth_methods:
|
|
339
|
-
plugin_imports.append("import { magicLink } from 'better-auth/plugins';")
|
|
340
|
-
plugins.append("""magicLink({
|
|
341
|
-
sendMagicLink: async ({ email, url }) => {
|
|
342
|
-
// TODO: Implement email sending
|
|
343
|
-
console.log(`Magic link for ${email}: ${url}`);
|
|
344
|
-
}
|
|
345
|
-
})""")
|
|
346
|
-
|
|
347
|
-
if "8" in auth_methods:
|
|
348
|
-
plugin_imports.append("import { username } from 'better-auth/plugins';")
|
|
349
|
-
plugins.append("username()")
|
|
350
|
-
|
|
351
|
-
# Combine all imports
|
|
352
|
-
all_imports = imports + plugin_imports
|
|
353
|
-
|
|
354
|
-
# Build config
|
|
355
|
-
config_body = ",\n".join(config_parts)
|
|
356
|
-
|
|
357
|
-
if plugins:
|
|
358
|
-
plugins_str = ",\n ".join(plugins)
|
|
359
|
-
config_body += f",\n plugins: [\n {plugins_str}\n ]"
|
|
360
|
-
|
|
361
|
-
# Final output
|
|
362
|
-
return f"""{chr(10).join(all_imports)}
|
|
363
|
-
|
|
364
|
-
export const auth = betterAuth({{
|
|
365
|
-
{db_config["config"]},
|
|
366
|
-
{config_body}
|
|
367
|
-
}});
|
|
368
|
-
"""
|
|
369
|
-
|
|
370
|
-
def generate_env_file(
|
|
371
|
-
self,
|
|
372
|
-
db_config: Dict[str, Any],
|
|
373
|
-
auth_methods: List[str]
|
|
374
|
-
) -> str:
|
|
375
|
-
"""
|
|
376
|
-
Generate .env file content.
|
|
377
|
-
|
|
378
|
-
Args:
|
|
379
|
-
db_config: Database configuration.
|
|
380
|
-
auth_methods: Selected authentication methods.
|
|
381
|
-
|
|
382
|
-
Returns:
|
|
383
|
-
Generated .env file content.
|
|
384
|
-
"""
|
|
385
|
-
env_vars = [
|
|
386
|
-
f"BETTER_AUTH_SECRET={self.generate_secret()}",
|
|
387
|
-
"BETTER_AUTH_URL=http://localhost:3000",
|
|
388
|
-
]
|
|
389
|
-
|
|
390
|
-
# Database URL
|
|
391
|
-
if db_config.get("env_var"):
|
|
392
|
-
key, value = db_config["env_var"]
|
|
393
|
-
env_vars.append(f"{key}={value}")
|
|
394
|
-
|
|
395
|
-
# OAuth credentials
|
|
396
|
-
if "2" in auth_methods:
|
|
397
|
-
env_vars.extend([
|
|
398
|
-
"GITHUB_CLIENT_ID=your_github_client_id",
|
|
399
|
-
"GITHUB_CLIENT_SECRET=your_github_client_secret",
|
|
400
|
-
])
|
|
401
|
-
|
|
402
|
-
if "3" in auth_methods:
|
|
403
|
-
env_vars.extend([
|
|
404
|
-
"GOOGLE_CLIENT_ID=your_google_client_id",
|
|
405
|
-
"GOOGLE_CLIENT_SECRET=your_google_client_secret",
|
|
406
|
-
])
|
|
407
|
-
|
|
408
|
-
if "4" in auth_methods:
|
|
409
|
-
env_vars.extend([
|
|
410
|
-
"DISCORD_CLIENT_ID=your_discord_client_id",
|
|
411
|
-
"DISCORD_CLIENT_SECRET=your_discord_client_secret",
|
|
412
|
-
])
|
|
413
|
-
|
|
414
|
-
return "\n".join(env_vars) + "\n"
|
|
415
|
-
|
|
416
|
-
def run(self) -> None:
|
|
417
|
-
"""Run interactive initialization."""
|
|
418
|
-
print("=" * 50)
|
|
419
|
-
print("Better Auth Configuration Generator")
|
|
420
|
-
print("=" * 50)
|
|
421
|
-
|
|
422
|
-
# Load existing env
|
|
423
|
-
env_vars = self._load_env_files()
|
|
424
|
-
|
|
425
|
-
# Prompt for configuration
|
|
426
|
-
db_config = self.prompt_database()
|
|
427
|
-
auth_methods = self.prompt_auth_methods()
|
|
428
|
-
|
|
429
|
-
# Generate files
|
|
430
|
-
auth_config = self.generate_auth_config(db_config, auth_methods)
|
|
431
|
-
env_content = self.generate_env_file(db_config, auth_methods)
|
|
432
|
-
|
|
433
|
-
# Display output
|
|
434
|
-
print("\n" + "=" * 50)
|
|
435
|
-
print("Generated Configuration")
|
|
436
|
-
print("=" * 50)
|
|
437
|
-
|
|
438
|
-
print("\n--- auth.ts ---")
|
|
439
|
-
print(auth_config)
|
|
440
|
-
|
|
441
|
-
print("\n--- .env ---")
|
|
442
|
-
print(env_content)
|
|
443
|
-
|
|
444
|
-
# Offer to save
|
|
445
|
-
save = input("\nSave configuration files? (y/N): ").strip().lower()
|
|
446
|
-
if save == "y":
|
|
447
|
-
self._save_files(auth_config, env_content)
|
|
448
|
-
else:
|
|
449
|
-
print("Configuration not saved.")
|
|
450
|
-
|
|
451
|
-
def _save_files(self, auth_config: str, env_content: str) -> None:
|
|
452
|
-
"""
|
|
453
|
-
Save generated configuration files.
|
|
454
|
-
|
|
455
|
-
Args:
|
|
456
|
-
auth_config: auth.ts content.
|
|
457
|
-
env_content: .env content.
|
|
458
|
-
"""
|
|
459
|
-
# Save auth.ts
|
|
460
|
-
auth_locations = [
|
|
461
|
-
self.project_root / "lib" / "auth.ts",
|
|
462
|
-
self.project_root / "src" / "lib" / "auth.ts",
|
|
463
|
-
self.project_root / "utils" / "auth.ts",
|
|
464
|
-
self.project_root / "auth.ts",
|
|
465
|
-
]
|
|
466
|
-
|
|
467
|
-
print("\nWhere to save auth.ts?")
|
|
468
|
-
for i, loc in enumerate(auth_locations, 1):
|
|
469
|
-
print(f"{i}. {loc}")
|
|
470
|
-
print("5. Custom path")
|
|
471
|
-
|
|
472
|
-
choice = input("Select (1-5): ").strip()
|
|
473
|
-
if choice == "5":
|
|
474
|
-
custom_path = input("Enter path: ").strip()
|
|
475
|
-
auth_path = Path(custom_path)
|
|
476
|
-
else:
|
|
477
|
-
idx = int(choice) - 1 if choice.isdigit() else 0
|
|
478
|
-
auth_path = auth_locations[idx]
|
|
479
|
-
|
|
480
|
-
auth_path.parent.mkdir(parents=True, exist_ok=True)
|
|
481
|
-
auth_path.write_text(auth_config)
|
|
482
|
-
print(f"Saved: {auth_path}")
|
|
483
|
-
|
|
484
|
-
# Save .env
|
|
485
|
-
env_path = self.project_root / ".env"
|
|
486
|
-
if env_path.exists():
|
|
487
|
-
backup = self.project_root / ".env.backup"
|
|
488
|
-
env_path.rename(backup)
|
|
489
|
-
print(f"Backed up existing .env to {backup}")
|
|
490
|
-
|
|
491
|
-
env_path.write_text(env_content)
|
|
492
|
-
print(f"Saved: {env_path}")
|
|
493
|
-
|
|
494
|
-
print("\nNext steps:")
|
|
495
|
-
print("1. Run: npx @better-auth/cli generate")
|
|
496
|
-
print("2. Apply database migrations")
|
|
497
|
-
print("3. Mount API handler in your framework")
|
|
498
|
-
print("4. Create client instance")
|
|
499
|
-
|
|
500
|
-
|
|
501
|
-
def main() -> int:
|
|
502
|
-
"""
|
|
503
|
-
Main entry point.
|
|
504
|
-
|
|
505
|
-
Returns:
|
|
506
|
-
Exit code (0 for success, 1 for error).
|
|
507
|
-
"""
|
|
508
|
-
try:
|
|
509
|
-
initializer = BetterAuthInit()
|
|
510
|
-
initializer.run()
|
|
511
|
-
return 0
|
|
512
|
-
except KeyboardInterrupt:
|
|
513
|
-
print("\n\nOperation cancelled.")
|
|
514
|
-
return 1
|
|
515
|
-
except Exception as e:
|
|
516
|
-
print(f"\nError: {e}", file=sys.stderr)
|
|
517
|
-
return 1
|
|
518
|
-
|
|
519
|
-
|
|
520
|
-
if __name__ == "__main__":
|
|
521
|
-
sys.exit(main())
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""
|
|
3
|
+
Better Auth Initialization Script
|
|
4
|
+
|
|
5
|
+
Interactive script to initialize Better Auth configuration.
|
|
6
|
+
Supports multiple databases, ORMs, and authentication methods.
|
|
7
|
+
|
|
8
|
+
.env loading order: process.env > skill/.env > skills/.env > .claude/.env
|
|
9
|
+
"""
|
|
10
|
+
|
|
11
|
+
import os
|
|
12
|
+
import sys
|
|
13
|
+
import json
|
|
14
|
+
import secrets
|
|
15
|
+
from pathlib import Path
|
|
16
|
+
from typing import Optional, Dict, Any, List
|
|
17
|
+
from dataclasses import dataclass
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
@dataclass
|
|
21
|
+
class EnvConfig:
|
|
22
|
+
"""Environment configuration holder."""
|
|
23
|
+
secret: str
|
|
24
|
+
url: str
|
|
25
|
+
database_url: Optional[str] = None
|
|
26
|
+
github_client_id: Optional[str] = None
|
|
27
|
+
github_client_secret: Optional[str] = None
|
|
28
|
+
google_client_id: Optional[str] = None
|
|
29
|
+
google_client_secret: Optional[str] = None
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
class BetterAuthInit:
|
|
33
|
+
"""Better Auth configuration initializer."""
|
|
34
|
+
|
|
35
|
+
def __init__(self, project_root: Optional[Path] = None):
|
|
36
|
+
"""
|
|
37
|
+
Initialize the Better Auth configuration tool.
|
|
38
|
+
|
|
39
|
+
Args:
|
|
40
|
+
project_root: Project root directory. Auto-detected if not provided.
|
|
41
|
+
"""
|
|
42
|
+
self.project_root = project_root or self._find_project_root()
|
|
43
|
+
self.env_config: Optional[EnvConfig] = None
|
|
44
|
+
|
|
45
|
+
@staticmethod
|
|
46
|
+
def _find_project_root() -> Path:
|
|
47
|
+
"""
|
|
48
|
+
Find project root by looking for package.json.
|
|
49
|
+
|
|
50
|
+
Returns:
|
|
51
|
+
Path to project root.
|
|
52
|
+
|
|
53
|
+
Raises:
|
|
54
|
+
RuntimeError: If project root cannot be found.
|
|
55
|
+
"""
|
|
56
|
+
current = Path.cwd()
|
|
57
|
+
while current != current.parent:
|
|
58
|
+
if (current / "package.json").exists():
|
|
59
|
+
return current
|
|
60
|
+
current = current.parent
|
|
61
|
+
|
|
62
|
+
raise RuntimeError("Could not find project root (no package.json found)")
|
|
63
|
+
|
|
64
|
+
def _load_env_files(self) -> Dict[str, str]:
|
|
65
|
+
"""
|
|
66
|
+
Load environment variables from .env files in order.
|
|
67
|
+
|
|
68
|
+
Loading order: process.env > skill/.env > skills/.env > .claude/.env
|
|
69
|
+
|
|
70
|
+
Returns:
|
|
71
|
+
Dictionary of environment variables.
|
|
72
|
+
"""
|
|
73
|
+
env_vars = {}
|
|
74
|
+
|
|
75
|
+
# Define search paths in reverse priority order
|
|
76
|
+
skill_dir = Path(__file__).parent.parent
|
|
77
|
+
env_paths = [
|
|
78
|
+
self.project_root / ".claude" / ".env",
|
|
79
|
+
self.project_root / ".claude" / "skills" / ".env",
|
|
80
|
+
skill_dir / ".env",
|
|
81
|
+
]
|
|
82
|
+
|
|
83
|
+
# Load from files (lowest priority first)
|
|
84
|
+
for env_path in env_paths:
|
|
85
|
+
if env_path.exists():
|
|
86
|
+
env_vars.update(self._parse_env_file(env_path))
|
|
87
|
+
|
|
88
|
+
# Override with process environment (highest priority)
|
|
89
|
+
env_vars.update(os.environ)
|
|
90
|
+
|
|
91
|
+
return env_vars
|
|
92
|
+
|
|
93
|
+
@staticmethod
|
|
94
|
+
def _parse_env_file(path: Path) -> Dict[str, str]:
|
|
95
|
+
"""
|
|
96
|
+
Parse .env file into dictionary.
|
|
97
|
+
|
|
98
|
+
Args:
|
|
99
|
+
path: Path to .env file.
|
|
100
|
+
|
|
101
|
+
Returns:
|
|
102
|
+
Dictionary of key-value pairs.
|
|
103
|
+
"""
|
|
104
|
+
env_vars = {}
|
|
105
|
+
try:
|
|
106
|
+
with open(path, "r") as f:
|
|
107
|
+
for line in f:
|
|
108
|
+
line = line.strip()
|
|
109
|
+
if line and not line.startswith("#") and "=" in line:
|
|
110
|
+
key, value = line.split("=", 1)
|
|
111
|
+
# Remove quotes if present
|
|
112
|
+
value = value.strip().strip('"').strip("'")
|
|
113
|
+
env_vars[key.strip()] = value
|
|
114
|
+
except Exception as e:
|
|
115
|
+
print(f"Warning: Could not parse {path}: {e}")
|
|
116
|
+
|
|
117
|
+
return env_vars
|
|
118
|
+
|
|
119
|
+
@staticmethod
|
|
120
|
+
def generate_secret(length: int = 32) -> str:
|
|
121
|
+
"""
|
|
122
|
+
Generate cryptographically secure random secret.
|
|
123
|
+
|
|
124
|
+
Args:
|
|
125
|
+
length: Length of secret in bytes.
|
|
126
|
+
|
|
127
|
+
Returns:
|
|
128
|
+
Hex-encoded secret string.
|
|
129
|
+
"""
|
|
130
|
+
return secrets.token_hex(length)
|
|
131
|
+
|
|
132
|
+
def prompt_database(self) -> Dict[str, Any]:
|
|
133
|
+
"""
|
|
134
|
+
Prompt user for database configuration.
|
|
135
|
+
|
|
136
|
+
Returns:
|
|
137
|
+
Database configuration dictionary.
|
|
138
|
+
"""
|
|
139
|
+
print("\nDatabase Configuration")
|
|
140
|
+
print("=" * 50)
|
|
141
|
+
print("1. Direct Connection (PostgreSQL/MySQL/SQLite)")
|
|
142
|
+
print("2. Drizzle ORM")
|
|
143
|
+
print("3. Prisma")
|
|
144
|
+
print("4. Kysely")
|
|
145
|
+
print("5. MongoDB")
|
|
146
|
+
|
|
147
|
+
choice = input("\nSelect database option (1-5): ").strip()
|
|
148
|
+
|
|
149
|
+
db_configs = {
|
|
150
|
+
"1": self._prompt_direct_db,
|
|
151
|
+
"2": self._prompt_drizzle,
|
|
152
|
+
"3": self._prompt_prisma,
|
|
153
|
+
"4": self._prompt_kysely,
|
|
154
|
+
"5": self._prompt_mongodb,
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
handler = db_configs.get(choice)
|
|
158
|
+
if not handler:
|
|
159
|
+
print("Invalid choice. Defaulting to direct PostgreSQL.")
|
|
160
|
+
return self._prompt_direct_db()
|
|
161
|
+
|
|
162
|
+
return handler()
|
|
163
|
+
|
|
164
|
+
def _prompt_direct_db(self) -> Dict[str, Any]:
|
|
165
|
+
"""Prompt for direct database connection."""
|
|
166
|
+
print("\nDatabase Type:")
|
|
167
|
+
print("1. PostgreSQL")
|
|
168
|
+
print("2. MySQL")
|
|
169
|
+
print("3. SQLite")
|
|
170
|
+
|
|
171
|
+
db_type = input("Select (1-3): ").strip()
|
|
172
|
+
|
|
173
|
+
if db_type == "3":
|
|
174
|
+
db_path = input("SQLite file path [./dev.db]: ").strip() or "./dev.db"
|
|
175
|
+
return {
|
|
176
|
+
"type": "sqlite",
|
|
177
|
+
"import": "import Database from 'better-sqlite3';",
|
|
178
|
+
"config": f'database: new Database("{db_path}")'
|
|
179
|
+
}
|
|
180
|
+
elif db_type == "2":
|
|
181
|
+
db_url = input("MySQL connection string: ").strip()
|
|
182
|
+
return {
|
|
183
|
+
"type": "mysql",
|
|
184
|
+
"import": "import { createPool } from 'mysql2/promise';",
|
|
185
|
+
"config": f"database: createPool({{ connectionString: process.env.DATABASE_URL }})",
|
|
186
|
+
"env_var": ("DATABASE_URL", db_url)
|
|
187
|
+
}
|
|
188
|
+
else:
|
|
189
|
+
db_url = input("PostgreSQL connection string: ").strip()
|
|
190
|
+
return {
|
|
191
|
+
"type": "postgresql",
|
|
192
|
+
"import": "import { Pool } from 'pg';",
|
|
193
|
+
"config": "database: new Pool({ connectionString: process.env.DATABASE_URL })",
|
|
194
|
+
"env_var": ("DATABASE_URL", db_url)
|
|
195
|
+
}
|
|
196
|
+
|
|
197
|
+
def _prompt_drizzle(self) -> Dict[str, Any]:
|
|
198
|
+
"""Prompt for Drizzle ORM configuration."""
|
|
199
|
+
print("\nDrizzle Provider:")
|
|
200
|
+
print("1. PostgreSQL")
|
|
201
|
+
print("2. MySQL")
|
|
202
|
+
print("3. SQLite")
|
|
203
|
+
|
|
204
|
+
provider = input("Select (1-3): ").strip()
|
|
205
|
+
provider_map = {"1": "pg", "2": "mysql", "3": "sqlite"}
|
|
206
|
+
provider_name = provider_map.get(provider, "pg")
|
|
207
|
+
|
|
208
|
+
return {
|
|
209
|
+
"type": "drizzle",
|
|
210
|
+
"provider": provider_name,
|
|
211
|
+
"import": "import { drizzleAdapter } from 'better-auth/adapters/drizzle';\nimport { db } from '@/db';",
|
|
212
|
+
"config": f"database: drizzleAdapter(db, {{ provider: '{provider_name}' }})"
|
|
213
|
+
}
|
|
214
|
+
|
|
215
|
+
def _prompt_prisma(self) -> Dict[str, Any]:
|
|
216
|
+
"""Prompt for Prisma configuration."""
|
|
217
|
+
print("\nPrisma Provider:")
|
|
218
|
+
print("1. PostgreSQL")
|
|
219
|
+
print("2. MySQL")
|
|
220
|
+
print("3. SQLite")
|
|
221
|
+
|
|
222
|
+
provider = input("Select (1-3): ").strip()
|
|
223
|
+
provider_map = {"1": "postgresql", "2": "mysql", "3": "sqlite"}
|
|
224
|
+
provider_name = provider_map.get(provider, "postgresql")
|
|
225
|
+
|
|
226
|
+
return {
|
|
227
|
+
"type": "prisma",
|
|
228
|
+
"provider": provider_name,
|
|
229
|
+
"import": "import { prismaAdapter } from 'better-auth/adapters/prisma';\nimport { PrismaClient } from '@prisma/client';\n\nconst prisma = new PrismaClient();",
|
|
230
|
+
"config": f"database: prismaAdapter(prisma, {{ provider: '{provider_name}' }})"
|
|
231
|
+
}
|
|
232
|
+
|
|
233
|
+
def _prompt_kysely(self) -> Dict[str, Any]:
|
|
234
|
+
"""Prompt for Kysely configuration."""
|
|
235
|
+
return {
|
|
236
|
+
"type": "kysely",
|
|
237
|
+
"import": "import { kyselyAdapter } from 'better-auth/adapters/kysely';\nimport { db } from '@/db';",
|
|
238
|
+
"config": "database: kyselyAdapter(db, { provider: 'pg' })"
|
|
239
|
+
}
|
|
240
|
+
|
|
241
|
+
def _prompt_mongodb(self) -> Dict[str, Any]:
|
|
242
|
+
"""Prompt for MongoDB configuration."""
|
|
243
|
+
mongo_uri = input("MongoDB connection string: ").strip()
|
|
244
|
+
db_name = input("Database name: ").strip()
|
|
245
|
+
|
|
246
|
+
return {
|
|
247
|
+
"type": "mongodb",
|
|
248
|
+
"import": "import { mongodbAdapter } from 'better-auth/adapters/mongodb';\nimport { client } from '@/db';",
|
|
249
|
+
"config": f"database: mongodbAdapter(client, {{ databaseName: '{db_name}' }})",
|
|
250
|
+
"env_var": ("MONGODB_URI", mongo_uri)
|
|
251
|
+
}
|
|
252
|
+
|
|
253
|
+
def prompt_auth_methods(self) -> List[str]:
|
|
254
|
+
"""
|
|
255
|
+
Prompt user for authentication methods.
|
|
256
|
+
|
|
257
|
+
Returns:
|
|
258
|
+
List of selected auth method codes.
|
|
259
|
+
"""
|
|
260
|
+
print("\nAuthentication Methods")
|
|
261
|
+
print("=" * 50)
|
|
262
|
+
print("Select authentication methods (space-separated, e.g., '1 2 3'):")
|
|
263
|
+
print("1. Email/Password")
|
|
264
|
+
print("2. GitHub OAuth")
|
|
265
|
+
print("3. Google OAuth")
|
|
266
|
+
print("4. Discord OAuth")
|
|
267
|
+
print("5. Two-Factor Authentication (2FA)")
|
|
268
|
+
print("6. Passkeys (WebAuthn)")
|
|
269
|
+
print("7. Magic Link")
|
|
270
|
+
print("8. Username")
|
|
271
|
+
|
|
272
|
+
choices = input("\nYour selection: ").strip().split()
|
|
273
|
+
return [c for c in choices if c in "12345678"]
|
|
274
|
+
|
|
275
|
+
def generate_auth_config(
|
|
276
|
+
self,
|
|
277
|
+
db_config: Dict[str, Any],
|
|
278
|
+
auth_methods: List[str],
|
|
279
|
+
) -> str:
|
|
280
|
+
"""
|
|
281
|
+
Generate auth.ts configuration file content.
|
|
282
|
+
|
|
283
|
+
Args:
|
|
284
|
+
db_config: Database configuration.
|
|
285
|
+
auth_methods: Selected authentication methods.
|
|
286
|
+
|
|
287
|
+
Returns:
|
|
288
|
+
Generated TypeScript configuration code.
|
|
289
|
+
"""
|
|
290
|
+
imports = ["import { betterAuth } from 'better-auth';"]
|
|
291
|
+
plugins = []
|
|
292
|
+
plugin_imports = []
|
|
293
|
+
config_parts = []
|
|
294
|
+
|
|
295
|
+
# Database import
|
|
296
|
+
if db_config.get("import"):
|
|
297
|
+
imports.append(db_config["import"])
|
|
298
|
+
|
|
299
|
+
# Email/Password
|
|
300
|
+
if "1" in auth_methods:
|
|
301
|
+
config_parts.append(""" emailAndPassword: {
|
|
302
|
+
enabled: true,
|
|
303
|
+
autoSignIn: true
|
|
304
|
+
}""")
|
|
305
|
+
|
|
306
|
+
# OAuth providers
|
|
307
|
+
social_providers = []
|
|
308
|
+
if "2" in auth_methods:
|
|
309
|
+
social_providers.append(""" github: {
|
|
310
|
+
clientId: process.env.GITHUB_CLIENT_ID!,
|
|
311
|
+
clientSecret: process.env.GITHUB_CLIENT_SECRET!,
|
|
312
|
+
}""")
|
|
313
|
+
|
|
314
|
+
if "3" in auth_methods:
|
|
315
|
+
social_providers.append(""" google: {
|
|
316
|
+
clientId: process.env.GOOGLE_CLIENT_ID!,
|
|
317
|
+
clientSecret: process.env.GOOGLE_CLIENT_SECRET!,
|
|
318
|
+
}""")
|
|
319
|
+
|
|
320
|
+
if "4" in auth_methods:
|
|
321
|
+
social_providers.append(""" discord: {
|
|
322
|
+
clientId: process.env.DISCORD_CLIENT_ID!,
|
|
323
|
+
clientSecret: process.env.DISCORD_CLIENT_SECRET!,
|
|
324
|
+
}""")
|
|
325
|
+
|
|
326
|
+
if social_providers:
|
|
327
|
+
config_parts.append(f" socialProviders: {{\n{',\\n'.join(social_providers)}\n }}")
|
|
328
|
+
|
|
329
|
+
# Plugins
|
|
330
|
+
if "5" in auth_methods:
|
|
331
|
+
plugin_imports.append("import { twoFactor } from 'better-auth/plugins';")
|
|
332
|
+
plugins.append("twoFactor()")
|
|
333
|
+
|
|
334
|
+
if "6" in auth_methods:
|
|
335
|
+
plugin_imports.append("import { passkey } from 'better-auth/plugins';")
|
|
336
|
+
plugins.append("passkey()")
|
|
337
|
+
|
|
338
|
+
if "7" in auth_methods:
|
|
339
|
+
plugin_imports.append("import { magicLink } from 'better-auth/plugins';")
|
|
340
|
+
plugins.append("""magicLink({
|
|
341
|
+
sendMagicLink: async ({ email, url }) => {
|
|
342
|
+
// TODO: Implement email sending
|
|
343
|
+
console.log(`Magic link for ${email}: ${url}`);
|
|
344
|
+
}
|
|
345
|
+
})""")
|
|
346
|
+
|
|
347
|
+
if "8" in auth_methods:
|
|
348
|
+
plugin_imports.append("import { username } from 'better-auth/plugins';")
|
|
349
|
+
plugins.append("username()")
|
|
350
|
+
|
|
351
|
+
# Combine all imports
|
|
352
|
+
all_imports = imports + plugin_imports
|
|
353
|
+
|
|
354
|
+
# Build config
|
|
355
|
+
config_body = ",\n".join(config_parts)
|
|
356
|
+
|
|
357
|
+
if plugins:
|
|
358
|
+
plugins_str = ",\n ".join(plugins)
|
|
359
|
+
config_body += f",\n plugins: [\n {plugins_str}\n ]"
|
|
360
|
+
|
|
361
|
+
# Final output
|
|
362
|
+
return f"""{chr(10).join(all_imports)}
|
|
363
|
+
|
|
364
|
+
export const auth = betterAuth({{
|
|
365
|
+
{db_config["config"]},
|
|
366
|
+
{config_body}
|
|
367
|
+
}});
|
|
368
|
+
"""
|
|
369
|
+
|
|
370
|
+
def generate_env_file(
|
|
371
|
+
self,
|
|
372
|
+
db_config: Dict[str, Any],
|
|
373
|
+
auth_methods: List[str]
|
|
374
|
+
) -> str:
|
|
375
|
+
"""
|
|
376
|
+
Generate .env file content.
|
|
377
|
+
|
|
378
|
+
Args:
|
|
379
|
+
db_config: Database configuration.
|
|
380
|
+
auth_methods: Selected authentication methods.
|
|
381
|
+
|
|
382
|
+
Returns:
|
|
383
|
+
Generated .env file content.
|
|
384
|
+
"""
|
|
385
|
+
env_vars = [
|
|
386
|
+
f"BETTER_AUTH_SECRET={self.generate_secret()}",
|
|
387
|
+
"BETTER_AUTH_URL=http://localhost:3000",
|
|
388
|
+
]
|
|
389
|
+
|
|
390
|
+
# Database URL
|
|
391
|
+
if db_config.get("env_var"):
|
|
392
|
+
key, value = db_config["env_var"]
|
|
393
|
+
env_vars.append(f"{key}={value}")
|
|
394
|
+
|
|
395
|
+
# OAuth credentials
|
|
396
|
+
if "2" in auth_methods:
|
|
397
|
+
env_vars.extend([
|
|
398
|
+
"GITHUB_CLIENT_ID=your_github_client_id",
|
|
399
|
+
"GITHUB_CLIENT_SECRET=your_github_client_secret",
|
|
400
|
+
])
|
|
401
|
+
|
|
402
|
+
if "3" in auth_methods:
|
|
403
|
+
env_vars.extend([
|
|
404
|
+
"GOOGLE_CLIENT_ID=your_google_client_id",
|
|
405
|
+
"GOOGLE_CLIENT_SECRET=your_google_client_secret",
|
|
406
|
+
])
|
|
407
|
+
|
|
408
|
+
if "4" in auth_methods:
|
|
409
|
+
env_vars.extend([
|
|
410
|
+
"DISCORD_CLIENT_ID=your_discord_client_id",
|
|
411
|
+
"DISCORD_CLIENT_SECRET=your_discord_client_secret",
|
|
412
|
+
])
|
|
413
|
+
|
|
414
|
+
return "\n".join(env_vars) + "\n"
|
|
415
|
+
|
|
416
|
+
def run(self) -> None:
|
|
417
|
+
"""Run interactive initialization."""
|
|
418
|
+
print("=" * 50)
|
|
419
|
+
print("Better Auth Configuration Generator")
|
|
420
|
+
print("=" * 50)
|
|
421
|
+
|
|
422
|
+
# Load existing env
|
|
423
|
+
env_vars = self._load_env_files()
|
|
424
|
+
|
|
425
|
+
# Prompt for configuration
|
|
426
|
+
db_config = self.prompt_database()
|
|
427
|
+
auth_methods = self.prompt_auth_methods()
|
|
428
|
+
|
|
429
|
+
# Generate files
|
|
430
|
+
auth_config = self.generate_auth_config(db_config, auth_methods)
|
|
431
|
+
env_content = self.generate_env_file(db_config, auth_methods)
|
|
432
|
+
|
|
433
|
+
# Display output
|
|
434
|
+
print("\n" + "=" * 50)
|
|
435
|
+
print("Generated Configuration")
|
|
436
|
+
print("=" * 50)
|
|
437
|
+
|
|
438
|
+
print("\n--- auth.ts ---")
|
|
439
|
+
print(auth_config)
|
|
440
|
+
|
|
441
|
+
print("\n--- .env ---")
|
|
442
|
+
print(env_content)
|
|
443
|
+
|
|
444
|
+
# Offer to save
|
|
445
|
+
save = input("\nSave configuration files? (y/N): ").strip().lower()
|
|
446
|
+
if save == "y":
|
|
447
|
+
self._save_files(auth_config, env_content)
|
|
448
|
+
else:
|
|
449
|
+
print("Configuration not saved.")
|
|
450
|
+
|
|
451
|
+
def _save_files(self, auth_config: str, env_content: str) -> None:
|
|
452
|
+
"""
|
|
453
|
+
Save generated configuration files.
|
|
454
|
+
|
|
455
|
+
Args:
|
|
456
|
+
auth_config: auth.ts content.
|
|
457
|
+
env_content: .env content.
|
|
458
|
+
"""
|
|
459
|
+
# Save auth.ts
|
|
460
|
+
auth_locations = [
|
|
461
|
+
self.project_root / "lib" / "auth.ts",
|
|
462
|
+
self.project_root / "src" / "lib" / "auth.ts",
|
|
463
|
+
self.project_root / "utils" / "auth.ts",
|
|
464
|
+
self.project_root / "auth.ts",
|
|
465
|
+
]
|
|
466
|
+
|
|
467
|
+
print("\nWhere to save auth.ts?")
|
|
468
|
+
for i, loc in enumerate(auth_locations, 1):
|
|
469
|
+
print(f"{i}. {loc}")
|
|
470
|
+
print("5. Custom path")
|
|
471
|
+
|
|
472
|
+
choice = input("Select (1-5): ").strip()
|
|
473
|
+
if choice == "5":
|
|
474
|
+
custom_path = input("Enter path: ").strip()
|
|
475
|
+
auth_path = Path(custom_path)
|
|
476
|
+
else:
|
|
477
|
+
idx = int(choice) - 1 if choice.isdigit() else 0
|
|
478
|
+
auth_path = auth_locations[idx]
|
|
479
|
+
|
|
480
|
+
auth_path.parent.mkdir(parents=True, exist_ok=True)
|
|
481
|
+
auth_path.write_text(auth_config)
|
|
482
|
+
print(f"Saved: {auth_path}")
|
|
483
|
+
|
|
484
|
+
# Save .env
|
|
485
|
+
env_path = self.project_root / ".env"
|
|
486
|
+
if env_path.exists():
|
|
487
|
+
backup = self.project_root / ".env.backup"
|
|
488
|
+
env_path.rename(backup)
|
|
489
|
+
print(f"Backed up existing .env to {backup}")
|
|
490
|
+
|
|
491
|
+
env_path.write_text(env_content)
|
|
492
|
+
print(f"Saved: {env_path}")
|
|
493
|
+
|
|
494
|
+
print("\nNext steps:")
|
|
495
|
+
print("1. Run: npx @better-auth/cli generate")
|
|
496
|
+
print("2. Apply database migrations")
|
|
497
|
+
print("3. Mount API handler in your framework")
|
|
498
|
+
print("4. Create client instance")
|
|
499
|
+
|
|
500
|
+
|
|
501
|
+
def main() -> int:
|
|
502
|
+
"""
|
|
503
|
+
Main entry point.
|
|
504
|
+
|
|
505
|
+
Returns:
|
|
506
|
+
Exit code (0 for success, 1 for error).
|
|
507
|
+
"""
|
|
508
|
+
try:
|
|
509
|
+
initializer = BetterAuthInit()
|
|
510
|
+
initializer.run()
|
|
511
|
+
return 0
|
|
512
|
+
except KeyboardInterrupt:
|
|
513
|
+
print("\n\nOperation cancelled.")
|
|
514
|
+
return 1
|
|
515
|
+
except Exception as e:
|
|
516
|
+
print(f"\nError: {e}", file=sys.stderr)
|
|
517
|
+
return 1
|
|
518
|
+
|
|
519
|
+
|
|
520
|
+
if __name__ == "__main__":
|
|
521
|
+
sys.exit(main())
|