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