Skip to content

chore(memory): add Phase E + sandbox-gate + runbook-verification lessons#122

Merged
RJK134 merged 4 commits into
mainfrom
chore/memory-updates
May 8, 2026
Merged

chore(memory): add Phase E + sandbox-gate + runbook-verification lessons#122
RJK134 merged 4 commits into
mainfrom
chore/memory-updates

Conversation

@RJK134

@RJK134 RJK134 commented May 8, 2026

Copy link
Copy Markdown
Owner

Summary

Three new entries to .claude/memory.md capturing lessons from the 2026-05-08 session that future Claude sessions need.

Lesson Why future sessions need it
Sandbox local gate works after npm install (~2 min) Saves a CI cycle on first-pass code edits — catches component-prop / unused-import / Prisma-schema errors before push
Verify file paths + response shapes with grep before writing operator docs PR #121 first draft had 8 factual errors Copilot caught (pointed at non-existent audit.service.ts, wrong endpoint for outbound WhatsApp) — never write a runbook claim without verifying it first
Phase E semantic: pendingRecallsCount is "pending actions, not horses" Future extensions to the recall workspace must keep dashboard tile and /api/recalls row count aligned — a single horse.count with OR deduplicates per horse and breaks the alignment

Test plan

  • CI passes (no code surface — pure markdown additions).
  • Reviewer opens .claude/memory.md and confirms the three new entries are present and dated.

Stop-gate

Final merge belongs to Richard or Freddie. Tiny chore PR; safe to merge once CI is green.

https://claude.ai/code/session_01JBMfnqc8QXZRqCG3Tm7hHx


Generated by Claude Code


Note

Low Risk
Low risk documentation-only change: adds session memory notes without modifying runtime code or behavior.

Overview
Adds three new dated entries to .claude/memory.md: guidance that local npm install enables running the full pre-push check gate (and that SKIP_ENV_VALIDATION=true is needed for Vercel-style builds), a rule to grep/verify paths and endpoint behaviors before writing operator runbooks, and a reminder that Phase E’s pendingRecallsCount represents pending actions (separate dental/vaccination counts summed) to keep dashboard totals aligned with recall rows.

Reviewed by Cursor Bugbot for commit 03ab8be. Configure here.

Three new entries to .claude/memory.md based on lessons earned in
the 2026-05-08 session.

- Sandbox local gate (2026-05-08): npm install completes in ~2 min
  and enables the full five-check gate locally. Saves a CI cycle on
  first-pass code edits. Build needs SKIP_ENV_VALIDATION=true to
  bypass scripts/check-env.ts in this sandbox.

- Runbook verification rule (2026-05-08): verify every file path /
  response shape / endpoint behaviour with grep against the actual
  code before writing it in operator-facing docs. PR #121 first
  draft had 8 factual errors caught by Copilot review — including
  pointing operators at a non-existent audit.service.ts and at
  /api/demo/simulate-whatsapp (which is inbound-only) for outbound
  WhatsApp testing.

- Phase E semantics (2026-05-08): /api/dashboard pendingRecallsCount
  is "pending recall actions" (sum of dental + vaccination counts),
  matching the recalls page row count exactly. Future extensions to
  the recall workspace should preserve the "actions, not horses"
  semantic — a single horse.count with OR would deduplicate per
  horse and produce a count that disagrees with /api/recalls totals.

Other entries already present from PR #115's memory updates:
form-encoded sign-in trap, prod-DB 0-invoices state, 9-template
count, Vercel MCP zero-team-scope, 25 UAT cases, lifecycle exercise.

https://claude.ai/code/session_01JBMfnqc8QXZRqCG3Tm7hHx
@vercel

vercel Bot commented May 8, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
equismile Error Error May 8, 2026 9:31pm

Request Review

@RJK134 RJK134 marked this pull request as ready for review May 8, 2026 16:36
Copilot AI review requested due to automatic review settings May 8, 2026 16:36
@RJK134 RJK134 enabled auto-merge (squash) May 8, 2026 16:37

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the internal session-memory file (.claude/memory.md) to capture three lessons from the 2026-05-08 session, intended to improve future agent workflows (local validation before push, runbook claims verified via grep, and the Phase E “actions not horses” recall-count semantic).

Changes:

  • Add a note that local installs in this sandbox are fast enough to run the full local pre-push validation gate.
  • Add a note to verify operator runbook claims (paths/endpoints/response shapes) against the codebase before documenting them.
  • Add a note clarifying Phase E recall semantics so dashboard and recalls page counts stay aligned.

Comment thread .claude/memory.md Outdated
Comment thread .claude/memory.md Outdated
- Add `npx prisma validate` to the gate list so it matches the
  "five-check" label and CLAUDE.md's standing rule.
- Reword the SKIP_ENV_VALIDATION note: clarify it's a local/sandbox
  bypass only, never to be set on Vercel project env (which must
  run check-env normally).

https://claude.ai/code/session_01JBMfnqc8QXZRqCG3Tm7hHx
Comment thread .claude/memory.md Outdated
Comment thread .claude/memory.md Outdated
Comment thread .claude/memory.md Outdated
VADE review nit on PR #122 — standing rule lists prisma validate
before test; the session-note line had them swapped. Reordered to
lint -> typecheck -> prisma validate -> test -> build for
consistency.

https://claude.ai/code/session_01JBMfnqc8QXZRqCG3Tm7hHx
@RJK134

RJK134 commented May 8, 2026

Copy link
Copy Markdown
Owner Author

@copilot apply changes based on the comments in this thread

auto-merge was automatically disabled May 8, 2026 21:31

Head branch was pushed to by a user without write access

Copilot AI commented May 8, 2026

Copy link
Copy Markdown
Contributor

@copilot apply changes based on the comments in this thread

Applied and pushed in edea4e7. I updated .claude/memory.md so the env-bypass line now explicitly scopes SKIP_ENV_VALIDATION=true to local/sandbox/CI stub builds, while keeping real Vercel deploys on normal check-env.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

  • checkpoint.prisma.io
    • Triggering command: /opt/hostedtoolcache/node/24.14.1/x64/bin/node /opt/hostedtoolcache/node/24.14.1/x64/bin/node /home/REDACTED/work/EquiSmile/EquiSmile/node_modules/prisma/build/child {"product":"prisma","version":"6.19.3","cli_install_type":"local","information":"","local_timestamp":"2026-05-08T21:29:56Z","project_hash":"d7fc30d6","cli_path":"/home/REDACTED/work/EquiSmile/EquiSmile/node_modules/.bin/prisma","cli_path_hash":"b3daa67a","e (dns block)
    • Triggering command: /opt/hostedtoolcache/node/24.14.1/x64/bin/node /opt/hostedtoolcache/node/24.14.1/x64/bin/node /home/REDACTED/work/EquiSmile/EquiSmile/node_modules/prisma/build/child {"product":"prisma","version":"6.19.3","cli_install_type":"local","information":"","local_timestamp":"2026-05-08T21:29:58Z","project_hash":"d7fc30d6","cli_path":"/home/REDACTED/work/EquiSmile/EquiSmile/node_modules/.bin/prisma","cli_path_hash":"b3daa67a","e (dns block)
    • Triggering command: /opt/hostedtoolcache/node/24.14.1/x64/bin/node /opt/hostedtoolcache/node/24.14.1/x64/bin/node /home/REDACTED/work/EquiSmile/EquiSmile/node_modules/prisma/build/child {"product":"prisma","version":"6.19.3","cli_install_type":"local","information":"","local_timestamp":"2026-05-08T21:30:41Z","project_hash":"d7fc30d6","cli_path":"/home/REDACTED/work/EquiSmile/EquiSmile/node_modules/.bin/prisma","cli_path_hash":"b3daa67a","e sh -c node scripts/preinstall-entry.js (dns block)
  • fonts.googleapis.com
    • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node node /home/REDACTED/work/EquiSmile/EquiSmile/node_modules/.bin/next build sh -c node postinstall.js (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated no new comments.

@RJK134 RJK134 requested a review from Copilot May 8, 2026 21:51
@RJK134

RJK134 commented May 8, 2026

Copy link
Copy Markdown
Owner Author

@copilot apply changes based on the comments in this thread

@RJK134 RJK134 merged commit bbdf254 into main May 8, 2026
12 of 14 checks passed
@RJK134 RJK134 deleted the chore/memory-updates branch May 8, 2026 21:52
Copilot stopped work on behalf of RJK134 due to an error May 8, 2026 21:52

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 1 comment.

Comment thread .claude/memory.md
Comment on lines +95 to +97
enables the full local five-check gate (`npm run lint`,
`npm run typecheck`, `npx prisma validate`, `npm run test`,
`npm run build`). Run before push to catch component-prop /
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants