create-forgeon 0.1.37 → 0.2.0

package/README.md

@@ -10,9 +10,10 @@ CLI package for generating Forgeon fullstack monorepo projects.
 
 ## Usage
 
-```bash
-npx create-forgeon@latest my-app --i18n true --proxy caddy
-```
+```bash
+npx create-forgeon@latest my-app --i18n true --db-prisma true --proxy caddy
+npx create-forgeon@latest my-app --db-prisma false --proxy caddy
+```
 
 If flags are omitted, the CLI asks interactive questions.
 Project name stays text input; fixed-choice prompts use arrow-key selection (`Up/Down + Enter`).
@@ -22,11 +23,18 @@ npx create-forgeon@latest add --list
 npx create-forgeon@latest add i18n --project ./my-app
 npx create-forgeon@latest add jwt-auth --project ./my-app
 ```
+
+```bash
+cd my-app
+pnpm forgeon:sync-integrations
+```
 
 ## Notes
 
-- Canonical stack is fixed: NestJS + React + Prisma/Postgres + Docker.
+- Canonical runtime stack is fixed: NestJS + React + Docker.
+- DB is module-driven: `db-prisma` is default-on and can be disabled at scaffold time.
 - Reverse proxy options: `caddy` (default), `nginx`, `none`.
 - `add i18n` is implemented and applies backend/frontend i18n wiring.
 - `add jwt-auth` is implemented and auto-detects DB adapter support for refresh-token persistence.
+- Integration sync is bundled by default and runs after `add` commands (best-effort).
 - Planned modules write docs notes under `docs/AI/MODULES/`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-forgeon",
-  "version": "0.1.37",
+  "version": "0.2.0",
   "description": "Forgeon project generator CLI",
   "license": "MIT",
   "author": "Forgeon",

package/src/cli/help.mjs

@@ -6,8 +6,9 @@ Usage:
   npx create-forgeon@latest add <module-id> [options]
   npx create-forgeon@latest add --list
 
-Create options:
-  --i18n <true|false>          Enable i18n (default: true)
+Create options:
+  --db-prisma <true|false>     Enable db-prisma module (default: true)
+  --i18n <true|false>          Enable i18n (default: true)
   --proxy <caddy|nginx|none>   Reverse proxy preset (default: caddy)
   --install                    Run pnpm install after generation
   -y, --yes                    Skip prompts and use defaults

package/src/cli/options.mjs

@@ -1,121 +1,142 @@
-import readline from 'node:readline/promises';
-import { stdin as input, stdout as output } from 'node:process';
-import { DEFAULT_OPTIONS, DEFAULT_PROXY } from '../constants.mjs';
-import { promptSelect } from './prompt-select.mjs';
-
-const REMOVED_FLAGS = new Set(['frontend', 'db', 'docker']);
-
-export function parseCliArgs(argv) {
-  const args = [...argv];
-  const options = { ...DEFAULT_OPTIONS };
-  const positional = [];
-
-  for (let i = 0; i < args.length; i += 1) {
-    const arg = args[i];
-
-    if (arg === '--') continue;
-
-    if (arg === '-h' || arg === '--help') {
-      options.help = true;
-      continue;
-    }
-
-    if (arg === '-y' || arg === '--yes') {
-      options.yes = true;
-      continue;
-    }
-
-    if (arg === '--install') {
-      options.install = true;
-      continue;
-    }
-
-    if (arg.startsWith('--no-')) {
-      const key = arg.slice(5);
-      if (REMOVED_FLAGS.has(key)) {
-        throw new Error(`Option "--${key}" has been removed. Forgeon now uses a fixed stack.`);
-      }
-      if (key === 'install') options.install = false;
-      if (key === 'i18n') options.i18n = false;
-      continue;
-    }
-
-    if (arg.startsWith('--')) {
-      const [keyRaw, inlineValue] = arg.split('=');
-      const key = keyRaw.slice(2);
-      if (REMOVED_FLAGS.has(key)) {
-        throw new Error(`Option "--${key}" has been removed. Forgeon now uses a fixed stack.`);
-      }
-
-      let value = inlineValue;
-      if (value === undefined && args[i + 1] && !args[i + 1].startsWith('-')) {
-        value = args[i + 1];
-        i += 1;
-      }
-
-      if (Object.prototype.hasOwnProperty.call(options, key)) {
-        options[key] = value;
-      }
-
-      continue;
-    }
-
-    positional.push(arg);
-  }
-
-  return { options, positional };
-}
-
-export async function promptForMissingOptions(options) {
-  const nextOptions = { ...options };
-
-  if (!nextOptions.name) {
-    if (!input.isTTY) {
-      throw new Error('Project name is required in non-interactive mode. Pass it as first argument.');
-    }
-
-    const rl = readline.createInterface({ input, output });
-    try {
-      nextOptions.name = await rl.question('Project name: ');
-    } finally {
-      await rl.close();
-    }
-  }
-
-  if (!nextOptions.yes && nextOptions.i18n === undefined) {
-    nextOptions.i18n = await promptSelect({
-      message: 'Enable i18n:',
-      defaultValue: 'true',
-      choices: [
-        { label: 'true', value: 'true' },
-        { label: 'false', value: 'false' },
-      ],
-    });
-  }
-
-  if (!nextOptions.yes && !nextOptions.proxy) {
-    nextOptions.proxy = await promptSelect({
-      message: 'Reverse proxy preset:',
-      defaultValue: DEFAULT_PROXY,
-      choices: [
-        { label: 'caddy', value: 'caddy' },
-        { label: 'nginx', value: 'nginx' },
-        { label: 'none', value: 'none' },
-      ],
-    });
-  }
-
-  if (nextOptions.yes) {
-    if (nextOptions.i18n === undefined) nextOptions.i18n = 'true';
-    if (!nextOptions.proxy) nextOptions.proxy = DEFAULT_PROXY;
-  }
-
-  if (nextOptions.i18n === undefined) {
-    nextOptions.i18n = 'true';
-  }
-  if (!nextOptions.proxy) {
-    nextOptions.proxy = DEFAULT_PROXY;
-  }
-
-  return nextOptions;
-}
+import readline from 'node:readline/promises';
+import { stdin as input, stdout as output } from 'node:process';
+import { DEFAULT_DB_PRISMA_ENABLED, DEFAULT_OPTIONS, DEFAULT_PROXY } from '../constants.mjs';
+import { promptSelect } from './prompt-select.mjs';
+
+const REMOVED_FLAGS = new Set(['frontend', 'db', 'docker']);
+
+export function parseCliArgs(argv) {
+  const args = [...argv];
+  const options = { ...DEFAULT_OPTIONS };
+  const positional = [];
+
+  for (let i = 0; i < args.length; i += 1) {
+    const arg = args[i];
+
+    if (arg === '--') continue;
+
+    if (arg === '-h' || arg === '--help') {
+      options.help = true;
+      continue;
+    }
+
+    if (arg === '-y' || arg === '--yes') {
+      options.yes = true;
+      continue;
+    }
+
+    if (arg === '--install') {
+      options.install = true;
+      continue;
+    }
+
+    if (arg.startsWith('--no-')) {
+      const key = arg.slice(5);
+      if (REMOVED_FLAGS.has(key)) {
+        throw new Error(`Option "--${key}" has been removed. Forgeon now uses a fixed stack.`);
+      }
+      if (key === 'install') options.install = false;
+      if (key === 'i18n') options.i18n = false;
+      if (key === 'db-prisma') options.dbPrisma = false;
+      continue;
+    }
+
+    if (arg.startsWith('--')) {
+      const [keyRaw, inlineValue] = arg.split('=');
+      const key = keyRaw.slice(2);
+      if (REMOVED_FLAGS.has(key)) {
+        throw new Error(`Option "--${key}" has been removed. Forgeon now uses a fixed stack.`);
+      }
+
+      let value = inlineValue;
+      if (value === undefined && args[i + 1] && !args[i + 1].startsWith('-')) {
+        value = args[i + 1];
+        i += 1;
+      }
+
+      if (key === 'db-prisma') {
+        options.dbPrisma = value;
+        continue;
+      }
+
+      if (Object.prototype.hasOwnProperty.call(options, key)) {
+        options[key] = value;
+      }
+
+      continue;
+    }
+
+    positional.push(arg);
+  }
+
+  return { options, positional };
+}
+
+export async function promptForMissingOptions(options) {
+  const nextOptions = { ...options };
+
+  if (!nextOptions.name) {
+    if (!input.isTTY) {
+      throw new Error('Project name is required in non-interactive mode. Pass it as first argument.');
+    }
+
+    const rl = readline.createInterface({ input, output });
+    try {
+      nextOptions.name = await rl.question('Project name: ');
+    } finally {
+      await rl.close();
+    }
+  }
+
+  if (!nextOptions.yes && nextOptions.dbPrisma === undefined) {
+    nextOptions.dbPrisma = await promptSelect({
+      message: 'Enable db-prisma:',
+      defaultValue: DEFAULT_DB_PRISMA_ENABLED ? 'true' : 'false',
+      choices: [
+        { label: 'true', value: 'true' },
+        { label: 'false', value: 'false' },
+      ],
+    });
+  }
+
+  if (!nextOptions.yes && nextOptions.i18n === undefined) {
+    nextOptions.i18n = await promptSelect({
+      message: 'Enable i18n:',
+      defaultValue: 'true',
+      choices: [
+        { label: 'true', value: 'true' },
+        { label: 'false', value: 'false' },
+      ],
+    });
+  }
+
+  if (!nextOptions.yes && !nextOptions.proxy) {
+    nextOptions.proxy = await promptSelect({
+      message: 'Reverse proxy preset:',
+      defaultValue: DEFAULT_PROXY,
+      choices: [
+        { label: 'caddy', value: 'caddy' },
+        { label: 'nginx', value: 'nginx' },
+        { label: 'none', value: 'none' },
+      ],
+    });
+  }
+
+  if (nextOptions.yes) {
+    if (nextOptions.dbPrisma === undefined) nextOptions.dbPrisma = DEFAULT_DB_PRISMA_ENABLED ? 'true' : 'false';
+    if (nextOptions.i18n === undefined) nextOptions.i18n = 'true';
+    if (!nextOptions.proxy) nextOptions.proxy = DEFAULT_PROXY;
+  }
+
+  if (nextOptions.dbPrisma === undefined) {
+    nextOptions.dbPrisma = DEFAULT_DB_PRISMA_ENABLED ? 'true' : 'false';
+  }
+  if (nextOptions.i18n === undefined) {
+    nextOptions.i18n = 'true';
+  }
+  if (!nextOptions.proxy) {
+    nextOptions.proxy = DEFAULT_PROXY;
+  }
+
+  return nextOptions;
+}

package/src/cli/options.test.mjs

@@ -5,26 +5,29 @@ import { parseCliArgs } from './options.mjs';
 describe('parseCliArgs', () => {
   it('parses positional name and supported inline options', () => {
     const { options, positional } = parseCliArgs([
-      'demo-app',
-      '--i18n=false',
-      '--proxy=caddy',
-      '--install',
+      'demo-app',
+      '--db-prisma=false',
+      '--i18n=false',
+      '--proxy=caddy',
+      '--install',
       '--yes',
     ]);
 
     assert.equal(positional[0], 'demo-app');
-    assert.equal(options.i18n, 'false');
+    assert.equal(options.dbPrisma, 'false');
+    assert.equal(options.i18n, 'false');
     assert.equal(options.proxy, 'caddy');
     assert.equal(options.install, true);
     assert.equal(options.yes, true);
   });
 
   it('parses separated option values and negated i18n flag', () => {
-    const { options } = parseCliArgs(['--proxy', 'none', '--no-i18n', '--help']);
-
-    assert.equal(options.proxy, 'none');
-    assert.equal(options.i18n, false);
-    assert.equal(options.help, true);
+    const { options } = parseCliArgs(['--proxy', 'none', '--no-i18n', '--no-db-prisma', '--help']);
+
+    assert.equal(options.proxy, 'none');
+    assert.equal(options.i18n, false);
+    assert.equal(options.dbPrisma, false);
+    assert.equal(options.help, true);
   });
 
   it('throws for removed stack-selection flags', () => {

package/src/constants.mjs

@@ -1,12 +1,14 @@
-export const DEFAULT_FRONTEND = 'react';
-export const DEFAULT_DB = 'prisma';
-export const DEFAULT_PROXY = 'caddy';
-export const FIXED_DOCKER_ENABLED = true;
-
-export const DEFAULT_OPTIONS = {
-  name: undefined,
-  i18n: undefined,
-  proxy: undefined,
+export const DEFAULT_FRONTEND = 'react';
+export const DEFAULT_DB = 'prisma';
+export const DEFAULT_DB_PRISMA_ENABLED = true;
+export const DEFAULT_PROXY = 'caddy';
+export const FIXED_DOCKER_ENABLED = true;
+
+export const DEFAULT_OPTIONS = {
+  name: undefined,
+  dbPrisma: undefined,
+  i18n: undefined,
+  proxy: undefined,
   install: false,
   yes: false,
   help: false,

package/src/core/docs.mjs

@@ -40,20 +40,26 @@ function writeDocFromFragments({
   fs.writeFileSync(absoluteOutputPath, content, 'utf8');
 }
 
-export function generateDocs(targetRoot, options, packageRoot) {
-  const fragmentsRoot = path.resolve(packageRoot, 'templates', 'docs-fragments');
-  const variables = {
-    FRONTEND_LABEL: getFrontendLabel(options.frontend),
-    DB_LABEL: getDatabaseLabel(options.db),
-    I18N_STATUS: options.i18nEnabled ? 'enabled' : 'disabled',
-    DOCKER_STATUS: 'enabled',
-    PROXY_LABEL: options.proxy,
-    PROXY_CONFIG_PATH: getProxyConfigPath(options.proxy),
-  };
-
-  const readmeFragments = ['00_title', '10_stack', '20_quick_start_dev_intro'];
-  readmeFragments.push('21_quick_start_dev_db_docker');
-  readmeFragments.push('22_quick_start_dev_outro');
+export function generateDocs(targetRoot, options, packageRoot) {
+  const fragmentsRoot = path.resolve(packageRoot, 'templates', 'docs-fragments');
+  const dbLabel = options.dbPrismaEnabled ? getDatabaseLabel(options.db) : 'none (add db-prisma later)';
+  const variables = {
+    FRONTEND_LABEL: getFrontendLabel(options.frontend),
+    DB_LABEL: dbLabel,
+    I18N_STATUS: options.i18nEnabled ? 'enabled' : 'disabled',
+    DB_PRISMA_STATUS: options.dbPrismaEnabled ? 'enabled' : 'disabled',
+    DOCKER_STATUS: 'enabled',
+    PROXY_LABEL: options.proxy,
+    PROXY_CONFIG_PATH: getProxyConfigPath(options.proxy),
+  };
+
+  const readmeFragments = ['00_title', '10_stack', '20_quick_start_dev_intro'];
+  if (options.dbPrismaEnabled) {
+    readmeFragments.push('21_quick_start_dev_db_docker');
+  } else {
+    readmeFragments.push('21_quick_start_dev_no_db');
+  }
+  readmeFragments.push('22_quick_start_dev_outro');
   readmeFragments.push(
     options.proxy === 'none' ? '30_quick_start_docker_none' : '30_quick_start_docker',
   );
@@ -64,16 +70,23 @@ export function generateDocs(targetRoot, options, packageRoot) {
   } else {
     readmeFragments.push('31_proxy_preset_none');
   }
-  readmeFragments.push('32_prisma_container_start');
+  if (options.dbPrismaEnabled) {
+    readmeFragments.push('32_prisma_container_start');
+  }
   if (options.i18nEnabled) {
     readmeFragments.push('40_i18n');
   }
   readmeFragments.push('41_error_handling');
   readmeFragments.push('90_next_steps');
 
-  const aiProjectFragments = ['00_title', '10_what_is', '20_structure_base'];
-  if (options.i18nEnabled) {
-    aiProjectFragments.push('21_structure_i18n');
+  const aiProjectFragments = ['00_title', '10_what_is', '20_structure_base'];
+  if (options.dbPrismaEnabled) {
+    aiProjectFragments.push('20b_structure_db_prisma');
+  } else {
+    aiProjectFragments.push('20b_structure_db_none');
+  }
+  if (options.i18nEnabled) {
+    aiProjectFragments.push('21_structure_i18n');
   }
   aiProjectFragments.push('22_structure_docker', '23_structure_docs', '30_run_dev', '31_run_docker');
   if (options.proxy === 'none') {
@@ -90,17 +103,25 @@ export function generateDocs(targetRoot, options, packageRoot) {
     aiProjectFragments.push('41_change_boundaries_docker');
   }
 
-  const aiArchitectureFragments = ['00_title', '10_layout_base', '11_layout_infra'];
-  if (options.i18nEnabled) {
-    aiArchitectureFragments.push('12_layout_i18n_resources');
-  }
+  const aiArchitectureFragments = ['00_title', '10_layout_base', '11_layout_infra'];
+  if (options.i18nEnabled) {
+    aiArchitectureFragments.push('12_layout_i18n_resources');
+  }
   aiArchitectureFragments.push('20_env_base');
+  if (options.dbPrismaEnabled) {
+    aiArchitectureFragments.push('20b_env_db_prisma');
+  }
   if (options.i18nEnabled) {
     aiArchitectureFragments.push('21_env_i18n');
   }
   aiArchitectureFragments.push('22_ts_module_policy');
   aiArchitectureFragments.push('23_error_handling');
-  aiArchitectureFragments.push('30_default_db', '31_docker_runtime', '32_scope_freeze');
+  if (options.dbPrismaEnabled) {
+    aiArchitectureFragments.push('30_default_db');
+  } else {
+    aiArchitectureFragments.push('30_default_db_none');
+  }
+  aiArchitectureFragments.push('31_docker_runtime', '32_scope_freeze');
   aiArchitectureFragments.push('40_docs_generation', '50_extension_points');
 
   writeDocFromFragments({

package/src/core/docs.test.mjs

@@ -24,12 +24,13 @@ describe('generateDocs', () => {
     try {
       generateDocs(
         targetRoot,
-        {
-          frontend: 'react',
-          db: 'prisma',
-          dockerEnabled: true,
-          i18nEnabled: false,
-          proxy: 'none',
+        {
+          frontend: 'react',
+          db: 'prisma',
+          dbPrismaEnabled: false,
+          dockerEnabled: true,
+          i18nEnabled: false,
+          proxy: 'none',
         },
         packageRoot,
       );
@@ -38,24 +39,26 @@ describe('generateDocs', () => {
       const projectDoc = readFile(path.join(targetRoot, 'docs', 'AI', 'PROJECT.md'));
       const architectureDoc = readFile(path.join(targetRoot, 'docs', 'AI', 'ARCHITECTURE.md'));
 
-      assert.match(readme, /Docker\/infra: `enabled`/);
+      assert.match(readme, /db-prisma`: `disabled`/);
+      assert.match(readme, /No DB module is enabled by default/);
       assert.match(readme, /Quick Start \(Docker\)/);
       assert.match(readme, /Proxy Preset: none/);
       assert.match(readme, /Error Handling \(`core-errors`\)/);
       assert.doesNotMatch(readme, /i18n Configuration/);
+      assert.doesNotMatch(readme, /Prisma In Container Start/);
 
       assert.match(projectDoc, /### Docker mode/);
       assert.match(projectDoc, /Active proxy preset: `none`/);
       assert.match(projectDoc, /CoreErrorsModule/);
       assert.doesNotMatch(projectDoc, /packages\/i18n/);
 
-      assert.match(architectureDoc, /infra\/\*/);
+      assert.match(architectureDoc, /generated without `db-prisma`/);
       assert.doesNotMatch(architectureDoc, /I18N_ENABLED/);
       assert.match(architectureDoc, /API_PREFIX/);
       assert.match(architectureDoc, /Config Strategy/);
       assert.match(architectureDoc, /TypeScript Module Policy/);
       assert.match(architectureDoc, /tsconfig\.base\.esm\.json/);
-      assert.match(architectureDoc, /DbPrismaModule/);
+      assert.doesNotMatch(architectureDoc, /DbPrismaModule/);
     } finally {
       fs.rmSync(targetRoot, { recursive: true, force: true });
     }
@@ -67,12 +70,13 @@ describe('generateDocs', () => {
     try {
       generateDocs(
         targetRoot,
-        {
-          frontend: 'react',
-          db: 'prisma',
-          dockerEnabled: true,
-          i18nEnabled: true,
-          proxy: 'caddy',
+        {
+          frontend: 'react',
+          db: 'prisma',
+          dbPrismaEnabled: true,
+          dockerEnabled: true,
+          i18nEnabled: true,
+          proxy: 'caddy',
         },
         packageRoot,
       );
@@ -84,6 +88,8 @@ describe('generateDocs', () => {
       assert.match(readme, /Quick Start \(Docker\)/);
       assert.match(readme, /Proxy Preset: Caddy/);
       assert.match(readme, /i18n Configuration/);
+      assert.match(readme, /db-prisma`: `enabled`/);
+      assert.match(readme, /Prisma In Container Start/);
       assert.match(readme, /Error Handling \(`core-errors`\)/);
 
       assert.match(projectDoc, /`infra` - Docker Compose \(always\) \+ proxy preset \(`caddy`\)/);

package/src/core/scaffold.mjs

@@ -5,16 +5,19 @@ import { toKebabCase } from '../utils/values.mjs';
 import { applyI18nDisabled, applyProxyPreset, patchDockerEnvForI18n } from '../presets/index.mjs';
 import { applyModulePreset } from '../modules/executor.mjs';
 import { generateDocs } from './docs.mjs';
-
-function writeApiEnvExample(targetRoot, i18nEnabled) {
-  const apiEnvExamplePath = path.join(targetRoot, 'apps', 'api', '.env.example');
+
+function writeApiEnvExample(targetRoot, i18nEnabled, dbPrismaEnabled) {
+  const apiEnvExamplePath = path.join(targetRoot, 'apps', 'api', '.env.example');
   const apiEnvLines = [
     'NODE_ENV=development',
     'PORT=3000',
     'API_PREFIX=api',
-    'DATABASE_URL=postgresql://postgres:postgres@localhost:5432/app?schema=public',
   ];
-
+
+  if (dbPrismaEnabled) {
+    apiEnvLines.push('DATABASE_URL=postgresql://postgres:postgres@localhost:5432/app?schema=public');
+  }
+
   if (i18nEnabled) {
     apiEnvLines.push('I18N_DEFAULT_LANG=en');
     apiEnvLines.push('I18N_FALLBACK_LANG=en');
@@ -39,12 +42,13 @@ export function scaffoldProject({
   templateRoot,
   packageRoot,
   targetRoot,
-  projectName,
-  frontend,
-  db,
-  i18nEnabled,
-  proxy,
-}) {
+  projectName,
+  frontend,
+  db,
+  dbPrismaEnabled,
+  i18nEnabled,
+  proxy,
+}) {
   copyRecursive(templateRoot, targetRoot);
   patchRootPackageJson(targetRoot, projectName);
   applyProxyPreset(targetRoot, proxy);
@@ -55,7 +59,15 @@ export function scaffoldProject({
     patchDockerEnvForI18n(targetRoot, i18nEnabled);
     applyI18nDisabled(targetRoot);
   }
-
-  writeApiEnvExample(targetRoot, i18nEnabled);
-  generateDocs(targetRoot, { frontend, db, dockerEnabled: true, i18nEnabled, proxy }, packageRoot);
-}
+
+  if (dbPrismaEnabled) {
+    applyModulePreset({ moduleId: 'db-prisma', targetRoot, packageRoot });
+  }
+
+  writeApiEnvExample(targetRoot, i18nEnabled, dbPrismaEnabled);
+  generateDocs(
+    targetRoot,
+    { frontend, db, dbPrismaEnabled, dockerEnabled: true, i18nEnabled, proxy },
+    packageRoot,
+  );
+}