@outerlayer/cli 0.36.0-next.20261031231928 → 0.36.0-next.20261101112952
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/dist/{build-XZGB4JPQ.js → build-IENNKWWC.js} +3 -3
- package/dist/{build-disk-YLQT3UHL.js → build-disk-M33Q6L22.js} +3 -3
- package/dist/build-info.json +1 -1
- package/dist/{builder-TS3QFXN4.js → builder-YNMSYR75.js} +2 -2
- package/dist/{caller-VHISEQAD.js → caller-2GU5V52U.js} +5 -5
- package/dist/{check-LUQM6DGK.js → check-JYGQOG3Y.js} +21 -21
- package/dist/{chunk-7EPIOSLO.js → chunk-2ANBJ7DB.js} +1 -1
- package/dist/{chunk-IVH7WDOO.js → chunk-2HODPJOF.js} +4 -4
- package/dist/{chunk-XTVVKNRP.js → chunk-2QW2PLWT.js} +2 -2
- package/dist/{chunk-NRTRPGCW.js → chunk-3DMCCCVM.js} +1 -1
- package/dist/{chunk-5UBNSGK3.js → chunk-3ONYQMGD.js} +2 -2
- package/dist/{chunk-GU25RNKD.js → chunk-46YRS7QS.js} +2 -2
- package/dist/{chunk-LHFG5YUG.js → chunk-4W7CPTKY.js} +2 -2
- package/dist/{chunk-IP7F4CQH.js → chunk-6GA5BJTH.js} +2 -2
- package/dist/{chunk-3GFZSLSP.js → chunk-6KHQGLNT.js} +2 -2
- package/dist/{chunk-LXYWSGEW.js → chunk-A67A5SWG.js} +1 -1
- package/dist/{chunk-XZ7NIGVA.js → chunk-A7D5BMII.js} +2 -2
- package/dist/{chunk-PDQWXH3F.js → chunk-CIEX2ZKQ.js} +3 -3
- package/dist/{chunk-JPROSTGX.js → chunk-CONA2WNE.js} +1 -1
- package/dist/{chunk-6O33JZ3X.js → chunk-DZDTSDHQ.js} +1 -1
- package/dist/{chunk-HDTFRHY6.js → chunk-EC3D3HMN.js} +5 -5
- package/dist/{chunk-SK7ZXQIV.js → chunk-H3TI7BQX.js} +64 -6
- package/dist/{chunk-RUK7QHSH.js → chunk-HGGR7Y3V.js} +1 -1
- package/dist/{chunk-6IJZL7X2.js → chunk-IM2DECLP.js} +2 -2
- package/dist/{chunk-ZJ4Y2BOI.js → chunk-K462MYDV.js} +5 -5
- package/dist/{chunk-4NMAJYYE.js → chunk-MDFOS4OM.js} +1 -1
- package/dist/{chunk-AHEIZCCA.js → chunk-MWMXC57F.js} +7 -7
- package/dist/{chunk-GQVOK4ZO.js → chunk-NWK55RMD.js} +14 -14
- package/dist/{chunk-453B2ZHX.js → chunk-OQLF3IGM.js} +2 -2
- package/dist/{chunk-MXWPLGO6.js → chunk-SQ6HDN7A.js} +33 -7
- package/dist/{chunk-NIZ7FXUX.js → chunk-SRT7IYXD.js} +11 -11
- package/dist/{chunk-H3S5LJI2.js → chunk-UFRRRF64.js} +2 -2
- package/dist/{chunk-IGHAPIKZ.js → chunk-UIKUH2UQ.js} +1 -1
- package/dist/{chunk-IVY3PD7P.js → chunk-VI6Z4EJZ.js} +2 -2
- package/dist/{chunk-T3SRWWPX.js → chunk-VIJWXQMT.js} +3 -3
- package/dist/{chunk-CVQ4YBBE.js → chunk-XH444QQE.js} +2 -2
- package/dist/{cli-I7ZLMEL6.js → cli-U4PDYOW4.js} +88 -88
- package/dist/{command-TDJDBIXU.js → command-4IRZZKI6.js} +17 -17
- package/dist/{config-FF3E73ZE.js → config-4HXUXX3M.js} +4 -4
- package/dist/{connect-cmd-IRJ3MBPY.js → connect-cmd-GLB2X7YA.js} +2 -2
- package/dist/{container-start-DNGL4XJ3.js → container-start-4ZGCCSVY.js} +18 -18
- package/dist/{context-show-cmd-YQEQ5B34.js → context-show-cmd-MKQAAR7R.js} +3 -3
- package/dist/{demo-voice-cmd-QFVATHAQ.js → demo-voice-cmd-SMR3QVZA.js} +7 -7
- package/dist/{dist-2SPMAD7Z.js → dist-Y3WSK7OZ.js} +1 -1
- package/dist/{docker-6QIZVYF3.js → docker-AFJABU7U.js} +2 -2
- package/dist/{doctor-LXVJQKME.js → doctor-K3PKBJF4.js} +18 -18
- package/dist/{emit-artifact-cmd-3YHOU4TI.js → emit-artifact-cmd-DGFH4MUK.js} +6 -6
- package/dist/{emit-criteria-cmd-NN52H53B.js → emit-criteria-cmd-B23VYUF6.js} +4 -4
- package/dist/{emit-demo-cmd-ZYMLB5R5.js → emit-demo-cmd-ELRNY5FA.js} +7 -7
- package/dist/{emit-finding-cmd-J5UZGNP4.js → emit-finding-cmd-DNFJEYQS.js} +4 -4
- package/dist/{emit-result-cmd-IWMACBFI.js → emit-result-cmd-OR5WTW4P.js} +5 -5
- package/dist/{emit-step-cmd-SRWFWEU7.js → emit-step-cmd-AAEBYW3L.js} +4 -4
- package/dist/{find-unit-EX5ETHGL.js → find-unit-4XKMNIE7.js} +6 -6
- package/dist/{findings-cmd-BWTLCXDR.js → findings-cmd-LTM62M3K.js} +4 -4
- package/dist/{governing-source-3LUGSBRW.js → governing-source-75MBT2IE.js} +5 -5
- package/dist/{host-checks-7NCEW7FR.js → host-checks-3M4UTGJO.js} +16 -16
- package/dist/index.js +1 -1
- package/dist/{init-AQJEIH57.js → init-BKGJ74XC.js} +16 -16
- package/dist/{init-U4AM3APJ.js → init-OZEWZN4C.js} +16 -16
- package/dist/{init-cmd-SP4YMVKT.js → init-cmd-4QB7ZBA2.js} +5 -5
- package/dist/{init-update-4IQPGOA6.js → init-update-3W2TOJQV.js} +2 -2
- package/dist/{loop-NKJRLAGI.js → loop-7RNVQCSE.js} +20 -20
- package/dist/{machine-VV4LYWZQ.js → machine-QZZ2BNAA.js} +16 -16
- package/dist/recorder.cjs +166 -55
- package/dist/{runner-env-LWKAYARL.js → runner-env-FK3SUT3Q.js} +6 -6
- package/dist/{runner-identity-WUAQLGRY.js → runner-identity-WYAGV6UQ.js} +2 -2
- package/dist/{runner-key-4JXOPPUJ.js → runner-key-NIGSMVQN.js} +16 -16
- package/dist/{session-sender-EINASB3R.js → session-sender-32UAV25N.js} +6 -6
- package/dist/{spec-cmd-6LT5JJKG.js → spec-cmd-TPRHZ3EV.js} +5 -5
- package/dist/{status-OADVUMST.js → status-GDB2DSON.js} +16 -16
- package/dist/{sync-cmd-Z6PU33GC.js → sync-cmd-AHXCXMVP.js} +5 -5
- package/dist/{update-steps-GRF3BQ5M.js → update-steps-42DOJYQO.js} +17 -17
- package/dist/{watch-XNBXSIEI.js → watch-4EDI4CTS.js} +5 -5
- package/dist/{work-claim-cmd-2OO73LEV.js → work-claim-cmd-GFRZBX2V.js} +8 -8
- package/dist/{work-cmd-YOWM4KZU.js → work-cmd-FLKJQWGQ.js} +4 -4
- package/dist/{work-comment-cmd-7AKCM2JN.js → work-comment-cmd-3HUIIEQD.js} +5 -5
- package/dist/{work-demo-cmd-DHJDR7BB.js → work-demo-cmd-FDPDTXG6.js} +4 -4
- package/dist/{work-logs-cmd-62PZKGUU.js → work-logs-cmd-PSB44DT5.js} +4 -4
- package/dist/{work-open-pr-cmd-DMDHGKEJ.js → work-open-pr-cmd-QJW5PNT2.js} +5 -5
- package/dist/{work-pr-cmd-QGAOPNLV.js → work-pr-cmd-HMGBUHGL.js} +4 -4
- package/dist/{work-proofs-cmd-UQPQF7CK.js → work-proofs-cmd-MLC67VFR.js} +5 -5
- package/dist/{work-proofs-record-SRL7DRXV.js → work-proofs-record-7YBR6HSK.js} +10 -10
- package/dist/{work-stop-cmd-NYPQKSHC.js → work-stop-cmd-YO7SBPNF.js} +4 -4
- package/package.json +1 -1
- package/skill-pack/maintained/outerlayer-build/references/agent-briefs.md +7 -3
- package/skill-pack/maintained/outerlayer-evidence/SKILL.md +19 -8
- package/skill-pack/maintained/outerlayer-evidence/references/demo.md +55 -10
|
@@ -84,22 +84,33 @@ only when Playwright cannot drive the flow.
|
|
|
84
84
|
|
|
85
85
|
A demo plays like a person showing the app. Tell each chapter in beats with
|
|
86
86
|
`demo.say(line, steps)`: the line is spoken while its steps run on screen.
|
|
87
|
-
The demo shows only beats, so sign in, seed data and wait outside them.
|
|
88
|
-
|
|
89
|
-
|
|
87
|
+
The demo shows only beats, so sign in, seed data and wait outside them. In
|
|
88
|
+
each beat, check with `expect(locator)` the element its line names, so the
|
|
89
|
+
recorder rings it. Show a CLI step with `demo.terminal()`. The recorder
|
|
90
|
+
ships inside the CLI, so install nothing. The script, and the rules a reviewer holds it to, are in
|
|
90
91
|
[references/demo.md](references/demo.md).
|
|
91
92
|
|
|
93
|
+
A person hears each line, so it never reads a criterion back. Say what the
|
|
94
|
+
viewer notices and why it matters, as you would to a teammate at your
|
|
95
|
+
screen. Use "you" and contractions, and plain words. Not "The label is in
|
|
96
|
+
monospace on the light shade of its color", but "Each status gets its own
|
|
97
|
+
color now, so you can tell at a glance whose turn it is." When the script
|
|
98
|
+
is done, list its lines, read each aloud, and write again every one that
|
|
99
|
+
sounds like a test assertion or an advert. Its "Write the lines" section
|
|
100
|
+
has more pairs.
|
|
101
|
+
|
|
92
102
|
Commit the script, named `*.demo.ts`: `work proofs --record` finds it by its
|
|
93
103
|
chapter ids. Record it, then emit the demo:
|
|
94
104
|
|
|
95
105
|
outerlayer demo record e2e/<name>.demo.ts --config <playwright config> --project <name>
|
|
96
106
|
outerlayer emit demo <the manifest it prints>
|
|
97
107
|
|
|
98
|
-
Pass `--output demo.webm` first
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
108
|
+
Pass `--output demo.webm` first, then watch and listen to the demo. Where
|
|
109
|
+
a beat's ring is missing or wrong, check the element its line names. The
|
|
110
|
+
command shows only the beats, and cuts each frozen, silent stretch. It
|
|
111
|
+
refuses a demo that still holds one over 2 s, a chapter id that is
|
|
112
|
+
not recorded, a line too long for its beat, or a line that sells. A
|
|
113
|
+
chapter whose checks all passed is bound to its criterion. A chapter with a failed check is stored
|
|
103
114
|
unbound, and the command exits 1: fix the app and record again. It needs
|
|
104
115
|
`ffmpeg` and `espeak-ng`. A runner build has both.
|
|
105
116
|
|
|
@@ -4,6 +4,13 @@ A demo is a reviewer's first look at the change. It plays like a person
|
|
|
4
4
|
showing the app: each step happens on screen while a line says what it is.
|
|
5
5
|
Setup, sign-ins and waits never reach the video.
|
|
6
6
|
|
|
7
|
+
## Contents
|
|
8
|
+
|
|
9
|
+
- The script
|
|
10
|
+
- Write the lines
|
|
11
|
+
- Rules
|
|
12
|
+
- Before you emit
|
|
13
|
+
|
|
7
14
|
## The script
|
|
8
15
|
|
|
9
16
|
The recorder ships inside the CLI. Install nothing. Name the script
|
|
@@ -17,13 +24,13 @@ it against the app as it is now, not from an older demo. Import `test` and
|
|
|
17
24
|
await signIn(page); // setup: outside every beat
|
|
18
25
|
await page.goto("/settings");
|
|
19
26
|
await demo.chapter("AC-7-02", "Save a variable", async () => {
|
|
20
|
-
await demo.say("
|
|
27
|
+
await demo.say("Here's the settings page. We'll save a variable called NPM token.", async () => {
|
|
21
28
|
await page.getByLabel("Name").fill("NPM_TOKEN");
|
|
22
29
|
await page.getByRole("button", { name: "Save" }).click();
|
|
23
30
|
await expect(page.getByText("The variable is saved")).toBeVisible();
|
|
24
31
|
});
|
|
25
32
|
await page.reload(); // setup: the demo cuts it
|
|
26
|
-
await demo.say("
|
|
33
|
+
await demo.say("Reload, and the list shows the name but never the value.", async () => {
|
|
27
34
|
await expect(page.getByText("NPM_TOKEN")).toBeVisible();
|
|
28
35
|
await demo.screenshot();
|
|
29
36
|
});
|
|
@@ -31,13 +38,41 @@ it against the app as it is now, not from an older demo. Import `test` and
|
|
|
31
38
|
});
|
|
32
39
|
|
|
33
40
|
Each beat lasts as long as its line. Inside a beat a pointer moves to each
|
|
34
|
-
click, `fill` types its text, and the page scrolls smoothly.
|
|
41
|
+
click, `fill` types its text, and the page scrolls smoothly. Each `expect` on
|
|
42
|
+
a locator dims the page around the element it checks and rings it, so the
|
|
43
|
+
viewer sees what the line talks about. A second check in the beat widens the
|
|
44
|
+
ring to take in both elements.
|
|
35
45
|
|
|
36
46
|
Record it with `outerlayer demo record <script>`. In a repository with its
|
|
37
47
|
own Playwright config, add `--config <file>` and `--project <name>` to reuse
|
|
38
48
|
its setup and sign-in. Without one, add `--base-url <url>`. The command
|
|
39
49
|
prints the manifest's path.
|
|
40
50
|
|
|
51
|
+
## Write the lines
|
|
52
|
+
|
|
53
|
+
Each line is spoken to someone who watches the demo. Write it as you would
|
|
54
|
+
say it to a teammate at your screen.
|
|
55
|
+
|
|
56
|
+
- Say what the viewer sees change, and why it matters to them. Leave out
|
|
57
|
+
the CSS: the viewer sees a grey number, not "the secondary text color".
|
|
58
|
+
- Name each thing by its label on the screen.
|
|
59
|
+
- Talk to the viewer. "You", "we", "here" and contractions such as "it's"
|
|
60
|
+
are fine.
|
|
61
|
+
- Say each step once, in one or two short sentences.
|
|
62
|
+
- Say it calmly. Do not sell. `emit demo` refuses a line with a word such
|
|
63
|
+
as "seamless", "powerful" or "effortless", a phrase such as "dive in" or
|
|
64
|
+
"not just … but", a dash, an exclamation mark, a criterion id, or more
|
|
65
|
+
than 30 words.
|
|
66
|
+
- Read each line aloud before you commit it. Write it again if it sounds
|
|
67
|
+
like a test assertion or an advert.
|
|
68
|
+
|
|
69
|
+
| A line read off a spec | A line a person says |
|
|
70
|
+
| --- | --- |
|
|
71
|
+
| Eight stats sit in one bordered strip with sentence-case labels. | All eight numbers now sit together in one strip. |
|
|
72
|
+
| Zero follow-ups and zero denials show in the secondary text color. | When there's nothing to report, the number goes grey. |
|
|
73
|
+
| The visitor selects the Back to top link. | Click Back to top, and you're at the start again. |
|
|
74
|
+
| The picker offers acme app and acme web with neither selected. The button does not work yet. | You pick the repository first. Until you do, you can't file. |
|
|
75
|
+
|
|
41
76
|
## Rules
|
|
42
77
|
|
|
43
78
|
- One chapter for each criterion that declares `video` or `screenshot`, in
|
|
@@ -48,9 +83,8 @@ prints the manifest's path.
|
|
|
48
83
|
- Change state between beats: through the app where a screen exists, or
|
|
49
84
|
directly where none does. The demo leaves it out, so a long wait costs
|
|
50
85
|
nothing.
|
|
51
|
-
- One beat for each step a viewer should see.
|
|
52
|
-
|
|
53
|
-
criterion ids aloud.
|
|
86
|
+
- One beat for each step a viewer should see. Write its line as "Write
|
|
87
|
+
the lines" says.
|
|
54
88
|
- Inside a beat, move between pages through the app's own links. Reload a
|
|
55
89
|
list between beats.
|
|
56
90
|
- Put each `expect` that proves the criterion inside a beat: it is a check.
|
|
@@ -62,9 +96,18 @@ prints the manifest's path.
|
|
|
62
96
|
- Show a call to an API with `await demo.http({ method, url, body }, run)`
|
|
63
97
|
when a criterion's proof is an API response, or a step goes through the
|
|
64
98
|
API and no page shows it. Return the real `{ status, body }` from `run`.
|
|
65
|
-
-
|
|
66
|
-
|
|
67
|
-
|
|
99
|
+
- In each beat, check with `expect(locator)` each element its line names,
|
|
100
|
+
such as the new status in a list. The ring covers every element the beat
|
|
101
|
+
checks. A check of a computed value, such as a style read with
|
|
102
|
+
`evaluate`, rings nothing, so check the element itself too. A locator that
|
|
103
|
+
matches several elements, a negated check, and an element that fills most
|
|
104
|
+
of the screen ring nothing. When the box around all the checked elements
|
|
105
|
+
would fill most of the screen, the ring starts again on the latest one.
|
|
106
|
+
The pointer moving to an element outside the ring clears it.
|
|
107
|
+
- Call `await demo.highlight(locator)` to ring an element no check looks at.
|
|
108
|
+
After it, checks in that beat leave the ring in place.
|
|
109
|
+
- Write the script against the guidance here, not by copying an older demo:
|
|
110
|
+
an older demo can break a rule that came later.
|
|
68
111
|
- Turn off `demoOptions.animations` to keep the app's own transitions. Each
|
|
69
112
|
still and screenshot stops motion either way.
|
|
70
113
|
|
|
@@ -72,5 +115,7 @@ prints the manifest's path.
|
|
|
72
115
|
|
|
73
116
|
Render the demo with `outerlayer emit demo <manifest> --output demo.webm`
|
|
74
117
|
and watch it. Fix a beat that shows a loading screen, a sign-in or a step
|
|
75
|
-
its line does not name.
|
|
118
|
+
its line does not name. Fix a beat whose ring is missing, or marks a part
|
|
119
|
+
its line does not name. Listen to every line, and write again one that
|
|
120
|
+
sounds read off a spec. The command exits 1 while the demo holds a frozen,
|
|
76
121
|
silent stretch over 2 s.
|