feat: llms file generator, import order organizer and minor improvem…

.github/workflows/generate-llms.yml

@@ -0,0 +1,49 @@
+name: Generate LLMs files
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  generate:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: yarn
+
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile
+
+      - name: Copy prod env file
+        run: |
+          echo "${{ secrets.ENV_PROD }}" | base64 -d > .env
+          rm -f .env.local
+
+      - name: Generate llms.txt
+        run: node scripts/generate-llms.mjs
+        env:
+          LLMS_MODE: curated
+
+      - name: Generate llms-full.txt
+        run: node scripts/generate-llms.mjs
+        env:
+          LLMS_MODE: full
+
+      - name: Commit and push generated files
+        run: |
+          git config user.name "github-actions"
+          git config user.email "github-actions@github.com"
+          git add public/keepsimple_/
+          if ! git diff --cached --quiet; then
+            git commit -m "chore: regenerate llms files"
+            git push
+          fi

cypress/e2e/uxcore/bias-modal.cy.ts

@@ -13,6 +13,7 @@ describe('UX Core Bias Page: Availability Heuristics', () => {
   });
   it('Should open the first question and verify URL and content', () => {
     cy.get('[data-cy="open-question"]').first().click();
+    cy.wait(4000);
     cy.url().should('include', '/why-our-company-is-having-reputation-issue#0');
   });
 

cypress/support/commands.d.ts

@@ -1,4 +1,5 @@
 import { mount } from 'cypress/react';
+
 import buttonText from '@data/buttonText';
 
 declare global {

cypress/support/index.d.ts

@@ -0,0 +1,66 @@
+import { mount } from 'cypress/react';
+
+import buttonText from '@data/buttonText';
+
+declare global {
+  namespace Cypress {
+    interface Chainable {
+      /**
+       * Custom command to check all external links on the page.
+       * @param excludedDomains Array of domain strings to skip
+       * @param selector CSS selector for links (defaults to 'a')
+       */
+      checkExternalLinks(
+        excludedDomains?: string[],
+        selector?: string,
+      ): Chainable<void>;
+
+      checkH1(expectedText: string): Chainable<void>;
+
+      scrollToSection(sectionText: string): Chainable<void>;
+
+      validateAllImages(): Chainable<void>;
+
+      uxcgTestSearchBehavior(
+        validWord: string,
+        invalidWord: string,
+      ): Chainable<void>;
+
+      checkSocialMediaLink(title: string, domain: string): Chainable<void>;
+
+      showCopiedTooltip(): Chainable<void>;
+
+      clickArrowWhenReady(
+        direction: 'next' | 'prev',
+        expectedUrlPart: string,
+      ): Chainable<void>;
+
+      showMoreAndLess(): Chainable<void>;
+
+      uxcoreSearchBehavior: (
+        validWord: string,
+        invalidWord: string,
+      ) => Chainable<void>;
+
+      playAudio(): Chainable<void>;
+
+      checkPyramidChange(
+        bluePyramidId: string,
+        orangePyramidId: string,
+        purplePyramidId: string,
+      ): Chainable<void>;
+
+      checkSwiperSlide(prevUrl, nextUrl): Chainable<void>;
+
+      uxcpSearchBehavior(
+        validWord: string,
+        invalidWord: string,
+      ): Chainable<void>;
+
+      uxcpAddBiases: () => Chainable<void>;
+      checkAllLinks: (routes) => Chainable<void>;
+      openLoginModalByButtonClick: (buttonLabel: string) => Chainable<void>;
+      loginBySession: () => Chainable<void>;
+    }
+  }
+}

eslint.config.mjs

@@ -1,6 +1,7 @@
+import { FlatCompat } from '@eslint/eslintrc';
+import simpleImportSort from 'eslint-plugin-simple-import-sort';
 import { dirname } from 'path';
 import { fileURLToPath } from 'url';
-import { FlatCompat } from '@eslint/eslintrc';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -9,15 +10,20 @@ const compat = new FlatCompat({
   baseDirectory: __dirname,
 });
 
+// eslint-disable-next-line import/no-anonymous-default-export
 export default [
   {
-    ignores: ['.next/**', 'node_modules/**', 'out/**', 'build/**'],
+    ignores: ['.next/**', 'out/**', 'build/**', 'next-env.d.ts'],
   },
 
   ...compat.extends('next/core-web-vitals', 'next/typescript'),
 
   {
+    plugins: {
+      'simple-import-sort': simpleImportSort,
+    },
     rules: {
+      // ── TypeScript ───────────────────────────────────────────────────────
       '@typescript-eslint/ban-ts-comment': [
         'warn',
         {
@@ -28,7 +34,49 @@ export default [
         },
       ],
       '@typescript-eslint/no-explicit-any': 'off',
-      'react-hooks/exhaustive-deps': 'off',
+
+      // ── Import order ─────────────────────────────────────────────────────
+      'simple-import-sort/imports': [
+        'error',
+        {
+          groups: [
+            // 1. Side-effect imports (e.g. `import 'reflect-metadata'`)
+            ['^\\u0000'],
+            // 2. Node built-ins (e.g. `node:url`, `path`, `fs`)
+            ['^node:'],
+            // 3. Third-party packages (react, next, classnames, lodash…)
+            ['^@?\\w'],
+            // 4. Styles alias
+            ['^@styles(?:/.*)?$'],
+            // 5. Constants alias
+            ['^@constants(?:/.*)?$'],
+            // 6. Types / local-types aliases
+            ['^@local-types(?:/.*)?$'],
+            // 7. Hooks alias
+            ['^@hooks(?:/.*)?$'],
+            // 8. Lib alias
+            ['^@lib(?:/.*)?$'],
+            // 9. API alias
+            ['^@api(?:/.*)?$'],
+            // 10. Data alias
+            ['^@data(?:/.*)?$'],
+            // 11. Icons alias
+            ['^@icons(?:/.*)?$'],
+            // 12. Components alias
+            ['^@components(?:/.*)?$'],
+            // 13. Layouts alias
+            ['^@layouts(?:/.*)?$'],
+            // 14. Catch-all for any other @ aliases (e.g. src/…)
+            ['^@/', '^src/'],
+            // 15. Relative imports (non-style)
+            ['^\\.(?!.*\\.(?:css|scss|sass|less)$)'],
+            // 16. Style imports (CSS / SCSS)
+            ['^.+\\.(?:css|scss|sass|less)$'],
+          ],
+        },
+      ],
+      'simple-import-sort/exports': 'error',
+      'import/newline-after-import': 'error',
     },
   },
 ];

middleware.ts

@@ -1,6 +1,7 @@
 import { NextRequest, NextResponse } from 'next/server';
-import { getRedirectMap } from './lib/getUXCoreRedirects';
+
 import { getUXCGRedirects } from './lib/getUXCGRedirects';
+import { getRedirectMap } from './lib/getUXCoreRedirects';
 
 const PUBLIC_FILE = /\.(.*)$/;
 const supportedLocales = ['en', 'ru', 'hy'];
@@ -79,5 +80,6 @@ export const config = {
     '/:locale/uxcore/:path*',
     '/uxcg/:path*',
     '/:locale/uxcg/:path*',
+    '/((?!api|_next/static|_next/image|uxcore_|favicon.ico).*)',
   ],
 };

next.config.js

@@ -43,6 +43,18 @@ module.exports = async () => {
           source: '/robots.txt',
           destination: '/uxcore_/robots.txt',
         },
+        {
+          source: '/llms.txt',
+          destination: '/uxcore_/llms.txt',
+        },
+        {
+          source: '/llms-full.txt',
+          destination: '/uxcore_/llms-full.txt',
+        },
+        {
+          source: '/llms-full-pages/:path*',
+          destination: '/uxcore_/llms-full-pages/:path*',
+        },
       ];
     },
     experimental: {

package.json

@@ -15,7 +15,9 @@
     "test:firefox": "cypress run --browser firefox",
     "test:edge": "cypress run --browser edge",
     "test:all": "npm run test:chrome && npm run test:firefox && npm run test:edge",
-    "prepare": "husky install"
+    "prepare": "husky install",
+    "generate:llms": "tsx --tsconfig scripts/tsconfig.json scripts/generate-llms.ts",
+    "generate:llms:full": "tsx --tsconfig scripts/tsconfig.json scripts/generate-llms-full.ts"
   },
   "lint-staged": {
     "**/*.{ts,tsx}": [
@@ -34,7 +36,8 @@
     "cypress-v10-preserve-cookie": "^1.2.1",
     "date-fns": "2.30.0",
     "dotenv": "^16.4.5",
-    "geoip-lite": "1.4.2",
+    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "fast-geoip": "^1.1.88",
     "html2canvas": "^1.4.1",
     "lodash.debounce": "4.0.8",
     "lodash.unescape": "4.0.1",
@@ -88,6 +91,7 @@
     "sass-loader": "13.1.0",
     "start-server-and-test": "^2.0.12",
     "ts-node": "^10.9.2",
+    "tsx": "^4.19.2",
     "typescript": "5.2.2"
   }
 }

public/robots.txt

@@ -11,10 +11,6 @@ Disallow: /hy/uxcgstory/
 Disallow: /hy/uxcgdiy/
 Disallow: /hy/uiux/
 Disallow: /hy/awareness-test/
-Disallow: /hy/table-of-contents/
-Disallow: /hy/why-study-management/
-Disallow: /hy/what-is-a-project/
-Disallow: /hy/project-artifacts-and-their-importance/
 Disallow: /hy/project-management-environment/
 Disallow: /hy/philosophies-methodologies-and-frameworks/
 Disallow: /hy/software-development-life-cycles/

scripts/generate-llms-full.ts

@@ -0,0 +1,7 @@
+process.env.LLMS_OUTPUT_FILE = 'uxcore_/llms-full.txt';
+// Large enough to include all current UXCore (105) and UXCG entries.
+process.env.LLMS_DYNAMIC_LIMIT = '1000';
+process.env.LLMS_WRITE_SLUG_MDS = 'true';
+process.env.LLMS_SLUG_MD_DIR = 'uxcore_/llms-full-pages';
+
+void import('./generate-llms');