create-projx 1.4.2 → 1.4.3

package/README.md

@@ -2,6 +2,7 @@
 
 [![npm version](https://img.shields.io/npm/v/create-projx)](https://www.npmjs.com/package/create-projx)
 [![CI](https://github.com/ukanhaupa/projx/actions/workflows/ci.yml/badge.svg)](https://github.com/ukanhaupa/projx/actions/workflows/ci.yml)
+[![GitHub stars](https://img.shields.io/github/stars/ukanhaupa/projx)](https://github.com/ukanhaupa/projx)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
 Production-grade project scaffolder. Pick your stack, get a fully wired project with auth, database, CI/CD, and E2E tests — ready to deploy.
@@ -111,7 +112,7 @@ To skip root-level files (docker-compose, README), add `skip` to `.projx`:
 
 ```json
 {
-  "version": "1.3.6",
+  "version": "1.4.2",
   "components": ["fastapi", "frontend"],
   "skip": ["docker-compose.yml", "README.md"]
 }
@@ -131,10 +132,12 @@ npx create-projx pin <patterns...>
 npx create-projx unpin <patterns...>
 npx create-projx pin --list
 npx create-projx doctor [--fix]
-npx create-projx gen entity <name>
+npx create-projx gen entity <name> [--ai | --backend]
 npx create-projx sync [--url <url>]
 
 --components <list>    Comma-separated: fastapi,fastify,frontend,mobile,e2e,infra
+--ai                   Target fastapi (AI/ML) for gen entity
+--backend              Target fastify (API backend) for gen entity
 --no-git               Skip git init
 --no-install           Skip dependency installation
 -y, --yes              Accept defaults (fastify + frontend + e2e)
@@ -178,19 +181,26 @@ Checks: config validity, component markers, baseline ref, stale worktrees, skip
 
 ### Generate Entities
 
-Scaffold a new entity across all components in your project:
+Scaffold a new entity in your primary backend + typed models for frontend/mobile:
 
 ```bash
 npx create-projx gen entity invoice                                          # interactive
 npx create-projx gen entity invoice --fields "name:string,amount:number"     # non-interactive
+npx create-projx gen entity embedding --ai --fields "name:string,vector:json"  # target AI backend
 ```
 
-Generates based on what's in your `.projx`:
+When both `fastapi` and `fastify` exist, the entity generates in the **primary backend** only (not both). First run prompts you to choose and saves to `.projx`:
+
+```json
+{ "primaryBackend": "fastify" }
+```
+
+Override with `--ai` (fastapi) or `--backend` (fastify).
 
 | Component | Generated |
 | --------- | --------- |
-| `fastapi` | `src/entities/<name>/_model.py` — auto-discovered by registry |
-| `fastify` | `src/modules/<name>/schemas.ts` + `index.ts` + Prisma model + app.ts import |
+| Primary backend (fastapi) | `src/entities/<name>/_model.py` — auto-discovered by registry |
+| Primary backend (fastify) | `src/modules/<name>/schemas.ts` + `index.ts` + Prisma model + app.ts import |
 | `frontend` | `src/types/<name>.ts` — TypeScript interface + Create/Update variants |
 | `mobile` | `lib/entities/<name>/model.dart` — Dart class with fromJson/toJson/copyWith |
 

package/dist/index.js

@@ -2622,7 +2622,40 @@ function generateDartModel(config) {
   lines.push("");
   return lines.join("\n");
 }
-async function gen(cwd, entityName, fieldsFlag) {
+async function resolvePrimaryBackend(cwd, hasFastapi, hasFastify, backendFlag) {
+  if (backendFlag) return backendFlag;
+  if (hasFastapi && !hasFastify) return "fastapi";
+  if (hasFastify && !hasFastapi) return "fastify";
+  const configPath = join12(cwd, ".projx");
+  if (existsSync11(configPath)) {
+    try {
+      const data = JSON.parse(await readFile11(configPath, "utf-8"));
+      if (data.primaryBackend === "fastapi" || data.primaryBackend === "fastify") {
+        return data.primaryBackend;
+      }
+    } catch {
+    }
+  }
+  if (!process.stdin.isTTY) return "fastify";
+  const choice = await p9.select({
+    message: "Both backends detected. Which is your primary?",
+    options: [
+      { value: "fastify", label: "fastify (API backend)" },
+      { value: "fastapi", label: "fastapi (AI/ML engine)" }
+    ],
+    initialValue: "fastify"
+  });
+  if (p9.isCancel(choice)) process.exit(0);
+  try {
+    const data = JSON.parse(await readFile11(configPath, "utf-8"));
+    data.primaryBackend = choice;
+    await writeFile5(configPath, JSON.stringify(data, null, 2) + "\n");
+    p9.log.success(`Saved primaryBackend: ${choice} to .projx`);
+  } catch {
+  }
+  return choice;
+}
+async function gen(cwd, entityName, fieldsFlag, backendFlag) {
   p9.intro(`projx gen entity ${entityName}`);
   const configPath = join12(cwd, ".projx");
   if (!existsSync11(configPath)) {
@@ -2638,6 +2671,9 @@ async function gen(cwd, entityName, fieldsFlag) {
     p9.log.error("No backend component found. Need fastapi or fastify.");
     process.exit(1);
   }
+  const targetBackend = await resolvePrimaryBackend(cwd, hasFastapi, hasFastify, backendFlag);
+  const genFastapi = targetBackend === "fastapi" && hasFastapi;
+  const genFastify = targetBackend === "fastify" && hasFastify;
   let config;
   if (fieldsFlag) {
     const fields = parseFieldsFlag(fieldsFlag);
@@ -2658,7 +2694,7 @@ async function gen(cwd, entityName, fieldsFlag) {
     config = await promptEntityConfig(entityName);
   }
   const generated = [];
-  if (hasFastapi) {
+  if (genFastapi) {
     const dir = componentPaths.fastapi;
     const entityDir = join12(cwd, dir, "src/entities", toSnake(config.name));
     if (existsSync11(entityDir)) {
@@ -2669,7 +2705,7 @@ async function gen(cwd, entityName, fieldsFlag) {
       generated.push(`${dir}/src/entities/${toSnake(config.name)}/_model.py`);
     }
   }
-  if (hasFastify) {
+  if (genFastify) {
     const dir = componentPaths.fastify;
     const moduleDir = join12(cwd, dir, "src/modules", toKebab(config.name));
     if (existsSync11(moduleDir)) {
@@ -2754,13 +2790,13 @@ async function gen(cwd, entityName, fieldsFlag) {
     p9.log.info(`  ${f}`);
   }
   const className = toPascal(config.name);
-  if (hasFastapi) {
+  if (genFastapi) {
     p9.log.info("");
     p9.log.info("FastAPI next steps:");
     p9.log.info(`  alembic revision --autogenerate -m "add ${config.tableName}"`);
     p9.log.info("  alembic upgrade head");
   }
-  if (hasFastify) {
+  if (genFastify) {
     p9.log.info("");
     p9.log.info("Fastify next steps:");
     p9.log.info(`  npx prisma migrate dev --name add_${toSnake(config.name)}`);
@@ -3146,6 +3182,14 @@ function parseArgs() {
       flags.fix = true;
       continue;
     }
+    if (arg === "--ai") {
+      flags.ai = true;
+      continue;
+    }
+    if (arg === "--backend") {
+      flags.backend = true;
+      continue;
+    }
     if (arg === "--url") {
       const val = args[++i];
       if (val) extraArgs.push(`--url=${val}`);
@@ -3266,7 +3310,8 @@ async function main() {
     const entityName = extraArgs[1];
     const fieldsArg = extraArgs.find((a) => a.startsWith("--fields="));
     const fieldsFlag = fieldsArg ? fieldsArg.split("=").slice(1).join("=") : void 0;
-    await gen(process.cwd(), entityName, fieldsFlag);
+    const backendFlag = flags.ai ? "fastapi" : flags.backend ? "fastify" : void 0;
+    await gen(process.cwd(), entityName, fieldsFlag, backendFlag);
     return;
   }
   let opts;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-projx",
-  "version": "1.4.2",
+  "version": "1.4.3",
   "description": "Scaffold production-grade fullstack projects in seconds. FastAPI, Fastify, React, Flutter, Terraform — with auth, database, CI/CD, E2E tests, and Docker. One command, ready to deploy.",
   "type": "module",
   "bin": {