DRAFT: Improve automation

[Neikon]

Summary

This branch modernizes the development environment, stabilizes the build pipeline, fixes asset/image issues, enables site indexing, and automates validation and rebuilding so the project no longer depends on manually triggered GitHub Actions.

Main Changes

• Added support for coding agents:

  • AGENTS.md
  • MEMORY.md
  • explicit commit/push guidance after relevant changes
  • explicit prohibition on merging or affecting main without authorization

• Improved the container environment:

  • added .devcontainer/devcontainer.json
  • added .devcontainer/post-create.sh
  • automatic installation of required dependencies and tools after container rebuild

• Modernized the project toolchain:

  • upgraded CI/runtime expectations to Node 24
  • updated build dependencies
  • migrated to gulp@5
  • updated gulp-sass
  • replaced gulp-minify with gulp-terser
  • replaced fragile build steps with native utilities and sharp
  • removed build deprecation warnings
  • npm outdated is clean
  • npm audit is clean

• Hardened and fixed the generation pipeline:

  • binary image copies now use fs.copyFile to avoid .webp corruption
  • optional directories such as dev/fonts are now handled safely
  • config filtering now avoids artifacts such as docs/.robots
  • ESM-only Gulp plugins are lazy-loaded

• Fixed frontend behavior:

  • fixed the lightbox implementation in dev/js/main.js
  • lightbox close behavior now works correctly
  • removed inconsistent state when opening multiple previews

• Fixed broken theme images:

  • several fragile remote screenshots were localized into the repository
  • new images were added under images/themes/remote-*
  • generated assets were added under docs/assets/img/themes/remote-*
  • the site no longer depends on unstable hotlinked screenshots for those themes

• SEO / indexing:

  • robots.txt now allows global indexing:
    • User-agent: *
    • Allow: /

• Automated GitHub Actions:

  • automatic pull request validation for changes targeting main
  • npm test and npm run build now run automatically for PRs affecting the site or build
  • docs/ is rebuilt automatically after pushes/merges to main
  • generated docs/ changes are committed automatically on main
  • updated to actions/checkout@v4 and actions/setup-node@v4
  • switched to npm ci
  • removed the dependency on manual workflow_dispatch as the only build path

• Other supporting changes:

  • .gitignore updated to ignore .codex
  • added .github/dependabot.yml

Validation Performed

• verified the rebuilt container environment
• ran npm test
• ran npm run build
• ran the build with deprecation tracing
• performed smoke tests by serving docs/ over local HTTP
• verified specific problematic assets
• verified the final robots.txt

Result

This branch leaves the project ready to:

• work correctly after container rebuilds without manual setup
• validate changes automatically in pull requests
• rebuild and publish docs/ automatically after merges to main
• serve catalog images correctly without the broken local previews previously detected

close #221

[Neikon]

@BeyondMagic @unseen-ninja I’ve tried to modernize and automate the pipeline with the help of Codex, but since my web development knowledge is limited and most of the changes have been made by Codex, I’d really appreciate it if you could take a look and give your approval.
Thank you very much!