genclass 0.3.6 → 0.3.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/CHANGELOG.md +56 -0
- package/README.md +45 -26
- package/dist/genclass.mjs +2046 -1426
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,61 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.3.7
|
|
4
|
+
|
|
5
|
+
The genclass command comes with Pro:
|
|
6
|
+
|
|
7
|
+
- **Pro right after the sign-in.** An account without Pro (paid, in its trial, GenClass's grant, or a place in a
|
|
8
|
+
paying team) sees Pro's card next, and Enter opens its checkout in the browser: 3 days free, the card asked for on
|
|
9
|
+
Stripe, then $15 a developer a month. The command waits for the payment and goes on with what was asked. There is
|
|
10
|
+
no Free in the terminal: Free stays on the website (one app and its totals).
|
|
11
|
+
- **Every command asks first**, except `login`, `logout`, `whoami`, `plan`, `upgrade`, `profile`, `status`, `remove`,
|
|
12
|
+
`help` and `version`. Signed out, the sign-in comes first and Pro right after it. Without a terminal (`--yes`,
|
|
13
|
+
`--json`, a coding agent) nothing is opened: one line with the checkout address, and exit code 1. genclass.dev
|
|
14
|
+
answers 402 to the command's other routes for an account without Pro, and every command says the same line then.
|
|
15
|
+
- **Pro is for the account**, per developer, for up to 3 apps (genclass.dev's plans version 5). Free covers one
|
|
16
|
+
app. `plan`, `profile` and `upgrade` show Pro's card and its trial; an app past the 3 says more apps come with
|
|
17
|
+
Enterprise, by email.
|
|
18
|
+
- **Every new app has its plan page once.** `login`, `connect`, `init` and `apps new` open it once the app is in the
|
|
19
|
+
account: Continue with Pro for an account that has it, or what the app needs. The walk has it as its own step,
|
|
20
|
+
after the runtime.
|
|
21
|
+
- The header shows this folder's app's plan. The note under a dashboard link says what Free shows (the totals) and
|
|
22
|
+
what comes with Pro.
|
|
23
|
+
|
|
24
|
+
Fixed before release, from a test report on the 0.3.7 pull request and a walk of 0.3.6 at 58 columns:
|
|
25
|
+
|
|
26
|
+
- **The telemetry opt-out works without Pro.** `npx genclass init --no-telemetry` (and `--telemetry`, to undo it) on
|
|
27
|
+
an app that has GenClass changes only that option, signed out too. It no longer opens a checkout.
|
|
28
|
+
- **`genclass login` only signs in.** An account without Pro sees Pro's card next, and nothing is written in the
|
|
29
|
+
folder. This folder's app is offered to the account (the runtime login's own question) once Pro is on.
|
|
30
|
+
- **The home's commands pass the gate**, like any command: the home can open before the sign-in (q at the first
|
|
31
|
+
step). Skipping the sign-in skips the steps after Pro too.
|
|
32
|
+
- **A 4th app on Pro** says that more apps come with Enterprise, by email, with the address on its plan page. Nothing
|
|
33
|
+
is opened or waited for, and the walk goes on. `upgrade` and `apps new` say the same.
|
|
34
|
+
- **Pro with one seat:** `team` and `team invite` say to add seats in Manage billing, not that a team needs Pro.
|
|
35
|
+
`upgrade` on Pro says there is nothing to upgrade, and where seats are added.
|
|
36
|
+
- **Said before the sign-in:** the first screen and `--help` say that the command comes with Pro (3 days free, then
|
|
37
|
+
US$15 a developer a month, card on Stripe). `--help` lists `upgrade`, `profile` and what works without Pro.
|
|
38
|
+
- **No v4 text:** `whoami`, the login's next steps, the dashboard help and the lines under a dashboard link no
|
|
39
|
+
longer say every dashboard is free, or offer Pro to an account that has it. Signed out, `genclass dashboard` in a
|
|
40
|
+
folder with an app's private link prints it again.
|
|
41
|
+
- **The Pro card:** a used trial is no longer promised; it says which account it is for; n, no, s and exit stop as
|
|
42
|
+
q does. `plan` says when a trial ends and its first charge, shows no model runs without Pro, and shows no app
|
|
43
|
+
limit for GenClass's grant. A stopped payment wait says so once.
|
|
44
|
+
- **For scripts and agents:** `needs_pro` has one JSON shape everywhere: `ok`, `error`, `needs_pro`, `signed_in`,
|
|
45
|
+
`plan`, `price`, `trial_days`, `checkout_url`, `run`. `upgrade` without Pro ends like the gated commands (exit 1;
|
|
46
|
+
`--json` gives that shape). `scan` and `audit` behind the gate exit 2 (their 1 means problems found) and name the
|
|
47
|
+
free page check on genclass.dev. A command's own usage error comes before the gate.
|
|
48
|
+
- An app Pro covers is no longer told it "has no plan yet", and its views are not blocked on a terminal. A Free
|
|
49
|
+
choice made earlier no longer answers a new plan-page wait.
|
|
50
|
+
- **58 columns:** a spinner's line never wraps (the stop hint goes on its own line); a command or an address is never
|
|
51
|
+
broken across lines, and warnings are wrapped too; the session file is written with `~`.
|
|
52
|
+
- Small ones: `ask` says Pro is needed before its privacy notice; `suggest` remembers "repository only"; adding
|
|
53
|
+
GenClass again after `remove` reuses the account's app of the same name (asked first; `--yes` reuses it); the
|
|
54
|
+
coding-agent step shows the files it writes and asks; the welcome no longer makes a name from an email address;
|
|
55
|
+
`q stop` everywhere; `status` in the home has no card; `analytics` on Free says "already counted" only when it is;
|
|
56
|
+
a Pro account's `suggest` with no plan from genclass.dev (`--no-model`) shows every item; a member of a paying team
|
|
57
|
+
is told a new app goes into the team's account (genclass.dev's `team_plan` and `via`).
|
|
58
|
+
|
|
3
59
|
## 0.3.6
|
|
4
60
|
|
|
5
61
|
The paid plan is Pro (it was called Team), with 3 days free:
|
package/README.md
CHANGED
|
@@ -8,10 +8,11 @@ npx genclass
|
|
|
8
8
|
```
|
|
9
9
|
|
|
10
10
|
Run it in your web app's folder. It shows where the project stands and walks you through the next step: one Enter
|
|
11
|
-
per step. Stop at any point and run it again: it continues from what is true now.
|
|
11
|
+
per step. Stop at any point and run it again: it continues from what is true now. It comes with Pro: 3 days free,
|
|
12
|
+
then US$15 a developer a month.
|
|
12
13
|
|
|
13
14
|
```text
|
|
14
|
-
╭─ GenClass ────────────────────────────────────────────── v0.3.
|
|
15
|
+
╭─ GenClass ────────────────────────────────────────────── v0.3.7 ─╮
|
|
15
16
|
│ │
|
|
16
17
|
│ Welcome back, Ada! │
|
|
17
18
|
│ │
|
|
@@ -25,12 +26,12 @@ per step. Stop at any point and run it again: it continues from what is true now
|
|
|
25
26
|
│ ▀▀█▀▀▀ │
|
|
26
27
|
│ │
|
|
27
28
|
│ shop • Vite + React │
|
|
28
|
-
│
|
|
29
|
+
│ ada@example.com • Pro plan │
|
|
29
30
|
│ ~/code/shop │
|
|
30
31
|
│ │
|
|
31
32
|
╰──────────────────────────────────────────────────────────────────╯
|
|
32
33
|
|
|
33
|
-
✔ Done Account • Runtime
|
|
34
|
+
✔ Done Account • Pro • Runtime
|
|
34
35
|
● Next Add the test workflow
|
|
35
36
|
◌ Waiting Dashboard: deploy, then open your site once
|
|
36
37
|
○ Later GitHub App • Coding agent • Suggestions
|
|
@@ -65,9 +66,17 @@ When the walk is done (or you press `q` to leave it for later), the command does
|
|
|
65
66
|
❯ which page loses the most visitors?
|
|
66
67
|
```
|
|
67
68
|
|
|
68
|
-
Type a number, a command, or a sentence: a sentence is a question about your app. `q` leaves.
|
|
69
|
-
|
|
70
|
-
|
|
69
|
+
Type a number, a command, or a sentence: a sentence is a question about your app. `q` leaves. Everything here is
|
|
70
|
+
also a command of its own (`npx genclass problems`), so scripts and coding agents use the same things.
|
|
71
|
+
|
|
72
|
+
**The command comes with Pro.** Right after the sign-in, an account without Pro sees Pro's card, and Enter opens its
|
|
73
|
+
checkout in the browser: 3 days free (one trial per account; the card is asked for on Stripe, and nothing is charged
|
|
74
|
+
if you cancel before they end), then US$15 a developer a month, for up to 3 apps in the account. More apps come with
|
|
75
|
+
Enterprise, by email. Every command but `login`, `logout`, `whoami`, `plan`, `upgrade`, `profile`, `status`,
|
|
76
|
+
`remove`, `help` and `version` asks first. Without a terminal (`--yes`, `--json`, a coding agent) nothing is opened:
|
|
77
|
+
one line with the checkout address, and exit code 1. Free stays on the website: one app's totals for the last 7 days.
|
|
78
|
+
Plans bought before 13 November 2026 keep every app they cover (an app paid for on its own does not count toward
|
|
79
|
+
Pro's 3); Free covers an account's oldest app and locks the others.
|
|
71
80
|
|
|
72
81
|
**Just `genclass`.** `npx` runs the command without installing it, so the first run on a terminal installs it
|
|
73
82
|
(`npm install -g genclass`, said on screen; `npm uninstall -g genclass` takes it out, `GENCLASS_NO_INSTALL=1` turns
|
|
@@ -78,8 +87,9 @@ it off). After that you type `genclass`, and every screen says `genclass` instea
|
|
|
78
87
|
| Part | What the step does | What it changes |
|
|
79
88
|
|---|---|---|
|
|
80
89
|
| Account | Opens genclass.dev in your browser; you approve a short code there. | A session file in your user config folder. Nothing is typed in the terminal. |
|
|
90
|
+
| Pro | Right after the sign-in: Pro's 3-day free trial opens in your browser, and the command waits for it. Every step after it needs Pro. | Nothing in your project. The payment is on Stripe's page; the command never sees a card. |
|
|
81
91
|
| Runtime | Adds GenClass to the app: one import (or script tag) and the package. It watches the page in your users' browsers for lost edits, double submits and old data shown over new, and only reports, to the console and your dashboard. Nothing is drawn on your pages. | Your entry file and `package.json`; you see the change first. `genclass remove` undoes it. |
|
|
82
|
-
|
|
|
92
|
+
| App plan | Once the app is in your account, its plan page opens in your browser once: Continue with Pro. Pro covers up to 3 apps; more apps come with Enterprise, by email. | Nothing in your project. |
|
|
83
93
|
| Dashboard | Waits for your live site to be opened once. GenClass sends nothing from localhost. | Nothing. |
|
|
84
94
|
| Test workflow | Runs your Playwright tests once more per pull request with slow and reordered responses. | One new file, `.github/workflows/genclass.yml`, which you commit. |
|
|
85
95
|
| GitHub App | Comments on a pull request when a page ends up wrong, with the steps to see it. The command opens GitHub's install page and waits for the answer. A repository that was renamed on GitHub is looked up under its new name. | Nothing in your project. The app cannot read or change your code. |
|
|
@@ -87,7 +97,8 @@ it off). After that you type `genclass`, and every screen says `genclass` instea
|
|
|
87
97
|
| Suggestions | Tells you what your app is missing, most important first. | Nothing in your project. |
|
|
88
98
|
|
|
89
99
|
On a terminal, Enter starts a step and is the yes for what its sentence says it writes. While a step waits for you
|
|
90
|
-
in the browser (the sign-in, GitHub), Enter stops the wait and the walk goes on.
|
|
100
|
+
in the browser (the sign-in, GitHub), Enter stops the wait and the walk goes on. Pro and the app's plan are the
|
|
101
|
+
exception: nothing after them runs until they are done. A part that does not apply
|
|
91
102
|
is left out and says why: no Playwright tests, not a GitHub repository, not a web app.
|
|
92
103
|
|
|
93
104
|
## Your app in the terminal
|
|
@@ -102,7 +113,7 @@ suggestions run left to do.
|
|
|
102
113
|
|
|
103
114
|
```text
|
|
104
115
|
GenClass • shop Vite + React
|
|
105
|
-
ada@example.com •
|
|
116
|
+
ada@example.com • Pro plan
|
|
106
117
|
────────────────────────────────────────────────────────────────────────────
|
|
107
118
|
last 7 days · last page 3 hours ago
|
|
108
119
|
|
|
@@ -133,11 +144,11 @@ Each part of the browser dashboard has its own view, short first, `--all` for ev
|
|
|
133
144
|
| | |
|
|
134
145
|
|---|---|
|
|
135
146
|
| `npx genclass problems` | what was found, by kind and by page, the measured visual checks, what GenClass stopped on the visitor's screen, how it compares with the period before |
|
|
136
|
-
| `npx genclass analytics` | visitors: visits, page views, time on a page, where people come from, devices and countries, what gets clicked again and again. One part in full: `analytics pages`, `sources`, `devices`, `clicks`, `paths`, `funnels`
|
|
147
|
+
| `npx genclass analytics` | visitors: visits, page views, time on a page, where people come from, devices and countries, what gets clicked again and again. One part in full: `analytics pages`, `sources`, `devices`, `clicks`, `paths`, `funnels` |
|
|
137
148
|
| `npx genclass events` | the latest events one per line: when, kind, how sure the model was, the page, and what GenClass did |
|
|
138
149
|
| `npx genclass health` | how GenClass itself runs on your pages: model loads, where it ran, decision time, what was not checked, runtime versions |
|
|
139
150
|
| `npx genclass report` | the period as Markdown, to paste or pipe (`--out report.md` writes a file) |
|
|
140
|
-
| `npx genclass export` | every stored event as a file, JSON Lines or `--format csv`, `--from` and `--to` as days
|
|
151
|
+
| `npx genclass export` | every stored event as a file, JSON Lines or `--format csv`, `--from` and `--to` as days |
|
|
141
152
|
|
|
142
153
|
## Have it fixed
|
|
143
154
|
|
|
@@ -167,7 +178,7 @@ the question; a follow-up ("and on which page?") carries the turn before it.
|
|
|
167
178
|
**What leaves your machine:** the question. The numbers are read on genclass.dev, where they already are, and go to
|
|
168
179
|
the model (OpenAI's API) with it. No code, no file of your project. Neither the question nor the answer is stored.
|
|
169
180
|
The command says this before the first question and waits for Enter. Ask and suggest share a plan's model runs a
|
|
170
|
-
day (
|
|
181
|
+
day (30 on Pro).
|
|
171
182
|
|
|
172
183
|
## Connections
|
|
173
184
|
|
|
@@ -178,22 +189,24 @@ npx genclass connections
|
|
|
178
189
|
Where your app's new problems are sent (Slack, Sentry, PostHog, Datadog, or a webhook of your own), what the GitHub
|
|
179
190
|
App is doing on the repository, whether your coding agent is connected, and whether the app has a private link.
|
|
180
191
|
|
|
181
|
-
- `npx genclass connections add slack` sets a destination up
|
|
192
|
+
- `npx genclass connections add slack` sets a destination up. What you type is not shown, goes to
|
|
182
193
|
genclass.dev over HTTPS, is stored encrypted there and is not kept on your machine. Then `test`, `off`, `on`,
|
|
183
194
|
`remove` in place of `add`.
|
|
184
195
|
- `npx genclass agent` shows how your coding agent is connected and what it did with the findings (found,
|
|
185
196
|
reproduced, fix proven, closed). `npx genclass agent link` gives it the live site's numbers: it makes the app's
|
|
186
197
|
private dashboard link and hands it to GenClass's MCP server in your own agent settings, never in a file of the
|
|
187
198
|
repository.
|
|
188
|
-
- `npx genclass funnels add "Checkout" /cart /checkout /thanks` adds a funnel
|
|
199
|
+
- `npx genclass funnels add "Checkout" /cart /checkout /thanks` adds a funnel; `funnels remove "Checkout"`
|
|
189
200
|
removes it.
|
|
190
201
|
|
|
191
202
|
## Account
|
|
192
203
|
|
|
193
204
|
`npx genclass apps` lists your apps (`apps new "Name"` makes one). `npx genclass plan` shows your plan, its limits
|
|
194
205
|
and what is used, and each app's plan. `npx genclass profile` shows your account and each app's plan with numbered
|
|
195
|
-
choices (upgrade, billing, sign out)
|
|
196
|
-
|
|
206
|
+
choices (upgrade, billing, sign out). `npx genclass upgrade` starts Pro, its free trial first, for an account
|
|
207
|
+
without it. With Pro there is nothing to upgrade: it says where seats are added (Manage billing), and for an app past
|
|
208
|
+
Pro's 3 it says that more apps come with Enterprise, with the app's plan page. `npx genclass team` shows who is on the
|
|
209
|
+
plan (`team invite` makes a single-use invite link).
|
|
197
210
|
|
|
198
211
|
**What a terminal may do** is listed on the page where you approve its sign-in, and nothing else: read your apps'
|
|
199
212
|
dashboards, analytics and stored events, ask the model, change where alerts go, funnels and the private link, show
|
|
@@ -220,15 +233,16 @@ It measures your repository and your live site against a list of checks, in plai
|
|
|
220
233
|
- **Email:** SPF and DMARC, so your mail does not land in spam.
|
|
221
234
|
|
|
222
235
|
Each failed check comes with the evidence that was measured, what to do, and a prompt you can paste to your coding
|
|
223
|
-
agent.
|
|
236
|
+
agent. genclass.dev orders the list for your app and words the reasons for it.
|
|
224
237
|
|
|
225
238
|
**What leaves your machine.** Requests to your own site, and, to get the plan, the checks that failed with their
|
|
226
239
|
evidence lines, plus your app's name, framework, address, payment provider and host. No source code, no file
|
|
227
240
|
contents, no secrets. The command shows this before the first time it sends it for a project; `--no-model` sends
|
|
228
|
-
nothing. genclass.dev passes it to the model that writes the plan and
|
|
241
|
+
nothing. genclass.dev passes it to the model that writes the plan, and keeps the plan it writes for your app, not
|
|
242
|
+
what was sent.
|
|
229
243
|
|
|
230
|
-
**What
|
|
231
|
-
|
|
244
|
+
**What Pro shows.** Every check, with its evidence, and the plan for all of them: why it matters for your app, the
|
|
245
|
+
first step and the agent prompt, with the model's own ideas and website designs.
|
|
232
246
|
|
|
233
247
|
## Commands
|
|
234
248
|
|
|
@@ -250,12 +264,12 @@ prompt) is shown for the first three items on Free and for all of them on Team,
|
|
|
250
264
|
| `npx genclass fix [number, kind or all]` | hand a problem to your coding agent (`--print`, `--copy`, `--agent <name>`) |
|
|
251
265
|
| `npx genclass ask "..."` | a question about your app, answered from its numbers |
|
|
252
266
|
| `npx genclass suggest [url]` | what your app is missing, then one number hands the list to your coding agent (`--yes`, `--no-model`, `--all`) |
|
|
253
|
-
| `npx genclass scan <url>` | 23 visual checks on one page |
|
|
267
|
+
| `npx genclass scan <url>` | 23 visual checks on one page (free, with no account: `npx @genclass/runtime@beta scan <url>`) |
|
|
254
268
|
| `npx genclass connections` | alerts, GitHub App, coding agent (`add`, `test`, `on`, `off`, `remove` a destination) |
|
|
255
269
|
| `npx genclass agent` | your coding agent and what it did (`agent link`) |
|
|
256
270
|
| `npx genclass funnels` | funnels (`add "Name" /a /b`, `remove "Name"`) |
|
|
257
271
|
| `npx genclass apps`, `plan`, `team` | your apps, your plan, the people on it |
|
|
258
|
-
| `npx genclass profile`, `upgrade` | your account and each app's plan;
|
|
272
|
+
| `npx genclass profile`, `upgrade` | your account and each app's plan; start Pro |
|
|
259
273
|
| `npx genclass login`, `logout`, `whoami` | your account |
|
|
260
274
|
| `npx genclass remove` | take GenClass out of the app again |
|
|
261
275
|
|
|
@@ -275,9 +289,14 @@ npx genclass fix --print # the prompt to fix what was found (fix stale --p
|
|
|
275
289
|
npx genclass report # the period as Markdown
|
|
276
290
|
```
|
|
277
291
|
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
292
|
+
Four steps need the person, in their browser, and the command prints the link for each: approving the sign-in,
|
|
293
|
+
starting Pro's 3-day trial (their card, on Stripe), opening a new app's plan page once, and installing the GitHub
|
|
294
|
+
App. At the sign-in, `setup --yes` prints a link and a code and waits up to ten minutes for the person to approve, so
|
|
295
|
+
give it a long timeout, or have them run `npx genclass login` first. Without Pro, `setup --yes` stops at the trial
|
|
296
|
+
with exit code 1 and one line with the checkout link, and every command that needs Pro answers the same way (`upgrade`
|
|
297
|
+
included; `scan` and `audit` end with 2): give the person the link, wait for them to start the trial, then run
|
|
298
|
+
`setup --yes` again. With `--json` that answer is one shape everywhere: `{ "ok": false, "needs_pro": true,
|
|
299
|
+
"signed_in", "plan", "price", "trial_days", "checkout_url", "run" }`, where `run` is the command to run next.
|
|
281
300
|
|
|
282
301
|
## How it is built
|
|
283
302
|
|