@outerlayer/cli 0.34.0 → 0.34.1-next.20261029191024

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 (116) hide show
  1. package/README.md +1 -1
  2. package/dist/{agent-setup-UPIHHKI2.js → agent-setup-G445QZEM.js} +10 -10
  3. package/dist/{artifact-link-cmd-6LFCTDBD.js → artifact-link-cmd-H3KVDGP3.js} +2 -2
  4. package/dist/{build-WC5EBFL3.js → build-26BBPGWD.js} +4 -4
  5. package/dist/{build-disk-RARJJXLL.js → build-disk-UGIMTVLM.js} +4 -4
  6. package/dist/build-info.json +1 -1
  7. package/dist/{builder-IIFXZVGN.js → builder-LYFK7SKW.js} +3 -3
  8. package/dist/{caller-VWXDLYPU.js → caller-YGK3NKQQ.js} +6 -6
  9. package/dist/{check-FYYNT3UP.js → check-A6QEWYRN.js} +35 -35
  10. package/dist/{chunk-5DVJQC76.js → chunk-23DAYPF5.js} +4 -4
  11. package/dist/{chunk-5FWBAM6O.js → chunk-2PMJ7TQR.js} +1 -1
  12. package/dist/{chunk-2MTBQRCI.js → chunk-2WXFXI36.js} +6 -6
  13. package/dist/{chunk-IP3HLHWO.js → chunk-5ESKQSQP.js} +1 -1
  14. package/dist/{chunk-FYVIHKCH.js → chunk-6IIP4KMY.js} +3 -3
  15. package/dist/{chunk-ZI2E4YMY.js → chunk-6YK3SXCW.js} +1 -1
  16. package/dist/{chunk-AYMOVIT2.js → chunk-A6QFXRUU.js} +14 -14
  17. package/dist/{chunk-QM3HMXMU.js → chunk-AW4MYEIW.js} +1 -1
  18. package/dist/{chunk-PQ5YDDDE.js → chunk-AWNONB6E.js} +2 -2
  19. package/dist/{chunk-AZLWIUIF.js → chunk-BITJMQJ2.js} +3 -3
  20. package/dist/{chunk-JBUFM5JN.js → chunk-BMMSKKVA.js} +2 -2
  21. package/dist/{chunk-CZA37XBG.js → chunk-CANPD2V3.js} +5 -5
  22. package/dist/{chunk-3NPVOVWY.js → chunk-CPWSPEP5.js} +2 -2
  23. package/dist/{chunk-DVXUUCOF.js → chunk-CQQWIWYG.js} +1 -1
  24. package/dist/{chunk-32IASBQV.js → chunk-E3R62JBJ.js} +4 -4
  25. package/dist/{chunk-25SWTFPA.js → chunk-EBFU4YCI.js} +4 -4
  26. package/dist/{chunk-2OE4BZRF.js → chunk-EK7MQ56V.js} +3 -3
  27. package/dist/{chunk-UX7BQX4C.js → chunk-F7CYWR7J.js} +17 -17
  28. package/dist/{chunk-JXXMOAJG.js → chunk-GWXHRG2N.js} +1 -1
  29. package/dist/{chunk-DY2HAYJL.js → chunk-HJS267VR.js} +19 -5
  30. package/dist/{chunk-SVDO6ZQA.js → chunk-HJSNFVKX.js} +8 -8
  31. package/dist/{chunk-M4MSA6I4.js → chunk-HTJR62XR.js} +1 -1
  32. package/dist/{chunk-4CGEAKOR.js → chunk-HXCUMPPY.js} +3 -3
  33. package/dist/{chunk-NB44HOTO.js → chunk-I4TEZU2E.js} +2 -2
  34. package/dist/{chunk-QZQ2UTPE.js → chunk-L5GF2A43.js} +2 -2
  35. package/dist/{chunk-UPRZREBO.js → chunk-MGF4254K.js} +1 -1
  36. package/dist/{chunk-NZDM6KJ2.js → chunk-MTUV27NY.js} +5 -5
  37. package/dist/{chunk-YTTESG7K.js → chunk-N2XW4NYY.js} +5 -1
  38. package/dist/{chunk-7NARODRP.js → chunk-NFBWTJ3A.js} +1 -1
  39. package/dist/{chunk-H25XK3DY.js → chunk-PBAGWT2M.js} +1 -1
  40. package/dist/{chunk-CDVG2LXT.js → chunk-PILW3YP4.js} +7 -7
  41. package/dist/{chunk-WG3VIMD2.js → chunk-POZ65DAI.js} +6 -6
  42. package/dist/{chunk-HS5QEIJT.js → chunk-PPZ47OB6.js} +2 -2
  43. package/dist/{chunk-WJTIU2A5.js → chunk-Q7ZHL6FY.js} +4 -4
  44. package/dist/{chunk-HNA33MLR.js → chunk-QJCXP4TA.js} +2 -2
  45. package/dist/{chunk-H467HI5U.js → chunk-QRDF5A3U.js} +2 -2
  46. package/dist/{chunk-TJ755TTP.js → chunk-RO2XIOEN.js} +5 -5
  47. package/dist/{chunk-PUSCE544.js → chunk-SUVS7A7X.js} +4 -4
  48. package/dist/{chunk-62TMOXQN.js → chunk-TMFKZBOW.js} +2 -2
  49. package/dist/{chunk-RWQLBHU3.js → chunk-TYRKGKMX.js} +4 -4
  50. package/dist/{chunk-PHETCXGP.js → chunk-UJTYMT7G.js} +1 -1
  51. package/dist/{chunk-7SFE6CFO.js → chunk-VE3UM4HU.js} +12 -12
  52. package/dist/{chunk-XGSJNXH2.js → chunk-VQCAJUDV.js} +2 -2
  53. package/dist/{chunk-SIF536BT.js → chunk-WJPBZFSF.js} +1 -1
  54. package/dist/{chunk-PDK35AR4.js → chunk-XSX42Q2H.js} +1 -1
  55. package/dist/{chunk-7K6MTRN2.js → chunk-Y5CPIOBF.js} +12 -12
  56. package/dist/{chunk-2B6EKUBD.js → chunk-YC5KTX7D.js} +4 -4
  57. package/dist/{claude-launcher-MMCKOBND.js → claude-launcher-VA3OAA5V.js} +5 -5
  58. package/dist/{cli-VLQZS3BV.js → cli-NWOZT6B5.js} +123 -114
  59. package/dist/{command-Y2HFOL33.js → command-WQG2Y6MV.js} +21 -21
  60. package/dist/{config-YI5R4K77.js → config-FVSPGZIO.js} +5 -5
  61. package/dist/{connect-cmd-NHRK6Y4L.js → connect-cmd-NDWWTEHW.js} +8 -8
  62. package/dist/{container-start-W3BDQAQE.js → container-start-MMTUO3JR.js} +32 -32
  63. package/dist/{context-cleanup-PASDUBGW.js → context-cleanup-KIWINRKM.js} +3 -3
  64. package/dist/{context-show-cmd-OLJEKW2G.js → context-show-cmd-HLEHQJTV.js} +9 -9
  65. package/dist/{control-plane-launch-FV5Q6GVJ.js → control-plane-launch-X2QXGPFW.js} +6 -6
  66. package/dist/{demo-voice-cmd-W47GNKN6.js → demo-voice-cmd-NSKOX6T7.js} +14 -14
  67. package/dist/{dist-ZDKMTBJU.js → dist-RR6YVPSF.js} +2 -2
  68. package/dist/{docker-36W7PA5I.js → docker-LKM7PPDE.js} +3 -3
  69. package/dist/{doctor-YAPSQYAC.js → doctor-N5R5YUEC.js} +22 -22
  70. package/dist/{emit-artifact-cmd-72TRW3OL.js → emit-artifact-cmd-72V5FRE3.js} +13 -13
  71. package/dist/{emit-cmd-UOPHEUW5.js → emit-cmd-ZHYBT2F6.js} +6 -6
  72. package/dist/{emit-criteria-cmd-TLO4L3FN.js → emit-criteria-cmd-HIE6JLCO.js} +10 -10
  73. package/dist/{emit-demo-cmd-PISZZ6TE.js → emit-demo-cmd-TR2IS5NY.js} +14 -14
  74. package/dist/{emit-finding-cmd-MRXMDOQY.js → emit-finding-cmd-3HZBWWP7.js} +10 -10
  75. package/dist/{emit-result-cmd-UHX7OTY2.js → emit-result-cmd-YIPXXWII.js} +12 -12
  76. package/dist/{emit-step-cmd-TL73HPJY.js → emit-step-cmd-QQYPX7EF.js} +10 -10
  77. package/dist/{find-unit-LIJR6HXI.js → find-unit-QS446AID.js} +7 -7
  78. package/dist/{findings-cmd-WPHPYWZJ.js → findings-cmd-CPNMM5CJ.js} +10 -10
  79. package/dist/{fleet-readiness-4RNICYSP.js → fleet-readiness-ZQOFJZ5B.js} +8 -8
  80. package/dist/{governing-source-HAJVYDYG.js → governing-source-YXZXD6LI.js} +13 -13
  81. package/dist/{hook-fast-5PNO5HRO.js → hook-fast-OPHM3MRK.js} +1 -1
  82. package/dist/{host-checks-IAF6DYWU.js → host-checks-5YDTGG6B.js} +30 -30
  83. package/dist/index.js +4 -4
  84. package/dist/{init-4MUFI7Q7.js → init-7ZFHIK5W.js} +21 -21
  85. package/dist/{init-HTX7R3O6.js → init-M6GSCMJM.js} +21 -21
  86. package/dist/{init-cmd-Q337RMX5.js → init-cmd-RBRSD4US.js} +18 -18
  87. package/dist/{init-update-7F5WWVWX.js → init-update-GFXITSTA.js} +17 -17
  88. package/dist/{layout-ZE6F2Z7W.js → layout-2YSKJHPC.js} +4 -4
  89. package/dist/{login-browser-YB7AMKHR.js → login-browser-S6PLZCKK.js} +2 -2
  90. package/dist/{loop-XZH3TA5Z.js → loop-72U5FJPH.js} +34 -34
  91. package/dist/{machine-L4U73LZN.js → machine-FQNIDAC5.js} +21 -21
  92. package/dist/{machine-skills-DMHU7OLO.js → machine-skills-YXN3TMJ5.js} +4 -4
  93. package/dist/{runner-env-P7BHDTKU.js → runner-env-HUZ2TMAK.js} +7 -7
  94. package/dist/{runner-identity-BQEM2OHY.js → runner-identity-XKJFHYS7.js} +3 -3
  95. package/dist/{runner-key-MNVNR6UM.js → runner-key-HU542TOA.js} +21 -21
  96. package/dist/{session-sender-HPJWCUVZ.js → session-sender-5DTNDRJY.js} +13 -13
  97. package/dist/{spec-cmd-NPZ2H3ZN.js → spec-cmd-HMPVRZP2.js} +11 -11
  98. package/dist/{starter-pack-WUNNS6G7.js → starter-pack-3ERHTBBJ.js} +5 -5
  99. package/dist/{status-G4EL4ZCI.js → status-YOGCWUOD.js} +30 -30
  100. package/dist/{sync-cmd-AFB3TGYH.js → sync-cmd-45QEXKDM.js} +12 -12
  101. package/dist/{update-steps-N6U2OWK6.js → update-steps-VI2KVXG6.js} +31 -31
  102. package/dist/{watch-O6ZO5HBT.js → watch-L5MUTCM2.js} +12 -12
  103. package/dist/{work-claim-cmd-CN5FR3G4.js → work-claim-cmd-GF6O4PE4.js} +15 -15
  104. package/dist/{work-cmd-EHDLH3CJ.js → work-cmd-PKQ3UANC.js} +10 -10
  105. package/dist/{work-comment-cmd-YPNDPDHP.js → work-comment-cmd-X26ER5HH.js} +11 -11
  106. package/dist/{work-demo-cmd-TM47UETD.js → work-demo-cmd-WBOSB5QG.js} +10 -10
  107. package/dist/{work-logs-cmd-4PCBHRM2.js → work-logs-cmd-VRPW3AAL.js} +10 -10
  108. package/dist/{work-open-pr-cmd-ESLHVNO5.js → work-open-pr-cmd-BYQSZHFN.js} +11 -11
  109. package/dist/{work-pr-cmd-N63H6OJM.js → work-pr-cmd-BQBQORGW.js} +10 -10
  110. package/dist/{work-proofs-cmd-U6XFQ34N.js → work-proofs-cmd-BSNVSO7A.js} +12 -12
  111. package/dist/{work-proofs-record-YYRYIYMQ.js → work-proofs-record-LV5UTB3H.js} +18 -18
  112. package/dist/{work-stop-cmd-RB64IM3K.js → work-stop-cmd-5J5MUNDK.js} +10 -10
  113. package/package.json +1 -1
  114. package/skill-pack/maintained/outerlayer-amend/SKILL.md +20 -20
  115. package/skill-pack/maintained/outerlayer-amend/references/new-proof.md +13 -0
  116. package/skill-pack/maintained/outerlayer-amend/references/threads.md +56 -0
@@ -1,22 +1,22 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- export { classifyProofs, classifyProofsAt, otherPullRequestHeads, resolveProofsItem, runWorkProofs, runWorkProofsCommand } from './chunk-SVDO6ZQA.js';
4
- import './chunk-2B6EKUBD.js';
5
- import './chunk-NZDM6KJ2.js';
3
+ export { classifyProofs, classifyProofsAt, otherPullRequestHeads, resolveProofsItem, runWorkProofs, runWorkProofsCommand } from './chunk-HJSNFVKX.js';
4
+ import './chunk-YC5KTX7D.js';
5
+ import './chunk-MTUV27NY.js';
6
6
  import './chunk-IP7BIBXJ.js';
7
- import './chunk-QZQ2UTPE.js';
8
- import './chunk-RWQLBHU3.js';
9
- import './chunk-ZI2E4YMY.js';
7
+ import './chunk-L5GF2A43.js';
8
+ import './chunk-TYRKGKMX.js';
9
+ import './chunk-6YK3SXCW.js';
10
10
  import './chunk-A2LHHKTT.js';
11
11
  import './chunk-2AM6Z5BP.js';
12
- import './chunk-PDK35AR4.js';
13
- import './chunk-62TMOXQN.js';
12
+ import './chunk-XSX42Q2H.js';
13
+ import './chunk-TMFKZBOW.js';
14
14
  import './chunk-GBMTKV5B.js';
15
15
  import './chunk-HWVMRETT.js';
16
16
  import './chunk-XU5BNWX7.js';
17
17
  import './chunk-BJ3KTMDH.js';
18
- import './chunk-UPRZREBO.js';
19
- import './chunk-H25XK3DY.js';
18
+ import './chunk-MGF4254K.js';
19
+ import './chunk-PBAGWT2M.js';
20
20
  import './chunk-OLM2TIOW.js';
21
21
  import './chunk-CDDED64E.js';
22
22
  import './chunk-RA3O54FC.js';
@@ -24,8 +24,8 @@ import './chunk-5WYT3PPE.js';
24
24
  import './chunk-WZBHBH3J.js';
25
25
  import './chunk-FZKNTIOJ.js';
26
26
  import './chunk-YQR6E6OV.js';
27
- import './chunk-5FWBAM6O.js';
28
- import './chunk-YTTESG7K.js';
27
+ import './chunk-2PMJ7TQR.js';
28
+ import './chunk-N2XW4NYY.js';
29
29
  import './chunk-352DHUTP.js';
30
30
  import './chunk-YQHUCOUL.js';
31
31
  import './chunk-GANAOCHR.js';
@@ -1,37 +1,37 @@
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-SVDO6ZQA.js';
4
- import { runnerMatcher } from './chunk-2B6EKUBD.js';
5
- import { runWorkComment } from './chunk-DY2HAYJL.js';
6
- import { runEmitDemo } from './chunk-5DVJQC76.js';
3
+ import { resolveProofsItem, ownPullRequest, otherPullRequestHeads, classifyProofsAt, runWorkProofs, proofsCommentId, kindProblem, proofsCommentBody } from './chunk-HJSNFVKX.js';
4
+ import { runnerMatcher } from './chunk-YC5KTX7D.js';
5
+ import { runWorkComment } from './chunk-HJS267VR.js';
6
+ import { runEmitDemo } from './chunk-23DAYPF5.js';
7
7
  import { readNewestDemo } from './chunk-ER6KQCVJ.js';
8
- import { runEmitArtifact } from './chunk-CZA37XBG.js';
9
- import { runSync } from './chunk-TJ755TTP.js';
10
- import './chunk-25SWTFPA.js';
8
+ import { runEmitArtifact } from './chunk-CANPD2V3.js';
9
+ import { runSync } from './chunk-RO2XIOEN.js';
10
+ import './chunk-EBFU4YCI.js';
11
11
  import './chunk-AAGU5FJF.js';
12
12
  import './chunk-TBT347UY.js';
13
13
  import './chunk-2PGI6RDE.js';
14
14
  import './chunk-PZN4L2DN.js';
15
- import { WorkCommandError, resolveCredentials, getJson } from './chunk-NZDM6KJ2.js';
15
+ import { WorkCommandError, resolveCredentials, getJson } from './chunk-MTUV27NY.js';
16
16
  import './chunk-IP7BIBXJ.js';
17
- import './chunk-QZQ2UTPE.js';
18
- import './chunk-RWQLBHU3.js';
19
- import './chunk-ZI2E4YMY.js';
17
+ import './chunk-L5GF2A43.js';
18
+ import './chunk-TYRKGKMX.js';
19
+ import './chunk-6YK3SXCW.js';
20
20
  import './chunk-A2LHHKTT.js';
21
21
  import './chunk-2AM6Z5BP.js';
22
- import './chunk-PDK35AR4.js';
23
- import './chunk-62TMOXQN.js';
22
+ import './chunk-XSX42Q2H.js';
23
+ import './chunk-TMFKZBOW.js';
24
24
  import { defaultFetch } from './chunk-GBMTKV5B.js';
25
25
  import './chunk-HWVMRETT.js';
26
26
  import './chunk-XU5BNWX7.js';
27
- import './chunk-HS5QEIJT.js';
27
+ import './chunk-PPZ47OB6.js';
28
28
  import './chunk-545P7JY7.js';
29
29
  import './chunk-FUJUFLDC.js';
30
30
  import './chunk-BKO6JEZI.js';
31
31
  import './chunk-HCVLP7XA.js';
32
32
  import './chunk-BJ3KTMDH.js';
33
- import './chunk-UPRZREBO.js';
34
- import { resolveRepoIdentity } from './chunk-H25XK3DY.js';
33
+ import './chunk-MGF4254K.js';
34
+ import { resolveRepoIdentity } from './chunk-PBAGWT2M.js';
35
35
  import './chunk-OLM2TIOW.js';
36
36
  import './chunk-CDDED64E.js';
37
37
  import './chunk-RA3O54FC.js';
@@ -41,8 +41,8 @@ import './chunk-FZKNTIOJ.js';
41
41
  import './chunk-KYDEBGJG.js';
42
42
  import './chunk-YQR6E6OV.js';
43
43
  import './chunk-CJPTUU2E.js';
44
- import { parseProofsConfig } from './chunk-5FWBAM6O.js';
45
- import { ARTIFACT_MAX_CAPTION_LENGTH } from './chunk-YTTESG7K.js';
44
+ import { parseProofsConfig } from './chunk-2PMJ7TQR.js';
45
+ import { ARTIFACT_MAX_CAPTION_LENGTH } from './chunk-N2XW4NYY.js';
46
46
  import './chunk-352DHUTP.js';
47
47
  import './chunk-YQHUCOUL.js';
48
48
  import './chunk-GANAOCHR.js';
@@ -1,27 +1,27 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- import { resolveCredentials, postJson, WorkCommandError } from './chunk-NZDM6KJ2.js';
3
+ import { resolveCredentials, postJson, WorkCommandError } from './chunk-MTUV27NY.js';
4
4
  import './chunk-IP7BIBXJ.js';
5
- import './chunk-QZQ2UTPE.js';
6
- import './chunk-RWQLBHU3.js';
7
- import './chunk-ZI2E4YMY.js';
5
+ import './chunk-L5GF2A43.js';
6
+ import './chunk-TYRKGKMX.js';
7
+ import './chunk-6YK3SXCW.js';
8
8
  import './chunk-A2LHHKTT.js';
9
9
  import './chunk-2AM6Z5BP.js';
10
- import './chunk-PDK35AR4.js';
11
- import './chunk-62TMOXQN.js';
10
+ import './chunk-XSX42Q2H.js';
11
+ import './chunk-TMFKZBOW.js';
12
12
  import { defaultFetch } from './chunk-GBMTKV5B.js';
13
13
  import './chunk-HWVMRETT.js';
14
14
  import './chunk-XU5BNWX7.js';
15
15
  import './chunk-BJ3KTMDH.js';
16
- import './chunk-UPRZREBO.js';
17
- import './chunk-H25XK3DY.js';
16
+ import './chunk-MGF4254K.js';
17
+ import './chunk-PBAGWT2M.js';
18
18
  import './chunk-OLM2TIOW.js';
19
19
  import './chunk-CDDED64E.js';
20
20
  import './chunk-RA3O54FC.js';
21
21
  import { parseTrackerNumber, trackerNumberError } from './chunk-WZBHBH3J.js';
22
22
  import './chunk-FZKNTIOJ.js';
23
- import './chunk-5FWBAM6O.js';
24
- import './chunk-YTTESG7K.js';
23
+ import './chunk-2PMJ7TQR.js';
24
+ import './chunk-N2XW4NYY.js';
25
25
  import './chunk-352DHUTP.js';
26
26
  import './chunk-YQHUCOUL.js';
27
27
  import './chunk-GANAOCHR.js';
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@outerlayer/cli",
3
- "version": "0.34.0",
3
+ "version": "0.34.1-next.20261029191024",
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.",
@@ -1,12 +1,11 @@
1
1
  ---
2
2
  name: outerlayer-amend
3
3
  description: >
4
- Answer the review threads waiting on an agent on an open pull request: read each
5
- thread a person handed to an agent, fix what it says on the pull request's branch,
6
- reply on the thread with a replacement artifact or a sentence, and push. Also resolve a
7
- merge conflict with the base branch. Use when a work item has threads waiting on an
8
- agent or a conflicting pull request, or when asked to "answer the review" or "fix what
9
- the reviewer failed".
4
+ Answer the review threads and source threads waiting on an agent on an open pull
5
+ request: fix what each says on the pull request's branch, reply with a replacement
6
+ artifact or a sentence, and push. Also resolve a merge conflict with the base
7
+ branch. Use when a work item has threads waiting on an agent or a conflicting pull
8
+ request, or when asked to "answer the review".
10
9
  ---
11
10
 
12
11
  Run the CLI as `outerlayer`. If that command is not on PATH, run `npx -y @outerlayer/cli` with the same arguments. Every `outerlayer ...` command below follows this rule. Write the full command each time. Do not put it in a shell variable: zsh runs `$VAR args` as one command name, not as a command with arguments.
@@ -15,8 +14,9 @@ Answer every thread waiting on an agent on one work item's pull request, then
15
14
  stop. A work item has one general thread and one thread per acceptance
16
15
  criterion. A person's fail on the general thread leaves it waiting on an agent.
17
16
  A note a reviewer sent with Request changes (a sent note) does the same to its
18
- criterion thread. A plain comment from a person does not hand a thread to an
19
- agent. The person's newest comment says what they want. Only a person passes
17
+ criterion thread. A sent line comment from a member's GitHub review does the
18
+ same to its thread. A plain comment from a person does not hand a thread
19
+ to an agent. The person's newest comment says what they want. Only a person passes
20
20
  or fails a thread. A session can only reply.
21
21
 
22
22
  A session never records a pass or fail on an artifact.
@@ -62,7 +62,9 @@ repository. Commit and push in each checkout you change, to its own branch only.
62
62
  Tell the person to fail the general thread with their answer.
63
63
  2. **Read the threads.**
64
64
  `outerlayer work threads --item "$OUTERLAYER_WORK" --json` prints
65
- `{ "general": <thread>, "criteria": [<thread>, ...] }`. Each thread has
65
+ `{ "general": <thread>, "criteria": [<thread>, ...], "threads": [<source thread>, ...] }`.
66
+ A source thread has an `id`, a `source`, an optional `anchor` and `comments`; see
67
+ [references/threads.md](references/threads.md). Each thread has
66
68
  `criterion` (null for the general thread), `waitingOn` (`agent`, `person` or
67
69
  null), `verdict`, `proof` and `comments`, each comment with its `author`,
68
70
  `body`, `action` and `artifact`. Keep the threads whose `waitingOn` is
@@ -77,7 +79,7 @@ repository. Commit and push in each checkout you change, to its own branch only.
77
79
  items under `items`, each with a `result` and a `reason`. When a person asks you to fix failing
78
80
  checks or criteria, fix each failing check item by its reason.
79
81
  4. **Decide each thread.** Reply on every criterion thread waiting on an
80
- agent, with `--criterion`. Read each note and pick one:
82
+ agent, with `--criterion`. Reply on every source thread waiting on an agent with `--thread`. Read each note and pick one:
81
83
  - **Answer it.** A question gets an answer. Change nothing. Say which
82
84
  file or test you looked at.
83
85
  - **Fix it.** A requested change gets a fix. Change the code, tests, docs or
@@ -96,21 +98,19 @@ repository. Commit and push in each checkout you change, to its own branch only.
96
98
  - Over SSH, a long gate can drop the connection. Push again with
97
99
  `GIT_SSH_COMMAND="ssh -o ServerAliveInterval=20 -o ServerAliveCountMax=60"`.
98
100
  - **When the thread asks for new proof** (a person failed its proof),
99
- capture it after the fixed state exists, in the form the criterion
100
- declares or the form of the current proof. Emit it bound to that
101
- criterion, without `--replaces`:
102
- `outerlayer emit artifact <file> --caption "<what it shows>" --for <criterion>`.
103
- Note the id it prints. Run `outerlayer sync`, so the attach can find the
104
- artifact. Then reply, which supersedes the old proof:
105
- `outerlayer work comment --item "$OUTERLAYER_WORK" --criterion <criterion> --body "<what changed>" --artifact <uuid> --attach`.
106
- A replacement with the current proof's bytes is flagged `unchanged`, and
107
- the thread still waits on you.
101
+ capture it after the fixed state exists, emit it, and attach it with
102
+ `outerlayer work comment --item "$OUTERLAYER_WORK" --criterion <criterion> --artifact <uuid> --attach`.
103
+ See [references/new-proof.md](references/new-proof.md).
108
104
  - **A check the factory host records**, such as `acceptance-criteria`, is
109
105
  judged again after this session ends. Name each failing check item and
110
106
  your fix. Never claim the check passes.
111
107
  - **Otherwise**, reply with a sentence naming what changed and the commit:
112
108
  `outerlayer work comment --item "$OUTERLAYER_WORK" [--criterion <criterion>] --body "<what changed>" --ready`.
113
109
  Omit `--criterion` on the general thread.
110
+ - **A source thread** gets a fix and a sentence, or a question:
111
+ `outerlayer work comment --item "$OUTERLAYER_WORK" --thread <id> --body "<what changed>"`.
112
+ Give no `--criterion` and no action flag. Answer a review summary on the
113
+ general thread.
114
114
  6. **Record the proofs again** before you watch CI: the evidence check waits
115
115
  on them. Run `outerlayer work proofs --record --comment --pr <prNumber>` in each
116
116
  checkout you pushed. Run it in the foreground and read all its output. A
@@ -144,7 +144,7 @@ repository. Commit and push in each checkout you change, to its own branch only.
144
144
  ## Rules
145
145
 
146
146
  - **Answer only threads waiting on an agent.** Never reply on one waiting on a
147
- person or on no one.
147
+ person or on no one. This includes them all.
148
148
  - **One thread, one proof.** Never attach an artifact that does not prove that
149
149
  thread's criterion.
150
150
  - **A person decides.** Never pass `--pass` or `--fail`, never mark a check as
@@ -0,0 +1,13 @@
1
+ # New proof for a criterion
2
+
3
+ Use this when a person failed a criterion's proof and the thread asks for new proof.
4
+
5
+ 1. Capture the proof after the fixed state exists. Use the form the criterion declares, or the form of the current proof.
6
+ 2. Emit it bound to the criterion, without `--replaces`:
7
+ `outerlayer emit artifact <file> --caption "<what it shows>" --for <criterion>`.
8
+ Note the id it prints.
9
+ 3. Run `outerlayer sync`, so the attach can find the artifact.
10
+ 4. Reply with the attach. It supersedes the old proof:
11
+ `outerlayer work comment --item "$OUTERLAYER_WORK" --criterion <criterion> --body "<what changed>" --artifact <uuid> --attach`.
12
+
13
+ A replacement with the current proof's bytes is flagged `unchanged`, and the thread still waits on you.
@@ -0,0 +1,56 @@
1
+ # Source threads
2
+
3
+ A source thread is a conversation that started outside OuterLayer. Today the only source is GitHub. A member's line comment in a GitHub review comes into the work item as a source thread. The comment goes to the agent when the factory setting **Answer GitHub reviews** sends it.
4
+
5
+ ## Contents
6
+
7
+ - What a source thread holds
8
+ - Answer a source thread
9
+ - Answer a review summary
10
+ - What happens to your answer
11
+
12
+ ## What a source thread holds
13
+
14
+ `outerlayer work threads --item "$OUTERLAYER_WORK" --json` lists `threads`. Each source thread has:
15
+
16
+ - `id`: the id for `--thread`.
17
+ - `source`: where the thread came from, such as `github`.
18
+ - `externalRef`: the source's own id of the thread.
19
+ - `externalUrl`: the thread at its source. It is empty when there is no link.
20
+ - `anchor`: present when the thread is on a line of a pull request. It holds `repository`, `prNumber`, `path`, `line` and `excerpt`. The `excerpt` is the code around the line, as GitHub sent it.
21
+ - `waitingOn`: `agent`, `person` or `null`. Answer the threads that wait on `agent`.
22
+ - `comments`: each with its `body`, `authorName` and `authorKind`.
23
+
24
+ The list holds what was sent before your claim. A comment sent later waits for the next run.
25
+
26
+ ## Answer a source thread
27
+
28
+ Read the comments and the file. Pick one:
29
+
30
+ - **A question.** Answer it. Change nothing. Name the file or test you looked at.
31
+ - **A change.** Fix it on the pull request's branch, run the tests, and push. Then say what changed.
32
+ - **Unclear.** Ask one question in your answer.
33
+
34
+ Post the answer on the thread:
35
+
36
+ ```bash
37
+ outerlayer work comment --item "$OUTERLAYER_WORK" --thread <id> --body "<the answer>"
38
+ ```
39
+
40
+ Give no `--criterion` and no action flag. The answer hands the thread back to a person.
41
+
42
+ ## Answer a review summary
43
+
44
+ A Request changes review from GitHub can hand the general thread to you with a summary and no line comment. Answer the review summary on the general thread:
45
+
46
+ ```bash
47
+ outerlayer work comment --item "$OUTERLAYER_WORK" --body "<the answer>"
48
+ ```
49
+
50
+ Give no `--criterion`.
51
+
52
+ ## What happens to your answer
53
+
54
+ OuterLayer posts your answer as a reply on the same GitHub thread, as the GitHub App. For a review summary, it posts a pull request comment that quotes the summary. The reviewer reads it on GitHub, so keep it short and plain.
55
+
56
+ If GitHub refuses the reply, OuterLayer tries again. The answer stays on the work item either way. You do nothing more.