rapidkit 0.41.5 → 0.42.0

package/dist/chunk-F7GYXSBT.js

@@ -0,0 +1,916 @@
+import {k,e as e$2}from'./chunk-YWUWRSNO.js';import {b as b$2}from'./chunk-CDCYRBAY.js';import {e,g,f as f$1,b as b$4,c as c$1,d as d$1}from'./chunk-LANBSCGS.js';import {a,d,b as b$1}from'./chunk-2LBPX5K3.js';import {b}from'./chunk-Q2KZIBV4.js';import {f,c,e as e$3}from'./chunk-OLDPVVSV.js';import {b as b$3,j,i,l,h,q as q$1}from'./chunk-WRMCPKGA.js';import {promises}from'fs';import*as v from'fs-extra';import y from'path';import e$1 from'chalk';import {execa}from'execa';async function L(t,o={}){let n=y.resolve(t),s=o.workspaceName??y.basename(n);try{let{registerWorkspace:a}=await import('./workspace-IBTKZX7T.js');await a(n,s);}catch(a){o.silent||console.warn(e$1.gray(`Note: Could not register workspace in shared registry: ${a?.message??a}`));}try{let{syncWorkspaceContract:a}=await import('./workspace-contract-OO4GMENV.js'),l=await a({workspacePath:n});if(o.silent||console.log(e$1.gray(`\u2139\uFE0F  Workspace intelligence synced (contract + registry summary, ${l.contract.projects.length} project(s)).`)),!o.silent&&l.verification.status!=="passed"){console.log(e$1.yellow("\u26A0\uFE0F  Workspace contract verification reported issues."));for(let d of l.verification.violations)console.log(e$1.gray(`   Violation: ${d}`));console.log(e$1.white("   Next: npx rapidkit workspace contract inspect"));}}catch(a){o.silent||console.warn(e$1.gray(`Note: Could not sync workspace intelligence layer: ${a?.message??a}`));}}function K(){return h()}async function U(t,o,n,s,a){let l=d(o,b(),n,a?.pythonEngine?{coreStatus:a.pythonEngine,...a.pythonEngineReason?{coreReason:a.pythonEngineReason}:{},...s?{pythonVersion:s}:{}}:void 0);s&&!a?.pythonEngine&&(l.metadata||(l.metadata={}),l.metadata.python={pythonVersion:s}),await b$1(t,l);}async function G(t){await v.outputFile(y.join(t,".gitignore"),`.venv/
+__pycache__/
+*.pyc
+.env
+.rapidkit-workspace/
+
+`,"utf-8");}async function Ie(t,o){let n=o.replace(/[^a-z0-9-]/gi,"-").toLowerCase();await v.outputFile(y.join(t,"poetry.toml"),`[virtualenvs]
+in-project = true
+`,"utf-8"),await v.outputFile(y.join(t,"pyproject.toml"),`[tool.poetry]
+name = "${n}"
+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 Ee(t,o,n,s,a){return JSON.stringify({schema_version:"1.0",workspace_name:t,rapidkit_version:b(),created_at:new Date().toISOString(),created_by:"rapidkit-npm",profile:s||"minimal",...a?.profileRequested?{profile_requested:a.profileRequested}:{},...a?.bootstrapNote?{bootstrap_note:a.bootstrapNote}:{},engine:{install_method:o,python_version:n||null,...a?.pythonEngine?{python_core:{status:a.pythonEngine,...a.pythonEngineReason?{reason:a.pythonEngineReason}:{}}}:{}}},null,2)}function _e(t,o,n,s,a,l){return JSON.stringify({schema_version:"1.0",generated_by:"rapidkit-npm",generated_at:new Date().toISOString(),runtime:{python:{version:o||null,install_method:t,...l?.pythonEngine?{core:{status:l.pythonEngine,...l.pythonEngineReason?{reason:l.pythonEngineReason}:{}}}:{}},node:{version:n||process.version},go:{version:s||null},java:{version:null,build_tool:null,build_tool_version:null},dotnet:{version:a||null,sdk:a||null}}},null,2)}function je(){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 Ce(){return `version: "1.0"
+cache:
+  strategy: shared # "shared" or "on-demand"
+  prune_on_bootstrap: false
+  self_heal: true
+  verify_integrity: false
+`}async function $e(){try{let{stdout:t}=await execa("go",["version"],{timeout:3e3,stdio:"pipe"}),o=t.match(/go(\d+\.\d+(?:\.\d+)?)/i);return o?o[1]:void 0}catch{return}}async function Ae(){try{let{stdout:t}=await execa("dotnet",["--version"],{timeout:3e3,stdio:"pipe"}),o=t.trim();return o.length>0?o:void 0}catch{return}}async function q(t,o,n,s,a,l){let[d,u]=await Promise.all([$e(),Ae()]);await v.outputFile(y.join(t,".rapidkit","workspace.json"),Ee(o,n,s,a,l),"utf-8"),await v.outputFile(y.join(t,".rapidkit","toolchain.lock"),_e(n,s,process.version,d,u,l),"utf-8"),await v.outputFile(y.join(t,".rapidkit","policies.yml"),je(),"utf-8"),await v.outputFile(y.join(t,".rapidkit","cache-config.yml"),Ce(),"utf-8");}async function xt(t,o){let{workspaceName:n=y.basename(t),installMethod:s="venv",pythonVersion:a$1,profile:l,writeMarker:d$1=true,writeGitignore:u=true,onlyIfMissing:p=true}=o||{},w=[],[g,m]=await Promise.all([$e(),Ae()]),r=[{relPath:y.join(".rapidkit","workspace.json"),content:Ee(n,s,a$1,l)},{relPath:y.join(".rapidkit","toolchain.lock"),content:_e(s,a$1,process.version,g,m)},{relPath:y.join(".rapidkit","policies.yml"),content:je()},{relPath:y.join(".rapidkit","cache-config.yml"),content:Ce()}];for(let i of r){let b=y.join(t,i.relPath);p&&await v.pathExists(b)||(await v.outputFile(b,i.content,"utf-8"),w.push(i.relPath));}if(d$1&&(!!!await a(t)||!p)){let b$2=d(n,b(),s);a$1&&(b$2.metadata||(b$2.metadata={}),b$2.metadata.python={pythonVersion:a$1}),await b$1(t,b$2),w.push(".rapidkit-workspace");}if(u){let i=y.join(t,".gitignore");(!p||!await v.pathExists(i))&&(await G(t),w.push(".gitignore"));}return w}var Se=new Set(["go-only","java-only","dotnet-only","node-only","minimal"]),Ge={"python-only":"minimal",polyglot:"node-only",enterprise:"polyglot"};function We(t){let o=t,n=new Set;for(;!Se.has(o);){if(n.has(o))return "minimal";n.add(o);let s=Ge[o];if(!s)return "minimal";o=s;}return o}var V="3.10",Me=["3.10","3.11","3.12"];async function xe(t){try{let{stdout:o}=await execa(t,["--version"],{timeout:3e3}),n=o.match(/Python (\d+\.\d+\.\d+)/);if(n)return n[1]}catch{}return null}async function He(t,o){try{await promises.writeFile(y.join(t,".python-version"),`${o}
+`,"utf-8"),f.debug(`Created .python-version with ${o}`);}catch(n){f.warn(`Failed to create .python-version: ${n}`);}}function H(){let n=[...(process.env.PATH||"").split(y.delimiter).filter(Boolean)];for(let s of q$1())n.includes(s)||n.unshift(s);process.env.PATH=n.join(y.delimiter);}async function oe(t,o){H(),t.start("Checking pipx installation");try{return await execa("pipx",["--version"]),t.succeed("pipx found"),{kind:"binary"}}catch{}let n=K();try{return await execa(n,["-m","pipx","--version"]),t.succeed("pipx found"),{kind:"python-module",pythonCmd:n}}catch{}if(o)throw new d$1;t.stop?.();let{installPipx:s}=await b$2([{type:"confirm",name:"installPipx",message:"pipx is not installed. Install it now (user install via python -m pip)?",default:true}]);if(!s)throw new d$1;t.start("Installing pipx (user install)");try{try{await execa(n,["-m","pip","install","--user","--upgrade","pip"]);}catch{}await execa(n,["-m","pip","install","--user","--upgrade","pipx"]);}catch(a){let l=a,d=String(l?.stderr||l?.shortMessage||l?.message||"");throw new f$1("Install pipx with python -m pip",a instanceof Error?a:new Error(d))}t.succeed("pipx installed"),H();try{return await execa(n,["-m","pipx","--version"]),{kind:"python-module",pythonCmd:n}}catch(a){let l=a,d=String(l?.stderr||l?.shortMessage||l?.message||"pipx not runnable after install");throw new f$1("Verify pipx after install",new Error(`${d}
+
+Try reopening your terminal or run: ${n} -m pipx ensurepath`))}}async function W(t,o){return t.kind==="binary"?execa("pipx",o):execa(t.pythonCmd,["-m","pipx",...o])}function ze(t){let o=t.match(/^(\d+)\.(\d+)/);return o?`${o[1]}.${o[2]}`:null}function Re(t){if(!t)return null;let o=t.match(/Python\s+(\d+)\.(\d+)(?:\.\d+)?/i);return o?`${o[1]}.${o[2]}`:null}function ue(t,o){let[n,s]=t.split(".").map(d=>Number(d)),[a,l]=o.split(".").map(d=>Number(d));return n!==a?n-a:s-l}function Y(t,o){return ue(t,o)>=0}async function Ue(t){let o=new Set,n=j(14,10);for(let m of n)try{let r=await execa(m.command,m.args,{timeout:2500}),i=Re(`${r.stdout||""}
+${r.stderr||""}`);i&&Y(i,V)&&o.add(i);}catch{}let s=null;try{let m=await execa(K(),["--version"],{timeout:2500}),r=Re(`${m.stdout||""}
+${m.stderr||""}`);r&&Y(r,V)&&(s=r,o.add(r));}catch{}let a=Me.filter(m=>Y(m,V)),l=new Set([...a,...o]),d=Array.from(l).sort((m,r)=>ue(r,m)),u=t?ze(t):null,p=u&&Y(u,V)?u:s||d[0]||V;return l.has(p)||l.add(p),{choices:Array.from(l).sort((m,r)=>ue(r,m)).map(m=>{let r=[];return m===s&&r.push("current system"),m===V&&r.push("minimum supported"),o.has(m)&&m!==s&&r.push("detected"),{name:r.length>0?`${m} (${r.join(", ")})`:m,value:m}}),defaultValue:p}}async function qe(){H();let t=false,o=false;try{await execa("poetry",["--version"],{timeout:2500}),t=true;}catch{t=false;}try{await execa("pipx",["--version"],{timeout:2500}),o=true;}catch{let n=h();try{await execa(n,["-m","pipx","--version"],{timeout:2500}),o=true;}catch{o=false;}}return {poetry:t,pipx:o}}async function Ke(){H();try{return await execa("poetry",["--version"],{timeout:2500}),true}catch{return  false}}function Ye(t,o){return t==="poetry"&&o.poetry?"poetry":t==="pipx"&&o.pipx?"pipx":t==="venv"?"venv":o.poetry?"poetry":"venv"}async function Be(t,o){H(),t.start("Checking Poetry installation");try{await execa("poetry",["--version"]),t.succeed("Poetry found");return}catch{}if(o)throw new c$1;let{installPoetry:n}=await b$2([{type:"confirm",name:"installPoetry",message:"Poetry is not installed. Install it now using pipx?",default:true}]);if(!n)throw new c$1;let s=await oe(t,o);t.start("Installing Poetry with pipx");try{await W(s,["install","poetry"]);}catch(a){let l=a,d=String(l?.stderr||l?.shortMessage||l?.message||"");if(/already\s+installed|already\s+seems\s+to\s+be\s+installed|exists/i.test(d))try{await W(s,["upgrade","poetry"]);}catch{}else throw new f$1("Install Poetry with pipx",a instanceof Error?a:new Error(d))}t.succeed("Poetry installed"),H();try{await execa("poetry",["--version"]);}catch(a){let l=a,d=String(l?.stderr||l?.shortMessage||l?.message||"Poetry not found on PATH");throw new f$1("Verify Poetry after pipx install",new Error(`${d}
+
+Poetry may be installed but not on PATH yet. Try reopening your terminal or run: pipx ensurepath`))}}function Je(t,o={}){let n=t==="poetry",s=o.pythonEngineSkipped?`echo "- Python engine installation was intentionally skipped for this workspace." 1>&2
+echo "- For npm-owned workspace commands, run: npx rapidkit <command>" 1>&2
+echo "- To install the local Python engine later, create a RapidKit module-enabled project, then run: npx rapidkit workspace run init" 1>&2
+`:`echo "- If you used venv: ensure .venv exists (or re-run the installer)." 1>&2
+`;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
+
+`:""}if command -v rapidkit >/dev/null 2>&1; then
+  RAPIDKIT_CMD=$(command -v rapidkit)
+  if [ "$RAPIDKIT_CMD" != "$SCRIPT_DIR/rapidkit" ] && [ "$RAPIDKIT_CMD" != "$SCRIPT_DIR/.rapidkit/rapidkit" ]; then
+    RAPIDKIT_LOCAL_LAUNCHER_BYPASS=1 exec "$RAPIDKIT_CMD" "$@"
+  fi
+fi
+
+for RAPIDKIT_CORE in "$HOME/.local/bin/rapidkit" "$HOME/Library/Python/3.14/bin/rapidkit" "$HOME/Library/Python/3.13/bin/rapidkit" "$HOME/Library/Python/3.12/bin/rapidkit" "$HOME/Library/Python/3.11/bin/rapidkit" "$HOME/Library/Python/3.10/bin/rapidkit"; do
+  if [ -x "$RAPIDKIT_CORE" ]; then
+    exec "$RAPIDKIT_CORE" "$@"
+  fi
+done
+
+echo "RapidKit launcher could not find a local Python CLI." 1>&2
+${s}${o.pythonEngineSkipped?"":n?`echo "- If you used Poetry: run 'poetry install' and retry, or activate the env." 1>&2
+`:""}${o.pythonEngineSkipped?`echo "Tip: use 'npx rapidkit workspace model --json' for Workspace Intelligence without the Python engine." 1>&2
+`:`echo "Tip: you can also run: ./.venv/bin/rapidkit --help" 1>&2
+`}exit 1
+`}function Qe(t,o={}){let n=t==="poetry",s=o.pythonEngineSkipped?`echo - Python engine installation was intentionally skipped for this workspace. 1>&2
+echo - For npm-owned workspace commands, run: npx rapidkit ^<command^> 1>&2
+echo - To install the local Python engine later, create a RapidKit module-enabled project, then run: npx rapidkit workspace run init 1>&2
+`:`echo Tip: run .venv\\Scripts\\rapidkit.exe --help 1>&2
+`;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%
+)
+
+${n?`where poetry >nul 2>nul
+if %ERRORLEVEL%==0 if exist "%SCRIPT_DIR%\\pyproject.toml" (
+  poetry run rapidkit %*
+  exit /b %ERRORLEVEL%
+)
+
+`:""}:rapidkit_npm_wrapper_fallback
+for /f "delims=" %%R in ('where rapidkit.cmd 2^>nul') do (
+  if /I not "%%~fR"=="%SCRIPT_DIR%rapidkit.cmd" if /I not "%%~fR"=="%SCRIPT_DIR%.rapidkit\\rapidkit.cmd" (
+    set "RAPIDKIT_LOCAL_LAUNCHER_BYPASS=1"
+    "%%~fR" %*
+    exit /b %ERRORLEVEL%
+  )
+)
+
+:rapidkit_core_fallback
+for %%R in ("%USERPROFILE%\\.local\\bin\\rapidkit.exe" "%APPDATA%\\Python\\Scripts\\rapidkit.exe" "%LOCALAPPDATA%\\Programs\\Python\\Scripts\\rapidkit.exe") do (
+  if exist "%%~R" (
+    "%%~R" %*
+    exit /b %ERRORLEVEL%
+  )
+)
+
+echo RapidKit launcher could not find a local Python CLI. 1>&2
+${s}echo Tip: for npm-owned workspace commands, run npx --yes --package rapidkit rapidkit %* from a shell where npm is on PATH. 1>&2
+exit /b 1
+`}async function ye(t,o,n={}){await v.outputFile(y.join(t,"rapidkit"),Je(o,n),{encoding:"utf-8",mode:493}),await v.outputFile(y.join(t,"rapidkit.cmd"),Qe(o,n),"utf-8");}async function Rt(t,o){let{skipGit:n=false,skipPythonEngine:s=false,testMode:a=false,demoMode:l=false,dryRun:d=false,yes:u=false,userConfig:p={},installMethod:w,profile:g,parentDirectory:m}=o,r=t||"rapidkit",i=m?y.resolve(m,r):y.resolve(process.cwd(),r);if(await v.pathExists(i))throw new e(r);if(d){let h=g||(u?"minimal":void 0),I=w||p.defaultInstallMethod||"poetry",x=p.pythonVersion||"3.10";await Ze(i,r,l,p,h,I,x);return}if(l){await Xe(i,r,n);return}let b=new Set(["python-only","polyglot","enterprise"]),f$1=g||"";if(!u&&!g){let{selectedProfile:h}=await b$2([{type:"rawlist",name:"selectedProfile",message:"Select workspace profile:",choices:[{name:"minimal     \u2014 Foundation files only (fastest bootstrap, mixed projects)",value:"minimal"},{name:"java-only   \u2014 Java runtime (Spring Boot services)",value:"java-only"},{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:"dotnet-only \u2014 .NET runtime (ASP.NET Core services)",value:"dotnet-only"},{name:"polyglot    \u2014 Python + Node.js + Go + Java + .NET multi-runtime workspace",value:"polyglot"},{name:"enterprise  \u2014 Polyglot + governance + Sigstore verification",value:"enterprise"}],default:1}]);f$1=h;}else f$1||(f$1="minimal");let S=!u&&b.has(f$1),_=b.has(f$1)&&s?"skip":S?(await b$2([{type:"confirm",name:"installPythonEngine",message:"Install the optional RapidKit Python engine now? (needed for Python-backed kits/modules)",default:true}])).installPythonEngine!==false?"install":"skip":"install",F=S&&_==="install",ne=typeof p.pythonVersion=="string"&&p.pythonVersion.trim().length>0?p.pythonVersion.trim():void 0,Oe=w||p.defaultInstallMethod||"poetry",ie=F?await qe():{poetry:true,pipx:true},me=F?await Ue(ne):{choices:Me.map(h=>({name:h,value:h})),defaultValue:V},Le=Ye(Oe,ie),Ve=[{name:ie.poetry?"\u{1F3AF} Poetry (Recommended - includes virtual env + dependency mgmt)":"\u{1F3AF} Poetry (Recommended) \u2014 not detected (we can install it)",value:"poetry"},{name:"\u{1F4E6} pip with venv (Standard, zero extra tools)",value:"venv"},{name:ie.pipx?"\u{1F527} pipx (Global isolated - RapidKit CLI only, no local venv)":"\u{1F527} pipx (Global isolated) \u2014 not detected (we can install it)",value:"pipx"}],R=F?await b$2([{type:"rawlist",name:"pythonVersion",message:"Select Python version for RapidKit:",choices:me.choices,default:me.defaultValue},{type:"rawlist",name:"installMethod",message:"How would you like to manage the workspace environment?",choices:Ve,default:Le}]):await(async()=>{if(_==="skip")return {pythonVersion:p.pythonVersion||"3.10",installMethod:"venv"};let h=w||p.defaultInstallMethod||await(async()=>{try{return await execa("poetry",["--version"],{timeout:3e3}),"poetry"}catch{return f.warn("Poetry not found \u2014 auto-selecting venv. Pass --install-method poetry to override."),"venv"}})();return {pythonVersion:p.pythonVersion||"3.10",installMethod:h}})();F&&(console.log(e$1.gray(`
+\u{1F4CC} Configuration notes:`)),R.pythonVersion==="3.10"?console.log(e$1.gray("  \u2022 Python 3.10: Latest stable with widespread compatibility")):R.pythonVersion==="3.11"?console.log(e$1.gray("  \u2022 Python 3.11: Newer, faster (3.10-3.11: ~10% speed improvement)")):R.pythonVersion==="3.12"&&console.log(e$1.gray("  \u2022 Python 3.12: Cutting edge, excellent for performance")),R.installMethod==="poetry"?console.log(e$1.gray("  \u2022 Poetry: Dependency management + virtual env (recommended for teams)")):R.installMethod==="venv"?console.log(e$1.gray("  \u2022 venv: Standard library approach, lightweight, zero dependencies")):console.log(e$1.gray("  \u2022 pipx: Global isolated, RapidKit CLI only, no local venv")),console.log(""));let ae=Se;if(ae.has(f$1)){let h=c("Creating workspace",{component:"create",phase:"workspace.python-free"});try{await v.ensureDir(i),h.succeed("Directory created"),await U(i,r,"venv",void 0),await q(i,r,"venv",void 0,f$1),await G(i);let I={"go-only":"Go-only","java-only":"Java-only","dotnet-only":".NET-only","node-only":"Node.js-only",minimal:"Minimal"};if(await v.outputFile(y.join(i,"README.md"),`# ${r}
+
+RapidKit **${I[f$1]}** workspace.
+
+## Quick start
+
+\`\`\`bash
+`+(f$1==="go-only"?`npx rapidkit create project gofiber.standard my-api
+cd my-api
+npx rapidkit init
+npx rapidkit dev
+`:f$1==="java-only"?`npx rapidkit create project springboot.standard my-service
+cd my-service
+npx rapidkit init
+npx rapidkit dev
+`:f$1==="dotnet-only"?`npx rapidkit create project dotnet.webapi.clean my-api
+cd my-api
+npx rapidkit init
+npx rapidkit dev
+`:f$1==="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"),!n){h.start("Initializing git repository");try{await execa("git",["init"],{cwd:i}),await execa("git",["add","."],{cwd:i}),await execa("git",["commit","-m","Initial commit: RapidKit workspace"],{cwd:i}),h.succeed("Git repository initialized");}catch{h.warn("Could not initialize git repository");}}if(await L(i,{workspaceName:r,silent:a}),console.log(e$1.green(`
+\u2728 Workspace created!
+`)),console.log(e$1.cyan("\u{1F4C2} Location:"),e$1.white(i)),console.log(e$1.cyan(`
+\u{1F680} Get started:
+`)),console.log(e$1.white(`   ${k(i)}`)),f$1==="go-only"){console.log(e$1.white("   npx rapidkit create project gofiber.standard my-api")),console.log(e$1.white("   cd my-api")),console.log(e$1.white("   npx rapidkit init")),console.log(e$1.white(`   npx rapidkit dev
+`)),console.log(e$1.gray("\u{1F4A1} No Python required \u2014 Go kits run entirely through the npm package."));try{let{stdout:x}=await execa("go",["version"],{timeout:3e3}),k=x.match(/go version go(\d+\.\d+(?:\.\d+)?)/),D=k?k[1]:"unknown";console.log(e$1.gray(`\u{1F439} Go ${D} detected \u2014 ready for gofiber.standard / gogin.standard projects`));}catch{console.log(e$1.yellow(`
+\u26A0\uFE0F  Go is not installed \u2014 install it from https://go.dev/dl/`));}}else if(f$1==="java-only")console.log(e$1.white("   npx rapidkit create project springboot.standard my-service")),console.log(e$1.white("   cd my-service")),console.log(e$1.white("   npx rapidkit init")),console.log(e$1.white(`   npx rapidkit dev
+`)),console.log(e$1.gray("\u{1F4A1} No Python required \u2014 Spring Boot kit runs through the npm package with Java tooling."));else if(f$1==="dotnet-only"){console.log(e$1.white("   npx rapidkit create project dotnet.webapi.clean my-api")),console.log(e$1.white("   cd my-api")),console.log(e$1.white("   npx rapidkit init")),console.log(e$1.white(`   npx rapidkit dev
+`)),console.log(e$1.gray("\u{1F4A1} No Python required \u2014 ASP.NET Core kit runs through the npm package with .NET tooling."));try{let{stdout:x}=await execa("dotnet",["--version"],{timeout:3e3});console.log(e$1.gray(`\u2699\uFE0F  .NET SDK ${x.trim()} detected \u2014 ready for ASP.NET Core projects`));}catch{console.log(e$1.yellow(`
+\u26A0\uFE0F  .NET SDK is not installed \u2014 install it from https://dotnet.microsoft.com/download`));}}else f$1==="node-only"?(console.log(e$1.white("   npx rapidkit create project nestjs.standard my-app")),console.log(e$1.white("   cd my-app")),console.log(e$1.white("   npx rapidkit init")),console.log(e$1.white(`   npx rapidkit dev
+`)),console.log(e$1.gray("\u{1F4A1} Node lifecycle commands run through Node tooling. RapidKit module commands for module-enabled kits can install the local Python engine later with workspace run init."))):(console.log(e$1.white("   npx rapidkit create project")),console.log(e$1.white("   cd <project-name>")),console.log(e$1.white("   npx rapidkit init")),console.log(e$1.white(`   npx rapidkit dev
+`)),console.log(e$1.gray("\u{1F4A1} Bootstrap a specific runtime: rapidkit bootstrap --profile java-only|python-only|node-only|go-only|dotnet-only|polyglot|enterprise")));console.log(e$1.cyan(`
+\u{1F4DA} More info:`)),console.log(e$1.gray("  \u2022 Change profile anytime: rapidkit bootstrap --profile <profile>")),console.log(e$1.gray("  \u2022 View config: cat "+r+"/.rapidkit-workspace")),console.log(e$1.gray("  \u2022 Check health: rapidkit doctor")),console.log("");}catch(I){throw h.fail("Failed to create workspace"),console.error(e$1.red(`
+\u274C Error:`),I),I}return}if(b.has(f$1)&&_==="skip"){let h=c("Creating workspace",{component:"create",phase:"workspace.python-engine-skipped"});try{await v.ensureDir(i),h.succeed("Directory created");let I={bootstrapNote:"python-engine-skipped",pythonEngine:"skipped",pythonEngineReason:"user-opted-out"};await U(i,r,"venv",void 0,I),await q(i,r,"venv",void 0,f$1,I),await G(i),await ye(i,"venv",{pythonEngineSkipped:true});let x={"python-only":"Python-aware",polyglot:"Polyglot",enterprise:"Enterprise"};if(await v.outputFile(y.join(i,"README.md"),`# ${r}
+
+RapidKit **${x[f$1]??f$1}** workspace with Workspace Intelligence enabled and Python engine installation skipped.
+
+## Quick start
+
+\`\`\`bash
+npx rapidkit workspace model --json
+npx rapidkit adopt /path/to/project
+npx rapidkit workspace verify --json
+\`\`\`
+
+## Add the Python engine later
+
+\`\`\`bash
+npx rapidkit create project fastapi.standard api --yes
+npx rapidkit workspace run init
+\`\`\`
+`,"utf-8"),!n){h.start("Initializing git repository");try{await execa("git",["init"],{cwd:i}),await execa("git",["add","."],{cwd:i}),await execa("git",["commit","-m",`Initial commit: RapidKit workspace (${f$1})`],{cwd:i}),h.succeed("Git repository initialized");}catch{h.warn("Could not initialize git repository");}}await L(i,{workspaceName:r,silent:a}),console.log(e$1.green(`
+\u2728 Workspace created!
+`)),console.log(e$1.cyan("\u{1F4C2} Location:"),e$1.white(i)),console.log(e$1.cyan("\u2699\uFE0F  Configuration:")),console.log(e$1.gray(`  \u2022 Profile: ${f$1}`)),console.log(e$1.gray("  \u2022 Python engine: skipped")),console.log(e$1.gray("  \u2022 Workspace Intelligence: enabled")),console.log(e$1.cyan(`
+\u{1F680} Get started:
+`)),console.log(e$1.white(`   ${k(i)}`)),console.log(e$1.white("   npx rapidkit workspace model --json")),console.log(e$1.white("   npx rapidkit adopt /path/to/project")),console.log(e$1.white(`   npx rapidkit workspace verify --json
+`)),console.log(e$1.cyan(`\u{1F4A1} Add Python-backed kits/modules later:
+`)),console.log(e$1.gray("   npx rapidkit create project fastapi.standard api --yes")),console.log(e$1.gray(`   npx rapidkit workspace run init
+`));return}catch(I){throw h.fail("Failed to create workspace"),console.error(e$1.red(`
+\u274C Error:`),I),I}}{let h=K(),I=false;try{await execa(h,["--version"],{timeout:5e3}),I=true;}catch{try{await execa("python",["--version"],{timeout:5e3}),I=true;}catch{I=false;}}if(!I){let x=f$1,k$1=We(f$1);if(S&&!u){console.log(e$1.yellow(`
+\u26A0\uFE0F  Python 3.10+ is not detected on this system.
+`)),console.log(e$1.cyan(`You have 3 options:
+`));let{pythonAction:C}=await b$2([{type:"rawlist",name:"pythonAction",message:"What would you like to do?",choices:[{name:"\u{1F4E5} Install Python now (I'll show you the command for your OS)",value:"install"},{name:`\u{1F504} Switch to "${k$1}" profile (no Python required)`,value:"fallback"},{name:"\u274C Cancel and install Python manually",value:"cancel"}]}]);if(C==="cancel"&&(console.log(e$1.cyan(`
+\u{1F4A1} How to install Python:
+`)),console.log(e$1.white("   Ubuntu / Debian:  sudo apt install python3.10")),console.log(e$1.white("   macOS (Homebrew): brew install python@3.10")),console.log(e$1.white(`   Windows:          https://python.org/downloads
+`)),console.log(e$1.gray(`   After installing Python, run:  npx rapidkit ${r}
+`)),process.exit(1)),C==="install"){console.log(e$1.cyan(`
+\u{1F4A1} Install Python on your system:
+`));let $=process.platform;$==="linux"?console.log(e$1.white(`   sudo apt update && sudo apt install python3.10 python3.10-venv
+`)):$==="darwin"?console.log(e$1.white(`   brew install python@3.10
+`)):$==="win32"&&(console.log(e$1.white(`   Download: https://python.org/downloads
+`)),console.log(e$1.white(`   Run the installer and check "Add Python to PATH"
+`))),console.log(e$1.gray(`   After installing, run:  npx rapidkit ${r}
+`)),process.exit(0);}if(C==="fallback"&&(console.log(e$1.green(`
+\u2705 Switching to "${k$1}" profile (no Python required).
+`)),f$1=k$1,ae.has(k$1))){let $=c("Creating workspace",{component:"create",phase:"workspace.python-free"});try{await v.ensureDir(i),$.succeed("Directory created"),await U(i,r,"venv",void 0),await q(i,r,"venv",void 0,k$1,{profileRequested:x,bootstrapNote:"python-free-fallback"}),await G(i);let Q={"go-only":"Go-only","java-only":"Java-only","dotnet-only":".NET-only","node-only":"Node.js-only",minimal:"Minimal"};if(await v.outputFile(y.join(i,"README.md"),`# ${r}
+
+RapidKit **${Q[k$1]}** workspace (switched from ${x} due to missing Python).
+
+## Quick start
+
+\`\`\`bash
+`+(k$1==="go-only"?`npx rapidkit create project gofiber.standard my-api
+cd my-api
+npx rapidkit init
+npx rapidkit dev
+`:k$1==="java-only"?`npx rapidkit create project springboot.standard my-service
+cd my-service
+npx rapidkit init
+npx rapidkit dev
+`:k$1==="dotnet-only"?`npx rapidkit create project dotnet.webapi.clean my-api
+cd my-api
+npx rapidkit init
+npx rapidkit dev
+`:k$1==="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"),!n){$.start("Initializing git repository");try{await execa("git",["init"],{cwd:i}),await execa("git",["add","."],{cwd:i}),await execa("git",["commit","-m",`Initial commit: RapidKit workspace (${k$1} profile)`],{cwd:i}),$.succeed("Git repository initialized");}catch{$.warn("Could not initialize git repository");}}await L(i,{workspaceName:r,silent:a}),console.log(e$1.green(`
+\u2728 Workspace created with fallback profile!
+`)),console.log(e$1.cyan("\u{1F4C2} Location:"),e$1.white(i)),console.log(e$1.cyan(`
+\u{1F680} Get started:
+`)),console.log(e$1.white(`   ${k(i)}`)),console.log(e$1.white("   npx rapidkit create project")),console.log(e$1.white("   cd <project-name>")),console.log(e$1.white("   npx rapidkit init")),console.log(e$1.white(`   npx rapidkit dev
+`)),console.log(e$1.cyan(`\u{1F4A1} To use Python later:
+`)),console.log(e$1.gray("   1. Install Python 3.10+")),console.log(e$1.gray(`   2. Run: rapidkit bootstrap --profile ${x}
+`)),console.log("");return}catch(Q){throw $.fail("Failed to create workspace"),console.error(e$1.red(`
+\u274C Error:`),Q),Q}}}else if(console.log(e$1.yellow(`
+\u26A0\uFE0F  Python not detected. Auto-switching to "${k$1}" profile (no Python required).
+`)),f$1=k$1,ae.has(k$1)){let C=c("Creating workspace",{component:"create",phase:"workspace.python-free"});try{if(await v.ensureDir(i),C.succeed("Directory created"),await U(i,r,"venv",void 0),await q(i,r,"venv",void 0,k$1,{profileRequested:x,bootstrapNote:"python-free-fallback"}),await G(i),!n){C.start("Initializing git repository");try{await execa("git",["init"],{cwd:i}),await execa("git",["add","."],{cwd:i}),await execa("git",["commit","-m",`Initial commit: RapidKit workspace (${k$1})`],{cwd:i}),C.succeed("Git repository initialized");}catch{C.warn("Could not initialize git repository");}}await L(i,{workspaceName:r,silent:a}),console.log(e$1.green(`
+\u2728 Workspace created (auto-fallback profile)!
+`)),console.log(e$1.cyan("\u{1F4C2} Location:"),e$1.white(i)),console.log(e$1.cyan("\u{1F4E6} Profile:"),e$1.yellow(k$1)),console.log(e$1.cyan("\u{1F4A1} Reason:"),e$1.gray(`Python not detected; switched from ${x}`)),console.log(e$1.cyan(`
+\u{1F680} Get started:
+`)),console.log(e$1.white(`   ${k(i)}`)),console.log(e$1.white("   npx rapidkit create project")),console.log(e$1.white("   cd <project-name>")),console.log(e$1.white("   npx rapidkit init")),console.log(e$1.white(`   npx rapidkit dev
+`)),console.log(e$1.cyan(`\u{1F4A1} Add Python later:
+`)),console.log(e$1.gray("   1. Install Python 3.10+")),console.log(e$1.gray(`   2. Run: ${k(i)} && rapidkit bootstrap --profile ${x}
+`)),console.log("");return}catch($){throw C.fail("Failed to create workspace"),console.error(e$1.red(`
+\u274C Error:`),$),$}}}}f.step(1,3,"Setting up RapidKit environment");let E=c("Creating directory",{component:"create",phase:"workspace.directory"});try{await v.ensureDir(i),E.succeed("Directory created"),E.start("Detecting Python version");let h=null,I=await De(R.pythonVersion);if(I)h=await xe(I),h?(f.info(` Detected Python ${h}`),E.succeed(`Python ${h} detected`)):E.warn("Could not detect exact Python version");else {let x=K();h=await xe(x),h?E.succeed(`Python ${h} detected`):E.warn("Could not detect Python version, proceeding with defaults");}if(R.installMethod==="poetry"&&!await Ke()&&(E.warn("Poetry not found \u2014 auto-fallback to pip + venv"),R.installMethod="venv"),await U(i,r,R.installMethod,h||void 0),h&&await He(i,h),await q(i,r,R.installMethod,h||R.pythonVersion,f$1||g),await G(i),await Ie(i,r),R.installMethod==="poetry")try{await Te(i,R.pythonVersion,E,a,p,u);}catch(x){let k=x?.details||x?.message||String(x);if(k.includes("pyenv")||k.includes("exit status 127")||k.includes("returned non-zero exit status 127")){E.warn("Poetry encountered Python discovery issues, trying venv method"),f.debug(`Poetry error (attempting venv fallback): ${k}`);try{await ge(i,R.pythonVersion,E,a,p),R.installMethod="venv";}catch(C){throw C}}else throw x}else R.installMethod==="venv"?await ge(i,R.pythonVersion,E,a,p):await Ne(i,E,a,p,u);if(await ye(i,R.installMethod),await Fe(i,R.installMethod),E.succeed("RapidKit environment ready!"),!o.skipGit){E.start("Initializing git repository");try{await execa("git",["init"],{cwd:i}),await execa("git",["add","."],{cwd:i}),await execa("git",["commit","-m","Initial commit: RapidKit environment"],{cwd:i}),E.succeed("Git repository initialized");}catch{E.warn("Could not initialize git repository");}}if(await L(i,{workspaceName:r,silent:a}),console.log(e$1.green(`
+\u2728 RapidKit environment created successfully!
+`)),console.log(e$1.cyan("\u{1F4C2} Location:"),e$1.white(i)),console.log(e$1.cyan("\u2699\uFE0F  Configuration:")),console.log(e$1.gray(`  \u2022 Profile: ${f$1}`)),console.log(e$1.gray(`  \u2022 Python: ${R.pythonVersion}`)),console.log(e$1.gray(`  \u2022 Install method: ${R.installMethod}`)),console.log(e$1.cyan(`
+\u{1F680} Get started:
+`)),console.log(e$1.white(`   ${k(i)}`)),R.installMethod==="poetry"){let x="source $(poetry env info --path)/bin/activate";try{H();let{stdout:k}=await execa("poetry",["--version"]),D=k.match(/Poetry.*?(\d+)\.(\d+)/);D&&(parseInt(D[1])>=2?x="source $(poetry env info --path)/bin/activate":x="poetry shell");}catch{}console.log(e$1.white(`   ${x}  # Or: poetry run rapidkit`)),console.log(e$1.white("   rapidkit create  # Interactive mode")),console.log(e$1.white("   cd <project-name>")),console.log(e$1.white("   rapidkit init")),console.log(e$1.white("   rapidkit dev")),console.log(e$1.gray(`
+   \u{1F4E6} Why Poetry? Includes dependency management + virtual environment`));}else R.installMethod==="venv"?(console.log(e$1.white("   source .venv/bin/activate  # On Windows: .venv\\Scripts\\activate")),console.log(e$1.white("   rapidkit create  # Interactive mode")),console.log(e$1.white("   cd <project-name>")),console.log(e$1.white("   rapidkit init")),console.log(e$1.white("   rapidkit dev")),console.log(e$1.gray(`
+   \u{1F4E6} Why venv? Standard, zero extra tools, lightweight`))):(console.log(e$1.white("   rapidkit create  # Interactive mode")),console.log(e$1.white("   cd <project-name>")),console.log(e$1.white("   rapidkit init")),console.log(e$1.white("   rapidkit dev")),console.log(e$1.gray(`
+   \u{1F4E6} Why pipx? Global isolated install, no local venv`)));console.log(e$1.cyan(`
+\u{1F4DA} Next steps:`)),console.log(e$1.gray("  1. Check README.md for workspace details")),console.log(e$1.gray("  2. Create your first project: rapidkit create project")),console.log(e$1.gray("  3. See all runtimes: rapidkit list  # Shows: fastapi, nestjs, springboot, gofiber, gogin, dotnet")),console.log(e$1.cyan(`
+\u{1F4A1} Profile management:`)),console.log(e$1.gray("  \u2022 Add Python? \u2192 rapidkit bootstrap --profile python-only|polyglot")),console.log(e$1.gray("  \u2022 Add Node.js? \u2192 rapidkit bootstrap --profile node-only|polyglot")),console.log(e$1.gray("  \u2022 Add Go? \u2192 rapidkit bootstrap --profile go-only|polyglot")),console.log(e$1.gray("  \u2022 Add .NET? \u2192 rapidkit bootstrap --profile dotnet-only|polyglot")),console.log(e$1.gray("  \u2022 Full setup? \u2192 rapidkit bootstrap --profile enterprise")),console.log(e$1.cyan(`
+\u{1F4D6} Common commands:`)),console.log(e$1.white("   rapidkit create              - Create a new project (interactive)")),console.log(e$1.white("   rapidkit list                - List available kits")),console.log(e$1.white("   rapidkit modules             - List available modules")),console.log(e$1.white("   rapidkit doctor              - Check workspace health")),console.log(e$1.white(`   rapidkit bootstrap --help    - Advanced workspace configuration
+`));try{let{stdout:x}=await execa("go",["version"],{timeout:3e3}),k=x.match(/go version go(\d+\.\d+(?:\.\d+)?)/),D=k?k[1]:"unknown";console.log(e$1.gray(`\u{1F439} Go ${D} detected \u2014 ready for gofiber.standard projects`));}catch{console.log(e$1.yellow("\u26A0\uFE0F  Go not installed \u2014 needed for gofiber.standard/gogin.standard projects")),console.log(e$1.gray("   Install: https://go.dev/dl/"));}console.log("");}catch(h){E.fail("Failed to create RapidKit environment"),console.error(e$1.red(`
+\u274C Error:`),h);try{await v.remove(i);}catch{}throw h}}async function De(t){let o=[];if(!b$3())try{let{stdout:l}=await execa("pyenv",["which","python"]),d=l.trim();d&&o.push(d);}catch{}let n=Number(t.split(".")[1]),s=j(n,10).map(l=>l.command).filter(Boolean);o.push(`python${t}`,...s,...i());let a=[...new Set(o)];for(let l of a)try{let d=l==="py"?["-3","--version"]:["--version"],u=l==="py"?["-3","-c","import sys; sys.exit(0)"]:["-c","import sys; sys.exit(0)"],{stdout:p}=await execa(l,d,{timeout:2e3}),w=p.match(/Python (\d+\.\d+)/)?.[1];if(w&&Y(w,t))return await execa(l,u,{timeout:2e3}),l}catch{continue}return null}async function Te(t,o,n,s,a,l$1=false){await Be(n,l$1),n.start("Finding Python interpreter");let d=await De(o);d?(f.debug(`Found working Python: ${d}`),n.succeed("Python found")):n.warn("Could not verify Python path, proceeding with default"),n.start("Initializing Poetry project");let u=y.join(t,"pyproject.toml"),w=(await v.pathExists(u)?await promises.readFile(u,"utf-8"):"").includes("rapidkit-core");if(w)n.succeed("Poetry project initialized");else {await execa("poetry",["init","--no-interaction","--python",`^${o}`],{cwd:t}),n.succeed("Poetry project initialized");let i=await promises.readFile(u,"utf-8");i.includes("[tool.poetry]")?i=i.replace("[tool.poetry]",`[tool.poetry]
+package-mode = false`):i.includes("[project]")&&(i.includes("[build-system]")?i=i.replace("[build-system]",`
+[tool.poetry]
+package-mode = false
+
+[build-system]`):i+=`
+
+[tool.poetry]
+package-mode = false
+`),await promises.writeFile(u,i,"utf-8");}n.start("Configuring Poetry");try{await execa("poetry",["config","virtualenvs.in-project","true","--local"],{cwd:t}),n.succeed("Poetry configured");}catch{n.warn("Could not configure Poetry virtualenvs.in-project");}n.start("Creating virtualenv");let g$1=d||K(),m=l(y.join(t,".venv"));try{await execa(g$1,["-m","venv",".venv"],{cwd:t,timeout:6e4}),n.succeed("Virtualenv created");}catch(r){f.debug(`python -m venv failed: ${r}`),n.warn("Could not pre-create virtualenv, Poetry will try"),m=d||K();}try{await execa("poetry",["env","use",m||K()],{cwd:t}),f.debug(`Poetry env set to: ${m}`);}catch(r){f.debug(`Could not set Poetry env: ${r}`);}if(n.start("Installing RapidKit"),w&&!s){let r=e$2(a||{}),i=r?await v.pathExists(r):false,b=i&&r?r:"rapidkit-core";r&&!i&&f.warn(`RAPIDKIT_DEV_PATH is set but path does not exist: ${r}. Falling back to PyPI.`),n.text=i?"Installing RapidKit from local path":"Installing RapidKit from PyPI";let f$2=false,S=null;for(let _=1;_<=3;_++)try{i||e$3({status:"started",message:"Installing RapidKit from PyPI",installMethod:"poetry",attempt:_,maxAttempts:3}),await execa(m,["-m","pip","install",b,"--quiet"],{cwd:t,timeout:18e4}),f$2=true,i||e$3({status:"succeeded",message:"RapidKit installed from PyPI",installMethod:"poetry",attempt:_,maxAttempts:3});break}catch(F){S=F,f.debug(`pip install rapidkit-core attempt ${_} failed: ${F}`),_<3&&(n.text=`Retrying installation (attempt ${_+1}/3)`,await new Promise(ne=>setTimeout(ne,2e3)));}if(!f$2){let _=S?.stderr||S?.message||"Unknown error";throw f.debug(`All pip install attempts failed. Last error: ${_}`),_.includes("Could not find")||_.includes("No matching distribution")?new g:new f$1("Install rapidkit-core with pip",new Error(`Failed to install rapidkit-core after 3 attempts.
+Error: ${_}
+
+Possible solutions:
+  1. Check your internet connection
+  2. Try installing manually: cd ${y.basename(t)} && poetry add rapidkit-core
+  3. Use venv method instead: npx rapidkit ${y.basename(t)} --install-method=venv`))}}else {n.text="Syncing Poetry environment";try{await execa("poetry",["install","--no-root"],{cwd:t,timeout:12e4}),n.succeed("Poetry environment synced");}catch(r){f.debug(`poetry install --no-root failed: ${r}`),n.warn("Could not sync Poetry environment, proceeding with add command");}if(n.start("Installing RapidKit"),s){let r=e$2(a||{});if(!r)throw new f$1("Test mode installation",new Error("No local RapidKit path configured. Set RAPIDKIT_DEV_PATH environment variable."));f.debug(`Installing from local path: ${r}`),n.text="Installing RapidKit from local path (test mode)",await execa("poetry",["add",r],{cwd:t});}else {n.text="Installing RapidKit from PyPI";let r=false,i=null;for(let b=1;b<=3;b++)try{e$3({status:"started",message:"Installing RapidKit from PyPI",installMethod:"poetry",attempt:b,maxAttempts:3}),await execa("poetry",["add","rapidkit-core"],{cwd:t,timeout:6e4*b}),r=true,e$3({status:"succeeded",message:"RapidKit installed from PyPI",installMethod:"poetry",attempt:b,maxAttempts:3});break}catch(f$1){i=f$1,f.debug(`Poetry add attempt ${b} failed: ${f$1}`),b<3&&(n.text=`Retrying installation (attempt ${b+1}/3)`,await new Promise(S=>setTimeout(S,2e3)));}if(!r){let b=i?.stderr||i?.message||"Unknown error";throw f.debug(`All Poetry install attempts failed. Last error: ${b}`),b.includes("Could not find")||b.includes("No matching distribution")?new g:new f$1("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 ${y.basename(t)} && poetry add rapidkit-core
+  3. Use venv method instead: npx rapidkit ${y.basename(t)} --install-method=venv`))}}}n.succeed("RapidKit installed in project virtualenv");try{let{checkRapidkitCoreAvailable:r}=await import('./pythonRapidkitExec-SGKW76XM.js');if(!await r()&&!s){n.start("Checking optional global pipx installation");let b=await oe(n,true);try{n.start("Installing RapidKit globally with pipx for CLI access"),await W(b,["install","rapidkit-core"]),n.succeed("RapidKit installed globally");}catch(f$1){n.warn("Could not install globally (non-fatal, project virtualenv has RapidKit)"),f.debug(`pipx install failed: ${f$1}`);}}}catch(r){n.succeed("Skipped optional global pipx installation"),f.debug(`Global install check skipped: ${r}`);}}async function ge(t,o,n,s,a,l$1=false){n.start(`Checking Python ${o}`);let d=K();try{let{stdout:p}=await execa(d,["--version"]),w=p.match(/Python (\d+\.\d+)/)?.[1];if(w&&!Y(w,o))throw new b$4(o,w);n.succeed(`Python ${w} found`);}catch(p){throw p instanceof b$4?p:new b$4(o)}n.start("Creating virtual environment");try{await execa(d,["-m","venv",".venv"],{cwd:t}),n.succeed("Virtual environment created");}catch(p){if(n.fail("Failed to create virtual environment"),(g=>typeof g=="object"&&g!==null&&"stdout"in g&&typeof g.stdout=="string")(p)&&p.stdout.includes("ensurepip is not")){let g=p.stdout.match(/apt install (python[\d.]+-venv)/),m=g?g[1]:"python3-venv";throw new f$1("Python venv module not available",new Error(`Virtual environment creation failed.
+
+On Debian/Ubuntu systems, install the venv package:
+  sudo apt install ${m}
+
+Or use Poetry instead (recommended):
+  npx rapidkit ${y.basename(t)} --yes`))}throw new f$1("Virtual environment creation",p instanceof Error?p:new Error(String(p)))}n.start("Installing RapidKit");let u=l(y.join(t,".venv"));if(await execa(u,["-m","pip","install","--upgrade","pip"],{cwd:t}),s){let p=e$2(a||{});if(!p)throw new f$1("Test mode installation",new Error("No local RapidKit path configured. Set RAPIDKIT_DEV_PATH environment variable."));f.debug(`Installing from local path: ${p}`),n.text="Installing RapidKit from local path (test mode)",await execa(u,["-m","pip","install","-e",p],{cwd:t});}else {n.text="Installing RapidKit from PyPI";let p=false,w=null;for(let g=1;g<=3;g++)try{e$3({status:"started",message:"Installing RapidKit from PyPI",installMethod:"venv",attempt:g,maxAttempts:3}),await execa(u,["-m","pip","install","rapidkit-core"],{cwd:t,timeout:6e4*g}),p=true,e$3({status:"succeeded",message:"RapidKit installed from PyPI",installMethod:"venv",attempt:g,maxAttempts:3});break}catch(m){w=m,f.debug(`pip install attempt ${g} failed: ${m}`),g<3&&(n.text=`Retrying installation (attempt ${g+1}/3)`,await new Promise(r=>setTimeout(r,2e3)));}if(!p){let g$1=w?.stderr||w?.message||"Unknown error";throw f.debug(`All pip install attempts failed. Last error: ${g$1}`),g$1.includes("Could not find")||g$1.includes("No matching distribution")?new g:new f$1("Install rapidkit-core with pip",new Error(`Failed to install rapidkit-core after 3 attempts.
+Error: ${g$1}
+
+Possible solutions:
+  1. Check your internet connection
+  2. Try installing manually: cd ${y.basename(t)} && ${l(".venv")} -m pip install rapidkit-core
+  3. Use Poetry instead: npx rapidkit ${y.basename(t)} --install-method=poetry`))}}n.succeed("RapidKit installed in project virtualenv");try{let{checkRapidkitCoreAvailable:p}=await import('./pythonRapidkitExec-SGKW76XM.js');if(!await p()&&!s){n.start("Checking optional global pipx installation");let g=await oe(n,true);try{n.start("Installing RapidKit globally with pipx for CLI access"),await W(g,["install","rapidkit-core"]),n.succeed("RapidKit installed globally");}catch(m){n.warn("Could not install globally (non-fatal, project virtualenv has RapidKit)"),f.debug(`pipx install failed: ${m}`);}}}catch(p){n.succeed("Skipped optional global pipx installation"),f.debug(`Global install check skipped: ${p}`);}}async function Ne(t,o,n,s,a=false){if(!n)try{let{checkRapidkitCoreVersionCompatible:d}=await import('./pythonRapidkitExec-SGKW76XM.js'),u=await d();if(u.isCompatible){o.succeed(`RapidKit ${u.installedVersion??""} already compatible globally; skipping pipx installation`),await v.outputFile(y.join(t,".rapidkit-global"),`RapidKit already available globally (version ${u.installedVersion??"unknown"}) and satisfies expected constraint ${u.expectedConstraint??"n/a"}; workspace will reuse the existing installation
+`,"utf-8");return}u.reason==="constraint-missing"?o.warn('Version-aware global reuse skipped: no explicit rapidkit-core version constraint found. Set RAPIDKIT_CORE_PYTHON_PACKAGE (example: RAPIDKIT_CORE_PYTHON_PACKAGE="rapidkit-core>=0.4.0,<0.9.0") to enable version-aware reuse. Proceeding with pipx install/upgrade.'):u.reason==="constraint-unsupported"&&o.warn('Version-aware global reuse skipped: RAPIDKIT_CORE_PYTHON_PACKAGE uses an unsupported spec (path/url/git). Use a version range instead (example: RAPIDKIT_CORE_PYTHON_PACKAGE="rapidkit-core==0.4.0" or "rapidkit-core>=0.4.0,<0.9.0"). Proceeding with pipx install/upgrade.'),f.debug(`Global RapidKit install is not reusable via version-aware policy (reason=${u.reason}, installed=${u.installedVersion??"unknown"}, expected=${u.expectedConstraint??"none"}). Proceeding with pipx install/upgrade.`);}catch(d){f.debug(`Global RapidKit version-aware check failed before pipx install: ${d}`);}let l=await oe(o,a);if(o.start("Installing RapidKit globally with pipx"),n){let d=e$2(s||{});if(!d)throw new f$1("Test mode installation",new Error("No local RapidKit path configured. Set RAPIDKIT_DEV_PATH environment variable."));f.debug(`Installing from local path: ${d}`),o.text="Installing RapidKit from local path (test mode)",await W(l,["install","-e",d]);}else {o.text="Installing RapidKit from PyPI",e$3({status:"started",message:"Installing RapidKit from PyPI",installMethod:"pipx"});try{await W(l,["install","rapidkit-core"]),e$3({status:"succeeded",message:"RapidKit installed from PyPI",installMethod:"pipx"});}catch(d){try{o.text="RapidKit already installed globally, upgrading to match expected version",await W(l,["upgrade","rapidkit-core"]),e$3({status:"succeeded",message:"RapidKit upgraded from PyPI",installMethod:"pipx"});}catch(u){throw f.debug(`pipx install/upgrade failed: install=${d}, upgrade=${u}`),new g}}}o.succeed("RapidKit installed globally"),await v.outputFile(y.join(t,".rapidkit-global"),`RapidKit installed globally with pipx
+`,"utf-8");}async function It(t,o){let{skipGit:n=false,testMode:s=false,userConfig:a={},yes:l=false,installMethod:d,pythonVersion:u="3.10"}=o||{},p=d||a.defaultInstallMethod||await(async()=>{try{return await execa("poetry",["--version"],{timeout:3e3}),"poetry"}catch{return f.warn("Poetry not found \u2014 auto-selecting venv. Pass --install-method poetry to override."),"venv"}})(),w=p==="poetry"&&!await Ke()?"venv":p;await U(t,y.basename(t),w),await G(t),await q(t,y.basename(t),w,u,o?.profile);let g=c("Registering workspace",{component:"create",phase:"workspace.register"});try{if(w==="poetry"?(await Ie(t,y.basename(t)),await Te(t,u,g,s,a,l)):w==="venv"?await ge(t,u,g,s,a):await Ne(t,g,s,a,l),await ye(t,w),await Fe(t,w),g.succeed("Workspace registered"),await L(t,{workspaceName:y.basename(t),silent:s}),!n){g.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}),g.succeed("Git repository initialized");}catch{g.warn("Could not initialize git repository");}}}catch(m){throw g.fail("Failed to register workspace"),m}}async function Fe(t,o){let n=o==="poetry"?`source $(poetry env info --path)/bin/activate
+# Or simply use: poetry run rapidkit <command>`:o==="venv"?"source .venv/bin/activate  # On Windows: .venv\\Scripts\\activate":"N/A (globally installed)",s=o==="poetry"?`# No activation needed (recommended):
+./rapidkit --help
+# or:
+poetry run rapidkit --help`:o==="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)`,a=b$3()?"python --version (or: py -3 --version)":"python3 --version (or: python --version)",l=`# RapidKit Workspace
+
+This directory contains a RapidKit development environment.
+
+## Installation Method
+
+**${o==="poetry"?"Poetry":o==="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
+${s}
+\`\`\`
+
+### 1. Activate Environment
+
+\`\`\`bash
+${n}
+\`\`\`
+
+### 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
+
+\`\`\`
+${o==="venv"?".venv/          # Python virtual environment":""}
+${o==="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: \`${a}\`
+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"),l,"utf-8");}async function Xe(t,o,n){let s=c("Creating demo workspace",{component:"create",phase:"workspace.demo"});try{await v.ensureDir(t),s.succeed("Directory created"),s.start("Setting up demo kit generator");let a=JSON.stringify({name:`${o}-workspace`,version:"1.0.0",private:true,description:"RapidKit demo workspace",scripts:{generate:"node generate-demo.js"}},null,2);await promises.writeFile(y.join(t,"package.json"),a,"utf-8"),await promises.writeFile(y.join(t,"generate-demo.js"),`#!/usr/bin/env node
+/**
+ * Demo Kit Generator - Create FastAPI demo projects
+ * 
+ * This workspace contains bundled RapidKit templates that you can use
+ * to generate demo projects without installing Python RapidKit.
+ * 
+ * Usage:
+ *   npm run generate <project-name>
+ *   node generate-demo.js <project-name>
+ * 
+ * Example:
+ *   npm run generate my-api
+ */
+
+const 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",y.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.
+
+## \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
+
+\`\`\`
+${o}/
+  \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/rapidkitlabs/rapidkit-npm)
+`;if(await promises.writeFile(y.join(t,"README.md"),d,"utf-8"),s.succeed("Demo workspace setup complete"),!n){s.start("Initializing git repository");try{await execa("git",["init"],{cwd:t}),await v.outputFile(y.join(t,".gitignore"),`# Dependencies
+node_modules/
+
+# Generated projects
+*/
+!generate-demo.js
+!README.md
+
+# Python
+__pycache__/
+*.pyc
+.venv/
+.env
+`,"utf-8"),await execa("git",["add","."],{cwd:t}),await execa("git",["commit","-m","Initial commit: Demo workspace"],{cwd:t}),s.succeed("Git repository initialized");}catch{s.warn("Could not initialize git repository");}}console.log(e$1.green(`
+\u2728 Demo workspace created successfully!
+`)),console.log(e$1.cyan("\u{1F4C2} Location:"),e$1.white(t)),console.log(e$1.cyan(`\u{1F680} Get started:
+`)),console.log(e$1.white(`   ${k(t)}`)),console.log(e$1.white("   node generate-demo.js my-api")),console.log(e$1.white("   cd my-api")),console.log(e$1.white("   rapidkit init")),console.log(e$1.white("   rapidkit dev")),console.log(),console.log(e$1.yellow("\u{1F4A1} Note:"),"This is a demo workspace. For full RapidKit features:"),console.log(e$1.cyan("   pipx install rapidkit")),console.log();}catch(a){throw s.fail("Failed to create demo workspace"),a}}async function Ze(t,o,n,s,a,l,d){if(console.log(e$1.cyan(`
+\u{1F50D} Dry-run mode - what would be created:
+`)),console.log(e$1.white("\u{1F4C2} Workspace path:"),t),console.log(e$1.white("\u{1F4DB} Name:"),e$1.cyan(o)),n)console.log(e$1.white("\u{1F4E6} Type:"),"Demo environment"),console.log(e$1.white(`
+\u{1F4DD} Files to create:`)),console.log(e$1.gray("  - package.json")),console.log(e$1.gray("  - generate-demo.js (project generator)")),console.log(e$1.gray("  - README.md")),console.log(e$1.gray("  - .gitignore")),console.log(e$1.white(`
+\u{1F3AF} Capabilities:`)),console.log(e$1.gray("  - Generate FastAPI/NestJS demo projects")),console.log(e$1.gray("  - No Python RapidKit installation required")),console.log(e$1.gray("  - Bundled templates"));else {let u=a||"minimal",p=l,w=d,m=new Set(["python-only","polyglot","enterprise"]).has(u);console.log(e$1.white("\u{1F4E6} Profile:"),e$1.cyan(u)),console.log(e$1.white("\u{1F4DD} Configuration:")),m?(console.log(e$1.gray(`  - Python version: ${w}`)),console.log(e$1.gray(`  - Install method: ${p}`)),console.log(e$1.gray(`  - Git init: ${s.skipGit?"No":"Yes"}`))):(console.log(e$1.gray("  - Python-free profile (no Python needed)")),console.log(e$1.gray(`  - Git init: ${s.skipGit?"No":"Yes"}`))),console.log(e$1.white(`
+\u{1F4CB} Files to create:`)),console.log(e$1.gray("  - .rapidkit-workspace (workspace marker)")),console.log(e$1.gray("  - .rapidkit/ (workspace config directory)")),console.log(e$1.gray("  - README.md")),console.log(e$1.gray("  - .gitignore")),m&&console.log(e$1.gray(`  - ${p==="poetry"?"pyproject.toml + poetry.lock":".venv/ (virtual environment)"}`)),console.log(e$1.white(`
+\u2699\uFE0F  Environment setup:`)),m&&console.log(p==="poetry"?e$1.gray("  - Poetry virtual environment created (recommended, includes dependency management)"):p==="venv"?e$1.gray("  - Python venv created in .venv/ (standard, zero extra tools)"):e$1.gray("  - Global pipx install (isolated, not local to workspace)")),console.log(e$1.white(`
+\u{1F680} Next steps:`)),console.log(e$1.gray(`  1. ${k(t)}`)),console.log(e$1.gray("  2. npx rapidkit create project")),console.log(e$1.gray("  3. npx rapidkit init")),console.log(e$1.gray("  4. npx rapidkit dev")),console.log(e$1.white(`
+\u{1F4A1} Learn more:`)),console.log(e$1.gray("  \u2022 Change profile later: rapidkit bootstrap --profile <profile>")),console.log(e$1.gray("  \u2022 Profile options: minimal|java-only|python-only|node-only|go-only|dotnet-only|polyglot|enterprise")),console.log(e$1.gray("  \u2022 Help: npx rapidkit --help"));}console.log(e$1.white(`
+\u2728 To proceed: remove --dry-run flag
+`));}export{Ee as a,xt as b,Se as c,We as d,ye as e,Rt as f,It as g};