@bleedingdev/modern-js-create 3.2.0-ultramodern.9 → 3.2.0-ultramodern.90

package/template-workspace/scripts/validate-ultramodern-workspace.mjs.handlebars

@@ -1,403 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-
-const root = process.cwd();
-const packageScope = '{{packageScope}}';
-const tanstackVersion = '1.170.1';
-const rstackAgentSkillsCommit =
-  '61c948b42512e223bad44b83af4080eba48b2677';
-const modernPackages = [
-  '@modern-js/app-tools',
-  '@modern-js/plugin-bff',
-  '@modern-js/plugin-tanstack',
-  '@modern-js/runtime',
-];
-const baselineAgentSkills = [
-  'rsbuild-best-practices',
-  'rspack-best-practices',
-  'rspack-tracing',
-  'rsdoctor-analysis',
-  'rslib-best-practices',
-  'rslib-modern-package',
-  'rstest-best-practices',
-];
-const privateAgentSkills = [
-  'plan-graph',
-  'dag',
-  'subagent-graph',
-  'helm',
-  'debugger-mode',
-];
-
-function readText(relativePath) {
-  return fs.readFileSync(path.join(root, relativePath), 'utf-8');
-}
-
-function readJson(relativePath) {
-  return JSON.parse(readText(relativePath));
-}
-
-function assert(condition, message) {
-  if (!condition) {
-    throw new Error(message);
-  }
-}
-
-function assertExists(relativePath) {
-  assert(fs.existsSync(path.join(root, relativePath)), `Missing ${relativePath}`);
-}
-
-const requiredPaths = [
-  'AGENTS.md',
-  'package.json',
-  'pnpm-workspace.yaml',
-  'tsconfig.base.json',
-  'oxlint.config.ts',
-  'oxfmt.config.ts',
-  '.agents/skills-lock.json',
-  '.agents/rstackjs-agent-skills-LICENSE',
-  '.agents/skills/rsbuild-best-practices/SKILL.md',
-  '.agents/skills/rspack-best-practices/SKILL.md',
-  '.agents/skills/rspack-tracing/SKILL.md',
-  '.agents/skills/rspack-tracing/references/tracing-guide.md',
-  '.agents/skills/rspack-tracing/scripts/analyze_trace.js',
-  '.agents/skills/rsdoctor-analysis/SKILL.md',
-  '.agents/skills/rsdoctor-analysis/references/rsdoctor-data-types.md',
-  '.agents/skills/rslib-best-practices/SKILL.md',
-  '.agents/skills/rslib-modern-package/SKILL.md',
-  '.agents/skills/rstest-best-practices/SKILL.md',
-  'topology/reference-topology.json',
-  'topology/ownership.json',
-  'topology/local-overlays/development.json',
-  '.modernjs/ultramodern-workspace-template-manifest.json',
-  '.modernjs/ultramodern-package-source.json',
-  'scripts/bootstrap-agent-skills.mjs',
-  'apps/shell-super-app/package.json',
-  'apps/shell-super-app/modern.config.ts',
-  'apps/shell-super-app/module-federation.config.ts',
-  'apps/remotes/remote-commerce/package.json',
-  'apps/remotes/remote-commerce/modern.config.ts',
-  'apps/remotes/remote-commerce/module-federation.config.ts',
-  'apps/remotes/remote-identity/package.json',
-  'apps/remotes/remote-identity/modern.config.ts',
-  'apps/remotes/remote-identity/module-federation.config.ts',
-  'apps/remotes/remote-design-system/package.json',
-  'apps/remotes/remote-design-system/modern.config.ts',
-  'apps/remotes/remote-design-system/module-federation.config.ts',
-  'services/service-recommendations-effect/package.json',
-  'services/service-recommendations-effect/modern.config.ts',
-  'services/service-recommendations-effect/api/effect/index.ts',
-  'services/service-recommendations-effect/shared/effect/api.ts',
-  'packages/shared-contracts/src/index.ts',
-  'packages/shared-design-tokens/src/index.ts',
-  'packages/shared-effect-api/src/index.ts',
-];
-
-for (const requiredPath of requiredPaths) {
-  assertExists(requiredPath);
-}
-
-const rootPackage = readJson('package.json');
-const packageSource = readJson('.modernjs/ultramodern-package-source.json');
-const skillsLock = readJson('.agents/skills-lock.json');
-const expectedModernSpecifier =
-  packageSource.strategy === 'install'
-    ? packageSource.modernPackages?.specifier
-    : 'workspace:*';
-
-function expectedModernDependency(packageName) {
-  if (packageSource.strategy !== 'install') {
-    return 'workspace:*';
-  }
-
-  const aliasPackageName = packageSource.modernPackages?.aliases?.[packageName];
-  return aliasPackageName
-    ? `npm:${aliasPackageName}@${expectedModernSpecifier}`
-    : expectedModernSpecifier;
-}
-
-assert(rootPackage.private === true, 'Root package must be private');
-assert(rootPackage.modernjs?.preset === 'presetUltramodern', 'Root must declare presetUltramodern');
-assert(rootPackage.packageManager === 'pnpm@11.1.2', 'Root must pin pnpm 11.1.2');
-assert(rootPackage.engines?.pnpm === '>=11.0.0', 'Root must require pnpm >=11');
-assert(
-  rootPackage.modernjs?.packageSource?.config ===
-    './.modernjs/ultramodern-package-source.json',
-  'Root must point to the UltraModern package source metadata',
-);
-assert(
-  rootPackage.modernjs?.packageSource?.strategy === packageSource.strategy,
-  'Root package source strategy must match the UltraModern package source metadata',
-);
-assert(
-  packageSource.strategy === 'workspace' || packageSource.strategy === 'install',
-  'Package source strategy must be workspace or install',
-);
-assert(
-  packageSource.generatedWorkspacePackages?.specifier === 'workspace:*',
-  'Generated shared packages must keep workspace:* links',
-);
-assert(
-  modernPackages.every(packageName =>
-    packageSource.modernPackages?.packages?.includes(packageName),
-  ),
-  'Package source metadata must list all Modern runtime/tooling packages',
-);
-assert(
-  expectedModernSpecifier &&
-    packageSource.modernPackages?.specifier === expectedModernSpecifier,
-  'Package source metadata must provide a Modern package specifier',
-);
-assert(
-  rootPackage.scripts?.['ultramodern:check'] ===
-    'node ./scripts/validate-ultramodern-workspace.mjs',
-  'Root must expose the ultramodern:check script',
-);
-const requiredRootScripts = {
-  format: 'oxfmt .',
-  'format:check': 'oxfmt --check .',
-  lint: 'oxlint .',
-  'lint:fix': 'oxlint . --fix',
-  'skills:install': 'node ./scripts/bootstrap-agent-skills.mjs',
-  'skills:check': 'node ./scripts/bootstrap-agent-skills.mjs --check',
-};
-for (const [scriptName, scriptCommand] of Object.entries(requiredRootScripts)) {
-  assert(
-    rootPackage.scripts?.[scriptName] === scriptCommand,
-    `Root must expose ${scriptName}`,
-  );
-}
-for (const dependency of [
-  '@effect/tsgo',
-  '@typescript/native-preview',
-  'oxlint',
-  'oxfmt',
-  'ultracite',
-]) {
-  assert(
-    rootPackage.devDependencies?.[dependency],
-    `Root must depend on ${dependency}`,
-  );
-}
-
-const agentsInstructions = readText('AGENTS.md');
-assert(
-  agentsInstructions.includes('UltraModern Agent Contract') &&
-    agentsInstructions.includes('Required Skill Baseline'),
-  'Root AGENTS.md must document the UltraModern agent contract',
-);
-assert(
-  skillsLock.source?.repository === 'https://github.com/rstackjs/agent-skills',
-  'Agent skills lock must retain the Rstack skill source repository',
-);
-assert(
-  skillsLock.source?.commit === rstackAgentSkillsCommit,
-  'Agent skills lock must pin the expected Rstack skill commit',
-);
-assert(
-  skillsLock.installDir === '.agents/skills',
-  'Agent skills lock must use .agents/skills as installDir',
-);
-for (const skillName of baselineAgentSkills) {
-  assert(
-    skillsLock.baseline?.some(skill => skill.name === skillName),
-    `Agent skills lock must include ${skillName}`,
-  );
-  const skillContent = readText(`.agents/skills/${skillName}/SKILL.md`);
-  assert(
-    skillContent.includes(`name: ${skillName}`),
-    `${skillName} must contain matching skill metadata`,
-  );
-}
-const privateSource = skillsLock.sources?.find(
-  source => source.repository === 'https://github.com/TechsioCZ/skills',
-);
-assert(
-  privateSource?.install === 'clone-if-authorized',
-  'Agent skills lock must configure TechsioCZ skills as clone-if-authorized',
-);
-for (const skillName of privateAgentSkills) {
-  assert(
-    privateSource.baseline?.some(skill => skill.name === skillName),
-    `Agent skills lock must allowlist private skill ${skillName}`,
-  );
-}
-
-const appPackagePaths = [
-  'apps/shell-super-app/package.json',
-  'apps/remotes/remote-commerce/package.json',
-  'apps/remotes/remote-identity/package.json',
-  'apps/remotes/remote-design-system/package.json',
-];
-
-for (const packagePath of appPackagePaths) {
-  const packageJson = readJson(packagePath);
-  assert(
-    packageJson.dependencies?.['@modern-js/plugin-tanstack'] ===
-      expectedModernDependency('@modern-js/plugin-tanstack'),
-    `${packagePath} must depend on @modern-js/plugin-tanstack through ${expectedModernDependency('@modern-js/plugin-tanstack')}`,
-  );
-  assert(
-    packageJson.dependencies?.['@modern-js/runtime'] ===
-      expectedModernDependency('@modern-js/runtime'),
-    `${packagePath} must depend on @modern-js/runtime through ${expectedModernDependency('@modern-js/runtime')}`,
-  );
-  assert(
-    packageJson.devDependencies?.['@modern-js/app-tools'] ===
-      expectedModernDependency('@modern-js/app-tools'),
-    `${packagePath} must depend on @modern-js/app-tools through ${expectedModernDependency('@modern-js/app-tools')}`,
-  );
-  assert(
-    packageJson.dependencies?.[`@${packageScope}/shared-contracts`] ===
-      'workspace:*',
-    `${packagePath} must link generated shared contracts through workspace:*`,
-  );
-  assert(
-    packageJson.dependencies?.[`@${packageScope}/shared-design-tokens`] ===
-      'workspace:*',
-    `${packagePath} must link generated shared design tokens through workspace:*`,
-  );
-  assert(
-    packageJson.dependencies?.['@tanstack/react-router'] === tanstackVersion,
-    `${packagePath} must use @tanstack/react-router ${tanstackVersion}`,
-  );
-  assert(
-    packageJson.dependencies?.['@module-federation/modern-js-v3'] === '2.4.0',
-    `${packagePath} must include the Module Federation plugin`,
-  );
-  assert(
-    packageJson.modernjs?.preset === 'presetUltramodern',
-    `${packagePath} must keep presetUltramodern metadata`,
-  );
-}
-
-for (const configPath of [
-  'apps/shell-super-app/modern.config.ts',
-  'apps/remotes/remote-commerce/modern.config.ts',
-  'apps/remotes/remote-identity/modern.config.ts',
-  'apps/remotes/remote-design-system/modern.config.ts',
-]) {
-  const config = readText(configPath);
-  assert(config.includes('presetUltramodern('), `${configPath} must use presetUltramodern`);
-  assert(config.includes('tanstackRouterPlugin()'), `${configPath} must enable plugin-tanstack`);
-  assert(config.includes('moduleFederationPlugin()'), `${configPath} must enable Module Federation`);
-}
-
-const shellMf = readText('apps/shell-super-app/module-federation.config.ts');
-assert(shellMf.includes("name: 'shellSuperApp'"), 'Shell MF config must name the shell');
-assert(shellMf.includes('remoteCommerce@http://localhost:3021/mf-manifest.json'), 'Shell must reference commerce remote');
-assert(shellMf.includes('remoteIdentity@http://localhost:3022/mf-manifest.json'), 'Shell must reference identity remote');
-assert(shellMf.includes('remoteDesignSystem@http://localhost:3023/mf-manifest.json'), 'Shell must reference design-system remote');
-
-const commerceMf = readText('apps/remotes/remote-commerce/module-federation.config.ts');
-assert(commerceMf.includes("name: 'remoteCommerce'"), 'Commerce remote MF name is missing');
-assert(commerceMf.includes('"./Widget"'), 'Commerce remote must expose a widget');
-
-const designMf = readText('apps/remotes/remote-design-system/module-federation.config.ts');
-assert(designMf.includes("name: 'remoteDesignSystem'"), 'Design-system remote MF name is missing');
-assert(designMf.includes('"./Button"'), 'Design-system remote must expose Button');
-assert(designMf.includes('"./tokens"'), 'Design-system remote must expose tokens');
-
-const servicePackage = readJson('services/service-recommendations-effect/package.json');
-assert(
-  servicePackage.dependencies?.['@modern-js/runtime'] ===
-    expectedModernDependency('@modern-js/runtime'),
-  `Effect service must use @modern-js/runtime through ${expectedModernDependency('@modern-js/runtime')}`,
-);
-assert(
-  servicePackage.devDependencies?.['@modern-js/app-tools'] ===
-    expectedModernDependency('@modern-js/app-tools'),
-  `Effect service must use @modern-js/app-tools through ${expectedModernDependency('@modern-js/app-tools')}`,
-);
-assert(
-  servicePackage.devDependencies?.['@modern-js/plugin-bff'] ===
-    expectedModernDependency('@modern-js/plugin-bff'),
-  `Effect service must use @modern-js/plugin-bff through ${expectedModernDependency('@modern-js/plugin-bff')}`,
-);
-assert(
-  servicePackage.dependencies?.[`@${packageScope}/shared-effect-api`] ===
-    'workspace:*',
-  'Effect service must link generated shared Effect API through workspace:*',
-);
-
-const serviceConfig = readText('services/service-recommendations-effect/modern.config.ts');
-assert(serviceConfig.includes("runtimeFramework: 'effect'"), 'Effect service must use Effect runtime');
-assert(serviceConfig.includes('bffPlugin()'), 'Effect service must enable bffPlugin');
-
-const serviceEntry = readText('services/service-recommendations-effect/api/effect/index.ts');
-assert(serviceEntry.includes('defineEffectBff'), 'Effect service must expose defineEffectBff placeholder');
-assert(serviceEntry.includes('recommendationsEffectApi'), 'Effect service must use shared recommendations API');
-
-const serviceApi = readText('services/service-recommendations-effect/shared/effect/api.ts');
-assert(serviceApi.includes('HttpApi.make'), 'Effect shared API placeholder must define HttpApi');
-
-const topology = readJson('topology/reference-topology.json');
-assert(topology.preset === 'presetUltramodern', 'Topology must reference presetUltramodern');
-assert(topology.shell?.id === 'shell-super-app', 'Topology shell id is incorrect');
-assert(topology.shell?.remoteRefs?.length === 3, 'Topology shell must reference three remotes');
-assert(topology.remotes?.length === 3, 'Topology must contain three remotes');
-assert(
-  topology.remotes.some(
-    remote =>
-      remote.id === 'remote-design-system' &&
-      remote.kind === 'horizontal-design-system',
-  ),
-  'Topology must contain the horizontal design-system remote',
-);
-assert(topology.effectServices?.[0]?.runtime === 'effect', 'Topology must contain an Effect service');
-assert(topology.sharedPackages?.length === 3, 'Topology must contain shared package placeholders');
-
-const ownership = readJson('topology/ownership.json');
-assert(
-  ownership.owners?.some(
-    owner =>
-      owner.id === 'remote-commerce' &&
-      owner.ownership?.team === 'commerce-experience',
-  ),
-  'Ownership metadata must retain commerce owner',
-);
-assert(
-  ownership.owners?.some(
-    owner =>
-      owner.id === 'service-recommendations-effect' &&
-      owner.package === `@${packageScope}/service-recommendations-effect`,
-  ),
-  'Ownership metadata must retain Effect service owner',
-);
-
-const manifest = readJson('.modernjs/ultramodern-workspace-template-manifest.json');
-assert(
-  manifest.template?.id === 'modernjs-ultramodern-superapp-workspace',
-  'Template manifest evidence is missing',
-);
-assert(
-  manifest.packageSource?.strategy === packageSource.strategy,
-  'Template manifest must retain the generated package source strategy',
-);
-assert(
-  manifest.agentSkills?.source?.commit === rstackAgentSkillsCommit,
-  'Template manifest must retain the Rstack agent skills commit',
-);
-assert(
-  baselineAgentSkills.every(skillName =>
-    manifest.agentSkills?.baseline?.includes(skillName),
-  ),
-  'Template manifest must list every baseline agent skill',
-);
-assert(
-  manifest.agentSkills?.privateSource?.repository ===
-    'https://github.com/TechsioCZ/skills',
-  'Template manifest must retain the private TechsioCZ skill source',
-);
-assert(
-  privateAgentSkills.every(skillName =>
-    manifest.agentSkills?.privateSource?.baseline?.includes(skillName),
-  ),
-  'Template manifest must list every private agent skill allowlist entry',
-);
-assert(
-  manifest.validation?.expectedCommands?.includes('pnpm run ultramodern:check'),
-  'Template manifest must document the validation command',
-);
-
-console.log('UltraModern workspace scaffold validated');