rapidkit 0.10.0

package/dist/index.js

@@ -0,0 +1,366 @@
+#!/usr/bin/env node
+import {Command}from'commander';import i from'chalk';import {promises}from'fs';import*as h from'fs-extra';import y from'path';import oe from'inquirer';import W from'ora';import {execa}from'execa';import ee from'os';import ce from'nunjucks';import {fileURLToPath}from'url';import he from'validate-npm-package-name';var G=class{debugEnabled=false;setDebug(e){this.debugEnabled=e;}debug(e,...o){this.debugEnabled&&console.log(i.gray(`[DEBUG] ${e}`),...o);}info(e,...o){console.log(i.blue(e),...o);}success(e,...o){console.log(i.green(e),...o);}warn(e,...o){console.log(i.yellow(e),...o);}error(e,...o){console.error(i.red(e),...o);}step(e,o,r){console.log(i.cyan(`
+[${e}/${o}]`),i.white(r));}},s=new G;var te=".rapidkitrc.json";async function z(){let t=y.join(ee.homedir(),te);try{let e=await promises.readFile(t,"utf-8"),o=JSON.parse(e);return s.debug(`Loaded config from ${t}`),o}catch{return s.debug("No user config found, using defaults"),{}}}function $(t){return process.env.RAPIDKIT_DEV_PATH||t.testRapidKitPath||void 0}var g=class extends Error{constructor(o,r,n){super(o);this.code=r;this.details=n;this.name="RapidKitError",Error.captureStackTrace(this,this.constructor);}},x=class extends g{constructor(e,o){let r=o?`Python ${e}+ required, found ${o}`:`Python ${e}+ not found`;super(r,"PYTHON_NOT_FOUND","Please install Python from https://www.python.org/downloads/");}},F=class extends g{constructor(){super("Poetry is not installed","POETRY_NOT_FOUND","Install Poetry from https://python-poetry.org/docs/#installation");}},N=class extends g{constructor(){super("pipx is not installed","PIPX_NOT_FOUND","Install pipx from https://pypa.github.io/pipx/installation/");}},T=class extends g{constructor(e){super(`Directory "${e}" already exists`,"DIRECTORY_EXISTS","Please choose a different name or remove the existing directory");}},k=class extends g{constructor(e,o){super(`Invalid project name: "${e}"`,"INVALID_PROJECT_NAME",o);}},I=class extends g{constructor(e,o){let r=`Installation failed at: ${e}`,n=`${o.message}
+
+Troubleshooting:
+- Check your internet connection
+- Verify Python/Poetry installation
+- Try running with --debug flag for more details`;super(r,"INSTALLATION_ERROR",n);}},E=class extends g{constructor(){super("RapidKit Python package is not yet available on PyPI","RAPIDKIT_NOT_AVAILABLE",`Available options:
+  1. Demo mode: npx rapidkit my-workspace --demo
+  2. Test mode: npx rapidkit my-workspace --test-mode (requires local RapidKit)
+  3. Wait for official PyPI release (coming soon)`);}};async function U(t,e){let{skipGit:o=false,testMode:r=false,demoMode:n=false,dryRun:m=false,userConfig:p={}}=e,a=t,l=y.resolve(process.cwd(),a);if(await h.pathExists(l))throw new T(a);if(m){await le(l,a,n,p);return}if(n){await se(l,a,o);return}let f=await oe.prompt([{type:"list",name:"pythonVersion",message:"Select Python version for RapidKit:",choices:["3.10","3.11","3.12"],default:p.pythonVersion||"3.11"},{type:"list",name:"installMethod",message:"How would you like to install RapidKit?",choices:[{name:"\u{1F3AF} Poetry (Recommended - includes virtual env)",value:"poetry"},{name:"\u{1F4E6} pip with venv (Standard)",value:"venv"},{name:"\u{1F527} pipx (Global isolated install)",value:"pipx"}],default:p.defaultInstallMethod||"poetry"}]);s.step(1,3,"Setting up RapidKit environment");let u=W("Creating directory").start();try{if(await h.ensureDir(l),u.succeed("Directory created"),f.installMethod==="poetry"?await ie(l,f.pythonVersion,u,r,p):f.installMethod==="venv"?await re(l,f.pythonVersion,u,r,p):await ne(l,u,r,p),await ae(l,f.installMethod),u.succeed("RapidKit environment ready!"),!e.skipGit){u.start("Initializing git repository");try{await execa("git",["init"],{cwd:l}),await h.outputFile(y.join(l,".gitignore"),`.venv/
+__pycache__/
+*.pyc
+.env
+.rapidkit-workspace/
+`,"utf-8"),await execa("git",["add","."],{cwd:l}),await execa("git",["commit","-m","Initial commit: RapidKit environment"],{cwd:l}),u.succeed("Git repository initialized");}catch{u.warn("Could not initialize git repository");}}if(console.log(i.green(`
+\u2728 RapidKit environment created successfully!
+`)),console.log(i.cyan("\u{1F4C2} Location:"),i.white(l)),console.log(i.cyan(`\u{1F680} Get started:
+`)),console.log(i.white(`   cd ${a}`)),f.installMethod==="poetry"){let v="source $(poetry env info --path)/bin/activate";try{let{stdout:A}=await execa("poetry",["--version"]),D=A.match(/Poetry.*?(\d+)\.(\d+)/);D&&(parseInt(D[1])>=2?v="source $(poetry env info --path)/bin/activate":v="poetry shell");}catch{}console.log(i.white(`   ${v}  # Or: poetry run rapidkit`)),console.log(i.white("   rapidkit create  # Interactive mode")),console.log(i.white("   cd <project-name> && poetry install && rapidkit run dev"));}else f.installMethod==="venv"?(console.log(i.white("   source .venv/bin/activate  # On Windows: .venv\\Scripts\\activate")),console.log(i.white("   rapidkit create  # Interactive mode")),console.log(i.white("   cd <project-name> && pip install -r requirements.txt && rapidkit run dev"))):(console.log(i.white("   rapidkit create  # Interactive mode")),console.log(i.white("   cd <project-name> && rapidkit run dev")));console.log(i.white(`
+\u{1F4A1} For more information, check the README.md file.`)),console.log(i.cyan(`
+\u{1F4DA} RapidKit commands:`)),console.log(i.white("   rapidkit create          - Create a new project (interactive)")),console.log(i.white("   rapidkit run dev         - Run development server")),console.log(i.white("   rapidkit add module <name> - Add a module (e.g., settings)")),console.log(i.white("   rapidkit list            - List available kits")),console.log(i.white("   rapidkit modules         - List available modules")),console.log(i.white(`   rapidkit --help          - Show all commands
+`));}catch(v){u.fail("Failed to create RapidKit environment"),console.error(i.red(`
+\u274C Error:`),v);try{await h.remove(l);}catch{}process.exit(1);}}async function ie(t,e,o,r,n){o.start("Checking Poetry installation");try{await execa("poetry",["--version"]),o.succeed("Poetry found");}catch{throw new F}o.start("Initializing Poetry project"),await execa("poetry",["init","--no-interaction","--python",`^${e}`],{cwd:t});let m=y.join(t,"pyproject.toml"),a=(await promises.readFile(m,"utf-8")).replace("[tool.poetry]",`[tool.poetry]
+package-mode = false`);if(await promises.writeFile(m,a,"utf-8"),o.succeed("Poetry project initialized"),o.start("Installing RapidKit"),r){let l=$(n||{});if(!l)throw new I("Test mode installation",new Error("No local RapidKit path configured. Set RAPIDKIT_DEV_PATH environment variable."));s.debug(`Installing from local path: ${l}`),o.text="Installing RapidKit from local path (test mode)",await execa("poetry",["add",l],{cwd:t});}else {o.text="Installing RapidKit from PyPI";try{await execa("poetry",["add","rapidkit"],{cwd:t});}catch{throw new E}}o.succeed("RapidKit installed");}async function re(t,e,o,r,n){o.start(`Checking Python ${e}`);let m="python3";try{let{stdout:a}=await execa(m,["--version"]),l=a.match(/Python (\d+\.\d+)/)?.[1];if(l&&parseFloat(l)<parseFloat(e))throw new x(e,l);o.succeed(`Python ${l} found`);}catch(a){throw a instanceof x?a:new x(e)}o.start("Creating virtual environment"),await execa(m,["-m","venv",".venv"],{cwd:t}),o.succeed("Virtual environment created"),o.start("Installing RapidKit");let p=y.join(t,".venv","bin","pip");if(await execa(p,["install","--upgrade","pip"],{cwd:t}),r){let a=$(n||{});if(!a)throw new I("Test mode installation",new Error("No local RapidKit path configured. Set RAPIDKIT_DEV_PATH environment variable."));s.debug(`Installing from local path: ${a}`),o.text="Installing RapidKit from local path (test mode)",await execa(p,["install","-e",a],{cwd:t});}else {o.text="Installing RapidKit from PyPI";try{await execa(p,["install","rapidkit"],{cwd:t});}catch{throw new E}}o.succeed("RapidKit installed");}async function ne(t,e,o,r){e.start("Checking pipx installation");try{await execa("pipx",["--version"]),e.succeed("pipx found");}catch{throw new N}if(e.start("Installing RapidKit globally with pipx"),o){let n=$(r||{});if(!n)throw new I("Test mode installation",new Error("No local RapidKit path configured. Set RAPIDKIT_DEV_PATH environment variable."));s.debug(`Installing from local path: ${n}`),e.text="Installing RapidKit from local path (test mode)",await execa("pipx",["install","-e",n]);}else {e.text="Installing RapidKit from PyPI";try{await execa("pipx",["install","rapidkit"]);}catch{throw new E}}e.succeed("RapidKit installed globally"),await h.outputFile(y.join(t,".rapidkit-global"),`RapidKit installed globally with pipx
+`,"utf-8");}async function ae(t,e){let r=`# RapidKit Workspace
+
+This directory contains a RapidKit development environment.
+
+## Installation Method
+
+**${e==="poetry"?"Poetry":e==="venv"?"Python venv + pip":"pipx (global)"}**
+
+## Getting Started
+
+### 1. Activate Environment
+
+\`\`\`bash
+${e==="poetry"?`source $(poetry env info --path)/bin/activate
+# Or simply use: poetry run rapidkit <command>`:e==="venv"?"source .venv/bin/activate  # On Windows: .venv\\Scripts\\activate":"N/A (globally installed)"}
+\`\`\`
+
+### 2. Create Your First Project
+
+\`\`\`bash
+# Interactive mode (recommended):
+rapidkit create
+# Follow the prompts to choose kit and project name
+
+# Or specify directly:
+rapidkit create project fastapi.standard my-project
+
+# With poetry run (no activation needed):
+poetry run rapidkit create
+\`\`\`
+
+Interactive mode will guide you through selecting a kit and configuring your project.
+
+### 3. Navigate and Run
+
+\`\`\`bash
+cd my-project
+# Install dependencies:
+poetry install
+
+# Run the server (simplest way):
+rapidkit run dev
+
+# Or with poetry run:
+poetry run rapidkit run dev
+
+# Or manually:
+uvicorn src.main:app --reload
+\`\`\`
+
+### 4. Add Modules (Optional)
+
+\`\`\`bash
+# Add common modules to your project:
+rapidkit add module settings
+rapidkit add module logging
+rapidkit add module database
+
+# List available modules:
+rapidkit modules list
+\`\`\`
+
+## Available Commands
+
+- \`rapidkit create\` - Create a new project (interactive)
+- \`rapidkit create project <kit> <name>\` - Create project with specific kit
+- \`rapidkit run dev\` - Run development server
+- \`rapidkit add module <name>\` - Add a module (e.g., \`rapidkit add module settings\`)
+- \`rapidkit list\` - List available kits
+- \`rapidkit modules\` - List available modules
+- \`rapidkit upgrade\` - Upgrade RapidKit
+- \`rapidkit doctor\` - Check system requirements
+- \`rapidkit --help\` - Show all commands
+
+## RapidKit Documentation
+
+For full documentation, visit: [RapidKit Docs](https://rapidkit.dev) *(or appropriate URL)*
+
+## Workspace Structure
+
+\`\`\`
+${e==="venv"?".venv/          # Python virtual environment":""}
+${e==="poetry"?"pyproject.toml  # Poetry configuration":""}
+my-project/     # Your RapidKit projects go here
+README.md       # This file
+\`\`\`
+
+## Troubleshooting
+
+If you encounter issues:
+
+1. Ensure Python 3.10+ is installed: \`python3 --version\`
+2. Check RapidKit installation: \`rapidkit --version\`
+3. Run diagnostics: \`rapidkit doctor\`
+4. Visit RapidKit documentation or GitHub issues
+`;await promises.writeFile(y.join(t,"README.md"),r,"utf-8");}async function se(t,e,o){let r=W("Creating demo workspace").start();try{await h.ensureDir(t),r.succeed("Directory created"),r.start("Setting up demo kit generator");let n=JSON.stringify({name:`${e}-workspace`,version:"1.0.0",private:!0,description:"RapidKit demo workspace",scripts:{generate:"node generate-demo.js"}},null,2);await promises.writeFile(y.join(t,"package.json"),n,"utf-8"),await promises.writeFile(y.join(t,"generate-demo.js"),`#!/usr/bin/env node
+/**
+ * Demo Kit Generator - Create FastAPI demo projects
+ * 
+ * This workspace contains bundled RapidKit templates that you can use
+ * to generate demo projects without installing Python RapidKit.
+ * 
+ * Usage:
+ *   npm run generate <project-name>
+ *   node generate-demo.js <project-name>
+ * 
+ * Example:
+ *   npm run generate my-api
+ */
+
+const { execSync } = require('child_process');
+const path = require('path');
+
+const projectName = process.argv[2];
+
+if (!projectName) {
+  console.error('\\n\u274C Please provide a project name');
+  console.log('\\nUsage: npm run generate <project-name>\\n');
+  console.log('Example: npm run generate my-api\\n');
+  process.exit(1);
+}
+
+// Use npx to run rapidkit in demo mode, targeting the current directory
+const targetPath = path.join(process.cwd(), projectName);
+
+try {
+  console.log(\`\\nGenerating demo project: \${projectName}...\\n\`);
+  execSync(\`npx rapidkit "\${projectName}" --demo-only\`, {
+    stdio: 'inherit',
+    cwd: process.cwd(),
+  });
+  console.log(\`\\n\u2705 Demo project created at: \${targetPath}\\n\`);
+} catch (_error) {
+  console.error('\\n\u274C Failed to generate demo project\\n');
+  process.exit(1);
+}
+`,"utf-8");try{await execa("chmod",["+x",y.join(t,"generate-demo.js")]);}catch{}let p=`# RapidKit Demo Workspace
+
+Welcome to your RapidKit demo workspace! This environment lets you generate FastAPI demo projects using bundled RapidKit templates, without needing to install Python RapidKit.
+
+## \u{1F680} Quick Start
+
+### Generate Your First Demo Project
+
+\`\`\`bash
+# Generate a demo project:
+node generate-demo.js my-api
+
+# Navigate to the project:
+cd my-api
+
+# Install dependencies:
+poetry install
+
+# Run the development server:
+poetry run python -m src.main
+\`\`\`
+
+Your API will be available at \`http://localhost:8000\`
+
+## \u{1F4E6} Generate Multiple Projects
+
+You can create multiple demo projects in this workspace:
+
+\`\`\`bash
+node generate-demo.js api-service
+node generate-demo.js auth-service
+node generate-demo.js data-service
+\`\`\`
+
+Each project is independent and has its own dependencies.
+
+## \u{1F3AF} What's Included
+
+Each generated demo project contains:
+
+- **FastAPI Application** - Modern async web framework
+- **Routing System** - Organized API routes
+- **Module System** - Extensible module architecture
+- **CLI Commands** - Built-in command system
+- **Testing Setup** - pytest configuration
+- **Poetry Configuration** - Dependency management
+
+## \u{1F4DA} Next Steps
+
+1. **Explore the Generated Code** - Check out \`src/main.py\` and \`src/routing/\`
+2. **Add Routes** - Create new endpoints in \`src/routing/\`
+3. **Install Full RapidKit** - For advanced features: \`pipx install rapidkit\`
+4. **Read the Documentation** - Visit [RapidKit Docs](https://rapidkit.dev)
+
+## \u26A0\uFE0F Demo Mode Limitations
+
+This is a demo workspace with:
+- \u2705 Pre-built FastAPI templates
+- \u2705 Project generation without Python RapidKit
+- \u274C No RapidKit CLI commands (\`rapidkit create\`, \`rapidkit add module\`)
+- \u274C No interactive module system
+
+For full RapidKit features, install the Python package:
+
+\`\`\`bash
+pipx install rapidkit
+\`\`\`
+
+## \u{1F6E0}\uFE0F Workspace Structure
+
+\`\`\`
+${e}/
+  \u251C\u2500\u2500 generate-demo.js    # Demo project generator
+  \u251C\u2500\u2500 README.md           # This file
+  \u2514\u2500\u2500 my-api/             # Your generated projects go here
+\`\`\`
+
+## \u{1F4A1} Tips
+
+- Run \`node generate-demo.js --help\` for more options (coming soon)
+- Each project can have different configurations
+- Demo projects are production-ready FastAPI applications
+- You can copy and modify templates as needed
+
+---
+
+**Generated with RapidKit** | [GitHub](https://github.com/getrapidkit/rapidkit-npm)
+`;if(await promises.writeFile(y.join(t,"README.md"),p,"utf-8"),r.succeed("Demo workspace setup complete"),!o){r.start("Initializing git repository");try{await execa("git",["init"],{cwd:t}),await h.outputFile(y.join(t,".gitignore"),`# Dependencies
+node_modules/
+
+# Generated projects
+*/
+!generate-demo.js
+!README.md
+
+# Python
+__pycache__/
+*.pyc
+.venv/
+.env
+`,"utf-8"),await execa("git",["add","."],{cwd:t}),await execa("git",["commit","-m","Initial commit: Demo workspace"],{cwd:t}),r.succeed("Git repository initialized");}catch{r.warn("Could not initialize git repository");}}console.log(i.green(`
+\u2728 Demo workspace created successfully!
+`)),console.log(i.cyan("\u{1F4C2} Location:"),i.white(t)),console.log(i.cyan(`\u{1F680} Get started:
+`)),console.log(i.white(`   cd ${e}`)),console.log(i.white("   node generate-demo.js my-api")),console.log(i.white("   cd my-api")),console.log(i.white("   poetry install")),console.log(i.white("   poetry run python -m src.main")),console.log(),console.log(i.yellow("\u{1F4A1} Note:"),"This is a demo workspace. For full RapidKit features:"),console.log(i.cyan("   pipx install rapidkit")),console.log();}catch(n){throw r.fail("Failed to create demo workspace"),n}}async function le(t,e,o,r){console.log(i.cyan(`
+\u{1F50D} Dry-run mode - showing what would be created:
+`)),console.log(i.white("\u{1F4C2} Project path:"),t),console.log(i.white("\u{1F4E6} Project type:"),o?"Demo workspace":"Full RapidKit environment"),o?(console.log(i.white(`
+\u{1F4DD} Files to create:`)),console.log(i.gray("  - package.json")),console.log(i.gray("  - generate-demo.js (project generator)")),console.log(i.gray("  - README.md")),console.log(i.gray("  - .gitignore")),console.log(i.white(`
+\u{1F3AF} Capabilities:`)),console.log(i.gray("  - Generate multiple FastAPI demo projects")),console.log(i.gray("  - No Python RapidKit installation required")),console.log(i.gray("  - Bundled templates included"))):(console.log(i.white(`
+\u2699\uFE0F  Configuration:`)),console.log(i.gray(`  - Python version: ${r.pythonVersion||"3.11"}`)),console.log(i.gray(`  - Install method: ${r.defaultInstallMethod||"poetry"}`)),console.log(i.gray(`  - Git initialization: ${r.skipGit?"No":"Yes"}`)),console.log(i.white(`
+\u{1F4DD} Files to create:`)),console.log(i.gray("  - pyproject.toml (Poetry) or .venv/ (venv)")),console.log(i.gray("  - README.md")),console.log(i.gray("  - .gitignore")),console.log(i.white(`
+\u{1F3AF} Next steps after creation:`)),console.log(i.gray("  1. Install RapidKit Python package")),console.log(i.gray("  2. Create projects with rapidkit CLI")),console.log(i.gray("  3. Add modules and customize"))),console.log(i.white(`
+\u{1F4A1} To proceed with actual creation, run without --dry-run flag
+`));}var me=fileURLToPath(import.meta.url),ge=y.dirname(me);async function Y(t,e){let o=W("Generating FastAPI demo project...").start();try{let r=y.resolve(ge,".."),n=y.join(r,"templates","kits","fastapi-standard"),m=ce.configure(n,{autoescape:!1,trimBlocks:!0,lstripBlocks:!0}),p={project_name:e.project_name,author:e.author||"RapidKit User",description:e.description||"FastAPI service generated with RapidKit",app_version:e.app_version||"0.1.0",license:e.license||"MIT"},a=["src/main.py.j2","src/__init__.py.j2","src/cli.py.j2","src/routing/__init__.py.j2","src/routing/health.py.j2","src/modules/__init__.py.j2","tests/__init__.py.j2","README.md.j2","pyproject.toml.j2"];for(let f of a){let u=y.join(n,f),v=await promises.readFile(u,"utf-8"),A=m.renderString(v,p),D=f.replace(/\.j2$/,""),O=y.join(t,D);await promises.mkdir(y.dirname(O),{recursive:!0}),await promises.writeFile(O,A);}await promises.writeFile(y.join(t,".gitignore"),`# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+env/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Project specific
+.env
+.env.local
+`),o.succeed("FastAPI demo project generated!"),console.log(`
+${i.green("\u2728 Demo project created successfully!")}
+
+${i.bold("\u{1F4C2} Project structure:")}
+${t}/
+  \u251C\u2500\u2500 src/
+  \u2502   \u251C\u2500\u2500 main.py          # FastAPI application
+  \u2502   \u251C\u2500\u2500 cli.py           # CLI commands
+  \u2502   \u251C\u2500\u2500 routing/         # API routes
+  \u2502   \u2514\u2500\u2500 modules/         # Module system
+  \u251C\u2500\u2500 tests/               # Test suite
+  \u251C\u2500\u2500 pyproject.toml       # Poetry configuration
+  \u2514\u2500\u2500 README.md
+
+${i.bold("\u{1F680} Get started:")}
+  cd ${y.basename(t)}
+  poetry install
+  poetry run python -m src.main
+
+${i.bold("\u{1F4DA} Next steps:")}
+  \u2022 Add RapidKit modules: poetry add rapidkit
+  \u2022 Read the README.md for more information
+  \u2022 Start building your API!
+
+${i.yellow("Note:")} This is a standalone demo. For full RapidKit features and modules,
+install RapidKit Python package: ${i.cyan("pipx install rapidkit")}
+`);}catch(r){throw o.fail("Failed to generate demo project"),r}}var ye="rapidkit",L="1.0.0-beta.7";async function H(){try{s.debug("Checking for updates...");let{stdout:t}=await execa("npm",["view",ye,"version"],{timeout:3e3}),e=t.trim();e&&e!==L?(console.log(i.yellow(`
+\u26A0\uFE0F  Update available: ${L} \u2192 ${e}`)),console.log(i.cyan(`Run: npm install -g rapidkit@latest
+`))):s.debug("You are using the latest version");}catch{s.debug("Could not check for updates");}}function B(){return L}function V(t){let e=he(t);if(!e.validForNewPackages){let r=e.errors||[],n=e.warnings||[],m=[...r,...n];throw new k(t,`NPM validation failed: ${m.join(", ")}`)}if(!/^[a-z][a-z0-9_-]*$/.test(t))throw new k(t,"Must start with a lowercase letter and contain only lowercase letters, numbers, hyphens, and underscores");if(["test","tests","src","dist","build","lib","python","pip","poetry","node","npm","rapidkit","rapidkit"].includes(t.toLowerCase()))throw new k(t,`"${t}" is a reserved name. Please choose a different name.`);if(t.length<2)throw new k(t,"Name must be at least 2 characters long");if(t.length>214)throw new k(t,"Name must be less than 214 characters");return  true}var w=null,M=false,X=new Command;X.name("rapidkit").description("Create a RapidKit development environment or workspace").version(B()).argument("[directory-name]","Name of the workspace or project directory").option("--skip-git","Skip git initialization").option("--test-mode","Install RapidKit from local path (for development/testing only)").option("--demo","Create workspace with demo kit templates (no Python installation required)").option("--demo-only","Generate a demo project in current directory (used by demo workspace)").option("--debug","Enable debug logging").option("--dry-run","Show what would be created without creating it").option("--no-update-check","Skip checking for updates").action(async(t,e)=>{try{e.debug&&(s.setDebug(!0),s.debug("Debug mode enabled"));let o=await z();if(s.debug("User config loaded",o),e.updateCheck!==!1&&await H(),console.log(i.blue.bold(`
+\u{1F680} Welcome to RapidKit!
+`)),e.demoOnly){let n=t||"my-fastapi-project";try{V(n);}catch(a){throw a instanceof g&&(s.error(`
+\u274C ${a.message}`),a.details&&s.warn(`\u{1F4A1} ${a.details}
+`),process.exit(1)),a}let m=y.resolve(process.cwd(),n);if(w=m,e.dryRun){console.log(i.cyan(`
+\u{1F50D} Dry-run mode - showing what would be created:
+`)),console.log(i.white("\u{1F4C2} Project path:"),m),console.log(i.white("\u{1F4E6} Project type:"),"FastAPI demo project"),console.log(i.white("\u{1F4DD} Files to create:")),console.log(i.gray("  - src/main.py")),console.log(i.gray("  - src/cli.py")),console.log(i.gray("  - src/routing/")),console.log(i.gray("  - tests/")),console.log(i.gray("  - pyproject.toml")),console.log(i.gray(`  - README.md
+`));return}let p=await oe.prompt([{type:"input",name:"project_name",message:"Project name (snake_case):",default:n.replace(/-/g,"_"),validate:a=>/^[a-z][a-z0-9_]*$/.test(a)?!0:"Please use snake_case (lowercase with underscores)"},{type:"input",name:"author",message:"Author name:",default:process.env.USER||"RapidKit User"},{type:"input",name:"description",message:"Project description:",default:"FastAPI service generated with RapidKit"}]);await Y(m,p);return}let r=t||"rapidkit-workspace";try{V(r);}catch(n){throw n instanceof g&&(s.error(`
+\u274C ${n.message}`),n.details&&s.warn(`\u{1F4A1} ${n.details}
+`),process.exit(1)),n}if(w=y.resolve(process.cwd(),r),e.demo){console.log(i.gray(`This will create a workspace with demo kit templates.
+You can generate demo projects inside without installing Python RapidKit.
+`)),await U(r,{skipGit:e.skipGit||o.skipGit,testMode:!1,demoMode:!0,dryRun:e.dryRun,userConfig:o});return}console.log(i.yellow.bold(`\u26A0\uFE0F  BETA NOTICE
+`)),console.log(i.yellow(`RapidKit Python package is not yet available on PyPI.
+Full installation mode will be available soon.
+`)),console.log(i.cyan(`For now, please use one of these options:
+`)),console.log(i.white("  1. Demo mode (recommended):")),console.log(i.gray(`     npx rapidkit my-workspace --demo
+`)),console.log(i.white("  2. Test mode (if you have local RapidKit):")),console.log(i.gray(`     npx rapidkit my-workspace --test-mode
+`)),e.testMode||(console.log(i.red(`\u274C Cannot proceed without --demo or --test-mode flag.
+`)),process.exit(1)),console.log(i.yellow(`\u26A0\uFE0F  Running in TEST MODE - Installing from local path
+`)),await U(r,{skipGit:e.skipGit||o.skipGit,testMode:e.testMode,demoMode:!1,dryRun:e.dryRun,userConfig:o});}catch(o){o instanceof g?(s.error(`
+\u274C ${o.message}`),o.details&&s.warn(`\u{1F4A1} ${o.details}`),s.debug("Error code:",o.code)):(s.error(`
+\u274C An unexpected error occurred:`),console.error(o)),process.exit(1);}finally{w=null;}});process.on("SIGINT",async()=>{if(!M){if(M=true,console.log(i.yellow(`
+
+\u26A0\uFE0F  Interrupted by user`)),w&&await h.pathExists(w)){console.log(i.gray("Cleaning up partial installation..."));try{await h.remove(w),console.log(i.green("\u2713 Cleanup complete"));}catch(t){s.debug("Cleanup failed:",t);}}process.exit(130);}});process.on("SIGTERM",async()=>{if(!M){if(M=true,s.debug("Received SIGTERM"),w&&await h.pathExists(w))try{await h.remove(w);}catch(t){s.debug("Cleanup failed:",t);}process.exit(143);}});X.parse();

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "rapidkit",
+  "version": "0.10.0",
+  "type": "module",
+  "description": "Create RapidKit projects with a single command - The official CLI for RapidKit framework",
+  "keywords": [
+    "rapidkit",
+    "cli",
+    "create",
+    "fastapi",
+    "nestjs",
+    "backend",
+    "microservices",
+    "generator",
+    "scaffold"
+  ],
+  "author": "RapidKit Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/getrapidkit/rapidkit-npm.git"
+  },
+  "bin": {
+    "rapidkit": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "build:watch": "tsup --watch",
+    "dev": "tsup --watch",
+    "prepare": "husky",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:e2e": "vitest run src/__tests__/e2e.test.ts",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "typecheck": "tsc --noEmit",
+    "validate": "npm run typecheck && npm run lint && npm run format:check && npm test",
+    "security": "npm audit --audit-level=moderate",
+    "bundle-size": "npm run build && du -sh dist/ && ls -lh dist/"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "execa": "^9.3.1",
+    "fs-extra": "^11.2.0",
+    "inquirer": "^9.2.23",
+    "nunjucks": "^3.2.4",
+    "ora": "^8.0.1",
+    "validate-npm-package-name": "^5.0.1"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^9.0.7",
+    "@types/node": "^20.14.0",
+    "@types/nunjucks": "^3.2.6",
+    "@types/validate-npm-package-name": "^4.0.2",
+    "@typescript-eslint/eslint-plugin": "^8.46.2",
+    "@typescript-eslint/parser": "^8.46.2",
+    "@vitest/coverage-v8": "^2.0.0",
+    "@vitest/ui": "^2.0.0",
+    "eslint": "^8.57.1",
+    "husky": "^9.1.7",
+    "lint-staged": "^15.5.2",
+    "prettier": "^3.6.2",
+    "tsup": "^8.5.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "lint-staged": {
+    "*.ts": [
+      "eslint --fix",
+      "prettier --write"
+    ]
+  },
+  "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e"
+}

package/templates/kits/fastapi-standard/README.md.j2

@@ -0,0 +1,30 @@
+# {{ project_name | replace('_', ' ') | title }}
+
+A minimal FastAPI service generated with the **FastAPI Standard Kit**. All domain-specific capabilities (configuration, logging, persistence, observability, authentication, etc.) are provided by RapidKit modules.
+
+## Quick start
+
+```bash
+poetry install
+poetry run dev
+```
+
+## Available commands
+
+```bash
+poetry run dev      # 🚀 Start development server with hot reload
+poetry run start    # ⚡ Start production server
+poetry run build    # 📦 Build project for production
+poetry run test     # 🧪 Run tests
+```
+
+## Project layout
+
+- `src/main.py` – FastAPI application entrypoint
+- `src/routing/` – Core routers (health) and anchors for module routers
+- `src/modules/` – Module bootstrap anchors
+- `pyproject.toml` – Poetry configuration and dependencies
+
+## Adding features
+
+Use `rapidkit add module <module-name>` to install optional capabilities. Modules inject imports, routes, and services through the anchors defined in `src/main.py` and `src/routing/__init__.py`.

package/templates/kits/fastapi-standard/kit.json

@@ -0,0 +1,70 @@
+{
+  "name": "fastapi-standard",
+  "version": "1.0.0",
+  "description": "Standard FastAPI starter kit with basic project structure",
+  "author": "RapidKit Team",
+  "license": "MIT",
+  "rapidkit_min_version": "2.0.0",
+  "python_min_version": "3.10",
+  "tags": ["fastapi", "python", "api", "backend", "microservices"],
+  "features": [
+    "FastAPI application setup",
+    "Routing system with health check",
+    "Module system for extensibility",
+    "CLI commands via Poetry scripts",
+    "Testing setup with pytest",
+    "Code quality tools (black, ruff, mypy)"
+  ],
+  "files": [
+    "src/main.py",
+    "src/__init__.py",
+    "src/cli.py",
+    "src/routing/__init__.py",
+    "src/routing/health.py",
+    "src/modules/__init__.py",
+    "tests/__init__.py",
+    "README.md",
+    "pyproject.toml"
+  ],
+  "variables": {
+    "project_name": {
+      "type": "string",
+      "description": "Project name (snake_case)",
+      "required": true,
+      "pattern": "^[a-z][a-z0-9_]*$"
+    },
+    "author": {
+      "type": "string",
+      "description": "Project author name",
+      "default": "RapidKit User"
+    },
+    "description": {
+      "type": "string",
+      "description": "Project description",
+      "default": "FastAPI service generated with RapidKit"
+    },
+    "app_version": {
+      "type": "string",
+      "description": "Initial version number",
+      "default": "0.1.0",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "license": {
+      "type": "string",
+      "description": "Project license",
+      "default": "MIT",
+      "enum": ["MIT", "Apache-2.0", "BSD-3-Clause", "GPL-3.0", "Proprietary"]
+    }
+  },
+  "dependencies": {
+    "required": {
+      "python": "^3.10",
+      "poetry": "^1.5.0"
+    },
+    "python_packages": {
+      "fastapi": "^0.100.0",
+      "uvicorn": "^0.23.0",
+      "pydantic": "^2.0.0"
+    }
+  }
+}