@stackmemoryai/stackmemory 1.6.0 → 1.6.1

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

@@ -1,216 +0,0 @@
-```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,83 +0,0 @@
-```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,90 +0,0 @@
-```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)
-```