@electric-agent/agent 1.1.0 → 1.1.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@electric-agent/agent",
|
|
3
|
-
"version": "1.1.
|
|
3
|
+
"version": "1.1.7",
|
|
4
4
|
"description": "CLI tool that turns natural-language app descriptions into running reactive Electric SQL + TanStack DB applications",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -27,8 +27,8 @@
|
|
|
27
27
|
"commander": "^13.1.0",
|
|
28
28
|
"dotenv": "^17.3.1",
|
|
29
29
|
"zod": "^3.24.1",
|
|
30
|
-
"@electric-agent/
|
|
31
|
-
"@electric-agent/
|
|
30
|
+
"@electric-agent/studio": "1.5.0",
|
|
31
|
+
"@electric-agent/protocol": "1.3.0"
|
|
32
32
|
},
|
|
33
33
|
"devDependencies": {
|
|
34
34
|
"@types/node": "^22.15.0",
|
|
@@ -20,13 +20,9 @@ Evaluate the description provided in `$ARGUMENTS`.
|
|
|
20
20
|
- 50-79: Recognizable app type but light on specifics
|
|
21
21
|
- 0-49: Too vague to proceed
|
|
22
22
|
|
|
23
|
-
**If the description scores below 70**, use AskUserQuestion to
|
|
24
|
-
- What are the key features or interactions? (e.g., drag-and-drop, categories, search, due dates)
|
|
25
|
-
- What are the main entities/data objects and their relationships?
|
|
26
|
-
- Should it support multi-user collaboration with real-time sync?
|
|
27
|
-
- Should it work offline and sync when reconnected?
|
|
23
|
+
**If the description scores below 70**, use AskUserQuestion to gather missing details. You can use any combination of formats — single or multiple questions, multiSelect for picking features, headers to group topics, or free-text for open-ended input. Choose whatever format best fits the gaps in the description. Keep questions specific to the described app type.
|
|
28
24
|
|
|
29
|
-
|
|
25
|
+
After getting answers, enrich the description mentally and proceed.
|
|
30
26
|
|
|
31
27
|
**If the description scores 70+**, proceed immediately without questions.
|
|
32
28
|
|
|
@@ -85,6 +81,10 @@ export const entityName = pgTable("entity_name", {
|
|
|
85
81
|
### Phase 6: Architecture Reference
|
|
86
82
|
- [ ] Write ARCHITECTURE.md
|
|
87
83
|
|
|
84
|
+
### Phase 7: Deploy & Preview
|
|
85
|
+
- [ ] Run migrations (drizzle-kit generate && drizzle-kit migrate)
|
|
86
|
+
- [ ] pnpm dev:start
|
|
87
|
+
|
|
88
88
|
## Design Conventions
|
|
89
89
|
- UUID primary keys with defaultRandom()
|
|
90
90
|
- timestamp({ withTimezone: true }) for all dates
|
|
@@ -240,6 +240,18 @@ _Last updated: [ISO date]_
|
|
|
240
240
|
## State & Context
|
|
241
241
|
```
|
|
242
242
|
|
|
243
|
+
## Phase 8: Deploy & Preview
|
|
244
|
+
|
|
245
|
+
Start the dev server so the user can preview the app:
|
|
246
|
+
|
|
247
|
+
```bash
|
|
248
|
+
pnpm dev:start
|
|
249
|
+
```
|
|
250
|
+
|
|
251
|
+
**IMPORTANT**: Always use `pnpm dev:start` from the project directory. Do NOT use `sprite-env services create` or launch Vite manually — the project's `vite.config.ts` contains required settings (`allowedHosts`, `port`, `proxy`) that will not be applied if Vite is started from a different directory.
|
|
252
|
+
|
|
253
|
+
After starting, the app is accessible at the preview URL (shown in the UI).
|
|
254
|
+
|
|
243
255
|
## Critical Rules (from electric-app-guardrails)
|
|
244
256
|
|
|
245
257
|
- `z` from `"zod/v4"` — NEVER from `"zod"`
|
|
@@ -273,7 +285,9 @@ When the app runs inside a cloud sandbox (Fly.io Sprite), the following constrai
|
|
|
273
285
|
- **The preview URL** follows the pattern: `https://<sprite-name>.sprites.app`
|
|
274
286
|
- **`vite.config.ts` is pre-configured** with `port`, `host: true`, `allowedHosts: true`, and the Electric proxy — **DO NOT MODIFY it**. Changing it WILL break the preview.
|
|
275
287
|
|
|
276
|
-
|
|
288
|
+
**ALWAYS use `pnpm dev:start`** to start the dev server. This script runs Vite from the project directory where `vite.config.ts` is located. **DO NOT use `sprite-env services create`** or launch Vite manually — doing so will start Vite from the wrong directory, causing it to miss the config and reject Sprite hostnames with `allowedHosts` errors.
|
|
289
|
+
|
|
290
|
+
After finishing all code generation, always run migrations then `pnpm dev:start` so the user can preview.
|
|
277
291
|
|
|
278
292
|
## Scaffold Files (DO NOT MODIFY)
|
|
279
293
|
|