@bleedingdev/modern-js-create 3.2.0-ultramodern.0 → 3.2.0-ultramodern.10

package/dist/types/locale/index.d.ts

@@ -1,112 +1,3 @@
-import { I18n } from '@modern-js/i18n-utils';
-declare const i18n: I18n;
-declare const localeKeys: {
-    prompt: {
-        projectName: string;
-    };
-    error: {
-        projectNameEmpty: string;
-        directoryExists: string;
-        invalidRouter: string;
-        invalidBffRuntime: string;
-        createFailed: string;
-    };
-    message: {
-        welcome: string;
-        success: string;
-        nextSteps: string;
-        step1: string;
-        step2: string;
-        step3: string;
-    };
-    help: {
-        title: string;
-        description: string;
-        usage: string;
-        usageExample: string;
-        options: string;
-        optionHelp: string;
-        optionVersion: string;
-        optionLang: string;
-        optionRouter: string;
-        optionBff: string;
-        optionBffRuntime: string;
-        optionTailwind: string;
-        optionWorkspace: string;
-        optionUltramodernWorkspace: string;
-        optionUltramodernPackageSource: string;
-        optionUltramodernPackageScope: string;
-        optionUltramodernPackageNamePrefix: string;
-        optionSub: string;
-        examples: string;
-        example1: string;
-        example2: string;
-        example3: string;
-        example4: string;
-        example5: string;
-        example6: string;
-        example7: string;
-        example8: string;
-        example9: string;
-        example10: string;
-        moreInfo: string;
-    };
-    version: {
-        message: string;
-    };
-} | {
-    prompt: {
-        projectName: string;
-    };
-    error: {
-        projectNameEmpty: string;
-        directoryExists: string;
-        invalidRouter: string;
-        invalidBffRuntime: string;
-        createFailed: string;
-    };
-    message: {
-        welcome: string;
-        success: string;
-        nextSteps: string;
-        step1: string;
-        step2: string;
-        step3: string;
-    };
-    help: {
-        title: string;
-        description: string;
-        usage: string;
-        usageExample: string;
-        options: string;
-        optionHelp: string;
-        optionVersion: string;
-        optionLang: string;
-        optionRouter: string;
-        optionBff: string;
-        optionBffRuntime: string;
-        optionTailwind: string;
-        optionWorkspace: string;
-        optionUltramodernWorkspace: string;
-        optionUltramodernPackageSource: string;
-        optionUltramodernPackageScope: string;
-        optionUltramodernPackageNamePrefix: string;
-        optionSub: string;
-        examples: string;
-        example1: string;
-        example2: string;
-        example3: string;
-        example4: string;
-        example5: string;
-        example6: string;
-        example7: string;
-        example8: string;
-        example9: string;
-        example10: string;
-        moreInfo: string;
-    };
-    version: {
-        message: string;
-    };
-};
+declare const i18n: any;
+declare const localeKeys: any;
 export { i18n, localeKeys };

package/package.json

@@ -21,7 +21,7 @@
   "engines": {
     "node": ">=20"
   },
-  "version": "3.2.0-ultramodern.0",
+  "version": "3.2.0-ultramodern.10",
   "types": "./dist/types/index.d.ts",
   "main": "./dist/index.js",
   "bin": {
@@ -41,7 +41,7 @@
     "@types/node": "^25.8.0",
     "@typescript/native-preview": "7.0.0-dev.20260516.1",
     "tsx": "^4.22.0",
-    "@modern-js/i18n-utils": "npm:@bleedingdev/modern-js-i18n-utils@3.2.0-ultramodern.0"
+    "@modern-js/i18n-utils": "npm:@bleedingdev/modern-js-i18n-utils@3.2.0-ultramodern.10"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
@@ -52,5 +52,8 @@
     "build": "rslib build && pnpm -w tsgo:dts \"$PWD\"",
     "dev": "rslib build -w",
     "start": "node ./dist/index.js"
+  },
+  "ultramodern": {
+    "frameworkVersion": "3.2.0-ultramodern.10"
   }
 }

package/template/.agents/skills-lock.json

@@ -0,0 +1,34 @@
+{
+  "schemaVersion": 2,
+  "installDir": ".agents/skills",
+  "sources": [
+    {
+      "id": "techsiocz-private",
+      "visibility": "private",
+      "repository": "https://github.com/TechsioCZ/skills",
+      "install": "clone-if-authorized",
+      "baseline": [
+        {
+          "name": "plan-graph",
+          "reason": "Build and validate DAGs from .plan.md files"
+        },
+        {
+          "name": "dag",
+          "reason": "Inspect current plan frontiers and blocked lanes"
+        },
+        {
+          "name": "subagent-graph",
+          "reason": "Design dependency-aware multi-agent launch graphs"
+        },
+        {
+          "name": "helm",
+          "reason": "Steer already-running multi-agent work"
+        },
+        {
+          "name": "debugger-mode",
+          "reason": "Run hypothesis-driven debugging with runtime evidence"
+        }
+      ]
+    }
+  ]
+}

package/template/AGENTS.md

@@ -0,0 +1,20 @@
+# UltraModern Agent Contract
+
+This project is generated for Codex-first UltraModern.js work.
+
+## Quality Gates
+
+- `pnpm lint` runs Oxlint with the Ultracite preset.
+- `pnpm format` runs oxfmt.
+- `pnpm typecheck` runs effect-tsgo as the TypeScript checker.
+- `pnpm ultramodern:check` verifies the generated contract.
+
+## Private Skills
+
+Private orchestration skills are not vendored into this template. If you are authorized for `TechsioCZ/skills`, run:
+
+```bash
+pnpm skills:install
+```
+
+The installer clones that private repository and copies only the allowlisted skills from `.agents/skills-lock.json`.

package/template/README.md

@@ -1,4 +1,4 @@
-# Modern.js `presetUltramodern` Starter
+# UltraModern.js 3.0 Starter
 
 ## Setup
 
@@ -64,8 +64,9 @@ Module Federation remote with the same topology, trust, SSR compatibility, and
 fallback rules as the vertical remotes. Do not add a second preset or a
 design-system-specific framework mode.
 
-The public opinionated entrypoint is `presetUltramodern(...)`. The older
-`withAppBaseline(...)` helper remains only as a compatibility alias.
+The public opinionated entrypoint is `presetUltramodern(...)`. It is the default
+UltraModern.js SuperApp surface for Effect, TanStack, SSR, BFF, and Micro
+Verticals.
 
 Preview the production build locally:
 
@@ -74,5 +75,5 @@ pnpm serve
 ```
 
 For more information, see the
-[UltraModern.js guide](https://modernjs.dev/en/guides/get-started/ultramodern.html)
-and the [Modern.js documentation](https://modernjs.dev/en).
+[UltraModern.js guide](https://bleedingdev.github.io/ultramodern.js/guides/get-started/ultramodern.html)
+and the [UltraModern.js documentation](https://bleedingdev.github.io/ultramodern.js/).

package/template/api/effect/index.ts.handlebars

@@ -2,60 +2,22 @@
   Effect,
   HttpApiBuilder,
   Layer,
-  Schema,
-  ServiceMap,
   defineEffectBff,
 } from '@modern-js/plugin-bff/effect-server';
 import { bffEffectApi } from '../../shared/effect/api';
 
-class GreetingUnavailableError extends Schema.TaggedError<GreetingUnavailableError>()(
-  'GreetingUnavailableError',
-  {
-    message: Schema.String,
-  },
-) {}
-
-class GreetingService extends ServiceMap.Service<GreetingService>()('GreetingService', {
-  make: Effect.succeed({
-    hello: Effect.fn('GreetingService.hello')(function* () {
-      if (Date.now() < 0) {
-        return yield* Effect.fail(
-          new GreetingUnavailableError({
-            message: 'Greeting service is unavailable',
-          }),
-        );
-      }
-
-      return {
-        message: 'Hello from Effect HttpApi',
-        runtime: 'effect' as const,
-      };
-    }),
-  }),
-}) {
-  static readonly layer = Layer.effect(this, this.make);
-}
-
-const greetingsLayer = HttpApiBuilder.group(bffEffectApi, 'greetings', handlers =>
+const greetingsLayer = HttpApiBuilder.group(bffEffectApi, 'greetings', (handlers) =>
   handlers.handle('hello', () =>
-    GreetingService.use(service => service.hello()).pipe(
-      Effect.catchTag('GreetingUnavailableError', error =>
-        Effect.succeed({
-          message: error.message,
-          runtime: 'effect' as const,
-        }),
-      ),
-    ),
+    Effect.succeed({
+      message: 'Hello from Effect HttpApi',
+      runtime: 'effect' as const,
+    }),
   ),
 );
 
-const layer = HttpApiBuilder.layer(bffEffectApi).pipe(
-  Layer.provide(greetingsLayer),
-  Layer.provide(GreetingService.layer),
-);
+const layer = HttpApiBuilder.layer(bffEffectApi).pipe(Layer.provide(greetingsLayer));
 
 export default defineEffectBff({
   api: bffEffectApi,
   layer,
-});
-{{/if}}
+});{{/if}}

package/template/api/lambda/hello.ts.handlebars

@@ -1,6 +1,6 @@
 {{#if useHonoBff}}export default async () => {
   return {
-    message: 'Hello from Modern.js BFF ({{bffRuntime}})',
+    message: 'Hello from UltraModern.js BFF ({{bffRuntime}})',
   };
 };
 {{/if}}

package/template/modern.config.ts.handlebars

@@ -1,41 +1,37 @@
+// @effect-diagnostics nodeBuiltinImport:off processEnv:off
 import { appTools, defineConfig, presetUltramodern } from '@modern-js/app-tools';
 import path from 'node:path';
 {{#if enableBff}}import { bffPlugin } from '@modern-js/plugin-bff';
 {{/if}}{{#if isTanstackRouter}}import { tanstackRouterPlugin } from '@modern-js/plugin-tanstack';
 {{/if}}
-
-const appId = process.env.MODERN_BASELINE_APP_ID || path.basename(process.cwd());
-const enableModuleFederationSSR =
-  process.env.MODERN_BASELINE_ENABLE_MF_SSR !== 'false';
-const enableBffRequestId =
-  process.env.MODERN_BASELINE_ENABLE_BFF_REQUEST_ID !== 'false';
+const appId = process.env['MODERN_BASELINE_APP_ID'] || path.basename(process.cwd());
+const enableModuleFederationSSR = process.env['MODERN_BASELINE_ENABLE_MF_SSR'] !== 'false';
+const enableBffRequestId = process.env['MODERN_BASELINE_ENABLE_BFF_REQUEST_ID'] !== 'false';
 const enableTelemetryExporters =
-  process.env.MODERN_BASELINE_ENABLE_TELEMETRY_EXPORTERS !== 'false';
-const telemetryFailLoudStartup =
-  process.env.MODERN_TELEMETRY_FAIL_LOUD_STARTUP !== 'false';
+  process.env['MODERN_BASELINE_ENABLE_TELEMETRY_EXPORTERS'] !== 'false';
+const telemetryFailLoudStartup = process.env['MODERN_TELEMETRY_FAIL_LOUD_STARTUP'] !== 'false';
+const otlpEndpoint = process.env['MODERN_TELEMETRY_OTLP_ENDPOINT'];
+const victoriaMetricsEndpoint = process.env['MODERN_TELEMETRY_VICTORIA_ENDPOINT'];
 
-// https://modernjs.dev/en/configure/app/usage
+// https://bleedingdev.github.io/ultramodern.js/configure/app/usage.html
 export default defineConfig(
   presetUltramodern(
     {
-      plugins: [
+{{#if enableBff}}      bff: {
+{{#if useEffectBff}}        effect: {
+          openapi: true,
+        },
+
+{{/if}}        runtimeFramework: '{{bffRuntime}}',
+      },
+
+{{/if}}      plugins: [
         appTools(),
 {{#if isTanstackRouter}}
         tanstackRouterPlugin(),
 {{/if}}{{#if enableBff}}
         bffPlugin(),
-{{/if}}
-      ],
-{{#if enableBff}}
-      bff: {
-        runtimeFramework: '{{bffRuntime}}',
-{{#if useEffectBff}}
-        effect: {
-          openapi: true,
-        },
-{{/if}}
-      },
-{{/if}}
+{{/if}}      ],
     },
     {
       appId,
@@ -43,8 +39,8 @@ export default defineConfig(
       enableModuleFederationSSR,
       enableTelemetryExporters,
       telemetryFailLoudStartup,
-      otlpEndpoint: process.env.MODERN_TELEMETRY_OTLP_ENDPOINT,
-      victoriaMetricsEndpoint: process.env.MODERN_TELEMETRY_VICTORIA_ENDPOINT,
+      ...(typeof otlpEndpoint === 'string' ? { otlpEndpoint } : {}),
+      ...(typeof victoriaMetricsEndpoint === 'string' ? { victoriaMetricsEndpoint } : {}),
     },
   ),
 );

package/template/oxfmt.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from 'oxfmt';
+import ultracite from 'ultracite/oxfmt';
+
+export default defineConfig({
+  extends: [ultracite],
+  ignorePatterns: ['dist', 'node_modules', '.modern', '.modernjs', '**/routeTree.gen.ts'],
+  singleQuote: true,
+});

package/template/oxlint.config.ts

@@ -0,0 +1,12 @@
+import { defineConfig } from 'oxlint';
+import core from 'ultracite/oxlint/core';
+import react from 'ultracite/oxlint/react';
+
+export default defineConfig({
+  env: {
+    browser: true,
+    node: true,
+  },
+  extends: [core, react],
+  ignorePatterns: ['dist', 'node_modules', '.modern', '.modernjs', '**/routeTree.gen.ts'],
+});

package/template/package.json.handlebars

@@ -1,47 +1,62 @@
 {
   "name": "{{packageName}}",
   "version": "0.1.0",
+  "type": "module",
   "scripts": {
     "reset": "npx rimraf node_modules ./**/node_modules",
     "dev": "modern dev",
     "build": "modern build",
     "serve": "modern serve",
-    "ultramodern:check": "node ./scripts/validate-ultramodern.mjs"{{#unless isSubproject}},
-    "lint": "biome check",
+    "typecheck": "node -e \"const fs = require('node:fs'); const { execFileSync, spawnSync } = require('node:child_process'); const bin = execFileSync('effect-tsgo', ['get-exe-path'], { encoding: 'utf8' }).trim(); if (process.platform !== 'win32') fs.chmodSync(bin, 0o755); const result = spawnSync(bin, ['--noEmit', '-p', 'tsconfig.json'], { stdio: 'inherit' }); process.exit(result.status ?? 1);\"",
+    "skills:install": "node ./scripts/bootstrap-agent-skills.mjs",
+    "skills:check": "node ./scripts/bootstrap-agent-skills.mjs --check",
+    "ultramodern:check": "{{#unless isSubproject}}pnpm format:check && pnpm lint && {{/unless}}pnpm typecheck{{#unless isSubproject}} && pnpm skills:check{{/unless}} && node ./scripts/validate-ultramodern.mjs"{{#unless isSubproject}},
+    "format": "oxfmt .",
+    "format:check": "oxfmt --check .",
+    "lint": "oxlint .",
+    "lint:fix": "oxlint . --fix",
     "prepare": "simple-git-hooks"{{/unless}}
   },
-  "engines": {
-    "node": ">=20"
-  }{{#unless isSubproject}},
-  "lint-staged": {
-    "*.{js,ts,cjs,mjs,d.cts,d.mts,jsx,tsx,json,jsonc}": [
-      "biome check --files-ignore-unknown=true"
-    ]
-  },
-  "simple-git-hooks": {
-    "pre-commit": "npx lint-staged"
-  }{{/unless}},
   "dependencies": {
-    "@modern-js/runtime": "{{version}}"{{#if isTanstackRouter}},
-    "@modern-js/plugin-tanstack": "{{version}}",
-    "@tanstack/react-router": "1.170.1"{{/if}},
+{{#if isTanstackRouter}}    "@modern-js/plugin-tanstack": "{{pluginTanstackVersion}}",
+{{/if}}    "@modern-js/runtime": "{{runtimeVersion}}",
+{{#if isTanstackRouter}}    "@tanstack/react-router": "1.170.1",
+{{/if}}
     "react": "^19.2.3",
     "react-dom": "^19.2.0"
   },
   "devDependencies": {
-    "@modern-js/app-tools": "{{version}}",
-    "@modern-js/tsconfig": "{{version}}"{{#if enableBff}},
-    "@modern-js/plugin-bff": "{{version}}"{{/if}}{{#if enableTailwind}},
+    "@effect/tsgo": "0.7.3",
+    "@modern-js/app-tools": "{{appToolsVersion}}",
+{{#if enableBff}}    "@modern-js/plugin-bff": "{{pluginBffVersion}}",
+{{/if}}    "@modern-js/tsconfig": "{{tsconfigVersion}}",
+{{#if enableTailwind}}
     "@tailwindcss/postcss": "^4.1.18",
-    "postcss": "^8.5.6",
-    "tailwindcss": "^4.1.18"{{/if}}{{#unless isSubproject}},
-    "@biomejs/biome": "1.9.4"{{/unless}},
-    "@typescript/native-preview": "7.0.0-dev.20260516.1",
+{{/if}}
     "@types/node": "^20",
     "@types/react": "^19.1.8",
-    "@types/react-dom": "^19.1.6"{{#unless isSubproject}},
+    "@types/react-dom": "^19.1.6",
+    "@typescript/native-preview": "7.0.0-dev.20260518.1",
+{{#unless isSubproject}}
     "lint-staged": "~15.4.0",
-    "simple-git-hooks": "^2.11.1"{{/unless}},
-    "rimraf": "^6.0.1"
+    "oxfmt": "0.50.0",
+    "oxlint": "1.65.0",
+{{/unless}}{{#if enableTailwind}}    "postcss": "^8.5.6",
+{{/if}}    "rimraf": "^6.0.1"{{#unless isSubproject}},
+    "simple-git-hooks": "^2.11.1"{{/unless}}{{#if enableTailwind}},
+    "tailwindcss": "^4.1.18"{{/if}}{{#unless isSubproject}},
+    "ultracite": "7.7.0"{{/unless}}
+  }{{#unless isSubproject}},
+  "simple-git-hooks": {
+    "pre-commit": "npx lint-staged"
+  },
+  "lint-staged": {
+    "*.{js,ts,cjs,mjs,d.cts,d.mts,jsx,tsx,json,jsonc}": [
+      "oxfmt --write",
+      "oxlint --fix"
+    ]
+  }{{/unless}},
+  "engines": {
+    "node": ">=20"
   }
 }

package/template/scripts/bootstrap-agent-skills.mjs

@@ -0,0 +1,95 @@
+import { execFileSync } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+
+const root = process.cwd();
+const lockPath = path.join(root, '.agents/skills-lock.json');
+const checkOnly = process.argv.includes('--check');
+const force = process.argv.includes('--force');
+
+const readJson = (filePath) => JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+
+const run = (command, args, options = {}) =>
+  execFileSync(command, args, {
+    cwd: options.cwd ?? root,
+    encoding: 'utf-8',
+    stdio: options.stdio ?? ['ignore', 'pipe', 'pipe'],
+  });
+
+const cloneSource = (source, targetDir) => {
+  const repo = source.repository.replace(/^https:\/\/github.com\//u, '');
+  try {
+    run('gh', ['repo', 'clone', repo, targetDir, '--', '--depth', '1'], {
+      stdio: 'inherit',
+    });
+  } catch {
+    run('git', ['clone', '--depth', '1', source.repository, targetDir], {
+      stdio: 'inherit',
+    });
+  }
+};
+
+const resolveSkillDir = (sourceRoot, skillName) => {
+  const candidates = [
+    path.join(sourceRoot, skillName),
+    path.join(sourceRoot, 'skills', skillName),
+    path.join(sourceRoot, 'skills', 'engineering', skillName),
+    path.join(sourceRoot, 'skills', 'productivity', skillName),
+  ];
+  return candidates.find((candidate) => fs.existsSync(path.join(candidate, 'SKILL.md')));
+};
+
+if (!fs.existsSync(lockPath)) {
+  console.error('Missing .agents/skills-lock.json');
+  process.exit(1);
+}
+
+const lock = readJson(lockPath);
+const installDir = path.join(root, lock.installDir ?? '.agents/skills');
+const privateSources = (lock.sources ?? []).filter(
+  (source) => source.install === 'clone-if-authorized',
+);
+
+if (checkOnly) {
+  const missing = privateSources.flatMap((source) =>
+    (source.baseline ?? [])
+      .map((skill) => skill.name)
+      .filter((skillName) => !fs.existsSync(path.join(installDir, skillName, 'SKILL.md'))),
+  );
+  if (missing.length > 0) {
+    console.warn(
+      `Private skills not installed: ${missing.join(', ')}. Run pnpm skills:install if you have access.`,
+    );
+  } else {
+    console.log('Agent skills are installed.');
+  }
+  process.exit(0);
+}
+
+fs.mkdirSync(installDir, { recursive: true });
+
+for (const source of privateSources) {
+  const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ultramodern-skills-'));
+  try {
+    cloneSource(source, tempDir);
+    for (const skill of source.baseline ?? []) {
+      const sourceSkillDir = resolveSkillDir(tempDir, skill.name);
+      if (!sourceSkillDir) {
+        throw new Error(`Skill ${skill.name} not found in ${source.repository}`);
+      }
+      const targetSkillDir = path.join(installDir, skill.name);
+      if (fs.existsSync(targetSkillDir)) {
+        if (!force) {
+          console.log(`Skipping existing ${skill.name}`);
+          continue;
+        }
+        fs.rmSync(targetSkillDir, { force: true, recursive: true });
+      }
+      fs.cpSync(sourceSkillDir, targetSkillDir, { recursive: true });
+      console.log(`Installed ${skill.name}`);
+    }
+  } finally {
+    fs.rmSync(tempDir, { force: true, recursive: true });
+  }
+}