enterprise-ui-architect-cli 1.0.0 → 2.0.0

package/assets/SKILL.md

@@ -512,6 +512,104 @@ Avoid:
 - business-specific styling inside generic UI primitives
 - using `item` prop on MUI v7 `Grid`
 
+## Package Import Discipline
+
+When adding or modifying imports in any module:
+
+### 1. Verify Package Exists
+Before writing a new import statement, check `package.json` (and `package-lock.json` / `yarn.lock` / `pnpm-lock.yaml`) to confirm the package is installed.
+
+```bash
+# Quick check
+grep '"package-name"' package.json
+```
+
+### 2. If Package Is Missing
+**Do NOT install automatically.** Present the user with:
+- The missing package name
+- The import path that triggered the need
+- The recommended install command
+- Ask for explicit confirmation
+
+Example prompt:
+```
+⚠️  Missing package: @mui/x-data-grid
+    Required by: src/features/admin/components/DataTable.tsx
+    Install: npm install @mui/x-data-grid
+    Proceed? (y/n)
+```
+
+### 3. Install Only After Confirmation
+If user confirms, install with the project's package manager:
+- Detect from lockfile: `package-lock.json` → npm, `yarn.lock` → yarn, `pnpm-lock.yaml` → pnpm
+- Respect existing version constraints in `package.json`
+- Update lockfile alongside install
+
+### 4. Post-Install Verification
+After install:
+1. Run TypeScript check: `npx tsc --noEmit`
+2. Verify the import resolves without error
+3. Confirm no unused imports were added (tree-shaking friendly)
+
+### 5. Anti-Pattern
+- Adding imports for packages not in `package.json`
+- Auto-installing without user consent
+- Using different package managers within the same repo
+- Adding unused dependencies "just in case"
+
+## Translation Discipline (i18n)
+
+When building multi-language admin dashboards with `next-intl`, `react-i18next`, or similar:
+
+### 1. Always Use `t()` for User-Facing Text
+Every string visible to users must go through the translation function. No hardcoded labels, buttons, placeholders, or error messages.
+
+```tsx
+// ✅ Correct
+<Button>{t("form.save")}</Button>
+<CustomTextField label={t("auth.username")} />
+
+// ❌ Wrong
+<Button>Save</Button>
+<CustomTextField label="Username" />
+```
+
+### 2. Add Keys to All Locale Files
+When you introduce a new `t("key")` call, you **must** add that key to **every** `messages/*.json` file before finishing.
+
+```bash
+# Verify all keys exist in every locale
+enterprise-ui verify-i18n --src ./src
+```
+
+### 3. Namespace Convention
+Use `useTranslations("namespace")` for page-scoped keys. This keeps locale files organized and prevents key collisions.
+
+```tsx
+const t = useTranslations("admin.users");
+// keys become: admin.users.title, admin.users.column.name, etc.
+```
+
+### 4. Dynamic Keys
+Avoid dynamic template literals for translation keys when possible:
+
+```tsx
+// ✅ Prefer explicit mapping
+const statusKey = status === "active" ? "status.active" : "status.inactive";
+<Chip label={t(statusKey)} />
+
+// ❌ Avoid
+<Chip label={t(`status.${status}`)} />
+```
+
+If dynamic keys are unavoidable, ensure all possible values are documented and present in locale files.
+
+### 5. Pre-Delivery Check
+Before marking a feature complete:
+- [ ] All `t()` keys exist in every locale file
+- [ ] No hardcoded user-facing strings remain
+- [ ] `enterprise-ui verify-i18n` passes with zero missing keys
+
 ## Keyboard Navigation
 MUI components require specific keyboard patterns:
 

package/assets/commands/verify-i18n.ts

@@ -0,0 +1,213 @@
+import { readFileSync, existsSync, readdirSync } from "fs";
+import { resolve, dirname, join, sep, extname } from "path";
+
+interface VerifyOptions {
+  srcDir: string;
+  messagesDir: string;
+}
+
+interface KeyLocation {
+  key: string;
+  file: string;
+  line: number;
+}
+
+function findMessagesDir(startDir: string): string | null {
+  let dir = resolve(startDir);
+  while (dir !== dirname(dir)) {
+    const messagesPath = join(dir, "messages");
+    if (existsSync(messagesPath)) return messagesPath;
+    dir = dirname(dir);
+  }
+  return null;
+}
+
+function getSourceFiles(dir: string): string[] {
+  const results: string[] = [];
+  const entries = readdirSync(dir, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const fullPath = join(dir, entry.name);
+    if (entry.isDirectory()) {
+      if (
+        entry.name === "node_modules" ||
+        entry.name === "dist" ||
+        entry.name === "build" ||
+        entry.name === ".next" ||
+        entry.name.startsWith(".")
+      ) {
+        continue;
+      }
+      results.push(...getSourceFiles(fullPath));
+    } else if (entry.isFile()) {
+      const ext = extname(entry.name);
+      if (ext === ".ts" || ext === ".tsx" || ext === ".js" || ext === ".jsx") {
+        results.push(fullPath);
+      }
+    }
+  }
+
+  return results;
+}
+
+function loadTranslations(messagesDir: string): Record<string, Record<string, unknown>> {
+  const files = readdirSync(messagesDir).filter((f) => f.endsWith(".json"));
+  const translations: Record<string, Record<string, unknown>> = {};
+
+  for (const file of files) {
+    const locale = file.replace(".json", "");
+    const content = readFileSync(join(messagesDir, file), "utf-8");
+    translations[locale] = JSON.parse(content);
+  }
+
+  return translations;
+}
+
+function getNestedValue(obj: Record<string, unknown>, path: string): unknown {
+  const parts = path.split(".");
+  let current: unknown = obj;
+
+  for (const part of parts) {
+    if (current === null || current === undefined) return undefined;
+    if (typeof current !== "object") return undefined;
+    current = (current as Record<string, unknown>)[part];
+  }
+
+  return current;
+}
+
+function extractNamespace(content: string): string | null {
+  const match = /useTranslations\s*\(\s*["'`]([^"'`]+)["'`]\s*\)/.exec(content);
+  return match ? match[1] : null;
+}
+
+function isInsideStringLiteral(line: string, matchIndex: number): boolean {
+  // Check if the character before t( is inside a string literal
+  const before = line.slice(0, matchIndex);
+  let inSingle = false;
+  let inDouble = false;
+  let escaped = false;
+
+  for (const ch of before) {
+    if (escaped) {
+      escaped = false;
+      continue;
+    }
+    if (ch === "\\") {
+      escaped = true;
+      continue;
+    }
+    if (ch === '"' && !inSingle) {
+      inDouble = !inDouble;
+    } else if (ch === "'" && !inDouble) {
+      inSingle = !inSingle;
+    }
+  }
+
+  return inSingle || inDouble;
+}
+
+function extractTranslationKeys(content: string, namespace: string | null): KeyLocation[] {
+  const lines = content.split("\n");
+  const keys: KeyLocation[] = [];
+  const seen = new Set<string>();
+
+  const regex = /\bt\s*\(\s*["'`]([a-zA-Z0-9_.-]+)["'`]/g;
+
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    // Skip comment-only lines
+    const codePart = line.split("//")[0];
+    if (!codePart.includes("t(")) continue;
+
+    let match: RegExpExecArray | null;
+    while ((match = regex.exec(line)) !== null) {
+      if (isInsideStringLiteral(line, match.index)) continue;
+
+      const rawKey = match[1];
+      const key = namespace ? `${namespace}.${rawKey}` : rawKey;
+      if (!seen.has(key)) {
+        seen.add(key);
+        keys.push({ key, file: "", line: i + 1 });
+      }
+    }
+  }
+
+  return keys;
+}
+
+export function verifyI18nCommand(options: Partial<VerifyOptions> = {}): void {
+  const srcDir = options.srcDir || process.cwd();
+  const messagesDir = options.messagesDir || findMessagesDir(srcDir);
+
+  if (!messagesDir) {
+    console.error("❌ messages/ directory not found. Run this from a project root.");
+    process.exit(1);
+  }
+
+  const translations = loadTranslations(messagesDir);
+  const locales = Object.keys(translations);
+
+  if (locales.length === 0) {
+    console.error("❌ No translation files found in messages/ directory.");
+    process.exit(1);
+  }
+
+  const files = getSourceFiles(srcDir);
+  const allKeys: Map<string, Array<{ file: string; line: number }>> = new Map();
+
+  for (const file of files) {
+    const content = readFileSync(file, "utf-8");
+    const namespace = extractNamespace(content);
+    const keys = extractTranslationKeys(content, namespace);
+    for (const { key, line } of keys) {
+      const list = allKeys.get(key) || [];
+      list.push({ file, line });
+      allKeys.set(key, list);
+    }
+  }
+
+  if (allKeys.size === 0) {
+    console.log("ℹ️  No translation keys found in source files.");
+    return;
+  }
+
+  const missingByLocale: Map<string, KeyLocation[]> = new Map();
+
+  for (const [key, locations] of allKeys) {
+    for (const locale of locales) {
+      const value = getNestedValue(translations[locale], key);
+      if (value === undefined) {
+        const list = missingByLocale.get(locale) || [];
+        list.push({ key, file: locations[0].file, line: locations[0].line });
+        missingByLocale.set(locale, list);
+      }
+    }
+  }
+
+  const totalMissing = Array.from(missingByLocale.values()).reduce((sum, list) => sum + list.length, 0);
+
+  if (totalMissing === 0) {
+    console.log(`✅ All ${allKeys.size} translation key(s) exist in every locale (${locales.join(", ")}).`);
+    return;
+  }
+
+  console.log(`⚠️  Found ${totalMissing} missing translation key(s):\n`);
+
+  for (const [locale, missing] of missingByLocale) {
+    if (missing.length === 0) continue;
+    console.log(`  🌐 ${locale}.json (${missing.length} missing):`);
+    for (const { key, file, line } of missing.slice(0, 10)) {
+      const relPath = file.replace(srcDir + sep, "").replace(/^\//, "");
+      console.log(`     - ${key}`);
+      console.log(`       used in: ${relPath}:${line}`);
+    }
+    if (missing.length > 10) {
+      console.log(`       ... and ${missing.length - 10} more`);
+    }
+    console.log("");
+  }
+
+  console.log(`Add the missing keys to all ${locales.length} locale files.\n`);
+  process.exit(1);
+}

package/assets/commands/verify-imports.ts

@@ -0,0 +1,256 @@
+import { readFileSync, existsSync, readdirSync } from "fs";
+import { resolve, dirname, join, sep, extname } from "path";
+
+interface VerifyOptions {
+  srcDir: string;
+  packageJsonPath: string;
+}
+
+interface ImportInfo {
+  path: string;
+  line: number;
+  source: string;
+}
+
+const NODE_BUILTINS = new Set([
+  "assert", "async_hooks", "buffer", "child_process", "cluster", "console",
+  "constants", "crypto", "dgram", "diagnostics_channel", "dns", "domain",
+  "events", "fs", "http", "http2", "https", "inspector", "module", "net",
+  "os", "path", "perf_hooks", "process", "punycode", "querystring", "readline",
+  "repl", "stream", "string_decoder", "sys", "timers", "timers/promises",
+  "tls", "trace_events", "tty", "url", "util", "v8", "vm", "wasi", "worker_threads",
+  "zlib", "node:test",
+]);
+
+function findPackageJson(startDir: string): string | null {
+  let dir = resolve(startDir);
+  while (dir !== dirname(dir)) {
+    const pkgPath = join(dir, "package.json");
+    if (existsSync(pkgPath)) return pkgPath;
+    dir = dirname(dir);
+  }
+  return null;
+}
+
+function findTsConfig(startDir: string): string | null {
+  let dir = resolve(startDir);
+  while (dir !== dirname(dir)) {
+    const tsPath = join(dir, "tsconfig.json");
+    if (existsSync(tsPath)) return tsPath;
+    dir = dirname(dir);
+  }
+  return null;
+}
+
+function getInstalledPackages(packageJsonPath: string): Set<string> {
+  const pkg = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+  const deps = Object.keys(pkg.dependencies || {});
+  const devDeps = Object.keys(pkg.devDependencies || {});
+  const peerDeps = Object.keys(pkg.peerDependencies || {});
+  const optionalDeps = Object.keys(pkg.optionalDependencies || {});
+  return new Set([...deps, ...devDeps, ...peerDeps, ...optionalDeps]);
+}
+
+function getPathAliases(tsConfigPath: string): string[] {
+  try {
+    const raw = readFileSync(tsConfigPath, "utf-8");
+    // Extract path aliases via regex — tolerant to comments and trailing commas
+    const aliases: string[] = [];
+    // Match patterns like "@core/*" or "@/components/*" inside "paths": { ... }
+    const pathsMatch = raw.match(/"paths"\s*:\s*\{([\s\S]*?)\}/);
+    if (pathsMatch) {
+      const pathsBlock = pathsMatch[1];
+      const keyRegex = /"(@[^"]+)"\s*:/g;
+      let m: RegExpExecArray | null;
+      while ((m = keyRegex.exec(pathsBlock)) !== null) {
+        aliases.push(m[1]);
+      }
+    }
+    return aliases.length > 0 ? aliases : ["@/*"];
+  } catch {
+    return ["@/*"];
+  }
+}
+
+function isPathAlias(source: string, aliases: string[]): boolean {
+  for (const alias of aliases) {
+    const prefix = alias.replace(/\/\*$/, "");
+    if (alias.endsWith("/*")) {
+      if (source === prefix || source.startsWith(prefix + "/")) {
+        return true;
+      }
+    } else {
+      if (source === alias) {
+        return true;
+      }
+    }
+  }
+  return false;
+}
+
+function getSourceFiles(dir: string): string[] {
+  const results: string[] = [];
+  const entries = readdirSync(dir, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const fullPath = join(dir, entry.name);
+    if (entry.isDirectory()) {
+      if (
+        entry.name === "node_modules" ||
+        entry.name === "dist" ||
+        entry.name === "build" ||
+        entry.name === ".next" ||
+        entry.name.startsWith(".")
+      ) {
+        continue;
+      }
+      results.push(...getSourceFiles(fullPath));
+    } else if (entry.isFile()) {
+      const ext = extname(entry.name);
+      if (ext === ".ts" || ext === ".tsx" || ext === ".js" || ext === ".jsx") {
+        results.push(fullPath);
+      }
+    }
+  }
+
+  return results;
+}
+
+function extractImports(filePath: string): ImportInfo[] {
+  const content = readFileSync(filePath, "utf-8");
+  const lines = content.split("\n");
+  const imports: ImportInfo[] = [];
+
+  // Matches single-line imports: import ... from "..."
+  const singleLineRegex = /^(?:import\s+.*?from\s+|import\s*\(|require\s*\()["']([^"';]+)["'];?/;
+
+  // Matches multi-line import end: from "..."
+  const multiLineEndRegex = /from\s+["']([^"';]+)["'];?/;
+
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i].trim();
+    const singleMatch = singleLineRegex.exec(line);
+    if (singleMatch) {
+      imports.push({ path: filePath, line: i + 1, source: singleMatch[1] });
+      continue;
+    }
+    // Multi-line import: starts with "import" but no "from" on same line
+    if (line.startsWith("import") && !line.includes("from") && !line.includes("(")) {
+      // Look ahead up to 5 lines for "from '...'"
+      for (let j = i + 1; j < Math.min(i + 6, lines.length); j++) {
+        const nextLine = lines[j].trim();
+        const multiMatch = multiLineEndRegex.exec(nextLine);
+        if (multiMatch) {
+          imports.push({ path: filePath, line: j + 1, source: multiMatch[1] });
+          break;
+        }
+        if (nextLine.endsWith(";")) break; // End of import without from
+      }
+    }
+  }
+
+  return imports;
+}
+
+function resolvePackageName(source: string): string | null {
+  if (source.startsWith(".") || source.startsWith("/")) return null;
+  if (source.startsWith("node:")) return null;
+  if (source.startsWith("@/")) return null;
+
+  if (source.startsWith("@")) {
+    const parts = source.split("/");
+    return parts.length >= 2 ? `${parts[0]}/${parts[1]}` : null;
+  }
+
+  const idx = source.indexOf("/");
+  return idx > 0 ? source.slice(0, idx) : source;
+}
+
+function isNodeBuiltin(pkg: string): boolean {
+  return NODE_BUILTINS.has(pkg) || NODE_BUILTINS.has(`node:${pkg}`);
+}
+
+function detectPackageManager(lockFiles: string[]): "npm" | "yarn" | "pnpm" | "bun" | "unknown" {
+  if (lockFiles.some((f) => f.endsWith("bun.lockb"))) return "bun";
+  if (lockFiles.some((f) => f.endsWith("pnpm-lock.yaml"))) return "pnpm";
+  if (lockFiles.some((f) => f.endsWith("yarn.lock"))) return "yarn";
+  if (lockFiles.some((f) => f.endsWith("package-lock.json"))) return "npm";
+  return "unknown";
+}
+
+export function verifyImportsCommand(options: Partial<VerifyOptions> = {}): void {
+  const srcDir = options.srcDir || process.cwd();
+  const packageJsonPath = options.packageJsonPath || findPackageJson(srcDir);
+
+  if (!packageJsonPath) {
+    console.error("❌ package.json not found. Run this from a project root.");
+    process.exit(1);
+  }
+
+  const installed = getInstalledPackages(packageJsonPath);
+  const projectRoot = dirname(packageJsonPath);
+
+  const tsConfigPath = findTsConfig(srcDir);
+  const pathAliases = tsConfigPath ? getPathAliases(tsConfigPath) : [];
+
+  const lockFiles = ["package-lock.json", "yarn.lock", "pnpm-lock.yaml", "bun.lockb"].map((f) =>
+    join(projectRoot, f)
+  );
+  const existingLocks = lockFiles.filter((f) => existsSync(f));
+  const pkgManager = detectPackageManager(existingLocks);
+
+  const files = getSourceFiles(srcDir);
+
+  const allImports: ImportInfo[] = [];
+  for (const file of files) {
+    allImports.push(...extractImports(file));
+  }
+
+  const missing: Map<string, ImportInfo[]> = new Map();
+
+  for (const imp of allImports) {
+    if (isPathAlias(imp.source, pathAliases)) continue;
+
+    const pkg = resolvePackageName(imp.source);
+    if (!pkg) continue;
+    if (isNodeBuiltin(pkg)) continue;
+    if (installed.has(pkg)) continue;
+
+    const list = missing.get(pkg) || [];
+    list.push(imp);
+    missing.set(pkg, list);
+  }
+
+  if (missing.size === 0) {
+    console.log(`✅ All imports resolve to installed packages (${allImports.length} imports checked).`);
+    return;
+  }
+
+  console.log(`⚠️  Found ${missing.size} missing package(s):\n`);
+
+  for (const [pkg, imports] of missing) {
+    console.log(`  📦 ${pkg}`);
+    console.log(`     Used in:`);
+    for (const imp of imports.slice(0, 3)) {
+      const relPath = imp.path.replace(projectRoot + sep, "").replace(/^\//, "");
+      console.log(`       - ${relPath}:${imp.line}  →  import from "${imp.source}"`);
+    }
+    if (imports.length > 3) {
+      console.log(`       ... and ${imports.length - 3} more`);
+    }
+
+    const installCmd =
+      pkgManager === "bun"
+        ? `bun add ${pkg}`
+        : pkgManager === "pnpm"
+          ? `pnpm add ${pkg}`
+          : pkgManager === "yarn"
+            ? `yarn add ${pkg}`
+            : `npm install ${pkg}`;
+
+    console.log(`     Install: ${installCmd}\n`);
+  }
+
+  console.log(`Run the install command(s) above, then re-run this check.\n`);
+  process.exit(1);
+}

package/assets/data/anti-patterns.csv

@@ -53,3 +53,6 @@ id,area,bad_pattern,why_bad,fix
 52,Charts,No empty state for charts with zero data points,Empty chart looks broken or crashes chart library,Show empty state illustration or zero baseline when no data
 53,Charts,Using real-time updates without transition animations,Jarring jumps in chart data poor perceived performance,Use Recharts animation or smooth transitions for live data updates
 54,Charts,Fetching all chart data on every small filter change,Excessive API calls slow performance backend overload,Debounce filter changes use TanStack Query staleTime cache filter state in URL
+55,Dependencies,Adding new imports without verifying the package is installed,Build fails in CI or for teammates TypeScript errors runtime crashes silent failures,Always check package.json before adding an import If package is missing ask user for confirmation then install with the correct package manager
+57,Dependencies,Adding translation keys in source code without updating all locale files,Users see raw keys or missing text in unsupported languages breaks i18n contract,When adding t(key) always add the key to every messages locale file Run verify-i18n to check
+56,i18n,Adding translation keys in code without updating all locale files,Users see raw keys or missing text in unsupported languages breaks i18n contract,When adding t(key) always add the key to every messages locale file Run verify-i18n to check

package/assets/data/charts.csv

@@ -11,7 +11,7 @@ id,chart_type,library,use_case,admin_context,best_for_data,avoid_when
 10,Heatmap,ApexCharts / MUI X-Charts,Density matrix,User activity by hour/day correlation matrix,Finding patterns in dense data,Simple sparse data
 11,Scatter Plot,Recharts / ApexCharts,Correlation analysis,Price vs sales customer age vs spend,Finding relationships clusters outliers,Single variable data
 12,Bubble Chart,Recharts / ApexCharts,3-variable correlation,Deal size vs probability vs revenue impact,Adding size dimension to scatter,Too many bubbles overlap
-13,Candlestick,ApexCharts / MUI X-Charts,Financial OHLC,Stock price crypto forex trading data,Open high low close financial data,Non-financial contexts
+13,Candlestick,ApexCharts,Financial OHLC,Stock price crypto forex trading data,Open high low close financial data,Non-financial contexts
 14,Sparkline,Recharts / ApexCharts,Mini trend inline,Table row mini chart card header trend,Quick trend in small space,Detailed analysis needed
 15,Gauge Chart,ApexCharts / MUI X-Charts,Single KPI progress,CPU usage disk space quota utilization,0-100% progress toward goal,Multiple metrics
 16,Funnel Chart,Recharts / ApexCharts,Conversion stages,Sales pipeline recruitment funnel drop-off,Sequential stages with drop-off,Non-sequential data

package/assets/data/industries.csv

@@ -1,16 +1,16 @@
 id,industry,display_name,pattern,style_priority,color_mood,typography_mood,key_effects,anti_patterns
 1,saas,SaaS / B2B Platform,Feature-Rich Dashboard + Onboarding,bento-grid minimalism soft-ui,Clean blues + white + accent purple,Inter / Public Sans sans-serif,Micro-interactions smooth transitions 200ms subtle shadows,Skeuomorphism bright neon colors cluttered hero slow animations
-2,fintech,Fintech / Banking,Data-Dense Dashboard + Transaction Table,minimalism dark-mode-optional glassmorphism,Deep navy + emerald green + gold accents,Plus Jakarta Sans / DM Sans modern geometric,Real-time data updates subtle pulse animations card hover elevation,Playful colors rounded corners everywhere emoji icons insufficient contrast
+2,fintech,Fintech / Banking,Data-Dense Dashboard + Transaction Table,minimalism dark-mode glassmorphism,Deep navy + emerald green + gold accents,Plus Jakarta Sans / DM Sans modern geometric,Real-time data updates subtle pulse animations card hover elevation,Playful colors rounded corners everywhere emoji icons insufficient contrast
 3,healthcare,Healthcare / Medical,Patient List + Appointment Calendar + Charts,minimalism accessible soft-ui,Soft teal + white + warm gray + alert red,Open Sans / Roboto highly readable,Clear visual hierarchy status badges with icons gentle transitions,Small text poor contrast complex medical jargon without tooltips missing loading states
 4,ecommerce,E-commerce Admin,Order Management + Inventory Grid + Sales Charts,bento-grid data-dense,Orange accent + white + dark sidebar + success green,Inter / Source Sans Pro clean functional,Quick actions contextual menus real-time stock indicators,Bright sales-y colors distracting animations missing empty states for out-of-stock
-5,logistics,Logistics / Supply Chain,Map + Shipment Tracker + Fleet Table,real-time-monitoring glassmorphism,Deep blue + bright cyan + warning amber + map green,Roboto Mono / Inter monospace for tracking IDs,Map integrations timeline views live status indicators,Cluttered maps poor mobile experience missing offline indicators
+5,logistics,Logistics / Supply Chain,Map + Shipment Tracker + Fleet Table,real-time glassmorphism,Deep blue + bright cyan + warning amber + map green,Roboto Mono / Inter monospace for tracking IDs,Map integrations timeline views live status indicators,Cluttered maps poor mobile experience missing offline indicators
 6,hr,HR / People Management,Employee Directory + Org Chart + Payroll Table,minimalism soft-ui bento-grid,Warm purple + soft gray + white + status colors,Work Sans / Lato friendly professional,Profile cards org tree visualizations approval workflows,Overly casual fonts missing privacy indicators complex navigation too many clicks
 7,crm,CRM / Sales,Pipeline Board + Contact List + Activity Feed,bento-grid soft-ui,Electric blue + white + warm gray + deal stage colors,Inter / SF Pro clean crisp,Drag-drop pipeline activity timelines win/loss indicators,Missing empty pipeline states poor mobile card layout overwhelming notifications
 8,erp,ERP / Manufacturing,Production Dashboard + Inventory + BOM Table,data-dense executive,Industrial gray + safety orange + machine blue + alert red,IBM Plex Sans / Roboto technical precise,Machine status gauges production line visuals alert banners,Overly decorative fonts cluttered tables missing real-time indicators slow refresh
 9,education,Education / LMS,Course List + Student Progress + Gradebook,minimalism accessible soft-ui,Academic blue + warm white + success green + caution amber,Lora / Open Sans readable elegant,Progress bars achievement badges calendar views,Childish fonts excessive gamification poor accessibility missing progress persistence
-10,government,Government / Public Sector,Case Management + Document List + Reporting,minimalism accessible flat-design,Official blue + white + gray + priority red,Merriweather / Open Sans formal trustworthy,Clear status workflows document version tracking audit trails,Political colors overly modern flashy design missing WCAG compliance complex language
-11,cybersecurity,Cybersecurity / SOC,Alert Feed + Threat Map + Incident Table,dark-mode hud-scifi,Deep black + alert red + cyber cyan + warning amber,Fira Code / Inter monospace for logs technical,Dark theme real-time alerts threat level indicators SOC timeline,Light theme by default poor alert visibility cluttered dashboards missing severity colors
+10,government,Government / Public Sector,Case Management + Document List + Reporting,minimalism accessible,Official blue + white + gray + priority red,Merriweather / Open Sans formal trustworthy,Clear status workflows document version tracking audit trails,Political colors overly modern flashy design missing WCAG compliance complex language
+11,cybersecurity,Cybersecurity / SOC,Alert Feed + Threat Map + Incident Table,dark-mode ai-native,Deep black + alert red + cyber cyan + warning amber,Fira Code / Inter monospace for logs technical,Dark theme real-time alerts threat level indicators SOC timeline,Light theme by default poor alert visibility cluttered dashboards missing severity colors
 12,real-estate,Real Estate / Property,Property Grid + Map + Lead Pipeline,bento-grid soft-ui,Premium navy + gold accent + white + status green,Playfair Display / Inter luxury clean,Property cards map pins lead scoring visual comparison tools,Excessive imagery poor table performance missing price formatting cluttered filters
-13,energy,Energy / Utilities,Grid Monitor + Meter Readings + Outage Map,real-time-monitoring data-dense,Power blue + grid yellow + outage red + eco green,Roboto / Source Sans Pro technical functional,Real-time gauges geographic outage maps consumption charts,Missing time-series data poor mobile map experience slow data refresh
+13,energy,Energy / Utilities,Grid Monitor + Meter Readings + Outage Map,real-time data-dense,Power blue + grid yellow + outage red + eco green,Roboto / Source Sans Pro technical functional,Real-time gauges geographic outage maps consumption charts,Missing time-series data poor mobile map experience slow data refresh
 14,media,Media / Content Management,Asset Library + Editorial Calendar + Analytics,minimalism bento-grid,Dark charcoal + vibrant accent + white + video red,Montserrat / Inter modern dynamic,Media previews drag-drop upload editorial timeline engagement charts,Cluttered asset grids missing metadata poor search missing preview thumbnails
 15,nonprofit,Nonprofit / NGO,Donor CRM + Campaign Tracker + Impact Dashboard,soft-ui accessible minimalism,Hope blue + growth green + warm white + heart red,Merriweather / Lora trustworthy warm,Donor profiles campaign progress impact visualization volunteer management,Overly corporate design missing donation CTAs poor mobile donation flow complex reporting

package/assets/data/pre-delivery-checklist.csv

@@ -34,3 +34,9 @@ id,page_type,check,severity,why_it_matters
 33,auth,Password visibility toggle present,Medium,Improves UX for password entry
 34,auth,Form focuses first input on load,Low,Small UX improvement for keyboard users
 35,auth,Social login buttons match brand colors,Low,Visual consistency with external services
+36,dependencies,All new imports resolve to installed packages,High,Missing packages break builds and CI
+37,dependencies,No unused imports or dead dependencies,Medium,Bloats bundle and confuses developers
+38,dependencies,Package manager lockfile is in sync with package.json,High,Prevents inconsistent installs across environments
+39,i18n,All translation keys exist in every locale file,High,Missing keys show raw text to users
+40,i18n,No hardcoded user-facing strings outside t() calls,High,Breaks multi-language support
+41,i18n,New translation keys added to all messages files before commit,High,Prevents incomplete translations

package/assets/data/review-rubric.csv

@@ -1,6 +1,6 @@
 id,category,score_1_3,score_4_6,score_7_8,score_9_10
-1,Premium Admin Visual Quality,Layout is broken or unrecognizable as admin UI; no cards; random spacing,Cards present but inconsistent; spacing varies; some hierarchy; looks like generic AntD,Clean card hierarchy; consistent spacing; feels like admin panel; status chips styled,Premium Enterprise admin feel; balanced rhythm; excellent hierarchy; polished status and actions; visually cohesive
-2,AntD Architecture Quality,No typed props; inline everything; no reusable components; raw AntD dumped,Some abstractions; partial types; mixed patterns; inconsistent API surfaces,Good component boundaries; typed props; consistent Form/Table patterns; token usage,Excellent architecture; predictable APIs; disciplined abstractions; token-first; fully typed
+1,Premium Admin Visual Quality,Layout is broken or unrecognizable as admin UI; no cards; random spacing,Cards present but inconsistent; spacing varies; some hierarchy; looks like generic MUI,Clean card hierarchy; consistent spacing; feels like admin panel; status chips styled,Premium Enterprise admin feel; balanced rhythm; excellent hierarchy; polished status and actions; visually cohesive
+2,MUI Architecture Quality,No typed props; inline everything; no reusable components; raw MUI dumped,Some abstractions; partial types; mixed patterns; inconsistent API surfaces,Good component boundaries; typed props; consistent Form/Table patterns; token usage,Excellent architecture; predictable APIs; disciplined abstractions; token-first; fully typed
 3,Component Reusability,Everything inline; copy-paste patterns; no shared UI primitives,Some shared components but inconsistent props; magic numbers; hardcoded text,Reusable PageLayout Card Table Form primitives; configurable via props,Highly reusable system; composable patterns; design-token driven; minimal duplication
 4,Form Quality,No validation; no loading; no feedback; inline styles; missing labels,Basic validation; some feedback; inconsistent layout; partial loading state,Full typed Form; validation rules; helper text; dirty guard; responsive grid,Enterprise form discipline; accessible labels; clear errors; submit loading; cancel/reset; sectioned layout
 5,Table Quality,No pagination; no sorting; no rowKey; no empty state; inline columns,Basic table with some features; missing loading or error state; hardcoded columns,Typed columns; loading/empty/error; pagination; sorting; row actions; responsive plan,Production table standard; server-side ready; accessible headers; status tags; formatted values; bulk actions