chore: update gepa baselines and clean GitButler hooks

Author: StackMemory Bot (CLI)

.husky/post-checkout

@@ -1,198 +1,72 @@
-# CLAUDE.md
+# croissant.ai — Agent Guide
 
-You are a senior full-stack engineer working on **Sol**, the monorepo for Rize — an automatic time tracking application. Read the relevant code before making changes. Quote the specific code you're modifying when explaining changes.
+Tool-agnostic reference for AI coding agents working in this repository.
 
-## Project Overview
+## Stack
 
-- **api/** — Rails 7.1 GraphQL backend (Ruby 3.3.5)
-- **web/** — Next.js 14 React web app (Node 22)
-- **electron/** — Electron desktop app (Node 22)
-- **services/** — Bun-based TypeScript event consumers/workers
-- **voyager/** — Marketing website and landing pages (Next.js)
-- **scripts/** — Automation scripts (categorized by side-effect type)
-- **puppet/** — Puppeteer server for images/PDFs
-- **chrome/** — Chrome browser extension
-- **docs/** — Docusaurus documentation site
-- **zapier/** — Zapier integration
+Node.js / Express / PostgreSQL / Redis
+Railway deployment | Stripe / Salesforce / QuickBooks integrations
 
-## Development Commands
+## Project Structure
 
-```bash
-# Start all services (requires iTerm2 on macOS)
-./scripts/run-dev.sh
-
-# Or individually:
-cd api && hivemind Procfile.dev       # Rails + AnyCable + Sidekiq + Clockwork
-cd web && npm run dev                 # Next.js dev server
-cd electron && npm run dev            # Electron with hot reload
-cd services && hivemind Procfile.dev  # Bun services
-cd voyager && npm run dev             # Marketing site (port 3003)
 ```
-
-### Docker (start first)
-```bash
-cd api && docker-compose up -d
-# TimescaleDB :15432 | Redis :16379 | Kafka :9092 | MySQL :13306
+src/
+  api/          # Route handlers
+  core/         # monitoring-service, cache-service, queue-service, master-agent, api-validation
+  features/     # Feature modules
+  shared/       # Shared utilities
+  integrations/ # Third-party connectors
+docs/           # Documentation
+scripts/        # Automation scripts
+docker/         # Container configs
+prompts/        # Externalized LLM prompt templates
 ```
 
-### Testing
-```bash
-cd api && bundle exec rspec                              # Full API suite
-cd api && bundle exec rspec spec/path/to/file_spec.rb    # Single file
-cd api && bundle exec rspec spec/path/to/file_spec.rb:42 # Single line
-cd electron && npm test                                  # Electron (Jest)
-# Web — no active tests
-```
+## Commands
 
-### Building
 ```bash
-cd api && bundle install && rake db:migrate
-cd web && npm run build        # gql-gen + tailwind + next build
-cd electron && npm run build   # Electron Forge make
-cd services && bun install
+npm run dev       # Start dev server
+npm run test      # Run test suites (3 parallel Jest workers, maxWorkers=4)
+npm run lint      # Lint check
+npm run migrate   # Run DB migrations
+docker-compose up -d   # Start local DBs
 ```
 
-## Architecture
-
-### GraphQL API
-Two endpoints: `api/v1` (public — OAuth, Zapier) and `private/v1` (web, electron). Located at `api/app/graphql/{api,private}/v1/`.
-
-### Background Processing
-- **Sidekiq** for async jobs (`api/config/sidekiq.yml`) — use `perform_async`, not `perform_later` (ApplicationJob uses Sidekiq::Worker, not ActiveJob)
-- **Clockwork** for scheduled jobs (`api/config/clock.rb`)
-- **Kafka** for event streaming (`services/consumers/`)
-
-### Databases
-PostgreSQL (primary) + TimescaleDB (time-series, separate connection) + MySQL (legacy) + Redis (cache, ActionCable, Sidekiq)
-
-### Real-time
-AnyCable WebSocket server for subscriptions. Channels in `api/app/channels/`.
-
-## Code Patterns
-
-### Ruby/Rails
-- Controllers validate + enqueue async jobs. Jobs handle business logic. Models handle delivery.
-- Webhook controllers: `skip_before_action :authenticate_user!` + shared secret verification
-- `CanonicalEmail.find_by_canonical(email:)` — uses `email_address` gem canonicalization; stub in tests
-- `Identity#first_name` is a computed method (from `name` via `Nameable::Latin`), not a column
-- `generate_hash_authentication_settings_url` calls `update!` internally — stub in tests via `allow_any_instance_of(Identity)`
-- Test env uses `cache_store: :null_store` — swap to `MemoryStore` in `around` block for cache tests
-- Postmark emails: all go through `PostmarkClient.deliver_in_batches_with_templates` with required keys: `email_enabled`, `email_bounced`, `message_stream`
-- Prefer `be_between(before, after)` for time assertions (no `freeze_time` or `travel_to`)
-
-### JavaScript/TypeScript
-- Use `test()` instead of `it()` in Jest tests
-- Use `toBeCalled()` instead of `toHaveBeenCalledWith()` in assertions
-- ESM: add `.js` extension to relative imports
-
-### Error Handling
-- Prefer returning undefined over throwing exceptions
-- Log and continue rather than crashing — filter nulls at boundaries
-- Validate inputs at system boundaries (user input, external APIs, webhooks)
-
-## Scripts (`scripts/`)
-
-Standalone Node.js `.mjs` automation — outreach, content, analytics, CRM sync. Organized by side-effect type:
-
-- **`scripts/commit/`** — Scripts that produce repo artifacts (PRs, committed files). Includes `feedback/` for feedback collection and `profound-briefs/` for AEO pulse output.
-- **`scripts/ops/`** — Marketing motions with external side effects (CRM sync, outreach, social content).
-- **`scripts/diag/`** — Read-only diagnostics (pipeline health checks, demo scorecards).
-- **`scripts/data/`** — Committed data artifacts (ICP keywords, pipeline config, profound learnings/snapshots).
-- **`scripts/lib/`** — Shared utilities (Attio, Claude, Fathom, Slack, dates, prompts).
-
-Scheduled via GitHub Actions cron. All scheduled workflows support `workflow_dispatch` for manual runs.
-
-**GitHub Actions limit:** `workflow_dispatch` allows max 25 `inputs`. `weekly-start.yml` has 22/25 inputs. Feedback is consolidated into a single JSON `feedback` input: `{"social":"...","aeo":"...","blog":"...","snitcher":"..."}`.
-
-### Slack `/run` command
-When adding or renaming GitHub Actions workflows that should be triggerable via Slack, update the `WORKFLOWS` hash in `api/app/jobs/trigger_github_workflow_job.rb`. When deleting a workflow, remove it from the hash. The Slack `/run` command reads this mapping to dispatch workflows.
-
-### Workflow → Script mapping
-
-| Workflow | Script path | Category |
-|---|---|---|
-| `weekly-start.yml` | `voyager/scripts/content-brief.mjs` + `voyager/scripts/content-audit.mjs` + `ops/fathom-social-content.mjs` + `ops/fathom-testimonial-scan.mjs` + `ops/perplexity-citation-audit.mjs` + `commit/profound-aeo-pulse.mjs` + `voyager/scripts/generate-blog-scaffold.mjs` + `ops/ahrefs-firehose-digest.mjs` + `ops/export-dripify.mjs` + `commit/prospect-discovery.mjs` + `ops/repush-clay-leads.mjs` + `ops/snitcher-outreach.mjs` | GHA cron (Mon) |
-| `weekly-end.yml` | `diag/fathom-demo-scorecard.mjs` + `commit/feedback/collect-*.mjs` | GHA cron (Fri) |
-| `anneal-keywords.yml` | `commit/anneal-keywords.mjs` | GHA cron (Sun) |
-| `g2-review-monitor.yml` | `ops/g2-to-senja.mjs` | GHA cron (Daily) |
-| `testimonial-pipeline.yml` | `commit/testimonial-pipeline.mjs` | Manual |
-| `video-pipeline.yml` | `ops/video-clips.mjs` | Manual |
-| `pagespeed-audit.yml` | `diag/pagespeed-audit.mjs` + `commit/pagespeed-improvements.mjs` | GHA cron (1st of month) |
-| `daily-ops.yml` | `ops/slack-digest.mjs` + `ops/fathom-meeting-digest.mjs` + `ops/ops-daily-briefing.mjs` | GHA cron (weekdays) |
-| `indexnow-submit.yml` | (inline curl) | Push to master (voyager) / Manual |
-
-## GitHub Actions (`.github/workflows/`)
-
-### CI/CD (PR-triggered)
-- `test-api.yml` — RSpec on PR to `api/`
-- `review-voyager-seo.yml` — SEO/AEO/GEO review on PR to `voyager/`
-- `main.yml` — Deploy API/Web/Services/Docs/Voyager to staging on merge to master
-- `deploy-production.yml` — Manual sequential prod deploy (API → Services → Web)
-
-### GitHub Actions gotcha
-In `actions/github-script@v7`, `github.rest.issues.createComment` posts plain issue comments on PRs (PRs are issues in GitHub's API). For inline code suggestions on specific files/lines, use `github.rest.pulls.createReview` or `github.rest.pulls.createReviewComment` instead.
-
-### Scheduled (cron)
-- `weekly-start.yml` — Mon 9am ET (content review, social content, testimonial scan, Perplexity audit, AEO pulse → blog scaffold, Ahrefs digest, Dripify export, prospect discovery → snitcher outreach)
-- `weekly-end.yml` — Fri 9am ET (demo scorecard + pipeline health)
-- `anneal-keywords.yml` — Sun 11am ET (keyword annealing + kill pattern updates)
-- `g2-review-monitor.yml` — Daily 10am ET
-- `pagespeed-audit.yml` — 1st of month 9am ET (PSI audit → Claude recommendations → PR)
-- `daily-ops.yml` — Weekdays 10am ET (signal monitor, G2 reviews, review intercept, Slack digest → meeting digest → daily briefing)
-- `indexnow-submit.yml` — On push to master (voyager pages) + manual (`/run indexnow urls=...`)
+## Git Conventions
 
-## Deployments
+- Branch prefixes: `feature/`, `fix/`, `chore/`
+- Commit format: `type(scope): message`
+- Do NOT add `Co-Authored-By` lines to commits
+- Pre-commit hook runs: `npm run lint` + `npm run test` + E2E browser screenshots
 
-### Staging (auto on merge to master)
-- **API, Web, Services** — GCP Cloud Run via Docker (Artifact Registry)
-- **Voyager** — GCP Cloud Run
-- **Docs** — Heroku
+## Testing Rules
 
-### Production (manual `workflow_dispatch` only)
-- Sequential: API → 5min wait → Services → 5min wait → Web
-- `gh workflow run deploy-production.yml --ref master`
+- **Framework**: Jest + SWC
+- **DB mocking**: Use dependency injection (DI), not global mocks
+- **Supertest**: Pass `app` (NOT `server`) to supertest
+- **Global jest**: src/ tests use global `jest` — do NOT import from `@jest/globals` (causes redeclaration errors)
+- **Mock reset**: `jest.clearAllMocks()` resets `mockReturnValue` — always re-set mocks in `beforeEach`
+- **Test runner**: `npm test` is long-running; run in a background process or sub-agent, not inline
 
-## Voyager Content
+## ESLint Rules
 
-Blog posts in `voyager/src/content/blog/*.mdx`. See `voyager/CLAUDE.md` for tone of voice, banned words, and content rules.
-
-Key patterns:
-- Blog JSON-LD (BlogPosting) in `voyager/src/modules/blogJsonLd.js`
-- FAQ structured data via `faqs` frontmatter array in blog MDX files
-- Sitemap auto-includes all posts via `voyager/src/app/sitemap.js`
-- Blog scaffold: `voyager/scripts/generate-blog-scaffold.mjs` (or `npm run content:scaffold`)
-- Analytics events: `voyager/src/modules/analytics.js`
-- Route paths: `voyager/src/utils/locations.js`
-
-## Style
-
-### Commits
-- Plain imperative sentences, no conventional commit prefixes
-- Short and direct — describe what, not why
-
-### Code
-- Read before writing. Edit over rewrite. No docs unless asked.
-- KISS / YAGNI / SOLID. Under 20 lines per function.
-- Comments only for complex logic. No emojis in code.
-- When blocked, try an alternative approach before asking. Explain what you tried and why it failed.
-- Review your changes against the task requirements before reporting completion.
-
-## Knowledge Skills (.claude/skills/knowledge/)
+- Use `catch {}` not `catch (_err) {}` — underscore prefix not in the allowed pattern
+- CJS format for JS files in `src/`
 
-Project-specific knowledge skills load automatically when prompts match `activates_on` keywords. They provide current API patterns, SDK versions, and gotchas that prevent hallucination.
-
-**When to suggest a new skill:** If you encounter a repeatable workflow where you got something wrong (wrong API shape, deprecated pattern, incorrect filter field), suggest creating a knowledge skill for it. Format: "This would be a good candidate for a `.claude/skills/knowledge/<name>.skill.md` — want me to create one?"
+## Key Patterns
 
-Current skills: `postmark-email`, `nextjs-app-router`, `profound-mcp`, `greptile-review`, `tailwind-v4-design`, `rails-graphql-mutations`, `rails-sidekiq-clockwork`, `rails-billing-identity`, `electron-store-ipc`, `chrome-extension`, `blog-hero-images`
+- Provenance tracking: every data point includes source, timestamp, lineage
+- Multi-tenant container isolation
+- DI route factories for testability
+- Error handling: return undefined over throwing; log and continue over crashing
+- Add `.js` extension to relative ESM imports
 
-## Key Files
+## StackMemory Context Rule
 
-- `api/config/database.yml` — DB connections (primary + timescale)
-- `api/config/sidekiq.yml` — Job queues and concurrency
-- `api/config/clock.rb` — Scheduled jobs (Clockwork)
-- `api/Procfile.dev` — Dev processes
-- `api/app/services/postmark_client.rb` — Email delivery (all Postmark goes through here)
-- `api/app/services/drip_campaign_config.rb` — Drip email templates + required keys
-- `voyager/CLAUDE.md` — Blog tone, banned words, content rules
-- `sol.code-workspace` — VS Code workspace
-- Each project requires its own `.env` file (not in repo)
+- When an agent fetches conversation context for active work, it must pass the exact current assignment or question as `task_query`.
+- Prefer the MCP shape:
+  - `org_id`
+  - `conversation_id`
+  - `task_query`
+  - `recover_on_low_signal: true`
+- Do not fetch raw `get_conversation` context for worker execution unless full transcript behavior is explicitly required.