@stackmemoryai/stackmemory 1.5.8 → 1.6.0

package/scripts/gepa/generations/gen-001/variant-b.md

@@ -1 +1,216 @@
-API Error: 400 {"type":"error","error":{"type":"invalid_request_error","message":"You have reached your specified API usage limits. You will regain access on 2026-04-01 at 00:00 UTC."},"request_id":"req_011CYrHDkMg9shHV1yKLKZod"}
+```markdown
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Sol is the monorepo for **Rize**, an automatic time tracking application. The stack consists of:
+- **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
+- **vanity/** - Webflow marketing site scripts (deprecated)
+- **voyager/** - Marketing website for home and landing pages (Next.js)
+- **puppet/** - Puppeteer server for images/PDFs
+- **chrome/** - Chrome browser extension
+- **docs/** - Docusaurus documentation site
+- **zapier/** - Zapier integration
+
+## Development Commands
+
+### Starting Development Environment
+```bash
+# Start all services (requires iTerm2 on macOS)
+./scripts/run-dev.sh
+
+# Or start 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
+```
+
+### Docker Dependencies (api/docker-compose.yml)
+```bash
+cd api && docker-compose up -d
+# TimescaleDB: localhost:15432
+# Redis: localhost:16379
+# Kafka: localhost:9092
+# MySQL: localhost:13306
+```
+
+### Testing
+```bash
+# API (RSpec)
+cd api && bundle exec rspec
+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 test at line
+
+# Electron (Jest)
+cd electron && npm test
+cd electron && npm run test:watch
+cd electron && npm run test:coverage
+
+# Web - no active tests (exits 0)
+```
+
+### Building
+```bash
+cd api && bundle install && rake db:migrate
+cd web && npm run build       # Runs gql-gen, tailwind, next build
+cd electron && npm run build  # Electron Forge make
+cd services && bun install
+```
+
+### GraphQL Code Generation
+```bash
+cd web && npm run build       # Includes gql codegen
+cd electron && npm run dev    # Runs gql codegen as part of dev
+```
+
+## Architecture
+
+### GraphQL API Structure
+The API exposes two GraphQL endpoints:
+- **api/v1** - Public API (OAuth consumers, Zapier)
+- **private/v1** - Private API (web, electron apps)
+
+Located at `api/app/graphql/{api,private}/v1/`
+
+<example>
+# Adding a new mutation to the private API:
+# File: api/app/graphql/private/v1/mutations/update_something.rb
+module Private
+  module V1
+    module Mutations
+      class UpdateSomething < BaseMutation
+        argument :id, ID, required: true
+        field :something, Types::SomethingType, null: true
+
+        def resolve(id:)
+          something = Something.find(id)
+          something.update!(...)
+          { something: something }
+        end
+      end
+    end
+  end
+end
+</example>
+
+### Real-time Communication
+- **AnyCable** WebSocket server for subscriptions
+- ActionCable channels in `api/app/channels/`
+- WebSocket config: `api/config/cable.yml` and `api/config/anycable.yml`
+
+### Background Jobs
+- **Sidekiq** for async job processing (`api/config/sidekiq.yml`)
+- **Clockwork** for scheduled jobs (`api/config/clock.rb`)
+
+<example>
+# Adding a new Sidekiq job:
+class MyWorker
+  include Sidekiq::Worker
+  sidekiq_options queue: :default
+
+  def perform(user_id)
+    user = User.find(user_id)
+    # do work
+  end
+end
+
+# Enqueue it:
+MyWorker.perform_async(user.id)
+</example>
+
+### Event Streaming
+- **Kafka** for event publishing/consumption
+- Services consume events via `services/consumers/`
+- Kafka config: `api/config/initializers/kafka.rb`
+
+### Databases
+- **Primary PostgreSQL** - Main application data
+- **TimescaleDB** - Time-series data (separate connection in `database.yml`)
+- **MySQL** - Legacy/external integrations
+- **Redis** - Caching, ActionCable, Sidekiq
+
+## Style Guidelines
+
+### JavaScript/TypeScript
+
+Use `test()` instead of `it()` in tests:
+
+<example>
+// CORRECT
+test('returns the user name', () => {
+  expect(getUser().name).toBe('Alice')
+})
+
+// WRONG
+it('returns the user name', () => {
+  expect(getUser().name).toBe('Alice')
+})
+</example>
+
+Use `toBeCalled()` instead of `toHaveBeenCalledWith()` in jest assertions:
+
+<example>
+// CORRECT
+expect(mockFn).toBeCalled()
+
+// WRONG
+expect(mockFn).toHaveBeenCalledWith(someArg)
+</example>
+
+### Ruby/RSpec
+
+Use `be_between` for time assertions (no `freeze_time` or `travel_to` in this repo):
+
+<example>
+# CORRECT
+before = Time.current
+subject.call
+after = Time.current
+expect(record.updated_at).to be_between(before, after)
+
+# WRONG - freeze_time not available
+freeze_time do
+  subject.call
+  expect(record.updated_at).to eq(Time.current)
+end
+</example>
+
+Use `create(:user_with_default_workspace)` for a user with identity + workspace:
+
+<example>
+let(:user) { create(:user_with_default_workspace) }
+let(:identity) { user.identities.first }
+let(:workspace) { identity.workspaces.first }
+</example>
+
+Use `private_v1_execute_query` / `private_v1_execute_mutation` in GraphQL specs:
+
+<example>
+RSpec.describe 'someQuery', type: :request do
+  let(:user) { create(:user_with_default_workspace) }
+
+  it 'returns expected data' do
+    private_v1_execute_query(
+      query: SOME_QUERY,
+      variables: { id: user.id },
+      user: user
+    )
+    expect(response_data['someQuery']['field']).to eq('value')
+  end
+end
+</example>
+
+## Key Configuration Files
+
+- `api/config/database.yml` - Database connections (primary + timescale)
+- `api/config/cable.yml` - AnyCable WebSocket config
+- `api/Procfile.dev` - Development processes (rails, anycable, sidekiq, clockwork)
+- `sol.code-workspace` - VS Code multi-folder workspace
+- Each project requires its own `.env` file (not in repo)
+```

package/scripts/gepa/generations/gen-001/variant-c.md

@@ -1 +1,83 @@
-API Error: 400 {"type":"error","error":{"type":"invalid_request_error","message":"You have reached your specified API usage limits. You will regain access on 2026-04-01 at 00:00 UTC."},"request_id":"req_011CYrHEfNKPYQGLekuXZCrz"}
+```markdown
+# CLAUDE.md
+
+Sol is the monorepo for **Rize**, an automatic time tracking application.
+
+## 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 (Next.js)
+- **puppet/** - Puppeteer server for images/PDFs
+- **chrome/** - Chrome browser extension
+- **docs/** - Docusaurus documentation site
+- **zapier/** - Zapier integration
+- **vanity/** - Webflow scripts (deprecated)
+
+## Development Commands
+
+```bash
+# Start all (requires iTerm2)
+./scripts/run-dev.sh
+
+# Individual services
+cd api && hivemind Procfile.dev      # Rails + AnyCable + Sidekiq + Clockwork
+cd web && npm run dev                # Next.js (port 3001)
+cd electron && npm run dev           # Electron + gql codegen
+cd services && hivemind Procfile.dev # Bun consumers
+
+# Docker deps (TimescaleDB:15432, Redis:16379, Kafka:9092, MySQL:13306)
+cd api && docker-compose up -d
+```
+
+## Testing & Building
+
+```bash
+# API (RSpec)
+cd api && bundle exec rspec
+cd api && bundle exec rspec spec/path/to/file_spec.rb:42
+
+# Electron (Jest)
+cd electron && npm test
+
+# Web - no active tests (exits 0)
+
+# Build
+cd api && bundle install && rake db:migrate
+cd web && npm run build       # gql-gen + tailwind + next build
+cd electron && npm run build
+cd services && bun install
+```
+
+## Architecture
+
+### GraphQL API
+Two endpoints at `api/app/graphql/{api,private}/v1/`:
+- **api/v1** - Public API (OAuth, Zapier)
+- **private/v1** - Private API (web, electron)
+
+### Infrastructure
+- **AnyCable** WebSocket subscriptions (`api/config/cable.yml`, `anycable.yml`)
+- **Sidekiq** async jobs (`api/config/sidekiq.yml`)
+- **Clockwork** scheduled jobs (`api/config/clock.rb`)
+- **Kafka** event streaming (`api/config/initializers/kafka.rb`, `services/consumers/`)
+
+### Databases
+- **PostgreSQL** - Primary app data
+- **TimescaleDB** - Time-series (separate connection in `database.yml`)
+- **MySQL** - Legacy integrations
+- **Redis** - Caching, ActionCable, Sidekiq
+
+## Style Guidelines
+
+### JavaScript/TypeScript
+- Use `test()` not `it()` in tests
+- Use `toBeCalled()` not `toHaveBeenCalledWith()` in Jest assertions
+
+## Key Config Files
+- `api/config/database.yml` - DB connections
+- `api/Procfile.dev` - Dev processes
+- `sol.code-workspace` - VS Code workspace
+- Each project requires its own `.env` (not in repo)
+```

package/scripts/gepa/generations/gen-001/variant-d.md

@@ -1 +1,90 @@
-API Error: 400 {"type":"error","error":{"type":"invalid_request_error","message":"You have reached your specified API usage limits. You will regain access on 2026-04-01 at 00:00 UTC."},"request_id":"req_011CYrHFtqie98MEfrzJptbx"}
+```markdown
+# CLAUDE.md
+
+Sol is the monorepo for **Rize**, an automatic time tracking application.
+
+## Stack
+
+| Dir | Description |
+|-----|-------------|
+| `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 (Next.js) |
+| `puppet/` | Puppeteer server for images/PDFs |
+| `chrome/` | Chrome browser extension |
+| `docs/` | Docusaurus documentation site |
+| `zapier/` | Zapier integration |
+| `vanity/` | Webflow scripts (deprecated) |
+
+## Dev Commands
+
+```bash
+# All services (requires iTerm2)
+./scripts/run-dev.sh
+
+# Individual
+cd api && hivemind Procfile.dev      # Rails + AnyCable + Sidekiq + Clockwork
+cd web && npm run dev                # Next.js (port 3001)
+cd electron && npm run dev           # Electron with hot reload
+cd services && hivemind Procfile.dev # Bun services
+
+# Docker deps (start first)
+cd api && docker-compose up -d
+# TimescaleDB :15432 | Redis :16379 | Kafka :9092 | MySQL :13306
+```
+
+## Testing
+
+```bash
+# API (RSpec)
+cd api && bundle exec rspec
+cd api && bundle exec rspec spec/path/to/file_spec.rb
+cd api && bundle exec rspec spec/path/to/file_spec.rb:42
+
+# Electron (Jest)
+cd electron && npm test
+cd electron && npm run test:watch
+cd electron && npm run test:coverage
+
+# Web - no active tests (exits 0)
+```
+
+## 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
+```
+
+GraphQL codegen: runs in `web && npm run build` and `electron && npm run dev`.
+
+## Architecture
+
+### GraphQL Endpoints
+- `api/v1` — Public API (OAuth, Zapier) → `api/app/graphql/api/v1/`
+- `private/v1` — Private API (web, electron) → `api/app/graphql/private/v1/`
+
+### Infrastructure
+- **WebSockets**: AnyCable (`api/config/cable.yml`, `anycable.yml`), channels in `api/app/channels/`
+- **Jobs**: Sidekiq async (`api/config/sidekiq.yml`), Clockwork scheduled (`api/config/clock.rb`)
+- **Events**: Kafka (`api/config/initializers/kafka.rb`), consumers in `services/consumers/`
+- **Databases**: PostgreSQL (primary), TimescaleDB (time-series), MySQL (legacy), Redis (cache/cable/sidekiq)
+
+## Style Guidelines
+
+### JavaScript/TypeScript Tests
+- Use `test()` not `it()`
+- Use `toBeCalled()` not `toHaveBeenCalledWith()`
+
+## Key Config Files
+
+- `api/config/database.yml` — DB connections (primary + timescale)
+- `api/config/cable.yml` — AnyCable WebSocket
+- `api/Procfile.dev` — Dev processes
+- `sol.code-workspace` — VS Code workspace
+- Each project requires its own `.env` (not in repo)
+```