feat: CMD-187 autocreate search page

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,65 @@
+## Overview
+
+<!--
+1–3 sentences stating what problem this solves and what you changed at a high level. Example:
+
+"Fixes caption contrast on dark sections by using opacity instead of a fixed dark color."
+-->
+
+…
+
+## Related
+
+<!--
+Delete the bullets you don't need. Any ticket / cross-repo links go here. Examples:
+
+- [CMD-XYZ](https://tacc-main.atlassian.net/browse/CMD-XYZ)
+- requires https://github.com/TACC/Some-Repo/pull/NNN
+- required by https://github.com/TACC/Other-Repo/pull/NNN
+-->
+
+- …
+
+## Changes
+
+<!--
+Use short bullets. Add bold verb as prefix to help scanning; example:
+
+- **added** `.o-widget--compact` modifier
+- **updated** demo markup for Fractality
+- **deleted** cruft in a working file
+- **fixed** typo
+-->
+
+- …
+
+## Testing
+
+<!--
+Numbered steps another dev can repeat. Include local URLs for UI changes. Example:
+
+1. `make start`
+2. Create a page with plugin X that has setting Y with value Z.
+3. Verify UI shows …
+-->
+
+1. 
+
+
+## UI
+
+<!--
+Add screenshots via GitHub PR editor. Organize and label with a table; example:
+
+| Before | After |
+| - | - |
+| <img width="900" alt="before" src="..." /> | <img width="900" alt="after" src="..." /> |
+-->
+
+…
+
+<!--
+## Notes
+
+Optional: rollout, follow-ups, known limitations, unrelated dist churn.
+-->

.github/labels_basic.yml

@@ -12,6 +12,10 @@
 # + "paused"
 # + "proposal"
 
+- name: accessibility
+  color: 'FA8122'
+  description: Accessibility degraded or unavailable
+
 - name: blocked
   color: 'FA8122'
   description: Unable to begin or continue work

.gitmessage

@@ -0,0 +1,20 @@
+
+
+# type(scope)!: short summary
+#
+# Types: feat, fix, docs, style, refactor, perf, test, chore, build, ci
+# Scope (optional): describes area, e.g. api, ui, auth, deps
+# ! (optional): marks breaking changes
+#
+# Examples:
+#   feat(api)!: add user search endpoint
+#   chore(deps): update
+#   style: delete excess whitespace
+#
+# Body (optional):
+#   What changed and why
+#   Important design decisions or context
+#
+# Footer (optional):
+#   BREAKING CHANGE: describe breaking change
+#   Closes #123, Relates-to #456

.pr_agent.toml

@@ -0,0 +1,4 @@
+[pr_reviewer]
+extra_instructions = """
+Do not flag missing `rel="noopener noreferrer"` on `target="_blank"` links as a security issue. Modern browsers implicitly apply `noopener` per the HTML spec. This is not an active vulnerability.
+"""

AGENTS.md

@@ -1,6 +1,9 @@
 # AGENTS.md
 
-## Cursor Cloud specific instructions
+- [Architecture](#architecture)
+- [Pull Requests](#pull-requests)
+
+## Architecture
 
 This is a **Docker-based Django CMS** project. All application code runs inside Docker containers.
 
@@ -12,7 +15,7 @@ This is a **Docker-based Django CMS** project. All application code runs inside
 | PostgreSQL 14.9 | `core_cms_postgres` | `5432` (internal) |
 | Elasticsearch 7.17 | `core_cms_elasticsearch` | `localhost:9201` |
 
-### Makefile commands
+### Make
 
 Use the `Makefile` instead of raw `docker compose` commands:
 
@@ -24,27 +27,43 @@ Use the `Makefile` instead of raw `docker compose` commands:
 | `make stop` | Stop containers |
 | `make clean` | Stop containers, remove volumes and images |
 
-### First-time setup
+### Setup
 
 ```sh
 DJANGO_SUPERUSER_PASSWORD=yourpass make setup
 ```
 
-`make setup` (i.e. `bin/setup-cms.sh`) handles: settings file creation, Docker build, container startup, readiness polling, migrations, superuser creation, CSS build, and `collectstatic`. Non-interactive shells must set `DJANGO_SUPERUSER_PASSWORD`; a TTY prompts interactively.
+`make setup` (i.e. `bin/setup-cms.sh`) handles: settings file creation, Docker build, container startup, readiness polling, migrations, superuser creation, CSS build, and `collectstatic`. Non-interactive shells (e.g. agent runs) must set `DJANGO_SUPERUSER_PASSWORD`; a TTY prompts interactively.
+
+_Note: Stale containers errors (e.g. `core_cms_elasticsearch already in use`) come from old Compose state. Ask human whether to remove stale `core_cms*` containers/projects; once resolved, rerun `make setup`._
+
+### Dependencies
 
-### Key gotchas
+- When updating dependencies, use `npm` commands (e.g. `uninstall`/`install`); do not hand-edit lockfile entries.
+- When installing `@tacc/core-styles`, use a published version from the registry, or a `git+https://github.com/...` spec so install does not require SSH.
+
+### Gotchas
+
+#### Settings & Secrets
 
 - **Settings files** are gitignored. Created from `*.example.py` by `bin/setup-cms.sh` or manually.
-- The `secrets.py` Elasticsearch host should be `core_cms_elasticsearch` (the Docker hostname), not `elasticsearch`.
+- **Postgres secret files:** `docker-compose.dev.yml` mounts `./conf/postgres/*.secret` files. These are not required for development and can be ignored.
+
+#### Elasticsearch
+
+- **`secrets.py` Elasticsearch host:** Should be `core_cms_elasticsearch` (the Docker hostname), not `elasticsearch`.
 - Docker commands may need `sudo` depending on the environment.
 - **Elasticsearch cgroups v2:** ES 7.17.0 crashes on kernels with cgroups v2 (`CgroupV2Subsystem` NPE). Use ES 7.17.9+ in `docker-compose.dev.yml`.
-- **Postgres secret files:** `docker-compose.dev.yml` mounts `./conf/postgres/*.secret` files. These are not required for development and can be ignored.
 
-### Lint, test, build
+### Lint, Test, Build
 
 - **Lint:** `docker exec core_cms flake8 taccsite_cms/ --max-line-length=120` (pre-existing warnings expected)
 - **Tests:** `docker exec core_cms python manage.py test taccsite_cms.contrib.taccsite_sample --no-input`
 - **CSS build:** `docker run --rm -v "$(pwd):/code" -w /code node:18 sh -c "npm ci && npm run build"`
 - **Collect static:** `docker exec core_cms python manage.py collectstatic --no-input`
 
 See `README.md` for full setup instructions.
+
+## Pull Requests
+
+Write skimmable, template-aligned PRs; reviewers can see the code diff for details.

Dockerfile

@@ -37,7 +37,7 @@ RUN poetry install --no-root
 
 
 # NODE DEPENDENCIES & BUILD & OUTPUT
-FROM node:18 as node_build
+FROM node:20 as node_build
 
 # Install dependencies
 COPY package.json package-lock.json /code/

apps/search_page/apps.py

@@ -0,0 +1,10 @@
+from django.apps import AppConfig
+from django.conf import settings
+
+class SearchPageConfig(AppConfig):
+    name = 'apps.search_page'
+
+    def ready(self):
+        if settings.SEARCH_PAGE_AUTO_SETUP:
+            from .utils import create_page
+            create_page()

apps/search_page/cms_apps.py

@@ -0,0 +1,11 @@
+from cms.app_base import CMSApp
+from cms.apphook_pool import apphook_pool
+
+
+@apphook_pool.register
+class SearchPageApphook(CMSApp):
+    app_name = 'apps.search_page'
+    name = 'SearchPage'
+
+    def get_urls(self, page=None, language=None, **kwargs):
+        return ['apps.search_page.urls']

apps/search_page/static/search_page/css/google-search.css

@@ -0,0 +1,152 @@
+#google-search {
+
+  &:is(#cms-content-container > *:last-child) {
+    margin-bottom: var(--global-space--section-gap, 60px);
+  }
+
+  /* SEARCH CONTAINER */
+
+  /* To remove padding from search container */
+  & .gsc-control-cse {
+    padding: unset;
+  }
+
+
+
+  /* TABLE OF SEARCH STATS & SORTING OPTIONS */
+
+  /* To remove border from search analytics, add gray background */
+  & .gsc-above-wrapper-area {
+    --bkgd-color: var(--global-color-primary--x-light);
+
+    background-color: var(--bkgd-color);
+    box-shadow: 40vw 0 var(--bkgd-color), -40vw 0 var(--bkgd-color);
+    border-bottom: unset;
+  }
+
+  & .gsc-above-wrapper-area-container {
+    border-bottom: unset;
+  }
+
+  /* To override Core-Styles tables */
+  & tbody > tr:first-child > :is(td, th) {
+    border: unset;
+    padding-inline: unset;
+    background: unset;
+    vertical-align: middle;
+  }
+
+  & .gsc-selected-option-container {
+    background: var(--global-color-primary--xx-light);
+    border: var(--global-border--normal);
+  }
+
+  & .gsc-result-info {
+    padding: unset;
+    font-size: var(--global-font-size--medium);
+  }
+
+
+
+  /* SUGGESTION PHRASE (after "Did you mean:") */
+
+  & .gs-spelling {
+    padding: unset;
+  }
+  & .gs-spelling a {
+    color: var(--global-color-accent--light);
+
+    /* to undo core-styles.base */
+    /* https://github.com/TACC/Core-Styles/blob/8ab89d3/src/lib/_imports/elements/links.css */
+    &:not([href]) {
+      opacity: 1;
+      pointer-events: auto;
+    }
+  }
+
+
+
+  /* SEARCH RESULTS */
+
+  /* (search result body text) */
+  & .gs-snippet {
+    color: var(--global-color-primary--dark);
+  }
+
+  /* (url under search result title) */
+  & .gs-webResult div.gs-visibleUrl {
+    color: var(--global-color-secondary--normal);
+  }
+
+  /* (search result titles) */
+  & a.gs-title:link {
+    color: var(--global-color-accent--light);
+    text-decoration: none;
+    text-decoration-thickness: var(--global-border-width--normal);
+    text-underline-offset: 0.2em;
+  }
+  & a.gs-title:link:hover {
+    text-decoration-line: underline;
+    text-decoration-style: solid;
+  }
+  & a.gs-title b {
+    color: currentColor;
+  }
+  & .gs-result .gs-title:not(a):hover {
+    /* to remove duplicate underline */
+    /* (fix Google's default_v6+en.css bug `.gs-result .gs-title:hover`) */
+    text-decoration: auto;
+  }
+
+  /* (push search-result description to right) */
+  & .gs-image-box {
+    margin-right: 10px;
+  }
+
+
+
+  /* GOOGLE PAGE NAVIGATION (at bottom) */
+
+  & .gsc-cursor-box {
+    display: flex;
+    justify-content: center;
+    margin-block: var(--global-space--large);
+  }
+
+  & .gsc-cursor-current-page {
+    color: var(--global-color-accent--light);
+    text-decoration: none;
+    text-decoration-thickness: var(--global-border-width--normal);
+    text-underline-offset: 0.2em;
+  }
+
+  & .gsc-cursor-current-page:hover {
+    text-decoration-line: underline;
+    text-decoration-style: solid;
+  }
+
+
+
+  /* GOOGLE BRANDING */
+
+  & .gcsc-find-more-on-google {
+    color: var(--global-color-accent--light);
+    text-decoration: none;
+    text-decoration-thickness: var(--global-border-width--normal);
+    text-underline-offset: 0.2em;
+  }
+  svg.gcsc-find-more-on-google-magnifier {
+    fill: currentColor;
+  }
+
+  & .gcsc-find-more-on-google:hover {
+    text-decoration-line: underline;
+    text-decoration-style: solid;
+  }
+
+  & .gcsc-branding-img-noclear {
+    vertical-align: unset;
+    top: 1px;
+  }
+
+}