@cbartens/bkit 5.5.0 → 6.0.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 (297) hide show
  1. package/.bkit/README.md +30 -20
  2. package/.bkit/core/.agents/docs.md +1 -0
  3. package/.bkit/core/.agents/rules.md +51 -26
  4. package/.bkit/core/.bkit/README.md +29 -19
  5. package/.bkit/core/.bkit/authoring.md +117 -0
  6. package/.bkit/core/.bkit/cloud.md +11 -11
  7. package/.bkit/core/.bkit/comparison.md +5 -5
  8. package/.bkit/core/.bkit/install.md +20 -20
  9. package/.bkit/core/.bkit/jsonl.md +202 -122
  10. package/.bkit/core/.bkit/lite.md +1 -1
  11. package/.bkit/core/.bkit/pipeline.md +49 -52
  12. package/.bkit/core/.bkit/prompts.md +106 -167
  13. package/.bkit/core/.bkit/providers.md +29 -32
  14. package/.bkit/core/.bkit/templates.md +44 -18
  15. package/.bkit/core/.bkit/trackers.md +60 -28
  16. package/.bkit/core/.bkit/workflows.md +399 -359
  17. package/.bkit/core/AGENTS.md +16 -22
  18. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +14 -38
  19. package/.bkit/core/docs/templates/bkit-audit-adoption.md +16 -40
  20. package/.bkit/core/docs/templates/bkit-audit-agents.md +19 -43
  21. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +16 -40
  22. package/.bkit/core/docs/templates/bkit-audit-analytics.md +14 -38
  23. package/.bkit/core/docs/templates/bkit-audit-annotations.md +11 -35
  24. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +15 -39
  25. package/.bkit/core/docs/templates/bkit-audit-app-store.md +12 -36
  26. package/.bkit/core/docs/templates/bkit-audit-architecture.md +16 -40
  27. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +16 -40
  28. package/.bkit/core/docs/templates/bkit-audit-config.md +18 -42
  29. package/.bkit/core/docs/templates/bkit-audit-cost.md +16 -40
  30. package/.bkit/core/docs/templates/bkit-audit-coverage.md +15 -39
  31. package/.bkit/core/docs/templates/bkit-audit-database.md +16 -40
  32. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +15 -39
  33. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +15 -38
  34. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +16 -40
  35. package/.bkit/core/docs/templates/bkit-audit-documentation.md +11 -35
  36. package/.bkit/core/docs/templates/bkit-audit-duplication.md +18 -42
  37. package/.bkit/core/docs/templates/bkit-audit-failures.md +13 -37
  38. package/.bkit/core/docs/templates/bkit-audit-flakes.md +12 -36
  39. package/.bkit/core/docs/templates/bkit-audit-gates.md +14 -38
  40. package/.bkit/core/docs/templates/bkit-audit-issues.md +15 -39
  41. package/.bkit/core/docs/templates/bkit-audit-llm.md +16 -40
  42. package/.bkit/core/docs/templates/bkit-audit-logs.md +14 -38
  43. package/.bkit/core/docs/templates/bkit-audit-models.md +12 -36
  44. package/.bkit/core/docs/templates/bkit-audit-privacy.md +12 -36
  45. package/.bkit/core/docs/templates/bkit-audit-prompts.md +15 -39
  46. package/.bkit/core/docs/templates/bkit-audit-red-team.md +15 -39
  47. package/.bkit/core/docs/templates/bkit-audit-reliability.md +15 -39
  48. package/.bkit/core/docs/templates/bkit-audit-repo.md +12 -36
  49. package/.bkit/core/docs/templates/bkit-audit-security.md +13 -37
  50. package/.bkit/core/docs/templates/bkit-audit-slop.md +14 -38
  51. package/.bkit/core/docs/templates/bkit-audit-testing.md +12 -36
  52. package/.bkit/core/docs/templates/bkit-audit-usability.md +16 -40
  53. package/.bkit/core/docs/templates/bkit-plan.md +97 -226
  54. package/.bkit/core/engine/checks/after/ci-yml.ts +39 -30
  55. package/.bkit/core/engine/checks/after/github.ts +101 -72
  56. package/.bkit/core/engine/checks/after/index.ts +10 -12
  57. package/.bkit/core/engine/checks/after/suppression.ts +8 -5
  58. package/.bkit/core/engine/checks/after/tools.ts +47 -92
  59. package/.bkit/core/engine/checks/before/env.ts +2 -2
  60. package/.bkit/core/engine/checks/before/files.ts +5 -4
  61. package/.bkit/core/engine/checks/before/index.ts +18 -1
  62. package/.bkit/core/engine/checks/before/repo.ts +168 -2
  63. package/.bkit/core/engine/checks/tips/catalogue.ts +16 -5
  64. package/.bkit/core/engine/checks/tips/detect.ts +34 -0
  65. package/.bkit/core/engine/checks/tips/index.ts +10 -7
  66. package/.bkit/core/engine/cli.ts +20 -53
  67. package/.bkit/core/engine/commands/analysis.ts +171 -140
  68. package/.bkit/core/engine/commands/ci/ci.ts +6 -6
  69. package/.bkit/core/engine/commands/comply.ts +77 -103
  70. package/.bkit/core/engine/commands/install/doctor.ts +2 -2
  71. package/.bkit/core/engine/commands/install/install.ts +57 -18
  72. package/.bkit/core/engine/commands/install/uninstall.ts +65 -28
  73. package/.bkit/core/engine/commands/land.ts +18 -12
  74. package/.bkit/core/engine/commands/lib.ts +79 -17
  75. package/.bkit/core/engine/commands/registry.ts +4 -0
  76. package/.bkit/core/engine/commands/setup/setup.ts +7 -7
  77. package/.bkit/core/engine/commands/stats.ts +204 -0
  78. package/.bkit/core/engine/commands/tips.ts +10 -5
  79. package/.bkit/core/engine/commands/workflow/branches.ts +741 -62
  80. package/.bkit/core/engine/commands/workflow/challenge.ts +673 -0
  81. package/.bkit/core/engine/commands/workflow/context.ts +853 -29
  82. package/.bkit/core/engine/commands/workflow/counters.ts +267 -84
  83. package/.bkit/core/engine/commands/workflow/decisions.ts +541 -0
  84. package/.bkit/core/engine/commands/workflow/disk.ts +2 -2
  85. package/.bkit/core/engine/commands/workflow/fids.ts +793 -33
  86. package/.bkit/core/engine/commands/workflow/issues.ts +427 -105
  87. package/.bkit/core/engine/commands/workflow/ledgers.ts +884 -27
  88. package/.bkit/core/engine/commands/workflow/locks.ts +26 -2
  89. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +582 -0
  90. package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
  91. package/.bkit/core/engine/commands/workflow/prs.ts +166 -30
  92. package/.bkit/core/engine/commands/workflow/repo.ts +59 -7
  93. package/.bkit/core/engine/commands/workflow/roadmap.ts +16 -7
  94. package/.bkit/core/engine/commands/workflow/run-facts.ts +501 -0
  95. package/.bkit/core/engine/commands/workflow/runs.ts +179 -49
  96. package/.bkit/core/engine/commands/workflow/runtime.ts +22 -1
  97. package/.bkit/core/engine/commands/workflow/status.ts +142 -29
  98. package/.bkit/core/engine/commands/workflow/step-table.ts +339 -0
  99. package/.bkit/core/engine/commands/workflow/steps.ts +213 -88
  100. package/.bkit/core/engine/commands/workflow/summary.ts +398 -0
  101. package/.bkit/core/engine/commands/workflow/tests.ts +1013 -148
  102. package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
  103. package/.bkit/core/engine/commands/workflow/workflows.ts +984 -207
  104. package/.bkit/core/engine/commands/workflow/workstreams.ts +11 -5
  105. package/.bkit/core/engine/commands/workflow/worktrees.ts +276 -22
  106. package/.bkit/core/engine/install/manifest.ts +11 -9
  107. package/.bkit/core/engine/install/modules/cloud.ts +21 -13
  108. package/.bkit/core/engine/install/modules/core.ts +325 -7
  109. package/.bkit/core/engine/install/modules/opencode.ts +2 -2
  110. package/.bkit/core/engine/install/version-file.ts +6 -2
  111. package/.bkit/core/engine/ledgers/migrate.ts +92 -0
  112. package/.bkit/core/engine/ledgers/status.ts +92 -15
  113. package/.bkit/core/engine/ledgers/telemetry.ts +1261 -254
  114. package/.bkit/core/engine/render/hosts.ts +4 -0
  115. package/.bkit/core/engine/render/models.ts +12 -0
  116. package/.bkit/core/engine/shared/branches.ts +4 -1
  117. package/.bkit/core/engine/shared/egress.ts +7 -0
  118. package/.bkit/core/engine/shared/json.ts +25 -7
  119. package/.bkit/core/engine/shared/settings.ts +202 -33
  120. package/.bkit/core/engine/shared/text.ts +361 -0
  121. package/.bkit/core/engine/tools/grammar-density.ts +215 -0
  122. package/.bkit/core/engine/tools/instructions-sources.ts +834 -0
  123. package/.bkit/core/engine/tools/instructions.ts +1751 -0
  124. package/.bkit/core/hooks/gateguard-engine.js +24 -23
  125. package/.bkit/core/hooks/guardrails-shell.js +2 -3
  126. package/.bkit/core/hooks/guardrails-tiers.js +7 -1
  127. package/.bkit/core/hooks/readguard-engine.js +2 -2
  128. package/.bkit/core/prompts/bkit-audit-generate.md +62 -25
  129. package/.bkit/core/prompts/bkit-build-challenge-1.md +40 -17
  130. package/.bkit/core/prompts/bkit-build-challenge-2.md +44 -17
  131. package/.bkit/core/prompts/bkit-build-install-skills.md +26 -13
  132. package/.bkit/core/prompts/bkit-build-plan-convert.md +74 -0
  133. package/.bkit/core/prompts/bkit-build-plan-current.md +26 -13
  134. package/.bkit/core/prompts/bkit-build-plan-execute.md +74 -26
  135. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +64 -23
  136. package/.bkit/core/prompts/bkit-build-plan-verify.md +57 -33
  137. package/.bkit/core/prompts/bkit-debug-abort-handover.md +30 -14
  138. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +34 -14
  139. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +34 -17
  140. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +26 -13
  141. package/.bkit/core/prompts/bkit-debug-failure-soak.md +31 -16
  142. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +21 -11
  143. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +20 -11
  144. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +20 -11
  145. package/.bkit/core/prompts/bkit-design-generate.md +33 -13
  146. package/.bkit/core/prompts/bkit-design-organise.md +25 -12
  147. package/.bkit/core/prompts/bkit-design-review-1.md +31 -15
  148. package/.bkit/core/prompts/bkit-design-review-2.md +28 -13
  149. package/.bkit/core/prompts/bkit-design-spike.md +30 -13
  150. package/.bkit/core/prompts/bkit-design-update.md +33 -19
  151. package/.bkit/core/prompts/bkit-plan-generate.md +75 -19
  152. package/.bkit/core/prompts/bkit-plan-review-1.md +50 -27
  153. package/.bkit/core/prompts/bkit-plan-review-2.md +59 -28
  154. package/.bkit/core/prompts/bkit-plan-scope-check.md +109 -0
  155. package/.bkit/core/prompts/bkit-plan-update.md +61 -24
  156. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +27 -15
  157. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +31 -16
  158. package/.bkit/core/prompts/bkit-ship-update-docs.md +30 -15
  159. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +24 -14
  160. package/.bkit/core/prompts/bkit-utility-update-decisions.md +32 -14
  161. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +29 -14
  162. package/.bkit/core/prompts/bkit-utility-update-documentation.md +28 -13
  163. package/.bkit/core/prompts/bkit-utility-update-failures.md +31 -14
  164. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +33 -14
  165. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +38 -17
  166. package/.bkit/core/prompts/bkit-utility-update-tracker.md +43 -20
  167. package/.bkit/core/workflows/bkit-auto.md +54 -46
  168. package/.bkit/core/workflows/bkit-build.md +577 -458
  169. package/.bkit/core/workflows/bkit-debug.md +348 -333
  170. package/.bkit/core/workflows/bkit-design.md +201 -237
  171. package/.bkit/core/workflows/bkit-plan.md +210 -321
  172. package/.bkit/core/workflows/bkit-ship.md +328 -278
  173. package/.bkit/shared/.bkit/.env.example +2 -2
  174. package/.bkit/shared/.claude/settings.json +11 -0
  175. package/.bkit/shared/.cursor/mcp.json +1 -1
  176. package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
  177. package/.bkit/shared/.gitattributes +1 -1
  178. package/.bkit/shared/.mcp.json +1 -1
  179. package/.bkit/shared/.opencode/opencode.json +11 -0
  180. package/.bkit/shared/CLAUDE.md +2 -2
  181. package/.bkit/shared/GEMINI.md +2 -2
  182. package/.bkit/shared/docs/architecture.md +1 -1
  183. package/.bkit/shared/docs/data-schema.md +1 -1
  184. package/.bkit/shared/docs/deployments.md +16 -28
  185. package/.bkit/shared/docs/design.md +1 -1
  186. package/.bkit/shared/docs/noise.md +1 -1
  187. package/.bkit/shared/docs/observability.md +2 -2
  188. package/.bkit/shared/docs/security.md +1 -1
  189. package/.bkit/shared/docs/setup.md +1 -1
  190. package/.bkit/shared/docs/technology.md +1 -1
  191. package/.bkit/shared/docs/testing.md +27 -10
  192. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +1 -1
  193. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +26 -5
  194. package/.bkit/templates/.github/workflows/bkit-ci.yml +22 -84
  195. package/.bkit/templates/.github/workflows/bkit-cloud.yml +21 -19
  196. package/.bkit/templates/.husky/pre-push +52 -13
  197. package/.bkit/templates/.prettierignore +7 -0
  198. package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +194 -0
  199. package/.bkit/templates/scripts/ci/check-capstone.mjs +2 -4
  200. package/.bkit/templates/scripts/ci/check-capstone.test.mjs +4 -23
  201. package/.bkit/templates/scripts/ci/lanes/resolve-push-base.mjs +104 -23
  202. package/.bkit/templates/scripts/ci/lanes/resolve-push-base.test.mjs +103 -6
  203. package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +1 -1
  204. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +3 -1
  205. package/.bkit/templates/scripts/prettier/bkit-insert-ignore.mjs +49 -29
  206. package/CHANGELOG.md +142 -0
  207. package/README.md +58 -34
  208. package/dist/checks/after/ci-yml.js +39 -29
  209. package/dist/checks/after/github.js +99 -72
  210. package/dist/checks/after/index.js +11 -13
  211. package/dist/checks/after/suppression.js +8 -5
  212. package/dist/checks/after/tools.js +40 -83
  213. package/dist/checks/before/env.js +2 -2
  214. package/dist/checks/before/files.js +5 -3
  215. package/dist/checks/before/index.js +15 -2
  216. package/dist/checks/before/repo.js +163 -2
  217. package/dist/checks/tips/catalogue.js +14 -5
  218. package/dist/checks/tips/detect.js +32 -0
  219. package/dist/checks/tips/index.js +7 -5
  220. package/dist/cli.js +19 -47
  221. package/dist/commands/analysis.js +109 -100
  222. package/dist/commands/ci/ci.js +6 -6
  223. package/dist/commands/comply.js +54 -91
  224. package/dist/commands/install/doctor.js +2 -2
  225. package/dist/commands/install/install.js +50 -19
  226. package/dist/commands/install/uninstall.js +59 -28
  227. package/dist/commands/land.js +16 -12
  228. package/dist/commands/lib.js +51 -16
  229. package/dist/commands/registry.js +4 -0
  230. package/dist/commands/setup/setup.js +7 -7
  231. package/dist/commands/stats.js +136 -0
  232. package/dist/commands/tips.js +7 -3
  233. package/dist/commands/workflow/branches.js +656 -56
  234. package/dist/commands/workflow/challenge.js +556 -0
  235. package/dist/commands/workflow/context.js +709 -30
  236. package/dist/commands/workflow/counters.js +208 -75
  237. package/dist/commands/workflow/decisions.js +441 -0
  238. package/dist/commands/workflow/disk.js +2 -2
  239. package/dist/commands/workflow/fids.js +689 -33
  240. package/dist/commands/workflow/issues.js +362 -99
  241. package/dist/commands/workflow/ledgers.js +762 -27
  242. package/dist/commands/workflow/locks.js +24 -2
  243. package/dist/commands/workflow/plan-blocks.js +437 -0
  244. package/dist/commands/workflow/plan-versions.js +22 -0
  245. package/dist/commands/workflow/prs.js +142 -32
  246. package/dist/commands/workflow/repo.js +52 -7
  247. package/dist/commands/workflow/roadmap.js +9 -7
  248. package/dist/commands/workflow/run-facts.js +426 -0
  249. package/dist/commands/workflow/runs.js +144 -43
  250. package/dist/commands/workflow/runtime.js +12 -1
  251. package/dist/commands/workflow/status.js +130 -29
  252. package/dist/commands/workflow/step-table.js +276 -0
  253. package/dist/commands/workflow/steps.js +171 -80
  254. package/dist/commands/workflow/summary.js +275 -0
  255. package/dist/commands/workflow/tests.js +834 -136
  256. package/dist/commands/workflow/tracker.js +983 -0
  257. package/dist/commands/workflow/workflows.js +834 -195
  258. package/dist/commands/workflow/workstreams.js +11 -5
  259. package/dist/commands/workflow/worktrees.js +221 -22
  260. package/dist/install/manifest.js +11 -9
  261. package/dist/install/modules/cloud.js +22 -13
  262. package/dist/install/modules/core.js +326 -7
  263. package/dist/install/modules/opencode.js +2 -2
  264. package/dist/install/version-file.js +6 -2
  265. package/dist/ledgers/migrate.js +81 -0
  266. package/dist/ledgers/status.js +61 -8
  267. package/dist/ledgers/telemetry.js +905 -124
  268. package/dist/render/hosts.js +4 -0
  269. package/dist/render/models.js +12 -0
  270. package/dist/shared/branches.js +3 -1
  271. package/dist/shared/egress.js +7 -0
  272. package/dist/shared/json.js +20 -7
  273. package/dist/shared/settings.js +147 -26
  274. package/dist/shared/text.js +333 -0
  275. package/dist/tools/grammar-density.js +183 -0
  276. package/dist/tools/instructions-sources.js +721 -0
  277. package/dist/tools/instructions.js +1579 -0
  278. package/package.json +114 -23
  279. package/.bkit/core/engine/commands/harvest.ts +0 -459
  280. package/.bkit/core/engine/tools/wording.ts +0 -748
  281. package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
  282. package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
  283. package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
  284. package/.bkit/core/prompts/bkit-build-summary.md +0 -94
  285. package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
  286. package/.bkit/core/prompts/bkit-design-summary.md +0 -107
  287. package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
  288. package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
  289. package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
  290. package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
  291. package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
  292. package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
  293. package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
  294. package/.bkit/templates/scripts/ci/lanes/check-tree-cache.mjs +0 -138
  295. package/.bkit/templates/scripts/ci/lanes/check-tree-cache.test.mjs +0 -181
  296. package/dist/commands/harvest.js +0 -353
  297. package/dist/tools/wording.js +0 -680
@@ -11,14 +11,6 @@
11
11
  >
12
12
  > **Rules:**
13
13
  >
14
- > - Read-only audit; never edit code, config, or data.
15
- > - `Universal Instructions` apply to all projects; `Project Instructions` apply only to this project.
16
- > - Local audit instructions / overrides → `Project Instructions` below the bkit-managed block; universal instructions stay in-block.
17
- > - Any tools mentioned in `Universal Instructions` are examples only; swap for actual tools in final output; drop inapplicable.
18
- > - Use dense token-efficient phrasing; no filler / hedging / restating; tables > prose, bullets > paragraphs.
19
- > - Read `.agents/docs.md` → load docs for workflow / step / task; skip missing; cite docs inline where required.
20
- > - Every claim cites this run's evidence (`file:line`, or command / query and its output) and tool behind it; a previous report's figure, list, or status is a lead, not evidence.
21
- > - Read this document once at session start; do not trust session memory; do not re-read on every loop iteration.
22
14
  > - NEVER commit, push, or start a metered native build to produce shots. Use an artifact that already exists.
23
15
  > - Seeded-defect copies stay in scratch. never write them into the app, the manifest under test, or this report as product shots.
24
16
  > - Session notes name the segment, not the person. never copy a personal-data value from a screen into the report.
@@ -33,7 +25,7 @@ Automated checks never look at a screen. They pass when a title is centred on on
33
25
 
34
26
  **Cadence:** monthly. Extra pass when a shared component, the palette, or a route's layout changes. Every second run includes the sessions in `Sessions`.
35
27
 
36
- **Anchor Standards:** record version and date read. Newer version → `Standards` step reads what changed.
28
+ **Anchor Standards:**
37
29
 
38
30
  - Nielsen's 10 usability heuristics (NN/g, the 1994 set).
39
31
  - NN/g severity ratings: frequency, impact, and persistence.
@@ -70,49 +62,39 @@ Automated checks never look at a screen. They pass when a title is centred on on
70
62
 
71
63
  ### Pre-Flight / Dependencies
72
64
 
73
- **Checkpoint:** Check off all core items. Check conditional items only when applicable. Each item: available → tool and version; missing → fallback, gap in `Not Checked`, fix in `Process Improvements`. Unnamed gap reads as passed. never abort for a missing capability.
74
-
75
- **Credentials:** probe direnv before marking a token / env var missing: `direnv exec . sh -c '[ -n "${VAR}" ] && echo set || echo unset'`; `unset` = missing. Run credentialed CLIs as `direnv exec . <cmd>`. No direnv (cloud session) → plain env check. Report names, never values.
76
-
77
65
  #### Core
78
66
 
79
- Always verify.
80
-
81
- - [ ] **Permissions:** Before Step 1 — one cheap read-only call per tool this run uses (every item below, every rule under `Project Instructions` `Permissions`), e.g. `gh run list --limit 1`, one MCP read, one anchor-standard fetch. Blocked / denied (here or in any step) → record call verbatim and narrow allow rule clearing it (e.g. `Bash(gh run list *)`) in `Not Checked`, `Process Improvements`, and `Project Instructions` `Permissions`; run every step the remaining tools allow; work needing blocked call → `Not Checked`. never stop the run for a blocked call; never retry or reword a blocked call to get past it.
82
- - [ ] **Screens:** Steps 2, 7–14 — open product (local or existing preview). Fallback: drawings and source only; live claims = hypotheses.
67
+ - [ ] **Permissions:** blocked calls recorded
68
+ - [ ] **Screens:** Steps 2, 7-14 — open product (local or existing preview). Fallback: drawings and source only; live claims = hypotheses.
83
69
  - [ ] **Drawings:** Steps 5, 7, 9 — reference drawings readable. Fallback: live vs live only; drawing comparison `Not Checked`.
84
70
  - [ ] **Web:** Step 15 — fetch anchor standards. Fallback: versions recorded as unread.
85
71
 
86
72
  #### Conditional
87
73
 
88
- Verify only when applicable.
89
-
90
- - [ ] **Capture Artifact:** Screenshot-capture pipeline exists, finished run's artifact inside retention window → Steps 3–6. Fallback: hand walk; capture `Not Checked`. NEVER push or start a run.
91
- - [ ] **Vision:** Image review → Steps 5–6 — agent opens every PNG. Fallback: hand comparison; record images not opened.
74
+ - [ ] **Capture Artifact:** Screenshot-capture pipeline exists, finished run's artifact inside retention window → Steps 3-6. Fallback: hand walk; capture `Not Checked`. NEVER push or start a run.
75
+ - [ ] **Vision:** Image review → Steps 5-6 — agent opens every PNG. Fallback: hand comparison; record images not opened.
92
76
  - [ ] **Phone Runtimes:** Phone apps ship → Step 8 — simulator, emulator, or device. Fallback: web only; phone `Not Checked`.
93
77
  - [ ] **Locale Catalogue:** More than one locale, or a pseudo-locale → Step 8. Fallback: source-language copy only.
94
78
  - [ ] **Participants:** Session run → Step 11. Fallback: last round's date and next due date; figures `Not Checked`.
95
79
 
96
80
  ### 🔒 Gate 1: Prerequisites Check
97
81
 
98
- **Checkpoint.** Verify and check `[x]` all applicable boxes above, then continue to `Probe Steps` without asking.
99
-
100
82
  - [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
101
- - [ ] **Gate 1 - Verified:** All Core items checked. All applicable Conditional items checked.
83
+ - [ ] **Gate 1 — Verified:** All Core items checked. All applicable Conditional items checked.
102
84
 
103
85
  ### Probe Steps
104
86
 
105
- - [ ] **Step 1 — Previous Run:** Audited commit = this report's `bkit:anchor` `baseSha`. Read newest prior report for this slug under `docs/audits/`; its commit = its `bkit:anchor` `baseSha`, else the HEAD its `Previous Run` recorded. Count findings fixed / still open; age of oldest open. Open after 2 runs → re-raise with age. **Done when:** closure rate in `Previous Run`, or run marked baseline.
87
+ - [ ] **Step 1 — Previous Run:** **Done when:** closure rate in `Previous Run`, or run marked baseline.
106
88
  - [ ] **Step 2 — Signals:** Since previous report: funnel drop-off on core flows, support tickets, store-review themes, in-app feedback. Top 5 complaints → each a finding or explained by run end. No users yet → `no users yet`. Missing or untrustworthy funnel data stays listed; fix → `bkit-audit-analytics`. **Done when:** `Signals` holds the five, or `no users yet`.
107
89
  - [ ] **Step 3 — Capture:** Project has a screenshot-capture pipeline (`Project Instructions` names it, incl. how a run opts in, e.g. commit-message marker) → use finished run with artifact still inside retention window. No pipeline or no such run → hand walk; capture `Not Checked`. Record run id, event type, opt-in markers. Fetch and review before artifact expires. **Done when:** run id in `Capture`, or absence recorded.
108
90
  - [ ] **Step 4 — Manifest:** Download that run's report artifact. Read manifest and gap step in same job's log, where the pipeline emits them: every route and test id the run did not reach → this run's blind spot. **Done when:** manifest path in `Capture` and gap list in `Gaps`, or skip recorded.
109
- - [ ] **Step 5 — Review:** Side-by-side image per row. Reviewer opens every image; reads each row (drawing, viewport, full page, each platform with a cell). Rules: rows, not pairs (one row per screen × state × size × theme the pipeline captures); status bar, home indicator, and keyboard are never findings; blocked or missing native cell = pipeline or surface with no phone screen, never app defect; cut drawing stops at control its state is about — region below cut not missing; viewport↔viewport, full page↔full page (heights differ by construction); same scale → metrics may compare, different scale → layout and presence only. Inventory on full-page pair only: items in drawing missing from app, items in app missing from drawing — names, not counts; do not fold inventory into parity severity. Verdicts not deterministic → Step 7. **Done when:** every row has verdict or explicit skip; `Inventory` names both directions or `none`.
91
+ - [ ] **Step 5 — Review:** Side-by-side image per row. Reviewer opens every image; reads each row (drawing, viewport, full page, each platform with a cell). Rules: rows, not pairs (one row per screen x state x size x theme the pipeline captures); status bar, home indicator, and keyboard are never findings; blocked or missing native cell = pipeline or surface with no phone screen, never app defect; cut drawing stops at control its state is about — region below cut not missing; viewport↔viewport, full page↔full page (heights differ by construction); same scale → metrics may compare, different scale → layout and presence only. Inventory on full-page pair only: items in drawing missing from app, items in app missing from drawing — names, not counts; do not fold inventory into parity severity. Verdicts not deterministic → Step 7. **Done when:** every row has verdict or explicit skip; `Inventory` names both directions or `none`.
110
92
  - [ ] **Step 6 — Canary:** Run that finds nothing reads like blind reviewer. Copy few rows' shots to scratch; seed known defects (title off centre, truncated button label, blank drawn empty state). Point manifest copy at them; review those rows only. Record hit rate. Missed seed = pipeline finding, not app defect. **Done when:** hit rate in `Canary`.
111
93
  - [ ] **Step 7 — Verify:** No finding counts until PNG and live screen at same width and theme opened; drawing compared and wins on arrangement when they disagree; pipeline ruled out; value or control checked for second implementation (platform file split, both consumers). Second copy still recorded here → belongs to `bkit-audit-duplication`. Each finding cites PNG, live screen, drawing, or source line. **Done when:** every finding has that evidence.
112
94
  - [ ] **Step 8 — Hand Checks:** What shots do not cover. While phone cells blocked → walk primary flows on each phone platform, light and dark, against same drawings. States seed does not produce (empty, loading, failed request): each not seen = unchecked, not clean. Longer text in pseudo-locale; source detail → `bkit-audit-accessibility`. Translations: every key in every locale, no source-language on translated screen, no sentence from joined strings; then read every locale for meaning. Dates, numbers, currency use locale format. Plurals: counts reaching every category locale has (0, 1, 2, 5, 21 cover most) — right branch, not raw pattern or source-language form. Right-to-left target locale → walk primary flow once. Plain language: UI copy and email ~grade 8; one word per concept everywhere; no internal jargon. Findability: five lookups `Project Instructions` name; flag path over 3 taps or clicks. Phone conventions: back gesture and system back, native date/time pickers, share sheet, haptics, safe areas, pull-to-refresh, tab bar. Web: links open in place, browser back works, every screen has URL that opens directly. Notifications and email: worth sending, open right screen; frequency and quiet-hours settings; permission in context when first needed, not at first launch. Poor network on phone: slow/flaky, offline, backgrounding mid-flow, low-end device — record what user sees, whether action queues or fails loudly, whether every skeleton and spinner resolves. Switching devices: start task on phone, finish on web; state, drafts, notifications agree. Plans: comparison understandable, prices show tax and currency, downgrade, and cancel take no more steps than upgrade, no confirm-shaming, and no hidden cancel path. Consumer-law wording → `bkit-audit-privacy`. Everything in `Gaps`. **Done when:** `Hand Checks` lists each item checked, unchecked, or not applicable.
113
95
  - [ ] **Step 9 — First Run:** Capture account already full. Walk new-user path by hand, as journey, each platform, fresh synthetic account teardown can reap. One row per point: screens and taps, dead ends, words that assume knowledge, verdict per platform. (1) Sign up on web, including confirmation message and link, through first landing — check message, not only screens. (2) Install on phone first — create account? If not, screen says where to go? (3) Multi-tenant → tenant created for them: understand it exists, see and change name, find address or id given. (4) Empty primary screens — each says what to do next or is blank; no drawing of empty state → finding for drawing first: decide, draw, then build. (5) First record by hand from empty screen — appears where expected, empty-state message goes away. (6) Product ingests items from outside app (e.g. forwarded email, upload) → first item: what they see while processing, reply text, when nothing extractable. (7) Invitations exist → join by invitation — different first run, arrive in full tenant. (8) Come back: sign out, sign in, recovery path once; note drawings promise what app lacks. (9) First plan gate or paywall in first session — what it says, whether next step clear. **Done when:** `First Run` has one row per point; condition unmet → `N/A` row with evidence.
114
96
  - [ ] **Step 10 — Heuristics:** Drawing says how screen should look; nothing above asks whether drawn design is usable — screen matching bad drawing passes. Walk each primary flow; check every screen against Nielsen's 10 heuristics. Each violation = finding with heuristic (`H1` visibility of system status through `H10` help and documentation). Same problem in drawing → finding for drawing first. **Done when:** each primary flow has line in `Checked`; violations are findings.
115
- - [ ] **Step 11 — Sessions:** Screenshot review ≠ user evidence. Every second run: same scripted tasks with real people — five participants from segments `Project Instructions` name; think-aloud; one script in `Sessions` for next round. Per task: success (unaided, with help, failed), time on task, Single Ease Question. Per session: SUS or UMUX-Lite — pick one, keep it. Each figure beside previous session. No participants → last round's date and next due; do not invent figures. **Done when:** `Sessions` holds figures beside previous session, or next due date.
97
+ - [ ] **Step 11 — Sessions:** Screenshot review != user evidence. Every second run: same scripted tasks with real people — five participants from segments `Project Instructions` name; think-aloud; one script in `Sessions` for next round. Per task: success (unaided, with help, failed), time on task, Single Ease Question. Per session: SUS or UMUX-Lite — pick one, keep it. Each figure beside previous session. No participants → last round's date and next due; do not invent figures. **Done when:** `Sessions` holds figures beside previous session, or next due date.
116
98
  - [ ] **Step 12 — AI Features:** Each user-visible result feature vs human-AI guidelines — user sees what it did and why; each extracted field correctable, each created item undoable; low-confidence flagged, not silently saved; failure says what happened and next step (Step 9 point 6 covers first). Screen already does this, fault is model output → `bkit-audit-llm`. **Done when:** `AI Features` row per feature: guideline · what the user sees · verdict.
117
99
  - [ ] **Step 13 — Errors:** Trigger every validation and server error on primary forms — each says what happened and how to fix, plain language, next to field. Input survives failed submit, offline mid-form, session expiry. Every destructive action: undo or confirmation, same on every platform, not most prominent when drawing shows otherwise. **Done when:** `Errors` row per form and per destructive action.
118
100
  - [ ] **Step 14 — Dates:** Product with dates, times, or recurrence → accounts in different locales and timezones. Date format, first day of week, and 12- or 24-hour time follow the locale. Members in different timezones: which timezone each sees, whether app says so when they differ. Event crossing daylight-saving change keeps wall-clock time. Editing recurring event: choice (this event, this and following, all events) clear, each does what it says. No dates → skip with evidence. **Done when:** `Dates` holds answers, or skip recorded.
@@ -121,13 +103,11 @@ Verify only when applicable.
121
103
 
122
104
  ### 🔒 Gate 2: Probes Check
123
105
 
124
- **Checkpoint.** Verify and check `[x]` all boxes below, then continue to `Findings` without asking.
125
-
126
106
  - [ ] **Steps complete:** every step `[x]`, or explicit skip with evidence the surface is absent.
127
107
  - [ ] **Evidence:** every finding cites re-checkable evidence and the tool behind it.
128
108
  - [ ] **Canary isolated:** seeded copies are not product shots in this report, and were not written into the app.
129
109
  - [ ] **Pipeline ruled out:** no finding is OS chrome, the region below a cut drawing, or a blocked native cell.
130
- - [ ] **Gate 2 - Verified:** Every checkbox above independently verified and checked off.
110
+ - [ ] **Gate 2 — Verified:** Every checkbox above independently verified and checked off.
131
111
 
132
112
  ## Findings
133
113
 
@@ -136,10 +116,10 @@ Verify only when applicable.
136
116
  | --- | --- |
137
117
  | `CRITICAL` | Broken primary flow with no workaround; typed input or a record lost with no recovery; destructive action with no undo that loses data |
138
118
  | `HIGH` | User cannot finish a task, and a workaround exists; empty first screen with no next step; destructive confirmation missing on one platform |
139
- | `MEDIUM` | Screen ≠ drawing, the drawing is right, and it stops nobody; error text that does not say how to fix it; wrong locale format; one concept named two ways |
119
+ | `MEDIUM` | Screen != drawing, the drawing is right, and it stops nobody; error text that does not say how to fix it; wrong locale format; one concept named two ways |
140
120
  | `LOW` | Cosmetic mismatch; region below a cut drawing reported as missing and then corrected to not-reached |
141
121
 
142
- Scale per `.bkit/jsonl.md` § Severity. Within a severity: blocked tasks first. Set bucket from frequency (how many users meet it), impact (whether they can get past it), persistence (whether it bothers them every time). Task user cannot finish = `HIGH`, or `CRITICAL` with no workaround. Drawing mismatch that stops nobody = `MEDIUM` or `LOW`.
122
+ Within a severity: blocked tasks first. Set bucket from frequency (how many users meet it), impact (whether they can get past it), persistence (whether it bothers them every time). Task user cannot finish = `HIGH`, or `CRITICAL` with no workaround. Drawing mismatch that stops nobody = `MEDIUM` or `LOW`.
143
123
 
144
124
  <!-- prettier-ignore -->
145
125
  | ID | Severity | Location | Evidence | Expected |
@@ -231,17 +211,13 @@ PENDING
231
211
 
232
212
  ### 🔒 Gate 3: Report Check
233
213
 
234
- **Checkpoint.** Verify and check `[x]` all boxes below, then stop.
235
-
236
- - [ ] **No placeholders:** Findings table and every `Report` section have no `PENDING`.
214
+ - [ ] **No placeholders:** no `PENDING` left
237
215
  - [ ] **Summary:** names count per severity, cells captured vs blocked per platform, and the canary hit rate.
238
216
  - [ ] **Series:** every series beside previous report's numbers, or marked baseline.
239
- - [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
240
- - [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
217
+ - [ ] **Writes:** only this report, template `Project Instructions`, and ledger rows changed; throwaway worktrees / remote targets removed.
218
+ - [ ] **Process Improvements:** `Universal` and `Project` filled
241
219
  - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
242
- - [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
243
-
244
- > `Project Instructions` below `bkit:end` are consumer-owned — `bkit install` never overwrites them, `bkit check` drift stays clean. Add project-specific tools, paths, commands, and checks there, keyed by section or step title; never results.
220
+ - [ ] **Gate 3 — Verified:** Every checkbox above independently verified and checked off.
245
221
 
246
222
  <!-- bkit:end -->
247
223