chore(public): harden repo for public rollout

Author: miccy

.github/workflows/ci.yaml

@@ -93,10 +93,12 @@ jobs:
         uses: oven-sh/setup-bun@4bc047ad259df6fc24a6c9b0f9a0cb08cf17fbe5 # v2.0.1
         with:
           bun-version: "1.3.10"
-
       - name: Install dependencies
         run: bun install
 
+      - name: Build workspace packages
+        run: bun run build
+
       - name: Run active coverage lane
         run: bun run coverage:lane:active
 
@@ -153,10 +155,12 @@ jobs:
         uses: oven-sh/setup-bun@4bc047ad259df6fc24a6c9b0f9a0cb08cf17fbe5 # v2.0.1
         with:
           bun-version: "1.3.10"
-
       - name: Install dependencies
         run: bun install
 
+      - name: Build workspace packages
+        run: bun run build
+
       - name: Expo doctor
         working-directory: examples/react-expo
         continue-on-error: true

.gitignore

@@ -21,3 +21,5 @@ tmp
 __screenshots__
 *.tsBuildInfo
 .generated
+
+.ai/

AGENTS.md

@@ -1,127 +1,39 @@
-# AI Assistant Instructions: evolu-plan-b
+# Repository Notes for Contributors
 
-> **Full context**: See `.ai/` directory for detailed instructions and active tasks.
+This file is intentionally public-safe and minimal.
 
-## 🎯 This Repository
+## Purpose
 
-**Evolu Plan B** - Fork of [evoluhq/evolu](https://github.com/evoluhq/evolu) with:
-- **Bun** as package manager and runtime (not pnpm/Node)
-- **Biome** for linting and formatting (not ESLint/Prettier)
-- Reduced dependencies
-- SQLoot-specific enhancements
+`evolu-plan-b` is SQLoot's Bun + Biome fork of Evolu with focus on:
 
-## 📊 Quick Context
+- upstream compatibility,
+- measurable CI/benchmark quality,
+- practical local-first runtime hardening.
 
-| Aspect           | Value         |
-| ---------------- | ------------- |
-| Package Manager  | Bun 1.3.9     |
-| Node.js          | >=24.0.0      |
-| Linter/Formatter | Biome 2.4.0   |
-| Test Framework   | Vitest        |
-| Upstream         | evoluhq/evolu |
+## Development Baseline
 
-## 🗂️ Repository Structure
+- Package manager: `bun`
+- Lint/format: `biome`
+- TypeScript: strict mode
+- Main quality gate: `bun run verify`
 
-```
-evolu-plan-b/
-├── apps/
-│   ├── relay/          # Sync relay server
-│   └── web/            # Documentation (Dan's) - TO BE REMOVED
-├── packages/
-│   ├── common/         # Core logic, CRDTs, sync
-│   ├── web/            # Browser adapter (wa-sqlite)
-│   ├── react/          # React bindings
-│   ├── react-web/      # React + web combined
-│   ├── react-native/   # React Native adapter
-│   ├── nodejs/         # Node.js adapter
-│   ├── svelte/         # Svelte bindings
-│   ├── vue/            # Vue bindings
-│   └── tsconfig/       # Shared TS config
-├── examples/           # Framework examples - MIGRATING TO bench-suite
-└── .ai/                # AI agent context
-```
-
-## 🔧 Common Commands
-
-```bash
-# Development
-bun install              # Install dependencies
-bun run dev              # Start dev mode (packages + web + relay)
-bun run build            # Build all packages
-
-# Testing
-bun run test             # Run tests
-bun run test:coverage    # Tests with coverage
-bun run test:watch       # Watch mode
-
-# Quality
-bun run lint             # Lint with Biome
-bun run format           # Format with Biome
-bun run verify           # Full verification (build + lint + test)
-
-# Release
-bun run changeset        # Add changeset
-bun run version          # Bump versions
-bun run release          # Publish packages
-```
+## Core Commands
 
-## 🔄 Upstream Sync Strategy
-
-This fork cherry-picks from upstream. Dan (@steida) pushes frequently without warning.
-
-**Branches:**
-- `main` - Stable
-- `sync/upstream-main` - Tracking upstream/main
-- `sync/upstream-common-v8` - Tracking upstream/common-v8 (new Task architecture)
-- `feat/*` - Feature branches
-
-**Workflow:**
 ```bash
-git fetch upstream
-git cherry-pick <commit>  # Pick specific commits
-# Resolve conflicts, especially in lock files and CI
+bun install
+bun run build
+bun run test
+bun run lint
 bun run verify
 ```
 
-## ⚠️ Key Differences from Upstream
-
-1. **Bun over pnpm** - All commands use `bun`
-2. **Biome over ESLint** - Single tool for lint + format
-3. **No `apps/web`** - Dan's docs site will be removed
-4. **Examples migrating** - Moving to `bench-suite` repo
-
-## 📍 Related Resources
-
-| Resource     | Location                            |
-| ------------ | ----------------------------------- |
-| Issues       | `../knowledge/05-Issues/`           |
-| Roadmap      | `../knowledge/01-Vision/ROADMAP.md` |
-| Architecture | `../knowledge/02-Architecture/`     |
-| Bench Suite  | `../bench-suite/` (sibling repo)    |
-| Upstream     | https://github.com/evoluhq/evolu    |
-
-## 🤖 For AI Agents
-
-### Do
-- Use Bun for all package operations
-- Run `bun run verify` before suggesting PR
-- Check `.ai/tasks/active/` for current work
-- Reference upstream issues with `upstream#`
-
-### Don't
-- Use npm/pnpm/yarn
-- Suggest ESLint/Prettier configs
-- Modify `apps/web/` (it's going away)
-- Add unnecessary dependencies
+## Security
 
-### Context Priority
-1. This file
-2. `.ai/README.md`
-3. `.ai/tasks/active/*.md`
-4. `../knowledge/01-Vision/ROADMAP.md`
+- Never commit secrets or credentials.
+- Use responsible disclosure process from `SECURITY.md`.
 
----
+## Contribution
 
-<div align="center">
-  <a href="https://github.com/SQLoot/evolu-plan-b">SQLoot/evolu-plan-b</a>
-</div>
+- Keep changes focused.
+- Add/update tests for behavioral changes.
+- Update docs when behavior or workflows change.

README.md

@@ -11,6 +11,12 @@ Primary goals:
 
 Evolu is a TypeScript library and local-first platform.
 
+## 🪴 Project Activity
+
+<p align="center">
+  <img src="https://repobeats.axiom.co/api/embed/<hash>.svg" alt="Repobeats analytics image" />
+</p>
+
 ## Integration Matrix
 
 Coverage snapshot date: `2026-02-27` (from `bun run test:coverage` and `bun run test:coverage:bun`).

renovate.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
+  "extends": ["config:recommended"],
+  "dependencyDashboard": true,
+  "dependencyDashboardApproval": true,
+  "packageRules": [
+    {
+      "description": "Ignore changesets/action due to workflow file protection",
+      "matchManagers": ["github-actions"],
+      "matchPackageNames": ["changesets/action"],
+      "enabled": false
+    }
+  ]
+}