BUY-61977: stop caching degraded envelopes in search + deals

.codex/agents/a29ac9dc-cf0a-455b-964c-e75bd2f5fc47/workspace-memory.md

@@ -0,0 +1,58 @@
+# Workspace Memory - BUY-31015 WooCommerce Deep-page Lane Supervisor
+
+## Issue Status
+- Most recent: BUY-54957 WooCommerce deep-page lane supervisor (BUY-31015)
+- Status: done (closed 2026-06-21T11:32Z)
+- Previous: BUY-54940 (done 2026-06-21T10:53Z), BUY-54932 (done 2026-06-21T10:36Z), BUY-54907 (done 2026-06-21T09:34Z)
+
+## Lane Components
+- Supervisor: scripts/buy31015-deep-page-supervisor.mjs (BUY-52234 deps check soft-warned in BUY-54932)
+- Worker: scripts/buy31015-woocommerce-deep-page.mjs
+- Keepalive: scripts/buy31015-deep-page-keepalive.sh
+- Keepalive cron: run-buy-51993-deep-page-keepalive.sh (every 2 min)
+- State files: data/buy31015-deep-page-*.json
+- Known merchants: data/buy31015-wc-known-merchants.json (1,518 merchants)
+
+## Current Status (2026-06-21T11:32Z, end of BUY-54957 heartbeat)
+- Cycle: 324
+- Worker PID: 464081 (post-restart; setsid-detached, PPID=1)
+- Rows updated: 108 (cycle 324 mid-tick, ~24s after restart)
+- rowsPerHour: 16,281 (post-restart acceleration typical)
+- Merchants visited: 12 (cycle 324 mid-tick)
+- Supervisor: healthy, --check returns exit 0 with deps-warning soft-note
+- Keep-alive state: RUNNING, consecutive_dead=0, last_action=noop
+
+## This Heartbeat Action (BUY-54957)
+- Detected dead worker pid=429805 via --check (worker exited cleanly after cycle 323 signal-end at 11:30:29Z)
+- Verified dead: `ls /proc/429805` -> No such file or directory
+- Restarted via `node scripts/buy31015-deep-page-supervisor.mjs --restart` -> pid=464081
+- Confirmed new worker is setsid-detached (PPID=1, Ssl, --check returns alive=yes)
+- Cycle 324 healthy at 16,281 rows/hr post-restart
+- Posted comment + marked BUY-54957 done
+- Wrote reports/BUY-54957-IMPLEMENTATION.md
+
+## Cycle Progression Since BUY-54940
+| Cycle | Closed/Active | merchants | rowsUpdated | rows/hr | Note |
+|-------|---------------|-----------|-------------|---------|------|
+| 319 | closed (BUY-54940) | 25 | 211 | 11,253 | post-restart healthy |
+| 320 | closed | — | — | — | reaped mid-cycle |
+| 321 | closed | 73 | 535 | 8,503 | reaped mid-cycle |
+| 322 | closed | — | — | — | reaped mid-cycle |
+| 323 | closed | 85 | 540 | 7,253 | reaped at ~11:30Z after harvesting 85 merchants (largest cycle) |
+| 324 | active | 12 | 108 | 16,281 | post-restart healthy (acceleration) |
+
+## Notes
+- Lane is fully operational with supervisor + keepalive cron
+- Worker deaths happen both: (a) clean cycle-end exit (wait for next cron tick to restart), (b) reaped by paperclip-orphan-reaper cron (root, every 5 min, RSS>10MB filter on PPID=1)
+- Supervisor --restart recovers within ~10s of detection
+- Permanent reaper fix still requires root cgroup move (out of Dash scope)
+- BUY-52234 deps check is now scoped appropriately: warning for non-importers, hard-fail (in scripts/buy31015-node-modules-guard.mjs) for lanes that do import
+
+## BUY-55238 Heartbeat (2026-06-22T02:04Z)
+- Latest routine heartbeat: BUY-55238
+- Status: done (closed 2026-06-22T02:04:20Z)
+- Detected dead pid=2983890 via --check at 02:00:33Z (clean cycle-32 exit)
+- Restarted via supervisor --restart -> pid=3033255 setsid-detached (PPID=1, Ssl)
+- Cycle 33 mid-tick: 14 merchants, 108 rows, 7,916 rows/hr
+- Keepalive RUNNING, consecutive_dead=0
+- Worker deaths continue to be clean cycle-end timeouts (--duration-sec=720), not crashes

.dockerignore

@@ -0,0 +1,20 @@
+# Python API - excludes root app/ so Next.js uses src/app not the Python package
+app/
+venv/
+__pycache__/
+*.pyc
+*.pyo
+
+# Large artifacts not needed for Next.js build
+.git/
+.next-deploy/
+node_modules/
+
+# Docs and other non-frontend dirs
+docs-site/
+scraper/
+scrapers/
+tests/
+reports/
+logs/
+data/

.github/ISSUE_TEMPLATE/build-with-buywhere-submission.yml

@@ -0,0 +1,87 @@
+name: Build With BuyWhere Challenge Submission
+description: Submit your AI shopping agent for the Build With BuyWhere Challenge
+title: "[Submission] "
+labels: [challenge, submission]
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for entering the **Build With BuyWhere Challenge**! Fill out the details below and our team will review your submission.
+
+  - type: input
+    id: project-name
+    attributes:
+      label: Project Name
+      description: What did you build?
+      placeholder: e.g. "ShopBot — AI Shopping Assistant"
+    validations:
+      required: true
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: Tell us about your AI shopping agent. What does it do? What problem does it solve?
+      placeholder: Describe your agent, its features, and the real shopping scenarios it handles.
+    validations:
+      required: true
+
+  - type: input
+    id: repo-url
+    attributes:
+      label: Source Repository
+      description: Link to your public GitHub repo.
+      placeholder: https://github.com/your-username/your-agent
+    validations:
+      required: true
+
+  - type: input
+    id: demo-url
+    attributes:
+      label: Demo URL
+      description: Link to a live demo, video, or screencast.
+      placeholder: https://demo.example.com or https://youtube.com/...
+    validations:
+      required: false
+
+  - type: dropdown
+    id: integration-type
+    attributes:
+      label: Integration Type
+      description: How does your agent use BuyWhere?
+      options:
+        - REST API
+        - MCP Server
+        - Both
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: instructions
+    attributes:
+      label: Setup & Usage Instructions
+      description: How do we run or test your agent?
+      placeholder: Steps to set up and use your submission...
+    validations:
+      required: true
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Submission Checklist
+      options:
+        - label: My agent uses BuyWhere's API or MCP tools for at least one core feature
+          required: true
+        - label: My source code is publicly accessible
+          required: true
+        - label: I have included a clear demo or walkthrough
+          required: false
+        - label: My submission is original work
+          required: true
+
+  - type: markdown
+    attributes:
+      value: |
+        By submitting, you agree to the [Challenge Terms](https://buywhere.ai/terms). Good luck! 🚀

.github/__hex-scope-probe.md

@@ -0,0 +1 @@
+TEST

.github/workflows/build-mcp-server.yml

@@ -0,0 +1,57 @@
+name: Build MCP server image
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main]
+    paths:
+      - 'Dockerfile'
+      - 'mcp-server.js'
+      - 'mcp-health-config.js'
+      - '.github/workflows/build-mcp-server.yml'
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}/mcp-server
+
+jobs:
+  build:
+    name: Build and push MCP server image
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to GHCR
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            type=sha,prefix=sha-
+            type=ref,event=branch
+            type=raw,value=latest,enable={{is_default_branch}}
+
+      - name: Build and push
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          file: ./Dockerfile
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

.github/workflows/build-on-push.yml

@@ -0,0 +1,52 @@
+name: Build site image on push to main
+
+on:
+  push:
+    branches: [main]
+
+env:
+  GCP_PROJECT_ID: gaia-calendar-488606
+  GCP_REGION: asia-southeast1
+  ARTIFACT_REGISTRY: asia-southeast1-docker.pkg.dev
+  IMAGE_REPO: cloud-run-source-deploy
+
+jobs:
+  build:
+    name: Build and push site image
+    runs-on: ubuntu-latest
+    outputs:
+      full_image: ${{ steps.tag.outputs.full_image }}
+      image_tag: ${{ steps.tag.outputs.image_tag }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Authenticate to GCP
+        uses: google-github-actions/auth@v2
+        with:
+          credentials_json: ${{ secrets.GCP_SA_KEY }}
+
+      - name: Set up Cloud SDK
+        uses: google-github-actions/setup-gcloud@v2
+        with:
+          project_id: ${{ env.GCP_PROJECT_ID }}
+
+      - name: Configure Docker for Artifact Registry
+        run: gcloud auth configure-docker ${{ env.ARTIFACT_REGISTRY }} --quiet
+
+      - name: Set image tag
+        id: tag
+        run: |
+          TAG="sha-${{ github.sha }}"
+          echo "image_tag=${TAG}" >> "$GITHUB_OUTPUT"
+          FULL_IMAGE="${{ env.ARTIFACT_REGISTRY }}/${{ env.GCP_PROJECT_ID }}/${{ env.IMAGE_REPO }}/site:${TAG}"
+          echo "full_image=${FULL_IMAGE}" >> "$GITHUB_OUTPUT"
+          echo "Built image tag: ${TAG}"
+          echo "Full image: ${FULL_IMAGE}"
+
+      - name: Build and push site image
+        env:
+          FULL_IMAGE: ${{ steps.tag.outputs.full_image }}
+        run: |
+          docker build -t "$FULL_IMAGE" -f site.Dockerfile .
+          docker push "$FULL_IMAGE"
+          echo "Successfully pushed ${FULL_IMAGE}"