@cellajs/cli 0.6.6 → 0.7.0

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/README.md CHANGED
@@ -26,7 +26,7 @@ Develop, security and gate commands run without `cella.config.ts`; upstream comm
26
26
  | `testbed` | A throwaway copy of the app on its own seeded database and ports, beside `pnpm dev` (see [Testbed](#testbed)) |
27
27
  | `bench` | Load-test the running app with its scenarios and check what the stack did with the load (see [Bench](#bench)) |
28
28
  | `a11y` | Audit the app against WCAG 2.2 AA on a testbed and keep the conformance ledger (see [a11y](#a11y)) |
29
- | `screenshots` | Shoot the app's marketing screenshots on a testbed (see [Screenshots](#screenshots)) |
29
+ | `shoot` | Shoot the app's marketing screenshots on a testbed (see [Screenshots](#screenshots)) |
30
30
  | `i18n` | Translation status, unused keys and renames across the locale files and the code (see [Translations](#translations)) |
31
31
 
32
32
  | Security | Description |
@@ -40,10 +40,9 @@ Develop, security and gate commands run without `cella.config.ts`; upstream comm
40
40
  | `upgrade` | Merge upstream changes onto a fresh branch, merge package.json and open a squash-merge PR into `main` |
41
41
  | `align` | List the upstream alignments this app has not handled yet, read them, run their codemods, record them |
42
42
  | `stats` | Count files by category and workspace package; with `--since <ref>`, count what the current branch changed, by kind of file |
43
- | `forks` * | Run the upgrade inside local fork repositories |
44
- | `contributions` * | Pull and adopt changes from local forks |
43
+ | `adopt` * | Pull and adopt changes from local forks (see [Adopt](#adopt-from-forks)) |
45
44
 
46
- \* `forks` and `contributions` only appear when you have `forks` configured in `cella.config.ts`.
45
+ \* `adopt` only appears when you have `forks` configured in `cella.config.ts`.
47
46
 
48
47
  | Gate | Description |
49
48
  |------|-------------|
@@ -62,15 +61,14 @@ Per-command help: `pnpm cella <command> --help`.
62
61
  | testbed | `stop`, `--fresh`, `--showcase`, `-- <command>` |
63
62
  | bench | `[scenario]`, `--all`, `--short`, `--isolated`, `--skip-seed` |
64
63
  | a11y | `report`, `decide`, `--states <ids>`, `--workers <n>`, `--email <address>`, `--publish`, `--draft`, `--file <path>` |
65
- | screenshots | `<ids...>`, `--out <dir>`, `--email <address>` |
64
+ | shoot | `<ids...>`, `--out <dir>`, `--email <address>` |
66
65
  | i18n | `unused`, `rename <ns:old> <ns:new>`, `--json` |
67
66
  | pentest | `report`, `--only <probe,nuclei,zap>`, `--json` |
68
67
  | analyze | `--list`, `--json`, `--scope <all\|risk\|protected>`, `--all`, `--track <release\|branch>`, `--ref <ref>`, `--unpinned` |
69
68
  | upgrade | `--track <release\|branch>`, `--ref <ref>`, `--keep-config`, `--unpinned` |
70
69
  | align | `--all`, `--json`, `--show <id>`, `--extract <id>`, `--run <id> [-- <codemod args>]`, `--mark <ids...>` |
71
70
  | audit | `--list` |
72
- | forks | `--fork <name>`, `--keep-config` |
73
- | contributions | `--fork <name>`, `--json` |
71
+ | adopt | `--fork <name>`, `--json` |
74
72
  | stats | `--since <ref>`, `--md`, `-V, --verbose` |
75
73
  | style | `[paths...]` |
76
74
 
@@ -159,7 +157,7 @@ run. The audit takes three to four minutes on top of the testbed's start.
159
157
  | `pnpm cella a11y report --publish --draft` | The same while rows still need a person: the statement calls the results provisional |
160
158
  | `pnpm cella a11y decide --file decisions.json` | Record a reviewer's decisions (an agent's or a person's) with their evidence |
161
159
 
162
- The audit signs in as the seeded admin (`ADMIN_EMAIL` of `backend/.env`) with a minted session and signs it out when it
160
+ The audit signs in as the seeded admin (`ADMIN_EMAIL` of `.env`) with a minted session and signs it out when it
163
161
  ends. A visit that fails (a page that redirects, a check that cannot run) is reported, the command exits with an error,
164
162
  and the run writes `ledger-partial.json`: an incomplete run never replaces the ledger. The failed visit leaves
165
163
  `failure-<mode>.png` and `failure-<mode>.json` in the state's folder under `review/`: what the page showed, its
@@ -198,8 +196,8 @@ A short script can open one state of the scope, signed in, to check a fix: `open
198
196
 
199
197
  ## Screenshots
200
198
 
201
- `pnpm cella screenshots` shoots the app's marketing screenshots on a testbed, a light and a dark file each, over the
202
- files the app ships, and prints each file's pixel and byte size. Ids pick some shots (`pnpm cella screenshots settings`),
199
+ `pnpm cella shoot` shoots the app's marketing screenshots on a testbed, a light and a dark file each, over the
200
+ files the app ships, and prints each file's pixel and byte size. Ids pick some shots (`pnpm cella shoot settings`),
203
201
  `--out <dir>` writes a trial run elsewhere. An app with a `backend/scripts/seeds/showcase.json` is shot on a testbed seeded with that
204
202
  showcase, which no other tool writes to, as its admin; without one the testbed holds the app's seed, and the command turns
205
203
  MFA on for the shot user and a share of their members through the backend's `showcase:mfa` script where the app has it.
@@ -762,7 +760,7 @@ version an advisory claims. Most outcomes need no answer from you:
762
760
 
763
761
  `--list` prints the same report without prompts and writes nothing.
764
762
 
765
- ## Contributions (pull from forks)
763
+ ## Adopt from forks
766
764
 
767
765
  Upstream can pull modifications from local forks and selectively adopt them.
768
766
 
@@ -776,7 +774,7 @@ forks: [
776
774
 
777
775
  ### Pulling contributions
778
776
 
779
- Run `pnpm cella contributions` (or pick **contributions** from the menu). Select a fork; cella
777
+ Run `pnpm cella adopt` (or pick **adopt** from the menu). Select a fork; cella
780
778
  fetches its `pullBranch` and builds a clean local `contrib/<fork>` branch with only that fork's
781
779
  contributed files. Press `d` on a file to open its diff in your browser. Accepted files are
782
780
  checked out from the contrib branch and staged for review.
package/dist/bench.js CHANGED
@@ -1067,7 +1067,7 @@ import process6 from "process";
1067
1067
  // package.json
1068
1068
  var package_default = {
1069
1069
  name: "@cellajs/cli",
1070
- version: "0.6.6",
1070
+ version: "0.7.0",
1071
1071
  private: false,
1072
1072
  license: "MIT",
1073
1073
  description: "CLI for managing your monorepo and upgrading it with upstream Cella.",