create-projx 1.4.1 → 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

@@ -251,6 +251,35 @@ async function discoverComponentPaths(cwd, components) {
   }
   return paths;
 }
+async function discoverComponentsFromMarkers(cwd) {
+  const components = [];
+  const paths = {};
+  const entries = await readdir(cwd, { withFileTypes: true });
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    if (EXCLUDE.has(entry.name)) continue;
+    if (entry.name.startsWith(".")) continue;
+    const full = join(cwd, entry.name);
+    const marker = join(full, COMPONENT_MARKER);
+    if (existsSync(marker)) {
+      try {
+        const data = JSON.parse(await readFile(marker, "utf-8"));
+        const markerComponents = data.components ?? (data.component ? [data.component] : []);
+        for (const mc of markerComponents) {
+          if (COMPONENTS.includes(mc) && !components.includes(mc)) {
+            components.push(mc);
+            paths[mc] = entry.name;
+          }
+        }
+      } catch {
+      }
+    }
+  }
+  for (const c of components) {
+    if (!paths[c]) paths[c] = c;
+  }
+  return { components, paths };
+}
 function render(template, vars) {
   const components = vars.components;
   const projectName = vars.projectName;
@@ -925,17 +954,19 @@ async function update(cwd, localRepo) {
   const configPath = join5(cwd, ".projx");
   let config;
   if (existsSync4(configPath)) {
-    config = JSON.parse(await readFile5(configPath, "utf-8"));
+    const raw = JSON.parse(await readFile5(configPath, "utf-8"));
+    const { components: discovered } = await discoverComponentsFromMarkers(cwd);
+    config = { ...raw, components: discovered.length > 0 ? discovered : raw.components };
     p3.log.info(`Found .projx (v${config.version}, components: ${config.components.join(", ")})`);
   } else {
     p3.log.warn("No .projx file found. Detecting components from directories.");
-    const detected = COMPONENTS.filter((c) => existsSync4(join5(cwd, c)));
-    if (detected.length === 0) {
+    const { components: discovered } = await discoverComponentsFromMarkers(cwd);
+    if (discovered.length === 0) {
       p3.log.error("No projx components found. Run 'projx init' first.");
       process.exit(1);
     }
-    config = { version: "0.0.0", components: detected, createdAt: "unknown" };
-    p3.log.info(`Detected: ${detected.join(", ")}`);
+    config = { version: "0.0.0", components: discovered, createdAt: "unknown" };
+    p3.log.info(`Detected: ${discovered.join(", ")}`);
   }
   const componentPaths = await discoverComponentPaths(cwd, config.components);
   for (const c of config.components) {
@@ -1493,7 +1524,7 @@ async function pin(cwd, patterns) {
     process.exit(1);
   }
   const config = JSON.parse(await readFile8(configPath, "utf-8"));
-  const componentPaths = await discoverComponentPaths(cwd, config.components);
+  const componentPaths = (await discoverComponentsFromMarkers(cwd)).paths;
   const rootAdds = [];
   const componentAdds = {};
   for (const pattern of patterns) {
@@ -1550,7 +1581,7 @@ async function unpin(cwd, patterns) {
     process.exit(1);
   }
   const config = JSON.parse(await readFile8(configPath, "utf-8"));
-  const componentPaths = await discoverComponentPaths(cwd, config.components);
+  const componentPaths = (await discoverComponentsFromMarkers(cwd)).paths;
   const rootRemoves = [];
   const componentRemoves = {};
   for (const pattern of patterns) {
@@ -1611,7 +1642,7 @@ async function listPins(cwd) {
     process.exit(1);
   }
   const config = JSON.parse(await readFile8(configPath, "utf-8"));
-  const componentPaths = await discoverComponentPaths(cwd, config.components);
+  const { components: discovered, paths: componentPaths } = await discoverComponentsFromMarkers(cwd);
   let hasAny = false;
   if (config.skip && config.skip.length > 0) {
     hasAny = true;
@@ -1620,7 +1651,7 @@ async function listPins(cwd) {
       p6.log.info(`  ${s}`);
     }
   }
-  for (const component of config.components) {
+  for (const component of discovered) {
     const dir = componentPaths[component];
     const marker = await readComponentMarker(join9(cwd, dir));
     if (marker?.skip && marker.skip.length > 0) {
@@ -1877,10 +1908,11 @@ async function doctor(cwd, fix = false) {
     printReport(allResults);
     process.exit(1);
   }
-  const componentPaths = await discoverComponentPaths(cwd, config.components);
-  allResults.push(...await checkComponents(cwd, config, componentPaths));
+  const { components: discovered, paths: componentPaths } = await discoverComponentsFromMarkers(cwd);
+  const resolvedConfig = { ...config, components: discovered.length > 0 ? discovered : config.components };
+  allResults.push(...await checkComponents(cwd, resolvedConfig, componentPaths));
   allResults.push(...checkGit(cwd, fix));
-  allResults.push(...await checkSkipPatterns(cwd, config, componentPaths));
+  allResults.push(...await checkSkipPatterns(cwd, resolvedConfig, componentPaths));
   printReport(allResults);
   const passed = allResults.filter((r) => r.status === "pass").length;
   const warns = allResults.filter((r) => r.status === "warn").length;
@@ -1935,8 +1967,9 @@ async function diff(cwd, localRepo) {
     p8.log.error("No .projx file found. Run 'npx create-projx init' first.");
     process.exit(1);
   }
-  const config = JSON.parse(await readFile10(configPath, "utf-8"));
-  const componentPaths = await discoverComponentPaths(cwd, config.components);
+  const raw = JSON.parse(await readFile10(configPath, "utf-8"));
+  const { components: discovered, paths: componentPaths } = await discoverComponentsFromMarkers(cwd);
+  const config = { ...raw, components: discovered.length > 0 ? discovered : raw.components };
   const componentSkips = {};
   for (const component of config.components) {
     const dir = componentPaths[component];
@@ -2589,23 +2622,58 @@ 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)) {
     p9.log.error("No .projx file found. Run 'npx create-projx init' first.");
     process.exit(1);
   }
-  const projxConfig = JSON.parse(await readFile11(configPath, "utf-8"));
-  const componentPaths = await discoverComponentPaths(cwd, projxConfig.components);
-  const hasFastapi = projxConfig.components.includes("fastapi");
-  const hasFastify = projxConfig.components.includes("fastify");
-  const hasFrontend = projxConfig.components.includes("frontend");
-  const hasMobile = projxConfig.components.includes("mobile");
+  const { components: discovered, paths: componentPaths } = await discoverComponentsFromMarkers(cwd);
+  const hasFastapi = discovered.includes("fastapi");
+  const hasFastify = discovered.includes("fastify");
+  const hasFrontend = discovered.includes("frontend");
+  const hasMobile = discovered.includes("mobile");
   if (!hasFastapi && !hasFastify) {
     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);
@@ -2626,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)) {
@@ -2637,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)) {
@@ -2722,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)}`);
@@ -2749,7 +2817,7 @@ async function gen(cwd, entityName, fieldsFlag) {
 
 // src/sync.ts
 import { existsSync as existsSync12, readFileSync as readFileSync2 } from "fs";
-import { readFile as readFile12, writeFile as writeFile6, mkdir as mkdir6 } from "fs/promises";
+import { writeFile as writeFile6, mkdir as mkdir6 } from "fs/promises";
 import { join as join13 } from "path";
 import * as p10 from "@clack/prompts";
 function toPascal2(s) {
@@ -2926,15 +2994,9 @@ async function sync(cwd, url) {
     p10.log.error("No .projx file found. Run 'npx create-projx init' first.");
     process.exit(1);
   }
-  const projxConfig = JSON.parse(
-    await readFile12(configPath, "utf-8")
-  );
-  const componentPaths = await discoverComponentPaths(
-    cwd,
-    projxConfig.components
-  );
-  const hasFrontend = projxConfig.components.includes("frontend");
-  const hasMobile = projxConfig.components.includes("mobile");
+  const { components: discovered, paths: componentPaths } = await discoverComponentsFromMarkers(cwd);
+  const hasFrontend = discovered.includes("frontend");
+  const hasMobile = discovered.includes("mobile");
   if (!hasFrontend && !hasMobile) {
     p10.log.error("No frontend or mobile component found. Nothing to sync.");
     process.exit(1);
@@ -3120,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}`);
@@ -3240,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.1",
+  "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": {