refactor: split out engine to TechEngine (TechAPI = data + site)

.github/pull_request_template.md

@@ -1,21 +1,16 @@
-<!-- PR title must follow Conventional Commits (§14.5), e.g. feat(api): add /compare endpoint -->
+<!-- PR title must follow Conventional Commits, e.g. feat(data/cpu): add EPYC Rome SKUs -->
 
 ## What & why
 
 <!-- What does this change and why? Link issues with "Closes #123". -->
 
-## How
+## Source
 
-<!-- Key implementation notes. -->
-
-## Testing
-
-<!-- How was this verified? Paste test output or screenshots. -->
+<!-- Cite the upstream source (vendor product page, Wikipedia infobox, datasheet). -->
 
 ## Checklist
 
-- [ ] Type hints on all new functions (§0.5.4)
-- [ ] Tests added/updated (§15)
-- [ ] `ruff check` and `pytest` pass locally
-- [ ] Data changes pass `python -m scripts.validate`
-- [ ] SPEC/README updated if behavior changed (§0.5.4)
+- [ ] `python -m app.validate` passes locally
+- [ ] Files live at the correct `data/<category>/<...>/<slug>.json` path
+- [ ] Slugs are kebab-case and unique within the category
+- [ ] `source_urls` cites at least one canonical reference

.github/workflows/deploy-pages.yml

@@ -1,12 +1,16 @@
 name: deploy-pages
 
-# Builds the Astro site (intro homepage + OpenAPI docs) together with the static
-# JSON data dump and deploys everything to GitHub Pages. The dataset does not need
-# to be complete — whatever is curated in data/ is published.
+# Builds the Astro site (site/) and deploys it to GitHub Pages. TechAPI owns its
+# own homepage, so it deploys itself (Pages is per-repo). No backend here — the
+# static JSON dump the site consumes is produced by TechEngine and committed
+# under site/public/v1 (served at <base>/v1/...).
 # Enable once: Settings → Pages → Source = GitHub Actions.
 on:
   push:
     branches: [main]
+    paths:
+      - "site/**"
+      - ".github/workflows/deploy-pages.yml"
   workflow_dispatch:
 
 permissions:
@@ -24,20 +28,6 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - uses: actions/setup-python@v5
-        with:
-          python-version: "3.12"
-          cache: pip
-
-      - name: Install Python deps
-        run: pip install -e .
-
-      - name: Validate curated data
-        run: python -m scripts.validate
-
-      - name: Generate static JSON dump + openapi.json
-        run: python -m scripts.dump --output dump
-
       - uses: actions/setup-node@v4
         with:
           node-version: "22"
@@ -50,11 +40,10 @@ jobs:
           npm ci
           npm run build
 
-      - name: Assemble site (Astro dist + JSON data dump)
+      - name: Assemble _site
         run: |
           mkdir -p _site
           cp -r site/dist/. _site/
-          cp -r dump/. _site/
           touch _site/.nojekyll
 
       - uses: actions/upload-pages-artifact@v3

.github/workflows/validate-data.yml

@@ -1,17 +1,31 @@
 name: validate-data
 
+# Self-check: every PR runs the bundled lightweight validator. Heavy checks
+# (coverage gaps, schema migrations, ingestion smoke tests) live in TechEngine.
 on:
   pull_request:
     paths:
       - "data/**"
+      - "app/validate.py"
+  push:
+    branches: [main]
+    paths:
+      - "data/**"
+      - "app/validate.py"
 
 jobs:
-  validate:
+  self-validate:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-python@v5
         with:
           python-version: "3.12"
-      - name: Validate seed JSON (§9.3, §15.3)
-        run: python -m scripts.validate
+      - name: Self-check (bundled validator)
+        run: python -m app.validate
+
+  engine-validate:
+    needs: self-validate
+    uses: GetTechAPI/TechEngine/.github/workflows/validate-data.yml@main
+    with:
+      data-ref: ${{ github.event.pull_request.head.sha || github.sha }}