@soulbatical/tetra-dev-toolkit 1.20.25 → 1.20.26

package/lib/checks/codeQuality/next-route-coverage.js

@@ -0,0 +1,337 @@
+/**
+ * Code Quality Check: Next.js Route Coverage
+ *
+ * Detects gaps in the Next.js App Router page structure that produce silent 404s
+ * or unreachable routes — bugs that look like successful builds but serve 404
+ * responses or blank pages.
+ *
+ * WHAT IT CATCHES:
+ *
+ *   1. Layout without index page — the "/app 404 bug":
+ *      A layout.tsx exists at a route segment but there is no page.tsx at the
+ *      same level AND no immediate child segment with a page.tsx.
+ *      e.g. /app/layout.tsx exists, /app/page.tsx missing → visiting /app gives 404.
+ *
+ *   2. Navigation links pointing to non-existent pages:
+ *      Reads appConfig.navigation from frontend/src/app/app/app-config.tsx (or
+ *      app/app/app-config.tsx), extracts href values, and checks each href maps
+ *      to a real page.tsx file on disk.
+ *
+ * HOW IT WORKS:
+ *   1. Finds all layout.tsx files under src/app/ or app/
+ *   2. For each layout, checks for page.tsx at the same level
+ *   3. If missing, checks immediate children for page.tsx (redirect pattern is OK)
+ *   4. Reads app-config.tsx, extracts href strings from navigation config
+ *   5. Maps each href to a filesystem path and verifies page.tsx exists
+ *
+ * Severity: high — layout-without-page causes a silent 404 that bypasses all
+ *           error monitoring (Next.js returns 200 for some 404 variants)
+ */
+
+import { readFileSync, existsSync } from 'fs'
+import { join, dirname, relative, basename } from 'path'
+import { glob } from 'glob'
+
+// ============================================================================
+// META
+// ============================================================================
+
+export const meta = {
+  id: 'next-route-coverage',
+  name: 'Next.js route coverage',
+  category: 'codeQuality',
+  severity: 'high',
+  description: 'Detects layout.tsx files without a reachable page.tsx, and navigation links pointing to non-existent pages'
+}
+
+// ============================================================================
+// CONSTANTS
+// ============================================================================
+
+const IGNORE_PATTERNS = [
+  '**/node_modules/**',
+  '**/.next/**',
+  '**/dist/**',
+  '**/build/**',
+]
+
+// ============================================================================
+// HELPERS
+// ============================================================================
+
+function rel(projectRoot, absPath) {
+  return relative(projectRoot, absPath)
+}
+
+/**
+ * Find the Next.js app directory root — either frontend/src/app or src/app or app
+ * Returns the absolute path to the app directory, or null if not a Next.js project.
+ */
+function findAppDir(projectRoot) {
+  const candidates = [
+    join(projectRoot, 'frontend', 'src', 'app'),
+    join(projectRoot, 'src', 'app'),
+    join(projectRoot, 'app'),
+  ]
+  for (const candidate of candidates) {
+    if (existsSync(candidate)) return candidate
+  }
+  return null
+}
+
+/**
+ * Given an app directory root and a layout.tsx absolute path, return the
+ * corresponding route segment path (relative to the app root).
+ * e.g. /project/frontend/src/app/app/layout.tsx → /app
+ */
+function layoutToRoutePath(appDir, layoutAbsPath) {
+  const segmentDir = dirname(layoutAbsPath)
+  const rel = relative(appDir, segmentDir)
+  // Normalize to URL-like path
+  const urlPath = '/' + rel.replace(/\\/g, '/').replace(/^\.?\/?/, '')
+  return urlPath === '/.' || urlPath === '/' ? '/' : urlPath.replace(/\/$/, '')
+}
+
+/**
+ * Given a route path (e.g. "/app/dashboard"), return the expected page.tsx
+ * absolute path on disk.
+ */
+function routeToPagePath(appDir, routePath) {
+  const segments = routePath.replace(/^\//, '').split('/')
+  return join(appDir, ...segments, 'page.tsx')
+}
+
+/**
+ * Check if a directory has any immediate child directories containing page.tsx
+ * (catches the redirect pattern: layout.tsx + child/page.tsx, no index page.tsx)
+ */
+function hasChildPage(segmentDir) {
+  const childPages = glob.sync('*/page.tsx', {
+    cwd: segmentDir,
+    absolute: false,
+  })
+  return childPages.length > 0
+}
+
+/**
+ * Extract href values from an app-config.tsx navigation array.
+ *
+ * Looks for patterns like:
+ *   href: '/app/dashboard'
+ *   href: "/app/health"
+ *
+ * Returns array of { href, line } objects.
+ */
+function extractNavHrefs(content) {
+  const results = []
+  const lines = content.split('\n')
+  const hrefRe = /href\s*:\s*['"]([^'"]+)['"]/
+
+  for (let i = 0; i < lines.length; i++) {
+    const m = lines[i].match(hrefRe)
+    if (m) {
+      results.push({ href: m[1], line: i + 1 })
+    }
+  }
+  return results
+}
+
+/**
+ * Find the app-config file (app-config.tsx or app-config.ts) anywhere under
+ * the app directory. Returns null if not found.
+ */
+function findAppConfig(projectRoot) {
+  const candidates = glob.sync('**/app-config.{tsx,ts}', {
+    cwd: projectRoot,
+    ignore: IGNORE_PATTERNS,
+    absolute: true,
+  })
+  // Prefer frontend/src/app/app/app-config.tsx
+  return candidates[0] ?? null
+}
+
+// ============================================================================
+// MAIN CHECK
+// ============================================================================
+
+export async function run(config, projectRoot) {
+  const result = {
+    passed: true,
+    findings: [],
+    summary: { total: 0, critical: 0, high: 0, medium: 0, low: 0 },
+    details: {
+      layoutsChecked: 0,
+      layoutsWithoutPage: 0,
+      navLinksChecked: 0,
+      navLinksBroken: 0,
+    }
+  }
+
+  // ── Step 1: find the Next.js app directory ────────────────────────────────
+
+  const appDir = findAppDir(projectRoot)
+  if (!appDir) {
+    result.findings.push({
+      file: 'project',
+      line: 0,
+      severity: 'low',
+      message: 'next-route-coverage: no Next.js app directory found (checked src/app, frontend/src/app, app/) — check skipped',
+    })
+    result.summary.low++
+    result.summary.total++
+    return result
+  }
+
+  // ── Step 2: find all layout.tsx files ─────────────────────────────────────
+
+  const layoutFiles = glob.sync('**/layout.tsx', {
+    cwd: appDir,
+    ignore: ['**/node_modules/**'],
+    absolute: true,
+  })
+
+  result.details.layoutsChecked = layoutFiles.length
+
+  for (const layoutAbsPath of layoutFiles) {
+    const segmentDir = dirname(layoutAbsPath)
+    const routePath = layoutToRoutePath(appDir, layoutAbsPath)
+    const relLayout = rel(projectRoot, layoutAbsPath)
+
+    // Check for page.tsx at the same level as this layout
+    const pagePath = join(segmentDir, 'page.tsx')
+    const hasPage = existsSync(pagePath)
+
+    if (hasPage) continue
+
+    // No page.tsx at this level — check for immediate child page.tsx
+    // (a layout that only redirects to a child is acceptable)
+    const childPages = glob.sync('*/page.tsx', {
+      cwd: segmentDir,
+      absolute: false,
+    })
+    const hasImmediateChildPage = childPages.length > 0
+
+    if (hasImmediateChildPage) {
+      // Soft warn: layout exists, no index page but children exist
+      // This is fine only if there's an explicit redirect from this route
+      // Check if there's a redirect in the layout or if this is a known redirect pattern
+      let layoutContent = ''
+      try { layoutContent = readFileSync(layoutAbsPath, 'utf-8') } catch { /* ignore */ }
+
+      const hasRedirect = layoutContent.includes('redirect(') || layoutContent.includes('permanentRedirect(')
+
+      if (!hasRedirect) {
+        result.summary.medium++
+        result.summary.total++
+
+        result.findings.push({
+          file: relLayout,
+          line: 0,
+          severity: 'medium',
+          message: [
+            `Layout without index page — visiting "${routePath}" returns 404:`,
+            `  Layout:  ${relLayout}`,
+            `  Route:   ${routePath}`,
+            `  Missing: ${rel(projectRoot, pagePath)}`,
+            ``,
+            `  The layout has child segments (${childPages.slice(0, 3).join(', ')}${childPages.length > 3 ? '...' : ''})`,
+            `  but no page.tsx at "${routePath}" itself.`,
+            ``,
+            `  Fix option 1: create ${rel(projectRoot, pagePath)} with a redirect:`,
+            `    import { redirect } from 'next/navigation'`,
+            `    export default function Page() { redirect('${routePath}/${childPages[0].replace('/page.tsx', '')}') }`,
+            `  Fix option 2: add redirect() in the layout component`,
+          ].join('\n'),
+          fix: `Create page.tsx at "${routePath}" with redirect to first child, or add redirect() to layout`,
+        })
+      }
+      continue
+    }
+
+    // No page.tsx AND no child pages — this route is completely unreachable
+    result.details.layoutsWithoutPage++
+    result.passed = false
+    result.summary.high++
+    result.summary.total++
+
+    result.findings.push({
+      file: relLayout,
+      line: 0,
+      severity: 'high',
+      message: [
+        `Layout without any reachable page — this route is a dead end:`,
+        `  Layout:  ${relLayout}`,
+        `  Route:   ${routePath}`,
+        `  Missing: ${rel(projectRoot, pagePath)}`,
+        ``,
+        `  Visiting "${routePath}" will return 404 with no error in logs.`,
+        `  Next.js renders the layout but has no page component to render.`,
+        ``,
+        `  Fix: create ${rel(projectRoot, pagePath)}`,
+        `    export default function Page() {`,
+        `      return <div>Welcome to ${routePath}</div>`,
+        `    }`,
+      ].join('\n'),
+      fix: `Create page.tsx at ${rel(projectRoot, pagePath)}`,
+    })
+  }
+
+  // ── Step 3: check navigation links ────────────────────────────────────────
+
+  const appConfigPath = findAppConfig(projectRoot)
+  if (appConfigPath) {
+    let content
+    try { content = readFileSync(appConfigPath, 'utf-8') } catch { content = null }
+
+    if (content) {
+      const hrefs = extractNavHrefs(content)
+      result.details.navLinksChecked = hrefs.length
+
+      for (const { href, line } of hrefs) {
+        // Skip external URLs and anchors
+        if (!href.startsWith('/') || href.includes('://')) continue
+
+        // Remove query strings and hash fragments for path checking
+        const cleanHref = href.split('?')[0].split('#')[0]
+
+        const expectedPage = routeToPagePath(appDir, cleanHref)
+        if (!existsSync(expectedPage)) {
+          // Also check for dynamic route variants: [id]/page.tsx, [slug]/page.tsx
+          const segments = cleanHref.replace(/^\//, '').split('/')
+          const parentDir = join(appDir, ...segments.slice(0, -1))
+          const dynamicCandidates = glob.sync('[*]/page.tsx', {
+            cwd: parentDir,
+            absolute: false,
+          })
+
+          // If dynamic route exists, this is fine
+          if (dynamicCandidates.length > 0) continue
+
+          result.details.navLinksBroken++
+          result.passed = false
+          result.summary.high++
+          result.summary.total++
+
+          result.findings.push({
+            file: rel(projectRoot, appConfigPath),
+            line,
+            severity: 'high',
+            message: [
+              `Navigation link points to non-existent page:`,
+              `  Config:   ${rel(projectRoot, appConfigPath)}:${line}`,
+              `  href:     ${href}`,
+              `  Expected: ${rel(projectRoot, expectedPage)}`,
+              ``,
+              `  This nav item will lead to a 404. Either create the page or remove the nav link.`,
+              ``,
+              `  Fix: create ${rel(projectRoot, expectedPage)}`,
+            ].join('\n'),
+            fix: `Create ${rel(projectRoot, expectedPage)} or remove href "${href}" from navigation config`,
+          })
+        }
+      }
+    }
+  }
+
+  return result
+}

package/lib/checks/codeQuality/tetra-ui-ssr-safe-imports.js

@@ -0,0 +1,335 @@
+/**
+ * Code Quality Check: Tetra-UI SSR-Safe Imports
+ *
+ * Next.js server-side rendering (SSR) fails silently when browser-only code
+ * is imported in a server context: "window is not defined" at runtime, or
+ * hydration mismatches that log warnings but do not crash immediately.
+ *
+ * WHAT IT CATCHES:
+ *
+ *   1. FAIL: SSR-unsafe barrel import
+ *      File imports WeekCalendar, TeamPlanner, AvailabilityEditor,
+ *      BookingWidget, or usePlannerApi from '@soulbatical/tetra-ui' barrel,
+ *      AND the file is reachable from server rendering (root layout, providers
+ *      file, anything not wrapped in dynamic(() => ..., { ssr: false })).
+ *
+ *   2. WARN: DayPilot webpack alias missing
+ *      A Next.js project imports from the tetra-ui barrel in a 'use client'
+ *      providers file, but next.config.ts does NOT contain the DayPilot
+ *      webpack alias workaround.
+ *
+ *   SSR-unsafe exports (anything that pulls in DayPilot):
+ *     WeekCalendar, TeamPlanner, AvailabilityEditor, BookingWidget,
+ *     usePlannerApi
+ *
+ * HOW IT WORKS:
+ *   1. Find all .tsx/.ts files in the project (excluding node_modules).
+ *   2. For each file that imports from '@soulbatical/tetra-ui':
+ *      a. Parse the imported symbol names.
+ *      b. Check if any are SSR-unsafe.
+ *      c. Determine if the file is "server-reachable":
+ *         - Any layout.tsx or page.tsx without 'use client' at top
+ *         - Any file named providers.tsx / providers.ts
+ *         - Any file that does NOT have 'use client' as first non-blank line
+ *      d. Exclude: files containing dynamic(..., { ssr: false })
+ *   3. Check next.config.ts for the DayPilot alias.
+ *
+ * Severity: high — SSR failures can break entire page renders or cause
+ *           hydration errors that are hard to trace.
+ */
+
+import { readFileSync, existsSync } from 'fs'
+import { join, relative } from 'path'
+import { glob } from 'glob'
+
+// ============================================================================
+// META
+// ============================================================================
+
+export const meta = {
+  id: 'tetra-ui-ssr-safe-imports',
+  name: 'Tetra-UI SSR-safe imports',
+  category: 'codeQuality',
+  severity: 'high',
+  description: 'Detects SSR-unsafe tetra-ui imports (DayPilot planner components) reachable from server-rendered contexts'
+}
+
+// ============================================================================
+// CONSTANTS
+// ============================================================================
+
+const IGNORE_PATTERNS = [
+  '**/node_modules/**',
+  '**/.next/**',
+  '**/dist/**',
+  '**/build/**',
+]
+
+/**
+ * Exports from the @soulbatical/tetra-ui barrel that pull in DayPilot and are
+ * therefore NOT safe to import in server-rendered contexts.
+ */
+const SSR_UNSAFE_EXPORTS = new Set([
+  'WeekCalendar',
+  'TeamPlanner',
+  'AvailabilityEditor',
+  'BookingWidget',
+  'usePlannerApi',
+])
+
+// ============================================================================
+// HELPERS
+// ============================================================================
+
+function relPath(projectRoot, absPath) {
+  return relative(projectRoot, absPath)
+}
+
+/**
+ * Check if a file starts with 'use client' (Next.js client boundary marker).
+ * Ignores leading blank lines and block comments.
+ */
+function hasUseClientDirective(content) {
+  for (const line of content.split('\n')) {
+    const t = line.trim()
+    if (t === '') continue
+    if (t.startsWith('//') || t.startsWith('*') || t.startsWith('/*')) continue
+    return t === "'use client'" || t === '"use client"'
+  }
+  return false
+}
+
+/**
+ * Check if a file contains dynamic(() => ..., { ssr: false }).
+ * Files with this pattern are correctly guarded for SSR.
+ */
+function hasDynamicSsrFalse(content) {
+  return /dynamic\s*\(/.test(content) && /ssr\s*:\s*false/.test(content)
+}
+
+/**
+ * Parse named imports from @soulbatical/tetra-ui barrel.
+ *
+ * Handles:
+ *   import { WeekCalendar, TeamPlanner } from '@soulbatical/tetra-ui'
+ *   import { WeekCalendar as WC } from '@soulbatical/tetra-ui'
+ *   import type { ... } from '...'  — type-only, safe, skipped
+ */
+function parseTetraUiBarrelImports(content) {
+  const results = []
+
+  // Match: import [type] { ... } from '@soulbatical/tetra-ui'
+  // NOT matching subpaths like '@soulbatical/tetra-ui/planner'
+  const importRe = /import\s+(type\s+)?(\{[^}]+\})\s+from\s+['"]@soulbatical\/tetra-ui['"]/g
+  let match
+
+  while ((match = importRe.exec(content)) !== null) {
+    const isTypeImport = Boolean(match[1])
+    if (isTypeImport) continue
+
+    const importBlock = match[2]
+    const lineNumber = content.slice(0, match.index).split('\n').length
+
+    // Extract symbol names, stripping "as Alias" and "type" modifiers
+    const symbolRe = /(?:type\s+)?([A-Za-z_$][A-Za-z0-9_$]*)(?:\s+as\s+[A-Za-z_$][A-Za-z0-9_$]*)?/g
+    let sym
+    const symbols = []
+    while ((sym = symbolRe.exec(importBlock)) !== null) {
+      const name = sym[1]
+      if (name !== 'type') symbols.push(name)
+    }
+
+    results.push({ symbols, line: lineNumber, raw: match[0] })
+  }
+
+  return results
+}
+
+/**
+ * Determine if a file is server-reachable in Next.js App Router.
+ *
+ * Server-reachable = Next.js may try to render or import this file on the server.
+ *
+ * Rules:
+ * - layout.tsx: always server-rendered (unless it has 'use client' — unusual)
+ * - page.tsx: server-rendered unless it has 'use client'
+ * - providers.tsx: commonly used to wrap the app; flagged regardless of directive
+ *   because consumers often import it from server components
+ * - Any other file without 'use client'
+ */
+function isServerReachable(filename, content) {
+  const name = filename.toLowerCase()
+
+  if (name === 'layout.tsx' || name === 'layout.ts') return true
+  if (name === 'providers.tsx' || name === 'providers.ts') return true
+
+  if (name === 'page.tsx' || name === 'page.ts') {
+    return !hasUseClientDirective(content)
+  }
+
+  return !hasUseClientDirective(content)
+}
+
+/**
+ * Find the Next.js config file.
+ */
+function findNextConfig(projectRoot) {
+  const candidates = [
+    join(projectRoot, 'frontend', 'next.config.ts'),
+    join(projectRoot, 'frontend', 'next.config.js'),
+    join(projectRoot, 'frontend', 'next.config.mjs'),
+    join(projectRoot, 'next.config.ts'),
+    join(projectRoot, 'next.config.js'),
+    join(projectRoot, 'next.config.mjs'),
+  ]
+  return candidates.find(existsSync) ?? null
+}
+
+// ============================================================================
+// MAIN CHECK
+// ============================================================================
+
+export async function run(config, projectRoot) {
+  const result = {
+    passed: true,
+    findings: [],
+    summary: { total: 0, critical: 0, high: 0, medium: 0, low: 0 },
+    details: {
+      filesScanned: 0,
+      barrelImportsFound: 0,
+      ssrUnsafeImports: 0,
+      daypilotAliasChecked: false,
+    }
+  }
+
+  // ── Step 1: scan all TS/TSX source files ──────────────────────────────────
+
+  const sourceFiles = glob.sync('**/*.{ts,tsx}', {
+    cwd: projectRoot,
+    ignore: IGNORE_PATTERNS,
+    absolute: true,
+  })
+
+  result.details.filesScanned = sourceFiles.length
+
+  // Track providers files that import from the barrel (for DayPilot alias check)
+  const providersFilesWithBarrelImport = []
+
+  for (const absPath of sourceFiles) {
+    let content
+    try { content = readFileSync(absPath, 'utf-8') } catch { continue }
+
+    const rel = relPath(projectRoot, absPath)
+    const filename = absPath.split('/').pop() ?? ''
+
+    // Quick check: does this file import from the tetra-ui barrel at all?
+    const hasBarrelImport = (
+      content.includes("'@soulbatical/tetra-ui'") ||
+      content.includes('"@soulbatical/tetra-ui"')
+    )
+    if (!hasBarrelImport) continue
+
+    const imports = parseTetraUiBarrelImports(content)
+    if (imports.length === 0) continue
+
+    result.details.barrelImportsFound++
+
+    // Track providers files with 'use client' for DayPilot alias check
+    const name = filename.toLowerCase()
+    if ((name === 'providers.tsx' || name === 'providers.ts') && hasUseClientDirective(content)) {
+      providersFilesWithBarrelImport.push({ absPath, rel })
+    }
+
+    // Check each import for SSR-unsafe symbols
+    for (const importEntry of imports) {
+      const { symbols, line, raw } = importEntry
+      const unsafeSymbols = symbols.filter(s => SSR_UNSAFE_EXPORTS.has(s))
+      if (unsafeSymbols.length === 0) continue
+
+      // File must be server-reachable for this to be a problem
+      if (!isServerReachable(filename, content)) continue
+
+      // Correctly guarded with dynamic + ssr:false
+      if (hasDynamicSsrFalse(content)) continue
+
+      result.details.ssrUnsafeImports++
+      result.passed = false
+      result.summary.high++
+      result.summary.total++
+
+      result.findings.push({
+        file: rel,
+        line,
+        severity: 'high',
+        message: [
+          `SSR-unsafe tetra-ui import in server-reachable file:`,
+          `  File:    ${rel}:${line}`,
+          `  Import:  ${raw.trim()}`,
+          `  Unsafe:  ${unsafeSymbols.join(', ')} (pull in DayPilot — browser-only)`,
+          ``,
+          `  These components use browser globals and will fail during SSR with`,
+          `  "window is not defined" or cause hydration mismatches.`,
+          ``,
+          `  Fix option 1: import from the planner subpath and wrap with dynamic:`,
+          `    const ${unsafeSymbols[0]} = dynamic(`,
+          `      () => import('@soulbatical/tetra-ui/planner').then(m => ({ default: m.${unsafeSymbols[0]} })),`,
+          `      { ssr: false }`,
+          `    )`,
+          ``,
+          `  Fix option 2: add 'use client' at the top of ${rel}`,
+          `    (only valid if this file is never imported from a server component)`,
+        ].join('\n'),
+        fix: `Import ${unsafeSymbols.join(', ')} from '@soulbatical/tetra-ui/planner' and wrap with dynamic(..., { ssr: false })`,
+      })
+    }
+  }
+
+  // ── Step 2: check DayPilot webpack alias ──────────────────────────────────
+
+  if (providersFilesWithBarrelImport.length > 0) {
+    result.details.daypilotAliasChecked = true
+    const nextConfigPath = findNextConfig(projectRoot)
+
+    if (nextConfigPath) {
+      let configContent
+      try { configContent = readFileSync(nextConfigPath, 'utf-8') } catch { configContent = '' }
+
+      const hasDayPilotAlias = configContent.includes('@daypilot') || configContent.includes('daypilot')
+
+      if (!hasDayPilotAlias) {
+        result.summary.medium++
+        result.summary.total++
+
+        const relConfig = relPath(projectRoot, nextConfigPath)
+        const providersList = providersFilesWithBarrelImport.map(f => f.rel).join(', ')
+
+        result.findings.push({
+          file: relConfig,
+          line: 0,
+          severity: 'medium',
+          message: [
+            `DayPilot webpack alias missing from next.config:`,
+            `  Config:    ${relConfig}`,
+            `  Providers: ${providersList}`,
+            ``,
+            `  These files import from the @soulbatical/tetra-ui barrel, which re-exports`,
+            `  DayPilot planner components. Without a webpack alias, Next.js may try to`,
+            `  resolve DayPilot in a server context and fail with "window is not defined".`,
+            ``,
+            `  Fix: add this webpack config to ${relConfig}:`,
+            `    webpack(config) {`,
+            `      config.resolve.alias = {`,
+            `        ...config.resolve.alias,`,
+            `        '@daypilot/daypilot-lite-react': false,`,
+            `      }`,
+            `      return config`,
+            `    }`,
+          ].join('\n'),
+          fix: `Add '@daypilot/daypilot-lite-react': false to webpack alias in ${relConfig}`,
+        })
+      }
+    }
+  }
+
+  return result
+}

package/lib/checks/index.js

@@ -25,6 +25,9 @@ export * as barrelImportDetector from './codeQuality/barrel-import-detector.js'
 export * as typescriptStrictness from './codeQuality/typescript-strictness.js'
 export * as mcpToolDocs from './codeQuality/mcp-tool-docs.js'
 export * as tailwindSourcePaths from './codeQuality/tailwind-source-paths.js'
+export * as envVarsDefined from './codeQuality/env-vars-defined.js'
+export * as nextRouteCoverage from './codeQuality/next-route-coverage.js'
+export * as tetraUiSsrSafeImports from './codeQuality/tetra-ui-ssr-safe-imports.js'
 
 // Health checks (project ecosystem)
 export * as health from './health/index.js'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulbatical/tetra-dev-toolkit",
-  "version": "1.20.25",
+  "version": "1.20.26",
   "publishConfig": {
     "access": "restricted"
   },
@@ -44,7 +44,8 @@
     "tetra-check-pages": "./bin/tetra-check-pages.js",
     "tetra-check-views": "./bin/tetra-check-views.js",
     "tetra-doctor": "./bin/tetra-doctor.js",
-    "tetra-style-audit": "./bin/tetra-style-audit.js"
+    "tetra-style-audit": "./bin/tetra-style-audit.js",
+    "tetra-init-smoke": "./bin/tetra-init-smoke.js"
   },
   "files": [
     "bin/",