Skip to content

Commit e2486f0

Browse files
committed
format
1 parent d088659 commit e2486f0

981 files changed

Lines changed: 36406 additions & 32145 deletions

File tree

Some content is hidden

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

.claude/REVIEW.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,4 +47,4 @@ The `apps/webapp/app/v3/` directory name is misleading — most code there is V2
4747

4848
## Confidence calibration for this repo
4949

50-
The most common false-positive pattern: speculating about race conditions in code paths the agent doesn't have runtime visibility into. If the only evidence is "this *could* race", drop it. If you can point to a specific interleaving with file:line for each step, surface it.
50+
The most common false-positive pattern: speculating about race conditions in code paths the agent doesn't have runtime visibility into. If the only evidence is "this _could_ race", drop it. If you can point to a specific interleaving with file:line for each step, surface it.

.claude/rules/legacy-v3-code.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,7 @@ The `v3/` directory name is misleading - most code here is actively used by the
1919
## V1/V2 Branching Pattern
2020

2121
Some services act as routers that branch on `RunEngineVersion`:
22+
2223
- `services/cancelTaskRun.server.ts` - calls V1 service or `engine.cancelRun()` for V2
2324
- `services/batchTriggerV3.server.ts` - uses marqs for V1 path, run-engine for V2
2425

.claude/rules/package-installation.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,9 +8,11 @@ paths:
88
When adding a new dependency to any package.json in the monorepo:
99

1010
1. **Look up the latest version** on npm before adding:
11+
1112
```bash
1213
pnpm view <package-name> version
1314
```
15+
1416
If unsure which version to use (e.g. major version compatibility), confirm with the user.
1517

1618
2. **Edit the package.json directly** — do NOT use `pnpm add` as it can cause issues in the monorepo. Add the dependency with the correct version range (typically `^x.y.z`).

.claude/skills/span-timeline-events/SKILL.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -52,15 +52,15 @@ Sibling spans (same parent) are sorted by `start_time ASC` from the ClickHouse q
5252

5353
`getAdminOnlyForEvent()` controls visibility. Events default to **admin-only** (`true`).
5454

55-
| Event | Admin-only | Friendly name |
56-
|-------|-----------|---------------|
57-
| `dequeue` | No | Dequeued |
58-
| `fork` | No | Launched |
59-
| `import` | No (if no fork event) | Importing task file |
60-
| `create_attempt` | Yes | Attempt created |
61-
| `lazy_payload` | Yes | Lazy attempt initialized |
62-
| `pod_scheduled` | Yes | Pod scheduled |
63-
| (default) | Yes | (raw event name) |
55+
| Event | Admin-only | Friendly name |
56+
| ---------------- | --------------------- | ------------------------ |
57+
| `dequeue` | No | Dequeued |
58+
| `fork` | No | Launched |
59+
| `import` | No (if no fork event) | Importing task file |
60+
| `create_attempt` | Yes | Attempt created |
61+
| `lazy_payload` | Yes | Lazy attempt initialized |
62+
| `pod_scheduled` | Yes | Pod scheduled |
63+
| (default) | Yes | (raw event name) |
6464

6565
## Adding New Timeline Events
6666

.claude/skills/trigger-dev-tasks/SKILL.md

Lines changed: 35 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -113,17 +113,18 @@ export const paymentTask = task({
113113

114114
```ts
115115
await myTask.trigger(payload, {
116-
delay: "1h", // Delay execution
117-
ttl: "10m", // Cancel if not started within TTL
116+
delay: "1h", // Delay execution
117+
ttl: "10m", // Cancel if not started within TTL
118118
idempotencyKey: key,
119119
queue: "my-queue",
120-
machine: "large-1x", // micro, small-1x, small-2x, medium-1x, medium-2x, large-1x, large-2x
120+
machine: "large-1x", // micro, small-1x, small-2x, medium-1x, medium-2x, large-1x, large-2x
121121
maxAttempts: 3,
122-
tags: ["user_123"], // Max 10 tags
123-
debounce: { // Consolidate rapid triggers
122+
tags: ["user_123"], // Max 10 tags
123+
debounce: {
124+
// Consolidate rapid triggers
124125
key: "unique-key",
125126
delay: "5s",
126-
mode: "trailing", // "leading" (default) or "trailing"
127+
mode: "trailing", // "leading" (default) or "trailing"
127128
},
128129
});
129130
```
@@ -134,21 +135,27 @@ Consolidate multiple triggers into a single execution:
134135

135136
```ts
136137
// Rapid triggers with same key = single execution
137-
await myTask.trigger({ userId: "123" }, {
138-
debounce: {
139-
key: "user-123-update",
140-
delay: "5s",
141-
},
142-
});
138+
await myTask.trigger(
139+
{ userId: "123" },
140+
{
141+
debounce: {
142+
key: "user-123-update",
143+
delay: "5s",
144+
},
145+
}
146+
);
143147

144148
// Trailing mode: use payload from LAST trigger
145-
await myTask.trigger({ data: "latest" }, {
146-
debounce: {
147-
key: "my-key",
148-
delay: "10s",
149-
mode: "trailing",
150-
},
151-
});
149+
await myTask.trigger(
150+
{ data: "latest" },
151+
{
152+
debounce: {
153+
key: "my-key",
154+
delay: "10s",
155+
mode: "trailing",
156+
},
157+
}
158+
);
152159
```
153160

154161
Use cases: user activity updates, webhook deduplication, search indexing, notification batching.
@@ -170,15 +177,15 @@ for (const result of results) {
170177

171178
## Machine Presets
172179

173-
| Preset | vCPU | Memory |
174-
|-------------|------|--------|
175-
| micro | 0.25 | 0.25GB |
176-
| small-1x | 0.5 | 0.5GB |
177-
| small-2x | 1 | 1GB |
178-
| medium-1x | 1 | 2GB |
179-
| medium-2x | 2 | 4GB |
180-
| large-1x | 4 | 8GB |
181-
| large-2x | 8 | 16GB |
180+
| Preset | vCPU | Memory |
181+
| --------- | ---- | ------ |
182+
| micro | 0.25 | 0.25GB |
183+
| small-1x | 0.5 | 0.5GB |
184+
| small-2x | 1 | 1GB |
185+
| medium-1x | 1 | 2GB |
186+
| medium-2x | 2 | 4GB |
187+
| large-1x | 4 | 8GB |
188+
| large-2x | 8 | 16GB |
182189

183190
## Design Principles
184191

.claude/skills/trigger-dev-tasks/advanced-tasks.md

Lines changed: 25 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -48,19 +48,19 @@ Enhanced batch triggering with larger payloads and streaming ingestion.
4848

4949
### Rate Limiting (per environment)
5050

51-
| Tier | Bucket Size | Refill Rate |
52-
|------|-------------|-------------|
53-
| Free | 1,200 runs | 100 runs/10 sec |
54-
| Hobby | 5,000 runs | 500 runs/5 sec |
55-
| Pro | 5,000 runs | 500 runs/5 sec |
51+
| Tier | Bucket Size | Refill Rate |
52+
| ----- | ----------- | --------------- |
53+
| Free | 1,200 runs | 100 runs/10 sec |
54+
| Hobby | 5,000 runs | 500 runs/5 sec |
55+
| Pro | 5,000 runs | 500 runs/5 sec |
5656

5757
### Concurrent Batch Processing
5858

59-
| Tier | Concurrent Batches |
60-
|------|-------------------|
61-
| Free | 1 |
62-
| Hobby | 10 |
63-
| Pro | 10 |
59+
| Tier | Concurrent Batches |
60+
| ----- | ------------------ |
61+
| Free | 1 |
62+
| Hobby | 10 |
63+
| Pro | 10 |
6464

6565
### Usage
6666

@@ -122,8 +122,8 @@ await myTask.trigger(
122122
{ userId: "123" },
123123
{
124124
debounce: {
125-
key: "user-123-update", // Unique identifier for debounce group
126-
delay: "5s", // Wait duration ("5s", "1m", or milliseconds)
125+
key: "user-123-update", // Unique identifier for debounce group
126+
delay: "5s", // Wait duration ("5s", "1m", or milliseconds)
127127
},
128128
}
129129
);
@@ -135,14 +135,20 @@ await myTask.trigger(
135135

136136
```ts
137137
// First trigger sets the payload
138-
await myTask.trigger({ action: "first" }, {
139-
debounce: { key: "my-key", delay: "10s" }
140-
});
138+
await myTask.trigger(
139+
{ action: "first" },
140+
{
141+
debounce: { key: "my-key", delay: "10s" },
142+
}
143+
);
141144

142145
// Second trigger only reschedules - payload remains "first"
143-
await myTask.trigger({ action: "second" }, {
144-
debounce: { key: "my-key", delay: "10s" }
145-
});
146+
await myTask.trigger(
147+
{ action: "second" },
148+
{
149+
debounce: { key: "my-key", delay: "10s" },
150+
}
151+
);
146152
// Task executes with { action: "first" }
147153
```
148154

@@ -162,6 +168,7 @@ await myTask.trigger(
162168
```
163169

164170
In trailing mode, these options update with each trigger:
171+
165172
- `payload` — task input data
166173
- `metadata` — run metadata
167174
- `tags` — run tags (replaces existing)

.claude/skills/trigger-dev-tasks/basic-tasks.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -75,8 +75,8 @@ await myTask.trigger(
7575
{ userId: "123" },
7676
{
7777
debounce: {
78-
key: "user-123-update", // Unique key for debounce group
79-
delay: "5s", // Wait before executing
78+
key: "user-123-update", // Unique key for debounce group
79+
delay: "5s", // Wait before executing
8080
},
8181
}
8282
);
@@ -88,13 +88,14 @@ await myTask.trigger(
8888
debounce: {
8989
key: "trailing-example",
9090
delay: "10s",
91-
mode: "trailing", // Default is "leading" (first payload)
91+
mode: "trailing", // Default is "leading" (first payload)
9292
},
9393
}
9494
);
9595
```
9696

9797
**Debounce modes:**
98+
9899
- `leading` (default): Uses payload from first trigger, subsequent triggers only reschedule
99100
- `trailing`: Uses payload from most recent trigger
100101

.cursor/commands/deslop.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,10 @@
33
Check the diff against main, and remove all AI generated slop introduced in this branch.
44

55
This includes:
6+
67
- Extra comments that a human wouldn't add or is inconsistent with the rest of the file
78
- Extra defensive checks or try/catch blocks that are abnormal for that area of the codebase (especially if called by trusted / validated codepaths)
89
- Casts to any to get around type issues
910
- Any other style that is inconsistent with the file
1011

11-
Report at the end with only a 1-3 sentence summary of what you changed
12+
Report at the end with only a 1-3 sentence summary of what you changed

.github/labeler.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,4 +9,4 @@
99
- any: ["**/*.md"]
1010

1111
"📌 area: ci":
12-
- any: [".github/**/*"]
12+
- any: [".github/**/*"]

.github/workflows/dependabot-critical-alerts.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@ name: Dependabot Critical Alerts
22

33
on:
44
schedule:
5-
- cron: "0 8 * * *" # Daily 08:00 UTC
5+
- cron: "0 8 * * *" # Daily 08:00 UTC
66
workflow_dispatch:
77
inputs:
88
severity:

0 commit comments

Comments
 (0)