@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.
Files changed (87) hide show
  1. package/dist/{build-XZGB4JPQ.js → build-IENNKWWC.js} +3 -3
  2. package/dist/{build-disk-YLQT3UHL.js → build-disk-M33Q6L22.js} +3 -3
  3. package/dist/build-info.json +1 -1
  4. package/dist/{builder-TS3QFXN4.js → builder-YNMSYR75.js} +2 -2
  5. package/dist/{caller-VHISEQAD.js → caller-2GU5V52U.js} +5 -5
  6. package/dist/{check-LUQM6DGK.js → check-JYGQOG3Y.js} +21 -21
  7. package/dist/{chunk-7EPIOSLO.js → chunk-2ANBJ7DB.js} +1 -1
  8. package/dist/{chunk-IVH7WDOO.js → chunk-2HODPJOF.js} +4 -4
  9. package/dist/{chunk-XTVVKNRP.js → chunk-2QW2PLWT.js} +2 -2
  10. package/dist/{chunk-NRTRPGCW.js → chunk-3DMCCCVM.js} +1 -1
  11. package/dist/{chunk-5UBNSGK3.js → chunk-3ONYQMGD.js} +2 -2
  12. package/dist/{chunk-GU25RNKD.js → chunk-46YRS7QS.js} +2 -2
  13. package/dist/{chunk-LHFG5YUG.js → chunk-4W7CPTKY.js} +2 -2
  14. package/dist/{chunk-IP7F4CQH.js → chunk-6GA5BJTH.js} +2 -2
  15. package/dist/{chunk-3GFZSLSP.js → chunk-6KHQGLNT.js} +2 -2
  16. package/dist/{chunk-LXYWSGEW.js → chunk-A67A5SWG.js} +1 -1
  17. package/dist/{chunk-XZ7NIGVA.js → chunk-A7D5BMII.js} +2 -2
  18. package/dist/{chunk-PDQWXH3F.js → chunk-CIEX2ZKQ.js} +3 -3
  19. package/dist/{chunk-JPROSTGX.js → chunk-CONA2WNE.js} +1 -1
  20. package/dist/{chunk-6O33JZ3X.js → chunk-DZDTSDHQ.js} +1 -1
  21. package/dist/{chunk-HDTFRHY6.js → chunk-EC3D3HMN.js} +5 -5
  22. package/dist/{chunk-SK7ZXQIV.js → chunk-H3TI7BQX.js} +64 -6
  23. package/dist/{chunk-RUK7QHSH.js → chunk-HGGR7Y3V.js} +1 -1
  24. package/dist/{chunk-6IJZL7X2.js → chunk-IM2DECLP.js} +2 -2
  25. package/dist/{chunk-ZJ4Y2BOI.js → chunk-K462MYDV.js} +5 -5
  26. package/dist/{chunk-4NMAJYYE.js → chunk-MDFOS4OM.js} +1 -1
  27. package/dist/{chunk-AHEIZCCA.js → chunk-MWMXC57F.js} +7 -7
  28. package/dist/{chunk-GQVOK4ZO.js → chunk-NWK55RMD.js} +14 -14
  29. package/dist/{chunk-453B2ZHX.js → chunk-OQLF3IGM.js} +2 -2
  30. package/dist/{chunk-MXWPLGO6.js → chunk-SQ6HDN7A.js} +33 -7
  31. package/dist/{chunk-NIZ7FXUX.js → chunk-SRT7IYXD.js} +11 -11
  32. package/dist/{chunk-H3S5LJI2.js → chunk-UFRRRF64.js} +2 -2
  33. package/dist/{chunk-IGHAPIKZ.js → chunk-UIKUH2UQ.js} +1 -1
  34. package/dist/{chunk-IVY3PD7P.js → chunk-VI6Z4EJZ.js} +2 -2
  35. package/dist/{chunk-T3SRWWPX.js → chunk-VIJWXQMT.js} +3 -3
  36. package/dist/{chunk-CVQ4YBBE.js → chunk-XH444QQE.js} +2 -2
  37. package/dist/{cli-I7ZLMEL6.js → cli-U4PDYOW4.js} +88 -88
  38. package/dist/{command-TDJDBIXU.js → command-4IRZZKI6.js} +17 -17
  39. package/dist/{config-FF3E73ZE.js → config-4HXUXX3M.js} +4 -4
  40. package/dist/{connect-cmd-IRJ3MBPY.js → connect-cmd-GLB2X7YA.js} +2 -2
  41. package/dist/{container-start-DNGL4XJ3.js → container-start-4ZGCCSVY.js} +18 -18
  42. package/dist/{context-show-cmd-YQEQ5B34.js → context-show-cmd-MKQAAR7R.js} +3 -3
  43. package/dist/{demo-voice-cmd-QFVATHAQ.js → demo-voice-cmd-SMR3QVZA.js} +7 -7
  44. package/dist/{dist-2SPMAD7Z.js → dist-Y3WSK7OZ.js} +1 -1
  45. package/dist/{docker-6QIZVYF3.js → docker-AFJABU7U.js} +2 -2
  46. package/dist/{doctor-LXVJQKME.js → doctor-K3PKBJF4.js} +18 -18
  47. package/dist/{emit-artifact-cmd-3YHOU4TI.js → emit-artifact-cmd-DGFH4MUK.js} +6 -6
  48. package/dist/{emit-criteria-cmd-NN52H53B.js → emit-criteria-cmd-B23VYUF6.js} +4 -4
  49. package/dist/{emit-demo-cmd-ZYMLB5R5.js → emit-demo-cmd-ELRNY5FA.js} +7 -7
  50. package/dist/{emit-finding-cmd-J5UZGNP4.js → emit-finding-cmd-DNFJEYQS.js} +4 -4
  51. package/dist/{emit-result-cmd-IWMACBFI.js → emit-result-cmd-OR5WTW4P.js} +5 -5
  52. package/dist/{emit-step-cmd-SRWFWEU7.js → emit-step-cmd-AAEBYW3L.js} +4 -4
  53. package/dist/{find-unit-EX5ETHGL.js → find-unit-4XKMNIE7.js} +6 -6
  54. package/dist/{findings-cmd-BWTLCXDR.js → findings-cmd-LTM62M3K.js} +4 -4
  55. package/dist/{governing-source-3LUGSBRW.js → governing-source-75MBT2IE.js} +5 -5
  56. package/dist/{host-checks-7NCEW7FR.js → host-checks-3M4UTGJO.js} +16 -16
  57. package/dist/index.js +1 -1
  58. package/dist/{init-AQJEIH57.js → init-BKGJ74XC.js} +16 -16
  59. package/dist/{init-U4AM3APJ.js → init-OZEWZN4C.js} +16 -16
  60. package/dist/{init-cmd-SP4YMVKT.js → init-cmd-4QB7ZBA2.js} +5 -5
  61. package/dist/{init-update-4IQPGOA6.js → init-update-3W2TOJQV.js} +2 -2
  62. package/dist/{loop-NKJRLAGI.js → loop-7RNVQCSE.js} +20 -20
  63. package/dist/{machine-VV4LYWZQ.js → machine-QZZ2BNAA.js} +16 -16
  64. package/dist/recorder.cjs +166 -55
  65. package/dist/{runner-env-LWKAYARL.js → runner-env-FK3SUT3Q.js} +6 -6
  66. package/dist/{runner-identity-WUAQLGRY.js → runner-identity-WYAGV6UQ.js} +2 -2
  67. package/dist/{runner-key-4JXOPPUJ.js → runner-key-NIGSMVQN.js} +16 -16
  68. package/dist/{session-sender-EINASB3R.js → session-sender-32UAV25N.js} +6 -6
  69. package/dist/{spec-cmd-6LT5JJKG.js → spec-cmd-TPRHZ3EV.js} +5 -5
  70. package/dist/{status-OADVUMST.js → status-GDB2DSON.js} +16 -16
  71. package/dist/{sync-cmd-Z6PU33GC.js → sync-cmd-AHXCXMVP.js} +5 -5
  72. package/dist/{update-steps-GRF3BQ5M.js → update-steps-42DOJYQO.js} +17 -17
  73. package/dist/{watch-XNBXSIEI.js → watch-4EDI4CTS.js} +5 -5
  74. package/dist/{work-claim-cmd-2OO73LEV.js → work-claim-cmd-GFRZBX2V.js} +8 -8
  75. package/dist/{work-cmd-YOWM4KZU.js → work-cmd-FLKJQWGQ.js} +4 -4
  76. package/dist/{work-comment-cmd-7AKCM2JN.js → work-comment-cmd-3HUIIEQD.js} +5 -5
  77. package/dist/{work-demo-cmd-DHJDR7BB.js → work-demo-cmd-FDPDTXG6.js} +4 -4
  78. package/dist/{work-logs-cmd-62PZKGUU.js → work-logs-cmd-PSB44DT5.js} +4 -4
  79. package/dist/{work-open-pr-cmd-DMDHGKEJ.js → work-open-pr-cmd-QJW5PNT2.js} +5 -5
  80. package/dist/{work-pr-cmd-QGAOPNLV.js → work-pr-cmd-HMGBUHGL.js} +4 -4
  81. package/dist/{work-proofs-cmd-UQPQF7CK.js → work-proofs-cmd-MLC67VFR.js} +5 -5
  82. package/dist/{work-proofs-record-SRL7DRXV.js → work-proofs-record-7YBR6HSK.js} +10 -10
  83. package/dist/{work-stop-cmd-NYPQKSHC.js → work-stop-cmd-YO7SBPNF.js} +4 -4
  84. package/package.json +1 -1
  85. package/skill-pack/maintained/outerlayer-build/references/agent-briefs.md +7 -3
  86. package/skill-pack/maintained/outerlayer-evidence/SKILL.md +19 -8
  87. 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. Show
88
- a CLI step with `demo.terminal()`. The recorder ships inside the CLI, so
89
- install nothing. The script, and the rules a reviewer holds it to, are in
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 and watch the demo. The command shows only
99
- the beats and cuts each stretch in which the screen does not move and nothing
100
- is said. It refuses a demo that still holds one over 2 s, a chapter id that is
101
- not recorded, or a line too long for its beat. A chapter whose checks all
102
- passed is bound to its criterion. A chapter with a failed check is stored
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("The member saves a variable named NPM token.", async () => {
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("After a reload, the list shows its name and no value.", async () => {
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. Its line says what happens,
52
- in the present tense, in one or two short sentences. Do not read
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
- - Point to the one element a line talks about on a busy page with
66
- `await demo.highlight(locator)`, such as a status in a long list. Highlight
67
- at most one element in a beat, and none where the element is plain to see.
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. The command exits 1 while the demo holds a frozen,
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.