@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
@@ -1,39 +1,32 @@
1
- <!-- Note: Reports live at `docs/audits/{YYYYMM}/{slug}.md`. `{YYYYMM}` = UTC month of this run. `{slug}` = template basename without `bkit-audit-` and `.md`. **If** that month already has `{slug}.md` or `{slug}-{TIMESTAMP}.md` → write `{slug}-{TIMESTAMP}.md` (`{TIMESTAMP}` = `date -u +%Y%m%dT%H%M%SZ`). Never overwrite. The report is stamped with a `bkit:anchor` block recording the audited commit (`baseSha`) and branch (`baseRef`); never hand-author or edit it. `@bkit-audit-generate` fills this template. -->
2
-
3
1
  <!-- bkit:start -->
4
2
 
5
3
  {{BKIT_MANAGED_MARKER}}
6
4
 
5
+ <!-- Note: @bkit-audit-generate fills this template. The report lives at `docs/audits/{YYYYMM}/{slug}.md`, where `{YYYYMM}` is the UTC month of the run and `{slug}` is this file's name without `bkit-audit-` and `.md`. **If** that month already has `{slug}.md` or `{slug}-{TIMESTAMP}.md` → write `{slug}-{TIMESTAMP}.md`, where `{TIMESTAMP}` is the output of `date -u +%Y%m%dT%H%M%SZ`. NEVER overwrite an earlier report. The report is stamped with a `bkit:anchor` block that records the audited commit (`baseSha`) and branch (`baseRef`). NEVER write or edit that block by hand. -->
6
+
7
7
  # App Store Audit
8
8
 
9
9
  > [!CAUTION]
10
- > **Purpose:** Whether iOS and Android apps can ship and stay listed — deadlines, privacy declarations, permissions, signing credentials, review readiness, and once live: crashes, ratings, listing.
10
+ > **Purpose:** Whether the iOS and Android apps can ship and stay listed: deadlines, privacy declarations, permissions, signing credentials and review readiness, and, once live, crashes, ratings and the listing.
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
- > - NEVER submit a build, change a listing, accept an agreement, submit a declaration, or create, rotate, or download a credential.
23
- > - never copy certificate, key, token, or password material into the report; expiry, holder, and recovery path only.
24
- > - Every store, deadline, and credential claim names the platform and the account it was read from.
14
+ > - NEVER submit a build, change a listing, accept an agreement, submit a declaration, or create, rotate or download a credential.
15
+ > - NEVER copy certificate, key, token or password material into the report.
16
+ > - Record a credential's expiry, holder and recovery path only.
17
+ > - Name the platform, and the account it was read from, in every store, deadline and credential claim.
25
18
 
26
19
  ## Universal Instructions
27
20
 
28
21
  ### Context & Goals
29
22
 
30
- Stores change rules on their own schedule. New target API, higher upload SDK, privacy manifest, or in-app account deletion arrives with a deadline. Miss one → next release blocked when needed, or listing hidden from new users. Nothing else watches this plane. Native builds on hosted builder (if used) may fail with no error-tracker issue. Review, policy notices, certificate expiry → email to account holder. Target failure: **a release blocked, or a listing hidden, by a deadline, declaration, or credential nobody tracked.**
23
+ Stores change their rules on their own schedule. A new target API, a higher upload SDK, a privacy manifest or in-app account deletion arrives with a deadline. A missed deadline blocks the next release when it is needed, or hides the listing from new users. Nothing else watches the store side of the app. Native builds on a hosted builder, where one is used, can fail without raising an error-tracker issue. Review notices, policy notices and certificate expiry notices go by email to the account holder. The failure this audit targets is a release blocked, or a listing hidden, by a deadline, declaration or credential that nobody tracked.
31
24
 
32
- **Applies when:** native app prepared for store or already listed. None → one `N/A` row with evidence, never "clean". Before first submission, readiness steps still run; live-only steps → one `N/A` row with evidence, never "clean". Steps name Apple App Store and Google Play; other stores (e.g. Amazon Appstore, Microsoft Store, Huawei AppGallery) → equivalent policy pages, or `N/A` per step with evidence.
25
+ **Applies when:** a native app is being prepared for a store, or is already listed. **If** neither holds → write one `N/A` row with its evidence, and never report the surface as "clean". Before the first submission, the readiness steps still run. **If** the app is not yet listed → for each live-only step, write one `N/A` row with its evidence, and never report the surface as "clean". The steps name the Apple App Store and Google Play. **If** the app ships to another store (e.g., Amazon Appstore, Microsoft Store, Huawei AppGallery) → use that store's equivalent policy pages, or write `N/A` per step with its evidence.
33
26
 
34
- **Cadence:** monthly. Extra pass after yearly conference that sets upload minimums (e.g. Apple's June developer conference) and after yearly target-API announcement (e.g. Google Play).
27
+ **Cadence:** Run once a month. Run an extra pass after the yearly conference that sets upload minimums (e.g., Apple's June developer conference), and after the yearly target-API announcement (e.g., Google Play).
35
28
 
36
- **Anchor Standards:** record version and date read. Newer version → `Standards` step reads what changed.
29
+ **Anchor Standards:**
37
30
 
38
31
  - Apple App Review Guidelines. Record last-updated date.
39
32
  - Apple upcoming requirements and Apple developer news. Record newest item read.
@@ -42,106 +35,170 @@ Stores change rules on their own schedule. New target API, higher upload SDK, pr
42
35
  - Google Play Developer Program Policy: User Data, Permissions, Families, and Data safety. Record date read and newest policy-update announcement.
43
36
  - Play target API level requirement and 16 KB page-size requirement. Record required level and each date.
44
37
  - Android vitals. Record core vitals and their thresholds.
45
- - Native framework and build-service docs (e.g. Expo and EAS). Record SDK version in use and support window.
46
- - Age-assurance rules as stores apply them (e.g. Apple's Texas SB 2420 update, Google Play Age Signals API). Record jurisdictions in force on run date.
38
+ - Native framework and build-service docs (e.g., Expo and EAS). Record SDK version in use and support window.
39
+ - Age-assurance rules as stores apply them (e.g., Apple's Texas SB 2420 update, Google Play Age Signals API). Record jurisdictions in force on run date.
47
40
 
48
41
  ### Scope
49
42
 
50
- - Store state, accepted agreements, pending declarations, per platform.
51
- - Deadlines, and guideline and policy diff since previous run.
52
- - Store privacy declarations in depth — privacy manifest, store privacy labels, data-safety form — each matched to `bkit-audit-privacy`'s inventory and privacy policy. This audit does not rebuild that inventory.
53
- - Permissions, including restricted-permission declarations.
54
- - Store and push signing credentials: expiry, holder, recovery path.
55
- - Universal links and App Links against store build.
56
- - Once live: stability, store vitals, ratings, review prompts, releases, whether listing is true.
57
- - Listing fields, localisation, screenshots, conversion.
58
- - Review readiness: demo account, sign-in rules, how digital goods are sold, update-without-review limits, tablet, export compliance, trader status, pre-launch report, accessibility nutrition labels.
59
- - Age rating and age assurance.
43
+ - Read the store state, the accepted agreements and the pending declarations for each platform.
44
+ - Check the deadlines, and the guideline and policy changes since the previous run.
45
+ - Check the store privacy declarations in depth (the privacy manifest, the store privacy labels and the data-safety form), and match each one to `bkit-audit-privacy`'s inventory and privacy policy.
46
+ - Do not rebuild that inventory.
47
+ - Check the permissions, including restricted-permission declarations.
48
+ - Check the store and push signing credentials: expiry, holder and recovery path.
49
+ - Check universal links and App Links against the store build.
50
+ - **If** the app is live → check stability, store vitals, ratings, review prompts, releases, and whether the listing is true.
51
+ - Check the listing fields, localisation, screenshots and conversion.
52
+ - Check review readiness: the demo account, sign-in rules, how digital goods are sold, update-without-review limits, tablet, export compliance, trader status, the pre-launch report and accessibility nutrition labels.
53
+ - Check the age rating and age assurance.
60
54
 
61
55
  ### Out of Scope
62
56
 
63
57
  <!-- prettier-ignore -->
64
58
  | Excluded item | Why | Where it belongs |
65
59
  | --- | --- | --- |
66
- | What the app collects; privacy-policy wording; how a child is known | Privacy sweep owns the inventory; declarations here match it | `bkit-audit-privacy` |
67
- | SDK or library upgrade a deadline forces | Dependency sweep | `bkit-audit-dependencies` |
68
- | Crash and ANR clusters as log triage | Logs sweep; the rates stay here | `bkit-audit-logs` |
69
- | Native accessibility beyond the nutrition-label comparison | Accessibility sweep | `bkit-audit-accessibility` |
70
- | Expiry of credentials that are not store or push credentials | Config sweep | `bkit-audit-config` |
71
- | Who should hold store access | Security sweep; the recovery path stays here | `bkit-audit-security` |
72
- | Slow starts, hangs, wake locks, or battery drain as performance work | Performance sweep; the vital stays here | `bkit-audit-app-performance` |
73
- | How the app works, from review themes | Usability sweep; the theme list stays here | `bkit-audit-usability` |
74
- | Association-file hosting and DNS where the store build still matches | Config sweep | `bkit-audit-config` |
75
- | Submitting a build, changing a listing, or touching a credential | Audit reports only | Plan from this report |
60
+ | What the app collects; privacy-policy wording; how a child is known | The privacy audit owns the inventory. Declarations here are matched to it | `bkit-audit-privacy` |
61
+ | SDK or library upgrade a deadline forces | The dependency audit owns it | `bkit-audit-dependencies` |
62
+ | Crash and ANR clusters as log triage | The logs audit owns it. The rates stay here | `bkit-audit-logs` |
63
+ | Native accessibility beyond the nutrition-label comparison | The accessibility audit owns it | `bkit-audit-accessibility` |
64
+ | Expiry of credentials that are not store or push credentials | The config audit owns it | `bkit-audit-config` |
65
+ | Who should hold store access | The security audit owns it. The recovery path stays here | `bkit-audit-security` |
66
+ | Slow starts, hangs, wake locks, or battery drain as performance work | The performance audit owns it. The vital stays here | `bkit-audit-app-performance` |
67
+ | How the app works, from review themes | The usability audit owns it. The theme list stays here | `bkit-audit-usability` |
68
+ | Association-file hosting and DNS where the store build still matches | The config audit owns it | `bkit-audit-config` |
69
+ | Submitting a build, changing a listing, or touching a credential | The audit only reports | A plan made from this report |
76
70
 
77
71
  ### Pre-Flight / Dependencies
78
72
 
79
- **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.
80
-
81
- **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.
82
-
83
73
  #### Core
84
74
 
85
- Always verify.
86
-
87
- - [ ] **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.
88
- - [ ] **Build Config:** Steps 2–6, 10 — app config and build profiles in repo, e.g. `app.json`, `eas.json`, `project.pbxproj`. Fallback: none; missing config = finding.
89
- - [ ] **Web:** Step 12 — fetch anchor standards and deadline pages. Fallback: versions and dates recorded as unread.
75
+ - [ ] **Permissions:** every blocked call is recorded.
76
+ - [ ] **Build Config:** Steps 2-6, 10 — the app config and build profiles in the repo (e.g., `app.json`, `eas.json`, `project.pbxproj`). Fallback: none. Missing config is a finding.
77
+ - [ ] **Web:** Step 12 — fetch the anchor standards and the deadline pages. Fallback: record the versions and dates as unread.
90
78
 
91
79
  #### Conditional
92
80
 
93
- Verify only when applicable.
94
-
95
- - [ ] **Build Service:** Hosted native builds → Steps 2, 3, 6 — version and build number from service, not local config; last built artifact for native-library alignment, e.g. `eas build:list`, `eas build:view`. Fallback: local config only; remote version = hypothesis.
96
- - [ ] **Store Consoles:** Store accounts exist → Steps 2, 4, 8, 9, 11 — policy status, app content, agreements, listings, e.g. App Store Connect, Play Console. Fallback: repo only; store state `Not Checked`.
97
- - [ ] **Credential Metadata:** Signing material exists → Step 6 — expiry and holder from build service or console, never the material, e.g. `eas credentials`. Fallback: `Not Checked`.
98
- - [ ] **Devices:** Deep links or binary to open → Step 7 — device or emulator with app installed and one without. Fallback: file and config only; opening `Not Checked`.
99
- - [ ] **Vitals:** App is live → Step 8 — store vitals and error tracker, e.g. Play vitals, Xcode Organizer, Sentry, Crashlytics. Fallback: `Not Checked`.
81
+ - [ ] **Build Service:** **If** native builds run on a hosted service → Steps 2, 3, 6 — the version and build number from the service, not the local config, and the last built artifact for native-library alignment (e.g., `eas build:list`, `eas build:view`). Fallback: use the local config only, and treat the remote version as a hypothesis.
82
+ - [ ] **Store Consoles:** **If** store accounts exist → Steps 2, 4, 8, 9, 11 — policy status, app content, agreements and listings (e.g., App Store Connect, Play Console). Fallback: use the repo only, and mark store state `Not Checked`.
83
+ - [ ] **Credential Metadata:** **If** signing material exists → Step 6 — expiry and holder from the build service or console, NEVER the material itself (e.g., `eas credentials`). Fallback: `Not Checked`.
84
+ - [ ] **Devices:** **If** the app has deep links, or a binary to open → Step 7 — a device or emulator with the app installed, and one without it. Fallback: use files and config only, and mark opening `Not Checked`.
85
+ - [ ] **Vitals:** **If** the app is live → Step 8 — store vitals and the error tracker (e.g., Play vitals, Xcode Organizer, Sentry, Crashlytics). Fallback: `Not Checked`.
100
86
 
101
87
  ### 🔒 Gate 1: Prerequisites Check
102
88
 
103
- **Checkpoint.** Verify and check `[x]` all applicable boxes above, then continue to `Probe Steps` without asking.
104
-
105
- - [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
106
- - [ ] **Gate 1 - Verified:** All Core items checked. All applicable Conditional items checked.
89
+ - [ ] **Gaps named:** every missing item names its fallback and its `Not Checked` entry.
90
+ - [ ] **Gate 1 — Verified:** every item above, every Core item and every applicable Conditional item is checked.
107
91
 
108
92
  ### Probe Steps
109
93
 
110
- - [ ] **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.
111
- - [ ] **Step 2 — Store State:** Per platform: version · build from build service when config keeps version remotely, not local app config; store state (not submitted, in review, live); readable accounts. Read Android policy-status and app-content pages, iOS agreements page. Unaccepted updated agreement or pending declaration blocks uploads = finding → account holder, with page. **Done when:** `Store State` table per platform: version · build · target SDK · store state · accounts read · nearest deadline (filled in `Deadlines`).
112
- - [ ] **Step 3 — Deadlines:** Confirm each date on current store page; page wins if it differs. (a) Target API level and date vs app target SDK from last built Android bundle, not config only. (b) Memory page size: date and target API the requirement names (e.g. updates targeting that API cannot ship unless native libraries support 16 KB pages). Check `.so` alignment in last built bundle, not config. Any app shipping native code in scope. (c) Upload minimum SDK and toolchain vs build image. (d) Native framework SDK support window. (e) Store policy announced since previous run. (f) Guideline and policy diff since previous report's date, tested against app, not deadline-only. Due within 90 days = finding. Due within 30 days = at least `HIGH`. Upgrade fix → `bkit-audit-dependencies`. **Done when:** `Deadlines` row per item: requirement · date · app value · verdict.
113
- - [ ] **Step 4 — Declarations:** Match each declaration to `bkit-audit-privacy`'s inventory and privacy policy. Do not rebuild the inventory. (a) iOS privacy manifest — required-reason APIs for app and every third-party SDK — and store privacy labels. (b) Each SDK on vendor's commonly-used list ships own privacy manifest and signature; tracking-domain list names any tracking domain the app contacts. (c) Android data-safety form. (d) Third-party AI: review guideline requiring disclosure where personal data is shared with third parties, including third-party AI, and explicit permission before sharing (e.g. App Review Guideline 5.1.2(i)). In-app consent screen, stored consent flag gating each call, withdraw path, and privacy label describe same flow. Gap → `bkit-audit-privacy`, and plan item for consent screen. (e) Both stores require account deletion started inside the app, not only on the web. The Android form also requires a working web link, entered on the data-safety form, that names the app or developer and lets someone request deletion without reinstalling. Deleting an account revokes Sign in with Apple tokens through the revoke endpoint, and the server handles the server-to-server notifications for revoked consent and deleted accounts (e.g. Apple technote TN3194), when that provider exists. (f) Advertising-id and tracking answers match what `bkit-audit-analytics` found the app collects. Declaration mismatch = at least `HIGH` → `bkit-audit-privacy`. **Done when:** `Declarations` row per label, manifest entry, and form answer: declared · inventory · verdict.
114
- - [ ] **Step 5 — Permissions:** Each requested permission (e.g. camera, photos, location, contacts, notifications) has true purpose string and feature using it. Leftover permission from removed feature = finding — reviewers reject for it. Android: restricted permissions vs store policy. Photos/videos via system photo picker unless broad media access is core; broad media needs approved console declaration. Exact-alarm only for alarms/timers/calendar core apps; others → schedule-exact with user consent. Full-screen intent default only alarm/calling apps; others need user consent and console declaration. Post-notifications at runtime when notification makes sense, not first launch. Unused permission → plan from this report. **Done when:** `Permissions` row per permission: purpose string · feature · verdict.
115
- - [ ] **Step 6 — Credentials:** iOS distribution certificate and provisioning profiles, push key, Android upload key and store app signing, build-service credentials, developer-program membership: each expiry, holder, recovery if holder leaves. Lost upload key with no store app signing → app never updatable = `CRITICAL` until shown otherwise. Include push-messaging service-account credential for current HTTP API; legacy server keys must be unused. Record expiry, holder, recovery path only. Who should hold access → `bkit-audit-security`. Other expiry → `bkit-audit-config`. No owner or no recovery path = at least `HIGH`. **Done when:** `Credentials` row per item: expiry · holder · recovery · verdict.
116
- - [ ] **Step 7 — Links:** Native app with invite/deep links → association files on web domain over HTTPS, no redirect, cover invite/join/email deep-link paths, match shipped apps: iOS team and bundle id; Android SHA-256 fingerprints including store signing key's, not upload key only. Open invite link on device with app and without. Hosting/DNS drift where store build still matches → `bkit-audit-config`. File mismatch vs store build = finding → plan from this report. **Done when:** `Links` row per file and per device case.
117
- - [ ] **Step 8 — Live:** Not listed → `N/A` in `Live`, never "clean"; skip rest. (a) Crash-free sessions; Android ANR rate — store vitals, Xcode Organizer, error tracker. Compare crash/ANR vs overall and per-device bad-behaviour thresholds, not overall only. Cluster → `bkit-audit-logs`. (b) Android vitals beyond crashes: excessive partial wake locks (core vital; record vitals-page date) and slow cold/warm starts. (c) Xcode Organizer beyond crashes: hang rate, launch time, memory, disk writes, battery, per version. Slow starts, hangs, wake locks, battery → `bkit-audit-app-performance`. (d) Rating and change since previous run; recent review themes. How-app-works themes → `bkit-audit-usability`. (e) Review prompts via store review API only — never incentivised or gated. Replies vs owner response-rate target. (f) Rejections since previous run and reasons. (g) Production: phased release and staged rollout, halt rule tied to crash-free sessions; external test tracks active. (h) Screenshots current, description true, support and privacy URLs work. Out-of-date listing → owner, with screen or text. **Done when:** `Live` holds rates, rating, each verdict, or `N/A`.
118
- - [ ] **Step 9 — Listing:** Pre-submission → draft listing; live → published. Title, subtitle, keyword field, short/full description: within store field limits, search-oriented words. Localised listings for shipped locales. Screenshot sets per required device size; tablet if supported. Live: conversion funnel (impressions, product-page views, installs) from both stores' acquisition reports, change since previous run. Record listing experiments; propose one quarterly test (screenshots or icon) to owner. **Done when:** `Listing` row per field and locale: within limits · true · verdict.
119
- - [ ] **Step 10 — Readiness:** (a) Working demo account for reviewers, not seeded owner. (b) Sign in with Apple if any other third-party sign-in on iOS. (c) How digital subscriptions sold in-app. External processor vs in-app purchase limited by store/country rules — owner decision in `docs/decisions.jsonl`; match record to app behaviour. (d) Out-of-app purchase links vs same rules. (e) Subscription disclosures: terms, price, renewal before purchase; manage/cancel path; restore purchases if IAP used. External-processor-only subscriptions → account deletion explains cancellation. (f) App ships over-the-air updates (e.g. Expo Updates, CodePush) → script and assets only — never change primary purpose or skip-review feature. Runtime-version policy prevents incompatible binary landing. Breach → plan from this report. None → `N/A`. (g) Tablet supported → layouts work on tablet for review; else flag false on purpose. (h) Export-compliance flag set so uploads not held. (i) Trader status on both stores — undeclared apps removed from EU storefronts. (j) Current closed-test rule for personal developer account (e.g. account created after 2023-11-13 needs closed test with ≥12 testers opted in 14 consecutive days before production). Identity verification and package-name registration; record store-page date for unregistered package removal (e.g. 2026-09-30). (k) Pre-launch report for latest build: crashes, accessibility, security warnings; failed devices/OS versions. (l) Accessibility nutrition labels: store declaration vs vendor criteria per feature (every common task completable). Voluntary until store requires. Evidence → `bkit-audit-accessibility`. Unused permission, missing deletion path, review-rule gap → plan from this report. **Done when:** `Readiness` row per item: met / finding / not applicable.
120
- - [ ] **Step 11 — Age:** Both stores' age-rating questionnaires answered; re-answer when features change (messaging, UGC, AI chat, unrestricted web). Record store due date for new questions (e.g. Apple added bands due 2026-01-31 to keep submitting updates); unanswered past date = finding. Age assurance: owner decision in `docs/decisions.jsonl` when product holds children's data. Read both stores' jurisdiction lists (e.g. Texas SB 2420 for new Texas accounts from 2026-06-04 via declared-age-range API, significant-change API, server notification for revoked parental consent; Play age-signals API for eligible accounts). How child is known and consent given → `bkit-audit-privacy`. Target-audience declaration accurate; Play Families applicability recorded. Age-rating or age-assurance gap → owner; child safety → `bkit-audit-privacy`. **Done when:** `Age` row per questionnaire and jurisdiction: answered · matches the app · verdict.
121
- - [ ] **Step 12 — Standards:** Confirm current version per anchor standard; read changes since previous report's version. `Standards Coverage`: one row per App Review Guidelines section and per Play policy area (User Data, Permissions, Families, Data safety, and the rest) → checked (name step) / not applicable (why) / finding. Unapplied recommended practice → adopt (propose step) / reject (why) / not applicable. **Done when:** no empty row.
122
- - [ ] **Step 13 — Anything Else:** (a) All changes since previous report's commit touching native apps and listings (app config, build profiles, native permissions and config plugins, privacy manifest, entitlements, native SDK versions, store listing text, subscription and purchase flows, account deletion, over-the-air channels) → one-line verdict each. (b) Bounded ~30 min pass: senior mobile release manager flags no step asks; read since previous run (incidents, `bkit-audit-logs` reports, new `docs/failures.jsonl` rows, vendor status incidents) — what would no step catch? **Done when:** `Beyond the Steps` holds both passes, or `none`. Class seen on 2 runs → propose step in `Process Improvements`.
94
+ - [ ] **Step 1 — Previous Run:** **Done when:** `Previous Run` holds the closure rate, or the run is marked baseline.
95
+ - [ ] **Step 2 — Store State:** For each platform, record the version and build, the store state (not submitted, in review, live) and the accounts that can be read. **If** the config keeps the version remotely → read the version and build from the build service, not the local app config. Read the Android policy-status and app-content pages, and the iOS agreements page. An unaccepted updated agreement or a pending declaration blocks uploads, so each one is a finding for the account holder, with the page. **Done when:** `Store State` holds a table per platform with the version, build, target SDK, store state, accounts read and nearest deadline (filled in `Deadlines`).
96
+ - [ ] **Step 3 — Deadlines:** Confirm each date on the current store page. **If** the page differs → the page wins. (a) Compare the target API level and its date with the app's target SDK from the last built Android bundle, not from config only. (b) Memory page size: record the date and the target API the requirement names (e.g., updates targeting that API cannot ship unless native libraries support 16 KB pages). Check `.so` alignment in the last built bundle, not in config. Any app that ships native code is in scope. (c) Compare the upload minimum SDK and toolchain with the build image. (d) Check the native framework's SDK support window. (e) List the store policies announced since the previous run. (f) Diff the guidelines and policies since the previous report's date, and test the changes against the app, not only the deadlines. A requirement due within 90 days is a finding. One due within 30 days is at least `HIGH`. An upgrade fix goes to `bkit-audit-dependencies`. **Done when:** `Deadlines` holds one row per item, with the requirement, date, app value and verdict.
97
+ - [ ] **Step 4 — Declarations:** Match each declaration to `bkit-audit-privacy`'s inventory and privacy policy. Do not rebuild the inventory.
98
+ - (a) Check the iOS privacy manifest (required-reason APIs for the app and every third-party SDK) and the store privacy labels.
99
+ - (b) Check that each SDK on the vendor's commonly-used list ships its own privacy manifest and signature, and that the tracking-domain list names any tracking domain the app contacts.
100
+ - (c) Check the Android data-safety form.
101
+ - (d) Third-party AI: a review guideline requires disclosure where personal data is shared with third parties, including third-party AI, and explicit permission before sharing (e.g., App Review Guideline 5.1.2(i)).
102
+ - Check that the in-app consent screen, the stored consent flag that gates each call, the withdraw path and the privacy label describe the same flow.
103
+ - **If** there is a gap → it goes to `bkit-audit-privacy`, with a plan item for the consent screen.
104
+ - (e) Both stores require account deletion started inside the app, not only on the web. The Android form also requires a working web link, entered on the data-safety form, that names the app or developer and lets someone request deletion without reinstalling.
105
+ - **If** the app offers Sign in with Apple → deleting an account revokes its tokens through the revoke endpoint, and the server handles the server-to-server notifications for revoked consent and deleted accounts (e.g., Apple technote TN3194).
106
+ - (f) Check that the advertising-id and tracking answers match what `bkit-audit-analytics` found the app collects.
107
+ - A declaration mismatch is at least `HIGH`, and goes to `bkit-audit-privacy`.
108
+
109
+ **Done when:** `Declarations` holds one row per label, manifest entry and form answer, with what is declared, the inventory and the verdict.
110
+
111
+ - [ ] **Step 5 — Permissions:** Check that each requested permission (e.g., camera, photos, location, contacts, notifications) has a true purpose string and a feature that uses it. A permission left over from a removed feature is a finding, because reviewers reject apps for it. On Android, compare the restricted permissions with store policy. Photos and videos go through the system photo picker. **If** broad media access is core to the app → the picker is not required, and broad media access needs an approved console declaration. Exact alarms are only for apps whose core is alarms, timers or calendars. Other apps use schedule-exact with user consent. The full-screen intent is allowed by default only for alarm and calling apps. Other apps need user consent and a console declaration. Request post-notifications at runtime when a notification makes sense, not at first launch. An unused permission goes to a plan made from this report. **Done when:** `Permissions` holds one row per permission, with its purpose string, feature and verdict.
112
+ - [ ] **Step 6 — Credentials:** Check the iOS distribution certificate and provisioning profiles, the push key, the Android upload key and store app signing, the build-service credentials and the developer-program membership. For each, record the expiry, the holder, and the recovery path if the holder leaves. **If** the upload key is lost **and** there is no store app signing → the app can never be updated, and the finding is `CRITICAL` until shown otherwise. Include the push-messaging service-account credential for the current HTTP API. Legacy server keys must be unused. Record the expiry, holder and recovery path only. Who should hold access goes to `bkit-audit-security`. Other expiries go to `bkit-audit-config`. A credential with no owner or no recovery path is at least `HIGH`. **Done when:** `Credentials` holds one row per item, with its expiry, holder, recovery and verdict.
113
+ - [ ] **Step 7 — Links:** **If** the native app has invite or deep links → check that the association files sit on the web domain over HTTPS with no redirect, cover the invite, join and email deep-link paths, and match the shipped apps: the iOS team and bundle id, and the Android SHA-256 fingerprints, including the store signing key's, not the upload key's only. Open an invite link on a device with the app and on one without it. Hosting or DNS drift where the store build still matches goes to `bkit-audit-config`. A file that does not match the store build is a finding, and goes to a plan made from this report. **Done when:** `Links` holds one row per file and per device case.
114
+ - [ ] **Step 8 — Live:** **If** the app is not listed → write `N/A` in `Live`, never "clean", and skip the rest of this step.
115
+ - (a) Read the crash-free sessions and the Android ANR rate from store vitals, Xcode Organizer and the error tracker.
116
+ - Compare the crash and ANR rates with both the overall and the per-device bad-behaviour thresholds, not the overall only.
117
+ - A cluster goes to `bkit-audit-logs`.
118
+ - (b) Check Android vitals beyond crashes: excessive partial wake locks (a core vital; record the vitals-page date) and slow cold and warm starts.
119
+ - (c) Check Xcode Organizer beyond crashes: hang rate, launch time, memory, disk writes and battery, per version. Slow starts, hangs, wake locks and battery go to `bkit-audit-app-performance`.
120
+ - (d) Record the rating, its change since the previous run, and recent review themes. Themes about how the app works go to `bkit-audit-usability`.
121
+ - (e) Check that review prompts use the store review API only, and are never incentivised or gated.
122
+ - Compare replies with the owner's response-rate target.
123
+ - (f) List the rejections since the previous run, and their reasons.
124
+ - (g) Check production: phased release and staged rollout, with a halt rule tied to crash-free sessions, and the active external test tracks.
125
+ - (h) Check that the screenshots are current, the description is true, and the support and privacy URLs work. An out-of-date listing goes to the owner, with the screen or text.
126
+
127
+ **Done when:** `Live` holds the rates, the rating and each verdict, or `N/A`.
128
+
129
+ - [ ] **Step 9 — Listing:** Pick the listing to check:
130
+ - **If** the app is not yet submitted → check the draft listing.
131
+ - **If** a build is in review → check the listing submitted with that build.
132
+ - **If** it is live → check the published listing.
133
+ - Check that the title, subtitle, keyword field, and short and full descriptions are within the store field limits and use search-oriented words.
134
+ - Check for localised listings in the shipped locales.
135
+ - Check for a screenshot set per required device size, and a tablet set if tablet is supported.
136
+ - **If** the app is live → read the conversion funnel (impressions, product-page views, installs) from both stores' acquisition reports, with its change since the previous run.
137
+ - Record listing experiments, and propose one quarterly test (screenshots or icon) to the owner.
138
+
139
+ **Done when:** `Listing` holds one row per field and locale, with within limits, true and verdict.
140
+
141
+ - [ ] **Step 10 — Readiness:** Check each item below.
142
+ - (a) Check for a working demo account for reviewers, not the seeded owner.
143
+ - (b) **If** the iOS app offers any other third-party sign-in → it needs Sign in with Apple.
144
+ - (c) Check how digital subscriptions are sold in the app. Using an external processor instead of in-app purchase is limited by store and country rules. It is an owner decision in `docs/decisions.jsonl`, so match that record to the app's behaviour.
145
+ - (d) Check out-of-app purchase links against the same rules.
146
+ - (e) Check the subscription disclosures: terms, price and renewal shown before purchase, a manage and cancel path, and restore purchases when in-app purchase is used.
147
+ - **If** subscriptions run on an external processor only → account deletion explains cancellation.
148
+ - (f) Over-the-air updates (e.g., Expo Updates, CodePush):
149
+ - **If** the app ships them → they carry script and assets only, and never change the primary purpose or add a feature that skips review. The runtime-version policy prevents an incompatible binary from landing. A breach goes to a plan made from this report.
150
+ - **If** the app ships none → `N/A`.
151
+ - (g) Tablet:
152
+ - **If** tablet is supported → check that layouts work on tablet for review.
153
+ - **Else** → check that tablet support is flagged false on purpose.
154
+ - (h) Check that the export-compliance flag is set, so uploads are not held.
155
+ - (i) Check trader status on both stores. Undeclared apps are removed from EU storefronts.
156
+ - (j) Check the current closed-test rule for a personal developer account (e.g., an account created after 2023-11-13 needs a closed test with >=12 testers opted in for 14 consecutive days before production).
157
+ - Check identity verification and package-name registration.
158
+ - Record the store-page date for removing unregistered packages (e.g., 2026-09-30).
159
+ - (k) Read the pre-launch report for the latest build: crashes, accessibility and security warnings, and the failed devices and OS versions.
160
+ - (l) Compare the accessibility nutrition labels in the store declaration with the vendor criteria per feature (every common task can be completed). They are voluntary until the store requires them. Evidence goes to `bkit-audit-accessibility`.
161
+ - An unused permission, a missing deletion path or a review-rule gap goes to a plan made from this report.
162
+
163
+ **Done when:** `Readiness` holds one row per item: met / finding / not applicable.
164
+
165
+ - [ ] **Step 11 — Age:** Check that both stores' age-rating questionnaires are answered.
166
+ - **If** features changed (messaging, UGC, AI chat, unrestricted web) since they were answered → record a finding that the questionnaires need re-answering.
167
+ - Record the store's due date for new questions (e.g., Apple added bands due 2026-01-31 to keep submitting updates). A questionnaire left unanswered past that date is a finding.
168
+ - **If** the product holds children's data → age assurance is an owner decision in `docs/decisions.jsonl`.
169
+ - Read both stores' jurisdiction lists (e.g., Texas SB 2420 for new Texas accounts from 2026-06-04, through the declared-age-range API, the significant-change API and the server notification for revoked parental consent; the Play age-signals API for eligible accounts).
170
+ - How a child is known and consent is given goes to `bkit-audit-privacy`.
171
+ - Check that the target-audience declaration is accurate, and record whether Play Families applies.
172
+ - An age-rating or age-assurance gap goes to the owner.
173
+ - Child safety goes to `bkit-audit-privacy`.
174
+
175
+ **Done when:** `Age` holds one row per questionnaire and jurisdiction, with answered, matches the app, and verdict.
176
+
177
+ - [ ] **Step 12 — Standards:** Confirm the current version of each anchor standard, and read what changed since the previous report's version. Give `Standards Coverage` one row per App Review Guidelines section and one per Play policy area (User Data, Permissions, Families, Data safety, and the rest), each marked checked (naming the step), not applicable (saying why) or finding. Mark each recommended practice the project does not apply as adopt (with a proposed step), reject (saying why) or not applicable. **Done when:** no row is empty.
178
+ - [ ] **Step 13 — Anything Else:** (a) Give a one-line verdict on each change since the previous report's commit that touches native apps and listings: app config, build profiles, native permissions and config plugins, the privacy manifest, entitlements, native SDK versions, store listing text, subscription and purchase flows, account deletion, and over-the-air channels. (b) Spend a bounded pass of about 30 minutes on what a senior mobile release manager would flag that no step asks about. Read what happened since the previous run (incidents, `bkit-audit-logs` reports, new `docs/failures.jsonl` rows, vendor status incidents), and ask what no step would catch. **Done when:** `Beyond the Steps` holds both passes, or says `none`. **If** one class of issue is seen on 2 runs → propose a step for it in `Process Improvements`.
123
179
 
124
180
  ### 🔒 Gate 2: Probes Check
125
181
 
126
- **Checkpoint.** Verify and check `[x]` all boxes below, then continue to `Findings` without asking.
127
-
128
- - [ ] **Steps complete:** every step `[x]`, or explicit skip with evidence the surface is absent.
129
- - [ ] **Evidence:** every finding cites re-checkable evidence and the tool behind it.
130
- - [ ] **Consoles untouched:** no build submitted, no listing or declaration edited, no agreement accepted, no credential created, rotated, or downloaded.
131
- - [ ] **No secrets:** report contains no certificate, key, token, or password material.
132
- - [ ] **Gate 2 - Verified:** Every checkbox above independently verified and checked off.
182
+ - [ ] **Steps complete:** every step is `[x]`, or skipped with evidence that its surface is absent.
183
+ - [ ] **Evidence:** every finding cites evidence someone can check again, and the tool that produced it.
184
+ - [ ] **No submission:** no build was submitted.
185
+ - [ ] **Listing untouched:** no listing or declaration was edited.
186
+ - [ ] **No agreement:** no agreement was accepted.
187
+ - [ ] **Credentials untouched:** no credential was created, rotated or downloaded.
188
+ - [ ] **No secrets:** the report contains no certificate, key, token or password material.
189
+ - [ ] **Gate 2 — Verified:** every item above holds.
133
190
 
134
191
  ## Findings
135
192
 
136
193
  <!-- prettier-ignore -->
137
194
  | Severity | Use |
138
195
  | --- | --- |
139
- | `CRITICAL` | Upload key lost and no store app signing, so the app can never be updated; a deadline already passed so no update can ship |
140
- | `HIGH` | Deadline within 30 days; privacy declaration does not match the app or the privacy inventory; credential with no recovery path; personal data sent to a third-party AI without explicit in-app permission |
141
- | `MEDIUM` | Unused permission; association file does not match the store build; over-the-air update can change reviewed behaviour; age questionnaire stale; listing out of date; agreement unaccepted |
142
- | `LOW` | Listing wording within limits that does not use search words; nutrition-label gap while the labels are still voluntary; no listing experiment proposed |
196
+ | `CRITICAL` | The upload key is lost and there is no store app signing, so the app can never be updated. A deadline has already passed, so no update can ship |
197
+ | `HIGH` | A deadline within 30 days. A privacy declaration that does not match the app or the privacy inventory. A credential with no recovery path. Personal data sent to a third-party AI without explicit in-app permission |
198
+ | `MEDIUM` | An unused permission. An association file that does not match the store build. An over-the-air update that can change reviewed behaviour. A stale age questionnaire. An out-of-date listing. An unaccepted agreement |
199
+ | `LOW` | Listing wording within limits that does not use search words. A nutrition-label gap while the labels are still voluntary. No listing experiment proposed |
143
200
 
144
- Scale per `.bkit/jsonl.md` § Severity. Within a severity: blocked release and credentials first, then declarations. A deadline within 30 days, a privacy declaration that does not match the app, a credential with no recovery path, and personal data sent to a third-party AI without explicit in-app permission are each at least `HIGH`. `Expected` names where it goes.
201
+ Within a severity, list blocked releases and credentials first, then declarations. A deadline within 30 days, a privacy declaration that does not match the app, a credential with no recovery path, and personal data sent to a third-party AI without explicit in-app permission are each at least `HIGH`. `Expected` names where the finding goes.
145
202
 
146
203
  <!-- prettier-ignore -->
147
204
  | Finding | Goes to |
@@ -154,11 +211,11 @@ Scale per `.bkit/jsonl.md` § Severity. Within a severity: blocked release and c
154
211
  | Slow starts, hangs, wake locks, or battery drain | `bkit-audit-app-performance` |
155
212
  | Review themes about how the app works | `bkit-audit-usability` |
156
213
  | Native accessibility | `bkit-audit-accessibility` |
157
- | An unused permission, a missing deletion path, or a review-rule gap | Plan from this report |
158
- | A universal link or App Link that does not match a store build | Plan from this report |
159
- | An over-the-air update that changes reviewed behaviour, or a runtime-version gap | Plan from this report |
214
+ | An unused permission, a missing deletion path, or a review-rule gap | A plan made from this report |
215
+ | A universal link or App Link that does not match a store build | A plan made from this report |
216
+ | An over-the-air update that changes reviewed behaviour, or a runtime-version gap | A plan made from this report |
160
217
  | The in-app subscription decision | The owner, recorded in `docs/decisions.jsonl` |
161
- | An age-rating answer or age-assurance gap | The owner, recorded in `docs/decisions.jsonl`; child safety → `bkit-audit-privacy` |
218
+ | An age-rating answer or age-assurance gap | The owner, recorded in `docs/decisions.jsonl`. Child safety goes to `bkit-audit-privacy` |
162
219
  | An unaccepted agreement or a pending store declaration | The account holder, with the page |
163
220
  | A listing that is out of date | The owner, with the screen or text to change |
164
221
 
@@ -167,7 +224,7 @@ Scale per `.bkit/jsonl.md` § Severity. Within a severity: blocked release and c
167
224
  | --- | --- | --- | --- | --- |
168
225
  | PENDING | PENDING | PENDING | PENDING | PENDING |
169
226
 
170
- Empty and clean → one row `None`.
227
+ **If** the run finds nothing → write one row: `None`.
171
228
 
172
229
  ## Report
173
230
 
@@ -248,17 +305,17 @@ PENDING
248
305
 
249
306
  ### 🔒 Gate 3: Report Check
250
307
 
251
- **Checkpoint.** Verify and check `[x]` all boxes below, then stop.
252
-
253
- - [ ] **No placeholders:** Findings table and every `Report` section have no `PENDING`.
254
- - [ ] **Summary:** names count per severity, and per platform the store state and nearest deadline.
255
- - [ ] **Series:** ratings and the listing conversion funnel beside previous report's, or marked baseline / not live.
256
- - [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
257
- - [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
258
- - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
259
- - [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
260
-
261
- > `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.
308
+ - [ ] **No placeholders:** no `PENDING` is left.
309
+ - [ ] **Summary:** `Summary` gives the count per severity.
310
+ - [ ] **Store state:** `Summary` gives each platform's store state.
311
+ - [ ] **Deadline:** `Summary` gives each platform's nearest deadline.
312
+ - [ ] **Series:** the report shows ratings and the listing conversion funnel beside the previous report's, or marks the run as baseline or not live.
313
+ - [ ] **Writes:** this run changed only this report, the template's `Project Instructions` and its own `docs/failures.jsonl` rows.
314
+ - [ ] **Throwaways removed:** every throwaway worktree or remote target is removed.
315
+ - [ ] **Process Improvements:** `Universal` and `Project` are both filled.
316
+ - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID is in exactly one `Suggested Issues` row.
317
+ - [ ] **Next Step:** every `Suggested Issues` row has a `Next Step`.
318
+ - [ ] **Gate 3 — Verified:** every item above holds.
262
319
 
263
320
  <!-- bkit:end -->
264
321