@cbartens/bkit 5.2.3 → 5.2.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (65) hide show
  1. package/.bkit/README.md +4 -2
  2. package/.bkit/core/.bkit/README.md +3 -1
  3. package/.bkit/core/.bkit/install.md +3 -3
  4. package/.bkit/core/.bkit/prompts.md +1 -1
  5. package/.bkit/core/.bkit/templates.md +19 -1
  6. package/.bkit/core/.bkit/workflows.md +7 -2
  7. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +9 -1
  8. package/.bkit/core/docs/templates/bkit-audit-adoption.md +9 -1
  9. package/.bkit/core/docs/templates/bkit-audit-agents.md +9 -1
  10. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +9 -1
  11. package/.bkit/core/docs/templates/bkit-audit-analytics.md +9 -1
  12. package/.bkit/core/docs/templates/bkit-audit-annotations.md +10 -2
  13. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +9 -1
  14. package/.bkit/core/docs/templates/bkit-audit-app-store.md +9 -1
  15. package/.bkit/core/docs/templates/bkit-audit-architecture.md +9 -1
  16. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +9 -1
  17. package/.bkit/core/docs/templates/bkit-audit-config.md +9 -1
  18. package/.bkit/core/docs/templates/bkit-audit-cost.md +10 -2
  19. package/.bkit/core/docs/templates/bkit-audit-coverage.md +9 -1
  20. package/.bkit/core/docs/templates/bkit-audit-database.md +9 -1
  21. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +9 -1
  22. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +9 -1
  23. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +9 -1
  24. package/.bkit/core/docs/templates/bkit-audit-documentation.md +9 -1
  25. package/.bkit/core/docs/templates/bkit-audit-duplication.md +9 -1
  26. package/.bkit/core/docs/templates/bkit-audit-failures.md +9 -1
  27. package/.bkit/core/docs/templates/bkit-audit-flakes.md +10 -2
  28. package/.bkit/core/docs/templates/bkit-audit-gates.md +9 -1
  29. package/.bkit/core/docs/templates/bkit-audit-issues.md +9 -1
  30. package/.bkit/core/docs/templates/bkit-audit-llm.md +9 -1
  31. package/.bkit/core/docs/templates/bkit-audit-logs.md +10 -2
  32. package/.bkit/core/docs/templates/bkit-audit-models.md +9 -1
  33. package/.bkit/core/docs/templates/bkit-audit-privacy.md +9 -1
  34. package/.bkit/core/docs/templates/bkit-audit-prompts.md +9 -1
  35. package/.bkit/core/docs/templates/bkit-audit-red-team.md +10 -2
  36. package/.bkit/core/docs/templates/bkit-audit-reliability.md +9 -1
  37. package/.bkit/core/docs/templates/bkit-audit-repo.md +10 -2
  38. package/.bkit/core/docs/templates/bkit-audit-security.md +10 -2
  39. package/.bkit/core/docs/templates/bkit-audit-slop.md +9 -1
  40. package/.bkit/core/docs/templates/bkit-audit-testing.md +10 -2
  41. package/.bkit/core/docs/templates/bkit-audit-usability.md +9 -1
  42. package/.bkit/core/engine/checks/tips/catalogue.ts +10 -0
  43. package/.bkit/core/engine/commands/install/upgrade.ts +9 -10
  44. package/.bkit/core/engine/commands/workflow/branches.ts +61 -7
  45. package/.bkit/core/engine/commands/workflow/repo.ts +16 -2
  46. package/.bkit/core/engine/commands/workflow/workflows.ts +4 -3
  47. package/.bkit/core/engine/shared/bkit-latest.ts +164 -0
  48. package/.bkit/core/engine/shared/timeouts.ts +6 -0
  49. package/.bkit/core/prompts/bkit-audit-generate.md +6 -4
  50. package/.bkit/core/workflows/bkit-build.md +1 -1
  51. package/.bkit/core/workflows/bkit-debug.md +1 -1
  52. package/.bkit/core/workflows/bkit-design.md +1 -1
  53. package/.bkit/core/workflows/bkit-plan.md +1 -1
  54. package/.bkit/core/workflows/bkit-ship.md +1 -1
  55. package/.bkit/templates/.husky/pre-push +7 -0
  56. package/.bkit/templates/scripts/cleanup/bkit-tmp-prune.mjs +115 -0
  57. package/CHANGELOG.md +17 -0
  58. package/dist/checks/tips/catalogue.js +9 -0
  59. package/dist/commands/install/upgrade.js +9 -10
  60. package/dist/commands/workflow/branches.js +54 -8
  61. package/dist/commands/workflow/repo.js +14 -2
  62. package/dist/commands/workflow/workflows.js +4 -3
  63. package/dist/shared/bkit-latest.js +150 -0
  64. package/dist/shared/timeouts.js +6 -0
  65. package/package.json +1 -1
@@ -81,7 +81,7 @@ One per vendor, and one per paid resource inside a vendor that has several.
81
81
 
82
82
  Always verify.
83
83
 
84
- - [ ] **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 → record call verbatim and narrow allow rule clearing it (e.g. `Bash(gh run list *)`) in `Not Checked`, `Process Improvements`, and `Project Instructions` `Permissions`. never retry or reword a blocked call to get past it.
84
+ - [ ] **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.
85
85
  - [ ] **Bills:** Steps 3–5, 8 — invoices or billing export (e.g. FOCUS), read-only plan/usage/cap pages (e.g. host dashboard, cloud billing console, vendor API). Fallback: unread vendor = `ASK`; tax, foreign exchange, and card fees `Not Checked`.
86
86
  - [ ] **Code Search:** Steps 3, 6, 7 — SDKs, outbound hosts, reference checks (e.g. ripgrep, language-server references). Fallback: docs and invoices only; `REMOVE` proof marked incomplete.
87
87
  - [ ] **Web:** Step 9 — fetch anchor standards. Fallback: versions recorded as unread.
@@ -107,7 +107,7 @@ Verify only when applicable.
107
107
  - [ ] **Step 3 — Inventory:** Build list from code (SDKs, outbound hosts), docs (vendor list, secrets list), and owner-shared invoices; compare. In code, not docs = finding (doc fix → `bkit-audit-documentation`). On invoice, nowhere in code = `REMOVE` candidate. Count non-vendor-plan fees (card-processor, app-store commission): grow with paying accounts; no vendor dashboard. Replaced platform still billing after replacement shipped = `REMOVE` candidate. **Done when:** `Vendors` lists every vendor with its sources.
108
108
  - [ ] **Step 4 — Plans:** Per vendor: plan, billing model (flat, per seat, per use), spend last three months, usage driver, plan limit, proximity to limit. Split by environment; preview/dev billed like production = finding. Per usage-billed vendor: preview/E2E/CI vs production share, by feature where vendor can tell. Log audit environment split → start from `bkit-audit-logs`. E2E-driven usage on usage-billed vendor = `RIGHT-SIZE` candidate. Every free-tier resource production/CI depends on; behavior at limit (e.g. free DB pauses, free monitor stops). Free tier failing hard = finding even at $0 today. Compare monthly vs annual, prepaid credits, startup programmes, committed-use discounts; propose commitment only if usage stable ≥3 months. Record billing currency, card FX fees, sales tax/VAT/GST/reverse-charge correctness (invoice + card statement, not dashboards). **Done when:** `Vendors` row per vendor: verdict · plan · billing model · three-month spend · change since previous report · driver · limit · environment split. Total spend included.
109
109
  - [ ] **Step 5 — Unit Cost:** Total monthly cost ÷ active accounts and active users; split fixed/variable. Per metered feature, cost per action (e.g. per model assist, per inbound message). Series vs previous report: without unit cost, bill health is undecidable as usage grows. vs revenue: price × assumed conversion, less processor fees and store commission, vs cost per account. Account costing more than it pays = finding with assumptions. **Done when:** `Unit Cost` holds figures, trend, assumptions.
110
- - [ ] **Step 6 — Drivers:** Per usage-billed service: code driving the meter and worst case (retry, tenant fan-out, cron frequency). Multiplier with no upper bound = finding. Model-call multiplier also names `bkit-audit-llm` (in-code limits); other unbounded multipliers name `docs/failures.jsonl` row to append (append = next step). Egress/data transfer own line: grow with users, unnamed in code (DB egress, cached egress, host data transfer, origin transfer, storage transforms, log-drain egress); top routes/buckets by bytes. Observability metered: log drains, host observability events, replay, trace sample rates in code. From drivers, forecast monthly cost at 10× and 100× today's active accounts; name first vendor whose tier breaks and month at current growth. CI minutes → `bkit-audit-ci-performance`; do not analyse here. **Done when:** `Drivers` row per meter; `Forecast` holds 10×, 100×, first tier break, month.
110
+ - [ ] **Step 6 — Drivers:** Per usage-billed service: code driving the meter and worst case (retry, tenant fan-out, cron frequency). Multiplier with no upper bound = finding. Model-call multiplier also names `bkit-audit-llm` (in-code limits); other unbounded multipliers → `docs/failures.jsonl` row, which the audit agent writes. Egress/data transfer own line: grow with users, unnamed in code (DB egress, cached egress, host data transfer, origin transfer, storage transforms, log-drain egress); top routes/buckets by bytes. Observability metered: log drains, host observability events, replay, trace sample rates in code. From drivers, forecast monthly cost at 10× and 100× today's active accounts; name first vendor whose tier breaks and month at current growth. CI minutes → `bkit-audit-ci-performance`; do not analyse here. **Done when:** `Drivers` row per meter; `Forecast` holds 10×, 100×, first tier break, month.
111
111
  - [ ] **Step 7 — Leftovers:** Seats for people who no longer need them — cost only here; access → `bkit-audit-security`. Idle resources: projects, DBs, monitors, buckets, domains from experiments. Duplicates: two vendors, one job. **Done when:** `Leftovers` row per hit with monthly amount and verdict.
112
112
  - [ ] **Step 8 — Caps:** Per usage-billed vendor: spend cap or budget alert, amount, recipients. No cap and no alert = finding even when spend is small. When hit:
113
113
  - Notify, stop spend, or pause service; whether hit = outage. Notify-only may leave production serving; pause may take production down (e.g. host spend limit notifies unless production deploys paused). Record check frequency; lag → overshoot.
@@ -199,6 +199,13 @@ PENDING
199
199
 
200
200
  PENDING
201
201
 
202
+ ### Suggested Issues
203
+
204
+ <!-- prettier-ignore -->
205
+ | # | Title | Findings | Severity | Next Step | Reason |
206
+ | --- | --- | --- | --- | --- | --- |
207
+ | PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
208
+
202
209
  ### Process Improvements
203
210
 
204
211
  PENDING
@@ -212,6 +219,7 @@ PENDING
212
219
  - [ ] **Series:** `Vendors` spend, `Unit Cost`, and `Forecast` beside previous report's numbers, or marked baseline.
213
220
  - [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
214
221
  - [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
222
+ - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
215
223
  - [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
216
224
 
217
225
  > `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.
@@ -72,7 +72,7 @@ Static floor: coverage climbs, gate far below, large drop passes green. One-run
72
72
 
73
73
  Always verify.
74
74
 
75
- - [ ] **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 → record call verbatim and narrow allow rule clearing it (e.g. `Bash(gh run list *)`) in `Not Checked`, `Process Improvements`, and `Project Instructions` `Permissions`. never retry or reword a blocked call to get past it.
75
+ - [ ] **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.
76
76
  - [ ] **CI History:** Steps 4, 5, 7, 10 — branch coverage from full CI runs, e.g. `gh run list` / `gh run download`, GitLab pipelines, Codecov. Fallback: local re-runs fill gap; mark every local observation.
77
77
  - [ ] **Coverage Artifacts:** Steps 6, 7, 11, 12 — summary and per-file coverage, e.g. `coverage-summary.json`, `coverage-final.json`, lcov. Fallback: percentages only; file-level claims `Not Checked`.
78
78
  - [ ] **Git History:** Steps 3, 9, 15 — `git log -L` / `git log -p` on floor values and coverage config. Fallback: current tree only; history `Not Checked`.
@@ -202,6 +202,13 @@ PENDING
202
202
 
203
203
  PENDING
204
204
 
205
+ ### Suggested Issues
206
+
207
+ <!-- prettier-ignore -->
208
+ | # | Title | Findings | Severity | Next Step | Reason |
209
+ | --- | --- | --- | --- | --- | --- |
210
+ | PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
211
+
205
212
  ### Process Improvements
206
213
 
207
214
  PENDING
@@ -215,6 +222,7 @@ PENDING
215
222
  - [ ] **Series:** `Sample` spreads and the floor series beside previous report's numbers, or marked baseline.
216
223
  - [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
217
224
  - [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
225
+ - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
218
226
  - [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
219
227
 
220
228
  > `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.
@@ -71,7 +71,7 @@ Migrations and integration tests exercise queries; neither verifies privileges,
71
71
 
72
72
  Always verify.
73
73
 
74
- - [ ] **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 → record call verbatim and narrow allow rule clearing it (e.g. `Bash(gh run list *)`) in `Not Checked`, `Process Improvements`, and `Project Instructions` `Permissions`. never retry or reword a blocked call to get past it.
74
+ - [ ] **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.
75
75
  - [ ] **Catalogue Read:** Steps 3–16 — read-only SQL (or store's read-only API) per environment, e.g. platform MCP `execute_sql`, `psql` as read-only role. Fallback: local DB from migrations; remote claims = hypotheses.
76
76
  - [ ] **Local DB:** Steps 2, 10, 14 — replayable from migrations. Fallback: rolled-back transactions and remote re-check.
77
77
  - [ ] **Web:** Step 18 — fetch anchor standards. Fallback: versions recorded as unread.
@@ -210,6 +210,13 @@ PENDING
210
210
 
211
211
  PENDING
212
212
 
213
+ ### Suggested Issues
214
+
215
+ <!-- prettier-ignore -->
216
+ | # | Title | Findings | Severity | Next Step | Reason |
217
+ | --- | --- | --- | --- | --- | --- |
218
+ | PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
219
+
213
220
  ### Process Improvements
214
221
 
215
222
  PENDING
@@ -223,6 +230,7 @@ PENDING
223
230
  - [ ] **Series:** every series beside previous report's numbers, or marked baseline.
224
231
  - [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
225
232
  - [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
233
+ - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
226
234
  - [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
227
235
 
228
236
  > `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.
@@ -81,7 +81,7 @@ Dead code = control that looks live, is not: limiter on unset env var; E2E asser
81
81
 
82
82
  Always verify.
83
83
 
84
- - [ ] **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 → record call verbatim and narrow allow rule clearing it (e.g. `Bash(gh run list *)`) in `Not Checked`, `Process Improvements`, and `Project Instructions` `Permissions`. never retry or reword a blocked call to get past it.
84
+ - [ ] **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.
85
85
  - [ ] **Clean Tree:** Steps 2–17 — clean `git status` at recorded commit; one checkout all steps. Fallback: detached worktree off integration branch; dirty-path candidates = hypotheses.
86
86
  - [ ] **Text Search:** Steps 5–14 — repo search (`git grep`, ripgrep). Fallback: none → those steps `Not Checked`.
87
87
  - [ ] **Reachability Scanner:** Steps 3–4 — ad hoc, not committed dependency (e.g. `pnpm dlx knip`, vulture). Fallback: language-server refs + text search; scanner categories `Not Checked`.
@@ -232,6 +232,13 @@ PENDING
232
232
 
233
233
  PENDING
234
234
 
235
+ ### Suggested Issues
236
+
237
+ <!-- prettier-ignore -->
238
+ | # | Title | Findings | Severity | Next Step | Reason |
239
+ | --- | --- | --- | --- | --- | --- |
240
+ | PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
241
+
235
242
  ### Process Improvements
236
243
 
237
244
  PENDING
@@ -245,6 +252,7 @@ PENDING
245
252
  - [ ] **Series:** `Reachability` counts and `Runtime` zeroes beside previous report's numbers, or marked baseline.
246
253
  - [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
247
254
  - [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
255
+ - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
248
256
  - [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
249
257
 
250
258
  > `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.
@@ -99,7 +99,7 @@ Never set `unjustified` while repairing a missing or illegal `reason`. That repa
99
99
 
100
100
  Always verify.
101
101
 
102
- - [ ] **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 → record call verbatim and narrow allow rule clearing it (e.g. `Bash(gh run list *)`) in `Not Checked`, `Process Improvements`, and `Project Instructions` `Permissions`. never retry or reword a blocked call to get past it.
102
+ - [ ] **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.
103
103
  - [ ] **Ledger:** Steps 3–9 — `docs/deferrals.jsonl` and `.bkit/jsonl.md`. Fallback: file absent → one `N/A` row after Step 3 and STOP.
104
104
  - [ ] **Git History:** Steps 2, 7 — commits since the previous report, 90-day churn. Fallback: closures and churn `Not Checked`.
105
105
  - [ ] **Web:** Step 10 — fetch anchor standards. Fallback: versions recorded as unread.
@@ -264,6 +264,13 @@ PENDING
264
264
 
265
265
  PENDING
266
266
 
267
+ ### Suggested Issues
268
+
269
+ <!-- prettier-ignore -->
270
+ | # | Title | Findings | Severity | Next Step | Reason |
271
+ | --- | --- | --- | --- | --- | --- |
272
+ | PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
273
+
267
274
  ### Process Improvements
268
275
 
269
276
  PENDING
@@ -277,6 +284,7 @@ PENDING
277
284
  - [ ] **Series:** `Trend` open count, inflow, and outflow beside previous report's numbers, or marked baseline.
278
285
  - [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
279
286
  - [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
287
+ - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
280
288
  - [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
281
289
 
282
290
  > `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.
@@ -92,7 +92,7 @@ Batch verdict, in `Summary`, not per PR. The landing push's CI is the next step'
92
92
 
93
93
  Always verify.
94
94
 
95
- - [ ] **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 → record call verbatim and narrow allow rule clearing it (e.g. `Bash(gh run list *)`) in `Not Checked`, `Process Improvements`, and `Project Instructions` `Permissions`. never retry or reword a blocked call to get past it.
95
+ - [ ] **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.
96
96
  - [ ] **Git Host:** Steps 2, 3, 11, 12 — open PRs by head-ref prefix, CI runs, behind-count, e.g. `gh`, GitLab API. Fallback: none; PR steps `Not Checked`, batch verdict `FAIL`.
97
97
  - [ ] **Package Manager:** Steps 5, 8–10 — install, lockfile, registry metadata, e.g. pnpm, npm. Fallback: none; `Batch` and `Verification` `Not Checked`, batch verdict `FAIL`.
98
98
  - [ ] **Clean Worktree:** Steps 8–10 — detached worktree off the integration branch, removed before the report finishes. Fallback: none; do not build the batch in the main checkout.
@@ -249,6 +249,13 @@ PENDING
249
249
 
250
250
  PENDING
251
251
 
252
+ ### Suggested Issues
253
+
254
+ <!-- prettier-ignore -->
255
+ | # | Title | Findings | Severity | Next Step | Reason |
256
+ | --- | --- | --- | --- | --- | --- |
257
+ | PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
258
+
252
259
  ### Process Improvements
253
260
 
254
261
  PENDING
@@ -262,6 +269,7 @@ PENDING
262
269
  - [ ] **Series:** security-fix latency and end-of-life days beside previous report's numbers, or marked baseline.
263
270
  - [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
264
271
  - [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
272
+ - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
265
273
  - [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
266
274
 
267
275
  > `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.
@@ -79,7 +79,7 @@ Docs are the record agents work from: memory points at them, plans cite them, co
79
79
 
80
80
  Always verify.
81
81
 
82
- - [ ] **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 → record call verbatim and narrow allow rule clearing it (e.g. `Bash(gh run list *)`) in `Not Checked`, `Process Improvements`, and `Project Instructions` `Permissions`. never retry or reword a blocked call to get past it.
82
+ - [ ] **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.
83
83
  - [ ] **Repo Read:** Steps 2–13 — live docs, instruction files, manifests, CI workflow. Fallback: none; unreadable tree = finding.
84
84
  - [ ] **Web:** Step 14 — fetch anchor standards. Fallback: versions recorded as unread.
85
85
 
@@ -261,6 +261,13 @@ PENDING
261
261
 
262
262
  PENDING
263
263
 
264
+ ### Suggested Issues
265
+
266
+ <!-- prettier-ignore -->
267
+ | # | Title | Findings | Severity | Next Step | Reason |
268
+ | --- | --- | --- | --- | --- | --- |
269
+ | PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
270
+
264
271
  ### Process Improvements
265
272
 
266
273
  PENDING
@@ -274,6 +281,7 @@ PENDING
274
281
  - [ ] **Series:** load size, and setup-walk times when the walk ran, beside previous report's numbers, or marked baseline.
275
282
  - [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
276
283
  - [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
284
+ - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
277
285
  - [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
278
286
 
279
287
  > `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.
@@ -96,7 +96,7 @@ Carry `COINCIDENTAL` and `RULE-OF-THREE-PENDING` forward in `Carried Forward`
96
96
 
97
97
  Always verify.
98
98
 
99
- - [ ] **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 → record call verbatim and narrow allow rule clearing it (e.g. `Bash(gh run list *)`) in `Not Checked`, `Process Improvements`, and `Project Instructions` `Permissions`. never retry or reword a blocked call to get past it.
99
+ - [ ] **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.
100
100
  - [ ] **Clean Tree:** Steps 2–13 — clean `git status` at recorded commit; findings only mean something against a known tree. Fallback: detached worktree off default branch.
101
101
  - [ ] **Text Search:** Steps 3, 5, 7–10 — inline expressions, literals, env names, non-code files, e.g. ripgrep, `git grep`. Fallback: `grep -rn`.
102
102
  - [ ] **Structural Search:** Steps 3, 12 — syntax patterns that skip comments / strings and catch reordered copies, e.g. ast-grep, Semgrep; ad hoc run, record resolved version. Fallback: text search; reformatted copies `Not Checked`.
@@ -234,6 +234,13 @@ PENDING
234
234
 
235
235
  PENDING
236
236
 
237
+ ### Suggested Issues
238
+
239
+ <!-- prettier-ignore -->
240
+ | # | Title | Findings | Severity | Next Step | Reason |
241
+ | --- | --- | --- | --- | --- | --- |
242
+ | PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
243
+
237
244
  ### Process Improvements
238
245
 
239
246
  PENDING
@@ -247,6 +254,7 @@ PENDING
247
254
  - [ ] **Series:** per-package duplication % and clone growth beside previous report's numbers, or marked baseline.
248
255
  - [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
249
256
  - [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
257
+ - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
250
258
  - [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
251
259
 
252
260
  > `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.
@@ -94,7 +94,7 @@ Row text awaiting confirmation = UNCONFIRMED until reproduced or read end to end
94
94
 
95
95
  Always verify.
96
96
 
97
- - [ ] **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 → record call verbatim and narrow allow rule clearing it (e.g. `Bash(gh run list *)`) in `Not Checked`, `Process Improvements`, and `Project Instructions` `Permissions`. never retry or reword a blocked call to get past it.
97
+ - [ ] **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.
98
98
  - [ ] **Ledger:** Steps 3–7 — `docs/failures.jsonl` and `.bkit/jsonl.md`. Fallback: file absent → one `N/A` row after Step 3 and STOP.
99
99
  - [ ] **Git History:** Steps 2, 5 — commits since the previous report, fix commits. Fallback: closures and regression-by-commit `Not Checked`.
100
100
  - [ ] **Web:** Step 8 — fetch anchor standards. Fallback: versions recorded as unread.
@@ -240,6 +240,13 @@ PENDING
240
240
 
241
241
  PENDING
242
242
 
243
+ ### Suggested Issues
244
+
245
+ <!-- prettier-ignore -->
246
+ | # | Title | Findings | Severity | Next Step | Reason |
247
+ | --- | --- | --- | --- | --- | --- |
248
+ | PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
249
+
243
250
  ### Process Improvements
244
251
 
245
252
  PENDING
@@ -253,6 +260,7 @@ PENDING
253
260
  - [ ] **Series:** open count and the recurrence ranking beside previous report's numbers, or marked baseline.
254
261
  - [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
255
262
  - [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
263
+ - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
256
264
  - [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
257
265
 
258
266
  > `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.
@@ -85,7 +85,7 @@ One per flake. Root-cause class (`Mechanism`) = evidence; these = outcomes. Quar
85
85
 
86
86
  Always verify.
87
87
 
88
- - [ ] **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 → record call verbatim and narrow allow rule clearing it (e.g. `Bash(gh run list *)`) in `Not Checked`, `Process Improvements`, and `Project Instructions` `Permissions`. never retry or reword a blocked call to get past it.
88
+ - [ ] **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.
89
89
  - [ ] **CI History:** Steps 2, 3 — workflow runs since previous report, e.g. `gh run list`, Actions API, GitLab pipelines. Log access: `.agents/context.md` `context-fetch` blocks below `bkit:end` are ready-made read-only readers (`bkit context list-blocks` → each block's `context` and `body`); set a body's `# Customise:` knobs to the audit window; run it via `direnv exec . bash`. Fallback: local repeats only; ranked CI list `Not Checked`.
90
90
  - [ ] **Repeat Runner:** Steps 4, 7, 8 — repeat with retries off, e.g. Playwright `--repeat-each`, pytest-repeat. Fallback: rate `Not Checked`; do not mark `FIX NAMED` on unmeasured flake unless mechanism deterministic and report says rate unknown.
91
91
  - [ ] **Web:** Steps 6, 13 — vendor status pages and anchor standards. Fallback: incidents and versions recorded as unread.
@@ -119,7 +119,7 @@ Verify only when applicable.
119
119
  - [ ] **Step 9 — Native:** Device-runner flake (e.g. Maestro, EAS) → Steps 5–6 target browser; also boot finished before flow, device-cloud retries, animation/keyboard timing. Record artifact locations (screenshots, recordings, logs). **Done when:** answers in `Native`, or skip with evidence.
120
120
  - [ ] **Step 10 — Mechanism:** Teardown deletes rows event points at → most diagnoses corroborated by mechanism, not row. Distinguish "fits" vs "proven". One root-cause class: async wait, concurrency, order dependency, shared fixture state, resource leak, network, external service, time and date, randomness, unordered collection, infrastructure, or other (describe). Luo et al.: async wait, concurrency, order dependency ≈ 78% classified. Per-class counts across open flakes = series. Before timing mechanism → floating-promise/missing-await rules on spec/helpers (e.g. `@typescript-eslint/no-floating-promises`, `playwright/missing-playwright-await`); record hits so missing `await` is not hidden behind timing. Real defect behind flake → verdict `BUG`. **Done when:** class, what is not established, await hits in `Mechanism`.
121
121
  - [ ] **Step 11 — Fix:** Name cause and change that removes it; making change = next step. Never `.skip`, quarantine, delete assertion, widen timeout. Before trusting the repaired test, the next step puts the bug back, watches the test go red, restores, and confirms `git diff` on the source file is empty. That is not optional on anything touching row-level access control or a cross-tenant boundary. Shared helper/fixture change = signature change: references first. One-spec fix via shared fixture → next unattributable failure. Put bug back proves deterministic fix. Flaky fix also repeats Step 4: at rate p, ~3/p runs with no failure → 95% confidence rate below p (rule of three); report states count. One verdict from `Verdicts`. **Done when:** verdict, change, or why none, run count in `Fix`.
122
- - [ ] **Step 12 — Route:** No finding without re-checkable evidence: `file:line`, or query/run id/measurement + tool. Language-server empty inconclusive → text search corroboration. Report names destinations (sending = next step). Every flake → `docs/failures.jsonl` row (class, rate, age). Named mechanism → recommended fix + proof runs (Step 11). Real defect → own issue + ledger row. Fix waits on decision → named decision. Mechanism error tracker also saw → `bkit-audit-logs`. Retry-pass/warning CI annotated → `bkit-audit-annotations`. Missing trace/capture, third-party stub, missing `await` → recommended change (Steps 5, 10). **Done when:** every finding's Expected names destination, including ledger row.
122
+ - [ ] **Step 12 — Route:** No finding without re-checkable evidence: `file:line`, or query/run id/measurement + tool. Language-server empty inconclusive → text search corroboration. Report names destinations (sending = next step); the audit agent writes `docs/failures.jsonl` rows. Every flake → `docs/failures.jsonl` row (class, rate, age). Named mechanism → recommended fix + proof runs (Step 11). Real defect → own issue + ledger row. Fix waits on decision → named decision. Mechanism error tracker also saw → `bkit-audit-logs`. Retry-pass/warning CI annotated → `bkit-audit-annotations`. Missing trace/capture, third-party stub, missing `await` → recommended change (Steps 5, 10). **Done when:** every finding's Expected names destination, including ledger row.
123
123
  - [ ] **Step 13 — Standards:** Confirm current version per anchor standard; read changes since previous report's version. `Standards Coverage`: row per Luo et al. class + per flake feature the runner offers (e.g. retries, flaky status, repeat-each, fail-on-flaky, sequence shuffle) → checked (name step) / not applicable (why) / finding. Unapplied recommended practice → adopt (propose step) / reject (why) / not applicable. Do not change steps during run. **Done when:** no empty row.
124
124
  - [ ] **Step 14 — Anything Else:** (a) Since previous report's commit, everything touching test stability (browser/unit config: retries, workers, timeouts, trace; shared fixtures/helpers; CI workflows/runners; preview/DB for E2E; device flows) → one-line verdict each. (b) Bounded ~30 min: senior test-infra flags no step asks; read since previous run (incidents, `bkit-audit-logs`, new `docs/failures.jsonl`, vendor status) — what would no step catch? **Done when:** `Beyond the Steps` holds both passes, or `none`. Class seen on 2 runs → propose step in `Process Improvements`.
125
125
 
@@ -218,6 +218,13 @@ PENDING
218
218
 
219
219
  PENDING
220
220
 
221
+ ### Suggested Issues
222
+
223
+ <!-- prettier-ignore -->
224
+ | # | Title | Findings | Severity | Next Step | Reason |
225
+ | --- | --- | --- | --- | --- | --- |
226
+ | PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
227
+
221
228
  ### Process Improvements
222
229
 
223
230
  PENDING
@@ -231,6 +238,7 @@ PENDING
231
238
  - [ ] **Series:** each open flake's rate and the median age beside previous report's numbers, or marked baseline.
232
239
  - [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
233
240
  - [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
241
+ - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
234
242
  - [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
235
243
 
236
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.
@@ -77,7 +77,7 @@ One per candidate.
77
77
 
78
78
  Always verify.
79
79
 
80
- - [ ] **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 → record call verbatim and narrow allow rule clearing it (e.g. `Bash(gh run list *)`) in `Not Checked`, `Process Improvements`, and `Project Instructions` `Permissions`. never retry or reword a blocked call to get past it.
80
+ - [ ] **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.
81
81
  - [ ] **Sibling Reports:** Steps 2, 3 — newest report per other `bkit-audit-*` slug under `docs/audits/`, else that template's `Process Improvements`. Fallback: templates only; a missing report = that audit `Not Checked`.
82
82
  - [ ] **Ledgers:** Steps 3, 10, 11 — `docs/failures.jsonl`, `docs/decisions.jsonl`, `docs/deferrals.jsonl`. Fallback: incident evidence and prior rejections `Not Checked`.
83
83
  - [ ] **Repo Gates:** Steps 7, 9, 12, 13, 15 — workflows, hook directory, gate scripts, allowlist files, e.g. `.github/workflows`, `.husky`, `.gitlab-ci.yml`, every `bkit:gate:*` script in `package.json`. Fallback: none; those items `Not Checked`.
@@ -231,6 +231,13 @@ PENDING
231
231
 
232
232
  PENDING
233
233
 
234
+ ### Suggested Issues
235
+
236
+ <!-- prettier-ignore -->
237
+ | # | Title | Findings | Severity | Next Step | Reason |
238
+ | --- | --- | --- | --- | --- | --- |
239
+ | PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
240
+
234
241
  ### Process Improvements
235
242
 
236
243
  PENDING
@@ -244,6 +251,7 @@ PENDING
244
251
  - [ ] **Series:** verdict counts, `Health`, and allowlist sizes beside previous report's numbers, or marked baseline.
245
252
  - [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
246
253
  - [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
254
+ - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
247
255
  - [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
248
256
 
249
257
  > `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.
@@ -119,7 +119,7 @@ Finding `CRITICAL`–`LOW` in another audit does not set priority. Two rules do.
119
119
 
120
120
  Always verify.
121
121
 
122
- - [ ] **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 → record call verbatim and narrow allow rule clearing it (e.g. `Bash(gh run list *)`) in `Not Checked`, `Process Improvements`, and `Project Instructions` `Permissions`. never retry or reword a blocked call to get past it.
122
+ - [ ] **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.
123
123
  - [ ] **Tracker Read:** Steps 2, 5, 10 — every board item with lane, size, and priority, e.g. `gh project item-list`, Linear issues. Fallback: none; unread items `Not Checked`, proposal does not cover them.
124
124
  - [ ] **Open-Issue List:** Steps 2, 10 — every open issue, every repo / team board draws from, read separately from board, e.g. `gh issue list --state open`, Linear team issues. Fallback: none; membership `Not Checked`, proposal covers board items only.
125
125
  - [ ] **Issue Bodies:** Steps 3, 4, 6, 8 — title, labels, body, parent, milestone, blocked-by, e.g. `gh issue view`, Linear issue API. Fallback: titles only; each such rank low-confidence in `Judgement Calls`, links from structured fields only.
@@ -254,6 +254,13 @@ PENDING
254
254
 
255
255
  PENDING
256
256
 
257
+ ### Suggested Issues
258
+
259
+ <!-- prettier-ignore -->
260
+ | # | Title | Findings | Severity | Next Step | Reason |
261
+ | --- | --- | --- | --- | --- | --- |
262
+ | PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
263
+
257
264
  ### Process Improvements
258
265
 
259
266
  PENDING
@@ -267,6 +274,7 @@ PENDING
267
274
  - [ ] **Series:** every series beside previous report's numbers, or marked baseline.
268
275
  - [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
269
276
  - [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
277
+ - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
270
278
  - [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
271
279
 
272
280
  > `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.
@@ -83,7 +83,7 @@ Taxonomy names match `bkit-audit-red-team`, so a finding here and its live proof
83
83
 
84
84
  Always verify.
85
85
 
86
- - [ ] **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 → record call verbatim and narrow allow rule clearing it (e.g. `Bash(gh run list *)`) in `Not Checked`, `Process Improvements`, and `Project Instructions` `Permissions`. never retry or reword a blocked call to get past it.
86
+ - [ ] **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.
87
87
  - [ ] **Code Search:** Steps 2–12, 14 — text search and language server for callers (e.g. ripgrep, Serena, `tsserver`). Prompts often markdown; tool names often strings. Language-server hits under-report; empty inconclusive → corroborate with text search and name the tool. Fallback: text search only; name it per claim.
88
88
  - [ ] **Taxonomy Skill:** Steps 2–9, 13 — skill covering LLM and agentic top 10 editions in Anchor Standards (e.g. `owasp-security`). Categories it lacks → `Checked`. Fallback: read anchor standards directly.
89
89
  - [ ] **Web:** Steps 4, 9, 13 — tool-server spec, provider terms, anchor standards. Fallback: regime and version changes recorded as unread.
@@ -218,6 +218,13 @@ PENDING
218
218
 
219
219
  PENDING
220
220
 
221
+ ### Suggested Issues
222
+
223
+ <!-- prettier-ignore -->
224
+ | # | Title | Findings | Severity | Next Step | Reason |
225
+ | --- | --- | --- | --- | --- | --- |
226
+ | PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
227
+
221
228
  ### Process Improvements
222
229
 
223
230
  PENDING
@@ -233,6 +240,7 @@ PENDING
233
240
  - [ ] **Registry:** model choice, deprecation, and catalogue checks point at `bkit-audit-models` and are not scored here.
234
241
  - [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
235
242
  - [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
243
+ - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
236
244
  - [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
237
245
 
238
246
  > `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.
@@ -85,7 +85,7 @@ A test-origin tag narrows the lane. It does not make something noise, and it doe
85
85
 
86
86
  Always verify.
87
87
 
88
- - [ ] **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 → record call verbatim and narrow allow rule clearing it (e.g. `Bash(gh run list *)`) in `Not Checked`, `Process Improvements`, and `Project Instructions` `Permissions`. never retry or reword a blocked call to get past it.
88
+ - [ ] **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.
89
89
  - [ ] **Error Tracker:** Steps 3–9 — read-only issue, event, and alert APIs, e.g. tracker MCP, REST. Fallback: skip tracker steps; runtime-log steps still run; tracker sections `Not Checked`. Never "clean".
90
90
  - [ ] **Web:** Step 13 — fetch anchor standards. Fallback: versions recorded as unread.
91
91
 
@@ -143,7 +143,7 @@ Verify only when applicable.
143
143
  - Client calls whose error is never read: result discarded, or success destructured without error.
144
144
  - Promises started without `await` or rejection handler on write path.
145
145
 
146
- Text search finds candidates; read each. Deliberate best-effort (telemetry, fire-and-forget notification) OK when code says so. Real one → Expected names `docs/failures.jsonl` row to append; names `bkit-audit-database` when miss is grant, policy, or write role. Appending = next step. Users see same shape: tracker user feedback, support inbox, store reviews since previous report. User-reported failure with no matching event = this class. Next step = runtime half: swallowed DB error may appear in DB log. **Done when:** `Invisible` lists each candidate read, and its verdict.
146
+ Text search finds candidates; read each. Deliberate best-effort (telemetry, fire-and-forget notification) OK when code says so. Real one → `docs/failures.jsonl` row, which the audit agent writes; Expected names `bkit-audit-database` when miss is grant, policy, or write role. Users see same shape: tracker user feedback, support inbox, store reviews since previous report. User-reported failure with no matching event = this class. Next step = runtime half: swallowed DB error may appear in DB log. **Done when:** `Invisible` lists each candidate read, and its verdict.
147
147
 
148
148
  - [ ] **Step 11 — Runtime Logs:** Read each runtime-log source in `Project Instructions` and each `context=runtime` block in `.agents/context.md` for whole window since previous report, not tool default short window. Record retention from plan page and window part source could not cover. Retention < cadence = finding → drain or shorter cadence. Skipped reader (credential, tool, block) = not read, never clean. No reader → vendor console by hand, or not read and why. Note whether server logs share one structured shape (request id, trace id, hashed tenant id, error code) so queries are filters not text search; tracker log product or OTel log exporter in use. Per log error:
149
149
  - Match tracker first (timestamps; trace id joins). Covered → note platform evidence on issue. Same incident, not second finding.
@@ -248,6 +248,13 @@ PENDING
248
248
 
249
249
  PENDING
250
250
 
251
+ ### Suggested Issues
252
+
253
+ <!-- prettier-ignore -->
254
+ | # | Title | Findings | Severity | Next Step | Reason |
255
+ | --- | --- | --- | --- | --- | --- |
256
+ | PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
257
+
251
258
  ### Process Improvements
252
259
 
253
260
  PENDING
@@ -261,6 +268,7 @@ PENDING
261
268
  - [ ] **Series:** `Board` counts beside previous report's counts, or marked baseline.
262
269
  - [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
263
270
  - [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
271
+ - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
264
272
  - [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
265
273
 
266
274
  > `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.
@@ -74,7 +74,7 @@ Config ids look identical delisted vs choice day. Target failure: **a stale entr
74
74
 
75
75
  Always verify.
76
76
 
77
- - [ ] **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 → record call verbatim and narrow allow rule clearing it (e.g. `Bash(gh run list *)`) in `Not Checked`, `Process Improvements`, and `Project Instructions` `Permissions`. never retry or reword a blocked call to get past it.
77
+ - [ ] **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.
78
78
  - [ ] **Catalogue Read:** Steps 3, 5, 6 — live model list per provider call sites use, e.g. OpenRouter `/api/v1/models`, Anthropic models API, OpenAI models API, Google models API. Fallback: maker docs only; live-endpoint claims = hypotheses.
79
79
  - [ ] **Web:** Steps 5, 10 — maker deprecation pages, model cards, anchor standards. Fallback: versions recorded as unread.
80
80
 
@@ -191,6 +191,13 @@ PENDING
191
191
 
192
192
  PENDING
193
193
 
194
+ ### Suggested Issues
195
+
196
+ <!-- prettier-ignore -->
197
+ | # | Title | Findings | Severity | Next Step | Reason |
198
+ | --- | --- | --- | --- | --- | --- |
199
+ | PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
200
+
194
201
  ### Process Improvements
195
202
 
196
203
  PENDING
@@ -204,6 +211,7 @@ PENDING
204
211
  - [ ] **Series:** every series beside previous report's numbers, or marked baseline.
205
212
  - [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
206
213
  - [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
214
+ - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
207
215
  - [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
208
216
 
209
217
  > `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.
@@ -71,7 +71,7 @@ Privacy rules land with features; nothing re-reads them together. Drift: new tab
71
71
 
72
72
  Always verify.
73
73
 
74
- - [ ] **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 → record call verbatim and narrow allow rule clearing it (e.g. `Bash(gh run list *)`) in `Not Checked`, `Process Improvements`, and `Project Instructions` `Permissions`. never retry or reword a blocked call to get past it.
74
+ - [ ] **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.
75
75
  - [ ] **Published Policy:** Step 10 — privacy policy and in-app privacy copy readable (repo file or live URL). Fallback: unreadable → `Not Checked`; no policy = finding.
76
76
  - [ ] **Web:** Steps 2, 6, 12 — regulator and law sources, vendor sub-processor pages, anchor standards. Fallback: regime changes and versions recorded as unread.
77
77
 
@@ -192,6 +192,13 @@ PENDING
192
192
 
193
193
  PENDING
194
194
 
195
+ ### Suggested Issues
196
+
197
+ <!-- prettier-ignore -->
198
+ | # | Title | Findings | Severity | Next Step | Reason |
199
+ | --- | --- | --- | --- | --- | --- |
200
+ | PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
201
+
195
202
  ### Process Improvements
196
203
 
197
204
  PENDING
@@ -205,6 +212,7 @@ PENDING
205
212
  - [ ] **Annual Review:** states whether this run serves as the annual privacy review and whether everyone with children's-data access completed privacy training.
206
213
  - [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
207
214
  - [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
215
+ - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
208
216
  - [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
209
217
 
210
218
  > `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.
@@ -77,7 +77,7 @@ Guides disagree. The guide for the model that runs the prompt wins. A prompt tha
77
77
 
78
78
  Always verify.
79
79
 
80
- - [ ] **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 → record call verbatim and narrow allow rule clearing it (e.g. `Bash(gh run list *)`) in `Not Checked`, `Process Improvements`, and `Project Instructions` `Permissions`. never retry or reword a blocked call to get past it.
80
+ - [ ] **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.
81
81
  - [ ] **Code Search:** Steps 2, 4–9 — text search and language server for call sites (e.g. ripgrep, Serena, `tsserver`). Prompts often markdown or string literals; tool descriptions often strings in schema files. Language-server hits under-report; empty inconclusive → corroborate with text search and name the tool. Fallback: text search only; name it per claim.
82
82
  - [ ] **Web:** Steps 3, 10 — each maker's prompting guide (e.g. WebFetch, WebSearch). Fallback: guide practice recorded as unread; Steps 4–7 cite the previous report's guide version and say so.
83
83
 
@@ -196,6 +196,13 @@ PENDING
196
196
 
197
197
  PENDING
198
198
 
199
+ ### Suggested Issues
200
+
201
+ <!-- prettier-ignore -->
202
+ | # | Title | Findings | Severity | Next Step | Reason |
203
+ | --- | --- | --- | --- | --- | --- |
204
+ | PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
205
+
199
206
  ### Process Improvements
200
207
 
201
208
  PENDING
@@ -210,6 +217,7 @@ PENDING
210
217
  - [ ] **Guides:** every `Model Fit` verdict names the guide and date it was judged against.
211
218
  - [ ] **Writes:** only this report and template `Project Instructions` changed.
212
219
  - [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
220
+ - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
213
221
  - [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
214
222
 
215
223
  > `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.