@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.
- package/.bkit/README.md +167 -154
- package/.bkit/core/.agents/context.md +95 -29
- package/.bkit/core/.agents/docs.md +18 -15
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
- package/.bkit/core/.agents/rules.md +112 -102
- package/.bkit/core/.agents/skills.md +63 -15
- package/.bkit/core/.bkit/README.md +167 -154
- package/.bkit/core/.bkit/authoring.md +747 -0
- package/.bkit/core/.bkit/cli.md +407 -0
- package/.bkit/core/.bkit/cloud.md +283 -195
- package/.bkit/core/.bkit/comparison.md +45 -43
- package/.bkit/core/.bkit/install.md +166 -95
- package/.bkit/core/.bkit/jsonl.md +339 -196
- package/.bkit/core/.bkit/pipeline.md +142 -145
- package/.bkit/core/.bkit/prompts.md +295 -264
- package/.bkit/core/.bkit/providers.md +460 -277
- package/.bkit/core/.bkit/router.md +69 -0
- package/.bkit/core/.bkit/templates.md +530 -256
- package/.bkit/core/.bkit/trackers.md +116 -65
- package/.bkit/core/.bkit/workflows.md +742 -618
- package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
- package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
- package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
- package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
- package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
- package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
- package/.bkit/core/AGENTS.md +6 -80
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +128 -130
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -94
- package/.bkit/core/docs/templates/bkit-audit-agents.md +96 -98
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +100 -103
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +141 -107
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +99 -97
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +122 -121
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +158 -101
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +114 -96
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +76 -97
- package/.bkit/core/docs/templates/bkit-audit-config.md +123 -101
- package/.bkit/core/docs/templates/bkit-audit-cost.md +86 -99
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +76 -93
- package/.bkit/core/docs/templates/bkit-audit-database.md +102 -95
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +165 -108
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -109
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +265 -113
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +119 -118
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +140 -111
- package/.bkit/core/docs/templates/bkit-audit-failures.md +111 -106
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +100 -99
- package/.bkit/core/docs/templates/bkit-audit-gates.md +107 -103
- package/.bkit/core/docs/templates/bkit-audit-issues.md +105 -105
- package/.bkit/core/docs/templates/bkit-audit-llm.md +134 -85
- package/.bkit/core/docs/templates/bkit-audit-logs.md +124 -125
- package/.bkit/core/docs/templates/bkit-audit-models.md +99 -78
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -76
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -78
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +125 -93
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +97 -96
- package/.bkit/core/docs/templates/bkit-audit-repo.md +170 -98
- package/.bkit/core/docs/templates/bkit-audit-security.md +207 -121
- package/.bkit/core/docs/templates/bkit-audit-slop.md +78 -95
- package/.bkit/core/docs/templates/bkit-audit-testing.md +163 -139
- package/.bkit/core/docs/templates/bkit-audit-usability.md +114 -96
- package/.bkit/core/docs/templates/bkit-plan.md +158 -281
- package/.bkit/core/engine/checks/after/auth.ts +40 -37
- package/.bkit/core/engine/checks/after/ci-yml.ts +104 -31
- package/.bkit/core/engine/checks/after/github.ts +95 -17
- package/.bkit/core/engine/checks/after/index.ts +21 -8
- package/.bkit/core/engine/checks/after/suppression.ts +8 -5
- package/.bkit/core/engine/checks/after/tools.ts +125 -123
- package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
- package/.bkit/core/engine/checks/before/env.ts +3 -3
- package/.bkit/core/engine/checks/before/files.ts +5 -4
- package/.bkit/core/engine/checks/before/index.ts +25 -1
- package/.bkit/core/engine/checks/before/repo.ts +208 -2
- package/.bkit/core/engine/checks/status-holes.ts +916 -123
- package/.bkit/core/engine/checks/tips/catalogue.ts +82 -20
- package/.bkit/core/engine/checks/tips/detect.ts +66 -0
- package/.bkit/core/engine/checks/tips/index.ts +52 -11
- package/.bkit/core/engine/cli.ts +251 -130
- package/.bkit/core/engine/commands/analysis.ts +282 -199
- package/.bkit/core/engine/commands/ci/ci.ts +363 -29
- package/.bkit/core/engine/commands/ci/pins.ts +172 -0
- package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
- package/.bkit/core/engine/commands/comply.ts +77 -103
- package/.bkit/core/engine/commands/install/doctor.ts +2 -2
- package/.bkit/core/engine/commands/install/install.ts +57 -18
- package/.bkit/core/engine/commands/install/uninstall.ts +86 -55
- package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
- package/.bkit/core/engine/commands/land.ts +139 -18
- package/.bkit/core/engine/commands/lib.ts +381 -22
- package/.bkit/core/engine/commands/registry.ts +10 -2
- package/.bkit/core/engine/commands/setup/setup.ts +8 -7
- package/.bkit/core/engine/commands/stats.ts +260 -0
- package/.bkit/core/engine/commands/tips.ts +10 -5
- package/.bkit/core/engine/commands/workflow/branches.ts +2215 -176
- package/.bkit/core/engine/commands/workflow/challenge.ts +748 -0
- package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
- package/.bkit/core/engine/commands/workflow/context.ts +1249 -47
- package/.bkit/core/engine/commands/workflow/counters.ts +483 -95
- package/.bkit/core/engine/commands/workflow/decisions.ts +585 -0
- package/.bkit/core/engine/commands/workflow/disk.ts +238 -56
- package/.bkit/core/engine/commands/workflow/fids.ts +811 -33
- package/.bkit/core/engine/commands/workflow/issues.ts +413 -64
- package/.bkit/core/engine/commands/workflow/ledgers.ts +1333 -36
- package/.bkit/core/engine/commands/workflow/locks.ts +28 -2
- package/.bkit/core/engine/commands/workflow/plan-blocks.ts +691 -0
- package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
- package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +178 -33
- package/.bkit/core/engine/commands/workflow/repo.ts +66 -8
- package/.bkit/core/engine/commands/workflow/roadmap.ts +72 -22
- package/.bkit/core/engine/commands/workflow/run-facts.ts +492 -0
- package/.bkit/core/engine/commands/workflow/runs.ts +827 -79
- package/.bkit/core/engine/commands/workflow/runtime.ts +25 -1
- package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
- package/.bkit/core/engine/commands/workflow/status.ts +329 -33
- package/.bkit/core/engine/commands/workflow/step-table.ts +381 -0
- package/.bkit/core/engine/commands/workflow/steps.ts +841 -105
- package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
- package/.bkit/core/engine/commands/workflow/summary.ts +544 -0
- package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
- package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
- package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +2124 -330
- package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
- package/.bkit/core/engine/commands/workflow/workflows.ts +1197 -235
- package/.bkit/core/engine/commands/workflow/worktrees.ts +543 -24
- package/.bkit/core/engine/install/cloud-env.ts +251 -121
- package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
- package/.bkit/core/engine/install/manifest.ts +67 -17
- package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
- package/.bkit/core/engine/install/modules/cloud.ts +24 -16
- package/.bkit/core/engine/install/modules/codex.ts +15 -2
- package/.bkit/core/engine/install/modules/core.ts +1196 -45
- package/.bkit/core/engine/install/modules/cursor.ts +6 -6
- package/.bkit/core/engine/install/modules/opencode.ts +18 -6
- package/.bkit/core/engine/install/template-notes.ts +130 -0
- package/.bkit/core/engine/install/version-file.ts +9 -4
- package/.bkit/core/engine/install/write.ts +5 -0
- package/.bkit/core/engine/ledgers/compact.ts +124 -0
- package/.bkit/core/engine/ledgers/journal.ts +291 -0
- package/.bkit/core/engine/ledgers/migrate.ts +92 -0
- package/.bkit/core/engine/ledgers/status.ts +249 -21
- package/.bkit/core/engine/ledgers/telemetry.ts +1397 -253
- package/.bkit/core/engine/render/hosts.ts +118 -14
- package/.bkit/core/engine/render/models.ts +12 -0
- package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
- package/.bkit/core/engine/shared/branches.ts +4 -1
- package/.bkit/core/engine/shared/dep-updater.ts +60 -0
- package/.bkit/core/engine/shared/egress.ts +8 -1
- package/.bkit/core/engine/shared/json.ts +25 -7
- package/.bkit/core/engine/shared/package-manager.ts +9 -0
- package/.bkit/core/engine/shared/settings.ts +243 -31
- package/.bkit/core/engine/shared/text.ts +361 -0
- package/.bkit/core/engine/shared/timeouts.ts +2 -0
- package/.bkit/core/engine/tools/cli-doc.ts +111 -0
- package/.bkit/core/engine/tools/grammar-density.ts +215 -0
- package/.bkit/core/engine/tools/instructions-sources.ts +832 -0
- package/.bkit/core/engine/tools/instructions.ts +1802 -0
- package/.bkit/core/hooks/antigravity-hook.js +25 -10
- package/.bkit/core/hooks/gateguard-engine.js +54 -29
- package/.bkit/core/hooks/guardrails-shell.js +4 -5
- package/.bkit/core/hooks/guardrails-tiers.js +10 -4
- package/.bkit/core/hooks/preflight-linear.sh +9 -9
- package/.bkit/core/hooks/preflight-rules.sh +8 -0
- package/.bkit/core/hooks/readguard-engine.js +29 -10
- package/.bkit/core/hooks/session-rules-advisory.js +61 -0
- package/.bkit/core/prompts/bkit-audit-generate.md +202 -94
- package/.bkit/core/prompts/bkit-build-challenge-1.md +76 -34
- package/.bkit/core/prompts/bkit-build-challenge-2.md +85 -38
- package/.bkit/core/prompts/bkit-build-install-skills.md +50 -28
- package/.bkit/core/prompts/bkit-build-plan-convert.md +85 -0
- package/.bkit/core/prompts/bkit-build-plan-current.md +59 -36
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +101 -36
- package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
- package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
- package/.bkit/core/prompts/bkit-build-plan-verify.md +104 -43
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +47 -32
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +109 -57
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +65 -39
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +53 -31
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +65 -34
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +46 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +45 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +43 -30
- package/.bkit/core/prompts/bkit-design-generate.md +80 -46
- package/.bkit/core/prompts/bkit-design-organise.md +83 -32
- package/.bkit/core/prompts/bkit-design-review-1.md +70 -50
- package/.bkit/core/prompts/bkit-design-review-2.md +65 -46
- package/.bkit/core/prompts/bkit-design-spike.md +64 -40
- package/.bkit/core/prompts/bkit-design-update.md +53 -28
- package/.bkit/core/prompts/bkit-plan-generate.md +101 -29
- package/.bkit/core/prompts/bkit-plan-review-1.md +78 -41
- package/.bkit/core/prompts/bkit-plan-review-2.md +78 -35
- package/.bkit/core/prompts/bkit-plan-scope-check.md +116 -0
- package/.bkit/core/prompts/bkit-plan-update.md +86 -31
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +94 -50
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +91 -41
- package/.bkit/core/prompts/bkit-ship-update-docs.md +45 -24
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +65 -49
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +87 -42
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +81 -37
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +43 -25
- package/.bkit/core/prompts/bkit-utility-update-failures.md +84 -37
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +88 -42
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +92 -39
- package/.bkit/core/prompts/bkit-utility-update-tracker.md +159 -60
- package/.bkit/core/workflows/bkit-auto.md +89 -58
- package/.bkit/core/workflows/bkit-build.md +967 -517
- package/.bkit/core/workflows/bkit-debug.md +555 -387
- package/.bkit/core/workflows/bkit-design.md +319 -283
- package/.bkit/core/workflows/bkit-plan.md +319 -342
- package/.bkit/core/workflows/bkit-ship.md +525 -328
- package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
- package/.bkit/shared/.bkit/.env.example +2 -2
- package/.bkit/shared/.claude/bkit-cloud.md +12 -10
- package/.bkit/shared/.claude/settings.json +14 -0
- package/.bkit/shared/.codex/bkit-cloud.md +98 -0
- package/.bkit/shared/.codex/hooks.json +20 -0
- package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
- package/.bkit/shared/.cursor/mcp.json +1 -1
- package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
- package/.bkit/shared/.gitattributes +1 -1
- package/.bkit/shared/.mcp.json +1 -1
- package/.bkit/shared/.opencode/opencode.json +12 -1
- package/.bkit/shared/CLAUDE.md +6 -2
- package/.bkit/shared/GEMINI.md +5 -2
- package/.bkit/shared/docs/architecture.md +4 -7
- package/.bkit/shared/docs/data-schema.md +4 -7
- package/.bkit/shared/docs/deployments.md +241 -168
- package/.bkit/shared/docs/design.md +11 -12
- package/.bkit/shared/docs/noise.md +8 -7
- package/.bkit/shared/docs/observability.md +5 -8
- package/.bkit/shared/docs/security.md +35 -17
- package/.bkit/shared/docs/setup.md +29 -18
- package/.bkit/shared/docs/technology.md +3 -6
- package/.bkit/shared/docs/testing.md +289 -174
- package/.bkit/shared/gitignore +6 -2
- package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
- package/.bkit/templates/.cursor/Dockerfile +12 -8
- package/.bkit/templates/.cursor/environment.json +1 -1
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +45 -12
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
- package/.bkit/templates/.github/renovate.json5 +34 -6
- package/.bkit/templates/.github/workflows/bkit-ci.yml +54 -51
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +34 -33
- package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
- package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
- package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
- package/.bkit/templates/.husky/pre-commit +2 -2
- package/.bkit/templates/.husky/pre-push +96 -36
- package/.bkit/templates/.prettierignore +6 -0
- package/.bkit/templates/.vale.ini +27 -27
- package/.bkit/templates/context/bkit-cloudrun.md +23 -15
- package/.bkit/templates/context/bkit-expo.md +70 -52
- package/.bkit/templates/context/bkit-github.md +93 -56
- package/.bkit/templates/context/bkit-inngest.md +21 -15
- package/.bkit/templates/context/bkit-maestro.md +22 -16
- package/.bkit/templates/context/bkit-playwright.md +23 -17
- package/.bkit/templates/context/bkit-resend.md +12 -10
- package/.bkit/templates/context/bkit-sentry.md +30 -20
- package/.bkit/templates/context/bkit-serena.md +8 -7
- package/.bkit/templates/context/bkit-stripe.md +14 -13
- package/.bkit/templates/context/bkit-supabase.md +16 -13
- package/.bkit/templates/context/bkit-tavily.md +14 -11
- package/.bkit/templates/context/bkit-vercel.md +27 -18
- package/.bkit/templates/docs/capabilities.md +15 -14
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
- package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
- package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
- package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
- package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
- package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
- package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +10 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
- package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
- package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
- package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
- package/.bkit/templates/slop-scan.config.json +9 -2
- package/CHANGELOG.md +231 -0
- package/README.md +278 -89
- package/dist/checks/after/auth.js +36 -33
- package/dist/checks/after/ci-yml.js +91 -30
- package/dist/checks/after/github.js +91 -17
- package/dist/checks/after/index.js +22 -11
- package/dist/checks/after/suppression.js +8 -5
- package/dist/checks/after/tools.js +111 -114
- package/dist/checks/before/context-fetch.js +218 -33
- package/dist/checks/before/env.js +3 -3
- package/dist/checks/before/files.js +5 -3
- package/dist/checks/before/index.js +20 -3
- package/dist/checks/before/repo.js +197 -2
- package/dist/checks/status-holes.js +739 -114
- package/dist/checks/tips/catalogue.js +70 -19
- package/dist/checks/tips/detect.js +62 -0
- package/dist/checks/tips/index.js +51 -9
- package/dist/cli.js +234 -124
- package/dist/commands/analysis.js +174 -141
- package/dist/commands/ci/ci.js +302 -25
- package/dist/commands/ci/pins.js +142 -0
- package/dist/commands/ci/push-gate.js +194 -0
- package/dist/commands/comply.js +54 -91
- package/dist/commands/install/doctor.js +2 -2
- package/dist/commands/install/install.js +50 -19
- package/dist/commands/install/uninstall.js +82 -55
- package/dist/commands/install/upgrade.js +21 -11
- package/dist/commands/land.js +137 -17
- package/dist/commands/lib.js +295 -21
- package/dist/commands/registry.js +10 -2
- package/dist/commands/setup/setup.js +8 -7
- package/dist/commands/stats.js +175 -0
- package/dist/commands/tips.js +7 -3
- package/dist/commands/workflow/branches.js +1873 -152
- package/dist/commands/workflow/challenge.js +609 -0
- package/dist/commands/workflow/completeness.js +97 -0
- package/dist/commands/workflow/context.js +1045 -46
- package/dist/commands/workflow/counters.js +385 -86
- package/dist/commands/workflow/decisions.js +484 -0
- package/dist/commands/workflow/disk.js +214 -56
- package/dist/commands/workflow/fids.js +706 -33
- package/dist/commands/workflow/issues.js +349 -59
- package/dist/commands/workflow/ledgers.js +1123 -37
- package/dist/commands/workflow/locks.js +26 -2
- package/dist/commands/workflow/plan-blocks.js +501 -0
- package/dist/commands/workflow/plan-versions.js +22 -0
- package/dist/commands/workflow/plans.js +205 -0
- package/dist/commands/workflow/prs.js +154 -35
- package/dist/commands/workflow/repo.js +58 -8
- package/dist/commands/workflow/roadmap.js +58 -23
- package/dist/commands/workflow/run-facts.js +421 -0
- package/dist/commands/workflow/runs.js +670 -72
- package/dist/commands/workflow/runtime.js +15 -1
- package/dist/commands/workflow/skills.js +1 -0
- package/dist/commands/workflow/status.js +282 -34
- package/dist/commands/workflow/step-table.js +308 -0
- package/dist/commands/workflow/steps.js +703 -96
- package/dist/commands/workflow/summary-findings.js +117 -0
- package/dist/commands/workflow/summary.js +388 -0
- package/dist/commands/workflow/tasks.js +378 -0
- package/dist/commands/workflow/test-blocks.js +231 -0
- package/dist/commands/workflow/tests-changed.js +172 -0
- package/dist/commands/workflow/tests.js +1695 -305
- package/dist/commands/workflow/tracker.js +983 -0
- package/dist/commands/workflow/workflows.js +1014 -222
- package/dist/commands/workflow/worktrees.js +432 -26
- package/dist/install/cloud-env.js +233 -99
- package/dist/install/context-ci-workflow.js +85 -0
- package/dist/install/manifest.js +64 -17
- package/dist/install/modules/antigravity.js +3 -2
- package/dist/install/modules/cloud.js +25 -16
- package/dist/install/modules/codex.js +12 -2
- package/dist/install/modules/core.js +1090 -48
- package/dist/install/modules/cursor.js +6 -6
- package/dist/install/modules/opencode.js +13 -7
- package/dist/install/template-notes.js +116 -0
- package/dist/install/version-file.js +9 -4
- package/dist/ledgers/compact.js +87 -0
- package/dist/ledgers/journal.js +233 -0
- package/dist/ledgers/migrate.js +81 -0
- package/dist/ledgers/status.js +176 -13
- package/dist/ledgers/telemetry.js +1010 -125
- package/dist/render/hosts.js +104 -14
- package/dist/render/models.js +12 -0
- package/dist/shared/bkit-latest.js +26 -4
- package/dist/shared/branches.js +3 -1
- package/dist/shared/dep-updater.js +49 -0
- package/dist/shared/egress.js +8 -1
- package/dist/shared/json.js +20 -7
- package/dist/shared/package-manager.js +6 -0
- package/dist/shared/settings.js +181 -24
- package/dist/shared/text.js +333 -0
- package/dist/shared/timeouts.js +2 -0
- package/dist/tools/cli-doc.js +97 -0
- package/dist/tools/grammar-density.js +183 -0
- package/dist/tools/instructions-sources.js +720 -0
- package/dist/tools/instructions.js +1623 -0
- package/package.json +156 -51
- package/.bkit/core/.bkit/lite.md +0 -73
- package/.bkit/core/engine/commands/harvest.ts +0 -459
- package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -166
- package/.bkit/core/engine/tools/wording.ts +0 -748
- package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
- package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
- package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
- package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -76
- package/.bkit/core/prompts/bkit-build-summary.md +0 -94
- package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
- package/.bkit/core/prompts/bkit-design-summary.md +0 -107
- package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
- package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
- package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
- package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
- package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
- package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
- package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
- package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
- package/dist/commands/harvest.js +0 -353
- package/dist/commands/workflow/workstreams.js +0 -143
- package/dist/tools/wording.js +0 -680
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
- /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
- /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
|
|
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
|
-
> -
|
|
15
|
-
> -
|
|
16
|
-
> -
|
|
17
|
-
> -
|
|
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.
|
|
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.
|
|
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:**
|
|
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:**
|
|
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
|
|
46
|
-
- Age-assurance rules as stores apply them (e.g
|
|
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
|
-
-
|
|
51
|
-
-
|
|
52
|
-
-
|
|
53
|
-
-
|
|
54
|
-
-
|
|
55
|
-
-
|
|
56
|
-
-
|
|
57
|
-
-
|
|
58
|
-
-
|
|
59
|
-
-
|
|
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 |
|
|
67
|
-
| SDK or library upgrade a deadline forces |
|
|
68
|
-
| Crash and ANR clusters as log triage |
|
|
69
|
-
| Native accessibility beyond the nutrition-label comparison |
|
|
70
|
-
| Expiry of credentials that are not store or push credentials |
|
|
71
|
-
| Who should hold store access |
|
|
72
|
-
| Slow starts, hangs, wake locks, or battery drain as performance work |
|
|
73
|
-
| How the app works, from review themes |
|
|
74
|
-
| Association-file hosting and DNS where the store build still matches |
|
|
75
|
-
| Submitting a build, changing a listing, or touching a credential |
|
|
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
|
-
|
|
86
|
-
|
|
87
|
-
- [ ] **
|
|
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
|
-
|
|
94
|
-
|
|
95
|
-
- [ ] **
|
|
96
|
-
- [ ] **
|
|
97
|
-
- [ ] **
|
|
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
|
-
|
|
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:**
|
|
111
|
-
- [ ] **Step 2 — Store State:**
|
|
112
|
-
- [ ] **Step 3 — Deadlines:** Confirm each date on current store page
|
|
113
|
-
- [ ] **Step 4 — Declarations:** Match each declaration to `bkit-audit-privacy`'s inventory and privacy policy. Do not rebuild the inventory.
|
|
114
|
-
-
|
|
115
|
-
-
|
|
116
|
-
-
|
|
117
|
-
-
|
|
118
|
-
-
|
|
119
|
-
-
|
|
120
|
-
-
|
|
121
|
-
-
|
|
122
|
-
-
|
|
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
|
-
**
|
|
127
|
-
|
|
128
|
-
- [ ] **
|
|
129
|
-
- [ ] **
|
|
130
|
-
- [ ] **
|
|
131
|
-
- [ ] **
|
|
132
|
-
- [ ] **
|
|
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` |
|
|
140
|
-
| `HIGH` |
|
|
141
|
-
| `MEDIUM` |
|
|
142
|
-
| `LOW` | Listing wording within limits that does not use search words
|
|
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
|
-
|
|
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 |
|
|
158
|
-
| A universal link or App Link that does not match a store build |
|
|
159
|
-
| An over-the-air update that changes reviewed behaviour, or a runtime-version gap |
|
|
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
|
|
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
|
-
|
|
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
|
-
**
|
|
252
|
-
|
|
253
|
-
- [ ] **
|
|
254
|
-
- [ ] **
|
|
255
|
-
- [ ] **Series:** ratings and the listing conversion funnel beside previous report's, or
|
|
256
|
-
- [ ] **Writes:** only this report
|
|
257
|
-
- [ ] **
|
|
258
|
-
- [ ] **
|
|
259
|
-
- [ ] **
|
|
260
|
-
|
|
261
|
-
|
|
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
|
|