genclass 0.2.2 → 0.2.3

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,70 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.2.3
4
+
5
+ From using the command on a real site the morning after 0.2.2, and from watching its owner use it:
6
+
7
+ - **A new first screen.** On a terminal the command opens with a welcome card: its name and version in the border,
8
+ "Welcome back, Ada!" (or, signed out, what GenClass does in two lines), GenClass's logo as pixel art (the green
9
+ arrow over the top, the red arrow underneath, in the logo's own two greens and two reds), and three quiet lines for
10
+ the app, the account and the folder. It fits a 58-column window, where the old block-letter wordmark never showed.
11
+ What comes next stands beside a green bar, and the question is one line under a rule: `❯ Enter to continue · d
12
+ every part · s skip · q stop`. Piped output and `--json` are as plain as before.
13
+ - **An app on Vite 7 or earlier builds again.** Found by installing into a fresh Vite 7 app and running its
14
+ build: `vite build` failed with `Invalid value "iife" for option "worker.format"` once GenClass was in it, because
15
+ Vite before 8 bundles a worker as one classic script and the model's worker cannot be one. Every app in GenClass's
16
+ own repository is on Vite 8, so this was never seen. The runtime step now shows and writes the two settings such
17
+ an app needs (`worker: { format: "es" }` for the build, `optimizeDeps: { exclude: ["@genclass/runtime"] }` so the
18
+ dev server runs the model in a worker instead of on the page's thread), as the first keys of your Vite config,
19
+ with its own marker. An app that already has GenClass gets "Add two Vite settings" as its next step. A config it
20
+ cannot edit without guessing (a function, one that sets `worker` itself, an app with workers of its own) is left
21
+ alone and gets the two lines to add by hand. `remove` takes them out. Vite 8 needs nothing and gets nothing.
22
+ - **`npx genclass dashboard`, after seeing it on a real account:** the list is largest first whatever order the
23
+ server sends, and leads with what happened in plain words ("old data replaced newer data", then the page) instead
24
+ of the kind's name and a cut-off explanation; `--all` adds the kind's own name. The first number is "Page loads",
25
+ the dashboard page's own word (it said "Visits watched" next to a different "visits" under Visitors). The chart of
26
+ problems has a line of its own and folds a long period to the window. Long lines fold; nothing ends in "…".
27
+ - **`npx genclass remove` takes out everything GenClass put in the project.** After the runtime (the import, the
28
+ config file, the package) it lists what the other steps wrote and removes it on one more yes: GenClass's entry
29
+ in `.mcp.json` (your other servers stay; the file goes only when that entry was all it held), the skill (only
30
+ while it still carries its marker), the pull-request workflow (only while it is exactly the file this command
31
+ wrote) and `.genclass/`, where the coding agent's tools keep what they recorded. What you made your own is kept
32
+ and named. Your app stays in your account.
33
+ - **From walking the whole setup as a new user, twice, on a real terminal at 80 and 58 columns:**
34
+ - A sign-in that did not finish (the code expired, the browser said no) is offered once more instead of the walk
35
+ moving on without an account.
36
+ - The sign-in step says where a new person's account comes from ("New here? Your free account is made there").
37
+ - Nothing runs past a narrow window any more: the runtime step's lines, the suggestions (a long evidence line
38
+ wraps instead of ending in "…"), the list of steps, the day-to-day commands. A command or an address is never
39
+ split across two lines.
40
+ - Suggestions no longer list the internal names of checks that need your site ("Not checked (20): https,
41
+ www-joined, ..."); it says how many there are and how to get them.
42
+ - **Every command it names is one you can run.** The screens said `genclass suggest`, which is "command not found"
43
+ for anyone who started with `npx genclass` and has nothing installed. They now say `npx genclass suggest`, in the
44
+ views, the help and the `run` fields of `--json`. The help says how to get the short name
45
+ (`npm install -g genclass`).
46
+ - **A folder that is not a web app is no longer a dead end.** In a monorepo's root, or the folder above the app, the
47
+ command lists the web apps it finds below (three folders deep, eight named) with the command for each, and on a
48
+ terminal it asks which one and carries on there. `status --json` carries the list as `app.below`.
49
+ - A mistyped command names the nearest one: `genclass dashbord` says "Did you mean npx genclass dashboard?".
50
+ - **`genclass login` signs in again when it has to.** With a sign-in from before the command could show dashboards,
51
+ `genclass dashboard` said "run genclass login" and `genclass login` answered "already signed in". It now says what
52
+ is missing and asks for one more approval in the browser.
53
+ - **`genclass scan --local` works.** The command carries no copy of the runtime, so it uses the one installed in the
54
+ project (`node_modules/@genclass/runtime`, in this folder or one above it). When there is none it says what to
55
+ install, instead of naming a build step of GenClass's own repository.
56
+ - **`genclass scan` waits for a scan of the same page that is already running** (someone else's, or yours a moment
57
+ ago) and prints that scan's report, instead of stopping with "try again in 20 s".
58
+ - **A normal page is not told its check "could not finish".** A page with no search box and no form gives the race
59
+ probe nothing to try; that row now reads "nothing to try on this page" and does not count as a part that failed.
60
+ - **A page check that could not finish says so next to the score.** On a heavy page the hosted check runs out of
61
+ time, and the report read "Score 83/100" with five of eight parts not measured further down. It now reads
62
+ "Score 83/100 over 3 of 8 parts", says which parts the score covers and why, and gives the command that runs the
63
+ visual checks on your computer with no time limit. With nothing measured it is one sentence, not a table of dashes.
64
+ - The page check's help and messages say `genclass scan`, not `genclass-runtime scan`, the help says where the
65
+ check runs by default (on genclass.dev), and the full report's link is on genclass.dev.
66
+ - The npm page links to the command's guide, genclass.dev/docs/cli.
67
+
3
68
  ## 0.2.2
4
69
 
5
70
  From a walk through the whole setup as a new user, against a local copy of genclass.dev:
package/README.md CHANGED
@@ -10,30 +10,38 @@ Run it in your web app's folder. It shows where the project stands and walks you
10
10
  per step. Stop at any point and run it again: it continues from what is true now.
11
11
 
12
12
  ```text
13
- ██████╗ ███████╗███╗ ██╗ ██████╗██╗ █████╗ ███████╗███████╗
14
- ██╔════╝ ██╔════╝████╗ ██║██╔════╝██║ ██╔══██╗██╔════╝██╔════╝
15
- ██║ ███╗█████╗ ██╔██╗ ██║██║ ██║ ███████║███████╗███████╗
16
- ██║ ██║██╔══╝ ██║╚██╗██║██║ ██║ ██╔══██║╚════██║╚════██║
17
- ╚██████╔╝███████╗██║ ╚████║╚██████╗███████╗██║ ██║███████║███████║
18
- ╚═════╝ ╚══════╝╚═╝ ╚═══╝ ╚═════╝╚══════╝╚═╝ ╚═╝╚══════╝╚══════╝
13
+ ╭─ GenClass ────────────────────────────────────────────── v0.2.3 ─╮
14
+ │ │
15
+ │ Welcome back, Ada! │
16
+ │ │
17
+ │ ▄▄▄▄█▄ │
18
+ │ ▄█████████ │
19
+ │ ▄███▀▀ ▀▀ │
20
+ │ ███▀ ▄▄▄▄▄ │
21
+ │ ███▄ ▀█████ │
22
+ │ ▀███▄ ▄▄ ▄███▀ │
23
+ │ ▀▀▄████████▀ │
24
+ │ ▀▀█▀▀▀ │
25
+ │ │
26
+ │ shop • Vite + React │
27
+ │ ada@example.com • Free plan │
28
+ │ ~/code/shop │
29
+ │ │
30
+ ╰──────────────────────────────────────────────────────────────────╯
19
31
 
20
- Finds what breaks in your web app, and tells you what it needs next. v0.2.2
21
-
22
- GenClass • shop Vite + React
23
- ada@example.com • Free plan
24
- ────────────────────────────────────────────────────────────────────────────
25
32
  ✔ Done Account • Runtime
26
33
  ● Next Add the test workflow
27
34
  ◌ Waiting Dashboard: deploy, then open your site once
28
35
  ○ Later GitHub App • Coding agent • Suggestions
29
36
 
30
- Next Add the test workflow
31
- One new file, .github/workflows/genclass.yml. Your tests are not changed.
37
+ ▎ Next Add the test workflow
38
+ ▎ One new file, .github/workflows/genclass.yml.
32
39
 
33
- Enter to continue, d for every part, s to skip, q to stop
40
+ ────────────────────────────────────────────────────────────────────
41
+ ❯ Enter to continue · d every part · s skip · q stop
34
42
  ```
35
43
 
36
- The view stays that short. Press `d` (or run `genclass status --all`) to see every part with what is known about
44
+ The view stays that short. Press `d` (or run `npx genclass status --all`) to see every part with what is known about
37
45
  it, and `d` again to fold it back.
38
46
 
39
47
  ## Every part, in order
@@ -83,7 +91,7 @@ suggestions run left to do.
83
91
  Visitors 312 visits · 1,020 page views · 41% left after one page
84
92
  Coding agent 5 found · 3 reproduced · 2 fixed · 1 with a test
85
93
  GitHub App reviewing · 4 pull requests so far
86
- Suggestions 7 to do, 2 urgent · checked 2 days ago · genclass suggest
94
+ Suggestions 7 to do, 2 urgent · checked 2 days ago · npx genclass suggest
87
95
  ```
88
96
 
89
97
  `--range 24h`, `7d` or `30d` picks the period, `--all` shows every row, `--app <name>` another app of your account,
@@ -122,16 +130,18 @@ prompt) is shown for the first three items on Free and for all of them on Team,
122
130
 
123
131
  ## Commands
124
132
 
133
+ `npx` runs the command without installing it. To type just `genclass`, install it once: `npm install -g genclass`.
134
+
125
135
  | | |
126
136
  |---|---|
127
- | `genclass` | where the project stands; on a terminal, the next step |
128
- | `genclass setup` | the guided setup (`--yes`: no questions) |
129
- | `genclass status` | what is done and what is next (`--all`: every part; `--json`) |
130
- | `genclass suggest [url]` | what your app is missing (`--json`, `--yes`, `--no-model`, `--all`) |
131
- | `genclass dashboard` | your app in the terminal (`--range`, `--all`, `--app`, `--open`, `--json`) |
132
- | `genclass scan <url>` | 23 visual checks on one page |
133
- | `genclass login`, `logout`, `whoami` | your account |
134
- | `genclass remove` | take GenClass out of the app again |
137
+ | `npx genclass` | where the project stands; on a terminal, the next step |
138
+ | `npx genclass setup` | the guided setup (`--yes`: no questions) |
139
+ | `npx genclass status` | what is done and what is next (`--all`: every part; `--json`) |
140
+ | `npx genclass suggest [url]` | what your app is missing (`--json`, `--yes`, `--no-model`, `--all`) |
141
+ | `npx genclass dashboard` | your app in the terminal (`--range`, `--all`, `--app`, `--open`, `--json`) |
142
+ | `npx genclass scan <url>` | 23 visual checks on one page |
143
+ | `npx genclass login`, `logout`, `whoami` | your account |
144
+ | `npx genclass remove` | take GenClass out of the app again |
135
145
 
136
146
  Options everywhere: `--cwd <dir>`, `--yes`, `--json`, `--no-browser`.
137
147