Skip to content

Commit a9c521e

Browse files
committed
Merge remote-tracking branch 'origin/release/v0.2.0-rc2' into feature/47-implement-core-storage-engine-for-filter-presets
2 parents 72a44ba + 57ea78e commit a9c521e

File tree

555 files changed

+102211
-1854
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

555 files changed

+102211
-1854
lines changed

.env.example

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
# Cloudflare API Configuration
2+
# Copy this file to .env and fill in your actual values
3+
4+
# Cloudflare API Token - Create at https://dash.cloudflare.com/profile/api-tokens
5+
CLOUDFLARE_API_TOKEN="your-cloudflare-api-token-here"
6+
7+
# Cloudflare Account ID - Find in your Cloudflare dashboard
8+
CLOUDFLARE_ACCOUNT_ID="your-cloudflare-account-id-here"
9+
10+
# Cloudflare KV Namespace ID - Create in Workers KV section
11+
CLOUDFLARE_KV_NAMESPACE_ID="your-kv-namespace-id-here"
12+
13+
# Cloudflare R2 Storage Credentials - Create in R2 section
14+
CLOUDFLARE_R2_ACCESS_KEY_ID="your-r2-access-key-id-here"
15+
CLOUDFLARE_R2_SECRET_ACCESS_KEY="your-r2-secret-access-key-here"
16+
17+
# IMPORTANT: Never commit the .env file with real credentials!
18+
# The .env file is gitignored and should never be checked into version control

.github/AI_AGENT_CONFIG.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -86,7 +86,7 @@ When analyzing code, always check:
8686

8787
## Priority Assessment Matrix
8888

89-
```
89+
```text
9090
CRITICAL (🔴):
9191
- Breaks core functionality
9292
- Security vulnerability
@@ -137,7 +137,7 @@ To find the next priority tasks, run:
137137

138138
```bash
139139
bash .github/scripts/get-next-tasks.sh
140-
```
140+
```text
141141
142142
Or query directly:
143143
@@ -172,7 +172,7 @@ Always check and update status labels:
172172
## Templates Quick Reference
173173

174174
```yaml
175-
# Bug Report must include:
175+
# Bug Report must include
176176
area: [Components|Demo|Build|Docs|Tests]
177177
component: [DateFilter|QuickFilterDropdown|ActiveFilters|etc]
178178
description: Clear problem statement
@@ -181,21 +181,21 @@ technical-context: File:line analysis
181181
priority-suggestion: [Critical|High|Medium|Low]
182182
complexity: [Simple|Medium|Complex]
183183

184-
# Feature Request must include:
184+
# Feature Request must include
185185
feature-type: [New Component|Enhancement|DX|Performance|etc]
186186
problem-statement: Why needed
187187
proposed-solution: How to implement
188188
api-design: TypeScript interfaces
189189
breaking-change: [No|Minor|Major]
190190
effort-estimate: [XS|S|M|L|XL]
191191

192-
# Discovery must include:
192+
# Discovery must include
193193
discovery-type: [Performance|Code Smell|Security|etc]
194194
what-found: Specific issue
195195
current-state: Code + analysis
196196
questions: What to research
197197
investigation-plan: Steps to validate
198-
```
198+
```text
199199
200200
## Example: Good Issue Creation by AI
201201

.github/CONTRIBUTING.md

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ npm run test:e2e
6060

6161
1. **Pick an Issue**
6262

63-
- Check the [Project Board](https://github.com/ryanrozich/ag-grid-react-components/projects)
63+
- Check the [Project Board](<[https://github.com/ryanrozich/ag-grid-react-components/project](https://github.com/ryanrozich/ag-grid-react-components/project)s>)
6464
- Look for issues labeled `status: ready`
6565
- Comment on the issue to claim it
6666

@@ -117,7 +117,7 @@ npm run test:e2e
117117
- `investigation` - Needs research
118118
- `documentation` - Docs only
119119

120-
## 🎯 What Makes a Good Issue?
120+
## 🎯 What Makes a Good Issue
121121

122122
### Great Bug Report Example
123123

@@ -135,15 +135,17 @@ useEffect(() => {
135135
setFilterState(props.value);
136136
}, []); // Missing props.value dependency
137137
```
138-
````
138+
139+
```text
139140

140141
**Fix**: Add props.value to dependency array
141142
**Impact**: Medium - affects dynamic filters
142143
**Complexity**: Simple - one line change
143-
144+
```
144145
````
145146

146147
### Great Feature Request Example
148+
147149
```markdown
148150
**Feature**: Add keyboard navigation to QuickFilterDropdown
149151

@@ -152,19 +154,21 @@ useEffect(() => {
152154
**Proposed API**: No API change needed, just behavior
153155

154156
**Implementation**:
157+
155158
1. Add keydown handler to dropdown
156159
2. Track highlighted index in state
157160
3. Enter/Space to select
158161
4. Escape to close
159162
5. Arrow keys to navigate
160163

161164
**Files to modify**:
165+
162166
- src/components/QuickFilterDropdown/index.tsx
163167
- Add new hook: useKeyboardNavigation.ts
164168

165169
**Effort**: S (1-2 days)
166170
**Breaking**: No
167-
````
171+
```
168172

169173
## 🔍 Code Review Guidelines
170174

@@ -222,7 +226,7 @@ Issues flow through these stages:
222226
## 🤝 Community
223227

224228
- **Discussions**: Use GitHub Discussions for questions
225-
- **Discord**: [Join our Discord](#) for real-time chat
229+
- **Discord**: Join our Discord for real-time chat
226230
- **Issues**: For bugs and features only
227231
- **PRs**: Include tests and follow the template
228232

.github/PROJECT_SETUP.md

Lines changed: 18 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ This guide helps you set up the GitHub Project for optimal workflow with both AI
44

55
## Creating the Project
66

7-
1. Go to https://github.com/ryanrozich/ag-grid-react-components/projects
7+
1. Go to [https://github.com/ryanrozich/ag-grid-react-components/projects](https://github.com/ryanrozich/ag-grid-react-components/projects)
88
2. Click "New project" → Choose "Board" template
99
3. Name: "AG Grid React Components Roadmap"
1010

@@ -73,36 +73,36 @@ Set up these workflows in Project Settings → Workflows:
7373

7474
### 1. Issue Created
7575

76-
```
76+
```text
7777
When: Issue is created
7878
Then: Move to "Backlog"
7979
```
8080

8181
### 2. Issue Assigned
8282

83-
```
83+
```text
8484
When: Issue is assigned
8585
If: Status is "Ready"
8686
Then: Move to "In Progress"
8787
```
8888

8989
### 3. PR Opened
9090

91-
```
91+
```text
9292
When: Pull request is opened
9393
Then: Move linked issues to "In Review"
9494
```
9595

9696
### 4. PR Merged
9797

98-
```
98+
```text
9999
When: Pull request is merged
100100
Then: Move linked issues to "Done"
101101
```
102102

103103
### 5. Issue Closed (No PR)
104104

105-
```
105+
```text
106106
When: Issue is closed
107107
If: No linked PR
108108
Then: Move to "Done"
@@ -205,7 +205,7 @@ For new issues in Backlog:
205205

206206
### Weekly Metrics Dashboard
207207

208-
```markdown
208+
`````markdown
209209
## Week of [Date]
210210

211211
### Velocity
@@ -232,7 +232,8 @@ For new issues in Backlog:
232232
- Issues Created by AI: X
233233
- Quality Score: Y/10
234234
- Accuracy Rate: Z%
235-
```
235+
236+
````text
236237

237238
## Best Practices
238239

@@ -276,11 +277,11 @@ For new issues in Backlog:
276277

277278
## Quick Links
278279

279-
- [Create Bug Report](https://github.com/ryanrozich/ag-grid-react-components/issues/new?template=01-bug-report.yml)
280-
- [Create Feature Request](https://github.com/ryanrozich/ag-grid-react-components/issues/new?template=02-feature-request.yml)
281-
- [Create Discovery Task](https://github.com/ryanrozich/ag-grid-react-components/issues/new?template=03-discovery-task.yml)
280+
- [Create Bug Report]([https://github.com/ryanrozich/ag-grid-react-components/issues/new?template=01-bug-report.ym](https://github.com/ryanrozich/ag-grid-react-components/issues/new?template=01-bug-report.ym)l)
281+
- [Create Feature Request]([https://github.com/ryanrozich/ag-grid-react-components/issues/new?template=02-feature-request.ym](https://github.com/ryanrozich/ag-grid-react-components/issues/new?template=02-feature-request.ym)l)
282+
- [Create Discovery Task]([https://github.com/ryanrozich/ag-grid-react-components/issues/new?template=03-discovery-task.ym](https://github.com/ryanrozich/ag-grid-react-components/issues/new?template=03-discovery-task.ym)l)
282283
- [View Project Board](#) <!-- Add link when created -->
283-
- [View Milestones](https://github.com/ryanrozich/ag-grid-react-components/milestones)
284+
- [View Milestones]([https://github.com/ryanrozich/ag-grid-react-components/milestone](https://github.com/ryanrozich/ag-grid-react-components/milestone)s)
284285

285286
## Automation Scripts
286287

@@ -304,6 +305,10 @@ gh api graphql -f query='
304305
gh issue list --label "status: needs-triage" --json number \
305306
| jq -r '.[].number' \
306307
| xargs -I {} gh issue edit {} --add-label "area: components"
307-
```
308+
````
309+
`````
310+
311+
```bash
308312

309313
This project board setup ensures smooth collaboration between AI agents and human developers while maintaining high code quality and clear priorities.
314+
```

.github/PROJECT_SETUP_SCRIPT.md

Lines changed: 20 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ Since GitHub CLI has limitations with project creation, here's a step-by-step gu
44

55
## Step 1: Create the Project Manually
66

7-
1. Go to: https://github.com/ryanrozich/ag-grid-react-components/projects
7+
1. Go to: [https://github.com/ryanrozich/ag-grid-react-components/projects](https://github.com/ryanrozich/ag-grid-react-components/projects)
88
2. Click "New project" (green button)
99
3. Select "Board" template
1010
4. Name it: "AG Grid React Components Roadmap"
@@ -35,7 +35,7 @@ Since this is a repository project, adding issues is even easier! In the project
3535

3636
Alternatively, use this script:
3737

38-
```bash
38+
````bash
3939
#!/bin/bash
4040
OWNER=ryanrozich
4141
REPO=ag-grid-react-components
@@ -45,13 +45,13 @@ echo "To bulk add issues:"
4545
echo "1. Go to https://github.com/$OWNER/$REPO/issues"
4646
echo "2. Select issues using checkboxes"
4747
echo "3. Click 'Projects' → 'AG Grid React Components Roadmap'"
48-
```
48+
```text
4949
5050
## Step 5: Configure Project Settings
5151
5252
In the project settings, you'll need to manually add:
5353
54-
### Custom Fields (Settings → Fields → + New Field):
54+
### Custom Fields (Settings → Fields → + New Field)
5555
5656
1. **Area** (Single select)
5757
@@ -94,7 +94,7 @@ In the project settings, you'll need to manually add:
9494
- Demo App
9595
- N/A
9696
97-
### Workflows (Settings → Workflows):
97+
### Workflows (Settings → Workflows)
9898
9999
1. **Auto-add to project**
100100
@@ -145,7 +145,7 @@ Here's a script to help map the existing labels to custom fields:
145145
146146
```bash
147147
# This would need to be done manually in the UI as the API doesn't support custom fields yet
148-
# But here's the mapping:
148+
# But here's the mapping
149149

150150
# Issue #6 (Grand total z-index)
151151
# - Area: Demo
@@ -157,31 +157,31 @@ Here's a script to help map the existing labels to custom fields:
157157
# Issue #5 (.serena directory)
158158
# - Area: Build
159159
# - Priority: High
160-
# - Type: Bug
160+
# - Type: Bug (2)
161161
# - Effort: XS
162162
# - Component: N/A
163163

164164
# Issue #4 (OG image)
165-
# - Area: Demo
165+
# - Area: Demo (2)
166166
# - Priority: Low
167167
# - Type: Enhancement
168-
# - Effort: S
169-
# - Component: Demo App
168+
# - Effort: S (2)
169+
# - Component: Demo App (2)
170170

171171
# Issue #3 (Cloudflare secrets)
172172
# - Area: CI/CD
173-
# - Priority: High
173+
# - Priority: High (2)
174174
# - Type: Documentation
175-
# - Effort: XS
176-
# - Component: N/A
175+
# - Effort: XS (2)
176+
# - Component: N/A (2)
177177

178178
# Issue #1 (Test coverage)
179179
# - Area: Testing
180-
# - Priority: Medium
181-
# - Type: Enhancement
180+
# - Priority: Medium (2)
181+
# - Type: Enhancement (2)
182182
# - Effort: XL
183-
# - Component: N/A
184-
```
183+
# - Component: N/A (3)
184+
```text
185185
186186
## Step 8: Set Up Issue Templates Link
187187
@@ -194,7 +194,7 @@ Add this to your README.md:
194194
- [✨ Request a Feature](https://github.com/ryanrozich/ag-grid-react-components/issues/new?template=02-feature-request.yml)
195195
- [🔍 Create Discovery Task](https://github.com/ryanrozich/ag-grid-react-components/issues/new?template=03-discovery-task.yml)
196196
- [📊 View Project Board](https://github.com/users/ryanrozich/projects/X) <!-- Replace X -->
197-
```
197+
```text
198198
199199
## Automation Helper Scripts
200200
@@ -218,7 +218,7 @@ echo "- Critical: $(gh issue list --repo $OWNER/$REPO --label "priority: critica
218218
echo "- High: $(gh issue list --repo $OWNER/$REPO --label "priority: high" --state open --json number | jq '. | length')"
219219
echo "- Medium: $(gh issue list --repo $OWNER/$REPO --label "priority: medium" --state open --json number | jq '. | length')"
220220
echo "- Low: $(gh issue list --repo $OWNER/$REPO --label "priority: low" --state open --json number | jq '. | length')"
221-
```
221+
```text
222222
223223
### triage-helper.sh
224224
@@ -229,7 +229,7 @@ REPO=ag-grid-react-components
229229

230230
echo "Issues needing triage:"
231231
gh issue list --repo $OWNER/$REPO --label "status: needs-triage" --json number,title,createdAt | jq -r '.[] | "#\(.number): \(.title) (created: \(.createdAt | split("T")[0]))"'
232-
```
232+
````
233233

234234
## Notes
235235

0 commit comments

Comments
 (0)