lab-kit-cli 0.6.3__tar.gz → 1.0.1__tar.gz

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 (232) hide show
  1. lab_kit_cli-1.0.1/.github/workflows/ci.yml +38 -0
  2. {lab_kit_cli-0.6.3 → lab_kit_cli-1.0.1}/.github/workflows/release.yml +6 -10
  3. {lab_kit_cli-0.6.3 → lab_kit_cli-1.0.1}/AGENTS.md +9 -11
  4. {lab_kit_cli-0.6.3 → lab_kit_cli-1.0.1}/CHANGELOG.md +118 -0
  5. lab_kit_cli-1.0.1/CONTRIBUTING.md +37 -0
  6. lab_kit_cli-1.0.1/PKG-INFO +77 -0
  7. lab_kit_cli-1.0.1/README.md +59 -0
  8. lab_kit_cli-1.0.1/agents/reviewer.md +11 -0
  9. lab_kit_cli-1.0.1/docs/model.md +539 -0
  10. lab_kit_cli-1.0.1/method/METHOD.md +40 -0
  11. {lab_kit_cli-0.6.3 → lab_kit_cli-1.0.1}/pyproject.toml +8 -4
  12. lab_kit_cli-1.0.1/skills/lab-review/SKILL.md +57 -0
  13. lab_kit_cli-1.0.1/skills/lab-set-up/SKILL.md +47 -0
  14. lab_kit_cli-1.0.1/skills/lab-talk/SKILL.md +70 -0
  15. lab_kit_cli-1.0.1/skills/lab-work/SKILL.md +215 -0
  16. lab_kit_cli-1.0.1/src/lab_kit/__init__.py +2 -0
  17. lab_kit_cli-1.0.1/src/lab_kit/checks.py +329 -0
  18. lab_kit_cli-1.0.1/src/lab_kit/cli.py +191 -0
  19. lab_kit_cli-1.0.1/src/lab_kit/history.py +208 -0
  20. lab_kit_cli-1.0.1/src/lab_kit/record.py +949 -0
  21. lab_kit_cli-1.0.1/src/lab_kit/runs.py +415 -0
  22. lab_kit_cli-1.0.1/src/lab_kit/site.py +1156 -0
  23. lab_kit_cli-1.0.1/src/lab_kit/supervise.py +7 -0
  24. lab_kit_cli-1.0.1/src/lab_kit/views.py +236 -0
  25. lab_kit_cli-1.0.1/src/lab_kit/write.py +357 -0
  26. lab_kit_cli-1.0.1/tests/test_flow.py +395 -0
  27. lab_kit_cli-1.0.1/tests/test_held.py +222 -0
  28. lab_kit_cli-1.0.1/tests/test_integrity.py +865 -0
  29. lab_kit_cli-1.0.1/tests/test_refusals.py +146 -0
  30. lab_kit_cli-1.0.1/tests/test_site.py +308 -0
  31. lab_kit_cli-1.0.1/tools/import_run.py +61 -0
  32. lab_kit_cli-0.6.3/.github/workflows/ci.yml +0 -26
  33. lab_kit_cli-0.6.3/CLAUDE.md +0 -1
  34. lab_kit_cli-0.6.3/CONTRIBUTING.md +0 -28
  35. lab_kit_cli-0.6.3/PKG-INFO +0 -114
  36. lab_kit_cli-0.6.3/README.md +0 -98
  37. lab_kit_cli-0.6.3/SETUP.md +0 -17
  38. lab_kit_cli-0.6.3/agents/reporter.md +0 -30
  39. lab_kit_cli-0.6.3/agents/reviewer.md +0 -36
  40. lab_kit_cli-0.6.3/agents/runner.md +0 -41
  41. lab_kit_cli-0.6.3/agents/scout.md +0 -28
  42. lab_kit_cli-0.6.3/docs/figures/how-lab-kit-works-dark.svg +0 -168
  43. lab_kit_cli-0.6.3/docs/figures/how-lab-kit-works-light.svg +0 -168
  44. lab_kit_cli-0.6.3/docs/figures/lab-loop-dark.svg +0 -159
  45. lab_kit_cli-0.6.3/docs/figures/lab-loop-light.svg +0 -159
  46. lab_kit_cli-0.6.3/docs/figures/number-chain-dark.svg +0 -150
  47. lab_kit_cli-0.6.3/docs/figures/number-chain-light.svg +0 -150
  48. lab_kit_cli-0.6.3/docs/spec/lab-model.md +0 -181
  49. lab_kit_cli-0.6.3/examples/monte-carlo-lab/.agents/agents/reporter.md +0 -30
  50. lab_kit_cli-0.6.3/examples/monte-carlo-lab/.agents/agents/reviewer.md +0 -36
  51. lab_kit_cli-0.6.3/examples/monte-carlo-lab/.agents/agents/runner.md +0 -41
  52. lab_kit_cli-0.6.3/examples/monte-carlo-lab/.agents/agents/scout.md +0 -28
  53. lab_kit_cli-0.6.3/examples/monte-carlo-lab/.agents/skills/address/SKILL.md +0 -75
  54. lab_kit_cli-0.6.3/examples/monte-carlo-lab/.agents/skills/configure/SKILL.md +0 -88
  55. lab_kit_cli-0.6.3/examples/monte-carlo-lab/.agents/skills/experiment/SKILL.md +0 -80
  56. lab_kit_cli-0.6.3/examples/monte-carlo-lab/.agents/skills/organise/SKILL.md +0 -92
  57. lab_kit_cli-0.6.3/examples/monte-carlo-lab/.agents/skills/plan-mission/SKILL.md +0 -80
  58. lab_kit_cli-0.6.3/examples/monte-carlo-lab/.agents/skills/publish/SKILL.md +0 -70
  59. lab_kit_cli-0.6.3/examples/monte-carlo-lab/.agents/skills/review/SKILL.md +0 -75
  60. lab_kit_cli-0.6.3/examples/monte-carlo-lab/.agents/skills/run/SKILL.md +0 -69
  61. lab_kit_cli-0.6.3/examples/monte-carlo-lab/.agents/skills/run-mission/SKILL.md +0 -88
  62. lab_kit_cli-0.6.3/examples/monte-carlo-lab/.agents/skills/set-up/SKILL.md +0 -72
  63. lab_kit_cli-0.6.3/examples/monte-carlo-lab/.agents/skills/set-up-lab/SKILL.md +0 -81
  64. lab_kit_cli-0.6.3/examples/monte-carlo-lab/.agents/skills/write/SKILL.md +0 -111
  65. lab_kit_cli-0.6.3/examples/monte-carlo-lab/.gitignore +0 -5
  66. lab_kit_cli-0.6.3/examples/monte-carlo-lab/.lab/frozen.sha256 +0 -2
  67. lab_kit_cli-0.6.3/examples/monte-carlo-lab/.lab/method/DISCIPLINE.md +0 -114
  68. lab_kit_cli-0.6.3/examples/monte-carlo-lab/.lab/method/LADDER.md +0 -73
  69. lab_kit_cli-0.6.3/examples/monte-carlo-lab/.lab/migration.tsv +0 -4
  70. lab_kit_cli-0.6.3/examples/monte-carlo-lab/AGENTS.md +0 -22
  71. lab_kit_cli-0.6.3/examples/monte-carlo-lab/CLAUDE.md +0 -1
  72. lab_kit_cli-0.6.3/examples/monte-carlo-lab/docs/.folio/backlinks.json +0 -425
  73. lab_kit_cli-0.6.3/examples/monte-carlo-lab/docs/.folio/cards.json +0 -1
  74. lab_kit_cli-0.6.3/examples/monte-carlo-lab/docs/.folio/catalog.json +0 -491
  75. lab_kit_cli-0.6.3/examples/monte-carlo-lab/docs/.folio/journal.json +0 -143
  76. lab_kit_cli-0.6.3/examples/monte-carlo-lab/docs/.folio/nav.json +0 -1
  77. lab_kit_cli-0.6.3/examples/monte-carlo-lab/docs/.folio/search.json +0 -248
  78. lab_kit_cli-0.6.3/examples/monte-carlo-lab/docs/.gitignore +0 -4
  79. lab_kit_cli-0.6.3/examples/monte-carlo-lab/docs/assets/data/.gitkeep +0 -0
  80. lab_kit_cli-0.6.3/examples/monte-carlo-lab/docs/assets/figures/.gitkeep +0 -0
  81. lab_kit_cli-0.6.3/examples/monte-carlo-lab/docs/assets/refs.bib +0 -0
  82. lab_kit_cli-0.6.3/examples/monte-carlo-lab/docs/baseline.sha256 +0 -9
  83. lab_kit_cli-0.6.3/examples/monte-carlo-lab/docs/content/claims/C-1.md +0 -26
  84. lab_kit_cli-0.6.3/examples/monte-carlo-lab/docs/content/index.html +0 -19
  85. lab_kit_cli-0.6.3/examples/monte-carlo-lab/docs/content/journal/2026/2026-10-04-concluded-the-pi-error-scaling-mission.md +0 -10
  86. lab_kit_cli-0.6.3/examples/monte-carlo-lab/docs/content/journal/2026/2026-10-04-lab-set-up.md +0 -10
  87. lab_kit_cli-0.6.3/examples/monte-carlo-lab/docs/content/journal/2026/2026-10-04-locked-the-pi-error-scaling-protocol.md +0 -10
  88. lab_kit_cli-0.6.3/examples/monte-carlo-lab/docs/content/journal/2026/2026-10-04-opened-the-pi-error-scaling-mission.md +0 -10
  89. lab_kit_cli-0.6.3/examples/monte-carlo-lab/docs/content/journal/2026/2026-10-04-r-1-fitted-the-mean-absolute-error.md +0 -10
  90. lab_kit_cli-0.6.3/examples/monte-carlo-lab/docs/content/journal/2026/2026-10-04-ran-the-pi-error-scaling-protocol.md +0 -10
  91. lab_kit_cli-0.6.3/examples/monte-carlo-lab/docs/content/journal/2026/2026-10-04-recorded-r-1.md +0 -9
  92. lab_kit_cli-0.6.3/examples/monte-carlo-lab/docs/content/journal/2026/2026-10-04-recorded-r-2.md +0 -9
  93. lab_kit_cli-0.6.3/examples/monte-carlo-lab/docs/content/journal/2026/2026-10-04-reported-the-pi-error-scaling-experiment.md +0 -9
  94. lab_kit_cli-0.6.3/examples/monte-carlo-lab/docs/content/journal/2026/2026-10-04-the-square-root-law-holds-per-size-predictions.md +0 -10
  95. lab_kit_cli-0.6.3/examples/monte-carlo-lab/docs/content/maps/research.html +0 -29
  96. lab_kit_cli-0.6.3/examples/monte-carlo-lab/docs/content/projects/lab/index.html +0 -31
  97. lab_kit_cli-0.6.3/examples/monte-carlo-lab/docs/content/protocols/pi-error-scaling.md +0 -66
  98. lab_kit_cli-0.6.3/examples/monte-carlo-lab/docs/content/questions/Q-1.md +0 -25
  99. lab_kit_cli-0.6.3/examples/monte-carlo-lab/docs/content/reports/pi-error-scaling-report/index.html +0 -47
  100. lab_kit_cli-0.6.3/examples/monte-carlo-lab/docs/content/results/R-1.md +0 -18
  101. lab_kit_cli-0.6.3/examples/monte-carlo-lab/docs/content/results/R-2.md +0 -19
  102. lab_kit_cli-0.6.3/examples/monte-carlo-lab/docs/folio.yaml +0 -9
  103. lab_kit_cli-0.6.3/examples/monte-carlo-lab/experiments/.gitkeep +0 -0
  104. lab_kit_cli-0.6.3/examples/monte-carlo-lab/experiments/26-10-04-e_pi-error-scaling/bin/.gitkeep +0 -0
  105. lab_kit_cli-0.6.3/examples/monte-carlo-lab/experiments/26-10-04-e_pi-error-scaling/bin/fold.py +0 -101
  106. lab_kit_cli-0.6.3/examples/monte-carlo-lab/experiments/26-10-04-e_pi-error-scaling/bin/sample.py +0 -65
  107. lab_kit_cli-0.6.3/examples/monte-carlo-lab/experiments/26-10-04-e_pi-error-scaling/lock.json +0 -11
  108. lab_kit_cli-0.6.3/examples/monte-carlo-lab/experiments/26-10-04-e_pi-error-scaling/score.yaml +0 -50
  109. lab_kit_cli-0.6.3/examples/monte-carlo-lab/lab.yaml +0 -5
  110. lab_kit_cli-0.6.3/examples/monte-carlo-lab/missions/.gitkeep +0 -0
  111. lab_kit_cli-0.6.3/examples/monte-carlo-lab/missions/26-10-04-m_pi-error-scaling.md +0 -42
  112. lab_kit_cli-0.6.3/examples/monte-carlo-lab/ops/STATE.md +0 -7
  113. lab_kit_cli-0.6.3/examples/monte-carlo-lab/ops/missions/.gitkeep +0 -0
  114. lab_kit_cli-0.6.3/examples/monte-carlo-lab/runs/26-10-04-e_pi-error-scaling/26-10-04-2316-r_zlk7/out/estimates.tsv +0 -501
  115. lab_kit_cli-0.6.3/examples/monte-carlo-lab/runs/26-10-04-e_pi-error-scaling/26-10-04-2316-r_zlk7/run.json +0 -43
  116. lab_kit_cli-0.6.3/examples/monte-carlo-lab/substrate/README.md +0 -3
  117. lab_kit_cli-0.6.3/examples/monte-carlo-lab/substrate/estimator.py +0 -18
  118. lab_kit_cli-0.6.3/method/DISCIPLINE.md +0 -114
  119. lab_kit_cli-0.6.3/method/LADDER.md +0 -73
  120. lab_kit_cli-0.6.3/skills/experiment/SKILL.md +0 -80
  121. lab_kit_cli-0.6.3/skills/plan-mission/SKILL.md +0 -80
  122. lab_kit_cli-0.6.3/skills/review/SKILL.md +0 -75
  123. lab_kit_cli-0.6.3/skills/run-mission/SKILL.md +0 -88
  124. lab_kit_cli-0.6.3/skills/set-up-lab/SKILL.md +0 -81
  125. lab_kit_cli-0.6.3/src/lab_kit/__init__.py +0 -3
  126. lab_kit_cli-0.6.3/src/lab_kit/__main__.py +0 -3
  127. lab_kit_cli-0.6.3/src/lab_kit/budgets.py +0 -94
  128. lab_kit_cli-0.6.3/src/lab_kit/checks/__init__.py +0 -1
  129. lab_kit_cli-0.6.3/src/lab_kit/checks/base.py +0 -41
  130. lab_kit_cli-0.6.3/src/lab_kit/checks/files.py +0 -312
  131. lab_kit_cli-0.6.3/src/lab_kit/checks/locks.py +0 -156
  132. lab_kit_cli-0.6.3/src/lab_kit/checks/results.py +0 -188
  133. lab_kit_cli-0.6.3/src/lab_kit/checks/run.py +0 -63
  134. lab_kit_cli-0.6.3/src/lab_kit/cli.py +0 -233
  135. lab_kit_cli-0.6.3/src/lab_kit/commands/__init__.py +0 -1
  136. lab_kit_cli-0.6.3/src/lab_kit/commands/experiments.py +0 -97
  137. lab_kit_cli-0.6.3/src/lab_kit/commands/migrate.py +0 -682
  138. lab_kit_cli-0.6.3/src/lab_kit/commands/runs.py +0 -116
  139. lab_kit_cli-0.6.3/src/lab_kit/commands/setup.py +0 -150
  140. lab_kit_cli-0.6.3/src/lab_kit/commands/status.py +0 -41
  141. lab_kit_cli-0.6.3/src/lab_kit/data.py +0 -49
  142. lab_kit_cli-0.6.3/src/lab_kit/errors.py +0 -2
  143. lab_kit_cli-0.6.3/src/lab_kit/frozen.py +0 -48
  144. lab_kit_cli-0.6.3/src/lab_kit/gitlog.py +0 -55
  145. lab_kit_cli-0.6.3/src/lab_kit/lab.py +0 -173
  146. lab_kit_cli-0.6.3/src/lab_kit/ops.py +0 -193
  147. lab_kit_cli-0.6.3/src/lab_kit/protocol.py +0 -100
  148. lab_kit_cli-0.6.3/src/lab_kit/records.py +0 -357
  149. lab_kit_cli-0.6.3/src/lab_kit/rederive.py +0 -54
  150. lab_kit_cli-0.6.3/src/lab_kit/store.py +0 -273
  151. lab_kit_cli-0.6.3/src/lab_kit/supervise.py +0 -132
  152. lab_kit_cli-0.6.3/tests/conftest.py +0 -79
  153. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/.agents/agents/reporter.md +0 -30
  154. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/.agents/agents/reviewer.md +0 -36
  155. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/.agents/agents/runner.md +0 -41
  156. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/.agents/agents/scout.md +0 -28
  157. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/.agents/skills/address/SKILL.md +0 -75
  158. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/.agents/skills/configure/SKILL.md +0 -88
  159. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/.agents/skills/experiment/SKILL.md +0 -80
  160. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/.agents/skills/organise/SKILL.md +0 -92
  161. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/.agents/skills/plan-mission/SKILL.md +0 -79
  162. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/.agents/skills/publish/SKILL.md +0 -70
  163. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/.agents/skills/review/SKILL.md +0 -75
  164. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/.agents/skills/run/SKILL.md +0 -69
  165. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/.agents/skills/run-mission/SKILL.md +0 -83
  166. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/.agents/skills/set-up/SKILL.md +0 -72
  167. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/.agents/skills/set-up-lab/SKILL.md +0 -81
  168. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/.agents/skills/write/SKILL.md +0 -111
  169. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/.gitignore +0 -1
  170. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/.lab/frozen.sha256 +0 -2
  171. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/.lab/method/DISCIPLINE.md +0 -114
  172. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/.lab/method/LADDER.md +0 -73
  173. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/AGENTS.md +0 -22
  174. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/docs/.folio/backlinks.json +0 -425
  175. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/docs/.folio/cards.json +0 -1
  176. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/docs/.folio/catalog.json +0 -491
  177. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/docs/.folio/journal.json +0 -143
  178. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/docs/.folio/nav.json +0 -1
  179. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/docs/.folio/search.json +0 -248
  180. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/docs/.gitignore +0 -4
  181. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/docs/assets/data/.gitkeep +0 -0
  182. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/docs/assets/figures/.gitkeep +0 -0
  183. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/docs/assets/refs.bib +0 -0
  184. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/docs/content/claims/C-1.md +0 -26
  185. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/docs/content/index.html +0 -19
  186. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/docs/content/journal/2026/2026-10-04-concluded-the-pi-error-scaling-mission.md +0 -10
  187. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/docs/content/journal/2026/2026-10-04-lab-set-up.md +0 -10
  188. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/docs/content/journal/2026/2026-10-04-locked-the-pi-error-scaling-protocol.md +0 -10
  189. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/docs/content/journal/2026/2026-10-04-opened-the-pi-error-scaling-mission.md +0 -10
  190. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/docs/content/journal/2026/2026-10-04-r-1-fitted-the-mean-absolute-error.md +0 -10
  191. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/docs/content/journal/2026/2026-10-04-ran-the-pi-error-scaling-protocol.md +0 -10
  192. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/docs/content/journal/2026/2026-10-04-recorded-r-1.md +0 -9
  193. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/docs/content/journal/2026/2026-10-04-recorded-r-2.md +0 -9
  194. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/docs/content/journal/2026/2026-10-04-reported-the-pi-error-scaling-experiment.md +0 -9
  195. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/docs/content/journal/2026/2026-10-04-the-square-root-law-holds-per-size-predictions.md +0 -10
  196. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/docs/content/maps/research.html +0 -29
  197. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/docs/content/projects/lab/index.html +0 -31
  198. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/docs/content/protocols/pi-error-scaling.md +0 -66
  199. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/docs/content/questions/Q-1.md +0 -25
  200. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/docs/content/reports/pi-error-scaling-report/index.html +0 -47
  201. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/docs/content/results/R-1.md +0 -18
  202. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/docs/content/results/R-2.md +0 -19
  203. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/docs/folio.yaml +0 -8
  204. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/experiments/.gitkeep +0 -0
  205. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/experiments/pi-error-scaling/.gitignore +0 -3
  206. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/experiments/pi-error-scaling/bin/.gitkeep +0 -0
  207. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/experiments/pi-error-scaling/bin/fold.py +0 -101
  208. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/experiments/pi-error-scaling/bin/sample.py +0 -65
  209. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/experiments/pi-error-scaling/lock.json +0 -6
  210. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/experiments/pi-error-scaling/runs/.gitkeep +0 -0
  211. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/experiments/pi-error-scaling/runs/20261004-231629/MANIFEST.sha256 +0 -1
  212. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/experiments/pi-error-scaling/runs/20261004-231629/out/estimates.tsv +0 -501
  213. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/experiments/pi-error-scaling/runs/20261004-231629/run.json +0 -31
  214. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/experiments/pi-error-scaling/score.yaml +0 -50
  215. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/lab.yaml +0 -5
  216. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/ops/STATE.md +0 -7
  217. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/ops/missions/.gitkeep +0 -0
  218. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/ops/missions/2026-10-04-pi-error-scaling.md +0 -42
  219. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/substrate/README.md +0 -3
  220. lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5/substrate/estimator.py +0 -18
  221. lab_kit_cli-0.6.3/tests/test_budgets.py +0 -213
  222. lab_kit_cli-0.6.3/tests/test_checks.py +0 -269
  223. lab_kit_cli-0.6.3/tests/test_end_to_end.py +0 -264
  224. lab_kit_cli-0.6.3/tests/test_example.py +0 -40
  225. lab_kit_cli-0.6.3/tests/test_instrument.py +0 -92
  226. lab_kit_cli-0.6.3/tests/test_migrate.py +0 -271
  227. lab_kit_cli-0.6.3/tests/test_runs.py +0 -78
  228. lab_kit_cli-0.6.3/tests/test_store.py +0 -115
  229. {lab_kit_cli-0.6.3 → lab_kit_cli-1.0.1}/.github/workflows/policy.yml +0 -0
  230. {lab_kit_cli-0.6.3 → lab_kit_cli-1.0.1}/.gitignore +0 -0
  231. {lab_kit_cli-0.6.3/tests/fixtures/monte-carlo-lab-0.5 → lab_kit_cli-1.0.1}/CLAUDE.md +0 -0
  232. {lab_kit_cli-0.6.3 → lab_kit_cli-1.0.1}/LICENSE +0 -0
@@ -0,0 +1,38 @@
1
+ name: gate
2
+
3
+ on:
4
+ push:
5
+ pull_request:
6
+
7
+ jobs:
8
+ check:
9
+ runs-on: ubuntu-latest
10
+ strategy:
11
+ matrix:
12
+ python: ["3.10", "3.12"]
13
+ steps:
14
+ - uses: actions/checkout@v4
15
+ - uses: actions/setup-python@v5
16
+ with:
17
+ python-version: ${{ matrix.python }}
18
+ # The site's tests need folio's views hook, in folio-kb 0.5.0 and later: the `site` extra brings it.
19
+ - name: Install lab-kit, and folio for the site's tests
20
+ run: |
21
+ python -m pip install --upgrade pip
22
+ python -m pip install -e ".[dev,site]"
23
+ - name: Tests
24
+ run: python -m pytest -q -rs
25
+ env:
26
+ LAB_SITE_TESTS: required # the site's tests run and fail like any other; they never skip here
27
+ # What a lab gets is the wheel: build it, install it alone, and set up a lab with it.
28
+ - name: The built wheel sets up a lab that passes its own check
29
+ if: matrix.python == '3.12'
30
+ run: |
31
+ python -m pip install build
32
+ python -m build --wheel
33
+ python -m venv /tmp/wheel
34
+ /tmp/wheel/bin/pip install dist/*.whl
35
+ mkdir /tmp/new-lab
36
+ cd /tmp/new-lab
37
+ /tmp/wheel/bin/lab init
38
+ /tmp/wheel/bin/lab check
@@ -21,16 +21,12 @@ jobs:
21
21
  - uses: actions/setup-python@v5
22
22
  with:
23
23
  python-version: "3.12"
24
- - name: Configure git for the tests' temporary repositories
25
- run: |
26
- git config --global user.name "ci"
27
- git config --global user.email "ci@example.invalid"
28
- # Never publish untested: the same gate CI runs, against folio-kb from PyPI.
29
- - run: python -m pip install -e ".[dev]"
30
- - run: python -m pytest -q
31
- - name: Example lab
32
- working-directory: examples/monte-carlo-lab
33
- run: lab-kit check
24
+ # Never publish untested: the same gate CI runs, and here the site's tests must run too, so
25
+ # folio-kb 0.5.0 or later has to be on PyPI before lab-kit is released.
26
+ - run: python -m pip install -e ".[dev,site]"
27
+ - run: python -m pytest -q -rs
28
+ env:
29
+ LAB_SITE_TESTS: required
34
30
  - name: Build
35
31
  run: |
36
32
  python -m pip install build
@@ -4,27 +4,25 @@ This file is the only copy of the operating rules for this checkout. `CLAUDE.md`
4
4
 
5
5
  ## Read
6
6
 
7
- - `README.md`: what lab-kit is and how it uses folio.
8
- - `docs/spec/lab-model.md`: the contract. When code, a skill or the method disagrees with it, it wins.
9
- - `method/`: `DISCIPLINE.md` and `LADDER.md`, the operating contract every lab inherits.
10
- - `skills/`: set-up-lab, plan-mission, run-mission, experiment, review. `agents/`: scout, runner, reviewer, reporter.
11
- - `src/lab_kit/`: the `lab-kit` command and the lab checks.
12
- - `examples/monte-carlo-lab/`: a small lab that passes the gate.
7
+ - `README.md`: what lab-kit is.
8
+ - `docs/model.md`: the contract. When code, a skill or the method disagrees with it, it wins.
9
+ - `method/METHOD.md`: the rules every lab keeps.
10
+ - `skills/`: lab-set-up, lab-work, lab-review, lab-talk. `agents/`: the reviewer.
11
+ - `src/lab_kit/`: the `lab` command. `record.py` reads a lab and works out every state, `views.py` shows it to the agent, `site.py` draws it for the operator inside folio, `write.py` and `runs.py` change it, `checks.py` checks it.
13
12
 
14
13
  ## The gate
15
14
 
16
15
  ```bash
17
16
  python -m pytest -q
18
- (cd examples/monte-carlo-lab && lab-kit check)
19
17
  ```
20
18
 
21
- The tests, then `lab-kit check` on the example lab. CI runs the same two commands.
19
+ The tests build a small lab with the command itself and take it from a question to a reviewed result.
22
20
 
23
21
  ## Rules
24
22
 
25
- - folio owns documents. lab-kit writes none, adds no genres and no journal kinds, and uses the lab pack's names exactly.
26
- - A check is added to `docs/spec/lab-model.md` §5, the registry in `src/lab_kit/checks/run.py` and a failing test in the same change.
27
- - The example lab's run evidence, lock record and run record are never edited by hand.
23
+ - The model wins. Change `docs/model.md` first, then the code, the method and the skills, in the same change.
24
+ - A rule a command holds is in `docs/model.md`, in the code and in a test together, with a case that it refuses.
25
+ - A command validates before it writes, and says what it wrote. No command writes a computed view into a lab.
28
26
  - Never `git add -A`. Add the files you touched.
29
27
 
30
28
  <!-- ops:lanes:start (generated from the owner's central rules; change them there, not here) -->
@@ -1,5 +1,123 @@
1
1
  # Changelog
2
2
 
3
+ ## 1.0.1
4
+
5
+ Three defects found by moving a real repository to 1.0.0, and one message.
6
+
7
+ - `lab check` reads the history of the lab's own record only: `log.md`, `resources.toml`,
8
+ `decisions/`, and each experiment's lock, runs, results and reviews under `goals/`. It used to
9
+ read every file with one of those names anywhere in the repository, so a repository that once held
10
+ an older layout, since removed, failed for ever with "was committed and is gone".
11
+ - A file of the record is known by the numbers in its path. A folder or a decision renamed after a
12
+ reworded title is the same record: the rename is no longer reported as a removal, and what was
13
+ committed under the old name is still held under the new one. A file moved to another number, or
14
+ out of the record's places, is reported as gone.
15
+ - The hash of `plan/` leaves out `__pycache__` folders and `*.pyc` files, as it always meant to.
16
+ Importing a script from `plan/` no longer makes `lab check` say the plan changed after the run.
17
+ The hash of a folder that holds neither is what it was, in both formats, so every existing lock,
18
+ run and review still verifies.
19
+ - A card's `see:` that names a page of another library is a note, not a problem, when that
20
+ library's folder is not on the machine, as in CI. With `--strict` it is a failure. When the folder
21
+ is there and the page is not, it is still a problem.
22
+ - `lab run` says that the resources changed when `uses:` is not what was locked. It used to say the
23
+ demand had changed.
24
+
25
+ ## 1.0.0
26
+
27
+ A rewrite from first principles. Nothing of 0.6 carries over: a lab kept with 0.6 is not read by 1.0,
28
+ and no command converts one. `docs/model.md` is the contract, and its section 8 sets the old model
29
+ beside the new.
30
+
31
+ What a lab is
32
+
33
+ - One tree. A goal holds questions. A question holds its steps, of three kinds: an experiment (a
34
+ comparison with its bars set in advance), a build (something an experiment needs that has to be
35
+ made first) and a reading (a look at what already exists, which suggests and never confirms). An
36
+ experiment holds its runs and its results. Every id spells the path: `G1.Q2.3`, and a result is
37
+ `G1.Q2.3:attack-success`.
38
+ - Decisions beside the tree. A decision is something discussed with the operator: what was seen, two
39
+ or three options, a recommendation, then what was decided and why, in the lab's words. Every goal
40
+ and question names the decision it came from.
41
+ - Cards. Each of these is one small Markdown file: front matter, a description, and named slots with
42
+ word budgets. A card never holds an id, a state or an outcome; all three are worked out from the
43
+ record when asked for. Nothing computed is kept in a lab.
44
+ - The files: `lab.toml`, `resources.toml`, `log.md`, `GLOSSARY.md`, `goals/`, `decisions/`, and
45
+ `runs/` outside git. Missions, protocols, attempts, budgets, ledgers and the folio documents that
46
+ held the record are gone.
47
+
48
+ How a number counts
49
+
50
+ - write the card, lock, run, result, review. Each step is a command that refuses when the one before
51
+ it is missing.
52
+ - An experiment says what it compares, each arm, its cases, and its confirmed-if and refuted-if
53
+ lines, each a sentence and the one result it tests (`attack-success < 0.05`). The outcome
54
+ (confirmed, refuted, unclear) is worked out from those lines and the results, never written.
55
+ - The lock holds what the experiment demands: the comparison, the arms, the cases, the lines, what
56
+ each outcome would mean, and the limits. That never changes. A changed demand, a failed results
57
+ review or a partial score is a new experiment that replaces the old one and says why. The lock
58
+ also records `plan/` as it was locked.
59
+ - An experiment is run until one run finishes. Each run pins the `plan/` folder it ran (the
60
+ configuration and the code, as files and no links). When `plan/` is not what the run before ran,
61
+ or for the first run what was locked, the run says what changed and why: `lab run --changed`.
62
+ The first run that finishes is the only source of results, nothing more runs under that
63
+ experiment, and its `plan/` stays as it ran.
64
+ - A run is detached, sealed when its command exits (every file's hash, and one over the record) and
65
+ moved into the store. A trial run comes before the lock and never gives a result.
66
+ - Every run is listed in `runs.tsv`, in git beside the lock: a row when it starts, a row with its
67
+ seal when it ends. The store is outside git, so this list is what says a run existed: a run
68
+ removed from the store, or a record rewritten, fails `lab check`, and a clone without the store
69
+ still knows what ran. A run that started and whose folder is gone for good is declared lost,
70
+ with the reason: `lab runs lost`.
71
+ - What git holds is tamper-evident from the commit that first holds it, not before: the lock is
72
+ committed when it is made and a run's row when it starts. `lab now` and `lab check` say what is
73
+ not committed yet.
74
+ - A result is a row in `results.tsv`: a name, a plain label, a value, how it reads, what it is
75
+ compared with, and the command that prints it again from the sealed run. `lab check` runs every
76
+ command again. A card names a result (`{attack-success}`) and never types its number.
77
+ - One review, after the results, by a session that did not do the work. A second, of the plan, only
78
+ before a run that uses a metered resource. A failed results review is final for that experiment.
79
+
80
+ Who decides
81
+
82
+ - The operator decides direction (the goals and the questions) and resources, in a discussion
83
+ recorded as a decision, not by approving requests. What a decision settles needs no further yes.
84
+ The agent decides everything else and records each choice in the log. A settled decision is
85
+ never reworded. A question is answered with `lab answer`, on a finished experiment.
86
+ - Resources are set once for the lab in `resources.toml`: what each is, where its key is kept, for a
87
+ metered one its unit, grant and amount for one run, and its rules as plain sentences. `lab run`
88
+ refuses a run that would pass the amounts; an experiment may carry an override, which is a
89
+ resource and a cap. A metered resource names the settled decision that set its amounts (`from`),
90
+ which lists it under `about:`, and an amount changes only together with it. A resource is never
91
+ removed, only retired, and use outside a run is a list that only grows.
92
+
93
+ The command, the method and the site
94
+
95
+ - One command, `lab` (`lab-kit` still starts it), with fifteen commands: `now`, `show`, `brief`,
96
+ `since` and `define` to look; `new`, `log`, `decide` and `answer` to write; `lock`, `run`, `runs`,
97
+ `review` and `check` for evidence; `init` once.
98
+ - One log, `log.md`, with five kinds of line: a decision recorded, a choice of the agent's, a
99
+ result, something stuck, and what the agent is starting on now (`doing`). The `doing` line is how
100
+ the operator sees that the lab is alive without asking.
101
+ - `lab check` holds what can be held mechanically: ids and links, card budgets and front matter,
102
+ a test on every line, unchanged locks, listed and sealed runs, results that re-derive and were
103
+ reviewed, use inside the resources' amounts, a decision behind every goal, question and amount,
104
+ the installed method and skills, and a history that only grows. It runs the commands in
105
+ `results.tsv`, so it is for a lab you trust. `--strict` fails when history or the store could not
106
+ be checked, which is what CI wants.
107
+ - A lab that is not written as the model says (a mistyped folder, a list written as one value, a
108
+ file that is not text) is reported by `lab check`, and stops no command and no page. Commands
109
+ validate everything before they write, and one writes at a time.
110
+ - The method is seven rules in one file, `method/METHOD.md`. Four skills (lab-set-up, lab-work,
111
+ lab-review, lab-talk) and one role (the reviewer). `lab init` installs them into a lab.
112
+ - The site is drawn by `lab_kit.site` inside folio, from the record, at each request. It needs
113
+ `folio-kb` 0.5.0 or later, as the optional extra `lab-kit-cli[site]`. The command itself depends
114
+ only on `pyyaml` (and `tomli` on Python 3.10), and needs Python 3.10 or later.
115
+
116
+ ## 0.6.4
117
+
118
+ - `lab-append-only` accepts a recorded correction. `.lab/corrections.tsv` lists `path<TAB>commit<TAB>reason` for a commit that edited a mission log, a budget or a lock record in place and was later put right. That commit's version is left out of the file's history, so the versions before and after it must still show the file only growing, and the file's current version is never a listed one. The list is committed, so every waiver keeps its reason on the record.
119
+ - `lab-roster-frozen` compares a run's `config` with its protocol's pinned configuration as the run records it, through JSON. YAML reads a key such as `1:` as an integer and `run.json` holds it as the string `"1"`, so a run that used exactly its pinned configuration was reported as differing.
120
+
3
121
  ## 0.6.3
4
122
 
5
123
  - A mission runs to its conclusion with no further input from the operator. The approval launches it: plan-mission hands it to run-mission at once, with no separate "go". A running mission never waits for an answer. A few lines it never crosses (new money, a credential, publishing outside the lab, a change to a frozen surface, anything irreversible outside git) unless its approved plan names the exact step; work that reaches one is recorded as blocked, and the mission carries on and concludes with it open for the next mission. plan-mission settles those lines in the plan instead of naming points where the run comes back to the operator.
@@ -0,0 +1,37 @@
1
+ # Contributing
2
+
3
+ ## Set up
4
+
5
+ ```bash
6
+ python3 -m venv .venv
7
+ .venv/bin/pip install -e '.[dev,site]'
8
+ ```
9
+
10
+ Python 3.10 or later. The `site` extra brings folio (`folio-kb` 0.5.0 or later), which only the
11
+ site's tests need; with a checkout of folio beside this one, `pip install -e ../folio` instead.
12
+ Without folio, `tests/test_site.py` skips itself and the rest runs; CI sets `LAB_SITE_TESTS=required`,
13
+ so there it never skips.
14
+
15
+ ## The gate
16
+
17
+ ```bash
18
+ python -m pytest -q
19
+ ```
20
+
21
+ The tests build a small lab with the `lab` command itself and take it from a decision to a reviewed
22
+ result. CI runs them on Python 3.10 and 3.12, then builds the wheel, installs it alone and runs
23
+ `lab init` and `lab check` in an empty folder.
24
+
25
+ ## How a change lands
26
+
27
+ - The contract is `docs/model.md`. Change it first, then the code, the method and the skills, in the
28
+ same change.
29
+ - A rule a command holds is in `docs/model.md`, in the code and in a test together, and the test has
30
+ a case that the command refuses.
31
+ - A command validates before it writes, and says what it wrote. No command writes a computed view
32
+ into a lab.
33
+ - The method, the skills and the reviewer role ship inside the package. A lab gets a new version of
34
+ them from `lab init`, never by hand, and `lab check` fails while they differ.
35
+ - Write plain words in short sentences. Name no particular project, person or organisation in the
36
+ docs or the code.
37
+ - Fail loud. A problem lab-kit cannot work around is an error with a message that says what to do.
@@ -0,0 +1,77 @@
1
+ Metadata-Version: 2.5
2
+ Name: lab-kit-cli
3
+ Version: 1.0.1
4
+ Summary: A research lab's record, its method, and the command that keeps both.
5
+ Project-URL: Homepage, https://github.com/pierg/lab-kit
6
+ Project-URL: Issues, https://github.com/pierg/lab-kit/issues
7
+ Author: Piergiuseppe Mallozzi
8
+ License-Expression: MIT
9
+ License-File: LICENSE
10
+ Requires-Python: >=3.10
11
+ Requires-Dist: pyyaml
12
+ Requires-Dist: tomli; python_version < '3.11'
13
+ Provides-Extra: dev
14
+ Requires-Dist: pytest; extra == 'dev'
15
+ Provides-Extra: site
16
+ Requires-Dist: folio-kb>=0.5.0; extra == 'site'
17
+ Description-Content-Type: text/markdown
18
+
19
+ # lab-kit
20
+
21
+ lab-kit keeps a research lab that coding agents work in. It fixes what the lab's record looks like,
22
+ the method that makes a number count, and one command, `lab`, that both keeps the rules and shows
23
+ the lab to an agent a level at a time. [folio](https://github.com/pierg/folio) serves the same
24
+ record to the operator as a live site: `lab_kit.site` draws the pages, and nothing is generated.
25
+
26
+ ## Two readers
27
+
28
+ - **The operator** decides direction and resources, in conversation with the agent, and reads the
29
+ lab as a site. Nothing else reaches them.
30
+ - **The agent** plans, builds, runs and records, and decides everything else.
31
+
32
+ ## One tree
33
+
34
+ ```
35
+ Goal what the lab wants to be able to say
36
+ Question a yes-or-no question: what we expect, what would prove us wrong, what we know so far
37
+ Build something an experiment needs that has to be made first
38
+ Reading a look at what already exists: it suggests, and never confirms
39
+ Experiment what is compared, what would confirm, what would refute; then what was found
40
+ Run one try at producing what the experiment demands; the first that finishes counts
41
+ Result one number from that run, with the command that prints it again
42
+ Decision something discussed with the operator: what was seen, the options, what was decided and why
43
+ ```
44
+
45
+ Every id spells the path: `G1.Q2.3`. Cards are small and written for the operator. Nothing computed is
46
+ kept: every state, and an experiment's outcome, is worked out from the record when it is asked for.
47
+
48
+ ## How a number counts
49
+
50
+ ```
51
+ write the card -> lock -> run -> result -> review -> the number may be used on a card
52
+ ```
53
+
54
+ Each arrow is a command that refuses when the step before it is missing. An experiment's lines, each
55
+ with the result it tests, are locked before its run. The first run that finishes is the only source
56
+ of its results. The reviewer is a separate session that did not do the work. Every run is listed in a file
57
+ that git keeps, so one cannot be removed or rewritten quietly.
58
+
59
+ ## Install
60
+
61
+ ```text
62
+ uv tool install lab-kit-cli
63
+ lab init
64
+ ```
65
+
66
+ Then ask your agent to follow `.agents/skills/lab-set-up/SKILL.md`. `lab --help` lists the fifteen
67
+ commands.
68
+
69
+ The command needs Python 3.10 or later and nothing of folio. The site does: install `lab-kit-cli[site]`
70
+ where folio serves the lab, which brings `folio-kb` 0.5.0 or later, and list `lab_kit.site` under
71
+ `views:` in the charter of the lab's `docs/` library.
72
+
73
+ ## Read more
74
+
75
+ - [docs/model.md](https://github.com/pierg/lab-kit/blob/main/docs/model.md): the contract. What you read, how a number becomes a result, who decides, the commands, the files.
76
+ - [method/METHOD.md](https://github.com/pierg/lab-kit/blob/main/method/METHOD.md): the seven rules every lab keeps.
77
+ - [skills/](https://github.com/pierg/lab-kit/blob/main/skills/): lab-set-up, lab-work, lab-review and lab-talk. [agents/](https://github.com/pierg/lab-kit/blob/main/agents/): the reviewer.
@@ -0,0 +1,59 @@
1
+ # lab-kit
2
+
3
+ lab-kit keeps a research lab that coding agents work in. It fixes what the lab's record looks like,
4
+ the method that makes a number count, and one command, `lab`, that both keeps the rules and shows
5
+ the lab to an agent a level at a time. [folio](https://github.com/pierg/folio) serves the same
6
+ record to the operator as a live site: `lab_kit.site` draws the pages, and nothing is generated.
7
+
8
+ ## Two readers
9
+
10
+ - **The operator** decides direction and resources, in conversation with the agent, and reads the
11
+ lab as a site. Nothing else reaches them.
12
+ - **The agent** plans, builds, runs and records, and decides everything else.
13
+
14
+ ## One tree
15
+
16
+ ```
17
+ Goal what the lab wants to be able to say
18
+ Question a yes-or-no question: what we expect, what would prove us wrong, what we know so far
19
+ Build something an experiment needs that has to be made first
20
+ Reading a look at what already exists: it suggests, and never confirms
21
+ Experiment what is compared, what would confirm, what would refute; then what was found
22
+ Run one try at producing what the experiment demands; the first that finishes counts
23
+ Result one number from that run, with the command that prints it again
24
+ Decision something discussed with the operator: what was seen, the options, what was decided and why
25
+ ```
26
+
27
+ Every id spells the path: `G1.Q2.3`. Cards are small and written for the operator. Nothing computed is
28
+ kept: every state, and an experiment's outcome, is worked out from the record when it is asked for.
29
+
30
+ ## How a number counts
31
+
32
+ ```
33
+ write the card -> lock -> run -> result -> review -> the number may be used on a card
34
+ ```
35
+
36
+ Each arrow is a command that refuses when the step before it is missing. An experiment's lines, each
37
+ with the result it tests, are locked before its run. The first run that finishes is the only source
38
+ of its results. The reviewer is a separate session that did not do the work. Every run is listed in a file
39
+ that git keeps, so one cannot be removed or rewritten quietly.
40
+
41
+ ## Install
42
+
43
+ ```text
44
+ uv tool install lab-kit-cli
45
+ lab init
46
+ ```
47
+
48
+ Then ask your agent to follow `.agents/skills/lab-set-up/SKILL.md`. `lab --help` lists the fifteen
49
+ commands.
50
+
51
+ The command needs Python 3.10 or later and nothing of folio. The site does: install `lab-kit-cli[site]`
52
+ where folio serves the lab, which brings `folio-kb` 0.5.0 or later, and list `lab_kit.site` under
53
+ `views:` in the charter of the lab's `docs/` library.
54
+
55
+ ## Read more
56
+
57
+ - [docs/model.md](docs/model.md): the contract. What you read, how a number becomes a result, who decides, the commands, the files.
58
+ - [method/METHOD.md](method/METHOD.md): the seven rules every lab keeps.
59
+ - [skills/](skills/): lab-set-up, lab-work, lab-review and lab-talk. [agents/](agents/): the reviewer.
@@ -0,0 +1,11 @@
1
+ ---
2
+ name: reviewer
3
+ description: >-
4
+ Reads one experiment's plan or results with fresh context and records a verdict. Use for every
5
+ results review, and for a plan review before a run that uses a metered resource. Give it only
6
+ the experiment's id and the stage. Never use it in the session that did the work.
7
+ ---
8
+
9
+ You review one experiment. You did not plan it, build it or run it, and you were told nothing about
10
+ it except its id and the stage. Follow `.agents/skills/lab-review/SKILL.md`. Write nothing in the lab
11
+ except your verdict, through `lab review`.