genclass 0.3.3 → 0.3.6

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,69 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.3.6
4
+
5
+ The paid plan is Pro (it was called Team), with 3 days free:
6
+
7
+ - **Free shows the totals and one suggestion.** `problems`, `events`, `report` and `fix` say what Pro adds, its
8
+ trial and price, and `genclass upgrade`; `dashboard` shows the headline numbers with the same box; `ask` is Pro's.
9
+ - **`genclass suggest` on Free: the first suggestion and how many more**, counting the checks, the model's own ideas
10
+ and website designs. A Free app is shown that same plan again on later runs (with its date) until it has Pro.
11
+ - **On Pro, suggest also prints the model's ideas** (marked as not measured) **and website designs**: each one is
12
+ inspired by a real site that fits what the company does, with a complete prompt to paste into Claude. The hand-off
13
+ menu copies a design's prompt in one key.
14
+ - The digest sent for a plan now includes what the site says it is about (its title and description), shown before
15
+ it is sent.
16
+ - The plan card and the Free line name the trial: 3 days free, then $15 a project a month.
17
+ - Suggest's lines fit 58 columns.
18
+
19
+ ## 0.3.5
20
+
21
+ For onboarding paying customers:
22
+
23
+ - **Every app chooses its plan on a page.** Once the app is in the account, the setup opens the app's plan page in
24
+ the browser: Team large, with its price and a Start button, and a very small "Try for free (limited)" under it.
25
+ Free asks what is stopping them from paying first. The terminal shows the same card and waits for the choice made
26
+ there; the setup goes on only once the app has its plan. Plans are per
27
+ app now: Team is $15 a project a month with the whole team on it, Free covers 3 apps and 100 problems fixed live a
28
+ month per app. A fourth app has only Team. Before, the plan was a card in the terminal only, and a setup run
29
+ without a keyboard (`--yes`, a coding agent) chose Free without showing anything.
30
+ - **`genclass` alone works.** A run through `npx genclass` on a terminal installs the command (`npm install -g
31
+ genclass`) and says so; `npm uninstall -g genclass` takes it out, `GENCLASS_NO_INSTALL=1` turns it off.
32
+ - **Numbered choices.** The home lists its commands with numbers (type 3 for analytics), and "Which app?" is a
33
+ numbered list instead of commands to retype.
34
+ - **`genclass profile`**: who is signed in, each app's plan, and numbered choices to upgrade, open billing or sign
35
+ out. **`genclass upgrade`** opens the plan page of this folder's app (`--app` for another).
36
+ - On Free, every command ends with one line: the limits and the way up (`genclass upgrade`).
37
+ - **`genclass suggest` hands the whole list to your coding agent**: after the list, one number starts Claude Code,
38
+ Codex, Cursor or Gemini CLI in the folder with every item, or copies or prints the prompt.
39
+ - `genclass dashboard` shows the live fixes used this month, and says when an app on Free has used them all and
40
+ GenClass only observes until the month ends.
41
+ - `genclass apps new` says when the new app needs a plan of its own, with its plan page.
42
+
43
+ ## 0.3.4
44
+
45
+ From a review of every setup path after a teammate hit the 0.3.2 bug:
46
+
47
+ - **The GitHub App step is offered for every repository on GitHub.** It waited for Playwright tests, so a project
48
+ without them (most) never saw it. The app also comments production findings on pull requests, which need no tests.
49
+ - **A hand-written setup is no longer stuck at "Put this app in your account".** Its key (`GenClass.init({ token })`,
50
+ `GENCLASS_CONFIG`, a meta tag) was not read, so the step came back on every run even with the app in the account.
51
+ - **An app set up with `@genclass/nuxt` or `@genclass/astro` is not treated as new**, so the walk no longer adds a
52
+ second runtime import and a second app.
53
+ - **`--yes` no longer replaces a key that is not the account's** (a teammate's): `connect` says which options name
54
+ the app instead.
55
+ - `setup --yes --json` prints only JSON on stdout; `status --json` names `npx genclass setup --yes` where a step
56
+ needs it, so a coding agent no longer loops on `npx genclass setup`.
57
+ - Saying no to the runtime's change no longer leads to the Vite settings; signed out, the first-page and GitHub App
58
+ steps say why they do nothing.
59
+ - Commands now run as the screen prints them: the signed-out `dashboard` with `--all`, `--range` or `--app`;
60
+ `connect`, `init` and `audit` typed at the home prompt (they were sent to the model as questions); the CSP advice's
61
+ `fetch-model`; `scan` of a local address; `--app` with a long or quoted name; "which app" and "sign in again" hints
62
+ that dropped what was typed after the command.
63
+ - `remove` run from a folder inside the app finds GenClass's other files.
64
+ - `init` and `connect` run through `genclass` add no developer overlay, name themselves `npx genclass` in their help
65
+ and errors, and point a newer runtime at `npx genclass@latest`.
66
+
3
67
  ## 0.3.3
4
68
 
5
69
  - **"Put this app in your account" works.** For an app that already has GenClass in it but is not in the signed-in
package/README.md CHANGED
@@ -11,7 +11,7 @@ Run it in your web app's folder. It shows where the project stands and walks you
11
11
  per step. Stop at any point and run it again: it continues from what is true now.
12
12
 
13
13
  ```text
14
- ╭─ GenClass ────────────────────────────────────────────── v0.3.0 ─╮
14
+ ╭─ GenClass ────────────────────────────────────────────── v0.3.6 ─╮
15
15
  │ │
16
16
  │ Welcome back, Ada! │
17
17
  │ │
@@ -50,34 +50,36 @@ it, and `d` again to fold it back.
50
50
  When the walk is done (or you press `q` to leave it for later), the command does not end. It asks what next:
51
51
 
52
52
  ```text
53
- What next? A command, or a question about your app.
54
- dashboard what GenClass found on your live site
55
- problems every problem, by kind and page
56
- analytics visitors, pages, sources, clicks
57
- events the latest events, one per line
58
- fix hand a problem to your coding agent
59
- ask ask about your app (or just type it)
60
- connections alerts, GitHub, your coding agent
61
- suggest what your app is missing
62
- help every command q leave
53
+ What next? A number, a command, or a question.
54
+ 1 dashboard what GenClass found on your live site
55
+ 2 problems every problem, by kind and page
56
+ 3 analytics visitors, pages, sources, clicks
57
+ 4 events the latest events, one per line
58
+ 5 fix hand a problem to your coding agent
59
+ 6 ask ask about your app (or just type it)
60
+ 7 connections alerts, GitHub, your coding agent
61
+ 8 suggest what your app is missing
62
+ 9 profile your account and plan, and upgrade
63
+ help every command q leave
63
64
 
64
65
  ❯ which page loses the most visitors?
65
66
  ```
66
67
 
67
- Type a command, or a sentence: a sentence is a question about your app. `q` leaves. Everything here is also a
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
68
70
  command of its own (`npx genclass problems`), so scripts and coding agents use the same things.
69
71
 
70
- **Just `genclass`.** `npx` runs the command without installing it, so `genclass` alone is not a command yet. The
71
- first time the home opens it offers to install it (`npm install -g genclass`, shown before it runs, asked once).
72
- After that you type `genclass`, and every screen says `genclass` instead of `npx genclass`.
72
+ **Just `genclass`.** `npx` runs the command without installing it, so the first run on a terminal installs it
73
+ (`npm install -g genclass`, said on screen; `npm uninstall -g genclass` takes it out, `GENCLASS_NO_INSTALL=1` turns
74
+ it off). After that you type `genclass`, and every screen says `genclass` instead of `npx genclass`.
73
75
 
74
76
  ## Every part, in order
75
77
 
76
78
  | Part | What the step does | What it changes |
77
79
  |---|---|---|
78
80
  | 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. |
79
- | Plan | On Free, shows the paid plan first: Enter opens its checkout in your browser, `f` goes on with Free for now. Asked once per project. | Nothing in your project. The payment is on Stripe's page; the command never sees a card. |
80
81
  | 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. |
81
83
  | Dashboard | Waits for your live site to be opened once. GenClass sends nothing from localhost. | Nothing. |
82
84
  | 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. |
83
85
  | 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. |
@@ -189,7 +191,8 @@ App is doing on the repository, whether your coding agent is connected, and whet
189
191
  ## Account
190
192
 
191
193
  `npx genclass apps` lists your apps (`apps new "Name"` makes one). `npx genclass plan` shows your plan, its limits
192
- and what is used; on Free it shows the paid plan and Enter opens its checkout. `npx genclass team` shows who is on
194
+ 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
193
196
  the plan (`team invite` makes a single-use invite link).
194
197
 
195
198
  **What a terminal may do** is listed on the page where you approve its sign-in, and nothing else: read your apps'
@@ -229,8 +232,8 @@ prompt) is shown for the first three items on Free and for all of them on Team,
229
232
 
230
233
  ## Commands
231
234
 
232
- `npx` runs the command without installing it. To type just `genclass`, install it once: `npm install -g genclass`
233
- (the command offers to, the first time its home opens).
235
+ `npx` runs the command without installing it. The first run on a terminal installs it, so you can type just
236
+ `genclass` (by hand: `npm install -g genclass`).
234
237
 
235
238
  | | |
236
239
  |---|---|
@@ -246,12 +249,13 @@ prompt) is shown for the first three items on Free and for all of them on Team,
246
249
  | `npx genclass export` | every stored event as a file (`--from`, `--to`, `--format csv`, `--out`) |
247
250
  | `npx genclass fix [number, kind or all]` | hand a problem to your coding agent (`--print`, `--copy`, `--agent <name>`) |
248
251
  | `npx genclass ask "..."` | a question about your app, answered from its numbers |
249
- | `npx genclass suggest [url]` | what your app is missing (`--yes`, `--no-model`, `--all`) |
252
+ | `npx genclass suggest [url]` | what your app is missing, then one number hands the list to your coding agent (`--yes`, `--no-model`, `--all`) |
250
253
  | `npx genclass scan <url>` | 23 visual checks on one page |
251
254
  | `npx genclass connections` | alerts, GitHub App, coding agent (`add`, `test`, `on`, `off`, `remove` a destination) |
252
255
  | `npx genclass agent` | your coding agent and what it did (`agent link`) |
253
256
  | `npx genclass funnels` | funnels (`add "Name" /a /b`, `remove "Name"`) |
254
257
  | `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 |
255
259
  | `npx genclass login`, `logout`, `whoami` | your account |
256
260
  | `npx genclass remove` | take GenClass out of the app again |
257
261