rapidkit 0.25.4 → 0.25.6

package/dist/create-27NVMJAR.js

@@ -0,0 +1,776 @@
+import {i,d as d$2,l,k,f as f$1,g,h}from'./chunk-ZAZJEYYT.js';import {a as a$2,e,d as d$1,f,c,k as k$1}from'./chunk-Z5LKRG57.js';import {a,d,b as b$1}from'./chunk-RV6HBTFC.js';import {b}from'./chunk-Q7ULIFQA.js';import {a as a$1}from'./chunk-VM2TOHNX.js';import {promises}from'fs';import*as v from'fs-extra';import m from'path';import U from'inquirer';import o from'chalk';import z from'ora';import {execa}from'execa';function C(){return c()}async function et(t,n,e,r){let s=d(n,b(),e);r&&(s.metadata||(s.metadata={}),s.metadata.python={version:r}),await b$1(t,s);}async function H(t){await v.outputFile(m.join(t,".gitignore"),`.venv/
+__pycache__/
+*.pyc
+.env
+.rapidkit-workspace/
+
+`,"utf-8");}async function ot(t,n){let e=n.replace(/[^a-z0-9-]/gi,"-").toLowerCase();await v.outputFile(m.join(t,"poetry.toml"),`[virtualenvs]
+in-project = true
+`,"utf-8"),await v.outputFile(m.join(t,"pyproject.toml"),`[tool.poetry]
+name = "${e}"
+version = "0.1.0"
+description = "RapidKit workspace"
+authors = []
+package-mode = false
+
+[tool.poetry.dependencies]
+python = "^3.10"
+rapidkit-core = "*"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
+`,"utf-8");}function mt(t,n,e,r){return JSON.stringify({schema_version:"1.0",workspace_name:t,rapidkit_version:b(),created_at:new Date().toISOString(),created_by:"rapidkit-npm",profile:r||"minimal",engine:{install_method:n,python_version:e||null}},null,2)}function yt(t,n,e,r){return JSON.stringify({schema_version:"1.0",generated_by:"rapidkit-npm",generated_at:new Date().toISOString(),runtime:{python:{version:n||null,install_method:t},node:{version:e||process.version},go:{version:r||null}}},null,2)}function gt(){return `version: "1.0"
+mode: warn # "warn" or "strict"
+dependency_sharing_mode: isolated # "isolated" or "shared-runtime-caches" or "shared-node-deps"
+# change profile (recommended): npx rapidkit bootstrap --profile polyglot
+# change mode/dependency manually: edit this file and rerun npx rapidkit init
+rules:
+  enforce_workspace_marker: true
+  enforce_toolchain_lock: false
+  disallow_untrusted_tool_sources: false
+`}function ht(){return `version: "1.0"
+cache:
+  strategy: shared # "shared" or "on-demand"
+  prune_on_bootstrap: false
+  self_heal: true
+  verify_integrity: false
+`}async function nt(t,n,e,r,s){let d;try{let{stdout:u}=await execa("go",["version"],{timeout:3e3,stdio:"pipe"}),g=u.match(/go(\d+\.\d+(?:\.\d+)?)/i);d=g?g[1]:void 0;}catch{}await v.outputFile(m.join(t,".rapidkit","workspace.json"),mt(n,e,r,s),"utf-8"),await v.outputFile(m.join(t,".rapidkit","toolchain.lock"),yt(e,r,process.version,d),"utf-8"),await v.outputFile(m.join(t,".rapidkit","policies.yml"),gt(),"utf-8"),await v.outputFile(m.join(t,".rapidkit","cache-config.yml"),ht(),"utf-8");}async function ee(t,n){let{workspaceName:e=m.basename(t),installMethod:r="venv",pythonVersion:s,profile:d$1,writeMarker:u=true,writeGitignore:g=true,onlyIfMissing:y=true}=n||{},h=[],c;try{let{stdout:a}=await execa("go",["version"],{timeout:3e3,stdio:"pipe"}),p=a.match(/go(\d+\.\d+(?:\.\d+)?)/i);c=p?p[1]:void 0;}catch{}let i=[{relPath:m.join(".rapidkit","workspace.json"),content:mt(e,r,s,d$1)},{relPath:m.join(".rapidkit","toolchain.lock"),content:yt(r,s,process.version,c)},{relPath:m.join(".rapidkit","policies.yml"),content:gt()},{relPath:m.join(".rapidkit","cache-config.yml"),content:ht()}];for(let a of i){let p=m.join(t,a.relPath);y&&await v.pathExists(p)||(await v.outputFile(p,a.content,"utf-8"),h.push(a.relPath));}if(u&&(!!!await a(t)||!y)){let p=d(e,b(),r);s&&(p.metadata||(p.metadata={}),p.metadata.python={version:s}),await b$1(t,p),h.push(".rapidkit-workspace");}if(g){let a=m.join(t,".gitignore");(!y||!await v.pathExists(a))&&(await H(t),h.push(".gitignore"));}return h}var A="3.10",ft=["3.10","3.11","3.12"];async function pt(t){try{let{stdout:n}=await execa(t,["--version"],{timeout:3e3}),e=n.match(/Python (\d+\.\d+\.\d+)/);if(e)return e[1]}catch{}return null}async function jt(t,n){try{await promises.writeFile(m.join(t,".python-version"),`${n}
+`,"utf-8"),a$1.debug(`Created .python-version with ${n}`);}catch(e){a$1.warn(`Failed to create .python-version: ${e}`);}}function D(){let e=[...(process.env.PATH||"").split(m.delimiter).filter(Boolean)];for(let r of k$1())e.includes(r)||e.unshift(r);process.env.PATH=e.join(m.delimiter);}async function q(t,n){D(),t.start("Checking pipx installation");try{return await execa("pipx",["--version"]),t.succeed("pipx found"),{kind:"binary"}}catch{}let e=C();try{return await execa(e,["-m","pipx","--version"]),t.succeed("pipx found"),{kind:"python-module",pythonCmd:e}}catch{}if(n)throw new h;t.stop?.();let{installPipx:r}=await U.prompt([{type:"confirm",name:"installPipx",message:"pipx is not installed. Install it now (user install via python -m pip)?",default:true}]);if(!r)throw new h;t.start("Installing pipx (user install)");try{try{await execa(e,["-m","pip","install","--user","--upgrade","pip"]);}catch{}await execa(e,["-m","pip","install","--user","--upgrade","pipx"]);}catch(s){let d=s,u=String(d?.stderr||d?.shortMessage||d?.message||"");throw new k("Install pipx with python -m pip",s instanceof Error?s:new Error(u))}t.succeed("pipx installed"),D();try{return await execa(e,["-m","pipx","--version"]),{kind:"python-module",pythonCmd:e}}catch(s){let d=s,u=String(d?.stderr||d?.shortMessage||d?.message||"pipx not runnable after install");throw new k("Verify pipx after install",new Error(`${u}
+
+Try reopening your terminal or run: ${e} -m pipx ensurepath`))}}async function F(t,n){return t.kind==="binary"?execa("pipx",n):execa(t.pythonCmd,["-m","pipx",...n])}function Et(t){let n=t.match(/^(\d+)\.(\d+)/);return n?`${n[1]}.${n[2]}`:null}function ut(t){if(!t)return null;let n=t.match(/Python\s+(\d+)\.(\d+)(?:\.\d+)?/i);return n?`${n[1]}.${n[2]}`:null}function it(t,n){let[e,r]=t.split(".").map(u=>Number(u)),[s,d]=n.split(".").map(u=>Number(u));return e!==s?e-s:r-d}function K(t,n){return it(t,n)>=0}async function Ct(t){let n=new Set,e$1=e(14,10);for(let i of e$1)try{let a=await execa(i.command,i.args,{timeout:2500}),p=ut(`${a.stdout||""}
+${a.stderr||""}`);p&&K(p,A)&&n.add(p);}catch{}let r=null;try{let i=await execa(C(),["--version"],{timeout:2500}),a=ut(`${i.stdout||""}
+${i.stderr||""}`);a&&K(a,A)&&(r=a,n.add(a));}catch{}let s=ft.filter(i=>K(i,A)),d=new Set([...s,...n]),u=Array.from(d).sort((i,a)=>it(a,i)),g=t?Et(t):null,y=g&&K(g,A)?g:r||u[0]||A;return d.has(y)||d.add(y),{choices:Array.from(d).sort((i,a)=>it(a,i)).map(i=>{let a=[];return i===r&&a.push("current system"),i===A&&a.push("minimum supported"),n.has(i)&&i!==r&&a.push("detected"),{name:a.length>0?`${i} (${a.join(", ")})`:i,value:i}}),defaultValue:y}}async function $t(){D();let t=false,n=false;try{await execa("poetry",["--version"],{timeout:2500}),t=true;}catch{t=false;}try{await execa("pipx",["--version"],{timeout:2500}),n=true;}catch{let e=c();try{await execa(e,["-m","pipx","--version"],{timeout:2500}),n=true;}catch{n=false;}}return {poetry:t,pipx:n}}async function wt(){D();try{return await execa("poetry",["--version"],{timeout:2500}),true}catch{return  false}}function Mt(t,n){return t==="poetry"&&n.poetry?"poetry":t==="pipx"&&n.pipx?"pipx":t==="venv"?"venv":n.poetry?"poetry":"venv"}async function St(t,n){D(),t.start("Checking Poetry installation");try{await execa("poetry",["--version"]),t.succeed("Poetry found");return}catch{}if(n)throw new g;let{installPoetry:e}=await U.prompt([{type:"confirm",name:"installPoetry",message:"Poetry is not installed. Install it now using pipx?",default:true}]);if(!e)throw new g;let r=await q(t,n);t.start("Installing Poetry with pipx");try{await F(r,["install","poetry"]);}catch(s){let d=s,u=String(d?.stderr||d?.shortMessage||d?.message||"");if(/already\s+installed|already\s+seems\s+to\s+be\s+installed|exists/i.test(u))try{await F(r,["upgrade","poetry"]);}catch{}else throw new k("Install Poetry with pipx",s instanceof Error?s:new Error(u))}t.succeed("Poetry installed"),D();try{await execa("poetry",["--version"]);}catch(s){let d=s,u=String(d?.stderr||d?.shortMessage||d?.message||"Poetry not found on PATH");throw new k("Verify Poetry after pipx install",new Error(`${u}
+
+Poetry may be installed but not on PATH yet. Try reopening your terminal or run: pipx ensurepath`))}}function At(t){let n=t==="poetry";return `#!/usr/bin/env sh
+set -eu
+
+SCRIPT_DIR=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
+
+VENV_RAPIDKIT="$SCRIPT_DIR/.venv/bin/rapidkit"
+if [ -x "$VENV_RAPIDKIT" ]; then
+  exec "$VENV_RAPIDKIT" "$@"
+fi
+
+${n?`if command -v poetry >/dev/null 2>&1 && [ -f "$SCRIPT_DIR/pyproject.toml" ]; then
+  exec poetry run rapidkit "$@"
+fi
+
+`:""}echo "RapidKit launcher could not find a local Python CLI." 1>&2
+echo "- If you used venv: ensure .venv exists (or re-run the installer)." 1>&2
+${n?`echo "- If you used Poetry: run 'poetry install' and retry, or activate the env." 1>&2
+`:""}echo "Tip: you can also run: ./.venv/bin/rapidkit --help" 1>&2
+exit 1
+`}function Dt(t){return `@echo off
+setlocal
+
+set "SCRIPT_DIR=%~dp0"
+
+if exist "%SCRIPT_DIR%\\.venv\\Scripts\\rapidkit.exe" (
+  "%SCRIPT_DIR%\\.venv\\Scripts\\rapidkit.exe" %*
+  exit /b %ERRORLEVEL%
+)
+
+${t==="poetry"?`where poetry >nul 2>nul
+if %ERRORLEVEL%==0 if exist "%SCRIPT_DIR%\\pyproject.toml" (
+  poetry run rapidkit %*
+  exit /b %ERRORLEVEL%
+)
+
+`:""}echo RapidKit launcher could not find a local Python CLI. 1>&2
+echo Tip: run .venv\\Scripts\\rapidkit.exe --help 1>&2
+exit /b 1
+`}async function vt(t,n){await v.outputFile(m.join(t,"rapidkit"),At(n),{encoding:"utf-8",mode:493}),await v.outputFile(m.join(t,"rapidkit.cmd"),Dt(n),"utf-8");}async function oe(t,n){let{skipGit:e=false,testMode:r=false,demoMode:s=false,dryRun:d=false,yes:u=false,userConfig:g={},installMethod:y,profile:h}=n,c=t||"rapidkit",i$1=m.resolve(process.cwd(),c);if(await v.pathExists(i$1))throw new i(c);if(d){await Ft(i$1,c,s,g);return}if(s){await Kt(i$1,c,e);return}let a=new Set(["python-only","polyglot","enterprise"]),p=h||"";if(!u&&!h){let{selectedProfile:f}=await U.prompt([{type:"rawlist",name:"selectedProfile",message:"Select workspace profile:",choices:[{name:"minimal     \u2014 Foundation files only (fastest bootstrap, mixed projects)",value:"minimal"},{name:"python-only \u2014 Python + Poetry (FastAPI, Django, ML pipelines)",value:"python-only"},{name:"node-only   \u2014 Node.js runtime (NestJS, Express, Next.js)",value:"node-only"},{name:"go-only     \u2014 Go runtime (Fiber, Gin, gRPC, microservices)",value:"go-only"},{name:"polyglot    \u2014 Python + Node.js + Go multi-runtime workspace",value:"polyglot"},{name:"enterprise  \u2014 Polyglot + governance + Sigstore verification",value:"enterprise"}],default:1}]);p=f;}else p||(p="minimal");let b=!u&&a.has(p),E=typeof g.pythonVersion=="string"&&g.pythonVersion.trim().length>0?g.pythonVersion.trim():void 0,M=y||g.defaultInstallMethod||"poetry",I=b?await $t():{poetry:true,pipx:true},T=b?await Ct(E):{choices:ft.map(f=>({name:f,value:f})),defaultValue:A},Y=Mt(M,I),It=[{name:I.poetry?"\u{1F3AF} Poetry (Recommended - includes virtual env)":"\u{1F3AF} Poetry (Recommended - includes virtual env) \u2014 not detected (we can install it)",value:"poetry"},{name:"\u{1F4E6} pip with venv (Standard, zero extra tools)",value:"venv"},{name:I.pipx?"\u{1F527} pipx (Global isolated install)":"\u{1F527} pipx (Global isolated install) \u2014 not detected (we can install it)",value:"pipx"}],x=b?await U.prompt([{type:"rawlist",name:"pythonVersion",message:"Select Python version for RapidKit:",choices:T.choices,default:T.defaultValue},{type:"rawlist",name:"installMethod",message:"How would you like to manage the workspace environment?",choices:It,default:Y}]):await(async()=>{let f=y||g.defaultInstallMethod||await(async()=>{try{return await execa("poetry",["--version"],{timeout:3e3}),"poetry"}catch{return a$1.warn("Poetry not found \u2014 auto-selecting venv. Pass --install-method poetry to override."),"venv"}})();return {pythonVersion:g.pythonVersion||"3.10",installMethod:f}})();if(new Set(["go-only","node-only","minimal"]).has(p)){let f=z("Creating workspace").start();try{await v.ensureDir(i$1),f.succeed("Directory created"),await et(i$1,c,"venv",void 0),await nt(i$1,c,"venv",void 0,p),await H(i$1),await ot(i$1,c);let R={"go-only":"Go-only","node-only":"Node.js-only",minimal:"Minimal"};if(await v.outputFile(m.join(i$1,"README.md"),`# ${c}
+
+RapidKit **${R[p]}** workspace.
+
+## Quick start
+
+\`\`\`bash
+`+(p==="go-only"?`npx rapidkit create project gofiber.standard my-api
+cd my-api
+npx rapidkit init
+npx rapidkit dev
+`:p==="node-only"?`npx rapidkit create project nestjs.standard my-app
+cd my-app
+npx rapidkit init
+npx rapidkit dev
+`:`npx rapidkit create project
+cd <project-name>
+npx rapidkit init
+npx rapidkit dev
+`)+"```\n","utf-8"),!e){f.start("Initializing git repository");try{await execa("git",["init"],{cwd:i$1}),await execa("git",["add","."],{cwd:i$1}),await execa("git",["commit","-m","Initial commit: RapidKit workspace"],{cwd:i$1}),f.succeed("Git repository initialized");}catch{f.warn("Could not initialize git repository");}}try{let{registerWorkspace:k}=await import('./workspace-VXNLNKCM.js');await k(i$1,c);}catch{}if(console.log(o.green(`
+\u2728 Workspace created!
+`)),console.log(o.cyan("\u{1F4C2} Location:"),o.white(i$1)),console.log(o.cyan(`
+\u{1F680} Get started:
+`)),console.log(o.white(`   cd ${c}`)),p==="go-only"){console.log(o.white("   npx rapidkit create project gofiber.standard my-api")),console.log(o.white("   cd my-api")),console.log(o.white("   npx rapidkit init")),console.log(o.white(`   npx rapidkit dev
+`)),console.log(o.gray("\u{1F4A1} No Python required \u2014 Go kits run entirely through the npm package."));try{let{stdout:k}=await execa("go",["version"],{timeout:3e3}),_=k.match(/go version go(\d+\.\d+(?:\.\d+)?)/),S=_?_[1]:"unknown";console.log(o.gray(`\u{1F439} Go ${S} detected \u2014 ready for gofiber.standard / gogin.standard projects`));}catch{console.log(o.yellow(`
+\u26A0\uFE0F  Go is not installed \u2014 install it from https://go.dev/dl/`));}}else p==="node-only"?(console.log(o.white("   npx rapidkit create project nestjs.standard my-app")),console.log(o.white("   cd my-app")),console.log(o.white("   npx rapidkit init")),console.log(o.white(`   npx rapidkit dev
+`)),console.log(o.gray("\u{1F4A1} Python engine will be installed automatically on first `create project nestjs.standard`."))):(console.log(o.white("   npx rapidkit create project")),console.log(o.white("   cd <project-name>")),console.log(o.white("   npx rapidkit init")),console.log(o.white(`   npx rapidkit dev
+`)),console.log(o.gray("\u{1F4A1} Bootstrap a specific runtime any time: rapidkit bootstrap --profile python-only|node-only|go-only")));console.log("");}catch(R){throw f.fail("Failed to create workspace"),console.error(o.red(`
+\u274C Error:`),R),R}return}{let f=C(),R=false;try{await execa(f,["--version"],{timeout:5e3}),R=true;}catch{try{await execa("python",["--version"],{timeout:5e3}),R=true;}catch{R=false;}}R||(console.log(o.red(`
+\u274C Python 3.10+ is required for the "${p}" profile.
+`)),console.log(o.cyan(`\u{1F4A1} How to install Python:
+`)),console.log(o.white("   Ubuntu / Debian:  sudo apt install python3.10")),console.log(o.white("   macOS (Homebrew): brew install python@3.10")),console.log(o.white(`   Windows:          https://python.org/downloads
+`)),console.log(o.gray(`   After installing Python, run:  npx rapidkit ${c}
+`)),process.exit(1));}a$1.step(1,3,"Setting up RapidKit environment");let P=z("Creating directory").start();try{await v.ensureDir(i$1),P.succeed("Directory created"),P.start("Detecting Python version");let f=null,R=await kt(x.pythonVersion);if(R)f=await pt(R),f?(a$1.info(` Detected Python ${f}`),P.succeed(`Python ${f} detected`)):P.warn("Could not detect exact Python version");else {let k=C();f=await pt(k),f?P.succeed(`Python ${f} detected`):P.warn("Could not detect Python version, proceeding with defaults");}if(x.installMethod==="poetry"&&!await wt()&&(P.warn("Poetry not found \u2014 auto-fallback to pip + venv"),x.installMethod="venv"),await et(i$1,c,x.installMethod,f||void 0),f&&await jt(i$1,f),await nt(i$1,c,x.installMethod,f||x.pythonVersion,p||h),await H(i$1),await ot(i$1,c),x.installMethod==="poetry")try{await bt(i$1,x.pythonVersion,P,r,g,u);}catch(k){let _=k?.details||k?.message||String(k);if(_.includes("pyenv")||_.includes("exit status 127")||_.includes("returned non-zero exit status 127")){P.warn("Poetry encountered Python discovery issues, trying venv method"),a$1.debug(`Poetry error (attempting venv fallback): ${_}`);try{await rt(i$1,x.pythonVersion,P,r,g),x.installMethod="venv";}catch(at){throw at}}else throw k}else x.installMethod==="venv"?await rt(i$1,x.pythonVersion,P,r,g):await Pt(i$1,P,r,g,u);if(await vt(i$1,x.installMethod),await xt(i$1,x.installMethod),P.succeed("RapidKit environment ready!"),!n.skipGit){P.start("Initializing git repository");try{await execa("git",["init"],{cwd:i$1}),await execa("git",["add","."],{cwd:i$1}),await execa("git",["commit","-m","Initial commit: RapidKit environment"],{cwd:i$1}),P.succeed("Git repository initialized");}catch{P.warn("Could not initialize git repository");}}try{let{registerWorkspace:k}=await import('./workspace-VXNLNKCM.js');await k(i$1,c);}catch{console.warn(o.gray("Note: Could not register workspace in shared registry"));}if(console.log(o.green(`
+\u2728 RapidKit environment created successfully!
+`)),console.log(o.cyan("\u{1F4C2} Location:"),o.white(i$1)),console.log(o.cyan(`\u{1F680} Get started:
+`)),console.log(o.white(`   cd ${c}`)),x.installMethod==="poetry"){let k="source $(poetry env info --path)/bin/activate";try{D();let{stdout:_}=await execa("poetry",["--version"]),S=_.match(/Poetry.*?(\d+)\.(\d+)/);S&&(parseInt(S[1])>=2?k="source $(poetry env info --path)/bin/activate":k="poetry shell");}catch{}console.log(o.white(`   ${k}  # Or: poetry run rapidkit`)),console.log(o.white("   rapidkit create  # Interactive mode")),console.log(o.white("   cd <project-name>")),console.log(o.white("   rapidkit init")),console.log(o.white("   rapidkit dev"));}else x.installMethod==="venv"?(console.log(o.white("   source .venv/bin/activate  # On Windows: .venv\\Scripts\\activate")),console.log(o.white("   rapidkit create  # Interactive mode")),console.log(o.white("   cd <project-name>")),console.log(o.white("   rapidkit init")),console.log(o.white("   rapidkit dev"))):(console.log(o.white("   rapidkit create  # Interactive mode")),console.log(o.white("   cd <project-name>")),console.log(o.white("   rapidkit init")),console.log(o.white("   rapidkit dev")));console.log(o.white(`
+\u{1F4A1} For more information, check the README.md file.`)),console.log(o.cyan(`
+\u{1F4DA} RapidKit commands:`)),console.log(o.white("   rapidkit create          - Create a new project (interactive)")),console.log(o.white("   rapidkit dev             - Run development server")),console.log(o.white("   rapidkit add module <name> - Add a module (e.g., settings)")),console.log(o.white("   rapidkit list            - List available kits")),console.log(o.white("   rapidkit modules         - List available modules")),console.log(o.white(`   rapidkit --help          - Show all commands
+`));try{let{stdout:k}=await execa("go",["version"],{timeout:3e3}),_=k.match(/go version go(\d+\.\d+(?:\.\d+)?)/),S=_?_[1]:"unknown";console.log(o.gray(`\u{1F439} Go toolchain: Go ${S} detected \u2014 ready for gofiber.standard projects`));}catch{console.log(o.yellow("\u26A0\uFE0F  Go toolchain not installed \u2014 needed for gofiber.standard projects")),console.log(o.gray("   Install: https://go.dev/dl/"));}console.log("");}catch(f){P.fail("Failed to create RapidKit environment"),console.error(o.red(`
+\u274C Error:`),f);try{await v.remove(i$1);}catch{}throw f}}async function kt(t){let n=[];if(!a$2())try{let{stdout:d}=await execa("pyenv",["which","python"]),u=d.trim();u&&n.push(u);}catch{}let e$1=Number(t.split(".")[1]),r=e(e$1,10).map(d=>d.command).filter(Boolean);n.push(`python${t}`,...r,...d$1());let s=[...new Set(n)];for(let d of s)try{let u=d==="py"?["-3","--version"]:["--version"],g=d==="py"?["-3","-c","import sys; sys.exit(0)"]:["-c","import sys; sys.exit(0)"],{stdout:y}=await execa(d,u,{timeout:2e3}),h=y.match(/Python (\d+\.\d+)/)?.[1];if(h&&K(h,t))return await execa(d,g,{timeout:2e3}),d}catch{continue}return null}async function bt(t,n,e,r,s,d=false){await St(e,d),e.start("Finding Python interpreter");let u=await kt(n);u?(a$1.debug(`Found working Python: ${u}`),e.succeed("Python found")):e.warn("Could not verify Python path, proceeding with default"),e.start("Initializing Poetry project");let g=m.join(t,"pyproject.toml"),h=(await v.pathExists(g)?await promises.readFile(g,"utf-8"):"").includes("rapidkit-core");if(h)e.succeed("Poetry project initialized");else {await execa("poetry",["init","--no-interaction","--python",`^${n}`],{cwd:t}),e.succeed("Poetry project initialized");let p=await promises.readFile(g,"utf-8");p.includes("[tool.poetry]")?p=p.replace("[tool.poetry]",`[tool.poetry]
+package-mode = false`):p.includes("[project]")&&(p.includes("[build-system]")?p=p.replace("[build-system]",`
+[tool.poetry]
+package-mode = false
+
+[build-system]`):p+=`
+
+[tool.poetry]
+package-mode = false
+`),await promises.writeFile(g,p,"utf-8");}e.start("Configuring Poetry");try{await execa("poetry",["config","virtualenvs.in-project","true","--local"],{cwd:t}),e.succeed("Poetry configured");}catch{e.warn("Could not configure Poetry virtualenvs.in-project");}e.start("Creating virtualenv");let c=u||C(),i=f(m.join(t,".venv"));try{await execa(c,["-m","venv",".venv"],{cwd:t,timeout:6e4}),e.succeed("Virtualenv created");}catch(a){a$1.debug(`python -m venv failed: ${a}`),e.warn("Could not pre-create virtualenv, Poetry will try"),i=u||C();}try{await execa("poetry",["env","use",i||C()],{cwd:t}),a$1.debug(`Poetry env set to: ${i}`);}catch(a){a$1.debug(`Could not set Poetry env: ${a}`);}if(e.start("Installing RapidKit"),h&&!r){let a=d$2(s||{}),p=a?await v.pathExists(a):false,b=p&&a?a:"rapidkit-core";a&&!p&&a$1.warn(`RAPIDKIT_DEV_PATH is set but path does not exist: ${a}. Falling back to PyPI.`),e.text=p?"Installing RapidKit from local path":"Installing RapidKit from PyPI";let E=false,M=null;for(let I=1;I<=3;I++)try{await execa(i,["-m","pip","install",b,"--quiet"],{cwd:t,timeout:18e4}),E=true;break}catch(T){M=T,a$1.debug(`pip install rapidkit-core attempt ${I} failed: ${T}`),I<3&&(e.text=`Retrying installation (attempt ${I+1}/3)`,await new Promise(Y=>setTimeout(Y,2e3)));}if(!E){let I=M?.stderr||M?.message||"Unknown error";throw a$1.debug(`All pip install attempts failed. Last error: ${I}`),I.includes("Could not find")||I.includes("No matching distribution")?new l:new k("Install rapidkit-core with pip",new Error(`Failed to install rapidkit-core after 3 attempts.
+Error: ${I}
+
+Possible solutions:
+  1. Check your internet connection
+  2. Try installing manually: cd ${m.basename(t)} && poetry add rapidkit-core
+  3. Use venv method instead: npx rapidkit ${m.basename(t)} --install-method=venv`))}}else {e.text="Syncing Poetry environment";try{await execa("poetry",["install","--no-root"],{cwd:t,timeout:12e4}),e.succeed("Poetry environment synced");}catch(a){a$1.debug(`poetry install --no-root failed: ${a}`),e.warn("Could not sync Poetry environment, proceeding with add command");}if(e.start("Installing RapidKit"),r){let a=d$2(s||{});if(!a)throw new k("Test mode installation",new Error("No local RapidKit path configured. Set RAPIDKIT_DEV_PATH environment variable."));a$1.debug(`Installing from local path: ${a}`),e.text="Installing RapidKit from local path (test mode)",await execa("poetry",["add",a],{cwd:t});}else {e.text="Installing RapidKit from PyPI";let a=false,p=null;for(let b=1;b<=3;b++)try{await execa("poetry",["add","rapidkit-core"],{cwd:t,timeout:6e4*b}),a=true;break}catch(E){p=E,a$1.debug(`Poetry add attempt ${b} failed: ${E}`),b<3&&(e.text=`Retrying installation (attempt ${b+1}/3)`,await new Promise(M=>setTimeout(M,2e3)));}if(!a){let b=p?.stderr||p?.message||"Unknown error";throw a$1.debug(`All Poetry install attempts failed. Last error: ${b}`),b.includes("Could not find")||b.includes("No matching distribution")?new l:new k("Install rapidkit-core with Poetry",new Error(`Failed to install rapidkit-core after 3 attempts.
+Error: ${b}
+
+Possible solutions:
+  1. Check your internet connection
+  2. Try installing manually: cd ${m.basename(t)} && poetry add rapidkit-core
+  3. Use venv method instead: npx rapidkit ${m.basename(t)} --install-method=venv`))}}}e.succeed("RapidKit installed in project virtualenv");try{let{checkRapidkitCoreAvailable:a}=await import('./pythonRapidkitExec-K2SFGAYJ.js');if(!await a()&&!r){e.start("Checking optional global pipx installation");let b=await q(e,true);try{e.start("Installing RapidKit globally with pipx for CLI access"),await F(b,["install","rapidkit-core"]),e.succeed("RapidKit installed globally");}catch(E){e.warn("Could not install globally (non-fatal, project virtualenv has RapidKit)"),a$1.debug(`pipx install failed: ${E}`);}}}catch(a){e.succeed("Skipped optional global pipx installation"),a$1.debug(`Global install check skipped: ${a}`);}}async function rt(t,n,e,r,s,d=false){e.start(`Checking Python ${n}`);let u=C();try{let{stdout:y}=await execa(u,["--version"]),h=y.match(/Python (\d+\.\d+)/)?.[1];if(h&&!K(h,n))throw new f$1(n,h);e.succeed(`Python ${h} found`);}catch(y){throw y instanceof f$1?y:new f$1(n)}e.start("Creating virtual environment");try{await execa(u,["-m","venv",".venv"],{cwd:t}),e.succeed("Virtual environment created");}catch(y){if(e.fail("Failed to create virtual environment"),(c=>typeof c=="object"&&c!==null&&"stdout"in c&&typeof c.stdout=="string")(y)&&y.stdout.includes("ensurepip is not")){let c=y.stdout.match(/apt install (python[\d.]+-venv)/),i=c?c[1]:"python3-venv";throw new k("Python venv module not available",new Error(`Virtual environment creation failed.
+
+On Debian/Ubuntu systems, install the venv package:
+  sudo apt install ${i}
+
+Or use Poetry instead (recommended):
+  npx rapidkit ${m.basename(t)} --yes`))}throw new k("Virtual environment creation",y instanceof Error?y:new Error(String(y)))}e.start("Installing RapidKit");let g=f(m.join(t,".venv"));if(await execa(g,["-m","pip","install","--upgrade","pip"],{cwd:t}),r){let y=d$2(s||{});if(!y)throw new k("Test mode installation",new Error("No local RapidKit path configured. Set RAPIDKIT_DEV_PATH environment variable."));a$1.debug(`Installing from local path: ${y}`),e.text="Installing RapidKit from local path (test mode)",await execa(g,["-m","pip","install","-e",y],{cwd:t});}else {e.text="Installing RapidKit from PyPI";let y=false,h=null;for(let c=1;c<=3;c++)try{await execa(g,["-m","pip","install","rapidkit-core"],{cwd:t,timeout:6e4*c}),y=true;break}catch(i){h=i,a$1.debug(`pip install attempt ${c} failed: ${i}`),c<3&&(e.text=`Retrying installation (attempt ${c+1}/3)`,await new Promise(a=>setTimeout(a,2e3)));}if(!y){let c=h?.stderr||h?.message||"Unknown error";throw a$1.debug(`All pip install attempts failed. Last error: ${c}`),c.includes("Could not find")||c.includes("No matching distribution")?new l:new k("Install rapidkit-core with pip",new Error(`Failed to install rapidkit-core after 3 attempts.
+Error: ${c}
+
+Possible solutions:
+  1. Check your internet connection
+  2. Try installing manually: cd ${m.basename(t)} && ${f(".venv")} -m pip install rapidkit-core
+  3. Use Poetry instead: npx rapidkit ${m.basename(t)} --install-method=poetry`))}}e.succeed("RapidKit installed in project virtualenv");try{let{checkRapidkitCoreAvailable:y}=await import('./pythonRapidkitExec-K2SFGAYJ.js');if(!await y()&&!r){e.start("Checking optional global pipx installation");let c=await q(e,true);try{e.start("Installing RapidKit globally with pipx for CLI access"),await F(c,["install","rapidkit-core"]),e.succeed("RapidKit installed globally");}catch(i){e.warn("Could not install globally (non-fatal, project virtualenv has RapidKit)"),a$1.debug(`pipx install failed: ${i}`);}}}catch(y){e.succeed("Skipped optional global pipx installation"),a$1.debug(`Global install check skipped: ${y}`);}}async function Pt(t,n,e,r,s=false){let d=await q(n,s);if(n.start("Installing RapidKit globally with pipx"),e){let u=d$2(r||{});if(!u)throw new k("Test mode installation",new Error("No local RapidKit path configured. Set RAPIDKIT_DEV_PATH environment variable."));a$1.debug(`Installing from local path: ${u}`),n.text="Installing RapidKit from local path (test mode)",await F(d,["install","-e",u]);}else {n.text="Installing RapidKit from PyPI";try{await F(d,["install","rapidkit-core"]);}catch{throw new l}}n.succeed("RapidKit installed globally"),await v.outputFile(m.join(t,".rapidkit-global"),`RapidKit installed globally with pipx
+`,"utf-8");}async function ne(t,n){let{skipGit:e=false,testMode:r=false,userConfig:s={},yes:d=false,installMethod:u,pythonVersion:g="3.10"}=n||{},y=u||s.defaultInstallMethod||await(async()=>{try{return await execa("poetry",["--version"],{timeout:3e3}),"poetry"}catch{return a$1.warn("Poetry not found \u2014 auto-selecting venv. Pass --install-method poetry to override."),"venv"}})(),h=y==="poetry"&&!await wt()?"venv":y;await et(t,m.basename(t),h),await H(t),await nt(t,m.basename(t),h,g,n?.profile);let c=z("Registering workspace").start();try{h==="poetry"?(await ot(t,m.basename(t)),await bt(t,g,c,r,s,d)):h==="venv"?await rt(t,g,c,r,s):await Pt(t,c,r,s,d),await vt(t,h),await xt(t,h),c.succeed("Workspace registered");try{let{registerWorkspace:i}=await import('./workspace-VXNLNKCM.js');await i(t,m.basename(t));}catch{}if(!e){c.start("Initializing git repository");try{await execa("git",["init"],{cwd:t}),await execa("git",["add","."],{cwd:t}),await execa("git",["commit","-m","Initial commit: RapidKit workspace"],{cwd:t}),c.succeed("Git repository initialized");}catch{c.warn("Could not initialize git repository");}}}catch(i){throw c.fail("Failed to register workspace"),i}}async function xt(t,n){let e=n==="poetry"?`source $(poetry env info --path)/bin/activate
+# Or simply use: poetry run rapidkit <command>`:n==="venv"?"source .venv/bin/activate  # On Windows: .venv\\Scripts\\activate":"N/A (globally installed)",r=n==="poetry"?`# No activation needed (recommended):
+./rapidkit --help
+# or:
+poetry run rapidkit --help`:n==="venv"?`# No activation needed (recommended):
+./rapidkit --help
+# or direct:
+./.venv/bin/rapidkit --help`:`# Optional: use the local launcher
+./rapidkit --help
+# (pipx installs may require Poetry/venv to be present in this folder)`,s=a$2()?"python --version (or: py -3 --version)":"python3 --version (or: python --version)",d=`# RapidKit Workspace
+
+This directory contains a RapidKit development environment.
+
+## Installation Method
+
+**${n==="poetry"?"Poetry":n==="venv"?"Python venv + pip":"pipx (global)"}**
+
+## Getting Started
+
+### 0. Run Without Activation (Recommended)
+
+This workspace includes a local launcher script so you can run the Python Core CLI without activating the environment:
+
+\`\`\`bash
+${r}
+\`\`\`
+
+### 1. Activate Environment
+
+\`\`\`bash
+${e}
+\`\`\`
+
+### 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 (preferred):
+rapidkit init
+
+# Run the server (project-aware):
+rapidkit dev
+
+# Or with poetry run (manual / advanced):
+poetry run rapidkit 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 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://getrapidkit.com) *(or appropriate URL)*
+
+## Workspace Structure
+
+\`\`\`
+${n==="venv"?".venv/          # Python virtual environment":""}
+${n==="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: \`${s}\`
+2. Check RapidKit installation: \`rapidkit --version\`
+3. Run diagnostics: \`rapidkit doctor\`
+4. Visit RapidKit documentation or GitHub issues
+`;await promises.writeFile(m.join(t,"README.md"),d,"utf-8");}async function Kt(t,n,e){let r=z("Creating demo workspace").start();try{await v.ensureDir(t),r.succeed("Directory created"),r.start("Setting up demo kit generator");let s=JSON.stringify({name:`${n}-workspace`,version:"1.0.0",private:true,description:"RapidKit demo workspace",scripts:{generate:"node generate-demo.js"}},null,2);await promises.writeFile(m.join(t,"package.json"),s,"utf-8"),await promises.writeFile(m.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 fs = require('fs');
+const path = require('path');
+const readline = require('readline');
+
+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);
+}
+
+const rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout
+});
+
+function ask(question, defaultValue) {
+  return new Promise((resolve) => {
+    rl.question(\`\${question} (\${defaultValue}): \`, (answer) => {
+      resolve(answer || defaultValue);
+    });
+  });
+}
+
+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.10"
+fastapi = "^0.128.0"
+uvicorn = {extras = ["standard"], version = "^0.40.0"}
+pydantic = "^2.12.5"
+pydantic-settings = "^2.12.0"
+
+[tool.poetry.group.dev.dependencies]
+pytest = "^9.0.2"
+pytest-asyncio = "^1.3.0"
+pytest-cov = "^7.0.0"
+httpx = "^0.28.1"
+black = "^25.12.0"
+ruff = "^0.14.10"
+mypy = "^1.19.1"
+
+[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
+npx rapidkit init       # Install dependencies
+npx rapidkit dev        # Start dev server
+\\\`\\\`\\\`
+
+## Available commands
+
+\\\`\\\`\\\`bash
+npx rapidkit init       # \u{1F527} Install dependencies
+npx rapidkit dev        # \u{1F680} Start development server with hot reload
+npx rapidkit start      # \u26A1 Start production server
+npx rapidkit test       # \u{1F9EA} Run tests
+npx 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}
+  npx rapidkit init   # Install dependencies
+  npx rapidkit dev    # Start dev server
+
+\u{1F4DA} Available commands:
+  npx rapidkit init   # \u{1F527} Install dependencies
+  npx rapidkit dev    # \u{1F680} Start dev server with hot reload
+  npx rapidkit start  # \u26A1 Start production server
+  npx rapidkit test   # \u{1F9EA} Run tests
+  npx 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",m.join(t,"generate-demo.js")]);}catch{}let u=`# 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:
+rapidkit init
+
+# Run the development server:
+rapidkit dev
+\`\`\`
+
+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://getrapidkit.com)
+
+## \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
+
+\`\`\`
+${n}/
+  \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(m.join(t,"README.md"),u,"utf-8"),r.succeed("Demo workspace setup complete"),!e){r.start("Initializing git repository");try{await execa("git",["init"],{cwd:t}),await v.outputFile(m.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(o.green(`
+\u2728 Demo workspace created successfully!
+`)),console.log(o.cyan("\u{1F4C2} Location:"),o.white(t)),console.log(o.cyan(`\u{1F680} Get started:
+`)),console.log(o.white(`   cd ${n}`)),console.log(o.white("   node generate-demo.js my-api")),console.log(o.white("   cd my-api")),console.log(o.white("   rapidkit init")),console.log(o.white("   rapidkit dev")),console.log(),console.log(o.yellow("\u{1F4A1} Note:"),"This is a demo workspace. For full RapidKit features:"),console.log(o.cyan("   pipx install rapidkit")),console.log();}catch(s){throw r.fail("Failed to create demo workspace"),s}}async function Ft(t,n,e,r){console.log(o.cyan(`
+\u{1F50D} Dry-run mode - showing what would be created:
+`)),console.log(o.white("\u{1F4C2} Project path:"),t),console.log(o.white("\u{1F4E6} Project type:"),e?"Demo workspace":"Full RapidKit environment"),e?(console.log(o.white(`
+\u{1F4DD} Files to create:`)),console.log(o.gray("  - package.json")),console.log(o.gray("  - generate-demo.js (project generator)")),console.log(o.gray("  - README.md")),console.log(o.gray("  - .gitignore")),console.log(o.white(`
+\u{1F3AF} Capabilities:`)),console.log(o.gray("  - Generate multiple FastAPI demo projects")),console.log(o.gray("  - No Python RapidKit installation required")),console.log(o.gray("  - Bundled templates included"))):(console.log(o.white(`
+\u2699\uFE0F  Configuration:`)),console.log(o.gray(`  - Python version: ${r.pythonVersion||"3.10"}`)),console.log(o.gray(`  - Install method: ${r.defaultInstallMethod||"poetry"}`)),console.log(o.gray(`  - Git initialization: ${r.skipGit?"No":"Yes"}`)),console.log(o.white(`
+\u{1F4DD} Files to create:`)),console.log(o.gray("  - pyproject.toml (Poetry) or .venv/ (venv)")),console.log(o.gray("  - README.md")),console.log(o.gray("  - .gitignore")),console.log(o.white(`
+\u{1F3AF} Next steps after creation:`)),console.log(o.gray("  1. Install RapidKit Python package")),console.log(o.gray("  2. Create projects with rapidkit CLI")),console.log(o.gray("  3. Add modules and customize"))),console.log(o.white(`
+\u{1F4A1} To proceed with actual creation, run without --dry-run flag
+`));}export{oe as createProject,ne as registerWorkspaceAtPath,ee as syncWorkspaceFoundationFiles,vt as writeWorkspaceLauncher};