create-forgeon 0.3.11 → 0.3.12

package/package.json

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

package/src/modules/dependencies.test.mjs

@@ -1,4 +1,4 @@
-import { describe, it } from 'node:test';
+import { describe, it } from 'node:test';
 import assert from 'node:assert/strict';
 import fs from 'node:fs';
 import os from 'node:os';
@@ -109,6 +109,24 @@ const TEST_PRESETS = [
       },
     ],
   },
+  {
+    id: 'queue',
+    label: 'Queue',
+    implemented: true,
+    detectionPaths: ['packages/queue/package.json'],
+    provides: ['queue-runtime'],
+    requires: [],
+    optionalIntegrations: [],
+  },
+  {
+    id: 'scheduler',
+    label: 'Scheduler',
+    implemented: true,
+    detectionPaths: ['packages/scheduler/package.json'],
+    provides: ['scheduler-runtime'],
+    requires: [{ type: 'capability', id: 'queue-runtime' }],
+    optionalIntegrations: [],
+  },
 ];
 
 describe('module dependency helpers', () => {
@@ -278,6 +296,28 @@ describe('module dependency helpers', () => {
     }
   });
 
+  it('resolves scheduler plan through queue-runtime capability chain', async () => {
+    const targetRoot = mkTmp('forgeon-deps-scheduler-plan-');
+
+    try {
+      const result = await resolveModuleInstallPlan({
+        moduleId: 'scheduler',
+        targetRoot,
+        presets: TEST_PRESETS,
+        withRequired: true,
+        isInteractive: false,
+      });
+
+      assert.equal(result.cancelled, false);
+      assert.deepEqual(result.moduleSequence, ['queue', 'scheduler']);
+      assert.deepEqual(result.selectedProviders, {
+        'queue-runtime': 'queue',
+      });
+    } finally {
+      fs.rmSync(targetRoot, { recursive: true, force: true });
+    }
+  });
+
   it('reports missing optional integrations for the installed module', () => {
     const targetRoot = mkTmp('forgeon-deps-optional-');
     try {
@@ -358,3 +398,4 @@ describe('module dependency helpers', () => {
     }
   });
 });
+

package/src/modules/executor.mjs

@@ -1,4 +1,4 @@
-import fs from 'node:fs';
+import fs from 'node:fs';
 import path from 'node:path';
 import { ensureModuleExists } from './registry.mjs';
 import { writeModuleDocs } from './docs.mjs';
@@ -15,6 +15,7 @@ import { applyLoggerModule } from './logger.mjs';
 import { applyRateLimitModule } from './rate-limit.mjs';
 import { applyRbacModule } from './rbac.mjs';
 import { applyQueueModule } from './queue.mjs';
+import { applySchedulerModule } from './scheduler.mjs';
 import { applySwaggerModule } from './swagger.mjs';
 
 function ensureForgeonLikeProject(targetRoot) {
@@ -46,6 +47,7 @@ const MODULE_APPLIERS = {
   logger: applyLoggerModule,
   queue: applyQueueModule,
   'rate-limit': applyRateLimitModule,
+  scheduler: applySchedulerModule,
   rbac: applyRbacModule,
   swagger: applySwaggerModule,
 };
@@ -82,3 +84,4 @@ export function addModule({ moduleId, targetRoot, packageRoot, writeDocs = true
       : `Module "${preset.id}" is planned; docs note created only.`,
   };
 }
+

package/src/modules/executor.test.mjs

@@ -1,4 +1,4 @@
-import { describe, it } from 'node:test';
+import { describe, it } from 'node:test';
 import assert from 'node:assert/strict';
 import fs from 'node:fs';
 import os from 'node:os';
@@ -132,6 +132,51 @@ function assertQueueWiring(projectRoot) {
   assert.match(readme, /runtime baseline backed by Redis/i);
 }
 
+function assertSchedulerWiring(projectRoot) {
+  const appModule = fs.readFileSync(path.join(projectRoot, 'apps', 'api', 'src', 'app.module.ts'), 'utf8');
+  assert.match(appModule, /schedulerConfig/);
+  assert.match(appModule, /schedulerEnvSchema/);
+  assert.match(appModule, /ForgeonSchedulerModule/);
+
+  const apiPackage = fs.readFileSync(path.join(projectRoot, 'apps', 'api', 'package.json'), 'utf8');
+  assert.match(apiPackage, /@forgeon\/scheduler/);
+  assert.match(apiPackage, /pnpm --filter @forgeon\/scheduler build/);
+
+  const apiDockerfile = fs.readFileSync(path.join(projectRoot, 'apps', 'api', 'Dockerfile'), 'utf8');
+  assert.match(apiDockerfile, /COPY packages\/scheduler\/package\.json packages\/scheduler\/package\.json/);
+  assert.match(apiDockerfile, /COPY packages\/scheduler packages\/scheduler/);
+  assert.match(apiDockerfile, /RUN pnpm --filter @forgeon\/scheduler build/);
+
+  const healthController = fs.readFileSync(
+    path.join(projectRoot, 'apps', 'api', 'src', 'health', 'health.controller.ts'),
+    'utf8',
+  );
+  assert.match(healthController, /ForgeonSchedulerService/);
+  assert.match(healthController, /@Get\('scheduler'\)/);
+  assert.match(healthController, /schedulerService\.getProbeStatus/);
+
+  const webApp = fs.readFileSync(path.join(projectRoot, 'apps', 'web', 'src', 'App.tsx'), 'utf8');
+  assert.match(webApp, /Check scheduler health/);
+  assert.match(webApp, /Scheduler probe response/);
+
+  const apiEnv = fs.readFileSync(path.join(projectRoot, 'apps', 'api', '.env.example'), 'utf8');
+  assert.match(apiEnv, /SCHEDULER_ENABLED=true/);
+  assert.match(apiEnv, /SCHEDULER_TIMEZONE=UTC/);
+  assert.match(apiEnv, /SCHEDULER_HEARTBEAT_CRON=\*\/5 \* \* \* \*/);
+
+  const dockerEnv = fs.readFileSync(path.join(projectRoot, 'infra', 'docker', '.env.example'), 'utf8');
+  assert.match(dockerEnv, /SCHEDULER_TIMEZONE=UTC/);
+
+  const compose = fs.readFileSync(path.join(projectRoot, 'infra', 'docker', 'compose.yml'), 'utf8');
+  assert.match(compose, /SCHEDULER_ENABLED: \$\{SCHEDULER_ENABLED\}/);
+  assert.match(compose, /SCHEDULER_HEARTBEAT_CRON: \$\{SCHEDULER_HEARTBEAT_CRON\}/);
+  assert.doesNotMatch(compose, /^\s{2}scheduler:\s*$/m);
+
+  const readme = fs.readFileSync(path.join(projectRoot, 'README.md'), 'utf8');
+  assert.match(readme, /## Scheduler Module/);
+  assert.match(readme, /cron-based orchestration/i);
+}
+
 function assertRbacWiring(projectRoot) {
   const appModule = fs.readFileSync(path.join(projectRoot, 'apps', 'api', 'src', 'app.module.ts'), 'utf8');
   assert.match(appModule, /ForgeonRbacModule/);
@@ -752,6 +797,51 @@ describe('addModule', () => {
     }
   });
 
+  it('applies scheduler module on top of project with queue installed', () => {
+    const targetRoot = mkTmp('forgeon-module-scheduler-');
+    const projectRoot = path.join(targetRoot, 'demo-scheduler');
+    const templateRoot = path.join(packageRoot, 'templates', 'base');
+
+    try {
+      scaffoldProject({
+        templateRoot,
+        packageRoot,
+        targetRoot: projectRoot,
+        projectName: 'demo-scheduler',
+        frontend: 'react',
+        db: 'prisma',
+        dbPrismaEnabled: false,
+        i18nEnabled: false,
+        proxy: 'caddy',
+      });
+
+      addModule({
+        moduleId: 'queue',
+        targetRoot: projectRoot,
+        packageRoot,
+      });
+
+      const result = addModule({
+        moduleId: 'scheduler',
+        targetRoot: projectRoot,
+        packageRoot,
+      });
+
+      assert.equal(result.applied, true);
+      assert.match(result.message, /applied/);
+      assert.equal(fs.existsSync(result.docsPath), true);
+
+      assertQueueWiring(projectRoot);
+      assertSchedulerWiring(projectRoot);
+
+      const note = fs.readFileSync(result.docsPath, 'utf8');
+      assert.match(note, /Scheduler/);
+      assert.match(note, /Status: implemented/);
+    } finally {
+      fs.rmSync(targetRoot, { recursive: true, force: true });
+    }
+  });
+
   it('throws for unknown module id', () => {
     const targetRoot = mkTmp('forgeon-module-unknown-');
     try {
@@ -2352,3 +2442,4 @@ describe('addModule', () => {
     }
   });
 });
+