@cbartens/bkit 5.5.1 → 6.1.0

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 (425) hide show
  1. package/.bkit/README.md +167 -154
  2. package/.bkit/core/.agents/context.md +95 -29
  3. package/.bkit/core/.agents/docs.md +18 -15
  4. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
  5. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
  6. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
  7. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
  8. package/.bkit/core/.agents/rules.md +112 -102
  9. package/.bkit/core/.agents/skills.md +63 -15
  10. package/.bkit/core/.bkit/README.md +167 -154
  11. package/.bkit/core/.bkit/authoring.md +747 -0
  12. package/.bkit/core/.bkit/cli.md +407 -0
  13. package/.bkit/core/.bkit/cloud.md +283 -195
  14. package/.bkit/core/.bkit/comparison.md +45 -43
  15. package/.bkit/core/.bkit/install.md +166 -95
  16. package/.bkit/core/.bkit/jsonl.md +339 -196
  17. package/.bkit/core/.bkit/pipeline.md +142 -145
  18. package/.bkit/core/.bkit/prompts.md +295 -264
  19. package/.bkit/core/.bkit/providers.md +460 -277
  20. package/.bkit/core/.bkit/router.md +69 -0
  21. package/.bkit/core/.bkit/templates.md +530 -256
  22. package/.bkit/core/.bkit/trackers.md +116 -65
  23. package/.bkit/core/.bkit/workflows.md +742 -618
  24. package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
  25. package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
  26. package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
  27. package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
  28. package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
  29. package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
  30. package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
  31. package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
  32. package/.bkit/core/AGENTS.md +6 -80
  33. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +128 -130
  34. package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -94
  35. package/.bkit/core/docs/templates/bkit-audit-agents.md +96 -98
  36. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +100 -103
  37. package/.bkit/core/docs/templates/bkit-audit-analytics.md +141 -107
  38. package/.bkit/core/docs/templates/bkit-audit-annotations.md +99 -97
  39. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +122 -121
  40. package/.bkit/core/docs/templates/bkit-audit-app-store.md +158 -101
  41. package/.bkit/core/docs/templates/bkit-audit-architecture.md +114 -96
  42. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +76 -97
  43. package/.bkit/core/docs/templates/bkit-audit-config.md +123 -101
  44. package/.bkit/core/docs/templates/bkit-audit-cost.md +86 -99
  45. package/.bkit/core/docs/templates/bkit-audit-coverage.md +76 -93
  46. package/.bkit/core/docs/templates/bkit-audit-database.md +102 -95
  47. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +165 -108
  48. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -109
  49. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +265 -113
  50. package/.bkit/core/docs/templates/bkit-audit-documentation.md +119 -118
  51. package/.bkit/core/docs/templates/bkit-audit-duplication.md +140 -111
  52. package/.bkit/core/docs/templates/bkit-audit-failures.md +111 -106
  53. package/.bkit/core/docs/templates/bkit-audit-flakes.md +100 -99
  54. package/.bkit/core/docs/templates/bkit-audit-gates.md +107 -103
  55. package/.bkit/core/docs/templates/bkit-audit-issues.md +105 -105
  56. package/.bkit/core/docs/templates/bkit-audit-llm.md +134 -85
  57. package/.bkit/core/docs/templates/bkit-audit-logs.md +124 -125
  58. package/.bkit/core/docs/templates/bkit-audit-models.md +99 -78
  59. package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -76
  60. package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -78
  61. package/.bkit/core/docs/templates/bkit-audit-red-team.md +125 -93
  62. package/.bkit/core/docs/templates/bkit-audit-reliability.md +97 -96
  63. package/.bkit/core/docs/templates/bkit-audit-repo.md +170 -98
  64. package/.bkit/core/docs/templates/bkit-audit-security.md +207 -121
  65. package/.bkit/core/docs/templates/bkit-audit-slop.md +78 -95
  66. package/.bkit/core/docs/templates/bkit-audit-testing.md +163 -139
  67. package/.bkit/core/docs/templates/bkit-audit-usability.md +114 -96
  68. package/.bkit/core/docs/templates/bkit-plan.md +158 -281
  69. package/.bkit/core/engine/checks/after/auth.ts +40 -37
  70. package/.bkit/core/engine/checks/after/ci-yml.ts +104 -31
  71. package/.bkit/core/engine/checks/after/github.ts +95 -17
  72. package/.bkit/core/engine/checks/after/index.ts +21 -8
  73. package/.bkit/core/engine/checks/after/suppression.ts +8 -5
  74. package/.bkit/core/engine/checks/after/tools.ts +125 -123
  75. package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
  76. package/.bkit/core/engine/checks/before/env.ts +3 -3
  77. package/.bkit/core/engine/checks/before/files.ts +5 -4
  78. package/.bkit/core/engine/checks/before/index.ts +25 -1
  79. package/.bkit/core/engine/checks/before/repo.ts +208 -2
  80. package/.bkit/core/engine/checks/status-holes.ts +916 -123
  81. package/.bkit/core/engine/checks/tips/catalogue.ts +82 -20
  82. package/.bkit/core/engine/checks/tips/detect.ts +66 -0
  83. package/.bkit/core/engine/checks/tips/index.ts +52 -11
  84. package/.bkit/core/engine/cli.ts +251 -130
  85. package/.bkit/core/engine/commands/analysis.ts +282 -199
  86. package/.bkit/core/engine/commands/ci/ci.ts +363 -29
  87. package/.bkit/core/engine/commands/ci/pins.ts +172 -0
  88. package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
  89. package/.bkit/core/engine/commands/comply.ts +77 -103
  90. package/.bkit/core/engine/commands/install/doctor.ts +2 -2
  91. package/.bkit/core/engine/commands/install/install.ts +57 -18
  92. package/.bkit/core/engine/commands/install/uninstall.ts +86 -55
  93. package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
  94. package/.bkit/core/engine/commands/land.ts +139 -18
  95. package/.bkit/core/engine/commands/lib.ts +381 -22
  96. package/.bkit/core/engine/commands/registry.ts +10 -2
  97. package/.bkit/core/engine/commands/setup/setup.ts +8 -7
  98. package/.bkit/core/engine/commands/stats.ts +260 -0
  99. package/.bkit/core/engine/commands/tips.ts +10 -5
  100. package/.bkit/core/engine/commands/workflow/branches.ts +2215 -176
  101. package/.bkit/core/engine/commands/workflow/challenge.ts +748 -0
  102. package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
  103. package/.bkit/core/engine/commands/workflow/context.ts +1249 -47
  104. package/.bkit/core/engine/commands/workflow/counters.ts +483 -95
  105. package/.bkit/core/engine/commands/workflow/decisions.ts +585 -0
  106. package/.bkit/core/engine/commands/workflow/disk.ts +238 -56
  107. package/.bkit/core/engine/commands/workflow/fids.ts +811 -33
  108. package/.bkit/core/engine/commands/workflow/issues.ts +413 -64
  109. package/.bkit/core/engine/commands/workflow/ledgers.ts +1333 -36
  110. package/.bkit/core/engine/commands/workflow/locks.ts +28 -2
  111. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +691 -0
  112. package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
  113. package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
  114. package/.bkit/core/engine/commands/workflow/prs.ts +178 -33
  115. package/.bkit/core/engine/commands/workflow/repo.ts +66 -8
  116. package/.bkit/core/engine/commands/workflow/roadmap.ts +72 -22
  117. package/.bkit/core/engine/commands/workflow/run-facts.ts +492 -0
  118. package/.bkit/core/engine/commands/workflow/runs.ts +827 -79
  119. package/.bkit/core/engine/commands/workflow/runtime.ts +25 -1
  120. package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
  121. package/.bkit/core/engine/commands/workflow/status.ts +329 -33
  122. package/.bkit/core/engine/commands/workflow/step-table.ts +381 -0
  123. package/.bkit/core/engine/commands/workflow/steps.ts +841 -105
  124. package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
  125. package/.bkit/core/engine/commands/workflow/summary.ts +544 -0
  126. package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
  127. package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
  128. package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
  129. package/.bkit/core/engine/commands/workflow/tests.ts +2124 -330
  130. package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
  131. package/.bkit/core/engine/commands/workflow/workflows.ts +1197 -235
  132. package/.bkit/core/engine/commands/workflow/worktrees.ts +543 -24
  133. package/.bkit/core/engine/install/cloud-env.ts +251 -121
  134. package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
  135. package/.bkit/core/engine/install/manifest.ts +67 -17
  136. package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
  137. package/.bkit/core/engine/install/modules/cloud.ts +24 -16
  138. package/.bkit/core/engine/install/modules/codex.ts +15 -2
  139. package/.bkit/core/engine/install/modules/core.ts +1196 -45
  140. package/.bkit/core/engine/install/modules/cursor.ts +6 -6
  141. package/.bkit/core/engine/install/modules/opencode.ts +18 -6
  142. package/.bkit/core/engine/install/template-notes.ts +130 -0
  143. package/.bkit/core/engine/install/version-file.ts +9 -4
  144. package/.bkit/core/engine/install/write.ts +5 -0
  145. package/.bkit/core/engine/ledgers/compact.ts +124 -0
  146. package/.bkit/core/engine/ledgers/journal.ts +291 -0
  147. package/.bkit/core/engine/ledgers/migrate.ts +92 -0
  148. package/.bkit/core/engine/ledgers/status.ts +249 -21
  149. package/.bkit/core/engine/ledgers/telemetry.ts +1397 -253
  150. package/.bkit/core/engine/render/hosts.ts +118 -14
  151. package/.bkit/core/engine/render/models.ts +12 -0
  152. package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
  153. package/.bkit/core/engine/shared/branches.ts +4 -1
  154. package/.bkit/core/engine/shared/dep-updater.ts +60 -0
  155. package/.bkit/core/engine/shared/egress.ts +8 -1
  156. package/.bkit/core/engine/shared/json.ts +25 -7
  157. package/.bkit/core/engine/shared/package-manager.ts +9 -0
  158. package/.bkit/core/engine/shared/settings.ts +243 -31
  159. package/.bkit/core/engine/shared/text.ts +361 -0
  160. package/.bkit/core/engine/shared/timeouts.ts +2 -0
  161. package/.bkit/core/engine/tools/cli-doc.ts +111 -0
  162. package/.bkit/core/engine/tools/grammar-density.ts +215 -0
  163. package/.bkit/core/engine/tools/instructions-sources.ts +832 -0
  164. package/.bkit/core/engine/tools/instructions.ts +1802 -0
  165. package/.bkit/core/hooks/antigravity-hook.js +25 -10
  166. package/.bkit/core/hooks/gateguard-engine.js +54 -29
  167. package/.bkit/core/hooks/guardrails-shell.js +4 -5
  168. package/.bkit/core/hooks/guardrails-tiers.js +10 -4
  169. package/.bkit/core/hooks/preflight-linear.sh +9 -9
  170. package/.bkit/core/hooks/preflight-rules.sh +8 -0
  171. package/.bkit/core/hooks/readguard-engine.js +29 -10
  172. package/.bkit/core/hooks/session-rules-advisory.js +61 -0
  173. package/.bkit/core/prompts/bkit-audit-generate.md +202 -94
  174. package/.bkit/core/prompts/bkit-build-challenge-1.md +76 -34
  175. package/.bkit/core/prompts/bkit-build-challenge-2.md +85 -38
  176. package/.bkit/core/prompts/bkit-build-install-skills.md +50 -28
  177. package/.bkit/core/prompts/bkit-build-plan-convert.md +85 -0
  178. package/.bkit/core/prompts/bkit-build-plan-current.md +59 -36
  179. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +101 -36
  180. package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
  181. package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
  182. package/.bkit/core/prompts/bkit-build-plan-verify.md +104 -43
  183. package/.bkit/core/prompts/bkit-debug-abort-handover.md +47 -32
  184. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +109 -57
  185. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +65 -39
  186. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +53 -31
  187. package/.bkit/core/prompts/bkit-debug-failure-soak.md +65 -34
  188. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +46 -31
  189. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +45 -31
  190. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +43 -30
  191. package/.bkit/core/prompts/bkit-design-generate.md +80 -46
  192. package/.bkit/core/prompts/bkit-design-organise.md +83 -32
  193. package/.bkit/core/prompts/bkit-design-review-1.md +70 -50
  194. package/.bkit/core/prompts/bkit-design-review-2.md +65 -46
  195. package/.bkit/core/prompts/bkit-design-spike.md +64 -40
  196. package/.bkit/core/prompts/bkit-design-update.md +53 -28
  197. package/.bkit/core/prompts/bkit-plan-generate.md +101 -29
  198. package/.bkit/core/prompts/bkit-plan-review-1.md +78 -41
  199. package/.bkit/core/prompts/bkit-plan-review-2.md +78 -35
  200. package/.bkit/core/prompts/bkit-plan-scope-check.md +116 -0
  201. package/.bkit/core/prompts/bkit-plan-update.md +86 -31
  202. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +94 -50
  203. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +91 -41
  204. package/.bkit/core/prompts/bkit-ship-update-docs.md +45 -24
  205. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +65 -49
  206. package/.bkit/core/prompts/bkit-utility-update-decisions.md +87 -42
  207. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +81 -37
  208. package/.bkit/core/prompts/bkit-utility-update-documentation.md +43 -25
  209. package/.bkit/core/prompts/bkit-utility-update-failures.md +84 -37
  210. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +88 -42
  211. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +92 -39
  212. package/.bkit/core/prompts/bkit-utility-update-tracker.md +159 -60
  213. package/.bkit/core/workflows/bkit-auto.md +89 -58
  214. package/.bkit/core/workflows/bkit-build.md +967 -517
  215. package/.bkit/core/workflows/bkit-debug.md +555 -387
  216. package/.bkit/core/workflows/bkit-design.md +319 -283
  217. package/.bkit/core/workflows/bkit-plan.md +319 -342
  218. package/.bkit/core/workflows/bkit-ship.md +525 -328
  219. package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
  220. package/.bkit/shared/.bkit/.env.example +2 -2
  221. package/.bkit/shared/.claude/bkit-cloud.md +12 -10
  222. package/.bkit/shared/.claude/settings.json +14 -0
  223. package/.bkit/shared/.codex/bkit-cloud.md +98 -0
  224. package/.bkit/shared/.codex/hooks.json +20 -0
  225. package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
  226. package/.bkit/shared/.cursor/mcp.json +1 -1
  227. package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
  228. package/.bkit/shared/.gitattributes +1 -1
  229. package/.bkit/shared/.mcp.json +1 -1
  230. package/.bkit/shared/.opencode/opencode.json +12 -1
  231. package/.bkit/shared/CLAUDE.md +6 -2
  232. package/.bkit/shared/GEMINI.md +5 -2
  233. package/.bkit/shared/docs/architecture.md +4 -7
  234. package/.bkit/shared/docs/data-schema.md +4 -7
  235. package/.bkit/shared/docs/deployments.md +241 -168
  236. package/.bkit/shared/docs/design.md +11 -12
  237. package/.bkit/shared/docs/noise.md +8 -7
  238. package/.bkit/shared/docs/observability.md +5 -8
  239. package/.bkit/shared/docs/security.md +35 -17
  240. package/.bkit/shared/docs/setup.md +29 -18
  241. package/.bkit/shared/docs/technology.md +3 -6
  242. package/.bkit/shared/docs/testing.md +289 -174
  243. package/.bkit/shared/gitignore +6 -2
  244. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
  245. package/.bkit/templates/.cursor/Dockerfile +12 -8
  246. package/.bkit/templates/.cursor/environment.json +1 -1
  247. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
  248. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +45 -12
  249. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
  250. package/.bkit/templates/.github/renovate.json5 +34 -6
  251. package/.bkit/templates/.github/workflows/bkit-ci.yml +54 -51
  252. package/.bkit/templates/.github/workflows/bkit-cloud.yml +34 -33
  253. package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
  254. package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
  255. package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
  256. package/.bkit/templates/.husky/pre-commit +2 -2
  257. package/.bkit/templates/.husky/pre-push +96 -36
  258. package/.bkit/templates/.prettierignore +6 -0
  259. package/.bkit/templates/.vale.ini +27 -27
  260. package/.bkit/templates/context/bkit-cloudrun.md +23 -15
  261. package/.bkit/templates/context/bkit-expo.md +70 -52
  262. package/.bkit/templates/context/bkit-github.md +93 -56
  263. package/.bkit/templates/context/bkit-inngest.md +21 -15
  264. package/.bkit/templates/context/bkit-maestro.md +22 -16
  265. package/.bkit/templates/context/bkit-playwright.md +23 -17
  266. package/.bkit/templates/context/bkit-resend.md +12 -10
  267. package/.bkit/templates/context/bkit-sentry.md +30 -20
  268. package/.bkit/templates/context/bkit-serena.md +8 -7
  269. package/.bkit/templates/context/bkit-stripe.md +14 -13
  270. package/.bkit/templates/context/bkit-supabase.md +16 -13
  271. package/.bkit/templates/context/bkit-tavily.md +14 -11
  272. package/.bkit/templates/context/bkit-vercel.md +27 -18
  273. package/.bkit/templates/docs/capabilities.md +15 -14
  274. package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
  275. package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
  276. package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
  277. package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
  278. package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
  279. package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
  280. package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
  281. package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
  282. package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
  283. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
  284. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
  285. package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +10 -2
  286. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
  287. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
  288. package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
  289. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
  290. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
  291. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
  292. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
  293. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
  294. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
  295. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
  296. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
  297. package/.bkit/templates/slop-scan.config.json +9 -2
  298. package/CHANGELOG.md +231 -0
  299. package/README.md +278 -89
  300. package/dist/checks/after/auth.js +36 -33
  301. package/dist/checks/after/ci-yml.js +91 -30
  302. package/dist/checks/after/github.js +91 -17
  303. package/dist/checks/after/index.js +22 -11
  304. package/dist/checks/after/suppression.js +8 -5
  305. package/dist/checks/after/tools.js +111 -114
  306. package/dist/checks/before/context-fetch.js +218 -33
  307. package/dist/checks/before/env.js +3 -3
  308. package/dist/checks/before/files.js +5 -3
  309. package/dist/checks/before/index.js +20 -3
  310. package/dist/checks/before/repo.js +197 -2
  311. package/dist/checks/status-holes.js +739 -114
  312. package/dist/checks/tips/catalogue.js +70 -19
  313. package/dist/checks/tips/detect.js +62 -0
  314. package/dist/checks/tips/index.js +51 -9
  315. package/dist/cli.js +234 -124
  316. package/dist/commands/analysis.js +174 -141
  317. package/dist/commands/ci/ci.js +302 -25
  318. package/dist/commands/ci/pins.js +142 -0
  319. package/dist/commands/ci/push-gate.js +194 -0
  320. package/dist/commands/comply.js +54 -91
  321. package/dist/commands/install/doctor.js +2 -2
  322. package/dist/commands/install/install.js +50 -19
  323. package/dist/commands/install/uninstall.js +82 -55
  324. package/dist/commands/install/upgrade.js +21 -11
  325. package/dist/commands/land.js +137 -17
  326. package/dist/commands/lib.js +295 -21
  327. package/dist/commands/registry.js +10 -2
  328. package/dist/commands/setup/setup.js +8 -7
  329. package/dist/commands/stats.js +175 -0
  330. package/dist/commands/tips.js +7 -3
  331. package/dist/commands/workflow/branches.js +1873 -152
  332. package/dist/commands/workflow/challenge.js +609 -0
  333. package/dist/commands/workflow/completeness.js +97 -0
  334. package/dist/commands/workflow/context.js +1045 -46
  335. package/dist/commands/workflow/counters.js +385 -86
  336. package/dist/commands/workflow/decisions.js +484 -0
  337. package/dist/commands/workflow/disk.js +214 -56
  338. package/dist/commands/workflow/fids.js +706 -33
  339. package/dist/commands/workflow/issues.js +349 -59
  340. package/dist/commands/workflow/ledgers.js +1123 -37
  341. package/dist/commands/workflow/locks.js +26 -2
  342. package/dist/commands/workflow/plan-blocks.js +501 -0
  343. package/dist/commands/workflow/plan-versions.js +22 -0
  344. package/dist/commands/workflow/plans.js +205 -0
  345. package/dist/commands/workflow/prs.js +154 -35
  346. package/dist/commands/workflow/repo.js +58 -8
  347. package/dist/commands/workflow/roadmap.js +58 -23
  348. package/dist/commands/workflow/run-facts.js +421 -0
  349. package/dist/commands/workflow/runs.js +670 -72
  350. package/dist/commands/workflow/runtime.js +15 -1
  351. package/dist/commands/workflow/skills.js +1 -0
  352. package/dist/commands/workflow/status.js +282 -34
  353. package/dist/commands/workflow/step-table.js +308 -0
  354. package/dist/commands/workflow/steps.js +703 -96
  355. package/dist/commands/workflow/summary-findings.js +117 -0
  356. package/dist/commands/workflow/summary.js +388 -0
  357. package/dist/commands/workflow/tasks.js +378 -0
  358. package/dist/commands/workflow/test-blocks.js +231 -0
  359. package/dist/commands/workflow/tests-changed.js +172 -0
  360. package/dist/commands/workflow/tests.js +1695 -305
  361. package/dist/commands/workflow/tracker.js +983 -0
  362. package/dist/commands/workflow/workflows.js +1014 -222
  363. package/dist/commands/workflow/worktrees.js +432 -26
  364. package/dist/install/cloud-env.js +233 -99
  365. package/dist/install/context-ci-workflow.js +85 -0
  366. package/dist/install/manifest.js +64 -17
  367. package/dist/install/modules/antigravity.js +3 -2
  368. package/dist/install/modules/cloud.js +25 -16
  369. package/dist/install/modules/codex.js +12 -2
  370. package/dist/install/modules/core.js +1090 -48
  371. package/dist/install/modules/cursor.js +6 -6
  372. package/dist/install/modules/opencode.js +13 -7
  373. package/dist/install/template-notes.js +116 -0
  374. package/dist/install/version-file.js +9 -4
  375. package/dist/ledgers/compact.js +87 -0
  376. package/dist/ledgers/journal.js +233 -0
  377. package/dist/ledgers/migrate.js +81 -0
  378. package/dist/ledgers/status.js +176 -13
  379. package/dist/ledgers/telemetry.js +1010 -125
  380. package/dist/render/hosts.js +104 -14
  381. package/dist/render/models.js +12 -0
  382. package/dist/shared/bkit-latest.js +26 -4
  383. package/dist/shared/branches.js +3 -1
  384. package/dist/shared/dep-updater.js +49 -0
  385. package/dist/shared/egress.js +8 -1
  386. package/dist/shared/json.js +20 -7
  387. package/dist/shared/package-manager.js +6 -0
  388. package/dist/shared/settings.js +181 -24
  389. package/dist/shared/text.js +333 -0
  390. package/dist/shared/timeouts.js +2 -0
  391. package/dist/tools/cli-doc.js +97 -0
  392. package/dist/tools/grammar-density.js +183 -0
  393. package/dist/tools/instructions-sources.js +720 -0
  394. package/dist/tools/instructions.js +1623 -0
  395. package/package.json +156 -51
  396. package/.bkit/core/.bkit/lite.md +0 -73
  397. package/.bkit/core/engine/commands/harvest.ts +0 -459
  398. package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -166
  399. package/.bkit/core/engine/tools/wording.ts +0 -748
  400. package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
  401. package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
  402. package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
  403. package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -76
  404. package/.bkit/core/prompts/bkit-build-summary.md +0 -94
  405. package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
  406. package/.bkit/core/prompts/bkit-design-summary.md +0 -107
  407. package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
  408. package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
  409. package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
  410. package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
  411. package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
  412. package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
  413. package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
  414. package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
  415. package/dist/commands/harvest.js +0 -353
  416. package/dist/commands/workflow/workstreams.js +0 -143
  417. package/dist/tools/wording.js +0 -680
  418. /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
  419. /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
  420. /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
  421. /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
  422. /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
  423. /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
  424. /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
  425. /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
@@ -3,16 +3,29 @@
3
3
 
4
4
  # Expo EAS — native builds and Workflow e2e runs (Maestro)
5
5
 
6
- Fits: React Native / Expo apps on EAS. `context=runtime` (`expo` block): recent EAS Build status (id, platform, status, profile, commit, error), then the error-level lines of the latest errored builds' logs. `context=e2e` (`expo-workflows` block): for the latest failed EAS Workflow runs (`eas workflow:run`, Maestro) — job status and errors, step-log tails, the per-flow exception for every flow and retry (EAS GraphQL), JUnit, failure screenshot URLs, and from `artifacts.tar.gz` the failing Maestro commands, the view-hierarchy dump list, per-attempt JUnit, the XCUITest runner's own errors and the app's JS console. EAS drains build failures and Workflow runs nowhere else — no host log, no error tracker — so this is the only place they surface.
6
+ Fits: React Native / Expo apps on EAS. EAS sends build failures and Workflow runs nowhere else, neither to a host log nor to an error tracker, so these blocks are the only place they surface.
7
7
 
8
- - Secret: `EXPO_TOKEN` (an EAS access token), in the app's env (e.g. `apps/mobile/.env.local`), not `.bkit/.env`.
9
- - Non-secret: `EXPO_APP_DIR` (the EAS-linked app folder, default `apps/mobile`), both blocks; `expo`: `EAS_PLATFORM`, `EAS_PROFILE`, `EAS_N` (default and max 50, the CLI limit), `EAS_ERR_N`, `EAS_LOG_N`; `expo-workflows`: `EAS_WF_FILE`, `EAS_WF_N` and `EAS_WF_FAIL_N` (each at most 100, the CLI limit), `EAS_WF_ERR_N`, `EAS_JUNIT_N`.
10
- - CLI: `eas` (`eas-cli`); each block's same-named provision block installs it in cloud, self-guarded, so copying both installs once. `expo` also uses `node` to decompress logs.
11
- - Domains: `expo.dev` (both), `googleapis.com` (`expo`), `eascdn.net` (`expo-workflows`); each section carries its own `allowed-domains` block.
12
- - `expo`: build logs are pre-signed, brotli-encoded storage URLs valid ~15 min; macOS curl has no brotli, so the block decompresses with Node zlib and filters the JSON lines with `jq`.
13
- - `expo-workflows`: pair with the `maestro` block (`maestro.md`) when a GitHub Actions job starts the run: that block reads the GitHub job log, this one reads EAS.
14
- - `expo-workflows`: read in this order: per-flow exception (2b), then the XCUITest runner errors (2e) for any `DeviceUnreachableException` — Maestro's iOS driver is an XCUITest case hosting the HTTP server, so one failure inside it fails every later flow. Then the view-hierarchy dump (2d) for any selector or visibility failure: it is the tree Maestro actually searched, and it can contradict a screenshot.
15
- - `expo-workflows`: artifact URLs are pre-signed and expire in ~1 h; EAS keeps the data 90 days. An expired URL means re-run `workflow:status`, not "artifact gone".
8
+ - The `expo` block (`context=runtime`) returns recent EAS Build status (id, platform, status, profile, commit, error), then the error-level lines of the latest errored builds' logs.
9
+ - The `expo-workflows` block (`context=e2e`) reads the latest failed EAS Workflow runs (`eas workflow:run`, Maestro). For each run it returns the job status and errors, the step-log tails, the per-flow exception for every flow and retry (EAS GraphQL), the JUnit, and the failure screenshot URLs. From `artifacts.tar.gz` it adds the failing Maestro commands, the list of view-hierarchy dumps, the per-attempt JUnit, the XCUITest runner's own errors and the app's JS console.
10
+
11
+ The settings:
12
+
13
+ - Secret: `EXPO_TOKEN` (an EAS access token). It goes in the app's env (e.g. `apps/mobile/.env.local`), not in `.bkit/.env`.
14
+ - Non-secret, both blocks: `EXPO_APP_DIR`, the EAS-linked app folder (default `apps/mobile`).
15
+ - Non-secret, `expo` block: `EAS_PLATFORM`, `EAS_PROFILE`, `EAS_N` (default and max 50, the CLI limit), `EAS_ERR_N` and `EAS_LOG_N`.
16
+ - Non-secret, `expo-workflows` block: `EAS_WF_FILE`, `EAS_WF_N` and `EAS_WF_FAIL_N` (each at most 100, the CLI limit), `EAS_WF_ERR_N` and `EAS_JUNIT_N`.
17
+ - CLI: `eas` (`eas-cli`). Each block's provision block of the same name installs it in cloud and guards itself, so copying both installs it once. The `expo` block also uses `node` to decompress logs.
18
+ - Domains: `expo.dev` for both blocks, `googleapis.com` for `expo`, and `eascdn.net` for `expo-workflows`. Each section carries its own `allowed-domains` block.
19
+
20
+ How the blocks read their sources:
21
+
22
+ - `expo`: build logs are pre-signed, brotli-encoded storage URLs, valid for about 15 min. macOS curl has no brotli, so the block decompresses the logs with Node zlib and filters the JSON lines with `jq`.
23
+ - `expo-workflows`: when a GitHub Actions job starts the run, pair this block with the `maestro` block (`bkit-maestro.md`). That block reads the GitHub job log, and this one reads EAS.
24
+ - `expo-workflows`: read its output in this order:
25
+ 1. The per-flow exception (2b).
26
+ 2. The XCUITest runner errors (2e), for any `DeviceUnreachableException`. Maestro's iOS driver is an XCUITest case that hosts the HTTP server, so one failure inside it fails every later flow.
27
+ 3. The view-hierarchy dump (2d), for any selector or visibility failure. It is the tree Maestro actually searched, and it can contradict a screenshot.
28
+ - `expo-workflows`: artifact URLs are pre-signed and expire after about 1 h, and EAS keeps the data for 90 days. An expired URL means you re-run `workflow:status`. It does not mean the artifact is gone.
16
29
 
17
30
  Copy the blocks below into `.agents/context.md`, below `<!-- bkit:end -->`. The two sections are independent: copy one or both, each with its provision and `allowed-domains` blocks.
18
31
 
@@ -21,10 +34,11 @@ Copy the blocks below into `.agents/context.md`, below `<!-- bkit:end -->`. The
21
34
  <!-- context-fetch:start expo context=runtime -->
22
35
 
23
36
  ```bash
24
- # Expo EAS native build status + errored-build logs (read-only).
25
- # EXPO_TOKEN is an app/stack cred (it builds and ships the native apps) — app env, not .bkit/.env.
26
- # Run `eas` from the EAS-linked app folder: from anywhere else it writes a stub app.json there.
27
- # Failed `eas build:list` (bad token, EAS_N > 50, network) → `skipped`.
37
+ # Expo EAS native build status and errored-build logs (read-only).
38
+ # EXPO_TOKEN is an app / stack credential, because it builds and ships the native apps. It goes in
39
+ # the app env, not in .bkit/.env.
40
+ # Run `eas` from the EAS-linked app folder. Run from anywhere else, it writes a stub app.json there.
41
+ # A failed `eas build:list` (bad token, EAS_N > 50, network) → `skipped`.
28
42
  # Customise: EXPO_APP_DIR; EAS_PLATFORM (android|ios|all); EAS_PROFILE (build profile, e.g. preview / production); EAS_N (builds listed, default and max 50); EAS_ERR_N; EAS_LOG_N (log lines per build); the log-line filter. Positive control (suggested): newest build on expo.dev must be the first line; missing = reader broken, not clean.
29
43
  EXPO_APP_DIR="${EXPO_APP_DIR:-apps/mobile}"
30
44
  command -v eas >/dev/null && [ -n "${EXPO_TOKEN:-}" ] \
@@ -42,8 +56,9 @@ EAS_BUILDS=$(eas build:list \
42
56
  printf '===== eas builds, newest %s (%s) — %s build(s) =====\n' "${EAS_N:-50}" "${EAS_PLATFORM:-all}" "$(printf '%s' "$EAS_BUILDS" | jq length)"
43
57
  printf '%s' "$EAS_BUILDS" \
44
58
  | jq -c '.[] | {id, platform, status, createdAt, buildProfile, gitCommitHash, error}' # gitCommitHash stitches to the CI run
45
- # 2) LOGS for recent failures. No `eas build:logs`; build:view exposes `logFiles`: pre-signed
46
- # URLs (signature in the query string, no auth header), valid ~900s, BROTLI-encoded JSON lines.
59
+ # 2) Logs for recent failures. There is no `eas build:logs`. build:view exposes `logFiles`:
60
+ # pre-signed URLs (the signature is in the query string, with no auth header), valid for about
61
+ # 900s, holding brotli-encoded JSON lines.
47
62
  # An install-dependencies failure (e.g. a private-registry 401) shows here.
48
63
  for id in $(eas build:list --status errored --platform "${EAS_PLATFORM:-all}" ${EAS_PROFILE:+--build-profile "$EAS_PROFILE"} \
49
64
  --limit "${EAS_ERR_N:-2}" --json --non-interactive | jq -r '.[].id'); do
@@ -62,7 +77,8 @@ done
62
77
  <!-- context-fetch:provision expo -->
63
78
 
64
79
  ```bash
65
- # Install eas-cli in cloud if absent (self-guarded; no-op when present).
80
+ # Install eas-cli in cloud if it is absent. The block guards itself and does nothing when the CLI
81
+ # is present.
66
82
  command -v eas >/dev/null 2>&1 || pnpm add -g eas-cli
67
83
  ```
68
84
 
@@ -80,9 +96,9 @@ googleapis.com
80
96
  <!-- context-fetch:start expo-workflows context=e2e -->
81
97
 
82
98
  ```bash
83
- # EAS WORKFLOW runs — the native e2e (Maestro) lane (read-only). SEPARATE from the expo block:
84
- # that one covers `eas build`, this one covers `eas workflow:run`.
85
- # Failed `eas workflow:runs` (bad token, network) → `skipped`.
99
+ # EAS Workflow runs: the native e2e (Maestro) lane (read-only). This block is separate from the
100
+ # expo block: that one covers `eas build`, and this one covers `eas workflow:run`.
101
+ # A failed `eas workflow:runs` (bad token, network) → `skipped`.
86
102
  # Customise: EXPO_APP_DIR; EAS_WF_FILE (e2e workflow file; unset = all); EAS_WF_N (all-status runs listed, max 100); EAS_WF_FAIL_N (FAILURE runs listed, max 100; reaches further back than the all-status list); EAS_WF_ERR_N (failed runs read in detail); EAS_JUNIT_N (lines per JUnit file); which artifacts to inline; the log greps. Positive control (suggested): a known failed run must appear in the FAILURE list; missing = reader broken, not clean.
87
103
  EXPO_APP_DIR="${EXPO_APP_DIR:-apps/mobile}"
88
104
  command -v eas >/dev/null && [ -n "${EXPO_TOKEN:-}" ] \
@@ -92,10 +108,10 @@ grep -qs 'projectId' "$EXPO_APP_DIR"/app.json "$EXPO_APP_DIR"/app.config.* \
92
108
  cd "$EXPO_APP_DIR" || exit 0
93
109
  WORK=$(mktemp -d)
94
110
  trap 'rm -rf "$WORK"' EXIT
95
- # 1) Recent workflow runs, newest first. `workflow:runs` does NOT accept --non-interactive
96
- # (unlike its sibling commands): passing it errors out with no output, which reads exactly
97
- # like "no runs found". Its flags are only --json --limit --status --workflow; --limit above
98
- # 100 errors. The date field is `startedAt` (there is no `createdAt`).
111
+ # 1) Recent workflow runs, newest first. Unlike its sibling commands, `workflow:runs` does not
112
+ # accept --non-interactive. Passing it errors out with no output, which reads exactly like
113
+ # "no runs found". Its only flags are --json --limit --status --workflow, and a --limit above
114
+ # 100 errors. The date field is `startedAt`. There is no `createdAt`.
99
115
  WF_N="${EAS_WF_N:-10}"; [ "$WF_N" -le 100 ] || WF_N=100
100
116
  WF_FAIL_N="${EAS_WF_FAIL_N:-100}"; [ "$WF_FAIL_N" -le 100 ] || WF_FAIL_N=100
101
117
  eas workflow:runs --json ${EAS_WF_FILE:+--workflow "$EAS_WF_FILE"} --limit "$WF_N" > "$WORK/runs.json" 2>/dev/null \
@@ -108,32 +124,33 @@ printf '===== eas workflow runs, newest %s — %s run(s) =====\n' "$WF_N" "$(jq
108
124
  jq -c '.[] | {id, status, workflowName, gitCommitHash, startedAt}' "$WORK/runs.json"
109
125
  printf '===== FAILURE runs, newest %s — %s run(s) =====\n' "$WF_FAIL_N" "$(jq length "$WORK/failures.json")"
110
126
  jq -c '.[] | {id, workflowName, gitCommitHash, startedAt}' "$WORK/failures.json"
111
- # 2) Per-run detail. `workflow:status` is the only command that yields BOTH job ids and artifact URLs.
127
+ # 2) Per-run detail. `workflow:status` is the only command that yields both job ids and artifact URLs.
112
128
  for run in $(jq -r --argjson n "${EAS_WF_ERR_N:-2}" '.[:$n][].id' "$WORK/failures.json"); do
113
129
  echo "===== failed workflow run $run ====="
114
130
  STATUS="$WORK/status-$run.json"
115
- # `workflow:status` prints its JSON, then exits 11 FAILED / 12 canceled: test the JSON, NEVER
116
- # the exit code; an exit-code guard skips every failed run's detail.
131
+ # `workflow:status` prints its JSON, then exits 11 for FAILED and 12 for canceled. Test the
132
+ # JSON, never the exit code, because an exit-code guard skips every failed run's detail.
117
133
  eas workflow:status "$run" --json --non-interactive > "$STATUS" 2>/dev/null
118
134
  jq -e '.id' "$STATUS" >/dev/null 2>&1 \
119
135
  || { echo "===== run $run: workflow:status returned no JSON — detail NOT read ====="; continue; }
120
136
  jq -r '.jobs[]? | "job \(.id) key=\(.key // "?") \(.status)", (.turtleJobRun.errors[]? | " \(.errorCode): \(.message)")' "$STATUS"
121
- # 2a) Step logs. `workflow:logs` takes the JOB id, not the run id (the run id returns "No
122
- # workflow job found"). --all-steps is required or it prompts for a step and hangs headless.
123
- # Failed jobs only: a passing job's log tail is noise.
137
+ # 2a) Step logs. `workflow:logs` takes the job id, not the run id. The run id returns "No
138
+ # workflow job found". --all-steps is required, because without it the command prompts for
139
+ # a step and hangs headless.
140
+ # Failed jobs only, because a passing job's log tail is noise.
124
141
  for job in $(jq -r '.jobs[]? | select(.status=="FAILURE") | .id' "$STATUS"); do
125
142
  eas workflow:logs "$job" --all-steps --non-interactive 2>/dev/null | tail -60
126
143
  done
127
- # 2b) THE PER-FLOW EXCEPTION. Neither the GitHub job log nor the EAS job log carries it — both
128
- # stop at EAS's summary line. `allDeviceTestCaseResults.errorMessage` is the only text
129
- # source; one POST returns every flow and every retry. Read it before theorising.
144
+ # 2b) The per-flow exception. Neither the GitHub job log nor the EAS job log carries it, because
145
+ # both stop at EAS's summary line. `allDeviceTestCaseResults.errorMessage` is the only text
146
+ # source, and one POST returns every flow and every retry. Read it before theorising.
130
147
  curl -sS https://api.expo.dev/graphql \
131
148
  -H "authorization: Bearer $EXPO_TOKEN" -H 'content-type: application/json' \
132
149
  -d "{\"query\":\"query{workflowRuns{byId(workflowRunId:\\\"$run\\\"){id status jobs{id key status allDeviceTestCaseResults{name path status errorMessage duration retryCount}}}}}\"}" \
133
150
  | jq -r '.data.workflowRuns.byId.jobs[]?.allDeviceTestCaseResults[]? | "----- \(.name) \(.status) attempt=\(.retryCount) \(.duration)ms\n\(.errorMessage // "(no error message)")\n"'
134
- # 2c) Artifacts: pre-signed (no auth header), PLAIN files (not brotli, unlike build logs).
135
- # The merged JUnit is the per-flow verdict of record; failure screenshots are often the
136
- # fastest read — URLs only, open them in an image viewer.
151
+ # 2c) Artifacts are pre-signed (no auth header) plain files. Unlike build logs, they are not
152
+ # brotli-encoded. The merged JUnit is the per-flow verdict of record. Failure screenshots are
153
+ # often the fastest read. The block prints their URLs only, so open them in an image viewer.
137
154
  grep -oE 'https://wf-artifacts[^"]*(junit\.xml|failure-attempt[^"]*\.png)[^"]*' "$STATUS" \
138
155
  | while read -r u; do
139
156
  case "$u" in
@@ -141,45 +158,45 @@ for run in $(jq -r --argjson n "${EAS_WF_ERR_N:-2}" '.[:$n][].id' "$WORK/failure
141
158
  *) echo "===== failure screenshot: $u" ;;
142
159
  esac
143
160
  done
144
- # 2d) artifacts.tar.gz: commands.json, screen-hierarchy dumps, per-attempt JUnit, simulator and
145
- # XCUITest runner logs. Excluding *.logarchive* and *.mov keeps the extraction small; the
146
- # .logarchive reads back empty with `log show --archive` anyway — use
147
- # <flow>/logs/device-simulator.log (same system log, plain text).
161
+ # 2d) artifacts.tar.gz holds commands.json, the screen-hierarchy dumps, the per-attempt JUnit,
162
+ # and the simulator and XCUITest runner logs. Excluding *.logarchive* and *.mov keeps the
163
+ # extraction small. The .logarchive reads back empty with `log show --archive` anyway, so
164
+ # use <flow>/logs/device-simulator.log, which is the same system log in plain text.
148
165
  TARBALL=$(grep -oE 'https://wf-artifacts[^"]*artifacts\.tar\.gz[^"]*' "$STATUS" | head -1)
149
166
  [ -n "$TARBALL" ] || continue
150
167
  DEST="$WORK/artifacts-$run"
151
168
  mkdir -p "$DEST"
152
169
  curl -sS "$TARBALL" \
153
170
  | tar -xz -C "$DEST" --exclude='*.logarchive*' --exclude='*.mov' 2>/dev/null || true
154
- # commands.json: every Maestro step with status, duration and the FULL error.message.
171
+ # commands.json holds every Maestro step with its status, its duration and the full error.message.
155
172
  find "$DEST" -name commands.json 2>/dev/null | while read -r c; do
156
173
  echo "===== failing steps: ${c#"$DEST"/} ====="
157
174
  jq -r '.[]? | select(.error != null or (.status // "") == "FAILED")
158
175
  | " \(.command // .name // "?") [\(.status // "?")] \(.error.message // "")"' "$c" 2>/dev/null
159
176
  done
160
- # View-hierarchy dumps are large: list them with sizes. Named step-NNN-<command>-<selector>.json,
161
- # so the failing step's dump is identifiable by name — cat that one.
177
+ # View-hierarchy dumps are large, so the block lists them with their sizes. Each is named
178
+ # step-NNN-<command>-<selector>.json, so the name identifies the failing step's dump. Cat that one.
162
179
  echo "===== screen-hierarchy dumps (cat the one matching the failing step) ====="
163
180
  find "$DEST" -path '*screen-hierarchy*' -name '*.json' -exec ls -lh {} \; 2>/dev/null \
164
181
  | awk '{print " " $5 " " $NF}'
165
- # Per-ATTEMPT JUnit: the merged JUnit above hides a flow that failed and then passed on retry.
182
+ # Per-attempt JUnit. The merged JUnit above hides a flow that failed and then passed on retry.
166
183
  find "$DEST" -path '*junit-reports*' -name '*.xml' 2>/dev/null | sort | head -n 20 \
167
184
  | while read -r j; do
168
185
  echo "===== $(basename "$j") (first ${EAS_JUNIT_N:-300} lines) ====="
169
186
  tr -d '\r' < "$j" | head -n "${EAS_JUNIT_N:-300}"
170
187
  done
171
- # 2e) WHY THE DRIVER DIED — read first for any DeviceUnreachableException. An `error:` line in
172
- # xctest_runner_*.log names the cause; neither job log does. A device-unreachable sweep is a
173
- # symptom shared by several faults, not a diagnosis.
188
+ # 2e) Why the driver died. For any DeviceUnreachableException, read this after the per-flow
189
+ # exception (2b). An `error:` line in xctest_runner_*.log names the cause, and neither job
190
+ # log does. A device-unreachable sweep is a symptom shared by several faults, not a diagnosis.
174
191
  echo "===== XCUITest runner: the driver's own failure ====="
175
192
  find "$DEST" -name 'xctest_runner_*.log' 2>/dev/null | while read -r r; do
176
193
  grep -nE 'error:|TEST EXECUTE FAILED|Test Suite .* failed|failed \(' "$r" | tail -25
177
194
  done
178
- # 2f) THE APP'S OWN JS CONSOLE (React Native). RN logs under the framework's os_log subsystem
179
- # com.facebook.react.log, category javascript — NOT the app's bundle id, which returns OS
180
- # install / launch chatter and no JS. console.error persists on every run; console.warn /
181
- # console.log need a `log config --subsystem com.facebook.react.log` step before the tests,
182
- # so a low count without it is a closed channel, not a quiet app.
195
+ # 2f) The app's own JS console (React Native). RN logs under the framework's os_log subsystem
196
+ # com.facebook.react.log, category javascript. It does not log under the app's bundle id,
197
+ # which returns OS install / launch chatter and no JS. console.error persists on every run.
198
+ # console.warn / console.log need a `log config --subsystem com.facebook.react.log` step
199
+ # before the tests, so without that step a low count is a closed channel, not a quiet app.
183
200
  echo "===== app JS console per flow (count, then the lines) ====="
184
201
  find "$DEST" -name device-simulator.log 2>/dev/null | while read -r sl; do
185
202
  echo " $(grep -c 'com\.facebook\.react\.log:javascript' "$sl") $sl"
@@ -198,7 +215,8 @@ done
198
215
  <!-- context-fetch:provision expo-workflows -->
199
216
 
200
217
  ```bash
201
- # Install eas-cli in cloud if absent (self-guarded; no-op when present).
218
+ # Install eas-cli in cloud if it is absent. The block guards itself and does nothing when the CLI
219
+ # is present.
202
220
  command -v eas >/dev/null 2>&1 || pnpm add -g eas-cli
203
221
  ```
204
222
 
@@ -3,13 +3,20 @@
3
3
 
4
4
  # GitHub Actions — failing CI run and diff since the last green run
5
5
 
6
- Fits: any repo whose CI runs on GitHub Actions. `context=ci`: the failing run on the current branch — failed jobs and steps, `::error` annotations, failed-step logs per failed job, each tail-bounded (bounded whole-run tail when `--log-failed` returns nothing). `context=diff`: `git diff --stat` (capped at `DIFF_STAT_N` files) from the last commit where your CI workflow passed on trunk to `HEAD`.
6
+ Fits: any repo whose CI runs on GitHub Actions.
7
7
 
8
- - Secret: `GH_TOKEN` in cloud (local `gh auth login` works too).
9
- - Non-secret: `context=ci` none, the block discovers its own run. `context=diff`: `BASELINE_BRANCH` (your trunk, default `dev`) and `BASELINE_WORKFLOW` (your CI workflow file, default `bkit-ci.yml`); edit the defaults in the block so cloud agents inherit them.
10
- - CLI: `gh` — base tooling, no provision block.
8
+ - The `context=ci` block reads the selected run and attempt, then returns bounded logs for every failed job. Without a selection it discovers the configured workflow's latest completed run on the current branch.
9
+ - The `context=diff` block compares the selected failing commit with an ancestral successful commit of the same workflow on the baseline branch. Without a selection it compares the configured workflow's last successful commit with `HEAD`.
10
+
11
+ The settings:
12
+
13
+ - Secret: `GH_TOKEN` in cloud. A local `gh auth login` works too.
14
+ - Optional inputs: `BKIT_CI_RUN_ID`, `BKIT_CI_RUN_ATTEMPT`, `BKIT_CI_REPO` and `BKIT_CI_HEAD_SHA`, supplied together by `context fetch --ci-selection-file`.
15
+ - Workflow: `package.json` `bkit.testing.ciWorkflow`; `BASELINE_WORKFLOW` may override the unpinned diff selector.
16
+ - Baseline branch: `BASELINE_BRANCH` (default `dev`). Commit your trunk selector in the copied block so cloud agents inherit it.
17
+ - CLI: `gh`. It is base tooling, so there is no provision block.
11
18
  - Domains: none beyond bkit's derived set (`github.com`).
12
- - `context=diff` needs the last-passing commit locally: a shallow clone self-skips, naming the SHA.
19
+ - The diff needs both commits locally. Missing history or an unavailable baseline is reported as unchecked evidence.
13
20
 
14
21
  Copy the blocks below into `.agents/context.md`, below `<!-- bkit:end -->`. The blocks are independent: copy one or both.
15
22
 
@@ -18,49 +25,55 @@ Copy the blocks below into `.agents/context.md`, below `<!-- bkit:end -->`. The
18
25
  <!-- context-fetch:start github context=ci -->
19
26
 
20
27
  ```bash
21
- # GitHub Actions: failing-run job/step failures + error annotations + failed-step logs.
22
- # Discovers its own run. `gh` is base tooling — no context-fetch:provision sibling.
23
- # Customise: run (`--branch`, `--limit`, pin RUN_ID); log slice (`--log-failed` vs `--log`); CI_LOG_TAIL (lines kept per failed job, and of the whole-run fallback); job/step name filter; annotation grep.
24
- command -v gh >/dev/null 2>&1 \
25
- || { echo "[context-fetch:github] skipped — gh CLI not installed" >&2; exit 0; }
26
- gh auth status >/dev/null 2>&1 \
27
- || { echo "[context-fetch:github] skipped — gh not authenticated (set GH_TOKEN)" >&2; exit 0; }
28
- RUN_JSON=$(gh run list --branch "$(git branch --show-current)" --limit 1 \
29
- --json databaseId,conclusion,headSha 2>/dev/null || echo '[]')
30
- RUN_ID=$(printf '%s' "$RUN_JSON" | jq -r '.[0].databaseId // ""')
31
- RUN_SHA=$(printf '%s' "$RUN_JSON" | jq -r '.[0].headSha // ""')
32
- RUN_CONCLUSION=$(printf '%s' "$RUN_JSON" | jq -r '.[0].conclusion // ""')
33
- [ -n "$RUN_ID" ] \
34
- || { echo "[context-fetch:github] skipped — no CI run found for this branch" >&2; exit 0; }
35
- [ "$RUN_CONCLUSION" != "success" ] \
36
- || { echo "[context-fetch:github] skipped — run $RUN_ID concluded success (nothing failing to fetch)" >&2; exit 0; }
37
- FAILED_STEPS=$(gh run view "$RUN_ID" --json conclusion,jobs \
38
- --jq '[.jobs[] | select(.conclusion=="failure") | {job: .name, steps: [.steps[] | select(.conclusion=="failure") | .name]}]' 2>/dev/null)
39
- # Failed-step logs, one tail-bounded section per failed job, so a second failing job keeps its
40
- # lines. Raise CI_LOG_TAIL if the cause sits higher in a job's log.
28
+ # GitHub Actions: selected-attempt metadata and bounded logs of every failed job.
29
+ # Customise: CI_LOG_TAIL (lines kept per failed job); configured workflow; job/step filters.
30
+ set -o pipefail
31
+ skip() { echo "[context-fetch:github] skipped — $*" >&2; exit 0; }
32
+ command -v gh >/dev/null 2>&1 || skip "gh CLI not installed"
33
+ gh auth status >/dev/null 2>&1 || skip "gh not authenticated (set GH_TOKEN)"
41
34
  CI_LOG_TAIL=2000
42
- FAILED_JOBS=$(gh run view "$RUN_ID" --json jobs \
43
- --jq '.jobs[] | select(.conclusion=="failure") | "\(.databaseId)\t\(.name)"' 2>/dev/null)
35
+ RUN_ID="${BKIT_CI_RUN_ID:-}"
36
+ RUN_ATTEMPT="${BKIT_CI_RUN_ATTEMPT:-}"
37
+ RUN_REPO="${BKIT_CI_REPO:-}"
38
+ if [ -z "$RUN_ID" ]; then
39
+ CI_WORKFLOW=$(node -p 'require(process.cwd()+"/package.json").bkit?.testing?.ciWorkflow || ""' 2>/dev/null) || skip "workflow configuration unavailable"
40
+ [ -n "$CI_WORKFLOW" ] || skip "no configured CI workflow"
41
+ RUN_LIST=$(gh run list --workflow "$CI_WORKFLOW" --branch "$(git branch --show-current)" --status completed --limit 1 --json databaseId,attempt 2>/dev/null) || skip "CI discovery unavailable"
42
+ RUN_ID=$(printf '%s' "$RUN_LIST" | jq -er '.[0].databaseId | select(type=="number" and .>0)') || skip "no completed CI run found"
43
+ RUN_ATTEMPT=$(printf '%s' "$RUN_LIST" | jq -er '.[0].attempt | select(type=="number" and .>0)') || skip "run attempt unavailable"
44
+ RUN_REPO=$(gh repo view --json nameWithOwner --jq '.nameWithOwner' 2>/dev/null) || skip "repository identity unavailable"
45
+ fi
46
+ printf '%s\n' "$RUN_ID" "$RUN_ATTEMPT" | command grep -Eqv '^[1-9][0-9]*$' && skip "invalid selected run or attempt"
47
+ printf '%s' "$RUN_REPO" | command grep -Eq '^[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+$' || skip "invalid selected repository"
48
+ RUN_META=$(gh api "/repos/$RUN_REPO/actions/runs/$RUN_ID/attempts/$RUN_ATTEMPT" 2>/dev/null) || skip "selected run metadata unavailable"
49
+ printf '%s' "$RUN_META" | jq -e --arg id "$RUN_ID" --argjson attempt "$RUN_ATTEMPT" --arg repo "$RUN_REPO" --arg sha "${BKIT_CI_HEAD_SHA:-}" '
50
+ (.id|tostring)==$id and .run_attempt==$attempt and .repository.full_name==$repo and .head_repository.full_name==$repo
51
+ and (.head_sha|test("^([0-9a-f]{40}|[0-9a-f]{64})$")) and ($sha=="" or .head_sha==$sha)
52
+ and (.workflow_id|type=="number" and .>0) and .status=="completed"
53
+ and (.conclusion=="failure" or .conclusion=="timed_out" or .conclusion=="startup_failure")' >/dev/null || skip "selected run identity or failure does not match"
54
+ RUN_SHA=$(printf '%s' "$RUN_META" | jq -r '.head_sha')
55
+ WORKFLOW_ID=$(printf '%s' "$RUN_META" | jq -r '.workflow_id')
56
+ JOB_PAGES=$(gh api "/repos/$RUN_REPO/actions/runs/$RUN_ID/attempts/$RUN_ATTEMPT/jobs?per_page=100" --paginate --slurp 2>/dev/null) || skip "selected job pages unavailable"
57
+ printf '%s' "$JOB_PAGES" | jq -e '
58
+ type=="array" and length>0 and all(.[]; (.total_count|type=="number" and .>=0 and floor==.) and (.jobs|type=="array"))
59
+ and ([.[].total_count]|unique|length)==1 and ([.[].jobs[]]|length)==.[0].total_count
60
+ and ([.[].jobs[].id]|unique|length)==.[0].total_count' >/dev/null || skip "selected job pages incomplete"
61
+ FAILED_JOBS=$(printf '%s' "$JOB_PAGES" | jq -r '.[].jobs[] | select(.conclusion=="failure" or .conclusion=="timed_out" or .conclusion=="startup_failure") | [.id,.name] | @tsv') || skip "failed job list unavailable"
62
+ [ -n "$FAILED_JOBS" ] || skip "no failed job logs available"
44
63
  CI_LOGS=""
45
64
  TAB=$(printf '\t')
46
65
  while IFS="$TAB" read -r JOB JOB_NAME; do
47
- [ -n "$JOB" ] || continue
48
- JOB_LOG=$(gh run view "$RUN_ID" --job "$JOB" --log-failed 2>/dev/null | tail -n "$CI_LOG_TAIL")
49
- [ -n "$JOB_LOG" ] && CI_LOGS="${CI_LOGS}===== job ${JOB_NAME} =====
66
+ printf '%s' "$JOB" | command grep -Eq '^[1-9][0-9]*$' || skip "invalid failed job identity"
67
+ JOB_LOG=$(gh run view "$RUN_ID" --repo "$RUN_REPO" --attempt "$RUN_ATTEMPT" --job "$JOB" --log-failed 2>/dev/null | tail -n "$CI_LOG_TAIL") || skip "selected job log unavailable"
68
+ [ -n "$JOB_LOG" ] || skip "selected job log empty"
69
+ CI_LOGS="${CI_LOGS}===== job ${JOB_NAME} =====
50
70
  ${JOB_LOG}
51
71
  "
52
72
  done <<EOF_JOBS
53
73
  $FAILED_JOBS
54
74
  EOF_JOBS
55
- # Whole-run fallback is tens of MB — bound it the same way.
56
- [ -z "$CI_LOGS" ] && CI_LOGS=$(gh run view "$RUN_ID" --log 2>/dev/null | tail -n "$CI_LOG_TAIL")
57
- [ -n "$CI_LOGS" ] \
58
- || { echo "[context-fetch:github] skipped — no logs returned for run $RUN_ID" >&2; exit 0; }
59
- ERR_SUBSET=$(printf '%s' "$CI_LOGS" | grep -E '##\[error\]|::error' 2>/dev/null)
60
- printf '===== run %s (headSha %s, conclusion %s) =====\n\n' "$RUN_ID" "${RUN_SHA:-unknown}" "$RUN_CONCLUSION"
61
- printf '===== failed jobs/steps =====\n%s\n\n' "${FAILED_STEPS:-[]}"
62
- [ -n "$ERR_SUBSET" ] && printf '===== error annotations =====\n%s\n\n' "$ERR_SUBSET"
63
- printf '===== failed-step logs =====\n%s\n' "$CI_LOGS"
75
+ jq -cn --arg repo "$RUN_REPO" --arg runId "$RUN_ID" --argjson runAttempt "$RUN_ATTEMPT" --arg headSha "$RUN_SHA" --arg workflowId "$WORKFLOW_ID" '{provider:"github",repo:$repo,runId:$runId,runAttempt:$runAttempt,headSha:$headSha,workflowId:$workflowId,complete:true}' | sed 's/^/bkit-ci-evidence: /'
76
+ printf '===== run %s attempt %s (headSha %s) =====\n%s\n' "$RUN_ID" "$RUN_ATTEMPT" "$RUN_SHA" "$CI_LOGS"
64
77
  ```
65
78
 
66
79
  <!-- context-fetch:end -->
@@ -70,24 +83,48 @@ printf '===== failed-step logs =====\n%s\n' "$CI_LOGS"
70
83
  <!-- context-fetch:start github context=diff -->
71
84
 
72
85
  ```bash
73
- # GitHub Actions: diff HEAD vs last-passing CI on trunk.
74
- # Set BASELINE_BRANCH / BASELINE_WORKFLOW to YOUR trunk and workflow file; commit them here.
75
- # Customise: BASELINE_BRANCH / BASELINE_WORKFLOW; last-passing `--limit`; `git diff` pathspec / `--stat` vs full patch; DIFF_STAT_N (files listed).
86
+ # GitHub Actions: ancestral successful baseline to the selected failing commit.
87
+ # Customise: BASELINE_BRANCH; last-passing --limit; DIFF_STAT_N (files listed).
88
+ set -o pipefail
89
+ skip() { echo "[context-fetch:github] skipped — $*" >&2; exit 0; }
76
90
  BASELINE_BRANCH="${BASELINE_BRANCH:-dev}"
77
- BASELINE_WORKFLOW="${BASELINE_WORKFLOW:-bkit-ci.yml}"
78
- command -v gh >/dev/null 2>&1 \
79
- || { echo "[context-fetch:github] skipped — gh CLI not installed" >&2; exit 0; }
80
- LAST_PASS_SHA=$(gh run list --branch "$BASELINE_BRANCH" --workflow "$BASELINE_WORKFLOW" \
81
- --status success --limit 5 --json headSha --jq '.[0].headSha // ""' 2>/dev/null)
82
- [ -n "$LAST_PASS_SHA" ] \
83
- || { echo "[context-fetch:github] skipped — no successful $BASELINE_WORKFLOW run on $BASELINE_BRANCH (check both names)" >&2; exit 0; }
84
- git cat-file -e "${LAST_PASS_SHA}^{commit}" 2>/dev/null \
85
- || { echo "[context-fetch:github] skipped — last-passing SHA $LAST_PASS_SHA not present locally (shallow clone?)" >&2; exit 0; }
86
- DIFF_STAT=$(git diff "$LAST_PASS_SHA..HEAD" --stat --stat-count="${DIFF_STAT_N:-200}" 2>/dev/null)
87
- [ -n "$DIFF_STAT" ] \
88
- || { echo "[context-fetch:github] skipped — no diff between HEAD and last-passing $LAST_PASS_SHA" >&2; exit 0; }
89
- printf '===== diff vs last-passing CI on %s (last-passing-sha: %s) =====\n\n%s\n' \
90
- "$BASELINE_BRANCH" "$LAST_PASS_SHA" "$DIFF_STAT"
91
+ command -v gh >/dev/null 2>&1 || skip "gh CLI not installed"
92
+ RUN_ID="${BKIT_CI_RUN_ID:-}"
93
+ END_SHA=HEAD
94
+ if [ -n "$RUN_ID" ]; then
95
+ RUN_ATTEMPT="${BKIT_CI_RUN_ATTEMPT:-}"
96
+ RUN_REPO="${BKIT_CI_REPO:-}"
97
+ printf '%s\n' "$RUN_ID" "$RUN_ATTEMPT" | command grep -Eqv '^[1-9][0-9]*$' && skip "invalid selected run or attempt"
98
+ printf '%s' "$RUN_REPO" | command grep -Eq '^[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+$' || skip "invalid selected repository"
99
+ RUN_META=$(gh api "/repos/$RUN_REPO/actions/runs/$RUN_ID/attempts/$RUN_ATTEMPT" 2>/dev/null) || skip "selected baseline metadata unavailable"
100
+ printf '%s' "$RUN_META" | jq -e --arg id "$RUN_ID" --argjson attempt "$RUN_ATTEMPT" --arg repo "$RUN_REPO" --arg sha "${BKIT_CI_HEAD_SHA:-}" '
101
+ (.id|tostring)==$id and .run_attempt==$attempt and .repository.full_name==$repo and .head_repository.full_name==$repo
102
+ and .head_sha==$sha and (.workflow_id|type=="number" and .>0) and (.created_at|type=="string")' >/dev/null || skip "selected diff identity does not match"
103
+ END_SHA=$(printf '%s' "$RUN_META" | jq -r '.head_sha')
104
+ BASELINE_WORKFLOW=$(printf '%s' "$RUN_META" | jq -r '.workflow_id')
105
+ FAIL_TIME=$(printf '%s' "$RUN_META" | jq -r '.created_at')
106
+ BASELINES=$(gh run list --repo "$RUN_REPO" --branch "$BASELINE_BRANCH" --workflow "$BASELINE_WORKFLOW" --status success --limit 100 --json headSha,createdAt,workflowDatabaseId 2>/dev/null) || skip "successful baseline lookup unavailable"
107
+ CANDIDATES=$(printf '%s' "$BASELINES" | jq -r --arg before "$FAIL_TIME" --arg workflow "$BASELINE_WORKFLOW" '[.[] | select(.createdAt<=$before and (.workflowDatabaseId|tostring)==$workflow)] | sort_by(.createdAt) | reverse | .[].headSha') || skip "baseline response unavailable"
108
+ else
109
+ BASELINE_WORKFLOW="${BASELINE_WORKFLOW:-}"
110
+ if [ -z "$BASELINE_WORKFLOW" ]; then
111
+ BASELINE_WORKFLOW=$(node -p 'require(process.cwd()+"/package.json").bkit?.testing?.ciWorkflow || ""' 2>/dev/null) || skip "workflow configuration unavailable"
112
+ fi
113
+ [ -n "$BASELINE_WORKFLOW" ] || skip "no configured baseline workflow"
114
+ CANDIDATES=$(gh run list --branch "$BASELINE_BRANCH" --workflow "$BASELINE_WORKFLOW" --status success --limit 100 --json headSha --jq '.[].headSha' 2>/dev/null) || skip "successful baseline lookup unavailable"
115
+ fi
116
+ git cat-file -e "${END_SHA}^{commit}" 2>/dev/null || skip "selected commit unavailable in local history"
117
+ LAST_PASS_SHA=""
118
+ while IFS= read -r CANDIDATE; do
119
+ printf '%s' "$CANDIDATE" | command grep -Eq '^([0-9a-f]{40}|[0-9a-f]{64})$' || continue
120
+ if git merge-base --is-ancestor "$CANDIDATE" "$END_SHA" 2>/dev/null; then LAST_PASS_SHA="$CANDIDATE"; break; fi
121
+ done <<EOF_BASELINES
122
+ $CANDIDATES
123
+ EOF_BASELINES
124
+ [ -n "$LAST_PASS_SHA" ] || skip "ancestral same-workflow baseline unavailable in the inspected window"
125
+ DIFF_STAT=$(git diff "$LAST_PASS_SHA..$END_SHA" --stat --stat-count="${DIFF_STAT_N:-200}" 2>/dev/null) || skip "selected diff unavailable"
126
+ [ -n "$DIFF_STAT" ] || skip "no diff from baseline to selected commit"
127
+ printf '===== diff baseline %s to selected commit %s =====\n%s\n' "$LAST_PASS_SHA" "$END_SHA" "$DIFF_STAT"
91
128
  ```
92
129
 
93
130
  <!-- context-fetch:end -->
@@ -3,28 +3,34 @@
3
3
 
4
4
  # Inngest — failed function runs
5
5
 
6
- Fits: apps running durable functions on Inngest Cloud. `context=runtime`: `inngest/function.failed` system events across a time window (default last 4 h), paged — a count per day and function, then the newest events with function id, run id, error class, and the opaque `*Id` keys of the triggering event. Never the error message: it can carry secrets.
6
+ Fits: apps running durable functions on Inngest Cloud. The `context=runtime` block pages through the `inngest/function.failed` system events in a time window (default the last 4 h). It returns a count per day and function, then the newest events with their function id, run id, error class and the opaque `*Id` keys of the triggering event. It never returns the error message, because the message can carry secrets.
7
7
 
8
- - Secret: `INNGEST_SIGNING_KEY` — reuse the app's existing key. It is environment-scoped (branch environments and production have separate keys): use the key whose runs you want.
9
- - Non-secret: `SINCE_ISO` / `UNTIL_ISO` (window, default last 4 h; the API alone looks back only 1 h), `INNGEST_ENV` (branch environment name; required with a branch key, ignored otherwise), `INNGEST_N` (newest events listed, default 25), `INNGEST_MAX_PAGES` (pages of up to 51 events, default 40).
10
- - CLI: none (`curl` + `jq`), no provision block.
11
- - PII: the projection keeps only keys ending in `Id` from the triggering event's data. Keep free text and personal data out of `*Id` keys in your event payloads, or narrow the projection.
8
+ - Secret: `INNGEST_SIGNING_KEY`. Reuse the app's existing key. The key is scoped to one environment: branch environments and production have separate keys. Use the key whose runs you want.
9
+ - Non-secret: `SINCE_ISO` / `UNTIL_ISO`, the window (default the last 4 h). The API on its own looks back only 1 h.
10
+ - Non-secret: `INNGEST_ENV`, the branch environment name. It is required with a branch key and ignored otherwise.
11
+ - Non-secret: `INNGEST_N`, the number of newest events listed (default 25).
12
+ - Non-secret: `INNGEST_MAX_PAGES`, the number of pages of up to 51 events each (default 40).
13
+ - CLI: none (`curl` and `jq`), so there is no provision block.
14
+ - PII: the projection keeps only the keys ending in `Id` from the triggering event's data. Keep free text and personal data out of the `*Id` keys in your event payloads, or narrow the projection.
12
15
 
13
16
  Copy the blocks below into `.agents/context.md`, below `<!-- bkit:end -->`.
14
17
 
15
18
  <!-- context-fetch:start inngest context=runtime -->
16
19
 
17
20
  ```bash
18
- # Inngest Cloud — failed durable-function runs, exhausted retries (read-only).
19
- # INNGEST_SIGNING_KEY is ENV-SCOPED (branch env vs production) — use the key for the env whose
20
- # runs you want. Branch key (`signkey-branch-…`) reads the env in header `x-inngest-env`; without
21
- # it the API reads env `branch` and returns nothing → block refuses a branch key with INNGEST_ENV
22
- # unset. Lists `inngest/function.failed` events from received_after, paged by
23
- # cursor=<last internal_id>; pages stop at 51 events whatever `limit` says; API default window 1 h.
24
- # Non-200 first page → `skipped`; failed later page or page cap → TRUNCATED line.
25
- # NEVER prints `.data.error.message` / `.stack`: error strings can carry secrets from request
26
- # headers or URLs. Prints function id, run id, time, error class (`.data.error.name`, ONLY when
27
- # class-shaped), ONLY /Id$/ keys from the triggering event.
21
+ # Inngest Cloud: failed durable-function runs that exhausted their retries (read-only).
22
+ # INNGEST_SIGNING_KEY is scoped to one environment (a branch env or production). Use the key for
23
+ # the env whose runs you want. A branch key (`signkey-branch-…`) reads the env named in the header
24
+ # `x-inngest-env`. Without that header the API reads the env `branch` and returns nothing, so the
25
+ # block refuses a branch key while INNGEST_ENV is unset.
26
+ # The block lists `inngest/function.failed` events from received_after, paged by
27
+ # cursor=<last internal_id>. Pages stop at 51 events whatever `limit` says. The API's default
28
+ # window is 1 h.
29
+ # A non-200 first page → `skipped`. A failed later page or the page cap → a TRUNCATED line.
30
+ # The block NEVER prints `.data.error.message` / `.stack`, because error strings can carry
31
+ # secrets from request headers or URLs. It prints the function id, run id, time, error class
32
+ # (`.data.error.name`, printed only when it is shaped like a class name) and only the /Id$/ keys
33
+ # from the triggering event.
28
34
  # Customise: INNGEST_ENV (branch environment name, with a branch key); SINCE_ISO / UNTIL_ISO (window, default last 4 h); INNGEST_N (newest events listed); INNGEST_MAX_PAGES (x 51 events); the ids projection (narrow it if any *Id key in your events carries PII). Positive control (suggested): run once over a window holding a run the dashboard shows Failed; nothing back = reader broken, not clean.
29
35
  [ -n "${INNGEST_SIGNING_KEY:-}" ] \
30
36
  || { echo "[context-fetch:inngest] skipped — INNGEST_SIGNING_KEY unset" >&2; exit 0; }
@@ -3,14 +3,18 @@
3
3
 
4
4
  # Maestro e2e lanes on GitHub Actions — job logs
5
5
 
6
- Fits: native e2e lanes (iOS, Android, or both) whose GitHub Actions jobs run Maestro, on the runner or by handing the run to Expo EAS, and upload no GitHub artifact. `context=e2e`: the tail-bounded log of every failed Maestro job in the run, sliced to the steps that carry the per-flow result, else each log's tail.
6
+ Fits: native e2e lanes (iOS, Android, or both) whose GitHub Actions jobs run Maestro, either on the runner or by handing the run to Expo EAS, and that upload no GitHub artifact. The `context=e2e` block returns the log of every failed Maestro job in the run. It slices each log to the steps that carry the per-flow result. When no step matches, it returns the log's tail instead.
7
7
 
8
- - Reads the per-flow result from steps that succeed inside the failed job, which `gh run view --log-failed` (the `context=ci` block) skips; the Playwright block's artifact download finds nothing on these lanes.
9
- - Secret: `GH_TOKEN` in cloud (local `gh auth login` works too).
10
- - Non-secret: `MAESTRO_JOB_RE` (anchored regex matching your Maestro lanes' job names, e.g. `^e2e-(ios|android)$`), `MAESTRO_STEPS` (`|`-separated step names that print the result), `MAESTRO_LOG_TAIL`. Edit the defaults in the block.
11
- - CLI: `gh` — base tooling, no provision block.
8
+ - The block reads the per-flow result from steps that succeed inside the failed job. `gh run view --log-failed` (the `context=ci` block) skips those steps, and the Playwright block's artifact download finds nothing on these lanes.
9
+ - Secret: `GH_TOKEN` in cloud. A local `gh auth login` works too.
10
+ - Non-secret: `MAESTRO_JOB_RE`, an anchored regex matching your Maestro lanes' job names (e.g. `^e2e-(ios|android)$`).
11
+ - Non-secret: `MAESTRO_STEPS`, the `|`-separated names of the steps that print the result.
12
+ - Non-secret: `MAESTRO_LOG_TAIL`.
13
+ - Non-secret: `CI_WORKFLOW`, the workflow file that runs these lanes (default `bkit-ci.yml`). The block reads only that workflow's newest run on the current branch.
14
+ - Edit the defaults of these four in the block.
15
+ - CLI: `gh`. It is base tooling, so there is no provision block.
12
16
  - Domains: none beyond bkit's derived set (`github.com`).
13
- - Lanes on EAS: screenshots, JUnit and view-hierarchy dumps live on EAS, not in this log; the `expo-workflows` block in `expo.md` fetches them.
17
+ - Lanes on EAS keep their screenshots, JUnit and view-hierarchy dumps on EAS, not in this log. The `expo-workflows` block in `bkit-expo.md` fetches them.
14
18
 
15
19
  Copy the block below into `.agents/context.md`, below `<!-- bkit:end -->`.
16
20
 
@@ -18,21 +22,23 @@ Copy the block below into `.agents/context.md`, below `<!-- bkit:end -->`.
18
22
 
19
23
  ```bash
20
24
  # Maestro e2e (iOS and/or Android): every failed job matching MAESTRO_JOB_RE, one section per job.
21
- # MAESTRO_JOB_RE matches Maestro lanes only; another lane's job matched here is printed as Maestro evidence.
22
- # The placeholder matches NO job, so every run self-skips until you edit it.
23
- # iOS: Maestro's driver is an XCUITest case hosting the HTTP server Maestro talks to, so one
24
- # failure inside it ends the suite and turns every later flow into DeviceUnreachableException;
25
- # read the per-flow table before the traces.
26
- # Customise: MAESTRO_JOB_RE; MAESTRO_STEPS (the steps that print per-flow results); MAESTRO_LOG_TAIL (lines kept per step slice, and of the fallback tail).
25
+ # Scope MAESTRO_JOB_RE to your Maestro lanes' job names. A job from another lane that it matches
26
+ # is printed as Maestro evidence.
27
+ # The placeholder matches no job, so every run skips itself until you edit it.
28
+ # iOS: Maestro's driver is an XCUITest case that hosts the HTTP server Maestro talks to, so one
29
+ # failure inside it ends the suite and turns every later flow into DeviceUnreachableException.
30
+ # Read the per-flow table before the traces.
31
+ # Customise: CI_WORKFLOW (the workflow file that runs these lanes); MAESTRO_JOB_RE; MAESTRO_STEPS (the steps that print per-flow results); MAESTRO_LOG_TAIL (lines kept per step slice, and of the fallback tail).
27
32
  MAESTRO_JOB_RE="${MAESTRO_JOB_RE:-^your-maestro-e2e-job-name$}"
28
33
  MAESTRO_STEPS="${MAESTRO_STEPS:-Your per-flow results step|Your failure classification step}"
29
34
  MAESTRO_LOG_TAIL="${MAESTRO_LOG_TAIL:-800}"
30
35
  command -v gh >/dev/null 2>&1 \
31
36
  || { echo "[context-fetch:maestro] skipped — gh CLI not installed" >&2; exit 0; }
32
- RUN_ID=$(gh run list --branch "$(git branch --show-current)" --limit 1 \
37
+ CI_WORKFLOW="${CI_WORKFLOW:-bkit-ci.yml}"
38
+ RUN_ID=$(gh run list --branch "$(git branch --show-current)" --workflow "$CI_WORKFLOW" --limit 1 \
33
39
  --json databaseId,conclusion --jq 'if (.[0].conclusion // "") == "success" then "" else (.[0].databaseId // "" | tostring) end' 2>/dev/null)
34
40
  [ -n "$RUN_ID" ] \
35
- || { echo "[context-fetch:maestro] skipped — no failing CI run found for this branch" >&2; exit 0; }
41
+ || { echo "[context-fetch:maestro] skipped — no failing $CI_WORKFLOW run found for this branch" >&2; exit 0; }
36
42
  # `gh --jq` takes no `--arg`, so the regex goes through real jq.
37
43
  JOBS=$(gh run view "$RUN_ID" --json jobs 2>/dev/null \
38
44
  | jq -r --arg re "$MAESTRO_JOB_RE" '.jobs[] | select(.name | test($re)) | select(.conclusion=="failure") | "\(.databaseId)\t\(.name)"' 2>/dev/null)
@@ -50,8 +56,8 @@ while IFS="$TAB" read -r JOB_ID JOB_NAME; do
50
56
  fi
51
57
  PRINTED=1
52
58
  printf '===== Maestro job %s (run %s, job %s) =====\n' "$JOB_NAME" "$RUN_ID" "$JOB_ID"
53
- # Step names match as fixed strings against the step-name column gh prints; each slice keeps its
54
- # last MAESTRO_LOG_TAIL lines. No match falls through to the whole-log tail.
59
+ # Step names match as fixed strings against the step-name column gh prints, and each slice keeps
60
+ # its last MAESTRO_LOG_TAIL lines. When no step matches, the block prints the whole log's tail.
55
61
  FOUND=0
56
62
  OLD_IFS=$IFS; IFS='|'
57
63
  for STEP in $MAESTRO_STEPS; do