@outerlayer/cli 0.36.0-next.20261101022001 → 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 (86) 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/{runner-env-LWKAYARL.js → runner-env-FK3SUT3Q.js} +6 -6
  65. package/dist/{runner-identity-WUAQLGRY.js → runner-identity-WYAGV6UQ.js} +2 -2
  66. package/dist/{runner-key-4JXOPPUJ.js → runner-key-NIGSMVQN.js} +16 -16
  67. package/dist/{session-sender-EINASB3R.js → session-sender-32UAV25N.js} +6 -6
  68. package/dist/{spec-cmd-6LT5JJKG.js → spec-cmd-TPRHZ3EV.js} +5 -5
  69. package/dist/{status-OADVUMST.js → status-GDB2DSON.js} +16 -16
  70. package/dist/{sync-cmd-Z6PU33GC.js → sync-cmd-AHXCXMVP.js} +5 -5
  71. package/dist/{update-steps-GRF3BQ5M.js → update-steps-42DOJYQO.js} +17 -17
  72. package/dist/{watch-XNBXSIEI.js → watch-4EDI4CTS.js} +5 -5
  73. package/dist/{work-claim-cmd-2OO73LEV.js → work-claim-cmd-GFRZBX2V.js} +8 -8
  74. package/dist/{work-cmd-YOWM4KZU.js → work-cmd-FLKJQWGQ.js} +4 -4
  75. package/dist/{work-comment-cmd-7AKCM2JN.js → work-comment-cmd-3HUIIEQD.js} +5 -5
  76. package/dist/{work-demo-cmd-DHJDR7BB.js → work-demo-cmd-FDPDTXG6.js} +4 -4
  77. package/dist/{work-logs-cmd-62PZKGUU.js → work-logs-cmd-PSB44DT5.js} +4 -4
  78. package/dist/{work-open-pr-cmd-DMDHGKEJ.js → work-open-pr-cmd-QJW5PNT2.js} +5 -5
  79. package/dist/{work-pr-cmd-QGAOPNLV.js → work-pr-cmd-HMGBUHGL.js} +4 -4
  80. package/dist/{work-proofs-cmd-UQPQF7CK.js → work-proofs-cmd-MLC67VFR.js} +5 -5
  81. package/dist/{work-proofs-record-SRL7DRXV.js → work-proofs-record-7YBR6HSK.js} +10 -10
  82. package/dist/{work-stop-cmd-NYPQKSHC.js → work-stop-cmd-YO7SBPNF.js} +4 -4
  83. package/package.json +1 -1
  84. package/skill-pack/maintained/outerlayer-build/references/agent-briefs.md +6 -4
  85. package/skill-pack/maintained/outerlayer-evidence/SKILL.md +18 -12
  86. package/skill-pack/maintained/outerlayer-evidence/references/demo.md +38 -6
@@ -1,9 +1,9 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- export { WorkCommandError, environmentFacts, findLiveItemForIssue, getJson, parsePositiveInt, patchJson, postJson, resolveCredentials, runWorkBuild, runWorkLinkSession, runWorkList, runWorkRemove, runWorkStatus } from './chunk-T3SRWWPX.js';
3
+ export { WorkCommandError, environmentFacts, findLiveItemForIssue, getJson, parsePositiveInt, patchJson, postJson, resolveCredentials, runWorkBuild, runWorkLinkSession, runWorkList, runWorkRemove, runWorkStatus } from './chunk-VIJWXQMT.js';
4
4
  import './chunk-IP7BIBXJ.js';
5
- import './chunk-LHFG5YUG.js';
6
- import './chunk-JPROSTGX.js';
5
+ import './chunk-4W7CPTKY.js';
6
+ import './chunk-CONA2WNE.js';
7
7
  import './chunk-5H57X7YC.js';
8
8
  import './chunk-A2LHHKTT.js';
9
9
  import './chunk-2AM6Z5BP.js';
@@ -14,7 +14,7 @@ import './chunk-HWVMRETT.js';
14
14
  import './chunk-4DJZSNVT.js';
15
15
  import './chunk-BJ3KTMDH.js';
16
16
  import './chunk-7O7LJWQO.js';
17
- import './chunk-MXWPLGO6.js';
17
+ import './chunk-SQ6HDN7A.js';
18
18
  import './chunk-OLM2TIOW.js';
19
19
  import './chunk-CDDED64E.js';
20
20
  import './chunk-RA3O54FC.js';
@@ -1,10 +1,10 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- export { WorkCommentCommandError, runWorkComment, runWorkCommentsRead, runWorkThreads } from './chunk-XZ7NIGVA.js';
4
- import './chunk-T3SRWWPX.js';
3
+ export { WorkCommentCommandError, runWorkComment, runWorkCommentsRead, runWorkThreads } from './chunk-A7D5BMII.js';
4
+ import './chunk-VIJWXQMT.js';
5
5
  import './chunk-IP7BIBXJ.js';
6
- import './chunk-LHFG5YUG.js';
7
- import './chunk-JPROSTGX.js';
6
+ import './chunk-4W7CPTKY.js';
7
+ import './chunk-CONA2WNE.js';
8
8
  import './chunk-5H57X7YC.js';
9
9
  import './chunk-A2LHHKTT.js';
10
10
  import './chunk-2AM6Z5BP.js';
@@ -18,7 +18,7 @@ import './chunk-545P7JY7.js';
18
18
  import './chunk-HCVLP7XA.js';
19
19
  import './chunk-BJ3KTMDH.js';
20
20
  import './chunk-7O7LJWQO.js';
21
- import './chunk-MXWPLGO6.js';
21
+ import './chunk-SQ6HDN7A.js';
22
22
  import './chunk-OLM2TIOW.js';
23
23
  import './chunk-CDDED64E.js';
24
24
  import './chunk-RA3O54FC.js';
@@ -1,10 +1,10 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
3
  import { readNewestDemo } from './chunk-ER6KQCVJ.js';
4
- import { resolveCredentials, WorkCommandError } from './chunk-T3SRWWPX.js';
4
+ import { resolveCredentials, WorkCommandError } from './chunk-VIJWXQMT.js';
5
5
  import './chunk-IP7BIBXJ.js';
6
- import './chunk-LHFG5YUG.js';
7
- import './chunk-JPROSTGX.js';
6
+ import './chunk-4W7CPTKY.js';
7
+ import './chunk-CONA2WNE.js';
8
8
  import './chunk-5H57X7YC.js';
9
9
  import './chunk-A2LHHKTT.js';
10
10
  import './chunk-2AM6Z5BP.js';
@@ -15,7 +15,7 @@ import './chunk-HWVMRETT.js';
15
15
  import './chunk-4DJZSNVT.js';
16
16
  import './chunk-BJ3KTMDH.js';
17
17
  import './chunk-7O7LJWQO.js';
18
- import './chunk-MXWPLGO6.js';
18
+ import './chunk-SQ6HDN7A.js';
19
19
  import './chunk-OLM2TIOW.js';
20
20
  import './chunk-CDDED64E.js';
21
21
  import './chunk-RA3O54FC.js';
@@ -1,9 +1,9 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- import { resolveCredentials, getJson } from './chunk-T3SRWWPX.js';
3
+ import { resolveCredentials, getJson } from './chunk-VIJWXQMT.js';
4
4
  import './chunk-IP7BIBXJ.js';
5
- import './chunk-LHFG5YUG.js';
6
- import './chunk-JPROSTGX.js';
5
+ import './chunk-4W7CPTKY.js';
6
+ import './chunk-CONA2WNE.js';
7
7
  import './chunk-5H57X7YC.js';
8
8
  import './chunk-A2LHHKTT.js';
9
9
  import './chunk-2AM6Z5BP.js';
@@ -14,7 +14,7 @@ import './chunk-HWVMRETT.js';
14
14
  import './chunk-4DJZSNVT.js';
15
15
  import './chunk-BJ3KTMDH.js';
16
16
  import './chunk-7O7LJWQO.js';
17
- import './chunk-MXWPLGO6.js';
17
+ import './chunk-SQ6HDN7A.js';
18
18
  import './chunk-OLM2TIOW.js';
19
19
  import './chunk-CDDED64E.js';
20
20
  import './chunk-RA3O54FC.js';
@@ -1,10 +1,10 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- import { itemLabel, runWorkPr, WorkPrCommandError } from './chunk-6IJZL7X2.js';
4
- import { resolveCredentials } from './chunk-T3SRWWPX.js';
3
+ import { itemLabel, runWorkPr, WorkPrCommandError } from './chunk-IM2DECLP.js';
4
+ import { resolveCredentials } from './chunk-VIJWXQMT.js';
5
5
  import './chunk-IP7BIBXJ.js';
6
- import './chunk-LHFG5YUG.js';
7
- import './chunk-JPROSTGX.js';
6
+ import './chunk-4W7CPTKY.js';
7
+ import './chunk-CONA2WNE.js';
8
8
  import './chunk-5H57X7YC.js';
9
9
  import './chunk-A2LHHKTT.js';
10
10
  import { C } from './chunk-2AM6Z5BP.js';
@@ -15,7 +15,7 @@ import './chunk-HWVMRETT.js';
15
15
  import './chunk-4DJZSNVT.js';
16
16
  import './chunk-BJ3KTMDH.js';
17
17
  import './chunk-7O7LJWQO.js';
18
- import './chunk-MXWPLGO6.js';
18
+ import './chunk-SQ6HDN7A.js';
19
19
  import './chunk-OLM2TIOW.js';
20
20
  import './chunk-CDDED64E.js';
21
21
  import './chunk-RA3O54FC.js';
@@ -1,9 +1,9 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- export { WorkPrCommandError, itemLabel, runWorkPr } from './chunk-6IJZL7X2.js';
3
+ export { WorkPrCommandError, itemLabel, runWorkPr } from './chunk-IM2DECLP.js';
4
4
  import './chunk-IP7BIBXJ.js';
5
- import './chunk-LHFG5YUG.js';
6
- import './chunk-JPROSTGX.js';
5
+ import './chunk-4W7CPTKY.js';
6
+ import './chunk-CONA2WNE.js';
7
7
  import './chunk-5H57X7YC.js';
8
8
  import './chunk-A2LHHKTT.js';
9
9
  import './chunk-2AM6Z5BP.js';
@@ -14,7 +14,7 @@ import './chunk-HWVMRETT.js';
14
14
  import './chunk-4DJZSNVT.js';
15
15
  import './chunk-BJ3KTMDH.js';
16
16
  import './chunk-7O7LJWQO.js';
17
- import './chunk-MXWPLGO6.js';
17
+ import './chunk-SQ6HDN7A.js';
18
18
  import './chunk-OLM2TIOW.js';
19
19
  import './chunk-CDDED64E.js';
20
20
  import './chunk-RA3O54FC.js';
@@ -1,11 +1,11 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- export { classifyProofs, classifyProofsAt, otherPullRequestHeads, resolveProofsItem, runWorkProofs, runWorkProofsCommand } from './chunk-ZJ4Y2BOI.js';
3
+ export { classifyProofs, classifyProofsAt, otherPullRequestHeads, resolveProofsItem, runWorkProofs, runWorkProofsCommand } from './chunk-K462MYDV.js';
4
4
  import './chunk-GDIVOYDA.js';
5
- import './chunk-T3SRWWPX.js';
5
+ import './chunk-VIJWXQMT.js';
6
6
  import './chunk-IP7BIBXJ.js';
7
- import './chunk-LHFG5YUG.js';
8
- import './chunk-JPROSTGX.js';
7
+ import './chunk-4W7CPTKY.js';
8
+ import './chunk-CONA2WNE.js';
9
9
  import './chunk-5H57X7YC.js';
10
10
  import './chunk-A2LHHKTT.js';
11
11
  import './chunk-2AM6Z5BP.js';
@@ -16,7 +16,7 @@ import './chunk-HWVMRETT.js';
16
16
  import './chunk-4DJZSNVT.js';
17
17
  import './chunk-BJ3KTMDH.js';
18
18
  import './chunk-7O7LJWQO.js';
19
- import './chunk-MXWPLGO6.js';
19
+ import './chunk-SQ6HDN7A.js';
20
20
  import './chunk-OLM2TIOW.js';
21
21
  import './chunk-CDDED64E.js';
22
22
  import './chunk-RA3O54FC.js';
@@ -1,20 +1,20 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- import { resolveProofsItem, ownPullRequest, otherPullRequestHeads, classifyProofsAt, runWorkProofs, proofsCommentId, kindProblem, proofsCommentBody } from './chunk-ZJ4Y2BOI.js';
4
- import { runWorkComment } from './chunk-XZ7NIGVA.js';
5
- import { runEmitDemo } from './chunk-SK7ZXQIV.js';
3
+ import { resolveProofsItem, ownPullRequest, otherPullRequestHeads, classifyProofsAt, runWorkProofs, proofsCommentId, kindProblem, proofsCommentBody } from './chunk-K462MYDV.js';
4
+ import { runWorkComment } from './chunk-A7D5BMII.js';
5
+ import { runEmitDemo } from './chunk-H3TI7BQX.js';
6
6
  import { readNewestDemo } from './chunk-ER6KQCVJ.js';
7
- import { runEmitArtifact } from './chunk-PDQWXH3F.js';
7
+ import { runEmitArtifact } from './chunk-CIEX2ZKQ.js';
8
8
  import { runnerMatcher } from './chunk-GDIVOYDA.js';
9
9
  import './chunk-2PGI6RDE.js';
10
- import { runSync } from './chunk-XTVVKNRP.js';
11
- import './chunk-3GFZSLSP.js';
10
+ import { runSync } from './chunk-2QW2PLWT.js';
11
+ import './chunk-6KHQGLNT.js';
12
12
  import './chunk-AAGU5FJF.js';
13
13
  import './chunk-OUPQTA7N.js';
14
- import { WorkCommandError, resolveCredentials, getJson } from './chunk-T3SRWWPX.js';
14
+ import { WorkCommandError, resolveCredentials, getJson } from './chunk-VIJWXQMT.js';
15
15
  import './chunk-IP7BIBXJ.js';
16
- import './chunk-LHFG5YUG.js';
17
- import './chunk-JPROSTGX.js';
16
+ import './chunk-4W7CPTKY.js';
17
+ import './chunk-CONA2WNE.js';
18
18
  import './chunk-5H57X7YC.js';
19
19
  import './chunk-A2LHHKTT.js';
20
20
  import './chunk-2AM6Z5BP.js';
@@ -30,7 +30,7 @@ import './chunk-BKO6JEZI.js';
30
30
  import './chunk-HCVLP7XA.js';
31
31
  import './chunk-BJ3KTMDH.js';
32
32
  import './chunk-7O7LJWQO.js';
33
- import { resolveRepoIdentity } from './chunk-MXWPLGO6.js';
33
+ import { resolveRepoIdentity } from './chunk-SQ6HDN7A.js';
34
34
  import './chunk-OLM2TIOW.js';
35
35
  import './chunk-CDDED64E.js';
36
36
  import './chunk-RA3O54FC.js';
@@ -1,9 +1,9 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- import { resolveCredentials, postJson, WorkCommandError } from './chunk-T3SRWWPX.js';
3
+ import { resolveCredentials, postJson, WorkCommandError } from './chunk-VIJWXQMT.js';
4
4
  import './chunk-IP7BIBXJ.js';
5
- import './chunk-LHFG5YUG.js';
6
- import './chunk-JPROSTGX.js';
5
+ import './chunk-4W7CPTKY.js';
6
+ import './chunk-CONA2WNE.js';
7
7
  import './chunk-5H57X7YC.js';
8
8
  import './chunk-A2LHHKTT.js';
9
9
  import './chunk-2AM6Z5BP.js';
@@ -14,7 +14,7 @@ import './chunk-HWVMRETT.js';
14
14
  import './chunk-4DJZSNVT.js';
15
15
  import './chunk-BJ3KTMDH.js';
16
16
  import './chunk-7O7LJWQO.js';
17
- import './chunk-MXWPLGO6.js';
17
+ import './chunk-SQ6HDN7A.js';
18
18
  import './chunk-OLM2TIOW.js';
19
19
  import './chunk-CDDED64E.js';
20
20
  import './chunk-RA3O54FC.js';
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@outerlayer/cli",
3
- "version": "0.36.0-next.20261101022001",
3
+ "version": "0.36.0-next.20261101112952",
4
4
  "description": "OuterLayer CLI — commands: init, claude, connect, doctor, login, logout, sync, daemon (alias: watch), emit, demo, findings, work, spec, runner, hooks, mcp, context. Capture and sync coding-agent sessions, and record proof of factory work.",
5
5
  "license": "Apache-2.0",
6
6
  "author": "Magu Studios, Inc.",
@@ -295,10 +295,12 @@ tests at HEAD that hold the id of each proof that is not current, and runs them.
295
295
  "Record a demo" says. Tell each chapter in beats with `demo.say()`: sign in
296
296
  once, and seed and wait between beats, so the demo shows only narrated
297
297
  steps. In each beat, check with `expect(locator)` the element its line
298
- names, so the recorder rings it. Render it with `outerlayer emit demo
299
- <manifest> --output demo.webm` and watch it before you commit the test:
300
- each beat rings what its line names. The fixture writes the manifest
301
- where `OUTERLAYER_PROOF_OUT` names.
298
+ names, so the recorder rings it. Write each line as you would say it to a
299
+ teammate at your screen, in plain words. Render it with `outerlayer emit
300
+ demo <manifest> --output demo.webm`, then watch and listen to it before
301
+ you commit the test. Each beat rings what its line names. Write again each
302
+ line that sounds read off a spec or like an advert. The fixture writes the
303
+ manifest where `OUTERLAYER_PROOF_OUT` names.
302
304
  - A report, log or file proof is a test, in any language, that writes
303
305
  `$OUTERLAYER_PROOF_OUT/<criterion id>.<ext>`. The kind of the file must be the
304
306
  kind the criterion declares. The test writes outside the repository, so there is
@@ -85,26 +85,32 @@ only when Playwright cannot drive the flow.
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
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: the
89
- recorder dims the page around each element a beat checks and rings it, so
90
- the viewer sees what the line talks about. Show a CLI step with
91
- `demo.terminal()`. The recorder ships inside the CLI, so
92
- install nothing. The script, and the rules a reviewer holds it to, are 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
93
91
  [references/demo.md](references/demo.md).
94
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
+
95
102
  Commit the script, named `*.demo.ts`: `work proofs --record` finds it by its
96
103
  chapter ids. Record it, then emit the demo:
97
104
 
98
105
  outerlayer demo record e2e/<name>.demo.ts --config <playwright config> --project <name>
99
106
  outerlayer emit demo <the manifest it prints>
100
107
 
101
- Pass `--output demo.webm` first and watch the demo. Each beat rings what its
102
- line names. Where a ring is missing or marks the wrong part, check the
103
- element the line names in that beat. The command shows only
104
- the beats and cuts each stretch in which the screen does not move and nothing
105
- is said. It refuses a demo that still holds one over 2 s, a chapter id that is
106
- not recorded, or a line too long for its beat. A chapter whose checks all
107
- 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
108
114
  unbound, and the command exits 1: fix the app and record again. It needs
109
115
  `ffmpeg` and `espeak-ng`. A runner build has both.
110
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
  });
@@ -41,6 +48,31 @@ own Playwright config, add `--config <file>` and `--project <name>` to reuse
41
48
  its setup and sign-in. Without one, add `--base-url <url>`. The command
42
49
  prints the manifest's path.
43
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
+
44
76
  ## Rules
45
77
 
46
78
  - One chapter for each criterion that declares `video` or `screenshot`, in
@@ -51,9 +83,8 @@ prints the manifest's path.
51
83
  - Change state between beats: through the app where a screen exists, or
52
84
  directly where none does. The demo leaves it out, so a long wait costs
53
85
  nothing.
54
- - One beat for each step a viewer should see. Its line says what happens,
55
- in the present tense, in one or two short sentences. Do not read
56
- criterion ids aloud.
86
+ - One beat for each step a viewer should see. Write its line as "Write
87
+ the lines" says.
57
88
  - Inside a beat, move between pages through the app's own links. Reload a
58
89
  list between beats.
59
90
  - Put each `expect` that proves the criterion inside a beat: it is a check.
@@ -85,5 +116,6 @@ prints the manifest's path.
85
116
  Render the demo with `outerlayer emit demo <manifest> --output demo.webm`
86
117
  and watch it. Fix a beat that shows a loading screen, a sign-in or a step
87
118
  its line does not name. Fix a beat whose ring is missing, or marks a part
88
- its line does not name. The command exits 1 while the demo holds a frozen,
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,
89
121
  silent stretch over 2 s.