@voltx/cli 0.2.0 → 0.3.0

package/dist/chunk-IV352HZA.mjs

@@ -0,0 +1,107 @@
+// src/welcome.ts
+var ESC = "\x1B[";
+var RESET = `${ESC}0m`;
+var ITALIC = `${ESC}3m`;
+function rgb(r, g, b, text) {
+  return `${ESC}38;2;${r};${g};${b}m${text}${RESET}`;
+}
+function lerp(a, b, t) {
+  return Math.round(a + (b - a) * t);
+}
+function gradientLine(text, from, to) {
+  const len = text.length;
+  if (len === 0) return "";
+  return text.split("").map((char, i) => {
+    const t = len === 1 ? 0 : i / (len - 1);
+    const r = lerp(from.r, to.r, t);
+    const g = lerp(from.g, to.g, t);
+    const b = lerp(from.b, to.b, t);
+    return rgb(r, g, b, char);
+  }).join("");
+}
+function gradientBlock(lines, colors) {
+  return lines.map((line, i) => {
+    const t = lines.length === 1 ? 0 : i / (lines.length - 1);
+    const segIndex = t * (colors.length - 1);
+    const fromIdx = Math.floor(segIndex);
+    const toIdx = Math.min(fromIdx + 1, colors.length - 1);
+    const localT = segIndex - fromIdx;
+    const from = {
+      r: lerp(colors[fromIdx].r, colors[toIdx].r, localT),
+      g: lerp(colors[fromIdx].g, colors[toIdx].g, localT),
+      b: lerp(colors[fromIdx].b, colors[toIdx].b, localT)
+    };
+    const to = {
+      r: lerp(colors[Math.min(fromIdx + 1, colors.length - 1)].r, colors[Math.min(toIdx + 1, colors.length - 1)].r, localT),
+      g: lerp(colors[Math.min(fromIdx + 1, colors.length - 1)].g, colors[Math.min(toIdx + 1, colors.length - 1)].g, localT),
+      b: lerp(colors[Math.min(fromIdx + 1, colors.length - 1)].b, colors[Math.min(toIdx + 1, colors.length - 1)].b, localT)
+    };
+    return gradientLine(line, from, to);
+  }).join("\n");
+}
+var VOLTX_BANNER = [
+  "  \u2588\u2588\u2557   \u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557  \u2588\u2588\u2557",
+  "  \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551  \u255A\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255D\u255A\u2588\u2588\u2557\u2588\u2588\u2554\u255D",
+  "  \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2551    \u255A\u2588\u2588\u2588\u2554\u255D ",
+  "  \u255A\u2588\u2588\u2557 \u2588\u2588\u2554\u255D\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2551    \u2588\u2588\u2554\u2588\u2588\u2557 ",
+  "   \u255A\u2588\u2588\u2588\u2588\u2554\u255D \u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551   \u2588\u2588\u2554\u255D \u2588\u2588\u2557",
+  "    \u255A\u2550\u2550\u2550\u255D   \u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D   \u255A\u2550\u255D  \u255A\u2550\u255D"
+];
+var VOLTX_COLORS = [
+  { r: 0, g: 180, b: 255 },
+  // electric blue
+  { r: 120, g: 80, b: 255 },
+  // purple
+  { r: 255, g: 50, b: 180 },
+  // hot pink
+  { r: 255, g: 120, b: 50 }
+  // orange
+];
+function dimRule(width = 48) {
+  return `  ${rgb(60, 60, 80, "\u2500".repeat(width))}`;
+}
+function printWelcomeBanner(projectName) {
+  console.log("");
+  console.log(gradientBlock(VOLTX_BANNER, VOLTX_COLORS));
+  console.log("");
+  console.log(
+    `  ${ITALIC}${rgb(180, 180, 220, "The AI-first full-stack framework")}${RESET}`
+  );
+  console.log("");
+  if (projectName) {
+    console.log(
+      `  ${ITALIC}${rgb(120, 220, 180, `Thank you for choosing VoltX! \u26A1`)}${RESET}`
+    );
+    console.log(
+      `  ${ITALIC}${rgb(160, 160, 200, `Your project "${projectName}" is ready to go.`)}${RESET}`
+    );
+    console.log("");
+    console.log(`  ${rgb(100, 180, 255, "Next steps:")}`);
+    console.log(`  ${rgb(200, 200, 220, `  cd ${projectName}`)}`);
+    console.log(`  ${rgb(200, 200, 220, "  pnpm install")}`);
+    console.log(`  ${rgb(200, 200, 220, "  pnpm dev          # or: npx voltx dev")}`);
+    console.log("");
+    console.log(dimRule());
+    console.log("");
+    console.log(
+      `  ${rgb(255, 200, 80, "\u2615")} ${ITALIC}${rgb(200, 180, 140, "Love VoltX? Support us and fuel the next update:")}${RESET}`
+    );
+    console.log(
+      `     ${rgb(255, 180, 100, "https://buymeacoffee.com/promptlyai")}`
+    );
+    console.log("");
+    console.log(dimRule());
+    console.log("");
+    console.log(
+      `  ${ITALIC}${rgb(140, 140, 170, "Docs: https://voltx.co.in  \u2022  GitHub: github.com/codewithshail/voltx")}${RESET}`
+    );
+    console.log(
+      `  ${ITALIC}${rgb(100, 100, 130, "Made with \u2665 by the Promptly AI Team")}${RESET}`
+    );
+    console.log("");
+  }
+}
+
+export {
+  printWelcomeBanner
+};

package/dist/chunk-KFHPTRKZ.mjs

@@ -0,0 +1,405 @@
+import {
+  printWelcomeBanner
+} from "./chunk-IV352HZA.mjs";
+import {
+  __require
+} from "./chunk-Y6FXYEAI.mjs";
+
+// src/create.ts
+import * as fs from "fs";
+import * as path from "path";
+async function createProject(options) {
+  const { name, template = "blank", auth = "none" } = options;
+  const targetDir = path.resolve(process.cwd(), name);
+  if (fs.existsSync(targetDir)) {
+    console.error(`[voltx] Directory "${name}" already exists.`);
+    process.exit(1);
+  }
+  fs.mkdirSync(targetDir, { recursive: true });
+  const templateDeps = {
+    blank: {
+      "@voltx/core": "^0.3.0",
+      "@voltx/server": "^0.3.0"
+    },
+    chatbot: {
+      "@voltx/core": "^0.3.0",
+      "@voltx/ai": "^0.3.0",
+      "@voltx/server": "^0.3.0",
+      "@voltx/memory": "^0.3.0"
+    },
+    "rag-app": {
+      "@voltx/core": "^0.3.0",
+      "@voltx/ai": "^0.3.0",
+      "@voltx/server": "^0.3.0",
+      "@voltx/rag": "^0.3.0",
+      "@voltx/db": "^0.3.0"
+    },
+    "agent-app": {
+      "@voltx/core": "^0.3.0",
+      "@voltx/ai": "^0.3.0",
+      "@voltx/server": "^0.3.0",
+      "@voltx/agents": "^0.3.0",
+      "@voltx/memory": "^0.3.0"
+    }
+  };
+  const packageJson = {
+    name,
+    version: "0.1.0",
+    private: true,
+    scripts: {
+      dev: "voltx dev",
+      build: "voltx build",
+      start: "voltx start"
+    },
+    dependencies: {
+      ...templateDeps[template] ?? templateDeps["blank"],
+      "@voltx/cli": "^0.3.0",
+      ...auth === "better-auth" ? { "@voltx/auth": "^0.3.0", "better-auth": "^1.5.0" } : {},
+      ...auth === "jwt" ? { "@voltx/auth": "^0.3.0", "jose": "^6.0.0" } : {}
+    },
+    devDependencies: {
+      typescript: "^5.7.0",
+      tsx: "^4.21.0",
+      tsup: "^8.0.0",
+      "@types/node": "^22.0.0"
+    }
+  };
+  fs.writeFileSync(
+    path.join(targetDir, "package.json"),
+    JSON.stringify(packageJson, null, 2)
+  );
+  const hasDb = template === "rag-app" || template === "agent-app" || auth === "better-auth";
+  const provider = template === "rag-app" ? "openai" : "cerebras";
+  const model = template === "rag-app" ? "gpt-4o" : "llama-4-scout-17b-16e";
+  let configContent = `import { defineConfig } from "@voltx/core";
+
+export default defineConfig({
+  name: "${name}",
+  port: 3000,
+  ai: {
+    provider: "${provider}",
+    model: "${model}",
+  },`;
+  if (hasDb) {
+    configContent += `
+  db: {
+    url: process.env.DATABASE_URL,
+  },`;
+  }
+  if (auth !== "none") {
+    configContent += `
+  auth: {
+    provider: "${auth}",
+  },`;
+  }
+  configContent += `
+  server: {
+    routesDir: "src/routes",
+    staticDir: "public",
+    cors: true,
+  },
+});
+`;
+  fs.writeFileSync(path.join(targetDir, "voltx.config.ts"), configContent);
+  fs.mkdirSync(path.join(targetDir, "src", "routes", "api"), { recursive: true });
+  fs.mkdirSync(path.join(targetDir, "public"), { recursive: true });
+  fs.writeFileSync(
+    path.join(targetDir, "src", "index.ts"),
+    `import { createApp } from "@voltx/core";
+import config from "../voltx.config";
+
+const app = createApp(config);
+app.start();
+`
+  );
+  fs.writeFileSync(
+    path.join(targetDir, "src", "routes", "index.ts"),
+    `// GET / \u2014 Health check
+import type { Context } from "@voltx/server";
+
+export function GET(c: Context) {
+  return c.json({ name: "${name}", status: "ok" });
+}
+`
+  );
+  if (template === "chatbot" || template === "agent-app") {
+    fs.writeFileSync(
+      path.join(targetDir, "src", "routes", "api", "chat.ts"),
+      `// POST /api/chat \u2014 Streaming chat with conversation memory
+import type { Context } from "@voltx/server";
+import { streamText } from "@voltx/ai";
+import { createMemory } from "@voltx/memory";
+
+// In-memory for dev; swap to createMemory("postgres", { url }) for production
+const memory = createMemory({ maxMessages: 50 });
+
+export async function POST(c: Context) {
+  const { messages, conversationId = "default" } = await c.req.json();
+
+  // Store the latest user message
+  const lastMessage = messages[messages.length - 1];
+  if (lastMessage?.role === "user") {
+    await memory.add(conversationId, { role: "user", content: lastMessage.content });
+  }
+
+  // Get conversation history from memory
+  const history = await memory.get(conversationId);
+
+  const result = await streamText({
+    model: "${provider}:${model}",
+    system: "You are a helpful AI assistant.",
+    messages: history.map((m) => ({ role: m.role, content: m.content })),
+  });
+
+  // Store assistant response after stream completes
+  result.text.then(async (text) => {
+    await memory.add(conversationId, { role: "assistant", content: text });
+  });
+
+  return result.toSSEResponse();
+}
+`
+    );
+  }
+  if (template === "agent-app") {
+    fs.mkdirSync(path.join(targetDir, "src", "agents"), { recursive: true });
+    fs.mkdirSync(path.join(targetDir, "src", "tools"), { recursive: true });
+    fs.writeFileSync(
+      path.join(targetDir, "src", "agents", "assistant.ts"),
+      `import { createAgent } from "@voltx/agents";
+import { searchTool } from "../tools/search";
+
+export const assistant = createAgent({
+  name: "assistant",
+  model: "${provider}:${model}",
+  instructions: "You are a helpful AI assistant. Use your tools when needed.",
+  tools: [searchTool],
+  maxIterations: 5,
+});
+`
+    );
+    fs.writeFileSync(
+      path.join(targetDir, "src", "tools", "search.ts"),
+      `import type { Tool } from "@voltx/agents";
+
+export const searchTool: Tool = {
+  name: "search",
+  description: "Search for information on a topic.",
+  parameters: {
+    type: "object",
+    properties: { query: { type: "string", description: "The search query" } },
+    required: ["query"],
+  },
+  async execute(args: { query: string }) {
+    return \`Search results for "\${args.query}": Placeholder \u2014 connect a real search API.\`;
+  },
+};
+`
+    );
+    fs.writeFileSync(
+      path.join(targetDir, "src", "routes", "api", "agent.ts"),
+      `import type { Context } from "@voltx/server";
+import { assistant } from "../../agents/assistant";
+
+export async function POST(c: Context) {
+  const { input } = await c.req.json();
+  if (!input) return c.json({ error: "Missing 'input' field" }, 400);
+  const result = await assistant.run(input);
+  return c.json({ content: result.content, steps: result.steps });
+}
+`
+    );
+  }
+  if (template === "rag-app") {
+    const embedModel = "openai:text-embedding-3-small";
+    fs.mkdirSync(path.join(targetDir, "src", "routes", "api", "rag"), { recursive: true });
+    fs.writeFileSync(
+      path.join(targetDir, "src", "routes", "api", "rag", "query.ts"),
+      `// POST /api/rag/query \u2014 Query documents with RAG
+import type { Context } from "@voltx/server";
+import { streamText } from "@voltx/ai";
+import { createRAGPipeline, createEmbedder } from "@voltx/rag";
+import { createVectorStore } from "@voltx/db";
+
+const vectorStore = createVectorStore(); // swap to "pinecone" or "pgvector" for production
+const embedder = createEmbedder({ model: "${embedModel}" });
+const rag = createRAGPipeline({ embedder, vectorStore });
+
+export async function POST(c: Context) {
+  const { question } = await c.req.json();
+
+  const context = await rag.getContext(question, { topK: 5 });
+
+  const result = await streamText({
+    model: "${provider}:${model}",
+    system: \`Answer the user's question based on the following context. If the context doesn't contain relevant information, say so.\\n\\nContext:\\n\${context}\`,
+    messages: [{ role: "user", content: question }],
+  });
+
+  return result.toSSEResponse();
+}
+`
+    );
+    fs.writeFileSync(
+      path.join(targetDir, "src", "routes", "api", "rag", "ingest.ts"),
+      `// POST /api/rag/ingest \u2014 Ingest documents into the vector store
+import type { Context } from "@voltx/server";
+import { createRAGPipeline, createEmbedder } from "@voltx/rag";
+import { createVectorStore } from "@voltx/db";
+
+const vectorStore = createVectorStore();
+const embedder = createEmbedder({ model: "${embedModel}" });
+const rag = createRAGPipeline({ embedder, vectorStore });
+
+export async function POST(c: Context) {
+  const { text, idPrefix } = await c.req.json();
+
+  if (!text || typeof text !== "string") {
+    return c.json({ error: "Missing 'text' field" }, 400);
+  }
+
+  const result = await rag.ingest(text, idPrefix ?? "doc");
+  return c.json({ status: "ok", chunks: result.chunks, ids: result.ids });
+}
+`
+    );
+  }
+  if (auth === "better-auth") {
+    fs.mkdirSync(path.join(targetDir, "src", "routes", "api", "auth"), { recursive: true });
+    fs.writeFileSync(
+      path.join(targetDir, "src", "routes", "api", "auth", "[...path].ts"),
+      `// ALL /api/auth/* \u2014 Better Auth handler
+import type { Context } from "@voltx/server";
+import { auth } from "../../../lib/auth";
+import { createAuthHandler } from "@voltx/auth";
+
+const handler = createAuthHandler(auth);
+
+export const GET = (c: Context) => handler(c);
+export const POST = (c: Context) => handler(c);
+`
+    );
+    fs.mkdirSync(path.join(targetDir, "src", "lib"), { recursive: true });
+    fs.writeFileSync(
+      path.join(targetDir, "src", "lib", "auth.ts"),
+      `// Auth configuration \u2014 Better Auth with DB-backed sessions
+import { createAuth, createAuthMiddleware } from "@voltx/auth";
+
+export const auth = createAuth("better-auth", {
+  database: process.env.DATABASE_URL!,
+  emailAndPassword: true,
+});
+
+export const authMiddleware = createAuthMiddleware({
+  provider: auth,
+  publicPaths: ["/api/auth", "/api/health", "/"],
+});
+`
+    );
+  } else if (auth === "jwt") {
+    fs.mkdirSync(path.join(targetDir, "src", "lib"), { recursive: true });
+    fs.writeFileSync(
+      path.join(targetDir, "src", "lib", "auth.ts"),
+      `// Auth configuration \u2014 JWT (stateless)
+import { createAuth, createAuthMiddleware } from "@voltx/auth";
+
+export const jwt = createAuth("jwt", {
+  secret: process.env.JWT_SECRET!,
+  expiresIn: "7d",
+});
+
+export const authMiddleware = createAuthMiddleware({
+  provider: jwt,
+  publicPaths: ["/api/auth", "/api/health", "/"],
+});
+`
+    );
+    fs.writeFileSync(
+      path.join(targetDir, "src", "routes", "api", "auth.ts"),
+      `// POST /api/auth/login \u2014 Example JWT login route
+import type { Context } from "@voltx/server";
+import { jwt } from "../../lib/auth";
+
+export async function POST(c: Context) {
+  const { email, password } = await c.req.json();
+
+  if (!email || !password) {
+    return c.json({ error: "Email and password are required" }, 400);
+  }
+
+  const token = await jwt.sign({ sub: email, email });
+  return c.json({ token });
+}
+`
+    );
+  }
+  let envContent = "";
+  if (template === "rag-app") {
+    envContent += "# \u2500\u2500\u2500 LLM Provider \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nOPENAI_API_KEY=sk-...\n\n";
+    envContent += "# \u2500\u2500\u2500 Database (Neon Postgres) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nDATABASE_URL=postgresql://user:pass@ep-xxx.us-east-2.aws.neon.tech/dbname?sslmode=require\n\n";
+    envContent += "# \u2500\u2500\u2500 Vector Database (Pinecone) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nPINECONE_API_KEY=pc-...\nPINECONE_INDEX=voltx-embeddings\n\n";
+  } else if (template === "chatbot" || template === "agent-app") {
+    envContent += "# \u2500\u2500\u2500 LLM Provider \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nCEREBRAS_API_KEY=csk-...\n\n";
+    if (template === "agent-app") {
+      envContent += "# \u2500\u2500\u2500 Database (Neon Postgres \u2014 optional) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nDATABASE_URL=\n\n";
+    }
+  } else {
+    envContent += "# \u2500\u2500\u2500 LLM Provider (add your key) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n# OPENAI_API_KEY=sk-...\n# CEREBRAS_API_KEY=csk-...\n\n";
+  }
+  if (auth === "better-auth") {
+    envContent += "# \u2500\u2500\u2500 Auth (Better Auth) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nBETTER_AUTH_SECRET=your-secret-key-min-32-chars-here\nBETTER_AUTH_URL=http://localhost:3000\n";
+    if (template !== "rag-app" && template !== "agent-app") {
+      envContent += "DATABASE_URL=postgresql://user:pass@ep-xxx.us-east-2.aws.neon.tech/dbname?sslmode=require\n";
+    }
+    envContent += "# GITHUB_CLIENT_ID=\n# GITHUB_CLIENT_SECRET=\n\n";
+  } else if (auth === "jwt") {
+    envContent += "# \u2500\u2500\u2500 Auth (JWT) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nJWT_SECRET=your-jwt-secret-key\n\n";
+  }
+  envContent += "# \u2500\u2500\u2500 App \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nPORT=3000\nNODE_ENV=development\n";
+  fs.writeFileSync(path.join(targetDir, ".env.example"), envContent);
+  fs.writeFileSync(
+    path.join(targetDir, ".gitignore"),
+    "node_modules\ndist\n.env\n"
+  );
+  fs.writeFileSync(
+    path.join(targetDir, "tsconfig.json"),
+    JSON.stringify(
+      {
+        compilerOptions: {
+          target: "ES2022",
+          module: "ESNext",
+          moduleResolution: "bundler",
+          strict: true,
+          esModuleInterop: true,
+          skipLibCheck: true,
+          outDir: "dist",
+          rootDir: "src"
+        },
+        include: ["src"]
+      },
+      null,
+      2
+    )
+  );
+  printWelcomeBanner(name);
+}
+var isDirectRun = typeof __require !== "undefined" && __require.main === module && process.argv[1]?.includes("create");
+if (isDirectRun) {
+  const projectName = process.argv[2];
+  if (!projectName) {
+    console.log("Usage: create-voltx-app <project-name> [--template chatbot] [--auth jwt]");
+    process.exit(1);
+  }
+  const templateFlag = process.argv.indexOf("--template");
+  const template = templateFlag !== -1 ? process.argv[templateFlag + 1] : "blank";
+  const authFlag = process.argv.indexOf("--auth");
+  const auth = authFlag !== -1 ? process.argv[authFlag + 1] : "none";
+  createProject({ name: projectName, template, auth }).catch((err) => {
+    console.error("[voltx] Error:", err);
+    process.exit(1);
+  });
+}
+
+export {
+  createProject
+};

package/dist/chunk-L3247M3A.mjs

@@ -0,0 +1,81 @@
+// src/start.ts
+import { spawn } from "child_process";
+import { resolve, join } from "path";
+import { existsSync } from "fs";
+async function runStart(options = {}) {
+  const cwd = process.cwd();
+  const { port, outDir = "dist" } = options;
+  const distDir = resolve(cwd, outDir);
+  if (!existsSync(distDir)) {
+    console.error(`[voltx] Build output not found at ${outDir}/`);
+    console.error("[voltx] Run `voltx build` first to create a production build.");
+    process.exit(1);
+  }
+  const entry = options.entry ?? findDistEntry(distDir);
+  if (!entry) {
+    console.error(`[voltx] No entry file found in ${outDir}/`);
+    console.error("[voltx] Expected index.js, index.mjs, or main.js");
+    process.exit(1);
+  }
+  const entryPath = resolve(distDir, entry);
+  if (!existsSync(entryPath)) {
+    console.error(`[voltx] Entry file not found: ${outDir}/${entry}`);
+    process.exit(1);
+  }
+  const env = {
+    ...process.env,
+    NODE_ENV: "production"
+  };
+  if (port) {
+    env.PORT = String(port);
+  }
+  console.log("");
+  console.log("  \u26A1 VoltX Production Server");
+  console.log("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+  console.log(`  Entry:   ${outDir}/${entry}`);
+  if (port) {
+    console.log(`  Port:    ${port}`);
+  }
+  console.log(`  Mode:    production`);
+  console.log("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+  console.log("");
+  const child = spawn("node", [entryPath], {
+    cwd,
+    env,
+    stdio: "inherit"
+  });
+  const signals = ["SIGINT", "SIGTERM"];
+  for (const signal of signals) {
+    process.on(signal, () => {
+      child.kill(signal);
+    });
+  }
+  child.on("error", (err) => {
+    console.error("[voltx] Failed to start production server:", err.message);
+    process.exit(1);
+  });
+  child.on("exit", (code) => {
+    process.exit(code ?? 0);
+  });
+}
+function findDistEntry(distDir) {
+  const candidates = [
+    "index.mjs",
+    "index.js",
+    "index.cjs",
+    "main.mjs",
+    "main.js",
+    "src/index.mjs",
+    "src/index.js"
+  ];
+  for (const candidate of candidates) {
+    if (existsSync(join(distDir, candidate))) {
+      return candidate;
+    }
+  }
+  return null;
+}
+
+export {
+  runStart
+};