rapidkit 0.11.1 → 0.11.3

package/README.md

@@ -30,8 +30,8 @@ cd my-workspace
 # Generate your first project
 node generate-demo.js api-project
 cd api-project
-poetry install
-poetry run dev
+rapidkit init       # Install dependencies
+rapidkit dev        # Start dev server
 
 # Go back and create more projects
 cd ..
@@ -74,14 +74,17 @@ my-workspace/              # Workspace (container)
 ├── package.json          # npm configuration
 ├── README.md             # Workspace instructions
 ├── api-project/          # Project 1
+│   ├── .rapidkit/        # Local CLI (rapidkit init/dev/test)
 │   ├── src/
 │   ├── tests/
 │   └── pyproject.toml
 ├── auth-service/         # Project 2
+│   ├── .rapidkit/
 │   ├── src/
 │   ├── tests/
 │   └── pyproject.toml
 └── data-service/         # Project 3
+    ├── .rapidkit/
     ├── src/
     ├── tests/
     └── pyproject.toml
@@ -299,8 +302,8 @@ npx rapidkit my-workspace --test-mode
 
 3. **Install dependencies and run**:
    ```bash
-   poetry install
-   poetry run dev
+   rapidkit init       # Install dependencies
+   rapidkit dev        # Start dev server
    ```
 
 4. **Create more projects** (go back to workspace):
@@ -335,7 +338,7 @@ npx rapidkit my-workspace --test-mode
 4. **Navigate and run**:
    ```bash
    cd api-service
-   rapidkit run dev
+   rapidkit dev
    ```
 
 5. **Create more projects** (from workspace root):
@@ -421,7 +424,7 @@ After setting up your demo project:
 ## Related Projects
 
 - **RapidKit Python** - The core framework (coming soon to PyPI)
-- **RapidKit Marketplace** - Browse and share modules (https://rapidkit.dev)
+- **RapidKit Marketplace** - Browse and share modules (https://rapidkit.top)
 - **GitHub**: https://github.com/getrapidkit
 
 ## Contributing
@@ -481,7 +484,7 @@ MIT
 ## Support
 
 - 🐛 Report issues: [GitHub Issues](https://github.com/getrapidkit/rapidkit-npm/issues)
-- 📚 Docs: https://rapidkit.dev
+- 📚 Docs: https://rapidkit.top
 - 💬 Community: Coming soon
 
 ---

package/dist/index.js

@@ -1,28 +1,28 @@
 #!/usr/bin/env node
-import {Command}from'commander';import i from'chalk';import {readFileSync,promises}from'fs';import*as h from'fs-extra';import y,{dirname,join}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 je 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 F(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);}},b=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/");}},$=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);}},j=class extends g{constructor(e,o){let r=`Installation failed at: ${e}`,n=`${o.message}
+import {Command}from'commander';import i from'chalk';import {readFileSync,promises}from'fs';import*as y from'fs-extra';import h,{dirname,join}from'path';import oe from'inquirer';import z from'ora';import {execa}from'execa';import ee from'os';import le from'nunjucks';import {fileURLToPath}from'url';import Pe 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 W(){let t=h.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 F(t){return process.env.RAPIDKIT_DEV_PATH||t.testRapidKitPath||void 0}var u=class extends Error{constructor(o,r,a){super(o);this.code=r;this.details=a;this.name="RapidKitError",Error.captureStackTrace(this,this.constructor);}},P=class extends u{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/");}},T=class extends u{constructor(){super("Poetry is not installed","POETRY_NOT_FOUND","Install Poetry from https://python-poetry.org/docs/#installation");}},N=class extends u{constructor(){super("pipx is not installed","PIPX_NOT_FOUND","Install pipx from https://pypa.github.io/pipx/installation/");}},M=class extends u{constructor(e){super(`Directory "${e}" already exists`,"DIRECTORY_EXISTS","Please choose a different name or remove the existing directory");}},k=class extends u{constructor(e,o){super(`Invalid project name: "${e}"`,"INVALID_PROJECT_NAME",o);}},j=class extends u{constructor(e,o){let r=`Installation failed at: ${e}`,a=`${o.message}
 
 Troubleshooting:
 - Check your internet connection
 - Verify Python/Poetry installation
-- Try running with --debug flag for more details`;super(r,"INSTALLATION_ERROR",n);}},x=class extends g{constructor(){super("RapidKit Python package is not yet available on PyPI","RAPIDKIT_NOT_AVAILABLE",`Available options:
+- Try running with --debug flag for more details`;super(r,"INSTALLATION_ERROR",a);}},I=class extends u{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/
+  3. Wait for official PyPI release (coming soon)`);}};async function U(t,e){let{skipGit:o=false,testMode:r=false,demoMode:a=false,dryRun:m=false,userConfig:d={}}=e,n=t,c=h.resolve(process.cwd(),n);if(await y.pathExists(c))throw new M(n);if(m){await ce(c,n,a,d);return}if(a){await se(c,n,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:d.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:d.defaultInstallMethod||"poetry"}]);s.step(1,3,"Setting up RapidKit environment");let g=z("Creating directory").start();try{if(await y.ensureDir(c),g.succeed("Directory created"),f.installMethod==="poetry"?await ie(c,f.pythonVersion,g,r,d):f.installMethod==="venv"?await re(c,f.pythonVersion,g,r,d):await ae(c,g,r,d),await ne(c,f.installMethod),g.succeed("RapidKit environment ready!"),!e.skipGit){g.start("Initializing git repository");try{await execa("git",["init"],{cwd:c}),await y.outputFile(h.join(c,".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(`
+`,"utf-8"),await execa("git",["add","."],{cwd:c}),await execa("git",["commit","-m","Initial commit: RapidKit environment"],{cwd:c}),g.succeed("Git repository initialized");}catch{g.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:C}=await execa("poetry",["--version"]),D=C.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(`
+`)),console.log(i.cyan("\u{1F4C2} Location:"),i.white(c)),console.log(i.cyan(`\u{1F680} Get started:
+`)),console.log(i.white(`   cd ${n}`)),f.installMethod==="poetry"){let v="source $(poetry env info --path)/bin/activate";try{let{stdout:K}=await execa("poetry",["--version"]),b=K.match(/Poetry.*?(\d+)\.(\d+)/);b&&(parseInt(b[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> && rapidkit init && rapidkit 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> && rapidkit init && rapidkit dev"))):(console.log(i.white("   rapidkit create  # Interactive mode")),console.log(i.white("   cd <project-name> && rapidkit init && rapidkit 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 $}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=F(n||{});if(!l)throw new j("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 x}}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 b(e,l);o.succeed(`Python ${l} found`);}catch(a){throw a instanceof b?a:new b(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=F(n||{});if(!a)throw new j("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 x}}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=F(r||{});if(!n)throw new j("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 x}}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
+\u{1F4DA} RapidKit commands:`)),console.log(i.white("   rapidkit create          - Create a new project (interactive)")),console.log(i.white("   rapidkit 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){g.fail("Failed to create RapidKit environment"),console.error(i.red(`
+\u274C Error:`),v);try{await y.remove(c);}catch{}process.exit(1);}}async function ie(t,e,o,r,a){o.start("Checking Poetry installation");try{await execa("poetry",["--version"]),o.succeed("Poetry found");}catch{throw new T}o.start("Initializing Poetry project"),await execa("poetry",["init","--no-interaction","--python",`^${e}`],{cwd:t});let m=h.join(t,"pyproject.toml"),n=(await promises.readFile(m,"utf-8")).replace("[tool.poetry]",`[tool.poetry]
+package-mode = false`);if(await promises.writeFile(m,n,"utf-8"),o.succeed("Poetry project initialized"),o.start("Installing RapidKit"),r){let c=F(a||{});if(!c)throw new j("Test mode installation",new Error("No local RapidKit path configured. Set RAPIDKIT_DEV_PATH environment variable."));s.debug(`Installing from local path: ${c}`),o.text="Installing RapidKit from local path (test mode)",await execa("poetry",["add",c],{cwd:t});}else {o.text="Installing RapidKit from PyPI";try{await execa("poetry",["add","rapidkit"],{cwd:t});}catch{throw new I}}o.succeed("RapidKit installed");}async function re(t,e,o,r,a){o.start(`Checking Python ${e}`);let m="python3";try{let{stdout:n}=await execa(m,["--version"]),c=n.match(/Python (\d+\.\d+)/)?.[1];if(c&&parseFloat(c)<parseFloat(e))throw new P(e,c);o.succeed(`Python ${c} found`);}catch(n){throw n instanceof P?n:new P(e)}o.start("Creating virtual environment"),await execa(m,["-m","venv",".venv"],{cwd:t}),o.succeed("Virtual environment created"),o.start("Installing RapidKit");let d=h.join(t,".venv","bin","pip");if(await execa(d,["install","--upgrade","pip"],{cwd:t}),r){let n=F(a||{});if(!n)throw new j("Test mode installation",new Error("No local RapidKit path configured. Set RAPIDKIT_DEV_PATH environment variable."));s.debug(`Installing from local path: ${n}`),o.text="Installing RapidKit from local path (test mode)",await execa(d,["install","-e",n],{cwd:t});}else {o.text="Installing RapidKit from PyPI";try{await execa(d,["install","rapidkit"],{cwd:t});}catch{throw new I}}o.succeed("RapidKit installed");}async function ae(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 a=F(r||{});if(!a)throw new j("Test mode installation",new Error("No local RapidKit path configured. Set RAPIDKIT_DEV_PATH environment variable."));s.debug(`Installing from local path: ${a}`),e.text="Installing RapidKit from local path (test mode)",await execa("pipx",["install","-e",a]);}else {e.text="Installing RapidKit from PyPI";try{await execa("pipx",["install","rapidkit"]);}catch{throw new I}}e.succeed("RapidKit installed globally"),await y.outputFile(h.join(t,".rapidkit-global"),`RapidKit installed globally with pipx
+`,"utf-8");}async function ne(t,e){let r=`# RapidKit Workspace
 
 This directory contains a RapidKit development environment.
 
@@ -59,14 +59,14 @@ Interactive mode will guide you through selecting a kit and configuring your pro
 
 \`\`\`bash
 cd my-project
-# Install dependencies:
-poetry install
+# Install dependencies (preferred):
+rapidkit init
 
-# Run the server (simplest way):
-rapidkit run dev
+# Run the server (project-aware):
+rapidkit dev
 
-# Or with poetry run:
-poetry run rapidkit run dev
+# Or with poetry run (manual / advanced):
+poetry run rapidkit dev
 
 # Or manually:
 uvicorn src.main:app --reload
@@ -88,7 +88,7 @@ rapidkit modules list
 
 - \`rapidkit create\` - Create a new project (interactive)
 - \`rapidkit create project <kit> <name>\` - Create project with specific kit
-- \`rapidkit run dev\` - Run development server
+- \`rapidkit 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
@@ -98,7 +98,7 @@ rapidkit modules list
 
 ## RapidKit Documentation
 
-For full documentation, visit: [RapidKit Docs](https://rapidkit.dev) *(or appropriate URL)*
+For full documentation, visit: [RapidKit Docs](https://rapidkit.top) *(or appropriate URL)*
 
 ## Workspace Structure
 
@@ -117,7 +117,7 @@ If you encounter issues:
 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
+`;await promises.writeFile(h.join(t,"README.md"),r,"utf-8");}async function se(t,e,o){let r=z("Creating demo workspace").start();try{await y.ensureDir(t),r.succeed("Directory created"),r.start("Setting up demo kit generator");let a=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(h.join(t,"package.json"),a,"utf-8"),await promises.writeFile(h.join(t,"generate-demo.js"),`#!/usr/bin/env node
 /**
  * Demo Kit Generator - Create FastAPI demo projects
  * 
@@ -132,8 +132,9 @@ If you encounter issues:
  *   npm run generate my-api
  */
 
-const { execSync } = require('child_process');
+const fs = require('fs');
 const path = require('path');
+const readline = require('readline');
 
 const projectName = process.argv[2];
 
@@ -144,21 +145,375 @@ if (!projectName) {
   process.exit(1);
 }
 
-// Use npx to run rapidkit in demo mode, targeting the current directory
-const targetPath = path.join(process.cwd(), projectName);
+const rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout
+});
 
-try {
-  console.log(\`\\nGenerating demo project: \${projectName}...\\n\`);
-  execSync(\`npx rapidkit "\${projectName}" --demo-only\`, {
-    stdio: 'inherit',
-    cwd: process.cwd(),
+function ask(question, defaultValue) {
+  return new Promise((resolve) => {
+    rl.question(\`\${question} (\${defaultValue}): \`, (answer) => {
+      resolve(answer || defaultValue);
+    });
   });
-  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
+
+async function main() {
+  const targetPath = path.join(process.cwd(), projectName);
+  
+  if (fs.existsSync(targetPath)) {
+    console.error(\`\\n\u274C Directory "\${projectName}" already exists\\n\`);
+    process.exit(1);
+  }
+
+  console.log(\`\\n\u{1F680} Creating FastAPI project: \${projectName}\\n\`);
+  
+  const snakeName = projectName.replace(/-/g, '_').toLowerCase();
+  const project_name = await ask('Project name (snake_case)', snakeName);
+  const author = await ask('Author name', process.env.USER || 'RapidKit User');
+  const description = await ask('Description', 'FastAPI service generated with RapidKit');
+  
+  rl.close();
+
+  // Create project structure
+  const dirs = [
+    '',
+    'src',
+    'src/routing',
+    'src/modules',
+    'tests',
+    '.rapidkit'
+  ];
+
+  for (const dir of dirs) {
+    fs.mkdirSync(path.join(targetPath, dir), { recursive: true });
+  }
+
+  // Template files with content
+  const files = {
+    'src/__init__.py': '"""' + project_name + ' package."""\\n',
+    'src/modules/__init__.py': '"""Modules package."""\\n',
+    'tests/__init__.py': '"""Tests package."""\\n',
+    'src/main.py': \`"""\${project_name} application entrypoint."""
+
+from __future__ import annotations
+
+from contextlib import asynccontextmanager
+from typing import AsyncIterator
+
+from fastapi import FastAPI
+from fastapi.middleware.cors import CORSMiddleware
+
+from .routing import api_router
+
+
+@asynccontextmanager
+async def lifespan(app: FastAPI) -> AsyncIterator[None]:
+    """Application lifespan context manager for startup/shutdown events."""
+    yield
+
+
+app = FastAPI(
+    title="\${project_name}",
+    description="\${description}",
+    version="0.1.0",
+    docs_url="/docs",
+    redoc_url="/redoc",
+    lifespan=lifespan,
+)
+
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["*"],
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+app.include_router(api_router, prefix="/api")
+
+
+if __name__ == "__main__":
+    import uvicorn
+    uvicorn.run("src.main:app", host="0.0.0.0", port=8001, reload=True)
+\`,
+    'src/routing/__init__.py': \`"""API routing configuration."""
+
+from fastapi import APIRouter
+
+from .health import router as health_router
+
+api_router = APIRouter()
+
+api_router.include_router(health_router)
+\`,
+    'src/routing/health.py': \`"""Health check endpoints."""
+
+from __future__ import annotations
+
+from fastapi import APIRouter
+
+router = APIRouter(prefix="/health", tags=["health"])
+
+
+@router.get("/", summary="Health check")
+async def heartbeat() -> dict[str, str]:
+    """Return basic service heartbeat."""
+    return {"status": "ok"}
+\`,
+    'src/cli.py': \`"""CLI commands for \${project_name}."""
+
+import subprocess
+import sys
+from pathlib import Path
+
+
+def dev():
+    """Start development server with hot reload."""
+    print("\u{1F680} Starting development server...")
+    subprocess.run([
+        sys.executable, "-m", "uvicorn",
+        "src.main:app", "--reload",
+        "--host", "0.0.0.0", "--port", "8000"
+    ])
+
+
+def start():
+    """Start production server."""
+    print("\u26A1 Starting production server...")
+    subprocess.run([
+        sys.executable, "-m", "uvicorn",
+        "src.main:app",
+        "--host", "0.0.0.0", "--port", "8000"
+    ])
+
+
+def test():
+    """Run tests."""
+    print("\u{1F9EA} Running tests...")
+    subprocess.run([sys.executable, "-m", "pytest", "-q"])
+
+
+if __name__ == "__main__":
+    if len(sys.argv) < 2:
+        print("Usage: python -m src.cli <command>")
+        print("Commands: dev, start, test")
+        sys.exit(1)
+    
+    cmd = sys.argv[1]
+    if cmd == "dev":
+        dev()
+    elif cmd == "start":
+        start()
+    elif cmd == "test":
+        test()
+    else:
+        print(f"Unknown command: {cmd}")
+        sys.exit(1)
+\`,
+    'pyproject.toml': \`[tool.poetry]
+name = "\${project_name}"
+version = "0.1.0"
+description = "\${description}"
+authors = ["\${author}"]
+license = "MIT"
+readme = "README.md"
+package-mode = false
+
+[tool.poetry.dependencies]
+python = "^3.11"
+fastapi = "^0.115.0"
+uvicorn = {extras = ["standard"], version = "^0.32.0"}
+pydantic = "^2.0"
+pydantic-settings = "^2.0"
+
+[tool.poetry.group.dev.dependencies]
+pytest = "^8.0"
+pytest-asyncio = "^0.24.0"
+pytest-cov = "^6.0"
+httpx = "^0.27"
+black = "^24.0"
+ruff = "^0.8"
+mypy = "^1.0"
+
+[tool.poetry.scripts]
+dev = "src.cli:dev"
+start = "src.cli:start"
+test = "src.cli:test"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.black]
+line-length = 100
+target-version = ["py311"]
+\`,
+    'README.md': \`# \${project_name}
+
+\${description}
+
+## Quick start
+
+\\\`\\\`\\\`bash
+rapidkit init       # Install dependencies
+rapidkit dev        # Start dev server
+\\\`\\\`\\\`
+
+## Available commands
+
+\\\`\\\`\\\`bash
+rapidkit init       # \u{1F527} Install dependencies
+rapidkit dev        # \u{1F680} Start development server with hot reload
+rapidkit start      # \u26A1 Start production server
+rapidkit test       # \u{1F9EA} Run tests
+rapidkit help       # \u{1F4DA} Show available commands
+\\\`\\\`\\\`
+
+## Project layout
+
+\\\`\\\`\\\`
+\${project_name}/
+\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
+\\\`\\\`\\\`
+\`,
+    '.rapidkit/project.json': JSON.stringify({
+      kit_name: "fastapi.standard",
+      profile: "fastapi/standard",
+      created_at: new Date().toISOString(),
+      rapidkit_version: "npm-demo"
+    }, null, 2),
+    '.rapidkit/cli.py': \`#!/usr/bin/env python3
+"""RapidKit CLI wrapper for demo projects."""
+
+import subprocess
+import sys
+from pathlib import Path
+
+
+def dev(port=8000, host="0.0.0.0"):
+    """Start development server."""
+    print("\u{1F680} Starting development server with hot reload...")
+    subprocess.run([
+        sys.executable, "-m", "uvicorn",
+        "src.main:app", "--reload",
+        "--host", host, "--port", str(port)
+    ])
+
+
+def start(port=8000, host="0.0.0.0"):
+    """Start production server."""
+    print("\u26A1 Starting production server...")
+    subprocess.run([
+        sys.executable, "-m", "uvicorn",
+        "src.main:app",
+        "--host", host, "--port", str(port)
+    ])
+
+
+def init():
+    """Install dependencies."""
+    print("\u{1F4E6} Installing dependencies...")
+    subprocess.run(["poetry", "install"])
+
+
+def test():
+    """Run tests."""
+    print("\u{1F9EA} Running tests...")
+    subprocess.run([sys.executable, "-m", "pytest", "-q"])
+
+
+def help_cmd():
+    """Show help."""
+    print("\u{1F4DA} Available commands:")
+    print("  init   - Install dependencies")
+    print("  dev    - Start dev server")
+    print("  start  - Start production server")
+    print("  test   - Run tests")
+
+
+if __name__ == "__main__":
+    cmd = sys.argv[1] if len(sys.argv) > 1 else "help"
+    cmds = {"dev": dev, "start": start, "init": init, "test": test, "help": help_cmd}
+    cmds.get(cmd, help_cmd)()
+\`,
+    '.rapidkit/rapidkit': '#!/usr/bin/env bash\\n# Local RapidKit launcher for demo projects\\nset -euo pipefail\\nSCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"\\nROOT_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"\\ncd "$ROOT_DIR"\\n\\nif [ -f "pyproject.toml" ]; then\\n  if command -v poetry >/dev/null 2>&1; then\\n    exec poetry run python "$SCRIPT_DIR/cli.py" "$@"\\n  fi\\nfi\\n\\necho "Poetry not found. Install with: pip install poetry"\\nexit 1\\n',
+    '.gitignore': \`# Python
+__pycache__/
+*.py[cod]
+*.so
+.Python
+build/
+dist/
+*.egg-info/
+
+# Virtual environments
+.venv/
+venv/
+
+# IDEs
+.vscode/
+.idea/
+
+# OS
+.DS_Store
+
+# Project
+.env
+.env.local
+\`
+  };
+
+  for (const [filePath, content] of Object.entries(files)) {
+    fs.writeFileSync(path.join(targetPath, filePath), content);
+  }
+
+  // Make scripts executable
+  try {
+    fs.chmodSync(path.join(targetPath, '.rapidkit/cli.py'), 0o755);
+    fs.chmodSync(path.join(targetPath, '.rapidkit/rapidkit'), 0o755);
+  } catch (e) {
+    // Ignore on Windows
+  }
+
+  console.log(\`
+\u2728 Demo project created successfully!
+
+\u{1F4C2} Project: \${targetPath}
+
+\u{1F680} Get started:
+  cd \${projectName}
+  rapidkit init       # Install dependencies
+  rapidkit dev        # Start dev server
+
+\u{1F4DA} Available commands:
+  rapidkit init       # \u{1F527} Install dependencies
+  rapidkit dev        # \u{1F680} Start dev server with hot reload
+  rapidkit start      # \u26A1 Start production server
+  rapidkit test       # \u{1F9EA} Run tests
+  rapidkit help       # \u{1F4DA} Show help
+
+\u{1F4A1} For full RapidKit features: pipx install rapidkit
+\`);
+}
+
+main().catch(console.error);
+`,"utf-8");try{await execa("chmod",["+x",h.join(t,"generate-demo.js")]);}catch{}let d=`# 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.
 
@@ -174,10 +529,10 @@ node generate-demo.js my-api
 cd my-api
 
 # Install dependencies:
-poetry install
+rapidkit init
 
 # Run the development server:
-poetry run python -m src.main
+rapidkit dev
 \`\`\`
 
 Your API will be available at \`http://localhost:8000\`
@@ -210,7 +565,7 @@ Each generated demo project contains:
 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)
+4. **Read the Documentation** - Visit [RapidKit Docs](https://rapidkit.top)
 
 ## \u26A0\uFE0F Demo Mode Limitations
 
@@ -245,7 +600,7 @@ ${e}/
 ---
 
 **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
+`;if(await promises.writeFile(h.join(t,"README.md"),d,"utf-8"),r.succeed("Demo workspace setup complete"),!o){r.start("Initializing git repository");try{await execa("git",["init"],{cwd:t}),await y.outputFile(h.join(t,".gitignore"),`# Dependencies
 node_modules/
 
 # Generated projects
@@ -261,7 +616,7 @@ __pycache__/
 `,"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(`
+`)),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("   rapidkit init")),console.log(i.white("   rapidkit dev")),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(a){throw r.fail("Failed to create demo workspace"),a}}async function ce(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(`
@@ -270,7 +625,7 @@ __pycache__/
 \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"),C=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,C);}await promises.writeFile(y.join(t,".gitignore"),`# Python
+`));}var me=fileURLToPath(import.meta.url),ue=h.dirname(me);async function q(t,e){let o=z("Generating FastAPI demo project...").start();try{let r=h.resolve(ue,".."),a=h.join(r,"templates","kits","fastapi-standard"),m=le.configure(a,{autoescape:!1,trimBlocks:!0,lstripBlocks:!0}),d={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"},n=["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",".rapidkit/project.json.j2",".rapidkit/cli.py.j2",".rapidkit/rapidkit.j2"];for(let f of n){let g=h.join(a,f),v=await promises.readFile(g,"utf-8"),K=m.renderString(v,d),b=f.replace(/\.j2$/,""),D=h.join(t,b);await promises.mkdir(h.dirname(D),{recursive:!0}),await promises.writeFile(D,K),(b===".rapidkit/rapidkit"||b===".rapidkit/cli.py")&&await promises.chmod(D,493);}await promises.writeFile(h.join(t,".gitignore"),`# Python
 __pycache__/
 *.py[cod]
 *$py.class
@@ -317,6 +672,10 @@ ${i.green("\u2728 Demo project created successfully!")}
 
 ${i.bold("\u{1F4C2} Project structure:")}
 ${t}/
+  \u251C\u2500\u2500 .rapidkit/           # RapidKit project config
+  \u2502   \u251C\u2500\u2500 project.json     # Project metadata
+  \u2502   \u251C\u2500\u2500 cli.py           # Local CLI handler
+  \u2502   \u2514\u2500\u2500 rapidkit         # Local launcher
   \u251C\u2500\u2500 src/
   \u2502   \u251C\u2500\u2500 main.py          # FastAPI application
   \u2502   \u251C\u2500\u2500 cli.py           # CLI commands
@@ -327,29 +686,32 @@ ${t}/
   \u2514\u2500\u2500 README.md
 
 ${i.bold("\u{1F680} Get started:")}
-  cd ${y.basename(t)}
+  cd ${h.basename(t)}
   poetry install
-  poetry run python -m src.main
+  rapidkit dev             # or: 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.bold("\u{1F4DA} Available commands:")}
+  rapidkit init            # Install dependencies
+  rapidkit dev             # Start dev server with hot reload
+  rapidkit start           # Start production server
+  rapidkit test            # Run tests
+  rapidkit lint            # Lint code
+  rapidkit format          # Format code
 
 ${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 ve="rapidkit",ke=fileURLToPath(import.meta.url),Re=dirname(ke),Pe=join(Re,"..","package.json"),be=JSON.parse(readFileSync(Pe,"utf-8")),L=be.version;async function H(){try{s.debug("Checking for updates...");let{stdout:t}=await execa("npm",["view",ve,"version"],{timeout:3e3}),e=t.trim();e&&e!==L?(console.log(i.yellow(`
+`);}catch(r){throw o.fail("Failed to generate demo project"),r}}var ve="rapidkit",ke=fileURLToPath(import.meta.url),_e=dirname(ke),Re=join(_e,"..","package.json"),be=JSON.parse(readFileSync(Re,"utf-8")),L=be.version;async function H(){try{s.debug("Checking for updates...");let{stdout:t}=await execa("npm",["view",ve,"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 J(){return L}function V(t){let e=je(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(J()).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(`
+`))):s.debug("You are using the latest version");}catch{s.debug("Could not check for updates");}}function J(){return L}function V(t){let e=Pe(t);if(!e.validForNewPackages){let r=e.errors||[],a=e.warnings||[],m=[...r,...a];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,O=false,Q=new Command;Q.name("rapidkit").description("Create a RapidKit development environment or workspace").version(J()).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 W();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(`
+`)),e.demoOnly){let a=t||"my-fastapi-project";try{V(a);}catch(n){throw n instanceof u&&(s.error(`
+\u274C ${n.message}`),n.details&&s.warn(`\u{1F4A1} ${n.details}
+`),process.exit(1)),n}let m=h.resolve(process.cwd(),a);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.
+`));return}let d=await oe.prompt([{type:"input",name:"project_name",message:"Project name (snake_case):",default:a.replace(/-/g,"_"),validate:n=>/^[a-z][a-z0-9_]*$/.test(n)?!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 q(m,d);return}let r=t||"rapidkit-workspace";try{V(r);}catch(a){throw a instanceof u&&(s.error(`
+\u274C ${a.message}`),a.details&&s.warn(`\u{1F4A1} ${a.details}
+`),process.exit(1)),a}if(w=h.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.
@@ -359,8 +721,8 @@ Full installation mode will be available soon.
 `)),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(`
+`)),await U(r,{skipGit:e.skipGit||o.skipGit,testMode:e.testMode,demoMode:!1,dryRun:e.dryRun,userConfig:o});}catch(o){o instanceof u?(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(`
+\u274C An unexpected error occurred:`),console.error(o)),process.exit(1);}finally{w=null;}});process.on("SIGINT",async()=>{if(!O){if(O=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();
+\u26A0\uFE0F  Interrupted by user`)),w&&await y.pathExists(w)){console.log(i.gray("Cleaning up partial installation..."));try{await y.remove(w),console.log(i.green("\u2713 Cleanup complete"));}catch(t){s.debug("Cleanup failed:",t);}}process.exit(130);}});process.on("SIGTERM",async()=>{if(!O){if(O=true,s.debug("Received SIGTERM"),w&&await y.pathExists(w))try{await y.remove(w);}catch(t){s.debug("Cleanup failed:",t);}process.exit(143);}});Q.parse();

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rapidkit",
-  "version": "0.11.1",
+  "version": "0.11.3",
   "type": "module",
   "description": "Create RapidKit projects with a single command - The official CLI for RapidKit framework",
   "keywords": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rapidkit",
-  "version": "0.11.1",
+  "version": "0.11.3",
   "type": "module",
   "description": "Create RapidKit projects with a single command - The official CLI for RapidKit framework",
   "keywords": [

package/templates/kits/fastapi-standard/.rapidkit/cli.py.j2

@@ -0,0 +1,255 @@
+#!/usr/bin/env python3
+"""RapidKit CLI wrapper (npm demo template)
+
+This file provides local project commands for demo projects generated
+via npx rapidkit --demo. It mimics the behavior of the full RapidKit
+engine for dev, start, test, lint, and format commands.
+"""
+
+import subprocess
+import shutil
+import sys
+from pathlib import Path
+import socket
+from typing import Any
+
+
+def _print_banner(emoji: str, message: str) -> None:
+    print(f"{emoji} {message}")
+
+
+def _run(*cmd: Any, cwd: Path | str | None = None, env: dict | None = None) -> int:
+    try:
+        run_env = None
+        if env is not None:
+            import os as _os
+            run_env = _os.environ.copy()
+            run_env.update(env)
+
+        proc = subprocess.run([str(c) for c in cmd], cwd=str(cwd) if cwd else None, env=run_env)
+        return proc.returncode
+    except KeyboardInterrupt:
+        print("\n🛑 Command interrupted by user")
+        return 130
+    except Exception as exc:
+        print(f"❌ Error running command: {exc}")
+        return 1
+
+
+def _project_type(root: Path) -> str:
+    if (root / "pyproject.toml").exists():
+        return "python"
+    if (root / "package.json").exists():
+        return "node"
+    return "unknown"
+
+
+def _python_module(module: str, *module_args: str) -> int:
+    return _run(sys.executable, "-m", module, *module_args)
+
+
+def _python_code_targets(root: Path) -> list[str]:
+    targets: list[str] = []
+    for name in ("src", "tests"):
+        if (root / name).exists():
+            targets.append(name)
+    return targets or ["src"]
+
+
+def _venv_has_uvicorn(venv_path: Path) -> bool:
+    if (venv_path / "bin" / "uvicorn").exists():
+        return True
+    for p in venv_path.rglob("site-packages/*"):
+        name = p.name.lower()
+        if "uvicorn" in name or "fastapi" in name:
+            return True
+    return False
+
+
+def dev(port: int = 8000, host: str = "0.0.0.0", allow_global_runtime: bool = False) -> None:
+    """Start development server with reload"""
+    _print_banner("🚀", "Starting development server with hot reload...")
+    root = Path.cwd()
+    ptype = _project_type(root)
+
+    if ptype == "python":
+        venv_dir = root / ".venv"
+
+        if venv_dir.exists():
+            if not _venv_has_uvicorn(venv_dir):
+                print("❌ Project .venv was found but uvicorn/fastapi doesn't appear installed.")
+                print("💡 Run 'poetry install' to install dependencies.")
+                sys.exit(1)
+        else:
+            if not allow_global_runtime:
+                print("❌ Project environment not bootstrapped (no .venv found).")
+                print("")
+                print("💡 Initialize and install dependencies with:")
+                print("")
+                print("  poetry install")
+                print("")
+                print("If you intentionally want to use the system Python, run:")
+                print("")
+                print("  rapidkit dev --allow-global-runtime")
+                print("")
+                sys.exit(1)
+
+            if shutil.which("uvicorn") is None:
+                print("❌ No uvicorn executable found on PATH and no .venv present.")
+                print("")
+                print("💡 Install dependencies with: poetry install")
+                print("")
+                sys.exit(1)
+            print("⚠️  Running with system/global Python runtime.")
+
+        rc = _run(sys.executable, "-m", "uvicorn", "src.main:app", "--reload", "--host", host, "--port", str(port))
+        if rc != 0:
+            sys.exit(rc)
+    else:
+        print("❌ Unknown project type. Ensure pyproject.toml exists.")
+        sys.exit(1)
+
+
+def init() -> None:
+    """Bootstrap project: install dependencies"""
+    _print_banner("🚀", "Bootstrapping project (installing dependencies)")
+    root = Path.cwd()
+    ptype = _project_type(root)
+    
+    if ptype == "python":
+        if shutil.which("poetry"):
+            rc = _run("poetry", "install")
+            if rc != 0:
+                print("❌ Failed to install dependencies via poetry.")
+                sys.exit(rc)
+            print("✅ Dependencies installed successfully!")
+        else:
+            print("❌ Poetry not found. Install it with: pip install poetry")
+            sys.exit(1)
+    else:
+        print("❌ Unknown project type. Ensure pyproject.toml exists.")
+        sys.exit(1)
+
+
+def start(port: int = 8000, host: str = "0.0.0.0", allow_global_runtime: bool = False) -> None:
+    """Start production server"""
+    _print_banner("⚡", "Starting production server...")
+    root = Path.cwd()
+    ptype = _project_type(root)
+    
+    if ptype == "python":
+        venv_dir = root / ".venv"
+        if venv_dir.exists():
+            if not _venv_has_uvicorn(venv_dir):
+                print("❌ Project .venv was found but uvicorn/fastapi doesn't appear installed.")
+                print("💡 Run 'poetry install' to install dependencies.")
+                sys.exit(1)
+        else:
+            if not allow_global_runtime:
+                print("❌ Project environment not bootstrapped (no .venv found).")
+                print("💡 Run 'poetry install' to install dependencies.")
+                sys.exit(1)
+
+        rc = _run(sys.executable, "-m", "uvicorn", "src.main:app", "--host", host, "--port", str(port))
+        if rc != 0:
+            sys.exit(rc)
+    else:
+        print("❌ Unknown project type.")
+        sys.exit(1)
+
+
+def build() -> None:
+    """Build project"""
+    _print_banner("📦", "Building project")
+    rc = _python_module("build")
+    if rc != 0:
+        sys.exit(rc)
+
+
+def test() -> None:
+    """Run tests"""
+    _print_banner("🧪", "Running tests")
+    rc = _python_module("pytest", "-q")
+    if rc != 0:
+        sys.exit(rc)
+
+
+def lint() -> None:
+    """Run linting"""
+    _print_banner("🔧", "Running lint")
+    root = Path.cwd()
+    targets = _python_code_targets(root)
+    rc = _python_module("ruff", "check", *targets)
+    if rc == 0:
+        rc = _python_module("black", "--check", *targets)
+    if rc != 0:
+        sys.exit(rc)
+
+
+def format_code() -> None:
+    """Format code"""
+    _print_banner("✨", "Formatting")
+    root = Path.cwd()
+    targets = _python_code_targets(root)
+    rc = _python_module("ruff", "check", *targets, "--fix")
+    if rc == 0:
+        rc = _python_module("black", *targets)
+    if rc != 0:
+        sys.exit(rc)
+
+
+def help_cmd() -> None:
+    """Show help"""
+    _print_banner("📚", "Project Commands")
+    print("Usage: rapidkit <command> [args...]\n")
+    print("  init     📦 Initialize project (install deps)")
+    print("  dev      🚀 Start development server")
+    print("  start    ⚡ Start production server")
+    print("  build    📦 Build for production")
+    print("  test     🧪 Run tests")
+    print("  lint     🔧 Lint code")
+    print("  format   ✨ Format code")
+    print("  help     📚 Show help")
+    print("")
+    print("💡 Note: This is a demo project. For full RapidKit features:")
+    print("   pipx install rapidkit")
+
+
+def main():
+    if len(sys.argv) < 2 or sys.argv[1] in ("-h", "--help", "help"):
+        help_cmd()
+        return
+
+    command = sys.argv[1]
+    args = sys.argv[2:]
+
+    commands = {
+        "init": init,
+        "dev": dev,
+        "start": start,
+        "build": build,
+        "test": test,
+        "lint": lint,
+        "format": format_code,
+        "help": help_cmd,
+    }
+
+    if command not in commands:
+        print(f"❌ Unknown command: {command}")
+        help_cmd()
+        sys.exit(1)
+
+    if command in ("dev", "start"):
+        import argparse as _arg
+        _parser = _arg.ArgumentParser(prog=f"rapidkit {command}")
+        _parser.add_argument("-p", "--port", dest="port", type=int, default=8000)
+        _parser.add_argument("--host", dest="host", default="0.0.0.0")
+        _parser.add_argument("--allow-global-runtime", action="store_true", dest="allow_global_runtime")
+        _ns, _extra = _parser.parse_known_args(args)
+        commands[command](port=_ns.port, host=_ns.host, allow_global_runtime=_ns.allow_global_runtime)
+    else:
+        commands[command]()
+
+
+if __name__ == "__main__":
+    main()

package/templates/kits/fastapi-standard/.rapidkit/project.json.j2

@@ -0,0 +1,6 @@
+{
+  "kit_name": "fastapi.standard",
+  "profile": "fastapi/standard",
+  "created_at": "{{ created_at | default(now) }}",
+  "rapidkit_version": "npm-demo"
+}

package/templates/kits/fastapi-standard/.rapidkit/rapidkit.j2

@@ -0,0 +1,67 @@
+#!/usr/bin/env bash
+# Local RapidKit project launcher (npm demo template)
+# This script provides local project commands for demo projects.
+
+set -euo pipefail
+ROOT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+
+# Detect project type
+if [ -f "$ROOT_DIR/pyproject.toml" ]; then
+  PKG_TYPE="python"
+elif [ -f "$ROOT_DIR/package.json" ]; then
+  PKG_TYPE="node"
+else
+  PKG_TYPE="unknown"
+fi
+
+VENV_PY="${ROOT_DIR}/.venv/bin/python"
+VENV_POETRY="${ROOT_DIR}/.venv/bin/poetry"
+
+case "$PKG_TYPE" in
+  python)
+    # prefer project-local poetry
+    if [ -x "$VENV_POETRY" ]; then
+      if [ "${1:-}" = "init" ]; then
+        exec "$VENV_POETRY" "install"
+      else
+        exec "$VENV_POETRY" "run" "$@"
+      fi
+    fi
+
+    # then prefer poetry on PATH
+    if command -v poetry >/dev/null 2>&1; then
+      if [ "${1:-}" = "init" ]; then
+        exec poetry "install"
+      else
+        exec poetry "run" "$@"
+      fi
+    fi
+
+    # If venv python exists, try installing poetry into it
+    if [ -x "$VENV_PY" ]; then
+      echo "⚠️  Poetry not found. Installing poetry into project .venv..."
+      "$VENV_PY" -m pip install --upgrade pip >/dev/null 2>&1 || true
+      "$VENV_PY" -m pip install poetry >/dev/null 2>&1 || true
+      if [ -x "$VENV_POETRY" ]; then
+        if [ "${1:-}" = "init" ]; then
+          exec "$VENV_POETRY" "install"
+        else
+          exec "$VENV_POETRY" "run" "$@"
+        fi
+      else
+        echo "❌ Failed to locate poetry after installation."
+        exit 1
+      fi
+    fi
+
+    echo "❌ Poetry is not available and no project .venv exists."
+    echo "💡 Run: 'poetry install' to bootstrap the project, or install poetry: 'pip install poetry'"
+    exit 127
+    ;;
+
+  *)
+    echo "❌ Could not detect project type (pyproject.toml missing)."
+    echo "💡 This appears to be a demo project. Run 'poetry install' to set up."
+    exit 127
+    ;;
+esac

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

@@ -5,17 +5,18 @@ A minimal FastAPI service generated with the **FastAPI Standard Kit**. All domai
 ## Quick start
 
 ```bash
-poetry install
-poetry run dev
+rapidkit init  # bootstrap the project (preferred)
+rapidkit 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
+rapidkit init       # 🔧 Install dependencies
+rapidkit dev        # 🚀 Start development server with hot reload
+rapidkit start      # ⚡ Start production server
+rapidkit test       # 🧪 Run tests
+rapidkit help       # 📚 Show available commands
 ```
 
 ## Project layout

package/templates/kits/fastapi-standard/src/cli.py.j2

@@ -95,7 +95,8 @@ def dev() -> None:
     """🚀 Start development server with hot reload
 
     Usage:
-        poetry run dev [options]
+        rapidkit dev [options]  # preferred (project-aware)
+        # or: poetry run dev [options]
 
     Options:
         --port, -p PORT     Server port (default: 8000)
@@ -103,9 +104,10 @@ def dev() -> None:
         --env, -e ENV       Environment (default: development)
 
     Examples:
-        poetry run dev
-        poetry run dev --port 3000
-        poetry run dev --host 127.0.0.1 --port 8080
+        rapidkit dev
+        rapidkit dev --port 3000
+        rapidkit dev --host 127.0.0.1 --port 8080
+        # or: poetry run dev --port 3000
     """
     _print_banner("🚀", "Starting development server with hot reload...")
     _print_banner("📁", f"Working directory: {Path.cwd()}")
@@ -175,7 +177,7 @@ def build() -> None:
         _print_error(f"Build failed: {e}")
         sys.exit(1)
     except FileNotFoundError:
-        _print_error("Build tools not found. Install with: poetry install --group dev")
+        _print_error("Build tools not found. Install with: rapidkit init (or: poetry install --group dev)")
         sys.exit(1)
 
 
@@ -214,7 +216,7 @@ def test() -> None:
             sys.exit(result.returncode)
 
     except FileNotFoundError:
-        _print_error("pytest not found. Install with: poetry install --group dev")
+        _print_error("pytest not found. Install with: rapidkit init (or: poetry install --group dev)")
         sys.exit(1)
 
 
@@ -247,7 +249,7 @@ def lint() -> None:
         _print_error("Linting failed! Run 'poetry run format' to fix issues.")
         sys.exit(1)
     except FileNotFoundError:
-        _print_error("Linting tools not found. Install with: poetry install --group dev")
+        _print_error("Linting tools not found. Install with: rapidkit init (or: poetry install --group dev)")
         sys.exit(1)
 
 
@@ -280,7 +282,7 @@ def format() -> None:
         _print_error(f"Formatting failed: {e}")
         sys.exit(1)
     except FileNotFoundError:
-        _print_error("Formatting tools not found. Install with: poetry install --group dev")
+        _print_error("Formatting tools not found. Install with: rapidkit init (or: poetry install --group dev)")
         sys.exit(1)
 
 

package/templates/kits/fastapi-standard/src/main.py.j2

@@ -2,6 +2,9 @@
 
 from __future__ import annotations
 
+from contextlib import asynccontextmanager
+from typing import AsyncIterator
+
 from fastapi import FastAPI
 from fastapi.middleware.cors import CORSMiddleware
 
@@ -9,12 +12,24 @@ from fastapi.middleware.cors import CORSMiddleware
 
 from .routing import api_router
 
+
+@asynccontextmanager
+async def lifespan(app: FastAPI) -> AsyncIterator[None]:
+    """Application lifespan context manager for startup/shutdown events."""
+    # Startup
+    # <<<inject:startup>>>
+    yield
+    # Shutdown
+    # <<<inject:shutdown>>>
+
+
 app = FastAPI(
     title="{{ project_name }}",
     description="{{ description }}",
     version="{{ app_version }}",
     docs_url="/docs",
     redoc_url="/redoc",
+    lifespan=lifespan,
 )
 
 app.add_middleware(
@@ -27,15 +42,3 @@ app.add_middleware(
 
 app.include_router(api_router, prefix="/api")
 # <<<inject:routes>>>
-
-
-@app.on_event("startup")
-async def _on_startup() -> None:
-    """Execute startup hooks provided by modules."""
-    # <<<inject:startup>>>
-
-
-@app.on_event("shutdown")
-async def _on_shutdown() -> None:
-    """Execute shutdown hooks provided by modules."""
-    # <<<inject:shutdown>>>

package/templates/kits/fastapi-standard/src/routing/__init__.py.j2

@@ -9,5 +9,5 @@ from .health import router as health_router
 
 api_router = APIRouter()
 
-api_router.include_router(health_router, prefix="/health", tags=["health"])
+api_router.include_router(health_router)
 # <<<inject:router-mount>>>

package/templates/kits/fastapi-standard/src/routing/health.py.j2

@@ -4,10 +4,29 @@ from __future__ import annotations
 
 from fastapi import APIRouter
 
-router = APIRouter()
+try:
+    from src.health.registry import (
+        list_registered_health_routes as _list_registered_health_routes,
+    )
+except ImportError:  # pragma: no cover - registry not generated yet
+    def _list_registered_health_routes(
+        prefix: str = "/api/health",
+    ) -> list[dict[str, str]]:
+        return []
+
+
+router = APIRouter(prefix="/health", tags=["health"])
 
 
 @router.get("/", summary="Health check")
 async def heartbeat() -> dict[str, str]:
     """Return basic service heartbeat."""
+
     return {"status": "ok"}
+
+
+@router.get("/modules", summary="Registered module health endpoints")
+async def module_health_catalog() -> dict[str, list[dict[str, str]]]:
+    """Expose metadata for module-provided health routers."""
+
+    return {"routes": _list_registered_health_routes()}