Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
60 commits
Select commit Hold shift + click to select a range
a117bfe
genclass-alpha: privacy, doctor, two suggest safety checks, fixes fro…
Karanvir1729 Nov 14, 2026
e915c91
genclass flake: is this Playwright test flaky, or is my app racy?
Karanvir1729 Nov 14, 2026
a9b9909
genclass-alpha onboarding: the Coding agent step links the dev page, …
Karanvir1729 Nov 14, 2026
d34e50c
@genclass/mcp polish from a coding agent's real run: origins, explore…
Karanvir1729 Nov 14, 2026
de5f0d2
runtime: consent mode (consent: "pending", GenClass.consent) for site…
Karanvir1729 Nov 14, 2026
a45e67c
Merge alpha/flake: genclass flake
Karanvir1729 Nov 14, 2026
da711be
Merge alpha/onboarding: the walk wires the coding agent end to end
Karanvir1729 Nov 14, 2026
63a7abf
Merge alpha/mcp-polish: origins, explore wait, better generated tests…
Karanvir1729 Nov 14, 2026
50b2065
Merge alpha/consent-mode: consent: pending in the runtime
Karanvir1729 Nov 14, 2026
6a2dc71
genclass privacy: learned state as the runtime keeps it (nothing by d…
Karanvir1729 Nov 14, 2026
c941956
@genclass/mcp: race tests that pass on the fixed page, origins said, …
Karanvir1729 Nov 14, 2026
c40ec91
genclass agent link: no link without the runtime's ./agent entry, imp…
Karanvir1729 Nov 14, 2026
a1eb18a
genclass suggest: secrets-in-bundle reads the app's own scripts and s…
Karanvir1729 Nov 14, 2026
2a67ca4
genclass doctor: read the site's policy as a browser does, find the p…
Karanvir1729 Nov 14, 2026
458e795
genclass privacy: read GenClass's options from its own places only, a…
Karanvir1729 Nov 14, 2026
6589129
genclass alpha: setup answers, the home's local commands, flake's ver…
Karanvir1729 Nov 14, 2026
8a180d4
consent: fixes from the review (URL opt-out, bucket and breaker, anal…
Karanvir1729 Nov 14, 2026
8918ab7
Merge alpha/fix-privacy: review fixes
Karanvir1729 Nov 14, 2026
b229d7a
Merge alpha/fix-doctor: review fixes
Karanvir1729 Nov 14, 2026
2f6bee7
Merge alpha/fix-agentlink: review fixes
Karanvir1729 Nov 14, 2026
db31c69
Merge alpha/fix-mcp: review fixes
Karanvir1729 Nov 14, 2026
507e690
Merge alpha/fix-consent: review fixes
Karanvir1729 Nov 14, 2026
3798383
Merge alpha/fix-suggest: review fixes
Karanvir1729 Nov 14, 2026
cec415f
Merge alpha/fix-cli-misc: review fixes
Karanvir1729 Nov 14, 2026
11472d4
consent: a ready cut short by a model withdrawal resolves; re-granted…
Karanvir1729 Nov 14, 2026
2033a7f
genclass suggest: fixes from the second check (AWS pairs as NAME=valu…
Karanvir1729 Nov 14, 2026
f77a883
genclass doctor: check every page route's policy, read _headers as ho…
Karanvir1729 Nov 14, 2026
12df444
genclass alpha, review round 2: init's folded code pastes as code; fl…
Karanvir1729 Nov 14, 2026
0526671
@genclass/mcp: a value cut short ends at its …; the skill's no-origin…
Karanvir1729 Nov 14, 2026
85900a2
genclass agent link: Plug'n'Play installs linked again; the call befo…
Karanvir1729 Nov 14, 2026
889f3c1
genclass privacy: read the setup as the runtime reads it, so the map …
Karanvir1729 Nov 14, 2026
880f0ad
Merge alpha/fix2-privacy: round 2 review fixes
Karanvir1729 Nov 14, 2026
9b30259
Merge alpha/fix2-doctor: round 2 review fixes
Karanvir1729 Nov 14, 2026
17e16a8
Merge alpha/fix2-agentlink: round 2 review fixes
Karanvir1729 Nov 14, 2026
75ec389
Merge alpha/fix2-mcp: round 2 review fixes
Karanvir1729 Nov 14, 2026
809fd9d
Merge alpha/fix2-consent: round 2 review fixes
Karanvir1729 Nov 14, 2026
f90748b
Merge alpha/fix2-suggest: round 2 review fixes
Karanvir1729 Nov 14, 2026
15ac4fa
Merge alpha/fix2-cli-misc: round 2 review fixes
Karanvir1729 Nov 14, 2026
335f32b
genclass suggest: a script's read past exactly 1 MB keeps what came; …
Karanvir1729 Nov 14, 2026
ce550ae
consent: a model withdrawal also settles ready and ask() with model.u…
Karanvir1729 Nov 14, 2026
af5d010
genclass doctor: API and asset patterns not led by their folder are n…
Karanvir1729 Nov 14, 2026
2e4ff3d
@genclass/mcp: any value after a cut one keeps the #N renaming; the 0…
Karanvir1729 Nov 14, 2026
5dc0cc1
genclass alpha, review round 3: flake's title and commands, init's im…
Karanvir1729 Nov 14, 2026
e6745c9
genclass-alpha review round 3: the coding-agent link is a file of its…
Karanvir1729 Nov 14, 2026
dd3ecc5
genclass privacy: read only what certainly applies, and take the read…
Karanvir1729 Nov 14, 2026
858703a
Merge alpha/fix3-privacy: round 3 review fixes
Karanvir1729 Nov 14, 2026
36cf5d2
Merge alpha/fix3-doctor: round 3 review fixes
Karanvir1729 Nov 14, 2026
5191639
Merge alpha/fix3-agentlink: round 3 review fixes
Karanvir1729 Nov 14, 2026
cb5f70b
Merge alpha/fix3-mcp: round 3 review fixes
Karanvir1729 Nov 14, 2026
a86fd87
Merge alpha/fix3-consent: round 3 review fixes
Karanvir1729 Nov 14, 2026
ee70729
Merge alpha/fix3-suggest: round 3 review fixes
Karanvir1729 Nov 14, 2026
488b9fa
Merge alpha/fix3-cli-misc: round 3 review fixes
Karanvir1729 Nov 14, 2026
5b0b553
Review round 3 leftovers: privacy keeps the higher certain reading (l…
Karanvir1729 Nov 14, 2026
702e8b5
genclass doctor: the header names the signed-in account, as its Signe…
Karanvir1729 Nov 14, 2026
984d748
genclass doctor: the To fix list wraps to the window
Karanvir1729 Nov 14, 2026
0dd85e8
genclass privacy: the header names the signed-in account from the loc…
Karanvir1729 Nov 14, 2026
f485a48
Merge origin/main (genclass 0.3.9 and later) into genclass-alpha
Karanvir1729 Nov 14, 2026
8f2e2bd
genclass 0.4.0-alpha.0: a closed pipe ends the command quietly (no EP…
Karanvir1729 Nov 14, 2026
ad94210
genclass 0.4.0-alpha.0 pre-release fixes: an alpha never installs ove…
Karanvir1729 Nov 14, 2026
8223b6c
runtime first load: the telemetry summary's counts are copied from th…
Karanvir1729 Nov 14, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,14 +14,14 @@ Default mode is `observe` (report only); `guard` is opt-in; `heal` is experiment

| path | what |
|---|---|
| `packages/runtime/` | the library: `src/` (incl. `auto.ts`, `cdn/`, `situation/`, `decide/`, `model/`, `devtools/`, `visual/` (measured visual checks: `start.ts` is the first-load stub, the rest is the lazy chunk), `analytics/` (interaction analytics, opt-in: `start.ts` stub, `index.ts` lazy chunk; `docs/runtime/ANALYTICS.md`), `agent/` (`@genclass/runtime/agent`, the coding-agent link: recording, delivery schedules, the bridge link; its own entry, never in the first load; `docs/runtime/AGENT.md`)), `test/` (vitest; `test/install/`, `test/browser/`, `test/browser/visual/` (Playwright, the CI `visual-browser` job)), `bin/` (CLI: `init`, `remove`, `login`, `connect`, `whoami`, `logout`, `dashboard`, `scan`/`audit`, `fetch-model`, `info`), `CHANGELOG.md`, `TELEMETRY.md`, `INTERCEPTION.md` |
| `packages/runtime/` | the library: `src/` (incl. `auto.ts`, `cdn/`, `situation/`, `decide/`, `model/`, `devtools/`, `visual/` (measured visual checks: `start.ts` is the first-load stub, the rest is the lazy chunk), `analytics/` (interaction analytics, opt-in: `start.ts` stub, `index.ts` lazy chunk; `docs/runtime/ANALYTICS.md`), `consent.ts` (the lazy chunk that applies `GenClass.consent(...)` under `consent: "pending"`; the gates themselves are in the first load), `agent/` (`@genclass/runtime/agent`, the coding-agent link: recording, delivery schedules, the bridge link; its own entry, never in the first load; `docs/runtime/AGENT.md`)), `test/` (vitest; `test/install/`, `test/browser/`, `test/browser/visual/` (Playwright, the CI `visual-browser` job)), `bin/` (CLI: `init`, `remove`, `login`, `connect`, `whoami`, `logout`, `dashboard`, `scan`/`audit`, `fetch-model`, `info`), `CHANGELOG.md`, `TELEMETRY.md`, `INTERCEPTION.md` |
| `packages/runtime-model/` | the data-only model package (`files/` is gitignored, filled at release) and `MODEL_CARD.md` |
| `sim/` | deterministic training-data simulator driving the real runtime (`SEPARABILITY.md`, `README.md`) |
| `realapps/` | 128 real apps run in headless Chromium with the real runtime: training rows and the never-worse sweep |
| `training/` | vocabulary pruning, curriculum (`curriculum/rt.py` mirrors the runtime's situation renderer), Azure training, ONNX export, `EVAL.md` |
| `demos/` | six demo apps with a chaos backend and Playwright trials; `bench/heal/` runs them per mode |
| `packages/mcp/` | `@genclass/mcp`: the MCP server for coding agents (bridge on 127.0.0.1:47357, store, explore verdicts, replays, regression-test generation, 9 tools incl. `genclass_scan`, which runs the runtime CLI's `scan`); no runtime deps; `test/e2e/race.e2e.mjs` is the real-browser check (not in CI's main job). `plugin/` is the Claude Code plugin (also an Agent Plugins package); `server.json`, the plugin, `.claude-plugin/`, `.cursor-plugin/`, `gemini-extension.json`, `llms-install.md` and the READMEs pin its version (`npm run sync -w @genclass/mcp` after a version bump; `test/manifests.test.ts` fails otherwise); `scripts/plugin-repo.mjs` assembles genclass-dev/genclass-plugin (the plugin at a repository root with its marketplace files and the released server vendored from npm under `server/`, which `.mcp.json` and the hook there run with `node` from `${CLAUDE_PLUGIN_ROOT}`, for the Claude directory's 50 MiB archive limit and its holds on `npx` launchers and lockfiles, Codex, Gemini CLI, `gh skill`; that repository re-syncs daily from main and is never edited by hand) |
| `packages/cli/` | `genclass` (`npx genclass`): the one way to set GenClass up, `genclass dashboard` (one app, whole, in the terminal) and `genclass suggest`. Plain ESM `.mjs` in `src/` (`main.mjs` names the command to the runtime CLI's modules, which it reuses from `packages/runtime/bin/lib`: sign-in, project detection, `init`; `state.mjs` reads the seven steps of a project from disk and from genclass.dev (account, runtime, dashboard, test workflow, GitHub App, coding agent, suggestions); `setup.mjs` and `actions.mjs` walk them, one Enter each, in a short view that `d` expands; `art.mjs` is the opening wordmark; `app.mjs` is `genclass dashboard`, which reads `GET /api/cli/app` (the dashboard's own numbers; a CLI session approved before the approval page said so is asked to sign in again); `views.mjs` is the rest of the dashboard from the same answer (`problems`, `analytics`, `events`, `health`, `agent`, `report`); `kinds.mjs` holds the dashboard page's own texts for each kind and its fix prompts (a test reads `telemetry-worker/src/pages.ts` and fails when a sentence differs); `fix.mjs` hands a problem to the person's coding agent with that prompt (it starts `claude`, `codex`, `cursor-agent` or `gemini` on a key press, or copies or prints; GenClass changes no code); `ask.mjs` is a question to genclass.dev's model; `manage.mjs` is the account's side (`apps`, `plan`, `team`, `connections`, `export`, `funnels`, `agent link`) over the routes a newer approval lists, with `session.mjs` saying why a call was refused and what to do next; `home.mjs` is the prompt the command stays open on after the walk (a command, or a sentence that is a question); `name.mjs` makes every screen say `genclass` once it is installed, `npx genclass` until then; `suggest/` measures the repository and the live site (`repo.mjs`, `site.mjs`), runs the catalog of checks (`checks.mjs`) and asks genclass.dev to order and explain what failed (`digest.mjs` is everything that is sent); `tui.mjs` is the look); `build.mjs` bundles it into one file with no dependencies (`dist/genclass.mjs`) with the runtime and MCP versions it installs; tests in `test/` (`server.test.ts` runs it against the collector in process). The server side is `telemetry-worker/src/cli.ts`, `suggest.ts` (rule 11) and `ask.ts` (rule 12). On npm as `genclass` since 2026-11-12, released by `release-cli.yml` on a `cli-v*` tag; it is the first install line the README names |
| `packages/cli/` | `genclass` (`npx genclass`): the one way to set GenClass up, `genclass dashboard` (one app, whole, in the terminal) and `genclass suggest`. Plain ESM `.mjs` in `src/` (`main.mjs` names the command to the runtime CLI's modules, which it reuses from `packages/runtime/bin/lib`: sign-in, project detection, `init`; `state.mjs` reads the seven steps of a project from disk and from genclass.dev (account, runtime, dashboard, test workflow, GitHub App, coding agent, suggestions); `setup.mjs` and `actions.mjs` walk them, one Enter each, in a short view that `d` expands; `art.mjs` is the opening wordmark; `app.mjs` is `genclass dashboard`, which reads `GET /api/cli/app` (the dashboard's own numbers; a CLI session approved before the approval page said so is asked to sign in again); `views.mjs` is the rest of the dashboard from the same answer (`problems`, `analytics`, `events`, `health`, `agent`, `report`); `kinds.mjs` holds the dashboard page's own texts for each kind and its fix prompts (a test reads `telemetry-worker/src/pages.ts` and fails when a sentence differs); `fix.mjs` hands a problem to the person's coding agent with that prompt (it starts `claude`, `codex`, `cursor-agent` or `gemini` on a key press, or copies or prints; GenClass changes no code); `ask.mjs` is a question to genclass.dev's model; `manage.mjs` is the account's side (`apps`, `plan`, `team`, `connections`, `export`, `funnels`, `agent link`) over the routes a newer approval lists, with `session.mjs` saying why a call was refused and what to do next; `home.mjs` is the prompt the command stays open on after the walk (a command, or a sentence that is a question); `name.mjs` makes every screen say `genclass` once it is installed, `npx genclass` until then; `privacy.mjs` is `genclass privacy` (what the project's setup sends and keeps, read from its files; free, no network), `doctor.mjs` is `genclass doctor` (every part's health, `--fix` for GenClass's own lines: the MCP pin, the skill, the dev-only agent link where `agentlink.mjs` plans it, which is every setup `init` writes but Angular, Nuxt, a plain script tag, another bundler or a setup by hand), `update.mjs` the once-a-day newer-release line; `agentlink.mjs` plans the dev-only `connectAgent` link the Coding agent step and `doctor --fix` write (in a `genclass:init` block `remove` takes out); `flake.mjs` is `genclass flake` (the project's Playwright suite through `@genclass/playwright` once in the natural order and once per seed: passed, racy, flaky or broken per test, from the race files; free, local); `suggest/` measures the repository and the live site (`repo.mjs`, `site.mjs`, including the shipped scripts' secret keys and the installed framework versions), runs the catalog of checks (`checks.mjs`) and asks genclass.dev to order and explain what failed (`digest.mjs` is everything that is sent); `tui.mjs` is the look); `build.mjs` bundles it into one file with no dependencies (`dist/genclass.mjs`) with the runtime and MCP versions it installs; tests in `test/` (`server.test.ts` runs it against the collector in process). The server side is `telemetry-worker/src/cli.ts`, `suggest.ts` (rule 11) and `ask.ts` (rule 12). On npm as `genclass` since 2026-11-12, released by `release-cli.yml` on a `cli-v*` tag; it is the first install line the README names |
| `packages/sv/` | `@genclass/sv`: the Svelte CLI community add-on (`npx sv add @genclass`): adds the runtime, the `/auto` import first in `src/hooks.client`, the dev-only overlay and (default) the telemetry opt-out meta in `src/app.html`, all with the `genclass:init` marker so `remove` undoes it; bundles `@sveltejs/sv-utils`, `sv` is a peer; `test/e2e/` runs sv's add-on harness (pnpm, Chromium) |
| `packages/playwright/` | `@genclass/playwright`: the fixture (`src/fixture.ts`, `install.ts`, `page.ts`, `chaos.ts`, `races.ts`: puts the runtime's script-tag build on every `page` in observe mode with telemetry off, seeded chaos that holds matched fetch/XHR requests with `page.route` and `route.fallback()`, witnesses through the agent entry with every hold off, one `genclass-races/1` file per test in `test-results/genclass/`, with where the test is declared (`location`), which the GitHub App's inline comments use) and the reporter + pure summariser that read those files and write `genclass-report.md` for the PR; peer deps only (`@playwright/test`, `@genclass/runtime`); zero-edit mode (`src/register.ts`, `wrap.ts`, `worker.ts`, `run.ts`: the command `genclass-playwright-run` gives an unmodified suite the same instrumentation by wrapping public Playwright objects in the worker process; `docs/github-app/workflows/genclass.yml` is the one file a repository adds); `test/e2e/run.mjs` is the real-browser check of both (its own workflow) |
| `packages/nuxt/`, `packages/astro/` | `@genclass/nuxt` (a Nuxt module, `@nuxt/kit`, built with `@nuxt/module-builder`) and `@genclass/astro` (an Astro integration, `injectScript("page", ...)`): from options `{ mode, token?, telemetry?, devtools? }` they generate the runtime's own one line (`/auto` or `/auto/guard`) plus a `window.GENCLASS_CONFIG` module imported before it; browser only, nothing on the server; `@genclass/runtime` is a peer dependency. The generated code is pure (`src/source.ts`, `src/index.ts`) and the tests check it exactly, then build one fixture app. Workflow: `integrations.yml` (Node 24) |
Expand Down Expand Up @@ -62,7 +62,9 @@ the e2e needs the runtime built too: `node packages/playwright/test/e2e/run.mjs`
`packages/cli/` (`genclass`, the one command) has its own workflow, `cli.yml` (never blocks `ci.yml`):
`npm run build -w genclass && (cd packages/cli && npx vitest run)`; the tests need no network (genclass.dev is the
collector in process or a stand-in, the model and the sites are stand-ins). Its sources are plain `.mjs` and are not
type-checked.
type-checked. The real-browser check of `genclass flake` is not in `cli.yml` (it needs Chromium; about 40 s on the
development Mac): `npm run build -w @genclass/runtime && npm run build -w @genclass/playwright && npm run build -w genclass && node packages/cli/test/e2e/flake.e2e.mjs`;
its numbers are in RESULTS.md section 30.

`packages/sv/` (`@genclass/sv`, the Svelte CLI add-on) has its own workflow, `sv-addon.yml` (never blocks `ci.yml`):
`npm run typecheck -w @genclass/sv && npm run build -w @genclass/sv && (cd packages/sv && npx vitest run --project unit)`;
Expand Down
Loading
Loading