@cbartens/bkit 5.5.0 → 6.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (297) hide show
  1. package/.bkit/README.md +30 -20
  2. package/.bkit/core/.agents/docs.md +1 -0
  3. package/.bkit/core/.agents/rules.md +51 -26
  4. package/.bkit/core/.bkit/README.md +29 -19
  5. package/.bkit/core/.bkit/authoring.md +117 -0
  6. package/.bkit/core/.bkit/cloud.md +11 -11
  7. package/.bkit/core/.bkit/comparison.md +5 -5
  8. package/.bkit/core/.bkit/install.md +20 -20
  9. package/.bkit/core/.bkit/jsonl.md +202 -122
  10. package/.bkit/core/.bkit/lite.md +1 -1
  11. package/.bkit/core/.bkit/pipeline.md +49 -52
  12. package/.bkit/core/.bkit/prompts.md +106 -167
  13. package/.bkit/core/.bkit/providers.md +29 -32
  14. package/.bkit/core/.bkit/templates.md +44 -18
  15. package/.bkit/core/.bkit/trackers.md +60 -28
  16. package/.bkit/core/.bkit/workflows.md +399 -359
  17. package/.bkit/core/AGENTS.md +16 -22
  18. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +14 -38
  19. package/.bkit/core/docs/templates/bkit-audit-adoption.md +16 -40
  20. package/.bkit/core/docs/templates/bkit-audit-agents.md +19 -43
  21. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +16 -40
  22. package/.bkit/core/docs/templates/bkit-audit-analytics.md +14 -38
  23. package/.bkit/core/docs/templates/bkit-audit-annotations.md +11 -35
  24. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +15 -39
  25. package/.bkit/core/docs/templates/bkit-audit-app-store.md +12 -36
  26. package/.bkit/core/docs/templates/bkit-audit-architecture.md +16 -40
  27. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +16 -40
  28. package/.bkit/core/docs/templates/bkit-audit-config.md +18 -42
  29. package/.bkit/core/docs/templates/bkit-audit-cost.md +16 -40
  30. package/.bkit/core/docs/templates/bkit-audit-coverage.md +15 -39
  31. package/.bkit/core/docs/templates/bkit-audit-database.md +16 -40
  32. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +15 -39
  33. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +15 -38
  34. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +16 -40
  35. package/.bkit/core/docs/templates/bkit-audit-documentation.md +11 -35
  36. package/.bkit/core/docs/templates/bkit-audit-duplication.md +18 -42
  37. package/.bkit/core/docs/templates/bkit-audit-failures.md +13 -37
  38. package/.bkit/core/docs/templates/bkit-audit-flakes.md +12 -36
  39. package/.bkit/core/docs/templates/bkit-audit-gates.md +14 -38
  40. package/.bkit/core/docs/templates/bkit-audit-issues.md +15 -39
  41. package/.bkit/core/docs/templates/bkit-audit-llm.md +16 -40
  42. package/.bkit/core/docs/templates/bkit-audit-logs.md +14 -38
  43. package/.bkit/core/docs/templates/bkit-audit-models.md +12 -36
  44. package/.bkit/core/docs/templates/bkit-audit-privacy.md +12 -36
  45. package/.bkit/core/docs/templates/bkit-audit-prompts.md +15 -39
  46. package/.bkit/core/docs/templates/bkit-audit-red-team.md +15 -39
  47. package/.bkit/core/docs/templates/bkit-audit-reliability.md +15 -39
  48. package/.bkit/core/docs/templates/bkit-audit-repo.md +12 -36
  49. package/.bkit/core/docs/templates/bkit-audit-security.md +13 -37
  50. package/.bkit/core/docs/templates/bkit-audit-slop.md +14 -38
  51. package/.bkit/core/docs/templates/bkit-audit-testing.md +12 -36
  52. package/.bkit/core/docs/templates/bkit-audit-usability.md +16 -40
  53. package/.bkit/core/docs/templates/bkit-plan.md +97 -226
  54. package/.bkit/core/engine/checks/after/ci-yml.ts +39 -30
  55. package/.bkit/core/engine/checks/after/github.ts +101 -72
  56. package/.bkit/core/engine/checks/after/index.ts +10 -12
  57. package/.bkit/core/engine/checks/after/suppression.ts +8 -5
  58. package/.bkit/core/engine/checks/after/tools.ts +47 -92
  59. package/.bkit/core/engine/checks/before/env.ts +2 -2
  60. package/.bkit/core/engine/checks/before/files.ts +5 -4
  61. package/.bkit/core/engine/checks/before/index.ts +18 -1
  62. package/.bkit/core/engine/checks/before/repo.ts +168 -2
  63. package/.bkit/core/engine/checks/tips/catalogue.ts +16 -5
  64. package/.bkit/core/engine/checks/tips/detect.ts +34 -0
  65. package/.bkit/core/engine/checks/tips/index.ts +10 -7
  66. package/.bkit/core/engine/cli.ts +20 -53
  67. package/.bkit/core/engine/commands/analysis.ts +171 -140
  68. package/.bkit/core/engine/commands/ci/ci.ts +6 -6
  69. package/.bkit/core/engine/commands/comply.ts +77 -103
  70. package/.bkit/core/engine/commands/install/doctor.ts +2 -2
  71. package/.bkit/core/engine/commands/install/install.ts +57 -18
  72. package/.bkit/core/engine/commands/install/uninstall.ts +65 -28
  73. package/.bkit/core/engine/commands/land.ts +18 -12
  74. package/.bkit/core/engine/commands/lib.ts +79 -17
  75. package/.bkit/core/engine/commands/registry.ts +4 -0
  76. package/.bkit/core/engine/commands/setup/setup.ts +7 -7
  77. package/.bkit/core/engine/commands/stats.ts +204 -0
  78. package/.bkit/core/engine/commands/tips.ts +10 -5
  79. package/.bkit/core/engine/commands/workflow/branches.ts +741 -62
  80. package/.bkit/core/engine/commands/workflow/challenge.ts +673 -0
  81. package/.bkit/core/engine/commands/workflow/context.ts +853 -29
  82. package/.bkit/core/engine/commands/workflow/counters.ts +267 -84
  83. package/.bkit/core/engine/commands/workflow/decisions.ts +541 -0
  84. package/.bkit/core/engine/commands/workflow/disk.ts +2 -2
  85. package/.bkit/core/engine/commands/workflow/fids.ts +793 -33
  86. package/.bkit/core/engine/commands/workflow/issues.ts +427 -105
  87. package/.bkit/core/engine/commands/workflow/ledgers.ts +884 -27
  88. package/.bkit/core/engine/commands/workflow/locks.ts +26 -2
  89. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +582 -0
  90. package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
  91. package/.bkit/core/engine/commands/workflow/prs.ts +166 -30
  92. package/.bkit/core/engine/commands/workflow/repo.ts +59 -7
  93. package/.bkit/core/engine/commands/workflow/roadmap.ts +16 -7
  94. package/.bkit/core/engine/commands/workflow/run-facts.ts +501 -0
  95. package/.bkit/core/engine/commands/workflow/runs.ts +179 -49
  96. package/.bkit/core/engine/commands/workflow/runtime.ts +22 -1
  97. package/.bkit/core/engine/commands/workflow/status.ts +142 -29
  98. package/.bkit/core/engine/commands/workflow/step-table.ts +339 -0
  99. package/.bkit/core/engine/commands/workflow/steps.ts +213 -88
  100. package/.bkit/core/engine/commands/workflow/summary.ts +398 -0
  101. package/.bkit/core/engine/commands/workflow/tests.ts +1013 -148
  102. package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
  103. package/.bkit/core/engine/commands/workflow/workflows.ts +984 -207
  104. package/.bkit/core/engine/commands/workflow/workstreams.ts +11 -5
  105. package/.bkit/core/engine/commands/workflow/worktrees.ts +276 -22
  106. package/.bkit/core/engine/install/manifest.ts +11 -9
  107. package/.bkit/core/engine/install/modules/cloud.ts +21 -13
  108. package/.bkit/core/engine/install/modules/core.ts +325 -7
  109. package/.bkit/core/engine/install/modules/opencode.ts +2 -2
  110. package/.bkit/core/engine/install/version-file.ts +6 -2
  111. package/.bkit/core/engine/ledgers/migrate.ts +92 -0
  112. package/.bkit/core/engine/ledgers/status.ts +92 -15
  113. package/.bkit/core/engine/ledgers/telemetry.ts +1261 -254
  114. package/.bkit/core/engine/render/hosts.ts +4 -0
  115. package/.bkit/core/engine/render/models.ts +12 -0
  116. package/.bkit/core/engine/shared/branches.ts +4 -1
  117. package/.bkit/core/engine/shared/egress.ts +7 -0
  118. package/.bkit/core/engine/shared/json.ts +25 -7
  119. package/.bkit/core/engine/shared/settings.ts +202 -33
  120. package/.bkit/core/engine/shared/text.ts +361 -0
  121. package/.bkit/core/engine/tools/grammar-density.ts +215 -0
  122. package/.bkit/core/engine/tools/instructions-sources.ts +834 -0
  123. package/.bkit/core/engine/tools/instructions.ts +1751 -0
  124. package/.bkit/core/hooks/gateguard-engine.js +24 -23
  125. package/.bkit/core/hooks/guardrails-shell.js +2 -3
  126. package/.bkit/core/hooks/guardrails-tiers.js +7 -1
  127. package/.bkit/core/hooks/readguard-engine.js +2 -2
  128. package/.bkit/core/prompts/bkit-audit-generate.md +62 -25
  129. package/.bkit/core/prompts/bkit-build-challenge-1.md +40 -17
  130. package/.bkit/core/prompts/bkit-build-challenge-2.md +44 -17
  131. package/.bkit/core/prompts/bkit-build-install-skills.md +26 -13
  132. package/.bkit/core/prompts/bkit-build-plan-convert.md +74 -0
  133. package/.bkit/core/prompts/bkit-build-plan-current.md +26 -13
  134. package/.bkit/core/prompts/bkit-build-plan-execute.md +74 -26
  135. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +64 -23
  136. package/.bkit/core/prompts/bkit-build-plan-verify.md +57 -33
  137. package/.bkit/core/prompts/bkit-debug-abort-handover.md +30 -14
  138. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +34 -14
  139. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +34 -17
  140. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +26 -13
  141. package/.bkit/core/prompts/bkit-debug-failure-soak.md +31 -16
  142. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +21 -11
  143. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +20 -11
  144. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +20 -11
  145. package/.bkit/core/prompts/bkit-design-generate.md +33 -13
  146. package/.bkit/core/prompts/bkit-design-organise.md +25 -12
  147. package/.bkit/core/prompts/bkit-design-review-1.md +31 -15
  148. package/.bkit/core/prompts/bkit-design-review-2.md +28 -13
  149. package/.bkit/core/prompts/bkit-design-spike.md +30 -13
  150. package/.bkit/core/prompts/bkit-design-update.md +33 -19
  151. package/.bkit/core/prompts/bkit-plan-generate.md +75 -19
  152. package/.bkit/core/prompts/bkit-plan-review-1.md +50 -27
  153. package/.bkit/core/prompts/bkit-plan-review-2.md +59 -28
  154. package/.bkit/core/prompts/bkit-plan-scope-check.md +109 -0
  155. package/.bkit/core/prompts/bkit-plan-update.md +61 -24
  156. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +27 -15
  157. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +31 -16
  158. package/.bkit/core/prompts/bkit-ship-update-docs.md +30 -15
  159. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +24 -14
  160. package/.bkit/core/prompts/bkit-utility-update-decisions.md +32 -14
  161. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +29 -14
  162. package/.bkit/core/prompts/bkit-utility-update-documentation.md +28 -13
  163. package/.bkit/core/prompts/bkit-utility-update-failures.md +31 -14
  164. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +33 -14
  165. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +38 -17
  166. package/.bkit/core/prompts/bkit-utility-update-tracker.md +43 -20
  167. package/.bkit/core/workflows/bkit-auto.md +54 -46
  168. package/.bkit/core/workflows/bkit-build.md +577 -458
  169. package/.bkit/core/workflows/bkit-debug.md +348 -333
  170. package/.bkit/core/workflows/bkit-design.md +201 -237
  171. package/.bkit/core/workflows/bkit-plan.md +210 -321
  172. package/.bkit/core/workflows/bkit-ship.md +328 -278
  173. package/.bkit/shared/.bkit/.env.example +2 -2
  174. package/.bkit/shared/.claude/settings.json +11 -0
  175. package/.bkit/shared/.cursor/mcp.json +1 -1
  176. package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
  177. package/.bkit/shared/.gitattributes +1 -1
  178. package/.bkit/shared/.mcp.json +1 -1
  179. package/.bkit/shared/.opencode/opencode.json +11 -0
  180. package/.bkit/shared/CLAUDE.md +2 -2
  181. package/.bkit/shared/GEMINI.md +2 -2
  182. package/.bkit/shared/docs/architecture.md +1 -1
  183. package/.bkit/shared/docs/data-schema.md +1 -1
  184. package/.bkit/shared/docs/deployments.md +16 -28
  185. package/.bkit/shared/docs/design.md +1 -1
  186. package/.bkit/shared/docs/noise.md +1 -1
  187. package/.bkit/shared/docs/observability.md +2 -2
  188. package/.bkit/shared/docs/security.md +1 -1
  189. package/.bkit/shared/docs/setup.md +1 -1
  190. package/.bkit/shared/docs/technology.md +1 -1
  191. package/.bkit/shared/docs/testing.md +27 -10
  192. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +1 -1
  193. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +26 -5
  194. package/.bkit/templates/.github/workflows/bkit-ci.yml +22 -84
  195. package/.bkit/templates/.github/workflows/bkit-cloud.yml +21 -19
  196. package/.bkit/templates/.husky/pre-push +52 -13
  197. package/.bkit/templates/.prettierignore +7 -0
  198. package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +194 -0
  199. package/.bkit/templates/scripts/ci/check-capstone.mjs +2 -4
  200. package/.bkit/templates/scripts/ci/check-capstone.test.mjs +4 -23
  201. package/.bkit/templates/scripts/ci/lanes/resolve-push-base.mjs +104 -23
  202. package/.bkit/templates/scripts/ci/lanes/resolve-push-base.test.mjs +103 -6
  203. package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +1 -1
  204. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +3 -1
  205. package/.bkit/templates/scripts/prettier/bkit-insert-ignore.mjs +49 -29
  206. package/CHANGELOG.md +142 -0
  207. package/README.md +58 -34
  208. package/dist/checks/after/ci-yml.js +39 -29
  209. package/dist/checks/after/github.js +99 -72
  210. package/dist/checks/after/index.js +11 -13
  211. package/dist/checks/after/suppression.js +8 -5
  212. package/dist/checks/after/tools.js +40 -83
  213. package/dist/checks/before/env.js +2 -2
  214. package/dist/checks/before/files.js +5 -3
  215. package/dist/checks/before/index.js +15 -2
  216. package/dist/checks/before/repo.js +163 -2
  217. package/dist/checks/tips/catalogue.js +14 -5
  218. package/dist/checks/tips/detect.js +32 -0
  219. package/dist/checks/tips/index.js +7 -5
  220. package/dist/cli.js +19 -47
  221. package/dist/commands/analysis.js +109 -100
  222. package/dist/commands/ci/ci.js +6 -6
  223. package/dist/commands/comply.js +54 -91
  224. package/dist/commands/install/doctor.js +2 -2
  225. package/dist/commands/install/install.js +50 -19
  226. package/dist/commands/install/uninstall.js +59 -28
  227. package/dist/commands/land.js +16 -12
  228. package/dist/commands/lib.js +51 -16
  229. package/dist/commands/registry.js +4 -0
  230. package/dist/commands/setup/setup.js +7 -7
  231. package/dist/commands/stats.js +136 -0
  232. package/dist/commands/tips.js +7 -3
  233. package/dist/commands/workflow/branches.js +656 -56
  234. package/dist/commands/workflow/challenge.js +556 -0
  235. package/dist/commands/workflow/context.js +709 -30
  236. package/dist/commands/workflow/counters.js +208 -75
  237. package/dist/commands/workflow/decisions.js +441 -0
  238. package/dist/commands/workflow/disk.js +2 -2
  239. package/dist/commands/workflow/fids.js +689 -33
  240. package/dist/commands/workflow/issues.js +362 -99
  241. package/dist/commands/workflow/ledgers.js +762 -27
  242. package/dist/commands/workflow/locks.js +24 -2
  243. package/dist/commands/workflow/plan-blocks.js +437 -0
  244. package/dist/commands/workflow/plan-versions.js +22 -0
  245. package/dist/commands/workflow/prs.js +142 -32
  246. package/dist/commands/workflow/repo.js +52 -7
  247. package/dist/commands/workflow/roadmap.js +9 -7
  248. package/dist/commands/workflow/run-facts.js +426 -0
  249. package/dist/commands/workflow/runs.js +144 -43
  250. package/dist/commands/workflow/runtime.js +12 -1
  251. package/dist/commands/workflow/status.js +130 -29
  252. package/dist/commands/workflow/step-table.js +276 -0
  253. package/dist/commands/workflow/steps.js +171 -80
  254. package/dist/commands/workflow/summary.js +275 -0
  255. package/dist/commands/workflow/tests.js +834 -136
  256. package/dist/commands/workflow/tracker.js +983 -0
  257. package/dist/commands/workflow/workflows.js +834 -195
  258. package/dist/commands/workflow/workstreams.js +11 -5
  259. package/dist/commands/workflow/worktrees.js +221 -22
  260. package/dist/install/manifest.js +11 -9
  261. package/dist/install/modules/cloud.js +22 -13
  262. package/dist/install/modules/core.js +326 -7
  263. package/dist/install/modules/opencode.js +2 -2
  264. package/dist/install/version-file.js +6 -2
  265. package/dist/ledgers/migrate.js +81 -0
  266. package/dist/ledgers/status.js +61 -8
  267. package/dist/ledgers/telemetry.js +905 -124
  268. package/dist/render/hosts.js +4 -0
  269. package/dist/render/models.js +12 -0
  270. package/dist/shared/branches.js +3 -1
  271. package/dist/shared/egress.js +7 -0
  272. package/dist/shared/json.js +20 -7
  273. package/dist/shared/settings.js +147 -26
  274. package/dist/shared/text.js +333 -0
  275. package/dist/tools/grammar-density.js +183 -0
  276. package/dist/tools/instructions-sources.js +721 -0
  277. package/dist/tools/instructions.js +1579 -0
  278. package/package.json +114 -23
  279. package/.bkit/core/engine/commands/harvest.ts +0 -459
  280. package/.bkit/core/engine/tools/wording.ts +0 -748
  281. package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
  282. package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
  283. package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
  284. package/.bkit/core/prompts/bkit-build-summary.md +0 -94
  285. package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
  286. package/.bkit/core/prompts/bkit-design-summary.md +0 -107
  287. package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
  288. package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
  289. package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
  290. package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
  291. package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
  292. package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
  293. package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
  294. package/.bkit/templates/scripts/ci/lanes/check-tree-cache.mjs +0 -138
  295. package/.bkit/templates/scripts/ci/lanes/check-tree-cache.test.mjs +0 -181
  296. package/dist/commands/harvest.js +0 -353
  297. package/dist/tools/wording.js +0 -680
@@ -7,6 +7,7 @@ import { execFileSync } from "node:child_process";
7
7
  import { MCP_TOOLSETS_HEADER, parseToolsets } from "../../install/write.js";
8
8
  import { parseJson, readJsonFile } from "../../shared/json.js";
9
9
  import { readBkitConfig } from "../../shared/settings.js";
10
+ import { isCloudOrCi } from "../before/env.js";
10
11
  /**
11
12
  * Detect whether branch protection is configured on `main`.
12
13
  * Returns "present" | "missing" | "unknown".
@@ -64,7 +65,7 @@ export function detectActionsWritePermissions() {
64
65
  *
65
66
  * - `github` → GitHub tracker: the GitHub MCP server authenticates with `BKIT_GH_TOKEN`; `gh` uses `gh auth login`.
66
67
  * - `linear` → existing Linear setup message (BKIT_LINEAR_API_KEY + LINEAR_ISSUE_ID).
67
- * - `jira` → admin switch, BKIT_JIRA_API_TOKEN and `bkit.jira` in package.json.
68
+ * - `jira` → admin switch, BKIT_JIRA_API_KEY and `bkit.tracker.jira` in package.json.
68
69
  * - `none` → prompt to run `bkit install --tracker=github`, `--tracker=linear` or `--tracker=jira`.
69
70
  *
70
71
  * Only fires when bkit workflows are installed (.claude/ or .cursor/ present).
@@ -96,10 +97,10 @@ export function buildTrackerSetupAdvisory(cwd) {
96
97
  id: "tracker-setup-jira",
97
98
  severity: "advisory",
98
99
  detect: "bkit tracker is configured as `jira`. Jira Cloud is the active tracker.",
99
- action: 'Jira tracker: (1) an org admin turns on API-token sign-in for the Rovo MCP server (admin.atlassian.com → Rovo → Rovo MCP server → Authentication → "Allow API token authentication"); (2) create an API token with scopes for the app "Atlassian MCP V2" at https://id.atlassian.com/manage-profile/security/api-tokens and set it as `BKIT_JIRA_API_TOKEN` in `.bkit/.env`, then `direnv allow`; (3) set `bkit.jira.site` (e.g. `https://acme.atlassian.net`) and `bkit.jira.project` (the project key) in package.json. Full steps: `.bkit/trackers.md` § jira.',
100
+ action: 'Jira tracker: (1) an org admin turns on API-token sign-in for the Rovo MCP server (admin.atlassian.com → Rovo → Rovo MCP server → Authentication → "Allow API token authentication"); (2) create an API token with scopes for the app "Atlassian MCP V2" at https://id.atlassian.com/manage-profile/security/api-tokens and set it as `BKIT_JIRA_API_KEY` in `.bkit/.env`, then `direnv allow`; (3) set `bkit.tracker.jira.site` (e.g. `https://acme.atlassian.net`) and `bkit.tracker.jira.project` (the project key) in package.json. Full steps: `.bkit/trackers.md` § jira.',
100
101
  };
101
102
  }
102
- // tracker === "none". Distinguish opt-out (explicit `bkit.issueTracker: "none"`)
103
+ // tracker === "none". Distinguish opt-out (explicit `bkit.tracker.default: "none"`)
103
104
  // from undecided (field absent). An explicit `none` silences the nudge, as with the
104
105
  // dep-updater advisory.
105
106
  if (issueTrackerExplicit)
@@ -107,23 +108,24 @@ export function buildTrackerSetupAdvisory(cwd) {
107
108
  return {
108
109
  id: "tracker-setup-none",
109
110
  severity: "advisory",
110
- detect: "bkit tracker is not configured (`bkit.issueTracker` absent). Workflows run but every tracker call is a no-op.",
111
- action: 'Optional post-install decision. Run `bkit install --tracker=github` (recommended), `--tracker=linear` or `--tracker=jira` to enable tracker integration. GitHub tracker requires `BKIT_GH_TOKEN` in `.bkit/.env` (fine-grained PAT for one owner, classic PAT across owners). Linear tracker requires `BKIT_LINEAR_API_KEY` in `.bkit/.env`. Jira tracker requires `BKIT_JIRA_API_TOKEN` in `.bkit/.env` and `bkit.jira` in package.json. To opt out and silence this advisory, set `bkit.issueTracker` to `"none"` in package.json.',
111
+ detect: "bkit tracker is not configured (`bkit.tracker.default` absent). Workflows run but every tracker call is a no-op.",
112
+ action: 'Optional post-install decision. Run `bkit install --tracker=github` (recommended), `--tracker=linear` or `--tracker=jira` to enable tracker integration. GitHub tracker requires `BKIT_GH_TOKEN` in `.bkit/.env` (fine-grained PAT for one owner, classic PAT across owners). Linear tracker requires `BKIT_LINEAR_API_KEY` in `.bkit/.env`. Jira tracker requires `BKIT_JIRA_API_KEY` in `.bkit/.env` and `bkit.tracker.jira` in package.json. To opt out and silence this advisory, set `bkit.tracker.default` to `"none"` in package.json.',
112
113
  };
113
114
  }
114
115
  /**
115
- * Classify the `bkit.githubProject` board-sync config in package.json:
116
- * - "configured" → object with at least `owner` + `number` (the lookup keys)
116
+ * Classify the `bkit.tracker.github.project` board-sync config in package.json:
117
+ * - "configured" → a Projects v2 board URL
117
118
  * - "opted-out" → set to `false` ("no board sync" — stay quiet)
119
+ * - "invalid" → a string that is not a board URL
118
120
  * - "absent" → missing, malformed, or unreadable
119
121
  */
120
122
  function readGithubProjectConfig(cwd) {
121
- const gp = readBkitConfig(cwd).githubProject;
122
- if (gp === false)
123
+ const { project, projectUrl } = readBkitConfig(cwd).github;
124
+ if (project === false)
123
125
  return "opted-out";
124
- if (gp !== null && gp.owner !== undefined && gp.number !== undefined)
126
+ if (project !== null)
125
127
  return "configured";
126
- return "absent";
128
+ return projectUrl === null ? "absent" : "invalid";
127
129
  }
128
130
  /**
129
131
  * Inspect the root `.mcp.json` github server's `X-MCP-Toolsets` header for the
@@ -153,13 +155,13 @@ export function detectProjectsToolset(cwd) {
153
155
  /**
154
156
  * GitHub Projects v2 board-sync prerequisite advisory. Board status sync needs
155
157
  * THREE things, none of which install seeds or verifies end-to-end:
156
- * `bkit.githubProject` config, the `projects` MCP toolset, and an org-scoped
157
- * Projects R/W PAT. Absent any of the first two (the detectable ones), board
158
- * sync silently no-ops — `bkit.githubProject` alone is useless if the toolset
159
- * lacks `projects`, and vice versa. Emits one advisory naming what's missing.
158
+ * `bkit.tracker.github.project` (the board URL), the `projects` MCP toolset, and a PAT
159
+ * with Projects R/W. Absent any of the first two (the detectable ones), board
160
+ * sync silently no-ops — the URL alone is useless if the toolset lacks
161
+ * `projects`, and vice versa. Emits one advisory naming what's missing.
160
162
  *
161
163
  * Gates: workflows installed (.claude/ or .cursor/) AND tracker === "github".
162
- * Stays quiet on explicit opt-out (`bkit.githubProject: false`) or when both
164
+ * Stays quiet on explicit opt-out (`bkit.tracker.github.project: false`) or when both
163
165
  * detectable prerequisites are satisfied (PAT scope can't be checked locally).
164
166
  */
165
167
  export function buildGithubProjectAdvisory(cwd) {
@@ -178,8 +180,10 @@ export function buildGithubProjectAdvisory(cwd) {
178
180
  if (configOk && toolsetOk)
179
181
  return null;
180
182
  const missing = [];
181
- if (!configOk)
182
- missing.push("`bkit.githubProject` is absent from package.json");
183
+ if (configState === "absent")
184
+ missing.push("`bkit.tracker.github.project` is empty or absent in package.json");
185
+ if (configState === "invalid")
186
+ missing.push("`bkit.tracker.github.project` is not a GitHub Projects board URL");
183
187
  if (toolset === "missing")
184
188
  missing.push("the `projects` toolset is missing from `.mcp.json` `X-MCP-Toolsets`");
185
189
  const missingPhrase = missing.length > 0 ? `: ${missing.join("; ")}` : "";
@@ -189,68 +193,91 @@ export function buildGithubProjectAdvisory(cwd) {
189
193
  detect: `GitHub tracker is active but Projects v2 board status sync is not fully configured${missingPhrase}. ` +
190
194
  "Board sync silently no-ops — workflows never reflect phase on the project board.",
191
195
  action: "Board status sync is optional (workflows never gate on it) but invisible when half-configured. All three prerequisites are required:\n\n" +
192
- "1. Add `bkit.githubProject` to package.json (org-owned board only — fine-grained PATs cannot reach user-owned projects, nor span orgs; use a classic PAT with `project` to cover more than one owner):\n\n" +
196
+ "1. Add the board's URL to package.json, as the browser shows it on the board (`/orgs/<org>/…` for an organization board, `/users/<login>/…` for a personal one; a trailing `/views/<n>` is fine):\n\n" +
193
197
  ' "bkit": {\n' +
194
- ' "githubProject": {\n' +
195
- ' "owner": "<org>", "number": <project-number>,\n' +
196
- ' "statusFieldId": <numeric-field-id>, "progressOptionId": "<option-id>",\n' +
197
- ' "reviewOptionId": "<option-id>", "doneOptionId": "<option-id>"\n' +
198
+ ' "tracker": {\n' +
199
+ ' "github": { "project": "https://github.com/orgs/<org>/projects/<number>" }\n' +
198
200
  " }\n" +
199
201
  " }\n\n" +
200
- " Discover the ids: `gh api /orgs/<org>/projectsV2/<number>/fields --jq '.[] | select(.name==\"Status\")'` → the Status field's " +
201
- "numeric `id` → `statusFieldId` (a JSON number, NOT quoted); each `options[].id` (e.g. `47fc9ee4`) → " +
202
- "the option ids (quoted strings). `gh project field-list`'s `id` is the GraphQL node id (`PVTSSF_…`) " +
203
- "and must NOT be used for `statusFieldId` — `projects_write` rejects it with " +
204
- "`updated_field.id: value must be a number`.\n\n" +
202
+ " Workflows set the board's Status field by option name: `In progress` when a phase starts, `In review` at hand-off. " +
203
+ 'A board whose Status options are named differently sets `"progress"` and `"review"` beside `"project"` to its own names.\n\n' +
205
204
  "2. Ensure the root `.mcp.json` github server enables the `projects` toolset:\n\n" +
206
205
  ' "X-MCP-Toolsets": "context,issues,pull_requests,repos,users,projects,actions"\n\n' +
207
- "3. The `BKIT_GH_TOKEN` PAT needs organization-scoped Projects read & write (repo scope is not enough).\n\n" +
208
- "To opt out and silence this advisory, set `bkit.githubProject` to `false` in package.json.",
206
+ "3. The `BKIT_GH_TOKEN` PAT needs Projects read & write (repo scope is not enough): a fine-grained PAT gets it as an " +
207
+ "organization permission, so it reaches organization boards only; a classic PAT with the `project` scope reaches " +
208
+ "organization and personal boards.\n\n" +
209
+ "To opt out and silence this advisory, set `bkit.tracker.github.project` to `false` in package.json.",
209
210
  };
210
211
  }
212
+ /** `gh` run with the token the engine uses for tracker calls: BKIT_GH_TOKEN as GH_TOKEN when set. */
213
+ function ghAsEngine(args) {
214
+ const token = process.env.BKIT_GH_TOKEN;
215
+ return execFileSync("gh", args, {
216
+ encoding: "utf-8",
217
+ stdio: ["ignore", "pipe", "pipe"],
218
+ timeout: 5000,
219
+ env: token ? { ...process.env, GH_TOKEN: token } : process.env,
220
+ });
221
+ }
211
222
  /**
212
- * Static-validate the `statusFieldId` shape on an otherwise-configured board.
213
- * Projects v2 board sync feeds `statusFieldId` straight into `projects_write`
214
- * `updated_field.id`, which requires the NUMERIC field id; a GraphQL node id
215
- * (`PVTSSF_…` — what `gh project field-list` returns) or any non-number value is
216
- * rejected with `updated_field.id: value must be a number`, and best-effort sync then
217
- * no-ops silently. Checked at install/check time, no network needed.
218
- *
219
- * Gates: workflows installed AND tracker === "github" AND `bkit.githubProject` is
220
- * an object carrying `owner` + `number` (an otherwise-usable board) AND
221
- * `statusFieldId` is present but not a JSON number. An absent `statusFieldId` is
222
- * the setup advisory's job; opt-out (`false`) and absent config never reach here.
223
+ * Whether the engine's token can move cards on the configured board: "present",
224
+ * "missing", or "unknown" (gh unavailable or unauthenticated). A classic token lists its
225
+ * scopes in `X-OAuth-Scopes` and needs `project`; a fine-grained token lists none, so the
226
+ * board itself is queried.
223
227
  */
224
- export function detectGithubProjectFieldIdFormat(cwd) {
225
- const hasClaude = fs.existsSync(path.join(cwd, ".claude"));
226
- const hasCursor = fs.existsSync(path.join(cwd, ".cursor"));
227
- if (!hasClaude && !hasCursor)
228
- return null;
229
- const { issueTracker, githubProject: gp } = readBkitConfig(cwd);
230
- if (issueTracker !== "github")
228
+ export function detectProjectTokenScope(owner, number) {
229
+ let head;
230
+ try {
231
+ head = ghAsEngine(["api", "-i", "user"]).split(/\r?\n\r?\n/)[0] ?? "";
232
+ }
233
+ catch {
234
+ return "unknown";
235
+ }
236
+ const scopes = /^x-oauth-scopes:(.*)$/im.exec(head);
237
+ if (scopes) {
238
+ const list = scopes[1].split(",").map((x) => x.trim());
239
+ return list.includes("project") ? "present" : "missing";
240
+ }
241
+ const field = "projectV2(number: $n) { id }";
242
+ try {
243
+ const out = ghAsEngine([
244
+ "api",
245
+ "graphql",
246
+ "-f",
247
+ `query=query($login: String!, $n: Int!) { repositoryOwner(login: $login) { ... on User { ${field} } ... on Organization { ${field} } } }`,
248
+ "-f",
249
+ `login=${owner}`,
250
+ "-F",
251
+ `n=${number}`,
252
+ ]);
253
+ const parsed = parseJson(out);
254
+ const data = (parsed.ok ? parsed.value : null);
255
+ return data?.data?.repositoryOwner?.projectV2?.id ? "present" : "missing";
256
+ }
257
+ catch {
258
+ return "missing";
259
+ }
260
+ }
261
+ /**
262
+ * The engine moves board cards with `BKIT_GH_TOKEN`; a token that cannot reach the board
263
+ * makes every move fall back to the MCP. Checked live, so it runs only when a board is
264
+ * configured, the tracker is GitHub, and not on cloud / CI (no interactive owner to fix it).
265
+ */
266
+ export function buildGithubProjectTokenScopeAdvisory(cwd) {
267
+ const config = readBkitConfig(cwd);
268
+ const board = config.github.project;
269
+ if (config.issueTracker !== "github" || !board || isCloudOrCi())
231
270
  return null;
232
- // Only judge a board that is otherwise configured (owner + number present) and
233
- // has a statusFieldId set — absent statusFieldId is handled by the setup advisory.
234
- if (!gp || gp.owner === undefined || gp.number === undefined)
271
+ if (detectProjectTokenScope(board.owner, board.number) !== "missing")
235
272
  return null;
236
- const sfid = gp.statusFieldId;
237
- if (sfid === undefined || typeof sfid === "number")
238
- return null; // absent or already correct
239
- const looksLikeNodeId = typeof sfid === "string" && /^PVT/.test(sfid);
240
- const shape = looksLikeNodeId
241
- ? "a GraphQL node id (`PVTSSF_…`)"
242
- : `a ${typeof sfid} (\`${String(sfid)}\`)`;
243
273
  return {
244
- id: "github-project-status-field-id-format",
274
+ id: "github-project-token-scope",
245
275
  severity: "advisory",
246
- detect: `\`bkit.githubProject.statusFieldId\` is ${shape}, but Projects v2 board sync feeds it to ` +
247
- "`projects_write` `updated_field.id`, which requires the numeric field id and rejects anything " +
248
- "else (`updated_field.id: value must be a number`). Board sync silently no-ops — the board never reflects phase.",
249
- action: "Re-derive the numeric Status field id and store it unquoted:\n\n" +
250
- " gh api /orgs/<org>/projectsV2/<number>/fields --jq '.[] | select(.name==\"Status\")'\n\n" +
251
- "The Status field's numeric `id` (e.g. `350038178`) → `statusFieldId` (a JSON number, NOT quoted); " +
252
- "each `options[].id` (e.g. `47fc9ee4`) → the option ids (quoted strings). `gh project field-list`'s " +
253
- "`id` is the GraphQL node id (`PVTSSF_…`) and must NOT be used for `statusFieldId`.",
276
+ detect: `The GitHub token cannot reach the board \`${config.github.projectUrl}\`: a classic token lacks the \`project\` scope, ` +
277
+ "or a fine-grained token's board query returned nothing. Board moves fall back to the MCP.",
278
+ action: "Give `BKIT_GH_TOKEN` Projects read & write: a classic PAT needs the `project` scope (reaches organization and personal boards); " +
279
+ "a fine-grained PAT needs the organization permission Projects: Read and write (organization boards only). " +
280
+ "Then re-run `bkit check`.",
254
281
  };
255
282
  }
256
283
  /**
@@ -260,15 +287,15 @@ export function detectGithubProjectFieldIdFormat(cwd) {
260
287
  * consumers to make the choice post-install.
261
288
  *
262
289
  * Also performs the cloud=claude config-consistency assertion: when
263
- * `bkit.cloudAgents === "claude"` but the installed `bkit-cloud.yml` lacks
290
+ * `bkit.cloud.agent === "claude"` but the installed `bkit-cloud.yml` lacks
264
291
  * `id-token: write`, it surfaces a consistency warning (exit-1 signal surfaced via
265
292
  * the `blocker` severity in the checks/before/index.ts caller).
266
293
  *
267
294
  * Resolution order (file presence is authoritative, package.json field is the
268
295
  * opt-out):
269
296
  * - `.github/workflows/bkit-cloud.yml` present → `cloud-router` (informational; active)
270
- * - `bkit.cloudAgents === "none"` → null (opt-out — stay quiet)
271
- * - `bkit.issueTracker === "jira"` → null (Jira runs locally only)
297
+ * - `bkit.cloud.agent === "none"` → null (opt-out — stay quiet)
298
+ * - `bkit.tracker.default === "jira"` → null (Jira runs locally only)
272
299
  * - otherwise (undecided) → `cloud-router-none` (nudge to choose)
273
300
  *
274
301
  * Only fires when there is a `.github/workflows/` dir (the router wakes on a CI
@@ -286,7 +313,7 @@ export function buildCloudSetupAdvisory(cwd) {
286
313
  return {
287
314
  id: "cloud-claude-missing-id-token",
288
315
  severity: "blocker",
289
- detect: "`bkit.cloudAgents` is `claude` but `.github/workflows/bkit-cloud.yml` lacks `id-token: write`. `claude-code-action@v1` will fail at boot with an OIDC error.",
316
+ detect: "`bkit.cloud.agent` is `claude` but `.github/workflows/bkit-cloud.yml` lacks `id-token: write`. `claude-code-action@v1` will fail at boot with an OIDC error.",
290
317
  action: "Re-run `pnpm bkit install --auto=claude --tracker=github` to regenerate the workflow with `id-token: write` and the App-auth framing. Also verify the Claude GitHub App is installed (`/install-github-app`). See bkit's `cloud.md` § Post-CI auto-routing.",
291
318
  };
292
319
  }
@@ -314,6 +341,6 @@ export function buildCloudSetupAdvisory(cwd) {
314
341
  detect: "Cloud agents: post-CI auto-routing is not configured. `.github/workflows/` exists but no `bkit-cloud.yml` — CI pass/fail does not auto-dispatch bkit-ship / bkit-debug.",
315
342
  action: "Optional post-install decision. For a GitHub-tracker repo: `pnpm bkit install --auto=claude --tracker=github`. For a Linear-tracker repo: `pnpm bkit install --auto=cursor --tracker=linear`.\n\n" +
316
343
  "Prerequisites for `--auto=claude`: `ANTHROPIC_API_KEY` repo secret (or the `ANTHROPIC_FEDERATION_RULE_ID` + `ANTHROPIC_ORGANIZATION_ID` repo variables for keyless workload identity federation) + Claude GitHub App (`/install-github-app`) + GitHub Actions write permissions.\n\n" +
317
- 'To opt out and silence this advisory, set `bkit.cloudAgents` to `"none"` in package.json.',
344
+ 'To opt out and silence this advisory, set `bkit.cloud.agent` to `"none"` in package.json.',
318
345
  };
319
346
  }
@@ -10,7 +10,7 @@ import { readBkitConfig } from "../../shared/settings.js";
10
10
  import { detectOpencodeYmlProviderDrift } from "../../install/modules/opencode.js";
11
11
  import { detectManagedDuplicate, detectManagedStale } from "./managed.js";
12
12
  import { buildCloudDashboardsAdvisory, detectCiRouterSecrets, detectGhMcpToken } from "./auth.js";
13
- import { buildCloudSetupAdvisory, buildGithubProjectAdvisory, buildTrackerSetupAdvisory, detectActionsWritePermissions, detectGithubProjectFieldIdFormat, detectMainBranchProtection, } from "./github.js";
13
+ import { buildCloudSetupAdvisory, buildGithubProjectAdvisory, buildGithubProjectTokenScopeAdvisory, buildTrackerSetupAdvisory, detectActionsWritePermissions, detectMainBranchProtection, } from "./github.js";
14
14
  import { buildDepUpdaterSetupAdvisory, detectBkitStubs, detectValePackageNotSynced, detectWorkflowLintToolsMissing, } from "./tools.js";
15
15
  import { detectBkitCloudYmlAlwaysTrueGate, detectCiYmlCapstoneContractDrift, detectCiYmlMissingActionlint, detectCiYmlRunInjection, detectGhaFloatingTags, detectRunLevelsNotComposed, detectTaggedTestsWithoutCiHome, detectTestIntegrationEnv, detectTurboIntegrationInputs, } from "./ci-yml.js";
16
16
  import { dropTipSilencedAdvisories, setupTipsChecklistLines, setupTipsMarkdownLines, } from "../tips/index.js";
@@ -43,7 +43,7 @@ export function suppressedNoteLines(suppressed) {
43
43
  return [];
44
44
  const n = suppressed.length;
45
45
  return [
46
- `${n} advisor${n === 1 ? "y" : "ies"} suppressed by bkit.ignoreAdvisories:`,
46
+ `${n} advisor${n === 1 ? "y" : "ies"} suppressed by bkit.advisories.ignore:`,
47
47
  ...suppressed.map((note) => `- ${note.id} (${note.scope})`),
48
48
  ];
49
49
  }
@@ -243,7 +243,7 @@ export function readChangelogVersionDelta(version) {
243
243
  * cwd defaults to process.cwd().
244
244
  *
245
245
  * Pass `suppressed` to collect the advisories a package opted out of via
246
- * `bkit.ignoreAdvisories` (one note per id + owning package); the caller renders them with
246
+ * `bkit.advisories.ignore` (one note per id + owning package); the caller renders them with
247
247
  * `suppressedNoteLines` so a dismissal stays visible. Omitted by callers that do not render.
248
248
  */
249
249
  export function runPostInstallCheck(preflightAdvisories, cwd = process.cwd(), suppressed) {
@@ -265,11 +265,11 @@ export function runPostInstallCheck(preflightAdvisories, cwd = process.cwd(), su
265
265
  const ghMcpToken = detectGhMcpToken(cwd);
266
266
  if (ghMcpToken)
267
267
  phase3.push(ghMcpToken);
268
- // Main branch protection — bkit's PR-base gates (build Step 17, ship Step 2)
268
+ // Main branch protection — bkit's PR-base gates (build Step 14, ship Step 2)
269
269
  // assert feat/* PRs target dev. Enforcing it at the GitHub layer needs branch
270
270
  // protection on main restricting merges to PRs from dev.
271
271
  const protectionStatus = detectMainBranchProtection();
272
- const scriptHint = "\n\nQuick path: run `bkit setup protect-main --dry-run` to preview the policy, then drop `--dry-run` to apply. It requires the CI capstone job named by `package.json` `bkit.capstoneJob` (default `bkit-tests-check`, so the required check means 'validated', not just 'tests job did not fail') and pre-flights that the job exists in the `bkit.ciWorkflow` file before requiring it.";
272
+ const scriptHint = "\n\nQuick path: run `bkit setup protect-main --dry-run` to preview the policy, then drop `--dry-run` to apply. It requires the CI capstone job named by `package.json` `bkit.testing.ciCapstone` (default `bkit-tests-check`, so the required check means 'validated', not just 'tests job did not fail') and pre-flights that the job exists in the `bkit.testing.ciWorkflow` file before requiring it.";
273
273
  if (protectionStatus === "missing") {
274
274
  phase3.push({
275
275
  id: "main-branch-protection-missing",
@@ -278,7 +278,7 @@ export function runPostInstallCheck(preflightAdvisories, cwd = process.cwd(), su
278
278
  action: "main only ever moves via a release PR (release/* -> main); bkit's build/ship workflows keep all feat/* PRs on dev. Gate main at the GitHub layer:\n\n" +
279
279
  " Settings → Branches → Add rule → Branch name pattern: main\n" +
280
280
  " - Require a pull request before merging\n" +
281
- " - Require status checks: bkit-tests-check (the always-on capstone — required-check green then means 'the planned tiers ran', not just 'nothing failed'; do NOT require bkit-tests-scope, it is always green)\n" +
281
+ ` - Require status checks: ${readBkitConfig(cwd).capstoneJob} (the always-on capstone — required-check green then means 'the planned tiers ran', not just 'nothing failed'; do NOT require bkit-tests-scope, it is always green)\n` +
282
282
  " - Do not allow bypassing the above settings (enforce for admins)\n" +
283
283
  " - Require linear history; block force-pushes and deletions\n\n" +
284
284
  "enforce-for-admins is load-bearing: agents act with the owner's admin token, so an admin-bypass exemption means the agent is the bypass. Covering admins is the only way protection actually constrains agents. dev is intentionally left unprotected — operators choose direct-push or feat/PR and own that tests ran." +
@@ -286,7 +286,7 @@ export function runPostInstallCheck(preflightAdvisories, cwd = process.cwd(), su
286
286
  });
287
287
  }
288
288
  // Optional post-install decisions (opt-in add-ons):
289
- // 1. Issue tracker — branch on bkit.issueTracker.
289
+ // 1. Issue tracker — branch on bkit.tracker.default.
290
290
  // 2. Dependency updater — read-only. Suggests an example template. Never writes config.
291
291
  // 3. Cloud agents — branch on bkit-cloud.yml presence.
292
292
  const trackerSetup = buildTrackerSetupAdvisory(cwd);
@@ -297,11 +297,9 @@ export function runPostInstallCheck(preflightAdvisories, cwd = process.cwd(), su
297
297
  const githubProjectSetup = buildGithubProjectAdvisory(cwd);
298
298
  if (githubProjectSetup)
299
299
  phase3.push(githubProjectSetup);
300
- // A configured board can still silently no-op if statusFieldId holds the GraphQL
301
- // node id instead of the numeric field id projects_write requires.
302
- const githubProjectFieldId = detectGithubProjectFieldIdFormat(cwd);
303
- if (githubProjectFieldId)
304
- phase3.push(githubProjectFieldId);
300
+ const githubProjectToken = buildGithubProjectTokenScopeAdvisory(cwd);
301
+ if (githubProjectToken)
302
+ phase3.push(githubProjectToken);
305
303
  const depUpdaterSetup = buildDepUpdaterSetupAdvisory(cwd);
306
304
  if (depUpdaterSetup)
307
305
  phase3.push(depUpdaterSetup);
@@ -411,6 +409,6 @@ export function runPostInstallCheck(preflightAdvisories, cwd = process.cwd(), su
411
409
  const phase3Ids = new Set(deduped.map((f) => f.id));
412
410
  const filteredPreflight = dedupedPreflight.filter((f) => !phase3Ids.has(f.id));
413
411
  // Final order: preflight advisories (that weren't superseded) first, then Phase 3.
414
- // An advisory a setup tip reuses goes quiet with that tip (`bkit.ignoreAdvisories`).
412
+ // An advisory a setup tip reuses goes quiet with that tip (`bkit.advisories.ignore`).
415
413
  return dropTipSilencedAdvisories([...filteredPreflight, ...deduped], cwd, onSuppressed);
416
414
  }
@@ -1,5 +1,5 @@
1
1
  // checks/after/suppression.ts — per-package advisory opt-out (`package.json`
2
- // `bkit.ignoreAdvisories`).
2
+ // `bkit.advisories.ignore`).
3
3
  //
4
4
  // A detector can be right in general and still fire on a package where the condition is
5
5
  // deliberately not applicable (a rule-linter whose test titles mention `@live`, an
@@ -12,9 +12,9 @@
12
12
  // suppressible whatever the manifest says.
13
13
  import { readPackageJson } from "../../shared/package-json.js";
14
14
  /**
15
- * Advisory ids `dir/package.json` opts out of. A missing manifest, a `bkit` key that is
16
- * absent or not an object, and an `ignoreAdvisories` that is absent or not an array all
17
- * yield no ids — never a throw.
15
+ * Advisory ids `dir/package.json` opts out of. A missing manifest, a `bkit` or
16
+ * `bkit.advisories` key that is absent or not an object, and an `advisories.ignore` that is
17
+ * absent or not an array all yield no ids — never a throw.
18
18
  */
19
19
  export function ignoredAdvisoryIds(dir) {
20
20
  const read = readPackageJson(dir);
@@ -23,7 +23,10 @@ export function ignoredAdvisoryIds(dir) {
23
23
  const bkit = read.pkg.bkit;
24
24
  if (typeof bkit !== "object" || bkit === null || Array.isArray(bkit))
25
25
  return new Set();
26
- const list = bkit.ignoreAdvisories;
26
+ const advisories = bkit.advisories;
27
+ if (typeof advisories !== "object" || advisories === null || Array.isArray(advisories))
28
+ return new Set();
29
+ const list = advisories.ignore;
27
30
  if (!Array.isArray(list))
28
31
  return new Set();
29
32
  return new Set(list.filter((id) => typeof id === "string"));