genclass 0.3.5 → 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 CHANGED
@@ -1,5 +1,77 @@
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
+
59
+ ## 0.3.6
60
+
61
+ The paid plan is Pro (it was called Team), with 3 days free:
62
+
63
+ - **Free shows the totals and one suggestion.** `problems`, `events`, `report` and `fix` say what Pro adds, its
64
+ trial and price, and `genclass upgrade`; `dashboard` shows the headline numbers with the same box; `ask` is Pro's.
65
+ - **`genclass suggest` on Free: the first suggestion and how many more**, counting the checks, the model's own ideas
66
+ and website designs. A Free app is shown that same plan again on later runs (with its date) until it has Pro.
67
+ - **On Pro, suggest also prints the model's ideas** (marked as not measured) **and website designs**: each one is
68
+ inspired by a real site that fits what the company does, with a complete prompt to paste into Claude. The hand-off
69
+ menu copies a design's prompt in one key.
70
+ - The digest sent for a plan now includes what the site says it is about (its title and description), shown before
71
+ it is sent.
72
+ - The plan card and the Free line name the trial: 3 days free, then $15 a project a month.
73
+ - Suggest's lines fit 58 columns.
74
+
3
75
  ## 0.3.5
4
76
 
5
77
  For onboarding paying customers:
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.5 ─╮
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
- │ ada@example.com • Free plan │
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. On Free, each command
69
- ends with one line on Free's limits and `genclass upgrade`. Everything here is also a
70
- command of its own (`npx genclass problems`), so scripts and coding agents use the same things.
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
- | Plan | Once the app is in your account, its plan page opens in your browser: Team, or Free for now (limited) after saying what stops you from paying. Each app has its own plan. The setup goes on once it has one. | Nothing in your project. The payment is on Stripe's page; the command never sees a card. |
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. A part that does not apply
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 • Team plan
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` (Team) |
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 (Team) |
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 (3 on Free, 30 on Team).
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 (Team). What you type is not shown, goes to
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 (Team); `funnels remove "Checkout"`
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); `npx genclass upgrade` opens the plan page of this folder's app. `npx genclass team` shows who is on
196
- the plan (`team invite` makes a single-use invite link).
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. When you are signed in, genclass.dev orders the list for your app and words the reasons for it.
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 stores none of it.
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 is free.** Every check, with its evidence. The plan (why it matters for your app, the first step, the agent
231
- prompt) is shown for the first three items on Free and for all of them on Team, with more plans a day.
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; Team for this app |
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
- Two steps need the person: approving the sign-in and installing the GitHub App. Both happen in their browser, and
279
- the command prints the link. At the sign-in, `setup --yes` prints a link and a code and waits up to ten minutes for
280
- the person to approve, so give it a long timeout, or have them run `npx genclass login` first.
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